@penner/smart-primitive 0.0.1 → 0.1.0

package/dist/index.es.js

@@ -1,5 +1,68 @@
-const I = !1;
+import { ConverterRegistry as c, chain as T, createBiConverter as m, createConverter as d, createLinearConverter as p, createStringConverter as u, identity as h } from "./convert.es.js";
+import { applyVelocity as x, celsiusToFahrenheit as z, centimetersToInches as P, centimetersToMeters as v, centimetersToMillimeters as C, clampAlpha as M, clampNormalized as y, clampPercentage as S, clampSignedNormalized as f, degreesToRadians as R, degreesToTurns as N, emsToPixels as V, fahrenheitToCelsius as w, hoursToMinutes as D, inchesToCentimeters as I, inchesToPixels as F, inchesToPoints as A, metersToCentimeters as B, millimetersToCentimeters as E, millisecondsToSeconds as H, minutesToHours as L, minutesToSeconds as b, normalizeDegrees as j, normalizeRadians as k, normalizeTurns as q, normalizedProgressToPercent as G, normalizedToPercentage as J, percentToNormalizedProgress as K, percentageToNormalized as O, pixelsToEms as Q, pixelsToInches as U, pixelsToRems as W, pixelsToVh as X, pixelsToVw as Y, pointsToInches as Z, radiansToDegrees as _, radiansToTurns as $, remsToPixels as ee, secondsToMilliseconds as oe, secondsToMinutes as se, turnsToDegrees as re, turnsToRadians as ie, velocityFromValues as ne, velocityMillisecondsToSeconds as te, velocitySecondsToMilliseconds as le, vhToPixels as ae, vwToPixels as ce } from "./units/index.es.js";
+function n(o, e, s) {
+  return Math.min(Math.max(o, e), s);
+}
+function t(o, e, s) {
+  const r = s - e;
+  return ((o - e) % r + r) % r + e;
+}
 export {
-  I as USE_PLAIN_PRIMITIVES
+  c as ConverterRegistry,
+  x as applyVelocity,
+  z as celsiusToFahrenheit,
+  P as centimetersToInches,
+  v as centimetersToMeters,
+  C as centimetersToMillimeters,
+  T as chain,
+  n as clamp,
+  M as clampAlpha,
+  y as clampNormalized,
+  S as clampPercentage,
+  f as clampSignedNormalized,
+  m as createBiConverter,
+  d as createConverter,
+  p as createLinearConverter,
+  u as createStringConverter,
+  R as degreesToRadians,
+  N as degreesToTurns,
+  V as emsToPixels,
+  w as fahrenheitToCelsius,
+  D as hoursToMinutes,
+  h as identity,
+  I as inchesToCentimeters,
+  F as inchesToPixels,
+  A as inchesToPoints,
+  B as metersToCentimeters,
+  E as millimetersToCentimeters,
+  H as millisecondsToSeconds,
+  L as minutesToHours,
+  b as minutesToSeconds,
+  j as normalizeDegrees,
+  k as normalizeRadians,
+  q as normalizeTurns,
+  G as normalizedProgressToPercent,
+  J as normalizedToPercentage,
+  K as percentToNormalizedProgress,
+  O as percentageToNormalized,
+  Q as pixelsToEms,
+  U as pixelsToInches,
+  W as pixelsToRems,
+  X as pixelsToVh,
+  Y as pixelsToVw,
+  Z as pointsToInches,
+  _ as radiansToDegrees,
+  $ as radiansToTurns,
+  ee as remsToPixels,
+  oe as secondsToMilliseconds,
+  se as secondsToMinutes,
+  re as turnsToDegrees,
+  ie as turnsToRadians,
+  ne as velocityFromValues,
+  te as velocityMillisecondsToSeconds,
+  le as velocitySecondsToMilliseconds,
+  ae as vhToPixels,
+  ce as vwToPixels,
+  t as wrap
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/SmartPrimitive.ts"],"sourcesContent":["/**\n * 🔧 FEATURE FLAG: Toggle smart primitive type checking\n * When false (default): SmartPrimitive types provide type safety\n * When true: All SmartNumber, SmartString, etc. become plain primitives\n *\n * Use cases:\n * - Performance testing (eliminate type overhead)\n * - Debugging type issues\n * - Gradual migration to/from smart primitives\n * - Bundle size optimization\n *\n * How to use:\n * 1. Change `false` to `true` below\n * 2. Your entire codebase now treats Pixels, URLs, etc. as plain primitives\n * 3. Cross-brand assignments that were errors become allowed\n * 4. All type extraction utilities become no-ops\n * 5. Change back to `false` to re-enable smart primitive type safety\n */\n\n// 🔧 FEATURE FLAG: Both runtime constant AND compile-time type\nexport const USE_PLAIN_PRIMITIVES = false as const; // 👈 Change to `true` for plain primitives, `false` for branded types\nexport type USE_PLAIN_PRIMITIVES_TYPE = typeof USE_PLAIN_PRIMITIVES;\n\n/**\n * Clean type extraction using the brand pattern\n * Respects the USE_PLAIN_PRIMITIVES flag.\n */\ntype BaseOf<T> = USE_PLAIN_PRIMITIVES_TYPE extends true\n  ? T // 🚫 Smart types disabled: type is already the base\n  : T extends number & { readonly __brand?: unknown }\n    ? number\n    : T extends string & { readonly __brand?: unknown }\n      ? string\n      : T extends boolean & { readonly __brand?: unknown }\n        ? boolean\n        : T; // 🎯 Extract base type or return as-is\n\n/**\n * Generic smart primitive type that provides **opt-in type safety** while staying flexible.\n *\n * **How it works:**\n * - ✅ **Accepts plain values**: You can use regular numbers, strings, etc. directly\n * - ✅ **Prevents cross-domain mixing**: TypeScript stops you from using pixels where milliseconds are expected\n * - ✅ **Zero runtime cost**: No performance impact - it's just TypeScript magic\n * - ✅ **Easy to disable**: Toggle `USE_PLAIN_PRIMITIVES` to turn off all smart typing\n *\n * **Example:**\n * ```ts\n * type Pixels = SmartPrimitive<number, 'Pixels'>;\n * type Milliseconds = SmartPrimitive<number, 'Milliseconds'>;\n *\n * let width: Pixels = 300;        // ✅ Plain number works\n * let delay: Milliseconds = 500;        // ✅ Plain number works\n * let oops: Pixels = delay;       // ❌ TypeScript error - caught the mistake!\n * ```\n *\n * This prevents bugs like accidentally using milliseconds where pixels are expected,\n * while keeping your code simple and readable.\n */\nexport type SmartPrimitive<\n  Base extends string | number | boolean | bigint | symbol,\n  BrandName extends string,\n> = USE_PLAIN_PRIMITIVES_TYPE extends true\n  ? Base\n  : Base & { readonly __brand?: BrandName };\n\n/**\n * A smart number type for domain-specific numeric values like pixels, milliseconds, etc.\n *\n * **Why use this?** Prevents common bugs like mixing up different kinds of numbers:\n * - Using milliseconds where pixels are expected\n * - Passing a width value to a duration parameter\n * - Confusing degrees with radians\n *\n * **How it works:**\n * - ✅ Works with plain numbers: `let width: Pixels = 300`\n * - ✅ Catches domain mix-ups: `let width: Pixels = duration` → TypeScript error\n * - ✅ Zero runtime cost: Just TypeScript checking, no JavaScript overhead\n *\n * Built on `SmartPrimitive` - respects the USE_PLAIN_PRIMITIVES flag for easy toggling.\n *\n * **Example:**\n * ```ts\n * type Pixels = SmartNumber<'Pixels'>;\n * type Milliseconds = SmartNumber<'Milliseconds'>;\n *\n * let width: Pixels = 300;        // ✅ works\n * let delay: Milliseconds = 500;        // ✅ works\n * let badAssign: Pixels = delay;  // ❌ type error - caught the mistake!\n * ```\n *\n * When USE_PLAIN_PRIMITIVES = false (default):\n * - Full smart number system with type safety between different units\n * - Plain numbers accepted seamlessly\n * - Clean tooltip display\n *\n * When USE_PLAIN_PRIMITIVES = true:\n * - All smart number types collapse to plain `number`\n * - Zero runtime overhead, maximum performance\n *\n * Usage remains the same regardless of flag state:\n * ```ts\n * let distance: Pixels = 300;           // ✅ always works\n * let branded: Pixels = 300 as Pixels;  // ✅ always works\n * ```\n */\nexport type SmartNumber<BrandName extends string> = SmartPrimitive<\n  number,\n  BrandName\n>;\n\n/**\n * A smart string type that accepts plain strings but maintains type identity.\n * Perfect for things like URLs, CSS selectors, or other domain-specific strings.\n *\n * Usage:\n * ```ts\n * type URL = SmartString<'URL'>;\n * type CSSSelector = SmartString<'CSSSelector'>;\n *\n * let url: URL = \"https://example.com\";        // ✅ works\n * let selector: CSSSelector = \".my-class\";     // ✅ works\n * let badAssign: URL = selector;               // ❌ type error\n * ```\n */\nexport type SmartString<BrandName extends string> = SmartPrimitive<\n  string,\n  BrandName\n>;\n\n/**\n * A smart boolean type that accepts plain booleans but maintains type identity.\n * Useful for domain-specific flags or state indicators.\n *\n * Usage:\n * ```ts\n * type IsVisible = SmartBoolean<'IsVisible'>;\n * type IsEnabled = SmartBoolean<'IsEnabled'>;\n *\n * let visible: IsVisible = true;               // ✅ works\n * let enabled: IsEnabled = false;              // ✅ works\n * let badAssign: IsVisible = enabled;          // ❌ type error\n * ```\n */\nexport type SmartBoolean<BrandName extends string> = SmartPrimitive<\n  boolean,\n  BrandName\n>;\n\n/**\n * Simplified Unbrand using the generic brand pattern.\n * Also respects the USE_PLAIN_PRIMITIVES flag.\n *\n * When USE_PLAIN_PRIMITIVES = true: This becomes a no-op (types pass through unchanged)\n * When USE_PLAIN_PRIMITIVES = false: Full unbranding to base types\n */\nexport type Unbrand<T> = USE_PLAIN_PRIMITIVES_TYPE extends true\n  ? T // 🚫 Smart types disabled: types pass through unchanged\n  : // 🎯 Smart types enabled: extract base types and recurse\n    // 1️⃣ If T has a brand, extract the base type (could be number, string, etc.)\n    T extends number & { readonly __brand?: unknown }\n    ? number\n    : T extends string & { readonly __brand?: unknown }\n      ? string\n      : T extends boolean & { readonly __brand?: unknown }\n        ? boolean\n        : // 2️⃣ If T is an object (e.g. your params bag), recurse each field\n          T extends Record<string, unknown>\n          ? { [K in keyof T]: Unbrand<T[K]> }\n          : // 3️⃣ Everything else stays the same\n            T;\n\n/**\n * Given any function type F, produce a new function type whose\n * arguments have been passed through Unbrand<…>, and whose return\n * type you can also choose to unbrand (or leave alone).\n */\nexport type UnbrandFn<F, UnbrandReturn extends boolean = false> = F extends (\n  ...args: infer A\n) => infer R\n  ? A extends readonly unknown[]\n    ? (\n        ...args: { [K in keyof A]: Unbrand<A[K]> }\n      ) => UnbrandReturn extends true ? Unbrand<R> : R\n    : never\n  : never;\n\n// Export the BaseOf utility for advanced users\nexport type { BaseOf };\n"],"names":["USE_PLAIN_PRIMITIVES"],"mappings":"AAoBO,MAAMA,IAAuB;"}
+{"version":3,"file":"index.es.js","sources":["../src/trait-utils.ts"],"sourcesContent":["/**\n * 🏷️ Trait System Utilities\n *\n * Core trait interfaces and wrapper types for the orthogonal trait system.\n * These are used across all unit type definitions to provide composable,\n * flag-aware type annotations.\n */\n\nimport type { UsePlainPrimitives } from './SmartPrimitive';\n\n/* ═══════════════════════════════════════════════════════════════\n   CORE TRAIT INTERFACES (Internal)\n   ═══════════════════════════════════════════════════════════════ */\n\ninterface Unit<U extends string> {\n  readonly _unit?: U;\n}\n\ninterface Range<Min extends number, Max extends number> {\n  readonly _range?: { readonly min: Min; readonly max: Max };\n}\n\ninterface Clamped {\n  readonly _clamped?: true;\n}\n\ninterface Periodic {\n  readonly _periodic?: true;\n}\n\ninterface Kind<K extends string> {\n  readonly _kind?: K;\n}\n\ninterface Integer {\n  readonly _integer?: true;\n}\n\n/* ═══════════════════════════════════════════════════════════════\n   EXPORTED TRAIT WRAPPERS (Flag-Aware)\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Marks a number with measurement units.\n */\nexport type WithUnit<U extends string> = number &\n  (UsePlainPrimitives extends true ? {} : Unit<U>);\n\n/**\n * Marks a number as having a reference range [Min, Max].\n */\nexport type WithRange<Min extends number, Max extends number> = number &\n  (UsePlainPrimitives extends true ? {} : Range<Min, Max>);\n\n/**\n * Marks a number as being clamped (constrained) to its range.\n */\nexport type WithClamped = number &\n  (UsePlainPrimitives extends true ? {} : Clamped);\n\n/**\n * Marks a number as periodic (wrapping around at boundaries).\n */\nexport type WithPeriodic = number &\n  (UsePlainPrimitives extends true ? {} : Periodic);\n\n/**\n * Groups related unit types under a common archetype/kind.\n */\nexport type WithKind<K extends string> = number &\n  (UsePlainPrimitives extends true ? {} : Kind<K>);\n\n/**\n * Marks a number as an integer (whole number).\n */\nexport type WithInteger = number &\n  (UsePlainPrimitives extends true ? {} : Integer);\n\n/* ═══════════════════════════════════════════════════════════════\n   TYPE EXTRACTION UTILITIES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Extract units from a type.\n * @returns The unit string, or never if type has no Units trait.\n */\nexport type UnitOf<T> = T extends Unit<infer U> ? U : never;\n\n/**\n * Extract range from a type as a tuple [Min, Max].\n * @returns [Min, Max] tuple, or never if type has no Range trait.\n */\nexport type RangeOf<T> =\n  T extends Range<infer Min, infer Max> ? readonly [Min, Max] : never;\n\n/**\n * Extract min value from range trait.\n * @returns Min value, or never if type has no Range trait.\n */\nexport type MinOf<T> = T extends Range<infer Min, infer _Max> ? Min : never;\n\n/**\n * Extract max value from range trait.\n * @returns Max value, or never if type has no Range trait.\n */\nexport type MaxOf<T> = T extends Range<infer _Min, infer Max> ? Max : never;\n\n/**\n * Check if a type has the Clamped trait.\n * @returns true if clamped, false if not.\n */\nexport type IsClamped<T> = T extends Clamped ? true : false;\n\n/**\n * Check if a type has the Periodic trait.\n * @returns true if periodic, false if not.\n */\nexport type IsPeriodic<T> = T extends Periodic ? true : false;\n\n/**\n * Extract kind/archetype from a type.\n * @returns The kind string, or never if type has no Kind trait.\n */\nexport type KindOf<T> = T extends Kind<infer K> ? K : never;\n\n/* ═══════════════════════════════════════════════════════════════\n   TRAIT MODIFICATION UTILITIES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Remove the Clamped trait from a type (return to unclamped).\n */\nexport type WithoutClamped<T> = T extends Clamped ? Omit<T, '_clamped'> : T;\n\n/**\n * Remove the Periodic trait from a type.\n */\nexport type WithoutPeriodic<T> = T extends Periodic ? Omit<T, '_periodic'> : T;\n\n/**\n * Change the units of a type (unit conversion).\n */\nexport type ChangeUnits<T, U extends string> = Omit<T, '_unit'> & WithUnit<U>;\n\n/**\n * Change the range of a type.\n */\nexport type ChangeRange<T, Min extends number, Max extends number> = Omit<\n  T,\n  '_range'\n> &\n  WithRange<Min, Max>;\n\n/* ═══════════════════════════════════════════════════════════════\n   RUNTIME UTILITIES\n   ═══════════════════════════════════════════════════════════════ */\n\n/**\n * Clamp a value to specified bounds, preserve orthogonal traits, and mark as clamped.\n */\nexport function clamp<T extends number, Min extends number, Max extends number>(\n  value: T,\n  min: Min,\n  max: Max,\n): WithRange<Min, Max> & WithClamped {\n  return Math.min(Math.max(value, min), max);\n}\n\n/**\n * Wrap a value to specified bounds, preserve orthogonal traits, and mark as periodic.\n */\nexport function wrap<T, Min extends number, Max extends number>(\n  value: T,\n  min: Min,\n  max: Max,\n): Omit<T, '_range' | '_periodic'> & WithRange<Min, Max> & WithPeriodic {\n  const range = max - min;\n  const normalized = ((((value as any) - min) % range) + range) % range;\n  return (normalized + min) as any;\n}\n"],"names":["clamp","value","min","max","wrap","range"],"mappings":";;AAgKO,SAASA,EACdC,GACAC,GACAC,GACmC;AACnC,SAAO,KAAK,IAAI,KAAK,IAAIF,GAAOC,CAAG,GAAGC,CAAG;AAC3C;AAKO,SAASC,EACdH,GACAC,GACAC,GACsE;AACtE,QAAME,IAAQF,IAAMD;AAEpB,WADuBD,IAAgBC,KAAOG,IAASA,KAASA,IAC3CH;AACvB;"}

package/dist/strings/css.d.ts

@@ -0,0 +1,143 @@
+import { SmartString } from '../SmartPrimitive';
+/**
+ * A CSS selector string
+ *
+ * @example
+ * const btnSelector: CSSSelector = ".nav .button.primary";
+ */
+export type CSSSelector = SmartString<'CSSSelector'>;
+/**
+ * An XPath expression
+ *
+ * @example
+ * const firstLink: XPath = "//div[@id='main']//a[1]";
+ */
+export type XPath = SmartString<'XPath'>;
+/**
+ * An HTML element ID
+ *
+ * @example
+ * const mainId: HTMLElementID = "main-content";
+ */
+export type HTMLElementID = SmartString<'HTMLElementID'>;
+/**
+ * A CSS class name
+ *
+ * @example
+ * const primaryClass: CSSClassName = "button-primary";
+ */
+export type CSSClassName = SmartString<'CSSClassName'>;
+/**
+ * An HTML attribute name
+ *
+ * @example
+ * const trackingAttr: HTMLAttribute = "data-tracking-id";
+ */
+export type HTMLAttribute = SmartString<'HTMLAttribute'>;
+/**
+ * A CSS color value (hex, rgb, hsl, etc.)
+ *
+ * @example
+ * const accent: CSSColor = "#ffcc00";
+ * const overlay: CSSColor = "rgba(0, 0, 0, 0.5)";
+ */
+export type CSSColor = SmartString<'CSSColor'>;
+/**
+ * CSS length units
+ *
+ * Absolute: px, cm, mm, in, pt, pc
+ * Relative: em, rem, ex, ch, %
+ * Viewport: vw, vh, vmin, vmax
+ */
+export type CSSLengthUnit = 'px' | 'em' | 'rem' | '%' | 'vw' | 'vh' | 'vmin' | 'vmax' | 'ch' | 'ex' | 'cm' | 'mm' | 'in' | 'pt' | 'pc';
+/**
+ * CSS angle units
+ */
+export type CSSAngleUnit = 'deg' | 'rad' | 'grad' | 'turn';
+/**
+ * CSS time units
+ */
+export type CSSTimeUnit = 'ms' | 's';
+/**
+ * All CSS unit types
+ */
+export type CSSUnit = CSSLengthUnit | CSSAngleUnit | CSSTimeUnit;
+/**
+ * A CSS value with a number and unit (e.g., "16px", "1.5em")
+ *
+ * @example
+ * const width: CSSValue<'px'> = "16px";
+ * const fontSize: CSSValue<'em'> = "1.5em";
+ * const duration: CSSValue<'ms'> = "300ms";
+ */
+export type CSSUnitValue<U extends CSSUnit = CSSUnit> = `${number}${U}`;
+/**
+ * A CSS length value with unit
+ *
+ * @example
+ * const width: CSSLength = "16px";
+ * const padding: CSSLength = "2rem";
+ */
+export type CSSLength = CSSUnitValue<CSSLengthUnit>;
+/**
+ * A CSS angle value with unit
+ *
+ * @example
+ * const rotation: CSSAngle = "45deg";
+ * const hueRotation: CSSAngle = "0.5turn";
+ */
+export type CSSAngle = CSSUnitValue<CSSAngleUnit>;
+/**
+ * A CSS time value with unit
+ *
+ * @example
+ * const duration: CSSTime = "300ms";
+ * const delay: CSSTime = "0.5s";
+ */
+export type CSSTime = CSSUnitValue<CSSTimeUnit>;
+/**
+ * A percentage string with `%` suffix (e.g., "30%", "100%")
+ *
+ * Used for CSS percentage values and formatted display strings.
+ *
+ * @example
+ * const opacity: PercentageString = "50%";
+ * const progress: PercentageString = "100%";
+ */
+export type PercentageString = `${number}%`;
+/**
+ * A CSS easing function string
+ *
+ * @example
+ * const easeInOut: CSSEasing = "ease-in-out";
+ * const easeInOutBezier: CSSEasing = "cubic-bezier(0.42, 0, 0.58, 1)";
+ * const easeBounce: CSSEasing = "linear(0 0%, 0.01 1.25%, 0.04 5%, ...)";
+ */
+export type CSSEasing = SmartString<'CSSEasing'>;
+/**
+ * A CSS custom property name
+ *
+ * Should start with two hyphens (--)
+ *
+ * @example
+ * const themeProp: CSSCustomProperty = "--theme-color";
+ * const spacing: CSSCustomProperty = "--spacing-lg";
+ */
+export type CSSCustomProperty = SmartString<'CSSCustomProperty'>;
+/**
+ * CSS cursor property values
+ *
+ * Standard cursor types for interactive elements. Provides autocomplete and
+ * type safety for cursor assignments. Includes a fallback for custom cursor
+ * URLs like `url("cursor.png"), auto`.
+ *
+ * @example
+ * const dragCursor: CSSCursor = "move";
+ * const resizeCursor: CSSCursor = "ns-resize";
+ * element.style.cursor = dragCursor;
+ *
+ * // Custom cursor with fallback
+ * const customCursor: CSSCursor = 'url("cursor.png"), pointer';
+ */
+export type CSSCursor = 'default' | 'pointer' | 'wait' | 'text' | 'help' | 'move' | 'grab' | 'grabbing' | 'copy' | 'alias' | 'n-resize' | 's-resize' | 'e-resize' | 'w-resize' | 'ne-resize' | 'nw-resize' | 'se-resize' | 'sw-resize' | 'ns-resize' | 'ew-resize' | 'nwse-resize' | 'nesw-resize' | 'col-resize' | 'row-resize' | 'crosshair' | 'cell' | 'zoom-in' | 'zoom-out' | 'not-allowed' | 'no-drop' | 'progress' | 'context-menu' | 'vertical-text' | 'all-scroll' | 'none' | 'auto' | 'inherit' | 'initial' | 'unset' | (string & {});
+//# sourceMappingURL=css.d.ts.map

package/dist/strings/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/strings/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAMzC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAMzD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,MAAM,GAAG,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAEjB,SAAS,GACT,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GAEN,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GAEP,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GAEV,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GAEX,WAAW,GACX,WAAW,GACX,aAAa,GACb,aAAa,GAEb,YAAY,GACZ,YAAY,GAEZ,WAAW,GACX,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,SAAS,GACT,UAAU,GACV,cAAc,GACd,eAAe,GACf,YAAY,GAEZ,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,GACT,OAAO,GAEP,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}

