@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/smartart/types.d.ts

@@ -0,0 +1,323 @@
+/**
+ * SmartArt Types
+ *
+ * Type definitions for SmartArt diagrams. SmartArt provides visual
+ * representations of information like organization charts, process flows,
+ * relationship diagrams, and hierarchies.
+ *
+ * Architecture Notes:
+ * - SmartArtDiagram is the deserialized TypeScript view, NOT Yjs storage
+ * - computedLayout is a runtime cache, NOT persisted to Yjs
+ * - NodeId is a branded type for type safety
+ * - Actual Yjs storage uses Y.Map and Y.Array (handled by bridge layer)
+ */
+import type { ShapeType } from '../objects/floating-objects';
+export type { ShapeType };
+/**
+ * Unique identifier for a SmartArt node.
+ *
+ * This is a branded type for type safety - prevents accidental use of
+ * arbitrary strings as NodeIds. Uses UUID v4 format.
+ */
+export type NodeId = string & {
+    readonly __brand: 'SmartArtNodeId';
+};
+/**
+ * SmartArt diagram categories matching Excel.
+ *
+ * Each category represents a different type of visual representation:
+ * - list: Sequential or grouped items
+ * - process: Steps or stages in a workflow
+ * - cycle: Continuous or circular processes
+ * - hierarchy: Organization charts, tree structures
+ * - relationship: Connections between concepts
+ * - matrix: Grid-based relationships
+ * - pyramid: Proportional or hierarchical layers
+ * - picture: Image-centric layouts
+ */
+export type SmartArtCategory = 'list' | 'process' | 'cycle' | 'hierarchy' | 'relationship' | 'matrix' | 'pyramid' | 'picture';
+/**
+ * Single node in a SmartArt diagram.
+ *
+ * Nodes form a tree structure with parent-child relationships.
+ * Each node can have optional per-node styling that overrides diagram defaults.
+ */
+export interface SmartArtNode {
+    /** Unique node identifier */
+    id: NodeId;
+    /** Text content displayed in the node */
+    text: string;
+    /** Hierarchy level (0 = root, 1 = child, 2 = grandchild, etc.) */
+    level: number;
+    /** Parent node ID (null for root nodes) */
+    parentId: NodeId | null;
+    /** Ordered child node IDs */
+    childIds: NodeId[];
+    /** Order among siblings (used for layout ordering) */
+    siblingOrder: number;
+    /** Fill/background color (CSS color string) */
+    fillColor?: string;
+    /** Border/stroke color (CSS color string) */
+    borderColor?: string;
+    /** Text color (CSS color string) */
+    textColor?: string;
+    /** Font family for node text */
+    fontFamily?: string;
+    /** Font size in points */
+    fontSize?: number;
+    /** Font weight */
+    fontWeight?: 'normal' | 'bold';
+    /** Font style */
+    fontStyle?: 'normal' | 'italic';
+    /** Image URL for picture layouts */
+    imageUrl?: string;
+    /** How the image fits within the node bounds */
+    imageFit?: 'cover' | 'contain' | 'fill';
+}
+/**
+ * SmartArt diagram model (deserialized TypeScript view).
+ *
+ * IMPORTANT: This interface represents the runtime/API view of the data.
+ * Actual Yjs storage uses Y.Map and Y.Array types as defined in
+ * SMARTART_DIAGRAM_SCHEMA. The bridge handles conversion between formats.
+ *
+ * NOTE: computedLayout is NOT part of this interface because it's a
+ * runtime cache managed by the bridge, not persisted data.
+ *
+ * COPY SEMANTICS:
+ * When copying a SmartArtDiagram, the bridge must:
+ * 1. Generate new NodeIds for all nodes (using createNodeId())
+ * 2. Build oldId -> newId mapping
+ * 3. Deep-copy node data (text, styling, level, siblingOrder)
+ * 4. Remap parentId and childIds references using mapping
+ * 5. Update rootNodeIds array with new IDs
+ * 6. Preserve tree structure with new identity
+ */
+export interface SmartArtDiagram {
+    /** Layout ID (e.g., 'hierarchy/org-chart', 'process/basic-process') */
+    layoutId: string;
+    /** Category of the diagram */
+    category: SmartArtCategory;
+    /** Map of all nodes by their ID */
+    nodes: Map<NodeId, SmartArtNode>;
+    /** Top-level (root) node IDs in display order */
+    rootNodeIds: NodeId[];
+    /** Quick style ID (e.g., 'subtle-effect', 'moderate-effect') */
+    quickStyleId: string;
+    /** Color theme ID (e.g., 'colorful-1', 'accent-1') */
+    colorThemeId: string;
+    /** Layout-specific options (varies by layout type) */
+    layoutOptions: Record<string, unknown>;
+}
+/**
+ * SmartArt-specific shape types.
+ *
+ * This is a subset of the full ShapeType union from floating-objects.ts
+ * that SmartArt layouts commonly use. The names match exactly with the
+ * ShapeType definitions to ensure compatibility.
+ */
+export type SmartArtShapeType = 'rect' | 'roundRect' | 'ellipse' | 'diamond' | 'hexagon' | 'chevron' | 'rightArrow' | 'pentagon' | 'trapezoid' | 'parallelogram' | 'plus' | 'star5' | 'cloud' | 'wedgeRectCallout';
+/**
+ * Computed layout result (runtime cache, NOT persisted to Yjs).
+ *
+ * This is calculated by layout algorithms and cached by the bridge.
+ * Invalidated whenever the diagram structure or styling changes.
+ *
+ * Layout computation is expensive, so this cache avoids recalculating
+ * positions on every render.
+ */
+export interface ComputedLayout {
+    /** Computed shape positions and styles for each node */
+    shapes: ComputedShape[];
+    /** Computed connector paths between nodes */
+    connectors: ComputedConnector[];
+    /** Overall bounds of the rendered diagram */
+    bounds: {
+        width: number;
+        height: number;
+    };
+    /** Version number, incremented on each layout change */
+    version: number;
+}
+/**
+ * Computed shape position and style for a single node.
+ *
+ * Contains all information needed to render a node's shape.
+ */
+export interface ComputedShape {
+    /** The node this shape represents */
+    nodeId: NodeId;
+    /** Shape type to render */
+    shapeType: SmartArtShapeType;
+    /** X position in pixels (relative to diagram origin) */
+    x: number;
+    /** Y position in pixels (relative to diagram origin) */
+    y: number;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+    /** Rotation angle in degrees */
+    rotation: number;
+    /** Fill color (CSS color string) */
+    fill: string;
+    /** Stroke/border color (CSS color string) */
+    stroke: string;
+    /** Stroke width in pixels */
+    strokeWidth: number;
+    /** Text content to display */
+    text: string;
+    /** Text styling */
+    textStyle: TextStyle;
+    /** Visual effects (shadow, glow, etc.) */
+    effects: ShapeEffects;
+}
+/**
+ * Type of connector line between nodes.
+ */
+export type ConnectorType = 'straight' | 'elbow' | 'curved' | 'none';
+/**
+ * Path data for rendering a connector.
+ */
+export interface ConnectorPath {
+    /** Path type */
+    type: 'line' | 'bezier' | 'polyline';
+    /** Points along the path */
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** Control points for bezier curves */
+    controlPoints?: Array<{
+        x: number;
+        y: number;
+    }>;
+}
+/**
+ * Computed connector between two nodes.
+ */
+export interface ComputedConnector {
+    /** Source node ID */
+    fromNodeId: NodeId;
+    /** Target node ID */
+    toNodeId: NodeId;
+    /** Connector type */
+    connectorType: ConnectorType;
+    /** Path data for rendering */
+    path: ConnectorPath;
+    /** Stroke color (CSS color string) */
+    stroke: string;
+    /** Stroke width in pixels */
+    strokeWidth: number;
+    /** Arrow head at start of connector */
+    arrowStart?: ArrowHead;
+    /** Arrow head at end of connector */
+    arrowEnd?: ArrowHead;
+}
+/**
+ * Arrow head style for connectors.
+ */
+export interface ArrowHead {
+    /** Arrow head type */
+    type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'open';
+    /** Arrow head size */
+    size: 'small' | 'medium' | 'large';
+}
+/**
+ * Text styling properties for node labels.
+ */
+export interface TextStyle {
+    /** Font family name */
+    fontFamily: string;
+    /** Font size in points */
+    fontSize: number;
+    /** Font weight */
+    fontWeight: 'normal' | 'bold';
+    /** Font style */
+    fontStyle: 'normal' | 'italic';
+    /** Text color (CSS color string) */
+    color: string;
+    /** Horizontal text alignment */
+    align: 'left' | 'center' | 'right';
+    /** Vertical text alignment */
+    verticalAlign: 'top' | 'middle' | 'bottom';
+}
+/**
+ * Visual effects that can be applied to shapes.
+ */
+export interface ShapeEffects {
+    /** Drop shadow effect */
+    shadow?: ShadowEffect;
+    /** Glow effect around the shape */
+    glow?: GlowEffect;
+    /** Reflection effect below the shape */
+    reflection?: ReflectionEffect;
+    /** 3D bevel effect */
+    bevel?: BevelEffect;
+    /** 3D transformation effect */
+    transform3D?: Transform3DEffect;
+}
+/**
+ * Drop shadow effect configuration.
+ */
+export interface ShadowEffect {
+    /** Shadow color (CSS color string) */
+    color: string;
+    /** Blur radius in pixels */
+    blur: number;
+    /** Horizontal offset in pixels */
+    offsetX: number;
+    /** Vertical offset in pixels */
+    offsetY: number;
+    /** Opacity (0 = transparent, 1 = opaque) */
+    opacity: number;
+}
+/**
+ * Glow effect configuration.
+ */
+export interface GlowEffect {
+    /** Glow color (CSS color string) */
+    color: string;
+    /** Glow radius in pixels */
+    radius: number;
+    /** Opacity (0 = transparent, 1 = opaque) */
+    opacity: number;
+}
+/**
+ * Reflection effect configuration.
+ */
+export interface ReflectionEffect {
+    /** Blur amount for the reflection */
+    blur: number;
+    /** Distance from the shape to the reflection */
+    distance: number;
+    /** Opacity of the reflection (0 = transparent, 1 = opaque) */
+    opacity: number;
+    /** Size of the reflection relative to the shape (0-1) */
+    size: number;
+}
+/**
+ * 3D bevel effect configuration.
+ */
+export interface BevelEffect {
+    /** Bevel preset type */
+    type: 'none' | 'relaxed' | 'circle' | 'slope' | 'cross' | 'angle' | 'soft-round' | 'convex' | 'cool-slant' | 'divot' | 'riblet' | 'hard-edge' | 'art-deco';
+    /** Bevel width in pixels */
+    width: number;
+    /** Bevel height in pixels */
+    height: number;
+}
+/**
+ * 3D transformation effect configuration.
+ */
+export interface Transform3DEffect {
+    /** Rotation around X axis in degrees */
+    rotationX: number;
+    /** Rotation around Y axis in degrees */
+    rotationY: number;
+    /** Rotation around Z axis in degrees */
+    rotationZ: number;
+    /** Perspective distance for 3D effect */
+    perspective: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/smartart/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,CAAC;AAM1B;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAMrE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,OAAO,GACP,WAAW,GACX,cAAc,GACd,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAMd;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IAIrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kBAAkB;IAClB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE/B,iBAAiB;IACjB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAIhC,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACzC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,mCAAmC;IACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEjC,iDAAiD;IACjD,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IAErB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IAErB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAMD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,WAAW,GACX,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,eAAe,GACf,MAAM,GACN,OAAO,GACP,OAAO,GACP,kBAAkB,CAAC;AAMvB;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,6CAA6C;IAC7C,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAEhC,6CAA6C;IAC7C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1C,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IAEf,2BAA2B;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAE7B,wDAAwD;IACxD,CAAC,EAAE,MAAM,CAAC;IAEV,wDAAwD;IACxD,CAAC,EAAE,MAAM,CAAC;IAEV,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,SAAS,EAAE,SAAS,CAAC;IAErB,0CAA0C;IAC1C,OAAO,EAAE,YAAY,CAAC;CACvB;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAErC,4BAA4B;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExC,uCAAuC;IACvC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,aAAa,EAAE,aAAa,CAAC;IAE7B,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IAEpB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAEpE,sBAAsB;IACtB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,kBAAkB;IAClB,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE9B,iBAAiB;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE/B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEnC,8BAA8B;IAC9B,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,mCAAmC;IACnC,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,wCAAwC;IACxC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,sBAAsB;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,IAAI,EACA,MAAM,GACN,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,WAAW,GACX,UAAU,CAAC;IAEf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/storage/capabilities.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Table Driver Capabilities
+ *
+ * Capability flags that describe what a table driver can and cannot do.
+ * Apps can check these to enable/disable features based on the data source.
+ *
+ * @see plans/active/desktop-app/DESKTOP-APP-PLAN.md
+ */
+/**
+ * Capability flags for a table driver.
+ * Apps can check these to enable/disable features based on the data source.
+ */
+export interface TableDriverCapabilities {
+    /** Can create new records? */
+    canCreate: boolean;
+    /** Can update existing records? */
+    canUpdate: boolean;
+    /** Can delete records? */
+    canDelete: boolean;
+    /** Supports real-time updates via subscribe()? */
+    canStream: boolean;
+    /** Is data stored locally in the workbook? */
+    isLocal: boolean;
+    /** Supports atomic transactions? */
+    supportsTransactions: boolean;
+    /** Has executeNative() for raw queries? */
+    supportsNativeQuery: boolean;
+    /** Has batch operations (createRecords, updateRecords, deleteRecords)? */
+    supportsBatch: boolean;
+    /** Has subscribe() for real-time change notifications? */
+    supportsWatch: boolean;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/storage/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/storage/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,2CAA2C;IAC3C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAC;CACxB"}

package/dist/storage/connection.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Connection Configuration Types
+ *
+ * Types for configuring data source connections.
+ * Users see these as "Connections" in the UI.
+ *
+ * SECURITY NOTE: Credentials (passwords, tokens) are NOT stored in these configs.
+ * They are stored securely via:
+ * - Desktop (Tauri): System keychain (macOS Keychain, Windows Credential Manager)
+ * - Web: Server-side encrypted storage
+ *
+ * @see plans/active/desktop-app/DESKTOP-APP-PLAN.md
+ */
+declare const TableIdBrand: unique symbol;
+declare const RowIdBrand: unique symbol;
+/**
+ * A branded type for table identifiers.
+ * Ensures type safety when passing table IDs between functions.
+ */
+export type TableId = string & {
+    readonly [TableIdBrand]: never;
+};
+/**
+ * A branded type for row identifiers.
+ * Ensures type safety when passing row IDs between functions.
+ */
+export type RowId = string & {
+    readonly [RowIdBrand]: never;
+};
+/**
+ * Connection status for a table driver.
+ */
+export type ConnectionStatus = 'connected' | 'disconnected' | 'connecting' | 'error';
+/**
+ * Supported driver types.
+ */
+export type DriverType = 'local' | 'postgres' | 'mysql' | 'sqlite' | 'rest' | 'graphql';
+/**
+ * Base configuration shared by all connection types.
+ */
+export interface BaseConnectionConfig {
+    /** Unique identifier for this connection */
+    id: string;
+    /** Display name shown in UI */
+    name: string;
+    /** The driver type */
+    type: DriverType;
+}
+/**
+ * PostgreSQL connection configuration.
+ * Credentials stored in system keychain, NOT here.
+ */
+export interface PostgresConnectionConfig extends BaseConnectionConfig {
+    type: 'postgres';
+    /** Database host */
+    host: string;
+    /** Database port (default: 5432) */
+    port: number;
+    /** Database name */
+    database: string;
+    /** Schema name (default: public) */
+    schema?: string;
+    /** Use SSL connection */
+    ssl?: boolean;
+}
+/**
+ * MySQL connection configuration.
+ * Credentials stored in system keychain, NOT here.
+ */
+export interface MySQLConnectionConfig extends BaseConnectionConfig {
+    type: 'mysql';
+    /** Database host */
+    host: string;
+    /** Database port (default: 3306) */
+    port: number;
+    /** Database name */
+    database: string;
+    /** Use SSL connection */
+    ssl?: boolean;
+}
+/**
+ * SQLite connection configuration.
+ * Desktop only - connects to a local SQLite file.
+ */
+export interface SQLiteConnectionConfig extends BaseConnectionConfig {
+    type: 'sqlite';
+    /** Path to the SQLite database file */
+    filePath: string;
+}
+/**
+ * REST API connection configuration.
+ */
+export interface RestConnectionConfig extends BaseConnectionConfig {
+    type: 'rest';
+    /** Base URL for API requests */
+    baseUrl: string;
+    /** Default headers to include in requests */
+    headers?: Record<string, string>;
+    /** Endpoint mappings for CRUD operations */
+    endpoints: {
+        /** GET endpoint for listing records (e.g., "/users") */
+        list?: string;
+        /** GET endpoint for single record (e.g., "/users/:id") */
+        get?: string;
+        /** POST endpoint for creating records */
+        create?: string;
+        /** PUT/PATCH endpoint for updating records */
+        update?: string;
+        /** DELETE endpoint for deleting records */
+        delete?: string;
+    };
+    /** Pagination configuration */
+    pagination?: {
+        /** Pagination type */
+        type: 'offset' | 'cursor';
+        /** Query parameter for page/cursor (default: "page" or "cursor") */
+        pageParam?: string;
+        /** Query parameter for limit (default: "limit") */
+        limitParam?: string;
+    };
+}
+/**
+ * GraphQL API connection configuration.
+ */
+export interface GraphQLConnectionConfig extends BaseConnectionConfig {
+    type: 'graphql';
+    /** GraphQL endpoint URL */
+    endpoint: string;
+    /** Default headers to include in requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Local connection configuration.
+ * Data stored in the workbook file.
+ */
+export interface LocalConnectionConfig extends BaseConnectionConfig {
+    type: 'local';
+}
+/**
+ * Union of all connection configuration types.
+ */
+export type ConnectionConfig = PostgresConnectionConfig | MySQLConnectionConfig | SQLiteConnectionConfig | RestConnectionConfig | GraphQLConnectionConfig | LocalConnectionConfig;
+/**
+ * Configuration for mapping a table to an external data source.
+ */
+export type SourceConfig = {
+    type: 'table';
+    tableName: string;
+    schema?: string;
+} | {
+    type: 'endpoint';
+    path: string;
+} | {
+    type: 'query';
+    queryName: string;
+} | {
+    type: 'local';
+};
+/**
+ * Maps a table to a connection and data source.
+ * Stored in the workbook file.
+ */
+export interface TableBinding {
+    /** The table ID in the kernel */
+    tableId: TableId;
+    /** The connection ID to use */
+    connectionId: string;
+    /** How to access data from this connection */
+    sourceConfig: SourceConfig;
+}
+/**
+ * When to refresh data from external sources.
+ */
+export type RefreshBehavior = {
+    type: 'manual';
+} | {
+    type: 'onOpen';
+} | {
+    type: 'interval';
+    intervalMs: number;
+};
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/storage/connection.d.ts.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Storage Contracts
+ *
+ * Contracts for table data storage drivers.
+ * Supports local (Yjs) and external (Postgres, REST, etc.) data sources.
+ *
+ * @see plans/active/desktop-app/DESKTOP-APP-PLAN.md
+ */
+export type { ArrayFilterCondition, FilterCondition, FilterGroup, FilterOperator, FilterScalar, NullFilterCondition, ScalarFilterCondition, StringFilterCondition, Query, SortSpec, } from './query';
+export type { TableDriverCapabilities } from './capabilities';
+export type { BaseConnectionConfig, ConnectionConfig, ConnectionStatus, DriverType, GraphQLConnectionConfig, LocalConnectionConfig, MySQLConnectionConfig, PostgresConnectionConfig, RefreshBehavior, RestConnectionConfig, RowId, SQLiteConnectionConfig, SourceConfig, TableBinding, TableId, } from './connection';
+export type { ColumnSchema, ColumnType, DriverError, ITableDriver, PingResult, RecordData, TableChange, TableRecord, TableSchema, Unsubscribe, } from './table-driver';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,EACL,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,gBAAgB,CAAC"}

package/dist/storage/query.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Portable Query Contract
+ *
+ * A query format that ALL table drivers must support.
+ * Translates cleanly to SQL, REST params, GraphQL, and MongoDB.
+ *
+ * Complex operations (joins, aggregations, subqueries) are intentionally
+ * excluded - use the formula engine, pivot engine, or executeNative().
+ *
+ * @see plans/active/desktop-app/DESKTOP-APP-PLAN.md
+ */
+/**
+ * Portable query that ALL drivers must support.
+ * Translates cleanly to SQL, REST params, GraphQL, and MongoDB.
+ *
+ * Complex operations (joins, aggregations, subqueries) are intentionally
+ * excluded - use the formula engine, pivot engine, or executeNative().
+ */
+export interface Query {
+    /** Filter conditions (optional) */
+    where?: FilterGroup;
+    /** Sort specifications (optional) */
+    orderBy?: SortSpec[];
+    /** Maximum number of records to return (optional) */
+    limit?: number;
+    /** Number of records to skip (optional) */
+    offset?: number;
+    /** Column subset to return (optional - returns all if not specified) */
+    select?: string[];
+}
+/**
+ * A group of filter conditions combined with AND or OR.
+ * Can be nested to create complex filter trees.
+ */
+export interface FilterGroup {
+    /** How to combine the conditions */
+    operator: 'and' | 'or';
+    /** The conditions or nested groups to combine */
+    conditions: Array<FilterCondition | FilterGroup>;
+}
+/** Scalar value type for filter comparisons */
+export type FilterScalar = string | number | boolean | null;
+interface FilterConditionBase {
+    /** The column name to filter on */
+    column: string;
+}
+/** eq, neq, gt, gte, lt, lte */
+export interface ScalarFilterCondition extends FilterConditionBase {
+    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte';
+    value: FilterScalar;
+}
+/** contains, startsWith, endsWith */
+export interface StringFilterCondition extends FilterConditionBase {
+    operator: 'contains' | 'startsWith' | 'endsWith';
+    value: string;
+}
+/** in, notIn */
+export interface ArrayFilterCondition extends FilterConditionBase {
+    operator: 'in' | 'notIn';
+    value: FilterScalar[];
+}
+/** isNull, isNotNull */
+export interface NullFilterCondition extends FilterConditionBase {
+    operator: 'isNull' | 'isNotNull';
+}
+/**
+ * A single filter condition comparing a column to a value.
+ * Discriminated union on `operator` for type-safe value access.
+ */
+export type FilterCondition = ScalarFilterCondition | StringFilterCondition | ArrayFilterCondition | NullFilterCondition;
+/**
+ * Supported filter operators.
+ *
+ * These operators are chosen to be portable across all drivers:
+ * - SQL: Direct translation
+ * - REST: Query parameter conventions
+ * - GraphQL: Common filter patterns
+ * - MongoDB: Direct operator mapping
+ */
+export type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
+/**
+ * A sort specification for ordering results.
+ */
+export interface SortSpec {
+    /** The column name to sort by */
+    column: string;
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+}
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/storage/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/storage/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qCAAqC;IACrC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,UAAU,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,CAAC,CAAC;CAClD;AAED,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE5D,UAAU,mBAAmB;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACrD,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAwB;AACxB,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,UAAU,GACV,YAAY,GACZ,UAAU,GACV,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,WAAW,CAAC;AAMhB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B"}