@penner/smart-primitive 0.0.1 → 0.1.0

package/dist/traits.examples.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 🎯 Intersection-Based Traits Examples
+ *
+ * Demonstrates the gradual, composable approach to traits using intersections.
+ */
+export {};
+//# sourceMappingURL=traits.examples.d.ts.map

package/dist/traits.examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.examples.d.ts","sourceRoot":"","sources":["../src/traits.examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/traits.test-d.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Type tests for intersection-based traits system.
+ */
+export {};
+//# sourceMappingURL=traits.test-d.d.ts.map

package/dist/traits.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.test-d.d.ts","sourceRoot":"","sources":["../src/traits.test-d.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/units/angle.d.ts

@@ -0,0 +1,43 @@
+import { WithUnit, WithRange, WithPeriodic, WithKind } from '../trait-utils';
+/**
+ * Angle in degrees [0, 360), periodic.
+ * All angle types share the 'angle' kind.
+ */
+export type Degrees = WithUnit<'deg'> & WithRange<0, 360> & WithPeriodic & WithKind<'angle'>;
+/**
+ * Angle in radians [0, 2π), periodic.
+ * All angle types share the 'angle' kind.
+ */
+export type Radians = WithUnit<'rad'> & WithRange<0, 6.283185307179586> & WithPeriodic & WithKind<'angle'>;
+/**
+ * Angle in turns/rotations [0, 1), periodic.
+ * All angle types share the 'angle' kind.
+ */
+export type Turns = WithUnit<'turn'> & WithRange<0, 1> & WithPeriodic & WithKind<'angle'>;
+/** Degrees → Radians */
+export declare const degreesToRadians: (deg: Degrees) => Radians;
+/** Radians → Degrees */
+export declare const radiansToDegrees: (rad: Radians) => Degrees;
+/** Degrees → Turns */
+export declare const degreesToTurns: (deg: Degrees) => Turns;
+/** Turns → Degrees */
+export declare const turnsToDegrees: (t: Turns) => Degrees;
+/** Radians → Turns */
+export declare const radiansToTurns: (rad: Radians) => Turns;
+/** Turns → Radians */
+export declare const turnsToRadians: (t: Turns) => Radians;
+/**
+ * Normalize an angle in degrees to the range [0, 360).
+ */
+export declare function normalizeDegrees(deg: Degrees): Degrees;
+/**
+ * Normalize an angle in radians to the range [0, 2π).
+ */
+export declare function normalizeRadians(rad: Radians): Radians;
+/**
+ * Normalize an angle in turns to the range [0, 1).
+ */
+export declare function normalizeTurns(t: Turns): Turns;
+/** Any angle unit */
+export type AngleUnit = Degrees | Radians | Turns;
+//# sourceMappingURL=angle.d.ts.map

package/dist/units/angle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angle.d.ts","sourceRoot":"","sources":["../../src/units/angle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAMxB;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GACnC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GACjB,YAAY,GACZ,QAAQ,CAAC,OAAO,CAAC,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GACnC,SAAS,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAC/B,YAAY,GACZ,QAAQ,CAAC,OAAO,CAAC,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAClC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACf,YAAY,GACZ,QAAQ,CAAC,OAAO,CAAC,CAAC;AAmBpB,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,KAAG,OAA4B,CAAC;AAE7E,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,KAAG,OAA4B,CAAC;AAE7E,sBAAsB;AACtB,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,KAAkB,CAAC;AAEjE,sBAAsB;AACtB,eAAO,MAAM,cAAc,GAAI,GAAG,KAAK,KAAG,OAAkB,CAAC;AAE7D,sBAAsB;AACtB,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,KAAG,KAAkB,CAAC;AAEjE,sBAAsB;AACtB,eAAO,MAAM,cAAc,GAAI,GAAG,KAAK,KAAG,OAAkB,CAAC;AAM7D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE9C;AAMD,qBAAqB;AACrB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC"}

package/dist/units/angle.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=angle.test-d.d.ts.map

package/dist/units/angle.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angle.test-d.d.ts","sourceRoot":"","sources":["../../src/units/angle.test-d.ts"],"names":[],"mappings":""}

package/dist/units/color.d.ts

@@ -0,0 +1,35 @@
+import { WithRange, WithClamped, WithKind } from '../trait-utils';
+/**
+ * A color channel value in the range [0, 255].
+ * Used for RGB and alpha channels in byte-based color representations
+ * (Canvas ImageData, PNG/JPEG files, etc.).
+ */
+export type ColorByte = WithRange<0, 255> & WithClamped & WithKind<'color-byte'>;
+/**
+ * RGB color tuple with named elements.
+ * Each component is a byte value [0, 255].
+ *
+ * @example
+ * ```ts
+ * const red: RGBTuple = [255, 0, 0];
+ * const [r, g, b] = red;
+ * ```
+ */
+export type RGBTuple = [r: ColorByte, g: ColorByte, b: ColorByte];
+/**
+ * RGBA color tuple with named elements.
+ * Each component is a byte value [0, 255].
+ *
+ * @example
+ * ```ts
+ * const semiTransparentRed: RGBATuple = [255, 0, 0, 128];
+ * const [r, g, b, a] = semiTransparentRed;
+ * ```
+ */
+export type RGBATuple = [
+    r: ColorByte,
+    g: ColorByte,
+    b: ColorByte,
+    a: ColorByte
+];
+//# sourceMappingURL=color.d.ts.map

package/dist/units/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/units/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAMvE;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GACvC,WAAW,GACX,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEzB;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;CACb,CAAC"}

package/dist/units/color.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=color.test-d.d.ts.map

package/dist/units/color.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.test-d.d.ts","sourceRoot":"","sources":["../../src/units/color.test-d.ts"],"names":[],"mappings":""}

package/dist/units/index.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=e=>e*1e3,t=e=>e/1e3,i=e=>e*60,r=e=>e/60,c=e=>e*60,l=e=>e/60,T=e=>e*100,a=e=>e/100,m=e=>e*10,u=e=>e/10,d=e=>e*2.54,h=e=>e/2.54,p=e=>s=>s/e,P=e=>s=>s*e,g=(e=16)=>s=>s/e,M=(e=16)=>s=>s*e,x=e=>s=>s/e*100,z=e=>s=>s/100*e,f=e=>s=>s/e*100,y=e=>s=>s/100*e,R=e=>e*72,S=e=>e/72,v=e=>e*96,D=e=>e/96,I=180/Math.PI,C=Math.PI/180,o=2*Math.PI,N=e=>e*C,V=e=>e*I,E=e=>e/360,A=e=>e*360,w=e=>e/o,F=e=>e*o;function _(e){return(e%360+360)%360}function b(e){return(e%o+o)%o}function G(e){return(e%1+1)%1}const H=e=>e*100,j=e=>e/100,O=e=>e*100,U=e=>e/100;function k(e){return e!==e||e<=0?0:e>=1?1:e}function q(e){return Math.max(-1,Math.min(1,e))}function B(e){return Math.max(0,Math.min(100,e))}function J(e){return Math.max(0,Math.min(1,e))}const K=e=>e*9/5+32,L=e=>(e-32)*5/9;function Q(e,s){return e/s}function W(e,s){return e*s}function X(e){return e/1e3}function Y(e){return e*1e3}exports.applyVelocity=W;exports.celsiusToFahrenheit=K;exports.centimetersToInches=h;exports.centimetersToMeters=a;exports.centimetersToMillimeters=m;exports.clampAlpha=J;exports.clampNormalized=k;exports.clampPercentage=B;exports.clampSignedNormalized=q;exports.degreesToRadians=N;exports.degreesToTurns=E;exports.emsToPixels=P;exports.fahrenheitToCelsius=L;exports.hoursToMinutes=c;exports.inchesToCentimeters=d;exports.inchesToPixels=v;exports.inchesToPoints=R;exports.metersToCentimeters=T;exports.millimetersToCentimeters=u;exports.millisecondsToSeconds=t;exports.minutesToHours=l;exports.minutesToSeconds=i;exports.normalizeDegrees=_;exports.normalizeRadians=b;exports.normalizeTurns=G;exports.normalizedProgressToPercent=O;exports.normalizedToPercentage=H;exports.percentToNormalizedProgress=U;exports.percentageToNormalized=j;exports.pixelsToEms=p;exports.pixelsToInches=D;exports.pixelsToRems=g;exports.pixelsToVh=f;exports.pixelsToVw=x;exports.pointsToInches=S;exports.radiansToDegrees=V;exports.radiansToTurns=w;exports.remsToPixels=M;exports.secondsToMilliseconds=n;exports.secondsToMinutes=r;exports.turnsToDegrees=A;exports.turnsToRadians=F;exports.velocityFromValues=Q;exports.velocityMillisecondsToSeconds=Y;exports.velocitySecondsToMilliseconds=X;exports.vhToPixels=y;exports.vwToPixels=z;
+//# sourceMappingURL=index.cjs.js.map

