@antelopejs/interface-dms 0.3.5 → 0.4.0

package/dist/page/internal/categories.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCategoryInfo = resolveCategoryInfo;
+exports.resolveInheritedLayout = resolveInheritedLayout;
+exports.calculateFullSlug = calculateFullSlug;
+exports.validateNotInsideSettings = validateNotInsideSettings;
+exports.createCategoryFunction = createCategoryFunction;
+exports.applyModuleResolution = applyModuleResolution;
+exports.clearModuleResolution = clearModuleResolution;
+exports.applyPageExtension = applyPageExtension;
+exports.revokePageExtension = revokePageExtension;
+exports.clearPageMetadata = clearPageMetadata;
+exports.RootCategory = RootCategory;
+const interface_core_1 = require("@antelopejs/interface-core");
+const permissions_1 = require("../../permissions");
+// Categories resolve controller classes through their PageMetadata, and the
+// metadata module registers pages through the proxies declared in
+// ../categories: the cycle stays safe because none of these modules
+// dereferences another while it evaluates — only from inside function bodies.
+// oxlint-disable-next-line import/no-cycle
+const metadata_1 = require("../metadata");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const fire_and_forget_1 = require("../../utils/fire-and-forget");
+const registry_1 = require("./registry");
+const types_1 = require("./types");
+// The proxies and isInsideModule are only read inside function bodies; see
+// the matching import in ../categories.
+// oxlint-disable-next-line import/no-cycle
+const categories_1 = require("../categories");
+/**
+ * Resolve a category to CategoryInfo
+ * @param category A CategoryInfo object or a ControllerClass
+ * @returns The resolved CategoryInfo
+ *
+ * @internal
+ */
+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;
+}
+/**
+ * The default layout a page or category declared under `category` inherits:
+ * the `layout` of the nearest ancestor that declares one.
+ *
+ * @param category The parent the entry is declared under
+ * @returns That layout, or undefined when no ancestor declares one
+ *
+ * @internal
+ */
+function resolveInheritedLayout(category) {
+    let current = findCategoryInfo(category);
+    while (current) {
+        if (current.layout)
+            return current.layout;
+        current = findCategoryInfo(current.category);
+    }
+    return undefined;
+}
+// Unlike resolveCategoryInfo, a parent class that is not a registered page
+// ends the walk instead of throwing: the page declaring it reports that when
+// it registers, not while its layout is being chosen.
+function findCategoryInfo(category) {
+    if (typeof category !== "function")
+        return category;
+    return (0, interface_core_1.GetMetadata)(category, metadata_1.PageMetadata).pageInfo;
+}
+/**
+ * Calculate the full slug for a page or category
+ * @param id The unique identifier
+ * @param options Menu options containing urlSlug and category
+ * @returns The calculated full slug
+ *
+ * @internal
+ */
+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.`);
+        }
+        // Loose pages attach to the module's default category when one is declared,
+        // so they render under a controllable heading instead of the generic
+        // "Pages" group. Otherwise they sit directly under the module root.
+        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.`);
+    }
+}
+// The settings root is compared by its stable fullId, not through the
+// `settingsCategory` object: that object lives in the bootstrap module, which
+// this module underpins — importing it back would make the graph circular for
+// a check that only needs the id.
+const SETTINGS_ROOT_FULL_ID = "settings";
+/** @internal */
+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,
+    };
+    categories_1.internal.RegisterCategory.register(categoryInfo);
+    // Left exactly as it was, and it is wrong: when `permission` is an Action,
+    // the spread copies the action's `id` and `definition` over the category's
+    // own and leaves the permission with no title, so the category registers
+    // under the action's short id while `resolvePagePermissionId` later looks it
+    // up under the full one.
+    //
+    // Not fixed here. registerPagePermission converts through `toPermission()`
+    // and skips registration when it succeeds, but it runs at page-registration
+    // time; a category is built at import time, before `permissionMap` holds the
+    // component, so `toPermission()` returns undefined and the same spread runs
+    // anyway. Making this right means deciding when a category's permission is
+    // resolved, which is a design question and not a lint pass.
+    const categoryPermission = {
+        id: categoryInfo.fullId,
+        title: categoryInfo.displayName,
+        icon: categoryInfo.icon,
+        defaultGranted: categoryInfo.publicAccess || categoryInfo.memberAccess,
+        // oxlint-disable-next-line typescript/no-misused-spread
+        ...categoryInfo.permission,
+    };
+    if ((0, categories_1.isInsideModule)(categoryInfo)) {
+        (0, permissions_1.MarkModuleScopedPermission)(categoryPermission.id);
+    }
+    else {
+        (0, permissions_1.RegisterPermission)(categoryPermission.id, categoryPermission);
+    }
+    return categoryInfo;
+}
+/** @internal */
+function applyModuleResolution(id, options) {
+    const resolvedReference = resolveCategoryFromOptions(id, options);
+    return { ...options, category: resolvedReference };
+}
+/** @internal */
+function clearModuleResolution(id) {
+    registry_1.moduleRootCategories.delete(id);
+    registry_1.moduleDefaultCategories.delete(id);
+}
+/** @internal */
+function applyPageExtension(info) {
+    const registered = registry_1.pageExtensions.get(info.targetFullId) ?? [];
+    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 */
+function revokePageExtension(info) {
+    const registered = registry_1.pageExtensions.get(info.targetFullId);
+    if (!registered)
+        return;
+    // By token: the implementation hands the extension back as a view of
+    // itself, and dropping it by reference would revoke nothing.
+    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`);
+}
+/**
+ * Take down the metadata registered for a page.
+ *
+ * `expected` names the registration being unwound. A hot reload registers
+ * the replacement before the old one unregisters, so without it the departing
+ * page would tear down the live one's metadata, layout handler and
+ * permissions.
+ *
+ * @internal
+ */
+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 */
+function RootCategory(id, options) {
+    return createCategoryFunction(id, options);
+}
+//# sourceMappingURL=categories.js.map

package/dist/page/internal/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../../src/page/internal/categories.ts"],"names":[],"mappings":";;AA6CA,kDAgBC;AAWD,wDASC;AAoBD,8CAgBC;AAuED,8DAUC;AAYD,wDAkEC;AAGD,sDAMC;AAGD,sDAGC;AAGD,gDAaC;AAGD,kDAiBC;AAYD,8CAKC;AASD,oCAKC;AArWD,+DAAyD;AAEzD,mDAI2B;AAC3B,4EAA4E;AAC5E,kEAAkE;AAClE,oEAAoE;AACpE,8EAA8E;AAC9E,2CAA2C;AAC3C,0CAA2C;AAC3C,gEAA6D;AAC7D,iEAA4D;AAC5D,yCASoB;AAOpB,mCAAoC;AACpC,2EAA2E;AAC3E,wCAAwC;AACxC,2CAA2C;AAC3C,8CAAyD;AAEzD;;;;;;GAMG;AACH,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;AAED;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CACpC,QAAoD;IAEpD,IAAI,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC;QAC1C,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,sDAAsD;AACtD,SAAS,gBAAgB,CACvB,QAAoD;IAEpD,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IACpD,OAAO,IAAA,4BAAW,EAAC,QAAQ,EAAE,uBAAY,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,EAAU,EACV,OAA0C;IAE1C,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;QACD,4EAA4E;QAC5E,qEAAqE;QACrE,oEAAoE;QACpE,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;AAED,sEAAsE;AACtE,8EAA8E;AAC9E,8EAA8E;AAC9E,kCAAkC;AAClC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,gBAAgB;AAChB,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;AAYD,SAAgB,sBAAsB,CACpC,EAAU,EACV,OAA0C;IAE1C,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,qBAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,yBAAyB;IACzB,EAAE;IACF,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,4DAA4D;IAC5D,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,IAAI,YAAY,CAAC,YAAY;QACtE,wDAAwD;QACxD,GAAG,YAAY,CAAC,UAAU;KAC3B,CAAC;IACF,IAAI,IAAA,2BAAc,EAAC,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,gBAAgB;AAChB,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;AAED,gBAAgB;AAChB,SAAgB,qBAAqB,CAAC,EAAU;IAC9C,+BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,kCAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,gBAAgB;AAChB,SAAgB,kBAAkB,CAAC,IAAuB;IACxD,MAAM,UAAU,GAAG,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC/D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,IAAA,gCAAqB,EAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,iBAAO,CAAC,IAAI,CACV,yBAAyB,IAAI,CAAC,aAAa,0BAA0B,IAAI,CAAC,YAAY,yBAAyB,CAChH,CAAC;IACJ,CAAC;IACD,IAAA,+BAAa,EACX,IAAA,+BAAoB,EAAC,IAAI,CAAC,YAAY,CAAC,EACvC,mBAAmB,IAAI,CAAC,aAAa,GAAG,CACzC,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,SAAgB,mBAAmB,CAAC,IAAuB;IACzD,MAAM,UAAU,GAAG,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,qEAAqE;IACrE,6DAA6D;IAC7D,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gCAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CACtD,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,yBAAc,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,yBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IACD,IAAA,+BAAa,EACX,IAAA,+BAAoB,EAAC,IAAI,CAAC,YAAY,CAAC,EACvC,mBAAmB,IAAI,CAAC,aAAa,YAAY,CAClD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAAC,MAAc,EAAE,QAAmB;IACnE,MAAM,QAAQ,GAAG,+BAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,QAAQ,IAAI,CAAC,IAAA,iCAAsB,EAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAE,OAAO;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC;AACrB,CAAC;AAQD,gBAAgB;AAChB,SAAgB,YAAY,CAC1B,EAAU,EACV,OAA4B;IAE5B,OAAO,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,37 @@
+import { type BaseComponentChild, type Component, type ComponentTargetInput } from "../../component";
+/**
+ * A component and its resolved position under a page's static root field.
+ *
+ * @internal
+ */
+export interface ResolvedComponentTarget {
+    rootKey: string;
+    path: readonly string[];
+    component: Component;
+    parent?: Component;
+}
+/**
+ * Read children that are available synchronously during page registration.
+ *
+ * @internal
+ */
+export declare function getDeclaredComponentChildren(component: Component): BaseComponentChild[];
+/**
+ * Resolve and validate a target against a page's static root components.
+ *
+ * @internal
+ */
+export declare function resolveComponentTarget(target: ComponentTargetInput, roots: Map<string, Component>): ResolvedComponentTarget | undefined;
+/**
+ * Build the id the recursive frontend component renderer assigns to a child,
+ * from the id it assigned to the child's parent.
+ *
+ * @internal
+ */
+export declare function childComponentClientId(parentClientId: string, childId: string): string;
+/**
+ * Build the id assigned by the recursive frontend component renderer.
+ *
+ * @internal
+ */
+export declare function componentTargetClientId(target: ResolvedComponentTarget): string;

package/dist/page/{component-target.js → internal/component-target.js}

@@ -2,8 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDeclaredComponentChildren = getDeclaredComponentChildren;
 exports.resolveComponentTarget = resolveComponentTarget;
+exports.childComponentClientId = childComponentClientId;
 exports.componentTargetClientId = componentTargetClientId;
-const component_1 = require("../component");
+const component_1 = require("../../component");
+/**
+ * Read children that are available synchronously during page registration.
+ *
+ * @internal
+ */
 function getDeclaredComponentChildren(component) {
     const info = component.componentInfo;
     if (!info || typeof info.then === "function")
@@ -28,6 +34,11 @@ function resolveDescendant(root, path) {
     }
     return { component, parent };
 }
+/**
+ * Resolve and validate a target against a page's static root components.
+ *
+ * @internal
+ */
 function resolveComponentTarget(target, roots) {
     const { root, path } = targetParts(target);
     const rootEntry = [...roots].find(([, component]) => component === root);
@@ -38,7 +49,21 @@ function resolveComponentTarget(target, roots) {
         return undefined;
     return { rootKey: rootEntry[0], path, ...descendant };
 }
+/**
+ * Build the id the recursive frontend component renderer assigns to a child,
+ * from the id it assigned to the child's parent.
+ *
+ * @internal
+ */
+function childComponentClientId(parentClientId, childId) {
+    return `${parentClientId}-child-${childId}`;
+}
+/**
+ * Build the id assigned by the recursive frontend component renderer.
+ *
+ * @internal
+ */
 function componentTargetClientId(target) {
-    return [target.rootKey, ...target.path.map((id) => `child-${id}`)].join("-");
+    return target.path.reduce(childComponentClientId, target.rootKey);
 }
 //# sourceMappingURL=component-target.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-target.js","sourceRoot":"","sources":["../../../src/page/internal/component-target.ts"],"names":[],"mappings":";;AAyBA,oEASC;AAmCD,wDAUC;AAQD,wDAKC;AAOD,0DAIC;AAvGD,+CAMyB;AAczB;;;;GAIG;AACH,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;AAED;;;;GAIG;AACH,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;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,cAAsB,EACtB,OAAe;IAEf,OAAO,GAAG,cAAc,UAAU,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,MAA+B;IAE/B,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { Component } from "../../component";
+import type { ComponentTreeNode } from "../component-tree";
+/**
+ * Flatten a page component and everything it nests, in registration order
+ * (parents before their children), each with the permission id its position
+ * gives it.
+ *
+ * @param root A component the page declares.
+ * @param rootPermissionId `<page fullId>.<component key>`.
+ *
+ * @internal
+ */
+export declare function collectComponentTree(root: Component, rootPermissionId: string): ComponentTreeNode[];

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

@@ -0,0 +1,61 @@
+"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");
+/**
+ * A child's id is its parent's followed by its own — and so is an action's, so
+ * the two share one namespace. A child colliding with an action is withheld
+ * rather than registered: the action's grant would otherwise serve it, and
+ * either registration would take the other's entry down.
+ */
+function childAccess(parent, childId) {
+    if (parent.actions[childId])
+        return "withheld";
+    return "own";
+}
+/**
+ * Flatten a page component and everything it nests, in registration order
+ * (parents before their children), each with the permission id its position
+ * gives it.
+ *
+ * @param root A component the page declares.
+ * @param rootPermissionId `<page fullId>.<component key>`.
+ *
+ * @internal
+ */
+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);
+        // Recorded, so the filter knows to withhold it, but not walked: nothing
+        // below a position that is never served can be reached either.
+        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/internal/component-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tree.js","sourceRoot":"","sources":["../../../src/page/internal/component-tree.ts"],"names":[],"mappings":";;AA0BA,oDA2CC;AArED,gEAA6D;AAE7D,yDAAkE;AAGlE;;;;;GAKG;AACH,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;AAED;;;;;;;;;GASG;AACH,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;QACjB,wEAAwE;QACxE,+DAA+D;QAC/D,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/{extension-assembly.d.ts → internal/extension-assembly.d.ts}

@@ -1,8 +1,11 @@
-import type { ComponentInfoSerialized } from "../component";
-import type { PageExtensionComponent } from "./types";
+import type { ComponentInfoSerialized } from "../../component";
+import type { PageExtensionComponent } from "../types";
+/** @internal */
 export interface PageExtensionEntry extends PageExtensionComponent {
     extensionName: string;
     declarationIndex: number;
+    /** Unset while the component is being processed, or if processing failed. */
     serialized?: ComponentInfoSerialized;
 }
+/** @internal */
 export declare function assembleLayoutComponents(own: Record<string, ComponentInfoSerialized>, entries: PageExtensionEntry[]): Record<string, ComponentInfoSerialized>;

package/dist/page/{extension-assembly.js → internal/extension-assembly.js}

@@ -7,6 +7,13 @@ function compareText(a, b) {
         return 0;
     return a < b ? -1 : 1;
 }
+// Placement is anchor-relative first; the comparator only breaks ties inside a
+// single anchor group (or the appended tail). Every criterion after `order` is
+// intrinsic to the declaration — never the order the modules were started in —
+// so the same set of extensions always assembles the same page. Comparison is
+// codepoint-wise rather than locale-aware for the same reason. `key` closes the
+// total order: keys are unique on a page, a collision being a registration
+// error.
 function compareExtensionEntries(a, b) {
     return (a.order - b.order ||
         compareText(a.extensionName, b.extensionName) ||
@@ -76,6 +83,7 @@ function assembleNestedComponent(component, path, entries) {
     }
     return { ...component, children: assembled };
 }
+/** @internal */
 function assembleLayoutComponents(own, entries) {
     if (entries.length === 0) {
         return { ...own };

package/dist/page/internal/extension-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-assembly.js","sourceRoot":"","sources":["../../../src/page/internal/extension-assembly.ts"],"names":[],"mappings":"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"}

package/dist/page/internal/extension-validation.d.ts

@@ -0,0 +1,24 @@
+import type { ComponentInfoSerialized } from "../../component";
+import type { PageExtensionInfo } from "../types";
+/**
+ * The target page as an extension sees it when the injection applies: its own
+ * serialized components, and every component key already spoken for on the
+ * page — its own fields and the ones earlier extensions injected — mapped to
+ * whoever owns it. A page's keys share one namespace because they share one
+ * permission subtree.
+ *
+ * @internal
+ */
+export interface ExtensionTargetView {
+    own: Record<string, ComponentInfoSerialized>;
+    taken: Map<string, string>;
+}
+/**
+ * Everything wrong with an extension, read against the page it is about to be
+ * grafted onto. Reported rather than thrown: the extending module declared it
+ * against a page id, so nothing could be checked when it was declared, and a
+ * mistake there must cost that extension, not the DMS.
+ *
+ * @internal
+ */
+export declare function collectExtensionErrors(info: PageExtensionInfo, target: ExtensionTargetView): string[];

package/dist/page/{extension-validation.js → internal/extension-validation.js}

@@ -31,6 +31,14 @@ function anchorErrors(info, contribution, own) {
     }
     return [];
 }
+/**
+ * Everything wrong with an extension, read against the page it is about to be
+ * grafted onto. Reported rather than thrown: the extending module declared it
+ * against a page id, so nothing could be checked when it was declared, and a
+ * mistake there must cost that extension, not the DMS.
+ *
+ * @internal
+ */
 function collectExtensionErrors(info, target) {
     const errors = [];
     for (const contribution of info.components) {

package/dist/page/internal/extension-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-validation.js","sourceRoot":"","sources":["../../../src/page/internal/extension-validation.ts"],"names":[],"mappings":";;AAkEA,wDAeC;AAhED,SAAS,UAAU,CACjB,SAA8C;IAE9C,OAAO,SAAS,EAAE,QAAQ,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CACpB,GAA4C,EAC5C,IAAuB;IAEvB,MAAM,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;IACpC,IAAI,OAAO,GAAwC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACtE,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CACnB,IAAuB,EACvB,YAAoC,EACpC,GAA4C;IAE5C,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,mBAAmB,IAAI,CAAC,aAAa,cAAc,YAAY,CAAC,GAAG,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,YAAY,qBAAqB;SACnJ,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO;YACL,mBAAmB,IAAI,CAAC,aAAa,oBAAoB,YAAY,CAAC,GAAG,cAAc,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,YAAY,0EAA0E;SAC/M,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CACpC,IAAuB,EACvB,MAA2B;IAE3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CACT,mBAAmB,IAAI,CAAC,aAAa,cAAc,YAAY,CAAC,GAAG,gBAAgB,IAAI,CAAC,YAAY,uCAAuC,KAAK,sBAAsB,CACvK,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/page/internal/form-page-routes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * One page-mode form sub-page a table view is about to register.
+ *
+ * @internal
+ */
+export interface FormPageRouteClaim {
+    /** Permission id of the table view registering it. */
+    owner: string;
+    /** Page carrying the table view. */
+    pageFullId: string;
+    /** `new`, `edit` or `view`. */
+    kind: string;
+    fullId: string;
+    fullSlug: string;
+}
+/**
+ * Record a form sub-page a table view is about to register, refusing one that
+ * another table view already holds.
+ *
+ * A claim only stands in the way while the page it named is live: the same
+ * table view re-registering after a hot reload re-claims what it held, and a
+ * page that went away releases its id and its slug through its own teardown.
+ *
+ * @internal
+ */
+export declare function claimFormPageRoute(claim: FormPageRouteClaim): void;

package/dist/page/internal/form-page-routes.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimFormPageRoute = claimFormPageRoute;
+const registry_1 = require("./registry");
+const form_page_routes_1 = require("../form-page-routes");
+const claimsByFullId = new Map();
+const claimsBySlug = new Map();
+function conflict(held, claim, what) {
+    throw new form_page_routes_1.FormPageRouteConflictError(`[dms] TableView "${held.owner}" and TableView "${claim.owner}" on page "${claim.pageFullId}" both register their "${claim.kind}" form page ${what}. Give one of them a URL of its own with formContainer.pages.${claim.kind}.urlSlug.`);
+}
+/**
+ * Record a form sub-page a table view is about to register, refusing one that
+ * another table view already holds.
+ *
+ * A claim only stands in the way while the page it named is live: the same
+ * table view re-registering after a hot reload re-claims what it held, and a
+ * page that went away releases its id and its slug through its own teardown.
+ *
+ * @internal
+ */
+function claimFormPageRoute(claim) {
+    const byId = claimsByFullId.get(claim.fullId);
+    if (byId &&
+        byId.owner !== claim.owner &&
+        registry_1.pageMetadataByFullId.has(claim.fullId)) {
+        conflict(byId, claim, `under the id "${claim.fullId}"`);
+    }
+    const bySlug = claimsBySlug.get(claim.fullSlug);
+    if (bySlug &&
+        bySlug.owner !== claim.owner &&
+        registry_1.pageLayoutHandlers.has(claim.fullSlug)) {
+        conflict(bySlug, claim, `at "${claim.fullSlug}"`);
+    }
+    if (byId && byId.fullSlug !== claim.fullSlug) {
+        claimsBySlug.delete(byId.fullSlug);
+    }
+    claimsByFullId.set(claim.fullId, claim);
+    claimsBySlug.set(claim.fullSlug, claim);
+}
+//# sourceMappingURL=form-page-routes.js.map

package/dist/page/internal/form-page-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-page-routes.js","sourceRoot":"","sources":["../../../src/page/internal/form-page-routes.ts"],"names":[],"mappings":";;AA0CA,gDAwBC;AAlED,yCAAsE;AACtE,0DAAiE;AAkBjE,MAAM,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAC;AAC7D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;AAE3D,SAAS,QAAQ,CACf,IAAwB,EACxB,KAAyB,EACzB,IAAY;IAEZ,MAAM,IAAI,6CAA0B,CAClC,oBAAoB,IAAI,CAAC,KAAK,oBAAoB,KAAK,CAAC,KAAK,cAAc,KAAK,CAAC,UAAU,0BAA0B,KAAK,CAAC,IAAI,eAAe,IAAI,gEAAgE,KAAK,CAAC,IAAI,WAAW,CACxO,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,IACE,IAAI;QACJ,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAC1B,+BAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EACtC,CAAC;QACD,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,iBAAiB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,IACE,MAAM;QACN,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAC5B,6BAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EACtC,CAAC;QACD,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7C,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/page/internal/layout-filter.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentInfo, ComponentFilterContext, ComponentInfoSerialized } from "../../component";
+/**
+ * The page layout (the frame around the components) as one caller may see it:
+ * the header buttons whose gate the caller fails are left out — a `permission`
+ * names an action of the page, relative to `pagePermissionId` — and those
+ * whose `availability` refuses the request are disabled with its reason.
+ * `loadPermissions` is only called when a button declares a permission.
+ *
+ * @internal
+ */
+export declare function filterLayoutHeaderActions<T>(layout: ComponentInfo<T> | undefined, loadPermissions: () => Promise<Set<string>>, context: ComponentFilterContext, pagePermissionId: string | undefined): Promise<ComponentInfo<T> | undefined>;
+/**
+ * The layout with, after its own header buttons, those the components of the
+ * page place in the header (`placement: "header"`): served as the components
+ * were, so a button whose permission the caller lacks is already gone, and a
+ * disabled one keeps its reason. The component still runs them: the header
+ * names it.
+ *
+ * @internal
+ */
+export declare function withComponentHeaderButtons<T>(layout: ComponentInfo<T> | undefined, components: Record<string, ComponentInfoSerialized>): ComponentInfo<T> | undefined;