@czap/core 0.1.0

package/dist/timeline.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Timeline -- quantizer over time with play/pause/seek/scrub/reverse.
+ *
+ * A Timeline wraps a BoundaryDef and drives it from a time-based signal,
+ * producing discrete state transitions as the elapsed time crosses thresholds.
+ *
+ * @module
+ */
+import type { Stream, Scope } from 'effect';
+import { Effect } from 'effect';
+import type { Millis } from './brands.js';
+import { Boundary } from './boundary.js';
+import type { StateUnion } from './type-utils.js';
+import type { Scheduler } from './scheduler.js';
+interface TimelineShape<B extends Boundary.Shape = Boundary.Shape> {
+    readonly boundary: B;
+    readonly state: Effect.Effect<StateUnion<B>>;
+    readonly progress: Effect.Effect<number>;
+    readonly elapsed: Effect.Effect<Millis>;
+    readonly changes: Stream.Stream<StateUnion<B>>;
+    play(): Effect.Effect<void>;
+    pause(): Effect.Effect<void>;
+    reverse(): Effect.Effect<void>;
+    seek(ms: Millis): Effect.Effect<void>;
+    scrub(progress: number): Effect.Effect<void>;
+}
+interface TimelineFactory {
+    from<B extends Boundary.Shape>(boundary: B, config?: {
+        duration?: Millis;
+        loop?: boolean;
+        scheduler?: Scheduler.Shape;
+    }): Effect.Effect<TimelineShape<B>, never, Scope.Scope>;
+}
+/**
+ * Timeline — scheduler-driven advancement over a {@link Boundary}.
+ * Produces a scoped reactive timeline that seeks or plays between boundary
+ * states; pluggable clock via {@link Scheduler}.
+ */
+export declare const Timeline: TimelineFactory;
+export declare namespace Timeline {
+    /** Structural shape of a timeline instance for a given {@link Boundary}. */
+    type Shape<B extends Boundary.Shape = Boundary.Shape> = TimelineShape<B>;
+}
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAwB,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,UAAU,aAAa,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK;IAC/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,EAC3B,QAAQ,EAAE,CAAC,EACX,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAA;KAAE,GAC1E,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,eAiGtB,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,4EAA4E;IAC5E,KAAY,KAAK,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;CACjF"}

package/dist/timeline.js