package/dist/strings/data.d.ts

@@ -0,0 +1,140 @@
+import { SmartString } from '../SmartPrimitive';
+/**
+ * A JSON-formatted string
+ *
+ * @example
+ * const config: JSONString = '{"name":"app","version":"1.0"}';
+ */
+export type JSONString = SmartString<'JSONString'>;
+/**
+ * An XML-formatted string
+ *
+ * @example
+ * const doc: XMLString = '<?xml version="1.0"?><root><item>data</item></root>';
+ */
+export type XMLString = SmartString<'XMLString'>;
+/**
+ * A YAML-formatted string
+ *
+ * @example
+ * const config: YAMLString = 'name: app\nversion: 1.0\nitems:\n  - one\n  - two';
+ */
+export type YAMLString = SmartString<'YAMLString'>;
+/**
+ * A CSV-formatted string
+ *
+ * @example
+ * const data: CSVString = 'name,age,city\nAlice,30,NYC\nBob,25,LA';
+ */
+export type CSVString = SmartString<'CSVString'>;
+/**
+ * A Base64-encoded string
+ *
+ * @example
+ * const encoded: Base64String = 'SGVsbG8gV29ybGQ=';
+ */
+export type Base64String = SmartString<'Base64String'>;
+/**
+ * A UUID string
+ *
+ * @example
+ * const id: UUID = '550e8400-e29b-41d4-a716-446655440000';
+ */
+export type UUID = SmartString<'UUID'>;
+/**
+ * A ULID string
+ *
+ * @example
+ * const id: ULID = '01ARZ3NDEKTSV4RRFFQ69G5FAV';
+ */
+export type ULID = SmartString<'ULID'>;
+/**
+ * A nanoid string
+ *
+ * @example
+ * const id: NanoID = 'V1StGXR_Z5j3eK6b';
+ */
+export type NanoID = SmartString<'NanoID'>;
+/**
+ * A slug string (URL-safe identifier)
+ *
+ * @example
+ * const urlPath: Slug = 'my-awesome-article';
+ */
+export type Slug = SmartString<'Slug'>;
+/**
+ * An email address
+ *
+ * @example
+ * const contact: EmailAddress = 'user@example.com';
+ */
+export type EmailAddress = SmartString<'EmailAddress'>;
+/**
+ * A phone number
+ *
+ * @example
+ * const phone: PhoneNumber = '+1-555-123-4567';
+ */
+export type PhoneNumber = SmartString<'PhoneNumber'>;
+/**
+ * An IP address (v4 or v6)
+ *
+ * @example
+ * const ipv4: IPAddress = '192.168.1.1';
+ * const ipv6: IPAddress = '2001:0db8:85a3::8a2e:0370:7334';
+ */
+export type IPAddress = SmartString<'IPAddress'>;
+/**
+ * A hostname
+ *
+ * @example
+ * const host: Hostname = 'example.com';
+ * const subdomain: Hostname = 'api.example.com';
+ */
+export type Hostname = SmartString<'Hostname'>;
+/**
+ * An ISO 8601 date string
+ *
+ * @example
+ * const date: ISODateString = '2024-12-21';
+ */
+export type ISODateString = SmartString<'ISODateString'>;
+/**
+ * An ISO 8601 datetime string
+ *
+ * @example
+ * const datetime: ISODateTimeString = '2024-12-21T15:30:45Z';
+ */
+export type ISODateTimeString = SmartString<'ISODateTimeString'>;
+/**
+ * A time string (HH:MM:SS)
+ *
+ * @example
+ * const time: TimeString = '15:30:45';
+ */
+export type TimeString = SmartString<'TimeString'>;
+/**
+ * A file path
+ *
+ * @example
+ * const path: FilePath = '/home/user/documents/file.txt';
+ * const winPath: FilePath = 'C:\\Users\\user\\Documents\\file.txt';
+ */
+export type FilePath = SmartString<'FilePath'>;
+/**
+ * A directory path
+ *
+ * @example
+ * const dir: DirectoryPath = '/home/user/documents';
+ * const winDir: DirectoryPath = 'C:\\Users\\user\\Documents';
+ */
+export type DirectoryPath = SmartString<'DirectoryPath'>;
+/**
+ * A file extension (including dot)
+ *
+ * @example
+ * const txtExt: FileExtension = '.txt';
+ * const jsExt: FileExtension = '.js';
+ */
+export type FileExtension = SmartString<'FileExtension'>;
+//# sourceMappingURL=data.d.ts.map

