@veryfront/ext-content-mdx 0.1.1182 → 0.1.1185

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

@@ -1,121 +1,37 @@
-import * as dntShim from "../../../../_dnt.shims.js";
-import { isDeno, nodePath } from "./runtime.js";
-function hasWindowsLikePath(path) {
-    return path.includes("\\") || /^[A-Za-z]:/.test(path) || path.startsWith("\\\\");
+import { hasWindowsLikePath, portableIsAbsolute, portableNormalize, portableRelative, portableResolve, 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;
-}
-/** Match Windows drive letter prefix like "C:/" */
-const DRIVE_LETTER = /^[A-Za-z]:\//;
-/** Resolve path segments to an absolute path. */
+/** Resolve path segments to an absolute, normalized path. */
 export function resolve(...paths) {
-    if (!isDeno && nodePath && !paths.some(hasWindowsLikePath))
-        return nodePath.resolve(...paths);
-    let resolvedPath = normSep(dntShim.dntGlobalThis.Deno?.cwd?.() ?? "/");
-    for (const rawPath of paths) {
-        if (!rawPath)
-            continue;
-        const path = normSep(rawPath);
-        if (path.startsWith("/") || DRIVE_LETTER.test(path)) {
-            resolvedPath = path;
-        }
-        else {
-            resolvedPath = `${resolvedPath}/${path}`;
-        }
-    }
-    // Preserve drive letter prefix (e.g. "D:/") if present
-    let prefix = "/";
-    const driveMatch = resolvedPath.match(DRIVE_LETTER);
-    if (driveMatch) {
-        prefix = driveMatch[0]; // e.g. "D:/"
-        resolvedPath = resolvedPath.slice(prefix.length);
-    }
-    else if (resolvedPath.startsWith("/")) {
-        resolvedPath = resolvedPath.slice(1);
-    }
-    const parts = resolvedPath.split("/").filter(Boolean);
-    const resolved = [];
-    for (const part of parts) {
-        if (part === "..") {
-            resolved.pop();
-            continue;
-        }
-        if (part !== ".")
-            resolved.push(part);
-    }
-    return `${prefix}${resolved.join("/")}`;
+    const windows = usesWindowsFlavor(paths);
+    const pathApi = getNativePathImplementation(windows);
+    return pathApi
+        ? toPortableSeparators(pathApi.resolve(...paths))
+        : portableResolve(paths, windows);
 }
 export function isAbsolute(path) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(path) && nodePath.isAbsolute(path))
-        return true;
-    // Cross-platform fallback: Unix, Windows drive letters, and UNC paths
-    if (path.startsWith("/"))
-        return true;
-    if (/^[A-Za-z]:[/\\]/.test(path))
-        return true;
-    return /^\\\\[^\\]+\\[^\\]+/.test(path);
+    const windows = usesWindowsFlavor([path]);
+    const pathApi = getNativePathImplementation(windows);
+    return pathApi?.isAbsolute(path) ?? portableIsAbsolute(path, windows);
 }
 export function relative(from, to) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(from) && !hasWindowsLikePath(to)) {
-        const relativePath = nodePath.relative(from, to);
-        return relativePath || ".";
-    }
-    const resolvedFrom = resolve(from);
-    const resolvedTo = resolve(to);
-    // Strip drive prefix for comparison (both will share the same drive after resolve)
-    const fromDrive = resolvedFrom.match(DRIVE_LETTER);
-    const fromBase = fromDrive ? resolvedFrom.slice(fromDrive[0].length) : resolvedFrom.slice(1);
-    const toDrive = resolvedTo.match(DRIVE_LETTER);
-    const toBase = toDrive ? resolvedTo.slice(toDrive[0].length) : resolvedTo.slice(1);
-    const fromParts = fromBase.split("/").filter(Boolean);
-    const toParts = toBase.split("/").filter(Boolean);
-    let common = 0;
-    const minLen = Math.min(fromParts.length, toParts.length);
-    for (let i = 0; i < minLen; i++) {
-        if (fromParts[i] !== toParts[i])
-            break;
-        common++;
-    }
-    const ups = fromParts.length - common;
-    const result = [...new Array(ups).fill(".."), ...toParts.slice(common)];
-    return result.join("/") || ".";
+    const windows = usesWindowsFlavor([from, to]);
+    const pathApi = getNativePathImplementation(windows);
+    const result = pathApi
+        ? toPortableSeparators(pathApi.relative(from, to))
+        : portableRelative(from, to, windows);
+    return result || ".";
 }
 export function normalize(path) {
-    if (!isDeno && nodePath && !hasWindowsLikePath(path))
-        return nodePath.normalize(path);
-    if (path === "")
-        return ".";
-    const p = normSep(path);
-    const abs = isAbsolute(p);
-    // Preserve drive letter prefix
-    let prefix = "";
-    const driveMatch = p.match(DRIVE_LETTER);
-    if (driveMatch) {
-        prefix = driveMatch[0];
-    }
-    else if (abs) {
-        prefix = "/";
-    }
-    const pathWithoutPrefix = driveMatch ? p.slice(prefix.length) : abs ? p.slice(1) : p;
-    const parts = pathWithoutPrefix.split("/").filter((s) => s && s !== ".");
-    const normalized = [];
-    for (const part of parts) {
-        if (part !== "..") {
-            normalized.push(part);
-            continue;
-        }
-        const last = normalized[normalized.length - 1];
-        if (normalized.length > 0 && last !== "..") {
-            normalized.pop();
-            continue;
-        }
-        if (!abs)
-            normalized.push("..");
-    }
-    const result = normalized.join("/");
-    if (abs)
-        return result ? `${prefix}${result}` : prefix || "/";
-    return result || ".";
+    const windows = usesWindowsFlavor([path]);
+    const pathApi = getNativePathImplementation(windows);
+    const normalized = pathApi
+        ? toPortableSeparators(pathApi.normalize(path))
+        : portableNormalize(path, windows);
+    // The established Veryfront facade contract returns canonical paths without
+    // a trailing separator, except for filesystem roots. Enforce that
+    // postcondition independently of whether the runtime supplies node:path.
+    return removeTrailingSeparatorsExceptRoot(normalized, windows);
 }

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

