css-calipers 0.15.0 → 1.1.0-beta.0

package/dist/esm/core.d.ts

@@ -1,12 +1,30 @@
+import { f, type FloatConstraints, type FloatOptions, hardenFloat, type IFloat, isFloat } from './float';
+import { hardenInteger, i, type IInteger, type IntegerConstraints, type IntegerOptions, isInteger } from './integer';
+import { type ErrorCode, type ErrorConfig } from './internal/errors';
+import { type IRatio, isRatio, normalizeRatio, parseRatio, r, type RatioParts, ratioToFloat, type RatioValue, reduceRatio, simplifyRatio, toFloat } from './ratio';
+import { type Scalar } from './scalar';
 import { type UnitCategory, type UnitDefinition, type UnitDefinitionRecord } from './unitDefinitions';
-import { type ErrorConfig, type ErrorCode } from './internal/errors';
-import { r, isRatio, normalizeRatio, parseRatio, ratioToFloat, toFloat, reduceRatio, simplifyRatio, type IRatio, type RatioParts } from './ratio';
 type UnitSymbol = UnitDefinitionRecord[keyof UnitDefinitionRecord]['unit'];
 export type MeasurementString<Unit extends string = UnitSymbol> = `${number}${Unit}`;
 declare const unitBrand: unique symbol;
 type UnitBrand<Unit extends string> = {
     readonly [unitBrand]: Unit;
 };
