@spectral_labs/ui 1.0.2 → 1.1.1

package/dist/components/app-bar/app-bar.svelte

@@ -83,6 +83,25 @@
     flex-shrink: 0;
   }
 
+  /**
+   * Push the trailing slot to the far right of `.sp-app-bar-row`. In small
+   * mode the row layout is `leading | title | children | trailing` ; only
+   * `.sp-app-bar-title` (when present) carries `flex: 1` to push trailing
+   * right. When the consumer renders the brand inside the `leading`
+   * snippet and omits `title` (e.g. to keep a clickable brand link), the
+   * trailing collapsed against the leading. `margin-left: auto` makes the
+   * trailing universally right-aligned without changing the title spacer
+   * logic — neutral when title is present (title already absorbs the row
+   * flex), corrective when title is absent.
+   *
+   * Medium/large modes use `.sp-app-bar-spacer` as the explicit flex
+   * spacer, so trailing is already right-aligned there. We scope this
+   * fix to `.small` only to avoid surprise.
+   */
+  .sp-app-bar.small .sp-app-bar-trailing {
+    margin-left: auto;
+  }
+
   .sp-app-bar-headline {
     padding: 0 1rem 1.5rem;
   }

package/dist/components/combobox/__tests__/ComboboxTest.svelte

@@ -1,4 +1,5 @@
 <script lang='ts'>
+  import type { Align, Side } from '../../../internal/floating-layer/types.js'
   import ComboboxContent from '../components/combobox-content.svelte'
   import ComboboxInput from '../components/combobox-input.svelte'
   import ComboboxItem from '../components/combobox-item.svelte'
@@ -11,6 +12,9 @@
     portalTo,
     disablePortal,
     contentClass,
+    side,
+    sideOffset,
+    align,
     onOpenChange,
   }: {
     value?: string
@@ -19,13 +23,16 @@
     portalTo?: HTMLElement | string
     disablePortal?: boolean
     contentClass?: string
+    side?: Side
+    sideOffset?: number
+    align?: Align
     onOpenChange?: (open: boolean) => void
   } = $props()
 </script>
 
 <ComboboxRoot bind:value bind:open {name} {onOpenChange}>
   <ComboboxInput placeholder='Search...' />
-  <ComboboxContent {portalTo} {disablePortal} class={contentClass}>
+  <ComboboxContent {portalTo} {disablePortal} class={contentClass} {side} {sideOffset} {align}>
     <ComboboxItem value='apple'>Apple</ComboboxItem>
     <ComboboxItem value='banana'>Banana</ComboboxItem>
     <ComboboxItem value='cherry'>Cherry</ComboboxItem>

package/dist/components/combobox/__tests__/combobox.test.svelte.js

@@ -1,5 +1,5 @@
 import { flushSync, mount, unmount } from 'svelte';
