devframe 0.1.20 → 0.1.22

package/dist/{devtool-Bm6zZAw5.d.mts → devframe-DulcIxwu.d.mts}

@@ -1,11 +1,9 @@
-import { g as RpcFunctionsCollectorBase } from "./index-BCo03GEF.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-VQqESKAs.mjs";
+import { f as RpcFunctionsCollectorBase } from "./index-DB2Ie0Or.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-DjvlwLuM.mjs";
 import { Logger, createLogger, defineDiagnostics } from "logs-sdk";
 import { BirpcReturn } from "birpc";
-import { Objectish, Patch, Patch as SharedStatePatch } from "immer";
 import { CAC } from "cac";
 import { GenericSchema, InferOutput } from "valibot";
-import { ChildProcess } from "node:child_process";
 
 //#region src/adapters/flags.d.ts
 /**
@@ -26,7 +24,7 @@ type CliFlagsSchema = Record<string, GenericSchema>;
  *   config: v.optional(v.string()),
  * })
  *
- * defineDevtool({
+ * defineDevframe({
  *   cli: { flags: appFlags },
  *   setup(ctx, info) {
  *     const flags = info.flags as InferCliFlags<typeof appFlags>
@@ -286,127 +284,6 @@ interface DevToolsAgentHost {
   getResource: (id: string) => AgentResource | undefined;
 }
 //#endregion
-//#region src/types/commands.d.ts
-interface DevToolsCommandKeybinding {
-  /**
-   * Keyboard shortcut string.
-   * Use "Mod" for platform-aware modifier (Cmd on macOS, Ctrl elsewhere).
-   * Examples: "Mod+K", "Mod+Shift+P", "Alt+N"
-   */
-  key: string;
-}
-interface DevToolsCommandBase {
-  /**
-   * Unique namespaced ID, e.g. "vite:open-in-editor"
-   */
-  id: string;
-  title: string;
-  description?: string;
-  /**
-   * Iconify icon string, e.g. "ph:pencil-duotone"
-   */
-  icon?: string;
-  category?: string;
-  /**
-   * Whether to show in command palette. Default: true
-   *
-   * - `true` — show the command and flatten its children into search results
-   * - `false` — hide the command entirely from the palette
-   * - `'without-children'` — show the command but don't flatten children into top-level search (children are still accessible via drill-down)
-   */
-  showInPalette?: boolean | 'without-children';
-  /**
-   * Optional context expression for conditional visibility.
-   * When set, the command is only shown in the palette and only executable
-   * when the expression evaluates to true.
-   *
-   * Uses the same syntax as keybinding `when` clauses.
-   * @example 'clientType == embedded'
-   * @example 'dockOpen && !paletteOpen'
-   */
-  when?: string;
-  /**
-   * Default keyboard shortcut(s) for this command
-   */
-  keybindings?: DevToolsCommandKeybinding[];
-}
-/**
- * Server command input — what plugins pass to `ctx.commands.register()`.
- */
-interface DevToolsServerCommandInput extends DevToolsCommandBase {
-  /**
-   * Handler for this command. Optional if the command only serves as a group for children.
-   */
-  handler?: (...args: any[]) => any | Promise<any>;
-  /**
-   * Static sub-commands. Two levels max (parent → children).
-   * Each child must have a globally unique `id`.
-   */
-  children?: DevToolsServerCommandInput[];
-}
-/**
- * Serializable server command entry — sent over RPC (no handler).
- */
-interface DevToolsServerCommandEntry extends DevToolsCommandBase {
-  source: 'server';
-  children?: DevToolsServerCommandEntry[];
-}
-/**
- * Client command — registered in the webcomponent context.
- */
-interface DevToolsClientCommand extends DevToolsCommandBase {
-  source: 'client';
-  /**
-   * Action for this command. Optional if the command only serves as a group for children.
-   * Return sub-commands for dynamic nested palette menus (runtime submenus).
-   */
-  action?: (...args: any[]) => void | DevToolsClientCommand[] | Promise<void | DevToolsClientCommand[]>;
-  /**
-   * Static sub-commands. Two levels max (parent → children).
-   */
-  children?: DevToolsClientCommand[];
-}
-/**
- * Union of command entries visible in the palette.
- */
-type DevToolsCommandEntry = DevToolsServerCommandEntry | DevToolsClientCommand;
-interface DevToolsCommandHandle {
-  readonly id: string;
-  update: (patch: Partial<Omit<DevToolsServerCommandInput, 'id'>>) => void;
-  unregister: () => void;
-}
-interface DevToolsCommandsHostEvents {
-  'command:registered': (command: DevToolsServerCommandEntry) => void;
-  'command:unregistered': (id: string) => void;
-}
-interface DevToolsCommandsHost {
-  readonly commands: Map<string, DevToolsServerCommandInput>;
-  readonly events: EventEmitter<DevToolsCommandsHostEvents>;
-  /**
-   * Register a command (with optional children).
-   */
-  register: (command: DevToolsServerCommandInput) => DevToolsCommandHandle;
-  /**
-   * Unregister a command by ID (removes parent and all children).
-   */
-  unregister: (id: string) => boolean;
-  /**
-   * Execute a command by ID. Searches top-level and children.
-   * Throws if not found or if command has no handler.
-   */
-  execute: (id: string, ...args: any[]) => Promise<unknown>;
-  /**
-   * Returns serializable list (no handlers), preserving tree structure.
-   */
-  list: () => DevToolsServerCommandEntry[];
-}
-interface DevToolsCommandShortcutOverrides {
-  /**
-   * Command ID → keybinding overrides. Empty array = shortcut disabled.
-   */
-  [commandId: string]: DevToolsCommandKeybinding[];
-}
-//#endregion
 //#region src/types/diagnostics.d.ts
 /**
  * A diagnostics definition object built with `defineDiagnostics`. Typed as
@@ -473,183 +350,6 @@ interface DevToolsDiagnosticsHost {
   createLogger: typeof createLogger;
 }
 //#endregion
-//#region src/types/docks.d.ts
-interface DevToolsDockHost {
-  readonly views: Map<string, DevToolsDockUserEntry>;
-  readonly events: EventEmitter<{
-    'dock:entry:updated': (entry: DevToolsDockUserEntry) => void;
-  }>;
-  register: <T extends DevToolsDockUserEntry>(entry: T, force?: boolean) => {
-    update: (patch: Partial<T>) => void;
-  };
-  update: (entry: DevToolsDockUserEntry) => void;
-  values: (options?: {
-    includeBuiltin?: boolean;
-  }) => DevToolsDockEntry[];
-}
-type DevToolsDockEntryCategory = 'app' | 'framework' | 'web' | 'advanced' | 'default' | '~viteplus' | '~builtin';
-type DevToolsDockEntryIcon = string | {
-  light: string;
-  dark: string;
-};
-interface DevToolsDockEntryBase {
-  id: string;
-  title: string;
-  icon: DevToolsDockEntryIcon;
-  /**
-   * The default order of the entry in the dock.
-   * The higher the number the earlier it appears.
-   * @default 0
-   */
-  defaultOrder?: number;
-  /**
-   * The category of the entry
-   * @default 'default'
-   */
-  category?: DevToolsDockEntryCategory;
-  /**
-   * Conditional visibility expression.
-   * When set, the dock entry is only visible when the expression evaluates to true.
-   * Uses the same syntax as command `when` clauses.
-   *
-   * Set to `'false'` to unconditionally hide the entry.
-   *
-   * @example 'clientType == embedded'
-   * @see {@link import('../utils/when').evaluateWhen}
-   */
-  when?: string;
-  /**
-   * Badge text to display on the dock icon (e.g., unread count)
-   */
-  badge?: string;
-}
-interface ClientScriptEntry {
-  /**
-   * The filepath or module name to import from
-   */
-  importFrom: string;
-  /**
-   * The name to import the module as
-   *
-   * @default 'default'
-   */
-  importName?: string;
-}
-interface DevToolsViewIframe extends DevToolsDockEntryBase {
-  type: 'iframe';
-  url: string;
-  /**
-   * The id of the iframe, if multiple tabs is assigned with the same id, the iframe will be shared.
-   *
-   * When not provided, it would be treated as a unique frame.
-   */
-  frameId?: string;
-  /**
-   * Optional client script to import into the iframe
-   */
-  clientScript?: ClientScriptEntry;
-  /**
-   * Enable remote-UI mode: the core injects a connection descriptor
-   * (WS URL + pre-approved auth token) into the iframe URL so a hosted
-   * page can connect back via `connectRemoteDevTools()` from
-   * `@vitejs/devtools-kit/client` — without needing to ship a dist with
-   * the plugin.
-   *
-   * Requires dev mode (no effect in build mode — no WS server exists).
-   * When enabled, the dock is automatically hidden in build mode unless
-   * the author provides an explicit `when` clause.
-   *
-   * @example
-   *   remote: true
-   *   remote: { transport: 'query', originLock: false }
-   */
-  remote?: boolean | RemoteDockOptions;
-}
-interface RemoteDockOptions {
-  /**
-   * How to pass the connection descriptor to the hosted page.
-   *
-   * - `'fragment'` (default): appended as `#vite-devtools-kit-connection=...`.
-   *   Not sent in HTTP requests or Referer headers — safest for auth tokens.
-   * - `'query'`: appended as `?vite-devtools-kit-connection=...`. Use when
-   *   your hosting platform rewrites fragments or your SPA router repurposes
-   *   the fragment for navigation. The token will appear in server access
-   *   logs and outbound Referer headers.
-   *
-   * @default 'fragment'
-   */
-  transport?: 'fragment' | 'query';
-  /**
-   * Reject WS handshakes whose `Origin` header doesn't match the dock URL
-   * origin. Turn off when the same hosted app is served from multiple
-   * origins (e.g. preview deploys).
-   *
-   * @default true
-   */
-  originLock?: boolean;
-}
-type DevToolsViewLauncherStatus = 'idle' | 'loading' | 'success' | 'error';
-interface DevToolsViewLauncher extends DevToolsDockEntryBase {
-  type: 'launcher';
-  launcher: {
-    icon?: DevToolsDockEntryIcon;
-    title: string;
-    status?: DevToolsViewLauncherStatus;
-    error?: string;
-    description?: string;
-    buttonStart?: string;
-    buttonLoading?: string;
-    onLaunch: () => Promise<void>;
-  };
-}
-interface DevToolsViewAction extends DevToolsDockEntryBase {
-  type: 'action';
-  action: ClientScriptEntry;
-}
-interface DevToolsViewCustomRender extends DevToolsDockEntryBase {
-  type: 'custom-render';
-  renderer: ClientScriptEntry;
-}
-interface DevToolsViewBuiltin extends DevToolsDockEntryBase {
-  type: '~builtin';
-  id: '~terminals' | '~messages' | '~client-auth-notice' | '~settings' | '~popup';
-}
-interface JsonRenderElement {
-  type: string;
-  props?: Record<string, unknown>;
-  children?: string[];
-  /** json-render event bindings (e.g. `{ press: { action: "my:action" } }`) */
-  on?: Record<string, unknown>;
-  /** json-render visibility condition */
-  visible?: unknown;
-  /** json-render repeat binding */
-  repeat?: unknown;
-  /** Allow additional json-render element fields */
-  [key: string]: unknown;
-}
-interface JsonRenderSpec {
-  root: string;
-  elements: Record<string, JsonRenderElement>;
-  /** Initial client-side state model for $state/$bindState expressions */
-  state?: Record<string, unknown>;
-}
-interface JsonRenderer {
-  /** Replace the entire spec */
-  updateSpec: (spec: JsonRenderSpec) => void | Promise<void>;
-  /** Update json-render state values (shallow merge into spec.state) */
-  updateState: (state: Record<string, unknown>) => void | Promise<void>;
-  /** Internal: shared state key used by the client to subscribe */
-  readonly _stateKey: string;
-}
-interface DevToolsViewJsonRender extends DevToolsDockEntryBase {
-  type: 'json-render';
-  /** JsonRenderer handle created by ctx.createJsonRenderer() */
-  ui: JsonRenderer;
-}
-type DevToolsDockUserEntry = DevToolsViewIframe | DevToolsViewAction | DevToolsViewCustomRender | DevToolsViewLauncher | DevToolsViewJsonRender;
-type DevToolsDockEntry = DevToolsDockUserEntry | DevToolsViewBuiltin;
-type DevToolsDockEntriesGrouped = [category: string, entries: DevToolsDockEntry[]][];
-//#endregion
 //#region src/types/host.d.ts
 interface DevToolsHost {
   /**
@@ -686,167 +386,6 @@ interface DevToolsHost {
   getStorageDir: (scope: 'workspace' | 'global') => string;
 }
 //#endregion
-//#region src/types/messages.d.ts
-type DevToolsMessageLevel = 'info' | 'warn' | 'error' | 'success' | 'debug';
-type DevToolsMessageEntryFrom = 'server' | 'browser';
-interface DevToolsMessageElementPosition {
-  /** CSS selector for the element */
-  selector?: string;
-  /** Bounding box of the element */
-  boundingBox?: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  };
-  /** Human-readable description of the element */
-  description?: string;
-}
-interface DevToolsMessageFilePosition {
-  /** Absolute or relative file path */
-  file: string;
-  /** Line number (1-based) */
-  line?: number;
-  /** Column number (1-based) */
-  column?: number;
-}
-interface DevToolsMessageEntry {
-  /**
-   * Unique identifier for this message entry (auto-generated if not provided)
-   */
-  id: string;
-  /**
-   * Short title or summary of the message
-   */
-  message: string;
-  /**
-   * Optional detailed description or explanation
-   */
-  description?: string;
-  /**
-   * Severity level, determines color and icon
-   */
-  level: DevToolsMessageLevel;
-  /**
-   * Optional stack trace string
-   */
-  stacktrace?: string;
-  /**
-   * Optional DOM element position info (e.g., for a11y issues)
-   */
-  elementPosition?: DevToolsMessageElementPosition;
-  /**
-   * Optional source file position info (e.g., for lint errors)
-   */
-  filePosition?: DevToolsMessageFilePosition;
-  /**
-   * Whether this message should also appear as a toast notification
-   */
-  notify?: boolean;
-  /**
-   * Origin of the message entry, automatically set by the context
-   */
-  from: DevToolsMessageEntryFrom;
-  /**
-   * Grouping category (e.g., 'a11y', 'lint', 'runtime', 'test')
-   */
-  category?: string;
-  /**
-   * Optional tags/labels for filtering
-   */
-  labels?: string[];
-  /**
-   * Time in ms to auto-dismiss the toast notification (client-side)
-   */
-  autoDismiss?: number;
-  /**
-   * Time in ms to auto-delete this message entry (server-side)
-   */
-  autoDelete?: number;
-  /**
-   * Timestamp when the message was created (auto-generated if not provided)
-   */
-  timestamp: number;
-  /**
-   * Status of the message entry (e.g., 'loading' while an operation is in progress).
-   * Defaults to 'idle' when not specified.
-   */
-  status?: 'loading' | 'idle';
-}
-/**
- * Input type for creating a message entry.
- * `id`, `timestamp`, and `from` are auto-filled by the host.
- */
-type DevToolsMessageEntryInput = Omit<DevToolsMessageEntry, 'id' | 'timestamp' | 'from'> & {
-  id?: string;
-  timestamp?: number;
-};
-interface DevToolsMessageHandle {
-  /** The underlying message entry data */
-  readonly entry: DevToolsMessageEntry;
-  /** Shortcut to entry.id */
-  readonly id: string;
-  /** Partial update of this message entry */
-  update: (patch: Partial<DevToolsMessageEntryInput>) => Promise<DevToolsMessageEntry | undefined>;
-  /** Remove this message entry */
-  dismiss: () => Promise<void>;
-}
-interface DevToolsMessagesClient {
-  /**
-   * Add a message entry. Returns a Promise resolving to a handle for subsequent updates/dismissal.
-   * Can be used without `await` for fire-and-forget usage.
-   */
-  add: (input: DevToolsMessageEntryInput) => Promise<DevToolsMessageHandle>;
-  /** Remove a message entry by id */
-  remove: (id: string) => Promise<void>;
-  /** Clear all message entries */
-  clear: () => Promise<void>;
-}
-interface DevToolsMessagesHost {
-  readonly entries: Map<string, DevToolsMessageEntry>;
-  readonly events: EventEmitter<{
-    'message:added': (entry: DevToolsMessageEntry) => void;
-    'message:updated': (entry: DevToolsMessageEntry) => void;
-    'message:removed': (id: string) => void;
-    'message:cleared': () => void;
-  }>;
-  /**
-   * Add a new message entry. If an entry with the same `id` already exists, it will be updated instead.
-   * Returns a handle for subsequent updates/dismissal. Can be used without `await` for fire-and-forget.
-   */
-  add: (entry: DevToolsMessageEntryInput) => Promise<DevToolsMessageHandle>;
-  /**
-   * Update an existing message entry by id (partial update)
-   */
-  update: (id: string, patch: Partial<DevToolsMessageEntryInput>) => Promise<DevToolsMessageEntry | undefined>;
-  /**
-   * Remove a message entry by id
-   */
-  remove: (id: string) => Promise<void>;
-  /**
-   * Clear all message entries
-   */
-  clear: () => Promise<void>;
-}
-/** @deprecated alias of {@link DevToolsMessageLevel}. Will be removed in a future release. */
-type DevToolsLogLevel = DevToolsMessageLevel;
-/** @deprecated alias of {@link DevToolsMessageEntryFrom}. Will be removed in a future release. */
-type DevToolsLogEntryFrom = DevToolsMessageEntryFrom;
-/** @deprecated alias of {@link DevToolsMessageElementPosition}. Will be removed in a future release. */
-type DevToolsLogElementPosition = DevToolsMessageElementPosition;
-/** @deprecated alias of {@link DevToolsMessageFilePosition}. Will be removed in a future release. */
-type DevToolsLogFilePosition = DevToolsMessageFilePosition;
-/** @deprecated alias of {@link DevToolsMessageEntry}. Will be removed in a future release. */
-type DevToolsLogEntry = DevToolsMessageEntry;
-/** @deprecated alias of {@link DevToolsMessageEntryInput}. Will be removed in a future release. */
-type DevToolsLogEntryInput = DevToolsMessageEntryInput;
-/** @deprecated alias of {@link DevToolsMessageHandle}. Will be removed in a future release. */
-type DevToolsLogHandle = DevToolsMessageHandle;
-/** @deprecated alias of {@link DevToolsMessagesClient}. Will be removed in a future release. */
-type DevToolsLogsClient = DevToolsMessagesClient;
-/** @deprecated alias of {@link DevToolsMessagesHost}. Will be removed in a future release. */
-type DevToolsLogsHost = DevToolsMessagesHost;
-//#endregion
 //#region src/types/rpc-augments.d.ts
 /**
  * To be extended
@@ -955,53 +494,6 @@ interface DevToolsRpcServerFunctions {
  */
 interface DevToolsRpcSharedStates {}
 //#endregion
