@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.6

package/dist/esm/components/form/fields/form-field-address.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-address.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FormFieldAddress Component\n *\n * Edits a structured postal address declared with `z_address()`: one labelled input per part, the\n * multi-field address pattern (GOV.UK \"Addresses\") rather than a single free-text box nothing can\n * validate or compare.\n *\n * - Every part carries its HTML autofill token (`address-line1`, `address-level2`, `postal-code`,\n *   `country`, …), so a browser or password manager fills the whole address in one gesture (WCAG\n *   1.3.5).\n * - The country is a native `<select>` of ISO 3166-1 alpha-2 codes with names from the active\n *   locale (`Intl.DisplayNames`), restricted to the field's `countriesAllowed` and pre-selected from\n *   its `defaultCountry`. A stored code outside that list is kept as an option rather than silently\n *   replaced.\n * - The latitude/longitude pair is offered only when the field declares `withCoordinates`.\n * - Blur is reported when focus leaves the GROUP, not each part, so on-blur validation does not fire\n *   between \"line 1\" and \"city\".\n * - A validation issue is shown under the PART it concerns (`partErrors`), with that input marked\n *   invalid — a nested error summarised as one message for the whole group names nothing to fix.\n * - The group is named by the field's own label (`field-<name>-label`, rendered by FormFieldChrome),\n *   so \"Town or city\" in a billing address and in a shipping address are distinguishable to a screen\n *   reader. The first line keeps the `field-<name>` id the chrome label targets, so clicking the label\n *   still focuses the address.\n *\n * Every part is held as a string draft while typing and composed into the value on each change:\n * optional parts left empty are omitted, and a half-typed coordinate becomes `NaN`, which the schema\n * refuses — the field shows an error instead of storing a point the user did not enter.\n */\n\nimport React, { forwardRef } from 'react';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { InputRoot } from '~wildo-frontend-lib/components/form/controls/input';\nimport { FieldError } from '~wildo-frontend-lib/components/form/chromes/field';\nimport { ControlSize, CorePresetNames, FormControlVariant, FrontendComponentType, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { AddressCoordinatePart, AddressPart, getAddressMetadata, getCountries, type AddressValue } from '@wildo-ai/zod-decorators';\n\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types';\n\n// --- Contract ---\nexport interface FormFieldAddressProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value?: AddressValue;\n  /**\n   * `undefined` is emitted when the user empties every part of a clearable field — the control's\n   * \"no address\" gesture. A pre-selected country alone is not an entry and does not count.\n   */\n  onChange?: (value: AddressValue | undefined) => void;\n  defaultValue?: AddressValue;\n  /**\n   * The resolved, displayable error of each part that has one, keyed by the part's dotted path inside\n   * the value (`city`, `coordinates.longitude` — see `listAddressPartPaths`). Resolved by the form,\n   * which owns touch/submit visibility; the control only places each message under its input.\n   */\n  partErrors?: Readonly<Record<string, string | undefined>>;\n}\n\nexport type FormFieldAddressRef = HTMLInputElement;\n\n/** The free-text parts, in the order the form presents them. */\ntype AddressTextPart = AddressPart.LINE1 | AddressPart.LINE2 | AddressPart.CITY | AddressPart.STATE | AddressPart.POSTAL_CODE;\n\ninterface AddressTextPartControl {\n  part: AddressTextPart;\n  /** HTML autofill field name for this part. */\n  autoComplete: string;\n}\n\nconst ADDRESS_TEXT_PART_CONTROLS: readonly AddressTextPartControl[] = [\n  { part: AddressPart.LINE1, autoComplete: 'address-line1' },\n  { part: AddressPart.LINE2, autoComplete: 'address-line2' },\n  { part: AddressPart.CITY, autoComplete: 'address-level2' },\n  { part: AddressPart.STATE, autoComplete: 'address-level1' },\n  { part: AddressPart.POSTAL_CODE, autoComplete: 'postal-code' },\n];\n\n/** What the user has typed, part by part, before it is composed into a value. */\ntype AddressDraft = Record<AddressPart, string> & Record<AddressCoordinatePart, string>;\n\nfunction draftFromValue(value: AddressValue | undefined, defaultCountry: string | undefined): AddressDraft {\n  return {\n    [AddressPart.LINE1]: value?.line1 ?? '',\n    [AddressPart.LINE2]: value?.line2 ?? '',\n    [AddressPart.CITY]: value?.city ?? '',\n    [AddressPart.STATE]: value?.state ?? '',\n    [AddressPart.POSTAL_CODE]: value?.postalCode ?? '',\n    [AddressPart.COUNTRY]: value?.country ?? defaultCountry ?? '',\n    [AddressCoordinatePart.LATITUDE]: value?.coordinates ? String(value.coordinates.latitude) : '',\n    [AddressCoordinatePart.LONGITUDE]: value?.coordinates ? String(value.coordinates.longitude) : '',\n  };\n}\n\n/** A coordinate the user left empty while typing the other one is `NaN`, never a silent `0`. */\nfunction coordinateFromDraft(text: string): number {\n  return text.trim() === '' ? Number.NaN : Number(text);\n}\n\n/**\n * Compose the draft into the value the form stores. Returns `null` when nothing was entered, so the\n * caller decides between the clear gesture and an empty (schema-refused) value.\n */\nfunction composeAddress(draft: AddressDraft): AddressValue | null {\n  const hasText = ADDRESS_TEXT_PART_CONTROLS.some(({ part }) => draft[part].trim() !== '');\n  const hasCoordinates = draft.latitude.trim() !== '' || draft.longitude.trim() !== '';\n  if (!hasText && !hasCoordinates) return null;\n  return {\n    line1: draft.line1,\n    ...(draft.line2 !== '' && { line2: draft.line2 }),\n    city: draft.city,\n    ...(draft.state !== '' && { state: draft.state }),\n    ...(draft.postalCode !== '' && { postalCode: draft.postalCode }),\n    country: draft.country,\n    ...(hasCoordinates && {\n      coordinates: { latitude: coordinateFromDraft(draft.latitude), longitude: coordinateFromDraft(draft.longitude) },\n    }),\n  };\n}\n\ninterface CountryOption {\n  code: string;\n  name: string;\n}\n\n/**\n * Selectable countries with locale-aware names, collated in the active language.\n *\n * The code list is the one the phone field uses (libphonenumber's region set). It covers every\n * inhabited ISO 3166-1 region; a stored code it lacks is still offered by the render below.\n */\nfunction buildCountryOptions(locale: string, countriesAllowed: readonly string[] | undefined): CountryOption[] {\n  let displayNames: Intl.DisplayNames | undefined;\n  try {\n    displayNames = new Intl.DisplayNames([locale], { type: 'region' });\n  } catch {\n    displayNames = undefined;\n  }\n  const collator = new Intl.Collator(locale);\n  const codes = countriesAllowed && countriesAllowed.length > 0 ? [...countriesAllowed] : getCountries();\n  return codes\n    .map((code) => ({ code, name: displayNames?.of(code) ?? code }))\n    .sort((a, b) => collator.compare(a.name, b.name));\n}\n\n/**\n * FormFieldAddress component\n *\n * One labelled control per address part plus a country selector. Emits `AddressValue`.\n */\nexport const FormFieldAddress_Preset_Default = React.forwardRef<FormFieldAddressRef, FormFieldAddressProps>(\n  (\n    {\n      schema,\n      name,\n      disabled,\n      readOnly,\n      className,\n      value: controlledValue,\n      onChange,\n      onBlur,\n      defaultValue,\n      autoFocus,\n      clearable,\n      partErrors,\n      controlSize = ControlSize.MD,\n    },\n    ref\n  ): React.JSX.Element => {\n    const { tComponent, currentLanguage } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n    const { getRecipe } = useUI();\n    const formRecipe = getRecipe(UIBehavior.FORM_CONTROL, FormControlVariant.DEFAULT);\n\n    const addressMetadata = getAddressMetadata(schema);\n    const defaultCountry = addressMetadata?.defaultCountry;\n    const withCoordinates = addressMetadata?.withCoordinates === true;\n\n    const externalValue = controlledValue ?? defaultValue;\n    const [draft, setDraft] = React.useState<AddressDraft>(() => draftFromValue(externalValue, defaultCountry));\n    /**\n     * The latest draft, updated synchronously on every change. Change handlers build the next draft\n     * from THIS rather than from the render's `draft`: browser autofill fills several parts in one\n     * gesture, and a handler reading the render-time draft would overwrite the parts filled just before.\n     */\n    const draftRef = React.useRef<AddressDraft>(draft);\n\n    /**\n     * Our own emits come back as `controlledValue`. Re-deriving the draft from that echo would clobber\n     * in-progress typing (an optional part emptied mid-edit is omitted from the value, and a half-typed\n     * coordinate is `NaN`), so a resync happens only for a value this control did not emit.\n     */\n    const lastEmittedKeyRef = React.useRef<string>(JSON.stringify(externalValue ?? null));\n    const externalKey = JSON.stringify(externalValue ?? null);\n    React.useEffect(() => {\n      if (externalKey === lastEmittedKeyRef.current) return;\n      lastEmittedKeyRef.current = externalKey;\n      const resynced = draftFromValue(externalValue, defaultCountry);\n      draftRef.current = resynced;\n      setDraft(resynced);\n      // `externalValue` is represented by `externalKey`; depending on the object would resync on identity.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [externalKey, defaultCountry]);\n\n    const countryOptions = React.useMemo(\n      () => buildCountryOptions(currentLanguage, addressMetadata?.countriesAllowed),\n      [currentLanguage, addressMetadata?.countriesAllowed]\n    );\n\n    const commitPart = React.useCallback(\n      (part: AddressPart | AddressCoordinatePart, text: string) => {\n        const nextDraft = { ...draftRef.current, [part]: text };\n        draftRef.current = nextDraft;\n        setDraft(nextDraft);\n        const composed = composeAddress(nextDraft);\n        const emitted = composed ?? (clearable ? undefined : { line1: '', city: '', country: nextDraft.country });\n        lastEmittedKeyRef.current = JSON.stringify(emitted ?? null);\n        onChange?.(emitted);\n      },\n      [clearable, onChange]\n    );\n\n    const handleGroupBlur = React.useCallback(\n      (event: React.FocusEvent<HTMLDivElement>) => {\n        if (event.currentTarget.contains(event.relatedTarget as Node | null)) return;\n        onBlur?.();\n      },\n      [onBlur]\n    );\n\n    const fieldId = `field-${name}`;\n    const partId = (path: string): string => (path === AddressPart.LINE1 ? fieldId : `${fieldId}-${path.replace('.', '-')}`);\n    const labelClassName = 'text-sm text-muted-foreground';\n\n    /** Label, control and the part's own error, with the error linked to the control. */\n    const renderPart = (path: string, label: string, control: (a11y: { id: string; 'aria-invalid'?: true; 'aria-describedby'?: string }) => React.ReactNode) => {\n      const id = partId(path);\n      const error = partErrors?.[path];\n      const errorId = `${id}-error`;\n      return (\n        <div key={path} className=\"flex flex-col gap-1\">\n          <label htmlFor={id} className={labelClassName}>\n            {label}\n          </label>\n          {control({ id, ...(error && { 'aria-invalid': true as const, 'aria-describedby': errorId }) })}\n          {error && <FieldError id={errorId}>{error}</FieldError>}\n        </div>\n      );\n    };\n\n    const renderTextPart = ({ part, autoComplete }: AddressTextPartControl): React.ReactNode =>\n      renderPart(part, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, part), (a11y) => (\n        <InputRoot\n          {...a11y}\n          ref={part === AddressPart.LINE1 ? ref : undefined}\n          name={`${name}.${part}`}\n          type=\"text\"\n          value={draft[part]}\n          onChange={(event: React.ChangeEvent<HTMLInputElement>) => commitPart(part, event.target.value)}\n          disabled={disabled}\n          readOnly={readOnly}\n          autoComplete={autoComplete}\n          autoFocus={part === AddressPart.LINE1 ? autoFocus : undefined}\n          controlSize={controlSize}\n        />\n      ));\n\n    const renderCoordinatePart = (part: AddressCoordinatePart): React.ReactNode =>\n      renderPart(`coordinates.${part}`, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, part), (a11y) => (\n        <InputRoot\n          {...a11y}\n          name={`${name}.coordinates.${part}`}\n          type=\"number\"\n          step=\"any\"\n          inputMode=\"decimal\"\n          value={draft[part]}\n          onChange={(event: React.ChangeEvent<HTMLInputElement>) => commitPart(part, event.target.value)}\n          disabled={disabled}\n          readOnly={readOnly}\n          className=\"tabular-nums\"\n          controlSize={controlSize}\n        />\n      ));\n\n    const [line1Control, line2Control, cityControl, stateControl, postalCodeControl] = ADDRESS_TEXT_PART_CONTROLS;\n    const countryIsListed = countryOptions.some((option) => option.code === draft.country);\n\n    return (\n      <div\n        className={cn('flex w-full flex-col gap-element', className)}\n        role=\"group\"\n        aria-labelledby={`${fieldId}-label`}\n        onBlur={handleGroupBlur}\n      >\n        {renderTextPart(line1Control)}\n        {renderTextPart(line2Control)}\n        <div className=\"grid gap-element sm:grid-cols-2\">\n          {renderTextPart(cityControl)}\n          {renderTextPart(postalCodeControl)}\n        </div>\n        {renderTextPart(stateControl)}\n        {renderPart(AddressPart.COUNTRY, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, AddressPart.COUNTRY), (a11y) => (\n          <select\n            {...a11y}\n            name={`${name}.${AddressPart.COUNTRY}`}\n            value={draft.country}\n            onChange={(event) => commitPart(AddressPart.COUNTRY, event.target.value)}\n            disabled={disabled || readOnly}\n            autoComplete=\"country\"\n            data-size={controlSize}\n            className={cn(\n              'flex w-full rounded-md bg-transparent text-sm',\n              formRecipe.base,\n              formRecipe.states.focus,\n              formRecipe.states.disabled,\n              formRecipe.sizes?.[controlSize],\n              formRecipe.motion.transition\n            )}\n          >\n            {draft.country === '' && (\n              <option value=\"\" disabled>\n                {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, 'countryPlaceholder')}\n              </option>\n            )}\n            {draft.country !== '' && !countryIsListed && <option value={draft.country}>{draft.country}</option>}\n            {countryOptions.map((option) => (\n              <option key={option.code} value={option.code}>\n                {option.name}\n              </option>\n            ))}\n          </select>\n        ))}\n        {withCoordinates && (\n          <div className=\"grid gap-element sm:grid-cols-2\">\n            {renderCoordinatePart(AddressCoordinatePart.LATITUDE)}\n            {renderCoordinatePart(AddressCoordinatePart.LONGITUDE)}\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nFormFieldAddress_Preset_Default.displayName = 'FormFieldAddress_Preset_Default';\n\n// --- Wrapper ---\nexport const FormFieldAddress = forwardRef<FormFieldAddressRef, FormFieldAddressProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolverWithRef<FormFieldAddressProps, FormFieldAddressRef>(\n      FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS,\n      'FormFieldAddress'\n    )(preset);\n    return <Component {...props} ref={ref} />;\n  }\n);\nFormFieldAddress.displayName = 'FormFieldAddress';\n"]}
+{"version":3,"file":"form-field-address.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,oDAAoD,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAC1I,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAqB,MAAM,0BAA0B,CAAC;AAEnI,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAC;AAiFjI,MAAM,0BAA0B,GAAsC;IACpE,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE;IAC1D,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE;IAC1D,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE;IAC1D,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE;IAC3D,EAAE,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE;CAC/D,CAAC;AAKF,SAAS,cAAc,CAAC,KAA+B,EAAE,cAAkC;IACzF,OAAO;QACL,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;QACvC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;QACvC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,EAAE;QACrC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;QACvC,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE;QAClD,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,IAAI,cAAc,IAAI,EAAE;QAC7D,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9F,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;KACjG,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAmB;IACzC,MAAM,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzF,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACrF,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACjD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAChE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,cAAc,IAAI;YACpB,WAAW,EAAE,EAAE,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;SAChH,CAAC;KACH,CAAC;AACJ,CAAC;AAOD;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,gBAA+C;IAC1F,IAAI,YAA2C,CAAC;IAChD,IAAI,CAAC;QACH,YAAY,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IACvG,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;SAC/D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC,UAAU,CAC7D,CACE,EACE,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,EAAE,eAAe,EACtB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,GAAG,WAAW,CAAC,EAAE,GAC7B,EACD,GAAG,EACgB,EAAE;IACrB,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,qBAAqB,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACrH,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAElF,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,eAAe,EAAE,cAAc,CAAC;IACvD,MAAM,eAAe,GAAG,eAAe,EAAE,eAAe,KAAK,IAAI,CAAC;IAElE,MAAM,aAAa,GAAG,eAAe,IAAI,YAAY,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAe,GAAG,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5G;;;;OAIG;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAe,KAAK,CAAC,CAAC;IAEnD;;;;OAIG;IACH,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAS,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAC1D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,WAAW,KAAK,iBAAiB,CAAC,OAAO;YAAE,OAAO;QACtD,iBAAiB,CAAC,OAAO,GAAG,WAAW,CAAC;QACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC/D,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnB,qGAAqG;QACrG,uDAAuD;IACzD,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IAElC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAClC,GAAG,EAAE,CAAC,mBAAmB,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAC7E,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,CACrD,CAAC;IAEF,6GAA6G;IAC7G,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CACnC,CAAC,SAAuB,EAAE,EAAE;QAC1B,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1G,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QAC5D,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC,EACD,CAAC,SAAS,EAAE,QAAQ,CAAC,CACtB,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,CAAC,IAAyC,EAAE,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAC/G,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,cAAc,GAAG,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,CAAC;IAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,CAAC,OAAqB,EAAE,EAAE;QACxB,mGAAmG;QACnG,yDAAyD;QACzD,IAAI,cAAc;YAAE,OAAO;QAC3B,6FAA6F;QAC7F,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;QAC9D,WAAW,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IACzD,CAAC,EACD,CAAC,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC,CAC9C,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CACvC,CAAC,KAAuC,EAAE,EAAE;QAC1C,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,aAA4B,CAAC;YAAE,OAAO;QAC7E,MAAM,EAAE,EAAE,CAAC;IACb,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,OAAO,GAAG,SAAS,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzH,MAAM,cAAc,GAAG,+BAA+B,CAAC;IAEvD,qFAAqF;IACrF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,OAAsG,EAAE,EAAE;QACzJ,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,GAAG,EAAE,QAAQ,CAAC;QAC9B,OAAO,CACL,eAAgB,SAAS,EAAC,qBAAqB,aAC7C,KAAC,UAAU,IAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,YAC/C,KAAK,GACK,EACZ,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,cAAc,EAAE,IAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAC7F,KAAK,IAAI,KAAC,UAAU,IAAC,EAAE,EAAE,OAAO,YAAG,KAAK,GAAc,KAL/C,IAAI,CAMR,CACP,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,EAA0B,EAAmB,EAAE,CACzF,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAC/F,KAAC,SAAS,OACJ,IAAI,EACR,GAAG,EAAE,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EACjD,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EACvB,IAAI,EAAC,MAAM,EACX,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,QAAQ,EAAE,CAAC,KAA0C,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAC9F,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC7D,WAAW,EAAE,WAAW,GACxB,CACH,CAAC,CAAC;IAEL,MAAM,oBAAoB,GAAG,CAAC,IAA2B,EAAmB,EAAE,CAC5E,UAAU,CAAC,eAAe,IAAI,EAAE,EAAE,UAAU,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAChH,KAAC,SAAS,OACJ,IAAI,EACR,IAAI,EAAE,GAAG,IAAI,gBAAgB,IAAI,EAAE,EACnC,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,KAAK,EACV,SAAS,EAAC,SAAS,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,QAAQ,EAAE,CAAC,KAA0C,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAC9F,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAC,cAAc,EACxB,WAAW,EAAE,WAAW,GACxB,CACH,CAAC,CAAC;IAEL,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,CAAC,GAAG,0BAA0B,CAAC;IAC9G,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvF,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CAAC,kCAAkC,EAAE,SAAS,CAAC,EAC5D,IAAI,EAAC,OAAO,qBACK,GAAG,OAAO,QAAQ,EACnC,MAAM,EAAE,eAAe,aAEtB,YAAY,EAAE,CAAC;gBACd,mGAAmG;gBACnG,8DAA8D;gBAC9D,GAAG,CAAC,eAAe,EAAE,gBAAgB,IAAI,eAAe,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,gBAAgB,EAAE,CAAC;gBAC/I,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,CAAC;gBACvD,QAAQ,EAAE,cAAc;gBACxB,YAAY;aACb,CAAC,EACD,cAAc,CAAC,YAAY,CAAC,EAC5B,cAAc,CAAC,YAAY,CAAC,EAC7B,eAAK,SAAS,EAAC,iCAAiC,aAC7C,cAAc,CAAC,WAAW,CAAC,EAC3B,cAAc,CAAC,iBAAiB,CAAC,IAC9B,EACL,cAAc,CAAC,YAAY,CAAC,EAC5B,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9H,qBACM,IAAI,EACR,IAAI,EAAE,GAAG,IAAI,IAAI,WAAW,CAAC,OAAO,EAAE,EACtC,KAAK,EAAE,KAAK,CAAC,OAAO,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EACxE,QAAQ,EAAE,QAAQ,IAAI,QAAQ,EAC9B,YAAY,EAAC,SAAS,eACX,WAAW,EACtB,SAAS,EAAE,EAAE,CACX,+CAA+C,EAC/C,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,MAAM,CAAC,KAAK,EACvB,UAAU,CAAC,MAAM,CAAC,QAAQ,EAC1B,UAAU,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAC/B,UAAU,CAAC,MAAM,CAAC,UAAU,CAC7B,aAEA,KAAK,CAAC,OAAO,KAAK,EAAE,IAAI,CACvB,iBAAQ,KAAK,EAAC,EAAE,EAAC,QAAQ,kBACtB,UAAU,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,oBAAoB,CAAC,GAC9E,CACV,EACA,KAAK,CAAC,OAAO,KAAK,EAAE,IAAI,CAAC,eAAe,IAAI,iBAAQ,KAAK,EAAE,KAAK,CAAC,OAAO,YAAG,KAAK,CAAC,OAAO,GAAU,EAClG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC9B,iBAA0B,KAAK,EAAE,MAAM,CAAC,IAAI,YACzC,MAAM,CAAC,IAAI,IADD,MAAM,CAAC,IAAI,CAEf,CACV,CAAC,IACK,CACV,CAAC,EACD,eAAe,IAAI,CAClB,eAAK,SAAS,EAAC,iCAAiC,aAC7C,oBAAoB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EACpD,oBAAoB,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAClD,CACP,IACG,CACP,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,+BAA+B,CAAC,WAAW,GAAG,iCAAiC,CAAC;AAEhF,kBAAkB;AAClB,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CACxC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,4BAA4B,EAClD,kBAAkB,CACnB,CAAC,MAAM,CAAC,CAAC;IACV,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAC;AAC5C,CAAC,CACF,CAAC;AACF,gBAAgB,CAAC,WAAW,GAAG,kBAAkB,CAAC","sourcesContent":["/**\n * FormFieldAddress Component\n *\n * Edits a structured postal address declared with `z_address()`: one labelled input per part, the\n * multi-field address pattern (GOV.UK \"Addresses\") rather than a single free-text box nothing can\n * validate or compare.\n *\n * - Every part carries its HTML autofill token (`address-line1`, `address-level2`, `postal-code`,\n *   `country`, …), so a browser or password manager fills the whole address in one gesture (WCAG\n *   1.3.5).\n * - The country is a native `<select>` of ISO 3166-1 alpha-2 codes with names from the active\n *   locale (`Intl.DisplayNames`), restricted to the field's `countriesAllowed` and pre-selected from\n *   its `defaultCountry`. A stored code outside that list is kept as an option rather than silently\n *   replaced.\n * - The latitude/longitude pair is offered only when the field declares `withCoordinates`.\n * - Blur is reported when focus leaves the GROUP, not each part, so on-blur validation does not fire\n *   between \"line 1\" and \"city\".\n * - A validation issue is shown under the PART it concerns (`partErrors`), with that input marked\n *   invalid — a nested error summarised as one message for the whole group names nothing to fix.\n * - The group is named by the field's own label (`field-<name>-label`, rendered by FormFieldChrome),\n *   so \"Town or city\" in a billing address and in a shipping address are distinguishable to a screen\n *   reader. The first line keeps the `field-<name>` id the chrome label targets, so clicking the label\n *   still focuses the address.\n *\n * Every part is held as a string draft while typing and composed into the value on each change:\n * optional parts left empty are omitted, and a half-typed coordinate becomes `NaN`, which the schema\n * refuses — the field shows an error instead of storing a point the user did not enter.\n *\n * ## The lookup slot (#1730, filled by #561)\n *\n * `renderLookup` is where an address LOOKUP renders — a vendor autocomplete such as a\n * `FRONTEND_ADDRESS_LOOKUP` provider component — above the parts. The field hands it an\n * {@link AddressFieldLookupHost} and nothing else: the field imports no provider code, resolves no\n * provider, and works exactly the same by hand when the slot is empty, refused or failing. That split\n * is the design, not a placeholder: the field owns the value, its validation and its persistence; a\n * lookup only SUGGESTS a whole address, which lands in the parts as if the person had typed it and\n * stays editable before anything is saved.\n */\n\nimport React, { forwardRef } from 'react';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { InputRoot } from '~wildo-frontend-lib/components/form/controls/input';\nimport { FieldError, FieldLabel } from '~wildo-frontend-lib/components/form/chromes/field';\nimport { ControlSize, CorePresetNames, FormControlVariant, FrontendComponentType, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { AddressCoordinatePart, AddressPart, getAddressMetadata, getCountries, type AddressValue } from '@wildo-ai/zod-decorators';\n\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas';\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types';\n\n// --- Contract ---\n/** @wildo_source:part:start saas.frontend.form-field-address.lookup-slot facet:layer:frontend facet:family:component facet:audience:app-developer */\n/**\n * Props of `FormFieldAddress` (`@wildo-ai/saas-frontend-lib`), the control the framework renders for every\n * field declared with `z_address()`. Forms dispatch to it automatically; an application passes these\n * props itself only when it renders the control directly or fills its lookup slot.\n */\nexport interface FormFieldAddressProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value?: AddressValue;\n  /**\n   * `undefined` is emitted when the user empties every part of a clearable field — the control's\n   * \"no address\" gesture. A pre-selected country alone is not an entry and does not count.\n   */\n  onChange?: (value: AddressValue | undefined) => void;\n  defaultValue?: AddressValue;\n  /**\n   * The resolved, displayable error of each part that has one, keyed by the part's dotted path inside\n   * the value (`city`, `coordinates.longitude` — see `listAddressPartPaths`). Resolved by the form,\n   * which owns touch/submit visibility; the control only places each message under its input.\n   */\n  partErrors?: Readonly<Record<string, string | undefined>>;\n  /**\n   * Renders an address LOOKUP (a vendor autocomplete) above the parts. Omitted, the field is the plain\n   * multi-part control, and it stays fully usable by hand when a lookup is refused or fails. The field\n   * decides nothing about which lookup this is and imports no provider code: whoever fills the slot\n   * resolves the provider, its consent and its errors, and fills the field through\n   * {@link AddressFieldLookupHost.applyAddress}.\n   */\n  renderLookup?: (host: AddressFieldLookupHost) => React.ReactNode;\n}\n\n/**\n * What an address field hands to the lookup rendered in its `renderLookup` slot.\n *\n * Deliberately provider-free: every member is the FIELD's own knowledge (its `z_address()` options and\n * its editability) plus one way to fill it. A vendor lookup narrows its suggestions to\n * `countriesAllowed`, ranks by `defaultCountry`, and calls `applyAddress` with the place the person chose.\n */\nexport interface AddressFieldLookupHost {\n  /** ISO 3166-1 alpha-2 codes the field accepts, from `z_address({ countriesAllowed })`. Absent means any; never empty. */\n  readonly countriesAllowed?: readonly string[];\n  /** The field's default country, from `z_address({ defaultCountry })` — a ranking hint for suggestions. */\n  readonly defaultCountry?: string;\n  /** True while the field is disabled or read-only. A lookup must not offer to fill it then; `applyAddress` ignores the call. */\n  readonly disabled: boolean;\n  /**\n   * Replace every TEXT part and the country with the chosen address, as though the person had typed\n   * it, and emit the value.\n   *\n   * Every text part is replaced, including the ones the chosen address omits: a `line2` left over from\n   * the previous address describes a different place, so keeping it would compose an address that exists\n   * nowhere.\n   *\n   * Coordinates are ALWAYS cleared, whatever `address` carries. The previous geocode describes the previous\n   * place, and a lookup's geocode is never stored: vendors' terms either forbid storing it or allow it for a\n   * limited time, while a stored `coordinates` has no expiry, so nothing would ever delete it on the\n   * vendor's clock. The person can still enter coordinates by hand where the field offers them.\n   *\n   * The value is NOT validated here: it goes through the same form validation as a typed address, so a\n   * country outside `countriesAllowed` shows the same error under the country part. A caller that wants to\n   * refuse such a value before it reaches the field (the provider path does) validates it first.\n   */\n  applyAddress(address: AddressValue): void;\n}\n/** @wildo_source:part:end saas.frontend.form-field-address.lookup-slot */\n\nexport type FormFieldAddressRef = HTMLInputElement;\n\n/** The free-text parts, in the order the form presents them. */\ntype AddressTextPart = AddressPart.LINE1 | AddressPart.LINE2 | AddressPart.CITY | AddressPart.STATE | AddressPart.POSTAL_CODE;\n\ninterface AddressTextPartControl {\n  part: AddressTextPart;\n  /** HTML autofill field name for this part. */\n  autoComplete: string;\n}\n\nconst ADDRESS_TEXT_PART_CONTROLS: readonly AddressTextPartControl[] = [\n  { part: AddressPart.LINE1, autoComplete: 'address-line1' },\n  { part: AddressPart.LINE2, autoComplete: 'address-line2' },\n  { part: AddressPart.CITY, autoComplete: 'address-level2' },\n  { part: AddressPart.STATE, autoComplete: 'address-level1' },\n  { part: AddressPart.POSTAL_CODE, autoComplete: 'postal-code' },\n];\n\n/** What the user has typed, part by part, before it is composed into a value. */\ntype AddressDraft = Record<AddressPart, string> & Record<AddressCoordinatePart, string>;\n\nfunction draftFromValue(value: AddressValue | undefined, defaultCountry: string | undefined): AddressDraft {\n  return {\n    [AddressPart.LINE1]: value?.line1 ?? '',\n    [AddressPart.LINE2]: value?.line2 ?? '',\n    [AddressPart.CITY]: value?.city ?? '',\n    [AddressPart.STATE]: value?.state ?? '',\n    [AddressPart.POSTAL_CODE]: value?.postalCode ?? '',\n    [AddressPart.COUNTRY]: value?.country ?? defaultCountry ?? '',\n    [AddressCoordinatePart.LATITUDE]: value?.coordinates ? String(value.coordinates.latitude) : '',\n    [AddressCoordinatePart.LONGITUDE]: value?.coordinates ? String(value.coordinates.longitude) : '',\n  };\n}\n\n/** A coordinate the user left empty while typing the other one is `NaN`, never a silent `0`. */\nfunction coordinateFromDraft(text: string): number {\n  return text.trim() === '' ? Number.NaN : Number(text);\n}\n\n/**\n * Compose the draft into the value the form stores. Returns `null` when nothing was entered, so the\n * caller decides between the clear gesture and an empty (schema-refused) value.\n */\nfunction composeAddress(draft: AddressDraft): AddressValue | null {\n  const hasText = ADDRESS_TEXT_PART_CONTROLS.some(({ part }) => draft[part].trim() !== '');\n  const hasCoordinates = draft.latitude.trim() !== '' || draft.longitude.trim() !== '';\n  if (!hasText && !hasCoordinates) return null;\n  return {\n    line1: draft.line1,\n    ...(draft.line2 !== '' && { line2: draft.line2 }),\n    city: draft.city,\n    ...(draft.state !== '' && { state: draft.state }),\n    ...(draft.postalCode !== '' && { postalCode: draft.postalCode }),\n    country: draft.country,\n    ...(hasCoordinates && {\n      coordinates: { latitude: coordinateFromDraft(draft.latitude), longitude: coordinateFromDraft(draft.longitude) },\n    }),\n  };\n}\n\ninterface CountryOption {\n  code: string;\n  name: string;\n}\n\n/**\n * Selectable countries with locale-aware names, collated in the active language.\n *\n * The code list is the one the phone field uses (libphonenumber's region set). It covers every\n * inhabited ISO 3166-1 region; a stored code it lacks is still offered by the render below.\n */\nfunction buildCountryOptions(locale: string, countriesAllowed: readonly string[] | undefined): CountryOption[] {\n  let displayNames: Intl.DisplayNames | undefined;\n  try {\n    displayNames = new Intl.DisplayNames([locale], { type: 'region' });\n  } catch {\n    displayNames = undefined;\n  }\n  const collator = new Intl.Collator(locale);\n  const codes = countriesAllowed && countriesAllowed.length > 0 ? [...countriesAllowed] : getCountries();\n  return codes\n    .map((code) => ({ code, name: displayNames?.of(code) ?? code }))\n    .sort((a, b) => collator.compare(a.name, b.name));\n}\n\n/**\n * FormFieldAddress component\n *\n * One labelled control per address part plus a country selector. Emits `AddressValue`.\n */\nexport const FormFieldAddress_Preset_Default = React.forwardRef<FormFieldAddressRef, FormFieldAddressProps>(\n  (\n    {\n      schema,\n      name,\n      disabled,\n      readOnly,\n      className,\n      value: controlledValue,\n      onChange,\n      onBlur,\n      defaultValue,\n      autoFocus,\n      clearable,\n      partErrors,\n      renderLookup,\n      controlSize = ControlSize.MD,\n    },\n    ref\n  ): React.JSX.Element => {\n    const { tComponent, currentLanguage } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n    const { getRecipe } = useUI();\n    const formRecipe = getRecipe(UIBehavior.FORM_CONTROL, FormControlVariant.DEFAULT);\n\n    const addressMetadata = getAddressMetadata(schema);\n    const defaultCountry = addressMetadata?.defaultCountry;\n    const withCoordinates = addressMetadata?.withCoordinates === true;\n\n    const externalValue = controlledValue ?? defaultValue;\n    const [draft, setDraft] = React.useState<AddressDraft>(() => draftFromValue(externalValue, defaultCountry));\n    /**\n     * The latest draft, updated synchronously on every change. Change handlers build the next draft\n     * from THIS rather than from the render's `draft`: browser autofill fills several parts in one\n     * gesture, and a handler reading the render-time draft would overwrite the parts filled just before.\n     */\n    const draftRef = React.useRef<AddressDraft>(draft);\n\n    /**\n     * Our own emits come back as `controlledValue`. Re-deriving the draft from that echo would clobber\n     * in-progress typing (an optional part emptied mid-edit is omitted from the value, and a half-typed\n     * coordinate is `NaN`), so a resync happens only for a value this control did not emit.\n     */\n    const lastEmittedKeyRef = React.useRef<string>(JSON.stringify(externalValue ?? null));\n    const externalKey = JSON.stringify(externalValue ?? null);\n    React.useEffect(() => {\n      if (externalKey === lastEmittedKeyRef.current) return;\n      lastEmittedKeyRef.current = externalKey;\n      const resynced = draftFromValue(externalValue, defaultCountry);\n      draftRef.current = resynced;\n      setDraft(resynced);\n      // `externalValue` is represented by `externalKey`; depending on the object would resync on identity.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [externalKey, defaultCountry]);\n\n    const countryOptions = React.useMemo(\n      () => buildCountryOptions(currentLanguage, addressMetadata?.countriesAllowed),\n      [currentLanguage, addressMetadata?.countriesAllowed]\n    );\n\n    /** Adopt a new draft and emit the value it composes — the one path every edit, typed or looked up, takes. */\n    const commitDraft = React.useCallback(\n      (nextDraft: AddressDraft) => {\n        draftRef.current = nextDraft;\n        setDraft(nextDraft);\n        const composed = composeAddress(nextDraft);\n        const emitted = composed ?? (clearable ? undefined : { line1: '', city: '', country: nextDraft.country });\n        lastEmittedKeyRef.current = JSON.stringify(emitted ?? null);\n        onChange?.(emitted);\n      },\n      [clearable, onChange]\n    );\n\n    const commitPart = React.useCallback(\n      (part: AddressPart | AddressCoordinatePart, text: string) => commitDraft({ ...draftRef.current, [part]: text }),\n      [commitDraft]\n    );\n\n    const lookupDisabled = disabled === true || readOnly === true;\n    const applyAddress = React.useCallback(\n      (address: AddressValue) => {\n        // Checked here as well as advertised through `disabled`: a lookup that ignored the flag must still\n        // not be able to rewrite a field the person cannot edit.\n        if (lookupDisabled) return;\n        // `coordinates` is dropped before the draft is built: see the `applyAddress` contract above.\n        const { coordinates: _lookupGeocode, ...textParts } = address;\n        commitDraft(draftFromValue(textParts, defaultCountry));\n      },\n      [commitDraft, defaultCountry, lookupDisabled]\n    );\n\n    const handleGroupBlur = React.useCallback(\n      (event: React.FocusEvent<HTMLDivElement>) => {\n        if (event.currentTarget.contains(event.relatedTarget as Node | null)) return;\n        onBlur?.();\n      },\n      [onBlur]\n    );\n\n    const fieldId = `field-${name}`;\n    const partId = (path: string): string => (path === AddressPart.LINE1 ? fieldId : `${fieldId}-${path.replace('.', '-')}`);\n    const labelClassName = 'text-sm text-muted-foreground';\n\n    /** Label, control and the part's own error, with the error linked to the control. */\n    const renderPart = (path: string, label: string, control: (a11y: { id: string; 'aria-invalid'?: true; 'aria-describedby'?: string }) => React.ReactNode) => {\n      const id = partId(path);\n      const error = partErrors?.[path];\n      const errorId = `${id}-error`;\n      return (\n        <div key={path} className=\"flex flex-col gap-1\">\n          <FieldLabel htmlFor={id} className={labelClassName}>\n            {label}\n          </FieldLabel>\n          {control({ id, ...(error && { 'aria-invalid': true as const, 'aria-describedby': errorId }) })}\n          {error && <FieldError id={errorId}>{error}</FieldError>}\n        </div>\n      );\n    };\n\n    const renderTextPart = ({ part, autoComplete }: AddressTextPartControl): React.ReactNode =>\n      renderPart(part, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, part), (a11y) => (\n        <InputRoot\n          {...a11y}\n          ref={part === AddressPart.LINE1 ? ref : undefined}\n          name={`${name}.${part}`}\n          type=\"text\"\n          value={draft[part]}\n          onChange={(event: React.ChangeEvent<HTMLInputElement>) => commitPart(part, event.target.value)}\n          disabled={disabled}\n          readOnly={readOnly}\n          autoComplete={autoComplete}\n          autoFocus={part === AddressPart.LINE1 ? autoFocus : undefined}\n          controlSize={controlSize}\n        />\n      ));\n\n    const renderCoordinatePart = (part: AddressCoordinatePart): React.ReactNode =>\n      renderPart(`coordinates.${part}`, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, part), (a11y) => (\n        <InputRoot\n          {...a11y}\n          name={`${name}.coordinates.${part}`}\n          type=\"number\"\n          step=\"any\"\n          inputMode=\"decimal\"\n          value={draft[part]}\n          onChange={(event: React.ChangeEvent<HTMLInputElement>) => commitPart(part, event.target.value)}\n          disabled={disabled}\n          readOnly={readOnly}\n          className=\"tabular-nums\"\n          controlSize={controlSize}\n        />\n      ));\n\n    const [line1Control, line2Control, cityControl, stateControl, postalCodeControl] = ADDRESS_TEXT_PART_CONTROLS;\n    const countryIsListed = countryOptions.some((option) => option.code === draft.country);\n\n    return (\n      <div\n        className={cn('flex w-full flex-col gap-element', className)}\n        role=\"group\"\n        aria-labelledby={`${fieldId}-label`}\n        onBlur={handleGroupBlur}\n      >\n        {renderLookup?.({\n          // An empty list means \"any country\" to this field (see `buildCountryOptions`), so it is not handed\n          // over as a list a lookup could read as \"no country allowed\".\n          ...(addressMetadata?.countriesAllowed && addressMetadata.countriesAllowed.length > 0 && { countriesAllowed: addressMetadata.countriesAllowed }),\n          ...(defaultCountry !== undefined && { defaultCountry }),\n          disabled: lookupDisabled,\n          applyAddress,\n        })}\n        {renderTextPart(line1Control)}\n        {renderTextPart(line2Control)}\n        <div className=\"grid gap-element sm:grid-cols-2\">\n          {renderTextPart(cityControl)}\n          {renderTextPart(postalCodeControl)}\n        </div>\n        {renderTextPart(stateControl)}\n        {renderPart(AddressPart.COUNTRY, tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, AddressPart.COUNTRY), (a11y) => (\n          <select\n            {...a11y}\n            name={`${name}.${AddressPart.COUNTRY}`}\n            value={draft.country}\n            onChange={(event) => commitPart(AddressPart.COUNTRY, event.target.value)}\n            disabled={disabled || readOnly}\n            autoComplete=\"country\"\n            data-size={controlSize}\n            className={cn(\n              'flex w-full rounded-md bg-transparent text-sm',\n              formRecipe.base,\n              formRecipe.states.focus,\n              formRecipe.states.disabled,\n              formRecipe.sizes?.[controlSize],\n              formRecipe.motion.transition\n            )}\n          >\n            {draft.country === '' && (\n              <option value=\"\" disabled>\n                {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, 'countryPlaceholder')}\n              </option>\n            )}\n            {draft.country !== '' && !countryIsListed && <option value={draft.country}>{draft.country}</option>}\n            {countryOptions.map((option) => (\n              <option key={option.code} value={option.code}>\n                {option.name}\n              </option>\n            ))}\n          </select>\n        ))}\n        {withCoordinates && (\n          <div className=\"grid gap-element sm:grid-cols-2\">\n            {renderCoordinatePart(AddressCoordinatePart.LATITUDE)}\n            {renderCoordinatePart(AddressCoordinatePart.LONGITUDE)}\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nFormFieldAddress_Preset_Default.displayName = 'FormFieldAddress_Preset_Default';\n\n// --- Wrapper ---\nexport const FormFieldAddress = forwardRef<FormFieldAddressRef, FormFieldAddressProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolverWithRef<FormFieldAddressProps, FormFieldAddressRef>(\n      FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS,\n      'FormFieldAddress'\n    )(preset);\n    return <Component {...props} ref={ref} />;\n  }\n);\nFormFieldAddress.displayName = 'FormFieldAddress';\n"]}

