@alikhalilll/ui 1.2.1 → 1.2.3

package/dist/entries/tell-input/index.d.ts

@@ -0,0 +1,12 @@
+export { default as ATellInput } from './components/ATellInput.vue';
+export { default as ACountrySelect } from './components/ACountrySelect.vue';
+export { default as ACountryFlag } from './components/ACountryFlag.vue';
+export { aTellInputVariants, DEFAULT_ERROR_MESSAGES, DEFAULT_MESSAGES, resolveMessages, type ATellInputProps, type ATellInputSize, type ATellInputVariants, type ATellInputDir, type TellInputMessages, type TellInputMessagesInput, } from './utils/types';
+export { defaultFlagUrl, type FlagUrlBuilder } from './utils/flag-url';
+export { normalizeDigits, LOCALE_DIGIT_RANGES } from './utils/digits';
+export * from './composables/usePhoneValidation';
+export * from './composables/useCountryDetection';
+export * from './composables/useCountryMatching';
+export * from './composables/useTypingPhase';
+export * from './composables/useTellInputValidation';
+//# sourceMappingURL=index.d.ts.map

package/dist/entries/tell-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../entries/tell-input/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGtE,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC"}

package/dist/entries/tell-input/utils/digits.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Alternative-numeral support. Phone numbers are routinely entered with the digits of the
+ * user's own script — Arabic-Indic, Persian/Urdu, Devanagari, Bengali. `libphonenumber-js`
+ * and our own `\d` cleanup only understand ASCII `0-9`, so anything else silently becomes
+ * an empty number. `normalizeDigits` folds those scripts down to ASCII before validation.
+ */
+/**
+ * Base code points of contiguous decimal-digit blocks. Each block runs `base`‥`base+9`
+ * for digit `0`‥`9`, so the ASCII digit is `codePoint - base`. Add a script by appending
+ * one entry here.
+ */
+export declare const LOCALE_DIGIT_RANGES: {
+    name: string;
+    base: number;
+}[];
+/**
+ * Replace any supported non-ASCII decimal digit with its ASCII equivalent. Every other
+ * character (spaces, `+`, separators, letters) is left untouched — callers still run their
+ * own `\D` cleanup afterwards.
+ */
+export declare function normalizeDigits(input: string): string;
+//# sourceMappingURL=digits.d.ts.map

package/dist/entries/tell-input/utils/digits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digits.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/utils/digits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAK/D,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD"}

package/dist/entries/tell-input/utils/flag-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default flag URL builder — flagcdn.com hosts PNG flags at multiple widths and is
+ * generous with caching + no API key required. Swap via the `flagUrl` prop on
+ * ATellInput / ACountrySelect / ACountryFlag to use any other source.
+ */
+export declare function defaultFlagUrl(iso2: string, width?: number): string;
+export type FlagUrlBuilder = (iso2: string, width: number) => string;
+//# sourceMappingURL=flag-url.d.ts.map

package/dist/entries/tell-input/utils/flag-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-url.d.ts","sourceRoot":"","sources":["../../../../entries/tell-input/utils/flag-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/entries/tell-input/utils/types.d.ts

