@aglyn/aglyn 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/foundation/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/foundation/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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//    / __ \\/ ____/ ____/  _/ | / /  _/_  __/  _/ __ \\/ | / / ___/\n//   / / / / __/ / /_   / //  |/ // /  / /  / // / / /  |/ /\\__ \\\n//  / /_/ / /___/ __/ _/ // /|  // /  / / _/ // /_/ / /|  /___/ /\n// /_____/_____/_/   /___/_/ |_/___/ /_/ /___/\\____/_/ |_//____/\n// 👇\n\nexport * from './definitions/components.types'\n// One postal address + one phone format, shared by the personal profile, the\n// org billing address and the Stripe customer (AGL-1133). The failure this\n// prevents is a phone number stored three ways in three collections.\nexport * from './definitions/contact.types'\n// Which host subcollections the media usage scan reads, and which it skips\n// with a written reason (AGL-1867). A VALUE, and exported here rather than\n// kept in the console, because the guard that keeps it equal to a repo-wide\n// sweep lives beside the other derived host-subcollection guards.\nexport * from './definitions/host-content-collections'\nexport * from './definitions/organization.types'\n// The component and layout property kinds (AGL-2893), VALUES because the\n// Properties dialog, the Attributes panel and the graft all read the same\n// table — one list per field kind, derived from `FieldComponentType`.\nexport * from './definitions/property-kinds'\nexport * from './definitions/shared'\n// `HOST_UNPERSISTED_FIELDS` is a VALUE for the same reason its org twin below\n// is: it states which `hosts/{hostId}` keys are never fields. It is exported\n// here so the write boundary can enforce that declaration at runtime\n// (AGL-1429), not only so the rules coverage guard can read it.\nexport {\n  // The four error slots as a VALUE (AGL-2092). Exported because their COUNT\n  // is now the bound on `kind: 'error'` exemptions (`ERROR_SCREEN_MAX_PER_HOST`)\n  // as well as the console card's picker list — one list, so the pickers and\n  // the bound cannot drift apart.\n  HOST_ERROR_SCREEN_SLOTS,\n  HOST_UNPERSISTED_FIELDS,\n  HostEntityType,\n  HostRedirectParams,\n  HostScreenStatus,\n  HostScreenVisibility,\n  HostViewFormat,\n  HostViewType,\n} from './definitions/platform.types'\n// AglynScreenVersion/AglynLayoutVersion are exported (specialized with the\n// SDK's NodeSchema) from ../types/screen instead of this generic form.\n// Org billing vocabulary (see definitions/org-billing.types.ts and the\n// glossary). The two ownership maps are VALUES, not types: they are the\n// declared client-writable/unpersisted partition of `orgs/{orgId}` that the\n// AGL-1355 coverage guard checks the Firestore rules against.\nexport {\n  ORG_CLIENT_WRITABLE_FIELDS,\n  ORG_UNPERSISTED_FIELDS,\n} from './definitions/org-billing.types'\nexport type {\n  AglynOrgBilling,\n  // The core halves of the two composed shapes (AGL-3124): what a plan table\n  // declares exhaustively, beside the plugin half every reader gets through\n  // `OrgEntitlements` / `OrgFeatureFlags`.\n  CoreOrgEntitlements,\n  CoreOrgFeatureFlags,\n  OrgBandwidthCap,\n  OrgBrandingProfile,\n  OrgCrmAssignmentRule,\n  OrgCrmHostSettings,\n  OrgCrmRoundRobin,\n  OrgCrmSettings,\n  OrgDiscount,\n  OrgEntitlements,\n  OrgFeatureFlags,\n  OrgPlan,\n  OrgPlanComp,\n  OrgSeatAddons,\n  OrgSubscription,\n  OrgUid,\n} from './definitions/org-billing.types'\nexport type {\n  AglynDocument,\n  AglynHost,\n  AglynHostComponent,\n  AglynHostComponentVersion,\n  AglynHostMedia,\n  AglynHostMediaFolder,\n  AglynHostTheme,\n  AglynLayout,\n  AglynRedirect,\n  AglynScreen,\n  AglynTemplate,\n  AglynUser,\n  ComponentDefUid,\n  HostAnnouncementBar,\n  HostErrorScreens,\n  HostErrorScreenSlot,\n  HostPopup,\n  HostMediaUid,\n  HostPath,\n  HostUid,\n  LayoutUid,\n  LegacyNamedFieldKind,\n  NonValueFieldKind,\n  ProjectNumber,\n  ProjectUid,\n  PublishSchedule,\n  RedirectUid,\n  ReusableComponentIcon,\n  ReusableComponentKind,\n  ReusableComponentProp,\n  ReusableComponentPropCondition,\n  ReusableComponentPropOption,\n  ReusableComponentPropRule,\n  ReusableComponentPropType,\n  ReusableComponentPropValue,\n  ScopeToken,\n  ScreenSlug,\n  ScreenUid,\n  TemplateKind,\n  TemplatePlaceholder,\n  TemplateSource,\n  TemplateUid,\n  UserUid,\n  VersionUid,\n} from './definitions/platform.types'\n\n//    __________  _   ________________    _   _____________\n//   / ____/ __ \\/ | / / ___/_  __/   |  / | / /_  __/ ___/\n//  / /   / / / /  |/ /\\__ \\ / / / /| | /  |/ / / /  \\__ \\\n// / /___/ /_/ / /|  /___/ // / / ___ |/ /|  / / /  ___/ /\n// \\____/\\____/_/ |_//____//_/ /_/  |_/_/ |_/ /_/  /____/\n// 👇\n\nexport * from './constants/_internal'\nexport * from './constants/app'\nexport * from './constants/canvas'\nexport * from './constants/components'\nexport * from './constants/shared'\nexport * from './constants/symbol'\n"],"names":["HOST_ERROR_SCREEN_SLOTS","HOST_UNPERSISTED_FIELDS","HostEntityType","HostRedirectParams","HostScreenStatus","HostScreenVisibility","HostViewFormat","HostViewType","ORG_CLIENT_WRITABLE_FIELDS","ORG_UNPERSISTED_FIELDS"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,kEAAkE;AAClE,kEAAkE;AAClE,iEAAiE;AACjE,iEAAiE;AACjE,gEAAgE;AAChE,KAAK;AAEL,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,cAAc,iCAA6B;AAC3C,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,kEAAkE;AAClE,cAAc,4CAAwC;AACtD,cAAc,sCAAkC;AAChD,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,cAAc,kCAA8B;AAC5C,cAAc,0BAAsB;AACpC,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,gEAAgE;AAChE,SACE,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,gCAAgC;AAChCA,uBAAuB,EACvBC,uBAAuB,EACvBC,cAAc,EACdC,kBAAkB,EAClBC,gBAAgB,EAChBC,oBAAoB,EACpBC,cAAc,EACdC,YAAY,QACP,kCAA8B;AACrC,2EAA2E;AAC3E,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,4EAA4E;AAC5E,8DAA8D;AAC9D,SACEC,0BAA0B,EAC1BC,sBAAsB,QACjB,qCAAiC;AAsExC,2DAA2D;AAC3D,2DAA2D;AAC3D,0DAA0D;AAC1D,0DAA0D;AAC1D,yDAAyD;AACzD,KAAK;AAEL,cAAc,2BAAuB;AACrC,cAAc,qBAAiB;AAC/B,cAAc,wBAAoB;AAClC,cAAc,4BAAwB;AACtC,cAAc,wBAAoB;AAClC,cAAc,wBAAoB"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/foundation/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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//    / __ \\/ ____/ ____/  _/ | / /  _/_  __/  _/ __ \\/ | / / ___/\n//   / / / / __/ / /_   / //  |/ // /  / /  / // / / /  |/ /\\__ \\\n//  / /_/ / /___/ __/ _/ // /|  // /  / / _/ // /_/ / /|  /___/ /\n// /_____/_____/_/   /___/_/ |_/___/ /_/ /___/\\____/_/ |_//____/\n// 👇\n\nexport * from './definitions/components.types'\n// One postal address + one phone format, shared by the personal profile, the\n// org billing address and the Stripe customer (AGL-1133). The failure this\n// prevents is a phone number stored three ways in three collections.\nexport * from './definitions/contact.types'\n// Which host subcollections the media usage scan reads, and which it skips\n// with a written reason (AGL-1867). A VALUE, and exported here rather than\n// kept in the console, because the guard that keeps it equal to a repo-wide\n// sweep lives beside the other derived host-subcollection guards.\nexport * from './definitions/host-content-collections'\nexport * from './definitions/organization.types'\n// The component and layout property kinds (AGL-2893), VALUES because the\n// Properties dialog, the Attributes panel and the graft all read the same\n// table — one list per field kind, derived from `FieldComponentType`.\nexport * from './definitions/property-kinds'\nexport * from './definitions/shared'\n// `HOST_UNPERSISTED_FIELDS` is a VALUE for the same reason its org twin below\n// is: it states which `hosts/{hostId}` keys are never fields. It is exported\n// here so the write boundary can enforce that declaration at runtime\n// (AGL-1429), not only so the rules coverage guard can read it.\nexport {\n  // The four error slots as a VALUE (AGL-2092). Exported because their COUNT\n  // is now the bound on `kind: 'error'` exemptions (`ERROR_SCREEN_MAX_PER_HOST`)\n  // as well as the console card's picker list — one list, so the pickers and\n  // the bound cannot drift apart.\n  HOST_ERROR_SCREEN_SLOTS,\n  HOST_UNPERSISTED_FIELDS,\n  HostEntityType,\n  HostRedirectParams,\n  HostScreenStatus,\n  HostScreenVisibility,\n  HostViewFormat,\n  HostViewType,\n} from './definitions/platform.types'\n// AglynScreenVersion/AglynLayoutVersion are exported (specialized with the\n// SDK's NodeSchema) from ../types/screen instead of this generic form.\n// Org billing vocabulary (see definitions/org-billing.types.ts and the\n// glossary). The two ownership maps are VALUES, not types: they are the\n// declared client-writable/unpersisted partition of `orgs/{orgId}` that the\n// AGL-1355 coverage guard checks the Firestore rules against.\nexport {\n  ORG_CLIENT_WRITABLE_FIELDS,\n  ORG_UNPERSISTED_FIELDS,\n} from './definitions/org-billing.types'\nexport type {\n  AglynOrgBilling,\n  // The core halves of the two composed shapes (AGL-3124): what a plan table\n  // declares exhaustively, beside the plugin half every reader gets through\n  // `OrgEntitlements` / `OrgFeatureFlags`.\n  CoreOrgEntitlements,\n  CoreOrgFeatureFlags,\n  OrgBandwidthCap,\n  OrgBrandingProfile,\n  OrgCrmAssignmentRule,\n  OrgCrmHostSettings,\n  OrgCrmRoundRobin,\n  OrgCrmSettings,\n  OrgDiscount,\n  OrgEntitlements,\n  OrgFeatureFlags,\n  OrgPlan,\n  OrgPlanComp,\n  OrgSeatAddons,\n  OrgSubscription,\n  OrgUid,\n  OrgUpgradeProposal,\n} from './definitions/org-billing.types'\nexport type {\n  AglynDocument,\n  AglynHost,\n  AglynHostComponent,\n  AglynHostComponentVersion,\n  AglynHostMedia,\n  AglynHostMediaFolder,\n  AglynHostTheme,\n  AglynLayout,\n  AglynRedirect,\n  AglynScreen,\n  AglynTemplate,\n  AglynUser,\n  ComponentDefUid,\n  HostAnnouncementBar,\n  HostErrorScreens,\n  HostErrorScreenSlot,\n  HostPopup,\n  HostMediaUid,\n  HostPath,\n  HostUid,\n  LayoutUid,\n  LegacyNamedFieldKind,\n  NonValueFieldKind,\n  ProjectNumber,\n  ProjectUid,\n  PublishSchedule,\n  RedirectUid,\n  ReusableComponentIcon,\n  ReusableComponentKind,\n  ReusableComponentProp,\n  ReusableComponentPropCondition,\n  ReusableComponentPropOption,\n  ReusableComponentPropRule,\n  ReusableComponentPropType,\n  ReusableComponentPropValue,\n  ScopeToken,\n  ScreenSlug,\n  ScreenUid,\n  TemplateKind,\n  TemplatePlaceholder,\n  TemplateSource,\n  TemplateUid,\n  UserUid,\n  VersionUid,\n} from './definitions/platform.types'\n\n//    __________  _   ________________    _   _____________\n//   / ____/ __ \\/ | / / ___/_  __/   |  / | / /_  __/ ___/\n//  / /   / / / /  |/ /\\__ \\ / / / /| | /  |/ / / /  \\__ \\\n// / /___/ /_/ / /|  /___/ // / / ___ |/ /|  / / /  ___/ /\n// \\____/\\____/_/ |_//____//_/ /_/  |_/_/ |_/ /_/  /____/\n// 👇\n\nexport * from './constants/_internal'\nexport * from './constants/app'\nexport * from './constants/canvas'\nexport * from './constants/components'\nexport * from './constants/shared'\nexport * from './constants/symbol'\n"],"names":["HOST_ERROR_SCREEN_SLOTS","HOST_UNPERSISTED_FIELDS","HostEntityType","HostRedirectParams","HostScreenStatus","HostScreenVisibility","HostViewFormat","HostViewType","ORG_CLIENT_WRITABLE_FIELDS","ORG_UNPERSISTED_FIELDS"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,kEAAkE;AAClE,kEAAkE;AAClE,iEAAiE;AACjE,iEAAiE;AACjE,gEAAgE;AAChE,KAAK;AAEL,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,cAAc,iCAA6B;AAC3C,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,kEAAkE;AAClE,cAAc,4CAAwC;AACtD,cAAc,sCAAkC;AAChD,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,cAAc,kCAA8B;AAC5C,cAAc,0BAAsB;AACpC,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,gEAAgE;AAChE,SACE,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,gCAAgC;AAChCA,uBAAuB,EACvBC,uBAAuB,EACvBC,cAAc,EACdC,kBAAkB,EAClBC,gBAAgB,EAChBC,oBAAoB,EACpBC,cAAc,EACdC,YAAY,QACP,kCAA8B;AACrC,2EAA2E;AAC3E,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,4EAA4E;AAC5E,8DAA8D;AAC9D,SACEC,0BAA0B,EAC1BC,sBAAsB,QACjB,qCAAiC;AAuExC,2DAA2D;AAC3D,2DAA2D;AAC3D,0DAA0D;AAC1D,0DAA0D;AAC1D,yDAAyD;AACzD,KAAK;AAEL,cAAc,2BAAuB;AACrC,cAAc,qBAAiB;AAC/B,cAAc,wBAAoB;AAClC,cAAc,4BAAwB;AACtC,cAAc,wBAAoB;AAClC,cAAc,wBAAoB"}

