@tai42/studio-sdk 16.0.0 → 16.0.1

package/dist/navigation/guarded-navigation.js

@@ -0,0 +1,102 @@
+import { mergeEntryState, reconstructEntryState } from './entry-state';
+// navigate: forwarded as a REST tuple so the shell's `navigate` is called with
+// exactly the arguments the caller passed — a caller wanting the default history
+// behaviour never turns into one that passed an explicit `undefined` for it.
+function buildNavigate(value, registry, committedRef) {
+    return (...args) => {
+        const [token, search] = args;
+        if (!registry.hasArmedGuards()) {
+            value.navigate(...args);
+            return;
+        }
+        void registry.run().then((allowed) => {
+            if (!allowed)
+                return;
+            value.navigate(...args);
+            // Advance the committed entry to the resolved destination (the router may commit
+            // async, so `window.location` would be stale). Router state is unobservable here.
+            if (committedRef.current !== null) {
+                committedRef.current = { href: value.resolvePath(token, search), state: null };
+            }
+        });
+    };
+}
+function buildNavigatePlugin(value, registry, committedRef) {
+    return (pluginId, pagePath, params, search) => {
+        if (!registry.hasArmedGuards()) {
+            value.navigatePlugin(pluginId, pagePath, params, search);
+            return;
+        }
+        void registry.run().then((allowed) => {
+            if (!allowed)
+                return;
+            value.navigatePlugin(pluginId, pagePath, params, search);
+            if (committedRef.current !== null) {
+                committedRef.current = {
+                    href: value.resolvePluginPath(pluginId, pagePath, params, search),
+                    state: null,
+                };
+            }
+        });
+    };
+}
+// navigatePluginWithOptions: guard-gated exactly like navigatePlugin (a veto never
+// reaches the host member). On approval, refresh the committed entry with the
+// reconstructed state bag so a subsequent vetoed Back restores the slot this
+// navigation just wrote, not null.
+function buildNavigateWithOptions(hostNavigateWithOptions, value, registry, committedRef) {
+    return (pluginId, pagePath, params, search, options) => {
+        if (!registry.hasArmedGuards()) {
+            hostNavigateWithOptions(pluginId, pagePath, params, search, options);
+            return;
+        }
+        void registry.run().then((allowed) => {
+            if (!allowed)
+                return;
+            hostNavigateWithOptions(pluginId, pagePath, params, search, options);
+            if (committedRef.current !== null) {
+                committedRef.current = {
+                    href: value.resolvePluginPath(pluginId, pagePath, params, search),
+                    state: options?.state !== undefined ? reconstructEntryState(pluginId, options.state) : null,
+                };
+            }
+        });
+    };
+}
+// updatePluginEntryState: guard-FREE — rewriting the current entry's state is not a
+// navigation away. The SDK still wraps it to refresh the committed entry with the
+// merged slot, so a later vetoed Back restores the UPDATED state. URL is unchanged.
+function buildUpdateEntryState(hostUpdateEntryState, committedRef) {
+    return (pluginId, state) => {
+        hostUpdateEntryState(pluginId, state);
+        if (committedRef.current !== null) {
+            committedRef.current = {
+                href: committedRef.current.href,
+                state: mergeEntryState(committedRef.current.state, pluginId, state),
+            };
+        }
+    };
+}
+/**
+ * Build the guarded navigation value. The two host-optional members
+ * (`navigatePluginWithOptions`, `updatePluginEntryState`) are wrapped only when the
+ * host provides them; an older host leaves them undefined and the plugin-facing hook
+ * throws loudly.
+ */
+export function buildGuardedNavigation(value, registry, committedRef) {
+    const result = {
+        ...value,
+        navigate: buildNavigate(value, registry, committedRef),
+        navigatePlugin: buildNavigatePlugin(value, registry, committedRef),
+    };
+    const hostNavigateWithOptions = value.navigatePluginWithOptions;
+    if (hostNavigateWithOptions !== undefined) {
+        result.navigatePluginWithOptions = buildNavigateWithOptions(hostNavigateWithOptions, value, registry, committedRef);
+    }
+    const hostUpdateEntryState = value.updatePluginEntryState;
+    if (hostUpdateEntryState !== undefined) {
+        result.updatePluginEntryState = buildUpdateEntryState(hostUpdateEntryState, committedRef);
+    }
+    return result;
+}
+//# sourceMappingURL=guarded-navigation.js.map

