@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/hooks/use-repeat-preview.d.ts

@@ -0,0 +1,64 @@
+import { type RepeatableDataset, type RepeatScope } from '@aglyn/aglyn/app-utils/expand-repeatables';
+/** What a repeating element draws on the canvas. */
+export interface RepeatPreview {
+    /** What authors call the thing being repeated, for the badge. */
+    label: string;
+    /**
+     * The records this element renders, in order, bounded exactly as the
+     * published page's composition bounds them.
+     */
+    records: ReadonlyArray<Record<string, unknown>>;
+    /** Which scope applies, so the canvas draws what the page will build. */
+    scope: RepeatScope;
+    /** The repeated rows, for the token substitution's reference hops. */
+    dataset?: RepeatableDataset;
+    /** Every key the rows answered under, for a one-hop reference (AGL-180). */
+    datasetsByKey?: Readonly<Record<string, RepeatableDataset>>;
+}
+/**
+ * The rows a canvas element repeats over, and the copies it therefore draws
+ * (AGL-3111).
+ *
+ * The designer cannot read them itself — it renders inside a plugin sandbox,
+ * and which documents hold them is the source's business — so this HOLDS the
+ * request and reads back whatever the host app's reader filed. Without a
+ * provider, or before an answer, it returns `undefined` and the element draws
+ * its template once, the way the canvas always did.
+ *
+ * The records are {@link repeatedRecords}, not a second reading of the same
+ * props: the filter, the sort, the limit and `REPEAT_MAX_RECORDS` are applied
+ * by the function the page applies them with, so a copy on the canvas is a
+ * copy a visitor gets.
+ */
+export declare function useRepeatPreview(node: unknown): RepeatPreview | undefined;
+/**
+ * The copies a repeating element draws BESIDE the one an author edits
+ * (AGL-3111): records 2..n, as denormalized trees ready for an inert render.
+ *
+ * The first record is deliberately missing. It is drawn by the element's own
+ * children — the real canvas nodes, selectable and draggable, with that
+ * record's values laid over their render copies through
+ * {@link RepeatRecordContext}. That is what makes editing the template edit
+ * every copy: there is one template, it is on the canvas, and the copies are
+ * pictures of it.
+ *
+ * Built by running the published page's own {@link expandRepeatables} over a
+ * snapshot of this subtree, so the canvas cannot draw a shape the page would
+ * not compose.
+ */
+export declare function useRepeatCopies(node: {
+    $id?: string;
+    parentId?: string;
+} | null | undefined, preview: RepeatPreview | undefined): any[];
+/**
+ * A node's render copy with the record its subtree is drawing laid over it
+ * (AGL-3111).
+ *
+ * Inside a repeating element the FIRST record's values belong on the real
+ * canvas nodes, so the element an author edits reads as the first copy rather
+ * than as a row of raw `{{item.*}}` tokens beside the copies that resolved
+ * them. Render copies only — the node keeps its tokens, and every save writes
+ * the template.
+ */
+export declare function useNodeWithRepeatRecord<N>(node: N): N;
+export default useRepeatPreview;

package/src/lib/hooks/use-repeat-preview.js

