@fungi.computer/tourtois 0.0.0-stage → 0.1.0

package/dist/useAppWindowManager.js

@@ -0,0 +1,47 @@
+import { useEffect, useMemo, useRef } from "react";
+import { createAppWindowManager, } from "./app-windows.js";
+/** One mounted host connection owns its windows, including StrictMode teardown. */
+export function useAppWindowManager(host, teamId, events) {
+    const latest = useRef(events);
+    latest.current = events;
+    const manager = useMemo(() => createAppWindowManager({
+        waitForAttachment: true,
+        mount: async (container, launch, signal, projectionEvents) => {
+            if (!host)
+                throw new Error("App host unavailable");
+            return await host.mount(container, launch, signal, {
+                onAgentSessionSelection: (selection) => {
+                    if (!host.reportAgentSessionSelection)
+                        return Promise.reject(new Error("Hub Agent browser host unavailable"));
+                    return Promise.resolve(host.reportAgentSessionSelection(teamId, launch.windowId, selection)).then(() => undefined);
+                },
+                onNavigation: (input) => latest.current.onNavigation(input),
+                onAppOpen: (input) => latest.current.onAppOpen(input),
+                onAppRole: (role) => latest.current.onAppRole(role),
+                onSelectionChanged: () => latest.current.onSelectionChanged(launch),
+                onFocus: () => {
+                    latest.current.onAppFocus(launch);
+                },
+                onNavigationState: projectionEvents.onNavigationState,
+                onStatusItems: projectionEvents.onStatusItems,
+                onComputerChoice: projectionEvents.onComputerChoice,
+            });
+        },
+    }), [host, teamId]);
+    const setups = useRef(new Map());
+    useEffect(() => {
+        setups.current.set(manager, (setups.current.get(manager) ?? 0) + 1);
+        return () => {
+            queueMicrotask(() => {
+                const remaining = (setups.current.get(manager) ?? 1) - 1;
+                if (remaining === 0) {
+                    setups.current.delete(manager);
+                    void manager.dispose();
+                }
+                else
+                    setups.current.set(manager, remaining);
+            });
+        };
+    }, [manager]);
+    return manager;
+}

package/dist/useDirectoryCommands.d.ts

@@ -0,0 +1,12 @@
+import type { TourtoisAppSurfaceHost } from "./app-surface.js";
+import type { AppDirectoryApp } from "./app-launch.js";
+import type { createAppWindowManager, AppLaunchDescriptor } from "./app-windows.js";
+/** Keep declared commands addressable before their App has mounted. */
+export declare function useDirectoryCommands({ host, directory, manager, launchFor, onFocus, onError, }: {
+    host: TourtoisAppSurfaceHost | null;
+    directory: readonly AppDirectoryApp[];
+    manager: ReturnType<typeof createAppWindowManager>;
+    launchFor: (app: AppDirectoryApp) => AppLaunchDescriptor | null;
+    onFocus: (windowId: string) => void;
+    onError: (message: string) => void;
+}): void;

package/dist/useDirectoryCommands.js