@@ -0,0 +1,120 @@
+import type { HTMLAttributes } from 'vue';
+import { type VariantProps } from 'class-variance-authority';
+import type { DetectionStrategy } from '../composables/useCountryDetection';
+import type { PhoneValidationReason } from '../composables/usePhoneValidation';
+import { type Size } from '../../../utils';
+/** Alias for the shared `Size` scale — kept for backwards-friendly naming. */
+export type ATellInputSize = Size;
+export declare const aTellInputVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type ATellInputVariants = VariantProps<typeof aTellInputVariants>;
+/** Text direction for the field. `'auto'` (or omitting the prop) inherits from the
+ *  nearest `[dir]` ancestor / `<html dir>`; `'ltr'` / `'rtl'` force it. */
+export type ATellInputDir = 'ltr' | 'rtl' | 'auto';
+/**
+ * Every user-facing string in the tell-input UI, bundled so a consumer can localize the
+ * component in one prop. Each key has an English default in {@link DEFAULT_MESSAGES}.
+ */
+export interface TellInputMessages {
+    /** Placeholder of the country-picker search box. */
+    searchPlaceholder: string;
+    /** Shown when a search yields no countries. */
+    emptyText: string;
+    /** Shown while the country list is loading. */
+    loadingText: string;
+    /** Header of the "Suggested" group (current + recent picks). */
+    suggestedLabel: string;
+    /** Header of the full country list. */
+    allCountriesLabel: string;
+    /** Validation error text, keyed by reason. */
+    errorMessages: Record<PhoneValidationReason, string>;
+    /** Prefix of the country trigger's `aria-label`, e.g. `"Country: Egypt"`. */
+    countryLabel: string;
+    /** `aria-label` of the country trigger when no country is selected. */
+    selectCountryLabel: string;
+    /** `aria-label` of the phone input element. */
+    phoneInputLabel: string;
+}
+/** Partial override shape for the `messages` prop — every key (and every error reason) is optional. */
+export type TellInputMessagesInput = Partial<Omit<TellInputMessages, 'errorMessages'>> & {
+    errorMessages?: Partial<Record<PhoneValidationReason, string>>;
+};
+export interface ATellInputProps {
+    class?: HTMLAttributes['class'];
+    placeholder?: string;
+    disabled?: boolean;
+    loading?: boolean;
+    size?: ATellInputSize;
+    /**
+     * Text direction. Omit (or pass `'auto'`) to inherit from the page — RTL pages get an
+     * RTL field automatically. Pass `'ltr'` / `'rtl'` to force it.
+     */
+    dir?: ATellInputDir;
+    /**
+     * BCP-47 locale (e.g. `'ar'`, `'fr'`). When set, country names render localized via
+     * `Intl.DisplayNames` and the format hint uses the locale's numerals.
+     */
+    locale?: string;
+    /**
+     * Localized UI strings. A single bag covering the picker, validation errors, and a11y
+     * labels. Individual props (`searchPlaceholder`, `emptyText`, `loadingText`,
+     * `errorMessages`) take precedence over the matching `messages` key when both are set.
+     */
+    messages?: TellInputMessagesInput;
+    /**
+     * Whitelist of allowed dial-digit codes (no `+`), e.g. `['20', '966']`.
+     * Countries outside this list are still shown in the picker but rendered as disabled.
+     */
+    allowedDialCodes?: string[];
+    /** Light up the field's validation styling — coloured border + ring on the input and the
+     *  error message line below — when the number is valid / invalid. Default `false`, so the
+     *  field stays neutral and validation surfacing is left to the consumer (via the
+     *  `validation` ref exposure). */
+    showValidation?: boolean;
+    /** Show the green check / red alert icon at the end of the field. Default `false`; opt
+     *  in with `true`. Independent of `showValidation` — you can show the icon without the
+     *  coloured field, or vice versa. The slots `#valid-icon` / `#error-icon` still apply. */
+    showValidationIcon?: boolean;
+    /**
+     * Country auto-detect strategy. Defaults to `'auto'` — try IP geolocation first, then
+     * timezone, then `navigator.language`, finally `defaultCountry`.
+     */
+    detectCountry?: DetectionStrategy;
+    /**
+     * Initial country. Accepts either an ISO2 code (`'EG'`) or a dial-digit string
+     * (`'20'`, `'+20'`). When set, the picker is visible at mount with this country
+     * pre-selected — overrides the hidden-until-detected default.
+     */
+    defaultCountry?: string;
+    /** Override the IP geolocation endpoint. Must return JSON with `country_code` or `country`. */
+    ipEndpoint?: string;
+    /** Localized strings for the country picker UI. */
+    searchPlaceholder?: string;
+    emptyText?: string;
+    loadingText?: string;
+    /** Error labels keyed by reason. Each gets a sensible English default. */
+    errorMessages?: Partial<Record<PhoneValidationReason, string>>;
+    /**
+     * When true, the country picker is hidden until a leading dial code is detected in the
+     * phone input. Every keystroke runs a longest-prefix match against known dial codes; on
+     * first match the picker reveals with that country and the matched dial digits are
+     * stripped from `phone`. Skips the onMount IP/timezone/locale detection chain.
+     */
+    detectFromInput?: boolean;
+    /**
+     * Debounce window (ms) for `detectFromInput` detection. Each keystroke schedules the
+     * libphonenumber parse + lookup; bursts of typing/paste collapse into a single call.
+     * Clearing the input is not debounced — the picker hides immediately. Default 150ms.
+     */
+    detectDebounceMs?: number;
+}
+export declare const DEFAULT_ERROR_MESSAGES: Record<PhoneValidationReason, string>;
+/** English defaults for every {@link TellInputMessages} key. */
+export declare const DEFAULT_MESSAGES: TellInputMessages;
+/**
+ * Merge a partial `messages` override onto the English defaults. Used internally by
+ * `ATellInput` to resolve a complete {@link TellInputMessages} object.
+ */
+export declare function resolveMessages(input?: TellInputMessagesInput): TellInputMessages;
+//# sourceMappingURL=types.d.ts.map

package/dist/entries/tell-input/utils/types.d.ts.map

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