raqam 0.3.2 → 0.4.0

package/dist/{index-BMFJwudG.d.ts → types-B2ZqkJI-.d.ts}

@@ -1,7 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
-import React__default, { RefObject } from 'react';
-
 interface LocaleInfo {
     /** Decimal separator for this locale (e.g. "." en-US, "," de-DE, "٫" fa-IR) */
     decimalSeparator: string;
@@ -44,7 +40,13 @@ interface UseNumberFieldStateOptions {
     defaultValue?: number | null;
     /** Fires on every meaningful value change */
     onChange?: (value: number | null) => void;
-    /** BCP 47 locale tag (default: browser locale) */
+    /**
+     * BCP 47 locale tag. When omitted, the runtime default is used — the browser
+     * locale on the client, but the host's ICU/OS locale on the server. For SSR,
+     * pass an explicit `locale` so the server and first client render format
+     * identically; otherwise the initial formatted value can differ and trigger a
+     * React hydration mismatch.
+     */
     locale?: string;
     /** Full Intl.NumberFormatOptions — currency, percent, decimal, etc. */
     formatOptions?: Intl.NumberFormatOptions;
@@ -147,6 +149,13 @@ interface NumberFieldState {
     _setLastChangeReason: (reason: ChangeReason) => void;
     /** Internal: read the current change reason (used by NumberField.Root) */
     _getLastChangeReason: () => ChangeReason;
+    /**
+     * Internal: read the display string that matches the value most recently
+     * emitted via onChange. Updated synchronously before the state setter, so it is
+     * accurate at onChange time (unlike `inputValue`, which still reflects the
+     * previous render). Used by NumberField.Root to report `formattedValue`.
+     */
+    _getLatestDisplay: () => string;
     /**
      * Update display string (triggers parse + onChange). `knownValue` overrides
      * the parsed value when `val` is a formatted string that cannot be reversed
@@ -193,6 +202,10 @@ interface UseNumberFieldProps extends UseNumberFieldStateOptions {
     stepHoldDelay?: number;
     /** Initial milliseconds between repeats during press-and-hold (default: 200) */
     stepHoldInterval?: number;
+    /** Accessible label for the increment button (default: "Increase") */
+    incrementLabel?: string;
+    /** Accessible label for the decrement button (default: "Decrease") */
+    decrementLabel?: string;
     onFocus?: (e: React.FocusEvent<HTMLInputElement>) => void;
     onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void;
     /**
@@ -221,7 +234,14 @@ interface NumberFieldAria {
     hiddenInputProps: React.InputHTMLAttributes<HTMLInputElement> | null;
     incrementButtonProps: React.ButtonHTMLAttributes<HTMLButtonElement>;
     decrementButtonProps: React.ButtonHTMLAttributes<HTMLButtonElement>;
-    descriptionProps: React.HTMLAttributes<HTMLElement>;
+    descriptionProps: React.HTMLAttributes<HTMLElement> & {
+        /**
+         * Registration ref — spread it onto the rendered description element so the
+         * input's `aria-describedby` only points here while a description is mounted
+         * (mirrors `labelProps.ref`, avoiding a dangling reference otherwise).
+         */
+        ref?: React.RefCallback<HTMLElement>;
+    };
     errorMessageProps: React.HTMLAttributes<HTMLElement>;
 }
 interface ScrubAreaOptions {
@@ -232,8 +252,14 @@ interface ScrubAreaOptions {
      * - 'both': uses whichever axis has greater movement
      */
     direction?: "horizontal" | "vertical" | "both";
-    /** Pixels of drag movement required for one step (default: 4) */
+    /**
+     * Pixels of drag movement required for one step (default: 4). Values below 1
+     * are clamped to 1 to keep stepping bounded (0 or negative would otherwise
+     * loop forever).
+     */
     pixelSensitivity?: number;
+    /** Accessible label for the scrub area (default: "Scrub to change value") */
+    label?: string;
 }
 type StateRenderFn = (props: Record<string, unknown>, state: NumberFieldState) => React.ReactElement;
 type RenderProp = React.ReactElement | StateRenderFn;
@@ -259,103 +285,4 @@ interface NumberFieldRootProps extends UseNumberFieldProps {
     }) => void;
 }
 
