@antelopejs/interface-dms 0.0.1

package/dist/notifications/index.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationSubject = exports.CollaborationSubject = exports.AccountSubject = exports.SecuritySubject = exports.GeneralSubject = exports.SystemCategory = exports.internal = void 0;
+exports.Notification = Notification;
+exports.NotificationCategory = NotificationCategory;
+exports.NotificationSubject = NotificationSubject;
+const builder_1 = require("./builder");
+const internal_1 = require("./internal");
+Object.defineProperty(exports, "internal", { enumerable: true, get: function () { return internal_1.internal; } });
+function Notification() {
+    return new builder_1.NotificationBuilder();
+}
+function NotificationCategory(id, category) {
+    const notificationCategory = {
+        id,
+        ...category,
+    };
+    internal_1.internal.RegisterNotificationCategory.register(notificationCategory);
+    return notificationCategory;
+}
+function NotificationSubject(id, subject) {
+    const notificationSubject = {
+        id,
+        ...subject,
+    };
+    internal_1.internal.RegisterNotificationSubject.register(notificationSubject);
+    return notificationSubject;
+}
+exports.SystemCategory = NotificationCategory("system", {
+    labelKey: "dms.notifications.categories.system",
+    descriptionKey: "dms.notifications.categories.system_desc",
+    icon: "i-ph-gear",
+    togglePermission: "default",
+});
+exports.GeneralSubject = NotificationSubject("general", {
+    category: exports.SystemCategory,
+    labelKey: "dms.notifications.subjects.general",
+    togglePermission: "forbidden",
+});
+exports.SecuritySubject = NotificationSubject("security", {
+    category: exports.SystemCategory,
+    labelKey: "dms.notifications.subjects.security",
+    descriptionKey: "dms.notifications.subjects.security_desc",
+    togglePermission: "default",
+});
+exports.AccountSubject = NotificationSubject("account", {
+    category: exports.SystemCategory,
+    labelKey: "dms.notifications.subjects.account",
+    descriptionKey: "dms.notifications.subjects.account_desc",
+    togglePermission: "default",
+});
+exports.CollaborationSubject = NotificationSubject("collaboration", {
+    category: exports.SystemCategory,
+    labelKey: "dms.notifications.subjects.collaboration",
+    descriptionKey: "dms.notifications.subjects.collaboration_desc",
+    togglePermission: "default",
+});
+exports.AutomationSubject = NotificationSubject("automation", {
+    category: exports.SystemCategory,
+    labelKey: "dms.notifications.subjects.automation",
+    descriptionKey: "dms.notifications.subjects.automation_desc",
+    togglePermission: "default",
+});
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";;;AASA,oCAEC;AAED,oDAUC;AAED,kDAUC;AAnCD,uCAAgD;AAChD,yCAAsC;AAE7B,yFAFA,mBAAQ,OAEA;AAMjB,SAAgB,YAAY;IAC1B,OAAO,IAAI,6BAAmB,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,oBAAoB,CAClC,EAAU,EACV,QAA8C;IAE9C,MAAM,oBAAoB,GAA6B;QACrD,EAAE;QACF,GAAG,QAAQ;KACZ,CAAC;IACF,mBAAQ,CAAC,4BAA4B,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACrE,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,mBAAmB,CACjC,EAAU,EACV,OAA4C;IAE5C,MAAM,mBAAmB,GAA4B;QACnD,EAAE;QACF,GAAG,OAAO;KACX,CAAC;IACF,mBAAQ,CAAC,2BAA2B,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACnE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAEY,QAAA,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE;IAC3D,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,IAAI,EAAE,WAAW;IACjB,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,gBAAgB,EAAE,WAAW;CAC9B,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,mBAAmB,CAAC,UAAU,EAAE;IAC7D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE;IAC3D,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,oCAAoC;IAC9C,cAAc,EAAE,yCAAyC;IACzD,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,mBAAmB,CAAC,eAAe,EAAE;IACvE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,0CAA0C;IACpD,cAAc,EAAE,+CAA+C;IAC/D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAAG,mBAAmB,CAAC,YAAY,EAAE;IACjE,QAAQ,EAAE,sBAAc;IACxB,QAAQ,EAAE,uCAAuC;IACjD,cAAc,EAAE,4CAA4C;IAC5D,gBAAgB,EAAE,SAAS;CAC5B,CAAC,CAAC"}

package/dist/notifications/internal.d.ts

