@veryfront/ext-content-mdx 0.1.1183 → 0.1.1186

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

@@ -1,6 +1,9 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { createError, toError } from "../../errors/veryfront-error.js";
 import { isBun, isDeno, isNode } from "./runtime.js";
+import { readFileWithinLimit } from "../adapters/bounded-file-read.js";
+import { readNodeFileSnapshotWithinLimit, supportsNativeFileSnapshots, } from "../adapters/runtime/shared/native-file-capabilities.js";
+export { isNotFoundError } from "./not-found-error.js";
 /**
  * Typed accessor for the Deno global.
  *
@@ -13,6 +16,9 @@ function denoGlobal() {
     return dntShim.dntGlobalThis.Deno;
 }
 class NodeFileSystem {
+    readFileSnapshotWithinLimit = supportsNativeFileSnapshots()
+        ? (path, containmentRoot, byteLimit) => readNodeFileSnapshotWithinLimit(path, containmentRoot, byteLimit)
+        : undefined;
     fs;
     os;
     path;
@@ -60,6 +66,19 @@ class NodeFileSystem {
         await this.ensureInitialized();
         return this.getFs().readFile(path);
     }
+    async readFileBytesWithinLimit(path, byteLimit) {
+        await this.ensureInitialized();
+        return await readFileWithinLimit(async () => {
+            const handle = await this.getFs().open(path, "r");
+            return {
+                close: () => handle.close(),
+                read: async (buffer) => {
+                    const { bytesRead } = await handle.read(buffer, 0, buffer.byteLength, null);
+                    return bytesRead === 0 ? null : bytesRead;
+                },
+            };
+        }, byteLimit);
+    }
     async writeTextFile(path, data) {
         await this.ensureInitialized();
         await this.getFs().writeFile(path, data, { encoding: "utf8" });
@@ -68,6 +87,14 @@ class NodeFileSystem {
         await this.ensureInitialized();
         await this.getFs().writeFile(path, data);
     }
+    async createFileBytesExclusive(path, data) {
+        await this.ensureInitialized();
+        await this.getFs().writeFile(path, data, { flag: "wx" });
+    }
+    async rename(from, to) {
+        await this.ensureInitialized();
+        await this.getFs().rename(from, to);
+    }
     async exists(path) {
         await this.ensureInitialized();
         try {
@@ -142,18 +169,46 @@ class NodeFileSystem {
     }
 }
 class DenoFileSystem {
+    readFileSnapshotWithinLimit = supportsNativeFileSnapshots()
+        ? (path, containmentRoot, byteLimit) => readNodeFileSnapshotWithinLimit(path, containmentRoot, byteLimit)
+        : undefined;
     readTextFile(path) {
         return denoGlobal().readTextFile(path);
     }
     readFile(path) {
         return denoGlobal().readFile(path);
     }
+    async readFileBytesWithinLimit(path, byteLimit) {
+        return await readFileWithinLimit(async () => {
+            const file = await denoGlobal().open(path, { read: true });
+            return { close: () => file.close(), read: (buffer) => file.read(buffer) };
+        }, byteLimit);
+    }
     async writeTextFile(path, data) {
         await denoGlobal().writeTextFile(path, data);
     }
     async writeFile(path, data) {
         await denoGlobal().writeFile(path, data);
     }
+    async createFileBytesExclusive(path, data) {
+        const file = await denoGlobal().open(path, { write: true, createNew: true });
+        let offset = 0;
+        try {
+            while (offset < data.byteLength) {
+                const written = await file.write(data.subarray(offset));
+                if (!Number.isSafeInteger(written) || written <= 0 || written > data.byteLength - offset) {
+                    throw new Error("Deno exclusive create write made no forward progress");
+                }
+                offset += written;
+            }
+        }
+        finally {
+            file.close();
+        }
+    }
+    async rename(from, to) {
+        await denoGlobal().rename(from, to);
+    }
     async exists(path) {
         try {
             await denoGlobal().stat(path);
@@ -308,25 +363,6 @@ export async function realPath(path) {
     const fs = await import("node:fs/promises");
     return await fs.realpath(path);
 }
-/** Error shape for is not found. */
-export function isNotFoundError(error, seen = new Set()) {
-    if (seen.has(error))
-        return false;
-    seen.add(error);
-    const NotFound = dntShim.dntGlobalThis.Deno?.errors?.NotFound;
-    if (isDeno && NotFound && error instanceof NotFound)
-        return true;
-    if (error?.code === "ENOENT")
-        return true;
-    if (error instanceof Error && error.name === "VeryfrontError" &&
-        error.slug === "file-not-found") {
-        return true;
-    }
-    if (error instanceof Error && "cause" in error) {
-        return isNotFoundError(error.cause, seen);
-    }
-    return false;
-}
 /** Error shape for is already exists. */
 export function isAlreadyExistsError(error) {
     const AlreadyExists = dntShim.dntGlobalThis.Deno?.errors?.AlreadyExists;

package/esm/src/platform/compat/not-found-error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Return whether an error or its cause chain represents a path that cannot be
+ * resolved. ENOTDIR is included because a missing candidate beneath a file is
+ * just as absent as an ENOENT candidate during filesystem lookup.
+ */
+export declare function isNotFoundError(error: unknown, seen?: Set<unknown>): boolean;
+//# sourceMappingURL=not-found-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"not-found-error.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/not-found-error.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,GAAG,CAAC,OAAO,CAAa,GAAG,OAAO,CAuCvF"}

package/esm/src/platform/compat/not-found-error.js

@@ -0,0 +1,41 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { isDeno } from "./runtime.js";
+/**
+ * Return whether an error or its cause chain represents a path that cannot be
+ * resolved. ENOTDIR is included because a missing candidate beneath a file is
+ * just as absent as an ENOENT candidate during filesystem lookup.
+ */
+export function isNotFoundError(error, seen = new Set()) {
+    if (seen.has(error))
+        return false;
+    seen.add(error);
+    try {
+        const NotFound = dntShim.dntGlobalThis.Deno?.errors?.NotFound;
+        if (isDeno && NotFound && error instanceof NotFound)
+            return true;
+        const code = error?.code;
+        if (code === "ENOENT" || code === "ENOTDIR")
+            return true;
+        if (error instanceof Error) {
+            if (error.name === "VeryfrontError" &&
+                error.slug === "file-not-found") {
+                return true;
+            }
+            const legacyContext = error.context;
+            if (error.name === "VeryfrontError[file]" &&
+                typeof legacyContext === "object" &&
+                legacyContext !== null &&
+                legacyContext.type === "file" &&
+                typeof legacyContext.message === "string" &&
+                /^(?:File|Path) not found:/.test(legacyContext.message)) {
+                return true;
+            }
+            if ("cause" in error)
+                return isNotFoundError(error.cause, seen);
+        }
+    }
+    catch {
+        // Error classifiers must not replace the original filesystem failure.
+    }
+    return false;
+}

package/esm/src/platform/compat/path/basic-operations.d.ts

@@ -1,4 +1,4 @@
-/** Join path segments. */
+/** Join and normalize path segments using their detected path flavor. */
 export declare function join(...paths: string[]): string;
 /** Return the parent directory path. */
 export declare function dirname(path: string): string;

package/esm/src/platform/compat/path/basic-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-operations.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/basic-operations.ts"],"names":[],"mappings":"AAWA,0BAA0B;AAC1B,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAS/C;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB3D;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C"}
+{"version":3,"file":"basic-operations.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/basic-operations.ts"],"names":[],"mappings":"AAgBA,yEAAyE;AACzE,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ/C;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C"}

