@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/store/store-types.d.ts

@@ -0,0 +1,381 @@
+/**
+ * Store Types - Type definitions for cell storage.
+ *
+ * These types define the internal storage format for cells, sheets, and filters.
+ * They are used by domain modules and bridge the gap between the contracts API
+ * and the storage implementation.
+ *
+ * Cell Identity Model:
+ * - Cells are keyed by stable CellId (UUID), not position
+ * - Position (row, col) is stored IN the cell data, not AS the key
+ * - Grid index maps position -> CellId for O(1) lookup
+ *
+ * NOTE: These types use standard Map/Array instead of Yjs CRDT types.
+ * The storage layer is responsible for providing Map-compatible containers.
+ *
+ * @see plans/cell-ids/CELL-IDENTITY-MODEL.md
+ */
+import type { CellId, ColData, ColId, IdentityFormula, IdentityMergedRegion, RowData, RowId } from '../cells/cell-identity';
+import type { FormulaA1 } from '../cells/formula-string';
+import type { CellFormat, CellProperties, CellRawValue, CellValue, SheetId } from '../core';
+import type { ColumnSchema, RangeSchema } from '../core/schema';
+import type { FilterType } from '../data/filter';
+import type { StoredSlicerConfig } from '../data/slicers';
+import type { TableConfig } from '../data/tables';
+import type { Comment } from '../document/comments';
+import type { FormControl } from '../editor/form-controls';
+import type { FloatingObject, FloatingObjectGroup } from '../objects/floating-objects';
+/**
+ * Cached used range for O(1) Ctrl+End navigation.
+ * Stores the bounding box end point of all non-empty cells.
+ */
+export interface UsedRange {
+    /** Maximum row index with data (0-indexed) */
+    endRow: number;
+    /** Maximum column index with data (0-indexed) */
+    endCol: number;
+}
+/**
+ * Sheet metadata stored in Yjs.
+ * Contains dimensions, frozen panes, and display properties.
+ */
+export interface SheetMeta {
+    id: SheetId;
+    name: string;
+    /** Default row height for new rows in pixels */
+    defaultRowHeight: number;
+    /** Default column width for new columns in pixels */
+    defaultColWidth: number;
+    /** Number of frozen rows (always visible) */
+    frozenRows: number;
+    /** Number of frozen columns (always visible) */
+    frozenCols: number;
+    /** Tab color in hex format (e.g., "#4285f4"), null for default */
+    tabColor?: string | null;
+    /** Whether the sheet is hidden */
+    hidden?: boolean;
+    /**
+     * Cached used range for O(1) Ctrl+End navigation.
+     * Updated incrementally on cell writes. May over-estimate on deletions.
+     */
+    usedRange?: UsedRange | null;
+}
+/**
+ * Internal cell data for Yjs storage (Cell Identity Model).
+ *
+ * Key insight: Position is stored IN the cell, not AS the key.
+ * This enables O(1) position updates on insert/delete row/col
+ * without touching formula strings or dependency graph keys.
+ *
+ * NOTE: The external API `CellData` in contracts/src/core.ts is UNCHANGED.
+ * This type is for internal Yjs storage only. Conversion happens at API boundaries.
+ */
+export interface StoreCellData {
+    /** Stable cell identity - never changes even when cell moves */
+    id: CellId;
+    /** Current row position (mutable on structure changes) */
+    row: number;
+    /** Current column position (mutable on structure changes) */
+    col: number;
+    /**
+     * Raw value entered by user (CellRawValue).
+     * Can be a formula string, literal primitive, or RichText array.
+     * Rich text is only valid for literal values, not formula results.
+     * Use rawToCellValue() to convert to CellValue when needed.
+     */
+    raw: CellRawValue;
+    /**
+     * A1-style formula string with '=' prefix (FormulaA1).
+     * Used for formula bar display and calculator evaluation.
+     * This is the backward-compatible formula field.
+     */
+    formula?: FormulaA1;
+    /**
+     * Parsed formula with identity references.
+     * Used for stable formula storage that survives structure changes.
+     * When populated, this is the source of truth for formula references.
+     */
+    identityFormula?: IdentityFormula;
+    /** Computed value after formula evaluation (only set if raw is a formula) */
+    computed?: CellValue;
+    /** Cell note/comment (optional) */
+    note?: string;
+    /** Hyperlink URL (optional) */
+    hyperlink?: string;
+    /**
+     * For spill anchor cells: the dimensions of the spill range.
+     * { rows, cols } where rows >= 1 and cols >= 1.
+     */
+    spillRange?: {
+        rows: number;
+        cols: number;
+    };
+    /**
+     * For spill member cells: CellId of the anchor cell containing the formula.
+     */
+    spillAnchor?: CellId;
+    /**
+     * True if this is a legacy CSE (Ctrl+Shift+Enter) array formula.
+     */
+    isCSE?: boolean;
+}
+/**
+ * Serialized cell data for Yjs storage.
+ * Uses short keys for compact CRDT storage.
+ *
+ * NOTE: The DiffCellData type (previously in contracts/src/versioning.ts)
+ * was removed when the versioning package was deleted.
+ */
+export interface SerializedCellData {
+    /** Stable cell identity */
+    id: CellId;
+    /** Row position */
+    row: number;
+    /** Column position */
+    col: number;
+    /**
+     * Raw value (CellRawValue).
+     * Can be a primitive (string, number, boolean, null) or RichText array.
+     * Rich text is only valid for literal values, not formula results.
+     * Use isRichText() from @mog/spreadsheet-contracts to discriminate.
+     * Use rawToCellValue() to convert to CellValue when needed.
+     */
+    r: CellRawValue;
+    /** A1-style formula string without '=' prefix (backward compatible) */
+    f?: string;
+    /** Parsed identity formula */
+    idf?: IdentityFormula;
+    /** Computed value (omit if same as raw) */
+    c?: CellValue;
+    /** Note (omit if empty) */
+    n?: string;
+    /** Hyperlink URL (omit if none) */
+    h?: string;
+    /**
+     * For spill anchor cells: the dimensions of the spill range.
+     * { rows, cols } where rows >= 1 and cols >= 1.
+     * Only present on the cell containing the array formula.
+     */
+    spillRange?: {
+        rows: number;
+        cols: number;
+    };
+    /**
+     * For spill member cells: CellId of the anchor cell containing the formula.
+     * Points back to the cell that owns this spill range.
+     * Used for:
+     * - Determining if editing this cell should be blocked
+     * - Finding the formula when clicking a spill cell
+     * - Clearing old spill when anchor formula result changes size
+     */
+    spillAnchor?: CellId;
+    /**
+     * True if this is a legacy CSE (Ctrl+Shift+Enter) array formula.
+     * CSE formulas have fixed size and show {=formula} in the formula bar.
+     * Only present on anchor cells when isCSE is true.
+     */
+    isCSE?: boolean;
+}
+/**
+ * Yjs-compatible filter state for storage (Cell Identity Model).
+ *
+ * ARCHITECTURE: Stores CellIds for range corners and column filter keys,
+ * NOT position-based row/col numbers. This follows the same pattern as:
+ * - IdentityRangeRef (formulas)
+ * - IdentityRangeSchemaRef (data validation)
+ * - IdentityMergedRegion (merged cells)
+ *
+ * Why CellId-based?
+ * - Survives row/col insert/delete (positions change, CellIds stable)
+ * - CRDT-safe for concurrent structure changes
+ * - Matches the Cell Identity Model used throughout the codebase
+ *
+ * The filter-operations module handles conversion between FilterState and StoredFilterState.
+ */
+export interface StoredFilterState {
+    /** Unique filter identifier (UUID v7) */
+    id: string;
+    /** Filter type: 'autoFilter' | 'tableFilter' | 'advancedFilter' */
+    type: FilterType;
+    /**
+     * CellId of the header row, first column (top-left of header).
+     * Example: If filter is on A1:C10, this is the CellId of A1.
+     */
+    headerStartCellId: CellId;
+    /**
+     * CellId of the header row, last column (top-right of header).
+     * Example: If filter is on A1:C10, this is the CellId of C1.
+     */
+    headerEndCellId: CellId;
+    /**
+     * CellId of the last data row, first column (defines data extent).
+     * Example: If filter is on A1:C10, this is CellId of A10.
+     */
+    dataEndCellId: CellId;
+    /**
+     * Per-column filter criteria.
+     * JSON-serialized Record<CellId, ColumnFilterCriteria>.
+     * Keyed by header cell CellId (not column index) for CRDT safety.
+     * Stored as string because Yjs doesn't handle nested complex objects well.
+     */
+    columnFilters: string;
+    /**
+     * Current sort state (JSON-serialized FilterSortState).
+     * Optional - only present if filter has sorting applied.
+     * FilterSortState.columnCellId is a CellId, not column index.
+     */
+    sortState?: string;
+    /** Associated table ID for tableFilter type */
+    tableId?: string;
+    /** When this filter was created (Unix ms) */
+    createdAt?: number;
+    /** When this filter was last modified (Unix ms) */
+    updatedAt?: number;
+}
+/**
+ * References to all Yjs maps within a single sheet.
+ * Used by domain modules to access sheet data without coupling to the store.
+ *
+ * Cell Identity Model Architecture:
+ * - cells: Map<CellId, SerializedCellData> - primary storage by stable ID
+ * - properties: Map<CellId, CellProperties> - sparse formatting by ID
+ * - grid: Map<"row:col", CellId> - position lookup for rendering
+ *
+ * Row/Column Identity Model Architecture:
+ * - rows: Map<RowId, RowData> - primary storage by stable ID
+ * - cols: Map<ColId, ColData> - primary storage by stable ID
+ * - rowIndex: Map<"position", RowId> - position lookup
+ * - colIndex: Map<"position", ColId> - position lookup
+ * - rowHeights: Map<RowId, number> - keyed by identity (stable)
+ * - colWidths: Map<ColId, number> - keyed by identity (stable)
+ * - rowFormats: Map<RowId, CellFormat> - keyed by identity (stable)
+ * - colFormats: Map<ColId, CellFormat> - keyed by identity (stable)
+ *
+ * @see plans/active/refactor/ROW-COLUMN-IDENTITY.md
+ */
+export interface SheetMaps {
+    /** Sheet metadata (id, name, frozen rows/cols, etc.) */
+    meta: Map<string, unknown>;
+    /**
+     * Primary cell storage: Map<CellId, SerializedCellData>
+     * Cells are keyed by stable UUID. Position is stored in the value.
+     * On insert/delete row/col, only position values change - no key changes.
+     */
+    cells: Map<string, SerializedCellData>;
+    /**
+     * Cell properties: Map<CellId, CellProperties>
+     * Sparse storage - only cells with non-default formatting have entries.
+     * Keyed by CellId for CRDT stability (no key changes on structure ops).
+     */
+    properties: Map<string, CellProperties>;
+    /**
+     * Position index: Map<"row:col", CellId>
+     * Enables O(1) lookup of "what cell is at position X,Y?" for rendering.
+     * Derived state, kept in sync within transactions.
+     */
+    grid: Map<string, CellId>;
+    /**
+     * Primary row storage: Map<RowId, RowData>
+     * Rows are keyed by stable UUID. Position is stored in the value.
+     * On insert/delete rows, only position values change - no key changes.
+     * Lazily materialized - only rows with custom properties have entries.
+     */
+    rows: Map<string, RowData> | undefined;
+    /**
+     * Row position index: Map<"position", RowId>
+     * Enables O(1) lookup of "what RowId is at position Y?" for property lookup.
+     * Derived state, kept in sync within transactions.
+     * Lazily created when first row is materialized.
+     */
+    rowIndex: Map<string, RowId> | undefined;
+    /**
+     * Row heights: Map<RowId, number>
+     * Keyed by RowId for CRDT stability (no key changes on structure ops).
+     * Sparse storage - only rows with custom height have entries.
+     */
+    rowHeights: Map<string, number>;
+    /**
+     * Row formats: Map<RowId, CellFormat>
+     * Keyed by RowId for CRDT stability (no key changes on structure ops).
+     * Sparse storage - only rows with non-default formatting have entries.
+     * Used for format inheritance: cell -> row -> column -> default.
+     * Lazily created when first row format is set.
+     */
+    rowFormats: Map<string, CellFormat> | undefined;
+    /**
+     * Primary column storage: Map<ColId, ColData>
+     * Columns are keyed by stable UUID. Position is stored in the value.
+     * On insert/delete columns, only position values change - no key changes.
+     * Lazily materialized - only columns with custom properties have entries.
+     */
+    cols: Map<string, ColData> | undefined;
+    /**
+     * Column position index: Map<"position", ColId>
+     * Enables O(1) lookup of "what ColId is at position X?" for property lookup.
+     * Derived state, kept in sync within transactions.
+     * Lazily created when first column is materialized.
+     */
+    colIndex: Map<string, ColId> | undefined;
+    /**
+     * Column widths: Map<ColId, number>
+     * Keyed by ColId for CRDT stability (no key changes on structure ops).
+     * Sparse storage - only columns with custom width have entries.
+     */
+    colWidths: Map<string, number>;
+    /**
+     * Column formats: Map<ColId, CellFormat>
+     * Keyed by ColId for CRDT stability (no key changes on structure ops).
+     * Sparse storage - only columns with non-default formatting have entries.
+     * Used for format inheritance: cell -> row -> column -> default.
+     * Lazily created when first column format is set.
+     */
+    colFormats: Map<string, CellFormat> | undefined;
+    /** Column schemas: Map<colIndex, ColumnSchema> */
+    schemas: Map<string, ColumnSchema> | undefined;
+    /** Charts: Map<chartId, FloatingObject> — chart-type floating objects */
+    charts: Map<string, FloatingObject>;
+    /** Range schemas (data validation): Map<schemaId, RangeSchema> */
+    rangeSchemas: Map<string, RangeSchema> | undefined;
+    /** Hidden row indices (Stream E2): Array of row numbers */
+    hiddenRows: Array<number> | undefined;
+    /** Hidden column indices (Stream E2): Array of column numbers */
+    hiddenCols: Array<number> | undefined;
+    /** Excel-style tables (Stream M): Map<tableId, TableConfig> */
+    tables: Map<string, TableConfig> | undefined;
+    /** Row/column grouping config (Stream O): Map with grouping settings */
+    groupingConfig: Map<string, unknown> | undefined;
+    /**
+     * Merged cell regions: Map<CellId, IdentityMergedRegion>
+     * Keyed by topLeftId for O(1) lookup and CRDT-safe concurrent merges.
+     * CellId-based storage ensures merges compose correctly under structure changes.
+     */
+    merges: Map<string, IdentityMergedRegion>;
+    /** Floating objects (Stream N): Map<objectId, FloatingObject> */
+    floatingObjects: Map<string, FloatingObject> | undefined;
+    /** Floating object groups (Stream N): Map<groupId, FloatingObjectGroup> */
+    floatingObjectGroups: Map<string, FloatingObjectGroup> | undefined;
+    /** Form controls: Map<controlId, FormControl> */
+    formControls: Map<string, FormControl> | undefined;
+    /** Filters (Layer 0 - Filter State Foundation): Map<filterId, StoredFilterState> */
+    filters: Map<string, StoredFilterState> | undefined;
+    /**
+     * Cell comments (Stream C3 - Comments & Rich Text): Map<commentId, Comment>
+     * Comments reference cells via CellId for CRDT-safe structure changes.
+     * Lazily created when first comment is added.
+     */
+    comments: Map<string, Comment> | undefined;
+    /**
+     * Slicers (Stream ES - Slicers): Map<slicerId, StoredSlicerConfig>
+     * Slicers are visual filter controls for Tables and Pivot Tables.
+     * Uses Cell Identity Model for column references (CellId, not column index).
+     * Lazily created when first slicer is added.
+     */
+    slicers: Map<string, StoredSlicerConfig> | undefined;
+    /**
+     * Data bindings for external data connections (Stream DB).
+     * Maps binding IDs to data binding configurations.
+     * Lazily created when first data binding is added.
+     */
+    dataBindings: Map<string, unknown> | undefined;
+}
+//# sourceMappingURL=store-types.d.ts.map

