@czap/core 0.1.0

package/dist/hlc.js

@@ -0,0 +1,219 @@
+/**
+ * HLC -- Hybrid Logical Clock.
+ *
+ * Pure functions + Effect-based managed clock.
+ *
+ * @module
+ */
+import { Ref } from 'effect';
+/**
+ * Create a new HLC timestamp initialized to zero for the given node.
+ *
+ * @example
+ * ```ts
+ * const hlc = HLC.create('node-1');
+ * // hlc === { wall_ms: 0, counter: 0, node_id: 'node-1' }
+ * ```
+ */
+const _create = (nodeId) => ({
+    wall_ms: 0,
+    counter: 0,
+    node_id: nodeId,
+});
+/**
+ * Compare two HLC timestamps. Returns -1, 0, or 1.
+ *
+ * Compares wall_ms first, then counter, then node_id lexicographically.
+ *
+ * @example
+ * ```ts
+ * const a = HLC.create('node-1');
+ * const b = HLC.increment(a, 1000);
+ * const cmp = HLC.compare(a, b);
+ * // cmp === -1 (a is before b)
+ * ```
+ */
+export const compare = (a, b) => {
+    if (a.wall_ms < b.wall_ms)
+        return -1;
+    if (a.wall_ms > b.wall_ms)
+        return 1;
+    if (a.counter < b.counter)
+        return -1;
+    if (a.counter > b.counter)
+        return 1;
+    if (a.node_id < b.node_id)
+        return -1;
+    if (a.node_id > b.node_id)
+        return 1;
+    return 0;
+};
+// 16-bit counter — supports 65535 events per ms before overflow
+const MAX_COUNTER = 0xffff;
+/**
+ * Increment an HLC for a local event.
+ *
+ * Advances wall_ms to max(current, now) and bumps the counter if the wall
+ * time didn't advance. Throws on counter overflow (`> 0xFFFF`).
+ *
+ * @example
+ * ```ts
+ * const hlc0 = HLC.create('node-1');
+ * const hlc1 = HLC.increment(hlc0, Date.now());
+ * // hlc1.wall_ms >= hlc0.wall_ms
+ * ```
+ */
+const _increment = (hlc, now = 0) => {
+    const newWallMs = Math.max(hlc.wall_ms, now);
+    if (newWallMs === hlc.wall_ms) {
+        const next = hlc.counter + 1;
+        if (next > MAX_COUNTER)
+            throw new Error(`HLC counter overflow: exceeded ${MAX_COUNTER} (>65535 events in 1ms — consider batching or increasing clock resolution)`);
+        return { wall_ms: newWallMs, counter: next, node_id: hlc.node_id };
+    }
+    return { wall_ms: newWallMs, counter: 0, node_id: hlc.node_id };
+};
+/**
+ * Merge a local HLC with a remote HLC on message receive.
+ *
+ * Takes the max of local, remote, and now for wall_ms, then adjusts the
+ * counter accordingly. Preserves the local node_id.
+ *
+ * Lamport causality: if wall clocks agree, increment the higher counter to preserve
+ * happened-before ordering. Reset counter only when wall clock advances (new causal epoch).
+ *
+ * @example
+ * ```ts
+ * const local = HLC.increment(HLC.create('A'), 1000);
+ * const remote = HLC.increment(HLC.create('B'), 2000);
+ * const merged = HLC.merge(local, remote, 1500);
+ * // merged.wall_ms === 2000, merged.node_id === 'A'
+ * ```
+ */
+const _merge = (local, remote, now = 0) => {
+    const newWallMs = Math.max(local.wall_ms, remote.wall_ms, now);
+    let newCounter;
+    if (newWallMs === local.wall_ms && newWallMs === remote.wall_ms) {
+        newCounter = Math.max(local.counter, remote.counter) + 1;
+    }
+    else if (newWallMs === local.wall_ms) {
+        newCounter = local.counter + 1;
+    }
+    else if (newWallMs === remote.wall_ms) {
+        newCounter = remote.counter + 1;
+    }
+    else {
+        newCounter = 0;
+    }
+    if (newCounter > MAX_COUNTER)
+        throw new Error(`HLC counter overflow: exceeded ${MAX_COUNTER} (>65535 events in 1ms — consider batching or increasing clock resolution)`);
+    return { wall_ms: newWallMs, counter: newCounter, node_id: local.node_id };
+};
+/**
+ * Encode an HLC timestamp to a colon-separated hex string.
+ *
+ * Format: `{wall_ms_hex_12}:{counter_hex_4}:{node_id}`
+ *
+ * @example
+ * ```ts
+ * const hlc = HLC.increment(HLC.create('node-1'), 1000);
+ * const encoded = HLC.encode(hlc);
+ * // encoded === '0000000003e8:0000:node-1'
+ * ```
+ */
+const _encode = (hlc) => {
+    // 12 hex digits = 48-bit wall clock (good to year 10889), 4 hex = 16-bit counter
+    const wallHex = hlc.wall_ms.toString(16).padStart(12, '0');
+    const counterHex = hlc.counter.toString(16).padStart(4, '0');
+    return `${wallHex}:${counterHex}:${hlc.node_id}`;
+};
+/**
+ * Decode an HLC timestamp from a colon-separated hex string.
+ *
+ * Inverse of `encode`. Supports node IDs containing colons.
+ *
+ * @example
+ * ```ts
+ * const hlc = HLC.decode('0000000003e8:0000:node-1');
+ * // hlc === { wall_ms: 1000, counter: 0, node_id: 'node-1' }
+ * ```
+ */
+const _decode = (s) => {
+    const parts = s.split(':');
+    if (parts.length < 3)
+        throw new Error(`Invalid HLC format: expected at least 3 colon-separated parts, got "${s}"`);
+    const wall_ms = parseInt(parts[0], 16);
+    const counter = parseInt(parts[1], 16);
+    const node_id = parts.slice(2).join(':');
+    if (isNaN(wall_ms))
+        throw new Error(`Invalid HLC format: wall_ms is not valid hex in "${s}"`);
+    if (isNaN(counter))
+        throw new Error(`Invalid HLC format: counter is not valid hex in "${s}"`);
+    return { wall_ms, counter, node_id };
+};
+/**
+ * Create a managed HLC clock as an Effect Ref.
+ *
+ * @example
+ * ```ts
+ * import { Effect } from 'effect';
+ *
+ * const program = Effect.gen(function* () {
+ *   const clock = yield* HLC.makeClock('node-1');
+ *   const ts = yield* HLC.tick(clock);
+ *   // ts.wall_ms === Date.now() (approximately)
+ * });
+ * ```
+ */
+export const makeClock = (nodeId) => Ref.make(_create(nodeId));
+/**
+ * Tick a managed clock forward, returning the new HLC timestamp.
+ *
+ * @example
+ * ```ts
+ * const ts = yield* HLC.tick(clock);
+ * // ts.wall_ms >= previous wall_ms
+ * ```
+ */
+export const tick = (clock) => Ref.updateAndGet(clock, (current) => _increment(current, Date.now()));
+/**
+ * Receive a remote HLC timestamp and merge it into the managed clock.
+ *
+ * @example
+ * ```ts
+ * const remoteTs = HLC.decode(remoteEncoded);
+ * const merged = yield* HLC.receive(clock, remoteTs);
+ * // merged.wall_ms >= remoteTs.wall_ms
+ * ```
+ */
+export const receive = (clock, remote) => Ref.updateAndGet(clock, (current) => _merge(current, remote, Date.now()));
+/**
+ * HLC namespace -- Hybrid Logical Clock.
+ *
+ * Pure functions for creating, comparing, incrementing, and merging HLC
+ * timestamps, plus Effect-based managed clock helpers. Encodes to/from
+ * a deterministic colon-separated hex string format.
+ *
+ * @example
+ * ```ts
+ * import { HLC } from '@czap/core';
+ *
+ * const a = HLC.increment(HLC.create('A'), Date.now());
+ * const b = HLC.increment(HLC.create('B'), Date.now());
+ * const merged = HLC.merge(a, b, Date.now());
+ * const encoded = HLC.encode(merged);
+ * const decoded = HLC.decode(encoded);
+ * ```
+ */
+export const HLC = {
+    create: _create,
+    compare,
+    increment: _increment,
+    merge: _merge,
+    encode: _encode,
+    decode: _decode,
+    makeClock,
+    tick,
+    receive,
+};
+//# sourceMappingURL=hlc.js.map

