@aglyn/aglyn 1.0.0-beta.143

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

@@ -0,0 +1,172 @@
+/**
+ * @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

@@ -0,0 +1,31 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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"}

package/src/lib/plugin-manager/custom-fields.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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.
+ */
+import type { ComponentType } from 'react';
+/**
+ * Custom field types (AGL-434, Strapi custom-fields parity): a plugin
+ * declares a NAMED field type that rides an EXISTING dataset storage type
+ * — no new storage primitives, so records stay portable and every query/
+ * binding path keeps working. The dataset schema editor offers registered
+ * types; a field using one stores `customType` next to its base `type`,
+ * the record editor mounts the plugin's Input, and the custom `validate`
+ * runs on BOTH sides (editor pre-save and the server import/write paths)
+ * after the base-type validation.
+ *
+ * Register at module scope in a file imported by the plugin's client
+ * barrel and /server entry (the AGL-428 config-schema pattern).
+ */
+/** Storage subset custom types may ride (mirrors Strapi's limitation). */
+export type CustomFieldBaseType = 'text' | 'bool' | 'int32' | 'float' | 'map';
+export interface CustomFieldInputProps {
+    value: unknown;
+    onChange: (value: unknown) => void;
+    disabled?: boolean;
+    label?: string;
+}
+export interface CustomFieldType {
+    /** Stable name persisted on field definitions ('rating'); never rename. */
+    name: string;
+    pluginId: string;
+    label: string;
+    baseType: CustomFieldBaseType;
+    description?: string;
+    /** Record-editor input; base-type input is the fallback when absent. */
+    Input?: ComponentType<CustomFieldInputProps>;
+    /** Runs after base-type validation; returns an error message or null. */
+    validate?: (value: unknown) => string | null;
+}
+/** Idempotent by name — re-registration replaces the type. */
+export declare function registerCustomFieldType(fieldType: CustomFieldType): void;
+export declare function getCustomFieldType(name: string | undefined): CustomFieldType | undefined;
+export declare function listCustomFieldTypes(): CustomFieldType[];
+/**
+ * The custom-type validation hook (both sides): no-op for plain fields,
+ * unknown custom types (plugin disabled/uninstalled — the base type still
+ * guards storage), or empty optional values.
+ */
+export declare function validateCustomFieldValue(customType: string | undefined, value: unknown): string | null;

package/src/lib/plugin-manager/custom-fields.js

@@ -0,0 +1,39 @@
+/**
+ * @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.
+ */ const customFieldTypes = new Map();
+/** Idempotent by name — re-registration replaces the type. */ export function registerCustomFieldType(fieldType) {
+    customFieldTypes.set(fieldType.name, fieldType);
+}
+export function getCustomFieldType(name) {
+    return name ? customFieldTypes.get(name) : undefined;
+}
+export function listCustomFieldTypes() {
+    return [
+        ...customFieldTypes.values()
+    ];
+}
+/**
+ * The custom-type validation hook (both sides): no-op for plain fields,
+ * unknown custom types (plugin disabled/uninstalled — the base type still
+ * guards storage), or empty optional values.
+ */ export function validateCustomFieldValue(customType, value) {
+    const fieldType = getCustomFieldType(customType);
+    if (!(fieldType == null ? void 0 : fieldType.validate)) return null;
+    if (value === undefined || value === null || value === '') return null;
+    return fieldType.validate(value);
+}
+
+//# sourceMappingURL=custom-fields.js.map