@@ -0,0 +1,214 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { canvas } from "@aglyn/aglyn";
+// By path: the repeat rules and the source registry stay out of every
+// `@aglyn/aglyn` barrel, so nothing on a published page can pull them in.
+import { expandRepeatables, repeatedRecords, repeatScope, substituteRecordTokens } from "@aglyn/aglyn/app-utils/expand-repeatables";
+import { repeatSourceOf } from "@aglyn/aglyn/app-utils/repeat-sources";
+import { useContext, useEffect, useMemo, useSyncExternalStore } from "react";
+import { RepeatRowsContext, repeatRowsKey } from "../contexts/repeat-rows-context.js";
+import { RepeatRecordContext } from "../contexts/repeat-record-context.js";
+const subscribeToNothing = ()=>()=>undefined;
+const noVersion = ()=>0;
+/**
+ * The rows a canvas element repeats over, and the copies it therefore draws
+ * (AGL-3111).
+ *
+ * The designer cannot read them itself — it renders inside a plugin sandbox,
+ * and which documents hold them is the source's business — so this HOLDS the
+ * request and reads back whatever the host app's reader filed. Without a
+ * provider, or before an answer, it returns `undefined` and the element draws
+ * its template once, the way the canvas always did.
+ *
+ * The records are {@link repeatedRecords}, not a second reading of the same
+ * props: the filter, the sort, the limit and `REPEAT_MAX_RECORDS` are applied
+ * by the function the page applies them with, so a copy on the canvas is a
+ * copy a visitor gets.
+ */ export function useRepeatPreview(node) {
+    const source = useContext(RepeatRowsContext);
+    const props = node == null ? void 0 : node.props;
+    // MobX props are observable and change in place; their JSON keys the memos
+    // below, the way every other render copy in the canvas is keyed.
+    const propsJson = JSON.stringify(props != null ? props : null);
+    const request = useMemo(()=>{
+        const repeat = source ? repeatSourceOf({
+            props
+        }) : undefined;
+        return repeat ? {
+            sourceId: repeat.source.id,
+            key: repeat.key,
+            label: repeat.source.label
+        } : undefined;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        source,
+        props,
+        propsJson
+    ]);
+    const key = request ? repeatRowsKey(request) : '';
+    useEffect(()=>{
+        if (!source || !request) return undefined;
+        return source.retain(request);
+    // `key` stands in for `request`: the same source and key keeps the read
+    // it already holds rather than dropping and re-taking it.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        source,
+        key
+    ]);
+    const version = useSyncExternalStore(source && request ? source.subscribe : subscribeToNothing, source ? source.getVersion : noVersion, noVersion);
+    return useMemo(()=>{
+        if (!source || !request) return undefined;
+        const answer = source.get(key);
+        if ((answer == null ? void 0 : answer.status) !== 'ready') return undefined;
+        const dataset = answer.rowsByKey[request.key];
+        const records = repeatedRecords({
+            props
+        }, dataset);
+        if (!records.length) return undefined;
+        return {
+            label: answer.label,
+            records,
+            scope: repeatScope(node),
+            dataset,
+            datasetsByKey: answer.rowsByKey
+        };
+    // `version` carries a new answer in; the body reads it through `get`.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        source,
+        request,
+        key,
+        version,
+        node,
+        props,
+        propsJson
+    ]);
+}
+/**
+ * The stored subtree under `rootId`, as a plain snapshot.
+ *
+ * Canvas nodes are MobX observables the expansion must not read through — it
+ * copies props by reference into the copies it builds, and an observable read
+ * outside a reaction is both a stale value and a missing dependency.
+ */ function subtreeSnapshot(rootId) {
+    var _canvas_toJSON_nodes;
+    const nodes = (_canvas_toJSON_nodes = canvas.toJSON().nodes) != null ? _canvas_toJSON_nodes : {};
+    const snapshot = {};
+    const walk = (id)=>{
+        var _node_nodes;
+        const node = nodes[id];
+        if (!node || snapshot[id]) return;
+        snapshot[id] = JSON.parse(JSON.stringify(node));
+        for (const childId of (_node_nodes = node.nodes) != null ? _node_nodes : [])walk(childId);
+    };
+    walk(rootId);
+    return snapshot;
+}
+/**
+ * The copies a repeating element draws BESIDE the one an author edits
+ * (AGL-3111): records 2..n, as denormalized trees ready for an inert render.
+ *
+ * The first record is deliberately missing. It is drawn by the element's own
+ * children — the real canvas nodes, selectable and draggable, with that
+ * record's values laid over their render copies through
+ * {@link RepeatRecordContext}. That is what makes editing the template edit
+ * every copy: there is one template, it is on the canvas, and the copies are
+ * pictures of it.
+ *
+ * Built by running the published page's own {@link expandRepeatables} over a
+ * snapshot of this subtree, so the canvas cannot draw a shape the page would
+ * not compose.
+ */ export function useRepeatCopies(node, preview) {
+    var _ref;
+    const $id = node == null ? void 0 : node.$id;
+    const recordCount = (_ref = preview == null ? void 0 : preview.records.length) != null ? _ref : 0;
+    const key = preview ? `${$id}\n${preview.scope}\n${JSON.stringify(preview.records)}` : '';
+    return useMemo(()=>{
+        var _preview_datasetsByKey, _ref, _ref1, _ref2;
+        var _expanded_holderId, _expanded_$id, // One template's worth of children per record: the first
+        // record's copies are the ones the real children already draw.
+        _expanded_$id1;
+        if (!$id || !preview || recordCount < 2) return [];
+        const snapshot = subtreeSnapshot($id);
+        if (!snapshot[$id]) return [];
+        // A parent the copies can take their place in. The real parent is not in
+        // this snapshot — only the subtree is — so a self-scoped repeat is given
+        // a holder that lists it, which is all the expansion reads a parent for.
+        const holderId = `${$id}__repeat-preview-parent`;
+        snapshot[$id] = _extends({}, snapshot[$id], {
+            parentId: holderId
+        });
+        snapshot[holderId] = {
+            $id: holderId,
+            nodes: [
+                $id
+            ]
+        };
+        const expanded = expandRepeatables(snapshot, _extends({}, (_preview_datasetsByKey = preview.datasetsByKey) != null ? _preview_datasetsByKey : {}));
+        const copyIds = preview.scope === 'self' ? ((_ref = (_expanded_holderId = expanded[holderId]) == null ? void 0 : _expanded_holderId.nodes) != null ? _ref : []).slice(1) : ((_ref1 = (_expanded_$id = expanded[$id]) == null ? void 0 : _expanded_$id.nodes) != null ? _ref1 : []).slice(((_ref2 = (_expanded_$id1 = expanded[$id]) == null ? void 0 : _expanded_$id1.nodes) != null ? _ref2 : []).length / recordCount);
+        return copyIds.map((id)=>denormalize(expanded, id)).filter(Boolean);
+    // `key` stands in for the records and the node; both are snapshots.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        $id,
+        key,
+        recordCount
+    ]);
+}
+/** Nested-object form of an expanded map, which is what `Stem` walks. */ function denormalize(nodes, rootId, seen = new Set()) {
+    var _node_nodes;
+    const node = nodes == null ? void 0 : nodes[rootId];
+    if (!node || seen.has(rootId)) return undefined;
+    seen.add(rootId);
+    return _extends({}, node, {
+        children: ((_node_nodes = node.nodes) != null ? _node_nodes : []).map((childId)=>denormalize(nodes, childId, seen)).filter(Boolean)
+    });
+}
+/**
+ * A node's render copy with the record its subtree is drawing laid over it
+ * (AGL-3111).
+ *
+ * Inside a repeating element the FIRST record's values belong on the real
+ * canvas nodes, so the element an author edits reads as the first copy rather
+ * than as a row of raw `{{item.*}}` tokens beside the copies that resolved
+ * them. Render copies only — the node keeps its tokens, and every save writes
+ * the template.
+ */ export function useNodeWithRepeatRecord(node) {
+    var _ref;
+    const context = useContext(RepeatRecordContext);
+    const rendered = node;
+    const propsJson = context ? JSON.stringify((_ref = rendered == null ? void 0 : rendered.props) != null ? _ref : null) : '';
+    return useMemo(()=>{
+        if (!context || !(rendered == null ? void 0 : rendered.props)) return node;
+        const props = substituteRecordTokens(_extends({}, rendered.props), context);
+        return _extends({}, rendered, {
+            props
+        });
+    // Observable props: the JSON string keys the copy, as everywhere else.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        node,
+        rendered,
+        context,
+        propsJson
+    ]);
+}
+export default useRepeatPreview;
+
+//# sourceMappingURL=use-repeat-preview.js.map

