@goplasmatic/datalogic-ui 5.2.0 → 5.3.0

package/README.md

@@ -16,12 +16,14 @@ see the [repo README](https://github.com/GoPlasmatic/datalogic-rs#readme).
 ## Features
 
 - Visual representation of JSONLogic expressions as flow diagrams
-- Support for all standard JSONLogic operators (logical, comparison, arithmetic, string, array, control flow, datetime, error handling)
-- Tree-based automatic layout using @dagrejs/dagre
+- Every built-in operator the bundled engine accepts (64 canonical operators plus the `var`, `?:` and `match` aliases), across variables, comparison, logical, arithmetic, string, array, object, control flow, datetime, validation, error handling and the flagd feature-flag operators (`fractional`, `sem_ver`)
+- Per-operator help with engine-verified examples and a link to that operator's documentation page
+- Tree-based automatic layout using @dagrejs/dagre, in data-flow or JSON-hierarchy direction
 - Prop-based modes: read-only visualization, debugging with step-through trace, and full visual editing
-- Editing mode with node selection, properties panel, context menus, and undo/redo
+- Editing mode with node selection, properties panel, context menus, an Insert menu (Cmd/Ctrl+K) and undo/redo
 - Templating mode for JSON templates with embedded JSONLogic
-- Built-in WASM-based JSONLogic evaluation with execution tracing
+- Built-in WASM-based JSONLogic evaluation with execution tracing, a step timeline, and failed-node highlighting
+- Engine evaluation settings (`config`) and custom operators (`customOperators`) passed straight through to the engine
 - Light/dark theme support with system preference detection
 
 ## Installation
@@ -35,17 +37,19 @@ npm install @goplasmatic/datalogic-ui @xyflow/react
 ## Quick Start
 
 ```tsx
-import '@xyflow/react/dist/style.css';
 import '@goplasmatic/datalogic-ui/styles.css';
 
-import { DataLogicEditor } from '@goplasmatic/datalogic-ui';
+import { DataLogicEditor, type JsonLogicValue } from '@goplasmatic/datalogic-ui';
 
 function App() {
-  const expression = {
-    "and": [
-      { ">": [{ "var": "age" }, 18] },
-      { "==": [{ "var": "status" }, "active"] }
-    ]
+  // Annotate the expression: TypeScript widens a bare object literal whose
+  // array holds two different operator keys into a union that is not
+  // assignable to JsonLogicValue.
+  const expression: JsonLogicValue = {
+    and: [
+      { '>': [{ var: 'age' }, 18] },
+      { '==': [{ var: 'status' }, 'active'] },
+    ],
   };
 
   return <DataLogicEditor value={expression} />;
@@ -66,7 +70,11 @@ Simply render a JSONLogic expression as a flow diagram:
 
 ### With Debugger
 
-Provide `data` to enable debugger controls with step-through execution trace:
+Provide `data` to enable the debugger toolbar (play/pause, step, jump, and a
+step timeline). As you step, the current node shows its context and result in
+a bubble, executed and on-path nodes are highlighted, and a node on the
+engine's failure breadcrumb is marked with its error. Nodes do not show
+results at rest; step through the trace to see values:
 
 ```tsx
 <DataLogicEditor
@@ -110,8 +118,12 @@ Combine editing with live debugging:
 | `theme` | `'light' \| 'dark'` | system | Theme override. If not provided, uses system preference |
 | `className` | `string` | - | Additional CSS class |
 | `templating` | `boolean` | `false` | Enable templating mode: multi-key objects and arrays compile to output-shaping templates with embedded JSONLogic |
-| `onTemplatingChange` | `(value: boolean) => void` | - | Callback when templating mode changes (from toolbar checkbox) |
-| `editable` | `boolean` | `false` | Enable editing: node selection, properties panel, context menus, undo/redo |
+| `onTemplatingChange` | `(value: boolean) => void` | - | Callback when templating mode changes. The toolbar's Templating checkbox renders only when this is provided |
+| `config` | `DataLogicEvaluationConfig` | - | Engine evaluation settings (preset, NaN and division-by-zero handling, truthiness, numeric coercion, recursion cap). Applied to both the result and the trace |
+| `customOperators` | `Record<string, (args: unknown[]) => unknown>` | - | Custom operators registered on the engine. Rules using them evaluate and trace normally; their nodes render with the generic "utility" styling |
+| `editable` | `boolean` | `false` | Enable editing: node selection, properties panel, context menus, Insert menu, undo/redo |
+| `exampleSuggestions` | `string[]` | - | Example names shown as quick-action chips in the empty state. Chips render only when `onSelectExample` is also provided |
+| `onSelectExample` | `(name: string) => void` | - | Called with the example name when a user clicks an empty-state chip |
 
 ## Exports
 
@@ -126,16 +138,27 @@ import { DataLogicEditor } from '@goplasmatic/datalogic-ui';
 ```tsx
 import type {
   DataLogicEditorProps,
+  DataLogicEvaluationConfig,
+  DataLogicCustomOperator,
   JsonLogicValue,
+  JsonLogicToNodesOptions,
   LogicNode,
   LogicEdge,
   LogicNodeData,
   OperatorNodeData,
   VariableNodeData,
   LiteralNodeData,
+  StructureNodeData,
+  StructureElement,
+  CellData,
+  ConversionResult,
   NodeEvaluationResult,
   EvaluationResultsMap,
+  StructuredError,
+  TracedResult,
   OperatorCategory,
+  FlowDirection,
+  IconName,
 } from '@goplasmatic/datalogic-ui';
 ```
 
@@ -145,42 +168,148 @@ import type {
 import { OPERATORS, CATEGORY_COLORS } from '@goplasmatic/datalogic-ui';
 ```
 
-### Utilities (for advanced use)
+`OPERATORS` is the operator registry keyed by name: label, category, arity,
+panel configuration, and help (summary, return type, notes, and examples that
+are checked against the engine in this package's test suite). `CATEGORY_COLORS`
+is a per-category palette for consumer-side legends and custom renderers; the
+shipped nodes are coloured by the value type they produce, through the
+`--sig-*` tokens (see Styling).
+
+### Utilities and hooks (for advanced use)
 
 ```tsx
-import { jsonLogicToNodes, applyTreeLayout } from '@goplasmatic/datalogic-ui';
+import {
+  jsonLogicToNodes,
+  applyTreeLayout,
+  useWasmEvaluator,
+  DataLogicEvaluationError,
+  summarizeEvaluationConfig,
+  isDefaultEvaluationConfig,
+} from '@goplasmatic/datalogic-ui';
 ```
 
-## Styling
+- `jsonLogicToNodes(value, options?)` converts an expression into
+  `{ nodes, edges, rootId }`.
+- `applyTreeLayout(nodes, edges?, direction?)` positions them with dagre.
+  `direction` is `'flow'` (default: sources on the left, result on the right)
+  or `'hierarchy'` (root on the left, JSON nesting order).
+- `useWasmEvaluator({ templating, config, customOperators })` is the same
+  engine hook the component uses: it returns `{ ready, loading, error,
+  evaluate, evaluateWithTrace }`.
+- `DataLogicEvaluationError` carries the engine's structured error on
+  `.structured` (`type`, `message`, and, where the engine provides them,
+  `operator`, `node_ids`, `thrown`, `variable`, `index`, `length`, `stage`).
 
-The component requires two CSS imports:
+### Engine settings and custom operators
 
 ```tsx
-// React Flow base styles
-import '@xyflow/react/dist/style.css';
+<DataLogicEditor
+  value={expression}
+  data={data}
+  config={{ preset: 'strict', division_by_zero: 'return_null' }}
+  customOperators={{ double: (args) => Number(args[0]) * 2 }}
+/>
+```
+
+`config` mirrors the engine's `EvaluationConfig`: `preset`
+(`'default' | 'safe_arithmetic' | 'strict'`), `arithmetic_nan_handling`,
+`division_by_zero`, `loose_equality_errors`, `truthy_evaluator`,
+`numeric_coercion` (`empty_string_to_zero`, `null_to_zero`, `bool_to_number`,
+`reject_non_numeric`) and `max_recursion_depth`. Every key is optional and
+omitted keys keep the engine default. Changing `config` or `customOperators`
+rebuilds the engine, so selection and undo history reset.
 
-// DataLogicEditor styles
+A custom operator receives the already-evaluated arguments and returns any
+JSON-serializable value (`undefined` becomes `null`); a thrown exception
+becomes a runtime evaluation error.
+
+## Styling
+
+One CSS import is all you need. React Flow's base styles are bundled into
+`styles.css`, so there is no separate `@xyflow/react/dist/style.css` import
+and no import-order requirement:
+
+```tsx
 import '@goplasmatic/datalogic-ui/styles.css';
 ```
 
-The component respects the `data-theme` attribute on parent elements for theming, or you can override with the `theme` prop.
+The component sets `data-theme` on its own `.logic-editor` root from the
+`theme` prop, falling back to the system preference. It does not read
+`data-theme` from ancestor elements: pass the `theme` prop to force a theme.
+
+Every design decision is a CSS custom property scoped to `.logic-editor`, so
+overrides never leak into the host app. The primary axis is the signal
+palette (`--sig-bool-true`, `--sig-bool-false`, `--sig-bool-rest`,
+`--sig-number`, `--sig-string`, `--sig-collection`, `--sig-data`,
+`--sig-temporal`, `--sig-null`, each with a `-bg` variant): a node is
+coloured by the type of value it produces. The neutral substrate is
+`--board`, `--surface`, `--chip`, `--hairline`, `--ink`, `--muted`, and
+`--accent` is reserved for selection, root and focus.
+
+```css
+.logic-editor {
+  --sig-number: #0ea5e9;
+  --font-ui: 'Inter', sans-serif;
+}
+.logic-editor[data-theme="dark"] {
+  --board: #0b0b0f;
+}
+```
+
+The default `--font-ui` / `--font-mono` stacks name Space Grotesk and
+JetBrains Mono but the package does not ship them; either install
+`@fontsource/space-grotesk` and `@fontsource/jetbrains-mono` yourself or
+override the two tokens. See
+[Customization](https://goplasmatic.github.io/datalogic-rs/react-ui/customization.html)
+for the full token list.
 
 ## Development
 
 This package lives at `ui/` in the
-[datalogic-rs monorepo](https://github.com/GoPlasmatic/datalogic-rs). It
-depends on a locally-built `@goplasmatic/datalogic-wasm` WASM bundle — see
-[DEVELOPMENT.md](https://github.com/GoPlasmatic/datalogic-rs/blob/main/DEVELOPMENT.md)
-for the full link/install dance. Day-to-day, from the repo root:
+[datalogic-rs monorepo](https://github.com/GoPlasmatic/datalogic-rs) and
+bundles the WASM engine into its own output. It builds against the WASM
+package vendored from the repo, not against a registry download: build the
+WASM once, and the `predev` / `prebuild*` hooks copy `bindings/wasm/pkg` into
+`ui/vendor/datalogic` on every run (`npm run sync-wasm`).
 
 ```bash
-cd ui
+cd bindings/wasm && ./build.sh   # once, and after any engine change
+cd ../../ui
 npm install       # install dependencies
-npm run dev       # start the dev playground
-npm run build:lib # build the publishable library bundle
+npm run dev       # start the dev playground (Studio)
+npm test          # vitest: round trips, operator help, trace, samples
 npm run lint      # run ESLint
+npm run build:lib # build the publishable library bundle
+npm run build:embed # build the docs-site embed bundle
 ```
 
+`@goplasmatic/datalogic-wasm` is a devDependency pinned to the last published
+release. Nothing in the build resolves it (Vite and the tsconfigs alias the
+package to `vendor/datalogic`); the release workflow rewrites the pin to the
+version being published. See
+[DEVELOPMENT.md](https://github.com/GoPlasmatic/datalogic-rs/blob/main/DEVELOPMENT.md)
+for the repo-wide pipeline.
+
+### Tests
+
+`npm test` runs vitest against the vendored engine, so the checks are real
+evaluations rather than fixtures:
+
+- **Operator registry and help** (`config/__tests__`): every registry entry
+  matches `builtinOperatorNames()` from the engine, and every help example is
+  evaluated and compared to its documented result.
+- **Round trips** (`utils/__tests__`): a corpus covering every operator plus
+  the shipped samples must survive `jsonLogicToNodes` to `nodesToJsonLogic`
+  unchanged and evaluate identically.
+- **Trace** (`utils/trace/__tests__`): real `evaluateWithTrace` envelopes must
+  map onto the diagram with no synthetic nodes.
+- **Samples, sharing, menus, evaluator** (`tests/`): each sample evaluates to
+  its stored expected result, share URLs round trip, and every operator is
+  reachable from the menus.
+
+When you add an operator config example or a sample, give it the result the
+engine actually produces; the suites will tell you if it drifts.
+
 ## Architecture
 
 The main component is `DataLogicEditor` which:
@@ -211,9 +340,11 @@ The main component is `DataLogicEditor` which:
 - React Flow (@xyflow/react)
 - @dagrejs/dagre (graph layout)
 - lucide-react (icons)
-- @msgpack/msgpack (data serialization)
-- fflate (compression)
-- @goplasmatic/datalogic-wasm (bundled, for WASM evaluation)
+- @goplasmatic/datalogic-wasm (bundled into the library output)
+
+The dev playground additionally uses @msgpack/msgpack and fflate for share
+links and @fontsource for its fonts; those are devDependencies and are not
+installed by consumers.
 
 ## Documentation
 

package/dist/components/logic-editor/DataLogicEditor.d.ts

@@ -1,4 +1,4 @@
 import { DataLogicEditorProps } from './types';
-export declare function DataLogicEditor({ value, onChange, data, theme: themeProp, className, templating, onTemplatingChange, editable, exampleSuggestions, onSelectExample, }: DataLogicEditorProps): import("react").JSX.Element;
+export declare function DataLogicEditor({ value, onChange, data, theme: themeProp, className, templating, onTemplatingChange, config, customOperators, editable, exampleSuggestions, onSelectExample, }: DataLogicEditorProps): import("react").JSX.Element;
 export default DataLogicEditor;
 //# sourceMappingURL=DataLogicEditor.d.ts.map

package/dist/components/logic-editor/DataLogicEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataLogicEditor.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/DataLogicEditor.tsx"],"names":[],"mappings":"AAWA,OAAO,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,SAAS,CAAC;AAmB1E,OAAO,oBAAoB,CAAC;AAC5B,OAAO,mBAAmB,CAAC;AAuS3B,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,SAAc,EACd,UAAkB,EAClB,kBAAkB,EAClB,QAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,EAAE,oBAAoB,+BAiNtB;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DataLogicEditor.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/DataLogicEditor.tsx"],"names":[],"mappings":"AAWA,OAAO,6BAA6B,CAAC;AAErC,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,SAAS,CAAC;AAqBjB,OAAO,oBAAoB,CAAC;AAC5B,OAAO,mBAAmB,CAAC;AA8hB3B,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,SAAc,EACd,UAAkB,EAClB,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,QAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,EAAE,oBAAoB,+BA6CtB;AAED,eAAe,eAAe,CAAC"}

package/dist/components/logic-editor/EditorToolbar.d.ts

@@ -6,7 +6,14 @@ interface EditorToolbarProps {
     onTemplatingChange?: (value: boolean) => void;
     direction: FlowDirection;
     onDirectionChange?: (value: FlowDirection) => void;
+    /**
+     * One-line summary of the non-default engine settings in effect
+     * (see `summarizeEvaluationConfig`). Renders a compact indicator when set.
+     */
+    configSummary?: string | null;
+    /** Makes the engine-settings indicator clickable. */
+    onOpenEngineSettings?: () => void;
 }
-export declare const EditorToolbar: import('react').MemoExoticComponent<({ isEditMode, hasDebugger, templating, onTemplatingChange, direction, onDirectionChange, }: EditorToolbarProps) => import("react").JSX.Element>;
+export declare const EditorToolbar: import('react').MemoExoticComponent<({ isEditMode, hasDebugger, templating, onTemplatingChange, direction, onDirectionChange, configSummary, onOpenEngineSettings, }: EditorToolbarProps) => import("react").JSX.Element>;
 export {};
 //# sourceMappingURL=EditorToolbar.d.ts.map

package/dist/components/logic-editor/EditorToolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorToolbar.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/EditorToolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,UAAU,kBAAkB;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,SAAS,EAAE,aAAa,CAAC;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,aAAa,mIAOvB,kBAAkB,iCAqDnB,CAAC"}
+{"version":3,"file":"EditorToolbar.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/EditorToolbar.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO/C,UAAU,kBAAkB;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,SAAS,EAAE,aAAa,CAAC;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC;AAsKD,eAAO,MAAM,aAAa,wKASvB,kBAAkB,iCA0EnB,CAAC"}

package/dist/components/logic-editor/KeyboardHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyboardHandler.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/KeyboardHandler.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wBAAgB,eAAe,SA6G9B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"KeyboardHandler.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/KeyboardHandler.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wBAAgB,eAAe,SAuH9B;AAED,eAAe,eAAe,CAAC"}

package/dist/components/logic-editor/config/arity.d.ts

@@ -0,0 +1,3 @@
+import { AritySpec } from './operators.types';
+export declare function formatArity(arity: AritySpec): string;
+//# sourceMappingURL=arity.d.ts.map

package/dist/components/logic-editor/config/arity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arity.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/arity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAenD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAyBpD"}

package/dist/components/logic-editor/config/categories.d.ts

@@ -1,4 +1,5 @@
 import { CategoryMeta, OperatorCategory } from './operators.types';
+import { IconName } from '../utils/icons';
 export declare const categories: Record<OperatorCategory, CategoryMeta>;
 /**
  * Get category metadata by name
@@ -9,11 +10,15 @@ export declare function getCategory(name: OperatorCategory): CategoryMeta;
  */
 export declare function getAllCategories(): CategoryMeta[];
 /**
- * Get category icon
+ * Get category icon (falls back to 'list' for unknown categories)
  */
-export declare function getCategoryIcon(name: string): string;
+export declare function getCategoryIcon(name: string): IconName;
 /**
  * Get category color
  */
 export declare function getCategoryColor(name: OperatorCategory): string;
+/**
+ * Get the docs page slug for a category
+ */
+export declare function getCategoryDocsPage(name: OperatorCategory): string;
 //# sourceMappingURL=categories.d.ts.map

package/dist/components/logic-editor/config/categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/categories.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAqF7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE/D"}
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,YAAY,CA0G7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAElE"}

package/dist/components/logic-editor/config/docs.d.ts

@@ -0,0 +1,11 @@
+import { Operator, OperatorCategory } from './operators.types';
+export declare const DOCS_BASE_URL = "https://goplasmatic.github.io/datalogic-rs/operators/";
+/** mdBook's heading-id normalisation. */
+export declare function mdBookAnchor(heading: string): string;
+/** Anchor for an operator's section on its docs page. */
+export declare function getOperatorDocsAnchor(name: string): string;
+/** Full URL of an operator's documentation section. */
+export declare function getOperatorDocsUrl(name: string, category: OperatorCategory): string;
+/** Convenience overload for a full operator config. */
+export declare function getDocsUrlForOperator(op: Operator): string;
+//# sourceMappingURL=docs.d.ts.map

package/dist/components/logic-editor/config/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGpE,eAAO,MAAM,aAAa,0DAA0D,CAAC;AAyBrF,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEnF;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAE1D"}

package/dist/components/logic-editor/config/literalPanel.d.ts

@@ -3,4 +3,8 @@ import { PanelConfig } from './operators.types';
  * Panel configuration for editing literal values
  */
 export declare const literalPanelConfig: PanelConfig;
+/**
+ * Panel configuration for structure (array / object) nodes
+ */
+export declare const structurePanelConfig: PanelConfig;
 //# sourceMappingURL=literalPanel.d.ts.map

package/dist/components/logic-editor/config/literalPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"literalPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/literalPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WA+FhC,CAAC"}
+{"version":3,"file":"literalPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/literalPanel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AA4GjF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAEhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC"}

package/dist/components/logic-editor/config/operators/arithmetic-basic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arithmetic-basic.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/arithmetic-basic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAsR7D,CAAC"}
+{"version":3,"file":"arithmetic-basic.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/arithmetic-basic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuV7D,CAAC"}

package/dist/components/logic-editor/config/operators/arithmetic-functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arithmetic-functions.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/arithmetic-functions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAgQhE,CAAC"}
+{"version":3,"file":"arithmetic-functions.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/arithmetic-functions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmShE,CAAC"}

package/dist/components/logic-editor/config/operators/array-iteration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-iteration.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/array-iteration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAssB5D,CAAC"}
+{"version":3,"file":"array-iteration.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/array-iteration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA4sB5D,CAAC"}

package/dist/components/logic-editor/config/operators/array-manipulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-manipulation.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/array-manipulation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAsU/D,CAAC"}
+{"version":3,"file":"array-manipulation.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/array-manipulation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAsY/D,CAAC"}

package/dist/components/logic-editor/config/operators/array.d.ts

@@ -3,7 +3,7 @@
  *
  * Array operations and iteration.
  * - Iteration: map, filter, reduce, all, some, none
- * - Manipulation: merge, sort, slice
+ * - Manipulation: merge, sort, slice, group_by, distinct
  */
 export declare const arrayOperators: {
     [x: string]: import('../operators.types').Operator;

package/dist/components/logic-editor/config/operators/control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/control.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmkBrD,CAAC"}
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/control.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA2kBrD,CAAC"}

package/dist/components/logic-editor/config/operators/datetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/datetime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA0YtD,CAAC"}
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/datetime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAyetD,CAAC"}

package/dist/components/logic-editor/config/operators/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA8JnD,CAAC"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAyLnD,CAAC"}

package/dist/components/logic-editor/config/operators/flagd.d.ts

@@ -0,0 +1,3 @@
+import { Operator } from '../operators.types';
+export declare const flagdOperators: Record<string, Operator>;
+//# sourceMappingURL=flagd.d.ts.map

package/dist/components/logic-editor/config/operators/flagd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagd.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/flagd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA4MnD,CAAC"}

package/dist/components/logic-editor/config/operators/index.d.ts

@@ -11,7 +11,8 @@ import { datetimeOperators } from './datetime';
 import { validationOperators } from './validation';
 import { errorOperators } from './error';
 import { utilityOperators } from './utility';
-export { variableOperators, comparisonOperators, logicalOperators, arithmeticOperators, controlOperators, stringOperators, arrayOperators, objectOperators, datetimeOperators, validationOperators, errorOperators, utilityOperators, };
+import { flagdOperators } from './flagd';
+export { variableOperators, comparisonOperators, logicalOperators, arithmeticOperators, controlOperators, stringOperators, arrayOperators, objectOperators, datetimeOperators, validationOperators, errorOperators, utilityOperators, flagdOperators, };
 /**
  * Combined map of all operators by name
  */

package/dist/components/logic-editor/config/operators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAa9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,GAAG,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAUjF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CASzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAc9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,GAAG,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAUjF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CASzD"}

package/dist/components/logic-editor/config/operators/logical.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logical.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/logical.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA8SrD,CAAC"}
+{"version":3,"file":"logical.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/logical.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAyTrD,CAAC"}

package/dist/components/logic-editor/config/operators/string-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-core.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/string-core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmMxD,CAAC"}
+{"version":3,"file":"string-core.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/string-core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuNxD,CAAC"}

package/dist/components/logic-editor/config/operators/string-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-transform.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/string-transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA4U7D,CAAC"}
+{"version":3,"file":"string-transform.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/string-transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA0V7D,CAAC"}

package/dist/components/logic-editor/config/operators/utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA0FrD,CAAC"}
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqGrD,CAAC"}

package/dist/components/logic-editor/config/operators/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmJxD,CAAC"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA0JxD,CAAC"}

package/dist/components/logic-editor/config/operators/variable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variable.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/variable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAwXtD,CAAC"}
+{"version":3,"file":"variable.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/variable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqZtD,CAAC"}

package/dist/components/logic-editor/config/operators.types.d.ts

@@ -1,11 +1,5 @@
-/**
- * Operator Configuration Types
- *
- * This file defines the TypeScript interfaces for the operator configuration
- * that serves as the single source of truth for all operator documentation
- * and UI rendering.
- */
-export type OperatorCategory = 'variable' | 'comparison' | 'logical' | 'arithmetic' | 'control' | 'string' | 'array' | 'object' | 'datetime' | 'validation' | 'error' | 'utility';
+import { IconName } from '../utils/icons';
+export type OperatorCategory = 'variable' | 'comparison' | 'logical' | 'arithmetic' | 'control' | 'string' | 'array' | 'object' | 'datetime' | 'validation' | 'error' | 'utility' | 'flagd';
 export type ArityType = 'nullary' | 'unary' | 'binary' | 'ternary' | 'nary' | 'variadic' | 'chainable' | 'range' | 'special';
 export type ArgType = 'any' | 'number' | 'string' | 'boolean' | 'array' | 'object' | 'expression' | 'path' | 'datetime' | 'duration';
 export interface ArgSpec {
@@ -27,11 +21,16 @@ export interface OperatorExample {
     title: string;
     rule: unknown;
     data?: unknown;
+    /** Expected engine result. Omit (together with `error`) only for
+     *  non-deterministic rules such as `now`, and say why in `note`. */
     result?: unknown;
+    /** Expected structured error `type` (e.g. "Thrown", "InvalidArguments"). */
     error?: {
         type: string;
     };
     note?: string;
+    /** Evaluate in templating mode (multi-key object literals only parse there). */
+    templating?: boolean;
 }
 export interface OperatorHelp {
     summary: string;
@@ -43,7 +42,8 @@ export interface OperatorHelp {
 }
 export type NodeType = 'operator' | 'variable' | 'literal' | 'decision' | 'vertical' | 'iterator' | 'structure';
 export interface OperatorUIHints {
-    icon?: string;
+    /** Icon shown in the help header; falls back to the category icon. */
+    icon?: IconName;
     shortLabel?: string;
     nodeType?: NodeType;
     inlineEditable?: boolean;
@@ -51,7 +51,6 @@ export interface OperatorUIHints {
     collapsible?: boolean;
     scopeJump?: boolean;
     metadata?: boolean;
-    datetimeProps?: boolean;
     iteratorContext?: boolean;
     addArgumentLabel?: string;
 }
@@ -74,7 +73,10 @@ export interface CategoryMeta {
     label: string;
     description: string;
     color: string;
-    icon: string;
+    /** Node/help icon; must be a registered IconName so it can always render. */
+    icon: IconName;
+    /** Page slug under https://goplasmatic.github.io/datalogic-rs/operators/ */
+    docsPage: string;
 }
 /**
  * Input widget types for panel fields

package/dist/components/logic-editor/config/operators.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operators.types.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/operators.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operators.types.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/config/operators.types.ts"],"names":[],"mappings":"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"}

package/dist/components/logic-editor/constants/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/constants/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAaxD,CAAC"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../../src/components/logic-editor/constants/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAexD,CAAC"}