@antelopejs/interface-dms 0.3.5 → 0.3.6

package/dist/page/registry.d.ts

@@ -1,43 +1,24 @@
 import type { ControllerClass } from "@antelopejs/interface-api";
 import { type Component, type ComponentTargetInput } from "../component";
-import type { PageMetadata } from "./metadata";
-import type { CategoryInfo, DynamicMenuProviderInfo, ModuleInfo, PageExtensionInfo, PageInfo, PageLayoutHandler } from "./types";
-export declare const permissionMap: Map<ControllerClass | Component<unknown>, string>;
-export declare const pageLayoutHandlers: Map<string, PageLayoutHandler>;
-export declare const pageMetadataByFullId: Map<string, PageMetadata>;
-export declare class RegistrationIdentity<T extends object> {
-    private readonly kind;
-    private readonly byToken;
-    constructor(kind: string);
-    private tokenOf;
-    stamp(value: T): void;
-    remember(value: T): void;
-    forget(value: T): void;
-    resolve(value: T): T;
-    isSame(left: T | undefined, right: T | undefined): boolean;
-}
-export declare const pageIdentity: RegistrationIdentity<PageInfo>;
-export declare const categoryIdentity: RegistrationIdentity<CategoryInfo>;
-export declare const moduleIdentity: RegistrationIdentity<ModuleInfo>;
-export declare const dynamicMenuProviderIdentity: RegistrationIdentity<DynamicMenuProviderInfo>;
-export declare const pageExtensionIdentity: RegistrationIdentity<PageExtensionInfo>;
-export declare function capturePageExtensionContext(info: PageExtensionInfo): void;
-export declare function runAsPageExtensionOwner<T>(info: PageExtensionInfo, callback: () => T): T;
-export declare function stampPageRegistration(pageInfo: PageInfo): void;
-export declare function isSamePageRegistration(left: PageInfo | undefined, right: PageInfo | undefined): boolean;
+import type { PageLayoutHandler } from "./types";
+/** Resolve every live page position of a reusable component. */
 export declare function GetComponentPermissionIds(component: Component): string[];
-export declare const pageExtensions: Map<string, PageExtensionInfo[]>;
-export declare function isPageExtensionRegistered(info: PageExtensionInfo): boolean;
 export declare function GetPageLayoutBySlug(slug: string): PageLayoutHandler | undefined;
+/**
+ * Drop the layout handler a page registered.
+ *
+ * Called when the page unregisters: the handler is reachable by slug through
+ * `/dms/pagelayout`, so leaving it behind keeps serving the layout of a page
+ * that is already gone from the registry, the navigation tree and its own
+ * route — an unloaded module's screens would still answer.
+ *
+ * @param slug Full slug the page registered under
+ */
 export declare function ClearPageLayoutBySlug(slug: string): void;
-export declare function acceptsPageExtensions(targetFullId: string): boolean;
-export interface PendingPageExtension {
-    extensionName: string;
-    targetFullId: string;
-}
-export declare function GetPendingPageExtensions(): PendingPageExtension[];
+/**
+ * Ids of every registered page, sorted. The id of a page is what
+ * `@RegisterPageExtension` takes, and also its permission id.
+ */
 export declare function GetRegisteredPageIds(): string[];
-export declare function syncTargetExtensions(targetFullId: string): Promise<void>;
+/** Resolve the permission id of a page, component, or exact child position. */
 export declare function GetPermissionId(target: ComponentTargetInput | ControllerClass): string | undefined;
-export declare const moduleRootCategories: Map<string, CategoryInfo>;
-export declare const moduleDefaultCategories: Map<string, CategoryInfo>;

package/dist/page/registry.js

@@ -1,150 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.moduleDefaultCategories = exports.moduleRootCategories = exports.pageExtensions = exports.pageExtensionIdentity = exports.dynamicMenuProviderIdentity = exports.moduleIdentity = exports.categoryIdentity = exports.pageIdentity = exports.RegistrationIdentity = exports.pageMetadataByFullId = exports.pageLayoutHandlers = exports.permissionMap = void 0;
-exports.capturePageExtensionContext = capturePageExtensionContext;
-exports.runAsPageExtensionOwner = runAsPageExtensionOwner;
-exports.stampPageRegistration = stampPageRegistration;
-exports.isSamePageRegistration = isSamePageRegistration;
 exports.GetComponentPermissionIds = GetComponentPermissionIds;
