@fungi.computer/nacre 0.0.0-stage → 0.0.1

package/docs/api/workbench-directory.md

@@ -0,0 +1,141 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/nacre**](README.md)
+
+---
+
+[@fungi.computer/nacre](README.md) / workbench-directory
+
+# workbench-directory
+
+## Type Aliases
+
+### WorkbenchDirectory
+
+```ts
+type WorkbenchDirectory = z.output<typeof workbenchDirectorySchema>;
+```
+
+One host's current desktop rows and actual role selections.
+
+## Variables
+
+### workbenchComputerDirectorySchema
+
+```ts
+const workbenchComputerDirectorySchema: ZodObject<
+  {
+    computers: ZodArray<
+      ZodObject<
+        {
+          computerId: ZodString;
+          name: ZodString;
+        },
+        $strip
+      >
+    >;
+    nextOffset: ZodNullable<ZodNumber>;
+  },
+  $strip
+>;
+```
+
+The shell picker needs identities and labels, not inventory receipts.
+
+---
+
+### workbenchDirectorySchema
+
+```ts
+const workbenchDirectorySchema: ZodPipe<ZodObject<{
+  apps: ZodArray<ZodObject<{
+     address: ZodLazy<ZodUnion<readonly [ZodObject<{
+        kind: ...;
+        appId: ...;
+      }, $strict>, ZodObject<{
+        kind: ...;
+        installationId: ...;
+     }, $strict>]>>;
+     installationId: ZodNullable<ZodString>;
+     surfaceId: ZodString;
+     appId: ZodString;
+     displayName: ZodOptional<ZodString>;
+     icon: ZodOptional<ZodNullable<ZodString>>;
+     releaseId: ZodNullable<ZodString>;
+     authorityVersion: ZodNumber;
+     enforcement: ZodNullable<ZodLazy<ZodObject<{
+        requestId: ZodString;
+        address: ZodLazy<...>;
+        authorityVersion: ZodNumber;
+        state: ZodEnum<...>;
+        outstanding: ZodNumber;
+     }, $strict>>>;
+     handlers: ZodArray<ZodLiteral<"file.open">>;
+     roles: ZodArray<ZodString>;
+     declaredCapabilities: ZodArray<ZodString>;
+     calls: ZodOptional<ZodPipe<ZodUnknown, ZodTransform<readonly object[], unknown>>>;
+     commands: ZodPipe<ZodArray<ZodUnknown>, ZodTransform<Readonly<{
+        id: ...;
+        title: ...;
+        category: ...;
+        description?: ...;
+        sigil?: ...;
+        projections?: ...;
+     }>[], unknown[]>>;
+     gills: ZodPipe<ZodArray<ZodUnknown>, ZodTransform<AppDirectoryGill[], unknown[]>>;
+     availability: ZodEnum<{
+        available: "available";
+        unavailable: "unavailable";
+     }>;
+     surface: ZodNullable<ZodObject<{
+        stableRoute: ZodString;
+     }, $strict>>;
+     surfacePath: ZodString;
+     computer: ZodOptional<ZodUnion<readonly [ZodObject<{
+        computerId: ...;
+        name: ...;
+     }, $strip>, ZodLiteral<"owner-fleet">]>>;
+     computerPermission: ZodOptional<ZodNullable<ZodDiscriminatedUnion<[ZodLazy<...>, ZodLazy<...>], "kind">>>;
+  }, $strip>>;
+  computer: ZodOptional<ZodObject<{
+     computerId: ZodString;
+     name: ZodString;
+  }, $strip>>;
+  computerContext: ZodOptional<ZodLiteral<"owner-fleet">>;
+  roles: ZodRecord<ZodString, ZodObject<{
+     surfaceId: ZodNullable<ZodString>;
+     chosen: ZodBoolean;
+  }, $strict>>;
+  needsUpdate: ZodOptional<ZodArray<ZodObject<{
+     installationId: ZodNullable<ZodString>;
+     appId: ZodNullable<ZodString>;
+     displayName: ZodString;
+  }, $strict>>>;
+}, $strip>, ZodTransform<{
+  apps: object[];
+  computer?: {
+     computerId: string;
+     name: string;
+  };
+  computerContext?: "owner-fleet";
+  roles: Record<string, {
+     surfaceId: string | null;
+     chosen: boolean;
+  }>;
+  needsUpdate?: object[];
+}, {
+  apps: object[];
+  computer?: {
+     computerId: string;
+     name: string;
+  };
+  computerContext?: "owner-fleet";
+  roles: Record<string, {
+     surfaceId: string | null;
+     chosen: boolean;
+  }>;
+  needsUpdate?: object[];
+}>>;
+```
+
+Desktop metadata shared by hosts; hosted administration stays in Settings.

