@jay-framework/wix-stores 0.19.7 → 0.20.0

package/README.md

@@ -64,9 +64,6 @@ Run `jay-stack agent-kit` (or `yarn agent-kit`) to index the live category tree
 urls:
   product: '/products/{slug}' # default
   category: null # no category pages by default
-
-# Fallback category for pages without category context
-defaultCategory: 'all-products' # slug of the fallback category
 ```
 
 URL templates use three placeholders:
@@ -114,7 +111,6 @@ src/pages/products/
 urls:
   product: '/products/{prefix}/{category}/{slug}'
   category: '/products/{prefix}/{category}'
-defaultCategory: 'all-products'
 ```
 
 ```
@@ -154,12 +150,12 @@ src/pages/products/polgat/
 
 ### Setting Params for Static Routes
 
-Static route directories use `jay-params` to tell the component which prefix they represent:
+Static route directories use `jay-params` to tell the component which category they represent:
 
 ```html
-<!-- src/pages/products/polgat/page.jay-html -->
+<!-- src/pages/products/polgat/page.jay-html (root category) -->
 <script type="application/jay-params">
-  prefix: polgat
+  category: polgat
 </script>
 <script
   type="application/jay-headless"
@@ -171,11 +167,10 @@ Static route directories use `jay-params` to tell the component which prefix the
 
 ## Category Header
 
-The category header is always loaded. The component resolves category metadata using a fallback chain:
+The category header is always loaded. The component resolves category metadata:
 
-1. **`category` param** → load category
-2. **`prefix` param** → load root category
-3. **Neither** → load `defaultCategory` from config
+1. **`category` param** → load category (always the active category slug)
+2. **No `category`** → load the "All Products" system category via `getAllProductsCategory()` (header only, no base filter)
 
 If the resolved category is missing image, description, or SEO data, the component walks up the parent chain until it finds the data. Each field inherits independently.
 

package/dist/agent-kit/aiditor/add-menu.template.yaml

@@ -5,7 +5,11 @@ items:
     subCategory: Components
     pluginName: wix-stores
     packageName: "@jay-framework/wix-stores"
-    thumbnail: thumbnails/wix-stores/product-search.png
+    thumbnail: thumbnails/wix-stores/product-search.svg
+    interaction:
+      mode: stage-place
+      stagePromptTemplate: |
+        Add a product search component at this marker location on the page.
     prompt: |
       Use headless component @jay-framework/wix-stores / contract product-search.
       Read agent-kit/materialized-contracts/wix-stores/product-search.jay-contract.
@@ -18,7 +22,11 @@ items:
     subCategory: Components
     pluginName: wix-stores
     packageName: "@jay-framework/wix-stores"
-    thumbnail: thumbnails/wix-stores/product-page.png
+    thumbnail: thumbnails/wix-stores/product-page.svg
+    interaction:
+      mode: stage-place
+      stagePromptTemplate: |
+        Add a product page component at this marker location on the page.
     prompt: |
       Use headless component @jay-framework/wix-stores / contract product-page.
       Read agent-kit/materialized-contracts/wix-stores/product-page.jay-contract.
@@ -31,7 +39,11 @@ items:
     subCategory: Components
     pluginName: wix-stores
     packageName: "@jay-framework/wix-stores"
-    thumbnail: thumbnails/wix-stores/category-products.png
+    thumbnail: thumbnails/wix-stores/category-products.svg
+    interaction:
+      mode: stage-place
+      stagePromptTemplate: |
+        Add a category products grid at this marker location on the page.
     prompt: |
       Use headless component @jay-framework/wix-stores / contract category-products.
       Read agent-kit/materialized-contracts/wix-stores/category-products.jay-contract.
@@ -46,6 +58,10 @@ items:
     pluginName: wix-stores
     packageName: "@jay-framework/wix-stores"
     thumbnail: thumbnails/wix-stores/product-spotlight.png
+    interaction:
+      mode: stage-place
+      stagePromptTemplate: |
+        Add a product spotlight at this marker location on the page.
     prompt: |
       Use headless component @jay-framework/wix-stores / contract product-spotlight.
       Read agent-kit/materialized-contracts/wix-stores/product-spotlight.jay-contract.
@@ -59,7 +75,11 @@ items:
     subCategory: Components
     pluginName: wix-stores
     packageName: "@jay-framework/wix-stores"