-declare function useNumberFieldState(options: UseNumberFieldStateOptions): NumberFieldState;
-
-declare function useNumberField(props: UseNumberFieldProps, state: NumberFieldState, inputRef: React.RefObject<HTMLInputElement | null>): NumberFieldAria;
-
-type FormatOptions = Pick<UseNumberFieldStateOptions, "locale" | "formatOptions" | "prefix" | "suffix" | "minimumFractionDigits" | "maximumFractionDigits" | "fixedDecimalScale">;
-/**
- * Lightweight display-only formatting hook. Returns the formatted string for
- * a numeric value using the same Intl.NumberFormat engine as the full input.
- *
- * Use this when you need to display a formatted number in a read-only context
- * (table cells, summaries, labels) without the overhead of a full input state machine.
- *
- * @example
- * const price = useNumberFieldFormat(1234567.89, {
- *   locale: 'en-US',
- *   formatOptions: { style: 'currency', currency: 'USD' },
- * })
- * // price === "$1,234,567.89"
- *
- * @example
- * const pct = useNumberFieldFormat(0.4267, {
- *   formatOptions: { style: 'percent', maximumFractionDigits: 1 },
- * })
- * // pct === "42.7%"
- */
-declare function useNumberFieldFormat(value: number | null, options?: FormatOptions): string;
-
-interface UseControllableStateOptions<T> {
-    value?: T;
-    defaultValue?: T;
-    onChange?: (value: T) => void;
-}
-/**
- * Manages controlled vs uncontrolled state.
- * - If `value` is provided, the component is controlled.
- * - Otherwise it manages its own state starting from `defaultValue`.
- * Warns in dev mode if the component switches between controlled/uncontrolled.
- */
-declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateOptions<T>): [
-    T | undefined,
-    (next: T | ((prev: T | undefined) => T)) => void
-];
-
-interface LabelProps extends React__default.LabelHTMLAttributes<HTMLLabelElement> {
-    render?: RenderProp;
-    children?: React__default.ReactNode;
-}
-interface GroupProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    render?: RenderProp;
-    children?: React__default.ReactNode;
-}
-interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type"> {
-    render?: RenderProp;
-}
-interface IncrementProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
-    render?: RenderProp;
-    children?: React__default.ReactNode;
-}
-interface DecrementProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
-    render?: RenderProp;
-    children?: React__default.ReactNode;
-}
-interface DescriptionProps extends React__default.HTMLAttributes<HTMLParagraphElement> {
-    children?: React__default.ReactNode;
-}
-interface ErrorMessageProps extends React__default.HTMLAttributes<HTMLParagraphElement> {
-    children?: React__default.ReactNode;
-}
-interface FormattedProps extends React__default.HTMLAttributes<HTMLSpanElement> {
-    render?: RenderProp;
-}
-declare const NumberField: {
-    Root: React__default.ForwardRefExoticComponent<NumberFieldRootProps & React__default.RefAttributes<HTMLDivElement>>;
-    Label: React__default.ForwardRefExoticComponent<LabelProps & React__default.RefAttributes<HTMLLabelElement>>;
-    Group: React__default.ForwardRefExoticComponent<GroupProps & React__default.RefAttributes<HTMLDivElement>>;
-    Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
-    Increment: React__default.ForwardRefExoticComponent<IncrementProps & React__default.RefAttributes<HTMLButtonElement>>;
-    Decrement: React__default.ForwardRefExoticComponent<DecrementProps & React__default.RefAttributes<HTMLButtonElement>>;
-    HiddenInput: () => react_jsx_runtime.JSX.Element | null;
-    ScrubArea: React__default.ForwardRefExoticComponent<ScrubAreaProps & React__default.RefAttributes<HTMLSpanElement>>;
-    ScrubAreaCursor: React__default.ForwardRefExoticComponent<ScrubAreaCursorProps & React__default.RefAttributes<HTMLSpanElement>>;
-    Description: React__default.ForwardRefExoticComponent<DescriptionProps & React__default.RefAttributes<HTMLParagraphElement>>;
-    ErrorMessage: React__default.ForwardRefExoticComponent<ErrorMessageProps & React__default.RefAttributes<HTMLParagraphElement>>;
-    Formatted: React__default.ForwardRefExoticComponent<FormattedProps & React__default.RefAttributes<HTMLSpanElement>>;
-};
-
-interface NumberFieldContextValue {
-    state: NumberFieldState;
-    aria: NumberFieldAria;
-    inputRef: RefObject<HTMLInputElement | null>;
-    props: UseNumberFieldProps;
-}
-declare const NumberFieldContext: React$1.Context<NumberFieldContextValue | null>;
-/**
- * Hook for sub-components to access the NumberField context.
- * Throws if used outside NumberField.Root.
- */
-declare function useNumberFieldContext(): NumberFieldContextValue;
-
-export { type CaretBoundary as C, type DigitBlock as D, type FormatResult as F, type LocaleInfo as L, type NumberFieldState as N, type ParseResult as P, type RenderProp as R, type ScrubAreaOptions as S, type UseNumberFieldProps as U, type ChangeReason as a, NumberField as b, type NumberFieldAria as c, NumberFieldContext as d, type NumberFieldContextValue as e, type NumberFieldRootProps as f, type ScrubAreaCursorProps as g, type ScrubAreaProps as h, type StateRenderFn as i, type UseNumberFieldStateOptions as j, useNumberField as k, useNumberFieldContext as l, useNumberFieldFormat as m, useNumberFieldState as n, useControllableState as u };
+export type { CaretBoundary as C, DigitBlock as D, FormatResult as F, LocaleInfo as L, NumberFieldState as N, ParseResult as P, RenderProp as R, ScrubAreaOptions as S, UseNumberFieldProps as U, ChangeReason as a, NumberFieldAria as b, NumberFieldRootProps as c, ScrubAreaCursorProps as d, ScrubAreaProps as e, StateRenderFn as f, UseNumberFieldStateOptions as g };

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "raqam",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "The definitive React number input: live formatting, full i18n, headless, accessible",
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/locales/*.js",
+    "./dist/locales/*.cjs",
+    "./dist/chunk-*.js",
+    "./dist/chunk-*.cjs"
+  ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "author": "47vigen",
   "license": "MIT",
-  "homepage": "https://47vigen.github.io/raqam",
+  "homepage": "https://raqam.vercel.app",
   "repository": {
     "type": "git",
     "url": "https://github.com/47vigen/raqam"
@@ -29,6 +34,9 @@
       "react": [
         "./dist/react.d.ts"
       ],
+      "locales": [
+        "./dist/locales/index.d.ts"
+      ],
       "locales/*": [
         "./dist/locales/*.d.ts"
       ],
@@ -68,6 +76,16 @@
         "default": "./dist/react.cjs"
       }
     },
+    "./locales": {
+      "import": {
+        "types": "./dist/locales/index.d.ts",
+        "default": "./dist/locales/index.js"
+      },
+      "require": {
+        "types": "./dist/locales/index.d.cts",
+        "default": "./dist/locales/index.cjs"
+      }
+    },
     "./locales/*": {
       "import": {
         "types": "./dist/locales/*.d.ts",
@@ -87,13 +105,17 @@
         "types": "./dist/core.d.cts",
         "default": "./dist/core.cjs"
       }
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
+  "engines": {
+    "node": ">=20.9"
+  },
   "keywords": [
     "react",
     "number",
@@ -164,8 +186,8 @@
     "test:e2e": "playwright test -c playwright-ct.config.ts",
     "test:e2e:ui": "playwright test -c playwright-ct.config.ts --ui",
     "test:e2e:debug": "playwright test -c playwright-ct.config.ts --headed --project=chromium",
-    "docs:dev": "cd docs && pnpm astro dev",
-    "docs:build": "pnpm build && cd docs && pnpm astro build",
+    "docs:dev": "pnpm --filter raqam-docs dev",
+    "docs:build": "pnpm --filter raqam-docs build",
     "release:beta": "changeset version --snapshot beta && changeset publish --tag beta"
   }
 }

package/dist/chunk-4AMLNJEK.js

@@ -1,14 +0,0 @@
-import { registerLocale } from './chunk-TISOJTKH.js';
-
-// src/locales/ar.ts
-registerLocale({
-  digitBlocks: [
-    [1632, 1641]
-    // Arabic-Indic ٠–٩
-  ]
-});
-var LOCALE_CODES = ["ar", "ar-EG", "ar-SA", "ar-MA", "ar-DZ", "ar-TN"];
-
-export { LOCALE_CODES };
-//# sourceMappingURL=chunk-4AMLNJEK.js.map
-//# sourceMappingURL=chunk-4AMLNJEK.js.map

package/dist/chunk-4AMLNJEK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/locales/ar.ts"],"names":[],"mappings":";;;AAUA,cAAA,CAAe;AAAA,EACb,WAAA,EAAa;AAAA,IACX,CAAC,MAAQ,IAAM;AAAA;AAAA;AAEnB,CAAC,CAAA;AAGM,IAAM,eAAe,CAAC,IAAA,EAAM,SAAS,OAAA,EAAS,OAAA,EAAS,SAAS,OAAO","file":"chunk-4AMLNJEK.js","sourcesContent":["/**\n * Arabic (ar) locale plugin.\n *\n * Registers Arabic-Indic digit block (U+0660–U+0669).\n *\n * Usage:\n *   import 'raqam/locales/ar'\n */\nimport { registerLocale } from \"../core/normalizer.js\";\n\nregisterLocale({\n  digitBlocks: [\n    [0x0660, 0x0669], // Arabic-Indic ٠–٩\n  ],\n});\n\n/** BCP 47 locale tags that this plugin covers. */\nexport const LOCALE_CODES = [\"ar\", \"ar-EG\", \"ar-SA\", \"ar-MA\", \"ar-DZ\", \"ar-TN\"] as const;\n"]}

