@wow-two-beta/fe 0.0.38 → 0.0.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/dist/formsEngine/AppForm.d.ts +12 -3
  2. package/dist/formsEngine/FormOperations.d.ts +18 -0
  3. package/dist/formsEngine/FormOperations.js +9 -0
  4. package/dist/formsEngine/FormOperations.js.map +1 -1
  5. package/dist/formsEngine/adapters/house/HouseFormCore.js +15 -6
  6. package/dist/formsEngine/adapters/house/HouseFormCore.js.map +1 -1
  7. package/dist/formsEngine/adapters/tanstack/TanstackFormOverlay.d.ts +4 -0
  8. package/dist/formsEngine/adapters/tanstack/TanstackFormOverlay.js +10 -1
  9. package/dist/formsEngine/adapters/tanstack/TanstackFormOverlay.js.map +1 -1
  10. package/dist/formsEngine/adapters/tanstack/UseAppForm.js +9 -6
  11. package/dist/formsEngine/adapters/tanstack/UseAppForm.js.map +1 -1
  12. package/dist/foundation/animation/animatedLayout/AnimatedLayout.d.ts +3 -3
  13. package/dist/foundation/dom/FocusTarget.d.ts +13 -0
  14. package/dist/foundation/dom/FocusTarget.js +12 -0
  15. package/dist/foundation/dom/FocusTarget.js.map +1 -0
  16. package/dist/foundation/dom/index.d.ts +1 -0
  17. package/dist/foundation/dom/index.js +3 -0
  18. package/dist/foundation/dom/index.js.map +1 -1
  19. package/dist/foundation/phone/PhoneCountries.d.ts +13 -0
  20. package/dist/foundation/phone/PhoneCountries.js +62 -0
  21. package/dist/foundation/phone/PhoneCountries.js.map +1 -0
  22. package/dist/foundation/phone/PhoneFormats.d.ts +12 -0
  23. package/dist/foundation/phone/PhoneFormats.js +32 -0
  24. package/dist/foundation/phone/PhoneFormats.js.map +1 -0
  25. package/dist/foundation/phone/PhoneNumberExtensions.d.ts +94 -0
  26. package/dist/foundation/phone/PhoneNumberExtensions.js +137 -0
  27. package/dist/foundation/phone/PhoneNumberExtensions.js.map +1 -0
  28. package/dist/foundation/phone/index.d.ts +3 -0
  29. package/dist/foundation/phone/index.js +9 -0
  30. package/dist/foundation/phone/index.js.map +1 -0
  31. package/dist/foundation/primitives/index.d.ts +1 -0
  32. package/dist/foundation/primitives/index.js +3 -0
  33. package/dist/foundation/primitives/index.js.map +1 -1
  34. package/dist/foundation/primitives/swapTransition/SwapTransition.d.ts +76 -0
  35. package/dist/foundation/primitives/swapTransition/SwapTransition.js +240 -0
  36. package/dist/foundation/primitives/swapTransition/SwapTransition.js.map +1 -0
  37. package/dist/foundation/primitives/swapTransition/index.d.ts +1 -0
  38. package/dist/foundation/validators/Formats.d.ts +15 -0
  39. package/dist/foundation/validators/Formats.js +32 -1
  40. package/dist/foundation/validators/Formats.js.map +1 -1
  41. package/dist/foundation/validators/Messages.d.ts +1 -1
  42. package/dist/foundation/validators/Messages.js +10 -0
  43. package/dist/foundation/validators/Messages.js.map +1 -1
  44. package/dist/foundation/validators/index.d.ts +1 -1
  45. package/dist/foundation/validators/index.js +2 -1
  46. package/dist/index.css +11 -0
  47. package/dist/index.js +2 -1
  48. package/dist/index.js.map +1 -1
  49. package/dist/presentation/actions/refreshButton/RefreshButton.vue.js.map +1 -1
  50. package/dist/presentation/display/animatedNumberText/AnimatedNumberText.vue.d.ts +1 -1
  51. package/dist/presentation/display/carousel/Carousel.vue.d.ts +1 -1
  52. package/dist/presentation/display/countUpText/CountUpText.vue.d.ts +1 -1
  53. package/dist/presentation/display/scrollRevealGroup/ScrollRevealGroup.vue.d.ts +2 -2
  54. package/dist/presentation/forms/field/Field.vue.js +10 -3
  55. package/dist/presentation/forms/field/Field.vue.js.map +1 -1
  56. package/dist/presentation/forms/imageCropEditor/ImageCropEditor.vue.d.ts +1 -1
  57. package/dist/presentation/forms/imageEditor/ImageEditor.vue.d.ts +1 -1
  58. package/dist/presentation/forms/index.js +2 -1
  59. package/dist/presentation/forms/index.js.map +1 -1
  60. package/dist/presentation/forms/labeledField/LabeledField.vue.js +2 -2
  61. package/dist/presentation/forms/labeledField/LabeledField.vue.js.map +1 -1
  62. package/dist/presentation/forms/phoneInput/PhoneInput.vue.d.ts +5 -9
  63. package/dist/presentation/forms/phoneInput/PhoneInput.vue.js +104 -92
  64. package/dist/presentation/forms/phoneInput/PhoneInput.vue.js.map +1 -1
  65. package/dist/presentation/forms/phoneInput/PhoneInput2.vue.js +0 -2
  66. package/dist/presentation/forms/phoneInput/PhoneInput2.vue.js.map +1 -1
  67. package/dist/presentation/forms/phoneInput/index.d.ts +2 -1
  68. package/dist/presentation/layout/navbar/Navbar.vue.js.map +1 -1
  69. package/dist/router/adapters/vueRouter/routeAnnouncer/RouteAnnouncer.vue.js +17 -5
  70. package/dist/router/adapters/vueRouter/routeAnnouncer/RouteAnnouncer.vue.js.map +1 -1
  71. package/package.json +6 -1
