@veryfront/ext-content-mdx 0.1.985

package/esm/src/platform/compat/process/runtime-process.js

@@ -0,0 +1,25 @@
+import * as dntShim from "../../../../_dnt.shims.js";
+import { getDenoRuntime, isDeno as IS_DENO } from "../runtime.js";
+const nodeProcess = dntShim.dntGlobalThis.process;
+/**
+ * Detect a real Node/Bun process object.
+ * Browser bundles may inject `window.process = { env: {} }`, which is not enough
+ * to safely call process APIs like cwd(), exit(), or on().
+ */
+export function testHasRuntimeProcess(processLike) {
+    if (!processLike || typeof processLike !== "object")
+        return false;
+    const versions = processLike.versions;
+    return typeof versions?.node === "string" && versions.node.length > 0;
+}
+export const runtimeProcess = testHasRuntimeProcess(nodeProcess)
+    ? nodeProcess
+    : null;
+export function isWindowsPlatform() {
+    const deno = IS_DENO ? getDenoRuntime() : undefined;
+    if (deno)
+        return deno.build.os === "windows";
+    const platform = runtimeProcess?.platform ??
+        dntShim.dntGlobalThis.process?.platform;
+    return platform === "win32";
+}

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

@@ -0,0 +1,5 @@
+export { deleteEnv, env, type EnvBooleanOptions, getEnv, getEnvBoolean, getEnvNumber, getEnvOverlayStorage, getEnvString, getHostEnv, setEnv, } from "./process/env.js";
+export { chdir, cwd, execPath, exit, getArgs, getOsType, getRuntimeVersion, getStdout, getTerminalSize, isInteractive, isStdoutTTY, memoryUsage, onGlobalError, onSignal, pid, promptSync, readStdinByteSync, unrefTimer, uptime, writeStdout, writeStdoutAsync, } from "./process/lifecycle.js";
+export { testHasRuntimeProcess } from "./process/runtime-process.js";
+export { type CommandOptions, type CommandResult, runCommand } from "./process/command.js";
+//# sourceMappingURL=process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/process.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,GAAG,EACH,KAAK,iBAAiB,EACtB,MAAM,EACN,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,EACL,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,GAAG,EACH,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { deleteEnv, env, getEnv, getEnvBoolean, getEnvNumber, getEnvOverlayStorage, getEnvString, getHostEnv, setEnv, } from "./process/env.js";
+export { chdir, cwd, execPath, exit, getArgs, getOsType, getRuntimeVersion, getStdout, getTerminalSize, isInteractive, isStdoutTTY, memoryUsage, onGlobalError, onSignal, pid, promptSync, readStdinByteSync, unrefTimer, uptime, writeStdout, writeStdoutAsync, } from "./process/lifecycle.js";
+export { testHasRuntimeProcess } from "./process/runtime-process.js";
+export { runCommand } from "./process/command.js";

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

