@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/contexts/element-drawer-context.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2021 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 { createContext, useContext } from "react";
+export const DEFAULT_OPTIONS = {
+    title: 'Are you sure?',
+    description: '',
+    selectionText: 'OK',
+    cancellationText: 'Cancel',
+    dialogProps: {},
+    selectionButtonProps: {},
+    cancellationButtonProps: {}
+};
+export const buildOptions = (defaultOptions, options)=>{
+    const dialogProps = _extends({}, defaultOptions.dialogProps || DEFAULT_OPTIONS.dialogProps, options.dialogProps || {});
+    const selectionButtonProps = _extends({}, defaultOptions.selectionButtonProps || DEFAULT_OPTIONS.selectionButtonProps, options.selectionButtonProps || {});
+    const cancellationButtonProps = _extends({}, defaultOptions.cancellationButtonProps || DEFAULT_OPTIONS.cancellationButtonProps, options.cancellationButtonProps || {});
+    return _extends({}, DEFAULT_OPTIONS, defaultOptions, options, {
+        dialogProps,
+        selectionButtonProps,
+        cancellationButtonProps
+    });
+};
+export const ElementDrawerContext = createContext(null);
+ElementDrawerContext.displayName = 'ElementDrawerContext';
+ElementDrawerContext.aglyn = true;
+export const useElementDrawerContext = ()=>{
+    return useContext(ElementDrawerContext);
+};
+export default ElementDrawerContext;
+
+//# sourceMappingURL=element-drawer-context.js.map

package/src/lib/contexts/element-drawer-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/element-drawer-context.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 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 ButtonProps } from '@mui/material/Button'\nimport { type DialogProps } from '@mui/material/Dialog'\nimport { type DialogContentTextProps } from '@mui/material/DialogContentText'\nimport { type DialogTitleProps } from '@mui/material/DialogTitle'\nimport { createContext, useContext } from 'react'\n\nexport interface ElementDrawerOptions {\n  cancellationText?: ButtonProps['children']\n  selectionText?: ButtonProps['children']\n  cancellationButtonProps?: Partial<ButtonProps>\n  selectionButtonProps?: Partial<ButtonProps>\n  dialogProps?: Partial<DialogProps>\n  title?: DialogTitleProps['children']\n  description?: DialogContentTextProps['children']\n}\n\nexport type ElementDrawerFn = (\n  options?: ElementDrawerOptions,\n) => Promise<unknown>\n\nexport interface ElementDrawerContextType {\n  elementDrawer: ElementDrawerFn\n  /**\n   * Whether the Choose-element dialog is currently open (AGL-2486).\n   *\n   * Published so surfaces BELOW the provider can stand down while it is up —\n   * the Elements panel's floating detail has no business surviving a modal\n   * opening over it, and sniffing for a backdrop in the DOM would be a guess\n   * where the provider already knows the answer.\n   */\n  open?: boolean\n}\n\nexport type UseElementDrawerType = () => ElementDrawerContextType\n\nexport const DEFAULT_OPTIONS: ElementDrawerOptions = {\n  title: 'Are you sure?',\n  description: '',\n  selectionText: 'OK',\n  cancellationText: 'Cancel',\n  dialogProps: {},\n  selectionButtonProps: {},\n  cancellationButtonProps: {},\n}\n\nexport const buildOptions = (defaultOptions: ElementDrawerOptions, options: ElementDrawerOptions) => {\n  const dialogProps = {\n    ...(defaultOptions.dialogProps || DEFAULT_OPTIONS.dialogProps),\n    ...(options.dialogProps || {}),\n  }\n  const selectionButtonProps = {\n    ...(defaultOptions.selectionButtonProps ||\n      DEFAULT_OPTIONS.selectionButtonProps),\n    ...(options.selectionButtonProps || {}),\n  }\n  const cancellationButtonProps = {\n    ...(defaultOptions.cancellationButtonProps ||\n      DEFAULT_OPTIONS.cancellationButtonProps),\n    ...(options.cancellationButtonProps || {}),\n  }\n\n  return {\n    ...DEFAULT_OPTIONS,\n    ...defaultOptions,\n    ...options,\n    dialogProps,\n    selectionButtonProps,\n    cancellationButtonProps,\n  }\n}\n\nexport const ElementDrawerContext =\n  createContext<ElementDrawerContextType>(null)\nElementDrawerContext.displayName = 'ElementDrawerContext'\nElementDrawerContext.aglyn = true\nexport const useElementDrawerContext: UseElementDrawerType = () => {\n  return useContext(ElementDrawerContext)\n}\n\nexport default ElementDrawerContext\n"],"names":["createContext","useContext","DEFAULT_OPTIONS","title","description","selectionText","cancellationText","dialogProps","selectionButtonProps","cancellationButtonProps","buildOptions","defaultOptions","options","ElementDrawerContext","displayName","aglyn","useElementDrawerContext"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAMD,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAO;AA+BjD,OAAO,MAAMC,kBAAwC;IACnDC,OAAO;IACPC,aAAa;IACbC,eAAe;IACfC,kBAAkB;IAClBC,aAAa,CAAC;IACdC,sBAAsB,CAAC;IACvBC,yBAAyB,CAAC;AAC5B,EAAC;AAED,OAAO,MAAMC,eAAe,CAACC,gBAAsCC;IACjE,MAAML,cAAc,aACdI,eAAeJ,WAAW,IAAIL,gBAAgBK,WAAW,EACzDK,QAAQL,WAAW,IAAI,CAAC;IAE9B,MAAMC,uBAAuB,aACvBG,eAAeH,oBAAoB,IACrCN,gBAAgBM,oBAAoB,EAClCI,QAAQJ,oBAAoB,IAAI,CAAC;IAEvC,MAAMC,0BAA0B,aAC1BE,eAAeF,uBAAuB,IACxCP,gBAAgBO,uBAAuB,EACrCG,QAAQH,uBAAuB,IAAI,CAAC;IAG1C,OAAO,aACFP,iBACAS,gBACAC;QACHL;QACAC;QACAC;;AAEJ,EAAC;AAED,OAAO,MAAMI,uBACXb,cAAwC,MAAK;AAC/Ca,qBAAqBC,WAAW,GAAG;AACnCD,qBAAqBE,KAAK,GAAG;AAC7B,OAAO,MAAMC,0BAAgD;IAC3D,OAAOf,WAAWY;AACpB,EAAC;AAED,eAAeA,qBAAoB"}