@@ -0,0 +1,11 @@
+import { RegisteringProxy } from "@antelopejs/interface-core";
+import type { NotificationCategoryInfo, NotificationData, NotificationSubjectInfo, ReadScope } from "./types";
+export declare namespace internal {
+    const SupportsIdempotency: () => Promise<boolean>;
+    const RegisterNotificationCategory: RegisteringProxy<(info: NotificationCategoryInfo) => void>;
+    const RegisterNotificationSubject: RegisteringProxy<(info: NotificationSubjectInfo) => void>;
+    const SendToUser: (userId: string, data: NotificationData, groupId?: string | undefined, idempotencyKey?: string | undefined) => Promise<void>;
+    const SendToUsers: (userIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
+    const SendToRoles: (roleIds: string[], data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
+    const SendToAll: (data: NotificationData, readScope?: ReadScope | undefined, idempotencyKey?: string | undefined) => Promise<void>;
+}

package/dist/notifications/internal.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = void 0;
+const interface_core_1 = require("@antelopejs/interface-core");
+var internal;
+(function (internal) {
+    internal.SupportsIdempotency = (0, interface_core_1.InterfaceFunction)();
+    internal.RegisterNotificationCategory = new interface_core_1.RegisteringProxy();
+    internal.RegisterNotificationSubject = new interface_core_1.RegisteringProxy();
+    internal.SendToUser = (0, interface_core_1.InterfaceFunction)();
+    internal.SendToUsers = (0, interface_core_1.InterfaceFunction)();
+    internal.SendToRoles = (0, interface_core_1.InterfaceFunction)();
+    internal.SendToAll = (0, interface_core_1.InterfaceFunction)();
+})(internal || (exports.internal = internal = {}));
+//# sourceMappingURL=internal.js.map

package/dist/notifications/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/notifications/internal.ts"],"names":[],"mappings":";;;AAAA,+DAGoC;AAepC,IAAiB,QAAQ,CAiDxB;AAjDD,WAAiB,QAAQ;IACV,4BAAmB,GAC9B,IAAA,kCAAiB,GAA0B,CAAC;IAEjC,qCAA4B,GAAG,IAAI,iCAAgB,EAE7D,CAAC;IACS,oCAA2B,GAAG,IAAI,iCAAgB,EAE5D,CAAC;IAES,mBAAU,GACrB,IAAA,kCAAiB,GAOd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAOd,CAAC;IAEO,oBAAW,GACtB,IAAA,kCAAiB,GAOd,CAAC;IAEO,kBAAS,GACpB,IAAA,kCAAiB,GAMd,CAAC;AACR,CAAC,EAjDgB,QAAQ,wBAAR,QAAQ,QAiDxB"}

package/dist/notifications/sendable.d.ts

@@ -0,0 +1,11 @@
+import type { NotificationData, SendOptions } from "./types";
+export declare class SendableNotification {
+    private readonly data;
+    constructor(data: NotificationData);
+    toUser(userId: string, options?: SendOptions): Promise<void>;
+    toUsers(userIds: string[], options?: SendOptions): Promise<void>;
+    toUsersIdempotently(userIds: string[], idempotencyKey: string, options?: SendOptions): Promise<void>;
+    toRoles(roleIds: string[], options?: SendOptions): Promise<void>;
+    broadcast(options?: SendOptions): Promise<void>;
+    private requireIdempotencySupport;
+}

package/dist/notifications/sendable.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendableNotification = void 0;
+const internal_1 = require("./internal");
+class SendableNotification {
+    data;
+    constructor(data) {
+        this.data = Object.freeze({ ...data });
+    }
+    async toUser(userId, options = {}) {
+        await this.requireIdempotencySupport(options);
+        await internal_1.internal.SendToUser(userId, this.data, undefined, options.idempotencyKey);
+    }
+    async toUsers(userIds, options = {}) {
+        await this.requireIdempotencySupport(options);
+        await internal_1.internal.SendToUsers(userIds, this.data, options.readScope, options.idempotencyKey);
+    }
+    async toUsersIdempotently(userIds, idempotencyKey, options = {}) {
+        await this.toUsers(userIds, { ...options, idempotencyKey });
+    }
+    async toRoles(roleIds, options = {}) {
+        await this.requireIdempotencySupport(options);
+        await internal_1.internal.SendToRoles(roleIds, this.data, options.readScope, options.idempotencyKey);
+    }
+    async broadcast(options = {}) {
+        await this.requireIdempotencySupport(options);
+        await internal_1.internal.SendToAll(this.data, options.readScope, options.idempotencyKey);
+    }
+    async requireIdempotencySupport(options) {
+        if (options.idempotencyKey === undefined)
+            return;
+        if ((await internal_1.internal.SupportsIdempotency()) !== true) {
+            throw new Error("DMS idempotent notification delivery is unavailable");
+        }
+    }
+}
+exports.SendableNotification = SendableNotification;
+//# sourceMappingURL=sendable.js.map

package/dist/notifications/sendable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendable.js","sourceRoot":"","sources":["../../src/notifications/sendable.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAGtC,MAAa,oBAAoB;IACd,IAAI,CAAmB;IAExC,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAqB,CAAC;IAC7D,CAAC;IAGD,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAuB,EAAE;QACpD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,UAAU,CACvB,MAAM,EACN,IAAI,CAAC,IAAI,EACT,SAAS,EACT,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAGD,KAAK,CAAC,mBAAmB,CACvB,OAAiB,EACjB,cAAsB,EACtB,UAAuB,EAAE;QAEzB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,UAAuB,EAAE;QACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,WAAW,CACxB,OAAO,EACP,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAAuB,EAAE;QACvC,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,mBAAQ,CAAC,SAAS,CACtB,IAAI,CAAC,IAAI,EACT,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,OAAoB;QAC1D,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO;QACjD,IAAI,CAAC,MAAM,mBAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AA9DD,oDA8DC"}

package/dist/notifications/types.d.ts

@@ -0,0 +1,29 @@
+export type TogglePermission = "allowed" | "forbidden" | "default";
+export type ReadScope = "individual" | "shared";
+export interface NotificationCategoryInfo {
+    id: string;
+    labelKey: string;
+    descriptionKey?: string;
+    icon: string;
+    togglePermission?: TogglePermission;
+}
+export interface NotificationSubjectInfo {
+    id: string;
+    category: NotificationCategoryInfo;
+    labelKey: string;
+    descriptionKey?: string;
+    togglePermission?: TogglePermission;
+}
+export interface SendOptions {
+    readScope?: ReadScope;
+    idempotencyKey?: string;
+}
+export interface NotificationData {
+    icon: string;
+    title: string;
+    description: string;
+    subject: NotificationSubjectInfo;
+    linkTo?: string;
+    params?: Record<string, string | number>;
+}
+export type RequiredFields = "icon" | "title" | "description" | "subject";

package/dist/notifications/types.js

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

package/dist/notifications/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":""}

package/dist/page/categories.d.ts

@@ -0,0 +1,39 @@
+import type { ControllerClass } from "@antelopejs/interface-api";
+import { RegisteringProxy } from "@antelopejs/interface-core";
+import { type RegistrationIdentity } from "./registry";
+import { type CategoryInfo, type DynamicMenuProviderInfo, type MenuOptions, type ModuleInfo, type PageExtensionInfo, type PageInfo } from "./types";
+declare class IdentifiedRegisteringProxy<T extends object> extends RegisteringProxy<(value: T) => void> {
+    private readonly identity;
+    constructor(identity: RegistrationIdentity<T>);
+    register(value: T): void;
+    unregister(value: T): void;
+}
+export declare namespace internal {
+    const RegisterCategory: IdentifiedRegisteringProxy<CategoryInfo>;
+    const RegisterPage: IdentifiedRegisteringProxy<PageInfo>;
+    const RegisterModule: IdentifiedRegisteringProxy<ModuleInfo>;
+    const RegisterDynamicMenuProvider: IdentifiedRegisteringProxy<DynamicMenuProviderInfo>;
+    const RegisterPageExtension: IdentifiedRegisteringProxy<PageExtensionInfo>;
+    function clearModuleResolution(id: string): void;
+    function applyPageExtension(info: PageExtensionInfo): void;
+    function revokePageExtension(info: PageExtensionInfo): void;
+    function clearPageMetadata(fullId: string, expected?: PageInfo): void;
+    interface RootCategoryOptions extends Omit<MenuOptions, "category"> {
+        category?: CategoryInfo | ControllerClass;
+        isModuleRoot?: boolean;
+    }
+    function RootCategory(id: string, options: RootCategoryOptions): CategoryInfo;
+}
+interface ModuleEntry {
+    module?: string;
+    category?: CategoryInfo | ControllerClass;
+    isModuleRoot?: boolean;
+}
+export declare function isInsideModule(entry: ModuleEntry): boolean;
+export declare function resolveCategoryInfo(category: CategoryInfo | ControllerClass | undefined): CategoryInfo | undefined;
+export declare function calculateFullSlug(id: string, options: MenuOptions | internal.RootCategoryOptions): string;
+export declare function validateNotInsideSettings(moduleId: string | undefined, resolved: CategoryInfo | undefined): void;
+export declare function createCategoryFunction(id: string, options: internal.RootCategoryOptions): CategoryInfo;
+export declare function createCategoryFunction(id: string, options: MenuOptions): CategoryInfo;
+export declare function applyModuleResolution(id: string, options: MenuOptions): MenuOptions;
+export {};

package/dist/page/categories.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = void 0;
+exports.isInsideModule = isInsideModule;
+exports.resolveCategoryInfo = resolveCategoryInfo;
+exports.calculateFullSlug = calculateFullSlug;
+exports.validateNotInsideSettings = validateNotInsideSettings;
+exports.createCategoryFunction = createCategoryFunction;
+exports.applyModuleResolution = applyModuleResolution;
+const interface_core_1 = require("@antelopejs/interface-core");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const fire_and_forget_1 = require("../utils/fire-and-forget");
+const permissions_1 = require("../permissions");
+const extension_assembly_1 = require("./extension-assembly");
+const metadata_1 = require("./metadata");
+const registry_1 = require("./registry");
+const types_1 = require("./types");
+class IdentifiedRegisteringProxy extends interface_core_1.RegisteringProxy {
+    identity;
+    constructor(identity) {
+        super();
+        this.identity = identity;
+    }
+    register(value) {
+        this.identity.remember(value);
+        super.register(value);
+    }
+    unregister(value) {
+        const registered = this.identity.resolve(value);
+        this.identity.forget(registered);
+        super.unregister(registered);
+    }
+}
+var internal;
+(function (internal) {
+    internal.RegisterCategory = new IdentifiedRegisteringProxy(registry_1.categoryIdentity);
+    internal.RegisterPage = new IdentifiedRegisteringProxy(registry_1.pageIdentity);
+    internal.RegisterModule = new IdentifiedRegisteringProxy(registry_1.moduleIdentity);
+    internal.RegisterDynamicMenuProvider = new IdentifiedRegisteringProxy(registry_1.dynamicMenuProviderIdentity);
+    internal.RegisterPageExtension = new IdentifiedRegisteringProxy(registry_1.pageExtensionIdentity);
+    function clearModuleResolution(id) {
+        registry_1.moduleRootCategories.delete(id);
+        registry_1.moduleDefaultCategories.delete(id);
+    }
+    internal.clearModuleResolution = clearModuleResolution;
+    function applyPageExtension(info) {
+        const registered = registry_1.pageExtensions.get(info.targetFullId) ?? [];
+        (0, extension_assembly_1.assertExtensionKeysAvailable)(info, registered);
+        registered.push(info);
+        registry_1.pageExtensions.set(info.targetFullId, registered);
+        if (!(0, registry_1.acceptsPageExtensions)(info.targetFullId)) {
+            logging_1.Logging.Info(`[dms] page extension "${info.extensionName}" is waiting for page "${info.targetFullId}" to finish registering`);
+        }
+        (0, fire_and_forget_1.fireAndForget)((0, registry_1.syncTargetExtensions)(info.targetFullId), `page extension "${info.extensionName}"`);
+    }
+    internal.applyPageExtension = applyPageExtension;
+    function revokePageExtension(info) {
+        const registered = registry_1.pageExtensions.get(info.targetFullId);
+        if (!registered)
+            return;
+        const remaining = registered.filter((entry) => !registry_1.pageExtensionIdentity.isSame(entry, info));
+        if (remaining.length === 0) {
+            registry_1.pageExtensions.delete(info.targetFullId);
+        }
+        else {
+            registry_1.pageExtensions.set(info.targetFullId, remaining);
+        }
+        (0, fire_and_forget_1.fireAndForget)((0, registry_1.syncTargetExtensions)(info.targetFullId), `page extension "${info.extensionName}" teardown`);
+    }
+    internal.revokePageExtension = revokePageExtension;
+    function clearPageMetadata(fullId, expected) {
+        const metadata = registry_1.pageMetadataByFullId.get(fullId);
+        if (!metadata)
+            return;
+        if (expected && !(0, registry_1.isSamePageRegistration)(metadata.pageInfo, expected))
+            return;
+        metadata.Dispose();
+    }
+    internal.clearPageMetadata = clearPageMetadata;
+    function RootCategory(id, options) {
+        return createCategoryFunction(id, options);
+    }
+    internal.RootCategory = RootCategory;
+})(internal || (exports.internal = internal = {}));
+function isInsideModule(entry) {
+    if (entry.isModuleRoot)
+        return true;
+    if (entry.module)
+        return true;
+    let current = entry.category;
+    while (current) {
+        const resolved = resolveCategoryInfo(current);
+        if (!resolved)
+            return false;
+        if (resolved.isModuleRoot)
+            return true;
+        current = resolved.category;
+    }
+    return false;
+}
+function resolveCategoryInfo(category) {
+    if (!category) {
+        return undefined;
+    }
+    if (typeof category === "function") {
+        const meta = (0, interface_core_1.GetMetadata)(category, metadata_1.PageMetadata);
+        if (!meta.pageInfo) {
+            throw new Error(`PageMetadata not initialized for controller class.`);
+        }
+        return meta.pageInfo;
+    }
+    return category;
+}
+function calculateFullSlug(id, options) {
+    const resolvedCategory = resolveCategoryInfo(options.category);
+    const parentSlug = resolvedCategory?.fullSlug || "";
+    const urlSlug = options.urlSlug || id;
+    let fullSlug = parentSlug ? `${parentSlug}/${urlSlug}` : `/${urlSlug}`;
+    fullSlug = fullSlug.replace(/\/+/g, "/");
+    if (fullSlug !== "/" && fullSlug.endsWith("/")) {
+        fullSlug = fullSlug.slice(0, -1);
+    }
+    return fullSlug;
+}
+function isCategoryDescendantOf(candidate, ancestorFullId) {
+    let current = candidate;
+    while (current) {
+        const resolved = resolveCategoryInfo(current);
+        if (!resolved)
+            return false;
+        if (resolved.fullId === ancestorFullId)
+            return true;
+        current = resolved.category;
+    }
+    return false;
+}
+function resolveCategoryFromOptions(id, options) {
+    if (options.category) {
+        if (options.module) {
+            validateExplicitCategoryMatchesModule(id, options.category, options.module);
+        }
+        return options.category;
+    }
+    if (options.module) {
+        const moduleRoot = registry_1.moduleRootCategories.get(options.module);
+        if (!moduleRoot) {
+            throw new Error(`"${id}" references unknown module "${options.module}". Make sure RegisterModule was called before registration.`);
+        }
+        return registry_1.moduleDefaultCategories.get(options.module) ?? moduleRoot;
+    }
+    return undefined;
+}
+function validateExplicitCategoryMatchesModule(id, category, moduleId) {
+    const moduleRoot = registry_1.moduleRootCategories.get(moduleId);
+    if (!moduleRoot) {
+        throw new Error(`Page "${id}" references unknown module "${moduleId}". Make sure RegisterModule was called before page registration.`);
+    }
+    const resolved = resolveCategoryInfo(category);
+    if (!isCategoryDescendantOf(resolved, moduleRoot.fullId)) {
+        throw new Error(`Page "${id}" declares module "${moduleId}" but its explicit category is not a descendant of that module's root.`);
+    }
+}
+const SETTINGS_ROOT_FULL_ID = "settings";
+function validateNotInsideSettings(moduleId, resolved) {
+    if (!moduleId || !resolved)
+        return;
+    if (isCategoryDescendantOf(resolved, SETTINGS_ROOT_FULL_ID)) {
+        throw new Error(`Pages of module "${moduleId}" cannot use the settings category — declare a settings page inside your module instead.`);
+    }
+}
+function createCategoryFunction(id, options) {
+    const hasModuleField = "module" in options && options.module !== undefined;
+    const effectiveOptions = hasModuleField
+        ? applyModuleResolution(id, options)
+        : options;
+    const category = effectiveOptions.category;
+    const resolvedCategory = resolveCategoryInfo(category);
+    if (hasModuleField) {
+        validateNotInsideSettings(effectiveOptions.module, resolvedCategory);
+    }
+    const parentFullId = resolvedCategory?.fullId || "";
+    const fullId = parentFullId ? `${parentFullId}.${id}` : id;
+    const fullSlug = calculateFullSlug(id, effectiveOptions);
+    const categoryInfo = {
+        ...effectiveOptions,
+        category: resolvedCategory,
+        id,
+        fullId,
+        fullSlug,
+        urlTransparent: fullSlug === (resolvedCategory?.fullSlug || types_1.ROOT_SLUG),
+        hidden: effectiveOptions.hidden || resolvedCategory?.hidden,
+        bypassTenantAccessGate: effectiveOptions.bypassTenantAccessGate ||
+            resolvedCategory?.bypassTenantAccessGate,
+    };
+    internal.RegisterCategory.register(categoryInfo);
+    const categoryPermission = {
+        id: categoryInfo.fullId,
+        title: categoryInfo.displayName,
+        icon: categoryInfo.icon,
+        defaultGranted: categoryInfo.publicAccess,
+        ...categoryInfo.permission,
+    };
+    if (isInsideModule(categoryInfo)) {
+        (0, permissions_1.MarkModuleScopedPermission)(categoryPermission.id);
+    }
+    else {
+        (0, permissions_1.RegisterPermission)(categoryPermission.id, categoryPermission);
+    }
+    return categoryInfo;
+}
+function applyModuleResolution(id, options) {
+    const resolvedReference = resolveCategoryFromOptions(id, options);
+    return { ...options, category: resolvedReference };
+}
+//# sourceMappingURL=categories.js.map

package/dist/page/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/page/categories.ts"],"names":[],"mappings":";;;AA0KA,wCAWC;AAOD,kDAgBC;AAQD,8CAgBC;AAsED,8DAUC;AAUD,wDAkEC;AAED,sDAMC;AAvYD,+DAA2E;AAC3E,gEAA6D;AAC7D,8DAAyD;AACzD,gDAIwB;AACxB,6DAAoE;AAUpE,yCAA0C;AAC1C,yCAcoB;AACpB,mCAQiB;AAYjB,MAAM,0BAA6C,SAAQ,iCAE1D;IAC8B;IAA7B,YAA6B,QAAiC;QAC5D,KAAK,EAAE,CAAC;QADmB,aAAQ,GAAR,QAAQ,CAAyB;IAE9D,CAAC;IAEQ,QAAQ,CAAC,KAAQ;QACxB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEQ,UAAU,CAAC,KAAQ;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;CACF;AAKD,IAAiB,QAAQ,CAqFxB;AArFD,WAAiB,QAAQ;IACV,yBAAgB,GAAG,IAAI,0BAA0B,CAC5D,2BAAgB,CACjB,CAAC;IACW,qBAAY,GAAG,IAAI,0BAA0B,CACxD,uBAAY,CACb,CAAC;IACW,uBAAc,GAAG,IAAI,0BAA0B,CAC1D,yBAAc,CACf,CAAC;IACW,oCAA2B,GACtC,IAAI,0BAA0B,CAC5B,sCAA2B,CAC5B,CAAC;IAES,8BAAqB,GAChC,IAAI,0BAA0B,CAAoB,gCAAqB,CAAC,CAAC;IAE3E,SAAgB,qBAAqB,CAAC,EAAU;QAC9C,+BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChC,kCAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAHe,8BAAqB,wBAGpC,CAAA;IAED,SAAgB,kBAAkB,CAAC,IAAuB;QACxD,MAAM,UAAU,GAAG,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAA,iDAA4B,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,IAAA,gCAAqB,EAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,iBAAO,CAAC,IAAI,CACV,yBAAyB,IAAI,CAAC,aAAa,0BAA0B,IAAI,CAAC,YAAY,yBAAyB,CAChH,CAAC;QACJ,CAAC;QACD,IAAA,+BAAa,EACX,IAAA,+BAAoB,EAAC,IAAI,CAAC,YAAY,CAAC,EACvC,mBAAmB,IAAI,CAAC,aAAa,GAAG,CACzC,CAAC;IACJ,CAAC;IAde,2BAAkB,qBAcjC,CAAA;IAED,SAAgB,mBAAmB,CAAC,IAAuB;QACzD,MAAM,UAAU,GAAG,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU;YAAE,OAAO;QAGxB,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gCAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CACtD,CAAC;QACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,yBAAc,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;QACD,IAAA,+BAAa,EACX,IAAA,+BAAoB,EAAC,IAAI,CAAC,YAAY,CAAC,EACvC,mBAAmB,IAAI,CAAC,aAAa,YAAY,CAClD,CAAC;IACJ,CAAC;IAjBe,4BAAmB,sBAiBlC,CAAA;IAUD,SAAgB,iBAAiB,CAAC,MAAc,EAAE,QAAmB;QACnE,MAAM,QAAQ,GAAG,+BAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,QAAQ,IAAI,CAAC,IAAA,iCAAsB,EAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAClE,OAAO;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;IANe,0BAAiB,oBAMhC,CAAA;IAOD,SAAgB,YAAY,CAC1B,EAAU,EACV,OAA4B;QAE5B,OAAO,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IALe,qBAAY,eAK3B,CAAA;AACH,CAAC,EArFgB,QAAQ,wBAAR,QAAQ,QAqFxB;AAQD,SAAgB,cAAc,CAAC,KAAkB;IAC/C,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,GAA+C,KAAK,CAAC,QAAQ,CAAC;IACzE,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,QAAQ,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,SAAgB,mBAAmB,CACjC,QAAoD;IAEpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAA,4BAAW,EAAC,QAAQ,EAAE,uBAAY,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,SAAgB,iBAAiB,CAC/B,EAAU,EACV,OAAmD;IAEnD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,gBAAgB,EAAE,QAAQ,IAAI,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IACvE,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzC,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAAmC,EACnC,cAAsB;IAEtB,IAAI,OAAO,GAA+C,SAAS,CAAC;IACpE,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,cAAc;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CACjC,EAAU,EACV,OAAoB;IAEpB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,qCAAqC,CACnC,EAAE,EACF,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,MAAM,CACf,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,+BAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,IAAI,EAAE,gCAAgC,OAAO,CAAC,MAAM,6DAA6D,CAClH,CAAC;QACJ,CAAC;QAID,OAAO,kCAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qCAAqC,CAC5C,EAAU,EACV,QAAwC,EACxC,QAAgB;IAEhB,MAAM,UAAU,GAAG,+BAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,SAAS,EAAE,gCAAgC,QAAQ,kEAAkE,CACtH,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,SAAS,EAAE,sBAAsB,QAAQ,wEAAwE,CAClH,CAAC;IACJ,CAAC;AACH,CAAC;AAMD,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,SAAgB,yBAAyB,CACvC,QAA4B,EAC5B,QAAkC;IAElC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;QAAE,OAAO;IACnC,IAAI,sBAAsB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,oBAAoB,QAAQ,0FAA0F,CACvH,CAAC;IACJ,CAAC;AACH,CAAC;AAUD,SAAgB,sBAAsB,CACpC,EAAU,EACV,OAAmD;IAEnD,MAAM,cAAc,GAClB,QAAQ,IAAI,OAAO,IAAK,OAAuB,CAAC,MAAM,KAAK,SAAS,CAAC;IACvE,MAAM,gBAAgB,GAAG,cAAc;QACrC,CAAC,CAAC,qBAAqB,CAAC,EAAE,EAAE,OAAsB,CAAC;QACnD,CAAC,CAAC,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC3C,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEvD,IAAI,cAAc,EAAE,CAAC;QACnB,yBAAyB,CACtB,gBAAgC,CAAC,MAAM,EACxC,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,EAAE,MAAM,IAAI,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAiB;QACjC,GAAG,gBAAgB;QACnB,QAAQ,EAAE,gBAAgB;QAC1B,EAAE;QACF,MAAM;QACN,QAAQ;QACR,cAAc,EAAE,QAAQ,KAAK,CAAC,gBAAgB,EAAE,QAAQ,IAAI,iBAAS,CAAC;QACtE,MAAM,EAAE,gBAAgB,CAAC,MAAM,IAAI,gBAAgB,EAAE,MAAM;QAC3D,sBAAsB,EACpB,gBAAgB,CAAC,sBAAsB;YACvC,gBAAgB,EAAE,sBAAsB;KAC3C,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAajD,MAAM,kBAAkB,GAAe;QACrC,EAAE,EAAE,YAAY,CAAC,MAAM;QACvB,KAAK,EAAE,YAAY,CAAC,WAAW;QAC/B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,cAAc,EAAE,YAAY,CAAC,YAAY;QAEzC,GAAG,YAAY,CAAC,UAAU;KAC3B,CAAC;IACF,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,IAAA,wCAA0B,EAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,IAAA,gCAAkB,EAAC,kBAAkB,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAgB,qBAAqB,CACnC,EAAU,EACV,OAAoB;IAEpB,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;AACrD,CAAC"}

package/dist/page/component-target.d.ts

@@ -0,0 +1,11 @@
+import { type BaseComponentChild, type Component, type ComponentTargetInput } from "../component";
+export interface ResolvedComponentTarget {
+    rootKey: string;
+    path: readonly string[];
+    component: Component;
+    parent?: Component;
+}
+export declare function getDeclaredComponentChildren(component: Component): BaseComponentChild[];
+export declare function resolveComponentTarget(target: ComponentTargetInput, roots: Map<string, Component>): ResolvedComponentTarget | undefined;
+export declare function componentDeclaresChild(component: Component, id: string): boolean;
+export declare function componentTargetClientId(target: ResolvedComponentTarget): string;

package/dist/page/component-target.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeclaredComponentChildren = getDeclaredComponentChildren;
+exports.resolveComponentTarget = resolveComponentTarget;
+exports.componentDeclaresChild = componentDeclaresChild;
+exports.componentTargetClientId = componentTargetClientId;
+const component_1 = require("../component");
+function getDeclaredComponentChildren(component) {
+    const info = component.componentInfo;
+    if (!info || typeof info.then === "function")
+        return [];
+    return (info.children ??
+        []);
+}
+function targetParts(target) {
+    return target instanceof component_1.ComponentTarget
+        ? target
+        : new component_1.ComponentTarget(target, []);
+}
+function resolveDescendant(root, path) {
+    let component = root;
+    let parent;
+    for (const id of path) {
+        const child = getDeclaredComponentChildren(component).find((entry) => entry.id === id);
+        if (!child)
+            return undefined;
+        parent = component;
+        component = child.component;
+    }
+    return { component, parent };
+}
+function resolveComponentTarget(target, roots) {
+    const { root, path } = targetParts(target);
+    const rootEntry = [...roots].find(([, component]) => component === root);
+    if (!rootEntry)
+        return undefined;
+    const descendant = resolveDescendant(root, path);
+    if (!descendant)
+        return undefined;
+    return { rootKey: rootEntry[0], path, ...descendant };
+}
+function componentDeclaresChild(component, id) {
+    return getDeclaredComponentChildren(component).some((child) => child.id === id);
+}
+function componentTargetClientId(target) {
+    return [target.rootKey, ...target.path.map((id) => `child-${id}`)].join("-");
+}
+//# sourceMappingURL=component-target.js.map

package/dist/page/component-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-target.js","sourceRoot":"","sources":["../../src/page/component-target.ts"],"names":[],"mappings":";;AAiBA,oEASC;AA+BD,wDAUC;AAGD,wDAOC;AAGD,0DAIC;AApFD,4CAMsB;AAWtB,SAAgB,4BAA4B,CAC1C,SAAoB;IAEpB,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,OAAQ,IAAyB,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,CAAC;IAC9E,OAAO,CACJ,IAA8D,CAAC,QAAQ;QACxE,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAA4B;IAC/C,OAAO,MAAM,YAAY,2BAAe;QACtC,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,IAAI,2BAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAOD,SAAS,iBAAiB,CACxB,IAAe,EACf,IAAuB;IAEvB,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,MAA6B,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC,IAAI,CACxD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAC3B,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,MAAM,GAAG,SAAS,CAAC;QACnB,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAGD,SAAgB,sBAAsB,CACpC,MAA4B,EAC5B,KAA6B;IAE7B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;AACxD,CAAC;AAGD,SAAgB,sBAAsB,CACpC,SAAoB,EACpB,EAAU;IAEV,OAAO,4BAA4B,CAAC,SAAS,CAAC,CAAC,IAAI,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAC3B,CAAC;AACJ,CAAC;AAGD,SAAgB,uBAAuB,CACrC,MAA+B;IAE/B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC"}

package/dist/page/component-tree.d.ts

@@ -0,0 +1,9 @@
+import type { Component } from "../component";
+export type ComponentAccess = "own" | "withheld";
+export interface ComponentTreeNode {
+    component: Component;
+    permissionId: string;
+    depth: number;
+    access: ComponentAccess;
+}
+export declare function collectComponentTree(root: Component, rootPermissionId: string): ComponentTreeNode[];

package/dist/page/component-tree.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectComponentTree = collectComponentTree;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const component_target_1 = require("./component-target");
+function childAccess(parent, childId) {
+    if (parent.actions[childId])
+        return "withheld";
+    return "own";
+}
+function collectComponentTree(root, rootPermissionId) {
+    const nodes = [];
+    const ancestors = new Set();
+    const walk = (node) => {
+        if (ancestors.has(node.component)) {
+            logging_1.Logging.Warn(`[dms] component "${node.permissionId}" nests itself; the cycle is not walked further.`);
+            return;
+        }
+        nodes.push(node);
+        if (node.access === "withheld") {
+            logging_1.Logging.Error(`[dms] "${node.permissionId}" is claimed by both an action and a child of the same name; the child and everything below it is withheld. Rename one of them.`);
+            return;
+        }
+        ancestors.add(node.component);
+        for (const child of (0, component_target_1.getDeclaredComponentChildren)(node.component)) {
+            walk({
+                component: child.component,
+                permissionId: `${node.permissionId}.${child.id}`,
+                depth: node.depth + 1,
+                access: childAccess(node.component, child.id),
+            });
+        }
+        ancestors.delete(node.component);
+    };
+    walk({
+        component: root,
+        permissionId: rootPermissionId,
+        depth: 0,
+        access: "own",
+    });
+    return nodes;
+}
+//# sourceMappingURL=component-tree.js.map

package/dist/page/component-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tree.js","sourceRoot":"","sources":["../../src/page/component-tree.ts"],"names":[],"mappings":";;AA+CA,oDA2CC;AA1FD,gEAA6D;AAE7D,yDAAkE;AAgClE,SAAS,WAAW,CAAC,MAAiB,EAAE,OAAe;IACrD,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAUD,SAAgB,oBAAoB,CAClC,IAAe,EACf,gBAAwB;IAExB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAa,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,IAAuB,EAAQ,EAAE;QAC7C,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,iBAAO,CAAC,IAAI,CACV,oBAAoB,IAAI,CAAC,YAAY,kDAAkD,CACxF,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAGjB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,iBAAO,CAAC,KAAK,CACX,UAAU,IAAI,CAAC,YAAY,iIAAiI,CAC7J,CAAC;YACF,OAAO;QACT,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,IAAA,+CAA4B,EAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC;gBACH,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,EAAE,EAAE;gBAChD,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC;gBACrB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,gBAAgB;QAC9B,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/page/controllers.d.ts

@@ -0,0 +1,47 @@
+import { type ControllerClass } from "@antelopejs/interface-api";
+import { type ComponentInfo } from "../component";
+import type { CategoryInfo, DynamicMenuResolver, MenuOptions } from "./types";
+export declare const RegisterPage: () => import("@antelopejs/interface-core/decorators").ClassDecorator<import("@antelopejs/interface-core/decorators").Class<any, any[]>>;
+export declare const RegisterPageExtension: (target: ControllerClass) => import("@antelopejs/interface-core/decorators").ClassDecorator<import("@antelopejs/interface-core/decorators").Class<any, any[]>>;
+export declare function Category(id: string, options: MenuOptions): CategoryInfo;
+export declare function PageController(id: string, options: MenuOptions, layout?: ComponentInfo): {
+    new (...args: any[]): {};
+    extend: <T extends ControllerClass>(this: T, location: string) => T;
+    location: string;
+};
+export declare function RootPageController(id: string, options: Omit<MenuOptions, "category" | "module"> & {
+    isModuleRoot?: boolean;
+}, layout?: ComponentInfo): {
+    new (...args: any[]): {};
+    extend: <T extends ControllerClass>(this: T, location: string) => T;
+    location: string;
+};
+export declare function RegisterDynamicMenuProvider(categoryFullId: string, resolver: DynamicMenuResolver): () => void;
+export declare const NotifyMenuChanged: (tenantId?: string | undefined) => Promise<void>;
+export declare function RootCategory(id: string, options: Omit<MenuOptions, "category" | "module">): CategoryInfo;
+export interface FrontendRendererMetadata {
+    name: string;
+    version: string;
+}
+export type FrontendModuleValue = string | number | boolean | null | FrontendModuleValue[] | FrontendModuleOptions;
+export interface FrontendModuleOptions {
+    [key: string]: FrontendModuleValue;
+}
+export interface AddFrontendModuleOptions {
+    name: string;
+    sourcePath: string;
+    renderer: FrontendRendererMetadata;
+    options?: FrontendModuleOptions;
+    privateOptions?: FrontendModuleOptions;
+    priority?: number;
+    configKey?: string;
+}
+export declare const AddFrontendModule: (config: AddFrontendModuleOptions) => Promise<void>;
+export interface FrontendModuleMetadata {
+    name: string;
+    sourcePath: string;
+    renderer: FrontendRendererMetadata;
+    priority: number;
+    options: FrontendModuleOptions;
+}
+export declare const GetFrontendModules: () => Promise<FrontendModuleMetadata[]>;