@thorprovider/blocks 1.0.0 → 3.0.0

package/dist/blocks/e-commerce/checkout-forms/checkout.mjs

@@ -0,0 +1,327 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Lock } from "lucide-react";
+import { Button } from "../../../ui/button.mjs";
+import { Card, CardContent } from "../../../ui/card.mjs";
+import { cn } from "../../../lib/utils.mjs";
+import { CheckoutContactStep } from "./checkout-contact-step.mjs";
+import { CheckoutShippingStep } from "./checkout-shipping-step.mjs";
+import { CheckoutPaymentStep } from "./checkout-payment-step.mjs";
+import { CheckoutReviewStep } from "./checkout-review-step.mjs";
+import { CheckoutOrderSummaryPanel } from "./checkout-order-summary.mjs";
+import { CheckoutProgress } from "./checkout-progress.mjs";
+const DEFAULT_LABELS = {
+  title: "Checkout",
+  description: "",
+  orderSummaryTitle: "Order summary",
+  stepProgressLabel: "Checkout progress",
+  contactStepName: "Contact",
+  shippingStepName: "Shipping",
+  paymentStepName: "Payment",
+  reviewStepName: "Review",
+  contactHeading: "Contact information",
+  contactDescription: "We use these details to keep you informed about your order.",
+  shippingHeading: "Shipping address",
+  shippingDescription: "Tell us where the order should be delivered.",
+  paymentHeading: "Payment",
+  paymentDescription: "Choose how you want to pay for this order.",
+  reviewHeading: "Review your order",
+  reviewDescription: "Check the details below before placing the order.",
+  emailLabel: "Email",
+  firstNameLabel: "First name",
+  lastNameLabel: "Last name",
+  phoneLabel: "Phone (optional)",
+  addressLabel: "Street address",
+  cityLabel: "City",
+  stateLabel: "State / Province",
+  zipCodeLabel: "ZIP / Postal code",
+  countryLabel: "Country",
+  countryPlaceholder: "Select a country",
+  shippingMethodLegend: "Shipping method",
+  paymentMethodLegend: "Payment method",
+  noPaymentMethodsLabel: "No payment methods are available for this region.",
+  unavailableMethodLabel: "Unavailable",
+  requiresSetupLabel: "Requires additional setup",
+  saveInfoLabel: "Save this information for next time",
+  newsletterLabel: "Email me about news and offers",
+  promoCodeLabel: "Promotional code",
+  promoPlaceholder: "Enter the code",
+  promoApplyLabel: "Apply",
+  subtotalLabel: "Subtotal",
+  discountLabel: "Discount",
+  taxLabel: "Tax",
+  shippingLabel: "Shipping",
+  totalLabel: "Total",
+  eachLabel: "each",
+  totalsPendingLabel: "Updating totals\u2026",
+  totalsErrorLabel: "We could not update the order totals.",
+  totalsUnavailableLabel: "Totals are unavailable.",
+  amountUnavailableLabel: "\u2014",
+  retryLabel: "Retry",
+  reviewContactLabel: "Contact",
+  reviewShipToLabel: "Ship to",
+  reviewPaymentLabel: "Payment",
+  reviewShippingLabel: "Shipping method",
+  reviewEmptyLabel: "No details provided yet.",
+  backLabel: "Back",
+  continueLabel: "Continue",
+  completeOrderLabel: "Place order",
+  processingLabel: "Placing order\u2026",
+  submitErrorActionLabel: "Try again"
+};
+const BASE_STEPS = ["contact", "shipping", "payment"];
+const STEP_COPY = {
+  contact: {
+    name: "contactStepName",
+    heading: "contactHeading",
+    description: "contactDescription"
+  },
+  shipping: {
+    name: "shippingStepName",
+    heading: "shippingHeading",
+    description: "shippingDescription"
+  },
+  payment: {
+    name: "paymentStepName",
+    heading: "paymentHeading",
+    description: "paymentDescription"
+  },
+  review: {
+    name: "reviewStepName",
+    heading: "reviewHeading",
+    description: "reviewDescription"
+  }
+};
+function Checkout({
+  presentation,
+  showReviewStep = false,
+  values,
+  onChange,
+  orderSummary,
+  totalsState = "idle",
+  onRetryTotals,
+  countries,
+  shippingOptions,
+  selectedShippingOptionId,
+  onSelectShippingOption,
+  paymentMethods = [],
+  onApplyPromo,
+  promoPending = false,
+  trustNotes,
+  labels,
+  formatMoney,
+  fieldErrors,
+  fieldDescriptions,
+  validateStep,
+  onStepChange,
+  onSubmit,
+  submitting = false,
+  submitError,
+  onRetrySubmit
+}) {
+  const resolved = { ...DEFAULT_LABELS, ...labels };
+  const steps = showReviewStep ? [...BASE_STEPS, "review"] : BASE_STEPS;
+  const [stepIndex, setStepIndex] = useState(0);
+  const activeStep = steps[Math.min(stepIndex, steps.length - 1)];
+  const headingRef = useRef(null);
+  const hasMounted = useRef(false);
+  useEffect(() => {
+    if (presentation !== "stepper") return;
+    if (!hasMounted.current) {
+      hasMounted.current = true;
+      return;
+    }
+    headingRef.current?.focus();
+  }, [presentation, activeStep]);
+  const moveTo = (nextIndex) => {
+    const next = steps[nextIndex];
+    if (!next) return;
+    setStepIndex(nextIndex);
+    onStepChange?.(next);
+  };
+  const handleContinue = () => {
+    if (validateStep && !validateStep(activeStep)) return;
+    moveTo(stepIndex + 1);
+  };
+  const handleBack = () => {
+    if (stepIndex === 0) return;
+    moveTo(stepIndex - 1);
+  };
+  const handleSubmit = () => {
+    if (submitting) return;
+    if (validateStep && !steps.every((step) => validateStep(step))) return;
+    onSubmit?.(values);
+  };
+  const renderStep = (step) => {
+    switch (step) {
+      case "contact":
+        return /* @__PURE__ */ jsx(
+          CheckoutContactStep,
+          {
+            values,
+            onChange,
+            labels: resolved,
+            showSaveInfo: labels?.saveInfoLabel !== void 0,
+            showNewsletter: labels?.newsletterLabel !== void 0,
+            fieldErrors,
+            fieldDescriptions
+          }
+        );
+      case "shipping":
+        return /* @__PURE__ */ jsx(
+          CheckoutShippingStep,
+          {
+            values,
+            onChange,
+            labels: resolved,
+            countries,
+            shippingOptions,
+            selectedShippingOptionId,
+            onSelectShippingOption,
+            formatMoney,
+            fieldErrors,
+            fieldDescriptions
+          }
+        );
+      case "payment":
+        return /* @__PURE__ */ jsx(
+          CheckoutPaymentStep,
+          {
+            values,
+            onChange,
+            labels: resolved,
+            paymentMethods,
+            fieldErrors,
+            fieldDescriptions
+          }
+        );
+      case "review":
+        return /* @__PURE__ */ jsx(
+          CheckoutReviewStep,
+          {
+            values,
+            labels: resolved,
+            selectedShippingOptionId,
+            shippingOptions,
+            paymentMethods
+          }
+        );
+    }
+  };
+  const isLastStep = stepIndex === steps.length - 1;
+  const submitAction = /* @__PURE__ */ jsxs(Button, { type: "button", onClick: handleSubmit, disabled: submitting, children: [
+    /* @__PURE__ */ jsx(Lock, { className: "size-4" }),
+    submitting ? resolved.processingLabel : resolved.completeOrderLabel
+  ] });
+  const submitErrorNode = submitError ? /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "alert",
+      className: "mt-6 flex flex-wrap items-center justify-between gap-3 rounded-md border border-destructive/50 bg-destructive/10 px-4 py-3 text-sm text-destructive",
+      children: [
+        /* @__PURE__ */ jsx("span", { children: submitError }),
+        onRetrySubmit ? /* @__PURE__ */ jsx(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            size: "sm",
+            onClick: onRetrySubmit,
+            disabled: submitting,
+            children: resolved.submitErrorActionLabel
+          }
+        ) : null
+      ]
+    }
+  ) : null;
+  const summaryNode = orderSummary ? /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        "min-w-0 lg:col-span-1",
+        presentation === "single-page" && "lg:order-last"
+      ),
+      children: /* @__PURE__ */ jsx(
+        CheckoutOrderSummaryPanel,
+        {
+          summary: orderSummary,
+          labels: resolved,
+          totalsState,
+          onRetryTotals,
+          promoCode: values.promoCode,
+          onPromoCodeChange: (value) => onChange("promoCode", value),
+          onApplyPromo,
+          promoPending,
+          trustNotes,
+          formatMoney
+        }
+      )
+    }
+  ) : null;
+  return /* @__PURE__ */ jsxs("div", { className: "mx-auto max-w-6xl px-4 py-12 sm:px-6 lg:px-8", children: [
+    (resolved.title || resolved.description) && /* @__PURE__ */ jsxs("header", { className: "mb-8 text-center", children: [
+      resolved.title ? /* @__PURE__ */ jsx("h1", { className: "text-3xl font-bold tracking-tight sm:text-4xl", children: resolved.title }) : null,
+      resolved.description ? /* @__PURE__ */ jsx("p", { className: "mt-2 text-muted-foreground", children: resolved.description }) : null
+    ] }),
+    presentation === "stepper" ? /* @__PURE__ */ jsx(
+      CheckoutProgress,
+      {
+        steps: steps.map((step) => ({
+          id: step,
+          label: resolved[STEP_COPY[step].name]
+        })),
+        currentStep: activeStep,
+        ariaLabel: resolved.stepProgressLabel
+      }
+    ) : null,
+    /* @__PURE__ */ jsxs("div", { className: cn("mt-8 grid grid-cols-1 gap-6", orderSummary && "lg:grid-cols-3"), children: [
+      presentation === "single-page" ? summaryNode : null,
+      /* @__PURE__ */ jsx("div", { className: cn("min-w-0", orderSummary ? "lg:col-span-2" : "lg:col-span-3"), children: /* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsxs(CardContent, { className: "p-6", children: [
+        presentation === "stepper" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsxs("div", { className: "mb-6", children: [
+            /* @__PURE__ */ jsx("h2", { ref: headingRef, tabIndex: -1, className: "text-lg font-semibold outline-none", children: resolved[STEP_COPY[activeStep].heading] }),
+            /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: resolved[STEP_COPY[activeStep].description] })
+          ] }),
+          renderStep(activeStep)
+        ] }) : /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-8", children: steps.map((step) => /* @__PURE__ */ jsxs("section", { className: "flex flex-col gap-4", children: [
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("h2", { className: "text-lg font-semibold", children: resolved[STEP_COPY[step].heading] }),
+            /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: resolved[STEP_COPY[step].description] })
+          ] }),
+          renderStep(step)
+        ] }, step)) }),
+        submitErrorNode,
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: cn(
+              "mt-6 flex flex-wrap items-center gap-4",
+              presentation === "stepper" ? "justify-between" : "justify-end"
+            ),
+            children: presentation === "stepper" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                Button,
+                {
+                  type: "button",
+                  variant: "outline",
+                  onClick: handleBack,
+                  disabled: stepIndex === 0 || submitting,
+                  children: resolved.backLabel
+                }
+              ),
+              isLastStep ? submitAction : /* @__PURE__ */ jsx(Button, { type: "button", onClick: handleContinue, disabled: submitting, children: resolved.continueLabel })
+            ] }) : submitAction
+          }
+        )
+      ] }) }) }),
+      presentation === "stepper" ? summaryNode : null
+    ] })
+  ] });
+}
+var checkout_default = Checkout;
+export {
+  Checkout,
+  checkout_default as default
+};
+//# sourceMappingURL=checkout.mjs.map

