@happyvertical/smrt-ui 0.53.3 → 0.53.5

package/README.md

@@ -1087,3 +1087,29 @@ their empty shape. Names and paths must be nonempty strings; invalid mixed sets
 are rejected atomically. Sets are snapshotted, so later caller mutations do not
 change glyphs. Register static application assets, never request or identity data,
 and install the same application set for SSR and client hydration.
+
+### Currency, country, and province controls
+
+Import `CurrencySelect`, `CountrySelect`, `ProvinceSelect`, their named `*Props`
+interfaces, and `CodeSelectOption` from `@happyvertical/smrt-ui/forms`. Each composes
+shared Select/Input controls, accepts a bindable string `value`, native Select
+attributes (except children/multiple), density and interaction configuration,
+`locale` (default `en`), `placeholder` (default `—`), and `readOnly`.
+
+Currency choices use existing ISO 4217 metadata. Countries cover 249 ISO 3166-1
+alpha-2 codes; both use Intl.DisplayNames and invalid locales fall back to English.
+ProvinceSelect accepts `country?: string`: built-ins cover Canada's 13 subdivisions
+and the United States' 57 ISO subdivisions (50 states, DC and six territories).
+Region labels default to English. Other/missing countries use a free-text Input.
+Provide `options?: readonly CodeSelectOption[]` to replace built-ins and localize
+region labels; even an empty array deliberately selects the custom Select mode.
+Each option has `value`, optional `label`, and optional `disabled`.
+
+Blank values stay blank; unknown values and country/options changes preserve the
+exact raw string. Callers validate permitted values server-side. Disabled options
+retain native FormData omission. `readOnly` disables the visible control and submits
+the original value via a hidden input, including external `form` association;
+`disabled` and disabled fieldsets omit it. Province event targets can be either
+HTMLInputElement or HTMLSelectElement. All controls expose `focus()` and
+`getElement()`. The Workbench code-selectors entry demonstrates changing countries
+and inspecting native payloads without a provider.

package/dist/components/forms/CodeSelect.svelte

