@cimplify/sdk 0.9.9 → 0.10.0

package/registry/index.json

@@ -0,0 +1,411 @@
+{
+  "components": [
+    {
+      "name": "price",
+      "title": "Price",
+      "description": "Renders a formatted price in the display currency.",
+      "type": "component",
+      "registryDependencies": []
+    },
+    {
+      "name": "quantity-selector",
+      "title": "QuantitySelector",
+      "description": "Controlled increment/decrement quantity input.",
+      "type": "component",
+      "registryDependencies": []
+    },
+    {
+      "name": "variant-selector",
+      "title": "VariantSelector",
+      "description": "Select product variants via axis chips or direct list.",
+      "type": "component",
+      "registryDependencies": [
+        "price"
+      ]
+    },
+    {
+      "name": "add-on-selector",
+      "title": "AddOnSelector",
+      "description": "Modifier groups with single-select or multi-select options.",
+      "type": "component",
+      "registryDependencies": [
+        "price"
+      ]
+    },
+    {
+      "name": "bundle-selector",
+      "title": "BundleSelector",
+      "description": "Bundle component picker with variant choices and price summary.",
+      "type": "component",
+      "registryDependencies": [
+        "price"
+      ]
+    },
+    {
+      "name": "composite-selector",
+      "title": "CompositeSelector",
+      "description": "Composite product builder with group constraints and live pricing.",
+      "type": "component",
+      "registryDependencies": [
+        "price"
+      ]
+    },
+    {
+      "name": "product-customizer",
+      "title": "ProductCustomizer",
+      "description": "Full product configuration with variants, add-ons, and add-to-cart.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "quantity-selector",
+        "variant-selector",
+        "add-on-selector",
+        "composite-selector",
+        "bundle-selector"
+      ]
+    },
+    {
+      "name": "product-image-gallery",
+      "title": "ProductImageGallery",
+      "description": "Main image with thumbnail strip for product images.",
+      "type": "component",
+      "registryDependencies": []
+    },
+    {
+      "name": "cart-summary",
+      "title": "CartSummary",
+      "description": "Cart line items with quantity controls and totals.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "quantity-selector"
+      ]
+    },
+    {
+      "name": "availability-badge",
+      "title": "AvailabilityBadge",
+      "description": "Displays in-stock / out-of-stock status for tracked products.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "sale-badge",
+      "title": "SaleBadge",
+      "description": "Sale/discount indicator with percentage and original price.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "product-sheet",
+      "title": "ProductSheet",
+      "description": "Full product detail view with gallery, header, and customizer.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "product-image-gallery",
+        "product-customizer",
+        "cn"
+      ]
+    },
+    {
+      "name": "product-card",
+      "title": "ProductCard",
+      "description": "Product display card with modal or link mode.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "product-sheet",
+        "cn"
+      ]
+    },
+    {
+      "name": "product-grid",
+      "title": "ProductGrid",
+      "description": "Responsive CSS grid that renders ProductCards.",
+      "type": "component",
+      "registryDependencies": [
+        "product-card",
+        "cn"
+      ]
+    },
+    {
+      "name": "cn",
+      "title": "cn",
+      "description": "Utility that merges Tailwind CSS classes with clsx + tailwind-merge.",
+      "type": "utility",
+      "registryDependencies": []
+    },
+    {
+      "name": "search-input",
+      "title": "SearchInput",
+      "description": "Search bar with debounced results dropdown.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "category-filter",
+      "title": "CategoryFilter",
+      "description": "Selectable category chips for filtering products.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "discount-input",
+      "title": "DiscountInput",
+      "description": "Discount code input with inline validation.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "category-grid",
+      "title": "CategoryGrid",
+      "description": "Responsive grid of category cards.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "deal-banner",
+      "title": "DealBanner",
+      "description": "Displays active deals and promotions.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "order-summary",
+      "title": "OrderSummary",
+      "description": "Single order detail view with line items and totals.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "order-history",
+      "title": "OrderHistory",
+      "description": "List of past orders with status and totals.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "store-nav",
+      "title": "StoreNav",
+      "description": "Top navigation bar with brand, categories, cart badge, and search.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "catalogue-page",
+      "title": "CataloguePage",
+      "description": "Browse all products with category filtering and search.",
+      "type": "component",
+      "registryDependencies": [
+        "product-grid",
+        "category-filter",
+        "search-input",
+        "cn"
+      ]
+    },
+    {
+      "name": "product-page",
+      "title": "ProductPage",
+      "description": "Full product detail page with badges and related products.",
+      "type": "component",
+      "registryDependencies": [
+        "product-sheet",
+        "availability-badge",
+        "sale-badge",
+        "product-grid",
+        "cn"
+      ]
+    },
+    {
+      "name": "cart-page",
+      "title": "CartPage",
+      "description": "Full-page cart with summary, discount input, and checkout.",
+      "type": "component",
+      "registryDependencies": [
+        "cart-summary",
+        "discount-input",
+        "cn"
+      ]
+    },
+    {
+      "name": "checkout-page",
+      "title": "CheckoutPage",
+      "description": "Multi-step checkout with auth, address, and payment.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "collection-page",
+      "title": "CollectionPage",
+      "description": "Curated product collection with header and grid.",
+      "type": "component",
+      "registryDependencies": [
+        "product-grid",
+        "cn"
+      ]
+    },
+    {
+      "name": "order-detail-page",
+      "title": "OrderDetailPage",
+      "description": "Single order detail view with live status polling.",
+      "type": "component",
+      "registryDependencies": [
+        "order-summary",
+        "cn"
+      ]
+    },
+    {
+      "name": "order-history-page",
+      "title": "OrderHistoryPage",
+      "description": "Order list with status filtering and inline detail view.",
+      "type": "component",
+      "registryDependencies": [
+        "order-history",
+        "order-summary",
+        "cn"
+      ]
+    },
+    {
+      "name": "search-page",
+      "title": "SearchPage",
+      "description": "Dedicated search page with input and results grid.",
+      "type": "component",
+      "registryDependencies": [
+        "product-grid",
+        "cn"
+      ]
+    },
+    {
+      "name": "deals-page",
+      "title": "DealsPage",
+      "description": "Promotions landing page with deal banners and on-sale products.",
+      "type": "component",
+      "registryDependencies": [
+        "deal-banner",
+        "product-grid",
+        "sale-badge",
+        "product-card",
+        "cn"
+      ]
+    },
+    {
+      "name": "slot-picker",
+      "title": "SlotPicker",
+      "description": "Time slot grid for a single day with morning/afternoon/evening grouping.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "date-slot-picker",
+      "title": "DateSlotPicker",
+      "description": "Horizontal date strip with slot picker for service scheduling.",
+      "type": "component",
+      "registryDependencies": [
+        "slot-picker",
+        "cn"
+      ]
+    },
+    {
+      "name": "staff-picker",
+      "title": "StaffPicker",
+      "description": "Staff member selection list with avatar and bio.",
+      "type": "component",
+      "registryDependencies": [
+        "cn"
+      ]
+    },
+    {
+      "name": "booking-card",
+      "title": "BookingCard",
+      "description": "Single booking display with status, time, and action buttons.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "booking-list",
+      "title": "BookingList",
+      "description": "List of booking cards with optional self-fetching.",
+      "type": "component",
+      "registryDependencies": [
+        "booking-card",
+        "cn"
+      ]
+    },
+    {
+      "name": "booking-page",
+      "title": "BookingPage",
+      "description": "Full booking flow with date/slot picker, staff selection, and cart integration.",
+      "type": "component",
+      "registryDependencies": [
+        "date-slot-picker",
+        "staff-picker",
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "bookings-page",
+      "title": "BookingsPage",
+      "description": "Booking history with filter tabs and inline detail view.",
+      "type": "component",
+      "registryDependencies": [
+        "booking-list",
+        "booking-card",
+        "cn"
+      ]
+    },
+    {
+      "name": "service-card",
+      "title": "ServiceCard",
+      "description": "Service display card with image, duration, price, and book action.",
+      "type": "component",
+      "registryDependencies": [
+        "price",
+        "cn"
+      ]
+    },
+    {
+      "name": "service-grid",
+      "title": "ServiceGrid",
+      "description": "Responsive grid of bookable services with self-fetching.",
+      "type": "component",
+      "registryDependencies": [
+        "service-card",
+        "cn"
+      ]
+    }
+  ]
+}

