@antelopejs/interface-dms 0.3.5 → 0.4.0

package/dist/page/internal/registry.js

@@ -0,0 +1,225 @@
+"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.isPageExtensionRegistered = isPageExtensionRegistered;
+exports.acceptsPageExtensions = acceptsPageExtensions;
+exports.GetPendingPageExtensions = GetPendingPageExtensions;
+exports.syncTargetExtensions = syncTargetExtensions;
+const interface_core_1 = require("@antelopejs/interface-core");
+const modules_1 = require("@antelopejs/interface-core/modules");
+/** @internal */
+exports.permissionMap = new Map();
+/** @internal */
+exports.pageLayoutHandlers = new Map();
+/** @internal */
+exports.pageMetadataByFullId = new Map();
+/**
+ * A registration crosses the interface boundary when the module implementing
+ * the interface receives it, and the runtime hands that module a per-context
+ * view of the object rather than the object itself. Reference equality does not
+ * survive the round trip, so a registration that comes back from the
+ * implementation is recognised by a token stamped on it instead.
+ */
+const REGISTRATION_TOKEN = Symbol.for("@antelopejs/interface-dms:pageRegistration");
+let nextRegistrationToken = 0;
+/**
+ * Token-based identity for one family of registrations.
+ *
+ * Two things need it. Comparing a registration the implementation handed back
+ * against one held here cannot use `===`, and `RegisteringProxy` keys its own
+ * bookkeeping by object reference — so a caller unregistering with the view it
+ * holds would match nothing and silently leave the registration live. The
+ * token survives the round trip, so it can stand in for the reference in the
+ * first case and lead back to it in the second.
+ *
+ * @internal
+ */
+class RegistrationIdentity {
+    kind;
+    byToken = new Map();
+    constructor(kind) {
+        this.kind = kind;
+    }
+    tokenOf(value) {
+        return value[REGISTRATION_TOKEN];
+    }
+    /** Give a registration a fresh identity, replacing any it already carried. */
+    stamp(value) {
+        Object.defineProperty(value, REGISTRATION_TOKEN, {
+            value: `${this.kind}:${(nextRegistrationToken += 1)}`,
+            configurable: true,
+            enumerable: false,
+            writable: false,
+        });
+    }
+    /**
+     * Record the reference a registration is filed under, stamping it first if
+     * nothing else did. Re-stamping here would orphan the identity an earlier
+     * caller already handed out.
+     */
+    remember(value) {
+        if (this.tokenOf(value) === undefined)
+            this.stamp(value);
+        const token = this.tokenOf(value);
+        if (token === undefined)
+            return;
+        this.byToken.set(token, value);
+    }
+    /**
+     * Drop a registration's reference once it is unregistered.
+     *
+     * Only the registration still holding the token forgets it: a hot reload
+     * files the replacement before the departing one unwinds, and letting the
+     * departing one delete would strand the live reference.
+     */
+    forget(value) {
+        const token = this.tokenOf(value);
+        if (token === undefined)
+            return;
+        if (this.byToken.get(token) !== value)
+            return;
+        this.byToken.delete(token);
+    }
+    /**
+     * Resolve a registration back to the reference it was filed under.
+     *
+     * Returns the argument unchanged when it carries no token or names no live
+     * registration, so an unknown one still reaches the proxy and is refused
+     * there rather than here.
+     */
+    resolve(value) {
+        const token = this.tokenOf(value);
+        if (token === undefined)
+            return value;
+        return this.byToken.get(token) ?? value;
+    }
+    /**
+     * Two absent registrations are not the same registration: the caller asks
+     * whether a known one matches, and "nothing matches nothing" would let a
+     * teardown claim something it never registered.
+     */
+    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;
+/** @internal */
+exports.pageIdentity = new RegistrationIdentity("page");
+/** @internal */
+exports.categoryIdentity = new RegistrationIdentity("category");
+/** @internal */
+exports.moduleIdentity = new RegistrationIdentity("module");
+/** @internal */
+exports.dynamicMenuProviderIdentity = new RegistrationIdentity("dynamic-menu-provider");
+/** @internal */
+exports.pageExtensionIdentity = new RegistrationIdentity("page-extension");
+/**
+ * The execution context of the module that registered each page extension,
+ * keyed by the registered reference.
+ *
+ * The DMS applies an extension from its own context -- it receives it through
+ * its implementation of `RegisterPageExtension`, and re-applies it whenever the
+ * target page registers again. What preparing the extension's components
+ * registers (their permissions, native upload fields, form sub-pages, realtime
+ * topics) would then belong to whichever generation happened to run the sync,
+ * and go away with it rather than with the module that extends the page.
+ */
+const pageExtensionContexts = new WeakMap();
+/**
+ * Remember the context of the module registering `info`. Called from the
+ * registration itself, before the extension crosses into the DMS.
+ *
+ * @internal
+ */
+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 });
+}
+/**
+ * Run `callback` as the module that registered `info`, so everything it
+ * registers is owned by, and released with, that module. Runs in the current
+ * context when the registering module is unknown.
+ *
+ * @internal
+ */
+function runAsPageExtensionOwner(info, callback) {
+    const context = pageExtensionContexts.get(exports.pageExtensionIdentity.resolve(info));
+    return context ? (0, modules_1.RunWithModuleContext)(context, callback) : callback();
+}
+/** @internal */
+function stampPageRegistration(pageInfo) {
+    exports.pageIdentity.stamp(pageInfo);
+}
+/** @internal */
+function isSamePageRegistration(left, right) {
+    return exports.pageIdentity.isSame(left, right);
+}
+/** @internal */
+exports.pageExtensions = new Map();
+/**
+ * Whether `info` is still registered: an extension whose module went away is
+ * revoked before that module's context is invalidated, and must not be
+ * prepared in that context afterwards.
+ *
+ * @internal
+ */
+function isPageExtensionRegistered(info) {
+    const registered = exports.pageExtensions.get(info.targetFullId) ?? [];
+    return registered.some((entry) => exports.pageExtensionIdentity.isSame(entry, info));
+}
+/**
+ * Whether the page is registered *and* done serializing its own components.
+ * Presence in `pageMetadataByFullId` only answers the first half: a page is
+ * published there before it has any component to anchor onto.
+ *
+ * @internal
+ */
+function acceptsPageExtensions(targetFullId) {
+    return exports.pageMetadataByFullId.get(targetFullId)?.AcceptsExtensions() ?? false;
+}
+/**
+ * Extensions whose target page no module has registered. An extension names its
+ * target by id, so a typo — or a module that is simply not deployed — is
+ * indistinguishable from a page that has yet to start; both surface here.
+ *
+ * @internal
+ */
+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;
+}
+/** @internal */
+function syncTargetExtensions(targetFullId) {
+    const metadata = exports.pageMetadataByFullId.get(targetFullId);
+    if (!metadata) {
+        return Promise.resolve();
+    }
+    return metadata.SyncExtensions();
+}
+/** @internal */
+exports.moduleRootCategories = new Map();
+/** @internal */
+exports.moduleDefaultCategories = new Map();
+//# sourceMappingURL=registry.js.map

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

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