package/src/lib/hooks/use-repeat-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-repeat-preview.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { canvas } from '@aglyn/aglyn'\n// By path: the repeat rules and the source registry stay out of every\n// `@aglyn/aglyn` barrel, so nothing on a published page can pull them in.\nimport {\n  expandRepeatables,\n  type RepeatableDataset,\n  type RepeatScope,\n  repeatedRecords,\n  repeatScope,\n  substituteRecordTokens,\n} from '@aglyn/aglyn/app-utils/expand-repeatables'\nimport { repeatSourceOf } from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { useContext, useEffect, useMemo, useSyncExternalStore } from 'react'\nimport {\n  RepeatRowsContext,\n  repeatRowsKey,\n} from '../contexts/repeat-rows-context'\nimport { RepeatRecordContext } from '../contexts/repeat-record-context'\n\nconst subscribeToNothing = () => () => undefined\nconst noVersion = () => 0\n\n/** What a repeating element draws on the canvas. */\nexport interface RepeatPreview {\n  /** What authors call the thing being repeated, for the badge. */\n  label: string\n  /**\n   * The records this element renders, in order, bounded exactly as the\n   * published page's composition bounds them.\n   */\n  records: ReadonlyArray<Record<string, unknown>>\n  /** Which scope applies, so the canvas draws what the page will build. */\n  scope: RepeatScope\n  /** The repeated rows, for the token substitution's reference hops. */\n  dataset?: RepeatableDataset\n  /** Every key the rows answered under, for a one-hop reference (AGL-180). */\n  datasetsByKey?: Readonly<Record<string, RepeatableDataset>>\n}\n\n/**\n * The rows a canvas element repeats over, and the copies it therefore draws\n * (AGL-3111).\n *\n * The designer cannot read them itself — it renders inside a plugin sandbox,\n * and which documents hold them is the source's business — so this HOLDS the\n * request and reads back whatever the host app's reader filed. Without a\n * provider, or before an answer, it returns `undefined` and the element draws\n * its template once, the way the canvas always did.\n *\n * The records are {@link repeatedRecords}, not a second reading of the same\n * props: the filter, the sort, the limit and `REPEAT_MAX_RECORDS` are applied\n * by the function the page applies them with, so a copy on the canvas is a\n * copy a visitor gets.\n */\nexport function useRepeatPreview(node: unknown): RepeatPreview | undefined {\n  const source = useContext(RepeatRowsContext)\n  const props = (node as { props?: Record<string, unknown> })?.props\n  // MobX props are observable and change in place; their JSON keys the memos\n  // below, the way every other render copy in the canvas is keyed.\n  const propsJson = JSON.stringify(props ?? null)\n  const request = useMemo(() => {\n    const repeat = source ? repeatSourceOf({ props }) : undefined\n    return repeat\n      ? { sourceId: repeat.source.id, key: repeat.key, label: repeat.source.label }\n      : undefined\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [source, props, propsJson])\n\n  const key = request ? repeatRowsKey(request) : ''\n  useEffect(() => {\n    if (!source || !request) return undefined\n    return source.retain(request)\n    // `key` stands in for `request`: the same source and key keeps the read\n    // it already holds rather than dropping and re-taking it.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [source, key])\n\n  const version = useSyncExternalStore(\n    source && request ? source.subscribe : subscribeToNothing,\n    source ? source.getVersion : noVersion,\n    noVersion,\n  )\n\n  return useMemo(() => {\n    if (!source || !request) return undefined\n    const answer = source.get(key)\n    if (answer?.status !== 'ready') return undefined\n    const dataset = answer.rowsByKey[request.key]\n    const records = repeatedRecords({ props }, dataset)\n    if (!records.length) return undefined\n    return {\n      label: answer.label,\n      records,\n      scope: repeatScope(node),\n      dataset,\n      datasetsByKey: answer.rowsByKey,\n    }\n    // `version` carries a new answer in; the body reads it through `get`.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [source, request, key, version, node, props, propsJson])\n}\n\n/**\n * The stored subtree under `rootId`, as a plain snapshot.\n *\n * Canvas nodes are MobX observables the expansion must not read through — it\n * copies props by reference into the copies it builds, and an observable read\n * outside a reaction is both a stale value and a missing dependency.\n */\nfunction subtreeSnapshot(rootId: string): Record<string, any> {\n  const nodes = (canvas.toJSON().nodes ?? {}) as Record<string, any>\n  const snapshot: Record<string, any> = {}\n  const walk = (id: string) => {\n    const node = nodes[id]\n    if (!node || snapshot[id]) return\n    snapshot[id] = JSON.parse(JSON.stringify(node))\n    for (const childId of (node.nodes ?? []) as string[]) walk(childId)\n  }\n  walk(rootId)\n  return snapshot\n}\n\n/**\n * The copies a repeating element draws BESIDE the one an author edits\n * (AGL-3111): records 2..n, as denormalized trees ready for an inert render.\n *\n * The first record is deliberately missing. It is drawn by the element's own\n * children — the real canvas nodes, selectable and draggable, with that\n * record's values laid over their render copies through\n * {@link RepeatRecordContext}. That is what makes editing the template edit\n * every copy: there is one template, it is on the canvas, and the copies are\n * pictures of it.\n *\n * Built by running the published page's own {@link expandRepeatables} over a\n * snapshot of this subtree, so the canvas cannot draw a shape the page would\n * not compose.\n */\nexport function useRepeatCopies(\n  node: { $id?: string; parentId?: string } | null | undefined,\n  preview: RepeatPreview | undefined,\n): any[] {\n  const $id = node?.$id\n  const recordCount = preview?.records.length ?? 0\n  const key = preview\n    ? `${$id}\\n${preview.scope}\\n${JSON.stringify(preview.records)}`\n    : ''\n  return useMemo(() => {\n    if (!$id || !preview || recordCount < 2) return []\n    const snapshot = subtreeSnapshot($id)\n    if (!snapshot[$id]) return []\n    // A parent the copies can take their place in. The real parent is not in\n    // this snapshot — only the subtree is — so a self-scoped repeat is given\n    // a holder that lists it, which is all the expansion reads a parent for.\n    const holderId = `${$id}__repeat-preview-parent`\n    snapshot[$id] = { ...snapshot[$id], parentId: holderId }\n    snapshot[holderId] = { $id: holderId, nodes: [$id] }\n    const expanded = expandRepeatables(snapshot as never, {\n      // Under the key the node stores, which is the key the expansion looks\n      // the rows up by.\n      ...(preview.datasetsByKey ?? {}),\n    } as never) as Record<string, any>\n    const copyIds =\n      preview.scope === 'self'\n        ? (expanded[holderId]?.nodes ?? []).slice(1)\n        : (expanded[$id]?.nodes ?? []).slice(\n            // One template's worth of children per record: the first\n            // record's copies are the ones the real children already draw.\n            (expanded[$id]?.nodes ?? []).length / recordCount,\n          )\n    return copyIds\n      .map((id: string) => denormalize(expanded, id))\n      .filter(Boolean)\n    // `key` stands in for the records and the node; both are snapshots.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [$id, key, recordCount])\n}\n\n/** Nested-object form of an expanded map, which is what `Stem` walks. */\nfunction denormalize(\n  nodes: Record<string, any>,\n  rootId: string,\n  seen: Set<string> = new Set(),\n): any {\n  const node = nodes?.[rootId]\n  if (!node || seen.has(rootId)) return undefined\n  seen.add(rootId)\n  return {\n    ...node,\n    children: ((node.nodes ?? []) as string[])\n      .map((childId) => denormalize(nodes, childId, seen))\n      .filter(Boolean),\n  }\n}\n\n/**\n * A node's render copy with the record its subtree is drawing laid over it\n * (AGL-3111).\n *\n * Inside a repeating element the FIRST record's values belong on the real\n * canvas nodes, so the element an author edits reads as the first copy rather\n * than as a row of raw `{{item.*}}` tokens beside the copies that resolved\n * them. Render copies only — the node keeps its tokens, and every save writes\n * the template.\n */\nexport function useNodeWithRepeatRecord<N>(node: N): N {\n  const context = useContext(RepeatRecordContext)\n  const rendered = node as { props?: Record<string, unknown> } | null | undefined\n  const propsJson = context ? JSON.stringify(rendered?.props ?? null) : ''\n  return useMemo(() => {\n    if (!context || !rendered?.props) return node\n    const props = substituteRecordTokens({ ...rendered.props }, context)\n    return { ...rendered, props } as N\n    // Observable props: the JSON string keys the copy, as everywhere else.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node, rendered, context, propsJson])\n}\n\nexport default useRepeatPreview\n"],"names":["canvas","expandRepeatables","repeatedRecords","repeatScope","substituteRecordTokens","repeatSourceOf","useContext","useEffect","useMemo","useSyncExternalStore","RepeatRowsContext","repeatRowsKey","RepeatRecordContext","subscribeToNothing","undefined","noVersion","useRepeatPreview","node","source","props","propsJson","JSON","stringify","request","repeat","sourceId","id","key","label","retain","version","subscribe","getVersion","answer","get","status","dataset","rowsByKey","records","length","scope","datasetsByKey","subtreeSnapshot","rootId","nodes","toJSON","snapshot","walk","parse","childId","useRepeatCopies","preview","$id","recordCount","expanded","holderId","parentId","copyIds","slice","map","denormalize","filter","Boolean","seen","Set","has","add","children","useNodeWithRepeatRecord","context","rendered"],"mappings":"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"}