-//#region src/types/settings.d.ts
-interface DevToolsDocksUserSettings {
-  docksHidden: string[];
-  docksCategoriesHidden: string[];
-  docksPinned: string[];
-  docksCustomOrder: Record<string, number>;
-  showIframeAddressBar: boolean;
-  closeOnOutsideClick: boolean;
-  commandShortcuts: DevToolsCommandShortcutOverrides;
-}
-//#endregion
-//#region src/types/terminals.d.ts
-interface DevToolsTerminalHost {
-  readonly sessions: Map<string, DevToolsTerminalSession>;
-  readonly events: EventEmitter<{
-    'terminal:session:updated': (session: DevToolsTerminalSession) => void;
-  }>;
-  register: (session: DevToolsTerminalSession) => DevToolsTerminalSession;
-  update: (session: DevToolsTerminalSession) => void;
-  startChildProcess: (executeOptions: DevToolsChildProcessExecuteOptions, terminal: Omit<DevToolsTerminalSessionBase, 'status'>) => Promise<DevToolsChildProcessTerminalSession>;
-}
-type DevToolsTerminalStatus = 'running' | 'stopped' | 'error';
-interface DevToolsTerminalSessionBase {
-  id: string;
-  title: string;
-  description?: string;
-  status: DevToolsTerminalStatus;
-  icon?: DevToolsDockEntryIcon;
-}
-interface DevToolsTerminalSession extends DevToolsTerminalSessionBase {
-  buffer?: string[];
-  stream?: ReadableStream<string>;
-}
-interface DevToolsChildProcessExecuteOptions {
-  command: string;
-  args: string[];
-  cwd?: string;
-  env?: Record<string, string>;
-}
-interface DevToolsChildProcessTerminalSession extends DevToolsTerminalSession {
-  type: 'child-process';
-  executeOptions: DevToolsChildProcessExecuteOptions;
-  getChildProcess: () => ChildProcess | undefined;
-  terminate: () => Promise<void>;
-  restart: () => Promise<void>;
-}
-//#endregion
 //#region src/types/utils.d.ts
 type Thenable<T> = T | Promise<T>;
 type EntriesToObject<T extends readonly [string, any][]> = { [K in T[number] as K[0]]: K[1] };
