@thorprovider/storefront 0.3.1 → 0.4.0-mvp.0

package/skills/sf-view-gen/assets/recipes/catalog.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://thorcommerce.dev/storefront/catalog.schema.json",
+  "title": "Thor Commerce Storefront Semantic Catalog",
+  "description": "The semantic executable catalog: per view slot and candidate variant, its execution status (executable | held), the block it renders, its canonical data shape, emitted events, controlled/uncontrolled state, requirements, and an optional prop bridge. Held entries carry a reason. Also declares operational capabilities with their backend/data requirements and a verification state (verified | unverified); an unverified capability names its owning change in `owner`. Versioned by catalogVersion.",
+  "type": "object",
+  "required": ["catalogVersion", "slots"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "catalogVersion": { "type": "number", "enum": [1] },
+    "description": { "type": "string" },
+    "slots": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["default", "variants"],
+        "additionalProperties": false,
+        "properties": {
+          "default": { "type": "string", "minLength": 1 },
+          "variants": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "required": ["status", "block", "dataShape", "events", "state", "requirements"],
+              "additionalProperties": false,
+              "properties": {
+                "status": { "type": "string", "enum": ["executable", "held"] },
+                "reason": { "type": "string", "minLength": 1 },
+                "block": { "type": "string", "minLength": 1 },
+                "dataShape": { "type": "string", "minLength": 1 },
+                "events": { "type": "array", "items": { "type": "string" } },
+                "state": { "type": "string", "enum": ["controlled", "uncontrolled"] },
+                "requirements": { "type": "array", "items": { "type": "string" } },
+                "bridge": {
+                  "type": "object",
+                  "required": ["from", "to"],
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": { "type": "string", "minLength": 1 },
+                    "to": { "type": "string", "minLength": 1 }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["requirements", "verification"],
+        "additionalProperties": false,
+        "properties": {
+          "requirements": { "type": "array", "items": { "type": "string" } },
+          "verification": { "type": "string", "enum": ["verified", "unverified"] },
+          "owner": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/skills/sf-view-gen/assets/recipes/features.json

@@ -0,0 +1,139 @@
+{
+  "version": "1.0.0",
+  "features": [
+    {
+      "name": "checkout",
+      "mvp": true,
+      "description": "Multi-step checkout: cart validation, shipping, payment, and order placement.",
+      "route": "/checkout",
+      "views": ["checkout"],
+      "state": [
+        "checkout",
+        "checkoutCountries",
+        "checkoutPaymentMethods",
+        "checkoutPending",
+        "checkoutError",
+        "lastOrder",
+        "lastOrderLines",
+        "orderPlaced"
+      ],
+      "handlers": ["placeOrder", "goToCheckout", "continueShopping"],
+      "adapter": { "needs": ["createCart", "completeCheckout"] },
+      "config": { "type": "object", "additionalProperties": false, "properties": {} },
+      "configRejection": {
+        "code": "E_UNPROVEN_CHECKOUT_OPTION",
+        "message": "checkout variants and route options are not proven; the checkout feature accepts an empty config only"
+      },
+      "surfaces": []
+    },
+    {
+      "name": "customer-auth",
+      "mvp": true,
+      "description": "Customer authentication: registration, login, logout, and a minimal signed-in state. Owns the account view.",
+      "route": "/cuenta",
+      "views": ["account"],
+      "state": [
+        "accountCustomer",
+        "accountAuthenticated",
+        "accountMode",
+        "accountPending",
+        "accountError"
+      ],
+      "handlers": ["logout", "showRegister", "showLogin"],
+      "adapter": { "needs": [] },
+      "config": { "type": "object", "additionalProperties": false, "properties": {} },
+      "surfaces": []
+    },
+    {
+      "name": "static-pages",
+      "mvp": true,
+      "description": "Content-driven static pages (contact, legal, about) served with per-page metadata. Owns the static view.",
+      "route": "/contacto",
+      "views": ["static"],
+      "state": [],
+      "handlers": [],
+      "adapter": { "needs": [] },
+      "config": { "type": "object", "additionalProperties": false, "properties": {} },
+      "surfaces": []
+    },
+    {
+      "name": "benefits",
+      "mvp": true,
+      "description": "Bounded editorial benefits feature that mounts at the home benefits slot; config selects the Feature1/Feature2 presentation while the item content stays user-owned.",
+      "views": [],
+      "state": [],
+      "handlers": [],
+      "adapter": { "needs": [] },
+      "config": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "presentation": { "type": "string", "enum": ["compact", "detailed"], "default": "compact" }
+        }
+      },
+      "presentations": { "compact": "Feature1", "detailed": "Feature2" },
+      "mounts": [{ "id": "home-benefits", "host": "home", "slot": "benefits" }],
+      "surfaces": []
+    },
+    {
+      "name": "catalog-search",
+      "mvp": true,
+      "description": "Optional category-listing search control (E2). Installation is presence, not an enabled flag; the config only supplies an optional placeholder. The search input contributes to the single controlled CategoryFilter2 at the category.search logical slot and never adds a block.",
+      "views": [],
+      "state": [],
+      "handlers": [],
+      "adapter": { "needs": [] },
+      "config": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "placeholder": { "type": "string" }
+        }
+      },
+      "mounts": [{ "id": "category-search", "host": "category", "slot": "search" }],
+      "surfaces": []
+    },
+    {
+      "name": "category-filters",
+      "mvp": true,
+      "description": "Optional category-listing filter controls (E2). Installation is presence, not an enabled flag; the config selects which demonstrated basic filters show (filterSet) and whether the price control is shown (showPrice). The controls contribute to the single controlled CategoryFilter2 at the category.filters logical slot and never add a block.",
+      "views": [],
+      "state": [],
+      "handlers": [],
+      "adapter": { "needs": [] },
+      "config": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "filterSet": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["categories", "collections"] },
+            "default": ["categories", "collections"]
+          },
+          "showPrice": { "type": "boolean", "default": false }
+        }
+      },
+      "configRejection": {
+        "code": "E_UNVERIFIED_PRICE_RANGE",
+        "message": "showPrice: true requires a verified price range for the listing scope; capability \"category.price.range\" is unverified (held), so configure showPrice: false until a real range is demonstrated",
+        "when": { "field": "showPrice", "equals": true },
+        "capability": "category.price.range"
+      },
+      "mounts": [{ "id": "category-filters", "host": "category", "slot": "filters" }],
+      "surfaces": []
+    },
+    {
+      "name": "recommendations",
+      "mvp": false,
+      "description": "Related-products surface injected into the product view.",
+      "views": [],
+      "state": ["recommendedProducts"],
+      "handlers": [],
+      "adapter": { "needs": ["getRelatedProducts"], "fallback": "catalog" },
+      "config": { "type": "object", "additionalProperties": false, "properties": {} },
+      "surfaces": [
+        { "host": "product", "slot": "product.related", "element": "ProductCard" }
+      ]
+    }
+  ]
+}