@@ -0,0 +1,101 @@
+/**
+ * Timeline -- quantizer over time with play/pause/seek/scrub/reverse.
+ *
+ * A Timeline wraps a BoundaryDef and drives it from a time-based signal,
+ * producing discrete state transitions as the elapsed time crosses thresholds.
+ *
+ * @module
+ */
+import { Effect, SubscriptionRef, Ref } from 'effect';
+import { Millis as mkMillis } from './brands.js';
+import { Boundary } from './boundary.js';
+import { Scheduler as SchedulerImpl } from './scheduler.js';
+/**
+ * Timeline — scheduler-driven advancement over a {@link Boundary}.
+ * Produces a scoped reactive timeline that seeks or plays between boundary
+ * states; pluggable clock via {@link Scheduler}.
+ */
+export const Timeline = {
+    from(boundary, config) {
+        const duration = config?.duration ??
+            (boundary.thresholds.length > 0 ? boundary.thresholds[boundary.thresholds.length - 1] * 1.2 : 1000);
+        const loop = config?.loop ?? false;
+        return Effect.gen(function* () {
+            const elapsedRef = yield* SubscriptionRef.make(0);
+            const playingRef = yield* Ref.make(false);
+            const directionRef = yield* Ref.make(1);
+            const initialState = Boundary.evaluate(boundary, 0);
+            const stateRef = yield* SubscriptionRef.make(initialState);
+            const sched = config?.scheduler ??
+                (typeof requestAnimationFrame !== 'undefined' ? SchedulerImpl.raf() : SchedulerImpl.noop());
+            let lastTime = null;
+            let playing = false;
+            let direction = 1;
+            let currentElapsed = 0;
+            const step = (now) => {
+                if (lastTime !== null && playing) {
+                    const dt = (now - lastTime) * direction;
+                    let next = currentElapsed + dt;
+                    if (loop) {
+                        next = ((next % duration) + duration) % duration;
+                    }
+                    else {
+                        next = Math.max(0, Math.min(duration, next));
+                    }
+                    currentElapsed = next;
+                    Effect.runSync(SubscriptionRef.set(elapsedRef, next));
+                    const newState = Boundary.evaluate(boundary, next);
+                    const oldState = Effect.runSync(SubscriptionRef.get(stateRef));
+                    if (newState !== oldState) {
+                        Effect.runSync(SubscriptionRef.set(stateRef, newState));
+                    }
+                }
+                lastTime = now;
+                schedId = sched.schedule(step);
+            };
+            let schedId = sched.schedule(step);
+            yield* Effect.addFinalizer(() => Effect.sync(() => sched.cancel(schedId)));
+            const timeline = {
+                boundary,
+                state: SubscriptionRef.get(stateRef),
+                progress: Effect.map(SubscriptionRef.get(elapsedRef), (e) => Math.max(0, Math.min(e / duration, 1))),
+                elapsed: Effect.map(SubscriptionRef.get(elapsedRef), (e) => mkMillis(e)),
+                changes: SubscriptionRef.changes(stateRef),
+                play: () => Effect.gen(function* () {
+                    playing = true;
+                    yield* Ref.set(playingRef, true);
+                }),
+                pause: () => Effect.gen(function* () {
+                    playing = false;
+                    yield* Ref.set(playingRef, false);
+                }),
+                reverse: () => Effect.gen(function* () {
+                    direction = direction === 1 ? -1 : 1;
+                    yield* Ref.update(directionRef, (d) => (d === 1 ? -1 : 1));
+                }),
+                seek: (ms) => Effect.gen(function* () {
+                    const clamped = Math.max(0, Math.min(duration, ms));
+                    currentElapsed = clamped;
+                    yield* SubscriptionRef.set(elapsedRef, clamped);
+                    const newState = Boundary.evaluate(boundary, clamped);
+                    const oldState = yield* SubscriptionRef.get(stateRef);
+                    if (newState !== oldState) {
+                        yield* SubscriptionRef.set(stateRef, newState);
+                    }
+                }),
+                scrub: (progress) => Effect.gen(function* () {
+                    const val = Math.max(0, Math.min(1, progress)) * duration;
+                    currentElapsed = val;
+                    yield* SubscriptionRef.set(elapsedRef, val);
+                    const newState = Boundary.evaluate(boundary, val);
+                    const oldState = yield* SubscriptionRef.get(stateRef);
+                    if (newState !== oldState) {
+                        yield* SubscriptionRef.set(stateRef, newState);
+                    }
+                }),
+            };
+            return timeline;
+        });
+    },
+};
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/token-buffer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TokenBuffer -- ring buffer that absorbs bursty LLM token arrival
+ * and emits at smooth cadence.
+ *
+ * Backed by pre-allocated array (zero-alloc push/drain).
+ * EMA (exponential moving average) for rate estimation.
+ * Stall detection: buffer empty + `gen < consume`.
+ *
+ * @module
+ */
+interface TokenBufferShape<T = string> {
+    push(token: T): void;
+    drain(maxCount?: number): T[];
+    reset(): void;
+    readonly occupancy: number;
+    readonly generationRate: number;
+    readonly consumptionRate: number;
+    readonly isStalled: boolean;
+    readonly length: number;
+    readonly capacity: number;
+}
+interface TokenBufferConfig {
+    readonly capacity?: number;
+    readonly emaAlpha?: number;
+}
+declare function _make<T = string>(config?: TokenBufferConfig): TokenBufferShape<T>;
+/**
+ * TokenBuffer — zero-alloc ring buffer that absorbs bursty LLM token arrival
+ * and hands tokens out at a smooth cadence. Reports stall via `isStalled`
+ * and rate via an internal EMA.
+ */
+export declare const TokenBuffer: {
+    /** Build a new buffer — pass capacity or reuse defaults. */
+    make: typeof _make;
+};
+export declare namespace TokenBuffer {
+    /** Structural shape of a token buffer: `push`, `drain`, `reset`, stall/rate accessors. */
+    type Shape<T = string> = TokenBufferShape<T>;
+    /** Configuration accepted by {@link TokenBuffer.make}. */
+    type Config = TokenBufferConfig;
+}
+export {};
+//# sourceMappingURL=token-buffer.d.ts.map