@@ -0,0 +1,51 @@
+import * as dntShim from "../../../_dnt.shims.js";
+export declare function getDenoRuntime(): typeof dntShim.Deno | undefined;
+/**
+ * Check if an executable path is a compiled Deno binary.
+ * Detects by binary name: "deno" or "deno.exe" = standard runtime, anything else = compiled.
+ * @internal Exported for testing only.
+ */
+export declare function testDenoCompiledDetection(execPath: string): boolean;
+/** True if running in Bun runtime (check first since Bun has process.versions.node) */
+export declare const isBun: boolean;
+/** True if running in Node.js runtime (has process.versions.node, not Bun, not shimmed Deno) */
+export declare const isNode: boolean;
+/** True if running in real Deno runtime (not dnt shim) */
+export declare const isDeno: boolean;
+/**
+ * True if running in a compiled Deno binary.
+ * Compiled binaries cannot dynamically import HTTP URLs - they must use local file:// paths.
+ * This is evaluated once at module load time.
+ */
+export declare const isDenoCompiled: boolean;
+/** True if running in Cloudflare Workers runtime */
+export declare const isCloudflare: boolean;
+/**
+ * Detect if running in Node.js (vs Deno) at call time.
+ * Use this function instead of the constant when runtime detection needs to happen
+ * at call time (e.g., when bundled with esbuild's __esm lazy initialization pattern).
+ */
+export declare function isNodeRuntime(): boolean;
+/**
+ * Detect if code is executing in a server environment (SSR).
+ *
+ * This function provides consistent SSR detection that works correctly even when
+ * SSR globals stub the window/document objects. It should be used instead of
+ * `typeof window === "undefined"` checks to avoid hydration mismatches.
+ *
+ * Priority:
+ * 1. Check __VERYFRONT_SSR__ flag (set by ssr-globals/index.ts) - most reliable
+ * 2. Check if window is undefined (fallback for non-veryfront environments)
+ *
+ * @returns true if executing on server, false if in browser
+ * @see plans/architecture-audit/006.1-ssr-detection-inconsistencies.md
+ */
+export declare function isServerEnvironment(): boolean;
+/**
+ * Detect if code is executing in a browser environment.
+ * Inverse of isServerEnvironment() - use this instead of `typeof window !== "undefined"`.
+ *
+ * @returns true if executing in browser, false if on server
+ */
+export declare function isBrowserEnvironment(): boolean;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAelD,wBAAgB,cAAc,IAAI,OAAO,OAAO,CAAC,IAAI,GAAG,SAAS,CAWhE;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOnE;AAmBD,uFAAuF;AACvF,eAAO,MAAM,KAAK,EAAE,OAAwB,CAAC;AAE7C,gGAAgG;AAChG,eAAO,MAAM,MAAM,EAAE,OAAoC,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,MAAM,EAAE,OAA4C,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAA0C,CAAC;AAExE,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,OAAgC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

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

@@ -0,0 +1,101 @@
+import * as dntShim from "../../../_dnt.shims.js";
+function hasNodeProcess() {
+    const global = dntShim.dntGlobalThis;
+    return global.process?.versions?.node != null && !global.process?.versions?.deno;
+}
+function hasBunGlobal() {
+    return dntShim.dntGlobalThis.Bun != null;
+}
+export function getDenoRuntime() {
+    const deno = Reflect.get(dntShim.dntGlobalThis, "Deno");
+    if (deno &&
+        typeof deno.version === "object" &&
+        typeof deno.build === "object" &&
+        typeof deno.build.os === "string") {
+        return deno;
+    }
+    return undefined;
+}
+function hasRealDeno() {
+    return getDenoRuntime() != null;
+}
+/**
+ * Check if an executable path is a compiled Deno binary.
+ * Detects by binary name: "deno" or "deno.exe" = standard runtime, anything else = compiled.
+ * @internal Exported for testing only.
+ */
+export function testDenoCompiledDetection(execPath) {
+    if (!execPath)
+        return false;
+    const binaryName = execPath.split(/[/\\]/).pop()?.toLowerCase();
+    if (!binaryName)
+        return false;
+    return binaryName !== "deno" && binaryName !== "deno.exe";
+}
+/** Compiled Deno binaries cannot dynamically import HTTP URLs at runtime. */
+function isDenoCompiledBinary() {
+    const deno = getDenoRuntime();
+    if (!deno)
+        return false;
+    try {
+        return testDenoCompiledDetection(deno.execPath());
+    }
+    catch (_) {
+        /* expected: Deno.execPath() may not be available in all environments */
+        return false;
+    }
+}
+function hasCloudflareGlobals() {
+    return "caches" in dntShim.dntGlobalThis && "WebSocketPair" in dntShim.dntGlobalThis;
+}
+/** True if running in Bun runtime (check first since Bun has process.versions.node) */
+export const isBun = hasBunGlobal();
+/** True if running in Node.js runtime (has process.versions.node, not Bun, not shimmed Deno) */
+export const isNode = !isBun && hasNodeProcess();
+/** True if running in real Deno runtime (not dnt shim) */
+export const isDeno = !isNode && !isBun && hasRealDeno();
+/**
+ * True if running in a compiled Deno binary.
+ * Compiled binaries cannot dynamically import HTTP URLs - they must use local file:// paths.
+ * This is evaluated once at module load time.
+ */
+export const isDenoCompiled = isDeno && isDenoCompiledBinary();
+/** True if running in Cloudflare Workers runtime */
+export const isCloudflare = hasCloudflareGlobals();
+/**
+ * Detect if running in Node.js (vs Deno) at call time.
+ * Use this function instead of the constant when runtime detection needs to happen
+ * at call time (e.g., when bundled with esbuild's __esm lazy initialization pattern).
+ */
+export function isNodeRuntime() {
+    return !hasBunGlobal() && hasNodeProcess();
+}
+/**
+ * Detect if code is executing in a server environment (SSR).
+ *
+ * This function provides consistent SSR detection that works correctly even when
+ * SSR globals stub the window/document objects. It should be used instead of
+ * `typeof window === "undefined"` checks to avoid hydration mismatches.
+ *
+ * Priority:
+ * 1. Check __VERYFRONT_SSR__ flag (set by ssr-globals/index.ts) - most reliable
+ * 2. Check if window is undefined (fallback for non-veryfront environments)
+ *
+ * @returns true if executing on server, false if in browser
+ * @see plans/architecture-audit/006.1-ssr-detection-inconsistencies.md
+ */
+export function isServerEnvironment() {
+    const ssrFlag = dntShim.dntGlobalThis.__VERYFRONT_SSR__;
+    if (ssrFlag === true)
+        return true;
+    return typeof dntShim.dntGlobalThis === "undefined";
+}
+/**
+ * Detect if code is executing in a browser environment.
+ * Inverse of isServerEnvironment() - use this instead of `typeof window !== "undefined"`.
+ *
+ * @returns true if executing in browser, false if on server
+ */
+export function isBrowserEnvironment() {
+    return !isServerEnvironment();
+}

