@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/filesystem/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Filesystem abstraction contracts for Spreadsheet OS.
+ *
+ * TYPES ONLY — this module contains only type definitions for the filesystem system.
+ * All runtime code (path utilities, permission functions, error classes, sandbox
+ * helpers) lives in @mog/kernel/services/filesystem/.
+ */
+export type { DeleteOptions, FileEntry, FileStat, IFileSystem, MkdirOptions, RmdirOptions, Unsubscribe, WatchCallback, WatchCreateEvent, WatchDeleteEvent, WatchEvent, WatchModifyEvent, WatchRenameEvent, } from './types';
+export type { AnyPath, DirPath, FilePath } from './paths';
+export type { AccessLevel, AppId, FilePermission, SandboxConfig } from './permissions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1D,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/filesystem/paths.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Type-safe path types for Spreadsheet OS filesystem.
+ *
+ * Uses branded types to distinguish between file paths and directory paths
+ * at compile time, preventing common path-related bugs.
+ *
+ * TYPES ONLY — all runtime path utilities live in @mog/kernel/services/filesystem/paths.
+ */
+/**
+ * Brand symbol for file paths.
+ * @internal
+ */
+declare const FilePathBrand: unique symbol;
+/**
+ * Brand symbol for directory paths.
+ * @internal
+ */
+declare const DirPathBrand: unique symbol;
+/**
+ * A branded string type representing a file path.
+ * Use `filePath()` from kernel to create instances.
+ */
+export type FilePath = string & {
+    readonly [FilePathBrand]: never;
+};
+/**
+ * A branded string type representing a directory path.
+ * Use `dirPath()` from kernel to create instances.
+ */
+export type DirPath = string & {
+    readonly [DirPathBrand]: never;
+};
+/**
+ * Union type for any path (file or directory).
+ */
+export type AnyPath = FilePath | DirPath;
+export {};
+//# sourceMappingURL=paths.d.ts.map