-exports.isPageExtensionRegistered = isPageExtensionRegistered;
 exports.GetPageLayoutBySlug = GetPageLayoutBySlug;
 exports.ClearPageLayoutBySlug = ClearPageLayoutBySlug;
-exports.acceptsPageExtensions = acceptsPageExtensions;
-exports.GetPendingPageExtensions = GetPendingPageExtensions;
 exports.GetRegisteredPageIds = GetRegisteredPageIds;
-exports.syncTargetExtensions = syncTargetExtensions;
 exports.GetPermissionId = GetPermissionId;
-const interface_core_1 = require("@antelopejs/interface-core");
-const modules_1 = require("@antelopejs/interface-core/modules");
 const component_1 = require("../component");
-exports.permissionMap = new Map();
-component_1.getPermissionIdRef.get = (component) => exports.permissionMap.get(component);
-exports.pageLayoutHandlers = new Map();
-exports.pageMetadataByFullId = new Map();
-const REGISTRATION_TOKEN = Symbol.for("@antelopejs/interface-dms:pageRegistration");
-let nextRegistrationToken = 0;
-class RegistrationIdentity {
-    kind;
-    byToken = new Map();
-    constructor(kind) {
-        this.kind = kind;
-    }
-    tokenOf(value) {
-        return value[REGISTRATION_TOKEN];
-    }
-    stamp(value) {
-        Object.defineProperty(value, REGISTRATION_TOKEN, {
-            value: `${this.kind}:${(nextRegistrationToken += 1)}`,
-            configurable: true,
-            enumerable: false,
-            writable: false,
-        });
-    }
-    remember(value) {
-        if (this.tokenOf(value) === undefined)
-            this.stamp(value);
-        const token = this.tokenOf(value);
-        if (token === undefined)
-            return;
-        this.byToken.set(token, value);
-    }
-    forget(value) {
-        const token = this.tokenOf(value);
-        if (token === undefined)
-            return;
-        if (this.byToken.get(token) !== value)
-            return;
-        this.byToken.delete(token);
-    }
-    resolve(value) {
-        const token = this.tokenOf(value);
-        if (token === undefined)
-            return value;
-        return this.byToken.get(token) ?? value;
-    }
-    isSame(left, right) {
-        if (!left || !right)
-            return false;
-        if (left === right)
-            return true;
-        const token = this.tokenOf(left);
-        return token !== undefined && token === this.tokenOf(right);
-    }
-}
-exports.RegistrationIdentity = RegistrationIdentity;
-exports.pageIdentity = new RegistrationIdentity("page");
-exports.categoryIdentity = new RegistrationIdentity("category");
-exports.moduleIdentity = new RegistrationIdentity("module");
-exports.dynamicMenuProviderIdentity = new RegistrationIdentity("dynamic-menu-provider");
-exports.pageExtensionIdentity = new RegistrationIdentity("page-extension");
-const pageExtensionContexts = new WeakMap();
-function capturePageExtensionContext(info) {
-    const context = (0, modules_1.GetModuleContext)();
-    if (context) {
-        pageExtensionContexts.set(info, context);
-        return;
-    }
-    const module = (0, interface_core_1.GetResponsibleModule)();
-    if (module)
-        pageExtensionContexts.set(info, { module });
-}
-function runAsPageExtensionOwner(info, callback) {
-    const context = pageExtensionContexts.get(exports.pageExtensionIdentity.resolve(info));
-    return context ? (0, modules_1.RunWithModuleContext)(context, callback) : callback();
-}
-function stampPageRegistration(pageInfo) {
-    exports.pageIdentity.stamp(pageInfo);
-}
-function isSamePageRegistration(left, right) {
-    return exports.pageIdentity.isSame(left, right);
-}
+const registry_1 = require("./internal/registry");
+component_1.getPermissionIdRef.get = (component) => registry_1.permissionMap.get(component);
+/** Resolve every live page position of a reusable component. */
 function GetComponentPermissionIds(component) {
-    return [...exports.pageMetadataByFullId.values()].flatMap((page) => page.ComponentPermissionIds(component));
-}
-exports.pageExtensions = new Map();
-function isPageExtensionRegistered(info) {
-    const registered = exports.pageExtensions.get(info.targetFullId) ?? [];
-    return registered.some((entry) => exports.pageExtensionIdentity.isSame(entry, info));
+    return [...registry_1.pageMetadataByFullId.values()].flatMap((page) => page.ComponentPermissionIds(component));
 }
 function GetPageLayoutBySlug(slug) {
-    return exports.pageLayoutHandlers.get(slug);
-}
+    return registry_1.pageLayoutHandlers.get(slug);
+}
+/**
+ * Drop the layout handler a page registered.
+ *
+ * Called when the page unregisters: the handler is reachable by slug through
+ * `/dms/pagelayout`, so leaving it behind keeps serving the layout of a page
+ * that is already gone from the registry, the navigation tree and its own
+ * route — an unloaded module's screens would still answer.
+ *
+ * @param slug Full slug the page registered under
+ */
 function ClearPageLayoutBySlug(slug) {
-    exports.pageLayoutHandlers.delete(slug);
-}
-function acceptsPageExtensions(targetFullId) {
-    return exports.pageMetadataByFullId.get(targetFullId)?.AcceptsExtensions() ?? false;
-}
-function GetPendingPageExtensions() {
-    const pending = [];
-    for (const [targetFullId, infos] of exports.pageExtensions) {
-        if (exports.pageMetadataByFullId.has(targetFullId))
-            continue;
-        for (const info of infos) {
-            pending.push({ extensionName: info.extensionName, targetFullId });
-        }
-    }
-    return pending;
+    registry_1.pageLayoutHandlers.delete(slug);
 }
