@thorprovider/storefront 0.3.1 → 0.4.0-mvp.2

package/assets/templates/views/home/assembly/index.skeleton.tsx

@@ -0,0 +1,90 @@
+// Thor Commerce view module: home
+// Server Component module: elements + catalog entries + route + loader only.
+// The client-side component mappings live in ./registry.tsx ('use client'); this
+// module imports them as data so the RSC graph never evaluates @json-render/react
+// on the server. Registered by importing it in ../index.ts. Recipe: recipes.json -> "home".
+
+import { getCatalog } from '@thorprovider/runtime/commerce'
+import { getDataSource, getStoreContext } from '../../store-context'
+import { pageRoot } from '../../spec/page-root'
+import type { StorefrontElement } from '../../spec/types'
+import type { ViewModule } from '../types'
+import { registry } from './registry'
+import { benefitsProps, categoriesProps, heroProps } from './props'
+import * as homeData from './data'
+import { toCategoryCard, toFeaturedProduct } from '../../mappers'
+import { resolveSectionSources, resolveSectionViewStates } from '../../section-sources'
+import {
+  categoryCardsPropsSchema,
+  featurePropsSchema,
+  storefrontHeroPropsSchema,
+} from './schema'@@SECTION_IMPORTS@@
+
+// The element tree is derived wiring; the rendered props come from the
+// user-owned ./props.ts module so they survive sync and unit removal.
+const elements: Record<string, StorefrontElement> = {
+@@ELEMENTS@@
+}
+
+const catalog = {
+@@CATALOG@@
+}
+
+export const home: ViewModule = {
+  name: 'home',
+  elements,
+  catalog,
+  registry,
+  route: {
+    path: '/',
+    loaderName: 'home',
+    layout: 'default',
+    metadata: {
+      title: 'Inicio',
+      description: 'Descubre los productos de __SITE_NAME__.',
+    },
+    entry: pageRoot('home', [@@SLOT_IDS@@], elements),
+  },
+  loader: {
+    home: async () => {
+      // Data-bound sections resolve independently through the canonical catalog
+      // bridge; equal queries share request-local work and differing contexts
+      // stay isolated. A section failure never erases its siblings, and it is
+      // resolved separately so a catalog failure still yields truthful
+      // per-section state instead of a missing one.
+      let sections: Record<string, unknown> = {}
+      try {
+        sections = await resolveSectionViewStates(
+          @@SECTION_LOADERS@@,
+          resolveSectionSources(homeData),
+          getStoreContext(),
+        )
+      } catch {
+        sections = {}
+      }
+      try {
+        const { products, categories, source } = await getCatalog()
+        return {
+          heroProducts: homeData.selectHeroProducts(products).map(toFeaturedProduct),
+          categories: categories.map(toCategoryCard),
+          navCategories: homeData.toNavCategories(categories),
+          dataSource: source,
+          dataError: null,
+          sections,
+        }
+      } catch (error) {
+        // A real-mode failure is surfaced as a visible error, never as fictional
+        // data. Mock mode is labelled by `dataSource`.
+        return {
+          heroProducts: [],
+          categories: [],
+          navCategories: [],
+          dataSource: getDataSource(),
+          dataError:
+            error instanceof Error ? error.message : 'No se pudo cargar el catálogo.',
+          sections,
+        }
+      }
+    },
+  },
+}

package/assets/templates/views/home/assembly/registry.skeleton.tsx

@@ -0,0 +1,25 @@
+'use client'
+
+// Thor Commerce view registry fragment: home
+// Client boundary for the home view. Imports value bindings from
+// @json-render/react and components from @thorprovider/blocks — both must stay
+// on the client side of the RSC graph. Kept separate from index.tsx so the view
+// spec (elements/catalog/route/loader) stays a pure Server Component module.
+//
+// Props arrive as untyped spec data: every entry parses them through the view's
+// schema (./schema.ts) before binding, so a contract mismatch fails loudly at
+// the boundary instead of rendering undefined fields or literal icon tags.
+
+@@BLOCK_IMPORTS@@@@SECTION_REGISTRY_IMPORTS@@
+import { useStateStore } from '@json-render/react'
+import { resolveIcon } from '../../icon-map'
+import type { ViewRegistry } from '../types'
+import {
+  categoryCardsPropsSchema,
+  featurePropsSchema,
+  storefrontHeroPropsSchema,
+} from './schema'
+
+export const registry: ViewRegistry = {
+@@REGISTRY@@
+}