package/dist/page/internal/table-view-ids.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentInfoSerialized } from "../../component";
+/**
+ * The page's components, each table view among them told its key in the
+ * page and whether it is the page's only one: a URL addresses a table view's
+ * views and tabs by that key, and by the short `?view=` / `?tab=` only when
+ * it is alone.
+ *
+ * @internal
+ */
+export declare function withTableViewPlacements(components: Record<string, ComponentInfoSerialized>): Record<string, ComponentInfoSerialized>;

package/dist/page/internal/table-view-ids.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTableViewPlacements = withTableViewPlacements;
+const options_1 = require("../../base/table-view/internal/options");
+const isTableView = (component) => component.componentName === options_1.TABLE_VIEW_COMPONENT_NAME;
+function countTableViews(component) {
+    const own = isTableView(component) ? 1 : 0;
+    return (component.children ?? []).reduce((total, child) => total + countTableViews(child.component), own);
+}
+function placeTableViews(component, id, isSoleTableView) {
+    const children = component.children?.map((child) => ({
+        ...child,
+        component: placeTableViews(child.component, child.id, isSoleTableView),
+    }));
+    const placed = children ? { ...component, children } : component;
+    if (!isTableView(component))
+        return placed;
+    const placement = { tableId: id, isSoleTableView };
+    const options = component.options;
+    return { ...placed, options: { ...options, ...placement } };
+}
+/**
+ * The page's components, each table view among them told its key in the
+ * page and whether it is the page's only one: a URL addresses a table view's
+ * views and tabs by that key, and by the short `?view=` / `?tab=` only when
+ * it is alone.
+ *
+ * @internal
+ */
+function withTableViewPlacements(components) {
+    const total = Object.values(components).reduce((count, component) => count + countTableViews(component), 0);
+    if (total === 0)
+        return components;
+    return Object.fromEntries(Object.entries(components).map(([id, component]) => [
+        id,
+        placeTableViews(component, id, total === 1),
+    ]));
+}
+//# sourceMappingURL=table-view-ids.js.map

