@aglyn/plugins-logic 1.0.0-beta.246 → 1.0.0-beta.249

package/src/lib/model/structured-value.d.ts

@@ -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.
+ */
+/**
+ * A dictionary or collection variable, as rows an author fills in rather than
+ * JSON they type (AGL-3757). The stored value is unchanged — the same JSON
+ * string `formatVariableValue` and a function's `name.member` read — so this
+ * module only translates between that string and the rows the editor shows.
+ */
+/** What one entry holds; `kept` is a nested value the rows cannot edit. */
+export type StructuredValueKind = 'text' | 'number' | 'boolean' | 'kept';
+export interface StructuredValueRow {
+    /** The dictionary key; ignored for a collection. */
+    key: string;
+    kind: StructuredValueKind;
+    /** Text as shown in the box; `'true'`/`'false'` for a true/false entry. */
+    value: string;
+    /** The original nested value, carried through untouched for a `kept` row. */
+    kept?: unknown;
+}
+export interface ParsedStructuredValue {
+    rows: StructuredValueRow[];
+    /**
+     * True when a stored value could not be read as the expected shape — an
+     * old hand-typed value with a stray comma, or a list stored on a
+     * dictionary. The editor starts from what it could read and says so.
+     */
+    unreadable: boolean;
+}
+/** The rows a stored dictionary or collection value reads as. */
+export declare function parseStructuredValue(raw: string | undefined, shape: 'dictionary' | 'collection'): ParsedStructuredValue;
+/**
+ * The JSON string rows store as. A dictionary drops rows without a key and
+ * keeps the LAST row of a repeated key, as reading the JSON back would.
+ */
+export declare function serializeStructuredValue(rows: readonly StructuredValueRow[], shape: 'dictionary' | 'collection'): string;
+/** The dictionary keys used more than once, which the editor flags. */
+export declare function duplicateStructuredKeys(rows: readonly StructuredValueRow[]): Set<string>;

package/src/lib/model/structured-value.js

@@ -0,0 +1,135 @@
+/**
+ * @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.
+ */ /**
+ * A dictionary or collection variable, as rows an author fills in rather than
+ * JSON they type (AGL-3757). The stored value is unchanged — the same JSON
+ * string `formatVariableValue` and a function's `name.member` read — so this
+ * module only translates between that string and the rows the editor shows.
+ */ /** What one entry holds; `kept` is a nested value the rows cannot edit. */ function rowFor(key, value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return {
+            key,
+            kind: 'number',
+            value: String(value)
+        };
+    }
+    if (typeof value === 'boolean') {
+        return {
+            key,
+            kind: 'boolean',
+            value: value ? 'true' : 'false'
+        };
+    }
+    if (typeof value === 'string') return {
+        key,
+        kind: 'text',
+        value
+    };
+    if (value === null || value === undefined) {
+        return {
+            key,
+            kind: 'text',
+            value: ''
+        };
+    }
+    return {
+        key,
+        kind: 'kept',
+        value: JSON.stringify(value),
+        kept: value
+    };
+}
+/** The rows a stored dictionary or collection value reads as. */ export function parseStructuredValue(raw, shape) {
+    const text = String(raw != null ? raw : '').trim();
+    if (!text) return {
+        rows: [],
+        unreadable: false
+    };
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    } catch (unused) {
+        return {
+            rows: [],
+            unreadable: true
+        };
+    }
+    if (shape === 'collection') {
+        if (!Array.isArray(parsed)) return {
+            rows: [],
+            unreadable: true
+        };
+        return {
+            rows: parsed.map((item)=>rowFor('', item)),
+            unreadable: false
+        };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            rows: [],
+            unreadable: true
+        };
+    }
+    return {
+        rows: Object.entries(parsed).map(([key, value])=>rowFor(key, value)),
+        unreadable: false
+    };
+}
+/**
+ * One row's stored value. A number box that does not hold a number stores
+ * nothing rather than a string a calculation would then trip over.
+ */ function rowValue(row) {
+    switch(row.kind){
+        case 'number':
+            {
+                const text = row.value.trim();
+                const parsed = Number(text);
+                return text !== '' && Number.isFinite(parsed) ? parsed : null;
+            }
+        case 'boolean':
+            return row.value === 'true';
+        case 'kept':
+            return row.kept;
+        case 'text':
+        default:
+            return row.value;
+    }
+}
+/**
+ * The JSON string rows store as. A dictionary drops rows without a key and
+ * keeps the LAST row of a repeated key, as reading the JSON back would.
+ */ export function serializeStructuredValue(rows, shape) {
+    if (shape === 'collection') return JSON.stringify(rows.map(rowValue));
+    const entries = {};
+    for (const row of rows){
+        const key = row.key.trim();
+        if (key) entries[key] = rowValue(row);
+    }
+    return JSON.stringify(entries);
+}
+/** The dictionary keys used more than once, which the editor flags. */ export function duplicateStructuredKeys(rows) {
+    const seen = new Set();
+    const duplicates = new Set();
+    for (const row of rows){
+        const key = row.key.trim();
+        if (!key) continue;
+        if (seen.has(key)) duplicates.add(key);
+        seen.add(key);
+    }
+    return duplicates;
+}
+
+//# sourceMappingURL=structured-value.js.map