package/skills/sf-view-gen/assets/recipes/recipes.json

@@ -4,6 +4,7 @@
   "views": [
     {
       "name": "home",
+      "mvp": true,
       "description": "Storefront landing page with hero, benefits, and category highlights",
       "route": "/",
       "loader": "home",
@@ -19,10 +20,14 @@
         "categories": ["ProductCategory1", "ProductCategory2", "ProductCategory4", "ProductCategory5"],
         "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
       },
-      "optionalSections": ["testimonials", "faq", "statistics", "logoCloud", "pricing"]
+      "optionalSections": ["testimonials", "faq", "statistics", "logoCloud", "pricing"],
+      "registeredSlots": ["hero", "benefits", "categories"],
+      "allowedSections": ["faq", "cta"],
+      "maxSections": 4
     },
     {
       "name": "product",
+      "mvp": true,
       "description": "Single product detail page with overview, gallery, and reviews",
       "route": "/productos/[id]",
       "loader": "product",
@@ -36,10 +41,14 @@
         "reviews": ["ReviewRating1", "ReviewRating2"],
         "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
       },
-      "optionalSections": ["testimonials", "faq", "statistics"]
+      "optionalSections": ["testimonials", "faq", "statistics"],
+      "registeredSlots": ["overview", "reviews"],
+      "allowedSections": [],
+      "maxSections": 4
     },
     {
       "name": "category",
+      "mvp": true,
       "description": "Product listing filtered by category with filters and sorting",
       "route": "/categorias/[[...slug]]",
       "loader": "category",
@@ -52,10 +61,14 @@
         "filter": ["CategoryFilter1", "CategoryFilter2", "CategoryFilter4"],
         "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
       },
