veryfront 0.1.324 → 0.1.327

package/esm/src/testing/isolation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Test isolation utilities for cross-runtime execution.
+ *
+ * Provides default cleanup hooks to reduce cross-test leakage,
+ * especially in Bun where module caching and shared globals
+ * can cause flakiness.
+ *
+ * @module
+ */
+type CleanupTask = () => void | Promise<void>;
+export declare function registerTestCleanup(task: CleanupTask): void;
+/**
+ * Comprehensive reset of ALL test state across the application.
+ *
+ * This function clears all known caches and singletons that can cause
+ * test isolation issues when running tests in parallel. It should be
+ * called at the start and end of each test to ensure clean state.
+ *
+ * Includes:
+ * - Config state (_environmentConfig, runtimeConfig, configCache)
+ * - Layout discovery cache
+ * - SSR module caches
+ * - React cache and compat hooks
+ * - Snippet cache
+ * - API handler state
+ * - Reload notifier
+ */
+export declare function resetAllTestState(): Promise<void>;
+export {};
+//# sourceMappingURL=isolation.d.ts.map

package/esm/src/testing/isolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.d.ts","sourceRoot":"","sources":["../../../src/src/testing/isolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,KAAK,WAAW,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAQ9C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAE3D;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkHvD"}

package/esm/src/testing/isolation.js

@@ -0,0 +1,151 @@
+/**
+ * Test isolation utilities for cross-runtime execution.
+ *
+ * Provides default cleanup hooks to reduce cross-test leakage,
+ * especially in Bun where module caching and shared globals
+ * can cause flakiness.
+ *
+ * @module
+ */
+import { isBun } from "../platform/compat/runtime.js";
+const cleanupTasks = new Set();
+export function registerTestCleanup(task) {
+    cleanupTasks.add(task);
+}
+async function runBestEffortCleanups(cleanups) {
+    for (const { label, task } of cleanups) {
+        try {
+            await task();
+        }
+        catch (error) {
+            console.debug(`resetAllTestState ${label} failed`, error);
+        }
+    }
+}
+async function runRegisteredCleanups() {
+    const tasks = Array.from(cleanupTasks);
+    cleanupTasks.clear();
+    await runBestEffortCleanups(tasks.map((task) => ({
+        label: "registered cleanup",
+        task,
+    })));
+}
+/**
+ * Comprehensive reset of ALL test state across the application.
+ *
+ * This function clears all known caches and singletons that can cause
+ * test isolation issues when running tests in parallel. It should be
+ * called at the start and end of each test to ensure clean state.
+ *
+ * Includes:
+ * - Config state (_environmentConfig, runtimeConfig, configCache)
+ * - Layout discovery cache
+ * - SSR module caches
+ * - React cache and compat hooks
+ * - Snippet cache
+ * - API handler state
+ * - Reload notifier
+ */
+export async function resetAllTestState() {
+    await runRegisteredCleanups();
+    const cleanupSteps = [
+        // Config state - CRITICAL for test isolation
+        {
+            label: "config cache cleanup",
+            task: async () => {
+                const { clearConfigCache } = await import("../config/loader.js");
+                clearConfigCache();
+            },
+        },
+        {
+            label: "environment config cleanup",
+            task: async () => {
+                const { _resetEnvironmentConfig } = await import("../config/environment-config.js");
+                _resetEnvironmentConfig();
+            },
+        },
+        {
+            label: "runtime config cleanup",
+            task: async () => {
+                const { _resetRuntimeConfig } = await import("../config/runtime-config.js");
+                _resetRuntimeConfig();
+            },
+        },
+        // Layout discovery cache - prevents stale layouts across tests
+        {
+            label: "layout discovery cleanup",
+            task: async () => {
+                const { clearLayoutDiscoveryCache } = await import("../rendering/layouts/utils/discovery.js");
+                clearLayoutDiscoveryCache();
+            },
+        },
+        // SSR module caches
+        {
+            label: "SSR module cache cleanup",
+            task: async () => {
+                const { clearSSRModuleCache } = await import("../modules/index.js");
+                clearSSRModuleCache();
+            },
+        },
+        // React cache and compat hooks
+        {
+            label: "React cache cleanup",
+            task: async () => {
+                const { resetReactCache } = await import("../react/compat/ssr-adapter/server-loader.js");
+                resetReactCache();
+            },
+        },
+        {
+            label: "compat hooks cleanup",
+            task: async () => {
+                const { resetCompatHooksContext } = await import("../react/compat/hooks-adapter.js");
+                resetCompatHooksContext();
+            },
+        },
+        // Snippet cache
+        {
+            label: "snippet cache cleanup",
+            task: async () => {
+                const { clearSnippetCache } = await import("../rendering/snippet-renderer.js");
+                clearSnippetCache();
+            },
+        },
+        // API handler state
+        {
+            label: "API handler cleanup",
+            task: async () => {
+                const { resetApiHandler } = await import("../server/handlers/request/api/index.js");
+                await resetApiHandler();
+            },
+        },
+        // Reload notifier
+        {
+            label: "reload notifier cleanup",
+            task: async () => {
+                const { ReloadNotifier } = await import("../server/reload-notifier.js");
+                ReloadNotifier.reset();
+            },
+        },
+        // HTTP module in-flight fetches - prevents test interference from shared promises
+        {
+            label: "HTTP in-flight fetch cleanup",
+            task: async () => {
+                const { __clearInFlightHttpFetches } = await import("../transforms/esm/http-cache.js");
+                __clearInFlightHttpFetches();
+            },
+        },
+    ];
+    await runBestEffortCleanups(cleanupSteps);
+    // Bun-specific cleanup
+    if (isBun) {
+        await runBestEffortCleanups([
+            {
+                label: "bundler cleanup",
+                task: async () => {
+                    const { cleanupBundler } = await import("../rendering/cleanup.js");
+                    await cleanupBundler();
+                },
+            },
+        ]);
+    }
+}

