@higgsfield/video-editor-mcp 1.0.4 → 1.0.6

package/dist/server.mjs

@@ -41515,6 +41515,39 @@ function registerAppResource(server, name, uri, config2, readCallback) {
   );
 }
 
+// src/tools/video-editor-local/auth.ts
+var AUTH_DEADLINE_MS = 4 * 6e4;
+var ERROR_MESSAGE = "Could not connect to Higgsfield. Complete browser sign-in, then try again.";
+var profileSchema = external_exports.object({ id: external_exports.string().regex(/\S/) });
+function createEditorAuth(readProfile) {
+  let state = { status: "idle" };
+  let pending;
+  return {
+    status: () => state,
+    start() {
+      if (pending) return state;
+      state = { status: "pending" };
+      const controller = new AbortController();
+      const timer = setTimeout(() => {
+        state = { status: "error", message: ERROR_MESSAGE };
+        controller.abort();
+      }, AUTH_DEADLINE_MS);
+      timer.unref();
+      pending = Promise.resolve().then(() => readProfile(controller.signal)).then((result) => {
+        if (controller.signal.aborted) return;
+        if (result.isError) throw new Error("Identity lookup failed");
+        state = { status: "ready", profile: profileSchema.parse(result.structuredContent) };
+      }).catch(() => {
+        if (!controller.signal.aborted) state = { status: "error", message: ERROR_MESSAGE };
+      }).finally(() => {
+        clearTimeout(timer);
+        pending = void 0;
+      });
+      return state;
+    }
+  };
+}
+
 // src/tools/video-editor-local/hosted-proxy.ts
 var HOSTED_MCP_URL = "https://openai-mcp.higgsfield.ai/mcp";
 var HOSTED_PANEL_TOOLS = [
@@ -41572,7 +41605,7 @@ function registerHostedProxyTools(server, url2, session = new LocalBrowserSessio
     const previous = connected?.client;
     const next = new Client({
       name: "higgsfield-video-editor-local",
-      version: "1.0.4"
+      version: "1.0.6"
     });
     const transport = new StreamableHTTPClientTransport(new URL(url2), {
       requestInit: { headers: { Authorization: `Bearer ${token}` } }
@@ -41587,6 +41620,43 @@ function registerHostedProxyTools(server, url2, session = new LocalBrowserSessio
       }), 6e4).unref();
     return pending;
   }
+  const identity2 = createEditorAuth(async (signal) => {
+    const token = await session.token();
+    signal.throwIfAborted();
+    const next = new Client({ name: "higgsfield-video-editor-identity", version: "1" });
+    const transport = new StreamableHTTPClientTransport(new URL(url2), {
+      requestInit: { headers: { Authorization: `Bearer ${token}` } }
+    });
+    const abort = () => {
+      void next.close().catch(() => void 0);
+    };
+    signal.addEventListener("abort", abort, { once: true });
+    try {
+      await next.connect(transport, { signal, timeout: 3e4 });
+      return await next.callTool({ name: "get_profile", arguments: {} }, void 0, {
+        signal,
+        timeout: 3e4
+      });
+    } finally {
+      signal.removeEventListener("abort", abort);
+      await next.close().catch(() => void 0);
+    }
+  });
+  registerAppTool(
+    server,
+    "video_editing_auth",
+    {
+      title: "Connect the local video editor",
+      description: "Start or inspect the local editor's Higgsfield sign-in without waiting for the browser.",
+      inputSchema: external_exports.strictObject({ action: external_exports.enum(["start", "status"]) }),
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+      _meta: { ui: { visibility: ["app"] } }
+    },
+    async ({ action }) => {
+      const state = action === "start" ? identity2.start() : identity2.status();
+      return { content: [], structuredContent: state };
+    }
+  );
   for (const name of HOSTED_PANEL_TOOLS)
     registerAppTool(
       server,
@@ -41805,12 +41875,15 @@ function parseCliJson(result) {
     throw new Error(
       (result.stderr || result.stdout).trim().slice(-4e3) || `higgsedit exited ${result.code}`
     );
-  const text = result.stdout.trim();
+  let value;
   try {
-    return JSON.parse(text);
+    value = JSON.parse(result.stdout);
   } catch {
-    return text.slice(-2e4);
+    throw new Error("higgsedit returned invalid or incomplete JSON.");
   }
+  if (value === null || typeof value !== "object" || Array.isArray(value))
+    throw new Error("higgsedit returned an unexpected JSON response; expected an object.");
+  return value;
 }
 var cliJson = async (args, cwd, timeoutMs) => parseCliJson(await runCli(args, cwd, timeoutMs));
 
@@ -41823,8 +41896,8 @@ var directCspOrigins = () => cspOrigins;
 var CORS = {
   "access-control-allow-origin": "*",
   "access-control-allow-methods": "GET, HEAD, POST, PUT, DELETE, OPTIONS",
-  "access-control-allow-headers": "range, content-type",
-  "access-control-expose-headers": "content-range, content-length, accept-ranges, content-type",
+  "access-control-allow-headers": "range, content-type, if-none-match, if-modified-since, if-range",
+  "access-control-expose-headers": "content-range, content-length, accept-ranges, content-type, etag, last-modified, cache-control",
   // An https page reaching loopback (Private Network Access / Local Network Access preflights).
   "access-control-allow-private-network": "true",
   "cross-origin-resource-policy": "cross-origin",
@@ -41836,7 +41909,8 @@ var FORWARDED = [
   "content-length",
   "accept",
   "if-none-match",
-  "if-modified-since"
+  "if-modified-since",
+  "if-range"
 ];
 var DirectServer = class {
   constructor(origin, ports = DIRECT_PORTS) {
@@ -42175,7 +42249,7 @@ var restyleStyleSchema = external_exports.object({
 });
 
 // src/tools/video-editor-local/standalone-resource.ts
-var packageVersion = "1.0.4";
+var packageVersion = "1.0.6";
 var VIDEO_EDITOR_RESOURCE_URI = packageVersion ? `ui://higgsfield/video-editor-v3-${encodeURIComponent(packageVersion)}.html` : "ui://higgsfield/video-editor-v3.html";
 function panelHtmlPath(env = process.env) {
   return env.VIDEO_EDITOR_LOCAL_HTML?.trim() || join5(import.meta.dirname, "index.html");
@@ -42226,10 +42300,48 @@ import { mkdtemp, rm as rm3, writeFile as writeFile4 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join as join6 } from "node:path";
 var MAX_CHUNK = 2 << 20;
-var KEPT_HEADERS = ["content-type", "content-range", "content-length", "accept-ranges"];
+var KEPT_HEADERS = [
+  "content-type",
+  "content-range",
+  "content-length",
+  "accept-ranges",
+  "etag",
+  "last-modified",
+  "cache-control"
+];
+var CONDITIONAL_HEADERS = ["if-none-match", "if-modified-since", "if-range"];
+async function readReply(res, method) {
+  if (method === "HEAD" || res.status === 304 || res.status === 204) return Buffer.alloc(0);
+  if (Number(res.headers.get("content-length")) > MAX_CHUNK) {
+    await res.body?.cancel();
+    throw new Error("response exceeds the tool chunk limit; ask for a range");
+  }
+  const reader = res.body?.getReader();
+  if (!reader) return Buffer.alloc(0);
+  const chunks = [];
+  let size = 0;
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) return Buffer.concat(chunks, size);
+      size += value.byteLength;
+      if (size > MAX_CHUNK) {
+        await reader.cancel();
+        throw new Error("response exceeds the tool chunk limit; ask for a range");
+      }
+      chunks.push(value);
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
 async function httpTool(origin, call) {
   checkPath(call.path);
   const headers = new Headers();
+  for (const name of CONDITIONAL_HEADERS) {
+    const value = call.headers?.[name];
+    if (value !== void 0) headers.set(name, value);
+  }
   if (call.rangeStart !== void 0) {
     const end = Math.min(call.rangeEnd ?? Infinity, call.rangeStart + MAX_CHUNK - 1);
     headers.set("range", `bytes=${call.rangeStart}-${end}`);
@@ -42252,9 +42364,7 @@ async function send(origin, method, path2, headers, body, signal) {
     await res.body?.cancel();
     throw new Error(STREAMING_IMPORT_REQUIRED);
   }
-  const bytes = Buffer.from(await res.arrayBuffer());
-  if (bytes.length > MAX_CHUNK && res.status !== 206)
-    throw new Error(`${path2}: ${bytes.length} bytes without a range; ask for a range`);
+  const bytes = await readReply(res, method);
   const kept = {};
   for (const name of KEPT_HEADERS) {
     const value = res.headers.get(name);
@@ -42375,7 +42485,6 @@ var reload = (undo) => ({
   detectedAt: Date.now(),
   undo
 });
-var NO_UNDO = { canUndo: false, canRedo: false, undoName: null, redoName: null };
 var EventFeed = class {
   constructor(origin) {
     this.origin = origin;
@@ -42424,14 +42533,14 @@ var EventFeed = class {
   holds(after) {
     return after >= (this.log[0]?.seq ?? this.seq + 1) - 1 && after <= this.seq;
   }
-  /** Events after `after`; waits up to `waitMs` for one. `after < 0` returns the current position at once. */
+  /** Events after `after`; a new reader gets one full resync with current undo, not historical edits. */
   async next(after, waitMs) {
-    if (after >= 0 && !this.holds(after)) {
-      const undo = await fetch(`${this.origin}/api/history`).then(
-        (r) => r.json(),
-        () => NO_UNDO
-      );
-      return { seq: this.seq, events: [reload(undo)] };
+    if (after < 0 || !this.holds(after)) {
+      const seq = this.seq;
+      const response = await fetch(`${this.origin}/api/history`, { signal: this.abort.signal });
+      if (!response.ok) throw new Error(`history: ${response.status}`);
+      const undo = await response.json();
+      return { seq, events: [reload(undo)] };
     }
     if (after >= 0 && after >= this.seq) {
       await new Promise((resolve3) => {
@@ -43005,7 +43114,7 @@ async function initProject(path2, roots, size = "1080x1920", fps = 30) {
   if (await hasProjectFile(dir)) return dir;
   cliPath();
   await mkdir5(dir, { recursive: true });
-  await cliJson(["init", dir, `--size=${size}`, `--fps=${fps}`], dir);
+  await cliJson(["init", dir, `--size=${size}`, `--fps=${fps}`, "--json"], dir);
   return dir;
 }
 async function newFile(dir, name, place) {
@@ -43218,7 +43327,7 @@ ${LOCAL_PROJECT_GUIDE}`);
       annotations: { readOnlyHint: true, openWorldHint: false }
     },
     async ({ project }) => scoped(project, async (session) => {
-      const outline = await cliJson(["outline", ".", "--json"], session.root);
+      const outline = external_exports.looseObject({ text: external_exports.string().optional() }).parse(await cliJson(["outline", ".", "--json"], session.root));
       const { text, ...rest } = outline;
       return reply({ ...describe3(session), ...rest }, text ?? JSON.stringify(rest));
     })
@@ -43374,6 +43483,7 @@ ${LOCAL_PROJECT_GUIDE}`);
           [
             "sheet",
             ".",
+            "--json",
             `--times=${times.join(",")}`,
             "-o",
             out,
@@ -43722,6 +43832,11 @@ function registerPanelRelay(server, store, stateDirectory, direct) {
         path: external_exports.string().min(1).max(4096),
         rangeStart: external_exports.number().int().nonnegative().optional(),
         rangeEnd: external_exports.number().int().nonnegative().optional(),
+        headers: external_exports.object({
+          "if-none-match": external_exports.string().max(8192).optional(),
+          "if-modified-since": external_exports.string().max(128).optional(),
+          "if-range": external_exports.string().max(128).optional()
+        }).optional(),
         body: external_exports.string().max(64 * 1024 * 1024).optional(),
         project: sessionArg
       },
@@ -44515,7 +44630,7 @@ function createEditorUpdates(options, start = (done) => new Promise((resolve3, r
       }
     }
     return {
-      runningVersion: options?.version ?? "1.0.4" ?? "Source checkout",
+      runningVersion: options?.version ?? "1.0.6" ?? "Source checkout",
       readyVersion: options && selectedDist(options) !== options.dist ? state.active : null,
       channel: options?.channel ?? null,
       supported: options !== null,
@@ -44579,7 +44694,7 @@ var handle = serveStdio(
     const server = new McpServer(
       {
         name: "Higgsfield Video Editor (local)",
-        version: "1.0.4"
+        version: "1.0.6"
       },
       { instructions: VIDEO_EDITOR_LOCAL_INSTRUCTIONS }
     );

package/node_modules/@higgsfield/higgsedit/dist/chunk-C6SASQHE.mjs

@@ -17,7 +17,7 @@ import {
 } from "./chunk-QLPCYN6K.mjs";
 import {
   analyze,
-  applyEdit
+  applyEdits
 } from "./chunk-VI6IV6JP.mjs";
 import {
   inside,
@@ -94,73 +94,7 @@ var WIDGET_DIST = join(EDITOR, "dist-mcp");
 var WIDGET = join(WIDGET_DIST, "mcp-app.js");
 
 // src/history.ts
-import { readFileSync as readFileSync2, renameSync, writeFileSync } from "node:fs";
-import { join as join2 } from "node:path";
-var EditHistory = class {
-  constructor(dir, onWrite) {
-    this.dir = dir;
-    this.onWrite = onWrite;
-  }
-  dir;
-  onWrite;
-  undoStack = [];
-  redoStack = [];
-  begin(name) {
-    const entry = { name, files: /* @__PURE__ */ new Map() };
-    return {
-      onWrite: (path, text) => {
-        const prior = entry.files.get(path);
-        entry.files.set(path, { before: prior?.before ?? readFileSync2(join2(this.dir, path), "utf8"), after: text });
-        this.onWrite?.(path, text);
-      },
-      commit: () => {
-        if (!entry.files.size) return;
-        this.undoStack.push(entry);
-        this.redoStack.length = 0;
-      },
-      rollback: () => {
-        for (const [path, texts] of entry.files) this.write(path, texts.before);
-      }
-    };
-  }
-  state() {
-    return {
-      canUndo: this.undoStack.length > 0,
-      canRedo: this.redoStack.length > 0,
-      undoName: this.undoStack.at(-1)?.name ?? null,
-      redoName: this.redoStack.at(-1)?.name ?? null
-    };
-  }
-  undo() {
-    return this.step(this.undoStack, this.redoStack, "after", "before");
-  }
-  redo() {
-    return this.step(this.redoStack, this.undoStack, "before", "after");
-  }
-  step(from, to, expect, write) {
-    const entry = from.at(-1);
-    if (!entry) return { ok: false, reason: `nothing to ${write === "before" ? "undo" : "redo"}` };
-    for (const [path, texts] of entry.files) {
-      let current;
-      try {
-        current = readFileSync2(join2(this.dir, path), "utf8");
-      } catch {
-        return { ok: false, reason: `${path} no longer exists` };
-      }
-      if (current !== texts[expect]) return { ok: false, reason: `${path} changed outside the editor since ${entry.name}` };
-    }
-    for (const [path, texts] of entry.files) this.write(path, texts[write]);
-    from.pop();
-    to.push(entry);
-    return { ok: true, written: [...entry.files.keys()] };
-  }
-  write(path, text) {
-    const target = join2(this.dir, path);
-    this.onWrite?.(path, text);
-    writeFileSync(`${target}.higgsedit-${process.pid}.tmp`, text);
-    renameSync(`${target}.higgsedit-${process.pid}.tmp`, target);
-  }
-};
+import { EditHistory } from "./history.mjs";
 
 import { Proxies } from "./proxy.mjs";
 
@@ -300,15 +234,15 @@ async function startDev(dir, port = 0, options = {}) {
         if (url.pathname !== "/api/edit" || req.method !== "POST") return false;
         const body = JSON.parse((await readBody(req)).toString());
         const tx = history.begin(body.name ?? "Edit");
-        const results = [];
-        for (const { key, edit } of body.edits) {
-          const r = applyEdit(dir, key, edit, { onWrite: tx.onWrite, ...body.dryRun ? { dryRun: true } : {} });
-          results.push(r);
-          if (!r.ok) break;
+        try {
+          const results = applyEdits(dir, body.edits, { onWrite: tx.onWrite, ...body.dryRun ? { dryRun: true } : {} });
+          if (results.every((r) => r.ok)) tx.commit();
+          else tx.rollback();
+          json(res, 200, { ok: results.every((r) => r.ok), results, undo: history.state() });
+        } catch (error) {
+          tx.rollback();
+          throw error;
         }
-        if (results.every((r) => r.ok)) tx.commit();
-        else tx.rollback();
-        json(res, 200, { ok: results.every((r) => r.ok), results, undo: history.state() });
         return true;
       },
       (req, res, url) => {

package/node_modules/@higgsfield/higgsedit/dist/chunk-QLPCYN6K.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createHash } from "node:crypto";
 import { createRequire as __higgseditRequire } from "node:module";
 import { fileURLToPath as __higgseditPath } from "node:url";
 const require = __higgseditRequire(import.meta.url);
@@ -131,10 +132,14 @@ var TYPES = {
 };
 function sendFile(req, res, file) {
   let size;
+  let etag;
+  let modified;
   try {
-    const st = statSync(file);
+    const st = statSync(file, { bigint: true });
     if (!st.isFile()) throw new Error("not a file");
-    size = st.size;
+    size = Number(st.size);
+    etag = `"${createHash("sha256").update(`${st.dev}:${st.ino}:${st.size}:${st.mtimeNs}:${st.ctimeNs}`).digest("hex")}"`;
+    modified = Math.floor(Number(st.mtimeNs > st.ctimeNs ? st.mtimeNs : st.ctimeNs) / 1e9) * 1e3;
   } catch {
     res.statusCode = 404;
     res.end("not found");
@@ -143,11 +148,23 @@ function sendFile(req, res, file) {
   res.setHeader("content-type", TYPES[extname(file).toLowerCase()] ?? "application/octet-stream");
   res.setHeader("accept-ranges", "bytes");
   res.setHeader("cache-control", "no-cache");
-  const range = /^bytes=(\d*)-(\d*)$/.exec(req.headers.range ?? "");
+  res.setHeader("etag", etag);
+  res.setHeader("last-modified", new Date(modified).toUTCString());
+  const readable = req.method === "GET" || req.method === "HEAD";
+  const noneMatch = req.headers["if-none-match"];
+  const unmodified = noneMatch !== void 0 ? noneMatch.split(",").some((value) => value.trim() === "*" || value.trim().replace(/^W\//, "") === etag) : Date.parse(req.headers["if-modified-since"] ?? "") >= modified;
+  if (readable && unmodified) {
+    res.statusCode = 304;
+    res.end();
+    return;
+  }
+  const ifRange = req.headers["if-range"];
+  const sameRange = !ifRange || ifRange === etag || modified <= Date.now() - 6e4 && typeof ifRange === "string" && Date.parse(ifRange) === modified;
+  const range = req.method === "GET" && sameRange ? /^bytes=(\d*)-(\d*)$/.exec(req.headers.range ?? "") : null;
   if (range) {
-    const start = range[1] ? Number(range[1]) : size - Number(range[2]);
+    const start = range[1] ? Number(range[1]) : Math.max(0, size - Number(range[2]));
     const end = range[1] && range[2] ? Math.min(Number(range[2]), size - 1) : size - 1;
-    if (start > end || start >= size) {
+    if (!range[1] && !Number(range[2]) || !Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start > end || start >= size) {
       res.statusCode = 416;
       res.setHeader("content-range", `bytes */${size}`);
       res.end();

package/node_modules/@higgsfield/higgsedit/dist/chunk-VI6IV6JP.mjs

@@ -242191,7 +242191,7 @@ function literalAt(root, path, at) {
   }
   return node;
 }
-function setProp(project, landed, scope, name, value) {
+function setProp(project, landed, scope, name, value, validateOnly = false) {
   const { tag } = landed;
   const at = line(tag);
   const [prop, ...path] = name.split(".");
@@ -242210,18 +242210,18 @@ function setProp(project, landed, scope, name, value) {
     if (ctx.component && ctx.component.callSites.length > 1) {
       refuse("shared-component", `<${tagName(tag)}> is inside <${ctx.component.name}>, used at ${ctx.component.callSites.length} call sites; pass ${prop} as a prop to edit one instance`, tag);
     }
-    addAttribute(tag, prop, initializerText(value));
+    if (!validateOnly) addAttribute(tag, prop, initializerText(value));
     return at;
   }
   const init = attr.getInitializer();
   if (!init) {
     if (path.length) refuse("invalid", `${prop} is a bare boolean`, tag);
     if (remove) {
-      attr.remove();
+      if (!validateOnly) attr.remove();
       return at;
     }
     if (value === true) return at;
-    attr.setInitializer(initializerText(value));
+    if (!validateOnly) attr.setInitializer(initializerText(value));
     return at;
   }
   const expr = init.isKind(import_ts_morph3.SyntaxKind.JsxExpression) ? init.getExpression() : init;
@@ -242230,12 +242230,13 @@ function setProp(project, landed, scope, name, value) {
     if (ctx.component && ctx.component.callSites.length > 1) {
       refuse("shared-component", `${prop} is a literal inside <${ctx.component.name}>, which has ${ctx.component.callSites.length} call sites; pass it as a prop to edit one instance`, attr, attr.getText());
     }
-    if (remove) attr.remove();
-    else if (path.length) {
+    if (remove) {
+      if (!validateOnly) attr.remove();
+    } else if (path.length) {
       const node = literalAt(expr, path, attr);
-      node.replaceWithText(literalText(value));
+      if (!validateOnly) node.replaceWithText(literalText(value));
     } else {
-      attr.setInitializer(initializerText(value));
+      if (!validateOnly) attr.setInitializer(initializerText(value));
     }
     return at;
   }
@@ -242244,7 +242245,7 @@ function setProp(project, landed, scope, name, value) {
   const forwarded = forwardedProp(expr, ctx);
   if (forwarded) {
     const site = callSiteFor(ctx, scope, attr);
-    return setProp(project, site, site.scope, [forwarded, ...path].join("."), value);
+    return setProp(project, site, site.scope, [forwarded, ...path].join("."), value, validateOnly);
   }
   return refuse("expression", `code-driven: ${prop} is bound to an expression`, attr, attr.getText());
 }
@@ -242262,13 +242263,14 @@ function saidRange(child) {
   return [child.getPos() + lead, child.getEnd() - trail];
 }
 var jsxText = (text) => /^[^\s{}<>&][^\n{}<>&]*[^\s{}<>&]$|^[^\s{}<>&]$/.test(text) ? text : `{${JSON.stringify(text)}}`;
-function setText(project, landed, scope, text) {
+function setText(project, landed, scope, text, validateOnly = false) {
   const { tag } = landed;
   const at = line(tag);
   const element = elementOf(tag);
   const sf = tag.getSourceFile();
   if (element.isKind(import_ts_morph3.SyntaxKind.JsxSelfClosingElement)) {
     if (tagName(tag) !== "text") refuse("invalid", `<${tagName(tag)}> has no text`, tag);
+    if (validateOnly) return at;
     const opening = element.getText().replace(/\s*\/>$/, ">");
     sf.replaceText([element.getStart(), element.getEnd()], `${opening}${jsxText(text)}</${tagName(tag)}>`);
     return at;
@@ -242279,7 +242281,7 @@ function setText(project, landed, scope, text) {
   if (expressions.length) {
     const e = expressions[0].asKindOrThrow(import_ts_morph3.SyntaxKind.JsxExpression).getExpressionOrThrow();
     if (isLiteral(e) && said.length === 1) {
-      e.replaceWithText(literalText(text));
+      if (!validateOnly) e.replaceWithText(literalText(text));
       return at;
     }
     const loopVar = ctx.inLoop ? mentions(e, ctx.loopNames) : void 0;
@@ -242287,14 +242289,15 @@ function setText(project, landed, scope, text) {
     const forwarded = said.length === 1 ? forwardedProp(e, ctx) : void 0;
     if (forwarded) {
       const site = callSiteFor(ctx, scope, e);
-      if (forwarded === "children") return setText(project, site, site.scope, text);
-      return setProp(project, site, site.scope, forwarded, text);
+      if (forwarded === "children") return setText(project, site, site.scope, text, validateOnly);
+      return setProp(project, site, site.scope, forwarded, text, validateOnly);
     }
     refuse("expression", `code-driven: the text is computed by {${e.getText()}}`, e, e.getText());
   }
   if (ctx.component && ctx.component.callSites.length > 1) {
     refuse("shared-component", `this text is inside <${ctx.component.name}>, used at ${ctx.component.callSites.length} call sites`, tag);
   }
+  if (validateOnly) return at;
   if (!said.length) {
     sf.insertText(element.getOpeningElement().getEnd(), jsxText(text));
     return at;
@@ -242407,7 +242410,22 @@ function finish(project, target, newId, options) {
   return { ok: true, written, target: target(), ...newId ? { id: newId } : {} };
 }
 function applyEdit(dir, key, edit, options = {}) {
+  return applyProjectEdit(new SourceProject(dir), key, edit, options);
+}
+function applyEdits(dir, edits, options = {}) {
   const project = new SourceProject(dir);
+  const results = [];
+  for (const { key, edit } of edits) {
+    const before = new Map([...project.files].map(([path, file]) => [path, file.sourceFile.getFullText()]));
+    const result = applyProjectEdit(project, key, edit, { dryRun: true });
+    if (result.ok) result.written = [...project.files].filter(([path, file]) => file.sourceFile.getFullText() !== before.get(path)).map(([path]) => path);
+    results.push(result);
+    if (!result.ok) return results;
+  }
+  if (!options.dryRun) project.save(options.onWrite);
+  return results;
+}
+function applyProjectEdit(project, key, edit, options) {
   try {
     if (edit.op === "set-const") {
       const landed2 = setConst(project, edit);
@@ -242521,11 +242539,9 @@ function describeProp(project, found, scope, name) {
   const init = attr?.getInitializer();
   const expr = init?.isKind(import_ts_morph3.SyntaxKind.JsxExpression) ? init.getExpression() : init;
   const source = attr?.getText();
-  const probe = new SourceProject(project.dir, [...project.files.keys()]);
   try {
-    const target = findById(probe, idOf(found.tag));
-    const origin = line(target.tag);
-    const landed = setProp(probe, target, scope, name, 0);
+    const origin = line(found.tag);
+    const landed = setProp(project, found, scope, name, 0, true);
     const followed = landed.file !== origin.file || landed.line !== origin.line;
     if (!attr) return { name, kind: "absent", editable: true };
     if (followed && landed.id) {
@@ -242549,12 +242565,11 @@ var forwardedName = (expr) => {
   return void 0;
 };
 function describeText(project, found, scope) {
-  const probe = new SourceProject(project.dir, [...project.files.keys()]);
   const element = elementOf(found.tag);
   const said = element.isKind(import_ts_morph3.SyntaxKind.JsxElement) ? element.getJsxChildren().filter(isSaid) : [];
   const source = said.map((c) => c.getText()).join("").trim();
   try {
-    setText(probe, findById(probe, idOf(found.tag)), scope, "x");
+    setText(project, found, scope, "x", true);
     const literal = said.length === 1 && said[0].isKind(import_ts_morph3.SyntaxKind.JsxText);
     return { name: "text", kind: literal || !said.length ? "literal" : "call-site", editable: true, ...source ? { source } : {} };
   } catch (error) {
@@ -242573,6 +242588,7 @@ export {
   stampProject,
   parseKey,
   applyEdit,
+  applyEdits,
   analyze,
   sourceFacts
 };