create-nymbal-app 0.4.0 → 0.5.0

package/scaffold/templates/astro/src/scripts/pdp.ts

@@ -1,6 +1,26 @@
-import { STOCK_LABELS, stockLevel } from '@nymbalhq/types'
+import { NymbalAddToCart } from '@nymbalhq/web-components/elements/nymbal-add-to-cart'
+import { NymbalBreadcrumb } from '@nymbalhq/web-components/elements/nymbal-breadcrumb'
+import { NymbalImageGallery } from '@nymbalhq/web-components/elements/nymbal-image-gallery'
+import { NymbalProductGrid } from '@nymbalhq/web-components/elements/nymbal-product-grid'
+import { NymbalProductPrice } from '@nymbalhq/web-components/elements/nymbal-product-price'
+import { NymbalQuantitySelector } from '@nymbalhq/web-components/elements/nymbal-quantity-selector'
+import { NymbalReviewForm } from '@nymbalhq/web-components/elements/nymbal-review-form'
+import { NymbalReviewList } from '@nymbalhq/web-components/elements/nymbal-review-list'
+import { NymbalStockBadge } from '@nymbalhq/web-components/elements/nymbal-stock-badge'
+import { NymbalVariantSelector } from '@nymbalhq/web-components/elements/nymbal-variant-selector'
 import { client } from '../lib/client.js'
-import { formatPrice } from '../lib/format.js'
+
+NymbalBreadcrumb.define()
+NymbalImageGallery.define()
+NymbalProductPrice.define()
+NymbalStockBadge.define()
+NymbalVariantSelector.define()
+NymbalQuantitySelector.define()
+NymbalAddToCart.define()
+NymbalReviewList.define()
+NymbalReviewForm.define()
+// The related grid is there only when the product has relations.
+if (document.querySelector('nymbal-product-grid') !== null) NymbalProductGrid.define()
 
 const slug = document.querySelector<HTMLElement>('[data-product-slug]')?.dataset.productSlug
 const addRow = document.querySelector<HTMLElement>('.pdp-add-row')
@@ -20,32 +40,15 @@ if (slug) {
     addToCart?.setAttribute('qty', String(e.detail.value))
   }) as EventListener)
 