package/dist/blocks/e-commerce/checkout-forms/checkout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/e-commerce/checkout-forms/checkout.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef, useState } from 'react'\nimport { Lock } from 'lucide-react'\nimport { Button } from '../../../ui/button'\nimport { Card, CardContent } from '../../../ui/card'\nimport { cn } from '../../../lib/utils'\nimport { CheckoutContactStep } from './checkout-contact-step'\nimport { CheckoutShippingStep } from './checkout-shipping-step'\nimport { CheckoutPaymentStep } from './checkout-payment-step'\nimport { CheckoutReviewStep } from './checkout-review-step'\nimport { CheckoutOrderSummaryPanel } from './checkout-order-summary'\nimport { CheckoutProgress } from './checkout-progress'\nimport type { Money, PaymentMethod } from '@thorprovider/types'\nimport type { CheckoutFieldErrors as GenericCheckoutFieldErrors } from './checkout-form-types'\n\n/**\n * The canonical checkout is a page-level unit. The host owns the commercial\n * state (values, selections, totals, submission); the block owns only the\n * ephemeral step index of the `stepper` presentation.\n */\nexport type CheckoutPresentation = 'single-page' | 'stepper'\n\nexport type CheckoutStepId = 'contact' | 'shipping' | 'payment' | 'review'\n\n/** Flat, controlled form values. No card data: payment entry belongs to the host provider surface. */\nexport interface CheckoutValues {\n  email: string\n  firstName: string\n  lastName: string\n  phone: string\n  address: string\n  city: string\n  state: string\n  zipCode: string\n  country: string\n  paymentMethod: string\n  saveInfo: boolean\n  newsletter: boolean\n  promoCode: string\n}\n\nexport type CheckoutValuesFieldErrors = GenericCheckoutFieldErrors<keyof CheckoutValues>\n\nexport type CheckoutFieldDescriptions = Partial<Record<keyof CheckoutValues, string>>\n\nexport interface CheckoutOrderLine {\n  /** Backend line identity — the stable React key. */\n  id: string | number\n  name: string\n  variant?: string\n  quantity: number\n  /** Backend-authoritative line total; rendered verbatim. */\n  lineTotal?: Money\n  /** Optional unit price shown as secondary text; never multiplied. */\n  unitPrice?: Money\n  /** Optional; an absent image is omitted rather than serialized as `\"\"`. */\n  image?: string\n}\n\nexport interface CheckoutTotals {\n  subtotal: Money\n  discount?: Money\n  tax?: Money\n  shipping?: Money\n  total: Money\n}\n\nexport interface CheckoutOrderSummary {\n  items: CheckoutOrderLine[]\n  /** Backend-authoritative totals; rendered verbatim. */\n  totals?: CheckoutTotals\n}\n\nexport type CheckoutTotalsState = 'idle' | 'pending' | 'error'\n\nexport interface CheckoutCountryOption {\n  value: string\n  label: string\n}\n\nexport interface CheckoutShippingOption {\n  /** Backend shipping method id — the controlled selection identity. */\n  id: string\n  name: string\n  price?: Money\n  description?: string\n  estimatedDays?: string\n}\n\nexport type CheckoutChangeHandler = (field: keyof CheckoutValues, value: string | boolean) => void\n\n/**\n * Every user-facing string is overridable. Neutral English defaults ship with\n * the block; the host supplies its own copy through this object.\n */\nexport interface CheckoutLabels {\n  title: string\n  description: string\n  orderSummaryTitle: string\n  stepProgressLabel: string\n  contactStepName: string\n  shippingStepName: string\n  paymentStepName: string\n  reviewStepName: string\n  contactHeading: string\n  contactDescription: string\n  shippingHeading: string\n  shippingDescription: string\n  paymentHeading: string\n  paymentDescription: string\n  reviewHeading: string\n  reviewDescription: string\n  emailLabel: string\n  firstNameLabel: string\n  lastNameLabel: string\n  phoneLabel: string\n  addressLabel: string\n  cityLabel: string\n  stateLabel: string\n  zipCodeLabel: string\n  countryLabel: string\n  countryPlaceholder: string\n  shippingMethodLegend: string\n  paymentMethodLegend: string\n  noPaymentMethodsLabel: string\n  unavailableMethodLabel: string\n  requiresSetupLabel: string\n  saveInfoLabel: string\n  newsletterLabel: string\n  promoCodeLabel: string\n  promoPlaceholder: string\n  promoApplyLabel: string\n  subtotalLabel: string\n  discountLabel: string\n  taxLabel: string\n  shippingLabel: string\n  totalLabel: string\n  eachLabel: string\n  totalsPendingLabel: string\n  totalsErrorLabel: string\n  totalsUnavailableLabel: string\n  amountUnavailableLabel: string\n  retryLabel: string\n  reviewContactLabel: string\n  reviewShipToLabel: string\n  reviewPaymentLabel: string\n  reviewShippingLabel: string\n  reviewEmptyLabel: string\n  backLabel: string\n  continueLabel: string\n  completeOrderLabel: string\n  processingLabel: string\n  submitErrorActionLabel: string\n}\n\nconst DEFAULT_LABELS: CheckoutLabels = {\n  title: 'Checkout',\n  description: '',\n  orderSummaryTitle: 'Order summary',\n  stepProgressLabel: 'Checkout progress',\n  contactStepName: 'Contact',\n  shippingStepName: 'Shipping',\n  paymentStepName: 'Payment',\n  reviewStepName: 'Review',\n  contactHeading: 'Contact information',\n  contactDescription: 'We use these details to keep you informed about your order.',\n  shippingHeading: 'Shipping address',\n  shippingDescription: 'Tell us where the order should be delivered.',\n  paymentHeading: 'Payment',\n  paymentDescription: 'Choose how you want to pay for this order.',\n  reviewHeading: 'Review your order',\n  reviewDescription: 'Check the details below before placing the order.',\n  emailLabel: 'Email',\n  firstNameLabel: 'First name',\n  lastNameLabel: 'Last name',\n  phoneLabel: 'Phone (optional)',\n  addressLabel: 'Street address',\n  cityLabel: 'City',\n  stateLabel: 'State / Province',\n  zipCodeLabel: 'ZIP / Postal code',\n  countryLabel: 'Country',\n  countryPlaceholder: 'Select a country',\n  shippingMethodLegend: 'Shipping method',\n  paymentMethodLegend: 'Payment method',\n  noPaymentMethodsLabel: 'No payment methods are available for this region.',\n  unavailableMethodLabel: 'Unavailable',\n  requiresSetupLabel: 'Requires additional setup',\n  saveInfoLabel: 'Save this information for next time',\n  newsletterLabel: 'Email me about news and offers',\n  promoCodeLabel: 'Promotional code',\n  promoPlaceholder: 'Enter the code',\n  promoApplyLabel: 'Apply',\n  subtotalLabel: 'Subtotal',\n  discountLabel: 'Discount',\n  taxLabel: 'Tax',\n  shippingLabel: 'Shipping',\n  totalLabel: 'Total',\n  eachLabel: 'each',\n  totalsPendingLabel: 'Updating totals…',\n  totalsErrorLabel: 'We could not update the order totals.',\n  totalsUnavailableLabel: 'Totals are unavailable.',\n  amountUnavailableLabel: '—',\n  retryLabel: 'Retry',\n  reviewContactLabel: 'Contact',\n  reviewShipToLabel: 'Ship to',\n  reviewPaymentLabel: 'Payment',\n  reviewShippingLabel: 'Shipping method',\n  reviewEmptyLabel: 'No details provided yet.',\n  backLabel: 'Back',\n  continueLabel: 'Continue',\n  completeOrderLabel: 'Place order',\n  processingLabel: 'Placing order…',\n  submitErrorActionLabel: 'Try again',\n}\n\nconst BASE_STEPS: CheckoutStepId[] = ['contact', 'shipping', 'payment']\n\nconst STEP_COPY: Record<\n  CheckoutStepId,\n  { name: keyof CheckoutLabels; heading: keyof CheckoutLabels; description: keyof CheckoutLabels }\n> = {\n  contact: {\n    name: 'contactStepName',\n    heading: 'contactHeading',\n    description: 'contactDescription',\n  },\n  shipping: {\n    name: 'shippingStepName',\n    heading: 'shippingHeading',\n    description: 'shippingDescription',\n  },\n  payment: {\n    name: 'paymentStepName',\n    heading: 'paymentHeading',\n    description: 'paymentDescription',\n  },\n  review: {\n    name: 'reviewStepName',\n    heading: 'reviewHeading',\n    description: 'reviewDescription',\n  },\n}\n\nexport interface CheckoutProps {\n  presentation: CheckoutPresentation\n  /** Appends a confirmation step (`stepper`) or section (`single-page`) before submission. */\n  showReviewStep?: boolean\n  values: CheckoutValues\n  onChange: CheckoutChangeHandler\n  orderSummary?: CheckoutOrderSummary\n  totalsState?: CheckoutTotalsState\n  onRetryTotals?: () => void\n  countries?: CheckoutCountryOption[]\n  shippingOptions?: CheckoutShippingOption[]\n  selectedShippingOptionId?: string\n  onSelectShippingOption?: (id: string) => void\n  paymentMethods?: PaymentMethod[]\n  onApplyPromo?: (code: string) => void\n  promoPending?: boolean\n  /** Optional trust copy; rendered only when supplied. */\n  trustNotes?: string[]\n  labels?: Partial<CheckoutLabels>\n  /** Override money formatting (locale, currency). Defaults to `Money.currencyCode`. */\n  formatMoney?: (money: Money) => string\n  fieldErrors?: CheckoutValuesFieldErrors\n  fieldDescriptions?: CheckoutFieldDescriptions\n  /** Consulted before advancing and for every applicable step before submitting. */\n  validateStep?: (step: CheckoutStepId) => boolean\n  /** Notification only — never an authoritative controlled value. */\n  onStepChange?: (step: CheckoutStepId) => void\n  onSubmit?: (values: CheckoutValues) => void\n  submitting?: boolean\n  submitError?: string\n  onRetrySubmit?: () => void\n}\n\nexport function Checkout({\n  presentation,\n  showReviewStep = false,\n  values,\n  onChange,\n  orderSummary,\n  totalsState = 'idle',\n  onRetryTotals,\n  countries,\n  shippingOptions,\n  selectedShippingOptionId,\n  onSelectShippingOption,\n  paymentMethods = [],\n  onApplyPromo,\n  promoPending = false,\n  trustNotes,\n  labels,\n  formatMoney,\n  fieldErrors,\n  fieldDescriptions,\n  validateStep,\n  onStepChange,\n  onSubmit,\n  submitting = false,\n  submitError,\n  onRetrySubmit,\n}: CheckoutProps) {\n  const resolved: CheckoutLabels = { ...DEFAULT_LABELS, ...labels }\n  const steps = showReviewStep ? [...BASE_STEPS, 'review' as const] : BASE_STEPS\n  const [stepIndex, setStepIndex] = useState(0)\n  const activeStep = steps[Math.min(stepIndex, steps.length - 1)]\n\n  const headingRef = useRef<HTMLHeadingElement>(null)\n  const hasMounted = useRef(false)\n\n  useEffect(() => {\n    if (presentation !== 'stepper') return\n    if (!hasMounted.current) {\n      hasMounted.current = true\n      return\n    }\n    headingRef.current?.focus()\n  }, [presentation, activeStep])\n\n  const moveTo = (nextIndex: number) => {\n    const next = steps[nextIndex]\n    if (!next) return\n    setStepIndex(nextIndex)\n    onStepChange?.(next)\n  }\n\n  const handleContinue = () => {\n    if (validateStep && !validateStep(activeStep)) return\n    moveTo(stepIndex + 1)\n  }\n\n  const handleBack = () => {\n    if (stepIndex === 0) return\n    moveTo(stepIndex - 1)\n  }\n\n  const handleSubmit = () => {\n    if (submitting) return\n    if (validateStep && !steps.every((step) => validateStep(step))) return\n    onSubmit?.(values)\n  }\n\n  const renderStep = (step: CheckoutStepId) => {\n    switch (step) {\n      case 'contact':\n        return (\n          <CheckoutContactStep\n            values={values}\n            onChange={onChange}\n            labels={resolved}\n            showSaveInfo={labels?.saveInfoLabel !== undefined}\n            showNewsletter={labels?.newsletterLabel !== undefined}\n            fieldErrors={fieldErrors}\n            fieldDescriptions={fieldDescriptions}\n          />\n        )\n      case 'shipping':\n        return (\n          <CheckoutShippingStep\n            values={values}\n            onChange={onChange}\n            labels={resolved}\n            countries={countries}\n            shippingOptions={shippingOptions}\n            selectedShippingOptionId={selectedShippingOptionId}\n            onSelectShippingOption={onSelectShippingOption}\n            formatMoney={formatMoney}\n            fieldErrors={fieldErrors}\n            fieldDescriptions={fieldDescriptions}\n          />\n        )\n      case 'payment':\n        return (\n          <CheckoutPaymentStep\n            values={values}\n            onChange={onChange}\n            labels={resolved}\n            paymentMethods={paymentMethods}\n            fieldErrors={fieldErrors}\n            fieldDescriptions={fieldDescriptions}\n          />\n        )\n      case 'review':\n        return (\n          <CheckoutReviewStep\n            values={values}\n            labels={resolved}\n            selectedShippingOptionId={selectedShippingOptionId}\n            shippingOptions={shippingOptions}\n            paymentMethods={paymentMethods}\n          />\n        )\n    }\n  }\n\n  const isLastStep = stepIndex === steps.length - 1\n\n  const submitAction = (\n    <Button type=\"button\" onClick={handleSubmit} disabled={submitting}>\n      <Lock className=\"size-4\" />\n      {submitting ? resolved.processingLabel : resolved.completeOrderLabel}\n    </Button>\n  )\n\n  const submitErrorNode = submitError ? (\n    <div\n      role=\"alert\"\n      className=\"mt-6 flex flex-wrap items-center justify-between gap-3 rounded-md border border-destructive/50 bg-destructive/10 px-4 py-3 text-sm text-destructive\"\n    >\n      <span>{submitError}</span>\n      {onRetrySubmit ? (\n        <Button\n          type=\"button\"\n          variant=\"outline\"\n          size=\"sm\"\n          onClick={onRetrySubmit}\n          disabled={submitting}\n        >\n          {resolved.submitErrorActionLabel}\n        </Button>\n      ) : null}\n    </div>\n  ) : null\n\n  const summaryNode = orderSummary ? (\n    <div\n      className={cn(\n        'min-w-0 lg:col-span-1',\n        presentation === 'single-page' && 'lg:order-last',\n      )}\n    >\n      <CheckoutOrderSummaryPanel\n        summary={orderSummary}\n        labels={resolved}\n        totalsState={totalsState}\n        onRetryTotals={onRetryTotals}\n        promoCode={values.promoCode}\n        onPromoCodeChange={(value) => onChange('promoCode', value)}\n        onApplyPromo={onApplyPromo}\n        promoPending={promoPending}\n        trustNotes={trustNotes}\n        formatMoney={formatMoney}\n      />\n    </div>\n  ) : null\n\n  return (\n    <div className=\"mx-auto max-w-6xl px-4 py-12 sm:px-6 lg:px-8\">\n      {(resolved.title || resolved.description) && (\n        <header className=\"mb-8 text-center\">\n          {resolved.title ? (\n            <h1 className=\"text-3xl font-bold tracking-tight sm:text-4xl\">{resolved.title}</h1>\n          ) : null}\n          {resolved.description ? (\n            <p className=\"mt-2 text-muted-foreground\">{resolved.description}</p>\n          ) : null}\n        </header>\n      )}\n\n      {presentation === 'stepper' ? (\n        <CheckoutProgress\n          steps={steps.map((step) => ({\n            id: step,\n            label: resolved[STEP_COPY[step].name],\n          }))}\n          currentStep={activeStep}\n          ariaLabel={resolved.stepProgressLabel}\n        />\n      ) : null}\n\n      <div className={cn('mt-8 grid grid-cols-1 gap-6', orderSummary && 'lg:grid-cols-3')}>\n        {presentation === 'single-page' ? summaryNode : null}\n\n        <div className={cn('min-w-0', orderSummary ? 'lg:col-span-2' : 'lg:col-span-3')}>\n          <Card>\n            <CardContent className=\"p-6\">\n              {presentation === 'stepper' ? (\n                <>\n                  <div className=\"mb-6\">\n                    <h2 ref={headingRef} tabIndex={-1} className=\"text-lg font-semibold outline-none\">\n                      {resolved[STEP_COPY[activeStep].heading]}\n                    </h2>\n                    <p className=\"text-sm text-muted-foreground\">\n                      {resolved[STEP_COPY[activeStep].description]}\n                    </p>\n                  </div>\n\n                  {renderStep(activeStep)}\n                </>\n              ) : (\n                <div className=\"flex flex-col gap-8\">\n                  {steps.map((step) => (\n                    <section key={step} className=\"flex flex-col gap-4\">\n                      <div>\n                        <h2 className=\"text-lg font-semibold\">\n                          {resolved[STEP_COPY[step].heading]}\n                        </h2>\n                        <p className=\"text-sm text-muted-foreground\">\n                          {resolved[STEP_COPY[step].description]}\n                        </p>\n                      </div>\n                      {renderStep(step)}\n                    </section>\n                  ))}\n                </div>\n              )}\n\n              {submitErrorNode}\n\n              <div\n                className={cn(\n                  'mt-6 flex flex-wrap items-center gap-4',\n                  presentation === 'stepper' ? 'justify-between' : 'justify-end',\n                )}\n              >\n                {presentation === 'stepper' ? (\n                  <>\n                    <Button\n                      type=\"button\"\n                      variant=\"outline\"\n                      onClick={handleBack}\n                      disabled={stepIndex === 0 || submitting}\n                    >\n                      {resolved.backLabel}\n                    </Button>\n                    {isLastStep ? (\n                      submitAction\n                    ) : (\n                      <Button type=\"button\" onClick={handleContinue} disabled={submitting}>\n                        {resolved.continueLabel}\n                      </Button>\n                    )}\n                  </>\n                ) : (\n                  submitAction\n                )}\n              </div>\n            </CardContent>\n          </Card>\n        </div>\n\n        {presentation === 'stepper' ? summaryNode : null}\n      </div>\n    </div>\n  )\n}\n\nexport default Checkout\n"],"mappings":"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","names":[]}

