@aglyn/besigner 1.0.0-beta.143

package/src/lib/clipboard-manager/style-clipboard.js

@@ -0,0 +1,173 @@
+/**
+ * @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 { canvas } from "@aglyn/aglyn";
+import { observable, runInAction } from "mobx";
+import { localStore, parseMirrored, watchMirror } from "./clipboard-mirror.js";
+/**
+ * Besigner STYLE clipboard.
+ *
+ * The element clipboard beside it carries whole subtrees. This carries a
+ * look: everything the Styles panel writes to one element, so a heading
+ * styled once can be applied to five more without rebuilding it field by
+ * field or duplicating an element and re-authoring its content.
+ *
+ * ## What a "style" is here
+ *
+ * `node.sx` and only `node.sx` — the Styles panel's entire output, including
+ * its responsive, `@scheme` and interaction-state slices, which are keys
+ * inside that object rather than separate storage.
+ *
+ * NOT classes. A class is a name pointing at rules the element does not own,
+ * and two of them carry behaviour rather than appearance: `aglyn-hidden`
+ * enrols an element in interaction choreography, and a theme utility class
+ * may be targeted by an interaction's class steps. Carrying those across on
+ * a "paste styles" would move behaviour under a label that promises looks.
+ *
+ * ## Paste REPLACES
+ *
+ * Merging would make the result depend on what the target already had, so
+ * pasting the same look onto two elements could produce two different
+ * elements — and there would be no way to paste "no styles". Undo is the way
+ * back, as it is for every other edit.
+ *
+ * Mirrored into `localStorage` on the same terms as the element clipboard, so
+ * a look copied in one document can be pasted in another after the full page
+ * navigation between two besigner routes.
+ */ /** `localStorage` key holding the mirrored style entry. */ export const STYLE_CLIPBOARD_STORAGE_KEY = 'aglyn:besigner:style-clipboard';
+/** Bumped when the persisted shape changes; an older entry is dropped. */ export const STYLE_CLIPBOARD_FORMAT_VERSION = 1;
+const state = observable({
+    entry: null,
+    hydrated: false
+});
+const parseEntry = (raw)=>parseMirrored(raw, STYLE_CLIPBOARD_FORMAT_VERSION);
+function hydrate() {
+    if (state.hydrated) return;
+    runInAction(()=>{
+        state.hydrated = true;
+    });
+    let parsed = null;
+    try {
+        var _ref;
+        var _localStore;
+        parsed = parseEntry((_ref = (_localStore = localStore()) == null ? void 0 : _localStore.getItem(STYLE_CLIPBOARD_STORAGE_KEY)) != null ? _ref : null);
+    } catch (unused) {
+    // A corrupt or foreign entry is no entry. Never throw on read.
+    }
+    if (!parsed) return;
+    runInAction(()=>{
+        state.entry = parsed;
+    });
+}
+/**
+ * A look copied in another besigner tab is this document's look too. Without
+ * this the mirror is read once and the document goes on pasting the first
+ * style it ever saw, however many times the tab next door copies a new one
+ * (AGL-2507).
+ */ watchMirror(STYLE_CLIPBOARD_STORAGE_KEY, (raw)=>{
+    const entry = parseEntry(raw);
+    runInAction(()=>{
+        state.entry = entry;
+        // The mirror has now been consulted, whatever it held.
+        state.hydrated = true;
+    });
+});
+/** The copied look, or null. */ export function getStyleEntry() {
+    hydrate();
+    return state.entry;
+}
+/** Whether anything has been copied. Observed, so menus enable on copy. */ export function hasStyles() {
+    return Boolean(getStyleEntry());
+}
+/** The label of the element the look came from, for the menu. */ export function getStyleLabel() {
+    var _ref;
+    var _getStyleEntry;
+    return (_ref = (_getStyleEntry = getStyleEntry()) == null ? void 0 : _getStyleEntry.label) != null ? _ref : '';
+}
+/** Takes the look off one node. Returns false when there is no node. */ export function copyStyles(node) {
+    var _ref, _node_labelShort;
+    var _node_componentSchema;
+    if (!node) return false;
+    // Deep-cloned through JSON: `node.sx` is a MobX observable, and keeping a
+    // live reference would make the clipboard track later edits to the element
+    // it was copied from — a copy that changes under you is not a copy.
+    let sx;
+    try {
+        sx = node.sx ? JSON.parse(JSON.stringify(node.sx)) : null;
+    } catch (unused) {
+        return false;
+    }
+    // The ELEMENT's own label. `labelShort` answers the document root with the
+    // document's name, which is a true answer to a different question and reads
+    // as "paste styles from this whole screen" on the menu below.
+    const label = canvas.isRootNode(node) ? (_ref = (_node_componentSchema = node.componentSchema) == null ? void 0 : _node_componentSchema.displayName) != null ? _ref : 'element' : (_node_labelShort = node.labelShort) != null ? _node_labelShort : 'element';
+    const entry = {
+        version: STYLE_CLIPBOARD_FORMAT_VERSION,
+        label,
+        sx
+    };
+    runInAction(()=>{
+        state.entry = entry;
+        state.hydrated = true;
+    });
+    const store = localStore();
+    try {
+        store == null ? void 0 : store.setItem(STYLE_CLIPBOARD_STORAGE_KEY, JSON.stringify(entry));
+    } catch (unused) {
+    // A full or unavailable store costs the cross-document paste, not the
+    // copy — the in-memory entry above is already set.
+    }
+    return true;
+}
+/**
+ * Applies the copied look to a node, replacing whatever it had.
+ *
+ * Returns false when there is nothing to paste. A copied entry of `null`
+ * styles IS something to paste — it clears the target — which is why the
+ * check is on the entry rather than on its `sx`.
+ */ export function pasteStyles(node) {
+    const entry = getStyleEntry();
+    if (!node || !entry) return false;
+    let sx;
+    try {
+        sx = entry.sx ? JSON.parse(JSON.stringify(entry.sx)) : null;
+    } catch (unused) {
+        return false;
+    }
+    // Through the canvas, not by assigning to `node.sx`. That records an undo
+    // step — a paste the author cannot take back is worse than no paste — and
+    // it re-resolves the node by `$id`, because a caller can be holding an
+    // instance the map replaced (an undo, a draft restore), and writing to that
+    // one loses the edit silently. Cloned per target as well: pasting onto
+    // three elements must give three independent objects.
+    canvas.updateNodeFields(node, {
+        sx: sx != null ? sx : undefined
+    });
+    return true;
+}
+/** Forgets the copied look. Tests, and a future "clear" affordance. */ export function clearStyles() {
+    runInAction(()=>{
+        state.entry = null;
+        state.hydrated = true;
+    });
+    try {
+        var _localStore;
+        (_localStore = localStore()) == null ? void 0 : _localStore.removeItem(STYLE_CLIPBOARD_STORAGE_KEY);
+    } catch (unused) {
+    // Ditto.
+    }
+}
+
+//# sourceMappingURL=style-clipboard.js.map

