sh3-core 0.15.3 → 0.16.0

package/dist/shell-shard/verbs/views.js

@@ -8,7 +8,7 @@ export const viewsVerb = {
     programmatic: true,
     async run(ctx, args) {
         if (args.includes('--standalone')) {
-            const standalones = ctx.shell.listStandaloneViews();
+            const standalones = ctx.sh3.listStandaloneViews();
             if (standalones.length === 0) {
                 ctx.scrollback.push({
                     kind: 'status',
@@ -28,7 +28,7 @@ export const viewsVerb = {
             });
             return;
         }
-        const views = ctx.shell.listViewsInCurrentLayout();
+        const views = ctx.sh3.listViewsInCurrentLayout();
         ctx.scrollback.push({
             kind: 'rich',
             componentKey: VIEWS_TABLE_KEY,
@@ -38,7 +38,7 @@ export const viewsVerb = {
                     views,
                     onClose: (slotId) => {
                         var _a;
-                        const result = ctx.shell.closeSlot(slotId);
+                        const result = ctx.sh3.closeSlot(slotId);
                         if (!result.ok) {
                             ctx.scrollback.push({
                                 kind: 'status',
@@ -70,7 +70,7 @@ export const openVerb = {
             });
             return;
         }
-        const result = ctx.shell.openViewInCurrentLayout(viewId);
+        const result = ctx.sh3.openViewInCurrentLayout(viewId);
         if (!result.ok) {
             ctx.scrollback.push({
                 kind: 'status',
@@ -105,7 +105,7 @@ export const popoutVerb = {
             });
             return;
         }
-        const result = ctx.shell.popoutSlot(slotId);
+        const result = ctx.sh3.popoutSlot(slotId);
         if (!result.ok) {
             ctx.scrollback.push({
                 kind: 'status',
@@ -132,7 +132,7 @@ export const dockVerb = {
         var _a;
         const floatId = args[0];
         if (!floatId) {
-            const floats = ctx.shell.listFloats();
+            const floats = ctx.sh3.listFloats();
             if (floats.length === 0) {
                 ctx.scrollback.push({
                     kind: 'status',
@@ -152,7 +152,7 @@ export const dockVerb = {
             });
             return;
         }
-        const result = ctx.shell.dockFloat(floatId);
+        const result = ctx.sh3.dockFloat(floatId);
         if (!result.ok) {
             ctx.scrollback.push({
                 kind: 'status',
@@ -187,7 +187,7 @@ export const closeVerb = {
             });
             return;
         }
-        const result = ctx.shell.closeSlot(slotId);
+        const result = ctx.sh3.closeSlot(slotId);
         if (!result.ok) {
             ctx.scrollback.push({
                 kind: 'status',

package/dist/shell-shard/verbs/zones.js

@@ -10,7 +10,7 @@ export const zonesVerb = {
     summary: 'List zones for the current user (optionally scoped to a shard).',
     programmatic: true,
     async run(ctx, args) {
-        const rows = ctx.shell.listZones(args[0]);
+        const rows = ctx.sh3.listZones(args[0]);
         ctx.scrollback.push({
             kind: 'rich',
             componentKey: ZONES_TABLE_KEY,
@@ -35,7 +35,7 @@ export const zoneVerb = {
             });
             return;
         }
-        const value = ctx.shell.readZone(shardId, zoneName);
+        const value = ctx.sh3.readZone(shardId, zoneName);
         ctx.scrollback.push({
             kind: 'rich',
             componentKey: ZONE_TREE_KEY,

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

@@ -11,7 +11,7 @@ export type StateZones<T extends ZoneSchema> = {
     [K in keyof T]: T[K];
 };
 /**
- * Create live reactive state zones for a shard (or the shell itself).
+ * Create live reactive state zones for a shard (or the sh3 itself).
  *
  * Each zone declared in `schema` is backed by the appropriate store:
  * `ephemeral` and `session` are in-memory; `workspace` and `user` are
@@ -35,7 +35,7 @@ export declare function __setBackend(zone: ZoneName, backend: Backend): void;
 /**
  * Read a raw persisted zone entry without creating a reactive proxy.
  *
- * Intended for framework-internal consumers (e.g. the shell's layout
+ * Intended for framework-internal consumers (e.g. the sh3's layout
  * persistence) that need to inspect a stored value before deciding
  * whether to pass it to `createStateZones`. Not part of the shard-facing
  * API — shards always go through `createStateZones` so hydration is

package/dist/state/zones.svelte.js

@@ -2,7 +2,7 @@
  * createStateZones — turns a declarative zone schema into live reactive
  * per-zone objects backed by the right store for each zone.
  *
- * Usage (from a shard, or the shell itself):
+ * Usage (from a shard, or the sh3 itself):
  *
  *   const state = createStateZones('graphlive', {
  *     ephemeral: { hoveredId: null as string | null },
@@ -25,7 +25,7 @@
  *
  * Lifetime management (tracking teardown on shard deactivation) arrives in
  * phase 4 when the shard contract exists. For phase 3, roots live until the
- * page unloads, which is fine for a single-session shell.
+ * page unloads, which is fine for a single-session sh3.
  *
  * This file must be `.svelte.ts` so it can use the Svelte 5 runes
  * `$state`, `$effect.root`, `$effect`, and `$state.snapshot` at module level.
@@ -54,7 +54,7 @@ function scheduleFlush(zone, shardId, value) {
     });
 }
 /**
- * Create live reactive state zones for a shard (or the shell itself).
+ * Create live reactive state zones for a shard (or the sh3 itself).
  *
  * Each zone declared in `schema` is backed by the appropriate store:
  * `ephemeral` and `session` are in-memory; `workspace` and `user` are
@@ -119,7 +119,7 @@ export function __setBackend(zone, backend) {
 /**
  * Read a raw persisted zone entry without creating a reactive proxy.
  *
- * Intended for framework-internal consumers (e.g. the shell's layout
+ * Intended for framework-internal consumers (e.g. the sh3's layout
  * persistence) that need to inspect a stored value before deciding
  * whether to pass it to `createStateZones`. Not part of the shard-facing
  * API — shards always go through `createStateZones` so hydration is

package/dist/theme.d.ts

@@ -1,7 +1,7 @@
 /**
  * Apply CSS token overrides to :root and persist to User zone.
  *
- * Keys are token names without the `--` prefix (e.g. `'shell-accent'`).
+ * Keys are token names without the `--` prefix (e.g. `'sh3-accent'`).
  * Values are any valid CSS value string.
  *
  * Calling this replaces ALL previous overrides — tokens not present in
@@ -10,7 +10,7 @@
 export declare function setTokenOverrides(overrides: Record<string, string>): void;
 /**
  * Remove all token overrides from :root and clear persisted state.
- * The shell reverts to the default tokens defined in tokens.css.
+ * The sh3 reverts to the default tokens defined in tokens.css.
  */
 export declare function clearTokenOverrides(): void;
 /**
@@ -19,7 +19,7 @@ export declare function clearTokenOverrides(): void;
  */
 export declare function getTokenOverrides(): Record<string, string>;
 /**
- * Apply persisted token overrides to :root. Called once during shell boot
+ * Apply persisted token overrides to :root. Called once during sh3 boot
  * before any component mounts, so the themed colors are visible from the
  * first frame.
  *

package/dist/theme.js

@@ -1,9 +1,9 @@
 /*
  * Token override API — allows external packages (like sh3-style) to
- * dynamically change shell CSS tokens and persist the selection to
+ * dynamically change sh3 CSS tokens and persist the selection to
  * the User zone.
  *
- * The shell reads persisted overrides at boot (see createShell.ts) so
+ * The sh3 reads persisted overrides at boot (see createShell.ts) so
  * themes survive page reloads. This module provides the write path.
  */
 const STORAGE_KEY = 'sh3:user:__sh3core__:theme';
@@ -12,7 +12,7 @@ let appliedKeys = [];
 /**
  * Apply CSS token overrides to :root and persist to User zone.
  *
- * Keys are token names without the `--` prefix (e.g. `'shell-accent'`).
+ * Keys are token names without the `--` prefix (e.g. `'sh3-accent'`).
  * Values are any valid CSS value string.
  *
  * Calling this replaces ALL previous overrides — tokens not present in
@@ -41,7 +41,7 @@ export function setTokenOverrides(overrides) {
 }
 /**
  * Remove all token overrides from :root and clear persisted state.
- * The shell reverts to the default tokens defined in tokens.css.
+ * The sh3 reverts to the default tokens defined in tokens.css.
  */
 export function clearTokenOverrides() {
     for (const key of appliedKeys) {
@@ -75,7 +75,7 @@ export function getTokenOverrides() {
     }
 }
 /**
- * Apply persisted token overrides to :root. Called once during shell boot
+ * Apply persisted token overrides to :root. Called once during sh3 boot
  * before any component mounts, so the themed colors are visible from the
  * first frame.
  *

package/dist/tokens.css

@@ -1,125 +1,125 @@
 /*
  * SH3 design tokens and base reset.
  *
- * All shell-level CSS variables live here. Shards may read --shell-* tokens
+ * All sh3-level CSS variables live here. Shards may read --sh3-* tokens
  * but must not override them. Z-indices for the overlay layer stack are the
  * ONLY place z-index is written in the codebase (per docs/design/layout.md).
  */
 
 :root {
   /* Surfaces */
-  --shell-bg:            #1a1b1e;
-  --shell-bg-elevated:   #22232a;
-  --shell-bg-sunken:     #141518;
+  --sh3-bg:            #1a1b1e;
+  --sh3-bg-elevated:   #22232a;
+  --sh3-bg-sunken:     #141518;
 
   /*
    * Gradient layer — undefined by default. When set (e.g. by sh3-style),
    * surfaces use the gradient instead of the flat color via the fallback
-   * pattern: background: var(--shell-grad-bg, var(--shell-bg)).
+   * pattern: background: var(--sh3-grad-bg, var(--sh3-bg)).
    * Do NOT declare these here — they must remain undefined for the
    * CSS fallback to work.
    */
 
-  --shell-border:        #2e3038;
-  --shell-border-strong: #3c3f4a;
+  --sh3-border:        #2e3038;
+  --sh3-border-strong: #3c3f4a;
 
   /* Text */
-  --shell-fg:         #e4e6eb;
-  --shell-fg-muted:   #9aa0aa;
-  --shell-fg-subtle:  #6b7280;
+  --sh3-fg:         #e4e6eb;
+  --sh3-fg-muted:   #9aa0aa;
+  --sh3-fg-subtle:  #6b7280;
 
   /* Accent */
-  --shell-accent:       #6ea8fe;
-  --shell-accent-muted: #3a5580;
+  --sh3-accent:       #6ea8fe;
+  --sh3-accent-muted: #3a5580;
 
   /* Inputs */
-  --shell-input-bg:           var(--shell-bg-sunken);
-  --shell-input-border-focus: var(--shell-accent);
-  --shell-focus-ring:         0 0 0 2px color-mix(in srgb, var(--shell-accent) 40%, transparent);
+  --sh3-input-bg:           var(--sh3-bg-sunken);
+  --sh3-input-border-focus: var(--sh3-accent);
+  --sh3-focus-ring:         0 0 0 2px color-mix(in srgb, var(--sh3-accent) 40%, transparent);
 
   /* Semantic */
-  --shell-error:   #f87171;
-  --shell-warning: #fbbf24;
-  --shell-success: #34d399;
+  --sh3-error:   #f87171;
+  --sh3-warning: #fbbf24;
+  --sh3-success: #34d399;
 
   /* Foreground pairings — the contrasting text/icon color for each
-     semantic surface. Used instead of --shell-fg when the background
-     is a saturated semantic color rather than --shell-bg. Theme
+     semantic surface. Used instead of --sh3-fg when the background
+     is a saturated semantic color rather than --sh3-bg. Theme
      overrides that change the surface hue should also update its
      paired foreground. */
-  --shell-fg-on-accent:  #ffffff;
-  --shell-fg-on-error:   #1a1b1e;
-  --shell-fg-on-warning: #1a1b1e;
-  --shell-fg-on-success: #1a1b1e;
+  --sh3-fg-on-accent:  #ffffff;
+  --sh3-fg-on-error:   #1a1b1e;
+  --sh3-fg-on-warning: #1a1b1e;
+  --sh3-fg-on-success: #1a1b1e;
 
   /* Typography */
-  --shell-font-ui:   system-ui, -apple-system, "Segoe UI", sans-serif;
-  --shell-font-mono: ui-monospace, "Cascadia Code", "Consolas", monospace;
-  --shell-font-size: 13px;
-  --shell-line:      1.45;
+  --sh3-font-ui:   system-ui, -apple-system, "Segoe UI", sans-serif;
+  --sh3-font-mono: ui-monospace, "Cascadia Code", "Consolas", monospace;
+  --sh3-font-size: 13px;
+  --sh3-line:      1.45;
 
   /* Radius */
-  --shell-radius-sm: 3px;
-  --shell-radius:    4px;
-  --shell-radius-md: 6px;
-  --shell-radius-lg: 8px;
+  --sh3-radius-sm: 3px;
+  --sh3-radius:    4px;
+  --sh3-radius-md: 6px;
+  --sh3-radius-lg: 8px;
 
   /* Spacing */
-  --shell-pad-xs: 2px;
-  --shell-pad-sm: 4px;
-  --shell-pad-md: 8px;
-  --shell-pad-lg: 12px;
+  --sh3-pad-xs: 2px;
+  --sh3-pad-sm: 4px;
+  --sh3-pad-md: 8px;
+  --sh3-pad-lg: 12px;
 
   /* Chrome metrics */
-  --shell-tabbar-height:    32px;
-  --shell-statusbar-height: 22px;
+  --sh3-tabbar-height:    32px;
+  --sh3-statusbar-height: 22px;
 
   /*
    * Overlay layer z-indices. See docs/design/layout.md — this is the single
    * source of truth for the layer stack. No component outside the overlay
    * layer managers is permitted to write a z-index.
    */
-  --shell-z-layer-0: 0;   /* docked layout (content area) */
-  --shell-z-layer-1: 100; /* floating panels (deferred)   */
-  --shell-z-layer-2: 200; /* drag preview                 */
-  --shell-z-layer-3: 300; /* popups, context menus        */
-  --shell-z-layer-4: 400; /* modals                       */
-  --shell-z-layer-5: 500; /* toasts                       */
-  --shell-z-layer-6: 600; /* command palette / AI input   */
+  --sh3-z-layer-0: 0;   /* docked layout (content area) */
+  --sh3-z-layer-1: 100; /* floating panels (deferred)   */
+  --sh3-z-layer-2: 200; /* drag preview                 */
+  --sh3-z-layer-3: 300; /* popups, context menus        */
+  --sh3-z-layer-4: 400; /* modals                       */
+  --sh3-z-layer-5: 500; /* toasts                       */
+  --sh3-z-layer-6: 600; /* command palette / AI input   */
 
   /* ── Widget tokens (ADR-022) ─────────────────────────────────────── */
 
   /* Field metrics — fields, selects, number inputs share these */
-  --shell-field-height-sm: 24px;
-  --shell-field-height-md: 28px;
-  --shell-field-pad-x:     10px;
+  --sh3-field-height-sm: 24px;
+  --sh3-field-height-md: 28px;
+  --sh3-field-pad-x:     10px;
 
   /* Slider tracks */
-  --shell-track-bg:     var(--shell-bg-sunken);
-  --shell-track-border: var(--shell-border);
-  --shell-track-fill:   var(--shell-accent);
+  --sh3-track-bg:     var(--sh3-bg-sunken);
+  --sh3-track-border: var(--sh3-border);
+  --sh3-track-fill:   var(--sh3-accent);
 
-  /* Slider thumbs — pinned to a fixed near-white instead of var(--shell-fg)
+  /* Slider thumbs — pinned to a fixed near-white instead of var(--sh3-fg)
      so light themes don't render a dark thumb. Themes that want a different
-     thumb override --shell-thumb-bg directly. */
-  --shell-thumb-bg:     #e4e6eb;
-  --shell-thumb-border: var(--shell-accent);
-  --shell-thumb-shadow: var(--shell-shadow-sm);
+     thumb override --sh3-thumb-bg directly. */
+  --sh3-thumb-bg:     #e4e6eb;
+  --sh3-thumb-border: var(--sh3-accent);
+  --sh3-thumb-shadow: var(--sh3-shadow-sm);
 
   /* Slider ticks */
-  --shell-tick-bg:        var(--shell-fg-subtle);
-  --shell-tick-strong-bg: var(--shell-border-strong);
+  --sh3-tick-bg:        var(--sh3-fg-subtle);
+  --sh3-tick-strong-bg: var(--sh3-border-strong);
 
   /* Widget radii */
-  --shell-widget-radius:      var(--shell-radius);
-  --shell-widget-radius-pill: 999px;
+  --sh3-widget-radius:      var(--sh3-radius);
+  --sh3-widget-radius-pill: 999px;
 
   /* Minimal shadow scale (1 token, just what thumbs need) */
-  --shell-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.35);
+  --sh3-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.35);
 
   /* Minimal motion scale */
-  --shell-motion-fast:   120ms;
-  --shell-ease-standard: cubic-bezier(0.2, 0, 0, 1);
+  --sh3-motion-fast:   120ms;
+  --sh3-ease-standard: cubic-bezier(0.2, 0, 0, 1);
 }
 
 /* Base reset — intentionally minimal */
@@ -135,11 +135,11 @@ body {
   padding: 0;
   height: 100%;
   overflow: hidden;
-  background: var(--shell-grad-bg, var(--shell-bg));
-  color: var(--shell-fg);
-  font-family: var(--shell-font-ui);
-  font-size: var(--shell-font-size);
-  line-height: var(--shell-line);
+  background: var(--sh3-grad-bg, var(--sh3-bg));
+  color: var(--sh3-fg);
+  font-family: var(--sh3-font-ui);
+  font-size: var(--sh3-font-size);
+  line-height: var(--sh3-line);
   -webkit-font-smoothing: antialiased;
 }
 

package/dist/verbs/types.d.ts

@@ -3,7 +3,7 @@ import type { SessionClient } from '../shell-shard/session-client.svelte';
 import type { TenantFsClient } from '../shell-shard/tenant-fs-client';
 import type { TreeRootRef } from '../layout/types';
 import type { DispatchToTerminalResult } from '../shell-shard/dispatch-to-terminal';
-export interface ShellApi {
+export interface Sh3Api {
     listApps(): Array<{
         id: string;
         label: string;
@@ -68,7 +68,7 @@ export interface ShellApi {
         admin: boolean;
     };
     /**
-     * Switch the active shell mode. The mode must be registered and visible
+     * Switch the active sh3 mode. The mode must be registered and visible
      * to the current role. Returns true on success, false on unknown or
      * role-restricted id (so verbs can surface a status).
      */
@@ -79,7 +79,7 @@ export interface ShellApi {
         label: string;
     }[];
     /**
-     * Active shell mode. Returns `{ id: 'sh3', label: 'sh3' }` from headless
+     * Active sh3 mode. Returns `{ id: 'sh3', label: 'sh3' }` from headless
      * contexts (no terminal view mounted) so callers can rely on a stable
      * shape — Terminal.svelte overrides this with the live mode.
      */
@@ -103,7 +103,7 @@ export interface ShellApi {
 }
 export type { DispatchToTerminalResult } from '../shell-shard/dispatch-to-terminal';
 export interface VerbContext {
-    shell: ShellApi;
+    sh3: Sh3Api;
     scrollback: Scrollback;
     session: SessionClient;
     cwd: string;
@@ -158,7 +158,7 @@ export interface Verb {
     name: string;
     summary: string;
     /**
-     * When true, this verb resolves in every shell mode — including bash and
+     * When true, this verb resolves in every sh3 mode — including bash and
      * external shards' custom modes. Defaults to false: sh3-domain verbs only
      * resolve when `mode.id === 'sh3'`. Reserve this flag for verbs whose
      * action is mode-agnostic (e.g. `clear` clears the local scrollback,

package/dist/verbs/types.js

@@ -2,7 +2,7 @@
  * Verb types — framework-level contribution kind.
  *
  * Shared between the framework verb registry (shards/registry.ts) and
- * shell-shard's resolution logic (shell-shard/registry.ts). ShellApi
+ * shell-shard's resolution logic (shell-shard/registry.ts). Sh3Api
  * stays in shell-shard — it's the Terminal's bridge to host actions.
  */
 export {};

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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

package/dist/Shell.svelte.d.ts

@@ -1,5 +0,0 @@
-import './tokens.css';
-import './primitives/base.css';
-declare const Shell: import("svelte").Component<Record<string, never>, {}, "">;
-type Shell = ReturnType<typeof Shell>;
-export default Shell;

package/dist/sh3core-shard/ShellHome.svelte.d.ts

@@ -1,3 +0,0 @@
-declare const ShellHome: import("svelte").Component<Record<string, never>, {}, "">;
-type ShellHome = ReturnType<typeof ShellHome>;
-export default ShellHome;

package/dist/sh3core-shard/ShellTitle.svelte.d.ts

@@ -1,3 +0,0 @@
-declare const ShellTitle: import("svelte").Component<Record<string, never>, {}, "">;
-type ShellTitle = ReturnType<typeof ShellTitle>;
-export default ShellTitle;

package/dist/shell-shard/shellApi.d.ts

@@ -1,4 +0,0 @@
-import type { ShellApi } from './registry';
-import type { ZoneManager } from '../state/types';
-export declare function makeShellApiHeadless(zones?: ZoneManager): ShellApi;
-export declare function makeShellApiForTest(): ShellApi;