@continuum-dev/contract 0.1.1-alpha.0

package/lib/constants.js

@@ -0,0 +1,71 @@
+/**
+ * Canonical issue taxonomy for reconciliation, validation, and view analysis.
+ */
+export const ISSUE_CODES = {
+    NO_PRIOR_DATA: 'NO_PRIOR_DATA',
+    NO_PRIOR_VIEW: 'NO_PRIOR_VIEW',
+    TYPE_MISMATCH: 'TYPE_MISMATCH',
+    NODE_REMOVED: 'NODE_REMOVED',
+    MIGRATION_FAILED: 'MIGRATION_FAILED',
+    UNVALIDATED_CARRY: 'UNVALIDATED_CARRY',
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    UNKNOWN_NODE: 'UNKNOWN_NODE',
+    DUPLICATE_NODE_ID: 'DUPLICATE_NODE_ID',
+    DUPLICATE_NODE_KEY: 'DUPLICATE_NODE_KEY',
+    VIEW_CHILD_CYCLE_DETECTED: 'VIEW_CHILD_CYCLE_DETECTED',
+    VIEW_MAX_DEPTH_EXCEEDED: 'VIEW_MAX_DEPTH_EXCEEDED',
+    COLLECTION_CONSTRAINT_VIOLATED: 'COLLECTION_CONSTRAINT_VIOLATED',
+    SCOPE_COLLISION: 'SCOPE_COLLISION',
+};
+/**
+ * Outcomes for how a value was handled during reconciliation.
+ */
+export const DATA_RESOLUTIONS = {
+    CARRIED: 'carried',
+    MIGRATED: 'migrated',
+    DETACHED: 'detached',
+    ADDED: 'added',
+    RESTORED: 'restored',
+};
+/**
+ * Node-level structural change classifications between view revisions.
+ */
+export const VIEW_DIFFS = {
+    ADDED: 'added',
+    REMOVED: 'removed',
+    MIGRATED: 'migrated',
+    TYPE_CHANGED: 'type-changed',
+    RESTORED: 'restored',
+};
+/**
+ * Severity levels for reported issues.
+ */
+export const ISSUE_SEVERITY = {
+    ERROR: 'error',
+    WARNING: 'warning',
+    INFO: 'info',
+};
+/**
+ * Canonical interaction categories for event producers/consumers.
+ */
+export const INTERACTION_TYPES = {
+    DATA_UPDATE: 'data-update',
+    VALUE_CHANGE: 'value-change',
+    VIEW_CONTEXT_CHANGE: 'view-context-change',
+};
+const INTERACTION_TYPE_VALUES = new Set(Object.values(INTERACTION_TYPES));
+/**
+ * Runtime type guard for {@link InteractionType}.
+ */
+export function isInteractionType(value) {
+    return typeof value === 'string' && INTERACTION_TYPE_VALUES.has(value);
+}
+/**
+ * Lifecycle states for queued intents.
+ */
+export const INTENT_STATUS = {
+    PENDING: 'pending',
+    VALIDATED: 'validated',
+    STALE: 'stale',
+    CANCELLED: 'cancelled',
+};

package/lib/continuity-snapshot.d.ts

@@ -0,0 +1,16 @@
+import type { ViewDefinition } from './view-definition.js';
+import type { DataSnapshot } from './data-snapshot.js';
+/**
+ * Atomic pairing of a view schema and user-owned runtime data.
+ */
+export interface ContinuitySnapshot {
+    /**
+     * Current structural definition for the UI.
+     */
+    view: ViewDefinition;
+    /**
+     * Current user-owned data aligned to the view.
+     */
+    data: DataSnapshot;
+}
+//# sourceMappingURL=continuity-snapshot.d.ts.map

package/lib/continuity-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity-snapshot.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/continuity-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;CACpB"}

package/lib/continuity-snapshot.js

@@ -0,0 +1 @@
+export {};

package/lib/data-snapshot.d.ts

