@vtex/faststore 0.0.8 → 0.0.11

package/dist/matter/delivery-options/use-delivery-option-selection.d.ts

@@ -1,4 +1,5 @@
 import { ShippingOption } from "../shipping-simulator/shipping-simulator.js";
+import "../../sdk/shipping/option-select-operations.js";
 import "../../sdk/actions/types.js";
 //#region src/matter/delivery-options/use-delivery-option-selection.d.ts
 export type RawDeliveryOptionsData = {

package/dist/matter/delivery-options/use-delivery-option-selection.js

@@ -49,7 +49,7 @@ function useDeliveryOptionSelection({ $data: $dataProp, $actions, mockOptions })
 			if (selectionToken.current !== token) return;
 			const [firstError] = userErrors;
 			if (firstError) {
-				setSelectionError(firstError.message);
+				setSelectionError(firstError);
 				callbacks?.onSettled?.(false);
 			} else callbacks?.onSettled?.(true);
 		});

package/dist/matter/delivery-options/use-delivery-option-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-delivery-option-selection.js","names":[],"sources":["../../../src/matter/delivery-options/use-delivery-option-selection.ts"],"sourcesContent":["'use client';\n\nimport { useMemo, useRef, useState } from 'react';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport type { ShippingOption, ShippingSimulatorContextValue } from '../shipping-simulator/shipping-simulator.js';\n\n// ---------------------------------------------------------------------------\n// Raw data type (shape of the reactive fragment result). `$data` is the unwrapped\n// `Shipping` entity the reactive runtime forwards (Decision 7 / INV-7), not `{ shipping: … }`.\n// Shared by DeliveryOptionsRoot and its collapsed variants (Accordion/Dialog/Drawer), all of\n// which read the same `shipping { options … selectedOptionId }` selection.\n// ---------------------------------------------------------------------------\n\nexport type RawDeliveryOptionsData = {\n  options: ShippingOption[];\n  selectedOptionId: string | null;\n};\n\nconst EMPTY_OPTIONS: ShippingOption[] = [];\n\n/**\n * Joins the structural classes a collapsed variant always applies (positioning, sizing, animation)\n * with the page-supplied visual override, dropping empty slots. Keeps the visual layer out of the\n * component (Free Particle Model) while guaranteeing the overlay still positions itself.\n */\nexport function cx(...classes: Array<string | undefined>): string {\n  return classes.filter(Boolean).join(' ');\n}\n\nexport type DeliveryOptionSelection = {\n  /** Real options when the fetch has any, else the `mockOptions` fallback, else empty. */\n  options: ShippingOption[];\n  /** Group value: the persisted `selectedOptionId` for real data, local state under mock. */\n  selectedOptionId: string | null;\n  /** True while the mock fallback is showing (no real options + `mockOptions` present). */\n  usingMockOptions: boolean;\n  /** Message of the first `userError` from the latest real selection, or `null`. */\n  selectionError: string | null;\n  /**\n   * Selects an option. Under mock data the choice is local-only and never dispatches the action.\n   * Under real data it dispatches `shipping.selectOption`, request-sequenced so only the latest\n   * click wins the error state. `onSettled(ok)` fires once the selection resolves — `ok` is `false`\n   * when the mutation surfaced a `userError` (or no action was injected) — letting collapsed\n   * variants close only on success.\n   */\n  selectOption: (optionId: string, callbacks?: { onSettled?: (ok: boolean) => void }) => void;\n  /** The FSPG-832 simulator context value (inert simulation fields) providers must supply. */\n  contextValue: ShippingSimulatorContextValue;\n};\n\n/**\n * Shared selection engine behind `DeliveryOptionsRoot` and its collapsed variants\n * (`DeliveryOptionsAccordion` / `Dialog` / `Drawer`). It owns the four behaviours the spec\n * requires identically across every surface, so they cannot drift apart:\n *\n * - real-vs-mock option resolution — real options of any length always win (INV-8);\n * - the local mock selection, reset whenever the real↔mock boundary flips so a stale mock\n *   choice from before a real-options interlude never reappears (Decision 7);\n * - the reactive `selectedOptionId` binding (Decision 5 — no local state for real data);\n * - the request-sequenced `selectOption` dispatch that resolves `userErrors` for inline display\n *   (US-4), guarding against an earlier click's result overwriting a later one.\n *\n * Callers render `selectionError` (as `role=\"alert\"`) and wire `contextValue` themselves; the\n * collapsed variants additionally use `onSettled` to close their panel only on success.\n */\nexport function useDeliveryOptionSelection({\n  $data: $dataProp,\n  $actions,\n  mockOptions,\n}: {\n  $data?: RawDeliveryOptionsData | null;\n  $actions?: ComponentActions;\n  mockOptions?: ShippingOption[];\n}): DeliveryOptionSelection {\n  const $data = useDataOverride($dataProp);\n  const realOptions = $data?.options;\n  const usingMockOptions = !realOptions?.length && !!mockOptions?.length;\n  const options = realOptions?.length ? realOptions : (mockOptions ?? EMPTY_OPTIONS);\n\n  const [mockSelectedOptionId, setMockSelectedOptionId] = useState<string | null>(null);\n  const [wasUsingMockOptions, setWasUsingMockOptions] = useState(usingMockOptions);\n  if (usingMockOptions !== wasUsingMockOptions) {\n    setWasUsingMockOptions(usingMockOptions);\n    setMockSelectedOptionId(null);\n  }\n  const selectedOptionId = usingMockOptions ? mockSelectedOptionId : ($data?.selectedOptionId ?? null);\n\n  const [selectionError, setSelectionError] = useState<string | null>(null);\n  const selectionToken = useRef(0);\n\n  function selectOption(optionId: string, callbacks?: { onSettled?: (ok: boolean) => void }) {\n    if (usingMockOptions) {\n      setMockSelectedOptionId(optionId);\n      callbacks?.onSettled?.(true);\n      return;\n    }\n    setSelectionError(null);\n    const dispatch = $actions?.shipping?.selectOption;\n    if (!dispatch) {\n      callbacks?.onSettled?.(false);\n      return;\n    }\n    const token = ++selectionToken.current;\n    dispatch(optionId).then((userErrors) => {\n      if (selectionToken.current !== token) return;\n      const [firstError] = userErrors;\n      if (firstError) {\n        setSelectionError(firstError.message);\n        callbacks?.onSettled?.(false);\n      } else {\n        callbacks?.onSettled?.(true);\n      }\n    });\n  }\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode: '',\n      setPostalCode: () => {},\n      status: 'idle',\n      shippingOptions: options,\n      userErrors: [],\n      submit: () => {},\n    }),\n    [options],\n  );\n\n  return { options, selectedOptionId, usingMockOptions, selectionError, selectOption, contextValue };\n}\n"],"mappings":";;;;AAmBA,MAAM,gBAAkC,CAAC;;;;;;;;;;;;;;;;AA+CzC,SAAgB,2BAA2B,EACzC,OAAO,WACP,UACA,eAK0B;CAC1B,MAAM,QAAQ,gBAAgB,SAAS;CACvC,MAAM,cAAc,OAAO;CAC3B,MAAM,mBAAmB,CAAC,aAAa,UAAU,CAAC,CAAC,aAAa;CAChE,MAAM,UAAU,aAAa,SAAS,cAAe,eAAe;CAEpE,MAAM,CAAC,sBAAsB,2BAA2B,SAAwB,IAAI;CACpF,MAAM,CAAC,qBAAqB,0BAA0B,SAAS,gBAAgB;CAC/E,IAAI,qBAAqB,qBAAqB;EAC5C,uBAAuB,gBAAgB;EACvC,wBAAwB,IAAI;CAC9B;CACA,MAAM,mBAAmB,mBAAmB,uBAAwB,OAAO,oBAAoB;CAE/F,MAAM,CAAC,gBAAgB,qBAAqB,SAAwB,IAAI;CACxE,MAAM,iBAAiB,OAAO,CAAC;CAE/B,SAAS,aAAa,UAAkB,WAAmD;EACzF,IAAI,kBAAkB;GACpB,wBAAwB,QAAQ;GAChC,WAAW,YAAY,IAAI;GAC3B;EACF;EACA,kBAAkB,IAAI;EACtB,MAAM,WAAW,UAAU,UAAU;EACrC,IAAI,CAAC,UAAU;GACb,WAAW,YAAY,KAAK;GAC5B;EACF;EACA,MAAM,QAAQ,EAAE,eAAe;EAC/B,SAAS,QAAQ,CAAC,CAAC,MAAM,eAAe;GACtC,IAAI,eAAe,YAAY,OAAO;GACtC,MAAM,CAAC,cAAc;GACrB,IAAI,YAAY;IACd,kBAAkB,WAAW,OAAO;IACpC,WAAW,YAAY,KAAK;GAC9B,OACE,WAAW,YAAY,IAAI;EAE/B,CAAC;CACH;CAcA,OAAO;EAAE;EAAS;EAAkB;EAAkB;EAAgB;EAAc,cAZ/D,eACZ;GACL,YAAY;GACZ,qBAAqB,CAAC;GACtB,QAAQ;GACR,iBAAiB;GACjB,YAAY,CAAC;GACb,cAAc,CAAC;EACjB,IACA,CAAC,OAAO,CAGqF;CAAE;AACnG"}
+{"version":3,"file":"use-delivery-option-selection.js","names":[],"sources":["../../../src/matter/delivery-options/use-delivery-option-selection.ts"],"sourcesContent":["'use client';\n\nimport { useMemo, useRef, useState } from 'react';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport type { ShippingOptionSelectUserError } from '../../sdk/shipping/option-select-operations.js';\nimport type { ShippingOption, ShippingSimulatorContextValue } from '../shipping-simulator/shipping-simulator.js';\n\n// ---------------------------------------------------------------------------\n// Raw data type (shape of the reactive fragment result). `$data` is the unwrapped\n// `Shipping` entity the reactive runtime forwards (Decision 7 / INV-7), not `{ shipping: … }`.\n// Shared by DeliveryOptionsRoot and its collapsed variants (Accordion/Dialog/Drawer), all of\n// which read the same `shipping { options … selectedOptionId }` selection.\n// ---------------------------------------------------------------------------\n\nexport type RawDeliveryOptionsData = {\n  options: ShippingOption[];\n  selectedOptionId: string | null;\n};\n\nconst EMPTY_OPTIONS: ShippingOption[] = [];\n\n/**\n * The codes a selection can resolve: `ShippingOptionSelectErrorCode` (the sdk types `code` as a string)\n * plus the client-minted transport failure. Each surface words them from its own `$content`.\n */\nexport type DeliveryOptionSelectErrorCode =\n  | 'MISSING_CART_CONTEXT'\n  | 'CART_NOT_FOUND'\n  | 'OPTION_UNAVAILABLE'\n  | 'MISSING_SHIPPING_ADDRESS'\n  | 'NETWORK_ERROR';\n\n/**\n * Joins the structural classes a collapsed variant always applies (positioning, sizing, animation)\n * with the page-supplied visual override, dropping empty slots. Keeps the visual layer out of the\n * component (Free Particle Model) while guaranteeing the overlay still positions itself.\n */\nexport function cx(...classes: Array<string | undefined>): string {\n  return classes.filter(Boolean).join(' ');\n}\n\nexport type DeliveryOptionSelection = {\n  /** Real options when the fetch has any, else the `mockOptions` fallback, else empty. */\n  options: ShippingOption[];\n  /** Group value: the persisted `selectedOptionId` for real data, local state under mock. */\n  selectedOptionId: string | null;\n  /** True while the mock fallback is showing (no real options + `mockOptions` present). */\n  usingMockOptions: boolean;\n  /** The first `userError` from the latest real selection, or `null`. */\n  selectionError: ShippingOptionSelectUserError | null;\n  /**\n   * Selects an option. Under mock data the choice is local-only and never dispatches the action.\n   * Under real data it dispatches `shipping.selectOption`, request-sequenced so only the latest\n   * click wins the error state. `onSettled(ok)` fires once the selection resolves — `ok` is `false`\n   * when the mutation surfaced a `userError` (or no action was injected) — letting collapsed\n   * variants close only on success.\n   */\n  selectOption: (optionId: string, callbacks?: { onSettled?: (ok: boolean) => void }) => void;\n  /** The FSPG-832 simulator context value (inert simulation fields) providers must supply. */\n  contextValue: ShippingSimulatorContextValue;\n};\n\n/**\n * Shared selection engine behind `DeliveryOptionsRoot` and its collapsed variants\n * (`DeliveryOptionsAccordion` / `Dialog` / `Drawer`). It owns the four behaviours the spec\n * requires identically across every surface, so they cannot drift apart:\n *\n * - real-vs-mock option resolution — real options of any length always win (INV-8);\n * - the local mock selection, reset whenever the real↔mock boundary flips so a stale mock\n *   choice from before a real-options interlude never reappears (Decision 7);\n * - the reactive `selectedOptionId` binding (Decision 5 — no local state for real data);\n * - the request-sequenced `selectOption` dispatch that resolves `userErrors` for inline display\n *   (US-4), guarding against an earlier click's result overwriting a later one.\n *\n * Callers render `selectionError` (as `role=\"alert\"`) and wire `contextValue` themselves; the\n * collapsed variants additionally use `onSettled` to close their panel only on success.\n */\nexport function useDeliveryOptionSelection({\n  $data: $dataProp,\n  $actions,\n  mockOptions,\n}: {\n  $data?: RawDeliveryOptionsData | null;\n  $actions?: ComponentActions;\n  mockOptions?: ShippingOption[];\n}): DeliveryOptionSelection {\n  const $data = useDataOverride($dataProp);\n  const realOptions = $data?.options;\n  const usingMockOptions = !realOptions?.length && !!mockOptions?.length;\n  const options = realOptions?.length ? realOptions : (mockOptions ?? EMPTY_OPTIONS);\n\n  const [mockSelectedOptionId, setMockSelectedOptionId] = useState<string | null>(null);\n  const [wasUsingMockOptions, setWasUsingMockOptions] = useState(usingMockOptions);\n  if (usingMockOptions !== wasUsingMockOptions) {\n    setWasUsingMockOptions(usingMockOptions);\n    setMockSelectedOptionId(null);\n  }\n  const selectedOptionId = usingMockOptions ? mockSelectedOptionId : ($data?.selectedOptionId ?? null);\n\n  const [selectionError, setSelectionError] = useState<ShippingOptionSelectUserError | null>(null);\n  const selectionToken = useRef(0);\n\n  function selectOption(optionId: string, callbacks?: { onSettled?: (ok: boolean) => void }) {\n    if (usingMockOptions) {\n      setMockSelectedOptionId(optionId);\n      callbacks?.onSettled?.(true);\n      return;\n    }\n    setSelectionError(null);\n    const dispatch = $actions?.shipping?.selectOption;\n    if (!dispatch) {\n      callbacks?.onSettled?.(false);\n      return;\n    }\n    const token = ++selectionToken.current;\n    dispatch(optionId).then((userErrors) => {\n      if (selectionToken.current !== token) return;\n      const [firstError] = userErrors;\n      if (firstError) {\n        setSelectionError(firstError);\n        callbacks?.onSettled?.(false);\n      } else {\n        callbacks?.onSettled?.(true);\n      }\n    });\n  }\n\n  const contextValue = useMemo<ShippingSimulatorContextValue>(\n    () => ({\n      postalCode: '',\n      setPostalCode: () => {},\n      status: 'idle',\n      shippingOptions: options,\n      userErrors: [],\n      submit: () => {},\n    }),\n    [options],\n  );\n\n  return { options, selectedOptionId, usingMockOptions, selectionError, selectOption, contextValue };\n}\n"],"mappings":";;;;AAoBA,MAAM,gBAAkC,CAAC;;;;;;;;;;;;;;;;AA0DzC,SAAgB,2BAA2B,EACzC,OAAO,WACP,UACA,eAK0B;CAC1B,MAAM,QAAQ,gBAAgB,SAAS;CACvC,MAAM,cAAc,OAAO;CAC3B,MAAM,mBAAmB,CAAC,aAAa,UAAU,CAAC,CAAC,aAAa;CAChE,MAAM,UAAU,aAAa,SAAS,cAAe,eAAe;CAEpE,MAAM,CAAC,sBAAsB,2BAA2B,SAAwB,IAAI;CACpF,MAAM,CAAC,qBAAqB,0BAA0B,SAAS,gBAAgB;CAC/E,IAAI,qBAAqB,qBAAqB;EAC5C,uBAAuB,gBAAgB;EACvC,wBAAwB,IAAI;CAC9B;CACA,MAAM,mBAAmB,mBAAmB,uBAAwB,OAAO,oBAAoB;CAE/F,MAAM,CAAC,gBAAgB,qBAAqB,SAA+C,IAAI;CAC/F,MAAM,iBAAiB,OAAO,CAAC;CAE/B,SAAS,aAAa,UAAkB,WAAmD;EACzF,IAAI,kBAAkB;GACpB,wBAAwB,QAAQ;GAChC,WAAW,YAAY,IAAI;GAC3B;EACF;EACA,kBAAkB,IAAI;EACtB,MAAM,WAAW,UAAU,UAAU;EACrC,IAAI,CAAC,UAAU;GACb,WAAW,YAAY,KAAK;GAC5B;EACF;EACA,MAAM,QAAQ,EAAE,eAAe;EAC/B,SAAS,QAAQ,CAAC,CAAC,MAAM,eAAe;GACtC,IAAI,eAAe,YAAY,OAAO;GACtC,MAAM,CAAC,cAAc;GACrB,IAAI,YAAY;IACd,kBAAkB,UAAU;IAC5B,WAAW,YAAY,KAAK;GAC9B,OACE,WAAW,YAAY,IAAI;EAE/B,CAAC;CACH;CAcA,OAAO;EAAE;EAAS;EAAkB;EAAkB;EAAgB;EAAc,cAZ/D,eACZ;GACL,YAAY;GACZ,qBAAqB,CAAC;GACtB,QAAQ;GACR,iBAAiB;GACjB,YAAY,CAAC;GACb,cAAc,CAAC;EACjB,IACA,CAAC,OAAO,CAGqF;CAAE;AACnG"}