package/assets/templates/views/home/assembly/slots/benefits/Feature1/binding.json

@@ -0,0 +1,5 @@
+{
+  "module": "@thorprovider/blocks",
+  "import": "Feature1",
+  "as": "FeatureBlock"
+}

package/assets/templates/views/home/assembly/slots/benefits/Feature1/catalog.part

@@ -0,0 +1,4 @@
+  Feature: {
+    props: featurePropsSchema,
+    description: 'Benefit highlights.',
+  },

package/assets/templates/views/home/assembly/slots/benefits/Feature1/element.part

@@ -0,0 +1,4 @@
+  'home.benefits': {
+    type: 'Feature',
+    props: benefitsProps,
+  },

package/assets/templates/views/home/assembly/slots/benefits/Feature1/registry.part

@@ -0,0 +1,11 @@
+  Feature: ({ props }) => {
+    const feature = featurePropsSchema.parse(props)
+    return (
+      <FeatureBlock
+        items={feature.items.map((item) => ({ ...item, icon: resolveIcon(item.icon) }))}
+        badge={feature.badge}
+        title={feature.title}
+        description={feature.description}
+      />
+    )
+  },

package/assets/templates/views/home/assembly/slots/benefits/Feature2/binding.json

@@ -0,0 +1,5 @@
+{
+  "module": "@thorprovider/blocks",
+  "import": "Feature2",
+  "as": "FeatureBlock"
+}

package/assets/templates/views/home/assembly/slots/benefits/Feature2/catalog.part

@@ -0,0 +1,4 @@
+  Feature: {
+    props: featurePropsSchema,
+    description: 'Benefit highlights.',
+  },

package/assets/templates/views/home/assembly/slots/benefits/Feature2/element.part

@@ -0,0 +1,4 @@
+  'home.benefits': {
+    type: 'Feature',
+    props: benefitsProps,
+  },

package/assets/templates/views/home/assembly/slots/benefits/Feature2/registry.part

@@ -0,0 +1,10 @@
+  Feature: ({ props }) => {
+    const feature = featurePropsSchema.parse(props)
+    return (
+      <FeatureBlock
+        items={feature.items.map((item) => ({ ...item, icon: resolveIcon(item.icon) }))}
+        title={feature.title}
+        description={feature.description}
+      />
+    )
+  },

package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/binding.json

@@ -0,0 +1,5 @@
+{
+  "module": "@thorprovider/blocks",
+  "import": "ProductCategory2",
+  "as": "CategoryCardsBlock"
+}

package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/catalog.part

@@ -0,0 +1,4 @@
+  CategoryCards: {
+    props: categoryCardsPropsSchema,
+    description: 'Category grid.',
+  },

package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/element.part

@@ -0,0 +1,5 @@
+  'home.categories': {
+    type: 'CategoryCards',
+    props: categoriesProps,
+    on: { openCategory: { action: 'openCategory' } },
+  },

package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/registry.part

@@ -0,0 +1,16 @@
+  CategoryCards: ({ props, emit }) => {
+    const { set } = useStateStore()
+    const cards = categoryCardsPropsSchema.parse(props)
+    return (
+      <CategoryCardsBlock
+        title={cards.title}
+        description={cards.description}
+        categories={cards.categories}
+        cta={cards.cta}
+        onBrowse={(category) => {
+          set('/lastCategory', category.handle ?? String(category.id))
+          emit('openCategory')
+        }}
+      />
+    )
+  },

package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/binding.json

