@aglyn/plugins-commerce 1.0.0-beta.228 → 1.0.0-beta.230

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-commerce",
-  "version": "1.0.0-beta.228",
+  "version": "1.0.0-beta.230",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,18 +25,18 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.228",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.228",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.228",
-    "@aglyn/shared-ui-next": "1.0.0-beta.228",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.228",
-    "@aglyn/shared-util-email": "1.0.0-beta.228",
-    "@aglyn/shared-util-http": "1.0.0-beta.228",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.228",
-    "@aglyn/shared-util-tools": "1.0.0-beta.228",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.228",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.228",
-    "@aglyn/tenant-runtime": "1.0.0-beta.228",
+    "@aglyn/aglyn": "1.0.0-beta.230",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.230",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.230",
+    "@aglyn/shared-ui-next": "1.0.0-beta.230",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.230",
+    "@aglyn/shared-util-email": "1.0.0-beta.230",
+    "@aglyn/shared-util-http": "1.0.0-beta.230",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.230",
+    "@aglyn/shared-util-tools": "1.0.0-beta.230",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.230",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.230",
+    "@aglyn/tenant-runtime": "1.0.0-beta.230",
     "@stripe/react-stripe-js": "^6.12.0",
     "@stripe/stripe-js": "^9.17.0",
     "@swc/helpers": "0.5.23",

package/src/lib/components/console/product-zones.d.ts

