@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/utils/muted-styles.js

@@ -0,0 +1,193 @@
+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 { expandSxAliases } from "@aglyn/shared-data-enums";
+import { readSxValue, writeSxValue } from "./responsive-sx.js";
+import { SX_STATE_SELECTORS } from "./state-sx.js";
+const SCOPE_BASE = 'base';
+/**
+ * The flag entry for a target. Encoded rather than stored as an object
+ * because the flag is a plain value compared by identity: a string list is
+ * cheap to test membership in and cheap to rewrite immutably.
+ */ export function mutedStyleKey(target) {
+    var _target_state, _target_breakpoint;
+    return [
+        target.nodeId,
+        (_target_state = target.state) != null ? _target_state : SCOPE_BASE,
+        (_target_breakpoint = target.breakpoint) != null ? _target_breakpoint : SCOPE_BASE,
+        target.property
+    ].join('|');
+}
+/** The target a flag entry stands for, or null when it is not one of ours. */ export function parseMutedStyleKey(key) {
+    const parts = key.split('|');
+    if (parts.length !== 4) return null;
+    const [nodeId, state, breakpoint, property] = parts;
+    if (!nodeId || !property) return null;
+    return {
+        nodeId,
+        property,
+        state: state === SCOPE_BASE ? null : state,
+        breakpoint: breakpoint === SCOPE_BASE ? null : breakpoint
+    };
+}
+/** Whether this declaration is muted in this scope. */ export function isStyleMuted(mutedStyles, target) {
+    const key = mutedStyleKey(target);
+    return !!(mutedStyles == null ? void 0 : mutedStyles.some((entry)=>entry === key));
+}
+/**
+ * The mute list with one declaration flipped. Returns a new array so the
+ * flag's subscribers see a changed value, and never mutates the input.
+ */ export function toggleMutedStyle(mutedStyles, target) {
+    const key = mutedStyleKey(target);
+    const current = mutedStyles != null ? mutedStyles : [];
+    return current.some((entry)=>entry === key) ? current.filter((entry)=>entry !== key) : [
+        ...current,
+        key
+    ];
+}
+/** Every mute recorded against one element. */ export function mutedStylesForNode(mutedStyles, nodeId) {
+    if (!nodeId || !(mutedStyles == null ? void 0 : mutedStyles.length)) return [];
+    const targets = [];
+    for (const entry of mutedStyles){
+        const target = parseMutedStyleKey(entry);
+        if (target && target.nodeId === nodeId) targets.push(target);
+    }
+    return targets;
+}
+const isPlainObject = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * The record with one declaration removed.
+ *
+ * Aliases are expanded for the muted key first, for the reason
+ * `applyStylePartialToSx` expands them: a preset writes `bgcolor` and the
+ * panel calls the field `backgroundColor`, so muting the field has to reach
+ * the declaration that is actually painting.
+ *
+ * Which breakpoint slice goes follows what the author is looking at. A
+ * property carrying an own slice at the active breakpoint loses THAT slice,
+ * so the mobile-first cascade fills in from below — the devtools behaviour of
+ * unchecking a declaration inside one media block. A property with no own
+ * slice there is applying at that width through the cascade, and the whole
+ * declaration goes; the alternative is a control that reads as available and
+ * does nothing when clicked.
+ */ function muteDeclaration(record, property, breakpoint) {
+    const expanded = expandSxAliases(record, {
+        only: [
+            property
+        ],
+        deep: true
+    });
+    if (readSxValue(expanded, property, breakpoint != null ? breakpoint : null) === undefined) {
+        return record;
+    }
+    const value = expanded[property];
+    const ownSlice = isPlainObject(value) && Object.prototype.hasOwnProperty.call(value, breakpoint != null ? breakpoint : 'xs');
+    if (ownSlice) {
+        return writeSxValue(expanded, property, undefined, breakpoint != null ? breakpoint : null);
+    }
+    const next = _extends({}, expanded);
+    delete next[property];
+    return next;
+}
+/** One target applied to one plain sx record. */ function muteOne(sx, target) {
+    if (!target.state) {
+        return muteDeclaration(sx, target.property, target.breakpoint);
+    }
+    const selector = SX_STATE_SELECTORS[target.state];
+    const slice = sx[selector];
+    if (!isPlainObject(slice)) return sx;
+    const nextSlice = muteDeclaration(slice, target.property, target.breakpoint);
+    if (nextSlice === slice) return sx;
+    const next = _extends({}, sx);
+    if (Object.keys(nextSlice).length) next[selector] = nextSlice;
+    else delete next[selector];
+    return next;
+}
+/**
+ * CANVAS ONLY: the element's sx with its muted declarations removed.
+ *
+ * Runs on the fully merged sx at the one point in `Leaf` where it reaches the
+ * element, and BEFORE the interaction-state hoist: a muted base declaration
+ * has to be gone before a hover slice is folded over it, and a muted hover
+ * declaration has to leave its slice so the base shows through.
+ *
+ * Handles the array form of sx for the same reason `hoistStateSx` does — a
+ * component may compose its own sx with the author's. Returns the input BY
+ * IDENTITY when nothing is muted, which is every element in every session
+ * where nobody has opened the comparison.
+ */ export function applyMutedStyles(sx, nodeId, mutedStyles) {
+    const targets = mutedStylesForNode(mutedStyles, nodeId);
+    if (!targets.length) return sx;
+    return muteTargets(sx, targets);
+}
+function muteTargets(sx, targets) {
+    if (Array.isArray(sx)) {
+        let changed = false;
+        const next = sx.map((entry)=>{
+            const value = muteTargets(entry, targets);
+            if (value !== entry) changed = true;
+            return value;
+        });
+        return changed ? next : sx;
+    }
+    if (!isPlainObject(sx)) return sx;
+    let out = sx;
+    for (const target of targets)out = muteOne(out, target);
+    return out === sx ? sx : out;
+}
+/** The mute control for one field, or nothing when there is none to offer. */ export function buildStyleMute(name, label, scope) {
+    var _scope_state, _scope_breakpoint;
+    if (!scope.nodeId || !name) return undefined;
+    const target = {
+        nodeId: scope.nodeId,
+        property: name,
+        state: (_scope_state = scope.state) != null ? _scope_state : null,
+        breakpoint: (_scope_breakpoint = scope.breakpoint) != null ? _scope_breakpoint : null
+    };
+    const muted = isStyleMuted(scope.mutedStyles, target);
+    // A row with nothing declared in this scope has nothing to switch off. A
+    // muted row keeps its control however it reads, or there would be no way
+    // back to the value it is still holding.
+    if (!muted && scope.scopeValues[name] === undefined) return undefined;
+    const named = typeof label === 'string' && label ? label : 'this style';
+    return {
+        label: muted ? `Apply ${named} again` : `Stop applying ${named} while designing`,
+        muted,
+        onToggle: ()=>scope.onToggle(target)
+    };
+}
+/**
+ * A group's field declarations carrying their per-row mute control.
+ *
+ * Supplied through `FormFieldGridProps`, which every editor in the shared
+ * mapper spreads onto its wrapper, so the affordance arrives on every field
+ * without each editor knowing anything about it. Fields with nothing to mute
+ * come back BY IDENTITY, so a panel where nothing is set re-renders exactly
+ * as it did before.
+ */ export function withStyleMuteControls(fields, scope) {
+    return fields.map((field)=>{
+        var _ref, _field_FormFieldGridProps;
+        const mute = buildStyleMute((_ref = field == null ? void 0 : field.name) != null ? _ref : '', field == null ? void 0 : field.label, scope);
+        if (!mute) return field;
+        return _extends({}, field, {
+            FormFieldGridProps: _extends({}, (_field_FormFieldGridProps = field.FormFieldGridProps) != null ? _field_FormFieldGridProps : {}, {
+                mute
+            })
+        });
+    });
+}
+
+//# sourceMappingURL=muted-styles.js.map

