@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/ext/diagram-registry.js

@@ -0,0 +1,303 @@
+"use strict";
+/**
+ * ============================================================================
+ * `DiagramRegistry` — one diagram's contribution surface
+ * ============================================================================
+ *
+ * Every method here exists as a module-level function already. What this adds is
+ * an ANSWER TO "WHOSE?".
+ *
+ *   registerShape('badge', …)          // the process. Everyone's.
+ *   diagram.registry.registerShape(…)  // this diagram. Nobody else's.
+ *
+ * The two layer: a diagram resolves a name against its own table first and falls
+ * through to the process-global registry, so an app that registers its shape
+ * library once at import time keeps working unchanged in every diagram, and a
+ * single diagram can still override one name for itself without mutating what
+ * the diagram beside it sees.
+ *
+ * ONE IMPLEMENTATION, TWO BINDINGS. `GLOBAL_DIAGRAM_REGISTRY` is this same class
+ * with a null scope, so the process-wide path and the per-diagram path are the
+ * same code with the same disposer semantics. That is deliberate: the previous
+ * arrangement had the ExtensionHost's restore-on-dispose logic written once, for
+ * the global registries only, and the whole bug was that it then ran on behalf
+ * of a diagram that did not own what it was restoring.
+ *
+ * DISPOSERS RESTORE, they do not merely delete — the rule `ext/disposable.ts`
+ * states. Scoped disposers restore the SCOPE's previous entry, which may be
+ * "nothing", in which case the global definition becomes visible again. That
+ * layering is the point: unloading a diagram's override reveals the built-in,
+ * it does not punch a hole through to the fallback.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_DIAGRAM_REGISTRY = exports.DiagramRegistry = void 0;
+const disposable_1 = require("./disposable");
+const registry_scope_1 = require("./registry-scope");
+const shape_registry_1 = require("../svg/shape-registry");
+const style_registry_1 = require("../themes/style-registry");
+const edge_templates_1 = require("../svg/edge-templates");
+const link_pipeline_1 = require("./link-pipeline");
+const custom_animation_registry_1 = require("../services/custom-animation-registry");
+/**
+ * Write `value` into one of THIS diagram's tables and hand back the undo.
+ *
+ * `had` is captured separately from `previous` because a registration whose
+ * value is legitimately `undefined` must still restore as "present", and
+ * `previous === undefined` cannot tell those apart.
+ */
+function setScoped(scope, table, key, value, notify) {
+    const map = scope.table(table);
+    const had = map.has(key);
+    const previous = map.get(key);
+    map.set(key, value);
+    notify();
+    return (0, disposable_1.once)(() => {
+        if (had)
+            map.set(key, previous);
+        else
+            map.delete(key);
+        notify();
+    });
+}
+/** Read the process-global registry even if a scope happens to be active. */
+function global(read) {
+    return (0, registry_scope_1.runInRegistryScope)(null, read);
+}
+/**
+ * The contribution surface. Obtained from a diagram as `diagram.registry`, or as
+ * {@link GLOBAL_DIAGRAM_REGISTRY} for the process-wide one.
+ */
+class DiagramRegistry {
+    /**
+     * @param scope this diagram's private tables, or `null` for the
+     *              process-global registries.
+     */
+    constructor(scope = null) {
+        this.scope = scope;
+    }
+    /** True when writes here are private to one diagram. */
+    get isScoped() {
+        return this.scope !== null;
+    }
+    // -- shapes ---------------------------------------------------------------
+    registerShape(type, definition) {
+        const value = Object.assign(Object.assign({}, definition), { type });
+        if (!this.scope) {
+            const previous = global(() => (0, shape_registry_1.getShapeDefinition)(type));
+            (0, shape_registry_1.registerShape)(type, definition);
+            return (0, disposable_1.once)(() => {
+                if (previous)
+                    (0, shape_registry_1.registerShape)(type, previous);
+                else
+                    (0, shape_registry_1.unregisterShape)(type);
+            });
+        }
+        return setScoped(this.scope, registry_scope_1.SHAPES, type, value, shape_registry_1.notifyShapeRegistered);
+    }
+    registerPathShape(type, path, options) {
+        // Built through the SAME builder the global path uses, so a scoped path
+        // shape cannot differ in geometry from a global one.
+        return this.registerShape(type, (0, shape_registry_1.buildPathShapeDefinition)(type, path, options));
+    }
+    unregisterShape(type) {
+        if (!this.scope)
+            return (0, shape_registry_1.unregisterShape)(type);
+        const map = this.scope.table(registry_scope_1.SHAPES);
+        const existed = map.delete(type);
+        if (existed)
+            (0, shape_registry_1.notifyShapeRegistered)();
+        return existed;
+    }
+    hasShape(type) {
+        return this.read(() => (0, shape_registry_1.hasShape)(type));
+    }
+    listShapes() {
+        return this.read(() => (0, shape_registry_1.listShapes)());
+    }
+    getShapeDefinition(type) {
+        return this.read(() => (0, shape_registry_1.getShapeDefinition)(type));
+    }
+    // -- named styles ---------------------------------------------------------
+    defineStyle(name, style) {
+        if (!this.scope) {
+            const previous = global(() => (0, style_registry_1.getStyle)(name));
+            (0, style_registry_1.defineStyle)(name, style);
+            return (0, disposable_1.once)(() => {
+                if (previous)
+                    (0, style_registry_1.defineStyle)(name, previous);
+                else
+                    (0, style_registry_1.removeStyle)(name);
+            });
+        }
+        // Copied, matching `defineStyle`: later mutation of the caller's object
+        // must not reach into the registry.
+        return setScoped(this.scope, registry_scope_1.STYLES, name, Object.assign({}, style), style_registry_1.notifyStyleRegistryChanged);
+    }
+    defineStyles(styles) {
+        if (!this.scope) {
+            const undo = Object.keys(styles).map((name) => {
+                const previous = global(() => (0, style_registry_1.getStyle)(name));
+                return () => (previous ? (0, style_registry_1.defineStyle)(name, previous) : (0, style_registry_1.removeStyle)(name));
+            });
+            (0, style_registry_1.defineStyles)(styles);
+            return (0, disposable_1.once)(() => undo.forEach((u) => u()));
+        }
+        const undo = Object.entries(styles).map(([name, style]) => setScoped(this.scope, registry_scope_1.STYLES, name, Object.assign({}, style), style_registry_1.notifyStyleRegistryChanged));
+        return (0, disposable_1.once)(() => undo.forEach((u) => u()));
+    }
+    removeStyle(name) {
+        if (!this.scope)
+            return (0, style_registry_1.removeStyle)(name);
+        const existed = this.scope.table(registry_scope_1.STYLES).delete(name);
+        if (existed)
+            (0, style_registry_1.notifyStyleRegistryChanged)();
+        return existed;
+    }
+    /**
+     * Drop THIS diagram's named styles. The process-global ones are untouched and
+     * become visible again — which is what makes this safe to call from a teardown
+     * that has no idea what else is on the page.
+     */
+    clearStyles() {
+        if (!this.scope) {
+            (0, style_registry_1.clearStyles)();
+            return;
+        }
+        const map = this.scope.table(registry_scope_1.STYLES);
+        if (map.size === 0)
+            return;
+        map.clear();
+        (0, style_registry_1.notifyStyleRegistryChanged)();
+    }
+    getStyle(name) {
+        return this.read(() => (0, style_registry_1.getStyle)(name));
+    }
+    hasStyle(name) {
+        return this.read(() => (0, style_registry_1.hasStyle)(name));
+    }
+    listStyles() {
+        return this.read(() => (0, style_registry_1.listStyles)());
+    }
+    // -- link visuals ---------------------------------------------------------
+    registerLinkTemplate(name, template) {
+        if (!this.scope) {
+            const previous = global(() => (0, edge_templates_1.getLinkTemplate)(name));
+            (0, edge_templates_1.registerLinkTemplate)(name, template);
+            return (0, disposable_1.once)(() => previous ? (0, edge_templates_1.registerLinkTemplate)(name, previous) : void (0, edge_templates_1.unregisterLinkTemplate)(name));
+        }
+        return setScoped(this.scope, registry_scope_1.LINK_TEMPLATES, name, template, edge_templates_1.notifyEdgeTemplatesChanged);
+    }
+    registerLabelTemplate(name, template) {
+        if (!this.scope) {
+            const previous = global(() => (0, edge_templates_1.getLabelTemplate)(name));
+            (0, edge_templates_1.registerLabelTemplate)(name, template);
+            return (0, disposable_1.once)(() => previous ? (0, edge_templates_1.registerLabelTemplate)(name, previous) : void (0, edge_templates_1.unregisterLabelTemplate)(name));
+        }
+        return setScoped(this.scope, registry_scope_1.LABEL_TEMPLATES, name, template, edge_templates_1.notifyEdgeTemplatesChanged);
+    }
+    registerMarker(name, definition) {
+        if (!this.scope) {
+            const previous = global(() => (0, edge_templates_1.getMarker)(name));
+            (0, edge_templates_1.registerMarker)(name, definition);
+            return (0, disposable_1.once)(() => (previous ? (0, edge_templates_1.registerMarker)(name, previous) : void (0, edge_templates_1.unregisterMarker)(name)));
+        }
+        return setScoped(this.scope, registry_scope_1.MARKERS, name, definition, edge_templates_1.notifyEdgeTemplatesChanged);
+    }
+    getLinkTemplate(name) {
+        return this.read(() => (0, edge_templates_1.getLinkTemplate)(name));
+    }
+    getLabelTemplate(name) {
+        return this.read(() => (0, edge_templates_1.getLabelTemplate)(name));
+    }
+    getMarker(name) {
+        return this.read(() => (0, edge_templates_1.getMarker)(name));
+    }
+    hasMarker(name) {
+        return this.read(() => (0, edge_templates_1.hasMarker)(name));
+    }
+    listLinkTemplates() {
+        return this.read(() => (0, edge_templates_1.listLinkTemplates)());
+    }
+    listLabelTemplates() {
+        return this.read(() => (0, edge_templates_1.listLabelTemplates)());
+    }
+    listMarkers() {
+        return this.read(() => (0, edge_templates_1.listMarkers)());
+    }
+    // -- link pipeline --------------------------------------------------------
+    //
+    // The three global `register*` functions already return restore-on-dispose
+    // disposers, so the unscoped branch delegates rather than re-deriving them.
+    registerAnchor(name, anchor) {
+        if (!this.scope)
+            return (0, link_pipeline_1.registerAnchor)(name, anchor);
+        return setScoped(this.scope, registry_scope_1.ANCHORS, name, anchor, link_pipeline_1.notifyLinkPipelineChanged);
+    }
+    registerConnectionPoint(name, strategy) {
+        if (!this.scope)
+            return (0, link_pipeline_1.registerConnectionPoint)(name, strategy);
+        return setScoped(this.scope, registry_scope_1.CONNECTION_POINTS, name, strategy, link_pipeline_1.notifyLinkPipelineChanged);
+    }
+    registerConnector(name, connector) {
+        if (!this.scope)
+            return (0, link_pipeline_1.registerConnector)(name, connector);
+        return setScoped(this.scope, registry_scope_1.CONNECTORS, name, connector, link_pipeline_1.notifyLinkPipelineChanged);
+    }
+    listAnchors() {
+        return this.read(() => (0, link_pipeline_1.listAnchors)());
+    }
+    listConnectionPoints() {
+        return this.read(() => (0, link_pipeline_1.listConnectionPoints)());
+    }
+    listConnectors() {
+        return this.read(() => (0, link_pipeline_1.listConnectors)());
+    }
+    // -- animations -----------------------------------------------------------
+    /**
+     * This diagram's own {@link CustomAnimationRegistry}, or the process-global
+     * singleton when unscoped.
+     *
+     * Lazy: the constructor appends a `<style>` element to the document, so a
+     * diagram that never contributes an animation must not pay for one.
+     */
+    get animations() {
+        if (!this.scope)
+            return (0, custom_animation_registry_1.getGlobalCustomAnimationRegistry)();
+        if (!this.ownAnimations)
+            this.ownAnimations = new custom_animation_registry_1.CustomAnimationRegistry();
+        return this.ownAnimations;
+    }
+    // -- lifecycle ------------------------------------------------------------
+    /** Drop every contribution this diagram made. No-op on the global registry. */
+    dispose() {
+        var _a;
+        if (!this.scope)
+            return;
+        const wasEmpty = this.scope.isEmpty();
+        this.scope.clear();
+        (_a = this.ownAnimations) === null || _a === void 0 ? void 0 : _a.destroy();
+        this.ownAnimations = undefined;
+        // Anything cached against a definition that no longer exists must go.
+        if (!wasEmpty) {
+            (0, shape_registry_1.notifyShapeRegistered)();
+            (0, style_registry_1.notifyStyleRegistryChanged)();
+            (0, edge_templates_1.notifyEdgeTemplatesChanged)();
+            (0, link_pipeline_1.notifyLinkPipelineChanged)();
+        }
+    }
+    /**
+     * Run a READ with this diagram's scope active.
+     *
+     * Every accessor above goes through here rather than reading the module maps,
+     * because the shadowing rule (mine first, then the process) must be identical
+     * whether a name is being resolved by a render pass or by a host asking
+     * `listShapes()`. Two implementations of that rule would drift.
+     */
+    read(fn) {
+        return (0, registry_scope_1.runInRegistryScope)(this.scope, fn);
+    }
+}
+exports.DiagramRegistry = DiagramRegistry;
+/** The process-wide registry — what the module-level `register*` functions write to. */
+exports.GLOBAL_DIAGRAM_REGISTRY = new DiagramRegistry(null);
+//# sourceMappingURL=diagram-registry.js.map

