@symbo.ls/shorthand 3.8.9 → 3.14.0

package/dist/cjs/index.js

@@ -30,6 +30,7 @@ __export(index_exports, {
   parseFurther: () => import_further.parseFurther,
   propToAbbr: () => import_registry.propToAbbr,
   shorten: () => import_encode.shorten,
+  shorthandPlugin: () => import_plugin.shorthandPlugin,
   stringify: () => import_encode.stringify,
   stringifyFurther: () => import_further.stringifyFurther
 });
@@ -37,4 +38,5 @@ module.exports = __toCommonJS(index_exports);
 var import_encode = require("./encode.js");
 var import_decode = require("./decode.js");
 var import_further = require("./further.js");
+var import_plugin = require("./plugin.js");
 var import_registry = require("./registry.js");

package/dist/cjs/plugin.js

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plugin_exports = {};
+__export(plugin_exports, {
+  shorthandPlugin: () => shorthandPlugin
+});
+module.exports = __toCommonJS(plugin_exports);
+var import_decode = require("./decode.js");
+var import_further = require("./further.js");
+const EXPAND_MODES = {
+  shorten: import_decode.expand,
+  stringify: import_decode.parse,
+  stringifyFurther: import_further.parseFurther
+};
+function expandSection(section, decoder) {
+  if (!section || typeof section !== "object") return section;
+  if (Array.isArray(section)) return section.map((item) => decoder(item));
+  const out = {};
+  for (const key in section) {
+    const val = section[key];
+    out[key] = val && typeof val === "object" ? decoder(val) : val;
+  }
+  return out;
+}
+const EXPANDABLE_SECTIONS = ["components", "pages", "snippets"];
+const shorthandPlugin = {
+  name: "shorthand",
+  /**
+   * Called during prepareContext to expand shorthand data in-place.
+   * This is not a standard lifecycle hook — it's invoked explicitly
+   * by createDomql's prepareContext.
+   */
+  prepareContext(context) {
+    const mode = context.shorthand;
+    if (!mode) return;
+    const decoderKey = mode === true ? "shorten" : mode;
+    const decoder = EXPAND_MODES[decoderKey];
+    if (!decoder) return;
+    for (const section of EXPANDABLE_SECTIONS) {
+      if (context[section]) {
+        context[section] = expandSection(context[section], decoder);
+      }
+    }
+    if (context.app && typeof context.app === "object") {
+      context.app = decoder(context.app);
+    }
+  }
+};

package/dist/cjs/registry.js

