@aglyn/aglyn 1.0.0-beta.230 → 1.0.0-beta.232

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

@@ -743,6 +743,18 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      * widget.
      */
     readonly hostTheme: "hostTheme";
+    /**
+     * Inside the theme editor's Typography card (AGL-3656): the control that
+     * chooses the site's fonts. Props: {@link ConsoleThemeEditorFontsZoneProps}
+     * — the site, the editor's draft, and `updateDraft`, which changes the
+     * draft as any of the editor's own controls does.
+     *
+     * A widget here edits the draft and never writes: the editor's Save keeps
+     * the change and Discard drops it, with the preview beside it following
+     * every step. With no widget the editor offers its own short list of
+     * fonts, so a workspace without a fonts plugin can still choose one.
+     */
+    readonly themeEditorFonts: "themeEditorFonts";
     /**
      * The staff overview, among its platform-wide cards (AGL-3080). No props:
      * the overview is about the platform, not one org, so a widget here reads
@@ -901,6 +913,15 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      * them; nothing a widget proposes reaches the published site before that.
      */
     readonly hostSeo: "hostSeo";
+    /**
+     * The host setup Business profile section, under the site's profile and
+     * the facts read from its settings (AGL-3661). Props:
+     * {@link ConsoleHostBusinessProfileZoneProps}. What a plugin keeps ABOUT the
+     * business — the preferences an AI plugin learned from the owner's edits —
+     * shown where the owner reads and corrects the profile itself. A widget
+     * here writes only its own records.
+     */
+    readonly hostBusinessProfile: "hostBusinessProfile";
     /** {@link ConsoleRecordInsightsZoneProps} */
     readonly recordInsights: "recordInsights";
     /** {@link ConsoleRecordEmailZoneProps} */
@@ -1020,6 +1041,16 @@ export interface ConsoleHostScreenRowZoneProps {
     /** The page's `kind` as stored. */
     screenKind?: string;
 }