package/esm/src/platform/compat/std/front-matter-yaml.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Portable @std/front-matter/yaml shim.
+ *
+ * @module
+ */
+export interface Extract<T> {
+    attrs: T;
+    body: string;
+    frontMatter: string;
+}
+export declare function extract<T = Record<string, unknown>>(text: string): Extract<T>;
+export declare function test(text: string): boolean;
+//# sourceMappingURL=front-matter-yaml.d.ts.map

package/esm/src/platform/compat/std/front-matter-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-matter-yaml.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/std/front-matter-yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAkB7E;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1C"}

package/esm/src/platform/compat/std/front-matter-yaml.js

@@ -0,0 +1,28 @@
+/**
+ * Portable @std/front-matter/yaml shim.
+ *
+ * @module
+ */
+import { parse } from "../../../../deps/jsr.io/@std/yaml/1.1.0/parse.js";
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)(?:\r?\n)?---(?:\r?\n|$)([\s\S]*)$/;
+export function extract(text) {
+    const match = text.match(FRONTMATTER_RE);
+    if (!match) {
+        return {
+            attrs: {},
+            body: text,
+            frontMatter: "",
+        };
+    }
+    const frontMatter = match[1] ?? "";
+    const parsed = frontMatter.trim() ? parse(frontMatter) : {};
+    const attrs = (parsed && typeof parsed === "object" ? parsed : {});
+    return {
+        attrs,
+        body: match[2] ?? "",
+        frontMatter,
+    };
+}
+export function test(text) {
+    return /^---\r?\n/.test(text);
+}