package/src/lib/clipboard-manager/style-clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/clipboard-manager/style-clipboard.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 { canvas } from '@aglyn/aglyn'\nimport { observable, runInAction } from 'mobx'\nimport { localStore, parseMirrored, watchMirror } from './clipboard-mirror'\n\n/**\n * Besigner STYLE clipboard.\n *\n * The element clipboard beside it carries whole subtrees. This carries a\n * look: everything the Styles panel writes to one element, so a heading\n * styled once can be applied to five more without rebuilding it field by\n * field or duplicating an element and re-authoring its content.\n *\n * ## What a \"style\" is here\n *\n * `node.sx` and only `node.sx` — the Styles panel's entire output, including\n * its responsive, `@scheme` and interaction-state slices, which are keys\n * inside that object rather than separate storage.\n *\n * NOT classes. A class is a name pointing at rules the element does not own,\n * and two of them carry behaviour rather than appearance: `aglyn-hidden`\n * enrols an element in interaction choreography, and a theme utility class\n * may be targeted by an interaction's class steps. Carrying those across on\n * a \"paste styles\" would move behaviour under a label that promises looks.\n *\n * ## Paste REPLACES\n *\n * Merging would make the result depend on what the target already had, so\n * pasting the same look onto two elements could produce two different\n * elements — and there would be no way to paste \"no styles\". Undo is the way\n * back, as it is for every other edit.\n *\n * Mirrored into `localStorage` on the same terms as the element clipboard, so\n * a look copied in one document can be pasted in another after the full page\n * navigation between two besigner routes.\n */\n\n/** `localStorage` key holding the mirrored style entry. */\nexport const STYLE_CLIPBOARD_STORAGE_KEY = 'aglyn:besigner:style-clipboard'\n\n/** Bumped when the persisted shape changes; an older entry is dropped. */\nexport const STYLE_CLIPBOARD_FORMAT_VERSION = 1\n\nexport interface StyleClipboardEntry {\n  version: number\n  /** The element the look was taken from, for the menu (\"from Heading\"). */\n  label: string\n  /** The Styles panel's whole output. `null` is a real value: no styles. */\n  sx: Record<string, unknown> | null\n}\n\ninterface StyleClipboardState {\n  entry: StyleClipboardEntry | null\n  hydrated: boolean\n}\n\nconst state = observable<StyleClipboardState>({ entry: null, hydrated: false })\n\nconst parseEntry = (raw: string | null): StyleClipboardEntry | null =>\n  parseMirrored<StyleClipboardEntry>(raw, STYLE_CLIPBOARD_FORMAT_VERSION)\n\nfunction hydrate(): void {\n  if (state.hydrated) return\n  runInAction(() => {\n    state.hydrated = true\n  })\n  let parsed: StyleClipboardEntry | null = null\n  try {\n    parsed = parseEntry(\n      localStore()?.getItem(STYLE_CLIPBOARD_STORAGE_KEY) ?? null,\n    )\n  } catch {\n    // A corrupt or foreign entry is no entry. Never throw on read.\n  }\n  if (!parsed) return\n  runInAction(() => {\n    state.entry = parsed\n  })\n}\n\n/**\n * A look copied in another besigner tab is this document's look too. Without\n * this the mirror is read once and the document goes on pasting the first\n * style it ever saw, however many times the tab next door copies a new one\n * (AGL-2507).\n */\nwatchMirror(STYLE_CLIPBOARD_STORAGE_KEY, (raw) => {\n  const entry = parseEntry(raw)\n  runInAction(() => {\n    state.entry = entry\n    // The mirror has now been consulted, whatever it held.\n    state.hydrated = true\n  })\n})\n\n/** The copied look, or null. */\nexport function getStyleEntry(): StyleClipboardEntry | null {\n  hydrate()\n  return state.entry\n}\n\n/** Whether anything has been copied. Observed, so menus enable on copy. */\nexport function hasStyles(): boolean {\n  return Boolean(getStyleEntry())\n}\n\n/** The label of the element the look came from, for the menu. */\nexport function getStyleLabel(): string {\n  return getStyleEntry()?.label ?? ''\n}\n\n/** Takes the look off one node. Returns false when there is no node. */\nexport function copyStyles(node: Aglyn.NodeSchema<any> | undefined): boolean {\n  if (!node) return false\n  // Deep-cloned through JSON: `node.sx` is a MobX observable, and keeping a\n  // live reference would make the clipboard track later edits to the element\n  // it was copied from — a copy that changes under you is not a copy.\n  let sx: Record<string, unknown> | null\n  try {\n    sx = node.sx ? (JSON.parse(JSON.stringify(node.sx)) as never) : null\n  } catch {\n    return false\n  }\n  // The ELEMENT's own label. `labelShort` answers the document root with the\n  // document's name, which is a true answer to a different question and reads\n  // as \"paste styles from this whole screen\" on the menu below.\n  const label = canvas.isRootNode(node)\n    ? (node.componentSchema?.displayName ?? 'element')\n    : (node.labelShort ?? 'element')\n  const entry: StyleClipboardEntry = {\n    version: STYLE_CLIPBOARD_FORMAT_VERSION,\n    label,\n    sx,\n  }\n  runInAction(() => {\n    state.entry = entry\n    state.hydrated = true\n  })\n  const store = localStore()\n  try {\n    store?.setItem(STYLE_CLIPBOARD_STORAGE_KEY, JSON.stringify(entry))\n  } catch {\n    // A full or unavailable store costs the cross-document paste, not the\n    // copy — the in-memory entry above is already set.\n  }\n  return true\n}\n\n/**\n * Applies the copied look to a node, replacing whatever it had.\n *\n * Returns false when there is nothing to paste. A copied entry of `null`\n * styles IS something to paste — it clears the target — which is why the\n * check is on the entry rather than on its `sx`.\n */\nexport function pasteStyles(node: Aglyn.NodeSchema<any> | undefined): boolean {\n  const entry = getStyleEntry()\n  if (!node || !entry) return false\n  let sx: Record<string, unknown> | null\n  try {\n    sx = entry.sx ? (JSON.parse(JSON.stringify(entry.sx)) as never) : null\n  } catch {\n    return false\n  }\n  // Through the canvas, not by assigning to `node.sx`. That records an undo\n  // step — a paste the author cannot take back is worse than no paste — and\n  // it re-resolves the node by `$id`, because a caller can be holding an\n  // instance the map replaced (an undo, a draft restore), and writing to that\n  // one loses the edit silently. Cloned per target as well: pasting onto\n  // three elements must give three independent objects.\n  canvas.updateNodeFields(node, { sx: (sx ?? undefined) as never })\n  return true\n}\n\n/** Forgets the copied look. Tests, and a future \"clear\" affordance. */\nexport function clearStyles(): void {\n  runInAction(() => {\n    state.entry = null\n    state.hydrated = true\n  })\n  try {\n    localStore()?.removeItem(STYLE_CLIPBOARD_STORAGE_KEY)\n  } catch {\n    // Ditto.\n  }\n}\n"],"names":["canvas","observable","runInAction","localStore","parseMirrored","watchMirror","STYLE_CLIPBOARD_STORAGE_KEY","STYLE_CLIPBOARD_FORMAT_VERSION","state","entry","hydrated","parseEntry","raw","hydrate","parsed","getItem","getStyleEntry","hasStyles","Boolean","getStyleLabel","label","copyStyles","node","sx","JSON","parse","stringify","isRootNode","componentSchema","displayName","labelShort","version","store","setItem","pasteStyles","updateNodeFields","undefined","clearStyles","removeItem"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+/**
+ * @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.
+ */
+import type { AppUUN, IBesignerAppController } from '../definitions/besigner-app.types';
+import type { IBesignerInterfaceController } from '../definitions/besigner-interface.types';
+export declare const _INTERNAL_BESIGNERS_: Map<AppUUN, IBesignerInterfaceController>;
+export declare const _INTERNAL_BESIGNER_APPS_: Map<AppUUN, IBesignerAppController>;

package/src/lib/constants/_internal.js

@@ -0,0 +1,19 @@
+/**
+ * @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 _INTERNAL_BESIGNERS_ = new Map();
+export const _INTERNAL_BESIGNER_APPS_ = new Map();
+
+//# sourceMappingURL=_internal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/constants/_internal.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\nimport type {\n  AppUUN,\n  IBesignerAppController,\n} from '../definitions/besigner-app.types'\nimport type { IBesignerInterfaceController } from '../definitions/besigner-interface.types'\n\nexport const _INTERNAL_BESIGNERS_: Map<AppUUN, IBesignerInterfaceController> =\n  new Map()\n\nexport const _INTERNAL_BESIGNER_APPS_: Map<AppUUN, IBesignerAppController> =\n  new Map()\n"],"names":["_INTERNAL_BESIGNERS_","Map","_INTERNAL_BESIGNER_APPS_"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAQD,OAAO,MAAMA,uBACX,IAAIC,MAAK;AAEX,OAAO,MAAMC,2BACX,IAAID,MAAK"}

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

@@ -0,0 +1,78 @@
+/**
+ * @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 enum InteractionModeFlag {
+    SELECT = 1,
+    REARRANGE = 2,
+    PREVIEW = 3
+}
+export declare enum BesignerPanelViewFlag {
+    PANEL_LEFT = 1,
+    PANEL_RIGHT = 2,
+    PANEL_BOTTOM = 3
+}
+export declare enum BesignerPanelTabFlag {
+    ELEMENTS_TREE = 1,
+    ELEMENT_BROWSE = 2,
+    /**
+     * Retired. The Info panel's two accordions — the component's own
+     * description, and the element/parent/component/plugin ids — moved to the
+     * bottom of Attributes, where they are reference detail beside the fields
+     * they describe rather than a tab of their own.
+     *
+     * The VALUE stays reserved. Panel state is persisted, so a reader whose
+     * last session ended on Info would otherwise come back to a tab id that now
+     * means something else.
+     */
+    ELEMENT_INFO = 3,
+    ELEMENT_PROPS_FORM = 4,
+    ELEMENT_STYLES = 5,
+    ELEMENT_INTERACTIONS = 6
+}
+export declare enum DndDragType {
+    CANVAS = "canvas",
+    TEMPLATE = "template",
+    TREE = "tree"
+}
+export declare enum DndDropType {
+    BEFORE = 1,
+    INSIDE = 2,
+    AFTER = 3
+}
+/**
+ * The interaction state the canvas is HOLDING ON for the element being
+ * styled (AGL-2486 item 39).
+ *
+ * You cannot hover an element while working in a side panel, so a state
+ * whose styles you cannot see is a state you cannot design. Selecting a
+ * state in the Styles panel's chip row holds it on the canvas for that one
+ * element; `undefined` is the resting state.
+ *
+ * Canvas UI context only — it is a flag, never a document field, so it
+ * cannot be saved, cannot reach Preview and cannot reach a published page.
+ * The union is declared HERE rather than in the designer so the flag store
+ * and the panel share one source of truth.
+ */
+export type BesignerStateFlag = 'hover' | 'active' | 'focusVisible' | 'disabled';
+export declare enum BesignerDeviceFlag {
+    SCALE = 1,
+    RESPONSIVE = 2,
+    XS = 3,
+    SM = 4,
+    MD = 5,
+    LG = 6,
+    XL = 7
+}

package/src/lib/constants/besigner.js

@@ -0,0 +1,69 @@
+/**
+ * @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 var InteractionModeFlag = /*#__PURE__*/ function(InteractionModeFlag) {
+    InteractionModeFlag[InteractionModeFlag["SELECT"] = 0x1] = "SELECT";
+    InteractionModeFlag[InteractionModeFlag["REARRANGE"] = 0x2] = "REARRANGE";
+    InteractionModeFlag[InteractionModeFlag["PREVIEW"] = 0x3] = "PREVIEW";
+    return InteractionModeFlag;
+}({});
+export var BesignerPanelViewFlag = /*#__PURE__*/ function(BesignerPanelViewFlag) {
+    BesignerPanelViewFlag[BesignerPanelViewFlag["PANEL_LEFT"] = 0x1] = "PANEL_LEFT";
+    BesignerPanelViewFlag[BesignerPanelViewFlag["PANEL_RIGHT"] = 0x2] = "PANEL_RIGHT";
+    BesignerPanelViewFlag[BesignerPanelViewFlag["PANEL_BOTTOM"] = 0x3] = "PANEL_BOTTOM";
+    return BesignerPanelViewFlag;
+}({});
+export var BesignerPanelTabFlag = /*#__PURE__*/ function(BesignerPanelTabFlag) {
+    BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENTS_TREE"] = 0x1] = "ELEMENTS_TREE";
+    BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENT_BROWSE"] = 0x2] = "ELEMENT_BROWSE";
+    /**
+   * Retired. The Info panel's two accordions — the component's own
+   * description, and the element/parent/component/plugin ids — moved to the
+   * bottom of Attributes, where they are reference detail beside the fields
+   * they describe rather than a tab of their own.
+   *
+   * The VALUE stays reserved. Panel state is persisted, so a reader whose
+   * last session ended on Info would otherwise come back to a tab id that now
+   * means something else.
+   */ BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENT_INFO"] = 0x3] = "ELEMENT_INFO";
+    BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENT_PROPS_FORM"] = 0x4] = "ELEMENT_PROPS_FORM";
+    BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENT_STYLES"] = 0x5] = "ELEMENT_STYLES";
+    BesignerPanelTabFlag[BesignerPanelTabFlag["ELEMENT_INTERACTIONS"] = 0x6] = "ELEMENT_INTERACTIONS";
+    return BesignerPanelTabFlag;
+}({});
+export var DndDragType = /*#__PURE__*/ function(DndDragType) {
+    DndDragType["CANVAS"] = "canvas";
+    DndDragType["TEMPLATE"] = "template";
+    DndDragType["TREE"] = "tree";
+    return DndDragType;
+}({});
+export var DndDropType = /*#__PURE__*/ function(DndDropType) {
+    DndDropType[DndDropType["BEFORE"] = 0x1] = "BEFORE";
+    DndDropType[DndDropType["INSIDE"] = 0x2] = "INSIDE";
+    DndDropType[DndDropType["AFTER"] = 0x3] = "AFTER";
+    return DndDropType;
+}({});
+export var BesignerDeviceFlag = /*#__PURE__*/ function(BesignerDeviceFlag) {
+    BesignerDeviceFlag[BesignerDeviceFlag["SCALE"] = 0x1] = "SCALE";
+    BesignerDeviceFlag[BesignerDeviceFlag["RESPONSIVE"] = 0x2] = "RESPONSIVE";
+    BesignerDeviceFlag[BesignerDeviceFlag["XS"] = 0x3] = "XS";
+    BesignerDeviceFlag[BesignerDeviceFlag["SM"] = 0x4] = "SM";
+    BesignerDeviceFlag[BesignerDeviceFlag["MD"] = 0x5] = "MD";
+    BesignerDeviceFlag[BesignerDeviceFlag["LG"] = 0x6] = "LG";
+    BesignerDeviceFlag[BesignerDeviceFlag["XL"] = 0x7] = "XL";
+    return BesignerDeviceFlag;
+}({});
+
+//# sourceMappingURL=besigner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/constants/besigner.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 enum InteractionModeFlag {\n  SELECT = 0x1,\n  REARRANGE = 0x2,\n  PREVIEW = 0x3,\n}\n\nexport enum BesignerPanelViewFlag {\n  PANEL_LEFT = 0x1,\n  PANEL_RIGHT = 0x2,\n  PANEL_BOTTOM = 0x3,\n}\n\nexport enum BesignerPanelTabFlag {\n  ELEMENTS_TREE = 0x1,\n  ELEMENT_BROWSE = 0x2,\n  /**\n   * Retired. The Info panel's two accordions — the component's own\n   * description, and the element/parent/component/plugin ids — moved to the\n   * bottom of Attributes, where they are reference detail beside the fields\n   * they describe rather than a tab of their own.\n   *\n   * The VALUE stays reserved. Panel state is persisted, so a reader whose\n   * last session ended on Info would otherwise come back to a tab id that now\n   * means something else.\n   */\n  ELEMENT_INFO = 0x3,\n  ELEMENT_PROPS_FORM = 0x4,\n  ELEMENT_STYLES = 0x5,\n  ELEMENT_INTERACTIONS = 0x6,\n}\n\nexport enum DndDragType {\n  CANVAS = 'canvas',\n  TEMPLATE = 'template',\n  TREE = 'tree',\n}\n\nexport enum DndDropType {\n  BEFORE = 0x1,\n  INSIDE = 0x2,\n  AFTER = 0x3,\n}\n\n/**\n * The interaction state the canvas is HOLDING ON for the element being\n * styled (AGL-2486 item 39).\n *\n * You cannot hover an element while working in a side panel, so a state\n * whose styles you cannot see is a state you cannot design. Selecting a\n * state in the Styles panel's chip row holds it on the canvas for that one\n * element; `undefined` is the resting state.\n *\n * Canvas UI context only — it is a flag, never a document field, so it\n * cannot be saved, cannot reach Preview and cannot reach a published page.\n * The union is declared HERE rather than in the designer so the flag store\n * and the panel share one source of truth.\n */\nexport type BesignerStateFlag =\n  | 'hover'\n  | 'active'\n  | 'focusVisible'\n  | 'disabled'\n\nexport enum BesignerDeviceFlag {\n  SCALE = 0x1,\n  RESPONSIVE = 0x2,\n  XS = 0x3,\n  SM = 0x4,\n  MD = 0x5,\n  LG = 0x6,\n  XL = 0x7,\n}\n"],"names":["InteractionModeFlag","BesignerPanelViewFlag","BesignerPanelTabFlag","DndDragType","DndDropType","BesignerDeviceFlag"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAO,IAAA,AAAKA,6CAAAA;wDACD;2DACG;yDACF;WAHAA;MAIX;AAED,OAAO,IAAA,AAAKC,+CAAAA;gEACG;iEACC;kEACC;WAHLA;MAIX;AAED,OAAO,IAAA,AAAKC,8CAAAA;iEACM;kEACC;IACjB;;;;;;;;;GASC,+DACc;sEACM;kEACJ;wEACM;WAhBbA;MAiBX;AAED,OAAO,IAAA,AAAKC,qCAAAA;;;;WAAAA;MAIX;AAED,OAAO,IAAA,AAAKC,qCAAAA;wCACD;wCACA;uCACD;WAHEA;MAIX;AAsBD,OAAO,IAAA,AAAKC,4CAAAA;qDACF;0DACK;kDACR;kDACA;kDACA;kDACA;kDACA;WAPKA;MAQX"}

package/src/lib/controllers/besigner-app.controller.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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 BesignerAppOptions, type IBesignerAppController } from '../definitions/besigner-app.types';
+import type { IBesignerInterfaceController } from '../definitions/besigner-interface.types';
+export declare class BesignerAppController implements IBesignerAppController {
+    readonly options: BesignerAppOptions;
+    readonly appName: string;
+    deleted: boolean;
+    interfaceController: IBesignerInterfaceController;
+    static get [Symbol.toStringTag](): string;
+    static get namespace(): string;
+    get interface(): IBesignerInterfaceController;
+    constructor(options: BesignerAppOptions);
+    getName(): string;
+    getBesignerController(): IBesignerInterfaceController;
+    onDestroy(): void;
+    setDeleted(value: boolean): void;
+}
+export default BesignerAppController;