package/src/lib/utils/muted-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/muted-styles.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 { expandSxAliases } from '@aglyn/shared-data-enums'\nimport type { FieldMuteAction } from '@aglyn/shared-ui-jsx-forms'\n\nimport { readSxValue, type SxBreakpoint, writeSxValue } from './responsive-sx'\nimport { SX_STATE_SELECTORS, type SxState } from './state-sx'\n\n/**\n * Muting one style declaration while designing (AGL-2486).\n *\n * ## What this is\n *\n * Every field in the Styles panel could set a value and take one off, and\n * nothing in between. Seeing a layout without its `maxWidth` meant deleting\n * the value and typing it back afterwards — which loses the very thing being\n * compared against. This is the browser-devtools checkbox: the declaration\n * stops applying, its value stays where it is, and one click puts it back.\n *\n * ## Canvas only, and the value is never moved\n *\n * A mute is held in the `mutedStyles` canvas flag, alongside `heldState`. The\n * document is not touched at all — the declaration stays in `node.sx` exactly\n * where the author left it, and the canvas renders a COPY with it removed,\n * through the same `LeafSxTransformContext` seam the artboard device pin and\n * the interaction-state hold already use.\n *\n * That is what makes the two requirements of a comparison tool hold at once.\n * The value is not parked somewhere and restored later, so turning a mute back\n * off cannot fail or lose anything; and nothing disabled can reach a published\n * page, because there is nothing in the document to reach it — no reserved sx\n * key for a renderer to recognise, no substitution pass on the tenant's render\n * path, and nothing for a publish to serialize. The cost is that a mute is a\n * session's worth of comparison rather than a saved state: reload, and every\n * declaration is applying again.\n *\n * ## Scope\n *\n * A mute belongs to the scope the panel was in when it was made — the\n * interaction state and the breakpoint the chips name. Muting `color` in the\n * hover slice leaves the default one applying, and a mute made while styling\n * SM is not in force at \"all screen sizes\".\n */\n\n/** One muted declaration, in the scope it was muted in. */\nexport interface MutedStyleTarget {\n  nodeId: string\n  /** sx property key, in the panel's spelling (`backgroundColor`, not `bgcolor`). */\n  property: string\n  /** Interaction-state slice, or null for the element's default styles. */\n  state?: SxState | null\n  /** Breakpoint scope, or null for \"all screen sizes\". */\n  breakpoint?: SxBreakpoint | null\n}\n\nconst SCOPE_BASE = 'base'\n\n/**\n * The flag entry for a target. Encoded rather than stored as an object\n * because the flag is a plain value compared by identity: a string list is\n * cheap to test membership in and cheap to rewrite immutably.\n */\nexport function mutedStyleKey(target: MutedStyleTarget): string {\n  return [\n    target.nodeId,\n    target.state ?? SCOPE_BASE,\n    target.breakpoint ?? SCOPE_BASE,\n    target.property,\n  ].join('|')\n}\n\n/** The target a flag entry stands for, or null when it is not one of ours. */\nexport function parseMutedStyleKey(key: string): MutedStyleTarget | null {\n  const parts = key.split('|')\n  if (parts.length !== 4) return null\n  const [nodeId, state, breakpoint, property] = parts\n  if (!nodeId || !property) return null\n  return {\n    nodeId,\n    property,\n    state: state === SCOPE_BASE ? null : (state as SxState),\n    breakpoint: breakpoint === SCOPE_BASE ? null : (breakpoint as SxBreakpoint),\n  }\n}\n\n/** Whether this declaration is muted in this scope. */\nexport function isStyleMuted(\n  mutedStyles: readonly string[] | undefined,\n  target: MutedStyleTarget,\n): boolean {\n  const key = mutedStyleKey(target)\n  return !!mutedStyles?.some((entry) => entry === key)\n}\n\n/**\n * The mute list with one declaration flipped. Returns a new array so the\n * flag's subscribers see a changed value, and never mutates the input.\n */\nexport function toggleMutedStyle(\n  mutedStyles: readonly string[] | undefined,\n  target: MutedStyleTarget,\n): string[] {\n  const key = mutedStyleKey(target)\n  const current = mutedStyles ?? []\n  return current.some((entry) => entry === key)\n    ? current.filter((entry) => entry !== key)\n    : [...current, key]\n}\n\n/** Every mute recorded against one element. */\nexport function mutedStylesForNode(\n  mutedStyles: readonly string[] | undefined,\n  nodeId: string | undefined,\n): MutedStyleTarget[] {\n  if (!nodeId || !mutedStyles?.length) return []\n  const targets: MutedStyleTarget[] = []\n  for (const entry of mutedStyles) {\n    const target = parseMutedStyleKey(entry)\n    if (target && target.nodeId === nodeId) targets.push(target)\n  }\n  return targets\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, any> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * The record with one declaration removed.\n *\n * Aliases are expanded for the muted key first, for the reason\n * `applyStylePartialToSx` expands them: a preset writes `bgcolor` and the\n * panel calls the field `backgroundColor`, so muting the field has to reach\n * the declaration that is actually painting.\n *\n * Which breakpoint slice goes follows what the author is looking at. A\n * property carrying an own slice at the active breakpoint loses THAT slice,\n * so the mobile-first cascade fills in from below — the devtools behaviour of\n * unchecking a declaration inside one media block. A property with no own\n * slice there is applying at that width through the cascade, and the whole\n * declaration goes; the alternative is a control that reads as available and\n * does nothing when clicked.\n */\nfunction muteDeclaration(\n  record: Record<string, any>,\n  property: string,\n  breakpoint: SxBreakpoint | null | undefined,\n): Record<string, any> {\n  const expanded = expandSxAliases(record, { only: [property], deep: true })\n  if (readSxValue(expanded, property, breakpoint ?? null) === undefined) {\n    return record\n  }\n  const value = expanded[property]\n  const ownSlice =\n    isPlainObject(value) &&\n    Object.prototype.hasOwnProperty.call(value, breakpoint ?? 'xs')\n  if (ownSlice) {\n    return writeSxValue(expanded, property, undefined, breakpoint ?? null)\n  }\n  const next = { ...expanded }\n  delete next[property]\n  return next\n}\n\n/** One target applied to one plain sx record. */\nfunction muteOne(\n  sx: Record<string, any>,\n  target: MutedStyleTarget,\n): Record<string, any> {\n  if (!target.state) {\n    return muteDeclaration(sx, target.property, target.breakpoint)\n  }\n  const selector = SX_STATE_SELECTORS[target.state]\n  const slice = sx[selector]\n  if (!isPlainObject(slice)) return sx\n  const nextSlice = muteDeclaration(slice, target.property, target.breakpoint)\n  if (nextSlice === slice) return sx\n  const next = { ...sx }\n  if (Object.keys(nextSlice).length) next[selector] = nextSlice\n  else delete next[selector]\n  return next\n}\n\n/**\n * CANVAS ONLY: the element's sx with its muted declarations removed.\n *\n * Runs on the fully merged sx at the one point in `Leaf` where it reaches the\n * element, and BEFORE the interaction-state hoist: a muted base declaration\n * has to be gone before a hover slice is folded over it, and a muted hover\n * declaration has to leave its slice so the base shows through.\n *\n * Handles the array form of sx for the same reason `hoistStateSx` does — a\n * component may compose its own sx with the author's. Returns the input BY\n * IDENTITY when nothing is muted, which is every element in every session\n * where nobody has opened the comparison.\n */\nexport function applyMutedStyles<T>(\n  sx: T,\n  nodeId: string | undefined,\n  mutedStyles: readonly string[] | undefined,\n): T {\n  const targets = mutedStylesForNode(mutedStyles, nodeId)\n  if (!targets.length) return sx\n  return muteTargets(sx, targets)\n}\n\nfunction muteTargets<T>(sx: T, targets: MutedStyleTarget[]): T {\n  if (Array.isArray(sx)) {\n    let changed = false\n    const next = sx.map((entry) => {\n      const value = muteTargets(entry, targets)\n      if (value !== entry) changed = true\n      return value\n    })\n    return (changed ? next : sx) as unknown as T\n  }\n  if (!isPlainObject(sx)) return sx\n  let out = sx as Record<string, any>\n  for (const target of targets) out = muteOne(out, target)\n  return (out === sx ? sx : out) as unknown as T\n}\n\n/** What the panel needs to know to offer a row's mute control. */\nexport interface StyleMuteScope {\n  nodeId?: string\n  state?: SxState | null\n  breakpoint?: SxBreakpoint | null\n  /**\n   * What the ACTIVE SCOPE declares, keyed by field name — not what the panel\n   * displays. The two differ in a state scope, where a field the author has\n   * not overridden for hover still shows the base value it inherits: there is\n   * no hover declaration to switch off, so that row gets no control.\n   */\n  scopeValues: Record<string, unknown>\n  mutedStyles?: readonly string[]\n  onToggle: (target: MutedStyleTarget) => void\n}\n\n/** The mute control for one field, or nothing when there is none to offer. */\nexport function buildStyleMute(\n  name: string,\n  label: unknown,\n  scope: StyleMuteScope,\n): FieldMuteAction | undefined {\n  if (!scope.nodeId || !name) return undefined\n  const target: MutedStyleTarget = {\n    nodeId: scope.nodeId,\n    property: name,\n    state: scope.state ?? null,\n    breakpoint: scope.breakpoint ?? null,\n  }\n  const muted = isStyleMuted(scope.mutedStyles, target)\n  // A row with nothing declared in this scope has nothing to switch off. A\n  // muted row keeps its control however it reads, or there would be no way\n  // back to the value it is still holding.\n  if (!muted && scope.scopeValues[name] === undefined) return undefined\n  const named = typeof label === 'string' && label ? label : 'this style'\n  return {\n    label: muted\n      ? `Apply ${named} again`\n      : `Stop applying ${named} while designing`,\n    muted,\n    onToggle: () => scope.onToggle(target),\n  }\n}\n\n/**\n * A group's field declarations carrying their per-row mute control.\n *\n * Supplied through `FormFieldGridProps`, which every editor in the shared\n * mapper spreads onto its wrapper, so the affordance arrives on every field\n * without each editor knowing anything about it. Fields with nothing to mute\n * come back BY IDENTITY, so a panel where nothing is set re-renders exactly\n * as it did before.\n */\nexport function withStyleMuteControls<\n  T extends { name?: string; label?: unknown },\n>(fields: readonly T[], scope: StyleMuteScope): T[] {\n  return fields.map((field) => {\n    const mute = buildStyleMute(field?.name ?? '', field?.label, scope)\n    if (!mute) return field\n    return {\n      ...field,\n      FormFieldGridProps: {\n        ...((field as { FormFieldGridProps?: object }).FormFieldGridProps ??\n          {}),\n        mute,\n      },\n    }\n  })\n}\n"],"names":["expandSxAliases","readSxValue","writeSxValue","SX_STATE_SELECTORS","SCOPE_BASE","mutedStyleKey","target","nodeId","state","breakpoint","property","join","parseMutedStyleKey","key","parts","split","length","isStyleMuted","mutedStyles","some","entry","toggleMutedStyle","current","filter","mutedStylesForNode","targets","push","isPlainObject","value","Array","isArray","muteDeclaration","record","expanded","only","deep","undefined","ownSlice","Object","prototype","hasOwnProperty","call","next","muteOne","sx","selector","slice","nextSlice","keys","applyMutedStyles","muteTargets","changed","map","out","buildStyleMute","name","label","scope","muted","scopeValues","named","onToggle","withStyleMuteControls","fields","field","mute","FormFieldGridProps"],"mappings":"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"}

package/src/lib/utils/numeric-text-value.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @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.
+ */
+/**
+ * Text that is ENTIRELY a number — the only shape a text control stores as
+ * a number.
+ *
+ * Deliberately narrower than `Number()` would accept: no exponent form, no
+ * `Infinity`, no hex. Those parse to a number and are not values any of the
+ * designer's controls offer, so converting them would only make the stored
+ * value harder to read back than the text the author actually typed.
+ */
+export declare const NUMERIC_TEXT_VALUE: RegExp;
+/**
+ * The NUMBER a control's text stands for, or the value unchanged.
+ *
+ * Every free-text control in the designer can only hand back a string, and
+ * for the values whose type carries meaning that changes what the value
+ * DOES: MUI multiplies a number by a theme unit and passes a string through
+ * verbatim, so `fontSize: 24` renders 24px while `fontSize: '24'` is not
+ * CSS at all and the declaration is dropped. Both panels that write those
+ * values normalize through here so the rule reads the same in each.
+ *
+ * Whitespace around an otherwise numeric value is incidental to typing and
+ * is dropped with it; text carrying any non-numeric character (`8px`,
+ * `50%`, `span 2`, a `{{var:id}}` binding) is what the author wrote and
+ * comes back untouched, whitespace and all.
+ */
+export declare function numericTextValue(value: unknown): unknown;

package/src/lib/utils/numeric-text-value.js

@@ -0,0 +1,47 @@
+/**
+ * @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.
+ */ /**
+ * Text that is ENTIRELY a number — the only shape a text control stores as
+ * a number.
+ *
+ * Deliberately narrower than `Number()` would accept: no exponent form, no
+ * `Infinity`, no hex. Those parse to a number and are not values any of the
+ * designer's controls offer, so converting them would only make the stored
+ * value harder to read back than the text the author actually typed.
+ */ export const NUMERIC_TEXT_VALUE = /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/;
+/**
+ * The NUMBER a control's text stands for, or the value unchanged.
+ *
+ * Every free-text control in the designer can only hand back a string, and
+ * for the values whose type carries meaning that changes what the value
+ * DOES: MUI multiplies a number by a theme unit and passes a string through
+ * verbatim, so `fontSize: 24` renders 24px while `fontSize: '24'` is not
+ * CSS at all and the declaration is dropped. Both panels that write those
+ * values normalize through here so the rule reads the same in each.
+ *
+ * Whitespace around an otherwise numeric value is incidental to typing and
+ * is dropped with it; text carrying any non-numeric character (`8px`,
+ * `50%`, `span 2`, a `{{var:id}}` binding) is what the author wrote and
+ * comes back untouched, whitespace and all.
+ */ export function numericTextValue(value) {
+    if (typeof value !== 'string') return value;
+    const text = value.trim();
+    if (!NUMERIC_TEXT_VALUE.test(text)) return value;
+    const numeric = Number(text);
+    return Number.isFinite(numeric) ? numeric : value;
+}
+
+//# sourceMappingURL=numeric-text-value.js.map

package/src/lib/utils/numeric-text-value.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/numeric-text-value.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\n/**\n * Text that is ENTIRELY a number — the only shape a text control stores as\n * a number.\n *\n * Deliberately narrower than `Number()` would accept: no exponent form, no\n * `Infinity`, no hex. Those parse to a number and are not values any of the\n * designer's controls offer, so converting them would only make the stored\n * value harder to read back than the text the author actually typed.\n */\nexport const NUMERIC_TEXT_VALUE = /^[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)$/\n\n/**\n * The NUMBER a control's text stands for, or the value unchanged.\n *\n * Every free-text control in the designer can only hand back a string, and\n * for the values whose type carries meaning that changes what the value\n * DOES: MUI multiplies a number by a theme unit and passes a string through\n * verbatim, so `fontSize: 24` renders 24px while `fontSize: '24'` is not\n * CSS at all and the declaration is dropped. Both panels that write those\n * values normalize through here so the rule reads the same in each.\n *\n * Whitespace around an otherwise numeric value is incidental to typing and\n * is dropped with it; text carrying any non-numeric character (`8px`,\n * `50%`, `span 2`, a `{{var:id}}` binding) is what the author wrote and\n * comes back untouched, whitespace and all.\n */\nexport function numericTextValue(value: unknown): unknown {\n  if (typeof value !== 'string') return value\n  const text = value.trim()\n  if (!NUMERIC_TEXT_VALUE.test(text)) return value\n  const numeric = Number(text)\n  return Number.isFinite(numeric) ? numeric : value\n}\n"],"names":["NUMERIC_TEXT_VALUE","numericTextValue","value","text","trim","test","numeric","Number","isFinite"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;CAQC,GACD,OAAO,MAAMA,qBAAqB,iCAAgC;AAElE;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,iBAAiBC,KAAc;IAC7C,IAAI,OAAOA,UAAU,UAAU,OAAOA;IACtC,MAAMC,OAAOD,MAAME,IAAI;IACvB,IAAI,CAACJ,mBAAmBK,IAAI,CAACF,OAAO,OAAOD;IAC3C,MAAMI,UAAUC,OAAOJ;IACvB,OAAOI,OAAOC,QAAQ,CAACF,WAAWA,UAAUJ;AAC9C"}

package/src/lib/utils/preset-interactions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { NodeSchema, NodeSchemaNested, PresetSchema } from '@aglyn/aglyn';
+import { type PresetInteractionDraft } from '../contexts/interactions-context';
+/**
+ * Resolves a preset's `presetRef` markers to the node ids minted at
+ * insert time (AGL-589). `createDuplicateNode` clones the preset's
+ * `data` tree preserving field values and child order, so the authored
+ * tree and the inserted subtree walk in lockstep — pairing them
+ * positionally maps each marker to its live id without the preset ever
+ * knowing ids exist.
+ */
+export declare function collectPresetRefIds(data: NodeSchemaNested<any> | undefined, live: NodeSchema<any> | undefined | null): Record<string, string>;
+/**
+ * Materializes a preset's interaction templates into ready-to-persist
+ * drafts: refs become `[data-aglyn="leaf:<id>"]` selectors. Templates
+ * (or steps) whose refs don't resolve are dropped rather than written
+ * broken — an unresolved ref means the preset author renamed a marker
+ * without updating the template, and a selector-less action would fail
+ * validation anyway.
+ */
+export declare function buildPresetInteractionDrafts(preset: PresetSchema<any>, live: NodeSchema<any> | undefined | null): PresetInteractionDraft[];
+export default buildPresetInteractionDrafts;

package/src/lib/utils/preset-interactions.js

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { nodeElementSelector } from "../contexts/interactions-context.js";
+/**
+ * Resolves a preset's `presetRef` markers to the node ids minted at
+ * insert time (AGL-589). `createDuplicateNode` clones the preset's
+ * `data` tree preserving field values and child order, so the authored
+ * tree and the inserted subtree walk in lockstep — pairing them
+ * positionally maps each marker to its live id without the preset ever
+ * knowing ids exist.
+ */ export function collectPresetRefIds(data, live) {
+    const refs = {};
+    const walk = (dataNode, liveNode)=>{
+        var _dataNode_nodes, _liveNode_children;
+        if (!dataNode || !liveNode) return;
+        if (dataNode.presetRef && liveNode.$id != null) {
+            refs[dataNode.presetRef] = String(liveNode.$id);
+        }
+        const dataChildren = (_dataNode_nodes = dataNode.nodes) != null ? _dataNode_nodes : [];
+        const liveChildren = (_liveNode_children = liveNode.children) != null ? _liveNode_children : [];
+        for(let index = 0; index < dataChildren.length; index += 1){
+            walk(dataChildren[index], liveChildren[index]);
+        }
+    };
+    walk(data, live != null ? live : undefined);
+    return refs;
+}
+/**
+ * Materializes a preset's interaction templates into ready-to-persist
+ * drafts: refs become `[data-aglyn="leaf:<id>"]` selectors. Templates
+ * (or steps) whose refs don't resolve are dropped rather than written
+ * broken — an unresolved ref means the preset author renamed a marker
+ * without updating the template, and a selector-less action would fail
+ * validation anyway.
+ */ export function buildPresetInteractionDrafts(preset, live) {
+    var _ref;
+    const interactions = (_ref = preset == null ? void 0 : preset.interactionTemplates) != null ? _ref : [];
+    if (!interactions.length || !live) return [];
+    const refs = collectPresetRefIds(preset.data, live);
+    const drafts = [];
+    for (const interaction of interactions){
+        var _interaction_steps;
+        const triggerId = refs[interaction.triggerRef];
+        if (!triggerId) continue;
+        const steps = [];
+        for (const step of (_interaction_steps = interaction.steps) != null ? _interaction_steps : []){
+            var _step_dismissOn;
+            const targetId = refs[step.targetRef];
+            if (!targetId) continue;
+            steps.push(_extends({
+                type: step.type,
+                selector: nodeElementSelector(targetId)
+            }, typeof step.delayMs === 'number' ? {
+                delayMs: step.delayMs
+            } : {}, ((_step_dismissOn = step.dismissOn) == null ? void 0 : _step_dismissOn.length) ? {
+                dismissOn: [
+                    ...step.dismissOn
+                ]
+            } : {}));
+        }
+        if (!steps.length) continue;
+        drafts.push({
+            name: interaction.name,
+            event: interaction.event,
+            selector: nodeElementSelector(triggerId),
+            steps
+        });
+    }
+    return drafts;
+}
+export default buildPresetInteractionDrafts;
+
+//# sourceMappingURL=preset-interactions.js.map

package/src/lib/utils/preset-interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/preset-interactions.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 { NodeSchema, NodeSchemaNested, PresetSchema } from '@aglyn/aglyn'\nimport {\n  nodeElementSelector,\n  type PresetInteractionDraft,\n  type PresetInteractionDraftStep,\n} from '../contexts/interactions-context'\n\n/**\n * Resolves a preset's `presetRef` markers to the node ids minted at\n * insert time (AGL-589). `createDuplicateNode` clones the preset's\n * `data` tree preserving field values and child order, so the authored\n * tree and the inserted subtree walk in lockstep — pairing them\n * positionally maps each marker to its live id without the preset ever\n * knowing ids exist.\n */\nexport function collectPresetRefIds(\n  data: NodeSchemaNested<any> | undefined,\n  live: NodeSchema<any> | undefined | null,\n): Record<string, string> {\n  const refs: Record<string, string> = {}\n  const walk = (\n    dataNode: NodeSchemaNested<any> | undefined,\n    liveNode: NodeSchema<any> | undefined,\n  ): void => {\n    if (!dataNode || !liveNode) return\n    if (dataNode.presetRef && liveNode.$id != null) {\n      refs[dataNode.presetRef] = String(liveNode.$id)\n    }\n    const dataChildren = dataNode.nodes ?? []\n    const liveChildren = liveNode.children ?? []\n    for (let index = 0; index < dataChildren.length; index += 1) {\n      walk(dataChildren[index], liveChildren[index])\n    }\n  }\n  walk(data, live ?? undefined)\n  return refs\n}\n\n/**\n * Materializes a preset's interaction templates into ready-to-persist\n * drafts: refs become `[data-aglyn=\"leaf:<id>\"]` selectors. Templates\n * (or steps) whose refs don't resolve are dropped rather than written\n * broken — an unresolved ref means the preset author renamed a marker\n * without updating the template, and a selector-less action would fail\n * validation anyway.\n */\nexport function buildPresetInteractionDrafts(\n  preset: PresetSchema<any>,\n  live: NodeSchema<any> | undefined | null,\n): PresetInteractionDraft[] {\n  const interactions = preset?.interactionTemplates ?? []\n  if (!interactions.length || !live) return []\n  const refs = collectPresetRefIds(preset.data, live)\n  const drafts: PresetInteractionDraft[] = []\n  for (const interaction of interactions) {\n    const triggerId = refs[interaction.triggerRef]\n    if (!triggerId) continue\n    const steps: PresetInteractionDraftStep[] = []\n    for (const step of interaction.steps ?? []) {\n      const targetId = refs[step.targetRef]\n      if (!targetId) continue\n      steps.push({\n        type: step.type,\n        selector: nodeElementSelector(targetId),\n        ...(typeof step.delayMs === 'number' ? { delayMs: step.delayMs } : {}),\n        ...(step.dismissOn?.length ? { dismissOn: [...step.dismissOn] } : {}),\n      })\n    }\n    if (!steps.length) continue\n    drafts.push({\n      name: interaction.name,\n      event: interaction.event,\n      selector: nodeElementSelector(triggerId),\n      steps,\n    })\n  }\n  return drafts\n}\n\nexport default buildPresetInteractionDrafts\n"],"names":["nodeElementSelector","collectPresetRefIds","data","live","refs","walk","dataNode","liveNode","presetRef","$id","String","dataChildren","nodes","liveChildren","children","index","length","undefined","buildPresetInteractionDrafts","preset","interactions","interactionTemplates","drafts","interaction","triggerId","triggerRef","steps","step","targetId","targetRef","push","type","selector","delayMs","dismissOn","name","event"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,mBAAmB,QAGd,sCAAkC;AAEzC;;;;;;;CAOC,GACD,OAAO,SAASC,oBACdC,IAAuC,EACvCC,IAAwC;IAExC,MAAMC,OAA+B,CAAC;IACtC,MAAMC,OAAO,CACXC,UACAC;YAMqBD,iBACAC;QALrB,IAAI,CAACD,YAAY,CAACC,UAAU;QAC5B,IAAID,SAASE,SAAS,IAAID,SAASE,GAAG,IAAI,MAAM;YAC9CL,IAAI,CAACE,SAASE,SAAS,CAAC,GAAGE,OAAOH,SAASE,GAAG;QAChD;QACA,MAAME,gBAAeL,kBAAAA,SAASM,KAAK,YAAdN,kBAAkB,EAAE;QACzC,MAAMO,gBAAeN,qBAAAA,SAASO,QAAQ,YAAjBP,qBAAqB,EAAE;QAC5C,IAAK,IAAIQ,QAAQ,GAAGA,QAAQJ,aAAaK,MAAM,EAAED,SAAS,EAAG;YAC3DV,KAAKM,YAAY,CAACI,MAAM,EAAEF,YAAY,CAACE,MAAM;QAC/C;IACF;IACAV,KAAKH,MAAMC,eAAAA,OAAQc;IACnB,OAAOb;AACT;AAEA;;;;;;;CAOC,GACD,OAAO,SAASc,6BACdC,MAAyB,EACzBhB,IAAwC;;IAExC,MAAMiB,uBAAeD,0BAAAA,OAAQE,oBAAoB,mBAAI,EAAE;IACvD,IAAI,CAACD,aAAaJ,MAAM,IAAI,CAACb,MAAM,OAAO,EAAE;IAC5C,MAAMC,OAAOH,oBAAoBkB,OAAOjB,IAAI,EAAEC;IAC9C,MAAMmB,SAAmC,EAAE;IAC3C,KAAK,MAAMC,eAAeH,aAAc;YAInBG;QAHnB,MAAMC,YAAYpB,IAAI,CAACmB,YAAYE,UAAU,CAAC;QAC9C,IAAI,CAACD,WAAW;QAChB,MAAME,QAAsC,EAAE;QAC9C,KAAK,MAAMC,SAAQJ,qBAAAA,YAAYG,KAAK,YAAjBH,qBAAqB,EAAE,CAAE;gBAOpCI;YANN,MAAMC,WAAWxB,IAAI,CAACuB,KAAKE,SAAS,CAAC;YACrC,IAAI,CAACD,UAAU;YACfF,MAAMI,IAAI,CAAC;gBACTC,MAAMJ,KAAKI,IAAI;gBACfC,UAAUhC,oBAAoB4B;eAC1B,OAAOD,KAAKM,OAAO,KAAK,WAAW;gBAAEA,SAASN,KAAKM,OAAO;YAAC,IAAI,CAAC,GAChEN,EAAAA,kBAAAA,KAAKO,SAAS,qBAAdP,gBAAgBX,MAAM,IAAG;gBAAEkB,WAAW;uBAAIP,KAAKO,SAAS;iBAAC;YAAC,IAAI,CAAC;QAEvE;QACA,IAAI,CAACR,MAAMV,MAAM,EAAE;QACnBM,OAAOQ,IAAI,CAAC;YACVK,MAAMZ,YAAYY,IAAI;YACtBC,OAAOb,YAAYa,KAAK;YACxBJ,UAAUhC,oBAAoBwB;YAC9BE;QACF;IACF;IACA,OAAOJ;AACT;AAEA,eAAeJ,6BAA4B"}