package/esm/src/testing/timing.d.ts

@@ -0,0 +1,4 @@
+export declare function getTestTimeScale(): number;
+export declare function scaleMs(ms: number, minMs?: number): number;
+export declare function testDelay(ms: number): Promise<void>;
+//# sourceMappingURL=timing.d.ts.map

package/esm/src/testing/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/src/testing/timing.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAErD;AAGD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnD"}

package/esm/src/testing/timing.js

@@ -0,0 +1,22 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { getEnv } from "../platform/compat/process.js";
+const DEFAULT_SCALE = 1;
+function readScale() {
+    const raw = getEnv("VF_TEST_TIME_SCALE");
+    if (!raw)
+        return DEFAULT_SCALE;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return DEFAULT_SCALE;
+    return parsed;
+}
+export function getTestTimeScale() {
+    return readScale();
+}
+export function scaleMs(ms, minMs = 1) {
+    return Math.max(minMs, Math.round(ms * readScale()));
+}
+// no cleanup needed: one-shot
+export function testDelay(ms) {
+    return new Promise((resolve) => dntShim.setTimeout(resolve, scaleMs(ms)));
+}

package/esm/src/testing/utils.d.ts

@@ -0,0 +1,6 @@
+/***********************
+ * Shared utility functions for cross-runtime testing.
+ ***********************/
+export declare function deepEquals(a: unknown, b: unknown, seen?: WeakSet<object>): boolean;
+export declare function safeStringify(value: unknown): string;
+//# sourceMappingURL=utils.d.ts.map

package/esm/src/testing/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/testing/utils.ts"],"names":[],"mappings":"AAAA;;yBAEyB;AAEzB,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,GAAG,OAAO,CA0BjG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD"}

package/esm/src/testing/utils.js

@@ -0,0 +1,49 @@
+/***********************
+ * Shared utility functions for cross-runtime testing.
+ ***********************/
+export function deepEquals(a, b, seen = new WeakSet()) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return a === b;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== "object")
+        return a === b;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b))
+            return false;
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, i) => deepEquals(val, b[i], seen));
+    }
+    const aObj = a;
+    const bObj = b;
+    if (seen.has(aObj))
+        return true;
+    seen.add(aObj);
+    const aKeys = Object.keys(aObj);
+    const bKeys = Object.keys(bObj);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    const aRec = a;
+    const bRec = b;
+    return aKeys.every((key) => deepEquals(aRec[key], bRec[key], seen));
+}
+export function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch (_) {
+        /* expected: value may contain circular references or non-serializable types */
+        if (value === null)
+            return "null";
+        if (value === undefined)
+            return "undefined";
+        if (typeof value === "function")
+            return "[Function]";
+        if (typeof value === "object")
+            return `[${value.constructor?.name ?? "Object"}]`;
+        return String(value);
+    }
+}