package/dist/page/internal/table-view-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-view-ids.js","sourceRoot":"","sources":["../../../src/page/internal/table-view-ids.ts"],"names":[],"mappings":";;AA8CA,0DAcC;AA5DD,oEAAmF;AAWnF,MAAM,WAAW,GAAG,CAAC,SAAkC,EAAW,EAAE,CAClE,SAAS,CAAC,aAAa,KAAK,mCAAyB,CAAC;AAExD,SAAS,eAAe,CAAC,SAAkC;IACzD,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,EAC1D,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,SAAkC,EAClC,EAAU,EACV,eAAwB;IAExB,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC;QACpE,GAAG,KAAK;QACR,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC;KACvE,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,MAAM,SAAS,GAAuB,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC;IACvE,MAAM,OAAO,GAAG,SAAS,CAAC,OAA8C,CAAC;IACzE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,UAAmD;IAEnD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAC5C,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,EACxD,CAAC,CACF,CAAC;IACF,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACnC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;QAClD,EAAE;QACF,eAAe,CAAC,SAAS,EAAE,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC;KAC5C,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/page/internal/types.d.ts

@@ -0,0 +1,2 @@
+/** @internal */
+export declare const ROOT_SLUG = "/";

package/dist/page/internal/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/page/internal/types.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AACH,QAAA,SAAS,GAAG,GAAG,CAAC"}

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

@@ -1,4 +1,8 @@
 import type { ComponentFilterContext, ComponentInfoSerialized } from "../component";
 import type { ComponentTreeNode } from "./component-tree";
+/**
+ * Every component of the page, keyed by the permission id of its position —
+ * what the registration established by walking the component tree.
+ */
 export type ComponentNodeMap = Map<string, ComponentTreeNode>;
 export declare function filterComponents(components: Record<string, ComponentInfoSerialized>, basePath: string, permissions: Set<string>, componentMap: ComponentNodeMap, context: ComponentFilterContext): Promise<Record<string, ComponentInfoSerialized>>;

package/dist/page/layout-filter.js

@@ -27,6 +27,17 @@ function filterRequiredPermissionWatches(options, permissions) {
         watchActions: opts.watchActions.filter((w) => !w.requirePermission || permissions.has(w.requirePermission)),
     };
 }