package/src/lib/plugin-manager/custom-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/custom-fields.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 type { ComponentType } from 'react'\n\n/**\n * Custom field types (AGL-434, Strapi custom-fields parity): a plugin\n * declares a NAMED field type that rides an EXISTING dataset storage type\n * — no new storage primitives, so records stay portable and every query/\n * binding path keeps working. The dataset schema editor offers registered\n * types; a field using one stores `customType` next to its base `type`,\n * the record editor mounts the plugin's Input, and the custom `validate`\n * runs on BOTH sides (editor pre-save and the server import/write paths)\n * after the base-type validation.\n *\n * Register at module scope in a file imported by the plugin's client\n * barrel and /server entry (the AGL-428 config-schema pattern).\n */\n\n/** Storage subset custom types may ride (mirrors Strapi's limitation). */\nexport type CustomFieldBaseType = 'text' | 'bool' | 'int32' | 'float' | 'map'\n\nexport interface CustomFieldInputProps {\n  value: unknown\n  onChange: (value: unknown) => void\n  disabled?: boolean\n  label?: string\n}\n\nexport interface CustomFieldType {\n  /** Stable name persisted on field definitions ('rating'); never rename. */\n  name: string\n  pluginId: string\n  label: string\n  baseType: CustomFieldBaseType\n  description?: string\n  /** Record-editor input; base-type input is the fallback when absent. */\n  Input?: ComponentType<CustomFieldInputProps>\n  /** Runs after base-type validation; returns an error message or null. */\n  validate?: (value: unknown) => string | null\n}\n\nconst customFieldTypes = new Map<string, CustomFieldType>()\n\n/** Idempotent by name — re-registration replaces the type. */\nexport function registerCustomFieldType(fieldType: CustomFieldType): void {\n  customFieldTypes.set(fieldType.name, fieldType)\n}\n\nexport function getCustomFieldType(\n  name: string | undefined,\n): CustomFieldType | undefined {\n  return name ? customFieldTypes.get(name) : undefined\n}\n\nexport function listCustomFieldTypes(): CustomFieldType[] {\n  return [...customFieldTypes.values()]\n}\n\n/**\n * The custom-type validation hook (both sides): no-op for plain fields,\n * unknown custom types (plugin disabled/uninstalled — the base type still\n * guards storage), or empty optional values.\n */\nexport function validateCustomFieldValue(\n  customType: string | undefined,\n  value: unknown,\n): string | null {\n  const fieldType = getCustomFieldType(customType)\n  if (!fieldType?.validate) return null\n  if (value === undefined || value === null || value === '') return null\n  return fieldType.validate(value)\n}\n"],"names":["customFieldTypes","Map","registerCustomFieldType","fieldType","set","name","getCustomFieldType","get","undefined","listCustomFieldTypes","values","validateCustomFieldValue","customType","value","validate"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAyCD,MAAMA,mBAAmB,IAAIC;AAE7B,4DAA4D,GAC5D,OAAO,SAASC,wBAAwBC,SAA0B;IAChEH,iBAAiBI,GAAG,CAACD,UAAUE,IAAI,EAAEF;AACvC;AAEA,OAAO,SAASG,mBACdD,IAAwB;IAExB,OAAOA,OAAOL,iBAAiBO,GAAG,CAACF,QAAQG;AAC7C;AAEA,OAAO,SAASC;IACd,OAAO;WAAIT,iBAAiBU,MAAM;KAAG;AACvC;AAEA;;;;CAIC,GACD,OAAO,SAASC,yBACdC,UAA8B,EAC9BC,KAAc;IAEd,MAAMV,YAAYG,mBAAmBM;IACrC,IAAI,EAACT,6BAAAA,UAAWW,QAAQ,GAAE,OAAO;IACjC,IAAID,UAAUL,aAAaK,UAAU,QAAQA,UAAU,IAAI,OAAO;IAClE,OAAOV,UAAUW,QAAQ,CAACD;AAC5B"}