+/** What the `hostBusinessProfile` zone hands each widget (AGL-3661). */
+export interface ConsoleHostBusinessProfileZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` while it resolves. */
+    orgId: string | undefined;
+    /** Path slug for building `/[orgSlug]/…` links. */
+    orgSlug: string;
+    /** The site's subdomain, which is what a console URL names a site by. */
+    host: string | null;
+}
 /** What the `hostScreens` zone hands each widget (AGL-2907). */
 export interface ConsoleHostScreensZoneProps {
     hostId: string;
@@ -1331,6 +1362,18 @@ export interface ConsoleHostThemeZoneProps {
      */
     proposeDraft: (theme: HostTheme, key: string) => void;
 }
+/** What the `themeEditorFonts` zone hands each widget (AGL-3656). */
+export interface ConsoleThemeEditorFontsZoneProps {
+    /** The site whose theme is being edited; `null` on an editor that names none. */
+    hostId: string | null;
+    /** The editor's draft: the saved theme with every unsaved edit on it. */
+    draft: HostTheme;
+    /**
+     * Changes the draft. The updater gets the draft as it is when the change
+     * applies, so two edits in one tick both land.
+     */
+    updateDraft: (updater: (draft: HostTheme) => HostTheme) => void;
+}
 /**
  * The zones on the STAFF pages (AGL-2939): the staff overview, the staff org
  * page, its detail zone, and the staff user page.
@@ -1763,6 +1806,46 @@ export interface ConsoleStaffPage {
     ownsSubtree?: boolean;
     Component: ComponentType<ConsoleStaffPageProps>;
 }
+/** What the console's generic public route hands a public page. */
+export interface ConsolePublicPageProps {
+    /** The plugin that registered the page, the URL's first segment after `/kiosk`. */
+    pluginId: PluginId;
+    /** The page's own path, as it registered it (`/display`). */
+    path: string;
+}
+/**
+ * A full-screen console page that needs NO staff session (AGL-3608): served
+ * at `/kiosk/{pluginId}{path}` by the console's generic public route, outside
+ * the workspace shell, with only the console theme around it.
+ *
+ * The case is a device a business sets down in front of the public — a
+ * screen facing a customer, a sign-in tablet at a front desk — which is
+ * nobody's console session and must never become one. The shell draws no
+ * nav, no workspace, no org switcher and no plugin providers here, and the
+ * route loads this one plugin's console bundle and nothing else.
+ *
+ * Neither the extension's `featureFlag` nor its `permission` applies: there is
+ * no member to ask. The page proves itself to its own API routes — a pairing
+ * code exchanged for a device token, say — and every read it makes must be
+ * refused server-side without that proof. Treat everything the page renders
+ * as visible to whoever is standing in front of the device.
+ *
+ * The plugin also declares each path in its manifest as
+ * `contributes.console.publicRoutes`, which is what lets the route load the
+ * bundle only for a path that exists. First-party plugins only: the route
+ * reads the console's generated manifest, never a marketplace install.
+ */
+export interface ConsolePublicPage {
+    /**
+     * The path beneath `/kiosk/{pluginId}`, with its leading slash
+     * (`/display`). Matched exactly. It is in URLs saved on devices — treat it
+     * as persisted.
+     */
+    path: string;
+    /** The browser tab's title, which is also what a home-screen shortcut shows. */
+    title: string;
+    Component: ComponentType<ConsolePublicPageProps>;
+}
 export interface ConsoleExtension {
     pluginId: PluginId;
     displayName: string;
@@ -1848,6 +1931,12 @@ export interface ConsoleExtension {
      * Neither `featureFlag` nor `permission` applies to them.
      */
     staffPages?: readonly ConsoleStaffPage[];
+    /**
+     * Full-screen pages that need no staff session (AGL-3608) — see
+     * {@link ConsolePublicPage}. Neither `featureFlag` nor `permission` applies
+     * to them.
+     */
+    publicPages?: readonly ConsolePublicPage[];
     /**
      * App-level providers the shell mounts around every console page
      * (AGL-419) — e.g. the marketplace plugin's AI-assist provider.
@@ -1973,6 +2062,24 @@ export declare function listConsoleStaffPages(enabledPluginIds?: readonly Plugin
  * symptom — the same rule {@link resolveConsolePluginPage} applies to paths.
  */
 export declare function resolveConsoleStaffPage(id: string, enabledPluginIds?: readonly PluginId[]): ConsoleStaffPageEntry | undefined;
+/** A public page flattened with its owning extension's id. */
+export interface ConsolePublicPageEntry extends ConsolePublicPage {
+    pluginId: PluginId;
+}
+/** `pos-display`, `/pos-display/` and `/pos-display` all name `/pos-display`. */
+export declare function normalizeConsolePublicPath(path: string): string;
+/** Every registered public page, in registration order. */
+export declare function listConsolePublicPages(enabledPluginIds?: readonly PluginId[]): ConsolePublicPageEntry[];
+/**
+ * The public page at `/kiosk/{pluginId}{path}` (AGL-3608), or `undefined`.
+ *
+ * Scoped to the ONE plugin the URL names, because the registry is a
+ * session-wide union (AGL-758): a device that once loaded another plugin
+ * must not have that plugin answer a path in this one's namespace. Two
+ * extensions of the same plugin claiming one path resolve to nothing and
+ * say so, the rule {@link resolveConsoleStaffPage} applies to ids.
+ */
+export declare function resolveConsolePublicPage(pluginId: PluginId, path: string): ConsolePublicPageEntry | undefined;
 /** Widgets registered for a slot, across every extension (AGL-419). */
 export declare function listConsoleWidgets(slot: string, enabledPluginIds?: readonly PluginId[]): Array<{
     extension: ConsoleExtension;

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

@@ -279,6 +279,17 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * widget.
    */ hostTheme: 'hostTheme',
     /**
+   * Inside the theme editor's Typography card (AGL-3656): the control that
+   * chooses the site's fonts. Props: {@link ConsoleThemeEditorFontsZoneProps}
+   * — the site, the editor's draft, and `updateDraft`, which changes the
+   * draft as any of the editor's own controls does.
+   *
+   * A widget here edits the draft and never writes: the editor's Save keeps
+   * the change and Discard drops it, with the preview beside it following
+   * every step. With no widget the editor offers its own short list of
+   * fonts, so a workspace without a fonts plugin can still choose one.
+   */ themeEditorFonts: 'themeEditorFonts',
+    /**
    * The staff overview, among its platform-wide cards (AGL-3080). No props:
    * the overview is about the platform, not one org, so a widget here reads
    * what its plugin holds across every workspace through its own staff
@@ -417,6 +428,14 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * which puts values in the form as unsaved edits. The form's Update stores
    * them; nothing a widget proposes reaches the published site before that.
    */ hostSeo: 'hostSeo',
+    /**
+   * The host setup Business profile section, under the site's profile and
+   * the facts read from its settings (AGL-3661). Props:
+   * {@link ConsoleHostBusinessProfileZoneProps}. What a plugin keeps ABOUT the
+   * business — the preferences an AI plugin learned from the owner's edits —
+   * shown where the owner reads and corrects the profile itself. A widget
+   * here writes only its own records.
+   */ hostBusinessProfile: 'hostBusinessProfile',
     /** {@link ConsoleRecordInsightsZoneProps} */ recordInsights: 'recordInsights',
     /** {@link ConsoleRecordEmailZoneProps} */ recordEmail: 'recordEmail',
     /** {@link ConsoleImportMappingZoneProps} */ importMapping: 'importMapping',
@@ -763,6 +782,39 @@ function matchNavItemHref(navItem, itemHref, href) {
     }
     return matches[0];
 }
+/** `pos-display`, `/pos-display/` and `/pos-display` all name `/pos-display`. */ export function normalizeConsolePublicPath(path) {
+    return `/${String(path != null ? path : '').split('/').filter(Boolean).join('/')}`;
+}
+/** Every registered public page, in registration order. */ export function listConsolePublicPages(enabledPluginIds) {
+    return listConsoleExtensions(enabledPluginIds).flatMap((extension)=>{
+        var _extension_publicPages;
+        return ((_extension_publicPages = extension.publicPages) != null ? _extension_publicPages : []).map((page)=>_extends({}, page, {
+                path: normalizeConsolePublicPath(page.path),
+                pluginId: extension.pluginId
+            }));
+    });
+}
+/**
+ * The public page at `/kiosk/{pluginId}{path}` (AGL-3608), or `undefined`.
+ *
+ * Scoped to the ONE plugin the URL names, because the registry is a
+ * session-wide union (AGL-758): a device that once loaded another plugin
+ * must not have that plugin answer a path in this one's namespace. Two
+ * extensions of the same plugin claiming one path resolve to nothing and
+ * say so, the rule {@link resolveConsoleStaffPage} applies to ids.
+ */ export function resolveConsolePublicPage(pluginId, path) {
+    if (!pluginId) return undefined;
+    const wanted = normalizeConsolePublicPath(path);
+    if (wanted === '/') return undefined;
+    const matches = listConsolePublicPages([
+        pluginId
+    ]).filter((page)=>page.path === wanted);
+    if (matches.length > 1) {
+        console.error(`[aglyn] public page "/kiosk/${pluginId}${wanted}" is registered more ` + 'than once; refusing to guess which one to serve.');
+        return undefined;
+    }
+    return matches[0];
+}
 /** Widgets registered for a slot, across every extension (AGL-419). */ export function listConsoleWidgets(slot, enabledPluginIds) {
     const out = [];
     for (const extension of listConsoleExtensions(enabledPluginIds)){