create-nymbal-app 0.0.0 → 0.3.0

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

@@ -0,0 +1,109 @@
+import type { ProductSortKey } from '@nymbalhq/types'
+import { client } from '../lib/client.js'
+import { escapeHtml, formatPrice } from '../lib/format.js'
+
+const gridContainer = document.getElementById('product-grid')
+const sortSelect = document.getElementById('sort-select') as HTMLSelectElement | null
+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 also selected the URL's sort in the dropdown.
+const urlParams = new URLSearchParams(window.location.search)
+const initialCategory = gridContainer?.dataset.category ?? urlParams.get('category') ?? undefined
+const initialSort = (sortSelect?.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()
+
+// The URL carries the sort, so a reload or a shared link renders the same order server-side.
+sortSelect?.addEventListener('change', () => {
+  const sort = sortSelect.value as ProductSortKey
+  const url = new URL(window.location.href)
+  url.searchParams.set('sort', sort)
+  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/profile-form.ts

@@ -0,0 +1,57 @@
+import { client } from '../lib/client.js'
+import { submitOnce } from '../lib/submit-once.js'
+
+const form = document.getElementById('profile-form') as HTMLFormElement | null
+const messageEl = document.getElementById('profile-message')
+
+function populateForm() {
+  const profile = client.auth.getState().customer
+  if (!profile) return
+
+  const firstNameEl = document.getElementById('profile-firstName') as HTMLInputElement
+  const lastNameEl = document.getElementById('profile-lastName') as HTMLInputElement
+  const emailEl = document.getElementById('profile-email') as HTMLInputElement
+  const phoneEl = document.getElementById('profile-phone') as HTMLInputElement
+
+  if (firstNameEl) firstNameEl.value = profile.firstName ?? ''
+  if (lastNameEl) lastNameEl.value = profile.lastName ?? ''
+  if (emailEl) emailEl.value = profile.email ?? ''
+  if (phoneEl) phoneEl.value = profile.phone ?? ''
+}
+
+// Load profile data
+async function init() {
+  try {
+    await client.auth.loadProfile()
+  } catch {
+    // ignore
+  }
+  populateForm()
+}
+
+client.auth.subscribe(populateForm)
+init()
+
+submitOnce(form, async () => {
+  if (!form || !messageEl) return
+
+  const firstName = (document.getElementById('profile-firstName') as HTMLInputElement)?.value
+  const lastName = (document.getElementById('profile-lastName') as HTMLInputElement)?.value
+  const phone = (document.getElementById('profile-phone') as HTMLInputElement)?.value
+
+  const submitBtn = form.querySelector('[data-testid="profile-save"]') as HTMLButtonElement | null
+  if (submitBtn) submitBtn.textContent = 'Saving...'
+
+  try {
+    await client.auth.updateProfile({ firstName, lastName, phone })
+    messageEl.textContent = 'Profile updated successfully.'
+    messageEl.style.color = 'var(--nymbal-color-success, #16a34a)'
+    messageEl.style.display = 'block'
+  } catch (err) {
+    messageEl.textContent = err instanceof Error ? err.message : 'Failed to update profile.'
+    messageEl.style.color = 'var(--nymbal-color-error, #dc2626)'
+    messageEl.style.display = 'block'
+  } finally {
+    if (submitBtn) submitBtn.textContent = 'Save Changes'
+  }
+})

package/scaffold/templates/astro/src/scripts/review-form.ts

@@ -0,0 +1,27 @@
+import { client } from '../lib/client.js'
+import { submitOnce } from '../lib/submit-once.js'
+
+const form = document.getElementById('review-form') as HTMLFormElement | null
+const messageEl = document.getElementById('review-form-message')
+
+submitOnce(form, async () => {
+  if (!form || !messageEl) return
+
+  const productId = form.dataset.productId ?? ''
+  const formData = new FormData(form)
+  const rating = Number(formData.get('rating'))
+  const title = String(formData.get('title'))
+  const body = String(formData.get('body'))
+
+  try {
+    await client.adapter.reviews.submit({ productId, rating, title, body })
+    messageEl.textContent = 'Thank you for your review!'
+    messageEl.style.display = 'block'
+    messageEl.style.color = 'var(--nymbal-color-success, #16a34a)'
+    form.reset()
+  } catch {
+    messageEl.textContent = 'Something went wrong. Please try again.'
+    messageEl.style.display = 'block'
+    messageEl.style.color = 'var(--nymbal-color-error, #dc2626)'
+  }
+})

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

@@ -0,0 +1,145 @@
+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 ?? ''
+  const isLoading = state.loading ?? false
+
+  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'
+    }
+  }
+
+  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
+  }
+
+  resultsContainer.replaceChildren(
+    el(
+      'div',
+      { class: 'search-results-header' },
+      el(
+        'span',
+        { class: 'search-result-count' },
+        `${results.length} result${results.length === 1 ? '' : 's'}`,
+      ),
+    ),
+    el('div', { class: 'product-grid' }, ...results.map(renderProductCard)),
+  )
+}
+
+client.search.subscribe(renderResults)
+
+// Read initial query 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)
+} else {
+  renderResults()
+}
+
+// Listen for search input changes
+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)
+    window.history.replaceState({}, '', url.toString())
+  } else if (value.length === 0) {
+    client.search.clearSearch()
+    const url = new URL(window.location.href)
+    url.searchParams.delete('q')
+    window.history.replaceState({}, '', url.toString())
+  }
+})

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

