@vtex/faststore 0.0.4 → 0.0.6

package/dist/matter/shipping-address/country-descriptors.js.map

@@ -1 +1 @@
-{"version":3,"file":"country-descriptors.js","names":[],"sources":["../../../src/matter/shipping-address/country-descriptors.ts"],"sourcesContent":["/**\n * Country-adaptive shipping address form descriptors.\n *\n * Each descriptor declares the form shape (field set, order, and labels) for a specific country.\n * Descriptors are data only: no validation metadata, no required flags, no format patterns.\n * Country adaptation is data-driven; adding a country is a data-only change (a new descriptor entry).\n *\n * Canonical field names must be shared/consistent across descriptors for fields both countries have\n * (recipientName, postalCode, street, number, complement, city, state), so that switching countries\n * preserves shared field values in the batched draft state (Decision 1/Invariant).\n *\n * Per Decision 2, this narrows the RFC's descriptor scope to form shape only: the only client-enforced\n * content rule is the non-blank recipient name. Postal-code format, per-country required enforcement,\n * and per-field blur validation are deferred to VTEX (v1 surfaces rejections as UPSTREAM_ERROR) and\n * a future @vtex/country-forms adoption.\n */\n\n/**\n * Describes a single form field within a country descriptor.\n *\n * @property name - Canonical field name (e.g., \"recipientName\", \"street\", \"neighborhood\").\n *                  Shared field names across descriptors enable draft state preservation on country switch.\n * @property label - Human-readable label for the field. Named `label` (not a key) to allow future\n *                   swapping with i18n keys once the codebase adopts an i18n layer.\n */\nexport type FieldDescriptor = Readonly<{\n  name: string;\n  label: string;\n}>;\n\n/**\n * Describes the form shape for a single country.\n *\n * @property iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\"). Must be a valid 3-letter code\n *                 matching the Address.country field type (plain String!, ISO alpha-3 by convention).\n * @property label - Human-readable country name for the country selector (e.g., \"Brazil\", \"United States\").\n *                   Named `label` (not a key) to allow future swapping with i18n keys.\n * @property fields - Ordered field set for this country. Order defines the visual order in the form.\n *                    Only fields this country uses are listed; absent fields are not rendered.\n */\nexport type CountryDescriptor = Readonly<{\n  iso: string;\n  label: string;\n  fields: readonly FieldDescriptor[];\n}>;\n\n/**\n * Brazil (BRA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. neighborhood — bairro (BR-specific, not in US form)\n * 6. city — city name\n * 7. state — state/UF code (canonical name shared with US, though US calls it state abbreviation)\n * 8. postalCode — CEP format (validation deferred to VTEX in v1)\n */\nconst brDescriptor: CountryDescriptor = {\n  iso: 'BRA',\n  label: 'Brasil',\n  fields: [\n    { name: 'recipientName', label: 'nome do destinatário' },\n    { name: 'street', label: 'rua' },\n    { name: 'number', label: 'número' },\n    { name: 'complement', label: 'complemento (opcional)' },\n    { name: 'neighborhood', label: 'bairro' },\n    { name: 'city', label: 'cidade' },\n    { name: 'state', label: 'estado' },\n    { name: 'postalCode', label: 'cep' },\n  ],\n};\n\n/**\n * United States (USA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. city — city name\n * 6. state — state abbreviation (canonical name shared with BR for draft preservation)\n * 7. postalCode — ZIP/ZIP+4 format (validation deferred to VTEX in v1)\n *\n * Note: neighborhood is not included in the US v1 form. If the shopper switches from BR to US,\n * the neighborhood value is retained in the draft but hidden (descriptor controls visibility only);\n * switching back to BR resurfaces it.\n */\nconst usaDescriptor: CountryDescriptor = {\n  iso: 'USA',\n  label: 'Estados Unidos',\n  fields: [\n    { name: 'recipientName', label: 'nome do destinatário' },\n    { name: 'street', label: 'rua' },\n    { name: 'number', label: 'número' },\n    { name: 'complement', label: 'complemento (opcional)' },\n    { name: 'city', label: 'cidade' },\n    { name: 'state', label: 'estado' },\n    { name: 'postalCode', label: 'código postal' },\n  ],\n};\n\n/**\n * All available country descriptors, keyed by ISO alpha-3 code.\n *\n * The country selector lists only countries with a descriptor; a descriptor-less country is unreachable.\n * Adding a country is a data-only change: add a new CountryDescriptor entry here.\n */\nexport const countryDescriptors: Readonly<Record<string, CountryDescriptor>> = {\n  BRA: brDescriptor,\n  USA: usaDescriptor,\n};\n\n/**\n * Returns an ordered list of available country ISO codes (those with a descriptor).\n *\n * @returns ISO alpha-3 codes of all implemented countries, in definition order.\n */\nexport function getAvailableCountries(): readonly string[] {\n  return Object.keys(countryDescriptors);\n}\n\n/**\n * Retrieves the descriptor for a given country.\n *\n * @param iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\")\n * @returns The CountryDescriptor for the country, or undefined if not implemented.\n */\nexport function getCountryDescriptor(iso: string): CountryDescriptor | undefined {\n  return countryDescriptors[iso];\n}\n"],"mappings":";;;;;;AA8GA,MAAa,qBAAkE;CAC7E,KAAK;EAnDL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;GAAuB;GACvD;IAAE,MAAM;IAAU,OAAO;GAAM;GAC/B;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAyB;GACtD;IAAE,MAAM;IAAgB,OAAO;GAAS;GACxC;IAAE,MAAM;IAAQ,OAAO;GAAS;GAChC;IAAE,MAAM;IAAS,OAAO;GAAS;GACjC;IAAE,MAAM;IAAc,OAAO;GAAM;EACrC;CAwCK;CACL,KAAK;EArBL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;GAAuB;GACvD;IAAE,MAAM;IAAU,OAAO;GAAM;GAC/B;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAyB;GACtD;IAAE,MAAM;IAAQ,OAAO;GAAS;GAChC;IAAE,MAAM;IAAS,OAAO;GAAS;GACjC;IAAE,MAAM;IAAc,OAAO;GAAgB;EAC/C;CAWK;AACP;;;;;;AAOA,SAAgB,wBAA2C;CACzD,OAAO,OAAO,KAAK,kBAAkB;AACvC;;;;;;;AAQA,SAAgB,qBAAqB,KAA4C;CAC/E,OAAO,mBAAmB;AAC5B"}
+{"version":3,"file":"country-descriptors.js","names":[],"sources":["../../../src/matter/shipping-address/country-descriptors.ts"],"sourcesContent":["/**\n * Country-adaptive shipping address form descriptors.\n *\n * Each descriptor declares the form shape (field set, order, and labels) for a specific country.\n * Descriptors are primarily data — field set, order, and labels — but a `FieldDescriptor` may also\n * carry `required` and `rule`, the two validation facts a country varies. `ShippingAddressFieldset`\n * is the only reader of either (specs/shipping-address-fieldset.md, Decision 3): a field whose\n * descriptor entry is absent is never rendered, so it can carry no requiredness at all.\n * Country adaptation is data-driven; adding a country is a data-only change (a new descriptor entry).\n *\n * Canonical field names must be shared/consistent across descriptors for fields both countries have\n * (recipientName, postalCode, street, number, complement, city, state), so that switching countries\n * preserves shared field values in the batched draft state (Decision 1/Invariant).\n *\n * Per Decision 2, this narrows the RFC's descriptor scope to form shape plus two per-field validation\n * facts: the non-blank recipient name and, per country, the postal code's format. Both descriptors'\n * `postalCode` entry carries a `pattern` rule matching that country's CEP or ZIP shape; every other\n * field's `rule` stays undefined. There is no server-side postal-code validation to fall back on:\n * `shippingAddressUpdate` types `postalCode` as a plain `z.string()`, forwards it verbatim with\n * `clearAddressIfPostalCodeNotFound: false`, and has no try/catch around the upstream call, so a\n * malformed value still returns HTTP 200 with an empty `userErrors` array. This client-side rule is\n * the only postal-code guard in the system today; per-field blur validation and a future\n * @vtex/country-forms adoption remain deferred.\n */\n\nimport type { FieldRule } from '../../particles/field/field.js';\n\n/**\n * Describes a single form field within a country descriptor.\n *\n * @property name - Canonical field name (e.g., \"recipientName\", \"street\", \"neighborhood\").\n *                  Shared field names across descriptors enable draft state preservation on country switch.\n * @property label - Human-readable label for the field. Named `label` (not a key) to allow future\n *                   swapping with i18n keys once the codebase adopts an i18n layer.\n */\nexport type FieldDescriptor = Readonly<{\n  name: string;\n  label: string;\n  /**\n   * Whether the fieldset requires a non-blank value. Read only by ShippingAddressFieldset, which\n   * turns it into the field contract's `rule`. A field whose descriptor entry is absent is not\n   * rendered, so it can carry no requiredness at all — that is the point (Decision 3).\n   */\n  required?: boolean;\n  /**\n   * Extra react-hook-form rules for this field in this country: pattern, minLength, and so on.\n   * Merged under the generated `required`. Only `postalCode` carries one today.\n   */\n  rule?: FieldRule;\n}>;\n\n/**\n * Describes the form shape for a single country.\n *\n * @property iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\"). Must be a valid 3-letter code\n *                 matching the Address.country field type (plain String!, ISO alpha-3 by convention).\n * @property label - Human-readable country name for the country selector (e.g., \"Brazil\", \"United States\").\n *                   Named `label` (not a key) to allow future swapping with i18n keys.\n * @property fields - Ordered field set for this country. Order defines the visual order in the form.\n *                    Only fields this country uses are listed; absent fields are not rendered.\n */\nexport type CountryDescriptor = Readonly<{\n  iso: string;\n  label: string;\n  fields: readonly FieldDescriptor[];\n}>;\n\n/**\n * Brazil (BRA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. neighborhood — bairro (BR-specific, not in US form)\n * 6. city — city name\n * 7. state — state/UF code (canonical name shared with US, though US calls it state abbreviation)\n * 8. postalCode — CEP format, client-validated via `rule` (8 digits, hyphen after the fifth optional)\n */\nconst brDescriptor: CountryDescriptor = {\n  iso: 'BRA',\n  label: 'Brasil',\n  fields: [\n    { name: 'recipientName', label: 'nome do destinatário', required: true },\n    { name: 'street', label: 'rua' },\n    { name: 'number', label: 'número' },\n    { name: 'complement', label: 'complemento (opcional)' },\n    { name: 'neighborhood', label: 'bairro' },\n    { name: 'city', label: 'cidade' },\n    { name: 'state', label: 'estado' },\n    {\n      name: 'postalCode',\n      label: 'cep',\n      rule: { pattern: { value: /^\\d{5}-?\\d{3}$/, message: 'cep inválido' } },\n    },\n  ],\n};\n\n/**\n * United States (USA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. city — city name\n * 6. state — state abbreviation (canonical name shared with BR for draft preservation)\n * 7. postalCode — ZIP/ZIP+4 format, client-validated via `rule` (5 digits, optional 4-digit\n *    extension, hyphen before it optional either way — accepts both `02101-1234` and `021011234`)\n *\n * Note: neighborhood is not included in the US v1 form. If the shopper switches from BR to US,\n * the neighborhood value is retained in the draft but hidden (descriptor controls visibility only);\n * switching back to BR resurfaces it.\n */\nconst usaDescriptor: CountryDescriptor = {\n  iso: 'USA',\n  label: 'United States',\n  fields: [\n    { name: 'recipientName', label: 'recipient name', required: true },\n    { name: 'street', label: 'street' },\n    { name: 'number', label: 'number' },\n    { name: 'complement', label: 'apartment, suite, etc. (optional)' },\n    { name: 'city', label: 'city' },\n    { name: 'state', label: 'state' },\n    {\n      name: 'postalCode',\n      label: 'zip code',\n      rule: { pattern: { value: /^\\d{5}(-?\\d{4})?$/, message: 'invalid zip code' } },\n    },\n  ],\n};\n\n/**\n * All available country descriptors, keyed by ISO alpha-3 code.\n *\n * The country selector lists only countries with a descriptor; a descriptor-less country is unreachable.\n * Adding a country is a data-only change: add a new CountryDescriptor entry here.\n */\nexport const countryDescriptors: Readonly<Record<string, CountryDescriptor>> = {\n  BRA: brDescriptor,\n  USA: usaDescriptor,\n};\n\n/**\n * Returns an ordered list of available country ISO codes (those with a descriptor).\n *\n * @returns ISO alpha-3 codes of all implemented countries, in definition order.\n */\nexport function getAvailableCountries(): readonly string[] {\n  return Object.keys(countryDescriptors);\n}\n\n/**\n * Retrieves the descriptor for a given country.\n *\n * @param iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\")\n * @returns The CountryDescriptor for the country, or undefined if not implemented.\n */\nexport function getCountryDescriptor(iso: string): CountryDescriptor | undefined {\n  return countryDescriptors[iso];\n}\n"],"mappings":";;;;;;AA4IA,MAAa,qBAAkE;CAC7E,KAAK;EA5DL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;IAAwB,UAAU;GAAK;GACvE;IAAE,MAAM;IAAU,OAAO;GAAM;GAC/B;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAyB;GACtD;IAAE,MAAM;IAAgB,OAAO;GAAS;GACxC;IAAE,MAAM;IAAQ,OAAO;GAAS;GAChC;IAAE,MAAM;IAAS,OAAO;GAAS;GACjC;IACE,MAAM;IACN,OAAO;IACP,MAAM,EAAE,SAAS;KAAE,OAAO;KAAkB,SAAS;IAAe,EAAE;GACxE;EACF;CA6CK;CACL,KAAK;EAzBL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;IAAkB,UAAU;GAAK;GACjE;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAoC;GACjE;IAAE,MAAM;IAAQ,OAAO;GAAO;GAC9B;IAAE,MAAM;IAAS,OAAO;GAAQ;GAChC;IACE,MAAM;IACN,OAAO;IACP,MAAM,EAAE,SAAS;KAAE,OAAO;KAAqB,SAAS;IAAmB,EAAE;GAC/E;EACF;CAWK;AACP;;;;;;AAOA,SAAgB,wBAA2C;CACzD,OAAO,OAAO,KAAK,kBAAkB;AACvC;;;;;;;AAQA,SAAgB,qBAAqB,KAA4C;CAC/E,OAAO,mBAAmB;AAC5B"}