-      "optionalSections": ["logoCloud", "testimonials"]
+      "optionalSections": ["logoCloud", "testimonials"],
+      "registeredSlots": ["filter", "productCard"],
+      "allowedSections": ["faq", "cta"],
+      "maxSections": 4
     },
     {
       "name": "checkout",
+      "mvp": true,
       "description": "Multi-step checkout with cart summary, shipping, and payment",
       "route": "/checkout",
       "loader": "checkout",
@@ -68,10 +81,49 @@
         "checkout": ["CheckoutForm1", "CheckoutForm2", "CheckoutForm3"],
         "confirmation": ["CheckoutConfirmation"]
       },
-      "optionalSections": []
+      "optionalSections": [],
+      "registeredSlots": ["checkout", "confirmation"],
+      "allowedSections": [],
+      "maxSections": 4
+    },
+    {
+      "name": "account",
+      "mvp": true,
+      "description": "Customer account area with sign-in, registration, and a minimal signed-in state",
+      "route": "/cuenta",
+      "loader": "account",
+      "requiredDataKeys": ["accountCustomer"],
+      "defaultVariants": {
+        "login": "LoginPage1",
+        "register": "SignUpPage1"
+      },
+      "allowedVariants": {
+        "login": ["LoginPage1", "LoginPage2"],
+        "register": ["SignUpPage1"],
+        "orders": ["OrderHistory1", "OrderHistory2"]
+      },
+      "optionalSections": [],
+      "registeredSlots": ["login", "register", "orders"],
+      "allowedSections": [],
+      "maxSections": 4
+    },
+    {
+      "name": "static",
+      "mvp": true,
+      "description": "Content-driven static pages (contact, legal, about) with per-page metadata",
+      "route": "/contacto",
+      "loader": "static",
+      "requiredDataKeys": [],
+      "defaultVariants": {},
+      "allowedVariants": {},
+      "optionalSections": [],
+      "registeredSlots": [],
+      "allowedSections": [],
+      "maxSections": 0
     },
     {
       "name": "user-panel",
+      "mvp": false,
       "description": "Customer account area with order history and account navigation",
       "route": "/cuenta",
       "loader": "userPanel",
@@ -84,7 +136,10 @@
         "shell": ["AppShell1"],
         "orderHistory": ["OrderHistory1", "OrderHistory2"]
       },
-      "optionalSections": []
+      "optionalSections": [],
+      "registeredSlots": ["shell", "orderHistory"],
+      "allowedSections": [],
+      "maxSections": 4
     }
   ]
 }

package/skills/sf-view-gen/assets/recipes/sections.json