package/dist/esm/components/form/fields/form-field-address.labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-address.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,8BAA8B,EAAE,mBAAmB,EA8C/D,CAAC"}
+{"version":3,"file":"form-field-address.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiE,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAMvK,eAAO,MAAM,8BAA8B,EAAE,mBAAmB,EAyG/D,CAAC"}

package/dist/esm/components/form/fields/form-field-address.labels.js

@@ -1,4 +1,4 @@
-import { FrontendComponentType, LabelKind, registerComponentLabels } from '@wildo-ai/presets-components-models';
+import { FormFieldAddressLookupLabel, FrontendComponentType, LabelKind, registerComponentLabels } from '@wildo-ai/presets-components-models';
 // Companion-only label metadata for this component: keys + params + (where
 // authored) per-key purpose / kind / variable meaning. Statically scanned by
 // the dev companion; NOT imported at runtime, so it never ships in the bundle.
@@ -48,6 +48,65 @@ export const LowLevelFormFieldAddressLabels = [
         kind: LabelKind.LABEL,
         purpose: 'Visible label of the longitude input, shown only when the address field offers coordinates',
     },
+    // The address LOOKUP (#561), rendered above the parts only when a lookup provider is live.
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_LABEL,
+        kind: LabelKind.LABEL,
+        purpose: 'Visible label of the optional search box above the address parts, where the person finds their address by typing part of it instead of filling every part',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_PLACEHOLDER,
+        kind: LabelKind.PLACEHOLDER,
+        purpose: 'Text of the closed address search control, inviting the person to search for their address',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_SEARCH_PLACEHOLDER,
+        kind: LabelKind.PLACEHOLDER,
+        purpose: 'Placeholder of the text box inside the open address suggestion list, asking the person to start typing their address',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_TYPE_MORE,
+        kind: LabelKind.EMPTY_STATE,
+        purpose: 'Shown in the suggestion list until the person has typed enough characters for a search to run',
+        params: [{ key: 'minimum', meaning: 'The number of characters needed before suggestions are searched' }],
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_NO_RESULTS,
+        kind: LabelKind.EMPTY_STATE,
+        purpose: 'Shown in the suggestion list when no address matches what was typed; the person can still fill the parts below by hand',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_UNAVAILABLE,
+        kind: LabelKind.MESSAGE,
+        purpose: 'Status shown when address search cannot run right now; tells the person to enter the address in the parts below, which always work',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_ADDRESS_REFUSED,
+        kind: LabelKind.MESSAGE,
+        purpose: 'Status shown when the chosen suggestion cannot fill this address (for example a country the field does not accept, or a place with no street address); tells the person to enter it below',
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_ATTRIBUTION,
+        kind: LabelKind.ARIA,
+        purpose: 'Sentence read by screen readers beside the address suggestions, naming the service they come from (the service\'s own mark is shown visually, untranslated)',
+        params: [{ key: 'mark', meaning: "The service's own required attribution text, for example Google Maps; a trademark, reproduced exactly and never translated" }],
+        notes: ['Keep {{mark}} exactly as given; do not translate, quote or restyle it.'],
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_CONSENT_REQUIRED,
+        kind: LabelKind.MESSAGE,
+        purpose: 'Status shown when the address search service can only be used after the person agrees to some data uses; names the service and the uses',
+        params: [
+            { key: 'provider', meaning: 'Name of the address search service' },
+            { key: 'purposes', meaning: 'Comma-separated names of the data uses the person has not agreed to' },
+        ],
+    },
+    {
+        ref: FormFieldAddressLookupLabel.LOOKUP_CONSENT_GRANT,
+        kind: LabelKind.BUTTON,
+        purpose: 'Button that records the person\'s agreement to exactly the listed data uses, so the address search can load',
+        params: [{ key: 'purposes', meaning: 'Comma-separated names of the data uses being agreed to' }],
+    },
 ];
 registerComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, LowLevelFormFieldAddressLabels);
 //# sourceMappingURL=form-field-address.labels.js.map

