@vtex/faststore 0.0.4 → 0.0.6

package/dist/particles/address-summary/address-summary.d.ts

@@ -12,6 +12,7 @@ import { ReactNode } from "react";
  */
 export type AddressSummaryFields = Readonly<{
   recipientName?: string | null;
+  name?: string | null;
   street?: string | null;
   number?: string | null;
   complement?: string | null;
@@ -19,7 +20,10 @@ export type AddressSummaryFields = Readonly<{
   city?: string | null;
   state?: string | null;
   postalCode?: string | null;
+  country?: string | null;
+  reference?: string | null;
 }>;
+export type AddressSummaryFieldKey = keyof AddressSummaryFields;
 export type AddressSummaryRootProps = {
   /** The address fields provided to descendant presentational components via context. */
   address: AddressSummaryFields;
@@ -33,11 +37,25 @@ export type AddressSummaryProps = {
 export type AddressSummaryLineProps = {
   className?: string;
 };
+export type AddressSummaryNameProps = Readonly<AddressSummaryLineProps>;
+export type AddressSummaryCountryProps = Readonly<AddressSummaryLineProps>;
+export type AddressSummaryFieldProps = Readonly<{
+  /** Which address field to render inline. */
+  field: AddressSummaryFieldKey;
+  className?: string;
+}>;
 export declare const AddressSummaryRootDefinition: ComponentDefinition<AddressSummaryRootProps>;
 export declare const AddressSummaryDefinition: ComponentDefinition<AddressSummaryProps>;
 export declare const AddressSummaryRecipientDefinition: ComponentDefinition<AddressSummaryLineProps>;
 export declare const AddressSummaryStreetDefinition: ComponentDefinition<AddressSummaryLineProps>;
 export declare const AddressSummaryLocalityDefinition: ComponentDefinition<AddressSummaryLineProps>;
+export declare const AddressSummaryNameDefinition: ComponentDefinition<Readonly<AddressSummaryLineProps>>;
+export declare const AddressSummaryCountryDefinition: ComponentDefinition<Readonly<AddressSummaryLineProps>>;
+export declare const AddressSummaryFieldDefinition: ComponentDefinition<Readonly<{
+  /** Which address field to render inline. */
+  field: AddressSummaryFieldKey;
+  className?: string;
+}>>;
 export declare function AddressSummaryRoot({ address, children }: AddressSummaryRootProps): import("react/jsx-runtime").JSX.Element;
 export declare function AddressSummary({ className, children }: AddressSummaryProps): import("react/jsx-runtime").JSX.Element;
 /** Who the delivery is addressed to. Renders nothing when the address carries no recipient. */
@@ -46,5 +64,11 @@ export declare function AddressSummaryRecipient({ className }: AddressSummaryLin
 export declare function AddressSummaryStreet({ className }: AddressSummaryLineProps): import("react/jsx-runtime").JSX.Element | null;
 /** Neighborhood, city, state and postal code on one line. Renders nothing when all are absent. */
 export declare function AddressSummaryLocality({ className }: AddressSummaryLineProps): import("react/jsx-runtime").JSX.Element | null;
+/** The shopper's own label for the address. Renders nothing when the address carries no name. */
+export declare function AddressSummaryName({ className }: AddressSummaryNameProps): import("react/jsx-runtime").JSX.Element | null;
+/** The address's country, shown as provided. Renders nothing when the address carries no country. */
+export declare function AddressSummaryCountry({ className }: AddressSummaryCountryProps): import("react/jsx-runtime").JSX.Element | null;
+/** One address field, rendered inline. Renders nothing when that field is absent. */
+export declare function AddressSummaryField({ field, className }: AddressSummaryFieldProps): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
 //# sourceMappingURL=address-summary.d.ts.map

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

@@ -32,7 +32,7 @@ const AddressSummaryDefinition = defineComponent({
 		category: "content"
 	},
 	schema: {},
-	guideline: "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. Must be a descendant of AddressSummaryRoot."
+	guideline: "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."
 });
 const AddressSummaryRecipientDefinition = defineComponent({
 	name: "AddressSummaryRecipient",
@@ -70,6 +70,57 @@ const AddressSummaryLocalityDefinition = defineComponent({
 	schema: {},
 	guideline: "Neighborhood, city, state and postal code on one line, or nothing when all are absent. Must be a descendant of AddressSummaryRoot."
 });
+const AddressSummaryNameDefinition = defineComponent({
+	name: "AddressSummaryName",
+	importPath: "@vtex/faststore/components",
+	component: AddressSummaryName,
+	requiresContext: "address-summary",
+	editor: {
+		label: "Address Summary Name",
+		category: "content"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AddressSummaryCountryDefinition = defineComponent({
+	name: "AddressSummaryCountry",
+	importPath: "@vtex/faststore/components",
+	component: AddressSummaryCountry,
+	requiresContext: "address-summary",
+	editor: {
+		label: "Address Summary Country",
+		category: "content"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AddressSummaryFieldDefinition = defineComponent({
+	name: "AddressSummaryField",
+	importPath: "@vtex/faststore/components",
+	component: AddressSummaryField,
+	requiresContext: "address-summary",
+	editor: {
+		label: "Address Summary Field",
+		category: "content"
+	},
+	schema: { field: {
+		type: [
+			"recipientName",
+			"name",
+			"street",
+			"number",
+			"complement",
+			"neighborhood",
+			"city",
+			"state",
+			"postalCode",
+			"country",
+			"reference"
+		],
+		label: "Field"
+	} },
+	guideline: "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."
+});
 function AddressSummaryRoot({ address, children }) {
 	return /* @__PURE__ */ jsx(AddressSummaryContext.Provider, {
 		value: address,
@@ -123,7 +174,37 @@ function AddressSummaryLocality({ className }) {
 		children: line
 	});
 }
+/** The shopper's own label for the address. Renders nothing when the address carries no name. */
+function AddressSummaryName({ className }) {
+	const { name } = useAddressSummary();
+	if (!name) return null;
+	return /* @__PURE__ */ jsx("p", {
+		className,
+		"data-fs-address-summary-name": "",
+		children: name
+	});
+}
+/** The address's country, shown as provided. Renders nothing when the address carries no country. */
+function AddressSummaryCountry({ className }) {
+	const { country } = useAddressSummary();
+	if (!country) return null;
+	return /* @__PURE__ */ jsx("p", {
+		className,
+		"data-fs-address-summary-country": "",
+		children: country
+	});
+}
+/** One address field, rendered inline. Renders nothing when that field is absent. */
+function AddressSummaryField({ field, className }) {
+	const value = useAddressSummary()[field];
+	if (!value) return null;
+	return /* @__PURE__ */ jsx("span", {
+		className,
+		"data-fs-address-summary-field": field,
+		children: value
+	});
+}
 //#endregion
-export { AddressSummary, AddressSummaryDefinition, AddressSummaryLocality, AddressSummaryLocalityDefinition, AddressSummaryRecipient, AddressSummaryRecipientDefinition, AddressSummaryRoot, AddressSummaryRootDefinition, AddressSummaryStreet, AddressSummaryStreetDefinition, useAddressSummary };
+export { AddressSummary, AddressSummaryCountry, AddressSummaryCountryDefinition, AddressSummaryDefinition, AddressSummaryField, AddressSummaryFieldDefinition, AddressSummaryLocality, AddressSummaryLocalityDefinition, AddressSummaryName, AddressSummaryNameDefinition, AddressSummaryRecipient, AddressSummaryRecipientDefinition, AddressSummaryRoot, AddressSummaryRootDefinition, AddressSummaryStreet, AddressSummaryStreetDefinition, useAddressSummary };
 
 //# sourceMappingURL=address-summary.js.map

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  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}>;\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 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. 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 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"],"mappings":";;;;;;AAyBA,MAAM,wBAAwB,cAA2C,IAAI;AAE7E,SAAgB,oBAA0C;CACxD,MAAM,MAAM,WAAW,qBAAqB;CAC5C,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,wDAAwD;CAClF,OAAO;AACT;AAkBA,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAU;CAC7D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,2BAA2B,gBAAqC;CAC3E,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAmB,UAAU;CAAU;CACxD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,oCAAoC,gBAAyC;CACxF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA6B,UAAU;CAAU;CAClE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,iCAAiC,gBAAyC;CACrF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA0B,UAAU;CAAU;CAC/D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,mCAAmC,gBAAyC;CACvF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAU;CACjE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,SAAgB,mBAAmB,EAAE,SAAS,YAAqC;CACjF,OAAO,oBAAC,sBAAsB,UAAvB;EAAgC,OAAO;EAAU;CAAyC,CAAA;AACnG;AAEA,SAAgB,eAAe,EAAE,WAAW,YAAiC;CAC3E,OACE,oBAAC,OAAD;EAAgB;EAAW,2BAAwB;EAChD,UAAA,YACC,qBAAA,UAAA,EAAA,UAAA;GACE,oBAAC,yBAAD,CAA0B,CAAA;GAC1B,oBAAC,sBAAD,CAAuB,CAAA;GACvB,oBAAC,wBAAD,CAAyB,CAAA;EACzB,EAAA,CAAA;CAED,CAAA;AAET;;AAGA,SAAgB,wBAAwB,EAAE,aAAsC;CAC9E,MAAM,EAAE,kBAAkB,kBAAkB;CAC5C,IAAI,CAAC,eAAe,OAAO;CAC3B,OACE,oBAAC,KAAD;EAAc;EAAW,qCAAkC;EACxD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,qBAAqB,EAAE,aAAsC;CAC3E,MAAM,EAAE,QAAQ,QAAQ,eAAe,kBAAkB;CACzD,MAAM,OAAO,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI,GAAG,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CACjG,IAAI,CAAC,MAAM,OAAO;CAClB,OACE,oBAAC,KAAD;EAAc;EAAW,mCAAgC;EACtD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,uBAAuB,EAAE,aAAsC;CAC7E,MAAM,EAAE,cAAc,MAAM,OAAO,eAAe,kBAAkB;CACpE,MAAM,OAAO;EAAC;EAAc,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;EAAG;CAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CAC5G,IAAI,CAAC,MAAM,OAAO;CAClB,OACE,oBAAC,KAAD;EAAc;EAAW,oCAAiC;EACvD,UAAA;CACA,CAAA;AAEP"}
+{"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":";;;;;;AA8BA,MAAM,wBAAwB,cAA2C,IAAI;AAE7E,SAAgB,oBAA0C;CACxD,MAAM,MAAM,WAAW,qBAAqB;CAC5C,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,wDAAwD;CAClF,OAAO;AACT;AA4BA,MAAa,+BAA+B,gBAAyC;CACnF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAwB,UAAU;CAAU;CAC7D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,2BAA2B,gBAAqC;CAC3E,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAmB,UAAU;CAAU;CACxD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,oCAAoC,gBAAyC;CACxF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA6B,UAAU;CAAU;CAClE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,iCAAiC,gBAAyC;CACrF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA0B,UAAU;CAAU;CAC/D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,mCAAmC,gBAAyC;CACvF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA4B,UAAU;CAAU;CACjE,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;CAAU;CAC7D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,kCAAkC,gBAA4C;CACzF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAA2B,UAAU;CAAU;CAChE,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,gCAAgC,gBAA0C;CACrF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,iBAAiB;CACjB,QAAQ;EAAE,OAAO;EAAyB,UAAU;CAAU;CAC9D,QAAQ,EACN,OAAO;EACL,MAAM;GACJ;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF;EACA,OAAO;CACT,EACF;CACA,WACE;AACJ,CAAC;AAED,SAAgB,mBAAmB,EAAE,SAAS,YAAqC;CACjF,OAAO,oBAAC,sBAAsB,UAAvB;EAAgC,OAAO;EAAU;CAAyC,CAAA;AACnG;AAEA,SAAgB,eAAe,EAAE,WAAW,YAAiC;CAC3E,OACE,oBAAC,OAAD;EAAgB;EAAW,2BAAwB;EAChD,UAAA,YACC,qBAAA,UAAA,EAAA,UAAA;GACE,oBAAC,yBAAD,CAA0B,CAAA;GAC1B,oBAAC,sBAAD,CAAuB,CAAA;GACvB,oBAAC,wBAAD,CAAyB,CAAA;EACzB,EAAA,CAAA;CAED,CAAA;AAET;;AAGA,SAAgB,wBAAwB,EAAE,aAAsC;CAC9E,MAAM,EAAE,kBAAkB,kBAAkB;CAC5C,IAAI,CAAC,eAAe,OAAO;CAC3B,OACE,oBAAC,KAAD;EAAc;EAAW,qCAAkC;EACxD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,qBAAqB,EAAE,aAAsC;CAC3E,MAAM,EAAE,QAAQ,QAAQ,eAAe,kBAAkB;CACzD,MAAM,OAAO,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI,GAAG,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CACjG,IAAI,CAAC,MAAM,OAAO;CAClB,OACE,oBAAC,KAAD;EAAc;EAAW,mCAAgC;EACtD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,uBAAuB,EAAE,aAAsC;CAC7E,MAAM,EAAE,cAAc,MAAM,OAAO,eAAe,kBAAkB;CACpE,MAAM,OAAO;EAAC;EAAc,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;EAAG;CAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CAC5G,IAAI,CAAC,MAAM,OAAO;CAClB,OACE,oBAAC,KAAD;EAAc;EAAW,oCAAiC;EACvD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,mBAAmB,EAAE,aAAsC;CACzE,MAAM,EAAE,SAAS,kBAAkB;CACnC,IAAI,CAAC,MAAM,OAAO;CAClB,OACE,oBAAC,KAAD;EAAc;EAAW,gCAA6B;EACnD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,sBAAsB,EAAE,aAAyC;CAC/E,MAAM,EAAE,YAAY,kBAAkB;CACtC,IAAI,CAAC,SAAS,OAAO;CACrB,OACE,oBAAC,KAAD;EAAc;EAAW,mCAAgC;EACtD,UAAA;CACA,CAAA;AAEP;;AAGA,SAAgB,oBAAoB,EAAE,OAAO,aAAuC;CAElF,MAAM,QADU,kBACI,CAAC,CAAC;CACtB,IAAI,CAAC,OAAO,OAAO;CACnB,OACE,oBAAC,QAAD;EAAiB;EAAW,iCAA+B;EACxD,UAAA;CACG,CAAA;AAEV"}

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

@@ -0,0 +1,68 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentProps, ComponentPropsWithRef, ReactNode } from "react";
+import { AlertDialog } from "@base-ui/react/alert-dialog";
+//#region src/particles/alert-dialog/alert-dialog.d.ts
+type BasePopupProps = ComponentProps<typeof AlertDialog.Popup>;
+export type AlertDialogRootProps = Readonly<{
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean, eventDetails: {
+    isCanceled: boolean;
+  }) => void;
+  children?: ReactNode;
+}>;
+export type AlertDialogTriggerProps = ComponentPropsWithRef<'button'>;
+export type AlertDialogPortalProps = Readonly<{
+  children?: ReactNode;
+}>;
+export type AlertDialogBackdropProps = ComponentPropsWithRef<'div'>;
+export type AlertDialogViewportProps = ComponentPropsWithRef<'div'>;
+export type AlertDialogPopupProps = ComponentPropsWithRef<'div'> & {
+  initialFocus?: BasePopupProps['initialFocus'];
+  finalFocus?: BasePopupProps['finalFocus'];
+};
+export type AlertDialogTitleProps = ComponentPropsWithRef<'h2'>;
+export type AlertDialogDescriptionProps = ComponentPropsWithRef<'p'>;
+export type AlertDialogCloseProps = ComponentPropsWithRef<'button'>;
+export declare const AlertDialogRootDefinition: ComponentDefinition<Readonly<{
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean, eventDetails: {
+    isCanceled: boolean;
+  }) => void;
+  children?: ReactNode;
+}>>;
+export declare const AlertDialogTriggerDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>>;
+export declare const AlertDialogPortalDefinition: ComponentDefinition<Readonly<{
+  children?: ReactNode;
+}>>;
+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>>;
+export declare const AlertDialogPopupDefinition: ComponentDefinition<AlertDialogPopupProps>;
+export declare const AlertDialogTitleDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
+export declare const AlertDialogDescriptionDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>>;
+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 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;
+export declare function AlertDialogTitle({ className, children, ...props }: AlertDialogTitleProps): import("react/jsx-runtime").JSX.Element;
+export declare function AlertDialogDescription({ className, children, ...props }: AlertDialogDescriptionProps): import("react/jsx-runtime").JSX.Element;
+export declare function AlertDialogClose({ className, children, ...props }: AlertDialogCloseProps): import("react/jsx-runtime").JSX.Element;
+declare const AlertDialog$1: {
+  Root: typeof AlertDialogRoot;
+  Trigger: typeof AlertDialogTrigger;
+  Portal: typeof AlertDialogPortal;
+  Backdrop: typeof AlertDialogBackdrop;
+  Viewport: typeof AlertDialogViewport;
+  Popup: typeof AlertDialogPopup;
+  Title: typeof AlertDialogTitle;
+  Description: typeof AlertDialogDescription;
+  Close: typeof AlertDialogClose;
+};
+//#endregion
+export { AlertDialog$1 as AlertDialog };
+//# sourceMappingURL=alert-dialog.d.ts.map

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

@@ -0,0 +1,187 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { jsx } from "react/jsx-runtime";
+import { AlertDialog } from "@base-ui/react/alert-dialog";
+//#region src/particles/alert-dialog/alert-dialog.tsx
+const AlertDialogRootDefinition = defineComponent({
+	name: "AlertDialogRoot",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogRoot,
+	editor: {
+		label: "Alert Dialog Root",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AlertDialogTriggerDefinition = defineComponent({
+	name: "AlertDialogTrigger",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogTrigger,
+	editor: {
+		label: "Alert Dialog Trigger",
+		category: "action"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AlertDialogPortalDefinition = defineComponent({
+	name: "AlertDialogPortal",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogPortal,
+	editor: {
+		label: "Alert Dialog Portal",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "Renders its children outside the DOM tree (into document.body). Place AlertDialogBackdrop and AlertDialogViewport as direct children, in that order."
+});
+const AlertDialogBackdropDefinition = defineComponent({
+	name: "AlertDialogBackdrop",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogBackdrop,
+	editor: {
+		label: "Alert Dialog Backdrop",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "Semi-transparent overlay behind the popup. Direct child of AlertDialogPortal, before AlertDialogViewport. Clicking it does not close the alert dialog."
+});
+const AlertDialogViewportDefinition = defineComponent({
+	name: "AlertDialogViewport",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogViewport,
+	editor: {
+		label: "Alert Dialog Viewport",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AlertDialogPopupDefinition = defineComponent({
+	name: "AlertDialogPopup",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogPopup,
+	editor: {
+		label: "Alert Dialog Popup",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "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."
+});
+const AlertDialogTitleDefinition = defineComponent({
+	name: "AlertDialogTitle",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogTitle,
+	editor: {
+		label: "Alert Dialog Title",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "Required heading inside AlertDialogPopup — sets the accessible name of the alert dialog for screen readers. State the question, e.g. \"Delete this address?\"."
+});
+const AlertDialogDescriptionDefinition = defineComponent({
+	name: "AlertDialogDescription",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogDescription,
+	editor: {
+		label: "Alert Dialog Description",
+		category: "layout"
+	},
+	schema: {},
+	guideline: "Description inside AlertDialogPopup, after AlertDialogTitle. Screen readers announce it with the prompt, so use it to state the consequence of confirming."
+});
+const AlertDialogCloseDefinition = defineComponent({
+	name: "AlertDialogClose",
+	importPath: "@vtex/faststore/components",
+	component: AlertDialogClose,
+	editor: {
+		label: "Alert Dialog Close",
+		category: "action"
+	},
+	schema: {},
+	guideline: "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."
+});
+function AlertDialogRoot({ open, defaultOpen, onOpenChange, children }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Root, {
+		open,
+		defaultOpen,
+		onOpenChange,
+		children
+	});
+}
+function AlertDialogTrigger({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Trigger, {
+		...props,
+		className,
+		"data-fs-alert-dialog-trigger": "",
+		children
+	});
+}
+function AlertDialogPortal({ children }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Portal, { children });
+}
+function AlertDialogBackdrop({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Backdrop, {
+		...props,
+		className,
+		"data-fs-alert-dialog-backdrop": "",
+		children
+	});
+}
+function AlertDialogViewport({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-alert-dialog-viewport": "",
+		children
+	});
+}
+function AlertDialogPopup({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Popup, {
+		...props,
+		className,
+		"data-fs-alert-dialog-popup": "",
+		children
+	});
+}
+function AlertDialogTitle({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Title, {
+		...props,
+		className,
+		"data-fs-alert-dialog-title": "",
+		children
+	});
+}
+function AlertDialogDescription({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Description, {
+		...props,
+		className,
+		"data-fs-alert-dialog-description": "",
+		children
+	});
+}
+function AlertDialogClose({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(AlertDialog.Close, {
+		...props,
+		className,
+		"data-fs-alert-dialog-close": "",
+		children
+	});
+}
+const AlertDialog$1 = {
+	Root: AlertDialogRoot,
+	Trigger: AlertDialogTrigger,
+	Portal: AlertDialogPortal,
+	Backdrop: AlertDialogBackdrop,
+	Viewport: AlertDialogViewport,
+	Popup: AlertDialogPopup,
+	Title: AlertDialogTitle,
+	Description: AlertDialogDescription,
+	Close: AlertDialogClose
+};
+//#endregion
+export { AlertDialog$1 as AlertDialog, AlertDialogBackdrop, AlertDialogBackdropDefinition, AlertDialogClose, AlertDialogCloseDefinition, AlertDialogDescription, AlertDialogDescriptionDefinition, AlertDialogPopup, AlertDialogPopupDefinition, AlertDialogPortal, AlertDialogPortalDefinition, AlertDialogRoot, AlertDialogRootDefinition, AlertDialogTitle, AlertDialogTitleDefinition, AlertDialogTrigger, AlertDialogTriggerDefinition, AlertDialogViewport, AlertDialogViewportDefinition };
+
+//# sourceMappingURL=alert-dialog.js.map

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

@@ -0,0 +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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"}

package/dist/particles/checkbox/checkbox.d.ts

@@ -1,8 +1,10 @@
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
-import { ComponentPropsWithRef, ReactNode } from "react";
+import { ComponentPropsWithRef, ReactNode, Ref } from "react";
 //#region src/particles/checkbox/checkbox.d.ts
-export type CheckboxRootProps = {
+export type CheckboxRootProps = Omit<ComponentPropsWithRef<'span'>, 'defaultValue' | 'defaultChecked' | 'onChange' | 'ref' | 'dangerouslySetInnerHTML'> & {
+  /** The rendered host element is a span; Base UI types its forwarded ref as HTMLElement because `render` can replace it. */
+  ref?: Ref<HTMLElement>;
   checked?: boolean;
   defaultChecked?: boolean;
   onCheckedChange?: (checked: boolean) => void;
@@ -15,6 +17,8 @@ export type CheckboxRootProps = {
   id?: string;
   className?: string;
   children?: ReactNode;
+  /** Id of the element this checkbox shows, hides or changes; forwarded to the `role="checkbox"` element. */
+  'aria-controls'?: string;
 };
 export type CheckboxIndicatorProps = ComponentPropsWithRef<'span'> & {
   keepMounted?: boolean;
@@ -29,7 +33,7 @@ export type CheckboxGroupProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValu
 export declare const CheckboxRootDefinition: ComponentDefinition<CheckboxRootProps>;
 export declare const CheckboxIndicatorDefinition: ComponentDefinition<CheckboxIndicatorProps>;
 export declare const CheckboxGroupDefinition: ComponentDefinition<CheckboxGroupProps>;
-export declare function CheckboxRoot({ checked, defaultChecked, onCheckedChange, indeterminate, disabled, readOnly, required, name, value, id, className, children }: CheckboxRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function CheckboxRoot({ checked, defaultChecked, onCheckedChange, indeterminate, disabled, readOnly, required, name, value, id, className, children, 'aria-controls': ariaControls, ref, ...props }: CheckboxRootProps): import("react/jsx-runtime").JSX.Element;
 export declare function CheckboxIndicator({ keepMounted, className, children, ...props }: CheckboxIndicatorProps): import("react/jsx-runtime").JSX.Element;
 export declare function CheckboxGroup({ className, children, ...props }: CheckboxGroupProps): import("react/jsx-runtime").JSX.Element;
 export declare const Checkbox: {

package/dist/particles/checkbox/checkbox.js

@@ -38,8 +38,10 @@ const CheckboxGroupDefinition = defineComponent({
 	schema: {},
 	guideline: "Shared state container for a series of checkboxes. Use allValues to enable select-all behavior. Contains Checkbox.Root children with individual value props."
 });
-function CheckboxRoot({ checked, defaultChecked, onCheckedChange, indeterminate, disabled, readOnly, required, name, value, id, className, children }) {
+function CheckboxRoot({ checked, defaultChecked, onCheckedChange, indeterminate, disabled, readOnly, required, name, value, id, className, children, "aria-controls": ariaControls, ref, ...props }) {
 	return /* @__PURE__ */ jsx(Checkbox.Root, {
+		...props,
+		ref,
 		checked,
 		defaultChecked,
 		onCheckedChange,
@@ -51,6 +53,7 @@ function CheckboxRoot({ checked, defaultChecked, onCheckedChange, indeterminate,
 		value,
 		id,
 		className,
+		"aria-controls": ariaControls,
 		"data-fs-checkbox-root": "",
 		children
 	});

package/dist/particles/checkbox/checkbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkbox.js","names":["CheckboxGroup","BaseCheckbox","BaseCheckboxGroup","Checkbox"],"sources":["../../../src/particles/checkbox/checkbox.tsx"],"sourcesContent":["'use client';\nimport { Checkbox as BaseCheckbox } from '@base-ui/react/checkbox';\nimport { CheckboxGroup as BaseCheckboxGroup } from '@base-ui/react/checkbox-group';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\n\nexport type CheckboxRootProps = {\n  checked?: boolean;\n  defaultChecked?: boolean;\n  onCheckedChange?: (checked: boolean) => void;\n  indeterminate?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  required?: boolean;\n  name?: string;\n  value?: string;\n  id?: string;\n  className?: string;\n  children?: ReactNode;\n};\n\nexport type CheckboxIndicatorProps = ComponentPropsWithRef<'span'> & {\n  keepMounted?: boolean;\n};\n\nexport type CheckboxGroupProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue'> & {\n  value?: string[];\n  defaultValue?: string[];\n  onValueChange?: (value: string[]) => void;\n  allValues?: string[];\n  disabled?: boolean;\n};\n\nexport const CheckboxRootDefinition = defineComponent<CheckboxRootProps>({\n  name: 'CheckboxRoot',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxRoot,\n  editor: { label: 'Checkbox Root', category: 'action' },\n  schema: {},\n  guideline:\n    'Form checkbox that integrates with Field for labeling and validation. Requires a Checkbox.Indicator child for visual state. Use indeterminate for partial selection in nested lists.',\n});\n\nexport const CheckboxIndicatorDefinition = defineComponent<CheckboxIndicatorProps>({\n  name: 'CheckboxIndicator',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxIndicator,\n  editor: { label: 'Checkbox Indicator', category: 'layout' },\n  schema: {},\n  guideline:\n    'Visual indicator inside Checkbox.Root showing checked/indeterminate state. Render a checkmark SVG as a child. Visible only when checked or indeterminate via data-checked/data-indeterminate.',\n});\n\nexport const CheckboxGroupDefinition = defineComponent<CheckboxGroupProps>({\n  name: 'CheckboxGroup',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxGroup,\n  editor: { label: 'Checkbox Group', category: 'layout' },\n  schema: {},\n  guideline:\n    'Shared state container for a series of checkboxes. Use allValues to enable select-all behavior. Contains Checkbox.Root children with individual value props.',\n});\n\nexport function CheckboxRoot({\n  checked,\n  defaultChecked,\n  onCheckedChange,\n  indeterminate,\n  disabled,\n  readOnly,\n  required,\n  name,\n  value,\n  id,\n  className,\n  children,\n}: CheckboxRootProps) {\n  return (\n    <BaseCheckbox.Root\n      checked={checked}\n      defaultChecked={defaultChecked}\n      onCheckedChange={onCheckedChange}\n      indeterminate={indeterminate}\n      disabled={disabled}\n      readOnly={readOnly}\n      required={required}\n      name={name}\n      value={value}\n      id={id}\n      className={className}\n      data-fs-checkbox-root=\"\"\n    >\n      {children}\n    </BaseCheckbox.Root>\n  );\n}\n\nexport function CheckboxIndicator({ keepMounted = false, className, children, ...props }: CheckboxIndicatorProps) {\n  return (\n    <BaseCheckbox.Indicator {...props} keepMounted={keepMounted} className={className} data-fs-checkbox-indicator=\"\">\n      {children}\n    </BaseCheckbox.Indicator>\n  );\n}\n\nexport function CheckboxGroup({ className, children, ...props }: CheckboxGroupProps) {\n  return (\n    <BaseCheckboxGroup {...props} className={className} data-fs-checkbox-group=\"\">\n      {children}\n    </BaseCheckboxGroup>\n  );\n}\n\nexport const Checkbox = {\n  Root: CheckboxRoot,\n  Indicator: CheckboxIndicator,\n};\n"],"mappings":";;;;;;;AAiCA,MAAa,yBAAyB,gBAAmC;CACvE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAiB,UAAU;CAAS;CACrD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,8BAA8B,gBAAwC;CACjF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAsB,UAAU;CAAS;CAC1D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,0BAA0B,gBAAoC;CACzE,MAAM;CACN,YAAY;CACZ,WAAWA;CACX,QAAQ;EAAE,OAAO;EAAkB,UAAU;CAAS;CACtD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,SAAgB,aAAa,EAC3B,SACA,gBACA,iBACA,eACA,UACA,UACA,UACA,MACA,OACA,IACA,WACA,YACoB;CACpB,OACE,oBAACC,SAAa,MAAd;EACW;EACO;EACC;EACF;EACL;EACA;EACA;EACJ;EACC;EACH;EACO;EACX,yBAAsB;EAErB;CACgB,CAAA;AAEvB;AAEA,SAAgB,kBAAkB,EAAE,cAAc,OAAO,WAAW,UAAU,GAAG,SAAiC;CAChH,OACE,oBAACA,SAAa,WAAd;EAAwB,GAAI;EAAoB;EAAwB;EAAW,8BAA2B;EAC3G;CACqB,CAAA;AAE5B;AAEA,SAAgBD,gBAAc,EAAE,WAAW,UAAU,GAAG,SAA6B;CACnF,OACE,oBAACE,eAAD;EAAmB,GAAI;EAAkB;EAAW,0BAAuB;EACxE;CACgB,CAAA;AAEvB;AAEA,MAAaC,aAAW;CACtB,MAAM;CACN,WAAW;AACb"}
+{"version":3,"file":"checkbox.js","names":["CheckboxGroup","BaseCheckbox","BaseCheckboxGroup","Checkbox"],"sources":["../../../src/particles/checkbox/checkbox.tsx"],"sourcesContent":["'use client';\nimport { Checkbox as BaseCheckbox } from '@base-ui/react/checkbox';\nimport { CheckboxGroup as BaseCheckboxGroup } from '@base-ui/react/checkbox-group';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef, ReactNode, Ref } from 'react';\n\n// The twelve members below, over the span props Base UI's own `CheckboxRoot` already accepts, so\n// `ref`, `onBlur` and any `data-*` attribute reach the rendered host element through a rest spread.\n// `dangerouslySetInnerHTML` is excluded — the rest spread otherwise forwards it straight onto the\n// rendered `<span>`, and a schema-authored `page.json` can supply it with no allowlist in between.\nexport type CheckboxRootProps = Omit<\n  ComponentPropsWithRef<'span'>,\n  'defaultValue' | 'defaultChecked' | 'onChange' | 'ref' | 'dangerouslySetInnerHTML'\n> & {\n  /** The rendered host element is a span; Base UI types its forwarded ref as HTMLElement because `render` can replace it. */\n  ref?: Ref<HTMLElement>;\n  checked?: boolean;\n  defaultChecked?: boolean;\n  onCheckedChange?: (checked: boolean) => void;\n  indeterminate?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  required?: boolean;\n  name?: string;\n  value?: string;\n  id?: string;\n  className?: string;\n  children?: ReactNode;\n  /** Id of the element this checkbox shows, hides or changes; forwarded to the `role=\"checkbox\"` element. */\n  'aria-controls'?: string;\n};\n\nexport type CheckboxIndicatorProps = ComponentPropsWithRef<'span'> & {\n  keepMounted?: boolean;\n};\n\nexport type CheckboxGroupProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue'> & {\n  value?: string[];\n  defaultValue?: string[];\n  onValueChange?: (value: string[]) => void;\n  allValues?: string[];\n  disabled?: boolean;\n};\n\nexport const CheckboxRootDefinition = defineComponent<CheckboxRootProps>({\n  name: 'CheckboxRoot',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxRoot,\n  editor: { label: 'Checkbox Root', category: 'action' },\n  schema: {},\n  guideline:\n    'Form checkbox that integrates with Field for labeling and validation. Requires a Checkbox.Indicator child for visual state. Use indeterminate for partial selection in nested lists.',\n});\n\nexport const CheckboxIndicatorDefinition = defineComponent<CheckboxIndicatorProps>({\n  name: 'CheckboxIndicator',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxIndicator,\n  editor: { label: 'Checkbox Indicator', category: 'layout' },\n  schema: {},\n  guideline:\n    'Visual indicator inside Checkbox.Root showing checked/indeterminate state. Render a checkmark SVG as a child. Visible only when checked or indeterminate via data-checked/data-indeterminate.',\n});\n\nexport const CheckboxGroupDefinition = defineComponent<CheckboxGroupProps>({\n  name: 'CheckboxGroup',\n  importPath: '@vtex/faststore/components',\n  component: CheckboxGroup,\n  editor: { label: 'Checkbox Group', category: 'layout' },\n  schema: {},\n  guideline:\n    'Shared state container for a series of checkboxes. Use allValues to enable select-all behavior. Contains Checkbox.Root children with individual value props.',\n});\n\nexport function CheckboxRoot({\n  checked,\n  defaultChecked,\n  onCheckedChange,\n  indeterminate,\n  disabled,\n  readOnly,\n  required,\n  name,\n  value,\n  id,\n  className,\n  children,\n  'aria-controls': ariaControls,\n  ref,\n  ...props\n}: CheckboxRootProps) {\n  return (\n    <BaseCheckbox.Root\n      {...props}\n      ref={ref}\n      checked={checked}\n      defaultChecked={defaultChecked}\n      onCheckedChange={onCheckedChange}\n      indeterminate={indeterminate}\n      disabled={disabled}\n      readOnly={readOnly}\n      required={required}\n      name={name}\n      value={value}\n      id={id}\n      className={className}\n      aria-controls={ariaControls}\n      data-fs-checkbox-root=\"\"\n    >\n      {children}\n    </BaseCheckbox.Root>\n  );\n}\n\nexport function CheckboxIndicator({ keepMounted = false, className, children, ...props }: CheckboxIndicatorProps) {\n  return (\n    <BaseCheckbox.Indicator {...props} keepMounted={keepMounted} className={className} data-fs-checkbox-indicator=\"\">\n      {children}\n    </BaseCheckbox.Indicator>\n  );\n}\n\nexport function CheckboxGroup({ className, children, ...props }: CheckboxGroupProps) {\n  return (\n    <BaseCheckboxGroup {...props} className={className} data-fs-checkbox-group=\"\">\n      {children}\n    </BaseCheckboxGroup>\n  );\n}\n\nexport const Checkbox = {\n  Root: CheckboxRoot,\n  Indicator: CheckboxIndicator,\n};\n"],"mappings":";;;;;;;AA4CA,MAAa,yBAAyB,gBAAmC;CACvE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAiB,UAAU;CAAS;CACrD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,8BAA8B,gBAAwC;CACjF,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAsB,UAAU;CAAS;CAC1D,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,MAAa,0BAA0B,gBAAoC;CACzE,MAAM;CACN,YAAY;CACZ,WAAWA;CACX,QAAQ;EAAE,OAAO;EAAkB,UAAU;CAAS;CACtD,QAAQ,CAAC;CACT,WACE;AACJ,CAAC;AAED,SAAgB,aAAa,EAC3B,SACA,gBACA,iBACA,eACA,UACA,UACA,UACA,MACA,OACA,IACA,WACA,UACA,iBAAiB,cACjB,KACA,GAAG,SACiB;CACpB,OACE,oBAACC,SAAa,MAAd;EACE,GAAI;EACC;EACI;EACO;EACC;EACF;EACL;EACA;EACA;EACJ;EACC;EACH;EACO;EACX,iBAAe;EACf,yBAAsB;EAErB;CACgB,CAAA;AAEvB;AAEA,SAAgB,kBAAkB,EAAE,cAAc,OAAO,WAAW,UAAU,GAAG,SAAiC;CAChH,OACE,oBAACA,SAAa,WAAd;EAAwB,GAAI;EAAoB;EAAwB;EAAW,8BAA2B;EAC3G;CACqB,CAAA;AAE5B;AAEA,SAAgBD,gBAAc,EAAE,WAAW,UAAU,GAAG,SAA6B;CACnF,OACE,oBAACE,eAAD;EAAmB,GAAI;EAAkB;EAAW,0BAAuB;EACxE;CACgB,CAAA;AAEvB;AAEA,MAAaC,aAAW;CACtB,MAAM;CACN,WAAW;AACb"}