doc-detective 4.29.1 → 4.31.0

package/dist/index.cjs

@@ -631871,10 +631871,13 @@ function getRandomUUID() {
 function cloneForValidation(object) {
   return JSON.parse(JSON.stringify(object));
 }
+function snapshotErrors(errors) {
+  return errors.map((error) => ({ ...error }));
+}
 function escapeRegExp(string) {
   return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function validate({ schemaKey, object, addDefaults = true }) {
+function validate({ schemaKey, object, addDefaults = true, structuredErrors = false }) {
   if (!schemaKey) {
     throw new Error("Schema key is required.");
   }
@@ -631886,6 +631889,9 @@ function validate({ schemaKey, object, addDefaults = true }) {
     errors: "",
     object
   };
+  if (structuredErrors) {
+    result.errorObjects = [];
+  }
   let validationObject;
   let check = ajv.getSchema(schemaKey);
   if (!check) {
@@ -631902,6 +631908,9 @@ function validate({ schemaKey, object, addDefaults = true }) {
     const compatibleSchemasList = compatibleSchemas[schemaKey];
     if (!compatibleSchemasList) {
       result.errors = targetErrors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      if (structuredErrors) {
+        result.errorObjects = snapshotErrors(targetErrors);
+      }
       result.object = object;
       result.valid = false;
       return result;
@@ -631918,6 +631927,9 @@ function validate({ schemaKey, object, addDefaults = true }) {
     }
     if (!matchedSchemaKey) {
       result.errors = targetErrors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      if (structuredErrors) {
+        result.errorObjects = snapshotErrors(targetErrors);
+      }
       result.object = object;
       result.valid = false;
       return result;
@@ -634095,6 +634107,49 @@ function logLevelEnabled(config, level) {
     return true;
   return false;
 }
+function viewportMismatchWarning(requested, actual, tolerance = 0) {
+  const parts = [];
+  for (const dim of ["width", "height"]) {
+    const req = Number(requested?.[dim]);
+    if (!(req > 0))
+      continue;
+    const act = Number(actual?.[dim]);
+    if (!Number.isFinite(act)) {
+      parts.push(`${dim} requested ${req}px, rendered unknown`);
+    } else if (Math.abs(act - req) > tolerance) {
+      parts.push(`${dim} requested ${req}px, rendered ${act}px`);
+    }
+  }
+  if (parts.length === 0)
+    return null;
+  return `Requested viewport not fully realized \u2014 the browser or OS enforces a minimum window size: ${parts.join("; ")}. Screenshots and measurements reflect the rendered size, not the requested size.`;
+}
+function resolveViewportTarget(requested, current) {
+  const w = Number(requested?.width);
+  const h = Number(requested?.height);
+  return {
+    width: w > 0 ? w : Number(current?.width),
+    height: h > 0 ? h : Number(current?.height)
+  };
+}
+async function readViewport(driver) {
+  const v = await driver.execute("return { width: window.innerWidth, height: window.innerHeight }", []);
+  return { width: Number(v?.width), height: Number(v?.height) };
+}
+async function realizeViewport(driver, requested, config = {}, label) {
+  const current = await readViewport(driver);
+  const target = resolveViewportTarget(requested, current);
+  const windowSize = await driver.getWindowSize();
+  const deltaWidth = Number.isFinite(current.width) && Number.isFinite(target.width) ? target.width - current.width : 0;
+  const deltaHeight = Number.isFinite(current.height) && Number.isFinite(target.height) ? target.height - current.height : 0;
+  await driver.setWindowSize(Math.round(windowSize.width + deltaWidth), Math.round(windowSize.height + deltaHeight));
+  const actual = await readViewport(driver);
+  const warning = viewportMismatchWarning(requested, actual, VIEWPORT_TOLERANCE_PX);
+  if (warning) {
+    await log(config, "warning", label ? `${label}: ${warning}` : warning);
+  }
+  return actual;
+}
 async function log(config, level, message) {
   if (message === void 0) {
     message = config;
@@ -634429,7 +634484,7 @@ function llevenshteinDistance(s, t) {
   }
   return arr[t.length][s.length];
 }
-var import_node_fs7, import_node_os2, import_node_path5, import_node_crypto2, import_promises, import_node_net, import_axios, import_node_child_process4, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, TRANSIENT_SESSION_ERROR, SESSION_TIMEOUT_ABORT, TRANSIENT_PROCESS_INIT_EXIT_CODES, SETTLE_CEILING_MAX_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS, ENV_VAR_REGEX, posixBashProbe;
+var import_node_fs7, import_node_os2, import_node_path5, import_node_crypto2, import_promises, import_node_net, import_axios, import_node_child_process4, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, TRANSIENT_SESSION_ERROR, SESSION_TIMEOUT_ABORT, TRANSIENT_PROCESS_INIT_EXIT_CODES, SETTLE_CEILING_MAX_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS, VIEWPORT_TOLERANCE_PX, ENV_VAR_REGEX, posixBashProbe;
 var init_utils = __esm({
   "dist/core/utils.js"() {
     "use strict";
@@ -634471,6 +634526,7 @@ var init_utils = __esm({
       maxBodyLength: 50 * 1024 * 1024,
       maxRedirects: 5
     };
+    VIEWPORT_TOLERANCE_PX = 16;
     ENV_VAR_REGEX = /\$[a-zA-Z0-9_]+(?![a-zA-Z0-9_$])/g;
   }
 });
@@ -646372,7 +646428,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         return result;
       } else {
         existFilePath = filePath;
-        filePath = import_node_path17.default.join(dir, `${step.stepId}_${Date.now()}.png`);
       }
     }
   }
@@ -646458,6 +646513,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     await driver.pause(100);
   }
   const recordingActive = !isAppCapture && isRecordingActive(driver);
+  let captureBuffer;
+  let appScratchPath;
   try {
     if (recordingActive) {
       await driver.execute(() => {
@@ -646467,18 +646524,24 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
     }
     if (isAppCapture) {
-      await appWindowScreenshot(appEntry, appWindowTarget, filePath);
+      appScratchPath = import_node_path17.default.join(dir, `.appcapture_${step.stepId || "screenshot"}_${Date.now()}.png`);
+      await appWindowScreenshot(appEntry, appWindowTarget, appScratchPath);
+      captureBuffer = import_node_fs20.default.readFileSync(appScratchPath);
     } else {
-      await captureDriver.saveScreenshot(filePath);
+      const base64 = await captureDriver.takeScreenshot();
+      captureBuffer = Buffer.from(base64, "base64");
     }
   } catch (error) {
     result.status = "FAIL";
     result.description = `Couldn't save screenshot. ${error}`;
-    if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-      import_node_fs20.default.unlinkSync(filePath);
-    }
     return result;
   } finally {
+    if (appScratchPath && import_node_fs20.default.existsSync(appScratchPath)) {
+      try {
+        import_node_fs20.default.unlinkSync(appScratchPath);
+      } catch {
+      }
+    }
     if (recordingActive) {
       try {
         await driver.execute(() => {
@@ -646490,6 +646553,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       }
     }
   }
+  let finalBuffer = captureBuffer;
   if (step.screenshot.crop) {
     let padding = { top: 0, right: 0, bottom: 0, left: 0 };
     if (typeof step.screenshot.crop.padding === "number") {
@@ -646523,35 +646587,53 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     rect.y = Math.round(rect.y);
     rect.width = Math.round(rect.width);
     rect.height = Math.round(rect.height);
-    const imgMeta = await sharp(filePath).metadata();
+    const imgMeta = await sharp(captureBuffer).metadata();
     const clamped = clampCropRect(rect, imgMeta.width, imgMeta.height);
     rect.x = clamped.x;
     rect.y = clamped.y;
     rect.width = clamped.width;
     rect.height = clamped.height;
     log(config, "debug", { padded_rect: rect });
-    const croppedPath = import_node_path17.default.join(dir, `cropped_${step.stepId || Date.now()}.png`);
     try {
-      await sharp(filePath).extract({
+      finalBuffer = await sharp(captureBuffer).extract({
         left: rect.x,
         top: rect.y,
         width: rect.width,
         height: rect.height
-      }).toFile(croppedPath);
-      import_node_fs20.default.renameSync(croppedPath, filePath);
+      }).png().toBuffer();
     } catch (error) {
       result.status = "FAIL";
       result.description = `Couldn't crop image. ${error}`;
-      if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-        import_node_fs20.default.unlinkSync(filePath);
-      }
       return result;
     }
   }
+  try {
+    const savedMeta = await sharp(finalBuffer).metadata();
+    if (savedMeta.width && savedMeta.height) {
+      result.outputs.width = savedMeta.width;
+      result.outputs.height = savedMeta.height;
+    }
+  } catch {
+  }
+  const writeFinalPng = (destination) => {
+    try {
+      import_node_fs20.default.writeFileSync(destination, finalBuffer);
+      return true;
+    } catch (error) {
+      result.status = "FAIL";
+      result.description = `Couldn't save screenshot. ${error}`;
+      return false;
+    }
+  };
+  if (isUrlPath) {
+    if (!writeFinalPng(filePath))
+      return result;
+  }
   if (existFilePath) {
     if (step.screenshot.overwrite == "true" && !isUrlPath) {
+      if (!writeFinalPng(existFilePath))
+        return result;
       result.description += ` Overwrote existing file.`;
-      import_node_fs20.default.renameSync(filePath, existFilePath);
       result.outputs.screenshotPath = existFilePath;
       result.outputs.changed = true;
       if (step.screenshot.sourceIntegration) {
@@ -646565,13 +646647,10 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       let img2;
       try {
         img1 = PNG.sync.read(import_node_fs20.default.readFileSync(existFilePath));
-        img2 = PNG.sync.read(import_node_fs20.default.readFileSync(filePath));
+        img2 = PNG.sync.read(finalBuffer);
       } catch (error) {
         result.status = "FAIL";
         result.description = isUrlPath ? `Couldn't decode PNG for comparison. The URL reference (${redactedUrl}) may not be a valid PNG. ${error}` : `Couldn't decode PNG for comparison. ${error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return result;
       }
       const aspectRatioMatch = aspectRatiosMatch(img1, img2);
@@ -646582,9 +646661,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (!aspectRatioMatch) {
         result.description = `Couldn't compare images. Images have different aspect ratios.`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return await evaluateApplicable();
       }
       if (img1.width !== img2.width || img1.height !== img2.height) {
@@ -646592,14 +646668,12 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         const height2 = Math.min(img1.height, img2.height);
         const img1ResizedBuffer = await sharp(img1.data, {
           raw: { width: img1.width, height: img1.height, channels: 4 }
-        }).resize(width2, height2).png().toBuffer();
+        }).resize(width2, height2).raw().toBuffer();
         const img2ResizedBuffer = await sharp(img2.data, {
           raw: { width: img2.width, height: img2.height, channels: 4 }
-        }).resize(width2, height2).png().toBuffer();
-        const resizedImg1 = PNG.sync.read(img1ResizedBuffer);
-        const resizedImg2 = PNG.sync.read(img2ResizedBuffer);
-        img1.data = resizedImg1.data;
-        img2.data = resizedImg2.data;
+        }).resize(width2, height2).raw().toBuffer();
+        img1.data = img1ResizedBuffer;
+        img2.data = img2ResizedBuffer;
         img1.width = width2;
         img1.height = height2;
       }
@@ -646610,9 +646684,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       } catch (error) {
         result.status = "FAIL";
         result.description = `Couldn't load screenshot comparison dependency (pixelmatch). ${error?.message ?? error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return result;
       }
       const numDiffPixels = pixelmatchFn(img1.data, img2.data, null, width, height, { threshold: 5e-4 });
@@ -646629,7 +646700,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (fractionalDiff > step.screenshot.maxVariation) {
         if (step.screenshot.overwrite == "aboveVariation" && !isUrlPath) {
-          import_node_fs20.default.renameSync(filePath, existFilePath);
+          if (!writeFinalPng(existFilePath))
+            return result;
         }
         result.description += ` The difference between the existing screenshot and new screenshot (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.screenshot.maxVariation}).`;
         if (isUrlPath) {
@@ -646653,14 +646725,13 @@ async function saveScreenshot({ config, step, driver, appSession }) {
           if (step.screenshot.sourceIntegration) {
             result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
           }
-          if (step.screenshot.overwrite != "true") {
-            import_node_fs20.default.unlinkSync(filePath);
-          }
         }
       }
     }
   }
   if (!result.outputs.screenshotPath) {
+    if (!writeFinalPng(filePath))
+      return result;
     result.outputs.screenshotPath = filePath;
     result.outputs.changed = true;
     if (step.screenshot.sourceIntegration) {
@@ -648745,20 +648816,31 @@ async function startSurfaceStep({ config, step, platform, driver, processRegistr
     }
     const vw = Number(d.viewport?.width);
     const vh = Number(d.viewport?.height);
+    let viewportOutput;
     if (vw > 0 || vh > 0) {
+      const requested = {
+        ...vw > 0 ? { width: vw } : {},
+        ...vh > 0 ? { height: vh } : {}
+      };
+      let rendered;
       try {
-        await applyViewport(opened.driver, d.viewport);
+        rendered = await realizeViewport(opened.driver, requested, config, `startSurface "${opened.name}"`);
       } catch (error) {
         return {
           status: "FAIL",
           description: `Opened browser surface "${opened.name}" but couldn't apply the viewport: ${error?.message ?? error}`
         };
       }
+      viewportOutput = { requested, actual: rendered };
     }
     return {
       status: "PASS",
       description: `Opened browser surface "${opened.name}" (${engine}).`,
-      outputs: { name: opened.name, engine }
+      outputs: {
+        name: opened.name,
+        engine,
+        ...viewportOutput ? { viewport: viewportOutput } : {}
+      }
     };
   };
   const runProcessDescriptor = async (d) => {
@@ -648873,13 +648955,6 @@ async function startSurfaceStep({ config, step, platform, driver, processRegistr
     outputs: { surfaces: results }
   };
 }
-async function applyViewport(driver, viewport) {
-  const viewportSize = await driver.execute("return { width: window.innerWidth, height: window.innerHeight }", []);
-  const windowSize = await driver.getWindowSize();
-  const deltaWidth = (viewport.width || viewportSize.width) - viewportSize.width;
-  const deltaHeight = (viewport.height || viewportSize.height) - viewportSize.height;
-  await driver.setWindowSize(windowSize.width + deltaWidth, windowSize.height + deltaHeight);
-}
 
 // dist/core/tests/mobileBrowser.js
 var import_node_path24 = __toESM(require("node:path"), 1);
@@ -650089,6 +650164,10 @@ function getDriverCapabilities({ runnerDetails, name, options }) {
           // 10 minutes
           "appium:executable": chromium.driver,
           browserName: "chrome",
+          // Classic WebDriver, no BiDi socket. Enabling `webSocketUrl` for
+          // viewport emulation (driver.setViewport) crashed headed recording
+          // contexts with a stack overflow and can't be gated off recording
+          // (viewport+recording is a supported combo) — see ADR 01072 (rejected).
           "wdio:enforceWebDriverClassic": true,
           // Disable BiDi, use classic mode
           "goog:chromeOptions": {
@@ -650446,14 +650525,18 @@ function driverSkipDiagnostic({ requestedName, platform, platformMatches, attemp
   msg += ` A present-but-broken driver (for example a partially downloaded ${driverHint}) can cause this; reinstall the driver or its browser.`;
   return msg;
 }
-async function setViewportSize(context, driver) {
-  if (context.browser?.viewport?.width || context.browser?.viewport?.height) {
-    const viewportSize = await driver.execute("return { width: window.innerWidth, height: window.innerHeight }", []);
-    const windowSize = await driver.getWindowSize();
-    const deltaWidth = (context.browser?.viewport?.width || viewportSize.width) - viewportSize.width;
-    const deltaHeight = (context.browser?.viewport?.height || viewportSize.height) - viewportSize.height;
-    await driver.setWindowSize(windowSize.width + deltaWidth, windowSize.height + deltaHeight);
+async function setViewportSize(context, driver, config = {}) {
+  const vw = Number(context.browser?.viewport?.width);
+  const vh = Number(context.browser?.viewport?.height);
+  if (vw > 0 || vh > 0) {
+    const requested = {
+      ...vw > 0 ? { width: vw } : {},
+      ...vh > 0 ? { height: vh } : {}
+    };
+    const label = `viewport for ${context.browser?.name ?? "browser"} on ${context.platform ?? "host"}`;
+    return realizeViewport(driver, requested, config, label);
   }
+  return void 0;
 }
 async function allowUnsafeSteps({ config }) {
   if (config.allowUnsafeSteps === true)
@@ -652172,8 +652255,10 @@ ${JSON.stringify(context, null, 2)}`);
           driver
         });
       }
-      if (context.browser?.viewport?.width || context.browser?.viewport?.height) {
-        await setViewportSize(context, driver);
+      const viewportW = Number(context.browser?.viewport?.width);
+      const viewportH = Number(context.browser?.viewport?.height);
+      if (viewportW > 0 || viewportH > 0) {
+        await setViewportSize(context, driver, config);
       } else if (context.browser?.window?.width || context.browser?.window?.height) {
         const windowSize = await driver.getWindowSize();
         await driver.setWindowSize(context.browser?.window?.width || windowSize.width, context.browser?.window?.height || windowSize.height);

package/dist/lsp/command.d.ts

@@ -0,0 +1,12 @@
+import type { CommandModule } from "yargs";
+export interface LspArgv {
+    stdio: boolean;
+}
+/**
+ * `doc-detective lsp` — start the Doc Detective language server. Registered
+ * lazily in `src/cli.ts`: the handler imports the server (and its
+ * `vscode-languageserver` dependency graph) only when this subcommand runs, so
+ * ordinary `runTests` invocations never pay that import cost.
+ */
+export declare const lspCommand: CommandModule<{}, LspArgv>;
+//# sourceMappingURL=command.d.ts.map

package/dist/lsp/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lsp/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,EAAE,EAAE,OAAO,CAmBjD,CAAC"}

package/dist/lsp/command.js

@@ -0,0 +1,24 @@
+/**
+ * `doc-detective lsp` — start the Doc Detective language server. Registered
+ * lazily in `src/cli.ts`: the handler imports the server (and its
+ * `vscode-languageserver` dependency graph) only when this subcommand runs, so
+ * ordinary `runTests` invocations never pay that import cost.
+ */
+export const lspCommand = {
+    command: "lsp",
+    describe: "Start the Doc Detective language server (LSP) over stdio for editors and AI agents.",
+    builder: (yargs) => yargs.option("stdio", {
+        type: "boolean",
+        default: true,
+        describe: "Communicate over stdio (the only supported transport). Present for explicitness and editor configs.",
+    }),
+    /* c8 ignore start - thin lazy-load + real stdio server start; the server's
+       pure wiring is unit-tested via registerHandlers and end-to-end via the
+       spawned protocol test. */
+    handler: async () => {
+        const { startServer } = await import("./server.js");
+        startServer();
+    },
+    /* c8 ignore stop */
+};
+//# sourceMappingURL=command.js.map

package/dist/lsp/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/lsp/command.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,OAAO,EAAE,KAAK;IACd,QAAQ,EACN,qFAAqF;IACvF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;QACpB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;QACb,QAAQ,EACN,qGAAqG;KACxG,CAA6C;IAChD;;gCAE4B;IAC5B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACpD,WAAW,EAAE,CAAC;IAChB,CAAC;IACD,oBAAoB;CACrB,CAAC"}

package/dist/lsp/completion.d.ts

@@ -0,0 +1,27 @@
+import { CompletionItem, MarkupKind } from "vscode-languageserver";
+import type { Position } from "vscode-languageserver";
+import type { TextDocument } from "vscode-languageserver-textdocument";
+type JsonPath = Array<string | number>;
+/**
+ * Cursor is at a step-object key position: `…/steps/<index>/<partialKey>`.
+ * Offers action-key completions.
+ */
+export declare function isStepKeyContext(path: JsonPath): boolean;
+/**
+ * Cursor is at a key position inside an action object:
+ * `…/steps/<index>/<actionKey>/<partialKey>`. Returns the action key, or null.
+ */
+export declare function actionFieldContext(path: JsonPath): string | null;
+/** A Markdown documentation payload, or undefined when there's no text. */
+export declare function markdownDoc(text: string | undefined): {
+    kind: MarkupKind;
+    value: string;
+} | undefined;
+/**
+ * Compute completions at a position. Phase 2: action-key completion inside a
+ * `steps` element, and field-name completion inside a known action's object.
+ * Spec documents only, JSON only, key positions only.
+ */
+export declare function computeCompletions(doc: TextDocument, position: Position): CompletionItem[];
+export {};
+//# sourceMappingURL=completion.d.ts.map

package/dist/lsp/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/lsp/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAGd,UAAU,EAEX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAKvE,KAAK,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAQxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAYhE;AAcD,2EAA2E;AAC3E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEjD;AAsDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,QAAQ,GACjB,cAAc,EAAE,CAyBlB"}

package/dist/lsp/completion.js

@@ -0,0 +1,114 @@
+import { CompletionItemKind, InsertTextFormat, MarkupKind, TextEdit, } from "vscode-languageserver";
+import { getLocation } from "jsonc-parser";
+import { classifyDocument, isJsonUri } from "./gate.js";
+import { getRegistry } from "./registry.js";
+/**
+ * Cursor is at a step-object key position: `…/steps/<index>/<partialKey>`.
+ * Offers action-key completions.
+ */
+export function isStepKeyContext(path) {
+    const n = path.length;
+    return (n >= 3 &&
+        typeof path[n - 1] === "string" &&
+        typeof path[n - 2] === "number" &&
+        path[n - 3] === "steps");
+}
+/**
+ * Cursor is at a key position inside an action object:
+ * `…/steps/<index>/<actionKey>/<partialKey>`. Returns the action key, or null.
+ */
+export function actionFieldContext(path) {
+    const n = path.length;
+    if (n >= 4 &&
+        typeof path[n - 1] === "string" &&
+        typeof path[n - 2] === "string" &&
+        typeof path[n - 3] === "number" &&
+        path[n - 4] === "steps") {
+        return path[n - 2];
+    }
+    return null;
+}
+/**
+ * The value placeholder inserted after an action key. Quotes the tab-stop only
+ * for string scalars — a numeric (`wait`) or boolean (`stopRecord`) action gets
+ * a bare placeholder so the starter isn't schema-invalid; object-only actions
+ * get a brace body.
+ */
+function valueSnippet(primitiveKind) {
+    if (primitiveKind === "string")
+        return '"$1"';
+    if (primitiveKind === "number" || primitiveKind === "boolean")
+        return "$1";
+    return "{\n\t$1\n}";
+}
+/** A Markdown documentation payload, or undefined when there's no text. */
+export function markdownDoc(text) {
+    return text ? { kind: MarkupKind.Markdown, value: text } : undefined;
+}
+/** Build a snippet TextEdit that replaces the partial key node, if present. */
+function keyTextEdit(doc, previousNode, insertText) {
+    // When the cursor is on a partial key, jsonc reports the enclosing node whose
+    // span covers the key (and any `:value` already typed). We're gated on
+    // isAtPropertyKey, so replacing that whole span with the snippet avoids
+    // doubled quotes and leftover `:` fragments.
+    if (previousNode) {
+        const start = doc.positionAt(previousNode.offset);
+        const end = doc.positionAt(previousNode.offset + previousNode.length);
+        return { textEdit: TextEdit.replace({ start, end }, insertText) };
+    }
+    // Truly empty object (`{}`): no key token to replace — insert at the cursor.
+    return { insertText };
+}
+function actionItem(action, doc, previousNode) {
+    const insert = `"${action.key}": ${valueSnippet(action.primitiveKind)}`;
+    const edit = keyTextEdit(doc, previousNode, insert);
+    return {
+        label: action.key,
+        kind: CompletionItemKind.Property,
+        detail: action.title,
+        documentation: markdownDoc(action.description),
+        insertTextFormat: InsertTextFormat.Snippet,
+        ...edit,
+    };
+}
+function fieldItem(field, doc, previousNode) {
+    const insert = `"${field.name}": ${valueSnippet(field.primitiveKind)}`;
+    const edit = keyTextEdit(doc, previousNode, insert);
+    return {
+        label: field.name,
+        kind: CompletionItemKind.Field,
+        documentation: markdownDoc(field.description),
+        insertTextFormat: InsertTextFormat.Snippet,
+        ...edit,
+    };
+}
+/**
+ * Compute completions at a position. Phase 2: action-key completion inside a
+ * `steps` element, and field-name completion inside a known action's object.
+ * Spec documents only, JSON only, key positions only.
+ */
+export function computeCompletions(doc, position) {
+    const text = doc.getText();
+    if (classifyDocument({ uri: doc.uri, text }) !== "spec")
+        return [];
+    if (!isJsonUri(doc.uri))
+        return [];
+    const offset = doc.offsetAt(position);
+    const location = getLocation(text, offset);
+    if (!location.isAtPropertyKey)
+        return [];
+    const registry = getRegistry();
+    const previousNode = location.previousNode;
+    if (isStepKeyContext(location.path)) {
+        return registry.actions.map((a) => actionItem(a, doc, previousNode));
+    }
+    const actionKey = actionFieldContext(location.path);
+    if (actionKey) {
+        const action = registry.byKey.get(actionKey);
+        if (action) {
+            return action.fields.map((f) => fieldItem(f, doc, previousNode));
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=completion.js.map

package/dist/lsp/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/lsp/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAa,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAA0C,MAAM,eAAe,CAAC;AAIpF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,OAAO,CACL,CAAC,IAAI,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ;QAC/B,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ;QAC/B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,CACxB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,IACE,CAAC,IAAI,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ;QAC/B,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ;QAC/B,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ;QAC/B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,EACvB,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAW,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,aAA4B;IAChD,IAAI,aAAa,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CACzB,IAAwB;IAExB,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,+EAA+E;AAC/E,SAAS,WAAW,CAClB,GAAiB,EACjB,YAA8B,EAC9B,UAAkB;IAElB,8EAA8E;IAC9E,uEAAuE;IACvE,wEAAwE;IACxE,6CAA6C;IAC7C,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACtE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,6EAA6E;IAC7E,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,UAAU,CACjB,MAAkB,EAClB,GAAiB,EACjB,YAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,GAAG;QACjB,IAAI,EAAE,kBAAkB,CAAC,QAAQ;QACjC,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC9C,gBAAgB,EAAE,gBAAgB,CAAC,OAAO;QAC1C,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,KAAkB,EAClB,GAAiB,EACjB,YAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,MAAM,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;IACvE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,IAAI,EAAE,kBAAkB,CAAC,KAAK;QAC9B,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;QAC7C,gBAAgB,EAAE,gBAAgB,CAAC,OAAO;QAC1C,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAiB,EACjB,QAAkB;IAElB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3B,IAAI,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACnE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,eAAe;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IAE3C,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/lsp/diagnostics.d.ts

@@ -0,0 +1,21 @@
+import { Diagnostic } from "vscode-languageserver";
+import type { TextDocument } from "vscode-languageserver-textdocument";
+import { DIAGNOSTIC_SOURCE, ACTION_KEYED_MESSAGE, V2_DEPRECATION_MESSAGE, schemaMessage } from "./messages.js";
+export { DIAGNOSTIC_SOURCE, ACTION_KEYED_MESSAGE, V2_DEPRECATION_MESSAGE, schemaMessage, };
+/**
+ * Should this schema error be dropped because an action-keyed step already
+ * explains it? Two cases: (1) the error sits at/under the offending step, or
+ * (2) it's a vague container `anyOf`/`oneOf` failure on an *ancestor* of that
+ * step — the propagation of the same problem up to the test/spec level, which
+ * says only "must match a schema in anyOf" and is useless next to the precise
+ * action-keyed diagnostic.
+ */
+export declare function isSuppressedByActionKeyed(instancePath: string, keyword: string | undefined, suppressedPointers: string[]): boolean;
+/**
+ * Compute all diagnostics for a document. Pure over (uri, text): no filesystem,
+ * no network. Handles JSON and YAML specs/configs. Returns `[]` for anything the
+ * detection gate doesn't recognize and for empty/unparseable buffers (beyond
+ * the syntax errors themselves).
+ */
+export declare function computeDiagnostics(doc: TextDocument): Diagnostic[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/lsp/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lsp/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAGX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAMvE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,GACd,CAAC;AA4BF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,kBAAkB,EAAE,MAAM,EAAE,GAC3B,OAAO,CAWT;AAGD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,EAAE,CAwFlE"}