@eigenpal/docx-editor-core 0.0.0

package/dist/managers/types.d.mts

@@ -0,0 +1,122 @@
+/**
+ * Manager Types
+ *
+ * Framework-agnostic interfaces for the editor's manager classes.
+ * @packageDocumentation
+ * @public
+ */
+import { EditorView } from 'prosemirror-view';
+import { Document } from '../types/document.mjs';
+import '../colors-C3vA7HUU.mjs';
+import '../formatting-D9I-lFS4.mjs';
+import '../lists-JDB80qyP.mjs';
+import '../types/content.mjs';
+import '../docx/wrapTypes.mjs';
+import '../styles-BBoqh07F.mjs';
+
+/**
+ * Manager Types
+ *
+ * Framework-agnostic interfaces for the editor's manager classes.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Framework-agnostic interface for an imperatively mounted editor instance.
+ *
+ * Returned by `renderAsync()` implementations (React, Vue, etc.).
+ * Consumers use this to interact with the editor programmatically.
+ */
+interface EditorHandle {
+    /** Save the document and return the DOCX as a Blob. */
+    save(): Promise<Blob | null>;
+    /** Get the current parsed document model. */
+    getDocument(): Document | null;
+    /** Focus the editor. */
+    focus(): void;
+    /** Unmount the editor and clean up. */
+    destroy(): void;
+}
+/** Auto-save status */
+type AutoSaveStatus = 'idle' | 'saving' | 'saved' | 'error';
+/** Configuration for AutoSaveManager */
+interface AutoSaveManagerOptions {
+    /** Storage key for localStorage (default: 'docx-editor-autosave') */
+    storageKey?: string;
+    /** Save interval in milliseconds (default: 30000 - 30 seconds) */
+    interval?: number;
+    /** Maximum age of auto-save before it's considered stale (default: 24 hours) */
+    maxAge?: number;
+    /** Whether to save on document change with debounce (default: true) */
+    saveOnChange?: boolean;
+    /** Debounce delay for saveOnChange in milliseconds (default: 2000) */
+    debounceDelay?: number;
+    /** Callback when save succeeds */
+    onSave?: (timestamp: Date) => void;
+    /** Callback when save fails */
+    onError?: (error: Error) => void;
+    /** Callback when recovery data is found */
+    onRecoveryAvailable?: (savedDocument: SavedDocumentData) => void;
+}
+/** Saved document data structure */
+interface SavedDocumentData {
+    /** The document JSON */
+    document: Document;
+    /** When the document was saved */
+    savedAt: string;
+    /** Version for format compatibility */
+    version: number;
+    /** Optional document identifier */
+    documentId?: string;
+}
+/** AutoSaveManager snapshot for UI consumption */
+interface AutoSaveSnapshot {
+    status: AutoSaveStatus;
+    lastSaveTime: Date | null;
+    hasRecoveryData: boolean;
+    isEnabled: boolean;
+}
+/** Cell coordinates in a table */
+interface CellCoordinates {
+    tableIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+}
+/** TableSelectionManager snapshot */
+interface TableSelectionSnapshot {
+    /** Currently selected cell, or null if no selection */
+    selectedCell: CellCoordinates | null;
+}
+/** Error severity levels */
+type ErrorSeverity = 'error' | 'warning' | 'info';
+/** Error notification */
+interface ErrorNotification {
+    id: string;
+    message: string;
+    severity: ErrorSeverity;
+    details?: string;
+    timestamp: number;
+    dismissed?: boolean;
+}
+/** ErrorManager snapshot */
+interface ErrorManagerSnapshot {
+    notifications: ErrorNotification[];
+}
+/** Plugin lifecycle configuration */
+interface PluginLifecycleConfig {
+    id: string;
+    styles?: string;
+    initialize?: (editorView: EditorView) => unknown;
+    onStateChange?: (editorView: EditorView) => unknown;
+    destroy?: () => void;
+}
+/** PluginLifecycleManager snapshot */
+interface PluginLifecycleSnapshot {
+    /** Map of plugin ID to plugin state */
+    states: Map<string, unknown>;
+    /** Version counter (incremented on any state change) */
+    version: number;
+}
+
+export type { AutoSaveManagerOptions, AutoSaveSnapshot, AutoSaveStatus, CellCoordinates, EditorHandle, ErrorManagerSnapshot, ErrorNotification, ErrorSeverity, PluginLifecycleConfig, PluginLifecycleSnapshot, SavedDocumentData, TableSelectionSnapshot };