package/src/lib/controllers/besigner-app.controller.js

@@ -0,0 +1,57 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { _INTERNAL_BESIGNERS_ } from "../constants/_internal.js";
+import { DEFAULT_APP_UUN } from "../definitions/besigner-app.types.js";
+import { BesignerInterfaceController } from "./besigner-interface.controller.js";
+const TAG = 'BesignerApp';
+const NS = 'com.aglyn.besigner.data.controller.app';
+export class BesignerAppController {
+    static get [Symbol.toStringTag]() {
+        return TAG;
+    }
+    static get namespace() {
+        return NS;
+    }
+    get interface() {
+        return this.interfaceController;
+    }
+    getName() {
+        return this.appName;
+    }
+    getBesignerController() {
+        return this.interfaceController;
+    }
+    onDestroy() {
+        _INTERNAL_BESIGNERS_.delete(this.appName);
+    }
+    setDeleted(value) {
+        this.deleted = value;
+    }
+    constructor(options){
+        var _options_modulesOptions;
+        this.options = options;
+        this.deleted = false;
+        this.interfaceController = null;
+        this.appName = (options == null ? void 0 : options.appName) || DEFAULT_APP_UUN;
+        _INTERNAL_BESIGNERS_.set(this.appName, this.interfaceController = new BesignerInterfaceController(this, _extends({
+            logLevel: options == null ? void 0 : options.logLevel
+        }, options == null ? void 0 : (_options_modulesOptions = options.modulesOptions) == null ? void 0 : _options_modulesOptions.interface)));
+    }
+}
+export default BesignerAppController;
+
+//# sourceMappingURL=besigner-app.controller.js.map