@@ -1,6 +1,7 @@
 {
   "$schema": "./section.schema.json",
   "version": "1.0.0",
+  "description": "Editorial section registry. Each entry declares a `status`: `executable` (shipped, with a verified presentation bridge/provenance and no backend data source required) or `held` (bounded curation: no verified presentation bridge/provenance in the current composition or no verified backend/data source for the MVP; not an intrinsic exclusion). A held entry declares a non-empty `reason`. The status is the single source of truth that `recipes/validate.mjs` and the CLI introspection read; there is no separate held list.",
   "sections": [
     {
       "name": "testimonials",
@@ -8,7 +9,9 @@
       "elementType": "Testimonials",
       "variants": ["Testimonial1", "Testimonial2"],
       "defaultVariant": "Testimonial1",
-      "propsHint": "title, badge, items[] (quote, author, role, avatar)"
+      "propsHint": "title, badge, items[] (quote, author, role, avatar)",
+      "status": "held",
+      "reason": "bounded curation: no verified presentation bridge/provenance in the current composition and no verified backend/data source for the MVP"
     },
     {
       "name": "faq",
@@ -16,7 +19,17 @@
       "elementType": "Faq",
       "variants": ["FaqBlock1"],
       "defaultVariant": "FaqBlock1",
-      "propsHint": "title, description, items[] (question, answer)"
+      "propsHint": "title, description, items[] (question, answer)",
+      "status": "executable"
+    },
+    {
+      "name": "cta",
+      "description": "Call-to-action banner with primary and secondary links",
+      "elementType": "Cta",
+      "variants": ["CtaSection1"],
+      "defaultVariant": "CtaSection1",
+      "propsHint": "badgeText, title, description, primaryCta/secondaryCta (label, href)",
+      "status": "executable"
     },
     {
       "name": "statistics",
@@ -24,7 +37,9 @@
       "elementType": "Statistics",
       "variants": ["Statistic1"],
       "defaultVariant": "Statistic1",
-      "propsHint": "title, items[] (value, label)"
+      "propsHint": "title, items[] (value, label)",
+      "status": "held",
+      "reason": "bounded curation: no verified backend/data source for the metrics and no verified presentation bridge/provenance in the current composition"
     },
     {
       "name": "logoCloud",
@@ -32,7 +47,9 @@
       "elementType": "LogoCloud",
       "variants": ["LogoCloud1"],
       "defaultVariant": "LogoCloud1",
-      "propsHint": "title, platforms[]/logos[] (name, src)"
+      "propsHint": "title, platforms[]/logos[] (name, src)",
+      "status": "held",
+      "reason": "bounded curation: no verified backend/data source for partner/brand logos and no verified presentation bridge/provenance in the current composition"
     },
     {
       "name": "pricing",
@@ -40,7 +57,9 @@
       "elementType": "Pricing",
       "variants": ["PricingSection1"],
       "defaultVariant": "PricingSection1",
-      "propsHint": "title, description, tiers[] (name, price, features, cta)"
+      "propsHint": "title, description, tiers[] (name, price, features, cta)",
+      "status": "held",
+      "reason": "bounded curation: no verified backend/data source for pricing tiers and no verified presentation bridge/provenance in the current composition"
     }
   ]
 }

package/skills/sf-view-gen/assets/templates/views/sections/cta.client.tsx

@@ -0,0 +1,25 @@
+'use client'
+
+// Optional section fragment: cta (mirrors recipes/sections.json) — client registry.
+// The matching server-side catalog lives in cta.tsx. @thorprovider/blocks ships a
+// 'use client' boundary, but this fragment keeps the explicit client boundary so
+// the section composes identically in any consumer graph.
+
+import { CtaSection1 as CtaBlock } from '@thorprovider/blocks'
+import { ctaSection1PropsSchema } from './schema.cta'
+import type { ViewRegistry } from '../types'
+
+export const ctaRegistry: ViewRegistry = {
+  Cta: ({ props }) => {
+    const parsed = ctaSection1PropsSchema.parse(props)
+    return (
+      <CtaBlock
+        badgeText={parsed.badgeText}
+        title={parsed.title}
+        description={parsed.description}
+        primaryCta={parsed.primaryCta}
+        secondaryCta={parsed.secondaryCta}
+      />
+    )
+  },
+}

package/skills/sf-view-gen/assets/templates/views/sections/cta.tsx

@@ -0,0 +1,16 @@
+// Optional section fragment: cta (mirrors recipes/sections.json)
+// Server-side part: element type + zod catalog entry. The component mappings
+// live in cta.client.tsx ('use client') and are composed via composeSections.
+
+import { ctaSection1PropsSchema } from './schema.cta'
+
+export const ctaSection = {
+  elementType: 'Cta',
+  catalog: {
+    Cta: {
+      props: ctaSection1PropsSchema,
+      description: 'Call-to-action banner with optional primary and secondary links.',
+    },
+  },
+  registryModule: './cta.client',
+}

package/skills/sf-view-gen/assets/templates/views/sections/faq.client.tsx

@@ -6,15 +6,19 @@
 // the section composes identically in any consumer graph.
 
 import { FaqBlock1 as FaqBlock } from '@thorprovider/blocks'
