sh3-core 0.21.2 → 0.22.1

package/dist/shards/lifecycle.test.js

@@ -0,0 +1,139 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { getShardBinding, rotateShardDocumentNamespace, __resetLifecycleForTest, registerAllShards, runAppActivate, runAppDeactivate, rebuildShardEntry, shardEntries, } from './lifecycle.svelte';
+import { registerShard, __resetShardRegistryForTest, erroredShards } from './lifecycle.svelte';
+describe('shards/lifecycle — binding map', () => {
+    beforeEach(() => __resetLifecycleForTest());
+    it('returns null for an unbound shard', () => {
+        expect(getShardBinding('foo')).toBeNull();
+    });
+    it('records and reads back a binding', () => {
+        rotateShardDocumentNamespace('foo', 'myApp');
+        expect(getShardBinding('foo')).toBe('myApp');
+    });
+    it('clears a binding when passed null', () => {
+        rotateShardDocumentNamespace('foo', 'myApp');
+        rotateShardDocumentNamespace('foo', null);
+        expect(getShardBinding('foo')).toBeNull();
+    });
+    it('overwrites an existing binding', () => {
+        rotateShardDocumentNamespace('foo', 'app1');
+        rotateShardDocumentNamespace('foo', 'app2');
+        expect(getShardBinding('foo')).toBe('app2');
+    });
+});
+describe('registerAllShards', () => {
+    beforeEach(() => {
+        __resetLifecycleForTest();
+        __resetShardRegistryForTest();
+    });
+    it('runs register(ctx) on every registered shard', async () => {
+        const registered = [];
+        const shardA = {
+            manifest: { id: 'reg-a', label: 'A', version: '0.0.0', views: [] },
+            register(_ctx) { registered.push('reg-a'); },
+        };
+        const shardB = {
+            manifest: { id: 'reg-b', label: 'B', version: '0.0.0', views: [] },
+            register(_ctx) { registered.push('reg-b'); },
+        };
+        registerShard(shardA);
+        registerShard(shardB);
+        await registerAllShards();
+        expect(registered.sort()).toEqual(['reg-a', 'reg-b']);
+        expect(shardEntries.has('reg-a')).toBe(true);
+        expect(shardEntries.has('reg-b')).toBe(true);
+    });
+    it('verifies every manifest view received a factory', async () => {
+        var _a;
+        const shardWithMissingFactory = {
+            manifest: { id: 'miss-x', label: 'X', version: '0.0.0', views: [{ id: 'miss-x:view', label: 'V' }] },
+            register(_ctx) { },
+        };
+        registerShard(shardWithMissingFactory);
+        await expect(registerAllShards()).resolves.toBeUndefined();
+        expect((_a = erroredShards.get('miss-x')) === null || _a === void 0 ? void 0 : _a.error).toBeInstanceOf(Error);
+    });
+    it('continues registering remaining shards when one throws', async () => {
+        const calls = [];
+        const shardBad = {
+            manifest: { id: 'bad-reg', label: 'Bad', version: '0.0.0', views: [] },
+            register(_ctx) { calls.push('bad-reg'); throw new Error('boom'); },
+        };
+        const shardGood = {
+            manifest: { id: 'good-reg', label: 'Good', version: '0.0.0', views: [] },
+            register(_ctx) { calls.push('good-reg'); },
+        };
+        registerShard(shardBad);
+        registerShard(shardGood);
+        await registerAllShards();
+        expect(calls).toContain('good-reg');
+    });
+});
+describe('runAppActivate / runAppDeactivate', () => {
+    beforeEach(() => {
+        __resetLifecycleForTest();
+        __resetShardRegistryForTest();
+    });
+    it('rotates document namespace and calls onAppActivate', async () => {
+        const calls = [];
+        const shard = {
+            manifest: { id: 'rotation-s', label: 'S', version: '0.0.0', views: [] },
+            register(_ctx) { },
+            onAppActivate(_ctx, appId) {
+                calls.push({ hook: 'activate', appId });
+            },
+            onAppDeactivate(_ctx, appId) {
+                calls.push({ hook: 'deactivate', appId });
+            },
+        };
+        registerShard(shard);
+        await registerAllShards();
+        await runAppActivate('rotation-s', 'myApp');
+        expect(getShardBinding('rotation-s')).toBe('myApp');
+        expect(calls).toContainEqual({ hook: 'activate', appId: 'myApp' });
+        await runAppDeactivate('rotation-s', 'myApp');
+        expect(getShardBinding('rotation-s')).toBeNull();
+        expect(calls).toContainEqual({ hook: 'deactivate', appId: 'myApp' });
+    });
+    it('auto-disposes contributions registered inside onAppActivate', async () => {
+        const shard = {
+            manifest: { id: 'bag-s', label: 'S', version: '0.0.0', views: [] },
+            register(_ctx) { },
+            onAppActivate(ctxParam) {
+                const ctx = ctxParam;
+                ctx.actions.register({ id: 'bag-s.action', label: 'A', scope: ['app'], run() { } });
+            },
+        };
+        registerShard(shard);
+        await registerAllShards();
+        await runAppActivate('bag-s', 'myApp');
+        const { listActions } = await import('../actions/registry');
+        expect(listActions().find(e => e.action.id === 'bag-s.action')).toBeDefined();
+        await runAppDeactivate('bag-s', 'myApp');
+        expect(listActions().find(e => e.action.id === 'bag-s.action')).toBeUndefined();
+    });
+});
+describe('hot-swap on re-register', () => {
+    beforeEach(() => {
+        __resetLifecycleForTest();
+        __resetShardRegistryForTest();
+    });
+    it('tears down old entry and rebuilds when shard re-registers', async () => {
+        var _a, _b, _c;
+        const original = {
+            manifest: { id: 'hot-s', label: 'Original', version: '0.0.0', views: [] },
+            register(_ctx) { },
+        };
+        registerShard(original);
+        await registerAllShards();
+        expect((_a = shardEntries.get('hot-s')) === null || _a === void 0 ? void 0 : _a.shard.manifest.label).toBe('Original');
+        const updated = {
+            manifest: { id: 'hot-s', label: 'Updated', version: '0.0.1', views: [] },
+            register(_ctx) { },
+        };
+        registerShard(updated);
+        await rebuildShardEntry('hot-s');
+        expect((_b = shardEntries.get('hot-s')) === null || _b === void 0 ? void 0 : _b.shard.manifest.label).toBe('Updated');
+        expect((_c = shardEntries.get('hot-s')) === null || _c === void 0 ? void 0 : _c.shard.manifest.version).toBe('0.0.1');
+    });
+});