+/**
+ * Whether a child of an already-granted component is served.
+ *
+ * Every child reached during registration has its own permission. A withheld
+ * child shares its id with an action of its parent, so no answer about that id
+ * describes it.
+ *
+ * A child the registration never walked — for example, one hanging off a
+ * promised `ComponentInfo` — has no node here and fails closed even if a stale
+ * role still carries the derived id.
+ */
 function childIsAccessible(permissions, permissionId, node) {
     if (!node || node.access === "withheld")
         return Promise.resolve(false);

package/dist/page/layout-filter.js.map

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

package/dist/page/metadata.d.ts

@@ -8,16 +8,30 @@ export declare class PageMetadata {
     pageInfo?: PageInfo;
     layout?: ComponentInfo;
     components: Record<string, Component>;
+    /**
+     * Tenant guard options the page's layout route was registered with. Recorded
+     * at registration so the page's `bypassTenantAccessGate` can be asserted
+     * without issuing a request.
+     */
     guardOptions?: TenantGuardOptions;
     private layoutRef?;
     private ownComponents;
     private componentMap;
     private nativeUploadFields;
+    /** Exact live positions of a component, including mounts on multiple pages. */
     ComponentPermissionIds(component: Component): string[];
     private componentTrees;
     private notifiedComponents;
     private extensionEntries;
     private extensionSyncQueue;
+    /**
+     * Being in the page registry and being ready to be extended are two facts:
+     * the page is published before its first await, while `ownComponents` is
+     * only filled after it. An extension grafted in between resolves its anchors
+     * against a key set that stops wherever the serialization loop had reached,
+     * so anchors on later fields silently fall to the end of the page. This gate
+     * carries the second fact — extensions wait on it instead of racing it.
+     */
     private ownComponentsReady;
     private ownComponentsGate;
     private releaseOwnComponentsGate;
@@ -32,10 +46,52 @@ export declare class PageMetadata {
     SetComponent(id: string, component: Component): void;
     SetInfo(id: string, fullSlug: string, menuOptions: MenuOptions, pageLayout?: ComponentInfo): void;
     Register(): Promise<void>;
+    /**
+     * Claim everything the page owns that does not depend on its components: the
+     * registry entry, the navigation entry, the page permission and the layout
+     * route.
+     *
+     * Published before the first await of `Register()`. The old order left a
+     * window where the page was in the registry but not in this map: a module
+     * destroyed during it found nothing to clear, and the registration still in
+     * flight then wrote the metadata of a page that no longer serves — which
+     * later extensions would graft themselves onto.
+     */
     private publish;
+    /**
+     * Take down everything this registration created. Idempotent, and safe to
+     * call on a metadata that has already been replaced: each step only undoes
+     * what it still owns.
+     *
+     * @internal
+     */
     Dispose(): void;
+    /**
+     * Bring the page's injected components in line with the extensions currently
+     * registered against it: components of extensions that went away are torn
+     * down, new ones are processed exactly like the page's own components, and
+     * the layout order is rebuilt.
+     *
+     * Runs are serialized, so two modules registering back to back never process
+     * the same extension twice.
+     *
+     * @internal
+     */
     SyncExtensions(): Promise<void>;
+    /**
+     * Whether an extension grafting onto this page right now would resolve its
+     * anchors against the page's full component set.
+     *
+     * @internal
+     */
     AcceptsExtensions(): boolean;
+    /**
+     * Wait until the page has serialized its own components — and until the
+     * registration that ends up owning them is the current one: a registration
+     * starting while this waits installs its own gate, and a run released by the
+     * old one would resolve its anchors against components the new one has yet
+     * to write.
+     */
     private awaitOwnComponents;
     private closeOwnComponentsGate;
     private applyRegisteredExtensions;
@@ -45,16 +101,53 @@ export declare class PageMetadata {
     private registersComponentPermissions;
     private componentPermissionId;
     private actionPermissions;
+    /**
+     * Claim a component's permissions now, and hand back the serialization to
+     * await later.
+     *
+     * The split is what keeps the registration attributable: `RegisterPermission`
+     * reads the responsible module off the call stack, and every component after
+     * the first used to register from a continuation of the previous one's
+     * `serialize()` — where that stack is gone, so the core had no module to
+     * sweep them from.
+     *
+     * A component's children are prepared with it, each under the permission id
+     * of its position: they take part in per-request filtering under that id, so
+     * a child that never claimed it would have its `onFilter` skipped.
+     */
     private prepareComponent;
     private bindNativeUploadFields;
     private bindUploadOptions;
     private registerNativeUploadField;
     private registerComponentNode;
+    /**
+     * Run a component's `onCreated` hook, once per registration whatever the
+     * number of positions the same instance occupies — the hook registers side
+     * effects (a table view's form sub-pages, a chart's realtime topic), and
+     * running it twice registers them twice.
+     *
+     * A nested component's hook is isolated the way `addExtension` isolates an
+     * extension's: it never ran before this walk existed, so letting it abort a
+     * page that used to register would turn a quietly inert component into a
+     * screen that no longer serves. The page's own components keep aborting it —
+     * a half-registered page is worse than none.
+     */
     private notifyPageCreated;
+    /**
+     * A page's permission ids are derived from its `fullId`, so a metadata
+     * instance that has already been replaced (dev hot reload re-registers the
+     * page under a new class) shares them with the live one. Only the current
+     * owner — or nobody, when the page is gone for good — may take them down.
+     */
     private ownsPagePermissions;
     private unregisterComponent;
     private unregisterComponentNode;
     private addExtension;
+    /**
+     * Who owns each component key of the page right now: the page itself for its
+     * own fields, the extension that injected it otherwise. One namespace,
+     * because a page's components share one permission subtree.
+     */
     private takenComponentKeys;
     private dropExtension;
     private extensionComponentPath;