@viax.io/uxm 4.36.0

package/dist/lib/calendar-grid.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Month-grid math for the Calendar atom. Pure: no React, no DOM, no I/O.
+ * Verified against October 2024, February 2024 (leap), February 2023, and
+ * December 2024 (year boundary) with both Sunday- and Monday-start.
+ */
+/** 0 = Sunday, 1 = Monday. */
+export type WeekStart = 0 | 1;
+export interface CalendarCell {
+    /** Absolute date this cell represents. Time component is midnight local. */
+    date: Date;
+    /** True when the date belongs to the previous or next month (grid filler). */
+    outside: boolean;
+}
+/**
+ * Build the 42-cell (6 weeks × 7 days) grid for the month containing `month`.
+ *
+ * The grid always starts on the chosen week-start day and always has 42 cells,
+ * so each row aligns to a weekday and the prev / next-month overflow cells
+ * fill the gaps. Year boundaries (e.g. Dec 2024 → Jan 2025) are handled by
+ * JS `Date` arithmetic: `new Date(y, 11, 32)` rolls into Jan 1 of the next year.
+ *
+ * @param month         Any date in the month to display. Only year + month read.
+ * @param weekStartsOn  0 for Sunday (US), 1 for Monday (most of the world).
+ */
+export declare function computeMonthGrid(month: Date, weekStartsOn?: WeekStart): CalendarCell[];
+//# sourceMappingURL=calendar-grid.d.ts.map

package/dist/lib/calendar-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-grid.d.ts","sourceRoot":"","sources":["../../src/lib/calendar-grid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,EAAE,IAAI,CAAC;IACX,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,GAAE,SAAa,GAAG,YAAY,EAAE,CAezF"}

package/dist/lib/calendar-grid.js

@@ -0,0 +1,16 @@
+function computeMonthGrid(month, weekStartsOn = 0) {
+  const year = month.getFullYear();
+  const m = month.getMonth();
+  const firstWeekday = new Date(year, m, 1).getDay();
+  const backOffset = (firstWeekday - weekStartsOn + 7) % 7;
+  const cells = [];
+  for (let i = 0; i < 42; i++) {
+    const date = new Date(year, m, 1 - backOffset + i);
+    cells.push({ date, outside: date.getMonth() !== m });
+  }
+  return cells;
+}
+export {
+  computeMonthGrid
+};
+//# sourceMappingURL=calendar-grid.js.map