-    thumbnail: thumbnails/wix-stores/category-list.png
+    thumbnail: thumbnails/wix-stores/category-list.svg
+    interaction:
+      mode: stage-place
+      stagePromptTemplate: |
+        Add a category list at this marker location on the page.
     prompt: |
       Use headless component @jay-framework/wix-stores / contract category-list.
       Read agent-kit/materialized-contracts/wix-stores/category-list.jay-contract.

package/dist/agent-kit/aiditor/thumbnails/wix-stores/category-list.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="240" viewBox="0 0 320 240" fill="none">
+  <rect width="320" height="240" fill="#f8fafc"/>
+  <rect x="16" y="20" width="288" height="36" rx="8" fill="#fff" stroke="#e2e8f0"/>
+  <rect x="28" y="32" width="120" height="12" rx="3" fill="#cbd5e1"/>
+  <rect x="16" y="72" width="136" height="14" rx="4" fill="#e2e8f0"/>
+  <rect x="16" y="98" width="288" height="1" fill="#e2e8f0"/>
+  <rect x="16" y="112" width="200" height="12" rx="3" fill="#cbd5e1"/>
+  <rect x="16" y="136" width="160" height="10" rx="3" fill="#e2e8f0"/>
+  <rect x="16" y="168" width="288" height="1" fill="#e2e8f0"/>
+  <rect x="16" y="182" width="184" height="12" rx="3" fill="#cbd5e1"/>
+  <rect x="16" y="206" width="128" height="10" rx="3" fill="#e2e8f0"/>
+</svg>

package/dist/agent-kit/aiditor/thumbnails/wix-stores/category-products.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="240" viewBox="0 0 320 240" fill="none">
+  <rect width="320" height="240" fill="#f8fafc"/>
+  <rect x="16" y="24" width="120" height="12" rx="3" fill="#cbd5e1"/>
+  <rect x="16" y="56" width="72" height="96" rx="8" fill="#fff" stroke="#e2e8f0"/>
+  <rect x="24" y="64" width="56" height="48" rx="4" fill="#dbeafe"/>
+  <rect x="24" y="120" width="48" height="8" rx="2" fill="#cbd5e1"/>
+  <rect x="96" y="56" width="72" height="96" rx="8" fill="#fff" stroke="#e2e8f0"/>
+  <rect x="104" y="64" width="56" height="48" rx="4" fill="#fce7f3"/>
+  <rect x="104" y="120" width="48" height="8" rx="2" fill="#cbd5e1"/>
+  <rect x="176" y="56" width="72" height="96" rx="8" fill="#fff" stroke="#e2e8f0"/>
+  <rect x="184" y="64" width="56" height="48" rx="4" fill="#dcfce7"/>
+  <rect x="184" y="120" width="48" height="8" rx="2" fill="#cbd5e1"/>
+  <rect x="248" y="56" width="56" height="96" rx="8" fill="#fff" stroke="#e2e8f0"/>
+  <rect x="256" y="64" width="40" height="48" rx="4" fill="#fef3c7"/>
+</svg>

package/dist/agent-kit/aiditor/thumbnails/wix-stores/product-page.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="240" viewBox="0 0 320 240" fill="none">
+  <rect width="320" height="240" fill="#f4f7fb"/>
+  <rect x="16" y="16" width="288" height="28" rx="6" fill="#e2e8f0"/>
+  <rect x="16" y="56" width="120" height="12" rx="3" fill="#cbd5e1"/>
+  <rect x="16" y="76" width="88" height="10" rx="3" fill="#e2e8f0"/>
+  <rect x="16" y="104" width="136" height="120" rx="8" fill="#dbeafe" stroke="#93c5fd"/>
+  <rect x="168" y="104" width="136" height="16" rx="4" fill="#cbd5e1"/>
+  <rect x="168" y="128" width="96" height="10" rx="3" fill="#e2e8f0"/>
+  <rect x="168" y="148" width="72" height="10" rx="3" fill="#e2e8f0"/>
+  <rect x="168" y="180" width="88" height="28" rx="6" fill="#2563eb"/>
+  <text x="188" y="198" fill="#fff" font-family="system-ui,sans-serif" font-size="11">Add to cart</text>
+</svg>

