@czap/core 0.1.0

package/dist/type-utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Type-level utilities for `@czap/core`.
+ *
+ * Mapped types, conditional helpers, and structural utilities
+ * used across boundary definitions and compositor outputs.
+ *
+ * @module
+ */
+import type { Boundary } from './boundary.js';
+import type { StateName, HLC } from './brands.js';
+import type { Effect as EffectType } from 'effect';
+/** Flatten branded intersections for clean IDE hints */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Extract literal union of state names from a Boundary.Shape */
+export type StateUnion<B extends Boundary.Shape> = B['states'][number];
+/** Generate valid output shapes per state */
+export type OutputsFor<B extends Boundary.Shape, T> = {
+    readonly [S in StateUnion<B>]: T;
+};
+/** Discriminated union of boundary crossings */
+export type BoundaryCrossing<S extends string = string> = {
+    readonly from: StateName<S>;
+    readonly to: StateName<S>;
+    readonly timestamp: HLC;
+    readonly value: number;
+};
+/** Extract the value type from an Effect */
+export type EffectValue<T> = T extends EffectType.Effect<infer A, unknown, unknown> ? A : never;
+/** Extract the error type from an Effect */
+export type EffectError<T> = T extends EffectType.Effect<unknown, infer E, unknown> ? E : never;
+/** Require at least one key of T */
+export type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+/** Deep readonly */
+export type DeepReadonly<T> = T extends (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends Record<string, unknown> ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../src/type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEnD,wDAAwD;AACxD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,iEAAiE;AACjE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,6CAA6C;AAC7C,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI;IACpD,QAAQ,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;CACjC,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhG,4CAA4C;AAC5C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhG,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GAChG;KAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,IAAI,CAAC,CAAC;AAErF,oBAAoB;AACpB,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC/C,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC/C,CAAC,CAAC"}

package/dist/type-utils.js

@@ -0,0 +1,10 @@
+/**
+ * Type-level utilities for `@czap/core`.
+ *
+ * Mapped types, conditional helpers, and structural utilities
+ * used across boundary definitions and compositor outputs.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=type-utils.js.map

package/dist/type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../src/type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/typed-ref.d.ts

@@ -0,0 +1,50 @@
+/**
+ * TypedRef -- content-addressed payload references.
+ *
+ * Uses CBOR canonical encoding (cborg) and SHA-256 via crypto.subtle.
+ *
+ * @module
+ */
+import { Effect } from 'effect';
+interface TypedRefShape {
+    readonly schema_hash: string;
+    readonly content_hash: string;
+}
+/** Canonicalize value to CBOR bytes using canonical (deterministic) encoding. */
+export declare const canonicalize: (value: unknown) => Uint8Array;
+/**
+ * Hash data using SHA-256. Returns "sha256:hex" formatted hash.
+ *
+ * The `bytes as BufferSource` assertion is the single sanctioned cast in this
+ * file. `Uint8Array` is structurally a BufferSource, but TS's DOM lib types
+ * `bytes.buffer` as potentially-SharedArrayBuffer, preventing direct assignment.
+ * Safe: cborg encodes into fresh ArrayBuffer and TextEncoder.encode returns
+ * ArrayBuffer-backed views. No data copy.
+ *
+ * Hash-primitive failures are unrecoverable in practice (crypto.subtle errors
+ * are environment-level, not user-recoverable), so we `Effect.orDie` to fold
+ * the Error channel into a defect and keep the `Effect<string>` signature that
+ * the content-addressing pipeline relies on.
+ */
+export declare const hash: (data: string | Uint8Array) => Effect.Effect<string>;
+/**
+ * TypedRef — schema-plus-content-hash pointer used by the receipt pipeline.
+ * Lets a receipt reference a payload by its content address without embedding
+ * the payload itself, while still binding it to a schema identity.
+ */
+export declare const TypedRef: {
+    /** Build a {@link TypedRef} from a schema hash and an arbitrary payload. */
+    create: (schemaHash: string, payload: unknown) => Effect.Effect<TypedRefShape>;
+    /** Structural equality over schema + content hashes. */
+    equals: (a: TypedRefShape, b: TypedRefShape) => boolean;
+    /** Canonical-CBOR-ish serialization used to compute the content hash. */
+    canonicalize: (value: unknown) => Uint8Array;
+    /** Hash a canonicalized payload to its content address. */
+    hash: (data: string | Uint8Array) => Effect.Effect<string>;
+};
+export declare namespace TypedRef {
+    /** Structural shape of a typed reference: schema hash + content hash. */
+    type Shape = TypedRefShape;
+}
+export {};
+//# sourceMappingURL=typed-ref.d.ts.map

package/dist/typed-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ref.d.ts","sourceRoot":"","sources":["../src/typed-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,UAAU,aAAa;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,UAA2B,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,GAAG,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAW9C,CAAC;AAaxB;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACnB,4EAA4E;yBAhBjD,MAAM,WAAW,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;IAkBlF,wDAAwD;gBAXtC,aAAa,KAAK,aAAa,KAAG,OAAO;IAa3D,yEAAyE;0BAlDvC,OAAO,KAAG,UAAU;IAoDtD,2DAA2D;iBApClC,MAAM,GAAG,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;CAsCrE,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,yEAAyE;IACzE,KAAY,KAAK,GAAG,aAAa,CAAC;CACnC"}

package/dist/typed-ref.js

@@ -0,0 +1,59 @@
+/**
+ * TypedRef -- content-addressed payload references.
+ *
+ * Uses CBOR canonical encoding (cborg) and SHA-256 via crypto.subtle.
+ *
+ * @module
+ */
+import { Effect } from 'effect';
+import { encode } from 'cborg';
+/** Canonicalize value to CBOR bytes using canonical (deterministic) encoding. */
+export const canonicalize = (value) => encode(value);
+/**
+ * Hash data using SHA-256. Returns "sha256:hex" formatted hash.
+ *
+ * The `bytes as BufferSource` assertion is the single sanctioned cast in this
+ * file. `Uint8Array` is structurally a BufferSource, but TS's DOM lib types
+ * `bytes.buffer` as potentially-SharedArrayBuffer, preventing direct assignment.
+ * Safe: cborg encodes into fresh ArrayBuffer and TextEncoder.encode returns
+ * ArrayBuffer-backed views. No data copy.
+ *
+ * Hash-primitive failures are unrecoverable in practice (crypto.subtle errors
+ * are environment-level, not user-recoverable), so we `Effect.orDie` to fold
+ * the Error channel into a defect and keep the `Effect<string>` signature that
+ * the content-addressing pipeline relies on.
+ */
+export const hash = (data) => Effect.tryPromise({
+    try: async () => {
+        const bytes = typeof data === 'string' ? new TextEncoder().encode(data) : data;
+        const buffer = await crypto.subtle.digest('SHA-256', bytes);
+        const hashHex = Array.from(new Uint8Array(buffer))
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+        return `sha256:${hashHex}`;
+    },
+    catch: (error) => new Error(`SHA-256 hash failed: ${error instanceof Error ? error.message : String(error)}`),
+}).pipe(Effect.orDie);
+/** Create a TypedRef from schema hash and payload. */
+const _create = (schemaHash, payload) => Effect.gen(function* () {
+    const contentHash = yield* hash(canonicalize(payload));
+    return { schema_hash: schemaHash, content_hash: contentHash };
+});
+/** Compare two TypedRefs for structural equality. */
+const _equals = (a, b) => a.schema_hash === b.schema_hash && a.content_hash === b.content_hash;
+/**
+ * TypedRef — schema-plus-content-hash pointer used by the receipt pipeline.
+ * Lets a receipt reference a payload by its content address without embedding
+ * the payload itself, while still binding it to a schema identity.
+ */
+export const TypedRef = {
+    /** Build a {@link TypedRef} from a schema hash and an arbitrary payload. */
+    create: _create,
+    /** Structural equality over schema + content hashes. */
+    equals: _equals,
+    /** Canonical-CBOR-ish serialization used to compute the content hash. */
+    canonicalize,
+    /** Hash a canonicalized payload to its content address. */
+    hash,
+};
+//# sourceMappingURL=typed-ref.js.map

package/dist/typed-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ref.js","sourceRoot":"","sources":["../src/typed-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAS/B,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAyB,EAAyB,EAAE,CACvE,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAqB,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;aAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,UAAU,OAAO,EAAE,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;CAC9G,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAExB,sDAAsD;AACtD,MAAM,OAAO,GAAG,CAAC,UAAkB,EAAE,OAAgB,EAAgC,EAAE,CACrF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAChE,CAAC,CAAC,CAAC;AAEL,qDAAqD;AACrD,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,CAAgB,EAAW,EAAE,CAC9D,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,4EAA4E;IAC5E,MAAM,EAAE,OAAO;IACf,wDAAwD;IACxD,MAAM,EAAE,OAAO;IACf,yEAAyE;IACzE,YAAY;IACZ,2DAA2D;IAC3D,IAAI;CACL,CAAC"}

package/dist/ui-quality.d.ts

@@ -0,0 +1,50 @@
+/**
+ * UIQuality -- maps buffer occupancy + device capability to UI complexity tier.
+ *
+ * Same pattern as video ABR (Adaptive Bitrate). Composite signal from
+ * buffer occupancy and device tier determines rendering fidelity.
+ *
+ * @module
+ */
+import type { MotionTier as _MotionTier } from '@czap/_spine';
+import { Boundary } from './boundary.js';
+/**
+ * Motion tier — re-anchored from `@czap/_spine` (the canonical declaration
+ * per ADR-0010). The ladder runs from lowest capability (`none`, forced by
+ * `prefers-reduced-motion: reduce` regardless of GPU tier) to highest
+ * (`compute`, which unlocks the Rust/WASM kernels).
+ */
+export type MotionTier = _MotionTier;
+/**
+ * Coarse UI-complexity ladder, in increasing fidelity: `skeleton` (placeholder
+ * blocks only) up through `rich` (full interactive styled content).
+ */
+export type UIQualityTier = 'skeleton' | 'text-only' | 'styled' | 'interactive' | 'rich';
+/** {@link Boundary.Shape} instantiation used by {@link UIQuality} — input = `buffer-occupancy`, states = the {@link UIQualityTier} ladder. */
+export type UIQualityBoundary = Boundary.Shape<'buffer-occupancy', readonly ['skeleton', 'text-only', 'styled', 'interactive', 'rich']>;
+interface UIQualityEvaluatorShape {
+    evaluate(bufferOccupancy: number, deviceTier?: MotionTier): UIQualityTier;
+    readonly boundary: UIQualityBoundary;
+}
+declare function _make(): UIQualityEvaluatorShape;
+/**
+ * UIQuality — adaptive-bitrate-style UI fidelity gate.
+ *
+ * Combines buffer occupancy (how far ahead the generator is) and device
+ * {@link MotionTier} into a composite score and maps it via {@link Boundary}
+ * with hysteresis to a {@link UIQualityTier}.
+ */
+export declare const UIQuality: {
+    /** Build a stateful evaluator that remembers the previous tier for hysteresis. */
+    make: typeof _make;
+    /** The pre-built boundary — exposed so callers can compile it to CSS/GLSL directly. */
+    boundary: UIQualityBoundary;
+};
+export declare namespace UIQuality {
+    /** Structural shape of a UIQuality evaluator. */
+    type Shape = UIQualityEvaluatorShape;
+    /** Alias for {@link UIQualityTier}. */
+    type Tier = UIQualityTier;
+}
+export {};
+//# sourceMappingURL=ui-quality.d.ts.map

package/dist/ui-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-quality.d.ts","sourceRoot":"","sources":["../src/ui-quality.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzF,8IAA8I;AAC9I,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,KAAK,CAC5C,kBAAkB,EAClB,SAAS,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,CACpE,CAAC;AA6BF,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED,iBAAS,KAAK,IAAI,uBAAuB,CAmBxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;IACpB,kFAAkF;;IAElF,uFAAuF;;CAExF,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,iDAAiD;IACjD,KAAY,KAAK,GAAG,uBAAuB,CAAC;IAC5C,uCAAuC;IACvC,KAAY,IAAI,GAAG,aAAa,CAAC;CAClC"}

package/dist/ui-quality.js

@@ -0,0 +1,64 @@
+/**
+ * UIQuality -- maps buffer occupancy + device capability to UI complexity tier.
+ *
+ * Same pattern as video ABR (Adaptive Bitrate). Composite signal from
+ * buffer occupancy and device tier determines rendering fidelity.
+ *
+ * @module
+ */
+import { Boundary } from './boundary.js';
+/**
+ * Pre-built boundary for UI quality based on buffer occupancy signal.
+ * Thresholds tuned for streaming UI: aggressive degradation when buffer low.
+ */
+const uiQualityBoundary = Boundary.make({
+    input: 'buffer-occupancy',
+    at: [
+        [0.0, 'skeleton'],
+        [0.15, 'text-only'],
+        [0.35, 'styled'],
+        [0.6, 'interactive'],
+        [0.85, 'rich'],
+    ],
+    hysteresis: 0.1,
+});
+/**
+ * Motion tier to normalized device capability score (0-1).
+ */
+const DEVICE_CAPABILITY_SCORES = {
+    none: 0.0,
+    transitions: 0.25,
+    animations: 0.5,
+    physics: 0.75,
+    compute: 1.0,
+};
+function _make() {
+    let previousTier = 'skeleton';
+    return {
+        evaluate(bufferOccupancy, deviceTier) {
+            // Composite signal: buffer occupancy weighted more heavily
+            const deviceScore = deviceTier ? DEVICE_CAPABILITY_SCORES[deviceTier] : 0.5;
+            const composite = bufferOccupancy * 0.7 + deviceScore * 0.3;
+            // Boundary.evaluateWithHysteresis now returns the exact state literal union ('skeleton' | ... | 'rich')
+            // because uiQualityBoundary's S parameter is narrowed via `as const`.
+            const result = Boundary.evaluateWithHysteresis(uiQualityBoundary, composite, previousTier);
+            previousTier = result;
+            return result;
+        },
+        boundary: uiQualityBoundary,
+    };
+}
+/**
+ * UIQuality — adaptive-bitrate-style UI fidelity gate.
+ *
+ * Combines buffer occupancy (how far ahead the generator is) and device
+ * {@link MotionTier} into a composite score and maps it via {@link Boundary}
+ * with hysteresis to a {@link UIQualityTier}.
+ */
+export const UIQuality = {
+    /** Build a stateful evaluator that remembers the previous tier for hysteresis. */
+    make: _make,
+    /** The pre-built boundary — exposed so callers can compile it to CSS/GLSL directly. */
+    boundary: uiQualityBoundary,
+};
+//# sourceMappingURL=ui-quality.js.map

package/dist/ui-quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-quality.js","sourceRoot":"","sources":["../src/ui-quality.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAsBzC;;;GAGG;AACH,MAAM,iBAAiB,GAAsB,QAAQ,CAAC,IAAI,CAAC;IACzD,KAAK,EAAE,kBAAkB;IACzB,EAAE,EAAE;QACF,CAAC,GAAG,EAAE,UAAU,CAAC;QACjB,CAAC,IAAI,EAAE,WAAW,CAAC;QACnB,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChB,CAAC,GAAG,EAAE,aAAa,CAAC;QACpB,CAAC,IAAI,EAAE,MAAM,CAAC;KACN;IACV,UAAU,EAAE,GAAG;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,wBAAwB,GAA+B;IAC3D,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,GAAG;CACb,CAAC;AAOF,SAAS,KAAK;IACZ,IAAI,YAAY,GAAkB,UAAU,CAAC;IAE7C,OAAO;QACL,QAAQ,CAAC,eAAuB,EAAE,UAAuB;YACvD,2DAA2D;YAC3D,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC5E,MAAM,SAAS,GAAG,eAAe,GAAG,GAAG,GAAG,WAAW,GAAG,GAAG,CAAC;YAE5D,wGAAwG;YACxG,sEAAsE;YACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,CAAC,iBAAiB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YAE3F,YAAY,GAAG,MAAM,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,kFAAkF;IAClF,IAAI,EAAE,KAAK;IACX,uFAAuF;IACvF,QAAQ,EAAE,iBAAiB;CAC5B,CAAC"}

package/dist/validation-error.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structured validation error for factory/constructor failures.
+ *
+ * Thrown (not Effect.fail'd) because all factory functions are synchronous.
+ * Callers can catch and `instanceof CzapValidationError` to distinguish
+ * czap validation failures from other errors.
+ *
+ * @module
+ */
+/**
+ * Structured validation error thrown by czap factory/constructor functions.
+ *
+ * Carries a `module` identifier (e.g. `'Boundary.make'`) and a human-readable
+ * `detail` message. Synchronous factories throw this directly so callers can
+ * `catch` and branch via {@link isValidationError} without Effect plumbing.
+ */
+export declare class CzapValidationError extends Error {
+    readonly _tag: "CzapValidationError";
+    readonly module: string;
+    readonly detail: string;
+    constructor(module: string, detail: string);
+}
+/** Type guard for CzapValidationError */
+export declare function isValidationError(error: unknown): error is CzapValidationError;
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM3C;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAE9E"}

package/dist/validation-error.js

@@ -0,0 +1,32 @@
+/**
+ * Structured validation error for factory/constructor failures.
+ *
+ * Thrown (not Effect.fail'd) because all factory functions are synchronous.
+ * Callers can catch and `instanceof CzapValidationError` to distinguish
+ * czap validation failures from other errors.
+ *
+ * @module
+ */
+/**
+ * Structured validation error thrown by czap factory/constructor functions.
+ *
+ * Carries a `module` identifier (e.g. `'Boundary.make'`) and a human-readable
+ * `detail` message. Synchronous factories throw this directly so callers can
+ * `catch` and branch via {@link isValidationError} without Effect plumbing.
+ */
+export class CzapValidationError extends Error {
+    _tag = 'CzapValidationError';
+    module;
+    detail;
+    constructor(module, detail) {
+        super(`${module}: ${detail}`);
+        this.name = 'CzapValidationError';
+        this.module = module;
+        this.detail = detail;
+    }
+}
+/** Type guard for CzapValidationError */
+export function isValidationError(error) {
+    return error instanceof CzapValidationError;
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,qBAA8B,CAAC;IACtC,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,MAAc,EAAE,MAAc;QACxC,KAAK,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC"}

package/dist/vector-clock.d.ts

@@ -0,0 +1,46 @@
+/**
+ * VectorClock -- causality tracking for distributed systems.
+ *
+ * @module
+ */
+interface VectorClockShape {
+    readonly _tag: 'VectorClock';
+    readonly entries: ReadonlyMap<string, number>;
+}
+/**
+ * VectorClock — per-peer counter algebra for causal ordering.
+ * Pairs with {@link HLC} when you need exact happens-before rather than HLC's
+ * hybrid ordering.
+ */
+export declare const VectorClock: {
+    /** Build an empty vector clock. */
+    make: () => VectorClockShape;
+    /** Build a vector clock from an existing `Record<peer, counter>`. */
+    from: (entries: Record<string, number>) => VectorClockShape;
+    /** Read the counter for a single peer. */
+    get: (vc: VectorClockShape, peerId: string) => number;
+    /** Increment the counter for the given peer, returning a new clock. */
+    tick: (vc: VectorClockShape, peerId: string) => VectorClockShape;
+    /** Pointwise-max merge of two clocks. */
+    merge: (a: VectorClockShape, b: VectorClockShape) => VectorClockShape;
+    /** `true` iff `a` strictly happens-before `b`. */
+    happensBefore: (a: VectorClockShape, b: VectorClockShape) => boolean;
+    /** `true` iff `a` and `b` are causally concurrent. */
+    concurrent: (a: VectorClockShape, b: VectorClockShape) => boolean;
+    /** Exact structural equality. */
+    equals: (a: VectorClockShape, b: VectorClockShape) => boolean;
+    /** `-1 | 0 | 1` comparator suitable for `sort`; `0` when concurrent. */
+    compare: (a: VectorClockShape, b: VectorClockShape) => -1 | 0 | 1;
+    /** Convert to a plain `Record<peer, counter>`. */
+    toObject: (vc: VectorClockShape) => Record<string, number>;
+    /** List peers known to the clock. */
+    peers: (vc: VectorClockShape) => string[];
+    /** Number of peers. */
+    size: (vc: VectorClockShape) => number;
+};
+export declare namespace VectorClock {
+    /** Structural shape of a vector clock: a `Map<peer, counter>` wrapper. */
+    type Shape = VectorClockShape;
+}
+export {};
+//# sourceMappingURL=vector-clock.d.ts.map

package/dist/vector-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-clock.d.ts","sourceRoot":"","sources":["../src/vector-clock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,gBAAgB;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAkED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,mCAAmC;gBAtEnB,gBAAgB;IAwEhC,qEAAqE;oBAnE/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,gBAAgB;IAqE/D,0CAA0C;cAhE1B,gBAAgB,UAAU,MAAM,KAAG,MAAM;IAkEzD,uEAAuE;eAhEtD,gBAAgB,UAAU,MAAM,KAAG,gBAAgB;IAkEpE,yCAAyC;eA5DxB,gBAAgB,KAAK,gBAAgB,KAAG,gBAAgB;IA8DzE,kDAAkD;uBArDzB,gBAAgB,KAAK,gBAAgB,KAAG,OAAO;IAuDxE,sDAAsD;oBAjChC,gBAAgB,KAAK,gBAAgB,KAAG,OAAO;IAmCrE,iCAAiC;gBA3Cf,gBAAgB,KAAK,gBAAgB,KAAG,OAAO;IA6CjE,wEAAwE;iBAlCrD,gBAAgB,KAAK,gBAAgB,KAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAoCrE,kDAAkD;mBA9B7B,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgC9D,qCAAqC;gBA9BnB,gBAAgB,KAAG,MAAM,EAAE;IAgC7C,uBAAuB;eA9BN,gBAAgB,KAAG,MAAM;CAgC3C,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,0EAA0E;IAC1E,KAAY,KAAK,GAAG,gBAAgB,CAAC;CACtC"}

package/dist/vector-clock.js

@@ -0,0 +1,91 @@
+/**
+ * VectorClock -- causality tracking for distributed systems.
+ *
+ * @module
+ */
+const _make = () => ({
+    _tag: 'VectorClock',
+    entries: new Map(),
+});
+const _from = (entries) => ({
+    _tag: 'VectorClock',
+    entries: new Map(Object.entries(entries)),
+});
+const _get = (vc, peerId) => vc.entries.get(peerId) ?? 0;
+const _tick = (vc, peerId) => {
+    const newEntries = new Map(vc.entries);
+    newEntries.set(peerId, _get(vc, peerId) + 1);
+    return { _tag: 'VectorClock', entries: newEntries };
+};
+const _merge = (a, b) => {
+    const newEntries = new Map(a.entries);
+    for (const [peerId, counter] of b.entries) {
+        const existing = newEntries.get(peerId) ?? 0;
+        newEntries.set(peerId, Math.max(existing, counter));
+    }
+    return { _tag: 'VectorClock', entries: newEntries };
+};
+const _happensBefore = (a, b) => {
+    const allPeers = new Set([...a.entries.keys(), ...b.entries.keys()]);
+    let hasStrictlyLess = false;
+    for (const peerId of allPeers) {
+        const aValue = _get(a, peerId);
+        const bValue = _get(b, peerId);
+        if (aValue > bValue)
+            return false;
+        if (aValue < bValue)
+            hasStrictlyLess = true;
+    }
+    return hasStrictlyLess;
+};
+const _equals = (a, b) => {
+    const allPeers = new Set([...a.entries.keys(), ...b.entries.keys()]);
+    for (const peerId of allPeers) {
+        if (_get(a, peerId) !== _get(b, peerId))
+            return false;
+    }
+    return true;
+};
+const _concurrent = (a, b) => !_happensBefore(a, b) && !_happensBefore(b, a) && !_equals(a, b);
+const _compare = (a, b) => {
+    if (_happensBefore(a, b))
+        return -1;
+    if (_happensBefore(b, a))
+        return 1;
+    return 0;
+};
+const _toObject = (vc) => Object.fromEntries(vc.entries);
+const _peers = (vc) => [...vc.entries.keys()];
+const _size = (vc) => vc.entries.size;
+/**
+ * VectorClock — per-peer counter algebra for causal ordering.
+ * Pairs with {@link HLC} when you need exact happens-before rather than HLC's
+ * hybrid ordering.
+ */
+export const VectorClock = {
+    /** Build an empty vector clock. */
+    make: _make,
+    /** Build a vector clock from an existing `Record<peer, counter>`. */
+    from: _from,
+    /** Read the counter for a single peer. */
+    get: _get,
+    /** Increment the counter for the given peer, returning a new clock. */
+    tick: _tick,
+    /** Pointwise-max merge of two clocks. */
+    merge: _merge,
+    /** `true` iff `a` strictly happens-before `b`. */
+    happensBefore: _happensBefore,
+    /** `true` iff `a` and `b` are causally concurrent. */
+    concurrent: _concurrent,
+    /** Exact structural equality. */
+    equals: _equals,
+    /** `-1 | 0 | 1` comparator suitable for `sort`; `0` when concurrent. */
+    compare: _compare,
+    /** Convert to a plain `Record<peer, counter>`. */
+    toObject: _toObject,
+    /** List peers known to the clock. */
+    peers: _peers,
+    /** Number of peers. */
+    size: _size,
+};
+//# sourceMappingURL=vector-clock.js.map

package/dist/vector-clock.js.map

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

package/dist/video.d.ts

@@ -0,0 +1,62 @@
+/**
+ * VideoRenderer -- fixed-step frame generator for deterministic video rendering.
+ *
+ * Same compositor, same state pipeline -- different clock. The VideoRenderer
+ * drives a FixedStepScheduler at target fps, producing VideoFrameOutput
+ * per frame with the full CompositeState snapshot.
+ *
+ * @module
+ */
+import type { Scheduler } from './scheduler.js';
+import type { CompositeState, Compositor } from './compositor.js';
+import type { Signal } from './signal.js';
+import type { Millis } from './brands.js';
+/** Configuration for a {@link VideoRenderer}: resolution, target fps, and total duration. */
+export interface VideoConfig {
+    readonly fps: number;
+    readonly width: number;
+    readonly height: number;
+    readonly durationMs: Millis;
+}
+/**
+ * Single frame yielded by `VideoRenderer.frames()`: frame index, timestamp,
+ * normalized progress, and the {@link CompositeState} snapshot captured at that tick.
+ */
+export interface VideoFrameOutput {
+    readonly frame: number;
+    readonly timestamp: number;
+    readonly progress: number;
+    readonly state: CompositeState;
+}
+interface VideoRendererShape {
+    readonly config: VideoConfig;
+    readonly totalFrames: number;
+    readonly scheduler: Scheduler.FixedStep;
+    frames(): AsyncGenerator<VideoFrameOutput>;
+}
+/**
+ * Create a video renderer that produces deterministic frames from a Compositor.
+ *
+ * Each call to `frames()` returns an async generator yielding one
+ * `VideoFrameOutput` per frame at the configured fps/duration.
+ *
+ * When a `signal` is provided it is seeked to each frame's timestamp before
+ * the compositor evaluates, so quantizers that read from that signal advance
+ * deterministically with the render clock.
+ */
+declare function _make(config: VideoConfig, compositor: Compositor.Shape, signal?: Signal.Controllable<number>): VideoRendererShape;
+/**
+ * VideoRenderer — fixed-step frame generator for deterministic offline rendering.
+ * Drives a {@link Compositor} at the configured fps and optionally seeks a
+ * controllable time {@link Signal} so every frame is reproducible.
+ */
+export declare const VideoRenderer: {
+    /** Create a renderer bound to the given compositor and optional seekable time signal. */
+    make: typeof _make;
+};
+export declare namespace VideoRenderer {
+    /** Structural shape of a renderer instance returned by {@link VideoRenderer.make}. */
+    type Shape = VideoRendererShape;
+}
+export {};
+//# sourceMappingURL=video.d.ts.map

package/dist/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;IACxC,MAAM,IAAI,cAAc,CAAC,gBAAgB,CAAC,CAAC;CAC5C;AAMD;;;;;;;;;GASG;AACH,iBAAS,KAAK,CACZ,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,CAAC,KAAK,EAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GACnC,kBAAkB,CAyBpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,yFAAyF;;CAE1F,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,sFAAsF;IACtF,KAAY,KAAK,GAAG,kBAAkB,CAAC;CACxC"}

package/dist/video.js

@@ -0,0 +1,59 @@
+/**
+ * VideoRenderer -- fixed-step frame generator for deterministic video rendering.
+ *
+ * Same compositor, same state pipeline -- different clock. The VideoRenderer
+ * drives a FixedStepScheduler at target fps, producing VideoFrameOutput
+ * per frame with the full CompositeState snapshot.
+ *
+ * @module
+ */
+import { Scheduler as SchedulerImpl } from './scheduler.js';
+import { Effect } from 'effect';
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a video renderer that produces deterministic frames from a Compositor.
+ *
+ * Each call to `frames()` returns an async generator yielding one
+ * `VideoFrameOutput` per frame at the configured fps/duration.
+ *
+ * When a `signal` is provided it is seeked to each frame's timestamp before
+ * the compositor evaluates, so quantizers that read from that signal advance
+ * deterministically with the render clock.
+ */
+function _make(config, compositor, signal) {
+    const totalFrames = Math.ceil((config.durationMs / 1000) * config.fps);
+    const scheduler = SchedulerImpl.fixedStep(config.fps);
+    return {
+        config,
+        totalFrames,
+        scheduler,
+        async *frames() {
+            for (let i = 0; i < totalFrames; i++) {
+                scheduler.step();
+                const timestamp = (i * 1000) / config.fps;
+                if (signal) {
+                    Effect.runSync(signal.seek(timestamp));
+                }
+                const state = Effect.runSync(compositor.compute());
+                yield {
+                    frame: i,
+                    timestamp,
+                    progress: totalFrames > 1 ? i / (totalFrames - 1) : 1,
+                    state,
+                };
+            }
+        },
+    };
+}
+/**
+ * VideoRenderer — fixed-step frame generator for deterministic offline rendering.
+ * Drives a {@link Compositor} at the configured fps and optionally seeks a
+ * controllable time {@link Signal} so every frame is reproducible.
+ */
+export const VideoRenderer = {
+    /** Create a renderer bound to the given compositor and optional seekable time signal. */
+    make: _make,
+};
+//# sourceMappingURL=video.js.map