@@ -0,0 +1,263 @@
+/**
+ * The complete user-owned state of the UI at a specific point in time.
+ * This is kept strictly separate from the ViewDefinition to ensure data survives UI restructures.
+ */
+export interface DataSnapshot {
+    /**
+     * Active values keyed by node id.
+     */
+    values: Record<string, NodeValue>;
+    /**
+     * Per-node UI state keyed by node id.
+     */
+    viewContext?: Record<string, ViewportState>;
+    /**
+     * Provenance for the snapshot as a whole.
+     */
+    lineage: SnapshotLineage;
+    /**
+     * Optional per-value provenance keyed by node id.
+     */
+    valueLineage?: Record<string, ValueLineage>;
+    /**
+     * Values preserved when no longer safely mappable to active nodes.
+     */
+    detachedValues?: Record<string, DetachedValue>;
+}
+/**
+ * Wraps a node's data payload with collaboration and validation metadata.
+ * Designed to safely merge AI suggestions without overwriting dirty user state.
+ *
+ * @template T The underlying data type.
+ */
+export interface NodeValue<T = unknown> {
+    /**
+     * The current, actual value of the node.
+     */
+    value: T;
+    /**
+     * An AI-proposed alternative value awaiting user approval.
+     */
+    suggestion?: T;
+    /**
+     * True if the user has manually edited this value.
+     */
+    isDirty?: boolean;
+    /**
+     * True if the value currently passes the ViewDefinition's constraints.
+     */
+    isValid?: boolean;
+}
+/**
+ * Data state for one collection item.
+ */
+export interface CollectionItemState {
+    /**
+     * Item field values keyed by node id.
+     */
+    values: Record<string, NodeValue>;
+}
+/**
+ * Data state for a collection node.
+ */
+export interface CollectionNodeState {
+    /**
+     * Ordered collection item states.
+     */
+    items: CollectionItemState[];
+}
+/**
+ * Ephemeral viewport and interaction state for a node.
+ */
+export interface ViewportState {
+    /**
+     * Horizontal scroll position.
+     */
+    scrollX?: number;
+    /**
+     * Vertical scroll position.
+     */
+    scrollY?: number;
+    /**
+     * Zoom factor applied to the viewport.
+     */
+    zoom?: number;
+    /**
+     * Horizontal pan offset.
+     */
+    offsetX?: number;
+    /**
+     * Vertical pan offset.
+     */
+    offsetY?: number;
+    /**
+     * Whether the associated UI region is expanded.
+     */
+    isExpanded?: boolean;
+    /**
+     * Whether the associated UI region currently has focus.
+     */
+    isFocused?: boolean;
+}
+/**
+ * Backward-compatible alias for viewport context.
+ */
+export type ViewContext = ViewportState;
+/**
+ * Global provenance metadata for a data snapshot.
+ */
+export interface SnapshotLineage {
+    /**
+     * Snapshot creation/update timestamp.
+     */
+    timestamp: number;
+    /**
+     * Owning session identifier.
+     */
+    sessionId: string;
+    /**
+     * Logical view identity.
+     */
+    viewId?: string;
+    /**
+     * View version associated with this snapshot.
+     */
+    viewVersion?: string;
+    /**
+     * Optional structural hash of the view.
+     */
+    viewHash?: string;
+    /**
+     * Interaction that most recently mutated the snapshot.
+     */
+    lastInteractionId?: string;
+}
+/**
+ * Provenance metadata for a single value key.
+ */
+export interface ValueLineage {
+    /**
+     * Last update timestamp for this value.
+     */
+    lastUpdated?: number;
+    /**
+     * Interaction that last updated this value.
+     */
+    lastInteractionId?: string;
+}
+/**
+ * Preserves user data from nodes that were removed or changed incompatibly.
+ * If the node returns in a compatible shape, this value can be restored.
+ */
+export interface DetachedValue {
+    /**
+     * The preserved user data.
+     */
+    value: unknown;
+    /**
+     * Node type where this value originated.
+     */
+    previousNodeType: string;
+    /**
+     * Optional semantic key used to match and restore this value later.
+     */
+    key?: string;
+    /**
+     * Detachment timestamp.
+     */
+    detachedAt: number;
+    /**
+     * View version at detachment time.
+     */
+    viewVersion: string;
+    /**
+     * Why this value was detached.
+     */
+    reason: 'node-removed' | 'type-mismatch' | 'migration-failed';
+    /**
+     * Number of pushView cycles since detachment.
+     */
+    pushesSinceDetach?: number;
+}
+/**
+ * Optional limits for detached value retention.
+ */
+export interface DetachedValuePolicy {
+    /**
+     * Purge detached values older than this many milliseconds.
+     */
+    maxAge?: number;
+    /**
+     * Keep at most this many detached values, purging oldest first.
+     */
+    maxCount?: number;
+    /**
+     * Purge after this many pushView calls since detachment.
+     */
+    pushCount?: number;
+}
+/**
+ * Models an AI-suggested value alongside the current user value.
+ * Used by conflict-resolution and diff-based approval flows.
+ */
+export interface ProposedValue {
+    /**
+     * Target node id.
+     */
+    nodeId: string;
+    /**
+     * Proposed replacement value.
+     */
+    proposedValue: NodeValue;
+    /**
+     * Current active value.
+     */
+    currentValue: NodeValue;
+    /**
+     * Proposal timestamp.
+     */
+    proposedAt: number;
+    /**
+     * Optional proposal source identifier.
+     */
+    source?: string;
+}
+/**
+ * Display metadata for a registered action intent.
+ */
+export interface ActionRegistration {
+    /**
+     * Human-readable action label.
+     */
+    label: string;
+    /**
+     * Optional helper text for the action.
+     */
+    description?: string;
+    /**
+     * Optional icon token/name for rendering.
+     */
+    icon?: string;
+}
+/**
+ * Runtime context passed to an action handler.
+ */
+export interface ActionContext {
+    /**
+     * Intent identifier being executed.
+     */
+    intentId: string;
+    /**
+     * Snapshot state at execution time.
+     */
+    snapshot: DataSnapshot;
+    /**
+     * Node id that originated the action.
+     */
+    nodeId: string;
+}
+/**
+ * Action execution handler contract.
+ */
+export type ActionHandler = (context: ActionContext) => void | Promise<void>;
+//# sourceMappingURL=data-snapshot.d.ts.map