package/src/lib/utils/publish-failure-message.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * What to tell an author whose publish threw (AGL-1334).
+ *
+ * A failed publish used to surface the raw thrown message — for the bug this
+ * fixes, a Firestore "called with invalid data, unsupported field value:
+ * undefined, found in field nodes.(id).props.startIconPath" — in a toast that
+ * auto-dismissed. That is the most dangerous possible
+ * failure surface for this action: publishing is the ONLY step that moves work
+ * onto live pages, the editor still reads `UP TO DATE` (the save really did
+ * succeed), and an author who misses the toast walks away believing the
+ * component shipped while every instance keeps rendering the old markup. It is
+ * how AGL-1318's fix sat stranded for hours.
+ *
+ * So every message here leads with the fact that matters — the live pages did
+ * NOT change — and names a next step. The underlying text is kept, last, for
+ * a bug report; it is evidence, not an explanation.
+ */
+export declare function publishFailureMessage(error: unknown): string;
+export default publishFailureMessage;

package/src/lib/utils/publish-failure-message.js

@@ -0,0 +1,51 @@
+/**
+ * @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.
+ */ /**
+ * What to tell an author whose publish threw (AGL-1334).
+ *
+ * A failed publish used to surface the raw thrown message — for the bug this
+ * fixes, a Firestore "called with invalid data, unsupported field value:
+ * undefined, found in field nodes.(id).props.startIconPath" — in a toast that
+ * auto-dismissed. That is the most dangerous possible
+ * failure surface for this action: publishing is the ONLY step that moves work
+ * onto live pages, the editor still reads `UP TO DATE` (the save really did
+ * succeed), and an author who misses the toast walks away believing the
+ * component shipped while every instance keeps rendering the old markup. It is
+ * how AGL-1318's fix sat stranded for hours.
+ *
+ * So every message here leads with the fact that matters — the live pages did
+ * NOT change — and names a next step. The underlying text is kept, last, for
+ * a bug report; it is evidence, not an explanation.
+ */ export function publishFailureMessage(error) {
+    const detail = error instanceof Error ? error.message : typeof error === 'string' ? error : '';
+    const lead = 'Not published — live pages still show the previous version.';
+    if (/permission|insufficient|unauthenticated/i.test(detail)) {
+        return `${lead} You do not have permission to publish this component. Ask an owner or admin of this site to publish it.`;
+    }
+    if (/invalid data|unsupported field value/i.test(detail)) {
+        return `${lead} This component has an element the site cannot store. Reload the editor and publish again — if it happens twice, report it with this: ${detail}`;
+    }
+    if (/offline|unavailable|network|deadline/i.test(detail)) {
+        return `${lead} The site could not be reached. Check your connection and publish again.`;
+    }
+    if (!detail) {
+        return `${lead} Publishing failed for an unknown reason — reload the editor and try again.`;
+    }
+    return `${lead} Publishing failed: ${detail}`;
+}
+export default publishFailureMessage;
+
+//# sourceMappingURL=publish-failure-message.js.map