package/src/lib/contexts/inspected-selection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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 { BesignerInspected } from './inspector-extras-context';
+/**
+ * What the Attributes panel tells a host section about the selection
+ * (AGL-2908).
+ *
+ * `editable` is the drag manager's rule, which is the rule the panel already
+ * draws its own in-place actions under — Save as reusable component, Detach
+ * from component: the canvas root fails it, and so does a node whose schema
+ * forbids dragging, which is how locked layout chrome reaches the panel.
+ *
+ * It is computed here rather than in the section because a section is handed
+ * a node and nothing else. Working the rule out for itself would mean
+ * importing the editor into a host app or a plugin, which is exactly what
+ * the zone exists to avoid, and would leave two answers to one question.
+ */
+export declare function besignerInspected(node: BesignerInspected['node'] | null | undefined): BesignerInspected | null;

package/src/lib/contexts/inspected-selection.js

@@ -0,0 +1,38 @@
+/**
+ * @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 Besigner from "@aglyn/besigner";
+/**
+ * What the Attributes panel tells a host section about the selection
+ * (AGL-2908).
+ *
+ * `editable` is the drag manager's rule, which is the rule the panel already
+ * draws its own in-place actions under — Save as reusable component, Detach
+ * from component: the canvas root fails it, and so does a node whose schema
+ * forbids dragging, which is how locked layout chrome reaches the panel.
+ *
+ * It is computed here rather than in the section because a section is handed
+ * a node and nothing else. Working the rule out for itself would mean
+ * importing the editor into a host app or a plugin, which is exactly what
+ * the zone exists to avoid, and would leave two answers to one question.
+ */ export function besignerInspected(node) {
+    if (!node) return null;
+    return {
+        node,
+        editable: Besigner.dnd.canDragNode(node)
+    };
+}
+
+//# sourceMappingURL=inspected-selection.js.map

package/src/lib/contexts/inspected-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/inspected-selection.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 * as Besigner from '@aglyn/besigner'\nimport type { BesignerInspected } from './inspector-extras-context'\n\n/**\n * What the Attributes panel tells a host section about the selection\n * (AGL-2908).\n *\n * `editable` is the drag manager's rule, which is the rule the panel already\n * draws its own in-place actions under — Save as reusable component, Detach\n * from component: the canvas root fails it, and so does a node whose schema\n * forbids dragging, which is how locked layout chrome reaches the panel.\n *\n * It is computed here rather than in the section because a section is handed\n * a node and nothing else. Working the rule out for itself would mean\n * importing the editor into a host app or a plugin, which is exactly what\n * the zone exists to avoid, and would leave two answers to one question.\n */\nexport function besignerInspected(\n  node: BesignerInspected['node'] | null | undefined,\n): BesignerInspected | null {\n  if (!node) return null\n  return { node, editable: Besigner.dnd.canDragNode(node) }\n}\n"],"names":["Besigner","besignerInspected","node","editable","dnd","canDragNode"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,cAAc,kBAAiB;AAG3C;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC,kBACdC,IAAkD;IAElD,IAAI,CAACA,MAAM,OAAO;IAClB,OAAO;QAAEA;QAAMC,UAAUH,SAASI,GAAG,CAACC,WAAW,CAACH;IAAM;AAC1D"}

package/src/lib/contexts/inspector-extras-context.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @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 { NodeSchema } from '@aglyn/aglyn';
+import { type ReactNode } from 'react';
+/** What the Attributes panel knows when it draws the host's section. */
+export interface BesignerInspected {
+    /** The selected element, as the panel resolved it. */
+    node: NodeSchema<any>;
+    /**
+     * Whether this document's editor may change the element in place
+     * (AGL-2908): the panel's own rule for the actions it offers under the
+     * element's fields — Save as reusable component, Detach from component —
+     * which the canvas root and locked layout chrome fail.
+     *
+     * The panel answers it because only the panel can. A host section is
+     * handed a node, not the editor: it has no canvas, no drag manager and no
+     * business importing either to work the rule out for itself. A section
+     * that would change the element reads this; one that only reports on it
+     * ignores it.
+     */
+    editable: boolean;
+}
+/**
+ * The host's section: a node drawn as it is, or a function that draws one
+ * for the selected element (AGL-2984).
+ */
+export type BesignerInspectorExtras = ReactNode | ((inspected: BesignerInspected) => ReactNode);
+/**
+ * A section the host app appends to the Attributes panel, under the
+ * selected element's own fields (AGL-2940).
+ *
+ * The designer stays free of console imports: the console supplies the
+ * section — its plugin widget slot, rendered with the shell's own gates, and
+ * handed the selection when it is a function — and the panel draws whatever
+ * arrives. Nothing here knows what a plugin is.
+ */
+export declare const BesignerInspectorExtrasContext: import("react").Context<BesignerInspectorExtras>;
+/** The host-supplied section, or `null` when the host supplied nothing. */
+export declare function useBesignerInspectorExtras(): BesignerInspectorExtras;
+/** The section to draw for a selection: a function's answer for it, or the node as given. */
+export declare function inspectorExtrasFor(extras: BesignerInspectorExtras, inspected: BesignerInspected): ReactNode;
+export default BesignerInspectorExtrasContext;