package/src/lib/hooks/use-repeat-sources.d.ts

@@ -0,0 +1,17 @@
+import { type RepeatSource } from '@aglyn/aglyn/app-utils/repeat-sources';
+/**
+ * The repeat sources registered right now (AGL-3111).
+ *
+ * A plugin registers one from the function its loader calls by name, so the
+ * set is empty until that plugin has loaded and grows when it does. Subscribed
+ * rather than read once for exactly that reason: an author who enables the
+ * plugin mid-session gets the field without reloading the besigner.
+ *
+ * On the server there are none — registration happens in the browser, and a
+ * server snapshot that claimed otherwise would hydrate into a different form
+ * than it rendered.
+ */
+export declare function useRepeatSources(): readonly RepeatSource[];
+/** Moves whenever the registered set changes; memo keys read it. */
+export declare function useRepeatSourcesVersion(): number;
+export default useRepeatSources;

package/src/lib/hooks/use-repeat-sources.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+// By path: what an element can repeat OVER is editor business, and nothing
+// on a published page asks, so this stays out of every `@aglyn/aglyn` barrel.
+import { getRepeatSourcesVersion, listRepeatSources, subscribeRepeatSources } from "@aglyn/aglyn/app-utils/repeat-sources";
+import { useSyncExternalStore } from "react";
+const NONE = [];
+/**
+ * The repeat sources registered right now (AGL-3111).
+ *
+ * A plugin registers one from the function its loader calls by name, so the
+ * set is empty until that plugin has loaded and grows when it does. Subscribed
+ * rather than read once for exactly that reason: an author who enables the
+ * plugin mid-session gets the field without reloading the besigner.
+ *
+ * On the server there are none — registration happens in the browser, and a
+ * server snapshot that claimed otherwise would hydrate into a different form
+ * than it rendered.
+ */ export function useRepeatSources() {
+    return useSyncExternalStore(subscribeRepeatSources, listRepeatSources, ()=>NONE);
+}
+/** Moves whenever the registered set changes; memo keys read it. */ export function useRepeatSourcesVersion() {
+    return useSyncExternalStore(subscribeRepeatSources, getRepeatSourcesVersion, ()=>0);
+}
+export default useRepeatSources;
+
+//# sourceMappingURL=use-repeat-sources.js.map