package/esm/src/platform/compat/path/basic-operations.js

@@ -1,56 +1,36 @@
-import { isDeno, nodePath } from "./runtime.js";
-function hasWindowsLikePath(path) {
-    return path.includes("\\") || /^[A-Za-z]:/.test(path) || path.startsWith("\\\\");
+import { hasWindowsLikePath, portableBasename, portableDirname, portableExtname, portableJoin, removeTrailingSeparatorsExceptRoot, runtimeUsesWindowsPaths, toPortableSeparators, } from "./portable.js";
+import { getNativePathImplementation } from "./runtime.js";
+function usesWindowsFlavor(paths) {
+    return runtimeUsesWindowsPaths() || paths.some(hasWindowsLikePath);
 }
-/** Normalize backslashes to forward slashes (for Deno on Windows). */
-function normSep(p) {
-    return p.includes("\\") ? p.replace(/\\/g, "/") : p;
-}
-/** Join path segments. */
+/** Join and normalize path segments using their detected path flavor. */
 export function join(...paths) {
-    const joined = paths
-        .map(normSep)
-        .filter((p) => p.length > 0)
-        .join("/")
-        .replace(/\/+/g, "/")
-        .replace(/\/$/, "");
-    return joined || "/";
+    if (paths.every((path) => path.length === 0))
+        return "/";
+    const windows = usesWindowsFlavor(paths);
+    const pathApi = getNativePathImplementation(windows);
+    const joined = pathApi
+        ? toPortableSeparators(pathApi.join(...paths))
+        : portableJoin(paths, windows);
+    return removeTrailingSeparatorsExceptRoot(joined, windows);
 }
 /** Return the parent directory path. */
 export function dirname(path) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(path))