package/src/lib/contexts/inspector-extras-context.js

@@ -0,0 +1,35 @@
+/**
+ * @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 { createContext, useContext } from "react";
+/**
+ * A section the host app appends to the Attributes panel, under the
+ * selected element's own fields (AGL-2940).
+ *
+ * The designer stays free of console imports: the console supplies the
+ * section — its plugin widget slot, rendered with the shell's own gates, and
+ * handed the selection when it is a function — and the panel draws whatever
+ * arrives. Nothing here knows what a plugin is.
+ */ export const BesignerInspectorExtrasContext = /*#__PURE__*/ createContext(null);
+BesignerInspectorExtrasContext.displayName = 'BesignerInspectorExtrasContext';
+/** The host-supplied section, or `null` when the host supplied nothing. */ export function useBesignerInspectorExtras() {
+    return useContext(BesignerInspectorExtrasContext);
+}
+/** The section to draw for a selection: a function's answer for it, or the node as given. */ export function inspectorExtrasFor(extras, inspected) {
+    return typeof extras === 'function' ? extras(inspected) : extras;
+}
+export default BesignerInspectorExtrasContext;
+
+//# sourceMappingURL=inspector-extras-context.js.map

package/src/lib/contexts/inspector-extras-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/inspector-extras-context.tsx"],"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 { NodeSchema } from '@aglyn/aglyn'\nimport { createContext, useContext, type ReactNode } from 'react'\n\n/** What the Attributes panel knows when it draws the host's section. */\nexport interface BesignerInspected {\n  /** The selected element, as the panel resolved it. */\n  node: NodeSchema<any>\n  /**\n   * Whether this document's editor may change the element in place\n   * (AGL-2908): the panel's own rule for the actions it offers under the\n   * element's fields — Save as reusable component, Detach from component —\n   * which the canvas root and locked layout chrome fail.\n   *\n   * The panel answers it because only the panel can. A host section is\n   * handed a node, not the editor: it has no canvas, no drag manager and no\n   * business importing either to work the rule out for itself. A section\n   * that would change the element reads this; one that only reports on it\n   * ignores it.\n   */\n  editable: boolean\n}\n\n/**\n * The host's section: a node drawn as it is, or a function that draws one\n * for the selected element (AGL-2984).\n */\nexport type BesignerInspectorExtras =\n  | ReactNode\n  | ((inspected: BesignerInspected) => ReactNode)\n\n/**\n * A section the host app appends to the Attributes panel, under the\n * selected element's own fields (AGL-2940).\n *\n * The designer stays free of console imports: the console supplies the\n * section — its plugin widget slot, rendered with the shell's own gates, and\n * handed the selection when it is a function — and the panel draws whatever\n * arrives. Nothing here knows what a plugin is.\n */\nexport const BesignerInspectorExtrasContext = createContext<BesignerInspectorExtras>(null)\nBesignerInspectorExtrasContext.displayName = 'BesignerInspectorExtrasContext'\n\n/** The host-supplied section, or `null` when the host supplied nothing. */\nexport function useBesignerInspectorExtras(): BesignerInspectorExtras {\n  return useContext(BesignerInspectorExtrasContext)\n}\n\n/** The section to draw for a selection: a function's answer for it, or the node as given. */\nexport function inspectorExtrasFor(\n  extras: BesignerInspectorExtras,\n  inspected: BesignerInspected,\n): ReactNode {\n  return typeof extras === 'function' ? extras(inspected) : extras\n}\n\nexport default BesignerInspectorExtrasContext\n"],"names":["createContext","useContext","BesignerInspectorExtrasContext","displayName","useBesignerInspectorExtras","inspectorExtrasFor","extras","inspected"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,aAAa,EAAEC,UAAU,QAAwB,QAAO;AA6BjE;;;;;;;;CAQC,GACD,OAAO,MAAMC,+CAAiCF,cAAuC,MAAK;AAC1FE,+BAA+BC,WAAW,GAAG;AAE7C,yEAAyE,GACzE,OAAO,SAASC;IACd,OAAOH,WAAWC;AACpB;AAEA,2FAA2F,GAC3F,OAAO,SAASG,mBACdC,MAA+B,EAC/BC,SAA4B;IAE5B,OAAO,OAAOD,WAAW,aAAaA,OAAOC,aAAaD;AAC5D;AAEA,eAAeJ,+BAA8B"}