package/dist/managers/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Manager Types
+ *
+ * Framework-agnostic interfaces for the editor's manager classes.
+ * @packageDocumentation
+ * @public
+ */
+import { EditorView } from 'prosemirror-view';
+import { Document } from '../types/document.js';
+import '../colors-C3vA7HUU.js';
+import '../formatting-BwpZWdGi.js';
+import '../lists-CdiIk_c1.js';
+import '../types/content.js';
+import '../docx/wrapTypes.js';
+import '../styles-jqO45PSq.js';
+
+/**
+ * Manager Types
+ *
+ * Framework-agnostic interfaces for the editor's manager classes.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Framework-agnostic interface for an imperatively mounted editor instance.
+ *
+ * Returned by `renderAsync()` implementations (React, Vue, etc.).
+ * Consumers use this to interact with the editor programmatically.
+ */
+interface EditorHandle {
+    /** Save the document and return the DOCX as a Blob. */
+    save(): Promise<Blob | null>;
+    /** Get the current parsed document model. */
+    getDocument(): Document | null;
+    /** Focus the editor. */
+    focus(): void;
+    /** Unmount the editor and clean up. */
+    destroy(): void;
+}
+/** Auto-save status */
+type AutoSaveStatus = 'idle' | 'saving' | 'saved' | 'error';
+/** Configuration for AutoSaveManager */
+interface AutoSaveManagerOptions {
+    /** Storage key for localStorage (default: 'docx-editor-autosave') */
+    storageKey?: string;
+    /** Save interval in milliseconds (default: 30000 - 30 seconds) */
+    interval?: number;
+    /** Maximum age of auto-save before it's considered stale (default: 24 hours) */
+    maxAge?: number;
+    /** Whether to save on document change with debounce (default: true) */
+    saveOnChange?: boolean;
+    /** Debounce delay for saveOnChange in milliseconds (default: 2000) */
+    debounceDelay?: number;
+    /** Callback when save succeeds */
+    onSave?: (timestamp: Date) => void;
+    /** Callback when save fails */
+    onError?: (error: Error) => void;
+    /** Callback when recovery data is found */
+    onRecoveryAvailable?: (savedDocument: SavedDocumentData) => void;
+}
+/** Saved document data structure */
+interface SavedDocumentData {
+    /** The document JSON */
+    document: Document;
+    /** When the document was saved */
+    savedAt: string;
+    /** Version for format compatibility */
+    version: number;
+    /** Optional document identifier */
+    documentId?: string;
+}
+/** AutoSaveManager snapshot for UI consumption */
+interface AutoSaveSnapshot {
+    status: AutoSaveStatus;
+    lastSaveTime: Date | null;
+    hasRecoveryData: boolean;
+    isEnabled: boolean;
+}
+/** Cell coordinates in a table */
+interface CellCoordinates {
+    tableIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+}
+/** TableSelectionManager snapshot */
+interface TableSelectionSnapshot {
+    /** Currently selected cell, or null if no selection */
+    selectedCell: CellCoordinates | null;
+}
+/** Error severity levels */
+type ErrorSeverity = 'error' | 'warning' | 'info';
+/** Error notification */
+interface ErrorNotification {
+    id: string;
+    message: string;
+    severity: ErrorSeverity;
+    details?: string;
+    timestamp: number;
+    dismissed?: boolean;
+}
+/** ErrorManager snapshot */
+interface ErrorManagerSnapshot {
+    notifications: ErrorNotification[];
+}
+/** Plugin lifecycle configuration */
+interface PluginLifecycleConfig {
+    id: string;
+    styles?: string;
+    initialize?: (editorView: EditorView) => unknown;
+    onStateChange?: (editorView: EditorView) => unknown;
+    destroy?: () => void;
+}
+/** PluginLifecycleManager snapshot */
+interface PluginLifecycleSnapshot {
+    /** Map of plugin ID to plugin state */
+    states: Map<string, unknown>;
+    /** Version counter (incremented on any state change) */
+    version: number;
+}
+
+export type { AutoSaveManagerOptions, AutoSaveSnapshot, AutoSaveStatus, CellCoordinates, EditorHandle, ErrorManagerSnapshot, ErrorNotification, ErrorSeverity, PluginLifecycleConfig, PluginLifecycleSnapshot, SavedDocumentData, TableSelectionSnapshot };