package/dist/store/store-types.d.ts.map

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

package/dist/store/wordart-schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * WordArt Schema - Type Definitions Only
+ *
+ * Runtime schema objects, defaults, factory functions, and utility functions have been moved to:
+ * @see @mog/kernel/defaults/wordart
+ *
+ * This file retains only the type exports for the contracts layer.
+ */
+/**
+ * Type for the schema keys - all valid WordArtConfig field names.
+ */
+export type WordArtSchemaField = 'warpPreset' | 'warpAdjustments' | 'fill' | 'outline' | 'effects' | 'followPath' | 'anchor' | 'textDirection' | 'normalizeHeights';
+//# sourceMappingURL=wordart-schema.d.ts.map

package/dist/store/wordart-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordart-schema.d.ts","sourceRoot":"","sources":["../../src/store/wordart-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,iBAAiB,GACjB,MAAM,GACN,SAAS,GACT,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,eAAe,GACf,kBAAkB,CAAC"}

package/dist/store/workbook-schema.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WorkbookSettings Schema - Type Definitions Only
+ *
+ * Runtime schema objects, defaults, and utility functions have been moved to:
+ * @see @mog/kernel/defaults/workbook
+ *
+ * This file retains only the type exports for the contracts layer.
+ */
+/**
+ * Type for the schema keys - all valid WorkbookSettings field names.
+ *
+ * NOTE: The actual WORKBOOK_SETTINGS_SCHEMA object lives in @mog/kernel/defaults/workbook.
+ * This type is kept here for contracts-level type checking.
+ */
+export type WorkbookSettingsField = 'showHorizontalScrollbar' | 'showVerticalScrollbar' | 'autoHideScrollBars' | 'showTabStrip' | 'showFormulaBar' | 'allowSheetReorder' | 'autoFitOnDoubleClick' | 'showCutCopyIndicator' | 'allowDragFill' | 'enterKeyDirection' | 'allowCellDragDrop' | 'themeId' | 'themeFontsId' | 'culture' | 'selectedSheetIds' | 'isWorkbookProtected' | 'workbookProtectionPasswordHash' | 'workbookProtectionOptions' | 'calculationSettings' | 'date1904' | 'defaultTableStyleId' | 'appInstances';
+//# sourceMappingURL=workbook-schema.d.ts.map

