@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/render/shell-selection.js

@@ -0,0 +1,117 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Shell selection — the state a SPLIT shell runs on.
+ *
+ * WHY THIS IS IN THE RUNTIME AND NOT IN THE BLOCK. A split surface (list on the
+ * left, detail on the right) has exactly one piece of state: which item is
+ * selected. Kept inside the block it is invisible to everything else — the URL
+ * does not move, so the page cannot be linked to, the browser Back button does
+ * nothing, and a second block on the same surface (a header showing the
+ * selected record's title, a toolbar acting on it) has no way to read it.
+ *
+ * So selection is a SURFACE-level fact with a URL projection:
+ *
+ *   ?<key>=<itemId>
+ *
+ * and this module is the single place that reads and writes it.
+ *
+ * THE URL IS THE SOURCE OF TRUTH when syncing is on. React state mirrors it
+ * rather than the other way round, which is what makes a pasted link, a Back
+ * press and a click on the list all land in the same place — three paths, one
+ * rule.
+ *
+ * INERT HOSTS DO NOT NAVIGATE. An editor or preview canvas renders the same
+ * block with `interactionMode: 'inert'`; there the selection stays in memory and
+ * the host's own URL is never touched. That mirrors the existing rule for blocks
+ * that navigate or write data.
+ */
+import * as React from 'react';
+function readFromUrl(key) {
+    if (typeof window === 'undefined')
+        return undefined;
+    const value = new URLSearchParams(window.location.search).get(key);
+    return value === null || value === '' ? undefined : value;
+}
+/**
+ * Create a selection store.
+ *
+ * `syncUrl: false` gives an in-memory store with identical semantics — the same
+ * hook, the same cross-block sharing, no address-bar side effects.
+ */
+export function createShellSelectionStore(syncUrl) {
+    const memory = new Map();
+    const listeners = new Set();
+    const emit = () => {
+        for (const l of [...listeners])
+            l();
+    };
+    if (syncUrl && typeof window !== 'undefined') {
+        window.addEventListener('popstate', emit);
+    }
+    return {
+        syncUrl,
+        get(key) {
+            // URL first: a Back press changes the address without going through
+            // `set`, so reading memory would serve a stale value.
+            if (syncUrl)
+                return readFromUrl(key) ?? memory.get(key);
+            return memory.get(key);
+        },
+        set(key, id) {
+            memory.set(key, id);
+            if (syncUrl && typeof window !== 'undefined') {
+                const url = new URL(window.location.href);
+                if (id === undefined)
+                    url.searchParams.delete(key);
+                else
+                    url.searchParams.set(key, id);
+                // pushState, not replaceState: selecting a record is a navigation the
+                // user expects Back to undo. That is the whole point of putting it in
+                // the URL rather than in a ref.
+                if (url.href !== window.location.href)
+                    window.history.pushState({}, '', url);
+            }
+            emit();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+// ============================================================
+// CONTEXT
+// ============================================================
+export const ShellSelectionContext = React.createContext(null);
+export function ShellSelectionProvider({ syncUrl = true, children, }) {
+    const store = React.useMemo(() => createShellSelectionStore(syncUrl), [syncUrl]);
+    return _jsx(ShellSelectionContext.Provider, { value: store, children: children });
+}
+/**
+ * Read and write the shell selection for `key`.
+ *
+ * Works with OR without a provider: with no `ShellSelectionProvider` above it,
+ * the hook makes its own store, so a block dropped into a bare React tree keeps
+ * behaving instead of throwing. The provider only widens the scope — one store
+ * per surface means two blocks reading the same key see the same value.
+ */
+export function useShellSelection(key, options = {}) {
+    const provided = React.useContext(ShellSelectionContext);
+    const wantsSync = options.syncUrl ?? provided?.syncUrl ?? true;
+    // A provider whose sync setting disagrees with this block's is not usable —
+    // an inert block inside a live surface must not push history.
+    const usable = provided && provided.syncUrl === wantsSync ? provided : null;
+    const fallbackStore = React.useMemo(() => (usable ? null : createShellSelectionStore(wantsSync)), [usable, wantsSync]);
+    const store = usable ?? fallbackStore;
+    const subscribe = React.useCallback((l) => store.subscribe(l), [store]);
+    const selected = React.useSyncExternalStore(subscribe, () => store.get(key), 
+    // Server render: no URL, no memory — the fallback is the honest answer.
+    () => undefined);
+    const select = React.useCallback((id) => {
+        store.set(key, id);
+    }, [store, key]);
+    return [selected ?? options.fallback, select];
+}
+//# sourceMappingURL=shell-selection.js.map

package/dist/render/shell-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-selection.js","sourceRoot":"","sources":["../../src/render/shell-selection.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAiB9B,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAClE,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAA;IACpD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;IACrC,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;YAAE,CAAC,EAAE,CAAA;IACrC,CAAC,CAAA;IAED,IAAI,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,OAAO;QACP,GAAG,CAAC,GAAG;YACL,oEAAoE;YACpE,sDAAsD;YACtD,IAAI,OAAO;gBAAE,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACvD,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,EAAE;YACT,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;YACnB,IAAI,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBACzC,IAAI,EAAE,KAAK,SAAS;oBAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;;oBAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;gBAClC,sEAAsE;gBACtE,sEAAsE;gBACtE,gCAAgC;gBAChC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI;oBAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;YAC9E,CAAC;YACD,IAAI,EAAE,CAAA;QACR,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC5B,CAAC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,aAAa,CAA6B,IAAI,CAAC,CAAA;AAQ1F,MAAM,UAAU,sBAAsB,CAAC,EACrC,OAAO,GAAG,IAAI,EACd,QAAQ,GACoB;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAChF,OAAO,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAkC,CAAA;AAClG,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAA;IAC9D,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3E,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,EAC5D,CAAC,MAAM,EAAE,SAAS,CAAC,CACpB,CAAA;IACD,MAAM,KAAK,GAAG,MAAM,IAAK,aAAqC,CAAA;IAE9D,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB,CACzC,SAAS,EACT,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IACpB,wEAAwE;IACxE,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAC,EAAsB,EAAE,EAAE;QACzB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACpB,CAAC,EACD,CAAC,KAAK,EAAE,GAAG,CAAC,CACb,CAAA;IAED,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAU,CAAA;AACxD,CAAC","sourcesContent":["/**\n * Shell selection — the state a SPLIT shell runs on.\n *\n * WHY THIS IS IN THE RUNTIME AND NOT IN THE BLOCK. A split surface (list on the\n * left, detail on the right) has exactly one piece of state: which item is\n * selected. Kept inside the block it is invisible to everything else — the URL\n * does not move, so the page cannot be linked to, the browser Back button does\n * nothing, and a second block on the same surface (a header showing the\n * selected record's title, a toolbar acting on it) has no way to read it.\n *\n * So selection is a SURFACE-level fact with a URL projection:\n *\n *   ?<key>=<itemId>\n *\n * and this module is the single place that reads and writes it.\n *\n * THE URL IS THE SOURCE OF TRUTH when syncing is on. React state mirrors it\n * rather than the other way round, which is what makes a pasted link, a Back\n * press and a click on the list all land in the same place — three paths, one\n * rule.\n *\n * INERT HOSTS DO NOT NAVIGATE. An editor or preview canvas renders the same\n * block with `interactionMode: 'inert'`; there the selection stays in memory and\n * the host's own URL is never touched. That mirrors the existing rule for blocks\n * that navigate or write data.\n */\nimport * as React from 'react'\n\n// ============================================================\n// STORE\n// ============================================================\n\ntype Listener = () => void\n\nexport interface ShellSelectionStore {\n  /** Current selection for a key, or undefined when nothing is selected. */\n  get(key: string): string | undefined\n  /** Select an item. Writes the URL when this store syncs. */\n  set(key: string, id: string | undefined): void\n  subscribe(listener: Listener): () => void\n  readonly syncUrl: boolean\n}\n\nfunction readFromUrl(key: string): string | undefined {\n  if (typeof window === 'undefined') return undefined\n  const value = new URLSearchParams(window.location.search).get(key)\n  return value === null || value === '' ? undefined : value\n}\n\n/**\n * Create a selection store.\n *\n * `syncUrl: false` gives an in-memory store with identical semantics — the same\n * hook, the same cross-block sharing, no address-bar side effects.\n */\nexport function createShellSelectionStore(syncUrl: boolean): ShellSelectionStore {\n  const memory = new Map<string, string | undefined>()\n  const listeners = new Set<Listener>()\n  const emit = (): void => {\n    for (const l of [...listeners]) l()\n  }\n\n  if (syncUrl && typeof window !== 'undefined') {\n    window.addEventListener('popstate', emit)\n  }\n\n  return {\n    syncUrl,\n    get(key) {\n      // URL first: a Back press changes the address without going through\n      // `set`, so reading memory would serve a stale value.\n      if (syncUrl) return readFromUrl(key) ?? memory.get(key)\n      return memory.get(key)\n    },\n    set(key, id) {\n      memory.set(key, id)\n      if (syncUrl && typeof window !== 'undefined') {\n        const url = new URL(window.location.href)\n        if (id === undefined) url.searchParams.delete(key)\n        else url.searchParams.set(key, id)\n        // pushState, not replaceState: selecting a record is a navigation the\n        // user expects Back to undo. That is the whole point of putting it in\n        // the URL rather than in a ref.\n        if (url.href !== window.location.href) window.history.pushState({}, '', url)\n      }\n      emit()\n    },\n    subscribe(listener) {\n      listeners.add(listener)\n      return () => {\n        listeners.delete(listener)\n      }\n    },\n  }\n}\n\n// ============================================================\n// CONTEXT\n// ============================================================\n\nexport const ShellSelectionContext = React.createContext<ShellSelectionStore | null>(null)\n\nexport interface ShellSelectionProviderProps {\n  /** Off for editor/preview canvases — selection works, the address bar does not move. */\n  readonly syncUrl?: boolean\n  readonly children: React.ReactNode\n}\n\nexport function ShellSelectionProvider({\n  syncUrl = true,\n  children,\n}: ShellSelectionProviderProps): React.ReactElement {\n  const store = React.useMemo(() => createShellSelectionStore(syncUrl), [syncUrl])\n  return <ShellSelectionContext.Provider value={store}>{children}</ShellSelectionContext.Provider>\n}\n\n// ============================================================\n// HOOK\n// ============================================================\n\nexport interface ShellSelectionOptions {\n  /** Selected when the URL carries nothing — normally the first list item. */\n  readonly fallback?: string | undefined\n  /**\n   * Override the provider. A block rendered inert must not move the host's URL\n   * even when the surrounding surface is live.\n   */\n  readonly syncUrl?: boolean\n}\n\n/**\n * Read and write the shell selection for `key`.\n *\n * Works with OR without a provider: with no `ShellSelectionProvider` above it,\n * the hook makes its own store, so a block dropped into a bare React tree keeps\n * behaving instead of throwing. The provider only widens the scope — one store\n * per surface means two blocks reading the same key see the same value.\n */\nexport function useShellSelection(\n  key: string,\n  options: ShellSelectionOptions = {}\n): readonly [string | undefined, (id: string | undefined) => void] {\n  const provided = React.useContext(ShellSelectionContext)\n  const wantsSync = options.syncUrl ?? provided?.syncUrl ?? true\n  // A provider whose sync setting disagrees with this block's is not usable —\n  // an inert block inside a live surface must not push history.\n  const usable = provided && provided.syncUrl === wantsSync ? provided : null\n  const fallbackStore = React.useMemo(\n    () => (usable ? null : createShellSelectionStore(wantsSync)),\n    [usable, wantsSync]\n  )\n  const store = usable ?? (fallbackStore as ShellSelectionStore)\n\n  const subscribe = React.useCallback((l: Listener) => store.subscribe(l), [store])\n  const selected = React.useSyncExternalStore(\n    subscribe,\n    () => store.get(key),\n    // Server render: no URL, no memory — the fallback is the honest answer.\n    () => undefined\n  )\n\n  const select = React.useCallback(\n    (id: string | undefined) => {\n      store.set(key, id)\n    },\n    [store, key]\n  )\n\n  return [selected ?? options.fallback, select] as const\n}\n"]}

package/dist/render/states-css.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Interaction-state CSS generation (token-driven hover/active/focus).
+ *
+ * `block.style` sits inline and cannot express pseudo-classes, so per-state
+ * styling lives in `block.states` and the runtime emits scoped CSS rules —
+ * keyed by the block's `data-block-id` — into the surface's generated
+ * `<style>` (the SAME mechanism `layout.hideOn`/`showOn` use). For a block
+ * with `states`, the runtime emits:
+ *
+ *   `[data-pw-surface] [data-block-id="<id>"]:hover{ … }`
+ *   `[data-pw-surface] [data-block-id="<id>"]:active{ … }`
+ *   `[data-pw-surface] [data-block-id="<id>"]:focus-visible{ … }`
+ *
+ * Keys are CSS camelCase property names (converted to kebab-case); values pass
+ * through untouched, so `var(--pw-color-primary-subtle)` works. Blocks without
+ * `states` emit zero bytes so existing surfaces are byte-identical.
+ *
+ * @module @pwfabric/runtime/render/states-css
+ */
+import type { Block } from '@pwfabric/core';
+/**
+ * Emit the scoped CSS rule(s) for a single block's interaction states. Targets
+ * `[data-block-id="<id>"]<pseudo>` scoped under the surface root so it cannot
+ * leak to the host page. Returns '' when the block declares no non-empty state.
+ */
+export declare function blockStatesCss(blockId: string, states: NonNullable<Block['states']>, surfaceId?: string): string;
+/**
+ * Walk a surface block tree and concatenate the per-block interaction-state CSS
+ * for every block declaring `states`. Blocks without `states` are skipped (zero
+ * bytes emitted) so existing surfaces are byte-identical.
+ */
+export declare function collectStatesCss(blocks: readonly Block[], surfaceId?: string): string;

package/dist/render/states-css.js

@@ -0,0 +1,63 @@
+/**
+ * Interaction-state CSS generation (token-driven hover/active/focus).
+ *
+ * `block.style` sits inline and cannot express pseudo-classes, so per-state
+ * styling lives in `block.states` and the runtime emits scoped CSS rules —
+ * keyed by the block's `data-block-id` — into the surface's generated
+ * `<style>` (the SAME mechanism `layout.hideOn`/`showOn` use). For a block
+ * with `states`, the runtime emits:
+ *
+ *   `[data-pw-surface] [data-block-id="<id>"]:hover{ … }`
+ *   `[data-pw-surface] [data-block-id="<id>"]:active{ … }`
+ *   `[data-pw-surface] [data-block-id="<id>"]:focus-visible{ … }`
+ *
+ * Keys are CSS camelCase property names (converted to kebab-case); values pass
+ * through untouched, so `var(--pw-color-primary-subtle)` works. Blocks without
+ * `states` emit zero bytes so existing surfaces are byte-identical.
+ *
+ * @module @pwfabric/runtime/render/states-css
+ */
+import { blockSelector, camelToKebab, collectScopedCss } from './scoped-css.js';
+/** Pseudo-state → selector suffix. `focus` maps to `:focus-visible`. */
+const STATE_SELECTORS = {
+    hover: ':hover',
+    active: ':active',
+    focus: ':focus-visible',
+};
+/** Serialize a camelCase decl record to `prop:value;…` (values pass through). */
+function declsToCss(decls) {
+    return Object.entries(decls)
+        .map(([prop, value]) => `${camelToKebab(prop)}:${value}`)
+        .join(';');
+}
+/**
+ * Emit the scoped CSS rule(s) for a single block's interaction states. Targets
+ * `[data-block-id="<id>"]<pseudo>` scoped under the surface root so it cannot
+ * leak to the host page. Returns '' when the block declares no non-empty state.
+ */
+export function blockStatesCss(blockId, states, surfaceId) {
+    const selector = blockSelector(blockId, surfaceId);
+    let css = '';
+    for (const key of ['hover', 'active', 'focus']) {
+        const decls = states[key];
+        if (!decls || Object.keys(decls).length === 0)
+            continue;
+        // `data-block-id` lives on BOTH the renderer wrapper and the component root
+        // (the wrapper keeps `data-block-wrapper`). A state rule keyed on the bare
+        // id therefore fired twice: the square wrapper took the hover box-shadow
+        // (square corners bleeding out from under a rounded card) and transforms
+        // compounded. Exclude the wrapper — visual states belong to the styled
+        // component root only.
+        css += `${selector}:not([data-block-wrapper])${STATE_SELECTORS[key]}{${declsToCss(decls)}}`;
+    }
+    return css;
+}
+/**
+ * Walk a surface block tree and concatenate the per-block interaction-state CSS
+ * for every block declaring `states`. Blocks without `states` are skipped (zero
+ * bytes emitted) so existing surfaces are byte-identical.
+ */
+export function collectStatesCss(blocks, surfaceId) {
+    return collectScopedCss(blocks, (block) => block.states ? blockStatesCss(block.id, block.states, surfaceId) : '');
+}
+//# sourceMappingURL=states-css.js.map

package/dist/render/states-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"states-css.js","sourceRoot":"","sources":["../../src/render/states-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAE/E,wEAAwE;AACxE,MAAM,eAAe,GAAiD;IACpE,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,gBAAgB;CACxB,CAAA;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,KAAuC;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;SACxD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,MAAoC,EACpC,SAAkB;IAElB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAClD,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QACvD,4EAA4E;QAC5E,2EAA2E;QAC3E,yEAAyE;QACzE,yEAAyE;QACzE,uEAAuE;QACvE,uBAAuB;QACvB,GAAG,IAAI,GAAG,QAAQ,6BAA6B,eAAe,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAA;IAC7F,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB,EAAE,SAAkB;IAC3E,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CACxC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CACtE,CAAA;AACH,CAAC","sourcesContent":["/**\n * Interaction-state CSS generation (token-driven hover/active/focus).\n *\n * `block.style` sits inline and cannot express pseudo-classes, so per-state\n * styling lives in `block.states` and the runtime emits scoped CSS rules —\n * keyed by the block's `data-block-id` — into the surface's generated\n * `<style>` (the SAME mechanism `layout.hideOn`/`showOn` use). For a block\n * with `states`, the runtime emits:\n *\n *   `[data-pw-surface] [data-block-id=\"<id>\"]:hover{ … }`\n *   `[data-pw-surface] [data-block-id=\"<id>\"]:active{ … }`\n *   `[data-pw-surface] [data-block-id=\"<id>\"]:focus-visible{ … }`\n *\n * Keys are CSS camelCase property names (converted to kebab-case); values pass\n * through untouched, so `var(--pw-color-primary-subtle)` works. Blocks without\n * `states` emit zero bytes so existing surfaces are byte-identical.\n *\n * @module @pwfabric/runtime/render/states-css\n */\n\nimport type { Block } from '@pwfabric/core'\nimport { blockSelector, camelToKebab, collectScopedCss } from './scoped-css.js'\n\n/** Pseudo-state → selector suffix. `focus` maps to `:focus-visible`. */\nconst STATE_SELECTORS: Record<'hover' | 'active' | 'focus', string> = {\n  hover: ':hover',\n  active: ':active',\n  focus: ':focus-visible',\n}\n\n/** Serialize a camelCase decl record to `prop:value;…` (values pass through). */\nfunction declsToCss(decls: Readonly<Record<string, string>>): string {\n  return Object.entries(decls)\n    .map(([prop, value]) => `${camelToKebab(prop)}:${value}`)\n    .join(';')\n}\n\n/**\n * Emit the scoped CSS rule(s) for a single block's interaction states. Targets\n * `[data-block-id=\"<id>\"]<pseudo>` scoped under the surface root so it cannot\n * leak to the host page. Returns '' when the block declares no non-empty state.\n */\nexport function blockStatesCss(\n  blockId: string,\n  states: NonNullable<Block['states']>,\n  surfaceId?: string\n): string {\n  const selector = blockSelector(blockId, surfaceId)\n  let css = ''\n  for (const key of ['hover', 'active', 'focus'] as const) {\n    const decls = states[key]\n    if (!decls || Object.keys(decls).length === 0) continue\n    // `data-block-id` lives on BOTH the renderer wrapper and the component root\n    // (the wrapper keeps `data-block-wrapper`). A state rule keyed on the bare\n    // id therefore fired twice: the square wrapper took the hover box-shadow\n    // (square corners bleeding out from under a rounded card) and transforms\n    // compounded. Exclude the wrapper — visual states belong to the styled\n    // component root only.\n    css += `${selector}:not([data-block-wrapper])${STATE_SELECTORS[key]}{${declsToCss(decls)}}`\n  }\n  return css\n}\n\n/**\n * Walk a surface block tree and concatenate the per-block interaction-state CSS\n * for every block declaring `states`. Blocks without `states` are skipped (zero\n * bytes emitted) so existing surfaces are byte-identical.\n */\nexport function collectStatesCss(blocks: readonly Block[], surfaceId?: string): string {\n  return collectScopedCss(blocks, (block) =>\n    block.states ? blockStatesCss(block.id, block.states, surfaceId) : ''\n  )\n}\n"]}

package/dist/render/surface-data-context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Surface Data Context
+ *
+ * What the data-bound renderer has CURRENTLY bound, keyed by source id — the
+ * same object block expressions resolve `{{<sourceId>}}` against, offered to
+ * the providers that sit between the data layer and the blocks.
+ *
+ * The form writer needs it: a binding that says `PATCH` can only name a
+ * record the page has loaded, and until this context existed the writer
+ * could not see one — so it patched the collection path and the API said
+ * 404. `null` outside the data-bound path (behaviours-only surfaces, plain
+ * `SurfaceRenderer`), where there is nothing bound to consult.
+ *
+ * @module @pwfabric/runtime/render/surface-data-context
+ */
+export type SurfaceData = Readonly<Record<string, unknown>>;
+export declare const SurfaceDataContext: import("react").Context<Readonly<Record<string, unknown>> | null>;
+export declare function useSurfaceData(): SurfaceData | null;

package/dist/render/surface-data-context.js

@@ -0,0 +1,21 @@
+/**
+ * Surface Data Context
+ *
+ * What the data-bound renderer has CURRENTLY bound, keyed by source id — the
+ * same object block expressions resolve `{{<sourceId>}}` against, offered to
+ * the providers that sit between the data layer and the blocks.
+ *
+ * The form writer needs it: a binding that says `PATCH` can only name a
+ * record the page has loaded, and until this context existed the writer
+ * could not see one — so it patched the collection path and the API said
+ * 404. `null` outside the data-bound path (behaviours-only surfaces, plain
+ * `SurfaceRenderer`), where there is nothing bound to consult.
+ *
+ * @module @pwfabric/runtime/render/surface-data-context
+ */
+import { createContext, useContext } from 'react';
+export const SurfaceDataContext = createContext(null);
+export function useSurfaceData() {
+    return useContext(SurfaceDataContext);
+}
+//# sourceMappingURL=surface-data-context.js.map

package/dist/render/surface-data-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-data-context.js","sourceRoot":"","sources":["../../src/render/surface-data-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAEzE,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAA;AACvC,CAAC","sourcesContent":["/**\n * Surface Data Context\n *\n * What the data-bound renderer has CURRENTLY bound, keyed by source id — the\n * same object block expressions resolve `{{<sourceId>}}` against, offered to\n * the providers that sit between the data layer and the blocks.\n *\n * The form writer needs it: a binding that says `PATCH` can only name a\n * record the page has loaded, and until this context existed the writer\n * could not see one — so it patched the collection path and the API said\n * 404. `null` outside the data-bound path (behaviours-only surfaces, plain\n * `SurfaceRenderer`), where there is nothing bound to consult.\n *\n * @module @pwfabric/runtime/render/surface-data-context\n */\n\nimport { createContext, useContext } from 'react'\n\nexport type SurfaceData = Readonly<Record<string, unknown>>\n\nexport const SurfaceDataContext = createContext<SurfaceData | null>(null)\n\nexport function useSurfaceData(): SurfaceData | null {\n  return useContext(SurfaceDataContext)\n}\n"]}

package/dist/render/surface-event-bus.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Surface Event Bus Implementation
+ *
+ * In-process pub/sub bus scoped to a single rendered surface.
+ *
+ * @module @pwfabric/runtime/render/surface-event-bus
+ */
+import type { SurfaceEventBus } from '@pwfabric/contracts';
+/**
+ * Create a new `SurfaceEventBus` instance.
+ *
+ * Each surface renderer creates its own bus so that events from one surface
+ * do not leak into sibling or parent surfaces.
+ *
+ * Wildcard support: listeners registered as `"<namespace>:*"` (e.g.
+ * `"capability:*"`) receive every event whose type starts with that namespace
+ * prefix (e.g. `"capability:data-loaded"`).
+ */
+export declare function createSurfaceEventBus(): SurfaceEventBus;

package/dist/render/surface-event-bus.js

@@ -0,0 +1,68 @@
+/**
+ * Surface Event Bus Implementation
+ *
+ * In-process pub/sub bus scoped to a single rendered surface.
+ *
+ * @module @pwfabric/runtime/render/surface-event-bus
+ */
+/**
+ * Create a new `SurfaceEventBus` instance.
+ *
+ * Each surface renderer creates its own bus so that events from one surface
+ * do not leak into sibling or parent surfaces.
+ *
+ * Wildcard support: listeners registered as `"<namespace>:*"` (e.g.
+ * `"capability:*"`) receive every event whose type starts with that namespace
+ * prefix (e.g. `"capability:data-loaded"`).
+ */
+export function createSurfaceEventBus() {
+    const handlers = new Map();
+    return {
+        emit(event) {
+            // Dev-mode payload validation — async/lazy, does not block emit
+            if (process.env.NODE_ENV === 'development') {
+                // Import lazily to avoid prod bundle size impact
+                void import('@pwfabric/contracts').then(({ SURFACE_EVENT_PAYLOAD_SCHEMAS }) => {
+                    const schema = SURFACE_EVENT_PAYLOAD_SCHEMAS[event.type];
+                    if (schema && event.payload !== undefined) {
+                        const result = schema.safeParse(event.payload);
+                        if (!result.success) {
+                            console.warn(`[SurfaceEventBus] Payload validation warning for '${event.type}':`, result.error.flatten());
+                        }
+                    }
+                });
+            }
+            // Exact-match listeners
+            const exactSet = handlers.get(event.type);
+            if (exactSet) {
+                exactSet.forEach((h) => h(event));
+            }
+            // Wildcard listeners for the namespace prefix (e.g. "block:*")
+            const ns = event.type.split(':')[0];
+            const wildcardSet = handlers.get(`${ns}:*`);
+            if (wildcardSet) {
+                wildcardSet.forEach((h) => h(event));
+            }
+            // Global wildcard "*" — every event. The surface renderer subscribes its
+            // single event handler here so block-emitted events (with their full
+            // payload, incl. a declarative `action`) reach the action dispatcher. This
+            // is what lets a form's submit→setState run via the canonical bus path
+            // instead of the retired legacy `context.onEvent` shim.
+            const globalSet = handlers.get('*');
+            if (globalSet) {
+                globalSet.forEach((h) => h(event));
+            }
+        },
+        on(eventType, handler) {
+            if (!handlers.has(eventType)) {
+                handlers.set(eventType, new Set());
+            }
+            handlers.get(eventType)?.add(handler);
+            return () => handlers.get(eventType)?.delete(handler);
+        },
+        off(eventType, handler) {
+            handlers.get(eventType)?.delete(handler);
+        },
+    };
+}
+//# sourceMappingURL=surface-event-bus.js.map

package/dist/render/surface-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-event-bus.js","sourceRoot":"","sources":["../../src/render/surface-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoC,CAAA;IAE5D,OAAO;QACL,IAAI,CAAC,KAA6B;YAChC,gEAAgE;YAChE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC3C,iDAAiD;gBACjD,KAAK,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,6BAA6B,EAAE,EAAE,EAAE;oBAC5E,MAAM,MAAM,GACV,6BAA6B,CAAC,KAAK,CAAC,IAAkD,CAAC,CAAA;oBACzF,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;wBAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;4BACpB,OAAO,CAAC,IAAI,CACV,qDAAqD,KAAK,CAAC,IAAI,IAAI,EACnE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACvB,CAAA;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,wBAAwB;YACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;YACnC,CAAC;YAED,+DAA+D;YAC/D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACnC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3C,IAAI,WAAW,EAAE,CAAC;gBAChB,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;YACtC,CAAC;YAED,yEAAyE;YACzE,qEAAqE;YACrE,2EAA2E;YAC3E,uEAAuE;YACvE,wDAAwD;YACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;QAED,EAAE,CAAC,SAAiB,EAAE,OAA4B;YAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;YACpC,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;YACrC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACvD,CAAC;QAED,GAAG,CAAC,SAAiB,EAAE,OAA4B;YACjD,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Surface Event Bus Implementation\n *\n * In-process pub/sub bus scoped to a single rendered surface.\n *\n * @module @pwfabric/runtime/render/surface-event-bus\n */\n\nimport type {\n  SurfaceEventBus,\n  SurfaceEventDescriptor,\n  SurfaceEventHandler,\n  Unsubscribe,\n} from '@pwfabric/contracts'\n\n/**\n * Create a new `SurfaceEventBus` instance.\n *\n * Each surface renderer creates its own bus so that events from one surface\n * do not leak into sibling or parent surfaces.\n *\n * Wildcard support: listeners registered as `\"<namespace>:*\"` (e.g.\n * `\"capability:*\"`) receive every event whose type starts with that namespace\n * prefix (e.g. `\"capability:data-loaded\"`).\n */\nexport function createSurfaceEventBus(): SurfaceEventBus {\n  const handlers = new Map<string, Set<SurfaceEventHandler>>()\n\n  return {\n    emit(event: SurfaceEventDescriptor): void {\n      // Dev-mode payload validation — async/lazy, does not block emit\n      if (process.env.NODE_ENV === 'development') {\n        // Import lazily to avoid prod bundle size impact\n        void import('@pwfabric/contracts').then(({ SURFACE_EVENT_PAYLOAD_SCHEMAS }) => {\n          const schema =\n            SURFACE_EVENT_PAYLOAD_SCHEMAS[event.type as keyof typeof SURFACE_EVENT_PAYLOAD_SCHEMAS]\n          if (schema && event.payload !== undefined) {\n            const result = schema.safeParse(event.payload)\n            if (!result.success) {\n              console.warn(\n                `[SurfaceEventBus] Payload validation warning for '${event.type}':`,\n                result.error.flatten()\n              )\n            }\n          }\n        })\n      }\n\n      // Exact-match listeners\n      const exactSet = handlers.get(event.type)\n      if (exactSet) {\n        exactSet.forEach((h) => h(event))\n      }\n\n      // Wildcard listeners for the namespace prefix (e.g. \"block:*\")\n      const ns = event.type.split(':')[0]\n      const wildcardSet = handlers.get(`${ns}:*`)\n      if (wildcardSet) {\n        wildcardSet.forEach((h) => h(event))\n      }\n\n      // Global wildcard \"*\" — every event. The surface renderer subscribes its\n      // single event handler here so block-emitted events (with their full\n      // payload, incl. a declarative `action`) reach the action dispatcher. This\n      // is what lets a form's submit→setState run via the canonical bus path\n      // instead of the retired legacy `context.onEvent` shim.\n      const globalSet = handlers.get('*')\n      if (globalSet) {\n        globalSet.forEach((h) => h(event))\n      }\n    },\n\n    on(eventType: string, handler: SurfaceEventHandler): Unsubscribe {\n      if (!handlers.has(eventType)) {\n        handlers.set(eventType, new Set())\n      }\n      handlers.get(eventType)?.add(handler)\n      return () => handlers.get(eventType)?.delete(handler)\n    },\n\n    off(eventType: string, handler: SurfaceEventHandler): void {\n      handlers.get(eventType)?.delete(handler)\n    },\n  }\n}\n"]}

package/dist/render/surface-event-context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Surface Event Context
+ *
+ * Re-exports the canonical `SurfaceEventContext` from `@pwfabric/runtime/blocks`.
+ * Runtime code that sets the context via
+ * `BehaviorSurfaceProvider` and block components that consume it via
+ * `useSurfaceEvents` share the same context object through this re-export.
+ *
+ * @module @pwfabric/runtime/render/surface-event-context
+ */
+export { SurfaceEventContext } from '../blocks/surface-event-context.js';

package/dist/render/surface-event-context.js

@@ -0,0 +1,12 @@
+/**
+ * Surface Event Context
+ *
+ * Re-exports the canonical `SurfaceEventContext` from `@pwfabric/runtime/blocks`.
+ * Runtime code that sets the context via
+ * `BehaviorSurfaceProvider` and block components that consume it via
+ * `useSurfaceEvents` share the same context object through this re-export.
+ *
+ * @module @pwfabric/runtime/render/surface-event-context
+ */
+export { SurfaceEventContext } from '../blocks/surface-event-context.js';
+//# sourceMappingURL=surface-event-context.js.map

package/dist/render/surface-event-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-event-context.js","sourceRoot":"","sources":["../../src/render/surface-event-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA","sourcesContent":["/**\n * Surface Event Context\n *\n * Re-exports the canonical `SurfaceEventContext` from `@pwfabric/runtime/blocks`.\n * Runtime code that sets the context via\n * `BehaviorSurfaceProvider` and block components that consume it via\n * `useSurfaceEvents` share the same context object through this re-export.\n *\n * @module @pwfabric/runtime/render/surface-event-context\n */\n\nexport { SurfaceEventContext } from '../blocks/surface-event-context.js'\n"]}

package/dist/render/surface-id-context.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Surface ID Context
+ *
+ * Re-exports the canonical `SurfaceIdContext` from `@pwfabric/runtime/blocks`.
+ *
+ * @module @pwfabric/runtime/render/surface-id-context
+ */
+export { SurfaceIdContext } from '../blocks/surface-id-context.js';

package/dist/render/surface-id-context.js

@@ -0,0 +1,9 @@
+/**
+ * Surface ID Context
+ *
+ * Re-exports the canonical `SurfaceIdContext` from `@pwfabric/runtime/blocks`.
+ *
+ * @module @pwfabric/runtime/render/surface-id-context
+ */
+export { SurfaceIdContext } from '../blocks/surface-id-context.js';
+//# sourceMappingURL=surface-id-context.js.map

package/dist/render/surface-id-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-id-context.js","sourceRoot":"","sources":["../../src/render/surface-id-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA","sourcesContent":["/**\n * Surface ID Context\n *\n * Re-exports the canonical `SurfaceIdContext` from `@pwfabric/runtime/blocks`.\n *\n * @module @pwfabric/runtime/render/surface-id-context\n */\n\nexport { SurfaceIdContext } from '../blocks/surface-id-context.js'\n"]}

package/dist/render/theme-utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Surface Theme Utilities
+ *
+ * Surface Theme Engine — converts SurfaceTheme to CSS custom properties.
+ *
+ * The implementation MOVED to `@pwfabric/contracts`
+ * (`fabric/appearance-cascade`) shared with the theme exporter (export
+ * `theme.css`) and the authoring studio (bake the dark variant at write time) need the same
+ * transform, and `contracts` is the only leaf all three can reach. This module
+ * stays as the runtime-facing name so existing import paths keep working.
+ *
+ * @module @pwfabric/runtime/render/theme-utils
+ */
+export { surfaceThemeToCSS } from '@pwfabric/contracts';

package/dist/render/theme-utils.js

@@ -0,0 +1,15 @@
+/**
+ * Surface Theme Utilities
+ *
+ * Surface Theme Engine — converts SurfaceTheme to CSS custom properties.
+ *
+ * The implementation MOVED to `@pwfabric/contracts`
+ * (`fabric/appearance-cascade`) shared with the theme exporter (export
+ * `theme.css`) and the authoring studio (bake the dark variant at write time) need the same
+ * transform, and `contracts` is the only leaf all three can reach. This module
+ * stays as the runtime-facing name so existing import paths keep working.
+ *
+ * @module @pwfabric/runtime/render/theme-utils
+ */
+export { surfaceThemeToCSS } from '@pwfabric/contracts';
+//# sourceMappingURL=theme-utils.js.map

package/dist/render/theme-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-utils.js","sourceRoot":"","sources":["../../src/render/theme-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA","sourcesContent":["/**\n * Surface Theme Utilities\n *\n * Surface Theme Engine — converts SurfaceTheme to CSS custom properties.\n *\n * The implementation MOVED to `@pwfabric/contracts`\n * (`fabric/appearance-cascade`) shared with the theme exporter (export\n * `theme.css`) and the authoring studio (bake the dark variant at write time) need the same\n * transform, and `contracts` is the only leaf all three can reach. This module\n * stays as the runtime-facing name so existing import paths keep working.\n *\n * @module @pwfabric/runtime/render/theme-utils\n */\n\nexport { surfaceThemeToCSS } from '@pwfabric/contracts'\n"]}