package/dist/shards/types.d.ts

@@ -1,6 +1,6 @@
 import type { StateZones } from '../state/zones.svelte';
 import type { ZoneSchema, ZoneManager } from '../state/types';
-import type { DocumentHandle, DocumentHandleOptions } from '../documents/types';
+import type { DocumentHandle } from '../documents/types';
 import type { BrowseCapability } from '../documents/browse';
 import type { DocumentPickerApi } from '../documents/picker-api';
 import type { EnvState } from '../env/types';
@@ -9,7 +9,7 @@ import type { Sh3Api } from '../verbs/types';
 import type { ShardContextKeys } from '../keys/types';
 import type { ContributionsApi } from '../contributions/types';
 import type { ActionsApi } from '../actions/types';
-import type { TreeRootRef, SlotRole } from '../layout/types';
+import type { TreeRootRef, SlotRole, JsonValue, RestoredSlot } from '../layout/types';
 export { PERMISSION_KEYS_MINT, type ShardContextKeys, type ApiKeyPublic, type MintOpts, ScopeEscalationError, ConsentDeniedError } from '../keys/types';
 /**
  * The object returned by `ViewFactory.mount`. The framework calls
@@ -65,6 +65,13 @@ export interface MountContext {
      * Not persisted with the layout — ephemeral per mount.
      */
     meta?: Record<string, unknown>;