package/src/lib/plugin-manager/feature-plugins.d.ts

@@ -699,8 +699,8 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      */
     readonly hostFirstRun: "hostFirstRun";
     /**
-     * The host setup Theme section, between the "What you have changed" card
-     * and the editor (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
+     * The host setup Theme section, between the Theme picker and the editor
+     * (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
      * site, the theme the editor shows, where that theme came from, the
      * editor's own preview, and `proposeDraft`, which puts a theme in the
      * editor as unsaved changes.
@@ -873,6 +873,23 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      * names no site).
      */
     readonly besignerToolbar: "besignerToolbar";
+    /**
+     * A section at the foot of the besigner's Page Properties drawer
+     * (AGL-3475), under the page's publishing, layout, SEO and password
+     * sections: what a plugin makes of the PAGE itself, such as serving it once
+     * per record. Props: {@link ConsoleBesignerPagePropertiesZoneProps}. The
+     * drawer's column spaces each widget as one of its sections; a widget saves
+     * through its own routes, never through the drawer's buttons.
+     */
+    readonly besignerPageProperties: "besignerPageProperties";
+    /**
+     * Inside one row of a site's Pages list (AGL-3475), beside the page's name:
+     * a chip a plugin draws about that page — that it is a record template,
+     * and how many pages it serves. Props:
+     * {@link ConsoleHostScreenRowZoneProps}. Drawn once per row, so a widget
+     * reads what it needs once for the site and answers each row from that.
+     */
+    readonly hostScreenRow: "hostScreenRow";
     /**
      * A site's Screens page, beside its Templates and Create New Screen actions
      * (AGL-2907): another way to start a screen. Props:
@@ -915,8 +932,43 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      * widget's declared permission.
      */
     readonly orgSites: "orgSites";