-        return nodePath.dirname(path);
-    const p = normSep(path);
-    const lastSlash = p.lastIndexOf("/");
-    if (lastSlash === -1)
-        return ".";
-    if (lastSlash === 0)
-        return "/";
-    return p.slice(0, lastSlash);
+    const windows = usesWindowsFlavor([path]);
+    const pathApi = getNativePathImplementation(windows);
+    return pathApi ? toPortableSeparators(pathApi.dirname(path)) : portableDirname(path, windows);
 }
 /** Return the last path segment. */
 export function basename(path, ext) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(path)) {
-        // Only pass ext if defined - Bun is strict about this parameter
-        return ext === undefined ? nodePath.basename(path) : nodePath.basename(path, ext);
-    }
-    let normalizedPath = normSep(path);
-    while (normalizedPath.length > 1 && normalizedPath.endsWith("/")) {
-        normalizedPath = normalizedPath.slice(0, -1);
-    }
-    const lastSlash = normalizedPath.lastIndexOf("/");
-    let base = lastSlash === -1 ? normalizedPath : normalizedPath.slice(lastSlash + 1);
-    if (ext && base.endsWith(ext))
-        base = base.slice(0, -ext.length);
-    return base;
+    const windows = usesWindowsFlavor([path]);
+    const pathApi = getNativePathImplementation(windows);
+    if (!pathApi)
+        return portableBasename(path, ext, windows);
+    return ext === undefined ? pathApi.basename(path) : pathApi.basename(path, ext);
 }
 /** Return the file extension for a path. */
 export function extname(path) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(path))
-        return nodePath.extname(path);
-    const base = basename(path);
-    const lastDot = base.lastIndexOf(".");
-    if (lastDot <= 0)
-        return "";
-    return base.slice(lastDot);
+    const windows = usesWindowsFlavor([path]);
+    const pathApi = getNativePathImplementation(windows);
+    return pathApi?.extname(path) ?? portableExtname(path, windows);
 }

package/esm/src/platform/compat/path/index.d.ts

@@ -8,6 +8,7 @@ export { delimiter, hasNodePath, isDeno, nodePath, sep, sep as SEPARATOR } from
 export { basename, dirname, extname, join } from "./basic-operations.js";
 export { isAbsolute, normalize, relative, resolve } from "./resolution.js";
 export { format, parse } from "./parse-format.js";
+export { posix, type PosixPath } from "./posix.js";
 export { fromFileUrl, toFileUrl } from "./url-conversion.js";
 export { validatePathSecurity } from "./security.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/platform/compat/path/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/esm/src/platform/compat/path/index.js

@@ -7,5 +7,6 @@ export { delimiter, hasNodePath, isDeno, nodePath, sep, sep as SEPARATOR } from
 export { basename, dirname, extname, join } from "./basic-operations.js";
 export { isAbsolute, normalize, relative, resolve } from "./resolution.js";
 export { format, parse } from "./parse-format.js";
+export { posix } from "./posix.js";
 export { fromFileUrl, toFileUrl } from "./url-conversion.js";
 export { validatePathSecurity } from "./security.js";

