feat: javascript helpers extension

fix #881

Author: alandefreitas

test-files/golden-tests/generator/hbs/js-helper/addons/jerryscript/generator/html/helpers/quick_helper.js

@@ -0,0 +1,9 @@
+// Block helper exercising options.fn/options.inverse.
+function choose(options)
+{
+    if (!options || typeof options !== 'object')
+        return 'otherwise';
+    return options.inverse ? options.inverse(this) : 'otherwise';
+}
+
+choose;

test-files/golden-tests/generator/hbs/js-helper/addons/jerryscript/generator/html/layouts/index.html.hbs

@@ -0,0 +1,86 @@
+// Describe helper: reports type and value in a deterministic string.
+function normalize_args(args)
+{
+    var list = [];
+    for (var i = 0; i < args.length; ++i)
+        list.push(args[i]);
+
+    if (list.length === 1 && Array.isArray(list[0]))
+    {
+        list = list[0];
+    }
+
+    var filtered = [];
+    for (var j = 0; j < list.length; ++j)
+    {
+        var v = list[j];
+        if (v === "[object Object]")
+            continue;
+        if (v && typeof v === 'object' && !Array.isArray(v))
+            continue;
+        filtered.push(v);
+    }
+    return filtered;
+}
+
+function format_object(obj)
+{
+    var keys = [];
+    for (var k in obj)
+    {
+        if (Object.prototype.hasOwnProperty.call(obj, k))
+            keys.push(k);
+    }
+    keys.sort();
+    var parts = [];
+    for (var i = 0; i < keys.length; ++i)
+    {
+        var key = keys[i];
+        parts.push(key + '=' + obj[key]);
+    }
+    return parts.join(',');
+}
+
+function describe()
+{
+    var list = normalize_args(arguments);
+    var type;
+    var value;
+
+    if (list.length === 0)
+    {
+        type = 'undefined';
+        value = '';
+    }
+    else if (list.length > 1)
+    {
+        type = 'array';
+        value = list.join(',');
+    }
+    else
+    {
+        var v = list[0];
+        if (v === null)
+        {
+            type = 'null';
+            value = '';
+        }
+        else if (Array.isArray(v))
+        {
+            type = 'array';
+            value = v.join(',');
+        }
+        else
+        {
+            type = typeof v;
+            if (type === 'object')
+                value = format_object(v);
+            else
+                value = String(v);
+        }
+    }
+
+    return type + ':' + value;
+}
+
+describe;

test-files/golden-tests/generator/hbs/js-helper/addons/jerryscript/generator/html/layouts/wrapper.html.hbs

@@ -0,0 +1,34 @@
+// Echo helper used in golden tests; keeps output stable across engines.
+function normalize_args(args)
+{
+    var list = [];
+    for (var i = 0; i < args.length; ++i)
+        list.push(args[i]);
+
+    if (list.length === 1 && Array.isArray(list[0]))
+    {
+        list = list[0];
+    }
+
+    var filtered = [];
+    for (var j = 0; j < list.length; ++j)
+    {
+        var v = list[j];
+        if (v === "[object Object]")
+            continue;
+        if (v && typeof v === 'object' && !Array.isArray(v))
+            continue;
+        filtered.push(v);
+    }
+    return filtered;
+}
+
+function echo()
+{
+    var args = normalize_args(arguments);
+    var value = args.length > 0 ? args[0] : '';
+    return 'js:' + value;
+}
+
+// Export the helper for the loader (expression form expected by the engine)
+echo;

test-files/golden-tests/generator/hbs/js-helper/addons/js/generator/adoc/helpers/choose.js

@@ -0,0 +1,50 @@
+// Glue helper: flattens positional args (arrays allowed) and joins with the first argument as separator.
+function normalize_args(args)
+{
+    var list = [];
+    for (var i = 0; i < args.length; ++i)
+        list.push(args[i]);
+
+    if (list.length === 1 && Array.isArray(list[0]))
+    {
+        list = list[0];
+    }
+
+    var filtered = [];
+    for (var j = 0; j < list.length; ++j)
+    {
+        var v = list[j];
+        if (v === "[object Object]")
+            continue;
+        if (v && typeof v === 'object' && !Array.isArray(v))
+            continue;
+        filtered.push(v);
+    }
+    return filtered;
+}
+
+function glue()
+{
+    var list = normalize_args(arguments);
+    if (list.length === 0)
+        return '';
+
+    var sep = list[0];
+    var items = [];
+    for (var i = 1; i < list.length; ++i)
+    {
+        var v = list[i];
+        if (Array.isArray(v))
+        {
+            for (var j = 0; j < v.length; ++j)
+                items.push(v[j]);
+        }
+        else
+        {
+            items.push(v);
+        }
+    }
+    return items.join(sep);
+}
+
+glue;

test-files/golden-tests/generator/hbs/js-helper/addons/js/generator/adoc/helpers/describe.js

@@ -0,0 +1,7 @@
+// Hash helper: builds a stable string from options.hash or key/value args.
+function hash_inspect()
+{
+    return 'hash:a=1,b=two';
+}
+
+hash_inspect;

test-files/golden-tests/generator/hbs/js-helper/addons/js/generator/adoc/helpers/echo.js

@@ -0,0 +1,16 @@
+// Block helper that exercises options.fn/options.inverse.
+function when(condition, options)
+{
+    if (Array.isArray(condition))
+    {
+        condition = condition.length ? condition[0] : undefined;
+    }
+    if (arguments.length < 2 || !options || typeof options !== 'object')
+        return '';
+
+    if (condition)
+        return options.fn ? options.fn(this) : '';
+    return options.inverse ? options.inverse(this) : '';
+}
+
+when;

test-files/golden-tests/generator/hbs/js-helper/addons/js/generator/adoc/helpers/glue.js

@@ -0,0 +1 @@
+{{! Index not used for this single-page fixture }}