package/src/lib/hooks/use-repeat-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-repeat-sources.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\n// By path: what an element can repeat OVER is editor business, and nothing\n// on a published page asks, so this stays out of every `@aglyn/aglyn` barrel.\nimport {\n  getRepeatSourcesVersion,\n  listRepeatSources,\n  type RepeatSource,\n  subscribeRepeatSources,\n} from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { useSyncExternalStore } from 'react'\n\nconst NONE: readonly RepeatSource[] = []\n\n/**\n * The repeat sources registered right now (AGL-3111).\n *\n * A plugin registers one from the function its loader calls by name, so the\n * set is empty until that plugin has loaded and grows when it does. Subscribed\n * rather than read once for exactly that reason: an author who enables the\n * plugin mid-session gets the field without reloading the besigner.\n *\n * On the server there are none — registration happens in the browser, and a\n * server snapshot that claimed otherwise would hydrate into a different form\n * than it rendered.\n */\nexport function useRepeatSources(): readonly RepeatSource[] {\n  return useSyncExternalStore(\n    subscribeRepeatSources,\n    listRepeatSources,\n    () => NONE,\n  )\n}\n\n/** Moves whenever the registered set changes; memo keys read it. */\nexport function useRepeatSourcesVersion(): number {\n  return useSyncExternalStore(\n    subscribeRepeatSources,\n    getRepeatSourcesVersion,\n    () => 0,\n  )\n}\n\nexport default useRepeatSources\n"],"names":["getRepeatSourcesVersion","listRepeatSources","subscribeRepeatSources","useSyncExternalStore","NONE","useRepeatSources","useRepeatSourcesVersion"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,2EAA2E;AAC3E,8EAA8E;AAC9E,SACEA,uBAAuB,EACvBC,iBAAiB,EAEjBC,sBAAsB,QACjB,wCAAuC;AAC9C,SAASC,oBAAoB,QAAQ,QAAO;AAE5C,MAAMC,OAAgC,EAAE;AAExC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC;IACd,OAAOF,qBACLD,wBACAD,mBACA,IAAMG;AAEV;AAEA,kEAAkE,GAClE,OAAO,SAASE;IACd,OAAOH,qBACLD,wBACAF,yBACA,IAAM;AAEV;AAEA,eAAeK,iBAAgB"}

package/src/lib/hooks/use-visible-component-categories.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+/**
+ * Component-drawer categories filtered by the site's plugin set and the
+ * current canvas view type:
+ *
+ *  - A plugin disabled for this site (AGL-1014) contributes nothing, in
+ *    either drawer — the palette and the picker read this one hook.
+ *  - Editing an EMAIL document → only the email plugin's email-safe blocks;
+ *    web/layout components would render inconsistently across mail clients.
+ *  - Editing a screen or layout → email blocks are hidden (they belong to
+ *    emails only); layout-only components (the LayoutSlot outlet) are also
+ *    hidden while editing screens.
+ *
+ * Call inside an observer component — the category list is a MobX computed.
+ */
+export declare function useVisibleComponentCategories(): {
+    items: (Aglyn.PresetSchema<any> | Aglyn.ComponentSchema<any>)[];
+    $id: string;
+    label: string;
+}[];
+export default useVisibleComponentCategories;