package/dist/store/workbook-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook-schema.d.ts","sourceRoot":"","sources":["../../src/store/workbook-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC7B,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,SAAS,GACT,cAAc,GACd,SAAS,GACT,kBAAkB,GAClB,qBAAqB,GACrB,gCAAgC,GAChC,2BAA2B,GAC3B,qBAAqB,GACrB,UAAU,GACV,qBAAqB,GACrB,cAAc,CAAC"}

package/dist/styles/built-in-styles.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Built-in Cell Styles - Types Only
+ *
+ * Runtime code (BUILT_IN_STYLES constant, helper functions, category constants)
+ * has been moved to @mog/kernel/domain/cells/built-in-styles.
+ *
+ * This file is kept empty to avoid breaking any residual imports.
+ * All consumers should import from @mog/kernel/domain/cells/built-in-styles.
+ */
+//# sourceMappingURL=built-in-styles.d.ts.map

package/dist/styles/built-in-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-styles.d.ts","sourceRoot":"","sources":["../../src/styles/built-in-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/styles/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Styles Module - Types Only
+ *
+ * Runtime code (BUILT_IN_STYLES, helper functions, category constants)
+ * has been moved to @mog/kernel/domain/cells/built-in-styles.
+ *
+ * This module retains only type exports.
+ */
+/**
+ * Information about a missing font detected during import.
+ */
+export interface MissingFontInfo {
+    /** The font name from the XLSX file that is not available */
+    originalFont: string;
+    /** The font that will be used as a substitute */
+    substituteFont: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/utils/a1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A1 Notation Utility Functions
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/a1.
+ * Import directly from there.
+ *
+ * Types re-exported for backward compatibility.
+ *
+ * @see plans/archive/refactor/cleanup-round2/02-CONTRACTS-RUNTIME-EXTRACTION.md
+ */
+export type { ParsedCellAddress, ParsedCellRange } from '@mog/spreadsheet-utils/a1';
+//# sourceMappingURL=a1.d.ts.map

package/dist/utils/a1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a1.d.ts","sourceRoot":"","sources":["../../src/utils/a1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/utils/datetime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Date/Time utilities for Excel serial number conversion
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/datetime.
+ * Import directly from there.
+ */
+//# sourceMappingURL=datetime.d.ts.map

package/dist/utils/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/utils/datetime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/function-registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Function Registry -- Lightweight metadata registry for Excel functions.
+ *
+ * Types remain here in contracts. The FunctionRegistry class and globalRegistry
+ * singleton have been moved to @mog/spreadsheet-utils/function-registry.
+ *
+ * Migrated from @mog/calculator.
+ */
+export type FunctionArgumentType = 'number' | 'text' | 'logical' | 'reference' | 'array' | 'any' | 'date';
+export interface FunctionArgument {
+    name: string;
+    description: string;
+    type: FunctionArgumentType;
+    optional: boolean;
+    repeating?: boolean;
+}
+export interface FunctionMetadata {
+    name: string;
+    category: FunctionCategory;
+    description: string;
+    minArgs?: number;
+    maxArgs?: number;
+    isVolatile?: boolean;
+    arguments?: FunctionArgument[];
+}
+export declare enum FunctionCategory {
+    MATH = "Math",
+    STATISTICAL = "Statistical",
+    TEXT = "Text",
+    LOGICAL = "Logical",
+    DATE_TIME = "Date & Time",
+    LOOKUP = "Lookup & Reference",
+    FINANCIAL = "Financial",
+    INFORMATION = "Information",
+    DATABASE = "Database",
+    ENGINEERING = "Engineering",
+    WEB = "Web",
+    TESTING = "Testing"
+}
+//# sourceMappingURL=function-registry.d.ts.map

package/dist/utils/function-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-registry.d.ts","sourceRoot":"","sources":["../../src/utils/function-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,MAAM,GACN,SAAS,GACT,WAAW,GACX,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,oBAAY,gBAAgB;IAC1B,IAAI,SAAS;IACb,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,SAAS,gBAAgB;IACzB,MAAM,uBAAuB;IAC7B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Contract Utility Types
+ *
+ * Runtime utilities have been moved to @mog/spreadsheet-utils.
+ * Only types remain here.
+ */
+export type { ParsedCellAddress, ParsedCellRange } from './a1';
+export { FunctionCategory, type FunctionArgument, type FunctionArgumentType, type FunctionMetadata, } from './function-registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAG/D,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/utils/protection.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Protection Utility Functions
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/protection.
+ * Import directly from there.
+ *
+ * @see plans/archive/refactor/cleanup-round2/02-CONTRACTS-RUNTIME-EXTRACTION.md
+ */
+//# sourceMappingURL=protection.d.ts.map

package/dist/utils/protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protection.d.ts","sourceRoot":"","sources":["../../src/utils/protection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/utils/range-navigation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Range Navigation Functions
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/range.
+ * Import directly from there.
+ *
+ * @see plans/archive/refactor/cleanup-round2/02-CONTRACTS-RUNTIME-EXTRACTION.md
+ */
+//# sourceMappingURL=range-navigation.d.ts.map

package/dist/utils/range-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-navigation.d.ts","sourceRoot":"","sources":["../../src/utils/range-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/utils/range.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Range Utility Functions
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/range.
+ * Import directly from there.
+ *
+ * @see plans/archive/refactor/cleanup-round2/02-CONTRACTS-RUNTIME-EXTRACTION.md
+ */
+//# sourceMappingURL=range.d.ts.map

package/dist/utils/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/utils/range.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/utils/rich-text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Rich Text Utility Functions
+ *
+ * Runtime functions have been moved to @mog/spreadsheet-utils/rich-text.
+ * Import directly from there.
+ *
+ * @see plans/archive/refactor/cleanup-round2/02-CONTRACTS-RUNTIME-EXTRACTION.md
+ */
+//# sourceMappingURL=rich-text.d.ts.map

package/dist/utils/rich-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../../src/utils/rich-text.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}