+  // The price and the stock badge follow the store themselves; the add row is the page's.
   client.product.subscribe(() => {
     const { product, selectedVariant } = client.product.getState()
     if (!product) return
     const variant = selectedVariant ?? product.variants?.[0]
 
-    const priceEl = document.querySelector('[data-testid="product-price"]')
-    if (priceEl) {
-      const price = formatPrice(
-        variant?.priceMinor ?? product.priceMinor ?? 0,
-        product.currency ?? 'GBP',
-      )
-      priceEl.innerHTML = `<span>${price}</span>`
-    }
-
-    const stock = variant?.stock ?? 0
-    const level = stockLevel(stock)
-    const badge = document.querySelector<HTMLElement>('[data-testid="stock-badge"]')
-    if (badge) {
-      badge.dataset.level = level
-      const label = badge.querySelector('[data-stock-label]')
-      if (label) label.textContent = STOCK_LABELS[level]
-    }
-
     if (addToCart && variant) {
       addToCart.setAttribute('variant-id', variant.id)
-      addToCart.toggleAttribute('disabled', stock <= 0)
+      addToCart.toggleAttribute('disabled', (variant.stock ?? 0) <= 0)
     }
 
     if (variant && variant.id !== shownVariantId) {

package/scaffold/templates/astro/src/scripts/plp.ts

@@ -1,98 +1,25 @@
 import type { ProductSortKey } from '@nymbalhq/types'
+import { NymbalBreadcrumb } from '@nymbalhq/web-components/elements/nymbal-breadcrumb'
+import { NymbalProductFilter } from '@nymbalhq/web-components/elements/nymbal-product-filter'
+import { NymbalProductGrid } from '@nymbalhq/web-components/elements/nymbal-product-grid'
+import { NymbalSortDropdown } from '@nymbalhq/web-components/elements/nymbal-sort-dropdown'
 import { client } from '../lib/client.js'
-import { escapeHtml, formatPrice } from '../lib/format.js'
 
-const gridContainer = document.getElementById('product-grid')
+NymbalBreadcrumb.define()
+NymbalProductFilter.define()
+NymbalSortDropdown.define()
+NymbalProductGrid.define()
+
+const grid = document.querySelector<HTMLElement>('nymbal-product-grid')
 const sortDropdown = document.querySelector('nymbal-sort-dropdown')
-const loadMoreBtn = document.getElementById('load-more-btn')
-const countEl = document.getElementById('product-count')
 
 // A category page carries its category in the path, which the server render puts on the grid; /products may carry
-// one in the query. The server render puts the sort it resolved from the URL on the dropdown's `value`.
-const urlParams = new URLSearchParams(window.location.search)
-const initialCategory = gridContainer?.dataset.category ?? urlParams.get('category') ?? undefined
+// one in the query. The server render puts the sort it resolved from the URL on the dropdown's `value`. The grid shows
+// the server's page until this load settles, then follows the store (sort, filter, load more).
+const initialCategory =
+  grid?.dataset.category ?? new URLSearchParams(window.location.search).get('category') ?? undefined
 const initialSort = (sortDropdown?.getAttribute('value') || 'newest') as ProductSortKey
-
-function renderProductCard(product: any): string {
-  const imageUrl =
-    product.imageUrl ??
-    (Array.isArray(product.media) && product.media[0]?.url) ??
-    `https://picsum.photos/seed/${product.slug}/600/600`
-  // The "from" price, which the price sorts order by.
-  const fromMinor = product.priceRange?.minMinor ?? product.priceMinor
-  const price = fromMinor != null ? formatPrice(fromMinor, product.currency ?? 'GBP') : ''
-
-  const slug = escapeHtml(product.slug)
-  const name = escapeHtml(product.name)
-
-  return `
-    <a href="/product/${slug}" class="product-card" data-testid="product-card-${slug}">
-      <img
-        src="${escapeHtml(imageUrl)}"
-        alt="${name}"
-        class="product-card-image"
-        loading="lazy"
-        width="600"
-        height="600"
-      />
-      <div class="product-card-body">
-        <span class="product-card-name">${name}</span>
-        ${price ? `<span class="product-card-price">${escapeHtml(price)}</span>` : ''}
-      </div>
-    </a>
-  `
-}
-
-function renderGrid() {
-  const state = client.productList.getState()
-  const products = state.products ?? []
-
-  if (!gridContainer) return
-
-  // Don't overwrite the grid with an empty state while a load is in flight.
-  // This prevents the SSR content from being replaced by "No products found"
-  // during the brief window between applyFilter setting filters and the API
-  // responding with the filtered set.
-  if (products.length === 0 && state.loading) return
-
-  if (products.length === 0) {
-    gridContainer.innerHTML = `
-      <div class="plp-empty">
-        <h2 class="plp-empty-title">No products found</h2>
-        <p class="plp-empty-text">Try adjusting your filters or search terms.</p>
-      </div>
-    `
-  } else {
-    gridContainer.innerHTML = products.map(renderProductCard).join('')
-  }
-
-  // Update count
-  if (countEl) {
-    countEl.textContent = `${products.length} product${products.length === 1 ? '' : 's'}`
-  }
-
-  // Toggle load more
-  if (loadMoreBtn) {
-    loadMoreBtn.style.display = state.pagination.hasMore ? '' : 'none'
-  }
-}
-
-// The first load's own answer is the server-rendered grid, so it is not re-rendered: subscribing after it keeps the
-// subscription to re-renders (sort, filter, load-more). A sort or filter chosen while it was in flight reached the
-// store with nothing subscribed, so that state is rendered here.
-async function init() {
-  await client.productList.load({ limit: 24, category: initialCategory, sort: initialSort })
-  client.productList.subscribe(renderGrid)
-  const state = client.productList.getState()
-  const filters = Object.entries(state.filters)
-  const changed =
-    state.sort !== initialSort ||
-    filters.length !== (initialCategory === undefined ? 0 : 1) ||
-    filters.some(([name, value]) => name !== 'category' || value !== initialCategory)
-  if (state.loading || changed) renderGrid()
-}
-
-void init()
+void client.productList.load({ limit: 24, category: initialCategory, sort: initialSort })
 
 // The element's event, not its select's `change`: the select may be the element's own rather than the server's.
 // The URL carries the sort, so a reload or a shared link renders the same order server-side.
@@ -103,8 +30,3 @@ sortDropdown?.addEventListener('nymbal:sort:changed', (e) => {
   window.history.replaceState(window.history.state, '', url)
   void client.productList.setSort(sort)
 })
-
-// Load more handler
-loadMoreBtn?.addEventListener('click', () => {
-  client.productList.loadMore()
-})

package/scaffold/templates/astro/src/scripts/search.ts

@@ -1,143 +1,19 @@
+import { NymbalProductFilter } from '@nymbalhq/web-components/elements/nymbal-product-filter'
+import { NymbalSearchResults } from '@nymbalhq/web-components/elements/nymbal-search-results'
 import { client } from '../lib/client.js'
-import { formatPrice } from '../lib/format.js'
 
-const resultsContainer = document.getElementById('search-results')
-const queryLabel = document.getElementById('search-query-label')
-const searchInput = document.getElementById('search-input') as HTMLInputElement | null
-
-/** Builds an element; dynamic values go in through setAttribute and text nodes, never through markup. */
-function el(
-  tag: string,
-  attrs: Record<string, string> = {},
-  ...children: (Node | string)[]
-): HTMLElement {
-  const node = document.createElement(tag)
-  for (const [name, value] of Object.entries(attrs)) node.setAttribute(name, value)
-  node.append(...children)
-  return node
-}
-
-function renderProductCard(product: any): HTMLElement {
-  const slug = String(product.slug ?? '')
-  const name = String(product.name ?? '')
-  const imageUrl =
-    product.imageUrl ??
-    (Array.isArray(product.media) && product.media[0]?.url) ??
-    `https://picsum.photos/seed/${encodeURIComponent(slug)}/600/600`
-  const price =
-    product.priceMinor != null ? formatPrice(product.priceMinor, product.currency ?? 'GBP') : ''
-
-  const body = el(
-    'div',
-    { class: 'product-card-body' },
-    el('span', { class: 'product-card-name' }, name),
-  )
-  if (price) body.append(el('span', { class: 'product-card-price' }, price))
-
-  return el(
-    'a',
-    {
-      href: `/product/${encodeURIComponent(slug)}`,
-      class: 'product-card',
-      'data-testid': `product-card-${slug}`,
-    },
-    el('img', {
-      src: String(imageUrl),
-      alt: name,
-      class: 'product-card-image',
-      loading: 'lazy',
-      width: '600',
-      height: '600',
-    }),
-    body,
-  )
-}
-
-function renderResults() {
-  const state = client.search.getState()
-  const results = state.results ?? []
-  const query = state.query ?? ''
-  // A load-more or category change keeps the results shown until its answer replaces them.
-  const isLoading = (state.loading ?? false) && results.length === 0
-
-  if (!resultsContainer) return
-
-  // Update query label
-  if (queryLabel) {
-    if (query) {
-      queryLabel.replaceChildren('Results for ', el('strong', {}, `"${query}"`))
-      queryLabel.style.display = ''
-    } else {
-      queryLabel.style.display = 'none'
-    }
-  }
+NymbalProductFilter.define()
+NymbalSearchResults.define()
 
-  if (isLoading) {
-    resultsContainer.innerHTML = `
-      <div class="search-loading">Searching...</div>
-    `
-    return
-  }
-
-  if (!query) {
-    resultsContainer.innerHTML = `
-      <div class="search-empty">
-        <div class="search-empty-icon" aria-hidden="true">&#128269;</div>
-        <h2 class="search-empty-title">Search our store</h2>
-        <p class="search-empty-text">Type a keyword to find products.</p>
-      </div>
-    `
-    return
-  }
-
-  if (results.length === 0) {
-    resultsContainer.innerHTML = `
-      <div class="search-empty">
-        <div class="search-empty-icon" aria-hidden="true">&#128269;</div>
-        <h2 class="search-empty-title">No results found</h2>
-        <p class="search-empty-text">Try a different search term or browse our categories.</p>
-      </div>
-    `
-    return
-  }
-
-  const total = state.total
-  const children: HTMLElement[] = [
-    el(
-      'div',
-      { class: 'search-results-header' },
-      el(
-        'span',
-        { class: 'search-result-count', 'data-testid': 'search-total' },
-        `${total} result${total === 1 ? '' : 's'}`,
-      ),
-    ),
-    el('div', { class: 'product-grid' }, ...results.map(renderProductCard)),
-  ]
-  if (state.nextCursor !== null) {
-    const loadMore = el(
-      'button',
-      { type: 'button', class: 'btn btn-secondary', 'data-testid': 'search-load-more' },
-      state.loading ? 'Loading...' : 'Load more',
-    ) as HTMLButtonElement
-    loadMore.disabled = state.loading
-    loadMore.addEventListener('click', () => void client.search.loadMore())
-    children.push(el('div', { class: 'plp-pagination' }, loadMore))
-  }
-  resultsContainer.replaceChildren(...children)
-}
-
-client.search.subscribe(renderResults)
+// The page owns the term and the category: the URL and the search input search, `nymbal-search-results` renders.
+const searchInput = document.getElementById('search-input') as HTMLInputElement | null
 
-// Read initial query and category from URL
 const urlParams = new URLSearchParams(window.location.search)
 const initialQuery = urlParams.get('q')
 
 if (initialQuery) {
   if (searchInput) searchInput.value = initialQuery
   client.search.search(initialQuery, { category: urlParams.get('category') })
-} else {
-  renderResults()
 }
 
 // The category filter has narrowed the search; the URL follows, beside ?q.
@@ -149,12 +25,11 @@ document.addEventListener('nymbal:filter:changed', (event) => {
   window.history.replaceState({}, '', url.toString())
 })
 
-// Listen for search input changes: a new query searches every category again.
+// A new query searches every category again.
 searchInput?.addEventListener('input', () => {
   const value = searchInput.value.trim()
   if (value.length >= 2) {
     client.search.search(value)
-    // Update URL without reload
     const url = new URL(window.location.href)
     url.searchParams.set('q', value)
     url.searchParams.delete('category')

package/scaffold/templates/astro/src/scripts/signed-in-redirect.ts

@@ -0,0 +1,4 @@
+// Signed in or registered: on to the page that sent the shopper here (`?redirect`), or the account.
+document.addEventListener('nymbal:auth:signed-in', () => {
+  window.location.href = new URLSearchParams(window.location.search).get('redirect') ?? '/account'
+})

package/scaffold/templates/astro/src/styles/global.css

@@ -1,9 +1,9 @@
 /* ----------------------------------------------------------------
    Nymbal Global Styles
-   Built on @nymbalhq/web-components design tokens (--nymbal-*)
+   Built on the design tokens in tokens.css (--nymbal-*)
    ---------------------------------------------------------------- */
 
-@import '@nymbalhq/web-components/tokens.css';
+@import './tokens.css';
 
 /* ---- Reset ---- */
 
@@ -23,7 +23,15 @@ html {
 }
 
 body {
-  font-family: var(--nymbal-font-family, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
+  font-family: var(
+    --nymbal-font-family,
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    Roboto,
+    sans-serif
+  );
   font-size: var(--nymbal-font-size-base, 1rem);
   font-weight: var(--nymbal-font-weight-normal, 400);
   line-height: 1.6;
@@ -68,7 +76,12 @@ a {
   text-decoration: none;
 }
 
-h1, h2, h3, h4, h5, h6 {
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
   line-height: 1.2;
   font-weight: var(--nymbal-font-weight-bold, 700);
   overflow-wrap: break-word;
@@ -84,12 +97,24 @@ table {
 
 /* ---- Base typography ---- */
 
-h1 { font-size: 2rem; }
-h2 { font-size: 1.5rem; }
-h3 { font-size: 1.25rem; }
-h4 { font-size: 1.125rem; }
-h5 { font-size: 1rem; }
-h6 { font-size: var(--nymbal-font-size-sm, 0.875rem); }
+h1 {
+  font-size: 2rem;
+}
+h2 {
+  font-size: 1.5rem;
+}
+h3 {
+  font-size: 1.25rem;
+}
+h4 {
+  font-size: 1.125rem;
+}
+h5 {
+  font-size: 1rem;
+}
+h6 {
+  font-size: var(--nymbal-font-size-sm, 0.875rem);
+}
 
 small {
   font-size: var(--nymbal-font-size-sm, 0.875rem);
@@ -277,13 +302,13 @@ a:not([class]):focus-visible {
 /* ---- Form inputs ---- */
 
 .input,
-input[type="text"],
-input[type="email"],
-input[type="password"],
-input[type="search"],
-input[type="tel"],
-input[type="url"],
-input[type="number"],
+input[type='text'],
+input[type='email'],
+input[type='password'],
+input[type='search'],
+input[type='tel'],
+input[type='url'],
+input[type='number'],
 select,
 textarea {
   display: block;
@@ -302,13 +327,13 @@ textarea {
 }
 
 .input:focus,
-input[type="text"]:focus,
-input[type="email"]:focus,
-input[type="password"]:focus,
-input[type="search"]:focus,
-input[type="tel"]:focus,
-input[type="url"]:focus,
-input[type="number"]:focus,
+input[type='text']:focus,
+input[type='email']:focus,
+input[type='password']:focus,
+input[type='search']:focus,
+input[type='tel']:focus,
+input[type='url']:focus,
+input[type='number']:focus,
 select:focus,
 textarea:focus {
   outline: none;
@@ -339,24 +364,3 @@ label {
   color: var(--nymbal-color-error, #dc2626);
   margin-top: var(--nymbal-spacing-xs, 0.25rem);
 }
-
-/* ---- Product grid ---- */
-
-.product-grid {
-  display: grid;
-  gap: var(--nymbal-spacing-md, 1rem);
-  grid-template-columns: 1fr;
-}
-
-@media (min-width: 641px) {
-  .product-grid {
-    grid-template-columns: repeat(2, 1fr);
-    gap: var(--nymbal-spacing-lg, 1.5rem);
-  }
-}
-
-@media (min-width: 1025px) {
-  .product-grid {
-    grid-template-columns: repeat(4, 1fr);
-  }
-}

package/scaffold/templates/astro/src/styles/pages/account.css

@@ -60,26 +60,6 @@
   max-width: 32rem;
 }
 
-.account-form-actions {
-  display: flex;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-top: var(--nymbal-spacing-lg, 1.5rem);
-  padding-top: var(--nymbal-spacing-lg, 1.5rem);
-  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.account-form-row {
-  display: grid;
-  grid-template-columns: 1fr;
-  gap: var(--nymbal-spacing-md, 1rem);
-}
-
-@media (min-width: 641px) {
-  .account-form-row {
-    grid-template-columns: 1fr 1fr;
-  }
-}
-
 /* ---- Order list ---- */
 
 .order-list {
@@ -189,70 +169,6 @@
   text-decoration: underline;
 }
 
-/* ---- Address cards ---- */
-
-.address-list {
-  display: grid;
-  grid-template-columns: 1fr;
-  gap: var(--nymbal-spacing-md, 1rem);
-}
-
-@media (min-width: 641px) {
-  .address-list {
-    grid-template-columns: repeat(2, 1fr);
-  }
-}
-
-.address-card {
-  border: 1px solid var(--nymbal-color-border, #e4e4e7);
-  border-radius: var(--nymbal-radius-lg, 0.75rem);
-  padding: var(--nymbal-spacing-lg, 1.5rem);
-  position: relative;
-}
-
-.address-card.default {
-  border-color: var(--nymbal-color-accent, #2563eb);
-}
-
-.address-card-badge {
-  display: inline-flex;
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-accent, #2563eb);
-  background-color: rgba(37, 99, 235, 0.08);
-  padding: 2px var(--nymbal-spacing-sm, 0.5rem);
-  border-radius: var(--nymbal-radius-full, 9999px);
-  margin-bottom: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.address-card-name {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-bold, 700);
-  color: var(--nymbal-color-primary, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.address-card-line {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  line-height: 1.5;
-}
-
-.address-card-actions {
-  display: flex;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-top: var(--nymbal-spacing-md, 1rem);
-  padding-top: var(--nymbal-spacing-md, 1rem);
-  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.address-card-actions button,
-.address-card-actions a {
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  padding: var(--nymbal-spacing-xs, 0.25rem) var(--nymbal-spacing-sm, 0.5rem);
-}
-
 /* ---- Auth pages (login/register) ---- */
 
 .auth-page {
@@ -287,12 +203,6 @@
   margin-bottom: var(--nymbal-spacing-lg, 1.5rem);
 }
 
-.auth-card .btn {
-  width: 100%;
-  justify-content: center;
-  margin-top: var(--nymbal-spacing-sm, 0.5rem);
-}
-
 .auth-footer {
   text-align: center;
   font-size: var(--nymbal-font-size-sm, 0.875rem);

package/scaffold/templates/astro/src/styles/pages/confirmation.css

@@ -44,6 +44,12 @@
 
 /* ---- Order details card ---- */
 
+.confirmation-summary {
+  display: block;
+  margin-bottom: var(--nymbal-spacing-xl, 2rem);
+  text-align: left;
+}
+
 .confirmation-card {
   text-align: left;
   background-color: #fafafa;