package/dist/chunk-7IEJOMYT.js

@@ -1,14 +0,0 @@
-import { registerLocale } from './chunk-TISOJTKH.js';
-
-// src/locales/bn.ts
-registerLocale({
-  digitBlocks: [
-    [2534, 2543]
-    // Bengali ০–৯
-  ]
-});
-var LOCALE_CODES = ["bn", "bn-BD", "bn-IN"];
-
-export { LOCALE_CODES };
-//# sourceMappingURL=chunk-7IEJOMYT.js.map
-//# sourceMappingURL=chunk-7IEJOMYT.js.map

package/dist/chunk-7IEJOMYT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/locales/bn.ts"],"names":[],"mappings":";;;AAUA,cAAA,CAAe;AAAA,EACb,WAAA,EAAa;AAAA,IACX,CAAC,MAAQ,IAAM;AAAA;AAAA;AAEnB,CAAC,CAAA;AAGM,IAAM,YAAA,GAAe,CAAC,IAAA,EAAM,OAAA,EAAS,OAAO","file":"chunk-7IEJOMYT.js","sourcesContent":["/**\n * Bengali (bn-BD / bn-IN) locale plugin.\n *\n * Registers Bengali digit block (U+09E6–U+09EF).\n *\n * Usage:\n *   import 'raqam/locales/bn'\n */\nimport { registerLocale } from \"../core/normalizer.js\";\n\nregisterLocale({\n  digitBlocks: [\n    [0x09e6, 0x09ef], // Bengali ০–৯\n  ],\n});\n\n/** BCP 47 locale tags that this plugin covers. */\nexport const LOCALE_CODES = [\"bn\", \"bn-BD\", \"bn-IN\"] as const;\n"]}

