obsidian-integration-testing 10.4.0 → 12.0.0

package/dist/lib/esm/wedged-appium-server.d.mts

@@ -0,0 +1,187 @@
+/**
+ * @file
+ *
+ * Pure helpers for recognizing a **wedged** Appium server and deciding what to
+ * do about it. Kept separate from the integration-only `transport-factory` so
+ * the classification, the remedy decision and the message stay unit-testable
+ * (the factory itself needs a real device and is excluded from unit tests).
+ *
+ * A wedged server is one that is still **live** — it listens on its port and
+ * answers `/status` with `ready: true` — but is no longer **usable**: its
+ * `appium-adb` can no longer enumerate devices, so every session creation dies
+ * with `Could not find a connected Android device in <n>ms` while the host's own
+ * `adb devices` lists the device instantly. Liveness is not readiness, and the
+ * error names the wrong subject: it blames a device that is demonstrably
+ * present, which sends whoever reads it to `adb devices` — the one diagnostic
+ * that actively misleads here.
+ *
+ * The wedge develops over time in a long-lived server (one auto-started by an
+ * earlier run and left listening), so the preflight cannot see it coming: it can
+ * only be recognized from the failed session, cross-checked against the host's
+ * adb.
+ */
+/**
+ * Parameters for {@link buildWedgedAppiumServerMessage}.
+ */
+export interface BuildWedgedAppiumServerMessageParams {
+    /**
+    Origin of the Appium server that could not see the device (e.g. `http://localhost:4723`).
+     */
+    readonly appiumOrigin: string;
+    /**
+    The device the host's adb can see but Appium cannot.
+     */
+    readonly deviceId: string;
+    /**
+    Why this run is reporting rather than restarting.
+     */
+    readonly reason: WedgedAppiumServerReportReason;
+    /**
+    How long the server has been running, when known from its marker.
+     */
+    readonly serverAgeInMilliseconds?: number | undefined;
+    /**
+    PID of the server, when known from its marker.
+     */
+    readonly serverPid?: number | undefined;
+}
+/**
+ * The server is not to blame: either the failure was a different error, or the
+ * host's adb cannot see the device either. The original error is rethrown.
+ */
+export interface NotWedgedVerdict {
+    /**
+    Which of the two honest-failure cases this is.
+     */
+    readonly reason: 'device-absent' | 'other-error';
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'not-wedged';
+}
+/**
+ * The server is wedged but must not be touched by this run.
+ */
+export interface ReportServerVerdict {
+    /**
+    Why this run is reporting rather than restarting.
+     */
+    readonly reason: WedgedAppiumServerReportReason;
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'report';
+}
+/**
+ * Parameters for {@link resolveWedgedAppiumServerRemedy}.
+ */
+export interface ResolveWedgedAppiumServerRemedyParams {
+    /**
+    Device IDs the **host's** adb currently lists (the cross-check that convicts the server).
+     */
+    readonly connectedDeviceIds: readonly string[];
+    /**
+    The device the session was requested against.
+     */
+    readonly deviceId: string;
+    /**
+    The error the session attempt failed with.
+     */
+    readonly error: unknown;
+    /**
+    Whether the server was already listening and was adopted, rather than started by this run.
+     */
+    readonly isAdoptedServer: boolean;
+    /**
+    Whether this run may start an Appium server (`shouldAutoStartAppium` is not `false`).
+     */
+    readonly isAutoStartAllowed: boolean;
+    /**
+    Whether the adopted server's marker proves an earlier run of this harness started it.
+     */
+    readonly isHarnessOwnedServer: boolean;
+}
+/**
+ * The server is wedged and an earlier run of this harness started it, so this
+ * run may replace it.
+ */
+export interface RestartServerVerdict {
+    /**
+    Always the harness-owned case.
+     */
+    readonly reason: 'harness-owned';
+    /**
+    Discriminant.
+     */
+    readonly remedy: 'restart';
+}
+/**
+ * The classification of a failed session attempt.
+ *
+ * `'device-absent'` and `'other-error'` are the not-wedged verdicts: the
+ * original error was honest and is rethrown untouched.
+ */
+export type WedgedAppiumServerReason = 'device-absent' | 'harness-owned' | 'other-error' | WedgedAppiumServerReportReason;
+/**
+ * What the factory should do with a failed session attempt.
+ */
+export type WedgedAppiumServerRemedy = 'not-wedged' | 'report' | 'restart';
+/**
+ * Why a wedged server is only reported rather than restarted. Each maps to its
+ * own remedy sentence — the whole point of the rewrite is that the message says
+ * what *this* run can and cannot do about the server it found.
+ */
+export type WedgedAppiumServerReportReason = 'auto-start-disabled' | 'foreign-server' | 'freshly-started' | 'restart-did-not-help';
+/**
+ * The verdict on a failed session attempt, discriminated by `remedy` so a
+ * `'report'` verdict carries a reason {@link buildWedgedAppiumServerMessage} can
+ * turn into advice.
+ */
+export type WedgedAppiumServerVerdict = NotWedgedVerdict | ReportServerVerdict | RestartServerVerdict;
+/**
+ * Builds the error message that replaces `Could not find a connected Android
+ * device`, naming the **server** and stating the evidence — the host's adb can
+ * see the device, so the server is the thing that is stale.
+ *
+ * @param params - The server, the device, and why this run is not restarting it.
+ * @returns The message.
+ */
+export declare function buildWedgedAppiumServerMessage(params: BuildWedgedAppiumServerMessageParams): string;
+/**
+ * Checks whether a failed session attempt is `appium-adb`'s device-enumeration
+ * failure. The whole `cause` chain is searched, so WebdriverIO's wrapping of the
+ * server's error does not hide it.
+ *
+ * @param error - The error the session attempt failed with.
+ * @returns `true` when it is the device-not-found failure.
+ */
+export declare function checkIsAppiumDeviceNotFoundError(error: unknown): boolean;
+/**
+ * Checks whether an Appium `/status` body reports a server that is accepting new
+ * sessions.
+ *
+ * Deliberately **tolerant**: only an explicit `ready: false` (Appium sets it
+ * while shutting down) is treated as not-ready. A body that cannot be parsed, or
+ * that omits the flag, reads as ready — an unrecognized shape must not make a
+ * healthy server look unreachable.
+ *
+ * This does not catch the wedge (a wedged server still answers `ready: true`);
+ * it closes the adjacent hole of adopting a server that is on its way down.
+ *
+ * @param statusBody - The raw `/status` response body.
+ * @returns `false` only when the server explicitly reports itself not ready.
+ */
+export declare function checkIsAppiumStatusReady(statusBody: string): boolean;
+/**
+ * Decides what to do with a failed session attempt.
+ *
+ * The device-not-found error is only evidence against the server when the host's
+ * adb *can* still see the device; otherwise the error was honest and is left
+ * alone. A server this harness started in an earlier run is restarted (the
+ * confirmed remedy); every other wedged server is reported rather than killed,
+ * because terminating a process this run does not own is not its call to make.
+ *
+ * @param params - The failed attempt and what is known about the server.
+ * @returns The verdict.
+ */
+export declare function resolveWedgedAppiumServerRemedy(params: ResolveWedgedAppiumServerRemedyParams): WedgedAppiumServerVerdict;