package/dist/units/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../../src/units/time.ts","../../src/units/length.ts","../../src/units/angle.ts","../../src/units/normalized.ts","../../src/units/temperature.ts","../../src/units/velocity.ts"],"sourcesContent":["/**\n * ⏱️ Time Units\n *\n * Trait-based types for time-based values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   TIME TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Time in seconds.\n * All time types share the 'time' kind.\n */\nexport type Seconds = WithUnit<'s'> & WithKind<'time'>;\n\n/**\n * Time in milliseconds.\n * All time types share the 'time' kind.\n */\nexport type Milliseconds = WithUnit<'ms'> & WithKind<'time'>;\n\n/**\n * Time in minutes.\n * All time types share the 'time' kind.\n */\nexport type Minutes = WithUnit<'min'> & WithKind<'time'>;\n\n/**\n * Time in hours.\n * All time types share the 'time' kind.\n */\nexport type Hours = WithUnit<'h'> & WithKind<'time'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Seconds → Milliseconds (1s = 1000ms) */\nexport const secondsToMilliseconds = (s: Seconds): Milliseconds =>\n  (s * 1000) as Milliseconds;\n\n/** Milliseconds → Seconds */\nexport const millisecondsToSeconds = (ms: Milliseconds): Seconds =>\n  (ms / 1000) as Seconds;\n\n/** Minutes → Seconds (1min = 60s) */\nexport const minutesToSeconds = (m: Minutes): Seconds => m * 60;\n\n/** Seconds → Minutes */\nexport const secondsToMinutes = (s: Seconds): Minutes => s / 60;\n\n/** Hours → Minutes (1h = 60min) */\nexport const hoursToMinutes = (h: Hours): Minutes => h * 60;\n\n/** Minutes → Hours */\nexport const minutesToHours = (m: Minutes): Hours => m / 60;\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any time unit */\nexport type TimeUnit = Seconds | Milliseconds | Minutes | Hours;\n\n/** Common animation time units (seconds or milliseconds) */\nexport type AnimationTimeUnit = Seconds | Milliseconds;\n","/**\n * 📏 Length Units\n *\n * Trait-based types for length/distance values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   LENGTH TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Length in pixels (CSS px).\n * All length types share the 'length' kind.\n */\nexport type Pixels = WithUnit<'px'> & WithKind<'length'>;\n\n/**\n * Length in em units (relative to font-size).\n * All length types share the 'length' kind.\n */\nexport type Ems = WithUnit<'em'> & WithKind<'length'>;\n\n/**\n * Length in rem units (relative to root font-size).\n * All length types share the 'length' kind.\n */\nexport type Rems = WithUnit<'rem'> & WithKind<'length'>;\n\n/**\n * Length in viewport width units.\n * All length types share the 'length' kind.\n */\nexport type Vw = WithUnit<'vw'> & WithKind<'length'>;\n\n/**\n * Length in viewport height units.\n * All length types share the 'length' kind.\n */\nexport type Vh = WithUnit<'vh'> & WithKind<'length'>;\n\n/**\n * Length in percent.\n * All length types share the 'length' kind.\n */\nexport type Percent = WithUnit<'%'> & WithKind<'length'>;\n\n/**\n * Length in points (1pt = 1/72 inch).\n * All length types share the 'length' kind.\n */\nexport type Points = WithUnit<'pt'> & WithKind<'length'>;\n\n/**\n * Length in inches.\n * All length types share the 'length' kind.\n */\nexport type Inches = WithUnit<'in'> & WithKind<'length'>;\n\n/**\n * Length in centimeters.\n * All length types share the 'length' kind.\n */\nexport type Centimeters = WithUnit<'cm'> & WithKind<'length'>;\n\n/**\n * Length in millimeters.\n * All length types share the 'length' kind.\n */\nexport type Millimeters = WithUnit<'mm'> & WithKind<'length'>;\n\n/**\n * Length in meters.\n * All length types share the 'length' kind.\n */\nexport type Meters = WithUnit<'m'> & WithKind<'length'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - Metric\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Meters → Centimeters (1m = 100cm) */\nexport const metersToCentimeters = (m: Meters): Centimeters => m * 100;\n\n/** Centimeters → Meters */\nexport const centimetersToMeters = (cm: Centimeters): Meters => cm / 100;\n\n/** Centimeters → Millimeters (1cm = 10mm) */\nexport const centimetersToMillimeters = (cm: Centimeters): Millimeters =>\n  cm * 10;\n\n/** Millimeters → Centimeters */\nexport const millimetersToCentimeters = (mm: Millimeters): Centimeters =>\n  mm / 10;\n\n/** Inches → Centimeters (1in = 2.54cm) */\nexport const inchesToCentimeters = (i: Inches): Centimeters => i * 2.54;\n\n/** Centimeters → Inches */\nexport const centimetersToInches = (cm: Centimeters): Inches => cm / 2.54;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - CSS (context-dependent)\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Pixels → Ems for a given font-size */\nexport const pixelsToEms =\n  (fontSize: number) =>\n  (px: Pixels): Ems =>\n    px / fontSize;\n\n/** Ems → Pixels for a given font-size */\nexport const emsToPixels =\n  (fontSize: number) =>\n  (em: Ems): Pixels =>\n    em * fontSize;\n\n/** Pixels → Rems for a given root font-size */\nexport const pixelsToRems =\n  (rootFontSize = 16) =>\n  (px: Pixels): Rems =>\n    px / rootFontSize;\n\n/** Rems → Pixels for a given root font-size */\nexport const remsToPixels =\n  (rootFontSize = 16) =>\n  (rem: Rems): Pixels =>\n    rem * rootFontSize;\n\n/** Pixels → Vw for a given viewport width */\nexport const pixelsToVw =\n  (viewportWidth: number) =>\n  (px: Pixels): Vw =>\n    (px / viewportWidth) * 100;\n\n/** Vw → Pixels for a given viewport width */\nexport const vwToPixels =\n  (viewportWidth: number) =>\n  (vwVal: Vw): Pixels =>\n    (vwVal / 100) * viewportWidth;\n\n/** Pixels → Vh for a given viewport height */\nexport const pixelsToVh =\n  (viewportHeight: number) =>\n  (px: Pixels): Vh =>\n    (px / viewportHeight) * 100;\n\n/** Vh → Pixels for a given viewport height */\nexport const vhToPixels =\n  (viewportHeight: number) =>\n  (vhVal: Vh): Pixels =>\n    (vhVal / 100) * viewportHeight;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - Print\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Inches → Points (1in = 72pt) */\nexport const inchesToPoints = (i: Inches): Points => i * 72;\n\n/** Points → Inches */\nexport const pointsToInches = (pt: Points): Inches => pt / 72;\n\n/** Inches → Pixels at 96 DPI (CSS standard) */\nexport const inchesToPixels = (i: Inches): Pixels => i * 96;\n\n/** Pixels → Inches at 96 DPI (CSS standard) */\nexport const pixelsToInches = (px: Pixels): Inches => px / 96;\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any length unit */\nexport type LengthUnit =\n  | Pixels\n  | Ems\n  | Rems\n  | Vw\n  | Vh\n  | Percent\n  | Points\n  | Inches\n  | Centimeters\n  | Millimeters\n  | Meters;\n\n/** CSS absolute length units */\nexport type CSSAbsoluteLengthUnit =\n  | Pixels\n  | Points\n  | Inches\n  | Centimeters\n  | Millimeters;\n\n/** CSS relative length units */\nexport type CSSRelativeLengthUnit = Ems | Rems | Vw | Vh | Percent;\n\n/** Metric length units */\nexport type MetricLengthUnit = Meters | Centimeters | Millimeters;\n","/**\n * 📐 Angle Units\n *\n * Trait-based types for angular measurements with type-safe conversions.\n */\n\nimport type {\n  WithUnit,\n  WithRange,\n  WithPeriodic,\n  WithKind,\n} from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   ANGLE TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Angle in degrees [0, 360), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Degrees = WithUnit<'deg'> &\n  WithRange<0, 360> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/**\n * Angle in radians [0, 2π), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Radians = WithUnit<'rad'> &\n  WithRange<0, 6.283185307179586> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/**\n * Angle in turns/rotations [0, 1), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Turns = WithUnit<'turn'> &\n  WithRange<0, 1> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONSTANTS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Degrees per radian */\nconst DEG_PER_RAD = 180 / Math.PI;\n\n/** Radians per degree */\nconst RAD_PER_DEG = Math.PI / 180;\n\n/** 2π constant */\nconst TAU = 2 * Math.PI;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Degrees → Radians */\nexport const degreesToRadians = (deg: Degrees): Radians => deg * RAD_PER_DEG;\n\n/** Radians → Degrees */\nexport const radiansToDegrees = (rad: Radians): Degrees => rad * DEG_PER_RAD;\n\n/** Degrees → Turns */\nexport const degreesToTurns = (deg: Degrees): Turns => deg / 360;\n\n/** Turns → Degrees */\nexport const turnsToDegrees = (t: Turns): Degrees => t * 360;\n\n/** Radians → Turns */\nexport const radiansToTurns = (rad: Radians): Turns => rad / TAU;\n\n/** Turns → Radians */\nexport const turnsToRadians = (t: Turns): Radians => t * TAU;\n\n/* ═══════════════════════════════════════════════════════════════\n   ANGLE UTILITIES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Normalize an angle in degrees to the range [0, 360).\n */\nexport function normalizeDegrees(deg: Degrees): Degrees {\n  return ((deg % 360) + 360) % 360;\n}\n\n/**\n * Normalize an angle in radians to the range [0, 2π).\n */\nexport function normalizeRadians(rad: Radians): Radians {\n  return ((rad % TAU) + TAU) % TAU;\n}\n\n/**\n * Normalize an angle in turns to the range [0, 1).\n */\nexport function normalizeTurns(t: Turns): Turns {\n  return ((t % 1) + 1) % 1;\n}\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any angle unit */\nexport type AngleUnit = Degrees | Radians | Turns;\n","/**\n * 📊 Normalized & Percentage Units\n *\n * Trait-based types for normalized values (0-1) and percentages (0-100).\n */\n\nimport type {\n  WithRange,\n  WithUnit,\n  WithKind,\n  WithClamped,\n} from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   NORMALIZED TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * A value normalized to the range [0, 1], unclamped.\n * Can exceed these bounds.\n */\nexport type Normalized = WithRange<0, 1>;\n\n/**\n * A clamped normalized value in the range [0, 1].\n * Constrained to not exceed these bounds.\n */\nexport type ClampedNormalized = Normalized & WithClamped;\n\n/**\n * A value normalized to the range [-1, 1], unclamped.\n * Can exceed these bounds.\n */\nexport type SignedNormalized = WithRange<-1, 1>;\n\n/**\n * A percentage value based on the range [0, 100], unclamped.\n */\nexport type Percentage = WithRange<0, 100> & WithUnit<'percent'>;\n\n/**\n * An alpha/opacity value in the range [0, 1].\n */\nexport type Alpha = WithRange<0, 1> & WithKind<'opacity'>;\n\n/**\n * A ratio value (typically positive).\n */\nexport type Ratio = number;\n\n/**\n * A factor/multiplier value (could be positive or negative).\n */\nexport type Factor = number;\n\n/* ═══════════════════════════════════════════════════════════════\n   ANIMATION-SPECIFIC NORMALIZED TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Normalized time [0, 1] within an animation segment.\n * Used as the input to easing functions (horizontal/time axis).\n * STRICTLY BOUNDED to [0, 1] - cannot overshoot.\n *\n * @example\n * ```ts\n * const joinTime: NormalizedTime = 0.6;\n * const bezierX1: NormalizedTime = 0.42; // Bezier X coordinates use time\n * ```\n */\nexport type NormalizedTime = ClampedNormalized & WithKind<'time'>;\n\n/**\n * Normalized progress [0, 1] of an animation.\n * Used as the output of easing functions (vertical/progress axis).\n * CAN OVERSHOOT [0, 1] during back/elastic effects (e.g., 1.2 or -0.1).\n *\n * The \"normalized\" refers to the scale (0-1 reference), not the bounds.\n *\n * @example\n * ```ts\n * const position: NormalizedProgress = 1.2; // Can overshoot\n * const bezierY1: NormalizedProgress = 1.5; // Bezier Y coordinates use progress\n * const restitution: NormalizedProgress = 0.8; // Ratios also use progress\n * ```\n */\nexport type NormalizedProgress = Normalized & WithKind<'progress'>;\n\n/**\n * Progress expressed as a percentage [0, 100].\n * Used for API parameters and user-facing values.\n *\n * @example\n * ```ts\n * const decay: PercentProgress = 90; // 90% decay\n * const overshoot: PercentProgress = 30; // 30% overshoot\n * ```\n */\nexport type PercentProgress = Percentage & WithKind<'progress'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Normalized → Percentage (0-1 → 0-100) */\nexport const normalizedToPercentage = (n: Normalized): Percentage => n * 100;\n\n/** Percentage → Normalized (0-100 → 0-1) */\nexport const percentageToNormalized = (p: Percentage): Normalized => p / 100;\n\n/** NormalizedProgress → PercentProgress (0-1 → 0-100) */\nexport const normalizedProgressToPercent = (\n  n: NormalizedProgress,\n): PercentProgress => n * 100;\n\n/** PercentProgress → NormalizedProgress (0-100 → 0-1) */\nexport const percentToNormalizedProgress = (\n  p: PercentProgress,\n): NormalizedProgress => p / 100;\n\n/* ═══════════════════════════════════════════════════════════════\n   UTILITY FUNCTIONS\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Clamp a normalized value to [0, 1].\n * NaN is clamped to 0.\n * Preserves branded traits from the input type.\n *\n * @example\n * clampNormalized(0.5)  // 0.5  — in range, unchanged\n * clampNormalized(1.5)  // 1    — above 1\n * clampNormalized(-0.5) // 0    — below 0\n * clampNormalized(NaN)  // 0    — NaN clamped to 0\n *\n * // Branded traits (e.g. from Smart Primitive) are preserved in the output type:\n *\n * // input is NormalizedProgress, different from NormalizedTime\n * const p: NormalizedProgress = 1.2;\n *\n * // output is NormalizedProgress & ClampedNormalized, not just number & ClampedNormalized\n * const clamped = clampNormalized(p);\n */\nexport function clampNormalized<T extends number>(n: T): T & ClampedNormalized {\n  if (n !== n || n <= 0) return 0 as T & ClampedNormalized;\n  if (n >= 1) return 1 as T & ClampedNormalized;\n  return n as T & ClampedNormalized;\n}\n\n/**\n * Clamp a normalized value to [-1, 1].\n */\nexport function clampSignedNormalized(n: SignedNormalized): SignedNormalized {\n  return Math.max(-1, Math.min(1, n));\n}\n\n/**\n * Clamp a percentage value to [0, 100].\n */\nexport function clampPercentage(p: Percentage): Percentage {\n  return Math.max(0, Math.min(100, p));\n}\n\n/**\n * Clamp an alpha value to [0, 1].\n */\nexport function clampAlpha(a: Alpha): Alpha {\n  return Math.max(0, Math.min(1, a));\n}\n","/**\n * 🌡️ Temperature Units\n *\n * Trait-based types for temperature values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   TEMPERATURE TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Temperature in Celsius.\n * All temperature types share the 'temperature' kind.\n */\nexport type Celsius = WithUnit<'celsius'> & WithKind<'temperature'>;\n\n/**\n * Temperature in Fahrenheit.\n * All temperature types share the 'temperature' kind.\n */\nexport type Fahrenheit = WithUnit<'fahrenheit'> & WithKind<'temperature'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Celsius → Fahrenheit */\nexport const celsiusToFahrenheit = (c: Celsius): Fahrenheit => (c * 9) / 5 + 32;\n\n/** Fahrenheit → Celsius */\nexport const fahrenheitToCelsius = (f: Fahrenheit): Celsius =>\n  ((f - 32) * 5) / 9;\n","/**\n * 🚀 Velocity Units\n *\n * Dynamic trait-based types for rates of change (distance/time).\n * Includes a generic Velocity type that computes compound units from component types.\n */\n\nimport type { WithUnit, WithKind, UnitOf, KindOf } from '../trait-utils';\nimport type { Pixels } from './length';\nimport type { Seconds, Milliseconds } from './time';\nimport type { Degrees, Radians, Turns } from './angle';\n\n/* ═══════════════════════════════════════════════════════════════\n   VELOCITY TYPE SYSTEM\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * A velocity type that dynamically combines distance and time types.\n * Extracts units from both types and creates a compound unit.\n *\n * The kind is determined by the distance type's kind:\n * - 'angle' kind → 'angular-velocity'\n * - other kinds → 'velocity'\n *\n * @example\n * ```ts\n * type PixelsPerSecond = Velocity<Pixels, Seconds>;\n * // Result: number & WithUnit<'px/s'> & WithKind<'velocity'>\n *\n * type DegreesPerSecond = Velocity<Degrees, Seconds>;\n * // Result: number & WithUnit<'deg/s'> & WithKind<'angular-velocity'>\n * ```\n */\nexport type Velocity<TDistance, TTime> =\n  WithUnit<`${UnitOf<TDistance>}/${UnitOf<TTime>}`> &\n    (KindOf<TDistance> extends 'angle'\n      ? WithKind<'angular-velocity'>\n      : WithKind<'velocity'>);\n\n/* ═══════════════════════════════════════════════════════════════\n   COMMON VELOCITY TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n// Linear velocity\nexport type PixelsPerSecond = Velocity<Pixels, Seconds>;\nexport type PixelsPerMillisecond = Velocity<Pixels, Milliseconds>;\n\n// Angular velocity\nexport type DegreesPerSecond = Velocity<Degrees, Seconds>;\nexport type DegreesPerMillisecond = Velocity<Degrees, Milliseconds>;\nexport type RadiansPerSecond = Velocity<Radians, Seconds>;\nexport type RadiansPerMillisecond = Velocity<Radians, Milliseconds>;\nexport type TurnsPerSecond = Velocity<Turns, Seconds>;\nexport type TurnsPerMillisecond = Velocity<Turns, Milliseconds>;\n\n// Normalized velocity (for animations/easing)\n// Note: Import is lazy to avoid circular dependency\nimport type { NormalizedProgress, NormalizedTime } from './normalized';\n\n/**\n * Velocity of normalized progress with respect to normalized time.\n * Used for easing function derivatives (dProgress/dTime).\n *\n * @example\n * ```ts\n * const velocity: NormalizedVelocity = 2.5; // Progress changes 2.5 per time unit\n * ```\n */\nexport type NormalizedVelocity = Velocity<NormalizedProgress, NormalizedTime>;\n\n/* ═══════════════════════════════════════════════════════════════\n   VELOCITY OPERATIONS\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Calculate velocity from distance and time values.\n *\n * @example\n * ```ts\n * const distance: Pixels = 100;\n * const time: Seconds = 2;\n * const speed = velocityFromValues(distance, time); // 50 px/s\n * ```\n */\nexport function velocityFromValues<TDistance, TTime>(\n  distance: TDistance,\n  time: TTime,\n): Velocity<TDistance, TTime> {\n  return (distance as any) / (time as any);\n}\n\n/**\n * Apply velocity over time to get distance.\n *\n * @example\n * ```ts\n * const speed: PixelsPerSecond = 100;\n * const time: Seconds = 2;\n * const distance = applyVelocity(speed, time); // 200 Pixels\n * ```\n */\nexport function applyVelocity<TDistance, TTime>(\n  velocity: Velocity<TDistance, TTime>,\n  time: TTime,\n): TDistance {\n  return ((velocity as any) * (time as any)) as TDistance;\n}\n\n/**\n * Convert velocity from per-second to per-millisecond.\n *\n * @example\n * ```ts\n * const pxPerSec: PixelsPerSecond = 1000;\n * const pxPerMs = velocitySecondsToMilliseconds(pxPerSec); // 1 px/ms\n * ```\n */\nexport function velocitySecondsToMilliseconds<TDistance>(\n  velocity: Velocity<TDistance, Seconds>,\n): Velocity<TDistance, Milliseconds> {\n  return ((velocity as any) / 1000) as Velocity<TDistance, Milliseconds>;\n}\n\n/**\n * Convert velocity from per-millisecond to per-second.\n */\nexport function velocityMillisecondsToSeconds<TDistance>(\n  velocity: Velocity<TDistance, Milliseconds>,\n): Velocity<TDistance, Seconds> {\n  return velocity * 1000;\n}\n"],"names":["secondsToMilliseconds","s","millisecondsToSeconds","ms","minutesToSeconds","m","secondsToMinutes","hoursToMinutes","h","minutesToHours","metersToCentimeters","centimetersToMeters","cm","centimetersToMillimeters","millimetersToCentimeters","mm","inchesToCentimeters","i","centimetersToInches","pixelsToEms","fontSize","px","emsToPixels","em","pixelsToRems","rootFontSize","remsToPixels","rem","pixelsToVw","viewportWidth","vwToPixels","vwVal","pixelsToVh","viewportHeight","vhToPixels","vhVal","inchesToPoints","pointsToInches","pt","inchesToPixels","pixelsToInches","DEG_PER_RAD","RAD_PER_DEG","TAU","degreesToRadians","deg","radiansToDegrees","rad","degreesToTurns","turnsToDegrees","t","radiansToTurns","turnsToRadians","normalizeDegrees","normalizeRadians","normalizeTurns","normalizedToPercentage","n","percentageToNormalized","p","normalizedProgressToPercent","percentToNormalizedProgress","clampNormalized","clampSignedNormalized","clampPercentage","clampAlpha","a","celsiusToFahrenheit","c","fahrenheitToCelsius","f","velocityFromValues","distance","time","applyVelocity","velocity","velocitySecondsToMilliseconds","velocityMillisecondsToSeconds"],"mappings":"gFAyCO,MAAMA,EAAyBC,GACnCA,EAAI,IAGMC,EAAyBC,GACnCA,EAAK,IAGKC,EAAoBC,GAAwBA,EAAI,GAGhDC,EAAoBL,GAAwBA,EAAI,GAGhDM,EAAkBC,GAAsBA,EAAI,GAG5CC,EAAkBJ,GAAsBA,EAAI,GCyB5CK,EAAuBL,GAA2BA,EAAI,IAGtDM,EAAuBC,GAA4BA,EAAK,IAGxDC,EAA4BD,GACvCA,EAAK,GAGME,EAA4BC,GACvCA,EAAK,GAGMC,EAAuBC,GAA2BA,EAAI,KAGtDC,EAAuBN,GAA4BA,EAAK,KAOxDO,EACVC,GACAC,GACCA,EAAKD,EAGIE,EACVF,GACAG,GACCA,EAAKH,EAGII,EACX,CAACC,EAAe,KACfJ,GACCA,EAAKI,EAGIC,EACX,CAACD,EAAe,KACfE,GACCA,EAAMF,EAGGG,EACVC,GACAR,GACEA,EAAKQ,EAAiB,IAGdC,EACVD,GACAE,GACEA,EAAQ,IAAOF,EAGPG,EACVC,GACAZ,GACEA,EAAKY,EAAkB,IAGfC,EACVD,GACAE,GACEA,EAAQ,IAAOF,EAOPG,EAAkBnB,GAAsBA,EAAI,GAG5CoB,EAAkBC,GAAuBA,EAAK,GAG9CC,EAAkBtB,GAAsBA,EAAI,GAG5CuB,EAAkBnB,GAAuBA,EAAK,GCvHrDoB,EAAc,IAAM,KAAK,GAGzBC,EAAc,KAAK,GAAK,IAGxBC,EAAM,EAAI,KAAK,GAORC,EAAoBC,GAA0BA,EAAMH,EAGpDI,EAAoBC,GAA0BA,EAAMN,EAGpDO,EAAkBH,GAAwBA,EAAM,IAGhDI,EAAkBC,GAAsBA,EAAI,IAG5CC,EAAkBJ,GAAwBA,EAAMJ,EAGhDS,EAAkBF,GAAsBA,EAAIP,EASlD,SAASU,EAAiBR,EAAuB,CACtD,OAASA,EAAM,IAAO,KAAO,GAC/B,CAKO,SAASS,EAAiBP,EAAuB,CACtD,OAASA,EAAMJ,EAAOA,GAAOA,CAC/B,CAKO,SAASY,EAAeL,EAAiB,CAC9C,OAASA,EAAI,EAAK,GAAK,CACzB,CCGO,MAAMM,EAA0BC,GAA8BA,EAAI,IAG5DC,EAA0BC,GAA8BA,EAAI,IAG5DC,EACXH,GACoBA,EAAI,IAGbI,EACXF,GACuBA,EAAI,IAyBtB,SAASG,EAAkCL,EAA6B,CAC7E,OAAIA,IAAMA,GAAKA,GAAK,EAAU,EAC1BA,GAAK,EAAU,EACZA,CACT,CAKO,SAASM,EAAsBN,EAAuC,CAC3E,OAAO,KAAK,IAAI,GAAI,KAAK,IAAI,EAAGA,CAAC,CAAC,CACpC,CAKO,SAASO,EAAgBL,EAA2B,CACzD,OAAO,KAAK,IAAI,EAAG,KAAK,IAAI,IAAKA,CAAC,CAAC,CACrC,CAKO,SAASM,EAAWC,EAAiB,CAC1C,OAAO,KAAK,IAAI,EAAG,KAAK,IAAI,EAAGA,CAAC,CAAC,CACnC,CC3IO,MAAMC,EAAuBC,GAA4BA,EAAI,EAAK,EAAI,GAGhEC,EAAuBC,IAChCA,EAAI,IAAM,EAAK,ECmDZ,SAASC,EACdC,EACAC,EAC4B,CAC5B,OAAQD,EAAoBC,CAC9B,CAYO,SAASC,EACdC,EACAF,EACW,CACX,OAASE,EAAoBF,CAC/B,CAWO,SAASG,EACdD,EACmC,CACnC,OAASA,EAAmB,GAC9B,CAKO,SAASE,EACdF,EAC8B,CAC9B,OAAOA,EAAW,GACpB"}

