devframe 0.1.19 → 0.1.21

package/README.md

@@ -10,7 +10,7 @@ pnpm add devframe
 
 ## Docs
 
-See the [DevFrame documentation](https://devtools.vite.dev/devframe/) for the full guide and API reference.
+See the [DevFrame documentation](https://devfra.me/) for the full guide and API reference.
 
 ## Agent-Native (experimental)
 
@@ -55,7 +55,7 @@ devframe mcp
 
 `@modelcontextprotocol/sdk` is a peer dependency — add it to your package when you want to ship MCP support.
 
-See the [Agent-Native guide](https://devtools.vite.dev/devframe/agent-native) for the full API, safety model, and Claude Desktop integration example.
+See the [Agent-Native guide](https://devfra.me/agent-native) for the full API, safety model, and Claude Desktop integration example.
 
 ## License
 

package/dist/{_shared-BcPXmcjq.mjs → _shared-iZy45oG3.mjs}

@@ -1,7 +1,7 @@
 //#region src/adapters/_shared.ts
 /**
 * Resolve the mount base path for a devtool's SPA. Hosted adapters
-* (`vite`, `kit`, `embedded`) default to `/.<id>/` so they don't
+* (`vite`, `kit`, `embedded`) default to `/__<id>/` so they don't
 * collide with the host app; standalone adapters (`cli`, `spa`,
 * `build`) default to `/` because they own the origin.
 *
@@ -9,7 +9,7 @@
 */
 function resolveBasePath(def, kind) {
 	if (def.basePath) return normalizeBasePath(def.basePath);
-	return kind === "standalone" ? "/" : `/.${def.id}/`;
+	return kind === "standalone" ? "/" : `/__${def.id}/`;
 }
 function normalizeBasePath(base) {
 	let out = base.startsWith("/") ? base : `/${base}`;

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevtoolDefinition } from "../devtool-CIqONpYU.mjs";
+import { r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
 
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
@@ -24,8 +24,8 @@ interface CreateBuildOptions {
  *
  *   - Build a `mode: 'build'` context and run `devtool.setup(ctx)`.
  *   - Copy the author's SPA dist into `<outDir>/`.
- *   - Write `<outDir>/.connection.json` (`{ backend: 'static' }`) and the
- *     sharded RPC dump under `<outDir>/.rpc-dump/` so the deployed SPA
+ *   - Write `<outDir>/__connection.json` (`{ backend: 'static' }`) and the
+ *     sharded RPC dump under `<outDir>/__rpc-dump/` so the deployed SPA
  *     discovers both via relative paths from `document.baseURI`.
  *   - When `def.spa` is configured, also write `<outDir>/spa-loader.json`
  *     describing the SPA's data-loader mode (`'query'` / `'upload'` /

package/dist/adapters/build.mjs

@@ -1,13 +1,13 @@
-import { n as strictJsonStringify, o as structuredCloneStringify } from "../serialization-BN2ZQEE9.mjs";
-import { t as createHostContext } from "../context-BsNZMCnr.mjs";
+import { n as strictJsonStringify, o as structuredCloneStringify } from "../serialization-DwKi05Pn.mjs";
+import { t as createHostContext } from "../context-BJ4r2SmR.mjs";
+import { t as createH3DevToolsHost } from "../host-h3-9jeHcltx.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_DIRNAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { t as createH3DevToolsHost } from "../host-h3-w3c0t8ZO.mjs";
-import { t as collectStaticRpcDump } from "../static-dump-cyGfMmRf.mjs";
-import { n as resolveBasePath } from "../_shared-BcPXmcjq.mjs";
+import { t as collectStaticRpcDump } from "../static-dump-D5VH8Iqk.mjs";
+import { n as resolveBasePath } from "../_shared-iZy45oG3.mjs";
+import c from "ansis";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "pathe";
 import process from "node:process";
-import c from "ansis";
 import fs$1 from "node:fs/promises";
 //#region src/adapters/build.ts
 /**
@@ -15,8 +15,8 @@ import fs$1 from "node:fs/promises";
 *
 *   - Build a `mode: 'build'` context and run `devtool.setup(ctx)`.
 *   - Copy the author's SPA dist into `<outDir>/`.
-*   - Write `<outDir>/.connection.json` (`{ backend: 'static' }`) and the
-*     sharded RPC dump under `<outDir>/.rpc-dump/` so the deployed SPA
+*   - Write `<outDir>/__connection.json` (`{ backend: 'static' }`) and the
+*     sharded RPC dump under `<outDir>/__rpc-dump/` so the deployed SPA
 *     discovers both via relative paths from `document.baseURI`.
 *   - When `def.spa` is configured, also write `<outDir>/spa-loader.json`
 *     describing the SPA's data-loader mode (`'query'` / `'upload'` /
@@ -34,7 +34,10 @@ async function createBuild(d, options = {}) {
 	const ctx = await createHostContext({
 		cwd: process.cwd(),
 		mode: "build",
-		host: createH3DevToolsHost({ origin: "http://localhost" })
+		host: createH3DevToolsHost({
+			origin: "http://localhost",
+			appName: d.id
+		})
 	});
 	await d.setup(ctx);
 	await fs$1.mkdir(resolve(outDir, DEVTOOLS_RPC_DUMP_DIRNAME), { recursive: true });

package/dist/adapters/cli.d.mts

@@ -1,4 +1,4 @@
-import { en as CliFlagsSchema, nn as defineCliFlags, r as DevtoolDefinition, rn as parseCliFlags, tn as InferCliFlags } from "../devtool-CIqONpYU.mjs";
+import { dt as CliFlagsSchema, ft as InferCliFlags, mt as parseCliFlags, pt as defineCliFlags, r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
 import { App } from "h3";
 import { CAC } from "cac";
 

package/dist/adapters/cli.mjs

@@ -1,7 +1,7 @@
 import { createBuild } from "./build.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-Djy5hbgs.mjs";
-import process from "node:process";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CdAy400a.mjs";
 import c from "ansis";
+import process from "node:process";
 import cac from "cac";
 import { safeParse } from "valibot";
 //#region src/adapters/flags.ts

package/dist/adapters/dev.d.mts

@@ -1,5 +1,5 @@
-import { r as DevtoolDefinition } from "../devtool-CIqONpYU.mjs";
-import { n as StartedServer } from "../server-CaUeMcAh.mjs";
+import { r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
+import { n as StartedServer } from "../server-BAqOajx_.mjs";
 import { App } from "h3";
 
 //#region src/adapters/dev.d.ts

package/dist/adapters/dev.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-Djy5hbgs.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CdAy400a.mjs";
 export { createDevServer, resolveDevServerPort };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { d as DevToolsNodeContext, r as DevtoolDefinition } from "../devtool-CIqONpYU.mjs";
+import { d as DevToolsNodeContext, r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
 
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {
@@ -12,7 +12,7 @@ interface CreateEmbeddedOptions {
  * dynamic, post-startup registration.
  *
  * The host owns the mount path; when a hosted mount is needed the
- * effective default follows the hosted rule of `def.basePath ?? '/.<id>/'`.
+ * effective default follows the hosted rule of `def.basePath ?? '/__<id>/'`.
  */
 declare function createEmbedded(d: DevtoolDefinition, options: CreateEmbeddedOptions): Promise<void>;
 //#endregion

package/dist/adapters/embedded.mjs

@@ -6,7 +6,7 @@
 * dynamic, post-startup registration.
 *
 * The host owns the mount path; when a hosted mount is needed the
-* effective default follows the hosted rule of `def.basePath ?? '/.<id>/'`.
+* effective default follows the hosted rule of `def.basePath ?? '/__<id>/'`.
 */
 async function createEmbedded(d, options) {
 	await d.setup(options.ctx);

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { r as DevtoolDefinition } from "../devtool-CIqONpYU.mjs";
+import { r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
 //#region src/node/mcp/build-server.d.ts

package/dist/adapters/mcp.mjs

@@ -1,4 +1,7 @@
-import { m as logger, t as createHostContext } from "../context-BsNZMCnr.mjs";
+import { n as logger } from "../diagnostics-DxPnRoXO.mjs";
+import { t as createHostContext } from "../context-BJ4r2SmR.mjs";
+import { join } from "pathe";
+import { homedir } from "node:os";
 import process from "node:process";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
@@ -127,7 +130,8 @@ async function createMcpServer(definition, options = {}) {
 		mode: "dev",
 		host: {
 			mountStatic: () => {},
-			resolveOrigin: () => "mcp://devframe"
+			resolveOrigin: () => "mcp://devframe",
+			getStorageDir: (scope) => scope === "workspace" ? join(process.cwd(), `node_modules/.${definition.id}/devtools`) : join(homedir(), `.${definition.id}/devtools`)
 		}
 	});
 	await definition.setup(ctx);

package/dist/adapters/vite.d.mts

@@ -1,9 +1,9 @@
-import { r as DevtoolDefinition } from "../devtool-CIqONpYU.mjs";
+import { r as DevtoolDefinition } from "../devtool-CNvLs2_Y.mjs";
 
 //#region src/adapters/vite.d.ts
 interface CreateVitePluginOptions {
   /**
-   * Mount base. Defaults to `def.basePath ?? '/.<id>/'` for this hosted
+   * Mount base. Defaults to `def.basePath ?? '/__<id>/'` for this hosted
    * adapter — the devtool shares the origin with the host Vite app.
    */
   base?: string;
@@ -19,12 +19,13 @@ interface DevframeVitePlugin {
 }
 /**
  * Plain Vite plugin — mounts a devframe devtool's SPA into a user's
- * Vite dev server at `options.base` (default: `def.basePath ?? '/.<id>/'`).
+ * Vite dev server at `options.base` (default: `def.basePath ?? '/__<id>/'`).
  * Use this for tools that want the Vite dev experience without
  * pulling the full Vite DevTools Kit.
  *
  * Note: this does not yet spin up the RPC WS server — for the full
- * RPC path, use `createKitPlugin` alongside `@vitejs/devtools`, or the
+ * RPC path, use `createPluginFromDevframe` from
+ * `@vitejs/devtools-kit/node` alongside `@vitejs/devtools`, or the
  * standalone `createCli`.
  */
 declare function createVitePlugin(d: DevtoolDefinition, options?: CreateVitePluginOptions): DevframeVitePlugin;

package/dist/adapters/vite.mjs

@@ -1,15 +1,16 @@
-import { n as resolveBasePath } from "../_shared-BcPXmcjq.mjs";
+import { n as resolveBasePath } from "../_shared-iZy45oG3.mjs";
 import { resolve } from "pathe";
 import sirv from "sirv";
 //#region src/adapters/vite.ts
 /**
 * Plain Vite plugin — mounts a devframe devtool's SPA into a user's
-* Vite dev server at `options.base` (default: `def.basePath ?? '/.<id>/'`).
+* Vite dev server at `options.base` (default: `def.basePath ?? '/__<id>/'`).
 * Use this for tools that want the Vite dev experience without
 * pulling the full Vite DevTools Kit.
 *
 * Note: this does not yet spin up the RPC WS server — for the full
-* RPC path, use `createKitPlugin` alongside `@vitejs/devtools`, or the
+* RPC path, use `createPluginFromDevframe` from
+* `@vitejs/devtools-kit/node` alongside `@vitejs/devtools`, or the
 * standalone `createCli`.
 */
 function createVitePlugin(d, options = {}) {

package/dist/client/index.d.mts

@@ -1,11 +1,50 @@
-import { H as DevToolsRpcClientFunctions, It as DevToolsCommandKeybinding, Mt as DevToolsClientCommand, Pt as DevToolsCommandEntry, U as DevToolsRpcServerFunctions, V as DevToolsDocksUserSettings, Zt as EventEmitter, _t as DevToolsDockUserEntry, dt as DevToolsDockEntriesGrouped, ft as DevToolsDockEntry, l as ConnectionMeta, v as RpcSharedStateHost, w as SharedState } from "../devtool-CIqONpYU.mjs";
-import { _ as RpcCacheManager, v as RpcCacheOptions } from "../index-BwrLhNmz.mjs";
-import { S as RpcFunctionsCollector } from "../types-gWbe-b2R.mjs";
-import { t as WhenContext } from "../when-BAE663Hv.mjs";
-import { t as WsRpcChannelOptions } from "../ws-client-DOYwYluO.mjs";
+import { T as StreamSink, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, ct as EventEmitter, g as RpcSharedStateHost, l as ConnectionMeta, w as StreamReader } from "../devtool-CNvLs2_Y.mjs";
+import { _ as RpcCacheManager, v as RpcCacheOptions } from "../index-CuLRIMto.mjs";
+import { S as RpcFunctionsCollector } from "../types-C5OVe4AC.mjs";
+import { t as WsRpcChannelOptions } from "../ws-client-CjPuPFbA.mjs";
 import { BirpcOptions, BirpcReturn } from "birpc";
 
+//#region src/client/rpc-streaming.d.ts
+interface StreamingSubscribeOptions {
+  /** Maximum buffered chunks before the oldest is dropped. Default 256. */
+  highWaterMark?: number;
+}
+interface RpcStreamingClientHost {
+  /**
+   * Subscribe to a server-side stream by channel + id. Returns a reader
+   * that's both an `AsyncIterable<T>` (`for await`) and exposes
+   * `readable: ReadableStream<T>` for `pipeTo`-style consumption.
+   */
+  subscribe: <T = unknown>(channel: string, id: string, options?: StreamingSubscribeOptions) => StreamReader<T>;
+  /**
+   * Open the client side of a client-to-server upload. The id is
+   * typically obtained from a prior action call that ran
+   * `channel.openInbound()` on the server. Returns a `StreamSink<T>`
+   * that mirrors the server-side producer surface (write / close /
+   * error / writable / signal).
+   *
+   * The sink's `signal` aborts when the server cancels the upload.
+   */
+  upload: <T = unknown>(channel: string, id: string) => StreamSink<T>;
+}
+/**
+ * Client-side streaming host. Mirrors `createRpcSharedStateClientHost`:
+ * registers the two `:chunk` / `:end` event handlers once, then per-stream
+ * state lives in a `Map<streamKey, StreamReader>`.
+ */
+declare function createRpcStreamingClientHost(rpc: DevToolsRpcClient): RpcStreamingClientHost;
+//#endregion
 //#region src/client/rpc.d.ts
+interface DevToolsRpcContext {
+  /**
+   * The RPC client to interact with the server
+   */
+  readonly rpc: DevToolsRpcClient;
+}
+type DevToolsClientRpcHost = RpcFunctionsCollector<DevToolsRpcClientFunctions, DevToolsRpcContext>;
+interface RpcClientEvents {
+  'rpc:is-trusted:updated': (isTrusted: boolean) => void;
+}
 interface DevToolsRpcClientOptions {
   connectionMeta?: ConnectionMeta;
   baseURL?: string | string[];
@@ -70,6 +109,12 @@ interface DevToolsRpcClient {
    * The shared state host
    */
   sharedState: RpcSharedStateHost;
+  /**
+   * The streaming channel host. Subscribe to a server-side stream by
+   * channel + id; the returned reader is both `AsyncIterable<T>` and
+   * exposes `.readable: ReadableStream<T>` for `pipeTo` consumption.
+   */
+  streaming: RpcStreamingClientHost;
   /**
    * The RPC cache manager
    */
@@ -86,143 +131,4 @@ interface DevToolsRpcClientMode {
 }
 declare function getDevToolsRpcClient(options?: DevToolsRpcClientOptions): Promise<DevToolsRpcClient>;
 //#endregion
-//#region src/client/docks.d.ts
-interface DockPanelStorage {
-  mode: 'float' | 'edge';
-  width: number;
-  height: number;
-  top: number;
-  left: number;
-  position: 'left' | 'right' | 'bottom' | 'top';
-  open: boolean;
-  inactiveTimeout: number;
-}
-type DockClientType = 'embedded' | 'standalone';
-interface DevToolsRpcContext {
-  /**
-   * The RPC client to interact with the server
-   */
-  readonly rpc: DevToolsRpcClient;
-}
-interface DocksContext extends DevToolsRpcContext {
-  /**
-   * Type of the client environment
-   *
-   * 'embedded' - running inside an embedded floating panel
-   * 'standalone' - running inside a standalone window (no user app)
-   */
-  readonly clientType: 'embedded' | 'standalone';
-  /**
-   * The panel context
-   */
-  readonly panel: DocksPanelContext;
-  /**
-   * The docks entries context
-   */
-  readonly docks: DocksEntriesContext;
-  /**
-   * The commands context for command palette and shortcuts
-   */
-  readonly commands: CommandsContext;
-  /**
-   * The when-clause context for conditional visibility
-   */
-  readonly when: WhenClauseContext;
-}
-interface WhenClauseContext {
-  /**
-   * Get the current when-clause context snapshot.
-   * Returns a reactive object with built-in variables and any custom plugin variables.
-   */
-  readonly context: WhenContext;
-}
-type DevToolsClientRpcHost = RpcFunctionsCollector<DevToolsRpcClientFunctions, DevToolsRpcContext>;
-type DevToolsClientContext = DocksContext;
-interface DocksPanelContext {
-  store: DockPanelStorage;
-  isDragging: boolean;
-  isResizing: boolean;
-  readonly isVertical: boolean;
-}
-interface DocksEntriesContext {
-  selectedId: string | null;
-  readonly selected: DevToolsDockEntry | null;
-  entries: DevToolsDockEntry[];
-  entryToStateMap: Map<string, DockEntryState>;
-  groupedEntries: DevToolsDockEntriesGrouped;
-  settings: SharedState<DevToolsDocksUserSettings>;
-  /**
-   * Get the state of a dock entry by its ID
-   */
-  getStateById: (id: string) => DockEntryState | undefined;
-  /**
-   * Switch to the selected dock entry, pass `null` to clear the selection
-   *
-   * @returns Whether the selection was changed successfully
-   */
-  switchEntry: (id?: string | null) => Promise<boolean>;
-  /**
-   * Toggle the selected dock entry
-   *
-   * @returns Whether the selection was changed successfully
-   */
-  toggleEntry: (id: string) => Promise<boolean>;
-}
-interface DockEntryState {
-  entryMeta: DevToolsDockEntry;
-  readonly isActive: boolean;
-  domElements: {
-    iframe?: HTMLIFrameElement | null;
-    panel?: HTMLDivElement | null;
-  };
-  events: EventEmitter<DockEntryStateEvents>;
-}
-interface DockEntryStateEvents {
-  'entry:activated': () => void;
-  'entry:deactivated': () => void;
-  'entry:updated': (newMeta: DevToolsDockUserEntry) => void;
-  'dom:panel:mounted': (panel: HTMLDivElement) => void;
-  'dom:iframe:mounted': (iframe: HTMLIFrameElement) => void;
-}
-interface RpcClientEvents {
-  'rpc:is-trusted:updated': (isTrusted: boolean) => void;
-}
-interface CommandsContext {
-  /**
-   * All commands (server + client)
-   */
-  readonly commands: DevToolsCommandEntry[];
-  /**
-   * Palette-visible commands only (filtered by `showInPalette !== false`)
-   */
-  readonly paletteCommands: DevToolsCommandEntry[];
-  /**
-   * Register client-side command(s). Returns cleanup function.
-   */
-  register: (cmd: DevToolsClientCommand | DevToolsClientCommand[]) => () => void;
-  /**
-   * Execute a command by ID. Delegates to RPC for server commands.
-   */
-  execute: (id: string, ...args: any[]) => Promise<unknown>;
-  /**
-   * Get effective keybindings for a command (defaults merged with overrides)
-   */
-  getKeybindings: (id: string) => DevToolsCommandKeybinding[];
-  /**
-   * User settings store (persisted, includes command shortcuts)
-   */
-  settings: SharedState<DevToolsDocksUserSettings>;
-  /**
-   * Whether the command palette is open
-   */
-  paletteOpen: boolean;
-}
-//#endregion
-//#region src/client/context.d.ts
-declare const CLIENT_CONTEXT_KEY = "__VITE_DEVTOOLS_CLIENT_CONTEXT__";
-/**
- * Get the global DevTools client context, or `undefined` if not yet initialized.
- */
-declare function getDevToolsClientContext(): DevToolsClientContext | undefined;
-//#endregion
-export { CLIENT_CONTEXT_KEY, CommandsContext, DevToolsClientContext, DevToolsClientRpcHost, DevToolsRpcClient, DevToolsRpcClientCall, DevToolsRpcClientCallEvent, DevToolsRpcClientCallOptional, DevToolsRpcClientMode, DevToolsRpcClientOptions, DevToolsRpcContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DocksContext, DocksEntriesContext, DocksPanelContext, RpcClientEvents, WhenClauseContext, getDevToolsRpcClient as connectDevtool, getDevToolsRpcClient, getDevToolsClientContext };
+export { DevToolsClientRpcHost, DevToolsRpcClient, DevToolsRpcClientCall, DevToolsRpcClientCallEvent, DevToolsRpcClientCallOptional, DevToolsRpcClientMode, DevToolsRpcClientOptions, DevToolsRpcContext, RpcClientEvents, RpcStreamingClientHost, StreamingSubscribeOptions, getDevToolsRpcClient as connectDevtool, getDevToolsRpcClient, createRpcStreamingClientHost };