package/esm/src/platform/compat/path/parse-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-format.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/parse-format.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAgB9C;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CASrD"}
+{"version":3,"file":"parse-format.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/parse-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAa9C;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAerD"}

package/esm/src/platform/compat/path/parse-format.js

@@ -1,26 +1,32 @@
-import { isDeno, nodePath } from "./runtime.js";
-import { basename, dirname, extname, join } from "./basic-operations.js";
-import { isAbsolute } from "./resolution.js";
+import { hasWindowsLikePath, portableFormat, portableParse, runtimeUsesWindowsPaths, toPortableSeparators, } from "./portable.js";
+import { getNativePathImplementation } from "./runtime.js";
 export function parse(path) {
-    if (!isDeno && nodePath) {
-        return nodePath.parse(path);
-    }
-    const dir = dirname(path);
-    const base = basename(path);
-    const ext = extname(path);
+    const windows = runtimeUsesWindowsPaths() || hasWindowsLikePath(path);
+    const pathApi = getNativePathImplementation(windows);
+    if (!pathApi)
+        return portableParse(path, windows);
+    const parsed = pathApi.parse(path);
     return {
-        root: isAbsolute(path) ? "/" : "",
-        dir,
-        base,
-        ext,
-        name: base.slice(0, base.length - ext.length),
+        root: toPortableSeparators(parsed.root ?? ""),
+        dir: toPortableSeparators(parsed.dir ?? ""),
+        base: parsed.base ?? "",
+        ext: parsed.ext ?? "",
+        name: parsed.name ?? "",
     };
 }
 export function format(pathObject) {
-    if (!isDeno && nodePath) {
-        return nodePath.format(pathObject);
-    }
-    const { dir = "", base = "", name = "", ext = "" } = pathObject;
-    const fileName = base || name + ext;
-    return dir ? join(dir, fileName) : fileName;
+    const windows = runtimeUsesWindowsPaths() ||
+        hasWindowsLikePath(pathObject.root ?? "") ||
+        hasWindowsLikePath(pathObject.dir ?? "");
+    const pathApi = getNativePathImplementation(windows);
+    if (!pathApi)
+        return portableFormat(pathObject, windows);
+    const formatted = pathApi.format({
+        root: pathObject.root ?? "",
+        dir: pathObject.dir ?? "",
+        base: pathObject.base ?? "",
+        ext: pathObject.ext ?? "",
+        name: pathObject.name ?? "",
+    });
+    return toPortableSeparators(formatted);
 }

package/esm/src/platform/compat/path/portable.d.ts

@@ -0,0 +1,16 @@
+import type { PathObject } from "./types.js";
+export declare function hasWindowsLikePath(path: string): boolean;
+export declare function toPortableSeparators(path: string): string;
+export declare function removeTrailingSeparatorsExceptRoot(path: string, windows: boolean): string;
+export declare function runtimeUsesWindowsPaths(): boolean;
+export declare function portableNormalize(path: string, windows: boolean): string;
+export declare function portableJoin(paths: readonly string[], windows: boolean): string;
+export declare function portableDirname(path: string, windows: boolean): string;
+export declare function portableBasename(path: string, ext: string | undefined, windows: boolean): string;
+export declare function portableExtname(path: string, windows: boolean): string;
+export declare function portableIsAbsolute(path: string, windows: boolean): boolean;
+export declare function portableResolve(paths: readonly string[], windows: boolean): string;
+export declare function portableRelative(from: string, to: string, windows: boolean): string;
+export declare function portableParse(path: string, windows: boolean): PathObject;
+export declare function portableFormat(pathObject: PathObject, windows: boolean): string;
+//# sourceMappingURL=portable.d.ts.map

package/esm/src/platform/compat/path/portable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/portable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS7C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAmFD,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,MAAM,CAUR;AAOD,wBAAgB,uBAAuB,IAAI,OAAO,CASjD;AAyBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAkBxE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAI/E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBtE;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,OAAO,GACf,MAAM,CAuCR;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAE1E;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,OAAO,GACf,MAAM,CAiCR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,GACf,MAAM,CA2BR;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAiCxE;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,GACf,MAAM,CAeR"}