package/dist/units/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 📦 Units Index
+ *
+ * Re-exports all unit types, constructors, and converters from category modules.
+ *
+ * @example
+ * ```ts
+ * import { Pixels, Seconds, degrees, degreesToRadians } from '@penner/smart-primitive';
+ * ```
+ */
+export * from './time';
+export * from './length';
+export * from './angle';
+export * from './normalized';
+export * from './temperature';
+export * from './velocity';
+export * from './color';
+export * from './integer';
+//# sourceMappingURL=index.d.ts.map

package/dist/units/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/units/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/units/index.es.js

@@ -0,0 +1,86 @@
+const c = (e) => e * 1e3, i = (e) => e / 1e3, r = (e) => e * 60, l = (e) => e / 60, a = (e) => e * 60, T = (e) => e / 60, u = (e) => e * 100, m = (e) => e / 100, d = (e) => e * 10, h = (e) => e / 10, p = (e) => e * 2.54, M = (e) => e / 2.54, P = (e) => (n) => n / e, f = (e) => (n) => n * e, x = (e = 16) => (n) => n / e, g = (e = 16) => (n) => n * e, z = (e) => (n) => n / e * 100, R = (e) => (n) => n / 100 * e, D = (e) => (n) => n / e * 100, I = (e) => (n) => n / 100 * e, v = (e) => e * 72, y = (e) => e / 72, E = (e) => e * 96, S = (e) => e / 96, s = 180 / Math.PI, t = Math.PI / 180, o = 2 * Math.PI, A = (e) => e * t, C = (e) => e * s, N = (e) => e / 360, V = (e) => e * 360, _ = (e) => e / o, w = (e) => e * o;
+function F(e) {
+  return (e % 360 + 360) % 360;
+}
+function G(e) {
+  return (e % o + o) % o;
+}
+function H(e) {
+  return (e % 1 + 1) % 1;
+}
+const U = (e) => e * 100, b = (e) => e / 100, j = (e) => e * 100, k = (e) => e / 100;
+function q(e) {
+  return e !== e || e <= 0 ? 0 : e >= 1 ? 1 : e;
+}
+function B(e) {
+  return Math.max(-1, Math.min(1, e));
+}
+function J(e) {
+  return Math.max(0, Math.min(100, e));
+}
+function K(e) {
+  return Math.max(0, Math.min(1, e));
+}
+const L = (e) => e * 9 / 5 + 32, O = (e) => (e - 32) * 5 / 9;
+function Q(e, n) {
+  return e / n;
+}
+function W(e, n) {
+  return e * n;
+}
+function X(e) {
+  return e / 1e3;
+}
+function Y(e) {
+  return e * 1e3;
+}
+export {
+  W as applyVelocity,
+  L as celsiusToFahrenheit,
+  M as centimetersToInches,
+  m as centimetersToMeters,
+  d as centimetersToMillimeters,
+  K as clampAlpha,
+  q as clampNormalized,
+  J as clampPercentage,
+  B as clampSignedNormalized,
+  A as degreesToRadians,
+  N as degreesToTurns,
+  f as emsToPixels,
+  O as fahrenheitToCelsius,
+  a as hoursToMinutes,
+  p as inchesToCentimeters,
+  E as inchesToPixels,
+  v as inchesToPoints,
+  u as metersToCentimeters,
+  h as millimetersToCentimeters,
+  i as millisecondsToSeconds,
+  T as minutesToHours,
+  r as minutesToSeconds,
+  F as normalizeDegrees,
+  G as normalizeRadians,
+  H as normalizeTurns,
+  j as normalizedProgressToPercent,
+  U as normalizedToPercentage,
+  k as percentToNormalizedProgress,
+  b as percentageToNormalized,
+  P as pixelsToEms,
+  S as pixelsToInches,
+  x as pixelsToRems,
+  D as pixelsToVh,
+  z as pixelsToVw,
+  y as pointsToInches,
+  C as radiansToDegrees,
+  _ as radiansToTurns,
+  g as remsToPixels,
+  c as secondsToMilliseconds,
+  l as secondsToMinutes,
+  V as turnsToDegrees,
+  w as turnsToRadians,
+  Q as velocityFromValues,
+  Y as velocityMillisecondsToSeconds,
+  X as velocitySecondsToMilliseconds,
+  I as vhToPixels,
+  R as vwToPixels
+};
+//# sourceMappingURL=index.es.js.map

