@yurikilian/lex4 0.1.2 → 0.2.0

package/dist/types/editor-handle.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Base imperative handle exposed by Lex4Editor via React ref.
+ *
+ * This is always empty — all methods are contributed by extensions.
+ * The actual handle type is dynamic based on which extensions are loaded.
+ *
+ * Common extension-provided methods:
+ * - astExtension: getDocumentAst(), getDocumentJson(), buildSavePayload()
+ * - variablesExtension: insertVariable(), refreshVariables()
+ */
+export interface Lex4EditorHandle {
+    [key: string]: (...args: any[]) => any;
+}
+//# sourceMappingURL=editor-handle.d.ts.map

package/dist/types/editor-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-handle.d.ts","sourceRoot":"","sources":["../../src/types/editor-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAE/B,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACxC"}

package/dist/types/editor-props.d.ts

@@ -1,4 +1,10 @@
 import { Lex4Document } from './document';
+import { Lex4Extension } from '../extensions/types';
+import { DocumentAst } from '../ast/types';
+import { Lex4Translations } from '../i18n/types';
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
 /** Public props for the Lex4Editor component */
 export interface Lex4EditorProps {
     /** Initial document state. Defaults to a single empty page. */
@@ -13,7 +19,24 @@ export interface Lex4EditorProps {
     readOnly?: boolean;
     /** Capture undo/redo shortcuts at the window level, even when focus is outside the document. Defaults to true. */
     captureHistoryShortcutsOnWindow?: boolean;
+    /** Called when the user triggers save/export. Provides both the AST and its JSON serialization. */
+    onSave?: (payload: {
+        ast: DocumentAst;
+        json: string;
+    }) => void;
+    /**
+     * Extensions to load into the editor.
+     * Each extension can contribute nodes, plugins, toolbar items, side panels, and imperative handle methods.
+     * @example extensions={[defaultTheme(), astExtension(), variablesExtension(defs)]}
+     */
+    extensions?: Lex4Extension[];
+    /**
+     * Translation overrides for i18n. Partial overrides are deep-merged with defaults (English).
+     * @example translations={{ toolbar: { undo: 'Desfazer' } }}
+     */
+    translations?: DeepPartial<Lex4Translations>;
     /** Additional CSS class for the editor root element */
     className?: string;
 }
+export {};
 //# sourceMappingURL=editor-props.d.ts.map

package/dist/types/editor-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-props.d.ts","sourceRoot":"","sources":["../../src/types/editor-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAElD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,kHAAkH;IAClH,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAE1C,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"editor-props.d.ts","sourceRoot":"","sources":["../../src/types/editor-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,KAAK,WAAW,CAAC,CAAC,IAAI;KACnB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAElD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,kHAAkH;IAClH,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAE1C,mGAAmG;IACnG,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE/D;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAE7C,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/variables/index.d.ts

@@ -0,0 +1,5 @@
+export type { VariableDefinition, VariableContextValue } from './types';
+export { VariableNode, $createVariableNode, $isVariableNode, type SerializedVariableNode, } from './variable-node';
+export { INSERT_VARIABLE_COMMAND, insertVariable, } from './variable-commands';
+export { VariablePlugin } from './variable-plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/variables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/variables/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/variables/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Variable system types.
+ *
+ * These types define the variable catalog, definitions,
+ * and source interface used by the editor UI and serializer.
+ */
+/** Describes a single variable that can be inserted into the document. */
+export interface VariableDefinition {
+    /** Dot-notation key, e.g. "customer.name" */
+    key: string;
+    /** Human-readable label shown in the picker */
+    label: string;
+    /** Optional description for tooltips */
+    description?: string;
+    /** Expected runtime value type */
+    valueType?: 'string' | 'number' | 'date' | 'boolean';
+    /** Grouping key for the picker UI, e.g. "Customer", "Proposal" */
+    group?: string;
+}
+/** Context value exposed by the VariableProvider. */
+export interface VariableContextValue {
+    definitions: VariableDefinition[];
+    getDefinition(key: string): VariableDefinition | undefined;
+    refreshDefinitions(newDefs: VariableDefinition[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/variables/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/variables/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC3D,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;CACzD"}

package/dist/variables/variable-commands.d.ts

@@ -0,0 +1,11 @@
+import { LexicalEditor } from 'lexical';
+/**
+ * Command to insert a variable node at the current selection.
+ * Payload is the variable key string (e.g. "customer.name").
+ */
+export declare const INSERT_VARIABLE_COMMAND: import('lexical').LexicalCommand<string>;
+/**
+ * Inserts a variable node at the current cursor position.
+ */
+export declare function insertVariable(editor: LexicalEditor, variableKey: string): void;
+//# sourceMappingURL=variable-commands.d.ts.map

package/dist/variables/variable-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-commands.d.ts","sourceRoot":"","sources":["../../src/variables/variable-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,uBAAuB,0CAA2C,CAAC;AAEhF;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAE/E"}

package/dist/variables/variable-context.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { VariableDefinition, VariableContextValue } from './types';
+interface VariableProviderProps {
+    initialDefinitions?: VariableDefinition[];
+    children: React.ReactNode;
+}
+/**
+ * VariableProvider — Manages the variable catalog.
+ *
+ * Host apps provide variable definitions via props.
+ * The picker reads from this context. Definitions can be refreshed
+ * at runtime without re-mounting the editor.
+ */
+export declare const VariableProvider: React.FC<VariableProviderProps>;
+/**
+ * Hook to access the variable catalog from within the editor tree.
+ * Returns empty defaults when called outside a VariableProvider.
+ */
+export declare function useVariables(): VariableContextValue;
+export {};
+//# sourceMappingURL=variable-context.d.ts.map

package/dist/variables/variable-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-context.d.ts","sourceRoot":"","sources":["../../src/variables/variable-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoE,MAAM,OAAO,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAUxE,UAAU,qBAAqB;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA2B5D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,IAAI,oBAAoB,CAEnD"}

package/dist/variables/variable-node.d.ts

@@ -0,0 +1,34 @@
+import { DecoratorNode, DOMConversionMap, DOMExportOutput, LexicalNode, NodeKey, SerializedLexicalNode, Spread } from 'lexical';
+export type SerializedVariableNode = Spread<{
+    variableKey: string;
+}, SerializedLexicalNode>;
+/**
+ * VariableNode — a custom Lexical DecoratorNode that represents
+ * a document variable/placeholder (e.g. "customer.name").
+ *
+ * Variables are atomic, non-editable inline tokens that:
+ * - Display as styled chips in the editor
+ * - Serialize to a structured node in JSON (not plain text)
+ * - Participate in copy/paste, undo/redo, and overflow
+ * - Return {{key}} as text content for clipboard
+ */
+export declare class VariableNode extends DecoratorNode<JSX.Element> {
+    __variableKey: string;
+    static getType(): string;
+    static clone(node: VariableNode): VariableNode;
+    constructor(variableKey: string, key?: NodeKey);
+    getVariableKey(): string;
+    static importJSON(serializedNode: SerializedVariableNode): VariableNode;
+    exportJSON(): SerializedVariableNode;
+    createDOM(): HTMLElement;
+    updateDOM(): false;
+    exportDOM(): DOMExportOutput;
+    static importDOM(): DOMConversionMap | null;
+    isInline(): boolean;
+    isKeyboardSelectable(): boolean;
+    getTextContent(): string;
+    decorate(): JSX.Element;
+}
+export declare function $createVariableNode(variableKey: string): VariableNode;
+export declare function $isVariableNode(node: LexicalNode | null | undefined): node is VariableNode;
+//# sourceMappingURL=variable-node.d.ts.map

package/dist/variables/variable-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-node.d.ts","sourceRoot":"","sources":["../../src/variables/variable-node.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACZ,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EACvB,qBAAqB,CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;gBAIlC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO;IAK9C,cAAc,IAAI,MAAM;IAMxB,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,sBAAsB,GAAG,YAAY;IAIvE,UAAU,IAAI,sBAAsB;IAUpC,SAAS,IAAI,WAAW;IASxB,SAAS,IAAI,KAAK;IAIlB,SAAS,IAAI,eAAe;IAO5B,MAAM,CAAC,SAAS,IAAI,gBAAgB,GAAG,IAAI;IAM3C,QAAQ,IAAI,OAAO;IAInB,oBAAoB,IAAI,OAAO;IAI/B,cAAc,IAAI,MAAM;IAMxB,QAAQ,IAAI,GAAG,CAAC,OAAO;CAaxB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAErE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACnC,IAAI,IAAI,YAAY,CAEtB"}

package/dist/variables/variable-plugin.d.ts

@@ -0,0 +1,8 @@
+/**
+ * VariablePlugin — registers the INSERT_VARIABLE_COMMAND handler.
+ *
+ * When the command fires, a VariableNode is created and inserted
+ * at the current selection position.
+ */
+export declare const VariablePlugin: React.FC;
+//# sourceMappingURL=variable-plugin.d.ts.map

package/dist/variables/variable-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-plugin.d.ts","sourceRoot":"","sources":["../../src/variables/variable-plugin.tsx"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAqBlC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yurikilian/lex4",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",