package/dist/filesystem/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/filesystem/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;GAGG;AACH,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/filesystem/permissions.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Filesystem permissions and sandboxing type definitions for Spreadsheet OS.
+ *
+ * TYPES ONLY — all runtime permission functions, error classes, and sandbox
+ * utilities live in @mog/kernel/services/filesystem/permissions.
+ */
+import type { DirPath, FilePath } from './paths';
+/**
+ * Brand symbol for app identifiers.
+ * @internal
+ */
+declare const AppIdBrand: unique symbol;
+/**
+ * A branded string type representing an app identifier.
+ * Use `appId()` from kernel to create instances.
+ */
+export type AppId = string & {
+    readonly [AppIdBrand]: never;
+};
+/**
+ * Access level for a permission grant.
+ */
+export type AccessLevel = 'read' | 'write' | 'read-write';
+/**
+ * A permission grant for accessing a specific path.
+ */
+export interface FilePermission {
+    /**
+     * The app that was granted this permission.
+     */
+    appId: AppId;
+    /**
+     * The path that was granted access to.
+     * Can be a file or directory.
+     */
+    path: FilePath | DirPath;
+    /**
+     * The level of access granted.
+     */
+    access: AccessLevel;
+    /**
+     * Timestamp when permission was granted (ms since epoch).
+     */
+    granted: number;
+    /**
+     * Optional expiry timestamp (ms since epoch).
+     * If undefined, permission does not expire.
+     */
+    expires?: number;
+    /**
+     * Whether this permission includes subdirectories.
+     * Only applicable for directory paths.
+     * @default true
+     */
+    recursive?: boolean;
+}
+/**
+ * Configuration for an app's filesystem sandbox.
+ */
+export interface SandboxConfig {
+    /**
+     * Root path for the sandbox.
+     * All paths will be relative to this unless explicitly allowed.
+     *
+     * @example '~/.spreadsheet-os/apps/com.example.my-app'
+     */
+    rootPath: string;
+    /**
+     * The app identifier.
+     */
+    appId: AppId;
+    /**
+     * Additional paths outside the sandbox that are allowed.
+     * These require explicit user permission grants.
+     */
+    allowedPaths?: FilePermission[];
+    /**
+     * Whether to allow access to the system temp directory.
+     * @default false
+     */
+    allowTempDir?: boolean;
+    /**
+     * Whether to allow network filesystem access.
+     * @default false
+     */
+    allowNetworkPaths?: boolean;
+}
+export {};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/filesystem/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/filesystem/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMjD;;;GAGG;AACH,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAM9D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;;OAGG;IACH,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAEhC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/filesystem/types.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Filesystem abstraction contracts for Spreadsheet OS.
+ *
+ * TYPES ONLY — defines the core filesystem interface that can be implemented
+ * by different backends (native fs, OPFS, memory, etc.) while providing
+ * a consistent API for the application layer.
+ *
+ * Error classes and runtime code live in @mog/kernel/services/filesystem/types.
+ */
+import type { DirPath, FilePath } from './paths';
+/**
+ * Core filesystem interface.
+ *
+ * All operations are async to support both synchronous (native fs) and
+ * asynchronous (OPFS, network) backends uniformly.
+ */
+export interface IFileSystem {
+    /**
+     * Read file contents as binary data.
+     * @param path - Absolute path to the file
+     * @returns File contents as Uint8Array
+     * @throws FileNotFoundError if file doesn't exist
+     * @throws PermissionDeniedError if access is denied
+     */
+    read(path: FilePath): Promise<Uint8Array>;
+    /**
+     * Read file contents as UTF-8 text.
+     * @param path - Absolute path to the file
+     * @returns File contents as string
+     * @throws FileNotFoundError if file doesn't exist
+     * @throws PermissionDeniedError if access is denied
+     */
+    readText(path: FilePath): Promise<string>;
+    /**
+     * Write content to a file, creating or overwriting as needed.
+     * Parent directories must exist.
+     * @param path - Absolute path to the file
+     * @param content - Content to write (binary or text)
+     * @throws PermissionDeniedError if access is denied
+     * @throws DirectoryNotFoundError if parent directory doesn't exist
+     */
+    write(path: FilePath, content: Uint8Array | string): Promise<void>;
+    /**
+     * Append content to a file, creating if it doesn't exist.
+     * Parent directories must exist.
+     * @param path - Absolute path to the file
+     * @param content - Content to append (binary or text)
+     * @throws PermissionDeniedError if access is denied
+     * @throws DirectoryNotFoundError if parent directory doesn't exist
+     */
+    append(path: FilePath, content: Uint8Array | string): Promise<void>;
+    /**
+     * Delete a file.
+     * @param path - Absolute path to the file
+     * @param options.trash - Move to trash instead of permanent delete (default: false)
+     * @throws FileNotFoundError if file doesn't exist
+     * @throws PermissionDeniedError if access is denied
+     */
+    delete(path: FilePath, options?: DeleteOptions): Promise<void>;
+    /**
+     * Check if a file or directory exists.
+     * @param path - Absolute path to check
+     * @returns true if path exists, false otherwise
+     */
+    exists(path: FilePath | DirPath): Promise<boolean>;
+    /**
+     * Get file or directory metadata.
+     * @param path - Absolute path to the file or directory
+     * @returns File statistics
+     * @throws FileNotFoundError if path doesn't exist
+     * @throws PermissionDeniedError if access is denied
+     */
+    stat(path: FilePath | DirPath): Promise<FileStat>;
+    /**
+     * List contents of a directory.
+     * @param dir - Absolute path to the directory
+     * @returns Array of file entries
+     * @throws DirectoryNotFoundError if directory doesn't exist
+     * @throws PermissionDeniedError if access is denied
+     */
+    list(dir: DirPath): Promise<FileEntry[]>;
+    /**
+     * Create a directory.
+     * @param dir - Absolute path to the directory
+     * @param options.recursive - Create parent directories if needed (default: false)
+     * @throws DirectoryExistsError if directory already exists (and not recursive)
+     * @throws PermissionDeniedError if access is denied
+     */
+    mkdir(dir: DirPath, options?: MkdirOptions): Promise<void>;
+    /**
+     * Remove a directory.
+     * @param dir - Absolute path to the directory
+     * @param options.recursive - Remove contents recursively (default: false)
+     * @throws DirectoryNotFoundError if directory doesn't exist
+     * @throws DirectoryNotEmptyError if directory is not empty (and not recursive)
+     * @throws PermissionDeniedError if access is denied
+     */
+    rmdir(dir: DirPath, options?: RmdirOptions): Promise<void>;
+    /**
+     * Rename or move a file.
+     * @param from - Source path
+     * @param to - Destination path
+     * @throws FileNotFoundError if source doesn't exist
+     * @throws FileExistsError if destination already exists
+     * @throws PermissionDeniedError if access is denied
+     */
+    rename(from: FilePath, to: FilePath): Promise<void>;
+    /**
+     * Copy a file.
+     * @param from - Source path
+     * @param to - Destination path
+     * @throws FileNotFoundError if source doesn't exist
+     * @throws FileExistsError if destination already exists
+     * @throws PermissionDeniedError if access is denied
+     */
+    copy(from: FilePath, to: FilePath): Promise<void>;
+    /**
+     * Watch a file or directory for changes.
+     * Not all backends support this operation.
+     * @param path - Path to watch
+     * @param callback - Called when changes occur
+     * @returns Unsubscribe function to stop watching
+     */
+    watch?(path: FilePath | DirPath, callback: WatchCallback): Unsubscribe;
+}
+/**
+ * Options for delete operation.
+ */
+export interface DeleteOptions {
+    /**
+     * Move to trash instead of permanent delete.
+     * @default false
+     */
+    trash?: boolean;
+}
+/**
+ * Options for mkdir operation.
+ */
+export interface MkdirOptions {
+    /**
+     * Create parent directories if they don't exist.
+     * @default false
+     */
+    recursive?: boolean;
+}
+/**
+ * Options for rmdir operation.
+ */
+export interface RmdirOptions {
+    /**
+     * Remove directory contents recursively.
+     * @default false
+     */
+    recursive?: boolean;
+}
+/**
+ * File or directory metadata.
+ */
+export interface FileStat {
+    /**
+     * Size in bytes (0 for directories).
+     */
+    size: number;
+    /**
+     * Creation timestamp (milliseconds since epoch).
+     */
+    created: number;
+    /**
+     * Last modification timestamp (milliseconds since epoch).
+     */
+    modified: number;
+    /**
+     * True if this is a directory.
+     */
+    isDirectory: boolean;
+    /**
+     * True if this is a regular file.
+     */
+    isFile: boolean;
+    /**
+     * True if this is a symbolic link.
+     */
+    isSymlink: boolean;
+}
+/**
+ * Entry in a directory listing.
+ */
+export interface FileEntry {
+    /**
+     * File or directory name (without path).
+     */
+    name: string;
+    /**
+     * Full absolute path.
+     */
+    path: FilePath | DirPath;
+    /**
+     * True if this is a directory.
+     */
+    isDirectory: boolean;
+    /**
+     * True if this is a regular file.
+     */
+    isFile: boolean;
+    /**
+     * True if this is a symbolic link.
+     */
+    isSymlink: boolean;
+}
+/**
+ * Events emitted by file watchers.
+ */
+export type WatchEvent = WatchCreateEvent | WatchModifyEvent | WatchDeleteEvent | WatchRenameEvent;
+/**
+ * File or directory was created.
+ */
+export interface WatchCreateEvent {
+    type: 'create';
+    path: FilePath | DirPath;
+}
+/**
+ * File was modified.
+ */
+export interface WatchModifyEvent {
+    type: 'modify';
+    path: FilePath;
+}
+/**
+ * File or directory was deleted.
+ */
+export interface WatchDeleteEvent {
+    type: 'delete';
+    path: FilePath | DirPath;
+}
+/**
+ * File or directory was renamed/moved.
+ */
+export interface WatchRenameEvent {
+    type: 'rename';
+    oldPath: FilePath | DirPath;
+    newPath: FilePath | DirPath;
+}
+/**
+ * Callback for watch events.
+ */
+export type WatchCallback = (event: WatchEvent) => void;
+/**
+ * Function to stop watching.
+ */
+export type Unsubscribe = () => void;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/fill/custom-lists.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Custom Lists Types
+ *
+ * Type definitions for user-defined fill lists.
+ * Runtime constant (BUILT_IN_LISTS) has been moved to
+ * @mog/kernel/domain/fill/custom-lists.
+ *
+ * @see plans/active/excel-parity/10-FILL-AUTOFILL-PLAN.md
+ */
+/**
+ * A custom fill list.
+ */
+export interface CustomList {
+    /** Unique ID for the list */
+    id: string;
+    /** Display name for the list */
+    name: string;
+    /** The list values in order */
+    values: string[];
+    /** Whether this is a built-in list (cannot be deleted) */
+    isBuiltIn?: boolean;
+}
+/**
+ * Custom list registry interface.
+ * Implementations provide storage and lookup for custom lists.
+ */
+export interface CustomListRegistry {
+    /** All custom lists */
+    lists: CustomList[];
+    /** Get list by ID */
+    getList(id: string): CustomList | undefined;
+    /** Find list that contains a value */
+    findListContainingValue(value: string): CustomList | undefined;
+    /** Add a new list */
+    addList(name: string, values: string[]): CustomList;
+    /** Remove a list */
+    removeList(id: string): boolean;
+    /** Update a list */
+    updateList(id: string, values: string[]): boolean;
+}
+//# sourceMappingURL=custom-lists.d.ts.map

