@veryfront/ext-content-mdx 0.1.1186 → 0.1.1189

package/esm/src/platform/adapters/runtime/shared/watcher-queue.js

@@ -0,0 +1,75 @@
+export function createWatcherIterator(eventQueue, setResolver, isClosed, isAborted) {
+    let pendingResolve = null;
+    function isDone() {
+        return isClosed() || isAborted();
+    }
+    const doneResult = { done: true, value: undefined };
+    return {
+        next() {
+            if (isDone())
+                return Promise.resolve(doneResult);
+            const event = eventQueue.shift();
+            if (event)
+                return Promise.resolve({ done: false, value: event });
+            if (pendingResolve) {
+                return Promise.reject(new TypeError("FileWatcher does not support concurrent next() calls"));
+            }
+            return new Promise((resolve) => {
+                if (isDone()) {
+                    resolve(doneResult);
+                    return;
+                }
+                pendingResolve = resolve;
+                setResolver((result) => {
+                    pendingResolve = null;
+                    resolve(result);
+                });
+            });
+        },
+        return() {
+            setResolver(null);
+            pendingResolve?.(doneResult);
+            pendingResolve = null;
+            return Promise.resolve(doneResult);
+        },
+    };
+}
+export function enqueueWatchEvent(event, eventQueue, getResolver, setResolver) {
+    const resolver = getResolver();
+    if (!resolver) {
+        eventQueue.push(event);
+        return;
+    }
+    setResolver(null);
+    resolver({ done: false, value: event });
+}
+export function createFileWatcher(iterator, cleanup) {
+    let closed = false;
+    const cleanupOnce = () => {
+        if (closed)
+            return;
+        closed = true;
+        cleanup();
+    };
+    const wrappedIterator = {
+        next: () => iterator.next(),
+        async return(value) {
+            cleanupOnce();
+            if (iterator.return)
+                return await iterator.return(value);
+            return { done: true, value: undefined };
+        },
+        async throw(error) {
+            cleanupOnce();
+            if (iterator.throw)
+                return await iterator.throw(error);
+            throw error;
+        },
+    };
+    return {
+        [Symbol.asyncIterator]() {
+            return wrappedIterator;
+        },
+        close: cleanupOnce,
+    };
+}

package/esm/src/platform/compat/abort-signal.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Captured AbortSignal operations for hostile JavaScript boundaries.
+ *
+ * Callers can shadow instance properties or mutate public prototypes after
+ * module initialization. These helpers validate the native brand and dispatch
+ * through captured intrinsics so cancellation cannot execute those hooks.
+ *
+ * @module
+ */
+/** Test the native AbortSignal brand without reading overridable properties. */
+export declare function isAbortSignalWithoutHooks(value: unknown): value is AbortSignal;
+/** Read cancellation state through the captured native getter. */
+export declare function isAbortSignalAborted(signal: AbortSignal): boolean;
+/** Read the native cancellation reason without consulting an own accessor. */
+export declare function getAbortSignalReason(signal: AbortSignal): unknown;
+/** Attach one native abort listener without consulting instance methods. */
+export declare function addAbortSignalListenerOnce(signal: AbortSignal, listener: () => void): void;
+/** Remove a native abort listener without consulting instance methods. */
+export declare function removeAbortSignalListener(signal: AbortSignal, listener: () => void): void;
+//# sourceMappingURL=abort-signal.d.ts.map

package/esm/src/platform/compat/abort-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/abort-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAc9E;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAKjE;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGjE;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAEN;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,IAAI,GACnB,IAAI,CAEN"}

package/esm/src/platform/compat/abort-signal.js

