@nordhealth/components 4.26.2 → 5.0.0

package/lib/src/pagination/PaginationPrevious.d.ts

@@ -0,0 +1,24 @@
+import { LitElement } from 'lit';
+declare const PaginationPrevious_base: typeof LitElement;
+/**
+ * The "previous page" control in a composed [Pagination](/components/pagination/).
+ * A layout wrapper around your own interactive element — provide an `<a>`
+ * (e.g. a framework `<Link>`) or a `nord-button` with its own icon, label and
+ * navigation, and disable it when there is no previous page.
+ *
+ * @status draft
+ * @category navigation
+ * @lightDom true
+ *
+ * @slot - Default slot for the previous-page link or button.
+ */
+export default class PaginationPrevious extends PaginationPrevious_base {
+    connectedCallback(): void;
+    protected createRenderRoot(): this;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nord-pagination-previous': PaginationPrevious;
+    }
+}
+export {};

package/lib/src/pagination/localization.d.ts

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

package/lib/src/pagination/paginate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The ellipsis marker returned by {@link paginate} in place of a page number.
+ */
+export declare const ELLIPSIS: "…";
+export type PaginationToken = number | typeof ELLIPSIS;
+/**
+ * Builds the sequence of page numbers (and ellipsis markers) to render for a
+ * numbered pager, keeping the window centred on the current page and collapsing
+ * long gaps into a single {@link ELLIPSIS}.
+ *
+ * Ported from the Provet Cloud frontend `paginate()` util (which is itself based
+ * on https://gist.github.com/kottenator/9d936eb3e4e3c3e02598), with the lodash
+ * `clamp`/`range` dependencies inlined.
+ *
+ * @param currentPage 1-based current page.
+ * @param pageCount Total number of pages.
+ * @param pagesShown Maximum number of page tokens to show (min 7).
+ * @returns An array of 1-based page numbers interleaved with `ELLIPSIS`.
+ */
+export declare function paginate(currentPage: number, pageCount: number, pagesShown?: number): PaginationToken[];

package/lib/src/popout/Popout.d.ts