+    /**
+     * Persistent view-level parameters passed by the caller when opening
+     * this view. Serialized with the layout tree — present on every mount
+     * including layout restore. Undefined when the slot was opened without
+     * props. Values are JSON-safe (`JsonValue`).
+     */
+    props?: Record<string, JsonValue>;
     /**
      * Push dirty-state to the tab strip. The framework renders a dirty
      * indicator (filled dot) on the tab when true, clears it when false.
@@ -217,8 +224,13 @@ export interface ShardContext {
      * @param verb - The verb definition (name, summary, run function).
      */
     registerVerb(verb: Verb): void;
-    /** Obtain a file-oriented document handle scoped to this shard. */
-    documents(options: DocumentHandleOptions): DocumentHandle;
+    /**
+     * Pre-minted document handle for this shard. Format moves per-call via
+     * readText/writeText/readJson/writeJson/readBinary/writeBinary. The
+     * handle's namespace resolves lazily on every operation — `{shardId}`
+     * when no app is bound, `{appId}` while a required-of app is active.
+     */
+    documents: DocumentHandle;
     /**
      * Cross-origin-safe HTTP helper. Resolves relative `/api/...` paths
      * against the configured serverUrl. In Tauri, routes through
@@ -344,23 +356,14 @@ export interface Shard {
     /** Static description of this shard's identity and declared contributions. */
     manifest: ShardManifest;
     /**
-     * Run once when the shard is activated. Use `ctx` to declare state zones,
-     * register view factories, and obtain document handles. Must register a
-     * factory for every view id declared in `manifest.views`.
-     */
-    activate(ctx: ShardContext): void | Promise<void>;
-    /**
-     * Optional self-starting hook. A shard that defines `autostart` is
-     * eagerly activated by the framework at boot (right after the register
-     * pass finishes) instead of waiting for an app to require it. `activate`
-     * runs first; `autostart` runs immediately after and may take imperative
-     * action — docking its own views into the active layout, opening a
-     * modal, subscribing to framework state, etc. The `__sh3core__` pseudo-
-     * shard uses this with a no-op body so its activation path is uniform
-     * with other self-starting shards. Diagnostic-style shards use it to
-     * do real work.
+     * Runs once at SH3 boot, for every registered shard, unconditionally.
+     * The only place to declare state zones, register views, verbs, actions,
+     * custom elements, contributions, and reactive effects. Everything
+     * registered here lives for the rest of the SH3 session.
+     *
+     * v3 contract — replaces v2's `activate()` + `autostart()` + `registerContributions()`.
      */
-    autostart?(ctx: ShardContext): void | Promise<void>;
+    register(ctx: ShardContext): void | Promise<void>;
     /** Optional cleanup hook called when the shard is deactivated. Release timers, subscriptions, and external resources here. */
     deactivate?(): void | Promise<void>;
     /**
@@ -368,14 +371,45 @@ export interface Shard {
      * remains active; its views and state are preserved. Return `false`
      * (sync or async) to cancel the navigation.
      */
-    suspend?(): void | false | Promise<void | false>;
+    suspend?(ctx: ShardContext): void | false | Promise<void | false>;
     /**
      * Called when the owning app resumes from Home. Receives the same
      * `ShardContext` that `activate` received.
      */
     resume?(ctx: ShardContext): void | Promise<void>;
     /** Fires when a key minted by this shard is revoked from any source. */