@@ -0,0 +1,5 @@
+{
+  "module": "@thorprovider/blocks",
+  "import": "StorefrontHero1",
+  "as": "StorefrontHeroBlock"
+}

package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/catalog.part

@@ -0,0 +1,4 @@
+  StorefrontHero: {
+    props: storefrontHeroPropsSchema,
+    description: 'Landing hero.',
+  },

package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/element.part

@@ -0,0 +1,5 @@
+  'home.hero': {
+    type: 'StorefrontHero',
+    props: heroProps,
+    on: { addClickedToCart: { action: 'addClickedToCart' }, openProduct: { action: 'openProduct' } },
+  },

package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/registry.part

@@ -0,0 +1,26 @@
+  StorefrontHero: ({ props, emit }) => {
+    const { set } = useStateStore()
+    const hero = storefrontHeroPropsSchema.parse(props)
+    return (
+      <StorefrontHeroBlock
+        title={hero.title}
+        description={hero.description}
+        products={hero.products}
+        titleAccent={hero.titleAccent}
+        badge={hero.badge}
+        primaryCta={hero.primaryCta}
+        secondaryCta={hero.secondaryCta}
+        heroImage={hero.heroImage}
+        onAddToCart={(product) => {
+          // Product-card shortcut: add the first purchasable variant.
+          set('/lastClicked', product)
+          emit('addClickedToCart')
+        }}
+        onBuyNow={(product) => {
+          set('/lastClicked', product)
+          emit('openProduct')
+        }}
+        onSelectColor={() => {}}
+      />
+    )
+  },

package/assets/templates/views/home/content.ts

@@ -0,0 +1,70 @@
+// Thor Commerce view content: home
+// User-owned view content — the copy, CTA labels, and feature items rendered by
+// this view. Reconcile seeds this file once and never rewrites it; the derived
+// view module (./index.tsx) imports it and wires it into the element tree, so
+// your edits here survive `storefront sync` and unit removal. Plain data only:
+// no React and no server imports.
+
+export interface HeroImageContent {
+  src: string
+  alt: string
+}
+
+/**
+ * Optional editorial hero image. Leave `undefined` to render no image; never
+ * set a blank `src`. This is static editorial imagery only — never a product
+ * image or backend data.
+ */
+export const heroImage: HeroImageContent | undefined = undefined
+
+export const heroContent = {
+  badge: 'Bienvenido',
+  title: '__SITE_NAME__',
+  titleAccent: 'para cada proyecto',
+  // Neutral: no delivery/shipping promise.
+  description: 'Productos seleccionados con precios claros y compra sencilla.',
+  primaryCta: { label: 'Comprar ahora' },
+  secondaryCta: { label: 'Ver categorías' },
+}
+
+export const benefitsContent = {
+  badge: '__SITE_NAME__',
+  title: 'Compra con confianza',
+  // Neutral: no delivery/shipping promise.
+  description: 'Ventajas pensadas para una compra clara y segura.',
+  items: [
+    {
+      id: 'pago',
+      title: 'Pago protegido',
+      description: 'Compra con confianza, múltiples opciones de pago.',
+      icon: 'shield-check',
+    },
+    {
+      id: 'catalogo',
+      title: 'Catálogo variado',
+      description: 'Productos para tu hogar y tu negocio.',
+      icon: 'star',
+    },
+    {
+      id: 'soporte',
+      title: 'Soporte local',
+      description: 'Atención personalizada en todo el país.',
+      icon: 'headphones',
+    },
+  ],
+}
+
+export const categoriesContent = {
+  title: 'Compra por categoría',
+  description: 'Explora nuestro catálogo completo.',
+}
+
+/**
+ * Editorial section instance content, keyed by the section instance id the
+ * manifest persists (`views[].sections[].id`, e.g. `home-faq-1`). The derived
+ * view module reads `sectionContent[id]`, so adding, reordering, or removing a
+ * section never rewrites this file and your copy survives `storefront sync`.
+ * Plain data only, matching the section fragment's props; an unset id renders
+ * the section's neutral default.
+ */
+export const sectionContent: Record<string, Record<string, unknown>> = {}