+/**
+ * Ids of every registered page, sorted. The id of a page is what
+ * `@RegisterPageExtension` takes, and also its permission id.
+ */
 function GetRegisteredPageIds() {
-    return [...exports.pageMetadataByFullId.keys()].sort();
-}
-function syncTargetExtensions(targetFullId) {
-    const metadata = exports.pageMetadataByFullId.get(targetFullId);
-    if (!metadata) {
-        return Promise.resolve();
-    }
-    return metadata.SyncExtensions();
+    return [...registry_1.pageMetadataByFullId.keys()].sort();
 }
+/** Resolve the permission id of a page, component, or exact child position. */
 function GetPermissionId(target) {
     if (target instanceof component_1.ComponentTarget) {
-        const rootPermissionId = exports.permissionMap.get(target.root);
+        const rootPermissionId = registry_1.permissionMap.get(target.root);
         if (!rootPermissionId)
             return undefined;
         return [rootPermissionId, ...target.path].join(".");
     }
-    return exports.permissionMap.get(target);
+    return registry_1.permissionMap.get(target);
 }
-exports.moduleRootCategories = new Map();
-exports.moduleDefaultCategories = new Map();
 //# sourceMappingURL=registry.js.map

package/dist/page/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/page/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/page/registry.ts"],"names":[],"mappings":";;AAiBA,8DAIC;AAED,kDAIC;AAYD,sDAEC;AAMD,oDAEC;AAGD,0CASC;AA5DD,4CAKsB;AAEtB,kDAI6B;AAE7B,8BAAkB,CAAC,GAAG,GAAG,CAAC,SAAoB,EAAE,EAAE,CAAC,wBAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAEhF,gEAAgE;AAChE,SAAgB,yBAAyB,CAAC,SAAoB;IAC5D,OAAO,CAAC,GAAG,+BAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CACjC,IAAY;IAEZ,OAAO,6BAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CAAC,IAAY;IAChD,6BAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO,CAAC,GAAG,+BAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,SAAgB,eAAe,CAC7B,MAA8C;IAE9C,IAAI,MAAM,YAAY,2BAAe,EAAE,CAAC;QACtC,MAAM,gBAAgB,GAAG,wBAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,wBAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/page/roots.d.ts

@@ -11,3 +11,13 @@ export declare const settingsCategory: {
     extend: <T extends import("@antelopejs/interface-api").ControllerClass>(this: T, location: string) => T;
     location: string;
 };