package/dist/managers/types.js

@@ -0,0 +1 @@
+'use strict';

package/dist/marks-BujVxYP4.d.ts

@@ -0,0 +1,56 @@
+import { T as ThemeColorSlot } from './colors-C3vA7HUU.js';
+import { U as UnderlineStyle } from './formatting-BwpZWdGi.js';
+
+/**
+ * ProseMirror Mark Type Interfaces
+ *
+ * Type definitions for mark attributes used by conversion modules,
+ * extensions, and other consumers. MarkSpec definitions have moved
+ * to the extension system (extensions/marks/).
+ */
+
+/**
+ * Text color mark attributes
+ */
+interface TextColorAttrs {
+    rgb?: string;
+    themeColor?: ThemeColorSlot;
+    themeTint?: string;
+    themeShade?: string;
+}
+/**
+ * Underline mark attributes
+ */
+interface UnderlineAttrs {
+    style?: UnderlineStyle;
+    color?: TextColorAttrs;
+}
+/**
+ * Font size mark attributes
+ */
+interface FontSizeAttrs {
+    size: number;
+}
+/**
+ * Font family mark attributes
+ */
+interface FontFamilyAttrs {
+    ascii?: string;
+    hAnsi?: string;
+    eastAsia?: string;
+    cs?: string;
+    asciiTheme?: string;
+    hAnsiTheme?: string;
+    eastAsiaTheme?: string;
+    csTheme?: string;
+}
+/**
+ * Hyperlink mark attributes
+ */
+interface HyperlinkAttrs {
+    href: string;
+    tooltip?: string;
+    rId?: string;
+}
+
+export type { FontFamilyAttrs as F, HyperlinkAttrs as H, TextColorAttrs as T, UnderlineAttrs as U, FontSizeAttrs as a };

package/dist/marks-CCPVlQzL.d.mts

@@ -0,0 +1,56 @@
+import { T as ThemeColorSlot } from './colors-C3vA7HUU.mjs';
+import { U as UnderlineStyle } from './formatting-D9I-lFS4.mjs';
+
+/**
+ * ProseMirror Mark Type Interfaces
+ *
+ * Type definitions for mark attributes used by conversion modules,
+ * extensions, and other consumers. MarkSpec definitions have moved
+ * to the extension system (extensions/marks/).
+ */
+
+/**
+ * Text color mark attributes
+ */
+interface TextColorAttrs {
+    rgb?: string;
+    themeColor?: ThemeColorSlot;
+    themeTint?: string;
+    themeShade?: string;
+}
+/**
+ * Underline mark attributes
+ */
+interface UnderlineAttrs {
+    style?: UnderlineStyle;
+    color?: TextColorAttrs;
+}
+/**
+ * Font size mark attributes
+ */
+interface FontSizeAttrs {
+    size: number;
+}
+/**
+ * Font family mark attributes
+ */
+interface FontFamilyAttrs {
+    ascii?: string;
+    hAnsi?: string;
+    eastAsia?: string;
+    cs?: string;
+    asciiTheme?: string;
+    hAnsiTheme?: string;
+    eastAsiaTheme?: string;
+    csTheme?: string;
+}
+/**
+ * Hyperlink mark attributes
+ */
+interface HyperlinkAttrs {
+    href: string;
+    tooltip?: string;
+    rId?: string;
+}
+
+export type { FontFamilyAttrs as F, HyperlinkAttrs as H, TextColorAttrs as T, UnderlineAttrs as U, FontSizeAttrs as a };