package/dist/matter/email-identification/email-identification.d.ts

@@ -1,19 +1,40 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { ComponentActions } from "../../sdk/actions/types.js";
 import { ComponentPropsWithRef } from "react";
 //#region src/matter/email-identification/email-identification.d.ts
+export declare const EmailIdentificationControlContent: {
+  readonly id: "email-identification-control";
+  readonly title: "Email Identification Control";
+  readonly description: "The inline message shown when saving the email fails.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly genericErrorMessage: {
+        readonly type: "string";
+        readonly title: "Save failure message";
+        readonly description: "Shown for a network failure and for any refusal the shopper cannot act on.";
+        readonly format: "icu-message";
+        readonly messageSource: "Unable to save your details. Please try again.";
+      };
+    };
+  };
+};
 /** ClientProfile slice forwarded by the reactive runtime — only `email` is consumed for pre-fill. */
 export type EmailIdentificationSlice = {
   email?: string | null;
 };
-export type EmailIdentificationControlProps = Omit<ComponentPropsWithRef<'div'>, 'onChange'> & {
+export type EmailIdentificationControlProps = Omit<ComponentPropsWithRef<'div'>, 'onChange'> & MessageLocaleProp & {
   /** Accessible label passed to the EmailField. */
   label?: string;
   /** Input placeholder passed to the EmailField. */
   placeholder?: string;
   /** Inline error text for an invalid email format (port of `checkout/form-messages.invalid-email`). */
   invalidEmailMessage?: string;
+  /** The inline message for a refused save. */
+  $content?: ContentValue<typeof EmailIdentificationControlContent>;
   /** ClientProfile slice forwarded by the reactive runtime; `null` until the entity resolves. */
   $data?: EmailIdentificationSlice | null;
   /** Compiler-injected action surface; carries `identity.clientProfileUpdate`. */
@@ -29,9 +50,10 @@ export declare const EmailIdentificationControlDefinition: ComponentDefinition<E
  * flight the field is disabled and `data-fs-email-identification-pending` is present so a
  * checkout-CTA guard can block. When the session reports `canEditData: false` (identified but
  * unauthenticated claimed profile — VTEX refuses the write server-side) the field renders disabled
- * with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline; the
+ * with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline, worded by the
+ * `$content` field for their code (genericErrorMessage for a code it does not know); the
  * session state is never computed locally.
  */
-export declare function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $data: $dataProp, $actions: $actionsProp, className, ...props }: EmailIdentificationControlProps): import("react/jsx-runtime").JSX.Element;
+export declare function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $content, $locale, $data: $dataProp, $actions: $actionsProp, className, ...props }: EmailIdentificationControlProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //# sourceMappingURL=email-identification.d.ts.map