package/lib/data-snapshot.d.ts.map

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

package/lib/data-snapshot.js

@@ -0,0 +1 @@
+export {};

package/lib/interaction.d.ts

@@ -0,0 +1,29 @@
+import type { ContinuitySnapshot } from './snapshot.js';
+import type { IntentStatus } from './constants.js';
+export interface Interaction {
+    interactionId: string;
+    sessionId: string;
+    nodeId: string;
+    type: string;
+    payload: unknown;
+    timestamp: number;
+    viewVersion: string;
+}
+export interface PendingIntent {
+    intentId: string;
+    nodeId: string;
+    intentName: string;
+    payload: unknown;
+    queuedAt: number;
+    viewVersion: string;
+    status: IntentStatus;
+}
+export interface Checkpoint {
+    checkpointId: string;
+    sessionId: string;
+    snapshot: ContinuitySnapshot;
+    eventIndex: number;
+    timestamp: number;
+    trigger: 'auto' | 'manual';
+}
+//# sourceMappingURL=interaction.d.ts.map

package/lib/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC5B"}

package/lib/interactions.d.ts

@@ -0,0 +1,98 @@
+import type { ContinuitySnapshot } from './continuity-snapshot.js';
+import type { IntentStatus, InteractionType } from './constants.js';
+/**
+ * Immutable interaction event emitted by user or system activity.
+ */
+export interface Interaction {
+    /**
+     * Unique interaction identifier.
+     */
+    interactionId: string;
+    /**
+     * Session identifier for partitioning event streams.
+     */
+    sessionId: string;
+    /**
+     * Target node id.
+     */
+    nodeId: string;
+    /**
+     * Interaction category.
+     */
+    type: InteractionType;
+    /**
+     * Interaction-specific payload.
+     */
+    payload: unknown;
+    /**
+     * Event timestamp.
+     */
+    timestamp: number;
+    /**
+     * View version observed when the event occurred.
+     */
+    viewVersion: string;
+}
+/**
+ * Queued intent awaiting validation/execution.
+ */
+export interface PendingIntent {
+    /**
+     * Unique intent instance identifier.
+     */
+    intentId: string;
+    /**
+     * Node id that originated the intent.
+     */
+    nodeId: string;
+    /**
+     * Intent name/category.
+     */
+    intentName: string;
+    /**
+     * Intent-specific payload.
+     */
+    payload: unknown;
+    /**
+     * Queue timestamp.
+     */
+    queuedAt: number;
+    /**
+     * View version at queue time.
+     */
+    viewVersion: string;
+    /**
+     * Current intent lifecycle status.
+     */
+    status: IntentStatus;
+}
+/**
+ * Durable restore point in a session timeline.
+ */
+export interface Checkpoint {
+    /**
+     * Unique checkpoint identifier.
+     */
+    checkpointId: string;
+    /**
+     * Session identifier for this checkpoint.
+     */
+    sessionId: string;
+    /**
+     * Full continuity snapshot captured at this checkpoint.
+     */
+    snapshot: ContinuitySnapshot;
+    /**
+     * Event stream index associated with this snapshot.
+     */
+    eventIndex: number;
+    /**
+     * Checkpoint creation timestamp.
+     */
+    timestamp: number;
+    /**
+     * Origin of checkpoint creation.
+     */
+    trigger: 'auto' | 'manual';
+}
+//# sourceMappingURL=interactions.d.ts.map