package/dist/strings/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/strings/data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAMvD;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAMvC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;AAM/C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAMnD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC"}

package/dist/strings/index.cjs.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/strings/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 📝 Strings Index
+ *
+ * Re-exports all SmartString types and constructors from category modules.
+ *
+ * @example
+ * ```ts
+ * import { URL, CSSSelector, UUID, EmailAddress } from '@penner/smart-primitive/strings';
+ * ```
+ */
+export * from './web';
+export * from './css';
+export * from './data';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC"}

package/dist/strings/index.es.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index.es.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/strings/web.d.ts

@@ -0,0 +1,55 @@
+import { SmartString } from '../SmartPrimitive';
+/**
+ * An absolute URL with protocol (subtype of URL)
+ *
+ * Must include a protocol (http://, https://, etc.)
+ *
+ * @example
+ * const apiEndpoint: AbsoluteURL = "https://api.example.com/v1/users";
+ * const fileLink: AbsoluteURL = "file:///path/to/file.html";
+ */
+export type AbsoluteURL = SmartString<'AbsoluteURL'>;
+/**
+ * A relative URL path (subtype of URL)
+ *
+ * Path-only URL without protocol. Can start with / (root-relative) or not (relative).
+ *
+ * @example
+ * const aboutPath: RelativeURL = "/about/team"; // root-relative
+ * const nested: RelativeURL = "./components/button"; // relative
+ * const parent: RelativeURL = "../assets/image.png"; // parent-relative
+ */
+export type RelativeURL = SmartString<'RelativeURL'>;
+/**
+ * A URL string
+ *
+ * @example
+ * const homepage: URL = "https://example.com";
+ */
+export type URL = AbsoluteURL | RelativeURL;
+/**
+ * A data URL (base64 encoded)
+ *
+ * @example
+ * const imageData: DataURL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...";
+ */
+export type DataURL = SmartString<'DataURL'>;
+/**
+ * An HTTP method (GET, POST, PUT, DELETE, PATCH, etc.)
+ *
+ * @example
+ * const getMethod: HTTPMethod = "GET";
+ * const postMethod: HTTPMethod = "POST";
+ * const deleteMethod: HTTPMethod = "DELETE";
+ */
+export type HTTPMethod = SmartString<'HTTPMethod'>;
+/**
+ * A MIME type (media type)
+ *
+ * @example
+ * const jsonType: MIMEType = "application/json";
+ * const htmlType: MIMEType = "text/html";
+ * const imageType: MIMEType = "image/png";
+ */
+export type MIMEType = SmartString<'MIMEType'>;
+//# sourceMappingURL=web.d.ts.map