+    /**
+     * One side of one item in a site package import's Changes step, beside
+     * the other side (AGL-3545): the item drawn the way its owner previews it.
+     * Props: {@link ConsoleSitePackageItemPreviewZoneProps}.
+     *
+     * A package carries items of many kinds, and how one looks belongs to
+     * whoever keeps that kind — a form through the form's own preview, a site
+     * email through the email preview. So a widget here names the kinds it
+     * draws in its `itemKinds`, the import draws it for those and nothing else,
+     * and an item of a kind no widget names keeps the console's own rendering
+     * or its value list. The widget reads nothing it is not handed beyond what
+     * its preview always reads, and never writes: the import writes, after the
+     * person decides.
+     */
+    readonly sitePackageItemPreview: "sitePackageItemPreview";
 };
 export type ConsoleWidgetSlot = (typeof CONSOLE_WIDGET_SLOTS)[keyof typeof CONSOLE_WIDGET_SLOTS];
+/** What the `besignerPageProperties` zone hands each widget (AGL-3475). */
+export interface ConsoleBesignerPagePropertiesZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` while it resolves. */
+    orgId: string | undefined;
+    /** The page in the editor. */
+    screenId: string;
+    /** The page's `kind` as stored: `'template'` for a template, absent for a page. */
+    screenKind?: string;
+}
+/** What the `hostScreenRow` zone hands each widget (AGL-3475). */
+export interface ConsoleHostScreenRowZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` while it resolves. */
+    orgId: string | undefined;
+    /** The row's page. */
+    screenId: string;
+    /** The page's `kind` as stored. */
+    screenKind?: string;
+}
 /** What the `hostScreens` zone hands each widget (AGL-2907). */
 export interface ConsoleHostScreensZoneProps {
     hostId: string;
@@ -1143,6 +1195,23 @@ export interface ConsoleTemplateInstallStatusZoneProps {
      */
     template: Readonly<Record<string, unknown>>;
 }
+/** What the `sitePackageItemPreview` zone hands each widget (AGL-3545). */
+export interface ConsoleSitePackageItemPreviewZoneProps {
+    /** The site the package is being imported into. */
+    hostId: string;
+    /** Which side this is: the site's copy, or the file's. */
+    side: 'site' | 'file';
+    /** The item's package key, `<kind>/<id>`. */
+    itemKey: string;
+    /** One of the kinds the widget names in `itemKinds`. */
+    kind: string;
+    /** The document the side is: the site's item, or the id the file's would land under. */
+    itemId: string;
+    /** The item as an import would write it: the document, without `$id`. */
+    content: unknown;
+    /** What the import calls the item. */
+    title: string;
+}
 /** What the `hostArtifactPublish` zone hands each widget (AGL-3080). */
 export interface ConsoleArtifactPublishZoneProps {
     /**
@@ -1194,6 +1263,20 @@ export interface ConsoleHostThemeZoneProps {
 export declare const CONSOLE_STAFF_WIDGET_SLOTS: readonly ConsoleWidgetSlot[];
 /** Whether a slot is one of the {@link CONSOLE_STAFF_WIDGET_SLOTS}. */
 export declare function isConsoleStaffWidgetSlot(slot: string): boolean;
+/**
+ * The zones whose HOST decides who reads them (AGL-3554): each widget draws
+ * only the props the host hands it, and the host page is already gated on
+ * what its own route requires — a site package import's side-by-side diff,
+ * opened by whoever may import a package into the site. So the console asks
+ * the widget's own `permission` there and not its extension's: an
+ * extension's permission guards the extension's own surfaces and reads (the
+ * Email plugin's `data.manage`, for the audiences its page lists), and
+ * would otherwise hide a preview from the very person importing the item.
+ * The extension's plan feature is still asked.
+ */
+export declare const CONSOLE_HOST_GATED_WIDGET_SLOTS: readonly ConsoleWidgetSlot[];
+/** Whether a slot is one of the {@link CONSOLE_HOST_GATED_WIDGET_SLOTS}. */
+export declare function isConsoleHostGatedWidgetSlot(slot: string): boolean;
 /** Search listing values by field; a field the editor does not hold is absent. */
 export type ConsoleSeoFieldValues = Partial<Record<SeoListingFieldKey, string>>;
 /**
@@ -1329,6 +1412,12 @@ export interface ConsoleWidget {
      * slots read it; elsewhere it is ignored.
      */
     column?: ConsoleWidgetColumn;
+    /**
+     * The kinds of item the widget draws, for a zone that draws one item of
+     * many kinds (`sitePackageItemPreview`, AGL-3545). Only the slots
+     * documented as reading it do; elsewhere it is ignored.
+     */
+    itemKinds?: readonly string[];
     /**
      * Stable identity for this widget, unique within the plugin per slot.
      * The id names the CARD, not its placement: the same card registered on

package/src/lib/plugin-manager/feature-plugins.js

@@ -257,8 +257,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * state worth returning to.
    */ hostFirstRun: 'hostFirstRun',
     /**
-   * The host setup Theme section, between the "What you have changed" card
-   * and the editor (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
+   * The host setup Theme section, between the Theme picker and the editor
+   * (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
    * site, the theme the editor shows, where that theme came from, the
    * editor's own preview, and `proposeDraft`, which puts a theme in the
    * editor as unsaved changes.
@@ -409,6 +409,21 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * names no site).
    */ besignerToolbar: 'besignerToolbar',
     /**
+   * A section at the foot of the besigner's Page Properties drawer
+   * (AGL-3475), under the page's publishing, layout, SEO and password
+   * sections: what a plugin makes of the PAGE itself, such as serving it once
+   * per record. Props: {@link ConsoleBesignerPagePropertiesZoneProps}. The
+   * drawer's column spaces each widget as one of its sections; a widget saves
+   * through its own routes, never through the drawer's buttons.
+   */ besignerPageProperties: 'besignerPageProperties',
+    /**
+   * Inside one row of a site's Pages list (AGL-3475), beside the page's name:
+   * a chip a plugin draws about that page — that it is a record template,
+   * and how many pages it serves. Props:
+   * {@link ConsoleHostScreenRowZoneProps}. Drawn once per row, so a widget
+   * reads what it needs once for the site and answers each row from that.
+   */ hostScreenRow: 'hostScreenRow',
+    /**
    * A site's Screens page, beside its Templates and Create New Screen actions
    * (AGL-2907): another way to start a screen. Props:
    * {@link ConsoleHostScreensZoneProps}. A widget here runs its own flow and
@@ -444,7 +459,21 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * door proves the reader's permission on each of them again. So the zone
    * carries no gate beyond the slot's own — enablement, entitlement, and the
    * widget's declared permission.
-   */ orgSites: 'orgSites'
+   */ orgSites: 'orgSites',
+    /**
+   * One side of one item in a site package import's Changes step, beside
+   * the other side (AGL-3545): the item drawn the way its owner previews it.
+   * Props: {@link ConsoleSitePackageItemPreviewZoneProps}.
+   *
+   * A package carries items of many kinds, and how one looks belongs to
+   * whoever keeps that kind — a form through the form's own preview, a site
+   * email through the email preview. So a widget here names the kinds it
+   * draws in its `itemKinds`, the import draws it for those and nothing else,
+   * and an item of a kind no widget names keeps the console's own rendering
+   * or its value list. The widget reads nothing it is not handed beyond what
+   * its preview always reads, and never writes: the import writes, after the
+   * person decides.
+   */ sitePackageItemPreview: 'sitePackageItemPreview'
 };
 /**
  * The zones on the STAFF pages (AGL-2939): the staff overview, the staff org
@@ -469,6 +498,22 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 /** Whether a slot is one of the {@link CONSOLE_STAFF_WIDGET_SLOTS}. */ export function isConsoleStaffWidgetSlot(slot) {
     return CONSOLE_STAFF_WIDGET_SLOTS.includes(slot);
 }
+/**
+ * The zones whose HOST decides who reads them (AGL-3554): each widget draws
+ * only the props the host hands it, and the host page is already gated on
+ * what its own route requires — a site package import's side-by-side diff,
+ * opened by whoever may import a package into the site. So the console asks
+ * the widget's own `permission` there and not its extension's: an
+ * extension's permission guards the extension's own surfaces and reads (the
+ * Email plugin's `data.manage`, for the audiences its page lists), and
+ * would otherwise hide a preview from the very person importing the item.
+ * The extension's plan feature is still asked.
+ */ export const CONSOLE_HOST_GATED_WIDGET_SLOTS = [
+    CONSOLE_WIDGET_SLOTS.sitePackageItemPreview
+];
+/** Whether a slot is one of the {@link CONSOLE_HOST_GATED_WIDGET_SLOTS}. */ export function isConsoleHostGatedWidgetSlot(slot) {
+    return CONSOLE_HOST_GATED_WIDGET_SLOTS.includes(slot);
+}
 const consoleExtensions = new Map();
 /** Idempotent by pluginId — re-registration replaces the previous entry. */ export function registerConsoleExtension(extension) {
     consoleExtensions.set(extension.pluginId, extension);