package/dist/blocks/e-commerce/navigation/back-to-top.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const backToTopPropsSchema: z.ZodObject<{
+    threshold: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label?: string | undefined;
+    className?: string | undefined;
+    threshold?: number | undefined;
+}, {
+    label?: string | undefined;
+    className?: string | undefined;
+    threshold?: number | undefined;
+}>;
+export type BackToTopProps = z.infer<typeof backToTopPropsSchema>;
+/**
+ * Resolve the scroll behavior for a back-to-top activation. Pure so it can be
+ * unit-tested without a DOM: reduced motion yields an instant jump.
+ */
+export declare function resolveScrollBehavior(prefersReducedMotion: boolean): 'auto' | 'smooth';
+/**
+ * Back-to-top control that appears once the page is scrolled past `threshold`
+ * and returns the viewport to the top. Honors `prefers-reduced-motion` (instant
+ * jump instead of a smooth scroll). Framework-agnostic; icon-only with an
+ * accessible label.
+ */
+export declare function BackToTop({ threshold, label, className, }: BackToTopProps): import("react").JSX.Element | null;
+//# sourceMappingURL=back-to-top.d.ts.map

package/dist/blocks/e-commerce/navigation/back-to-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"back-to-top.d.ts","sourceRoot":"","sources":["../../../../src/blocks/e-commerce/navigation/back-to-top.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAIjE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,oBAAoB,EAAE,OAAO,GAC5B,MAAM,GAAG,QAAQ,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,SAA6B,EAC7B,KAAqB,EACrB,SAAS,GACV,EAAE,cAAc,sCAgChB"}