package/src/lib/plugin-manager/editor-sessions.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @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 editor a person has open, as another surface may act on it.
+ *
+ * A console editor — the besigner on a screen, a component or a layout —
+ * holds state no plugin can reach: which element is selected, whether the
+ * version it has open is the one the live site serves, the dialog that makes
+ * a new version, and form fields that sit beside the canvas rather than on
+ * it (a screen's search title). A plugin mounted in a shell zone that wants
+ * to help with that document — a translation, a review comment, a proposed
+ * edit — would otherwise have to import the console page, which the package
+ * map forbids, or write the stored document itself, which skips the editor's
+ * guards and the author's review.
+ *
+ * So the editor registers a SESSION while it is open, and a plugin reads it.
+ * Every capability is the editor's own:
+ *
+ *  - `selectedNodeId` and `isLiveVersion` are answered when asked, so a
+ *    caller never holds an answer from registration time;
+ *  - `createVersion` starts the editor's own new-version flow, with its
+ *    entitlement check, its refusal to copy an unsaved canvas and its name
+ *    dialog — nothing here creates a version;
+ *  - `fields` are the setters the editor's own form reads, so a staged value
+ *    is exactly what typing it would have been: an unsaved edit, stored only
+ *    when the author saves with the editor's own control. There is no save
+ *    here, by construction.
+ *
+ * One editor is open at a time in a console tab, but a remount registers
+ * before the previous mount's cleanup runs, so registrations stack: the
+ * newest session answers, and an unregister removes only the registration
+ * it was returned for.
+ */
+export interface EditorSession {
+    /** The kind of document open, as the editor's route names it: `screen`, `component`, `layout`. */
+    documentKind: string;
+    /** The id of the document open. */
+    documentId: string;
+    /** The id of the version open. */
+    versionId: string;
+    /** Whether the open version is the one the live site serves. */
+    isLiveVersion: () => boolean;
+    /** The element the author has selected, or null. */
+    selectedNodeId?: () => string | null;
+    /**
+     * Starts the editor's own new-version flow. Whether a version results is
+     * the flow's decision — the plan, an unsaved canvas and the author's own
+     * dialog can each stop it — and a created version opens in the editor the
+     * way the editor's own button opens it.
+     */
+    createVersion?: () => void;
+    /**
+     * Fields beside the canvas another surface may stage, keyed as the editor
+     * names them (`seo.title`), each with the setter the editor's own form
+     * reads.
+     */
+    fields?: Readonly<Record<string, (value: string) => void>>;
+    /** Brings the staged fields into view, so the author sees them before saving. */
+    revealFields?: () => void;
+}
+/** What a staging call did: the keys it staged, and the keys the editor lacks. */
+export interface EditorFieldStageResult {
+    staged: string[];
+    unknown: string[];
+}
+/**
+ * Registers the open editor. Returns the unregister function, which removes
+ * only this registration.
+ */
+export declare function registerEditorSession(session: EditorSession): () => void;
+/** The newest open editor session, or `undefined` when no editor is open. */
+export declare function openEditorSession(): EditorSession | undefined;
+/**
+ * Calls `listener` whenever a session opens or closes, or its editor reports
+ * that an answer changed. Returns the unsubscribe function.
+ */
+export declare function subscribeEditorSessions(listener: () => void): () => void;
+/**
+ * A number that moves on every notification — the snapshot a React
+ * subscriber compares, since the open session itself stays the same object
+ * when only one of its answers changes.
+ */
+export declare function editorSessionsRevision(): number;
+/**
+ * Tells subscribers that an open session's answers changed — the version it
+ * holds went live, or stopped being live — without registering it again.
+ */
+export declare function notifyEditorSessionChanged(): void;
+/**
+ * Stages `values` into the session's own fields, and reveals them when any
+ * was staged. Nothing is saved.
+ */
+export declare function stageEditorSessionFields(session: EditorSession, values: Readonly<Record<string, string>>): EditorFieldStageResult;
+/** Closes every session and drops every subscriber. Specs only. */
+export declare function resetEditorSessionsForTests(): void;

package/src/lib/plugin-manager/editor-sessions.js

@@ -0,0 +1,137 @@
+/**
+ * @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 editor a person has open, as another surface may act on it.
+ *
+ * A console editor — the besigner on a screen, a component or a layout —
+ * holds state no plugin can reach: which element is selected, whether the
+ * version it has open is the one the live site serves, the dialog that makes
+ * a new version, and form fields that sit beside the canvas rather than on
+ * it (a screen's search title). A plugin mounted in a shell zone that wants
+ * to help with that document — a translation, a review comment, a proposed
+ * edit — would otherwise have to import the console page, which the package
+ * map forbids, or write the stored document itself, which skips the editor's
+ * guards and the author's review.
+ *
+ * So the editor registers a SESSION while it is open, and a plugin reads it.
+ * Every capability is the editor's own:
+ *
+ *  - `selectedNodeId` and `isLiveVersion` are answered when asked, so a
+ *    caller never holds an answer from registration time;
+ *  - `createVersion` starts the editor's own new-version flow, with its
+ *    entitlement check, its refusal to copy an unsaved canvas and its name
+ *    dialog — nothing here creates a version;
+ *  - `fields` are the setters the editor's own form reads, so a staged value
+ *    is exactly what typing it would have been: an unsaved edit, stored only
+ *    when the author saves with the editor's own control. There is no save
+ *    here, by construction.
+ *
+ * One editor is open at a time in a console tab, but a remount registers
+ * before the previous mount's cleanup runs, so registrations stack: the
+ * newest session answers, and an unregister removes only the registration
+ * it was returned for.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+const sessions = [];
+const listeners = new Set();
+let revision = 0;
+function notify() {
+    revision += 1;
+    for (const listener of [
+        ...listeners
+    ])listener();
+}
+/**
+ * Registers the open editor. Returns the unregister function, which removes
+ * only this registration.
+ */ export function registerEditorSession(session) {
+    var _ref, _ref1, _ref2;
+    const documentKind = String((_ref = session == null ? void 0 : session.documentKind) != null ? _ref : '').trim();
+    const documentId = String((_ref1 = session == null ? void 0 : session.documentId) != null ? _ref1 : '').trim();
+    const versionId = String((_ref2 = session == null ? void 0 : session.versionId) != null ? _ref2 : '').trim();
+    if (!documentKind || !documentId || !versionId) {
+        throw new Error('an editor session needs a document kind, a document id and a version id');
+    }
+    if (typeof session.isLiveVersion !== 'function') {
+        throw new Error('an editor session needs isLiveVersion');
+    }
+    const entry = _extends({}, session, {
+        documentKind,
+        documentId,
+        versionId
+    });
+    sessions.push(entry);
+    notify();
+    return ()=>{
+        const index = sessions.indexOf(entry);
+        if (index < 0) return;
+        sessions.splice(index, 1);
+        notify();
+    };
+}
+/** The newest open editor session, or `undefined` when no editor is open. */ export function openEditorSession() {
+    return sessions[sessions.length - 1];
+}
+/**
+ * Calls `listener` whenever a session opens or closes, or its editor reports
+ * that an answer changed. Returns the unsubscribe function.
+ */ export function subscribeEditorSessions(listener) {
+    listeners.add(listener);
+    return ()=>{
+        listeners.delete(listener);
+    };
+}
+/**
+ * A number that moves on every notification — the snapshot a React
+ * subscriber compares, since the open session itself stays the same object
+ * when only one of its answers changes.
+ */ export function editorSessionsRevision() {
+    return revision;
+}
+/**
+ * Tells subscribers that an open session's answers changed — the version it
+ * holds went live, or stopped being live — without registering it again.
+ */ export function notifyEditorSessionChanged() {
+    notify();
+}
+/**
+ * Stages `values` into the session's own fields, and reveals them when any
+ * was staged. Nothing is saved.
+ */ export function stageEditorSessionFields(session, values) {
+    const staged = [];
+    const unknown = [];
+    for (const [key, value] of Object.entries(values != null ? values : {})){
+        var _session_fields;
+        const set = (_session_fields = session.fields) == null ? void 0 : _session_fields[key];
+        if (typeof set !== 'function') {
+            unknown.push(key);
+            continue;
+        }
+        set(String(value));
+        staged.push(key);
+    }
+    if (staged.length) session.revealFields == null ? void 0 : session.revealFields.call(session);
+    return {
+        staged,
+        unknown
+    };
+}
+/** Closes every session and drops every subscriber. Specs only. */ export function resetEditorSessionsForTests() {
+    sessions.length = 0;
+    listeners.clear();
+    revision = 0;
+}
+
+//# sourceMappingURL=editor-sessions.js.map

package/src/lib/plugin-manager/editor-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/editor-sessions.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 editor a person has open, as another surface may act on it.\n *\n * A console editor — the besigner on a screen, a component or a layout —\n * holds state no plugin can reach: which element is selected, whether the\n * version it has open is the one the live site serves, the dialog that makes\n * a new version, and form fields that sit beside the canvas rather than on\n * it (a screen's search title). A plugin mounted in a shell zone that wants\n * to help with that document — a translation, a review comment, a proposed\n * edit — would otherwise have to import the console page, which the package\n * map forbids, or write the stored document itself, which skips the editor's\n * guards and the author's review.\n *\n * So the editor registers a SESSION while it is open, and a plugin reads it.\n * Every capability is the editor's own:\n *\n *  - `selectedNodeId` and `isLiveVersion` are answered when asked, so a\n *    caller never holds an answer from registration time;\n *  - `createVersion` starts the editor's own new-version flow, with its\n *    entitlement check, its refusal to copy an unsaved canvas and its name\n *    dialog — nothing here creates a version;\n *  - `fields` are the setters the editor's own form reads, so a staged value\n *    is exactly what typing it would have been: an unsaved edit, stored only\n *    when the author saves with the editor's own control. There is no save\n *    here, by construction.\n *\n * One editor is open at a time in a console tab, but a remount registers\n * before the previous mount's cleanup runs, so registrations stack: the\n * newest session answers, and an unregister removes only the registration\n * it was returned for.\n */\n\nexport interface EditorSession {\n  /** The kind of document open, as the editor's route names it: `screen`, `component`, `layout`. */\n  documentKind: string\n  /** The id of the document open. */\n  documentId: string\n  /** The id of the version open. */\n  versionId: string\n  /** Whether the open version is the one the live site serves. */\n  isLiveVersion: () => boolean\n  /** The element the author has selected, or null. */\n  selectedNodeId?: () => string | null\n  /**\n   * Starts the editor's own new-version flow. Whether a version results is\n   * the flow's decision — the plan, an unsaved canvas and the author's own\n   * dialog can each stop it — and a created version opens in the editor the\n   * way the editor's own button opens it.\n   */\n  createVersion?: () => void\n  /**\n   * Fields beside the canvas another surface may stage, keyed as the editor\n   * names them (`seo.title`), each with the setter the editor's own form\n   * reads.\n   */\n  fields?: Readonly<Record<string, (value: string) => void>>\n  /** Brings the staged fields into view, so the author sees them before saving. */\n  revealFields?: () => void\n}\n\n/** What a staging call did: the keys it staged, and the keys the editor lacks. */\nexport interface EditorFieldStageResult {\n  staged: string[]\n  unknown: string[]\n}\n\nconst sessions: EditorSession[] = []\nconst listeners = new Set<() => void>()\nlet revision = 0\n\nfunction notify(): void {\n  revision += 1\n  for (const listener of [...listeners]) listener()\n}\n\n/**\n * Registers the open editor. Returns the unregister function, which removes\n * only this registration.\n */\nexport function registerEditorSession(session: EditorSession): () => void {\n  const documentKind = String(session?.documentKind ?? '').trim()\n  const documentId = String(session?.documentId ?? '').trim()\n  const versionId = String(session?.versionId ?? '').trim()\n  if (!documentKind || !documentId || !versionId) {\n    throw new Error(\n      'an editor session needs a document kind, a document id and a version id',\n    )\n  }\n  if (typeof session.isLiveVersion !== 'function') {\n    throw new Error('an editor session needs isLiveVersion')\n  }\n  const entry: EditorSession = { ...session, documentKind, documentId, versionId }\n  sessions.push(entry)\n  notify()\n  return () => {\n    const index = sessions.indexOf(entry)\n    if (index < 0) return\n    sessions.splice(index, 1)\n    notify()\n  }\n}\n\n/** The newest open editor session, or `undefined` when no editor is open. */\nexport function openEditorSession(): EditorSession | undefined {\n  return sessions[sessions.length - 1]\n}\n\n/**\n * Calls `listener` whenever a session opens or closes, or its editor reports\n * that an answer changed. Returns the unsubscribe function.\n */\nexport function subscribeEditorSessions(listener: () => void): () => void {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/**\n * A number that moves on every notification — the snapshot a React\n * subscriber compares, since the open session itself stays the same object\n * when only one of its answers changes.\n */\nexport function editorSessionsRevision(): number {\n  return revision\n}\n\n/**\n * Tells subscribers that an open session's answers changed — the version it\n * holds went live, or stopped being live — without registering it again.\n */\nexport function notifyEditorSessionChanged(): void {\n  notify()\n}\n\n/**\n * Stages `values` into the session's own fields, and reveals them when any\n * was staged. Nothing is saved.\n */\nexport function stageEditorSessionFields(\n  session: EditorSession,\n  values: Readonly<Record<string, string>>,\n): EditorFieldStageResult {\n  const staged: string[] = []\n  const unknown: string[] = []\n  for (const [key, value] of Object.entries(values ?? {})) {\n    const set = session.fields?.[key]\n    if (typeof set !== 'function') {\n      unknown.push(key)\n      continue\n    }\n    set(String(value))\n    staged.push(key)\n  }\n  if (staged.length) session.revealFields?.()\n  return { staged, unknown }\n}\n\n/** Closes every session and drops every subscriber. Specs only. */\nexport function resetEditorSessionsForTests(): void {\n  sessions.length = 0\n  listeners.clear()\n  revision = 0\n}\n"],"names":["sessions","listeners","Set","revision","notify","listener","registerEditorSession","session","documentKind","String","trim","documentId","versionId","Error","isLiveVersion","entry","push","index","indexOf","splice","openEditorSession","length","subscribeEditorSessions","add","delete","editorSessionsRevision","notifyEditorSessionChanged","stageEditorSessionFields","values","staged","unknown","key","value","Object","entries","set","fields","revealFields","resetEditorSessionsForTests","clear"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BC;AAoCD,MAAMA,WAA4B,EAAE;AACpC,MAAMC,YAAY,IAAIC;AACtB,IAAIC,WAAW;AAEf,SAASC;IACPD,YAAY;IACZ,KAAK,MAAME,YAAY;WAAIJ;KAAU,CAAEI;AACzC;AAEA;;;CAGC,GACD,OAAO,SAASC,sBAAsBC,OAAsB;;IAC1D,MAAMC,eAAeC,eAAOF,2BAAAA,QAASC,YAAY,mBAAI,IAAIE,IAAI;IAC7D,MAAMC,aAAaF,gBAAOF,2BAAAA,QAASI,UAAU,oBAAI,IAAID,IAAI;IACzD,MAAME,YAAYH,gBAAOF,2BAAAA,QAASK,SAAS,oBAAI,IAAIF,IAAI;IACvD,IAAI,CAACF,gBAAgB,CAACG,cAAc,CAACC,WAAW;QAC9C,MAAM,IAAIC,MACR;IAEJ;IACA,IAAI,OAAON,QAAQO,aAAa,KAAK,YAAY;QAC/C,MAAM,IAAID,MAAM;IAClB;IACA,MAAME,QAAuB,aAAKR;QAASC;QAAcG;QAAYC;;IACrEZ,SAASgB,IAAI,CAACD;IACdX;IACA,OAAO;QACL,MAAMa,QAAQjB,SAASkB,OAAO,CAACH;QAC/B,IAAIE,QAAQ,GAAG;QACfjB,SAASmB,MAAM,CAACF,OAAO;QACvBb;IACF;AACF;AAEA,2EAA2E,GAC3E,OAAO,SAASgB;IACd,OAAOpB,QAAQ,CAACA,SAASqB,MAAM,GAAG,EAAE;AACtC;AAEA;;;CAGC,GACD,OAAO,SAASC,wBAAwBjB,QAAoB;IAC1DJ,UAAUsB,GAAG,CAAClB;IACd,OAAO;QACLJ,UAAUuB,MAAM,CAACnB;IACnB;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASoB;IACd,OAAOtB;AACT;AAEA;;;CAGC,GACD,OAAO,SAASuB;IACdtB;AACF;AAEA;;;CAGC,GACD,OAAO,SAASuB,yBACdpB,OAAsB,EACtBqB,MAAwC;IAExC,MAAMC,SAAmB,EAAE;IAC3B,MAAMC,UAAoB,EAAE;IAC5B,KAAK,MAAM,CAACC,KAAKC,MAAM,IAAIC,OAAOC,OAAO,CAACN,iBAAAA,SAAU,CAAC,GAAI;YAC3CrB;QAAZ,MAAM4B,OAAM5B,kBAAAA,QAAQ6B,MAAM,qBAAd7B,eAAgB,CAACwB,IAAI;QACjC,IAAI,OAAOI,QAAQ,YAAY;YAC7BL,QAAQd,IAAI,CAACe;YACb;QACF;QACAI,IAAI1B,OAAOuB;QACXH,OAAOb,IAAI,CAACe;IACd;IACA,IAAIF,OAAOR,MAAM,EAAEd,QAAQ8B,YAAY,oBAApB9B,QAAQ8B,YAAY,MAApB9B;IACnB,OAAO;QAAEsB;QAAQC;IAAQ;AAC3B;AAEA,iEAAiE,GACjE,OAAO,SAASQ;IACdtC,SAASqB,MAAM,GAAG;IAClBpB,UAAUsC,KAAK;IACfpC,WAAW;AACb"}