@phillipsharring/graspr-framework 0.2.2 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Phillip Harrington
+
+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.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@phillipsharring/graspr-framework",
-    "version": "0.2.2",
+    "version": "0.2.3",
     "description": "HTMX + Handlebars + Tailwind frontend framework",
     "type": "module",
     "exports": {

package/src/helpers/ab-helpers.js

@@ -0,0 +1,29 @@
+/**
+ * Register A/B testing Handlebars helpers.
+ *
+ * Usage in templates:
+ *   {{#ab "test-name" "a"}}...content for variant a...{{/ab}}
+ *   {{#ab "test-name" "b"}}...content for variant b...{{/ab}}
+ *
+ * The template context must include an `ab` object mapping test names to assigned variants.
+ * This is typically set on the rendering context before template execution.
+ *
+ * @param {typeof import('handlebars')} Handlebars
+ */
+export function registerAbHelpers(Handlebars) {
+    /**
+     * Block helper: renders content only if the visitor's assignment matches.
+     *
+     * @example
+     *   {{#ab "headline" "a"}}<h1>Original headline</h1>{{/ab}}
+     *   {{#ab "headline" "b"}}<h1>New headline</h1>{{/ab}}
+     */
+    Handlebars.registerHelper('ab', function (testName, variant, options) {
+        // `this` is the Handlebars context — look for ab assignments
+        var assignments = this.ab || {};
+        if (assignments[testName] === variant) {
+            return options.fn(this);
+        }
+        return '';
+    });
+}

package/src/index.js

@@ -66,6 +66,7 @@ export { createTypeahead } from './ui/typeahead.js';
 
 // Helpers
 export { registerHandlebarsHelpers } from './helpers/handlebars-helpers.js';
+export { registerAbHelpers } from './helpers/ab-helpers.js';
 export { initCopyIdHandler } from './helpers/utils.js';
 export { escapeHtml } from './helpers/escape-html.js';
 export { populateSelect } from './helpers/populate-select.js';