@@ -0,0 +1,80 @@
+import { useEffect, useMemo, useRef } from "react";
+function waitForPaletteCommand(host, commandId) {
+    const isReady = () => host.active().palette.some((command) => command.commandId === commandId);
+    if (isReady())
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const timeout = window.setTimeout(() => {
+            unsubscribe();
+            reject(new Error("The App did not register its declared command."));
+        }, 10_000);
+        const finish = () => {
+            window.clearTimeout(timeout);
+            unsubscribe();
+            resolve();
+        };
+        const check = () => {
+            if (isReady())
+                finish();
+        };
+        const unsubscribe = host.subscribe(check);
+        check();
+    });
+}
+/** Keep declared commands addressable before their App has mounted. */
+export function useDirectoryCommands({ host, directory, manager, launchFor, onFocus, onError, }) {
+    const advertisedCommands = useMemo(() => directory.flatMap((installation) => installation.commands.map((command) => ({
+        surfaceId: installation.surfaceId,
+        appTitle: installation.displayName ?? "App",
+        command,
+    }))), [directory]);
+    const directoryCommandContext = useRef({
+        manager,
+        directory,
+        onFocus,
+        onError,
+        launchFor,
+    });
+    directoryCommandContext.current = {
+        manager,
+        directory,
+        onFocus,
+        onError,
+        launchFor,
+    };
+    useEffect(() => {
+        if (!host?.registerDirectoryCommands)
+            return;
+        return host.registerDirectoryCommands(advertisedCommands, async (surfaceId, commandId) => {
+            const context = directoryCommandContext.current;
+            const installation = context.directory.find((app) => app.surfaceId === surfaceId);
+            if (!installation)
+                throw new Error("This App is no longer available.");
+            const launch = context.launchFor(installation);
+            if (!launch)
+                throw new Error("This App is no longer available.");
+            try {
+                await context.manager.open(launch);
+                context.onFocus(launch.windowId);
+                const runtimeCommandId = `${encodeURIComponent(surfaceId)}:${commandId}`;
+                await waitForPaletteCommand(host, runtimeCommandId);
+                const outcome = await host.execute(runtimeCommandId, {
+                    origin: "palette",
+                });
+                if (outcome.status === "handled")
+                    return;
+                if (outcome.status === "failed")
+                    throw new Error(outcome.error.message);
+                if (outcome.status === "unavailable")
+                    throw new Error(outcome.reason);
+                throw new Error("The App command is no longer available.");
+            }
+            catch (error) {
+                context.onError(error instanceof Error
+                    ? error.message
+                    : `${installation.displayName ?? "App"} could not run this command.`);
+                throw error;
+            }
+        });
+    }, [host, advertisedCommands]);
+}

package/dist/workbench.d.ts

@@ -0,0 +1,3 @@
+export { TeamTourtois } from "./TeamDesktop.js";
+export { AppSurfaceHostProvider } from "./app-surface.js";
+export type { TourtoisAppMountEvents, TourtoisAppSurfaceHost, } from "./app-surface.js";

package/dist/workbench.js

@@ -0,0 +1,2 @@
+export { TeamTourtois } from "./TeamDesktop.js";
+export { AppSurfaceHostProvider } from "./app-surface.js";

package/package.json