@@ -42,7 +42,7 @@ const propToAbbr = {
   hide: "hd",
   html: "htm",
   if: "if",
-  ignoreChildExtend: "icex",
+  ignoreChildExtends: "icex",
   key: "ky",
   query: "qy",
   routes: "rt",

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import { encode, shorten, stringify } from "./encode.js";
 import { decode, expand, parse } from "./decode.js";
 import { stringifyFurther, parseFurther } from "./further.js";
+import { shorthandPlugin } from "./plugin.js";
 import {
   propToAbbr,
   abbrToProp,
@@ -22,6 +23,7 @@ export {
   parseFurther,
   propToAbbr,
   shorten,
+  shorthandPlugin,
   stringify,
   stringifyFurther
 };

package/dist/esm/plugin.js

@@ -0,0 +1,44 @@
+import { expand, parse } from "./decode.js";
+import { parseFurther } from "./further.js";
+const EXPAND_MODES = {
+  shorten: expand,
+  stringify: parse,
+  stringifyFurther: parseFurther
+};
+function expandSection(section, decoder) {
+  if (!section || typeof section !== "object") return section;
+  if (Array.isArray(section)) return section.map((item) => decoder(item));
+  const out = {};
+  for (const key in section) {
+    const val = section[key];
+    out[key] = val && typeof val === "object" ? decoder(val) : val;
+  }
+  return out;
+}
+const EXPANDABLE_SECTIONS = ["components", "pages", "snippets"];
+const shorthandPlugin = {
+  name: "shorthand",
+  /**
+   * Called during prepareContext to expand shorthand data in-place.
+   * This is not a standard lifecycle hook — it's invoked explicitly
+   * by createDomql's prepareContext.
+   */
+  prepareContext(context) {
+    const mode = context.shorthand;
+    if (!mode) return;
+    const decoderKey = mode === true ? "shorten" : mode;
+    const decoder = EXPAND_MODES[decoderKey];
+    if (!decoder) return;
+    for (const section of EXPANDABLE_SECTIONS) {
+      if (context[section]) {
+        context[section] = expandSection(context[section], decoder);
+      }
+    }
+    if (context.app && typeof context.app === "object") {
+      context.app = decoder(context.app);
+    }
+  }
+};
+export {
+  shorthandPlugin
+};

package/dist/esm/registry.js

@@ -14,7 +14,7 @@ const propToAbbr = {
   hide: "hd",
   html: "htm",
   if: "if",
-  ignoreChildExtend: "icex",
+  ignoreChildExtends: "icex",
   key: "ky",
   query: "qy",
   routes: "rt",

package/dist/iife/index.js

@@ -33,6 +33,7 @@ var SmblsShorthand = (() => {
     parseFurther: () => parseFurther,
     propToAbbr: () => propToAbbr,
     shorten: () => shorten,
+    shorthandPlugin: () => shorthandPlugin,
     stringify: () => stringify,
     stringifyFurther: () => stringifyFurther
   });
@@ -54,7 +55,7 @@ var SmblsShorthand = (() => {
     hide: "hd",
     html: "htm",
     if: "if",
-    ignoreChildExtend: "icex",
+    ignoreChildExtends: "icex",
     key: "ky",
     query: "qy",
     routes: "rt",
@@ -1176,5 +1177,46 @@ var SmblsShorthand = (() => {
     if (typeof val === "object") return parseFurther(val);
     return val;
   }
+
+  // src/plugin.js
+  var EXPAND_MODES = {
+    shorten: expand,
+    stringify: parse,
+    stringifyFurther: parseFurther
+  };
+  function expandSection(section, decoder) {
+    if (!section || typeof section !== "object") return section;
+    if (Array.isArray(section)) return section.map((item) => decoder(item));
+    const out = {};
+    for (const key in section) {
+      const val = section[key];
+      out[key] = val && typeof val === "object" ? decoder(val) : val;
+    }
+    return out;
+  }
+  var EXPANDABLE_SECTIONS = ["components", "pages", "snippets"];
+  var shorthandPlugin = {
+    name: "shorthand",
+    /**
+     * Called during prepareContext to expand shorthand data in-place.
+     * This is not a standard lifecycle hook — it's invoked explicitly
+     * by createDomql's prepareContext.
+     */
+    prepareContext(context) {
+      const mode = context.shorthand;
+      if (!mode) return;
+      const decoderKey = mode === true ? "shorten" : mode;
+      const decoder = EXPAND_MODES[decoderKey];
+      if (!decoder) return;
+      for (const section of EXPANDABLE_SECTIONS) {
+        if (context[section]) {
+          context[section] = expandSection(context[section], decoder);
+        }
+      }
+      if (context.app && typeof context.app === "object") {
+        context.app = decoder(context.app);
+      }
+    }
+  };
   return __toCommonJS(index_exports);
 })();

package/package.json

@@ -2,16 +2,14 @@
   "name": "@symbo.ls/shorthand",
   "description": "Shorthand syntax transpiler for Symbols properties",
   "author": "symbo.ls",
-  "version": "3.8.9",
+  "version": "3.14.0",
   "repository": "https://github.com/symbo-ls/smbls",
   "type": "module",
-  "module": "./dist/esm/index.js",
-  "main": "./dist/cjs/index.js",
+  "module": "./src/index.js",
+  "main": "./src/index.js",
   "exports": {
-    ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
-    }
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
   },
   "source": "src/index.js",
   "publishConfig": {
@@ -20,11 +18,11 @@
   "scripts": {
     "test": "node --experimental-vm-modules ../../node_modules/.bin/jest",
     "copy:package:cjs": "cp ../../build/package-cjs.json dist/cjs/package.json",
-    "build:cjs": "cross-env NODE_ENV=$NODE_ENV esbuild src/*.js --target=node18 --format=cjs --outdir=dist/cjs --define:process.env.NODE_ENV=process.env.NODE_ENV",
+    "build:cjs": "NODE_ENV=$NODE_ENV esbuild src/*.js --target=node18 --format=cjs --outdir=dist/cjs --define:process.env.NODE_ENV=process.env.NODE_ENV",
     "build": "node ../../build/build.js",
     "prepublish": "npm run build && npm run copy:package:cjs",
-    "build:esm": "cross-env NODE_ENV=$NODE_ENV esbuild src/*.js --target=es2020 --format=esm --outdir=dist/esm --define:process.env.NODE_ENV=process.env.NODE_ENV",
-    "build:iife": "cross-env NODE_ENV=$NODE_ENV esbuild src/index.js --bundle --target=es2020 --format=iife --global-name=SmblsShorthand --outfile=dist/iife/index.js --define:process.env.NODE_ENV=process.env.NODE_ENV"
+    "build:esm": "NODE_ENV=$NODE_ENV esbuild src/*.js --target=es2020 --format=esm --outdir=dist/esm --define:process.env.NODE_ENV=process.env.NODE_ENV",
+    "build:iife": "NODE_ENV=$NODE_ENV esbuild src/index.js --bundle --target=es2020 --format=iife --global-name=SmblsShorthand --outfile=dist/iife/index.js --define:process.env.NODE_ENV=process.env.NODE_ENV"
   },
   "files": [
     "dist",
@@ -33,7 +31,7 @@
   ],
   "license": "CC-BY-NC-4.0",
   "gitHead": "0be12bcdd99c265fdeded6d756a1a3616a943ffc",
-  "browser": "./dist/esm/index.js",
+  "browser": "./src/index.js",
   "unpkg": "./dist/iife/index.js",
   "jsdelivr": "./dist/iife/index.js",
   "sideEffects": false

package/src/index.js

@@ -3,6 +3,7 @@
 export { encode, shorten, stringify } from './encode.js'
 export { decode, expand, parse } from './decode.js'
 export { stringifyFurther, parseFurther } from './further.js'
+export { shorthandPlugin } from './plugin.js'
 export {
   propToAbbr,
   abbrToProp,

package/src/plugin.js

@@ -0,0 +1,75 @@
+'use strict'
+
+import { expand, parse } from './decode.js'
+import { parseFurther } from './further.js'
+
+const EXPAND_MODES = {
+  shorten: expand,
+  stringify: parse,
+  stringifyFurther: parseFurther
+}
+
+/**
+ * Expand shorthand keys/values on a section of the context.
+ * Walks every top-level entry and applies the decoder.
+ */
+function expandSection (section, decoder) {
+  if (!section || typeof section !== 'object') return section
+  if (Array.isArray(section)) return section.map(item => decoder(item))
+  const out = {}
+  for (const key in section) {
+    const val = section[key]
+    out[key] = val && typeof val === 'object' ? decoder(val) : val
+  }
+  return out
+}
+
+/**
+ * Sections of the context that contain component-like objects
+ * and should be expanded at runtime.
+ */
+const EXPANDABLE_SECTIONS = ['components', 'pages', 'snippets']
+
+/**
+ * Shorthand runtime plugin for smbls.
+ *
+ * When context.shorthand is set, this plugin expands abbreviated
+ * property names back to their full form before the framework
+ * processes them.
+ *
+ * context.shorthand can be:
+ *   - true or 'shorten'   → expand abbreviated keys (inverse of shorten())
+ *   - 'stringify'          → parse inline `in` strings (inverse of stringify())
+ *   - 'stringifyFurther'   → parse further-compressed form (inverse of stringifyFurther())
+ *
+ * The expansion runs once in prepareContext via the plugin's `prepareContext` hook,
+ * so individual element creation pays no per-element cost.
+ */
+export const shorthandPlugin = {
+  name: 'shorthand',
+
+  /**
+   * Called during prepareContext to expand shorthand data in-place.
+   * This is not a standard lifecycle hook — it's invoked explicitly
+   * by createDomql's prepareContext.
+   */
+  prepareContext (context) {
+    const mode = context.shorthand
+    if (!mode) return
+
+    const decoderKey = mode === true ? 'shorten' : mode
+    const decoder = EXPAND_MODES[decoderKey]
+    if (!decoder) return
+
+    for (const section of EXPANDABLE_SECTIONS) {
+      if (context[section]) {
+        context[section] = expandSection(context[section], decoder)
+      }
+    }
+
+    // Expand app-level element if present
+    if (context.app && typeof context.app === 'object') {
+      context.app = decoder(context.app)
+    }
+  }
+}

package/src/registry.js

@@ -23,7 +23,7 @@ const propToAbbr = {
   hide: 'hd',
   html: 'htm',
   if: 'if',
-  ignoreChildExtend: 'icex',
+  ignoreChildExtends: 'icex',
   key: 'ky',
   query: 'qy',
   routes: 'rt',