package/dist/token-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-buffer.d.ts","sourceRoot":"","sources":["../src/token-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,UAAU,gBAAgB,CAAC,CAAC,GAAG,MAAM;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iBAAS,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAyG1E;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,4DAA4D;;CAE7D,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,0FAA0F;IAC1F,KAAY,KAAK,CAAC,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACpD,0DAA0D;IAC1D,KAAY,MAAM,GAAG,iBAAiB,CAAC;CACxC"}

package/dist/token-buffer.js

@@ -0,0 +1,112 @@
+/**
+ * TokenBuffer -- ring buffer that absorbs bursty LLM token arrival
+ * and emits at smooth cadence.
+ *
+ * Backed by pre-allocated array (zero-alloc push/drain).
+ * EMA (exponential moving average) for rate estimation.
+ * Stall detection: buffer empty + `gen < consume`.
+ *
+ * @module
+ */
+function _make(config) {
+    const capacity = config?.capacity ?? 256;
+    const alpha = config?.emaAlpha ?? 0.1;
+    // Ring buffer backing store
+    const buffer = new Array(capacity);
+    let head = 0; // next write position
+    let tail = 0; // next read position
+    let count = 0;
+    // Rate estimation
+    let genRate = 0; // tokens/sec EMA
+    let consumeRate = 0;
+    let lastPushTime = 0;
+    let lastDrainTime = 0;
+    function now() {
+        return typeof performance !== 'undefined' ? performance.now() : Date.now();
+    }
+    return {
+        push(token) {
+            const t = now();
+            if (lastPushTime > 0) {
+                const dt = (t - lastPushTime) / 1000;
+                if (dt > 0) {
+                    const instantRate = 1 / dt;
+                    genRate = genRate === 0 ? instantRate : genRate * (1 - alpha) + instantRate * alpha;
+                }
+            }
+            lastPushTime = t;
+            if (count < capacity) {
+                buffer[head] = token;
+                head = (head + 1) % capacity;
+                count++;
+            }
+            else {
+                // Overflow: overwrite oldest (drop tail)
+                buffer[head] = token;
+                head = (head + 1) % capacity;
+                tail = (tail + 1) % capacity;
+            }
+        },
+        drain(maxCount) {
+            const max = maxCount ?? count;
+            const drainSize = Math.min(max, count);
+            if (drainSize === 0)
+                return [];
+            const t = now();
+            if (lastDrainTime > 0) {
+                const dt = (t - lastDrainTime) / 1000;
+                if (dt > 0) {
+                    const instantRate = drainSize / dt;
+                    consumeRate = consumeRate === 0 ? instantRate : consumeRate * (1 - alpha) + instantRate * alpha;
+                }
+            }
+            lastDrainTime = t;
+            const result = [];
+            for (let i = 0; i < drainSize; i++) {
+                result.push(buffer[tail]);
+                buffer[tail] = undefined;
+                tail = (tail + 1) % capacity;
+                count--;
+            }
+            return result;
+        },
+        reset() {
+            head = 0;
+            tail = 0;
+            count = 0;
+            genRate = 0;
+            consumeRate = 0;
+            lastPushTime = 0;
+            lastDrainTime = 0;
+            buffer.fill(undefined);
+        },
+        get occupancy() {
+            return count / capacity;
+        },
+        get generationRate() {
+            return genRate;
+        },
+        get consumptionRate() {
+            return consumeRate;
+        },
+        get isStalled() {
+            return count === 0 && genRate > 0 && genRate < consumeRate;
+        },
+        get length() {
+            return count;
+        },
+        get capacity() {
+            return capacity;
+        },
+    };
+}
+/**
+ * TokenBuffer — zero-alloc ring buffer that absorbs bursty LLM token arrival
+ * and hands tokens out at a smooth cadence. Reports stall via `isStalled`
+ * and rate via an internal EMA.
+ */
+export const TokenBuffer = {
+    /** Build a new buffer — pass capacity or reuse defaults. */
+    make: _make,
+};
+//# sourceMappingURL=token-buffer.js.map

package/dist/token-buffer.js.map

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

package/dist/token.d.ts