package/lib/interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/interactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,eAAe,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC5B"}

package/lib/interactions.js

@@ -0,0 +1 @@
+export {};

package/lib/schema.d.ts

@@ -0,0 +1,62 @@
+export interface ViewDefinition {
+    viewId: string;
+    version: string;
+    nodes: ViewNode[];
+}
+export type ViewNode = FieldNode | GroupNode | CollectionNode | ActionNode | PresentationNode;
+export interface BaseNode {
+    id: string;
+    type: string;
+    key?: string;
+    hidden?: boolean;
+    hash?: string;
+    migrations?: MigrationRule[];
+}
+export interface FieldNode extends BaseNode {
+    type: 'field';
+    dataType: 'string' | 'number' | 'boolean';
+    label?: string;
+    placeholder?: string;
+    description?: string;
+    readOnly?: boolean;
+    defaultValue?: unknown;
+    constraints?: FieldConstraints;
+}
+export interface GroupNode extends BaseNode {
+    type: 'group';
+    label?: string;
+    children: ViewNode[];
+}
+export interface CollectionNode extends BaseNode {
+    type: 'collection';
+    label?: string;
+    template: ViewNode;
+    minItems?: number;
+    maxItems?: number;
+}
+export interface ActionNode extends BaseNode {
+    type: 'action';
+    intentId: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface PresentationNode extends BaseNode {
+    type: 'presentation';
+    contentType: 'text' | 'markdown';
+    content: string;
+}
+export interface FieldConstraints {
+    required?: boolean;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+export interface MigrationRule {
+    fromHash: string;
+    toHash: string;
+    strategyId?: string;
+}
+export declare function getChildNodes(node: ViewNode): ViewNode[];
+//# sourceMappingURL=schema.d.ts.map

package/lib/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,SAAS,GACT,cAAc,GACd,UAAU,GACV,gBAAgB,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAQxD"}

package/lib/snapshot.d.ts

@@ -0,0 +1,7 @@
+import type { ViewDefinition } from './schema.js';
+import type { DataSnapshot } from './state.js';
+export interface ContinuitySnapshot {
+    view: ViewDefinition;
+    data: DataSnapshot;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;CACpB"}

package/lib/state.d.ts

@@ -0,0 +1,39 @@
+export interface DataSnapshot {
+    values: Record<string, NodeValue>;
+    viewContext?: Record<string, ViewContext>;
+    lineage: SnapshotLineage;
+    valueLineage?: Record<string, ValueLineage>;
+    detachedValues?: Record<string, DetachedValue>;
+}
+export interface NodeValue<T = unknown> {
+    value: T;
+    isDirty?: boolean;
+    isValid?: boolean;
+}
+export interface ViewContext {
+    scrollX?: number;
+    scrollY?: number;
+    isExpanded?: boolean;
+    isFocused?: boolean;
+}
+export interface SnapshotLineage {
+    timestamp: number;
+    sessionId: string;
+    viewId?: string;
+    viewVersion?: string;
+    viewHash?: string;
+    lastInteractionId?: string;
+}
+export interface ValueLineage {
+    lastUpdated?: number;
+    lastInteractionId?: string;
+}
+export interface DetachedValue {
+    value: unknown;
+    previousNodeType: string;
+    key?: string;
+    detachedAt: number;
+    viewVersion: string;
+    reason: 'node-removed' | 'type-mismatch' | 'migration-failed';
+}
+//# sourceMappingURL=state.d.ts.map

package/lib/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../packages/contract/src/lib/state.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,GAAG,eAAe,GAAG,kBAAkB,CAAC;CAC/D"}