package/esm/src/transforms/import-rewriter/url-builder.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Canonical URL builders for import rewriting.
+ *
+ * Single source of truth for all URL generation.
+ * Ensures consistent URLs across SSR and browser for hydration parity.
+ */
+/**
+ * Default React version - used when not specified.
+ *
+ * MUST match the React version the build bundles (see `react/deno.json`),
+ * because veryfront's framework React re-export is generated against that
+ * version and references its named exports. A drift guard in
+ * `src/utils/constants/cdn.test.ts` enforces this.
+ */
+export declare const DEFAULT_REACT_VERSION = "19.2.4";
+/** Tailwind CSS version */
+export declare const TAILWIND_VERSION = "4.1.8";
+/** csstype version - must match deno.json for type consistency */
+export declare const CSSTYPE_VERSION = "3.2.3";
+type EsmShOptions = {
+    external?: string[];
+    target?: string;
+    deps?: Record<string, string>;
+};
+/**
+ * Build esm.sh URL with proper configuration.
+ *
+ * @param pkg - Package name (e.g., "react", "lodash")
+ * @param version - Package version (optional)
+ * @param subpath - Subpath (e.g., "/jsx-runtime")
+ * @param options - URL options
+ */
+export declare function buildEsmShUrl(pkg: string, version?: string, subpath?: string, options?: EsmShOptions): string;
+/**
+ * Build React esm.sh URL.
+ * Uses deps=csstype for type consistency.
+ */
+export declare function buildReactUrl(pkg: "react" | "react-dom", version: string, subpath?: string, external?: boolean): string;
+/**
+ * Get complete React import map for a specific version.
+ */
+export declare function getReactImportMap(version: string): Record<string, string>;
+/**
+ * Build module server URL for a path.
+ */
+export declare function buildModuleServerUrl(baseUrl: string, path: string): string;
+/**
+ * Build cross-project import URL.
+ */
+export declare function buildCrossProjectUrl(projectSlug: string, version: string | null, path: string): string;
+/**
+ * Build veryfront framework module URL.
+ */
+export declare function buildVeryfrontModuleUrl(path: string): string;
+/**
+ * Normalize file extension for JavaScript output.
+ */
+export declare function normalizeExtension(path: string, options?: {
+    removeExtension?: boolean;
+}): string;
+/**
+ * Check if a URL is an esm.sh URL.
+ */
+export declare function isEsmShUrl(url: string): boolean;
+/**
+ * Add deps query param to esm.sh URL if not already present.
+ */
+export declare function addEsmShDeps(url: string, reactVersion: string): string;
+export {};
+//# sourceMappingURL=url-builder.d.ts.map

package/esm/src/transforms/import-rewriter/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/import-rewriter/url-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAE9C,2BAA2B;AAC3B,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,kEAAkE;AAClE,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACf,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGhG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAgDtE"}

package/esm/src/transforms/import-rewriter/url-builder.js