-    onKeyRevoked?(id: string): void | Promise<void>;
+    onKeyRevoked?(ctx: ShardContext, id: string): void | Promise<void>;
+    /**
+     * Called when an app that lists this shard in `requiredShards` launches.
+     * v3 signature: receives the shard's ctx plus the activating app's id.
+     * The shard's `ctx.documents` namespace has already been rotated to the
+     * app's namespace before this fires. Disposers from registrations made
+     * inside this hook are tracked in a per-app bag and auto-cleared on
+     * the matching `onAppDeactivate`.
+     */
+    onAppActivate?(ctx: ShardContext, appId: string): void | Promise<void>;
+    /**
+     * Called when an app that requires this shard unloads. v3 signature:
+     * receives ctx + appId. The shard stays alive; only per-app
+     * registrations (those added inside `onAppActivate`) are torn down.
+     */
+    onAppDeactivate?(ctx: ShardContext, appId: string): void | Promise<void>;
+    /**
+     * Called BEFORE layout slots begin mounting, after all required shards have
+     * activated. `slots` contains every slot in the restored layout tree that
+     * has a non-null viewId, including their persisted `props`. Register any
+     * slot-specific contributions here (e.g. `EDITOR_DOCUMENT_POINT` keyed by
+     * `slotId`) so they are in place when the view factory's `mount()` is called.
+     */
+    onLayoutWillRestore?(ctx: ShardContext, slots: RestoredSlot[]): void | Promise<void>;
+    /**
+     * Called AFTER the layout has been switched to the app's tree and slots
+     * have begun mounting. Use for post-mount wiring and reconciliation.
+     * Note: view factories may still be mounting asynchronously (microtask);
+     * this hook fires after the layout render, not after all `mount()` calls
+     * have returned.
+     */
+    onLayoutRestored?(ctx: ShardContext, slots: RestoredSlot[]): void;
 }
 /**
  * Source-level shape of a shard as written by external package authors.

package/dist/shell-shard/shellShard.svelte.js

@@ -25,10 +25,11 @@ import { focusView } from '../layout/inspection';
 import { floatManager } from '../overlays/float';
 import { getUser, isAdmin } from '../auth/index';
 import { __bindZone, __unbindZone } from './buffer-zone-state.svelte';
+import { getAuthToken } from '../transport/authToken';
 export { makeSh3ApiHeadless, makeSh3ApiForTest } from '../sh3Api/headless';
 export const shellShard = {
     manifest,
-    activate(ctx) {
+    register(ctx) {
         registerV1Verbs(ctx);
         const shell = makeSh3ApiHeadless(ctx.zones);
         // Bind the shell-shard's workspace zone — backs scrollback persistence
@@ -58,7 +59,15 @@ export const shellShard = {
                 var _a;
                 const proto = typeof location !== 'undefined' && location.protocol === 'https:' ? 'wss' : 'ws';
                 const host = typeof location !== 'undefined' ? location.host : 'localhost';
-                const wsUrl = `${proto}://${host}/api/shell/session`;
+                let wsUrl = `${proto}://${host}/api/shell/session`;
+                // Tauri WebSocket can't set Authorization headers; use the query-param
+                // token fallback already supported by extractSessionToken() in auth.ts.
+                const isTauri = typeof window !== 'undefined' && ('__TAURI_INTERNALS__' in window || '__TAURI__' in window);
+                if (isTauri) {
+                    const tok = getAuthToken();
+                    if (tok)
+                        wsUrl += `?token=${encodeURIComponent(tok)}`;
+                }
                 const user = getUser();
                 const userId = (_a = user === null || user === void 0 ? void 0 : user.id) !== null && _a !== void 0 ? _a : 'guest';
                 const role = isAdmin() ? 'admin' : 'user';
@@ -76,9 +85,6 @@ export const shellShard = {
         };
         ctx.registerView('shell:terminal', factory);
     },
-    autostart() {
-        // Intentionally empty — same pattern as __sh3core__.
-    },
     deactivate() {
         __unbindZone();
     },

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.21.2";
+export declare const VERSION = "0.22.1";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.21.2';
+export const VERSION = '0.22.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.21.2",
+  "version": "0.22.1",
   "type": "module",
   "files": [
     "dist"

package/dist/shards/activate-browse.test.js

@@ -1,120 +0,0 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setActiveScope } from '../documents/config';
-import { registerShard, activateShard, __resetShardRegistryForTest } from './activate.svelte';
-import { PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ, PERMISSION_DOCUMENTS_WRITE, } from '../documents/types';
-describe('ctx.browse permission gating', () => {
-    beforeEach(() => {
-        __resetShardRegistryForTest();
-        __setDocumentBackend(new MemoryDocumentBackend());
-        __setActiveScope('tenant-a');
-    });
-    it('is undefined when no documents permission is declared', async () => {
-        let captured = null;
-        registerShard({
-            manifest: { id: 'no-browse', label: 'n', version: '0.0.0', views: [] },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('no-browse');
-        expect(captured.browse).toBeUndefined();
-    });
-    it('exposes metadata methods when documents:browse is declared', async () => {
-        var _a, _b, _c;
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'has-browse', label: 'b', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_BROWSE],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('has-browse');
-        expect(typeof ((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.listDocuments)).toBe('function');
-        expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.watchDocuments)).toBe('function');
-        expect(typeof ((_c = captured.browse) === null || _c === void 0 ? void 0 : _c.listShards)).toBe('function');
-    });
-    it('omits readFrom and writeTo when only documents:browse is declared', async () => {
-        var _a, _b;
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'browse-only', label: 'b', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_BROWSE],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('browse-only');
-        expect((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom).toBeUndefined();
-        expect((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo).toBeUndefined();
-    });
-    it('exposes readFrom when documents:browse + documents:read are declared', async () => {
-        var _a, _b;
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'browse-and-read', label: 'br', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('browse-and-read');
-        expect(typeof ((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom)).toBe('function');
-        expect((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo).toBeUndefined();
-    });
-    it('exposes writeTo when documents:browse + documents:write are declared', async () => {
-        var _a, _b;
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'browse-and-write', label: 'bw', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_WRITE],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('browse-and-write');
-        expect((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom).toBeUndefined();
-        expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo)).toBe('function');
-    });
-    it('exposes both readFrom and writeTo when all three permissions are declared', async () => {
-        var _a, _b;
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'full-access', label: 'full', version: '0.0.0', views: [],
-                permissions: [
-                    PERMISSION_DOCUMENTS_BROWSE,
-                    PERMISSION_DOCUMENTS_READ,
-                    PERMISSION_DOCUMENTS_WRITE,
-                ],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('full-access');
-        expect(typeof ((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom)).toBe('function');
-        expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo)).toBe('function');
-    });
-    it('yields no ctx.browse when documents:read is declared without documents:browse', async () => {
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'read-only', label: 'r', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_READ],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('read-only');
-        expect(captured.browse).toBeUndefined();
-    });
-    it('yields no ctx.browse when documents:write is declared without documents:browse', async () => {
-        let captured = null;
-        registerShard({
-            manifest: {
-                id: 'write-only', label: 'w', version: '0.0.0', views: [],
-                permissions: [PERMISSION_DOCUMENTS_WRITE],
-            },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('write-only');
-        expect(captured.browse).toBeUndefined();
-    });
-});

package/dist/shards/activate-contributions.test.js

@@ -1,141 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setActiveScope } from '../documents/config';
-import { registerShard, activateShard, deactivateShard, __resetShardRegistryForTest, } from './activate.svelte';
-import { __resetContributionsForTest, list, listPoints } from '../contributions';
-describe('ctx.contributions', () => {
-    beforeEach(() => {
-        __resetShardRegistryForTest();
-        __resetContributionsForTest();
-        __setDocumentBackend(new MemoryDocumentBackend());
-        __setActiveScope('tenant-a');
-    });
-    it('is always present on ShardContext (no permission required)', async () => {
-        let captured = null;
-        registerShard({
-            manifest: { id: 'a', label: 'A', version: '0.0.0', views: [] },
-            activate(ctx) { captured = ctx; },
-        });
-        await activateShard('a');
-        expect(typeof captured.contributions.register).toBe('function');
-        expect(typeof captured.contributions.list).toBe('function');
-        expect(typeof captured.contributions.listPoints).toBe('function');
-        expect(typeof captured.contributions.onChange).toBe('function');
-    });
-    it('register() makes the descriptor visible via the global list()', async () => {
-        registerShard({
-            manifest: { id: 'provider', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('my.point', { id: 'alpha' });
-            },
-        });
-        await activateShard('provider');
-        expect(list('my.point')).toEqual([{ id: 'alpha' }]);
-    });
-    it('deactivate auto-unregisters every descriptor the shard registered', async () => {
-        registerShard({
-            manifest: { id: 'provider', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('p1', { id: 'a' });
-                ctx.contributions.register('p1', { id: 'b' });
-                ctx.contributions.register('p2', { id: 'c' });
-            },
-        });
-        await activateShard('provider');
-        expect(list('p1')).toHaveLength(2);
-        expect(list('p2')).toHaveLength(1);
-        deactivateShard('provider');
-        expect(list('p1')).toEqual([]);
-        expect(list('p2')).toEqual([]);
-        expect(listPoints()).toEqual([]);
-    });
-    it('deactivate auto-unsubscribes every onChange listener the shard registered', async () => {
-        const cb = vi.fn();
-        registerShard({
-            manifest: { id: 'watcher', label: 'W', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.onChange('p', cb);
-            },
-        });
-        await activateShard('watcher');
-        registerShard({
-            manifest: { id: 'provider', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('p', { id: 'x' });
-            },
-        });
-        await activateShard('provider');
-        expect(cb).toHaveBeenCalledTimes(1);
-        deactivateShard('watcher');
-        // Further registrations must not reach the watcher's callback.
-        registerShard({
-            manifest: { id: 'provider-2', label: 'P2', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('p', { id: 'y' });
-            },
-        });
-        await activateShard('provider-2');
-        expect(cb).toHaveBeenCalledTimes(1);
-    });
-    it('two shards can contribute to the same point independently', async () => {
-        registerShard({
-            manifest: { id: 'a', label: 'A', version: '0.0.0', views: [] },
-            activate(ctx) { ctx.contributions.register('shared', { from: 'a' }); },
-        });
-        registerShard({
-            manifest: { id: 'b', label: 'B', version: '0.0.0', views: [] },
-            activate(ctx) { ctx.contributions.register('shared', { from: 'b' }); },
-        });
-        await activateShard('a');
-        await activateShard('b');
-        expect(list('shared')).toEqual([{ from: 'a' }, { from: 'b' }]);
-        deactivateShard('a');
-        expect(list('shared')).toEqual([{ from: 'b' }]);
-    });
-    it('explicit unregister returned by register() is safe alongside auto-cleanup', async () => {
-        let earlyUnregister;
-        registerShard({
-            manifest: { id: 'p', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
-                earlyUnregister = ctx.contributions.register('p', { id: 'a' });
-            },
-        });
-        await activateShard('p');
-        expect(list('p')).toHaveLength(1);
-        earlyUnregister();
-        expect(list('p')).toEqual([]);
-        // Deactivate must not throw when the entry is already gone.
-        expect(() => deactivateShard('p')).not.toThrow();
-    });
-    it('onAnyChange fires for register/unregister at any point and auto-unsubscribes on deactivate', async () => {
-        const cb = vi.fn();
-        registerShard({
-            manifest: { id: 'watcher', label: 'W', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.onAnyChange(cb);
-            },
-        });
-        await activateShard('watcher');
-        registerShard({
-            manifest: { id: 'p1', label: 'P1', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('point.a', { id: 'x' });
-                ctx.contributions.register('point.b', { id: 'y' });
-            },
-        });
-        await activateShard('p1');
-        expect(cb).toHaveBeenCalledTimes(2);
-        expect(cb).toHaveBeenCalledWith('point.a');
-        expect(cb).toHaveBeenCalledWith('point.b');
-        deactivateShard('watcher');
-        cb.mockClear();
-        registerShard({
-            manifest: { id: 'p2', label: 'P2', version: '0.0.0', views: [] },
-            activate(ctx) {
-                ctx.contributions.register('point.c', { id: 'z' });
-            },
-        });
-        await activateShard('p2');
-        expect(cb).not.toHaveBeenCalled();
-    });
-});