+import { faqPropsSchema } from './schema.faq'
 import type { ViewRegistry } from '../types'
 
-export const registry: ViewRegistry = {
-  Faq: ({ props }) => (
-    <FaqBlock
-      title={(props.title as string) ?? 'Preguntas frecuentes'}
-      description={props.description as string}
-      items={props.items as never}
-      accordionType={(props.accordionType as 'single' | 'multiple') ?? 'single'}
-    />
-  ),
+export const faqRegistry: ViewRegistry = {
+  Faq: ({ props }) => {
+    const parsed = faqPropsSchema.parse(props)
+    return (
+      <FaqBlock
+        title={parsed.title ?? 'Preguntas frecuentes'}
+        description={parsed.description}
+        items={parsed.items}
+        accordionType={parsed.accordionType ?? 'single'}
+      />
+    )
+  },
 }

package/skills/sf-view-gen/assets/templates/views/sections/faq.tsx

@@ -2,18 +2,13 @@
 // Server-side part: element type + zod catalog entry. The component mappings
 // live in faq.client.tsx ('use client') and are composed via composeSections.
 
-import { z } from 'zod'
+import { faqPropsSchema } from './schema.faq'
 
 export const faqSection = {
   elementType: 'Faq',
   catalog: {
     Faq: {
-      props: z.object({
-        title: z.string().optional(),
-        description: z.string().optional(),
-        items: z.array(z.record(z.string(), z.unknown())),
-        accordionType: z.enum(['single', 'multiple']).optional(),
-      }),
+      props: faqPropsSchema,
       description: 'Frequently asked questions accordion.',
     },
   },

package/skills/sf-view-gen/assets/templates/views/sections/logoCloud.client.tsx

@@ -4,15 +4,19 @@
 // The matching server-side catalog entry lives in logoCloud.tsx.
 
 import { LogoCloud1 as LogoCloudBlock } from '@thorprovider/blocks'
+import { logoCloudPropsSchema } from './schema.logoCloud'
 import type { ViewRegistry } from '../types'
 
 export const registry: ViewRegistry = {
-  LogoCloud: ({ props }) => (
-    <LogoCloudBlock
-      title={(props.title as string) ?? 'Marcas que confían en nosotros'}
-      description={props.description as string}
-      moreLabel={props.moreLabel as string}
-      platforms={props.platforms as never}
-    />
-  ),
+  LogoCloud: ({ props }) => {
+    const parsed = logoCloudPropsSchema.parse(props)
+    return (
+      <LogoCloudBlock
+        title={parsed.title ?? 'Marcas que confían en nosotros'}
+        description={parsed.description}
+        moreLabel={parsed.moreLabel}
+        platforms={parsed.platforms}
+      />
+    )
+  },
 }

package/skills/sf-view-gen/assets/templates/views/sections/logoCloud.tsx

@@ -2,18 +2,13 @@
 // Server-side part: element type + zod catalog entry. The component mappings
 // live in logoCloud.client.tsx ('use client').
 
-import { z } from 'zod'
+import { logoCloudPropsSchema } from './schema.logoCloud'
 
 export const logoCloudSection = {
   elementType: 'LogoCloud',
   catalog: {
     LogoCloud: {
-      props: z.object({
-        title: z.string().optional(),
-        description: z.string().optional(),
-        moreLabel: z.string().optional(),
-        platforms: z.array(z.record(z.string(), z.unknown())),
-      }),
+      props: logoCloudPropsSchema,
       description: 'Brand or partner logo strip.',
     },
   },

package/skills/sf-view-gen/assets/templates/views/sections/pricing.client.tsx

@@ -4,17 +4,21 @@
 // The matching server-side catalog entry lives in pricing.tsx.
 
 import { PricingSection1 as PricingBlock } from '@thorprovider/blocks'
+import { pricingPropsSchema } from './schema.pricing'
 import type { ViewRegistry } from '../types'
 
 export const registry: ViewRegistry = {
-  Pricing: ({ props }) => (
-    <PricingBlock
-      sectionTitle={(props.sectionTitle as string) ?? 'Planes y precios'}
-      sectionLabel={props.sectionLabel as string}
-      currencySymbol={props.currencySymbol as string}
-      popularBadgeLabel={(props.popularBadgeLabel as string) ?? 'Popular'}
-      getStartedLabel={(props.getStartedLabel as string) ?? 'Empezar'}
-      tiers={props.tiers as never}
-    />
-  ),
+  Pricing: ({ props }) => {
+    const parsed = pricingPropsSchema.parse(props)
+    return (
+      <PricingBlock
+        sectionTitle={parsed.sectionTitle ?? 'Planes y precios'}
+        sectionLabel={parsed.sectionLabel}
+        currencySymbol={parsed.currencySymbol}
+        popularBadgeLabel={parsed.popularBadgeLabel ?? 'Popular'}
+        getStartedLabel={parsed.getStartedLabel ?? 'Empezar'}
+        tiers={parsed.tiers}
+      />
+    )
+  },
 }

package/skills/sf-view-gen/assets/templates/views/sections/pricing.tsx

@@ -2,20 +2,13 @@
 // Server-side part: element type + zod catalog entry. The component mappings
 // live in pricing.client.tsx ('use client').
 
-import { z } from 'zod'
+import { pricingPropsSchema } from './schema.pricing'
 
 export const pricingSection = {
   elementType: 'Pricing',
   catalog: {
     Pricing: {
-      props: z.object({
-        sectionTitle: z.string().optional(),
-        sectionLabel: z.string().optional(),
-        currencySymbol: z.string().optional(),
-        popularBadgeLabel: z.string().optional(),
-        getStartedLabel: z.string().optional(),
-        tiers: z.array(z.record(z.string(), z.unknown())),
-      }),
+      props: pricingPropsSchema,
       description: 'Pricing tiers or plans.',
     },
   },

package/skills/sf-view-gen/assets/templates/views/sections/schema.cta.ts

@@ -0,0 +1,19 @@
+// Optional section fragment: cta (mirrors recipes/sections.json) — shared contract.
+// Zod mirror of the Cta/CtaSection1Props block contracts, shared by the server
+// catalog (cta.tsx) and the client registry (cta.client.tsx). The React-only
+// callbacks (onPrimaryClick/onSecondaryClick) are intentionally excluded.
+
+import { z } from 'zod'
+
+export const ctaSchema = z.object({
+  label: z.string(),
+  href: z.string().optional(),
+})
+
+export const ctaSection1PropsSchema = z.object({
+  badgeText: z.string().optional(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  primaryCta: ctaSchema.optional(),
+  secondaryCta: ctaSchema.optional(),
+})

package/skills/sf-view-gen/assets/templates/views/sections/schema.faq.ts

@@ -0,0 +1,18 @@
+// Optional section fragment: faq (mirrors recipes/sections.json) — shared contract.
+// Zod mirror of the FaqItem/FaqBlock1Props block contracts, shared by the server
+// catalog (faq.tsx) and the client registry (faq.client.tsx).
+
+import { z } from 'zod'
+
+export const faqItemSchema = z.object({
+  value: z.string(),
+  question: z.string(),
+  answer: z.string(),
+})
+
+export const faqPropsSchema = z.object({
+  title: z.string().optional(),
+  description: z.string().optional(),
+  items: z.array(faqItemSchema),
+  accordionType: z.enum(['single', 'multiple']).optional(),
+})

package/skills/sf-view-gen/assets/templates/views/sections/schema.logoCloud.ts

@@ -0,0 +1,19 @@
+// Optional section fragment: logoCloud (mirrors recipes/sections.json) — shared contract.
+// Zod mirror of the LogoCloud1Platform/LogoCloud1Props block contracts, shared
+// by the server catalog (logoCloud.tsx) and the client registry
+// (logoCloud.client.tsx). `id` is a simple-icons slug resolved internally by
+// the block.
+
+import { z } from 'zod'
+
+export const logoCloudPlatformSchema = z.object({
+  name: z.string(),
+  id: z.string(),
+})
+
+export const logoCloudPropsSchema = z.object({
+  title: z.string().optional(),
+  description: z.string().optional(),
+  moreLabel: z.string().optional(),
+  platforms: z.array(logoCloudPlatformSchema),
+})