package/dist/chunk-HPUEM7JB.js

@@ -1,14 +0,0 @@
-import { registerLocale } from './chunk-TISOJTKH.js';
-
-// src/locales/th.ts
-registerLocale({
-  digitBlocks: [
-    [3664, 3673]
-    // Thai ๐–๙
-  ]
-});
-var LOCALE_CODES = ["th", "th-TH"];
-
-export { LOCALE_CODES };
-//# sourceMappingURL=chunk-HPUEM7JB.js.map
-//# sourceMappingURL=chunk-HPUEM7JB.js.map

package/dist/chunk-HPUEM7JB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/locales/th.ts"],"names":[],"mappings":";;;AAUA,cAAA,CAAe;AAAA,EACb,WAAA,EAAa;AAAA,IACX,CAAC,MAAQ,IAAM;AAAA;AAAA;AAEnB,CAAC,CAAA;AAGM,IAAM,YAAA,GAAe,CAAC,IAAA,EAAM,OAAO","file":"chunk-HPUEM7JB.js","sourcesContent":["/**\n * Thai (th-TH) locale plugin.\n *\n * Registers Thai digit block (U+0E50–U+0E59).\n *\n * Usage:\n *   import 'raqam/locales/th'\n */\nimport { registerLocale } from \"../core/normalizer.js\";\n\nregisterLocale({\n  digitBlocks: [\n    [0x0e50, 0x0e59], // Thai ๐–๙\n  ],\n});\n\n/** BCP 47 locale tags that this plugin covers. */\nexport const LOCALE_CODES = [\"th\", \"th-TH\"] as const;\n"]}