package/dist/matter/email-identification/email-identification.js

@@ -1,17 +1,17 @@
 "use client";
 import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
+import { useMessageFormatter } from "../../sdk/i18n/use-message-formatter.js";
 import { EmailField, isValidEmail } from "../../particles/email-field/email-field.js";
 import { useActionsOverride } from "../../sdk/actions/actions-override-context.js";
+import { formatErrorCode } from "../../sdk/i18n/format-error-code.js";
 import { useDataOverride } from "../../sdk/data/data-override-context.js";
 import { useSession } from "../session/session.js";
 import { useEffect, useState } from "react";
 import { jsx } from "react/jsx-runtime";
-const EmailIdentificationControlDefinition = defineComponent({
-	name: "EmailIdentificationControl",
-	importPath: "@vtex/faststore/components",
-	component: EmailIdentificationControl,
-	fragment: `
+//#region src/matter/email-identification/email-identification.tsx
+const fragment = `
   fragment EmailIdentificationData on Query {
     clientProfile {
       __typename
@@ -19,7 +19,39 @@ const EmailIdentificationControlDefinition = defineComponent({
       email
     }
   }
-`,
+`;
+const EmailIdentificationControlContent = defineContentType({
+	id: "email-identification-control",
+	title: "Email Identification Control",
+	description: "The inline message shown when saving the email fails.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { genericErrorMessage: {
+			type: "string",
+			title: "Save failure message",
+			description: "Shown for a network failure and for any refusal the shopper cannot act on.",
+			format: "icu-message",
+			messageSource: "Unable to save your details. Please try again."
+		} }
+	}
+});
+/**
+* `ClientProfileUpdateErrorCode` of API Core's schema plus the client-minted transport failure. None is
+* something the shopper can fix by editing the email, so all share the generic message.
+*/
+const EMAIL_IDENTIFICATION_ERROR_FIELDS = {
+	MISSING_CART_CONTEXT: "genericErrorMessage",
+	CART_NOT_FOUND: "genericErrorMessage",
+	NO_PROFILE_FIELD_PROVIDED: "genericErrorMessage",
+	NETWORK_ERROR: "genericErrorMessage"
+};
+const EmailIdentificationControlDefinition = defineComponent({
+	name: "EmailIdentificationControl",
+	importPath: "@vtex/faststore/components",
+	component: EmailIdentificationControl,
+	content: EmailIdentificationControlContent,
+	fragment,
 	fetchStrategy: "reactive",
 	actions: { identity: ["clientProfileUpdate"] },
 	requiresContext: "session",
@@ -41,7 +73,7 @@ const EmailIdentificationControlDefinition = defineComponent({
 			label: "Invalid email message"
 		}
 	},
-	guideline: "Checkout-bound email field: pre-fills from clientProfile.email and persists a valid changed email via $actions.identity.clientProfileUpdate (anonymous→identified). Must be inside SessionRoot. See email-identification.md."
+	guideline: "Checkout-bound email field: pre-fills from clientProfile.email and persists a valid changed email via $actions.identity.clientProfileUpdate (anonymous→identified); a refused save shows the $content field genericErrorMessage. Must be inside SessionRoot. See email-identification.md."
 });
 /**
 * Matter that binds the presentational `EmailField` to the User Identity foundation. It reads
@@ -52,12 +84,14 @@ const EmailIdentificationControlDefinition = defineComponent({
 * flight the field is disabled and `data-fs-email-identification-pending` is present so a
 * checkout-CTA guard can block. When the session reports `canEditData: false` (identified but
 * unauthenticated claimed profile — VTEX refuses the write server-side) the field renders disabled
-* with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline; the
+* with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline, worded by the
+* `$content` field for their code (genericErrorMessage for a code it does not know); the
 * session state is never computed locally.
 */
-function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $data: $dataProp, $actions: $actionsProp, className, ...props }) {
+function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $content, $locale, $data: $dataProp, $actions: $actionsProp, className, ...props }) {
 	const $data = useDataOverride($dataProp);
 	const $actions = useActionsOverride($actionsProp);
+	const { format } = useMessageFormatter(EmailIdentificationControlContent, $content);
 	const { canEditData } = useSession();
 	const readOnly = !canEditData;
 	const savedEmail = $data?.email ?? "";
@@ -67,6 +101,9 @@ function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $
 	useEffect(() => {
 		setValue(savedEmail);
 	}, [savedEmail]);
+	function serverErrorMessage(error) {
+		return formatErrorCode(EmailIdentificationControlContent, EMAIL_IDENTIFICATION_ERROR_FIELDS, error, format, "genericErrorMessage");
+	}
 	function handleValueChange(next) {
 		setValue(next);
 		if (serverError) setServerError(null);
@@ -83,7 +120,7 @@ function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $
 		setServerError(null);
 		try {
 			const errors = await $actions?.identity?.clientProfileUpdate?.({ email: trimmed }) ?? [];
-			if (errors.length > 0) setServerError(errors[0]?.message ?? null);
+			if (errors.length > 0) setServerError(errors[0] ?? null);
 		} finally {
 			setPending(false);
 		}
@@ -100,7 +137,7 @@ function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $
 			value,
 			disabled: pending || readOnly,
 			invalid: serverError != null,
-			errorMessage: serverError ?? invalidEmailMessage,
+			errorMessage: serverError ? serverErrorMessage(serverError) : invalidEmailMessage,
 			onValueChange: handleValueChange,
 			onBlur: handleBlur,
 			required: true
@@ -108,6 +145,6 @@ function EmailIdentificationControl({ label, placeholder, invalidEmailMessage, $
 	});
 }
 //#endregion
-export { EmailIdentificationControl, EmailIdentificationControlDefinition };
+export { EMAIL_IDENTIFICATION_ERROR_FIELDS, EmailIdentificationControl, EmailIdentificationControlContent, EmailIdentificationControlDefinition };
 
 //# sourceMappingURL=email-identification.js.map

package/dist/matter/email-identification/email-identification.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-identification.js","names":[],"sources":["../../../src/matter/email-identification/email-identification.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { useEffect, useState } from 'react';\nimport { EmailField, isValidEmail } from '../../particles/email-field/email-field.js';\nimport { useActionsOverride } from '../../sdk/actions/actions-override-context.js';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { useSession } from '../session/session.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment (colocated, ADR-0011) — reads only clientProfile.email.\n// Authored as a raw string (not the codegen graphql() factory), mirroring the ShippingSimulator\n// matter: the compiler derives the entity fragment on `clientProfile` and subscribes reactively.\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment EmailIdentificationData on Query {\n    clientProfile {\n      __typename\n      id\n      email\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** ClientProfile slice forwarded by the reactive runtime — only `email` is consumed for pre-fill. */\nexport type EmailIdentificationSlice = {\n  email?: string | null;\n};\n\nexport type EmailIdentificationControlProps = Omit<ComponentPropsWithRef<'div'>, 'onChange'> & {\n  /** Accessible label passed to the EmailField. */\n  label?: string;\n  /** Input placeholder passed to the EmailField. */\n  placeholder?: string;\n  /** Inline error text for an invalid email format (port of `checkout/form-messages.invalid-email`). */\n  invalidEmailMessage?: string;\n  /** ClientProfile slice forwarded by the reactive runtime; `null` until the entity resolves. */\n  $data?: EmailIdentificationSlice | null;\n  /** Compiler-injected action surface; carries `identity.clientProfileUpdate`. */\n  $actions?: ComponentActions;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const EmailIdentificationControlDefinition = defineComponent<EmailIdentificationControlProps>({\n  name: 'EmailIdentificationControl',\n  importPath: '@vtex/faststore/components',\n  component: EmailIdentificationControl,\n  fragment,\n  fetchStrategy: 'reactive',\n  actions: { identity: ['clientProfileUpdate'] },\n  requiresContext: 'session',\n  editor: { label: 'Email Identification', category: 'identity' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    invalidEmailMessage: { type: 'string', label: 'Invalid email message' },\n  },\n  guideline:\n    'Checkout-bound email field: pre-fills from clientProfile.email and persists a valid changed email via $actions.identity.clientProfileUpdate (anonymous→identified). Must be inside SessionRoot. See email-identification.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * Matter that binds the presentational `EmailField` to the User Identity foundation. It reads\n * `clientProfile.email` (colocated reactive fragment) for the pre-fill, reads the identification\n * tri-state and `canEditData` from `useSession()` (which also enforces the `SessionRoot` ancestor),\n * and on a **valid, changed** email persists only the `email` field through\n * `$actions.identity.clientProfileUpdate` (async / pessimistic, Decision 1). While the write is in\n * flight the field is disabled and `data-fs-email-identification-pending` is present so a\n * checkout-CTA guard can block. When the session reports `canEditData: false` (identified but\n * unauthenticated claimed profile — VTEX refuses the write server-side) the field renders disabled\n * with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline; the\n * session state is never computed locally.\n */\nexport function EmailIdentificationControl({\n  label,\n  placeholder,\n  invalidEmailMessage,\n  $data: $dataProp,\n  $actions: $actionsProp,\n  className,\n  ...props\n}: EmailIdentificationControlProps) {\n  const $data = useDataOverride($dataProp);\n  const $actions = useActionsOverride($actionsProp);\n  // Also enforces the SessionRoot ancestor: useSession() throws when rendered outside one.\n  const { canEditData } = useSession();\n  // VTEX refuses profile edits for an identified-but-unauthenticated claimed profile; render the\n  // field read-only instead of accepting a write that is doomed server-side.\n  const readOnly = !canEditData;\n\n  const savedEmail = $data?.email ?? '';\n  const [value, setValue] = useState(savedEmail);\n  const [pending, setPending] = useState(false);\n  const [serverError, setServerError] = useState<string | null>(null);\n\n  // Sync the pre-fill when the saved profile email resolves or changes (identified/logged-in shopper).\n  // Does not fire while the shopper is typing, since `savedEmail` only changes when the profile does.\n  useEffect(() => {\n    setValue(savedEmail);\n  }, [savedEmail]);\n\n  function handleValueChange(next: string) {\n    setValue(next);\n    if (serverError) setServerError(null);\n  }\n\n  async function handleBlur() {\n    const trimmed = value.trim();\n    // Cleared field → re-fill with the saved email; clearing must not visually \"un-identify\"\n    // (changing email = switching user is a deliberate act, done by typing a new one).\n    if (trimmed === '' && savedEmail !== '') {\n      setValue(savedEmail);\n      return;\n    }\n    // Invalid format → EmailField shows its own inline error; no persist, no step advance.\n    if (!isValidEmail(trimmed)) return;\n    // Unchanged → nothing to persist.\n    if (trimmed === savedEmail) return;\n\n    setPending(true);\n    setServerError(null);\n    try {\n      const errors = (await $actions?.identity?.clientProfileUpdate?.({ email: trimmed })) ?? [];\n      if (errors.length > 0) setServerError(errors[0]?.message ?? null);\n    } finally {\n      setPending(false);\n    }\n  }\n\n  return (\n    <div\n      {...props}\n      className={className}\n      data-fs-email-identification-control=\"\"\n      {...(pending ? { 'data-fs-email-identification-pending': '' } : {})}\n      {...(readOnly ? { 'data-fs-email-identification-readonly': '' } : {})}\n    >\n      <EmailField\n        label={label}\n        placeholder={placeholder}\n        value={value}\n        disabled={pending || readOnly}\n        invalid={serverError != null}\n        errorMessage={serverError ?? invalidEmailMessage}\n        onValueChange={handleValueChange}\n        onBlur={handleBlur}\n        required\n      />\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAqDA,MAAa,uCAAuC,gBAAiD;CACnG,MAAM;CACN,YAAY;CACZ,WAAW;CACX;;;;;;;;;CACA,eAAe;CACf,SAAS,EAAE,UAAU,CAAC,qBAAqB,EAAE;CAC7C,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAW;CAC9D,QAAQ;EACN,OAAO;GAAE,MAAM;GAAU,OAAO;EAAQ;EACxC,aAAa;GAAE,MAAM;GAAU,OAAO;EAAc;EACpD,qBAAqB;GAAE,MAAM;GAAU,OAAO;EAAwB;CACxE;CACA,WACE;AACJ,CAAC;;;;;;;;;;;;;AAkBD,SAAgB,2BAA2B,EACzC,OACA,aACA,qBACA,OAAO,WACP,UAAU,cACV,WACA,GAAG,SAC+B;CAClC,MAAM,QAAQ,gBAAgB,SAAS;CACvC,MAAM,WAAW,mBAAmB,YAAY;CAEhD,MAAM,EAAE,gBAAgB,WAAW;CAGnC,MAAM,WAAW,CAAC;CAElB,MAAM,aAAa,OAAO,SAAS;CACnC,MAAM,CAAC,OAAO,YAAY,SAAS,UAAU;CAC7C,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,aAAa,kBAAkB,SAAwB,IAAI;CAIlE,gBAAgB;EACd,SAAS,UAAU;CACrB,GAAG,CAAC,UAAU,CAAC;CAEf,SAAS,kBAAkB,MAAc;EACvC,SAAS,IAAI;EACb,IAAI,aAAa,eAAe,IAAI;CACtC;CAEA,eAAe,aAAa;EAC1B,MAAM,UAAU,MAAM,KAAK;EAG3B,IAAI,YAAY,MAAM,eAAe,IAAI;GACvC,SAAS,UAAU;GACnB;EACF;EAEA,IAAI,CAAC,aAAa,OAAO,GAAG;EAE5B,IAAI,YAAY,YAAY;EAE5B,WAAW,IAAI;EACf,eAAe,IAAI;EACnB,IAAI;GACF,MAAM,SAAU,MAAM,UAAU,UAAU,sBAAsB,EAAE,OAAO,QAAQ,CAAC,KAAM,CAAC;GACzF,IAAI,OAAO,SAAS,GAAG,eAAe,OAAO,EAAE,EAAE,WAAW,IAAI;EAClE,UAAU;GACR,WAAW,KAAK;EAClB;CACF;CAEA,OACE,oBAAC,OAAD;EACE,GAAI;EACO;EACX,wCAAqC;EACrC,GAAK,UAAU,EAAE,wCAAwC,GAAG,IAAI,CAAC;EACjE,GAAK,WAAW,EAAE,yCAAyC,GAAG,IAAI,CAAC;EAEnE,UAAA,oBAAC,YAAD;GACS;GACM;GACN;GACP,UAAU,WAAW;GACrB,SAAS,eAAe;GACxB,cAAc,eAAe;GAC7B,eAAe;GACf,QAAQ;GACR,UAAA;EACD,CAAA;CACE,CAAA;AAET"}
+{"version":3,"file":"email-identification.js","names":[],"sources":["../../../src/matter/email-identification/email-identification.tsx"],"sourcesContent":["'use client';\n\nimport {\n  type ContentValue,\n  defineComponent,\n  defineContentType,\n  type MessageFieldName,\n  type MessageLocaleProp,\n} from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { useEffect, useState } from 'react';\nimport { EmailField, isValidEmail } from '../../particles/email-field/email-field.js';\nimport { useActionsOverride } from '../../sdk/actions/actions-override-context.js';\nimport type { ComponentActions } from '../../sdk/actions/types.js';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { formatErrorCode } from '../../sdk/i18n/format-error-code.js';\nimport { useMessageFormatter } from '../../sdk/i18n/use-message-formatter.js';\nimport type { ClientProfileUserError } from '../../sdk/identity/operations.js';\nimport { useSession } from '../session/session.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment (colocated, ADR-0011) — reads only clientProfile.email.\n// Authored as a raw string (not the codegen graphql() factory), mirroring the ShippingSimulator\n// matter: the compiler derives the entity fragment on `clientProfile` and subscribes reactively.\n// ---------------------------------------------------------------------------\n\nconst fragment = /* GraphQL */ `\n  fragment EmailIdentificationData on Query {\n    clientProfile {\n      __typename\n      id\n      email\n    }\n  }\n`;\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const EmailIdentificationControlContent = defineContentType({\n  id: 'email-identification-control',\n  title: 'Email Identification Control',\n  description: 'The inline message shown when saving the email fails.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      genericErrorMessage: {\n        type: 'string',\n        title: 'Save failure message',\n        description: 'Shown for a network failure and for any refusal the shopper cannot act on.',\n        format: 'icu-message',\n        messageSource: 'Unable to save your details. Please try again.',\n      },\n    },\n  },\n});\n\n/**\n * `ClientProfileUpdateErrorCode` of API Core's schema plus the client-minted transport failure. None is\n * something the shopper can fix by editing the email, so all share the generic message.\n */\nexport const EMAIL_IDENTIFICATION_ERROR_FIELDS = {\n  MISSING_CART_CONTEXT: 'genericErrorMessage',\n  CART_NOT_FOUND: 'genericErrorMessage',\n  NO_PROFILE_FIELD_PROVIDED: 'genericErrorMessage',\n  NETWORK_ERROR: 'genericErrorMessage',\n} as const satisfies Record<string, MessageFieldName<typeof EmailIdentificationControlContent>>;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** ClientProfile slice forwarded by the reactive runtime — only `email` is consumed for pre-fill. */\nexport type EmailIdentificationSlice = {\n  email?: string | null;\n};\n\nexport type EmailIdentificationControlProps = Omit<ComponentPropsWithRef<'div'>, 'onChange'> &\n  MessageLocaleProp & {\n    /** Accessible label passed to the EmailField. */\n    label?: string;\n    /** Input placeholder passed to the EmailField. */\n    placeholder?: string;\n    /** Inline error text for an invalid email format (port of `checkout/form-messages.invalid-email`). */\n    invalidEmailMessage?: string;\n    /** The inline message for a refused save. */\n    $content?: ContentValue<typeof EmailIdentificationControlContent>;\n    /** ClientProfile slice forwarded by the reactive runtime; `null` until the entity resolves. */\n    $data?: EmailIdentificationSlice | null;\n    /** Compiler-injected action surface; carries `identity.clientProfileUpdate`. */\n    $actions?: ComponentActions;\n  };\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const EmailIdentificationControlDefinition = defineComponent<EmailIdentificationControlProps>({\n  name: 'EmailIdentificationControl',\n  importPath: '@vtex/faststore/components',\n  component: EmailIdentificationControl,\n  content: EmailIdentificationControlContent,\n  fragment,\n  fetchStrategy: 'reactive',\n  actions: { identity: ['clientProfileUpdate'] },\n  requiresContext: 'session',\n  editor: { label: 'Email Identification', category: 'identity' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    invalidEmailMessage: { type: 'string', label: 'Invalid email message' },\n  },\n  guideline:\n    'Checkout-bound email field: pre-fills from clientProfile.email and persists a valid changed email via $actions.identity.clientProfileUpdate (anonymous→identified); a refused save shows the $content field genericErrorMessage. Must be inside SessionRoot. See email-identification.md.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * Matter that binds the presentational `EmailField` to the User Identity foundation. It reads\n * `clientProfile.email` (colocated reactive fragment) for the pre-fill, reads the identification\n * tri-state and `canEditData` from `useSession()` (which also enforces the `SessionRoot` ancestor),\n * and on a **valid, changed** email persists only the `email` field through\n * `$actions.identity.clientProfileUpdate` (async / pessimistic, Decision 1). While the write is in\n * flight the field is disabled and `data-fs-email-identification-pending` is present so a\n * checkout-CTA guard can block. When the session reports `canEditData: false` (identified but\n * unauthenticated claimed profile — VTEX refuses the write server-side) the field renders disabled\n * with `data-fs-email-identification-readonly`. Server `userErrors` are surfaced inline, worded by the\n * `$content` field for their code (genericErrorMessage for a code it does not know); the\n * session state is never computed locally.\n */\nexport function EmailIdentificationControl({\n  label,\n  placeholder,\n  invalidEmailMessage,\n  $content,\n  $locale,\n  $data: $dataProp,\n  $actions: $actionsProp,\n  className,\n  ...props\n}: EmailIdentificationControlProps) {\n  const $data = useDataOverride($dataProp);\n  const $actions = useActionsOverride($actionsProp);\n  const { format } = useMessageFormatter(EmailIdentificationControlContent, $content);\n  // Also enforces the SessionRoot ancestor: useSession() throws when rendered outside one.\n  const { canEditData } = useSession();\n  // VTEX refuses profile edits for an identified-but-unauthenticated claimed profile; render the\n  // field read-only instead of accepting a write that is doomed server-side.\n  const readOnly = !canEditData;\n\n  const savedEmail = $data?.email ?? '';\n  const [value, setValue] = useState(savedEmail);\n  const [pending, setPending] = useState(false);\n  const [serverError, setServerError] = useState<ClientProfileUserError | null>(null);\n\n  // Sync the pre-fill when the saved profile email resolves or changes (identified/logged-in shopper).\n  // Does not fire while the shopper is typing, since `savedEmail` only changes when the profile does.\n  useEffect(() => {\n    setValue(savedEmail);\n  }, [savedEmail]);\n\n  function serverErrorMessage(error: ClientProfileUserError): string {\n    return formatErrorCode(\n      EmailIdentificationControlContent,\n      EMAIL_IDENTIFICATION_ERROR_FIELDS,\n      error,\n      format,\n      'genericErrorMessage',\n    );\n  }\n\n  function handleValueChange(next: string) {\n    setValue(next);\n    if (serverError) setServerError(null);\n  }\n\n  async function handleBlur() {\n    const trimmed = value.trim();\n    // Cleared field → re-fill with the saved email; clearing must not visually \"un-identify\"\n    // (changing email = switching user is a deliberate act, done by typing a new one).\n    if (trimmed === '' && savedEmail !== '') {\n      setValue(savedEmail);\n      return;\n    }\n    // Invalid format → EmailField shows its own inline error; no persist, no step advance.\n    if (!isValidEmail(trimmed)) return;\n    // Unchanged → nothing to persist.\n    if (trimmed === savedEmail) return;\n\n    setPending(true);\n    setServerError(null);\n    try {\n      const errors = (await $actions?.identity?.clientProfileUpdate?.({ email: trimmed })) ?? [];\n      if (errors.length > 0) setServerError(errors[0] ?? null);\n    } finally {\n      setPending(false);\n    }\n  }\n\n  return (\n    <div\n      {...props}\n      className={className}\n      data-fs-email-identification-control=\"\"\n      {...(pending ? { 'data-fs-email-identification-pending': '' } : {})}\n      {...(readOnly ? { 'data-fs-email-identification-readonly': '' } : {})}\n    >\n      <EmailField\n        label={label}\n        placeholder={placeholder}\n        value={value}\n        disabled={pending || readOnly}\n        invalid={serverError != null}\n        errorMessage={serverError ? serverErrorMessage(serverError) : invalidEmailMessage}\n        onValueChange={handleValueChange}\n        onBlur={handleBlur}\n        required\n      />\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA0BA,MAAM,WAAyB;;;;;;;;;AAc/B,MAAa,oCAAoC,kBAAkB;CACjE,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;EACN,MAAM;EACN,sBAAsB;EACtB,YAAY,EACV,qBAAqB;GACnB,MAAM;GACN,OAAO;GACP,aAAa;GACb,QAAQ;GACR,eAAe;EACjB,EACF;CACF;AACF,CAAC;;;;;AAMD,MAAa,oCAAoC;CAC/C,sBAAsB;CACtB,gBAAgB;CAChB,2BAA2B;CAC3B,eAAe;AACjB;AA+BA,MAAa,uCAAuC,gBAAiD;CACnG,MAAM;CACN,YAAY;CACZ,WAAW;CACX,SAAS;CACT;CACA,eAAe;CACf,SAAS,EAAE,UAAU,CAAC,qBAAqB,EAAE;CAC7C,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAW;CAC9D,QAAQ;EACN,OAAO;GAAE,MAAM;GAAU,OAAO;EAAQ;EACxC,aAAa;GAAE,MAAM;GAAU,OAAO;EAAc;EACpD,qBAAqB;GAAE,MAAM;GAAU,OAAO;EAAwB;CACxE;CACA,WACE;AACJ,CAAC;;;;;;;;;;;;;;AAmBD,SAAgB,2BAA2B,EACzC,OACA,aACA,qBACA,UACA,SACA,OAAO,WACP,UAAU,cACV,WACA,GAAG,SAC+B;CAClC,MAAM,QAAQ,gBAAgB,SAAS;CACvC,MAAM,WAAW,mBAAmB,YAAY;CAChD,MAAM,EAAE,WAAW,oBAAoB,mCAAmC,QAAQ;CAElF,MAAM,EAAE,gBAAgB,WAAW;CAGnC,MAAM,WAAW,CAAC;CAElB,MAAM,aAAa,OAAO,SAAS;CACnC,MAAM,CAAC,OAAO,YAAY,SAAS,UAAU;CAC7C,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,aAAa,kBAAkB,SAAwC,IAAI;CAIlF,gBAAgB;EACd,SAAS,UAAU;CACrB,GAAG,CAAC,UAAU,CAAC;CAEf,SAAS,mBAAmB,OAAuC;EACjE,OAAO,gBACL,mCACA,mCACA,OACA,QACA,qBACF;CACF;CAEA,SAAS,kBAAkB,MAAc;EACvC,SAAS,IAAI;EACb,IAAI,aAAa,eAAe,IAAI;CACtC;CAEA,eAAe,aAAa;EAC1B,MAAM,UAAU,MAAM,KAAK;EAG3B,IAAI,YAAY,MAAM,eAAe,IAAI;GACvC,SAAS,UAAU;GACnB;EACF;EAEA,IAAI,CAAC,aAAa,OAAO,GAAG;EAE5B,IAAI,YAAY,YAAY;EAE5B,WAAW,IAAI;EACf,eAAe,IAAI;EACnB,IAAI;GACF,MAAM,SAAU,MAAM,UAAU,UAAU,sBAAsB,EAAE,OAAO,QAAQ,CAAC,KAAM,CAAC;GACzF,IAAI,OAAO,SAAS,GAAG,eAAe,OAAO,MAAM,IAAI;EACzD,UAAU;GACR,WAAW,KAAK;EAClB;CACF;CAEA,OACE,oBAAC,OAAD;EACE,GAAI;EACO;EACX,wCAAqC;EACrC,GAAK,UAAU,EAAE,wCAAwC,GAAG,IAAI,CAAC;EACjE,GAAK,WAAW,EAAE,yCAAyC,GAAG,IAAI,CAAC;EAEnE,UAAA,oBAAC,YAAD;GACS;GACM;GACN;GACP,UAAU,WAAW;GACrB,SAAS,eAAe;GACxB,cAAc,cAAc,mBAAmB,WAAW,IAAI;GAC9D,eAAe;GACf,QAAQ;GACR,UAAA;EACD,CAAA;CACE,CAAA;AAET"}

package/dist/matter/free-shipping-progress/free-shipping-progress.d.ts

@@ -1,3 +1,4 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { ComponentPropsWithRef } from "react";
@@ -9,7 +10,10 @@ type MoneyValue = {
 type FreeShippingProgressData = {
   cart?: {
     id: string;
-    total?: MoneyValue | null;
+    totalizers?: {
+      id: string;
+      value: MoneyValue;
+    }[] | null;
     freeShippingProgress?: {
       threshold: MoneyValue | null;
       remaining: MoneyValue;
@@ -21,20 +25,91 @@ export type FreeShippingProgressRootProps = ComponentPropsWithRef<'div'> & {
   threshold?: number;
   remaining?: number;
   qualified?: boolean;
-  cartTotal?: number;
+  itemsTotal?: number;
   $data?: FreeShippingProgressData['cart'] | null;
 };
-export type FreeShippingProgressBarProps = ComponentPropsWithRef<'div'>;
-export type FreeShippingProgressMessageProps = ComponentPropsWithRef<'div'> & {
-  label?: string;
-  qualifiedLabel?: string;
+export declare const FreeShippingProgressMessageContent: {
+  readonly id: "free-shipping-progress-message";
+  readonly title: "Free Shipping Progress Message";
+  readonly description: "The below-threshold and earned free-shipping messages.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Below-threshold label";
+        readonly description: "Shown while the cart is below the threshold; value is the formatted amount still missing.";
+        readonly format: "icu-message";
+        readonly messageSource: "{value} away from free shipping";
+        readonly messageArguments: {
+          readonly type: "object";
+          readonly properties: {
+            readonly value: {
+              readonly type: "string";
+            };
+          };
+        };
+        readonly messageExample: {
+          readonly value: "$25.00";
+        };
+      };
+      readonly qualifiedLabel: {
+        readonly type: "string";
+        readonly title: "Qualified label";
+        readonly format: "icu-message";
+        readonly messageSource: "You got free shipping!";
+      };
+    };
+  };
+};
+export declare const FreeShippingProgressBarContent: {
+  readonly id: "free-shipping-progress-bar";
+  readonly title: "Free Shipping Progress Bar";
+  readonly description: "The value text a screen reader announces for the progress bar.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly valueText: {
+        readonly type: "string";
+        readonly title: "Below-threshold value text";
+        readonly description: "Announced while the cart is below the threshold; value is the formatted amount still missing.";
+        readonly format: "icu-message";
+        readonly messageSource: "{value} left for free shipping";
+        readonly messageArguments: {
+          readonly type: "object";
+          readonly properties: {
+            readonly value: {
+              readonly type: "string";
+            };
+          };
+        };
+        readonly messageExample: {
+          readonly value: "$25.00";
+        };
+      };
+      readonly qualifiedValueText: {
+        readonly type: "string";
+        readonly title: "Qualified value text";
+        readonly format: "icu-message";
+        readonly messageSource: "Free shipping earned";
+      };
+    };
+  };
+};
+export type FreeShippingProgressBarProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
+  $content?: ContentValue<typeof FreeShippingProgressBarContent>;
+};
+export type FreeShippingProgressMessageProps = ComponentPropsWithRef<'div'> & MessageLocaleProp & {
+  $content?: ContentValue<typeof FreeShippingProgressMessageContent>;
 };
 export declare const FreeShippingProgressRootDefinition: ComponentDefinition<FreeShippingProgressRootProps>;
-export declare const FreeShippingProgressBarDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const FreeShippingProgressBarDefinition: ComponentDefinition<FreeShippingProgressBarProps>;
 export declare const FreeShippingProgressMessageDefinition: ComponentDefinition<FreeShippingProgressMessageProps>;
-export declare function FreeShippingProgressRoot({ threshold, remaining, qualified, cartTotal, $data: $dataProp, className, children, ...props }: FreeShippingProgressRootProps): import("react/jsx-runtime").JSX.Element | null;
-export declare function FreeShippingProgressBar({ className, ...props }: FreeShippingProgressBarProps): import("react/jsx-runtime").JSX.Element;
-export declare function FreeShippingProgressMessage({ label, qualifiedLabel, className, children, ...props }: FreeShippingProgressMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function FreeShippingProgressRoot({ threshold, remaining, qualified, itemsTotal, $data: $dataProp, className, children, ...props }: FreeShippingProgressRootProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function FreeShippingProgressBar({ $content, $locale, className, ...props }: FreeShippingProgressBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function FreeShippingProgressMessage({ $content, $locale, className, children, ...props }: FreeShippingProgressMessageProps): import("react/jsx-runtime").JSX.Element;
 export declare const FreeShippingProgress: {
   Root: typeof FreeShippingProgressRoot;
   Bar: typeof FreeShippingProgressBar;