package/dist/matter/shipping-address/shipping-address.d.ts

@@ -1,16 +1,17 @@
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { ComponentActions } from "../../sdk/actions/types.js";
-import { ReactNode } from "react";
+import { ComponentPropsWithRef, ReactNode } from "react";
 //#region src/matter/shipping-address/shipping-address.d.ts
 /**
- * The `$data` slice forwarded by the reactive runtime. `ShippingAddressData` selects two root
- * fields (`shipping`, `clientProfile`), so the compiler composes them via
+ * The `$data` slice forwarded to `ShippingAddressFieldset` by the reactive runtime. Selects two
+ * root fields (`shipping`, `clientProfile`), so the compiler composes them via
  * `MultipleReactiveDataProvider`, which keys each entity's resolved slice by its own root field —
  * `$data` is `{ shipping: {...}, clientProfile: {...} }`, not a flat/unwrapped shape (that unwrapped
  * shape only applies to single-root-field fragments, e.g. CartTotalizerRoot's `$data.totalizers`).
+ * Carries no `savedAddresses` — the fieldset has no saved-address UI of its own (Decision 1).
  */
-export type ShippingAddressData = {
+export type ShippingAddressFieldsetData = {
   shipping?: {
     address?: {
       id?: string | null;
@@ -24,106 +25,102 @@ export type ShippingAddressData = {
       city?: string | null;
       state?: string | null;
     } | null;
-    savedAddresses?: Array<{
-      id?: string | null;
-      recipientName?: string | null;
-      postalCode?: string | null;
-      country?: string | null;
-      street?: string | null;
-      number?: string | null;
-      complement?: string | null;
-      neighborhood?: string | null;
-      city?: string | null;
-      state?: string | null;
-    }>;
   } | null;
   clientProfile?: {
     firstName?: string | null;
     lastName?: string | null;
   } | null;
 } | null;
-export type ShippingAddressRootProps = {
-  /** Default country (ISO alpha-3) when no address exists. */
+export type ShippingAddressFieldsetProps = {
+  /** Country used when the stored address has none. */
   defaultCountry?: string;
+  /** Placeholder rows the loading skeleton draws. Set it to the number of Controls composed here. */
+  skeletonCount?: number;
+  /** Announced politely while the address resolves. Blank means no announcement. */
+  loadingLabel?: string;
+  /** Announced politely once the Controls mount. Blank means no announcement. */
+  loadedLabel?: string;
+  /** Accessible name of the `<fieldset>` group. Blank means no name is exposed. */
+  groupLabel?: string;
   className?: string;
   children?: ReactNode;
-  /** `ShippingAddressData` forwarded by the reactive runtime. */
-  $data?: ShippingAddressData;
+  /** `ShippingAddressFieldsetData` forwarded by the reactive runtime. */
+  $data?: ShippingAddressFieldsetData;
   /** Compiler-injected action surface; carries `shipping.setAddress`. */
   $actions?: ComponentActions;
 };
 export type ShippingAddressStreetControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
+  label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
 export type ShippingAddressNumberControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
+  label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
 export type ShippingAddressCityControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
+  label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
 export type ShippingAddressStateControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
+  label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
 export type ShippingAddressPostalCodeControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
+  label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
 export type ShippingAddressComplementControlProps = {
   className?: string;
-};
-export type ShippingAddressNeighborhoodControlProps = {
-  className?: string;
-};
-export type ShippingAddressCountryControlProps = {
-  className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
   label?: string;
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
+  children?: ReactNode;
 };
-export type ShippingAddressRecipientNameControlProps = {
-  className?: string;
-};
-export type ShippingAddressSavedListProps = {
-  className?: string;
-};
-export type ShippingAddressSavedOptionProps = {
-  id: string;
-  className?: string;
-};
-export type ShippingAddressSubmitProps = {
+export type ShippingAddressNeighborhoodControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
   label?: string;
-  pendingLabel?: string;
-};
-export type ShippingAddressErrorProps = {
-  className?: string;
-};
-export type ShippingAddressSavedAddressDrawerControllerProps = {
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
   children?: ReactNode;
 };
-export type ShippingAddressSavedAddressSubmitProps = {
+export type ShippingAddressCountryControlProps = {
   className?: string;
   label?: string;
-  pendingLabel?: string;
-};
-export type ShippingAddressSelectedSummaryProps = {
-  className?: string;
-  /**
-   * The lines to render, in order — typically the `AddressSummaryRecipient` / `Street` / `Locality`
-   * leaves. Defaults to recipient, street, locality when omitted.
-   */
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, FieldSelect.Root, Field.Error. */
   children?: ReactNode;
 };
-export type ShippingAddressEditControllerProps = {
-  children?: ReactNode;
-};
-export type ShippingAddressSectionPanelProps = {
-  children?: ReactNode;
-};
-export type ShippingAddressEditButtonProps = {
+export type ShippingAddressRecipientNameControlProps = {
   className?: string;
+  /** Overrides the descriptor's label. Absence means the platform's value. */
   label?: string;
-  /** Compose custom button content (e.g. an Icon plus text); falls back to `label`. */
+  placeholder?: string;
+  /** Recomposes the anatomy. Absence renders Field.Label, Field.Control, Field.Error. */
   children?: ReactNode;
 };
-export declare const ShippingAddressRootDefinition: ComponentDefinition<ShippingAddressRootProps>;
+export declare const ShippingAddressFieldsetDefinition: ComponentDefinition<ShippingAddressFieldsetProps>;
 export declare const ShippingAddressRecipientNameControlDefinition: ComponentDefinition<ShippingAddressRecipientNameControlProps>;
 export declare const ShippingAddressStreetControlDefinition: ComponentDefinition<ShippingAddressStreetControlProps>;
 export declare const ShippingAddressNumberControlDefinition: ComponentDefinition<ShippingAddressNumberControlProps>;
@@ -133,110 +130,76 @@ export declare const ShippingAddressPostalCodeControlDefinition: ComponentDefini
 export declare const ShippingAddressComplementControlDefinition: ComponentDefinition<ShippingAddressComplementControlProps>;
 export declare const ShippingAddressNeighborhoodControlDefinition: ComponentDefinition<ShippingAddressNeighborhoodControlProps>;
 export declare const ShippingAddressCountryControlDefinition: ComponentDefinition<ShippingAddressCountryControlProps>;
-export declare const ShippingAddressSavedListDefinition: ComponentDefinition<ShippingAddressSavedListProps>;
-export declare const ShippingAddressSavedOptionDefinition: ComponentDefinition<ShippingAddressSavedOptionProps>;
-export declare const ShippingAddressSubmitDefinition: ComponentDefinition<ShippingAddressSubmitProps>;
-export declare const ShippingAddressErrorDefinition: ComponentDefinition<ShippingAddressErrorProps>;
-export declare const ShippingAddressSavedAddressDrawerControllerDefinition: ComponentDefinition<ShippingAddressSavedAddressDrawerControllerProps>;
-export declare const ShippingAddressSavedAddressSubmitDefinition: ComponentDefinition<ShippingAddressSavedAddressSubmitProps>;
-export declare const ShippingAddressSelectedSummaryDefinition: ComponentDefinition<ShippingAddressSelectedSummaryProps>;
-export declare const ShippingAddressEditControllerDefinition: ComponentDefinition<ShippingAddressEditControllerProps>;
-export declare const ShippingAddressSummaryViewDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
-export declare const ShippingAddressEditFormDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
-export declare const ShippingAddressEditButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
-export declare const ShippingAddressCancelButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
 /**
- * ShippingAddressRoot owns the batched form state, manages the current descriptor,
- * and provides context to child Controls. It handles submit dispatch and error tracking.
+ * ShippingAddressFieldset — this entity's root: same data, same action as a page-level submit
+ * would use, dispatched at form-submit time instead of through a button of its own. Registers one
+ * `FieldsetRegistration` with the enclosing `FormRoot` under the `shippingAddress` namespace,
+ * derives the active country descriptor from react-hook-form (Decision 2), and publishes each
+ * field's seed/rule/label through its own context so a bound Control never writes a validation
+ * expression. Renders no button and holds no draft of its own.
+ *
+ * Its controls mount only once the entity has resolved; until then the `Fieldset.Root` carries
+ * `-pending` and renders `ShippingAddressFieldsetSkeleton`. "Resolved" is two conditions, because
+ * `$data` alone cannot answer it: under the reactive runtime the slice is defined from the first
+ * render — `useReactiveEntity` hands down `fallbackData` while the cache read is incomplete — so an
+ * empty server answer looks exactly like a resolved one, and every control would mount seeded `''`
+ * before the shopper's stored address arrives. Each seed reaches react-hook-form as a field-level
+ * `defaultValue`; `useSeedAdoption` re-seeds a clean field with it on every render, but once the
+ * field turns dirty no later seed ever reaches it again (Decision 12). Mounting before the answer
+ * arrives would seed `''`: a shopper who starts typing before the real value lands makes the field
+ * dirty on that empty seed, permanently locking their saved address out of it, and even a shopper who
+ * does not type sees the field flash from `''` to the real data. `useReactiveDataSettled` supplies
+ * the missing half: the page query's own in-flight state, latched so it only ever goes pending →
+ * settled. The `$data === undefined` half still carries
+ * trees with no reactive root above them, where the slice arrives as a plain prop.
+ *
+ * Both ends of that wait are spoken: the fieldset carries `aria-busy` while it lasts and holds a
+ * polite live region that announces `loadingLabel` and then `loadedLabel`. Style the region
+ * `sr-only` — it is text meant for a screen reader, not for the page.
  */
-export declare function ShippingAddressRoot({ defaultCountry, className, children, $data: $dataProp, $actions: $actionsProp }: Readonly<ShippingAddressRootProps>): import("react/jsx-runtime").JSX.Element;
+export declare function ShippingAddressFieldset({ defaultCountry, skeletonCount, loadingLabel, loadedLabel, groupLabel, className, children, $data: $dataProp, $actions: $actionsProp }: ShippingAddressFieldsetProps): ReactNode;
+export declare namespace ShippingAddressFieldset {
+  var Skeleton: typeof ShippingAddressFieldsetSkeleton;
+}
 /**
- * RecipientNameControl — the only client-validated field (US-4, US-6).
+ * The loading state of the fieldset, rendered in place of the Controls until the entity resolves and
+ * declared as the definition's `skeleton`. Purely visual: the wait is spoken by the fieldset's own
+ * live region, so this is hidden from assistive technology rather than announced twice.
+ */
+export declare function ShippingAddressFieldsetSkeleton({ count, className, ...props }: ComponentPropsWithRef<'div'> & {
+  count?: number;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * RecipientNameControl — the only required field (US-4, US-6); the postal code is client-validated
+ * too, against the active country's format.
  * Pre-filled from clientProfile, editable, required.
  */
-export declare function ShippingAddressRecipientNameControl({ className }: ShippingAddressRecipientNameControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressRecipientNameControl({ className, label, placeholder, children }: ShippingAddressRecipientNameControlProps): ReactNode;
 /** StreetControl */
-export declare function ShippingAddressStreetControl({ className }: ShippingAddressStreetControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressStreetControl({ className, label, placeholder, children }: ShippingAddressStreetControlProps): ReactNode;
 /** NumberControl */
-export declare function ShippingAddressNumberControl({ className }: ShippingAddressNumberControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressNumberControl({ className, label, placeholder, children }: ShippingAddressNumberControlProps): ReactNode;
 /** CityControl */
-export declare function ShippingAddressCityControl({ className }: ShippingAddressCityControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressCityControl({ className, label, placeholder, children }: ShippingAddressCityControlProps): ReactNode;
 /** StateControl */
-export declare function ShippingAddressStateControl({ className }: ShippingAddressStateControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressStateControl({ className, label, placeholder, children }: ShippingAddressStateControlProps): ReactNode;
 /** PostalCodeControl */
-export declare function ShippingAddressPostalCodeControl({ className }: ShippingAddressPostalCodeControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressPostalCodeControl({ className, label, placeholder, children }: ShippingAddressPostalCodeControlProps): ReactNode;
 /** ComplementControl */
-export declare function ShippingAddressComplementControl({ className }: ShippingAddressComplementControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressComplementControl({ className, label, placeholder, children }: ShippingAddressComplementControlProps): ReactNode;
 /** NeighborhoodControl (BR-specific in v1) */
-export declare function ShippingAddressNeighborhoodControl({ className }: ShippingAddressNeighborhoodControlProps): import("react/jsx-runtime").JSX.Element | null;
-/** CountryControl — lists only countries with a descriptor (US-2, first criterion) */
-export declare function ShippingAddressCountryControl({ className, label }: ShippingAddressCountryControlProps): import("react/jsx-runtime").JSX.Element;
-/**
- * ShippingAddressSavedList — renders only when savedAddresses is non-empty (logged-in signal).
- */
-export declare function ShippingAddressSavedList({ className }: ShippingAddressSavedListProps): import("react/jsx-runtime").JSX.Element | null;
-/**
- * ShippingAddressSavedOption — selectable saved address; populates draft on selection.
- * Includes isCurrent visual variant to mark the address matching the current cart address (Decision 8).
- */
-export declare function ShippingAddressSavedOption({ id, className }: ShippingAddressSavedOptionProps): import("react/jsx-runtime").JSX.Element | null;
-/**
- * ShippingAddressSubmit — dispatches the batched submit; reflects pending state.
- */
-export declare function ShippingAddressSubmit({ className, label, pendingLabel }: ShippingAddressSubmitProps): import("react/jsx-runtime").JSX.Element;
-/**
- * ShippingAddressSavedAddressDrawerController — makes the wrapped DrawerRoot controlled by the
- * shipping-address context's savedAddressDrawerOpen state, and blocks dismissal (Escape, backdrop
- * click, close button) while drawerSubmitting is true by simply not forwarding the close request
- * to the setter. Mirrors CartOpenOnAdd's cloneElement mechanism. Expects a single DrawerRoot child.
- */
-export declare function ShippingAddressSavedAddressDrawerController({ children }: ShippingAddressSavedAddressDrawerControllerProps): ReactNode;
-/**
- * ShippingAddressSavedAddressSubmit — the drawer's "selecionar" submit button; independent
- * submitting state from the main form's Submit (Decision 7); no-ops when the selected saved
- * address is already the current one (Decision 8).
- */
-export declare function ShippingAddressSavedAddressSubmit({ className, label, pendingLabel }: ShippingAddressSavedAddressSubmitProps): import("react/jsx-runtime").JSX.Element;
-/**
- * ShippingAddressSelectedSummary — provides the current delivery address via AddressSummaryRoot's
- * context and renders it through AddressSummary. Composed lines go through that same wrapper rather
- * than replacing it, because AddressSummaryRoot renders no DOM and `className` would have nowhere to
- * land. Self-gating on currentAddress: renders null when there is none yet, rather than an empty
- * provider with nothing meaningful to show.
- */
-export declare function ShippingAddressSelectedSummary({ className, children }: ShippingAddressSelectedSummaryProps): import("react/jsx-runtime").JSX.Element | null;
-/**
- * ShippingAddressEditController — owns the view/edit mode. Defaults to 'view' when a current
- * address exists, 'edit' otherwise (derived reactively from currentAddressId, so it self-corrects
- * if the address arrives asynchronously after mount, same issue as the draft-sync effect above).
- * Once the shopper explicitly toggles (via ShippingAddressEditButton) or a submit succeeds, the
- * explicit mode takes over. Does not render any DOM itself; provides ShippingAddressSectionContext
- * to ShippingAddressSummaryView/ShippingAddressEditForm/ShippingAddressEditButton descendants.
- */
-export declare function ShippingAddressEditController({ children }: ShippingAddressEditControllerProps): import("react/jsx-runtime").JSX.Element;
-/** Renders its children only while the section shows the saved-address summary. */
-export declare function ShippingAddressSummaryView({ children }: ShippingAddressSectionPanelProps): import("react/jsx-runtime").JSX.Element | null;
-/** Renders its children only while the section shows the address form. */
-export declare function ShippingAddressEditForm({ children }: ShippingAddressSectionPanelProps): import("react/jsx-runtime").JSX.Element | null;
-/**
- * ShippingAddressEditButton — CTA that switches the mode to 'edit'. Has no knowledge of why the
- * mode might currently be 'view' (a current address, or a just-completed submit) — it only writes
- * the mode forward.
- */
-export declare function ShippingAddressEditButton({ className, label, children }: ShippingAddressEditButtonProps): import("react/jsx-runtime").JSX.Element;
-/**
- * ShippingAddressCancelButton — returns the section to its summary without writing. Without it a
- * shopper who opens the form can only leave through a successful `setAddress`, and blanking the
- * recipient disables Submit, which leaves the section stuck open over the summary it replaced.
- */
-export declare function ShippingAddressCancelButton({ className, label, children }: ShippingAddressEditButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ShippingAddressNeighborhoodControl({ className, label, placeholder, children }: ShippingAddressNeighborhoodControlProps): ReactNode;
 /**
- * ShippingAddressError — renders domain userErrors inline, or generic upstream error state.
+ * CountryControl — moves onto `FieldSelect` (Decision 8): the trigger resolves a country name from
+ * the field contract's `options`. Gated on `descriptor`, not on a per-field entry (country has
+ * none): a country with no descriptor renders no controls at all (Decision 3/4's "no entry, no
+ * control" applied to the field that selects the entry itself).
  */
-export declare function ShippingAddressError({ className }: ShippingAddressErrorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingAddressCountryControl({ className, label, placeholder, children }: ShippingAddressCountryControlProps): ReactNode;
 export declare const ShippingAddress: {
-  Root: typeof ShippingAddressRoot;
-  RootDefinition: ComponentDefinition<ShippingAddressRootProps>;
+  Fieldset: typeof ShippingAddressFieldset;
+  FieldsetDefinition: ComponentDefinition<ShippingAddressFieldsetProps>;
+  FieldsetSkeleton: typeof ShippingAddressFieldsetSkeleton;
   RecipientNameControl: typeof ShippingAddressRecipientNameControl;
   RecipientNameControlDefinition: ComponentDefinition<ShippingAddressRecipientNameControlProps>;
   StreetControl: typeof ShippingAddressStreetControl;
@@ -255,30 +218,6 @@ export declare const ShippingAddress: {
   NeighborhoodControlDefinition: ComponentDefinition<ShippingAddressNeighborhoodControlProps>;
   CountryControl: typeof ShippingAddressCountryControl;
   CountryControlDefinition: ComponentDefinition<ShippingAddressCountryControlProps>;
-  SavedList: typeof ShippingAddressSavedList;
-  SavedListDefinition: ComponentDefinition<ShippingAddressSavedListProps>;
-  SavedOption: typeof ShippingAddressSavedOption;
-  SavedOptionDefinition: ComponentDefinition<ShippingAddressSavedOptionProps>;
-  Submit: typeof ShippingAddressSubmit;
-  SubmitDefinition: ComponentDefinition<ShippingAddressSubmitProps>;
-  SavedAddressDrawerController: typeof ShippingAddressSavedAddressDrawerController;
-  SavedAddressDrawerControllerDefinition: ComponentDefinition<ShippingAddressSavedAddressDrawerControllerProps>;
-  SavedAddressSubmit: typeof ShippingAddressSavedAddressSubmit;
-  SavedAddressSubmitDefinition: ComponentDefinition<ShippingAddressSavedAddressSubmitProps>;
-  SelectedSummary: typeof ShippingAddressSelectedSummary;
-  SelectedSummaryDefinition: ComponentDefinition<ShippingAddressSelectedSummaryProps>;
-  EditController: typeof ShippingAddressEditController;
-  EditControllerDefinition: ComponentDefinition<ShippingAddressEditControllerProps>;
-  SummaryView: typeof ShippingAddressSummaryView;
-  SummaryViewDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
-  EditForm: typeof ShippingAddressEditForm;
-  EditFormDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
-  EditButton: typeof ShippingAddressEditButton;
-  EditButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
-  CancelButton: typeof ShippingAddressCancelButton;
-  CancelButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
-  Error: typeof ShippingAddressError;
-  ErrorDefinition: ComponentDefinition<ShippingAddressErrorProps>;
 };
 //#endregion
 //# sourceMappingURL=shipping-address.d.ts.map