sh3-core 0.15.3 → 0.16.0

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}

@@ -9,15 +9,16 @@ import type { ConflictsApi } from './conflicts/api';
 import type { ColorApi } from './color/api';
 import { type OpenContextMenuOpts, type OpenPaletteOpts } from './actions/listeners';
 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.
      */
@@ -32,18 +33,29 @@ 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
+     * terminal as if the user had typed the line. Resolves which terminal:
+     * focused → sole → fail. Returns synchronously with the routing outcome;
+     * the dispatch itself runs fire-and-forget.
+     *
+     * Mirrors `Sh3Api.dispatchToTerminal` (the verb-side surface). Both
+     * read the same module-scoped registry of live Terminal.svelte instances.
+     */
+    dispatchToTerminal(line: string): DispatchToTerminalResult;
 }
 /**
  * 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. */
@@ -60,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[];
@@ -71,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,14 +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';
-const shellActions = {
+import { makeDispatchToTerminal } from './shell-shard/dispatch-to-terminal';
+const sh3Actions = {
     async rebind(appId, actionId, shortcut) {
         await saveUserBinding(appId, actionId, shortcut);
         const current = getLiveDispatcherState();
@@ -64,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,
@@ -74,5 +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 {};

package/dist/sh3Runtime.svelte.test.js

@@ -0,0 +1,46 @@
+/*
+ * Targeted coverage for the `sh3` runtime singleton's dispatchToTerminal.
+ *
+ * The wiring is what matters: the singleton must consult the same module-
+ * scoped terminal-registry as Sh3Api.dispatchToTerminal so a Svelte view
+ * (which imports `sh3`) and a verb (which receives `vctx.sh3`) hit the
+ * same set of live Terminal handles. A view import is the only path a
+ * picker has — without this, the dispatchToTerminal API is unreachable
+ * from the place it was designed to be called.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { sh3 } from './sh3Runtime.svelte';
+import { registerTerminalView, __resetTerminalRegistryForTest, } from './shell-shard/terminal-registry';
+function makeHandle(id, focusStamp = 0, dispatch = vi.fn(async () => undefined)) {
+    return {
+        id,
+        dispatch,
+        getFocusStamp: () => focusStamp,
+        getMode: () => ({ id: 'sh3', label: 'sh3', transport: 'none', autoRelocate: false, showCwd: true }),
+    };
+}
+describe('sh3 runtime singleton — dispatchToTerminal', () => {
+    beforeEach(() => {
+        __resetTerminalRegistryForTest();
+    });
+    it('returns no-terminal when registry is empty', () => {
+        const r = sh3.dispatchToTerminal('foo');
+        expect(r).toMatchObject({ ok: false, error: 'no-terminal', message: 'no terminal open' });
+    });
+    it('routes through the resolved handle when one is registered', () => {
+        const dispatch = vi.fn(async () => undefined);
+        registerTerminalView(makeHandle('term-1', 0, dispatch));
+        const r = sh3.dispatchToTerminal('apps');
+        expect(r).toEqual({ ok: true, terminalId: 'term-1' });
+        expect(dispatch).toHaveBeenCalledWith('apps');
+    });
+    it('shares the registry with Sh3Api.dispatchToTerminal (same handles, same routing)', () => {
+        const dispatch = vi.fn(async () => undefined);
+        registerTerminalView(makeHandle('term-shared', 0, dispatch));
+        // The singleton is the surface a Svelte view sees; it must hit the
+        // same registry as the verb-side Sh3Api.
+        const r = sh3.dispatchToTerminal('hi');
+        expect(r).toEqual({ ok: true, terminalId: 'term-shared' });
+        expect(dispatch).toHaveBeenCalledWith('hi');
+    });
+});

package/dist/sh3core-shard/AppInfoView.svelte

@@ -94,15 +94,15 @@
     padding: 16px 20px;
     min-width: 360px;
     max-width: 520px;
-    color: var(--shell-fg);
-    background: var(--shell-bg);
+    color: var(--sh3-fg);
+    background: var(--sh3-bg);
     font: inherit;
   }
   header { display: flex; align-items: baseline; gap: 10px; margin-bottom: 10px; }
   header h2 { margin: 0; font-size: 16px; }
   header .id {
     font-size: 12px;
-    color: var(--shell-fg-muted);
+    color: var(--sh3-fg-muted);
   }
   .version { margin: 4px 0 12px; font-size: 13px; display: flex; align-items: center; gap: 8px; }
   .description { margin: 8px 0 12px; }
@@ -114,7 +114,7 @@
   }
   .row { margin: 6px 0; font-size: 13px; display: flex; align-items: baseline; gap: 8px; flex-wrap: wrap; }
   .label {
-    color: var(--shell-fg-muted);
+    color: var(--sh3-fg-muted);
     font-size: 11px;
     text-transform: uppercase;
     letter-spacing: 0.04em;
@@ -124,31 +124,31 @@
   .chips { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: 4px; }
   .chips code {
     padding: 1px 6px;
-    border: 1px solid var(--shell-border);
-    border-radius: var(--shell-radius-sm, 3px);
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-sm, 3px);
   }
   .badge {
     font-size: 11px;
     padding: 1px 6px;
-    border-radius: var(--shell-radius-sm, 3px);
-    background: var(--shell-bg-elevated);
-    color: var(--shell-fg-muted);
-    border: 1px solid var(--shell-border);
+    border-radius: var(--sh3-radius-sm, 3px);
+    background: var(--sh3-bg-elevated);
+    color: var(--sh3-fg-muted);
+    border: 1px solid var(--sh3-border);
   }
-  .installed { margin-top: 12px; padding-top: 10px; border-top: 1px solid var(--shell-border); }
+  .installed { margin-top: 12px; padding-top: 10px; border-top: 1px solid var(--sh3-border); }
   code {
-    font-family: var(--shell-font-mono, monospace);
-    background: var(--shell-bg-elevated);
+    font-family: var(--sh3-font-mono, monospace);
+    background: var(--sh3-bg-elevated);
     padding: 0 4px;
-    border-radius: var(--shell-radius-sm, 3px);
+    border-radius: var(--sh3-radius-sm, 3px);
   }
   .actions { display: flex; gap: 8px; margin-top: 16px; justify-content: flex-end; }
   .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); }
 </style>