+/**
+ * The settings of the workspace as a whole — members, invitations, roles —
+ * next to the account settings each user keeps for themselves. A project adds
+ * its workspace settings here (`category: workspaceSettingsCategory`) rather
+ * than declaring a `settings.workspace` category of its own. A page declaring
+ * a `module` cannot: registration throws for any page of a module under the
+ * settings root. A module keeps its settings in its own sidebar, or
+ * registers a workspace settings page without `module`.
+ */
+export declare const workspaceSettingsCategory: CategoryInfo;

package/dist/page/roots.js

@@ -1,16 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.settingsCategory = exports.modulesCategory = exports.pagesCategory = void 0;
+exports.workspaceSettingsCategory = exports.settingsCategory = exports.modulesCategory = exports.pagesCategory = void 0;
 exports.RegisterModule = RegisterModule;
 const layouts_1 = require("../base/layouts");
 const categories_1 = require("./categories");
+const categories_2 = require("./internal/categories");
 const controllers_1 = require("./controllers");
-const registry_1 = require("./registry");
+const registry_1 = require("./internal/registry");
 function RegisterModule(opts) {
     if (registry_1.moduleRootCategories.has(opts.id)) {
         throw new Error(`Module "${opts.id}" is already registered.`);
     }
-    const moduleRoot = categories_1.internal.RootCategory(opts.id, {
+    const moduleRoot = (0, categories_2.RootCategory)(opts.id, {
         displayName: opts.title,
         description: opts.description,
         icon: opts.icon,
@@ -21,7 +22,9 @@ function RegisterModule(opts) {
     });
     registry_1.moduleRootCategories.set(opts.id, moduleRoot);
     if (opts.defaultCategory) {
-        const defaultCategory = categories_1.internal.RootCategory("pages", {
+        const defaultCategory = (0, categories_2.RootCategory)("pages", {
+            // Treat an empty string the same as omitted: fall back to the built-in
+            // i18n label rather than rendering a blank heading.
             displayName: opts.defaultCategory.displayName || "$menu.section.pages",
             icon: opts.defaultCategory.icon,
             order: opts.defaultCategory.order,
@@ -34,7 +37,7 @@ function RegisterModule(opts) {
     categories_1.internal.RegisterModule.register(opts);
     return moduleRoot;
 }
-exports.pagesCategory = categories_1.internal.RootCategory("pages", {
+exports.pagesCategory = (0, categories_2.RootCategory)("pages", {
     displayName: "$menu.section.pages",
     urlSlug: "/",
     order: 1,
@@ -56,5 +59,23 @@ exports.settingsCategory = (0, controllers_1.RootPageController)("settings", {
     icon: "i-ph-gear",
     order: 3,
     noComponentPermissions: true,
-}, (0, layouts_1.DefaultLayout)());
+    layout: (0, layouts_1.SettingsLayout)(),
+});
+/**
+ * The settings of the workspace as a whole — members, invitations, roles —
+ * next to the account settings each user keeps for themselves. A project adds
+ * its workspace settings here (`category: workspaceSettingsCategory`) rather
+ * than declaring a `settings.workspace` category of its own. A page declaring
+ * a `module` cannot: registration throws for any page of a module under the
+ * settings root. A module keeps its settings in its own sidebar, or
+ * registers a workspace settings page without `module`.
+ */
+exports.workspaceSettingsCategory = (0, controllers_1.Category)("workspace", {
+    category: exports.settingsCategory,
+    displayName: "$page.settings.shell.workspace",
+    description: "$page.settings.overview.workspace_description",
+    urlSlug: "workspace",
+    icon: "i-ph-buildings",
+    order: 2,
+});
 //# sourceMappingURL=roots.js.map

package/dist/page/roots.js.map

@@ -1 +1 @@
-{"version":3,"file":"roots.js","sourceRoot":"","sources":["../../src/page/roots.ts"],"names":[],"mappings":";;;AAMA,wCAkCC;AAxCD,6CAAgD;AAChD,6CAAwC;AACxC,+CAAmD;AACnD,yCAA2E;AAG3E,SAAgB,cAAc,CAAC,IAAgB;IAC7C,IAAI,+BAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,UAAU,GAAG,qBAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE;QAChD,WAAW,EAAE,IAAI,CAAC,KAAK;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,uBAAe;KAC1B,CAAC,CAAC;IAEH,+BAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE9C,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,MAAM,eAAe,GAAG,qBAAQ,CAAC,YAAY,CAAC,OAAO,EAAE;YAGrD,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,IAAI,qBAAqB;YACtE,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;YAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK;YACjC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,OAAO;YAChD,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;QACH,kCAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,qBAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAEY,QAAA,aAAa,GAAG,qBAAQ,CAAC,YAAY,CAAC,OAAO,EAAE;IAC1D,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,OAAO;CACd,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,IAAA,gCAAkB,EAC/C,SAAS,EACT;IACE,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,YAAY,EAAE,IAAI;CACnB,EACD,IAAA,uBAAa,GAAE,CAChB,CAAC;AAEW,QAAA,gBAAgB,GAAG,IAAA,gCAAkB,EAChD,UAAU,EACV;IACE,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;CAC7B,EACD,IAAA,uBAAa,GAAE,CAChB,CAAC"}
+{"version":3,"file":"roots.js","sourceRoot":"","sources":["../../src/page/roots.ts"],"names":[],"mappings":";;;AAUA,wCAkCC;AA5CD,6CAAgE;AAChE,6CAAwC;AACxC,sDAAqD;AACrD,+CAA6D;AAC7D,kDAG6B;AAG7B,SAAgB,cAAc,CAAC,IAAgB;IAC7C,IAAI,+BAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,yBAAY,EAAC,IAAI,CAAC,EAAE,EAAE;QACvC,WAAW,EAAE,IAAI,CAAC,KAAK;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,uBAAe;KAC1B,CAAC,CAAC;IAEH,+BAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE9C,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,MAAM,eAAe,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE;YAC5C,uEAAuE;YACvE,oDAAoD;YACpD,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,IAAI,qBAAqB;YACtE,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;YAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK;YACjC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,OAAO;YAChD,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;QACH,kCAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,qBAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAEY,QAAA,aAAa,GAAG,IAAA,yBAAY,EAAC,OAAO,EAAE;IACjD,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,OAAO;CACd,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,IAAA,gCAAkB,EAC/C,SAAS,EACT;IACE,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,YAAY,EAAE,IAAI;CACnB,EACD,IAAA,uBAAa,GAAE,CAChB,CAAC;AAEW,QAAA,gBAAgB,GAAG,IAAA,gCAAkB,EAAC,UAAU,EAAE;IAC7D,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,MAAM,EAAE,IAAA,wBAAc,GAAE;CACzB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACU,QAAA,yBAAyB,GAAG,IAAA,sBAAQ,EAAC,WAAW,EAAE;IAC7D,QAAQ,EAAE,wBAAgB;IAC1B,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,+CAA+C;IAC5D,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,CAAC;CACT,CAAC,CAAC"}

package/dist/page/types.d.ts

@@ -3,33 +3,113 @@ import type { User } from "../auth/db";
 import type { Action, Component, ComponentInfo, ComponentInfoSerialized, PlacementSide } from "../component";
 import type { RoleModel, TenantMemberModel } from "../db";
 import type { Permission } from "../permissions";
+import type { Tone } from "../base/types/tone";
 import type { MaybePromise } from "../types";
 export type { MaybePromise };
 export type MenuItemType = "label" | "link";
+/**
+ * Semantic look of a menu entry. `accent` renders the entry in the theme's
+ * primary color, for call-to-action entries such as "New project".
+ */
 export type MenuItemVariant = "default" | "accent";
+/**
+ * Semantic state dot rendered at the end of a menu entry. Maps to the theme's
+ * semantic colors, so a consumer never ships raw classes.
+ */
 export type MenuItemStatus = "success" | "warning" | "error" | "neutral";
+/** Query parameters appended to a menu entry's link. */
 export type MenuItemQuery = Record<string, string>;
+/** Values for the `:name` segments of the page slug a menu entry links to. */
 export type MenuItemParams = Record<string, string>;
+/** Cleanup callback returned by a PageSetupFunction. Called on page unmount. */
 export type PageSetupCleanup = () => void;
+/**
+ * Context passed to a PageSetupFunction. Use on(component, event, handler)
+ * to subscribe (returns an unsubscribe). Use emit(component, event, data) to
+ * dispatch on the shared window event bus.
+ */
 export interface PageSetupContext {
     pageInfo: PageInfo;
     permissions: Set<string>;
     on(component: string, event: string, handler: (data: unknown) => void): () => void;
     emit(component: string, event: string, data?: unknown): void;
 }
+/**
+ * Page-level setup function referenced by MenuOptions.setupId. Registered on
+ * the frontend via useDefinedFunctions().registerFunction(). Runs in
+ * onMounted; cleanup runs on onUnmounted.
+ *
+ * Returns `void` rather than `undefined`, which lets callers omit a return
+ * statement entirely.
+ */
 export type PageSetupFunction = (context: PageSetupContext) => MaybePromise<PageSetupCleanup | void>;
 export interface PageValidation {
     requiredQueryParams?: string[];
     customFunctionId?: string;
 }
 export declare const MODULE_URL_PREFIX = "/modules";
-export declare const ROOT_SLUG = "/";
+/**
+ * State a module reports on the modules catalog, rendered as a pill on its
+ * tile: `live` (working normally, the default), `beta` (usable, still
+ * changing), `update` (a newer version is available) or `attention`
+ * (something needs a platform owner, such as a failing job).
+ */
+export type ModuleStatus = "live" | "beta" | "update" | "attention";
+/**
+ * Tone of one readout line: `success` (healthy figure), `info` (neutral
+ * fact), `warning` (worth a look) or `error` (something is failing). The
+ * former `ok` is still read as `success` in 0.4, with a warning.
+ */
+export type ModuleReadoutTone = Extract<Tone, "success" | "info" | "warning" | "error">;
+/**
+ * One short line of a module's live readout on the catalog
+ * (`42 tables · 1.9 GB`). `text` may be an i18n key prefixed with `$`.
+ */
+export interface ModuleReadoutLine {
+    text: string;
+    tone?: ModuleReadoutTone;
+}
+/**
+ * Request the catalog hooks of a module run for. The catalog is owner-only,
+ * so `user` is a platform owner; `tenantId` is the tenant the request is
+ * scoped to.
+ */
+export interface ModuleCatalogContext {
+    user: User | undefined;
+    tenantId: string;
+}
 export interface ModuleInfo {
     id: string;
     title: string;
     description: string;
     icon: string;
     landingPage?: string;
+    /** Version shown on the catalog tile (`1.4.0`). */
+    version?: string;
+    /**
+     * Catalog category the module is filed under (`Content`, `Developer`…).
+     * May be an i18n key prefixed with `$`. Modules without one are grouped
+     * under a generic "Other" category.
+     */
+    catalogCategory?: string;
+    /**
+     * Reports the module's current state on the catalog. Called on each catalog
+     * load; a hook that throws or does not answer in time is ignored and the
+     * module shows as `live`.
+     */
+    status?: (context: ModuleCatalogContext) => MaybePromise<ModuleStatus>;
+    /**
+     * Returns a few short lines (two read best) saying what the module is doing
+     * right now. Called on each catalog load; a hook that throws or does not
+     * answer in time is ignored and the tile shows no readout.
+     */
+    readout?: (context: ModuleCatalogContext) => MaybePromise<ModuleReadoutLine[]>;
+    /**
+     * Optional category that groups the module's "loose" pages (pages declared
+     * with `module` but no explicit `category`) under a real, controllable
+     * heading instead of the default "Pages" label. When omitted, loose pages
+     * fall back to the generic "Pages" grouping.
+     */
     defaultCategory?: {
         displayName?: string;
         icon?: string;
@@ -49,13 +129,57 @@ export interface MenuOptions {
     permission?: Partial<Permission> | Action;
     publicAccess?: boolean;
     authOnly?: boolean;
+    /**
+     * Every signed-in member of the tenant reaches the entry, its components and
+     * their actions without a role grant: their permissions are registered as
+     * `defaultGranted`, so they never wait on a role and the role editor does not
+     * list them. Guards, menus and table views keep checking them as usual — only
+     * the grant is implied. Unlike `authOnly`, the tenant access gate still
+     * applies and the permission ids still exist.
+     *
+     * Inherited by the pages of a flagged category. Meant for personal surfaces
+     * every member owns: their profile, security, notifications and preferences.
+     */
+    memberAccess?: boolean;
     type?: MenuItemType;
     validation?: PageValidation;
     setupId?: string;
     noComponentPermissions?: boolean;
+    /**
+     * Query parameters carried by the entry's menu link, so a single page with
+     * `validation.requiredQueryParams` can serve many entries
+     * (e.g. `/project?project=<id>`).
+     */
     query?: MenuItemQuery;
     variant?: MenuItemVariant;
     status?: MenuItemStatus;
+    /**
+     * Short count or label rendered at the end of the menu entry (`3`, `new`).
+     * Takes the trailing slot, so a leaf entry shows either a badge or a
+     * status dot — the badge wins.
+     */
+    badge?: string;
+    /**
+     * Default layout of the entry and of every page and sub-category declared
+     * under it that sets none of its own (`Category("billing", { category,
+     * layout: SettingsLayout() })`). The nearest declaring ancestor wins; a
+     * page's own layout argument always overrides it, and a page with neither
+     * gets `DefaultLayout()`.
+     */
+    layout?: ComponentInfo;
+    /**
+     * Keep the page reachable while a tenant access gate denies the tenant, the
+     * page-level mirror of the `bypassTenantAccessGate` guard option. Covers page
+     * visibility, menu visibility and the page's own layout route. Permission
+     * checks still apply normally — unlike `authOnly`, which drops them entirely.
+     *
+     * Inherited by the pages of a flagged category. The data routes feeding the
+     * page are not covered: a data API is not owned by a single page, so it opts
+     * out explicitly through its own guard's `bypassTenantAccessGate` option.
+     *
+     * Reserved for recovery surfaces (billing, payment portal) a blocked tenant
+     * must still reach.
+     */
     bypassTenantAccessGate?: boolean;
 }
 export interface CategoryInfo extends Omit<MenuOptions, "category"> {
@@ -64,15 +188,45 @@ export interface CategoryInfo extends Omit<MenuOptions, "category"> {
     fullSlug: string;
     category: CategoryInfo | ControllerClass | undefined;
     isModuleRoot?: boolean;
+    /**
+     * Whether the category adds no segment of its own to the URL, because its
+     * `fullSlug` is its parent's — what `urlSlug: "/"` produces. Such a category
+     * is a section heading, not a route: it cannot be addressed on its own, and
+     * any number of them may sit under one parent.
+     *
+     * Derived at declaration time, never declared: `MenuOptions` has no matching
+     * field, and passing one would be ignored.
+     */
     urlTransparent?: boolean;
 }
 export interface PageInfo extends CategoryInfo {
     layoutUrl: string;
 }
+/**
+ * A menu entry produced by a dynamic menu provider. It is not a page: it links
+ * to an already registered page (`fullSlug`), optionally narrowed by `params`
+ * and `query`, so one page can back any number of entries.
+ */
 export interface DynamicMenuItem {
+    /**
+     * Unique within the provider's category; becomes the entry's `fullId` suffix.
+     * Dots separate the levels of a `fullId`, so an id may not contain one — an
+     * entry that does is skipped with a warning.
+     */
     id: string;
     displayName: string;
+    /**
+     * Full slug of the registered page the entry links to. The entry is listed
+     * only when the caller can access that page, so an entry never offers a link
+     * its target would refuse.
+     */
     fullSlug: string;
+    /**
+     * Values for the `:name` segments of `fullSlug`, URL-encoded into the entry's
+     * link. They must fill every segment and nothing else: an entry that leaves a
+     * segment unfilled, or names a parameter the slug does not have, is skipped
+     * with a warning.
+     */
     params?: MenuItemParams;
     query?: MenuItemQuery;
     description?: string;
@@ -80,13 +234,39 @@ export interface DynamicMenuItem {
     order?: number;
     variant?: MenuItemVariant;
     status?: MenuItemStatus;
+    /** Short count or label rendered at the end of the entry (`3`, `new`). */
+    badge?: string;
+    /**
+     * Permission required to see the entry, as a raw id — unlike `MenuOptions`,
+     * which takes a whole permission or an `Action`. Unset means always visible.
+     *
+     * It is matched against the permission set the caller's browser actually
+     * receives, the way the browser matches it — the wildcard or a literal grant,
+     * never a `defaultGranted` fallback — so the sidebar never offers an entry
+     * whose controls would be inert. While a tenant access gate denies the
+     * tenant, that set only holds the surfaces flagged `bypassTenantAccessGate`,
+     * so a recovery entry declares its permission under its target page, as in
+     * `<recoveryPageFullId>.settle`.
+     */
     permissionId?: string;
 }
+/**
+ * Resolves the dynamic entries of a category for one request. `permissions` is
+ * the caller's effective permission set as the parent category sees it: empty
+ * when a tenant access gate denies the tenant, unless the category is flagged
+ * `bypassTenantAccessGate`, in which case the real permissions are kept.
+ * `user` is undefined for an unauthenticated request.
+ */
 export type DynamicMenuResolver = (user: User | undefined, tenantId: string, permissions: Set<string>) => MaybePromise<DynamicMenuItem[]>;
 export interface DynamicMenuProviderInfo {
     categoryFullId: string;
     resolver: DynamicMenuResolver;
 }
+/**
+ * One component a page extension contributes to its target page. `key` is the
+ * static field name it was declared under, and also the last segment of its
+ * permission id on the target page.
+ */
 export interface PageExtensionComponent {
     key: string;
     component: Component;
@@ -94,6 +274,11 @@ export interface PageExtensionComponent {
     anchorPath?: readonly string[];
     order: number;
 }
+/**
+ * Everything one `@RegisterPageExtension` class contributes to one target page.
+ * The object itself is the registration handle: it is what gets unregistered
+ * when the extending module stops.
+ */
 export interface PageExtensionInfo {
     extensionName: string;
     targetFullId: string;

package/dist/page/types.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROOT_SLUG = exports.MODULE_URL_PREFIX = void 0;
+exports.MODULE_URL_PREFIX = void 0;
 exports.MODULE_URL_PREFIX = "/modules";
-exports.ROOT_SLUG = "/";
 //# sourceMappingURL=types.js.map

package/dist/page/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/page/types.ts"],"names":[],"mappings":";;;AAuEa,QAAA,iBAAiB,GAAG,UAAU,CAAC;AAE/B,QAAA,SAAS,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/page/types.ts"],"names":[],"mappings":";;;AAwEa,QAAA,iBAAiB,GAAG,UAAU,CAAC"}

package/dist/page.d.ts

@@ -1,7 +1,29 @@
+/**
+ * Public entry of the page system, split by concern under `./page/`:
+ *
+ * - `types` — the shared vocabulary (menu options, page/category infos,
+ *   dynamic menu and extension contracts)
+ * - `registry` — the page layout and permission id lookups
+ * - `layout-filter` — permission filtering of a serialized layout
+ * - `categories` — the `internal` registration proxies and the module
+ *   membership check
+ * - `metadata` — `PageMetadata`, the registration/teardown lifecycle of one
+ *   page
+ * - `controllers` — the consumer-facing decorators and constructors
+ * - `roots` — the built-in root categories and module registration
+ *
+ * The plumbing behind them lives under `./page/internal/` and is not
+ * re-exported here: the module-wide registries every piece writes to
+ * (`registry`), category resolution and creation (`categories`), the
+ * deterministic ordering and grafting of page extensions into a layout
+ * (`extension-assembly`), extension validation, component targets and trees,
+ * form page route claims and the registration identities.
+ */
 export { internal, isInsideModule } from "./page/categories";
 export { AddFrontendModule, type AddFrontendModuleOptions, Category, type FrontendModuleMetadata, type FrontendModuleOptions, type FrontendModuleValue, type FrontendRendererMetadata, GetFrontendModules, NotifyMenuChanged, PageController, RegisterDynamicMenuProvider, RegisterPage, RegisterPageExtension, RootCategory, RootPageController, } from "./page/controllers";
+export { PageDeclarationConflictError } from "./page/declaration-conflict";
 export { FormPageRouteConflictError } from "./page/form-page-routes";
 export { PageMetadata } from "./page/metadata";
-export { ClearPageLayoutBySlug, GetComponentPermissionIds, GetPageLayoutBySlug, GetPendingPageExtensions, GetPermissionId, GetRegisteredPageIds, type PendingPageExtension, } from "./page/registry";
+export { ClearPageLayoutBySlug, GetComponentPermissionIds, GetPageLayoutBySlug, GetPermissionId, GetRegisteredPageIds, } from "./page/registry";
 export * from "./page/roots";
 export * from "./page/types";