@aglyn/aglyn 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/plugin-manager/commerce-zone-props.d.ts

@@ -1,172 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * The props the commerce plugin's zones hand each widget (AGL-2916): the
- * product editor, the products hub and the CSV import dialog.
- *
- * Types only. `feature-plugins.ts` re-exports them with `export type`, which
- * TypeScript erases, so a published page that imports the zone catalog does
- * not carry them.
- */
-/** A product type, as the commerce catalog names it. */
-export type ConsoleProductType = 'physical' | 'digital' | 'service';
-/** A product option axis: its name and the values a shopper picks from. */
-export interface ConsoleProductOption {
-    name: string;
-    values: string[];
-}
-/** A product as the commerce editor holds it: saved, or staged and unsaved (AGL-2916). */
-export interface ConsoleProductDraft {
-    /** `null` for a product nobody has saved yet. */
-    id: string | null;
-    name: string;
-    type: ConsoleProductType;
-    description: string;
-    tags: string[];
-    categoryIds: string[];
-    options: ConsoleProductOption[];
-    /** The product's media, in order; the first is the photo the storefront leads with. */
-    mediaUrls: string[];
-    seoTitle: string;
-    seoDescription: string;
-}
-/**
- * Copy a widget proposes for one product (AGL-2916). A field left out is left
- * alone; `optionNames` renames the product's options in order, keeping every
- * variant, and is ignored unless it names each option once.
- */
-export interface ConsoleProductCopyValues {
-    description?: string;
-    tags?: string[];
-    categoryIds?: string[];
-    optionNames?: string[];
-    seoTitle?: string;
-    seoDescription?: string;
-}
-/**
- * What the `productEditor` zone hands each widget (AGL-2916): the product as
- * the editor holds it, and `proposeValues`, which stages copy in the editor as
- * unsaved edits. The zone sits under the product's description, tags and
- * categories, hosted by the commerce plugin through `useConsoleWidgetSlot` as
- * the editor's search listing hosts `seoFields`. A widget here proposes and
- * never writes: Save product is the write, with the guards it carries.
- */
-export interface ConsoleProductEditorZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    product: ConsoleProductDraft;
-    /** The site's categories, as the editor's picker lists them. */
-    categories: ReadonlyArray<{
-        id: string;
-        name: string;
-    }>;
-    /**
-     * Stages `values` in the editor as unsaved edits under `key`. Save product
-     * is what stores them; a widget never writes the product itself.
-     */
-    proposeValues: (values: ConsoleProductCopyValues, key: string) => void;
-}
-/** A catalog row as the products hub holds it (AGL-2916). */
-export interface ConsoleProductSummary {
-    id: string;
-    name: string;
-    status: 'draft' | 'active' | 'archived';
-    /** Whether a variant of the product has no price yet. */
-    priceMissing: boolean;
-    /** Whether the product has a photo. */
-    hasPhoto: boolean;
-}
-/** A new product a widget asks the hub to create, always as a draft with no price (AGL-2916). */
-export interface ConsoleProposedProduct {
-    name: string;
-    type: ConsoleProductType;
-    description: string;
-    tags: string[];
-    options: ConsoleProductOption[];
-    seoTitle: string;
-    seoDescription: string;
-}
-/** A discount a widget asks the hub to create, always switched off (AGL-2916). */
-export interface ConsoleProposedDiscount {
-    name: string;
-    /** The code a shopper types, or `null` for a discount that applies on its own. */
-    code: string | null;
-    kind: 'percent' | 'fixed' | 'free_shipping';
-    valuePct: number | null;
-    valueCents: number | null;
-    minSubtotalCents: number | null;
-}
-/**
- * What the `productsHub` zone hands each widget (AGL-2916): the catalog rows
- * the hub holds, the products its latest import created, and the hub's own
- * writes a widget may ask it to make — copy onto saved products, new draft
- * products, categories and switched-off discounts. The zone sits above the
- * catalog table. Each write is the hub's, with its seed, allowance and slug
- * checks; a widget writes nothing itself. Every write
- * resolves once it is stored and throws with a message a person can act on
- * when the hub refuses it: an allowance the plan has no room for, a product
- * that is gone.
- *
- * The creates are safe to ask twice: a product or a category named like one
- * the site has, and a discount with the code (or, with no code, the name) of
- * one the site has, are passed over, so a proposal applied again, by anyone,
- * creates nothing it already created.
- */
-export interface ConsoleProductsHubZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    /** The catalog rows the hub holds, in its order. */
-    products: readonly ConsoleProductSummary[];
-    /**
-     * The products the hub's latest CSV import created in this visit, and the
-     * options the `productImport` zone set for them; `null` before any import.
-     * `key` is new for each import.
-     */
-    lastImport: {
-        key: string;
-        productIds: readonly string[];
-        options: Readonly<Record<string, boolean>>;
-    } | null;
-    /** Writes copy onto a saved product, read fresh from the store. */
-    applyProductCopy: (productId: string, values: ConsoleProductCopyValues) => Promise<void>;
-    /** Creates each product as a draft with no price, and resolves with the ids it created. */
-    createProductDrafts: (products: readonly ConsoleProposedProduct[]) => Promise<string[]>;
-    /** Creates categories by name, and resolves with how many it created. */
-    createCategories: (names: readonly string[]) => Promise<number>;
-    /** Creates each discount switched off, and resolves with how many it created. */
-    createDiscountDrafts: (discounts: readonly ConsoleProposedDiscount[]) => Promise<number>;
-}
-/**
- * What the `productImport` zone hands each widget (AGL-2916), inside the
- * commerce CSV import dialog: how many products the import creates, and
- * options a widget sets for what happens to them once they land. The hub hands
- * the options, with the ids of the products the import created, to
- * `productsHub` as its `lastImport`.
- */
-export interface ConsoleProductImportZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    /** How many products the import creates. */
-    count: number;
-    /** The options set for this import, by key. */
-    options: Readonly<Record<string, boolean>>;
-    /** Sets one option; the hub carries it to `productsHub` with what the import created. */
-    setOption: (key: string, on: boolean) => void;
-}

