@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/keyboard/shortcuts/types.d.ts

@@ -0,0 +1,347 @@
+/**
+ * @file Keyboard Shortcut Types
+ *
+ * Defines the complete keyboard shortcut type system including bindings,
+ * contexts, categories, and full shortcut definitions.
+ */
+import type { ModifierKey, PhysicalKeyCode } from '../physical-keys';
+export type { ModifierKey, PhysicalKeyCode };
+/**
+ * A physical key binding specifies which physical key and modifiers
+ * trigger a shortcut.
+ *
+ * @example
+ * ```ts
+ * // Ctrl+C (Copy)
+ * const copyBinding: PhysicalKeyBinding = {
+ *   code: 'KeyC',
+ *   modifiers: ['ctrl']
+ * };
+ *
+ * // Ctrl+Shift+Z (Redo on Windows)
+ * const redoBinding: PhysicalKeyBinding = {
+ *   code: 'KeyZ',
+ *   modifiers: ['ctrl', 'shift']
+ * };
+ * ```
+ */
+export interface PhysicalKeyBinding {
+    /**
+     * The physical key code that triggers this shortcut.
+     */
+    readonly code: PhysicalKeyCode;
+    /**
+     * The modifier keys required for this shortcut.
+     *
+     * Empty array means no modifiers (just the key itself).
+     * Order doesn't matter - ['ctrl', 'shift'] equals ['shift', 'ctrl'].
+     */
+    readonly modifiers: readonly ModifierKey[];
+}
+/**
+ * Platform-specific key bindings for a shortcut.
+ *
+ * Most shortcuts use the same key across platforms (with Ctrl/Cmd swap),
+ * but some need completely different keys on different platforms.
+ *
+ * @example
+ * ```ts
+ * // Simple case - same key, automatic Ctrl/Cmd swap
+ * const save: PlatformKeyBindings = {
+ *   default: { code: 'KeyS', modifiers: ['ctrl'] }
+ *   // Mac automatically uses Cmd+S
+ * };
+ *
+ * // Complex case - different keys per platform
+ * const redo: PlatformKeyBindings = {
+ *   default: { code: 'KeyY', modifiers: ['ctrl'] },       // Windows: Ctrl+Y
+ *   macos: { code: 'KeyZ', modifiers: ['meta', 'shift'] } // Mac: Cmd+Shift+Z
+ * };
+ * ```
+ */
+export interface PlatformKeyBindings {
+    /**
+     * The default binding used when no platform-specific binding is defined.
+     *
+     * For non-Mac platforms, this is used as-is.
+     * For macOS, if no macos binding is specified, Ctrl is automatically
+     * converted to Meta (Cmd).
+     */
+    readonly default: PhysicalKeyBinding;
+    /**
+     * macOS-specific binding override.
+     *
+     * If not specified, the default binding is used with Ctrl->Cmd conversion.
+     */
+    readonly macos?: PhysicalKeyBinding;
+    /**
+     * Windows-specific binding override.
+     *
+     * If not specified, the default binding is used.
+     */
+    readonly windows?: PhysicalKeyBinding;
+    /**
+     * Linux-specific binding override.
+     *
+     * If not specified, the default binding is used.
+     */
+    readonly linux?: PhysicalKeyBinding;
+}
+/**
+ * Contexts in which shortcuts can be active.
+ *
+ * A shortcut may be available in multiple contexts. The active context
+ * is determined by the current focus and application state.
+ *
+ * - 'global': Always available (e.g., Ctrl+S save)
+ * - 'grid': Grid is focused but not in edit mode
+ * - 'editing': Generic editing mode (cell or formula bar)
+ * - 'enterMode': Cell editor in Enter mode (navigating commits)
+ * - 'editMode': Cell editor in Edit mode (arrow keys move cursor)
+ * - 'formulaEnterMode': Formula bar in Enter mode
+ * - 'formulaEditMode': Formula bar in Edit mode
+ * - 'formulaEditing': Either formula mode (for formula-specific shortcuts)
+ * - 'objectSelected': A floating object is selected
+ * - 'dialog': A modal dialog is open
+ * - 'menu': A menu or dropdown is open
+ * - 'view': Parent context for all view-specific contexts
+ * - 'kanban': Kanban board view
+ * - 'kanbanEditing': Editing within kanban view
+ * - 'gallery': Gallery view
+ * - 'calendar': Calendar view
+ * - 'timeline': Timeline view
+ * - 'any': Available in all contexts
+ */
+export type ShortcutContext = 'global' | 'grid' | 'editing' | 'enterMode' | 'editMode' | 'formulaEnterMode' | 'formulaEditMode' | 'formulaEditing' | 'objectSelected' | 'dialog' | 'menu' | 'drawing' | 'smartArtNodeSelected' | 'view' | 'kanban' | 'kanbanEditing' | 'gallery' | 'calendar' | 'timeline' | 'any';
+/**
+ * Categories for organizing shortcuts in help dialogs and documentation.
+ */
+export type ShortcutCategory = 'navigation' | 'selection' | 'editing' | 'formatting' | 'clipboard' | 'formula' | 'comments' | 'data' | 'view' | 'file' | 'workbook' | 'object' | 'accessibility';
+/**
+ * Priority level for shortcuts when conflicts occur.
+ *
+ * Higher priority shortcuts are matched first when multiple shortcuts
+ * could match the same key combination.
+ *
+ * - 'critical': System-level shortcuts that must always work (Escape, etc.)
+ * - 'high': Important user actions (Save, Undo, Cut/Copy/Paste)
+ * - 'medium': Common operations (formatting, navigation)
+ * - 'low': Less common or context-specific operations
+ */
+export type ShortcutPriority = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Muscle memory importance for shortcuts.
+ *
+ * This helps prioritize which shortcuts should match Excel exactly
+ * for users migrating from Excel.
+ *
+ * - 'essential': Must match Excel exactly (Ctrl+C, Ctrl+V, Ctrl+Z)
+ * - 'common': Frequently used, should match Excel (Ctrl+B, Ctrl+I, F2)
+ * - 'occasional': Used regularly but not constantly (Ctrl+;, Ctrl+Shift+;)
+ * - 'rare': Power user shortcuts (F4 for absolute refs, Ctrl+`)
+ */
+export type MuscleMemoryLevel = 'essential' | 'common' | 'occasional' | 'rare';
+/**
+ * Conflict policy when a shortcut conflicts with browser default behavior.
+ *
+ * - 'override': Always prevent browser default (use for essential shortcuts)
+ * - 'defer': Let browser handle it (use when browser behavior is desired)
+ * - 'none': No browser conflict (most shortcuts)
+ */
+export type BrowserConflictPolicy = 'override' | 'defer' | 'none';
+/**
+ * Browser conflict information for a shortcut.
+ */
+export interface BrowserConflict {
+    /**
+     * Description of what the browser does with this shortcut.
+     *
+     * @example "Opens browser devtools"
+     * @example "Refreshes the page"
+     */
+    readonly conflictsWith?: string;
+    /**
+     * How to handle the conflict.
+     */
+    readonly policy: BrowserConflictPolicy;
+    /**
+     * Alternative way for users to perform the browser action.
+     *
+     * @example "F5 or browser menu still works for refresh"
+     * @example "Use browser menu"
+     */
+    readonly workaround?: string;
+}
+/**
+ * Complete keyboard shortcut definition.
+ *
+ * This contains all information needed to:
+ * - Match keyboard input to the shortcut
+ * - Display the shortcut in UI/help
+ * - Handle platform differences
+ * - Manage conflicts with browser shortcuts
+ * - Allow user customization
+ *
+ * @example
+ * ```ts
+ * const saveShortcut: KeyboardShortcut = {
+ *   id: 'file.save',
+ *   bindings: {
+ *     default: { code: 'KeyS', modifiers: ['ctrl'] }
+ *   },
+ *   description: 'Save the current workbook',
+ *   action: 'save',
+ *   enabled: true,
+ *   priority: 'high',
+ *   category: 'file',
+ *   contexts: ['global'],
+ *   muscleMemory: 'essential',
+ *   browserConflict: {
+ *     conflictsWith: 'Browser save page dialog',
+ *     policy: 'override'
+ *   },
+ *   allowRepeat: false
+ * };
+ * ```
+ */
+export interface KeyboardShortcut {
+    /**
+     * Unique identifier for this shortcut.
+     *
+     * Use dot-notation for namespacing: 'category.action'
+     *
+     * @example 'file.save'
+     * @example 'edit.undo'
+     * @example 'format.bold'
+     */
+    readonly id: string;
+    /**
+     * Key bindings for this shortcut, with optional platform overrides.
+     */
+    readonly bindings: PlatformKeyBindings;
+    /**
+     * Human-readable description of what this shortcut does.
+     *
+     * Used in help dialogs and tooltips.
+     */
+    readonly description: string;
+    /**
+     * The action identifier to dispatch when this shortcut is triggered.
+     *
+     * This should match an action handler in the action system.
+     */
+    readonly action: string;
+    /**
+     * Whether this shortcut is currently enabled.
+     *
+     * Disabled shortcuts are not matched against input.
+     * Use this for feature flags or conditional availability.
+     */
+    readonly enabled: boolean;
+    /**
+     * Priority for conflict resolution.
+     *
+     * Higher priority shortcuts are matched first when multiple
+     * shortcuts could match the same key combination.
+     */
+    readonly priority: ShortcutPriority;
+    /**
+     * Category for organization in help/settings UI.
+     */
+    readonly category: ShortcutCategory;
+    /**
+     * Contexts where this shortcut is active.
+     *
+     * The shortcut only triggers if the current context matches
+     * one of the listed contexts (or 'any').
+     */
+    readonly contexts: readonly ShortcutContext[];
+    /**
+     * Muscle memory level for Excel compatibility prioritization.
+     */
+    readonly muscleMemory: MuscleMemoryLevel;
+    /**
+     * Browser conflict information.
+     *
+     * If undefined, there is no browser conflict.
+     */
+    readonly browserConflict?: BrowserConflict;
+    /**
+     * How to match this shortcut against keyboard input.
+     *
+     * - 'key': Match against event.key (character output). Use for mnemonic
+     *   letter shortcuts (Ctrl+B for Bold). Works across all keyboard layouts.
+     * - 'code': Match against event.code (physical position). Use for positional
+     *   shortcuts (arrows, F-keys, digits, numpad, punctuation).
+     *
+     * DEFAULT: 'code' (backward compatible with current behavior)
+     */
+    readonly matchBy: 'key' | 'code';
+    /**
+     * The character to match against event.key (lowercase).
+     * Required when matchBy is 'key'. Ignored when matchBy is 'code'.
+     *
+     * @example 'b' for Bold (Ctrl+B)
+     * @example 'c' for Copy (Ctrl+C)
+     */
+    readonly expectedCharacter?: string;
+    /**
+     * Whether this shortcut should trigger repeatedly when held.
+     *
+     * - true: Triggers repeatedly (e.g., arrow navigation)
+     * - false: Only triggers once per keypress (e.g., Ctrl+S save)
+     *
+     * Default is false if not specified.
+     */
+    readonly allowRepeat?: boolean;
+    /**
+     * When true, this shortcut is registered as an OS-level global hotkey
+     * (via Tauri's global-shortcut plugin) in addition to the normal in-app
+     * shortcut. Global shortcuts fire even when the app is not focused.
+     *
+     * Desktop only — ignored on web. If registration fails (e.g., another
+     * app owns the key combination), the in-app shortcut still works.
+     *
+     * @example Use cases: quick capture, show/hide app
+     */
+    readonly global?: boolean;
+    /**
+     * Additional notes about this shortcut.
+     *
+     * Documentation-only, not used at runtime.
+     */
+    readonly notes?: string;
+}
+/**
+ * Result of matching keyboard input against shortcuts.
+ */
+export interface ShortcutMatchResult {
+    /**
+     * The matched shortcut, or null if no match.
+     */
+    readonly shortcut: KeyboardShortcut | null;
+    /**
+     * Whether the browser default should be prevented.
+     *
+     * This is true when:
+     * - A shortcut matched and has browserConflict.policy === 'override'
+     * - A shortcut matched and has no browser conflict
+     *
+     * It's false when:
+     * - No shortcut matched
+     * - The matched shortcut has browserConflict.policy === 'defer'
+     */
+    readonly preventDefault: boolean;
+}
+/**
+ * Handler function for a keyboard shortcut.
+ *
+ * @param shortcut - The matched shortcut
+ * @returns true if the shortcut was handled, false to allow fallthrough
+ */
+export type ShortcutHandler = (shortcut: KeyboardShortcut) => boolean;
+/**
+ * A collection of keyboard shortcuts indexed by ID.
+ */
+export type ShortcutRegistry = ReadonlyMap<string, KeyboardShortcut>;
+//# sourceMappingURL=types.d.ts.map

package/dist/keyboard/shortcuts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/keyboard/shortcuts/types.ts"],"names":[],"mappings":"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"}

package/dist/machines/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Machine Types Module
+ *
+ * Re-exports all machine-related types and snapshot interfaces.
+ *
+ * @module @mog/spreadsheet-contracts/machines
+ */
+export type { CellCoord, LayerName } from './types';
+export { FORMULA_RANGE_COLORS, RenderPriority } from './types';
+export type { ChartUIState, Direction, FocusLayerType, IFunctionMetadata, IFunctionRegistry, RendererStatus, SelectionDirection, } from './types';
+export type { ChartSnapshot, ClipboardSnapshot, EditorSnapshot, FocusLayer, FocusSnapshot, RendererSnapshot, SelectionSnapshot, } from './snapshots';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machines/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/machines/snapshots.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Machine Snapshot Types
+ *
+ * Snapshot interfaces for state machines. These define the output contracts
+ * that machines expose to consumers.
+ *
+ * @module @mog/spreadsheet-contracts/machines/snapshots
+ */
+import type { CellRange } from '../core';
+import type { CellCoord } from '../rendering/coordinates';
+import type { ChartUIState, FocusLayerType, RendererStatus, SelectionDirection } from './types';
+/**
+ * What the selection machine exposes to consumers.
+ *
+ * Includes pre-computed derived state for efficient rendering.
+ * Consumers should use the derived state (hasFullRowSelection, selectedCols, etc.)
+ * instead of iterating over ranges themselves.
+ */
+export interface SelectionSnapshot {
+    ranges: CellRange[];
+    activeCell: CellCoord;
+    isSelecting: boolean;
+    isFormulaMode: boolean;
+    isDraggingFillHandle: boolean;
+    isRightDraggingFillHandle: boolean;
+    /** Direction the selection was created in (from anchor to active cell) */
+    direction: SelectionDirection;
+    /** True if any range has isFullRow (all columns selected) */
+    hasFullRowSelection: boolean;
+    /** True if any range has isFullColumn (all rows selected) */
+    hasFullColumnSelection: boolean;
+    /** Rows touched by any selection (efficient - excludes full-column row iteration) */
+    selectedRows: ReadonlySet<number>;
+    /** Cols touched by any selection (efficient - excludes full-row col iteration) */
+    selectedCols: ReadonlySet<number>;
+    /** Rows with isFullRow (entire row selected) */
+    fullySelectedRows: ReadonlySet<number>;
+    /** Cols with isFullColumn (entire column selected) */
+    fullySelectedCols: ReadonlySet<number>;
+    /** True if user is dragging cells for move/copy operation */
+    isDraggingCells: boolean;
+    /** Source range being dragged (null if not dragging) */
+    dragSourceRange: CellRange | null;
+    /** Current target cell for the drop (null if not dragging) */
+    dragTargetCell: CellCoord | null;
+    /** Drag mode: 'move' (default) or 'copy' (Ctrl held) */
+    dragMode: 'move' | 'copy';
+    /** True if user is resizing a column or row header */
+    isResizingHeader: boolean;
+    /** Type of resize: 'column' or 'row' (null if not resizing) */
+    resizeType: 'column' | 'row' | null;
+    /** Index of the column or row being resized (null if not resizing) */
+    resizeIndex: number | null;
+    /** Current size during resize in pixels (null if not resizing) */
+    resizeCurrentSize: number | null;
+    /** True if user is resizing a table via the resize handle */
+    isResizingTable: boolean;
+    /** ID of the table being resized (null if not resizing) */
+    tableResizeId: string | null;
+    /** Original table bounds when resize started */
+    tableResizeStartBounds: CellRange | null;
+    /** Target row for the bottom-right corner during resize */
+    tableResizeTargetRow: number | null;
+    /** Target column for the bottom-right corner during resize */
+    tableResizeTargetCol: number | null;
+}
+/**
+ * What the editor machine exposes to consumers.
+ *
+ * ARCHITECTURE NOTE: editingCell is included in the snapshot for convenience,
+ * but it is DERIVED from selection.activeCell - NOT from EditorContext.
+ * This implements the single source of truth pattern.
+ */
+export interface EditorSnapshot {
+    isEditing: boolean;
+    isFormulaEditing: boolean;
+    /**
+     * The cell being edited, derived from selection.activeCell.
+     * SINGLE SOURCE OF TRUTH: This is NOT stored in EditorContext,
+     * it's derived from selection.activeCell when building the snapshot.
+     */
+    editingCell: CellCoord | null;
+    /** Sheet ID being edited (null if not editing) */
+    sheetId: string | null;
+    /** Merged region bounds if editing a merged cell (for in-cell editor sizing) */
+    mergeBounds: CellRange | null;
+    value: string;
+    hasConflict: boolean;
+    isIMEComposing: boolean;
+}
+/**
+ * What the clipboard machine exposes to consumers.
+ * G1/G2: Extended with copySource for marching ants on copy operations.
+ */
+export interface ClipboardSnapshot {
+    hasCopy: boolean;
+    hasCut: boolean;
+    cutSource: CellRange[] | null;
+    /** G1: Source ranges when copy is active (for marching ants on copy) */
+    copySource: CellRange[] | null;
+    isPasting: boolean;
+}
+/**
+ * What the renderer machine exposes to consumers.
+ */
+export interface RendererSnapshot {
+    status: RendererStatus;
+    currentSheetId: string | null;
+    isSwitching: boolean;
+}
+/**
+ * What the chart machine exposes to consumers.
+ * Used for chart UI state (editing, creation wizard, element selection).
+ *
+ * NOTE: Selection/drag/resize is now handled by objectInteractionActor.
+ * This snapshot contains chart-specific UI state only.
+ *
+ * Note: For full snapshot with all fields, import getChartSnapshot from chart-machine.ts.
+ * This interface provides a minimal subset for backwards compatibility.
+ */
+export interface ChartSnapshot {
+    /** Current UI state (derived from machine state) */
+    state: ChartUIState;
+    /** Selected chart ID (synced from objectInteractionActor) */
+    selectedChartId: string | null;
+    editingChartId: string | null;
+    isCreating: boolean;
+    creationStep: number;
+    isEditing: boolean;
+    /** True if charts are selected (synced from objectInteractionActor) */
+    hasSelection: boolean;
+}
+/**
+ * A layer in the focus stack.
+ * Stores the layer type, an ID for debugging, and a target for focus restoration.
+ */
+export interface FocusLayer {
+    /** Type of focus layer */
+    type: FocusLayerType;
+    /** Unique identifier for this layer instance (for debugging/tracking) */
+    id: string;
+    /** CSS selector to restore focus to when this layer is popped (captured by coordinator) */
+    returnFocusTarget: string | null;
+}
+/**
+ * What the focus machine exposes to consumers.
+ */
+export interface FocusSnapshot {
+    /** Current focus state */
+    state: FocusLayerType;
+    /** Current top layer */
+    currentLayer: FocusLayer;
+    /** Full stack (for debugging) */
+    stack: readonly FocusLayer[];
+    /** Whether grid should handle keyboard events */
+    shouldGridHandle: boolean;
+    /** Whether focus is in an overlay (dialog, commandPalette, contextMenu, formulaPicker) */
+    isInOverlay: boolean;
+}
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/machines/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/machines/snapshots.ts"],"names":[],"mappings":"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"}

package/dist/machines/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Machine Types for State Machines
+ *
+ * Types used by state machines in the renderer architecture.
+ * Moved to contracts to enable decoupling of canvas and state subsystems.
+ *
+ * @module @mog/spreadsheet-contracts/machines/types
+ */
+export type { CellCoord } from '../rendering/coordinates';
+export { RenderPriority } from '../rendering/grid-renderer';
+export type { LayerName } from '../rendering/grid-renderer';
+/**
+ * Selection direction type.
+ * Indicates the direction from the anchor (start) to the active cell (end).
+ * Used for Tab/Enter cycling to determine starting position.
+ */
+export type SelectionDirection = 'down-right' | 'down-left' | 'up-right' | 'up-left';
+/**
+ * Cardinal directions for keyboard navigation and commit actions.
+ */
+export type Direction = 'up' | 'down' | 'left' | 'right';
+/**
+ * All possible renderer states.
+ */
+export type RendererStatus = 'unmounted' | 'waitingForLayout' | 'initializing' | 'ready' | 'switchingSheet' | 'suspended' | 'error' | 'disposing';
+/**
+ * Chart UI states (derived from state machine).
+ * NOTE: 'selected', 'moving', 'resizing' removed - selection/drag/resize handled by objectInteractionActor.
+ * P1-A: Element selection states for chart-specific interactions.
+ */
+export type ChartUIState = 'idle' | 'editing' | 'creating' | 'elementSelected' | 'seriesSelected' | 'pointSelected' | 'titleEditing';
+/**
+ * Focus layer types for the focus machine.
+ */
+export type FocusLayerType = 'grid' | 'editor' | 'formulaBar' | 'dialog' | 'commandPalette' | 'contextMenu' | 'formulaPicker' | 'sheetTabs' | 'formControl';
+/**
+ * Minimal function metadata interface for editor machines.
+ * This is a subset of the full FunctionMetadata from calculator-engine,
+ * containing only what machines need for argument hint insertion.
+ */
+export interface IFunctionMetadata {
+    /** Minimum number of arguments */
+    minArgs?: number;
+    /** Maximum number of arguments (Infinity for variadic) */
+    maxArgs?: number;
+}
+/**
+ * Interface for function registry lookup.
+ * Machines receive this via context injection rather than importing globalRegistry.
+ * This decouples machines from calculator-engine.
+ */
+export interface IFunctionRegistry {
+    /**
+     * Get metadata for a function by name.
+     * @param name Function name (e.g., "SUM", "VLOOKUP")
+     * @returns Function metadata or undefined if not found
+     */
+    getMetadata(name: string): IFunctionMetadata | undefined;
+}
+/**
+ * Colors used for formula range highlighting (matches Excel/Sheets).
+ */
+export declare const FORMULA_RANGE_COLORS: readonly ["#4285f4", "#ea4335", "#9334e6", "#ff6d01", "#34a853", "#46bdc6", "#7baaf7", "#f07b72"];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/machines/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAM5D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAMrF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAMzD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,OAAO,GACP,gBAAgB,GAChB,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAMhB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,cAAc,CAAC;AAMnB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,WAAW,GACX,aAAa,CAAC;AAMlB;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAC1D;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,mGASvB,CAAC"}

package/dist/number-formats/constants.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Number format constants and presets
+ *
+ * Standard Excel-compatible format codes organized by category.
+ */
+import type { NumberFormatType } from '../core';
+import type { FormatCategory, FormatPreset } from './types';
+export declare const FORMAT_CATEGORIES: FormatCategory[];
+export declare const GENERAL_FORMATS: Record<string, FormatPreset>;
+export declare const NUMBER_FORMATS: Record<string, FormatPreset>;
+export declare const CURRENCY_FORMATS: Record<string, FormatPreset>;
+export declare const ACCOUNTING_FORMATS: Record<string, FormatPreset>;
+export declare const DATE_FORMATS: Record<string, FormatPreset>;
+export declare const TIME_FORMATS: Record<string, FormatPreset>;
+export declare const PERCENTAGE_FORMATS: Record<string, FormatPreset>;
+export declare const FRACTION_FORMATS: Record<string, FormatPreset>;
+export declare const SCIENTIFIC_FORMATS: Record<string, FormatPreset>;
+export declare const TEXT_FORMATS: Record<string, FormatPreset>;
+export declare const SPECIAL_FORMATS: Record<string, FormatPreset>;
+export declare const FORMAT_PRESETS: Record<NumberFormatType, Record<string, FormatPreset>>;
+export declare const CURRENCY_SYMBOLS: {
+    symbol: string;
+    name: string;
+    code: string;
+}[];
+export declare const NEGATIVE_FORMATS: ({
+    id: string;
+    label: string;
+    format: string;
+    color?: undefined;
+} | {
+    id: string;
+    label: string;
+    format: string;
+    color: string;
+})[];
+export declare const EXCEL_BUILTIN_FORMATS: Record<number, string>;
+export declare const DEFAULT_FORMAT_BY_TYPE: Record<NumberFormatType, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/number-formats/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/number-formats/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAM5D,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAqB7C,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAExD,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+BvD,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2BzD,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAgB3D,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAuCrD,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA0BrD,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAK3D,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAczD,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAK3D,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAErD,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKxD,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAajF,CAAC;AAMF,eAAO,MAAM,gBAAgB;;;;GA2B5B,CAAC;AAMF,eAAO,MAAM,gBAAgB;;;;;;;;;;IAK5B,CAAC;AAOF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6BxD,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAanE,CAAC"}

package/dist/number-formats/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Number format types, constants, and utility functions
+ *
+ * This module provides type definitions for number formatting,
+ * format constants/presets, and pure format code analysis utilities.
+ *
+ * Runtime code has been extracted to @mog/number-formats.
+ * This module re-exports everything for backward compatibility.
+ *
+ * Runtime value formatting is handled by Rust (compute-formats crate)
+ * via ComputeBridge.formatValues().
+ */
+export type { DateTimeToken, FormatCategory, FormatCondition, FormatOptions, FormatPreset, FormatResult, FormatSection, FormatSelection, LocaleOptions, ParsedFormat, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/number-formats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number-formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAC"}