Initial commit

Author: wooorm

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{json,remarkrc,eslintrc,sh}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.eslintignore

@@ -0,0 +1,4 @@
+coverage/
+example.js
+hastscript.js
+hastscript.min.js

.eslintrc

@@ -0,0 +1,6 @@
+{
+  "extends": "eslint:recommended",
+  "rules": {
+    "quotes": [2, "single"]
+  }
+}

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+*.log
+coverage/
+node_modules/
+hastscript.js
+hastscript.min.js

.jscs.json

@@ -0,0 +1,35 @@
+{
+  "excludeFiles": [
+    "coverage/",
+    "node_modules/",
+    "hastscript.js",
+    "hastscript.min.js"
+  ],
+  "preset": "yandex",
+  "requireQuotedKeysInObjects": true,
+  "disallowQuotedKeysInObjects": false,
+  "maximumLineLength": {
+    "value": 79,
+    "allExcept": [
+      "regex",
+      "urlComments"
+    ]
+  },
+  "jsDoc": {
+    "checkAnnotations": "jsdoc3",
+    "checkParamExistence": true,
+    "checkParamNames": true,
+    "checkRedundantAccess": true,
+    "checkRedundantParams": true,
+    "checkRedundantReturns": true,
+    "checkReturnTypes": true,
+    "checkTypes": "strictNativeCase",
+    "enforceExistence": true,
+    "requireHyphenBeforeDescription": true,
+    "requireNewlineAfterDescription": true,
+    "requireParamDescription": true,
+    "requireParamTypes": true,
+    "requireReturnDescription": true,
+    "requireReturnTypes": true
+  }
+}

.remarkrc

@@ -0,0 +1,13 @@
+{
+  "output": true,
+  "plugins": [
+    "comment-config",
+    "github",
+    "lint",
+    "usage",
+    "validate-links"
+  ],
+  "settings": {
+    "bullet": "*"
+  }
+}

.travis.yml

@@ -0,0 +1,26 @@
+language: node_js
+node_js:
+- '0.10'
+- '0.11'
+- '0.12'
+- '4.0'
+- '5.0'
+- iojs
+sudo: false
+after_script: npm install codecov.io && cat ./coverage/lcov.info | codecov
+deploy:
+  - provider: npm
+    email: [email protected]
+    api_key:
+      secure: l2iOveDemDpIVr8+8OFm+3yKUz7ix1r0v6Izy4XHegV/6X5PAFws6PEyDSFZvwhq2ROx8vSxXgDiRykdbIMWQSHYEbF8pF4RZPjIl+qO/Mn+aIqYErHDT8y8/UHfTzVR9ZJhr+3kfdA//Slu1GQUpc2cNahttZ5YCUeeafSEFkf6bNOZSV2/R9zneAnEc6Rdhif4y6TInNKFUsFzn0i5vz0MgS/NCecpsONKpGzK8xXz/yppr6kJGOJDkVi0WVIBnGC9tpu1oITb1rRpl6p+3sKFpc0+QoNNkFPol9SUFIZSNazTfNH2r6TpkGLZP37n28vFiXiurrLUsVZ2fSZMZaJLcNrGUe0GDPEYyVcqDohmMs2fpudCDWBiuumPaPieBGNYVARjSXZs8Fwe4bcp480JxhTdAecD2f506euSpe7q3g7cmuF14cutA51hH6lMZgHuLWS7nE0LZLwO6wtg9q0d1pFHwebxI4j9D/zXeopQ8YzkPSxqIsxZGBj8QnJWlDt0OLSwVKjXPMDr34OjY7I4LQdsiK9ChozaPbYg/WMqILOi7d4iFHE82RxIf71EAyFtvKvFclerqvB0/TwMqiy2vKJgFOikX+6v70oVWPERZ4DOO9rguDztQkSqMCJVN/0HEGVVfSJLEPspCi1CX8cU8f6cFoExJ6PDXMGJOw4=
+    on:
+      tags: true
+      node: '5.0'
+  - provider: releases
+    api_key:
+      secure: Kj34ePmdMrhEkSMMXUrVd1tX/0l9OnAze3cNAjeyKuFn3mSdM9DcXy7TstJb023tJQ57PIX+LDFyZCGe8vubwSfFeULZLBIyaSsaZw6wfZTkobla99f3oWm+1iGhUU7aLbH+31U4k6aEUsU2S/VtPo/TbrW6/P8wzGiWIC2j1OObnZqiB2a0UUlqEGEqsMwv/9tI/EMkx/qYN2/MJJUj1KYORMQcZCI8cv6R2XnSSZ7lHeuOsN67hB/WotZyfrihsFRY0ANT4J94ateiX2E9BFBLFtjQwa8T2JsFh8Q+Ex7otgQIegu+Jum9x8/EAUGtiopgz4PCeWCey2Ri0mywKLIl+ewQvAlX0zNjreBKNpumcPd4UKXCLQHTpPjbNjNzgGyVBT161xipx1PrCgAKlSX2PS3dydLArwOlYnE+EK8xbBCHonLsnyHrm4xSJKZk1ypeNMEd7jaxBbkFlHkvcWselIA6Y4xSjxb9szY8QlDU5oKuNzOtVZrOxHY9IXijP3aub889D4yzbtNc1oBhDFpdiPLbHO0KAo6bOzR4/kDLjm0KEOYHcmZqMDSX+YKwfOOfJEVGKTjekpi1FBoN9in6Y3piJgpkvURjp6tDMYaC9C2dBFGbhKNPNQDLSoMvfBzdemAk8AJjx6tTT9ZdmWCNcP+XjGG2vuNDZEz7sq4=
+    file:
+      - "hastscript.js"
+      - "hastscript.min.js"
+    on:
+      tags: true

LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2016 Titus Wormer <[email protected]>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

example.js

@@ -0,0 +1,19 @@
+// Dependencies:
+var h = require('./index.js');
+
+// AST:
+var tree = h('.foo#some-id', [
+    h('span', 'some text'),
+    h('input', {
+        'type': 'text',
+        'value': 'foo'
+    }),
+    h('a.alpha', {
+        'class': 'bravo charlie',
+        'style': 'color:/*red*/purple',
+        'download': 'download'
+    }, ['delta', 'echo'])
+]);
+
+// Yields:
+console.log('js', require('util').inspect(tree, {'depth': null}));

history.md

@@ -0,0 +1,6 @@
+<!--remark setext-->
+
+<!--lint disable no-multiple-toplevel-headings -->
+
+0.0.0 / 2016-02-24
+==================

index.js

@@ -0,0 +1,226 @@
+/**
+ * @author Titus Wormer
+ * @copyright 2016 Titus Wormer
+ * @license MIT
+ * @module hastscript
+ * @fileoverview Hyperscript compatible DSL for creating
+ *   virtual HAST trees.
+ */
+
+'use strict';
+
+/* eslint-env commonjs */
+
+/*
+ * Dependencies.
+ */
+
+var parseSelector = require('hast-util-parse-selector');
+var camelcase = require('camelcase');
+var propertyInformation = require('property-information');
+var cssDeclarations = require('css-declarations').parse;
+var spaces = require('space-separated-tokens').parse;
+var commas = require('comma-separated-tokens').parse;
+
+/**
+ * Parse a (list of) primitives.
+ *
+ * @param {Object} info - Information.
+ * @param {string} name - Property name.
+ * @param {*} value - Values to parse.
+ * @return {*} - Parsed `value`.
+ */
+function parsePrimitive(info, name, value) {
+    var result = value;
+    var index;
+    var length;
+
+    if (typeof value === 'object' && 'length' in value) {
+        length = value.length;
+        index = -1;
+        result = [];
+
+        while (++index < length) {
+            result[index] = parsePrimitive(info, name, value[index]);
+        }
+
+        return result;
+    }
+
+    if (info.boolean) {
+        result = true;
+    } else if (info.numeric || info.positiveNumeric) {
+        result = Number(result);
+    } else if (info.overloadedBoolean) {
+        /*
+         * Accept `boolean` and `string`.
+         */
+
+        if (
+            typeof result === 'string' &&
+            (result === '' || value.toLowerCase() === name)
+        ) {
+            result = true;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Add `name` and its `value` to `properties`.
+ * `properties` can be prefilled by `parseSelector`:
+ * it can have `id` and `className` properties.
+ *
+ * @param {Object} properties - Attributes.
+ * @param {string} name - Property name.
+ * @param {*} value - Property value.
+ */
+function addProperty(properties, name, value) {
+    var info = propertyInformation(name) || {};
+    var result = value;
+    var key;
+
+    /*
+     * Ignore nully and NaN values.
+     */
+
+    if (value === null || value === undefined || value !== value) {
+        return;
+    }
+
+    /*
+     * Handle values.
+     */
+
+    if (name === 'style') {
+        /*
+         * Accept both `string` and `object`.
+         */
+
+        if (typeof value === 'string') {
+            result = cssDeclarations(result);
+        } else {
+            result = {};
+
+            for (key in value) {
+                result[key] = value[key];
+            }
+        }
+    } else if (info.spaceSeparated) {
+        /*
+         * Accept both `string` and `Array`.
+         */
+
+        result = typeof value === 'string' ? spaces(result) : result;
+
+        /*
+         * Class-names (which can be added both on
+         * the `selector` and here).
+         */
+
+        if (name === 'class' && properties.className) {
+            result = properties.className.concat(result);
+        }
+    } else if (info.commaSeparated) {
+        /*
+         * Accept both `string` and `Array`.
+         */
+
+        result = typeof value === 'string' ? commas(result) : result;
+    }
+
+    result = parsePrimitive(info, name, result);
+
+    properties[info.propertyName || camelcase(name)] = result;
+}
+
+/**
+ * Add `value` as a child to `nodes`.
+ *
+ * @param {Array.<Node>} nodes - List of siblings.
+ * @param {string|Node|Array.<string|Node>} value - List of
+ *   children or child to add.
+ */
+function addChild(nodes, value) {
+    var index;
+    var length;
+
+    if (value === null || value === undefined) {
+        return;
+    }
+
+    if (typeof value === 'string' || typeof value === 'number') {
+        value = {
+            'type': 'text',
+            'value': String(value)
+        };
+    }
+
+    if (typeof value === 'object' && 'length' in value) {
+        index = -1;
+        length = value.length;
+
+        while (++index < length) {
+            addChild(nodes, value[index]);
+        }
+
+        return;
+    }
+
+    if (typeof value !== 'object' || !('type' in value)) {
+        throw new Error(
+            'Expected node, nodes, or string, got `' + value + '`'
+        );
+    }
+
+    nodes.push(value);
+}
+
+/**
+ * Hyperscript compatible DSL for creating virtual HAST
+ * trees.
+ *
+ * @param {string?} selector - Simple CSS selector to parse.
+ * @param {Object?} properties - HTML attributes to add.
+ * @param {string|Array.<string|Node>} children - List of
+ *   children to add.
+ * @return {Node} - HAST node.
+ */
+function h(selector, properties, children) {
+    var node = parseSelector(selector);
+    var property;
+
+    if (
+        properties &&
+        !children &&
+        (
+            typeof properties === 'string' ||
+            'length' in properties ||
+            // Only allow a node at the `properties`
+            // position when it isn’t an `input`, as those
+            // use HTML `type` and `value` attributes too
+            // and are void.
+            (node.tagName !== 'input' && 'type' in properties)
+        )
+    ) {
+        children = properties;
+        properties = null;
+    }
+
+    if (properties) {
+        for (property in properties) {
+            addProperty(node.properties, property, properties[property]);
+        }
+    }
+
+    addChild(node.children, children);
+
+    return node;
+}
+
+/*
+ * Expose.
+ */
+
+module.exports = h;