package/src/lib/plugin-manager/commerce-zone-props.js

@@ -1,31 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * The props the commerce plugin's zones hand each widget (AGL-2916): the
- * product editor, the products hub and the CSV import dialog.
- *
- * Types only. `feature-plugins.ts` re-exports them with `export type`, which
- * TypeScript erases, so a published page that imports the zone catalog does
- * not carry them.
- */ /** A product type, as the commerce catalog names it. */ /**
- * What the `productImport` zone hands each widget (AGL-2916), inside the
- * commerce CSV import dialog: how many products the import creates, and
- * options a widget sets for what happens to them once they land. The hub hands
- * the options, with the ids of the products the import created, to
- * `productsHub` as its `lastImport`.
- */ export { };
-
-//# sourceMappingURL=commerce-zone-props.js.map

package/src/lib/plugin-manager/commerce-zone-props.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/commerce-zone-props.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\n/**\n * The props the commerce plugin's zones hand each widget (AGL-2916): the\n * product editor, the products hub and the CSV import dialog.\n *\n * Types only. `feature-plugins.ts` re-exports them with `export type`, which\n * TypeScript erases, so a published page that imports the zone catalog does\n * not carry them.\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 (AGL-2916). */\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 (AGL-2916). A field left out is left\n * alone; `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 (AGL-2916): the product as\n * the editor holds it, and `proposeValues`, which stages copy in the editor as\n * unsaved edits. The zone sits under the product's description, tags and\n * categories, hosted by the commerce plugin through `useConsoleWidgetSlot` as\n * the editor's search listing hosts `seoFields`. A widget here proposes and\n * never writes: Save product is the 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 (AGL-2916). */\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 (AGL-2916). */\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 (AGL-2916). */\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 (AGL-2916): the catalog rows\n * the hub holds, the products its latest import created, and the hub's own\n * writes a widget may ask it to make — copy onto saved products, new draft\n * products, categories and switched-off discounts. The zone sits above the\n * catalog table. Each write is the hub's, with its seed, allowance and slug\n * checks; a widget writes nothing itself. Every write\n * resolves once it is stored and throws with a message a person can act on\n * when the hub refuses it: an allowance the plan has no room for, a product\n * 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 CSV 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 (AGL-2916), inside the\n * commerce CSV import dialog: how many products the import creates, and\n * options a widget sets for what happens to them once they land. The hub hands\n * the options, with the ids of the products the import created, to\n * `productsHub` as its `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"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GAED,sDAAsD,GAwItD;;;;;;CAMC,GACD,WAUC"}