@thorprovider/blocks 0.1.0 → 0.1.2

package/dist/contracts.js

@@ -1,4 +1,3 @@
-'use client';
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -23,15 +22,31 @@ var contracts_exports = {};
 __export(contracts_exports, {
   PRODUCT_IMAGE_FALLBACK: () => PRODUCT_IMAGE_FALLBACK,
   accountMenuItemSchema: () => accountMenuItemSchema,
+  brandAccentSchema: () => brandAccentSchema,
   buttonPropsSchema: () => buttonPropsSchema,
   cardProductSchema: () => cardProductSchema,
   cartItemSchema: () => cartItemSchema,
+  cartTotalsSchema: () => cartTotalsSchema,
+  ctaSchema: () => ctaSchema,
+  ctaSection1PropsSchema: () => ctaSection1PropsSchema,
+  faqBlock1PropsSchema: () => faqBlock1PropsSchema,
+  faqItemSchema: () => faqItemSchema,
+  formatMoney: () => formatMoney,
+  heroImageSchema: () => heroImageSchema,
+  isAvailableMoney: () => isAvailableMoney,
+  isCompleteFiniteDecimal: () => isCompleteFiniteDecimal,
+  logoAccentSchema: () => logoAccentSchema,
+  moneySchema: () => moneySchema,
   navCartItemSchema: () => navCartItemSchema,
   navbar4PropsSchema: () => navbar4PropsSchema,
   paymentMethodSchema: () => paymentMethodSchema,
   productCard1PropsSchema: () => productCard1PropsSchema,
+  productDetailProductSchema: () => productDetailProductSchema,
+  productDetailVariantSchema: () => productDetailVariantSchema,
+  productOverview1PropsSchema: () => productOverview1PropsSchema,
   promotionSchema: () => promotionSchema,
   recentlyViewedItemSchema: () => recentlyViewedItemSchema,
+  resolveAbsoluteQuantity: () => resolveAbsoluteQuantity,
   shoppingCart4PropsSchema: () => shoppingCart4PropsSchema,
   storeCategorySchema: () => storeCategorySchema,
   storeContainer1PropsSchema: () => storeContainer1PropsSchema,
@@ -40,9 +55,91 @@ __export(contracts_exports, {
 });
 module.exports = __toCommonJS(contracts_exports);
 var import_zod = require("zod");
+
+// src/lib/money.ts
+var COMPLETE_FINITE_DECIMAL = /^-?(?:\d+)(?:\.\d+)?$/;
+function isCompleteFiniteDecimal(value) {
+  if (typeof value !== "string") return false;
+  const trimmed = value.trim();
+  if (trimmed === "" || !COMPLETE_FINITE_DECIMAL.test(trimmed)) return false;
+  return Number.isFinite(Number(trimmed));
+}
+function isAvailableMoney(money) {
+  return !!money && typeof money.currencyCode === "string" && money.currencyCode.trim() !== "" && isCompleteFiniteDecimal(money.amount);
+}
+function formatMoney(money, formatter) {
+  if (!isAvailableMoney(money)) return null;
+  if (formatter) return formatter(money);
+  return new Intl.NumberFormat(void 0, {
+    style: "currency",
+    currency: money.currencyCode
+  }).format(Number(money.amount));
+}
+
+// src/lib/cart.ts
+function resolveAbsoluteQuantity(currentQuantity, delta) {
+  return Math.max(1, currentQuantity + delta);
+}
+
+// src/lib/contracts.ts
 var PRODUCT_IMAGE_FALLBACK = "data:image/svg+xml;charset=utf-8," + encodeURIComponent(
   `<svg xmlns='http://www.w3.org/2000/svg' width='600' height='600'><rect width='100%' height='100%' fill='#e2e8f0'/><g fill='none' stroke='#94a3b8' stroke-width='12' stroke-linecap='round'><path d='M150 300h300M300 150v300'/><path d='M220 230h50M220 300h50M220 370h50'/><path d='M330 230h50M330 300h50M330 370h50'/></g></svg>`
 );
+var moneySchema = import_zod.z.object({
+  amount: import_zod.z.string(),
+  currencyCode: import_zod.z.string()
+});
+var imageSchema = import_zod.z.object({
+  id: import_zod.z.string().optional(),
+  url: import_zod.z.string(),
+  altText: import_zod.z.string(),
+  width: import_zod.z.number().optional(),
+  height: import_zod.z.number().optional()
+});
+var selectedOptionSchema = import_zod.z.object({
+  name: import_zod.z.string(),
+  value: import_zod.z.string()
+});
+var productDetailVariantSchema = import_zod.z.object({
+  id: import_zod.z.string(),
+  title: import_zod.z.string(),
+  sku: import_zod.z.string().optional(),
+  availableForSale: import_zod.z.boolean(),
+  selectedOptions: import_zod.z.array(selectedOptionSchema),
+  /** Omit or null when the backend has no resolved price (purchase disabled). */
+  price: moneySchema.nullish(),
+  compareAtPrice: moneySchema.optional(),
+  image: imageSchema.optional()
+});
+var productDetailProductSchema = import_zod.z.object({
+  id: import_zod.z.string(),
+  handle: import_zod.z.string().optional(),
+  title: import_zod.z.string(),
+  description: import_zod.z.string().optional(),
+  vendor: import_zod.z.string().optional(),
+  options: import_zod.z.array(import_zod.z.object({ id: import_zod.z.string(), name: import_zod.z.string(), values: import_zod.z.array(import_zod.z.string()) })),
+  variants: import_zod.z.array(productDetailVariantSchema),
+  images: import_zod.z.array(imageSchema),
+  featuredImage: imageSchema.optional()
+});
+var productOverview1PropsSchema = import_zod.z.object({
+  product: productDetailProductSchema,
+  selectedVariantId: import_zod.z.string().nullable().optional(),
+  quantity: import_zod.z.number().optional(),
+  rating: import_zod.z.object({ value: import_zod.z.number(), count: import_zod.z.number() }).optional(),
+  deliveryEstimate: import_zod.z.string().optional(),
+  shipping: moneySchema.optional(),
+  sizesLabel: import_zod.z.string().optional(),
+  variantLabel: import_zod.z.string().optional(),
+  reviewsLabel: import_zod.z.string().optional(),
+  addToCartLabel: import_zod.z.string().optional(),
+  outOfStockLabel: import_zod.z.string().optional(),
+  unavailablePriceLabel: import_zod.z.string().optional(),
+  selectVariantLabel: import_zod.z.string().optional(),
+  quantityLabel: import_zod.z.string().optional(),
+  deliveryEstimateLabel: import_zod.z.string().optional(),
+  shippingLabel: import_zod.z.string().optional()
+});
 var cardProductSchema = import_zod.z.object({
   id: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]),
   title: import_zod.z.string(),
@@ -56,8 +153,20 @@ var cartItemSchema = import_zod.z.object({
   name: import_zod.z.string(),
   price: import_zod.z.number(),
   quantity: import_zod.z.number().int().min(0),
-  image: import_zod.z.string(),
-  variant: import_zod.z.string().optional()
+  /** Optional; absent images are omitted, never serialized as `""`. */
+  image: import_zod.z.string().optional(),
+  variant: import_zod.z.string().optional(),
+  /** Canonical backend per-unit price, preferred for display when present. */
+  unitPrice: moneySchema.optional(),
+  /** Canonical backend line total, preferred over `price * quantity`. */
+  lineTotal: moneySchema.optional()
+});
+var cartTotalsSchema = import_zod.z.object({
+  subtotal: moneySchema,
+  discount: moneySchema.optional(),
+  tax: moneySchema.optional(),
+  shipping: moneySchema.optional(),
+  total: moneySchema
 });
 var recentlyViewedItemSchema = import_zod.z.object({
   id: import_zod.z.string(),
@@ -88,10 +197,11 @@ var utilityLinkSchema = import_zod.z.object({
 var navCartItemSchema = import_zod.z.object({
   id: import_zod.z.string(),
   name: import_zod.z.string(),
-  variant: import_zod.z.string(),
+  variant: import_zod.z.string().optional(),
   price: import_zod.z.number(),
   qty: import_zod.z.number().int().min(0),
-  image: import_zod.z.string()
+  /** Optional; absent images are omitted, never serialized as `""`. */
+  image: import_zod.z.string().optional()
 });
 var storeUserSchema = import_zod.z.object({
   name: import_zod.z.string(),
@@ -151,13 +261,22 @@ var shoppingCart4PropsSchema = import_zod.z.object({
   items: import_zod.z.array(cartItemSchema),
   promotions: import_zod.z.array(promotionSchema).default([]),
   recentlyViewed: import_zod.z.array(recentlyViewedItemSchema).optional(),
+  /** Backend-authoritative totals; rendered verbatim, never computed locally. */
+  totals: cartTotalsSchema.optional(),
+  totalsState: import_zod.z.enum(["idle", "pending", "error"]).optional(),
+  totalsErrorLabel: import_zod.z.string().optional(),
+  totalsUnavailableLabel: import_zod.z.string().optional(),
+  amountUnavailableLabel: import_zod.z.string().optional(),
+  retryLabel: import_zod.z.string().optional(),
   taxRate: import_zod.z.number().optional(),
   titleLabel: import_zod.z.string().optional(),
   subtotalLabel: import_zod.z.string().optional(),
+  discountLabel: import_zod.z.string().optional(),
   taxLabel: import_zod.z.string().optional(),
   shippingLabel: import_zod.z.string().optional(),
   shippingFreeLabel: import_zod.z.string().optional(),
   totalLabel: import_zod.z.string().optional(),
+  totalsPendingLabel: import_zod.z.string().optional(),
   awayFromLabel: import_zod.z.string().optional(),
   activatedLabel: import_zod.z.string().optional(),
   itemsLabel: import_zod.z.string().optional(),
@@ -171,7 +290,23 @@ var shoppingCart4PropsSchema = import_zod.z.object({
   expandLabel: import_zod.z.string().optional(),
   checkoutLabel: import_zod.z.string().optional(),
   quickCheckoutLabel: import_zod.z.string().optional(),
-  checkoutNowLabel: import_zod.z.string().optional()
+  checkoutNowLabel: import_zod.z.string().optional(),
+  emptyLabel: import_zod.z.string().optional(),
+  removeLabel: import_zod.z.string().optional(),
+  decreaseLabel: import_zod.z.string().optional(),
+  increaseLabel: import_zod.z.string().optional()
+});
+var logoAccentSchema = import_zod.z.object({
+  text: import_zod.z.string(),
+  className: import_zod.z.string().optional()
+});
+var brandAccentSchema = import_zod.z.object({
+  text: import_zod.z.string(),
+  className: import_zod.z.string().optional()
+});
+var heroImageSchema = import_zod.z.object({
+  src: import_zod.z.string(),
+  alt: import_zod.z.string()
 });
 var navbar4PropsSchema = import_zod.z.object({
   storeCategories: import_zod.z.array(storeCategorySchema),
@@ -179,25 +314,73 @@ var navbar4PropsSchema = import_zod.z.object({
   utilityLinks: import_zod.z.array(utilityLinkSchema),
   logoText: import_zod.z.string(),
   logoHref: import_zod.z.string().optional(),
+  /** Optional accent for a trailing segment of `logoText`; omitted → unchanged. */
+  logoAccent: logoAccentSchema.optional(),
+  /**
+   * Consumer-supplied classes merged onto the block's outer surface as the
+   * final argument (e.g. a semantic surface token). Omitted → unchanged.
+   */
+  className: import_zod.z.string().optional(),
   accountHref: import_zod.z.string().optional(),
   searchQuery: import_zod.z.string().optional(),
   items: import_zod.z.array(navCartItemSchema).optional(),
+  /** Authoritative backend subtotal for the mini-cart. */
+  subtotal: moneySchema.optional(),
+  subtotalUnavailableLabel: import_zod.z.string().optional(),
   user: storeUserSchema.optional(),
   accountMenuItems: import_zod.z.array(accountMenuItemSchema).optional()
 });
+var ctaSchema = import_zod.z.object({
+  label: import_zod.z.string(),
+  href: import_zod.z.string().optional()
+});
+var faqItemSchema = import_zod.z.object({
+  value: import_zod.z.string(),
+  question: import_zod.z.string(),
+  answer: import_zod.z.string()
+});
+var faqBlock1PropsSchema = import_zod.z.object({
+  items: import_zod.z.array(faqItemSchema),
+  title: import_zod.z.string().optional(),
+  description: import_zod.z.string().optional(),
+  accordionType: import_zod.z.enum(["single", "multiple"]).optional()
+});
+var ctaSection1PropsSchema = import_zod.z.object({
+  badgeText: import_zod.z.string().optional(),
+  title: import_zod.z.string().optional(),
+  description: import_zod.z.string().optional(),
+  primaryCta: ctaSchema.optional(),
+  secondaryCta: ctaSchema.optional()
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PRODUCT_IMAGE_FALLBACK,
   accountMenuItemSchema,
+  brandAccentSchema,
   buttonPropsSchema,
   cardProductSchema,
   cartItemSchema,
+  cartTotalsSchema,
+  ctaSchema,
+  ctaSection1PropsSchema,
+  faqBlock1PropsSchema,
+  faqItemSchema,
+  formatMoney,
+  heroImageSchema,
+  isAvailableMoney,
+  isCompleteFiniteDecimal,
+  logoAccentSchema,
+  moneySchema,
   navCartItemSchema,
   navbar4PropsSchema,
   paymentMethodSchema,
   productCard1PropsSchema,
+  productDetailProductSchema,
+  productDetailVariantSchema,
+  productOverview1PropsSchema,
   promotionSchema,
   recentlyViewedItemSchema,
+  resolveAbsoluteQuantity,
   shoppingCart4PropsSchema,
   storeCategorySchema,
   storeContainer1PropsSchema,

package/dist/contracts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/lib/contracts.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { Money, PaymentMethod, ProductPreview } from '@thorprovider/types'\n\n/**\n * Serialization contracts for spec-driven storefronts.\n *\n * These Zod schemas are the *serializable subset* of what a spec may write for\n * a block. The component keeps its rich React interface; the catalog/registry\n * is the adapter that maps these props to real component props and binds\n * callbacks (see storefronts-on-blocks design D3). `z.infer` is the typed\n * boundary between spec and catalog — a prop outside the schema is a compile\n * error, not a runtime surprise.\n *\n * Data shapes are projections of the @thorprovider/types canon so that\n * @thorprovider/adapters output validates without conflict:\n * - Prices are plain numbers here while the canon `Money` is a decimal string\n *   ({ amount: \"45.00\", currencyCode }). The projection happens at the\n *   loader boundary.\n * - Blocks use `title` while the canon `ProductPreview` uses `name`. Reconcile\n *   via the canonical aliases below or the catalog/loader adapter.\n */\nexport type CanonMoney = Money\nexport type CanonProduct = ProductPreview\n\n/**\n * Fallback data-URI for required image fields when the data source has no\n * image. Image fields are non-optional `z.string()` in these contracts, so the\n * boundary must never emit `\"\"` (React warns about `src=\"\"`); it must emit a\n * real, renderable value. Hosts may override with their own branded fallback\n * (e.g. electrostore's `CATEGORY_IMAGE_FALLBACK`), but blocks ship a neutral\n * one so direct consumers are safe by default.\n */\nexport const PRODUCT_IMAGE_FALLBACK =\n  'data:image/svg+xml;charset=utf-8,' +\n  encodeURIComponent(\n    `<svg xmlns='http://www.w3.org/2000/svg' width='600' height='600'><rect width='100%' height='100%' fill='#e2e8f0'/><g fill='none' stroke='#94a3b8' stroke-width='12' stroke-linecap='round'><path d='M150 300h300M300 150v300'/><path d='M220 230h50M220 300h50M220 370h50'/><path d='M330 230h50M330 300h50M330 370h50'/></g></svg>`,\n  )\n\n// ---------------------------------------------------------------------------\n// Data contracts\n// ---------------------------------------------------------------------------\n\nexport const cardProductSchema = z.object({\n  id: z.union([z.string(), z.number()]),\n  title: z.string(),\n  price: z.number(),\n  originalPrice: z.number().optional(),\n  image: z.string(),\n  badge: z.string().optional(),\n})\nexport type CardProduct = z.infer<typeof cardProductSchema>\n\nexport const cartItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  price: z.number(),\n  quantity: z.number().int().min(0),\n  image: z.string(),\n  variant: z.string().optional(),\n})\nexport type CartItem = z.infer<typeof cartItemSchema>\n\nexport const recentlyViewedItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  price: z.number(),\n  image: z.string(),\n})\nexport type RecentlyViewedItem = z.infer<typeof recentlyViewedItemSchema>\n\nexport const promotionSchema = z.object({\n  threshold: z.number(),\n  reward: z.string(),\n  icon: z.string().default('gift'),\n})\nexport type Promotion = z.infer<typeof promotionSchema>\n\nconst storeCategoryBase = {\n  label: z.string(),\n  href: z.string(),\n  emphasis: z.boolean().optional(),\n}\n\nexport const storeCategorySchema: z.ZodType<StoreCategory> = z.lazy(() =>\n  z.object({\n    ...storeCategoryBase,\n    children: z.array(storeCategorySchema).optional(),\n  }),\n)\nexport type StoreCategory = {\n  label: string\n  href: string\n  children?: StoreCategory[]\n  emphasis?: boolean\n}\n\nexport const utilityLinkSchema = z.object({\n  label: z.string(),\n  href: z.string(),\n})\nexport type UtilityLink = z.infer<typeof utilityLinkSchema>\n\nexport const navCartItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  variant: z.string(),\n  price: z.number(),\n  qty: z.number().int().min(0),\n  image: z.string(),\n})\nexport type NavCartItem = z.infer<typeof navCartItemSchema>\n\nexport const storeUserSchema = z.object({\n  name: z.string(),\n  email: z.string(),\n  avatar: z.string(),\n  initials: z.string(),\n})\nexport type StoreUser = z.infer<typeof storeUserSchema>\n\nexport const accountMenuItemSchema = z.object({\n  label: z.string(),\n  href: z.string(),\n  description: z.string().optional(),\n  icon: z.enum(['orders', 'wishlist', 'addresses', 'settings']).optional(),\n})\nexport type AccountMenuItem = z.infer<typeof accountMenuItemSchema>\n\n/**\n * Serialization contract for a payment method offered at checkout.\n *\n * A projection of `@thorprovider/types` `PaymentMethod` — the storefront-facing\n * shape produced by the adapters transform. Checkout blocks render the method\n * list from this data instead of hardcoding providers.\n */\nexport const paymentMethodSchema: z.ZodType<PaymentMethod> = z.object({\n  id: z.string(),\n  name: z.string(),\n  type: z.enum([\n    'card',\n    'wallet',\n    'bank_transfer',\n    'buy_now_pay_later',\n    'cash_on_delivery',\n    'crypto',\n    'other',\n  ]),\n  isEnabled: z.boolean(),\n  requiresSetup: z.boolean(),\n  description: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  features: z\n    .object({\n      saveForLater: z.boolean().optional(),\n      requires3DS: z.boolean().optional(),\n      supportsRefunds: z.boolean().optional(),\n      minAmount: z.number().optional(),\n      maxAmount: z.number().optional(),\n      supportedCurrencies: z.array(z.string()).optional(),\n      requiresVerification: z.boolean().optional(),\n    })\n    .optional(),\n  logo: z.string().optional(),\n})\n\n// ---------------------------------------------------------------------------\n// Block prop schemas\n// ---------------------------------------------------------------------------\n\nexport const buttonPropsSchema = z.object({\n  variant: z\n    .enum(['default', 'destructive', 'outline', 'secondary', 'ghost', 'link'])\n    .optional(),\n  size: z\n    .enum(['default', 'xs', 'sm', 'lg', 'icon', 'icon-xs', 'icon-sm', 'icon-lg'])\n    .optional(),\n  disabled: z.boolean().optional(),\n  className: z.string().optional(),\n})\nexport type ButtonSpecProps = z.infer<typeof buttonPropsSchema>\n\nexport const storeContainer1PropsSchema = z.object({\n  size: z.enum(['default', 'narrow', 'wide', 'full']).optional(),\n  className: z.string().optional(),\n})\nexport type StoreContainer1SpecProps = z.infer<typeof storeContainer1PropsSchema>\n\nexport const productCard1PropsSchema = z.object({\n  products: z.array(cardProductSchema),\n  heading: z.string().optional(),\n  maxItems: z.number().int().positive().optional(),\n})\nexport type ProductCard1SpecProps = z.infer<typeof productCard1PropsSchema>\n\nexport const shoppingCart4PropsSchema = z.object({\n  items: z.array(cartItemSchema),\n  promotions: z.array(promotionSchema).default([]),\n  recentlyViewed: z.array(recentlyViewedItemSchema).optional(),\n  taxRate: z.number().optional(),\n  titleLabel: z.string().optional(),\n  subtotalLabel: z.string().optional(),\n  taxLabel: z.string().optional(),\n  shippingLabel: z.string().optional(),\n  shippingFreeLabel: z.string().optional(),\n  totalLabel: z.string().optional(),\n  awayFromLabel: z.string().optional(),\n  activatedLabel: z.string().optional(),\n  itemsLabel: z.string().optional(),\n  expressCheckoutLabel: z.string().optional(),\n  expressLabel: z.string().optional(),\n  standardLabel: z.string().optional(),\n  estimatedDeliveryLabel: z.string().optional(),\n  secureCheckoutLabel: z.string().optional(),\n  recentlyViewedLabel: z.string().optional(),\n  collapseLabel: z.string().optional(),\n  expandLabel: z.string().optional(),\n  checkoutLabel: z.string().optional(),\n  quickCheckoutLabel: z.string().optional(),\n  checkoutNowLabel: z.string().optional(),\n})\nexport type ShoppingCart4SpecProps = z.infer<typeof shoppingCart4PropsSchema>\n\nexport const navbar4PropsSchema = z.object({\n  storeCategories: z.array(storeCategorySchema),\n  shippingNote: z.string(),\n  utilityLinks: z.array(utilityLinkSchema),\n  logoText: z.string(),\n  logoHref: z.string().optional(),\n  accountHref: z.string().optional(),\n  searchQuery: z.string().optional(),\n  items: z.array(navCartItemSchema).optional(),\n  user: storeUserSchema.optional(),\n  accountMenuItems: z.array(accountMenuItemSchema).optional(),\n})\nexport type Navbar4SpecProps = z.infer<typeof navbar4PropsSchema>"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAgCX,IAAM,yBACX,sCACA;AAAA,EACE;AACF;AAMK,IAAM,oBAAoB,aAAE,OAAO;AAAA,EACxC,IAAI,aAAE,MAAM,CAAC,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,CAAC;AAAA,EACpC,OAAO,aAAE,OAAO;AAAA,EAChB,OAAO,aAAE,OAAO;AAAA,EAChB,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,OAAO,aAAE,OAAO;AAAA,EAChB,OAAO,aAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAGM,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,IAAI,aAAE,OAAO;AAAA,EACb,MAAM,aAAE,OAAO;AAAA,EACf,OAAO,aAAE,OAAO;AAAA,EAChB,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;AAAA,EAChC,OAAO,aAAE,OAAO;AAAA,EAChB,SAAS,aAAE,OAAO,EAAE,SAAS;AAC/B,CAAC;AAGM,IAAM,2BAA2B,aAAE,OAAO;AAAA,EAC/C,IAAI,aAAE,OAAO;AAAA,EACb,MAAM,aAAE,OAAO;AAAA,EACf,OAAO,aAAE,OAAO;AAAA,EAChB,OAAO,aAAE,OAAO;AAClB,CAAC;AAGM,IAAM,kBAAkB,aAAE,OAAO;AAAA,EACtC,WAAW,aAAE,OAAO;AAAA,EACpB,QAAQ,aAAE,OAAO;AAAA,EACjB,MAAM,aAAE,OAAO,EAAE,QAAQ,MAAM;AACjC,CAAC;AAGD,IAAM,oBAAoB;AAAA,EACxB,OAAO,aAAE,OAAO;AAAA,EAChB,MAAM,aAAE,OAAO;AAAA,EACf,UAAU,aAAE,QAAQ,EAAE,SAAS;AACjC;AAEO,IAAM,sBAAgD,aAAE;AAAA,EAAK,MAClE,aAAE,OAAO;AAAA,IACP,GAAG;AAAA,IACH,UAAU,aAAE,MAAM,mBAAmB,EAAE,SAAS;AAAA,EAClD,CAAC;AACH;AAQO,IAAM,oBAAoB,aAAE,OAAO;AAAA,EACxC,OAAO,aAAE,OAAO;AAAA,EAChB,MAAM,aAAE,OAAO;AACjB,CAAC;AAGM,IAAM,oBAAoB,aAAE,OAAO;AAAA,EACxC,IAAI,aAAE,OAAO;AAAA,EACb,MAAM,aAAE,OAAO;AAAA,EACf,SAAS,aAAE,OAAO;AAAA,EAClB,OAAO,aAAE,OAAO;AAAA,EAChB,KAAK,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;AAAA,EAC3B,OAAO,aAAE,OAAO;AAClB,CAAC;AAGM,IAAM,kBAAkB,aAAE,OAAO;AAAA,EACtC,MAAM,aAAE,OAAO;AAAA,EACf,OAAO,aAAE,OAAO;AAAA,EAChB,QAAQ,aAAE,OAAO;AAAA,EACjB,UAAU,aAAE,OAAO;AACrB,CAAC;AAGM,IAAM,wBAAwB,aAAE,OAAO;AAAA,EAC5C,OAAO,aAAE,OAAO;AAAA,EAChB,MAAM,aAAE,OAAO;AAAA,EACf,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,MAAM,aAAE,KAAK,CAAC,UAAU,YAAY,aAAa,UAAU,CAAC,EAAE,SAAS;AACzE,CAAC;AAUM,IAAM,sBAAgD,aAAE,OAAO;AAAA,EACpE,IAAI,aAAE,OAAO;AAAA,EACb,MAAM,aAAE,OAAO;AAAA,EACf,MAAM,aAAE,KAAK;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,WAAW,aAAE,QAAQ;AAAA,EACrB,eAAe,aAAE,QAAQ;AAAA,EACzB,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,UAAU,aAAE,OAAO,aAAE,OAAO,GAAG,aAAE,QAAQ,CAAC,EAAE,SAAS;AAAA,EACrD,UAAU,aACP,OAAO;AAAA,IACN,cAAc,aAAE,QAAQ,EAAE,SAAS;AAAA,IACnC,aAAa,aAAE,QAAQ,EAAE,SAAS;AAAA,IAClC,iBAAiB,aAAE,QAAQ,EAAE,SAAS;AAAA,IACtC,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,IAC/B,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,IAC/B,qBAAqB,aAAE,MAAM,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,IAClD,sBAAsB,aAAE,QAAQ,EAAE,SAAS;AAAA,EAC7C,CAAC,EACA,SAAS;AAAA,EACZ,MAAM,aAAE,OAAO,EAAE,SAAS;AAC5B,CAAC;AAMM,IAAM,oBAAoB,aAAE,OAAO;AAAA,EACxC,SAAS,aACN,KAAK,CAAC,WAAW,eAAe,WAAW,aAAa,SAAS,MAAM,CAAC,EACxE,SAAS;AAAA,EACZ,MAAM,aACH,KAAK,CAAC,WAAW,MAAM,MAAM,MAAM,QAAQ,WAAW,WAAW,SAAS,CAAC,EAC3E,SAAS;AAAA,EACZ,UAAU,aAAE,QAAQ,EAAE,SAAS;AAAA,EAC/B,WAAW,aAAE,OAAO,EAAE,SAAS;AACjC,CAAC;AAGM,IAAM,6BAA6B,aAAE,OAAO;AAAA,EACjD,MAAM,aAAE,KAAK,CAAC,WAAW,UAAU,QAAQ,MAAM,CAAC,EAAE,SAAS;AAAA,EAC7D,WAAW,aAAE,OAAO,EAAE,SAAS;AACjC,CAAC;AAGM,IAAM,0BAA0B,aAAE,OAAO;AAAA,EAC9C,UAAU,aAAE,MAAM,iBAAiB;AAAA,EACnC,SAAS,aAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AACjD,CAAC;AAGM,IAAM,2BAA2B,aAAE,OAAO;AAAA,EAC/C,OAAO,aAAE,MAAM,cAAc;AAAA,EAC7B,YAAY,aAAE,MAAM,eAAe,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC/C,gBAAgB,aAAE,MAAM,wBAAwB,EAAE,SAAS;AAAA,EAC3D,SAAS,aAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAChC,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,UAAU,aAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,mBAAmB,aAAE,OAAO,EAAE,SAAS;AAAA,EACvC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAChC,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,gBAAgB,aAAE,OAAO,EAAE,SAAS;AAAA,EACpC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAChC,sBAAsB,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1C,cAAc,aAAE,OAAO,EAAE,SAAS;AAAA,EAClC,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,wBAAwB,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5C,qBAAqB,aAAE,OAAO,EAAE,SAAS;AAAA,EACzC,qBAAqB,aAAE,OAAO,EAAE,SAAS;AAAA,EACzC,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,eAAe,aAAE,OAAO,EAAE,SAAS;AAAA,EACnC,oBAAoB,aAAE,OAAO,EAAE,SAAS;AAAA,EACxC,kBAAkB,aAAE,OAAO,EAAE,SAAS;AACxC,CAAC;AAGM,IAAM,qBAAqB,aAAE,OAAO;AAAA,EACzC,iBAAiB,aAAE,MAAM,mBAAmB;AAAA,EAC5C,cAAc,aAAE,OAAO;AAAA,EACvB,cAAc,aAAE,MAAM,iBAAiB;AAAA,EACvC,UAAU,aAAE,OAAO;AAAA,EACnB,UAAU,aAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,aAAE,MAAM,iBAAiB,EAAE,SAAS;AAAA,EAC3C,MAAM,gBAAgB,SAAS;AAAA,EAC/B,kBAAkB,aAAE,MAAM,qBAAqB,EAAE,SAAS;AAC5D,CAAC;","names":[]}
+{"version":3,"sources":["../src/lib/contracts.ts","../src/lib/money.ts","../src/lib/cart.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { Money, PaymentMethod, ProductPreview } from '@thorprovider/types'\n\n/**\n * Serialization contracts for spec-driven storefronts.\n *\n * These Zod schemas are the *serializable subset* of what a spec may write for\n * a block. The component keeps its rich React interface; the catalog/registry\n * is the adapter that maps these props to real component props and binds\n * callbacks (see storefronts-on-blocks design D3). `z.infer` is the typed\n * boundary between spec and catalog — a prop outside the schema is a compile\n * error, not a runtime surprise.\n *\n * Data shapes are projections of the @thorprovider/types canon so that\n * @thorprovider/adapters output validates without conflict:\n * - Prices are plain numbers here while the canon `Money` is a decimal string\n *   ({ amount: \"45.00\", currencyCode }). The projection happens at the\n *   loader boundary.\n * - Blocks use `title` while the canon `ProductPreview` uses `name`. Reconcile\n *   via the canonical aliases below or the catalog/loader adapter.\n */\nexport type CanonMoney = Money\nexport type CanonProduct = ProductPreview\n\n/**\n * Fallback data-URI for required image fields when the data source has no\n * image. Image fields are non-optional `z.string()` in these contracts, so the\n * boundary must never emit `\"\"` (React warns about `src=\"\"`); it must emit a\n * real, renderable value. Hosts may override with their own branded fallback\n * (e.g. electrostore's `CATEGORY_IMAGE_FALLBACK`), but blocks ship a neutral\n * one so direct consumers are safe by default.\n */\nexport const PRODUCT_IMAGE_FALLBACK =\n  'data:image/svg+xml;charset=utf-8,' +\n  encodeURIComponent(\n    `<svg xmlns='http://www.w3.org/2000/svg' width='600' height='600'><rect width='100%' height='100%' fill='#e2e8f0'/><g fill='none' stroke='#94a3b8' stroke-width='12' stroke-linecap='round'><path d='M150 300h300M300 150v300'/><path d='M220 230h50M220 300h50M220 370h50'/><path d='M330 230h50M330 300h50M330 370h50'/></g></svg>`,\n  )\n\n// ---------------------------------------------------------------------------\n// Data contracts\n// ---------------------------------------------------------------------------\n\n/**\n * Canonical `Money` (`@thorprovider/types`): a decimal string in major units\n * (`\"69.99\"`), never cents. A missing price is represented by omitting the\n * field (or `null` on a nullable field), not by an empty string.\n *\n * The amount stays a permissive `z.string()` on purpose: an unresolved backend\n * price may arrive as the canonical sentinel `\"\"`, and tightening the schema\n * would reject the whole view instead of letting the presentation layer render\n * an unavailable state. Validity is enforced at render time by\n * `isAvailableMoney`/`formatMoney` (a `\"\"`/malformed amount never becomes `$0`).\n */\nexport const moneySchema: z.ZodType<Money> = z.object({\n  amount: z.string(),\n  currencyCode: z.string(),\n})\n\nconst imageSchema = z.object({\n  id: z.string().optional(),\n  url: z.string(),\n  altText: z.string(),\n  width: z.number().optional(),\n  height: z.number().optional(),\n})\n\nconst selectedOptionSchema = z.object({\n  name: z.string(),\n  value: z.string(),\n})\n\nexport const productDetailVariantSchema = z.object({\n  id: z.string(),\n  title: z.string(),\n  sku: z.string().optional(),\n  availableForSale: z.boolean(),\n  selectedOptions: z.array(selectedOptionSchema),\n  /** Omit or null when the backend has no resolved price (purchase disabled). */\n  price: moneySchema.nullish(),\n  compareAtPrice: moneySchema.optional(),\n  image: imageSchema.optional(),\n})\nexport type ProductDetailVariantSpec = z.infer<typeof productDetailVariantSchema>\n\nexport const productDetailProductSchema = z.object({\n  id: z.string(),\n  handle: z.string().optional(),\n  title: z.string(),\n  description: z.string().optional(),\n  vendor: z.string().optional(),\n  options: z.array(z.object({ id: z.string(), name: z.string(), values: z.array(z.string()) })),\n  variants: z.array(productDetailVariantSchema),\n  images: z.array(imageSchema),\n  featuredImage: imageSchema.optional(),\n})\nexport type ProductDetailProductSpec = z.infer<typeof productDetailProductSchema>\n\nexport const productOverview1PropsSchema = z.object({\n  product: productDetailProductSchema,\n  selectedVariantId: z.string().nullable().optional(),\n  quantity: z.number().optional(),\n  rating: z.object({ value: z.number(), count: z.number() }).optional(),\n  deliveryEstimate: z.string().optional(),\n  shipping: moneySchema.optional(),\n  sizesLabel: z.string().optional(),\n  variantLabel: z.string().optional(),\n  reviewsLabel: z.string().optional(),\n  addToCartLabel: z.string().optional(),\n  outOfStockLabel: z.string().optional(),\n  unavailablePriceLabel: z.string().optional(),\n  selectVariantLabel: z.string().optional(),\n  quantityLabel: z.string().optional(),\n  deliveryEstimateLabel: z.string().optional(),\n  shippingLabel: z.string().optional(),\n})\nexport type ProductOverview1SpecProps = z.infer<typeof productOverview1PropsSchema>\n\nexport const cardProductSchema = z.object({\n  id: z.union([z.string(), z.number()]),\n  title: z.string(),\n  price: z.number(),\n  originalPrice: z.number().optional(),\n  image: z.string(),\n  badge: z.string().optional(),\n})\nexport type CardProduct = z.infer<typeof cardProductSchema>\n\nexport const cartItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  price: z.number(),\n  quantity: z.number().int().min(0),\n  /** Optional; absent images are omitted, never serialized as `\"\"`. */\n  image: z.string().optional(),\n  variant: z.string().optional(),\n  /** Canonical backend per-unit price, preferred for display when present. */\n  unitPrice: moneySchema.optional(),\n  /** Canonical backend line total, preferred over `price * quantity`. */\n  lineTotal: moneySchema.optional(),\n})\nexport type CartItem = z.infer<typeof cartItemSchema>\n\nexport const cartTotalsSchema = z.object({\n  subtotal: moneySchema,\n  discount: moneySchema.optional(),\n  tax: moneySchema.optional(),\n  shipping: moneySchema.optional(),\n  total: moneySchema,\n})\nexport type CartTotals = z.infer<typeof cartTotalsSchema>\n\nexport const recentlyViewedItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  price: z.number(),\n  image: z.string(),\n})\nexport type RecentlyViewedItem = z.infer<typeof recentlyViewedItemSchema>\n\nexport const promotionSchema = z.object({\n  threshold: z.number(),\n  reward: z.string(),\n  icon: z.string().default('gift'),\n})\nexport type Promotion = z.infer<typeof promotionSchema>\n\nconst storeCategoryBase = {\n  label: z.string(),\n  href: z.string(),\n  emphasis: z.boolean().optional(),\n}\n\nexport const storeCategorySchema: z.ZodType<StoreCategory> = z.lazy(() =>\n  z.object({\n    ...storeCategoryBase,\n    children: z.array(storeCategorySchema).optional(),\n  }),\n)\nexport type StoreCategory = {\n  label: string\n  href: string\n  children?: StoreCategory[]\n  emphasis?: boolean\n}\n\nexport const utilityLinkSchema = z.object({\n  label: z.string(),\n  href: z.string(),\n})\nexport type UtilityLink = z.infer<typeof utilityLinkSchema>\n\nexport const navCartItemSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  variant: z.string().optional(),\n  price: z.number(),\n  qty: z.number().int().min(0),\n  /** Optional; absent images are omitted, never serialized as `\"\"`. */\n  image: z.string().optional(),\n})\nexport type NavCartItem = z.infer<typeof navCartItemSchema>\n\nexport const storeUserSchema = z.object({\n  name: z.string(),\n  email: z.string(),\n  avatar: z.string(),\n  initials: z.string(),\n})\nexport type StoreUser = z.infer<typeof storeUserSchema>\n\nexport const accountMenuItemSchema = z.object({\n  label: z.string(),\n  href: z.string(),\n  description: z.string().optional(),\n  icon: z.enum(['orders', 'wishlist', 'addresses', 'settings']).optional(),\n})\nexport type AccountMenuItem = z.infer<typeof accountMenuItemSchema>\n\n/**\n * Serialization contract for a payment method offered at checkout.\n *\n * A projection of `@thorprovider/types` `PaymentMethod` — the storefront-facing\n * shape produced by the adapters transform. Checkout blocks render the method\n * list from this data instead of hardcoding providers.\n */\nexport const paymentMethodSchema: z.ZodType<PaymentMethod> = z.object({\n  id: z.string(),\n  name: z.string(),\n  type: z.enum([\n    'card',\n    'wallet',\n    'bank_transfer',\n    'buy_now_pay_later',\n    'cash_on_delivery',\n    'crypto',\n    'other',\n  ]),\n  isEnabled: z.boolean(),\n  requiresSetup: z.boolean(),\n  description: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  features: z\n    .object({\n      saveForLater: z.boolean().optional(),\n      requires3DS: z.boolean().optional(),\n      supportsRefunds: z.boolean().optional(),\n      minAmount: z.number().optional(),\n      maxAmount: z.number().optional(),\n      supportedCurrencies: z.array(z.string()).optional(),\n      requiresVerification: z.boolean().optional(),\n    })\n    .optional(),\n  logo: z.string().optional(),\n})\n\n// ---------------------------------------------------------------------------\n// Block prop schemas\n// ---------------------------------------------------------------------------\n\nexport const buttonPropsSchema = z.object({\n  variant: z\n    .enum(['default', 'destructive', 'outline', 'secondary', 'ghost', 'link'])\n    .optional(),\n  size: z\n    .enum(['default', 'xs', 'sm', 'lg', 'icon', 'icon-xs', 'icon-sm', 'icon-lg'])\n    .optional(),\n  disabled: z.boolean().optional(),\n  className: z.string().optional(),\n})\nexport type ButtonSpecProps = z.infer<typeof buttonPropsSchema>\n\nexport const storeContainer1PropsSchema = z.object({\n  size: z.enum(['default', 'narrow', 'wide', 'full']).optional(),\n  className: z.string().optional(),\n})\nexport type StoreContainer1SpecProps = z.infer<typeof storeContainer1PropsSchema>\n\nexport const productCard1PropsSchema = z.object({\n  products: z.array(cardProductSchema),\n  heading: z.string().optional(),\n  maxItems: z.number().int().positive().optional(),\n})\nexport type ProductCard1SpecProps = z.infer<typeof productCard1PropsSchema>\n\nexport const shoppingCart4PropsSchema = z.object({\n  items: z.array(cartItemSchema),\n  promotions: z.array(promotionSchema).default([]),\n  recentlyViewed: z.array(recentlyViewedItemSchema).optional(),\n  /** Backend-authoritative totals; rendered verbatim, never computed locally. */\n  totals: cartTotalsSchema.optional(),\n  totalsState: z.enum(['idle', 'pending', 'error']).optional(),\n  totalsErrorLabel: z.string().optional(),\n  totalsUnavailableLabel: z.string().optional(),\n  amountUnavailableLabel: z.string().optional(),\n  retryLabel: z.string().optional(),\n  taxRate: z.number().optional(),\n  titleLabel: z.string().optional(),\n  subtotalLabel: z.string().optional(),\n  discountLabel: z.string().optional(),\n  taxLabel: z.string().optional(),\n  shippingLabel: z.string().optional(),\n  shippingFreeLabel: z.string().optional(),\n  totalLabel: z.string().optional(),\n  totalsPendingLabel: z.string().optional(),\n  awayFromLabel: z.string().optional(),\n  activatedLabel: z.string().optional(),\n  itemsLabel: z.string().optional(),\n  expressCheckoutLabel: z.string().optional(),\n  expressLabel: z.string().optional(),\n  standardLabel: z.string().optional(),\n  estimatedDeliveryLabel: z.string().optional(),\n  secureCheckoutLabel: z.string().optional(),\n  recentlyViewedLabel: z.string().optional(),\n  collapseLabel: z.string().optional(),\n  expandLabel: z.string().optional(),\n  checkoutLabel: z.string().optional(),\n  quickCheckoutLabel: z.string().optional(),\n  checkoutNowLabel: z.string().optional(),\n  emptyLabel: z.string().optional(),\n  removeLabel: z.string().optional(),\n  decreaseLabel: z.string().optional(),\n  increaseLabel: z.string().optional(),\n})\nexport type ShoppingCart4SpecProps = z.infer<typeof shoppingCart4PropsSchema>\n\n/**\n * Optional brand seams shared by the existing blocks. These mirror the\n * components' optional props as a serializable subset (no React): an accent\n * marks a trailing segment of the wordmark/brand name, and an editorial image\n * is a native `<img>` source. Omitting each keeps the block's current output.\n */\nexport const logoAccentSchema = z.object({\n  text: z.string(),\n  className: z.string().optional(),\n})\nexport type LogoAccent = z.infer<typeof logoAccentSchema>\n\nexport const brandAccentSchema = z.object({\n  text: z.string(),\n  className: z.string().optional(),\n})\nexport type BrandAccent = z.infer<typeof brandAccentSchema>\n\nexport const heroImageSchema = z.object({\n  src: z.string(),\n  alt: z.string(),\n})\nexport type HeroImage = z.infer<typeof heroImageSchema>\n\nexport const navbar4PropsSchema = z.object({\n  storeCategories: z.array(storeCategorySchema),\n  shippingNote: z.string(),\n  utilityLinks: z.array(utilityLinkSchema),\n  logoText: z.string(),\n  logoHref: z.string().optional(),\n  /** Optional accent for a trailing segment of `logoText`; omitted → unchanged. */\n  logoAccent: logoAccentSchema.optional(),\n  /**\n   * Consumer-supplied classes merged onto the block's outer surface as the\n   * final argument (e.g. a semantic surface token). Omitted → unchanged.\n   */\n  className: z.string().optional(),\n  accountHref: z.string().optional(),\n  searchQuery: z.string().optional(),\n  items: z.array(navCartItemSchema).optional(),\n  /** Authoritative backend subtotal for the mini-cart. */\n  subtotal: moneySchema.optional(),\n  subtotalUnavailableLabel: z.string().optional(),\n  user: storeUserSchema.optional(),\n  accountMenuItems: z.array(accountMenuItemSchema).optional(),\n})\nexport type Navbar4SpecProps = z.infer<typeof navbar4PropsSchema>\n\n/**\n * Serializable contracts for the two bounded editorial sections (`faq`, `cta`).\n * These are the serializable subset of `FaqBlock1Props`/`CtaSection1Props`: the\n * React-only callbacks (`onPrimaryClick`/`onSecondaryClick`) are intentionally\n * excluded — the catalog adapter binds them (see design D3).\n */\nexport const ctaSchema = z.object({\n  label: z.string(),\n  href: z.string().optional(),\n})\nexport type CtaSpec = z.infer<typeof ctaSchema>\n\nexport const faqItemSchema = z.object({\n  value: z.string(),\n  question: z.string(),\n  answer: z.string(),\n})\nexport type FaqItemSpec = z.infer<typeof faqItemSchema>\n\nexport const faqBlock1PropsSchema = z.object({\n  items: z.array(faqItemSchema),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  accordionType: z.enum(['single', 'multiple']).optional(),\n})\nexport type FaqBlock1SpecProps = z.infer<typeof faqBlock1PropsSchema>\n\nexport const ctaSection1PropsSchema = z.object({\n  badgeText: z.string().optional(),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  primaryCta: ctaSchema.optional(),\n  secondaryCta: ctaSchema.optional(),\n})\nexport type CtaSection1SpecProps = z.infer<typeof ctaSection1PropsSchema>\n\n// Pure monetary helpers, re-exported from the server-safe contracts entry so a\n// host boundary can validate/format `Money` without importing the React entry.\nexport { isCompleteFiniteDecimal, isAvailableMoney, formatMoney } from './money'\nexport { resolveAbsoluteQuantity } from './cart'","import type { Money } from '@thorprovider/types'\n\n/**\n * Pure monetary helpers shared by the curated commerce blocks.\n *\n * Canonical `Money` (`@thorprovider/types`) carries a decimal string in major\n * units (e.g. `\"69.99\"`) — never cents. A missing, invalid, or unresolved\n * amount is *unavailable*, which is a different state from a legitimate `\"0\"`.\n * These helpers keep that distinction in the presentation layer: they validate\n * a complete finite decimal before any display conversion, and they never\n * invent a currency.\n */\n\nconst COMPLETE_FINITE_DECIMAL = /^-?(?:\\d+)(?:\\.\\d+)?$/\n\n/**\n * True only for a complete, finite decimal string (`\"0\"`, `\"69.99\"`, `\"-3.5\"`).\n * Rejects `\"\"`, `\" \"`, `\"1.\"`, `\".5\"`, `\"1e3\"`, `\"abc\"`, and non-strings.\n */\nexport function isCompleteFiniteDecimal(value: unknown): value is string {\n  if (typeof value !== 'string') return false\n  const trimmed = value.trim()\n  if (trimmed === '' || !COMPLETE_FINITE_DECIMAL.test(trimmed)) return false\n  return Number.isFinite(Number(trimmed))\n}\n\n/**\n * True when a `Money` value is safe to display and price a purchase with: a\n * complete finite decimal amount and a non-empty currency code. A valid zero\n * (`{ amount: '0', currencyCode: 'USD' }`) is available — zero alone does not\n * make a price unavailable.\n */\nexport function isAvailableMoney(money: Money | null | undefined): money is Money {\n  return (\n    !!money &&\n    typeof money.currencyCode === 'string' &&\n    money.currencyCode.trim() !== '' &&\n    isCompleteFiniteDecimal(money.amount)\n  )\n}\n\n/**\n * Formats a `Money` for display, or `null` when the value is unavailable.\n *\n * This is the safety gate the whole curated surface relies on: an absent or\n * malformed amount (`\"\"`, `\" \"`, `\"abc\"`, a non-string, a missing currency)\n * MUST NOT reach `Intl.NumberFormat`, because `Number(\"\")` is `0` and would\n * render a fake `$0.00` for missing data. A backend-resolved valid zero\n * (`{ amount: \"0\", currencyCode: \"USD\" }`) is available and formats as zero.\n *\n * When no `formatter` is supplied the currency comes from\n * `money.currencyCode`, so no currency is hardcoded. Callers render their own\n * unavailable/pending/recovery state when this returns `null`.\n */\nexport function formatMoney(\n  money: Money | null | undefined,\n  formatter?: (money: Money) => string,\n): string | null {\n  if (!isAvailableMoney(money)) return null\n  if (formatter) return formatter(money)\n  return new Intl.NumberFormat(undefined, {\n    style: 'currency',\n    currency: money.currencyCode,\n  }).format(Number(money.amount))\n}\n","/**\n * Cart line quantity normalization shared by the curated cart surfaces.\n *\n * The Navbar mini-cart expresses a quantity DELTA while the cart page reports\n * an ABSOLUTE quantity. The boundary normalizes the delta against the\n * authoritative current line quantity (from the backend cart) before mutating;\n * it must never reinterpret one as the other.\n */\nexport function resolveAbsoluteQuantity(currentQuantity: number, delta: number): number {\n  return Math.max(1, currentQuantity + delta)\n}\n"],"mappings":"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","names":[]}

package/dist/contracts.mjs

@@ -1,10 +1,90 @@
-'use client';
-
 // src/lib/contracts.ts
 import { z } from "zod";
+
+// src/lib/money.ts
+var COMPLETE_FINITE_DECIMAL = /^-?(?:\d+)(?:\.\d+)?$/;
+function isCompleteFiniteDecimal(value) {
+  if (typeof value !== "string") return false;
+  const trimmed = value.trim();
+  if (trimmed === "" || !COMPLETE_FINITE_DECIMAL.test(trimmed)) return false;
+  return Number.isFinite(Number(trimmed));
+}
+function isAvailableMoney(money) {
+  return !!money && typeof money.currencyCode === "string" && money.currencyCode.trim() !== "" && isCompleteFiniteDecimal(money.amount);
+}
+function formatMoney(money, formatter) {
+  if (!isAvailableMoney(money)) return null;
+  if (formatter) return formatter(money);
+  return new Intl.NumberFormat(void 0, {
+    style: "currency",
+    currency: money.currencyCode
+  }).format(Number(money.amount));
+}
+
+// src/lib/cart.ts
+function resolveAbsoluteQuantity(currentQuantity, delta) {
+  return Math.max(1, currentQuantity + delta);
+}
+
+// src/lib/contracts.ts
 var PRODUCT_IMAGE_FALLBACK = "data:image/svg+xml;charset=utf-8," + encodeURIComponent(
   `<svg xmlns='http://www.w3.org/2000/svg' width='600' height='600'><rect width='100%' height='100%' fill='#e2e8f0'/><g fill='none' stroke='#94a3b8' stroke-width='12' stroke-linecap='round'><path d='M150 300h300M300 150v300'/><path d='M220 230h50M220 300h50M220 370h50'/><path d='M330 230h50M330 300h50M330 370h50'/></g></svg>`
 );
+var moneySchema = z.object({
+  amount: z.string(),
+  currencyCode: z.string()
+});
+var imageSchema = z.object({
+  id: z.string().optional(),
+  url: z.string(),
+  altText: z.string(),
+  width: z.number().optional(),
+  height: z.number().optional()
+});
+var selectedOptionSchema = z.object({
+  name: z.string(),
+  value: z.string()
+});
+var productDetailVariantSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  sku: z.string().optional(),
+  availableForSale: z.boolean(),
+  selectedOptions: z.array(selectedOptionSchema),
+  /** Omit or null when the backend has no resolved price (purchase disabled). */
+  price: moneySchema.nullish(),
+  compareAtPrice: moneySchema.optional(),
+  image: imageSchema.optional()
+});
+var productDetailProductSchema = z.object({
+  id: z.string(),
+  handle: z.string().optional(),
+  title: z.string(),
+  description: z.string().optional(),
+  vendor: z.string().optional(),
+  options: z.array(z.object({ id: z.string(), name: z.string(), values: z.array(z.string()) })),
+  variants: z.array(productDetailVariantSchema),
+  images: z.array(imageSchema),
+  featuredImage: imageSchema.optional()
+});
+var productOverview1PropsSchema = z.object({
+  product: productDetailProductSchema,
+  selectedVariantId: z.string().nullable().optional(),
+  quantity: z.number().optional(),
+  rating: z.object({ value: z.number(), count: z.number() }).optional(),
+  deliveryEstimate: z.string().optional(),
+  shipping: moneySchema.optional(),
+  sizesLabel: z.string().optional(),
+  variantLabel: z.string().optional(),
+  reviewsLabel: z.string().optional(),
+  addToCartLabel: z.string().optional(),
+  outOfStockLabel: z.string().optional(),
+  unavailablePriceLabel: z.string().optional(),
+  selectVariantLabel: z.string().optional(),
+  quantityLabel: z.string().optional(),
+  deliveryEstimateLabel: z.string().optional(),
+  shippingLabel: z.string().optional()
+});
 var cardProductSchema = z.object({
   id: z.union([z.string(), z.number()]),
   title: z.string(),
@@ -18,8 +98,20 @@ var cartItemSchema = z.object({
   name: z.string(),
   price: z.number(),
   quantity: z.number().int().min(0),
-  image: z.string(),
-  variant: z.string().optional()
+  /** Optional; absent images are omitted, never serialized as `""`. */
+  image: z.string().optional(),
+  variant: z.string().optional(),
+  /** Canonical backend per-unit price, preferred for display when present. */
+  unitPrice: moneySchema.optional(),
+  /** Canonical backend line total, preferred over `price * quantity`. */
+  lineTotal: moneySchema.optional()
+});
+var cartTotalsSchema = z.object({
+  subtotal: moneySchema,
+  discount: moneySchema.optional(),
+  tax: moneySchema.optional(),
+  shipping: moneySchema.optional(),
+  total: moneySchema
 });
 var recentlyViewedItemSchema = z.object({
   id: z.string(),
@@ -50,10 +142,11 @@ var utilityLinkSchema = z.object({
 var navCartItemSchema = z.object({
   id: z.string(),
   name: z.string(),
-  variant: z.string(),
+  variant: z.string().optional(),
   price: z.number(),
   qty: z.number().int().min(0),
-  image: z.string()
+  /** Optional; absent images are omitted, never serialized as `""`. */
+  image: z.string().optional()
 });
 var storeUserSchema = z.object({
   name: z.string(),
@@ -113,13 +206,22 @@ var shoppingCart4PropsSchema = z.object({
   items: z.array(cartItemSchema),
   promotions: z.array(promotionSchema).default([]),
   recentlyViewed: z.array(recentlyViewedItemSchema).optional(),
+  /** Backend-authoritative totals; rendered verbatim, never computed locally. */
+  totals: cartTotalsSchema.optional(),
+  totalsState: z.enum(["idle", "pending", "error"]).optional(),
+  totalsErrorLabel: z.string().optional(),
+  totalsUnavailableLabel: z.string().optional(),
+  amountUnavailableLabel: z.string().optional(),
+  retryLabel: z.string().optional(),
   taxRate: z.number().optional(),
   titleLabel: z.string().optional(),
   subtotalLabel: z.string().optional(),
+  discountLabel: z.string().optional(),
   taxLabel: z.string().optional(),
   shippingLabel: z.string().optional(),
   shippingFreeLabel: z.string().optional(),
   totalLabel: z.string().optional(),
+  totalsPendingLabel: z.string().optional(),
   awayFromLabel: z.string().optional(),
   activatedLabel: z.string().optional(),
   itemsLabel: z.string().optional(),
@@ -133,7 +235,23 @@ var shoppingCart4PropsSchema = z.object({
   expandLabel: z.string().optional(),
   checkoutLabel: z.string().optional(),
   quickCheckoutLabel: z.string().optional(),
-  checkoutNowLabel: z.string().optional()
+  checkoutNowLabel: z.string().optional(),
+  emptyLabel: z.string().optional(),
+  removeLabel: z.string().optional(),
+  decreaseLabel: z.string().optional(),
+  increaseLabel: z.string().optional()
+});
+var logoAccentSchema = z.object({
+  text: z.string(),
+  className: z.string().optional()
+});
+var brandAccentSchema = z.object({
+  text: z.string(),
+  className: z.string().optional()
+});
+var heroImageSchema = z.object({
+  src: z.string(),
+  alt: z.string()
 });
 var navbar4PropsSchema = z.object({
   storeCategories: z.array(storeCategorySchema),
@@ -141,24 +259,72 @@ var navbar4PropsSchema = z.object({
   utilityLinks: z.array(utilityLinkSchema),
   logoText: z.string(),
   logoHref: z.string().optional(),
+  /** Optional accent for a trailing segment of `logoText`; omitted → unchanged. */
+  logoAccent: logoAccentSchema.optional(),
+  /**
+   * Consumer-supplied classes merged onto the block's outer surface as the
+   * final argument (e.g. a semantic surface token). Omitted → unchanged.
+   */
+  className: z.string().optional(),
   accountHref: z.string().optional(),
   searchQuery: z.string().optional(),
   items: z.array(navCartItemSchema).optional(),
+  /** Authoritative backend subtotal for the mini-cart. */
+  subtotal: moneySchema.optional(),
+  subtotalUnavailableLabel: z.string().optional(),
   user: storeUserSchema.optional(),
   accountMenuItems: z.array(accountMenuItemSchema).optional()
 });
+var ctaSchema = z.object({
+  label: z.string(),
+  href: z.string().optional()
+});
+var faqItemSchema = z.object({
+  value: z.string(),
+  question: z.string(),
+  answer: z.string()
+});
+var faqBlock1PropsSchema = z.object({
+  items: z.array(faqItemSchema),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  accordionType: z.enum(["single", "multiple"]).optional()
+});
+var ctaSection1PropsSchema = z.object({
+  badgeText: z.string().optional(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  primaryCta: ctaSchema.optional(),
+  secondaryCta: ctaSchema.optional()
+});
 export {
   PRODUCT_IMAGE_FALLBACK,
   accountMenuItemSchema,
+  brandAccentSchema,
   buttonPropsSchema,
   cardProductSchema,
   cartItemSchema,
+  cartTotalsSchema,
+  ctaSchema,
+  ctaSection1PropsSchema,
+  faqBlock1PropsSchema,
+  faqItemSchema,
+  formatMoney,
+  heroImageSchema,
+  isAvailableMoney,
+  isCompleteFiniteDecimal,
+  logoAccentSchema,
+  moneySchema,
   navCartItemSchema,
   navbar4PropsSchema,
   paymentMethodSchema,
   productCard1PropsSchema,
+  productDetailProductSchema,
+  productDetailVariantSchema,
+  productOverview1PropsSchema,
   promotionSchema,
   recentlyViewedItemSchema,
+  resolveAbsoluteQuantity,
   shoppingCart4PropsSchema,
   storeCategorySchema,
   storeContainer1PropsSchema,