feat(property converters): helpers for deserializing attributes

Author: jyounce

README.md

@@ -33,6 +33,7 @@ $ yarn add @rapid-build-ui/rb-base
 	* [guid service](#guid-service)
 	* [type service](#type-service)
 	* [view directives](#view-directives)
+	* [property converters](#properties-converters)
 
 * [Slot Mixin](#slot-mixin) (adds helpers onto this for working with slots)
 
@@ -43,7 +44,7 @@ $ yarn add @rapid-build-ui/rb-base
 /* Example
  **********/
 import { RbBase, props, html } from '../../rb-base/scripts/rb-base.js';
-import view                    from '../../rb-base/scripts/public/view/directives.js';
+import View                    from '../../rb-base/scripts/public/view/directives.js';
 import template                from '../views/rb-popover.html';
 
 export class RbPopover extends RbBase() {
@@ -122,6 +123,25 @@ const guid = Guid.create();
 ```
 
 
+### property converters
+* Methods
+	* valueless(val) :boolean
+
+```js
+// Example
+import Converter from from '../../rb-base/scripts/public/props/converters.js';
+class RbIcon {
+	static get props() {
+		return {
+			spin: Object.assign({}, props.boolean, {
+				deserialize: Converter.valueless
+			})
+		};
+	}
+}
+```
+
+
 ### type service
 * Methods (**is.methods() :boolean**)
 	* get(val) :string (returns val type)
@@ -152,13 +172,13 @@ to be used in view.
 
 ```js
 // Example
-import view from '../../rb-base/scripts/public/view/directives.js';
+import View from '../../rb-base/scripts/public/view/directives.js';
 ```
 
 ```html
-<!-- Example (import view object in js, see "How To Use"): -->
+<!-- Example (import View object in js, see "How To Use"): -->
 <ul>
-	${view.repeat(
+	${View.repeat(
 		['hulk','thor'],
 		(hero, i) => html`<li>${i} ${hero}</li>`
 	)}

src/client/scripts/private/services/view.js

@@ -1,13 +1,13 @@
-/********************************************************************
+/**********************************************************************
  * VIEW SERVICE
- * -----------------------------------------------------------------
+ * -------------------------------------------------------------------
  * HOW TO USE
  - import ViewService from './view.js';
- - this.rb.view = View.call(this); :object (set in constructor)
+ - this.rb.view = ViewService.call(this); :object (set in constructor)
  * API
  - this.rb.view.isReady; :boolean (readonly: set in readyCallback())
  - this.rb.view.readyCallback(); :void (run in rb-base's renderer())
- ********************************************************************/
+ **********************************************************************/
 
 /* View Helper
  **************/

src/client/scripts/public/props/converters.js

@@ -0,0 +1,18 @@
+/*******************************************
+ * PROPERTY CONVERTERS
+ * ----------------------------------------
+ * HOW TO USE
+ - import Converter from './converters.js';
+ *******************************************/
+const Converters = {
+	valueless(val) { // :boolean
+		if (typeof val !== 'string') return val;
+		val = val.trim();
+		if (!val) return true; // valueless attr is empty string
+		return /^true$/i.test(val);
+	}
+};
+
+/* Export it!
+ *************/
+export default Converters;