package/src/lib/contexts/interactions-context.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @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.
+ */
+/**
+ * Host-app-provided interactions for the Attributes panel (AGL-258): the
+ * console supplies the host's element-scoped automations and section
+ * experiments plus creators; the designer stays storage-agnostic and
+ * hides the section when no context is provided. Element selectors use
+ * the renderer's stable `[data-aglyn="leaf:<nodeId>"]` attribute.
+ */
+export interface InteractionAutomation {
+    id: string;
+    name?: string;
+    event: string;
+    selector?: string;
+    enabled?: boolean;
+}
+export interface SectionExperimentRef {
+    id: string;
+    name?: string;
+    nodeId?: string;
+    status?: string;
+}
+export type InteractionTriggerEvent = 'elementClick' | 'elementVisible' | 'scrollToElement' | 'elementHoverEnter' | 'elementHoverLeave';
+/**
+ * A ready-to-persist interaction resolved from a preset's templates
+ * (AGL-589): every ref is already a concrete `[data-aglyn="leaf:<id>"]`
+ * selector. The host app validates and writes it like a builder save.
+ */
+export interface PresetInteractionDraftStep {
+    type: string;
+    selector: string;
+    delayMs?: number;
+    dismissOn?: string[];
+}
+export interface PresetInteractionDraft {
+    name: string;
+    event: InteractionTriggerEvent | string;
+    selector: string;
+    steps: PresetInteractionDraftStep[];
+}
+export interface InteractionsContextValue {
+    /** The host's site-event automations (for per-element listing). */
+    automations?: InteractionAutomation[];
+    /** Screen/section experiments (badges + duplication guard). */
+    sectionExperiments?: SectionExperimentRef[];
+    /**
+     * Opens the interaction builder for a new automation bound to the
+     * node's element selector — trigger, steps, and frequency configure
+     * inline without leaving the besigner (AGL-319).
+     */
+    onCreateInteraction?: (options: {
+        nodeId: string;
+        event: InteractionTriggerEvent;
+    }) => void;
+    /** Reopens the builder for an existing element automation (AGL-319). */
+    onEditInteraction?: (options: {
+        id: string;
+        nodeId: string;
+    }) => void;
+    /** Creates a draft section experiment targeting the node. */
+    onCreateSectionExperiment?: (options: {
+        nodeId: string;
+    }) => void;
+    /** Enables/disables an element automation in place (wave v7). */
+    onToggleInteraction?: (options: {
+        id: string;
+        enabled: boolean;
+    }) => void;
+    /**
+     * Persists interactions a preset declared for its inserted nodes
+     * (AGL-589) — fired by the add-element flow after the subtree lands
+     * so presets like Dropdown Panel arrive with their hover choreography
+     * already wired and enabled.
+     */
+    onCreatePresetInteractions?: (options: {
+        interactions: PresetInteractionDraft[];
+    }) => void;
+    /** Soft-deletes an element automation (wave v7). */
+    onDeleteInteraction?: (options: {
+        id: string;
+    }) => void;
+}
+export declare const InteractionsContext: import("react").Context<InteractionsContextValue>;
+/** The selector the renderer/automations engine can target for a node. */
+export declare function nodeElementSelector(nodeId: string): string;

package/src/lib/contexts/interactions-context.js

@@ -0,0 +1,22 @@
+/**
+ * @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 { createContext } from "react";
+export const InteractionsContext = createContext({});
+/** The selector the renderer/automations engine can target for a node. */ export function nodeElementSelector(nodeId) {
+    return `[data-aglyn="leaf:${nodeId}"]`;
+}
+
+//# sourceMappingURL=interactions-context.js.map