package/dist/chunk-OLLREWX6.js

@@ -1,16 +0,0 @@
-import { registerLocale } from './chunk-TISOJTKH.js';
-
-// src/locales/fa.ts
-registerLocale({
-  digitBlocks: [
-    [1776, 1785],
-    // Extended Arabic-Indic (Persian) ۰–۹
-    [1632, 1641]
-    // Arabic-Indic ٠–٩
-  ]
-});
-var LOCALE_CODES = ["fa", "fa-IR", "fa-AF"];
-
-export { LOCALE_CODES };
-//# sourceMappingURL=chunk-OLLREWX6.js.map
-//# sourceMappingURL=chunk-OLLREWX6.js.map

package/dist/chunk-OLLREWX6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/locales/fa.ts"],"names":[],"mappings":";;;AAeA,cAAA,CAAe;AAAA,EACb,WAAA,EAAa;AAAA,IACX,CAAC,MAAQ,IAAM,CAAA;AAAA;AAAA,IACf,CAAC,MAAQ,IAAM;AAAA;AAAA;AAEnB,CAAC,CAAA;AAGM,IAAM,YAAA,GAAe,CAAC,IAAA,EAAM,OAAA,EAAS,OAAO","file":"chunk-OLLREWX6.js","sourcesContent":["/**\n * Persian (fa-IR) locale plugin.\n *\n * Registers Extended Arabic-Indic digit block (U+06F0–U+06F9).\n * The ISIRI 9147 keyboard produces these codepoints when number keys are\n * pressed on a Persian layout. This side-effect import enables their\n * normalization to ASCII 0–9 before parsing.\n *\n * Also registers the Arabic-Indic block for mixed-input scenarios.\n *\n * Usage:\n *   import 'raqam/locales/fa'\n */\nimport { registerLocale } from \"../core/normalizer.js\";\n\nregisterLocale({\n  digitBlocks: [\n    [0x06f0, 0x06f9], // Extended Arabic-Indic (Persian) ۰–۹\n    [0x0660, 0x0669], // Arabic-Indic ٠–٩\n  ],\n});\n\n/** BCP 47 locale tags that this plugin covers. */\nexport const LOCALE_CODES = [\"fa\", \"fa-IR\", \"fa-AF\"] as const;\n"]}