@@ -0,0 +1,152 @@
+/**
+ * Canonical URL builders for import rewriting.
+ *
+ * Single source of truth for all URL generation.
+ * Ensures consistent URLs across SSR and browser for hydration parity.
+ */
+/**
+ * Default React version - used when not specified.
+ *
+ * MUST match the React version the build bundles (see `react/deno.json`),
+ * because veryfront's framework React re-export is generated against that
+ * version and references its named exports. A drift guard in
+ * `src/utils/constants/cdn.test.ts` enforces this.
+ */
+export const DEFAULT_REACT_VERSION = "19.2.4";
+/** Tailwind CSS version */
+export const TAILWIND_VERSION = "4.1.8";
+/** csstype version - must match deno.json for type consistency */
+export const CSSTYPE_VERSION = "3.2.3";
+/**
+ * Build esm.sh URL with proper configuration.
+ *
+ * @param pkg - Package name (e.g., "react", "lodash")
+ * @param version - Package version (optional)
+ * @param subpath - Subpath (e.g., "/jsx-runtime")
+ * @param options - URL options
+ */
+export function buildEsmShUrl(pkg, version, subpath, options) {
+    const params = [];
+    if (options?.external?.length) {
+        params.push(`external=${options.external.join(",")}`);
+    }
+    params.push(`target=${options?.target ?? "es2022"}`);
+    if (options?.deps) {
+        const depsStr = Object.entries(options.deps)
+            .map(([k, v]) => `${k}@${v}`)
+            .join(",");
+        params.push(`deps=${depsStr}`);
+    }
+    const versionStr = version ? `@${version}` : "";
+    const pathStr = subpath ?? "";
+    const queryStr = params.length ? `?${params.join("&")}` : "";
+    return `https://esm.sh/${pkg}${versionStr}${pathStr}${queryStr}`;
+}
+/**
+ * Build React esm.sh URL.
+ * Uses deps=csstype for type consistency.
+ */
+export function buildReactUrl(pkg, version, subpath, external = false) {
+    return buildEsmShUrl(pkg, version, subpath, {
+        external: external ? ["react"] : undefined,
+        deps: { csstype: CSSTYPE_VERSION },
+    });
+}
+/**
+ * Get complete React import map for a specific version.
+ */
+export function getReactImportMap(version) {
+    return {
+        react: buildReactUrl("react", version),
+        "react-dom": buildReactUrl("react-dom", version, undefined, true),
+        "react-dom/client": buildReactUrl("react-dom", version, "/client", true),
+        "react-dom/server": buildReactUrl("react-dom", version, "/server", true),
+        "react/jsx-runtime": buildReactUrl("react", version, "/jsx-runtime", true),
+        "react/jsx-dev-runtime": buildReactUrl("react", version, "/jsx-dev-runtime", true),
+        // Prefix match for any react/* subpath imports
+        "react/": buildReactUrl("react", version, "/", true),
+    };
+}
+/**
+ * Build module server URL for a path.
+ */
+export function buildModuleServerUrl(baseUrl, path) {
+    const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${normalizedBase}${normalizedPath}`;
+}
+/**
+ * Build cross-project import URL.
+ */
+export function buildCrossProjectUrl(projectSlug, version, path) {
+    const modulePath = /\.(js|mjs|jsx|ts|tsx|mdx)$/.test(path) ? path : `${path}.tsx`;
+    const projectRef = version && version !== "latest" ? `${projectSlug}@${version}` : projectSlug;
+    return `/_vf_modules/_cross/${projectRef}/@/${modulePath}`;
+}
+/**
+ * Build veryfront framework module URL.
+ */
+export function buildVeryfrontModuleUrl(path) {
+    const normalizedPath = path.replace(/\.(tsx?|jsx)$/, ".js");
+    return `/_vf_modules/_veryfront/${normalizedPath}`;
+}
+/**
+ * Normalize file extension for JavaScript output.
+ */
+export function normalizeExtension(path, options) {
+    if (options?.removeExtension)
+        return path.replace(/\.(tsx?|jsx|mdx)$/, "");
+    return path.replace(/\.(tsx?|jsx|mdx)$/, ".js");
+}
+/**
+ * Check if a URL is an esm.sh URL.
+ */
+export function isEsmShUrl(url) {
+    return url.startsWith("https://esm.sh/") || url.startsWith("http://esm.sh/");
+}
+/**
+ * Add deps query param to esm.sh URL if not already present.
+ */
+export function addEsmShDeps(url, reactVersion) {
+    if (!isEsmShUrl(url))
+        return url;
+    if (url.includes(`react@${reactVersion}`))
+        return url;
+    try {
+        const parsed = new URL(url);
+        const params = new URLSearchParams(parsed.search);
+        const externals = new Set();
+        for (const value of params.getAll("external")) {
+            for (const external of value.split(",")) {
+                const normalized = external.trim();
+                if (normalized)
+                    externals.add(normalized);
+            }
+        }
+        for (const external of ["react", "react-dom"]) {
+            if (params.has(external)) {
+                externals.add(external);
+                params.delete(external);
+            }
+            externals.add(external);
+        }
+        const orderedExternals = [
+            "react",
+            "react-dom",
+            ...Array.from(externals).filter((external) => external !== "react" && external !== "react-dom"),
+        ];
+        const target = params.get("target") ?? "es2022";
+        params.delete("external");
+        params.delete("target");
+        const query = [
+            `external=${orderedExternals.join(",")}`,
+            `target=${target}`,
+            ...Array.from(params.entries()).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`),
+        ].join("&");
+        return `${parsed.origin}${parsed.pathname}?${query}${parsed.hash}`;
+    }
+    catch (_) {
+        /* expected: malformed URL falls back to the original string */
+        return url;
+    }
+}

package/esm/src/transforms/md/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Markdown Preview Utilities
+ *
+ * Helpers for determining markdown preview mode and related checks.
+ *
+ * @module transforms/md/utils
+ */
+/**
+ * Check if a markdown file should be rendered with GitHub preview styles.
+ * Returns true for all .md files unless opted out via `prose: false` frontmatter.
+ * This includes both standalone files and routable pages (pages/, app/).
+ */
+export declare function isMarkdownPreview(_filePath: string | undefined, frontmatter?: Record<string, unknown>): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/esm/src/transforms/md/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/md/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAGT"}