@@ -0,0 +1,64 @@
+/**
+ * Captured AbortSignal operations for hostile JavaScript boundaries.
+ *
+ * Callers can shadow instance properties or mutate public prototypes after
+ * module initialization. These helpers validate the native brand and dispatch
+ * through captured intrinsics so cancellation cannot execute those hooks.
+ *
+ * @module
+ */
+import { isProxyWithoutHooks } from "./error-introspection.js";
+const apply = Reflect.apply;
+const createObject = Object.create;
+const defineOwnProperty = Object.defineProperty;
+const freeze = Object.freeze;
+const getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+const NativeTypeError = TypeError;
+const abortSignalAbortedGetter = getOwnPropertyDescriptor(AbortSignal.prototype, "aborted")?.get;
+const abortSignalReasonGetter = getOwnPropertyDescriptor(AbortSignal.prototype, "reason")?.get;
+const eventTargetAddEventListener = EventTarget.prototype.addEventListener;
+const eventTargetRemoveEventListener = EventTarget.prototype.removeEventListener;
+const onceOptions = createObject(null);
+defineOwnProperty(onceOptions, "once", {
+    configurable: false,
+    enumerable: true,
+    value: true,
+    writable: false,
+});
+freeze(onceOptions);
+/** Test the native AbortSignal brand without reading overridable properties. */
+export function isAbortSignalWithoutHooks(value) {
+    if (value === null ||
+        (typeof value !== "object" && typeof value !== "function") ||
+        isProxyWithoutHooks(value) ||
+        typeof abortSignalAbortedGetter !== "function") {
+        return false;
+    }
+    try {
+        return typeof apply(abortSignalAbortedGetter, value, []) === "boolean";
+    }
+    catch {
+        return false;
+    }
+}
+/** Read cancellation state through the captured native getter. */
+export function isAbortSignalAborted(signal) {
+    if (typeof abortSignalAbortedGetter !== "function") {
+        throw new NativeTypeError("AbortSignal is unavailable in this runtime");
+    }
+    return apply(abortSignalAbortedGetter, signal, []);
+}
+/** Read the native cancellation reason without consulting an own accessor. */
+export function getAbortSignalReason(signal) {
+    if (typeof abortSignalReasonGetter !== "function")
+        return undefined;
+    return apply(abortSignalReasonGetter, signal, []);
+}
+/** Attach one native abort listener without consulting instance methods. */
+export function addAbortSignalListenerOnce(signal, listener) {
+    apply(eventTargetAddEventListener, signal, ["abort", listener, onceOptions]);
+}
+/** Remove a native abort listener without consulting instance methods. */
+export function removeAbortSignalListener(signal, listener) {
+    apply(eventTargetRemoveEventListener, signal, ["abort", listener]);
+}

package/esm/src/platform/compat/constants.d.ts

@@ -5,9 +5,9 @@
  * Note: config/defaults.ts re-exports DEFAULT_PORT for higher layers.
  */
 export declare const DEFAULT_PORT = 3000;
-export declare const LOCALHOST: {
+export declare const LOCALHOST: Readonly<{
     readonly IPV4: "127.0.0.1";
     readonly IPV6: "::1";
     readonly HOSTNAME: "localhost";
-};
+}>;
 //# sourceMappingURL=constants.d.ts.map

package/esm/src/platform/compat/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,SAAS;;;;CAIZ,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,SAAS;;;;EAMrB,CAAC"}

package/esm/src/platform/compat/constants.js

@@ -5,8 +5,8 @@
  * Note: config/defaults.ts re-exports DEFAULT_PORT for higher layers.
  */
 export const DEFAULT_PORT = 3000;
-export const LOCALHOST = {
+export const LOCALHOST = Object.freeze({
     IPV4: "127.0.0.1",
     IPV6: "::1",
     HOSTNAME: "localhost",
-};
+});

package/esm/src/platform/compat/error-introspection.d.ts