package/dist/fill/custom-lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-lists.d.ts","sourceRoot":"","sources":["../../src/fill/custom-lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,qBAAqB;IACrB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,sCAAsC;IACtC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/D,qBAAqB;IACrB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACpD,oBAAoB;IACpB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,oBAAoB;IACpB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CACnD"}

package/dist/fill/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fill Module - Types Only
+ *
+ * Custom lists types and fill operation types.
+ * Runtime constant (BUILT_IN_LISTS) has been moved to
+ * @mog/kernel/domain/fill/custom-lists.
+ */
+export type { CustomList, CustomListRegistry } from './custom-lists';
+export type { AutoFillChange, AutoFillMode, AutoFillResult, AutoFillWarning, AutoFillWarningKind, DateUnit, FillDirection, FillOptions, FillPatternType, FillSeriesOptions, FillType, FlashFillPreviewValue, SeriesType, } from './types';
+export { DEFAULT_FILL_OPTIONS } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fill/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGrE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,qBAAqB,EACrB,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/fill/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Fill Types
+ *
+ * Pure type definitions for fill/autofill operations.
+ * These types are shared between the domain fill module and other zones
+ * that need to reference fill configuration without depending on the domain layer.
+ *
+ * @module @mog/spreadsheet-contracts/fill
+ */
+import type { CellValue } from '../core';
+/** Direction of a fill operation relative to the source range. */
+export type FillDirection = 'down' | 'right' | 'up' | 'left';
+/** What content types to include in the fill. */
+export type FillType = 'all' | 'formulas' | 'values' | 'formats';
+/** How the fill series should be generated. */
+export type SeriesType = 'auto' | 'copy' | 'linear' | 'growth' | 'date';
+/** Unit for date-based series fills. */
+export type DateUnit = 'day' | 'weekday' | 'month' | 'year';
+/**
+ * Configuration options for a fill operation.
+ * Controls direction, content types, series generation, and visibility handling.
+ */
+export interface FillOptions {
+    direction: FillDirection;
+    fillType: FillType;
+    seriesType: SeriesType;
+    dateUnit?: DateUnit;
+    step?: number;
+    includeFormulas: boolean;
+    includeValues: boolean;
+    includeFormats: boolean;
+    smartFill: boolean;
+    includeValidation?: boolean;
+    skipHiddenRows?: boolean;
+    skipHiddenCols?: boolean;
+    isRowHidden?: (row: number) => boolean;
+    isColHidden?: (col: number) => boolean;
+}
+/** Default fill options used when no overrides are specified. */
+export declare const DEFAULT_FILL_OPTIONS: FillOptions;
+/**
+ * A single cell's preview value for flash fill.
+ * Used to show the user what values flash fill will produce before confirming.
+ */
+export interface FlashFillPreviewValue {
+    row: number;
+    col: number;
+    value: CellValue;
+}
+/**
+ * Fill mode for autoFill() — matches Rust FillMode enum.
+ * Covers the full OfficeJS fill behavior set.
+ */
+export type AutoFillMode = 'auto' | 'copy' | 'series' | 'days' | 'weekdays' | 'months' | 'years' | 'formats' | 'values' | 'withoutFormats' | 'linearTrend' | 'growthTrend';
+/**
+ * Pattern type detected by the fill engine.
+ */
+export type FillPatternType = 'copy' | 'linear' | 'growth' | 'date' | 'time' | 'weekday' | 'weekdayShort' | 'month' | 'monthShort' | 'quarter' | 'ordinal' | 'textWithNumber' | 'customList';
+/** A single cell change produced by the fill engine. */
+export interface AutoFillChange {
+    row: number;
+    col: number;
+    type: 'value' | 'formula' | 'format' | 'clear';
+}
+/**
+ * Result from autoFill() — summary of what the fill engine did.
+ */
+export interface AutoFillResult {
+    /** The pattern that was detected (or forced by mode) */
+    patternType: FillPatternType;
+    /** Number of cells that were filled */
+    filledCellCount: number;
+    /** Any warnings generated during fill */
+    warnings: AutoFillWarning[];
+    /** Per-cell changes listing each cell written */
+    changes: AutoFillChange[];
+}
+export interface AutoFillWarning {
+    row: number;
+    col: number;
+    kind: AutoFillWarningKind;
+}
+export type AutoFillWarningKind = {
+    type: 'mergedCellsInTarget';
+} | {
+    type: 'formulaRefOutOfBounds';
+    refIndex: number;
+} | {
+    type: 'sourceCellEmpty';
+};
+/**
+ * Options for the Fill Series dialog (Edit > Fill > Series).
+ */
+export interface FillSeriesOptions {
+    direction: FillDirection;
+    seriesType: 'linear' | 'growth' | 'date';
+    stepValue: number;
+    stopValue?: number;
+    dateUnit?: DateUnit;
+    trend?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/formatting/format-registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Format Property Registry - Types Only
+ *
+ * Runtime code (FORMAT_PROPERTY_REGISTRY constant, query functions)
+ * has been moved to @mog/kernel/domain/formatting/format-registry.
+ *
+ * This file retains only type definitions.
+ *
+ * @see plans/format-parity/README.md
+ */
+/**
+ * Implementation status for a format property
+ */
+export interface FormatPropertyStatus {
+    /** Property is defined in contracts/src/core.ts CellFormat */
+    contract: boolean;
+    /** Property is imported from XLSX (format-mapper.ts) */
+    import: boolean;
+    /** Property is exported to XLSX (exporter.ts) */
+    export: boolean;
+    /** Property is rendered in canvas (cell-layer.ts) */
+    render: boolean;
+}
+/**
+ * A single format property definition
+ */
+export interface FormatPropertyDef {
+    /** Category of the property */
+    category: FormatCategory;
+    /** Our internal property name (in CellFormat) */
+    property: string;
+    /** ExcelJS field path (e.g., 'font.bold', 'alignment.textRotation') */
+    excelJSField: string;
+    /** Human-readable description */
+    description: string;
+    /** Implementation status */
+    status: FormatPropertyStatus;
+    /** Notes about implementation */
+    notes?: string;
+}
+/**
+ * Format property categories matching Excel's format dialog
+ */
+export type FormatCategory = 'font' | 'alignment' | 'fill' | 'borders' | 'numberFormat' | 'protection';
+//# sourceMappingURL=format-registry.d.ts.map

package/dist/formatting/format-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-registry.d.ts","sourceRoot":"","sources":["../../src/formatting/format-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,WAAW,GACX,MAAM,GACN,SAAS,GACT,cAAc,GACd,YAAY,CAAC"}

package/dist/formatting/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Formatting Module - Types Only
+ *
+ * Runtime code (FORMAT_PROPERTY_REGISTRY, query functions) has been moved to
+ * @mog/kernel/domain/formatting/format-registry.
+ */
+export type { FormatCategory, FormatPropertyDef, FormatPropertyStatus } from './format-registry';
+export * from './theme';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACjG,cAAc,SAAS,CAAC"}