package/src/lib/utils/publish-failure-message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/publish-failure-message.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\n/**\n * What to tell an author whose publish threw (AGL-1334).\n *\n * A failed publish used to surface the raw thrown message — for the bug this\n * fixes, a Firestore \"called with invalid data, unsupported field value:\n * undefined, found in field nodes.(id).props.startIconPath\" — in a toast that\n * auto-dismissed. That is the most dangerous possible\n * failure surface for this action: publishing is the ONLY step that moves work\n * onto live pages, the editor still reads `UP TO DATE` (the save really did\n * succeed), and an author who misses the toast walks away believing the\n * component shipped while every instance keeps rendering the old markup. It is\n * how AGL-1318's fix sat stranded for hours.\n *\n * So every message here leads with the fact that matters — the live pages did\n * NOT change — and names a next step. The underlying text is kept, last, for\n * a bug report; it is evidence, not an explanation.\n */\nexport function publishFailureMessage(error: unknown): string {\n  const detail =\n    error instanceof Error\n      ? error.message\n      : typeof error === 'string'\n        ? error\n        : ''\n  const lead = 'Not published — live pages still show the previous version.'\n\n  if (/permission|insufficient|unauthenticated/i.test(detail)) {\n    return `${lead} You do not have permission to publish this component. Ask an owner or admin of this site to publish it.`\n  }\n  if (/invalid data|unsupported field value/i.test(detail)) {\n    return `${lead} This component has an element the site cannot store. Reload the editor and publish again — if it happens twice, report it with this: ${detail}`\n  }\n  if (/offline|unavailable|network|deadline/i.test(detail)) {\n    return `${lead} The site could not be reached. Check your connection and publish again.`\n  }\n  if (!detail) {\n    return `${lead} Publishing failed for an unknown reason — reload the editor and try again.`\n  }\n  return `${lead} Publishing failed: ${detail}`\n}\n\nexport default publishFailureMessage\n"],"names":["publishFailureMessage","error","detail","Error","message","lead","test"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASA,sBAAsBC,KAAc;IAClD,MAAMC,SACJD,iBAAiBE,QACbF,MAAMG,OAAO,GACb,OAAOH,UAAU,WACfA,QACA;IACR,MAAMI,OAAO;IAEb,IAAI,2CAA2CC,IAAI,CAACJ,SAAS;QAC3D,OAAO,GAAGG,KAAK,wGAAwG,CAAC;IAC1H;IACA,IAAI,wCAAwCC,IAAI,CAACJ,SAAS;QACxD,OAAO,GAAGG,KAAK,sIAAsI,EAAEH,QAAQ;IACjK;IACA,IAAI,wCAAwCI,IAAI,CAACJ,SAAS;QACxD,OAAO,GAAGG,KAAK,wEAAwE,CAAC;IAC1F;IACA,IAAI,CAACH,QAAQ;QACX,OAAO,GAAGG,KAAK,2EAA2E,CAAC;IAC7F;IACA,OAAO,GAAGA,KAAK,oBAAoB,EAAEH,QAAQ;AAC/C;AAEA,eAAeF,sBAAqB"}

