@thorprovider/blocks 2.0.0 → 3.0.0

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

@@ -0,0 +1,175 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Field, FieldContent, FieldGroup, FieldLabel, FieldLegend, FieldSet } from "../../../ui/field.mjs";
+import { Input } from "../../../ui/input.mjs";
+import { RadioGroup, RadioGroupItem } from "../../../ui/radio-group.mjs";
+import { formatMoney, isAvailableMoney } from "../../../lib/money.mjs";
+import { CheckoutFieldFeedback, checkoutFieldAria } from "./checkout-field-feedback.mjs";
+import { CheckoutCountryField } from "./checkout-country-field.mjs";
+function CheckoutShippingStep({
+  values,
+  onChange,
+  labels,
+  countries,
+  shippingOptions,
+  selectedShippingOptionId,
+  onSelectShippingOption,
+  formatMoney: formatMoneyProp,
+  fieldErrors,
+  fieldDescriptions
+}) {
+  return /* @__PURE__ */ jsxs(FieldGroup, { className: "grid grid-cols-1 gap-4", children: [
+    /* @__PURE__ */ jsxs(Field, { "data-invalid": !!fieldErrors?.address?.length, children: [
+      /* @__PURE__ */ jsx(FieldLabel, { htmlFor: "checkout-address", children: labels.addressLabel }),
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          id: "checkout-address",
+          autoComplete: "street-address",
+          value: values.address,
+          onChange: (e) => onChange("address", e.target.value),
+          ...checkoutFieldAria("checkout-address", fieldErrors?.address)
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        CheckoutFieldFeedback,
+        {
+          id: "checkout-address",
+          errors: fieldErrors?.address,
+          description: fieldDescriptions?.address
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-1 gap-4 md:grid-cols-2", children: [
+      /* @__PURE__ */ jsxs(Field, { "data-invalid": !!fieldErrors?.city?.length, children: [
+        /* @__PURE__ */ jsx(FieldLabel, { htmlFor: "checkout-city", children: labels.cityLabel }),
+        /* @__PURE__ */ jsx(
+          Input,
+          {
+            id: "checkout-city",
+            autoComplete: "address-level2",
+            value: values.city,
+            onChange: (e) => onChange("city", e.target.value),
+            ...checkoutFieldAria("checkout-city", fieldErrors?.city)
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          CheckoutFieldFeedback,
+          {
+            id: "checkout-city",
+            errors: fieldErrors?.city,
+            description: fieldDescriptions?.city
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxs(Field, { "data-invalid": !!fieldErrors?.state?.length, children: [
+        /* @__PURE__ */ jsx(FieldLabel, { htmlFor: "checkout-state", children: labels.stateLabel }),
+        /* @__PURE__ */ jsx(
+          Input,
+          {
+            id: "checkout-state",
+            autoComplete: "address-level1",
+            value: values.state,
+            onChange: (e) => onChange("state", e.target.value),
+            ...checkoutFieldAria("checkout-state", fieldErrors?.state)
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          CheckoutFieldFeedback,
+          {
+            id: "checkout-state",
+            errors: fieldErrors?.state,
+            description: fieldDescriptions?.state
+          }
+        )
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-1 gap-4 md:grid-cols-2", children: [
+      /* @__PURE__ */ jsxs(Field, { "data-invalid": !!fieldErrors?.zipCode?.length, children: [
+        /* @__PURE__ */ jsx(FieldLabel, { htmlFor: "checkout-zip", children: labels.zipCodeLabel }),
+        /* @__PURE__ */ jsx(
+          Input,
+          {
+            id: "checkout-zip",
+            autoComplete: "postal-code",
+            value: values.zipCode,
+            onChange: (e) => onChange("zipCode", e.target.value),
+            ...checkoutFieldAria("checkout-zip", fieldErrors?.zipCode)
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          CheckoutFieldFeedback,
+          {
+            id: "checkout-zip",
+            errors: fieldErrors?.zipCode,
+            description: fieldDescriptions?.zipCode
+          }
+        )
+      ] }),
+      countries && countries.length > 0 ? /* @__PURE__ */ jsx(
+        CheckoutCountryField,
+        {
+          labels,
+          countries,
+          value: values.country,
+          onValueChange: (value) => onChange("country", value),
+          errors: fieldErrors?.country,
+          description: fieldDescriptions?.country
+        }
+      ) : /* @__PURE__ */ jsxs(Field, { "data-invalid": !!fieldErrors?.country?.length, children: [
+        /* @__PURE__ */ jsx(FieldLabel, { htmlFor: "checkout-country-input", children: labels.countryLabel }),
+        /* @__PURE__ */ jsx(
+          Input,
+          {
+            id: "checkout-country-input",
+            autoComplete: "country-name",
+            value: values.country,
+            onChange: (e) => onChange("country", e.target.value),
+            ...checkoutFieldAria("checkout-country-input", fieldErrors?.country)
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          CheckoutFieldFeedback,
+          {
+            id: "checkout-country-input",
+            errors: fieldErrors?.country,
+            description: fieldDescriptions?.country
+          }
+        )
+      ] })
+    ] }),
+    shippingOptions && shippingOptions.length > 0 ? /* @__PURE__ */ jsxs(FieldSet, { children: [
+      /* @__PURE__ */ jsx(FieldLegend, { children: labels.shippingMethodLegend }),
+      /* @__PURE__ */ jsx(
+        RadioGroup,
+        {
+          value: selectedShippingOptionId ?? "",
+          onValueChange: (value) => value && onSelectShippingOption?.(String(value)),
+          className: "grid grid-cols-1 gap-3",
+          children: shippingOptions.map((option) => /* @__PURE__ */ jsxs(
+            Field,
+            {
+              orientation: "horizontal",
+              className: "flex-wrap items-start justify-between gap-3 rounded-lg border p-4",
+              children: [
+                /* @__PURE__ */ jsx(FieldContent, { className: "min-w-0", children: /* @__PURE__ */ jsxs(FieldLabel, { htmlFor: `shipping-${option.id}`, className: "flex flex-col gap-0.5", children: [
+                  /* @__PURE__ */ jsx("span", { children: option.name }),
+                  option.description ? /* @__PURE__ */ jsx("span", { className: "text-muted-foreground text-xs font-normal", children: option.description }) : null
+                ] }) }),
+                /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+                  isAvailableMoney(option.price) ? /* @__PURE__ */ jsx("span", { className: "text-sm tabular-nums", children: formatMoney(option.price, formatMoneyProp) }) : null,
+                  /* @__PURE__ */ jsx(RadioGroupItem, { value: option.id, id: `shipping-${option.id}` })
+                ] })
+              ]
+            },
+            option.id
+          ))
+        }
+      )
+    ] }) : null
+  ] });
+}
+export {
+  CheckoutShippingStep
+};
+//# sourceMappingURL=checkout-shipping-step.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/e-commerce/checkout-forms/checkout-shipping-step.tsx"],"sourcesContent":["'use client'\n\nimport { Field, FieldContent, FieldGroup, FieldLabel, FieldLegend, FieldSet } from '../../../ui/field'\nimport { Input } from '../../../ui/input'\nimport { RadioGroup, RadioGroupItem } from '../../../ui/radio-group'\nimport { formatMoney, isAvailableMoney } from '../../../lib/money'\nimport type { Money } from '@thorprovider/types'\nimport { CheckoutFieldFeedback, checkoutFieldAria } from './checkout-field-feedback'\nimport { CheckoutCountryField } from './checkout-country-field'\nimport type {\n  CheckoutChangeHandler,\n  CheckoutCountryOption,\n  CheckoutFieldDescriptions,\n  CheckoutValuesFieldErrors,\n  CheckoutLabels,\n  CheckoutShippingOption,\n  CheckoutValues,\n} from './checkout'\n\nexport interface CheckoutShippingStepProps {\n  values: CheckoutValues\n  onChange: CheckoutChangeHandler\n  labels: CheckoutLabels\n  countries?: CheckoutCountryOption[]\n  shippingOptions?: CheckoutShippingOption[]\n  selectedShippingOptionId?: string\n  onSelectShippingOption?: (id: string) => void\n  /** Override money formatting (locale, currency). Defaults to `Money.currencyCode`. */\n  formatMoney?: (money: Money) => string\n  fieldErrors?: CheckoutValuesFieldErrors\n  fieldDescriptions?: CheckoutFieldDescriptions\n}\n\nexport function CheckoutShippingStep({\n  values,\n  onChange,\n  labels,\n  countries,\n  shippingOptions,\n  selectedShippingOptionId,\n  onSelectShippingOption,\n  formatMoney: formatMoneyProp,\n  fieldErrors,\n  fieldDescriptions,\n}: CheckoutShippingStepProps) {\n  return (\n    <FieldGroup className=\"grid grid-cols-1 gap-4\">\n      <Field data-invalid={!!fieldErrors?.address?.length}>\n        <FieldLabel htmlFor=\"checkout-address\">{labels.addressLabel}</FieldLabel>\n        <Input\n          id=\"checkout-address\"\n          autoComplete=\"street-address\"\n          value={values.address}\n          onChange={(e) => onChange('address', e.target.value)}\n          {...checkoutFieldAria('checkout-address', fieldErrors?.address)}\n        />\n        <CheckoutFieldFeedback\n          id=\"checkout-address\"\n          errors={fieldErrors?.address}\n          description={fieldDescriptions?.address}\n        />\n      </Field>\n\n      <div className=\"grid grid-cols-1 gap-4 md:grid-cols-2\">\n        <Field data-invalid={!!fieldErrors?.city?.length}>\n          <FieldLabel htmlFor=\"checkout-city\">{labels.cityLabel}</FieldLabel>\n          <Input\n            id=\"checkout-city\"\n            autoComplete=\"address-level2\"\n            value={values.city}\n            onChange={(e) => onChange('city', e.target.value)}\n            {...checkoutFieldAria('checkout-city', fieldErrors?.city)}\n          />\n          <CheckoutFieldFeedback\n            id=\"checkout-city\"\n            errors={fieldErrors?.city}\n            description={fieldDescriptions?.city}\n          />\n        </Field>\n        <Field data-invalid={!!fieldErrors?.state?.length}>\n          <FieldLabel htmlFor=\"checkout-state\">{labels.stateLabel}</FieldLabel>\n          <Input\n            id=\"checkout-state\"\n            autoComplete=\"address-level1\"\n            value={values.state}\n            onChange={(e) => onChange('state', e.target.value)}\n            {...checkoutFieldAria('checkout-state', fieldErrors?.state)}\n          />\n          <CheckoutFieldFeedback\n            id=\"checkout-state\"\n            errors={fieldErrors?.state}\n            description={fieldDescriptions?.state}\n          />\n        </Field>\n      </div>\n\n      <div className=\"grid grid-cols-1 gap-4 md:grid-cols-2\">\n        <Field data-invalid={!!fieldErrors?.zipCode?.length}>\n          <FieldLabel htmlFor=\"checkout-zip\">{labels.zipCodeLabel}</FieldLabel>\n          <Input\n            id=\"checkout-zip\"\n            autoComplete=\"postal-code\"\n            value={values.zipCode}\n            onChange={(e) => onChange('zipCode', e.target.value)}\n            {...checkoutFieldAria('checkout-zip', fieldErrors?.zipCode)}\n          />\n          <CheckoutFieldFeedback\n            id=\"checkout-zip\"\n            errors={fieldErrors?.zipCode}\n            description={fieldDescriptions?.zipCode}\n          />\n        </Field>\n        {countries && countries.length > 0 ? (\n          <CheckoutCountryField\n            labels={labels}\n            countries={countries}\n            value={values.country}\n            onValueChange={(value) => onChange('country', value)}\n            errors={fieldErrors?.country}\n            description={fieldDescriptions?.country}\n          />\n        ) : (\n          <Field data-invalid={!!fieldErrors?.country?.length}>\n            <FieldLabel htmlFor=\"checkout-country-input\">{labels.countryLabel}</FieldLabel>\n            <Input\n              id=\"checkout-country-input\"\n              autoComplete=\"country-name\"\n              value={values.country}\n              onChange={(e) => onChange('country', e.target.value)}\n              {...checkoutFieldAria('checkout-country-input', fieldErrors?.country)}\n            />\n            <CheckoutFieldFeedback\n              id=\"checkout-country-input\"\n              errors={fieldErrors?.country}\n              description={fieldDescriptions?.country}\n            />\n          </Field>\n        )}\n      </div>\n\n      {shippingOptions && shippingOptions.length > 0 ? (\n        <FieldSet>\n          <FieldLegend>{labels.shippingMethodLegend}</FieldLegend>\n          <RadioGroup\n            value={selectedShippingOptionId ?? ''}\n            onValueChange={(value) => value && onSelectShippingOption?.(String(value))}\n            className=\"grid grid-cols-1 gap-3\"\n          >\n            {shippingOptions.map((option) => (\n              <Field\n                key={option.id}\n                orientation=\"horizontal\"\n                className=\"flex-wrap items-start justify-between gap-3 rounded-lg border p-4\"\n              >\n                <FieldContent className=\"min-w-0\">\n                  <FieldLabel htmlFor={`shipping-${option.id}`} className=\"flex flex-col gap-0.5\">\n                    <span>{option.name}</span>\n                    {option.description ? (\n                      <span className=\"text-muted-foreground text-xs font-normal\">\n                        {option.description}\n                      </span>\n                    ) : null}\n                  </FieldLabel>\n                </FieldContent>\n                <div className=\"flex items-center gap-3\">\n                  {isAvailableMoney(option.price) ? (\n                    <span className=\"text-sm tabular-nums\">\n                      {formatMoney(option.price, formatMoneyProp)}\n                    </span>\n                  ) : null}\n                  <RadioGroupItem value={option.id} id={`shipping-${option.id}`} />\n                </div>\n              </Field>\n            ))}\n          </RadioGroup>\n        </FieldSet>\n      ) : null}\n    </FieldGroup>\n  )\n}\n"],"mappings":"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","names":[]}

package/dist/blocks/e-commerce/checkout-forms/checkout.d.ts

@@ -0,0 +1,164 @@
+import type { Money, PaymentMethod } from '@thorprovider/types';
+import type { CheckoutFieldErrors as GenericCheckoutFieldErrors } from './checkout-form-types';
+/**
+ * The canonical checkout is a page-level unit. The host owns the commercial
+ * state (values, selections, totals, submission); the block owns only the
+ * ephemeral step index of the `stepper` presentation.
+ */
+export type CheckoutPresentation = 'single-page' | 'stepper';
+export type CheckoutStepId = 'contact' | 'shipping' | 'payment' | 'review';
+/** Flat, controlled form values. No card data: payment entry belongs to the host provider surface. */
+export interface CheckoutValues {
+    email: string;
+    firstName: string;
+    lastName: string;
+    phone: string;
+    address: string;
+    city: string;
+    state: string;
+    zipCode: string;
+    country: string;
+    paymentMethod: string;
+    saveInfo: boolean;
+    newsletter: boolean;
+    promoCode: string;
+}
+export type CheckoutValuesFieldErrors = GenericCheckoutFieldErrors<keyof CheckoutValues>;
+export type CheckoutFieldDescriptions = Partial<Record<keyof CheckoutValues, string>>;
+export interface CheckoutOrderLine {
+    /** Backend line identity — the stable React key. */
+    id: string | number;
+    name: string;
+    variant?: string;
+    quantity: number;
+    /** Backend-authoritative line total; rendered verbatim. */
+    lineTotal?: Money;
+    /** Optional unit price shown as secondary text; never multiplied. */
+    unitPrice?: Money;
+    /** Optional; an absent image is omitted rather than serialized as `""`. */
+    image?: string;
+}
+export interface CheckoutTotals {
+    subtotal: Money;
+    discount?: Money;
+    tax?: Money;
+    shipping?: Money;
+    total: Money;
+}
+export interface CheckoutOrderSummary {
+    items: CheckoutOrderLine[];
+    /** Backend-authoritative totals; rendered verbatim. */
+    totals?: CheckoutTotals;
+}
+export type CheckoutTotalsState = 'idle' | 'pending' | 'error';
+export interface CheckoutCountryOption {
+    value: string;
+    label: string;
+}
+export interface CheckoutShippingOption {
+    /** Backend shipping method id — the controlled selection identity. */
+    id: string;
+    name: string;
+    price?: Money;
+    description?: string;
+    estimatedDays?: string;
+}
+export type CheckoutChangeHandler = (field: keyof CheckoutValues, value: string | boolean) => void;
+/**
+ * Every user-facing string is overridable. Neutral English defaults ship with
+ * the block; the host supplies its own copy through this object.
+ */
+export interface CheckoutLabels {
+    title: string;
+    description: string;
+    orderSummaryTitle: string;
+    stepProgressLabel: string;
+    contactStepName: string;
+    shippingStepName: string;
+    paymentStepName: string;
+    reviewStepName: string;
+    contactHeading: string;
+    contactDescription: string;
+    shippingHeading: string;
+    shippingDescription: string;
+    paymentHeading: string;
+    paymentDescription: string;
+    reviewHeading: string;
+    reviewDescription: string;
+    emailLabel: string;
+    firstNameLabel: string;
+    lastNameLabel: string;
+    phoneLabel: string;
+    addressLabel: string;
+    cityLabel: string;
+    stateLabel: string;
+    zipCodeLabel: string;
+    countryLabel: string;
+    countryPlaceholder: string;
+    shippingMethodLegend: string;
+    paymentMethodLegend: string;
+    noPaymentMethodsLabel: string;
+    unavailableMethodLabel: string;
+    requiresSetupLabel: string;
+    saveInfoLabel: string;
+    newsletterLabel: string;
+    promoCodeLabel: string;
+    promoPlaceholder: string;
+    promoApplyLabel: string;
+    subtotalLabel: string;
+    discountLabel: string;
+    taxLabel: string;
+    shippingLabel: string;
+    totalLabel: string;
+    eachLabel: string;
+    totalsPendingLabel: string;
+    totalsErrorLabel: string;
+    totalsUnavailableLabel: string;
+    amountUnavailableLabel: string;
+    retryLabel: string;
+    reviewContactLabel: string;
+    reviewShipToLabel: string;
+    reviewPaymentLabel: string;
+    reviewShippingLabel: string;
+    reviewEmptyLabel: string;
+    backLabel: string;
+    continueLabel: string;
+    completeOrderLabel: string;
+    processingLabel: string;
+    submitErrorActionLabel: string;
+}
+export interface CheckoutProps {
+    presentation: CheckoutPresentation;
+    /** Appends a confirmation step (`stepper`) or section (`single-page`) before submission. */
+    showReviewStep?: boolean;
+    values: CheckoutValues;
+    onChange: CheckoutChangeHandler;
+    orderSummary?: CheckoutOrderSummary;
+    totalsState?: CheckoutTotalsState;
+    onRetryTotals?: () => void;
+    countries?: CheckoutCountryOption[];
+    shippingOptions?: CheckoutShippingOption[];
+    selectedShippingOptionId?: string;
+    onSelectShippingOption?: (id: string) => void;
+    paymentMethods?: PaymentMethod[];
+    onApplyPromo?: (code: string) => void;
+    promoPending?: boolean;
+    /** Optional trust copy; rendered only when supplied. */
+    trustNotes?: string[];
+    labels?: Partial<CheckoutLabels>;
+    /** Override money formatting (locale, currency). Defaults to `Money.currencyCode`. */
+    formatMoney?: (money: Money) => string;
+    fieldErrors?: CheckoutValuesFieldErrors;
+    fieldDescriptions?: CheckoutFieldDescriptions;
+    /** Consulted before advancing and for every applicable step before submitting. */
+    validateStep?: (step: CheckoutStepId) => boolean;
+    /** Notification only — never an authoritative controlled value. */
+    onStepChange?: (step: CheckoutStepId) => void;
+    onSubmit?: (values: CheckoutValues) => void;
+    submitting?: boolean;
+    submitError?: string;
+    onRetrySubmit?: () => void;
+}
+export declare function Checkout({ presentation, showReviewStep, values, onChange, orderSummary, totalsState, onRetryTotals, countries, shippingOptions, selectedShippingOptionId, onSelectShippingOption, paymentMethods, onApplyPromo, promoPending, trustNotes, labels, formatMoney, fieldErrors, fieldDescriptions, validateStep, onStepChange, onSubmit, submitting, submitError, onRetrySubmit, }: CheckoutProps): import("react").JSX.Element;
+export default Checkout;
+//# sourceMappingURL=checkout.d.ts.map

package/dist/blocks/e-commerce/checkout-forms/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../../../src/blocks/e-commerce/checkout-forms/checkout.tsx"],"names":[],"mappings":"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"}