@thorprovider/storefront 0.3.1 → 0.4.0-mvp.0

package/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/recipes/manifest.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://thorcommerce.dev/storefront/manifest.schema.json",
+  "title": "Thor Commerce Storefront Composition Manifest",
+  "type": "object",
+  "required": ["version", "name", "theme", "views", "features"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "type": "string", "minLength": 1 },
+    "name": { "type": "string", "minLength": 1 },
+    "siteName": { "type": "string" },
+    "theme": {
+      "type": "object",
+      "required": ["mode"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["light", "dark", "system"] }
+      }
+    },
+    "views": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "intents": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "variants": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "sections": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "type": { "type": "string", "minLength": 1 },
+                "name": { "type": "string", "minLength": 1 },
+                "variant": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "preservedSectionIds": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "config": { "type": "object" }
+        }
+      }
+    }
+  }
+}

package/recipes/operations.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://thorcommerce.dev/storefront/operations.schema.json",
+  "title": "Thor Commerce Storefront Operations Envelope",
+  "description": "The versioned input envelope for `storefront plan --operations`. `formatVersion` must equal 1, aligned with the catalog `catalogVersion` (both 1 in E1). E1 accepts exactly six namespaced operations: view.add, view.remove, view.configure, feature.add, feature.remove, feature.configure. The per-operation field contract (which fields are required, which optional, and the exactly-one `intent` / `variant` / `reset: true` rule) is declared by OPERATION_SCHEMAS in scripts/operations.mjs, which is the runtime authority; this published schema is the closed structural contract. Unknown operation names, unknown fields, and a `force` field are not part of version 1 (`force` is an internal add/refresh control used by the legacy `view add --force` alias and by plan/apply, never a public operation field).",
+  "type": "object",
+  "required": ["formatVersion", "operations"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "formatVersion": { "type": "number", "enum": [1] },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["op"],
+        "additionalProperties": false,
+        "properties": {
+          "op": {
+            "type": "string",
+            "enum": [
+              "view.add",
+              "view.remove",
+              "view.configure",
+              "feature.add",
+              "feature.remove",
+              "feature.configure"
+            ]
+          },
+          "view": { "type": "string", "minLength": 1 },
+          "slot": { "type": "string", "minLength": 1 },
+          "intent": { "type": "string", "minLength": 1 },
+          "variant": { "type": "string", "minLength": 1 },
+          "reset": { "type": "boolean" },
+          "intents": { "type": "object", "additionalProperties": { "type": "string" } },
+          "variants": { "type": "object", "additionalProperties": { "type": "string" } },
+          "feature": { "type": "string", "minLength": 1 },
+          "config": { "type": "object" }
+        }
+      }
+    }
+  }
+}

package/recipes/recipe.schema.json

@@ -23,7 +23,7 @@
         "properties": {
           "name": {
             "type": "string",
-            "enum": ["home", "product", "category", "checkout", "user-panel"]
+            "enum": ["home", "product", "category", "checkout", "account", "static", "user-panel"]
           },
           "description": { "type": "string" },
           "route": { "type": "string" },
@@ -51,7 +51,16 @@
               "type": "string",
               "enum": ["testimonials", "faq", "statistics", "logoCloud", "pricing"]
             }
-          }
+          },
+          "registeredSlots": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "allowedSections": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["faq", "cta"] }
+          },
+          "maxSections": { "type": "number" }
         }
       }
     }

package/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/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"
     }
   ]
 }