package/src/lib/controllers/besigner-app.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/controllers/besigner-app.controller.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 { _INTERNAL_BESIGNERS_ } from '../constants/_internal'\nimport {\n  type BesignerAppOptions,\n  DEFAULT_APP_UUN,\n  type IBesignerAppController,\n} from '../definitions/besigner-app.types'\nimport type { IBesignerInterfaceController } from '../definitions/besigner-interface.types'\nimport { BesignerInterfaceController } from './besigner-interface.controller'\n\nconst TAG = 'BesignerApp'\nconst NS = 'com.aglyn.besigner.data.controller.app'\n\nexport class BesignerAppController implements IBesignerAppController {\n  public readonly appName: string\n  public deleted = false\n  public interfaceController: IBesignerInterfaceController = null\n\n  public static get [Symbol.toStringTag](): string {\n    return TAG\n  }\n  public static get namespace(): string {\n    return NS\n  }\n\n  public get interface(): IBesignerInterfaceController {\n    return this.interfaceController\n  }\n\n  constructor(public readonly options: BesignerAppOptions) {\n    this.appName = options?.appName || DEFAULT_APP_UUN\n    _INTERNAL_BESIGNERS_.set(\n      this.appName,\n      (this.interfaceController = new BesignerInterfaceController(this, {\n        logLevel: options?.logLevel,\n        ...options?.modulesOptions?.interface,\n      })),\n    )\n  }\n\n  public getName(): string {\n    return this.appName\n  }\n  public getBesignerController(): IBesignerInterfaceController {\n    return this.interfaceController\n  }\n  public onDestroy(): void {\n    _INTERNAL_BESIGNERS_.delete(this.appName)\n  }\n  public setDeleted(value: boolean): void {\n    this.deleted = value\n  }\n}\nexport default BesignerAppController\n"],"names":["_INTERNAL_BESIGNERS_","DEFAULT_APP_UUN","BesignerInterfaceController","TAG","NS","BesignerAppController","Symbol","toStringTag","namespace","interface","interfaceController","getName","appName","getBesignerController","onDestroy","delete","setDeleted","value","deleted","options","set","logLevel","modulesOptions"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,oBAAoB,QAAQ,4BAAwB;AAC7D,SAEEC,eAAe,QAEV,uCAAmC;AAE1C,SAASC,2BAA2B,QAAQ,qCAAiC;AAE7E,MAAMC,MAAM;AACZ,MAAMC,KAAK;AAEX,OAAO,MAAMC;IAKX,WAAkB,CAACC,OAAOC,WAAW,CAAC,GAAW;QAC/C,OAAOJ;IACT;IACA,WAAkBK,YAAoB;QACpC,OAAOJ;IACT;IAEA,IAAWK,YAA0C;QACnD,OAAO,IAAI,CAACC,mBAAmB;IACjC;IAaOC,UAAkB;QACvB,OAAO,IAAI,CAACC,OAAO;IACrB;IACOC,wBAAsD;QAC3D,OAAO,IAAI,CAACH,mBAAmB;IACjC;IACOI,YAAkB;QACvBd,qBAAqBe,MAAM,CAAC,IAAI,CAACH,OAAO;IAC1C;IACOI,WAAWC,KAAc,EAAQ;QACtC,IAAI,CAACC,OAAO,GAAGD;IACjB;IAtBA,YAAY,AAAgBE,OAA2B,CAAE;YAMhDA;aANmBA,UAAAA;aAdrBD,UAAU;aACVR,sBAAoD;QAczD,IAAI,CAACE,OAAO,GAAGO,CAAAA,2BAAAA,QAASP,OAAO,KAAIX;QACnCD,qBAAqBoB,GAAG,CACtB,IAAI,CAACR,OAAO,EACX,IAAI,CAACF,mBAAmB,GAAG,IAAIR,4BAA4B,IAAI,EAAE;YAChEmB,QAAQ,EAAEF,2BAAAA,QAASE,QAAQ;WACxBF,4BAAAA,0BAAAA,QAASG,cAAc,qBAAvBH,wBAAyBV,SAAS;IAG3C;AAcF;AACA,eAAeJ,sBAAqB"}