package/dist/units/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../../src/units/time.ts","../../src/units/length.ts","../../src/units/angle.ts","../../src/units/normalized.ts","../../src/units/temperature.ts","../../src/units/velocity.ts"],"sourcesContent":["/**\n * ⏱️ Time Units\n *\n * Trait-based types for time-based values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   TIME TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Time in seconds.\n * All time types share the 'time' kind.\n */\nexport type Seconds = WithUnit<'s'> & WithKind<'time'>;\n\n/**\n * Time in milliseconds.\n * All time types share the 'time' kind.\n */\nexport type Milliseconds = WithUnit<'ms'> & WithKind<'time'>;\n\n/**\n * Time in minutes.\n * All time types share the 'time' kind.\n */\nexport type Minutes = WithUnit<'min'> & WithKind<'time'>;\n\n/**\n * Time in hours.\n * All time types share the 'time' kind.\n */\nexport type Hours = WithUnit<'h'> & WithKind<'time'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Seconds → Milliseconds (1s = 1000ms) */\nexport const secondsToMilliseconds = (s: Seconds): Milliseconds =>\n  (s * 1000) as Milliseconds;\n\n/** Milliseconds → Seconds */\nexport const millisecondsToSeconds = (ms: Milliseconds): Seconds =>\n  (ms / 1000) as Seconds;\n\n/** Minutes → Seconds (1min = 60s) */\nexport const minutesToSeconds = (m: Minutes): Seconds => m * 60;\n\n/** Seconds → Minutes */\nexport const secondsToMinutes = (s: Seconds): Minutes => s / 60;\n\n/** Hours → Minutes (1h = 60min) */\nexport const hoursToMinutes = (h: Hours): Minutes => h * 60;\n\n/** Minutes → Hours */\nexport const minutesToHours = (m: Minutes): Hours => m / 60;\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any time unit */\nexport type TimeUnit = Seconds | Milliseconds | Minutes | Hours;\n\n/** Common animation time units (seconds or milliseconds) */\nexport type AnimationTimeUnit = Seconds | Milliseconds;\n","/**\n * 📏 Length Units\n *\n * Trait-based types for length/distance values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   LENGTH TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Length in pixels (CSS px).\n * All length types share the 'length' kind.\n */\nexport type Pixels = WithUnit<'px'> & WithKind<'length'>;\n\n/**\n * Length in em units (relative to font-size).\n * All length types share the 'length' kind.\n */\nexport type Ems = WithUnit<'em'> & WithKind<'length'>;\n\n/**\n * Length in rem units (relative to root font-size).\n * All length types share the 'length' kind.\n */\nexport type Rems = WithUnit<'rem'> & WithKind<'length'>;\n\n/**\n * Length in viewport width units.\n * All length types share the 'length' kind.\n */\nexport type Vw = WithUnit<'vw'> & WithKind<'length'>;\n\n/**\n * Length in viewport height units.\n * All length types share the 'length' kind.\n */\nexport type Vh = WithUnit<'vh'> & WithKind<'length'>;\n\n/**\n * Length in percent.\n * All length types share the 'length' kind.\n */\nexport type Percent = WithUnit<'%'> & WithKind<'length'>;\n\n/**\n * Length in points (1pt = 1/72 inch).\n * All length types share the 'length' kind.\n */\nexport type Points = WithUnit<'pt'> & WithKind<'length'>;\n\n/**\n * Length in inches.\n * All length types share the 'length' kind.\n */\nexport type Inches = WithUnit<'in'> & WithKind<'length'>;\n\n/**\n * Length in centimeters.\n * All length types share the 'length' kind.\n */\nexport type Centimeters = WithUnit<'cm'> & WithKind<'length'>;\n\n/**\n * Length in millimeters.\n * All length types share the 'length' kind.\n */\nexport type Millimeters = WithUnit<'mm'> & WithKind<'length'>;\n\n/**\n * Length in meters.\n * All length types share the 'length' kind.\n */\nexport type Meters = WithUnit<'m'> & WithKind<'length'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - Metric\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Meters → Centimeters (1m = 100cm) */\nexport const metersToCentimeters = (m: Meters): Centimeters => m * 100;\n\n/** Centimeters → Meters */\nexport const centimetersToMeters = (cm: Centimeters): Meters => cm / 100;\n\n/** Centimeters → Millimeters (1cm = 10mm) */\nexport const centimetersToMillimeters = (cm: Centimeters): Millimeters =>\n  cm * 10;\n\n/** Millimeters → Centimeters */\nexport const millimetersToCentimeters = (mm: Millimeters): Centimeters =>\n  mm / 10;\n\n/** Inches → Centimeters (1in = 2.54cm) */\nexport const inchesToCentimeters = (i: Inches): Centimeters => i * 2.54;\n\n/** Centimeters → Inches */\nexport const centimetersToInches = (cm: Centimeters): Inches => cm / 2.54;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - CSS (context-dependent)\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Pixels → Ems for a given font-size */\nexport const pixelsToEms =\n  (fontSize: number) =>\n  (px: Pixels): Ems =>\n    px / fontSize;\n\n/** Ems → Pixels for a given font-size */\nexport const emsToPixels =\n  (fontSize: number) =>\n  (em: Ems): Pixels =>\n    em * fontSize;\n\n/** Pixels → Rems for a given root font-size */\nexport const pixelsToRems =\n  (rootFontSize = 16) =>\n  (px: Pixels): Rems =>\n    px / rootFontSize;\n\n/** Rems → Pixels for a given root font-size */\nexport const remsToPixels =\n  (rootFontSize = 16) =>\n  (rem: Rems): Pixels =>\n    rem * rootFontSize;\n\n/** Pixels → Vw for a given viewport width */\nexport const pixelsToVw =\n  (viewportWidth: number) =>\n  (px: Pixels): Vw =>\n    (px / viewportWidth) * 100;\n\n/** Vw → Pixels for a given viewport width */\nexport const vwToPixels =\n  (viewportWidth: number) =>\n  (vwVal: Vw): Pixels =>\n    (vwVal / 100) * viewportWidth;\n\n/** Pixels → Vh for a given viewport height */\nexport const pixelsToVh =\n  (viewportHeight: number) =>\n  (px: Pixels): Vh =>\n    (px / viewportHeight) * 100;\n\n/** Vh → Pixels for a given viewport height */\nexport const vhToPixels =\n  (viewportHeight: number) =>\n  (vhVal: Vh): Pixels =>\n    (vhVal / 100) * viewportHeight;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS - Print\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Inches → Points (1in = 72pt) */\nexport const inchesToPoints = (i: Inches): Points => i * 72;\n\n/** Points → Inches */\nexport const pointsToInches = (pt: Points): Inches => pt / 72;\n\n/** Inches → Pixels at 96 DPI (CSS standard) */\nexport const inchesToPixels = (i: Inches): Pixels => i * 96;\n\n/** Pixels → Inches at 96 DPI (CSS standard) */\nexport const pixelsToInches = (px: Pixels): Inches => px / 96;\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any length unit */\nexport type LengthUnit =\n  | Pixels\n  | Ems\n  | Rems\n  | Vw\n  | Vh\n  | Percent\n  | Points\n  | Inches\n  | Centimeters\n  | Millimeters\n  | Meters;\n\n/** CSS absolute length units */\nexport type CSSAbsoluteLengthUnit =\n  | Pixels\n  | Points\n  | Inches\n  | Centimeters\n  | Millimeters;\n\n/** CSS relative length units */\nexport type CSSRelativeLengthUnit = Ems | Rems | Vw | Vh | Percent;\n\n/** Metric length units */\nexport type MetricLengthUnit = Meters | Centimeters | Millimeters;\n","/**\n * 📐 Angle Units\n *\n * Trait-based types for angular measurements with type-safe conversions.\n */\n\nimport type {\n  WithUnit,\n  WithRange,\n  WithPeriodic,\n  WithKind,\n} from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   ANGLE TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Angle in degrees [0, 360), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Degrees = WithUnit<'deg'> &\n  WithRange<0, 360> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/**\n * Angle in radians [0, 2π), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Radians = WithUnit<'rad'> &\n  WithRange<0, 6.283185307179586> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/**\n * Angle in turns/rotations [0, 1), periodic.\n * All angle types share the 'angle' kind.\n */\nexport type Turns = WithUnit<'turn'> &\n  WithRange<0, 1> &\n  WithPeriodic &\n  WithKind<'angle'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONSTANTS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Degrees per radian */\nconst DEG_PER_RAD = 180 / Math.PI;\n\n/** Radians per degree */\nconst RAD_PER_DEG = Math.PI / 180;\n\n/** 2π constant */\nconst TAU = 2 * Math.PI;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Degrees → Radians */\nexport const degreesToRadians = (deg: Degrees): Radians => deg * RAD_PER_DEG;\n\n/** Radians → Degrees */\nexport const radiansToDegrees = (rad: Radians): Degrees => rad * DEG_PER_RAD;\n\n/** Degrees → Turns */\nexport const degreesToTurns = (deg: Degrees): Turns => deg / 360;\n\n/** Turns → Degrees */\nexport const turnsToDegrees = (t: Turns): Degrees => t * 360;\n\n/** Radians → Turns */\nexport const radiansToTurns = (rad: Radians): Turns => rad / TAU;\n\n/** Turns → Radians */\nexport const turnsToRadians = (t: Turns): Radians => t * TAU;\n\n/* ═══════════════════════════════════════════════════════════════\n   ANGLE UTILITIES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Normalize an angle in degrees to the range [0, 360).\n */\nexport function normalizeDegrees(deg: Degrees): Degrees {\n  return ((deg % 360) + 360) % 360;\n}\n\n/**\n * Normalize an angle in radians to the range [0, 2π).\n */\nexport function normalizeRadians(rad: Radians): Radians {\n  return ((rad % TAU) + TAU) % TAU;\n}\n\n/**\n * Normalize an angle in turns to the range [0, 1).\n */\nexport function normalizeTurns(t: Turns): Turns {\n  return ((t % 1) + 1) % 1;\n}\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE FAMILIES: Useful unions for function parameters\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Any angle unit */\nexport type AngleUnit = Degrees | Radians | Turns;\n","/**\n * 📊 Normalized & Percentage Units\n *\n * Trait-based types for normalized values (0-1) and percentages (0-100).\n */\n\nimport type {\n  WithRange,\n  WithUnit,\n  WithKind,\n  WithClamped,\n} from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   NORMALIZED TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * A value normalized to the range [0, 1], unclamped.\n * Can exceed these bounds.\n */\nexport type Normalized = WithRange<0, 1>;\n\n/**\n * A clamped normalized value in the range [0, 1].\n * Constrained to not exceed these bounds.\n */\nexport type ClampedNormalized = Normalized & WithClamped;\n\n/**\n * A value normalized to the range [-1, 1], unclamped.\n * Can exceed these bounds.\n */\nexport type SignedNormalized = WithRange<-1, 1>;\n\n/**\n * A percentage value based on the range [0, 100], unclamped.\n */\nexport type Percentage = WithRange<0, 100> & WithUnit<'percent'>;\n\n/**\n * An alpha/opacity value in the range [0, 1].\n */\nexport type Alpha = WithRange<0, 1> & WithKind<'opacity'>;\n\n/**\n * A ratio value (typically positive).\n */\nexport type Ratio = number;\n\n/**\n * A factor/multiplier value (could be positive or negative).\n */\nexport type Factor = number;\n\n/* ═══════════════════════════════════════════════════════════════\n   ANIMATION-SPECIFIC NORMALIZED TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Normalized time [0, 1] within an animation segment.\n * Used as the input to easing functions (horizontal/time axis).\n * STRICTLY BOUNDED to [0, 1] - cannot overshoot.\n *\n * @example\n * ```ts\n * const joinTime: NormalizedTime = 0.6;\n * const bezierX1: NormalizedTime = 0.42; // Bezier X coordinates use time\n * ```\n */\nexport type NormalizedTime = ClampedNormalized & WithKind<'time'>;\n\n/**\n * Normalized progress [0, 1] of an animation.\n * Used as the output of easing functions (vertical/progress axis).\n * CAN OVERSHOOT [0, 1] during back/elastic effects (e.g., 1.2 or -0.1).\n *\n * The \"normalized\" refers to the scale (0-1 reference), not the bounds.\n *\n * @example\n * ```ts\n * const position: NormalizedProgress = 1.2; // Can overshoot\n * const bezierY1: NormalizedProgress = 1.5; // Bezier Y coordinates use progress\n * const restitution: NormalizedProgress = 0.8; // Ratios also use progress\n * ```\n */\nexport type NormalizedProgress = Normalized & WithKind<'progress'>;\n\n/**\n * Progress expressed as a percentage [0, 100].\n * Used for API parameters and user-facing values.\n *\n * @example\n * ```ts\n * const decay: PercentProgress = 90; // 90% decay\n * const overshoot: PercentProgress = 30; // 30% overshoot\n * ```\n */\nexport type PercentProgress = Percentage & WithKind<'progress'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Normalized → Percentage (0-1 → 0-100) */\nexport const normalizedToPercentage = (n: Normalized): Percentage => n * 100;\n\n/** Percentage → Normalized (0-100 → 0-1) */\nexport const percentageToNormalized = (p: Percentage): Normalized => p / 100;\n\n/** NormalizedProgress → PercentProgress (0-1 → 0-100) */\nexport const normalizedProgressToPercent = (\n  n: NormalizedProgress,\n): PercentProgress => n * 100;\n\n/** PercentProgress → NormalizedProgress (0-100 → 0-1) */\nexport const percentToNormalizedProgress = (\n  p: PercentProgress,\n): NormalizedProgress => p / 100;\n\n/* ═══════════════════════════════════════════════════════════════\n   UTILITY FUNCTIONS\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Clamp a normalized value to [0, 1].\n * NaN is clamped to 0.\n * Preserves branded traits from the input type.\n *\n * @example\n * clampNormalized(0.5)  // 0.5  — in range, unchanged\n * clampNormalized(1.5)  // 1    — above 1\n * clampNormalized(-0.5) // 0    — below 0\n * clampNormalized(NaN)  // 0    — NaN clamped to 0\n *\n * // Branded traits (e.g. from Smart Primitive) are preserved in the output type:\n *\n * // input is NormalizedProgress, different from NormalizedTime\n * const p: NormalizedProgress = 1.2;\n *\n * // output is NormalizedProgress & ClampedNormalized, not just number & ClampedNormalized\n * const clamped = clampNormalized(p);\n */\nexport function clampNormalized<T extends number>(n: T): T & ClampedNormalized {\n  if (n !== n || n <= 0) return 0 as T & ClampedNormalized;\n  if (n >= 1) return 1 as T & ClampedNormalized;\n  return n as T & ClampedNormalized;\n}\n\n/**\n * Clamp a normalized value to [-1, 1].\n */\nexport function clampSignedNormalized(n: SignedNormalized): SignedNormalized {\n  return Math.max(-1, Math.min(1, n));\n}\n\n/**\n * Clamp a percentage value to [0, 100].\n */\nexport function clampPercentage(p: Percentage): Percentage {\n  return Math.max(0, Math.min(100, p));\n}\n\n/**\n * Clamp an alpha value to [0, 1].\n */\nexport function clampAlpha(a: Alpha): Alpha {\n  return Math.max(0, Math.min(1, a));\n}\n","/**\n * 🌡️ Temperature Units\n *\n * Trait-based types for temperature values with type-safe conversions.\n */\n\nimport type { WithUnit, WithKind } from '../trait-utils';\n\n/* ═══════════════════════════════════════════════════════════════\n   TEMPERATURE TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Temperature in Celsius.\n * All temperature types share the 'temperature' kind.\n */\nexport type Celsius = WithUnit<'celsius'> & WithKind<'temperature'>;\n\n/**\n * Temperature in Fahrenheit.\n * All temperature types share the 'temperature' kind.\n */\nexport type Fahrenheit = WithUnit<'fahrenheit'> & WithKind<'temperature'>;\n\n/* ═══════════════════════════════════════════════════════════════\n   CONVERTERS\n   ═══════════════════════════════════════════════════════════════ */\n\n/** Celsius → Fahrenheit */\nexport const celsiusToFahrenheit = (c: Celsius): Fahrenheit => (c * 9) / 5 + 32;\n\n/** Fahrenheit → Celsius */\nexport const fahrenheitToCelsius = (f: Fahrenheit): Celsius =>\n  ((f - 32) * 5) / 9;\n","/**\n * 🚀 Velocity Units\n *\n * Dynamic trait-based types for rates of change (distance/time).\n * Includes a generic Velocity type that computes compound units from component types.\n */\n\nimport type { WithUnit, WithKind, UnitOf, KindOf } from '../trait-utils';\nimport type { Pixels } from './length';\nimport type { Seconds, Milliseconds } from './time';\nimport type { Degrees, Radians, Turns } from './angle';\n\n/* ═══════════════════════════════════════════════════════════════\n   VELOCITY TYPE SYSTEM\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * A velocity type that dynamically combines distance and time types.\n * Extracts units from both types and creates a compound unit.\n *\n * The kind is determined by the distance type's kind:\n * - 'angle' kind → 'angular-velocity'\n * - other kinds → 'velocity'\n *\n * @example\n * ```ts\n * type PixelsPerSecond = Velocity<Pixels, Seconds>;\n * // Result: number & WithUnit<'px/s'> & WithKind<'velocity'>\n *\n * type DegreesPerSecond = Velocity<Degrees, Seconds>;\n * // Result: number & WithUnit<'deg/s'> & WithKind<'angular-velocity'>\n * ```\n */\nexport type Velocity<TDistance, TTime> =\n  WithUnit<`${UnitOf<TDistance>}/${UnitOf<TTime>}`> &\n    (KindOf<TDistance> extends 'angle'\n      ? WithKind<'angular-velocity'>\n      : WithKind<'velocity'>);\n\n/* ═══════════════════════════════════════════════════════════════\n   COMMON VELOCITY TYPES\n   ═══════════════════════════════════════════════════════════════ */\n\n// Linear velocity\nexport type PixelsPerSecond = Velocity<Pixels, Seconds>;\nexport type PixelsPerMillisecond = Velocity<Pixels, Milliseconds>;\n\n// Angular velocity\nexport type DegreesPerSecond = Velocity<Degrees, Seconds>;\nexport type DegreesPerMillisecond = Velocity<Degrees, Milliseconds>;\nexport type RadiansPerSecond = Velocity<Radians, Seconds>;\nexport type RadiansPerMillisecond = Velocity<Radians, Milliseconds>;\nexport type TurnsPerSecond = Velocity<Turns, Seconds>;\nexport type TurnsPerMillisecond = Velocity<Turns, Milliseconds>;\n\n// Normalized velocity (for animations/easing)\n// Note: Import is lazy to avoid circular dependency\nimport type { NormalizedProgress, NormalizedTime } from './normalized';\n\n/**\n * Velocity of normalized progress with respect to normalized time.\n * Used for easing function derivatives (dProgress/dTime).\n *\n * @example\n * ```ts\n * const velocity: NormalizedVelocity = 2.5; // Progress changes 2.5 per time unit\n * ```\n */\nexport type NormalizedVelocity = Velocity<NormalizedProgress, NormalizedTime>;\n\n/* ═══════════════════════════════════════════════════════════════\n   VELOCITY OPERATIONS\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Calculate velocity from distance and time values.\n *\n * @example\n * ```ts\n * const distance: Pixels = 100;\n * const time: Seconds = 2;\n * const speed = velocityFromValues(distance, time); // 50 px/s\n * ```\n */\nexport function velocityFromValues<TDistance, TTime>(\n  distance: TDistance,\n  time: TTime,\n): Velocity<TDistance, TTime> {\n  return (distance as any) / (time as any);\n}\n\n/**\n * Apply velocity over time to get distance.\n *\n * @example\n * ```ts\n * const speed: PixelsPerSecond = 100;\n * const time: Seconds = 2;\n * const distance = applyVelocity(speed, time); // 200 Pixels\n * ```\n */\nexport function applyVelocity<TDistance, TTime>(\n  velocity: Velocity<TDistance, TTime>,\n  time: TTime,\n): TDistance {\n  return ((velocity as any) * (time as any)) as TDistance;\n}\n\n/**\n * Convert velocity from per-second to per-millisecond.\n *\n * @example\n * ```ts\n * const pxPerSec: PixelsPerSecond = 1000;\n * const pxPerMs = velocitySecondsToMilliseconds(pxPerSec); // 1 px/ms\n * ```\n */\nexport function velocitySecondsToMilliseconds<TDistance>(\n  velocity: Velocity<TDistance, Seconds>,\n): Velocity<TDistance, Milliseconds> {\n  return ((velocity as any) / 1000) as Velocity<TDistance, Milliseconds>;\n}\n\n/**\n * Convert velocity from per-millisecond to per-second.\n */\nexport function velocityMillisecondsToSeconds<TDistance>(\n  velocity: Velocity<TDistance, Milliseconds>,\n): Velocity<TDistance, Seconds> {\n  return velocity * 1000;\n}\n"],"names":["secondsToMilliseconds","s","millisecondsToSeconds","ms","minutesToSeconds","m","secondsToMinutes","hoursToMinutes","h","minutesToHours","metersToCentimeters","centimetersToMeters","cm","centimetersToMillimeters","millimetersToCentimeters","mm","inchesToCentimeters","i","centimetersToInches","pixelsToEms","fontSize","px","emsToPixels","em","pixelsToRems","rootFontSize","remsToPixels","rem","pixelsToVw","viewportWidth","vwToPixels","vwVal","pixelsToVh","viewportHeight","vhToPixels","vhVal","inchesToPoints","pointsToInches","pt","inchesToPixels","pixelsToInches","DEG_PER_RAD","RAD_PER_DEG","TAU","degreesToRadians","deg","radiansToDegrees","rad","degreesToTurns","turnsToDegrees","t","radiansToTurns","turnsToRadians","normalizeDegrees","normalizeRadians","normalizeTurns","normalizedToPercentage","n","percentageToNormalized","p","normalizedProgressToPercent","percentToNormalizedProgress","clampNormalized","clampSignedNormalized","clampPercentage","clampAlpha","a","celsiusToFahrenheit","c","fahrenheitToCelsius","f","velocityFromValues","distance","time","applyVelocity","velocity","velocitySecondsToMilliseconds","velocityMillisecondsToSeconds"],"mappings":"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"}