package/dist/chunk-RP3DVBGJ.js

@@ -1,14 +0,0 @@
-import { registerLocale } from './chunk-TISOJTKH.js';
-
-// src/locales/hi.ts
-registerLocale({
-  digitBlocks: [
-    [2406, 2415]
-    // Devanagari ०–९
-  ]
-});
-var LOCALE_CODES = ["hi", "hi-IN", "mr", "mr-IN", "ne", "ne-NP"];
-
-export { LOCALE_CODES };
-//# sourceMappingURL=chunk-RP3DVBGJ.js.map
-//# sourceMappingURL=chunk-RP3DVBGJ.js.map

package/dist/chunk-RP3DVBGJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/locales/hi.ts"],"names":[],"mappings":";;;AAUA,cAAA,CAAe;AAAA,EACb,WAAA,EAAa;AAAA,IACX,CAAC,MAAQ,IAAM;AAAA;AAAA;AAEnB,CAAC,CAAA;AAGM,IAAM,eAAe,CAAC,IAAA,EAAM,SAAS,IAAA,EAAM,OAAA,EAAS,MAAM,OAAO","file":"chunk-RP3DVBGJ.js","sourcesContent":["/**\n * Hindi / Devanagari (hi-IN) locale plugin.\n *\n * Registers Devanagari digit block (U+0966–U+096F).\n *\n * Usage:\n *   import 'raqam/locales/hi'\n */\nimport { registerLocale } from \"../core/normalizer.js\";\n\nregisterLocale({\n  digitBlocks: [\n    [0x0966, 0x096f], // Devanagari ०–९\n  ],\n});\n\n/** BCP 47 locale tags that this plugin covers. */\nexport const LOCALE_CODES = [\"hi\", \"hi-IN\", \"mr\", \"mr-IN\", \"ne\", \"ne-NP\"] as const;\n"]}

package/dist/chunk-TISOJTKH.js

@@ -1,25 +0,0 @@
-// src/core/normalizer.ts
-var BUILTIN_DIGIT_BLOCKS = [
-  [1632, 1641],
-  // Arabic-Indic (arab)
-  [1776, 1785],
-  // Extended Arabic-Indic / Persian (arabext)
-  [2406, 2415],
-  // Devanagari / Hindi (deva)
-  [2534, 2543],
-  // Bengali (beng)
-  [3664, 3673]
-  // Thai (thai)
-];
-var registeredBlocks = [...BUILTIN_DIGIT_BLOCKS];
-function registerLocale(config) {
-  if (!config.digitBlocks) return;
-  for (const block of config.digitBlocks) {
-    const already = registeredBlocks.some(([s]) => s === block[0]);
-    if (!already) registeredBlocks.push(block);
-  }
-}
-
-export { registerLocale };
-//# sourceMappingURL=chunk-TISOJTKH.js.map
-//# sourceMappingURL=chunk-TISOJTKH.js.map