package/dist/esm/components/form/fields/form-field-address.labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-address.labels.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,8BAA8B,GAA0B;IACnE;QACE,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,iGAAiG;KAC3G;IACD;QACE,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,2HAA2H;KACrI;IACD;QACE,GAAG,EAAE,MAAM;QACX,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,uDAAuD;KACjE;IACD;QACE,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,8HAA8H;KACxI;IACD;QACE,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,6GAA6G;KACvH;IACD;QACE,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,4DAA4D;KACtE;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,2HAA2H;KACrI;IACD;QACE,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,2FAA2F;KACrG;IACD;QACE,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,4FAA4F;KACtG;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,8BAA8B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelFormFieldAddressLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'line1',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the first address line (street and number) inside the structured address input',\n  },\n  {\n    ref: 'line2',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the second address line (building, floor, apartment); the part is always optional, and the label says so',\n  },\n  {\n    ref: 'city',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the town or city part of the address',\n  },\n  {\n    ref: 'state',\n    kind: LabelKind.LABEL,\n    purpose: \"Visible label of the country's first subdivision (state, province, region or county); always optional, and the label says so\",\n  },\n  {\n    ref: 'postalCode',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the postal code part; optional because not every country issues one, and the label says so',\n  },\n  {\n    ref: 'country',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the country selector of the address input',\n  },\n  {\n    ref: 'countryPlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Disabled first option of the country selector, shown while no country is chosen and the field declares no default country',\n  },\n  {\n    ref: 'latitude',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the latitude input, shown only when the address field offers coordinates',\n  },\n  {\n    ref: 'longitude',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the longitude input, shown only when the address field offers coordinates',\n  },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, LowLevelFormFieldAddressLabels);\n"]}
+{"version":3,"file":"form-field-address.labels.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-address.labels.ts"],"names":[],"mappings":"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","sourcesContent":["import { FormFieldAddressLookupLabel, FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelFormFieldAddressLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'line1',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the first address line (street and number) inside the structured address input',\n  },\n  {\n    ref: 'line2',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the second address line (building, floor, apartment); the part is always optional, and the label says so',\n  },\n  {\n    ref: 'city',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the town or city part of the address',\n  },\n  {\n    ref: 'state',\n    kind: LabelKind.LABEL,\n    purpose: \"Visible label of the country's first subdivision (state, province, region or county); always optional, and the label says so\",\n  },\n  {\n    ref: 'postalCode',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the postal code part; optional because not every country issues one, and the label says so',\n  },\n  {\n    ref: 'country',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the country selector of the address input',\n  },\n  {\n    ref: 'countryPlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Disabled first option of the country selector, shown while no country is chosen and the field declares no default country',\n  },\n  {\n    ref: 'latitude',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the latitude input, shown only when the address field offers coordinates',\n  },\n  {\n    ref: 'longitude',\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the longitude input, shown only when the address field offers coordinates',\n  },\n  // The address LOOKUP (#561), rendered above the parts only when a lookup provider is live.\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_LABEL,\n    kind: LabelKind.LABEL,\n    purpose: 'Visible label of the optional search box above the address parts, where the person finds their address by typing part of it instead of filling every part',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_PLACEHOLDER,\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Text of the closed address search control, inviting the person to search for their address',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_SEARCH_PLACEHOLDER,\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Placeholder of the text box inside the open address suggestion list, asking the person to start typing their address',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_TYPE_MORE,\n    kind: LabelKind.EMPTY_STATE,\n    purpose: 'Shown in the suggestion list until the person has typed enough characters for a search to run',\n    params: [{ key: 'minimum', meaning: 'The number of characters needed before suggestions are searched' }],\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_NO_RESULTS,\n    kind: LabelKind.EMPTY_STATE,\n    purpose: 'Shown in the suggestion list when no address matches what was typed; the person can still fill the parts below by hand',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_UNAVAILABLE,\n    kind: LabelKind.MESSAGE,\n    purpose: 'Status shown when address search cannot run right now; tells the person to enter the address in the parts below, which always work',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_ADDRESS_REFUSED,\n    kind: LabelKind.MESSAGE,\n    purpose: 'Status shown when the chosen suggestion cannot fill this address (for example a country the field does not accept, or a place with no street address); tells the person to enter it below',\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_ATTRIBUTION,\n    kind: LabelKind.ARIA,\n    purpose: 'Sentence read by screen readers beside the address suggestions, naming the service they come from (the service\\'s own mark is shown visually, untranslated)',\n    params: [{ key: 'mark', meaning: \"The service's own required attribution text, for example Google Maps; a trademark, reproduced exactly and never translated\" }],\n    notes: ['Keep {{mark}} exactly as given; do not translate, quote or restyle it.'],\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_CONSENT_REQUIRED,\n    kind: LabelKind.MESSAGE,\n    purpose: 'Status shown when the address search service can only be used after the person agrees to some data uses; names the service and the uses',\n    params: [\n      { key: 'provider', meaning: 'Name of the address search service' },\n      { key: 'purposes', meaning: 'Comma-separated names of the data uses the person has not agreed to' },\n    ],\n  },\n  {\n    ref: FormFieldAddressLookupLabel.LOOKUP_CONSENT_GRANT,\n    kind: LabelKind.BUTTON,\n    purpose: 'Button that records the person\\'s agreement to exactly the listed data uses, so the address search can load',\n    params: [{ key: 'purposes', meaning: 'Comma-separated names of the data uses being agreed to' }],\n  },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, LowLevelFormFieldAddressLabels);\n"]}