package/dist/blocks/e-commerce/navigation/back-to-top.js

@@ -0,0 +1,78 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var back_to_top_exports = {};
+__export(back_to_top_exports, {
+  BackToTop: () => BackToTop,
+  backToTopPropsSchema: () => backToTopPropsSchema,
+  resolveScrollBehavior: () => resolveScrollBehavior
+});
+module.exports = __toCommonJS(back_to_top_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_lucide_react = require("lucide-react");
+var import_react = require("react");
+var import_zod = require("zod");
+var import_utils = require("../../../lib/utils.js");
+const backToTopPropsSchema = import_zod.z.object({
+  threshold: import_zod.z.number().optional(),
+  label: import_zod.z.string().optional(),
+  className: import_zod.z.string().optional()
+});
+const DEFAULT_THRESHOLD = 400;
+function resolveScrollBehavior(prefersReducedMotion) {
+  return prefersReducedMotion ? "auto" : "smooth";
+}
+function BackToTop({
+  threshold = DEFAULT_THRESHOLD,
+  label = "Back to top",
+  className
+}) {
+  const [visible, setVisible] = (0, import_react.useState)(false);
+  (0, import_react.useEffect)(() => {
+    const onScroll = () => setVisible(window.scrollY > threshold);
+    onScroll();
+    window.addEventListener("scroll", onScroll, { passive: true });
+    return () => window.removeEventListener("scroll", onScroll);
+  }, [threshold]);
+  if (!visible) return null;
+  const handleClick = () => {
+    const reduce = typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    window.scrollTo({ top: 0, behavior: resolveScrollBehavior(reduce) });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      "aria-label": label,
+      className: (0, import_utils.cn)(
+        "fixed bottom-4 right-4 z-40 inline-flex size-11 items-center justify-center rounded-full border bg-card text-foreground shadow-lg transition-colors hover:bg-secondary",
+        className
+      ),
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_lucide_react.ArrowUp, { className: "size-5", "aria-hidden": "true" })
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BackToTop,
+  backToTopPropsSchema,
+  resolveScrollBehavior
+});
+//# sourceMappingURL=back-to-top.js.map