package/esm/src/types/global-guards.d.ts

@@ -0,0 +1,11 @@
+export type { GlobalWithBun, GlobalWithDeno, GlobalWithProcess } from "../utils/index.js";
+export { hasBunRuntime, hasDenoRuntime, hasNodeProcess } from "../utils/index.js";
+export interface GlobalWithReactDOM {
+    ReactDOM?: typeof import("../../deps/esm.sh/react-dom@19.2.4/client.js");
+}
+export interface GlobalWithVeryFrontCache {
+    __VF_CACHE_NAMESPACE__?: string;
+}
+export declare function hasReactDOM(global: unknown): global is GlobalWithReactDOM;
+export declare function hasVeryFrontCache(global: unknown): global is GlobalWithVeryFrontCache;
+//# sourceMappingURL=global-guards.d.ts.map

package/esm/src/types/global-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-guards.d.ts","sourceRoot":"","sources":["../../../src/src/types/global-guards.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,cAAc,8CAA8C,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,wBAAwB;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,kBAAkB,CAIzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,wBAAwB,CAGrF"}

package/esm/src/types/global-guards.js

@@ -0,0 +1,12 @@
+export { hasBunRuntime, hasDenoRuntime, hasNodeProcess } from "../utils/index.js";
+export function hasReactDOM(global) {
+    if (typeof global !== "object" || global === null)
+        return false;
+    return "ReactDOM" in global &&
+        typeof global["ReactDOM"] !== "undefined";
+}
+export function hasVeryFrontCache(global) {
+    if (typeof global !== "object" || global === null)
+        return false;
+    return "__VF_CACHE_NAMESPACE__" in global;
+}

package/esm/src/utils/cache/keys/namespace.d.ts

@@ -0,0 +1,3 @@
+export declare function setCacheNamespace(namespace?: string): void;
+export declare function getCacheNamespace(): string | undefined;
+//# sourceMappingURL=namespace.d.ts.map

package/esm/src/utils/cache/keys/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../../../src/src/utils/cache/keys/namespace.ts"],"names":[],"mappings":"AAYA,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ1D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD"}

package/esm/src/utils/cache/keys/namespace.js

@@ -0,0 +1,19 @@
+import * as dntShim from "../../../../_dnt.shims.js";
+import { getEnv } from "../../../platform/compat/process.js";
+import { serverLogger } from "../../logger/logger.js";
+const logger = serverLogger.component("cache");
+const globalCache = dntShim.dntGlobalThis;
+let cacheNamespace = globalCache.__VF_CACHE_NAMESPACE__ ??
+    getEnv("VF_CACHE_NAMESPACE");
+export function setCacheNamespace(namespace) {
+    cacheNamespace = namespace ?? undefined;
+    try {
+        globalCache.__VF_CACHE_NAMESPACE__ = cacheNamespace;
+    }
+    catch (e) {
+        logger.debug("setCacheNamespace failed", e);
+    }
+}
+export function getCacheNamespace() {
+    return cacheNamespace;
+}

package/esm/src/utils/clsx.d.ts

@@ -2,13 +2,13 @@
  * Inline implementation of the `clsx` class-name joining utility.
  *
  * API-compatible with the MIT-licensed `clsx` npm package — this is a
- * clean-room rewrite against the public API (named `clsx` export, `ClassValue`
- * type, default export alias); no source was copied.
+ * clean-room rewrite against the public API surface veryfront uses (named
+ * `clsx` export and `ClassValue` type); no source was copied.
  *
  * Replaces the `clsx` npm dep per spec §8.3 (inline micro-utilities in core).
  */
 export type ClassValue = string | number | boolean | null | undefined | Record<string, unknown> | ClassValue[];
 type Value = ClassValue;
 export declare function clsx(...args: Value[]): string;
-export default clsx;
+export {};
 //# sourceMappingURL=clsx.d.ts.map

package/esm/src/utils/clsx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clsx.d.ts","sourceRoot":"","sources":["../../../src/src/utils/clsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,UAAU,EAAE,CAAC;AAEjB,KAAK,KAAK,GAAG,UAAU,CAAC;AAExB,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAgB7C;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"clsx.d.ts","sourceRoot":"","sources":["../../../src/src/utils/clsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,UAAU,EAAE,CAAC;AAEjB,KAAK,KAAK,GAAG,UAAU,CAAC;AAExB,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAgB7C"}

