@happyvertical/smrt-svelte 0.37.9 → 0.37.10

package/dist/components/workspace/admin-shell/state.svelte.js

@@ -0,0 +1,252 @@
+import { LocalStorageShellSettingsAdapter, mergeShellSettingsDelta, resolveInitialPanelState, resolveShellConfig, } from './settings.js';
+import { PANEL_EDGES, SCOPE_EDGES } from './types.js';
+export class ShellState {
+    config;
+    adapter;
+    settings = $state({});
+    panels = $state({
+        top: 'collapsed',
+        left: 'collapsed',
+        right: 'collapsed',
+        bottom: 'collapsed',
+    });
+    focusTools = $state([]);
+    activeFocusToolId = $state(null);
+    activities = $state([]);
+    activityListeners = new Set();
+    constructor(options = {}) {
+        this.config = resolveShellConfig(options.config);
+        this.adapter =
+            options.settingsAdapter ??
+                (options.storageKey
+                    ? new LocalStorageShellSettingsAdapter(options.storageKey)
+                    : null);
+        this.applySettings(options.settings ?? {}, { persist: false });
+    }
+    async hydrate() {
+        if (!this.adapter)
+            return;
+        const delta = await this.adapter.read();
+        if (delta)
+            this.applySettings(delta, { persist: false });
+    }
+    snapshot() {
+        return {
+            panels: { ...this.panels },
+            activeFocusToolId: this.activeFocusToolId,
+            settings: {
+                ...this.settings,
+                keymap: this.settings.keymap ? { ...this.settings.keymap } : undefined,
+                panels: this.settings.panels ? { ...this.settings.panels } : undefined,
+            },
+        };
+    }
+    applySettings(delta, options = {}) {
+        this.settings = mergeShellSettingsDelta(this.settings, delta);
+        for (const edge of PANEL_EDGES) {
+            this.panels[edge] = resolveInitialPanelState(edge, this.config.panels[edge], this.settings);
+        }
+        this.activeFocusToolId =
+            this.settings.activeFocusToolId ?? this.activeFocusToolId;
+        if (options.persist !== false)
+            void this.persistSettings();
+    }
+    setHotkeysEnabled(enabled) {
+        this.applySettings({ hotkeysEnabled: enabled });
+    }
+    setHotkey(edge, code) {
+        this.applySettings({
+            keymap: {
+                [edge]: code ? { code } : null,
+            },
+        });
+    }
+    setPanel(edge, state) {
+        if (this.config.panels[edge].initial === 'hidden') {
+            this.panels[edge] = 'hidden';
+            return;
+        }
+        if (state === 'expanded')
+            this.closeExclusivePeers(edge);
+        this.panels[edge] = state;
+        this.settings = mergeShellSettingsDelta(this.settings, {
+            panels: { [edge]: state },
+        });
+        void this.persistSettings();
+    }
+    togglePanel(edge) {
+        if (this.panels[edge] === 'hidden')
+            return;
+        this.setPanel(edge, this.panels[edge] === 'expanded' ? 'collapsed' : 'expanded');
+    }
+    expandPanel(edge) {
+        this.setPanel(edge, 'expanded');
+    }
+    collapsePanel(edge) {
+        this.setPanel(edge, 'collapsed');
+    }
+    closeTopmostExpanded() {
+        for (const edge of [...PANEL_EDGES].reverse()) {
+            if (this.panels[edge] === 'expanded') {
+                this.collapsePanel(edge);
+                return true;
+            }
+        }
+        return false;
+    }
+    registerFocusTool(tool) {
+        this.focusTools = [
+            ...this.focusTools.filter((existing) => existing.id !== tool.id),
+            tool,
+        ].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+        if (!this.activeFocusToolId)
+            this.activeFocusToolId = tool.id;
+        return () => this.unregisterFocusTool(tool.id);
+    }
+    unregisterFocusTool(id) {
+        this.focusTools = this.focusTools.filter((tool) => tool.id !== id);
+        if (this.activeFocusToolId === id) {
+            this.activeFocusToolId = this.focusTools[0]?.id ?? null;
+        }
+    }
+    openFocusTool(id) {
+        if (!this.focusTools.some((tool) => tool.id === id))
+            return;
+        this.activeFocusToolId = id;
+        this.settings = mergeShellSettingsDelta(this.settings, {
+            activeFocusToolId: id,
+        });
+        this.expandPanel('right');
+        void this.persistSettings();
+    }
+    upsertActivity(activity) {
+        const now = new Date().toISOString();
+        const normalized = {
+            ...activity,
+            edge: activity.edge ?? this.homeEdgeForScope(activity.scope),
+            createdAt: activity.createdAt ?? now,
+            updatedAt: activity.updatedAt ?? now,
+        };
+        const previous = this.activities.find((item) => item.id === activity.id);
+        this.activities = [
+            ...this.activities.filter((item) => item.id !== activity.id),
+            normalized,
+        ];
+        this.emitActivity({
+            type: previous && previous.status !== normalized.status
+                ? 'transition'
+                : 'upsert',
+            activity: normalized,
+            previous,
+        });
+    }
+    updateActivity(id, patch) {
+        const current = this.activities.find((activity) => activity.id === id);
+        if (!current)
+            return;
+        this.upsertActivity({
+            ...current,
+            ...patch,
+            id,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    removeActivity(id) {
+        const current = this.activities.find((activity) => activity.id === id);
+        if (!current)
+            return;
+        this.activities = this.activities.filter((activity) => activity.id !== id);
+        this.emitActivity({ type: 'remove', activity: current });
+    }
+    watchActivities(listener) {
+        this.activityListeners.add(listener);
+        return () => this.activityListeners.delete(listener);
+    }
+    listActivities(filter = {}) {
+        return this.activities
+            .map((activity) => ({
+            ...activity,
+            edge: activity.edge ?? this.homeEdgeForScope(activity.scope),
+        }))
+            .filter((activity) => activityMatchesFilter(activity, filter));
+    }
+    activityBadge(edge) {
+        const activities = this.listActivities({ edge }).filter((activity) => isActiveStatus(activity.status));
+        const determinate = activities
+            .map((activity) => activity.progress)
+            .filter((progress) => typeof progress === 'number');
+        return {
+            count: activities.length,
+            running: activities.filter((activity) => activity.status === 'running')
+                .length,
+            hasFailed: this.listActivities({ edge }).some((activity) => activity.status === 'failed'),
+            progress: determinate.length === 0
+                ? null
+                : determinate.reduce((total, progress) => total + progress, 0) /
+                    determinate.length,
+        };
+    }
+    homeEdgeForScope(scope) {
+        const preferred = SCOPE_EDGES[scope];
+        if (this.panels[preferred] !== 'hidden')
+            return preferred;
+        if (this.panels.bottom !== 'hidden')
+            return 'bottom';
+        // Both the scope's edge and System are hidden — fall back to any visible
+        // edge so the activity still surfaces somewhere rather than homing to a
+        // hidden edge where its badge never renders.
+        const visible = PANEL_EDGES.find((edge) => this.panels[edge] !== 'hidden');
+        return visible ?? preferred;
+    }
+    closeExclusivePeers(edge) {
+        const group = this.config.panels[edge].exclusiveGroup;
+        if (!group)
+            return;
+        for (const peer of PANEL_EDGES) {
+            if (peer !== edge &&
+                this.config.panels[peer].exclusiveGroup === group &&
+                this.panels[peer] === 'expanded') {
+                this.panels[peer] = 'collapsed';
+                // Persist the peer collapse too, otherwise its stale 'expanded' delta
+                // survives and both panels reopen on reload, defeating exclusivity.
+                this.settings = mergeShellSettingsDelta(this.settings, {
+                    panels: { [peer]: 'collapsed' },
+                });
+            }
+        }
+    }
+    async persistSettings() {
+        await this.adapter?.write(this.settings);
+    }
+    emitActivity(event) {
+        for (const listener of this.activityListeners)
+            listener(event);
+    }
+}
+export function createShellState(options = {}) {
+    return new ShellState(options);
+}
+function activityMatchesFilter(activity, filter) {
+    if (filter.edge && activity.edge !== filter.edge)
+        return false;
+    if (filter.scope && activity.scope !== filter.scope)
+        return false;
+    if (filter.kind && !matchesOne(activity.kind, filter.kind))
+        return false;
+    if (filter.status && !matchesOne(activity.status, filter.status)) {
+        return false;
+    }
+    if (filter.subject) {
+        return (activity.subject?.type === filter.subject.type &&
+            activity.subject.id === filter.subject.id);
+    }
+    return true;
+}
+function matchesOne(value, expected) {
+    return Array.isArray(expected)
+        ? expected.includes(value)
+        : value === expected;
+}
+function isActiveStatus(status) {
+    return status === 'queued' || status === 'running';
+}

package/dist/components/workspace/admin-shell/types.d.ts

@@ -0,0 +1,137 @@
+import type { Component, Snippet } from 'svelte';
+export type PanelEdge = 'top' | 'left' | 'right' | 'bottom';
+export type ShellScope = 'app' | 'tenant' | 'focus' | 'system';
+export type PanelState = 'hidden' | 'collapsed' | 'expanded';
+export type VisiblePanelState = Exclude<PanelState, 'hidden'>;
+export type PanelPresentation = 'push' | 'overlay';
+export type ActivityStatus = 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+export interface ShellHotkeyBinding {
+    code: string;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+}
+export interface ShellPanelConfig {
+    edge: PanelEdge;
+    scope: ShellScope;
+    label: string;
+    initial: PanelState;
+    presentation: PanelPresentation;
+    hotkey: ShellHotkeyBinding | null;
+    collapsedSize: string;
+    expandedSize: string;
+    exclusiveGroup?: string;
+}
+export type ShellPanelDefaults = Partial<Record<PanelEdge, Partial<ShellPanelConfig> | false>>;
+export interface ShellSettingsDelta {
+    hotkeysEnabled?: boolean;
+    keymap?: Partial<Record<PanelEdge, ShellHotkeyBinding | null>>;
+    panels?: Partial<Record<PanelEdge, VisiblePanelState>>;
+    activeFocusToolId?: string | null;
+}
+export interface ShellSettingsAdapter {
+    read(): ShellSettingsDelta | null | Promise<ShellSettingsDelta | null>;
+    write(delta: ShellSettingsDelta): void | Promise<void>;
+}
+export interface ResolvedShellConfig {
+    panels: Record<PanelEdge, ShellPanelConfig>;
+}
+export interface ShellFocusToolSubject {
+    type: string;
+    id: string;
+    label?: string;
+}
+export interface ShellNavItem {
+    href: string;
+    label: string;
+    icon?: string;
+    description?: string;
+    badge?: number | string | null;
+    children?: ShellNavItem[];
+}
+export interface ShellFocusTool {
+    id: string;
+    label: string;
+    description?: string;
+    order?: number;
+    badge?: number | string | null;
+    component?: Component | null;
+    render?: Snippet<[{
+        tool: ShellFocusTool;
+    }]>;
+    scopeId?: string;
+    subject?: ShellFocusToolSubject;
+    activityKinds?: string[];
+}
+export interface ShellActivity {
+    id: string;
+    label: string;
+    kind: string;
+    scope: ShellScope;
+    status: ActivityStatus;
+    subject?: ShellFocusToolSubject;
+    edge?: PanelEdge;
+    progress?: number | null;
+    detailHref?: string;
+    message?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    cancel?: () => void | Promise<void>;
+}
+export interface ShellActivityFilter {
+    edge?: PanelEdge;
+    scope?: ShellScope;
+    kind?: string | string[];
+    status?: ActivityStatus | ActivityStatus[];
+    subject?: ShellFocusToolSubject;
+}
+export interface ShellActivityBadge {
+    count: number;
+    running: number;
+    hasFailed: boolean;
+    progress: number | null;
+}
+export interface ShellActivityEvent {
+    type: 'upsert' | 'transition' | 'remove';
+    activity: ShellActivity;
+    previous?: ShellActivity;
+}
+export type ShellStatusTone = 'neutral' | 'success' | 'warning' | 'error' | 'info';
+export interface ShellStatusChip {
+    id: string;
+    label: string;
+    value?: string | number;
+    tone?: ShellStatusTone;
+    href?: string;
+}
+export interface ShellSystemItem {
+    id: string;
+    label: string;
+    status: string;
+    detail?: string;
+    href?: string;
+    updatedAt?: string;
+}
+export interface ShellSystemPanel {
+    id: string;
+    label: string;
+    items: ShellSystemItem[];
+}
+export interface ShellStateSnapshot {
+    panels: Record<PanelEdge, PanelState>;
+    activeFocusToolId: string | null;
+    settings: ShellSettingsDelta;
+}
+export interface AdminShellProps {
+    title?: string;
+    subtitle?: string;
+    config?: ShellPanelDefaults;
+    settings?: ShellSettingsDelta;
+    settingsAdapter?: ShellSettingsAdapter;
+    storageKey?: string;
+}
+export declare const PANEL_EDGES: PanelEdge[];
+export declare const EDGE_SCOPES: Record<PanelEdge, ShellScope>;
+export declare const SCOPE_EDGES: Record<ShellScope, PanelEdge>;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/workspace/admin-shell/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/types.ts"],"names":[],"mappings":"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"}

package/dist/components/workspace/admin-shell/types.js

@@ -0,0 +1,13 @@
+export const PANEL_EDGES = ['top', 'left', 'right', 'bottom'];
+export const EDGE_SCOPES = {
+    top: 'app',
+    left: 'tenant',
+    right: 'focus',
+    bottom: 'system',
+};
+export const SCOPE_EDGES = {
+    app: 'top',
+    tenant: 'left',
+    focus: 'right',
+    system: 'bottom',
+};

package/dist/components/workspace/index.d.ts

@@ -1,16 +1,30 @@
 /**
  * @happyvertical/smrt-svelte/workspace
  *
- * Workspace shell primitives for admin UIs. See packages/smrt-svelte/CLAUDE.md
- * for layering principles. Implementations land via #1227, #1228, #1229.
+ * Canonical AdminShell family for SMRT admin UIs. The first-generation
+ * WorkspaceShell / RoleShell / NavTree / ToolsDock source files remain in this
+ * package as migration references, but the public workspace surface now points
+ * at the four-edge AdminShell contract.
  */
-export { default as Breadcrumbs } from './Breadcrumbs.svelte';
-export { type NavSection, type NavTreeFromManifestOptions, navTreeFromManifest, pluralizeClassName, type SmrtManifestEntryLike, type SmrtManifestLike, } from './manifest-nav.js';
-export { default as NavTree } from './NavTree.svelte';
-export { default as RoleShell } from './RoleShell.svelte';
-export { type DefineToolsDockOptions, defineToolsDock, TOOLS_DOCK_KEY, type ToolsDockInstance, } from './tools-dock/define-tools-dock.svelte.js';
-export { default as ToolsDock } from './tools-dock/ToolsDock.svelte';
-export { tryUseToolsDock, useToolsDock } from './tools-dock/use-tools-dock.js';
-export type { AvailableTool, BreadcrumbItem, NavItem, RoleConfig, ToolDef, ToolsDockApi, ToolsDockContext, ToolsDockEvents, } from './types.js';
-export { default as WorkspaceShell } from './WorkspaceShell.svelte';
+export { default as ActivityBadge } from './admin-shell/ActivityBadge.svelte';
+export { default as ActivityItem } from './admin-shell/ActivityItem.svelte';
+export { default as ActivityList } from './admin-shell/ActivityList.svelte';
+export { default as ActivityToasts } from './admin-shell/ActivityToasts.svelte';
+export { default as AdminShell } from './admin-shell/AdminShell.svelte';
+export { default as AppScopePanel } from './admin-shell/AppScopePanel.svelte';
+export { ADMIN_SHELL_CONTEXT, setAdminShell, tryUseAdminShell, useAdminShell, } from './admin-shell/context.js';
+export { default as HotkeyInput } from './admin-shell/HotkeyInput.svelte';
+export { formatHotkeyBinding, hotkeyMatchesEvent, isEditableTarget, isShortcutsEvent, type ShellHotkeyAction, shellActionFromKeyboardEvent, shouldIgnoreShellHotkey, } from './admin-shell/hotkeys.js';
+export { default as ShellCorner } from './admin-shell/ShellCorner.svelte';
+export { default as ShellDockTool } from './admin-shell/ShellDockTool.svelte';
+export { default as ShellSettingsPanel } from './admin-shell/ShellSettingsPanel.svelte';
+export { default as ShortcutsOverlay } from './admin-shell/ShortcutsOverlay.svelte';
+export { default as SystemScopePanel } from './admin-shell/SystemScopePanel.svelte';
+export { default as SystemStatusChips } from './admin-shell/SystemStatusChips.svelte';
+export { DEFAULT_SHELL_KEYMAP, LocalStorageShellSettingsAdapter, mergeShellSettingsDelta, pruneShellSettingsDelta, resolveHotkey, resolveInitialPanelState, resolveShellConfig, } from './admin-shell/settings.js';
+export { createShellState, ShellState } from './admin-shell/state.svelte.js';
+export { default as TenantNav } from './admin-shell/TenantNav.svelte';
+export type { ActivityStatus, AdminShellProps, PanelEdge, PanelPresentation, PanelState, ResolvedShellConfig, ShellActivity, ShellActivityBadge, ShellActivityEvent, ShellActivityFilter, ShellFocusTool, ShellFocusToolSubject, ShellHotkeyBinding, ShellNavItem, ShellPanelConfig, ShellPanelDefaults, ShellScope, ShellSettingsAdapter, ShellSettingsDelta, ShellStateSnapshot, ShellStatusChip, ShellStatusTone, ShellSystemItem, ShellSystemPanel, VisiblePanelState, } from './admin-shell/types.js';
+export { EDGE_SCOPES, PANEL_EDGES, SCOPE_EDGES } from './admin-shell/types.js';
+export { type NavSection, type NavTreeFromManifestOptions, navTreeFromManifest as tenantNavFromManifest, pluralizeClassName, type SmrtManifestEntryLike, type SmrtManifestLike, } from './manifest-nav.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,KAAK,UAAU,EACf,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,EACf,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACP,UAAU,EACV,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,uBAAuB,EACvB,uBAAuB,EACvB,aAAa,EACb,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EACV,cAAc,EACd,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,0BAA0B,EAC/B,mBAAmB,IAAI,qBAAqB,EAC5C,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/components/workspace/index.js

@@ -1,14 +1,28 @@
 /**
  * @happyvertical/smrt-svelte/workspace
  *
- * Workspace shell primitives for admin UIs. See packages/smrt-svelte/CLAUDE.md
- * for layering principles. Implementations land via #1227, #1228, #1229.
+ * Canonical AdminShell family for SMRT admin UIs. The first-generation
+ * WorkspaceShell / RoleShell / NavTree / ToolsDock source files remain in this
+ * package as migration references, but the public workspace surface now points
+ * at the four-edge AdminShell contract.
  */
-export { default as Breadcrumbs } from './Breadcrumbs.svelte';
-export { navTreeFromManifest, pluralizeClassName, } from './manifest-nav.js';
-export { default as NavTree } from './NavTree.svelte';
-export { default as RoleShell } from './RoleShell.svelte';
-export { defineToolsDock, TOOLS_DOCK_KEY, } from './tools-dock/define-tools-dock.svelte.js';
-export { default as ToolsDock } from './tools-dock/ToolsDock.svelte';
-export { tryUseToolsDock, useToolsDock } from './tools-dock/use-tools-dock.js';
-export { default as WorkspaceShell } from './WorkspaceShell.svelte';
+export { default as ActivityBadge } from './admin-shell/ActivityBadge.svelte';
+export { default as ActivityItem } from './admin-shell/ActivityItem.svelte';
+export { default as ActivityList } from './admin-shell/ActivityList.svelte';
+export { default as ActivityToasts } from './admin-shell/ActivityToasts.svelte';
+export { default as AdminShell } from './admin-shell/AdminShell.svelte';
+export { default as AppScopePanel } from './admin-shell/AppScopePanel.svelte';
+export { ADMIN_SHELL_CONTEXT, setAdminShell, tryUseAdminShell, useAdminShell, } from './admin-shell/context.js';
+export { default as HotkeyInput } from './admin-shell/HotkeyInput.svelte';
+export { formatHotkeyBinding, hotkeyMatchesEvent, isEditableTarget, isShortcutsEvent, shellActionFromKeyboardEvent, shouldIgnoreShellHotkey, } from './admin-shell/hotkeys.js';
+export { default as ShellCorner } from './admin-shell/ShellCorner.svelte';
+export { default as ShellDockTool } from './admin-shell/ShellDockTool.svelte';
+export { default as ShellSettingsPanel } from './admin-shell/ShellSettingsPanel.svelte';
+export { default as ShortcutsOverlay } from './admin-shell/ShortcutsOverlay.svelte';
+export { default as SystemScopePanel } from './admin-shell/SystemScopePanel.svelte';
+export { default as SystemStatusChips } from './admin-shell/SystemStatusChips.svelte';
+export { DEFAULT_SHELL_KEYMAP, LocalStorageShellSettingsAdapter, mergeShellSettingsDelta, pruneShellSettingsDelta, resolveHotkey, resolveInitialPanelState, resolveShellConfig, } from './admin-shell/settings.js';
+export { createShellState, ShellState } from './admin-shell/state.svelte.js';
+export { default as TenantNav } from './admin-shell/TenantNav.svelte';
+export { EDGE_SCOPES, PANEL_EDGES, SCOPE_EDGES } from './admin-shell/types.js';
+export { navTreeFromManifest as tenantNavFromManifest, pluralizeClassName, } from './manifest-nav.js';

package/dist/i18n/strings.workspace.d.ts

@@ -26,5 +26,35 @@ export declare const M: {
     readonly 'ui.tools_dock.no_tools_context': "ui.tools_dock.no_tools_context";
     readonly 'ui.tools_dock.select_tool': "ui.tools_dock.select_tool";
     readonly 'ui.tools_dock.workspace_tools': "ui.tools_dock.workspace_tools";
+    readonly 'ui.admin_shell.no_focus_tools': "ui.admin_shell.no_focus_tools";
+    readonly 'ui.admin_shell.no_app_panel': "ui.admin_shell.no_app_panel";
+    readonly 'ui.admin_shell.no_system_panel': "ui.admin_shell.no_system_panel";
+    readonly 'ui.admin_shell.shell_shortcuts': "ui.admin_shell.shell_shortcuts";
+    readonly 'ui.admin_shell.close_shortcuts': "ui.admin_shell.close_shortcuts";
+    readonly 'ui.admin_shell.shortcuts': "ui.admin_shell.shortcuts";
+    readonly 'ui.admin_shell.close': "ui.admin_shell.close";
+    readonly 'ui.activity_toasts.dismiss': "ui.activity_toasts.dismiss";
+    readonly 'ui.activity_toasts.dismiss_action': "ui.activity_toasts.dismiss_action";
+    readonly 'ui.activity_item.view': "ui.activity_item.view";
+    readonly 'ui.activity_item.cancel': "ui.activity_item.cancel";
+    readonly 'ui.activity_list.empty': "ui.activity_list.empty";
+    readonly 'ui.app_scope_panel.app_scope': "ui.app_scope_panel.app_scope";
+    readonly 'ui.hotkey_input.capture_title': "ui.hotkey_input.capture_title";
+    readonly 'ui.hotkey_input.conflicts_with': "ui.hotkey_input.conflicts_with";
+    readonly 'ui.shell_settings_panel.shell_settings': "ui.shell_settings_panel.shell_settings";
+    readonly 'ui.shell_settings_panel.description': "ui.shell_settings_panel.description";
+    readonly 'ui.shell_settings_panel.disable_hotkeys': "ui.shell_settings_panel.disable_hotkeys";
+    readonly 'ui.shell_settings_panel.enable_hotkeys': "ui.shell_settings_panel.enable_hotkeys";
+    readonly 'ui.shell_settings_panel.collapse': "ui.shell_settings_panel.collapse";
+    readonly 'ui.shell_settings_panel.expand': "ui.shell_settings_panel.expand";
+    readonly 'ui.shortcuts_overlay.open_shortcuts': "ui.shortcuts_overlay.open_shortcuts";
+    readonly 'ui.shortcuts_overlay.close_drawer': "ui.shortcuts_overlay.close_drawer";
+    readonly 'ui.shortcuts_overlay.close': "ui.shortcuts_overlay.close";
+    readonly 'ui.shortcuts_overlay.escape': "ui.shortcuts_overlay.escape";
+    readonly 'ui.system_scope_panel.system_scope': "ui.system_scope_panel.system_scope";
+    readonly 'ui.system_scope_panel.activities': "ui.system_scope_panel.activities";
+    readonly 'ui.system_scope_panel.no_running_work': "ui.system_scope_panel.no_running_work";
+    readonly 'ui.system_status_chips.system_status': "ui.system_status_chips.system_status";
+    readonly 'ui.tenant_nav.tenant_navigation': "ui.tenant_nav.tenant_navigation";
 };
 //# sourceMappingURL=strings.workspace.d.ts.map

package/dist/i18n/strings.workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.workspace.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;CAuBZ,CAAC"}
+{"version":3,"file":"strings.workspace.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDZ,CAAC"}

package/dist/i18n/strings.workspace.js

@@ -30,4 +30,35 @@ export const M = defineMessages({
     'ui.tools_dock.no_tools_context': 'No tools are available for the current context.',
     'ui.tools_dock.select_tool': 'Select a tool to begin.',
     'ui.tools_dock.workspace_tools': 'Workspace tools',
+    // components/workspace/admin-shell/*
+    'ui.admin_shell.no_focus_tools': 'No focus tools',
+    'ui.admin_shell.no_app_panel': 'No app panel',
+    'ui.admin_shell.no_system_panel': 'No system panel',
+    'ui.admin_shell.shell_shortcuts': 'Shell shortcuts',
+    'ui.admin_shell.close_shortcuts': 'Close shortcuts',
+    'ui.admin_shell.shortcuts': 'Shortcuts',
+    'ui.admin_shell.close': 'Close',
+    'ui.activity_toasts.dismiss': 'Dismiss activity notification',
+    'ui.activity_toasts.dismiss_action': 'Dismiss',
+    'ui.activity_item.view': 'View',
+    'ui.activity_item.cancel': 'Cancel',
+    'ui.activity_list.empty': 'No activities',
+    'ui.app_scope_panel.app_scope': 'App scope',
+    'ui.hotkey_input.capture_title': 'Press a key to capture it',
+    'ui.hotkey_input.conflicts_with': 'Conflicts with',
+    'ui.shell_settings_panel.shell_settings': 'Shell settings',
+    'ui.shell_settings_panel.description': 'Panel preferences and physical-key shortcuts.',
+    'ui.shell_settings_panel.disable_hotkeys': 'Disable hotkeys',
+    'ui.shell_settings_panel.enable_hotkeys': 'Enable hotkeys',
+    'ui.shell_settings_panel.collapse': 'Collapse',
+    'ui.shell_settings_panel.expand': 'Expand',
+    'ui.shortcuts_overlay.open_shortcuts': 'Open shortcuts',
+    'ui.shortcuts_overlay.close_drawer': 'Close drawer',
+    'ui.shortcuts_overlay.close': 'Close',
+    'ui.shortcuts_overlay.escape': 'Esc',
+    'ui.system_scope_panel.system_scope': 'System scope',
+    'ui.system_scope_panel.activities': 'Activities',
+    'ui.system_scope_panel.no_running_work': 'No running work',
+    'ui.system_status_chips.system_status': 'System status',
+    'ui.tenant_nav.tenant_navigation': 'Tenant navigation',
 });

package/dist/web/__tests__/harness.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+/**
+ * Test harness — invokes liveCollection() inside a component init scope so the
+ * `$effect` that `useLiveQuery` installs wires up correctly, then hands the
+ * returned reactive view back to the test via the `onReady` callback prop.
+ */
+import type { SmrtWebCollection } from '@happyvertical/smrt-web';
+import {
+  type LiveCollection,
+  liveCollection,
+} from '../live-collection.svelte.js';
+
+interface Props {
+  handle: SmrtWebCollection<Record<string, unknown>>;
+  onReady: (view: LiveCollection<Record<string, unknown>>) => void;
+}
+
+const props: Props = $props();
+// This harness intentionally snapshots the handle during setup.
+// svelte-ignore state_referenced_locally
+const view = liveCollection(props.handle);
+// This harness intentionally snapshots the callback during setup.
+// svelte-ignore state_referenced_locally
+props.onReady(view);
+</script>

package/dist/web/__tests__/harness.svelte.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Test harness — invokes liveCollection() inside a component init scope so the
+ * `$effect` that `useLiveQuery` installs wires up correctly, then hands the
+ * returned reactive view back to the test via the `onReady` callback prop.
+ */
+import type { SmrtWebCollection } from '@happyvertical/smrt-web';
+import { type LiveCollection } from '../live-collection.svelte.js';
+interface Props {
+    handle: SmrtWebCollection<Record<string, unknown>>;
+    onReady: (view: LiveCollection<Record<string, unknown>>) => void;
+}
+declare const Harness: import("svelte").Component<Props, {}, "">;
+type Harness = ReturnType<typeof Harness>;
+export default Harness;
+//# sourceMappingURL=harness.svelte.d.ts.map

package/dist/web/__tests__/harness.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/harness.svelte.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,8BAA8B,CAAC;AAGtC,UAAU,KAAK;IACb,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CAClE;AAkBD,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}