@@ -0,0 +1,107 @@
+/**
+ * TokenDef -- design token primitive for constraint-based adaptive rendering.
+ *
+ * A token defines a named design value that varies across axes (e.g. theme,
+ * density, contrast). Content-addressed via FNV-1a.
+ *
+ * @module
+ */
+import type { ContentAddress } from './brands.js';
+/** Design-system category of a {@link Token} — governs compilation strategy and CSS property prefix. */
+export type TokenCategory = 'color' | 'spacing' | 'typography' | 'shadow' | 'radius' | 'animation' | 'effect';
+interface TokenDef<N extends string = string, Axes extends readonly string[] = readonly string[]> {
+    readonly _tag: 'TokenDef';
+    readonly _version: 1;
+    readonly id: ContentAddress;
+    readonly name: N;
+    readonly category: TokenCategory;
+    readonly axes: Axes;
+    readonly values: Record<string, unknown>;
+    readonly fallback: unknown;
+    readonly cssProperty: `--${string}`;
+}
+interface TokenFactory {
+    make<N extends string, const A extends readonly [string, ...string[]]>(config: {
+        readonly name: N;
+        readonly category: TokenCategory;
+        readonly axes: A;
+        readonly values: Record<string, unknown>;
+        readonly fallback: unknown;
+    }): TokenDef<N, A>;
+}
+/**
+ * Resolve a token's value for the given axis values. Builds a sorted lookup key.
+ *
+ * Axes are sorted alphabetically and joined with ':' to form the lookup key.
+ * Falls back to the token's fallback value if no match is found.
+ *
+ * The optional type parameter `T` lets callers narrow the return value when
+ * they know the value shape; without it, the return is `unknown` (the
+ * underlying `TokenDef.values` is `Record<string, unknown>` because token
+ * values can be any JSON shape — colors as strings, spacing as numbers,
+ * shadow records as objects). Pass `Token.tap<string>(...)` for a color
+ * token, etc.
+ *
+ * @example
+ * ```ts
+ * const token = Token.make({
+ *   name: 'primary', category: 'color',
+ *   axes: ['theme'] as const,
+ *   values: { 'light': '#000', 'dark': '#fff' },
+ *   fallback: '#888',
+ * });
+ * const value = Token.tap<string>(token, { theme: 'dark' });
+ * // value === '#fff' (typed as string)
+ * ```
+ */
+declare function _tap<T = unknown>(token: TokenDef, axisValues: Record<string, string>): T;
+/**
+ * Generate a CSS var() reference for a token.
+ *
+ * Returns a `var(--czap-<name>)` string suitable for use in CSS properties.
+ *
+ * @example
+ * ```ts
+ * const token = Token.make({
+ *   name: 'primary', category: 'color',
+ *   axes: ['theme'] as const,
+ *   values: { 'light': '#000' },
+ *   fallback: '#888',
+ * });
+ * const ref = Token.cssVar(token);
+ * // ref === 'var(--czap-primary)'
+ * ```
+ */
+declare function _cssVar<N extends string>(token: TokenDef<N>): `var(--czap-${N})`;
+/**
+ * Token namespace -- design token primitive for adaptive rendering.
+ *
+ * Create named design values that vary across axes (theme, density, contrast).
+ * Tokens are content-addressed and produce CSS custom property references.
+ *
+ * @example
+ * ```ts
+ * import { Token } from '@czap/core';
+ *
+ * const spacing = Token.make({
+ *   name: 'gap', category: 'spacing',
+ *   axes: ['density'] as const,
+ *   values: { 'compact': '4px', 'comfortable': '8px' },
+ *   fallback: '6px',
+ * });
+ * const resolved = Token.tap(spacing, { density: 'compact' });
+ * // resolved === '4px'
+ * const cssRef = Token.cssVar(spacing);
+ * // cssRef === 'var(--czap-gap)'
+ * ```
+ */
+export declare const Token: TokenFactory & {
+    tap: typeof _tap;
+    cssVar: typeof _cssVar;
+};
+export declare namespace Token {
+    /** Structural shape of a token definition parameterized by its name `N` and axis tuple `Axes`. */
+    type Shape<N extends string = string, Axes extends readonly string[] = readonly string[]> = TokenDef<N, Axes>;
+}
+export {};
+//# sourceMappingURL=token.d.ts.map

