@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/contexts/component-promotion-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 ComponentPromotionContext = createContext({});
+ComponentPromotionContext.displayName = 'ComponentPromotionContext';
+export default ComponentPromotionContext;
+
+//# sourceMappingURL=component-promotion-context.js.map

package/src/lib/contexts/component-promotion-context.js.map

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

package/src/lib/contexts/components-drawer-context.provider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2023 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 ElementType } from 'react';
+import { type CloseableDrawerProps } from '../components/closeable-drawer.component';
+import { type ElementDrawerOptions } from './element-drawer-context';
+export interface ComponentsDrawerContextProviderProps extends Partial<CloseableDrawerProps> {
+    defaultOptions?: ElementDrawerOptions;
+    children?: JSX.Children;
+    component?: ElementType<CloseableDrawerProps>;
+}
+export type ComponentPickerResolve<T> = (value: T | PromiseLike<T>) => void;
+export type ComponentPickerReject = (reason?: unknown) => void;
+export declare function ComponentsDrawerContextProvider(props: ComponentsDrawerContextProviderProps): import("react").JSX.Element;
+export declare namespace ComponentsDrawerContextProvider {
+    var displayName: string;
+    var aglyn: boolean;
+}
+export default ComponentsDrawerContextProvider;

package/src/lib/contexts/components-drawer-context.provider.js

@@ -0,0 +1,80 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2023 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 { Fragment, useCallback, useState } from "react";
+import ComponentPicker from "../components/component-picker.js";
+import { buildOptions, DEFAULT_OPTIONS, ElementDrawerContext } from "./element-drawer-context.js";
+export function ComponentsDrawerContextProvider(props) {
+    const { children, defaultOptions = {} } = props;
+    const [options, setOptions] = useState(()=>_extends({}, DEFAULT_OPTIONS, defaultOptions));
+    const [[resolve, reject], setCallbacks] = useState([]);
+    const open = Boolean(resolve);
+    const handleResolve = useCallback((e, item)=>{
+        try {
+            resolve(item);
+        } catch (e) {
+            console.error(e);
+        } finally{
+            setCallbacks([]);
+        }
+    }, [
+        resolve
+    ]);
+    const handleReject = useCallback((e, reason)=>{
+        try {
+            reject(reason || 'canceled');
+        } catch (e) {
+            console.error(e);
+        } finally{
+            setCallbacks([]);
+        }
+    }, [
+        reject
+    ]);
+    const elementDrawer = useCallback((opts)=>{
+        setOptions(buildOptions(defaultOptions, opts));
+        return new Promise((resolve, reject)=>{
+            setCallbacks([
+                resolve,
+                reject
+            ]);
+        });
+    }, [
+        defaultOptions
+    ]);
+    return /*#__PURE__*/ _jsxs(Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(ElementDrawerContext.Provider, {
+                value: {
+                    elementDrawer,
+                    open
+                },
+                children: children
+            }),
+            /*#__PURE__*/ _jsx(ComponentPicker, {
+                open: open,
+                onClose: handleReject,
+                onSelectItem: handleResolve
+            })
+        ]
+    });
+}
+ComponentsDrawerContextProvider.displayName = 'ComponentsDrawerContextProvider';
+ComponentsDrawerContextProvider.aglyn = true;
+export default ComponentsDrawerContextProvider;
+
+//# sourceMappingURL=components-drawer-context.provider.js.map