@@ -175,11 +175,23 @@ export declare const PRODUCT_EDITOR_ZONE: import("@aglyn/aglyn/plugin-manager/pl
 export declare const PRODUCTS_HUB_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductsHubZoneProps>;
 export declare const PRODUCT_IMPORT_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductImportZoneProps>;
 /**
- * Declares the three zones, from the console registrar. The ids are the ones
+ * What the `productsCreate` zone hands each widget (AGL-3596): the site and
+ * its org. The zone sits beside Add product on the Products page and in the
+ * empty catalog: another way to start a product. A widget here writes nothing
+ * through the page — anything it proposes is applied through `productsHub`.
+ */
+export interface ConsoleProductsCreateZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` where the host does not know it. */
+    orgId: string | undefined;
+}
+export declare const PRODUCTS_CREATE_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductsCreateZoneProps>;
+/**
+ * Declares the four zones, from the console registrar. The ids are the ones
  * widgets have always registered under, so a widget written for them keeps
  * working. Each is `bare`: the section is one item of a layout this plugin
  * draws — among the editor's fields, above the catalog table, in the import
- * wizard's After import step — and a wrapper would add a gap the page
+ * wizard's After import step, in the row beside Add product — and a wrapper would add a gap the page
  * already spaces.
  */
 export declare function registerCommerceZones(): void;

package/src/lib/components/console/product-zones.js

@@ -18,12 +18,13 @@ import { BUNDLE_ID } from "../../constants/bundle-common.js";
 export const PRODUCT_EDITOR_ZONE = definePluginZone('productEditor');
 export const PRODUCTS_HUB_ZONE = definePluginZone('productsHub');
 export const PRODUCT_IMPORT_ZONE = definePluginZone('productImport');
+export const PRODUCTS_CREATE_ZONE = definePluginZone('productsCreate');
 /**
- * Declares the three zones, from the console registrar. The ids are the ones
+ * Declares the four zones, from the console registrar. The ids are the ones
  * widgets have always registered under, so a widget written for them keeps
  * working. Each is `bare`: the section is one item of a layout this plugin
  * draws — among the editor's fields, above the catalog table, in the import
- * wizard's After import step — and a wrapper would add a gap the page
+ * wizard's After import step, in the row beside Add product — and a wrapper would add a gap the page
  * already spaces.
  */ export function registerCommerceZones() {
     const owner = {
@@ -43,6 +44,13 @@ export const PRODUCT_IMPORT_ZONE = definePluginZone('productImport');
         layout: 'bare',
         description: 'Above the catalog table on the Products page. A widget here proposes copy, draft products, categories and switched-off discounts, and asks the hub to write them; every write is the hub’s, with its allowance and slug checks.'
     }, owner);
+    registerPluginZone({
+        zone: PRODUCTS_CREATE_ZONE,
+        label: 'Start a product',
+        surface: 'console',
+        layout: 'bare',
+        description: 'Beside Add product on the Products page, and in the empty catalog: another way to start a product. A widget here is handed the site and its org and writes nothing through the page.'
+    }, owner);
     registerPluginZone({
         zone: PRODUCT_IMPORT_ZONE,
         label: 'Product import',

package/src/lib/components/console/product-zones.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/product-zones.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  definePluginZone,\n  registerPluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { BUNDLE_ID } from '../../constants/bundle-common'\n\n/**\n * The zones this plugin hosts on its product surfaces (AGL-2916): the product\n * editor, the products hub and the import wizard's After import step.\n *\n * Each is drawn through the shell's renderer (`useConsoleWidgetSlot`), so a\n * widget there passes the same enablement, entitlement and permission gates as\n * one on a console page. The props are this plugin's words for its catalog,\n * declared on the zone's token; a widget from another plugin restates the\n * shape it reads rather than importing this package. A widget proposes and\n * never writes: every write is this plugin's, with the guards it carries.\n */\n\n/** A product type, as the commerce catalog names it. */\nexport type ConsoleProductType = 'physical' | 'digital' | 'service'\n\n/** A product option axis: its name and the values a shopper picks from. */\nexport interface ConsoleProductOption {\n  name: string\n  values: string[]\n}\n\n/** A product as the commerce editor holds it: saved, or staged and unsaved. */\nexport interface ConsoleProductDraft {\n  /** `null` for a product nobody has saved yet. */\n  id: string | null\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  categoryIds: string[]\n  options: ConsoleProductOption[]\n  /** The product's media, in order; the first is the photo the storefront leads with. */\n  mediaUrls: string[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/**\n * Copy a widget proposes for one product. A field left out is left alone;\n * `optionNames` renames the product's options in order, keeping every\n * variant, and is ignored unless it names each option once.\n */\nexport interface ConsoleProductCopyValues {\n  description?: string\n  tags?: string[]\n  categoryIds?: string[]\n  optionNames?: string[]\n  seoTitle?: string\n  seoDescription?: string\n}\n\n/**\n * What the `productEditor` zone hands each widget: the product as the editor\n * holds it, and `proposeValues`, which stages copy in the editor as unsaved\n * edits. The zone sits under the product's description, tags and categories,\n * as the editor's search listing hosts `seoFields`. Save product is the\n * write, with the guards it carries.\n */\nexport interface ConsoleProductEditorZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  product: ConsoleProductDraft\n  /** The site's categories, as the editor's picker lists them. */\n  categories: ReadonlyArray<{ id: string; name: string }>\n  /**\n   * Stages `values` in the editor as unsaved edits under `key`. Save product\n   * is what stores them; a widget never writes the product itself.\n   */\n  proposeValues: (values: ConsoleProductCopyValues, key: string) => void\n}\n\n/** A catalog row as the products hub holds it. */\nexport interface ConsoleProductSummary {\n  id: string\n  name: string\n  status: 'draft' | 'active' | 'archived'\n  /** Whether a variant of the product has no price yet. */\n  priceMissing: boolean\n  /** Whether the product has a photo. */\n  hasPhoto: boolean\n}\n\n/** A new product a widget asks the hub to create, always as a draft with no price. */\nexport interface ConsoleProposedProduct {\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  options: ConsoleProductOption[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/** A discount a widget asks the hub to create, always switched off. */\nexport interface ConsoleProposedDiscount {\n  name: string\n  /** The code a shopper types, or `null` for a discount that applies on its own. */\n  code: string | null\n  kind: 'percent' | 'fixed' | 'free_shipping'\n  valuePct: number | null\n  valueCents: number | null\n  minSubtotalCents: number | null\n}\n\n/**\n * What the `productsHub` zone hands each widget: the catalog rows the hub\n * holds, the products its latest import created, and the hub's own writes a\n * widget may ask it to make — copy onto saved products, new draft products,\n * categories and switched-off discounts. The zone sits above the catalog\n * table. Each write is the hub's, with its seed, allowance and slug checks; a\n * widget writes nothing itself. Every write resolves once it is stored and\n * throws with a message a person can act on when the hub refuses it: an\n * allowance the plan has no room for, a product that is gone.\n *\n * The creates are safe to ask twice: a product or a category named like one\n * the site has, and a discount with the code (or, with no code, the name) of\n * one the site has, are passed over, so a proposal applied again, by anyone,\n * creates nothing it already created.\n */\nexport interface ConsoleProductsHubZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** The catalog rows the hub holds, in its order. */\n  products: readonly ConsoleProductSummary[]\n  /**\n   * The products the hub's latest import created in this visit, and the\n   * options the `productImport` zone set for them; `null` before any import.\n   * `key` is new for each import.\n   */\n  lastImport: {\n    key: string\n    productIds: readonly string[]\n    options: Readonly<Record<string, boolean>>\n  } | null\n  /** Writes copy onto a saved product, read fresh from the store. */\n  applyProductCopy: (productId: string, values: ConsoleProductCopyValues) => Promise<void>\n  /** Creates each product as a draft with no price, and resolves with the ids it created. */\n  createProductDrafts: (products: readonly ConsoleProposedProduct[]) => Promise<string[]>\n  /** Creates categories by name, and resolves with how many it created. */\n  createCategories: (names: readonly string[]) => Promise<number>\n  /** Creates each discount switched off, and resolves with how many it created. */\n  createDiscountDrafts: (discounts: readonly ConsoleProposedDiscount[]) => Promise<number>\n}\n\n/**\n * What the `productImport` zone hands each widget, in the import wizard's\n * After import step: how many products the import creates, and options a widget sets\n * for what happens to them once they land. The hub hands the options, with\n * the ids of the products the import created, to `productsHub` as its\n * `lastImport`.\n */\nexport interface ConsoleProductImportZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** How many products the import creates. */\n  count: number\n  /** The options set for this import, by key. */\n  options: Readonly<Record<string, boolean>>\n  /** Sets one option; the hub carries it to `productsHub` with what the import created. */\n  setOption: (key: string, on: boolean) => void\n}\n\nexport const PRODUCT_EDITOR_ZONE =\n  definePluginZone<ConsoleProductEditorZoneProps>('productEditor')\n\nexport const PRODUCTS_HUB_ZONE =\n  definePluginZone<ConsoleProductsHubZoneProps>('productsHub')\n\nexport const PRODUCT_IMPORT_ZONE =\n  definePluginZone<ConsoleProductImportZoneProps>('productImport')\n\n/**\n * Declares the three zones, from the console registrar. The ids are the ones\n * widgets have always registered under, so a widget written for them keeps\n * working. Each is `bare`: the section is one item of a layout this plugin\n * draws — among the editor's fields, above the catalog table, in the import\n * wizard's After import step — and a wrapper would add a gap the page\n * already spaces.\n */\nexport function registerCommerceZones(): void {\n  const owner = { pluginId: BUNDLE_ID }\n  registerPluginZone(\n    {\n      zone: PRODUCT_EDITOR_ZONE,\n      label: 'Product editor',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Under a product’s description, tags and categories in the product editor. A widget here proposes copy for the fields through `proposeValues`, staged as unsaved edits; Save product is the write.',\n    },\n    owner,\n  )\n  registerPluginZone(\n    {\n      zone: PRODUCTS_HUB_ZONE,\n      label: 'Products hub',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Above the catalog table on the Products page. A widget here proposes copy, draft products, categories and switched-off discounts, and asks the hub to write them; every write is the hub’s, with its allowance and slug checks.',\n    },\n    owner,\n  )\n  registerPluginZone(\n    {\n      zone: PRODUCT_IMPORT_ZONE,\n      label: 'Product import',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'In the product import wizard’s After import step. A widget here sets options for what happens to the imported products once they land; the hub hands them to `productsHub` with the ids the import created.',\n    },\n    owner,\n  )\n}\n"],"names":["definePluginZone","registerPluginZone","BUNDLE_ID","PRODUCT_EDITOR_ZONE","PRODUCTS_HUB_ZONE","PRODUCT_IMPORT_ZONE","registerCommerceZones","owner","pluginId","zone","label","surface","layout","description"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,gBAAgB,EAChBC,kBAAkB,QACb,2CAA0C;AACjD,SAASC,SAAS,QAAQ,mCAA+B;AAuKzD,OAAO,MAAMC,sBACXH,iBAAgD,iBAAgB;AAElE,OAAO,MAAMI,oBACXJ,iBAA8C,eAAc;AAE9D,OAAO,MAAMK,sBACXL,iBAAgD,iBAAgB;AAElE;;;;;;;CAOC,GACD,OAAO,SAASM;IACd,MAAMC,QAAQ;QAAEC,UAAUN;IAAU;IACpCD,mBACE;QACEQ,MAAMN;QACNO,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;IAEFN,mBACE;QACEQ,MAAML;QACNM,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;IAEFN,mBACE;QACEQ,MAAMJ;QACNK,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;AAEJ"}
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/product-zones.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  definePluginZone,\n  registerPluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { BUNDLE_ID } from '../../constants/bundle-common'\n\n/**\n * The zones this plugin hosts on its product surfaces (AGL-2916): the product\n * editor, the products hub and the import wizard's After import step.\n *\n * Each is drawn through the shell's renderer (`useConsoleWidgetSlot`), so a\n * widget there passes the same enablement, entitlement and permission gates as\n * one on a console page. The props are this plugin's words for its catalog,\n * declared on the zone's token; a widget from another plugin restates the\n * shape it reads rather than importing this package. A widget proposes and\n * never writes: every write is this plugin's, with the guards it carries.\n */\n\n/** A product type, as the commerce catalog names it. */\nexport type ConsoleProductType = 'physical' | 'digital' | 'service'\n\n/** A product option axis: its name and the values a shopper picks from. */\nexport interface ConsoleProductOption {\n  name: string\n  values: string[]\n}\n\n/** A product as the commerce editor holds it: saved, or staged and unsaved. */\nexport interface ConsoleProductDraft {\n  /** `null` for a product nobody has saved yet. */\n  id: string | null\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  categoryIds: string[]\n  options: ConsoleProductOption[]\n  /** The product's media, in order; the first is the photo the storefront leads with. */\n  mediaUrls: string[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/**\n * Copy a widget proposes for one product. A field left out is left alone;\n * `optionNames` renames the product's options in order, keeping every\n * variant, and is ignored unless it names each option once.\n */\nexport interface ConsoleProductCopyValues {\n  description?: string\n  tags?: string[]\n  categoryIds?: string[]\n  optionNames?: string[]\n  seoTitle?: string\n  seoDescription?: string\n}\n\n/**\n * What the `productEditor` zone hands each widget: the product as the editor\n * holds it, and `proposeValues`, which stages copy in the editor as unsaved\n * edits. The zone sits under the product's description, tags and categories,\n * as the editor's search listing hosts `seoFields`. Save product is the\n * write, with the guards it carries.\n */\nexport interface ConsoleProductEditorZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  product: ConsoleProductDraft\n  /** The site's categories, as the editor's picker lists them. */\n  categories: ReadonlyArray<{ id: string; name: string }>\n  /**\n   * Stages `values` in the editor as unsaved edits under `key`. Save product\n   * is what stores them; a widget never writes the product itself.\n   */\n  proposeValues: (values: ConsoleProductCopyValues, key: string) => void\n}\n\n/** A catalog row as the products hub holds it. */\nexport interface ConsoleProductSummary {\n  id: string\n  name: string\n  status: 'draft' | 'active' | 'archived'\n  /** Whether a variant of the product has no price yet. */\n  priceMissing: boolean\n  /** Whether the product has a photo. */\n  hasPhoto: boolean\n}\n\n/** A new product a widget asks the hub to create, always as a draft with no price. */\nexport interface ConsoleProposedProduct {\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  options: ConsoleProductOption[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/** A discount a widget asks the hub to create, always switched off. */\nexport interface ConsoleProposedDiscount {\n  name: string\n  /** The code a shopper types, or `null` for a discount that applies on its own. */\n  code: string | null\n  kind: 'percent' | 'fixed' | 'free_shipping'\n  valuePct: number | null\n  valueCents: number | null\n  minSubtotalCents: number | null\n}\n\n/**\n * What the `productsHub` zone hands each widget: the catalog rows the hub\n * holds, the products its latest import created, and the hub's own writes a\n * widget may ask it to make — copy onto saved products, new draft products,\n * categories and switched-off discounts. The zone sits above the catalog\n * table. Each write is the hub's, with its seed, allowance and slug checks; a\n * widget writes nothing itself. Every write resolves once it is stored and\n * throws with a message a person can act on when the hub refuses it: an\n * allowance the plan has no room for, a product that is gone.\n *\n * The creates are safe to ask twice: a product or a category named like one\n * the site has, and a discount with the code (or, with no code, the name) of\n * one the site has, are passed over, so a proposal applied again, by anyone,\n * creates nothing it already created.\n */\nexport interface ConsoleProductsHubZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** The catalog rows the hub holds, in its order. */\n  products: readonly ConsoleProductSummary[]\n  /**\n   * The products the hub's latest import created in this visit, and the\n   * options the `productImport` zone set for them; `null` before any import.\n   * `key` is new for each import.\n   */\n  lastImport: {\n    key: string\n    productIds: readonly string[]\n    options: Readonly<Record<string, boolean>>\n  } | null\n  /** Writes copy onto a saved product, read fresh from the store. */\n  applyProductCopy: (productId: string, values: ConsoleProductCopyValues) => Promise<void>\n  /** Creates each product as a draft with no price, and resolves with the ids it created. */\n  createProductDrafts: (products: readonly ConsoleProposedProduct[]) => Promise<string[]>\n  /** Creates categories by name, and resolves with how many it created. */\n  createCategories: (names: readonly string[]) => Promise<number>\n  /** Creates each discount switched off, and resolves with how many it created. */\n  createDiscountDrafts: (discounts: readonly ConsoleProposedDiscount[]) => Promise<number>\n}\n\n/**\n * What the `productImport` zone hands each widget, in the import wizard's\n * After import step: how many products the import creates, and options a widget sets\n * for what happens to them once they land. The hub hands the options, with\n * the ids of the products the import created, to `productsHub` as its\n * `lastImport`.\n */\nexport interface ConsoleProductImportZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** How many products the import creates. */\n  count: number\n  /** The options set for this import, by key. */\n  options: Readonly<Record<string, boolean>>\n  /** Sets one option; the hub carries it to `productsHub` with what the import created. */\n  setOption: (key: string, on: boolean) => void\n}\n\nexport const PRODUCT_EDITOR_ZONE =\n  definePluginZone<ConsoleProductEditorZoneProps>('productEditor')\n\nexport const PRODUCTS_HUB_ZONE =\n  definePluginZone<ConsoleProductsHubZoneProps>('productsHub')\n\nexport const PRODUCT_IMPORT_ZONE =\n  definePluginZone<ConsoleProductImportZoneProps>('productImport')\n\n/**\n * What the `productsCreate` zone hands each widget (AGL-3596): the site and\n * its org. The zone sits beside Add product on the Products page and in the\n * empty catalog: another way to start a product. A widget here writes nothing\n * through the page — anything it proposes is applied through `productsHub`.\n */\nexport interface ConsoleProductsCreateZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n}\n\nexport const PRODUCTS_CREATE_ZONE =\n  definePluginZone<ConsoleProductsCreateZoneProps>('productsCreate')\n\n/**\n * Declares the four zones, from the console registrar. The ids are the ones\n * widgets have always registered under, so a widget written for them keeps\n * working. Each is `bare`: the section is one item of a layout this plugin\n * draws — among the editor's fields, above the catalog table, in the import\n * wizard's After import step, in the row beside Add product — and a wrapper would add a gap the page\n * already spaces.\n */\nexport function registerCommerceZones(): void {\n  const owner = { pluginId: BUNDLE_ID }\n  registerPluginZone(\n    {\n      zone: PRODUCT_EDITOR_ZONE,\n      label: 'Product editor',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Under a product’s description, tags and categories in the product editor. A widget here proposes copy for the fields through `proposeValues`, staged as unsaved edits; Save product is the write.',\n    },\n    owner,\n  )\n  registerPluginZone(\n    {\n      zone: PRODUCTS_HUB_ZONE,\n      label: 'Products hub',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Above the catalog table on the Products page. A widget here proposes copy, draft products, categories and switched-off discounts, and asks the hub to write them; every write is the hub’s, with its allowance and slug checks.',\n    },\n    owner,\n  )\n  registerPluginZone(\n    {\n      zone: PRODUCTS_CREATE_ZONE,\n      label: 'Start a product',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Beside Add product on the Products page, and in the empty catalog: another way to start a product. A widget here is handed the site and its org and writes nothing through the page.',\n    },\n    owner,\n  )\n  registerPluginZone(\n    {\n      zone: PRODUCT_IMPORT_ZONE,\n      label: 'Product import',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'In the product import wizard’s After import step. A widget here sets options for what happens to the imported products once they land; the hub hands them to `productsHub` with the ids the import created.',\n    },\n    owner,\n  )\n}\n"],"names":["definePluginZone","registerPluginZone","BUNDLE_ID","PRODUCT_EDITOR_ZONE","PRODUCTS_HUB_ZONE","PRODUCT_IMPORT_ZONE","PRODUCTS_CREATE_ZONE","registerCommerceZones","owner","pluginId","zone","label","surface","layout","description"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,gBAAgB,EAChBC,kBAAkB,QACb,2CAA0C;AACjD,SAASC,SAAS,QAAQ,mCAA+B;AAuKzD,OAAO,MAAMC,sBACXH,iBAAgD,iBAAgB;AAElE,OAAO,MAAMI,oBACXJ,iBAA8C,eAAc;AAE9D,OAAO,MAAMK,sBACXL,iBAAgD,iBAAgB;AAclE,OAAO,MAAMM,uBACXN,iBAAiD,kBAAiB;AAEpE;;;;;;;CAOC,GACD,OAAO,SAASO;IACd,MAAMC,QAAQ;QAAEC,UAAUP;IAAU;IACpCD,mBACE;QACES,MAAMP;QACNQ,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;IAEFP,mBACE;QACES,MAAMN;QACNO,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;IAEFP,mBACE;QACES,MAAMJ;QACNK,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;IAEFP,mBACE;QACES,MAAML;QACNM,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACAN;AAEJ"}

package/src/lib/components/console/products-hub-card.component.js

@@ -18,6 +18,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { TransferResumeImport } from "@aglyn/aglyn/app-utils/transfer-resume-import";
+import { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
 import * as Aglyn from "@aglyn/aglyn";
 import * as CommerceModel from "../../model/index.js";
 import { PRODUCT_LIST_BASE, PRODUCT_LIST_FIELDS, PRODUCT_LIST_HEADERS, PRODUCT_LIST_OPTIONS, PRODUCT_LIST_QUERY, PRODUCT_LIST_SELECT_FIELDS, productListRequestClauses } from "../../constants/product-list-query.js";
@@ -46,6 +47,7 @@ import { productSlugLedger } from "./product-slugs.js";
 import { productCollectionFields } from "./smart-collections.js";
 import ProductsHubZone from "./products-hub-zone.component.js";
 import { pluginDocsHelp } from "@aglyn/aglyn";
+import { PRODUCTS_CREATE_ZONE } from "./product-zones.js";
 import { commerceListFilter } from "../../transfer/list-filter.js";
 import { COMMERCE_PRODUCTS_TRANSFER } from "../../transfer/transfer-keys.js";
 /**
@@ -77,6 +79,7 @@ const STATUS_COLOR = {
  */ export function ProductsHubCard(props) {
     var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6, _ref7, _ref8, _ref9, _ref10, _ref11;
     const { hostId } = props;
+    /** The shell's zone renderer, for the `productsCreate` zone (AGL-3596). */ const CreateZone = useConsoleWidgetSlot();
     const firestore = useFirestore();
     const { data: user } = useUser();
     const { enqueueSnackbar } = useSnackbar();
@@ -687,6 +690,26 @@ const STATUS_COLOR = {
             width: 470
         })
     ], PRODUCT_LIST_FIELDS, PRODUCT_LIST_OPTIONS, PRODUCT_LIST_HEADERS);
+    /** Add product: the quota first, then the create drawer. */ const startAddProduct = ()=>{
+        if (!productQuota) return;
+        if (!productQuota.allowed) {
+            return void enqueueSnackbar(`Your plan includes ${productQuota.limit} products — ` + 'upgrade for more', {
+                variant: 'info',
+                persist: false
+            });
+        }
+        setCreating(true);
+    };
+    /*
+   * Other ways to start a product (AGL-3596): the `productsCreate` zone this
+   * plugin declares, drawn through the shell's gated slot beside Add product
+   * and again in the empty catalog. `null` outside the console shell. The
+   * org is not this page's to know, so a widget reads it from the site.
+   */ const createZone = CreateZone ? /*#__PURE__*/ _jsx(CreateZone, {
+        slot: PRODUCTS_CREATE_ZONE.id,
+        hostId: hostId,
+        orgId: undefined
+    }) : null;
     return /*#__PURE__*/ _jsxs(CardDisplay, {
         /*
        * The header count is the SITE'S catalog, not the rows in hand.
@@ -720,21 +743,13 @@ const STATUS_COLOR = {
                                     flex: 1
                                 }
                             }),
+                            createZone,
                             /*#__PURE__*/ _jsx(Button, {
                                 variant: "contained",
                                 color: "primary",
                                 size: "small",
                                 disabled: !productQuota,
-                                onClick: ()=>{
-                                    if (!productQuota) return;
-                                    if (!productQuota.allowed) {
-                                        return void enqueueSnackbar(`Your plan includes ${productQuota.limit} products — ` + 'upgrade for more', {
-                                            variant: 'info',
-                                            persist: false
-                                        });
-                                    }
-                                    setCreating(true);
-                                },
+                                onClick: startAddProduct,
                                 children: 'Add product'
                             }),
                             /*#__PURE__*/ _jsx(TransferResumeImport, {
@@ -817,7 +832,20 @@ const STATUS_COLOR = {
                             }
                         },
                         noRowsLabel: filtering ? 'No products match these filters' : 'No products yet',
-                        noRowsDescription: filtering ? undefined : 'Build your catalog: add a product, then drop commerce ' + 'blocks on any page in Besigner.'
+                        noRowsDescription: filtering ? undefined : 'Build your catalog: add a product, then drop commerce ' + 'blocks on any page in Besigner.',
+                        noRowsAction: filtering ? undefined : /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                createZone,
+                                /*#__PURE__*/ _jsx(Button, {
+                                    variant: "contained",
+                                    disabled: !productQuota,
+                                    onClick: startAddProduct,
+                                    children: 'Add your first product'
+                                })
+                            ]
+                        })
                     }),
                     products.length === 0 && page === 0 && productsStatus !== 'loading' ? null : /* The count line is the PAGE's. `hasMore` is a fact from the probe
              row; the site's total is `productCount` above, which counts the