package/src/lib/hooks/use-visible-component-categories.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { components, HostViewType, isCategoryCapabilityEnabled, isFromEnabledPlugin, LAYOUT_SLOT_COMPONENT_ID, useEnabledPlugins } from "@aglyn/aglyn";
+import useAglynBesignerFlag from "./use-aglyn-besigner-flag.js";
+/** Bundle id of the email designer's blocks (AGL-395). */ const EMAIL_PLUGIN_ID = 'email';
+function isLayoutOnlyPreset(preset) {
+    var _preset_data;
+    return (preset == null ? void 0 : (_preset_data = preset.data) == null ? void 0 : _preset_data.componentId) === LAYOUT_SLOT_COMPONENT_ID;
+}
+function isEmailComponent(item) {
+    return (item == null ? void 0 : item.pluginId) === EMAIL_PLUGIN_ID;
+}
+/**
+ * Component-drawer categories filtered by the site's plugin set and the
+ * current canvas view type:
+ *
+ *  - A plugin disabled for this site (AGL-1014) contributes nothing, in
+ *    either drawer — the palette and the picker read this one hook.
+ *  - Editing an EMAIL document → only the email plugin's email-safe blocks;
+ *    web/layout components would render inconsistently across mail clients.
+ *  - Editing a screen or layout → email blocks are hidden (they belong to
+ *    emails only); layout-only components (the LayoutSlot outlet) are also
+ *    hidden while editing screens.
+ *
+ * Call inside an observer component — the category list is a MobX computed.
+ */ export function useVisibleComponentCategories() {
+    const [viewType] = useAglynBesignerFlag('viewType');
+    // Per-site plugin enablement (AGL-1014). Enforcement, not decoration: the
+    // preset registry is a module-global union across every plugin loaded this
+    // session, so without this the drawer offers — and inserts — components
+    // from a plugin the site has switched off, which the published site then
+    // refuses to render. Undefined off host surfaces, which filters nothing.
+    const enabled = useEnabledPlugins();
+    if (viewType === HostViewType.EMAIL) {
+        return components.schemasBySortedCategories.map((category)=>{
+            var _category_items;
+            return _extends({}, category, {
+                items: isCategoryCapabilityEnabled(category.label, enabled) ? (_category_items = category.items) == null ? void 0 : _category_items.filter((item)=>isEmailComponent(item) && isFromEnabledPlugin(item, enabled)) : []
+            });
+        }).filter((category)=>{
+            var _category_items;
+            return (_category_items = category.items) == null ? void 0 : _category_items.length;
+        });
+    }
+    const isLayout = viewType === HostViewType.LAYOUT;
+    return components.schemasBySortedCategories.map((category)=>{
+        var _category_items;
+        return _extends({}, category, {
+            // A category whose CAPABILITY is off contributes nothing, heading
+            // included (AGL-2486) — an empty "Members" heading still advertises a
+            // capability the site does not have. Emptying it here rather than
+            // filtering item by item is what makes the final `.filter` drop it.
+            items: !isCategoryCapabilityEnabled(category.label, enabled) ? [] : (_category_items = category.items) == null ? void 0 : _category_items.filter((item)=>// A plugin this site has switched off offers nothing.
+                isFromEnabledPlugin(item, enabled) && // Email blocks never appear outside an email document.
+                !isEmailComponent(item) && // The LayoutSlot outlet is layout-only.
+                (isLayout || !isLayoutOnlyPreset(item)))
+        });
+    }).filter((category)=>{
+        var _category_items;
+        return (_category_items = category.items) == null ? void 0 : _category_items.length;
+    });
+}
+export default useVisibleComponentCategories;
+
+//# sourceMappingURL=use-visible-component-categories.js.map

