sh3-core 0.20.1 → 0.20.3

package/dist/primitives/widgets/_DocumentBrowser.svelte.test.js

@@ -0,0 +1,277 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { render, fireEvent, screen } from '@testing-library/svelte';
+import DocumentBrowser from './_DocumentBrowser.svelte';
+function makeHandle() {
+    return {
+        mkdir: vi.fn().mockResolvedValue(undefined),
+        rmdir: vi.fn().mockResolvedValue(undefined),
+        renameFolder: vi.fn().mockResolvedValue(undefined),
+        rename: vi.fn().mockResolvedValue(undefined),
+        delete: vi.fn().mockResolvedValue(undefined),
+    };
+}
+const sampleDocs = [
+    { shardId: 'sh1', path: 'a.md', size: 100, lastModified: 0 },
+    { shardId: 'sh1', path: 'sub/b.md', size: 200, lastModified: 0 },
+];
+function baseProps(extra = {}) {
+    return Object.assign({ mode: 'open', docs: sampleDocs, onCommit: vi.fn(), onCancel: vi.fn(), close: vi.fn() }, extra);
+}
+describe('_DocumentBrowser toolbar visibility', () => {
+    it('toolbar is hidden at the shard-list view (shardId === null)', async () => {
+        render(DocumentBrowser, { props: baseProps({ handle: makeHandle() }) });
+        expect(document.querySelector('.sh3-doc-browser__toolbar')).toBeNull();
+    });
+    it('toolbar is visible when inside a shard and handle is provided', async () => {
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle: makeHandle() }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        expect(container.querySelector('.sh3-doc-browser__toolbar')).not.toBeNull();
+    });
+    it('toolbar is hidden when readOnlyShard returns true', async () => {
+        const { container } = render(DocumentBrowser, {
+            props: baseProps({ handle: makeHandle(), readOnlyShard: () => true }),
+        });
+        await fireEvent.click(screen.getByText('sh1'));
+        expect(container.querySelector('.sh3-doc-browser__toolbar')).toBeNull();
+    });
+    it('toolbar is hidden when no handle is provided', async () => {
+        const { container } = render(DocumentBrowser, { props: baseProps() });
+        await fireEvent.click(screen.getByText('sh1'));
+        expect(container.querySelector('.sh3-doc-browser__toolbar')).toBeNull();
+    });
+});
+describe('_DocumentBrowser navigation', () => {
+    it('clicking a shard navigates into it and shows its contents', async () => {
+        render(DocumentBrowser, { props: baseProps() });
+        expect(screen.getByText('sh1')).not.toBeNull();
+        await fireEvent.click(screen.getByText('sh1'));
+        expect(screen.getByText('a.md')).not.toBeNull();
+        expect(screen.getByText('sub')).not.toBeNull();
+    });
+    it('double-clicking a file commits it in open mode', async () => {
+        const onCommit = vi.fn();
+        const close = vi.fn();
+        render(DocumentBrowser, { props: baseProps({ onCommit, close }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.dblClick(screen.getByText('a.md'));
+        expect(onCommit).toHaveBeenCalledWith({ shardId: 'sh1', path: 'a.md', kind: 'file' });
+        expect(close).toHaveBeenCalled();
+    });
+    it('double-clicking a folder navigates into it', async () => {
+        render(DocumentBrowser, { props: baseProps() });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.dblClick(screen.getByText('sub'));
+        expect(screen.getByText('b.md')).not.toBeNull();
+    });
+    it('clicking a folder with selectable=folder selects it, not navigates', async () => {
+        const onCommit = vi.fn();
+        render(DocumentBrowser, {
+            props: baseProps({ onCommit, selectable: 'folder' }),
+        });
+        // Use dblClick to navigate into sh1 (dblClick always navigates)
+        await fireEvent.dblClick(screen.getByText('sh1'));
+        // Now inside sh1: clicking sub should select it, not navigate
+        await fireEvent.click(screen.getByText('sub'));
+        expect(screen.queryByText('b.md')).toBeNull(); // not navigated
+        // Open button should be enabled since a folder is selected
+        const openBtn = screen.getByText('Open');
+        expect(openBtn.disabled).toBe(false);
+    });
+});
+describe('_DocumentBrowser commit and cancel', () => {
+    it('Open button is disabled when nothing is selected', async () => {
+        render(DocumentBrowser, { props: baseProps() });
+        await fireEvent.click(screen.getByText('sh1'));
+        const openBtn = screen.getByText('Open');
+        expect(openBtn.disabled).toBe(true);
+    });
+    it('Open button is enabled when a file is selected', async () => {
+        render(DocumentBrowser, { props: baseProps() });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const openBtn = screen.getByText('Open');
+        expect(openBtn.disabled).toBe(false);
+    });
+    it('clicking Open commits the selected file', async () => {
+        const onCommit = vi.fn();
+        const close = vi.fn();
+        render(DocumentBrowser, { props: baseProps({ onCommit, close }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        await fireEvent.click(screen.getByText('Open'));
+        expect(onCommit).toHaveBeenCalledWith({ shardId: 'sh1', path: 'a.md', kind: 'file' });
+        expect(close).toHaveBeenCalled();
+    });
+    it('Cancel calls onCancel and close', async () => {
+        const onCancel = vi.fn();
+        const close = vi.fn();
+        render(DocumentBrowser, { props: baseProps({ onCancel, close }) });
+        await fireEvent.click(screen.getByText('Cancel'));
+        expect(onCancel).toHaveBeenCalled();
+        expect(close).toHaveBeenCalled();
+    });
+});
+describe('_DocumentBrowser new folder', () => {
+    beforeEach(() => { vi.clearAllMocks(); });
+    it('clicking New folder shows an inline editable row', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        const newFolderBtn = container.querySelector('[title="New folder"]');
+        await fireEvent.click(newFolderBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        expect(input).not.toBeNull();
+    });
+    it('entering a name and pressing Enter calls handle.mkdir', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        const newFolderBtn = container.querySelector('[title="New folder"]');
+        await fireEvent.click(newFolderBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        await fireEvent.input(input, { target: { value: 'newdir' } });
+        await fireEvent.keyDown(input, { key: 'Enter' });
+        expect(handle.mkdir).toHaveBeenCalledWith('sh1', 'newdir');
+    });
+    it('Esc cancels new folder without calling mkdir', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        const newFolderBtn = container.querySelector('[title="New folder"]');
+        await fireEvent.click(newFolderBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        await fireEvent.keyDown(input, { key: 'Escape' });
+        expect(handle.mkdir).not.toHaveBeenCalled();
+        expect(container.querySelector('.sh3-doc-browser__rename-input')).toBeNull();
+    });
+    it('duplicate name shows error and does not call mkdir', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        const newFolderBtn = container.querySelector('[title="New folder"]');
+        await fireEvent.click(newFolderBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        // 'sub' already exists as a folder from sampleDocs
+        await fireEvent.input(input, { target: { value: 'sub' } });
+        await fireEvent.keyDown(input, { key: 'Enter' });
+        expect(handle.mkdir).not.toHaveBeenCalled();
+        const errorEl = container.querySelector('.sh3-doc-browser__toolbar-error');
+        expect(errorEl === null || errorEl === void 0 ? void 0 : errorEl.textContent).toMatch(/already exists/);
+    });
+});
+describe('_DocumentBrowser rename', () => {
+    beforeEach(() => { vi.clearAllMocks(); });
+    it('clicking Rename while a file is selected shows inline input', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const renameBtn = container.querySelector('[title="Rename"]');
+        await fireEvent.click(renameBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        expect(input).not.toBeNull();
+        expect(input.value).toBe('a.md');
+    });
+    it('confirming rename calls handle.rename', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const renameBtn = container.querySelector('[title="Rename"]');
+        await fireEvent.click(renameBtn);
+        const input = container.querySelector('.sh3-doc-browser__rename-input');
+        await fireEvent.input(input, { target: { value: 'renamed.md' } });
+        await fireEvent.keyDown(input, { key: 'Enter' });
+        expect(handle.rename).toHaveBeenCalledWith('sh1', 'a.md', 'renamed.md');
+    });
+});
+describe('_DocumentBrowser delete', () => {
+    beforeEach(() => { vi.clearAllMocks(); });
+    it('clicking Delete while a file is selected shows confirm overlay', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const deleteBtn = container.querySelector('[title="Delete"]');
+        await fireEvent.click(deleteBtn);
+        expect(container.querySelector('.sh3-confirm-delete')).not.toBeNull();
+    });
+    it('confirming delete calls handle.delete', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const deleteBtn = container.querySelector('[title="Delete"]');
+        await fireEvent.click(deleteBtn);
+        const confirmBtn = container.querySelector('.sh3-confirm-delete__btn--danger');
+        await fireEvent.click(confirmBtn);
+        expect(handle.delete).toHaveBeenCalledWith('sh1', 'a.md');
+    });
+    it('cancelling delete hides the overlay without calling delete', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const deleteBtn = container.querySelector('[title="Delete"]');
+        await fireEvent.click(deleteBtn);
+        const cancelBtn = container.querySelector('.sh3-confirm-delete__btn:not(.sh3-confirm-delete__btn--danger)');
+        await fireEvent.click(cancelBtn);
+        expect(handle.delete).not.toHaveBeenCalled();
+        expect(container.querySelector('.sh3-confirm-delete')).toBeNull();
+    });
+});
+describe('_DocumentBrowser cut and paste', () => {
+    beforeEach(() => { vi.clearAllMocks(); });
+    it('Paste button is disabled when clipboard is empty', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        const pasteBtn = container.querySelector('[title="Paste"]');
+        expect(pasteBtn.disabled).toBe(true);
+    });
+    it('Cut then Paste calls handle.rename with new path', async () => {
+        const handle = makeHandle();
+        const { container } = render(DocumentBrowser, { props: baseProps({ handle }) });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const cutBtn = container.querySelector('[title="Cut"]');
+        await fireEvent.click(cutBtn);
+        // Navigate into sub folder (dblclick)
+        await fireEvent.dblClick(screen.getByText('sub'));
+        const pasteBtn = container.querySelector('[title="Paste"]');
+        expect(pasteBtn.disabled).toBe(false);
+        await fireEvent.click(pasteBtn);
+        expect(handle.rename).toHaveBeenCalledWith('sh1', 'a.md', 'sub/a.md');
+    });
+});
+describe('_DocumentBrowser save mode', () => {
+    it('shows filename input when inside a shard in save mode', async () => {
+        const { container } = render(DocumentBrowser, {
+            props: Object.assign(Object.assign({}, baseProps()), { mode: 'save' }),
+        });
+        await fireEvent.click(screen.getByText('sh1'));
+        expect(container.querySelector('.sh3-doc-browser__save-input')).not.toBeNull();
+    });
+    it('clicking a file in save mode populates the filename field', async () => {
+        const { container } = render(DocumentBrowser, {
+            props: Object.assign(Object.assign({}, baseProps()), { mode: 'save' }),
+        });
+        await fireEvent.click(screen.getByText('sh1'));
+        await fireEvent.click(screen.getByText('a.md'));
+        const input = container.querySelector('.sh3-doc-browser__save-input');
+        expect(input.value).toBe('a.md');
+    });
+    it('Save commits the typed path', async () => {
+        const onCommit = vi.fn();
+        const close = vi.fn();
+        const { container } = render(DocumentBrowser, {
+            props: Object.assign(Object.assign({}, baseProps({ onCommit, close })), { mode: 'save' }),
+        });
+        await fireEvent.click(screen.getByText('sh1'));
+        const input = container.querySelector('.sh3-doc-browser__save-input');
+        await fireEvent.input(input, { target: { value: 'report.txt' } });
+        await fireEvent.click(screen.getByText('Save'));
+        expect(onCommit).toHaveBeenCalledWith('sh1/report.txt');
+        expect(close).toHaveBeenCalled();
+    });
+});

package/dist/primitives/widgets/_FolderConfirmDelete.svelte

@@ -0,0 +1,57 @@
+<script lang="ts">
+  let {
+    item,
+    childCount,
+    onConfirm,
+    onCancel,
+  }: {
+    item: { kind: 'file' | 'folder'; name: string };
+    childCount: number;
+    onConfirm: () => void;
+    onCancel: () => void;
+  } = $props();
+</script>
+
+<div class="sh3-confirm-delete">
+  <div class="sh3-confirm-delete__title">
+    {#if item.kind === 'file'}
+      Delete "{item.name}"?
+    {:else if childCount === 0}
+      Delete folder "{item.name}"?
+    {:else}
+      Delete folder "{item.name}" and {childCount} item{childCount === 1 ? '' : 's'}?
+    {/if}
+  </div>
+  <div class="sh3-confirm-delete__buttons">
+    <button type="button" class="sh3-confirm-delete__btn" onclick={onCancel}>Cancel</button>
+    <button type="button" class="sh3-confirm-delete__btn sh3-confirm-delete__btn--danger" onclick={onConfirm}>Delete</button>
+  </div>
+</div>
+
+<style>
+  .sh3-confirm-delete {
+    padding: 12px 16px;
+    min-width: 240px;
+    color: var(--sh3-fg);
+    font-size: 0.8125rem;
+  }
+  .sh3-confirm-delete__title { font-size: 0.875rem; margin-bottom: 12px; }
+  .sh3-confirm-delete__buttons { display: flex; justify-content: flex-end; gap: 8px; }
+  .sh3-confirm-delete__btn {
+    display: inline-flex; align-items: center;
+    height: 26px; padding: 0 12px;
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-sm);
+    background: var(--sh3-bg-elevated);
+    color: var(--sh3-fg);
+    font: inherit; font-size: 0.75rem;
+    cursor: pointer;
+  }
+  .sh3-confirm-delete__btn:hover { background: var(--sh3-bg); }
+  .sh3-confirm-delete__btn--danger {
+    background: var(--sh3-error);
+    color: var(--sh3-fg-on-error);
+    border-color: var(--sh3-error);
+  }
+  .sh3-confirm-delete__btn--danger:hover { filter: brightness(1.1); }
+</style>

package/dist/primitives/widgets/_FolderConfirmDelete.svelte.d.ts

@@ -0,0 +1,12 @@
+type $$ComponentProps = {
+    item: {
+        kind: 'file' | 'folder';
+        name: string;
+    };
+    childCount: number;
+    onConfirm: () => void;
+    onCancel: () => void;
+};
+declare const FolderConfirmDelete: import("svelte").Component<$$ComponentProps, {}, "">;
+type FolderConfirmDelete = ReturnType<typeof FolderConfirmDelete>;
+export default FolderConfirmDelete;

package/dist/projects/session-state.svelte.d.ts

@@ -1,3 +1,6 @@
+export declare const PENDING_SCOPE_KEY = "sh3:pending-scope";
+export declare function readPendingScope(): string | null;
+export declare function switchProjectScope(projectId: string | null): void;
 export declare const sessionState: {
     activeProjectId: string | null;
 };

package/dist/projects/session-state.svelte.js

@@ -12,6 +12,31 @@
  */
 import { activeApp, breadcrumbApp } from '../apps/registry.svelte';
 import { unloadApp } from '../apps/lifecycle';
+export const PENDING_SCOPE_KEY = 'sh3:pending-scope';
+export function readPendingScope() {
+    if (typeof sessionStorage === 'undefined')
+        return null;
+    const raw = sessionStorage.getItem(PENDING_SCOPE_KEY);
+    if (!raw)
+        return null;
+    sessionStorage.removeItem(PENDING_SCOPE_KEY);
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed.projectId === 'string' ? parsed.projectId : null;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+export function switchProjectScope(projectId) {
+    if (projectId !== null) {
+        sessionStorage.setItem(PENDING_SCOPE_KEY, JSON.stringify({ projectId }));
+    }
+    else {
+        sessionStorage.removeItem(PENDING_SCOPE_KEY);
+    }
+    window.location.reload();
+}
 export const sessionState = $state({
     activeProjectId: null,
 });

package/dist/projects/session-state.test.js

@@ -1,5 +1,5 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { sessionState, setActiveProjectId } from './session-state.svelte';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { sessionState, setActiveProjectId, switchProjectScope, readPendingScope, PENDING_SCOPE_KEY, } from './session-state.svelte';
 import { breadcrumbApp, activeApp } from '../apps/registry.svelte';
 vi.mock('../apps/lifecycle', () => ({
     unloadApp: vi.fn(),
@@ -53,3 +53,44 @@ describe('sessionState.activeProjectId', () => {
         expect(lifecycle.unloadApp).not.toHaveBeenCalled();
     });
 });
+describe('readPendingScope', () => {
+    beforeEach(() => sessionStorage.clear());
+    it('returns null when nothing is stored', () => {
+        expect(readPendingScope()).toBeNull();
+    });
+    it('returns the stored projectId and clears the key', () => {
+        sessionStorage.setItem(PENDING_SCOPE_KEY, JSON.stringify({ projectId: 'proj-abc' }));
+        expect(readPendingScope()).toBe('proj-abc');
+        expect(sessionStorage.getItem(PENDING_SCOPE_KEY)).toBeNull();
+    });
+    it('returns null and clears a malformed entry', () => {
+        sessionStorage.setItem(PENDING_SCOPE_KEY, 'not-json');
+        expect(readPendingScope()).toBeNull();
+        expect(sessionStorage.getItem(PENDING_SCOPE_KEY)).toBeNull();
+    });
+    it('returns null if projectId field is not a string', () => {
+        sessionStorage.setItem(PENDING_SCOPE_KEY, JSON.stringify({ other: 42 }));
+        expect(readPendingScope()).toBeNull();
+    });
+});
+describe('switchProjectScope', () => {
+    let reloadSpy;
+    beforeEach(() => {
+        sessionStorage.clear();
+        reloadSpy = vi.fn();
+        vi.stubGlobal('location', { reload: reloadSpy });
+    });
+    afterEach(() => vi.unstubAllGlobals());
+    it('writes projectId to sessionStorage and reloads', () => {
+        switchProjectScope('proj-abc');
+        const raw = sessionStorage.getItem(PENDING_SCOPE_KEY);
+        expect(JSON.parse(raw)).toEqual({ projectId: 'proj-abc' });
+        expect(reloadSpy).toHaveBeenCalledOnce();
+    });
+    it('removes the key for null (personal scope) and reloads', () => {
+        sessionStorage.setItem(PENDING_SCOPE_KEY, JSON.stringify({ projectId: 'old' }));
+        switchProjectScope(null);
+        expect(sessionStorage.getItem(PENDING_SCOPE_KEY)).toBeNull();
+        expect(reloadSpy).toHaveBeenCalledOnce();
+    });
+});

package/dist/projects-shard/ProjectsSection.svelte

@@ -1,26 +1,13 @@
 <script lang="ts">
-  /*
-   * 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
-   * (which then filters the apps grid via the appAllowlist) and binds any
-   * subsequently launched app's documents to the project scope.
-   */
-
   import { projectsState, openProjectManage } from './projectsShard.svelte';
-  import { sessionState, setActiveProjectId } from '../projects/session-state.svelte';
+  import { sessionState, switchProjectScope } from '../projects/session-state.svelte';
   import { isAdmin } from '../auth/auth.svelte';
   import HomeSection from '../sh3core-shard/HomeSection.svelte';
+  import Button from '../primitives/Button.svelte';
 
   const visible = $derived(projectsState.projects.length > 0);
   const activeId = $derived(sessionState.activeProjectId);
   const elevated = $derived(isAdmin());
-
-  function selectProject(id: string) {
-    setActiveProjectId(activeId === id ? null : id);
-  }
-
   function editProject(id: string, ev: MouseEvent) {
     ev.stopPropagation();
     const project = projectsState.projects.find((p) => p.id === id) ?? null;
@@ -28,7 +15,13 @@
   }
 </script>
 
-{#if visible}
+{#if activeId !== null}
+  <HomeSection title="Project" persistKey="project-active">
+    <div class="leave-project">
+      <Button onclick={() => switchProjectScope(null)}>Leave project</Button>
+    </div>
+  </HomeSection>
+{:else if visible}
   <HomeSection title="Projects" persistKey="projects">
     <div class="projects-grid">
       {#each projectsState.projects as project (project.id)}
@@ -36,8 +29,7 @@
           <button
             type="button"
             class="project-card"
-            class:active={activeId === project.id}
-            onclick={() => selectProject(project.id)}
+            onclick={() => switchProjectScope(project.id)}
             title={project.description ?? `${project.members.length} member${project.members.length === 1 ? '' : 's'}`}
           >
             <span class="project-name">{project.name}</span>
@@ -104,4 +96,8 @@
   }
   .project-name { font-weight: 600; font-size: 13px; }
   .project-meta { font-size: 11px; color: var(--sh3-fg-muted); }
+  .leave-project {
+    display: flex;
+    justify-content: flex-start;
+  }
 </style>

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

@@ -11,7 +11,7 @@
  */
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, __resetShardRegistryForTest, } from '../shards/activate.svelte';
 import { __resetViewRegistryForTest } from '../shards/registry';
 import { __resetActionsRegistryForTest } from '../actions/registry';
@@ -25,7 +25,7 @@ describe('shell-shard programmatic verbs (integration)', () => {
         __resetActionsRegistryForTest();
         __resetAppRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-test');
+        __setActiveScope('tenant-test');
         registerShard(shellShard);
         await activateShard('shell');
     });

package/dist/runtime/runVerb.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, __resetShardRegistryForTest, } from '../shards/activate.svelte';
 import { __resetViewRegistryForTest } from '../shards/registry';
 import { runVerbProgrammatic } from './runVerb';
@@ -19,7 +19,7 @@ describe('runVerbProgrammatic', () => {
         __resetShardRegistryForTest();
         __resetViewRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-test');
+        __setActiveScope('tenant-test');
     });
     it('rejects on unknown shard', async () => {
         await expect(runVerbProgrammatic('missing', 'echo', [])).rejects.toThrow('unknown shard: missing');

package/dist/sh3Api/headless.js

@@ -31,6 +31,8 @@ import { listFields as listFieldsImpl, getField as getFieldImpl, setField as set
 import { attachDecoration as attachDecorationImpl } from '../fields/decoration';
 import { onChange as onContributionsChange } from '../contributions';
 import { FIELD_POINT_ID, WALKER_SHARD_ID } from '../fields/types';
+import { getActiveScopeId, getPersonalScopeId } from '../documents/config';
+import { projectsState } from '../projects-shard/projectsShard.svelte';
 const KNOWN_ZONES = ['ephemeral', 'session', 'workspace', 'user'];
 function collectTabEntries(node) {
     if (node.type === 'tabs') {
@@ -317,6 +319,14 @@ export function makeSh3Api(opts) {
             return listViewsImpl();
         },
         fields,
+        getActiveScope() {
+            const id = getActiveScopeId();
+            const personalId = getPersonalScopeId();
+            return { id, isProject: id !== personalId, personalId };
+        },
+        listProjects() {
+            return projectsState.projects.map((p) => ({ id: p.id, name: p.name }));
+        },
     };
 }
 /** @deprecated Renamed to makeSh3Api(opts?). Kept for one minor cycle. */

package/dist/sh3core-shard/appActions.js

@@ -30,6 +30,7 @@ import AppInfoView from './AppInfoView.svelte';
 import { spawnSatellite } from '../sh3Api/window';
 import { activeApp, getActiveApp } from '../apps/registry.svelte';
 import { returnToHome } from '../apps/lifecycle';
+import { sessionState } from '../projects/session-state.svelte';
 const isTauri = typeof globalThis.__TAURI_INTERNALS__ !== 'undefined';
 export function computeAppActionDisabled(g) {
     return !g.admin || g.builtin;
@@ -111,7 +112,7 @@ async function runCheckUpdate(_ctx) {
     modalManager.open(AppUpdateAvailableModal, props);
 }
 function runPopOut(_ctx) {
-    var _a;
+    var _a, _b;
     const ref = readSelection();
     if (!ref)
         return;
@@ -122,10 +123,11 @@ function runPopOut(_ctx) {
         kind: 'app',
         appId: ref.appId,
         activateShards: (_a = manifest.requiredShards) !== null && _a !== void 0 ? _a : [],
+        projectId: (_b = sessionState.activeProjectId) !== null && _b !== void 0 ? _b : undefined,
     });
 }
 async function runPopOutCurrent(_ctx) {
-    var _a;
+    var _a, _b;
     const current = getActiveApp();
     if (!current)
         return;
@@ -136,6 +138,7 @@ async function runPopOutCurrent(_ctx) {
         kind: 'app',
         appId,
         activateShards: requiredShards,
+        projectId: (_b = sessionState.activeProjectId) !== null && _b !== void 0 ? _b : undefined,
     });
 }
 function runUninstall(_ctx) {

package/dist/shards/activate-browse.test.js

@@ -1,13 +1,13 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, __resetShardRegistryForTest } from './activate.svelte';
 import { PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ, PERMISSION_DOCUMENTS_WRITE, } from '../documents/types';
 describe('ctx.browse permission gating', () => {
     beforeEach(() => {
         __resetShardRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-a');
+        __setActiveScope('tenant-a');
     });
     it('is undefined when no documents permission is declared', async () => {
         let captured = null;

package/dist/shards/activate-contributions.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, deactivateShard, __resetShardRegistryForTest, } from './activate.svelte';
 import { __resetContributionsForTest, list, listPoints } from '../contributions';
 describe('ctx.contributions', () => {
@@ -8,7 +8,7 @@ describe('ctx.contributions', () => {
         __resetShardRegistryForTest();
         __resetContributionsForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-a');
+        __setActiveScope('tenant-a');
     });
     it('is always present on ShardContext (no permission required)', async () => {
         let captured = null;

package/dist/shards/activate-error-isolation.test.js

@@ -1,12 +1,12 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, registeredShards, activeShards, __resetShardRegistryForTest, erroredShards, } from './activate.svelte';
 describe('erroredShards map', () => {
     beforeEach(() => {
         __resetShardRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-a');
+        __setActiveScope('tenant-a');
     });
     it('is empty after reset', () => {
         expect(erroredShards.size).toBe(0);
@@ -21,7 +21,7 @@ describe('activateShard — unwind on activation failure', () => {
     beforeEach(() => {
         __resetShardRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-a');
+        __setActiveScope('tenant-a');
     });
     it('unwinds partial state and records the error when activate throws', async () => {
         const shard = {