package/src/lib/utils/rank-picker-results.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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.
+ */
+/**
+ * Match quality, best first. Lower sorts earlier.
+ *
+ * `FUZZY_ONLY` is the floor: the caller's fuzzy pass matched it but no field
+ * literally contains the term (a typo, a transposition). Those keep their
+ * incoming order and sit behind every literal hit.
+ */
+export declare const PICKER_RANK: {
+    readonly EXACT_NAME: 0;
+    readonly NAME_PREFIX: 1;
+    readonly NAME_WORD_PREFIX: 2;
+    readonly NAME_SUBSTRING: 3;
+    readonly OTHER_FIELD: 4;
+    readonly FUZZY_ONLY: 5;
+};
+export type PickerRank = (typeof PICKER_RANK)[keyof typeof PICKER_RANK];
+/**
+ * How well `item` matches `query`.
+ *
+ * A multi-word query is scored by its WEAKEST term: "icon button" must not
+ * be reported as an exact name match on the strength of `icon` alone.
+ */
+export declare function rankPickerItem(item: unknown, query: string): PickerRank;
+/**
+ * `items` reordered best-match first. Nothing is dropped — the caller has
+ * already decided what matches.
+ */
+export declare function rankPickerItems<T>(items: T[], query: string): T[];
+export default rankPickerItems;