package/dist/esm/components/form/fields/form-field-file.d.ts

@@ -28,18 +28,6 @@ export type FormFieldFileRef = HTMLDivElement;
  * - Upload cancellation support
  */
 export declare const FormFieldFile_Preset_Default: React.ForwardRefExoticComponent<FormFieldFilePresetProps & React.RefAttributes<HTMLDivElement>>;
-/**
- * Schema-aware FormFieldFile component.
- *
- * This wrapper sits between the generic FormField orchestrator and the preset
- * component. It is the proper boundary for injecting engine-level concerns:
- * - Authenticated HTTP operations (upload, metadata, delete) via httpClient
- * - Component preset resolution via the registry
- *
- * The preset component (presets-components) never imports the HTTP client directly,
- * maintaining separation of concerns. The generic FormField never deals with
- * file-specific HTTP concerns.
- */
 export declare const FormFieldFile: React.ForwardRefExoticComponent<Omit<FormFieldFilePresetProps, "httpOperations"> & {
     httpOperations?: FileHttpOperations;
 } & ComponentPresetProps & React.RefAttributes<HTMLDivElement>>;

package/dist/esm/components/form/fields/form-field-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-file.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-file.tsx"],"names":[],"mappings":"AACA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAUhH,OAAO,EAIL,SAAS,EAIT,kBAAkB,EAOnB,MAAM,0BAA0B,CAAA;AAWjC,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC7G,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,kBAAkB,CAAA;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAAG;IAClF,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC,GAAG,oBAAoB,CAAA;AAExB,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AA6F7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,iGAk9CvC,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;qBA5kDP,kBAAkB;+DA6nDnC,CAAA"}
+{"version":3,"file":"form-field-file.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-file.tsx"],"names":[],"mappings":"AACA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAUhH,OAAO,EAIL,SAAS,EAIT,kBAAkB,EAOnB,MAAM,0BAA0B,CAAA;AAajC,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC7G,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,kBAAkB,CAAA;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAAG;IAClF,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC,GAAG,oBAAoB,CAAA;AAExB,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AA8F7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,iGAy+CvC,CAAA;AAqBF,eAAO,MAAM,aAAa;qBA1mDP,kBAAkB;+DA2pDnC,CAAA"}