package/docs/api/workbench.md

@@ -0,0 +1,201 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/nacre**](README.md)
+
+---
+
+[@fungi.computer/nacre](README.md) / workbench
+
+# workbench
+
+## References
+
+### WorkbenchResolvedChild
+
+Re-exports [WorkbenchResolvedChild](index.md#workbenchresolvedchild)
+
+---
+
+### WorkbenchChildSurface
+
+Re-exports [WorkbenchChildSurface](index.md#workbenchchildsurface)
+
+---
+
+### WorkbenchChildMountOptions
+
+Re-exports [WorkbenchChildMountOptions](index.md#workbenchchildmountoptions)
+
+---
+
+### WorkbenchPreparedChild
+
+Re-exports [WorkbenchPreparedChild](index.md#workbenchpreparedchild)
+
+---
+
+### WorkbenchHostServices
+
+Re-exports [WorkbenchHostServices](index.md#workbenchhostservices)
+
+---
+
+### WorkbenchHostControls
+
+Re-exports [WorkbenchHostControls](index.md#workbenchhostcontrols)
+
+---
+
+### WorkbenchWarningEvent
+
+Re-exports [WorkbenchWarningEvent](index.md#workbenchwarningevent)
+
+---
+
+### WorkbenchWarningFields
+
+Re-exports [WorkbenchWarningFields](index.md#workbenchwarningfields)
+
+---
+
+### WorkbenchHostOptions
+
+Re-exports [WorkbenchHostOptions](index.md#workbenchhostoptions)
+
+---
+
+### WorkbenchChildLaunch
+
+Re-exports [WorkbenchChildLaunch](index.md#workbenchchildlaunch)
+
+---
+
+### WorkbenchCommandInvocation
+
+Re-exports [WorkbenchCommandInvocation](index.md#workbenchcommandinvocation)
+
+---
+
+### WorkbenchChildEvents
+
+Re-exports [WorkbenchChildEvents](index.md#workbenchchildevents)
+
+---
+
+### WorkbenchChildHandle
+
+Re-exports [WorkbenchChildHandle](index.md#workbenchchildhandle)
+
+---
+
+### WorkbenchPlatformDestination
+
+Re-exports [WorkbenchPlatformDestination](index.md#workbenchplatformdestination)
+
+---
+
+### workbenchGillRequestSchema
+
+Re-exports [workbenchGillRequestSchema](index.md#workbenchgillrequestschema)
+
+---
+
+### WorkbenchGillRequest
+
+Re-exports [WorkbenchGillRequest](index.md#workbenchgillrequest)
+
+---
+
+### desktopGillSelectionSchema
+
+Re-exports [desktopGillSelectionSchema](index.md#desktopgillselectionschema)
+
+---
+
+### DesktopGillSelection
+
+Re-exports [DesktopGillSelection](index.md#desktopgillselection)
+
+---
+
+### desktopGillSizesSchema
+
+Re-exports [desktopGillSizesSchema](index.md#desktopgillsizesschema)
+
+---
+
+### desktopGillAdditionSchema
+
+Re-exports [desktopGillAdditionSchema](index.md#desktopgilladditionschema)
+
+---
+
+### DesktopGillAddition
+
+Re-exports [DesktopGillAddition](index.md#desktopgilladdition)
+
+---
+
+### WorkbenchDesktopSettings
+
+Re-exports [WorkbenchDesktopSettings](index.md#workbenchdesktopsettings)
+
+---
+
+### desktopSettingsHandlerSchema
+
+Re-exports [desktopSettingsHandlerSchema](index.md#desktopsettingshandlerschema)
+
+---
+
+### WorkbenchDesktopRegistration
+
+Re-exports [WorkbenchDesktopRegistration](index.md#workbenchdesktopregistration)
+
+---
+
+### WorkbenchGillWatch
+
+Re-exports [WorkbenchGillWatch](index.md#workbenchgillwatch)
+
+---
+
+### appOpenRequestSchema
+
+Re-exports [appOpenRequestSchema](index.md#appopenrequestschema)
+
+---
+
+### teamComputerSchema
+
+Re-exports [teamComputerSchema](index.md#teamcomputerschema)
+
+---
+
+### TeamComputer
+
+Re-exports [TeamComputer](index.md#teamcomputer)
+
+---
+
+### teamComputerDirectorySchema
+
+Re-exports [teamComputerDirectorySchema](index.md#teamcomputerdirectoryschema)
+
+---
+
+### TeamWorkbenchHostHandle
+
+Re-exports [TeamWorkbenchHostHandle](index.md#teamworkbenchhosthandle)
+
+---
+
+### TeamWorkbenchChildEvents
+
+Re-exports [TeamWorkbenchChildEvents](index.md#teamworkbenchchildevents)
+
+---
+
+### WorkbenchHost
+
+Re-exports [WorkbenchHost](index.md#workbenchhost)

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "@fungi.computer/nacre",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "author": "Levi <levi@technomancy.dev>",
+  "description": "The shell client for hosting Apps: workbench, command host, keys, commands, window manager and App directory rows",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./workbench": {
+      "types": "./dist/workbench.d.ts",
+      "import": "./dist/workbench.js"
+    },
+    "./shell-module": {
+      "types": "./dist/shell-module.d.ts",
+      "import": "./dist/shell-module.js"
+    },
+    "./command-host": {
+      "types": "./dist/command-host.d.ts",
+      "import": "./dist/command-host.js"
+    },
+    "./keys": {
+      "types": "./dist/keys.d.ts",
+      "import": "./dist/keys.js"
+    },
+    "./commands": {
+      "types": "./dist/commands.d.ts",
+      "import": "./dist/commands.js"
+    },
+    "./window-manager": {
+      "types": "./dist/window-manager.d.ts",
+      "import": "./dist/window-manager.js"
+    },
+    "./app-directory": {
+      "types": "./dist/app-directory.d.ts",
+      "import": "./dist/app-directory.js"
+    },
+    "./workbench-directory": {
+      "types": "./dist/workbench-directory.d.ts",
+      "import": "./dist/workbench-directory.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/api",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@fungi.computer/agar": "0.3.0",
+    "@fungi.computer/ear-tag": "0.1.0",
+    "@fungi.computer/gills": "0.2.0",
+    "@fungi.computer/puffball": "0.2.0",
+    "@fungi.computer/whistle": "0.1.0",
+    "effect": "4.0.2",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "typescript": "5.9.3",
+    "vitest": "4.1.11"
+  },
+  "botanical": {
+    "role": "package",
+    "operations": {
+      "lint": "required",
+      "typecheck": "required",
+      "build": "required",
+      "test": "required",
+      "docs": "required",
+      "pack": "required",
+      "smoke": "required",
+      "stranger": "required"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fungi-computer/nacre.git"
+  },
+  "scripts": {
+    "lint": "eslint src test --max-warnings=0 && ../../node_modules/.bin/oxlint --config ../../oxlint.config.ts --deny-warnings src test",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json --noEmit",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "clean": "node --input-type=module --eval \"import { rm } from 'node:fs/promises'; await rm('dist', { recursive: true, force: true });\"",
+    "test": "vitest run",
+    "test:unit": "pnpm run test",
+    "docs": "tsx ../../tooling/repository/src/docs/cli.ts check --root ../..",
+    "docs:write": "tsx ../../tooling/repository/src/docs/cli.ts write --root ../..",
+    "pack": "mkdir -p ../../.botanical/nacre-pack && pnpm pack --pack-destination ../../.botanical/nacre-pack",
+    "smoke": "node test/stranger/runtime.mjs",
+    "stranger": "tsx ../../tooling/repository/src/artifacts/cli.ts --repo-root ../.. .",
+    "format:check": "node ../../tooling/repository/scripts/format-package-check.mjs",
+    "lint:anti-slop": "node ../../tooling/repository/scripts/lint-package-anti-slop.mjs"
+  }
 }