@@ -37,6 +37,15 @@ export default class Popout extends Popout_base {
      * Set to true to always display the popout as a floating overlay, even on smaller viewports.
      */
     alwaysFloating: boolean;
+    /**
+     * Set to true when the consuming component owns the `open` state and drives
+     * the popout itself (e.g. via its own trigger `@click` and `show()`/`hide()`).
+     * The popout stays presentational — positioning, top layer, light dismiss and
+     * transitions all still work — but it does NOT attach its own click-to-toggle
+     * listener to the `aria-controls` trigger, avoiding a competing second toggle
+     * on the same click.
+     */
+    controlled: boolean;
     /**
      * Show the popout.
      * A promise that resolves to a `TransitionEvent` when the popout's show animation ends or is cancelled.

package/lib/src/qrcode/Qrcode.d.ts

@@ -4,7 +4,7 @@ import { LitElement } from 'lit';
  * to users which they can quickly scan with their smartphone.
  *
  * @status ready
- * @category image
+ * @category content
  * @displayName QR Code
  */
 export default class Qrcode extends LitElement {

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 layout
+ *
+ * @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/stack/Stack.d.ts

@@ -4,7 +4,7 @@ import { LitElement } from 'lit';
  * vertical or horizontal axis with optional spacing between each child.
  *
  * @status ready
- * @category structure
+ * @category layout
  * @slot - The stack content.
  *
  * @cssprop [--n-stack-gap=var(--n-space-m)] - Controls the spacing between items, using our [spacing tokens](/tokens/#space).

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/Tag.d.ts

@@ -6,7 +6,7 @@ declare const Tag_base: (new (...args: any[]) => import("../common/mixins/InputM
  * and organize objects. Commonly used to signify the attributes of an object.
  *
  * @status new
- * @category text
+ * @category content
  * @slot - The tag content.
  *
  * @localization removeLabel - Accessible label for the remove button.

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

@@ -3,7 +3,7 @@ import { LitElement } from 'lit';
  * Tag groups are designed to bring together selectable tags that are of a similar nature. For example categories you can filter by.
  *
  * @status new
- * @category structure
+ * @category content
  * @slot - The tag group content
  *
  * @fires {NordEvent} change - Fired whenever a tag has been checked or unchecked via user interaction.
@@ -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/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/top-bar/TopBar.d.ts

@@ -3,7 +3,7 @@ import { LitElement } from 'lit';
  * Top bar is a header component that is always visible at the top of the interface. Top bar allows functionality such as search and contextual menus to be placed at the top of the interface.
  *
  * @status ready
- * @category structure
+ * @category layout
  * @slot - Used for the main content of the top bar. We recommend placing your application’s global search functionality into this slot.
  * @slot end - Optional slot for menus, buttons, toggles, etc.
  */

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

@@ -5,7 +5,7 @@ import '../tooltip/Tooltip.js';
  * Truncate clips text with a single- or multi-line ellipsis and reveals a tooltip with the full text when the content overflows.
  *
  * @status ready
- * @category text
+ * @category content
  * @slot - The full text content. Plain text is recommended; rich markup is
  *   not supported (only `textContent` is read for truncation).
  */

package/lib/src/visually-hidden/VisuallyHidden.d.ts

@@ -5,7 +5,7 @@ import { LitElement } from 'lit';
  * hidden.
  *
  * @status ready
- * @category text
+ * @category content
  * @slot - The visually hidden content.
  */
 export default class VisuallyHidden extends LitElement {

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/tinykeys-DwvDXsEb.js

@@ -0,0 +1,2 @@
+let e=["Shift","Meta","Alt","Control"],t=1e3,n="object"==typeof navigator?navigator.platform:"",o=/Mac|iPod|iPhone|iPad/.test(n)?"Meta":"Control",r="Win32"===n?["Control","Alt"]:["Alt"];function i(e){let t=e.target;return e.repeat||e.isComposing||t!==e.currentTarget&&t.matches("[contenteditable],input,select,textarea")}function a(e,t){return"function"==typeof e.getModifierState&&(e.getModifierState(t)||r.includes(t)&&e.getModifierState("AltGraph"))}function l(t,[n,o,i]){const l=n.includes("AltGraph");return!((i instanceof RegExp?!i.test(t.key)&&!i.test(t.code):i.toUpperCase()!==t.key.toUpperCase()&&i!==t.code)||n.find((e=>!a(t,e)))||e.find((e=>!n.includes(e)&&!o.includes(e)&&i!==e&&a(t,e)&&!(l&&r.includes(e)))))}function c(e,n={}){let r=n.timeout??t,c=n.ignore??i,s=Object.keys(e).map((t=>{return[t,(n=t,n.trim().split(" ").map((e=>{let t=e.split(/(?<=\w|\])\+/),n=t.pop(),r=n.match(/^\((.+)\)$/),i=r?new RegExp(`^(?:${r[1]})$`,"iv"):n,a=[],l=[];for(const e of t){let t=e.match(/^\[(.*)\]$/),n=t?.[1]??e;n="$mod"===n?o:n,t?l.push(n):a.push(n)}return[a,l,i]}))),e[t]];var n})),u=new Map,f=null;return e=>{if(!function(e){return!!(e.key&&e.code&&e.getModifierState)}(e)||c(e))return;let t=[];for(let[n,o,r]of s){let i=u.get(n),[c,...s]=i||o;if(l(e,c))if(s.length>0)u.set(n,s),t.push(n);else{if(u.delete(n),!t.length){r(e);break}console.warn(`tinykeys: Conflict found, "${n}" did not fire, waiting for:`,t)}else a(e,e.key)||u.delete(n)}f&&clearTimeout(f),f=setTimeout((()=>u.clear()),r)}}function s(e,t,n={}){let o=n.event??"keydown",r=c(t,n);return e.addEventListener(o,r,n.capture),()=>{e.removeEventListener(o,r,n.capture)}}export{c,s as t};
+//# sourceMappingURL=tinykeys-DwvDXsEb.js.map

package/lib/tinykeys-DwvDXsEb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinykeys-DwvDXsEb.js","sources":["../../../node_modules/.pnpm/tinykeys@4.0.0/node_modules/tinykeys/dist/tinykeys.mjs"],"sourcesContent":["//#region src/tinykeys.ts\n/**\n* These are the modifier keys that change the meaning of keybindings.\n*\n* Note: Ignoring \"AltGraph\" because it is covered by the others.\n*/\nlet KEYBINDING_MODIFIER_KEYS = [\n\t\"Shift\",\n\t\"Meta\",\n\t\"Alt\",\n\t\"Control\"\n];\n/**\n* Keybinding sequences should timeout if individual key presses are more than\n* 1s apart by default.\n*/\nlet DEFAULT_TIMEOUT = 1e3;\n/**\n* Keybinding sequences should bind to this event by default.\n*/\nlet DEFAULT_EVENT = \"keydown\";\n/**\n* Platform detection code.\n* @see https://github.com/jamiebuilds/tinykeys/issues/184\n*/\nlet PLATFORM = typeof navigator === \"object\" ? navigator.platform : \"\";\n/**\n* An alias for creating platform-specific keybinding aliases.\n*/\nlet MOD = /Mac|iPod|iPhone|iPad/.test(PLATFORM) ? \"Meta\" : \"Control\";\n/**\n* Meaning of `AltGraph`, from MDN:\n* - Windows: Both Alt and Ctrl keys are pressed, or AltGr key is pressed\n* - Mac: ⌥ Option key pressed\n* - Linux: Level 3 Shift key (or Level 5 Shift key) pressed\n* - Android: Not supported\n* @see https://github.com/jamiebuilds/tinykeys/issues/185\n*/\nlet ALT_GRAPH_ALIASES = PLATFORM === \"Win32\" ? [\"Control\", \"Alt\"] : [\"Alt\"];\n/**\n* Ensure and stop any event that isn't a full keyboard event.\n* Autocomplete option navigation and selection would fire an Event,\n* instead of the expected KeyboardEvent\n*/\nfunction isKeyboardEvent(event) {\n\treturn !!(event.key && event.code && event.getModifierState);\n}\n/**\n* Ignores keyboard events from contenteditable and form elements unless they\n* are the current target.\n*/\nfunction defaultKeybindingsHandlerIgnore(event) {\n\tlet target = event.target;\n\treturn event.repeat || event.isComposing || target !== event.currentTarget && target.matches(\"[contenteditable],input,select,textarea\");\n}\n/**\n* There's a bug in Chrome that causes event.getModifierState not to exist on\n* KeyboardEvent's for F1/F2/etc keys.\n*/\nfunction getModifierState(event, mod) {\n\treturn typeof event.getModifierState === \"function\" ? event.getModifierState(mod) || ALT_GRAPH_ALIASES.includes(mod) && event.getModifierState(\"AltGraph\") : false;\n}\n/**\n* Parses a keybinding string into its parts.\n*\n* ```\n* grammar    = `<sequence>`\n* <sequence> = `<press> <press> <press> ...`\n* <press>    = `<key>` or `<mods>+<key>`\n* <mods>     = `<mod>+<mod>+...`\n* <mod>      = `<modifier>` (required) or `[<modifier>]` (optional)\n* <key>      = `<KeyboardEvent.key>` or `<KeyboardEvent.code>` (case-insensitive)\n* <key>      = `(<regex>)` -> `/^(?:<regex>)$/iy` (case-insensitive)\n* ```\n*/\nfunction parseKeybinding(str) {\n\treturn str.trim().split(\" \").map((press) => {\n\t\tlet parts = press.split(/(?<=\\w|\\])\\+/);\n\t\tlet last = parts.pop();\n\t\tlet regex = last.match(/^\\((.+)\\)$/);\n\t\tlet key = regex ? new RegExp(`^(?:${regex[1]})$`, \"iv\") : last;\n\t\tlet requiredModifiers = [];\n\t\tlet optionalModifiers = [];\n\t\tfor (const part of parts) {\n\t\t\tlet optional = part.match(/^\\[(.*)\\]$/);\n\t\t\tlet mod = optional?.[1] ?? part;\n\t\t\tmod = mod === \"$mod\" ? MOD : mod;\n\t\t\tif (optional) optionalModifiers.push(mod);\n\t\t\telse requiredModifiers.push(mod);\n\t\t}\n\t\treturn [\n\t\t\trequiredModifiers,\n\t\t\toptionalModifiers,\n\t\t\tkey\n\t\t];\n\t});\n}\n/**\n* This tells us if a single keyboard event matches a single keybinding press.\n*/\nfunction matchKeybindingPress(event, [requiredModifiers, optionalModifiers, key]) {\n\tconst hasAltGraph = requiredModifiers.includes(\"AltGraph\");\n\treturn !((key instanceof RegExp ? !(key.test(event.key) || key.test(event.code)) : key.toUpperCase() !== event.key.toUpperCase() && key !== event.code) || requiredModifiers.find((mod) => {\n\t\treturn !getModifierState(event, mod);\n\t}) || KEYBINDING_MODIFIER_KEYS.find((mod) => {\n\t\treturn !requiredModifiers.includes(mod) && !optionalModifiers.includes(mod) && key !== mod && getModifierState(event, mod) && !(hasAltGraph && ALT_GRAPH_ALIASES.includes(mod));\n\t}));\n}\n/**\n* Creates an event listener for handling keybindings.\n*\n* @example\n* ```js\n* import { createKeybindingsHandler } from \"../src/keybindings\"\n*\n* let handler = createKeybindingsHandler({\n* \t\"Shift+d\": () => {\n* \t\talert(\"The 'Shift' and 'd' keys were pressed at the same time\")\n* \t},\n* \t\"y e e t\": () => {\n* \t\talert(\"The keys 'y', 'e', 'e', and 't' were pressed in order\")\n* \t},\n* \t\"$mod+d\": () => {\n* \t\talert(\"Either 'Control+d' or 'Meta+d' were pressed\")\n* \t},\n* })\n*\n* window.addEventListener(\"keydown\", handler)\n* ```\n*/\nfunction createKeybindingsHandler(keybindingsMap, options = {}) {\n\tlet timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\tlet ignore = options.ignore ?? defaultKeybindingsHandlerIgnore;\n\tlet keybindings = Object.keys(keybindingsMap).map((input) => {\n\t\treturn [\n\t\t\tinput,\n\t\t\tparseKeybinding(input),\n\t\t\tkeybindingsMap[input]\n\t\t];\n\t});\n\tlet pending = /* @__PURE__ */ new Map();\n\tlet timer = null;\n\treturn (event) => {\n\t\tif (!isKeyboardEvent(event) || ignore(event)) return;\n\t\tlet conflicts = [];\n\t\tfor (let [input, sequence, handler] of keybindings) {\n\t\t\tlet prev = pending.get(input);\n\t\t\tlet [current, ...rest] = prev ? prev : sequence;\n\t\t\tif (!matchKeybindingPress(event, current)) {\n\t\t\t\tif (!getModifierState(event, event.key)) pending.delete(input);\n\t\t\t} else if (rest.length > 0) {\n\t\t\t\tpending.set(input, rest);\n\t\t\t\tconflicts.push(input);\n\t\t\t} else {\n\t\t\t\tpending.delete(input);\n\t\t\t\tif (conflicts.length) console.warn(`tinykeys: Conflict found, \"${input}\" did not fire, waiting for:`, conflicts);\n\t\t\t\telse {\n\t\t\t\t\thandler(event);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (timer) clearTimeout(timer);\n\t\ttimer = setTimeout(() => pending.clear(), timeout);\n\t};\n}\n/**\n* Subscribes to keybindings.\n*\n* Returns an unsubscribe method.\n*\n* @example\n* ```js\n* import { tinykeys } from \"../src/tinykeys\"\n*\n* tinykeys(window, {\n* \t\"Shift+d\": () => {\n* \t\talert(\"The 'Shift' and 'd' keys were pressed at the same time\")\n* \t},\n* \t\"y e e t\": () => {\n* \t\talert(\"The keys 'y', 'e', 'e', and 't' were pressed in order\")\n* \t},\n* \t\"$mod+d\": () => {\n* \t\talert(\"Either 'Control+d' or 'Meta+d' were pressed\")\n* \t},\n* })\n* ```\n*/\nfunction tinykeys(target, keybindingMap, options = {}) {\n\tlet event = options.event ?? DEFAULT_EVENT;\n\tlet onKeyEvent = createKeybindingsHandler(keybindingMap, options);\n\ttarget.addEventListener(event, onKeyEvent, options.capture);\n\treturn () => {\n\t\ttarget.removeEventListener(event, onKeyEvent, options.capture);\n\t};\n}\n//#endregion\nexport { createKeybindingsHandler, defaultKeybindingsHandlerIgnore, matchKeybindingPress, parseKeybinding, tinykeys };\n\n//# sourceMappingURL=tinykeys.mjs.map"],"names":["KEYBINDING_MODIFIER_KEYS","DEFAULT_TIMEOUT","PLATFORM","navigator","platform","MOD","test","ALT_GRAPH_ALIASES","defaultKeybindingsHandlerIgnore","event","target","repeat","isComposing","currentTarget","matches","getModifierState","mod","includes","matchKeybindingPress","requiredModifiers","optionalModifiers","key","hasAltGraph","RegExp","code","toUpperCase","find","createKeybindingsHandler","keybindingsMap","options","timeout","ignore","keybindings","Object","keys","map","input","str","trim","split","press","parts","last","pop","regex","match","part","optional","push","pending","Map","timer","isKeyboardEvent","conflicts","sequence","handler","prev","get","current","rest","length","set","delete","console","warn","clearTimeout","setTimeout","clear","tinykeys","keybindingMap","onKeyEvent","addEventListener","capture","removeEventListener"],"mappings":"AAMA,IAAIA,EAA2B,CAC9B,QACA,OACA,MACA,WAMGC,EAAkB,IASlBC,EAAgC,iBAAdC,UAAyBA,UAAUC,SAAW,GAIhEC,EAAM,uBAAuBC,KAAKJ,GAAY,OAAS,UASvDK,EAAiC,UAAbL,EAAuB,CAAC,UAAW,OAAS,CAAC,OAarE,SAASM,EAAgCC,GACxC,IAAIC,EAASD,EAAMC,OACnB,OAAOD,EAAME,QAAUF,EAAMG,aAAeF,IAAWD,EAAMI,eAAiBH,EAAOI,QAAQ,0CAC9F,CAKA,SAASC,EAAiBN,EAAOO,GAChC,MAAyC,mBAA3BP,EAAMM,mBAAkCN,EAAMM,iBAAiBC,IAAQT,EAAkBU,SAASD,IAAQP,EAAMM,iBAAiB,YAChJ,CAuCA,SAASG,EAAqBT,GAAQU,EAAmBC,EAAmBC,IAC3E,MAAMC,EAAcH,EAAkBF,SAAS,YAC/C,SAAUI,aAAeE,QAAWF,EAAIf,KAAKG,EAAMY,OAAQA,EAAIf,KAAKG,EAAMe,MAASH,EAAII,gBAAkBhB,EAAMY,IAAII,eAAiBJ,IAAQZ,EAAMe,OAASL,EAAkBO,MAAMV,IAC1KD,EAAiBN,EAAOO,MAC3BhB,EAAyB0B,MAAMV,IAC5BG,EAAkBF,SAASD,KAASI,EAAkBH,SAASD,IAAQK,IAAQL,GAAOD,EAAiBN,EAAOO,MAAUM,GAAef,EAAkBU,SAASD,MAE5K,CAuBA,SAASW,EAAyBC,EAAgBC,EAAU,IAC3D,IAAIC,EAAUD,EAAQC,SAAW7B,EAC7B8B,EAASF,EAAQE,QAAUvB,EAC3BwB,EAAcC,OAAOC,KAAKN,GAAgBO,KAAKC,IAClD,MAAO,CACNA,GA5DsBC,EA6DND,EA5DXC,EAAIC,OAAOC,MAAM,KAAKJ,KAAKK,IACjC,IAAIC,EAAQD,EAAMD,MAAM,gBACpBG,EAAOD,EAAME,MACbC,EAAQF,EAAKG,MAAM,cACnBxB,EAAMuB,EAAQ,IAAIrB,OAAO,OAAOqB,EAAM,OAAQ,MAAQF,EACtDvB,EAAoB,GACpBC,EAAoB,GACxB,IAAK,MAAM0B,KAAQL,EAAO,CACzB,IAAIM,EAAWD,EAAKD,MAAM,cACtB7B,EAAM+B,IAAW,IAAMD,EAC3B9B,EAAc,SAARA,EAAiBX,EAAMW,EACzB+B,EAAU3B,EAAkB4B,KAAKhC,GAChCG,EAAkB6B,KAAKhC,EAC5B,CACD,MAAO,CACNG,EACAC,EACAC,EACA,KA2CAO,EAAeQ,IA9DlB,IAAyBC,CA+DtB,IAEEY,EAA0B,IAAIC,IAC9BC,EAAQ,KACZ,OAAQ1C,IACP,IAnGF,SAAyBA,GACxB,SAAUA,EAAMY,KAAOZ,EAAMe,MAAQf,EAAMM,iBAC5C,CAiGOqC,CAAgB3C,IAAUsB,EAAOtB,GAAQ,OAC9C,IAAI4C,EAAY,GAChB,IAAK,IAAKjB,EAAOkB,EAAUC,KAAYvB,EAAa,CACnD,IAAIwB,EAAOP,EAAQQ,IAAIrB,IAClBsB,KAAYC,GAAQH,GAAcF,EACvC,GAAKpC,EAAqBT,EAAOiD,GAE1B,GAAIC,EAAKC,OAAS,EACxBX,EAAQY,IAAIzB,EAAOuB,GACnBN,EAAUL,KAAKZ,OACT,CAEN,GADAa,EAAQa,OAAO1B,IACXiB,EAAUO,OACT,CACJL,EAAQ9C,GACR,KACA,CAJqBsD,QAAQC,KAAK,8BAA8B5B,gCAAqCiB,EAKtG,MAXKtC,EAAiBN,EAAOA,EAAMY,MAAM4B,EAAQa,OAAO1B,EAYzD,CACGe,GAAOc,aAAad,GACxBA,EAAQe,YAAW,IAAMjB,EAAQkB,SAASrC,EAAQ,CAEpD,CAuBA,SAASsC,EAAS1D,EAAQ2D,EAAexC,EAAU,CAAA,GAClD,IAAIpB,EAAQoB,EAAQpB,OAzKD,UA0Kf6D,EAAa3C,EAAyB0C,EAAexC,GAEzD,OADAnB,EAAO6D,iBAAiB9D,EAAO6D,EAAYzC,EAAQ2C,SAC5C,KACN9D,EAAO+D,oBAAoBhE,EAAO6D,EAAYzC,EAAQ2C,QAAQ,CAEhE","x_google_ignoreList":[0]}

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";import"./localization23.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 j(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,j 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":"mrBAqBA,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"}