package/dist/chunk-TISOJTKH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/normalizer.ts"],"names":[],"mappings":";AAMA,IAAM,oBAAA,GAAqC;AAAA,EACzC,CAAC,MAAQ,IAAM,CAAA;AAAA;AAAA,EACf,CAAC,MAAQ,IAAM,CAAA;AAAA;AAAA,EACf,CAAC,MAAQ,IAAM,CAAA;AAAA;AAAA,EACf,CAAC,MAAQ,IAAM,CAAA;AAAA;AAAA,EACf,CAAC,MAAQ,IAAM;AAAA;AACjB,CAAA;AAGA,IAAM,gBAAA,GAAiC,CAAC,GAAG,oBAAoB,CAAA;AAaxD,SAAS,eAAe,MAAA,EAA4B;AACzD,EAAA,IAAI,CAAC,OAAO,WAAA,EAAa;AACzB,EAAA,KAAA,MAAW,KAAA,IAAS,OAAO,WAAA,EAAa;AACtC,IAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA,KAAM,CAAA,KAAM,KAAA,CAAM,CAAC,CAAC,CAAA;AAC7D,IAAA,IAAI,CAAC,OAAA,EAAS,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA;AAAA,EAC3C;AACF","file":"chunk-TISOJTKH.js","sourcesContent":["import type { DigitBlock } from \"./types.js\";\n\n// ── Built-in digit blocks ────────────────────────────────────────────────────\n// These cover the digit systems required by the spec.\n// Additional blocks can be registered via registerLocale().\n\nconst BUILTIN_DIGIT_BLOCKS: DigitBlock[] = [\n  [0x0660, 0x0669], // Arabic-Indic (arab)\n  [0x06f0, 0x06f9], // Extended Arabic-Indic / Persian (arabext)\n  [0x0966, 0x096f], // Devanagari / Hindi (deva)\n  [0x09e6, 0x09ef], // Bengali (beng)\n  [0x0e50, 0x0e59], // Thai (thai)\n];\n\n// Mutable registry — locale plugins can add blocks here\nconst registeredBlocks: DigitBlock[] = [...BUILTIN_DIGIT_BLOCKS];\n\n// ── Public API ────────────────────────────────────────────────────────────────\n\nexport interface LocaleConfig {\n  /** Extra digit block ranges to register */\n  digitBlocks?: DigitBlock[];\n}\n\n/**\n * Register additional digit blocks (called by locale plugins as a side effect).\n * Duplicate ranges are silently ignored.\n */\nexport function registerLocale(config: LocaleConfig): void {\n  if (!config.digitBlocks) return;\n  for (const block of config.digitBlocks) {\n    const already = registeredBlocks.some(([s]) => s === block[0]);\n    if (!already) registeredBlocks.push(block);\n  }\n}\n\n/**\n * Normalise any Unicode decimal digit in `input` to its ASCII equivalent (0–9).\n * Non-digit characters pass through unchanged.\n */\nexport function normalizeDigits(input: string): string {\n  // Fast path: if there are no non-ASCII chars, return as-is\n  if (!/[^\\u0020-\\u007e]/.test(input)) return input;\n\n  return input.replace(/\\p{Nd}/gu, (ch) => {\n    const code = ch.codePointAt(0)!;\n    for (const [start, end] of registeredBlocks) {\n      if (code >= start && code <= end) {\n        return String(code - start);\n      }\n    }\n    // Fallback: let JS try to parse it as a decimal digit\n    const digit = Number.parseInt(ch, 10);\n    return Number.isNaN(digit) ? ch : String(digit);\n  });\n}\n\n/**\n * Inverse of {@link normalizeDigits}: map ASCII digits 0–9 to the locale's\n * native digit block (identified by its \"zero\" character). No-op when the\n * locale already uses ASCII digits. Used to keep intermediate (still-typing)\n * display strings in the user's native script.\n */\nexport function localizeDigits(input: string, zero: string): string {\n  if (!zero || zero === \"0\") return input;\n  const base = zero.codePointAt(0);\n  if (base === undefined) return input;\n  return input.replace(/[0-9]/g, (d) => String.fromCodePoint(base + (d.charCodeAt(0) - 48)));\n}\n\n/**\n * Returns true if the character is a non-Latin Unicode decimal digit\n * (i.e. would need normalization).\n */\nexport function isNonLatinDigit(ch: string): boolean {\n  const code = ch.codePointAt(0);\n  if (code === undefined) return false;\n  if (code >= 0x30 && code <= 0x39) return false; // ASCII 0-9\n  for (const [start, end] of registeredBlocks) {\n    if (code >= start && code <= end) return true;\n  }\n  return false;\n}\n"]}