package/dist/units/integer.d.ts

@@ -0,0 +1,12 @@
+import { WithInteger, WithKind } from '../trait-utils';
+/**
+ * A non-negative integer used as a zero-based index into a collection.
+ *
+ * @example
+ * ```ts
+ * const extremumIndex: Index = 0;
+ * const items = extrema[extremumIndex];
+ * ```
+ */
+export type Index = WithInteger & WithKind<'index'>;
+//# sourceMappingURL=integer.d.ts.map

package/dist/units/integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.d.ts","sourceRoot":"","sources":["../../src/units/integer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC"}

package/dist/units/integer.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integer.test-d.d.ts.map

package/dist/units/integer.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.test-d.d.ts","sourceRoot":"","sources":["../../src/units/integer.test-d.ts"],"names":[],"mappings":""}

package/dist/units/length.d.ts

@@ -0,0 +1,101 @@
+import { WithUnit, WithKind } from '../trait-utils';
+/**
+ * Length in pixels (CSS px).
+ * All length types share the 'length' kind.
+ */
+export type Pixels = WithUnit<'px'> & WithKind<'length'>;
+/**
+ * Length in em units (relative to font-size).
+ * All length types share the 'length' kind.
+ */
+export type Ems = WithUnit<'em'> & WithKind<'length'>;
+/**
+ * Length in rem units (relative to root font-size).
+ * All length types share the 'length' kind.
+ */
+export type Rems = WithUnit<'rem'> & WithKind<'length'>;
+/**
+ * Length in viewport width units.
+ * All length types share the 'length' kind.
+ */
+export type Vw = WithUnit<'vw'> & WithKind<'length'>;
+/**
+ * Length in viewport height units.
+ * All length types share the 'length' kind.
+ */
+export type Vh = WithUnit<'vh'> & WithKind<'length'>;
+/**
+ * Length in percent.
+ * All length types share the 'length' kind.
+ */
+export type Percent = WithUnit<'%'> & WithKind<'length'>;
+/**
+ * Length in points (1pt = 1/72 inch).
+ * All length types share the 'length' kind.
+ */
+export type Points = WithUnit<'pt'> & WithKind<'length'>;
+/**
+ * Length in inches.
+ * All length types share the 'length' kind.
+ */
+export type Inches = WithUnit<'in'> & WithKind<'length'>;
+/**
+ * Length in centimeters.
+ * All length types share the 'length' kind.
+ */
+export type Centimeters = WithUnit<'cm'> & WithKind<'length'>;
+/**
+ * Length in millimeters.
+ * All length types share the 'length' kind.
+ */
+export type Millimeters = WithUnit<'mm'> & WithKind<'length'>;
+/**
+ * Length in meters.
+ * All length types share the 'length' kind.
+ */
+export type Meters = WithUnit<'m'> & WithKind<'length'>;
+/** Meters → Centimeters (1m = 100cm) */
+export declare const metersToCentimeters: (m: Meters) => Centimeters;
+/** Centimeters → Meters */
+export declare const centimetersToMeters: (cm: Centimeters) => Meters;
+/** Centimeters → Millimeters (1cm = 10mm) */
+export declare const centimetersToMillimeters: (cm: Centimeters) => Millimeters;
+/** Millimeters → Centimeters */
+export declare const millimetersToCentimeters: (mm: Millimeters) => Centimeters;
+/** Inches → Centimeters (1in = 2.54cm) */
+export declare const inchesToCentimeters: (i: Inches) => Centimeters;
+/** Centimeters → Inches */
+export declare const centimetersToInches: (cm: Centimeters) => Inches;
+/** Pixels → Ems for a given font-size */
+export declare const pixelsToEms: (fontSize: number) => (px: Pixels) => Ems;
+/** Ems → Pixels for a given font-size */
+export declare const emsToPixels: (fontSize: number) => (em: Ems) => Pixels;
+/** Pixels → Rems for a given root font-size */
+export declare const pixelsToRems: (rootFontSize?: number) => (px: Pixels) => Rems;
+/** Rems → Pixels for a given root font-size */
+export declare const remsToPixels: (rootFontSize?: number) => (rem: Rems) => Pixels;
+/** Pixels → Vw for a given viewport width */
+export declare const pixelsToVw: (viewportWidth: number) => (px: Pixels) => Vw;
+/** Vw → Pixels for a given viewport width */
+export declare const vwToPixels: (viewportWidth: number) => (vwVal: Vw) => Pixels;
+/** Pixels → Vh for a given viewport height */
+export declare const pixelsToVh: (viewportHeight: number) => (px: Pixels) => Vh;
+/** Vh → Pixels for a given viewport height */
+export declare const vhToPixels: (viewportHeight: number) => (vhVal: Vh) => Pixels;
+/** Inches → Points (1in = 72pt) */
+export declare const inchesToPoints: (i: Inches) => Points;
+/** Points → Inches */
+export declare const pointsToInches: (pt: Points) => Inches;
+/** Inches → Pixels at 96 DPI (CSS standard) */
+export declare const inchesToPixels: (i: Inches) => Pixels;
+/** Pixels → Inches at 96 DPI (CSS standard) */
+export declare const pixelsToInches: (px: Pixels) => Inches;
+/** Any length unit */
+export type LengthUnit = Pixels | Ems | Rems | Vw | Vh | Percent | Points | Inches | Centimeters | Millimeters | Meters;
+/** CSS absolute length units */
+export type CSSAbsoluteLengthUnit = Pixels | Points | Inches | Centimeters | Millimeters;
+/** CSS relative length units */
+export type CSSRelativeLengthUnit = Ems | Rems | Vw | Vh | Percent;
+/** Metric length units */
+export type MetricLengthUnit = Meters | Centimeters | Millimeters;
+//# sourceMappingURL=length.d.ts.map

package/dist/units/length.d.ts.map

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

package/dist/units/length.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=length.test-d.d.ts.map

package/dist/units/length.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.test-d.d.ts","sourceRoot":"","sources":["../../src/units/length.test-d.ts"],"names":[],"mappings":""}