@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/utils/token-segments.js

@@ -0,0 +1,246 @@
+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 { COLLECTION_TOKEN_CATALOG, ENTRY_TOKEN_CATALOG, hostTokenDefinition, humanizeDatasetFieldId } from "@aglyn/aglyn";
+/**
+ * Any `{{...}}` occurrence without nested braces — var:/fn:/entry./
+ * collection./item.* AND unknown tokens alike. `{{a{{b}}` yields the text
+ * `{{a` plus the token `{{b}}` (the opener without a closer is plain text).
+ */ export const TOKEN_SEGMENT_PATTERN = /\{\{[^{}]*\}\}/g;
+/** Drops empty text runs and merges adjacent text segments. */ function normalizeSegments(segments) {
+    const out = [];
+    for (const segment of segments){
+        if (segment.type === 'text' && !segment.value) continue;
+        const last = out[out.length - 1];
+        if (segment.type === 'text' && (last == null ? void 0 : last.type) === 'text') {
+            last.value += segment.value;
+        } else {
+            out.push(_extends({}, segment));
+        }
+    }
+    return out;
+}
+/** Splits `text` on `{{...}}` occurrences into text/token segments. */ export function parseTokenSegments(text) {
+    const segments = [];
+    let cursor = 0;
+    const pattern = new RegExp(TOKEN_SEGMENT_PATTERN.source, 'g');
+    for(let match = pattern.exec(text); match; match = pattern.exec(text)){
+        if (match.index > cursor) {
+            segments.push({
+                type: 'text',
+                value: text.slice(cursor, match.index)
+            });
+        }
+        segments.push({
+            type: 'token',
+            value: match[0],
+            token: match[0]
+        });
+        cursor = match.index + match[0].length;
+    }
+    if (cursor < text.length) {
+        segments.push({
+            type: 'text',
+            value: text.slice(cursor)
+        });
+    }
+    return segments;
+}
+/** Joins segments back to the exact stored string (lossless round-trip). */ export function serializeTokenSegments(segments) {
+    return segments.map((segment)=>segment.value).join('');
+}
+/** True when any text run still holds a complete raw `{{...}}` token. */ export function hasUnmaterializedTokens(segments) {
+    const probe = new RegExp(TOKEN_SEGMENT_PATTERN.source);
+    return segments.some((segment)=>segment.type === 'text' && probe.test(segment.value));
+}
+/** Unit length of one segment: text = char count, token = 1 atomic unit. */ export function segmentUnitLength(segment) {
+    return segment.type === 'token' ? 1 : segment.value.length;
+}
+/** Total unit length of a segment list (pills count as 1 unit each). */ export function segmentsUnitLength(segments) {
+    return segments.reduce((sum, segment)=>sum + segmentUnitLength(segment), 0);
+}
+/**
+ * Extracts [from, to) in unit offsets. Tokens are atomic: since a token is
+ * exactly 1 unit, an integer range either includes it wholly or not at all
+ * — a caret can never split a pill.
+ */ export function sliceSegmentsByUnits(segments, from, to) {
+    const out = [];
+    let position = 0;
+    for (const segment of segments){
+        const length = segmentUnitLength(segment);
+        const start = Math.max(from, position);
+        const stop = Math.min(to, position + length);
+        if (stop > start) {
+            if (segment.type === 'token') {
+                out.push(_extends({}, segment));
+            } else {
+                out.push({
+                    type: 'text',
+                    value: segment.value.slice(start - position, stop - position)
+                });
+            }
+        }
+        position += length;
+    }
+    return normalizeSegments(out);
+}
+/**
+ * Splices `replacement` into `segments` at the unit-offset selection,
+ * replacing any selected range — the caret-preserving insert used by the
+ * {x} picker (AGL-583 semantics, pill-aware). A null/undefined start means
+ * "no caret captured": the replacement appends at the end. Returns the new
+ * segment list and the caret unit just after the inserted content.
+ */ export function spliceSegmentsAtUnits(segments, replacement, start, end) {
+    const length = segmentsUnitLength(segments);
+    const clamp = (value)=>Math.min(Math.max(value, 0), length);
+    const at = start == null ? length : clamp(start);
+    const to = end == null ? at : Math.max(clamp(end), at);
+    const next = normalizeSegments([
+        ...sliceSegmentsByUnits(segments, 0, at),
+        ...replacement,
+        ...sliceSegmentsByUnits(segments, to, Infinity)
+    ]);
+    return {
+        segments: next,
+        caretUnit: at + segmentsUnitLength(replacement)
+    };
+}
+/** A single token segment for `spliceSegmentsAtUnits` insertion. */ export function tokenSegment(token) {
+    return {
+        type: 'token',
+        value: token,
+        token
+    };
+}
+/** A single text segment for `spliceSegmentsAtUnits` insertion. */ export function textSegment(text) {
+    return {
+        type: 'text',
+        value: text
+    };
+}
+const stripBraces = (token)=>token.replace(/^\{\{\s*/, '').replace(/\s*\}\}$/, '');
+/** Whitespace-insensitive raw-token comparison (`{{ var:x }}` ≡ `{{var:x}}`). */ const canonical = (token)=>token.replace(/\s+/g, '');
+/**
+ * Resolves a raw token to its display name (AGL-586 requirement 2: users
+ * see NAMES, storage keeps IDS). The group comes from the token's shape so
+ * pills stay consistently colored even when the referent is missing;
+ * `known: false` marks unresolvable tokens for warning styling with the
+ * raw token surfaced as the tooltip.
+ */ export function resolveTokenLabel(token, context = {}) {
+    const inner = stripBraces(token).trim();
+    const optionByToken = (candidate)=>{
+        var _context_options;
+        return ((_context_options = context.options) != null ? _context_options : []).find((option)=>canonical(option.token) === canonical(candidate));
+    };
+    const variableMatch = /^var:([^\s(){}]+)$/.exec(inner);
+    if (variableMatch) {
+        var _ref;
+        var _context_variables_id, _context_variables, _optionByToken;
+        const id = variableMatch[1];
+        const name = (_ref = (_context_variables = context.variables) == null ? void 0 : (_context_variables_id = _context_variables[id]) == null ? void 0 : _context_variables_id.name) != null ? _ref : (_optionByToken = optionByToken(`{{var:${id}}}`)) == null ? void 0 : _optionByToken.label;
+        return {
+            label: name != null ? name : id,
+            group: 'variable',
+            known: Boolean(name)
+        };
+    }
+    const functionMatch = /^fn:([^(){}]+)\(([^)]*)\)$/.exec(inner);
+    if (functionMatch) {
+        var _ref1, _context_options;
+        var _context_functions_id, _context_functions, _find;
+        const id = String(functionMatch[1]).trim();
+        // A stored call's args differ from the picker's parameter template, so
+        // options match on the `{{fn:id(` prefix rather than the whole token.
+        const name = (_ref1 = (_context_functions = context.functions) == null ? void 0 : (_context_functions_id = _context_functions[id]) == null ? void 0 : _context_functions_id.name) != null ? _ref1 : (_find = ((_context_options = context.options) != null ? _context_options : []).find((option)=>canonical(option.token).startsWith(canonical(`{{fn:${id}(`)))) == null ? void 0 : _find.label;
+        return {
+            label: name != null ? name : id,
+            group: 'function',
+            known: Boolean(name)
+        };
+    }
+    if (inner.startsWith('entry.')) {
+        var _ref2;
+        const entry = ENTRY_TOKEN_CATALOG.find((candidate)=>canonical(candidate.token) === canonical(`{{${inner}}}`));
+        return {
+            label: (_ref2 = entry == null ? void 0 : entry.label) != null ? _ref2 : inner,
+            group: 'entry',
+            known: Boolean(entry)
+        };
+    }
+    // `{{pagination.*}}` (AGL-1386) resolves on the same collection list pages
+    // and lives in the same catalog, so it shares the collection pill rather
+    // than reading as an unresolvable token in warning colors.
+    if (inner.startsWith('collection.') || inner.startsWith('pagination.')) {
+        var _ref3;
+        const entry = COLLECTION_TOKEN_CATALOG.find((candidate)=>canonical(candidate.token) === canonical(`{{${inner}}}`));
+        return {
+            label: (_ref3 = entry == null ? void 0 : entry.label) != null ? _ref3 : inner,
+            group: 'collection',
+            known: Boolean(entry)
+        };
+    }
+    /*
+   * A component's own property (AGL-1335), named the way the Attributes panel
+   * names it. Known only where the picker offers it — inside the component
+   * that declares it — because that is the only place the token substitutes:
+   * the same pill on an ordinary screen, or naming a property since removed,
+   * resolves to nothing on the page and says so in warning colors.
+   */ const propertyMatch = /^prop\.([A-Za-z_][A-Za-z0-9_]*)$/.exec(inner);
+    if (propertyMatch) {
+        var _ref4;
+        const option = optionByToken(`{{${inner}}}`);
+        return {
+            label: (_ref4 = option == null ? void 0 : option.label) != null ? _ref4 : propertyMatch[1],
+            group: 'property',
+            known: Boolean(option)
+        };
+    }
+    /*
+   * A host variable (AGL-1022), named from the registry that resolves it
+   * (AGL-2881), so the pill reads "Business name" wherever the token sits and
+   * every surface agrees on what exists. A name the registry does not declare
+   * renders nothing on the page, and says so in warning colors.
+   */ const hostMatch = /^host\.([a-zA-Z][a-zA-Z0-9_]*)$/.exec(inner);
+    if (hostMatch) {
+        var _ref5;
+        const definition = hostTokenDefinition(hostMatch[1]);
+        return {
+            label: (_ref5 = definition == null ? void 0 : definition.label) != null ? _ref5 : inner,
+            group: 'host',
+            known: Boolean(definition)
+        };
+    }
+    const itemMatch = /^item\.([^.\s{}]+)(?:\.([^.\s{}]+))?$/.exec(inner);
+    if (itemMatch) {
+        var _context_datasetFields;
+        const fieldId = itemMatch[1];
+        const hopId = itemMatch[2];
+        const field = ((_context_datasetFields = context.datasetFields) != null ? _context_datasetFields : []).find((candidate)=>candidate.id === fieldId);
+        const label = field ? hopId ? `${field.label} → ${humanizeDatasetFieldId(hopId)}` : field.label : inner;
+        return {
+            label,
+            group: 'dataset',
+            known: Boolean(field)
+        };
+    }
+    return {
+        label: inner || token,
+        group: 'unknown',
+        known: false
+    };
+}
+
+//# sourceMappingURL=token-segments.js.map