package/src/lib/model/structured-value.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/logic/src/lib/model/structured-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 * A dictionary or collection variable, as rows an author fills in rather than\n * JSON they type (AGL-3757). The stored value is unchanged — the same JSON\n * string `formatVariableValue` and a function's `name.member` read — so this\n * module only translates between that string and the rows the editor shows.\n */\n\n/** What one entry holds; `kept` is a nested value the rows cannot edit. */\nexport type StructuredValueKind = 'text' | 'number' | 'boolean' | 'kept'\n\nexport interface StructuredValueRow {\n  /** The dictionary key; ignored for a collection. */\n  key: string\n  kind: StructuredValueKind\n  /** Text as shown in the box; `'true'`/`'false'` for a true/false entry. */\n  value: string\n  /** The original nested value, carried through untouched for a `kept` row. */\n  kept?: unknown\n}\n\nexport interface ParsedStructuredValue {\n  rows: StructuredValueRow[]\n  /**\n   * True when a stored value could not be read as the expected shape — an\n   * old hand-typed value with a stray comma, or a list stored on a\n   * dictionary. The editor starts from what it could read and says so.\n   */\n  unreadable: boolean\n}\n\nfunction rowFor(key: string, value: unknown): StructuredValueRow {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return { key, kind: 'number', value: String(value) }\n  }\n  if (typeof value === 'boolean') {\n    return { key, kind: 'boolean', value: value ? 'true' : 'false' }\n  }\n  if (typeof value === 'string') return { key, kind: 'text', value }\n  if (value === null || value === undefined) {\n    return { key, kind: 'text', value: '' }\n  }\n  return { key, kind: 'kept', value: JSON.stringify(value), kept: value }\n}\n\n/** The rows a stored dictionary or collection value reads as. */\nexport function parseStructuredValue(\n  raw: string | undefined,\n  shape: 'dictionary' | 'collection',\n): ParsedStructuredValue {\n  const text = String(raw ?? '').trim()\n  if (!text) return { rows: [], unreadable: false }\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(text)\n  } catch {\n    return { rows: [], unreadable: true }\n  }\n  if (shape === 'collection') {\n    if (!Array.isArray(parsed)) return { rows: [], unreadable: true }\n    return { rows: parsed.map((item) => rowFor('', item)), unreadable: false }\n  }\n  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    return { rows: [], unreadable: true }\n  }\n  return {\n    rows: Object.entries(parsed as Record<string, unknown>).map(\n      ([key, value]) => rowFor(key, value),\n    ),\n    unreadable: false,\n  }\n}\n\n/**\n * One row's stored value. A number box that does not hold a number stores\n * nothing rather than a string a calculation would then trip over.\n */\nfunction rowValue(row: StructuredValueRow): unknown {\n  switch (row.kind) {\n    case 'number': {\n      const text = row.value.trim()\n      const parsed = Number(text)\n      return text !== '' && Number.isFinite(parsed) ? parsed : null\n    }\n    case 'boolean':\n      return row.value === 'true'\n    case 'kept':\n      return row.kept\n    case 'text':\n    default:\n      return row.value\n  }\n}\n\n/**\n * The JSON string rows store as. A dictionary drops rows without a key and\n * keeps the LAST row of a repeated key, as reading the JSON back would.\n */\nexport function serializeStructuredValue(\n  rows: readonly StructuredValueRow[],\n  shape: 'dictionary' | 'collection',\n): string {\n  if (shape === 'collection') return JSON.stringify(rows.map(rowValue))\n  const entries: Record<string, unknown> = {}\n  for (const row of rows) {\n    const key = row.key.trim()\n    if (key) entries[key] = rowValue(row)\n  }\n  return JSON.stringify(entries)\n}\n\n/** The dictionary keys used more than once, which the editor flags. */\nexport function duplicateStructuredKeys(\n  rows: readonly StructuredValueRow[],\n): Set<string> {\n  const seen = new Set<string>()\n  const duplicates = new Set<string>()\n  for (const row of rows) {\n    const key = row.key.trim()\n    if (!key) continue\n    if (seen.has(key)) duplicates.add(key)\n    seen.add(key)\n  }\n  return duplicates\n}\n"],"names":["rowFor","key","value","Number","isFinite","kind","String","undefined","JSON","stringify","kept","parseStructuredValue","raw","shape","text","trim","rows","unreadable","parsed","parse","Array","isArray","map","item","Object","entries","rowValue","row","serializeStructuredValue","duplicateStructuredKeys","seen","Set","duplicates","has","add"],"mappings":"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"}