package/dist/navigation/guarded-navigation.js.map

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

package/dist/navigation/index.d.ts

@@ -1,5 +1,6 @@
-export { NavigationProvider, AppLink, useAppNavigate, useResolvePath, usePluginNavigation, usePluginEntryNavigation, useNavigationGuard, useNavigationGate, } from './context';
-export type { AppLinkProps } from './context';
+export { NavigationProvider, useAppNavigate, useResolvePath, usePluginNavigation, usePluginEntryNavigation, useNavigationGuard, useNavigationGate, } from './context';
+export { AppLink } from './app-link';
+export type { AppLinkProps } from './app-link';
 export { useSearchCommit } from './use-search-commit';
 export type { SearchCommitParams } from './use-search-commit';
 export type { RouteToken, RouteSearch, RouteSearchByToken, PageProps, NavigationContextValue, NavigateOptions, PluginNavigateOptions, PluginSearch, NavigationGuardHandler, } from './types';

package/dist/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/navigation/index.js

@@ -1,3 +1,4 @@
-export { NavigationProvider, AppLink, useAppNavigate, useResolvePath, usePluginNavigation, usePluginEntryNavigation, useNavigationGuard, useNavigationGate, } from './context';
+export { NavigationProvider, useAppNavigate, useResolvePath, usePluginNavigation, usePluginEntryNavigation, useNavigationGuard, useNavigationGate, } from './context';
+export { AppLink } from './app-link';
 export { useSearchCommit } from './use-search-commit';
 //# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/navigation/types.d.ts

