@yurikilian/lex4 0.1.2 → 0.2.1

package/dist/components/PageBody.d.ts

@@ -18,8 +18,7 @@ interface PageBodyProps {
  * Each page gets its own Lexical editor. The OverflowPlugin
  * handles splitting content when it exceeds the available height.
  *
- * When created with initialBodyState (e.g. from overflow), the
- * LexicalComposer is initialized with that content.
+ * Extension-contributed body plugins are rendered inside the LexicalComposer.
  */
 export declare const PageBody: React.FC<PageBodyProps>;
 export {};

package/dist/components/PageBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageBody.d.ts","sourceRoot":"","sources":["../../src/components/PageBody.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAQ/D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAalE,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsBD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA6F5C,CAAC"}
+{"version":3,"file":"PageBody.d.ts","sourceRoot":"","sources":["../../src/components/PageBody.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAQ/D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAclE,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsBD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAiG5C,CAAC"}

package/dist/components/PageFooter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageFooter.d.ts","sourceRoot":"","sources":["../../src/components/PageFooter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAM5D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AASlE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA8EhD,CAAC"}
+{"version":3,"file":"PageFooter.d.ts","sourceRoot":"","sources":["../../src/components/PageFooter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAM5D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWlE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgFhD,CAAC"}

package/dist/components/PageHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../src/components/PageHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAM5D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AASlE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA8EhD,CAAC"}
+{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../src/components/PageHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAM5D,OAAO,KAAK,EAAe,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWlE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgFhD,CAAC"}

package/dist/components/Toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../src/components/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AA6B3C,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAmU3B,CAAC"}
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../src/components/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAgC3C,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAsW3B,CAAC"}

package/dist/components/VariablePanel.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+/**
+ * VariablePanel — Right sidebar for browsing and inserting variables.
+ *
+ * Features:
+ * - Search/filter variables by name or key
+ * - Grouped list with colored badges
+ * - Click-to-insert into the active editor
+ * - Refresh button for reloading definitions
+ */
+export declare const VariablePanel: React.FC<{
+    open: boolean;
+    onClose: () => void;
+}>;
+//# sourceMappingURL=VariablePanel.d.ts.map

package/dist/components/VariablePanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariablePanel.d.ts","sourceRoot":"","sources":["../../src/components/VariablePanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAS9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA2GA,CAAC"}

package/dist/components/VariablePicker.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+interface VariablePickerProps {
+    onInsert: (variableKey: string) => void;
+    disabled?: boolean;
+}
+/**
+ * VariablePicker — Dropdown UI for browsing and inserting variables.
+ *
+ * Groups variables by their `group` field and allows filtering by name.
+ * Clicking a variable calls `onInsert` with its key.
+ */
+export declare const VariablePicker: React.FC<VariablePickerProps>;
+export {};
+//# sourceMappingURL=VariablePicker.d.ts.map

package/dist/components/VariablePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariablePicker.d.ts","sourceRoot":"","sources":["../../src/components/VariablePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAIjF,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+GxD,CAAC"}

package/dist/extensions/ast-extension.d.ts

@@ -0,0 +1,16 @@
+import { Lex4Extension } from './types';
+/**
+ * Creates an AST extension that adds document export capabilities.
+ *
+ * Handle methods provided:
+ * - `getDocumentAst()` — returns the current document as a typed AST
+ * - `getDocumentJson()` — returns the AST as a JSON string
+ * - `buildSavePayload(options?)` — builds a REST payload wrapping the AST
+ *
+ * @example
+ * ```tsx
+ * <Lex4Editor extensions={[astExtension()]} />
+ * ```
+ */
+export declare function astExtension(): Lex4Extension;
+//# sourceMappingURL=ast-extension.d.ts.map

package/dist/extensions/ast-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-extension.d.ts","sourceRoot":"","sources":["../../src/extensions/ast-extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAC;AAK/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,aAAa,CA0B5C"}

package/dist/extensions/extension-context.d.ts

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+import { ResolvedExtensions, ExtensionContext, Lex4Extension } from './types';
+/**
+ * Provides resolved extension data to all child components.
+ * Extensions are resolved once from the extensions array.
+ */
+export declare const ExtensionProvider: React.FC<{
+    extensions?: Lex4Extension[];
+    children: React.ReactNode;
+}>;
+/**
+ * Returns the resolved extension data.
+ */
+export declare function useExtensions(): ResolvedExtensions;
+export declare const ExtensionStateProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+/**
+ * Hook to get/set extension shared state from any component within the editor tree.
+ */
+export declare function useExtensionState(): {
+    get: <T = unknown>(key: string) => T | undefined;
+    set: <T = unknown>(key: string, value: T) => void;
+};
+/**
+ * Builds an ExtensionContext for handle method factories.
+ */
+export declare function useExtensionContext(getDocument: ExtensionContext['getDocument'], getActiveEditor: ExtensionContext['getActiveEditor']): ExtensionContext;
+//# sourceMappingURL=extension-context.d.ts.map

package/dist/extensions/extension-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-context.d.ts","sourceRoot":"","sources":["../../src/extensions/extension-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqD,MAAM,OAAO,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAc7C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAkBA,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAElD;AAMD,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAO1E,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB;UAGvB,CAAC,iBAAiB,MAAM,KAAG,CAAC,GAAG,SAAS;UACxC,CAAC,iBAAiB,MAAM,SAAS,CAAC;EAI3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAC5C,eAAe,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,GACnD,gBAAgB,CAWlB"}

package/dist/extensions/index.d.ts

@@ -0,0 +1,6 @@
+export type { Lex4Extension, ExtensionContext, ResolvedExtensions, } from './types';
+export { resolveExtensions } from './types';
+export { ExtensionProvider, ExtensionStateProvider, useExtensions, useExtensionContext, useExtensionState, } from './extension-context';
+export { astExtension } from './ast-extension';
+export { variablesExtension } from './variables-extension';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/extensions/types.d.ts

@@ -0,0 +1,74 @@
+import { EditorThemeClasses, Klass, LexicalNode } from 'lexical';
+import { Lex4Document } from '../types/document';
+/**
+ * Context passed to extension handleMethods factories.
+ * Provides read access to editor state so extensions can build
+ * their imperative API methods.
+ */
+export interface ExtensionContext {
+    getDocument: () => Lex4Document;
+    getActiveEditor: () => import('lexical').LexicalEditor | null;
+    getExtensionState: <T = unknown>(key: string) => T | undefined;
+    setExtensionState: <T = unknown>(key: string, value: T) => void;
+}
+/**
+ * Lex4Extension — Plugin-based extension contract.
+ *
+ * Extensions add capabilities to the editor without requiring
+ * hard-wired imports. Each extension can contribute:
+ * - Lexical nodes (custom block/inline node types)
+ * - Body plugins (rendered inside every page's LexicalComposer)
+ * - Toolbar items (rendered in the toolbar extension slot)
+ * - Side panels (rendered to the right of the document area)
+ * - Provider wrappers (React context providers wrapping the editor)
+ * - Imperative handle methods (merged into the ref API)
+ */
+export interface Lex4Extension {
+    /** Unique extension name used for identification. */
+    name: string;
+    /** Additional Lexical node classes to register in every editor instance. */
+    nodes?: Klass<LexicalNode>[];
+    /** Plugin components rendered inside each page body's LexicalComposer. */
+    bodyPlugins?: React.ComponentType[];
+    /** Components rendered in the toolbar's extension slot. */
+    toolbarItems?: React.ComponentType[];
+    /** Component rendered as a right side panel. */
+    sidePanel?: React.ComponentType;
+    /**
+     * Provider component that wraps the editor tree.
+     * Useful for injecting React contexts.
+     */
+    provider?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    /**
+     * Lexical editor theme overrides contributed by this extension.
+     * Merged into the base theme.
+     */
+    themeOverrides?: Partial<EditorThemeClasses>;
+    /**
+     * Factory that returns imperative handle methods.
+     * These are merged into the Lex4EditorHandle exposed via ref.
+     */
+    handleMethods?: (ctx: ExtensionContext) => Record<string, (...args: never[]) => unknown>;
+}
+/**
+ * Resolved extension data after processing all extensions.
+ * Used internally by the editor to wire everything together.
+ */
+export interface ResolvedExtensions {
+    nodes: Klass<LexicalNode>[];
+    bodyPlugins: React.ComponentType[];
+    toolbarItems: React.ComponentType[];
+    sidePanels: React.ComponentType[];
+    providers: React.ComponentType<{
+        children: React.ReactNode;
+    }>[];
+    themeOverrides: Partial<EditorThemeClasses>;
+    handleFactories: Array<(ctx: ExtensionContext) => Record<string, (...args: never[]) => unknown>>;
+}
+/**
+ * Processes an array of extensions into a single resolved structure.
+ */
+export declare function resolveExtensions(extensions: Lex4Extension[]): ResolvedExtensions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/extensions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,YAAY,CAAC;IAChC,eAAe,EAAE,MAAM,OAAO,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9D,iBAAiB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IAC/D,iBAAiB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IAEb,4EAA4E;IAC5E,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IAE7B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IAErC,gDAAgD;IAChD,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,CAAC;IAE9D;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7C;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;CAC1F;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IACnC,YAAY,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IACpC,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IAClC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IAChE,cAAc,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,eAAe,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;CAClG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAwBjF"}

package/dist/extensions/variables-extension.d.ts

@@ -0,0 +1,31 @@
+import { Lex4Extension } from './types';
+import { VariableDefinition } from '../variables/types';
+interface VariablePanelState {
+    panelOpen: boolean;
+    setPanelOpen: (open: boolean) => void;
+}
+export declare function useVariablePanelState(): VariablePanelState;
+/**
+ * Creates a variables extension that adds variable/placeholder support.
+ *
+ * Contributes:
+ * - VariableNode (custom Lexical node)
+ * - VariablePlugin (body plugin for insert command handling)
+ * - VariableProvider (context provider for variable catalog)
+ * - VariablePicker toolbar item + panel toggle button
+ * - VariablePanel side panel with toggle state
+ * - Handle methods: insertVariable, refreshVariables
+ *
+ * @param definitions Initial variable definitions to load
+ *
+ * @example
+ * ```tsx
+ * const defs = [
+ *   { key: 'customer.name', label: 'Customer', group: 'Customer', valueType: 'string' },
+ * ];
+ * <Lex4Editor extensions={[variablesExtension(defs)]} />
+ * ```
+ */
+export declare function variablesExtension(definitions?: VariableDefinition[]): Lex4Extension;
+export {};
+//# sourceMappingURL=variables-extension.d.ts.map

package/dist/extensions/variables-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-extension.d.ts","sourceRoot":"","sources":["../../src/extensions/variables-extension.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAa7D,UAAU,kBAAkB;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAOD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAwFD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,kBAAkB,EAAO,GAAG,aAAa,CAgCxF"}

package/dist/i18n/context.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { Lex4Translations } from './types';
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Returns the active translations. Use inside any editor component
+ * to access localized strings.
+ */
+export declare function useTranslations(): Lex4Translations;
+/**
+ * Interpolates `{{key}}` placeholders in a translation string.
+ *
+ * @example
+ * interpolate('Font changed to {{value}}', { value: 'Inter' })
+ * // => 'Font changed to Inter'
+ */
+export declare function interpolate(template: string, params: Record<string, string | number>): string;
+interface TranslationsProviderProps {
+    translations?: DeepPartial<Lex4Translations>;
+    children: React.ReactNode;
+}
+/**
+ * TranslationsProvider — merges consumer overrides with DEFAULT_TRANSLATIONS.
+ */
+export declare const TranslationsProvider: React.FC<TranslationsProviderProps>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/i18n/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/i18n/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD,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;AA+BF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAIR;AAED,UAAU,yBAAyB;IACjC,YAAY,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAiBpE,CAAC"}

package/dist/i18n/defaults.d.ts

@@ -0,0 +1,3 @@
+import { Lex4Translations } from './types';
+export declare const DEFAULT_TRANSLATIONS: Lex4Translations;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/i18n/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/i18n/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,oBAAoB,EAAE,gBA0ElC,CAAC"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,4 @@
+export type { Lex4Translations } from './types';
+export { DEFAULT_TRANSLATIONS } from './defaults';
+export { TranslationsProvider, useTranslations, interpolate } from './context';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/i18n/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Lex4Translations — All UI strings used by the editor.
+ *
+ * Consumers can pass `Partial<Lex4Translations>` to override
+ * any subset of strings for localization purposes.
+ */
+export interface Lex4Translations {
+    toolbar: {
+        undo: string;
+        redo: string;
+        bold: string;
+        italic: string;
+        underline: string;
+        strikethrough: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
+        justify: string;
+        numberedList: string;
+        bulletList: string;
+        indent: string;
+        outdent: string;
+        openHistory: string;
+        closeHistory: string;
+    };
+    history: {
+        title: string;
+        subtitle: string;
+        empty: string;
+        clearHistory: string;
+        actions: {
+            enabledHeadersFooters: string;
+            disabledHeadersFooters: string;
+            copiedHeaderToAll: string;
+            copiedFooterToAll: string;
+            clearedHeader: string;
+            clearedFooter: string;
+            clearedAllHeaders: string;
+            clearedAllFooters: string;
+            /** Use {{value}} for the mode name */
+            pageCounterSet: string;
+            boldApplied: string;
+            italicApplied: string;
+            underlineApplied: string;
+            strikethroughApplied: string;
+            alignedLeft: string;
+            alignedCenter: string;
+            alignedRight: string;
+            justifiedText: string;
+            insertedNumberedList: string;
+            insertedBulletList: string;
+            indentedContent: string;
+            outdentedContent: string;
+            /** Use {{value}} for the font name */
+            fontChanged: string;
+            /** Use {{value}} for the size */
+            fontSizeChanged: string;
+        };
+    };
+    variables: {
+        title: string;
+        /** Use {{count}} for the number of available variables */
+        available: string;
+        refreshVariables: string;
+        searchPlaceholder: string;
+        noVariablesFound: string;
+        /** Use {{key}} for the variable key */
+        insertVariable: string;
+        openPanel: string;
+        closePanel: string;
+    };
+    header: {
+        placeholder: string;
+    };
+    footer: {
+        placeholder: string;
+    };
+    sidebar: {
+        close: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE;YACP,qBAAqB,EAAE,MAAM,CAAC;YAC9B,sBAAsB,EAAE,MAAM,CAAC;YAC/B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,aAAa,EAAE,MAAM,CAAC;YACtB,aAAa,EAAE,MAAM,CAAC;YACtB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,sCAAsC;YACtC,cAAc,EAAE,MAAM,CAAC;YACvB,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;YACtB,gBAAgB,EAAE,MAAM,CAAC;YACzB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;YACtB,YAAY,EAAE,MAAM,CAAC;YACrB,aAAa,EAAE,MAAM,CAAC;YACtB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,kBAAkB,EAAE,MAAM,CAAC;YAC3B,eAAe,EAAE,MAAM,CAAC;YACxB,gBAAgB,EAAE,MAAM,CAAC;YACzB,sCAAsC;YACtC,WAAW,EAAE,MAAM,CAAC;YACpB,iCAAiC;YACjC,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;IAEF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,0DAA0D;QAC1D,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,uCAAuC;QACvC,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/index.d.ts

@@ -1,9 +1,19 @@
 export { Lex4Editor } from './components/Lex4Editor';
 export type { Lex4EditorProps } from './types/editor-props';
+export type { Lex4EditorHandle } from './types/editor-handle';
 export type { Lex4Document, PageState } from './types/document';
 export { createEmptyDocument, createEmptyPage } from './types/document';
 export { A4_WIDTH_PX, A4_HEIGHT_PX, A4_WIDTH_MM, A4_HEIGHT_MM, MAX_HEADER_HEIGHT_PX, MAX_FOOTER_HEIGHT_PX, } from './constants/dimensions';
 export { usePagination } from './hooks/use-pagination';
 export { useOverflowDetection } from './hooks/use-overflow-detection';
 export { useHeaderFooter } from './hooks/use-header-footer';
+export type { Lex4Extension, ExtensionContext } from './extensions';
+export { astExtension } from './extensions';
+export { variablesExtension } from './extensions';
+export type { DocumentAst, PageAst, ContentAst, BlockNodeAst, InlineNodeAst, TextRunAst, TextMarks, VariableAst, LineBreakAst, ParagraphAst, HeadingAst, ListAst, ListItemAst, BlockQuoteAst, SaveDocumentRequest, VariableDefinitionAst, PayloadOptions, } from './ast';
+export { AST_VERSION, serializeDocument, buildSavePayload, serializeDocumentJson } from './ast';
+export type { VariableDefinition, VariableContextValue } from './variables';
+export { VariableNode, $createVariableNode, $isVariableNode, INSERT_VARIABLE_COMMAND } from './variables';
+export type { Lex4Translations } from './i18n';
+export { DEFAULT_TRANSLATIONS } from './i18n';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,YAAY,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AAGhG,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG1G,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC"}