@vtex/faststore 0.0.7 → 0.0.10

package/dist/sdk/i18n/messages/pt-BR.json

@@ -1,12 +1,166 @@
 {
   "fs/a11y.close": "Fechar",
+  "fs/address-book.empty": "Você ainda não tem endereços salvos.",
+  "fs/address-book.error": "Não foi possível carregar seus endereços.",
+  "fs/address-book.loading": "Carregando seus endereços…",
+  "fs/address-book.profile-notice": "Seus endereços salvos não serão oferecidos no checkout até que seu perfil tenha um telefone.",
+  "fs/address-book.profile-notice.link": "Complete seu perfil",
+  "fs/address-book.retry": "Tentar novamente",
+  "fs/address-book.undeliverable": "No momento, não entregamos neste país.",
+  "fs/address-delete.cancel": "Cancelar",
+  "fs/address-delete.confirm": "Excluir",
+  "fs/address-delete.deleted": "Endereço excluído.",
+  "fs/address-delete.description": "Esta ação não pode ser desfeita.",
+  "fs/address-delete.error.failed": "Não foi possível excluir este endereço. Tente novamente.",
+  "fs/address-delete.error.unauthorized": "Sua sessão expirou. Entre novamente para excluir este endereço.",
+  "fs/address-delete.title": "Excluir este endereço?",
+  "fs/address-delete.trigger": "Excluir",
+  "fs/address-form.add": "Adicionar endereço",
+  "fs/address-form.added": "Endereço adicionado.",
+  "fs/address-form.cancel": "Cancelar",
+  "fs/address-form.country": "País",
+  "fs/address-form.country-notice": "{count, plural, one {Este campo não passa para um endereço em {country}: {fields}. Ele volta se você trocar de novo para {previous}.} other {Estes campos não passam para um endereço em {country}: {fields}. Eles voltam se você trocar de novo para {previous}.}}",
+  "fs/address-form.edit": "Editar",
+  "fs/address-form.error.country-switch-failed": "Não foi possível trocar o país. Tente de novo.",
+  "fs/address-form.error.not-found": "Este endereço não existe mais.",
+  "fs/address-form.error.rules-failed": "Não foi possível carregar este formulário. Feche-o e tente novamente.",
+  "fs/address-form.error.save-failed": "Não foi possível salvar este endereço. Tente novamente.",
+  "fs/address-form.error.unauthorized": "Sua sessão expirou. Entre novamente para salvar este endereço.",
+  "fs/address-form.error.unrendered-field": "Este endereço precisa de informações que este formulário não consegue mostrar, então ele não foi salvo.",
+  "fs/address-form.error.unsupported-country": "A loja não entrega neste país.",
+  "fs/address-form.saved": "Endereço salvo.",
+  "fs/address-form.status.failed": "Endereço não salvo.",
+  "fs/address-form.status.fields": "Endereço não salvo. {count, plural, one {# campo precisa de atenção.} other {# campos precisam de atenção.}}",
+  "fs/address-form.status.filled": "{count, plural, one {# campo preenchido a partir do CEP.} other {# campos preenchidos a partir do CEP.}}",
+  "fs/address-form.submit": "Salvar",
+  "fs/address-form.title.add": "Adicionar endereço",
+  "fs/address-form.title.edit": "Editar endereço",
+  "fs/address-record.error": "Não foi possível carregar este endereço.",
+  "fs/address.error.cep": "Informe um CEP válido (exemplo: {example}).",
+  "fs/address.error.invalid": "Confira este campo.",
+  "fs/address.error.postal-code": "Informe um código postal válido (exemplo: {example}).",
+  "fs/address.error.required": "Campo obrigatório.",
+  "fs/address.error.too-long": "Use no máximo {maxLength, number} caracteres.",
+  "fs/address.field.cep": "CEP",
+  "fs/address.field.city": "Cidade",
+  "fs/address.field.commune": "Comuna",
+  "fs/address.field.complement": "Complemento (opcional)",
+  "fs/address.field.county": "Condado",
+  "fs/address.field.department": "Departamento",
+  "fs/address.field.district": "Distrito",
+  "fs/address.field.municipality": "Município",
+  "fs/address.field.name": "Nome do endereço (opcional)",
+  "fs/address.field.neighborhood": "Bairro",
+  "fs/address.field.number": "Número",
+  "fs/address.field.postal-code": "Código postal",
+  "fs/address.field.postcode": "Código postal",
+  "fs/address.field.province": "Província",
+  "fs/address.field.recipient-name": "Nome do destinatário",
+  "fs/address.field.reference": "Referência (opcional)",
+  "fs/address.field.region": "Região",
+  "fs/address.field.state": "Estado",
+  "fs/address.field.street": "Endereço",
+  "fs/address.field.town": "Cidade",
+  "fs/address.placeholder.postal-code": "Exemplo: {example}",
+  "fs/address.placeholder.street": "Endereço",
+  "fs/card.ending-in": "final {lastDigits}",
   "fs/form.clear": "Limpar",
   "fs/form.reset": "Redefinir",
   "fs/form.submit": "Continuar",
+  "fs/order-cancel.confirm": "Cancelar pedido",
+  "fs/order-cancel.description": "Esta ação não pode ser desfeita.",
+  "fs/order-cancel.dismiss": "Manter pedido",
+  "fs/order-cancel.dismiss-message": "Dispensar",
+  "fs/order-cancel.failure": "Não foi possível cancelar o pedido. Tente novamente.",
+  "fs/order-cancel.other": "Outro",
+  "fs/order-cancel.other-field": "Motivo",
+  "fs/order-cancel.reason.better-price": "Encontrei um preço melhor",
+  "fs/order-cancel.reason.bought-by-mistake": "Comprei por engano",
+  "fs/order-cancel.reason.changed-mind": "Mudei de ideia",
+  "fs/order-cancel.reason.slow-delivery": "A entrega está demorando",
+  "fs/order-cancel.success": "Seu pedido foi cancelado.",
+  "fs/order-cancel.title": "Cancelar este pedido?",
+  "fs/order-cancel.trigger": "Cancelar pedido",
+  "fs/order-delivery-address.delivery": "Endereço de entrega",
+  "fs/order-delivery-address.store": "Endereço da loja",
+  "fs/order-delivery-group.channel.delivery": "Entrega",
+  "fs/order-delivery-group.channel.pickup-in-point": "Retirada",
+  "fs/order-delivery-group.estimate": "Previsão de entrega",
+  "fs/order-delivery-group.items": "{count, plural, one {# item} other {# itens}}",
+  "fs/order-delivery-group.label": "Entregas",
+  "fs/order-delivery-group.list-price": "Preço de lista",
+  "fs/order-delivery-group.quantity": "Quantidade",
+  "fs/order-delivery-group.subtotal": "Subtotal",
+  "fs/order-delivery-group.tax": "Imposto",
+  "fs/order-delivery-group.total": "Total",
+  "fs/order-delivery-group.unit-price": "Preço unitário",
+  "fs/order-list.column.estimate": "Previsão",
+  "fs/order-list.column.id": "Pedido",
+  "fs/order-list.column.items": "Itens",
+  "fs/order-list.column.placed": "Data",
+  "fs/order-list.column.status": "Status",
+  "fs/order-list.column.total": "Total",
+  "fs/order-payment.bank-invoice.number": "Número do boleto",
+  "fs/order-payment.bank-invoice.print": "Imprimir boleto",
+  "fs/order-payment.empty": "Nenhum pagamento registrado",
+  "fs/order-payment.heading": "Pagamento",
+  "fs/order-payment.installments": "{count}x {amount}",
+  "fs/order-payment.method.placeholder": "Forma de pagamento indisponível",
+  "fs/order-payment.redemption-code": "Código do vale-presente",
+  "fs/order-status.cancellation-requested": "Cancelamento solicitado",
+  "fs/order-status.cancelled": "Cancelado",
+  "fs/order-status.collected": "Retirado",
+  "fs/order-status.delivered": "Entregue",
+  "fs/order-status.in-progress": "Em andamento",
+  "fs/order-status.placeholder": "Status indisponível",
+  "fs/order-status.ready-for-pickup": "Pronto para retirada",
+  "fs/order-status.shipped": "Enviado",
+  "fs/order.back-to-orders": "Voltar aos pedidos",
+  "fs/order.copy.action": "Copiar",
+  "fs/order.copy.copied": "Copiado",
+  "fs/order.copy.dismiss": "Dispensar",
+  "fs/order.copy.failure": "Não foi possível copiar",
+  "fs/order.number.copy-name": "Copiar número do pedido",
+  "fs/order.number.prefix": "Pedido nº",
+  "fs/order.placed-at": "Pedido realizado",
+  "fs/order.progress.label": "Progresso do pedido",
+  "fs/order.stage-state.current": "Em andamento",
+  "fs/order.stage-state.done": "Concluído",
+  "fs/order.stage-state.pending": "Não iniciado",
+  "fs/order.stage.payment": "Pagamento",
+  "fs/order.stage.placed": "Pedido realizado",
+  "fs/order.stage.processing": "Preparação",
+  "fs/order.stage.shipping": "Envio",
+  "fs/order.totals.change": "Troco",
+  "fs/order.totals.discounts": "Descontos",
+  "fs/order.totals.grand-total": "Total",
+  "fs/order.totals.heading": "Resumo",
+  "fs/order.totals.interest": "Juros",
+  "fs/order.totals.items": "Itens",
+  "fs/order.totals.shipping": "Frete",
+  "fs/order.totals.tax": "Impostos",
   "fs/region.error.invalid-postal-code": "Informe um CEP válido.",
   "fs/region.error.network": "Não foi possível definir sua região. Tente novamente.",
   "fs/region.error.unserved-postal-code": "Ainda não entregamos neste CEP.",
   "fs/route.not-found": "Página não encontrada",
+  "fs/saved-cards.empty": "Você ainda não tem cartões salvos.",
+  "fs/saved-cards.expired": "Venceu em",
+  "fs/saved-cards.expired-no-date": "Vencido",
+  "fs/saved-cards.expires": "Vence em",
+  "fs/saved-cards.heading": "Cartões salvos",
+  "fs/saved-cards.load-failed": "Não foi possível carregar seus cartões salvos. Tente novamente mais tarde.",
+  "fs/saved-cards.loading": "Carregando seus cartões salvos…",
+  "fs/saved-cards.remove.cancel": "Cancelar",
+  "fs/saved-cards.remove.confirm": "Remover cartão",
+  "fs/saved-cards.remove.description": "Ele não será mais oferecido no pagamento. Essa ação não pode ser desfeita.",
+  "fs/saved-cards.remove.failed": "Não foi possível remover o cartão. Tente novamente.",
+  "fs/saved-cards.remove.pending": "Removendo…",
+  "fs/saved-cards.remove.success": "O cartão foi removido.",
+  "fs/saved-cards.remove.title": "Remover este cartão?",
+  "fs/saved-cards.remove.trigger": "Remover",
+  "fs/saved-cards.session-expired": "Sua sessão expirou.",
+  "fs/saved-cards.sign-in": "Entrar novamente",
+  "fs/saved-cards.unusable": "Este cartão não pode ser usado",
   "fs/shipping.calculating": "Calculando…",
   "fs/shipping.calculation-failed": "Não foi possível calcular o frete. Tente novamente.",
   "fs/shipping.estimate.in-business-days": "em {days, plural, one {# dia útil} other {# dias úteis}}",
@@ -18,5 +172,7 @@
   "fs/shipping.free-price": "Grátis",
   "fs/shipping.no-options": "Nenhuma opção de entrega disponível para este endereço.",
   "fs/shipping.postal-code.aria-label": "CEP",
-  "fs/shipping.postal-code.placeholder": "Digite seu CEP"
+  "fs/shipping.postal-code.placeholder": "Digite seu CEP",
+  "fs/toast.dismiss": "Fechar",
+  "fs/toast.region": "Notificações"
 }