package/dist/lib/calendar-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/calendar-grid.ts"],"sourcesContent":["/**\n * Month-grid math for the Calendar atom. Pure: no React, no DOM, no I/O.\n * Verified against October 2024, February 2024 (leap), February 2023, and\n * December 2024 (year boundary) with both Sunday- and Monday-start.\n */\n\n/** 0 = Sunday, 1 = Monday. */\nexport type WeekStart = 0 | 1;\n\nexport interface CalendarCell {\n  /** Absolute date this cell represents. Time component is midnight local. */\n  date: Date;\n  /** True when the date belongs to the previous or next month (grid filler). */\n  outside: boolean;\n}\n\n/**\n * Build the 42-cell (6 weeks × 7 days) grid for the month containing `month`.\n *\n * The grid always starts on the chosen week-start day and always has 42 cells,\n * so each row aligns to a weekday and the prev / next-month overflow cells\n * fill the gaps. Year boundaries (e.g. Dec 2024 → Jan 2025) are handled by\n * JS `Date` arithmetic: `new Date(y, 11, 32)` rolls into Jan 1 of the next year.\n *\n * @param month         Any date in the month to display. Only year + month read.\n * @param weekStartsOn  0 for Sunday (US), 1 for Monday (most of the world).\n */\nexport function computeMonthGrid(month: Date, weekStartsOn: WeekStart = 0): CalendarCell[] {\n  const year = month.getFullYear();\n  const m = month.getMonth();\n  const firstWeekday = new Date(year, m, 1).getDay(); // 0 = Sunday\n  // Days to go back from the 1st to land on the chosen week-start day.\n  // Sun start (0): back-offset equals firstWeekday.\n  // Mon start (1): the formula `(firstWeekday - 1 + 7) % 7` handles the wrap\n  // when the 1st falls on Sunday (firstWeekday=0 → back-offset=6).\n  const backOffset = (firstWeekday - weekStartsOn + 7) % 7;\n  const cells: CalendarCell[] = [];\n  for (let i = 0; i < 42; i++) {\n    const date = new Date(year, m, 1 - backOffset + i);\n    cells.push({ date, outside: date.getMonth() !== m });\n  }\n  return cells;\n}\n"],"mappings":"AA2BO,SAAS,iBAAiB,OAAa,eAA0B,GAAmB;AACzF,QAAM,OAAO,MAAM,YAAY;AAC/B,QAAM,IAAI,MAAM,SAAS;AACzB,QAAM,eAAe,IAAI,KAAK,MAAM,GAAG,CAAC,EAAE,OAAO;AAKjD,QAAM,cAAc,eAAe,eAAe,KAAK;AACvD,QAAM,QAAwB,CAAC;AAC/B,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,OAAO,IAAI,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC;AACjD,UAAM,KAAK,EAAE,MAAM,SAAS,KAAK,SAAS,MAAM,EAAE,CAAC;AAAA,EACrD;AACA,SAAO;AACT;","names":[]}

package/dist/lib/contrast.cjs

@@ -0,0 +1,225 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contrast_exports = {};
+__export(contrast_exports, {
+  contrastRatio: () => contrastRatio,
+  hexToHsl: () => hexToHsl,
+  hslToHex: () => hslToHex,
+  hslToRgb: () => hslToRgb,
+  parseColor: () => parseColor,
+  relativeLuminance: () => relativeLuminance,
+  resolveCssColor: () => resolveCssColor,
+  retintHue: () => retintHue,
+  rgbToHex: () => rgbToHex,
+  rgbToHsl: () => rgbToHsl,
+  suggestAccessibleColor: () => suggestAccessibleColor,
+  suggestAccessibleToken: () => suggestAccessibleToken,
+  wcagLevel: () => wcagLevel
+});
+module.exports = __toCommonJS(contrast_exports);
+function resolveCssColor(value, scope) {
+  const trimmed = value.trim();
+  const varMatch = trimmed.match(/^var\((--[\w-]+)(?:\s*,\s*([^)]+))?\)$/);
+  if (varMatch) {
+    const source = scope ?? (typeof document !== "undefined" ? document.documentElement : null);
+    if (source) {
+      const resolved = getComputedStyle(source).getPropertyValue(varMatch[1]).trim();
+      if (resolved) return resolveCssColor(resolved, scope);
+    }
+    if (varMatch[2]) return resolveCssColor(varMatch[2], scope);
+  }
+  return trimmed;
+}
+function parseColor(value, scope) {
+  const v = resolveCssColor(value, scope);
+  const hex = v.match(/^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i);
+  if (hex) {
+    const h = hex[1];
+    const expand = h.length === 3 || h.length === 4 ? h.split("").map((c) => c + c).join("") : h;
+    return {
+      r: parseInt(expand.slice(0, 2), 16),
+      g: parseInt(expand.slice(2, 4), 16),
+      b: parseInt(expand.slice(4, 6), 16)
+    };
+  }
+  const rgb = v.match(/^rgba?\(([^)]+)\)$/i);
+  if (rgb) {
+    const parts = rgb[1].split(/[\s,/]+/).filter(Boolean).slice(0, 3);
+    if (parts.length === 3) {
+      const [r, g, b] = parts.map((p) => {
+        const n = p.endsWith("%") ? parseFloat(p) * 255 / 100 : parseFloat(p);
+        return Math.round(n);
+      });
+      return { r, g, b };
+    }
+  }
+  return null;
+}
+function channelLuminance(c) {
+  const s = c / 255;
+  return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+}
+function relativeLuminance({ r, g, b }) {
+  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
+}
+function contrastRatio(fg, bg) {
+  const l1 = relativeLuminance(fg);
+  const l2 = relativeLuminance(bg);
+  const [lighter, darker] = l1 > l2 ? [l1, l2] : [l2, l1];
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function wcagLevel(ratio) {
+  if (ratio >= 7) return "AAA";
+  if (ratio >= 4.5) return "AA";
+  if (ratio >= 3) return "AA-large";
+  return "fail";
+}
+function rgbToHex({ r, g, b }) {
+  const c = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0");
+  return `#${c(r)}${c(g)}${c(b)}`;
+}
+function rgbToHsl({ r, g, b }) {
+  const rn = r / 255;
+  const gn = g / 255;
+  const bn = b / 255;
+  const max = Math.max(rn, gn, bn);
+  const min = Math.min(rn, gn, bn);
+  const d = max - min;
+  let h = 0;
+  if (d !== 0) {
+    switch (max) {
+      case rn:
+        h = (gn - bn) / d % 6;
+        break;
+      case gn:
+        h = (bn - rn) / d + 2;
+        break;
+      default:
+        h = (rn - gn) / d + 4;
+        break;
+    }
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  const l = (max + min) / 2;
+  const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));
+  return { h, s: s * 100, l: l * 100 };
+}
+function hslToRgb({ h, s, l }) {
+  const sn = Math.max(0, Math.min(100, s)) / 100;
+  const ln = Math.max(0, Math.min(100, l)) / 100;
+  const c = (1 - Math.abs(2 * ln - 1)) * sn;
+  const hp = (h % 360 + 360) % 360 / 60;
+  const x = c * (1 - Math.abs(hp % 2 - 1));
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];
+  else if (hp < 2) [r, g, b] = [x, c, 0];
+  else if (hp < 3) [r, g, b] = [0, c, x];
+  else if (hp < 4) [r, g, b] = [0, x, c];
+  else if (hp < 5) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+  const m = ln - c / 2;
+  return { r: (r + m) * 255, g: (g + m) * 255, b: (b + m) * 255 };
+}
+function hexToHsl(value, scope) {
+  const rgb = parseColor(value, scope);
+  return rgb ? rgbToHsl(rgb) : null;
+}
+function hslToHex(hsl) {
+  return rgbToHex(hslToRgb(hsl));
+}
+function retintHue(value, targetHue, scope) {
+  const hsl = hexToHsl(value, scope);
+  if (!hsl) return value;
+  return hslToHex({ h: targetHue, s: hsl.s, l: hsl.l });
+}
+function mixToward(rgb, target, amount) {
+  return {
+    r: rgb.r + (target.r - rgb.r) * amount,
+    g: rgb.g + (target.g - rgb.g) * amount,
+    b: rgb.b + (target.b - rgb.b) * amount
+  };
+}
+function searchTowardPole(fg, bg, pole, targetRatio) {
+  let lo = 0;
+  let hi = 1;
+  let best = null;
+  for (let i = 0; i < 24; i++) {
+    const mid = (lo + hi) / 2;
+    const candidate = mixToward(fg, pole, mid);
+    if (contrastRatio(candidate, bg) >= targetRatio) {
+      best = candidate;
+      hi = mid;
+    } else {
+      lo = mid;
+    }
+  }
+  if (!best) return null;
+  let rounded = { r: Math.round(best.r), g: Math.round(best.g), b: Math.round(best.b) };
+  for (let step = 0; step < 16 && contrastRatio(rounded, bg) < targetRatio; step++) {
+    rounded = {
+      r: rounded.r + Math.sign(pole.r - rounded.r),
+      g: rounded.g + Math.sign(pole.g - rounded.g),
+      b: rounded.b + Math.sign(pole.b - rounded.b)
+    };
+  }
+  return contrastRatio(rounded, bg) >= targetRatio ? rounded : null;
+}
+function suggestAccessibleColor(fg, bg, targetRatio = 4.5) {
+  if (contrastRatio(fg, bg) >= targetRatio) return fg;
+  const towardBlack = searchTowardPole(fg, bg, { r: 0, g: 0, b: 0 }, targetRatio);
+  const towardWhite = searchTowardPole(fg, bg, { r: 255, g: 255, b: 255 }, targetRatio);
+  if (towardBlack && towardWhite) {
+    const dBlack = colorDistance(fg, towardBlack);
+    const dWhite = colorDistance(fg, towardWhite);
+    return dBlack <= dWhite ? towardBlack : towardWhite;
+  }
+  return towardBlack ?? towardWhite;
+}
+function colorDistance(a, b) {
+  const dr = a.r - b.r;
+  const dg = a.g - b.g;
+  const db = a.b - b.b;
+  return dr * dr + dg * dg + db * db;
+}
+function suggestAccessibleToken(fg, bg, targetRatio, candidates) {
+  const passing = candidates.filter((c) => contrastRatio(c.rgb, bg) >= targetRatio);
+  if (passing.length === 0) return null;
+  passing.sort((a, b) => colorDistance(fg, a.rgb) - colorDistance(fg, b.rgb));
+  return passing[0];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  contrastRatio,
+  hexToHsl,
+  hslToHex,
+  hslToRgb,
+  parseColor,
+  relativeLuminance,
+  resolveCssColor,
+  retintHue,
+  rgbToHex,
+  rgbToHsl,
+  suggestAccessibleColor,
+  suggestAccessibleToken,
+  wcagLevel
+});
+//# sourceMappingURL=contrast.cjs.map

