create-nymbal-app 0.4.0 → 0.5.0

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

@@ -12,7 +12,12 @@
   text-align: center;
   padding: 4rem var(--nymbal-spacing-md, 1rem);
   min-height: 420px;
-  background: linear-gradient(135deg, var(--nymbal-color-primary, #18181b) 0%, #27272a 50%, var(--nymbal-color-accent, #2563eb) 100%);
+  background: linear-gradient(
+    135deg,
+    var(--nymbal-color-primary, #18181b) 0%,
+    #27272a 50%,
+    var(--nymbal-color-accent, #2563eb) 100%
+  );
   color: var(--nymbal-color-text-inverse, #fff);
   overflow: hidden;
 }
@@ -95,55 +100,6 @@
   border-color: rgba(255, 255, 255, 0.5);
 }
 
-/* ---- Category grid ---- */
-
-.category-grid {
-  display: grid;
-  grid-template-columns: repeat(2, 1fr);
-  gap: var(--nymbal-spacing-md, 1rem);
-}
-
-@media (min-width: 641px) {
-  .category-grid {
-    grid-template-columns: repeat(4, 1fr);
-    gap: var(--nymbal-spacing-lg, 1.5rem);
-  }
-}
-
-.category-card {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  justify-content: center;
-  text-align: center;
-  padding: var(--nymbal-spacing-lg, 1.5rem) var(--nymbal-spacing-md, 1rem);
-  background-color: var(--nymbal-color-surface, #fff);
-  border: 1px solid var(--nymbal-color-border, #e4e4e7);
-  border-radius: var(--nymbal-radius-lg, 0.75rem);
-  text-decoration: none;
-  transition: border-color var(--nymbal-transition-fast, 150ms) ease,
-    box-shadow var(--nymbal-transition-fast, 150ms) ease,
-    transform var(--nymbal-transition-fast, 150ms) ease;
-  min-height: 140px;
-}
-
-.category-card:hover {
-  border-color: var(--nymbal-color-accent, #2563eb);
-  box-shadow: var(--nymbal-shadow-md, 0 4px 6px -1px rgba(0, 0, 0, 0.1));
-  transform: translateY(-2px);
-}
-
-.category-card-icon {
-  font-size: 2rem;
-  margin-bottom: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.category-card-name {
-  font-size: var(--nymbal-font-size-base, 1rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-}
-
 /* ---- Featured products ---- */
 
 .featured-section {
@@ -170,53 +126,6 @@
   text-decoration: underline;
 }
 
-/* ---- Product card (shared home / PLP) ---- */
-
-.product-card {
-  display: flex;
-  flex-direction: column;
-  background-color: var(--nymbal-color-surface, #fff);
-  border: 1px solid var(--nymbal-color-border, #e4e4e7);
-  border-radius: var(--nymbal-radius-lg, 0.75rem);
-  overflow: hidden;
-  text-decoration: none;
-  transition: box-shadow var(--nymbal-transition-normal, 200ms) ease,
-    transform var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.product-card:hover {
-  box-shadow: var(--nymbal-shadow-md, 0 4px 6px -1px rgba(0, 0, 0, 0.1));
-  transform: translateY(-2px);
-}
-
-.product-card-image {
-  aspect-ratio: 1 / 1;
-  width: 100%;
-  object-fit: cover;
-  background-color: #f4f4f5;
-}
-
-.product-card-body {
-  padding: var(--nymbal-spacing-md, 1rem);
-  flex: 1;
-  display: flex;
-  flex-direction: column;
-  gap: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.product-card-name {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  line-height: 1.3;
-}
-
-.product-card-price {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-bold, 700);
-  color: var(--nymbal-color-primary, #18181b);
-}
-
 /* ---- Newsletter section ---- */
 
 .newsletter {
@@ -247,7 +156,7 @@
   justify-content: center;
 }
 
-.newsletter-form input[type="email"] {
+.newsletter-form input[type='email'] {
   flex: 1;
   min-width: 200px;
   border-color: rgba(255, 255, 255, 0.2);
@@ -255,11 +164,11 @@
   color: var(--nymbal-color-text-inverse, #fff);
 }
 
-.newsletter-form input[type="email"]::placeholder {
+.newsletter-form input[type='email']::placeholder {
   color: rgba(255, 255, 255, 0.5);
 }
 
-.newsletter-form input[type="email"]:focus {
+.newsletter-form input[type='email']:focus {
   border-color: var(--nymbal-color-accent, #2563eb);
   box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.3);
 }

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

@@ -24,38 +24,7 @@
   }
 }
 
-/* ---- Breadcrumbs ---- */
-
-.pdp-breadcrumbs {
-  display: flex;
-  align-items: center;
-  gap: var(--nymbal-spacing-xs, 0.25rem);
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  flex-wrap: wrap;
-}
-
-.pdp-breadcrumbs a {
-  color: var(--nymbal-color-text-muted, #71717a);
-  text-decoration: none;
-  transition: color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.pdp-breadcrumbs a:hover {
-  color: var(--nymbal-color-accent, #2563eb);
-}
-
-.pdp-breadcrumbs .separator {
-  color: var(--nymbal-color-border, #e4e4e7);
-}
-
-.pdp-breadcrumbs .current {
-  color: var(--nymbal-color-text, #18181b);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-}
-
-/* ---- Image gallery ---- */
+/* ---- Image gallery (nymbal-image-gallery) ---- */
 
 .pdp-gallery {
   position: sticky;
@@ -63,50 +32,6 @@
   align-self: start;
 }
 
-.pdp-main-image {
-  width: 100%;
-  aspect-ratio: 1 / 1;
-  object-fit: cover;
-  border-radius: var(--nymbal-radius-lg, 0.75rem);
-  background-color: #f4f4f5;
-  margin-bottom: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.pdp-thumbnails {
-  display: flex;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  overflow-x: auto;
-  scrollbar-width: thin;
-  padding-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.pdp-thumbnail {
-  width: 64px;
-  height: 64px;
-  object-fit: cover;
-  border-radius: var(--nymbal-radius-md, 0.5rem);
-  border: 2px solid transparent;
-  cursor: pointer;
-  flex-shrink: 0;
-  background-color: #f4f4f5;
-  transition: border-color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.pdp-thumbnail:hover {
-  border-color: var(--nymbal-color-border, #e4e4e7);
-}
-
-.pdp-thumbnail.active {
-  border-color: var(--nymbal-color-primary, #18181b);
-}
-
-@media (min-width: 641px) {
-  .pdp-thumbnail {
-    width: 80px;
-    height: 80px;
-  }
-}
-
 /* ---- Product info ---- */
 
 .pdp-info {
@@ -128,46 +53,6 @@
   }
 }
 
-.pdp-price {
-  font-size: 1.5rem;
-  font-weight: var(--nymbal-font-weight-bold, 700);
-  color: var(--nymbal-color-primary, #18181b);
-}
-
-.pdp-price-range {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-weight: var(--nymbal-font-weight-normal, 400);
-  margin-left: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.pdp-stock {
-  display: inline-flex;
-  align-items: center;
-  gap: var(--nymbal-spacing-xs, 0.25rem);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-}
-
-.pdp-stock[data-level='in'] {
-  color: var(--nymbal-color-success, #16a34a);
-}
-
-.pdp-stock[data-level='low'] {
-  color: var(--nymbal-color-warning, #d97706);
-}
-
-.pdp-stock[data-level='out'] {
-  color: var(--nymbal-color-error, #dc2626);
-}
-
-.pdp-stock-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: var(--nymbal-radius-full, 9999px);
-  background-color: currentColor;
-}
-
 .pdp-description {
   font-size: var(--nymbal-font-size-sm, 0.875rem);
   color: var(--nymbal-color-text-muted, #71717a);
@@ -218,59 +103,8 @@ nymbal-add-to-cart {
   margin-bottom: var(--nymbal-spacing-lg, 1.5rem);
 }
 
-.review-list {
-  display: flex;
-  flex-direction: column;
-  gap: var(--nymbal-spacing-lg, 1.5rem);
-}
-
-.review-item {
-  padding-bottom: var(--nymbal-spacing-lg, 1.5rem);
-  border-bottom: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.review-item:last-child {
-  border-bottom: none;
-  padding-bottom: 0;
-}
-
-.review-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-  flex-wrap: wrap;
-}
-
-.review-rating {
-  display: flex;
-  gap: 2px;
-  color: var(--nymbal-color-warning, #d97706);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-}
-
-.review-date {
-  font-size: var(--nymbal-font-size-xs, 0.75rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.review-title {
-  font-size: var(--nymbal-font-size-base, 1rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.review-body {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  line-height: 1.6;
-}
-
-.reviews-empty {
-  text-align: center;
-  padding: var(--nymbal-spacing-xl, 2rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
+.pdp-review-form {
+  margin-top: var(--nymbal-spacing-xl, 2rem);
+  padding-top: var(--nymbal-spacing-xl, 2rem);
+  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
 }

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

@@ -30,11 +30,6 @@
   margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
 }
 
-.plp-count {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
 /* ---- Filter sidebar ---- */
 
 .plp-sidebar {
@@ -91,7 +86,7 @@
   margin-bottom: 0;
 }
 
-.filter-item input[type="checkbox"] {
+.filter-item input[type='checkbox'] {
   width: 16px;
   height: 16px;
   accent-color: var(--nymbal-color-accent, #2563eb);
@@ -108,11 +103,11 @@
 }
 
 .filter-link:hover,
-.filter-link[aria-current="page"] {
+.filter-link[aria-current='page'] {
   color: var(--nymbal-color-accent, #2563eb);
 }
 
-.filter-link[aria-current="page"] {
+.filter-link[aria-current='page'] {
   font-weight: var(--nymbal-font-weight-bold, 700);
 }
 
@@ -171,40 +166,6 @@
   min-width: 0;
 }
 
-/* ---- Pagination ---- */
-
-.plp-pagination {
-  display: flex;
-  justify-content: center;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-  margin-top: var(--nymbal-spacing-xl, 2rem);
-  padding-top: var(--nymbal-spacing-lg, 1.5rem);
-  border-top: 1px solid var(--nymbal-color-border, #e4e4e7);
-}
-
-.plp-pagination .btn {
-  min-width: 100px;
-}
-
-/* ---- Empty state ---- */
-
-.plp-empty {
-  text-align: center;
-  padding: 4rem var(--nymbal-spacing-md, 1rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.plp-empty-title {
-  font-size: var(--nymbal-font-size-lg, 1.125rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.plp-empty-text {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-}
-
 /* ---- nymbal-product-filter integration ---- */
 
 nymbal-product-filter {

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

@@ -52,120 +52,14 @@
   gap: var(--nymbal-spacing-lg, 1.5rem);
 }
 
-/* The filter renders nothing when the search has no facets: the results take the width. */
+/* The filter carries `empty` when the search has no facets: the results take the width. The page serves it with
+   `empty`, so no sidebar column is drawn before the element runs. */
 @media (min-width: 769px) {
-  .search-layout:has(nymbal-product-filter:not(:empty)) {
+  .search-layout:has(nymbal-product-filter:not([empty])) {
     grid-template-columns: 240px minmax(0, 1fr);
   }
 }
 
-.search-sidebar:has(nymbal-product-filter:empty) {
+.search-sidebar:has(nymbal-product-filter[empty]) {
   display: none;
 }
-
-/* ---- Results area ---- */
-
-.search-results {
-  padding-top: var(--nymbal-spacing-lg, 1.5rem);
-}
-
-.search-results-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  flex-wrap: wrap;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.search-query-label {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-.search-query-label strong {
-  color: var(--nymbal-color-text, #18181b);
-  font-weight: var(--nymbal-font-weight-bold, 700);
-}
-
-.search-result-count {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-}
-
-/* ---- Results grid (uses .product-grid from global) ---- */
-
-/* ---- Empty / no results ---- */
-
-.search-empty {
-  text-align: center;
-  padding: 4rem var(--nymbal-spacing-md, 1rem);
-}
-
-.search-empty-icon {
-  font-size: 3rem;
-  margin-bottom: var(--nymbal-spacing-md, 1rem);
-  opacity: 0.3;
-}
-
-.search-empty-title {
-  font-size: var(--nymbal-font-size-lg, 1.125rem);
-  font-weight: var(--nymbal-font-weight-medium, 500);
-  color: var(--nymbal-color-text, #18181b);
-  margin-bottom: var(--nymbal-spacing-xs, 0.25rem);
-}
-
-.search-empty-text {
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  color: var(--nymbal-color-text-muted, #71717a);
-  max-width: 28ch;
-  margin-inline: auto;
-}
-
-/* ---- Suggestions ---- */
-
-.search-suggestions {
-  margin-top: var(--nymbal-spacing-lg, 1.5rem);
-}
-
-.search-suggestions-title {
-  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-sm, 0.5rem);
-}
-
-.search-suggestions-list {
-  display: flex;
-  flex-wrap: wrap;
-  gap: var(--nymbal-spacing-sm, 0.5rem);
-}
-
-.search-suggestion {
-  display: inline-flex;
-  padding: var(--nymbal-spacing-xs, 0.25rem) var(--nymbal-spacing-md, 1rem);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-  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-full, 9999px);
-  text-decoration: none;
-  transition: border-color var(--nymbal-transition-fast, 150ms) ease,
-    background-color var(--nymbal-transition-fast, 150ms) ease;
-}
-
-.search-suggestion:hover {
-  border-color: var(--nymbal-color-accent, #2563eb);
-  background-color: rgba(37, 99, 235, 0.04);
-}
-
-/* ---- Loading ---- */
-
-.search-loading {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  padding: 3rem;
-  color: var(--nymbal-color-text-muted, #71717a);
-  font-size: var(--nymbal-font-size-sm, 0.875rem);
-}

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

@@ -0,0 +1,56 @@
+/* ----------------------------------------------------------------
+   Design tokens: this store's file, edit it to restyle.
+   Every Nymbal element reads its look from these custom properties,
+   which cross into its shadow root. An element's `part`s can be
+   styled further with ::part(), e.g. nymbal-add-to-cart::part(button).
+   Defaults: @nymbalhq/web-components/tokens.css.
+   ---------------------------------------------------------------- */
+
+:root {
+  --nymbal-color-primary: #18181b;
+  --nymbal-color-primary-hover: #27272a;
+  --nymbal-color-accent: #2563eb;
+  --nymbal-color-accent-hover: #1d4ed8;
+  --nymbal-color-success: #16a34a;
+  --nymbal-color-error: #dc2626;
+  --nymbal-color-warning: #d97706;
+  --nymbal-color-text: #18181b;
+  --nymbal-color-text-muted: #71717a;
+  --nymbal-color-text-inverse: #ffffff;
+  --nymbal-color-border: #e4e4e7;
+  --nymbal-color-surface: #ffffff;
+  --nymbal-color-overlay: rgba(0, 0, 0, 0.4);
+
+  --nymbal-font-family: system-ui, -apple-system, sans-serif;
+  --nymbal-font-size-xs: 0.75rem;
+  --nymbal-font-size-sm: 0.875rem;
+  --nymbal-font-size-base: 1rem;
+  --nymbal-font-size-lg: 1.125rem;
+  --nymbal-font-size-xl: 1.25rem;
+  --nymbal-font-weight-normal: 400;
+  --nymbal-font-weight-medium: 500;
+  --nymbal-font-weight-bold: 700;
+
+  --nymbal-spacing-xs: 0.25rem;
+  --nymbal-spacing-sm: 0.5rem;
+  --nymbal-spacing-md: 1rem;
+  --nymbal-spacing-lg: 1.5rem;
+  --nymbal-spacing-xl: 2rem;
+
+  --nymbal-radius-sm: 0.25rem;
+  --nymbal-radius-md: 0.375rem;
+  --nymbal-radius-lg: 0.5rem;
+  --nymbal-radius-full: 9999px;
+
+  --nymbal-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
+  --nymbal-shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
+  --nymbal-shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
+
+  --nymbal-transition-fast: 150ms ease;
+  --nymbal-transition-normal: 200ms ease;
+  --nymbal-transition-slow: 300ms ease;
+
+  --nymbal-z-dropdown: 100;
+  --nymbal-z-drawer: 200;
+  --nymbal-z-toast: 300;
+}

package/scaffold/templates/nextjs/_dot.node-version

@@ -1 +1 @@
-22.23.3
+26.12.1

package/scaffold/templates/nextjs/app/(catalog)/category/[slug]/page.tsx

@@ -0,0 +1,74 @@
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+import { fetchProducts, fetchCategories, fetchCapabilities, sortFromSearchParams } from '@/lib/api'
+import { cardImageOf, cardProductOf, renderNymbal } from '@/lib/render'
+import { Breadcrumb, ProductGrid } from '@/components/client/elements'
+import { ListingControls } from '@/components/client/ListingControls'
+import styles from '@/styles/pages/plp.module.css'
+
+interface CategoryPageProps {
+  params: Promise<{ slug: string }>
+  searchParams: Promise<{ sort?: string | string[] }>
+}
+
+export async function generateMetadata({ params }: CategoryPageProps): Promise<Metadata> {
+  const { slug } = await params
+  const categories = await fetchCategories()
+  const category = categories.find((c) => c.slug === slug)
+
+  return {
+    title: category?.name ?? slug,
+    description: category?.description ?? `Browse products in ${slug}.`,
+  }
+}
+
+export default async function CategoryPage({ params, searchParams }: CategoryPageProps) {
+  const { slug } = await params
+  const capabilities = await fetchCapabilities()
+  const sort = sortFromSearchParams(await searchParams, capabilities?.catalog)
+  const [{ items, nextCursor, facets }, categories] = await Promise.all([
+    fetchProducts({ limit: 24, category: slug, sort }),
+    fetchCategories(),
+  ])
+
+  const category = categories.find((c) => c.slug === slug)
+  if (!category) notFound()
+  const crumbs = [{ label: 'Home', href: '/' }, { label: category.name }]
+  const cards = items.map(cardProductOf)
+  // The first card's image is the page's LCP, and the preload scanner never reaches it inside the grid's shadow root:
+  // a preload link, which React hoists into the head, starts it.
+  const firstImage = cards[0] === undefined ? null : cardImageOf(cards[0]).url
+  const grid = {
+    products: JSON.stringify(cards),
+    source: 'product-list',
+    ...(nextCursor !== null && { 'has-more': '' }),
+  }
+
+  return (
+    <div className={`container ${styles.page}`}>
+      {firstImage !== null && (
+        <link rel="preload" as="image" href={firstImage} fetchPriority="high" />
+      )}
+      <Breadcrumb
+        items={crumbs}
+        serverHtml={renderNymbal('nymbal-breadcrumb', { items: JSON.stringify(crumbs) }).__html}
+      />
+      <h1 className={styles.pageTitle}>{category.name}</h1>
+      {category.description && <p className="text-muted mb-lg">{category.description}</p>}
+      <ListingControls
+        sort={sort}
+        category={slug}
+        facets={facets ?? []}
+        sortKeys={capabilities?.catalog.sortKeys ?? []}
+        defaultSort={capabilities?.catalog.defaultSort}
+      >
+        <ProductGrid
+          products={cards}
+          source="product-list"
+          hasMore={nextCursor !== null}
+          serverHtml={renderNymbal('nymbal-product-grid', grid).__html}
+        />
+      </ListingControls>
+    </div>
+  )
+}