package/assets/templates/views/home/data.ts

@@ -0,0 +1,24 @@
+// Thor Commerce view data: home
+// User-owned loader shaping for the home view. Reconcile seeds this file once and
+// never rewrites it; the derived view module (./index.tsx) imports these helpers
+// and calls them from its loader, so edits here survive `storefront sync` and
+// unit removal. Pure functions only: no React and no server imports.
+
+export function selectHeroProducts<T>(products: readonly T[]): T[] {
+  return products.slice(0, 4)
+}
+
+export function toNavCategories(
+  categories: readonly { label: string; href: string }[],
+): { label: string; href: string }[] {
+  return categories.map((category) => ({ label: category.label, href: category.href }))
+}
+
+// Per-instance selection for data-bound sections (for example `products`), keyed
+// by the section's stable id from the composition manifest. Each value is a
+// canonical catalog selection (category/collection/search/ordering) that the
+// generated host loader resolves through the runtime catalog bridge. Left empty
+// by default: a data-bound section with no entry renders an `unconfigured`
+// state. Entries whose id is no longer referenced by the composition are kept
+// but never queried, so re-adding the section with the same id restores them.
+export const sectionSources: Record<string, unknown> = {}

package/assets/templates/views/home/index.tsx

@@ -5,115 +5,51 @@
 // on the server. Registered by importing it in ../index.ts. Recipe: recipes.json -> "home".
 
 import { getCatalog } from '@thorprovider/runtime/commerce'
-import { z } from 'zod'
+import { getDataSource, getStoreContext } from '../../store-context'
 import { pageRoot } from '../../spec/page-root'
 import type { StorefrontElement } from '../../spec/types'
 import type { ViewModule } from '../types'
 import { registry } from './registry'
-import { toFeaturedProduct } from '../../mappers'
+import { benefitsProps, categoriesProps, heroProps } from './props'
+import * as homeData from './data'
+import { toCategoryCard, toFeaturedProduct } from '../../mappers'
+import { resolveSectionSources, resolveSectionViewStates } from '../../section-sources'
+import {
+  categoryCardsPropsSchema,
+  featurePropsSchema,
+  storefrontHeroPropsSchema,
+} from './schema'
 
+// The element tree is derived wiring; the rendered props come from the
+// user-owned ./props.ts module so they survive sync and unit removal.
 const elements: Record<string, StorefrontElement> = {
   'home.hero': {
     type: 'StorefrontHero',
-    props: {
-      badge: 'Bienvenido',
-      title: '__SITE_NAME__',
-      titleAccent: 'para cada proyecto',
-      description: 'Productos seleccionados con precios justos y entrega a tu puerta.',
-      products: { $state: '/heroProducts' },
-      primaryCta: { label: 'Comprar ahora' },
-      secondaryCta: { label: 'Ver categorías' },
-    },
-    on: { addToCart: { action: 'addToCart' }, openProduct: { action: 'openProduct' } },
+    props: heroProps,
+    on: { addClickedToCart: { action: 'addClickedToCart' }, openProduct: { action: 'openProduct' } },
   },
   'home.benefits': {
     type: 'Feature',
-    props: {
-      badge: '__SITE_NAME__',
-      title: 'Compra con confianza',
-      description: 'Beneficios pensados para que tu compra llegue segura y a tiempo.',
-      items: [
-        {
-          id: 'entrega',
-          title: 'Entrega segura',
-          description: 'Seguimiento de tu pedido hasta la puerta de tu casa.',
-          icon: 'truck',
-        },
-        {
-          id: 'pago',
-          title: 'Pago protegido',
-          description: 'Compra con confianza, múltiples opciones de pago.',
-          icon: 'shield-check',
-        },
-        {
-          id: 'soporte',
-          title: 'Soporte local',
-          description: 'Atención personalizada en todo el país.',
-          icon: 'headphones',
-        },
-      ],
-    },
+    props: benefitsProps,
   },
   'home.categories': {
     type: 'CategoryCards',
-    props: {
-      title: 'Compra por categoría',
-      description: 'Explora nuestro catálogo completo.',
-      categories: { $state: '/categories' },
-    },
+    props: categoriesProps,
     on: { openCategory: { action: 'openCategory' } },
   },
 }
 