package/src/lib/controllers/besigner-interface.controller.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @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.
+ */
+import { BehaviorSubject } from 'rxjs';
+import type { BesignerSetFlagPayload, BesignerSetFlagsPayload, BesignerSetPanelPayload, BesignerSetPanelsPayload } from '../definitions/emitter.types';
+import type { IBesignerAppController } from '../definitions/besigner-app.types';
+import type { BesignerContext, BesignerInterfaceControllerOptions, IBesignerInterfaceController } from '../definitions/besigner-interface.types';
+export declare class BesignerInterfaceController implements IBesignerInterfaceController {
+    protected readonly app: IBesignerAppController;
+    protected readonly options: BesignerInterfaceControllerOptions;
+    readonly __store__: {
+        [K in keyof BesignerContext]: BehaviorSubject<BesignerContext[K]>;
+    };
+    static get [Symbol.toStringTag](): string;
+    static get namespace(): string;
+    get flags(): this['__store__']['flags'];
+    get panels(): this['__store__']['panels'];
+    constructor(app: IBesignerAppController, options: BesignerInterfaceControllerOptions);
+    private setupInternal;
+    toJSON(): {
+        tag: string;
+        namespace: string;
+        appName: string;
+    };
+    private isDeepEqual;
+    setFlag(payload: BesignerSetFlagPayload): this;
+    setFlags(payload: BesignerSetFlagsPayload): this;
+    setPanel(payload: BesignerSetPanelPayload): this;
+    setPanels(payload: BesignerSetPanelsPayload): this;
+}
+export default BesignerInterfaceController;