package/dist/agent-kit/aiditor/thumbnails/wix-stores/product-search.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="320" height="240" viewBox="0 0 320 240" fill="none">
+  <rect width="320" height="240" fill="#f8fafc"/>
+  <rect x="16" y="16" width="200" height="24" rx="6" fill="#fff" stroke="#cbd5e1"/>
+  <rect x="24" y="24" width="64" height="8" rx="2" fill="#e2e8f0"/>
+  <g>
+    <rect x="16" y="56" width="88" height="88" rx="8" fill="#fff" stroke="#e2e8f0"/>
+    <rect x="24" y="64" width="72" height="48" rx="4" fill="#dbeafe"/>
+    <rect x="24" y="120" width="56" height="8" rx="2" fill="#cbd5e1"/>
+    <rect x="112" y="56" width="88" height="88" rx="8" fill="#fff" stroke="#e2e8f0"/>
+    <rect x="120" y="64" width="72" height="48" rx="4" fill="#fce7f3"/>
+    <rect x="120" y="120" width="56" height="8" rx="2" fill="#cbd5e1"/>
+    <rect x="208" y="56" width="88" height="88" rx="8" fill="#fff" stroke="#e2e8f0"/>
+    <rect x="216" y="64" width="72" height="48" rx="4" fill="#dcfce7"/>
+    <rect x="216" y="120" width="56" height="8" rx="2" fill="#cbd5e1"/>
+  </g>
+  <rect x="16" y="160" width="288" height="64" rx="8" fill="#fff" stroke="#e2e8f0"/>
+</svg>

package/dist/index.d.ts

