acryl-development-canvas 0.1.0

package/lib/types/client/development-canvas/state.d.ts

@@ -0,0 +1,65 @@
+/** In-memory Development Canvas tabs. Host PTY sessions bind through tab.sessionId. */
+import type { CanvasPtyCommandId } from '../../canvas-pty-contract.ts';
+export type CanvasTileKind = 'chat' | 'pty' | 'file' | 'browser';
+export interface CanvasTile {
+    readonly id: string;
+    readonly kind: CanvasTileKind;
+    readonly title: string;
+    readonly commandId?: CanvasPtyCommandId;
+    readonly sessionId?: string;
+    readonly path?: string;
+    readonly content?: string;
+    readonly url?: string;
+    readonly error?: string;
+}
+export interface DevelopmentCanvasSnapshot {
+    readonly tiles: readonly CanvasTile[];
+    readonly activeId: string | undefined;
+    readonly menuOpen: boolean;
+}
+export interface DevelopmentCanvasStateOptions {
+    readonly createId?: () => string;
+}
+export interface AddTileOptions {
+    readonly commandId?: CanvasPtyCommandId;
+    readonly title?: string;
+}
+/**
+ * Observable tab workspace for one advanced-shell lifetime.
+ * One tab fills the main content area; "+" appends another tab.
+ */
+export declare class DevelopmentCanvasState {
+    private snapshot;
+    private readonly listeners;
+    private readonly createId;
+    constructor(options?: DevelopmentCanvasStateOptions);
+    /** @returns the immutable current canvas. */
+    getSnapshot(): DevelopmentCanvasSnapshot;
+    /** @param listener - notified after a snapshot replacement. @returns disposer. */
+    subscribe(listener: () => void): () => void;
+    /** Open or close the "+" menu. */
+    setMenuOpen(menuOpen: boolean): void;
+    /** Focus one existing tab. */
+    selectTile(id: string): void;
+    /**
+     * Append one tab and focus it. A second Chat tab is ignored.
+     * @param kind - tab kind from the "+" menu.
+     * @param options - PTY command / title overrides.
+     */
+    addTile(kind: CanvasTileKind, options?: AddTileOptions): CanvasTile | undefined;
+    /**
+     * Remove one tab. Caller disposes a Host PTY when `sessionId` was set.
+     * @param id - tab id.
+     */
+    closeTile(id: string): CanvasTile | undefined;
+    /**
+     * Merge kind-specific fields onto one tab.
+     * @param id - tab id.
+     * @param patch - fields to replace.
+     */
+    updateTile(id: string, patch: Partial<Omit<CanvasTile, 'id' | 'kind'>>): void;
+    private createTile;
+    private replace;
+}
+/** @param url - address-bar text. */
+export declare function normalizeBrowserUrl(url: string): string | undefined;

package/lib/types/client/index.d.ts

@@ -0,0 +1,23 @@
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import '@deepseek-ai/dsh-client-ui-renderer/client';
+import '@deepseek-ai/dsh-client-ui-session/client';
+import type { ReactNode } from 'react';
+interface DesktopMainOwnerProps {
+    renderConversation(): ReactNode;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'desktop.main': {
+            kind: 'single';
+            scope: 'root';
+            owner: DesktopMainOwnerProps;
+        };
+    }
+}
+export declare const name = "development-canvas-client";
+export declare const inject: string[];
+/** Contribute Canvas only while the Desktop main slot declaration is live. */
+export declare function apply(ctx: ClientContext): void;
+export { DevelopmentCanvas } from './development-canvas/DevelopmentCanvas.tsx';
+export { CanvasPtyClient } from './development-canvas/session-client.ts';
+export { DevelopmentCanvasState, normalizeBrowserUrl } from './development-canvas/state.ts';

package/lib/types/client/styles.d.ts

@@ -0,0 +1,2 @@
+/** Install styles owned by one Canvas Client Fiber. */
+export declare function installCanvasStyles(): () => void;

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "acryl-development-canvas",
+  "version": "0.1.0",
+  "description": "Standalone Cordis Development Canvas plugin for ACRYL",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/acryldev/acryl-development-canvas.git"
+  },
+  "homepage": "https://github.com/acryldev/acryl-development-canvas#readme",
+  "bugs": {
+    "url": "https://github.com/acryldev/acryl-development-canvas/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "cordis.patch.yml",
+    "lib/**",
+    "README.md",
+    "LICENSE",
+    "docs/",
+    "provenance.json"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "keywords": [
+    "acryl-package",
+    "cordis-plugin",
+    "dsh-plugin",
+    "development-canvas",
+    "pty",
+    "agent-workspace"
+  ],
+  "scripts": {
+    "build": "node scripts/clean.mjs && tsdown && tsc -p tsconfig.json --emitDeclarationOnly && tsc -p tsconfig.client.json --emitDeclarationOnly",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit && tsc -p tsconfig.tests.json --noEmit",
+    "test": "vitest run",
+    "check": "pnpm run build && pnpm run typecheck && pnpm run test",
+    "prepack": "pnpm run check"
+  },
+  "dependencies": {
+    "@xterm/addon-fit": "0.10.0",
+    "@xterm/xterm": "5.5.0",
+    "node-pty": "1.2.0-beta.15"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "0.1.5-alpha.1",
+    "react": "18.3.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "0.1.5-alpha.1",
+    "@types/node": "^22.20.0",
+    "@types/react": "^18",
+    "react": "18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8"
+  },
+  "acryl": {
+    "schemaVersion": 1,
+    "artifacts": {
+      "plugins": [
+        "./lib/index.js",
+        "./lib/client.js"
+      ]
+    },
+    "runtime": "cordis",
+    "compatibility": {
+      "acryl": ">=0.1.0 <1.0.0",
+      "node": "^22.19.0 || >=24.0.0",
+      "hosts": {
+        "@deepseek-ai/cordis": "4.0.1"
+      }
+    },
+    "capabilities": [
+      "development-canvas",
+      "pty-workspace",
+      "desktop-slot"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/provenance.json

@@ -0,0 +1,9 @@
+{
+  "extractedAt": "2026-09-09",
+  "acryl": {
+    "repository": "https://github.com/acryldev/acryl",
+    "sourcePackage": "acryl-development-canvas",
+    "sourcePath": "acryl-development-canvas/"
+  },
+  "strategy": "Copy-only extraction from the ACRYL workspace. The source package remains in ACRYL unchanged; this repository publishes the same Host and Client Cordis plugin as an independently installable package."
+}