@mog-sdk/spreadsheet-contracts 0.1.12

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

@@ -0,0 +1,5 @@
+/**
+ * Locale defaults and utilities for number formatting.
+ */
+export { DEFAULT_LOCALE } from './locale-defaults';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/number-formats/locale/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/number-formats/locale/locale-defaults.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Default locale settings for number formatting.
+ *
+ * These defaults provide US-style formatting as the baseline.
+ */
+import type { LocaleOptions } from '../types';
+/**
+ * Default locale options for number formatting.
+ *
+ * Stream G: Currency patterns are NOT set by default.
+ * Culture-aware currency positioning only applies when the caller explicitly
+ * passes a locale with currencyPositivePattern/currencyNegativePattern.
+ * This preserves backward compatibility: format codes are interpreted literally
+ * unless culture formatting is explicitly requested.
+ */
+export declare const DEFAULT_LOCALE: LocaleOptions;
+//# sourceMappingURL=locale-defaults.d.ts.map

package/dist/number-formats/locale/locale-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-defaults.d.ts","sourceRoot":"","sources":["../../../src/number-formats/locale/locale-defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,aAW5B,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Excel Number Format Code Registry
+ *
+ * SINGLE SOURCE OF TRUTH for all Excel number format CODE SYNTAX support.
+ *
+ * Runtime code has been extracted to @mog/number-formats.
+ * This module keeps type definitions and re-exports runtime values
+ * for backward compatibility.
+ */
+/**
+ * Priority level for format features
+ */
+export type FeaturePriority = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Category of format feature
+ */
+export type FormatFeatureCategory = 'number-placeholders' | 'separators' | 'percentage' | 'scientific' | 'literals' | 'metacharacters' | 'colors' | 'conditions' | 'sections' | 'fractions' | 'date-tokens' | 'time-tokens' | 'elapsed-time' | 'text';
+/**
+ * Status of a format feature
+ */
+export interface FormatFeatureStatus {
+    /** Feature name */
+    name: string;
+    /** Category of the feature */
+    category: FormatFeatureCategory;
+    /** Pattern or syntax */
+    pattern: string;
+    /** Whether it's implemented */
+    implemented: boolean;
+    /** Implementation priority */
+    priority: FeaturePriority;
+    /** Example format code */
+    example?: string;
+    /** Expected output for example */
+    expectedOutput?: string;
+    /** Implementation notes */
+    notes?: string;
+}
+/**
+ * Excel built-in format definition
+ */
+export interface BuiltInFormat {
+    /** Excel format ID (0-49) */
+    id: number;
+    /** Format code */
+    code: string;
+    /** Whether it's implemented */
+    implemented: boolean;
+    /** Description */
+    description?: string;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/number-formats/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,qBAAqB,GACrB,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,WAAW,GACX,aAAa,GACb,aAAa,GACb,cAAc,GACd,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

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

@@ -0,0 +1,134 @@
+/**
+ * Number format types and interfaces
+ */
+import type { NumberFormatType } from '../core';
+/**
+ * A format preset with code and example display
+ */
+export interface FormatPreset {
+    /** Excel-compatible format code */
+    code: string;
+    /** Example formatted output */
+    example: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Parsed format code structure.
+ * Excel format codes can have up to 4 sections: positive;negative;zero;text
+ */
+export interface ParsedFormat {
+    positive: FormatSection;
+    negative?: FormatSection;
+    zero?: FormatSection;
+    text?: FormatSection;
+}
+/**
+ * A single section of a format code
+ */
+export interface FormatSection {
+    /** Raw format string for this section */
+    raw: string;
+    /** Text prefix before the number */
+    prefix?: string;
+    /** Text suffix after the number */
+    suffix?: string;
+    /** Color directive: [Red], [Blue], [Green], etc. */
+    color?: string;
+    /** Conditional directive: [>100], [<=0], etc. */
+    condition?: FormatCondition;
+    /** Minimum integer digits (0 = none required) */
+    integerDigits: number;
+    /** Decimal places (undefined = none) */
+    decimalDigits?: number;
+    /** Whether to use thousands separator */
+    useThousands: boolean;
+    /** Whether this is a percentage format */
+    isPercent: boolean;
+    /** Whether this is scientific notation */
+    isScientific: boolean;
+    /** Currency symbol if present */
+    currencySymbol?: string;
+    /** Date/time tokens if this is a date format */
+    dateTimeTokens?: DateTimeToken[];
+    /** Whether this section forces text */
+    isText: boolean;
+    /** Fraction format denominator (if fraction) */
+    fractionDenominator?: number;
+    /** Fraction format max denominator digits (e.g., ?/? = 1, ??/?? = 2) */
+    fractionDigits?: number;
+    /** Scale factor for thousands scaling (1000 per trailing comma) */
+    scaleFactor?: number;
+    /** Number of ? placeholders in integer part (for space padding) */
+    integerSpacePlaceholders?: number;
+    /** Number of ? placeholders in decimal part (for space padding) */
+    decimalSpacePlaceholders?: number;
+}
+/**
+ * Conditional format directive
+ */
+export interface FormatCondition {
+    operator: '>' | '>=' | '<' | '<=' | '=' | '<>';
+    value: number;
+}
+/**
+ * Date/time token in a format string
+ */
+export interface DateTimeToken {
+    type: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'ampm' | 'literal';
+    format: string;
+    value?: string;
+}
+/**
+ * Options for building a format code
+ */
+export interface FormatOptions {
+    type: NumberFormatType;
+    decimalPlaces?: number;
+    useThousandsSeparator?: boolean;
+    currencySymbol?: string;
+    negativeFormat?: 'minus' | 'parentheses' | 'minusRed' | 'parenthesesRed';
+    dateFormat?: string;
+    timeFormat?: string;
+    fractionType?: 'halves' | 'quarters' | 'eighths' | 'tenths' | 'hundredths' | 'custom';
+    customDenominator?: number;
+}
+/**
+ * Result of formatting a value
+ */
+export interface FormatResult {
+    /** Formatted display string */
+    text: string;
+    /** Color to apply (from format directives like [Red]) */
+    color?: string;
+    /** Whether this is an error value */
+    isError?: boolean;
+}
+/**
+ * Format selection for UI
+ */
+export interface FormatSelection {
+    /** The format code string to store */
+    formatCode: string;
+    /** Category type for the numberFormatType field */
+    formatType: NumberFormatType;
+}
+/**
+ * Category definition for UI
+ */
+export interface FormatCategory {
+    type: NumberFormatType;
+    label: string;
+    description?: string;
+}
+/**
+ * Re-export LocaleOptions from culture utils.
+ *
+ * This interface provides the subset of CultureInfo properties needed for formatting.
+ * Use getCulture() from the culture registry to get a full CultureInfo, then pass
+ * relevant fields as LocaleOptions.
+ *
+ * Stream G: Currency position/spacing patterns added.
+ */
+export type { LocaleOptions } from '../culture/types';
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/objects/canvas-object.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Universal Canvas Object Types
+ *
+ * App-agnostic base types for floating/canvas objects. These types have ZERO
+ * spreadsheet dependencies and serve as the foundation for all app-specific
+ * object systems (Spreadsheet, Slides, Docs, Whiteboard, etc.).
+ *
+ * The key abstraction is the generic `TAnchor` parameter on `CanvasObject`:
+ * each app provides its own anchor type (e.g., CellAnchor for spreadsheets,
+ * SlideAnchor for slides) and a corresponding `IPositionResolver` to convert
+ * anchors to pixel positions at render time.
+ *
+ * @module @mog/spreadsheet-contracts/objects/canvas-object
+ */
+/**
+ * Open string type for canvas object kinds.
+ * Well-known constants are provided via CANVAS_OBJECT_TYPES and
+ * SPREADSHEET_OBJECT_TYPES, but apps can extend freely with any string.
+ */
+export type CanvasObjectType = string;
+/** Well-known universal object types shared across all apps. */
+export declare const CANVAS_OBJECT_TYPES: {
+    readonly PICTURE: "picture";
+    readonly TEXTBOX: "textbox";
+    readonly SHAPE: "shape";
+    readonly CONNECTOR: "connector";
+    readonly DRAWING: "drawing";
+    readonly GROUP: "group";
+};
+/** Spreadsheet-specific object types. */
+export declare const SPREADSHEET_OBJECT_TYPES: {
+    readonly CHART: "chart";
+    readonly EQUATION: "equation";
+    readonly SMARTART: "smartart";
+    readonly OLE_OBJECT: "oleObject";
+    readonly SLICER: "slicer";
+};
+/**
+ * Base for all canvas objects across all apps.
+ *
+ * The `TAnchor` generic parameter is opaque to the core system — each app
+ * resolves it to pixel positions at render time via `IPositionResolver`.
+ *
+ * @template TAnchor App-specific anchor type (CellAnchor, SlideAnchor, etc.)
+ */
+export interface CanvasObject<TAnchor = unknown> {
+    /** Unique identifier */
+    id: string;
+    /** Object type discriminator */
+    type: CanvasObjectType;
+    /** Container scope: sheetId, slideId, pageId, etc. */
+    containerId: string;
+    /** App-specific anchor — opaque to core, resolved at render time */
+    anchor: TAnchor;
+    /** Z-order (higher = on top) */
+    zIndex: number;
+    /** Whether object is locked (can't be moved/resized) */
+    locked: boolean;
+    /** Whether object appears in print output */
+    printable: boolean;
+    /** Optional name for object */
+    name?: string;
+    /** Alt text for accessibility */
+    altText?: string;
+    /** Created timestamp (Unix ms) */
+    createdAt?: number;
+    /** Last modified timestamp (Unix ms) */
+    updatedAt?: number;
+}
+/**
+ * Resolved pixel bounds. This is what operations work with after anchor
+ * resolution. All values are in pixels relative to the document origin.
+ */
+export interface CanvasObjectPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation?: number;
+    flipH?: boolean;
+    flipV?: boolean;
+}
+/** Generic group for canvas objects. */
+export interface CanvasObjectGroup {
+    /** Unique group identifier */
+    id: string;
+    /** Container scope: sheetId, slideId, pageId, etc. */
+    containerId: string;
+    /** Object IDs in this group (can include other group IDs) */
+    memberIds: string[];
+    /** Z-order for the group (all members inherit) */
+    zIndex: number;
+    /** Group name (optional) */
+    name?: string;
+    /** Whether the group is locked */
+    locked?: boolean;
+}
+/** Generic CRUD for canvas objects. Async — Tauri IPC is the primary runtime. */
+export interface IObjectStore<T extends CanvasObject = CanvasObject> {
+    create(containerId: string, object: T): Promise<{
+        success: boolean;
+        object?: T;
+    }>;
+    read(objectId: string): Promise<{
+        object?: T;
+        containerId?: string;
+    }>;
+    readInDocument(containerId: string): Promise<T[]>;
+    readByType(containerId: string, type: CanvasObjectType): Promise<T[]>;
+    update(objectId: string, updates: Partial<T>, containerId?: string): Promise<{
+        success: boolean;
+        object?: T;
+    }>;
+    delete(objectId: string): Promise<{
+        success: boolean;
+        containerId?: string;
+    }>;
+    deleteBatch(objectIds: string[]): Promise<number>;
+    count(containerId: string): Promise<number>;
+}
+/** Generic group store. */
+export interface IGroupStore<TGroup extends CanvasObjectGroup = CanvasObjectGroup> {
+    create(containerId: string, group: TGroup): Promise<boolean>;
+    read(groupId: string): Promise<TGroup | undefined>;
+    readInDocument(containerId: string): Promise<TGroup[]>;
+    delete(groupId: string): Promise<boolean>;
+}
+/**
+ * Resolves app-specific anchors to pixel positions.
+ *
+ * This is THE key abstraction: each app implements this to convert its native
+ * anchor type (cell-based, slide-based, etc.) to the universal
+ * `CanvasObjectPosition` that operations and rendering work with.
+ *
+ * @template TAnchor App-specific anchor type
+ */
+export interface IPositionResolver<TAnchor = unknown> {
+    /** Resolve an anchor to pixel bounds. Returns null if anchor is invalid. */
+    resolve(containerId: string, anchor: TAnchor): CanvasObjectPosition | null;
+    /** Create an anchor from pixel coordinates. */
+    fromPixels(containerId: string, x: number, y: number, width: number, height: number): TAnchor;
+}
+/** Base event type for canvas object events. */
+export interface CanvasObjectEvent {
+    type: string;
+    containerId: string;
+    objectId?: string;
+    timestamp: number;
+    source?: string;
+}
+/** Generic event bus for canvas object events. */
+export interface ICanvasEventBus {
+    emit(event: CanvasObjectEvent): void;
+    emitBatch(events: CanvasObjectEvent[]): void;
+    on(type: string, handler: (event: CanvasObjectEvent) => void): () => void;
+}
+//# sourceMappingURL=canvas-object.d.ts.map

package/dist/objects/canvas-object.d.ts.map

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

package/dist/objects/drawing-object.d.ts

@@ -0,0 +1,144 @@
+/**
+ * DrawingObject — Universal Resolved Rendering Primitive
+ *
+ * This module defines the DrawingObject type, the universal resolved rendering
+ * primitive for all drawing systems (shapes, SmartArt, WordArt, ink).
+ *
+ * All colors are concrete hex/rgba values (NOT theme references). Theme
+ * resolution happens upstream in bridges. These types are used for rendering
+ * only and are not persisted to Yjs.
+ *
+ * @see ECMA-376 Part 1, Section 20.1 (DrawingML)
+ */
+import type { Scene3D, Shape3D } from '../drawing/three-d';
+import type { AffineTransform, Path } from '../viewport/geometry';
+import type { BevelEffect, GlowEffect, InnerShadowEffect, OuterShadowEffect, ReflectionEffect, SoftEdgeEffect, Transform3DEffect } from '../wordart/effects';
+import type { PatternType } from '../wordart/types';
+/**
+ * The universal resolved rendering primitive for all drawing systems.
+ *
+ * A DrawingObject represents a fully-resolved shape ready for rendering.
+ * It is the output of bridge resolution — all theme colors, style inheritance,
+ * and layout have already been computed. Renderers consume DrawingObjects
+ * directly without needing access to theme or document context.
+ */
+export interface DrawingObject {
+    geometry: Path;
+    fill?: DrawingFill;
+    stroke?: DrawingStroke;
+    effects?: DrawingEffects;
+    scene3d?: Scene3D;
+    sp3d?: Shape3D;
+    text?: DrawingTextBody;
+    transform?: AffineTransform;
+    clip?: Path;
+    children?: DrawingObject[];
+}
+/** Discriminated union for all resolved fill types. Post-theme-resolution using CSS color strings. OOXML raw version (with DrawingColor) is in ooxml-types.ts bridge. */
+export type DrawingFill = {
+    type: 'solid';
+    color: string;
+    opacity?: number;
+} | {
+    type: 'linear-gradient';
+    angle: number;
+    stops: GradientStop[];
+} | {
+    type: 'radial-gradient';
+    centerX: number;
+    centerY: number;
+    radiusX: number;
+    radiusY: number;
+    stops: GradientStop[];
+} | {
+    type: 'pattern';
+    pattern: PatternType;
+    foreground: string;
+    background: string;
+} | {
+    type: 'image';
+    src: string;
+    stretch?: boolean;
+    tile?: boolean;
+    crop?: ImageCrop;
+} | {
+    type: 'none';
+};
+/** GradientStop — Drawing object layer. Maps to CT_GradientStop (dml-main.xsd:1539) with resolved offset + color + opacity. */
+export interface GradientStop {
+    offset: number;
+    color: string;
+    opacity?: number;
+}
+/** Crop insets for an image fill (as fractions or absolute values). */
+export interface ImageCrop {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** Resolved stroke/outline for a drawing object. */
+export interface DrawingStroke {
+    color: string;
+    width: number;
+    opacity?: number;
+    dash?: DashStyle;
+    cap?: 'flat' | 'round' | 'square';
+    join?: 'miter' | 'round' | 'bevel';
+    compound?: 'single' | 'double' | 'thickThin' | 'thinThick' | 'triple';
+}
+/** Line dash pattern styles. Maps to ST_PresetLineDashVal (ECMA-376, dml-main.xsd). */
+export type DashStyle = 'solid' | 'dash' | 'dot' | 'dashDot' | 'dashDotDot' | 'longDash' | 'longDashDot' | 'longDashDotDot';
+/**
+ * Resolved visual effects for a drawing object.
+ *
+ * Uses the canonical ECMA-376 effect types from the WordArt effects module.
+ * Note that outerShadow and innerShadow are arrays (a shape can have multiple).
+ */
+export interface DrawingEffects {
+    outerShadow?: OuterShadowEffect[];
+    innerShadow?: InnerShadowEffect[];
+    glow?: GlowEffect;
+    softEdge?: SoftEdgeEffect;
+    reflection?: ReflectionEffect;
+    bevel?: BevelEffect;
+    transform3D?: Transform3DEffect;
+}
+/** Text content within a drawing object (e.g., text inside a shape). */
+export interface DrawingTextBody {
+    paragraphs: DrawingTextParagraph[];
+    insets: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    anchor: 'top' | 'middle' | 'bottom';
+    wrap: boolean;
+    direction?: 'horizontal' | 'vertical' | 'vertical270';
+    autofit?: 'none' | 'shrink' | 'resize-shape';
+}
+/** A single paragraph within a drawing text body. */
+export interface DrawingTextParagraph {
+    runs: DrawingTextRun[];
+    align?: 'left' | 'center' | 'right' | 'justify';
+    spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+    };
+}
+/** A run of text with uniform styling. */
+export interface DrawingTextRun {
+    text: string;
+    style?: DrawingTextStyle;
+}
+/** Resolved text styling for a drawing text run. */
+export interface DrawingTextStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic';
+    color?: string;
+}
+//# sourceMappingURL=drawing-object.d.ts.map

package/dist/objects/drawing-object.d.ts.map

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