package/src/lib/contexts/interactions-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/interactions-context.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 { createContext } from 'react'\n\n/**\n * Host-app-provided interactions for the Attributes panel (AGL-258): the\n * console supplies the host's element-scoped automations and section\n * experiments plus creators; the designer stays storage-agnostic and\n * hides the section when no context is provided. Element selectors use\n * the renderer's stable `[data-aglyn=\"leaf:<nodeId>\"]` attribute.\n */\nexport interface InteractionAutomation {\n  id: string\n  name?: string\n  event: string\n  selector?: string\n  enabled?: boolean\n}\n\nexport interface SectionExperimentRef {\n  id: string\n  name?: string\n  nodeId?: string\n  status?: string\n}\n\nexport type InteractionTriggerEvent =\n  | 'elementClick'\n  | 'elementVisible'\n  | 'scrollToElement'\n  // Hover choreography (AGL-562): mega menus, drawers, show/hide.\n  | 'elementHoverEnter'\n  | 'elementHoverLeave'\n\n/**\n * A ready-to-persist interaction resolved from a preset's templates\n * (AGL-589): every ref is already a concrete `[data-aglyn=\"leaf:<id>\"]`\n * selector. The host app validates and writes it like a builder save.\n */\nexport interface PresetInteractionDraftStep {\n  type: string\n  selector: string\n  delayMs?: number\n  dismissOn?: string[]\n}\n\nexport interface PresetInteractionDraft {\n  name: string\n  event: InteractionTriggerEvent | string\n  selector: string\n  steps: PresetInteractionDraftStep[]\n}\n\nexport interface InteractionsContextValue {\n  /** The host's site-event automations (for per-element listing). */\n  automations?: InteractionAutomation[]\n  /** Screen/section experiments (badges + duplication guard). */\n  sectionExperiments?: SectionExperimentRef[]\n  /**\n   * Opens the interaction builder for a new automation bound to the\n   * node's element selector — trigger, steps, and frequency configure\n   * inline without leaving the besigner (AGL-319).\n   */\n  onCreateInteraction?: (options: {\n    nodeId: string\n    event: InteractionTriggerEvent\n  }) => void\n  /** Reopens the builder for an existing element automation (AGL-319). */\n  onEditInteraction?: (options: { id: string; nodeId: string }) => void\n  /** Creates a draft section experiment targeting the node. */\n  onCreateSectionExperiment?: (options: { nodeId: string }) => void\n  /** Enables/disables an element automation in place (wave v7). */\n  onToggleInteraction?: (options: { id: string; enabled: boolean }) => void\n  /**\n   * Persists interactions a preset declared for its inserted nodes\n   * (AGL-589) — fired by the add-element flow after the subtree lands\n   * so presets like Dropdown Panel arrive with their hover choreography\n   * already wired and enabled.\n   */\n  onCreatePresetInteractions?: (options: {\n    interactions: PresetInteractionDraft[]\n  }) => void\n  /** Soft-deletes an element automation (wave v7). */\n  onDeleteInteraction?: (options: { id: string }) => void\n}\n\nexport const InteractionsContext = createContext<InteractionsContextValue>({})\n\n/** The selector the renderer/automations engine can target for a node. */\nexport function nodeElementSelector(nodeId: string): string {\n  return `[data-aglyn=\"leaf:${nodeId}\"]`\n}\n"],"names":["createContext","InteractionsContext","nodeElementSelector","nodeId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,QAAO;AAoFrC,OAAO,MAAMC,sBAAsBD,cAAwC,CAAC,GAAE;AAE9E,wEAAwE,GACxE,OAAO,SAASE,oBAAoBC,MAAc;IAChD,OAAO,CAAC,kBAAkB,EAAEA,OAAO,EAAE,CAAC;AACxC"}

package/src/lib/contexts/layout-chrome-context.d.ts

@@ -0,0 +1,37 @@
+import type * as Aglyn from '@aglyn/aglyn';
+export type LayoutChromeContextValue = {
+    /**
+     * Read-only canvas holding the bound layout's nodes. The viewport renders
+     * it as non-interactive chrome around the editable screen canvas; absent,
+     * the screen renders bare (today's behavior).
+     */
+    chromeCanvas?: Aglyn.CanvasManager;
+};
+export declare const LayoutChromeContext: import("react").Context<LayoutChromeContextValue>;
+export declare function useLayoutChromeContext(): LayoutChromeContextValue;
+/**
+ * Builds the read-only chrome canvas from a layout version's node map.
+ * Returns undefined without nodes so unbound screens skip chrome entirely.
+ *
+ * `reusableDefinitions` (host components keyed by id) grafts the layout's
+ * reusable instances before the canvas loads (AGL-1217). The placeholder an
+ * unexpanded instance renders is the EDITOR's UX — it names what you would
+ * be selecting in the document that owns it — but chrome is not editable
+ * from here, so on this canvas it is just a dashed grey box where the site
+ * shows the nav. Grafting into the chrome canvas alone keeps the layout's
+ * own editor untouched, and chrome stays as locked as it was: expansion
+ * only adds nodes to a canvas the viewport already renders non-interactive.
+ * Omitted or undefined, the graft no-ops and chrome renders as it did.
+ */
+export declare function useLayoutChromeCanvas(layoutNodes: Aglyn.ProcessableNodes | undefined, reusableDefinitions?: Record<string, Aglyn.ReusableComponentTree>, 
+/**
+ * The layout's declared properties and this screen's values for them
+ * (AGL-2893), applied before anything is grafted — the composition the
+ * published page runs, so the chrome shows the banner, copy and choices
+ * this screen will publish with.
+ */
+layoutProps?: {
+    props?: Aglyn.ReusableComponentProp[] | null;
+    values?: Record<string, unknown> | null;
+}): Aglyn.CanvasManager | undefined;
+export default LayoutChromeContext;

package/src/lib/contexts/layout-chrome-context.js