package/esm/src/transforms/md/utils.js

@@ -0,0 +1,17 @@
+/**
+ * Markdown Preview Utilities
+ *
+ * Helpers for determining markdown preview mode and related checks.
+ *
+ * @module transforms/md/utils
+ */
+/**
+ * Check if a markdown file should be rendered with GitHub preview styles.
+ * Returns true for all .md files unless opted out via `prose: false` frontmatter.
+ * This includes both standalone files and routable pages (pages/, app/).
+ */
+export function isMarkdownPreview(_filePath, frontmatter) {
+    if (frontmatter?.prose === false)
+        return false;
+    return true;
+}

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.d.ts

@@ -0,0 +1,6 @@
+export interface FrontmatterExtractionResult {
+    body: string;
+    frontmatter: Record<string, unknown>;
+}
+export declare function extractFrontmatter(content: string, providedFrontmatter?: Record<string, unknown>): FrontmatterExtractionResult;
+//# sourceMappingURL=frontmatter-extractor.d.ts.map

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-extractor.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/frontmatter-extractor.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA0CD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,2BAA2B,CAc7B"}

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.js

@@ -0,0 +1,48 @@
+import { rendererLogger as logger } from "../../../utils/index.js";
+import { extract } from "../../../platform/compat/std/front-matter-yaml.js";
+function extractYamlFrontmatter(content) {
+    if (!content.trim().startsWith("---"))
+        return { body: content, frontmatter: {} };
+    const extracted = extract(content);
+    return {
+        body: extracted.body,
+        frontmatter: extracted.attrs,
+    };
+}
+function parseExportValue(rawValue) {
+    if (rawValue === "true")
+        return true;
+    if (rawValue === "false")
+        return false;
+    if (rawValue === "null")
+        return null;
+    if (/^\d+(?:\.\d+)?$/.test(rawValue))
+        return parseFloat(rawValue);
+    return rawValue.replace(/^['"`]|['"`]$/g, "");
+}
+function extractExportConstants(body) {
+    const exportRegex = /^export\s+const\s+(\w+)\s*=\s*(['"`][^'"`\n]*['"`]|\d+(?:\.\d+)?|true|false|null)\s*;?\s*$/gm;
+    const exports = {};
+    let cleanedBody = body;
+    let match;
+    while ((match = exportRegex.exec(body)) !== null) {
+        const key = match[1];
+        const rawValue = match[2];
+        if (!key || !rawValue)
+            continue;
+        exports[key] = parseExportValue(rawValue);
+        cleanedBody = cleanedBody.replace(match[0], "");
+    }
+    return { body: cleanedBody, exports };
+}
+export function extractFrontmatter(content, providedFrontmatter) {
+    const { body: yamlBody, frontmatter: yamlFrontmatter } = extractYamlFrontmatter(content);
+    const { body, exports } = extractExportConstants(yamlBody);
+    const frontmatter = {
+        ...yamlFrontmatter,
+        ...(providedFrontmatter ?? {}),
+        ...exports,
+    };
+    logger.debug("Extracted frontmatter:", frontmatter);
+    return { body, frontmatter };
+}

package/esm/src/transforms/mdx/compiler/import-rewriter.d.ts

@@ -0,0 +1,10 @@
+import type { CompilationTarget } from "veryfront/extensions/content";
+export interface ImportRewriterConfig {
+    filePath: string;
+    target: CompilationTarget;
+    baseUrl?: string;
+    projectDir?: string;
+}
+export declare function rewriteBodyImports(body: string, config: ImportRewriterConfig): string;
+export declare function rewriteCompiledImports(compiledCode: string, config: ImportRewriterConfig): string;
+//# sourceMappingURL=import-rewriter.d.ts.map

package/esm/src/transforms/mdx/compiler/import-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/import-rewriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8ED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAWrF;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAyBjG"}