@@ -1 +1 @@
1
- {"version":3,"file":"UseAppForm.js","sources":["../../../../src/formsEngine/adapters/tanstack/UseAppForm.ts"],"sourcesContent":["import { createFormArrayIdentity } from '../../FormArrayIdentity';\nimport { onMounted, onScopeDispose, shallowRef, toValue, type ShallowRef } from 'vue';\n\nimport {\n revalidateLogic,\n useForm,\n type DeepKeys,\n type FormApi,\n type FormAsyncValidateOrFn,\n type FormOptions,\n type FormValidateAsyncFn,\n type VueFormApi,\n} from '@tanstack/vue-form';\n\nimport { fieldIssues } from '../../../foundation/http';\nimport { AppErrorFactory, type AppError } from '../../../foundation/results';\nimport type { ResolveValidationMessage } from '../../../foundation/validators';\n\nimport type {\n AppFieldApi,\n AppForm,\n AppFormOptions,\n AppFormOptionsSource,\n AppFormState,\n AppFormValidationOptions,\n} from '../../AppForm';\nimport { deepEqual } from '../../DeepEqual';\nimport { includesValidationPath, submitWithFocus, untilFormAbort, validateFormScope } from '../../FormOperations';\nimport { snapshotFormValues } from '../../FormSnapshot';\nimport { createFieldApi, createFieldComponent, createFormStateView, createUseFormState } from '../../FormGlue';\nimport { getPath, hasPath } from '../../Paths';\nimport {\n createOptionsMessageResolver,\n parseStandardSchema,\n formParseFailure,\n type FormParseResult,\n} from '../../SchemaValidation';\nimport { defaultMapFieldPath, resolveSubmitFailure, toSubmitError } from '../../SubmitErrors';\n\nimport { createTanstackFormOverlay, type TanstackFormOverlay, type TanstackOverlayState } from './TanstackFormOverlay';\n\n/*\n * The tanstack adapter — the facade contract over `@tanstack/vue-form` (optional peer).\n * TanStack owns values, validation scheduling, and the submit lifecycle; the overlay\n * (`TanstackFormOverlay`) owns everything the contract pins that TanStack models\n * differently — server-error merge/clearing, baseline-compared dirty, blur-or-submit\n * touched, contract array reindexing, `submitError` (see the overlay's module doc).\n *\n * Validation wiring: the whole-form Standard Schema runs as a TanStack form-level\n * `onDynamicAsync` validator under `revalidateLogic` — `validateOn` maps 1:1 onto its\n * pre-submission `mode` ('submit' default / 'blur' / 'change'), and `modeAfterSubmission:\n * 'change'` gives the pinned post-attempt change-revalidation. The validator returns\n * TanStack's global `{ form?, fields }` error shape, so client errors land in TanStack\n * field meta (created on demand — no TanStack `Field` mounts needed) and `state.isValid`\n * stays engine-native. Adapter notes (both mirror the contract's static options intent):\n * - `validateOn` is creation-pinned; schema and message values are read per run.\n * Schema presence may change through the options getter.\n * - Escape-hatch writes (`engine.setFieldValue`) bypass the overlay — server-error\n * clearing and touched semantics then follow TanStack, not the contract.\n *\n * HOW STATE IS READ. `@tanstack/vue-form` is `form-core` under a Vue host binding.\n * - The returned instance is `FormApi & VueFormApi`.\n * - TanStack's store is a `@tanstack/store` `Store`, invisible to Vue's tracker. It is bridged\n * ONCE, here, into a `shallowRef` (`bridgeStore`); every contract read then flows through\n * Vue reactivity. `form.useSelector` would do the same per slice, but it wraps its ref in\n * `readonly()`, which would hand values back through a proxy and break the identity compares\n * the reader and `deepEqual` rely on.\n * - `useForm` applies its options ONCE (Vue's `setup` runs once), so the options object must\n * stay stable: `reset()` keeps `tanstackOptions.defaultValues` in step with TanStack's own\n * copy.\n */\n\n/** The native TanStack form instance the adapter builds — what `form.engine` exposes. */\nexport type TanstackFormEngine<TValues extends object> = FormApi<\n TValues,\n undefined, // onMount\n undefined, // onChange\n undefined, // onChangeAsync\n undefined, // onBlur\n undefined, // onBlurAsync\n undefined, // onSubmit\n undefined, // onSubmitAsync\n undefined, // onDynamic\n FormAsyncValidateOrFn<TValues>, // onDynamicAsync — the adapter's schema bridge\n undefined, // onServer\n never // submitMeta\n> &\n VueFormApi<\n TValues,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n FormAsyncValidateOrFn<TValues>,\n undefined,\n never\n >;\n\ntype TanstackFormOptions<TValues extends object> = FormOptions<\n TValues,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n FormAsyncValidateOrFn<TValues>,\n undefined,\n never\n>;\n\nconst EmptyMessages: ReadonlyArray<string> = Object.freeze([]);\n\n/**\n * Folds the shared schema-error map into TanStack's global form error shape:\n * root-path (`''`) issues become the form-level error, the rest per-field errors.\n */\nfunction toEngineValidationError(errors: Record<string, ReadonlyArray<string>>): unknown {\n const paths = Object.keys(errors);\n if (paths.length === 0) return undefined;\n const fields: Record<string, ReadonlyArray<string>> = Object.create(null);\n let form: ReadonlyArray<string> | undefined;\n for (const path of paths) {\n if (path === '') form = errors[path];\n else fields[path] = errors[path] ?? [];\n }\n return form ? { form, fields } : { fields };\n}\n\n/**\n * Normalizes TanStack field-meta errors to plain messages. The adapter's own validator\n * yields `string[]`, but escape-hatch validators may add strings, nested arrays, or\n * Standard Schema issue objects — all are accepted.\n */\nfunction toMessages(errors: ReadonlyArray<unknown> | undefined): ReadonlyArray<string> {\n if (!errors || errors.length === 0) return EmptyMessages;\n const messages: string[] = [];\n const visit = (error: unknown): void => {\n if (error === null || error === undefined) return;\n if (typeof error === 'string') {\n messages.push(error);\n return;\n }\n if (Array.isArray(error)) {\n for (const entry of error) visit(entry);\n return;\n }\n if (typeof error === 'object' && typeof (error as { message?: unknown }).message === 'string') {\n messages.push((error as { message: string }).message);\n }\n };\n for (const error of errors) visit(error);\n return messages.length > 0 ? messages : EmptyMessages;\n}\n\n/** The per-field slice the `Field` glue reads — identity-stable while its members are unchanged. */\ninterface TanstackFieldState {\n readonly value: unknown;\n readonly errors: ReadonlyArray<string>;\n readonly isDirty: boolean;\n readonly isTouched: boolean;\n}\n\n/** The minimal structural view of TanStack form state the reader consumes (loose string paths). */\ninterface EngineStateView {\n readonly values: unknown;\n readonly isValid: boolean;\n readonly isValidating: boolean;\n readonly isFormValidating: boolean;\n readonly fieldMeta: Partial<Record<string, { readonly errors: ReadonlyArray<unknown> }>>;\n}\n\nfunction sameMessages(a: ReadonlyArray<string>, b: ReadonlyArray<string>): boolean {\n return a === b || (a.length === b.length && a.every((message, index) => message === b[index]));\n}\n\nfunction fieldStatesEqual(a: TanstackFieldState, b: TanstackFieldState): boolean {\n return (\n Object.is(a.value, b.value) &&\n a.isDirty === b.isDirty &&\n a.isTouched === b.isTouched &&\n sameMessages(a.errors, b.errors)\n );\n}\n\n/**\n * Mirrors the `@tanstack/store` store into a `shallowRef` — the ONE seam that puts TanStack\n * state inside Vue's tracker. Deliberately not `useSelector`/`useStore` from\n * `@tanstack/vue-store`: those wrap the ref in `readonly()`, which would hand every read back\n * through a deep proxy and defeat the `Object.is` identity compares the reader, `deepEqual`, and\n * TanStack's own writes all depend on.\n */\nfunction bridgeStore<TValues extends object>(engine: TanstackFormEngine<TValues>): ShallowRef<EngineStateView> {\n const snapshot = shallowRef(engine.store.state as unknown as EngineStateView);\n const subscription = engine.store.subscribe((next) => {\n snapshot.value = next as unknown as EngineStateView;\n });\n onScopeDispose(() => subscription.unsubscribe(), true);\n return snapshot;\n}\n\ninterface CombinedReader<TValues extends object> {\n readonly getFormState: () => AppFormState<TValues>;\n readonly getFieldState: (path: string) => TanstackFieldState;\n}\n\n/**\n * Derives the contract state from the (TanStack store state, overlay state) pair with\n * generation caching: snapshots are rebuilt only when either source commits, and per-path\n * field slices reuse the previous generation's identity when unchanged — so a read stays\n * referentially stable between commits. Both sources are `shallowRef`s, so every read below\n * is also the subscription.\n */\nfunction createCombinedReader<TValues extends object>(\n snapshot: ShallowRef<EngineStateView>,\n overlay: TanstackFormOverlay<TValues>,\n): CombinedReader<TValues> {\n let generation: { tan: EngineStateView; ov: TanstackOverlayState<TValues> } | null = null;\n let formState: AppFormState<TValues> | null = null;\n let fieldCache = new Map<string, TanstackFieldState>();\n let previousFieldCache = new Map<string, TanstackFieldState>();\n\n function currentGeneration(): { tan: EngineStateView; ov: TanstackOverlayState<TValues> } {\n const tan = snapshot.value;\n const ov = overlay.state.value;\n if (generation && generation.tan === tan && generation.ov === ov) return generation;\n generation = { tan, ov };\n formState = null;\n previousFieldCache = fieldCache;\n fieldCache = new Map();\n return generation;\n }\n\n return {\n getFormState: () => {\n const { tan, ov } = currentGeneration();\n formState ??= {\n values: tan.values as TValues,\n isDirty: !deepEqual(tan.values, ov.baseline),\n // Client validity is engine-native; the server-error overlay holds it false too.\n isValid:\n (ov.scopedErrors === null\n ? tan.isValid\n : Object.keys(ov.scopedErrors).length === 0 &&\n Object.entries(tan.fieldMeta).every(\n ([path, meta]) => includesValidationPath(path, ov.scopedFields) || !meta?.errors.length,\n )) && Object.keys(ov.serverErrors).length === 0,\n isSubmitting: ov.isSubmitting,\n // Whole-schema validation is a FORM-level validator — TanStack's derived\n // `isValidating` counts field-level validators only, so merge both flags.\n isValidating: tan.isFormValidating || tan.isValidating || ov.isScopeValidating,\n submitError: ov.submitError,\n isSubmitSuccessful: ov.isSubmitSuccessful,\n };\n return formState;\n },\n getFieldState: (path) => {\n const { tan, ov } = currentGeneration();\n const cached = fieldCache.get(path);\n if (cached) return cached;\n const value = getPath(tan.values, path);\n const clientMessages =\n ov.scopedErrors !== null && includesValidationPath(path, ov.scopedFields)\n ? (ov.scopedErrors[path] ?? EmptyMessages)\n : toMessages(tan.fieldMeta[path]?.errors);\n const serverMessages = ov.serverErrors[path] ?? EmptyMessages;\n const computed: TanstackFieldState = {\n value,\n // Client + server messages merged, client first (contract JSDoc).\n errors:\n serverMessages.length === 0\n ? clientMessages\n : clientMessages.length === 0\n ? serverMessages\n : [...clientMessages, ...serverMessages],\n isDirty: !deepEqual(value, getPath(ov.baseline, path)),\n // A submit attempt counts as touching everything — error-display gating works post-attempt.\n isTouched: [...ov.touched].some((selected) => includesValidationPath(path, [selected])) || ov.submitCount > 0,\n };\n const previous = previousFieldCache.get(path);\n const stable = previous && fieldStatesEqual(previous, computed) ? previous : computed;\n fieldCache.set(path, stable);\n return stable;\n },\n };\n}\n\ninterface AdapterPrelude<TValues extends object, TOutput> {\n readonly getOptions: () => AppFormOptions<TValues, TOutput>;\n readonly overlay: TanstackFormOverlay<TValues>;\n readonly tanstackOptions: TanstackFormOptions<TValues>;\n readonly parseValues: (values: TValues, fresh?: boolean) => Promise<FormParseResult<TOutput>>;\n /** The form's message resolver, memoized against the `messages` / `labels` option identities. */\n readonly messageResolver: () => ResolveValidationMessage;\n readonly bindValues: (read: () => TValues) => void;\n}\n\n/** Builds the overlay + the stable TanStack options (all callbacks read the latest options through `getOptions`). */\nfunction createAdapterPrelude<TValues extends object, TOutput>(\n getOptions: () => AppFormOptions<TValues, TOutput>,\n): AdapterPrelude<TValues, TOutput> {\n let readCurrentValues: (() => TValues) | null = null;\n const initialOptions = getOptions();\n const initialValues = snapshotFormValues(initialOptions.defaultValues);\n const overlay = createTanstackFormOverlay<TValues>(snapshotFormValues(initialValues));\n const messageResolver = createOptionsMessageResolver(getOptions);\n\n let cached: {\n values: TValues;\n schema: AppFormOptions<TValues, TOutput>['schema'];\n resolver: ResolveValidationMessage;\n result: Promise<FormParseResult<TOutput>>;\n } | null = null;\n const parseValues = (values: TValues, fresh = false): Promise<FormParseResult<TOutput>> => {\n const schema = getOptions().schema;\n const resolver = messageResolver();\n if (\n !fresh &&\n cached !== null &&\n deepEqual(cached.values, values) &&\n cached.schema === schema &&\n cached.resolver === resolver\n )\n return cached.result;\n const snapshot = snapshotFormValues(values);\n const result = Promise.resolve()\n .then(() =>\n schema\n ? parseStandardSchema(schema, snapshot, resolver)\n : { ok: true as const, value: snapshot as unknown as TOutput },\n )\n .catch((): FormParseResult<TOutput> =>\n formParseFailure({ '': [getOptions().fallbackErrorMessage ?? 'Validation failed'] }),\n );\n cached = { values: snapshotFormValues(values), schema, resolver, result };\n return result;\n };\n\n const tanstackOptions: TanstackFormOptions<TValues> = {\n defaultValues: initialValues,\n onSubmit: async ({ value }) => {\n // The contract's `isSubmitting` brackets ONLY the app submit call (house-identical),\n // not TanStack's validation window. Failures propagate to the adapter's\n // `handleSubmit` catch, so TanStack's own submit lifecycle stays truthful.\n overlay.setSubmitting(true);\n try {\n const parsed = await parseValues(value, true);\n if (!parsed.ok) return;\n const result = await getOptions().onSubmit(parsed.value, { signal: new AbortController().signal });\n // Reached only when validation passed AND the app submit resolved — the verdict's\n // sole success signal (the invalid path never runs this; a throw skips it).\n overlay.setSubmitSuccessful(result.ok);\n } finally {\n overlay.setSubmitting(false);\n }\n },\n };\n\n const validateWithSchema: FormValidateAsyncFn<TValues> = async ({ value, signal }) => {\n overlay.setScope(null);\n const snapshot = snapshotFormValues(value);\n const result = await untilFormAbort(parseValues(snapshot), signal, null);\n if (!result || (readCurrentValues && !deepEqual(snapshot, readCurrentValues()))) return undefined;\n return toEngineValidationError(result.ok ? {} : result.failure.fieldErrors);\n };\n tanstackOptions.validators = { onDynamicAsync: validateWithSchema };\n tanstackOptions.validationLogic = (props) =>\n revalidateLogic({\n mode:\n overlay.getState().submitCount > 0 || overlay.getState().touched.size > 0\n ? 'change'\n : (initialOptions.validateOn ?? 'submit'),\n modeAfterSubmission: 'change',\n })(props);\n\n return {\n getOptions,\n overlay,\n tanstackOptions,\n messageResolver,\n parseValues,\n bindValues: (read) => {\n readCurrentValues = read;\n },\n };\n}\n\n/** What `buildAppForm` returns — the contract surface plus the teardown the adapter's own timer needs. */\ninterface BuiltForm<TValues extends object> {\n readonly form: AppForm<TValues, TanstackFormEngine<TValues>>;\n /** Releases the pending `submitOn: 'change'` debounce timer on scope teardown. */\n readonly dispose: () => void;\n}\n\n/** Builds the stable contract surface over the TanStack engine + overlay pair. */\nfunction buildAppForm<TValues extends object, TOutput>(\n engine: TanstackFormEngine<TValues>,\n prelude: AdapterPrelude<TValues, TOutput>,\n): BuiltForm<TValues> {\n const { getOptions, overlay, tanstackOptions, messageResolver, parseValues } = prelude;\n let lifecycleEpoch = 0;\n let validationEpoch = 0;\n let focusEpoch = 0;\n let requestController = new AbortController();\n let disposed = false;\n let trailingSubmit = false;\n let submittingValues: TValues | null = null;\n const reader = createCombinedReader(bridgeStore(engine), overlay);\n const identity = createFormArrayIdentity(() => engine.store.state.values);\n\n // ── Submit path shared by `handleSubmit` + auto-submit (validate → onSubmit → map failure) ─────\n /** Resolves a thrown submit failure onto the overlay (matched paths → fields, remainder → banner). */\n function applySubmitFailure(error: AppError, submittedValues = engine.store.state.values): void {\n const options = getOptions();\n const values = engine.store.state.values;\n overlay.applySubmitFailure(\n resolveSubmitFailure(\n error,\n options.mapSubmitError ?? fieldIssues,\n options.mapFieldPath ?? defaultMapFieldPath,\n (path) => hasPath(submittedValues, path) && deepEqual(getPath(submittedValues, path), getPath(values, path)),\n options.fallbackErrorMessage,\n messageResolver(),\n ),\n );\n }\n\n async function performSubmit(values: TValues): Promise<boolean> {\n if (disposed || getOptions().isDisabled) return false;\n const epoch = lifecycleEpoch;\n const signal = requestController.signal;\n const isCurrent = (): boolean => !disposed && epoch === lifecycleEpoch;\n validationEpoch += 1;\n overlay.setScope(null);\n overlay.beginSubmitAttempt();\n // The facade owns submission snapshots; TanStack still owns field validation and metadata.\n // Its validator reuses this parse, so transforming/async schemas run once for this input.\n const parsing = parseValues(values, true);\n await engine.validate('submit');\n const parsed = await parsing;\n if (!isCurrent()) return false;\n if (!parsed.ok) {\n overlay.setSubmitSuccessful(false);\n return false;\n }\n overlay.setSubmitting(true);\n let successful = false;\n try {\n const result = await untilFormAbort(getOptions().onSubmit(parsed.value, { signal }), signal, {\n ok: false,\n failure: AppErrorFactory.cancelled(),\n });\n successful = result.ok;\n if (isCurrent() && result.ok) overlay.setBaseline(values);\n else if (isCurrent() && !result.ok) applySubmitFailure(result.failure, values);\n } catch (error) {\n if (isCurrent()) applySubmitFailure(toSubmitError(error, getOptions().fallbackErrorMessage), values);\n } finally {\n if (isCurrent()) overlay.setSubmitting(false);\n if (isCurrent()) overlay.setSubmitSuccessful(successful);\n }\n return successful && isCurrent();\n }\n\n /** Serializes submissions and coalesces newer edits into one trailing snapshot. */\n let inFlight: Promise<boolean> | null = null;\n async function guardedSubmit(): Promise<boolean> {\n if (disposed) return false;\n if (inFlight) {\n if (!deepEqual(engine.store.state.values, submittingValues)) trailingSubmit = true;\n return inFlight;\n }\n const run = async (): Promise<boolean> => {\n let successful = false;\n do {\n trailingSubmit = false;\n submittingValues = snapshotFormValues(engine.store.state.values);\n successful = await untilFormAbort(performSubmit(submittingValues), requestController.signal, false);\n } while (\n !disposed &&\n trailingSubmit &&\n !deepEqual(engine.store.state.values, submittingValues) &&\n !deepEqual(engine.store.state.values, overlay.getState().baseline)\n );\n return successful;\n };\n inFlight = run();\n try {\n return await inFlight;\n } finally {\n inFlight = null;\n submittingValues = null;\n }\n }\n\n /** Validate without submitting — marks touched, runs the whole-form schema, resolves client validity. */\n async function validate(options?: AppFormValidationOptions<TValues>): Promise<boolean> {\n if (disposed) return false;\n const epoch = ++validationEpoch;\n const lifecycle = lifecycleEpoch;\n if (options) {\n for (const meta of Object.values(engine.state.validationMetaMap)) meta?.lastAbortController.abort();\n const values = snapshotFormValues(engine.store.state.values);\n for (const path of options.fields ?? Object.keys(values)) overlay.markBlurred(path);\n overlay.setScopeValidating(true);\n const errors = await untilFormAbort(\n validateFormScope(\n values,\n options,\n getOptions().schema,\n messageResolver(),\n getOptions().fallbackErrorMessage ?? 'Validation failed',\n ),\n requestController.signal,\n {},\n );\n if (disposed || epoch !== validationEpoch || lifecycle !== lifecycleEpoch) return false;\n overlay.setScopeValidating(false);\n if (!deepEqual(values, engine.store.state.values)) return false;\n const previous = overlay.getState();\n const retained = Object.fromEntries(\n Object.entries(previous.scopedErrors ?? {}).filter(([path]) => !includesValidationPath(path, options.fields)),\n );\n const fields =\n options.fields &&\n (previous.scopedErrors === null\n ? options.fields\n : previous.scopedFields && [...previous.scopedFields, ...options.fields]);\n overlay.setScope({ ...retained, ...errors }, fields);\n return Object.keys(errors).length === 0;\n }\n overlay.setScope(null);\n overlay.touchAll();\n const values = snapshotFormValues(engine.store.state.values);\n const parsing = parseValues(values, true);\n const result = await untilFormAbort(\n Promise.all([engine.validate('submit'), parsing]),\n requestController.signal,\n null,\n );\n return (\n !disposed &&\n lifecycle === lifecycleEpoch &&\n epoch === validationEpoch &&\n result !== null &&\n result[1].ok &&\n deepEqual(values, engine.store.state.values)\n );\n }\n\n // ── Auto-submit (`submitOn`) — routes through the SAME `guardedSubmit` as manual submit ────────\n let autoSubmitTimer: ReturnType<typeof setTimeout> | null = null;\n const clearAutoSubmitTimer = (): void => {\n if (autoSubmitTimer !== null) {\n clearTimeout(autoSubmitTimer);\n autoSubmitTimer = null;\n }\n };\n const scheduleAutoSubmit = (): void => {\n if ((getOptions().submitOn ?? 'manual') !== 'change') return;\n clearAutoSubmitTimer();\n const delay = getOptions().submitDebounceMs ?? 0;\n autoSubmitTimer = setTimeout(() => {\n autoSubmitTimer = null;\n void guardedSubmit();\n }, delay);\n };\n const autoSubmitOnBlur = (): void => {\n if ((getOptions().submitOn ?? 'manual') === 'blur') void guardedSubmit();\n };\n\n // One API object per path — memoized, so the identity a slot payload sees is stable.\n const fieldApis = new Map<string, AppFieldApi<unknown>>();\n const fieldOps = {\n getState: (path: string) => reader.getFieldState(path),\n setValue: (path: string, value: unknown) => {\n // Server messages clear on the next change to the field (contract JSDoc).\n overlay.clearServerErrorsAt(path);\n // Triggers TanStack 'change'-cause validation, gated by `revalidateLogic`.\n engine.setFieldValue(path as DeepKeys<TValues>, snapshotFormValues(value) as never);\n identity.replace(path);\n // `submitOn: 'change'` — a user-origin write schedules the debounced auto-submit.\n scheduleAutoSubmit();\n },\n blur: (path: string) => {\n overlay.markBlurred(path);\n // 'blur'-cause validation — runs the schema only in `validateOn: 'blur'` mode.\n void engine.validateField(path as DeepKeys<TValues>, 'blur');\n // `submitOn: 'blur'` — save-on-blur.\n autoSubmitOnBlur();\n },\n };\n const getFieldApi = (path: string): AppFieldApi<unknown> => {\n const existing = fieldApis.get(path);\n if (existing) return existing;\n const api = createFieldApi(path, fieldOps);\n fieldApis.set(path, api);\n return api;\n };\n\n const arrayOperation = (path: string, operation: Parameters<typeof overlay.remapForArrayOperation>[1]): void => {\n // TanStack's array ops are constrained to its typed array paths (`DeepKeysOfType`); the\n // contract's paths are loose strings, so the vendor's path algebra is opted out of with\n // `never` rather than reimplemented here.\n identity.operation(path, operation, () => {\n const field = path as never;\n switch (operation.kind) {\n case 'push':\n engine.pushFieldValue(field, snapshotFormValues(operation.value) as never);\n break;\n case 'insert':\n void engine.insertFieldValue(field, operation.index, snapshotFormValues(operation.value) as never);\n break;\n case 'remove':\n void engine.removeFieldValue(field, operation.index);\n break;\n case 'swap':\n engine.swapFieldValues(field, operation.indexA, operation.indexB);\n break;\n case 'move':\n engine.moveFieldValues(field, operation.fromIndex, operation.toIndex);\n break;\n }\n // Contract reindexing for the overlay: row-scoped server errors + touched marks\n // follow their rows. TanStack shifts its OWN field meta by its rules; where they\n // differ, the contract wins because errors/touched surface from the overlay and\n // client errors are recomputed by the op's change-revalidation.\n overlay.remapForArrayOperation(path, operation);\n });\n scheduleAutoSubmit();\n };\n\n function invalidateWork(): void {\n lifecycleEpoch += 1;\n validationEpoch += 1;\n focusEpoch += 1;\n requestController.abort();\n requestController = new AbortController();\n for (const meta of Object.values(engine.state.validationMetaMap)) meta?.lastAbortController.abort();\n engine.baseStore.setState((previous) => ({ ...previous, isFormValidating: false }));\n overlay.setSubmitting(false);\n overlay.setScopeValidating(false);\n trailingSubmit = false;\n clearAutoSubmitTimer();\n }\n\n const state = createFormStateView<TValues>(reader.getFormState);\n\n const form: AppForm<TValues, TanstackFormEngine<TValues>> = {\n Field: createFieldComponent<TValues>(getFieldApi, () => getOptions().isDisabled ?? false),\n state,\n // The same computed `state.values` reads — `form.values` is a shorthand, never a second source.\n get values() {\n return state.values;\n },\n useFormState: createUseFormState<TValues>(reader.getFormState),\n handleSubmit: async (event?: Event) => {\n const epoch = ++focusEpoch;\n return submitWithFocus(guardedSubmit, () => epoch === focusEpoch, event, getOptions().focusRoot?.());\n },\n validate,\n cancelSubmit: () => {\n invalidateWork();\n overlay.applySubmitFailure({ fieldErrors: {}, submitError: AppErrorFactory.cancelled() });\n overlay.setSubmitSuccessful(false);\n },\n invalidateSession: (next) => form.reset(next),\n setValue: (path, value) => {\n // Server messages clear on the next change to the field (contract JSDoc) — mirror the\n // in-field `setValue`; TanStack's 'change'-cause validation runs under `revalidateLogic`.\n overlay.clearServerErrorsAt(path);\n engine.setFieldValue(path as DeepKeys<TValues>, snapshotFormValues(value) as never);\n identity.replace(path);\n scheduleAutoSubmit();\n },\n array: (path: string) => ({\n get keys() {\n return identity.keys(path);\n },\n push: (value: unknown) => arrayOperation(path, { kind: 'push', value }),\n insert: (index: number, value: unknown) => arrayOperation(path, { kind: 'insert', index, value }),\n remove: (index: number) => arrayOperation(path, { kind: 'remove', index }),\n swap: (indexA: number, indexB: number) => arrayOperation(path, { kind: 'swap', indexA, indexB }),\n move: (fromIndex: number, toIndex: number) => arrayOperation(path, { kind: 'move', fromIndex, toIndex }),\n }),\n reset: (next?: TValues) => {\n invalidateWork();\n const values = snapshotFormValues(next ?? overlay.getState().baseline);\n // Keep the options object TanStack was created with in sync: its own `reset(values)`\n // rewrites `options.defaultValues`, and any later `update()` would otherwise clobber the\n // re-seeded values back from the stale copy.\n tanstackOptions.defaultValues = values;\n overlay.reset(snapshotFormValues(values));\n engine.reset(values);\n identity.reset();\n clearAutoSubmitTimer(); // a reset/prefill never auto-submits — drop any pending trailing submit\n },\n setFieldErrors: (errors: Record<string, ReadonlyArray<string>>) => overlay.replaceServerErrors(errors),\n clearSubmitError: () => overlay.clearSubmitError(),\n engine,\n };\n\n return {\n form,\n dispose: () => {\n invalidateWork();\n disposed = true;\n },\n };\n}\n\n/**\n * The tanstack adapter's `useAppForm` — the facade contract over `@tanstack/vue-form`.\n * The returned form object is stable for the owning scope's lifetime and every state member on\n * it is a live getter, so `form.values.title` / `form.state.isSubmitting` read in a template ARE\n * the subscription; `form.engine` exposes the native {@link TanstackFormEngine} (the 90/10\n * escape hatch — typed here, `unknown` on the shared contract), including TanStack's typed\n * deep-path `Field`/`Subscribe` and per-field validator graph.\n *\n * Call it in `setup()`: `useForm` registers an `onMounted` of its own, and the store bridge +\n * the pending `submitOn: 'change'` timer release on scope teardown.\n */\nexport function useAppForm<TValues extends object, TOutput = TValues>(\n options: AppFormOptionsSource<TValues, TOutput>,\n): AppForm<TValues, TanstackFormEngine<TValues>> {\n const prelude = createAdapterPrelude<TValues, TOutput>(() => toValue(options));\n const engine = useForm(prelude.tanstackOptions) as TanstackFormEngine<TValues>;\n prelude.bindValues(() => engine.store.state.values);\n const built = buildAppForm<TValues, TOutput>(engine, prelude);\n\n // Validate once on mount when flagged — seeds `isValid` / field errors WITHOUT marking touched\n // (the mount pass shows validity without asserting the user interacted).\n onMounted(() => {\n if (toValue(options).validateOnMount) void engine.validate('submit');\n });\n onScopeDispose(built.dispose, true);\n\n return built.form;\n}\n"],"names":["values"],"mappings":"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"}
1
+ {"version":3,"file":"UseAppForm.js","sources":["../../../../src/formsEngine/adapters/tanstack/UseAppForm.ts"],"sourcesContent":["import { createFormArrayIdentity } from '../../FormArrayIdentity';\nimport { onMounted, onScopeDispose, shallowRef, toValue, type ShallowRef } from 'vue';\n\nimport {\n revalidateLogic,\n useForm,\n type DeepKeys,\n type FormApi,\n type FormAsyncValidateOrFn,\n type FormOptions,\n type FormValidateAsyncFn,\n type VueFormApi,\n} from '@tanstack/vue-form';\n\nimport { fieldIssues } from '../../../foundation/http';\nimport { AppErrorFactory, type AppError } from '../../../foundation/results';\nimport type { ResolveValidationMessage } from '../../../foundation/validators';\n\nimport type {\n AppFieldApi,\n AppForm,\n AppFormOptions,\n AppFormOptionsSource,\n AppFormState,\n AppFormValidationOptions,\n} from '../../AppForm';\nimport { deepEqual } from '../../DeepEqual';\nimport {\n includesValidationPath,\n resolveFieldDisplay,\n submitWithFocus,\n untilFormAbort,\n validateFormScope,\n} from '../../FormOperations';\nimport { snapshotFormValues } from '../../FormSnapshot';\nimport { createFieldApi, createFieldComponent, createFormStateView, createUseFormState } from '../../FormGlue';\nimport { getPath, hasPath } from '../../Paths';\nimport {\n createOptionsMessageResolver,\n parseStandardSchema,\n formParseFailure,\n type FormParseResult,\n} from '../../SchemaValidation';\nimport { defaultMapFieldPath, resolveSubmitFailure, toSubmitError } from '../../SubmitErrors';\n\nimport { createTanstackFormOverlay, type TanstackFormOverlay, type TanstackOverlayState } from './TanstackFormOverlay';\n\n/*\n * The tanstack adapter — the facade contract over `@tanstack/vue-form` (optional peer).\n * TanStack owns values, validation scheduling, and the submit lifecycle; the overlay\n * (`TanstackFormOverlay`) owns everything the contract pins that TanStack models\n * differently — server-error merge/clearing, baseline-compared dirty, blur-or-submit\n * touched, contract array reindexing, `submitError` (see the overlay's module doc).\n *\n * Validation wiring: the whole-form Standard Schema runs as a TanStack form-level\n * `onDynamicAsync` validator under `revalidateLogic` — `validateOn` maps 1:1 onto its\n * pre-submission `mode` ('submit' default / 'blur' / 'change'), and `modeAfterSubmission:\n * 'change'` gives the pinned post-attempt change-revalidation. The validator returns\n * TanStack's global `{ form?, fields }` error shape, so client errors land in TanStack\n * field meta (created on demand — no TanStack `Field` mounts needed) and `state.isValid`\n * stays engine-native. Adapter notes (both mirror the contract's static options intent):\n * - `validateOn` is creation-pinned; schema and message values are read per run.\n * Schema presence may change through the options getter.\n * - Escape-hatch writes (`engine.setFieldValue`) bypass the overlay — server-error\n * clearing and touched semantics then follow TanStack, not the contract.\n *\n * HOW STATE IS READ. `@tanstack/vue-form` is `form-core` under a Vue host binding.\n * - The returned instance is `FormApi & VueFormApi`.\n * - TanStack's store is a `@tanstack/store` `Store`, invisible to Vue's tracker. It is bridged\n * ONCE, here, into a `shallowRef` (`bridgeStore`); every contract read then flows through\n * Vue reactivity. `form.useSelector` would do the same per slice, but it wraps its ref in\n * `readonly()`, which would hand values back through a proxy and break the identity compares\n * the reader and `deepEqual` rely on.\n * - `useForm` applies its options ONCE (Vue's `setup` runs once), so the options object must\n * stay stable: `reset()` keeps `tanstackOptions.defaultValues` in step with TanStack's own\n * copy.\n */\n\n/** The native TanStack form instance the adapter builds — what `form.engine` exposes. */\nexport type TanstackFormEngine<TValues extends object> = FormApi<\n TValues,\n undefined, // onMount\n undefined, // onChange\n undefined, // onChangeAsync\n undefined, // onBlur\n undefined, // onBlurAsync\n undefined, // onSubmit\n undefined, // onSubmitAsync\n undefined, // onDynamic\n FormAsyncValidateOrFn<TValues>, // onDynamicAsync — the adapter's schema bridge\n undefined, // onServer\n never // submitMeta\n> &\n VueFormApi<\n TValues,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n FormAsyncValidateOrFn<TValues>,\n undefined,\n never\n >;\n\ntype TanstackFormOptions<TValues extends object> = FormOptions<\n TValues,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n undefined,\n FormAsyncValidateOrFn<TValues>,\n undefined,\n never\n>;\n\nconst EmptyMessages: ReadonlyArray<string> = Object.freeze([]);\n\n/**\n * Folds the shared schema-error map into TanStack's global form error shape:\n * root-path (`''`) issues become the form-level error, the rest per-field errors.\n */\nfunction toEngineValidationError(errors: Record<string, ReadonlyArray<string>>): unknown {\n const paths = Object.keys(errors);\n if (paths.length === 0) return undefined;\n const fields: Record<string, ReadonlyArray<string>> = Object.create(null);\n let form: ReadonlyArray<string> | undefined;\n for (const path of paths) {\n if (path === '') form = errors[path];\n else fields[path] = errors[path] ?? [];\n }\n return form ? { form, fields } : { fields };\n}\n\n/**\n * Normalizes TanStack field-meta errors to plain messages. The adapter's own validator\n * yields `string[]`, but escape-hatch validators may add strings, nested arrays, or\n * Standard Schema issue objects — all are accepted.\n */\nfunction toMessages(errors: ReadonlyArray<unknown> | undefined): ReadonlyArray<string> {\n if (!errors || errors.length === 0) return EmptyMessages;\n const messages: string[] = [];\n const visit = (error: unknown): void => {\n if (error === null || error === undefined) return;\n if (typeof error === 'string') {\n messages.push(error);\n return;\n }\n if (Array.isArray(error)) {\n for (const entry of error) visit(entry);\n return;\n }\n if (typeof error === 'object' && typeof (error as { message?: unknown }).message === 'string') {\n messages.push((error as { message: string }).message);\n }\n };\n for (const error of errors) visit(error);\n return messages.length > 0 ? messages : EmptyMessages;\n}\n\n/** The per-field slice the `Field` glue reads — identity-stable while its members are unchanged. */\ninterface TanstackFieldState {\n readonly value: unknown;\n readonly errors: ReadonlyArray<string>;\n readonly isDirty: boolean;\n readonly isTouched: boolean;\n}\n\n/** The minimal structural view of TanStack form state the reader consumes (loose string paths). */\ninterface EngineStateView {\n readonly values: unknown;\n readonly isValid: boolean;\n readonly isValidating: boolean;\n readonly isFormValidating: boolean;\n readonly fieldMeta: Partial<Record<string, { readonly errors: ReadonlyArray<unknown> }>>;\n}\n\nfunction sameMessages(a: ReadonlyArray<string>, b: ReadonlyArray<string>): boolean {\n return a === b || (a.length === b.length && a.every((message, index) => message === b[index]));\n}\n\nfunction fieldStatesEqual(a: TanstackFieldState, b: TanstackFieldState): boolean {\n return (\n Object.is(a.value, b.value) &&\n a.isDirty === b.isDirty &&\n a.isTouched === b.isTouched &&\n sameMessages(a.errors, b.errors)\n );\n}\n\n/**\n * Mirrors the `@tanstack/store` store into a `shallowRef` — the ONE seam that puts TanStack\n * state inside Vue's tracker. Deliberately not `useSelector`/`useStore` from\n * `@tanstack/vue-store`: those wrap the ref in `readonly()`, which would hand every read back\n * through a deep proxy and defeat the `Object.is` identity compares the reader, `deepEqual`, and\n * TanStack's own writes all depend on.\n */\nfunction bridgeStore<TValues extends object>(engine: TanstackFormEngine<TValues>): ShallowRef<EngineStateView> {\n const snapshot = shallowRef(engine.store.state as unknown as EngineStateView);\n const subscription = engine.store.subscribe((next) => {\n snapshot.value = next as unknown as EngineStateView;\n });\n onScopeDispose(() => subscription.unsubscribe(), true);\n return snapshot;\n}\n\ninterface CombinedReader<TValues extends object> {\n readonly getFormState: () => AppFormState<TValues>;\n readonly getFieldState: (path: string) => TanstackFieldState;\n}\n\n/**\n * Derives the contract state from the (TanStack store state, overlay state) pair with\n * generation caching: snapshots are rebuilt only when either source commits, and per-path\n * field slices reuse the previous generation's identity when unchanged — so a read stays\n * referentially stable between commits. Both sources are `shallowRef`s, so every read below\n * is also the subscription.\n */\nfunction createCombinedReader<TValues extends object>(\n snapshot: ShallowRef<EngineStateView>,\n overlay: TanstackFormOverlay<TValues>,\n getValidateOn: () => AppFormOptions<TValues>['validateOn'],\n): CombinedReader<TValues> {\n let generation: { tan: EngineStateView; ov: TanstackOverlayState<TValues> } | null = null;\n let formState: AppFormState<TValues> | null = null;\n let fieldCache = new Map<string, TanstackFieldState>();\n let previousFieldCache = new Map<string, TanstackFieldState>();\n\n function currentGeneration(): { tan: EngineStateView; ov: TanstackOverlayState<TValues> } {\n const tan = snapshot.value;\n const ov = overlay.state.value;\n if (generation && generation.tan === tan && generation.ov === ov) return generation;\n generation = { tan, ov };\n formState = null;\n previousFieldCache = fieldCache;\n fieldCache = new Map();\n return generation;\n }\n\n return {\n getFormState: () => {\n const { tan, ov } = currentGeneration();\n formState ??= {\n values: tan.values as TValues,\n isDirty: !deepEqual(tan.values, ov.baseline),\n // Client validity is engine-native; the server-error overlay holds it false too.\n isValid:\n (ov.scopedErrors === null\n ? tan.isValid\n : Object.keys(ov.scopedErrors).length === 0 &&\n Object.entries(tan.fieldMeta).every(\n ([path, meta]) => includesValidationPath(path, ov.scopedFields) || !meta?.errors.length,\n )) && Object.keys(ov.serverErrors).length === 0,\n isSubmitting: ov.isSubmitting,\n // Whole-schema validation is a FORM-level validator — TanStack's derived\n // `isValidating` counts field-level validators only, so merge both flags.\n isValidating: tan.isFormValidating || tan.isValidating || ov.isScopeValidating,\n submitError: ov.submitError,\n isSubmitSuccessful: ov.isSubmitSuccessful,\n };\n return formState;\n },\n getFieldState: (path) => {\n const { tan, ov } = currentGeneration();\n const cached = fieldCache.get(path);\n if (cached) return cached;\n const value = getPath(tan.values, path);\n const { isTouched, showsClientErrors } = resolveFieldDisplay(path, ov, getValidateOn());\n // Validation is form-wide; display follows the field's own marks. Server messages always display.\n const clientMessages = !showsClientErrors\n ? EmptyMessages\n : ov.scopedErrors !== null && includesValidationPath(path, ov.scopedFields)\n ? (ov.scopedErrors[path] ?? EmptyMessages)\n : toMessages(tan.fieldMeta[path]?.errors);\n const serverMessages = ov.serverErrors[path] ?? EmptyMessages;\n const computed: TanstackFieldState = {\n value,\n // Client + server messages merged, client first (contract JSDoc).\n errors:\n serverMessages.length === 0\n ? clientMessages\n : clientMessages.length === 0\n ? serverMessages\n : [...clientMessages, ...serverMessages],\n isDirty: !deepEqual(value, getPath(ov.baseline, path)),\n isTouched,\n };\n const previous = previousFieldCache.get(path);\n const stable = previous && fieldStatesEqual(previous, computed) ? previous : computed;\n fieldCache.set(path, stable);\n return stable;\n },\n };\n}\n\ninterface AdapterPrelude<TValues extends object, TOutput> {\n readonly getOptions: () => AppFormOptions<TValues, TOutput>;\n readonly overlay: TanstackFormOverlay<TValues>;\n readonly tanstackOptions: TanstackFormOptions<TValues>;\n readonly parseValues: (values: TValues, fresh?: boolean) => Promise<FormParseResult<TOutput>>;\n /** The form's message resolver, memoized against the `messages` / `labels` option identities. */\n readonly messageResolver: () => ResolveValidationMessage;\n readonly bindValues: (read: () => TValues) => void;\n}\n\n/** Builds the overlay + the stable TanStack options (all callbacks read the latest options through `getOptions`). */\nfunction createAdapterPrelude<TValues extends object, TOutput>(\n getOptions: () => AppFormOptions<TValues, TOutput>,\n): AdapterPrelude<TValues, TOutput> {\n let readCurrentValues: (() => TValues) | null = null;\n const initialOptions = getOptions();\n const initialValues = snapshotFormValues(initialOptions.defaultValues);\n const overlay = createTanstackFormOverlay<TValues>(snapshotFormValues(initialValues));\n const messageResolver = createOptionsMessageResolver(getOptions);\n\n let cached: {\n values: TValues;\n schema: AppFormOptions<TValues, TOutput>['schema'];\n resolver: ResolveValidationMessage;\n result: Promise<FormParseResult<TOutput>>;\n } | null = null;\n const parseValues = (values: TValues, fresh = false): Promise<FormParseResult<TOutput>> => {\n const schema = getOptions().schema;\n const resolver = messageResolver();\n if (\n !fresh &&\n cached !== null &&\n deepEqual(cached.values, values) &&\n cached.schema === schema &&\n cached.resolver === resolver\n )\n return cached.result;\n const snapshot = snapshotFormValues(values);\n const result = Promise.resolve()\n .then(() =>\n schema\n ? parseStandardSchema(schema, snapshot, resolver)\n : { ok: true as const, value: snapshot as unknown as TOutput },\n )\n .catch((): FormParseResult<TOutput> =>\n formParseFailure({ '': [getOptions().fallbackErrorMessage ?? 'Validation failed'] }),\n );\n cached = { values: snapshotFormValues(values), schema, resolver, result };\n return result;\n };\n\n const tanstackOptions: TanstackFormOptions<TValues> = {\n defaultValues: initialValues,\n onSubmit: async ({ value }) => {\n // The contract's `isSubmitting` brackets ONLY the app submit call (house-identical),\n // not TanStack's validation window. Failures propagate to the adapter's\n // `handleSubmit` catch, so TanStack's own submit lifecycle stays truthful.\n overlay.setSubmitting(true);\n try {\n const parsed = await parseValues(value, true);\n if (!parsed.ok) return;\n const result = await getOptions().onSubmit(parsed.value, { signal: new AbortController().signal });\n // Reached only when validation passed AND the app submit resolved — the verdict's\n // sole success signal (the invalid path never runs this; a throw skips it).\n overlay.setSubmitSuccessful(result.ok);\n } finally {\n overlay.setSubmitting(false);\n }\n },\n };\n\n const validateWithSchema: FormValidateAsyncFn<TValues> = async ({ value, signal }) => {\n overlay.setScope(null);\n const snapshot = snapshotFormValues(value);\n const result = await untilFormAbort(parseValues(snapshot), signal, null);\n if (!result || (readCurrentValues && !deepEqual(snapshot, readCurrentValues()))) return undefined;\n return toEngineValidationError(result.ok ? {} : result.failure.fieldErrors);\n };\n tanstackOptions.validators = { onDynamicAsync: validateWithSchema };\n tanstackOptions.validationLogic = (props) =>\n revalidateLogic({\n mode:\n overlay.getState().submitCount > 0 || overlay.getState().touched.size > 0\n ? 'change'\n : (initialOptions.validateOn ?? 'submit'),\n modeAfterSubmission: 'change',\n })(props);\n\n return {\n getOptions,\n overlay,\n tanstackOptions,\n messageResolver,\n parseValues,\n bindValues: (read) => {\n readCurrentValues = read;\n },\n };\n}\n\n/** What `buildAppForm` returns — the contract surface plus the teardown the adapter's own timer needs. */\ninterface BuiltForm<TValues extends object> {\n readonly form: AppForm<TValues, TanstackFormEngine<TValues>>;\n /** Releases the pending `submitOn: 'change'` debounce timer on scope teardown. */\n readonly dispose: () => void;\n}\n\n/** Builds the stable contract surface over the TanStack engine + overlay pair. */\nfunction buildAppForm<TValues extends object, TOutput>(\n engine: TanstackFormEngine<TValues>,\n prelude: AdapterPrelude<TValues, TOutput>,\n): BuiltForm<TValues> {\n const { getOptions, overlay, tanstackOptions, messageResolver, parseValues } = prelude;\n let lifecycleEpoch = 0;\n let validationEpoch = 0;\n let focusEpoch = 0;\n let requestController = new AbortController();\n let disposed = false;\n let trailingSubmit = false;\n let submittingValues: TValues | null = null;\n const reader = createCombinedReader(bridgeStore(engine), overlay, () => getOptions().validateOn);\n const identity = createFormArrayIdentity(() => engine.store.state.values);\n\n // ── Submit path shared by `handleSubmit` + auto-submit (validate → onSubmit → map failure) ─────\n /** Resolves a thrown submit failure onto the overlay (matched paths → fields, remainder → banner). */\n function applySubmitFailure(error: AppError, submittedValues = engine.store.state.values): void {\n const options = getOptions();\n const values = engine.store.state.values;\n overlay.applySubmitFailure(\n resolveSubmitFailure(\n error,\n options.mapSubmitError ?? fieldIssues,\n options.mapFieldPath ?? defaultMapFieldPath,\n (path) => hasPath(submittedValues, path) && deepEqual(getPath(submittedValues, path), getPath(values, path)),\n options.fallbackErrorMessage,\n messageResolver(),\n ),\n );\n }\n\n async function performSubmit(values: TValues): Promise<boolean> {\n if (disposed || getOptions().isDisabled) return false;\n const epoch = lifecycleEpoch;\n const signal = requestController.signal;\n const isCurrent = (): boolean => !disposed && epoch === lifecycleEpoch;\n validationEpoch += 1;\n overlay.setScope(null);\n overlay.beginSubmitAttempt();\n // The facade owns submission snapshots; TanStack still owns field validation and metadata.\n // Its validator reuses this parse, so transforming/async schemas run once for this input.\n const parsing = parseValues(values, true);\n await engine.validate('submit');\n const parsed = await parsing;\n if (!isCurrent()) return false;\n if (!parsed.ok) {\n overlay.setSubmitSuccessful(false);\n return false;\n }\n overlay.setSubmitting(true);\n let successful = false;\n try {\n const result = await untilFormAbort(getOptions().onSubmit(parsed.value, { signal }), signal, {\n ok: false,\n failure: AppErrorFactory.cancelled(),\n });\n successful = result.ok;\n if (isCurrent() && result.ok) overlay.setBaseline(values);\n else if (isCurrent() && !result.ok) applySubmitFailure(result.failure, values);\n } catch (error) {\n if (isCurrent()) applySubmitFailure(toSubmitError(error, getOptions().fallbackErrorMessage), values);\n } finally {\n if (isCurrent()) overlay.setSubmitting(false);\n if (isCurrent()) overlay.setSubmitSuccessful(successful);\n }\n return successful && isCurrent();\n }\n\n /** Serializes submissions and coalesces newer edits into one trailing snapshot. */\n let inFlight: Promise<boolean> | null = null;\n async function guardedSubmit(): Promise<boolean> {\n if (disposed) return false;\n if (inFlight) {\n if (!deepEqual(engine.store.state.values, submittingValues)) trailingSubmit = true;\n return inFlight;\n }\n const run = async (): Promise<boolean> => {\n let successful = false;\n do {\n trailingSubmit = false;\n submittingValues = snapshotFormValues(engine.store.state.values);\n successful = await untilFormAbort(performSubmit(submittingValues), requestController.signal, false);\n } while (\n !disposed &&\n trailingSubmit &&\n !deepEqual(engine.store.state.values, submittingValues) &&\n !deepEqual(engine.store.state.values, overlay.getState().baseline)\n );\n return successful;\n };\n inFlight = run();\n try {\n return await inFlight;\n } finally {\n inFlight = null;\n submittingValues = null;\n }\n }\n\n /** Validate without submitting — marks touched, runs the whole-form schema, resolves client validity. */\n async function validate(options?: AppFormValidationOptions<TValues>): Promise<boolean> {\n if (disposed) return false;\n const epoch = ++validationEpoch;\n const lifecycle = lifecycleEpoch;\n if (options) {\n for (const meta of Object.values(engine.state.validationMetaMap)) meta?.lastAbortController.abort();\n const values = snapshotFormValues(engine.store.state.values);\n for (const path of options.fields ?? Object.keys(values)) overlay.markBlurred(path);\n overlay.setScopeValidating(true);\n const errors = await untilFormAbort(\n validateFormScope(\n values,\n options,\n getOptions().schema,\n messageResolver(),\n getOptions().fallbackErrorMessage ?? 'Validation failed',\n ),\n requestController.signal,\n {},\n );\n if (disposed || epoch !== validationEpoch || lifecycle !== lifecycleEpoch) return false;\n overlay.setScopeValidating(false);\n if (!deepEqual(values, engine.store.state.values)) return false;\n const previous = overlay.getState();\n const retained = Object.fromEntries(\n Object.entries(previous.scopedErrors ?? {}).filter(([path]) => !includesValidationPath(path, options.fields)),\n );\n const fields =\n options.fields &&\n (previous.scopedErrors === null\n ? options.fields\n : previous.scopedFields && [...previous.scopedFields, ...options.fields]);\n overlay.setScope({ ...retained, ...errors }, fields);\n return Object.keys(errors).length === 0;\n }\n overlay.setScope(null);\n overlay.touchAll();\n const values = snapshotFormValues(engine.store.state.values);\n const parsing = parseValues(values, true);\n const result = await untilFormAbort(\n Promise.all([engine.validate('submit'), parsing]),\n requestController.signal,\n null,\n );\n return (\n !disposed &&\n lifecycle === lifecycleEpoch &&\n epoch === validationEpoch &&\n result !== null &&\n result[1].ok &&\n deepEqual(values, engine.store.state.values)\n );\n }\n\n // ── Auto-submit (`submitOn`) — routes through the SAME `guardedSubmit` as manual submit ────────\n let autoSubmitTimer: ReturnType<typeof setTimeout> | null = null;\n const clearAutoSubmitTimer = (): void => {\n if (autoSubmitTimer !== null) {\n clearTimeout(autoSubmitTimer);\n autoSubmitTimer = null;\n }\n };\n const scheduleAutoSubmit = (): void => {\n if ((getOptions().submitOn ?? 'manual') !== 'change') return;\n clearAutoSubmitTimer();\n const delay = getOptions().submitDebounceMs ?? 0;\n autoSubmitTimer = setTimeout(() => {\n autoSubmitTimer = null;\n void guardedSubmit();\n }, delay);\n };\n const autoSubmitOnBlur = (): void => {\n if ((getOptions().submitOn ?? 'manual') === 'blur') void guardedSubmit();\n };\n\n // One API object per path — memoized, so the identity a slot payload sees is stable.\n const fieldApis = new Map<string, AppFieldApi<unknown>>();\n const fieldOps = {\n getState: (path: string) => reader.getFieldState(path),\n setValue: (path: string, value: unknown) => {\n // Server messages clear on the next change to the field (contract JSDoc).\n overlay.clearServerErrorsAt(path);\n overlay.markChanged(path);\n // Triggers TanStack 'change'-cause validation, gated by `revalidateLogic`.\n engine.setFieldValue(path as DeepKeys<TValues>, snapshotFormValues(value) as never);\n identity.replace(path);\n // `submitOn: 'change'` — a user-origin write schedules the debounced auto-submit.\n scheduleAutoSubmit();\n },\n blur: (path: string) => {\n overlay.markBlurred(path);\n // 'blur'-cause validation — runs the schema only in `validateOn: 'blur'` mode.\n void engine.validateField(path as DeepKeys<TValues>, 'blur');\n // `submitOn: 'blur'` — save-on-blur.\n autoSubmitOnBlur();\n },\n };\n const getFieldApi = (path: string): AppFieldApi<unknown> => {\n const existing = fieldApis.get(path);\n if (existing) return existing;\n const api = createFieldApi(path, fieldOps);\n fieldApis.set(path, api);\n return api;\n };\n\n const arrayOperation = (path: string, operation: Parameters<typeof overlay.remapForArrayOperation>[1]): void => {\n // TanStack's array ops are constrained to its typed array paths (`DeepKeysOfType`); the\n // contract's paths are loose strings, so the vendor's path algebra is opted out of with\n // `never` rather than reimplemented here.\n identity.operation(path, operation, () => {\n const field = path as never;\n switch (operation.kind) {\n case 'push':\n engine.pushFieldValue(field, snapshotFormValues(operation.value) as never);\n break;\n case 'insert':\n void engine.insertFieldValue(field, operation.index, snapshotFormValues(operation.value) as never);\n break;\n case 'remove':\n void engine.removeFieldValue(field, operation.index);\n break;\n case 'swap':\n engine.swapFieldValues(field, operation.indexA, operation.indexB);\n break;\n case 'move':\n engine.moveFieldValues(field, operation.fromIndex, operation.toIndex);\n break;\n }\n // Contract reindexing for the overlay: row-scoped server errors + touched marks\n // follow their rows. TanStack shifts its OWN field meta by its rules; where they\n // differ, the contract wins because errors/touched surface from the overlay and\n // client errors are recomputed by the op's change-revalidation.\n overlay.markChanged(path);\n overlay.remapForArrayOperation(path, operation);\n });\n scheduleAutoSubmit();\n };\n\n function invalidateWork(): void {\n lifecycleEpoch += 1;\n validationEpoch += 1;\n focusEpoch += 1;\n requestController.abort();\n requestController = new AbortController();\n for (const meta of Object.values(engine.state.validationMetaMap)) meta?.lastAbortController.abort();\n engine.baseStore.setState((previous) => ({ ...previous, isFormValidating: false }));\n overlay.setSubmitting(false);\n overlay.setScopeValidating(false);\n trailingSubmit = false;\n clearAutoSubmitTimer();\n }\n\n const state = createFormStateView<TValues>(reader.getFormState);\n\n const form: AppForm<TValues, TanstackFormEngine<TValues>> = {\n Field: createFieldComponent<TValues>(getFieldApi, () => getOptions().isDisabled ?? false),\n state,\n // The same computed `state.values` reads — `form.values` is a shorthand, never a second source.\n get values() {\n return state.values;\n },\n useFormState: createUseFormState<TValues>(reader.getFormState),\n handleSubmit: async (event?: Event) => {\n const epoch = ++focusEpoch;\n return submitWithFocus(guardedSubmit, () => epoch === focusEpoch, event, getOptions().focusRoot?.());\n },\n validate,\n cancelSubmit: () => {\n invalidateWork();\n overlay.applySubmitFailure({ fieldErrors: {}, submitError: AppErrorFactory.cancelled() });\n overlay.setSubmitSuccessful(false);\n },\n invalidateSession: (next) => form.reset(next),\n setValue: (path, value) => {\n // Server messages clear on the next change to the field (contract JSDoc) — mirror the\n // in-field `setValue`; TanStack's 'change'-cause validation runs under `revalidateLogic`.\n overlay.clearServerErrorsAt(path);\n overlay.markChanged(path);\n engine.setFieldValue(path as DeepKeys<TValues>, snapshotFormValues(value) as never);\n identity.replace(path);\n scheduleAutoSubmit();\n },\n array: (path: string) => ({\n get keys() {\n return identity.keys(path);\n },\n push: (value: unknown) => arrayOperation(path, { kind: 'push', value }),\n insert: (index: number, value: unknown) => arrayOperation(path, { kind: 'insert', index, value }),\n remove: (index: number) => arrayOperation(path, { kind: 'remove', index }),\n swap: (indexA: number, indexB: number) => arrayOperation(path, { kind: 'swap', indexA, indexB }),\n move: (fromIndex: number, toIndex: number) => arrayOperation(path, { kind: 'move', fromIndex, toIndex }),\n }),\n reset: (next?: TValues) => {\n invalidateWork();\n const values = snapshotFormValues(next ?? overlay.getState().baseline);\n // Keep the options object TanStack was created with in sync: its own `reset(values)`\n // rewrites `options.defaultValues`, and any later `update()` would otherwise clobber the\n // re-seeded values back from the stale copy.\n tanstackOptions.defaultValues = values;\n overlay.reset(snapshotFormValues(values));\n engine.reset(values);\n identity.reset();\n clearAutoSubmitTimer(); // a reset/prefill never auto-submits — drop any pending trailing submit\n },\n setFieldErrors: (errors: Record<string, ReadonlyArray<string>>) => overlay.replaceServerErrors(errors),\n clearSubmitError: () => overlay.clearSubmitError(),\n engine,\n };\n\n return {\n form,\n dispose: () => {\n invalidateWork();\n disposed = true;\n },\n };\n}\n\n/**\n * The tanstack adapter's `useAppForm` — the facade contract over `@tanstack/vue-form`.\n * The returned form object is stable for the owning scope's lifetime and every state member on\n * it is a live getter, so `form.values.title` / `form.state.isSubmitting` read in a template ARE\n * the subscription; `form.engine` exposes the native {@link TanstackFormEngine} (the 90/10\n * escape hatch — typed here, `unknown` on the shared contract), including TanStack's typed\n * deep-path `Field`/`Subscribe` and per-field validator graph.\n *\n * Call it in `setup()`: `useForm` registers an `onMounted` of its own, and the store bridge +\n * the pending `submitOn: 'change'` timer release on scope teardown.\n */\nexport function useAppForm<TValues extends object, TOutput = TValues>(\n options: AppFormOptionsSource<TValues, TOutput>,\n): AppForm<TValues, TanstackFormEngine<TValues>> {\n const prelude = createAdapterPrelude<TValues, TOutput>(() => toValue(options));\n const engine = useForm(prelude.tanstackOptions) as TanstackFormEngine<TValues>;\n prelude.bindValues(() => engine.store.state.values);\n const built = buildAppForm<TValues, TOutput>(engine, prelude);\n\n // Validate once on mount when flagged — seeds `isValid` / field errors WITHOUT marking touched\n // (the mount pass shows validity without asserting the user interacted).\n onMounted(() => {\n if (toValue(options).validateOnMount) void engine.validate('submit');\n });\n onScopeDispose(built.dispose, true);\n\n return built.form;\n}\n"],"names":["values"],"mappings":"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"}
@@ -76,10 +76,10 @@ export declare const AnimatedLayout: import('vue').DefineComponent<import('vue')
76
76
  };