@@ -0,0 +1,75 @@
+/**
+ * @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 { aglyn, applyLayoutProps, CanvasManager, composeReusableComponentNodes, NODE_ROOT_ID } from "@aglyn/aglyn";
+import { createContext, useContext, useMemo } from "react";
+export const LayoutChromeContext = /*#__PURE__*/ createContext({});
+LayoutChromeContext.displayName = 'LayoutChromeContext';
+export function useLayoutChromeContext() {
+    return useContext(LayoutChromeContext);
+}
+/**
+ * Builds the read-only chrome canvas from a layout version's node map.
+ * Returns undefined without nodes so unbound screens skip chrome entirely.
+ *
+ * `reusableDefinitions` (host components keyed by id) grafts the layout's
+ * reusable instances before the canvas loads (AGL-1217). The placeholder an
+ * unexpanded instance renders is the EDITOR's UX — it names what you would
+ * be selecting in the document that owns it — but chrome is not editable
+ * from here, so on this canvas it is just a dashed grey box where the site
+ * shows the nav. Grafting into the chrome canvas alone keeps the layout's
+ * own editor untouched, and chrome stays as locked as it was: expansion
+ * only adds nodes to a canvas the viewport already renders non-interactive.
+ * Omitted or undefined, the graft no-ops and chrome renders as it did.
+ */ export function useLayoutChromeCanvas(layoutNodes, reusableDefinitions, /**
+   * The layout's declared properties and this screen's values for them
+   * (AGL-2893), applied before anything is grafted — the composition the
+   * published page runs, so the chrome shows the banner, copy and choices
+   * this screen will publish with.
+   */ layoutProps) {
+    const declared = layoutProps == null ? void 0 : layoutProps.props;
+    const values = layoutProps == null ? void 0 : layoutProps.values;
+    return useMemo(()=>{
+        var _applyLayoutProps;
+        if (!layoutNodes) return undefined;
+        // Separate store instance so edits, history, and persistence stay on the
+        // global screen canvas — but backed by the real app: node getters reach
+        // through store.aglyn.components to resolve component schemas.
+        const canvas = new CanvasManager(aglyn);
+        // Cast as the tenant pipeline and Preview do: the canvas's `NodeSchema`
+        // makes `componentId` optional, the graft's `AglynNodeSchema` requires
+        // it, and neither side is wrong about its own half of the trip.
+        const nodes = _extends({}, composeReusableComponentNodes((_applyLayoutProps = applyLayoutProps(layoutNodes, declared, values)) != null ? _applyLayoutProps : layoutNodes, reusableDefinitions));
+        // Early seeds stored roots without $id, letting the canvas assign a
+        // random one — pin the root to its canonical id before loading.
+        if (nodes[NODE_ROOT_ID]) {
+            nodes[NODE_ROOT_ID] = _extends({}, nodes[NODE_ROOT_ID], {
+                $id: NODE_ROOT_ID
+            });
+        }
+        canvas.setNodes(canvas.processNodesToDenormalized(nodes));
+        return canvas;
+    }, [
+        layoutNodes,
+        reusableDefinitions,
+        declared,
+        values
+    ]);
+}
+export default LayoutChromeContext;
+
+//# sourceMappingURL=layout-chrome-context.js.map