package/dist/blocks/e-commerce/navigation/back-to-top.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/e-commerce/navigation/back-to-top.tsx"],"sourcesContent":["'use client'\n\nimport { ArrowUp } from 'lucide-react'\nimport { useEffect, useState } from 'react'\nimport { z } from 'zod'\n\nimport { cn } from '../../../lib/utils'\n\nexport const backToTopPropsSchema = z.object({\n  threshold: z.number().optional(),\n  label: z.string().optional(),\n  className: z.string().optional(),\n})\n\nexport type BackToTopProps = z.infer<typeof backToTopPropsSchema>\n\nconst DEFAULT_THRESHOLD = 400\n\n/**\n * Resolve the scroll behavior for a back-to-top activation. Pure so it can be\n * unit-tested without a DOM: reduced motion yields an instant jump.\n */\nexport function resolveScrollBehavior(\n  prefersReducedMotion: boolean,\n): 'auto' | 'smooth' {\n  return prefersReducedMotion ? 'auto' : 'smooth'\n}\n\n/**\n * Back-to-top control that appears once the page is scrolled past `threshold`\n * and returns the viewport to the top. Honors `prefers-reduced-motion` (instant\n * jump instead of a smooth scroll). Framework-agnostic; icon-only with an\n * accessible label.\n */\nexport function BackToTop({\n  threshold = DEFAULT_THRESHOLD,\n  label = 'Back to top',\n  className,\n}: BackToTopProps) {\n  const [visible, setVisible] = useState(false)\n\n  useEffect(() => {\n    const onScroll = () => setVisible(window.scrollY > threshold)\n    onScroll()\n    window.addEventListener('scroll', onScroll, { passive: true })\n    return () => window.removeEventListener('scroll', onScroll)\n  }, [threshold])\n\n  if (!visible) return null\n\n  const handleClick = () => {\n    const reduce =\n      typeof window !== 'undefined' &&\n      window.matchMedia('(prefers-reduced-motion: reduce)').matches\n    window.scrollTo({ top: 0, behavior: resolveScrollBehavior(reduce) })\n  }\n\n  return (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      aria-label={label}\n      className={cn(\n        'fixed bottom-4 right-4 z-40 inline-flex size-11 items-center justify-center rounded-full border bg-card text-foreground shadow-lg transition-colors hover:bg-secondary',\n        className,\n      )}\n    >\n      <ArrowUp className=\"size-5\" aria-hidden=\"true\" />\n    </button>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmEM;AAjEN,0BAAwB;AACxB,mBAAoC;AACpC,iBAAkB;AAElB,mBAAmB;AAEZ,MAAM,uBAAuB,aAAE,OAAO;AAAA,EAC3C,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,OAAO,aAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,WAAW,aAAE,OAAO,EAAE,SAAS;AACjC,CAAC;AAID,MAAM,oBAAoB;AAMnB,SAAS,sBACd,sBACmB;AACnB,SAAO,uBAAuB,SAAS;AACzC;AAQO,SAAS,UAAU;AAAA,EACxB,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR;AACF,GAAmB;AACjB,QAAM,CAAC,SAAS,UAAU,QAAI,uBAAS,KAAK;AAE5C,8BAAU,MAAM;AACd,UAAM,WAAW,MAAM,WAAW,OAAO,UAAU,SAAS;AAC5D,aAAS;AACT,WAAO,iBAAiB,UAAU,UAAU,EAAE,SAAS,KAAK,CAAC;AAC7D,WAAO,MAAM,OAAO,oBAAoB,UAAU,QAAQ;AAAA,EAC5D,GAAG,CAAC,SAAS,CAAC;AAEd,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,cAAc,MAAM;AACxB,UAAM,SACJ,OAAO,WAAW,eAClB,OAAO,WAAW,kCAAkC,EAAE;AACxD,WAAO,SAAS,EAAE,KAAK,GAAG,UAAU,sBAAsB,MAAM,EAAE,CAAC;AAAA,EACrE;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,cAAY;AAAA,MACZ,eAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MAEA,sDAAC,+BAAQ,WAAU,UAAS,eAAY,QAAO;AAAA;AAAA,EACjD;AAEJ;","names":[]}

package/dist/blocks/e-commerce/navigation/back-to-top.mjs

@@ -0,0 +1,52 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { ArrowUp } from "lucide-react";
+import { useEffect, useState } from "react";
+import { z } from "zod";
+import { cn } from "../../../lib/utils.mjs";
+const backToTopPropsSchema = z.object({
+  threshold: z.number().optional(),
+  label: z.string().optional(),
+  className: z.string().optional()
+});
+const DEFAULT_THRESHOLD = 400;
+function resolveScrollBehavior(prefersReducedMotion) {
+  return prefersReducedMotion ? "auto" : "smooth";
+}
+function BackToTop({
+  threshold = DEFAULT_THRESHOLD,
+  label = "Back to top",
+  className
+}) {
+  const [visible, setVisible] = useState(false);
+  useEffect(() => {
+    const onScroll = () => setVisible(window.scrollY > threshold);
+    onScroll();
+    window.addEventListener("scroll", onScroll, { passive: true });
+    return () => window.removeEventListener("scroll", onScroll);
+  }, [threshold]);
+  if (!visible) return null;
+  const handleClick = () => {
+    const reduce = typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    window.scrollTo({ top: 0, behavior: resolveScrollBehavior(reduce) });
+  };
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      "aria-label": label,
+      className: cn(
+        "fixed bottom-4 right-4 z-40 inline-flex size-11 items-center justify-center rounded-full border bg-card text-foreground shadow-lg transition-colors hover:bg-secondary",
+        className
+      ),
+      children: /* @__PURE__ */ jsx(ArrowUp, { className: "size-5", "aria-hidden": "true" })
+    }
+  );
+}
+export {
+  BackToTop,
+  backToTopPropsSchema,
+  resolveScrollBehavior
+};
+//# sourceMappingURL=back-to-top.mjs.map