package/esm/src/utils/clsx.js

@@ -2,8 +2,8 @@
  * Inline implementation of the `clsx` class-name joining utility.
  *
  * API-compatible with the MIT-licensed `clsx` npm package — this is a
- * clean-room rewrite against the public API (named `clsx` export, `ClassValue`
- * type, default export alias); no source was copied.
+ * clean-room rewrite against the public API surface veryfront uses (named
+ * `clsx` export and `ClassValue` type); no source was copied.
  *
  * Replaces the `clsx` npm dep per spec §8.3 (inline micro-utilities in core).
  */
@@ -29,4 +29,3 @@ export function clsx(...args) {
     }
     return out.join(" ");
 }
-export default clsx;

package/esm/src/utils/mime-types.d.ts

@@ -33,10 +33,4 @@ export declare function charset(mime: string): string | false;
  * the same reason `lookup()` does (avoid prototype-property leaks).
  */
 export declare function extension(mime: string): string | false;
-declare const _default: {
-    lookup: typeof lookup;
-    charset: typeof charset;
-    extension: typeof extension;
-};
-export default _default;
 //# sourceMappingURL=mime-types.d.ts.map

package/esm/src/utils/mime-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mime-types.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mime-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsGH;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAInD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CASpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAEtD;;;;;;AAED,wBAA8C"}
+{"version":3,"file":"mime-types.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mime-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsGH;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAInD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CASpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAEtD"}

package/esm/src/utils/mime-types.js

@@ -145,4 +145,3 @@ export function charset(mime) {
 export function extension(mime) {
     return Object.hasOwn(EXT_BY_MIME, mime) ? EXT_BY_MIME[mime] : false;
 }
-export default { lookup, charset, extension };

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.324";
+export declare const VERSION = "0.1.327";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.324";
+export const VERSION = "0.1.327";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.324",
+  "version": "0.1.327",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -173,6 +173,18 @@
       "import": "./esm/src/extensions/interfaces/index.js",
       "types": "./esm/src/extensions/interfaces/index.d.ts"
     },
