smbls 3.14.19 → 3.14.21

package/embed.js

@@ -0,0 +1,91 @@
+'use strict'
+
+/**
+ * Tiny embed-only surface (FT-EMBED-2).
+ *
+ * Standalone third-party embeds (chat widgets, partner-page surfaces,
+ * etc.) ship a tiny script that mounts a Symbols app into a host
+ * element. Loading the full `smbls/iife` bundle (~368 KB unminified)
+ * for that path forces every embedding partner to download the router,
+ * fetch plugin, polyglot, helmet, default config, and full uikit —
+ * none of which an embed widget actually uses.
+ *
+ * This entry re-exports JUST the runtime surface:
+ *
+ *   - element creation     (createElement, applyExtends, registerEvent, …)
+ *   - signal-based state   (createStore, createEffect, batch, signal, …)
+ *   - utils                (deepDestringifyFunctions, isObject, …)
+ *   - design-system core   (pushConfig, popConfig, scratch base)
+ *
+ * No router, no plugins, no DEFAULT_CREATE_OPTIONS pulling in fetch /
+ * uikit / initEmotion. Built as an IIFE under the global name
+ * `SymbolsEmbed` so a partner can `<script src=".../embed.iife.js">`
+ * and call `SymbolsEmbed.mount(rootDef, host)` — single CDN cache hit
+ * shared across every page that embeds.
+ *
+ * `mount(rootDef, host, opts)` is the convenience entry: bypasses the
+ * full `create()` pipeline (which expects pages / context / router)
+ * and runs `createElement` directly against the supplied host node.
+ */
+
+import { create, applyExtends, registerEvent, REGISTRY } from '@symbo.ls/element'
+import { createStore, createEffect, createSignal, batch, getObserver, setObserver } from '@symbo.ls/signal'
+import { pushConfig, popConfig, getActiveConfig, FACTORY } from '@symbo.ls/scratch'
+
+// `create` is element's canonical entry — same function the full
+// framework uses. Re-export under both names so embed-side code can
+// stay terminologically aligned with React/Solid embed APIs
+// (`createElement`) while old smbls consumers keep working with the
+// historical `create` name.
+export const createElement = create
+
+export {
+  create,
+  applyExtends,
+  registerEvent,
+  REGISTRY,
+  createStore,
+  createEffect,
+  createSignal,
+  batch,
+  getObserver,
+  setObserver,
+  pushConfig,
+  popConfig,
+  getActiveConfig,
+  FACTORY
+}
+
+/**
+ * Render `rootDef` into `host` and return the resulting element handle.
+ *
+ * No router, no pages, no default plugins. The host node receives the
+ * rendered tree as a child. Reactive props inside `rootDef` (top-level
+ * CSS props as functions, `text: (el, s) => …` predicates, etc.) work
+ * normally because they go through the same `createElement` path the
+ * full framework uses.
+ *
+ * @param {object} rootDef          Component definition (DOMQL object).
+ * @param {Element} host            DOM node to mount inside.
+ * @param {object}  [opts]
+ * @param {object}  [opts.state]    Initial state (proxied to createStore).
+ * @param {object}  [opts.context]  Per-app context (no global side-effects).
+ * @returns {object} the created element
+ */
+export const mount = (rootDef, host, opts = {}) => {
+  if (!rootDef || typeof rootDef !== 'object') {
+    throw new Error('[SymbolsEmbed.mount] rootDef must be an object')
+  }
+  if (!host || typeof host !== 'object' || !host.appendChild) {
+    throw new Error('[SymbolsEmbed.mount] host must be a DOM element')
+  }
+  const state = opts.state ? createStore(opts.state) : undefined
+  // element's `create` signature: (definition, parent, key, options).
+  // Key defaults to 'Root' to match the existing smbls convention so
+  // any reactive state predicate inside the rootDef that walks
+  // `el.parent` lands on a node with the expected shape.
+  return create(rootDef, host, 'Root', {
+    state,
+    context: opts.context || {}
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smbls",
-  "version": "3.14.19",
+  "version": "3.14.21",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./dist/smbls.esm.js",
@@ -16,6 +16,12 @@
     },
     "./iife": "./dist/smbls.iife.js",
     "./iife-string": "./dist/smbls.iife-string.js",
+    "./embed": {
+      "development": "./embed.js",
+      "import": "./embed.js",
+      "default": "./embed.js"
+    },
+    "./embed.iife": "./dist/smbls.embed.iife.js",
     "./package.json": "./package.json"
   },
   "source": "index.js",
@@ -29,7 +35,8 @@
     "build:esm": "node build.mjs esm dist/smbls.esm.js",
     "build:cjs": "node build.mjs cjs dist/smbls.cjs",
     "build:iife": "node build.mjs iife dist/smbls.iife.js && node scripts/build-iife-string.mjs",
-    "build": "rimraf dist && npm run build:esm && npm run build:cjs && npm run build:iife",
+    "build:embed": "node build.mjs embed dist/smbls.embed.iife.js --entry embed.js",
+    "build": "rimraf dist && npm run build:esm && npm run build:cjs && npm run build:iife && npm run build:embed",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
@@ -38,12 +45,12 @@
     "@symbo.ls/element": "^3.14.12",
     "@symbo.ls/state": "^3.14.11",
     "@symbo.ls/css": "^3.14.10",
-    "@symbo.ls/utils": "^3.14.11",
+    "@symbo.ls/utils": "^3.14.12",
     "@symbo.ls/wasm": "^3.14.10",
     "@symbo.ls/capsize": "^3.14.8",
     "@symbo.ls/helmet": "^3.14.8",
     "@symbo.ls/inspect": "^3.14.9",
-    "@symbo.ls/fetch": "^3.14.8",
+    "@symbo.ls/fetch": "^3.14.9",
     "@symbo.ls/polyglot": "^3.14.8",
     "@symbo.ls/scratch": "^3.14.10",
     "@symbo.ls/shorthand": "^3.14.9",