package/dist/hlc.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `@czap/core` — **LiteShip** primitives for the **CZAP** engine: boundaries,
+ * tokens, styles, themes, signals, and working-deck coordination (compositor,
+ * plan graph, ECS, capsule factory).
+ * @module
+ */
+export { SignalInput, ThresholdValue, StateName, ContentAddress, IntegrityDigest, TokenRef, Millis } from './brands.js';
+export type { HLC as HLCBrand } from './brands.js';
+export { fnv1a, fnv1aBytes } from './fnv.js';
+export { CanonicalCbor } from './cbor.js';
+export type { Prettify, StateUnion, OutputsFor, BoundaryCrossing, EffectValue, EffectError, RequireAtLeastOne, DeepReadonly, } from './type-utils.js';
+export { tupleMap } from './tuple.js';
+export { Boundary, BoundarySpec } from './boundary.js';
+export { Token } from './token.js';
+export type { TokenCategory } from './token.js';
+export { Style } from './style.js';
+export type { StyleLayer, ShadowLayer } from './style.js';
+export { Theme } from './theme.js';
+export { Component } from './component.js';
+export type { SlotConfig } from './component.js';
+export { Signal } from './signal.js';
+export type { SignalSourceType, SignalSource } from './signal.js';
+export { Easing } from './easing.js';
+export { Animation } from './animation.js';
+export { Timeline } from './timeline.js';
+export type { Quantizer } from './quantizer-types.js';
+export { Scheduler } from './scheduler.js';
+export { Compositor } from './compositor.js';
+export type { CompositeState, CompositorConfig } from './compositor.js';
+export { CompositorStatePool } from './compositor-pool.js';
+export { SpeculativeEvaluator } from './speculative.js';
+export { TokenBuffer } from './token-buffer.js';
+export { UIQuality } from './ui-quality.js';
+export type { UIQualityTier, MotionTier } from './ui-quality.js';
+export { GenFrame } from './gen-frame.js';
+export type { UIFrame, FrameType, MorphStrategy, GapStrategy } from './gen-frame.js';
+export { VideoRenderer } from './video.js';
+export type { VideoConfig, VideoFrameOutput } from './video.js';
+export type { CaptureConfig, CaptureFrame, FrameCapture, CaptureResult } from './capture.js';
+export { BlendTree } from './blend.js';
+export { FrameBudget } from './frame-budget.js';
+export type { Priority } from './frame-budget.js';
+export { DirtyFlags } from './dirty.js';
+export type { CellKind, CellMeta, CellEnvelope } from './protocol.js';
+export type { Entity, System, DenseSystem, DenseStore } from './ecs.js';
+export { Part, World, EntityId } from './ecs.js';
+export { Composable, ComposableWorld } from './composable.js';
+export type { EntityComponents, ComposableEntity, ComposableWorldShape } from './composable.js';
+export { Cell } from './cell.js';
+export { Derived } from './derived.js';
+export { Zap } from './zap.js';
+export { Store } from './store.js';
+export { Wire } from './wire.js';
+export { Op } from './op.js';
+export type { CapLevel, CapSet } from './caps.js';
+export { Cap } from './caps.js';
+export { HLC } from './hlc.js';
+export { VectorClock } from './vector-clock.js';
+export { TypedRef } from './typed-ref.js';
+export type { ReceiptSubject, ReceiptEnvelope, ChainValidationError } from './receipt.js';
+export { Receipt } from './receipt.js';
+export type { DAGNode, ReceiptDAG, MergeResult, ForkViolation } from './dag.js';
+export { DAG } from './dag.js';
+export { Plan } from './plan.js';
+export type { OpType, EdgeType } from './plan.js';
+export { RuntimeCoordinator } from './runtime-coordinator.js';
+export type { RuntimePhase, RuntimeCoordinatorConfig } from './runtime-coordinator.js';
+export { Codec } from './codec.js';
+export { LiveCell } from './live-cell.js';
+export { WASMDispatch } from './wasm-dispatch.js';
+export type { WASMKernels, WASMDispatchAPI } from './wasm-dispatch.js';
+export { fallbackKernels } from './wasm-fallback.js';
+export { AVBridge } from './av-bridge.js';
+export { AVRenderer } from './av-renderer.js';
+export { DEFAULT_TARGET_FPS, MS_PER_SEC, SSE_BUFFER_SIZE, SSE_HEARTBEAT_MS, SSE_RECONNECT_INITIAL_MS, SSE_RECONNECT_MAX_MS, COMPOSITOR_POOL_CAP, DIRTY_FLAGS_MAX, WASM_SCRATCH_BASE, CAPTURE_KEYFRAME_INTERVAL, EASING_SPRING_STEPS, THEME_TRANSITION_DURATION_MS, THEME_TRANSITION_EASING, CANVAS_FALLBACK_WIDTH, CANVAS_FALLBACK_HEIGHT, VIEWPORT, } from './defaults.js';
+export { CzapValidationError, isValidationError } from './validation-error.js';
+export { Diagnostics } from './diagnostics.js';
+export type { DiagnosticEvent, DiagnosticLevel, DiagnosticPayload, DiagnosticsSink } from './diagnostics.js';
+export { AddressedDigest } from './addressed-digest.js';
+export { ShipCapsule } from './ship-capsule.js';
+import type { Cell as _Cell } from './cell.js';
+import type { Derived as _Derived } from './derived.js';
+import type { Zap as _Zap } from './zap.js';
+import type { Wire as _Wire } from './wire.js';
+/** Union of the four reactive primitives the CZAP graph exposes to user code. */
+export type Primitive<T> = _Cell.Shape<T> | _Derived.Shape<T> | _Zap.Shape<T> | _Wire.Shape<T>;
+/** Narrow a {@link Primitive} to a {@link Cell}. */
+export declare const isCell: <T>(p: Primitive<T>) => p is _Cell.Shape<T>;
+/** Narrow a {@link Primitive} to a {@link Derived}. */
+export declare const isDerived: <T>(p: Primitive<T>) => p is _Derived.Shape<T>;
+/** Narrow a {@link Primitive} to a {@link Zap}. */
+export declare const isZap: <T>(p: Primitive<T>) => p is _Zap.Shape<T>;
+/** Narrow a {@link Primitive} to a {@link Wire}. */
+export declare const isWire: <T>(p: Primitive<T>) => p is _Wire.Shape<T>;
+export { Config, defineConfig } from './config.js';
+export type { PrimitiveKind, PluginConfig as CorePluginConfig, AstroConfig as CoreAstroConfig } from './config.js';
+export type { AssemblyKind, Site, CapabilityDecl, BudgetDecl, Invariant, AttributionDecl, CapsuleContract, } from './capsule.js';
+export { TypeValidator } from './capsule.js';
+export { defineCapsule, getCapsuleCatalog } from './assembly.js';
+export type { CapsuleDef } from './assembly.js';
+export { boundaryEvaluateCapsule } from './capsules/boundary-evaluate.js';
+export { tokenBufferCapsule } from './capsules/token-buffer.js';
+export { canonicalCborCapsule } from './capsules/canonical-cbor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,137 @@
+/**
+ * `@czap/core` — **LiteShip** primitives for the **CZAP** engine: boundaries,
+ * tokens, styles, themes, signals, and working-deck coordination (compositor,
+ * plan graph, ECS, capsule factory).
+ * @module
+ */
+// Brands — sanctioned constructors. The lower-level `brand` factory is
+// intentionally NOT re-exported here; it is the unsafe escape-hatch used
+// by `brands.ts` itself to define the sanctioned set, and exposing it on
+// the public surface would let consumers forge any brand. Code that
+// genuinely needs to mint a new brand should import from `@czap/core/brands`
+// directly and document the use site.
+export { SignalInput, ThresholdValue, StateName, ContentAddress, IntegrityDigest, TokenRef, Millis } from './brands.js';
+// FNV-1a hash utility
+export { fnv1a, fnv1aBytes } from './fnv.js';
+// Canonical CBOR encoder (RFC 8949 §4.2.1) — content-address kernel
+export { CanonicalCbor } from './cbor.js';
+// Tuple utilities
+export { tupleMap } from './tuple.js';
+// Boundary. `BoundarySpec` is exported as a value+type pair (see the
+// namespace-object pattern in ADR-0001); consumers who want only the type
+// can `import type { BoundarySpec } from '@czap/core'`.
+export { Boundary, BoundarySpec } from './boundary.js';
+// Token
+export { Token } from './token.js';
+// Style
+export { Style } from './style.js';
+// Theme
+export { Theme } from './theme.js';
+// Component
+export { Component } from './component.js';
+// Signal
+export { Signal } from './signal.js';
+// Easing
+export { Easing } from './easing.js';
+// Animation
+export { Animation } from './animation.js';
+// Timeline
+export { Timeline } from './timeline.js';
+// Scheduler
+export { Scheduler } from './scheduler.js';
+// Compositor
+export { Compositor } from './compositor.js';
+// Compositor State Pool
+export { CompositorStatePool } from './compositor-pool.js';
+// Speculative Evaluation
+export { SpeculativeEvaluator } from './speculative.js';
+// Token Buffer
+export { TokenBuffer } from './token-buffer.js';
+// UI Quality
+export { UIQuality } from './ui-quality.js';
+// Generative UI Frames
+export { GenFrame } from './gen-frame.js';
+// Video
+export { VideoRenderer } from './video.js';
+// Blend
+export { BlendTree } from './blend.js';
+// Frame budget
+export { FrameBudget } from './frame-budget.js';
+// Dirty tracking
+export { DirtyFlags } from './dirty.js';
+export { Part, World, EntityId } from './ecs.js';
+// Composable
+export { Composable, ComposableWorld } from './composable.js';
+// Cell
+export { Cell } from './cell.js';
+// Derived
+export { Derived } from './derived.js';
+// Zap
+export { Zap } from './zap.js';
+// Store
+export { Store } from './store.js';
+// Wire
+export { Wire } from './wire.js';
+// Op
+export { Op } from './op.js';
+export { Cap } from './caps.js';
+// HLC
+export { HLC } from './hlc.js';
+// VectorClock
+export { VectorClock } from './vector-clock.js';
+// TypedRef
+export { TypedRef } from './typed-ref.js';
+export { Receipt } from './receipt.js';
+export { DAG } from './dag.js';
+// Plan
+export { Plan } from './plan.js';
+// Runtime coordination
+export { RuntimeCoordinator } from './runtime-coordinator.js';
+// Codec
+export { Codec } from './codec.js';
+// `SchemaError` / `isSchemaError` removed from the main entry — they were
+// orphan re-exports from `effect/Schema` with no consumers in the repo
+// and added implicit coupling to an Effect internal sub-path. Consumers
+// who need them should import directly from `effect/Schema`.
+// LiveCell
+export { LiveCell } from './live-cell.js';
+// WASM Dispatch
+export { WASMDispatch } from './wasm-dispatch.js';
+export { fallbackKernels } from './wasm-fallback.js';
+// AVBridge
+export { AVBridge } from './av-bridge.js';
+// AVRenderer
+export { AVRenderer } from './av-renderer.js';
+// Defaults (centralized constants)
+export { DEFAULT_TARGET_FPS, MS_PER_SEC, SSE_BUFFER_SIZE, SSE_HEARTBEAT_MS, SSE_RECONNECT_INITIAL_MS, SSE_RECONNECT_MAX_MS, COMPOSITOR_POOL_CAP, DIRTY_FLAGS_MAX, WASM_SCRATCH_BASE, CAPTURE_KEYFRAME_INTERVAL, EASING_SPRING_STEPS, THEME_TRANSITION_DURATION_MS, THEME_TRANSITION_EASING, CANVAS_FALLBACK_WIDTH, CANVAS_FALLBACK_HEIGHT, VIEWPORT, } from './defaults.js';
+// Validation error
+export { CzapValidationError, isValidationError } from './validation-error.js';
+// Diagnostics
+export { Diagnostics } from './diagnostics.js';
+// AddressedDigest + ShipCapsule (ADR-0011)
+// Browser-bundleable: pure type + crypto.subtle hashing. The Node-only
+// release-input manifest helpers (gzip/tar/yaml) live in @czap/cli.
+export { AddressedDigest } from './addressed-digest.js';
+export { ShipCapsule } from './ship-capsule.js';
+/** Narrow a {@link Primitive} to a {@link Cell}. */
+export const isCell = (p) => p._tag === 'Cell';
+/** Narrow a {@link Primitive} to a {@link Derived}. */
+export const isDerived = (p) => p._tag === 'Derived';
+/** Narrow a {@link Primitive} to a {@link Zap}. */
+export const isZap = (p) => p._tag === 'Zap';
+/** Narrow a {@link Primitive} to a {@link Wire}. */
+export const isWire = (p) => p._tag === 'Wire';
+// Config hub
+export { Config, defineConfig } from './config.js';
+export { TypeValidator } from './capsule.js';
+export { defineCapsule, getCapsuleCatalog } from './assembly.js';
+// `resetCapsuleCatalog` is intentionally NOT re-exported here — it mutates
+// global registry state and ships from `@czap/core/testing` only.
+// Capsule declarations — concrete instances of the 7-arm factory
+export { boundaryEvaluateCapsule } from './capsules/boundary-evaluate.js';
+export { tokenBufferCapsule } from './capsules/token-buffer.js';
+export { canonicalCborCapsule } from './capsules/canonical-cbor.js';
+// Harness lives at `@czap/core/harness` — per-arm test + bench template
+// generators. Not re-exported here so consumers don't pull fast-check and
+// the code-gen surface into every bundle.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/interpolate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Value lerping between output states.
+ *
+ * Linearly interpolates all numeric properties of a record
+ * from one state to another, controlled by an eased progress value.
+ *
+ * @module
+ */
+/**
+ * Interpolate between two numeric records using an eased value [0..1].
+ * Returns a new record with each property lerped: from[k] + (to[k] - from[k]) * eased.
+ */
+export declare function interpolate<T extends Record<string, number>>(from: T, to: T, eased: number, defaults?: Partial<Record<string, number>>): T;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1D,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,CAAC,CAkBH"}

