veryfront 0.1.369 → 0.1.370

package/esm/cli/commands/build/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EjE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFjE"}

package/esm/cli/commands/build/command.js

@@ -7,6 +7,7 @@ import { displayBuildConfig, displayBuildStart } from "./config-display.js";
 import { handleBuildError } from "./error-handler.js";
 import { displayBuildSuccess } from "./stats-display.js";
 import { isJsonMode, streamJsonLine } from "../../shared/json-output.js";
+import { ensureBuiltinContentTransformer } from "../../shared/ensure-content-transformer.js";
 export function buildCommand(options) {
     return withSpan("cli.command.build", async () => {
         const outputDir = options.outputDir ?? join(options.projectDir, "dist");
@@ -21,6 +22,7 @@ export function buildCommand(options) {
             }
             const adapter = await runtime.get();
             await getConfig(options.projectDir, adapter);
+            ensureBuiltinContentTransformer();
             if (isJsonMode()) {
                 streamJsonLine({ type: "step", name: "config", status: "completed" });
                 streamJsonLine({ type: "step", name: "build", status: "started" });

package/esm/cli/shared/ensure-content-transformer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The CLI ships ext-mdx baked in so the compiled binary can render MDX/Markdown
+ * pages out of the box. Library consumers (programmatic `startProductionServer`)
+ * still opt in via `veryfront.config.ts` extensions. Bootstrap's
+ * `setupAll → teardownAll → reset()` clears the contract registry, so this
+ * must run *after* the server-start (or `getConfig`) call returns. We skip
+ * registration when a user-provided extension already supplied the contract.
+ */
+export declare function ensureBuiltinContentTransformer(): void;
+//# sourceMappingURL=ensure-content-transformer.d.ts.map

package/esm/cli/shared/ensure-content-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-content-transformer.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/ensure-content-transformer.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/esm/cli/shared/ensure-content-transformer.js

@@ -0,0 +1,16 @@
+import { tryResolve } from "../../src/extensions/index.js";
+import { register } from "../../src/extensions/contracts.js";
+import { MdxContentTransformer } from "../../extensions/ext-mdx/src/index.js";
+/**
+ * The CLI ships ext-mdx baked in so the compiled binary can render MDX/Markdown
+ * pages out of the box. Library consumers (programmatic `startProductionServer`)
+ * still opt in via `veryfront.config.ts` extensions. Bootstrap's
+ * `setupAll → teardownAll → reset()` clears the contract registry, so this
+ * must run *after* the server-start (or `getConfig`) call returns. We skip
+ * registration when a user-provided extension already supplied the contract.
+ */
+export function ensureBuiltinContentTransformer() {
+    if (tryResolve("ContentTransformer"))
+        return;
+    register("ContentTransformer", new MdxContentTransformer());
+}

package/esm/cli/shared/server-startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-startup.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/server-startup.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,cAAc,EACd,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAoB5D;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CASrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAqB5D"}
+{"version":3,"file":"server-startup.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/server-startup.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,cAAc,EACd,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAsB5D;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAWrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAuB5D"}

package/esm/cli/shared/server-startup.js

@@ -1,5 +1,6 @@
 import { getEnv, runtime, setEnv } from "../../src/platform/index.js";
 import { startDevServer, startProductionServer, } from "../../src/server/index.js";
+import { ensureBuiltinContentTransformer } from "./ensure-content-transformer.js";
 function buildDiscoveryConfig(options) {
     const token = getEnv("VERYFRONT_API_TOKEN") ?? "";
     const slug = getEnv("VERYFRONT_PROJECT_SLUG") ?? options.fallbackProjectSlug ?? "";
@@ -19,7 +20,7 @@ export async function startCliProxyModeServer(options) {
     if (!getEnv("NODE_ENV") && !getEnv("DENO_ENV")) {
         setEnv("NODE_ENV", "development");
     }
-    return await startProductionServer({
+    const result = await startProductionServer({
         port: options.port,
         projectDir: options.projectDir,
         signal: options.signal,
@@ -28,6 +29,8 @@ export async function startCliProxyModeServer(options) {
         defaultProjectId: options.defaultProjectId,
         discoveryConfig: buildDiscoveryConfig(options),
     });
+    ensureBuiltinContentTransformer();
+    return result;
 }
 export async function startCliDevServer(options) {
     const devOptions = {
@@ -37,7 +40,9 @@ export async function startCliDevServer(options) {
         enableFastRefresh: options.enableFastRefresh,
         signal: options.signal,
     };
-    return await startDevServer(devOptions);
+    const result = await startDevServer(devOptions);
+    ensureBuiltinContentTransformer();
+    return result;
 }
 export async function startCliProductionServer(options) {
     const adapter = options.adapter ?? (await runtime.get());
@@ -59,5 +64,7 @@ export async function startCliProductionServer(options) {
         // through `/_veryfront/rsc/module?` for non-local deployments, so no
         // `localProjects` entry is required for the compiled binary to work.
     };
-    return await startProductionServer(serverOptions);
+    const result = await startProductionServer(serverOptions);
+    ensureBuiltinContentTransformer();
+    return result;
 }

package/esm/deno.js

@@ -1,12 +1,13 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.369",
+    "version": "0.1.370",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
         "./extensions/ext-anthropic",
         "./extensions/ext-babel",
         "./extensions/ext-jwt",
+        "./extensions/ext-mdx",
         "./extensions/ext-node-compat",
         "./extensions/ext-openai",
         "./extensions/ext-opentelemetry",

package/esm/extensions/ext-mdx/src/compiler/markdown-compile.d.ts

@@ -0,0 +1,3 @@
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+export declare function compileMarkdown(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+//# sourceMappingURL=markdown-compile.d.ts.map

package/esm/extensions/ext-mdx/src/compiler/markdown-compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-compile.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/compiler/markdown-compile.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAkDlH,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4D/B"}

package/esm/extensions/ext-mdx/src/compiler/markdown-compile.js

@@ -0,0 +1,99 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkRehype from "remark-rehype";
+import rehypeStarryNight from "rehype-starry-night";
+import rehypeSlug from "rehype-slug";
+import rehypeRaw from "rehype-raw";
+import rehypeSanitize, { defaultSchema } from "rehype-sanitize";
+import rehypeStringify from "rehype-stringify";
+import { visit } from "unist-util-visit";
+import { toString } from "mdast-util-to-string";
+import Slugger from "github-slugger";
+import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
+import { isMarkdownPreview } from "../../../../src/transforms/md/utils.js";
+import { rehypeNodePositions } from "../plugins/rehype-node-positions.js";
+function remarkExtractHeadings(headings) {
+    const slugger = new Slugger();
+    return (tree) => {
+        visit(tree, "heading", (node) => {
+            const text = toString(node);
+            const id = slugger.slug(text);
+            headings.push({ id, text, level: node.depth });
+        });
+    };
+}
+function escapeForJsString(str) {
+    return str.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$");
+}
+function createCompiledCode(escapedHtml, isPreview) {
+    const injector = `dangerouslySetInnerHTML: { __html: \`${escapedHtml}\` }`;
+    if (isPreview) {
+        return `import { jsx as _jsx } from "react/jsx-runtime";
+export default function MDContent({ components, params, ...props }) {
+  return _jsx("div", {
+    className: "markdown-body",
+    ${injector}
+  });
+}
+`;
+    }
+    return `import { jsx as _jsx } from "react/jsx-runtime";
+export default function MDContent({ components, params, className, ...props }) {
+  return _jsx("div", {
+    className,
+    ${injector}
+  });
+}
+`;
+}
+export async function compileMarkdown(options) {
+    const { content, frontmatter: providedFrontmatter, filePath, studioEmbed } = options;
+    const { body, frontmatter: extractedFrontmatter } = extractFrontmatter(content, providedFrontmatter);
+    const headings = [];
+    const pipeline = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkFrontmatter)
+        .use(remarkExtractHeadings, headings)
+        .use(remarkRehype, { allowDangerousHtml: true })
+        .use(rehypeStarryNight)
+        .use(rehypeSlug);
+    pipeline.use(rehypeRaw);
+    if (studioEmbed && filePath) {
+        pipeline.use(rehypeNodePositions, { filePath });
+    }
+    const sanitizeSchema = studioEmbed
+        ? {
+            ...defaultSchema,
+            attributes: {
+                ...defaultSchema.attributes,
+                "*": [
+                    ...(defaultSchema.attributes?.["*"] ?? []),
+                    "data-node-file",
+                    "data-node-name",
+                    "data-node-line",
+                    "data-node-column",
+                    "data-node-source",
+                ],
+            },
+        }
+        : defaultSchema;
+    const result = await pipeline
+        .use(rehypeSanitize, sanitizeSchema)
+        .use(rehypeStringify)
+        .process(body);
+    const html = String(result);
+    const escapedHtml = escapeForJsString(html);
+    const isPreview = isMarkdownPreview(filePath, extractedFrontmatter);
+    const compiledCode = createCompiledCode(escapedHtml, isPreview);
+    return {
+        compiledCode,
+        frontmatter: extractedFrontmatter,
+        globals: {},
+        headings,
+        nodeMap: new Map(),
+        rawHtml: html,
+    };
+}

package/esm/extensions/ext-mdx/src/compiler/mdx-compile.d.ts

@@ -0,0 +1,3 @@
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+export declare function compileMdx(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+//# sourceMappingURL=mdx-compile.d.ts.map

package/esm/extensions/ext-mdx/src/compiler/mdx-compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-compile.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/compiler/mdx-compile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAQlH,wBAAsB,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8D9F"}

package/esm/extensions/ext-mdx/src/compiler/mdx-compile.js

@@ -0,0 +1,47 @@
+import { compile } from "@mdx-js/mdx";
+import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
+import { rewriteBodyImports, rewriteCompiledImports } from "../../../../src/transforms/mdx/compiler/import-rewriter.js";
+import { getRehypePlugins, getRemarkPlugins } from "../plugins/plugin-loader.js";
+import { rehypeNodePositions } from "../plugins/rehype-node-positions.js";
+export async function compileMdx(options) {
+    const { projectDir, content, frontmatter: providedFrontmatter, filePath, target = "server", baseUrl, studioEmbed, } = options;
+    const remarkPlugins = getRemarkPlugins();
+    const rehypePlugins = getRehypePlugins();
+    if (studioEmbed && filePath) {
+        rehypePlugins.push([rehypeNodePositions, { filePath }]);
+    }
+    const { body: extractedBody, frontmatter: extractedFrontmatter } = extractFrontmatter(content, providedFrontmatter);
+    const shouldRewriteImports = Boolean(filePath) &&
+        (target === "browser" || target === "server");
+    const body = shouldRewriteImports
+        ? rewriteBodyImports(extractedBody, { filePath: filePath, target, baseUrl, projectDir })
+        : extractedBody;
+    const compiled = await compile(body, {
+        outputFormat: "program",
+        // Always false: @mdx-js/mdx development mode emits extra JSX
+        // transforms that break the existing rendering pipeline.
+        development: false,
+        remarkPlugins,
+        rehypePlugins,
+        providerImportSource: undefined,
+        jsxImportSource: "react",
+    });
+    const headings = compiled.data?.headings ??
+        [];
+    const compiledString = String(compiled);
+    const compiledCode = shouldRewriteImports
+        ? rewriteCompiledImports(compiledString, {
+            filePath: filePath,
+            target,
+            baseUrl,
+            projectDir,
+        })
+        : compiledString;
+    return {
+        compiledCode,
+        frontmatter: extractedFrontmatter,
+        globals: {},
+        headings,
+        nodeMap: new Map(),
+    };
+}

package/esm/extensions/ext-mdx/src/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ext-mdx — ContentTransformer implementation backed by MDX + remark/rehype.
+ *
+ * Provides the `ContentTransformer` contract:
+ *  - `compileMdx(options)`  — runs @mdx-js/mdx through veryfront's remark +
+ *    rehype plugin stack and returns compiled ESM plus extracted headings
+ *    and frontmatter.
+ *  - `compileMarkdown(options)` — runs a unified markdown pipeline
+ *    (remark-parse → remark-rehype → rehype-sanitize → rehype-stringify)
+ *    producing sanitized HTML wrapped in a React component.
+ *
+ * Core's `src/transforms/md/compiler` and `src/transforms/mdx/compiler`
+ * resolve this contract at call time. When the extension is not installed,
+ * core throws an actionable install message (see
+ * `src/extensions/recommendations.ts`).
+ *
+ * @module extensions/ext-mdx
+ */
+import type { ExtensionFactory } from "../../../src/extensions/index.js";
+import type { ContentCompileOptions, ContentPlugin, ContentRuntimeBundle, ContentTransformer } from "../../../src/extensions/interfaces/index.js";
+declare class MdxContentTransformer implements ContentTransformer {
+    compileMdx(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+    compileMarkdown(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+    getRemarkPlugins(): ContentPlugin[];
+    getRehypePlugins(): ContentPlugin[];
+}
+declare const extMdx: ExtensionFactory;
+export default extMdx;
+export { MdxContentTransformer };
+//# sourceMappingURL=index.d.ts.map

package/esm/extensions/ext-mdx/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-mdx/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,6CAA6C,CAAC;AAKrD,cAAM,qBAAsB,YAAW,kBAAkB;IACvD,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAGzE,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAG9E,gBAAgB,IAAI,aAAa,EAAE;IAGnC,gBAAgB,IAAI,aAAa,EAAE;CAGpC;AAED,QAAA,MAAM,MAAM,EAAE,gBAcb,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/esm/extensions/ext-mdx/src/index.js

@@ -0,0 +1,52 @@
+/**
+ * ext-mdx — ContentTransformer implementation backed by MDX + remark/rehype.
+ *
+ * Provides the `ContentTransformer` contract:
+ *  - `compileMdx(options)`  — runs @mdx-js/mdx through veryfront's remark +
+ *    rehype plugin stack and returns compiled ESM plus extracted headings
+ *    and frontmatter.
+ *  - `compileMarkdown(options)` — runs a unified markdown pipeline
+ *    (remark-parse → remark-rehype → rehype-sanitize → rehype-stringify)
+ *    producing sanitized HTML wrapped in a React component.
+ *
+ * Core's `src/transforms/md/compiler` and `src/transforms/mdx/compiler`
+ * resolve this contract at call time. When the extension is not installed,
+ * core throws an actionable install message (see
+ * `src/extensions/recommendations.ts`).
+ *
+ * @module extensions/ext-mdx
+ */
+import { compileMdx } from "./compiler/mdx-compile.js";
+import { compileMarkdown } from "./compiler/markdown-compile.js";
+import { getRehypePlugins, getRemarkPlugins } from "./plugins/plugin-loader.js";
+class MdxContentTransformer {
+    compileMdx(options) {
+        return compileMdx(options);
+    }
+    compileMarkdown(options) {
+        return compileMarkdown(options);
+    }
+    getRemarkPlugins() {
+        return getRemarkPlugins();
+    }
+    getRehypePlugins() {
+        return getRehypePlugins();
+    }
+}
+const extMdx = () => {
+    const impl = new MdxContentTransformer();
+    return {
+        name: "ext-mdx",
+        version: "0.1.0",
+        capabilities: [{ type: "contract", name: "ContentTransformer" }],
+        setup(ctx) {
+            ctx.provide("ContentTransformer", impl);
+            ctx.logger.info("[ext-mdx] ContentTransformer registered");
+        },
+        teardown() {
+            // No resources to release.
+        },
+    };
+};
+export default extMdx;
+export { MdxContentTransformer };

package/esm/extensions/ext-mdx/src/plugins/plugin-loader.d.ts

@@ -0,0 +1,4 @@
+import type { Pluggable } from "unified";
+export declare function getRemarkPlugins(): Pluggable[];
+export declare function getRehypePlugins(): Pluggable[];
+//# sourceMappingURL=plugin-loader.d.ts.map

package/esm/extensions/ext-mdx/src/plugins/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/plugins/plugin-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAQ9C;AAED,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}

package/esm/extensions/ext-mdx/src/plugins/plugin-loader.js

@@ -0,0 +1,18 @@
+import rehypeHighlight from "rehype-highlight";
+import rehypeSlug from "rehype-slug";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+import { remarkMdxHeadings } from "./remark-headings.js";
+import { remarkCodeBlocks, remarkMdxRemoveParagraphs } from "./remark-mdx-utils.js";
+export function getRemarkPlugins() {
+    return [
+        remarkGfm,
+        remarkFrontmatter,
+        remarkMdxHeadings,
+        remarkMdxRemoveParagraphs,
+        remarkCodeBlocks,
+    ];
+}
+export function getRehypePlugins() {
+    return [rehypeHighlight, rehypeSlug];
+}

package/esm/extensions/ext-mdx/src/plugins/rehype-node-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-node-positions.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/plugins/rehype-node-positions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAGjD,UAAU,0BAA0B;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAoCtB"}

package/esm/extensions/ext-mdx/src/plugins/remark-headings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-headings.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/plugins/remark-headings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AA0BnC,wBAAgB,iBAAiB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CA8DrE"}

package/esm/extensions/ext-mdx/src/plugins/remark-mdx-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mdx-utils.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/ext-mdx/src/plugins/remark-mdx-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,IAAI,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAoGnC;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CA6EhE;AAYD,wBAAgB,gBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAmBvD;AAQD,wBAAgB,gBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAmBpE"}

package/esm/src/agent/fork-runtime-stream.d.ts

@@ -1,4 +1,4 @@
-import { type HostToolSet, type Tool, type TraceHostToolsOptions } from "../tool/index.js";
+import { type HostToolSet, type HostToolTraceAttributes, type Tool, type TraceHostToolsOptions } from "../tool/index.js";
 import type { AgUiRuntimeStreamEvent } from "./ag-ui-browser-encoder.js";
 import type { AgentResponse, Message as AgentMessage } from "./schemas/index.js";
 interface ForkStreamPart {
@@ -146,13 +146,13 @@ export type StartAgentRuntimeForkInput = {
     prepareStep?: ForkRuntimeStepPreparer;
     runStep?: AgentRuntimeForkStepRunner;
 };
-export type StartAgentRuntimeForkWithHostToolsInput = Omit<StartAgentRuntimeForkInput, "forkToolNames" | "model" | "runtimeTools"> & {
+export type StartAgentRuntimeForkWithHostToolsInput<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes> = Omit<StartAgentRuntimeForkInput, "forkToolNames" | "model" | "runtimeTools"> & {
     provider: string;
     forkModel: string;
     forkTools: HostToolSet;
-    traceTools?: TraceHostToolsOptions;
+    traceTools?: TraceHostToolsOptions<TAttributes>;
 };
-export declare function startAgentRuntimeForkWithHostTools(input: StartAgentRuntimeForkWithHostToolsInput): {
+export declare function startAgentRuntimeForkWithHostTools<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes>(input: StartAgentRuntimeForkWithHostToolsInput<TAttributes>): {
     streamResult: ForkRuntimeStreamResult;
     forkToolNames: string[];
 };

package/esm/src/agent/fork-runtime-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fork-runtime-stream.d.ts","sourceRoot":"","sources":["../../../src/src/agent/fork-runtime-stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fork-runtime-stream.d.ts","sourceRoot":"","sources":["../../../src/src/agent/fork-runtime-stream.ts"],"names":[],"mappings":"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"}

package/esm/src/extensions/interfaces/content-transformer.d.ts

@@ -3,38 +3,89 @@
  *
  * Default implementation: `@veryfront/ext-mdx`
  *
+ * Implementations compile MDX / Markdown source into renderable JavaScript
+ * modules. Core's `src/transforms/md/compiler` and
+ * `src/transforms/mdx/compiler` delegate to the registered implementation;
+ * when none is registered, the compile paths throw an actionable install
+ * message pointing at `@veryfront/ext-mdx`.
+ *
+ * The two compile methods have the same option shape on purpose so a single
+ * dispatcher (see `src/transforms/mdx/compiler/index.ts::compileContent`)
+ * can route on file extension. Options match the long-standing
+ * `compileMDXRuntime` / `compileMarkdownRuntime` signatures — option order
+ * and defaults are preserved so the extension boundary is a pure refactor,
+ * not a behavior change.
+ *
  * @module extensions/interfaces/content-transformer
  */
-/** Options passed to {@link ContentTransformer.transform}. */
-export interface ContentTransformOptions {
-    /** Raw source content (e.g. MDX, Markdown). */
-    source: string;
-    /** File path hint for the source content. */
-    filePath?: string;
-    /** Additional remark/rehype plugins or processor-specific settings. */
-    [key: string]: unknown;
+/** Compilation mode — dev surfaces extra diagnostics. */
+export type CompilationMode = "development" | "production";
+/** Where the output is destined — server-side RSC or browser bundle. */
+export type CompilationTarget = "browser" | "server";
+/** Runtime bundle returned by the compilation pipeline. */
+export interface ContentRuntimeBundle {
+    /** Compiled ESM source containing the default MDX/MD component export. */
+    compiledCode: string;
+    /** Front-matter extracted from the source document. */
+    frontmatter: Record<string, unknown>;
+    /** Globals injected into the module scope (MDX imports, shims). */
+    globals: Record<string, unknown>;
+    /** Extracted TOC headings, when the pipeline collected them. */
+    headings?: {
+        id: string;
+        text: string;
+        level: number;
+    }[];
+    /** Source-map-adjacent line/column data keyed by node ordinal. */
+    nodeMap?: Map<number, unknown>;
+    /** Raw HTML (markdown preview path only). */
+    rawHtml?: string;
 }
-/** Result returned from {@link ContentTransformer.transform}. */
-export interface ContentTransformResult {
-    /** Transformed output code. */
-    code: string;
-    /** Front-matter or metadata extracted from the source. */
+/** Options for {@link ContentTransformer.compileMdx} and {@link ContentTransformer.compileMarkdown}. */
+export interface ContentCompileOptions {
+    /** Compilation mode — defaults to "production" when omitted. */
+    mode?: CompilationMode;
+    /** Absolute project root (used for resolving relative import rewrites). */
+    projectDir: string;
+    /** Source document content. */
+    content: string;
+    /** Optional frontmatter pre-seed merged with in-body frontmatter. */
     frontmatter?: Record<string, unknown>;
-    /** Extracted table-of-contents headings. */
-    headings?: Array<{
-        depth: number;
-        text: string;
-        slug: string;
-    }>;
+    /** Source file path hint (used in error messages + import resolution). */
+    filePath?: string;
+    /** Compile target — defaults to "server". */
+    target?: CompilationTarget;
+    /** Base URL used when rewriting bare-specifier imports. */
+    baseUrl?: string;
+    /** When true, preserves node-position metadata for studio overlays. */
+    studioEmbed?: boolean;
 }
 /**
- * ContentTransformer contract interface.
+ * Opaque unified-compatible plugin entry. Kept as `unknown[] | unknown` so
+ * the contract surface doesn't require consumers to depend on the `unified`
+ * package directly — callers cast to the plugin-list shape they need.
+ */
+export type ContentPlugin = unknown | [unknown, ...unknown[]];
+/**
+ * ContentTransformer contract — compiles MDX/Markdown to runtime-ready JS.
+ *
+ * Implementations own the entire pipeline (parser, remark/rehype plugins,
+ * MDX compile step, sanitization, HTML wrapping). Core only dispatches by
+ * file extension and post-processes the returned bundle.
  *
- * Implementations transform authoring formats (MDX, Markdown, etc.)
- * into renderable code or HTML.
+ * `getRemarkPlugins()` / `getRehypePlugins()` are exposed so build-time MDX
+ * compilers (which run their own @mdx-js/mdx invocations) can borrow the
+ * canonical plugin list without duplicating it. Runtime compile paths
+ * should prefer `compileMdx` / `compileMarkdown`.
  */
 export interface ContentTransformer {
-    /** Transform source content into its processed form. */
-    transform(options: ContentTransformOptions): Promise<ContentTransformResult>;
+    /** Compile MDX source into a runtime bundle. */
+    compileMdx(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+    /** Compile plain Markdown into a runtime bundle. */
+    compileMarkdown(options: ContentCompileOptions): Promise<ContentRuntimeBundle>;
+    /** Return the canonical remark plugin list. */
+    getRemarkPlugins(): ContentPlugin[];
+    /** Return the canonical rehype plugin list. */
+    getRehypePlugins(): ContentPlugin[];
 }
 //# sourceMappingURL=content-transformer.d.ts.map

package/esm/src/extensions/interfaces/content-transformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-transformer.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/content-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC9E"}
+{"version":3,"file":"content-transformer.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/content-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;AAE3D,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,kEAAkE;IAClE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,oDAAoD;IACpD,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/E,+CAA+C;IAC/C,gBAAgB,IAAI,aAAa,EAAE,CAAC;IACpC,+CAA+C;IAC/C,gBAAgB,IAAI,aAAa,EAAE,CAAC;CACrC"}

package/esm/src/extensions/interfaces/content-transformer.js

@@ -3,6 +3,19 @@
  *
  * Default implementation: `@veryfront/ext-mdx`
  *
+ * Implementations compile MDX / Markdown source into renderable JavaScript
+ * modules. Core's `src/transforms/md/compiler` and
+ * `src/transforms/mdx/compiler` delegate to the registered implementation;
+ * when none is registered, the compile paths throw an actionable install
+ * message pointing at `@veryfront/ext-mdx`.
+ *
+ * The two compile methods have the same option shape on purpose so a single
+ * dispatcher (see `src/transforms/mdx/compiler/index.ts::compileContent`)
+ * can route on file extension. Options match the long-standing
+ * `compileMDXRuntime` / `compileMarkdownRuntime` signatures — option order
+ * and defaults are preserved so the extension boundary is a pure refactor,
+ * not a behavior change.
+ *
  * @module extensions/interfaces/content-transformer
  */
 export {};