@@ -0,0 +1,37 @@
+/** True when own stack descriptors can be inspected without formatting them. */
+export declare const canInspectErrorStackDescriptorWithoutHooks: boolean;
+/**
+ * Read a native Error's stack without letting project code observe the read.
+ *
+ * Data-valued stacks are returned directly. An accessor is only invoked when it
+ * is the runtime's own getter, and then only with `Error.prepareStackTrace`
+ * shadowed; any other accessor fails closed rather than running foreign code.
+ *
+ * Materializing a lazy stack makes the runtime format the error header, which
+ * reads `name` and `message`. Both must therefore resolve to data properties,
+ * or the read is skipped rather than allowed to trigger a project accessor.
+ */
+export declare function readNativeErrorStackWithoutHooks(error: Error): string | undefined;
+/**
+ * Identify native Error values without evaluating project-owned Proxy traps.
+ */
+export declare function isNativeErrorWithoutHooks(value: unknown): value is Error;
+/**
+ * Read a native Error's display name without executing instance, prototype, or
+ * constructor accessors. Custom subclasses use their own data-valued
+ * prototype name or constructor name; unreadable/exotic shapes fail closed.
+ */
+export declare function readNativeErrorNameWithoutHooks(error: Error): string;
+/** Identify a Proxy without evaluating any trap on the proxied value. */
+export declare function isProxyWithoutHooks(value: unknown): boolean;
+/** Identify a genuine Uint8Array without evaluating project-owned hooks. */
+export declare function isUint8ArrayWithoutHooks(value: unknown): value is Uint8Array;
+/** Identify a genuine Promise across realms without reading instance fields. */
+export declare function isNativePromiseWithoutHooks(value: unknown): value is Promise<unknown>;
+/**
+ * Identify native and bound async functions across realms without invoking
+ * project hooks. The descriptor fallback is deliberately conservative because
+ * runtime brand checks do not recognize bound async functions.
+ */
+export declare function isNativeAsyncFunctionWithoutHooks(value: unknown): value is (...args: unknown[]) => Promise<unknown>;
+//# sourceMappingURL=error-introspection.d.ts.map

package/esm/src/platform/compat/error-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-introspection.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/error-introspection.ts"],"names":[],"mappings":"AA2HA,gFAAgF;AAChF,eAAO,MAAM,0CAA0C,SAA0C,CAAC;AAgClG;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAuBjF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAExE;AA6BD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAkBpE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAE5E;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAE3B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAgBnD"}

package/esm/src/platform/compat/error-introspection.js