@@ -1035,6 +527,15 @@ type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
 type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
 type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
 type ImmutableObject<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+/**
+ * Serializable patch describing a single mutation to a `SharedState`.
+ * Structurally compatible with JSON-Patch and is safe to send over RPC.
+ */
+interface SharedStatePatch {
+  op: 'add' | 'remove' | 'replace';
+  path: readonly (string | number)[];
+  value?: unknown;
+}
 /**
  * State host that is immutable by default with explicit mutate.
  */
@@ -1054,14 +555,14 @@ interface SharedState<T> {
   /**
    * Apply patches to the state.
    */
-  patch: (patches: Patch[], syncId?: string) => void;
+  patch: (patches: SharedStatePatch[], syncId?: string) => void;
   /**
    * Sync IDs that have been applied to the state.
    */
   syncIds: Set<string>;
 }
 interface SharedStateEvents<T> {
-  updated: (fullState: T, patches: Patch[] | undefined, syncId: string) => void;
+  updated: (fullState: T, patches: SharedStatePatch[] | undefined, syncId: string) => void;
 }
 interface SharedStateOptions<T> {
   /**
@@ -1075,7 +576,7 @@ interface SharedStateOptions<T> {
    */
   enablePatches?: boolean;
 }
-declare function createSharedState<T extends Objectish>(options: SharedStateOptions<T>): SharedState<T>;
+declare function createSharedState<T extends object>(options: SharedStateOptions<T>): SharedState<T>;
 //#endregion
 //#region src/utils/streaming-channel.d.ts
 /**
@@ -1364,6 +865,13 @@ interface DevToolsCapabilities {
   rpc?: boolean;
   views?: boolean;
 }
+/**
+ * Framework-neutral node context — RPC + diagnostics + agent + the
+ * view-host (HTTP file-serving). Hub-level subsystems (docks,
+ * terminals, messages, commands) are not part of this surface; they are
+ * added by `@vitejs/devtools-kit`'s `createKitContext` when the devtool
+ * is mounted into a multi-integration hub.
+ */
 interface DevToolsNodeContext {
   readonly workspaceRoot: string;
   readonly cwd: string;
@@ -1388,45 +896,18 @@ interface DevToolsNodeContext {
    */
   host: DevToolsHost;
   rpc: RpcFunctionsHost;
-  docks: DevToolsDockHost;
   views: DevToolsViewHost;
-  utils: DevToolsNodeUtils;
-  terminals: DevToolsTerminalHost;
-  /**
-   * User-facing message subsystem — toast notifications and the
-   * "Messages & Notifications" dock panel. Plugins call
-   * `ctx.messages.add({ ... })` to surface activity to users.
-   */
-  messages: DevToolsMessagesHost;
-  /**
-   * @deprecated Use `ctx.messages` instead. Will be removed in a future release.
-   */
-  readonly logs: DevToolsMessagesHost;
   /**
    * Structured diagnostics host — wraps `logs-sdk` and lets integrations
    * register their own coded errors/warnings into the shared logger.
    */
   diagnostics: DevToolsDiagnosticsHost;
-  commands: DevToolsCommandsHost;
   /**
    * Agent host — aggregates the agent-exposed surface of this devtool.
    *
    * @experimental
    */
   agent: DevToolsAgentHost;
-  /**
-   * Create a JsonRenderer handle for building json-render powered UIs.
-   */
-  createJsonRenderer: (spec: JsonRenderSpec) => JsonRenderer;
-}
-interface DevToolsNodeUtils {
-  /**
-   * Create a simple client script from a function or stringified code.
-   *
-   * @deprecated testing helper; prefer a proper importable module.
-   * @experimental
-   */
-  createSimpleClientScript: (fn: string | ((ctx: any) => void)) => ClientScriptEntry;
 }
 interface ConnectionMeta {
   backend: 'websocket' | 'static';
@@ -1441,25 +922,18 @@ interface ConnectionMeta {
    */
   jsonSerializableMethods?: string[];
 }
-interface RemoteConnectionInfo extends ConnectionMeta {
-  backend: 'websocket';
-  websocket: string;
-  v: 1;
-  authToken: string;
-  origin: string;
-}
 //#endregion
-//#region src/types/devtool.d.ts
-type DevtoolRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'kit' | 'embedded';
+//#region src/types/devframe.d.ts
+type DevframeRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'kit' | 'embedded';
 /**
- * Classification of how a devtool is being deployed. Hosted adapters
+ * Classification of how a devframe is being deployed. Hosted adapters
  * (`vite`, `kit`, `embedded`) share their origin with a host app and
- * must namespace their mount path under `/.<id>/`. Standalone adapters
+ * must namespace their mount path under `/__<id>/`. Standalone adapters
  * (`cli`, `spa`, `build`) own the origin and default to `/`.
  */
-type DevtoolDeploymentKind = 'standalone' | 'hosted';
-interface DevtoolCliOptions {
-  /** Binary name; default: the devtool's `id`. */
+type DevframeDeploymentKind = 'standalone' | 'hosted';
+interface DevframeCliOptions {
+  /** Binary name; default: the devframe's `id`. */
   command?: string;
   /** Preferred port for the dev server (default 9999). */
   port?: number;
@@ -1484,7 +958,7 @@ interface DevtoolCliOptions {
    * `devtools.clientAuth` today.
    */
   auth?: boolean;
-  /** Author's SPA dist directory (served as the devtool's UI). */
+  /** Author's SPA dist directory (served as the devframe's UI). */
   distDir?: string;
   /**
    * Capability-side CAC hook. Called with the CAC instance after the
@@ -1510,7 +984,7 @@ interface DevtoolCliOptions {
    *   config: v.optional(v.string()),
    * })
    *
-   * defineDevtool({
+   * defineDevframe({
    *   cli: { flags: appFlags },
    *   setup(ctx, info) {
    *     const flags = info.flags as InferCliFlags<typeof appFlags>
@@ -1520,7 +994,7 @@ interface DevtoolCliOptions {
    */
   flags?: CliFlagsSchema;
 }
-interface DevtoolSpaOptions {
+interface DevframeSpaOptions {
   base?: string;
   /**
    * How the deployed SPA loads its data.
@@ -1530,7 +1004,7 @@ interface DevtoolSpaOptions {
    */
   loader?: 'query' | 'upload' | 'none';
 }
-interface DevtoolBrowserContext {
+interface DevframeBrowserContext {
   /**
    * The connected RPC client (may be write-disabled in static/spa modes).
    */
@@ -1541,11 +1015,11 @@ interface DevtoolBrowserContext {
  * populate the fields that make sense for their deployment. In
  * particular, `createCli` fills `flags` with the parsed CAC bag.
  */
-interface DevtoolSetupInfo {
+interface DevframeSetupInfo {
   /** Parsed CLI flags, populated by the CLI adapter. */
   flags?: Record<string, unknown>;
 }
-interface DevtoolDefinition {
+interface DevframeDefinition {
   id: string;
   name: string;
   icon?: string | {
@@ -1555,7 +1029,7 @@ interface DevtoolDefinition {
   version?: string;
   /**
    * Mount path override. Defaults depend on the adapter:
-   * `/` for standalone (`cli` / `spa` / `build`), `/.<id>/` for hosted
+   * `/` for standalone (`cli` / `spa` / `build`), `/__<id>/` for hosted
    * (`vite` / `kit` / `embedded`).
    */
   basePath?: string;
@@ -1565,12 +1039,28 @@ interface DevtoolDefinition {
     spa?: boolean | Record<string, boolean>;
   };
   /** Server-side setup — the primary entrypoint. Runs in every runtime. */
-  setup: (ctx: DevToolsNodeContext, info?: DevtoolSetupInfo) => void | Promise<void>;
+  setup: (ctx: DevToolsNodeContext, info?: DevframeSetupInfo) => void | Promise<void>;
   /** Browser-only setup for the SPA adapter (bundled into the client). */
-  setupBrowser?: (ctx: DevtoolBrowserContext) => void | Promise<void>;
-  cli?: DevtoolCliOptions;
-  spa?: DevtoolSpaOptions;
-}
-declare function defineDevtool(d: DevtoolDefinition): DevtoolDefinition;
+  setupBrowser?: (ctx: DevframeBrowserContext) => void | Promise<void>;
+  cli?: DevframeCliOptions;
+  spa?: DevframeSpaOptions;
+}
+declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
+/** @deprecated Use `DevframeRuntime`. */
+type DevtoolRuntime = DevframeRuntime;
+/** @deprecated Use `DevframeDeploymentKind`. */
+type DevtoolDeploymentKind = DevframeDeploymentKind;
+/** @deprecated Use `DevframeCliOptions`. */
+type DevtoolCliOptions = DevframeCliOptions;
+/** @deprecated Use `DevframeSpaOptions`. */
+type DevtoolSpaOptions = DevframeSpaOptions;
+/** @deprecated Use `DevframeBrowserContext`. */
+type DevtoolBrowserContext = DevframeBrowserContext;
+/** @deprecated Use `DevframeSetupInfo`. */
+type DevtoolSetupInfo = DevframeSetupInfo;
+/** @deprecated Use `DevframeDefinition`. */
+type DevtoolDefinition = DevframeDefinition;
+/** @deprecated Use `defineDevframe`. */
+declare function defineDevtool(d: DevframeDefinition): DevframeDefinition;
 //#endregion
-export { DevToolsRpcServerFunctions as $, AgentManifest as $t, createStreamSink as A, DevToolsViewCustomRender as At, createSharedState as B, DevToolsDiagnosticsHost as Bt, CreateStreamReaderOptions as C, DevToolsDockEntryBase as Ct, StreamSink as D, DevToolsDockUserEntry as Dt, StreamReader as E, DevToolsDockHost as Et, ImmutableSet as F, JsonRenderElement as Ft, DevToolsChildProcessExecuteOptions as G, DevToolsCommandHandle as Gt, EntriesToObject as H, DevToolsClientCommand as Ht, SharedState as I, JsonRenderSpec as It, DevToolsTerminalSession as J, DevToolsCommandsHost as Jt, DevToolsChildProcessTerminalSession as K, DevToolsCommandKeybinding as Kt, SharedStateEvents as L, JsonRenderer as Lt, ImmutableArray as M, DevToolsViewJsonRender as Mt, ImmutableMap as N, DevToolsViewLauncher as Nt, StreamSinkEvents as O, DevToolsViewAction as Ot, ImmutableObject as P, DevToolsViewLauncherStatus as Pt, DevToolsRpcClientFunctions as Q, AgentHandle as Qt, SharedStateOptions as R, RemoteDockOptions as Rt, BufferedChunk as S, DevToolsDockEntry as St, StreamErrorPayload as T, DevToolsDockEntryIcon as Tt, PartialWithoutId as U, DevToolsCommandBase as Ut, DevToolsViewHost as V, DevToolsDiagnosticsLogger as Vt, Thenable as W, DevToolsCommandEntry as Wt, DevToolsTerminalStatus as X, DevToolsServerCommandEntry as Xt, DevToolsTerminalSessionBase as Y, DevToolsCommandsHostEvents as Yt, DevToolsDocksUserSettings as Z, DevToolsServerCommandInput as Zt, RpcSharedStateGetOptions as _, DevToolsMessagesClient as _t, DevtoolRuntime as a, DevToolsAgentHost as an, DevToolsLogFilePosition as at, RpcStreamingChannelOptions as b, ClientScriptEntry as bt, defineDevtool as c, EventUnsubscribe as cn, DevToolsLogsClient as ct, DevToolsNodeContext as d, InferCliFlags as dn, DevToolsMessageEntry as dt, AgentResource as en, DevToolsRpcSharedStates as et, DevToolsNodeUtils as f, defineCliFlags as fn, DevToolsMessageEntryFrom as ft, RpcFunctionsHost as g, DevToolsMessageLevel as gt, RpcBroadcastOptions as h, DevToolsMessageHandle as ht, DevtoolDeploymentKind as i, AgentToolInput as in, DevToolsLogEntryInput as it, Immutable as j, DevToolsViewIframe as jt, createStreamReader as k, DevToolsViewBuiltin as kt, ConnectionMeta as l, EventsMap as ln, DevToolsLogsHost as lt, DevToolsNodeRpcSession as m, DevToolsMessageFilePosition as mt, DevtoolCliOptions as n, AgentResourceInput as nn, DevToolsLogEntry as nt, DevtoolSetupInfo as o, DevToolsAgentHostEvents as on, DevToolsLogHandle as ot, RemoteConnectionInfo as p, parseCliFlags as pn, DevToolsMessageEntryInput as pt, DevToolsTerminalHost as q, DevToolsCommandShortcutOverrides as qt, DevtoolDefinition as r, AgentTool as rn, DevToolsLogEntryFrom as rt, DevtoolSpaOptions as s, EventEmitter as sn, DevToolsLogLevel as st, DevtoolBrowserContext as t, AgentResourceContent as tn, DevToolsLogElementPosition as tt, DevToolsCapabilities as u, CliFlagsSchema as un, DevToolsMessageElementPosition as ut, RpcSharedStateHost as v, DevToolsMessagesHost as vt, CreateStreamSinkOptions as w, DevToolsDockEntryCategory as wt, RpcStreamingHost as x, DevToolsDockEntriesGrouped as xt, RpcStreamingChannel as y, DevToolsHost as yt, SharedStatePatch as z, DevToolsDiagnosticsDefinition as zt };
+export { DevToolsRpcSharedStates as $, CreateStreamSinkOptions as A, ImmutableObject as B, RpcSharedStateGetOptions as C, RpcStreamingHost as D, RpcStreamingChannelOptions as E, createStreamReader as F, SharedStatePatch as G, SharedState as H, createStreamSink as I, EntriesToObject as J, createSharedState as K, Immutable as L, StreamReader as M, StreamSink as N, BufferedChunk as O, StreamSinkEvents as P, DevToolsRpcServerFunctions as Q, ImmutableArray as R, RpcFunctionsHost as S, RpcStreamingChannel as T, SharedStateEvents as U, ImmutableSet as V, SharedStateOptions as W, Thenable as X, PartialWithoutId as Y, DevToolsRpcClientFunctions as Z, ConnectionMeta as _, InferCliFlags as _t, DevframeRuntime as a, AgentManifest as at, DevToolsNodeRpcSession as b, DevtoolBrowserContext as c, AgentResourceInput as ct, DevtoolDeploymentKind as d, DevToolsAgentHost as dt, DevToolsHost as et, DevtoolRuntime as f, DevToolsAgentHostEvents as ft, defineDevtool as g, CliFlagsSchema as gt, defineDevframe as h, EventsMap as ht, DevframeDeploymentKind as i, AgentHandle as it, StreamErrorPayload as j, CreateStreamReaderOptions as k, DevtoolCliOptions as l, AgentTool as lt, DevtoolSpaOptions as m, EventUnsubscribe as mt, DevframeCliOptions as n, DevToolsDiagnosticsHost as nt, DevframeSetupInfo as o, AgentResource as ot, DevtoolSetupInfo as p, EventEmitter as pt, DevToolsViewHost as q, DevframeDefinition as r, DevToolsDiagnosticsLogger as rt, DevframeSpaOptions as s, AgentResourceContent as st, DevframeBrowserContext as t, DevToolsDiagnosticsDefinition as tt, DevtoolDefinition as u, AgentToolInput as ut, DevToolsCapabilities as v, defineCliFlags as vt, RpcSharedStateHost as w, RpcBroadcastOptions as x, DevToolsNodeContext as y, parseCliFlags as yt, ImmutableMap as z };