package/dist/lib/contrast.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/contrast.ts"],"sourcesContent":["export interface RGB { r: number; g: number; b: number }\n\nexport function resolveCssColor(value: string, scope?: Element | null): string {\n  const trimmed = value.trim();\n  const varMatch = trimmed.match(/^var\\((--[\\w-]+)(?:\\s*,\\s*([^)]+))?\\)$/);\n  if (varMatch) {\n    const source = scope ?? (typeof document !== 'undefined' ? document.documentElement : null);\n    if (source) {\n      const resolved = getComputedStyle(source).getPropertyValue(varMatch[1]).trim();\n      if (resolved) return resolveCssColor(resolved, scope);\n    }\n    if (varMatch[2]) return resolveCssColor(varMatch[2], scope);\n  }\n  return trimmed;\n}\n\nexport function parseColor(value: string, scope?: Element | null): RGB | null {\n  const v = resolveCssColor(value, scope);\n\n  const hex = v.match(/^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i);\n  if (hex) {\n    const h = hex[1];\n    const expand = h.length === 3 || h.length === 4\n      ? h.split('').map((c) => c + c).join('')\n      : h;\n    return {\n      r: parseInt(expand.slice(0, 2), 16),\n      g: parseInt(expand.slice(2, 4), 16),\n      b: parseInt(expand.slice(4, 6), 16),\n    };\n  }\n\n  const rgb = v.match(/^rgba?\\(([^)]+)\\)$/i);\n  if (rgb) {\n    const parts = rgb[1].split(/[\\s,/]+/).filter(Boolean).slice(0, 3);\n    if (parts.length === 3) {\n      const [r, g, b] = parts.map((p) => {\n        const n = p.endsWith('%') ? (parseFloat(p) * 255) / 100 : parseFloat(p);\n        return Math.round(n);\n      });\n      return { r, g, b };\n    }\n  }\n\n  return null;\n}\n\nfunction channelLuminance(c: number): number {\n  const s = c / 255;\n  return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);\n}\n\nexport function relativeLuminance({ r, g, b }: RGB): number {\n  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);\n}\n\nexport function contrastRatio(fg: RGB, bg: RGB): number {\n  const l1 = relativeLuminance(fg);\n  const l2 = relativeLuminance(bg);\n  const [lighter, darker] = l1 > l2 ? [l1, l2] : [l2, l1];\n  return (lighter + 0.05) / (darker + 0.05);\n}\n\nexport type WcagLevel = 'AAA' | 'AA' | 'AA-large' | 'fail';\n\nexport function wcagLevel(ratio: number): WcagLevel {\n  if (ratio >= 7) return 'AAA';\n  if (ratio >= 4.5) return 'AA';\n  if (ratio >= 3) return 'AA-large';\n  return 'fail';\n}\n\nexport function rgbToHex({ r, g, b }: RGB): string {\n  const c = (n: number) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, '0');\n  return `#${c(r)}${c(g)}${c(b)}`;\n}\n\nexport interface HSL {\n  /** Hue in degrees, 0–360. */\n  h: number;\n  /** Saturation, 0–100. */\n  s: number;\n  /** Lightness, 0–100. */\n  l: number;\n}\n\nexport function rgbToHsl({ r, g, b }: RGB): HSL {\n  const rn = r / 255;\n  const gn = g / 255;\n  const bn = b / 255;\n  const max = Math.max(rn, gn, bn);\n  const min = Math.min(rn, gn, bn);\n  const d = max - min;\n  let h = 0;\n  if (d !== 0) {\n    switch (max) {\n      case rn: h = ((gn - bn) / d) % 6; break;\n      case gn: h = (bn - rn) / d + 2; break;\n      default: h = (rn - gn) / d + 4; break;\n    }\n    h *= 60;\n    if (h < 0) h += 360;\n  }\n  const l = (max + min) / 2;\n  const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));\n  return { h, s: s * 100, l: l * 100 };\n}\n\nexport function hslToRgb({ h, s, l }: HSL): RGB {\n  const sn = Math.max(0, Math.min(100, s)) / 100;\n  const ln = Math.max(0, Math.min(100, l)) / 100;\n  const c = (1 - Math.abs(2 * ln - 1)) * sn;\n  const hp = (((h % 360) + 360) % 360) / 60;\n  const x = c * (1 - Math.abs((hp % 2) - 1));\n  let r = 0;\n  let g = 0;\n  let b = 0;\n  if (hp < 1) [r, g, b] = [c, x, 0];\n  else if (hp < 2) [r, g, b] = [x, c, 0];\n  else if (hp < 3) [r, g, b] = [0, c, x];\n  else if (hp < 4) [r, g, b] = [0, x, c];\n  else if (hp < 5) [r, g, b] = [x, 0, c];\n  else [r, g, b] = [c, 0, x];\n  const m = ln - c / 2;\n  return { r: (r + m) * 255, g: (g + m) * 255, b: (b + m) * 255 };\n}\n\n/** Convert a hex (or any parseable color) string to HSL. Returns null if unparseable. */\nexport function hexToHsl(value: string, scope?: Element | null): HSL | null {\n  const rgb = parseColor(value, scope);\n  return rgb ? rgbToHsl(rgb) : null;\n}\n\n/** Convert HSL back to a `#rrggbb` hex string. */\nexport function hslToHex(hsl: HSL): string {\n  return rgbToHex(hslToRgb(hsl));\n}\n\n/**\n * Re-tint a color to a target hue while preserving its own saturation and\n * lightness — used to recompute an accent ramp from a single brand hue.\n * Returns a `#rrggbb` hex; falls back to the input if it can't be parsed.\n */\nexport function retintHue(value: string, targetHue: number, scope?: Element | null): string {\n  const hsl = hexToHsl(value, scope);\n  if (!hsl) return value;\n  return hslToHex({ h: targetHue, s: hsl.s, l: hsl.l });\n}\n\nfunction mixToward(rgb: RGB, target: RGB, amount: number): RGB {\n  return {\n    r: rgb.r + (target.r - rgb.r) * amount,\n    g: rgb.g + (target.g - rgb.g) * amount,\n    b: rgb.b + (target.b - rgb.b) * amount,\n  };\n}\n\nfunction searchTowardPole(fg: RGB, bg: RGB, pole: RGB, targetRatio: number): RGB | null {\n  let lo = 0;\n  let hi = 1;\n  let best: RGB | null = null;\n  for (let i = 0; i < 24; i++) {\n    const mid = (lo + hi) / 2;\n    const candidate = mixToward(fg, pole, mid);\n    if (contrastRatio(candidate, bg) >= targetRatio) {\n      best = candidate;\n      hi = mid;\n    } else {\n      lo = mid;\n    }\n  }\n  if (!best) return null;\n  // Round to integer RGB and nudge toward pole until the rounded value still meets target.\n  let rounded: RGB = { r: Math.round(best.r), g: Math.round(best.g), b: Math.round(best.b) };\n  for (let step = 0; step < 16 && contrastRatio(rounded, bg) < targetRatio; step++) {\n    rounded = {\n      r: rounded.r + Math.sign(pole.r - rounded.r),\n      g: rounded.g + Math.sign(pole.g - rounded.g),\n      b: rounded.b + Math.sign(pole.b - rounded.b),\n    };\n  }\n  return contrastRatio(rounded, bg) >= targetRatio ? rounded : null;\n}\n\nexport function suggestAccessibleColor(fg: RGB, bg: RGB, targetRatio = 4.5): RGB | null {\n  if (contrastRatio(fg, bg) >= targetRatio) return fg;\n  const towardBlack = searchTowardPole(fg, bg, { r: 0, g: 0, b: 0 }, targetRatio);\n  const towardWhite = searchTowardPole(fg, bg, { r: 255, g: 255, b: 255 }, targetRatio);\n  if (towardBlack && towardWhite) {\n    const dBlack = colorDistance(fg, towardBlack);\n    const dWhite = colorDistance(fg, towardWhite);\n    return dBlack <= dWhite ? towardBlack : towardWhite;\n  }\n  return towardBlack ?? towardWhite;\n}\n\nfunction colorDistance(a: RGB, b: RGB): number {\n  const dr = a.r - b.r;\n  const dg = a.g - b.g;\n  const db = a.b - b.b;\n  return dr * dr + dg * dg + db * db;\n}\n\nexport interface TokenCandidate {\n  variable: string;\n  name: string;\n  rgb: RGB;\n}\n\nexport function suggestAccessibleToken(\n  fg: RGB,\n  bg: RGB,\n  targetRatio: number,\n  candidates: TokenCandidate[],\n): TokenCandidate | null {\n  const passing = candidates.filter((c) => contrastRatio(c.rgb, bg) >= targetRatio);\n  if (passing.length === 0) return null;\n  passing.sort((a, b) => colorDistance(fg, a.rgb) - colorDistance(fg, b.rgb));\n  return passing[0];\n}\n"],"mappings":"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","names":[]}

package/dist/lib/contrast.d.ts

@@ -0,0 +1,40 @@
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+export declare function resolveCssColor(value: string, scope?: Element | null): string;
+export declare function parseColor(value: string, scope?: Element | null): RGB | null;
+export declare function relativeLuminance({ r, g, b }: RGB): number;
+export declare function contrastRatio(fg: RGB, bg: RGB): number;
+export type WcagLevel = 'AAA' | 'AA' | 'AA-large' | 'fail';
+export declare function wcagLevel(ratio: number): WcagLevel;
+export declare function rgbToHex({ r, g, b }: RGB): string;
+export interface HSL {
+    /** Hue in degrees, 0–360. */
+    h: number;
+    /** Saturation, 0–100. */
+    s: number;
+    /** Lightness, 0–100. */
+    l: number;
+}
+export declare function rgbToHsl({ r, g, b }: RGB): HSL;
+export declare function hslToRgb({ h, s, l }: HSL): RGB;
+/** Convert a hex (or any parseable color) string to HSL. Returns null if unparseable. */
+export declare function hexToHsl(value: string, scope?: Element | null): HSL | null;
+/** Convert HSL back to a `#rrggbb` hex string. */
+export declare function hslToHex(hsl: HSL): string;
+/**
+ * Re-tint a color to a target hue while preserving its own saturation and
+ * lightness — used to recompute an accent ramp from a single brand hue.
+ * Returns a `#rrggbb` hex; falls back to the input if it can't be parsed.
+ */
+export declare function retintHue(value: string, targetHue: number, scope?: Element | null): string;
+export declare function suggestAccessibleColor(fg: RGB, bg: RGB, targetRatio?: number): RGB | null;
+export interface TokenCandidate {
+    variable: string;
+    name: string;
+    rgb: RGB;
+}
+export declare function suggestAccessibleToken(fg: RGB, bg: RGB, targetRatio: number, candidates: TokenCandidate[]): TokenCandidate | null;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/lib/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/lib/contrast.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AAExD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAY7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CA6B5E;AAOD,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAE1D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,GAAG,MAAM,CAKtD;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAKlD;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAGjD;AAED,MAAM,WAAW,GAAG;IAClB,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAoB9C;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAiB9C;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAG1E;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAI1F;AAqCD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,SAAM,GAAG,GAAG,GAAG,IAAI,CAUtF;AASD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;CACV;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,GAAG,EACP,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,cAAc,EAAE,GAC3B,cAAc,GAAG,IAAI,CAKvB"}

package/dist/lib/contrast.js

@@ -0,0 +1,189 @@
+function resolveCssColor(value, scope) {
+  const trimmed = value.trim();
+  const varMatch = trimmed.match(/^var\((--[\w-]+)(?:\s*,\s*([^)]+))?\)$/);
+  if (varMatch) {
+    const source = scope ?? (typeof document !== "undefined" ? document.documentElement : null);
+    if (source) {
+      const resolved = getComputedStyle(source).getPropertyValue(varMatch[1]).trim();
+      if (resolved) return resolveCssColor(resolved, scope);
+    }
+    if (varMatch[2]) return resolveCssColor(varMatch[2], scope);
+  }
+  return trimmed;
+}
+function parseColor(value, scope) {
+  const v = resolveCssColor(value, scope);
+  const hex = v.match(/^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i);
+  if (hex) {
+    const h = hex[1];
+    const expand = h.length === 3 || h.length === 4 ? h.split("").map((c) => c + c).join("") : h;
+    return {
+      r: parseInt(expand.slice(0, 2), 16),
+      g: parseInt(expand.slice(2, 4), 16),
+      b: parseInt(expand.slice(4, 6), 16)
+    };
+  }
+  const rgb = v.match(/^rgba?\(([^)]+)\)$/i);
+  if (rgb) {
+    const parts = rgb[1].split(/[\s,/]+/).filter(Boolean).slice(0, 3);
+    if (parts.length === 3) {
+      const [r, g, b] = parts.map((p) => {
+        const n = p.endsWith("%") ? parseFloat(p) * 255 / 100 : parseFloat(p);
+        return Math.round(n);
+      });
+      return { r, g, b };
+    }
+  }
+  return null;
+}
+function channelLuminance(c) {
+  const s = c / 255;
+  return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+}
+function relativeLuminance({ r, g, b }) {
+  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
+}
+function contrastRatio(fg, bg) {
+  const l1 = relativeLuminance(fg);
+  const l2 = relativeLuminance(bg);
+  const [lighter, darker] = l1 > l2 ? [l1, l2] : [l2, l1];
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function wcagLevel(ratio) {
+  if (ratio >= 7) return "AAA";
+  if (ratio >= 4.5) return "AA";
+  if (ratio >= 3) return "AA-large";
+  return "fail";
+}
+function rgbToHex({ r, g, b }) {
+  const c = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0");
+  return `#${c(r)}${c(g)}${c(b)}`;
+}
+function rgbToHsl({ r, g, b }) {
+  const rn = r / 255;
+  const gn = g / 255;
+  const bn = b / 255;
+  const max = Math.max(rn, gn, bn);
+  const min = Math.min(rn, gn, bn);
+  const d = max - min;
+  let h = 0;
+  if (d !== 0) {
+    switch (max) {
+      case rn:
+        h = (gn - bn) / d % 6;
+        break;
+      case gn:
+        h = (bn - rn) / d + 2;
+        break;
+      default:
+        h = (rn - gn) / d + 4;
+        break;
+    }
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  const l = (max + min) / 2;
+  const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));
+  return { h, s: s * 100, l: l * 100 };
+}
+function hslToRgb({ h, s, l }) {
+  const sn = Math.max(0, Math.min(100, s)) / 100;
+  const ln = Math.max(0, Math.min(100, l)) / 100;
+  const c = (1 - Math.abs(2 * ln - 1)) * sn;
+  const hp = (h % 360 + 360) % 360 / 60;
+  const x = c * (1 - Math.abs(hp % 2 - 1));
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hp < 1) [r, g, b] = [c, x, 0];
+  else if (hp < 2) [r, g, b] = [x, c, 0];
+  else if (hp < 3) [r, g, b] = [0, c, x];
+  else if (hp < 4) [r, g, b] = [0, x, c];
+  else if (hp < 5) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+  const m = ln - c / 2;
+  return { r: (r + m) * 255, g: (g + m) * 255, b: (b + m) * 255 };
+}
+function hexToHsl(value, scope) {
+  const rgb = parseColor(value, scope);
+  return rgb ? rgbToHsl(rgb) : null;
+}
+function hslToHex(hsl) {
+  return rgbToHex(hslToRgb(hsl));
+}
+function retintHue(value, targetHue, scope) {
+  const hsl = hexToHsl(value, scope);
+  if (!hsl) return value;
+  return hslToHex({ h: targetHue, s: hsl.s, l: hsl.l });
+}
+function mixToward(rgb, target, amount) {
+  return {
+    r: rgb.r + (target.r - rgb.r) * amount,
+    g: rgb.g + (target.g - rgb.g) * amount,
+    b: rgb.b + (target.b - rgb.b) * amount
+  };
+}
+function searchTowardPole(fg, bg, pole, targetRatio) {
+  let lo = 0;
+  let hi = 1;
+  let best = null;
+  for (let i = 0; i < 24; i++) {
+    const mid = (lo + hi) / 2;
+    const candidate = mixToward(fg, pole, mid);
+    if (contrastRatio(candidate, bg) >= targetRatio) {
+      best = candidate;
+      hi = mid;
+    } else {
+      lo = mid;
+    }
+  }
+  if (!best) return null;
+  let rounded = { r: Math.round(best.r), g: Math.round(best.g), b: Math.round(best.b) };
+  for (let step = 0; step < 16 && contrastRatio(rounded, bg) < targetRatio; step++) {
+    rounded = {
+      r: rounded.r + Math.sign(pole.r - rounded.r),
+      g: rounded.g + Math.sign(pole.g - rounded.g),
+      b: rounded.b + Math.sign(pole.b - rounded.b)
+    };
+  }
+  return contrastRatio(rounded, bg) >= targetRatio ? rounded : null;
+}
+function suggestAccessibleColor(fg, bg, targetRatio = 4.5) {
+  if (contrastRatio(fg, bg) >= targetRatio) return fg;
+  const towardBlack = searchTowardPole(fg, bg, { r: 0, g: 0, b: 0 }, targetRatio);
+  const towardWhite = searchTowardPole(fg, bg, { r: 255, g: 255, b: 255 }, targetRatio);
+  if (towardBlack && towardWhite) {
+    const dBlack = colorDistance(fg, towardBlack);
+    const dWhite = colorDistance(fg, towardWhite);
+    return dBlack <= dWhite ? towardBlack : towardWhite;
+  }
+  return towardBlack ?? towardWhite;
+}
+function colorDistance(a, b) {
+  const dr = a.r - b.r;
+  const dg = a.g - b.g;
+  const db = a.b - b.b;
+  return dr * dr + dg * dg + db * db;
+}
+function suggestAccessibleToken(fg, bg, targetRatio, candidates) {
+  const passing = candidates.filter((c) => contrastRatio(c.rgb, bg) >= targetRatio);
+  if (passing.length === 0) return null;
+  passing.sort((a, b) => colorDistance(fg, a.rgb) - colorDistance(fg, b.rgb));
+  return passing[0];
+}
+export {
+  contrastRatio,
+  hexToHsl,
+  hslToHex,
+  hslToRgb,
+  parseColor,
+  relativeLuminance,
+  resolveCssColor,
+  retintHue,
+  rgbToHex,
+  rgbToHsl,
+  suggestAccessibleColor,
+  suggestAccessibleToken,
+  wcagLevel
+};
+//# sourceMappingURL=contrast.js.map