+declare const greaterOrEqualToZeroBrand: unique symbol;
+declare const smallerOrEqualToZeroBrand: unique symbol;
+declare const inRangeBrand: unique symbol;
+export type GreaterOrEqualToZeroBrand = {
+    readonly [greaterOrEqualToZeroBrand]: true;
+};
+export type SmallerOrEqualToZeroBrand = {
+    readonly [smallerOrEqualToZeroBrand]: true;
+};
+export type InRangeBrand<Min extends number = number, Max extends number = number> = {
+    readonly [inRangeBrand]: {
+        readonly min: Min;
+        readonly max: Max;
+    };
+};
 export interface IMeasurement<Unit extends string = string> {
     css: () => string;
     toString: () => string;
@@ -23,12 +41,13 @@ export interface IMeasurement<Unit extends string = string> {
     compare(other: IMeasurement<string>, strict: false): number;
     add(delta: number | IMeasurement<Unit>): IMeasurement<Unit>;
     subtract(delta: number | IMeasurement<Unit>): IMeasurement<Unit>;
-    multiply: (factor: number) => IMeasurement<Unit>;
-    divide: (divisor: number) => IMeasurement<Unit>;
+    multiply: (factor: Scalar) => IMeasurement<Unit>;
+    divide: (divisor: Scalar) => IMeasurement<Unit>;
     double: () => IMeasurement<Unit>;
     half: () => IMeasurement<Unit>;
     negation: (shouldNegate?: boolean) => IMeasurement<Unit>;
-    absolute: () => IMeasurement<Unit>;
+    /** Absolute value; always `>= 0`, so the result is hardened to `NonNegativeMeasurement`. */
+    absolute: () => NonNegativeMeasurement<Unit>;
     round: (precision?: number) => IMeasurement<Unit>;
     floor: () => IMeasurement<Unit>;
     ceil: () => IMeasurement<Unit>;
@@ -40,277 +59,64 @@ export type InscribedMeasurement<Unit extends string> = IMeasurement<Unit> & Uni
  * release for backwards compatibility and will be removed in a future version.
  */
 export type BrandedMeasurement<Unit extends string> = InscribedMeasurement<Unit>;
+/**
+ * A measurement proven `>= 0` by the `nonNegative` refinement. `NonNegativeMeasurement`
+ * is the conventional alias for the same constraint. The brand is additive over
+ * `IMeasurement` and is dropped by arithmetic, so a derived result must be re-checked.
+ */
+export type GreaterOrEqualToZeroMeasurement<Unit extends string = string> = IMeasurement<Unit> & GreaterOrEqualToZeroBrand;
+/** Non-negative (`>= 0`); alias of {@link GreaterOrEqualToZeroMeasurement}. */
+export type NonNegativeMeasurement<Unit extends string = string> = GreaterOrEqualToZeroMeasurement<Unit>;
+/**
+ * A measurement proven `<= 0` by the `nonPositive` refinement. `NonPositiveMeasurement`
+ * is the conventional alias for the same constraint. The brand is additive over
+ * `IMeasurement` and is dropped by arithmetic, so a derived result must be re-checked.
+ */
+export type SmallerOrEqualToZeroMeasurement<Unit extends string = string> = IMeasurement<Unit> & SmallerOrEqualToZeroBrand;
+/** Non-positive (`<= 0`); alias of {@link SmallerOrEqualToZeroMeasurement}. */
+export type NonPositiveMeasurement<Unit extends string = string> = SmallerOrEqualToZeroMeasurement<Unit>;
+/**
+ * A measurement proven within an inclusive numeric range by an `inRange(min, max)`
+ * refinement. The brand carries the literal bounds, so `InRangeMeasurement<'px', 0, 10>`
+ * is distinct from `InRangeMeasurement<'px', 0, 5>`. Assignability is by exact bounds, not
+ * range containment (TypeScript cannot compare numeric literals).
+ */
+export type InRangeMeasurement<Unit extends string = string, Min extends number = number, Max extends number = number> = IMeasurement<Unit> & InRangeBrand<Min, Max>;
+/** Result of a non-throwing refinement check (`refinement.check`). */
+export type MeasurementRefinementResult<M extends IMeasurement, B> = {
+    ok: true;
+    value: M & B;
+} | {
+    ok: false;
+    value: M;
+    error: string;
+};
+/**
+ * The quartet a value-constraint refinement exposes, built by
+ * `makeMeasurementRefinement`. `nonNegative` / `nonPositive` / `inRange(...)` are
+ * instances. `B` is the constraint brand the refinement applies.
+ */
+export interface MeasurementRefinement<B> {
+    /** Non-throwing guard; narrows to the brand on success. */
+    is: <M extends IMeasurement>(measurement: M) => measurement is M & B;
+    /** Throws if the constraint fails; otherwise returns the branded measurement. */
+    ensure: <M extends IMeasurement>(measurement: M, context?: string) => M & B;
+    /** Non-throwing; returns an ok/error result. */
+    check: <M extends IMeasurement>(measurement: M) => MeasurementRefinementResult<M, B>;
+    /** Returns the measurement if valid, else the fallback (default: a known-good value). */
+    hardenWith: <M extends IMeasurement>(measurement: M, fallback?: M & B) => M & B;
+}
 export type UnitHelper<Unit extends string = string> = ((value: number, context?: string) => InscribedMeasurement<Unit>) & {
     unit: Unit;
 };
 export type MeasurementOf<T extends UnitHelper> = ReturnType<T>;
 export type UnitGuard<T extends UnitHelper> = (value: unknown) => value is MeasurementOf<T>;
 export type UnitAssertion<T extends UnitHelper> = (value: unknown, context?: string) => asserts value is MeasurementOf<T>;
-export declare const m: {
-    (value: number): InscribedMeasurement<"px">;
-    (value: number, options: {
-        context?: string;
-    }): InscribedMeasurement<"px">;
-    <Unit extends string>(value: number, unit: Unit, context?: string): InscribedMeasurement<Lowercase<Unit>>;
-    <Unit extends string>(value: number, options: {
-        unit?: Unit | undefined;
-        context?: string;
-    }): InscribedMeasurement<Lowercase<Unit>>;
-}, isMeasurement: (x: unknown) => x is IMeasurement<string>, assertMatchingUnits: <Unit extends string>(left: IMeasurement<Unit>, right: IMeasurement<Unit>, context: string) => void, measurementMin: <Unit extends string>(a: IMeasurement<Unit>, b: IMeasurement<NoInfer<Unit>>) => IMeasurement<Unit>, measurementMax: <Unit extends string>(a: IMeasurement<Unit>, b: IMeasurement<NoInfer<Unit>>) => IMeasurement<Unit>, measurementUnitMetadata: {
-    readonly mPercent: {
-        readonly unit: "%";
-        readonly category: "percent";
-    };
-    readonly mPx: {
-        readonly unit: "px";
-        readonly category: "length-absolute";
-    };
-    readonly mCm: {
-        readonly unit: "cm";
-        readonly category: "length-absolute";
-    };
-    readonly mMm: {
-        readonly unit: "mm";
-        readonly category: "length-absolute";
-    };
-    readonly mQ: {
-        readonly unit: "q";
-        readonly category: "length-absolute";
-    };
-    readonly mIn: {
-        readonly unit: "in";
-        readonly category: "length-absolute";
-    };
-    readonly mPc: {
-        readonly unit: "pc";
-        readonly category: "length-absolute";
-    };
-    readonly mPt: {
-        readonly unit: "pt";
-        readonly category: "length-absolute";
-    };
-    readonly mEm: {
-        readonly unit: "em";
-        readonly category: "length-font-relative";
-    };
-    readonly mRem: {
-        readonly unit: "rem";
-        readonly category: "length-font-relative";
-    };
-    readonly mEx: {
-        readonly unit: "ex";
-        readonly category: "length-font-relative";
-    };
-    readonly mRex: {
-        readonly unit: "rex";
-        readonly category: "length-font-relative";
-    };
-    readonly mCh: {
-        readonly unit: "ch";
-        readonly category: "length-font-relative";
-    };
-    readonly mRch: {
-        readonly unit: "rch";
-        readonly category: "length-font-relative";
-    };
-    readonly mCap: {
-        readonly unit: "cap";
-        readonly category: "length-font-relative";
-    };
-    readonly mRcap: {
-        readonly unit: "rcap";
-        readonly category: "length-font-relative";
-    };
-    readonly mIc: {
-        readonly unit: "ic";
-        readonly category: "length-font-relative";
-    };
-    readonly mRic: {
-        readonly unit: "ric";
-        readonly category: "length-font-relative";
-    };
-    readonly mLh: {
-        readonly unit: "lh";
-        readonly category: "length-font-relative";
-    };
-    readonly mRlh: {
-        readonly unit: "rlh";
-        readonly category: "length-font-relative";
-    };
-    readonly mVw: {
-        readonly unit: "vw";
-        readonly category: "length-viewport";
-    };
-    readonly mVh: {
-        readonly unit: "vh";
-        readonly category: "length-viewport";
-    };
-    readonly mVi: {
-        readonly unit: "vi";
-        readonly category: "length-viewport";
-    };
-    readonly mVb: {
-        readonly unit: "vb";
-        readonly category: "length-viewport";
-    };
-    readonly mVmin: {
-        readonly unit: "vmin";
-        readonly category: "length-viewport";
-    };
-    readonly mVmax: {
-        readonly unit: "vmax";
-        readonly category: "length-viewport";
-    };
-    readonly mSvw: {
-        readonly unit: "svw";
-        readonly category: "length-viewport-small";
-    };
-    readonly mSvh: {
-        readonly unit: "svh";
-        readonly category: "length-viewport-small";
-    };
-    readonly mSvi: {
-        readonly unit: "svi";
-        readonly category: "length-viewport-small";
-    };
-    readonly mSvb: {
-        readonly unit: "svb";
-        readonly category: "length-viewport-small";
-    };
-    readonly mSvmin: {
-        readonly unit: "svmin";
-        readonly category: "length-viewport-small";
-    };
-    readonly mSvmax: {
-        readonly unit: "svmax";
-        readonly category: "length-viewport-small";
-    };
-    readonly mLvw: {
-        readonly unit: "lvw";
-        readonly category: "length-viewport-large";
-    };
-    readonly mLvh: {
-        readonly unit: "lvh";
-        readonly category: "length-viewport-large";
-    };
-    readonly mLvi: {
-        readonly unit: "lvi";
-        readonly category: "length-viewport-large";
-    };
-    readonly mLvb: {
-        readonly unit: "lvb";
-        readonly category: "length-viewport-large";
-    };
-    readonly mLvmin: {
-        readonly unit: "lvmin";
-        readonly category: "length-viewport-large";
-    };
-    readonly mLvmax: {
-        readonly unit: "lvmax";
-        readonly category: "length-viewport-large";
-    };
-    readonly mDvw: {
-        readonly unit: "dvw";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mDvh: {
-        readonly unit: "dvh";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mDvi: {
-        readonly unit: "dvi";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mDvb: {
-        readonly unit: "dvb";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mDvmin: {
-        readonly unit: "dvmin";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mDvmax: {
-        readonly unit: "dvmax";
-        readonly category: "length-viewport-dynamic";
-    };
-    readonly mCqw: {
-        readonly unit: "cqw";
-        readonly category: "length-container";
-    };
-    readonly mCqh: {
-        readonly unit: "cqh";
-        readonly category: "length-container";
-    };
-    readonly mCqi: {
-        readonly unit: "cqi";
-        readonly category: "length-container";
-    };
-    readonly mCqb: {
-        readonly unit: "cqb";
-        readonly category: "length-container";
-    };
-    readonly mCqmin: {
-        readonly unit: "cqmin";
-        readonly category: "length-container";
-    };
-    readonly mCqmax: {
-        readonly unit: "cqmax";
-        readonly category: "length-container";
-    };
-    readonly mDeg: {
-        readonly unit: "deg";
-        readonly category: "angle";
-    };
-    readonly mRad: {
-        readonly unit: "rad";
-        readonly category: "angle";
-    };
-    readonly mGrad: {
-        readonly unit: "grad";
-        readonly category: "angle";
-    };
-    readonly mTurn: {
-        readonly unit: "turn";
-        readonly category: "angle";
-    };
-    readonly mS: {
-        readonly unit: "s";
-        readonly category: "time";
-    };
-    readonly mMs: {
-        readonly unit: "ms";
-        readonly category: "time";
-    };
-    readonly mHz: {
-        readonly unit: "hz";
-        readonly category: "frequency";
-    };
-    readonly mKhz: {
-        readonly unit: "khz";
-        readonly category: "frequency";
-    };
-    readonly mDpi: {
-        readonly unit: "dpi";
-        readonly category: "resolution";
-    };
-    readonly mDpcm: {
-        readonly unit: "dpcm";
-        readonly category: "resolution";
-    };
-    readonly mDppx: {
-        readonly unit: "dppx";
-        readonly category: "resolution";
-    };
-    readonly mFr: {
-        readonly unit: "fr";
-        readonly category: "flex";
-    };
-}, makeUnitHelper: <Unit extends string>(unit: Unit) => UnitHelper<Unit>, makeUnitHelperFromDefinition: <Name extends import("./unitDefinitions").UnitHelperName>(name: Name) => UnitHelper<UnitDefinitionRecord[Name]["unit"]>, makeUnitGuard: <T extends UnitHelper>(helper: T) => UnitGuard<T>, makeUnitAssert: <T extends UnitHelper>(helper: T) => UnitAssertion<T>, hasCssMethod: (x: unknown) => x is {
-    css: () => string;
-}, assertUnit: <Unit extends string>(measurement: IMeasurement<Unit>, expectedUnit: string, context?: string) => void, assertCondition: (condition: boolean | (() => boolean), message: string) => void, getErrorConfig: () => Required<ErrorConfig>, setErrorConfig: (next: ErrorConfig) => void;
 export type MeasurementUnitDefinition = UnitDefinition;
 export type MeasurementUnitCategory = UnitCategory;
-export { type ErrorConfig, type ErrorCode };
-export { r, isRatio, normalizeRatio, parseRatio, ratioToFloat, toFloat, reduceRatio, simplifyRatio, };
-export type { IRatio, RatioParts };
+export { type ErrorCode, type ErrorConfig };
+export { isRatio, normalizeRatio, parseRatio, r, ratioToFloat, reduceRatio, simplifyRatio, toFloat, };
+export type { IRatio, RatioParts, RatioValue };
+export { f, hardenFloat, hardenInteger, i, isFloat, isInteger };
+export type { FloatConstraints, FloatOptions, IFloat, IInteger, IntegerConstraints, IntegerOptions, };
 //# sourceMappingURL=core.d.ts.map

package/dist/esm/core.d.ts.map

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

package/dist/esm/core.js

@@ -1,7 +1,5 @@
-import { createCoreApi } from './internal/createCoreApi';
-import { createErrorConfigStore, } from './internal/errors';
-import { r, isRatio, normalizeRatio, parseRatio, ratioToFloat, toFloat, reduceRatio, simplifyRatio, } from './ratio';
-const defaultErrorStore = createErrorConfigStore();
-const coreApi = createCoreApi(defaultErrorStore);
-export const { m, isMeasurement, assertMatchingUnits, measurementMin, measurementMax, measurementUnitMetadata, makeUnitHelper, makeUnitHelperFromDefinition, makeUnitGuard, makeUnitAssert, hasCssMethod, assertUnit, assertCondition, getErrorConfig, setErrorConfig, } = coreApi;
-export { r, isRatio, normalizeRatio, parseRatio, ratioToFloat, toFloat, reduceRatio, simplifyRatio, };
+import { f, hardenFloat, isFloat, } from './float';
+import { hardenInteger, i, isInteger, } from './integer';
+import { isRatio, normalizeRatio, parseRatio, r, ratioToFloat, reduceRatio, simplifyRatio, toFloat, } from './ratio';
+export { isRatio, normalizeRatio, parseRatio, r, ratioToFloat, reduceRatio, simplifyRatio, toFloat, };
+export { f, hardenFloat, hardenInteger, i, isFloat, isInteger };

package/dist/esm/corpus.d.ts

@@ -0,0 +1,26 @@
+import { type ColorFormatPlugin, type CreateColorConfig, type CustomColor } from './color';
+import { type CalipersFactoryConfig, type CalipersInstance, createCalipers } from './factory';
+export * from './index';
+export { createCalipers };
+export type { CalipersFactoryConfig, CalipersInstance };
+/** The calipers master config: one OPTIONAL key per calipers sub-factory. */
+export interface CalipersBundleConfig<P extends ReadonlyArray<ColorFormatPlugin> = readonly []> {
+    /** forwarded to `createCalipers` (the measurement / scalar surface + units). */
+    measurements?: CalipersFactoryConfig;
+    /** forwarded to `createColor` (custom colour format plugins). */
+    color?: CreateColorConfig<P>;
+}
+/** The bound calipers bundle: every helper plus the colour instance, in one object. */
+export type CalipersBundle<P extends ReadonlyArray<ColorFormatPlugin> = readonly []> = CalipersInstance & {
+    color: CustomColor<P>;
+};
+/**
+ * The calipers MASTER factory: combine the two sub-factories (`createCalipers` for the
+ * measurement / scalar surface, `createColor` for the colour value) under one keyed config,
+ * returning every helper bound in one object. Mirrors `publishCompendium`. A bare
+ * `createCalipersBundle()` binds everything at defaults; this file DEFAULT-exports it, and
+ * the named re-exports above are the same helpers already bound at defaults.
+ */
+export declare const createCalipersBundle: <const P extends ReadonlyArray<ColorFormatPlugin> = readonly []>(config?: CalipersBundleConfig<P>) => CalipersBundle<P>;
+export default createCalipersBundle;
+//# sourceMappingURL=corpus.d.ts.map

package/dist/esm/corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/corpus.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,cAAc,EACf,MAAM,WAAW,CAAC;AAEnB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,CAAC;AAExD,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB,CACnC,CAAC,SAAS,aAAa,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAAE;IAExD,gFAAgF;IAChF,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,iEAAiE;IACjE,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED,uFAAuF;AACvF,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,aAAa,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAAE,IACtD,gBAAgB,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAAE,EAE9D,SAAQ,oBAAoB,CAAC,CAAC,CAAM,KACnC,cAAc,CAAC,CAAC,CAQjB,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/esm/corpus.js

@@ -0,0 +1,37 @@
+// CORPUS: the css-calipers LAZY-DEFAULTS convenience entry, plus the master factory.
+//
+// - DEFAULT export: `createCalipersBundle`, the calipers MASTER factory. It mirrors the
+//   compendium's `publishCompendium`: one keyed config (a slot per sub-factory) that binds
+//   the whole calipers surface in one object. A bare `createCalipersBundle()` binds it all
+//   at defaults.
+// - NAMED exports: the full default set (`m` / `r` / `i` / `f` / `color`, each a
+//   factory-at-defaults instance) plus the sub-factories (`createCalipers` / `createColor`),
+//   so a consumer who just wants the defaults never has to bind anything.
+//
+// This is the convenience layer ON TOP of the factory, never a replacement: configuration
+// still goes through a factory. (Per-property value helpers are the books layer now, not
+// calipers.) Unlike `./measurements`, this entry is NOT colour-free: it pulls in the colour
+// value primitive (and `culori`) by design.
+import { createColor, } from './color';
+import { createCalipers, } from './factory';
+export * from './index';
+// `createCalipers` lives on the `./factory` real path and is not re-exported by the root;
+// surface it here so the corpus exposes both sub-factories (`createCalipers` / `createColor`).
+export { createCalipers };
+/**
+ * The calipers MASTER factory: combine the two sub-factories (`createCalipers` for the
+ * measurement / scalar surface, `createColor` for the colour value) under one keyed config,
+ * returning every helper bound in one object. Mirrors `publishCompendium`. A bare
+ * `createCalipersBundle()` binds everything at defaults; this file DEFAULT-exports it, and
+ * the named re-exports above are the same helpers already bound at defaults.
+ */
+export const createCalipersBundle = (config = {}) => {
+    var _a;
+    return ({
+        ...createCalipers(config.measurements),
+        // when no colour config is given, P is the default `readonly []` (no custom formats),
+        // so an empty formats list is the right default; the double cast satisfies the generic.
+        color: createColor((_a = config.color) !== null && _a !== void 0 ? _a : { formats: [] }),
+    });
+};
+export default createCalipersBundle;

package/dist/esm/css-values/cssValues.d.ts

@@ -0,0 +1,60 @@
+import { type CssPropertyKey, type PropertyValueMap } from './propertyMap';
+import { CSS_VALUE_SPEC, type SpecRow } from './spec';
+/**
+ * How an out-of-range (or non-integer) number is handled.
+ *
+ * - `'throw'`: defer to the scalar primitive, which throws on a value outside
+ *   the bound (or a non-integer for an `int` row). This is the default.
+ * - `'clamp'`: clamp the number into `[min, max]` first, then build the
+ *   primitive. Only meaningful when the row has both bounds; with an open bound
+ *   there is nothing to clamp against on that side.
+ */
+export type OutOfRange = 'throw' | 'clamp';
+/** The factory's configuration. `outOfRange` is the instance-wide default. */
+export interface CssValuesConfig {
+    outOfRange?: OutOfRange;
+}
+/** Per-call options; `outOfRange` overrides the instance default for that call. */
+export interface CssValueOptions {
+    outOfRange?: OutOfRange;
+}
+/**
+ * A single typed CSS value. Build it through a property helper (`opacity(0.5)`),
+ * then render with `.css()` (typed against that property's csstype `Property`
+ * key). `.value()` returns the raw `number` (scalar input) or `string`
+ * (keyword input); `.toString()` mirrors `.css()`.
+ */
+export interface CssValue<CssProperty extends CssPropertyKey> {
+    css: () => PropertyValueMap[CssProperty];
+    toString: () => string;
+    value: () => number | string;
+}
+/**
+ * A generated property helper: accepts the property's constrained number or one
+ * of its keywords, and returns a typed {@link CssValue}.
+ */
+export type CssValueHelper<CssProperty extends CssPropertyKey, Keyword extends string> = (value: number | Keyword, opts?: CssValueOptions) => CssValue<CssProperty>;
+/**
+ * The full helper map produced by {@link createCssValues}: one helper per spec
+ * row, keyed by the row's `name`, each carrying that row's `.css()` return type
+ * and keyword union. Derived from the spec tuple so the map stays in lockstep
+ * with the table.
+ */
+export type CssValues = {
+    readonly [Row in CssValueSpecEntry as Row['name']]: Row extends SpecRow<string, infer CssProperty, infer Keyword> ? CssValueHelper<CssProperty, Keyword> : never;
+};
+type CssValueSpecEntry = (typeof CSS_VALUE_SPEC)[number];
+/**
+ * Create a set of per-property CSS-value helpers, layered on the scalar
+ * primitives `i()` / `f()`. Each helper constrains its number against the
+ * property's bound and accepts that property's keyword companions, returning a
+ * `.css()`-renderable {@link CssValue} typed against csstype.
+ *
+ * `config.outOfRange` is the instance-wide default for out-of-range numbers
+ * (`'throw'`, the default, or `'clamp'`); a per-call `opts.outOfRange` overrides
+ * it. The package's bare `opacity` / `zIndex` / ... exports are this factory at
+ * its defaults.
+ */
+export declare const createCssValues: (config?: CssValuesConfig) => CssValues;
+export {};
+//# sourceMappingURL=cssValues.d.ts.map

package/dist/esm/css-values/cssValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssValues.d.ts","sourceRoot":"","sources":["../../../src/css-values/cssValues.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,WAAW,SAAS,cAAc;IAC1D,GAAG,EAAE,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CACxB,WAAW,SAAS,cAAc,EAClC,OAAO,SAAS,MAAM,IACpB,CACF,KAAK,EAAE,MAAM,GAAG,OAAO,EACvB,IAAI,CAAC,EAAE,eAAe,KACnB,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,GAAG,IAAI,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,SAAS,OAAO,CACrE,MAAM,EACN,MAAM,WAAW,EACjB,MAAM,OAAO,CACd,GACG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,GACpC,KAAK;CACV,CAAC;AAEF,KAAK,iBAAiB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AA4EzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAQ,eAAoB,KAC3B,SAUF,CAAC"}

package/dist/esm/css-values/cssValues.js

@@ -0,0 +1,74 @@
+import { f } from '../float';
+import { i } from '../integer';
+import { CSS_VALUE_SPEC } from './spec';
+const clampNumber = (value, min, max) => Math.min(max, Math.max(min, value));
+/**
+ * Build the value object for a number input, constraining it with the row's
+ * primitive (`i()` for `int`, `f()` for `float`). Under `'clamp'`, the number is
+ * first clamped into `[min, max]` (only when both bounds exist); otherwise the
+ * primitive throws on an out-of-range or non-integer value.
+ */
+const buildNumber = (row, value, policy) => {
+    let next = value;
+    if (policy === 'clamp' &&
+        row.min !== undefined &&
+        row.max !== undefined) {
+        next = clampNumber(value, row.min, row.max);
+    }
+    const bounds = { min: row.min, max: row.max, context: row.name };
+    const scalar = row.kind === 'int' ? i(next, bounds) : f(next, bounds);
+    // Every `PropertyValueMap[CssProperty]` value type widens to include
+    // `(string & {})`, so the scalar's `string` render is directly assignable; no
+    // cast is needed (and one would be flagged as redundant).
+    return {
+        css: () => scalar.css(),
+        toString: () => scalar.css(),
+        value: () => scalar.value(),
+    };
+};
+/** Build the value object for a keyword input (passed through untouched). */
+const buildKeyword = (keyword) => ({
+    css: () => keyword,
+    toString: () => keyword,
+    value: () => keyword,
+});
+/**
+ * Generate a single property helper from a spec row. Number inputs are
+ * constrained via the row's scalar primitive; keyword inputs (members of the
+ * row's `keywords`) pass through.
+ */
+const makeHelper = (spec, defaultPolicy) => {
+    const keywords = new Set(spec.keywords);
+    return (value, opts) => {
+        var _a;
+        if (typeof value === 'string') {
+            if (!keywords.has(value)) {
+                throw new Error(`${spec.name}: '${value}' is not a valid keyword` +
+                    ` (expected one of: ${spec.keywords.join(', ') || 'none'})`);
+            }
+            return buildKeyword(value);
+        }
+        const policy = (_a = opts === null || opts === void 0 ? void 0 : opts.outOfRange) !== null && _a !== void 0 ? _a : defaultPolicy;
+        return buildNumber(spec, value, policy);
+    };
+};
+/**
+ * Create a set of per-property CSS-value helpers, layered on the scalar
+ * primitives `i()` / `f()`. Each helper constrains its number against the
+ * property's bound and accepts that property's keyword companions, returning a
+ * `.css()`-renderable {@link CssValue} typed against csstype.
+ *
+ * `config.outOfRange` is the instance-wide default for out-of-range numbers
+ * (`'throw'`, the default, or `'clamp'`); a per-call `opts.outOfRange` overrides
+ * it. The package's bare `opacity` / `zIndex` / ... exports are this factory at
+ * its defaults.
+ */
+export const createCssValues = (config = {}) => {
+    var _a;
+    const defaultPolicy = (_a = config.outOfRange) !== null && _a !== void 0 ? _a : 'throw';
+    const helpers = {};
+    for (const spec of CSS_VALUE_SPEC) {
+        helpers[spec.name] = makeHelper(spec, defaultPolicy);
+    }
+    return helpers;
+};

package/dist/esm/css-values/index.d.ts

@@ -0,0 +1,6 @@
+export { createCssValues, type CssValue, type CssValueHelper, type CssValueOptions, type CssValues, type CssValuesConfig, type OutOfRange, } from './cssValues';
+export { borderImageOutset, borderImageSlice, borderImageWidth, type CounterEntry, counterIncrement, counterReset, counterSet, gridColumnEnd, gridColumnStart, type GridLineInput, gridRowEnd, gridRowStart, maskBorderOutset, maskBorderSlice, maskBorderWidth, type MultiCssValue, type MultiPropertyKey, type MultiPropertyValueMap, type NumberOrLength, scale, span, type SpanInput, strokeDasharray, strokeDashoffset, strokeWidth, tabSize, } from './multi';
+export { type CssPropertyKey, type PropertyValueMap, } from './propertyMap';
+export { CSS_VALUE_SPEC, type CssValueSpec, type SpecRow, } from './spec';
+export declare const animationIterationCount: import("./cssValues").CssValueHelper<"AnimationIterationCount", "infinite">, columnCount: import("./cssValues").CssValueHelper<"ColumnCount", "auto">, fillOpacity: import("./cssValues").CssValueHelper<"FillOpacity", never>, flexGrow: import("./cssValues").CssValueHelper<"FlexGrow", never>, flexShrink: import("./cssValues").CssValueHelper<"FlexShrink", never>, floodOpacity: import("./cssValues").CssValueHelper<"FloodOpacity", never>, fontSizeAdjust: import("./cssValues").CssValueHelper<"FontSizeAdjust", "from-font" | "none">, fontWeight: import("./cssValues").CssValueHelper<"FontWeight", "normal" | "bold" | "bolder" | "lighter">, lineClamp: import("./cssValues").CssValueHelper<"WebkitLineClamp", "none">, lineHeight: import("./cssValues").CssValueHelper<"LineHeight", "normal">, mathDepth: import("./cssValues").CssValueHelper<"MathDepth", "auto-add">, opacity: import("./cssValues").CssValueHelper<"Opacity", never>, order: import("./cssValues").CssValueHelper<"Order", never>, orphans: import("./cssValues").CssValueHelper<"Orphans", never>, shapeImageThreshold: import("./cssValues").CssValueHelper<"ShapeImageThreshold", never>, stopOpacity: import("./cssValues").CssValueHelper<"StopOpacity", never>, strokeMiterlimit: import("./cssValues").CssValueHelper<"StrokeMiterlimit", never>, strokeOpacity: import("./cssValues").CssValueHelper<"StrokeOpacity", never>, widows: import("./cssValues").CssValueHelper<"Widows", never>, zIndex: import("./cssValues").CssValueHelper<"ZIndex", "auto">, zoom: import("./cssValues").CssValueHelper<"Zoom", never>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/css-values/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/css-values/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,YAAY,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,KAAK,aAAa,EAClB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,EACL,IAAI,EACJ,KAAK,SAAS,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,OAAO,GACR,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,OAAO,GACb,MAAM,QAAQ,CAAC;AAKhB,eAAO,MACL,uBAAuB,+EACvB,WAAW,+DACX,WAAW,8DACX,QAAQ,2DACR,UAAU,6DACV,YAAY,+DACZ,cAAc,gFACd,UAAU,gGACV,SAAS,mEACT,UAAU,gEACV,SAAS,iEACT,OAAO,0DACP,KAAK,wDACL,OAAO,0DACP,mBAAmB,sEACnB,WAAW,8DACX,gBAAgB,mEAChB,aAAa,gEACb,MAAM,yDACN,MAAM,0DACN,IAAI,qDACM,CAAC"}