package/dist/esm/components/form/fields/form-field-file.js

@@ -18,6 +18,8 @@ import { resolveFormFieldFileProviderConstraints } from './form-field-file-provi
 import { describeAcceptedFileKinds } from './accepted-file-kinds-description.frontend.utils.js';
 import { ProviderFilePickerHost } from '../../../core/external-providers/ProviderFilePickerHost.js';
 import { ProviderFrontendSelectionDelivery } from '@wildo-ai/saas-models/public-runtime';
+import { CoreResourceType, UserPrivacySchema } from '@wildo-ai/saas-models';
+import { getZodObjectShape } from '@wildo-ai/zod-decorators';
 import { ImageCrop } from '../../../components/form/controls/file/image-crop.js';
 import { canExportWithinAllowedMimeTypes, isCroppableRasterImageFile } from '../../../components/form/controls/file/image-crop.frontend.utils.js';
 /** Type guard to check if value is a single file */
@@ -60,12 +62,13 @@ function hasActionableSingleFileEndpoint(endpoints, currentFileId) {
 function hasActionableMultipleFileEndpoint(endpoints) {
     return Boolean(endpoints.upload);
 }
-function getNeutralFileAttachmentLabel(filename, t) {
+function getNeutralFileAttachmentLabel(filename, fileAttachedLabel) {
     if (filename && filename.trim() !== '') {
         return filename;
     }
     // Do not expose internal file ids in fallback UI when metadata is unavailable.
-    return t('File attached') ?? 'File attached';
+    // The words are the component's `file_attached` label, resolved by the caller.
+    return fileAttachedLabel;
 }
 function getSafeFileMutationErrorMessage(fallbackMessage, _err) {
     return _err instanceof FileReadinessError ? _err.message : fallbackMessage;
@@ -82,9 +85,10 @@ function getSafeFileMutationErrorMessage(fallbackMessage, _err) {
  * - Upload cancellation support
  */
 export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, value: controlledValue, onChange, onBlur, defaultValue, disabled = false, readOnly, className, validationMode: validationModeProp, endpoints, uploadButtonText, replaceButtonText, onValidationError, required, httpOperations, }, ref) => {
-    const { t, tErrorValidation, tComponent, isReady } = useI18n({
+    const { t, tErrorValidation, tComponent, tResourceFieldEnumValue, isReady } = useI18n({
         component: FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE,
-        keys: ['errors_validation'],
+        // `system_enums` carries the consent purposes' words, shown when a provider waits on consent (#1702).
+        keys: ['errors_validation', 'system_enums'],
     });
     const { frontendProviderRegistry } = useApplication();
     const { renderIcon } = useIconRegistry();
@@ -95,7 +99,11 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
     const dragDropLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'drag_and_drop');
     const removeLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'remove');
     const uploadFailedMessage = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'upload_failed');
-    const metadataLoadFailedMessage = t('Unable to load file details') ?? 'Unable to load file details';
+    // Also an equality sentinel below (`current === metadataLoadFailedMessage`): the comparison is on
+    // the RESOLVED words, which is what `internalError` holds, never on the key.
+    const metadataLoadFailedMessage = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'metadata_load_failed');
+    const uploadsUnavailableMessage = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'uploads_unavailable');
+    const fileAttachedLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'file_attached');
     // Get file metadata from schema
     const fileSchemaMetadata = getFileMetadata(schema);
     // The FIELD's own constraints. A provider's declared limits are laid under