@@ -0,0 +1,50 @@
+<script lang="ts">
+import type { ComponentProps } from 'svelte';
+import type { CodeSelectProps } from './code-select-types.js';
+import Input from './Input.svelte';
+import Select from './Select.svelte';
+
+interface Props extends CodeSelectProps {
+  /** Internal region fallback for countries without a built-in option list. */
+  freeText?: boolean;
+}
+let {
+  value = $bindable(''),
+  options = [],
+  placeholder = '—',
+  readOnly = false,
+  disabled = false,
+  freeText = false,
+  locale: _locale,
+  name,
+  form,
+  ...rest
+}: Props = $props();
+const hiddenId = $props.id();
+let select: Select | undefined = $state();
+let input: Input | undefined = $state();
+const choices = $derived(options.filter((option) => option.value !== ''));
+const retained = $derived(
+  value !== '' && !choices.some((option) => option.value === value),
+);
+// Only ProvinceSelect uses freeText; its public event types expose both targets.
+const inputRest = $derived(rest as Omit<ComponentProps<typeof Input>, 'value'>);
+/** Focus the active shared control. */
+export function focus(): void {
+  (freeText ? input : select)?.focus();
+}
+/** Return the active native element. */
+export function getElement(): HTMLInputElement | HTMLSelectElement | null {
+  return (freeText ? input : select)?.getElement() ?? null;
+}
+</script>
+{#if freeText}
+  <Input {...inputRest} bind:this={input} bind:value type="text" {name} {form} {placeholder} disabled={disabled || readOnly} />
+{:else}
+  <Select {...rest} bind:this={select} bind:value {name} {form} disabled={disabled || readOnly}>
+    <option value="">{placeholder}</option>
+    {#if retained}<option value={value}>{value}</option>{/if}
+    {#each choices as option}<option value={option.value} disabled={option.disabled}>{option.label ?? option.value}</option>{/each}
+  </Select>
+{/if}
+{#if readOnly}<Input id={hiddenId} type="hidden" {name} {form} {value} {disabled} interaction={false} />{/if}

package/dist/components/forms/CodeSelect.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { CodeSelectProps } from './code-select-types.js';
+interface Props extends CodeSelectProps {
+    /** Internal region fallback for countries without a built-in option list. */
+    freeText?: boolean;
+}
+declare const CodeSelect: import("svelte").Component<Props, {
+    focus: () => void;
+    getElement: () => HTMLInputElement | HTMLSelectElement | null;
+}, "value">;
+type CodeSelect = ReturnType<typeof CodeSelect>;
+export default CodeSelect;
+//# sourceMappingURL=CodeSelect.svelte.d.ts.map

package/dist/components/forms/CodeSelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeSelect.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/CodeSelect.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAK9D,UAAU,KAAM,SAAQ,eAAe;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkDD,QAAA,MAAM,UAAU;iBArBG,IAAI;sBAIC,gBAAgB,GAAG,iBAAiB,GAAG,IAAI;WAiBX,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/forms/CountrySelect.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+import CodeSelect from './CodeSelect.svelte';
+import { countryOptions } from './code-select-options.js';
+import type { CountrySelectProps } from './code-select-types.js';
+export interface Props extends CountrySelectProps {}
+let {
+  value = $bindable(''),
+  options,
+  locale = 'en',
+  ...rest
+}: Props = $props();
+let control: CodeSelect | undefined = $state();
+const choices = $derived(options ?? countryOptions(locale));
+/** Focus the active native control. */
+export function focus(): void {
+  control?.focus();
+}
+/** Return the actual native control, or null before mounting. */
+export function getElement() {
+  return control?.getElement() ?? null;
+}
+</script>
+<CodeSelect {...rest} bind:this={control} bind:value options={choices} />

package/dist/components/forms/CountrySelect.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { CountrySelectProps } from './code-select-types.js';
+export interface Props extends CountrySelectProps {
+}
+declare const CountrySelect: import("svelte").Component<Props, {
+    focus: () => void;
+    getElement: () => HTMLInputElement | HTMLSelectElement | null;
+}, "value">;
+type CountrySelect = ReturnType<typeof CountrySelect>;
+export default CountrySelect;
+//# sourceMappingURL=CountrySelect.svelte.d.ts.map

package/dist/components/forms/CountrySelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CountrySelect.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/CountrySelect.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,KAAM,SAAQ,kBAAkB;CAAG;AA2BpD,QAAA,MAAM,aAAa;iBAZA,IAAI;;WAYoC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/forms/CurrencySelect.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+import CodeSelect from './CodeSelect.svelte';
+import { currencyOptions } from './code-select-options.js';
+import type { CurrencySelectProps } from './code-select-types.js';
+export interface Props extends CurrencySelectProps {}
+let {
+  value = $bindable(''),
+  options,
+  locale = 'en',
+  ...rest
+}: Props = $props();
+let control: CodeSelect | undefined = $state();
+const choices = $derived(options ?? currencyOptions(locale));
+/** Focus the active native control. */
+export function focus(): void {
+  control?.focus();
+}
+/** Return the actual native control, or null before mounting. */
+export function getElement() {
+  return control?.getElement() ?? null;
+}
+</script>
+<CodeSelect {...rest} bind:this={control} bind:value options={choices} />

package/dist/components/forms/CurrencySelect.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { CurrencySelectProps } from './code-select-types.js';
+export interface Props extends CurrencySelectProps {
+}
+declare const CurrencySelect: import("svelte").Component<Props, {
+    focus: () => void;
+    getElement: () => HTMLInputElement | HTMLSelectElement | null;
+}, "value">;
+type CurrencySelect = ReturnType<typeof CurrencySelect>;
+export default CurrencySelect;
+//# sourceMappingURL=CurrencySelect.svelte.d.ts.map

package/dist/components/forms/CurrencySelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurrencySelect.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/CurrencySelect.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,WAAW,KAAM,SAAQ,mBAAmB;CAAG;AA2BrD,QAAA,MAAM,cAAc;iBAZD,IAAI;;WAYqC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/forms/ProvinceSelect.svelte

@@ -0,0 +1,24 @@
+<script lang="ts">
+import CodeSelect from './CodeSelect.svelte';
+import { provinceOptions } from './code-select-options.js';
+import type { ProvinceSelectProps } from './code-select-types.js';
+export interface Props extends ProvinceSelectProps {}
+let {
+  value = $bindable(''),
+  options,
+  locale = 'en',
+  country = '',
+  ...rest
+}: Props = $props();
+let control: CodeSelect | undefined = $state();
+const choices = $derived(options ?? provinceOptions(country));
+/** Focus the active native control. */
+export function focus(): void {
+  control?.focus();
+}
+/** Return the actual native control, or null before mounting. */
+export function getElement() {
+  return control?.getElement() ?? null;
+}
+</script>
+<CodeSelect {...rest} bind:this={control} bind:value options={choices} freeText={choices === undefined} />

package/dist/components/forms/ProvinceSelect.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { ProvinceSelectProps } from './code-select-types.js';
+export interface Props extends ProvinceSelectProps {
+}
+declare const ProvinceSelect: import("svelte").Component<Props, {
+    focus: () => void;
+    getElement: () => HTMLInputElement | HTMLSelectElement | null;
+}, "value">;
+type ProvinceSelect = ReturnType<typeof ProvinceSelect>;
+export default ProvinceSelect;
+//# sourceMappingURL=ProvinceSelect.svelte.d.ts.map

package/dist/components/forms/ProvinceSelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProvinceSelect.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ProvinceSelect.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,WAAW,KAAM,SAAQ,mBAAmB;CAAG;AA4BrD,QAAA,MAAM,cAAc;iBAZD,IAAI;;WAYqC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/forms/StagedControlReview.svelte

@@ -153,7 +153,9 @@ $effect(() => {
 $effect(() => {
   if (!formElement) return;
   const element = formElement;
-  const refreshAfterFieldEdit = () => refresh();
+  // Removing a focused input can dispatch change during a Svelte block effect.
+  // This DOM event refresh is independent of the block's reactive evaluation.
+  const refreshAfterFieldEdit = () => untrack(refresh);
   const refreshAfterReset = () => queueMicrotask(refresh);
   const discardAfterResetGesture = (event: MouseEvent) => {
     const target = event.target;

package/dist/components/forms/StagedControlReview.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StagedControlReview.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/StagedControlReview.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAG5E,MAAM,WAAW,KAAK;IACpB,gEAAgE;IAChE,QAAQ,EAAE,0BAA0B,CAAC;IACrC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC7C;AA2kBD,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"StagedControlReview.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/StagedControlReview.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,0BAA0B,EAE3B,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAG5E,MAAM,WAAW,KAAK;IACpB,gEAAgE;IAChE,QAAQ,EAAE,0BAA0B,CAAC;IACrC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC7C;AA6kBD,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/components/forms/code-select-options.d.ts

@@ -0,0 +1,8 @@
+import type { CodeSelectOption } from './code-select-types.js';
+/** Build localized choices from the shared ISO currency metadata. */
+export declare function currencyOptions(locale: string): CodeSelectOption[];
+/** Build localized ISO alpha-2 country choices. */
+export declare function countryOptions(locale: string): CodeSelectOption[];
+/** Return CA/US subdivision choices, or undefined for free-text countries. */
+export declare function provinceOptions(country: string): readonly CodeSelectOption[] | undefined;
+//# sourceMappingURL=code-select-options.d.ts.map

package/dist/components/forms/code-select-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-select-options.d.ts","sourceRoot":"","sources":["../../../src/components/forms/code-select-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAiT/D,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAMlE;AACD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGjE;AACD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GACd,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAEzC"}

package/dist/components/forms/code-select-options.js

@@ -0,0 +1,315 @@
+import { ISO_4217_MINOR_UNITS } from '../display/currency-metadata.js';
+// ISO 3166-1 alpha-2 and ISO 3166-2 CA/US snapshot from iso-codes 4.20.1.
+// https://salsa.debian.org/iso-codes-team/iso-codes (data, no runtime dependency).
+const countries = 'AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW'.split(' ');
+const regions = {
+    CA: [
+        {
+            value: 'AB',
+            label: 'Alberta',
+        },
+        {
+            value: 'BC',
+            label: 'British Columbia',
+        },
+        {
+            value: 'MB',
+            label: 'Manitoba',
+        },
+        {
+            value: 'NB',
+            label: 'New Brunswick',
+        },
+        {
+            value: 'NL',
+            label: 'Newfoundland and Labrador',
+        },
+        {
+            value: 'NS',
+            label: 'Nova Scotia',
+        },
+        {
+            value: 'NT',
+            label: 'Northwest Territories',
+        },
+        {
+            value: 'NU',
+            label: 'Nunavut',
+        },
+        {
+            value: 'ON',
+            label: 'Ontario',
+        },
+        {
+            value: 'PE',
+            label: 'Prince Edward Island',
+        },
+        {
+            value: 'QC',
+            label: 'Quebec',
+        },
+        {
+            value: 'SK',
+            label: 'Saskatchewan',
+        },
+        {
+            value: 'YT',
+            label: 'Yukon',
+        },
+    ],
+    US: [
+        {
+            value: 'AK',
+            label: 'Alaska',
+        },
+        {
+            value: 'AL',
+            label: 'Alabama',
+        },
+        {
+            value: 'AR',
+            label: 'Arkansas',
+        },
+        {
+            value: 'AS',
+            label: 'American Samoa',
+        },
+        {
+            value: 'AZ',
+            label: 'Arizona',
+        },
+        {
+            value: 'CA',
+            label: 'California',
+        },
+        {
+            value: 'CO',
+            label: 'Colorado',
+        },
+        {
+            value: 'CT',
+            label: 'Connecticut',
+        },
+        {
+            value: 'DC',
+            label: 'District of Columbia',
+        },
+        {
+            value: 'DE',
+            label: 'Delaware',
+        },
+        {
+            value: 'FL',
+            label: 'Florida',
+        },
+        {
+            value: 'GA',
+            label: 'Georgia',
+        },
+        {
+            value: 'GU',
+            label: 'Guam',
+        },
+        {
+            value: 'HI',
+            label: 'Hawaii',
+        },
+        {
+            value: 'IA',
+            label: 'Iowa',
+        },
+        {
+            value: 'ID',
+            label: 'Idaho',
+        },
+        {
+            value: 'IL',
+            label: 'Illinois',
+        },
+        {
+            value: 'IN',
+            label: 'Indiana',
+        },
+        {
+            value: 'KS',
+            label: 'Kansas',
+        },
+        {
+            value: 'KY',
+            label: 'Kentucky',
+        },
+        {
+            value: 'LA',
+            label: 'Louisiana',
+        },
+        {
+            value: 'MA',
+            label: 'Massachusetts',
+        },
+        {
+            value: 'MD',
+            label: 'Maryland',
+        },
+        {
+            value: 'ME',
+            label: 'Maine',
+        },
+        {
+            value: 'MI',
+            label: 'Michigan',
+        },
+        {
+            value: 'MN',
+            label: 'Minnesota',
+        },
+        {
+            value: 'MO',
+            label: 'Missouri',
+        },
+        {
+            value: 'MP',
+            label: 'Northern Mariana Islands',
+        },
+        {
+            value: 'MS',
+            label: 'Mississippi',
+        },
+        {
+            value: 'MT',
+            label: 'Montana',
+        },
+        {
+            value: 'NC',
+            label: 'North Carolina',
+        },
+        {
+            value: 'ND',
+            label: 'North Dakota',
+        },
+        {
+            value: 'NE',
+            label: 'Nebraska',
+        },
+        {
+            value: 'NH',
+            label: 'New Hampshire',
+        },
+        {
+            value: 'NJ',
+            label: 'New Jersey',
+        },
+        {
+            value: 'NM',
+            label: 'New Mexico',
+        },
+        {
+            value: 'NV',
+            label: 'Nevada',
+        },
+        {
+            value: 'NY',
+            label: 'New York',
+        },
+        {
+            value: 'OH',
+            label: 'Ohio',
+        },
+        {
+            value: 'OK',
+            label: 'Oklahoma',
+        },
+        {
+            value: 'OR',
+            label: 'Oregon',
+        },
+        {
+            value: 'PA',
+            label: 'Pennsylvania',
+        },
+        {
+            value: 'PR',
+            label: 'Puerto Rico',
+        },
+        {
+            value: 'RI',
+            label: 'Rhode Island',
+        },
+        {
+            value: 'SC',
+            label: 'South Carolina',
+        },
+        {
+            value: 'SD',
+            label: 'South Dakota',
+        },
+        {
+            value: 'TN',
+            label: 'Tennessee',
+        },
+        {
+            value: 'TX',
+            label: 'Texas',
+        },
+        {
+            value: 'UM',
+            label: 'United States Minor Outlying Islands',
+        },
+        {
+            value: 'UT',
+            label: 'Utah',
+        },
+        {
+            value: 'VA',
+            label: 'Virginia',
+        },
+        {
+            value: 'VI',
+            label: 'Virgin Islands, U.S.',
+        },
+        {
+            value: 'VT',
+            label: 'Vermont',
+        },
+        {
+            value: 'WA',
+            label: 'Washington',
+        },
+        {
+            value: 'WI',
+            label: 'Wisconsin',
+        },
+        {
+            value: 'WV',
+            label: 'West Virginia',
+        },
+        {
+            value: 'WY',
+            label: 'Wyoming',
+        },
+    ],
+};
+function displayNames(locale, type) {
+    try {
+        return new Intl.DisplayNames(locale, { type });
+    }
+    catch {
+        return new Intl.DisplayNames('en', { type });
+    }
+}
+/** Build localized choices from the shared ISO currency metadata. */
+export function currencyOptions(locale) {
+    const names = displayNames(locale, 'currency');
+    return [...ISO_4217_MINOR_UNITS.keys()].sort().map((value) => ({
+        value,
+        label: `${value} — ${names.of(value) ?? value}`,
+    }));
+}
+/** Build localized ISO alpha-2 country choices. */
+export function countryOptions(locale) {
+    const names = displayNames(locale, 'region');
+    return countries.map((value) => ({ value, label: names.of(value) ?? value }));
+}
+/** Return CA/US subdivision choices, or undefined for free-text countries. */
+export function provinceOptions(country) {
+    return regions[country.toUpperCase()];
+}

package/dist/components/forms/code-select-types.d.ts

@@ -0,0 +1,42 @@
+import type { DOMAttributes, HTMLSelectAttributes } from 'svelte/elements';
+import type { ControlInteractionOptions } from './control-interaction.js';
+/** A caller-authorized native choice; supplied labels are displayed verbatim. */
+export interface CodeSelectOption {
+    /** Exact submitted code, never normalized by the control. */
+    value: string;
+    /** Optional localized text; defaults to the code. */
+    label?: string;
+    /** Native disabled option; selected disabled options are omitted from FormData. */
+    disabled?: boolean;
+}
+/** Shared single-choice contract; children and multiple are intentionally excluded. */
+export interface CodeSelectProps extends Omit<HTMLSelectAttributes, 'children' | 'multiple' | 'value' | 'class'> {
+    /** Exact bound and submitted value. */
+    value?: string;
+    /** Additional CSS classes. */
+    class?: string;
+    /** Control target density. */
+    density?: 'comfortable' | 'touch';
+    /** Optional shared agent interaction registration. */
+    interaction?: ControlInteractionOptions | false;
+    /** Custom choices replace defaults; an empty list is an intentional override. */
+    options?: readonly CodeSelectOption[];
+    /** Locale used for built-in currency/country display names; invalid locales use English. */
+    locale?: string;
+    /** Empty choice label. Defaults to an em dash and never auto-selects a code. */
+    placeholder?: string;
+    /** Disable editing while submitting the unchanged value through a hidden input. */
+    readOnly?: boolean;
+}
+/** Currency control with existing ISO 4217 defaults. */
+export interface CurrencySelectProps extends CodeSelectProps {
+}
+/** Country control with ISO 3166-1 alpha-2 defaults. */
+export interface CountrySelectProps extends CodeSelectProps {
+}
+/** Region control; event targets may be Select or the unsupported-country Input fallback. */
+export interface ProvinceSelectProps extends Omit<CodeSelectProps, keyof DOMAttributes<HTMLSelectElement>>, Omit<DOMAttributes<HTMLInputElement | HTMLSelectElement>, 'children'> {
+    /** Country code selecting CA/US subdivisions; other countries permit free text. */
+    country?: string;
+}
+//# sourceMappingURL=code-select-types.d.ts.map

package/dist/components/forms/code-select-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-select-types.d.ts","sourceRoot":"","sources":["../../../src/components/forms/code-select-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,uFAAuF;AACvF,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,oBAAoB,EACpB,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAC5C;IACD,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,sDAAsD;IACtD,WAAW,CAAC,EAAE,yBAAyB,GAAG,KAAK,CAAC;IAChD,iFAAiF;IACjF,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,wDAAwD;AACxD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;CAAG;AAC/D,wDAAwD;AACxD,MAAM,WAAW,kBAAmB,SAAQ,eAAe;CAAG;AAC9D,6FAA6F;AAC7F,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC,EACnE,IAAI,CAAC,aAAa,CAAC,gBAAgB,GAAG,iBAAiB,CAAC,EAAE,UAAU,CAAC;IACvE,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/components/forms/code-select-types.js

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

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

@@ -15,7 +15,10 @@ export { canCaptureDictationAudio, createMediaRecorderCapture, DICTATION_AUDIO_M
 export { default as CameraCapture } from './CameraCapture.svelte';
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
+export { default as CountrySelect } from './CountrySelect.svelte';
+export { default as CurrencySelect } from './CurrencySelect.svelte';
 export { type CameraCaptureErrorKind, type CameraFacingMode, type CameraSession, type CameraSessionDeps, type CameraSessionResult, classifyGetUserMediaError, createCameraSession, isCameraApiSupported, type MediaDevicesLike, } from './camera-capture-session.js';
+export type { CodeSelectOption, CountrySelectProps, CurrencySelectProps, ProvinceSelectProps, } from './code-select-types.js';
 export { emitControlChange, focusControl, highlightControl, revealControl, } from './control-dom.js';
 export { type ControlBatchResult, type ControlCapability, type ControlCommand, type ControlCommandAction, type ControlCommandContext, type ControlCommandResult, type ControlCommandSource, type ControlConstraints, type ControlExtensionContext, type ControlIdentity, type ControlInteractionEvent, type ControlInteractionOptions, type ControlInteractionPolicy, type ControlInteractionRegistry, type ControlKind, type ControlMetadata, type ControlOption, type ControlRegistration, type ControlRuntimeState, type ControlSensitivity, type ControlSnapshot, type ControlStagedEntry, type ControlStagedProvenance, type ControlSubject, type ControlValueValidationResult, createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
 export { type ControlInteractionContextValue, getControlInteractionContext, recordControlUserEdit, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
@@ -40,6 +43,7 @@ export { default as Listbox } from './Listbox.svelte';
 export { createLongPress, LONG_PRESS_DEFAULT_DELAY_MS, LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX, type LongPressController, type LongPressDetail, type LongPressOptions, longPress, } from './long-press.js';
 export { default as MultiSelect } from './MultiSelect.svelte';
 export { detectNativeFileFieldStrategy, type NativeFileFieldStrategy, } from './native-file-field.js';
+export { default as ProvinceSelect } from './ProvinceSelect.svelte';
 export { default as Radio } from './Radio.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as RangeSlider } from './RangeSlider.svelte';

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

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

package/dist/components/forms/index.js

@@ -16,6 +16,8 @@ export { canCaptureDictationAudio, createMediaRecorderCapture, DICTATION_AUDIO_M
 export { default as CameraCapture } from './CameraCapture.svelte';
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
+export { default as CountrySelect } from './CountrySelect.svelte';
+export { default as CurrencySelect } from './CurrencySelect.svelte';
 export { classifyGetUserMediaError, createCameraSession, isCameraApiSupported, } from './camera-capture-session.js';
 export { emitControlChange, focusControl, highlightControl, revealControl, } from './control-dom.js';
 export { createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
@@ -42,6 +44,7 @@ export { default as Listbox } from './Listbox.svelte';
 export { createLongPress, LONG_PRESS_DEFAULT_DELAY_MS, LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX, longPress, } from './long-press.js';
 export { default as MultiSelect } from './MultiSelect.svelte';
 export { detectNativeFileFieldStrategy, } from './native-file-field.js';
+export { default as ProvinceSelect } from './ProvinceSelect.svelte';
 export { default as Radio } from './Radio.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as RangeSlider } from './RangeSlider.svelte';

package/dist/svelte/playground/CodeSelectorsPreview.svelte

@@ -0,0 +1,29 @@
+<script lang="ts">
+import {
+  CountrySelect,
+  CurrencySelect,
+  Form,
+  FormGroup,
+  ProvinceSelect,
+} from '../../components/forms/index.js';
+import Button from '../../components/ui/Button.svelte';
+
+let currency = $state('CAD');
+let country = $state('CA');
+let province = $state('ON');
+let submitted = $state('');
+</script>
+<div class="selectors">
+  <p>Localized country and currency choices. Province choices cover Canada and the United States; other countries accept free text. Changing country preserves the entered region for review.</p>
+  <Form onsubmit={(event) => { submitted = JSON.stringify(Object.fromEntries(new FormData(event.currentTarget))); }}>
+    <FormGroup label="Currency"><CurrencySelect name="currency" bind:value={currency} /></FormGroup>
+    <FormGroup label="Country"><CountrySelect name="country" bind:value={country} /></FormGroup>
+    <FormGroup label="Province / state"><ProvinceSelect name="province" {country} bind:value={province} /></FormGroup>
+    <Button type="submit">Inspect values</Button>
+  </Form>
+  <output aria-label="Submitted codes">{submitted}</output>
+</div>
+<style>
+.selectors { display: grid; gap: 1rem; max-width: 40rem; color: var(--smrt-color-on-surface); }
+output { overflow-wrap: anywhere; }
+</style>

package/dist/svelte/playground/CodeSelectorsPreview.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const CodeSelectorsPreview: import("svelte").Component<Record<string, never>, {}, "">;
+type CodeSelectorsPreview = ReturnType<typeof CodeSelectorsPreview>;
+export default CodeSelectorsPreview;
+//# sourceMappingURL=CodeSelectorsPreview.svelte.d.ts.map

package/dist/svelte/playground/CodeSelectorsPreview.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeSelectorsPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/CodeSelectorsPreview.svelte.ts"],"names":[],"mappings":"AAmCA,QAAA,MAAM,oBAAoB,2DAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/svelte/playground.d.ts

@@ -6,7 +6,7 @@ declare const _default: {
         id: string;
         title: string;
         description: string;
-        loadComponent: () => Promise<typeof import("./playground/BaseControlsPreview.svelte")>;
+        loadComponent: () => Promise<typeof import("./playground/CodeSelectorsPreview.svelte")>;
         order: number;
         tags: string[];
         modes: {

package/dist/svelte/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAUA,wBAqFE"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAUA,wBA+FE"}

package/dist/svelte/playground.js

@@ -10,6 +10,15 @@ export default {
     displayName: 'UI Foundation',
     description: 'Provider-free controls and data primitives rendered in the active s-m-r-t theme.',
     entries: [
+        {
+            id: 'code-selectors',
+            title: 'Currency, Country & Province',
+            description: 'Localized code choices, retained values, and free-text regions.',
+            loadComponent: () => import('./playground/CodeSelectorsPreview.svelte'),
+            order: 8,
+            tags: ['forms', 'currency', 'address'],
+            modes: { mock: { label: 'Interactive' } },
+        },
         {
             id: 'base-controls',
             title: 'Base Controls',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-ui",
-  "version": "0.53.3",
+  "version": "0.53.5",
   "smrtJsdoc": "strict",
   "description": "Domain-agnostic Svelte 5 UI runtime for SMRT: primitives, i18n client, theme system, and module UI registry",
   "type": "module",
@@ -134,7 +134,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/smrt-types": "0.53.3",
+    "@happyvertical/smrt-types": "0.53.5",
     "esm-env": "^1.2.2"
   },
   "peerDependencies": {