package/dist/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,wGAAwG;AACxG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9G,UAAU,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAC9F,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;CACrC;AAED,UAAU,YAAY;IACpB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE;QAC7E,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACpB;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAMjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,GAAG,CAEzE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK,EAAE,YAAY,GAAG;IACjC,GAAG,EAAE,OAAO,IAAI,CAAC;IACjB,MAAM,EAAE,OAAO,OAAO,CAAC;CAsDxB,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,kGAAkG;IAClG,KAAY,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;CACtH"}

package/dist/token.js

@@ -0,0 +1,143 @@
+/**
+ * TokenDef -- design token primitive for constraint-based adaptive rendering.
+ *
+ * A token defines a named design value that varies across axes (e.g. theme,
+ * density, contrast). Content-addressed via FNV-1a.
+ *
+ * @module
+ */
+import { CanonicalCbor } from './cbor.js';
+import { fnv1aBytes } from './fnv.js';
+import { CzapValidationError } from './validation-error.js';
+function deterministicId(name, category, axes, values, fallback) {
+    return fnv1aBytes(CanonicalCbor.encode({
+        _tag: 'TokenDef',
+        _version: 1,
+        name,
+        category,
+        axes,
+        values,
+        fallback,
+    }));
+}
+/**
+ * Resolve a token's value for the given axis values. Builds a sorted lookup key.
+ *
+ * Axes are sorted alphabetically and joined with ':' to form the lookup key.
+ * Falls back to the token's fallback value if no match is found.
+ *
+ * The optional type parameter `T` lets callers narrow the return value when
+ * they know the value shape; without it, the return is `unknown` (the
+ * underlying `TokenDef.values` is `Record<string, unknown>` because token
+ * values can be any JSON shape — colors as strings, spacing as numbers,
+ * shadow records as objects). Pass `Token.tap<string>(...)` for a color
+ * token, etc.
+ *
+ * @example
+ * ```ts
+ * const token = Token.make({
+ *   name: 'primary', category: 'color',
+ *   axes: ['theme'] as const,
+ *   values: { 'light': '#000', 'dark': '#fff' },
+ *   fallback: '#888',
+ * });
+ * const value = Token.tap<string>(token, { theme: 'dark' });
+ * // value === '#fff' (typed as string)
+ * ```
+ */
+function _tap(token, axisValues) {
+    const key = [...token.axes]
+        .sort()
+        .map((axis) => axisValues[axis] ?? '')
+        .join(':');
+    return (token.values[key] ?? token.fallback);
+}
+/**
+ * Generate a CSS var() reference for a token.
+ *
+ * Returns a `var(--czap-<name>)` string suitable for use in CSS properties.
+ *
+ * @example
+ * ```ts
+ * const token = Token.make({
+ *   name: 'primary', category: 'color',
+ *   axes: ['theme'] as const,
+ *   values: { 'light': '#000' },
+ *   fallback: '#888',
+ * });
+ * const ref = Token.cssVar(token);
+ * // ref === 'var(--czap-primary)'
+ * ```
+ */
+function _cssVar(token) {
+    return `var(--czap-${token.name})`;
+}
+/**
+ * Token namespace -- design token primitive for adaptive rendering.
+ *
+ * Create named design values that vary across axes (theme, density, contrast).
+ * Tokens are content-addressed and produce CSS custom property references.
+ *
+ * @example
+ * ```ts
+ * import { Token } from '@czap/core';
+ *
+ * const spacing = Token.make({
+ *   name: 'gap', category: 'spacing',
+ *   axes: ['density'] as const,
+ *   values: { 'compact': '4px', 'comfortable': '8px' },
+ *   fallback: '6px',
+ * });
+ * const resolved = Token.tap(spacing, { density: 'compact' });
+ * // resolved === '4px'
+ * const cssRef = Token.cssVar(spacing);
+ * // cssRef === 'var(--czap-gap)'
+ * ```
+ */
+export const Token = {
+    /**
+     * Create a new TokenDef from a configuration object.
+     *
+     * The token is content-addressed via FNV-1a hash of its name, category,
+     * axes, and values. The resulting object is frozen.
+     *
+     * @example
+     * ```ts
+     * const token = Token.make({
+     *   name: 'bg', category: 'color',
+     *   axes: ['theme', 'contrast'] as const,
+     *   values: { 'light:normal': '#fff', 'dark:normal': '#111' },
+     *   fallback: '#ccc',
+     * });
+     * // token._tag === 'TokenDef'
+     * // token.cssProperty === '--czap-bg'
+     * ```
+     */
+    make(config) {
+        if (config.name === '') {
+            throw new CzapValidationError('Token.make', 'Token name must not be empty.');
+        }
+        const seen = new Set();
+        for (const axis of config.axes) {
+            if (seen.has(axis)) {
+                throw new CzapValidationError('Token.make', `duplicate axis "${axis}". Each axis must have a unique name.`);
+            }
+            seen.add(axis);
+        }
+        const id = deterministicId(config.name, config.category, config.axes, config.values, config.fallback);
+        return Object.freeze({
+            _tag: 'TokenDef',
+            _version: 1,
+            id,
+            name: config.name,
+            category: config.category,
+            axes: config.axes,
+            values: config.values,
+            fallback: config.fallback,
+            cssProperty: `--czap-${config.name}`,
+        });
+    },
+    tap: _tap,
+    cssVar: _cssVar,
+};
+//# sourceMappingURL=token.js.map

