@alikhalilll/ui 1.2.1 → 1.2.3

package/dist/entries/tell-input/components/ACountrySelect.vue.d.ts

@@ -0,0 +1,136 @@
+import type { HTMLAttributes } from 'vue';
+import { type CountryOption } from '../composables/usePhoneValidation';
+import { type Size } from '../../../utils';
+type __VLS_Props = {
+    class?: HTMLAttributes['class'];
+    triggerClass?: HTMLAttributes['class'];
+    contentClass?: HTMLAttributes['class'];
+    popoverClass?: HTMLAttributes['class'];
+    drawerClass?: HTMLAttributes['class'];
+    searchPlaceholder?: string;
+    emptyText?: string;
+    loadingText?: string;
+    suggestedLabel?: string;
+    allCountriesLabel?: string;
+    /** ISO2 codes that are selectable. Others are listed but disabled. */
+    allowedDialCodes?: string[];
+    disabled?: boolean;
+    /** Drives the trigger button padding + text size. Matches ATellInput's `size`. */
+    size?: Size;
+    /** Max items rendered under the "Suggested" header (current + recents, deduped). */
+    suggestedLimit?: number;
+    /** Cap the number of matching countries shown in search results. */
+    maxResults?: number;
+    /** Override the flag URL builder, e.g. `(iso, w) => \`/flags/${iso}.svg\``. */
+    flagUrl?: (iso2: string, width: number) => string;
+    /**
+     * Custom search predicate. Default: substring match on the precomputed `search_key`.
+     * Return `true` to keep the country in results.
+     */
+    searcher?: (query: string, country: CountryOption) => boolean;
+    /**
+     * Provide your own country list (bypasses the REST Countries fetch). Useful when you
+     * already have a curated subset, an i18n'd list, or want to avoid the network call.
+     */
+    countries?: CountryOption[];
+    /** Override the right-side kbd hints. Pass `null` to hide. */
+    kbdOpen?: string | null;
+    kbdClose?: string | null;
+    /** BCP-47 locale — country names render localized via `Intl.DisplayNames`. */
+    locale?: string;
+    /** Prefix of the trigger's `aria-label` when a country is selected, e.g. `"Country"`. */
+    countryLabel?: string;
+    /** Trigger's `aria-label` when no country is selected. */
+    selectCountryLabel?: string;
+    /**
+     * How page scroll is blocked while the popover is open. Defaults to `'events'` — an
+     * event-based lock that keeps the page scrollbar visible and `position: sticky` working.
+     * Pass `'body'` for the legacy `body { overflow: hidden }` lock, or `'none'` to allow
+     * the page to scroll freely.
+     */
+    scrollLock?: 'events' | 'body' | 'none';
+};
+type __VLS_Slots = {
+    /** Replace the entire country picker trigger button. */
+    trigger?: (props: {
+        selectedCountry: CountryOption | null;
+        open: boolean;
+        sizeClasses: string;
+    }) => unknown;
+    /** Replace the chevron icon. */
+    chevron?: (props: {
+        open: boolean;
+    }) => unknown;
+    /** Replace just the flag rendered in the trigger and items. */
+    flag?: (props: {
+        country: CountryOption;
+        context: 'trigger' | 'item';
+    }) => unknown;
+    /** Replace the entire search bar (input + icon + kbd). */
+    search?: (props: {
+        value: string;
+        setValue: (v: string) => void;
+        isSearching: boolean;
+    }) => unknown;
+    /** Replace the search-bar leading icon. */
+    'search-icon'?: () => unknown;
+    /** Replace the loading state. */
+    loading?: () => unknown;
+    /** Replace the empty/no-results state. */
+    empty?: (props: {
+        query: string;
+    }) => unknown;
+    /** Replace a section header. */
+    'group-header'?: (props: {
+        label: string;
+        group: 'suggested' | 'all';
+    }) => unknown;
+    /** Replace each country list row. Default render still available via <ACountrySelectItem />. */
+    item?: (props: {
+        country: CountryOption;
+        selected: boolean;
+        disabled: boolean;
+        select: () => void;
+    }) => unknown;
+    /** Replace just the right-side check icon for the selected row. */
+    'item-check'?: (props: {
+        country: CountryOption;
+    }) => unknown;
+};
+declare function selectCountry(option: CountryOption): void;
+type __VLS_ModelProps = {
+    'selected'?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    open: import("vue").Ref<boolean, boolean>;
+    setOpen: (v: boolean) => boolean;
+    search: import("vue").Ref<string, string>;
+    setSearch: (v: string) => string;
+    selectedCountry: import("vue").ComputedRef<CountryOption<import("../index").RestCountry> | null>;
+    selectCountry: typeof selectCountry;
+    countries: import("vue").ComputedRef<CountryOption<import("../index").RestCountry>[]>;
+    recents: import("vue").Ref<string[], string[]>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:selected": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:selected"?: ((value: string) => any) | undefined;
+}>, {
+    size: Size;
+    searchPlaceholder: string;
+    emptyText: string;
+    loadingText: string;
+    suggestedLabel: string;
+    allCountriesLabel: string;
+    countryLabel: string;
+    selectCountryLabel: string;
+    suggestedLimit: number;
+    maxResults: number;
+    kbdOpen: string | null;
+    kbdClose: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & (new () => (T extends new (...args: any) => infer R ? R : {}) & { $slots: S });
+//# sourceMappingURL=ACountrySelect.vue.d.ts.map

package/dist/entries/tell-input/components/ACountrySelect.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACountrySelect.vue.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/components/ACountrySelect.vue"],"names":[],"mappings":"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"}

package/dist/entries/tell-input/components/ATellInput.vue.d.ts

@@ -0,0 +1,141 @@
+import { type CountryOption, type PhoneValidationResult } from '../composables/usePhoneValidation';
+import { type DetectCountryOptions } from '../composables/useCountryDetection';
+import { type ATellInputProps } from '../utils/types';
+interface ExtendedProps extends ATellInputProps {
+    /** Override the flag URL builder, forwarded to ACountrySelect. */
+    flagUrl?: (iso2: string, width: number) => string;
+    /** Custom search predicate, forwarded to ACountrySelect. */
+    searcher?: (query: string, country: CountryOption) => boolean;
+    /** Provide your own country list, forwarded to ACountrySelect. */
+    countries?: CountryOption[];
+    /**
+     * Fully custom country detection. When provided, this function runs in place of the
+     * built-in chain — `detectCountry`-style options are still honored but the function
+     * receives them and is free to ignore them.
+     */
+    detector?: (options: DetectCountryOptions) => Promise<string | null | undefined>;
+    /** Forwarded to ACountrySelect: classes for the popover content surface. */
+    contentClass?: string;
+    popoverClass?: string;
+    drawerClass?: string;
+    /** Classes for the inner phone field input element. */
+    inputClass?: string;
+    /** Classes for the outer wrapper that holds country select + input. */
+    fieldClass?: string;
+    /** Classes for the helper hint line. */
+    hintClass?: string;
+    /** Classes for the error message line. */
+    errorClass?: string;
+    /**
+     * How page scroll is blocked while the country popover is open. Defaults to `'events'`
+     * (sticky-safe document-level lock). Pass `'body'` for the legacy
+     * `body { overflow: hidden }` lock, or `'none'` to leave page scrolling alone.
+     */
+    scrollLock?: 'events' | 'body' | 'none';
+}
+type __VLS_Props = ExtendedProps;
+type __VLS_Slots = {
+    /** Content before the country select trigger (e.g. an icon). */
+    prefix?: () => unknown;
+    /** Content between the input and the validation icons. */
+    suffix?: (props: {
+        validationState: 'idle' | 'valid' | 'error';
+        validation: PhoneValidationResult;
+    }) => unknown;
+    /** Replace the green check shown when the number validates. */
+    'valid-icon'?: () => unknown;
+    /** Replace the warning icon shown when the number fails validation. */
+    'error-icon'?: (props: {
+        reason: string;
+    }) => unknown;
+    /** Replace the dim helper line shown below the input when empty. */
+    hint?: (props: {
+        country: string;
+        formatHint: string;
+        example: string | null;
+    }) => unknown;
+    /** Replace the error message rendered when invalid. */
+    error?: (props: {
+        message: string;
+        reason: string;
+        validation: PhoneValidationResult;
+    }) => unknown;
+    /** Forwarded to ACountrySelect — replace the trigger button. */
+    trigger?: (props: {
+        selectedCountry: CountryOption | null;
+        open: boolean;
+        sizeClasses: string;
+    }) => unknown;
+    /** Forwarded to ACountrySelect — replace the chevron. */
+    chevron?: (props: {
+        open: boolean;
+    }) => unknown;
+    /** Forwarded — replace any flag rendering. */
+    flag?: (props: {
+        country: CountryOption;
+        context: 'trigger' | 'item';
+    }) => unknown;
+    /** Forwarded — replace each country list row. */
+    item?: (props: {
+        country: CountryOption;
+        selected: boolean;
+        disabled: boolean;
+        select: () => void;
+    }) => unknown;
+    /** Forwarded — section header. */
+    'group-header'?: (props: {
+        label: string;
+        group: 'suggested' | 'all';
+    }) => unknown;
+    /** Forwarded — search bar. */
+    search?: (props: {
+        value: string;
+        setValue: (v: string) => void;
+        isSearching: boolean;
+    }) => unknown;
+    loading?: () => unknown;
+    empty?: (props: {
+        query: string;
+    }) => unknown;
+    /** Replace the spinner shown in the picker slot during the debounce window. */
+    detecting?: () => unknown;
+};
+type __VLS_ModelProps = {
+    'phone'?: string;
+    /** Public `v-model:country` — the **dial number** (e.g. `20` for Egypt, `44` for the UK,
+     *  `1` for the NANP block). `null` means no country selected. Internally the component
+     *  tracks a richer ISO2 code (`selectedIso2`) because dial codes alone can't disambiguate
+     *  NANP (`+1` covers 25+ countries) — the picker still needs an exact country. */
+    'country'?: number | null;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    validation: import("vue").ComputedRef<PhoneValidationResult>;
+    required: import("vue").ComputedRef<import("../index").PhoneRequiredInfo | null>;
+    selectedDialCode: import("vue").ComputedRef<string | null>;
+    validationState: import("vue").ComputedRef<"error" | "idle" | "valid">;
+    visibleValidationState: import("vue").ComputedRef<"error" | "idle" | "valid">;
+    isDetecting: Readonly<import("vue").Ref<boolean, boolean>>;
+    hasFinishedTyping: Readonly<import("vue").Ref<boolean, boolean>>;
+    detectionAttempted: Readonly<import("vue").Ref<boolean, boolean>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:phone": (value: string) => any;
+    "update:country": (value: number | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:phone"?: ((value: string) => any) | undefined;
+    "onUpdate:country"?: ((value: number | null) => any) | undefined;
+}>, {
+    size: import("../index").ATellInputSize;
+    placeholder: string;
+    ipEndpoint: string;
+    defaultCountry: string;
+    showValidationIcon: boolean;
+    detectCountry: import("../index").DetectionStrategy;
+    detectFromInput: boolean;
+    detectDebounceMs: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & (new () => (T extends new (...args: any) => infer R ? R : {}) & { $slots: S });
+//# sourceMappingURL=ATellInput.vue.d.ts.map

package/dist/entries/tell-input/components/ATellInput.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ATellInput.vue.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/components/ATellInput.vue"],"names":[],"mappings":"AA8mBA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAK9F,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI3F,UAAU,aAAc,SAAQ,eAAe;IAC7C,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;IAC9D,kEAAkE;IAClE,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACjF,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAED,KAAK,WAAW,GAAG,aAAa,CAAC;AAYjC,KAAK,WAAW,GAAG;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC;IACvB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QACf,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QAC5C,UAAU,EAAE,qBAAqB,CAAC;KACnC,KAAK,OAAO,CAAC;IACd,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7B,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACtD,oEAAoE;IACpE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC;IAC3F,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,qBAAqB,CAAC;KACnC,KAAK,OAAO,CAAC;IACd,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;QACtC,IAAI,EAAE,OAAO,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;IACd,yDAAyD;IACzD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAChD,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACnF,iDAAiD;IACjD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QACb,OAAO,EAAE,aAAa,CAAC;QACvB,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,KAAK,OAAO,CAAC;IACd,kCAAkC;IAClC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;IACnF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC9B,WAAW,EAAE,OAAO,CAAC;KACtB,KAAK,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IAC9C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC;AA4SF,KAAK,gBAAgB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;sFAGkF;IAClF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAgBF,KAAK,iBAAiB,GAAG,WAAW,GAAG,gBAAgB,CAAC;AA2axD,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;6EAKd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/entries/tell-input/composables/useCountryDetection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Best-effort country detection chain: IP geolocation → timezone → navigator.language → fallback.
+ * Every step is independent and degrades gracefully; the final fallback is always returned.
+ *
+ * The composable returns reactive state so consumers can swap in the detected ISO2 the moment it
+ * resolves, while still rendering an input immediately on mount.
+ */
+import { type Ref } from 'vue';
+export type DetectionStrategy = 'auto' | 'locale' | 'none';
+export interface DetectCountryOptions {
+    /**
+     * - `'auto'` — try IP geolocation first, then timezone, then `navigator.language`, then default.
+     * - `'locale'` — skip the network call, use timezone + locale only.
+     * - `'none'` — return `defaultCountry` immediately.
+     */
+    strategy?: DetectionStrategy;
+    /** Endpoint returning a JSON body with a `country_code` (or `country`) field. */
+    ipEndpoint?: string;
+    /** Fallback ISO2 used when every step fails. */
+    defaultCountry?: string;
+    /** Abort the IP request after this many ms. */
+    timeoutMs?: number;
+    /** Persist the resolved country in sessionStorage so re-mounts within the session skip detection. */
+    cache?: boolean;
+}
+/**
+ * Imperative API. Use this when you want to call detection from outside Vue (e.g. inside a
+ * non-component composable, server middleware, or unit test).
+ */
+export declare function detectCountry(opts?: DetectCountryOptions): Promise<string>;
+export interface UseCountryDetectionReturn {
+    /** Resolved ISO2 code. Initially `null` until detection completes. */
+    country: Ref<string | null>;
+    /** True while detection is in flight. */
+    isLoading: Ref<boolean>;
+    /** Manually re-run detection (e.g. after the user changes their VPN). */
+    refresh: () => Promise<string>;
+}
+/**
+ * Reactive wrapper. Kicks off detection in `onMounted` so SSR renders an empty value and the
+ * client patches in the real country once resolved.
+ */
+export declare function useCountryDetection(opts?: DetectCountryOptions): UseCountryDetectionReturn;
+//# sourceMappingURL=useCountryDetection.d.ts.map

package/dist/entries/tell-input/composables/useCountryDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountryDetection.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/composables/useCountryDetection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAkB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuJD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BpF;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,yCAAyC;IACzC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,yEAAyE;IACzE,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,oBAAyB,GAAG,yBAAyB,CAmB9F"}

package/dist/entries/tell-input/composables/useCountryMatching.d.ts

@@ -0,0 +1,44 @@
+import type { CountryOption } from './usePhoneValidation';
+/** Synchronous dial-digit → ISO2 fallback for common countries, used when the async
+ *  REST Countries fetch hasn't populated `getCountriesByDial`'s index yet at setup. */
+export declare const DIAL_TO_ISO2_FALLBACK: Record<string, string>;
+/** localStorage key for the user's most recently picked countries. Used as a
+ *  tie-breaker when multiple countries share a dial code (e.g. all NANP). */
+export declare const COUNTRY_RECENTS_KEY = "ali_ui_country_recents_v1";
+export interface DialMatch {
+    country: CountryOption;
+    /** The national significant number — what the phone input should hold, with both the
+     *  dial code and the national prefix (e.g. Egyptian leading `0`) stripped. */
+    nationalNumber: string;
+}
+export interface MatchLeadingDialCodeOptions {
+    /** ISO2 hint for libphonenumber's national-format parse (tier 2). Typically the
+     *  IP/timezone/locale-resolved country. */
+    hintCountry?: string;
+    /** Currently selected ISO2 — preferred when a shared dial code yields multiple
+     *  countries (tier 3 tie-break). */
+    currentIso2?: string;
+}
+export interface CountryMatchingDeps {
+    /** Country lookup by ISO2 code — typically `usePhoneValidation().getCountryByValue`. */
+    getCountryByValue: (value: string) => CountryOption | null;
+    /** Country lookup by dial digits — typically `usePhoneValidation().getCountriesByDial`. */
+    getCountriesByDial: (dial: string) => CountryOption[];
+}
+/**
+ * Country-matching helpers used by the tel input — pure functions on top of the
+ * `usePhoneValidation` country index. Split out of `ATellInput.vue` so the component
+ * script stays focused on UI state and the matching logic is independently testable.
+ *
+ * **Important**: takes the validation lookups as dependencies rather than calling
+ * `usePhoneValidation()` itself. `usePhoneValidation` creates a fresh state on every
+ * call, so calling it here would produce a *second* empty country index that never gets
+ * populated by the caller's `getCountries()` — the matcher would see no countries and
+ * all tier-3 prefix lookups would fall through to the (much smaller) fallback table.
+ */
+export declare function useCountryMatching(deps: CountryMatchingDeps): {
+    resolveCountryIdentifier: (raw: string | undefined | null) => string;
+    dialNumberFor: (iso2: string) => number | null;
+    matchLeadingDialCode: (digits: string, options?: MatchLeadingDialCodeOptions) => DialMatch | null;
+};
+//# sourceMappingURL=useCountryMatching.d.ts.map

package/dist/entries/tell-input/composables/useCountryMatching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountryMatching.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/composables/useCountryMatching.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;uFACuF;AACvF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4DxD,CAAC;AAEF;6EAC6E;AAC7E,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB;kFAC8E;IAC9E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C;+CAC2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;wCACoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;IAC3D,2FAA2F;IAC3F,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB;oCAKnB,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,MAAM;0BAe5C,MAAM,KAAG,MAAM,GAAG,IAAI;mCAiBzC,MAAM,YACL,2BAA2B,KACnC,SAAS,GAAG,IAAI;EAwDpB"}

package/dist/entries/tell-input/composables/usePhoneValidation.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Country list + phone validation, framework-agnostic.
+ *
+ * Ported from the reference @pkgs/ui ATellInput composable with these cleanups:
+ *  - Drop Nuxt-only `process.client` checks → use plain `typeof window !== 'undefined'`.
+ *  - Drop Arabic default placeholder; let consumers pass their own.
+ *  - Expand the offline fallback list from 2 → ~20 of the most-populated countries.
+ *  - Keep REST Countries fetch + localStorage cache + libphonenumber-js examples + fast `search_key`.
+ */
+import { type Ref } from 'vue';
+export interface RestCountry {
+    name?: {
+        common?: string;
+    };
+    cca2?: string;
+    idd?: {
+        root?: string;
+        suffixes?: string[];
+    };
+    flags?: {
+        png?: string;
+        svg?: string;
+    };
+}
+export interface CountryOption<T = RestCountry> {
+    /** Display label, e.g. "Egypt (+20)". */
+    label: string;
+    /** Stable unique ID — the ISO 3166-1 alpha-2 code, e.g. "EG". */
+    value: string;
+    /** Precomputed normalized string for fast substring search. */
+    search_key: string;
+    raw_data: {
+        iso2: string;
+        dial_code: string;
+        dial_digits: string;
+        name: string;
+        flag: string | null;
+        source: 'restcountries' | 'fallback';
+        original: T;
+    };
+}
+export interface PhoneRequiredInfo {
+    iso2: string;
+    dial_code: string;
+    /** Empty by default — consumer passes a placeholder via the component prop. */
+    placeholder: string;
+    example_national: string;
+    example_e164: string;
+    national_number_length: {
+        min: number | null;
+        max: number | null;
+    };
+    format_hint: string;
+}
+export type PhoneValidationReason = 'missing_country' | 'country_not_supported' | 'phone_has_non_digits' | 'too_short' | 'too_long' | 'invalid_phone' | 'parse_failed';
+export interface PhoneValidationResult {
+    ok: boolean;
+    reason: PhoneValidationReason | null;
+    country: {
+        iso2: string;
+        dial_code: string;
+    } | null;
+    phone: {
+        raw: string | null;
+        digits: string;
+    };
+    full_phone: string | null;
+    required: PhoneRequiredInfo | null;
+    details?: Record<string, unknown>;
+}
+export type ValidateArgs = {
+    country: {
+        iso2: string;
+        dial_code?: string;
+    } | null | undefined;
+    phone?: undefined;
+    /** BCP-47 locale — localizes the numerals in the returned `required.format_hint`. */
+    locale?: string;
+} | {
+    country: {
+        iso2: string;
+        dial_code?: string;
+    } | null | undefined;
+    phone: string | null;
+    /** BCP-47 locale — localizes the numerals in the returned `required.format_hint`. */
+    locale?: string;
+};
+/**
+ * Return a copy of the country list with display names localized to `locale` via
+ * `Intl.DisplayNames`. `search_key` is rebuilt (keeping the English name too) so search
+ * still matches either spelling. Unknown locales / regions fall back to the English name.
+ */
+export declare function localizeCountries(list: CountryOption[], locale?: string): CountryOption[];
+export interface UsePhoneValidationReturn {
+    countries: Ref<CountryOption[]>;
+    isCountriesLoading: Ref<boolean>;
+    getCountries(options?: {
+        force?: boolean;
+    }): Promise<CountryOption[]>;
+    searchCountries(keyword: string, limit?: number): CountryOption[];
+    getCountryByValue(value: string): CountryOption | null;
+    getCountriesByDial(dial: string): CountryOption[];
+    getRequiredInfo(country: {
+        iso2: string;
+        dial_code?: string;
+    }, locale?: string): PhoneRequiredInfo | null;
+    validate(input: ValidateArgs): PhoneValidationResult;
+}
+export declare function usePhoneValidation(): UsePhoneValidationReturn;
+//# sourceMappingURL=usePhoneValidation.d.ts.map

package/dist/entries/tell-input/composables/usePhoneValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePhoneValidation.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/composables/usePhoneValidation.ts"],"names":[],"mappings":"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"}

package/dist/entries/tell-input/composables/useTellInputValidation.d.ts

@@ -0,0 +1,67 @@
+import { type ComputedRef, type Ref } from 'vue';
+import type { PhoneValidationReason, PhoneValidationResult, PhoneRequiredInfo, UsePhoneValidationReturn } from './usePhoneValidation';
+import type { TellInputMessages } from '../utils/types';
+/**
+ * Validation surfacing facade for ATellInput.
+ *
+ * Wraps the raw `usePhoneValidation()` calls and produces the *view-layer* surface the
+ * component needs:
+ *
+ * - `validation` / `validationState` — the raw + simplified state of the current input.
+ * - `visibleValidationState` — `validationState` gated by the `hasFinishedTyping` flag
+ *   from {@link useTypingPhase}, so error tints / icons / messages only appear once the
+ *   user has paused. This is the value the template should bind to.
+ * - `errorMessage` — localised error string for the current `validation.reason`, or
+ *   `null` when the input is empty or valid.
+ * - `showError` / `showHint` — boolean computed properties for conditional rendering
+ *   in the template; both already respect `showValidation` and the typing-pause gate.
+ * - `selectedDialCode` — the human-readable dial prefix (`+20`, `+1`, …) for the
+ *   selected country, used as an in-input prefix.
+ *
+ * Design notes:
+ *
+ * - The composable takes the `usePhoneValidation()` return value as a *dependency*
+ *   rather than calling `usePhoneValidation()` itself. That function creates a fresh
+ *   country index per invocation; calling it here would produce a second, empty index
+ *   that never gets populated by the caller's `getCountries()` (the same bug pattern
+ *   {@link useCountryMatching} avoids).
+ *
+ * - All inputs are `Ref` / `ComputedRef` so reactivity flows correctly. Method
+ *   references on the validation singleton (`validate`, `getRequiredInfo`,
+ *   `getCountryByValue`) are passed verbatim — their backing state is reactive.
+ */
+export interface UseTellInputValidationDeps {
+    validate: UsePhoneValidationReturn['validate'];
+    getRequiredInfo: UsePhoneValidationReturn['getRequiredInfo'];
+    getCountryByValue: UsePhoneValidationReturn['getCountryByValue'];
+}
+export interface UseTellInputValidationInputs {
+    /** Digits-only national number model. */
+    phone: Ref<string>;
+    /** Currently selected ISO2 — empty string when no country chosen. */
+    selectedIso2: Ref<string>;
+    /** From {@link useTypingPhase} — gates visible state during the debounce window. */
+    hasFinishedTyping: Readonly<Ref<boolean>>;
+    /** Resolved i18n messages (merged defaults + consumer overrides). */
+    messages: ComputedRef<TellInputMessages>;
+}
+export interface UseTellInputValidationConfig {
+    /** BCP-47 locale; affects `format_hint` numeral rendering. */
+    locale: () => string | undefined;
+    /** Light up field tinting + error message line. From props. */
+    showValidation: () => boolean | undefined;
+    /** Per-reason error string overrides. From props. */
+    errorMessages: () => Partial<Record<PhoneValidationReason, string>> | undefined;
+}
+export interface UseTellInputValidationReturn {
+    validation: ComputedRef<PhoneValidationResult>;
+    required: ComputedRef<PhoneRequiredInfo | null>;
+    validationState: ComputedRef<'idle' | 'valid' | 'error'>;
+    visibleValidationState: ComputedRef<'idle' | 'valid' | 'error'>;
+    errorMessage: ComputedRef<string | null>;
+    showError: ComputedRef<boolean>;
+    showHint: ComputedRef<boolean>;
+    selectedDialCode: ComputedRef<string | null>;
+}
+export declare function useTellInputValidation(deps: UseTellInputValidationDeps, inputs: UseTellInputValidationInputs, config: UseTellInputValidationConfig): UseTellInputValidationReturn;
+//# sourceMappingURL=useTellInputValidation.d.ts.map

package/dist/entries/tell-input/composables/useTellInputValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTellInputValidation.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/composables/useTellInputValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAC3D,OAAO,KAAK,EAEV,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAC/C,eAAe,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IAC7D,iBAAiB,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,4BAA4B;IAC3C,yCAAyC;IACzC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,oFAAoF;IACpF,iBAAiB,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACjC,+DAA+D;IAC/D,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,qDAAqD;IACrD,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACjF;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAC/C,QAAQ,EAAE,WAAW,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAChD,eAAe,EAAE,WAAW,CAAC,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IACzD,sBAAsB,EAAE,WAAW,CAAC,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IAChE,YAAY,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/B,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,EAChC,MAAM,EAAE,4BAA4B,EACpC,MAAM,EAAE,4BAA4B,GACnC,4BAA4B,CAuD9B"}

package/dist/entries/tell-input/composables/useTypingPhase.d.ts

@@ -0,0 +1,50 @@
+import { type ComputedRef, type Ref } from 'vue';
+/**
+ * Typing-phase state machine for the tel input.
+ *
+ * Owns the three reactive flags that drive the "is the user still typing?" UX:
+ *
+ * - `isDetecting` — true while the debounce window is in flight (user is mid-burst or
+ *   has just paused). Drives the loading spinner in the picker slot.
+ * - `hasFinishedTyping` — false from the moment a key lands until the debounce settles.
+ *   Gates validation visibility, so error/success states only appear once the user pauses.
+ * - `detectionAttempted` — flips true the first time the debounce fires on non-empty
+ *   input. Used by the consumer to keep the country picker visible after a failed
+ *   detection (so the user can pick manually instead of being stranded).
+ *
+ * Design notes:
+ *
+ * - The composable is pure state — it does not know about country detection, phone
+ *   numbers, or libphonenumber. The consumer wires the `onSettle` callback to whatever
+ *   "what to do when typing pauses" logic is appropriate (typically: try to detect a
+ *   country from the current digits, mark a detection attempt, and apply the match).
+ *
+ * - `markDetectionAttempt()` is exposed separately so the caller controls *when* the
+ *   "keep the picker visible" flag flips — not every settle triggers a real attempt
+ *   (e.g. when input is empty or the user already picked a country manually).
+ *
+ * - Refs are exposed `readonly` so external code can't bypass the state machine; all
+ *   transitions go through the exposed actions.
+ */
+export interface UseTypingPhaseOptions {
+    /** Debounce window in ms. Reactive so consumers can change `detectDebounceMs` at runtime. */
+    debounceMs: ComputedRef<number>;
+    /** Fired when the debounce timer settles. Runs regardless of input state — use this
+     *  to clear loading UI, then perform any pause-triggered work (e.g. detection). */
+    onSettle?: () => void;
+}
+export interface UseTypingPhaseReturn {
+    isDetecting: Readonly<Ref<boolean>>;
+    hasFinishedTyping: Readonly<Ref<boolean>>;
+    detectionAttempted: Readonly<Ref<boolean>>;
+    /** Call from the input handler on every keystroke that produces non-empty input. */
+    markTyping: () => void;
+    /** Flip `detectionAttempted` to true. Call from within the `onSettle` callback when
+     *  a real detection attempt is about to run — so the picker stays visible after even
+     *  a failed match. */
+    markDetectionAttempt: () => void;
+    /** Reset all three flags to defaults. Call when the input is cleared. */
+    reset: () => void;
+}
+export declare function useTypingPhase(opts: UseTypingPhaseOptions): UseTypingPhaseReturn;
+//# sourceMappingURL=useTypingPhase.d.ts.map

package/dist/entries/tell-input/composables/useTypingPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypingPhase.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/composables/useTypingPhase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,qBAAqB;IACpC,6FAA6F;IAC7F,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC;uFACmF;IACnF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,iBAAiB,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,oFAAoF;IACpF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;0BAEsB;IACtB,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,yEAAyE;IACzE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAmChF"}