package/src/libs/renderer/src/ext/diagram-registry.js.map

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

package/src/libs/renderer/src/ext/disposable.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Disposables — the one rule every extension seam in Wave 6 obeys.
+ *
+ * NON-NEGOTIABLE (learned from a real bug): every `register()` returns a
+ * disposer, and disposing an extension must leave the registries byte-identical
+ * to what they were before it loaded. The past failure was subscriptions that
+ * were never unsubscribed, so swapping the engine left handlers live on the old
+ * one. A registry that can only ADD is structurally incapable of honouring that,
+ * which is why Wave 6 added `unregisterShape` / `unregisterLinkTemplate` / … as
+ * additive removal paths on the existing registries.
+ *
+ * RESTORE-ON-DISPOSE. A disposer does not merely delete the key it wrote — it
+ * restores whatever was there BEFORE. An extension that overrides the built-in
+ * `rect` shape and is then disposed must give `rect` back, not leave a hole that
+ * silently falls through to the default. `snapshotRestore()` is that helper.
+ */
+/** The universal teardown handle. Idempotent by contract. */
+export type Disposer = () => void;
+/** Something that can be torn down. */
+export interface Disposable {
+    dispose(): void;
+}
+/** Wrap a function so it can only ever run once. */
+export declare function once(fn: Disposer): Disposer;
+/**
+ * Build a disposer that puts a registry key back the way it was.
+ *
+ * @param previous the value read out of the registry BEFORE the write (or
+ *                 `undefined` when the key did not exist)
+ * @param restore  re-register the previous value
+ * @param remove   delete the key (used when there was no previous value)
+ */
+export declare function snapshotRestore<T>(previous: T | undefined, restore: (value: T) => void, remove: () => void): Disposer;
+/**
+ * A bag of disposers with a single `dispose()`. Extensions accumulate their
+ * registrations here so the host can tear the whole extension down atomically.
+ *
+ * Disposal runs in REVERSE registration order (like a stack unwind) and is
+ * failure-tolerant: one throwing disposer must not strand the rest, or a single
+ * bad extension would leak every registry behind it.
+ */
+export declare class DisposableStore implements Disposable {
+    private readonly disposers;
+    private disposed;
+    /** Track a disposer. If the store is ALREADY disposed, run it immediately. */
+    add(disposer: Disposer): Disposer;
+    /** How many live registrations this store holds (tests assert on this). */
+    get size(): number;
+    get isDisposed(): boolean;
+    dispose(): void;
+}