77
77
  }>> & Readonly<{}>, {
78
78
  enabled: boolean;
79
- isEnabled: boolean;
80
- reducedMotion: boolean | undefined;
81
- duration: number;
82
79
  easing: string;
80
+ duration: number;
81
+ reducedMotion: boolean | undefined;
82
+ isEnabled: boolean;
83
83
  }, SlotsType<{
84
84
  default?: () => VNode[];
85
85
  }>, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Marks an element that script focuses without it being a control — a page's `main` after a route change, a
3
+ * heading, a region that holds focus while its content swaps. The base styles (`index.css`) draw no focus ring on
4
+ * a marked element: a ring around a whole page or card points at nothing the reader can operate, and a screen
5
+ * reader still lands on it and reads it.
6
+ */
7
+ export declare const FocusTargetAttribute = "data-focus-target";
8
+ /**
9
+ * Focuses `element` as a programmatic focus target: gives it `tabindex="-1"` when it has no tabindex of its own
10
+ * (focusable by script, never a Tab stop), marks it with {@link FocusTargetAttribute} and focuses it without
11
+ * scrolling. Returns whether the element now holds focus.
12
+ */
13
+ export declare function focusTarget(element: HTMLElement): boolean;
@@ -0,0 +1,12 @@
1
+ const FocusTargetAttribute = "data-focus-target";
2
+ function focusTarget(element) {
3
+ if (!element.hasAttribute("tabindex")) element.tabIndex = -1;
4
+ element.setAttribute(FocusTargetAttribute, "");
5
+ element.focus({ preventScroll: true });
6
+ return element.ownerDocument.activeElement === element;
7
+ }
8
+ export {
9
+ FocusTargetAttribute,
10
+ focusTarget
11
+ };
12
+ //# sourceMappingURL=FocusTarget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FocusTarget.js","sources":["../../../src/foundation/dom/FocusTarget.ts"],"sourcesContent":["/**\n * Marks an element that script focuses without it being a control — a page's `main` after a route change, a\n * heading, a region that holds focus while its content swaps. The base styles (`index.css`) draw no focus ring on\n * a marked element: a ring around a whole page or card points at nothing the reader can operate, and a screen\n * reader still lands on it and reads it.\n */\nexport const FocusTargetAttribute = 'data-focus-target';\n\n/**\n * Focuses `element` as a programmatic focus target: gives it `tabindex=\"-1\"` when it has no tabindex of its own\n * (focusable by script, never a Tab stop), marks it with {@link FocusTargetAttribute} and focuses it without\n * scrolling. Returns whether the element now holds focus.\n */\nexport function focusTarget(element: HTMLElement): boolean {\n if (!element.hasAttribute('tabindex')) element.tabIndex = -1;\n element.setAttribute(FocusTargetAttribute, '');\n element.focus({ preventScroll: true });\n return element.ownerDocument.activeElement === element;\n}\n"],"names":[],"mappings":"AAMO,MAAM,uBAAuB;AAO7B,SAAS,YAAY,SAA+B;AACzD,MAAI,CAAC,QAAQ,aAAa,UAAU,WAAW,WAAW;AAC1D,UAAQ,aAAa,sBAAsB,EAAE;AAC7C,UAAQ,MAAM,EAAE,eAAe,KAAA,CAAM;AACrC,SAAO,QAAQ,cAAc,kBAAkB;AACjD;"}
@@ -17,3 +17,4 @@ export * from './hooks/UseScrollActivity';
17
17
  export { DomOrderExtensions } from './DomOrderExtensions';