package/dist/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AA2B5D,SAAS,eAAe,CACtB,IAAY,EACZ,QAAgB,EAChB,IAAuB,EACvB,MAA+B,EAC/B,QAAiB;IAEjB,OAAO,UAAU,CACf,aAAa,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,CAAC;QACX,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,MAAM;QACN,QAAQ;KACT,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAS,IAAI,CAAc,KAAe,EAAE,UAAkC;IAC5E,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;SACxB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACrC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAM,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,OAAO,CAAmB,KAAkB;IACnD,OAAO,cAAc,KAAK,CAAC,IAAI,GAAyB,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,KAAK,GAGd;IACF;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAmE,MAMtE;QACC,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,+BAA+B,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,mBAAmB,IAAI,uCAAuC,CAAC,CAAC;YAC9G,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEtG,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE,CAAU;YACpB,EAAE;YACF,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,UAAU,MAAM,CAAC,IAAI,EAAW;SAC9C,CAAC,CAAC;IACL,CAAC;IACD,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,OAAO;CAChB,CAAC"}

package/dist/tuple.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Map each element of a readonly tuple, preserving tuple arity and ordering.
+ *
+ * TypeScript's Array.prototype.map returns U[], erasing tuple structure.
+ * This helper reintroduces the mapped tuple type via one narrow cast,
+ * provably safe: the map is total over the input and the output element
+ * type is uniform.
+ *
+ * @example
+ * ```ts
+ * const types = tupleMap([1, 'two', true] as const, (el) => typeof el);
+ * // types: readonly ['number', 'string', 'boolean']
+ * ```
+ */
+export declare const tupleMap: <T extends readonly unknown[], U>(tuple: T, fn: (element: T[number], index: number) => U) => { readonly [K in keyof T]: U; };
+//# sourceMappingURL=tuple.d.ts.map

package/dist/tuple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.d.ts","sourceRoot":"","sources":["../src/tuple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,OAAO,CAAC,EACR,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,KAC3C,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GACkB,CAAC"}

package/dist/tuple.js

@@ -0,0 +1,16 @@
+/**
+ * Map each element of a readonly tuple, preserving tuple arity and ordering.
+ *
+ * TypeScript's Array.prototype.map returns U[], erasing tuple structure.
+ * This helper reintroduces the mapped tuple type via one narrow cast,
+ * provably safe: the map is total over the input and the output element
+ * type is uniform.
+ *
+ * @example
+ * ```ts
+ * const types = tupleMap([1, 'two', true] as const, (el) => typeof el);
+ * // types: readonly ['number', 'string', 'boolean']
+ * ```
+ */
+export const tupleMap = (tuple, fn) => tuple.map(fn);
+//# sourceMappingURL=tuple.js.map

package/dist/tuple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../src/tuple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,KAAQ,EACR,EAA4C,EACZ,EAAE,CAClC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAmC,CAAC"}