package/src/lib/utils/token-segments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/token-segments.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 {\n  COLLECTION_TOKEN_CATALOG,\n  ENTRY_TOKEN_CATALOG,\n  hostTokenDefinition,\n  humanizeDatasetFieldId,\n} from '@aglyn/aglyn'\n\nimport type { BindingOption } from '../contexts/binding-picker-context'\n\n/**\n * Token-pill segment model (AGL-586). Stored prop strings keep the raw\n * id-based `{{...}}` grammar (AGL-100/185) — these helpers only SPLIT a\n * string into runs of plain text and atomic tokens so editors can render\n * the tokens as friendly, clickable pills. Serializing the segments always\n * reproduces the exact input string; nothing here ever rewrites a token.\n *\n * Offset model: editor carets address \"units\", where every plain-text\n * character is 1 unit and every token — however long its raw text — is 1\n * atomic unit. A caret can therefore sit before or after a pill but never\n * inside one, which is exactly how the pills behave in the DOM\n * (`contenteditable=\"false\"`).\n */\nexport interface TokenSegment {\n  type: 'text' | 'token'\n  /** The literal slice of the serialized string (raw `{{...}}` for tokens). */\n  value: string\n  /** Set on token segments: the raw token, identical to `value`. */\n  token?: string\n}\n\n/**\n * Any `{{...}}` occurrence without nested braces — var:/fn:/entry./\n * collection./item.* AND unknown tokens alike. `{{a{{b}}` yields the text\n * `{{a` plus the token `{{b}}` (the opener without a closer is plain text).\n */\nexport const TOKEN_SEGMENT_PATTERN = /\\{\\{[^{}]*\\}\\}/g\n\n/** Drops empty text runs and merges adjacent text segments. */\nfunction normalizeSegments(segments: TokenSegment[]): TokenSegment[] {\n  const out: TokenSegment[] = []\n  for (const segment of segments) {\n    if (segment.type === 'text' && !segment.value) continue\n    const last = out[out.length - 1]\n    if (segment.type === 'text' && last?.type === 'text') {\n      last.value += segment.value\n    } else {\n      out.push({ ...segment })\n    }\n  }\n  return out\n}\n\n/** Splits `text` on `{{...}}` occurrences into text/token segments. */\nexport function parseTokenSegments(text: string): TokenSegment[] {\n  const segments: TokenSegment[] = []\n  let cursor = 0\n  const pattern = new RegExp(TOKEN_SEGMENT_PATTERN.source, 'g')\n  for (let match = pattern.exec(text); match; match = pattern.exec(text)) {\n    if (match.index > cursor) {\n      segments.push({ type: 'text', value: text.slice(cursor, match.index) })\n    }\n    segments.push({ type: 'token', value: match[0], token: match[0] })\n    cursor = match.index + match[0].length\n  }\n  if (cursor < text.length) {\n    segments.push({ type: 'text', value: text.slice(cursor) })\n  }\n  return segments\n}\n\n/** Joins segments back to the exact stored string (lossless round-trip). */\nexport function serializeTokenSegments(segments: TokenSegment[]): string {\n  return segments.map((segment) => segment.value).join('')\n}\n\n/** True when any text run still holds a complete raw `{{...}}` token. */\nexport function hasUnmaterializedTokens(segments: TokenSegment[]): boolean {\n  const probe = new RegExp(TOKEN_SEGMENT_PATTERN.source)\n  return segments.some(\n    (segment) => segment.type === 'text' && probe.test(segment.value),\n  )\n}\n\n/** Unit length of one segment: text = char count, token = 1 atomic unit. */\nexport function segmentUnitLength(segment: TokenSegment): number {\n  return segment.type === 'token' ? 1 : segment.value.length\n}\n\n/** Total unit length of a segment list (pills count as 1 unit each). */\nexport function segmentsUnitLength(segments: TokenSegment[]): number {\n  return segments.reduce((sum, segment) => sum + segmentUnitLength(segment), 0)\n}\n\n/**\n * Extracts [from, to) in unit offsets. Tokens are atomic: since a token is\n * exactly 1 unit, an integer range either includes it wholly or not at all\n * — a caret can never split a pill.\n */\nexport function sliceSegmentsByUnits(\n  segments: TokenSegment[],\n  from: number,\n  to: number,\n): TokenSegment[] {\n  const out: TokenSegment[] = []\n  let position = 0\n  for (const segment of segments) {\n    const length = segmentUnitLength(segment)\n    const start = Math.max(from, position)\n    const stop = Math.min(to, position + length)\n    if (stop > start) {\n      if (segment.type === 'token') {\n        out.push({ ...segment })\n      } else {\n        out.push({\n          type: 'text',\n          value: segment.value.slice(start - position, stop - position),\n        })\n      }\n    }\n    position += length\n  }\n  return normalizeSegments(out)\n}\n\n/**\n * Splices `replacement` into `segments` at the unit-offset selection,\n * replacing any selected range — the caret-preserving insert used by the\n * {x} picker (AGL-583 semantics, pill-aware). A null/undefined start means\n * \"no caret captured\": the replacement appends at the end. Returns the new\n * segment list and the caret unit just after the inserted content.\n */\nexport function spliceSegmentsAtUnits(\n  segments: TokenSegment[],\n  replacement: TokenSegment[],\n  start?: number | null,\n  end?: number | null,\n): { segments: TokenSegment[]; caretUnit: number } {\n  const length = segmentsUnitLength(segments)\n  const clamp = (value: number) => Math.min(Math.max(value, 0), length)\n  const at = start == null ? length : clamp(start)\n  const to = end == null ? at : Math.max(clamp(end), at)\n  const next = normalizeSegments([\n    ...sliceSegmentsByUnits(segments, 0, at),\n    ...replacement,\n    ...sliceSegmentsByUnits(segments, to, Infinity),\n  ])\n  return { segments: next, caretUnit: at + segmentsUnitLength(replacement) }\n}\n\n/** A single token segment for `spliceSegmentsAtUnits` insertion. */\nexport function tokenSegment(token: string): TokenSegment {\n  return { type: 'token', value: token, token }\n}\n\n/** A single text segment for `spliceSegmentsAtUnits` insertion. */\nexport function textSegment(text: string): TokenSegment {\n  return { type: 'text', value: text }\n}\n\n/** Which catalog family a token belongs to — drives the pill color. */\nexport type TokenGroup =\n  | 'variable'\n  | 'function'\n  | 'entry'\n  | 'collection'\n  | 'dataset'\n  | 'property'\n  | 'host'\n  | 'unknown'\n\n/**\n * Display-name inputs for {@link resolveTokenLabel}: the picker options\n * (which already carry friendly labels for every insertable token), the\n * host's variable/function docs keyed by id (AGL-194), and the ancestor\n * repeatable's dataset model fields (id → current display name).\n */\nexport interface TokenLabelContext {\n  options?: BindingOption[]\n  variables?: Record<string, { name?: string } | undefined>\n  functions?: Record<string, { name?: string } | undefined>\n  datasetFields?: Array<{ id: string; label: string }>\n}\n\nexport interface ResolvedTokenLabel {\n  /** Friendly display name (the CURRENT name — ids stay in storage). */\n  label: string\n  /** Family for the pill color; shape-derived, stable across renames. */\n  group: TokenGroup\n  /** False when the referent can't be resolved (warning-colored pill). */\n  known: boolean\n}\n\nconst stripBraces = (token: string): string =>\n  token.replace(/^\\{\\{\\s*/, '').replace(/\\s*\\}\\}$/, '')\n\n/** Whitespace-insensitive raw-token comparison (`{{ var:x }}` ≡ `{{var:x}}`). */\nconst canonical = (token: string): string => token.replace(/\\s+/g, '')\n\n/**\n * Resolves a raw token to its display name (AGL-586 requirement 2: users\n * see NAMES, storage keeps IDS). The group comes from the token's shape so\n * pills stay consistently colored even when the referent is missing;\n * `known: false` marks unresolvable tokens for warning styling with the\n * raw token surfaced as the tooltip.\n */\nexport function resolveTokenLabel(\n  token: string,\n  context: TokenLabelContext = {},\n): ResolvedTokenLabel {\n  const inner = stripBraces(token).trim()\n  const optionByToken = (candidate: string): BindingOption | undefined =>\n    (context.options ?? []).find(\n      (option) => canonical(option.token) === canonical(candidate),\n    )\n\n  const variableMatch = /^var:([^\\s(){}]+)$/.exec(inner)\n  if (variableMatch) {\n    const id = variableMatch[1] as string\n    const name =\n      context.variables?.[id]?.name ?? optionByToken(`{{var:${id}}}`)?.label\n    return { label: name ?? id, group: 'variable', known: Boolean(name) }\n  }\n\n  const functionMatch = /^fn:([^(){}]+)\\(([^)]*)\\)$/.exec(inner)\n  if (functionMatch) {\n    const id = String(functionMatch[1]).trim()\n    // A stored call's args differ from the picker's parameter template, so\n    // options match on the `{{fn:id(` prefix rather than the whole token.\n    const name =\n      context.functions?.[id]?.name ??\n      (context.options ?? []).find((option) =>\n        canonical(option.token).startsWith(canonical(`{{fn:${id}(`)),\n      )?.label\n    return { label: name ?? id, group: 'function', known: Boolean(name) }\n  }\n\n  if (inner.startsWith('entry.')) {\n    const entry = ENTRY_TOKEN_CATALOG.find(\n      (candidate) => canonical(candidate.token) === canonical(`{{${inner}}}`),\n    )\n    return { label: entry?.label ?? inner, group: 'entry', known: Boolean(entry) }\n  }\n\n  // `{{pagination.*}}` (AGL-1386) resolves on the same collection list pages\n  // and lives in the same catalog, so it shares the collection pill rather\n  // than reading as an unresolvable token in warning colors.\n  if (inner.startsWith('collection.') || inner.startsWith('pagination.')) {\n    const entry = COLLECTION_TOKEN_CATALOG.find(\n      (candidate) => canonical(candidate.token) === canonical(`{{${inner}}}`),\n    )\n    return {\n      label: entry?.label ?? inner,\n      group: 'collection',\n      known: Boolean(entry),\n    }\n  }\n\n  /*\n   * A component's own property (AGL-1335), named the way the Attributes panel\n   * names it. Known only where the picker offers it — inside the component\n   * that declares it — because that is the only place the token substitutes:\n   * the same pill on an ordinary screen, or naming a property since removed,\n   * resolves to nothing on the page and says so in warning colors.\n   */\n  const propertyMatch = /^prop\\.([A-Za-z_][A-Za-z0-9_]*)$/.exec(inner)\n  if (propertyMatch) {\n    const option = optionByToken(`{{${inner}}}`)\n    return {\n      label: option?.label ?? (propertyMatch[1] as string),\n      group: 'property',\n      known: Boolean(option),\n    }\n  }\n\n  /*\n   * A host variable (AGL-1022), named from the registry that resolves it\n   * (AGL-2881), so the pill reads \"Business name\" wherever the token sits and\n   * every surface agrees on what exists. A name the registry does not declare\n   * renders nothing on the page, and says so in warning colors.\n   */\n  const hostMatch = /^host\\.([a-zA-Z][a-zA-Z0-9_]*)$/.exec(inner)\n  if (hostMatch) {\n    const definition = hostTokenDefinition(hostMatch[1] as string)\n    return {\n      label: definition?.label ?? inner,\n      group: 'host',\n      known: Boolean(definition),\n    }\n  }\n\n  const itemMatch = /^item\\.([^.\\s{}]+)(?:\\.([^.\\s{}]+))?$/.exec(inner)\n  if (itemMatch) {\n    const fieldId = itemMatch[1] as string\n    const hopId = itemMatch[2]\n    const field = (context.datasetFields ?? []).find(\n      (candidate) => candidate.id === fieldId,\n    )\n    const label = field\n      ? hopId\n        ? `${field.label} → ${humanizeDatasetFieldId(hopId)}`\n        : field.label\n      : inner\n    return { label, group: 'dataset', known: Boolean(field) }\n  }\n\n  return { label: inner || token, group: 'unknown', known: false }\n}\n"],"names":["COLLECTION_TOKEN_CATALOG","ENTRY_TOKEN_CATALOG","hostTokenDefinition","humanizeDatasetFieldId","TOKEN_SEGMENT_PATTERN","normalizeSegments","segments","out","segment","type","value","last","length","push","parseTokenSegments","text","cursor","pattern","RegExp","source","match","exec","index","slice","token","serializeTokenSegments","map","join","hasUnmaterializedTokens","probe","some","test","segmentUnitLength","segmentsUnitLength","reduce","sum","sliceSegmentsByUnits","from","to","position","start","Math","max","stop","min","spliceSegmentsAtUnits","replacement","end","clamp","at","next","Infinity","caretUnit","tokenSegment","textSegment","stripBraces","replace","canonical","resolveTokenLabel","context","inner","trim","optionByToken","candidate","options","find","option","variableMatch","id","name","variables","label","group","known","Boolean","functionMatch","String","functions","startsWith","entry","propertyMatch","hostMatch","definition","itemMatch","fieldId","hopId","field","datasetFields"],"mappings":"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"}

package/src/lib/utils/visibility-styles.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { VISIBILITY_BAND_MEDIA, VISIBILITY_BANDS, type VisibilityBand } from '@aglyn/aglyn';
+/**
+ * Responsive visibility control model (AGL-562): "hide on mobile /
+ * tablet / desktop" toggles that write `display: none` under
+ * range-scoped media keys in the node's sx. Range queries (rather than
+ * MUI's mobile-first responsive objects) mean hiding one band never
+ * needs a restore `display` value on the others, so an element's
+ * natural display — flex for stacks, block for boxes — is untouched
+ * where it stays visible. The keys are shared with the plugins-mui
+ * Mobile Nav preset via `@aglyn/aglyn`.
+ */
+export { VISIBILITY_BAND_MEDIA, VISIBILITY_BANDS };
+export type { VisibilityBand };
+export declare const VISIBILITY_BAND_LABELS: Record<VisibilityBand, string>;
+/** Bands the sx currently hides (band media key with display: none). */
+export declare function readHiddenBands(sx: Record<string, any> | undefined): VisibilityBand[];
+/**
+ * Returns a new sx with the band hidden or shown. Other declarations an
+ * author placed under the same media key (via the custom-CSS JSON tab)
+ * are preserved; the media key itself is dropped once it holds nothing.
+ */
+export declare function writeHiddenBand(sx: Record<string, any> | undefined, band: VisibilityBand, hidden: boolean): Record<string, any>;

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

@@ -0,0 +1,54 @@
+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 { VISIBILITY_BAND_MEDIA, VISIBILITY_BANDS } from "@aglyn/aglyn";
+/**
+ * Responsive visibility control model (AGL-562): "hide on mobile /
+ * tablet / desktop" toggles that write `display: none` under
+ * range-scoped media keys in the node's sx. Range queries (rather than
+ * MUI's mobile-first responsive objects) mean hiding one band never
+ * needs a restore `display` value on the others, so an element's
+ * natural display — flex for stacks, block for boxes — is untouched
+ * where it stays visible. The keys are shared with the plugins-mui
+ * Mobile Nav preset via `@aglyn/aglyn`.
+ */ export { VISIBILITY_BAND_MEDIA, VISIBILITY_BANDS };
+export const VISIBILITY_BAND_LABELS = {
+    mobile: 'Hide on mobile (under 600px)',
+    tablet: 'Hide on tablet (600–899px)',
+    desktop: 'Hide on desktop (900px and up)'
+};
+/** Bands the sx currently hides (band media key with display: none). */ export function readHiddenBands(sx) {
+    return VISIBILITY_BANDS.filter((band)=>{
+        var _sx_VISIBILITY_BAND_MEDIA_band;
+        return (sx == null ? void 0 : (_sx_VISIBILITY_BAND_MEDIA_band = sx[VISIBILITY_BAND_MEDIA[band]]) == null ? void 0 : _sx_VISIBILITY_BAND_MEDIA_band['display']) === 'none';
+    });
+}
+/**
+ * Returns a new sx with the band hidden or shown. Other declarations an
+ * author placed under the same media key (via the custom-CSS JSON tab)
+ * are preserved; the media key itself is dropped once it holds nothing.
+ */ export function writeHiddenBand(sx, band, hidden) {
+    const key = VISIBILITY_BAND_MEDIA[band];
+    const next = _extends({}, sx);
+    const slice = typeof next[key] === 'object' && next[key] !== null ? _extends({}, next[key]) : {};
+    if (hidden) slice['display'] = 'none';
+    else delete slice['display'];
+    if (Object.keys(slice).length === 0) delete next[key];
+    else next[key] = slice;
+    return next;
+}
+
+//# sourceMappingURL=visibility-styles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/utils/visibility-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 {\n  VISIBILITY_BAND_MEDIA,\n  VISIBILITY_BANDS,\n  type VisibilityBand,\n} from '@aglyn/aglyn'\n\n/**\n * Responsive visibility control model (AGL-562): \"hide on mobile /\n * tablet / desktop\" toggles that write `display: none` under\n * range-scoped media keys in the node's sx. Range queries (rather than\n * MUI's mobile-first responsive objects) mean hiding one band never\n * needs a restore `display` value on the others, so an element's\n * natural display — flex for stacks, block for boxes — is untouched\n * where it stays visible. The keys are shared with the plugins-mui\n * Mobile Nav preset via `@aglyn/aglyn`.\n */\n\nexport { VISIBILITY_BAND_MEDIA, VISIBILITY_BANDS }\nexport type { VisibilityBand }\n\nexport const VISIBILITY_BAND_LABELS: Record<VisibilityBand, string> = {\n  mobile: 'Hide on mobile (under 600px)',\n  tablet: 'Hide on tablet (600–899px)',\n  desktop: 'Hide on desktop (900px and up)',\n}\n\n/** Bands the sx currently hides (band media key with display: none). */\nexport function readHiddenBands(\n  sx: Record<string, any> | undefined,\n): VisibilityBand[] {\n  return VISIBILITY_BANDS.filter(\n    (band) => sx?.[VISIBILITY_BAND_MEDIA[band]]?.['display'] === 'none',\n  )\n}\n\n/**\n * Returns a new sx with the band hidden or shown. Other declarations an\n * author placed under the same media key (via the custom-CSS JSON tab)\n * are preserved; the media key itself is dropped once it holds nothing.\n */\nexport function writeHiddenBand(\n  sx: Record<string, any> | undefined,\n  band: VisibilityBand,\n  hidden: boolean,\n): Record<string, any> {\n  const key = VISIBILITY_BAND_MEDIA[band]\n  const next: Record<string, any> = { ...sx }\n  const slice: Record<string, any> =\n    typeof next[key] === 'object' && next[key] !== null ? { ...next[key] } : {}\n  if (hidden) slice['display'] = 'none'\n  else delete slice['display']\n  if (Object.keys(slice).length === 0) delete next[key]\n  else next[key] = slice\n  return next\n}\n"],"names":["VISIBILITY_BAND_MEDIA","VISIBILITY_BANDS","VISIBILITY_BAND_LABELS","mobile","tablet","desktop","readHiddenBands","sx","filter","band","writeHiddenBand","hidden","key","next","slice","Object","keys","length"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,qBAAqB,EACrBC,gBAAgB,QAEX,eAAc;AAErB;;;;;;;;;CASC,GAED,SAASD,qBAAqB,EAAEC,gBAAgB,GAAE;AAGlD,OAAO,MAAMC,yBAAyD;IACpEC,QAAQ;IACRC,QAAQ;IACRC,SAAS;AACX,EAAC;AAED,sEAAsE,GACtE,OAAO,SAASC,gBACdC,EAAmC;IAEnC,OAAON,iBAAiBO,MAAM,CAC5B,CAACC;YAASF;eAAAA,CAAAA,uBAAAA,iCAAAA,EAAI,CAACP,qBAAqB,CAACS,KAAK,CAAC,qBAAjCF,8BAAmC,CAAC,UAAU,MAAK;;AAEjE;AAEA;;;;CAIC,GACD,OAAO,SAASG,gBACdH,EAAmC,EACnCE,IAAoB,EACpBE,MAAe;IAEf,MAAMC,MAAMZ,qBAAqB,CAACS,KAAK;IACvC,MAAMI,OAA4B,aAAKN;IACvC,MAAMO,QACJ,OAAOD,IAAI,CAACD,IAAI,KAAK,YAAYC,IAAI,CAACD,IAAI,KAAK,OAAO,aAAKC,IAAI,CAACD,IAAI,IAAK,CAAC;IAC5E,IAAID,QAAQG,KAAK,CAAC,UAAU,GAAG;SAC1B,OAAOA,KAAK,CAAC,UAAU;IAC5B,IAAIC,OAAOC,IAAI,CAACF,OAAOG,MAAM,KAAK,GAAG,OAAOJ,IAAI,CAACD,IAAI;SAChDC,IAAI,CAACD,IAAI,GAAGE;IACjB,OAAOD;AACT"}