@vtex/faststore 0.0.6 → 0.0.8

package/dist/particles/address-summary/address-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"address-summary.js","names":[],"sources":["../../../src/particles/address-summary/address-summary.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { createContext, type ReactNode, useContext } from 'react';\n\n/**\n * AddressSummary particle (no business coupling — ADR-0001): a presentational display for a\n * postal address, driven entirely by AddressSummaryRoot's context rather than props. Any matter\n * component that owns address data (e.g. ShippingAddressSelectedSummary, ShippingAddressSavedOption)\n * provides it via AddressSummaryRoot; AddressSummary reads and renders it. A future alternative\n * presentation (e.g. a \"LeanAddressSummary\") would read the same context and could be composed in\n * its place — swapping the presentation is a composition change, not a new data-binding.\n */\n\nexport type AddressSummaryFields = Readonly<{\n  recipientName?: string | null;\n  name?: string | null;\n  street?: string | null;\n  number?: string | null;\n  complement?: string | null;\n  neighborhood?: string | null;\n  city?: string | null;\n  state?: string | null;\n  postalCode?: string | null;\n  country?: string | null;\n  reference?: string | null;\n}>;\n\nexport type AddressSummaryFieldKey = keyof AddressSummaryFields;\n\nconst AddressSummaryContext = createContext<AddressSummaryFields | null>(null);\n\nexport function useAddressSummary(): AddressSummaryFields {\n  const ctx = useContext(AddressSummaryContext);\n  if (!ctx) throw new Error('AddressSummary must be used inside AddressSummaryRoot.');\n  return ctx;\n}\n\nexport type AddressSummaryRootProps = {\n  /** The address fields provided to descendant presentational components via context. */\n  address: AddressSummaryFields;\n  children?: ReactNode;\n};\n\nexport type AddressSummaryProps = {\n  className?: string;\n  /** The lines to render, in order. Defaults to recipient, street, locality when omitted. */\n  children?: ReactNode;\n};\n\nexport type AddressSummaryLineProps = {\n  className?: string;\n};\n\nexport type AddressSummaryNameProps = Readonly<AddressSummaryLineProps>;\n\nexport type AddressSummaryCountryProps = Readonly<AddressSummaryLineProps>;\n\nexport type AddressSummaryFieldProps = Readonly<{\n  /** Which address field to render inline. */\n  field: AddressSummaryFieldKey;\n  className?: string;\n}>;\n\nexport const AddressSummaryRootDefinition = defineComponent<AddressSummaryRootProps>({\n  name: 'AddressSummaryRoot',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryRoot,\n  providesContext: 'address-summary',\n  editor: { label: 'Address Summary Root', category: 'content' },\n  schema: {},\n  guideline:\n    'Provides a postal address to descendant presentational components via context (no business coupling). Compose a matter component that owns address data as the source of the address prop, and AddressSummary (or a future alternative presentation reading the same context) as the child that renders it.',\n});\n\nexport const AddressSummaryDefinition = defineComponent<AddressSummaryProps>({\n  name: 'AddressSummary',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummary,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary', category: 'content' },\n  schema: {},\n  guideline:\n    'The address block: recipient, street line, locality line, in that order by default. Compose AddressSummaryRecipient / Street / Locality as children to choose the order or drop a line; the wrapper, and any styling on it, is the same either way. AddressSummaryName, AddressSummaryCountry and AddressSummaryField are also available for a custom composition — none of them join the default. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryRecipientDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryRecipient',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryRecipient,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Recipient', category: 'content' },\n  schema: {},\n  guideline:\n    'Who the delivery is addressed to, or nothing when the address carries no recipient. Place it in whatever order the summary should read. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryStreetDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryStreet',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryStreet,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Street', category: 'content' },\n  schema: {},\n  guideline:\n    'Street, number and complement on one line, or nothing when all three are absent. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryLocalityDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryLocality',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryLocality,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Locality', category: 'content' },\n  schema: {},\n  guideline:\n    'Neighborhood, city, state and postal code on one line, or nothing when all are absent. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryNameDefinition = defineComponent<AddressSummaryNameProps>({\n  name: 'AddressSummaryName',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryName,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Name', category: 'content' },\n  schema: {},\n  guideline:\n    \"The shopper's own label for the address, or nothing when there is none. An unnamed address is identified by its contents. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport const AddressSummaryCountryDefinition = defineComponent<AddressSummaryCountryProps>({\n  name: 'AddressSummaryCountry',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryCountry,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Country', category: 'content' },\n  schema: {},\n  guideline:\n    \"The address's country, shown exactly as provided, or nothing when there is none. Provide a display name, not a raw code: the address stores an ISO alpha-3 code, which Intl.DisplayNames rejects. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport const AddressSummaryFieldDefinition = defineComponent<AddressSummaryFieldProps>({\n  name: 'AddressSummaryField',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryField,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Field', category: 'content' },\n  schema: {\n    field: {\n      type: [\n        'recipientName',\n        'name',\n        'street',\n        'number',\n        'complement',\n        'neighborhood',\n        'city',\n        'state',\n        'postalCode',\n        'country',\n        'reference',\n      ] as const,\n      label: 'Field',\n    },\n  },\n  guideline:\n    \"One address field, rendered inline, or nothing when it is empty. Compose several to build a line in a country's own order (e.g. number before street), with the separators the composition supplies; a separator beside a field that turns out empty is the composition's to drop. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport function AddressSummaryRoot({ address, children }: AddressSummaryRootProps) {\n  return <AddressSummaryContext.Provider value={address}>{children}</AddressSummaryContext.Provider>;\n}\n\nexport function AddressSummary({ className, children }: AddressSummaryProps) {\n  return (\n    <div className={className} data-fs-address-summary=\"\">\n      {children ?? (\n        <>\n          <AddressSummaryRecipient />\n          <AddressSummaryStreet />\n          <AddressSummaryLocality />\n        </>\n      )}\n    </div>\n  );\n}\n\n/** Who the delivery is addressed to. Renders nothing when the address carries no recipient. */\nexport function AddressSummaryRecipient({ className }: AddressSummaryLineProps) {\n  const { recipientName } = useAddressSummary();\n  if (!recipientName) return null;\n  return (\n    <p className={className} data-fs-address-summary-recipient=\"\">\n      {recipientName}\n    </p>\n  );\n}\n\n/** Street, number and complement on one line. Renders nothing when all three are absent. */\nexport function AddressSummaryStreet({ className }: AddressSummaryLineProps) {\n  const { street, number, complement } = useAddressSummary();\n  const line = [[street, number].filter(Boolean).join(', '), complement].filter(Boolean).join(' - ');\n  if (!line) return null;\n  return (\n    <p className={className} data-fs-address-summary-address=\"\">\n      {line}\n    </p>\n  );\n}\n\n/** Neighborhood, city, state and postal code on one line. Renders nothing when all are absent. */\nexport function AddressSummaryLocality({ className }: AddressSummaryLineProps) {\n  const { neighborhood, city, state, postalCode } = useAddressSummary();\n  const line = [neighborhood, [city, state].filter(Boolean).join(' - '), postalCode].filter(Boolean).join(', ');\n  if (!line) return null;\n  return (\n    <p className={className} data-fs-address-summary-locality=\"\">\n      {line}\n    </p>\n  );\n}\n\n/** The shopper's own label for the address. Renders nothing when the address carries no name. */\nexport function AddressSummaryName({ className }: AddressSummaryNameProps) {\n  const { name } = useAddressSummary();\n  if (!name) return null;\n  return (\n    <p className={className} data-fs-address-summary-name=\"\">\n      {name}\n    </p>\n  );\n}\n\n/** The address's country, shown as provided. Renders nothing when the address carries no country. */\nexport function AddressSummaryCountry({ className }: AddressSummaryCountryProps) {\n  const { country } = useAddressSummary();\n  if (!country) return null;\n  return (\n    <p className={className} data-fs-address-summary-country=\"\">\n      {country}\n    </p>\n  );\n}\n\n/** One address field, rendered inline. Renders nothing when that field is absent. */\nexport function AddressSummaryField({ field, className }: AddressSummaryFieldProps) {\n  const address = useAddressSummary();\n  const value = address[field];\n  if (!value) return null;\n  return (\n    <span className={className} data-fs-address-summary-field={field}>\n      {value}\n    </span>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"address-summary.js","names":[],"sources":["../../../src/particles/address-summary/address-summary.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { createContext, type ReactNode, useContext } from 'react';\n\n/**\n * AddressSummary particle (no business coupling — ADR-0001): a presentational display for a\n * postal address, driven entirely by AddressSummaryRoot's context rather than props. Any matter\n * component that owns address data (e.g. ShippingAddressSelectedSummary, ShippingAddressSavedOption)\n * provides it via AddressSummaryRoot; AddressSummary reads and renders it. A future alternative\n * presentation (e.g. a \"LeanAddressSummary\") would read the same context and could be composed in\n * its place — swapping the presentation is a composition change, not a new data-binding.\n */\n\nexport type AddressSummaryFields = Readonly<{\n  recipientName?: string | null;\n  name?: string | null;\n  street?: string | null;\n  number?: string | null;\n  complement?: string | null;\n  neighborhood?: string | null;\n  city?: string | null;\n  state?: string | null;\n  postalCode?: string | null;\n  country?: string | null;\n  reference?: string | null;\n}>;\n\nexport type AddressSummaryFieldKey = keyof AddressSummaryFields;\n\nconst AddressSummaryContext = createContext<AddressSummaryFields | null>(null);\n\nexport function useAddressSummary(): AddressSummaryFields {\n  const ctx = useContext(AddressSummaryContext);\n  if (!ctx) throw new Error('AddressSummary must be used inside AddressSummaryRoot.');\n  return ctx;\n}\n\nexport type AddressSummaryRootProps = {\n  /** The address fields provided to descendant presentational components via context. */\n  address: AddressSummaryFields;\n  children?: ReactNode;\n};\n\nexport type AddressSummaryProps = {\n  className?: string;\n  /** The lines to render, in order. Defaults to recipient, street, locality when omitted. */\n  children?: ReactNode;\n};\n\nexport type AddressSummaryLineProps = {\n  className?: string;\n};\n\nexport type AddressSummaryNameProps = Readonly<AddressSummaryLineProps>;\n\nexport type AddressSummaryCountryProps = Readonly<AddressSummaryLineProps>;\n\nexport type AddressSummaryFieldProps = Readonly<{\n  /** Which address field to render inline. */\n  field: AddressSummaryFieldKey;\n  className?: string;\n}>;\n\nexport const AddressSummaryRootDefinition = defineComponent<AddressSummaryRootProps>({\n  name: 'AddressSummaryRoot',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryRoot,\n  providesContext: 'address-summary',\n  editor: { label: 'Address Summary Root', category: 'content' },\n  schema: {},\n  guideline:\n    'Provides a postal address to descendant presentational components via context (no business coupling). Compose a matter component that owns address data as the source of the address prop, and AddressSummary (or a future alternative presentation reading the same context) as the child that renders it.',\n});\n\nexport const AddressSummaryDefinition = defineComponent<AddressSummaryProps>({\n  name: 'AddressSummary',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummary,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary', category: 'content' },\n  schema: {},\n  guideline:\n    'The address block: recipient, street line, locality line, in that order by default. Compose AddressSummaryRecipient / Street / Locality as children to choose the order or drop a line; the wrapper, and any styling on it, is the same either way. AddressSummaryName, AddressSummaryCountry and AddressSummaryField are also available for a custom composition — none of them join the default. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryRecipientDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryRecipient',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryRecipient,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Recipient', category: 'content' },\n  schema: {},\n  guideline:\n    'Who the delivery is addressed to, or nothing when the address carries no recipient. Place it in whatever order the summary should read. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryStreetDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryStreet',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryStreet,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Street', category: 'content' },\n  schema: {},\n  guideline:\n    'Street, number and complement on one line, or nothing when all three are absent. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryLocalityDefinition = defineComponent<AddressSummaryLineProps>({\n  name: 'AddressSummaryLocality',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryLocality,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Locality', category: 'content' },\n  schema: {},\n  guideline:\n    'Neighborhood, city, state and postal code on one line, or nothing when all are absent. Must be a descendant of AddressSummaryRoot.',\n});\n\nexport const AddressSummaryNameDefinition = defineComponent<AddressSummaryNameProps>({\n  name: 'AddressSummaryName',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryName,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Name', category: 'content' },\n  schema: {},\n  guideline:\n    \"The shopper's own label for the address, or nothing when there is none. An unnamed address is identified by its contents. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport const AddressSummaryCountryDefinition = defineComponent<AddressSummaryCountryProps>({\n  name: 'AddressSummaryCountry',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryCountry,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Country', category: 'content' },\n  schema: {},\n  guideline:\n    \"The address's country, shown exactly as provided, or nothing when there is none. Provide a display name, not a raw code: the address stores an ISO alpha-3 code, which Intl.DisplayNames rejects. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport const AddressSummaryFieldDefinition = defineComponent<AddressSummaryFieldProps>({\n  name: 'AddressSummaryField',\n  importPath: '@vtex/faststore/components',\n  component: AddressSummaryField,\n  requiresContext: 'address-summary',\n  editor: { label: 'Address Summary Field', category: 'content' },\n  schema: {\n    field: {\n      type: [\n        'recipientName',\n        'name',\n        'street',\n        'number',\n        'complement',\n        'neighborhood',\n        'city',\n        'state',\n        'postalCode',\n        'country',\n        'reference',\n      ] as const,\n      label: 'Field',\n    },\n  },\n  guideline:\n    \"One address field, rendered inline, or nothing when it is empty. Compose several to build a line in a country's own order (e.g. number before street), with the separators the composition supplies; a separator beside a field that turns out empty is the composition's to drop. Must be a descendant of AddressSummaryRoot.\",\n});\n\nexport function AddressSummaryRoot({ address, children }: AddressSummaryRootProps) {\n  return <AddressSummaryContext.Provider value={address}>{children}</AddressSummaryContext.Provider>;\n}\n\nexport function AddressSummary({ className, children }: AddressSummaryProps) {\n  return (\n    <div className={className} data-fs-address-summary=\"\">\n      {children ?? (\n        <>\n          <AddressSummaryRecipient />\n          <AddressSummaryStreet />\n          <AddressSummaryLocality />\n        </>\n      )}\n    </div>\n  );\n}\n\n/** Who the delivery is addressed to. Renders nothing when the address carries no recipient. */\nexport function AddressSummaryRecipient({ className }: AddressSummaryLineProps) {\n  const { recipientName } = useAddressSummary();\n  if (!recipientName) return null;\n  return (\n    <p className={className} data-fs-address-summary-recipient=\"\">\n      {recipientName}\n    </p>\n  );\n}\n\n/** Street, number and complement on one line. Renders nothing when all three are absent. */\nexport function AddressSummaryStreet({ className }: AddressSummaryLineProps) {\n  const { street, number, complement } = useAddressSummary();\n  const line = [[street, number].filter(Boolean).join(', '), complement].filter(Boolean).join(' - ');\n  if (!line) return null;\n  return (\n    <p className={className} data-fs-address-summary-address=\"\">\n      {line}\n    </p>\n  );\n}\n\n/** Neighborhood, city, state and postal code on one line. Renders nothing when all are absent. */\nexport function AddressSummaryLocality({ className }: AddressSummaryLineProps) {\n  const { neighborhood, city, state, postalCode } = useAddressSummary();\n  const line = [neighborhood, [city, state].filter(Boolean).join(' - '), postalCode].filter(Boolean).join(', ');\n  if (!line) return null;\n  return (\n    <p className={className} data-fs-address-summary-locality=\"\">\n      {line}\n    </p>\n  );\n}\n\n/** The shopper's own label for the address. Renders nothing when the address carries no name. */\nexport function AddressSummaryName({ className }: AddressSummaryNameProps) {\n  const { name } = useAddressSummary();\n  if (!name) return null;\n  return (\n    <p className={className} data-fs-address-summary-name=\"\">\n      {name}\n    </p>\n  );\n}\n\n/** The address's country, shown as provided. Renders nothing when the address carries no country. */\nexport function AddressSummaryCountry({ className }: AddressSummaryCountryProps) {\n  const { country } = useAddressSummary();\n  if (!country) return null;\n  return (\n    <p className={className} data-fs-address-summary-country=\"\">\n      {country}\n    </p>\n  );\n}\n\n/** One address field, rendered inline. Renders nothing when that field is absent. */\nexport function AddressSummaryField({ field, className }: AddressSummaryFieldProps) {\n  const address = useAddressSummary();\n  const value = address[field];\n  if (!value) return null;\n  return (\n    <span className={className} data-fs-address-summary-field={field}>\n      {value}\n    </span>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/alert-dialog/alert-dialog.d.ts

@@ -15,6 +15,8 @@ export type AlertDialogRootProps = Readonly<{
 export type AlertDialogTriggerProps = ComponentPropsWithRef<'button'>;
 export type AlertDialogPortalProps = Readonly<{
   children?: ReactNode;
+  /** Parent element for the overlay. Omit it and the overlay renders on `document.body`. */
+  container?: ComponentProps<typeof AlertDialog.Portal>['container'];
 }>;
 export type AlertDialogBackdropProps = ComponentPropsWithRef<'div'>;
 export type AlertDialogViewportProps = ComponentPropsWithRef<'div'>;
@@ -36,6 +38,8 @@ export declare const AlertDialogRootDefinition: ComponentDefinition<Readonly<{
 export declare const AlertDialogTriggerDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>;
 export declare const AlertDialogPortalDefinition: ComponentDefinition<Readonly<{
   children?: ReactNode;
+  /** Parent element for the overlay. Omit it and the overlay renders on `document.body`. */
+  container?: ComponentProps<typeof AlertDialog.Portal>["container"];
 }>>;
 export declare const AlertDialogBackdropDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
 export declare const AlertDialogViewportDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
@@ -45,7 +49,7 @@ export declare const AlertDialogDescriptionDefinition: ComponentDefinition<impor
 export declare const AlertDialogCloseDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>;
 export declare function AlertDialogRoot({ open, defaultOpen, onOpenChange, children }: AlertDialogRootProps): import("react/jsx-runtime").JSX.Element;
 export declare function AlertDialogTrigger({ className, children, ...props }: AlertDialogTriggerProps): import("react/jsx-runtime").JSX.Element;
-export declare function AlertDialogPortal({ children }: AlertDialogPortalProps): import("react/jsx-runtime").JSX.Element;
+export declare function AlertDialogPortal({ children, container }: AlertDialogPortalProps): import("react/jsx-runtime").JSX.Element;
 export declare function AlertDialogBackdrop({ className, children, ...props }: AlertDialogBackdropProps): import("react/jsx-runtime").JSX.Element;
 export declare function AlertDialogViewport({ className, children, ...props }: AlertDialogViewportProps): import("react/jsx-runtime").JSX.Element;
 export declare function AlertDialogPopup({ className, children, ...props }: AlertDialogPopupProps): import("react/jsx-runtime").JSX.Element;

package/dist/particles/alert-dialog/alert-dialog.js

@@ -119,8 +119,11 @@ function AlertDialogTrigger({ className, children, ...props }) {
 		children
 	});
 }
-function AlertDialogPortal({ children }) {
-	return /* @__PURE__ */ jsx(AlertDialog.Portal, { children });
+function AlertDialogPortal({ children, container }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Portal, {
+		container,
+		children
+	});
 }
 function AlertDialogBackdrop({ className, children, ...props }) {
 	return /* @__PURE__ */ jsx(AlertDialog.Backdrop, {

package/dist/particles/alert-dialog/alert-dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert-dialog.js","names":["BaseAlertDialog","AlertDialog"],"sources":["../../../src/particles/alert-dialog/alert-dialog.tsx"],"sourcesContent":["'use client';\nimport { AlertDialog as BaseAlertDialog } from '@base-ui/react/alert-dialog';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentProps, ComponentPropsWithRef, ReactNode } from 'react';\n\ntype BasePopupProps = ComponentProps<typeof BaseAlertDialog.Popup>;\n\nexport type AlertDialogRootProps = Readonly<{\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean, eventDetails: { isCanceled: boolean }) => void;\n  children?: ReactNode;\n}>;\n\nexport type AlertDialogTriggerProps = ComponentPropsWithRef<'button'>;\n\nexport type AlertDialogPortalProps = Readonly<{\n  children?: ReactNode;\n}>;\n\nexport type AlertDialogBackdropProps = ComponentPropsWithRef<'div'>;\n\nexport type AlertDialogViewportProps = ComponentPropsWithRef<'div'>;\n\nexport type AlertDialogPopupProps = ComponentPropsWithRef<'div'> & {\n  initialFocus?: BasePopupProps['initialFocus'];\n  finalFocus?: BasePopupProps['finalFocus'];\n};\n\nexport type AlertDialogTitleProps = ComponentPropsWithRef<'h2'>;\n\nexport type AlertDialogDescriptionProps = ComponentPropsWithRef<'p'>;\n\nexport type AlertDialogCloseProps = ComponentPropsWithRef<'button'>;\n\nexport const AlertDialogRootDefinition = defineComponent<AlertDialogRootProps>({\n  name: 'AlertDialogRoot',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogRoot,\n  editor: { label: 'Alert Dialog Root', category: 'layout' },\n  schema: {},\n  guideline:\n    'Root of a confirmation prompt for an irreversible action. Compose as: AlertDialogRoot > (AlertDialogTrigger + AlertDialogPortal > (AlertDialogBackdrop + AlertDialogViewport > AlertDialogPopup > (AlertDialogTitle + AlertDialogDescription + AlertDialogClose + your confirm Button))). Always modal and never closes on an outside click; only Escape or an AlertDialogClose dismisses it. Use Dialog instead when a stray click may close the overlay.',\n});\n\nexport const AlertDialogTriggerDefinition = defineComponent<AlertDialogTriggerProps>({\n  name: 'AlertDialogTrigger',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogTrigger,\n  editor: { label: 'Alert Dialog Trigger', category: 'action' },\n  schema: {},\n  guideline:\n    'Opens the alert dialog when clicked. Direct child of AlertDialogRoot. Accepts any children (text, Icon). Base UI connects it to AlertDialogRoot via context — no explicit wiring needed.',\n});\n\nexport const AlertDialogPortalDefinition = defineComponent<AlertDialogPortalProps>({\n  name: 'AlertDialogPortal',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogPortal,\n  editor: { label: 'Alert Dialog Portal', category: 'layout' },\n  schema: {},\n  guideline:\n    'Renders its children outside the DOM tree (into document.body). Place AlertDialogBackdrop and AlertDialogViewport as direct children, in that order.',\n});\n\nexport const AlertDialogBackdropDefinition = defineComponent<AlertDialogBackdropProps>({\n  name: 'AlertDialogBackdrop',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogBackdrop,\n  editor: { label: 'Alert Dialog Backdrop', category: 'layout' },\n  schema: {},\n  guideline:\n    'Semi-transparent overlay behind the popup. Direct child of AlertDialogPortal, before AlertDialogViewport. Clicking it does not close the alert dialog.',\n});\n\nexport const AlertDialogViewportDefinition = defineComponent<AlertDialogViewportProps>({\n  name: 'AlertDialogViewport',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogViewport,\n  editor: { label: 'Alert Dialog Viewport', category: 'layout' },\n  schema: {},\n  guideline:\n    'Positioning container for AlertDialogPopup. Direct child of AlertDialogPortal, after AlertDialogBackdrop. Apply fixed positioning and centering here (e.g. fixed inset-0 flex items-center justify-center). Place AlertDialogPopup inside.',\n});\n\nexport const AlertDialogPopupDefinition = defineComponent<AlertDialogPopupProps>({\n  name: 'AlertDialogPopup',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogPopup,\n  editor: { label: 'Alert Dialog Popup', category: 'layout' },\n  schema: {},\n  guideline:\n    'The visible prompt, inside AlertDialogViewport, with role alertdialog. Place AlertDialogTitle (required), AlertDialogDescription, an AlertDialogClose for cancel, and a confirm Button inside. Focus starts on the first focusable element, except when opened by touch, where Base UI focuses the popup itself: put the cancel control first, and pass initialFocus (a ref) when Cancel must receive focus for every kind of interaction.',\n});\n\nexport const AlertDialogTitleDefinition = defineComponent<AlertDialogTitleProps>({\n  name: 'AlertDialogTitle',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogTitle,\n  editor: { label: 'Alert Dialog Title', category: 'layout' },\n  schema: {},\n  guideline:\n    'Required heading inside AlertDialogPopup — sets the accessible name of the alert dialog for screen readers. State the question, e.g. \"Delete this address?\".',\n});\n\nexport const AlertDialogDescriptionDefinition = defineComponent<AlertDialogDescriptionProps>({\n  name: 'AlertDialogDescription',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogDescription,\n  editor: { label: 'Alert Dialog Description', category: 'layout' },\n  schema: {},\n  guideline:\n    'Description inside AlertDialogPopup, after AlertDialogTitle. Screen readers announce it with the prompt, so use it to state the consequence of confirming.',\n});\n\nexport const AlertDialogCloseDefinition = defineComponent<AlertDialogCloseProps>({\n  name: 'AlertDialogClose',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogClose,\n  editor: { label: 'Alert Dialog Close', category: 'action' },\n  schema: {},\n  guideline:\n    'Closes the alert dialog when clicked. Use it for the cancel control inside AlertDialogPopup. The confirm control is a separate Button that runs the consumer action.',\n});\n\nexport function AlertDialogRoot({ open, defaultOpen, onOpenChange, children }: AlertDialogRootProps) {\n  return (\n    <BaseAlertDialog.Root open={open} defaultOpen={defaultOpen} onOpenChange={onOpenChange}>\n      {children}\n    </BaseAlertDialog.Root>\n  );\n}\n\nexport function AlertDialogTrigger({ className, children, ...props }: AlertDialogTriggerProps) {\n  return (\n    <BaseAlertDialog.Trigger {...props} className={className} data-fs-alert-dialog-trigger=\"\">\n      {children}\n    </BaseAlertDialog.Trigger>\n  );\n}\n\nexport function AlertDialogPortal({ children }: AlertDialogPortalProps) {\n  return <BaseAlertDialog.Portal>{children}</BaseAlertDialog.Portal>;\n}\n\nexport function AlertDialogBackdrop({ className, children, ...props }: AlertDialogBackdropProps) {\n  return (\n    <BaseAlertDialog.Backdrop {...props} className={className} data-fs-alert-dialog-backdrop=\"\">\n      {children}\n    </BaseAlertDialog.Backdrop>\n  );\n}\n\nexport function AlertDialogViewport({ className, children, ...props }: AlertDialogViewportProps) {\n  return (\n    <div {...props} className={className} data-fs-alert-dialog-viewport=\"\">\n      {children}\n    </div>\n  );\n}\n\nexport function AlertDialogPopup({ className, children, ...props }: AlertDialogPopupProps) {\n  return (\n    <BaseAlertDialog.Popup {...props} className={className} data-fs-alert-dialog-popup=\"\">\n      {children}\n    </BaseAlertDialog.Popup>\n  );\n}\n\nexport function AlertDialogTitle({ className, children, ...props }: AlertDialogTitleProps) {\n  return (\n    <BaseAlertDialog.Title {...props} className={className} data-fs-alert-dialog-title=\"\">\n      {children}\n    </BaseAlertDialog.Title>\n  );\n}\n\nexport function AlertDialogDescription({ className, children, ...props }: AlertDialogDescriptionProps) {\n  return (\n    <BaseAlertDialog.Description {...props} className={className} data-fs-alert-dialog-description=\"\">\n      {children}\n    </BaseAlertDialog.Description>\n  );\n}\n\nexport function AlertDialogClose({ className, children, ...props }: AlertDialogCloseProps) {\n  return (\n    <BaseAlertDialog.Close {...props} className={className} data-fs-alert-dialog-close=\"\">\n      {children}\n    </BaseAlertDialog.Close>\n  );\n}\n\nexport const AlertDialog = {\n  Root: AlertDialogRoot,\n  Trigger: AlertDialogTrigger,\n  Portal: AlertDialogPortal,\n  Backdrop: AlertDialogBackdrop,\n  Viewport: AlertDialogViewport,\n  Popup: AlertDialogPopup,\n  Title: AlertDialogTitle,\n  Description: AlertDialogDescription,\n  Close: AlertDialogClose,\n};\n"],"mappings":"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"}
+{"version":3,"file":"alert-dialog.js","names":["BaseAlertDialog","AlertDialog"],"sources":["../../../src/particles/alert-dialog/alert-dialog.tsx"],"sourcesContent":["'use client';\nimport { AlertDialog as BaseAlertDialog } from '@base-ui/react/alert-dialog';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentProps, ComponentPropsWithRef, ReactNode } from 'react';\n\ntype BasePopupProps = ComponentProps<typeof BaseAlertDialog.Popup>;\n\nexport type AlertDialogRootProps = Readonly<{\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean, eventDetails: { isCanceled: boolean }) => void;\n  children?: ReactNode;\n}>;\n\nexport type AlertDialogTriggerProps = ComponentPropsWithRef<'button'>;\n\nexport type AlertDialogPortalProps = Readonly<{\n  children?: ReactNode;\n  /** Parent element for the overlay. Omit it and the overlay renders on `document.body`. */\n  container?: ComponentProps<typeof BaseAlertDialog.Portal>['container'];\n}>;\n\nexport type AlertDialogBackdropProps = ComponentPropsWithRef<'div'>;\n\nexport type AlertDialogViewportProps = ComponentPropsWithRef<'div'>;\n\nexport type AlertDialogPopupProps = ComponentPropsWithRef<'div'> & {\n  initialFocus?: BasePopupProps['initialFocus'];\n  finalFocus?: BasePopupProps['finalFocus'];\n};\n\nexport type AlertDialogTitleProps = ComponentPropsWithRef<'h2'>;\n\nexport type AlertDialogDescriptionProps = ComponentPropsWithRef<'p'>;\n\nexport type AlertDialogCloseProps = ComponentPropsWithRef<'button'>;\n\nexport const AlertDialogRootDefinition = defineComponent<AlertDialogRootProps>({\n  name: 'AlertDialogRoot',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogRoot,\n  editor: { label: 'Alert Dialog Root', category: 'layout' },\n  schema: {},\n  guideline:\n    'Root of a confirmation prompt for an irreversible action. Compose as: AlertDialogRoot > (AlertDialogTrigger + AlertDialogPortal > (AlertDialogBackdrop + AlertDialogViewport > AlertDialogPopup > (AlertDialogTitle + AlertDialogDescription + AlertDialogClose + your confirm Button))). Always modal and never closes on an outside click; only Escape or an AlertDialogClose dismisses it. Use Dialog instead when a stray click may close the overlay.',\n});\n\nexport const AlertDialogTriggerDefinition = defineComponent<AlertDialogTriggerProps>({\n  name: 'AlertDialogTrigger',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogTrigger,\n  editor: { label: 'Alert Dialog Trigger', category: 'action' },\n  schema: {},\n  guideline:\n    'Opens the alert dialog when clicked. Direct child of AlertDialogRoot. Accepts any children (text, Icon). Base UI connects it to AlertDialogRoot via context — no explicit wiring needed.',\n});\n\nexport const AlertDialogPortalDefinition = defineComponent<AlertDialogPortalProps>({\n  name: 'AlertDialogPortal',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogPortal,\n  editor: { label: 'Alert Dialog Portal', category: 'layout' },\n  schema: {},\n  guideline:\n    'Renders its children outside the DOM tree (into document.body). Place AlertDialogBackdrop and AlertDialogViewport as direct children, in that order.',\n});\n\nexport const AlertDialogBackdropDefinition = defineComponent<AlertDialogBackdropProps>({\n  name: 'AlertDialogBackdrop',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogBackdrop,\n  editor: { label: 'Alert Dialog Backdrop', category: 'layout' },\n  schema: {},\n  guideline:\n    'Semi-transparent overlay behind the popup. Direct child of AlertDialogPortal, before AlertDialogViewport. Clicking it does not close the alert dialog.',\n});\n\nexport const AlertDialogViewportDefinition = defineComponent<AlertDialogViewportProps>({\n  name: 'AlertDialogViewport',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogViewport,\n  editor: { label: 'Alert Dialog Viewport', category: 'layout' },\n  schema: {},\n  guideline:\n    'Positioning container for AlertDialogPopup. Direct child of AlertDialogPortal, after AlertDialogBackdrop. Apply fixed positioning and centering here (e.g. fixed inset-0 flex items-center justify-center). Place AlertDialogPopup inside.',\n});\n\nexport const AlertDialogPopupDefinition = defineComponent<AlertDialogPopupProps>({\n  name: 'AlertDialogPopup',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogPopup,\n  editor: { label: 'Alert Dialog Popup', category: 'layout' },\n  schema: {},\n  guideline:\n    'The visible prompt, inside AlertDialogViewport, with role alertdialog. Place AlertDialogTitle (required), AlertDialogDescription, an AlertDialogClose for cancel, and a confirm Button inside. Focus starts on the first focusable element, except when opened by touch, where Base UI focuses the popup itself: put the cancel control first, and pass initialFocus (a ref) when Cancel must receive focus for every kind of interaction.',\n});\n\nexport const AlertDialogTitleDefinition = defineComponent<AlertDialogTitleProps>({\n  name: 'AlertDialogTitle',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogTitle,\n  editor: { label: 'Alert Dialog Title', category: 'layout' },\n  schema: {},\n  guideline:\n    'Required heading inside AlertDialogPopup — sets the accessible name of the alert dialog for screen readers. State the question, e.g. \"Delete this address?\".',\n});\n\nexport const AlertDialogDescriptionDefinition = defineComponent<AlertDialogDescriptionProps>({\n  name: 'AlertDialogDescription',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogDescription,\n  editor: { label: 'Alert Dialog Description', category: 'layout' },\n  schema: {},\n  guideline:\n    'Description inside AlertDialogPopup, after AlertDialogTitle. Screen readers announce it with the prompt, so use it to state the consequence of confirming.',\n});\n\nexport const AlertDialogCloseDefinition = defineComponent<AlertDialogCloseProps>({\n  name: 'AlertDialogClose',\n  importPath: '@vtex/faststore/components',\n  component: AlertDialogClose,\n  editor: { label: 'Alert Dialog Close', category: 'action' },\n  schema: {},\n  guideline:\n    'Closes the alert dialog when clicked. Use it for the cancel control inside AlertDialogPopup. The confirm control is a separate Button that runs the consumer action.',\n});\n\nexport function AlertDialogRoot({ open, defaultOpen, onOpenChange, children }: AlertDialogRootProps) {\n  return (\n    <BaseAlertDialog.Root open={open} defaultOpen={defaultOpen} onOpenChange={onOpenChange}>\n      {children}\n    </BaseAlertDialog.Root>\n  );\n}\n\nexport function AlertDialogTrigger({ className, children, ...props }: AlertDialogTriggerProps) {\n  return (\n    <BaseAlertDialog.Trigger {...props} className={className} data-fs-alert-dialog-trigger=\"\">\n      {children}\n    </BaseAlertDialog.Trigger>\n  );\n}\n\nexport function AlertDialogPortal({ children, container }: AlertDialogPortalProps) {\n  return <BaseAlertDialog.Portal container={container}>{children}</BaseAlertDialog.Portal>;\n}\n\nexport function AlertDialogBackdrop({ className, children, ...props }: AlertDialogBackdropProps) {\n  return (\n    <BaseAlertDialog.Backdrop {...props} className={className} data-fs-alert-dialog-backdrop=\"\">\n      {children}\n    </BaseAlertDialog.Backdrop>\n  );\n}\n\nexport function AlertDialogViewport({ className, children, ...props }: AlertDialogViewportProps) {\n  return (\n    <div {...props} className={className} data-fs-alert-dialog-viewport=\"\">\n      {children}\n    </div>\n  );\n}\n\nexport function AlertDialogPopup({ className, children, ...props }: AlertDialogPopupProps) {\n  return (\n    <BaseAlertDialog.Popup {...props} className={className} data-fs-alert-dialog-popup=\"\">\n      {children}\n    </BaseAlertDialog.Popup>\n  );\n}\n\nexport function AlertDialogTitle({ className, children, ...props }: AlertDialogTitleProps) {\n  return (\n    <BaseAlertDialog.Title {...props} className={className} data-fs-alert-dialog-title=\"\">\n      {children}\n    </BaseAlertDialog.Title>\n  );\n}\n\nexport function AlertDialogDescription({ className, children, ...props }: AlertDialogDescriptionProps) {\n  return (\n    <BaseAlertDialog.Description {...props} className={className} data-fs-alert-dialog-description=\"\">\n      {children}\n    </BaseAlertDialog.Description>\n  );\n}\n\nexport function AlertDialogClose({ className, children, ...props }: AlertDialogCloseProps) {\n  return (\n    <BaseAlertDialog.Close {...props} className={className} data-fs-alert-dialog-close=\"\">\n      {children}\n    </BaseAlertDialog.Close>\n  );\n}\n\nexport const AlertDialog = {\n  Root: AlertDialogRoot,\n  Trigger: AlertDialogTrigger,\n  Portal: AlertDialogPortal,\n  Backdrop: AlertDialogBackdrop,\n  Viewport: AlertDialogViewport,\n  Popup: AlertDialogPopup,\n  Title: AlertDialogTitle,\n  Description: AlertDialogDescription,\n  Close: AlertDialogClose,\n};\n"],"mappings":"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"}

package/dist/particles/avatar/avatar.d.ts

@@ -0,0 +1,17 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/particles/avatar/avatar.d.ts
+/** Props for {@link Avatar}. Extends the native `<span>` attributes, minus `children`. */
+export type AvatarProps = Omit<ComponentPropsWithRef<'span'>, 'children'> & {
+  /** Whose avatar this is. The initials derive from it. */
+  name?: string;
+  /** Image URL. Absent or empty, the initials show. */
+  src?: string;
+  /** Accessible name. Absent, the avatar is decorative and hidden from assistive technology. */
+  alt?: string;
+};
+export declare const AvatarDefinition: ComponentDefinition<AvatarProps>;
+export declare function Avatar({ name, src, alt, className, ...props }: AvatarProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=avatar.d.ts.map

package/dist/particles/avatar/avatar.js

@@ -0,0 +1,65 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Avatar } from "@base-ui/react/avatar";
+//#region src/particles/avatar/avatar.tsx
+const AvatarDefinition = defineComponent({
+	name: "Avatar",
+	importPath: "@vtex/faststore/components",
+	component: Avatar$1,
+	editor: {
+		label: "Avatar",
+		category: "content"
+	},
+	schema: {
+		name: {
+			type: "string",
+			label: "Name"
+		},
+		src: {
+			type: "string",
+			label: "Image URL"
+		},
+		alt: {
+			type: "string",
+			label: "Alt Text"
+		}
+	},
+	guideline: "A person or account marker: an image with an initials fallback derived from `name`. Decorative unless `alt` is set, so give it an `alt` whenever no adjacent text names the person. Style it through data-fs-avatar."
+});
+/**
+* The first code point of the first and last words of `name`, uppercased. One word yields one initial,
+* and no words yields an empty string. Code points rather than UTF-16 units, so an astral-plane letter
+* is not split in half.
+*/
+function getAvatarInitials(name) {
+	const words = name.trim().split(/\s+/).filter(Boolean);
+	const first = words[0];
+	const last = words.at(-1);
+	if (first === void 0 || last === void 0) return "";
+	const initial = (word) => Array.from(word)[0] ?? "";
+	return (words.length === 1 ? initial(first) : initial(first) + initial(last)).toLocaleUpperCase();
+}
+function Avatar$1({ name = "", src, alt, className, ...props }) {
+	return /* @__PURE__ */ jsxs(Avatar.Root, {
+		...props,
+		className,
+		role: alt ? "img" : void 0,
+		"aria-label": alt || void 0,
+		"aria-hidden": alt ? void 0 : true,
+		"data-fs-avatar": "",
+		children: [src ? /* @__PURE__ */ jsx(Avatar.Image, {
+			src,
+			alt: "",
+			"data-fs-avatar-image": ""
+		}) : null, /* @__PURE__ */ jsx(Avatar.Fallback, {
+			"data-fs-avatar-fallback": "",
+			children: getAvatarInitials(name)
+		})]
+	});
+}
+//#endregion
+export { Avatar$1 as Avatar, AvatarDefinition, getAvatarInitials };
+
+//# sourceMappingURL=avatar.js.map

package/dist/particles/avatar/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.js","names":["Avatar","BaseAvatar"],"sources":["../../../src/particles/avatar/avatar.tsx"],"sourcesContent":["'use client';\n\nimport { Avatar as BaseAvatar } from '@base-ui/react/avatar';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\n\n/** Props for {@link Avatar}. Extends the native `<span>` attributes, minus `children`. */\nexport type AvatarProps = Omit<ComponentPropsWithRef<'span'>, 'children'> & {\n  /** Whose avatar this is. The initials derive from it. */\n  name?: string;\n  /** Image URL. Absent or empty, the initials show. */\n  src?: string;\n  /** Accessible name. Absent, the avatar is decorative and hidden from assistive technology. */\n  alt?: string;\n};\n\nexport const AvatarDefinition = defineComponent<AvatarProps>({\n  name: 'Avatar',\n  importPath: '@vtex/faststore/components',\n  component: Avatar,\n  editor: { label: 'Avatar', category: 'content' },\n  schema: {\n    name: { type: 'string', label: 'Name' },\n    src: { type: 'string', label: 'Image URL' },\n    alt: { type: 'string', label: 'Alt Text' },\n  },\n  guideline:\n    'A person or account marker: an image with an initials fallback derived from `name`. Decorative unless `alt` is set, so give it an `alt` whenever no adjacent text names the person. Style it through data-fs-avatar.',\n});\n\n/**\n * The first code point of the first and last words of `name`, uppercased. One word yields one initial,\n * and no words yields an empty string. Code points rather than UTF-16 units, so an astral-plane letter\n * is not split in half.\n */\nexport function getAvatarInitials(name: string): string {\n  const words = name.trim().split(/\\s+/).filter(Boolean);\n  const first = words[0];\n  const last = words.at(-1);\n  if (first === undefined || last === undefined) {\n    return '';\n  }\n\n  const initial = (word: string) => Array.from(word)[0] ?? '';\n  const initials = words.length === 1 ? initial(first) : initial(first) + initial(last);\n  return initials.toLocaleUpperCase();\n}\n\nexport function Avatar({ name = '', src, alt, className, ...props }: AvatarProps) {\n  return (\n    <BaseAvatar.Root\n      {...props}\n      className={className}\n      role={alt ? 'img' : undefined}\n      aria-label={alt || undefined}\n      aria-hidden={alt ? undefined : true}\n      data-fs-avatar=\"\"\n    >\n      {src ? <BaseAvatar.Image src={src} alt=\"\" data-fs-avatar-image=\"\" /> : null}\n      <BaseAvatar.Fallback data-fs-avatar-fallback=\"\">{getAvatarInitials(name)}</BaseAvatar.Fallback>\n    </BaseAvatar.Root>\n  );\n}\n"],"mappings":";;;;;;AAgBA,MAAa,mBAAmB,gBAA6B;CAC3D,MAAM;CACN,YAAY;CACZ,WAAWA;CACX,QAAQ;EAAE,OAAO;EAAU,UAAU;CAAU;CAC/C,QAAQ;EACN,MAAM;GAAE,MAAM;GAAU,OAAO;EAAO;EACtC,KAAK;GAAE,MAAM;GAAU,OAAO;EAAY;EAC1C,KAAK;GAAE,MAAM;GAAU,OAAO;EAAW;CAC3C;CACA,WACE;AACJ,CAAC;;;;;;AAOD,SAAgB,kBAAkB,MAAsB;CACtD,MAAM,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;CACrD,MAAM,QAAQ,MAAM;CACpB,MAAM,OAAO,MAAM,GAAG,EAAE;CACxB,IAAI,UAAU,KAAA,KAAa,SAAS,KAAA,GAClC,OAAO;CAGT,MAAM,WAAW,SAAiB,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM;CAEzD,QADiB,MAAM,WAAW,IAAI,QAAQ,KAAK,IAAI,QAAQ,KAAK,IAAI,QAAQ,IAAI,EAAA,CACpE,kBAAkB;AACpC;AAEA,SAAgBA,SAAO,EAAE,OAAO,IAAI,KAAK,KAAK,WAAW,GAAG,SAAsB;CAChF,OACE,qBAACC,OAAW,MAAZ;EACE,GAAI;EACO;EACX,MAAM,MAAM,QAAQ,KAAA;EACpB,cAAY,OAAO,KAAA;EACnB,eAAa,MAAM,KAAA,IAAY;EAC/B,kBAAe;EANjB,UAAA,CAQG,MAAM,oBAACA,OAAW,OAAZ;GAAuB;GAAK,KAAI;GAAG,wBAAqB;EAAI,CAAA,IAAI,MACvE,oBAACA,OAAW,UAAZ;GAAqB,2BAAwB;GAAI,UAAA,kBAAkB,IAAI;EAAuB,CAAA,CAC/E;;AAErB"}

package/dist/particles/copy-text/copy-text.d.ts

@@ -0,0 +1,28 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ReactNode, Ref } from "react";
+//#region src/particles/copy-text/copy-text.d.ts
+export type CopyTextOutcome = 'idle' | 'pending' | 'success' | 'failure';
+export type CopyTextProps = Readonly<{
+  text: string;
+  accessibleName?: string;
+  successMessage?: string;
+  failureMessage?: string;
+  dismissLabel?: string;
+  children?: ReactNode;
+  className?: string;
+  ref?: Ref<HTMLSpanElement>;
+}>;
+export declare const CopyTextDefinition: ComponentDefinition<Readonly<{
+  text: string;
+  accessibleName?: string;
+  successMessage?: string;
+  failureMessage?: string;
+  dismissLabel?: string;
+  children?: ReactNode;
+  className?: string;
+  ref?: Ref<HTMLSpanElement>;
+}>>;
+export declare function CopyText({ text, accessibleName, successMessage, failureMessage, dismissLabel, children, className, ref }: CopyTextProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=copy-text.d.ts.map

package/dist/particles/copy-text/copy-text.js

@@ -0,0 +1,140 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useIntl } from "../../sdk/i18n/client.js";
+import { Button } from "../button/button.js";
+import { useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/particles/copy-text/copy-text.tsx
+const CLEAR_AFTER_MS = 5e3;
+function isBlank(text) {
+	return text.trim().length === 0;
+}
+const CopyTextDefinition = defineComponent({
+	name: "CopyText",
+	importPath: "@vtex/faststore/components",
+	component: CopyText,
+	editor: {
+		label: "Copy Text",
+		category: "action"
+	},
+	schema: {
+		accessibleName: {
+			type: "string",
+			default: "Copy",
+			label: "Accessible name"
+		},
+		successMessage: {
+			type: "string",
+			default: "Copied",
+			label: "Success message"
+		},
+		failureMessage: {
+			type: "string",
+			default: "Could not copy",
+			label: "Failure message"
+		},
+		dismissLabel: {
+			type: "string",
+			default: "Dismiss",
+			label: "Dismiss label"
+		}
+	},
+	guideline: "Copies the text it is given and confirms the result inline. Pass the identifier as text and the visible icon or label as children. Do not pass surrounding heading text."
+});
+function CopyText({ text, accessibleName, successMessage, failureMessage, dismissLabel, children, className, ref }) {
+	const intl = useIntl();
+	const name = accessibleName ?? intl.formatMessage({ id: "fs/order.copy.action" });
+	const success = successMessage ?? intl.formatMessage({ id: "fs/order.copy.copied" });
+	const failure = failureMessage ?? intl.formatMessage({ id: "fs/order.copy.failure" });
+	const dismissText = dismissLabel ?? intl.formatMessage({ id: "fs/order.copy.dismiss" });
+	const [outcome, setOutcome] = useState("idle");
+	const actionRef = useRef(null);
+	const timerRef = useRef(null);
+	const generation = useRef(0);
+	const active = useRef(true);
+	function clearTimer() {
+		if (timerRef.current === null) return;
+		clearTimeout(timerRef.current);
+		timerRef.current = null;
+	}
+	useEffect(() => {
+		active.current = true;
+		return () => {
+			active.current = false;
+			if (timerRef.current === null) return;
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		};
+	}, []);
+	function scheduleClear(token) {
+		clearTimer();
+		if (!active.current) return;
+		timerRef.current = setTimeout(() => {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("idle");
+		}, CLEAR_AFTER_MS);
+	}
+	async function copy() {
+		if (isBlank(text) || outcome === "pending") return;
+		const token = generation.current + 1;
+		generation.current = token;
+		clearTimer();
+		setOutcome("pending");
+		const write = navigator.clipboard?.writeText;
+		if (typeof write !== "function") {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("failure");
+			scheduleClear(token);
+			return;
+		}
+		try {
+			await write.call(navigator.clipboard, text);
+			if (!active.current || generation.current !== token) return;
+			setOutcome("success");
+		} catch {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("failure");
+		}
+		scheduleClear(token);
+	}
+	useEffect(() => {
+		if (outcome === "success" || outcome === "failure") actionRef.current?.focus();
+	}, [outcome]);
+	function dismiss() {
+		generation.current += 1;
+		clearTimer();
+		setOutcome("idle");
+		actionRef.current?.focus();
+	}
+	const message = outcome === "success" ? success : failure;
+	return /* @__PURE__ */ jsxs("span", {
+		ref,
+		className,
+		"data-fs-copy-text": "",
+		"data-fs-copy-text-outcome": outcome,
+		children: [/* @__PURE__ */ jsx(Button, {
+			ref: actionRef,
+			type: "button",
+			"aria-label": name,
+			"data-fs-copy-text-action": "",
+			disabled: isBlank(text) || outcome === "pending",
+			onClick: () => {
+				copy();
+			},
+			children
+		}), outcome === "success" || outcome === "failure" ? /* @__PURE__ */ jsxs("output", {
+			"data-fs-copy-text-message": "",
+			children: [message, /* @__PURE__ */ jsx(Button, {
+				type: "button",
+				"aria-label": dismissText,
+				onClick: dismiss,
+				children: dismissText
+			})]
+		}) : null]
+	});
+}
+//#endregion
+export { CopyText, CopyTextDefinition };
+
+//# sourceMappingURL=copy-text.js.map

package/dist/particles/copy-text/copy-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-text.js","names":[],"sources":["../../../src/particles/copy-text/copy-text.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { type ReactNode, type Ref, useEffect, useRef, useState } from 'react';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { Button } from '../button/button';\n\nconst CLEAR_AFTER_MS = 5000;\n\nexport type CopyTextOutcome = 'idle' | 'pending' | 'success' | 'failure';\n\nexport type CopyTextProps = Readonly<{\n  text: string;\n  accessibleName?: string;\n  successMessage?: string;\n  failureMessage?: string;\n  dismissLabel?: string;\n  children?: ReactNode;\n  className?: string;\n  ref?: Ref<HTMLSpanElement>;\n}>;\n\nfunction isBlank(text: string): boolean {\n  return text.trim().length === 0;\n}\n\nexport const CopyTextDefinition = defineComponent<CopyTextProps>({\n  name: 'CopyText',\n  importPath: '@vtex/faststore/components',\n  component: CopyText,\n  editor: { label: 'Copy Text', category: 'action' },\n  schema: {\n    accessibleName: { type: 'string', default: 'Copy', label: 'Accessible name' },\n    successMessage: { type: 'string', default: 'Copied', label: 'Success message' },\n    failureMessage: { type: 'string', default: 'Could not copy', label: 'Failure message' },\n    dismissLabel: { type: 'string', default: 'Dismiss', label: 'Dismiss label' },\n  },\n  guideline:\n    'Copies the text it is given and confirms the result inline. Pass the identifier as text and the visible icon or label as children. Do not pass surrounding heading text.',\n});\n\nexport function CopyText({\n  text,\n  accessibleName,\n  successMessage,\n  failureMessage,\n  dismissLabel,\n  children,\n  className,\n  ref,\n}: CopyTextProps) {\n  const intl = useIntl();\n  const name = accessibleName ?? intl.formatMessage({ id: 'fs/order.copy.action' });\n  const success = successMessage ?? intl.formatMessage({ id: 'fs/order.copy.copied' });\n  const failure = failureMessage ?? intl.formatMessage({ id: 'fs/order.copy.failure' });\n  const dismissText = dismissLabel ?? intl.formatMessage({ id: 'fs/order.copy.dismiss' });\n  const [outcome, setOutcome] = useState<CopyTextOutcome>('idle');\n  const actionRef = useRef<HTMLButtonElement>(null);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const generation = useRef(0);\n  const active = useRef(true);\n\n  function clearTimer() {\n    if (timerRef.current === null) return;\n    clearTimeout(timerRef.current);\n    timerRef.current = null;\n  }\n\n  useEffect(() => {\n    active.current = true;\n    return () => {\n      active.current = false;\n      if (timerRef.current === null) return;\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    };\n  }, []);\n\n  function scheduleClear(token: number) {\n    clearTimer();\n    if (!active.current) return;\n    timerRef.current = setTimeout(() => {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('idle');\n    }, CLEAR_AFTER_MS);\n  }\n\n  async function copy() {\n    if (isBlank(text) || outcome === 'pending') return;\n    const token = generation.current + 1;\n    generation.current = token;\n    clearTimer();\n    setOutcome('pending');\n\n    const write = navigator.clipboard?.writeText;\n    if (typeof write !== 'function') {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('failure');\n      scheduleClear(token);\n      return;\n    }\n\n    try {\n      await write.call(navigator.clipboard, text);\n      if (!active.current || generation.current !== token) return;\n      setOutcome('success');\n    } catch {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('failure');\n    }\n    scheduleClear(token);\n  }\n\n  // The action is disabled while pending, and a disabled control ignores focus(). Focus moves back\n  // once the outcome that re-enables it has committed.\n  useEffect(() => {\n    if (outcome === 'success' || outcome === 'failure') {\n      actionRef.current?.focus();\n    }\n  }, [outcome]);\n\n  function dismiss() {\n    generation.current += 1;\n    clearTimer();\n    setOutcome('idle');\n    actionRef.current?.focus();\n  }\n\n  const message = outcome === 'success' ? success : failure;\n\n  return (\n    <span ref={ref} className={className} data-fs-copy-text=\"\" data-fs-copy-text-outcome={outcome}>\n      <Button\n        ref={actionRef}\n        type=\"button\"\n        aria-label={name}\n        data-fs-copy-text-action=\"\"\n        disabled={isBlank(text) || outcome === 'pending'}\n        onClick={() => {\n          void copy();\n        }}\n      >\n        {children}\n      </Button>\n      {outcome === 'success' || outcome === 'failure' ? (\n        <output data-fs-copy-text-message=\"\">\n          {message}\n          <Button type=\"button\" aria-label={dismissText} onClick={dismiss}>\n            {dismissText}\n          </Button>\n        </output>\n      ) : null}\n    </span>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/document-field/document-field.d.ts

@@ -3,13 +3,18 @@ import "../../core/dist/index.js";
 import { applyMask } from "../shared/input-mask.js";
 import { ComponentPropsWithRef, FocusEvent, ReactNode, Ref } from "react";
 //#region src/particles/document-field/document-field.d.ts
-export type DocumentType = 'CPF';
+export type DocumentType = 'CPF' | 'SSN' | 'SIN' | 'RFC';
 type DocumentFieldRequirement = 'mandatory' | 'optional';
 export type DocumentSpec = {
   id: DocumentType;
   name: string;
   mask: string;
+  placeholder: string;
+  /** Strips what the type never holds, before the mask runs. */
+  sanitize: (raw: string) => string;
   validate: (value: string) => boolean;
+  /** `'off'` for SSN and SIN, absent for CPF and RFC (Decision 9). */
+  autoComplete?: 'off';
 };
 export type DocumentFieldProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref' | 'dangerouslySetInnerHTML'> & {
   /** Unused on the bound path — react-hook-form owns the value. */
@@ -54,9 +59,33 @@ export type DocumentFieldProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValu
  * digits. Runs on blur/submit only, never per keystroke.
  */
 export declare function validateCPF(value: string): boolean;
+/**
+ * SSN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+ * requires exactly 9 digits, refuses area `000`, `666` and `>= 900`, group `00` and serial `0000`.
+ */
+export declare function validateSSN(value: string): boolean;
+/**
+ * SIN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+ * requires exactly 9 digits, refuses all zeros, and verifies the Luhn check.
+ */
+export declare function validateSIN(value: string): boolean;
+/**
+ * RFC (individual) validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16): after
+ * uppercasing and stripping every non A-Z0-9 character it is four letters, six digits and three
+ * letters or digits, and characters 5-10 read as a plausible month (1-12) and day (1-31). The day check
+ * is not calendar-aware, as in the library. The library's set of refused four-letter prefixes is not
+ * carried (the structure and the date are what a typo breaks).
+ */
+export declare function validateRFC(value: string): boolean;
 export declare const DOCUMENTS: Record<DocumentType, DocumentSpec>;
 /**
- * True when `type` is a document type this build supports (lets a host gate the field by locale).
+ * Turns the API's lower-case document id (`Payment.countries[].documents[].type`) into this table's key,
+ * or `null` for anything else, including a business document, a prototype key and a non-string.
+ */
+export declare function documentTypeFromId(id: unknown): DocumentType | null;
+/**
+ * True when `type` is one of the table's upper-case keys (`CPF`, `SSN`, `SIN`, `RFC`); the API's lower-case
+ * ids go through `documentTypeFromId`. Lets a host gate the field by locale.
  *
  * `Object.hasOwn`, not the `in` operator: `in` walks the prototype chain, so `constructor`,
  * `__proto__` and `toString` all satisfied it and were then trusted as a `DocumentType` by callers
@@ -66,9 +95,9 @@ export declare const DOCUMENTS: Record<DocumentType, DocumentSpec>;
  */
 export declare function isSupportedDocumentType(type: unknown): type is DocumentType;
 /**
- * Apply a document type's mask to raw input: strip non-digits for digit-only masks, then truncate to
- * the mask's slot count so excess characters never trail past the mask (e.g. a 15-digit paste into
- * the 11-slot CPF mask yields `111.444.777-35`, not `111.444.777-358888`).
+ * Apply a document type's mask to raw input: run the type's sanitiser, then truncate to the mask's slot
+ * count so excess characters never trail past the mask (e.g. a 15-digit paste into the 11-slot CPF mask
+ * yields `111.444.777-35`, not `111.444.777-358888`).
  */
 export declare function maskDocumentValue(rawValue: string, documentType: DocumentType): string;
 /**