sh3-core 0.15.4 → 0.16.1

package/dist/projects-shard/ProjectManage.svelte

@@ -152,8 +152,8 @@
     display: flex;
     flex-direction: column;
     font: inherit;
-    color: var(--shell-fg);
-    background: var(--shell-bg);
+    color: var(--sh3-fg);
+    background: var(--sh3-bg);
   }
   .body {
     flex: 1;
@@ -161,8 +161,8 @@
     padding: 16px 16px 8px;
   }
   h2 { margin: 0 0 8px; font-size: 16px; }
-  .project-id { font-size: 12px; color: var(--shell-fg-muted); margin: 0 0 16px; }
-  .project-id code { font-family: var(--shell-font-mono, monospace); }
+  .project-id { font-size: 12px; color: var(--sh3-fg-muted); margin: 0 0 16px; }
+  .project-id code { font-family: var(--sh3-font-mono, monospace); }
   .field {
     display: flex;
     flex-direction: column;
@@ -170,50 +170,50 @@
     margin-bottom: 12px;
     font-size: 13px;
   }
-  .field span { color: var(--shell-fg-muted); }
-  .hint { font-size: 11px; color: var(--shell-fg-muted); }
+  .field span { color: var(--sh3-fg-muted); }
+  .hint { font-size: 11px; color: var(--sh3-fg-muted); }
   .hint code {
-    font-family: var(--shell-font-mono, monospace);
-    color: var(--shell-fg);
-    background: var(--shell-bg-elevated);
+    font-family: var(--sh3-font-mono, monospace);
+    color: var(--sh3-fg);
+    background: var(--sh3-bg-elevated);
     padding: 0 4px;
-    border-radius: var(--shell-radius-sm, 3px);
+    border-radius: var(--sh3-radius-sm, 3px);
   }
   .field input,
   .field textarea {
-    background: var(--shell-bg-elevated);
-    color: var(--shell-fg);
-    border: 1px solid var(--shell-border);
-    border-radius: var(--shell-radius-sm, 3px);
+    background: var(--sh3-bg-elevated);
+    color: var(--sh3-fg);
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-sm, 3px);
     padding: 6px 8px;
     font: inherit;
     font-size: 13px;
   }
   .field textarea { resize: vertical; min-height: 60px; }