-const ctaSchema = z.object({ label: z.string(), href: z.string().optional() })
-
-// Mirrors the StorefrontHero block contract (FeaturedProduct) so a product-shape
-// mismatch is a type error at the catalog boundary, not a runtime crash. The
-// block requires every field — including `colors` — to be defined at render.
-const featuredProductSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  brand: z.string(),
-  price: z.number(),
-  originalPrice: z.number(),
-  rating: z.number(),
-  reviewCount: z.number(),
-  inStock: z.boolean(),
-  isNew: z.boolean(),
-  isOnSale: z.boolean(),
-  image: z.string(),
-  colors: z.array(z.string()),
-})
-
 const catalog = {
   StorefrontHero: {
-    props: z.object({
-      title: z.string(),
-      description: z.string(),
-      titleAccent: z.string().optional(),
-      badge: z.string().optional(),
-      products: z.array(featuredProductSchema),
-      primaryCta: ctaSchema.optional(),
-      secondaryCta: ctaSchema.optional(),
-    }),
+    props: storefrontHeroPropsSchema,
     description: 'Landing hero.',
   },
   Feature: {
-    props: z.object({
-      items: z.array(z.record(z.string(), z.unknown())),
-      badge: z.string().optional(),
-      title: z.string().optional(),
-      description: z.string().optional(),
-    }),
+    props: featurePropsSchema,
     description: 'Benefit highlights.',
   },
   CategoryCards: {
-    props: z.object({
-      title: z.string().optional(),
-      description: z.string().optional(),
-      categories: z.array(z.record(z.string(), z.unknown())),
-      cta: ctaSchema.optional(),
-    }),
+    props: categoryCardsPropsSchema,
     description: 'Category grid.',
   },
 }
@@ -135,8 +71,44 @@ export const home: ViewModule = {
   },
   loader: {
     home: async () => {
-      const { products, categories } = await getCatalog()
-      return { heroProducts: products.slice(0, 4).map(toFeaturedProduct), categories }
+      // Data-bound sections resolve independently through the canonical catalog
+      // bridge; equal queries share request-local work and differing contexts
+      // stay isolated. A section failure never erases its siblings, and it is
+      // resolved separately so a catalog failure still yields truthful
+      // per-section state instead of a missing one.
+      let sections: Record<string, unknown> = {}
+      try {
+        sections = await resolveSectionViewStates(
+          [],
+          resolveSectionSources(homeData),
+          getStoreContext(),
+        )
+      } catch {
+        sections = {}
+      }
+      try {
+        const { products, categories, source } = await getCatalog()
+        return {
+          heroProducts: homeData.selectHeroProducts(products).map(toFeaturedProduct),
+          categories: categories.map(toCategoryCard),
+          navCategories: homeData.toNavCategories(categories),
+          dataSource: source,
+          dataError: null,
+          sections,
+        }
+      } catch (error) {
+        // A real-mode failure is surfaced as a visible error, never as fictional
+        // data. Mock mode is labelled by `dataSource`.
+        return {
+          heroProducts: [],
+          categories: [],
+          navCategories: [],
+          dataSource: getDataSource(),
+          dataError:
+            error instanceof Error ? error.message : 'No se pudo cargar el catálogo.',
+          sections,
+        }
+      }
     },
   },
 }

package/assets/templates/views/home/props.ts