package/dist/lib/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/contrast.ts"],"sourcesContent":["export interface RGB { r: number; g: number; b: number }\n\nexport function resolveCssColor(value: string, scope?: Element | null): string {\n  const trimmed = value.trim();\n  const varMatch = trimmed.match(/^var\\((--[\\w-]+)(?:\\s*,\\s*([^)]+))?\\)$/);\n  if (varMatch) {\n    const source = scope ?? (typeof document !== 'undefined' ? document.documentElement : null);\n    if (source) {\n      const resolved = getComputedStyle(source).getPropertyValue(varMatch[1]).trim();\n      if (resolved) return resolveCssColor(resolved, scope);\n    }\n    if (varMatch[2]) return resolveCssColor(varMatch[2], scope);\n  }\n  return trimmed;\n}\n\nexport function parseColor(value: string, scope?: Element | null): RGB | null {\n  const v = resolveCssColor(value, scope);\n\n  const hex = v.match(/^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i);\n  if (hex) {\n    const h = hex[1];\n    const expand = h.length === 3 || h.length === 4\n      ? h.split('').map((c) => c + c).join('')\n      : h;\n    return {\n      r: parseInt(expand.slice(0, 2), 16),\n      g: parseInt(expand.slice(2, 4), 16),\n      b: parseInt(expand.slice(4, 6), 16),\n    };\n  }\n\n  const rgb = v.match(/^rgba?\\(([^)]+)\\)$/i);\n  if (rgb) {\n    const parts = rgb[1].split(/[\\s,/]+/).filter(Boolean).slice(0, 3);\n    if (parts.length === 3) {\n      const [r, g, b] = parts.map((p) => {\n        const n = p.endsWith('%') ? (parseFloat(p) * 255) / 100 : parseFloat(p);\n        return Math.round(n);\n      });\n      return { r, g, b };\n    }\n  }\n\n  return null;\n}\n\nfunction channelLuminance(c: number): number {\n  const s = c / 255;\n  return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);\n}\n\nexport function relativeLuminance({ r, g, b }: RGB): number {\n  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);\n}\n\nexport function contrastRatio(fg: RGB, bg: RGB): number {\n  const l1 = relativeLuminance(fg);\n  const l2 = relativeLuminance(bg);\n  const [lighter, darker] = l1 > l2 ? [l1, l2] : [l2, l1];\n  return (lighter + 0.05) / (darker + 0.05);\n}\n\nexport type WcagLevel = 'AAA' | 'AA' | 'AA-large' | 'fail';\n\nexport function wcagLevel(ratio: number): WcagLevel {\n  if (ratio >= 7) return 'AAA';\n  if (ratio >= 4.5) return 'AA';\n  if (ratio >= 3) return 'AA-large';\n  return 'fail';\n}\n\nexport function rgbToHex({ r, g, b }: RGB): string {\n  const c = (n: number) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, '0');\n  return `#${c(r)}${c(g)}${c(b)}`;\n}\n\nexport interface HSL {\n  /** Hue in degrees, 0–360. */\n  h: number;\n  /** Saturation, 0–100. */\n  s: number;\n  /** Lightness, 0–100. */\n  l: number;\n}\n\nexport function rgbToHsl({ r, g, b }: RGB): HSL {\n  const rn = r / 255;\n  const gn = g / 255;\n  const bn = b / 255;\n  const max = Math.max(rn, gn, bn);\n  const min = Math.min(rn, gn, bn);\n  const d = max - min;\n  let h = 0;\n  if (d !== 0) {\n    switch (max) {\n      case rn: h = ((gn - bn) / d) % 6; break;\n      case gn: h = (bn - rn) / d + 2; break;\n      default: h = (rn - gn) / d + 4; break;\n    }\n    h *= 60;\n    if (h < 0) h += 360;\n  }\n  const l = (max + min) / 2;\n  const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));\n  return { h, s: s * 100, l: l * 100 };\n}\n\nexport function hslToRgb({ h, s, l }: HSL): RGB {\n  const sn = Math.max(0, Math.min(100, s)) / 100;\n  const ln = Math.max(0, Math.min(100, l)) / 100;\n  const c = (1 - Math.abs(2 * ln - 1)) * sn;\n  const hp = (((h % 360) + 360) % 360) / 60;\n  const x = c * (1 - Math.abs((hp % 2) - 1));\n  let r = 0;\n  let g = 0;\n  let b = 0;\n  if (hp < 1) [r, g, b] = [c, x, 0];\n  else if (hp < 2) [r, g, b] = [x, c, 0];\n  else if (hp < 3) [r, g, b] = [0, c, x];\n  else if (hp < 4) [r, g, b] = [0, x, c];\n  else if (hp < 5) [r, g, b] = [x, 0, c];\n  else [r, g, b] = [c, 0, x];\n  const m = ln - c / 2;\n  return { r: (r + m) * 255, g: (g + m) * 255, b: (b + m) * 255 };\n}\n\n/** Convert a hex (or any parseable color) string to HSL. Returns null if unparseable. */\nexport function hexToHsl(value: string, scope?: Element | null): HSL | null {\n  const rgb = parseColor(value, scope);\n  return rgb ? rgbToHsl(rgb) : null;\n}\n\n/** Convert HSL back to a `#rrggbb` hex string. */\nexport function hslToHex(hsl: HSL): string {\n  return rgbToHex(hslToRgb(hsl));\n}\n\n/**\n * Re-tint a color to a target hue while preserving its own saturation and\n * lightness — used to recompute an accent ramp from a single brand hue.\n * Returns a `#rrggbb` hex; falls back to the input if it can't be parsed.\n */\nexport function retintHue(value: string, targetHue: number, scope?: Element | null): string {\n  const hsl = hexToHsl(value, scope);\n  if (!hsl) return value;\n  return hslToHex({ h: targetHue, s: hsl.s, l: hsl.l });\n}\n\nfunction mixToward(rgb: RGB, target: RGB, amount: number): RGB {\n  return {\n    r: rgb.r + (target.r - rgb.r) * amount,\n    g: rgb.g + (target.g - rgb.g) * amount,\n    b: rgb.b + (target.b - rgb.b) * amount,\n  };\n}\n\nfunction searchTowardPole(fg: RGB, bg: RGB, pole: RGB, targetRatio: number): RGB | null {\n  let lo = 0;\n  let hi = 1;\n  let best: RGB | null = null;\n  for (let i = 0; i < 24; i++) {\n    const mid = (lo + hi) / 2;\n    const candidate = mixToward(fg, pole, mid);\n    if (contrastRatio(candidate, bg) >= targetRatio) {\n      best = candidate;\n      hi = mid;\n    } else {\n      lo = mid;\n    }\n  }\n  if (!best) return null;\n  // Round to integer RGB and nudge toward pole until the rounded value still meets target.\n  let rounded: RGB = { r: Math.round(best.r), g: Math.round(best.g), b: Math.round(best.b) };\n  for (let step = 0; step < 16 && contrastRatio(rounded, bg) < targetRatio; step++) {\n    rounded = {\n      r: rounded.r + Math.sign(pole.r - rounded.r),\n      g: rounded.g + Math.sign(pole.g - rounded.g),\n      b: rounded.b + Math.sign(pole.b - rounded.b),\n    };\n  }\n  return contrastRatio(rounded, bg) >= targetRatio ? rounded : null;\n}\n\nexport function suggestAccessibleColor(fg: RGB, bg: RGB, targetRatio = 4.5): RGB | null {\n  if (contrastRatio(fg, bg) >= targetRatio) return fg;\n  const towardBlack = searchTowardPole(fg, bg, { r: 0, g: 0, b: 0 }, targetRatio);\n  const towardWhite = searchTowardPole(fg, bg, { r: 255, g: 255, b: 255 }, targetRatio);\n  if (towardBlack && towardWhite) {\n    const dBlack = colorDistance(fg, towardBlack);\n    const dWhite = colorDistance(fg, towardWhite);\n    return dBlack <= dWhite ? towardBlack : towardWhite;\n  }\n  return towardBlack ?? towardWhite;\n}\n\nfunction colorDistance(a: RGB, b: RGB): number {\n  const dr = a.r - b.r;\n  const dg = a.g - b.g;\n  const db = a.b - b.b;\n  return dr * dr + dg * dg + db * db;\n}\n\nexport interface TokenCandidate {\n  variable: string;\n  name: string;\n  rgb: RGB;\n}\n\nexport function suggestAccessibleToken(\n  fg: RGB,\n  bg: RGB,\n  targetRatio: number,\n  candidates: TokenCandidate[],\n): TokenCandidate | null {\n  const passing = candidates.filter((c) => contrastRatio(c.rgb, bg) >= targetRatio);\n  if (passing.length === 0) return null;\n  passing.sort((a, b) => colorDistance(fg, a.rgb) - colorDistance(fg, b.rgb));\n  return passing[0];\n}\n"],"mappings":"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","names":[]}

package/dist/lib/currencies.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var currencies_exports = {};
+__export(currencies_exports, {
+  CURATED_CURRENCIES: () => CURATED_CURRENCIES,
+  findCurrency: () => findCurrency
+});
+module.exports = __toCommonJS(currencies_exports);
+const CURATED_CURRENCIES = [
+  // ── Tier-1 majors ──
+  { code: "USD", name: "US Dollar", symbol: "$", decimals: 2 },
+  { code: "EUR", name: "Euro", symbol: "\u20AC", decimals: 2 },
+  { code: "GBP", name: "British Pound", symbol: "\xA3", decimals: 2 },
+  { code: "JPY", name: "Japanese Yen", symbol: "\xA5", decimals: 0 },
+  { code: "CHF", name: "Swiss Franc", symbol: "CHF", decimals: 2 },
+  // ── Other G10 / common B2B ──
+  { code: "CAD", name: "Canadian Dollar", symbol: "CA$", decimals: 2 },
+  { code: "AUD", name: "Australian Dollar", symbol: "A$", decimals: 2 },
+  { code: "NZD", name: "New Zealand Dollar", symbol: "NZ$", decimals: 2 },
+  { code: "SEK", name: "Swedish Krona", symbol: "kr", decimals: 2 },
+  { code: "NOK", name: "Norwegian Krone", symbol: "kr", decimals: 2 },
+  { code: "DKK", name: "Danish Krone", symbol: "kr", decimals: 2 },
+  // ── Asia-Pacific ──
+  { code: "CNY", name: "Chinese Yuan", symbol: "\xA5", decimals: 2 },
+  { code: "HKD", name: "Hong Kong Dollar", symbol: "HK$", decimals: 2 },
+  { code: "SGD", name: "Singapore Dollar", symbol: "S$", decimals: 2 },
+  { code: "KRW", name: "South Korean Won", symbol: "\u20A9", decimals: 0 },
+  { code: "INR", name: "Indian Rupee", symbol: "\u20B9", decimals: 2 },
+  // ── Other regions ──
+  { code: "BRL", name: "Brazilian Real", symbol: "R$", decimals: 2 },
+  { code: "MXN", name: "Mexican Peso", symbol: "MX$", decimals: 2 },
+  { code: "ZAR", name: "South African Rand", symbol: "R", decimals: 2 },
+  { code: "AED", name: "UAE Dirham", symbol: "\u062F.\u0625", decimals: 2 },
+  { code: "ILS", name: "Israeli Shekel", symbol: "\u20AA", decimals: 2 }
+];
+const BY_CODE = new Map(CURATED_CURRENCIES.map((c) => [c.code, c]));
+function findCurrency(code, list = CURATED_CURRENCIES) {
+  if (list === CURATED_CURRENCIES) return BY_CODE.get(code);
+  return list.find((c) => c.code === code);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CURATED_CURRENCIES,
+  findCurrency
+});
+//# sourceMappingURL=currencies.cjs.map