-import { afterEach, describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
 import ComboboxRoot from '../components/combobox-root.svelte';
 import ComboboxTest from './ComboboxTest.svelte';
 describe('combobox', () => {
@@ -142,6 +142,64 @@ describe('combobox', () => {
         // Should have opened because isComposing was false
         expect(target.querySelector('.sp-combobox-root')?.getAttribute('data-state')).toBe('open');
     });
+    describe('content positioning (FloatingLayerState)', () => {
+        // Floating UI's computePosition is async; give it a microtask to run.
+        async function openAndWaitForFloating(props = {}) {
+            setup(props);
+            const input = target.querySelector('[role="combobox"]');
+            input.dispatchEvent(new FocusEvent('focus', { bubbles: true }));
+            flushSync();
+        }
+        it('applies inline position:absolute on content after opening', async () => {
+            await openAndWaitForFloating({ disablePortal: true });
+            const content = target.querySelector('.sp-combobox-content');
+            await vi.waitFor(() => {
+                expect(content.style.position).toBe('absolute');
+            });
+        });
+        it('applies inline top and left written by Floating UI (not CSS 100%/0)', async () => {
+            await openAndWaitForFloating({ disablePortal: true });
+            const content = target.querySelector('.sp-combobox-content');
+            await vi.waitFor(() => {
+                // Floating UI writes pixel values — in jsdom they resolve to '0px'
+                // since getBoundingClientRect returns zero, but the values must be
+                // *inline styles* (not CSS rules) so the '100%' top and '0' right
+                // that caused the bug are gone.
+                expect(content.style.top).toMatch(/px$/);
+                expect(content.style.left).toMatch(/px$/);
+            });
+        });
+        it('accepts the side prop (default: bottom)', async () => {
+            await openAndWaitForFloating({ disablePortal: true, side: 'top' });
+            const content = target.querySelector('.sp-combobox-content');
+            expect(content).toBeTruthy();
+        });
+        it('accepts the sideOffset prop', async () => {
+            await openAndWaitForFloating({ disablePortal: true, sideOffset: 12 });
+            const content = target.querySelector('.sp-combobox-content');
+            expect(content).toBeTruthy();
+        });
+        it('accepts the align prop', async () => {
+            await openAndWaitForFloating({ disablePortal: true, align: 'center' });
+            const content = target.querySelector('.sp-combobox-content');
+            expect(content).toBeTruthy();
+        });
+        it('does not stretch to full body width anymore when portaled', async () => {
+            // Regression: the bug rendered the content with right:0 against body,
+            // producing a full-viewport-width menu. After the fix, the content is
+            // positioned (via FloatingLayerState) and does NOT have `right: 0`
+            // inherited from the stylesheet.
+            await openAndWaitForFloating({});
+            const content = document.body.querySelector('.sp-combobox-content');
+            await vi.waitFor(() => {
+                const cs = window.getComputedStyle(content);
+                // Floating UI writes `left` inline → `right` in CSS should not be 0
+                // (the old buggy rule `right: 0` is removed). A reasonable proxy:
+                // assert that `width` isn't pinned to viewport / body width.
+                expect(cs.right).not.toBe('0px');
+            });
+        });
+    });
     describe('portal opt-out (disablePortal)', () => {
         it('portals to document.body by default', () => {
             const localTarget = document.createElement('div');

package/dist/components/combobox/components/combobox-content.svelte

@@ -2,12 +2,24 @@
   import type { ComboboxContentProps } from '../types.js'
   import { DismissibleLayerState } from '../../../internal/dismissible-layer/index.js'
   import { EscapeLayerState } from '../../../internal/escape-layer/index.js'
+  import { FloatingLayerState } from '../../../internal/floating-layer/index.js'
   import { isBrowser } from '../../../internal/helpers/index.js'
   import { Portal } from '../../../internal/portal/index.js'
   import { PresenceLayerState } from '../../../internal/presence-layer/index.js'
   import { getComboboxContext } from '../combobox.svelte.js'
 
-  const { portalTo, disablePortal, class: className, children }: ComboboxContentProps = $props()
+  const {
+    side = 'bottom',
+    sideOffset = 4,
+    align = 'start',
+    alignOffset = 0,
+    avoidCollisions = true,
+    portalTo,
+    disablePortal,
+    class: className,
+    children,
+  }: ComboboxContentProps = $props()
+
   const ctx = getComboboxContext()
   let contentEl: HTMLElement | undefined = $state()
 
@@ -32,16 +44,38 @@
       ctx.close()
     },
   })
+  const floating = new FloatingLayerState({
+    reference: null,
+    floating: null,
+    get side() {
+      return side
+    },
+    get sideOffset() {
+      return sideOffset
+    },
+    get align() {
+      return align
+    },
+    get alignOffset() {
+      return alignOffset
+    },
+    get avoidCollisions() {
+      return avoidCollisions
+    },
+  })
 
   $effect(() => {
     if (ctx.open && isBrowser && contentEl) {
       escapeLayer.mount()
       dismissLayer.props.element = contentEl
       dismissLayer.mount()
+      floating.setElements(ctx.inputEl, contentEl)
+      floating.startAutoUpdate()
     }
     return () => {
       escapeLayer.unmount()
       dismissLayer.unmount()
+      floating.stopAutoUpdate()
     }
   })
 
@@ -69,11 +103,8 @@
 <style>
   .sp-combobox-content {
     position: absolute;
-    top: 100%;
-    left: 0;
-    right: 0;
     z-index: 50;
-    margin-top: 4px;
+    min-width: var(--sp-floating-anchor-width, 12rem);
     padding: 0.25rem;
     background-color: var(--sp-sys-color-surface-container);
     border-radius: var(--sp-sys-shape-corner-md, 12px);

package/dist/components/combobox/components/combobox-content.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combobox-content.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/combobox/components/combobox-content.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAyEvD,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"combobox-content.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/combobox/components/combobox-content.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AA4GvD,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/components/combobox/index.d.ts

@@ -2,5 +2,5 @@ export { default as Content } from './components/combobox-content.svelte';
 export { default as Input } from './components/combobox-input.svelte';
 export { default as Item } from './components/combobox-item.svelte';
 export { default as Root } from './components/combobox-root.svelte';
-export type { ComboboxItemProps, ComboboxProps } from './types.js';
+export type { ComboboxContentProps, ComboboxInputProps, ComboboxItemProps, ComboboxProps } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/combobox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/components/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACnE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/components/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mCAAmC,CAAA;AACnE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/combobox/types.d.ts

@@ -1,5 +1,6 @@
 import type { Snippet } from 'svelte';
 import type { HTMLInputAttributes } from 'svelte/elements';
+import type { Align, Side } from '../../internal/floating-layer/types.js';
 export interface ComboboxProps {
     /** Selected value. */
     value?: string;
@@ -24,6 +25,33 @@ export interface ComboboxInputProps extends Omit<HTMLInputAttributes, 'class' |
     class?: string;
 }
 export interface ComboboxContentProps {
+    /**
+     * Preferred side of the input to render the listbox on. The listbox may
+     * flip to the opposite side if collision detection is enabled and there
+     * is not enough space.
+     * @default 'bottom'
+     */
+    side?: Side;
+    /**
+     * Distance in pixels between the input and the listbox.
+     * @default 4
+     */
+    sideOffset?: number;
+    /**
+     * Alignment along the perpendicular axis of `side`.
+     * @default 'start'
+     */
+    align?: Align;
+    /**
+     * Pixel offset along the alignment axis.
+     * @default 0
+     */
+    alignOffset?: number;
+    /**
+     * Whether the listbox should flip / shift to stay inside the viewport.
+     * @default true
+     */
+    avoidCollisions?: boolean;
     /**
      * Target element or CSS selector to portal the content into.
      * Defaults to `document.body`.

package/dist/components/combobox/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/components/combobox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAC9C,mBAAmB,EACjB,OAAO,GACP,UAAU,GACV,OAAO,GACP,UAAU,GACV,MAAM,GACN,MAAM,GACN,IAAI,GACJ,eAAe,GACf,eAAe,GACf,uBAAuB,GACvB,mBAAmB,GACnB,cAAc,GACd,SAAS,GACT,SAAS,GACT,WAAW,CACd;IACC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC/B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/components/combobox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAA;AAEzE,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAC9C,mBAAmB,EACjB,OAAO,GACP,UAAU,GACV,OAAO,GACP,UAAU,GACV,MAAM,GACN,MAAM,GACN,IAAI,GACJ,eAAe,GACf,eAAe,GACf,uBAAuB,GACvB,mBAAmB,GACnB,cAAc,GACd,SAAS,GACT,SAAS,GACT,WAAW,CACd;IACC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAA;IACX;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC/B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB"}

package/dist/components/language-select/__tests__/language-select.test.svelte.js

@@ -0,0 +1,199 @@
+import { flushSync, mount, unmount } from 'svelte';
+import { afterEach, describe, expect, it } from 'vitest';
+import { getLanguages } from '../../../internal/i18n/languages.js';
+import LanguageSelect from '../language-select.svelte';
+describe('language-select', () => {
+    let target;
+    let instance;
+    function setup(props = {}) {
+        target = document.createElement('div');
+        document.body.appendChild(target);
+        instance = mount(LanguageSelect, { target, props });
+        flushSync();
+        return target;
+    }
+    afterEach(() => {
+        if (instance)
+            unmount(instance);
+        target?.remove();
+    });
+    // ── Shared behavior (variant-agnostic) ────────────────────────────────────
+    describe('shared behavior', () => {
+        it('renders the wrapper with the sp-language-select class (default variant)', () => {
+            setup();
+            expect(target.querySelector('.sp-language-select')).toBeTruthy();
+        });
+        it('renders the label when provided (default variant)', () => {
+            setup({ label: 'UI language' });
+            expect(target.querySelector('.sp-language-select-label')?.textContent).toBe('UI language');
+        });
+        it('applies the consumer-supplied class to the wrapper (default variant)', () => {
+            setup({ class: 'my-wrapper' });
+            expect(target.querySelector('.sp-language-select.my-wrapper')).toBeTruthy();
+        });
+        it('renders the wrapper correctly in combobox variant', () => {
+            setup({ variant: 'combobox' });
+            expect(target.querySelector('.sp-language-select')).toBeTruthy();
+        });
+        it('renders the label in combobox variant', () => {
+            setup({ variant: 'combobox', label: 'UI language' });
+            expect(target.querySelector('.sp-language-select-label')?.textContent).toBe('UI language');
+        });
+    });
+    // ── Default variant: 'select' ─────────────────────────────────────────────
+    describe('variant="select" (default)', () => {
+        it('renders a Select trigger (button), not a Combobox input', () => {
+            setup();
+            // Both Select.Trigger and Combobox.Input use role="combobox" (WAI-ARIA
+            // 1.2 pattern). Distinguish by tag: the Select variant uses a <button>.
+            expect(target.querySelector('button.sp-select-trigger')).toBeTruthy();
+            expect(target.querySelector('input[role="combobox"]')).toBeNull();
+        });
+        it('trigger has aria-haspopup="listbox"', () => {
+            setup();
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.getAttribute('aria-haspopup')).toBe('listbox');
+        });
+        it('passes the label as aria-label on the trigger', () => {
+            setup({ label: 'UI language' });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.getAttribute('aria-label')).toBe('UI language');
+        });
+        it('shows the native name of the selected language in the trigger', () => {
+            setup({ value: 'fr' });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.textContent).toContain('Français');
+        });
+        it('shows the native name for a non-latin selection (ja)', () => {
+            setup({ value: 'ja' });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.textContent).toContain('日本語');
+        });
+        it('displays an RTL language (العربية) correctly', () => {
+            setup({ value: 'ar' });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.textContent).toContain('العربية');
+        });
+        it('renders the hidden form input via Select.Root when name and value are provided', () => {
+            setup({ name: 'locale', value: 'fr' });
+            const hidden = target.querySelector('input[type="hidden"][name="locale"]');
+            expect(hidden).toBeTruthy();
+            expect(hidden?.value).toBe('fr');
+        });
+        it('disables the trigger when disabled=true', () => {
+            setup({ disabled: true });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.disabled).toBe(true);
+        });
+        it('accepts a custom items subset', () => {
+            const subset = getLanguages(['fr', 'en', 'de']);
+            setup({ items: subset, value: 'fr' });
+            const trigger = target.querySelector('.sp-select-trigger');
+            expect(trigger?.textContent).toContain('Français');
+        });
+        it('updates the trigger display and fires onValueChange when an item is clicked', () => {
+            const calls = [];
+            setup({ value: 'en', onValueChange: (code) => calls.push(code) });
+            // Open the Select by clicking the trigger.
+            const trigger = target.querySelector('button.sp-select-trigger');
+            trigger.click();
+            flushSync();
+            // Content is portaled to document.body by default.
+            const frItem = document.body.querySelector(`.sp-select-item[data-value="fr"]`);
+            expect(frItem).toBeTruthy();
+            frItem.click();
+            flushSync();
+            // Trigger display should now reflect the new selection.
+            expect(trigger.textContent).toContain('Français');
+            // onValueChange should have fired exactly once with the new code.
+            expect(calls).toEqual(['fr']);
+            // Cleanup: remove portaled content from document.body before next test.
+            document.body.querySelector('.sp-select-content')?.remove();
+        });
+    });
+    // ── Opt-in variant: 'combobox' ────────────────────────────────────────────
+    describe('variant="combobox"', () => {
+        it('renders a Combobox root in closed state by default', () => {
+            setup({ variant: 'combobox' });
+            const root = target.querySelector('.sp-combobox-root');
+            expect(root).toBeTruthy();
+            expect(root?.getAttribute('data-state')).toBe('closed');
+        });
+        it('renders a Combobox input (not a Select trigger)', () => {
+            setup({ variant: 'combobox' });
+            // Distinguish by tag: the Combobox variant uses an <input>.
+            expect(target.querySelector('input[role="combobox"]')).toBeTruthy();
+            expect(target.querySelector('button.sp-select-trigger')).toBeNull();
+        });
+        it('passes the label as aria-label on the input', () => {
+            setup({ variant: 'combobox', label: 'UI language' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.getAttribute('aria-label')).toBe('UI language');
+        });
+        it('uses the custom placeholder when no language is selected', () => {
+            setup({ variant: 'combobox', placeholder: 'Choose...' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.placeholder).toBe('Choose...');
+        });
+        it('falls back to a default placeholder when none is provided', () => {
+            setup({ variant: 'combobox' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.placeholder).toBe('Select a language');
+        });
+        it('shows the native name of the selected language in the input', () => {
+            setup({ variant: 'combobox', value: 'fr' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.value).toBe('Français');
+        });
+        it('shows the native name for a non-latin selection (ja)', () => {
+            setup({ variant: 'combobox', value: 'ja' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.value).toBe('日本語');
+        });
+        it('displays an RTL language (العربية) correctly', () => {
+            setup({ variant: 'combobox', value: 'ar' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.value).toBe('العربية');
+        });
+        it('renders a hidden form input with the BCP 47 code when name and value are provided', () => {
+            setup({ variant: 'combobox', name: 'locale', value: 'fr' });
+            const hidden = target.querySelector('input[type="hidden"][name="locale"]');
+            expect(hidden).toBeTruthy();
+            expect(hidden?.value).toBe('fr');
+        });
+        it('does not render a hidden input when no value is set', () => {
+            setup({ variant: 'combobox', name: 'locale' });
+            const hidden = target.querySelector('input[type="hidden"][name="locale"]');
+            expect(hidden).toBeNull();
+        });
+        it('passes the disabled flag through to the combobox input', () => {
+            setup({ variant: 'combobox', disabled: true });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.disabled).toBe(true);
+        });
+        it('accepts a custom items subset and silently ignores values outside it', () => {
+            const subset = getLanguages(['fr', 'en', 'de']);
+            setup({ variant: 'combobox', items: subset, value: 'it' });
+            const input = target.querySelector('[role="combobox"]');
+            expect(input?.placeholder).toBe('Select a language');
+        });
+        it('updates the input display and fires onValueChange when an item is clicked', () => {
+            const calls = [];
+            setup({ variant: 'combobox', value: 'en', onValueChange: (code) => calls.push(code) });
+            // Open the listbox by focusing the input.
+            const input = target.querySelector('input[role="combobox"]');
+            input.dispatchEvent(new FocusEvent('focus', { bubbles: true }));
+            flushSync();
+            // Combobox.Content portals to document.body by default.
+            const frItem = document.body.querySelector(`.sp-combobox-item[data-value^="fr"]`);
+            expect(frItem).toBeTruthy();
+            frItem.click();
+            flushSync();
+            // After selection the input should reflect the new native name.
+            expect(input.value).toBe('Français');
+            // onValueChange should have fired exactly once with the new BCP 47 code.
+            expect(calls).toEqual(['fr']);
+            document.body.querySelector('.sp-combobox-content')?.remove();
+        });
+    });
+});

package/dist/components/language-select/__tests__/languages.test.js

@@ -0,0 +1,87 @@
+import { describe, expect, it } from 'vitest';
+import { getLanguage, getLanguages, LANGUAGES, } from '../../../internal/i18n/languages.js';
+describe('i18n/languages', () => {
+    describe('languages list', () => {
+        it('contains the 16 curated languages', () => {
+            expect(LANGUAGES).toHaveLength(16);
+        });
+        it('exposes valid BCP 47 codes', () => {
+            const codes = LANGUAGES.map(l => l.code);
+            expect(codes).toEqual([
+                'en',
+                'fr',
+                'de',
+                'it',
+                'id',
+                'ja',
+                'ko',
+                'pt',
+                'es',
+                'zh-Hans',
+                'hi',
+                'ar',
+                'bn',
+                'ru',
+                'ur',
+                'tr',
+            ]);
+        });
+        it('marks ar and ur as rtl and the rest as ltr', () => {
+            const rtl = LANGUAGES.filter(l => l.dir === 'rtl').map(l => l.code);
+            expect(rtl).toEqual(['ar', 'ur']);
+            const ltr = LANGUAGES.filter(l => l.dir === 'ltr').map(l => l.code);
+            expect(ltr).toHaveLength(14);
+        });
+        it('has a non-empty nativeName and englishName for each entry', () => {
+            for (const lang of LANGUAGES) {
+                expect(lang.nativeName.length).toBeGreaterThan(0);
+                expect(lang.englishName.length).toBeGreaterThan(0);
+            }
+        });
+        it('is frozen (cannot be mutated)', () => {
+            expect(Object.isFrozen(LANGUAGES)).toBe(true);
+        });
+        it('has no duplicate codes', () => {
+            const codes = LANGUAGES.map(l => l.code);
+            expect(new Set(codes).size).toBe(codes.length);
+        });
+    });
+    describe('getLanguages', () => {
+        it('returns the requested subset in the requested order', () => {
+            const result = getLanguages(['fr', 'en', 'de']);
+            expect(result.map(l => l.code)).toEqual(['fr', 'en', 'de']);
+        });
+        it('preserves user-specified order even when reversed vs LANGUAGES', () => {
+            const result = getLanguages(['de', 'en', 'fr']);
+            expect(result.map(l => l.code)).toEqual(['de', 'en', 'fr']);
+        });
+        it('silently drops unknown codes', () => {
+            const result = getLanguages(['fr', 'xx', 'en']);
+            expect(result.map(l => l.code)).toEqual(['fr', 'en']);
+        });
+        it('returns [] for an empty input', () => {
+            expect(getLanguages([])).toEqual([]);
+        });
+        it('returns full LanguageOption objects (not just codes)', () => {
+            const [fr] = getLanguages(['fr']);
+            expect(fr).toMatchObject({
+                code: 'fr',
+                nativeName: 'Français',
+                englishName: 'French',
+                dir: 'ltr',
+            });
+        });
+    });
+    describe('getLanguage', () => {
+        it('returns the language matching the given code', () => {
+            expect(getLanguage('ja')?.nativeName).toBe('日本語');
+        });
+        it('returns undefined for unknown codes', () => {
+            expect(getLanguage('xx')).toBeUndefined();
+        });
+        it('finds RTL languages correctly', () => {
+            expect(getLanguage('ar')?.dir).toBe('rtl');
+            expect(getLanguage('ur')?.dir).toBe('rtl');
+        });
+    });
+});

package/dist/components/language-select/index.d.ts

@@ -0,0 +1,3 @@
+export { default as LanguageSelect } from './language-select.svelte';
+export type { LanguageSelectProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/language-select/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/components/language-select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/language-select/index.js

@@ -0,0 +1 @@
+export { default as LanguageSelect } from './language-select.svelte';

package/dist/components/language-select/language-select.svelte

@@ -0,0 +1,200 @@
+<script lang='ts'>
+  import type { LanguageOption } from '../../internal/i18n/languages.js'
+  import type { LanguageSelectProps } from './types.js'
+  import { LANGUAGES } from '../../internal/i18n/languages.js'
+  import * as Combobox from '../combobox/index.js'
+  import * as Select from '../select/index.js'
+
+  let {
+    variant = 'select',
+    items = LANGUAGES,
+    value = $bindable<string | undefined>(undefined),
+    onValueChange,
+    label,
+    placeholder,
+    disabled = false,
+    name,
+    side,
+    sideOffset,
+    align,
+    class: className,
+  }: LanguageSelectProps = $props()
+
+  // ── Shared helpers ────────────────────────────────────────────────────────
+
+  function nativeNameFor(code: string | undefined): string {
+    if (!code)
+      return ''
+    return items.find(l => l.code === code)?.nativeName ?? ''
+  }
+
+  // ── Combobox variant — composite value trick ─────────────────────────────
+  //
+  // `Combobox` built-in filter matches `item.value.includes(search)`, so we
+  // encode each option as `code␟native␟english` (U+241F is a reserved
+  // information separator never present in user-entered text) to let the
+  // filter match native name, English name, or BCP 47 code. The wrapper
+  // exposes only the BCP 47 code externally.
+
+  const SEP = '␟'
+
+  function toComposite(item: LanguageOption): string {
+    return `${item.code}${SEP}${item.nativeName.toLowerCase()}${SEP}${item.englishName.toLowerCase()}`
+  }
+
+  function codeOf(composite: string): string {
+    const [code = ''] = composite.split(SEP)
+    return code
+  }
+
+  function compositeFor(code: string | undefined): string {
+    if (!code)
+      return ''
+    const item = items.find(l => l.code === code)
+    return item ? toComposite(item) : ''
+  }
+
+  // ── Sync plumbing ───────────────────────────────────────────────────────
+  //
+  // `lastExternalCode` tracks the most recent value that either flowed in
+  // from outside (consumer `bind:value` write) or out to outside (user
+  // interaction). It acts as a tiebreaker so the two sync effects don't
+  // overwrite each other: the "external → internal" effect only fires when
+  // `value` drifts from the last known external code, and the "internal →
+  // external" effect only fires when the internal state drifts from it.
+
+  let lastExternalCode: string | undefined = value
+
+  let selectValue = $state<string>(value ?? '')
+  let compositeValue = $state<string>(compositeFor(value))
+  let searchQuery = $state<string>(nativeNameFor(value))
+
+  // External `value` → internal state, only when value genuinely changed
+  // from outside (i.e. differs from the last code we synced).
+  $effect(() => {
+    if (value === lastExternalCode)
+      return
+    lastExternalCode = value
+    if (variant === 'select') {
+      const v = value ?? ''
+      if (selectValue !== v)
+        selectValue = v
+    }
+    else {
+      const expected = compositeFor(value)
+      if (compositeValue !== expected)
+        compositeValue = expected
+      searchQuery = nativeNameFor(value)
+    }
+  })
+
+  // Internal state → external `value`, only when user interaction moved it.
+  $effect(() => {
+    if (variant !== 'select')
+      return
+    const code: string | undefined = selectValue || undefined
+    if (code !== lastExternalCode) {
+      lastExternalCode = code
+      value = code
+      if (code !== undefined)
+        onValueChange?.(code)
+    }
+  })
+
+  $effect(() => {
+    if (variant !== 'combobox')
+      return
+    const code: string | undefined = codeOf(compositeValue) || undefined
+    if (code !== lastExternalCode) {
+      lastExternalCode = code
+      value = code
+      if (code !== undefined)
+        onValueChange?.(code)
+    }
+  })
+
+  function handleComboboxOpenChange(open: boolean): void {
+    // Combobox clears `search` on selection; restore native name on close so
+    // the input reflects the current selection even though search is empty.
+    if (open) {
+      searchQuery = ''
+    }
+    else {
+      const code = codeOf(compositeValue)
+      searchQuery = nativeNameFor(code)
+    }
+  }
+</script>
+
+<div class="sp-language-select {className ?? ''}">
+  {#if label}
+    <span class='sp-language-select-label'>{label}</span>
+  {/if}
+
+  {#if variant === 'select'}
+    <Select.Root bind:value={selectValue} {disabled} {name}>
+      <Select.Trigger
+        placeholder={placeholder || 'Select a language'}
+        aria-label={label}
+      >
+        {#if value && nativeNameFor(value)}
+          <span class='sp-language-select-native sp-select-value' dir='auto'>{nativeNameFor(value)}</span>
+        {:else}
+          <span class='sp-select-value placeholder'>{placeholder || 'Select a language'}</span>
+        {/if}
+      </Select.Trigger>
+      <Select.Content {side} {sideOffset} {align}>
+        {#each items as item (item.code)}
+          <Select.Item value={item.code} label={item.nativeName}>
+            <span class='sp-language-select-native' dir='auto'>{item.nativeName}</span>
+          </Select.Item>
+        {/each}
+      </Select.Content>
+    </Select.Root>
+  {:else}
+    <Combobox.Root
+      bind:value={compositeValue}
+      bind:search={searchQuery}
+      {disabled}
+      onOpenChange={handleComboboxOpenChange}
+    >
+      <Combobox.Input
+        placeholder={placeholder || nativeNameFor(value) || 'Select a language'}
+        aria-label={label}
+      />
+      <Combobox.Content {side} {sideOffset} {align}>
+        {#each items as item (item.code)}
+          <Combobox.Item value={toComposite(item)}>
+            <span class='sp-language-select-native' dir='auto'>{item.nativeName}</span>
+          </Combobox.Item>
+        {/each}
+      </Combobox.Content>
+    </Combobox.Root>
+
+    {#if name && value}
+      <input type='hidden' {name} {value} />
+    {/if}
+  {/if}
+</div>
+
+<style>
+  .sp-language-select {
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--sp-sys-spacing-xs, 0.25rem);
+    min-width: 200px;
+  }
+
+  .sp-language-select-label {
+    font-size: var(--sp-sys-typescale-label-medium-size, 0.75rem);
+    line-height: 1.4;
+    color: var(--sp-sys-color-on-surface-variant, inherit);
+  }
+
+  /* Bidirectional isolation for RTL native names displayed among LTR ones
+     (and vice versa). `dir="auto"` on the span triggers UA bidi resolution
+     based on the first strong character. */
+  .sp-language-select-native {
+    unicode-bidi: isolate;
+  }
+</style>

package/dist/components/language-select/language-select.svelte.d.ts

@@ -0,0 +1,5 @@
+import type { LanguageSelectProps } from './types.js';
+declare const LanguageSelect: import("svelte").Component<LanguageSelectProps, {}, "value">;
+type LanguageSelect = ReturnType<typeof LanguageSelect>;
+export default LanguageSelect;
+//# sourceMappingURL=language-select.svelte.d.ts.map

package/dist/components/language-select/language-select.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-select.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/language-select/language-select.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAiLrD,QAAA,MAAM,cAAc,8DAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/language-select/types.d.ts

@@ -0,0 +1,42 @@
+import type { Align, Side } from '../../internal/floating-layer/types.js';
+import type { LanguageOption } from '../../internal/i18n/languages.js';
+export type LanguageSelectVariant = 'select' | 'combobox';
+export interface LanguageSelectProps {
+    /**
+     * UI variant.
+     * - `'select'` (default) — classic dropdown: trigger button + listbox,
+     *   keyboard typeahead on the native name's first letter. Best for short
+     *   lists (2–6 languages) or when a compact control is preferred.
+     * - `'combobox'` — searchable input + filterable listbox. Search matches
+     *   against the native name, English name, or BCP 47 code. Best for the
+     *   full curated list or whenever keyword filtering is desirable.
+     * @default 'select'
+     */
+    variant?: LanguageSelectVariant;
+    /**
+     * Subset of languages to show. Defaults to the full curated list.
+     * Use {@link getLanguages} to build a subset from BCP 47 codes.
+     */
+    items?: readonly LanguageOption[];
+    /** Currently selected BCP 47 code. */
+    value?: string;
+    /** Called whenever the selected code changes. */
+    onValueChange?: (code: string) => void;
+    /** Optional visible label rendered above the control. */
+    label?: string;
+    /** Placeholder text when no language is selected. */
+    placeholder?: string;
+    /** Disable the control. */
+    disabled?: boolean;
+    /** Name of the hidden form field (for native form submission). */
+    name?: string;
+    /** Preferred side of the trigger to render the listbox on. @default 'bottom' */
+    side?: Side;
+    /** Pixel distance between trigger and listbox. @default 4 */
+    sideOffset?: number;
+    /** Alignment along the perpendicular axis of `side`. @default 'start' */
+    align?: Align;
+    /** Extra CSS class for the wrapper. */
+    class?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/language-select/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/components/language-select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEzD,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/components/language-select/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -44,6 +44,8 @@ export { Input } from './components/input/index.js';
 export type { InputProps, InputSize } from './components/input/index.js';
 export { Label } from './components/label/index.js';
 export type { LabelProps } from './components/label/index.js';
+export { LanguageSelect } from './components/language-select/index.js';
+export type { LanguageSelectProps } from './components/language-select/index.js';
 export * as LinkPreview from './components/link-preview/index.js';
 export * as List from './components/list/index.js';
 export * as Menubar from './components/menubar/index.js';
@@ -103,5 +105,7 @@ export * as Tree from './components/tree/index.js';
 export * as Virtualizer from './components/virtualizer/index.js';
 export type { DateRange, DateValue } from './internal/date-time/types.js';
 export type { DropItem, DropOperation, DropPosition, DropTarget } from './internal/drag-drop/index.js';
+export { getLanguage, getLanguages, LANGUAGES } from './internal/i18n/index.js';
+export type { LanguageOption } from './internal/i18n/index.js';
 export { CalendarDate, CalendarDateTime, getLocalTimeZone, today, ZonedDateTime } from '@internationalized/date';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -35,6 +35,7 @@ export * as HoverCard from './components/hover-card/index.js';
 export { Indicator } from './components/indicator/index.js';
 export { Input } from './components/input/index.js';
 export { Label } from './components/label/index.js';
+export { LanguageSelect } from './components/language-select/index.js';
 export * as LinkPreview from './components/link-preview/index.js';
 export * as List from './components/list/index.js';
 export * as Menubar from './components/menubar/index.js';
@@ -75,4 +76,6 @@ export { Toolbar, ToolbarGroup, ToolbarSeparator } from './components/toolbar/in
 export * as Tooltip from './components/tooltip/index.js';
 export * as Tree from './components/tree/index.js';
 export * as Virtualizer from './components/virtualizer/index.js';
+// i18n / locale utilities (re-exported for consumer convenience)
+export { getLanguage, getLanguages, LANGUAGES } from './internal/i18n/index.js';
 export { CalendarDate, CalendarDateTime, getLocalTimeZone, today, ZonedDateTime } from '@internationalized/date';

package/dist/internal/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export { getLanguage, getLanguages, LANGUAGES } from './languages.js';
+export type { LanguageOption } from './languages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/internal/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACrE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/internal/i18n/index.js

@@ -0,0 +1 @@
+export { getLanguage, getLanguages, LANGUAGES } from './languages.js';

package/dist/internal/i18n/languages.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Curated list of UI languages for Spectral UI locale pickers.
+ *
+ * Codes follow BCP 47. `nativeName` is the endonym (name in the language
+ * itself). `englishName` is used for keyword search and localization.
+ * `dir` is 'rtl' only for right-to-left scripts — consumers should apply
+ * bidi isolation (e.g. `dir="auto"`) when displaying these names.
+ */
+export interface LanguageOption {
+    /** BCP 47 language tag (e.g. `fr`, `zh-Hans`, `pt`). */
+    code: string;
+    /** Endonym — name of the language in the language itself. */
+    nativeName: string;
+    /** Name in English — used for keyword search. */
+    englishName: string;
+    /** Script direction. */
+    dir: 'ltr' | 'rtl';
+}
+export declare const LANGUAGES: readonly LanguageOption[];
+/**
+ * Return a subset of {@link LANGUAGES} matching the given codes, preserving
+ * the order of the `codes` array. Unknown codes are silently dropped.
+ *
+ * @example
+ * getLanguages(['fr', 'en', 'de'])
+ * // → [{ code: 'fr', ... }, { code: 'en', ... }, { code: 'de', ... }]
+ */
+export declare function getLanguages(codes: readonly string[]): LanguageOption[];
+/**
+ * Look up a single language option by BCP 47 code.
+ */
+export declare function getLanguage(code: string): LanguageOption | undefined;
+//# sourceMappingURL=languages.d.ts.map

package/dist/internal/i18n/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/lib/internal/i18n/languages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,GAAG,EAAE,KAAK,GAAG,KAAK,CAAA;CACnB;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,cAAc,EAiB7C,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,EAAE,CASvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEpE"}

package/dist/internal/i18n/languages.js

@@ -0,0 +1,42 @@
+export const LANGUAGES = Object.freeze([
+    { code: 'en', nativeName: 'English', englishName: 'English', dir: 'ltr' },
+    { code: 'fr', nativeName: 'Français', englishName: 'French', dir: 'ltr' },
+    { code: 'de', nativeName: 'Deutsch', englishName: 'German', dir: 'ltr' },
+    { code: 'it', nativeName: 'Italiano', englishName: 'Italian', dir: 'ltr' },
+    { code: 'id', nativeName: 'Indonesia', englishName: 'Indonesian', dir: 'ltr' },
+    { code: 'ja', nativeName: '日本語', englishName: 'Japanese', dir: 'ltr' },
+    { code: 'ko', nativeName: '한국어', englishName: 'Korean', dir: 'ltr' },
+    { code: 'pt', nativeName: 'Português', englishName: 'Portuguese', dir: 'ltr' },
+    { code: 'es', nativeName: 'Español', englishName: 'Spanish', dir: 'ltr' },
+    { code: 'zh-Hans', nativeName: '简体中文', englishName: 'Chinese (Simplified)', dir: 'ltr' },
+    { code: 'hi', nativeName: 'हिन्दी', englishName: 'Hindi', dir: 'ltr' },
+    { code: 'ar', nativeName: 'العربية', englishName: 'Arabic', dir: 'rtl' },
+    { code: 'bn', nativeName: 'বাংলা', englishName: 'Bengali', dir: 'ltr' },
+    { code: 'ru', nativeName: 'Русский', englishName: 'Russian', dir: 'ltr' },
+    { code: 'ur', nativeName: 'اردو', englishName: 'Urdu', dir: 'rtl' },
+    { code: 'tr', nativeName: 'Türkçe', englishName: 'Turkish', dir: 'ltr' },
+]);
+/**
+ * Return a subset of {@link LANGUAGES} matching the given codes, preserving
+ * the order of the `codes` array. Unknown codes are silently dropped.
+ *
+ * @example
+ * getLanguages(['fr', 'en', 'de'])
+ * // → [{ code: 'fr', ... }, { code: 'en', ... }, { code: 'de', ... }]
+ */
+export function getLanguages(codes) {
+    const byCode = new Map(LANGUAGES.map(lang => [lang.code, lang]));
+    const result = [];
+    for (const code of codes) {
+        const lang = byCode.get(code);
+        if (lang)
+            result.push(lang);
+    }
+    return result;
+}
+/**
+ * Look up a single language option by BCP 47 code.
+ */
+export function getLanguage(code) {
+    return LANGUAGES.find(lang => lang.code === code);
+}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@spectral_labs/ui",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.1.1",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
   "description": "Spectral UI — A styled and themeable design system for Svelte 5",
   "license": "MIT",
   "repository": {