@@ -0,0 +1,258 @@
+/**
+ * Runtime-compatible, no-hook value introspection.
+ *
+ * Node-compatible hosts expose internal-slot checks that do not consult
+ * mutable global constructors. Browser and edge imports must remain linkable
+ * even though those hosts do not provide `node:util/types`.
+ */
+import { nativeBrandChecks } from "./native-brand-checks.js";
+const createObject = Object.create;
+const defineProperty = Object.defineProperty;
+const getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+const getPrototypeOf = Object.getPrototypeOf;
+const objectHasOwnProperty = Object.prototype.hasOwnProperty;
+const deleteProperty = Reflect.deleteProperty;
+const apply = Reflect.apply;
+const NativeError = Error;
+const NativeAsyncFunctionPrototype = getPrototypeOf(async function () { });
+const toStringTagSymbol = Symbol.toStringTag;
+const unavailableBrandCheck = (_value) => false;
+const nativeAsyncFunctionBrandCheck = nativeBrandChecks?.isAsyncFunction ?? unavailableBrandCheck;
+const nativeErrorBrandCheck = nativeBrandChecks?.isNativeError ?? unavailableBrandCheck;
+const nativePromiseBrandCheck = nativeBrandChecks?.isPromise ?? unavailableBrandCheck;
+const nativeProxyBrandCheck = nativeBrandChecks?.isProxy ?? unavailableBrandCheck;
+const nativeUint8ArrayBrandCheck = nativeBrandChecks?.isUint8Array ?? unavailableBrandCheck;
+function hasOwn(object, key) {
+    return apply(objectHasOwnProperty, object, [key]);
+}
+function createDataDescriptor(value) {
+    const descriptor = createObject(null);
+    descriptor.configurable = true;
+    descriptor.enumerable = false;
+    descriptor.value = value;
+    descriptor.writable = true;
+    return descriptor;
+}
+function clonePropertyDescriptor(descriptor) {
+    const clone = createObject(null);
+    for (const key of [
+        "configurable",
+        "enumerable",
+        "get",
+        "set",
+        "value",
+        "writable",
+    ]) {
+        if (hasOwn(descriptor, key))
+            clone[key] = descriptor[key];
+    }
+    return clone;
+}
+/**
+ * Run `read` while an own `prepareStackTrace` data property shadows both own
+ * and inherited project hooks, so no user formatter observes or rewrites a
+ * stack the runtime materializes. The original descriptor is restored before
+ * returning. `restored` reports whether the shadow was removed again.
+ */
+function withShadowedStackFormatter(read) {
+    let originalFormatter;
+    try {
+        const descriptor = getOwnPropertyDescriptor(NativeError, "prepareStackTrace");
+        originalFormatter = descriptor ? clonePropertyDescriptor(descriptor) : undefined;
+    }
+    catch (_) {
+        return { value: undefined, restored: false };
+    }
+    let installed = false;
+    let restored = false;
+    let value;
+    try {
+        defineProperty(NativeError, "prepareStackTrace", createDataDescriptor(undefined));
+        installed = true;
+        value = read();
+    }
+    catch (_) {
+        // A non-configurable formatter or hostile runtime disables stack capture.
+    }
+    finally {
+        if (installed) {
+            try {
+                restored = originalFormatter
+                    ? (defineProperty(NativeError, "prepareStackTrace", originalFormatter), true)
+                    : deleteProperty(NativeError, "prepareStackTrace");
+            }
+            catch (_) {
+                restored = false;
+            }
+        }
+    }
+    return { value, restored };
+}
+/**
+ * Probe the runtime's actual stack-descriptor behavior without trusting a
+ * mutable version or feature flag, and capture the runtime's own stack getter.
+ *
+ * The getter is shared by every error the runtime creates, so its identity is
+ * what later distinguishes a runtime-installed accessor from one an attacker
+ * or an instrumentation layer defined on a specific error.
+ */
+function detectNativeErrorStackGetter() {
+    const probe = withShadowedStackFormatter(() => getOwnPropertyDescriptor(new NativeError(), "stack"));
+    const stackDescriptor = probe.value;
+    if (!probe.restored || !stackDescriptor || !hasOwn(stackDescriptor, "get")) {
+        return undefined;
+    }
+    const getter = stackDescriptor.get;
+    return typeof getter === "function" ? getter : undefined;
+}
+const NATIVE_ERROR_STACK_GETTER = detectNativeErrorStackGetter();
+/** True when own stack descriptors can be inspected without formatting them. */
+export const canInspectErrorStackDescriptorWithoutHooks = NATIVE_ERROR_STACK_GETTER !== undefined;
+const MAX_ERROR_PROTOTYPE_CHAIN_DEPTH = 100;
+/**
+ * True when `key` is absent or resolves to a data property across the whole
+ * prototype chain, so the runtime can read it without running project code.
+ */
+function resolvesWithoutAccessor(value, key) {
+    let current = value;
+    for (let depth = 0; current !== null && depth < MAX_ERROR_PROTOTYPE_CHAIN_DEPTH; depth++) {
+        if (nativeProxyBrandCheck(current))
+            return false;
+        let descriptor;
+        try {
+            descriptor = getOwnPropertyDescriptor(current, key);
+        }
+        catch (_) {
+            return false;
+        }
+        if (descriptor)
+            return hasOwn(descriptor, "value");
+        try {
+            current = getPrototypeOf(current);
+        }
+        catch (_) {
+            return false;
+        }
+    }
+    return current === null;
+}
+/**
+ * Read a native Error's stack without letting project code observe the read.
+ *
+ * Data-valued stacks are returned directly. An accessor is only invoked when it
+ * is the runtime's own getter, and then only with `Error.prepareStackTrace`
+ * shadowed; any other accessor fails closed rather than running foreign code.
+ *
+ * Materializing a lazy stack makes the runtime format the error header, which
+ * reads `name` and `message`. Both must therefore resolve to data properties,
+ * or the read is skipped rather than allowed to trigger a project accessor.
+ */
+export function readNativeErrorStackWithoutHooks(error) {
+    if (!NATIVE_ERROR_STACK_GETTER)
+        return undefined;
+    let descriptor;
+    try {
+        descriptor = getOwnPropertyDescriptor(error, "stack");
+    }
+    catch (_) {
+        return undefined;
+    }
+    if (!descriptor)
+        return undefined;
+    if (hasOwn(descriptor, "value")) {
+        return typeof descriptor.value === "string" ? descriptor.value : undefined;
+    }
+    if (descriptor.get !== NATIVE_ERROR_STACK_GETTER)
+        return undefined;
+    if (!resolvesWithoutAccessor(error, "message") ||
+        !resolvesWithoutAccessor(error, "name")) {
+        return undefined;
+    }
+    const stack = withShadowedStackFormatter(() => apply(NATIVE_ERROR_STACK_GETTER, error, [])).value;
+    return typeof stack === "string" ? stack : undefined;
+}
+/**
+ * Identify native Error values without evaluating project-owned Proxy traps.
+ */
+export function isNativeErrorWithoutHooks(value) {
+    return nativeErrorBrandCheck(value);
+}
+function readOwnDataString(value, key) {
+    const descriptor = getOwnPropertyDescriptor(value, key);
+    if (!descriptor || !hasOwn(descriptor, "value"))
+        return undefined;
+    return typeof descriptor.value === "string" && descriptor.value ? descriptor.value : undefined;
+}
+function readCustomErrorConstructorName(prototype) {
+    const constructorDescriptor = getOwnPropertyDescriptor(prototype, "constructor");
+    if (!constructorDescriptor ||
+        !hasOwn(constructorDescriptor, "value") ||
+        typeof constructorDescriptor.value !== "function" ||
+        nativeProxyBrandCheck(constructorDescriptor.value)) {
+        return undefined;
+    }
+    return readOwnDataString(constructorDescriptor.value, "name");
+}
+/**
+ * Read a native Error's display name without executing instance, prototype, or
+ * constructor accessors. Custom subclasses use their own data-valued
+ * prototype name or constructor name; unreadable/exotic shapes fail closed.
+ */
+export function readNativeErrorNameWithoutHooks(error) {
+    try {
+        const ownNameDescriptor = getOwnPropertyDescriptor(error, "name");
+        if (ownNameDescriptor) {
+            if (!hasOwn(ownNameDescriptor, "value"))
+                return "Error";
+            return typeof ownNameDescriptor.value === "string" && ownNameDescriptor.value
+                ? ownNameDescriptor.value
+                : "Error";
+        }
+        const prototype = getPrototypeOf(error);
+        if (prototype === null || nativeProxyBrandCheck(prototype))
+            return "Error";
+        return readOwnDataString(prototype, "name") ??
+            readCustomErrorConstructorName(prototype) ??
+            "Error";
+    }
+    catch (_) {
+        return "Error";
+    }
+}
+/** Identify a Proxy without evaluating any trap on the proxied value. */
+export function isProxyWithoutHooks(value) {
+    return nativeProxyBrandCheck(value);
+}
+/** Identify a genuine Uint8Array without evaluating project-owned hooks. */
+export function isUint8ArrayWithoutHooks(value) {
+    return nativeUint8ArrayBrandCheck(value);
+}
+/** Identify a genuine Promise across realms without reading instance fields. */
+export function isNativePromiseWithoutHooks(value) {
+    return nativePromiseBrandCheck(value);
+}
+/**
+ * Identify native and bound async functions across realms without invoking
+ * project hooks. The descriptor fallback is deliberately conservative because
+ * runtime brand checks do not recognize bound async functions.
+ */
+export function isNativeAsyncFunctionWithoutHooks(value) {
+    if (nativeAsyncFunctionBrandCheck(value))
+        return true;
+    if (typeof value !== "function" || nativeProxyBrandCheck(value))
+        return false;
+    try {
+        const prototype = getPrototypeOf(value);
+        if (prototype === NativeAsyncFunctionPrototype)
+            return true;
+        if (prototype === null || nativeProxyBrandCheck(prototype))
+            return false;
+        const tag = getOwnPropertyDescriptor(prototype, toStringTagSymbol);
+        return tag !== undefined &&
+            hasOwn(tag, "value") &&
+            tag.value === "AsyncFunction";
+    }
+    catch (_) {
+        return false;
+    }
+}