-  .error { color: var(--shell-error, #c33); font-size: 13px; margin: 0 0 8px; }
+  .error { color: var(--sh3-error, #c33); font-size: 13px; margin: 0 0 8px; }
   .actions {
     display: flex;
     gap: 8px;
     padding: 12px 16px;
-    border-top: 1px solid var(--shell-border);
-    background: var(--shell-bg);
+    border-top: 1px solid var(--sh3-border);
+    background: var(--sh3-bg);
     flex: 0 0 auto;
   }
   .actions button {
-    background: var(--shell-bg-elevated);
-    color: var(--shell-fg);
-    border: 1px solid var(--shell-border);
-    border-radius: var(--shell-radius-sm, 3px);
+    background: var(--sh3-bg-elevated);
+    color: var(--sh3-fg);
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-sm, 3px);
     padding: 6px 14px;
     font: inherit;
     cursor: pointer;
   }
-  .actions button:hover { border-color: var(--shell-accent); }
+  .actions button:hover { border-color: var(--sh3-accent); }
   .actions button.primary {
-    background: var(--shell-accent);
+    background: var(--sh3-accent);
     color: #fff;
-    border-color: var(--shell-accent);
+    border-color: var(--sh3-accent);
   }
-  .actions button.danger { margin-left: auto; color: var(--shell-error, #c33); }
+  .actions button.danger { margin-left: auto; color: var(--sh3-error, #c33); }
   .actions button:disabled { opacity: 0.5; cursor: not-allowed; }
 </style>

package/dist/projects-shard/ProjectsSection.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
   /*
-   * Projects section for ShellHome.
+   * Projects section for Sh3Home.
    *
    * Renders the list of projects the current user is a member of as
    * selectable cards. Selecting a project sets sessionState.activeProjectId
@@ -69,7 +69,7 @@
     font-weight: 600;
     text-transform: uppercase;
     letter-spacing: 0.06em;
-    color: var(--shell-fg-subtle);
+    color: var(--sh3-fg-subtle);
     margin: 0 0 12px;
   }
   .projects-grid {
@@ -84,9 +84,9 @@
     align-items: flex-start;
     gap: 4px;
     padding: 12px 14px;
-    background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
-    border: 1px solid var(--shell-border);
-    border-radius: var(--shell-radius-md);
+    background: var(--sh3-grad-bg-elevated, var(--sh3-bg-elevated));
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-md);
     cursor: pointer;
     text-align: left;
     color: inherit;
@@ -100,21 +100,21 @@
     right: 6px;
     background: transparent;
     border: 0;
-    color: var(--shell-fg-muted);
+    color: var(--sh3-fg-muted);
     cursor: pointer;
     padding: 2px 6px;
     font-size: 14px;
-    border-radius: var(--shell-radius-sm, 3px);
+    border-radius: var(--sh3-radius-sm, 3px);
   }
-  .project-card-edit:hover { color: var(--shell-fg); background: var(--shell-bg-elevated); }
+  .project-card-edit:hover { color: var(--sh3-fg); background: var(--sh3-bg-elevated); }
   .project-card:hover {
-    border-color: var(--shell-accent);
+    border-color: var(--sh3-accent);
     transform: translateY(-1px);
   }
   .project-card.active {
-    border-color: var(--shell-accent);
-    box-shadow: 0 0 0 2px color-mix(in srgb, var(--shell-accent) 40%, transparent);
+    border-color: var(--sh3-accent);
+    box-shadow: 0 0 0 2px color-mix(in srgb, var(--sh3-accent) 40%, transparent);
   }
   .project-name { font-weight: 600; font-size: 13px; }
-  .project-meta { font-size: 11px; color: var(--shell-fg-muted); }
+  .project-meta { font-size: 11px; color: var(--sh3-fg-muted); }
 </style>

package/dist/registry/installer.d.ts

@@ -53,7 +53,7 @@ export declare function listInstalledPackages(): Promise<InstalledPackage[]>;
  * Load all installed packages from IndexedDB and register them.
  *
  * Called once at boot by `bootstrap()`, before any glob-discovered shards
- * or the shell shard are registered. Individual package failures are logged
- * as warnings but do not prevent the shell from booting.
+ * or the sh3 shard are registered. Individual package failures are logged
+ * as warnings but do not prevent the sh3 from booting.
  */
 export declare function loadInstalledPackages(): Promise<void>;

package/dist/registry/installer.js

@@ -163,8 +163,8 @@ export async function listInstalledPackages() {
  * Load all installed packages from IndexedDB and register them.
  *
  * Called once at boot by `bootstrap()`, before any glob-discovered shards
- * or the shell shard are registered. Individual package failures are logged
- * as warnings but do not prevent the shell from booting.
+ * or the sh3 shard are registered. Individual package failures are logged
+ * as warnings but do not prevent the sh3 from booting.
  */
 export async function loadInstalledPackages() {
     let packages;

package/dist/registry/loader.js

@@ -60,7 +60,7 @@ const shimUrls = {
 // `svelte/internal/disclose-version` is a side-effect-only import (no exports).
 // Create an empty shim so the import doesn't fail.
 shimUrls['svelte/internal/disclose-version'] = URL.createObjectURL(new Blob([''], { type: 'application/javascript' }));
-// `sh3/tokens.css` — design tokens are already loaded by the host shell.
+// `sh3/tokens.css` — design tokens are already loaded by the host sh3.
 // Bundles that import this path get a no-op so the import doesn't fail.
 shimUrls['sh3-core/tokens.css'] = URL.createObjectURL(new Blob([''], { type: 'application/javascript' }));
 // ---- bare specifier rewriting ----------------------------------------------

package/dist/registry/permission-descriptions.js

@@ -8,7 +8,7 @@
  */
 export const PERMISSION_DESCRIPTIONS = {
     'state:manage': {
-        title: 'Manage shell state zones',
+        title: 'Manage sh3 state zones',
         description: 'Read and write state zones belonging to other shards.',
     },
     'documents:browse': {
@@ -37,7 +37,7 @@ export const PERMISSION_DESCRIPTIONS = {
     },
     'keys:mint': {
         title: 'Mint API keys',
-        description: 'Issue long-lived access tokens for this shell.',
+        description: 'Issue long-lived access tokens for this sh3.',
     },
 };
 export function describePermission(id) {

package/dist/registry/permission-descriptions.test.js

@@ -3,7 +3,7 @@ import { describePermission, extractBundlePermissions, PERMISSION_DESCRIPTIONS,
 describe('describePermission', () => {
     it('returns the registered entry for a known permission id', () => {
         const result = describePermission('state:manage');
-        expect(result.title).toBe('Manage shell state zones');
+        expect(result.title).toBe('Manage sh3 state zones');
         expect(result.description).toContain('state zones');
     });
     it('covers every permission advertised in the module registry', () => {

package/dist/runtime/runVerb-shell.test.js

@@ -95,7 +95,7 @@ describe('shell-shard programmatic verbs (integration)', () => {
             throw new Error('unreachable');
         expect(entry.text).toMatch(/no active app/);
     });
-    it('shards emits a rich entry containing the active shell shard', async () => {
+    it('shards emits a rich entry containing the active sh3 shard', async () => {
         const out = await runVerbProgrammatic('shell', 'shards', []);
         const entry = out.scrollback[0];
         expect(entry.kind).toBe('rich');
@@ -140,7 +140,7 @@ describe('shell-shard programmatic verbs (integration)', () => {
         expect(entry.level).toBe('warn');
     });
     it('zone with shardId+zoneName emits a rich entry exposing data.value', async () => {
-        const out = await runVerbProgrammatic('shell', 'zone', ['shell', 'workspace']);
+        const out = await runVerbProgrammatic('shell', 'zone', ['sh3', 'workspace']);
         const entry = out.scrollback[0];
         expect(entry.kind).toBe('rich');
         if (entry.kind !== 'rich')

package/dist/runtime/runVerb.js

@@ -2,7 +2,7 @@
  * runVerbProgrammatic — programmatic verb dispatch with synthesized VerbContext.
  *
  * Used by `ctx.runVerb(...)` (see shards/activate.svelte.ts). Builds a
- * sink scrollback that captures entries into an array, a headless ShellApi
+ * sink scrollback that captures entries into an array, a headless Sh3Api
  * (no terminal-bound state), a stub SessionClient, and a real TenantFsClient.
  * Verbs that opt in via `programmatic: true` run against this synthesized
  * context; non-programmatic verbs are rejected.
@@ -13,11 +13,11 @@
  * fire-and-forget semantics).
  *
  * Resolution: prefixed names (`'sh3-store:install'`) look up directly;
- * unprefixed shell names (`'apps'`) resolve against shardId 'shell'.
+ * unprefixed sh3 names (`'apps'`) resolve against shardId 'sh3'.
  */
 import { activeShards } from '../shards/activate.svelte';
 import { getVerb, listVerbsWithShard } from '../shards/registry';
-import { makeShellApiHeadless } from '../shell-shard/shellApi';
+import { makeSh3ApiHeadless } from '../sh3Api/headless';
 import { Scrollback } from '../shell-shard/scrollback.svelte';
 import { SessionClient } from '../shell-shard/session-client.svelte';
 import { TenantFsClient } from '../shell-shard/tenant-fs-client';
@@ -53,7 +53,7 @@ export async function runVerbProgrammatic(shardId, name, args, opts) {
 async function buildProgrammaticContext(b) {
     var _a, _b;
     const ctx = {
-        shell: makeShellApiHeadless(),
+        sh3: makeSh3ApiHeadless(),
         scrollback: b.sinkScrollback,
         session: makeStubSession(),
         cwd: '/',

package/dist/runtime/runVerb.test.js

@@ -129,18 +129,18 @@ describe('runVerbProgrammatic', () => {
         await activateShard('tester');
         await expect(runVerbProgrammatic('tester', 'tester:boom', [])).rejects.toThrow('kaboom');
     });
-    it('exposes vctx.shell.dispatchToTerminal that returns no-active-context', async () => {
+    it('exposes vctx.sh3.dispatchToTerminal that returns no-active-context', async () => {
         let observed = undefined;
         registerShard({
             manifest: { id: 'tester', label: 'T', version: '0.0.0', views: [] },
             activate(ctx) {
-                ctx.registerVerb(makeVerb('peek-shell', true, async (vctx) => {
-                    observed = vctx.shell.dispatchToTerminal('foo');
+                ctx.registerVerb(makeVerb('peek-sh3', true, async (vctx) => {
+                    observed = vctx.sh3.dispatchToTerminal('foo');
                 }));
             },
         });
         await activateShard('tester');
-        await runVerbProgrammatic('tester', 'tester:peek-shell', []);
+        await runVerbProgrammatic('tester', 'tester:peek-sh3', []);
         expect(observed).toMatchObject({
             ok: false,
             error: 'no-active-context',

package/dist/satellite/SatelliteShell.svelte

@@ -54,7 +54,7 @@
     position: absolute;
     inset: 0;
     overflow: hidden;
-    background: var(--shell-grad-bg, var(--shell-bg));
-    color: var(--shell-fg);
+    background: var(--sh3-grad-bg, var(--sh3-bg));
+    color: var(--sh3-fg);
   }
 </style>

package/dist/{shell → sh3}/views/KeysAndPeers.svelte

@@ -94,17 +94,17 @@
 </div>
 
 <style>
-  .keys-peers { padding: 24px; font-family: system-ui, sans-serif; color: var(--shell-fg); }
+  .keys-peers { padding: 24px; font-family: system-ui, sans-serif; color: var(--sh3-fg); }
   .keys-peers-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 16px; }
   .keys-peers-header h2 { margin: 0; font-size: 18px; }
   .keys-peers-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 8px; }
-  .keys-peers-item { display: flex; justify-content: space-between; align-items: flex-start; padding: 12px 16px; background: var(--shell-bg-elevated, #252540); border: 1px solid var(--shell-border, #3a3a5c); border-radius: var(--shell-radius, 6px); gap: 12px; }
+  .keys-peers-item { display: flex; justify-content: space-between; align-items: flex-start; padding: 12px 16px; background: var(--sh3-bg-elevated, #252540); border: 1px solid var(--sh3-border, #3a3a5c); border-radius: var(--sh3-radius, 6px); gap: 12px; }
   .keys-peers-info { display: flex; flex-direction: column; gap: 3px; min-width: 0; }
   .keys-peers-label { font-weight: 600; }
-  .keys-peers-meta { font-size: 11px; color: var(--shell-fg-subtle); }
+  .keys-peers-meta { font-size: 11px; color: var(--sh3-fg-subtle); }
   .keys-peers-actions { display: flex; gap: 6px; flex-shrink: 0; align-items: flex-start; padding-top: 2px; }
-  .keys-peers-btn-danger { background: transparent; color: var(--shell-error, #d32f2f); border: 1px solid var(--shell-error, #d32f2f); font-size: 12px; padding: 4px 10px; border-radius: var(--shell-radius, 6px); cursor: pointer; }
-  .keys-peers-btn-secondary { background: transparent; color: var(--shell-fg-subtle); border: 1px solid var(--shell-border, #3a3a5c); font-size: 12px; padding: 4px 10px; border-radius: var(--shell-radius, 6px); cursor: pointer; }
-  .keys-peers-muted { color: var(--shell-fg-muted); font-style: italic; }
-  .keys-peers-error { color: var(--shell-error, #d32f2f); font-size: 13px; }
+  .keys-peers-btn-danger { background: transparent; color: var(--sh3-error, #d32f2f); border: 1px solid var(--sh3-error, #d32f2f); font-size: 12px; padding: 4px 10px; border-radius: var(--sh3-radius, 6px); cursor: pointer; }
+  .keys-peers-btn-secondary { background: transparent; color: var(--sh3-fg-subtle); border: 1px solid var(--sh3-border, #3a3a5c); font-size: 12px; padding: 4px 10px; border-radius: var(--sh3-radius, 6px); cursor: pointer; }
+  .keys-peers-muted { color: var(--sh3-fg-muted); font-style: italic; }
+  .keys-peers-error { color: var(--sh3-error, #d32f2f); font-size: 13px; }
 </style>

package/dist/sh3Api/headless.d.ts

@@ -0,0 +1,4 @@
+import type { Sh3Api } from '../shell-shard/registry';
+import type { ZoneManager } from '../state/types';
+export declare function makeSh3ApiHeadless(zones?: ZoneManager): Sh3Api;
+export declare function makeSh3ApiForTest(): Sh3Api;

package/dist/{shell-shard/shellApi.js → sh3Api/headless.js}

@@ -1,5 +1,5 @@
 /*
- * Headless ShellApi factory.
+ * Headless Sh3Api factory.
  *
  * Built only from framework primitives (apps registry, layout inspection,
  * auth, float manager). No Svelte component imports — safe to load from
@@ -15,7 +15,7 @@ import { registeredShards, listStandaloneViews } from '../shards/activate.svelte
 import { inspectActiveLayout, focusView, closeTab, popoutView, dockFloat, dockIntoActiveLayout, locateSlot as locateSlotInActiveLayout, } from '../layout/inspection';
 import { floatManager } from '../overlays/float';
 import { getUser, isAdmin } from '../auth/index';
-import { makeDispatchToTerminal } from './dispatch-to-terminal';
+import { makeDispatchToTerminal } from '../shell-shard/dispatch-to-terminal';
 const KNOWN_ZONES = ['ephemeral', 'session', 'workspace', 'user'];
 function collectTabEntries(node) {
     if (node.type === 'tabs') {
@@ -29,7 +29,7 @@ function collectTabEntries(node) {
     }
     return [];
 }
-export function makeShellApiHeadless(zones) {
+export function makeSh3ApiHeadless(zones) {
     return {
         listApps() {
             return listRegisteredApps().map((m) => ({ id: m.id, label: m.label }));
@@ -168,6 +168,6 @@ export function makeShellApiHeadless(zones) {
         dispatchToTerminal: makeDispatchToTerminal({ headless: true }),
     };
 }
-export function makeShellApiForTest() {
-    return makeShellApiHeadless();
+export function makeSh3ApiForTest() {
+    return makeSh3ApiHeadless();
 }

package/dist/{shell-shard/shellApi.svelte.test.js → sh3Api/headless.svelte.test.js}

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { makeShellApiHeadless } from './shellApi';
+import { makeSh3ApiHeadless } from './headless';
 function makeMockZoneManager() {
     const data = {
         ephemeral: {},
@@ -14,46 +14,46 @@ function makeMockZoneManager() {
         clearAll: () => { },
     };
 }
-describe('shellApi listZones', () => {
+describe('sh3Api listZones', () => {
     it('returns empty when no ZoneManager provided (stub mode)', () => {
-        const api = makeShellApiHeadless();
+        const api = makeSh3ApiHeadless();
         expect(api.listZones()).toEqual([]);
     });
     it('returns one row per shard with the zones it has data in', () => {
         var _a, _b;
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         const rows = api.listZones();
         const byShard = new Map(rows.map((r) => [r.shardId, r.zones]));
         expect((_a = byShard.get('shard-a')) === null || _a === void 0 ? void 0 : _a.sort()).toEqual(['session', 'workspace']);
         expect((_b = byShard.get('shard-b')) === null || _b === void 0 ? void 0 : _b.sort()).toEqual(['user', 'workspace']);
     });
     it('filters by shardId when provided', () => {
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         const rows = api.listZones('shard-a');
         expect(rows).toHaveLength(1);
         expect(rows[0].shardId).toBe('shard-a');
         expect(rows[0].zones.sort()).toEqual(['session', 'workspace']);
     });
     it('returns empty array for unknown shardId', () => {
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         expect(api.listZones('not-a-shard')).toEqual([]);
     });
 });
-describe('shellApi readZone', () => {
+describe('sh3Api readZone', () => {
     it('returns null when no ZoneManager provided', () => {
-        const api = makeShellApiHeadless();
+        const api = makeSh3ApiHeadless();
         expect(api.readZone('shard-a', 'workspace')).toBe(null);
     });
     it('returns peeked value via ZoneManager', () => {
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         expect(api.readZone('shard-a', 'workspace')).toEqual({ bar: 2 });
     });
     it('returns null for unknown zone name', () => {
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         expect(api.readZone('shard-a', 'bogus')).toBe(null);
     });
     it('returns null for missing shard entry', () => {
-        const api = makeShellApiHeadless(makeMockZoneManager());
+        const api = makeSh3ApiHeadless(makeMockZoneManager());
         expect(api.readZone('not-a-shard', 'workspace')).toBe(null);
     });
 });

package/dist/{shellApi → sh3Api}/window.js

@@ -1,5 +1,5 @@
 /*
- * shell.window — host-side facade for spawning satellite windows.
+ * sh3.window — host-side facade for spawning satellite windows.
  *
  * Under Tauri, `spawnSatellite` invokes the `sh3_spawn_satellite` Rust
  * command which opens a native WebviewWindow pointed at the embedded
@@ -24,7 +24,7 @@ function nextLabel() {
 export async function spawnSatellite(payload, opts = {}) {
     var _a, _b, _c, _d;
     if (!isTauri()) {
-        console.warn('[sh3] shell.window.spawn called outside Tauri — no-op');
+        console.warn('[sh3] sh3.window.spawn called outside Tauri — no-op');
         return '';
     }
     const { invoke } = await import('@tauri-apps/api/core');

package/dist/{shellApi → sh3Api}/window.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { spawnSatellite } from './window';
-describe('shell.window.spawn (non-Tauri)', () => {
+describe('sh3.window.spawn (non-Tauri)', () => {
     beforeEach(() => {
         delete globalThis.__TAURI_INTERNALS__;
     });

package/dist/{shellRuntime.svelte.d.ts → sh3Runtime.svelte.d.ts}

@@ -11,14 +11,14 @@ import { type OpenContextMenuOpts, type OpenPaletteOpts } from './actions/listen
 import type { ActiveActionDescriptor } from './actions/types';
 import { type DispatchToTerminalResult } from './shell-shard/dispatch-to-terminal';
 /**
- * The process-wide shell singleton exposed to shards and the shell's own
+ * The process-wide sh3 singleton exposed to shards and the sh3's own
  * internal code. Provides state zone creation and overlay managers.
  * Shards receive a pre-bound version via `ShardContext` rather than
- * accessing `shell` directly.
+ * accessing `sh3` directly.
  */
-export interface Shell {
+export interface Sh3 {
     /**
-     * Declare the state zones a shard (or the shell itself) wants to use.
+     * Declare the state zones a shard (or the sh3 itself) wants to use.
      * Returns a live reactive object per declared zone. Persistent zones
      * are hydrated from the backend before the call returns.
      */
@@ -33,12 +33,12 @@ export interface Shell {
     float: FloatManager;
     /** Named layout presets per app. See overlays/presets.ts. */
     presets: PresetManager;
-    /** Conflict manager view. Shell-owned modal for conflict arbitration. */
+    /** Conflict manager view. Sh3-owned modal for conflict arbitration. */
     conflicts: ConflictsApi;
     /** Color picker. Falls back to native <input type="color"> when no picker shard is contributed. */
     color: ColorApi;
     /** Actions facade — rebind keys, query bindings, open menus/palette. */
-    actions: ShellActionsApi;
+    actions: Sh3ActionsApi;
     /**
      * Dispatch `line` through a Terminal view's normal submit path. Used by
      * views outside a verb context (floating pickers, dialogs) to drive a
@@ -46,7 +46,7 @@ export interface Shell {
      * focused → sole → fail. Returns synchronously with the routing outcome;
      * the dispatch itself runs fire-and-forget.
      *
-     * Mirrors `ShellApi.dispatchToTerminal` (the verb-side surface). Both
+     * Mirrors `Sh3Api.dispatchToTerminal` (the verb-side surface). Both
      * read the same module-scoped registry of live Terminal.svelte instances.
      */
     dispatchToTerminal(line: string): DispatchToTerminalResult;
@@ -55,7 +55,7 @@ export interface Shell {
  * API for managing action bindings and triggering menus/palette
  * programmatically (e.g. from a future settings UI shard).
  */
-export interface ShellActionsApi {
+export interface Sh3ActionsApi {
     /** Persist a custom shortcut for an action and refresh live state if the app is active. */
     rebind(appId: string, actionId: string, shortcut: string | null): Promise<void>;
     /** Remove a custom shortcut override and refresh live state if the app is active. */
@@ -72,7 +72,7 @@ export interface ShellActionsApi {
      * order. See {@link ActiveActionDescriptor}.
      *
      * Non-reactive: returns a fresh array on each call. Subscribe via
-     * {@link ShellActionsApi.onActiveChange} to re-call when the active
+     * {@link Sh3ActionsApi.onActiveChange} to re-call when the active
      * set or shortcuts change.
      */
     listActive(): ActiveActionDescriptor[];
@@ -83,5 +83,5 @@ export interface ShellActionsApi {
      */
     onActiveChange(cb: () => void): () => void;
 }
-/** The process-wide shell instance. Framework-internal code uses this directly; shards receive a scoped view via `ShardContext`. */
-export declare const shell: Shell;
+/** The process-wide sh3 instance. Framework-internal code uses this directly; shards receive a scoped view via `ShardContext`. */
+export declare const sh3: Sh3;

package/dist/{shellRuntime.svelte.js → sh3Runtime.svelte.js}

@@ -1,5 +1,5 @@
 /*
- * shell — the framework-facing entry point passed to shards.
+ * sh3 — the framework-facing entry point passed to shards.
  *
  * Conceptually this is the object a shard receives from its activation
  * callback; it exposes the APIs the shard is allowed to touch.
@@ -8,11 +8,11 @@
  *   Phase 4: registerView (lives on ShardContext, not here).
  *   Phase 5: modal / popup / toast overlay managers.
  *
- * For now `shell` is a module-level singleton. Once the shard lifecycle
- * exists in a fuller form, per-shard shells will be constructed per
+ * For now `sh3` is a module-level singleton. Once the shard lifecycle
+ * exists in a fuller form, per-shard sh3 instances will be constructed per
  * activation with the shardId baked in, so shards no longer need to pass
  * their own id to `state`. Overlay managers stay process-wide because
- * the layer stack is a shell-global resource.
+ * the layer stack is a sh3-global resource.
  */
 import { createStateZones } from './state/zones.svelte';
 import { modalManager } from './overlays/modal';
@@ -20,15 +20,15 @@ import { popupManager } from './overlays/popup';
 import { toastManager } from './overlays/toast';
 import { floatManager } from './overlays/float';
 import { presetManager } from './overlays/presets';
-import { conflictsApi } from './conflicts/shell-api';
-import { colorApi } from './color/shell-api';
+import { conflictsApi } from './conflicts/sh3-api';
+import { colorApi } from './color/sh3-api';
 import { loadUserBindings, saveUserBinding } from './actions/bindings-store';
 import { openContextMenu as listenersOpenContextMenu, openPalette as listenersOpenPalette, } from './actions/listeners';
 import { setUserBindings, getLiveDispatcherState, onActiveChange as onActiveChangeState, __notifyActiveChange, } from './actions/state.svelte';
 import { listActions, onActionsChange } from './actions/registry';
 import { listActiveFromEntries } from './actions/listActive';
 import { makeDispatchToTerminal } from './shell-shard/dispatch-to-terminal';
-const shellActions = {
+const sh3Actions = {
     async rebind(appId, actionId, shortcut) {
         await saveUserBinding(appId, actionId, shortcut);
         const current = getLiveDispatcherState();
@@ -65,8 +65,8 @@ const shellActions = {
         };
     },
 };
-/** The process-wide shell instance. Framework-internal code uses this directly; shards receive a scoped view via `ShardContext`. */
-export const shell = {
+/** The process-wide sh3 instance. Framework-internal code uses this directly; shards receive a scoped view via `ShardContext`. */
+export const sh3 = {
     state: createStateZones,
     modal: modalManager,
     popup: popupManager,
@@ -75,6 +75,6 @@ export const shell = {
     presets: presetManager,
     conflicts: conflictsApi,
     color: colorApi,
-    actions: shellActions,
+    actions: sh3Actions,
     dispatchToTerminal: makeDispatchToTerminal({ headless: false }),
 };

package/dist/sh3Runtime.svelte.test.d.ts

@@ -0,0 +1 @@
+export {};