package/dist/strings/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/strings/web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,GAAG,GAAG,WAAW,GAAG,WAAW,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAM7C;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC"}

package/dist/trait-utils.d.ts

@@ -0,0 +1,107 @@
+import { UsePlainPrimitives } from './SmartPrimitive';
+interface Unit<U extends string> {
+    readonly _unit?: U;
+}
+interface Range<Min extends number, Max extends number> {
+    readonly _range?: {
+        readonly min: Min;
+        readonly max: Max;
+    };
+}
+interface Clamped {
+    readonly _clamped?: true;
+}
+interface Periodic {
+    readonly _periodic?: true;
+}
+interface Kind<K extends string> {
+    readonly _kind?: K;
+}
+interface Integer {
+    readonly _integer?: true;
+}
+/**
+ * Marks a number with measurement units.
+ */
+export type WithUnit<U extends string> = number & (UsePlainPrimitives extends true ? {} : Unit<U>);
+/**
+ * Marks a number as having a reference range [Min, Max].
+ */
+export type WithRange<Min extends number, Max extends number> = number & (UsePlainPrimitives extends true ? {} : Range<Min, Max>);
+/**
+ * Marks a number as being clamped (constrained) to its range.
+ */
+export type WithClamped = number & (UsePlainPrimitives extends true ? {} : Clamped);
+/**
+ * Marks a number as periodic (wrapping around at boundaries).
+ */
+export type WithPeriodic = number & (UsePlainPrimitives extends true ? {} : Periodic);
+/**
+ * Groups related unit types under a common archetype/kind.
+ */
+export type WithKind<K extends string> = number & (UsePlainPrimitives extends true ? {} : Kind<K>);
+/**
+ * Marks a number as an integer (whole number).
+ */
+export type WithInteger = number & (UsePlainPrimitives extends true ? {} : Integer);
+/**
+ * Extract units from a type.
+ * @returns The unit string, or never if type has no Units trait.
+ */
+export type UnitOf<T> = T extends Unit<infer U> ? U : never;
+/**
+ * Extract range from a type as a tuple [Min, Max].
+ * @returns [Min, Max] tuple, or never if type has no Range trait.
+ */
+export type RangeOf<T> = T extends Range<infer Min, infer Max> ? readonly [Min, Max] : never;
+/**
+ * Extract min value from range trait.
+ * @returns Min value, or never if type has no Range trait.
+ */
+export type MinOf<T> = T extends Range<infer Min, infer _Max> ? Min : never;
+/**
+ * Extract max value from range trait.
+ * @returns Max value, or never if type has no Range trait.
+ */
+export type MaxOf<T> = T extends Range<infer _Min, infer Max> ? Max : never;
+/**
+ * Check if a type has the Clamped trait.
+ * @returns true if clamped, false if not.
+ */
+export type IsClamped<T> = T extends Clamped ? true : false;
+/**
+ * Check if a type has the Periodic trait.
+ * @returns true if periodic, false if not.
+ */
+export type IsPeriodic<T> = T extends Periodic ? true : false;
+/**
+ * Extract kind/archetype from a type.
+ * @returns The kind string, or never if type has no Kind trait.
+ */
+export type KindOf<T> = T extends Kind<infer K> ? K : never;
+/**
+ * Remove the Clamped trait from a type (return to unclamped).
+ */
+export type WithoutClamped<T> = T extends Clamped ? Omit<T, '_clamped'> : T;
+/**
+ * Remove the Periodic trait from a type.
+ */
+export type WithoutPeriodic<T> = T extends Periodic ? Omit<T, '_periodic'> : T;
+/**
+ * Change the units of a type (unit conversion).
+ */
+export type ChangeUnits<T, U extends string> = Omit<T, '_unit'> & WithUnit<U>;
+/**
+ * Change the range of a type.
+ */
+export type ChangeRange<T, Min extends number, Max extends number> = Omit<T, '_range'> & WithRange<Min, Max>;
+/**
+ * Clamp a value to specified bounds, preserve orthogonal traits, and mark as clamped.
+ */
+export declare function clamp<T extends number, Min extends number, Max extends number>(value: T, min: Min, max: Max): WithRange<Min, Max> & WithClamped;
+/**
+ * Wrap a value to specified bounds, preserve orthogonal traits, and mark as periodic.
+ */
+export declare function wrap<T, Min extends number, Max extends number>(value: T, min: Min, max: Max): Omit<T, '_range' | '_periodic'> & WithRange<Min, Max> & WithPeriodic;
+export {};
+//# sourceMappingURL=trait-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trait-utils.d.ts","sourceRoot":"","sources":["../src/trait-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAM3D,UAAU,IAAI,CAAC,CAAC,SAAS,MAAM;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACpB;AAED,UAAU,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;KAAE,CAAC;CAC5D;AAED,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B;AAED,UAAU,IAAI,CAAC,CAAC,SAAS,MAAM;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CACpB;AAED,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAC7C,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,IAAI,MAAM,GACpE,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAC9B,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAC/B,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAC7C,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAC9B,CAAC,kBAAkB,SAAS,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;AAMnD;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IACnB,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAM5D;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CACvE,CAAC,EACD,QAAQ,CACT,GACC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAMtB;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAC5E,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,GACP,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAEnC;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAC5D,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,GACP,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,YAAY,CAItE"}

package/dist/traits.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ���️ Legacy Traits Module
+ *
+ * This file provides backward compatibility for imports from './traits'.
+ * Most functionality has been migrated to:
+ * - trait-utils.ts: Core trait infrastructure
+ * - units/*.ts: Individual unit type definitions
+ */
+export type { WithUnit, WithRange, WithClamped, WithPeriodic, WithKind, UnitOf, RangeOf, MinOf, MaxOf, IsClamped, IsPeriodic, KindOf, WithoutClamped, WithoutPeriodic, ChangeUnits, ChangeRange, } from './trait-utils';
+export { clamp, wrap } from './trait-utils';
+export type { Normalized, SignedNormalized, Percentage, ClampedNormalized, Alpha, Ratio, Factor, NormalizedTime, NormalizedProgress, PercentProgress, } from './units/normalized';
+export type { Degrees, Radians, Turns } from './units/angle';
+export type { Pixels } from './units/length';
+//# sourceMappingURL=traits.d.ts.map

package/dist/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,YAAY,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,KAAK,EACL,SAAS,EACT,UAAU,EACV,MAAM,EACN,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG5C,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}