@@ -343,7 +351,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
         const generation = readinessGeneration.current;
         const uploadUrl = resolveSingleFileUploadUrl(endpoints, currentFileId);
         if (!uploadUrl) {
-            setInternalError(t('File uploads are unavailable for this field') ?? 'File uploads are unavailable for this field');
+            setInternalError(uploadsUnavailableMessage);
             return;
         }
         // Validate first
@@ -417,14 +425,14 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
             setUploadingFiles(previous => { const next = new Map(previous); next.delete(tempId); return next; });
             setUploadProgress(0);
         }
-    }, [currentFileId, endpoints, isControlled, onChange, t, validateFile, validationMode, schema, tErrorValidation, uploadSingleFile, cancelReadiness, onValidationError, processingMessage, uploadFailedMessage]);
+    }, [currentFileId, endpoints, isControlled, onChange, uploadsUnavailableMessage, validateFile, validationMode, schema, tErrorValidation, uploadSingleFile, cancelReadiness, onValidationError, processingMessage, uploadFailedMessage]);
     // ==========================================================================
     // UPLOAD HANDLERS — multiple mode
     // ==========================================================================
     const handleMultipleFilesUpload = React.useCallback(async (files) => {
         const generation = readinessGeneration.current;
         if (!hasActionableMultipleFileEndpoint(endpoints)) {
-            setInternalError(t('File uploads are unavailable for this field') ?? 'File uploads are unavailable for this field');
+            setInternalError(uploadsUnavailableMessage);
             return;
         }
         // Use ref to get latest file IDs — prevents stale closure when batches overlap.
@@ -560,7 +568,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
             }
             return next;
         });