+    "./testing": {
+      "import": "./esm/src/testing/index.js",
+      "types": "./esm/src/testing/index.d.ts"
+    },
+    "./testing/assert": {
+      "import": "./esm/src/testing/assert.js",
+      "types": "./esm/src/testing/assert.d.ts"
+    },
+    "./testing/bdd": {
+      "import": "./esm/src/testing/bdd.js",
+      "types": "./esm/src/testing/bdd.d.ts"
+    },
     "./cli": {
       "import": "./esm/cli/main.js",
       "types": "./esm/cli/main.d.ts"
@@ -239,6 +251,7 @@
     "remark-gfm": "4.0.1",
     "remark-parse": "11.0.0",
     "remark-rehype": "11.1.2",
+    "scheduler": "0.27.0",
     "tailwind-merge": "3.5.0",
     "tailwindcss": "4.2.2",
     "unified": "11.0.5",

package/src/cli/commands/extension/init-command.ts

@@ -72,8 +72,8 @@ export default ${camelCase(name)};
  * @module extensions/${name}/test
  */
 
-import { assertEquals } from "#veryfront/testing/assert.ts";
-import { describe, it } from "#veryfront/testing/bdd.ts";
+import { assertEquals } from "veryfront/testing/assert";
+import { describe, it } from "veryfront/testing/bdd";
 import factory from "./index.ts";
 
 describe("${name} extension", () => {

package/src/cli/commands/extension/validate-command.ts

@@ -6,7 +6,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 
 
-import { validateExtension } from "../../../src/extensions/validation.js";
+import { validateExtension } from "../../../src/extensions/index.js";
 
 export interface ValidationReport {
   valid: boolean;

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.324",
+  "version": "0.1.327",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -63,6 +63,9 @@ export default {
     "./embedding": "./src/embedding/index.ts",
     "./extensions": "./src/extensions/index.ts",
     "./extensions/interfaces": "./src/extensions/interfaces/index.ts",
+    "./testing": "./src/testing/index.ts",
+    "./testing/assert": "./src/testing/assert.ts",
+    "./testing/bdd": "./src/testing/bdd.ts",
     "./cli": "./cli/main.ts",
     "./chat/conversation": "./src/chat/conversation.ts",
     "./chat/message-prep": "./src/chat/message-prep.ts",
@@ -137,6 +140,9 @@ export default {
     "veryfront/tool/schema": "./src/tool/schema/index.ts",
     "veryfront/agent/composition": "./src/agent/composition/index.ts",
     "veryfront/extensions": "./src/extensions/index.ts",
+    "veryfront/testing": "./src/testing/index.ts",
+    "veryfront/testing/assert": "./src/testing/assert.ts",
+    "veryfront/testing/bdd": "./src/testing/bdd.ts",
     "#veryfront": "./src/index.ts",
     "#veryfront/agent": "./src/agent/index.ts",
     "#veryfront/agent/react": "./src/agent/react/index.ts",
@@ -255,6 +261,7 @@ export default {
     "react/jsx-dev-runtime": "https://esm.sh/react@19.2.4/jsx-dev-runtime?external=react&target=es2022&deps=csstype@3.2.3",
     "@mdx-js/mdx": "npm:@mdx-js/mdx@3.1.1",
     "@mdx-js/react": "npm:@mdx-js/react@3.1.1",
+    "@babel/parser": "npm:@babel/parser@7.29.2",
     "unist-util-visit": "npm:unist-util-visit@5.1.0",
     "mdast-util-to-string": "npm:mdast-util-to-string@4.0.0",
     "github-slugger": "npm:github-slugger@2.0.0",

package/src/deps/esm.sh/@types/react-dom@19.2.3/client.d.ts

@@ -0,0 +1,105 @@
+/**
+ * WARNING: This entrypoint is only available starting with `react-dom@18.0.0-rc.1`
+ */
+
+// See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
+
+import React = require("https://esm.sh/@types/react@19.2.14/index.d.ts");
+
+export {};
+
+declare const REACT_FORM_STATE_SIGIL: unique symbol;
+export interface ReactFormState {
+    [REACT_FORM_STATE_SIGIL]: never;
+}
+
+export interface HydrationOptions {
+    formState?: ReactFormState | null;
+    /**
+     * Prefix for `useId`.
+     */
+    identifierPrefix?: string;
+    onUncaughtError?:
+        | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
+        | undefined;
+    onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void;
+    onCaughtError?:
+        | ((
+            error: unknown,
+            errorInfo: {
+                componentStack?: string | undefined;
+                errorBoundary?: React.Component<unknown> | undefined;
+            },
+        ) => void)
+        | undefined;
+}
+
+export interface RootOptions {
+    /**
+     * Prefix for `useId`.
+     */
+    identifierPrefix?: string;
+    onUncaughtError?:
+        | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
+        | undefined;
+    onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void;
+    onCaughtError?:
+        | ((
+            error: unknown,
+            errorInfo: {
+                componentStack?: string | undefined;
+                errorBoundary?: React.Component<unknown> | undefined;
+            },
+        ) => void)
+        | undefined;
+}
+
+export interface ErrorInfo {
+    componentStack?: string;
+}
+
+export interface Root {
+    render(children: React.ReactNode): void;
+    unmount(): void;
+}
+
+/**
+ * Different release channels declare additional types of ReactNode this particular release channel accepts.
+ * App or library types should never augment this interface.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS {}
+
+export type Container =
+    | Element
+    | DocumentFragment
+    | Document
+    | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS[
+        keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS
+    ];
+
+/**
+ * createRoot lets you create a root to display React components inside a browser DOM node.
+ *
+ * @see {@link https://react.dev/reference/react-dom/client/createRoot API Reference for `createRoot`}
+ */
+export function createRoot(container: Container, options?: RootOptions): Root;
+
+/**
+ * Same as `createRoot()`, but is used to hydrate a container whose HTML contents were rendered by ReactDOMServer.
+ *
+ * React will attempt to attach event listeners to the existing markup.
+ *
+ * **Example Usage**
+ *
+ * ```jsx
+ * hydrateRoot(document.querySelector('#root'), <App />)
+ * ```
+ *
+ * @see https://react.dev/reference/react-dom/client/hydrateRoot
+ */
+export function hydrateRoot(
+    container: Element | Document,
+    initialChildren: React.ReactNode,
+    options?: HydrationOptions,
+): Root;