@nordhealth/components 4.26.1 → 5.0.0-alpha.0

package/lib/src/scroll-area/ScrollArea.d.ts

@@ -0,0 +1,101 @@
+import { LitElement } from 'lit';
+declare const ScrollArea_base: typeof LitElement;
+/**
+ * Scroll Area is a container that wraps overflowing content in a custom scroll
+ * viewport with consistently-styled scrollbars. Native scrollbars are hidden and
+ * replaced with a thin overlay thumb that appears on hover or while scrolling.
+ *
+ * It also exposes the distance from each edge as CSS custom properties
+ * (`--scroll-area-overflow-*`), which can drive an edge-fade mask on
+ * `::part(viewport)` — see the docs example.
+ *
+ * The scroll machinery lives in shadow DOM; slot your content directly inside.
+ *
+ * @status draft
+ * @category structure
+ *
+ * @slot - The scrollable content.
+ *
+ * @csspart viewport - The scrolling container that holds the slotted content.
+ * @csspart scrollbar-block - The scrollbar track for the block (vertical) axis.
+ * @csspart scrollbar-inline - The scrollbar track for the inline (horizontal) axis.
+ * @csspart thumb-block - The draggable thumb of the block-axis scrollbar.
+ * @csspart thumb-inline - The draggable thumb of the inline-axis scrollbar.
+ * @csspart corner - The square where the two scrollbars meet (when `axis="both"`).
+ *
+ * @cssprop [--n-scroll-area-fade-size=24px] - Depth of the edge fade (when `fade` is set).
+ * @cssprop [--n-scroll-area-scrollbar-size=10px] - Thickness of the scrollbar track and thumb.
+ * @cssprop [--n-scroll-area-scrollbar-inset=2px] - Inset of the scrollbar from the viewport edge.
+ * @cssprop [--n-scroll-area-thumb-color] - Thumb fill (defaults to the border token).
+ * @cssprop [--n-scroll-area-thumb-color-hover] - Thumb fill on hover (defaults to the strong border token).
+ * @cssprop [--scroll-area-overflow-y-start] - Read-only: pixels scrolled past the block start edge.
+ * @cssprop [--scroll-area-overflow-y-end] - Read-only: pixels remaining to the block end edge.
+ * @cssprop [--scroll-area-overflow-x-start] - Read-only: pixels scrolled past the inline start edge.
+ * @cssprop [--scroll-area-overflow-x-end] - Read-only: pixels remaining to the inline end edge.
+ */
+export default class ScrollArea extends ScrollArea_base {
+    static styles: import("lit").CSSResult[];
+    /**
+     * Which scrollbars to render. `block` is vertical, `inline` is horizontal.
+     * @default "block"
+     */
+    axis: 'block' | 'inline' | 'both';
+    /**
+     * Distance in pixels past an edge before the matching `data-overflow-*` state
+     * (and edge-fade variable) is considered active.
+     * @default 0
+     */
+    overflowEdgeThreshold: number;
+    /**
+     * Fades the content in and out at the scroll edges with a mask, signalling
+     * there is more content beyond the edge.
+     * @default false
+     */
+    fade: boolean;
+    /** Always display the scrollbar instead of hiding it when idle. */
+    alwaysShowScrollbar: boolean;
+    private viewport;
+    private scrollbarBlock?;
+    private thumbBlock?;
+    private scrollbarInline?;
+    private thumbInline?;
+    private hasBlockOverflow;
+    private hasInlineOverflow;
+    private resizeObserver?;
+    private coarsePointer?;
+    private scrollTimeout?;
+    private dragOrientation;
+    private dragStart;
+    private dragStartScroll;
+    private get hasBlock();
+    private get hasInline();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    protected updated(): void;
+    private handleSlotChange;
+    private handleCoarseChange;
+    private handlePointerOver;
+    private handlePointerLeave;
+    /** Marks the area as actively scrolling, clearing the flag after a quiet period. */
+    private flagScrolling;
+    private handleScroll;
+    /**
+     * Measures overflow and positions/sizes the thumbs. Ported from Base UI's
+     * `ScrollAreaViewport#computeThumbPosition`.
+     */
+    private measure;
+    private handleThumbPointerDown;
+    private handleThumbPointerMove;
+    private handleThumbPointerUp;
+    private handleTrackPointerDown;
+    /** Scrolling over a scrollbar track scrolls the viewport. */
+    private handleScrollbarWheel;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nord-scroll-area': ScrollArea;
+    }
+}
+export {};

package/lib/src/segmented-control-item/SegmentedControlItem.d.ts