-    }, [endpoints, isControlled, maxFiles, onChange, tComponent, uploadSingleFile, validateFile, uploadFailedMessage, onValidationError, processingMessage]);
+    }, [endpoints, isControlled, maxFiles, onChange, tComponent, uploadSingleFile, validateFile, uploadFailedMessage, uploadsUnavailableMessage, onValidationError, processingMessage]);
     // ==========================================================================
     // CROP STEP — aspect-ratio-constrained image fields
     // ==========================================================================
@@ -657,7 +665,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
         const toLink = isMultiple ? selections : selections.slice(0, 1);
         const uploadUrl = isMultiple ? endpoints.upload : resolveSingleFileUploadUrl(endpoints, currentFileId);
         if (!uploadUrl) {
-            setInternalError(t('File uploads are unavailable for this field') ?? 'File uploads are unavailable for this field');
+            setInternalError(uploadsUnavailableMessage);
             return;
         }
         onValidationError?.(processingMessage);
@@ -709,7 +717,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
             const failure = results.find(result => result.status === 'rejected');
             setInternalError(getSafeFileMutationErrorMessage(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_link_failed'), failure?.status === 'rejected' ? failure.reason : undefined));
         }
-    }, [currentFileId, endpoints, httpOperations, isControlled, isMultiple, onChange, t, tComponent, admitUploadResult, cancelReadiness, onValidationError, processingMessage, unverifiedMessage]);
+    }, [currentFileId, endpoints, httpOperations, isControlled, isMultiple, onChange, uploadsUnavailableMessage, tComponent, admitUploadResult, cancelReadiness, onValidationError, processingMessage, unverifiedMessage]);
     const handleProviderSelections = React.useCallback(async (providerRef, selections) => {
         if (!isMultiple)
             cancelReadiness();
@@ -942,7 +950,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
     // ==========================================================================
     // RENDER — File info line (filename, size, extension — shared)
     // ==========================================================================
-    const renderFileInfo = (fileId, meta, compact = false) => (_jsxs("div", { className: cn("min-w-0", compact ? "" : "flex-1"), children: [_jsx("div", { className: "flex items-center gap-element", children: meta?.url ? (_jsx("a", { href: meta.url, target: "_blank", rel: "noopener noreferrer", className: cn("font-medium text-primary hover:underline truncate", compact && "text-sm"), children: meta.filename })) : (_jsx("span", { className: cn("font-medium truncate", compact && "text-sm"), children: getNeutralFileAttachmentLabel(meta?.filename, t) })) }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [meta?.size !== undefined && (_jsx("span", { children: formatFileSize(meta.size) })), meta?.mimeType && (_jsx("span", { className: "uppercase", children: meta.extension || meta.mimeType.split('/').pop() })), meta?.width && meta?.height && (_jsxs("span", { children: [meta.width, "\u00D7", meta.height] }))] })] }));
+    const renderFileInfo = (fileId, meta, compact = false) => (_jsxs("div", { className: cn("min-w-0", compact ? "" : "flex-1"), children: [_jsx("div", { className: "flex items-center gap-element", children: meta?.url ? (_jsx("a", { href: meta.url, target: "_blank", rel: "noopener noreferrer", className: cn("font-medium text-primary hover:underline truncate", compact && "text-sm"), children: meta.filename })) : (_jsx("span", { className: cn("font-medium truncate", compact && "text-sm"), children: getNeutralFileAttachmentLabel(meta?.filename, fileAttachedLabel) })) }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [meta?.size !== undefined && (_jsx("span", { children: formatFileSize(meta.size) })), meta?.mimeType && (_jsx("span", { className: "uppercase", children: meta.extension || meta.mimeType.split('/').pop() })), meta?.width && meta?.height && (_jsxs("span", { children: [meta.width, "\u00D7", meta.height] }))] })] }));
     // ==========================================================================
     // RENDER — Nature-specific previews
     // ==========================================================================