package/src/lib/contexts/components-drawer-context.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/contexts/components-drawer-context.provider.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2023 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 ElementType, Fragment, useCallback, useState } from 'react'\nimport { type CloseableDrawerProps } from '../components/closeable-drawer.component'\nimport ComponentPicker from '../components/component-picker'\nimport {\n  buildOptions,\n  DEFAULT_OPTIONS,\n  ElementDrawerContext,\n  type ElementDrawerOptions,\n} from './element-drawer-context'\n\nexport interface ComponentsDrawerContextProviderProps\n  extends Partial<CloseableDrawerProps> {\n  defaultOptions?: ElementDrawerOptions\n  children?: JSX.Children\n  component?: ElementType<CloseableDrawerProps>\n}\n\nexport type ComponentPickerResolve<T> = (value: T | PromiseLike<T>) => void\nexport type ComponentPickerReject = (reason?: unknown) => void\n\nexport function ComponentsDrawerContextProvider(\n  props: ComponentsDrawerContextProviderProps,\n) {\n  const { children, defaultOptions = {} } = props\n  const [options, setOptions] = useState(() => ({\n    ...DEFAULT_OPTIONS,\n    ...defaultOptions,\n  }))\n\n  const [[resolve, reject], setCallbacks] = useState<\n    [resolve?: any, reject?: any]\n  >([])\n  const open = Boolean(resolve)\n\n  const handleResolve = useCallback(\n    (e, item) => {\n      try {\n        resolve(item)\n      } catch (e) {\n        console.error(e)\n      } finally {\n        setCallbacks([])\n      }\n    },\n    [resolve],\n  )\n\n  const handleReject = useCallback(\n    (e, reason: string) => {\n      try {\n        reject(reason || 'canceled')\n      } catch (e) {\n        console.error(e)\n      } finally {\n        setCallbacks([])\n      }\n    },\n    [reject],\n  )\n\n  const elementDrawer = useCallback(\n    (opts?: ElementDrawerOptions) => {\n      setOptions(buildOptions(defaultOptions, opts))\n      return new Promise((resolve, reject) => {\n        setCallbacks([resolve, reject])\n      })\n    },\n    [defaultOptions],\n  )\n\n  return (\n    <Fragment>\n      <ElementDrawerContext.Provider value={{ elementDrawer, open }}>\n        {children}\n      </ElementDrawerContext.Provider>\n      <ComponentPicker\n        open={open}\n        onClose={handleReject}\n        onSelectItem={handleResolve}\n      />\n    </Fragment>\n  )\n}\nComponentsDrawerContextProvider.displayName = 'ComponentsDrawerContextProvider'\nComponentsDrawerContextProvider.aglyn = true\n\nexport default ComponentsDrawerContextProvider\n"],"names":["Fragment","useCallback","useState","ComponentPicker","buildOptions","DEFAULT_OPTIONS","ElementDrawerContext","ComponentsDrawerContextProvider","props","children","defaultOptions","options","setOptions","resolve","reject","setCallbacks","open","Boolean","handleResolve","e","item","console","error","handleReject","reason","elementDrawer","opts","Promise","Provider","value","onClose","onSelectItem","displayName","aglyn"],"mappings":";;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAA2BA,QAAQ,EAAEC,WAAW,EAAEC,QAAQ,QAAQ,QAAO;AAEzE,OAAOC,qBAAqB,oCAAgC;AAC5D,SACEC,YAAY,EACZC,eAAe,EACfC,oBAAoB,QAEf,8BAA0B;AAYjC,OAAO,SAASC,gCACdC,KAA2C;IAE3C,MAAM,EAAEC,QAAQ,EAAEC,iBAAiB,CAAC,CAAC,EAAE,GAAGF;IAC1C,MAAM,CAACG,SAASC,WAAW,GAAGV,SAAS,IAAO,aACzCG,iBACAK;IAGL,MAAM,CAAC,CAACG,SAASC,OAAO,EAAEC,aAAa,GAAGb,SAExC,EAAE;IACJ,MAAMc,OAAOC,QAAQJ;IAErB,MAAMK,gBAAgBjB,YACpB,CAACkB,GAAGC;QACF,IAAI;YACFP,QAAQO;QACV,EAAE,OAAOD,GAAG;YACVE,QAAQC,KAAK,CAACH;QAChB,SAAU;YACRJ,aAAa,EAAE;QACjB;IACF,GACA;QAACF;KAAQ;IAGX,MAAMU,eAAetB,YACnB,CAACkB,GAAGK;QACF,IAAI;YACFV,OAAOU,UAAU;QACnB,EAAE,OAAOL,GAAG;YACVE,QAAQC,KAAK,CAACH;QAChB,SAAU;YACRJ,aAAa,EAAE;QACjB;IACF,GACA;QAACD;KAAO;IAGV,MAAMW,gBAAgBxB,YACpB,CAACyB;QACCd,WAAWR,aAAaM,gBAAgBgB;QACxC,OAAO,IAAIC,QAAQ,CAACd,SAASC;YAC3BC,aAAa;gBAACF;gBAASC;aAAO;QAChC;IACF,GACA;QAACJ;KAAe;IAGlB,qBACE,MAACV;;0BACC,KAACM,qBAAqBsB,QAAQ;gBAACC,OAAO;oBAAEJ;oBAAeT;gBAAK;0BACzDP;;0BAEH,KAACN;gBACCa,MAAMA;gBACNc,SAASP;gBACTQ,cAAcb;;;;AAItB;AACAX,gCAAgCyB,WAAW,GAAG;AAC9CzB,gCAAgC0B,KAAK,GAAG;AAExC,eAAe1B,gCAA+B"}