@@ -0,0 +1,22 @@
+// Thor Commerce view props: home
+// User-owned element props for the home view. Reconcile seeds this file once and
+// never rewrites it; the derived view module (./index.tsx) imports these objects
+// and binds them into the element tree, so edits here survive `storefront sync`
+// and unit removal. Plain data only: no React and no server imports.
+
+import { benefitsContent, categoriesContent, heroContent, heroImage } from './content'
+
+export const heroProps = {
+  ...heroContent,
+  products: { $state: '/heroProducts' },
+  heroImage,
+}
+
+export const benefitsProps = {
+  ...benefitsContent,
+}
+
+export const categoriesProps = {
+  ...categoriesContent,
+  categories: { $state: '/categories' },
+}

package/assets/templates/views/home/registry.tsx

@@ -5,31 +5,43 @@
 // @json-render/react and components from @thorprovider/blocks — both must stay
 // on the client side of the RSC graph. Kept separate from index.tsx so the view
 // spec (elements/catalog/route/loader) stays a pure Server Component module.
+//
+// Props arrive as untyped spec data: every entry parses them through the view's
+// schema (./schema.ts) before binding, so a contract mismatch fails loudly at
+// the boundary instead of rendering undefined fields or literal icon tags.
 
 import {
   Feature1 as FeatureBlock,
   ProductCategory2 as CategoryCardsBlock,
   StorefrontHero1 as StorefrontHeroBlock,
 } from '@thorprovider/blocks'
-import type { FeaturedProduct } from '@thorprovider/blocks'
 import { useStateStore } from '@json-render/react'
+import { resolveIcon } from '../../icon-map'
 import type { ViewRegistry } from '../types'
+import {
+  categoryCardsPropsSchema,
+  featurePropsSchema,
+  storefrontHeroPropsSchema,
+} from './schema'
 
 export const registry: ViewRegistry = {
   StorefrontHero: ({ props, emit }) => {
     const { set } = useStateStore()
+    const hero = storefrontHeroPropsSchema.parse(props)
     return (
       <StorefrontHeroBlock
-        title={props.title as string}
-        description={props.description as string}
-        products={props.products as FeaturedProduct[]}
-        titleAccent={props.titleAccent as string}
-        badge={props.badge as string}
-        primaryCta={props.primaryCta as never}
-        secondaryCta={props.secondaryCta as never}
+        title={hero.title}
+        description={hero.description}
+        products={hero.products}
+        titleAccent={hero.titleAccent}
+        badge={hero.badge}
+        primaryCta={hero.primaryCta}
+        secondaryCta={hero.secondaryCta}
+        heroImage={hero.heroImage}
         onAddToCart={(product) => {
+          // Product-card shortcut: add the first purchasable variant.
           set('/lastClicked', product)
-          emit('addToCart')
+          emit('addClickedToCart')
         }}
         onBuyNow={(product) => {
           set('/lastClicked', product)
@@ -39,24 +51,28 @@ export const registry: ViewRegistry = {
       />
     )
   },
-  Feature: ({ props }) => (
-    <FeatureBlock
-      items={props.items as never}
-      badge={props.badge as string}
-      title={props.title as string}
-      description={props.description as string}
-    />
-  ),
+  Feature: ({ props }) => {
+    const feature = featurePropsSchema.parse(props)
+    return (
+      <FeatureBlock
+        items={feature.items.map((item) => ({ ...item, icon: resolveIcon(item.icon) }))}
+        badge={feature.badge}
+        title={feature.title}
+        description={feature.description}
+      />
+    )
+  },
   CategoryCards: ({ props, emit }) => {
     const { set } = useStateStore()
+    const cards = categoryCardsPropsSchema.parse(props)
     return (
       <CategoryCardsBlock
-        title={props.title as string}
-        description={props.description as string}
-        categories={props.categories as never}
-        cta={props.cta as never}
+        title={cards.title}
+        description={cards.description}
+        categories={cards.categories}
+        cta={cards.cta}
         onBrowse={(category) => {
-          set('/lastCategory', (category.handle as string) ?? String(category.id))
+          set('/lastCategory', category.handle ?? String(category.id))
           emit('openCategory')
         }}
       />