sh3-core 0.22.0 → 0.22.2

package/dist/__test__/fixtures.js

@@ -25,7 +25,7 @@ export function makeShardManifest(overrides = {}) {
 }
 export function makeShard(overrides = {}) {
     var _a;
-    return Object.assign({ manifest: makeShardManifest(overrides.manifest), activate: (_a = overrides.activate) !== null && _a !== void 0 ? _a : (() => { }), deactivate: overrides.deactivate }, overrides);
+    return Object.assign({ manifest: makeShardManifest(overrides.manifest), register: (_a = overrides.register) !== null && _a !== void 0 ? _a : (() => { }), deactivate: overrides.deactivate }, overrides);
 }
 export function makeSlotNode(slotId, viewId) {
     const id = slotId !== null && slotId !== void 0 ? slotId : uid('slot');

package/dist/__test__/reset.js

@@ -8,8 +8,7 @@ import { __resetDragStateForTest } from '../layout/drag.svelte';
 import { __resetLayoutStoreForTest } from '../layout/store.svelte';
 import { resetSlotHostPool } from '../layout/slotHostPool.svelte';
 import { __resetViewRegistryForTest } from '../shards/registry';
-import { __resetShardRegistryForTest } from '../shards/activate.svelte';
-import { __resetShardBindingsForTest } from '../shards/app-binding.svelte';
+import { __resetShardRegistryForTest } from '../shards/lifecycle.svelte';
 import { __resetAppRegistryForTest } from '../apps/registry.svelte';
 import { __resetDispatcherStateForTest } from '../actions/state.svelte';
 import { __resetSelectionForTest } from '../actions/selection.svelte';
@@ -36,7 +35,6 @@ export function resetFramework() {
     resetSlotHostPool();
     __resetViewRegistryForTest();
     __resetShardRegistryForTest();
-    __resetShardBindingsForTest();
     __resetAppRegistryForTest();
     __resetDispatcherStateForTest();
     __resetSelectionForTest();

package/dist/__test__/smoke.test.js

@@ -1,11 +1,11 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { resetFramework } from './reset';
 import { registeredApps, activeApp } from '../apps/registry.svelte';
-import { registeredShards, activeShards } from '../shards/activate.svelte';
+import { registeredShards, activeShards } from '../shards/lifecycle.svelte';
 import { layoutStore } from '../layout/store.svelte';
 import { makeApp, makeShard } from './fixtures';
 import { registerApp } from '../apps/registry.svelte';
-import { registerShard } from '../shards/activate.svelte';
+import { registerShard } from '../shards/lifecycle.svelte';
 describe('resetFramework', () => {
     beforeEach(resetFramework);
     it('returns all registries and the layout store to boot state', () => {

package/dist/actions/contextMenuModel.test.js

@@ -4,7 +4,7 @@ const mkEntry = (a, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, a),
 });
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('buildContextMenuModel', () => {
     it('returns only actions with contextItem: true', () => {
         const entries = [
@@ -59,7 +59,10 @@ describe('buildContextMenuModel', () => {
         const model = buildContextMenuModel(entries, state, { element: 'cell' });
         expect(model.tiers).toEqual([]);
     });
-    it('app anchor honors the owner-shard guard', () => {
+    it('app anchor admits app-scoped actions from any shard once an app is active (v3)', () => {
+        // v3: scope 'app' means "active while any app is launched", regardless
+        // of which shard owns the action. The dispatcher no longer guards on
+        // ownerShardId / activeAppRequiredShards.
         const state = mkState({
             activeAppId: 'app.a',
             activeAppRequiredShards: new Set(['shard.x']),
@@ -69,7 +72,7 @@ describe('buildContextMenuModel', () => {
             mkEntry({ id: 'foreign', scope: 'app', contextItem: true, label: 'F' }, 'shard.y'),
         ];
         const model = buildContextMenuModel(entries, state, 'app');
-        expect(model.tiers.flatMap((t) => t.items).map((i) => i.id)).toEqual(['mine']);
+        expect(model.tiers.flatMap((t) => t.items).map((i) => i.id).sort()).toEqual(['foreign', 'mine']);
     });
     it('home anchor only admits actions when no app is active', () => {
         const noApp = mkState();

package/dist/actions/ctx-actions.svelte.test.js

@@ -1,7 +1,7 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
 import { __setDocumentBackend, __setActiveScope } from '../documents/config';
-import { registerShard, activateShard, __resetShardRegistryForTest, } from '../shards/activate.svelte';
+import { registerShard, activateShard, __resetShardRegistryForTest, } from '../shards/lifecycle.svelte';
 import { __resetViewRegistryForTest } from '../shards/registry';
 import { __resetActionsRegistryForTest } from './registry';
 import { __resetContributionsForTest } from '../contributions/registry';
@@ -19,7 +19,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
     it('listActions enumerates actions registered by other shards', async () => {
         registerShard({
             manifest: { id: 'producer', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
+            register(ctx) {
                 ctx.actions.register({
                     id: 'producer.do',
                     label: 'Do',
@@ -31,7 +31,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         let consumerCtx = null;
         registerShard({
             manifest: { id: 'consumer', label: 'C', version: '0.0.0', views: [] },
-            activate(ctx) { consumerCtx = ctx; },
+            register(ctx) { consumerCtx = ctx; },
         });
         await activateShard('producer');
         await activateShard('consumer');
@@ -45,7 +45,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
     it('listActions({ activeOnly: true }) filters out inactive actions', async () => {
         registerShard({
             manifest: { id: 'producer', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
+            register(ctx) {
                 ctx.actions.register({
                     id: 'home.go', label: 'H', scope: 'home', run: () => { },
                 });
@@ -58,7 +58,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         let consumerCtx = null;
         registerShard({
             manifest: { id: 'consumer', label: 'C', version: '0.0.0', views: [] },
-            activate(ctx) { consumerCtx = ctx; },
+            register(ctx) { consumerCtx = ctx; },
         });
         await activateShard('producer');
         await activateShard('consumer');
@@ -71,7 +71,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         let invokedVia = null;
         registerShard({
             manifest: { id: 'producer', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
+            register(ctx) {
                 ctx.actions.register({
                     id: 'producer.go',
                     label: 'Go',
@@ -83,7 +83,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         let consumerCtx = null;
         registerShard({
             manifest: { id: 'consumer', label: 'C', version: '0.0.0', views: [] },
-            activate(ctx) { consumerCtx = ctx; },
+            register(ctx) { consumerCtx = ctx; },
         });
         await activateShard('producer');
         await activateShard('consumer');
@@ -93,7 +93,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
     it('runAction rejects when the target action is inactive', async () => {
         registerShard({
             manifest: { id: 'producer', label: 'P', version: '0.0.0', views: [] },
-            activate(ctx) {
+            register(ctx) {
                 ctx.actions.register({
                     id: 'gated.go', label: 'G', scope: 'app', run: () => { },
                 });
@@ -102,7 +102,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         let consumerCtx = null;
         registerShard({
             manifest: { id: 'consumer', label: 'C', version: '0.0.0', views: [] },
-            activate(ctx) { consumerCtx = ctx; },
+            register(ctx) { consumerCtx = ctx; },
         });
         await activateShard('producer');
         await activateShard('consumer');

package/dist/actions/dispatcher-v3.test.js

@@ -0,0 +1,8 @@
+import { describe, it, expect } from 'vitest';
+import { getLiveDispatcherState } from './state.svelte';
+describe('dispatcher state — v3', () => {
+    it('no longer exposes autostartShards', () => {
+        const state = getLiveDispatcherState();
+        expect('autostartShards' in state).toBe(false);
+    });
+});

package/dist/actions/dispatcher.svelte.d.ts

@@ -4,7 +4,6 @@ import type { Platform } from './shortcuts';
 export interface DispatcherState {
     activeAppId: string | null;
     activeAppRequiredShards: Set<string>;
-    autostartShards: Set<string>;
     mountedViewIds: Set<string>;
     focusedViewId: string | null;
     selection: Selection | null;
@@ -20,7 +19,7 @@ export interface TierIndex {
     app: Map<string, string>;
     home: Map<string, string>;
 }
-export declare function isScopeActive(scope: AtomicScope, state: DispatcherState, ownerShardId?: string): boolean;
+export declare function isScopeActive(scope: AtomicScope, state: DispatcherState, _ownerShardId?: string): boolean;
 export declare function buildTierIndex(entries: ActionEntry[], state: DispatcherState): TierIndex;
 export interface KeydownEnv {
     target: EventTarget | null;

package/dist/actions/dispatcher.svelte.js

@@ -8,17 +8,16 @@ import { resolveLabel } from './types';
 import { effectiveShortcut } from './bindings';
 import { scopeToTier, normalizeScope } from './scope-helpers';
 export const TIER_ORDER = ['element', 'focus', 'view', 'app', 'home'];
-export function isScopeActive(scope, state, ownerShardId) {
+export function isScopeActive(scope, state, _ownerShardId) {
     if (scope === 'home') {
         return state.activeAppId === null;
     }
     if (scope === 'app') {
-        if (state.activeAppId === null)
-            return false;
-        if (!ownerShardId)
-            return false;
-        return (state.activeAppRequiredShards.has(ownerShardId) ||
-            state.autostartShards.has(ownerShardId));
+        // v3: scope 'app' means "active while any app is launched", regardless
+        // of which shard owns the action. The dispatcher no longer gates on
+        // shard ownership — every shard registered with register() can
+        // contribute app-scoped actions that fire inside any app.
+        return state.activeAppId !== null;
     }
     if (typeof scope === 'string') {
         if (scope.startsWith('view:')) {

package/dist/actions/dispatcher.test.js

@@ -4,28 +4,27 @@ const mkEntry = (action, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, action),
 });
-const mkState = (overrides = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, overrides));
+const mkState = (overrides = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, overrides));
 describe('isScopeActive', () => {
     it('home active iff no app', () => {
         expect(isScopeActive('home', mkState())).toBe(true);
         expect(isScopeActive('home', mkState({ activeAppId: 'app.a' }))).toBe(false);
     });
-    it('app active when app is loaded and declaring shard is required', () => {
+    it('app active for ANY shard when an app is loaded (v3 — owner gate removed)', () => {
         const state = mkState({
             activeAppId: 'app.a',
             activeAppRequiredShards: new Set(['shard.x']),
         });
         expect(isScopeActive('app', state, 'shard.x')).toBe(true);
-        expect(isScopeActive('app', state, 'shard.y')).toBe(false);
-    });
-    it('app active for autostart shards regardless of requiredShards', () => {
-        const state = mkState({
-            activeAppId: 'app.a',
-            activeAppRequiredShards: new Set(),
-            autostartShards: new Set(['__sh3core__']),
-        });
+        // v3: owner shard no longer gates app-scoped actions.
+        expect(isScopeActive('app', state, 'shard.y')).toBe(true);
+        // v3: no autostart concept — same rule applies.
         expect(isScopeActive('app', state, '__sh3core__')).toBe(true);
     });
+    it('app inactive when no app is loaded', () => {
+        const state = mkState({ activeAppId: null });
+        expect(isScopeActive('app', state, 'shard.x')).toBe(false);
+    });
     it('view:X active iff X is mounted', () => {
         const state = mkState({ mountedViewIds: new Set(['editor']) });
         expect(isScopeActive('view:editor', state)).toBe(true);
@@ -66,7 +65,6 @@ describe('buildTierIndex', () => {
         ];
         const state = mkState({
             activeAppId: null, // home active
-            autostartShards: new Set(['shard.x']),
         });
         const idx = buildTierIndex(entries, state);
         // Home is active; app is not (no app).
@@ -127,7 +125,6 @@ describe('dispatchKeydown', () => {
         const state = mkState({
             activeAppId: 'a',
             activeAppRequiredShards: new Set(),
-            autostartShards: new Set(['__sh3core__']),
             selection: { type: 'orb', ref: 1, ownerShardId: 's' },
         });
         const result = dispatchKeydown(mkEnv({ entries, runAction, state }));

package/dist/actions/listActionsFromEntries.test.js

@@ -4,7 +4,7 @@ const mkEntry = (a, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, a),
 });
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('listActionsFromEntries', () => {
     it('returns [] for an empty registry', () => {
         expect(listActionsFromEntries([], mkState())).toEqual([]);
@@ -55,7 +55,6 @@ describe('listActionsFromEntries', () => {
         ];
         const state = mkState({
             activeAppId: null, // app tier inactive
-            autostartShards: new Set(['__sh3core__']),
             mountedViewIds: new Set(['editor']),
         });
         const out = listActionsFromEntries(entries, state);

package/dist/actions/listActive.test.js

@@ -4,7 +4,7 @@ const mkEntry = (a, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, a),
 });
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('listActiveFromEntries', () => {
     it('omits actions whose scope is not active', () => {
         const entries = [mkEntry({ id: 'p', scope: 'app' })];
@@ -27,7 +27,7 @@ describe('listActiveFromEntries', () => {
                 id: 'm', scope: ['app', 'view:editor'],
             }, '__sh3core__')];
         const state = mkState({
-            activeAppId: 'a', autostartShards: new Set(['__sh3core__']),
+            activeAppId: 'a',
             mountedViewIds: new Set(['editor']),
         });
         const out = listActiveFromEntries(entries, state);
@@ -76,7 +76,6 @@ describe('listActiveFromEntries', () => {
         ];
         const state = mkState({
             activeAppId: 'a',
-            autostartShards: new Set(['__sh3core__']),
             mountedViewIds: new Set(['editor']),
         });
         const out = listActiveFromEntries(entries, state);

package/dist/actions/menuBarModel.test.js

@@ -4,7 +4,7 @@ const mkEntry = (a, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, a),
 });
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('resolveMenuContainers', () => {
     it('returns [] when no app is active', () => {
         expect(resolveMenuContainers(null, undefined)).toEqual([]);
@@ -72,7 +72,6 @@ describe('resolveMenuItems', () => {
         const state = mkState({
             activeAppId: 'app.a',
             activeAppRequiredShards: new Set(['shard.x']),
-            autostartShards: new Set(['shard.x']),
         });
         const entries = [
             mkEntry({ id: 'p', scope: ['home', 'app'], menuItem: 'file', label: 'P' }),
@@ -161,7 +160,6 @@ describe("resolveMenuItems — required-shard menu filter (issue #32)", () => {
         const state = mkState({
             activeAppId: 'other-app',
             activeAppRequiredShards: new Set(['other-shard']),
-            autostartShards: new Set(['guml.core']),
         });
         const entries = [
             mkEntry({ id: 'guml.project.new', scope: 'app', menuItem: 'file', label: 'New Project…' }, 'guml.core'),
@@ -172,7 +170,6 @@ describe("resolveMenuItems — required-shard menu filter (issue #32)", () => {
         const state = mkState({
             activeAppId: 'guml-ide',
             activeAppRequiredShards: new Set(['guml.core']),
-            autostartShards: new Set(['guml.core']),
         });
         const entries = [
             mkEntry({ id: 'guml.project.new', scope: 'app', menuItem: 'file', label: 'New Project…' }, 'guml.core'),
@@ -184,7 +181,6 @@ describe("resolveMenuItems — required-shard menu filter (issue #32)", () => {
         const state = mkState({
             activeAppId: 'other-app',
             activeAppRequiredShards: new Set(['other-shard']),
-            autostartShards: new Set(['guml.core']),
             mountedViewIds: new Set(['editor']),
         });
         const entries = [
@@ -196,7 +192,6 @@ describe("resolveMenuItems — required-shard menu filter (issue #32)", () => {
         const state = mkState({
             activeAppId: 'other-app',
             activeAppRequiredShards: new Set(['other-shard']),
-            autostartShards: new Set(['guml.core']),
         });
         const entries = [
             mkEntry({ id: 'g.global', scope: ['home', 'app'], menuItem: 'file', label: 'Global' }, 'guml.core'),
@@ -207,7 +202,6 @@ describe("resolveMenuItems — required-shard menu filter (issue #32)", () => {
         const state = mkState({
             activeAppId: 'other-app',
             activeAppRequiredShards: new Set(['other-shard']),
-            autostartShards: new Set(['guml.core']),
         });
         const entries = [
             mkEntry({ id: 'g.parent', scope: 'app', menuItem: 'file', label: 'GUML', submenu: true }, 'guml.core'),

package/dist/actions/paletteModel.test.js

@@ -4,7 +4,7 @@ const mkEntry = (a, owner = 'shard.x') => ({
     ownerShardId: owner,
     action: Object.assign({ id: 'a', label: 'A', scope: 'home', run: () => { } }, a),
 });
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('buildPaletteCandidates', () => {
     it('includes actions with paletteItem default true', () => {
         const entries = [mkEntry({ id: 'x', scope: 'home', label: 'X' })];
@@ -25,7 +25,6 @@ describe('buildPaletteCandidates', () => {
         const entries = [mkEntry({ id: 'p', scope: ['home', 'app'], label: 'P' }, '__sh3core__')];
         const state = mkState({
             activeAppId: 'a',
-            autostartShards: new Set(['__sh3core__']),
         });
         const out = buildPaletteCandidates(entries, state);
         expect(out).toHaveLength(1);
@@ -39,7 +38,6 @@ describe('buildPaletteCandidates', () => {
         ];
         const state = mkState({
             activeAppId: 'a',
-            autostartShards: new Set(['__sh3core__']),
             mountedViewIds: new Set(['editor']),
         });
         const out = buildPaletteCandidates(entries, state);

package/dist/actions/scope-helpers.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import { scopeToTier, normalizeScope, scopeBadge, innermostActiveScope, scopeEquals, scopeToString, parseScopeString, } from './scope-helpers';
-const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), autostartShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
+const mkState = (o = {}) => (Object.assign({ activeAppId: null, activeAppRequiredShards: new Set(), mountedViewIds: new Set(), focusedViewId: null, selection: null, bindings: {}, platform: 'other' }, o));
 describe('scopeToTier', () => {
     it('maps atoms to tier names', () => {
         expect(scopeToTier('home')).toBe('home');
@@ -37,7 +37,7 @@ describe('innermostActiveScope', () => {
     });
     it('picks the innermost active tier across a multi-scope action', () => {
         const state = mkState({
-            activeAppId: 'a', autostartShards: new Set(['owner']),
+            activeAppId: 'a',
             mountedViewIds: new Set(['editor']),
         });
         const winner = innermostActiveScope(['app', 'view:editor'], state, 'owner');
@@ -45,14 +45,14 @@ describe('innermostActiveScope', () => {
     });
     it('falls back to outer tier when inner is inactive', () => {
         const state = mkState({
-            activeAppId: 'a', autostartShards: new Set(['owner']),
+            activeAppId: 'a',
         });
         const winner = innermostActiveScope(['app', 'view:editor'], state, 'owner');
         expect(winner).toBe('app');
     });
     it('element scope beats view scope when both active', () => {
         const state = mkState({
-            activeAppId: 'a', autostartShards: new Set(['owner']),
+            activeAppId: 'a',
             mountedViewIds: new Set(['editor']),
             selection: { type: 'row', ref: {}, ownerShardId: 'owner' },
         });

package/dist/actions/shardContext.test.js

@@ -1,12 +1,12 @@
 import { describe, it, expect, beforeEach } from 'vitest';
-import { registerShard, activateShard, deactivateShard } from '../shards/activate.svelte';
+import { registerShard, activateShard, deactivateShard } from '../shards/lifecycle.svelte';
 import { __resetContributionsForTest } from '../contributions/registry';
 import { __resetActionsRegistryForTest, listActions } from './registry';
 import { __resetSelectionForTest, getSelection } from './selection.svelte';
 function mkShard(id, onActivate) {
     return {
         manifest: { id, label: id, version: '0.0.0-test', views: [] },
-        async activate(ctx) { onActivate(ctx); },
+        async register(ctx) { onActivate(ctx); },
     };
 }
 describe('ctx.actions on ShardContext', () => {

package/dist/actions/state.svelte.d.ts

@@ -12,7 +12,6 @@ export declare function __notifyActiveChange(): void;
 /** Test-only alias for the internal notifier. */
 export declare const __notifyActiveChangeForTest: typeof __notifyActiveChange;
 export declare function setActiveApp(appId: string | null, requiredShards: Set<string>): void;
-export declare function setAutostartShards(shards: Set<string>): void;
 export declare function setMountedViewIds(ids: Set<string>): void;
 /**
  * One-shot snapshot: walk the active layout tree and update
@@ -24,5 +23,16 @@ export declare function syncMountedViewIdsFromLayout(): void;
 export declare function setFocusedViewId(id: string | null): void;
 export declare function setUserBindings(bindings: Record<string, string | null>): void;
 export declare function getLiveDispatcherState(): DispatcherState;
-export declare function addAutostartShard(id: string): void;
+/**
+ * @deprecated v3: autostartShards has been removed. This is a no-op shim
+ * retained so existing test fixtures compile during the migration window.
+ * Phase 7 sweeps these call sites.
+ */
+export declare function addAutostartShard(_id: string): void;
+/**
+ * @deprecated v3: autostartShards has been removed. This is a no-op shim
+ * retained so existing test fixtures compile during the migration window.
+ * Phase 7 sweeps these call sites.
+ */
+export declare function setAutostartShards(_shards: Set<string>): void;
 export declare function __resetDispatcherStateForTest(): void;

package/dist/actions/state.svelte.js

@@ -13,7 +13,6 @@ import { layoutStore } from '../layout/store.svelte';
 import { collectTreeSlotRefs } from '../layout/tree-walk';
 let activeAppId = $state(null);
 let activeAppRequiredShards = $state(new Set());
-let autostartShards = $state(new Set());
 let mountedViewIds = $state(new Set());
 let focusedViewId = $state(null);
 let userBindings = $state({});
@@ -51,10 +50,6 @@ export function setActiveApp(appId, requiredShards) {
     activeAppRequiredShards = new Set(requiredShards);
     notifyActiveChange();
 }
-export function setAutostartShards(shards) {
-    autostartShards = new Set(shards);
-    notifyActiveChange();
-}
 export function setMountedViewIds(ids) {
     mountedViewIds = new Set(ids);
     notifyActiveChange();
@@ -87,7 +82,6 @@ export function getLiveDispatcherState() {
     return {
         activeAppId,
         activeAppRequiredShards,
-        autostartShards,
         mountedViewIds,
         focusedViewId,
         selection: getSelection(),
@@ -95,16 +89,25 @@ export function getLiveDispatcherState() {
         platform,
     };
 }
-export function addAutostartShard(id) {
-    if (!autostartShards.has(id)) {
-        autostartShards = new Set([...autostartShards, id]);
-        notifyActiveChange();
-    }
+/**
+ * @deprecated v3: autostartShards has been removed. This is a no-op shim
+ * retained so existing test fixtures compile during the migration window.
+ * Phase 7 sweeps these call sites.
+ */
+export function addAutostartShard(_id) {
+    /* no-op */
+}
+/**
+ * @deprecated v3: autostartShards has been removed. This is a no-op shim
+ * retained so existing test fixtures compile during the migration window.
+ * Phase 7 sweeps these call sites.
+ */
+export function setAutostartShards(_shards) {
+    /* no-op */
 }
 export function __resetDispatcherStateForTest() {
     activeAppId = null;
     activeAppRequiredShards = new Set();
-    autostartShards = new Set();
     mountedViewIds = new Set();
     focusedViewId = null;
     userBindings = {};

package/dist/actions/state.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach } from 'vitest';
-import { setActiveApp, setAutostartShards, setFocusedViewId, setMountedViewIds, setUserBindings, getLiveDispatcherState, onActiveChange, __notifyActiveChangeForTest, __resetDispatcherStateForTest, } from './state.svelte';
+import { setActiveApp, setFocusedViewId, setMountedViewIds, setUserBindings, getLiveDispatcherState, onActiveChange, __notifyActiveChangeForTest, __resetDispatcherStateForTest, } from './state.svelte';
 import { __resetSelectionForTest, makeSelectionApi } from './selection.svelte';
 describe('live dispatcher state', () => {
     beforeEach(() => {
@@ -46,15 +46,15 @@ describe('onActiveChange', () => {
     it('fires on every setter', () => {
         let n = 0;
         const off = onActiveChange(() => { n++; });
+        // v3: setAutostartShards is a no-op shim; 4 setters notify.
         setActiveApp('a', new Set(['s']));
-        setAutostartShards(new Set(['s']));
         setMountedViewIds(new Set(['v']));
         setFocusedViewId('v');
         setUserBindings({ foo: 'Ctrl+K' });
-        expect(n).toBe(5);
+        expect(n).toBe(4);
         off();
         setActiveApp(null, new Set());
-        expect(n).toBe(5);
+        expect(n).toBe(4);
     });
     it('fires on external notify (used for registry change)', () => {
         let n = 0;

package/dist/api.d.ts

@@ -27,7 +27,7 @@ export { spawnSatellite } from './sh3Api/window';
 export type { SpawnSatelliteOptions } from './sh3Api/window';
 export type { SatellitePayload } from './boot/satellitePayload';
 export { inspectActiveLayout, spliceIntoActiveLayout, dockIntoActiveLayout, focusTab, focusView, collapseChild, expandChild, closeTab, popoutView, dockFloat, locateSlot, } from './layout/inspection';
-export type { DocumentHandle, DocumentHandleOptions, DocumentFormat, DocumentMeta, DocumentChange, AutosaveController, } from './documents/types';
+export type { DocumentHandle, DocumentMeta, DocumentChange, AutosaveController, } from './documents/types';
 export { PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ, PERMISSION_DOCUMENTS_WRITE, } from './documents/types';
 export type { BrowseCapability } from './documents/browse';
 export type { DocumentPickerApi, DocumentOpenOptions, DocumentSaveOptions } from './documents/picker-api';
@@ -38,8 +38,8 @@ export type { ConflictItem, ConflictBranch as ConflictManagerBranch, ResolveOpti
 export { CONFLICT_RENDERER_POINT, ConflictPermissionError, ConflictSessionOrphanedError, } from './conflicts/api';
 export type { ColorPickOptions, ColorContribution, ColorApi, } from './color/api';
 export { COLOR_PICKER_POINT } from './color/api';
-export { registeredShards, activeShards, erroredShards } from './shards/activate.svelte';
-export type { ShardErrorEntry } from './shards/activate.svelte';
+export { registeredShards, activeShards, erroredShards } from './shards/lifecycle.svelte';
+export type { ShardErrorEntry } from './shards/lifecycle.svelte';
 export type { RegistryIndex, PackageEntry, PackageVersion, RequiredDependency, InstalledPackage, InstallResult, PackageMeta, RemoteInstallRequest, } from './registry/types';
 export type { ResolvedPackage } from './registry/client';
 export { fetchRegistries, fetchArchive, buildPackageMeta } from './registry/client';
@@ -55,6 +55,7 @@ export declare const capabilities: {
     readonly hotInstall: boolean;
 };
 export type { ServerShard, ServerShardContext, TenantDocumentAPI } from './server-shard/types';
+export type { ApiKeyPublic as ServerApiKeyPublic } from './server-shard/types';
 export type { Verb, VerbContext, Sh3Api, VerbSchema, PortableJSONSchema, DispatchToTerminalResult, } from './verbs/types';
 export type { Scrollback } from './shell-shard/scrollback.svelte';
 export type { SessionClient } from './shell-shard/session-client.svelte';

package/dist/api.js

@@ -42,7 +42,7 @@ export { COLOR_PICKER_POINT } from './color/api';
 // and tooling shards that need to visualize framework state. Phase 9
 // addition: diagnostic used to reach `activate.svelte` directly via $lib;
 // the package boundary requires routing through the public surface.
-export { registeredShards, activeShards, erroredShards } from './shards/activate.svelte';
+export { registeredShards, activeShards, erroredShards } from './shards/lifecycle.svelte';
 export { fetchRegistries, fetchArchive, buildPackageMeta } from './registry/client';
 export { validateRegistryIndex } from './registry/schema';
 // Key mint/revoke types — client shards that declare `keys:mint` get ctx.keys.

package/dist/app/admin/adminShard.svelte.js

@@ -33,7 +33,7 @@ export const adminShard = {
             { id: 'sh3-admin:mounts', label: 'Mounts' },
         ],
     },
-    activate(ctx) {
+    register(ctx) {
         const usersFactory = {
             mount(container, _context) {
                 const instance = mount(UsersView, { target: container });

package/dist/app/store/storeShard.svelte.js

@@ -69,7 +69,7 @@ export const storeShard = {
             { id: 'sh3-store:browse', label: 'Store' },
         ],
     },
-    activate(ctx) {
+    register(ctx) {
         const env = ctx.env({ registries: [] });
         const state = ctx.state({
             ephemeral: {
@@ -260,9 +260,14 @@ export const storeShard = {
         ctx.registerVerb(updateVerb);
         // refreshInstalled can run immediately (hits server, no env needed).
         refreshInstalled();
-    },
-    autostart() {
-        // Runs after env hydration, so registries are populated.
-        storeContext.refreshCatalog();
+        // v3: env hydration happens after register() returns. React via $effect
+        // so refreshCatalog fires once registries populate.
+        $effect.root(() => {
+            $effect(() => {
+                if (env.registries.length > 0) {
+                    storeContext.refreshCatalog();
+                }
+            });
+        });
     },
 };