@goplasmatic/datalogic-ui 4.0.20 → 5.0.0

package/README.md

@@ -1,6 +1,17 @@
 # @goplasmatic/datalogic-ui
 
-A React component library for visualizing, debugging, and editing JSONLogic expressions as interactive node-based flow diagrams.
+[![npm](https://img.shields.io/npm/v/@goplasmatic/datalogic-ui)](https://www.npmjs.com/package/@goplasmatic/datalogic-ui)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+A React component library for visualizing, debugging, and editing
+JSONLogic expressions as interactive node-based flow diagrams.
+
+This is the **React surface** of the
+[`datalogic-rs`](https://github.com/GoPlasmatic/datalogic-rs) monorepo.
+It consumes the WASM binding
+([`@goplasmatic/datalogic-wasm`](../bindings/wasm/README.md)) for evaluation
+and tracing — for the engine itself and the cross-runtime overview,
+see the [repo README](https://github.com/GoPlasmatic/datalogic-rs#readme).
 
 ## Features
 
@@ -9,7 +20,7 @@ A React component library for visualizing, debugging, and editing JSONLogic expr
 - Tree-based automatic layout using @dagrejs/dagre
 - 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
-- Structure preserve mode for JSON templates with embedded JSONLogic
+- Templating mode for JSON templates with embedded JSONLogic
 - Built-in WASM-based JSONLogic evaluation with execution tracing
 - Light/dark theme support with system preference detection
 
@@ -98,8 +109,8 @@ Combine editing with live debugging:
 | `data` | `unknown` | - | Data context for evaluation. When provided, debugger controls become available |
 | `theme` | `'light' \| 'dark'` | system | Theme override. If not provided, uses system preference |
 | `className` | `string` | - | Additional CSS class |
-| `preserveStructure` | `boolean` | `false` | Enable structure preserve mode for JSON templates with embedded JSONLogic |
-| `onPreserveStructureChange` | `(value: boolean) => void` | - | Callback when preserve structure changes (from toolbar checkbox) |
+| `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 |
 
 ## Exports
@@ -156,11 +167,18 @@ The component respects the `data-theme` attribute on parent elements for theming
 
 ## 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:
+
 ```bash
-pnpm install      # Install dependencies
-pnpm dev:ui       # Start development server
-pnpm build:ui:lib # Build library for publishing
-pnpm lint:ui      # Run ESLint
+cd ui
+npm install       # install dependencies
+npm run dev       # start the dev playground
+npm run build:lib # build the publishable library bundle
+npm run lint      # run ESLint
 ```
 
 ## Architecture
@@ -183,7 +201,7 @@ The main component is `DataLogicEditor` which:
 
 - **OperatorNode** (UnifiedOperatorNode): Renders all operators with cell-based argument display (and, or, if, var, val, ==, +, etc.)
 - **LiteralNode**: Renders primitive values (strings, numbers, booleans, null)
-- **StructureNode**: Renders JSON objects/arrays in structure preserve mode
+- **StructureNode**: Renders JSON objects/arrays in templating mode
 
 ## Tech Stack
 
@@ -195,18 +213,20 @@ The main component is `DataLogicEditor` which:
 - lucide-react (icons)
 - @msgpack/msgpack (data serialization)
 - fflate (compression)
-- @goplasmatic/datalogic (bundled, for WASM evaluation)
+- @goplasmatic/datalogic-wasm (bundled, for WASM evaluation)
 
 ## Documentation
 
 For complete documentation including all props, customization options, and advanced usage, see the [full documentation](https://goplasmatic.github.io/datalogic-rs/react-ui/installation.html).
 
-## Links
+## Learn more
 
-- [GitHub Repository](https://github.com/GoPlasmatic/datalogic-rs)
-- [Full Documentation](https://goplasmatic.github.io/datalogic-rs/)
-- [Online Playground](https://goplasmatic.github.io/datalogic-rs/playground/)
+- [Repo README](https://github.com/GoPlasmatic/datalogic-rs#readme) — cross-runtime overview, all binding READMEs
+- [WASM binding README](../bindings/wasm/README.md) — `@goplasmatic/datalogic-wasm`, the JS/TS engine this UI consumes
+- [Rust crate README](../crates/datalogic-rs/README.md) — engine design, the 5-tier API model
+- [Full documentation](https://goplasmatic.github.io/datalogic-rs/)
+- [Online playground](https://goplasmatic.github.io/datalogic-rs/playground/)
 
 ## License
 
-MIT
+Apache-2.0

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

@@ -0,0 +1,4 @@
+export declare function AutoFitView({ nodeCount }: {
+    nodeCount: number;
+}): null;
+//# sourceMappingURL=AutoFitView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutoFitView.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/AutoFitView.tsx"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,QAc/D"}

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

@@ -0,0 +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-runtime").JSX.Element;
+export default DataLogicEditor;
+//# sourceMappingURL=DataLogicEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataLogicEditor.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/DataLogicEditor.tsx"],"names":[],"mappings":"AAUA,OAAO,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,SAAS,CAAC;AAmB1E,OAAO,oBAAoB,CAAC;AAC5B,OAAO,mBAAmB,CAAC;AA0R3B,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,2CAgMtB;AAED,eAAe,eAAe,CAAC"}

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

@@ -0,0 +1,9 @@
+interface EditorToolbarProps {
+    isEditMode: boolean;
+    hasDebugger: boolean;
+    templating: boolean;
+    onTemplatingChange?: (value: boolean) => void;
+}
+export declare const EditorToolbar: import('react').MemoExoticComponent<({ isEditMode, hasDebugger, templating, onTemplatingChange, }: EditorToolbarProps) => import("react/jsx-runtime").JSX.Element>;
+export {};
+//# sourceMappingURL=EditorToolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EditorToolbar.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/EditorToolbar.tsx"],"names":[],"mappings":"AAKA,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;CAC/C;AAED,eAAO,MAAM,aAAa,qGAKvB,kBAAkB,6CAwBnB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Keyboard Handler Component
+ *
+ * Handles keyboard shortcuts for the visual editor.
+ * Must be placed inside EditorProvider context.
+ */
+export declare function KeyboardHandler(): null;
+export default KeyboardHandler;
+//# sourceMappingURL=KeyboardHandler.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+/**
+ * NodeSelectionHandler
+ *
+ * Bridges ReactFlow's node selection with our EditorContext.
+ * Must be used inside both ReactFlowProvider and EditorProvider.
+ *
+ * Supports multi-select:
+ * - Click: Single select
+ * - Cmd/Ctrl + Click: Toggle node in selection
+ * - Shift + Click: Add to selection
+ * - Drag box: Multi-select
+ */
+export declare function NodeSelectionHandler(): null;
+//# sourceMappingURL=NodeSelectionHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSelectionHandler.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/NodeSelectionHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,wBAAgB,oBAAoB,SAqCnC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Undo/Redo Toolbar Component
+ *
+ * Inline undo/redo buttons for the editor toolbar.
+ * Only renders when there are actions to undo or redo.
+ */
+export declare const UndoRedoToolbar: import('react').MemoExoticComponent<() => import("react/jsx-runtime").JSX.Element | null>;
+export default UndoRedoToolbar;
+//# sourceMappingURL=UndoRedoToolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UndoRedoToolbar.d.ts","sourceRoot":"","sources":["../../../src/components/logic-editor/UndoRedoToolbar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,eAAe,2FA8B1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

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

@@ -0,0 +1,19 @@
+import { CategoryMeta, OperatorCategory } from './operators.types';
+export declare const categories: Record<OperatorCategory, CategoryMeta>;
+/**
+ * Get category metadata by name
+ */
+export declare function getCategory(name: OperatorCategory): CategoryMeta;
+/**
+ * Get all categories as an array
+ */
+export declare function getAllCategories(): CategoryMeta[];
+/**
+ * Get category icon
+ */
+export declare function getCategoryIcon(name: string): string;
+/**
+ * Get category color
+ */
+export declare function getCategoryColor(name: OperatorCategory): string;
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +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,CA8E7D,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"}

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

@@ -0,0 +1,6 @@
+import { PanelConfig } from './operators.types';
+/**
+ * Panel configuration for editing literal values
+ */
+export declare const literalPanelConfig: PanelConfig;
+//# sourceMappingURL=literalPanel.d.ts.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Arithmetic Operators
+ *
+ * Mathematical operations.
+ * - Basic: +, -, *, /, %
+ * - Aggregate: max, min
+ * - Unary: abs, ceil, floor
+ */
+export declare const arithmeticOperators: {
+    [x: string]: import('../operators.types').Operator;
+};
+//# sourceMappingURL=arithmetic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arithmetic.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/arithmetic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,eAAO,MAAM,mBAAmB;;CAG/B,CAAC"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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,CA2M/D,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Array Operators
+ *
+ * Array operations and iteration.
+ * - Iteration: map, filter, reduce, all, some, none
+ * - Manipulation: merge, sort, slice
+ */
+export declare const arrayOperators: {
+    [x: string]: import('../operators.types').Operator;
+};
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/array.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,cAAc;;CAG1B,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,47 @@
+import { Operator, OperatorCategory } from '../operators.types';
+import { variableOperators } from './variable';
+import { comparisonOperators } from './comparison';
+import { logicalOperators } from './logical';
+import { arithmeticOperators } from './arithmetic';
+import { controlOperators } from './control';
+import { stringOperators } from './string';
+import { arrayOperators } from './array';
+import { datetimeOperators } from './datetime';
+import { validationOperators } from './validation';
+import { errorOperators } from './error';
+import { utilityOperators } from './utility';
+export { variableOperators, comparisonOperators, logicalOperators, arithmeticOperators, controlOperators, stringOperators, arrayOperators, datetimeOperators, validationOperators, errorOperators, utilityOperators, };
+/**
+ * Combined map of all operators by name
+ */
+export declare const operators: Record<string, Operator>;
+/**
+ * Get an operator by its name
+ * @param name - The operator name (e.g., "var", "+", "if")
+ * @returns The operator configuration, or undefined if not found
+ */
+export declare function getOperator(name: string): Operator | undefined;
+/**
+ * Get all operators in a specific category
+ * @param category - The category to filter by
+ * @returns Array of operators in the category
+ */
+export declare function getOperatorsByCategory(category: OperatorCategory): Operator[];
+/**
+ * Check if a string is a valid operator name
+ * @param name - String to check
+ * @returns true if the name is a valid operator
+ */
+export declare function isOperator(name: string): boolean;
+/**
+ * Get operators grouped by category
+ * @returns Map of category to operators
+ */
+export declare function getOperatorsGroupedByCategory(): Map<OperatorCategory, Operator[]>;
+/**
+ * Search operators by name or description
+ * @param query - Search query (case-insensitive)
+ * @returns Array of matching operators
+ */
+export declare function searchOperators(query: string): Operator[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAY9C,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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,16 @@
+/**
+ * String Operators
+ *
+ * Text manipulation operations.
+ * - cat: Concatenate strings
+ * - substr: Extract substring
+ * - in: Check if substring exists
+ * - length: Get string length
+ * - starts_with, ends_with: Check prefix/suffix
+ * - upper, lower, trim: Transform strings
+ * - split: Split string into array
+ */
+export declare const stringOperators: {
+    [x: string]: import('../operators.types').Operator;
+};
+//# sourceMappingURL=string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../../../src/components/logic-editor/config/operators/string.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,eAAe;;CAG3B,CAAC"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,144 @@
+/**
+ * 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' | 'datetime' | 'validation' | 'error' | 'utility';
+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 {
+    name: string;
+    label: string;
+    description?: string;
+    type?: ArgType;
+    required?: boolean;
+    repeatable?: boolean;
+}
+export interface AritySpec {
+    type: ArityType;
+    min?: number;
+    max?: number;
+    args?: ArgSpec[];
+}
+export type ReturnType = 'any' | 'number' | 'string' | 'boolean' | 'array' | 'object' | 'null' | 'datetime' | 'duration' | 'number | string' | 'same' | 'never';
+export interface OperatorExample {
+    title: string;
+    rule: unknown;
+    data?: unknown;
+    result?: unknown;
+    error?: {
+        type: string;
+    };
+    note?: string;
+}
+export interface OperatorHelp {
+    summary: string;
+    details?: string;
+    returnType: ReturnType;
+    examples: OperatorExample[];
+    notes?: string[];
+    seeAlso?: string[];
+}
+export type NodeType = 'operator' | 'variable' | 'literal' | 'decision' | 'vertical' | 'iterator' | 'structure';
+export interface OperatorUIHints {
+    icon?: string;
+    shortLabel?: string;
+    nodeType?: NodeType;
+    inlineEditable?: boolean;
+    showArgLabels?: boolean;
+    collapsible?: boolean;
+    scopeJump?: boolean;
+    metadata?: boolean;
+    datetimeProps?: boolean;
+    iteratorContext?: boolean;
+    addArgumentLabel?: string;
+}
+export interface Operator {
+    name: string;
+    label: string;
+    category: OperatorCategory;
+    description: string;
+    arity: AritySpec;
+    help: OperatorHelp;
+    ui?: OperatorUIHints;
+    panel?: PanelConfig;
+}
+export interface OperatorConfig {
+    version: string;
+    operators: Record<string, Operator>;
+}
+export interface CategoryMeta {
+    name: OperatorCategory;
+    label: string;
+    description: string;
+    color: string;
+    icon: string;
+}
+/**
+ * Input widget types for panel fields
+ */
+export type PanelInputType = 'text' | 'textarea' | 'number' | 'boolean' | 'select' | 'path' | 'pathArray' | 'expression' | 'json';
+/**
+ * Visibility condition for conditional fields
+ */
+export interface VisibilityCondition {
+    field: string;
+    operator: 'equals' | 'notEquals' | 'exists' | 'notExists';
+    value?: unknown;
+}
+/**
+ * Select dropdown option
+ */
+export interface SelectOption {
+    value: string | number | boolean;
+    label: string;
+    description?: string;
+}
+/**
+ * Panel field configuration
+ */
+export interface PanelField {
+    id: string;
+    label: string;
+    inputType: PanelInputType;
+    helpText?: string;
+    placeholder?: string;
+    required?: boolean;
+    defaultValue?: unknown;
+    options?: SelectOption[];
+    showWhen?: VisibilityCondition[];
+    min?: number;
+    max?: number;
+    repeatable?: boolean;
+}
+/**
+ * Panel section grouping
+ */
+export interface PanelSection {
+    id: string;
+    title?: string;
+    fields: PanelField[];
+    defaultCollapsed?: boolean;
+    showWhen?: VisibilityCondition[];
+}
+/**
+ * Iterator context variable
+ */
+export interface ContextVariable {
+    name: string;
+    label: string;
+    description: string;
+    accessor: 'var' | 'val';
+    example: string;
+}
+/**
+ * Complete panel configuration
+ */
+export interface PanelConfig {
+    sections: PanelSection[];
+    contextVariables?: ContextVariable[];
+    chainable?: boolean;
+}
+//# sourceMappingURL=operators.types.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+import { NodeCategory } from '../types';
+export declare const BRANCH_COLORS: {
+    readonly yes: "#22C55E";
+    readonly no: "#EF4444";
+};
+export declare const CATEGORY_COLORS: Record<NodeCategory, string>;
+//# sourceMappingURL=colors.d.ts.map

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

@@ -0,0 +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"}