@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/constants/sample-data.js

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2022 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 const samplePageData = [
+    {
+        $id: 'sample-element-1',
+        componentId: 'sample-element',
+        props: {},
+        nodes: [
+            {
+                $id: 'sample-element-11',
+                componentId: 'sample-element-1',
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-21',
+                componentId: 'sample-element-2',
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-31',
+                componentId: 'sample-element-3',
+                props: {
+                    children: 'hello'
+                }
+            }
+        ]
+    },
+    {
+        $id: 'sample-element-2',
+        componentId: 'sample-element-4',
+        props: {},
+        nodes: [
+            {
+                $id: 'sample-element-13',
+                componentId: 'sample-element-1',
+                sx: {
+                    fontWeight: 'fontWeightBold'
+                },
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-23',
+                componentId: 'sample-element-2',
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-33',
+                componentId: 'sample-element-3',
+                props: {
+                    children: 'hello'
+                }
+            }
+        ]
+    },
+    {
+        $id: 'sample-element-3',
+        componentId: 'sample-element-4',
+        props: {},
+        nodes: [
+            {
+                $id: 'sample-element-14',
+                componentId: 'sample-element-1',
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-24',
+                componentId: 'sample-element-2',
+                props: {
+                    children: 'hello'
+                }
+            },
+            {
+                $id: 'sample-element-34',
+                componentId: 'sample-element-3',
+                props: {
+                    children: 'hello'
+                }
+            }
+        ]
+    }
+];
+
+//# sourceMappingURL=sample-data.js.map