package/src/libs/renderer/src/ext/disposable.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Disposables — the one rule every extension seam in Wave 6 obeys.
+ *
+ * NON-NEGOTIABLE (learned from a real bug): every `register()` returns a
+ * disposer, and disposing an extension must leave the registries byte-identical
+ * to what they were before it loaded. The past failure was subscriptions that
+ * were never unsubscribed, so swapping the engine left handlers live on the old
+ * one. A registry that can only ADD is structurally incapable of honouring that,
+ * which is why Wave 6 added `unregisterShape` / `unregisterLinkTemplate` / … as
+ * additive removal paths on the existing registries.
+ *
+ * RESTORE-ON-DISPOSE. A disposer does not merely delete the key it wrote — it
+ * restores whatever was there BEFORE. An extension that overrides the built-in
+ * `rect` shape and is then disposed must give `rect` back, not leave a hole that
+ * silently falls through to the default. `snapshotRestore()` is that helper.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisposableStore = void 0;
+exports.once = once;
+exports.snapshotRestore = snapshotRestore;
+/** Wrap a function so it can only ever run once. */
+function once(fn) {
+    let done = false;
+    return () => {
+        if (done)
+            return;
+        done = true;
+        fn();
+    };
+}
+/**
+ * Build a disposer that puts a registry key back the way it was.
+ *
+ * @param previous the value read out of the registry BEFORE the write (or
+ *                 `undefined` when the key did not exist)
+ * @param restore  re-register the previous value
+ * @param remove   delete the key (used when there was no previous value)
+ */
+function snapshotRestore(previous, restore, remove) {
+    return once(() => {
+        if (previous === undefined)
+            remove();
+        else
+            restore(previous);
+    });
+}
+/**
+ * A bag of disposers with a single `dispose()`. Extensions accumulate their
+ * registrations here so the host can tear the whole extension down atomically.
+ *
+ * Disposal runs in REVERSE registration order (like a stack unwind) and is
+ * failure-tolerant: one throwing disposer must not strand the rest, or a single
+ * bad extension would leak every registry behind it.
+ */
+class DisposableStore {
+    constructor() {
+        this.disposers = [];
+        this.disposed = false;
+    }
+    /** Track a disposer. If the store is ALREADY disposed, run it immediately. */
+    add(disposer) {
+        if (this.disposed) {
+            disposer();
+            return () => undefined;
+        }
+        const wrapped = once(disposer);
+        this.disposers.push(wrapped);
+        return wrapped;
+    }
+    /** How many live registrations this store holds (tests assert on this). */
+    get size() {
+        return this.disposers.length;
+    }
+    get isDisposed() {
+        return this.disposed;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        const errors = [];
+        // Reverse order: the last registration is the first undone.
+        for (let i = this.disposers.length - 1; i >= 0; i--) {
+            try {
+                this.disposers[i]();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        this.disposers.length = 0;
+        if (errors.length > 0) {
+            // Surface the failures, but only AFTER every other disposer has run.
+            // (Not `AggregateError` — this library's TS lib target predates it.)
+            const error = new Error(`${errors.length} disposer(s) threw during dispose(): ` +
+                errors.map((e) => (e instanceof Error ? e.message : String(e))).join('; '));
+            error.errors = errors;
+            throw error;
+        }
+    }
+}
+exports.DisposableStore = DisposableStore;
+//# sourceMappingURL=disposable.js.map

package/src/libs/renderer/src/ext/disposable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../../../../../renderer/src/ext/disposable.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAWH,oBAOC;AAUD,0CASC;AA3BD,oDAAoD;AACpD,SAAgB,IAAI,CAAC,EAAY;IAC/B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,EAAE;QACV,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,EAAE,EAAE,CAAC;IACP,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,QAAuB,EACvB,OAA2B,EAC3B,MAAkB;IAElB,OAAO,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,EAAE,CAAC;;YAChC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,eAAe;IAA5B;QACmB,cAAS,GAAe,EAAE,CAAC;QACpC,aAAQ,GAAG,KAAK,CAAC;IA8C3B,CAAC;IA5CC,8EAA8E;IAC9E,GAAG,CAAC,QAAkB;QACpB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,QAAQ,EAAE,CAAC;YACX,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACzB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,2EAA2E;IAC3E,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,4DAA4D;QAC5D,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,qEAAqE;YACrE,qEAAqE;YACrE,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,GAAG,MAAM,CAAC,MAAM,uCAAuC;gBACrD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7E,CAAC;YACD,KAAuC,CAAC,MAAM,GAAG,MAAM,CAAC;YACzD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAhDD,0CAgDC"}

package/src/libs/renderer/src/ext/extension-host.d.ts

@@ -0,0 +1,144 @@
+/**
+ * ============================================================================
+ * Card 0 — the ExtensionHost, and Card 7 — the capability-scoped sandbox
+ * ============================================================================
+ *
+ * Before Wave 6 the extension story was seven unrelated registries, reached by
+ * importing whatever module happened to own them:
+ *
+ *   registerShape / registerPathShape        (renderer, module-global map)
+ *   registerLinkTemplate / registerLabelTemplate / registerMarker
+ *                                            (renderer, module-global maps)
+ *   RoutingEngine.registerRouter             (engine, per-engine instance)
+ *   TemplateRegistry.register                (engine, per-engine instance)
+ *   CustomAnimationRegistry.register         (renderer, global singleton)
+ *   PropertyEditorRegistryService            (ANGULAR-only — see note below)
+ *   HandleRegistryService                    (ANGULAR-only)
+ *
+ * Not one of them returned a disposer, three had no removal path at all, and two
+ * were reachable only from Angular. There was no way to answer "what did this
+ * plugin add?" or "unload it".
+ *
+ * The ExtensionHost is the ONE public seam over those. It is a FACADE — it does
+ * not reimplement a single registry — and it adds exactly what they lacked:
+ *
+ *   • ONE entry point, `host.register(extension)`.
+ *   • LEAST PRIVILEGE. An extension declares `capabilities: ['shapes']` and
+ *     receives an object with ONLY `shapes` on it. There is no `engine` handle,
+ *     no `document`, no way to reach a registry it did not ask for. Asking for a
+ *     capability the host was not given (e.g. `routers` with no engine bound)
+ *     fails AT REGISTRATION, not at first use.
+ *   • DISPOSERS EVERYWHERE. Every registration is tracked; `dispose()` unwinds
+ *     the extension completely and RESTORES anything it overrode.
+ *   • ENGINE COMPAT. A manifest declares the engine range it supports and is
+ *     REJECTED — loudly — if it does not match.
+ *   • LAZY LOADING. `registerLazy()` takes a `() => Promise<Extension>` and does
+ *     not touch it until `activate(id)`.
+ *
+ * ---------------------------------------------------------------------------
+ * NOTE — the two Angular-only registries
+ * ---------------------------------------------------------------------------
+ * `PropertyEditorRegistryService` and `HandleRegistryService` are Angular
+ * `@Injectable`s living in `libs/renderer-angular`. `libs/renderer` may not
+ * import Angular (hard rule), so they CANNOT be wrapped from here without first
+ * being lowered into the framework-free core. That lowering is a real piece of
+ * work and is NOT in this wave — stated plainly rather than faked with an
+ * any-typed shim. The host is designed for it: adding `editors` / `handles` to
+ * `CapabilityName` is additive and breaks nothing.
+ */
+import type { DiagramEngine } from '@grafloria/engine';
+import type { CapabilityName, ExtensionContext, HostBindings } from './capabilities';
+import type { Disposer } from './disposable';
+import type { ExtensionManifest } from './manifest';
+/** The engine/host API version extensions declare compatibility against. */
+export declare const EXTENSION_API_VERSION = "1.0.0";
+/**
+ * An extension. `activate` receives ONLY the capabilities its manifest declared.
+ *
+ * ```ts
+ * const starPlugin: Extension<'shapes'> = {
+ *   manifest: {
+ *     id: 'acme.stars',
+ *     version: '1.2.0',
+ *     engines: { grafloria: '^1.0.0' },
+ *     capabilities: ['shapes'],
+ *   },
+ *   activate({ capabilities }) {
+ *     // `capabilities.routers` does not exist here — not typed, not present.
+ *     capabilities.shapes.registerPath('star', starPath);
+ *   },
+ * };
+ * host.register(starPlugin);
+ * ```
+ */
+export interface Extension<C extends CapabilityName = CapabilityName> {
+    manifest: ExtensionManifest<C>;
+    /**
+     * Set up. Anything you register is tracked and undone on dispose; you may also
+     * return a disposer (or push onto `context.onDispose`) for your own resources.
+     */
+    activate(context: ExtensionContext<C>): void | Disposer | Promise<void | Disposer>;
+    /** Optional explicit teardown, run before the tracked disposers. */
+    deactivate?(): void;
+}
+/** A lazily-loaded extension: nothing is imported until `activate(id)`. */
+export type LazyExtension<C extends CapabilityName = CapabilityName> = () => Promise<Extension<C> | {
+    default: Extension<C>;
+}>;
+export interface RegisteredExtension {
+    readonly manifest: ExtensionManifest;
+    readonly active: boolean;
+    /** Registrations this extension currently holds. */
+    readonly registrationCount: number;
+}
+export interface ExtensionHostOptions extends HostBindings {
+    /** Reject manifests whose `engines.grafloria` range excludes this. */
+    apiVersion?: string;
+}
+export declare class ExtensionHost {
+    private readonly entries;
+    private readonly bindings;
+    private readonly apiVersion;
+    private disposed;
+    constructor(options: ExtensionHostOptions);
+    /** The engine this host is bound to (hosts, not extensions, may ask). */
+    get engine(): DiagramEngine;
+    /**
+     * Register and ACTIVATE an extension.
+     *
+     * Throws — deliberately, and before any side effect — when the manifest is
+     * malformed, the id is taken, the engine range excludes this host, or the
+     * extension asks for a capability this host cannot grant. A plugin that half-
+     * loads is worse than one that refuses to.
+     */
+    register<C extends CapabilityName>(extension: Extension<C>): Disposer;
+    /**
+     * Register WITHOUT loading. The factory is not called until `activate(id)`,
+     * so a 500 KB plugin costs nothing until something needs it.
+     *
+     * The manifest is supplied up front precisely so the host can answer "what
+     * shapes/routers exist?" and validate compatibility WITHOUT paying the import.
+     */
+    registerLazy<C extends CapabilityName>(manifest: ExtensionManifest<C>, load: LazyExtension<C>): Disposer;
+    /** Activate a lazily-registered extension (imports it on first call). */
+    activate(id: string): Promise<void>;
+    private activateEntry;
+    /** Tear one extension down. Every registration it made is undone. */
+    dispose(id: string): void;
+    /** Tear everything down. The host is unusable afterwards. */
+    disposeAll(): void;
+    has(id: string): boolean;
+    get(id: string): RegisteredExtension | undefined;
+    /** Everything registered, loaded or not. */
+    list(): RegisteredExtension[];
+    private assertLive;
+    private assertIdFree;
+    /**
+     * Least privilege, enforced EARLY. An extension that declares `panels` in a
+     * headless host (no DOM bound) is rejected here — not at first `createPanel()`
+     * call three minutes into a session.
+     */
+    private assertGrantable;
+}
+/** Convenience: a host bound to a live `createDiagram()` instance. */
+export declare function createExtensionHost(options: ExtensionHostOptions): ExtensionHost;