@@ -1,8 +1,9 @@
-import type { NodePathModule } from "./types.js";
+import type { NodePathModule, PathImplementation } from "./types.js";
 export declare const isDeno: boolean;
 declare let nodePath: NodePathModule | null;
 export { nodePath };
 export declare const sep: string;
 export declare const delimiter: string;
 export declare const hasNodePath: boolean;
+export declare function getNativePathImplementation(windows: boolean): PathImplementation | null;
 //# sourceMappingURL=runtime.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,eAAO,MAAM,MAAM,SAAsC,CAAC;AAE1D,QAAA,IAAI,QAAQ,EAAE,cAAc,GAAG,IAAW,CAAC;AAe3C,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,eAAO,MAAM,GAAG,QAAuB,CAAC;AACxC,eAAO,MAAM,SAAS,QAA6B,CAAC;AACpD,eAAO,MAAM,WAAW,SAAoB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrE,eAAO,MAAM,MAAM,SAAsC,CAAC;AAE1D,QAAA,IAAI,QAAQ,EAAE,cAAc,GAAG,IAAW,CAAC;AAe3C,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,eAAO,MAAM,GAAG,QAAuB,CAAC;AACxC,eAAO,MAAM,SAAS,QAA6B,CAAC;AACpD,eAAO,MAAM,WAAW,SAAoB,CAAC;AAE7C,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,GACf,kBAAkB,GAAG,IAAI,CAG3B"}

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

@@ -18,3 +18,8 @@ export { nodePath };
 export const sep = nodePath?.sep ?? "/";
 export const delimiter = nodePath?.delimiter ?? ":";
 export const hasNodePath = nodePath !== null;
+export function getNativePathImplementation(windows) {
+    if (!nodePath)
+        return null;
+    return windows ? nodePath.win32 : nodePath.posix;
+}

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

@@ -5,7 +5,7 @@ export interface PathObject {
     ext?: string;
     name?: string;
 }