@@ -1,6 +1,225 @@
 {
   "name": "@fungi.computer/tourtois",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "author": "Levi <levi@technomancy.dev>",
+  "description": "Tourtois: the trusted desktop shell for Oyster and Fungi, with host-supplied Settings sections",
+  "type": "module",
+  "exports": {
+    "./shell": {
+      "types": "./dist/shell.d.ts",
+      "import": "./dist/shell.js"
+    },
+    "./shell-module": {
+      "types": "./dist/shell-module.d.ts",
+      "import": "./dist/shell-module.js"
+    },
+    "./app-directory": {
+      "types": "./dist/app-directory.d.ts",
+      "import": "./dist/app-directory.js"
+    },
+    "./app-open-url": {
+      "types": "./dist/app-open-url.d.ts",
+      "import": "./dist/app-open-url.js"
+    },
+    "./app-surface": {
+      "types": "./dist/app-surface.d.ts",
+      "import": "./dist/app-surface.js"
+    },
+    "./styles.css": "./dist/shell.css",
+    "./workbench": {
+      "types": "./dist/workbench.d.ts",
+      "import": "./dist/workbench.js"
+    },
+    "./platform-controls": {
+      "types": "./dist/platform-controls.d.ts",
+      "import": "./dist/platform-controls.js"
+    },
+    "./settings-routes": {
+      "types": "./dist/settings-routes.d.ts",
+      "import": "./dist/settings-routes.js"
+    },
+    "./team-directory": {
+      "types": "./dist/team-directory.d.ts",
+      "import": "./dist/team-directory.js"
+    },
+    "./app-authority": {
+      "types": "./dist/app-authority.d.ts",
+      "import": "./dist/app-authority.js"
+    },
+    "./app-call-permissions": {
+      "types": "./dist/AppCallPermissions.d.ts",
+      "import": "./dist/AppCallPermissions.js"
+    },
+    "./settings-leave-guard": {
+      "types": "./dist/settings-leave-guard.d.ts",
+      "import": "./dist/settings-leave-guard.js"
+    },
+    "./app-icon": {
+      "types": "./dist/app-icon.d.ts",
+      "import": "./dist/app-icon.js"
+    },
+    "./app-access-consent": {
+      "types": "./dist/AppAccessConsent.d.ts",
+      "import": "./dist/AppAccessConsent.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@fungi.computer/agar": "0.2.0",
+    "@fungi.computer/cairn": "0.0.1",
+    "@fungi.computer/caps": "0.1.0",
+    "@fungi.computer/gills": "0.1.0",
+    "@fungi.computer/maosaico": "0.0.1",
+    "@fungi.computer/oyster": "0.2.0",
+    "@fungi.computer/parakeet": "0.1.0",
+    "@fungi.computer/puffball": "0.1.0",
+    "@fungi.computer/shiitake": "0.2.0",
+    "@fungi.computer/sigils": "0.1.0",
+    "@fungi.computer/sprite": "0.1.0",
+    "@fungi.computer/sprite-zdog": "0.1.0",
+    "@fungi.computer/whistle": "0.0.2",
+    "@tanstack/history": "1.162.1",
+    "@tanstack/react-form": "1.33.2",
+    "@tanstack/react-query": "5.102.8",
+    "@tanstack/react-router": "1.170.28",
+    "@tanstack/router-core": "1.171.23",
+    "animejs": "4.5.0",
+    "effect": "4.0.2",
+    "lucide-react": "0.460.0",
+    "react-dom": "18.3.1",
+    "zod": "4.4.3"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1 || ^19.2.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "5.20260828.1",
+    "@fungi.computer/forage": "0.1.0",
+    "@fungi.computer/mycelium": "0.1.0",
+    "@ladle/react": "5.1.1",
+    "@types/react": "18.3.3",
+    "@vitejs/plugin-react": "6.1.1",
+    "playwright": "1.62.1",
+    "react": "18.3.1",
+    "typescript": "5.9.3",
+    "vite": "8.2.2",
+    "vitest": "4.1.11",
+    "wrangler": "4.135.0",
+    "eslint": "10.9.1",
+    "oxlint": "1.78.0",
+    "tsx": "4.23.12",
+    "jsdom": "29.0.1",
+    "@types/node": "24.13.3",
+    "@types/react-dom": "18.3.0"
+  },
+  "fungi": {
+    "app": {
+      "displayName": "Tourtois",
+      "icon": "tourtois",
+      "capabilities": [
+        "team.workbenchHost",
+        "app.storage"
+      ],
+      "handlers": [],
+      "roles": [
+        "dashboard"
+      ],
+      "commands": [],
+      "storage": [
+        {
+          "key": "desktop",
+          "scopes": [
+            "team",
+            "member"
+          ],
+          "maxBytes": 16384
+        }
+      ],
+      "backend": {
+        "bindings": [
+          {
+            "name": "APP_STORAGE",
+            "operations": [
+              "read",
+              "write",
+              "reset"
+            ]
+          },
+          {
+            "name": "APPS",
+            "operations": [
+              "catalog"
+            ]
+          }
+        ]
+      }
+    },
+    "backendDefinition": "backend/methods.ts",
+    "build": {
+      "react": true,
+      "shellEntry": "src/shell-module.ts",
+      "packageStylesheets": [
+        "@fungi.computer/caps",
+        "@fungi.computer/parakeet"
+      ]
+    }
+  },
+  "license": "MIT",
+  "botanical": {
+    "role": "app",
+    "operations": {
+      "lint": "required",
+      "typecheck": "required",
+      "build": "required",
+      "test": "required",
+      "docs": {
+        "status": "not-applicable",
+        "reason": "App shell documented in README; shared docs tooling not yet wired for this App"
+      },
+      "pack": {
+        "status": "not-applicable",
+        "reason": "Shared pack tooling not yet wired for this App"
+      },
+      "smoke": {
+        "status": "not-applicable",
+        "reason": "The Bonsai standalone test:app-set and Hub browser proofs exercise the shell"
+      },
+      "stranger": {
+        "status": "not-applicable",
+        "reason": "Shared stranger consumer proof not yet wired for this App"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fungi-computer/tourtois.git"
+  },
+  "scripts": {
+    "clean": "node --input-type=module --eval \"import { rm } from 'node:fs/promises'; await rm('dist', { recursive: true, force: true });\"",
+    "lint": "eslint src backend test workbench .ladle --max-warnings=0 && oxlint --config ../../oxlint.config.ts --deny-warnings src backend test workbench .ladle",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.workbench.json && tsc -p backend/tsconfig.json && tsc -p test/workerd/tsconfig.json",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json && cp src/shell.css src/chrome.css src/spa.css src/settings-navigation.css dist/",
+    "build:spa": "vite build",
+    "dev": "vite",
+    "workbench": "ladle serve --host 127.0.0.1 --port 61001",
+    "workbench:build": "ladle build --outDir ../../.botanical/tourtois-ladle",
+    "test:overlay-layering": "node test/overlay-layering.browser.mjs",
+    "test:workbench": "node test/workbench.browser.mjs && node test/desktop-gills.browser.mjs && node test/app-directory-isolation.browser.mjs && node test/workflows-launcher-icon.browser.mjs && node test/landing-bugs.browser.mjs && node test/desktop-under-windows.browser.mjs && node test/show-desktop.browser.mjs && node test/window-stack.browser.mjs && node test/region-layers.browser.mjs && node test/window-chrome-back.browser.mjs && node test/app-bar-menu.browser.mjs && node test/launcher-gill.browser.mjs && node test/desktop-storage.browser.mjs && node test/desktop-method-editing.browser.mjs && node test/phone-desktop.browser.mjs && node test/phone-layout.browser.mjs && node test/phone-app-switcher.browser.mjs && node test/computer-choice.browser.mjs",
+    "test": "pnpm run test:unit && pnpm run test:merge",
+    "test:settings-icons": "node --import tsx ../../tooling/repository/scripts/workbench-proofs.mjs --output ../../.botanical/tourtois-ladle --origin-env TOURTOIS_WORKBENCH_URL test/settings-icons.browser.mjs",
+    "format:check": "node ../../tooling/repository/scripts/format-package-check.mjs",
+    "lint:anti-slop": "node ../../tooling/repository/scripts/lint-package-anti-slop.mjs",
+    "build:workbench": "pnpm run workbench:build",
+    "test:nightly": "node test/permission-matrix.browser.mjs && node --import tsx ../../tooling/repository/scripts/workbench-proofs.mjs --output ../../.botanical/tourtois-ladle --origin-env TOURTOIS_WORKBENCH_URL test/member-avatar.browser.mjs test/settings-icons.browser.mjs",
+    "test:unit": "vitest run",
+    "test:merge": "node test/layout-backend.native.mjs && node --import tsx test/desktop-refresh.native.mjs",
+    "test:app-call-permissions": "node --import tsx ../../tooling/repository/scripts/workbench-proofs.mjs --output ../../.botanical/tourtois-ladle --origin-env TOURTOIS_WORKBENCH_URL test/app-call-permissions.browser.mjs"
+  }
 }