package/dist/lib/currencies.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/currencies.ts"],"sourcesContent":["/**\n * Curated currency list backing the CurrencyInput picker. ~20 entries\n * covering the regions most B2B / fintech apps actually transact in.\n * Consumers needing different coverage pass a custom `currencies`\n * prop to CurrencyInput.\n *\n * Each entry carries:\n *   - `code`     ISO 4217 alpha-3 code (the canonical key, e.g. \"USD\")\n *   - `name`     English currency name (display in the picker)\n *   - `symbol`   Display glyph (`$`, `€`, `¥`, `kr`, …)\n *   - `decimals` Standard decimal places (USD/EUR → 2, JPY/KRW → 0,\n *                BHD/KWD → 3). Drives Intl.NumberFormat output and\n *                the input's mask precision.\n *\n * Symbol vs. code rendering convention: the picker shows the symbol\n * inline with the code (e.g. `$ USD`); this lets users disambiguate\n * `$` (which spans USD, CAD, AUD, MXN, etc.) at a glance without\n * needing a flag.\n */\n\nexport interface Currency {\n  code: string;\n  name: string;\n  symbol: string;\n  decimals: number;\n}\n\nexport const CURATED_CURRENCIES: Currency[] = [\n  // ── Tier-1 majors ──\n  { code: 'USD', name: 'US Dollar', symbol: '$', decimals: 2 },\n  { code: 'EUR', name: 'Euro', symbol: '€', decimals: 2 },\n  { code: 'GBP', name: 'British Pound', symbol: '£', decimals: 2 },\n  { code: 'JPY', name: 'Japanese Yen', symbol: '¥', decimals: 0 },\n  { code: 'CHF', name: 'Swiss Franc', symbol: 'CHF', decimals: 2 },\n  // ── Other G10 / common B2B ──\n  { code: 'CAD', name: 'Canadian Dollar', symbol: 'CA$', decimals: 2 },\n  { code: 'AUD', name: 'Australian Dollar', symbol: 'A$', decimals: 2 },\n  { code: 'NZD', name: 'New Zealand Dollar', symbol: 'NZ$', decimals: 2 },\n  { code: 'SEK', name: 'Swedish Krona', symbol: 'kr', decimals: 2 },\n  { code: 'NOK', name: 'Norwegian Krone', symbol: 'kr', decimals: 2 },\n  { code: 'DKK', name: 'Danish Krone', symbol: 'kr', decimals: 2 },\n  // ── Asia-Pacific ──\n  { code: 'CNY', name: 'Chinese Yuan', symbol: '¥', decimals: 2 },\n  { code: 'HKD', name: 'Hong Kong Dollar', symbol: 'HK$', decimals: 2 },\n  { code: 'SGD', name: 'Singapore Dollar', symbol: 'S$', decimals: 2 },\n  { code: 'KRW', name: 'South Korean Won', symbol: '₩', decimals: 0 },\n  { code: 'INR', name: 'Indian Rupee', symbol: '₹', decimals: 2 },\n  // ── Other regions ──\n  { code: 'BRL', name: 'Brazilian Real', symbol: 'R$', decimals: 2 },\n  { code: 'MXN', name: 'Mexican Peso', symbol: 'MX$', decimals: 2 },\n  { code: 'ZAR', name: 'South African Rand', symbol: 'R', decimals: 2 },\n  { code: 'AED', name: 'UAE Dirham', symbol: 'د.إ', decimals: 2 },\n  { code: 'ILS', name: 'Israeli Shekel', symbol: '₪', decimals: 2 },\n];\n\nconst BY_CODE = new Map(CURATED_CURRENCIES.map((c) => [c.code, c]));\n\n/** Lookup helper for components that need a currency by its ISO code. */\nexport function findCurrency(\n  code: string,\n  list: Currency[] = CURATED_CURRENCIES,\n): Currency | undefined {\n  if (list === CURATED_CURRENCIES) return BY_CODE.get(code);\n  return list.find((c) => c.code === code);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BO,MAAM,qBAAiC;AAAA;AAAA,EAE5C,EAAE,MAAM,OAAO,MAAM,aAAa,QAAQ,KAAK,UAAU,EAAE;AAAA,EAC3D,EAAE,MAAM,OAAO,MAAM,QAAQ,QAAQ,UAAK,UAAU,EAAE;AAAA,EACtD,EAAE,MAAM,OAAO,MAAM,iBAAiB,QAAQ,QAAK,UAAU,EAAE;AAAA,EAC/D,EAAE,MAAM,OAAO,MAAM,gBAAgB,QAAQ,QAAK,UAAU,EAAE;AAAA,EAC9D,EAAE,MAAM,OAAO,MAAM,eAAe,QAAQ,OAAO,UAAU,EAAE;AAAA;AAAA,EAE/D,EAAE,MAAM,OAAO,MAAM,mBAAmB,QAAQ,OAAO,UAAU,EAAE;AAAA,EACnE,EAAE,MAAM,OAAO,MAAM,qBAAqB,QAAQ,MAAM,UAAU,EAAE;AAAA,EACpE,EAAE,MAAM,OAAO,MAAM,sBAAsB,QAAQ,OAAO,UAAU,EAAE;AAAA,EACtE,EAAE,MAAM,OAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,EAAE;AAAA,EAChE,EAAE,MAAM,OAAO,MAAM,mBAAmB,QAAQ,MAAM,UAAU,EAAE;AAAA,EAClE,EAAE,MAAM,OAAO,MAAM,gBAAgB,QAAQ,MAAM,UAAU,EAAE;AAAA;AAAA,EAE/D,EAAE,MAAM,OAAO,MAAM,gBAAgB,QAAQ,QAAK,UAAU,EAAE;AAAA,EAC9D,EAAE,MAAM,OAAO,MAAM,oBAAoB,QAAQ,OAAO,UAAU,EAAE;AAAA,EACpE,EAAE,MAAM,OAAO,MAAM,oBAAoB,QAAQ,MAAM,UAAU,EAAE;AAAA,EACnE,EAAE,MAAM,OAAO,MAAM,oBAAoB,QAAQ,UAAK,UAAU,EAAE;AAAA,EAClE,EAAE,MAAM,OAAO,MAAM,gBAAgB,QAAQ,UAAK,UAAU,EAAE;AAAA;AAAA,EAE9D,EAAE,MAAM,OAAO,MAAM,kBAAkB,QAAQ,MAAM,UAAU,EAAE;AAAA,EACjE,EAAE,MAAM,OAAO,MAAM,gBAAgB,QAAQ,OAAO,UAAU,EAAE;AAAA,EAChE,EAAE,MAAM,OAAO,MAAM,sBAAsB,QAAQ,KAAK,UAAU,EAAE;AAAA,EACpE,EAAE,MAAM,OAAO,MAAM,cAAc,QAAQ,iBAAO,UAAU,EAAE;AAAA,EAC9D,EAAE,MAAM,OAAO,MAAM,kBAAkB,QAAQ,UAAK,UAAU,EAAE;AAClE;AAEA,MAAM,UAAU,IAAI,IAAI,mBAAmB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAG3D,SAAS,aACd,MACA,OAAmB,oBACG;AACtB,MAAI,SAAS,mBAAoB,QAAO,QAAQ,IAAI,IAAI;AACxD,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AACzC;","names":[]}