@@ -487,6 +487,8 @@ interface WixStoresService {
     getCustomizations(): Promise<Customization[]>;
     /** Get cached data extension schemas for products. Lazily loaded. */
     getDataExtensionSchemas(): Promise<DataExtensionSchema[]>;
+    /** Get the "All Products" system category ID. Lazily fetched and cached. */
+    getAllProductsCategoryId(): Promise<string | null>;
 }
 /**
  * Server service marker for Wix Stores.

package/dist/index.js

@@ -60,6 +60,7 @@ function provideWixStoresService(wixClient, options) {
   let cachedTree = null;
   let cachedCustomizations = null;
   let cachedExtensionSchemas = null;
+  let cachedAllProductsCategoryId;
   const categoriesClient = getCategoriesClient(wixClient);
   const customizationsClient = getCustomizationsV3Client(wixClient);
   const service = {
@@ -134,6 +135,17 @@ function provideWixStoresService(wixClient, options) {
         cachedExtensionSchemas = [];
       }
       return cachedExtensionSchemas;
+    },
+    async getAllProductsCategoryId() {
+      if (cachedAllProductsCategoryId !== void 0) return cachedAllProductsCategoryId;
+      try {
+        const result = await service.products.getAllProductsCategory();
+        cachedAllProductsCategoryId = result.categoryId ?? null;
+      } catch (error) {
+        console.error("[wix-stores] Failed to get All Products category:", error);
+        cachedAllProductsCategoryId = null;
+      }
+      return cachedAllProductsCategoryId;
     }
   };
   registerService(WIX_STORES_SERVICE_MARKER, service);
@@ -879,7 +891,10 @@ const EMPTY_CATEGORY_HEADER = {
 };
 async function findCategoryBySlug$1(categoriesClient, slug) {
   const result = await categoriesClient.queryCategories({ treeReference: { appNamespace: "@wix/stores" } }).eq("slug", slug).eq("visible", true).limit(1).find();
-  return result.items?.[0] ?? null;
+  const cat = result.items?.[0];
+  if (!cat?._id)
+    return null;
+  return loadCategoryDetails(categoriesClient, cat._id);
 }
 async function loadCategoryDetails(categoriesClient, categoryId) {
   try {
@@ -889,8 +904,7 @@ async function loadCategoryDetails(categoriesClient, categoryId) {
   }
 }
 async function buildCategoryHeader(wixStoreService, category, categoryUrlTemplate) {
-  const details = await loadCategoryDetails(wixStoreService.categories, category._id);
-  const cat = details || category;
+  const cat = category;
   const imageUrl = cat.image ? formatWixMediaUrl("", cat.image) : "";
   const description = cat.description || "";
   const categoryTree = await wixStoreService.getCategoryTree();
@@ -959,18 +973,16 @@ async function buildCategoryHeader(wixStoreService, category, categoryUrlTemplat
 async function renderSlowlyChanging$4(props, wixStores) {
   const Pipeline = RenderPipeline.for();
   const categorySlug = props.category ?? null;
-  const prefixSlug = props.prefix ?? null;
-  const defaultCategorySlug = wixStores.defaultCategory;
   let activeCategory = null;
   let baseCategoryId = null;
   if (categorySlug) {
     activeCategory = await findCategoryBySlug$1(wixStores.categories, categorySlug);
     baseCategoryId = activeCategory?._id ?? null;
-  } else if (prefixSlug) {
-    activeCategory = await findCategoryBySlug$1(wixStores.categories, prefixSlug);
-    baseCategoryId = activeCategory?._id ?? null;
-  } else if (defaultCategorySlug) {
-    activeCategory = await findCategoryBySlug$1(wixStores.categories, defaultCategorySlug);
+  } else {
+    const allProductsCategoryId = await wixStores.getAllProductsCategoryId();
+    if (allProductsCategoryId) {
+      activeCategory = await loadCategoryDetails(wixStores.categories, allProductsCategoryId);
+    }
   }
   const tree = await wixStores.getCategoryTree();
   const categoryHeader = activeCategory ? await buildCategoryHeader(wixStores, activeCategory, wixStores.urls.category) : EMPTY_CATEGORY_HEADER;
@@ -1156,12 +1168,13 @@ async function* loadSearchParams([wixStores]) {
       if (rootSlug) {
         params.push({ prefix: rootSlug, category: node.slug });
       } else {
-        params.push({ prefix: node.slug });
+        params.push({ category: node.slug });
       }
       for (const child of node.children) {
         collectParams(child, rootSlug ?? node.slug);
       }
     };
+    const allProductsCategoryId = await wixStores.getAllProductsCategoryId();
     const allCategories = [];
     let result = await wixStores.categories.queryCategories({
       treeReference: { appNamespace: "@wix/stores" }
@@ -1177,6 +1190,8 @@ async function* loadSearchParams([wixStores]) {
     for (const cat of allCategories) {
       if (!cat._id)
         continue;
+      if (cat._id === allProductsCategoryId)
+        continue;
       const node = {
         slug: cat.slug || "",
         itemCount: cat.itemCounter ?? 0,
@@ -1206,7 +1221,7 @@ async function* loadSearchParams([wixStores]) {
     for (const root of roots) {
       sumItems(root);
     }
-    const params = [];
+    const params = [{}];
     for (const root of roots) {
       collectParams(root, null);
     }
@@ -1932,16 +1947,39 @@ function buildCategoryAddMenuItems(roots, config) {
     prompt: buildCategoryPrompt(config, entry)
   }));
 }
+const PUBLIC_THUMBNAIL_ROOT = path.join("public", "aiditor-add-menu-thumbnails");
+function copyAiditorAddMenuThumbnails(ctx, resolvePackagePath, pluginName) {
+  const sourceDir = resolvePackagePath(
+    path.join("agent-kit", "aiditor", "thumbnails", pluginName)
+  );
+  if (!fs.existsSync(sourceDir)) return [];
+  const destDir = path.join(ctx.projectRoot, PUBLIC_THUMBNAIL_ROOT, pluginName);
+  const created = [];
+  fs.mkdirSync(destDir, { recursive: true });
+  for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
+    if (!entry.isFile()) continue;
+    const src = path.join(sourceDir, entry.name);
+    const dest = path.join(destDir, entry.name);
+    if (!fs.existsSync(dest) || ctx.force) {
+      fs.copyFileSync(src, dest);
+      created.push(path.posix.join(PUBLIC_THUMBNAIL_ROOT, pluginName, entry.name));
+    }
+  }
+  return created;
+}
 const CONFIG_FILE_NAME = ".wix-stores.yaml";
 const ADD_MENU_OUTPUT_REL = "agent-kit/aiditor/add-menu/wix-stores.yaml";
 const ADD_MENU_GENERATED_REL = "agent-kit/aiditor/add-menu/wix-stores.generated.yaml";
-function resolveAddMenuTemplatePath() {
+function resolvePackageAgentKitPath(relativePath) {
   const thisDir = path.dirname(fileURLToPath(import.meta.url));
-  const fromDist = path.join(thisDir, "agent-kit/aiditor/add-menu.template.yaml");
+  const fromDist = path.join(thisDir, relativePath);
   if (fs.existsSync(fromDist)) {
     return fromDist;
   }
-  return path.join(thisDir, "..", "agent-kit/aiditor/add-menu.template.yaml");
+  return path.join(thisDir, "..", relativePath);
+}
+function resolveAddMenuTemplatePath() {
+  return resolvePackageAgentKitPath("agent-kit/aiditor/add-menu.template.yaml");
 }
 function writeAddMenuCatalog(ctx) {
   const outputPath = path.join(ctx.projectRoot, ADD_MENU_OUTPUT_REL);
@@ -2022,6 +2060,9 @@ async function setupWixStores(ctx) {
   if (addMenuCreated) {
     configCreated.push(addMenuCreated);
   }
+  configCreated.push(
+    ...copyAiditorAddMenuThumbnails(ctx, resolvePackageAgentKitPath, "wix-stores")
+  );
   const message = `Wix Stores configured (product URL: ${service.urls.product})`;
   return {
     status: "configured",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-stores",
-  "version": "0.19.7",
+  "version": "0.20.0",
   "type": "module",
   "description": "Wix Stores API client for Jay Framework",
   "license": "Apache-2.0",
@@ -31,7 +31,7 @@
     "validate": "jay-stack-cli validate-plugin",
     "build:client": "vite build",
     "build:server": "vite build --ssr",
-    "build:copy-contract": "mkdir -p dist/contracts && cp lib/contracts/*.jay-contract* dist/contracts/ && mkdir -p dist/actions && cp lib/actions/*.jay-action dist/actions/ && mkdir -p dist/agent-kit/aiditor && cp agent-kit/aiditor/add-menu.template.yaml dist/agent-kit/aiditor/",
+    "build:copy-contract": "mkdir -p dist/contracts && cp lib/contracts/*.jay-contract* dist/contracts/ && mkdir -p dist/actions && cp lib/actions/*.jay-action dist/actions/ && mkdir -p dist/agent-kit/aiditor && cp agent-kit/aiditor/add-menu.template.yaml dist/agent-kit/aiditor/ && cp -R agent-kit/aiditor/thumbnails dist/agent-kit/aiditor/",
     "build:types": "tsup lib/index.ts --dts-only --format esm",
     "build:check-types": "tsc",
     "clean": "rimraf dist",
@@ -39,16 +39,16 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.19.7",
-    "@jay-framework/fullstack-component": "^0.19.7",
-    "@jay-framework/reactive": "^0.19.7",
-    "@jay-framework/runtime": "^0.19.7",
-    "@jay-framework/secure": "^0.19.7",
-    "@jay-framework/stack-client-runtime": "^0.19.7",
-    "@jay-framework/stack-server-runtime": "^0.19.7",
-    "@jay-framework/wix-cart": "^0.19.7",
-    "@jay-framework/wix-server-client": "^0.19.7",
-    "@jay-framework/wix-utils": "^0.19.7",
+    "@jay-framework/component": "^0.20.0",
+    "@jay-framework/fullstack-component": "^0.20.0",
+    "@jay-framework/reactive": "^0.20.0",
+    "@jay-framework/runtime": "^0.20.0",
+    "@jay-framework/secure": "^0.20.0",
+    "@jay-framework/stack-client-runtime": "^0.20.0",
+    "@jay-framework/stack-server-runtime": "^0.20.0",
+    "@jay-framework/wix-cart": "^0.20.0",
+    "@jay-framework/wix-server-client": "^0.20.0",
+    "@jay-framework/wix-utils": "^0.20.0",
     "@wix/categories": "^1.0.185",
     "@wix/data-extension-schema": "^1.0.221",
     "@wix/sdk": "^1.21.5",
@@ -60,10 +60,10 @@
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.19.7",
-    "@jay-framework/jay-cli": "^0.19.7",
-    "@jay-framework/jay-stack-cli": "^0.19.7",
-    "@jay-framework/vite-plugin": "^0.19.7",
+    "@jay-framework/compiler-jay-stack": "^0.20.0",
+    "@jay-framework/jay-cli": "^0.20.0",
+    "@jay-framework/jay-stack-cli": "^0.20.0",
+    "@jay-framework/vite-plugin": "^0.20.0",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",
     "tslib": "^2.6.2",