@@ -21,6 +21,8 @@ declare const SegmentedControlItem_base: (new (...args: any[]) => import("../com
  * @cssprop [--n-segmented-control-item-font-weight=var(--n-font-weight)] - Controls the weight of the text within the item, using our [font tokens](/tokens/#font).
  * @cssprop [--n-segmented-control-item-min-block-size=calc(var(--n-space-xl) - 2px)] - Controls the minimum block size, or height, of the item using our [spacing tokens](/tokens/#space).
  * @cssprop [--n-segmented-control-item-inline-size=auto] - Controls the inline size of the item.
+ *
+ * @parent SegmentedControl
  */
 export default class SegmentedControlItem extends SegmentedControlItem_base {
     static styles: import("lit").CSSResult[];

package/lib/src/storybook-utils/dates.d.ts

@@ -0,0 +1,2 @@
+export declare function isWeekend(date: Date): boolean;
+export declare function highlightEverySixthDay(date: Date): string | false;

package/lib/src/storybook-utils/dismiss.d.ts

@@ -0,0 +1 @@
+export declare function removeDismissedElement(event: Event): void;

package/lib/src/storybook-utils/story-descriptions.d.ts

@@ -0,0 +1,2 @@
+export declare const STANDALONE_STORY_DESCRIPTION = "Used on its own, providing its own label and hint via attributes. The Field story shows the same control composed inside a `nord-field` instead.";
+export declare const FIELD_STORY_DESCRIPTION = "Composed inside a `nord-field` with separate label and description elements, for layout the built-in label cannot give \u2014 horizontal orientation, custom label markup, or grouping. The Standalone story shows the same control providing its own label instead.";

package/lib/src/tab-group/TabGroup.d.ts

@@ -9,6 +9,8 @@ import { LitElement } from 'lit';
  * @slot tab - The element which contains all tabs to reveal tabbed content.
  *
  * @cssprop [--n-tab-group-padding=0] - Controls the padding around the tab group (including the tab list), using our [spacing tokens](/tokens/#space).
+ *
+ * @parent Tab
  */
 export default class TabGroup extends LitElement {
     static styles: import("lit").CSSResult[];

package/lib/src/tab-panel/TabPanel.d.ts

@@ -6,6 +6,8 @@ import { LitElement } from 'lit';
  * @status ready
  * @category navigation
  * @slot - The tab panel content.
+ *
+ * @parent Tab
  */
 export default class TabPanel extends LitElement {
     static styles: import("lit").CSSResult[];

package/lib/src/tag-group/TagGroup.d.ts

@@ -11,6 +11,8 @@ import { LitElement } from 'lit';
  *
  * @cssprop [--n-tag-group-border-radius=var(--n-border-radius-s)] - Controls the rounded corners of the tag group, using [border radius tokens](/tokens/#border-radius). Only relevant for the default variant.
  * @cssprop [--n-tag-group-box-shadow=var(--n-box-shadow)] - Controls the surrounding shadow, using [box shadow tokens](/tokens/#box-shadow). Only relevant for the default variant.
+ *
+ * @parent Tag
  */
 export default class TagGroup extends LitElement {
     static styles: import("lit").CSSResult[];

package/lib/src/textarea/Textarea.d.ts

@@ -12,7 +12,8 @@ declare const Textarea_base: (new (...args: any[]) => import("../common/mixins/S
  * @slot error - Optional slot that holds error text for the textarea.
  *
  * @cssprop [--n-textarea-inline-size=240px] - Controls the inline size, or width, of the textarea.
- * @cssprop [--n-textarea-block-size=76px] - Controls the block size, or height, of the textarea.
+ * @cssprop [--n-textarea-block-size=76px] - Controls the minimum block size, or height, of the textarea. When `resize="auto"`, the textarea grows from this height as content is added.
+ * @cssprop [--n-textarea-max-block-size=500px] - Controls the maximum block size, or height, of the textarea. When `resize="auto"`, the textarea stops growing at this height and a scrollbar appears.
  * @cssprop [--n-textarea-background=var(--n-color-active)] - Controls the background of the textarea, using our [color tokens](/tokens/#color).
  * @cssprop [--n-textarea-color=var(--n-color-text)] - Controls the text color of the textarea, using our [color tokens](/tokens/#color).
  * @cssprop [--n-textarea-border-color=var(--n-color-border-strong)] - Controls the border color of the textarea, using our [color tokens](/tokens/#color).

package/lib/src/time-picker/TimePicker.d.ts

@@ -0,0 +1,105 @@
+import { LitElement } from 'lit';
+import '../input/Input.js';
+import '../dropdown/Dropdown.js';
+import '../dropdown-item/DropdownItem.js';
+import '../button/Button.js';
+import '../icon/Icon.js';
+declare const TimePicker_base: typeof LitElement;
+/**
+ * Time Picker pairs the browser's native time field with a dropdown of quick
+ * options, generated at a configurable `interval` between `start` and `end`.
+ * The native field handles typing, locale-aware display and validation; the
+ * dropdown is a shortcut for common times.
+ *
+ * The value is held in ISO `HH:mm` format.
+ *
+ * Like a native input, Time Picker is a control only — it has no built-in
+ * label, hint or error. Compose it inside a [Field](/components/field/) (with a
+ * [Field Label](/components/field-label/), [Field Description](/components/field-description/)
+ * and [Field Error](/components/field-error/)) to label it and add help or error text.
+ *
+ * @status draft
+ * @category form
+ *
+ * @fires change - Fired when the selected time changes.
+ *
+ * @localization chooseTime - Accessible label for the dropdown toggle button.
+ */
+export default class TimePicker extends TimePicker_base {
+    static styles: import("lit").CSSResult[];
+    private localize;
+    private ariaObserver?;
+    /** The selected time, in ISO `HH:mm` format. */
+    value?: string;
+    /** Name submitted with the form. */
+    name?: string;
+    /** Earliest time offered in the dropdown, ISO `HH:mm`. @default "09:00" */
+    start: string;
+    /** Latest time offered in the dropdown, ISO `HH:mm`. @default "17:00" */
+    end: string;
+    /** Minutes between each option in the dropdown. @default 30 */
+    interval: number;
+    /** When set, a typed time is rounded to the nearest interval option; otherwise any time is accepted. */
+    roundToInterval: boolean;
+    /** Display dropdown times in 12-hour (AM/PM) or 24-hour format; omit to use the locale default. */
+    hourFormat?: '12h' | '24h';
+    /** Earliest time the field will accept, ISO `HH:mm`. */
+    min?: string;
+    /** Latest time the field will accept, ISO `HH:mm`. */
+    max?: string;
+    /** Size of the field. @default "m" */
+    size: 's' | 'm' | 'l';
+    /** Whether the field expands to fill its container. */
+    expand: boolean;
+    /** Whether the field is disabled. */
+    disabled: boolean;
+    /** Whether the field is read-only. */
+    readonly: boolean;
+    /** Whether a value is required when submitting a form. */
+    required: boolean;
+    /**
+     * Label for the control. Rendered by the inner input when used standalone;
+     * ignored when wrapped in a `<nord-field>` (the Field provides the label).
+     */
+    label?: string;
+    /** Optional hint text. Ignored inside a `<nord-field>`. */
+    hint?: string;
+    /** Optional error text. Ignored inside a `<nord-field>`. */
+    error?: string;
+    /** Visually hide the label, but keep it for assistive technology. */
+    hideLabel: boolean;
+    /** Render the hint below the control instead of below the label. */
+    hintBelow: boolean;
+    /** Visually hide the required indicator, but keep the required state for AT. */
+    hideRequired: boolean;
+    private input?;
+    private dropdown?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Move focus to the field, so a Field Label's click-to-focus works. */
+    focus(): void;
+    private get clampedInterval();
+    /**
+     * Accessible name from a consumer-set host `aria-label` / `aria-labelledby`,
+     * forwarded to the inner input as `aria-label` (an external `aria-labelledby`
+     * can't cross the shadow boundary). Inside a `<nord-field>` the inner input
+     * takes its name from the field context instead.
+     */
+    private get hostAccessibleName();
+    /** Locale-aware label for a `HH:mm` value (matches how the native field reads). */
+    private formatLabel;
+    /** Generated dropdown options between `start` and `end`. */
+    private get options();
+    /** Round a `HH:mm` value to the nearest interval option, clamped within `start`/`end`. */
+    private roundToNearestInterval;
+    private setValue;
+    private handleFieldChange;
+    private handleSelect;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nord-time-picker': TimePicker;
+    }
+}
+export {};

package/lib/src/time-picker/localization.d.ts

@@ -0,0 +1,4 @@
+declare const timePickerLocalization: {
+    chooseTime: string;
+};
+export default timePickerLocalization;

package/lib/src/toast-group/ToastGroup.d.ts

@@ -9,10 +9,21 @@ type ToastOptions = Partial<Pick<Toast, 'variant' | 'autoDismiss'>>;
  * @slot - Default slot in which to place toasts.
  *
  * @fires {NordEvent} dismiss - Fired when a toast is dismissed (via user action or auto-dismiss), and its exit animation has completed. This event should be used to remove the dismissed toast from the DOM.
+ *
+ * @parent Toast
  */
 export default class ToastGroup extends LitElement {
     static styles: import("lit").CSSResult[];
+    disconnectedCallback(): void;
     render(): import("lit").TemplateResult<1>;
+    private handleSlotChange;
+    /**
+     * Place the group in the top layer via the Popover API so that toasts render
+     * above modals, drawers and other content regardless of stacking contexts
+     * created by container queries, transforms or other containing block ancestors.
+     */
+    private enterTopLayer;
+    private leaveTopLayer;
     /**
      * Convenience method for creating and adding a toast to the group.
      * @param {string} text - The text/message of the toast.

package/lib/src/tooltip/Tooltip.d.ts

@@ -52,6 +52,18 @@ export default class Tooltip extends LitElement {
      * Indicates whether the tooltip is currently open.
      */
     open: boolean;
+    /**
+     * Distance in pixels from the trigger along the main axis — the gap between
+     * the tooltip and the side it opens against. Fed into Floating UI's `offset`
+     * middleware as `mainAxis`. Defaults to `8`.
+     */
+    sideOffset: number;
+    /**
+     * Offset in pixels along the alignment axis — skids the tooltip along the
+     * trigger's edge. Fed into Floating UI's `offset` middleware as
+     * `alignmentAxis`. Defaults to `0`.
+     */
+    alignOffset: number;
     /**
      * Apply all event listeners
      */

package/lib/src/truncate/Truncate.d.ts

@@ -27,6 +27,18 @@ export default class Truncate extends LitElement {
      * Delay in milliseconds before the tooltip opens.
      */
     delay: number;
+    /**
+     * Distance in pixels between the tooltip and the trigger along the main axis.
+     * Mirrors `nord-tooltip`'s `side-offset` and is forwarded to the portaled
+     * tooltip. Defaults to `8`.
+     */
+    sideOffset: number;
+    /**
+     * Offset in pixels along the tooltip's alignment axis. Mirrors
+     * `nord-tooltip`'s `align-offset` and is forwarded to the portaled tooltip.
+     * Defaults to `0`.
+     */
+    alignOffset: number;
     /**
      * Maximum number of lines before truncating. Defaults to `1` (single line).
      * Values `>= 2` allow the text to wrap up to that many lines before the

package/lib/story-descriptions.js

@@ -0,0 +1,2 @@
+const o="Used on its own, providing its own label and hint via attributes. The Field story shows the same control composed inside a `nord-field` instead.",e="Composed inside a `nord-field` with separate label and description elements, for layout the built-in label cannot give — horizontal orientation, custom label markup, or grouping. The Standalone story shows the same control providing its own label instead.";export{e as FIELD_STORY_DESCRIPTION,o as STANDALONE_STORY_DESCRIPTION};
+//# sourceMappingURL=story-descriptions.js.map

package/lib/story-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-descriptions.js","sources":["../src/storybook-utils/story-descriptions.ts"],"sourcesContent":["// Shared docs descriptions for the paired \"Standalone\" and \"Field\" stories that\n// most form controls provide. Both stories render the same control; only the\n// labelling approach differs, so the copy is identical across components.\n\nexport const STANDALONE_STORY_DESCRIPTION\n  = 'Used on its own, providing its own label and hint via attributes. The Field story shows the same control composed inside a `nord-field` instead.'\n\nexport const FIELD_STORY_DESCRIPTION\n  = 'Composed inside a `nord-field` with separate label and description elements, for layout the built-in label cannot give — horizontal orientation, custom label markup, or grouping. The Standalone story shows the same control providing its own label instead.'\n"],"names":["STANDALONE_STORY_DESCRIPTION","FIELD_STORY_DESCRIPTION"],"mappings":"AAIO,MAAMA,EACT,mJAESC,EACT"}

package/lib/translation.js

@@ -1,2 +1,2 @@
-import{isServer as t}from"lit";import o from"./en-us.js";import"./localization.js";import"./localization2.js";import"./localization3.js";import"./localization4.js";import"./localization5.js";import"./localization6.js";import"./localization7.js";import"./localization8.js";import"./localization9.js";const n=new Set,i=new Set,r=new Map;function e(t,o){if(!a(o))return o;if(!a(t))return o;const n={...t};for(const t in o){const i=o[t],r=n[t];a(i)&&a(r)?n[t]=e(r,i):n[t]=i}return n}function a(t){return null!==t&&"object"==typeof t&&!Array.isArray(t)}if(!t){new MutationObserver((function(){for(const t of n)t()})).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"]})}function c(){r.clear()}function l(...t){t.forEach((t=>{const o=t.$lang.toLowerCase(),n=r.get(o),i=n?e(n,t):t;r.set(o,i)})),function(){for(const t of i)t()}()}function s(t){return n.add(t),()=>n.delete(t)}function u(t){return i.add(t),()=>i.delete(t)}function f(t){return r.has(t)}function m(t){const n=t.toLowerCase(),[i]=n.split("-");return r.get(n)||r.get(i)||o}export{c as clearTranslations,o as fallback,f as isTranslationRegistered,l as registerTranslation,m as resolveTranslation,s as subscribeToDocumentLang,u as subscribeToTranslationRegistration};
+import{isServer as o}from"lit";import t from"./en-us.js";import"./localization.js";import"./localization2.js";import"./localization3.js";import"./localization4.js";import"./localization5.js";import"./localization6.js";import"./localization7.js";import"./localization8.js";import"./localization9.js";import"./localization10.js";import"./localization11.js";import"./localization12.js";import"./localization13.js";import"./localization14.js";import"./localization15.js";import"./localization16.js";import"./localization17.js";import"./localization18.js";import"./localization19.js";import"./localization20.js";import"./localization21.js";import"./localization22.js";const i=new Set,n=new Set,a=new Map;function r(o,t){if(!l(t))return t;if(!l(o))return t;const i={...o};for(const o in t){const n=t[o],a=i[o];l(n)&&l(a)?i[o]=r(a,n):i[o]=n}return i}function l(o){return null!==o&&"object"==typeof o&&!Array.isArray(o)}if(!o){new MutationObserver((function(){for(const o of i)o()})).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"]})}function c(){a.clear()}function e(...o){o.forEach((o=>{const t=o.$lang.toLowerCase(),i=a.get(t),n=i?r(i,o):o;a.set(t,n)})),function(){for(const o of n)o()}()}function s(o){return i.add(o),()=>i.delete(o)}function m(o){return n.add(o),()=>n.delete(o)}function p(o){return a.has(o)}function u(o){const i=o.toLowerCase(),[n]=i.split("-");return a.get(i)||a.get(n)||t}export{c as clearTranslations,t as fallback,p as isTranslationRegistered,e as registerTranslation,u as resolveTranslation,s as subscribeToDocumentLang,m as subscribeToTranslationRegistration};
 //# sourceMappingURL=translation.js.map

package/lib/translation.js.map

@@ -1 +1 @@
-{"version":3,"file":"translation.js","sources":["../src/localization/translation.ts"],"sourcesContent":["import { isServer } from 'lit'\nimport en from './en-us.js'\n\n// gets list of properties beginning prefix\ntype PickStartsWith<T, Prefix extends string> = T extends `${Prefix}${string}` ? T : never\n\n// Recursively make all properties optional\ntype DeepPartial<T> = T extends object\n  ? {\n      [P in keyof T]?: DeepPartial<T[P]>\n    }\n  : T\n\nexport type Translation = typeof en\nexport type PartialTranslation = {\n  $lang: string\n  $name?: string\n  $dir?: 'ltr' | 'rtl'\n} & DeepPartial<Omit<Translation, '$lang' | '$name' | '$dir'>>\nexport type WellKnownKeys = PickStartsWith<keyof Translation, '$'>\n\nconst documentLangSubscribers = new Set<() => void>()\nconst translationRegistrationSubscribers = new Set<() => void>()\nconst translations = new Map<string, Translation>()\n\nfunction notifyDocumentLangChange() {\n  for (const subscriber of documentLangSubscribers) {\n    subscriber()\n  }\n}\n\nfunction notifyTranslationRegistration() {\n  for (const subscriber of translationRegistrationSubscribers) {\n    subscriber()\n  }\n}\n\nfunction deepMerge(target: unknown, source: unknown): unknown {\n  if (!isObject(source))\n    return source\n\n  if (!isObject(target))\n    return source\n\n  const result = { ...target }\n\n  for (const key in source) {\n    const sourceValue = (source as Record<string, unknown>)[key]\n    const targetValue = result[key]\n\n    if (isObject(sourceValue) && isObject(targetValue)) {\n      result[key] = deepMerge(targetValue, sourceValue)\n    }\n    else {\n      result[key] = sourceValue\n    }\n  }\n\n  return result\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n\n// observe changes to the document's lang\nif (!isServer) {\n  const observer = new MutationObserver(notifyDocumentLangChange)\n\n  observer.observe(document.documentElement, {\n    attributes: true,\n    attributeFilter: ['lang'],\n  })\n}\n\n/**\n * Removes all registered translations\n */\nexport function clearTranslations() {\n  translations.clear()\n}\n\n/**\n * Registers one or more translations. If a translation for the same language\n * already exists, the new translation will be deep-merged with the existing one.\n * Translations can be partial — only the fields you provide will override existing values.\n */\nexport function registerTranslation(...translation: (Translation | PartialTranslation)[]) {\n  translation.forEach((t) => {\n    const lang = t.$lang.toLowerCase()\n    const existing = translations.get(lang)\n\n    // Deep merge: keep existing keys, override with new ones\n    const merged = existing ? (deepMerge(existing, t) as Translation) : (t as Translation)\n    translations.set(lang, merged)\n  })\n\n  notifyTranslationRegistration()\n}\n\n/**\n * subscribe to document language changes\n * @param onChange callback for when document `lang` attr changes\n * @returns cleanup function\n */\nexport function subscribeToDocumentLang(onChange: () => void): () => void {\n  documentLangSubscribers.add(onChange)\n  return () => documentLangSubscribers.delete(onChange)\n}\n\n/**\n * subscribe to translation registration changes\n * @param onChange callback for when new translations are registered\n * @returns cleanup function\n */\nexport function subscribeToTranslationRegistration(onChange: () => void): () => void {\n  translationRegistrationSubscribers.add(onChange)\n  return () => translationRegistrationSubscribers.delete(onChange)\n}\n\n/**\n * Check whether there is a translation registered for the given lang\n * @param lang the lang code e.g. \"en\" or \"en-GB\"\n */\nexport function isTranslationRegistered(lang: string) {\n  return translations.has(lang)\n}\n\n/**\n * Picks the most appropriate translation for the given language, from most specific to least specific.\n * First tries lang + region, then lang only, then fallback.\n */\nexport function resolveTranslation(langCode: string) {\n  const lang = langCode.toLowerCase()\n  const [langOnly] = lang.split('-')\n\n  return translations.get(lang) || translations.get(langOnly) || en\n}\n\nexport { en as fallback }\n"],"names":["documentLangSubscribers","Set","translationRegistrationSubscribers","translations","Map","deepMerge","target","source","isObject","result","key","sourceValue","targetValue","value","Array","isArray","isServer","MutationObserver","subscriber","observe","document","documentElement","attributes","attributeFilter","clearTranslations","clear","registerTranslation","translation","forEach","t","lang","$lang","toLowerCase","existing","get","merged","set","notifyTranslationRegistration","subscribeToDocumentLang","onChange","add","delete","subscribeToTranslationRegistration","isTranslationRegistered","has","resolveTranslation","langCode","langOnly","split","en"],"mappings":"2SAqBA,MAAMA,EAA0B,IAAIC,IAC9BC,EAAqC,IAAID,IACzCE,EAAe,IAAIC,IAczB,SAASC,EAAUC,EAAiBC,GAClC,IAAKC,EAASD,GACZ,OAAOA,EAET,IAAKC,EAASF,GACZ,OAAOC,EAET,MAAME,EAAS,IAAKH,GAEpB,IAAK,MAAMI,KAAOH,EAAQ,CACxB,MAAMI,EAAeJ,EAAmCG,GAClDE,EAAcH,EAAOC,GAEvBF,EAASG,IAAgBH,EAASI,GACpCH,EAAOC,GAAOL,EAAUO,EAAaD,GAGrCF,EAAOC,GAAOC,CAEjB,CAED,OAAOF,CACT,CAEA,SAASD,EAASK,GAChB,OAAiB,OAAVA,GAAmC,iBAAVA,IAAuBC,MAAMC,QAAQF,EACvE,CAGA,IAAKG,EAAU,CACI,IAAIC,kBA1CvB,WACE,IAAK,MAAMC,KAAclB,EACvBkB,GAEJ,IAwCWC,QAAQC,SAASC,gBAAiB,CACzCC,YAAY,EACZC,gBAAiB,CAAC,SAEtB,UAKgBC,IACdrB,EAAasB,OACf,CAOgB,SAAAC,KAAuBC,GACrCA,EAAYC,SAASC,IACnB,MAAMC,EAAOD,EAAEE,MAAMC,cACfC,EAAW9B,EAAa+B,IAAIJ,GAG5BK,EAASF,EAAY5B,EAAU4B,EAAUJ,GAAsBA,EACrE1B,EAAaiC,IAAIN,EAAMK,EAAO,IA/DlC,WACE,IAAK,MAAMjB,KAAchB,EACvBgB,GAEJ,CA8DEmB,EACF,CAOM,SAAUC,EAAwBC,GAEtC,OADAvC,EAAwBwC,IAAID,GACrB,IAAMvC,EAAwByC,OAAOF,EAC9C,CAOM,SAAUG,EAAmCH,GAEjD,OADArC,EAAmCsC,IAAID,GAChC,IAAMrC,EAAmCuC,OAAOF,EACzD,CAMM,SAAUI,EAAwBb,GACtC,OAAO3B,EAAayC,IAAId,EAC1B,CAMM,SAAUe,EAAmBC,GACjC,MAAMhB,EAAOgB,EAASd,eACfe,GAAYjB,EAAKkB,MAAM,KAE9B,OAAO7C,EAAa+B,IAAIJ,IAAS3B,EAAa+B,IAAIa,IAAaE,CACjE"}
+{"version":3,"file":"translation.js","sources":["../src/localization/translation.ts"],"sourcesContent":["import { isServer } from 'lit'\nimport en from './en-us.js'\n\n// gets list of properties beginning prefix\ntype PickStartsWith<T, Prefix extends string> = T extends `${Prefix}${string}` ? T : never\n\n// Recursively make all properties optional\ntype DeepPartial<T> = T extends object\n  ? {\n      [P in keyof T]?: DeepPartial<T[P]>\n    }\n  : T\n\nexport type Translation = typeof en\nexport type PartialTranslation = {\n  $lang: string\n  $name?: string\n  $dir?: 'ltr' | 'rtl'\n} & DeepPartial<Omit<Translation, '$lang' | '$name' | '$dir'>>\nexport type WellKnownKeys = PickStartsWith<keyof Translation, '$'>\n\nconst documentLangSubscribers = new Set<() => void>()\nconst translationRegistrationSubscribers = new Set<() => void>()\nconst translations = new Map<string, Translation>()\n\nfunction notifyDocumentLangChange() {\n  for (const subscriber of documentLangSubscribers) {\n    subscriber()\n  }\n}\n\nfunction notifyTranslationRegistration() {\n  for (const subscriber of translationRegistrationSubscribers) {\n    subscriber()\n  }\n}\n\nfunction deepMerge(target: unknown, source: unknown): unknown {\n  if (!isObject(source))\n    return source\n\n  if (!isObject(target))\n    return source\n\n  const result = { ...target }\n\n  for (const key in source) {\n    const sourceValue = (source as Record<string, unknown>)[key]\n    const targetValue = result[key]\n\n    if (isObject(sourceValue) && isObject(targetValue)) {\n      result[key] = deepMerge(targetValue, sourceValue)\n    }\n    else {\n      result[key] = sourceValue\n    }\n  }\n\n  return result\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n\n// observe changes to the document's lang\nif (!isServer) {\n  const observer = new MutationObserver(notifyDocumentLangChange)\n\n  observer.observe(document.documentElement, {\n    attributes: true,\n    attributeFilter: ['lang'],\n  })\n}\n\n/**\n * Removes all registered translations\n */\nexport function clearTranslations() {\n  translations.clear()\n}\n\n/**\n * Registers one or more translations. If a translation for the same language\n * already exists, the new translation will be deep-merged with the existing one.\n * Translations can be partial — only the fields you provide will override existing values.\n */\nexport function registerTranslation(...translation: (Translation | PartialTranslation)[]) {\n  translation.forEach((t) => {\n    const lang = t.$lang.toLowerCase()\n    const existing = translations.get(lang)\n\n    // Deep merge: keep existing keys, override with new ones\n    const merged = existing ? (deepMerge(existing, t) as Translation) : (t as Translation)\n    translations.set(lang, merged)\n  })\n\n  notifyTranslationRegistration()\n}\n\n/**\n * subscribe to document language changes\n * @param onChange callback for when document `lang` attr changes\n * @returns cleanup function\n */\nexport function subscribeToDocumentLang(onChange: () => void): () => void {\n  documentLangSubscribers.add(onChange)\n  return () => documentLangSubscribers.delete(onChange)\n}\n\n/**\n * subscribe to translation registration changes\n * @param onChange callback for when new translations are registered\n * @returns cleanup function\n */\nexport function subscribeToTranslationRegistration(onChange: () => void): () => void {\n  translationRegistrationSubscribers.add(onChange)\n  return () => translationRegistrationSubscribers.delete(onChange)\n}\n\n/**\n * Check whether there is a translation registered for the given lang\n * @param lang the lang code e.g. \"en\" or \"en-GB\"\n */\nexport function isTranslationRegistered(lang: string) {\n  return translations.has(lang)\n}\n\n/**\n * Picks the most appropriate translation for the given language, from most specific to least specific.\n * First tries lang + region, then lang only, then fallback.\n */\nexport function resolveTranslation(langCode: string) {\n  const lang = langCode.toLowerCase()\n  const [langOnly] = lang.split('-')\n\n  return translations.get(lang) || translations.get(langOnly) || en\n}\n\nexport { en as fallback }\n"],"names":["documentLangSubscribers","Set","translationRegistrationSubscribers","translations","Map","deepMerge","target","source","isObject","result","key","sourceValue","targetValue","value","Array","isArray","isServer","MutationObserver","subscriber","observe","document","documentElement","attributes","attributeFilter","clearTranslations","clear","registerTranslation","translation","forEach","t","lang","$lang","toLowerCase","existing","get","merged","set","notifyTranslationRegistration","subscribeToDocumentLang","onChange","add","delete","subscribeToTranslationRegistration","isTranslationRegistered","has","resolveTranslation","langCode","langOnly","split","en"],"mappings":"upBAqBA,MAAMA,EAA0B,IAAIC,IAC9BC,EAAqC,IAAID,IACzCE,EAAe,IAAIC,IAczB,SAASC,EAAUC,EAAiBC,GAClC,IAAKC,EAASD,GACZ,OAAOA,EAET,IAAKC,EAASF,GACZ,OAAOC,EAET,MAAME,EAAS,IAAKH,GAEpB,IAAK,MAAMI,KAAOH,EAAQ,CACxB,MAAMI,EAAeJ,EAAmCG,GAClDE,EAAcH,EAAOC,GAEvBF,EAASG,IAAgBH,EAASI,GACpCH,EAAOC,GAAOL,EAAUO,EAAaD,GAGrCF,EAAOC,GAAOC,CAEjB,CAED,OAAOF,CACT,CAEA,SAASD,EAASK,GAChB,OAAiB,OAAVA,GAAmC,iBAAVA,IAAuBC,MAAMC,QAAQF,EACvE,CAGA,IAAKG,EAAU,CACI,IAAIC,kBA1CvB,WACE,IAAK,MAAMC,KAAclB,EACvBkB,GAEJ,IAwCWC,QAAQC,SAASC,gBAAiB,CACzCC,YAAY,EACZC,gBAAiB,CAAC,SAEtB,UAKgBC,IACdrB,EAAasB,OACf,CAOgB,SAAAC,KAAuBC,GACrCA,EAAYC,SAASC,IACnB,MAAMC,EAAOD,EAAEE,MAAMC,cACfC,EAAW9B,EAAa+B,IAAIJ,GAG5BK,EAASF,EAAY5B,EAAU4B,EAAUJ,GAAsBA,EACrE1B,EAAaiC,IAAIN,EAAMK,EAAO,IA/DlC,WACE,IAAK,MAAMjB,KAAchB,EACvBgB,GAEJ,CA8DEmB,EACF,CAOM,SAAUC,EAAwBC,GAEtC,OADAvC,EAAwBwC,IAAID,GACrB,IAAMvC,EAAwByC,OAAOF,EAC9C,CAOM,SAAUG,EAAmCH,GAEjD,OADArC,EAAmCsC,IAAID,GAChC,IAAMrC,EAAmCuC,OAAOF,EACzD,CAMM,SAAUI,EAAwBb,GACtC,OAAO3B,EAAayC,IAAId,EAC1B,CAMM,SAAUe,EAAmBC,GACjC,MAAMhB,EAAOgB,EAASd,eACfe,GAAYjB,EAAKkB,MAAM,KAE9B,OAAO7C,EAAa+B,IAAIJ,IAAS3B,EAAa+B,IAAIa,IAAaE,CACjE"}

package/lib/validate.js

@@ -0,0 +1,2 @@
+import{getFormatter as n}from"./format.js";import{parseNumber as i}from"./parse.js";const t=1e-10,r=3;function u(n,i=Number.MIN_SAFE_INTEGER,t=Number.MAX_SAFE_INTEGER){return Math.max(i,Math.min(n,t))}function o(n){return null!=(null==n?void 0:n.maximumFractionDigits)||null!=(null==n?void 0:n.minimumFractionDigits)||null!=(null==n?void 0:n.maximumSignificantDigits)||null!=(null==n?void 0:n.minimumSignificantDigits)||null!=(null==n?void 0:n.roundingIncrement)||null!=(null==n?void 0:n.roundingMode)||null!=(null==n?void 0:n.roundingPriority)}function l(t,u){if(!Number.isFinite(t))return t;if(!o(u))return Number(t.toFixed(r));const l=n("en-US",{...u,signDisplay:"auto",currencySign:"standard",notation:"compact"===u.notation?"standard":u.notation,useGrouping:!1}),a=l.format(t),e=i(a,"en-US",u);return null===e?t:l.format(e)===a?e:t}function a(n,{step:i,minWithDefault:r,maxWithDefault:o,minWithZeroDefault:a,format:e,snapOnStep:m,small:s,clamp:c}){if(null===n)return n;let f=n;if(null!=i&&m&&0!==i){f=function(n,i,r,u="directional"){const o=Math.abs(r),l=Math.sign(r),a=n-i+o*t*l;return"nearest"===u?i+Math.round(a/r)*r:i+(l>0?Math.floor(a/o):Math.ceil(a/o))*o}(f,s||r===Number.MIN_SAFE_INTEGER?a:r,i,s?"nearest":"directional")}c&&(f=u(f,r,o));const d=l(f,e);return c?u(d,r,o):d}export{u as clamp,o as hasNumberFormatRoundingOptions,l as removeFloatingPointErrors,a as toValidatedNumber};
+//# sourceMappingURL=validate.js.map

package/lib/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sources":["../src/number-field/validate.ts"],"sourcesContent":["/**\n * Numeric validation/clamping/snapping, ported from Base UI's\n * `number-field/utils/validate.ts`. Snapping happens BEFORE clamping so\n * non-step-aligned boundaries stay reachable.\n */\n\nimport { getFormatter } from './format.js'\nimport { parseNumber } from './parse.js'\n\nconst STEP_EPSILON_FACTOR = 1e-10\n// Matches Intl.NumberFormat's decimal maximumFractionDigits default.\nconst DEFAULT_DIGITS = 3\n\n// Model NumberFormat v3 rounding options locally (es2022 Intl types omit them).\ntype NumberFormatOptionsWithRounding = Intl.NumberFormatOptions & {\n  roundingIncrement?: number | undefined\n  roundingMode?: string | undefined\n  roundingPriority?: string | undefined\n}\n\nexport function clamp(\n  val: number,\n  min: number = Number.MIN_SAFE_INTEGER,\n  max: number = Number.MAX_SAFE_INTEGER,\n): number {\n  return Math.max(min, Math.min(val, max))\n}\n\nexport function hasNumberFormatRoundingOptions(\n  format?: NumberFormatOptionsWithRounding,\n): format is NumberFormatOptionsWithRounding {\n  return (\n    format?.maximumFractionDigits != null\n    || format?.minimumFractionDigits != null\n    || format?.maximumSignificantDigits != null\n    || format?.minimumSignificantDigits != null\n    || format?.roundingIncrement != null\n    || format?.roundingMode != null\n    || format?.roundingPriority != null\n  )\n}\n\nexport function removeFloatingPointErrors(value: number, format?: NumberFormatOptionsWithRounding) {\n  if (!Number.isFinite(value)) {\n    return value\n  }\n\n  if (!hasNumberFormatRoundingOptions(format)) {\n    return Number(value.toFixed(DEFAULT_DIGITS))\n  }\n\n  const formatter = getFormatter('en-US', {\n    ...format,\n    // These options alter only display decoration, not numeric rounding.\n    signDisplay: 'auto',\n    currencySign: 'standard',\n    notation: format.notation === 'compact' ? 'standard' : format.notation,\n    useGrouping: false,\n  } as NumberFormatOptionsWithRounding)\n  const roundedText = formatter.format(value)\n  const roundedValue = parseNumber(roundedText, 'en-US', format)\n\n  if (roundedValue === null) {\n    return value\n  }\n\n  return formatter.format(roundedValue) === roundedText ? roundedValue : value\n}\n\nfunction snapToStep(\n  value: number,\n  base: number,\n  step: number,\n  mode: 'directional' | 'nearest' = 'directional',\n) {\n  const stepSize = Math.abs(step)\n  const direction = Math.sign(step)\n  const tolerance = stepSize * STEP_EPSILON_FACTOR * direction\n  const rawSteps = value - base + tolerance\n\n  if (mode === 'nearest') {\n    return base + Math.round(rawSteps / step) * step\n  }\n\n  const snappedSteps\n    = direction > 0 ? Math.floor(rawSteps / stepSize) : Math.ceil(rawSteps / stepSize)\n  return base + snappedSteps * stepSize\n}\n\nexport function toValidatedNumber(\n  value: number | null,\n  {\n    step,\n    minWithDefault,\n    maxWithDefault,\n    minWithZeroDefault,\n    format,\n    snapOnStep,\n    small,\n    clamp: shouldClamp,\n  }: {\n    step: number | undefined\n    minWithDefault: number\n    maxWithDefault: number\n    minWithZeroDefault: number\n    format: NumberFormatOptionsWithRounding | undefined\n    snapOnStep: boolean\n    small: boolean\n    clamp: boolean\n  },\n): number | null {\n  if (value === null) {\n    return value\n  }\n\n  let nextValue = value\n\n  if (step != null && snapOnStep && step !== 0) {\n    const base\n      = small || minWithDefault === Number.MIN_SAFE_INTEGER ? minWithZeroDefault : minWithDefault\n\n    // Snap before clamping so non-step-aligned boundaries stay reachable.\n    nextValue = snapToStep(nextValue, base, step, small ? 'nearest' : 'directional')\n  }\n\n  if (shouldClamp) {\n    nextValue = clamp(nextValue, minWithDefault, maxWithDefault)\n  }\n\n  const roundedValue = removeFloatingPointErrors(nextValue, format)\n  return shouldClamp ? clamp(roundedValue, minWithDefault, maxWithDefault) : roundedValue\n}\n"],"names":["STEP_EPSILON_FACTOR","DEFAULT_DIGITS","clamp","val","min","Number","MIN_SAFE_INTEGER","max","MAX_SAFE_INTEGER","Math","hasNumberFormatRoundingOptions","format","maximumFractionDigits","minimumFractionDigits","maximumSignificantDigits","minimumSignificantDigits","roundingIncrement","roundingMode","roundingPriority","removeFloatingPointErrors","value","isFinite","toFixed","formatter","getFormatter","signDisplay","currencySign","notation","useGrouping","roundedText","roundedValue","parseNumber","toValidatedNumber","step","minWithDefault","maxWithDefault","minWithZeroDefault","snapOnStep","small","shouldClamp","nextValue","base","mode","stepSize","abs","direction","sign","rawSteps","round","floor","ceil","snapToStep"],"mappings":"oFASA,MAAMA,EAAsB,MAEtBC,EAAiB,EASP,SAAAC,EACdC,EACAC,EAAcC,OAAOC,iBACrBC,EAAcF,OAAOG,kBAErB,OAAOC,KAAKF,IAAIH,EAAKK,KAAKL,IAAID,EAAKI,GACrC,CAEM,SAAUG,EACdC,GAEA,OACmC,OAAjCA,eAAAA,EAAQC,wBAC4B,OAAjCD,aAAM,EAANA,EAAQE,wBAC4B,OAApCF,aAAM,EAANA,EAAQG,2BAC4B,OAApCH,aAAM,EAANA,EAAQI,2BACqB,OAA7BJ,aAAM,EAANA,EAAQK,oBACgB,OAAxBL,aAAM,EAANA,EAAQM,eACoB,OAA5BN,aAAA,EAAAA,EAAQO,iBAEf,CAEgB,SAAAC,EAA0BC,EAAeT,GACvD,IAAKN,OAAOgB,SAASD,GACnB,OAAOA,EAGT,IAAKV,EAA+BC,GAClC,OAAON,OAAOe,EAAME,QAAQrB,IAG9B,MAAMsB,EAAYC,EAAa,QAAS,IACnCb,EAEHc,YAAa,OACbC,aAAc,WACdC,SAA8B,YAApBhB,EAAOgB,SAAyB,WAAahB,EAAOgB,SAC9DC,aAAa,IAETC,EAAcN,EAAUZ,OAAOS,GAC/BU,EAAeC,EAAYF,EAAa,QAASlB,GAEvD,OAAqB,OAAjBmB,EACKV,EAGFG,EAAUZ,OAAOmB,KAAkBD,EAAcC,EAAeV,CACzE,CAsBM,SAAUY,EACdZ,GACAa,KACEA,EAAIC,eACJA,EAAcC,eACdA,EAAcC,mBACdA,EAAkBzB,OAClBA,EAAM0B,WACNA,EAAUC,MACVA,EACApC,MAAOqC,IAYT,GAAc,OAAVnB,EACF,OAAOA,EAGT,IAAIoB,EAAYpB,EAEhB,GAAY,MAARa,GAAgBI,GAAuB,IAATJ,EAAY,CAK5CO,EArDJ,SACEpB,EACAqB,EACAR,EACAS,EAAkC,eAElC,MAAMC,EAAWlC,KAAKmC,IAAIX,GACpBY,EAAYpC,KAAKqC,KAAKb,GAEtBc,EAAW3B,EAAQqB,EADPE,EAAW3C,EAAsB6C,EAGnD,MAAa,YAATH,EACKD,EAAOhC,KAAKuC,MAAMD,EAAWd,GAAQA,EAKvCQ,GADHI,EAAY,EAAIpC,KAAKwC,MAAMF,EAAWJ,GAAYlC,KAAKyC,KAAKH,EAAWJ,IAC9CA,CAC/B,CAmCgBQ,CAAWX,EAHnBF,GAASJ,IAAmB7B,OAAOC,iBAAmB8B,EAAqBF,EAGvCD,EAAMK,EAAQ,UAAY,cACnE,CAEGC,IACFC,EAAYtC,EAAMsC,EAAWN,EAAgBC,IAG/C,MAAML,EAAeX,EAA0BqB,EAAW7B,GAC1D,OAAO4B,EAAcrC,EAAM4B,EAAcI,EAAgBC,GAAkBL,CAC7E"}