@@ -170,21 +170,18 @@ export interface NavigationContextValue {
     resolvePluginPath: (pluginId: string, pagePath: string, params?: string, search?: PluginSearch) => string;
     /**
      * ADDITIVE plugin-page navigation that also carries per-history-entry
-     * {@link PluginNavigateOptions}. OPTIONAL because a Studio host built before this
-     * feature does not provide it; plugins reach it — and require a host that does —
-     * through {@link usePluginEntryNavigation}, which throws loudly on an older host.
+     * {@link PluginNavigateOptions}. OPTIONAL because a host that does not implement it
+     * leaves it undefined; plugins reach it — and require a host that provides it —
+     * through {@link usePluginEntryNavigation}, which throws loudly when it is absent.
      * It behaves exactly like {@link navigatePlugin} for path / params / search, and in
      * addition writes `options.state` onto the DESTINATION entry under the plugin's own
      * namespace slot (see {@link PluginPageProps.entryState}).
      *
-     * NEXT-MAJOR (9.0) CONSOLIDATION NOTE: fold `options` into {@link navigatePlugin}'s
-     * own signature and RETIRE this sibling. It exists as a separate optional member
-     * ONLY to stay additive under the plugin-API equality gate — a new optional member
-     * does not move {@link STUDIO_PLUGIN_API_VERSION}, so every existing plugin keeps
-     * loading. Cutting a MAJOR now purely to rename one method onto another is the
-     * disproportion anti-pattern: a breaking change for a cosmetic merge. The merge
-     * therefore waits for the next major that carries real breaks; until then both
-     * coexist and {@link navigatePlugin} stays byte-for-byte stable.
+     * It is a separate optional member rather than an extra parameter on
+     * {@link navigatePlugin} so it stays additive under the plugin-API equality gate: a
+     * new optional member does not move {@link STUDIO_PLUGIN_API_VERSION}, so every
+     * existing plugin keeps loading and {@link navigatePlugin}'s own signature stays
+     * stable.
      */
     navigatePluginWithOptions?: (pluginId: string, pagePath: string, params?: string, search?: PluginSearch, options?: PluginNavigateOptions) => void;
     /**

package/dist/navigation/types.d.ts.map

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

package/dist/navigation/use-back-forward-guard.d.ts

@@ -0,0 +1,5 @@
+import type { RefObject } from 'react';
+import type { NavigationGuardRegistry } from './guard-registry';
+import type { CommittedEntry } from './guarded-navigation';
+export declare function useBackForwardGuard(registry: NavigationGuardRegistry, committedRef: RefObject<CommittedEntry | null>): void;
+//# sourceMappingURL=use-back-forward-guard.d.ts.map

package/dist/navigation/use-back-forward-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-back-forward-guard.d.ts","sourceRoot":"","sources":["../../src/navigation/use-back-forward-guard.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,GAC7C,IAAI,CAyEN"}

package/dist/navigation/use-back-forward-guard.js

@@ -0,0 +1,82 @@
+/**
+ * The browser back/forward and full-unload arm of the navigation guard. While any
+ * guard is armed it intercepts `popstate` — canceling the move by re-pushing the
+ * committed entry, consulting the guards once, and replaying the move on approval —
+ * and installs a `beforeunload` prompt. It attaches the listeners only while armed,
+ * mirroring the registry's armed state into React.
+ */
+import { useEffect, useState } from 'react';
+export function useBackForwardGuard(registry, committedRef) {
+    // Mirror the registry's armed state into React so the browser listeners attach only
+    // while at least one guard is armed.
+    const [armed, setArmed] = useState(false);
+    useEffect(() => {
+        setArmed(registry.hasArmedGuards());
+        return registry.subscribe(() => {
+            setArmed(registry.hasArmedGuards());
+        });
+    }, [registry]);
+    useEffect(() => {
+        if (!armed)
+            return;
+        // The protected entry (URL + state); a back/forward landing elsewhere is first
+        // canceled back to here while the guard is consulted.
+        committedRef.current = { href: window.location.href, state: window.history.state };
+        // Set while replaying a guard-approved back/forward, so its `popstate` passes
+        // through instead of being re-intercepted.
+        let bypass = false;
+        // Latched while a decision is pending, so a second Back mid-decision keeps canceling
+        // without starting a concurrent `registry.run()` — one gesture, one dialog.
+        let pending = false;
+        // Restore pushes stacked for the pending decision, so an approved replay unwinds
+        // exactly that far in one `go(-depth)`. Reset per decision.
+        let restores = 0;
+        const onPopState = () => {
+            if (bypass) {
+                bypass = false;
+                committedRef.current = { href: window.location.href, state: window.history.state };
+                return;
+            }
+            if (!registry.hasArmedGuards()) {
+                committedRef.current = { href: window.location.href, state: window.history.state };
+                return;
+            }
+            const committed = committedRef.current;
+            if (committed === null)
+                return;
+            // Cancel the browser's move by pushing the committed entry on top of wherever it
+            // landed. popstate exposes no direction/distance and the router owns
+            // `history.state`, so restore can only push, not delete. A vetoed forward thus
+            // strands a stub entry — an accepted limit the next pushState truncates.
+            window.history.pushState(committed.state, '', committed.href);
+            restores += 1;
+            if (pending)
+                return;
+            pending = true;
+            void registry.run().then((allowed) => {
+                pending = false;
+                const depth = restores;
+                restores = 0;
+                if (!allowed)
+                    return;
+                bypass = true;
+                window.history.go(-depth);
+            });
+        };
+        const onBeforeUnload = (event) => {
+            event.preventDefault();
+            // Browsers below the floor (Chrome 108) gate the prompt on a set `returnValue`,
+            // not `preventDefault` alone; the string is ignored. Typed deprecated, still required.
+            // eslint-disable-next-line @typescript-eslint/no-deprecated -- required beforeunload trigger for the supported browser range.
+            event.returnValue = '';
+        };
+        window.addEventListener('popstate', onPopState);
+        window.addEventListener('beforeunload', onBeforeUnload);
+        return () => {
+            committedRef.current = null;
+            window.removeEventListener('popstate', onPopState);
+            window.removeEventListener('beforeunload', onBeforeUnload);
+        };
+    }, [armed, registry, committedRef]);
+}
+//# sourceMappingURL=use-back-forward-guard.js.map

package/dist/navigation/use-back-forward-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-back-forward-guard.js","sourceRoot":"","sources":["../../src/navigation/use-back-forward-guard.ts"],"names":[],"mappings":"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"}

package/dist/plugin/registry.d.ts

@@ -11,21 +11,12 @@ import type { PluginContributions, PluginEntry } from './types';
  * Load one plugin: call its `register` entry with a context bound to `pluginId`,
  * then commit everything it staged into the global registry.
  *
- * Contributions are STAGED into local arrays (identity captured in the closure,
- * never read from ambient state) and only committed after `entry` settles
- * successfully. `entry` is AWAITED before commit, so a synchronous or an `async`
- * entry is fully done first: a post-`await` throw skips the commit (atomicity
- * holds for async too) and a post-`await` registration cannot slip past the batch.
- * The seal is set after `entry` has SETTLED — for a sync entry, after it returns
- * and the `await` continuation runs; for an async entry, after its returned promise
- * resolves. A registration attempted from that point on (a deferred timer, a
- * callback scheduled after settle) throws loudly instead of pushing into an
- * orphaned staged array that never commits. Registrations made during `entry`'s
- * synchronous body — including a microtask it enqueues then, which runs before the
- * `await` continuation — are still captured and committed with the batch. A
- * `register` that throws commits nothing and leaves the registry untouched.
- * Duplicate guards run against BOTH the staged contributions and what is already
- * committed, and fail loudly.
+ * `entry` is AWAITED before commit, so a synchronous or an `async` entry is fully
+ * done first: a post-`await` throw skips the commit (atomicity holds for async too)
+ * and a post-`await` registration cannot slip past the batch. The seal is set after
+ * `entry` has SETTLED, so a later registration throws loudly; registrations made
+ * during `entry`'s synchronous body — including a microtask it enqueues then — are
+ * still captured and committed. A `register` that throws commits nothing.
  */
 export declare function loadPlugin(pluginId: string, entry: PluginEntry): Promise<void>;
 /** The shell reads this after loading every installed plugin bundle. */

package/dist/plugin/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAIV,mBAAmB,EACnB,WAAW,EAMZ,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHpF;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,mBAAmB,CAEtD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAIV,mBAAmB,EACnB,WAAW,EAMZ,MAAM,SAAS,CAAC;AAwIjB;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAepF;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,mBAAmB,CAEtD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/plugin/registry.js

@@ -2,118 +2,126 @@ const toolPanels = new Map();
 const pages = [];
 const settingsTabs = [];
 const navEntries = [];
+function emptyStaged() {
+    return {
+        pages: [],
+        toolPanels: new Map(),
+        settingsTabs: [],
+        tabIds: new Set(),
+        navEntries: [],
+    };
+}
 /**
- * Load one plugin: call its `register` entry with a context bound to `pluginId`,
- * then commit everything it staged into the global registry.
- *
- * Contributions are STAGED into local arrays (identity captured in the closure,
- * never read from ambient state) and only committed after `entry` settles
- * successfully. `entry` is AWAITED before commit, so a synchronous or an `async`
- * entry is fully done first: a post-`await` throw skips the commit (atomicity
- * holds for async too) and a post-`await` registration cannot slip past the batch.
- * The seal is set after `entry` has SETTLED — for a sync entry, after it returns
- * and the `await` continuation runs; for an async entry, after its returned promise
- * resolves. A registration attempted from that point on (a deferred timer, a
- * callback scheduled after settle) throws loudly instead of pushing into an
- * orphaned staged array that never commits. Registrations made during `entry`'s
- * synchronous body — including a microtask it enqueues then, which runs before the
- * `await` continuation — are still captured and committed with the batch. A
- * `register` that throws commits nothing and leaves the registry untouched.
- * Duplicate guards run against BOTH the staged contributions and what is already
+ * Build the {@link PluginContext} a plugin's `register` entry contributes through.
+ * Every method stages into `staged` (never ambient state) and refuses once `seal` is
+ * closed — a registration after `entry` settles (a deferred timer, a post-settle
+ * callback) throws loudly rather than pushing into an orphaned array that never
+ * commits. Duplicate guards run against BOTH the staged set and what is already
  * committed, and fail loudly.
  */
-export async function loadPlugin(pluginId, entry) {
-    const stagedPages = [];
-    const stagedToolPanels = new Map();
-    const stagedSettingsTabs = [];
-    const stagedTabIds = new Set();
-    const stagedNavEntries = [];
-    let sealed = false;
-    const context = {
+function makeStagingContext(pluginId, staged, seal) {
+    const assertOpen = () => {
+        if (seal.closed) {
+            throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
+        }
+    };
+    return {
         registerPage(contribution) {
-            if (sealed) {
-                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
-            }
-            const staged = stagedPages.some((p) => p.path === contribution.path);
-            const committed = pages.some((p) => p.pluginId === pluginId && p.path === contribution.path);
-            if (staged || committed) {
+            assertOpen();
+            const duplicate = staged.pages.some((p) => p.path === contribution.path) ||
+                pages.some((p) => p.pluginId === pluginId && p.path === contribution.path);
+            if (duplicate) {
                 // A duplicate path within one plugin is an author mistake that would
                 // leave one page unreachable — fail loudly, as registerToolPanel does.
                 throw new Error(`plugin “${pluginId}” already registered a page at “${contribution.path}”`);
             }
-            stagedPages.push({ ...contribution, pluginId });
+            staged.pages.push({ ...contribution, pluginId });
         },
         registerToolPanel(contribution) {
-            if (sealed) {
-                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
-            }
-            if (stagedToolPanels.has(contribution.toolName) || toolPanels.has(contribution.toolName)) {
+            assertOpen();
+            if (staged.toolPanels.has(contribution.toolName) || toolPanels.has(contribution.toolName)) {
                 throw new Error(`a tool panel is already registered for ${contribution.toolName}`);
             }
-            stagedToolPanels.set(contribution.toolName, contribution);
+            staged.toolPanels.set(contribution.toolName, contribution);
         },
         registerSettingsTab(contribution) {
-            if (sealed) {
-                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
-            }
+            assertOpen();
             const committed = settingsTabs.some((t) => t.pluginId === pluginId && t.id === contribution.id);
-            if (stagedTabIds.has(contribution.id) || committed) {
+            if (staged.tabIds.has(contribution.id) || committed) {
                 // A duplicate tab id within one plugin would leave one tab unreachable —
                 // fail loudly, mirroring the page-path guard.
                 throw new Error(`plugin “${pluginId}” already registered a settings tab “${contribution.id}”`);
             }
-            stagedTabIds.add(contribution.id);
-            stagedSettingsTabs.push({ ...contribution, pluginId });
+            staged.tabIds.add(contribution.id);
+            staged.settingsTabs.push({ ...contribution, pluginId });
         },
         registerNavEntry(contribution) {
-            if (sealed) {
-                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
-            }
-            const staged = stagedNavEntries.some((e) => e.path === contribution.path);
-            const committed = navEntries.some((e) => e.pluginId === pluginId && e.path === contribution.path);
-            if (staged || committed) {
+            assertOpen();
+            const duplicate = staged.navEntries.some((e) => e.path === contribution.path) ||
+                navEntries.some((e) => e.pluginId === pluginId && e.path === contribution.path);
+            if (duplicate) {
                 // A duplicate nav path within one plugin is an author mistake — two
                 // entries pointing at the same page — so fail loudly like the page guard.
                 throw new Error(`plugin “${pluginId}” already registered a nav entry at “${contribution.path}”`);
             }
-            stagedNavEntries.push({ ...contribution, pluginId });
+            staged.navEntries.push({ ...contribution, pluginId });
         },
     };
-    try {
-        await entry(context);
-    }
-    finally {
-        // Whether `entry` resolved or threw, no further registration is valid — seal
-        // so a deferred call fails loudly rather than pushing into an orphaned array.
-        sealed = true;
-    }
-    // Every nav entry must link to a page THIS plugin registers — staged in this
-    // call or already committed. A nav entry with no matching page is a guaranteed
-    // dead link (the plugin page surface renders "Page not found"), so reject it
-    // loudly. This throws BEFORE the commit loops, so it propagates out of
-    // `loadPlugin` and NOTHING (pages, panels, tabs, nav) commits — atomicity holds.
-    for (const navEntry of stagedNavEntries) {
-        const hasPage = stagedPages.some((p) => p.path === navEntry.path) ||
+}
+/**
+ * Every nav entry must link to a page THIS plugin registers — staged in this call or
+ * already committed. A nav entry with no matching page is a guaranteed dead link (the
+ * plugin page surface renders "Page not found"), so reject it loudly. Throwing here —
+ * BEFORE any commit — keeps atomicity: nothing (pages, panels, tabs, nav) commits.
+ */
+function assertNavEntriesHavePages(pluginId, staged) {
+    for (const navEntry of staged.navEntries) {
+        const hasPage = staged.pages.some((p) => p.path === navEntry.path) ||
             pages.some((p) => p.pluginId === pluginId && p.path === navEntry.path);
         if (!hasPage) {
             throw new Error(`plugin “${pluginId}” registered a nav entry at “${navEntry.path}” but no page at that path`);
         }
     }
-    // `entry` resolved without throwing: commit the staged contributions as one
-    // batch, so the registry only ever holds a plugin's complete set — never a
-    // partial set left behind by a mid-registration failure.
-    for (const page of stagedPages) {
+}
+/**
+ * Commit the staged contributions as one batch, so the registry only ever holds a
+ * plugin's complete set — never a partial set left behind by a mid-registration failure.
+ */
+function commitStaged(staged) {
+    for (const page of staged.pages)
         pages.push(page);
-    }
-    for (const [toolName, contribution] of stagedToolPanels) {
+    for (const [toolName, contribution] of staged.toolPanels)
         toolPanels.set(toolName, contribution);
-    }
-    for (const tab of stagedSettingsTabs) {
+    for (const tab of staged.settingsTabs)
         settingsTabs.push(tab);
-    }
-    for (const navEntry of stagedNavEntries) {
+    for (const navEntry of staged.navEntries)
         navEntries.push(navEntry);
+}
+/**
+ * Load one plugin: call its `register` entry with a context bound to `pluginId`,
+ * then commit everything it staged into the global registry.
+ *
+ * `entry` is AWAITED before commit, so a synchronous or an `async` entry is fully
+ * done first: a post-`await` throw skips the commit (atomicity holds for async too)
+ * and a post-`await` registration cannot slip past the batch. The seal is set after
+ * `entry` has SETTLED, so a later registration throws loudly; registrations made
+ * during `entry`'s synchronous body — including a microtask it enqueues then — are
+ * still captured and committed. A `register` that throws commits nothing.
+ */
+export async function loadPlugin(pluginId, entry) {
+    const staged = emptyStaged();
+    const seal = { closed: false };
+    const context = makeStagingContext(pluginId, staged, seal);
+    try {
+        await entry(context);
+    }
+    finally {
+        // Whether `entry` resolved or threw, no further registration is valid — seal
+        // so a deferred call fails loudly rather than pushing into an orphaned array.
+        seal.closed = true;
     }
+    assertNavEntriesHavePages(pluginId, staged);
+    commitStaged(staged);
 }
 /** The shell reads this after loading every installed plugin bundle. */
 export function getContributions() {

package/dist/plugin/registry.js.map

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

package/dist/schema-form/SecretRefField.d.ts

@@ -2,10 +2,9 @@ import type { ReactNode } from 'react';
 /**
  * The value {@link SecretRefField} emits and reads back. The `source` discriminant
  * is what the host branches on:
- *  - `key`   — reference an existing env key; the host writes `!ENV ${key}`.
+ *  - `key`   — reference an existing env key; the host resolves the reference.
  *  - `paste` — a new plaintext secret; the host stores it under a generated key
- *              (combined op) and writes the resulting marker. `secret` is
- *              write-only and is never rendered.
+ *              and records the reference. `secret` is write-only and never rendered.
  */
 export type SecretRef = {
     readonly source: 'key';

package/dist/schema-form/SecretRefField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SecretRefField.d.ts","sourceRoot":"","sources":["../../src/schema-form/SecretRefField.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,KAAgB,EAChB,QAAuB,GACxB,EAAE,mBAAmB,GAAG,SAAS,CAsIjC"}
+{"version":3,"file":"SecretRefField.d.ts","sourceRoot":"","sources":["../../src/schema-form/SecretRefField.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,KAAgB,EAChB,QAAuB,GACxB,EAAE,mBAAmB,GAAG,SAAS,CAmFjC"}