package/esm/src/platform/compat/fs.d.ts

@@ -1,15 +1,27 @@
 import type { FileInfo } from "../adapters/base.js";
-export { isNotFoundError } from "./not-found-error.js";
-/** Public API contract for file system. */
+import { isNotFoundError } from "./not-found-error.js";
+export { isNotFoundError };
+/** Stable native identity for one filesystem object. */
+export interface PathIdentity {
+    readonly device: string;
+    readonly inode: string;
+}
+/**
+ * Runtime-neutral filesystem contract.
+ *
+ * Operations reject filesystem failures. Callers that intentionally tolerate a
+ * missing path can classify the rejection with {@link isNotFoundError}.
+ */
 export interface FileSystem {
     readTextFile(path: string): Promise<string>;
     readFile(path: string): Promise<Uint8Array>;
+    /** Exact bounded binary read; implementations must reject oversized files before materializing them. */
     readFileBytesWithinLimit?(path: string, byteLimit: number): Promise<Uint8Array>;
     readFileSnapshotWithinLimit?(path: string, containmentRoot: string, byteLimit: number): Promise<Uint8Array>;
     writeTextFile(path: string, data: string): Promise<void>;
     writeFile(path: string, data: Uint8Array): Promise<void>;
-    /** Atomically replace a path when same-filesystem rename is supported. */
     createFileBytesExclusive?(path: string, data: Uint8Array): Promise<void>;
+    /** Atomically replace a path when same-filesystem rename is supported. */
     rename?(from: string, to: string): Promise<void>;
     exists(path: string): Promise<boolean>;
     stat(path: string): Promise<FileInfo>;
@@ -23,15 +35,18 @@ export interface FileSystem {
         isDirectory: boolean;
         isSymlink?: boolean;
     }>;
+    /** Remove a path, rejecting when it does not exist. */
     remove(path: string, options?: {
         recursive?: boolean;
     }): Promise<void>;
+    /** Atomically create a unique directory beneath the operating-system temp root. */
     makeTempDir(options?: {
         prefix?: string;
     }): Promise<string>;
+    /** Change permissions, rejecting operational failures. */
     chmod(path: string, mode: number): Promise<void>;
 }