18
18
  export { resolveElement } from './ResolveElement';
19
19
  export { ScrollRegionAttribute, findScrollRegions } from './ScrollRegion';
20
+ export { FocusTargetAttribute, focusTarget } from './FocusTarget';
@@ -16,6 +16,7 @@ import { ScrollIdleDelay, ScrollingAttribute, useScrollActivity } from "./hooks/
16
16
  import { DomOrderExtensions } from "./DomOrderExtensions.js";
17
17
  import { resolveElement } from "./ResolveElement.js";
18
18
  import { ScrollRegionAttribute, findScrollRegions } from "./ScrollRegion.js";
19
+ import { FocusTargetAttribute, focusTarget } from "./FocusTarget.js";
19
20
  export {
20
21
  AriaAttribute,
21
22
  AttributeValue,
@@ -23,6 +24,7 @@ export {
23
24
  DomEvent,
24
25
  DomOrderExtensions,
25
26
  ElementTag,
27
+ FocusTargetAttribute,
26
28
  HtmlElement,
27
29
  Key,
28
30
  PressExtensions,
@@ -33,6 +35,7 @@ export {
33
35
  composeEventHandlers,
34
36
  dataAttr,
35
37
  findScrollRegions,
38
+ focusTarget,
36
39
  resolveElement,
37
40
  useEventListener,
38
41
  useFocusTrap,
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
@@ -0,0 +1,13 @@
1
+ /** Represents one selectable dialling country. */
2
+ export interface PhoneCountry {
3
+ /** The ISO 3166-1 alpha-2 code. */
4
+ readonly iso: string;
5
+ /** The English display name. */
6
+ readonly name: string;
7
+ /** The E.164 country calling code, leading `+` included. */
8
+ readonly dial: string;
9
+ /** The flag emoji. */
10
+ readonly flag: string;
11
+ }
12
+ /** Lists the known dialling countries in display order. */
13
+ export declare const PhoneCountries: ReadonlyArray<PhoneCountry>;
@@ -0,0 +1,62 @@
1
+ const PhoneCountries = Object.freeze([
2
+ { iso: "US", name: "United States", dial: "+1", flag: "🇺🇸" },
3
+ { iso: "CA", name: "Canada", dial: "+1", flag: "🇨🇦" },
4
+ { iso: "GB", name: "United Kingdom", dial: "+44", flag: "🇬🇧" },
5
+ { iso: "AU", name: "Australia", dial: "+61", flag: "🇦🇺" },
6
+ { iso: "DE", name: "Germany", dial: "+49", flag: "🇩🇪" },
7
+ { iso: "FR", name: "France", dial: "+33", flag: "🇫🇷" },
8
+ { iso: "ES", name: "Spain", dial: "+34", flag: "🇪🇸" },
9
+ { iso: "IT", name: "Italy", dial: "+39", flag: "🇮🇹" },
10
+ { iso: "NL", name: "Netherlands", dial: "+31", flag: "🇳🇱" },
11
+ { iso: "BE", name: "Belgium", dial: "+32", flag: "🇧🇪" },
12
+ { iso: "CH", name: "Switzerland", dial: "+41", flag: "🇨🇭" },
13
+ { iso: "AT", name: "Austria", dial: "+43", flag: "🇦🇹" },
14
+ { iso: "SE", name: "Sweden", dial: "+46", flag: "🇸🇪" },
15
+ { iso: "NO", name: "Norway", dial: "+47", flag: "🇳🇴" },
16
+ { iso: "DK", name: "Denmark", dial: "+45", flag: "🇩🇰" },
17
+ { iso: "FI", name: "Finland", dial: "+358", flag: "🇫🇮" },
18
+ { iso: "IE", name: "Ireland", dial: "+353", flag: "🇮🇪" },
19
+ { iso: "PT", name: "Portugal", dial: "+351", flag: "🇵🇹" },
20
+ { iso: "PL", name: "Poland", dial: "+48", flag: "🇵🇱" },
21
+ { iso: "CZ", name: "Czechia", dial: "+420", flag: "🇨🇿" },
22
+ { iso: "GR", name: "Greece", dial: "+30", flag: "🇬🇷" },
23
+ { iso: "TR", name: "Türkiye", dial: "+90", flag: "🇹🇷" },
24
+ { iso: "RU", name: "Russia", dial: "+7", flag: "🇷🇺" },
25
+ { iso: "UA", name: "Ukraine", dial: "+380", flag: "🇺🇦" },
26
+ { iso: "UZ", name: "Uzbekistan", dial: "+998", flag: "🇺🇿" },
27
+ { iso: "KZ", name: "Kazakhstan", dial: "+7", flag: "🇰🇿" },
28
+ { iso: "KG", name: "Kyrgyzstan", dial: "+996", flag: "🇰🇬" },
29
+ { iso: "TJ", name: "Tajikistan", dial: "+992", flag: "🇹🇯" },
30
+ { iso: "TM", name: "Turkmenistan", dial: "+993", flag: "🇹🇲" },
31
+ { iso: "IL", name: "Israel", dial: "+972", flag: "🇮🇱" },
32
+ { iso: "AE", name: "UAE", dial: "+971", flag: "🇦🇪" },
33
+ { iso: "SA", name: "Saudi Arabia", dial: "+966", flag: "🇸🇦" },
34
+ { iso: "EG", name: "Egypt", dial: "+20", flag: "🇪🇬" },
35
+ { iso: "ZA", name: "South Africa", dial: "+27", flag: "🇿🇦" },
36
+ { iso: "NG", name: "Nigeria", dial: "+234", flag: "🇳🇬" },
37
+ { iso: "KE", name: "Kenya", dial: "+254", flag: "🇰🇪" },
38
+ { iso: "IN", name: "India", dial: "+91", flag: "🇮🇳" },
39
+ { iso: "PK", name: "Pakistan", dial: "+92", flag: "🇵🇰" },
40
+ { iso: "BD", name: "Bangladesh", dial: "+880", flag: "🇧🇩" },
41
+ { iso: "SG", name: "Singapore", dial: "+65", flag: "🇸🇬" },
42
+ { iso: "MY", name: "Malaysia", dial: "+60", flag: "🇲🇾" },
43
+ { iso: "TH", name: "Thailand", dial: "+66", flag: "🇹🇭" },
44
+ { iso: "VN", name: "Vietnam", dial: "+84", flag: "🇻🇳" },
45
+ { iso: "PH", name: "Philippines", dial: "+63", flag: "🇵🇭" },
46
+ { iso: "ID", name: "Indonesia", dial: "+62", flag: "🇮🇩" },
47
+ { iso: "JP", name: "Japan", dial: "+81", flag: "🇯🇵" },
48
+ { iso: "KR", name: "South Korea", dial: "+82", flag: "🇰🇷" },
49
+ { iso: "CN", name: "China", dial: "+86", flag: "🇨🇳" },
50
+ { iso: "HK", name: "Hong Kong", dial: "+852", flag: "🇭🇰" },
51
+ { iso: "TW", name: "Taiwan", dial: "+886", flag: "🇹🇼" },
52
+ { iso: "NZ", name: "New Zealand", dial: "+64", flag: "🇳🇿" },
53
+ { iso: "BR", name: "Brazil", dial: "+55", flag: "🇧🇷" },
54
+ { iso: "AR", name: "Argentina", dial: "+54", flag: "🇦🇷" },
55
+ { iso: "CL", name: "Chile", dial: "+56", flag: "🇨🇱" },
56
+ { iso: "CO", name: "Colombia", dial: "+57", flag: "🇨🇴" },
57
+ { iso: "MX", name: "Mexico", dial: "+52", flag: "🇲🇽" }
58
+ ]);
59
+ export {
60
+ PhoneCountries
61
+ };
62
+ //# sourceMappingURL=PhoneCountries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PhoneCountries.js","sources":["../../../src/foundation/phone/PhoneCountries.ts"],"sourcesContent":["/** Represents one selectable dialling country. */\nexport interface PhoneCountry {\n /** The ISO 3166-1 alpha-2 code. */\n readonly iso: string;\n /** The English display name. */\n readonly name: string;\n /** The E.164 country calling code, leading `+` included. */\n readonly dial: string;\n /** The flag emoji. */\n readonly flag: string;\n}\n\n/*\n * E.164 calling codes are prefix-free, so the longest dial code a value starts with names its country. A shared code\n * (`+1` for the US and Canada, `+7` for Russia and Kazakhstan) reads as the earlier country in this list.\n */\n/** Lists the known dialling countries in display order. */\nexport const PhoneCountries: ReadonlyArray<PhoneCountry> = Object.freeze([\n { iso: 'US', name: 'United States', dial: '+1', flag: '🇺🇸' },\n { iso: 'CA', name: 'Canada', dial: '+1', flag: '🇨🇦' },\n { iso: 'GB', name: 'United Kingdom', dial: '+44', flag: '🇬🇧' },\n { iso: 'AU', name: 'Australia', dial: '+61', flag: '🇦🇺' },\n { iso: 'DE', name: 'Germany', dial: '+49', flag: '🇩🇪' },\n { iso: 'FR', name: 'France', dial: '+33', flag: '🇫🇷' },\n { iso: 'ES', name: 'Spain', dial: '+34', flag: '🇪🇸' },\n { iso: 'IT', name: 'Italy', dial: '+39', flag: '🇮🇹' },\n { iso: 'NL', name: 'Netherlands', dial: '+31', flag: '🇳🇱' },\n { iso: 'BE', name: 'Belgium', dial: '+32', flag: '🇧🇪' },\n { iso: 'CH', name: 'Switzerland', dial: '+41', flag: '🇨🇭' },\n { iso: 'AT', name: 'Austria', dial: '+43', flag: '🇦🇹' },\n { iso: 'SE', name: 'Sweden', dial: '+46', flag: '🇸🇪' },\n { iso: 'NO', name: 'Norway', dial: '+47', flag: '🇳🇴' },\n { iso: 'DK', name: 'Denmark', dial: '+45', flag: '🇩🇰' },\n { iso: 'FI', name: 'Finland', dial: '+358', flag: '🇫🇮' },\n { iso: 'IE', name: 'Ireland', dial: '+353', flag: '🇮🇪' },\n { iso: 'PT', name: 'Portugal', dial: '+351', flag: '🇵🇹' },\n { iso: 'PL', name: 'Poland', dial: '+48', flag: '🇵🇱' },\n { iso: 'CZ', name: 'Czechia', dial: '+420', flag: '🇨🇿' },\n { iso: 'GR', name: 'Greece', dial: '+30', flag: '🇬🇷' },\n { iso: 'TR', name: 'Türkiye', dial: '+90', flag: '🇹🇷' },\n { iso: 'RU', name: 'Russia', dial: '+7', flag: '🇷🇺' },\n { iso: 'UA', name: 'Ukraine', dial: '+380', flag: '🇺🇦' },\n { iso: 'UZ', name: 'Uzbekistan', dial: '+998', flag: '🇺🇿' },\n { iso: 'KZ', name: 'Kazakhstan', dial: '+7', flag: '🇰🇿' },\n { iso: 'KG', name: 'Kyrgyzstan', dial: '+996', flag: '🇰🇬' },\n { iso: 'TJ', name: 'Tajikistan', dial: '+992', flag: '🇹🇯' },\n { iso: 'TM', name: 'Turkmenistan', dial: '+993', flag: '🇹🇲' },\n { iso: 'IL', name: 'Israel', dial: '+972', flag: '🇮🇱' },\n { iso: 'AE', name: 'UAE', dial: '+971', flag: '🇦🇪' },\n { iso: 'SA', name: 'Saudi Arabia', dial: '+966', flag: '🇸🇦' },\n { iso: 'EG', name: 'Egypt', dial: '+20', flag: '🇪🇬' },\n { iso: 'ZA', name: 'South Africa', dial: '+27', flag: '🇿🇦' },\n { iso: 'NG', name: 'Nigeria', dial: '+234', flag: '🇳🇬' },\n { iso: 'KE', name: 'Kenya', dial: '+254', flag: '🇰🇪' },\n { iso: 'IN', name: 'India', dial: '+91', flag: '🇮🇳' },\n { iso: 'PK', name: 'Pakistan', dial: '+92', flag: '🇵🇰' },\n { iso: 'BD', name: 'Bangladesh', dial: '+880', flag: '🇧🇩' },\n { iso: 'SG', name: 'Singapore', dial: '+65', flag: '🇸🇬' },\n { iso: 'MY', name: 'Malaysia', dial: '+60', flag: '🇲🇾' },\n { iso: 'TH', name: 'Thailand', dial: '+66', flag: '🇹🇭' },\n { iso: 'VN', name: 'Vietnam', dial: '+84', flag: '🇻🇳' },\n { iso: 'PH', name: 'Philippines', dial: '+63', flag: '🇵🇭' },\n { iso: 'ID', name: 'Indonesia', dial: '+62', flag: '🇮🇩' },\n { iso: 'JP', name: 'Japan', dial: '+81', flag: '🇯🇵' },\n { iso: 'KR', name: 'South Korea', dial: '+82', flag: '🇰🇷' },\n { iso: 'CN', name: 'China', dial: '+86', flag: '🇨🇳' },\n { iso: 'HK', name: 'Hong Kong', dial: '+852', flag: '🇭🇰' },\n { iso: 'TW', name: 'Taiwan', dial: '+886', flag: '🇹🇼' },\n { iso: 'NZ', name: 'New Zealand', dial: '+64', flag: '🇳🇿' },\n { iso: 'BR', name: 'Brazil', dial: '+55', flag: '🇧🇷' },\n { iso: 'AR', name: 'Argentina', dial: '+54', flag: '🇦🇷' },\n { iso: 'CL', name: 'Chile', dial: '+56', flag: '🇨🇱' },\n { iso: 'CO', name: 'Colombia', dial: '+57', flag: '🇨🇴' },\n { iso: 'MX', name: 'Mexico', dial: '+52', flag: '🇲🇽' },\n]);\n"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /** Describes how one country's national number displays and how many digits it holds. */
2
+ export interface PhoneFormat {
3
+ /**
4
+ * The display mask: each `X` takes one national digit, and any other character is a separator shown only once a
5
+ * digit follows it (`XX-XXX-XX-XX` shows `99-663`, never `99-663-`).
6
+ */
7
+ readonly mask: string;
8
+ /** The national significant number's digit count: the dial code and any trunk prefix excluded. */
9
+ readonly length: number;
10
+ }
11
+ /** Maps an ISO 3166-1 alpha-2 code to its national-number format. */
12
+ export declare const PhoneFormats: Readonly<Record<string, PhoneFormat>>;
@@ -0,0 +1,32 @@
1
+ const PhoneFormats = Object.freeze({
2
+ US: { mask: "(XXX) XXX-XXXX", length: 10 },
3
+ CA: { mask: "(XXX) XXX-XXXX", length: 10 },
4
+ AU: { mask: "XXX XXX XXX", length: 9 },
5
+ FR: { mask: "X XX XX XX XX", length: 9 },
6
+ ES: { mask: "XXX XX XX XX", length: 9 },
7
+ CH: { mask: "XX XXX XX XX", length: 9 },
8
+ NO: { mask: "XXX XX XXX", length: 8 },
9
+ DK: { mask: "XX XX XX XX", length: 8 },
10
+ PT: { mask: "XXX XXX XXX", length: 9 },
11
+ PL: { mask: "XXX XXX XXX", length: 9 },
12
+ CZ: { mask: "XXX XXX XXX", length: 9 },
13
+ GR: { mask: "XXX XXX XXXX", length: 10 },
14
+ TR: { mask: "(XXX) XXX XX XX", length: 10 },
15
+ RU: { mask: "(XXX) XXX-XX-XX", length: 10 },
16
+ UA: { mask: "XX XXX XX XX", length: 9 },
17
+ UZ: { mask: "XX-XXX-XX-XX", length: 9 },
18
+ KZ: { mask: "(XXX) XXX-XX-XX", length: 10 },
19
+ KG: { mask: "XXX XXX XXX", length: 9 },
20
+ ZA: { mask: "XX XXX XXXX", length: 9 },
21
+ KE: { mask: "XXX XXX XXX", length: 9 },
22
+ IN: { mask: "XXXXX XXXXX", length: 10 },
23
+ SG: { mask: "XXXX XXXX", length: 8 },
24
+ HK: { mask: "XXXX XXXX", length: 8 },
25
+ CL: { mask: "X XXXX XXXX", length: 9 },
26
+ CO: { mask: "XXX XXX XXXX", length: 10 },
27
+ MX: { mask: "XX XXXX XXXX", length: 10 }
28
+ });
29
+ export {
30
+ PhoneFormats
31
+ };
32
+ //# sourceMappingURL=PhoneFormats.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PhoneFormats.js","sources":["../../../src/foundation/phone/PhoneFormats.ts"],"sourcesContent":["/** Describes how one country's national number displays and how many digits it holds. */\nexport interface PhoneFormat {\n /**\n * The display mask: each `X` takes one national digit, and any other character is a separator shown only once a\n * digit follows it (`XX-XXX-XX-XX` shows `99-663`, never `99-663-`).\n */\n readonly mask: string;\n /** The national significant number's digit count: the dial code and any trunk prefix excluded. */\n readonly length: number;\n}\n\n/*\n * Only fixed-length numbering plans are listed, and only where the length and the common grouping are certain. A\n * country absent here (Germany, the UK, Italy, …) has national numbers of several lengths: it displays plain\n * three-digit groups and validates against the E.164 bound alone.\n */\n/** Maps an ISO 3166-1 alpha-2 code to its national-number format. */\nexport const PhoneFormats: Readonly<Record<string, PhoneFormat>> = Object.freeze({\n US: { mask: '(XXX) XXX-XXXX', length: 10 },\n CA: { mask: '(XXX) XXX-XXXX', length: 10 },\n AU: { mask: 'XXX XXX XXX', length: 9 },\n FR: { mask: 'X XX XX XX XX', length: 9 },\n ES: { mask: 'XXX XX XX XX', length: 9 },\n CH: { mask: 'XX XXX XX XX', length: 9 },\n NO: { mask: 'XXX XX XXX', length: 8 },\n DK: { mask: 'XX XX XX XX', length: 8 },\n PT: { mask: 'XXX XXX XXX', length: 9 },\n PL: { mask: 'XXX XXX XXX', length: 9 },\n CZ: { mask: 'XXX XXX XXX', length: 9 },\n GR: { mask: 'XXX XXX XXXX', length: 10 },\n TR: { mask: '(XXX) XXX XX XX', length: 10 },\n RU: { mask: '(XXX) XXX-XX-XX', length: 10 },\n UA: { mask: 'XX XXX XX XX', length: 9 },\n UZ: { mask: 'XX-XXX-XX-XX', length: 9 },\n KZ: { mask: '(XXX) XXX-XX-XX', length: 10 },\n KG: { mask: 'XXX XXX XXX', length: 9 },\n ZA: { mask: 'XX XXX XXXX', length: 9 },\n KE: { mask: 'XXX XXX XXX', length: 9 },\n IN: { mask: 'XXXXX XXXXX', length: 10 },\n SG: { mask: 'XXXX XXXX', length: 8 },\n HK: { mask: 'XXXX XXXX', length: 8 },\n CL: { mask: 'X XXXX XXXX', length: 9 },\n CO: { mask: 'XXX XXX XXXX', length: 10 },\n MX: { mask: 'XX XXXX XXXX', length: 10 },\n});\n"],"names":[],"mappings":"AAiBO,MAAM,eAAsD,OAAO,OAAO;AAAA,EAC/E,IAAI,EAAE,MAAM,kBAAkB,QAAQ,GAAA;AAAA,EACtC,IAAI,EAAE,MAAM,kBAAkB,QAAQ,GAAA;AAAA,EACtC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,iBAAiB,QAAQ,EAAA;AAAA,EACrC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,EAAA;AAAA,EACpC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,EAAA;AAAA,EACpC,IAAI,EAAE,MAAM,cAAc,QAAQ,EAAA;AAAA,EAClC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,GAAA;AAAA,EACpC,IAAI,EAAE,MAAM,mBAAmB,QAAQ,GAAA;AAAA,EACvC,IAAI,EAAE,MAAM,mBAAmB,QAAQ,GAAA;AAAA,EACvC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,EAAA;AAAA,EACpC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,EAAA;AAAA,EACpC,IAAI,EAAE,MAAM,mBAAmB,QAAQ,GAAA;AAAA,EACvC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,eAAe,QAAQ,GAAA;AAAA,EACnC,IAAI,EAAE,MAAM,aAAa,QAAQ,EAAA;AAAA,EACjC,IAAI,EAAE,MAAM,aAAa,QAAQ,EAAA;AAAA,EACjC,IAAI,EAAE,MAAM,eAAe,QAAQ,EAAA;AAAA,EACnC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,GAAA;AAAA,EACpC,IAAI,EAAE,MAAM,gBAAgB,QAAQ,GAAA;AACtC,CAAC;"}
@@ -0,0 +1,94 @@
1
+ import { PhoneCountry } from './PhoneCountries';
2
+ import { PhoneFormat } from './PhoneFormats';
3
+ /** Holds a value's country and national digits. */
4
+ export interface PhoneNumberParts {
5
+ /** The ISO code the value's dial prefix names, or the fallback when none of the countries matches. */
6
+ readonly iso: string;
7
+ /** The national digits: everything after the matched dial code, or every digit when none matched. */
8
+ readonly national: string;
9
+ }
10
+ /** Holds the national digits a country's numbering plan accepts. */
11
+ export interface PhoneLengthRange {
12
+ /** The fewest national digits. */
13
+ readonly min: number;
14
+ /** The most national digits. Equals `min` for a fixed-length plan. */
15
+ readonly max: number;
16
+ }
17
+ /** Describes one edit of the national-number field, as the browser left it. */
18
+ export interface PhoneNationalEditInput {
19
+ /** The field text after the browser applied the edit, separators and stray characters included. */
20
+ readonly text: string;
21
+ /** The caret offset in `text`. */
22
+ readonly caret: number;
23
+ /** The national digits before the edit. */
24
+ readonly previousDigits: string;
25
+ /** The `InputEvent.inputType`; `deleteContentBackward` / `deleteContentForward` step over a separator. */
26
+ readonly inputType?: string;
27
+ /** The country's format; its `length` caps the digits. */
28
+ readonly format: PhoneFormat;
29
+ }
30
+ /** Holds the result of one national-number edit. */
31
+ export interface PhoneNationalEdit {
32
+ /** The national digits after the edit. */
33
+ readonly digits: string;
34
+ /** The display text: the digits through the mask. */
35
+ readonly text: string;
36
+ /** The caret offset in `text`, after the same digits it followed before the edit. */
37
+ readonly caret: number;
38
+ }
39
+ /** Holds an international number read from pasted or autofilled text. */
40
+ export interface PhoneInternationalNumber {
41
+ /** The allowed country its dial prefix names, or `null` when none does. */
42
+ readonly country: PhoneCountry | null;
43
+ /** The E.164 value: `+` and every digit of the text. */
44
+ readonly e164: string;
45
+ }
46
+ /** Extends E.164 phone values and their national digits: country lookup, length rules, display and editing. */
47
+ export declare const PhoneNumberExtensions: {
48
+ /** @internal E.164 caps a number, dial code included, at 15 digits. */
49
+ readonly MaxDigits: 15;
50
+ /** @internal The fewest national digits a plan outside `PhoneFormats` accepts — Austria's shortest. */
51
+ readonly MinNationalDigits: 4;
52
+ /** @internal The group size of the fallback mask. */
53
+ readonly GroupSize: 3;
54
+ /** @internal The mask character that takes one digit. */
55
+ readonly DigitSlot: "X";
56
+ /** @internal Every non-digit. */
57
+ readonly NonDigit: RegExp;
58
+ /** @internal An E.164 value: `+`, then digits, the first not `0`. */
59
+ readonly E164Pattern: RegExp;
60
+ /** Removes every non-digit. */
61
+ readonly digitsOf: (text: string) => string;
62
+ /**
63
+ * Resolves ISO codes to known countries in the order given; unknown and repeated codes are dropped. A list with no
64
+ * known code reads as absent — every country — since a phone control with no country could hold no value.
65
+ */
66
+ readonly resolveCountries: (isos: ReadonlyArray<string> | undefined) => ReadonlyArray<PhoneCountry>;
67
+ /** Resolves the national digits a country accepts: its fixed length, else up to the E.164 cap. */
68
+ readonly lengthOf: (country: PhoneCountry) => PhoneLengthRange;
69
+ /** Resolves a country's format: its `PhoneFormats` entry, else three-digit groups up to the E.164 cap. */
70
+ readonly formatOf: (country: PhoneCountry) => PhoneFormat;
71
+ /** Lays national digits into a mask; a separator shows only once a digit follows it, extra digits trail unmasked. */
72
+ readonly formatNational: (digits: string, format: PhoneFormat) => string;
73
+ /** Finds the offset just after the `count`-th digit of `text`; `0` for no digits, the end when it has fewer. */
74
+ readonly caretAfterDigits: (text: string, count: number) => number;
75
+ /**
76
+ * Applies one edit of the national-number field: drops non-digits, steps a deletion over a separator onto the digit
77
+ * beside it, drops typed or pasted digits past the format's length, and keeps the caret after the same digit.
78
+ */
79
+ readonly editNational: (input: PhoneNationalEditInput) => PhoneNationalEdit;
80
+ /**
81
+ * Finds the country an E.164 value belongs to: `preferredIso` when its dial code matches (a shared `+1` or `+7` stays
82
+ * on the reader's pick), else the longest matching dial code, a shared one going to the earlier country.
83
+ */
84
+ readonly countryOf: (value: string, countries: ReadonlyArray<PhoneCountry>, preferredIso?: string) => PhoneCountry | null;
85
+ /** Splits an E.164 value into its country and national digits; a value no country matches keeps every digit. */
86
+ readonly split: (value: string, countries: ReadonlyArray<PhoneCountry>, fallbackIso: string) => PhoneNumberParts;
87
+ /** Reads an international number from free text (`+998 99 663-25-82`): every digit after `+`, and its country. */
88
+ readonly parseInternational: (text: string, countries: ReadonlyArray<PhoneCountry>, preferredIso?: string) => PhoneInternationalNumber;
89
+ /**
90
+ * Strips a dial code typed without its `+` (`998996632582` for Uzbekistan): only digits that are exactly the
91
+ * country's dial code and a full fixed-length national number, a length no national number has on its own.
92
+ */
93
+ readonly withoutDialCode: (digits: string, country: PhoneCountry) => string;
94
+ };