package/registry/order-detail-page.json

@@ -0,0 +1,16 @@
+{
+  "name": "order-detail-page",
+  "title": "OrderDetailPage",
+  "description": "Single order detail view with live status polling.",
+  "type": "component",
+  "registryDependencies": [
+    "order-summary",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "order-detail-page.tsx",
+      "content": "\"use client\";\n\nimport React from \"react\";\nimport type { Order, LineItem } from \"@cimplify/sdk\";\nimport { OrderSummary } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nexport interface OrderDetailPageClassNames {\n  root?: string;\n  header?: string;\n  title?: string;\n  backButton?: string;\n  summary?: string;\n}\n\nexport interface OrderDetailPageProps {\n  /** Order ID to display. */\n  orderId: string;\n  /** Pre-fetched order for SSR. */\n  order?: Order;\n  /** Poll for status updates. Default: true. */\n  poll?: boolean;\n  /** Called when back button is clicked. */\n  onBack?: () => void;\n  /** Custom line item renderer. */\n  renderLineItem?: (item: LineItem) => React.ReactNode;\n  /** Back button label. */\n  backLabel?: string;\n  className?: string;\n  classNames?: OrderDetailPageClassNames;\n}\n\n/**\n * OrderDetailPage — single order detail view with live status polling.\n *\n * SSR-friendly: pass `order` prop for server rendering.\n */\nexport function OrderDetailPage({\n  orderId,\n  order,\n  poll = true,\n  onBack,\n  renderLineItem,\n  backLabel = \"Back to orders\",\n  className,\n  classNames,\n}: OrderDetailPageProps): React.ReactElement {\n  return (\n    <div data-cimplify-order-detail-page className={cn(className, classNames?.root)}>\n      {/* Header */}\n      <div data-cimplify-order-detail-header className={classNames?.header}>\n        {onBack && (\n          <button\n            type=\"button\"\n            onClick={onBack}\n            data-cimplify-order-detail-back\n            className={classNames?.backButton}\n          >\n            {backLabel}\n          </button>\n        )}\n        <h1 data-cimplify-order-detail-title className={classNames?.title}>\n          Order Details\n        </h1>\n      </div>\n\n      {/* Order summary */}\n      <div data-cimplify-order-detail-content className={classNames?.summary}>\n        <OrderSummary\n          order={order}\n          orderId={order ? undefined : orderId}\n          poll={poll}\n          renderLineItem={renderLineItem}\n        />\n      </div>\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/order-history-page.json

@@ -0,0 +1,17 @@
+{
+  "name": "order-history-page",
+  "title": "OrderHistoryPage",
+  "description": "Order list with status filtering and inline detail view.",
+  "type": "component",
+  "registryDependencies": [
+    "order-history",
+    "order-summary",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "order-history-page.tsx",
+      "content": "\"use client\";\n\nimport React, { useState, useCallback } from \"react\";\nimport type { Order, OrderStatus } from \"@cimplify/sdk\";\nimport { OrderHistory } from \"@cimplify/sdk/react\";\nimport { OrderSummary } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nexport interface OrderHistoryPageClassNames {\n  root?: string;\n  header?: string;\n  title?: string;\n  filters?: string;\n  filterButton?: string;\n  list?: string;\n  detail?: string;\n  backButton?: string;\n}\n\nexport interface OrderHistoryPageProps {\n  /** Page title. */\n  title?: string;\n  /** Pre-fetched orders for SSR. */\n  orders?: Order[];\n  /** Max orders to show per page. */\n  limit?: number;\n  /** Called when navigating to an order detail (e.g. for routing). */\n  onOrderNavigate?: (order: Order) => void;\n  /** Show status filter tabs. Default: true. */\n  showFilters?: boolean;\n  /** Custom order row renderer. */\n  renderOrder?: (order: Order) => React.ReactNode;\n  className?: string;\n  classNames?: OrderHistoryPageClassNames;\n}\n\nconst STATUS_FILTERS: { label: string; value: OrderStatus | undefined }[] = [\n  { label: \"All\", value: undefined },\n  { label: \"Active\", value: \"confirmed\" },\n  { label: \"Completed\", value: \"completed\" },\n  { label: \"Cancelled\", value: \"cancelled\" },\n];\n\n/**\n * OrderHistoryPage — order list with inline detail view and status filtering.\n *\n * SSR-friendly: pass `orders` prop for server rendering.\n * Supports both inline detail view and external navigation via `onOrderNavigate`.\n */\nexport function OrderHistoryPage({\n  title = \"Order History\",\n  orders: ordersProp,\n  limit = 20,\n  onOrderNavigate,\n  showFilters = true,\n  renderOrder,\n  className,\n  classNames,\n}: OrderHistoryPageProps): React.ReactElement {\n  const [statusFilter, setStatusFilter] = useState<OrderStatus | undefined>(undefined);\n  const [selectedOrder, setSelectedOrder] = useState<Order | null>(null);\n\n  const handleOrderClick = useCallback(\n    (order: Order) => {\n      if (onOrderNavigate) {\n        onOrderNavigate(order);\n      } else {\n        setSelectedOrder(order);\n      }\n    },\n    [onOrderNavigate],\n  );\n\n  const handleBack = useCallback(() => {\n    setSelectedOrder(null);\n  }, []);\n\n  // Inline detail view\n  if (selectedOrder && !onOrderNavigate) {\n    return (\n      <div data-cimplify-order-history-page className={cn(className, classNames?.root)}>\n        <div data-cimplify-order-history-detail className={classNames?.detail}>\n          <button\n            type=\"button\"\n            onClick={handleBack}\n            data-cimplify-order-history-back\n            className={classNames?.backButton}\n          >\n            Back to orders\n          </button>\n          <OrderSummary order={selectedOrder} />\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div data-cimplify-order-history-page className={cn(className, classNames?.root)}>\n      {/* Header */}\n      <div data-cimplify-order-history-header className={classNames?.header}>\n        <h1 data-cimplify-order-history-title className={classNames?.title}>\n          {title}\n        </h1>\n      </div>\n\n      {/* Status filter */}\n      {showFilters && (\n        <div data-cimplify-order-history-filters className={classNames?.filters} role=\"tablist\">\n          {STATUS_FILTERS.map((filter) => (\n            <button\n              key={filter.label}\n              type=\"button\"\n              role=\"tab\"\n              aria-selected={statusFilter === filter.value}\n              onClick={() => setStatusFilter(filter.value)}\n              data-cimplify-order-filter\n              data-selected={statusFilter === filter.value || undefined}\n              className={classNames?.filterButton}\n            >\n              {filter.label}\n            </button>\n          ))}\n        </div>\n      )}\n\n      {/* Order list */}\n      <div data-cimplify-order-history-list className={classNames?.list}>\n        <OrderHistory\n          orders={ordersProp}\n          status={statusFilter}\n          limit={limit}\n          onOrderClick={handleOrderClick}\n          renderOrder={renderOrder}\n        />\n      </div>\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/order-history.json

@@ -0,0 +1,16 @@
+{
+  "name": "order-history",
+  "title": "OrderHistory",
+  "description": "List of past orders with status and totals.",
+  "type": "component",
+  "registryDependencies": [
+    "price",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "order-history.tsx",
+      "content": "\"use client\";\n\nimport React from \"react\";\nimport type { Order, OrderStatus } from \"@cimplify/sdk\";\nimport { useOrders } from \"@cimplify/sdk/react\";\nimport { Price } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nexport interface OrderHistoryClassNames {\n  root?: string;\n  item?: string;\n  orderId?: string;\n  status?: string;\n  date?: string;\n  total?: string;\n  empty?: string;\n  loading?: string;\n}\n\nexport interface OrderHistoryProps {\n  /** Override orders (skips fetch). For SSR, pass pre-fetched orders. */\n  orders?: Order[];\n  /** Filter by status. */\n  status?: OrderStatus;\n  /** Max orders to display. */\n  limit?: number;\n  /** Called when an order row is clicked. */\n  onOrderClick?: (order: Order) => void;\n  /** Custom order row renderer. */\n  renderOrder?: (order: Order) => React.ReactNode;\n  /** Text shown when empty. */\n  emptyMessage?: string;\n  className?: string;\n  classNames?: OrderHistoryClassNames;\n}\n\nconst STATUS_LABELS: Record<OrderStatus, string> = {\n  pending: \"Pending\",\n  created: \"Created\",\n  confirmed: \"Confirmed\",\n  in_preparation: \"In Preparation\",\n  ready_to_serve: \"Ready\",\n  partially_served: \"Partially Served\",\n  served: \"Served\",\n  delivered: \"Delivered\",\n  picked_up: \"Picked Up\",\n  completed: \"Completed\",\n  cancelled: \"Cancelled\",\n  refunded: \"Refunded\",\n};\n\n/**\n * OrderHistory — list of past orders with status and totals.\n *\n * Fetches via `useOrders` unless pre-loaded orders are passed.\n */\nexport function OrderHistory({\n  orders: ordersProp,\n  status,\n  limit,\n  onOrderClick,\n  renderOrder,\n  emptyMessage = \"No orders yet\",\n  className,\n  classNames,\n}: OrderHistoryProps): React.ReactElement {\n  const { orders: fetched, isLoading } = useOrders({\n    status,\n    limit,\n    enabled: ordersProp === undefined,\n  });\n\n  const orders = ordersProp ?? fetched;\n\n  if (isLoading && orders.length === 0) {\n    return (\n      <div\n        data-cimplify-order-history\n        aria-busy=\"true\"\n        className={cn(className, classNames?.root, classNames?.loading)}\n      />\n    );\n  }\n\n  if (orders.length === 0) {\n    return (\n      <div\n        data-cimplify-order-history\n        data-empty\n        className={cn(className, classNames?.root, classNames?.empty)}\n      >\n        <p>{emptyMessage}</p>\n      </div>\n    );\n  }\n\n  return (\n    <div data-cimplify-order-history className={cn(className, classNames?.root)}>\n      {orders.map((order) => (\n        <button\n          key={order.id}\n          type=\"button\"\n          onClick={() => onOrderClick?.(order)}\n          data-cimplify-order-history-item\n          data-status={order.status}\n          className={classNames?.item}\n        >\n          {renderOrder ? (\n            renderOrder(order)\n          ) : (\n            <>\n              <div data-cimplify-order-history-main>\n                <span data-cimplify-order-history-id className={classNames?.orderId}>\n                  #{order.user_friendly_id}\n                </span>\n                <span\n                  data-cimplify-order-history-status\n                  data-status={order.status}\n                  className={classNames?.status}\n                >\n                  {STATUS_LABELS[order.status] ?? order.status}\n                </span>\n              </div>\n              <div data-cimplify-order-history-details>\n                <time\n                  data-cimplify-order-history-date\n                  dateTime={order.created_at}\n                  className={classNames?.date}\n                >\n                  {new Date(order.created_at).toLocaleDateString()}\n                </time>\n                <span data-cimplify-order-history-items>\n                  {order.total_quantity} {order.total_quantity === 1 ? \"item\" : \"items\"}\n                </span>\n                <span data-cimplify-order-history-total className={classNames?.total}>\n                  <Price amount={order.total_price} />\n                </span>\n              </div>\n            </>\n          )}\n        </button>\n      ))}\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/order-summary.json

@@ -0,0 +1,16 @@
+{
+  "name": "order-summary",
+  "title": "OrderSummary",
+  "description": "Single order detail view with line items and totals.",
+  "type": "component",
+  "registryDependencies": [
+    "price",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "order-summary.tsx",
+      "content": "\"use client\";\n\nimport React from \"react\";\nimport type { Order, LineItem, OrderStatus } from \"@cimplify/sdk\";\nimport { useOrder } from \"@cimplify/sdk/react\";\nimport { Price } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nexport interface OrderSummaryClassNames {\n  root?: string;\n  header?: string;\n  orderId?: string;\n  status?: string;\n  items?: string;\n  lineItem?: string;\n  totals?: string;\n  customer?: string;\n  loading?: string;\n}\n\nexport interface OrderSummaryProps {\n  /** Pass an Order object directly (skips fetch). */\n  order?: Order;\n  /** Or pass an order ID to fetch via useOrder. */\n  orderId?: string;\n  /** Poll for status updates. */\n  poll?: boolean;\n  /** Custom line item renderer. */\n  renderLineItem?: (item: LineItem) => React.ReactNode;\n  className?: string;\n  classNames?: OrderSummaryClassNames;\n}\n\nconst STATUS_LABELS: Record<OrderStatus, string> = {\n  pending: \"Pending\",\n  created: \"Created\",\n  confirmed: \"Confirmed\",\n  in_preparation: \"In Preparation\",\n  ready_to_serve: \"Ready\",\n  partially_served: \"Partially Served\",\n  served: \"Served\",\n  delivered: \"Delivered\",\n  picked_up: \"Picked Up\",\n  completed: \"Completed\",\n  cancelled: \"Cancelled\",\n  refunded: \"Refunded\",\n};\n\n/**\n * OrderSummary — displays a single order's details, line items, and totals.\n *\n * Accepts either a pre-loaded `order` object or an `orderId` to fetch.\n * Supports polling for live status updates.\n */\nexport function OrderSummary({\n  order: orderProp,\n  orderId,\n  poll = false,\n  renderLineItem,\n  className,\n  classNames,\n}: OrderSummaryProps): React.ReactElement {\n  const { order: fetched, isLoading } = useOrder(orderProp ? null : orderId, {\n    enabled: !orderProp && !!orderId,\n    poll,\n  });\n\n  const order = orderProp ?? fetched;\n\n  if (isLoading && !order) {\n    return (\n      <div\n        data-cimplify-order-summary\n        aria-busy=\"true\"\n        className={cn(className, classNames?.root, classNames?.loading)}\n      >\n        <div data-cimplify-order-summary-skeleton />\n      </div>\n    );\n  }\n\n  if (!order) {\n    return (\n      <div data-cimplify-order-summary className={cn(className, classNames?.root)}>\n        <p>Order not found.</p>\n      </div>\n    );\n  }\n\n  return (\n    <div data-cimplify-order-summary className={cn(className, classNames?.root)}>\n      {/* Header */}\n      <div data-cimplify-order-header className={classNames?.header}>\n        <span data-cimplify-order-id className={classNames?.orderId}>\n          Order #{order.user_friendly_id}\n        </span>\n        <span\n          data-cimplify-order-status\n          data-status={order.status}\n          className={classNames?.status}\n        >\n          {STATUS_LABELS[order.status] ?? order.status}\n        </span>\n      </div>\n\n      {/* Date */}\n      <time data-cimplify-order-date dateTime={order.created_at}>\n        {new Date(order.created_at).toLocaleDateString(undefined, {\n          year: \"numeric\",\n          month: \"long\",\n          day: \"numeric\",\n          hour: \"2-digit\",\n          minute: \"2-digit\",\n        })}\n      </time>\n\n      {/* Customer info */}\n      {(order.customer_name || order.customer_email) && (\n        <div data-cimplify-order-customer className={classNames?.customer}>\n          {order.customer_name && (\n            <span data-cimplify-order-customer-name>{order.customer_name}</span>\n          )}\n          {order.customer_email && (\n            <span data-cimplify-order-customer-email>{order.customer_email}</span>\n          )}\n        </div>\n      )}\n\n      {/* Line items */}\n      <div data-cimplify-order-items className={classNames?.items}>\n        {order.items.map((item) =>\n          renderLineItem ? (\n            <React.Fragment key={item.id}>{renderLineItem(item)}</React.Fragment>\n          ) : (\n            <div key={item.id} data-cimplify-order-line-item className={classNames?.lineItem}>\n              <div data-cimplify-order-line-info>\n                <span data-cimplify-order-line-qty>{item.quantity}&times;</span>\n                <span data-cimplify-order-line-key>{item.line_key}</span>\n              </div>\n              <Price amount={item.price} />\n            </div>\n          ),\n        )}\n      </div>\n\n      {/* Totals */}\n      <div data-cimplify-order-totals className={classNames?.totals}>\n        {order.total_discount != null && order.total_discount !== 0 && (\n          <div data-cimplify-order-discount>\n            <span>Discount</span>\n            <Price amount={order.total_discount} prefix=\"-\" />\n          </div>\n        )}\n        {order.service_charge != null && order.service_charge !== 0 && (\n          <div data-cimplify-order-service-charge>\n            <span>Service charge</span>\n            <Price amount={order.service_charge} />\n          </div>\n        )}\n        {order.tax != null && order.tax !== 0 && (\n          <div data-cimplify-order-tax>\n            <span>Tax</span>\n            <Price amount={order.tax} />\n          </div>\n        )}\n        <div data-cimplify-order-total>\n          <span>Total</span>\n          <Price amount={order.total_price} />\n        </div>\n      </div>\n\n      {/* Tracking */}\n      {order.tracking_link && (\n        <a\n          href={order.tracking_link}\n          target=\"_blank\"\n          rel=\"noopener noreferrer\"\n          data-cimplify-order-tracking\n        >\n          Track your order\n        </a>\n      )}\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/price.json

@@ -0,0 +1,13 @@
+{
+  "name": "price",
+  "title": "Price",
+  "description": "Renders a formatted price in the display currency.",
+  "type": "component",
+  "registryDependencies": [],
+  "files": [
+    {
+      "path": "price.tsx",
+      "content": "\"use client\";\n\nimport React from \"react\";\nimport { formatPrice } from \"@cimplify/sdk\";\nimport type { CurrencyCode } from \"@cimplify/sdk\";\nimport { useCimplify } from \"@cimplify/sdk/react\";\n\nexport interface PriceProps {\n  /** The amount in base (business) currency. */\n  amount: number | string;\n  /** Optional CSS class name for the wrapping span. */\n  className?: string;\n  /** Optional prefix rendered before the formatted price (e.g. \"+\"). */\n  prefix?: string;\n}\n\n/**\n * Price — renders a single price value in the user's chosen display currency.\n *\n * Reads `displayCurrency` and `convertPrice` from CimplifyProvider context\n * so every price on the page stays consistent with the selected currency.\n */\nexport function Price({ amount, className, prefix }: PriceProps): React.ReactElement {\n  const { displayCurrency, convertPrice } = useCimplify();\n  return (\n    <span className={className}>\n      {prefix}\n      {formatPrice(convertPrice(amount), displayCurrency as CurrencyCode)}\n    </span>\n  );\n}\n"
+    }
+  ]
+}

package/registry/product-card.json

@@ -0,0 +1,17 @@
+{
+  "name": "product-card",
+  "title": "ProductCard",
+  "description": "Product display card with modal or link mode.",
+  "type": "component",
+  "registryDependencies": [
+    "price",
+    "product-sheet",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "product-card.tsx",
+      "content": "\"use client\";\n\nimport React, { useCallback, useRef, useState } from \"react\";\nimport type { Product, ProductWithDetails } from \"@cimplify/sdk\";\nimport { useProduct } from \"@cimplify/sdk/react\";\nimport { Price } from \"@cimplify/sdk/react\";\nimport { ProductSheet } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nconst ASPECT_STYLES: Record<string, React.CSSProperties> = {\n  square: { aspectRatio: \"1/1\" },\n  \"4/3\": { aspectRatio: \"4/3\" },\n  \"16/10\": { aspectRatio: \"16/10\" },\n  \"3/4\": { aspectRatio: \"3/4\" },\n};\n\nexport interface ProductCardClassNames {\n  root?: string;\n  imageContainer?: string;\n  image?: string;\n  body?: string;\n  name?: string;\n  description?: string;\n  price?: string;\n  badges?: string;\n  badge?: string;\n  modal?: string;\n  modalOverlay?: string;\n}\n\nexport interface ProductCardProps {\n  /** The product to display. */\n  product: Product;\n  /** Display mode: \"card\" opens a modal, \"page\" renders as a link. Auto-detected from product.display_mode. */\n  displayMode?: \"card\" | \"page\";\n  /** Link href for page mode. Default: `/menu/${product.slug}` */\n  href?: string;\n  /** Custom modal content renderer. Receives the fully-loaded product. */\n  renderModal?: (product: ProductWithDetails) => React.ReactNode;\n  /** Custom image renderer (e.g. Next.js Image). */\n  renderImage?: (props: {\n    src: string;\n    alt: string;\n    className?: string;\n  }) => React.ReactNode;\n  /** Replace the entire default card body. */\n  children?: React.ReactNode;\n  /** Image aspect ratio. Default: \"4/3\". */\n  aspectRatio?: \"square\" | \"4/3\" | \"16/10\" | \"3/4\";\n  className?: string;\n  classNames?: ProductCardClassNames;\n}\n\n/**\n * ProductCard — a product display card with two modes:\n *\n * - **card** (default): clickable button that opens a native `<dialog>` modal with a ProductSheet\n * - **page**: a plain `<a>` link for SEO-friendly product pages\n */\nexport function ProductCard({\n  product,\n  displayMode,\n  href,\n  renderModal,\n  renderImage,\n  children,\n  aspectRatio = \"4/3\",\n  className,\n  classNames,\n}: ProductCardProps): React.ReactElement {\n  const mode = displayMode ?? product.display_mode ?? \"card\";\n  const [isOpen, setIsOpen] = useState(false);\n  const dialogRef = useRef<HTMLDialogElement>(null);\n\n  // Lazy-fetch product details only when modal is open\n  const { product: productDetails } = useProduct(\n    product.slug ?? product.id,\n    { enabled: isOpen },\n  );\n\n  const handleOpen = useCallback(() => {\n    setIsOpen(true);\n    dialogRef.current?.showModal();\n  }, []);\n\n  const handleClose = useCallback(() => {\n    dialogRef.current?.close();\n    setIsOpen(false);\n  }, []);\n\n  const handleCancel = useCallback(() => {\n    setIsOpen(false);\n  }, []);\n\n  const handleBackdropClick = useCallback(\n    (e: React.MouseEvent<HTMLDialogElement>) => {\n      if (e.target === dialogRef.current) {\n        handleClose();\n      }\n    },\n    [handleClose],\n  );\n\n  const imageUrl = product.image_url || product.images?.[0];\n\n  const cardBody = children ?? (\n    <>\n      {/* Image */}\n      {imageUrl && (\n        <div\n          data-cimplify-product-card-image-container\n          className={classNames?.imageContainer}\n          style={{\n            overflow: \"hidden\",\n            ...ASPECT_STYLES[aspectRatio],\n          }}\n        >\n          {renderImage ? (\n            renderImage({\n              src: imageUrl,\n              alt: product.name,\n              className: classNames?.image,\n            })\n          ) : (\n            <img\n              src={imageUrl}\n              alt={product.name}\n              className={classNames?.image}\n              style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n              data-cimplify-product-card-image\n            />\n          )}\n        </div>\n      )}\n\n      {/* Body */}\n      <div\n        data-cimplify-product-card-body\n        className={classNames?.body}\n      >\n        <span\n          data-cimplify-product-card-name\n          className={classNames?.name}\n        >\n          {product.name}\n        </span>\n        {product.description && (\n          <span\n            data-cimplify-product-card-description\n            className={classNames?.description}\n            style={{\n              display: \"-webkit-box\",\n              WebkitLineClamp: 2,\n              WebkitBoxOrient: \"vertical\",\n              overflow: \"hidden\",\n            }}\n          >\n            {product.description}\n          </span>\n        )}\n        <Price\n          amount={product.default_price}\n          className={classNames?.price}\n        />\n      </div>\n    </>\n  );\n\n  // Page mode — render as a link\n  if (mode === \"page\") {\n    return (\n      <a\n        href={href ?? `/menu/${product.slug}`}\n        data-cimplify-product-card\n        data-display-mode=\"page\"\n        className={cn(className, classNames?.root)}\n        style={{ display: \"block\", textDecoration: \"none\", color: \"inherit\" }}\n      >\n        {cardBody}\n      </a>\n    );\n  }\n\n  // Card mode — render as button + native dialog\n  return (\n    <>\n      <button\n        type=\"button\"\n        aria-haspopup=\"dialog\"\n        onClick={handleOpen}\n        data-cimplify-product-card\n        data-display-mode=\"card\"\n        className={cn(className, classNames?.root)}\n        style={{\n          display: \"block\",\n          width: \"100%\",\n          textAlign: \"inherit\",\n          background: \"none\",\n          border: \"none\",\n          padding: 0,\n          cursor: \"pointer\",\n          font: \"inherit\",\n          color: \"inherit\",\n        }}\n      >\n        {cardBody}\n      </button>\n\n      <dialog\n        ref={dialogRef}\n        onCancel={handleCancel}\n        onClick={handleBackdropClick}\n        data-cimplify-product-card-modal\n        className={classNames?.modal}\n        style={{\n          border: \"none\",\n          borderRadius: \"0.75rem\",\n          padding: \"1.5rem\",\n          maxWidth: \"32rem\",\n          width: \"100%\",\n          maxHeight: \"90vh\",\n          overflow: \"auto\",\n        }}\n      >\n        {isOpen && (\n          productDetails ? (\n            renderModal ? (\n              renderModal(productDetails)\n            ) : (\n              <ProductSheet\n                product={productDetails}\n                onClose={handleClose}\n                renderImage={renderImage}\n              />\n            )\n          ) : (\n            <div\n              data-cimplify-product-card-modal-loading\n              aria-busy=\"true\"\n              style={{\n                display: \"flex\",\n                flexDirection: \"column\",\n                gap: \"1rem\",\n              }}\n            >\n              <div\n                style={{\n                  aspectRatio: \"4/3\",\n                  backgroundColor: \"rgba(0,0,0,0.06)\",\n                  borderRadius: \"0.5rem\",\n                }}\n              />\n              <div\n                style={{\n                  height: \"1.5rem\",\n                  width: \"60%\",\n                  backgroundColor: \"rgba(0,0,0,0.06)\",\n                  borderRadius: \"0.25rem\",\n                }}\n              />\n            </div>\n          )\n        )}\n      </dialog>\n    </>\n  );\n}\n"
+    }
+  ]
+}

package/registry/product-customizer.json

@@ -0,0 +1,20 @@
+{
+  "name": "product-customizer",
+  "title": "ProductCustomizer",
+  "description": "Full product configuration with variants, add-ons, and add-to-cart.",
+  "type": "component",
+  "registryDependencies": [
+    "price",
+    "quantity-selector",
+    "variant-selector",
+    "add-on-selector",
+    "composite-selector",
+    "bundle-selector"
+  ],
+  "files": [
+    {
+      "path": "product-customizer.tsx",
+      "content": "\"use client\";\n\nimport React, { useState, useCallback, useMemo, useEffect } from \"react\";\nimport type {\n  ProductWithDetails,\n  ProductVariant,\n  AddOnOption,\n  ComponentSelectionInput,\n  CompositePriceResult,\n} from \"@cimplify/sdk\";\nimport type { BundleSelectionInput } from \"@cimplify/sdk\";\nimport { parsePrice } from \"@cimplify/sdk\";\nimport { useCart, useQuote } from \"@cimplify/sdk/react\";\nimport type { AddToCartOptions } from \"@cimplify/sdk/react\";\nimport { Price } from \"@cimplify/sdk/react\";\nimport { QuantitySelector } from \"@cimplify/sdk/react\";\nimport { VariantSelector } from \"@cimplify/sdk/react\";\nimport { AddOnSelector } from \"@cimplify/sdk/react\";\nimport { CompositeSelector } from \"@cimplify/sdk/react\";\nimport { BundleSelector } from \"@cimplify/sdk/react\";\n\nexport interface ProductCustomizerProps {\n  product: ProductWithDetails;\n  onAddToCart?: (\n    product: ProductWithDetails,\n    quantity: number,\n    options: AddToCartOptions,\n  ) => void | Promise<void>;\n  className?: string;\n}\n\nexport function ProductCustomizer({\n  product,\n  onAddToCart,\n  className,\n}: ProductCustomizerProps): React.ReactElement {\n  const [quantity, setQuantity] = useState(1);\n  const [isAdded, setIsAdded] = useState(false);\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  const [selectedVariantId, setSelectedVariantId] = useState<string | undefined>();\n  const [selectedVariant, setSelectedVariant] = useState<ProductVariant | undefined>();\n  const [selectedAddOnOptionIds, setSelectedAddOnOptionIds] = useState<string[]>([]);\n\n  const [compositeSelections, setCompositeSelections] = useState<ComponentSelectionInput[]>([]);\n  const [compositePrice, setCompositePrice] = useState<CompositePriceResult | null>(null);\n  const [compositeReady, setCompositeReady] = useState(false);\n\n  const [bundleSelections, setBundleSelections] = useState<BundleSelectionInput[]>([]);\n  const [bundleTotalPrice, setBundleTotalPrice] = useState<number | null>(null);\n  const [bundleReady, setBundleReady] = useState(false);\n\n  const cart = useCart();\n\n  const productType = product.type || \"product\";\n  const isComposite = productType === \"composite\";\n  const isBundle = productType === \"bundle\";\n  const isStandard = !isComposite && !isBundle;\n\n  const hasVariants = isStandard && product.variants && product.variants.length > 0;\n  const hasAddOns = isStandard && product.add_ons && product.add_ons.length > 0;\n\n  useEffect(() => {\n    setQuantity(1);\n    setIsAdded(false);\n    setIsSubmitting(false);\n    setSelectedVariantId(undefined);\n    setSelectedVariant(undefined);\n    setSelectedAddOnOptionIds([]);\n    setCompositeSelections([]);\n    setCompositePrice(null);\n    setCompositeReady(false);\n    setBundleSelections([]);\n    setBundleTotalPrice(null);\n    setBundleReady(false);\n  }, [product.id]);\n\n  const selectedAddOnOptions = useMemo(() => {\n    if (!product.add_ons) return [];\n    const options: AddOnOption[] = [];\n    for (const addOn of product.add_ons) {\n      for (const option of addOn.options) {\n        if (selectedAddOnOptionIds.includes(option.id)) {\n          options.push(option);\n        }\n      }\n    }\n    return options;\n  }, [product.add_ons, selectedAddOnOptionIds]);\n\n  const normalizedAddOnOptionIds = useMemo(() => {\n    if (selectedAddOnOptionIds.length === 0) return [];\n    return Array.from(new Set(selectedAddOnOptionIds.map((id) => id.trim()).filter(Boolean))).sort();\n  }, [selectedAddOnOptionIds]);\n\n  const localTotalPrice = useMemo(() => {\n    if (isComposite && compositePrice) {\n      return parsePrice(compositePrice.final_price) * quantity;\n    }\n\n    if (isBundle && bundleTotalPrice != null) {\n      return bundleTotalPrice * quantity;\n    }\n\n    let price = parsePrice(product.default_price);\n\n    if (selectedVariant?.price_adjustment) {\n      price += parsePrice(selectedVariant.price_adjustment);\n    }\n\n    for (const option of selectedAddOnOptions) {\n      if (option.default_price) {\n        price += parsePrice(option.default_price);\n      }\n    }\n\n    return price * quantity;\n  }, [product.default_price, selectedVariant, selectedAddOnOptions, quantity, isComposite, compositePrice, isBundle, bundleTotalPrice]);\n\n  const requiredAddOnsSatisfied = useMemo(() => {\n    if (!product.add_ons) return true;\n\n    for (const addOn of product.add_ons) {\n      if (addOn.is_required) {\n        const selectedInGroup = selectedAddOnOptionIds.filter((id) =>\n          addOn.options.some((opt) => opt.id === id),\n        ).length;\n\n        const minRequired = addOn.min_selections || 1;\n        if (selectedInGroup < minRequired) {\n          return false;\n        }\n      }\n    }\n    return true;\n  }, [product.add_ons, selectedAddOnOptionIds]);\n\n  const quoteInput = useMemo(\n    () => ({\n      productId: product.id,\n      quantity,\n      variantId: selectedVariantId,\n      addOnOptionIds: normalizedAddOnOptionIds.length > 0 ? normalizedAddOnOptionIds : undefined,\n      bundleSelections: isBundle && bundleSelections.length > 0 ? bundleSelections : undefined,\n      compositeSelections: isComposite && compositeSelections.length > 0 ? compositeSelections : undefined,\n    }),\n    [product.id, quantity, selectedVariantId, normalizedAddOnOptionIds, isBundle, bundleSelections, isComposite, compositeSelections],\n  );\n\n  const quoteEnabled = isComposite\n    ? compositeReady\n    : isBundle\n      ? bundleReady\n      : requiredAddOnsSatisfied;\n\n  const { quote } = useQuote(quoteInput, {\n    enabled: quoteEnabled,\n  });\n\n  const quoteId = quote?.quote_id;\n  const quotedTotalPrice = useMemo(() => {\n    if (!quote) return undefined;\n    const quotedTotal =\n      quote.quoted_total_price_info?.final_price ?? quote.final_price_info.final_price;\n    return quotedTotal === undefined || quotedTotal === null ? undefined : parsePrice(quotedTotal);\n  }, [quote]);\n\n  const displayTotalPrice = quotedTotalPrice ?? localTotalPrice;\n\n  const handleVariantChange = useCallback(\n    (variantId: string | undefined, variant: ProductVariant | undefined) => {\n      setSelectedVariantId(variantId);\n      setSelectedVariant(variant);\n    },\n    [],\n  );\n\n  const handleAddToCart = async () => {\n    if (isSubmitting) return;\n\n    setIsSubmitting(true);\n\n    const options: AddToCartOptions = {\n      variantId: selectedVariantId,\n      variant: selectedVariant\n        ? { id: selectedVariant.id, name: selectedVariant.name || \"\", price_adjustment: selectedVariant.price_adjustment }\n        : undefined,\n      quoteId,\n      addOnOptionIds: normalizedAddOnOptionIds.length > 0 ? normalizedAddOnOptionIds : undefined,\n      addOnOptions: selectedAddOnOptions.length > 0\n        ? selectedAddOnOptions.map((opt) => ({\n            id: opt.id,\n            name: opt.name,\n            add_on_id: opt.add_on_id,\n            default_price: opt.default_price,\n          }))\n        : undefined,\n      compositeSelections: isComposite && compositeSelections.length > 0 ? compositeSelections : undefined,\n      bundleSelections: isBundle && bundleSelections.length > 0 ? bundleSelections : undefined,\n    };\n\n    try {\n      if (onAddToCart) {\n        await onAddToCart(product, quantity, options);\n      } else {\n        await cart.addItem(product, quantity, options);\n      }\n      setIsAdded(true);\n      setTimeout(() => {\n        setIsAdded(false);\n        setQuantity(1);\n      }, 2000);\n    } catch {\n      // Caller handles errors via onAddToCart or cart hook error state\n    } finally {\n      setIsSubmitting(false);\n    }\n  };\n\n  return (\n    <div data-cimplify-customizer className={className}>\n      {isComposite && product.groups && product.composite_id && (\n        <CompositeSelector\n          compositeId={product.composite_id}\n          groups={product.groups}\n          onSelectionsChange={setCompositeSelections}\n          onPriceChange={setCompositePrice}\n          onReady={setCompositeReady}\n          skipPriceFetch\n        />\n      )}\n\n      {isBundle && product.components && (\n        <BundleSelector\n          components={product.components}\n          bundlePrice={product.bundle_price}\n          discountValue={product.discount_value}\n          pricingType={product.pricing_type}\n          onSelectionsChange={setBundleSelections}\n          onPriceChange={setBundleTotalPrice}\n          onReady={setBundleReady}\n        />\n      )}\n\n      {hasVariants && (\n        <VariantSelector\n          variants={product.variants!}\n          variantAxes={product.variant_axes}\n          basePrice={product.default_price}\n          selectedVariantId={selectedVariantId}\n          onVariantChange={handleVariantChange}\n        />\n      )}\n\n      {hasAddOns && (\n        <AddOnSelector\n          addOns={product.add_ons!}\n          selectedOptions={selectedAddOnOptionIds}\n          onOptionsChange={setSelectedAddOnOptionIds}\n        />\n      )}\n\n      <div data-cimplify-customizer-actions>\n        <QuantitySelector\n          value={quantity}\n          onChange={setQuantity}\n          min={1}\n        />\n\n        <button\n          type=\"button\"\n          onClick={handleAddToCart}\n          disabled={isAdded || isSubmitting || !quoteEnabled}\n          aria-describedby={!quoteEnabled ? \"cimplify-customizer-validation\" : undefined}\n          data-cimplify-customizer-submit\n        >\n          {isAdded ? \"Added to Cart\" : (\n            <>\n              Add to Cart &middot; <Price amount={displayTotalPrice} />\n            </>\n          )}\n        </button>\n      </div>\n\n      {!quoteEnabled && (\n        <p id=\"cimplify-customizer-validation\" data-cimplify-customizer-validation>Please select all required options</p>\n      )}\n    </div>\n  );\n}\n"
+    }
+  ]
+}

package/registry/product-grid.json

@@ -0,0 +1,16 @@
+{
+  "name": "product-grid",
+  "title": "ProductGrid",
+  "description": "Responsive CSS grid that renders ProductCards.",
+  "type": "component",
+  "registryDependencies": [
+    "product-card",
+    "cn"
+  ],
+  "files": [
+    {
+      "path": "product-grid.tsx",
+      "content": "\"use client\";\n\nimport React from \"react\";\nimport type { Product } from \"@cimplify/sdk\";\nimport { ProductCard } from \"@cimplify/sdk/react\";\nimport { cn } from \"@cimplify/sdk/react\";\n\nexport interface ProductGridClassNames {\n  root?: string;\n  item?: string;\n  empty?: string;\n}\n\nexport interface ProductGridProps {\n  /** Products to display in the grid. */\n  products: Product[];\n  /** Responsive column counts at each breakpoint. */\n  columns?: { sm?: number; md?: number; lg?: number; xl?: number };\n  /** Custom card renderer per product. */\n  renderCard?: (product: Product) => React.ReactNode;\n  /** Custom image renderer passed to default ProductCards. */\n  renderImage?: (props: {\n    src: string;\n    alt: string;\n    className?: string;\n  }) => React.ReactNode;\n  /** Text shown when `products` is empty. */\n  emptyMessage?: string;\n  className?: string;\n  classNames?: ProductGridClassNames;\n}\n\n/**\n * ProductGrid — responsive CSS grid that renders ProductCards.\n *\n * Injects an inline `<style>` tag with media queries for responsive columns.\n * Uses `React.useId()` for a hydration-safe, collision-free CSS selector.\n */\nexport function ProductGrid({\n  products,\n  columns,\n  renderCard,\n  renderImage,\n  emptyMessage,\n  className,\n  classNames,\n}: ProductGridProps): React.ReactElement {\n  const rawId = React.useId();\n  // CSS selectors can't contain colons, so strip them from the React-generated ID\n  const gridId = `cimplify-grid-${rawId.replace(/:/g, \"\")}`;\n\n  const sm = columns?.sm ?? 1;\n  const md = columns?.md ?? 2;\n  const lg = columns?.lg ?? 3;\n  const xl = columns?.xl ?? 4;\n\n  if (products.length === 0) {\n    return (\n      <div\n        data-cimplify-product-grid\n        data-empty\n        className={cn(className, classNames?.root, classNames?.empty)}\n      >\n        <p>{emptyMessage ?? \"No products found\"}</p>\n      </div>\n    );\n  }\n\n  const css = [\n    `#${gridId}{display:grid;grid-template-columns:repeat(${sm},1fr);gap:1rem}`,\n    `@media(min-width:768px){#${gridId}{grid-template-columns:repeat(${md},1fr)}}`,\n    `@media(min-width:1024px){#${gridId}{grid-template-columns:repeat(${lg},1fr)}}`,\n    `@media(min-width:1280px){#${gridId}{grid-template-columns:repeat(${xl},1fr)}}`,\n  ].join(\"\");\n\n  return (\n    <>\n      <style dangerouslySetInnerHTML={{ __html: css }} />\n      <div\n        id={gridId}\n        data-cimplify-product-grid\n        className={cn(className, classNames?.root)}\n      >\n        {products.map((product) => (\n          <div\n            key={product.id}\n            data-cimplify-product-grid-item\n            className={classNames?.item}\n          >\n            {renderCard\n              ? renderCard(product)\n              : (\n                <ProductCard\n                  product={product}\n                  renderImage={renderImage}\n                />\n              )}\n          </div>\n        ))}\n      </div>\n    </>\n  );\n}\n"
+    }
+  ]
+}

package/registry/product-image-gallery.json

@@ -0,0 +1,13 @@
+{
+  "name": "product-image-gallery",
+  "title": "ProductImageGallery",
+  "description": "Main image with thumbnail strip for product images.",
+  "type": "component",
+  "registryDependencies": [],
+  "files": [
+    {
+      "path": "product-image-gallery.tsx",
+      "content": "\"use client\";\n\nimport React, { useEffect, useMemo, useState } from \"react\";\n\nexport interface ProductImageGalleryProps {\n  images: string[];\n  productName: string;\n  aspectRatio?: \"square\" | \"4/3\" | \"16/10\" | \"3/4\";\n  className?: string;\n}\n\nconst ASPECT_STYLES: Record<string, React.CSSProperties> = {\n  square: { aspectRatio: \"1/1\" },\n  \"4/3\": { aspectRatio: \"4/3\" },\n  \"16/10\": { aspectRatio: \"16/10\" },\n  \"3/4\": { aspectRatio: \"3/4\" },\n};\n\n/**\n * ProductImageGallery — main image + thumbnail strip.\n *\n * Uses plain `<img>` for framework-agnostic rendering (not Next.js Image).\n */\nexport function ProductImageGallery({\n  images,\n  productName,\n  aspectRatio = \"4/3\",\n  className,\n}: ProductImageGalleryProps): React.ReactElement | null {\n  const normalizedImages = useMemo(\n    () =>\n      images.filter(\n        (image): image is string =>\n          typeof image === \"string\" && image.trim().length > 0,\n      ),\n    [images],\n  );\n\n  const [selectedImage, setSelectedImage] = useState(0);\n\n  useEffect(() => {\n    setSelectedImage(0);\n  }, [normalizedImages.length, productName]);\n\n  if (normalizedImages.length === 0) {\n    return null;\n  }\n\n  const activeImage = normalizedImages[selectedImage] || normalizedImages[0];\n\n  return (\n    <div data-cimplify-image-gallery className={className}>\n      <div\n        data-cimplify-image-gallery-main\n        style={{ position: \"relative\", overflow: \"hidden\", ...ASPECT_STYLES[aspectRatio] }}\n      >\n        <img\n          src={activeImage}\n          alt={productName}\n          style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n          data-cimplify-image-gallery-active\n        />\n      </div>\n\n      {normalizedImages.length > 1 && (\n        <div data-cimplify-image-gallery-thumbnails style={{ display: \"flex\", gap: \"0.5rem\", marginTop: \"0.75rem\" }}>\n          {normalizedImages.map((image, index) => (\n            <button\n              key={`${image}-${index}`}\n              type=\"button\"\n              onClick={() => setSelectedImage(index)}\n              aria-selected={selectedImage === index}\n              data-cimplify-image-gallery-thumb\n              data-selected={selectedImage === index || undefined}\n              style={{\n                width: \"4rem\",\n                height: \"4rem\",\n                overflow: \"hidden\",\n                padding: 0,\n                border: \"none\",\n                cursor: \"pointer\",\n              }}\n            >\n              <img\n                src={image}\n                alt=\"\"\n                style={{ width: \"100%\", height: \"100%\", objectFit: \"cover\" }}\n              />\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"
+    }
+  ]
+}