@@ -1091,7 +1099,15 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
      * name is an i18n KEY: the host cannot resolve it without depending on the
      * i18n service, and this field already has one.
      */
-    const renderProviderPickers = () => (_jsx(ProviderFilePickerHost, { multiple: isMultiple, constraints: providerConstraints, acceptedStorages: fileSchemaMetadata?.storageAccepted, onSelect: handleProviderSelections, onProviderFailure: handleProviderFailure, renderChooser: ({ choices, chosen, choose }) => (_jsx("div", { role: "group", className: "flex flex-wrap gap-item-xs mt-element", children: choices.map((choice) => (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE, "aria-pressed": choice.providerRef === chosen, onClick: () => choose(choice.providerRef), children: t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef }, choice.providerRef))) })) }));
+    const renderProviderPickers = () => (_jsx(ProviderFilePickerHost, { multiple: isMultiple, constraints: providerConstraints, acceptedStorages: fileSchemaMetadata?.storageAccepted, onSelect: handleProviderSelections, onProviderFailure: handleProviderFailure, renderConsentRequired: ({ choice, missingPurposes, grant }) => {
+            // Purpose names are the `ConsentPurpose` vocabulary's own words, read through the field that stores
+            // a person's grant — the same words the consent gate and the preferences page show (#1702).
+            const purposes = missingPurposes
+                .map((purpose) => tResourceFieldEnumValue(CoreResourceType.USER_SELF_PREFERENCES, 'privacy.consentedPurposes', purpose, CONSENTED_PURPOSES_FIELD_SCHEMA))
+                .join(', ');
+            const provider = t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef;
+            return (_jsxs("div", { role: "status", className: "flex flex-wrap items-center gap-item-xs mt-element text-sm text-muted-foreground", children: [_jsx("span", { children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_consent_required', { provider, purposes }) }), grant === undefined ? null : (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.OUTLINE, onClick: () => void grant(), children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_consent_grant', { purposes }) }))] }));
+        }, renderChooser: ({ choices, chosen, choose }) => (_jsx("div", { role: "group", className: "flex flex-wrap gap-item-xs mt-element", children: choices.map((choice) => (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE, "aria-pressed": choice.providerRef === chosen, onClick: () => choose(choice.providerRef), children: t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef }, choice.providerRef))) })) }));
     if (!isReady)
         return null;
     return (_jsxs("div", { ref: ref, className: className, children: [(internalError ?? readinessError) && _jsx("p", { role: "status", className: "text-sm text-muted-foreground", children: internalError ?? readinessError }), pendingReadiness.size > 0 && _jsx(Button, { type: "button", onClick: cancelReadiness, children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'cancel') }), _jsx("input", { ref: fileInputRef, type: "file", accept: accept, multiple: isMultiple, onChange: handleFileChange, className: "hidden", disabled: isUploadInteractionDisabled }), isMultiple ? (
@@ -1115,6 +1131,11 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
  * maintaining separation of concerns. The generic FormField never deals with
  * file-specific HTTP concerns.
  */
+/**
+ * The self-preferences field that stores a person's granted consent purposes. Handed to the enum-word lookup
+ * because a value is worded only through the enum its FIELD declares (#966) — here `ConsentPurpose`.
+ */
+const CONSENTED_PURPOSES_FIELD_SCHEMA = getZodObjectShape(UserPrivacySchema).consentedPurposes;
 export const FormFieldFile = forwardRef(({ preset = CorePresetNames.DEFAULT, httpOperations: externalHttpOperations, ...props }, ref) => {
     const { httpClient } = useApplication();
     const httpOperations = useMemo(() => {