@czap/quantizer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Eassa Ayoub <eassa@heyoub.dev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @czap/quantizer
+
+Q.from() builder, boundary evaluation, animated transitions, MotionTier gating.
+
+## Docs
+
+- [Naming & vocabulary](../../docs/GLOSSARY.md) — LiteShip, CZAP, `@czap/*`
+
+- [API reference](https://github.com/heyoub/LiteShip/tree/main/docs/api/quantizer/) — generated from source TSDoc
+- [Architecture index](https://github.com/heyoub/LiteShip/blob/main/docs/ARCHITECTURE.md)
+- [ADRs](https://github.com/heyoub/LiteShip/tree/main/docs/adr/)
+
+## Install
+
+```bash
+pnpm add @czap/quantizer
+```
+
+## Part of [LiteShip](https://github.com/heyoub/LiteShip#readme)

package/dist/animated-quantizer.d.ts

@@ -0,0 +1,108 @@
+/**
+ * AnimatedQuantizer -- wraps a Quantizer with Transitions.
+ * On boundary crossing, interpolates between old and new output values
+ * over the configured transition duration/easing.
+ */
+import type { Scope } from 'effect';
+import { Effect, Stream } from 'effect';
+import type { Boundary, StateUnion, Quantizer } from '@czap/core';
+import type { Transition, TransitionMap } from './transition.js';
+/**
+ * Quantizer augmented with transition-aware output interpolation.
+ *
+ * The `interpolated` stream emits a frame on each animation tick containing
+ * the target state, normalized progress (0-1), and the current lerped
+ * output record. Non-numeric values snap at the 50% mark.
+ */
+export interface AnimatedQuantizerShape<B extends Boundary.Shape> extends Quantizer<B> {
+    /** Resolver that maps `from -> to` crossings to {@link TransitionConfig}. */
+    readonly transition: Transition<B>;
+    /** Stream of interpolated animation frames during crossings. */
+    readonly interpolated: Stream.Stream<{
+        /** Target state of the in-flight transition. */
+        readonly state: StateUnion<B>;
+        /** Progress in `[0, 1]`, where `1` means the animation has landed. */
+        readonly progress: number;
+        /** Interpolated output record for the current frame. */
+        readonly outputs: Record<string, number | string>;
+    }>;
+}
+/**
+ * Create an animated quantizer that interpolates outputs during transitions.
+ *
+ * Wraps an existing {@link Quantizer} and applies easing/duration-based
+ * interpolation between old and new output values when a boundary crossing
+ * occurs. Produces an `interpolated` stream of frames with progress and
+ * lerped numeric outputs at ~60fps.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Q, AnimatedQuantizer } from '@czap/quantizer';
+ * import { Effect, Stream } from 'effect';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'scroll', states: ['top', 'bottom'] as const,
+ *   thresholds: [0, 500],
+ * });
+ * const config = Q.from(boundary).outputs({
+ *   css: { top: { opacity: '1' }, bottom: { opacity: '0.5' } },
+ * });
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const live = yield* config.create();
+ *   const animated = yield* AnimatedQuantizer.make(
+ *     live,
+ *     { '*->*': { duration: 300 } },
+ *     { top: { opacity: 1 }, bottom: { opacity: 0.5 } },
+ *   );
+ *   live.evaluate(600); // triggers interpolation
+ *   return animated;
+ * }));
+ * ```
+ *
+ * @param quantizer   - The base quantizer to wrap
+ * @param transitions - Map of state transition configs keyed by `from->to` pattern
+ * @param outputs     - Per-state numeric output maps for interpolation
+ * @returns An Effect yielding an {@link AnimatedQuantizerShape} (scoped)
+ */
+declare function makeAnimatedQuantizer<B extends Boundary.Shape>(quantizer: Quantizer<B>, transitions: TransitionMap<StateUnion<B> & string>, outputs?: Record<string, Record<string, number | string>>): Effect.Effect<AnimatedQuantizerShape<B>, never, Scope.Scope>;
+/**
+ * Animated quantizer namespace.
+ *
+ * Wraps a base quantizer with transition-aware interpolation. When a boundary
+ * crossing occurs, numeric output values are lerped over a configurable
+ * duration and easing curve. Non-numeric values snap at the 50% mark.
+ * The `interpolated` stream emits frames containing progress (0-1) and
+ * the current interpolated output record.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Q, AnimatedQuantizer } from '@czap/quantizer';
+ * import { Effect } from 'effect';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'scroll', states: ['top', 'bottom'] as const,
+ *   thresholds: [0, 500],
+ * });
+ * const config = Q.from(boundary).outputs({});
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const live = yield* config.create();
+ *   const animated = yield* AnimatedQuantizer.make(
+ *     live,
+ *     { '*->*': { duration: 200 } },
+ *   );
+ *   return animated.transition; // TransitionResolver
+ * }));
+ * ```
+ */
+export declare const AnimatedQuantizer: {
+    /** Wrap a quantizer with transition-aware output interpolation. */
+    readonly make: typeof makeAnimatedQuantizer;
+};
+export declare namespace AnimatedQuantizer {
+    /** Shape of an animated quantizer parameterized by boundary `B`. */
+    type Shape<B extends Boundary.Shape> = AnimatedQuantizerShape<B>;
+}
+export {};
+//# sourceMappingURL=animated-quantizer.d.ts.map

package/dist/animated-quantizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animated-quantizer.d.ts","sourceRoot":"","sources":["../src/animated-quantizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAgD,MAAM,QAAQ,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAoB,SAAS,EAAU,MAAM,YAAY,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOjE;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACpF,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QACnC,gDAAgD;QAChD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,sEAAsE;QACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,wDAAwD;QACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;KACnD,CAAC,CAAC;CACJ;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAS,qBAAqB,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,EACrD,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GACxD,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAyG9D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mEAAmE;;CAE3D,CAAC;AAEX,MAAM,CAAC,OAAO,WAAW,iBAAiB,CAAC;IACzC,oEAAoE;IACpE,KAAY,KAAK,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC;CACzE"}

package/dist/animated-quantizer.js

@@ -0,0 +1,196 @@
+/**
+ * AnimatedQuantizer -- wraps a Quantizer with Transitions.
+ * On boundary crossing, interpolates between old and new output values
+ * over the configured transition duration/easing.
+ */
+import { Effect, Stream, SubscriptionRef, Queue, Fiber, Ref, Duration } from 'effect';
+import { Transition as TransitionFactory } from './transition.js';
+// ---------------------------------------------------------------------------
+// Linear easing fallback
+// ---------------------------------------------------------------------------
+const linearEasing = (t) => t;
+// ---------------------------------------------------------------------------
+// Interpolate numeric values between two output records
+// ---------------------------------------------------------------------------
+function lerpOutputs(from, to, t) {
+    const result = {};
+    const allKeys = new Set([...Object.keys(from), ...Object.keys(to)]);
+    for (const key of allKeys) {
+        const a = from[key];
+        const b = to[key];
+        if (typeof a === 'number' && typeof b === 'number') {
+            result[key] = a + (b - a) * t;
+        }
+        else {
+            // Non-numeric values snap to target at progress >= 0.5
+            result[key] = (t < 0.5 ? (a ?? b) : (b ?? a));
+        }
+    }
+    return result;
+}
+function nowMs() {
+    // performance.now() is standard in browsers and Node ≥ 16.
+    // Optional chaining guards against stripped worker/SSR environments.
+    if (typeof globalThis.performance?.now === 'function') {
+        return globalThis.performance.now();
+    }
+    return Date.now();
+}
+// ---------------------------------------------------------------------------
+// Factory (internal impl)
+// ---------------------------------------------------------------------------
+/**
+ * Create an animated quantizer that interpolates outputs during transitions.
+ *
+ * Wraps an existing {@link Quantizer} and applies easing/duration-based
+ * interpolation between old and new output values when a boundary crossing
+ * occurs. Produces an `interpolated` stream of frames with progress and
+ * lerped numeric outputs at ~60fps.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Q, AnimatedQuantizer } from '@czap/quantizer';
+ * import { Effect, Stream } from 'effect';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'scroll', states: ['top', 'bottom'] as const,
+ *   thresholds: [0, 500],
+ * });
+ * const config = Q.from(boundary).outputs({
+ *   css: { top: { opacity: '1' }, bottom: { opacity: '0.5' } },
+ * });
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const live = yield* config.create();
+ *   const animated = yield* AnimatedQuantizer.make(
+ *     live,
+ *     { '*->*': { duration: 300 } },
+ *     { top: { opacity: 1 }, bottom: { opacity: 0.5 } },
+ *   );
+ *   live.evaluate(600); // triggers interpolation
+ *   return animated;
+ * }));
+ * ```
+ *
+ * @param quantizer   - The base quantizer to wrap
+ * @param transitions - Map of state transition configs keyed by `from->to` pattern
+ * @param outputs     - Per-state numeric output maps for interpolation
+ * @returns An Effect yielding an {@link AnimatedQuantizerShape} (scoped)
+ */
+function makeAnimatedQuantizer(quantizer, transitions, outputs) {
+    return Effect.gen(function* () {
+        const boundary = quantizer.boundary;
+        const transitionResolver = TransitionFactory.for(quantizer, transitions);
+        const initialState = yield* quantizer.state;
+        const stateRef = yield* SubscriptionRef.make(initialState);
+        const currentOutputsRef = yield* Ref.make(outputs?.[initialState] ?? {});
+        const currentFiberRef = yield* Ref.make(null);
+        const interpolatedStream = Stream.callback((queue) => Effect.gen(function* () {
+            yield* Effect.addFinalizer(() => Effect.gen(function* () {
+                const currentFiber = yield* Ref.get(currentFiberRef);
+                if (currentFiber !== null) {
+                    yield* Fiber.interrupt(currentFiber);
+                }
+            }));
+            yield* Stream.runForEach(quantizer.changes, (crossing) => Effect.gen(function* () {
+                const existingFiber = yield* Ref.get(currentFiberRef);
+                if (existingFiber !== null) {
+                    yield* Fiber.interrupt(existingFiber);
+                }
+                // crossing.from/to are StateName<StateUnion<B> & string>, which is a branded
+                // subtype of StateUnion<B>; assignable directly without a cast.
+                const { from, to } = crossing;
+                const config = transitionResolver.getTransition(from, to);
+                const duration = config.duration;
+                const easing = config.easing ?? linearEasing;
+                const delay = config.delay ?? 0;
+                const fromOutputs = { ...(yield* Ref.get(currentOutputsRef)) };
+                const toOutputs = outputs?.[crossing.to] ?? {};
+                const animationLoop = Effect.gen(function* () {
+                    if (delay > 0) {
+                        yield* Effect.sleep(Duration.millis(delay));
+                    }
+                    if (duration <= 0) {
+                        Queue.offerUnsafe(queue, { state: to, progress: 1, outputs: toOutputs });
+                        yield* Ref.set(currentOutputsRef, toOutputs);
+                        yield* SubscriptionRef.set(stateRef, to);
+                        return;
+                    }
+                    // Time-sliced animation loop (~60fps via 16ms sleep)
+                    const startTime = nowMs();
+                    let progress = 0;
+                    while (progress < 1) {
+                        const elapsed = nowMs() - startTime;
+                        progress = Math.min(elapsed / duration, 1);
+                        const eased = easing(progress);
+                        const interpolated = lerpOutputs(fromOutputs, toOutputs, eased);
+                        yield* Ref.set(currentOutputsRef, interpolated);
+                        Queue.offerUnsafe(queue, { state: to, progress, outputs: interpolated });
+                        if (progress < 1) {
+                            yield* Effect.sleep(Duration.millis(16));
+                        }
+                    }
+                    yield* Ref.set(currentOutputsRef, toOutputs);
+                    yield* SubscriptionRef.set(stateRef, to);
+                });
+                const fiber = yield* Effect.forkChild(animationLoop);
+                yield* Ref.set(currentFiberRef, fiber);
+            }));
+            const finalFiber = yield* Ref.get(currentFiberRef);
+            const fibers = [finalFiber].filter((fiber) => fiber !== null);
+            yield* Effect.forEach(fibers, Fiber.join, { discard: true });
+            yield* Ref.set(currentFiberRef, null);
+        }));
+        const animatedQuantizer = {
+            _tag: 'Quantizer',
+            boundary,
+            transition: transitionResolver,
+            state: SubscriptionRef.get(stateRef),
+            stateSync: quantizer.stateSync ? () => quantizer.stateSync() : undefined,
+            changes: quantizer.changes,
+            evaluate(value) {
+                return quantizer.evaluate(value);
+            },
+            interpolated: interpolatedStream,
+        };
+        return animatedQuantizer;
+    });
+}
+// ---------------------------------------------------------------------------
+// AnimatedQuantizer module object
+// ---------------------------------------------------------------------------
+/**
+ * Animated quantizer namespace.
+ *
+ * Wraps a base quantizer with transition-aware interpolation. When a boundary
+ * crossing occurs, numeric output values are lerped over a configurable
+ * duration and easing curve. Non-numeric values snap at the 50% mark.
+ * The `interpolated` stream emits frames containing progress (0-1) and
+ * the current interpolated output record.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Q, AnimatedQuantizer } from '@czap/quantizer';
+ * import { Effect } from 'effect';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'scroll', states: ['top', 'bottom'] as const,
+ *   thresholds: [0, 500],
+ * });
+ * const config = Q.from(boundary).outputs({});
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const live = yield* config.create();
+ *   const animated = yield* AnimatedQuantizer.make(
+ *     live,
+ *     { '*->*': { duration: 200 } },
+ *   );
+ *   return animated.transition; // TransitionResolver
+ * }));
+ * ```
+ */
+export const AnimatedQuantizer = {
+    /** Wrap a quantizer with transition-aware output interpolation. */
+    make: makeAnimatedQuantizer,
+};
+//# sourceMappingURL=animated-quantizer.js.map

package/dist/animated-quantizer.js.map

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

package/dist/evaluate.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Binary search evaluation of a value against boundary thresholds.
+ * Supports hysteresis to prevent state jitter at threshold edges.
+ */
+import type { Boundary, StateUnion } from '@czap/core';
+/**
+ * Result of quantizing a single numeric value against a boundary.
+ *
+ * `crossed` is true only when `previousState` was supplied and differs
+ * from the resolved state; it is the signal consumers use to emit
+ * transition events and route side effects.
+ */
+export interface EvaluateResult<S extends string = string> {
+    /** The resolved state literal. */
+    readonly state: S;
+    /** Index of `state` within the boundary's states tuple. */
+    readonly index: number;
+    /** The input value that was evaluated. */
+    readonly value: number;
+    /** Whether evaluation produced a change from `previousState`. */
+    readonly crossed: boolean;
+}
+/**
+ * Find which state a value maps to via binary search over sorted thresholds.
+ * With hysteresis: if previousState is provided and the value is within the
+ * hysteresis dead zone of a threshold, transition is suppressed.
+ *
+ * BoundaryDef contract: `thresholds[i]` = lower bound of `states[i]`.
+ * Binary search finds the largest index `i` where `thresholds[i] <= value`.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { evaluate } from '@czap/quantizer';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'width', states: ['sm', 'md', 'lg'] as const,
+ *   thresholds: [0, 640, 1024], hysteresis: 20,
+ * });
+ * const result = evaluate(boundary, 800);
+ * // result => { state: 'md', index: 1, value: 800, crossed: false }
+ *
+ * const cross = evaluate(boundary, 1100, 'md');
+ * // cross => { state: 'lg', index: 2, value: 1100, crossed: true }
+ * ```
+ *
+ * @param boundary      - The boundary definition with states and thresholds
+ * @param value         - The numeric value to evaluate
+ * @param previousState - Optional previous state for hysteresis and crossing detection
+ * @returns An {@link EvaluateResult} with the resolved state, index, and crossing flag
+ */
+export declare function evaluate<B extends Boundary.Shape>(boundary: B, value: number, previousState?: StateUnion<B>): EvaluateResult<StateUnion<B> & string>;
+/**
+ * Boundary evaluation namespace.
+ *
+ * Provides `evaluate()` for mapping a numeric value to a discrete state
+ * via binary search over boundary thresholds with optional hysteresis
+ * to prevent jitter at threshold edges.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Evaluate } from '@czap/quantizer';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'width', states: ['sm', 'lg'] as const,
+ *   thresholds: [0, 768], hysteresis: 10,
+ * });
+ * const r1 = Evaluate.evaluate(boundary, 500);
+ * // r1.state => 'sm', r1.crossed => false
+ *
+ * const r2 = Evaluate.evaluate(boundary, 900, 'sm');
+ * // r2.state => 'lg', r2.crossed => true
+ * ```
+ */
+export declare const Evaluate: {
+    readonly evaluate: typeof evaluate;
+};
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACvD,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,CAAC,KAAK,EAC/C,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAC5B,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CA4ExC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ;;CAAwB,CAAC"}

package/dist/evaluate.js

@@ -0,0 +1,128 @@
+/**
+ * Binary search evaluation of a value against boundary thresholds.
+ * Supports hysteresis to prevent state jitter at threshold edges.
+ */
+/**
+ * Find which state a value maps to via binary search over sorted thresholds.
+ * With hysteresis: if previousState is provided and the value is within the
+ * hysteresis dead zone of a threshold, transition is suppressed.
+ *
+ * BoundaryDef contract: `thresholds[i]` = lower bound of `states[i]`.
+ * Binary search finds the largest index `i` where `thresholds[i] <= value`.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { evaluate } from '@czap/quantizer';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'width', states: ['sm', 'md', 'lg'] as const,
+ *   thresholds: [0, 640, 1024], hysteresis: 20,
+ * });
+ * const result = evaluate(boundary, 800);
+ * // result => { state: 'md', index: 1, value: 800, crossed: false }
+ *
+ * const cross = evaluate(boundary, 1100, 'md');
+ * // cross => { state: 'lg', index: 2, value: 1100, crossed: true }
+ * ```
+ *
+ * @param boundary      - The boundary definition with states and thresholds
+ * @param value         - The numeric value to evaluate
+ * @param previousState - Optional previous state for hysteresis and crossing detection
+ * @returns An {@link EvaluateResult} with the resolved state, index, and crossing flag
+ */
+export function evaluate(boundary, value, previousState) {
+    const { thresholds, states, hysteresis } = boundary;
+    // Boundary.make guarantees states is non-empty; index access below yields StateUnion<B>.
+    // `& string` is structurally satisfied because every state literal is a string.
+    const stateAt = (index) => states[index];
+    if (thresholds.length === 0) {
+        return {
+            state: stateAt(0),
+            index: 0,
+            value,
+            crossed: false,
+        };
+    }
+    // Binary search: find largest index i where thresholds[i] <= value
+    // This gives the state whose lower bound is satisfied.
+    let lo = 0;
+    let hi = thresholds.length - 1;
+    let rawIndex = 0; // default: first state (value below all thresholds)
+    while (lo <= hi) {
+        const mid = (lo + hi) >>> 1;
+        if (thresholds[mid] <= value) {
+            rawIndex = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    const state = stateAt(rawIndex);
+    // Without hysteresis or no previous state, return raw result
+    if (!hysteresis || hysteresis <= 0 || previousState === undefined) {
+        const crossed = previousState !== undefined && previousState !== state;
+        return { state, index: rawIndex, value, crossed };
+    }
+    // Find previous state index
+    const prevIndex = states.indexOf(previousState);
+    if (prevIndex === -1) {
+        return { state, index: rawIndex, value, crossed: true };
+    }
+    // No crossing needed
+    if (rawIndex === prevIndex) {
+        return { state, index: rawIndex, value, crossed: false };
+    }
+    // Half-width hysteresis: dead zone of h/2 each side of threshold
+    const half = hysteresis / 2;
+    // Check ALL intermediate thresholds for dead zone suppression
+    if (rawIndex > prevIndex) {
+        // Crossing upward -- check thresholds from prevIndex+1 to rawIndex
+        for (let i = prevIndex + 1; i <= rawIndex; i++) {
+            const threshold = thresholds[i];
+            if (threshold !== undefined && value < threshold + half) {
+                // In dead zone -- settle at state just below this threshold
+                const settleIndex = i - 1;
+                return { state: stateAt(settleIndex), index: settleIndex, value, crossed: settleIndex !== prevIndex };
+            }
+        }
+    }
+    else {
+        // Crossing downward -- check thresholds from prevIndex down to rawIndex+1
+        for (let i = prevIndex; i > rawIndex; i--) {
+            const threshold = thresholds[i];
+            if (threshold !== undefined && value > threshold - half) {
+                // In dead zone -- settle at this state
+                return { state: stateAt(i), index: i, value, crossed: i !== prevIndex };
+            }
+        }
+    }
+    // Cleared all dead zones -- full transition
+    return { state, index: rawIndex, value, crossed: true };
+}
+/**
+ * Boundary evaluation namespace.
+ *
+ * Provides `evaluate()` for mapping a numeric value to a discrete state
+ * via binary search over boundary thresholds with optional hysteresis
+ * to prevent jitter at threshold edges.
+ *
+ * @example
+ * ```ts
+ * import { Boundary } from '@czap/core';
+ * import { Evaluate } from '@czap/quantizer';
+ *
+ * const boundary = Boundary.make({
+ *   input: 'width', states: ['sm', 'lg'] as const,
+ *   thresholds: [0, 768], hysteresis: 10,
+ * });
+ * const r1 = Evaluate.evaluate(boundary, 500);
+ * // r1.state => 'sm', r1.crossed => false
+ *
+ * const r2 = Evaluate.evaluate(boundary, 900, 'sm');
+ * // r2.state => 'lg', r2.crossed => true
+ * ```
+ */
+export const Evaluate = { evaluate };
+//# sourceMappingURL=evaluate.js.map

package/dist/evaluate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@czap/quantizer` — **LiteShip** quantizer: **rigged** boundary evaluation,
+ * live state, animated transitions between bearings, and motion-tier gating on
+ * the working line.
+ *
+ * @module
+ */
+export { evaluate, Evaluate } from './evaluate.js';
+export type { EvaluateResult } from './evaluate.js';
+export { Q } from './quantizer.js';
+export type { OutputTarget, QuantizerOutputs, QuantizerConfig, LiveQuantizer, QuantizerBuilder } from './quantizer.js';
+export { Transition } from './transition.js';
+export type { TransitionConfig, TransitionMap, Transition as TransitionType } from './transition.js';
+export { AnimatedQuantizer } from './animated-quantizer.js';
+export type { AnimatedQuantizerShape } from './animated-quantizer.js';
+export { TransitionConfigSchema, TransitionMapSchema, OutputTargetSchema, QuantizerOutputsSchema } from './schemas.js';
+export type { MotionTier, SpringConfig, QuantizerFromOptions } from './quantizer.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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEvH,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * `@czap/quantizer` — **LiteShip** quantizer: **rigged** boundary evaluation,
+ * live state, animated transitions between bearings, and motion-tier gating on
+ * the working line.
+ *
+ * @module
+ */
+export { evaluate, Evaluate } from './evaluate.js';
+export { Q } from './quantizer.js';
+export { Transition } from './transition.js';
+export { AnimatedQuantizer } from './animated-quantizer.js';
+export { TransitionConfigSchema, TransitionMapSchema, OutputTargetSchema, QuantizerOutputsSchema } from './schemas.js';
+// `MemoCache` and `TIER_TARGETS` ship via `@czap/quantizer/testing` —
+// implementation primitives that power the public `Q.from()` builder
+// internally but are not consumer-facing API.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGvH,sEAAsE;AACtE,qEAAqE;AACrE,8CAA8C"}

package/dist/memo-cache.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MemoCache -- content-address memoization layer.
+ *
+ * Boundaries and quantizer configs are already content-addressed via FNV-1a.
+ * This cache ensures identical configs never recompute. Content-addressed keys
+ * mean the cache is auto-invalidating: change definition → hash changes → miss.
+ *
+ * @module
+ */
+import type { ContentAddress } from '@czap/core';
+interface MemoCacheShape<V> {
+    get(key: ContentAddress): V | undefined;
+    set(key: ContentAddress, value: V): void;
+    has(key: ContentAddress): boolean;
+    readonly size: number;
+}
+declare function _make<V>(): MemoCacheShape<V>;
+/**
+ * Content-address memoization cache.
+ *
+ * Keys are {@link ContentAddress} values, so the cache is auto-invalidating:
+ * any change to an upstream definition produces a new hash and a guaranteed
+ * miss. Backed by an unbounded {@link Map}; callers are responsible for
+ * lifetime and eviction if needed.
+ */
+export declare const MemoCache: {
+    /** Construct a fresh cache with value type `V`. */
+    make: typeof _make;
+};
+export declare namespace MemoCache {
+    /** Structural shape of a {@link MemoCache} with value type `V`. */
+    type Shape<V> = MemoCacheShape<V>;
+}
+export {};
+//# sourceMappingURL=memo-cache.d.ts.map