package/src/lib/constants/sample-data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/constants/sample-data.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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 { AglynNodesList } from '@aglyn/aglyn'\n\nexport const samplePageData: AglynNodesList = [\n  {\n    $id: 'sample-element-1',\n    componentId: 'sample-element',\n    props: {},\n    nodes: [\n      {\n        $id: 'sample-element-11',\n        componentId: 'sample-element-1',\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-21',\n        componentId: 'sample-element-2',\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-31',\n        componentId: 'sample-element-3',\n        props: {\n          children: 'hello',\n        },\n      },\n    ],\n  },\n  {\n    $id: 'sample-element-2',\n    componentId: 'sample-element-4',\n    props: {},\n    nodes: [\n      {\n        $id: 'sample-element-13',\n        componentId: 'sample-element-1',\n        sx: { fontWeight: 'fontWeightBold' },\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-23',\n        componentId: 'sample-element-2',\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-33',\n        componentId: 'sample-element-3',\n        props: {\n          children: 'hello',\n        },\n      },\n    ],\n  },\n  {\n    $id: 'sample-element-3',\n    componentId: 'sample-element-4',\n    props: {},\n    nodes: [\n      {\n        $id: 'sample-element-14',\n        componentId: 'sample-element-1',\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-24',\n        componentId: 'sample-element-2',\n        props: {\n          children: 'hello',\n        },\n      },\n      {\n        $id: 'sample-element-34',\n        componentId: 'sample-element-3',\n        props: {\n          children: 'hello',\n        },\n      },\n    ],\n  },\n]\n"],"names":["samplePageData","$id","componentId","props","nodes","children","sx","fontWeight"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID,OAAO,MAAMA,iBAAiC;IAC5C;QACEC,KAAK;QACLC,aAAa;QACbC,OAAO,CAAC;QACRC,OAAO;YACL;gBACEH,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;SACD;IACH;IACA;QACEJ,KAAK;QACLC,aAAa;QACbC,OAAO,CAAC;QACRC,OAAO;YACL;gBACEH,KAAK;gBACLC,aAAa;gBACbI,IAAI;oBAAEC,YAAY;gBAAiB;gBACnCJ,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;SACD;IACH;IACA;QACEJ,KAAK;QACLC,aAAa;QACbC,OAAO,CAAC;QACRC,OAAO;YACL;gBACEH,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,OAAO;oBACLE,UAAU;gBACZ;YACF;SACD;IACH;CACD,CAAA"}

package/src/lib/constants/shared.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022 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 const DEFAULT_LEFT_DRAWER_WIDTH = 240;

package/src/lib/constants/shared.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022 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 const DEFAULT_LEFT_DRAWER_WIDTH = 240;
+
+//# sourceMappingURL=shared.js.map

package/src/lib/constants/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/constants/shared.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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\nexport const DEFAULT_LEFT_DRAWER_WIDTH = 240\n"],"names":["DEFAULT_LEFT_DRAWER_WIDTH"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAO,MAAMA,4BAA4B,IAAG"}

package/src/lib/contexts/besigner-app-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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 AppUUN, type IBesignerAppController } from '@aglyn/besigner';
+export type IBesignerAppContext = IBesignerAppController | undefined;
+export declare const BesignerAppContext: import("react").Context<IBesignerAppController>;
+export default BesignerAppContext;
+export declare function useBesignerAppContext(): IBesignerAppController;
+export interface BesignerAppProviderProps {
+    appName?: AppUUN;
+    children?: JSX.Children;
+}
+export declare function BesignerAppProvider(props: BesignerAppProviderProps): import("react").JSX.Element;
+export declare namespace BesignerAppProvider {
+    var displayName: string;
+    var aglyn: boolean;
+}

package/src/lib/contexts/besigner-app-context.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 { doesBesignerAppExist, getBesignerApp } from "@aglyn/besigner";
+import { createContext, useContext, useMemo } from "react";
+export const BesignerAppContext = /*#__PURE__*/ createContext(undefined);
+BesignerAppContext.displayName = 'BesignerAppContext';
+BesignerAppContext.aglyn = true;
+export default BesignerAppContext;
+export function useBesignerAppContext() {
+    return useContext(BesignerAppContext);
+}
+export function BesignerAppProvider(props) {
+    const { appName, children } = props;
+    // App initialization is browser-only; render undefined during SSR instead
+    // of throwing (matches the previous framework getApp semantics).
+    const state = useMemo(()=>doesBesignerAppExist(appName) ? getBesignerApp(appName) : undefined, [
+        appName
+    ]);
+    return /*#__PURE__*/ _jsx(BesignerAppContext.Provider, {
+        value: state,
+        children: children
+    });
+}
+BesignerAppProvider.displayName = 'BesignerAppProvider';
+BesignerAppProvider.aglyn = true;
+
+//# sourceMappingURL=besigner-app-context.js.map

package/src/lib/contexts/besigner-app-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/besigner-app-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 {\n  type AppUUN,\n  doesBesignerAppExist,\n  getBesignerApp,\n  type IBesignerAppController,\n} from '@aglyn/besigner'\nimport { createContext, useContext, useMemo } from 'react'\n\nexport type IBesignerAppContext = IBesignerAppController | undefined\n\nexport const BesignerAppContext =\n  createContext<IBesignerAppContext>(undefined)\nBesignerAppContext.displayName = 'BesignerAppContext'\nBesignerAppContext.aglyn = true\nexport default BesignerAppContext\n\nexport function useBesignerAppContext(): IBesignerAppController {\n  return useContext(BesignerAppContext)\n}\n\nexport interface BesignerAppProviderProps {\n  appName?: AppUUN\n  children?: JSX.Children\n}\n\nexport function BesignerAppProvider(props: BesignerAppProviderProps) {\n  const { appName, children } = props\n  // App initialization is browser-only; render undefined during SSR instead\n  // of throwing (matches the previous framework getApp semantics).\n  const state = useMemo<IBesignerAppContext>(\n    () => (doesBesignerAppExist(appName) ? getBesignerApp(appName) : undefined),\n    [appName],\n  )\n  return (\n    <BesignerAppContext.Provider value={state}>\n      {children}\n    </BesignerAppContext.Provider>\n  )\n}\nBesignerAppProvider.displayName = 'BesignerAppProvider'\nBesignerAppProvider.aglyn = true\n"],"names":["doesBesignerAppExist","getBesignerApp","createContext","useContext","useMemo","BesignerAppContext","undefined","displayName","aglyn","useBesignerAppContext","BesignerAppProvider","props","appName","children","state","Provider","value"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAEEA,oBAAoB,EACpBC,cAAc,QAET,kBAAiB;AACxB,SAASC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAQ,QAAO;AAI1D,OAAO,MAAMC,mCACXH,cAAmCI,WAAU;AAC/CD,mBAAmBE,WAAW,GAAG;AACjCF,mBAAmBG,KAAK,GAAG;AAC3B,eAAeH,mBAAkB;AAEjC,OAAO,SAASI;IACd,OAAON,WAAWE;AACpB;AAOA,OAAO,SAASK,oBAAoBC,KAA+B;IACjE,MAAM,EAAEC,OAAO,EAAEC,QAAQ,EAAE,GAAGF;IAC9B,0EAA0E;IAC1E,iEAAiE;IACjE,MAAMG,QAAQV,QACZ,IAAOJ,qBAAqBY,WAAWX,eAAeW,WAAWN,WACjE;QAACM;KAAQ;IAEX,qBACE,KAACP,mBAAmBU,QAAQ;QAACC,OAAOF;kBACjCD;;AAGP;AACAH,oBAAoBH,WAAW,GAAG;AAClCG,oBAAoBF,KAAK,GAAG"}

package/src/lib/contexts/binding-picker-context.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @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 binding options for the Attributes panel's "Insert
+ * binding" menu (AGL-100): the console supplies the host's variables
+ * (`{{name}}`) and functions (`{{fn:name(args)}}`); the designer stays
+ * storage-agnostic and hides the control when no options exist.
+ */
+export interface BindingOption {
+    /** Menu label, e.g. `Message` or `Sum(P1, P2)`. */
+    label: string;
+    /** Token appended to the element text, e.g. `{{Message}}`. */
+    token: string;
+    /** Section header the option renders under (e.g. Variables). */
+    group?: string;
+    /**
+     * Live value preview shown as the option's secondary line (AGL-262),
+     * e.g. a variable's current value — picking a binding shouldn't
+     * require remembering what it holds.
+     */
+    preview?: string;
+    /**
+     * Caption rendered under the group's subheader (AGL-583) — e.g. where a
+     * context-dependent token group resolves ("Resolves on collection
+     * pages"). Read from the group's first visible option.
+     */
+    groupHint?: string;
+}
+export interface BindingPickerContextValue {
+    options?: BindingOption[];
+    /**
+     * Live-resolution inputs (AGL-97): the host's variable docs (by name)
+     * and function definitions (by name) so the canvas can render resolved
+     * values via `resolveBindings`. Optional — without them the canvas
+     * shows raw tokens regardless of the toggle.
+     */
+    variables?: Record<string, import('@aglyn/aglyn').HostVariable>;
+    functions?: Record<string, import('@aglyn/aglyn').HostFunction>;
+    /**
+     * Props declared by the reusable component being edited (AGL-1335), so
+     * `{{prop.*}}` is offered in the insert picker like every other binding.
+     *
+     * Set ONLY inside a component editor — everywhere else the tokens would
+     * resolve to nothing, and offering a binding that cannot resolve is worse
+     * than not offering it. That is why this is a context value rather than
+     * something the designer derives: nothing on the canvas says which
+     * definition it belongs to.
+     */
+    componentProps?: import('@aglyn/aglyn').ReusableComponentProp[];
+    /**
+     * Whose properties {@link componentProps} are: a reusable component's, or a
+     * shared layout's (AGL-2893). Both bind the same way; what an empty binding
+     * picker tells the author to add names the right one.
+     */
+    componentPropsOwner?: 'component' | 'layout';
+    /**
+     * The site being edited, for `{{host.*}}` tokens (AGL-2881): the canvas
+     * fills them in from it through the resolver the published page composes
+     * with. Optional — without it the tokens draw as written.
+     */
+    host?: import('@aglyn/aglyn').HostTokenSource | null;
+}
+export declare const BindingPickerContext: import("react").Context<BindingPickerContextValue>;
+export default BindingPickerContext;

package/src/lib/contexts/binding-picker-context.js

@@ -0,0 +1,21 @@
+/**
+ * @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 BindingPickerContext = createContext({});
+BindingPickerContext.displayName = 'BindingPickerContext';
+export default BindingPickerContext;
+
+//# sourceMappingURL=binding-picker-context.js.map

package/src/lib/contexts/binding-picker-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/binding-picker-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 binding options for the Attributes panel's \"Insert\n * binding\" menu (AGL-100): the console supplies the host's variables\n * (`{{name}}`) and functions (`{{fn:name(args)}}`); the designer stays\n * storage-agnostic and hides the control when no options exist.\n */\nexport interface BindingOption {\n  /** Menu label, e.g. `Message` or `Sum(P1, P2)`. */\n  label: string\n  /** Token appended to the element text, e.g. `{{Message}}`. */\n  token: string\n  /** Section header the option renders under (e.g. Variables). */\n  group?: string\n  /**\n   * Live value preview shown as the option's secondary line (AGL-262),\n   * e.g. a variable's current value — picking a binding shouldn't\n   * require remembering what it holds.\n   */\n  preview?: string\n  /**\n   * Caption rendered under the group's subheader (AGL-583) — e.g. where a\n   * context-dependent token group resolves (\"Resolves on collection\n   * pages\"). Read from the group's first visible option.\n   */\n  groupHint?: string\n}\n\nexport interface BindingPickerContextValue {\n  options?: BindingOption[]\n  /**\n   * Live-resolution inputs (AGL-97): the host's variable docs (by name)\n   * and function definitions (by name) so the canvas can render resolved\n   * values via `resolveBindings`. Optional — without them the canvas\n   * shows raw tokens regardless of the toggle.\n   */\n  variables?: Record<string, import('@aglyn/aglyn').HostVariable>\n  functions?: Record<string, import('@aglyn/aglyn').HostFunction>\n  /**\n   * Props declared by the reusable component being edited (AGL-1335), so\n   * `{{prop.*}}` is offered in the insert picker like every other binding.\n   *\n   * Set ONLY inside a component editor — everywhere else the tokens would\n   * resolve to nothing, and offering a binding that cannot resolve is worse\n   * than not offering it. That is why this is a context value rather than\n   * something the designer derives: nothing on the canvas says which\n   * definition it belongs to.\n   */\n  componentProps?: import('@aglyn/aglyn').ReusableComponentProp[]\n  /**\n   * Whose properties {@link componentProps} are: a reusable component's, or a\n   * shared layout's (AGL-2893). Both bind the same way; what an empty binding\n   * picker tells the author to add names the right one.\n   */\n  componentPropsOwner?: 'component' | 'layout'\n  /**\n   * The site being edited, for `{{host.*}}` tokens (AGL-2881): the canvas\n   * fills them in from it through the resolver the published page composes\n   * with. Optional — without it the tokens draw as written.\n   */\n  host?: import('@aglyn/aglyn').HostTokenSource | null\n}\n\nexport const BindingPickerContext = createContext<BindingPickerContextValue>(\n  {},\n)\nBindingPickerContext.displayName = 'BindingPickerContext'\n\nexport default BindingPickerContext\n"],"names":["createContext","BindingPickerContext","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,QAAO;AAgErC,OAAO,MAAMC,uBAAuBD,cAClC,CAAC,GACF;AACDC,qBAAqBC,WAAW,GAAG;AAEnC,eAAeD,qBAAoB"}

package/src/lib/contexts/canvas-host-tokens-context.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @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 HostTokenSource } from '@aglyn/aglyn';
+import { type ReactNode } from 'react';
+/**
+ * The site whose `{{host.*}}` tokens the canvas fills in (AGL-2881), or
+ * `undefined` to draw them as written.
+ *
+ * Every leaf the canvas draws needs the answer — the document's own nodes, a
+ * component instance's definition, a placed form's design, the layout chrome —
+ * so it is decided once, at the top of the canvas, and carried down by context
+ * rather than by a subscription on every element.
+ */
+export declare const CanvasHostTokensContext: import("react").Context<HostTokenSource>;
+export interface CanvasHostTokensProviderProps {
+    children?: ReactNode;
+}
+/**
+ * Decides {@link CanvasHostTokensContext} from the site the console hands the
+ * binding picker, and from the WYSIWYG bindings toggle.
+ *
+ * The raw-token view keeps the tokens: an author who turned resolution off
+ * asked to see what is written, and a business name is a resolved value like
+ * a variable's. With no site to read — still loading, or a surface that has
+ * none — the tokens draw as written too.
+ *
+ * The value keeps its identity while every token resolves to the same thing.
+ * The console's host document is a new object on each snapshot, and a write to
+ * a field no token reads would otherwise redraw every leaf on the canvas.
+ */
+export declare function CanvasHostTokensProvider(props: CanvasHostTokensProviderProps): import("react").JSX.Element;
+export declare namespace CanvasHostTokensProvider {
+    var displayName: string;
+}
+export default CanvasHostTokensContext;

package/src/lib/contexts/canvas-host-tokens-context.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 { hostTokenMerge } from "@aglyn/aglyn";
+import { createContext, useContext, useMemo } from "react";
+import useAglynBesignerFlag from "../hooks/use-aglyn-besigner-flag.js";
+import BindingPickerContext from "./binding-picker-context.js";
+/**
+ * The site whose `{{host.*}}` tokens the canvas fills in (AGL-2881), or
+ * `undefined` to draw them as written.
+ *
+ * Every leaf the canvas draws needs the answer — the document's own nodes, a
+ * component instance's definition, a placed form's design, the layout chrome —
+ * so it is decided once, at the top of the canvas, and carried down by context
+ * rather than by a subscription on every element.
+ */ export const CanvasHostTokensContext = /*#__PURE__*/ createContext(undefined);
+CanvasHostTokensContext.displayName = 'CanvasHostTokensContext';
+/**
+ * Decides {@link CanvasHostTokensContext} from the site the console hands the
+ * binding picker, and from the WYSIWYG bindings toggle.
+ *
+ * The raw-token view keeps the tokens: an author who turned resolution off
+ * asked to see what is written, and a business name is a resolved value like
+ * a variable's. With no site to read — still loading, or a surface that has
+ * none — the tokens draw as written too.
+ *
+ * The value keeps its identity while every token resolves to the same thing.
+ * The console's host document is a new object on each snapshot, and a write to
+ * a field no token reads would otherwise redraw every leaf on the canvas.
+ */ export function CanvasHostTokensProvider(props) {
+    const { children } = props;
+    const [resolveFlag] = useAglynBesignerFlag('resolveBindings');
+    const { host } = useContext(BindingPickerContext);
+    const site = resolveFlag === false ? undefined : host != null ? host : undefined;
+    const resolvedTokens = site ? JSON.stringify(hostTokenMerge(site)) : '';
+    const value = useMemo(()=>site, // What every token resolves to keys the value, not the document's
+    // identity.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        resolvedTokens
+    ]);
+    return /*#__PURE__*/ _jsx(CanvasHostTokensContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+CanvasHostTokensProvider.displayName = 'CanvasHostTokensProvider';
+export default CanvasHostTokensContext;
+
+//# sourceMappingURL=canvas-host-tokens-context.js.map

package/src/lib/contexts/canvas-host-tokens-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/canvas-host-tokens-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 HostTokenSource, hostTokenMerge } from '@aglyn/aglyn'\nimport { createContext, type ReactNode, useContext, useMemo } from 'react'\nimport useAglynBesignerFlag from '../hooks/use-aglyn-besigner-flag'\nimport BindingPickerContext from './binding-picker-context'\n\n/**\n * The site whose `{{host.*}}` tokens the canvas fills in (AGL-2881), or\n * `undefined` to draw them as written.\n *\n * Every leaf the canvas draws needs the answer — the document's own nodes, a\n * component instance's definition, a placed form's design, the layout chrome —\n * so it is decided once, at the top of the canvas, and carried down by context\n * rather than by a subscription on every element.\n */\nexport const CanvasHostTokensContext = createContext<\n  HostTokenSource | undefined\n>(undefined)\nCanvasHostTokensContext.displayName = 'CanvasHostTokensContext'\n\nexport interface CanvasHostTokensProviderProps {\n  children?: ReactNode\n}\n\n/**\n * Decides {@link CanvasHostTokensContext} from the site the console hands the\n * binding picker, and from the WYSIWYG bindings toggle.\n *\n * The raw-token view keeps the tokens: an author who turned resolution off\n * asked to see what is written, and a business name is a resolved value like\n * a variable's. With no site to read — still loading, or a surface that has\n * none — the tokens draw as written too.\n *\n * The value keeps its identity while every token resolves to the same thing.\n * The console's host document is a new object on each snapshot, and a write to\n * a field no token reads would otherwise redraw every leaf on the canvas.\n */\nexport function CanvasHostTokensProvider(props: CanvasHostTokensProviderProps) {\n  const { children } = props\n  const [resolveFlag] = useAglynBesignerFlag('resolveBindings')\n  const { host } = useContext(BindingPickerContext)\n  const site = resolveFlag === false ? undefined : (host ?? undefined)\n  const resolvedTokens = site ? JSON.stringify(hostTokenMerge(site)) : ''\n  const value = useMemo(\n    () => site,\n    // What every token resolves to keys the value, not the document's\n    // identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [resolvedTokens],\n  )\n  return (\n    <CanvasHostTokensContext.Provider value={value}>\n      {children}\n    </CanvasHostTokensContext.Provider>\n  )\n}\nCanvasHostTokensProvider.displayName = 'CanvasHostTokensProvider'\n\nexport default CanvasHostTokensContext\n"],"names":["hostTokenMerge","createContext","useContext","useMemo","useAglynBesignerFlag","BindingPickerContext","CanvasHostTokensContext","undefined","displayName","CanvasHostTokensProvider","props","children","resolveFlag","host","site","resolvedTokens","JSON","stringify","value","Provider"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAA+BA,cAAc,QAAQ,eAAc;AACnE,SAASC,aAAa,EAAkBC,UAAU,EAAEC,OAAO,QAAQ,QAAO;AAC1E,OAAOC,0BAA0B,sCAAkC;AACnE,OAAOC,0BAA0B,8BAA0B;AAE3D;;;;;;;;CAQC,GACD,OAAO,MAAMC,wCAA0BL,cAErCM,WAAU;AACZD,wBAAwBE,WAAW,GAAG;AAMtC;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,yBAAyBC,KAAoC;IAC3E,MAAM,EAAEC,QAAQ,EAAE,GAAGD;IACrB,MAAM,CAACE,YAAY,GAAGR,qBAAqB;IAC3C,MAAM,EAAES,IAAI,EAAE,GAAGX,WAAWG;IAC5B,MAAMS,OAAOF,gBAAgB,QAAQL,YAAaM,eAAAA,OAAQN;IAC1D,MAAMQ,iBAAiBD,OAAOE,KAAKC,SAAS,CAACjB,eAAec,SAAS;IACrE,MAAMI,QAAQf,QACZ,IAAMW,MACN,kEAAkE;IAClE,YAAY;IACZ,uDAAuD;IACvD;QAACC;KAAe;IAElB,qBACE,KAACT,wBAAwBa,QAAQ;QAACD,OAAOA;kBACtCP;;AAGP;AACAF,yBAAyBD,WAAW,GAAG;AAEvC,eAAeF,wBAAuB"}

package/src/lib/contexts/canvas-reveal-context.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.
+ */
+/**
+ * Nodes the canvas is showing despite the hidden class (AGL-592).
+ *
+ * Read from the `revealedNodeIds` flag once, at the top of the canvas, and
+ * carried down by context: every leaf needs the answer, and a subscription
+ * per leaf would put one on every element on the page. Undefined outside the
+ * canvas, where nothing has been revealed.
+ */
+export declare const CanvasRevealContext: import("react").Context<readonly string[]>;
+/**
+ * Classes the canvas is rendering without (AGL-2486). Read from the
+ * `mutedClasses` flag once, at the top of the canvas, for the same reason
+ * the reveal list is: every leaf needs the answer.
+ */
+export declare const CanvasMutedClassesContext: import("react").Context<readonly string[]>;
+export default CanvasRevealContext;

package/src/lib/contexts/canvas-reveal-context.js

@@ -0,0 +1,34 @@
+/**
+ * @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";
+/**
+ * Nodes the canvas is showing despite the hidden class (AGL-592).
+ *
+ * Read from the `revealedNodeIds` flag once, at the top of the canvas, and
+ * carried down by context: every leaf needs the answer, and a subscription
+ * per leaf would put one on every element on the page. Undefined outside the
+ * canvas, where nothing has been revealed.
+ */ export const CanvasRevealContext = createContext(undefined);
+CanvasRevealContext.displayName = 'CanvasRevealContext';
+/**
+ * Classes the canvas is rendering without (AGL-2486). Read from the
+ * `mutedClasses` flag once, at the top of the canvas, for the same reason
+ * the reveal list is: every leaf needs the answer.
+ */ export const CanvasMutedClassesContext = createContext(undefined);
+CanvasMutedClassesContext.displayName = 'CanvasMutedClassesContext';
+export default CanvasRevealContext;
+
+//# sourceMappingURL=canvas-reveal-context.js.map

package/src/lib/contexts/canvas-reveal-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/canvas-reveal-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 * Nodes the canvas is showing despite the hidden class (AGL-592).\n *\n * Read from the `revealedNodeIds` flag once, at the top of the canvas, and\n * carried down by context: every leaf needs the answer, and a subscription\n * per leaf would put one on every element on the page. Undefined outside the\n * canvas, where nothing has been revealed.\n */\nexport const CanvasRevealContext = createContext<readonly string[] | undefined>(\n  undefined,\n)\nCanvasRevealContext.displayName = 'CanvasRevealContext'\n\n/**\n * Classes the canvas is rendering without (AGL-2486). Read from the\n * `mutedClasses` flag once, at the top of the canvas, for the same reason\n * the reveal list is: every leaf needs the answer.\n */\nexport const CanvasMutedClassesContext = createContext<\n  readonly string[] | undefined\n>(undefined)\nCanvasMutedClassesContext.displayName = 'CanvasMutedClassesContext'\n\nexport default CanvasRevealContext\n"],"names":["createContext","CanvasRevealContext","undefined","displayName","CanvasMutedClassesContext"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,QAAO;AAErC;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsBD,cACjCE,WACD;AACDD,oBAAoBE,WAAW,GAAG;AAElC;;;;CAIC,GACD,OAAO,MAAMC,4BAA4BJ,cAEvCE,WAAU;AACZE,0BAA0BD,WAAW,GAAG;AAExC,eAAeF,oBAAmB"}

package/src/lib/contexts/component-promotion-context.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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';
+/**
+ * Host-app callbacks for reusable-component flows (AGL-35). The designer
+ * stays storage-agnostic: the console provides `onPromote` ("Save as
+ * reusable component" on a selected subtree) and `onDemote` ("Detach" an
+ * instance into an editable copy); the Attributes panel shows the actions
+ * only when the callbacks exist.
+ */
+export interface ComponentPromotionContextValue {
+    onPromote?: (node: Aglyn.NodeSchema<any>) => void;
+    onDemote?: (node: Aglyn.NodeSchema<any>) => void;
+    /**
+     * "Edit component" on a selected instance (AGL-1303 phase 1): the
+     * console opens the component's own besigner in a new tab. Kills the
+     * dead end where the panel offered only Save-as/Detach and an author
+     * could not find where the component's truth lives.
+     *
+     * This comment used to say phase 2's live propagation "rides AGL-1301's
+     * co-editing on component documents — no extra plumbing here". That is
+     * wrong in two ways, and it was load-bearing enough to mislead whoever
+     * picked phase 2 up (AGL-1898). AGL-1301's co-editing DID land for
+     * component documents, but its RTDB room is keyed
+     * `coedit/{org}/{host}/{docType}/{docId}/…`: a screen besigner subscribes
+     * to its own screen's room and never to a component's. Even if it did,
+     * the payload is component-internal node ids, not the
+     * `cmp__{instance}__{def}` ids a screen renders.
+     *
+     * The propagation that actually works is unrelated to co-editing:
+     * {@link definitions} arrives from a live `onSnapshot` over the host's
+     * `components` collection, so an open canvas re-renders its instances
+     * when a component's PARENT doc changes. In the component editor, Save
+     * writes only the version doc; Publish writes the parent. So today the
+     * loop is edit → Save → **Publish** → other tabs update, and a Save alone
+     * does nothing anywhere else. Whether Save should propagate is a product
+     * question (it would show screen authors component content the live site
+     * does not have) and is open on AGL-1898 — not something to infer from
+     * this comment.
+     */
+    onEditComponent?: (node: Aglyn.NodeSchema<any>) => void;
+    /**
+     * The host's component definitions, keyed by id (AGL-1247/1251). The
+     * designer stays storage-agnostic: the console reads them and passes them
+     * down, exactly as it does the callbacks above.
+     *
+     * Three consumers, deliberately one field: the Attributes panel reads each
+     * definition's declared `props` to build an instance's fields, `NodeLeaf`
+     * renders the definition's subtree inside the instance so the canvas shows
+     * the component instead of a dashed box, and `ComponentIconComponent`
+     * reads its chosen `icon` (AGL-1193). Splitting them would let the panel,
+     * the canvas and the hierarchy disagree about what a definition is.
+     */
+    definitions?: Record<string, Aglyn.ReusableComponentTree | undefined>;
+    /**
+     * The host's FORM entities, keyed by id — the published `rootId`/`nodes`
+     * design of each, in the shape the graft consumes
+     * (`docs/specs/reusable-forms.md`).
+     *
+     * Beside {@link definitions} rather than in a context of its own because a
+     * placed form and a component instance are one mechanism: both are a node
+     * standing for a tree stored on another document, both are expanded by
+     * `composeReusableComponentNodes`, and `NodeLeaf` needs both in the same
+     * memo — a form design may contain an instance, and a component may contain
+     * a placed form. Two contexts would have to be kept in step by hand for a
+     * canvas that has to graft them together anyway.
+     *
+     * `undefined` while the read is still settling, distinct from `{}` for "this
+     * host has none": grafting against an empty map would draw the page's own
+     * fields and swap them for the entity's a beat later.
+     */
+    formDesigns?: Record<string, Aglyn.PlacedFormDesign | undefined>;
+}
+export declare const ComponentPromotionContext: import("react").Context<ComponentPromotionContextValue>;
+export default ComponentPromotionContext;