@@ -0,0 +1,362 @@
+/* ----------------------------------------------------------------
+   Nymbal Global Styles
+   Built on @nymbalhq/web-components design tokens (--nymbal-*)
+   ---------------------------------------------------------------- */
+
+@import '@nymbalhq/web-components/tokens.css';
+
+/* ---- Reset ---- */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html {
+  -webkit-text-size-adjust: 100%;
+  -moz-text-size-adjust: 100%;
+  text-size-adjust: 100%;
+  scroll-behavior: smooth;
+}
+
+body {
+  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;
+  color: var(--nymbal-color-text, #18181b);
+  background-color: var(--nymbal-color-surface, #fff);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+img,
+picture,
+video,
+canvas,
+svg {
+  display: block;
+  max-width: 100%;
+}
+
+img {
+  height: auto;
+}
+
+input,
+button,
+textarea,
+select {
+  font: inherit;
+  color: inherit;
+}
+
+button {
+  cursor: pointer;
+}
+
+ul,
+ol {
+  list-style: none;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  line-height: 1.2;
+  font-weight: var(--nymbal-font-weight-bold, 700);
+  overflow-wrap: break-word;
+}
+
+p {
+  overflow-wrap: break-word;
+}
+
+table {
+  border-collapse: collapse;
+}
+
+/* ---- 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); }
+
+small {
+  font-size: var(--nymbal-font-size-sm, 0.875rem);
+}
+
+/* ---- Link styles ---- */
+
+a:not([class]) {
+  color: var(--nymbal-color-accent, #2563eb);
+  text-decoration: underline;
+  text-underline-offset: 2px;
+  transition: color var(--nymbal-transition-fast, 150ms) ease;
+}
+
+a:not([class]):hover {
+  color: var(--nymbal-color-primary, #18181b);
+}
+
+a:not([class]):focus-visible {
+  outline: 2px solid var(--nymbal-color-accent, #2563eb);
+  outline-offset: 2px;
+  border-radius: var(--nymbal-radius-sm, 0.25rem);
+}
+
+/* ---- Skip navigation ---- */
+
+.skip-nav {
+  position: absolute;
+  top: -100%;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: var(--nymbal-z-index-tooltip, 1000);
+  padding: var(--nymbal-spacing-sm, 0.5rem) var(--nymbal-spacing-md, 1rem);
+  background: var(--nymbal-color-primary, #18181b);
+  color: var(--nymbal-color-text-inverse, #fff);
+  font-weight: var(--nymbal-font-weight-medium, 500);
+  border-radius: var(--nymbal-radius-md, 0.5rem);
+  text-decoration: none;
+  transition: top var(--nymbal-transition-fast, 150ms) ease;
+}
+
+.skip-nav:focus {
+  top: var(--nymbal-spacing-sm, 0.5rem);
+  outline: 2px solid var(--nymbal-color-accent, #2563eb);
+  outline-offset: 2px;
+}
+
+/* ---- Layout ---- */
+
+.container {
+  width: 100%;
+  max-width: 72rem;
+  margin-inline: auto;
+  padding-inline: var(--nymbal-spacing-md, 1rem);
+}
+
+@media (min-width: 641px) {
+  .container {
+    padding-inline: var(--nymbal-spacing-lg, 1.5rem);
+  }
+}
+
+.section {
+  padding-block: var(--nymbal-spacing-xl, 2rem);
+}
+
+@media (min-width: 641px) {
+  .section {
+    padding-block: 3rem;
+  }
+}
+
+@media (min-width: 1025px) {
+  .section {
+    padding-block: 4rem;
+  }
+}
+
+.section-title {
+  font-size: 1.5rem;
+  font-weight: var(--nymbal-font-weight-bold, 700);
+  color: var(--nymbal-color-primary, #18181b);
+  margin-bottom: var(--nymbal-spacing-lg, 1.5rem);
+}
+
+@media (min-width: 641px) {
+  .section-title {
+    font-size: 1.75rem;
+  }
+}
+
+/* ---- Accessibility ---- */
+
+.visually-hidden {
+  position: absolute !important;
+  width: 1px !important;
+  height: 1px !important;
+  padding: 0 !important;
+  margin: -1px !important;
+  overflow: hidden !important;
+  clip: rect(0, 0, 0, 0) !important;
+  white-space: nowrap !important;
+  border: 0 !important;
+}
+
+/* ---- Buttons ---- */
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--nymbal-spacing-xs, 0.25rem);
+  padding: var(--nymbal-spacing-sm, 0.5rem) var(--nymbal-spacing-md, 1rem);
+  font-size: var(--nymbal-font-size-sm, 0.875rem);
+  font-weight: var(--nymbal-font-weight-medium, 500);
+  line-height: 1.4;
+  border: 1px solid transparent;
+  border-radius: var(--nymbal-radius-md, 0.5rem);
+  cursor: pointer;
+  transition:
+    background-color var(--nymbal-transition-fast, 150ms) ease,
+    border-color var(--nymbal-transition-fast, 150ms) ease,
+    color var(--nymbal-transition-fast, 150ms) ease,
+    box-shadow var(--nymbal-transition-fast, 150ms) ease;
+  text-decoration: none;
+  white-space: nowrap;
+  user-select: none;
+}
+
+.btn:focus-visible {
+  outline: 2px solid var(--nymbal-color-accent, #2563eb);
+  outline-offset: 2px;
+}
+
+.btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+.btn-primary {
+  background-color: var(--nymbal-color-primary, #18181b);
+  color: var(--nymbal-color-text-inverse, #fff);
+  border-color: var(--nymbal-color-primary, #18181b);
+}
+
+.btn-primary:hover {
+  background-color: #27272a;
+  border-color: #27272a;
+}
+
+.btn-primary:active {
+  background-color: #09090b;
+}
+
+.btn-secondary {
+  background-color: transparent;
+  color: var(--nymbal-color-primary, #18181b);
+  border-color: var(--nymbal-color-border, #e4e4e7);
+}
+
+.btn-secondary:hover {
+  background-color: var(--nymbal-color-border, #e4e4e7);
+}
+
+.btn-secondary:active {
+  background-color: #d4d4d8;
+}
+
+.btn-outline {
+  background-color: transparent;
+  color: var(--nymbal-color-accent, #2563eb);
+  border-color: var(--nymbal-color-accent, #2563eb);
+}
+
+.btn-outline:hover {
+  background-color: var(--nymbal-color-accent, #2563eb);
+  color: var(--nymbal-color-text-inverse, #fff);
+}
+
+.btn-outline:active {
+  background-color: #1d4ed8;
+}
+
+/* ---- Form inputs ---- */
+
+.input,
+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;
+  width: 100%;
+  padding: var(--nymbal-spacing-sm, 0.5rem) var(--nymbal-spacing-md, 1rem);
+  font-size: var(--nymbal-font-size-sm, 0.875rem);
+  line-height: 1.5;
+  color: var(--nymbal-color-text, #18181b);
+  background-color: var(--nymbal-color-surface, #fff);
+  border: 1px solid var(--nymbal-color-border, #e4e4e7);
+  border-radius: var(--nymbal-radius-md, 0.5rem);
+  transition:
+    border-color var(--nymbal-transition-fast, 150ms) ease,
+    box-shadow var(--nymbal-transition-fast, 150ms) ease;
+  appearance: none;
+}
+
+.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,
+select:focus,
+textarea:focus {
+  outline: none;
+  border-color: var(--nymbal-color-accent, #2563eb);
+  box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.15);
+}
+
+.input::placeholder,
+input::placeholder,
+textarea::placeholder {
+  color: var(--nymbal-color-text-muted, #71717a);
+}
+
+label {
+  display: block;
+  font-size: var(--nymbal-font-size-sm, 0.875rem);
+  font-weight: var(--nymbal-font-weight-medium, 500);
+  color: var(--nymbal-color-text, #18181b);
+  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
+}
+
+.form-group {
+  margin-bottom: var(--nymbal-spacing-md, 1rem);
+}
+
+.form-error {
+  font-size: var(--nymbal-font-size-xs, 0.75rem);
+  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);
+  }
+}