package/dist/sdk/i18n/provider.js

@@ -7,7 +7,7 @@ import { IntlProvider } from "react-intl";
 * Mounted by `StorefrontProvider`, never by a store.
 *
 * The record arrives already resolved: the server merged the locale's catalog over the fallback
-* chain `global.json` declares, so SSR and hydration read the same bytes and only one locale reaches
+* chain the store's foundation declares, so SSR and hydration read the same bytes and only one locale reaches
 * the browser.
 *
 * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the

package/dist/sdk/i18n/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../../src/sdk/i18n/provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { IntlProvider } from 'react-intl';\nimport { asIntlMessages, DEFAULT_LOCALE, type Messages, normalizeLocale, onIntlError } from './locales.js';\n\nexport type MessageProviderProps = Readonly<{\n  locale: string;\n  messages: Messages;\n  children: ReactNode;\n}>;\n\n/**\n * Mounted by `StorefrontProvider`, never by a store.\n *\n * The record arrives already resolved: the server merged the locale's catalog over the fallback\n * chain `global.json` declares, so SSR and hydration read the same bytes and only one locale reaches\n * the browser.\n *\n * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the\n * declared locale the strings rendered are the source catalog's, and plural categories have to be\n * selected under the language those strings are written in. Without it a Server Component and a\n * Client Component could pluralize the same English string under different rules.\n */\nexport function MessageProvider({ locale, messages, children }: MessageProviderProps) {\n  return (\n    <IntlProvider\n      locale={normalizeLocale(locale) ?? DEFAULT_LOCALE}\n      defaultLocale={DEFAULT_LOCALE}\n      messages={asIntlMessages(messages)}\n      onError={onIntlError}\n    >\n      {children}\n    </IntlProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,SAAgB,gBAAgB,EAAE,QAAQ,UAAU,YAAkC;CACpF,OACE,oBAAC,cAAD;EACE,QAAQ,gBAAgB,MAAM,KAAA;EAC9B,eAAe;EACf,UAAU,eAAe,QAAQ;EACjC,SAAS;EAER;CACW,CAAA;AAElB"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/sdk/i18n/provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { IntlProvider } from 'react-intl';\nimport { asIntlMessages, DEFAULT_LOCALE, type Messages, normalizeLocale, onIntlError } from './locales.js';\n\nexport type MessageProviderProps = Readonly<{\n  locale: string;\n  messages: Messages;\n  children: ReactNode;\n}>;\n\n/**\n * Mounted by `StorefrontProvider`, never by a store.\n *\n * The record arrives already resolved: the server merged the locale's catalog over the fallback\n * chain the store's foundation declares, so SSR and hydration read the same bytes and only one locale reaches\n * the browser.\n *\n * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the\n * declared locale the strings rendered are the source catalog's, and plural categories have to be\n * selected under the language those strings are written in. Without it a Server Component and a\n * Client Component could pluralize the same English string under different rules.\n */\nexport function MessageProvider({ locale, messages, children }: MessageProviderProps) {\n  return (\n    <IntlProvider\n      locale={normalizeLocale(locale) ?? DEFAULT_LOCALE}\n      defaultLocale={DEFAULT_LOCALE}\n      messages={asIntlMessages(messages)}\n      onError={onIntlError}\n    >\n      {children}\n    </IntlProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,SAAgB,gBAAgB,EAAE,QAAQ,UAAU,YAAkC;CACpF,OACE,oBAAC,cAAD;EACE,QAAQ,gBAAgB,MAAM,KAAA;EAC9B,eAAe;EACf,UAAU,eAAe,QAAQ;EACjC,SAAS;EAER;CACW,CAAA;AAElB"}

package/dist/sdk/locale/binding-switch-provider.d.ts

@@ -0,0 +1,13 @@
+import { BindingSwitchRequest, BindingSwitchResult } from "../navigation/binding-switch.js";
+import { ReactNode } from "react";
+//#region src/sdk/locale/binding-switch-provider.d.ts
+export type SwitchBinding = (request: BindingSwitchRequest) => Promise<BindingSwitchResult>;
+export type BindingSwitchProviderProps = Readonly<{
+  /** The app's `switchBinding` server action. The package cannot import the generated binding table. */
+  switchBinding: SwitchBinding;
+  children: ReactNode;
+}>;
+/** Hands the generated app's `switchBinding` server action to `locale.set`. */
+export declare function BindingSwitchProvider({ switchBinding, children }: BindingSwitchProviderProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=binding-switch-provider.d.ts.map

package/dist/sdk/locale/binding-switch-provider.js

@@ -0,0 +1,20 @@
+"use client";
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/sdk/locale/binding-switch-provider.tsx
+const Context = createContext(null);
+/** Hands the generated app's `switchBinding` server action to `locale.set`. */
+function BindingSwitchProvider({ switchBinding, children }) {
+	return /* @__PURE__ */ jsx(Context.Provider, {
+		value: switchBinding,
+		children
+	});
+}
+/** The provided server action, or `null` outside a `BindingSwitchProvider`. */
+function useSwitchBinding() {
+	return useContext(Context);
+}
+//#endregion
+export { BindingSwitchProvider, useSwitchBinding };
+
+//# sourceMappingURL=binding-switch-provider.js.map

package/dist/sdk/locale/binding-switch-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-switch-provider.js","names":[],"sources":["../../../src/sdk/locale/binding-switch-provider.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, type ReactNode, useContext } from 'react';\nimport type { BindingSwitchRequest, BindingSwitchResult } from '../navigation/binding-switch.js';\n\nexport type SwitchBinding = (request: BindingSwitchRequest) => Promise<BindingSwitchResult>;\n\nexport type BindingSwitchProviderProps = Readonly<{\n  /** The app's `switchBinding` server action. The package cannot import the generated binding table. */\n  switchBinding: SwitchBinding;\n  children: ReactNode;\n}>;\n\nconst Context = createContext<SwitchBinding | null>(null);\n\n/** Hands the generated app's `switchBinding` server action to `locale.set`. */\nexport function BindingSwitchProvider({ switchBinding, children }: BindingSwitchProviderProps) {\n  return <Context.Provider value={switchBinding}>{children}</Context.Provider>;\n}\n\n/** The provided server action, or `null` outside a `BindingSwitchProvider`. */\nexport function useSwitchBinding(): SwitchBinding | null {\n  return useContext(Context);\n}\n"],"mappings":";;;;AAaA,MAAM,UAAU,cAAoC,IAAI;;AAGxD,SAAgB,sBAAsB,EAAE,eAAe,YAAwC;CAC7F,OAAO,oBAAC,QAAQ,UAAT;EAAkB,OAAO;EAAgB;CAA2B,CAAA;AAC7E;;AAGA,SAAgB,mBAAyC;CACvD,OAAO,WAAW,OAAO;AAC3B"}

package/dist/sdk/locale/use-locale-actions.d.ts

@@ -0,0 +1,16 @@
+import "../../core/dist/index.js";
+//#region src/sdk/locale/use-locale-actions.d.ts
+/**
+ * The `locale` action namespace. `set` switches the whole binding (locale, currency, sales channel):
+ * the app's server action decides the equivalent URL, or the no-equivalent fallback, and the browser
+ * goes there with a document navigation. `set` always resolves, never navigates on an error, and
+ * resolves `true` only when it started the navigation.
+ */
+export type LocaleActions = Readonly<{
+  /** Switches to the binding `bindingId` names. `true` once the navigation starts; `false` after logging. */
+  set: (payload: {
+    bindingId: string;
+  }) => Promise<boolean>;
+}>;
+//#endregion
+//# sourceMappingURL=use-locale-actions.d.ts.map

package/dist/sdk/locale/use-locale-actions.js

@@ -0,0 +1,70 @@
+"use client";
+import { defineActions } from "../../core/dist/actions/registry.js";
+import "../../core/dist/index.js";
+import { useStorefrontContext } from "../context/storefront-context.js";
+import { useStorefrontRoute } from "../navigation/use-storefront-route.js";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { useSwitchBinding } from "./binding-switch-provider.js";
+import { useCallback, useMemo } from "react";
+//#region src/sdk/locale/use-locale-actions.ts
+/**
+* The `locale` namespace hook. Reads the route at call time: `search` and `hash` come from
+* `location`, because `useStorefrontRoute().search` is `null` during hydration. The page name is
+* not sent: a layout has none, and the server derives the page from the path and params.
+*/
+function useLocaleActions() {
+	const switchBinding = useSwitchBinding();
+	const { params, path } = useStorefrontRoute();
+	const { bindingId: currentBindingId } = useStorefrontContext();
+	const set = useCallback(async ({ bindingId }) => {
+		if (!switchBinding) {
+			console.error("[locale.set] no BindingSwitchProvider");
+			return false;
+		}
+		try {
+			const { url } = await switchBinding({
+				bindingId,
+				currentBindingId,
+				params,
+				path,
+				search: globalThis.location.search,
+				hash: globalThis.location.hash
+			});
+			if (url === null) {
+				console.error("[locale.set] no URL for the binding");
+				return false;
+			}
+			globalThis.location.assign(url);
+			return true;
+		} catch (error) {
+			console.error("[locale.set] switchBinding failed", loggableErrorName(error));
+			return false;
+		}
+	}, [
+		switchBinding,
+		currentBindingId,
+		params,
+		path
+	]);
+	return useMemo(() => ({ set }), [set]);
+}
+defineActions({
+	namespace: "locale",
+	description: "Switches the whole binding (locale, currency, sales channel) by a document navigation to the equivalent URL, or to the destination home with a notice.",
+	provider: {
+		name: "LocaleActionProvider",
+		importPath: "@vtex/faststore/internal/client"
+	},
+	methods: { set: {
+		description: "Switch to another binding: navigates to the equivalent URL of the current page, or to the destination home with fs_notice=no-equivalent.",
+		payload: [{
+			name: "bindingId",
+			type: "string"
+		}]
+	} },
+	use: useLocaleActions
+});
+//#endregion
+export { useLocaleActions };
+
+//# sourceMappingURL=use-locale-actions.js.map

package/dist/sdk/locale/use-locale-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-locale-actions.js","names":[],"sources":["../../../src/sdk/locale/use-locale-actions.ts"],"sourcesContent":["'use client';\n\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { useStorefrontContext } from '../context/storefront-context.js';\nimport { useStorefrontRoute } from '../navigation/use-storefront-route.js';\nimport { useSwitchBinding } from './binding-switch-provider.js';\n\n/**\n * The `locale` action namespace. `set` switches the whole binding (locale, currency, sales channel):\n * the app's server action decides the equivalent URL, or the no-equivalent fallback, and the browser\n * goes there with a document navigation. `set` always resolves, never navigates on an error, and\n * resolves `true` only when it started the navigation.\n */\nexport type LocaleActions = Readonly<{\n  /** Switches to the binding `bindingId` names. `true` once the navigation starts; `false` after logging. */\n  set: (payload: { bindingId: string }) => Promise<boolean>;\n}>;\n\n/**\n * The `locale` namespace hook. Reads the route at call time: `search` and `hash` come from\n * `location`, because `useStorefrontRoute().search` is `null` during hydration. The page name is\n * not sent: a layout has none, and the server derives the page from the path and params.\n */\nexport function useLocaleActions(): LocaleActions {\n  const switchBinding = useSwitchBinding();\n  const { params, path } = useStorefrontRoute();\n  const { bindingId: currentBindingId } = useStorefrontContext();\n\n  const set = useCallback<LocaleActions['set']>(\n    async ({ bindingId }) => {\n      if (!switchBinding) {\n        console.error('[locale.set] no BindingSwitchProvider');\n        return false;\n      }\n      try {\n        const { url } = await switchBinding({\n          bindingId,\n          currentBindingId,\n          params,\n          path,\n          search: globalThis.location.search,\n          hash: globalThis.location.hash,\n        });\n        if (url === null) {\n          console.error('[locale.set] no URL for the binding');\n          return false;\n        }\n        globalThis.location.assign(url);\n        return true;\n      } catch (error) {\n        console.error('[locale.set] switchBinding failed', loggableErrorName(error));\n        return false;\n      }\n    },\n    [switchBinding, currentBindingId, params, path],\n  );\n\n  return useMemo(() => ({ set }), [set]);\n}\n\n/**\n * Declares the `locale` action namespace. The native catalog builder reads this call to emit\n * `actions.json`; at runtime `LocaleActionProvider` calls `useLocaleActions` directly.\n */\nexport const localeActions = defineActions({\n  namespace: 'locale',\n  description:\n    'Switches the whole binding (locale, currency, sales channel) by a document navigation to the equivalent URL, or to the destination home with a notice.',\n  provider: { name: 'LocaleActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    set: {\n      description:\n        'Switch to another binding: navigates to the equivalent URL of the current page, or to the destination home with fs_notice=no-equivalent.',\n      payload: [{ name: 'bindingId', type: 'string' }],\n    },\n  },\n  use: useLocaleActions,\n});\n"],"mappings":";;;;;;;;;;;;;;AAyBA,SAAgB,mBAAkC;CAChD,MAAM,gBAAgB,iBAAiB;CACvC,MAAM,EAAE,QAAQ,SAAS,mBAAmB;CAC5C,MAAM,EAAE,WAAW,qBAAqB,qBAAqB;CAE7D,MAAM,MAAM,YACV,OAAO,EAAE,gBAAgB;EACvB,IAAI,CAAC,eAAe;GAClB,QAAQ,MAAM,uCAAuC;GACrD,OAAO;EACT;EACA,IAAI;GACF,MAAM,EAAE,QAAQ,MAAM,cAAc;IAClC;IACA;IACA;IACA;IACA,QAAQ,WAAW,SAAS;IAC5B,MAAM,WAAW,SAAS;GAC5B,CAAC;GACD,IAAI,QAAQ,MAAM;IAChB,QAAQ,MAAM,qCAAqC;IACnD,OAAO;GACT;GACA,WAAW,SAAS,OAAO,GAAG;GAC9B,OAAO;EACT,SAAS,OAAO;GACd,QAAQ,MAAM,qCAAqC,kBAAkB,KAAK,CAAC;GAC3E,OAAO;EACT;CACF,GACA;EAAC;EAAe;EAAkB;EAAQ;CAAI,CAChD;CAEA,OAAO,eAAe,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC;AACvC;AAM6B,cAAc;CACzC,WAAW;CACX,aACE;CACF,UAAU;EAAE,MAAM;EAAwB,YAAY;CAAkC;CACxF,SAAS,EACP,KAAK;EACH,aACE;EACF,SAAS,CAAC;GAAE,MAAM;GAAa,MAAM;EAAS,CAAC;CACjD,EACF;CACA,KAAK;AACP,CAAC"}

package/dist/sdk/navigation/binding-switch.d.ts

@@ -0,0 +1,39 @@
+import { RouteMap } from "./types.js";
+import { AlternateBinding } from "../seo/page-alternates.js";
+import { ApolloClient } from "@apollo/client";
+//#region src/sdk/navigation/binding-switch.d.ts
+export type BindingSwitchRequest = {
+  /** Destination binding id. */
+  bindingId: string;
+  /** The binding the shopper is on. */
+  currentBindingId: string;
+  params: Record<string, string | string[]>;
+  /** Decoded logical path of the current page. */
+  path: string;
+  /** `location.search`: `''` or `'?…'`. */
+  search: string;
+  /** `location.hash`: `''` or `'#…'`. */
+  hash: string;
+};
+export type BindingSwitchResult = {
+  url: string | null;
+};
+export type ResolveBindingSwitchOptions = {
+  request: BindingSwitchRequest;
+  knownBindingId: (candidate: string | null | undefined) => string | null;
+  bindings: readonly AlternateBinding[];
+  routeMap: RouteMap;
+  buildUrl: (bindingId: string, logicalPath: string) => string;
+  clientFor: (bindingId: string) => ApolloClient;
+};
+/**
+ * The equivalent URL of the current page in the destination binding, or the destination's home with
+ * `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map
+ * entry whose href in the current binding equals the logical path; none or several take the
+ * fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared
+ * destination resolves `{ url: null }`. The request comes off the wire, so each field is read as
+ * unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.
+ */
+export declare function resolveBindingSwitch({ request, knownBindingId, bindings, routeMap, buildUrl, clientFor }: ResolveBindingSwitchOptions): Promise<BindingSwitchResult>;
+//#endregion
+//# sourceMappingURL=binding-switch.d.ts.map

package/dist/sdk/navigation/binding-switch.js

@@ -0,0 +1,129 @@
+import { resolveStorefrontHref } from "./resolve-storefront-href.js";
+import { CATALOG_ROUTE_ALTERNATES_QUERY, catalogClusterPaths, encodePath } from "../seo/page-alternates.js";
+import { decodeRouteParams } from "./decode-route-params.js";
+//#region src/sdk/navigation/binding-switch.ts
+/** Bounds the `catalogRoute` lookup: a slow API takes the no-equivalent fallback instead of stalling the switch. */
+const BINDING_SWITCH_LOOKUP_TIMEOUT_MS = 3e3;
+const CATALOG_STANDARDS = /* @__PURE__ */ new Set([
+	"product",
+	"category",
+	"brand",
+	"collection"
+]);
+const NO_EQUIVALENT_QUERY = "?fs_notice=no-equivalent";
+/**
+* The equivalent URL of the current page in the destination binding, or the destination's home with
+* `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map
+* entry whose href in the current binding equals the logical path; none or several take the
+* fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared
+* destination resolves `{ url: null }`. The request comes off the wire, so each field is read as
+* unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.
+*/
+async function resolveBindingSwitch({ request, knownBindingId, bindings, routeMap, buildUrl, clientFor }) {
+	const destination = knownBindingId(stringOr(request.bindingId, null));
+	if (destination === null) {
+		console.error("[locale.set] unknown binding");
+		return { url: null };
+	}
+	const fallback = { url: `${buildUrl(destination, "/")}${NO_EQUIVALENT_QUERY}` };
+	const path = stringOr(request.path, "");
+	const params = decodeRouteParams(paramsOf(request.params));
+	const page = pageMatchingPath(routeMap, stringOr(request.currentBindingId, ""), path, params);
+	const entry = page === void 0 ? void 0 : ownEntry(routeMap, page);
+	if (page === void 0 || entry === void 0) return fallback;
+	if (entry.bindings !== void 0 && !entry.bindings.includes(destination)) return fallback;
+	const tail = `${searchOf(request.search)}${hashOf(request.hash)}`;
+	if (entry.standard !== void 0 && CATALOG_STANDARDS.has(entry.standard)) {
+		const current = knownBindingId(stringOr(request.currentBindingId, null));
+		if (current === null || path === "" || path === "/") return fallback;
+		const paths = await catalogClusterPaths(bindings, async () => {
+			const { data, error } = await clientFor(current).query({
+				query: CATALOG_ROUTE_ALTERNATES_QUERY,
+				variables: { path },
+				errorPolicy: "all",
+				fetchPolicy: "no-cache",
+				context: { fetchOptions: { signal: AbortSignal.timeout(BINDING_SWITCH_LOOKUP_TIMEOUT_MS) } }
+			});
+			return {
+				data,
+				error
+			};
+		});
+		const variantPath = paths && Object.hasOwn(paths, destination) ? paths[destination] : void 0;
+		if (variantPath === void 0) return fallback;
+		return { url: `${buildUrl(destination, encodePath(variantPath))}${tail}` };
+	}
+	const { href } = resolveStorefrontHref({
+		bindingId: destination,
+		basePath: "/"
+	}, routeMap, {
+		page,
+		params
+	});
+	if (href === null) return fallback;
+	return { url: `${buildUrl(destination, href)}${tail}` };
+}
+function stringOr(value, empty) {
+	return typeof value === "string" ? value : empty;
+}
+function paramsOf(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+/**
+* The single page whose href in the current binding is this logical path. A miss and a tie are both
+* no page: the switch falls back instead of guessing. An entry that cannot be resolved (a missing
+* param, a binding it does not serve) is skipped.
+*/
+function pageMatchingPath(routeMap, bindingId, path, params) {
+	const matches = [];
+	for (const name of Object.keys(routeMap)) {
+		const { href } = resolveStorefrontHref({
+			bindingId,
+			basePath: "/"
+		}, routeMap, {
+			page: name,
+			params
+		});
+		if (href === null || !sameDecodedPath(href, path)) continue;
+		matches.push(name);
+	}
+	return matches.length === 1 ? matches[0] : void 0;
+}
+/**
+* `resolveStorefrontHref` percent-encodes params, so the href is decoded once. The request path is
+* compared as it arrived first, so a decoded slug like `100%-off` or `%41` is not decoded again; an
+* encoded path still matches through its decoded form.
+*/
+function sameDecodedPath(href, path) {
+	const decodedHref = decodeOrNull(href);
+	if (decodedHref === null) return false;
+	return decodedHref === path || decodedHref === decodeOrNull(path);
+}
+function decodeOrNull(text) {
+	try {
+		return decodeURIComponent(text);
+	} catch {
+		return null;
+	}
+}
+function ownEntry(routeMap, page) {
+	return Object.hasOwn(routeMap, page) ? routeMap[page] : void 0;
+}
+/** Kept verbatim when it is only a query: a leading `?`, no `#`, and no control character. */
+function searchOf(search) {
+	const text = stringOr(search, "");
+	if (text.length < 2 || !text.startsWith("?")) return "";
+	for (const char of text) {
+		const code = char.codePointAt(0) ?? 0;
+		if (char === "#" || code < 32 || code === 127) return "";
+	}
+	return text;
+}
+function hashOf(hash) {
+	const text = stringOr(hash, "");
+	return text.startsWith("#") && text.length > 1 ? text : "";
+}
+//#endregion
+export { resolveBindingSwitch };
+
+//# sourceMappingURL=binding-switch.js.map

package/dist/sdk/navigation/binding-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-switch.js","names":[],"sources":["../../../src/sdk/navigation/binding-switch.ts"],"sourcesContent":["import type { ApolloClient } from '@apollo/client';\nimport {\n  type AlternateBinding,\n  CATALOG_ROUTE_ALTERNATES_QUERY,\n  catalogClusterPaths,\n  encodePath,\n} from '../seo/page-alternates.js';\nimport { decodeRouteParams } from './decode-route-params.js';\nimport { resolveStorefrontHref } from './resolve-storefront-href.js';\nimport type { RouteMap, RouteMapEntry, StandardName } from './types.js';\n\n/** Bounds the `catalogRoute` lookup: a slow API takes the no-equivalent fallback instead of stalling the switch. */\nconst BINDING_SWITCH_LOOKUP_TIMEOUT_MS = 3_000;\n\nconst CATALOG_STANDARDS: ReadonlySet<StandardName> = new Set(['product', 'category', 'brand', 'collection']);\n\nconst NO_EQUIVALENT_QUERY = '?fs_notice=no-equivalent';\n\nexport type BindingSwitchRequest = {\n  /** Destination binding id. */\n  bindingId: string;\n  /** The binding the shopper is on. */\n  currentBindingId: string;\n  params: Record<string, string | string[]>;\n  /** Decoded logical path of the current page. */\n  path: string;\n  /** `location.search`: `''` or `'?…'`. */\n  search: string;\n  /** `location.hash`: `''` or `'#…'`. */\n  hash: string;\n};\n\nexport type BindingSwitchResult = { url: string | null };\n\nexport type ResolveBindingSwitchOptions = {\n  request: BindingSwitchRequest;\n  knownBindingId: (candidate: string | null | undefined) => string | null;\n  bindings: readonly AlternateBinding[];\n  routeMap: RouteMap;\n  buildUrl: (bindingId: string, logicalPath: string) => string;\n  clientFor: (bindingId: string) => ApolloClient;\n};\n\n/**\n * The equivalent URL of the current page in the destination binding, or the destination's home with\n * `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map\n * entry whose href in the current binding equals the logical path; none or several take the\n * fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared\n * destination resolves `{ url: null }`. The request comes off the wire, so each field is read as\n * unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.\n */\nexport async function resolveBindingSwitch({\n  request,\n  knownBindingId,\n  bindings,\n  routeMap,\n  buildUrl,\n  clientFor,\n}: ResolveBindingSwitchOptions): Promise<BindingSwitchResult> {\n  const destination = knownBindingId(stringOr(request.bindingId, null));\n  if (destination === null) {\n    console.error('[locale.set] unknown binding');\n    return { url: null };\n  }\n\n  const fallback = { url: `${buildUrl(destination, '/')}${NO_EQUIVALENT_QUERY}` };\n  const path = stringOr(request.path, '');\n  // `useParams()` hands the segments over percent-encoded; the route map fills patterns with decoded values.\n  const params = decodeRouteParams(paramsOf(request.params));\n  const page = pageMatchingPath(routeMap, stringOr(request.currentBindingId, ''), path, params);\n  const entry = page === undefined ? undefined : ownEntry(routeMap, page);\n  if (page === undefined || entry === undefined) return fallback;\n  if (entry.bindings !== undefined && !entry.bindings.includes(destination)) return fallback;\n\n  const tail = `${searchOf(request.search)}${hashOf(request.hash)}`;\n\n  if (entry.standard !== undefined && CATALOG_STANDARDS.has(entry.standard)) {\n    const current = knownBindingId(stringOr(request.currentBindingId, null));\n    if (current === null || path === '' || path === '/') return fallback;\n\n    const paths = await catalogClusterPaths(bindings, async () => {\n      const { data, error } = await clientFor(current).query({\n        query: CATALOG_ROUTE_ALTERNATES_QUERY,\n        variables: { path },\n        errorPolicy: 'all',\n        fetchPolicy: 'no-cache',\n        context: { fetchOptions: { signal: AbortSignal.timeout(BINDING_SWITCH_LOOKUP_TIMEOUT_MS) } },\n      });\n      return { data, error };\n    });\n    const variantPath = paths && Object.hasOwn(paths, destination) ? paths[destination] : undefined;\n    if (variantPath === undefined) return fallback;\n    return { url: `${buildUrl(destination, encodePath(variantPath))}${tail}` };\n  }\n\n  const { href } = resolveStorefrontHref({ bindingId: destination, basePath: '/' }, routeMap, { page, params });\n  if (href === null) return fallback;\n  return { url: `${buildUrl(destination, href)}${tail}` };\n}\n\nfunction stringOr<T extends string | null>(value: unknown, empty: T): string | T {\n  return typeof value === 'string' ? value : empty;\n}\n\nfunction paramsOf(value: unknown): BindingSwitchRequest['params'] {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as BindingSwitchRequest['params'])\n    : {};\n}\n\n/**\n * The single page whose href in the current binding is this logical path. A miss and a tie are both\n * no page: the switch falls back instead of guessing. An entry that cannot be resolved (a missing\n * param, a binding it does not serve) is skipped.\n */\nfunction pageMatchingPath(\n  routeMap: RouteMap,\n  bindingId: string,\n  path: string,\n  params: BindingSwitchRequest['params'],\n): string | undefined {\n  const matches: string[] = [];\n  for (const name of Object.keys(routeMap)) {\n    const { href } = resolveStorefrontHref({ bindingId, basePath: '/' }, routeMap, { page: name, params });\n    if (href === null || !sameDecodedPath(href, path)) continue;\n    matches.push(name);\n  }\n  return matches.length === 1 ? matches[0] : undefined;\n}\n\n/**\n * `resolveStorefrontHref` percent-encodes params, so the href is decoded once. The request path is\n * compared as it arrived first, so a decoded slug like `100%-off` or `%41` is not decoded again; an\n * encoded path still matches through its decoded form.\n */\nfunction sameDecodedPath(href: string, path: string): boolean {\n  const decodedHref = decodeOrNull(href);\n  if (decodedHref === null) return false;\n  return decodedHref === path || decodedHref === decodeOrNull(path);\n}\n\nfunction decodeOrNull(text: string): string | null {\n  try {\n    return decodeURIComponent(text);\n  } catch {\n    return null;\n  }\n}\n\nfunction ownEntry(routeMap: RouteMap, page: string): RouteMapEntry | undefined {\n  return Object.hasOwn(routeMap, page) ? routeMap[page] : undefined;\n}\n\n/** Kept verbatim when it is only a query: a leading `?`, no `#`, and no control character. */\nfunction searchOf(search: unknown): string {\n  const text = stringOr(search, '');\n  if (text.length < 2 || !text.startsWith('?')) return '';\n  for (const char of text) {\n    const code = char.codePointAt(0) ?? 0;\n    if (char === '#' || code < 0x20 || code === 0x7f) return '';\n  }\n  return text;\n}\n\nfunction hashOf(hash: unknown): string {\n  const text = stringOr(hash, '');\n  return text.startsWith('#') && text.length > 1 ? text : '';\n}\n"],"mappings":"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"}

package/dist/sdk/navigation/current-page.js

@@ -0,0 +1,30 @@
+//#region src/sdk/navigation/current-page.ts
+/**
+* The current page with `query` as its whole query: a page reference inside a Route Marker, and the
+* Logical Path plus the query outside one, where a layout has no page.
+*/
+function currentPageWith(route, query) {
+	const text = query.toString();
+	if (route.page === null) return text.length === 0 ? route.path : `${route.path}?${text}`;
+	const target = {
+		page: route.page.name,
+		params: route.params
+	};
+	return text.length === 0 ? target : {
+		...target,
+		query: queryRecord(query)
+	};
+}
+/** The query as a record, keeping every value of a repeated key in order. */
+function queryRecord(query) {
+	const record = {};
+	for (const key of new Set(query.keys())) {
+		const values = query.getAll(key);
+		record[key] = values.length === 1 ? values[0] ?? "" : values;
+	}
+	return record;
+}
+//#endregion
+export { currentPageWith };
+
+//# sourceMappingURL=current-page.js.map

package/dist/sdk/navigation/current-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-page.js","names":[],"sources":["../../../src/sdk/navigation/current-page.ts"],"sourcesContent":["import type { PageRef } from './types.js';\nimport type { StorefrontRoute } from './use-storefront-route.js';\n\nexport type CurrentRoute = Pick<StorefrontRoute, 'page' | 'params' | 'path'>;\n\n/**\n * The current page with `query` as its whole query: a page reference inside a Route Marker, and the\n * Logical Path plus the query outside one, where a layout has no page.\n */\nexport function currentPageWith(route: CurrentRoute, query: URLSearchParams): PageRef | string {\n  const text = query.toString();\n  if (route.page === null) return text.length === 0 ? route.path : `${route.path}?${text}`;\n  const target: PageRef = { page: route.page.name, params: route.params };\n  return text.length === 0 ? target : { ...target, query: queryRecord(query) };\n}\n\n/** The query as a record, keeping every value of a repeated key in order. */\nfunction queryRecord(query: URLSearchParams): Record<string, string | string[]> {\n  const record: Record<string, string | string[]> = {};\n  for (const key of new Set(query.keys())) {\n    const values = query.getAll(key);\n    record[key] = values.length === 1 ? (values[0] ?? '') : values;\n  }\n  return record;\n}\n"],"mappings":";;;;;AASA,SAAgB,gBAAgB,OAAqB,OAA0C;CAC7F,MAAM,OAAO,MAAM,SAAS;CAC5B,IAAI,MAAM,SAAS,MAAM,OAAO,KAAK,WAAW,IAAI,MAAM,OAAO,GAAG,MAAM,KAAK,GAAG;CAClF,MAAM,SAAkB;EAAE,MAAM,MAAM,KAAK;EAAM,QAAQ,MAAM;CAAO;CACtE,OAAO,KAAK,WAAW,IAAI,SAAS;EAAE,GAAG;EAAQ,OAAO,YAAY,KAAK;CAAE;AAC7E;;AAGA,SAAS,YAAY,OAA2D;CAC9E,MAAM,SAA4C,CAAC;CACnD,KAAK,MAAM,OAAO,IAAI,IAAI,MAAM,KAAK,CAAC,GAAG;EACvC,MAAM,SAAS,MAAM,OAAO,GAAG;EAC/B,OAAO,OAAO,OAAO,WAAW,IAAK,OAAO,MAAM,KAAM;CAC1D;CACA,OAAO;AACT"}

package/dist/sdk/navigation/decode-route-params.d.ts

@@ -0,0 +1,11 @@
+//#region src/sdk/navigation/decode-route-params.d.ts
+type RouteParamValue = string | string[] | undefined;
+/**
+ * The route params a generated page receives, decoded: Next hands over a dynamic segment
+ * percent-encoded, so an id ending in `=` arrives as `%3D`. A value with a malformed sequence is kept
+ * as received, so a request can never turn into an exception. A list (catch-all) is decoded segment
+ * by segment, and the keys are unchanged.
+ */
+export declare function decodeRouteParams<T extends Record<string, RouteParamValue>>(params: T): T;
+//#endregion
+//# sourceMappingURL=decode-route-params.d.ts.map

package/dist/sdk/navigation/decode-route-params.js

@@ -0,0 +1,32 @@
+//#region src/sdk/navigation/decode-route-params.ts
+function decodeSegment(segment) {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+}
+function decodeValue(value) {
+	if (value === void 0) return void 0;
+	return Array.isArray(value) ? value.map(decodeSegment) : decodeSegment(value);
+}
+/**
+* The route params a generated page receives, decoded: Next hands over a dynamic segment
+* percent-encoded, so an id ending in `=` arrives as `%3D`. A value with a malformed sequence is kept
+* as received, so a request can never turn into an exception. A list (catch-all) is decoded segment
+* by segment, and the keys are unchanged.
+*/
+function decodeRouteParams(params) {
+	const decoded = {};
+	for (const [key, value] of Object.entries(params)) Object.defineProperty(decoded, key, {
+		value: decodeValue(value),
+		enumerable: true,
+		writable: true,
+		configurable: true
+	});
+	return decoded;
+}
+//#endregion
+export { decodeRouteParams };
+
+//# sourceMappingURL=decode-route-params.js.map

package/dist/sdk/navigation/decode-route-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-route-params.js","names":[],"sources":["../../../src/sdk/navigation/decode-route-params.ts"],"sourcesContent":["type RouteParamValue = string | string[] | undefined;\n\nfunction decodeSegment(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n\nfunction decodeValue(value: RouteParamValue): RouteParamValue {\n  if (value === undefined) return undefined;\n  return Array.isArray(value) ? value.map(decodeSegment) : decodeSegment(value);\n}\n\n/**\n * The route params a generated page receives, decoded: Next hands over a dynamic segment\n * percent-encoded, so an id ending in `=` arrives as `%3D`. A value with a malformed sequence is kept\n * as received, so a request can never turn into an exception. A list (catch-all) is decoded segment\n * by segment, and the keys are unchanged.\n */\nexport function decodeRouteParams<T extends Record<string, RouteParamValue>>(params: T): T {\n  const decoded: Record<string, RouteParamValue> = {};\n  for (const [key, value] of Object.entries(params)) {\n    // defineProperty, not assignment: a param named `__proto__` must stay an own key.\n    Object.defineProperty(decoded, key, {\n      value: decodeValue(value),\n      enumerable: true,\n      writable: true,\n      configurable: true,\n    });\n  }\n  return decoded as T;\n}\n"],"mappings":";AAEA,SAAS,cAAc,SAAyB;CAC9C,IAAI;EACF,OAAO,mBAAmB,OAAO;CACnC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,YAAY,OAAyC;CAC5D,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,aAAa,IAAI,cAAc,KAAK;AAC9E;;;;;;;AAQA,SAAgB,kBAA6D,QAAc;CACzF,MAAM,UAA2C,CAAC;CAClD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAE9C,OAAO,eAAe,SAAS,KAAK;EAClC,OAAO,YAAY,KAAK;EACxB,YAAY;EACZ,UAAU;EACV,cAAc;CAChB,CAAC;CAEH,OAAO;AACT"}