package/dist/blocks/e-commerce/navigation/back-to-top.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/e-commerce/navigation/back-to-top.tsx"],"sourcesContent":["'use client'\n\nimport { ArrowUp } from 'lucide-react'\nimport { useEffect, useState } from 'react'\nimport { z } from 'zod'\n\nimport { cn } from '../../../lib/utils'\n\nexport const backToTopPropsSchema = z.object({\n  threshold: z.number().optional(),\n  label: z.string().optional(),\n  className: z.string().optional(),\n})\n\nexport type BackToTopProps = z.infer<typeof backToTopPropsSchema>\n\nconst DEFAULT_THRESHOLD = 400\n\n/**\n * Resolve the scroll behavior for a back-to-top activation. Pure so it can be\n * unit-tested without a DOM: reduced motion yields an instant jump.\n */\nexport function resolveScrollBehavior(\n  prefersReducedMotion: boolean,\n): 'auto' | 'smooth' {\n  return prefersReducedMotion ? 'auto' : 'smooth'\n}\n\n/**\n * Back-to-top control that appears once the page is scrolled past `threshold`\n * and returns the viewport to the top. Honors `prefers-reduced-motion` (instant\n * jump instead of a smooth scroll). Framework-agnostic; icon-only with an\n * accessible label.\n */\nexport function BackToTop({\n  threshold = DEFAULT_THRESHOLD,\n  label = 'Back to top',\n  className,\n}: BackToTopProps) {\n  const [visible, setVisible] = useState(false)\n\n  useEffect(() => {\n    const onScroll = () => setVisible(window.scrollY > threshold)\n    onScroll()\n    window.addEventListener('scroll', onScroll, { passive: true })\n    return () => window.removeEventListener('scroll', onScroll)\n  }, [threshold])\n\n  if (!visible) return null\n\n  const handleClick = () => {\n    const reduce =\n      typeof window !== 'undefined' &&\n      window.matchMedia('(prefers-reduced-motion: reduce)').matches\n    window.scrollTo({ top: 0, behavior: resolveScrollBehavior(reduce) })\n  }\n\n  return (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      aria-label={label}\n      className={cn(\n        'fixed bottom-4 right-4 z-40 inline-flex size-11 items-center justify-center rounded-full border bg-card text-foreground shadow-lg transition-colors hover:bg-secondary',\n        className,\n      )}\n    >\n      <ArrowUp className=\"size-5\" aria-hidden=\"true\" />\n    </button>\n  )\n}\n"],"mappings":";AAmEM;AAjEN,SAAS,eAAe;AACxB,SAAS,WAAW,gBAAgB;AACpC,SAAS,SAAS;AAElB,SAAS,UAAU;AAEZ,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,WAAW,EAAE,OAAO,EAAE,SAAS;AACjC,CAAC;AAID,MAAM,oBAAoB;AAMnB,SAAS,sBACd,sBACmB;AACnB,SAAO,uBAAuB,SAAS;AACzC;AAQO,SAAS,UAAU;AAAA,EACxB,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR;AACF,GAAmB;AACjB,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,YAAU,MAAM;AACd,UAAM,WAAW,MAAM,WAAW,OAAO,UAAU,SAAS;AAC5D,aAAS;AACT,WAAO,iBAAiB,UAAU,UAAU,EAAE,SAAS,KAAK,CAAC;AAC7D,WAAO,MAAM,OAAO,oBAAoB,UAAU,QAAQ;AAAA,EAC5D,GAAG,CAAC,SAAS,CAAC;AAEd,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,cAAc,MAAM;AACxB,UAAM,SACJ,OAAO,WAAW,eAClB,OAAO,WAAW,kCAAkC,EAAE;AACxD,WAAO,SAAS,EAAE,KAAK,GAAG,UAAU,sBAAsB,MAAM,EAAE,CAAC;AAAA,EACrE;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,cAAY;AAAA,MACZ,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MAEA,8BAAC,WAAQ,WAAU,UAAS,eAAY,QAAO;AAAA;AAAA,EACjD;AAEJ;","names":[]}

