@volter/editor-live 0.5.67 → 0.5.69

package/dist/session.d.ts

@@ -10,7 +10,7 @@ export type SessionListingTransport = SessionDiscoveryTransport;
 export interface ResolvedSession {
     /** Editor dev-server port the resolved session is listening on. */
     port: number;
-    /** Absolute project root — the nearest ancestor of the requested directory containing `vgai.project.json`. */
+    /** Absolute project root — the nearest ancestor of the requested directory containing `volter.project.json`. */
     projectRoot: string;
 }
 export interface SessionResolutionDeps {
@@ -18,7 +18,7 @@ export interface SessionResolutionDeps {
     transport?: SessionListingTransport;
     /** Project-root discovery — defaults to the real fs walk (`findProjectRootFrom` above). Overridable for tests. */
     findProjectRootFrom?: (dir: string) => string | null;
-    /** Project-local session hint reader. Defaults to `.vgai/session.json`. */
+    /** Project-local session hint reader. Defaults to `.volter/session.json`. */
     readProjectSession?: (projectRoot: string) => ProjectSessionHint | null;
     /** Exact-session verifier. Defaults to GET /__editor/project + canonical project matching. */
     verifyProjectSession?: (hint: ProjectSessionHint, projectRoot: string) => Promise<boolean>;

package/dist/tools.d.ts

@@ -3,7 +3,7 @@ import type { EditorClient, ProjectToolCatalog, ProjectToolCatalogEntry, Project
 export declare class LiveTools {
     #private;
     constructor(client: EditorClient);
-    /** Enumerate the exact `package.json#vgai.tools` catalog without executing it. */
+    /** Enumerate the exact `package.json#volter.tools` catalog without executing it. */
     list(): Promise<ProjectToolCatalog>;
     /** Return one tool's discoverable metadata, or `null` when it is not registered. */
     describe(name: string): Promise<ProjectToolCatalogEntry | null>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-live",
   "author": "Volter AI, Inc.",
-  "version": "0.5.67",
+  "version": "0.5.69",
   "publishConfig": {
     "access": "public"
   },
@@ -30,8 +30,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@volter/editor-sdk": "0.5.67",
-    "@volter/editor-project": "0.5.67",
+    "@volter/editor-sdk": "0.5.69",
+    "@volter/editor-project": "0.5.69",
     "undici": "^7.28.0"
   },
   "devDependencies": {

package/src/editor-document.ts

@@ -28,7 +28,7 @@
  * active; `editor.hierarchy()` / `editor.inspect()` keep answering what those
  * panels RESOLVED, where this door answers what they DREW.
  *
- * A field on `LiveEditor` rather than methods on it, so `vgai eval --list`
+ * A field on `LiveEditor` rather than methods on it, so the editor's `eval --list` command
  * shows the verbs as one named surface — the same reason `game.input`
  * and `game.events` are instance fields.
  */
@@ -90,13 +90,13 @@ export class LiveEditorDocument {
    * `styles` additionally resolves named properties per match — and resolving
    * is the point, because a theme token is an expression until an element
    * paints it. Ask for the standard property to learn the colour a person
-   * sees; ask for a `--vgai-…` custom property to learn what a rule WOULD
+   * sees; ask for a `--volter-…` custom property to learn what a rule WOULD
    * paint, which is the only way to measure a `:hover` colour (`:hover` is a
    * browser state no synthetic event can enter, so there is deliberately no
    * hover verb on this door).
    *
-   *   await editor.document.query('.vgai-tree-row', {
-   *     styles: ['backgroundColor', '--vgai-widget-regular-hover'],
+   *   await editor.document.query('.volter-tree-row', {
+   *     styles: ['backgroundColor', '--volter-widget-regular-hover'],
    *   });
    */
   async query(
@@ -116,12 +116,20 @@ export class LiveEditorDocument {
    *  — not `element.click()`, which a `pointerdown` listener never sees. */
   async click(
     selector: string,
-    options?: DocumentGestureOptions & { clicks?: number; at?: [number, number] },
+    options?: DocumentGestureOptions & {
+      clicks?: number;
+      at?: [number, number];
+      altKey?: boolean;
+      ctrlKey?: boolean;
+      metaKey?: boolean;
+      shiftKey?: boolean;
+    },
   ): Promise<DocumentProbeResult> {
     // An option this door does not know is refused, never dropped: a dropped `position` clicked
     // the element's centre and answered as if it had clicked where it was asked.
-    const unknown = Object.keys(options ?? {}).filter((key) => !['scope', 'index', 'clicks', 'at'].includes(key));
-    if (unknown.length > 0) throw new Error(`click has no option ${unknown.map((key) => `\`${key}\``).join(', ')}; its options are scope, index, clicks and at ([x, y] fractions of the element's box).`);
+    const known = ['scope', 'index', 'clicks', 'at', 'altKey', 'ctrlKey', 'metaKey', 'shiftKey'];
+    const unknown = Object.keys(options ?? {}).filter((key) => !known.includes(key));
+    if (unknown.length > 0) throw new Error(`click has no option ${unknown.map((key) => `\`${key}\``).join(', ')}; its options are scope, index, clicks, at ([x, y] fractions of the element's box) and the modifier keys altKey, ctrlKey, metaKey and shiftKey.`);
     return this.#probe({
       action: 'click',
       selector,
@@ -129,6 +137,10 @@ export class LiveEditorDocument {
       ...(options?.index === undefined ? {} : { index: options.index }),
       ...(options?.clicks === undefined ? {} : { clicks: options.clicks }),
       ...(options?.at === undefined ? {} : { at: options.at }),
+      ...(options?.altKey ? { altKey: true } : {}),
+      ...(options?.ctrlKey ? { ctrlKey: true } : {}),
+      ...(options?.metaKey ? { metaKey: true } : {}),
+      ...(options?.shiftKey ? { shiftKey: true } : {}),
     });
   }
 

package/src/editor.ts

@@ -127,7 +127,7 @@ export class LiveEditor {
    * `blender-execute`, `blender-scene-info`, `blender-object-info`,
    * `blender-screenshot-view`, `blender-read-file`, `blender-write-file`,
    * `blender-list-files`, `blender-stop` and `blender-status`. They were
-   * reachable from `@volter/editor-sdk` and through `vgai blender-mcp` but from
+   * reachable from `@volter/editor-sdk` and through `volter blender-mcp` but from
    * no GENERAL door, so driving a session meant writing an MCP client script
    * per question — the same discovery failure `eval-surface.ts`'s header
    * records, in a lane that had not noticed it yet.
@@ -190,7 +190,7 @@ export class LiveEditor {
 
   /**
    * Photograph the editor PAGE — every panel, tab strip and viewport as the
-   * person sees it. `vgai screenshot editor` is this verb from the shell. The
+   * person sees it. the editor's `screenshot editor` command is this verb from the shell. The
    * one door for judging chrome sighted: a skin, a workspace arrangement or a
    * contributed panel is looked at through this, never guessed at from DOM
    * probes. The page at its own layout, `scale` output pixels per CSS pixel
@@ -202,7 +202,7 @@ export class LiveEditor {
     return this.#client.captureEditorChrome(options);
   }
 
-  /** `'all'` -> `EditorClient.selectAll()` (mirrors `vgai select --all`); otherwise `EditorClient.select(id)` (mirrors `vgai select <entityId>`). */
+  /** `'all'` -> `EditorClient.selectAll()` (mirrors `volter select --all`); otherwise `EditorClient.select(id)` (mirrors `volter select <entityId>`). */
   async select(id: string | 'all'): Promise<void> {
     if (id === 'all') {
       await this.#client.selectAll();
@@ -211,12 +211,12 @@ export class LiveEditor {
     await this.#client.select(id);
   }
 
-  /** Mirrors `vgai deselect`. */
+  /** Mirrors `volter deselect`. */
   async deselect(): Promise<void> {
     await this.#client.select(null);
   }
 
-  /** No `id` -> focus the current selection (mirrors bare `vgai focus`); `id` given -> focus that entity. */
+  /** No `id` -> focus the current selection (mirrors bare `volter focus`); `id` given -> focus that entity. */
   async focus(id?: string): Promise<void> {
     if (id !== undefined) {
       await this.#client.focusEntity(id);
@@ -508,19 +508,19 @@ export class LiveEditor {
    * of one table is a second name for one thing, and an agent reading
    * `--list` had to choose between them with nothing to choose on. This door
    * stays because it is strictly wider: it addresses a COMMAND ID, so under
-   * the frame it reaches everything the workbench knows — a `vgai.action.<id>`
+   * the frame it reaches everything the workbench knows — a `volter.action.<id>`
    * editor action, one of VS Code's own — and not only a view. A VIEW is
    * reached by spelling its verb's command id:
    *
-   *     await editor.command('vgai.blender-uv-view.state')
-   *     await editor.command('vgai.blender-uv-view.zoom', { to: 600 })
+   *     await editor.command('volter.blender-uv-view.state')
+   *     await editor.command('volter.blender-uv-view.zoom', { to: 600 })
    *
-   *     await editor.command('vgai.blender-node-view.view-all')
-   *     await editor.command('vgai.blender-node-view.look', { node: 'Principled BSDF' })
+   *     await editor.command('volter.blender-node-view.view-all')
+   *     await editor.command('volter.blender-node-view.look', { node: 'Principled BSDF' })
    *
    * Under the Code-OSS frame this is the workbench's own command service, so
-   * any command id works — ours and VS Code's alike. Standalone `vgai edit`
-   * has no command service and answers the `vgai.<view>.<verb>` shape off the
+   * any command id works — ours and VS Code's alike. Standalone the editor's `edit` command
+   * has no command service and answers the `volter.<view>.<verb>` shape off the
    * SAME verb table the frame's commands call, refusing any other id by name.
    * One table, two doors, exactly like the keymap's.
    *
@@ -674,7 +674,7 @@ export class LiveEditor {
     await this.#client.reloadPage();
   }
 
-  /** Mirrors `vgai status` — the full live editor state as JSON. */
+  /** Mirrors the editor's `status` command — the full live editor state as JSON. */
   async status(): Promise<EditorState> {
     return this.#client.getState();
   }

package/src/session.ts

@@ -33,7 +33,7 @@ export type SessionListingTransport = SessionDiscoveryTransport;
 export interface ResolvedSession {
   /** Editor dev-server port the resolved session is listening on. */
   port: number;
-  /** Absolute project root — the nearest ancestor of the requested directory containing `vgai.project.json`. */
+  /** Absolute project root — the nearest ancestor of the requested directory containing `volter.project.json`. */
   projectRoot: string;
 }
 
@@ -42,7 +42,7 @@ export interface SessionResolutionDeps {
   transport?: SessionListingTransport;
   /** Project-root discovery — defaults to the real fs walk (`findProjectRootFrom` above). Overridable for tests. */
   findProjectRootFrom?: (dir: string) => string | null;
-  /** Project-local session hint reader. Defaults to `.vgai/session.json`. */
+  /** Project-local session hint reader. Defaults to `.volter/session.json`. */
   readProjectSession?: (projectRoot: string) => ProjectSessionHint | null;
   /** Exact-session verifier. Defaults to GET /__editor/project + canonical project matching. */
   verifyProjectSession?: (hint: ProjectSessionHint, projectRoot: string) => Promise<boolean>;
@@ -66,7 +66,7 @@ function canonicalPath(path: string): string {
 function readProjectSession(projectRoot: string): ProjectSessionHint | null {
   try {
     const value: unknown = JSON.parse(
-      readFileSync(join(projectRoot, '.vgai', 'session.json'), 'utf8'),
+      readFileSync(join(projectRoot, '.volter', 'session.json'), 'utf8'),
     );
     if (typeof value !== 'object' || value === null) return null;
     const hint = value as Record<string, unknown>;
@@ -133,7 +133,7 @@ async function probeServedProject(
  */
 function manifestRefusal(projectRoot: string, manifestError: string): Error {
   return new Error(
-    `@volter/editor-live: the editor session for ${projectRoot} is live, but its vgai.project.json does ` +
+    `@volter/editor-live: the editor session for ${projectRoot} is live, but its volter.project.json does ` +
       'not load, so there is no editor or game to drive — the editor page is showing this same ' +
       `error. Fix the manifest and retry; the session recovers on save, no restart needed.\n${manifestError}`,
   );
@@ -141,15 +141,15 @@ function manifestRefusal(projectRoot: string, manifestError: string): Error {
 
 /**
  * Resolve `projectDir` (default `process.cwd()`) to the port of its already-
- * running `vgai edit` session. Throws a descriptive error (never hangs
+ * running the editor's `edit` command session. Throws a descriptive error (never hangs
  * indefinitely — bounded by `EDITOR_SESSION_DISCOVERY_TIMEOUT_MS`, and never
  * silently attaches to an unrelated project's session — see the module doc
- * above) when no vgai.project.json is found, or no live session covers it.
+ * above) when no volter.project.json is found, or no live session covers it.
  */
 /**
  * THE REFUSAL WHEN NOTHING MATCHED — and it says WHICH nothing.
  *
- * "No live editor session found … run `vgai edit`" used to be the answer to
+ * "No live editor session found … run the editor's `edit` command" used to be the answer to
  * four different states, only one of which it described. The other three sent
  * the operator to start an editor that was already running:
  *
@@ -212,7 +212,7 @@ export async function resolveSession(
   const projectRoot = findRoot(projectDir);
   if (projectRoot === null) {
     throw new Error(
-      `@volter/editor-live: no vgai.project.json found in ${projectDir} or any parent directory — is this a project?`,
+      `@volter/editor-live: no volter.project.json found in ${projectDir} or any parent directory — is this a project?`,
     );
   }
 
@@ -243,7 +243,7 @@ export async function resolveSession(
   let sessions: EditorSessionInfo[];
   // A FAILED discovery is not an empty one. Collapsing the two into `[]` is
   // what made this door answer "no live editor session found" — and prescribe
-  // `vgai edit` — for a probe that merely timed out under load, sending the
+  // the editor's `edit` command — for a probe that merely timed out under load, sending the
   // operator to start an editor that was already running while the real defect
   // went unnamed. The same collapse the manifest refusal above was added for.
   let discoveryFailure: string | null = null;

package/src/tools.ts

@@ -15,7 +15,7 @@ export class LiveTools {
     this.#client = client;
   }
 
-  /** Enumerate the exact `package.json#vgai.tools` catalog without executing it. */
+  /** Enumerate the exact `package.json#volter.tools` catalog without executing it. */
   async list(): Promise<ProjectToolCatalog> {
     return this.#client.listProjectTools();
   }