@vtex/faststore 0.0.1

package/dist/matter/session/session.d.ts

@@ -0,0 +1,58 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { SessionEntity } from "../../sdk/session/operations.js";
+import { ReactNode } from "react";
+//#region src/matter/session/session.d.ts
+export type SessionState = 'anonymous' | 'identified' | 'loggedIn';
+/**
+ * Derive the identity tri-state from the two raw session flags. `loggedIn` takes precedence: an
+ * authenticated shopper is always `loggedIn` regardless of `isIdentified`.
+ */
+export declare function deriveSessionState({ loggedIn, isIdentified }: {
+  loggedIn: boolean;
+  isIdentified: boolean;
+}): SessionState;
+export type SessionContextValue = Readonly<{
+  /** Derived tri-state: anonymous | identified | loggedIn. */
+  state: SessionState;
+  /** Raw authenticated-session flag from `session.loggedIn`. */
+  loggedIn: boolean;
+  /** Raw edit-permission flag from `session.canEditData`; lets Controls render editable vs. masked. */
+  canEditData: boolean;
+  /** True while the Session entity has not yet resolved. */
+  loading: boolean;
+}>;
+export declare const SessionContext: React.Context<SessionContextValue>;
+/**
+ * Read the derived session state and raw flags from the nearest `SessionRoot`. Throws when called
+ * outside a `SessionRoot` subtree (a misplaced `useSession()` is a composition bug the author should
+ * see immediately, not a silent degrade to anonymous), mirroring `useCart()` (Decision 6).
+ *
+ * While the Session entity is unresolved the context carries `loading: true` and `state:
+ * 'anonymous'` (the least-privileged default); consumers that must not flash gate on `loading`.
+ */
+export declare function useSession(): SessionContextValue;
+export type SessionRootProps = {
+  /**
+   * Session entity slice forwarded by the reactive runtime (`ReactiveDataProvider`) — the value of
+   * the `session` top-level field on `SessionData on Query`, not the wrapping `{ session: … }` shape.
+   * Receives `null` while the entity has not yet resolved.
+   */
+  $data?: SessionEntity | null;
+  children?: ReactNode;
+};
+export type SessionGuardProps = {
+  /** The session states under which the children render. Renders nothing for any other state. */
+  when?: SessionState[];
+  children?: ReactNode;
+};
+export declare const SessionRootDefinition: ComponentDefinition<SessionRootProps>;
+export declare const SessionGuardDefinition: ComponentDefinition<SessionGuardProps>;
+export declare function SessionRoot({ $data: $dataProp, children }: SessionRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionGuard({ when, children }: SessionGuardProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const Session: {
+  Root: typeof SessionRoot;
+  Guard: typeof SessionGuard;
+};
+//#endregion
+//# sourceMappingURL=session.d.ts.map

package/dist/matter/session/session.js

@@ -0,0 +1,112 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { graphql } from "../../sdk/generated/gql.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { createContext, useContext, useMemo } from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+//#region src/matter/session/session.tsx
+const fragment = graphql(`
+  fragment SessionData on Query {
+    session {
+      ...SessionFragment
+    }
+  }
+`);
+/**
+* Derive the identity tri-state from the two raw session flags. `loggedIn` takes precedence: an
+* authenticated shopper is always `loggedIn` regardless of `isIdentified`.
+*/
+function deriveSessionState({ loggedIn, isIdentified }) {
+	if (loggedIn) return "loggedIn";
+	if (isIdentified) return "identified";
+	return "anonymous";
+}
+const SESSION_DATA_UNSET = Symbol("SessionContextUnset");
+const SessionContextInternal = createContext(SESSION_DATA_UNSET);
+const SessionContext = SessionContextInternal;
+/**
+* Read the derived session state and raw flags from the nearest `SessionRoot`. Throws when called
+* outside a `SessionRoot` subtree (a misplaced `useSession()` is a composition bug the author should
+* see immediately, not a silent degrade to anonymous), mirroring `useCart()` (Decision 6).
+*
+* While the Session entity is unresolved the context carries `loading: true` and `state:
+* 'anonymous'` (the least-privileged default); consumers that must not flash gate on `loading`.
+*/
+function useSession() {
+	const ctx = useContext(SessionContextInternal);
+	if (ctx === SESSION_DATA_UNSET) throw new Error("useSession() must be used inside a <SessionRoot> subtree.");
+	return ctx;
+}
+const SessionRootDefinition = defineComponent({
+	name: "SessionRoot",
+	importPath: "@vtex/faststore/components",
+	component: SessionRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	editor: {
+		label: "Session Root",
+		category: "identity"
+	},
+	schema: {},
+	providesContext: "session",
+	guideline: "Read-only identity-state provider, normally the root of the shared layout so the header and every page it serves resolve the same session: reads the Session and broadcasts the anonymous/identified/logged-in tri-state plus the raw loggedIn and canEditData flags. Layout scope fetches client-side with the shopper cookie; page scope fetches server-side without it. Exactly one per rendered tree — a page must not add its own when the layout already hosts one. See session.md."
+});
+const SessionGuardDefinition = defineComponent({
+	name: "SessionGuard",
+	importPath: "@vtex/faststore/components",
+	component: SessionGuard,
+	editor: {
+		label: "Session Guard",
+		category: "identity"
+	},
+	schema: { when: {
+		type: "array",
+		items: [
+			"anonymous",
+			"identified",
+			"loggedIn"
+		],
+		label: "When State"
+	} },
+	requiresContext: "session",
+	guideline: "Declarative gate: renders its children only when the current session state is one of the values in `when` (e.g. {\"when\":[\"identified\",\"loggedIn\"]}), else renders nothing. Use it in page or layout JSON to show or hide an identity subtree by state without writing the gate into a component. Must be inside SessionRoot, which may be hosted by the page or by its layout."
+});
+function SessionRoot({ $data: $dataProp, children }) {
+	const session = useDataOverride($dataProp) ?? null;
+	const loading = session == null;
+	const value = useMemo(() => {
+		const loggedIn = session?.loggedIn ?? false;
+		return {
+			state: deriveSessionState({
+				loggedIn,
+				isIdentified: session?.isIdentified ?? false
+			}),
+			loggedIn,
+			canEditData: session?.canEditData ?? false,
+			loading
+		};
+	}, [
+		session?.loggedIn,
+		session?.isIdentified,
+		session?.canEditData,
+		loading
+	]);
+	return /* @__PURE__ */ jsx(SessionContextInternal, {
+		value,
+		children
+	});
+}
+function SessionGuard({ when, children }) {
+	const { state } = useSession();
+	if (!when?.includes(state)) return null;
+	return /* @__PURE__ */ jsx(Fragment, { children });
+}
+const Session = {
+	Root: SessionRoot,
+	Guard: SessionGuard
+};
+//#endregion
+export { Session, SessionContext, SessionGuard, SessionGuardDefinition, SessionRoot, SessionRootDefinition, deriveSessionState, useSession };
+
+//# sourceMappingURL=session.js.map

package/dist/matter/session/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","names":[],"sources":["../../../src/matter/session/session.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { createContext, type ReactNode, useContext, useMemo } from 'react';\nimport { useDataOverride } from '../../sdk/data/data-override-context.js';\nimport { graphql } from '../../sdk/generated/gql.js';\nimport type { SessionEntity } from '../../sdk/session/operations.js';\n\n// ---------------------------------------------------------------------------\n// GraphQL Fragment — typed via @graphql-codegen client-preset\n// ---------------------------------------------------------------------------\n\nconst fragment = graphql(`\n  fragment SessionData on Query {\n    session {\n      ...SessionFragment\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Tri-state derivation — the single home of the truth table (Decision 2).\n// ---------------------------------------------------------------------------\n\nexport type SessionState = 'anonymous' | 'identified' | 'loggedIn';\n\n/**\n * Derive the identity tri-state from the two raw session flags. `loggedIn` takes precedence: an\n * authenticated shopper is always `loggedIn` regardless of `isIdentified`.\n */\nexport function deriveSessionState({\n  loggedIn,\n  isIdentified,\n}: {\n  loggedIn: boolean;\n  isIdentified: boolean;\n}): SessionState {\n  if (loggedIn) return 'loggedIn';\n  if (isIdentified) return 'identified';\n  return 'anonymous';\n}\n\n// ---------------------------------------------------------------------------\n// Session context (read-only derived state + raw flags)\n// ---------------------------------------------------------------------------\n\nexport type SessionContextValue = Readonly<{\n  /** Derived tri-state: anonymous | identified | loggedIn. */\n  state: SessionState;\n  /** Raw authenticated-session flag from `session.loggedIn`. */\n  loggedIn: boolean;\n  /** Raw edit-permission flag from `session.canEditData`; lets Controls render editable vs. masked. */\n  canEditData: boolean;\n  /** True while the Session entity has not yet resolved. */\n  loading: boolean;\n}>;\n\nconst SESSION_DATA_UNSET = Symbol('SessionContextUnset');\n\nconst SessionContextInternal = createContext<SessionContextValue | typeof SESSION_DATA_UNSET>(SESSION_DATA_UNSET);\n\nexport const SessionContext = SessionContextInternal as React.Context<SessionContextValue>;\n\n/**\n * Read the derived session state and raw flags from the nearest `SessionRoot`. Throws when called\n * outside a `SessionRoot` subtree (a misplaced `useSession()` is a composition bug the author should\n * see immediately, not a silent degrade to anonymous), mirroring `useCart()` (Decision 6).\n *\n * While the Session entity is unresolved the context carries `loading: true` and `state:\n * 'anonymous'` (the least-privileged default); consumers that must not flash gate on `loading`.\n */\nexport function useSession(): SessionContextValue {\n  const ctx = useContext(SessionContextInternal);\n  if (ctx === SESSION_DATA_UNSET) {\n    throw new Error('useSession() must be used inside a <SessionRoot> subtree.');\n  }\n  return ctx;\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type SessionRootProps = {\n  /**\n   * Session entity slice forwarded by the reactive runtime (`ReactiveDataProvider`) — the value of\n   * the `session` top-level field on `SessionData on Query`, not the wrapping `{ session: … }` shape.\n   * Receives `null` while the entity has not yet resolved.\n   */\n  $data?: SessionEntity | null;\n  children?: ReactNode;\n};\n\nexport type SessionGuardProps = {\n  /** The session states under which the children render. Renders nothing for any other state. */\n  when?: SessionState[];\n  children?: ReactNode;\n};\n\n// ---------------------------------------------------------------------------\n// Definitions\n// ---------------------------------------------------------------------------\n\nexport const SessionRootDefinition = defineComponent<SessionRootProps>({\n  name: 'SessionRoot',\n  importPath: '@vtex/faststore/components',\n  component: SessionRoot,\n  fragment,\n  fetchStrategy: 'reactive',\n  editor: { label: 'Session Root', category: 'identity' },\n  schema: {},\n  providesContext: 'session',\n  guideline:\n    'Read-only identity-state provider, normally the root of the shared layout so the header and every page it serves resolve the same session: reads the Session and broadcasts the anonymous/identified/logged-in tri-state plus the raw loggedIn and canEditData flags. Layout scope fetches client-side with the shopper cookie; page scope fetches server-side without it. Exactly one per rendered tree — a page must not add its own when the layout already hosts one. See session.md.',\n});\n\nexport const SessionGuardDefinition = defineComponent<SessionGuardProps>({\n  name: 'SessionGuard',\n  importPath: '@vtex/faststore/components',\n  component: SessionGuard,\n  editor: { label: 'Session Guard', category: 'identity' },\n  schema: {\n    when: { type: 'array', items: ['anonymous', 'identified', 'loggedIn'] as const, label: 'When State' },\n  },\n  requiresContext: 'session',\n  guideline:\n    'Declarative gate: renders its children only when the current session state is one of the values in `when` (e.g. {\"when\":[\"identified\",\"loggedIn\"]}), else renders nothing. Use it in page or layout JSON to show or hide an identity subtree by state without writing the gate into a component. Must be inside SessionRoot, which may be hosted by the page or by its layout.',\n});\n\n// ---------------------------------------------------------------------------\n// Implementations\n// ---------------------------------------------------------------------------\n\nexport function SessionRoot({ $data: $dataProp, children }: SessionRootProps) {\n  const $data = useDataOverride($dataProp);\n  const session = $data ?? null;\n  const loading = session == null;\n\n  const value: SessionContextValue = useMemo(() => {\n    const loggedIn = session?.loggedIn ?? false;\n    const isIdentified = session?.isIdentified ?? false;\n    return {\n      state: deriveSessionState({ loggedIn, isIdentified }),\n      loggedIn,\n      canEditData: session?.canEditData ?? false,\n      loading,\n    };\n  }, [session?.loggedIn, session?.isIdentified, session?.canEditData, loading]);\n\n  return <SessionContextInternal value={value}>{children}</SessionContextInternal>;\n}\n\nexport function SessionGuard({ when, children }: SessionGuardProps) {\n  const { state } = useSession();\n  if (!when?.includes(state)) return null;\n  return <>{children}</>;\n}\n\n// ---------------------------------------------------------------------------\n// Namespace export\n// ---------------------------------------------------------------------------\n\nexport const Session = {\n  Root: SessionRoot,\n  Guard: SessionGuard,\n};\n"],"mappings":";;;;;;;;AAYA,MAAM,WAAW,QAAQ;;;;;;CAMxB;;;;;AAYD,SAAgB,mBAAmB,EACjC,UACA,gBAIe;CACf,IAAI,UAAU,OAAO;CACrB,IAAI,cAAc,OAAO;CACzB,OAAO;AACT;AAiBA,MAAM,qBAAqB,OAAO,qBAAqB;AAEvD,MAAM,yBAAyB,cAA+D,kBAAkB;AAEhH,MAAa,iBAAiB;;;;;;;;;AAU9B,SAAgB,aAAkC;CAChD,MAAM,MAAM,WAAW,sBAAsB;CAC7C,IAAI,QAAQ,oBACV,MAAM,IAAI,MAAM,2DAA2D;CAE7E,OAAO;AACT;AA0BA,MAAa,wBAAwB,gBAAkC;CACrE,MAAM;CACN,YAAY;CACZ,WAAW;CACX;CACA,eAAe;CACf,QAAQ;EAAE,OAAO;EAAgB,UAAU;CAAW;CACtD,QAAQ,CAAC;CACT,iBAAiB;CACjB,WACE;AACJ,CAAC;AAED,MAAa,yBAAyB,gBAAmC;CACvE,MAAM;CACN,YAAY;CACZ,WAAW;CACX,QAAQ;EAAE,OAAO;EAAiB,UAAU;CAAW;CACvD,QAAQ,EACN,MAAM;EAAE,MAAM;EAAS,OAAO;GAAC;GAAa;GAAc;EAAU;EAAY,OAAO;CAAa,EACtG;CACA,iBAAiB;CACjB,WACE;AACJ,CAAC;AAMD,SAAgB,YAAY,EAAE,OAAO,WAAW,YAA8B;CAE5E,MAAM,UADQ,gBAAgB,SACV,KAAK;CACzB,MAAM,UAAU,WAAW;CAE3B,MAAM,QAA6B,cAAc;EAC/C,MAAM,WAAW,SAAS,YAAY;EAEtC,OAAO;GACL,OAAO,mBAAmB;IAAE;IAAU,cAFnB,SAAS,gBAAgB;GAEO,CAAC;GACpD;GACA,aAAa,SAAS,eAAe;GACrC;EACF;CACF,GAAG;EAAC,SAAS;EAAU,SAAS;EAAc,SAAS;EAAa;CAAO,CAAC;CAE5E,OAAO,oBAAC,wBAAD;EAA+B;EAAQ;CAAiC,CAAA;AACjF;AAEA,SAAgB,aAAa,EAAE,MAAM,YAA+B;CAClE,MAAM,EAAE,UAAU,WAAW;CAC7B,IAAI,CAAC,MAAM,SAAS,KAAK,GAAG,OAAO;CACnC,OAAO,oBAAA,UAAA,EAAG,SAAW,CAAA;AACvB;AAMA,MAAa,UAAU;CACrB,MAAM;CACN,OAAO;AACT"}

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

@@ -0,0 +1,101 @@
+/**
+* All available country descriptors, keyed by ISO alpha-3 code.
+*
+* The country selector lists only countries with a descriptor; a descriptor-less country is unreachable.
+* Adding a country is a data-only change: add a new CountryDescriptor entry here.
+*/
+const countryDescriptors = {
+	BRA: {
+		iso: "BRA",
+		label: "Brasil",
+		fields: [
+			{
+				name: "recipientName",
+				label: "nome do destinatário"
+			},
+			{
+				name: "street",
+				label: "rua"
+			},
+			{
+				name: "number",
+				label: "número"
+			},
+			{
+				name: "complement",
+				label: "complemento (opcional)"
+			},
+			{
+				name: "neighborhood",
+				label: "bairro"
+			},
+			{
+				name: "city",
+				label: "cidade"
+			},
+			{
+				name: "state",
+				label: "estado"
+			},
+			{
+				name: "postalCode",
+				label: "cep"
+			}
+		]
+	},
+	USA: {
+		iso: "USA",
+		label: "Estados Unidos",
+		fields: [
+			{
+				name: "recipientName",
+				label: "nome do destinatário"
+			},
+			{
+				name: "street",
+				label: "rua"
+			},
+			{
+				name: "number",
+				label: "número"
+			},
+			{
+				name: "complement",
+				label: "complemento (opcional)"
+			},
+			{
+				name: "city",
+				label: "cidade"
+			},
+			{
+				name: "state",
+				label: "estado"
+			},
+			{
+				name: "postalCode",
+				label: "código postal"
+			}
+		]
+	}
+};
+/**
+* Returns an ordered list of available country ISO codes (those with a descriptor).
+*
+* @returns ISO alpha-3 codes of all implemented countries, in definition order.
+*/
+function getAvailableCountries() {
+	return Object.keys(countryDescriptors);
+}
+/**
+* Retrieves the descriptor for a given country.
+*
+* @param iso - ISO 3166-1 alpha-3 country code (e.g., "BRA", "USA")
+* @returns The CountryDescriptor for the country, or undefined if not implemented.
+*/
+function getCountryDescriptor(iso) {
+	return countryDescriptors[iso];
+}
+//#endregion
+export { countryDescriptors, getAvailableCountries, getCountryDescriptor };
+
+//# sourceMappingURL=country-descriptors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"country-descriptors.js","names":[],"sources":["../../../src/matter/shipping-address/country-descriptors.ts"],"sourcesContent":["/**\n * Country-adaptive shipping address form descriptors.\n *\n * Each descriptor declares the form shape (field set, order, and labels) for a specific country.\n * Descriptors are data only: no validation metadata, no required flags, no format patterns.\n * Country adaptation is data-driven; adding a country is a data-only change (a new descriptor entry).\n *\n * Canonical field names must be shared/consistent across descriptors for fields both countries have\n * (recipientName, postalCode, street, number, complement, city, state), so that switching countries\n * preserves shared field values in the batched draft state (Decision 1/Invariant).\n *\n * Per Decision 2, this narrows the RFC's descriptor scope to form shape only: the only client-enforced\n * content rule is the non-blank recipient name. Postal-code format, per-country required enforcement,\n * and per-field blur validation are deferred to VTEX (v1 surfaces rejections as UPSTREAM_ERROR) and\n * a future @vtex/country-forms adoption.\n */\n\n/**\n * Describes a single form field within a country descriptor.\n *\n * @property name - Canonical field name (e.g., \"recipientName\", \"street\", \"neighborhood\").\n *                  Shared field names across descriptors enable draft state preservation on country switch.\n * @property label - Human-readable label for the field. Named `label` (not a key) to allow future\n *                   swapping with i18n keys once the codebase adopts an i18n layer.\n */\nexport type FieldDescriptor = Readonly<{\n  name: string;\n  label: string;\n}>;\n\n/**\n * Describes the form shape for a single country.\n *\n * @property iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\"). Must be a valid 3-letter code\n *                 matching the Address.country field type (plain String!, ISO alpha-3 by convention).\n * @property label - Human-readable country name for the country selector (e.g., \"Brazil\", \"United States\").\n *                   Named `label` (not a key) to allow future swapping with i18n keys.\n * @property fields - Ordered field set for this country. Order defines the visual order in the form.\n *                    Only fields this country uses are listed; absent fields are not rendered.\n */\nexport type CountryDescriptor = Readonly<{\n  iso: string;\n  label: string;\n  fields: readonly FieldDescriptor[];\n}>;\n\n/**\n * Brazil (BRA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. neighborhood — bairro (BR-specific, not in US form)\n * 6. city — city name\n * 7. state — state/UF code (canonical name shared with US, though US calls it state abbreviation)\n * 8. postalCode — CEP format (validation deferred to VTEX in v1)\n */\nconst brDescriptor: CountryDescriptor = {\n  iso: 'BRA',\n  label: 'Brasil',\n  fields: [\n    { name: 'recipientName', label: 'nome do destinatário' },\n    { name: 'street', label: 'rua' },\n    { name: 'number', label: 'número' },\n    { name: 'complement', label: 'complemento (opcional)' },\n    { name: 'neighborhood', label: 'bairro' },\n    { name: 'city', label: 'cidade' },\n    { name: 'state', label: 'estado' },\n    { name: 'postalCode', label: 'cep' },\n  ],\n};\n\n/**\n * United States (USA) address form descriptor.\n *\n * Field order:\n * 1. recipientName — recipient of the package\n * 2. street — street name\n * 3. number — street number\n * 4. complement — apartment, suite, etc. (optional per GraphQL but no form-level validation)\n * 5. city — city name\n * 6. state — state abbreviation (canonical name shared with BR for draft preservation)\n * 7. postalCode — ZIP/ZIP+4 format (validation deferred to VTEX in v1)\n *\n * Note: neighborhood is not included in the US v1 form. If the shopper switches from BR to US,\n * the neighborhood value is retained in the draft but hidden (descriptor controls visibility only);\n * switching back to BR resurfaces it.\n */\nconst usaDescriptor: CountryDescriptor = {\n  iso: 'USA',\n  label: 'Estados Unidos',\n  fields: [\n    { name: 'recipientName', label: 'nome do destinatário' },\n    { name: 'street', label: 'rua' },\n    { name: 'number', label: 'número' },\n    { name: 'complement', label: 'complemento (opcional)' },\n    { name: 'city', label: 'cidade' },\n    { name: 'state', label: 'estado' },\n    { name: 'postalCode', label: 'código postal' },\n  ],\n};\n\n/**\n * All available country descriptors, keyed by ISO alpha-3 code.\n *\n * The country selector lists only countries with a descriptor; a descriptor-less country is unreachable.\n * Adding a country is a data-only change: add a new CountryDescriptor entry here.\n */\nexport const countryDescriptors: Readonly<Record<string, CountryDescriptor>> = {\n  BRA: brDescriptor,\n  USA: usaDescriptor,\n};\n\n/**\n * Returns an ordered list of available country ISO codes (those with a descriptor).\n *\n * @returns ISO alpha-3 codes of all implemented countries, in definition order.\n */\nexport function getAvailableCountries(): readonly string[] {\n  return Object.keys(countryDescriptors);\n}\n\n/**\n * Retrieves the descriptor for a given country.\n *\n * @param iso - ISO 3166-1 alpha-3 country code (e.g., \"BRA\", \"USA\")\n * @returns The CountryDescriptor for the country, or undefined if not implemented.\n */\nexport function getCountryDescriptor(iso: string): CountryDescriptor | undefined {\n  return countryDescriptors[iso];\n}\n"],"mappings":";;;;;;AA8GA,MAAa,qBAAkE;CAC7E,KAAK;EAnDL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;GAAuB;GACvD;IAAE,MAAM;IAAU,OAAO;GAAM;GAC/B;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAyB;GACtD;IAAE,MAAM;IAAgB,OAAO;GAAS;GACxC;IAAE,MAAM;IAAQ,OAAO;GAAS;GAChC;IAAE,MAAM;IAAS,OAAO;GAAS;GACjC;IAAE,MAAM;IAAc,OAAO;GAAM;EACrC;CAwCK;CACL,KAAK;EArBL,KAAK;EACL,OAAO;EACP,QAAQ;GACN;IAAE,MAAM;IAAiB,OAAO;GAAuB;GACvD;IAAE,MAAM;IAAU,OAAO;GAAM;GAC/B;IAAE,MAAM;IAAU,OAAO;GAAS;GAClC;IAAE,MAAM;IAAc,OAAO;GAAyB;GACtD;IAAE,MAAM;IAAQ,OAAO;GAAS;GAChC;IAAE,MAAM;IAAS,OAAO;GAAS;GACjC;IAAE,MAAM;IAAc,OAAO;GAAgB;EAC/C;CAWK;AACP;;;;;;AAOA,SAAgB,wBAA2C;CACzD,OAAO,OAAO,KAAK,kBAAkB;AACvC;;;;;;;AAQA,SAAgB,qBAAqB,KAA4C;CAC/E,OAAO,mBAAmB;AAC5B"}

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

@@ -0,0 +1,284 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentActions } from "../../sdk/actions/types.js";
+import { ReactNode } from "react";
+//#region src/matter/shipping-address/shipping-address.d.ts
+/**
+ * The `$data` slice forwarded by the reactive runtime. `ShippingAddressData` selects two root
+ * fields (`shipping`, `clientProfile`), so the compiler composes them via
+ * `MultipleReactiveDataProvider`, which keys each entity's resolved slice by its own root field —
+ * `$data` is `{ shipping: {...}, clientProfile: {...} }`, not a flat/unwrapped shape (that unwrapped
+ * shape only applies to single-root-field fragments, e.g. CartTotalizerRoot's `$data.totalizers`).
+ */
+export type ShippingAddressData = {
+  shipping?: {
+    address?: {
+      id?: string | null;
+      recipientName?: string | null;
+      postalCode?: string | null;
+      country?: string | null;
+      street?: string | null;
+      number?: string | null;
+      complement?: string | null;
+      neighborhood?: string | null;
+      city?: string | null;
+      state?: string | null;
+    } | null;
+    savedAddresses?: Array<{
+      id?: string | null;
+      recipientName?: string | null;
+      postalCode?: string | null;
+      country?: string | null;
+      street?: string | null;
+      number?: string | null;
+      complement?: string | null;
+      neighborhood?: string | null;
+      city?: string | null;
+      state?: string | null;
+    }>;
+  } | null;
+  clientProfile?: {
+    firstName?: string | null;
+    lastName?: string | null;
+  } | null;
+} | null;
+export type ShippingAddressRootProps = {
+  /** Default country (ISO alpha-3) when no address exists. */
+  defaultCountry?: string;
+  className?: string;
+  children?: ReactNode;
+  /** `ShippingAddressData` forwarded by the reactive runtime. */
+  $data?: ShippingAddressData;
+  /** Compiler-injected action surface; carries `shipping.setAddress`. */
+  $actions?: ComponentActions;
+};
+export type ShippingAddressStreetControlProps = {
+  className?: string;
+};
+export type ShippingAddressNumberControlProps = {
+  className?: string;
+};
+export type ShippingAddressCityControlProps = {
+  className?: string;
+};
+export type ShippingAddressStateControlProps = {
+  className?: string;
+};
+export type ShippingAddressPostalCodeControlProps = {
+  className?: string;
+};
+export type ShippingAddressComplementControlProps = {
+  className?: string;
+};
+export type ShippingAddressNeighborhoodControlProps = {
+  className?: string;
+};
+export type ShippingAddressCountryControlProps = {
+  className?: string;
+  label?: string;
+};
+export type ShippingAddressRecipientNameControlProps = {
+  className?: string;
+};
+export type ShippingAddressSavedListProps = {
+  className?: string;
+};
+export type ShippingAddressSavedOptionProps = {
+  id: string;
+  className?: string;
+};
+export type ShippingAddressSubmitProps = {
+  className?: string;
+  label?: string;
+  pendingLabel?: string;
+};
+export type ShippingAddressErrorProps = {
+  className?: string;
+};
+export type ShippingAddressSavedAddressDrawerControllerProps = {
+  children?: ReactNode;
+};
+export type ShippingAddressSavedAddressSubmitProps = {
+  className?: string;
+  label?: string;
+  pendingLabel?: string;
+};
+export type ShippingAddressSelectedSummaryProps = {
+  className?: string;
+  /**
+   * The lines to render, in order — typically the `AddressSummaryRecipient` / `Street` / `Locality`
+   * leaves. Defaults to recipient, street, locality when omitted.
+   */
+  children?: ReactNode;
+};
+export type ShippingAddressEditControllerProps = {
+  children?: ReactNode;
+};
+export type ShippingAddressSectionPanelProps = {
+  children?: ReactNode;
+};
+export type ShippingAddressEditButtonProps = {
+  className?: string;
+  label?: string;
+  /** Compose custom button content (e.g. an Icon plus text); falls back to `label`. */
+  children?: ReactNode;
+};
+export declare const ShippingAddressRootDefinition: ComponentDefinition<ShippingAddressRootProps>;
+export declare const ShippingAddressRecipientNameControlDefinition: ComponentDefinition<ShippingAddressRecipientNameControlProps>;
+export declare const ShippingAddressStreetControlDefinition: ComponentDefinition<ShippingAddressStreetControlProps>;
+export declare const ShippingAddressNumberControlDefinition: ComponentDefinition<ShippingAddressNumberControlProps>;
+export declare const ShippingAddressCityControlDefinition: ComponentDefinition<ShippingAddressCityControlProps>;
+export declare const ShippingAddressStateControlDefinition: ComponentDefinition<ShippingAddressStateControlProps>;
+export declare const ShippingAddressPostalCodeControlDefinition: ComponentDefinition<ShippingAddressPostalCodeControlProps>;
+export declare const ShippingAddressComplementControlDefinition: ComponentDefinition<ShippingAddressComplementControlProps>;
+export declare const ShippingAddressNeighborhoodControlDefinition: ComponentDefinition<ShippingAddressNeighborhoodControlProps>;
+export declare const ShippingAddressCountryControlDefinition: ComponentDefinition<ShippingAddressCountryControlProps>;
+export declare const ShippingAddressSavedListDefinition: ComponentDefinition<ShippingAddressSavedListProps>;
+export declare const ShippingAddressSavedOptionDefinition: ComponentDefinition<ShippingAddressSavedOptionProps>;
+export declare const ShippingAddressSubmitDefinition: ComponentDefinition<ShippingAddressSubmitProps>;
+export declare const ShippingAddressErrorDefinition: ComponentDefinition<ShippingAddressErrorProps>;
+export declare const ShippingAddressSavedAddressDrawerControllerDefinition: ComponentDefinition<ShippingAddressSavedAddressDrawerControllerProps>;
+export declare const ShippingAddressSavedAddressSubmitDefinition: ComponentDefinition<ShippingAddressSavedAddressSubmitProps>;
+export declare const ShippingAddressSelectedSummaryDefinition: ComponentDefinition<ShippingAddressSelectedSummaryProps>;
+export declare const ShippingAddressEditControllerDefinition: ComponentDefinition<ShippingAddressEditControllerProps>;
+export declare const ShippingAddressSummaryViewDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
+export declare const ShippingAddressEditFormDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
+export declare const ShippingAddressEditButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
+export declare const ShippingAddressCancelButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
+/**
+ * ShippingAddressRoot owns the batched form state, manages the current descriptor,
+ * and provides context to child Controls. It handles submit dispatch and error tracking.
+ */
+export declare function ShippingAddressRoot({ defaultCountry, className, children, $data: $dataProp, $actions }: ShippingAddressRootProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * RecipientNameControl — the only client-validated field (US-4, US-6).
+ * Pre-filled from clientProfile, editable, required.
+ */
+export declare function ShippingAddressRecipientNameControl({ className }: ShippingAddressRecipientNameControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** StreetControl */
+export declare function ShippingAddressStreetControl({ className }: ShippingAddressStreetControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** NumberControl */
+export declare function ShippingAddressNumberControl({ className }: ShippingAddressNumberControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** CityControl */
+export declare function ShippingAddressCityControl({ className }: ShippingAddressCityControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** StateControl */
+export declare function ShippingAddressStateControl({ className }: ShippingAddressStateControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** PostalCodeControl */
+export declare function ShippingAddressPostalCodeControl({ className }: ShippingAddressPostalCodeControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** ComplementControl */
+export declare function ShippingAddressComplementControl({ className }: ShippingAddressComplementControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** NeighborhoodControl (BR-specific in v1) */
+export declare function ShippingAddressNeighborhoodControl({ className }: ShippingAddressNeighborhoodControlProps): import("react/jsx-runtime").JSX.Element | null;
+/** CountryControl — lists only countries with a descriptor (US-2, first criterion) */
+export declare function ShippingAddressCountryControl({ className, label }: ShippingAddressCountryControlProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ShippingAddressSavedList — renders only when savedAddresses is non-empty (logged-in signal).
+ */
+export declare function ShippingAddressSavedList({ className }: ShippingAddressSavedListProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * ShippingAddressSavedOption — selectable saved address; populates draft on selection.
+ * Includes isCurrent visual variant to mark the address matching the current cart address (Decision 8).
+ */
+export declare function ShippingAddressSavedOption({ id, className }: ShippingAddressSavedOptionProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * ShippingAddressSubmit — dispatches the batched submit; reflects pending state.
+ */
+export declare function ShippingAddressSubmit({ className, label, pendingLabel }: ShippingAddressSubmitProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ShippingAddressSavedAddressDrawerController — makes the wrapped DrawerRoot controlled by the
+ * shipping-address context's savedAddressDrawerOpen state, and blocks dismissal (Escape, backdrop
+ * click, close button) while drawerSubmitting is true by simply not forwarding the close request
+ * to the setter. Mirrors CartOpenOnAdd's cloneElement mechanism. Expects a single DrawerRoot child.
+ */
+export declare function ShippingAddressSavedAddressDrawerController({ children }: ShippingAddressSavedAddressDrawerControllerProps): ReactNode;
+/**
+ * ShippingAddressSavedAddressSubmit — the drawer's "selecionar" submit button; independent
+ * submitting state from the main form's Submit (Decision 7); no-ops when the selected saved
+ * address is already the current one (Decision 8).
+ */
+export declare function ShippingAddressSavedAddressSubmit({ className, label, pendingLabel }: ShippingAddressSavedAddressSubmitProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ShippingAddressSelectedSummary — provides the current delivery address via AddressSummaryRoot's
+ * context and renders it through AddressSummary. Composed lines go through that same wrapper rather
+ * than replacing it, because AddressSummaryRoot renders no DOM and `className` would have nowhere to
+ * land. Self-gating on currentAddress: renders null when there is none yet, rather than an empty
+ * provider with nothing meaningful to show.
+ */
+export declare function ShippingAddressSelectedSummary({ className, children }: ShippingAddressSelectedSummaryProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * ShippingAddressEditController — owns the view/edit mode. Defaults to 'view' when a current
+ * address exists, 'edit' otherwise (derived reactively from currentAddressId, so it self-corrects
+ * if the address arrives asynchronously after mount, same issue as the draft-sync effect above).
+ * Once the shopper explicitly toggles (via ShippingAddressEditButton) or a submit succeeds, the
+ * explicit mode takes over. Does not render any DOM itself; provides ShippingAddressSectionContext
+ * to ShippingAddressSummaryView/ShippingAddressEditForm/ShippingAddressEditButton descendants.
+ */
+export declare function ShippingAddressEditController({ children }: ShippingAddressEditControllerProps): import("react/jsx-runtime").JSX.Element;
+/** Renders its children only while the section shows the saved-address summary. */
+export declare function ShippingAddressSummaryView({ children }: ShippingAddressSectionPanelProps): import("react/jsx-runtime").JSX.Element | null;
+/** Renders its children only while the section shows the address form. */
+export declare function ShippingAddressEditForm({ children }: ShippingAddressSectionPanelProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * ShippingAddressEditButton — CTA that switches the mode to 'edit'. Has no knowledge of why the
+ * mode might currently be 'view' (a current address, or a just-completed submit) — it only writes
+ * the mode forward.
+ */
+export declare function ShippingAddressEditButton({ className, label, children }: ShippingAddressEditButtonProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ShippingAddressCancelButton — returns the section to its summary without writing. Without it a
+ * shopper who opens the form can only leave through a successful `setAddress`, and blanking the
+ * recipient disables Submit, which leaves the section stuck open over the summary it replaced.
+ */
+export declare function ShippingAddressCancelButton({ className, label, children }: ShippingAddressEditButtonProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ShippingAddressError — renders domain userErrors inline, or generic upstream error state.
+ */
+export declare function ShippingAddressError({ className }: ShippingAddressErrorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const ShippingAddress: {
+  Root: typeof ShippingAddressRoot;
+  RootDefinition: ComponentDefinition<ShippingAddressRootProps>;
+  RecipientNameControl: typeof ShippingAddressRecipientNameControl;
+  RecipientNameControlDefinition: ComponentDefinition<ShippingAddressRecipientNameControlProps>;
+  StreetControl: typeof ShippingAddressStreetControl;
+  StreetControlDefinition: ComponentDefinition<ShippingAddressStreetControlProps>;
+  NumberControl: typeof ShippingAddressNumberControl;
+  NumberControlDefinition: ComponentDefinition<ShippingAddressNumberControlProps>;
+  CityControl: typeof ShippingAddressCityControl;
+  CityControlDefinition: ComponentDefinition<ShippingAddressCityControlProps>;
+  StateControl: typeof ShippingAddressStateControl;
+  StateControlDefinition: ComponentDefinition<ShippingAddressStateControlProps>;
+  PostalCodeControl: typeof ShippingAddressPostalCodeControl;
+  PostalCodeControlDefinition: ComponentDefinition<ShippingAddressPostalCodeControlProps>;
+  ComplementControl: typeof ShippingAddressComplementControl;
+  ComplementControlDefinition: ComponentDefinition<ShippingAddressComplementControlProps>;
+  NeighborhoodControl: typeof ShippingAddressNeighborhoodControl;
+  NeighborhoodControlDefinition: ComponentDefinition<ShippingAddressNeighborhoodControlProps>;
+  CountryControl: typeof ShippingAddressCountryControl;
+  CountryControlDefinition: ComponentDefinition<ShippingAddressCountryControlProps>;
+  SavedList: typeof ShippingAddressSavedList;
+  SavedListDefinition: ComponentDefinition<ShippingAddressSavedListProps>;
+  SavedOption: typeof ShippingAddressSavedOption;
+  SavedOptionDefinition: ComponentDefinition<ShippingAddressSavedOptionProps>;
+  Submit: typeof ShippingAddressSubmit;
+  SubmitDefinition: ComponentDefinition<ShippingAddressSubmitProps>;
+  SavedAddressDrawerController: typeof ShippingAddressSavedAddressDrawerController;
+  SavedAddressDrawerControllerDefinition: ComponentDefinition<ShippingAddressSavedAddressDrawerControllerProps>;
+  SavedAddressSubmit: typeof ShippingAddressSavedAddressSubmit;
+  SavedAddressSubmitDefinition: ComponentDefinition<ShippingAddressSavedAddressSubmitProps>;
+  SelectedSummary: typeof ShippingAddressSelectedSummary;
+  SelectedSummaryDefinition: ComponentDefinition<ShippingAddressSelectedSummaryProps>;
+  EditController: typeof ShippingAddressEditController;
+  EditControllerDefinition: ComponentDefinition<ShippingAddressEditControllerProps>;
+  SummaryView: typeof ShippingAddressSummaryView;
+  SummaryViewDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
+  EditForm: typeof ShippingAddressEditForm;
+  EditFormDefinition: ComponentDefinition<ShippingAddressSectionPanelProps>;
+  EditButton: typeof ShippingAddressEditButton;
+  EditButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
+  CancelButton: typeof ShippingAddressCancelButton;
+  CancelButtonDefinition: ComponentDefinition<ShippingAddressEditButtonProps>;
+  Error: typeof ShippingAddressError;
+  ErrorDefinition: ComponentDefinition<ShippingAddressErrorProps>;
+};
+//#endregion
+//# sourceMappingURL=shipping-address.d.ts.map