package/src/lib/contexts/layout-chrome-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/layout-chrome-context.tsx"],"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 type * as Aglyn from '@aglyn/aglyn'\nimport {\n  aglyn,\n  applyLayoutProps,\n  CanvasManager,\n  composeReusableComponentNodes,\n  NODE_ROOT_ID,\n} from '@aglyn/aglyn'\nimport { createContext, useContext, useMemo } from 'react'\n\nexport type LayoutChromeContextValue = {\n  /**\n   * Read-only canvas holding the bound layout's nodes. The viewport renders\n   * it as non-interactive chrome around the editable screen canvas; absent,\n   * the screen renders bare (today's behavior).\n   */\n  chromeCanvas?: Aglyn.CanvasManager\n}\n\nexport const LayoutChromeContext = createContext<LayoutChromeContextValue>({})\nLayoutChromeContext.displayName = 'LayoutChromeContext'\n\nexport function useLayoutChromeContext() {\n  return useContext(LayoutChromeContext)\n}\n\n/**\n * Builds the read-only chrome canvas from a layout version's node map.\n * Returns undefined without nodes so unbound screens skip chrome entirely.\n *\n * `reusableDefinitions` (host components keyed by id) grafts the layout's\n * reusable instances before the canvas loads (AGL-1217). The placeholder an\n * unexpanded instance renders is the EDITOR's UX — it names what you would\n * be selecting in the document that owns it — but chrome is not editable\n * from here, so on this canvas it is just a dashed grey box where the site\n * shows the nav. Grafting into the chrome canvas alone keeps the layout's\n * own editor untouched, and chrome stays as locked as it was: expansion\n * only adds nodes to a canvas the viewport already renders non-interactive.\n * Omitted or undefined, the graft no-ops and chrome renders as it did.\n */\nexport function useLayoutChromeCanvas(\n  layoutNodes: Aglyn.ProcessableNodes | undefined,\n  reusableDefinitions?: Record<string, Aglyn.ReusableComponentTree>,\n  /**\n   * The layout's declared properties and this screen's values for them\n   * (AGL-2893), applied before anything is grafted — the composition the\n   * published page runs, so the chrome shows the banner, copy and choices\n   * this screen will publish with.\n   */\n  layoutProps?: {\n    props?: Aglyn.ReusableComponentProp[] | null\n    values?: Record<string, unknown> | null\n  },\n): Aglyn.CanvasManager | undefined {\n  const declared = layoutProps?.props\n  const values = layoutProps?.values\n  return useMemo(() => {\n    if (!layoutNodes) return undefined\n    // Separate store instance so edits, history, and persistence stay on the\n    // global screen canvas — but backed by the real app: node getters reach\n    // through store.aglyn.components to resolve component schemas.\n    const canvas = new CanvasManager(aglyn)\n    // Cast as the tenant pipeline and Preview do: the canvas's `NodeSchema`\n    // makes `componentId` optional, the graft's `AglynNodeSchema` requires\n    // it, and neither side is wrong about its own half of the trip.\n    const nodes = {\n      ...(composeReusableComponentNodes(\n        (applyLayoutProps(layoutNodes as any, declared, values) ??\n          layoutNodes) as any,\n        reusableDefinitions as any,\n      ) as Record<string, Aglyn.NodeSchema>),\n    }\n    // Early seeds stored roots without $id, letting the canvas assign a\n    // random one — pin the root to its canonical id before loading.\n    if (nodes[NODE_ROOT_ID]) {\n      nodes[NODE_ROOT_ID] = {\n        ...nodes[NODE_ROOT_ID],\n        $id: NODE_ROOT_ID,\n      }\n    }\n    canvas.setNodes(canvas.processNodesToDenormalized(nodes))\n    return canvas\n  }, [layoutNodes, reusableDefinitions, declared, values])\n}\n\nexport default LayoutChromeContext\n"],"names":["aglyn","applyLayoutProps","CanvasManager","composeReusableComponentNodes","NODE_ROOT_ID","createContext","useContext","useMemo","LayoutChromeContext","displayName","useLayoutChromeContext","useLayoutChromeCanvas","layoutNodes","reusableDefinitions","layoutProps","declared","props","values","undefined","canvas","nodes","$id","setNodes","processNodesToDenormalized"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAGA,SACEA,KAAK,EACLC,gBAAgB,EAChBC,aAAa,EACbC,6BAA6B,EAC7BC,YAAY,QACP,eAAc;AACrB,SAASC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAQ,QAAO;AAW1D,OAAO,MAAMC,oCAAsBH,cAAwC,CAAC,GAAE;AAC9EG,oBAAoBC,WAAW,GAAG;AAElC,OAAO,SAASC;IACd,OAAOJ,WAAWE;AACpB;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASG,sBACdC,WAA+C,EAC/CC,mBAAiE,EACjE;;;;;GAKC,GACDC,WAGC;IAED,MAAMC,WAAWD,+BAAAA,YAAaE,KAAK;IACnC,MAAMC,SAASH,+BAAAA,YAAaG,MAAM;IAClC,OAAOV,QAAQ;YAWRN;QAVL,IAAI,CAACW,aAAa,OAAOM;QACzB,yEAAyE;QACzE,wEAAwE;QACxE,+DAA+D;QAC/D,MAAMC,SAAS,IAAIjB,cAAcF;QACjC,wEAAwE;QACxE,uEAAuE;QACvE,gEAAgE;QAChE,MAAMoB,QAAQ,aACRjB,+BACDF,oBAAAA,iBAAiBW,aAAoBG,UAAUE,mBAA/ChB,oBACCW,aACFC;QAGJ,oEAAoE;QACpE,gEAAgE;QAChE,IAAIO,KAAK,CAAChB,aAAa,EAAE;YACvBgB,KAAK,CAAChB,aAAa,GAAG,aACjBgB,KAAK,CAAChB,aAAa;gBACtBiB,KAAKjB;;QAET;QACAe,OAAOG,QAAQ,CAACH,OAAOI,0BAA0B,CAACH;QAClD,OAAOD;IACT,GAAG;QAACP;QAAaC;QAAqBE;QAAUE;KAAO;AACzD;AAEA,eAAeT,oBAAmB"}

package/src/lib/contexts/media-asset-facts-context.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @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 { MediaRef } from '@aglyn/aglyn';
+import { type MediaAssetFacts } from '@aglyn/aglyn/app-utils/media-asset-facts';
+/**
+ * What each placed library asset's DAM document records NOW, for the canvas
+ * (AGL-2838, AGL-2856).
+ *
+ * Picking a library asset copies facts onto its node: a film's running time,
+ * frame pair and poster flag, an image's pixel pair. A replace rewrites the
+ * asset and cannot rewrite the nodes. The published page lays the asset's
+ * current records over the node when it is composed (AGL-2807, AGL-2833); a
+ * canvas drawing the node's props alone would show the replaced file's shape
+ * instead.
+ *
+ * The designer does not read Firestore — it renders inside a plugin sandbox,
+ * and the documents are the host app's to know, which is the same reason
+ * `MediaPickerContext` carries the approved image hosts. So the host app
+ * supplies a source, the canvas holds the assets it is drawing, and
+ * `useMediaAssetFactsOverlay` lays each answer over the render copy through
+ * `applyMediaAssetFacts`, the published page's own rule.
+ *
+ * ABSENT when no host app answers for assets: every placement then renders
+ * from its stored props.
+ */
+export interface MediaAssetFactsSource {
+    /**
+     * The facts filed under `mediaAssetFactsKey`, or `undefined` while nothing
+     * has answered for that asset. Pending, refused, deleted and failed are all
+     * `undefined`, because each of them renders the node's stored props.
+     */
+    get(key: string): MediaAssetFacts | undefined;
+    /**
+     * Keeps the asset's document read while the caller holds it, and returns
+     * the release. Holds are counted, so two placements of one asset share a
+     * read and the read ends with the last of them.
+     */
+    retain(ref: MediaRef): () => void;
+    /** Called after any asset's answer changes. Returns the unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** Moves on every change, so a subscriber can tell a new answer apart. */
+    getVersion(): number;
+}
+/** The source, plus the two ends the host app drives it from. */
+export interface MediaAssetFactsStore extends MediaAssetFactsSource {
+    /** Files an asset's answer; `undefined` withdraws it. */
+    set(key: string, facts: MediaAssetFacts | undefined): void;
+    /**
+     * The assets something currently holds, one per key. The array is replaced
+     * only when that set changes, which is the stable snapshot
+     * `useSyncExternalStore` needs to render one reader per asset.
+     */
+    getRetained(): readonly MediaRef[];
+    /** Called after the held set changes. Returns the unsubscribe. */
+    subscribeRetained(listener: () => void): () => void;
+}
+/** An in-memory store. How each asset is read is the host app's business. */
+export declare function createMediaAssetFactsStore(): MediaAssetFactsStore;
+export declare const MediaAssetFactsContext: import("react").Context<MediaAssetFactsSource>;
+export default MediaAssetFactsContext;

package/src/lib/contexts/media-asset-facts-context.js

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */ // By path: the overlay rules stay out of every `@aglyn/aglyn` barrel.
+import { mediaAssetFactsKey } from "@aglyn/aglyn/app-utils/media-asset-facts";
+import { createContext } from "react";
+import { createHeldAnswersStore } from "../utils/held-answers-store.js";
+/** An in-memory store. How each asset is read is the host app's business. */ export function createMediaAssetFactsStore() {
+    return createHeldAnswersStore(mediaAssetFactsKey);
+}
+export const MediaAssetFactsContext = createContext(undefined);
+MediaAssetFactsContext.displayName = 'MediaAssetFactsContext';
+export default MediaAssetFactsContext;
+
+//# sourceMappingURL=media-asset-facts-context.js.map

package/src/lib/contexts/media-asset-facts-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/media-asset-facts-context.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 { MediaRef } from '@aglyn/aglyn'\n// By path: the overlay rules stay out of every `@aglyn/aglyn` barrel.\nimport {\n  type MediaAssetFacts,\n  mediaAssetFactsKey,\n} from '@aglyn/aglyn/app-utils/media-asset-facts'\nimport { createContext } from 'react'\nimport { createHeldAnswersStore } from '../utils/held-answers-store'\n\n/**\n * What each placed library asset's DAM document records NOW, for the canvas\n * (AGL-2838, AGL-2856).\n *\n * Picking a library asset copies facts onto its node: a film's running time,\n * frame pair and poster flag, an image's pixel pair. A replace rewrites the\n * asset and cannot rewrite the nodes. The published page lays the asset's\n * current records over the node when it is composed (AGL-2807, AGL-2833); a\n * canvas drawing the node's props alone would show the replaced file's shape\n * instead.\n *\n * The designer does not read Firestore — it renders inside a plugin sandbox,\n * and the documents are the host app's to know, which is the same reason\n * `MediaPickerContext` carries the approved image hosts. So the host app\n * supplies a source, the canvas holds the assets it is drawing, and\n * `useMediaAssetFactsOverlay` lays each answer over the render copy through\n * `applyMediaAssetFacts`, the published page's own rule.\n *\n * ABSENT when no host app answers for assets: every placement then renders\n * from its stored props.\n */\nexport interface MediaAssetFactsSource {\n  /**\n   * The facts filed under `mediaAssetFactsKey`, or `undefined` while nothing\n   * has answered for that asset. Pending, refused, deleted and failed are all\n   * `undefined`, because each of them renders the node's stored props.\n   */\n  get(key: string): MediaAssetFacts | undefined\n  /**\n   * Keeps the asset's document read while the caller holds it, and returns\n   * the release. Holds are counted, so two placements of one asset share a\n   * read and the read ends with the last of them.\n   */\n  retain(ref: MediaRef): () => void\n  /** Called after any asset's answer changes. Returns the unsubscribe. */\n  subscribe(listener: () => void): () => void\n  /** Moves on every change, so a subscriber can tell a new answer apart. */\n  getVersion(): number\n}\n\n/** The source, plus the two ends the host app drives it from. */\nexport interface MediaAssetFactsStore extends MediaAssetFactsSource {\n  /** Files an asset's answer; `undefined` withdraws it. */\n  set(key: string, facts: MediaAssetFacts | undefined): void\n  /**\n   * The assets something currently holds, one per key. The array is replaced\n   * only when that set changes, which is the stable snapshot\n   * `useSyncExternalStore` needs to render one reader per asset.\n   */\n  getRetained(): readonly MediaRef[]\n  /** Called after the held set changes. Returns the unsubscribe. */\n  subscribeRetained(listener: () => void): () => void\n}\n\n/** An in-memory store. How each asset is read is the host app's business. */\nexport function createMediaAssetFactsStore(): MediaAssetFactsStore {\n  return createHeldAnswersStore<MediaRef, MediaAssetFacts>(mediaAssetFactsKey)\n}\n\nexport const MediaAssetFactsContext = createContext<\n  MediaAssetFactsSource | undefined\n>(undefined)\nMediaAssetFactsContext.displayName = 'MediaAssetFactsContext'\n\nexport default MediaAssetFactsContext\n"],"names":["mediaAssetFactsKey","createContext","createHeldAnswersStore","createMediaAssetFactsStore","MediaAssetFactsContext","undefined","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,sEAAsE;AACtE,SAEEA,kBAAkB,QACb,2CAA0C;AACjD,SAASC,aAAa,QAAQ,QAAO;AACrC,SAASC,sBAAsB,QAAQ,iCAA6B;AAwDpE,2EAA2E,GAC3E,OAAO,SAASC;IACd,OAAOD,uBAAkDF;AAC3D;AAEA,OAAO,MAAMI,yBAAyBH,cAEpCI,WAAU;AACZD,uBAAuBE,WAAW,GAAG;AAErC,eAAeF,uBAAsB"}