-/** Create file system. */
+/** Create the runtime-native filesystem implementation. */
 export declare function createFileSystem(): FileSystem;
 /** Read a file as text. */
 export declare function readTextFile(path: string): Promise<string>;
@@ -41,17 +56,23 @@ export declare function readFile(path: string): Promise<Uint8Array>;
 export declare function writeTextFile(path: string, data: string): Promise<void>;
 /** Write bytes to a file. */
 export declare function writeFile(path: string, data: Uint8Array): Promise<void>;
-/** Check whether a path exists. */
+/** Return false for a missing path and propagate every other filesystem error. */
 export declare function exists(path: string): Promise<boolean>;
 /** Read file metadata. */
 export declare function stat(path: string): Promise<FileInfo>;
 /** Read file metadata without following a terminal symbolic link. */
 export declare function lstat(path: string): Promise<FileInfo>;
+/**
+ * Read a path's native device/inode identity without following a terminal
+ * symbolic link. Returns undefined only when the runtime cannot expose a
+ * stable identity for the backing filesystem.
+ */
+export declare function getPathIdentity(path: string): Promise<PathIdentity | undefined>;
 /** Create a directory. */
 export declare function mkdir(path: string, options?: {
     recursive?: boolean;
 }): Promise<void>;
-/** Remove a file or directory. */
+/** Remove a file or directory, rejecting when the path does not exist. */
 export declare function remove(path: string, options?: {
     recursive?: boolean;
 }): Promise<void>;
@@ -62,11 +83,11 @@ export declare function readDir(path: string): AsyncIterable<{
     isDirectory: boolean;
     isSymlink?: boolean;
 }>;
-/** Create temp dir. */
+/** Atomically create a unique directory beneath the operating-system temp root. */
 export declare function makeTempDir(options?: {
     prefix?: string;
 }): Promise<string>;
-/** Change file permissions. */
+/** Change file permissions, rejecting operational failures. */
 export declare function chmod(path: string, mode: number): Promise<void>;
 export declare function symlink(target: string, path: string): Promise<void>;
 /**

package/esm/src/platform/compat/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/fs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAUpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,CAAC;AAuB3B,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAqCD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,wGAAwG;IACxG,wBAAwB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChF,2BAA2B,CAAC,CAC1B,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,wBAAwB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,0EAA0E;IAC1E,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,OAAO,CACL,IAAI,EAAE,MAAM,GACX,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/F,uDAAuD;IACvD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,mFAAmF;IACnF,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAsUD,2DAA2D;AAC3D,wBAAgB,gBAAgB,IAAI,UAAU,CA2C7C;AASD,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;AAED,4BAA4B;AAC5B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1D;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,6BAA6B;AAC7B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErD;AAED,0BAA0B;AAC1B,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpD;AAED,qEAAqE;AACrE,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB3D;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CASrF;AAED,0BAA0B;AAC1B,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED,8BAA8B;AAC9B,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,GACX,aAAa,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,CAED;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5D;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY5D"}