package/dist/blocks/e-commerce/navigation/breadcrumb.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+export declare const breadcrumbItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href?: string | undefined;
+}, {
+    label: string;
+    href?: string | undefined;
+}>;
+export type BreadcrumbItemData = z.infer<typeof breadcrumbItemSchema>;
+export declare const breadcrumbPropsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href?: string | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+    }>, "many">;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+    backLabel: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        label: string;
+        href?: string | undefined;
+    }[];
+    className?: string | undefined;
+    maxItems?: number | undefined;
+    ariaLabel?: string | undefined;
+    backLabel?: string | undefined;
+}, {
+    items: {
+        label: string;
+        href?: string | undefined;
+    }[];
+    className?: string | undefined;
+    maxItems?: number | undefined;
+    ariaLabel?: string | undefined;
+    backLabel?: string | undefined;
+}>;
+export type BreadcrumbProps = z.infer<typeof breadcrumbPropsSchema>;
+/**
+ * Breadcrumb trail for a real navigation path (Home → … → current).
+ *
+ * Framework-agnostic and prop-driven: plain anchors (no router) and the shared
+ * shadcn breadcrumb primitives. The last item is the current page and is never
+ * a link (`aria-current="page"`); earlier items link only when an `href` is
+ * given. Long labels truncate, and trails longer than `maxItems` collapse the
+ * intermediate levels behind an ellipsis. On mobile the full list is replaced
+ * by a single back link to the parent, so a wide trail never overflows.
+ *
+ * Renders nothing when there are no labelled items.
+ */
+export declare function Breadcrumb({ items, maxItems, ariaLabel, backLabel, className, }: BreadcrumbProps): import("react").JSX.Element | null;
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/blocks/e-commerce/navigation/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../../src/blocks/e-commerce/navigation/breadcrumb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAavB,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAErE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAoBnE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAA4B,EAC5B,SAAwB,EACxB,SAAS,EACT,SAAS,GACV,EAAE,eAAe,sCA6DjB"}