package/src/lib/hooks/use-visible-component-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-visible-component-categories.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type * as Aglyn from '@aglyn/aglyn'\nimport {\n  components,\n  HostViewType,\n  isCategoryCapabilityEnabled,\n  isFromEnabledPlugin,\n  LAYOUT_SLOT_COMPONENT_ID,\n  useEnabledPlugins,\n} from '@aglyn/aglyn'\nimport useAglynBesignerFlag from './use-aglyn-besigner-flag'\n\n/** Bundle id of the email designer's blocks (AGL-395). */\nconst EMAIL_PLUGIN_ID = 'email'\n\nfunction isLayoutOnlyPreset(preset: Aglyn.PresetSchema | undefined) {\n  return preset?.data?.componentId === LAYOUT_SLOT_COMPONENT_ID\n}\n\nfunction isEmailComponent(item: { pluginId?: string } | undefined) {\n  return item?.pluginId === EMAIL_PLUGIN_ID\n}\n\n/**\n * Component-drawer categories filtered by the site's plugin set and the\n * current canvas view type:\n *\n *  - A plugin disabled for this site (AGL-1014) contributes nothing, in\n *    either drawer — the palette and the picker read this one hook.\n *  - Editing an EMAIL document → only the email plugin's email-safe blocks;\n *    web/layout components would render inconsistently across mail clients.\n *  - Editing a screen or layout → email blocks are hidden (they belong to\n *    emails only); layout-only components (the LayoutSlot outlet) are also\n *    hidden while editing screens.\n *\n * Call inside an observer component — the category list is a MobX computed.\n */\nexport function useVisibleComponentCategories() {\n  const [viewType] = useAglynBesignerFlag('viewType')\n  // Per-site plugin enablement (AGL-1014). Enforcement, not decoration: the\n  // preset registry is a module-global union across every plugin loaded this\n  // session, so without this the drawer offers — and inserts — components\n  // from a plugin the site has switched off, which the published site then\n  // refuses to render. Undefined off host surfaces, which filters nothing.\n  const enabled = useEnabledPlugins()\n\n  if (viewType === HostViewType.EMAIL) {\n    return components.schemasBySortedCategories\n      .map((category) => ({\n        ...category,\n        items: isCategoryCapabilityEnabled(category.label, enabled)\n          ? category.items?.filter(\n              (item) =>\n                isEmailComponent(item) && isFromEnabledPlugin(item, enabled),\n            )\n          : [],\n      }))\n      .filter((category) => category.items?.length)\n  }\n\n  const isLayout = viewType === HostViewType.LAYOUT\n  return components.schemasBySortedCategories\n    .map((category) => ({\n      ...category,\n      // A category whose CAPABILITY is off contributes nothing, heading\n      // included (AGL-2486) — an empty \"Members\" heading still advertises a\n      // capability the site does not have. Emptying it here rather than\n      // filtering item by item is what makes the final `.filter` drop it.\n      items: !isCategoryCapabilityEnabled(category.label, enabled)\n        ? []\n        : category.items?.filter(\n            (item) =>\n              // A plugin this site has switched off offers nothing.\n              isFromEnabledPlugin(item, enabled) &&\n              // Email blocks never appear outside an email document.\n              !isEmailComponent(item) &&\n              // The LayoutSlot outlet is layout-only.\n              (isLayout || !isLayoutOnlyPreset(item as Aglyn.PresetSchema)),\n          ),\n    }))\n    .filter((category) => category.items?.length)\n}\n\nexport default useVisibleComponentCategories\n"],"names":["components","HostViewType","isCategoryCapabilityEnabled","isFromEnabledPlugin","LAYOUT_SLOT_COMPONENT_ID","useEnabledPlugins","useAglynBesignerFlag","EMAIL_PLUGIN_ID","isLayoutOnlyPreset","preset","data","componentId","isEmailComponent","item","pluginId","useVisibleComponentCategories","viewType","enabled","EMAIL","schemasBySortedCategories","map","category","items","label","filter","length","isLayout","LAYOUT"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,UAAU,EACVC,YAAY,EACZC,2BAA2B,EAC3BC,mBAAmB,EACnBC,wBAAwB,EACxBC,iBAAiB,QACZ,eAAc;AACrB,OAAOC,0BAA0B,+BAA2B;AAE5D,wDAAwD,GACxD,MAAMC,kBAAkB;AAExB,SAASC,mBAAmBC,MAAsC;QACzDA;IAAP,OAAOA,CAAAA,2BAAAA,eAAAA,OAAQC,IAAI,qBAAZD,aAAcE,WAAW,MAAKP;AACvC;AAEA,SAASQ,iBAAiBC,IAAuC;IAC/D,OAAOA,CAAAA,wBAAAA,KAAMC,QAAQ,MAAKP;AAC5B;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASQ;IACd,MAAM,CAACC,SAAS,GAAGV,qBAAqB;IACxC,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,yEAAyE;IACzE,yEAAyE;IACzE,MAAMW,UAAUZ;IAEhB,IAAIW,aAAaf,aAAaiB,KAAK,EAAE;QACnC,OAAOlB,WAAWmB,yBAAyB,CACxCC,GAAG,CAAC,CAACC;gBAGAA;mBAHc,aACfA;gBACHC,OAAOpB,4BAA4BmB,SAASE,KAAK,EAAEN,YAC/CI,kBAAAA,SAASC,KAAK,qBAAdD,gBAAgBG,MAAM,CACpB,CAACX,OACCD,iBAAiBC,SAASV,oBAAoBU,MAAMI,YAExD,EAAE;;WAEPO,MAAM,CAAC,CAACH;gBAAaA;oBAAAA,kBAAAA,SAASC,KAAK,qBAAdD,gBAAgBI,MAAM;;IAChD;IAEA,MAAMC,WAAWV,aAAaf,aAAa0B,MAAM;IACjD,OAAO3B,WAAWmB,yBAAyB,CACxCC,GAAG,CAAC,CAACC;YAQAA;eARc,aACfA;YACH,kEAAkE;YAClE,sEAAsE;YACtE,kEAAkE;YAClE,oEAAoE;YACpEC,OAAO,CAACpB,4BAA4BmB,SAASE,KAAK,EAAEN,WAChD,EAAE,IACFI,kBAAAA,SAASC,KAAK,qBAAdD,gBAAgBG,MAAM,CACpB,CAACX,OACC,sDAAsD;gBACtDV,oBAAoBU,MAAMI,YAC1B,uDAAuD;gBACvD,CAACL,iBAAiBC,SAClB,wCAAwC;gBACvCa,CAAAA,YAAY,CAAClB,mBAAmBK,KAA0B;;OAGpEW,MAAM,CAAC,CAACH;YAAaA;gBAAAA,kBAAAA,SAASC,KAAK,qBAAdD,gBAAgBI,MAAM;;AAChD;AAEA,eAAeV,8BAA6B"}

package/src/lib/utils/active-host-theme.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare function publishActiveHostTheme(doc: unknown): void;
+export declare function useActiveHostTheme(): any;
+/**
+ * Publishes the page's host theme for surfaces that sit outside the page.
+ * Call from a component mounted INSIDE `HostThemeDocumentContext.Provider`.
+ */
+export declare function usePublishActiveHostTheme(): void;
+/**
+ * The site theme document, preferring real context and falling back to the
+ * register. Use this anywhere a preview may be rendered outside the page.
+ */
+export declare function useResolvedHostThemeDocument(): any;

package/src/lib/utils/active-host-theme.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { useHostThemeDocument } from "@aglyn/shared-ui-theme";
+import { useEffect, useSyncExternalStore } from "react";
+/**
+ * The editor's current site theme, reachable from OUTSIDE the page tree
+ * (AGL-2486).
+ *
+ * `HostThemeDocumentContext` is provided inside the besigner PAGE, but
+ * `withBesignerContext` wraps that page — so `ComponentsDrawerContextProvider`,
+ * and the Choose-element dialog it renders, are ancestors of the provider
+ * rather than descendants. React context flows through portals, so the
+ * dialog's mounting is not the problem; its ANCESTRY is. The consequence was
+ * that the dialog's element preview fell back to the console's own brand and
+ * painted an Aglyn-cyan header for a site whose brand is brown — a preview
+ * showing the wrong colours is worse than no preview, because it sends an
+ * author to a component they believe matches their site.
+ *
+ * A register rather than another context, because another context would have
+ * exactly the same ancestry problem. One editor renders one site at a time,
+ * which is what makes a module-scoped value correct here rather than merely
+ * convenient — and the context is still preferred wherever it IS available,
+ * so this only ever fills the gap.
+ */ let activeHostTheme = undefined;
+const listeners = new Set();
+function subscribe(listener) {
+    listeners.add(listener);
+    return ()=>void listeners.delete(listener);
+}
+function getSnapshot() {
+    return activeHostTheme;
+}
+/** Server render has no editor, so there is no theme to report. */ function getServerSnapshot() {
+    return undefined;
+}
+export function publishActiveHostTheme(doc) {
+    if (activeHostTheme === doc) return;
+    activeHostTheme = doc;
+    listeners.forEach((listener)=>listener());
+}
+export function useActiveHostTheme() {
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+/**
+ * Publishes the page's host theme for surfaces that sit outside the page.
+ * Call from a component mounted INSIDE `HostThemeDocumentContext.Provider`.
+ */ export function usePublishActiveHostTheme() {
+    const doc = useHostThemeDocument();
+    useEffect(()=>{
+        publishActiveHostTheme(doc);
+    }, [
+        doc
+    ]);
+}
+/**
+ * The site theme document, preferring real context and falling back to the
+ * register. Use this anywhere a preview may be rendered outside the page.
+ */ export function useResolvedHostThemeDocument() {
+    const fromContext = useHostThemeDocument();
+    const fromRegister = useActiveHostTheme();
+    return fromContext != null ? fromContext : fromRegister;
+}
+
+//# sourceMappingURL=active-host-theme.js.map

package/src/lib/utils/active-host-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/active-host-theme.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useHostThemeDocument } from '@aglyn/shared-ui-theme'\nimport { useEffect, useSyncExternalStore } from 'react'\n\n/**\n * The editor's current site theme, reachable from OUTSIDE the page tree\n * (AGL-2486).\n *\n * `HostThemeDocumentContext` is provided inside the besigner PAGE, but\n * `withBesignerContext` wraps that page — so `ComponentsDrawerContextProvider`,\n * and the Choose-element dialog it renders, are ancestors of the provider\n * rather than descendants. React context flows through portals, so the\n * dialog's mounting is not the problem; its ANCESTRY is. The consequence was\n * that the dialog's element preview fell back to the console's own brand and\n * painted an Aglyn-cyan header for a site whose brand is brown — a preview\n * showing the wrong colours is worse than no preview, because it sends an\n * author to a component they believe matches their site.\n *\n * A register rather than another context, because another context would have\n * exactly the same ancestry problem. One editor renders one site at a time,\n * which is what makes a module-scoped value correct here rather than merely\n * convenient — and the context is still preferred wherever it IS available,\n * so this only ever fills the gap.\n */\nlet activeHostTheme: unknown = undefined\nconst listeners = new Set<() => void>()\n\nfunction subscribe(listener: () => void) {\n  listeners.add(listener)\n  return () => void listeners.delete(listener)\n}\n\nfunction getSnapshot() {\n  return activeHostTheme\n}\n\n/** Server render has no editor, so there is no theme to report. */\nfunction getServerSnapshot() {\n  return undefined\n}\n\nexport function publishActiveHostTheme(doc: unknown) {\n  if (activeHostTheme === doc) return\n  activeHostTheme = doc\n  listeners.forEach((listener) => listener())\n}\n\nexport function useActiveHostTheme() {\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)\n}\n\n/**\n * Publishes the page's host theme for surfaces that sit outside the page.\n * Call from a component mounted INSIDE `HostThemeDocumentContext.Provider`.\n */\nexport function usePublishActiveHostTheme() {\n  const doc = useHostThemeDocument()\n  useEffect(() => {\n    publishActiveHostTheme(doc)\n  }, [doc])\n}\n\n/**\n * The site theme document, preferring real context and falling back to the\n * register. Use this anywhere a preview may be rendered outside the page.\n */\nexport function useResolvedHostThemeDocument() {\n  const fromContext = useHostThemeDocument()\n  const fromRegister = useActiveHostTheme()\n  return (fromContext ?? fromRegister) as any\n}\n"],"names":["useHostThemeDocument","useEffect","useSyncExternalStore","activeHostTheme","undefined","listeners","Set","subscribe","listener","add","delete","getSnapshot","getServerSnapshot","publishActiveHostTheme","doc","forEach","useActiveHostTheme","usePublishActiveHostTheme","useResolvedHostThemeDocument","fromContext","fromRegister"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,oBAAoB,QAAQ,yBAAwB;AAC7D,SAASC,SAAS,EAAEC,oBAAoB,QAAQ,QAAO;AAEvD;;;;;;;;;;;;;;;;;;;CAmBC,GACD,IAAIC,kBAA2BC;AAC/B,MAAMC,YAAY,IAAIC;AAEtB,SAASC,UAAUC,QAAoB;IACrCH,UAAUI,GAAG,CAACD;IACd,OAAO,IAAM,KAAKH,UAAUK,MAAM,CAACF;AACrC;AAEA,SAASG;IACP,OAAOR;AACT;AAEA,iEAAiE,GACjE,SAASS;IACP,OAAOR;AACT;AAEA,OAAO,SAASS,uBAAuBC,GAAY;IACjD,IAAIX,oBAAoBW,KAAK;IAC7BX,kBAAkBW;IAClBT,UAAUU,OAAO,CAAC,CAACP,WAAaA;AAClC;AAEA,OAAO,SAASQ;IACd,OAAOd,qBAAqBK,WAAWI,aAAaC;AACtD;AAEA;;;CAGC,GACD,OAAO,SAASK;IACd,MAAMH,MAAMd;IACZC,UAAU;QACRY,uBAAuBC;IACzB,GAAG;QAACA;KAAI;AACV;AAEA;;;CAGC,GACD,OAAO,SAASI;IACd,MAAMC,cAAcnB;IACpB,MAAMoB,eAAeJ;IACrB,OAAQG,sBAAAA,cAAeC;AACzB"}