package/dist/lib/esm/wedged-appium-server.mjs

@@ -0,0 +1,86 @@
+import { errorToString } from "./error-to-string.mjs";
+const DEVICE_NOT_FOUND_MESSAGE_FRAGMENT = "Could not find a connected Android device";
+const MILLISECONDS_PER_SECOND = 1e3;
+const SECONDS_PER_MINUTE = 60;
+const MILLISECONDS_PER_MINUTE = MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE;
+function buildWedgedAppiumServerMessage(params) {
+  const lines = [
+    `The Appium server at ${params.appiumOrigin} cannot see Android device ${params.deviceId}, although this host's adb can.`,
+    "The server is stale \u2014 its adb connection is wedged \u2014 not the device, so `adb devices` will list the device and mislead you.",
+    resolveRemedyAdvice(params)
+  ];
+  const provenance = describeServer(params);
+  if (provenance) {
+    lines.push(provenance);
+  }
+  return lines.join("\n");
+}
+function checkIsAppiumDeviceNotFoundError(error) {
+  return errorToString(error).includes(DEVICE_NOT_FOUND_MESSAGE_FRAGMENT);
+}
+function checkIsAppiumStatusReady(statusBody) {
+  let parsed;
+  try {
+    parsed = JSON.parse(statusBody);
+  } catch {
+    return true;
+  }
+  return readReadyFlag(parsed) !== false;
+}
+function resolveWedgedAppiumServerRemedy(params) {
+  if (!checkIsAppiumDeviceNotFoundError(params.error)) {
+    return { reason: "other-error", remedy: "not-wedged" };
+  }
+  if (!params.connectedDeviceIds.includes(params.deviceId)) {
+    return { reason: "device-absent", remedy: "not-wedged" };
+  }
+  if (!params.isAdoptedServer) {
+    return { reason: "freshly-started", remedy: "report" };
+  }
+  if (!params.isAutoStartAllowed) {
+    return { reason: "auto-start-disabled", remedy: "report" };
+  }
+  if (!params.isHarnessOwnedServer) {
+    return { reason: "foreign-server", remedy: "report" };
+  }
+  return { reason: "harness-owned", remedy: "restart" };
+}
+function describeServer(params) {
+  if (params.serverPid === void 0) {
+    return "";
+  }
+  const age = params.serverAgeInMilliseconds === void 0 ? "" : `, running for ${formatAge(params.serverAgeInMilliseconds)}`;
+  return `The server was started by an earlier obsidian-integration-testing run (pid ${String(params.serverPid)}${age}).`;
+}
+function formatAge(ageInMilliseconds) {
+  if (ageInMilliseconds < MILLISECONDS_PER_MINUTE) {
+    return `${String(Math.round(ageInMilliseconds / MILLISECONDS_PER_SECOND))}s`;
+  }
+  return `${String(Math.round(ageInMilliseconds / MILLISECONDS_PER_MINUTE))}min`;
+}
+function readReadyFlag(parsed) {
+  if (typeof parsed !== "object" || parsed === null) {
+    return void 0;
+  }
+  const record = parsed;
+  const value = record["value"];
+  const nested = typeof value === "object" && value !== null ? value["ready"] : void 0;
+  const ready = nested ?? record["ready"];
+  return typeof ready === "boolean" ? ready : void 0;
+}
+function resolveRemedyAdvice(params) {
+  const advice = {
+    "auto-start-disabled": `Appium auto-start is disabled (\`shouldAutoStartAppium: false\`), so this server is yours to manage: kill it and start a fresh one on ${params.appiumOrigin}, then re-run.`,
+    "foreign-server": `This server was not started by obsidian-integration-testing, so it was left running: kill it and start a fresh one on ${params.appiumOrigin}, then re-run.`,
+    "freshly-started": "This server was started by this run, so restarting it would change nothing: check that adb and the emulator agree (`adb kill-server && adb devices`), then re-run.",
+    "restart-did-not-help": `Restarting the server on ${params.appiumOrigin} did not help \u2014 a fresh one still could not serve this run, so the wedge is not the server alone: check adb itself (\`adb kill-server && adb devices\`) and that nothing else holds the port, then re-run.`
+  };
+  return advice[params.reason];
+}
+export {
+  buildWedgedAppiumServerMessage,
+  checkIsAppiumDeviceNotFoundError,
+  checkIsAppiumStatusReady,
+  resolveWedgedAppiumServerRemedy
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3dlZGdlZC1hcHBpdW0tc2VydmVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUHVyZSBoZWxwZXJzIGZvciByZWNvZ25pemluZyBhICoqd2VkZ2VkKiogQXBwaXVtIHNlcnZlciBhbmQgZGVjaWRpbmcgd2hhdCB0b1xuICogZG8gYWJvdXQgaXQuIEtlcHQgc2VwYXJhdGUgZnJvbSB0aGUgaW50ZWdyYXRpb24tb25seSBgdHJhbnNwb3J0LWZhY3RvcnlgIHNvXG4gKiB0aGUgY2xhc3NpZmljYXRpb24sIHRoZSByZW1lZHkgZGVjaXNpb24gYW5kIHRoZSBtZXNzYWdlIHN0YXkgdW5pdC10ZXN0YWJsZVxuICogKHRoZSBmYWN0b3J5IGl0c2VsZiBuZWVkcyBhIHJlYWwgZGV2aWNlIGFuZCBpcyBleGNsdWRlZCBmcm9tIHVuaXQgdGVzdHMpLlxuICpcbiAqIEEgd2VkZ2VkIHNlcnZlciBpcyBvbmUgdGhhdCBpcyBzdGlsbCAqKmxpdmUqKiBcdTIwMTQgaXQgbGlzdGVucyBvbiBpdHMgcG9ydCBhbmRcbiAqIGFuc3dlcnMgYC9zdGF0dXNgIHdpdGggYHJlYWR5OiB0cnVlYCBcdTIwMTQgYnV0IGlzIG5vIGxvbmdlciAqKnVzYWJsZSoqOiBpdHNcbiAqIGBhcHBpdW0tYWRiYCBjYW4gbm8gbG9uZ2VyIGVudW1lcmF0ZSBkZXZpY2VzLCBzbyBldmVyeSBzZXNzaW9uIGNyZWF0aW9uIGRpZXNcbiAqIHdpdGggYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWQgZGV2aWNlIGluIDxuPm1zYCB3aGlsZSB0aGUgaG9zdCdzIG93blxuICogYGFkYiBkZXZpY2VzYCBsaXN0cyB0aGUgZGV2aWNlIGluc3RhbnRseS4gTGl2ZW5lc3MgaXMgbm90IHJlYWRpbmVzcywgYW5kIHRoZVxuICogZXJyb3IgbmFtZXMgdGhlIHdyb25nIHN1YmplY3Q6IGl0IGJsYW1lcyBhIGRldmljZSB0aGF0IGlzIGRlbW9uc3RyYWJseVxuICogcHJlc2VudCwgd2hpY2ggc2VuZHMgd2hvZXZlciByZWFkcyBpdCB0byBgYWRiIGRldmljZXNgIFx1MjAxNCB0aGUgb25lIGRpYWdub3N0aWNcbiAqIHRoYXQgYWN0aXZlbHkgbWlzbGVhZHMgaGVyZS5cbiAqXG4gKiBUaGUgd2VkZ2UgZGV2ZWxvcHMgb3ZlciB0aW1lIGluIGEgbG9uZy1saXZlZCBzZXJ2ZXIgKG9uZSBhdXRvLXN0YXJ0ZWQgYnkgYW5cbiAqIGVhcmxpZXIgcnVuIGFuZCBsZWZ0IGxpc3RlbmluZyksIHNvIHRoZSBwcmVmbGlnaHQgY2Fubm90IHNlZSBpdCBjb21pbmc6IGl0IGNhblxuICogb25seSBiZSByZWNvZ25pemVkIGZyb20gdGhlIGZhaWxlZCBzZXNzaW9uLCBjcm9zcy1jaGVja2VkIGFnYWluc3QgdGhlIGhvc3Qnc1xuICogYWRiLlxuICovXG5cbmltcG9ydCB7IGVycm9yVG9TdHJpbmcgfSBmcm9tICcuL2Vycm9yLXRvLXN0cmluZy5tanMnO1xuXG4vKipcbiAqIFRoZSBmcmFnbWVudCBgYXBwaXVtLWFkYmAgdGhyb3dzIHdoZW4gaXQgY2Fubm90IGVudW1lcmF0ZSBkZXZpY2VzIFx1MjAxNFxuICogYGAgYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWQgZGV2aWNlIGluICR7dGltZW91dE1zfW1zYCBgYCBmcm9tIGl0c1xuICogYGdldERldmljZXNXaXRoUmV0cnlgIChgbGliL3Rvb2xzL3N5c3RlbS1jYWxscy50c2ApLiBNYXRjaGVkIGFzIGEgc3Vic3RyaW5nIHNvXG4gKiB0aGUgdGltZW91dCB2YWx1ZSBhbmQgYW55IHdyYXBwaW5nIGJ5IFdlYmRyaXZlcklPIGRvIG5vdCBhZmZlY3QgaXQuXG4gKi9cbmNvbnN0IERFVklDRV9OT1RfRk9VTkRfTUVTU0FHRV9GUkFHTUVOVCA9ICdDb3VsZCBub3QgZmluZCBhIGNvbm5lY3RlZCBBbmRyb2lkIGRldmljZSc7XG5cbmNvbnN0IE1JTExJU0VDT05EU19QRVJfU0VDT05EID0gMTAwMDtcbmNvbnN0IFNFQ09ORFNfUEVSX01JTlVURSA9IDYwO1xuY29uc3QgTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUgPSBNSUxMSVNFQ09ORFNfUEVSX1NFQ09ORCAqIFNFQ09ORFNfUEVSX01JTlVURTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgYnVpbGRXZWRnZWRBcHBpdW1TZXJ2ZXJNZXNzYWdlfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCdWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2VQYXJhbXMge1xuICAvKipcbiAgT3JpZ2luIG9mIHRoZSBBcHBpdW0gc2VydmVyIHRoYXQgY291bGQgbm90IHNlZSB0aGUgZGV2aWNlIChlLmcuIGBodHRwOi8vbG9jYWxob3N0OjQ3MjNgKS5cbiAgICovXG4gIHJlYWRvbmx5IGFwcGl1bU9yaWdpbjogc3RyaW5nO1xuXG4gIC8qKlxuICBUaGUgZGV2aWNlIHRoZSBob3N0J3MgYWRiIGNhbiBzZWUgYnV0IEFwcGl1bSBjYW5ub3QuXG4gICAqL1xuICByZWFkb25seSBkZXZpY2VJZDogc3RyaW5nO1xuXG4gIC8qKlxuICBXaHkgdGhpcyBydW4gaXMgcmVwb3J0aW5nIHJhdGhlciB0aGFuIHJlc3RhcnRpbmcuXG4gICAqL1xuICByZWFkb25seSByZWFzb246IFdlZGdlZEFwcGl1bVNlcnZlclJlcG9ydFJlYXNvbjtcblxuICAvKipcbiAgSG93IGxvbmcgdGhlIHNlcnZlciBoYXMgYmVlbiBydW5uaW5nLCB3aGVuIGtub3duIGZyb20gaXRzIG1hcmtlci5cbiAgICovXG4gIHJlYWRvbmx5IHNlcnZlckFnZUluTWlsbGlzZWNvbmRzPzogbnVtYmVyIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICBQSUQgb2YgdGhlIHNlcnZlciwgd2hlbiBrbm93biBmcm9tIGl0cyBtYXJrZXIuXG4gICAqL1xuICByZWFkb25seSBzZXJ2ZXJQaWQ/OiBudW1iZXIgfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogVGhlIHNlcnZlciBpcyBub3QgdG8gYmxhbWU6IGVpdGhlciB0aGUgZmFpbHVyZSB3YXMgYSBkaWZmZXJlbnQgZXJyb3IsIG9yIHRoZVxuICogaG9zdCdzIGFkYiBjYW5ub3Qgc2VlIHRoZSBkZXZpY2UgZWl0aGVyLiBUaGUgb3JpZ2luYWwgZXJyb3IgaXMgcmV0aHJvd24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTm90V2VkZ2VkVmVyZGljdCB7XG4gIC8qKlxuICBXaGljaCBvZiB0aGUgdHdvIGhvbmVzdC1mYWlsdXJlIGNhc2VzIHRoaXMgaXMuXG4gICAqL1xuICByZWFkb25seSByZWFzb246ICdkZXZpY2UtYWJzZW50JyB8ICdvdGhlci1lcnJvcic7XG5cbiAgLyoqXG4gIERpc2NyaW1pbmFudC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbWVkeTogJ25vdC13ZWRnZWQnO1xufVxuXG4vKipcbiAqIFRoZSBzZXJ2ZXIgaXMgd2VkZ2VkIGJ1dCBtdXN0IG5vdCBiZSB0b3VjaGVkIGJ5IHRoaXMgcnVuLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlcG9ydFNlcnZlclZlcmRpY3Qge1xuICAvKipcbiAgV2h5IHRoaXMgcnVuIGlzIHJlcG9ydGluZyByYXRoZXIgdGhhbiByZXN0YXJ0aW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVhc29uOiBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb247XG5cbiAgLyoqXG4gIERpc2NyaW1pbmFudC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbWVkeTogJ3JlcG9ydCc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHJlc29sdmVXZWRnZWRBcHBpdW1TZXJ2ZXJSZW1lZHl9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlc29sdmVXZWRnZWRBcHBpdW1TZXJ2ZXJSZW1lZHlQYXJhbXMge1xuICAvKipcbiAgRGV2aWNlIElEcyB0aGUgKipob3N0J3MqKiBhZGIgY3VycmVudGx5IGxpc3RzICh0aGUgY3Jvc3MtY2hlY2sgdGhhdCBjb252aWN0cyB0aGUgc2VydmVyKS5cbiAgICovXG4gIHJlYWRvbmx5IGNvbm5lY3RlZERldmljZUlkczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gIFRoZSBkZXZpY2UgdGhlIHNlc3Npb24gd2FzIHJlcXVlc3RlZCBhZ2FpbnN0LlxuICAgKi9cbiAgcmVhZG9ubHkgZGV2aWNlSWQ6IHN0cmluZztcblxuICAvKipcbiAgVGhlIGVycm9yIHRoZSBzZXNzaW9uIGF0dGVtcHQgZmFpbGVkIHdpdGguXG4gICAqL1xuICByZWFkb25seSBlcnJvcjogdW5rbm93bjtcblxuICAvKipcbiAgV2hldGhlciB0aGUgc2VydmVyIHdhcyBhbHJlYWR5IGxpc3RlbmluZyBhbmQgd2FzIGFkb3B0ZWQsIHJhdGhlciB0aGFuIHN0YXJ0ZWQgYnkgdGhpcyBydW4uXG4gICAqL1xuICByZWFkb25seSBpc0Fkb3B0ZWRTZXJ2ZXI6IGJvb2xlYW47XG5cbiAgLyoqXG4gIFdoZXRoZXIgdGhpcyBydW4gbWF5IHN0YXJ0IGFuIEFwcGl1bSBzZXJ2ZXIgKGBzaG91bGRBdXRvU3RhcnRBcHBpdW1gIGlzIG5vdCBgZmFsc2VgKS5cbiAgICovXG4gIHJlYWRvbmx5IGlzQXV0b1N0YXJ0QWxsb3dlZDogYm9vbGVhbjtcblxuICAvKipcbiAgV2hldGhlciB0aGUgYWRvcHRlZCBzZXJ2ZXIncyBtYXJrZXIgcHJvdmVzIGFuIGVhcmxpZXIgcnVuIG9mIHRoaXMgaGFybmVzcyBzdGFydGVkIGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgaXNIYXJuZXNzT3duZWRTZXJ2ZXI6IGJvb2xlYW47XG59XG5cbi8qKlxuICogVGhlIHNlcnZlciBpcyB3ZWRnZWQgYW5kIGFuIGVhcmxpZXIgcnVuIG9mIHRoaXMgaGFybmVzcyBzdGFydGVkIGl0LCBzbyB0aGlzXG4gKiBydW4gbWF5IHJlcGxhY2UgaXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzdGFydFNlcnZlclZlcmRpY3Qge1xuICAvKipcbiAgQWx3YXlzIHRoZSBoYXJuZXNzLW93bmVkIGNhc2UuXG4gICAqL1xuICByZWFkb25seSByZWFzb246ICdoYXJuZXNzLW93bmVkJztcblxuICAvKipcbiAgRGlzY3JpbWluYW50LlxuICAgKi9cbiAgcmVhZG9ubHkgcmVtZWR5OiAncmVzdGFydCc7XG59XG5cbi8qKlxuICogVGhlIGNsYXNzaWZpY2F0aW9uIG9mIGEgZmFpbGVkIHNlc3Npb24gYXR0ZW1wdC5cbiAqXG4gKiBgJ2RldmljZS1hYnNlbnQnYCBhbmQgYCdvdGhlci1lcnJvcidgIGFyZSB0aGUgbm90LXdlZGdlZCB2ZXJkaWN0czogdGhlXG4gKiBvcmlnaW5hbCBlcnJvciB3YXMgaG9uZXN0IGFuZCBpcyByZXRocm93biB1bnRvdWNoZWQuXG4gKi9cbmV4cG9ydCB0eXBlIFdlZGdlZEFwcGl1bVNlcnZlclJlYXNvbiA9ICdkZXZpY2UtYWJzZW50JyB8ICdoYXJuZXNzLW93bmVkJyB8ICdvdGhlci1lcnJvcicgfCBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb247XG5cbi8qKlxuICogV2hhdCB0aGUgZmFjdG9yeSBzaG91bGQgZG8gd2l0aCBhIGZhaWxlZCBzZXNzaW9uIGF0dGVtcHQuXG4gKi9cbmV4cG9ydCB0eXBlIFdlZGdlZEFwcGl1bVNlcnZlclJlbWVkeSA9ICdub3Qtd2VkZ2VkJyB8ICdyZXBvcnQnIHwgJ3Jlc3RhcnQnO1xuXG4vKipcbiAqIFdoeSBhIHdlZGdlZCBzZXJ2ZXIgaXMgb25seSByZXBvcnRlZCByYXRoZXIgdGhhbiByZXN0YXJ0ZWQuIEVhY2ggbWFwcyB0byBpdHNcbiAqIG93biByZW1lZHkgc2VudGVuY2UgXHUyMDE0IHRoZSB3aG9sZSBwb2ludCBvZiB0aGUgcmV3cml0ZSBpcyB0aGF0IHRoZSBtZXNzYWdlIHNheXNcbiAqIHdoYXQgKnRoaXMqIHJ1biBjYW4gYW5kIGNhbm5vdCBkbyBhYm91dCB0aGUgc2VydmVyIGl0IGZvdW5kLlxuICovXG5leHBvcnQgdHlwZSBXZWRnZWRBcHBpdW1TZXJ2ZXJSZXBvcnRSZWFzb24gPVxuICB8ICdhdXRvLXN0YXJ0LWRpc2FibGVkJ1xuICB8ICdmb3JlaWduLXNlcnZlcidcbiAgfCAnZnJlc2hseS1zdGFydGVkJ1xuICB8ICdyZXN0YXJ0LWRpZC1ub3QtaGVscCc7XG5cbi8qKlxuICogVGhlIHZlcmRpY3Qgb24gYSBmYWlsZWQgc2Vzc2lvbiBhdHRlbXB0LCBkaXNjcmltaW5hdGVkIGJ5IGByZW1lZHlgIHNvIGFcbiAqIGAncmVwb3J0J2AgdmVyZGljdCBjYXJyaWVzIGEgcmVhc29uIHtAbGluayBidWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2V9IGNhblxuICogdHVybiBpbnRvIGFkdmljZS5cbiAqL1xuZXhwb3J0IHR5cGUgV2VkZ2VkQXBwaXVtU2VydmVyVmVyZGljdCA9IE5vdFdlZGdlZFZlcmRpY3QgfCBSZXBvcnRTZXJ2ZXJWZXJkaWN0IHwgUmVzdGFydFNlcnZlclZlcmRpY3Q7XG5cbi8qKlxuICogQnVpbGRzIHRoZSBlcnJvciBtZXNzYWdlIHRoYXQgcmVwbGFjZXMgYENvdWxkIG5vdCBmaW5kIGEgY29ubmVjdGVkIEFuZHJvaWRcbiAqIGRldmljZWAsIG5hbWluZyB0aGUgKipzZXJ2ZXIqKiBhbmQgc3RhdGluZyB0aGUgZXZpZGVuY2UgXHUyMDE0IHRoZSBob3N0J3MgYWRiIGNhblxuICogc2VlIHRoZSBkZXZpY2UsIHNvIHRoZSBzZXJ2ZXIgaXMgdGhlIHRoaW5nIHRoYXQgaXMgc3RhbGUuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBzZXJ2ZXIsIHRoZSBkZXZpY2UsIGFuZCB3aHkgdGhpcyBydW4gaXMgbm90IHJlc3RhcnRpbmcgaXQuXG4gKiBAcmV0dXJucyBUaGUgbWVzc2FnZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJ1aWxkV2VkZ2VkQXBwaXVtU2VydmVyTWVzc2FnZShwYXJhbXM6IEJ1aWxkV2VkZ2VkQXBwaXVtU2VydmVyTWVzc2FnZVBhcmFtcyk6IHN0cmluZyB7XG4gIGNvbnN0IGxpbmVzID0gW1xuICAgIGBUaGUgQXBwaXVtIHNlcnZlciBhdCAke3BhcmFtcy5hcHBpdW1PcmlnaW59IGNhbm5vdCBzZWUgQW5kcm9pZCBkZXZpY2UgJHtwYXJhbXMuZGV2aWNlSWR9LCBhbHRob3VnaCB0aGlzIGhvc3QncyBhZGIgY2FuLmAsXG4gICAgJ1RoZSBzZXJ2ZXIgaXMgc3RhbGUgXHUyMDE0IGl0cyBhZGIgY29ubmVjdGlvbiBpcyB3ZWRnZWQgXHUyMDE0IG5vdCB0aGUgZGV2aWNlLCBzbyBgYWRiIGRldmljZXNgIHdpbGwgbGlzdCB0aGUgZGV2aWNlIGFuZCBtaXNsZWFkIHlvdS4nLFxuICAgIHJlc29sdmVSZW1lZHlBZHZpY2UocGFyYW1zKVxuICBdO1xuXG4gIGNvbnN0IHByb3ZlbmFuY2UgPSBkZXNjcmliZVNlcnZlcihwYXJhbXMpO1xuICBpZiAocHJvdmVuYW5jZSkge1xuICAgIGxpbmVzLnB1c2gocHJvdmVuYW5jZSk7XG4gIH1cblxuICByZXR1cm4gbGluZXMuam9pbignXFxuJyk7XG59XG5cbi8qKlxuICogQ2hlY2tzIHdoZXRoZXIgYSBmYWlsZWQgc2Vzc2lvbiBhdHRlbXB0IGlzIGBhcHBpdW0tYWRiYCdzIGRldmljZS1lbnVtZXJhdGlvblxuICogZmFpbHVyZS4gVGhlIHdob2xlIGBjYXVzZWAgY2hhaW4gaXMgc2VhcmNoZWQsIHNvIFdlYmRyaXZlcklPJ3Mgd3JhcHBpbmcgb2YgdGhlXG4gKiBzZXJ2ZXIncyBlcnJvciBkb2VzIG5vdCBoaWRlIGl0LlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSBlcnJvciB0aGUgc2Vzc2lvbiBhdHRlbXB0IGZhaWxlZCB3aXRoLlxuICogQHJldHVybnMgYHRydWVgIHdoZW4gaXQgaXMgdGhlIGRldmljZS1ub3QtZm91bmQgZmFpbHVyZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNoZWNrSXNBcHBpdW1EZXZpY2VOb3RGb3VuZEVycm9yKGVycm9yOiB1bmtub3duKTogYm9vbGVhbiB7XG4gIHJldHVybiBlcnJvclRvU3RyaW5nKGVycm9yKS5pbmNsdWRlcyhERVZJQ0VfTk9UX0ZPVU5EX01FU1NBR0VfRlJBR01FTlQpO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIGFuIEFwcGl1bSBgL3N0YXR1c2AgYm9keSByZXBvcnRzIGEgc2VydmVyIHRoYXQgaXMgYWNjZXB0aW5nIG5ld1xuICogc2Vzc2lvbnMuXG4gKlxuICogRGVsaWJlcmF0ZWx5ICoqdG9sZXJhbnQqKjogb25seSBhbiBleHBsaWNpdCBgcmVhZHk6IGZhbHNlYCAoQXBwaXVtIHNldHMgaXRcbiAqIHdoaWxlIHNodXR0aW5nIGRvd24pIGlzIHRyZWF0ZWQgYXMgbm90LXJlYWR5LiBBIGJvZHkgdGhhdCBjYW5ub3QgYmUgcGFyc2VkLCBvclxuICogdGhhdCBvbWl0cyB0aGUgZmxhZywgcmVhZHMgYXMgcmVhZHkgXHUyMDE0IGFuIHVucmVjb2duaXplZCBzaGFwZSBtdXN0IG5vdCBtYWtlIGFcbiAqIGhlYWx0aHkgc2VydmVyIGxvb2sgdW5yZWFjaGFibGUuXG4gKlxuICogVGhpcyBkb2VzIG5vdCBjYXRjaCB0aGUgd2VkZ2UgKGEgd2VkZ2VkIHNlcnZlciBzdGlsbCBhbnN3ZXJzIGByZWFkeTogdHJ1ZWApO1xuICogaXQgY2xvc2VzIHRoZSBhZGphY2VudCBob2xlIG9mIGFkb3B0aW5nIGEgc2VydmVyIHRoYXQgaXMgb24gaXRzIHdheSBkb3duLlxuICpcbiAqIEBwYXJhbSBzdGF0dXNCb2R5IC0gVGhlIHJhdyBgL3N0YXR1c2AgcmVzcG9uc2UgYm9keS5cbiAqIEByZXR1cm5zIGBmYWxzZWAgb25seSB3aGVuIHRoZSBzZXJ2ZXIgZXhwbGljaXRseSByZXBvcnRzIGl0c2VsZiBub3QgcmVhZHkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjaGVja0lzQXBwaXVtU3RhdHVzUmVhZHkoc3RhdHVzQm9keTogc3RyaW5nKTogYm9vbGVhbiB7XG4gIGxldCBwYXJzZWQ6IHVua25vd247XG4gIHRyeSB7XG4gICAgcGFyc2VkID0gSlNPTi5wYXJzZShzdGF0dXNCb2R5KTtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cblxuICByZXR1cm4gcmVhZFJlYWR5RmxhZyhwYXJzZWQpICE9PSBmYWxzZTtcbn1cblxuLyoqXG4gKiBEZWNpZGVzIHdoYXQgdG8gZG8gd2l0aCBhIGZhaWxlZCBzZXNzaW9uIGF0dGVtcHQuXG4gKlxuICogVGhlIGRldmljZS1ub3QtZm91bmQgZXJyb3IgaXMgb25seSBldmlkZW5jZSBhZ2FpbnN0IHRoZSBzZXJ2ZXIgd2hlbiB0aGUgaG9zdCdzXG4gKiBhZGIgKmNhbiogc3RpbGwgc2VlIHRoZSBkZXZpY2U7IG90aGVyd2lzZSB0aGUgZXJyb3Igd2FzIGhvbmVzdCBhbmQgaXMgbGVmdFxuICogYWxvbmUuIEEgc2VydmVyIHRoaXMgaGFybmVzcyBzdGFydGVkIGluIGFuIGVhcmxpZXIgcnVuIGlzIHJlc3RhcnRlZCAodGhlXG4gKiBjb25maXJtZWQgcmVtZWR5KTsgZXZlcnkgb3RoZXIgd2VkZ2VkIHNlcnZlciBpcyByZXBvcnRlZCByYXRoZXIgdGhhbiBraWxsZWQsXG4gKiBiZWNhdXNlIHRlcm1pbmF0aW5nIGEgcHJvY2VzcyB0aGlzIHJ1biBkb2VzIG5vdCBvd24gaXMgbm90IGl0cyBjYWxsIHRvIG1ha2UuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBmYWlsZWQgYXR0ZW1wdCBhbmQgd2hhdCBpcyBrbm93biBhYm91dCB0aGUgc2VydmVyLlxuICogQHJldHVybnMgVGhlIHZlcmRpY3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlV2VkZ2VkQXBwaXVtU2VydmVyUmVtZWR5KHBhcmFtczogUmVzb2x2ZVdlZGdlZEFwcGl1bVNlcnZlclJlbWVkeVBhcmFtcyk6IFdlZGdlZEFwcGl1bVNlcnZlclZlcmRpY3Qge1xuICBpZiAoIWNoZWNrSXNBcHBpdW1EZXZpY2VOb3RGb3VuZEVycm9yKHBhcmFtcy5lcnJvcikpIHtcbiAgICByZXR1cm4geyByZWFzb246ICdvdGhlci1lcnJvcicsIHJlbWVkeTogJ25vdC13ZWRnZWQnIH07XG4gIH1cblxuICBpZiAoIXBhcmFtcy5jb25uZWN0ZWREZXZpY2VJZHMuaW5jbHVkZXMocGFyYW1zLmRldmljZUlkKSkge1xuICAgIHJldHVybiB7IHJlYXNvbjogJ2RldmljZS1hYnNlbnQnLCByZW1lZHk6ICdub3Qtd2VkZ2VkJyB9O1xuICB9XG5cbiAgaWYgKCFwYXJhbXMuaXNBZG9wdGVkU2VydmVyKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnZnJlc2hseS1zdGFydGVkJywgcmVtZWR5OiAncmVwb3J0JyB9O1xuICB9XG5cbiAgaWYgKCFwYXJhbXMuaXNBdXRvU3RhcnRBbGxvd2VkKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnYXV0by1zdGFydC1kaXNhYmxlZCcsIHJlbWVkeTogJ3JlcG9ydCcgfTtcbiAgfVxuXG4gIGlmICghcGFyYW1zLmlzSGFybmVzc093bmVkU2VydmVyKSB7XG4gICAgcmV0dXJuIHsgcmVhc29uOiAnZm9yZWlnbi1zZXJ2ZXInLCByZW1lZHk6ICdyZXBvcnQnIH07XG4gIH1cblxuICByZXR1cm4geyByZWFzb246ICdoYXJuZXNzLW93bmVkJywgcmVtZWR5OiAncmVzdGFydCcgfTtcbn1cblxuZnVuY3Rpb24gZGVzY3JpYmVTZXJ2ZXIocGFyYW1zOiBCdWlsZFdlZGdlZEFwcGl1bVNlcnZlck1lc3NhZ2VQYXJhbXMpOiBzdHJpbmcge1xuICBpZiAocGFyYW1zLnNlcnZlclBpZCA9PT0gdW5kZWZpbmVkKSB7XG4gICAgcmV0dXJuICcnO1xuICB9XG5cbiAgY29uc3QgYWdlID0gcGFyYW1zLnNlcnZlckFnZUluTWlsbGlzZWNvbmRzID09PSB1bmRlZmluZWQgPyAnJyA6IGAsIHJ1bm5pbmcgZm9yICR7Zm9ybWF0QWdlKHBhcmFtcy5zZXJ2ZXJBZ2VJbk1pbGxpc2Vjb25kcyl9YDtcbiAgcmV0dXJuIGBUaGUgc2VydmVyIHdhcyBzdGFydGVkIGJ5IGFuIGVhcmxpZXIgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZyBydW4gKHBpZCAke1N0cmluZyhwYXJhbXMuc2VydmVyUGlkKX0ke2FnZX0pLmA7XG59XG5cbmZ1bmN0aW9uIGZvcm1hdEFnZShhZ2VJbk1pbGxpc2Vjb25kczogbnVtYmVyKTogc3RyaW5nIHtcbiAgaWYgKGFnZUluTWlsbGlzZWNvbmRzIDwgTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUpIHtcbiAgICByZXR1cm4gYCR7U3RyaW5nKE1hdGgucm91bmQoYWdlSW5NaWxsaXNlY29uZHMgLyBNSUxMSVNFQ09ORFNfUEVSX1NFQ09ORCkpfXNgO1xuICB9XG5cbiAgcmV0dXJuIGAke1N0cmluZyhNYXRoLnJvdW5kKGFnZUluTWlsbGlzZWNvbmRzIC8gTUlMTElTRUNPTkRTX1BFUl9NSU5VVEUpKX1taW5gO1xufVxuXG5mdW5jdGlvbiByZWFkUmVhZHlGbGFnKHBhcnNlZDogdW5rbm93bik6IGJvb2xlYW4gfCB1bmRlZmluZWQge1xuICBpZiAodHlwZW9mIHBhcnNlZCAhPT0gJ29iamVjdCcgfHwgcGFyc2VkID09PSBudWxsKSB7XG4gICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgfVxuXG4gIGNvbnN0IHJlY29yZCA9IHBhcnNlZCBhcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbiAgY29uc3QgdmFsdWUgPSByZWNvcmRbJ3ZhbHVlJ107XG4gIGNvbnN0IG5lc3RlZCA9IHR5cGVvZiB2YWx1ZSA9PT0gJ29iamVjdCcgJiYgdmFsdWUgIT09IG51bGwgPyAodmFsdWUgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pWydyZWFkeSddIDogdW5kZWZpbmVkO1xuICBjb25zdCByZWFkeSA9IG5lc3RlZCA/PyByZWNvcmRbJ3JlYWR5J107XG4gIHJldHVybiB0eXBlb2YgcmVhZHkgPT09ICdib29sZWFuJyA/IHJlYWR5IDogdW5kZWZpbmVkO1xufVxuXG5mdW5jdGlvbiByZXNvbHZlUmVtZWR5QWR2aWNlKHBhcmFtczogQnVpbGRXZWRnZWRBcHBpdW1TZXJ2ZXJNZXNzYWdlUGFyYW1zKTogc3RyaW5nIHtcbiAgY29uc3QgYWR2aWNlOiBSZWNvcmQ8V2VkZ2VkQXBwaXVtU2VydmVyUmVwb3J0UmVhc29uLCBzdHJpbmc+ID0ge1xuICAgICdhdXRvLXN0YXJ0LWRpc2FibGVkJzogYEFwcGl1bSBhdXRvLXN0YXJ0IGlzIGRpc2FibGVkIChcXGBzaG91bGRBdXRvU3RhcnRBcHBpdW06IGZhbHNlXFxgKSwgc28gdGhpcyBzZXJ2ZXIgaXMgeW91cnMgdG8gbWFuYWdlOiBraWxsIGl0IGFuZCBzdGFydCBhIGZyZXNoIG9uZSBvbiAke3BhcmFtcy5hcHBpdW1PcmlnaW59LCB0aGVuIHJlLXJ1bi5gLFxuICAgICdmb3JlaWduLXNlcnZlcic6IGBUaGlzIHNlcnZlciB3YXMgbm90IHN0YXJ0ZWQgYnkgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZywgc28gaXQgd2FzIGxlZnQgcnVubmluZzoga2lsbCBpdCBhbmQgc3RhcnQgYSBmcmVzaCBvbmUgb24gJHtwYXJhbXMuYXBwaXVtT3JpZ2lufSwgdGhlbiByZS1ydW4uYCxcbiAgICAnZnJlc2hseS1zdGFydGVkJzogJ1RoaXMgc2VydmVyIHdhcyBzdGFydGVkIGJ5IHRoaXMgcnVuLCBzbyByZXN0YXJ0aW5nIGl0IHdvdWxkIGNoYW5nZSBub3RoaW5nOiBjaGVjayB0aGF0IGFkYiBhbmQgdGhlIGVtdWxhdG9yIGFncmVlIChgYWRiIGtpbGwtc2VydmVyICYmIGFkYiBkZXZpY2VzYCksIHRoZW4gcmUtcnVuLicsXG4gICAgJ3Jlc3RhcnQtZGlkLW5vdC1oZWxwJzogYFJlc3RhcnRpbmcgdGhlIHNlcnZlciBvbiAke3BhcmFtcy5hcHBpdW1PcmlnaW59IGRpZCBub3QgaGVscCBcdTIwMTQgYSBmcmVzaCBvbmUgc3RpbGwgY291bGQgbm90IHNlcnZlIHRoaXMgcnVuLCBzbyB0aGUgd2VkZ2UgaXMgbm90IHRoZSBzZXJ2ZXIgYWxvbmU6IGNoZWNrIGFkYiBpdHNlbGYgKFxcYGFkYiBraWxsLXNlcnZlciAmJiBhZGIgZGV2aWNlc1xcYCkgYW5kIHRoYXQgbm90aGluZyBlbHNlIGhvbGRzIHRoZSBwb3J0LCB0aGVuIHJlLXJ1bi5gXG4gIH07XG5cbiAgcmV0dXJuIGFkdmljZVtwYXJhbXMucmVhc29uXTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICJBQXVCQSxTQUFTLHFCQUFxQjtBQVE5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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obsidian-integration-testing",
-  "version": "10.4.0",
+  "version": "12.0.0",
   "description": "Simplifies integration testing of Obsidian plugins.",
   "keywords": [
     "obsidian",
@@ -151,6 +151,7 @@
     "lint:fix": "jiti scripts/lint-fix.ts",
     "lint:md": "jiti scripts/lint-md.ts",
     "lint:md:fix": "jiti scripts/lint-md-fix.ts",
+    "merge:runtime-versions": "jiti scripts/merge-runtime-versions.ts",
     "prepare": "jiti scripts/prepare.ts",
     "refresh:metadata": "jiti scripts/refresh-metadata.ts",
     "spellcheck": "jiti scripts/spellcheck.ts",
@@ -170,7 +171,7 @@
     "glob": "^13.0.6",
     "js-yaml": "4.3.1",
     "lodash": "4.18.1",
-    "markdown-it": "^15.0.0",
+    "markdown-it": "^15.0.1",
     "readdir-glob": "^3.0.0",
     "test-exclude": "^8.0.0",
     "tmp": "^0.2.7",
@@ -179,19 +180,19 @@
     "vite": "$vite"
   },
   "dependencies": {
-    "puppeteer-core": "^25.8.0",
+    "puppeteer-core": "^25.9.0",
     "webdriverio": "9.27.0"
   },
   "devDependencies": {
     "@astrojs/markdown-remark": "^7.2.4",
-    "@astrojs/starlight": "^0.41.8",
+    "@astrojs/starlight": "^0.41.10",
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
     "@commitlint/types": "^21.2.0",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.7.2",
     "@eslint/config-helpers": "^0.7.0",
     "@eslint/js": "^10.0.1",
-    "@obsidian-typings/obsidian-public-latest": "^6.34.0",
+    "@obsidian-typings/obsidian-public-latest": "^6.35.0",
     "@resvg/resvg-js": "^2.6.2",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@total-typescript/ts-reset": "^0.6.1",
@@ -201,9 +202,9 @@
     "@typescript-eslint/rule-tester": "^8.68.0",
     "@typescript-eslint/utils": "^8.68.0",
     "@vitest/coverage-v8": "^4.1.11",
-    "astro": "^7.2.6",
+    "astro": "^7.2.9",
     "better-typescript-lib": "^2.12.0",
-    "cspell": "^10.1.0",
+    "cspell": "^10.1.1",
     "czg": "^1.14.0",
     "dedent": "^1.7.2",
     "dprint": "^0.56.1",
@@ -215,13 +216,13 @@
     "eslint-plugin-jsdoc": "^64.2.1",
     "eslint-plugin-perfectionist": "^5.10.1",
     "eslint-plugin-tsdoc": "^0.5.2",
-    "eslint-plugin-unicorn": "^73.0.0",
+    "eslint-plugin-unicorn": "^74.0.0",
     "globals": "^17.11.0",
     "husky": "^9.1.7",
-    "jest": "^30.4.2",
-    "jest-config": "^30.4.2",
+    "jest": "^30.5.0",
+    "jest-config": "^30.5.0",
     "jiti": "^2.7.0",
-    "linkinator": "^8.0.4",
+    "linkinator": "^8.1.0",
     "markdownlint": "^0.41.1",
     "markdownlint-cli2": "^0.23.2",
     "markdownlint-rule-relative-links": "^5.1.2",
@@ -229,7 +230,7 @@
     "obsidian": "^1.13.1",
     "satori": "^0.33.4",
     "semver": "^7.8.5",
-    "sharp": "^0.35.3",
+    "sharp": "^0.35.4",
     "starlight-github-alerts": "^0.4.0",
     "ts-jest": "^29.4.12",
     "ts-morph": "^28.0.0",