@vtex/faststore 0.0.10 → 0.0.11

package/dist/matter/identity-edit/identity-edit.d.ts

@@ -1,25 +1,67 @@
+import { ContentValue, MessageLocaleProp } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
 import { ReactNode } from "react";
 //#region src/matter/identity-edit/identity-edit.d.ts
+export declare const IdentityEditButtonContent: {
+  readonly id: "identity-edit-button";
+  readonly title: "Identity Edit Button";
+  readonly description: "The label of the button that opens the identity form.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Button label";
+        readonly format: "icu-message";
+        readonly messageSource: "Edit";
+      };
+    };
+  };
+};
+export declare const IdentityEditCancelButtonContent: {
+  readonly id: "identity-edit-cancel-button";
+  readonly title: "Identity Edit Cancel Button";
+  readonly description: "The label of the button that closes the identity form without saving.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Button label";
+        readonly format: "icu-message";
+        readonly messageSource: "Cancel";
+      };
+    };
+  };
+};
 export type IdentityEditControllerProps = {
   children?: ReactNode;
 };
 export type IdentityEditPanelProps = {
   children?: ReactNode;
 };
-export type IdentityEditButtonProps = {
-  /** Text shown when no children are composed. */
-  label?: string;
+export type IdentityEditButtonProps = MessageLocaleProp & {
+  className?: string;
+  /** Compose custom button content (e.g. an Icon plus text); falls back to the `label` message. */
+  children?: ReactNode;
+  /** The label shown when no children are composed. */
+  $content?: ContentValue<typeof IdentityEditButtonContent>;
+};
+export type IdentityEditCancelButtonProps = MessageLocaleProp & {
   className?: string;
-  /** Compose custom button content (e.g. an Icon plus text); falls back to `label`. */
+  /** Compose custom button content; falls back to the `label` message. */
   children?: ReactNode;
+  /** The label shown when no children are composed. */
+  $content?: ContentValue<typeof IdentityEditCancelButtonContent>;
 };
 export declare const IdentityEditControllerDefinition: ComponentDefinition<IdentityEditControllerProps>;
 export declare const IdentitySummaryViewDefinition: ComponentDefinition<IdentityEditPanelProps>;
 export declare const IdentityEditFormDefinition: ComponentDefinition<IdentityEditPanelProps>;
 export declare const IdentityEditButtonDefinition: ComponentDefinition<IdentityEditButtonProps>;
-export declare const IdentityEditCancelButtonDefinition: ComponentDefinition<IdentityEditButtonProps>;
+export declare const IdentityEditCancelButtonDefinition: ComponentDefinition<IdentityEditCancelButtonProps>;
 /**
  * Owns the identity section's mode and provides it to descendants. Renders no DOM of its own.
  *
@@ -32,10 +74,10 @@ export declare function IdentityEditController({ children }: IdentityEditControl
 export declare function IdentitySummaryView({ children }: IdentityEditPanelProps): import("react/jsx-runtime").JSX.Element | null;
 /** Renders its children only while the section shows the form. */
 export declare function IdentityEditForm({ children }: IdentityEditPanelProps): import("react/jsx-runtime").JSX.Element | null;
-/** Opens the form. Renders `children` or the `label` fallback. */
-export declare function IdentityEditButton({ label, className, children }: IdentityEditButtonProps): import("react/jsx-runtime").JSX.Element;
-/** Returns to the summary without saving. Renders `children` or the `label` fallback. */
-export declare function IdentityEditCancelButton({ label, className, children }: IdentityEditButtonProps): import("react/jsx-runtime").JSX.Element;
+/** Opens the form. Renders `children` or the `label` message. */
+export declare function IdentityEditButton({ $content, $locale, className, children }: IdentityEditButtonProps): import("react/jsx-runtime").JSX.Element;
+/** Returns to the summary without saving. Renders `children` or the `label` message. */
+export declare function IdentityEditCancelButton({ $content, $locale, className, children }: IdentityEditCancelButtonProps): import("react/jsx-runtime").JSX.Element;
 export declare const IdentityEdit: {
   Controller: typeof IdentityEditController;
   ControllerDefinition: ComponentDefinition<IdentityEditControllerProps>;
@@ -46,7 +88,7 @@ export declare const IdentityEdit: {
   EditButton: typeof IdentityEditButton;
   EditButtonDefinition: ComponentDefinition<IdentityEditButtonProps>;
   CancelButton: typeof IdentityEditCancelButton;
-  CancelButtonDefinition: ComponentDefinition<IdentityEditButtonProps>;
+  CancelButtonDefinition: ComponentDefinition<IdentityEditCancelButtonProps>;
 };
 //#endregion
 //# sourceMappingURL=identity-edit.d.ts.map

package/dist/matter/identity-edit/identity-edit.js

@@ -1,6 +1,8 @@
 "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 { createContext, useContext, useMemo, useState } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 //#region src/matter/identity-edit/identity-edit.tsx
@@ -10,6 +12,36 @@ function useIdentityEditContext() {
 	if (!ctx) throw new Error("IdentitySummaryView, IdentityEditForm and the edit buttons must be used inside an IdentityEditController.");
 	return ctx;
 }
+const IdentityEditButtonContent = defineContentType({
+	id: "identity-edit-button",
+	title: "Identity Edit Button",
+	description: "The label of the button that opens the identity form.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { label: {
+			type: "string",
+			title: "Button label",
+			format: "icu-message",
+			messageSource: "Edit"
+		} }
+	}
+});
+const IdentityEditCancelButtonContent = defineContentType({
+	id: "identity-edit-cancel-button",
+	title: "Identity Edit Cancel Button",
+	description: "The label of the button that closes the identity form without saving.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: { label: {
+			type: "string",
+			title: "Button label",
+			format: "icu-message",
+			messageSource: "Cancel"
+		} }
+	}
+});
 const IdentityEditControllerDefinition = defineComponent({
 	name: "IdentityEditController",
 	importPath: "@vtex/faststore/components",
@@ -50,33 +82,27 @@ const IdentityEditButtonDefinition = defineComponent({
 	name: "IdentityEditButton",
 	importPath: "@vtex/faststore/components",
 	component: IdentityEditButton,
+	content: IdentityEditButtonContent,
 	requiresContext: "identity-edit",
 	editor: {
 		label: "Identity Edit Button",
 		category: "action"
 	},
-	schema: { label: {
-		type: "string",
-		default: "editar",
-		label: "Button label"
-	} },
-	guideline: "Opens the identity form. Place it in the section heading, inside an IdentitySummaryView so it disappears while the form is open. Compose an Icon plus text as children, or rely on `label`. Must be inside an IdentityEditController."
+	schema: {},
+	guideline: "Opens the identity form. Place it in the section heading, inside an IdentitySummaryView so it disappears while the form is open. Compose an Icon plus text as children, or rely on the $content field label. Must be inside an IdentityEditController."
 });
 const IdentityEditCancelButtonDefinition = defineComponent({
 	name: "IdentityEditCancelButton",
 	importPath: "@vtex/faststore/components",
 	component: IdentityEditCancelButton,
+	content: IdentityEditCancelButtonContent,
 	requiresContext: "identity-edit",
 	editor: {
 		label: "Identity Edit Cancel Button",
 		category: "action"
 	},
-	schema: { label: {
-		type: "string",
-		default: "cancelar",
-		label: "Button label"
-	} },
-	guideline: "Returns the identity section to its summary without saving. Place it inside an IdentityEditForm. Must be inside an IdentityEditController."
+	schema: {},
+	guideline: "Returns the identity section to its summary without saving. Its label is the $content field label unless children are composed. Place it inside an IdentityEditForm. Must be inside an IdentityEditController."
 });
 /**
 * Owns the identity section's mode and provides it to descendants. Renders no DOM of its own.
@@ -108,26 +134,28 @@ function IdentityEditForm({ children }) {
 	if (mode !== "edit") return null;
 	return /* @__PURE__ */ jsx(Fragment$1, { children });
 }
-/** Opens the form. Renders `children` or the `label` fallback. */
-function IdentityEditButton({ label = "editar", className, children }) {
+/** Opens the form. Renders `children` or the `label` message. */
+function IdentityEditButton({ $content, $locale, className, children }) {
 	const { setMode } = useIdentityEditContext();
+	const { format } = useMessageFormatter(IdentityEditButtonContent, $content);
 	return /* @__PURE__ */ jsx("button", {
 		type: "button",
 		"data-fs-identity-edit-button": "",
 		className,
 		onClick: () => setMode("edit"),
-		children: children ?? label
+		children: children ?? format("label")
 	});
 }
-/** Returns to the summary without saving. Renders `children` or the `label` fallback. */
-function IdentityEditCancelButton({ label = "cancelar", className, children }) {
+/** Returns to the summary without saving. Renders `children` or the `label` message. */
+function IdentityEditCancelButton({ $content, $locale, className, children }) {
 	const { setMode } = useIdentityEditContext();
+	const { format } = useMessageFormatter(IdentityEditCancelButtonContent, $content);
 	return /* @__PURE__ */ jsx("button", {
 		type: "button",
 		"data-fs-identity-edit-cancel-button": "",
 		className,
 		onClick: () => setMode("view"),
-		children: children ?? label
+		children: children ?? format("label")
 	});
 }
 const IdentityEdit = {
@@ -143,6 +171,6 @@ const IdentityEdit = {
 	CancelButtonDefinition: IdentityEditCancelButtonDefinition
 };
 //#endregion
-export { IdentityEdit, IdentityEditButton, IdentityEditButtonDefinition, IdentityEditCancelButton, IdentityEditCancelButtonDefinition, IdentityEditController, IdentityEditControllerDefinition, IdentityEditForm, IdentityEditFormDefinition, IdentitySummaryView, IdentitySummaryViewDefinition };
+export { IdentityEdit, IdentityEditButton, IdentityEditButtonContent, IdentityEditButtonDefinition, IdentityEditCancelButton, IdentityEditCancelButtonContent, IdentityEditCancelButtonDefinition, IdentityEditController, IdentityEditControllerDefinition, IdentityEditForm, IdentityEditFormDefinition, IdentitySummaryView, IdentitySummaryViewDefinition };
 
 //# sourceMappingURL=identity-edit.js.map

package/dist/matter/identity-edit/identity-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity-edit.js","names":[],"sources":["../../../src/matter/identity-edit/identity-edit.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { createContext, type ReactNode, useContext, useMemo, useState } from 'react';\n\n// ---------------------------------------------------------------------------\n// Identity view/edit toggle.\n//\n// The identity section shows a summary of who the shopper is until they ask to change it, and returns to\n// the summary when they say so — this component owns the mode rather than a page authoring it\n// (ADR-0006). Saving does not move it; whether it should is a sequencing question left to the\n// flow-of-steps RFC (#611). The delivery section owns no such mode of its own — its view/edit toggle\n// was removed with no replacement, so ShippingAddressFieldset always renders once resolved. See\n// identity-edit.md.\n// ---------------------------------------------------------------------------\n\n/** Internal: the section's two states never reach the schema, because each has its own component. */\ntype IdentityEditMode = 'view' | 'edit';\n\ntype IdentityEditContextValue = {\n  mode: IdentityEditMode;\n  setMode: (mode: IdentityEditMode) => void;\n};\n\nconst IdentityEditContext = createContext<IdentityEditContextValue | undefined>(undefined);\n\nfunction useIdentityEditContext(): IdentityEditContextValue {\n  const ctx = useContext(IdentityEditContext);\n  if (!ctx) {\n    throw new Error(\n      'IdentitySummaryView, IdentityEditForm and the edit buttons must be used inside an IdentityEditController.',\n    );\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Props\n// ---------------------------------------------------------------------------\n\nexport type IdentityEditControllerProps = {\n  children?: ReactNode;\n};\n\nexport type IdentityEditPanelProps = {\n  children?: ReactNode;\n};\n\nexport type IdentityEditButtonProps = {\n  /** Text shown when no children are composed. */\n  label?: string;\n  className?: string;\n  /** Compose custom button content (e.g. an Icon plus text); falls back to `label`. */\n  children?: ReactNode;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const IdentityEditControllerDefinition = defineComponent<IdentityEditControllerProps>({\n  name: 'IdentityEditController',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditController,\n  providesContext: 'identity-edit',\n  editor: { label: 'Identity Edit Controller', category: 'commerce' },\n  schema: {},\n  guideline:\n    \"Owns the identity section's summary/form toggle: starts on the summary, opens on IdentityEditButton and returns on IdentityEditCancelButton. Saving does not move it, so the form stays open and no descendant needs to know about a section around it. Self-contained: collapsing tells nothing else, so no other section opens as a result. Compose an IdentitySummaryView holding the summary parts and an IdentityEditForm holding a FormRoot over ClientProfileFieldset, plus an IdentityEditButton in the heading and an IdentityEditCancelButton next to the form. No state is named anywhere: which state a part belongs to is which component it is. Renders no DOM of its own.\",\n});\n\nexport const IdentitySummaryViewDefinition = defineComponent<IdentityEditPanelProps>({\n  name: 'IdentitySummaryView',\n  importPath: '@vtex/faststore/components',\n  component: IdentitySummaryView,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Summary View', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders its children only while the identity section shows the summary, and nothing while it shows the form. Takes no props: which state it gates is which component it is. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditFormDefinition = defineComponent<IdentityEditPanelProps>({\n  name: 'IdentityEditForm',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditForm,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Form', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders its children only while the identity section shows the form, and nothing while it shows the summary. Compose a FormRoot holding ClientProfileFieldset and its controls inside, plus an IdentityEditCancelButton. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditButtonDefinition = defineComponent<IdentityEditButtonProps>({\n  name: 'IdentityEditButton',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditButton,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Button', category: 'action' },\n  schema: {\n    label: { type: 'string', default: 'editar', label: 'Button label' },\n  },\n  guideline:\n    'Opens the identity form. Place it in the section heading, inside an IdentitySummaryView so it disappears while the form is open. Compose an Icon plus text as children, or rely on `label`. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditCancelButtonDefinition = defineComponent<IdentityEditButtonProps>({\n  name: 'IdentityEditCancelButton',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditCancelButton,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Cancel Button', category: 'action' },\n  schema: {\n    label: { type: 'string', default: 'cancelar', label: 'Button label' },\n  },\n  guideline:\n    'Returns the identity section to its summary without saving. Place it inside an IdentityEditForm. Must be inside an IdentityEditController.',\n});\n\n// ---------------------------------------------------------------------------\n// Components\n// ---------------------------------------------------------------------------\n\n/**\n * Owns the identity section's mode and provides it to descendants. Renders no DOM of its own.\n *\n * The mode moves only when the shopper presses one of this section's own buttons. Saving the form does\n * not close the section — the confirmation stays readable, and whether finishing a form should collapse\n * anything is a sequencing question this component deliberately has no opinion on.\n */\nexport function IdentityEditController({ children }: IdentityEditControllerProps) {\n  const [mode, setMode] = useState<IdentityEditMode>('view');\n\n  const value = useMemo<IdentityEditContextValue>(() => ({ mode, setMode }), [mode]);\n\n  return <IdentityEditContext.Provider value={value}>{children}</IdentityEditContext.Provider>;\n}\n\n/** Renders its children only while the section shows the summary. */\nexport function IdentitySummaryView({ children }: IdentityEditPanelProps) {\n  const { mode } = useIdentityEditContext();\n  if (mode !== 'view') return null;\n  return <>{children}</>;\n}\n\n/** Renders its children only while the section shows the form. */\nexport function IdentityEditForm({ children }: IdentityEditPanelProps) {\n  const { mode } = useIdentityEditContext();\n  if (mode !== 'edit') return null;\n  return <>{children}</>;\n}\n\n/** Opens the form. Renders `children` or the `label` fallback. */\nexport function IdentityEditButton({ label = 'editar', className, children }: IdentityEditButtonProps) {\n  const { setMode } = useIdentityEditContext();\n  return (\n    <button type=\"button\" data-fs-identity-edit-button=\"\" className={className} onClick={() => setMode('edit')}>\n      {children ?? label}\n    </button>\n  );\n}\n\n/** Returns to the summary without saving. Renders `children` or the `label` fallback. */\nexport function IdentityEditCancelButton({ label = 'cancelar', className, children }: IdentityEditButtonProps) {\n  const { setMode } = useIdentityEditContext();\n  return (\n    <button type=\"button\" data-fs-identity-edit-cancel-button=\"\" className={className} onClick={() => setMode('view')}>\n      {children ?? label}\n    </button>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace Export\n// ---------------------------------------------------------------------------\n\nexport const IdentityEdit = {\n  Controller: IdentityEditController,\n  ControllerDefinition: IdentityEditControllerDefinition,\n  SummaryView: IdentitySummaryView,\n  SummaryViewDefinition: IdentitySummaryViewDefinition,\n  Form: IdentityEditForm,\n  FormDefinition: IdentityEditFormDefinition,\n  EditButton: IdentityEditButton,\n  EditButtonDefinition: IdentityEditButtonDefinition,\n  CancelButton: IdentityEditCancelButton,\n  CancelButtonDefinition: IdentityEditCancelButtonDefinition,\n};\n"],"mappings":";;;;;;AAwBA,MAAM,sBAAsB,cAAoD,KAAA,CAAS;AAEzF,SAAS,yBAAmD;CAC1D,MAAM,MAAM,WAAW,mBAAmB;CAC1C,IAAI,CAAC,KACH,MAAM,IAAI,MACR,2GACF;CAEF,OAAO;AACT;AA0BA,MAAa,mCAAmC,gBAA6C;CAC3F,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAW;CAClE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,gCAAgC,gBAAwC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAyB,UAAU;CAAW;CAC/D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,6BAA6B,gBAAwC;CAChF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAsB,UAAU;CAAW;CAC5D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAS;CAC5D,QAAQ,EACN,OAAO;EAAE,MAAM;EAAU,SAAS;EAAU,OAAO;CAAe,EACpE;CACA,WACE;AACJ,CAAC;AAED,MAAa,qCAAqC,gBAAyC;CACzF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA+B,UAAU;CAAS;CACnE,QAAQ,EACN,OAAO;EAAE,MAAM;EAAU,SAAS;EAAY,OAAO;CAAe,EACtE;CACA,WACE;AACJ,CAAC;;;;;;;;AAaD,SAAgB,uBAAuB,EAAE,YAAyC;CAChF,MAAM,CAAC,MAAM,WAAW,SAA2B,MAAM;CAEzD,MAAM,QAAQ,eAAyC;EAAE;EAAM;CAAQ,IAAI,CAAC,IAAI,CAAC;CAEjF,OAAO,oBAAC,oBAAoB,UAArB;EAAqC;EAAQ;CAAuC,CAAA;AAC7F;;AAGA,SAAgB,oBAAoB,EAAE,YAAoC;CACxE,MAAM,EAAE,SAAS,uBAAuB;CACxC,IAAI,SAAS,QAAQ,OAAO;CAC5B,OAAO,oBAAA,YAAA,EAAG,SAAW,CAAA;AACvB;;AAGA,SAAgB,iBAAiB,EAAE,YAAoC;CACrE,MAAM,EAAE,SAAS,uBAAuB;CACxC,IAAI,SAAS,QAAQ,OAAO;CAC5B,OAAO,oBAAA,YAAA,EAAG,SAAW,CAAA;AACvB;;AAGA,SAAgB,mBAAmB,EAAE,QAAQ,UAAU,WAAW,YAAqC;CACrG,MAAM,EAAE,YAAY,uBAAuB;CAC3C,OACE,oBAAC,UAAD;EAAQ,MAAK;EAAS,gCAA6B;EAAc;EAAW,eAAe,QAAQ,MAAM;EACtG,UAAA,YAAY;CACP,CAAA;AAEZ;;AAGA,SAAgB,yBAAyB,EAAE,QAAQ,YAAY,WAAW,YAAqC;CAC7G,MAAM,EAAE,YAAY,uBAAuB;CAC3C,OACE,oBAAC,UAAD;EAAQ,MAAK;EAAS,uCAAoC;EAAc;EAAW,eAAe,QAAQ,MAAM;EAC7G,UAAA,YAAY;CACP,CAAA;AAEZ;AAMA,MAAa,eAAe;CAC1B,YAAY;CACZ,sBAAsB;CACtB,aAAa;CACb,uBAAuB;CACvB,MAAM;CACN,gBAAgB;CAChB,YAAY;CACZ,sBAAsB;CACtB,cAAc;CACd,wBAAwB;AAC1B"}
+{"version":3,"file":"identity-edit.js","names":[],"sources":["../../../src/matter/identity-edit/identity-edit.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType, type MessageLocaleProp } from '@vtex/fs-core';\nimport { createContext, type ReactNode, useContext, useMemo, useState } from 'react';\nimport { useMessageFormatter } from '../../sdk/i18n/use-message-formatter.js';\n\n// ---------------------------------------------------------------------------\n// Identity view/edit toggle.\n//\n// The identity section shows a summary of who the shopper is until they ask to change it, and returns to\n// the summary when they say so — this component owns the mode rather than a page authoring it\n// (ADR-0006). Saving does not move it; whether it should is a sequencing question left to the\n// flow-of-steps RFC (#611). The delivery section owns no such mode of its own — its view/edit toggle\n// was removed with no replacement, so ShippingAddressFieldset always renders once resolved. See\n// identity-edit.md.\n// ---------------------------------------------------------------------------\n\n/** Internal: the section's two states never reach the schema, because each has its own component. */\ntype IdentityEditMode = 'view' | 'edit';\n\ntype IdentityEditContextValue = {\n  mode: IdentityEditMode;\n  setMode: (mode: IdentityEditMode) => void;\n};\n\nconst IdentityEditContext = createContext<IdentityEditContextValue | undefined>(undefined);\n\nfunction useIdentityEditContext(): IdentityEditContextValue {\n  const ctx = useContext(IdentityEditContext);\n  if (!ctx) {\n    throw new Error(\n      'IdentitySummaryView, IdentityEditForm and the edit buttons must be used inside an IdentityEditController.',\n    );\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const IdentityEditButtonContent = defineContentType({\n  id: 'identity-edit-button',\n  title: 'Identity Edit Button',\n  description: 'The label of the button that opens the identity form.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label', format: 'icu-message', messageSource: 'Edit' },\n    },\n  },\n});\n\nexport const IdentityEditCancelButtonContent = defineContentType({\n  id: 'identity-edit-cancel-button',\n  title: 'Identity Edit Cancel Button',\n  description: 'The label of the button that closes the identity form without saving.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      label: { type: 'string', title: 'Button label', format: 'icu-message', messageSource: 'Cancel' },\n    },\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Props\n// ---------------------------------------------------------------------------\n\nexport type IdentityEditControllerProps = {\n  children?: ReactNode;\n};\n\nexport type IdentityEditPanelProps = {\n  children?: ReactNode;\n};\n\nexport type IdentityEditButtonProps = MessageLocaleProp & {\n  className?: string;\n  /** Compose custom button content (e.g. an Icon plus text); falls back to the `label` message. */\n  children?: ReactNode;\n  /** The label shown when no children are composed. */\n  $content?: ContentValue<typeof IdentityEditButtonContent>;\n};\n\nexport type IdentityEditCancelButtonProps = MessageLocaleProp & {\n  className?: string;\n  /** Compose custom button content; falls back to the `label` message. */\n  children?: ReactNode;\n  /** The label shown when no children are composed. */\n  $content?: ContentValue<typeof IdentityEditCancelButtonContent>;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const IdentityEditControllerDefinition = defineComponent<IdentityEditControllerProps>({\n  name: 'IdentityEditController',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditController,\n  providesContext: 'identity-edit',\n  editor: { label: 'Identity Edit Controller', category: 'commerce' },\n  schema: {},\n  guideline:\n    \"Owns the identity section's summary/form toggle: starts on the summary, opens on IdentityEditButton and returns on IdentityEditCancelButton. Saving does not move it, so the form stays open and no descendant needs to know about a section around it. Self-contained: collapsing tells nothing else, so no other section opens as a result. Compose an IdentitySummaryView holding the summary parts and an IdentityEditForm holding a FormRoot over ClientProfileFieldset, plus an IdentityEditButton in the heading and an IdentityEditCancelButton next to the form. No state is named anywhere: which state a part belongs to is which component it is. Renders no DOM of its own.\",\n});\n\nexport const IdentitySummaryViewDefinition = defineComponent<IdentityEditPanelProps>({\n  name: 'IdentitySummaryView',\n  importPath: '@vtex/faststore/components',\n  component: IdentitySummaryView,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Summary View', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders its children only while the identity section shows the summary, and nothing while it shows the form. Takes no props: which state it gates is which component it is. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditFormDefinition = defineComponent<IdentityEditPanelProps>({\n  name: 'IdentityEditForm',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditForm,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Form', category: 'commerce' },\n  schema: {},\n  guideline:\n    'Renders its children only while the identity section shows the form, and nothing while it shows the summary. Compose a FormRoot holding ClientProfileFieldset and its controls inside, plus an IdentityEditCancelButton. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditButtonDefinition = defineComponent<IdentityEditButtonProps>({\n  name: 'IdentityEditButton',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditButton,\n  content: IdentityEditButtonContent,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Button', category: 'action' },\n  schema: {},\n  guideline:\n    'Opens the identity form. Place it in the section heading, inside an IdentitySummaryView so it disappears while the form is open. Compose an Icon plus text as children, or rely on the $content field label. Must be inside an IdentityEditController.',\n});\n\nexport const IdentityEditCancelButtonDefinition = defineComponent<IdentityEditCancelButtonProps>({\n  name: 'IdentityEditCancelButton',\n  importPath: '@vtex/faststore/components',\n  component: IdentityEditCancelButton,\n  content: IdentityEditCancelButtonContent,\n  requiresContext: 'identity-edit',\n  editor: { label: 'Identity Edit Cancel Button', category: 'action' },\n  schema: {},\n  guideline:\n    'Returns the identity section to its summary without saving. Its label is the $content field label unless children are composed. Place it inside an IdentityEditForm. Must be inside an IdentityEditController.',\n});\n\n// ---------------------------------------------------------------------------\n// Components\n// ---------------------------------------------------------------------------\n\n/**\n * Owns the identity section's mode and provides it to descendants. Renders no DOM of its own.\n *\n * The mode moves only when the shopper presses one of this section's own buttons. Saving the form does\n * not close the section — the confirmation stays readable, and whether finishing a form should collapse\n * anything is a sequencing question this component deliberately has no opinion on.\n */\nexport function IdentityEditController({ children }: IdentityEditControllerProps) {\n  const [mode, setMode] = useState<IdentityEditMode>('view');\n\n  const value = useMemo<IdentityEditContextValue>(() => ({ mode, setMode }), [mode]);\n\n  return <IdentityEditContext.Provider value={value}>{children}</IdentityEditContext.Provider>;\n}\n\n/** Renders its children only while the section shows the summary. */\nexport function IdentitySummaryView({ children }: IdentityEditPanelProps) {\n  const { mode } = useIdentityEditContext();\n  if (mode !== 'view') return null;\n  return <>{children}</>;\n}\n\n/** Renders its children only while the section shows the form. */\nexport function IdentityEditForm({ children }: IdentityEditPanelProps) {\n  const { mode } = useIdentityEditContext();\n  if (mode !== 'edit') return null;\n  return <>{children}</>;\n}\n\n/** Opens the form. Renders `children` or the `label` message. */\nexport function IdentityEditButton({ $content, $locale, className, children }: IdentityEditButtonProps) {\n  const { setMode } = useIdentityEditContext();\n  const { format } = useMessageFormatter(IdentityEditButtonContent, $content);\n  return (\n    <button type=\"button\" data-fs-identity-edit-button=\"\" className={className} onClick={() => setMode('edit')}>\n      {children ?? format('label')}\n    </button>\n  );\n}\n\n/** Returns to the summary without saving. Renders `children` or the `label` message. */\nexport function IdentityEditCancelButton({ $content, $locale, className, children }: IdentityEditCancelButtonProps) {\n  const { setMode } = useIdentityEditContext();\n  const { format } = useMessageFormatter(IdentityEditCancelButtonContent, $content);\n  return (\n    <button type=\"button\" data-fs-identity-edit-cancel-button=\"\" className={className} onClick={() => setMode('view')}>\n      {children ?? format('label')}\n    </button>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Namespace Export\n// ---------------------------------------------------------------------------\n\nexport const IdentityEdit = {\n  Controller: IdentityEditController,\n  ControllerDefinition: IdentityEditControllerDefinition,\n  SummaryView: IdentitySummaryView,\n  SummaryViewDefinition: IdentitySummaryViewDefinition,\n  Form: IdentityEditForm,\n  FormDefinition: IdentityEditFormDefinition,\n  EditButton: IdentityEditButton,\n  EditButtonDefinition: IdentityEditButtonDefinition,\n  CancelButton: IdentityEditCancelButton,\n  CancelButtonDefinition: IdentityEditCancelButtonDefinition,\n};\n"],"mappings":"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"}

package/dist/matter/identity-summary/identity-summary.d.ts

@@ -1,9 +1,68 @@
+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 { PhoneCountry } from "../../particles/phone-field/phone-field.js";
 import { ReactNode } from "react";
 //#region src/matter/identity-summary/identity-summary.d.ts
+export declare const IdentitySummaryRootContent: {
+  readonly id: "identity-summary-root";
+  readonly title: "Identity Summary Root";
+  readonly description: "What the identity summary says when signing out fails.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly signOutErrorMessage: {
+        readonly type: "string";
+        readonly title: "Sign-out error message";
+        readonly description: "Shown for any refused or failed sign-out: none is something the shopper can fix.";
+        readonly format: "icu-message";
+        readonly messageSource: "Unable to sign out. Please try again.";
+      };
+    };
+  };
+};
+export declare const IdentitySummaryBadgeContent: {
+  readonly id: "identity-summary-badge";
+  readonly title: "Identity Summary Badge";
+  readonly description: "The session-state badge's label, one per state.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly identifiedLabel: {
+        readonly type: "string";
+        readonly title: "Identified badge label";
+        readonly format: "icu-message";
+        readonly messageSource: "Guest";
+      };
+      readonly loggedInLabel: {
+        readonly type: "string";
+        readonly title: "Logged-in badge label";
+        readonly format: "icu-message";
+        readonly messageSource: "Signed in";
+      };
+    };
+  };
+};
+export declare const IdentitySummarySignOutButtonContent: {
+  readonly id: "identity-summary-sign-out-button";
+  readonly title: "Identity Summary Sign Out Button";
+  readonly description: "The sign-out button's label.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly label: {
+        readonly type: "string";
+        readonly title: "Button label";
+        readonly format: "icu-message";
+        readonly messageSource: "Sign out";
+      };
+    };
+  };
+};
 /**
  * The `$data` slice forwarded by the reactive runtime — the unwrapped `ClientProfile` entity.
  * The fragment selects a single top-level field, so the compiler hands the entity value directly
@@ -16,9 +75,9 @@ export type IdentitySummaryData = {
   phone?: string | null;
   document?: string | null;
 } | null;
-export type IdentitySummaryRootProps = {
-  /** Error message shown when the sign-out mutation returns user errors. */
-  signOutErrorMessage?: string;
+export type IdentitySummaryRootProps = MessageLocaleProp & {
+  /** The message shown when the sign-out fails without an error of its own. */
+  $content?: ContentValue<typeof IdentitySummaryRootContent>;
   className?: string;
   children?: ReactNode;
   /** `IdentitySummaryData` slice forwarded by the reactive runtime. */
@@ -29,19 +88,13 @@ export type IdentitySummaryRootProps = {
 export type IdentitySummarySelectedSummaryProps = {
   /** Phone display country; selects the mask applied to the stored E.164 value. */
   country?: PhoneCountry;
-  /** Badge label in the `identified` session state. */
-  identifiedBadgeLabel?: string;
-  /** Badge label in the `loggedIn` session state. */
-  loggedInBadgeLabel?: string;
   className?: string;
   /** Compose custom read-only content; falls back to the default badge + details when omitted. */
   children?: ReactNode;
 };
-export type IdentitySummaryBadgeProps = {
-  /** Badge label in the `identified` session state. */
-  identifiedLabel?: string;
-  /** Badge label in the `loggedIn` session state. */
-  loggedInLabel?: string;
+export type IdentitySummaryBadgeProps = MessageLocaleProp & {
+  /** The badge label for each session state. */
+  $content?: ContentValue<typeof IdentitySummaryBadgeContent>;
   className?: string;
 };
 export type IdentitySummaryFieldProps = {
@@ -52,8 +105,9 @@ export type IdentitySummaryPhoneProps = {
   country?: PhoneCountry;
   className?: string;
 };
-export type IdentitySummarySignOutButtonProps = {
-  label?: string;
+export type IdentitySummarySignOutButtonProps = MessageLocaleProp & {
+  /** The label shown when no children are composed. */
+  $content?: ContentValue<typeof IdentitySummarySignOutButtonContent>;
   className?: string;
   children?: ReactNode;
 };
@@ -75,18 +129,18 @@ export declare const IdentitySummaryErrorDefinition: ComponentDefinition<Identit
  * state. Owns the sign-out mutation state (pending/error) and broadcasts everything the read-only
  * parts and the sign-out button need through `IdentitySummaryContext`.
  */
-export declare function IdentitySummaryRoot({ signOutErrorMessage, className, children, $data: $dataProp, $actions: $actionsProp }: Readonly<IdentitySummaryRootProps>): import("react/jsx-runtime").JSX.Element | null;
+export declare function IdentitySummaryRoot({ $content, $locale, className, children, $data: $dataProp, $actions: $actionsProp }: Readonly<IdentitySummaryRootProps>): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Read-only identity display: a session-state badge plus name, email, phone, and document.
  *
- * The props below configure the default composition only — composing children replaces it wholesale,
- * and a leaf placed there takes its own props (`IdentitySummaryPhone` its `country`,
- * `IdentitySummaryBadge` its labels). They are deliberately absent from the schema, so a page cannot
- * set one here and watch it disappear behind composed children.
+ * `country` configures the default composition only — composing children replaces it wholesale, and a
+ * leaf placed there takes its own props (`IdentitySummaryPhone` its `country`, `IdentitySummaryBadge`
+ * its `$content` labels). It is deliberately absent from the schema, so a page cannot set it here and
+ * watch it disappear behind composed children.
  */
-export declare function IdentitySummarySelectedSummary({ country, identifiedBadgeLabel, loggedInBadgeLabel, className, children }: IdentitySummarySelectedSummaryProps): import("react/jsx-runtime").JSX.Element;
+export declare function IdentitySummarySelectedSummary({ country, className, children }: Readonly<IdentitySummarySelectedSummaryProps>): import("react/jsx-runtime").JSX.Element;
 /** Session-state badge. Renders `identifiedLabel` for a guest and `loggedInLabel` once authenticated. */
-export declare function IdentitySummaryBadge({ identifiedLabel, loggedInLabel, className }: IdentitySummaryBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function IdentitySummaryBadge({ $content, $locale, className }: IdentitySummaryBadgeProps): import("react/jsx-runtime").JSX.Element;
 /** The shopper's full name. Renders nothing when the profile carries neither name. */
 export declare function IdentitySummaryName({ className }: IdentitySummaryFieldProps): import("react/jsx-runtime").JSX.Element | null;
 /** The shopper's e-mail. Renders nothing when absent. */
@@ -101,7 +155,7 @@ export declare function IdentitySummaryPhone({ country, className }: IdentitySum
 /** The shopper's tax document. Renders nothing when absent. */
 export declare function IdentitySummaryDocument({ className }: IdentitySummaryFieldProps): import("react/jsx-runtime").JSX.Element | null;
 /** Dispatches the sign-out mutation (async/pessimistic). */
-export declare function IdentitySummarySignOutButton({ label, className, children }: IdentitySummarySignOutButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function IdentitySummarySignOutButton({ $content, $locale, className, children }: IdentitySummarySignOutButtonProps): import("react/jsx-runtime").JSX.Element;
 /** Renders the inline sign-out user error, or nothing when there is none. */
 export declare function IdentitySummaryError({ className }: IdentitySummaryErrorProps): import("react/jsx-runtime").JSX.Element | null;
 export declare const IdentitySummary: {