-export interface NodePathModule {
+export interface PathImplementation {
     sep: string;
     delimiter: string;
     join(...paths: string[]): string;
@@ -19,4 +19,8 @@ export interface NodePathModule {
     parse(path: string): PathObject;
     format(pathObject: PathObject): string;
 }
+export interface NodePathModule extends PathImplementation {
+    posix: PathImplementation;
+    win32: PathImplementation;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;CAC3B"}

package/esm/src/platform/compat/path/url-conversion.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Convert a file URL to a runtime-native filesystem path.
+ *
+ * Local and `localhost` URLs are supported on every runtime. A non-local host
+ * becomes a UNC path on Windows; other runtimes reject it because no
+ * unambiguous local path representation exists.
+ *
+ * @throws {TypeError} If the URL is not a file URL, contains an encoded path
+ * separator, or names a non-local host on a non-Windows runtime.
+ */
 export declare function fromFileUrl(url: string | URL): string;
 export declare function toFileUrl(path: string): URL;
 //# sourceMappingURL=url-conversion.d.ts.map

package/esm/src/platform/compat/path/url-conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-conversion.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/url-conversion.ts"],"names":[],"mappings":"AA6BA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAwBrD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAS3C"}
+{"version":3,"file":"url-conversion.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/path/url-conversion.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAwBrD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAmB3C"}

package/esm/src/platform/compat/path/url-conversion.js

@@ -1,53 +1,75 @@
-import * as dntShim from "../../../../_dnt.shims.js";
-import { hasNodePath, isDeno } from "./runtime.js";
-import { isAbsolute, resolve } from "./resolution.js";
-let _fileURLToPath = null;
-function getFileURLToPath() {
-    if (_fileURLToPath)
-        return _fileURLToPath;
-    if (!hasNodePath)
-        return null;
-    try {
-        const nodeUrl = dntShim.dntGlobalThis.require?.("node:url");
-        const fileURLToPath = nodeUrl?.fileURLToPath;
-        if (!fileURLToPath)
-            return null;
-        _fileURLToPath = fileURLToPath;
-        return _fileURLToPath;
+import { posix } from "./posix.js";
+import { resolve } from "./resolution.js";
+import { runtimeUsesWindowsPaths } from "./portable.js";
+function decodeFilePath(pathname, windows) {
+    if (/%2f/i.test(pathname) || (windows && /%5c/i.test(pathname))) {
+        throw new TypeError("File URL path must not include encoded path separators");
     }
-    catch (_) {
-        /* expected: node:url require may fail in non-Node runtimes */
+    return decodeURIComponent(pathname);
+}
+function encodePath(path) {
+    // Match filesystem URL encoding: protect characters that URL parsing would
+    // interpret structurally while leaving valid path characters such as a
+    // drive-like colon untouched when it appears inside a POSIX path segment.
+    return path
+        .replaceAll("%", "%25")
+        .replaceAll("\\", "%5C")
+        .replaceAll("#", "%23")
+        .replaceAll("?", "%3F");
+}
+function parseUncPath(path) {
+    if (!runtimeUsesWindowsPaths() && !path.startsWith("\\\\"))
         return null;
-    }
+    const portable = path.replaceAll("\\", "/");
+    const match = portable.match(/^\/\/([^/]+)(\/.*)$/);
+    if (!match?.[1] || !match[2])
+        return null;
+    return { host: match[1], pathname: match[2] };
 }
+/**
+ * Convert a file URL to a runtime-native filesystem path.
+ *
+ * Local and `localhost` URLs are supported on every runtime. A non-local host
+ * becomes a UNC path on Windows; other runtimes reject it because no
+ * unambiguous local path representation exists.
+ *
+ * @throws {TypeError} If the URL is not a file URL, contains an encoded path
+ * separator, or names a non-local host on a non-Windows runtime.
+ */
 export function fromFileUrl(url) {
     const parsedUrl = typeof url === "string" ? new URL(url) : url;
     if (parsedUrl.protocol !== "file:") {
         throw new TypeError("Must be a file URL");
     }
-    const fileURLToPath = getFileURLToPath();
-    if (fileURLToPath)
-        return fileURLToPath(parsedUrl);
-    if (isDeno) {
-        const g = dntShim.dntGlobalThis;
-        const hasCwd = Boolean(g.Deno?.cwd);
-        const isWindows = g.Deno?.build?.os === "windows";
-        if (hasCwd && isWindows) {
-            return decodeURIComponent(parsedUrl.pathname)
-                .replace(/^\/([A-Za-z]:)/, "$1")
-                .replace(/\//g, "\\");
-        }
-        return decodeURIComponent(parsedUrl.pathname);
+    const windows = runtimeUsesWindowsPaths();
+    const host = parsedUrl.hostname;
+    if (host && host !== "localhost" && !windows) {
+        throw new TypeError("File URL host must be empty or localhost on non-Windows runtimes");
     }
-    return decodeURIComponent(parsedUrl.pathname);
+    const pathname = decodeFilePath(parsedUrl.pathname, windows);
+    if (host && host !== "localhost") {
+        return `\\\\${host}${pathname.replaceAll("/", "\\")}`;
+    }
+    if (!windows)
+        return pathname;
+    return pathname
+        .replace(/^\/([A-Za-z]:)/, "$1")
+        .replaceAll("/", "\\");
 }
 export function toFileUrl(path) {
-    const absolute = hasNodePath ? path : isAbsolute(path) ? path : resolve(path);
-    // Preserve filesystem characters that URL parsing would otherwise decode or
-    // interpret as fragment/query delimiters.
-    const encodedPath = absolute
-        .replaceAll("%", "%25")
-        .replaceAll("#", "%23")
-        .replaceAll("?", "%3F");
-    return new URL(`file://${encodedPath}`);
+    if (typeof path !== "string") {
+        throw new TypeError(`Path must be a string. Received ${typeof path}`);
+    }
+    const unc = parseUncPath(path);
+    if (unc) {
+        return new URL(`file://${unc.host}${encodePath(unc.pathname)}`);
+    }
+    const portable = path.replaceAll("\\", "/");
+    const drive = portable.match(/^([A-Za-z]:)(\/.*)?$/);
+    if (drive?.[1]) {
+        const pathname = drive[2] ?? "/";
+        return new URL(`file:///${drive[1]}${encodePath(pathname)}`);
+    }
+    const absolute = runtimeUsesWindowsPaths() ? resolve(path) : posix.resolve(path);
+    return new URL(`file://${encodePath(absolute)}`);
 }

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1182";
+export declare const VERSION = "0.1.1185";
 //# sourceMappingURL=version-constant.d.ts.map

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

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1182";
+export const VERSION = "0.1.1185";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veryfront/ext-content-mdx",
-  "version": "0.1.1182",
+  "version": "0.1.1185",
   "description": "Veryfront first-party extension package for ext-content-mdx",
   "keywords": [
     "veryfront",
@@ -67,7 +67,7 @@
     "vfile": "6.0.3"
   },
   "peerDependencies": {
-    "veryfront": "^0.1.1182"
+    "veryfront": "^0.1.1185"
   },
   "type": "module",
   "types": "./esm/extensions/ext-content-mdx/src/index.d.ts",