package/dist/interpolate.js

@@ -0,0 +1,31 @@
+/**
+ * Value lerping between output states.
+ *
+ * Linearly interpolates all numeric properties of a record
+ * from one state to another, controlled by an eased progress value.
+ *
+ * @module
+ */
+/**
+ * Interpolate between two numeric records using an eased value [0..1].
+ * Returns a new record with each property lerped: from[k] + (to[k] - from[k]) * eased.
+ */
+export function interpolate(from, to, eased, defaults) {
+    const result = {};
+    for (const [key, a] of Object.entries(from)) {
+        const b = to[key] ?? a;
+        result[key] = a + (b - a) * eased;
+    }
+    // Second pass: keys only in `to` (interpolate from implicit 0)
+    for (const [key, b] of Object.entries(to)) {
+        if (key in result) {
+            continue;
+        }
+        const base = defaults?.[key] ?? 0;
+        result[key] = base + (b - base) * eased;
+    }
+    // `result` has every key present in `from`/`to`, both of which are T. The
+    // output is structurally a T but TS can't infer that through Object.entries.
+    return result;
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,IAAO,EACP,EAAK,EACL,KAAa,EACb,QAA0C;IAE1C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC;IACD,+DAA+D;IAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC1C,CAAC;IACD,0EAA0E;IAC1E,6EAA6E;IAC7E,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/dist/live-cell.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `LiveCell<K, T>` — bridge between protocol envelope and reactive runtime.
+ *
+ * A LiveCell is a Cell that also carries a CellEnvelope, tracking
+ * its kind, content address, metadata (HLC timestamps, version),
+ * and boundary crossings.
+ *
+ * @module
+ */
+import type { Scope } from 'effect';
+import { Effect, Stream } from 'effect';
+import { Cell } from './cell.js';
+import type { CellKind, CellEnvelope } from './protocol.js';
+import type { BoundaryCrossing } from './type-utils.js';
+import { Boundary } from './boundary.js';
+interface LiveCellShape<K extends CellKind, T> extends Omit<Cell.Shape<T>, '_tag'> {
+    readonly _tag: 'LiveCell';
+    readonly envelope: Effect.Effect<CellEnvelope<K, T>>;
+    readonly crossings: Stream.Stream<BoundaryCrossing<string>>;
+    readonly kind: K;
+    publishCrossing(crossing: BoundaryCrossing<string>): Effect.Effect<void>;
+}
+declare function _make<K extends CellKind, T>(kind: K, initial: T): Effect.Effect<LiveCellShape<K, T>, never, Scope.Scope>;
+/**
+ * Create a boundary-kind LiveCell that automatically publishes crossings
+ * when the numeric value transitions between boundary states.
+ */
+declare function _makeBoundary<I extends string, S extends readonly [string, ...string[]]>(boundary: Boundary.Shape<I, S>, initial: number): Effect.Effect<LiveCellShape<'boundary', number>, never, Scope.Scope>;
+/**
+ * LiveCell — bridge between the {@link Cell} reactive graph and the wire
+ * protocol. A `LiveCell` wraps a `Cell` with a typed {@link CellEnvelope} —
+ * kind, content address, HLC, boundary crossings — so primitives can travel
+ * between peers as self-describing messages.
+ */
+export declare const LiveCell: {
+    /** Wrap an arbitrary value in a {@link LiveCell} with freshly minted identity + HLC. */
+    make: typeof _make;
+    /** Specialized factory for boundary crossings so the envelope captures crossing metadata. */
+    makeBoundary: typeof _makeBoundary;
+};
+export declare namespace LiveCell {
+    /** Structural shape of a {@link LiveCell} parameterized by cell kind `K` and value type `T`. */
+    type Shape<K extends CellKind, T> = LiveCellShape<K, T>;
+}
+export {};
+//# sourceMappingURL=live-cell.d.ts.map

package/dist/live-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-cell.d.ts","sourceRoot":"","sources":["../src/live-cell.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,UAAU,aAAa,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAE,SAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAChF,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,iBAAS,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CA+DjH;AAED;;;GAGG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAC/E,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CA+EtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;IACnB,wFAAwF;;IAExF,6FAA6F;;CAE9F,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,gGAAgG;IAChG,KAAY,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAChE"}