@vxrn/mdx-rust 1.20.3

package/README.md

@@ -0,0 +1,52 @@
+# @vxrn/mdx-rust
+
+A small, fast MDX pipeline for One, built on [satteri](https://satteri.bruits.org)
+(Markdown/MDX parsed and compiled in Rust) with syntax highlighting from
+[Expressive Code](https://expressive-code.com) (Shiki).
+
+It replaces the `mdx-bundler` + remark/rehype stack in `@vxrn/mdx` with far less
+code and a much faster compile. GFM, SmartyPants, frontmatter, and `:::`
+directives are built into the parser; heading slugs and code highlighting are the
+only bundled plugins.
+
+## Usage
+
+```ts
+// server (build / loader)
+import { getMDXBySlug } from '@vxrn/mdx-rust'
+
+const { frontmatter, code } = await getMDXBySlug('data/docs', slug)
+```
+
+```tsx
+// client
+import { getMDXComponent } from '@vxrn/mdx-rust/client'
+
+const Component = useMemo(() => getMDXComponent(code), [code])
+return <Component components={components} />
+```
+
+## API
+
+- `getMDX(source, options?)` → `{ frontmatter, code }`
+- `getMDXBySlug(basePath, slug, options?)` → `{ frontmatter, code }`
+- `getAllFrontmatter(fromPath)` → `Frontmatter[]`
+- `getAllVersionsFromPath(fromPath)` → `string[]`
+- `getHeadings(source)` → table-of-contents entries
+- `getMDXComponent(code)` (from `@vxrn/mdx-rust/client`)
+- `slugPlugin` — the bundled heading-id hast plugin, exported for reuse
+
+### `GetMDXOptions`
+
+- `expressiveCode` — Expressive Code options (themes, frames, styleOverrides,
+  plugins), or `false` to skip highlighting. Defaults to `{ themes: ['github-dark'] }`.
+- `mdastPlugins` / `hastPlugins` — extra satteri plugins (e.g. a hero/demo
+  source injector). These use satteri's `defineMdastPlugin` / `defineHastPlugin`,
+  not remark/rehype.
+- `publicDir` — for resolving `image:` frontmatter paths (default `./public`).
+
+## Code fence meta
+
+Highlighting, file titles, and line markers use Expressive Code's meta syntax:
+
+    ```tsx title="app/routes/index.tsx" {2-4}

package/dist/client.mjs

@@ -0,0 +1,11 @@
+import * as runtime from "react/jsx-runtime";
+function getMDXComponent(code, globals = {}) {
+  const fn = new Function(String(code));
+  const mod = fn({
+    ...runtime,
+    ...globals
+  });
+  return mod.default;
+}
+export { getMDXComponent };
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["runtime","getMDXComponent","code","globals","fn","Function","String","mod","default"],"sources":["../src/client.ts"],"sourcesContent":[null],"mappings":"AAAA,YAAYA,OAAA,MAAa;AAWlB,SAASC,gBACdC,IAAA,EACAC,OAAA,GAAmC,CAAC,GACsB;EAE1D,MAAMC,EAAA,GAAK,IAAIC,QAAA,CAASC,MAAA,CAAOJ,IAAI,CAAC;EACpC,MAAMK,GAAA,GAAMH,EAAA,CAAG;IAAE,GAAGJ,OAAA;IAAS,GAAGG;EAAQ,CAAC;EACzC,OAAOI,GAAA,CAAIC,OAAA;AACb","ignoreList":[]}

package/dist/getAllFrontmatter.mjs

@@ -0,0 +1,26 @@
+import fs from "node:fs";
+import glob from "fast-glob";
+import matter from "gray-matter";
+import readingTime from "reading-time";
+import { getHeadings } from "./getHeadings.mjs";
+import { notifyFileRead } from "./watchFile.mjs";
+const getAllFrontmatter = fromPath => {
+  const paths = glob.sync(`${fromPath}/**/*.mdx`);
+  return paths.map(filePath => {
+    notifyFileRead(filePath);
+    const source = fs.readFileSync(filePath, "utf8");
+    const {
+      data,
+      content
+    } = matter(source);
+    const slug = filePath.replace(`${fromPath.replaceAll("\\", "/")}/`, "").replace(".mdx", "");
+    return {
+      ...data,
+      slug,
+      headings: getHeadings(source),
+      readingTime: readingTime(content)
+    };
+  }).sort((a, b) => Number(new Date(b.publishedAt || "")) - Number(new Date(a.publishedAt || "")));
+};
+export { getAllFrontmatter };
+//# sourceMappingURL=getAllFrontmatter.mjs.map

package/dist/getAllFrontmatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["fs","glob","matter","readingTime","getHeadings","notifyFileRead","getAllFrontmatter","fromPath","paths","sync","map","filePath","source","readFileSync","data","content","slug","replace","replaceAll","headings","sort","a","b","Number","Date","publishedAt"],"sources":["../src/getAllFrontmatter.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAOA,EAAA,MAAQ;AAEf,OAAOC,IAAA,MAAU;AACjB,OAAOC,MAAA,MAAY;AACnB,OAAOC,WAAA,MAAiB;AACxB,SAASC,WAAA,QAAmB;AAE5B,SAASC,cAAA,QAAsB;AAIxB,MAAMC,iBAAA,GAAqBC,QAAA,IAAoC;EACpE,MAAMC,KAAA,GAAQP,IAAA,CAAKQ,IAAA,CAAK,GAAGF,QAAQ,WAAW;EAC9C,OAAOC,KAAA,CACJE,GAAA,CAAKC,QAAA,IAAa;IACjBN,cAAA,CAAeM,QAAQ;IACvB,MAAMC,MAAA,GAASZ,EAAA,CAAGa,YAAA,CAAaF,QAAA,EAAU,MAAM;IAC/C,MAAM;MAAEG,IAAA;MAAMC;IAAQ,IAAIb,MAAA,CAAOU,MAAM;IACvC,MAAMI,IAAA,GAAOL,QAAA,CACVM,OAAA,CAAQ,GAAGV,QAAA,CAASW,UAAA,CAAW,MAAM,GAAG,CAAC,KAAK,EAAE,EAChDD,OAAA,CAAQ,QAAQ,EAAE;IACrB,OAAO;MACL,GAAGH,IAAA;MACHE,IAAA;MACAG,QAAA,EAAUf,WAAA,CAAYQ,MAAM;MAC5BT,WAAA,EAAaA,WAAA,CAAYY,OAAO;IAClC;EACF,CAAC,EACAK,IAAA,CACC,CAACC,CAAA,EAAGC,CAAA,KACFC,MAAA,CAAO,IAAIC,IAAA,CAAKF,CAAA,CAAEG,WAAA,IAAe,EAAE,CAAC,IAAIF,MAAA,CAAO,IAAIC,IAAA,CAAKH,CAAA,CAAEI,WAAA,IAAe,EAAE,CAAC,CAChF;AACJ","ignoreList":[]}

package/dist/getHeadings.mjs

@@ -0,0 +1,12 @@
+import GithubSlugger from "github-slugger";
+const getTitle = source => source.replace(/^#+\s+/, "").replace(/<.*>/, " ");
+const getHeadings = source => {
+  const slugger = new GithubSlugger();
+  return source.split("\n").filter(x => x.startsWith("#")).map(x => ({
+    title: getTitle(x),
+    priority: x.trim().split(" ")[0].length,
+    id: slugger.slug(getTitle(x))
+  }));
+};
+export { getHeadings };
+//# sourceMappingURL=getHeadings.mjs.map

package/dist/getHeadings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["GithubSlugger","getTitle","source","replace","getHeadings","slugger","split","filter","x","startsWith","map","title","priority","trim","length","id","slug"],"sources":["../src/getHeadings.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAOA,aAAA,MAAmB;AAG1B,MAAMC,QAAA,GAAYC,MAAA,IAAmBA,MAAA,CAAOC,OAAA,CAAQ,UAAU,EAAE,EAAEA,OAAA,CAAQ,QAAQ,GAAG;AAI9E,MAAMC,WAAA,GAAeF,MAAA,IAA8B;EACxD,MAAMG,OAAA,GAAU,IAAIL,aAAA,CAAc;EAClC,OAAOE,MAAA,CACJI,KAAA,CAAM,IAAI,EACVC,MAAA,CAAQC,CAAA,IAAMA,CAAA,CAAEC,UAAA,CAAW,GAAG,CAAC,EAC/BC,GAAA,CAAKF,CAAA,KAAO;IACXG,KAAA,EAAOV,QAAA,CAASO,CAAC;IACjBI,QAAA,EAAUJ,CAAA,CAAEK,IAAA,CAAK,EAAEP,KAAA,CAAM,GAAG,EAAE,CAAC,EAAEQ,MAAA;IACjCC,EAAA,EAAIV,OAAA,CAAQW,IAAA,CAAKf,QAAA,CAASO,CAAC,CAAC;EAC9B,EAAE;AACN","ignoreList":[]}

package/dist/getMDX.mjs

@@ -0,0 +1,66 @@
+import matter from "gray-matter";
+import readingTime from "reading-time";
+import { mdxToJs } from "satteri";
+import expressiveCode from "satteri-expressive-code";
+import { getHeadings } from "./getHeadings.mjs";
+import { processImageMeta } from "./processImageMeta.mjs";
+import { slugPlugin } from "./slugPlugin.mjs";
+import { tableWhitespacePlugin } from "./tableWhitespacePlugin.mjs";
+const DEFAULT_EC = {
+  themes: ["github-dark"]
+};
+const ecByKey = /* @__PURE__ */new Map();
+function getExpressiveCode(opts) {
+  const key = (() => {
+    try {
+      return JSON.stringify(opts);
+    } catch {
+      return null;
+    }
+  })();
+  if (key == null) return expressiveCode(opts);
+  let plugin = ecByKey.get(key);
+  if (!plugin) {
+    plugin = expressiveCode(opts);
+    ecByKey.set(key, plugin);
+  }
+  return plugin;
+}
+async function getMDX(source, options = {}) {
+  const {
+    data,
+    content
+  } = matter(source);
+  const ec = options.expressiveCode === false ? [] : [getExpressiveCode(options.expressiveCode ?? DEFAULT_EC)];
+  const {
+    code
+  } = await mdxToJs(source, {
+    outputFormat: "function-body",
+    jsxImportSource: "react",
+    features: {
+      gfm: true,
+      smartPunctuation: true,
+      frontmatter: true
+    },
+    mdastPlugins: [...(options.mdastPlugins ?? [])],
+    hastPlugins: [slugPlugin, tableWhitespacePlugin, ...ec, ...(options.hastPlugins ?? [])]
+  });
+  let imageMeta;
+  if (data.image && typeof data.image === "string") {
+    const meta = await processImageMeta(data.image, {
+      publicDir: options.publicDir
+    });
+    if (meta) imageMeta = meta;
+  }
+  return {
+    frontmatter: {
+      ...data,
+      headings: getHeadings(source),
+      readingTime: readingTime(content),
+      imageMeta
+    },
+    code
+  };
+}
+export { getMDX };
+//# sourceMappingURL=getMDX.mjs.map

package/dist/getMDX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["matter","readingTime","mdxToJs","expressiveCode","getHeadings","processImageMeta","slugPlugin","tableWhitespacePlugin","DEFAULT_EC","themes","ecByKey","Map","getExpressiveCode","opts","key","JSON","stringify","plugin","get","set","getMDX","source","options","data","content","ec","code","outputFormat","jsxImportSource","features","gfm","smartPunctuation","frontmatter","mdastPlugins","hastPlugins","imageMeta","image","meta","publicDir","headings"],"sources":["../src/getMDX.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAOA,MAAA,MAAY;AACnB,OAAOC,WAAA,MAAiB;AACxB,SAAsDC,OAAA,QAAe;AACrE,OAAOC,cAAA,MAEA;AACP,SAASC,WAAA,QAAmB;AAC5B,SAASC,gBAAA,QAAwB;AACjC,SAASC,UAAA,QAAkB;AAC3B,SAASC,qBAAA,QAA6B;AAkBtC,MAAMC,UAAA,GAA2C;EAAEC,MAAA,EAAQ,CAAC,aAAa;AAAE;AAK3E,MAAMC,OAAA,GAAU,mBAAIC,GAAA,CAA+C;AACnE,SAASC,kBAAkBC,IAAA,EAAoC;EAC7D,MAAMC,GAAA,IAAO,MAAM;IACjB,IAAI;MACF,OAAOC,IAAA,CAAKC,SAAA,CAAUH,IAAI;IAC5B,QAAQ;MACN,OAAO;IACT;EACF,GAAG;EACH,IAAIC,GAAA,IAAO,MAAM,OAAOX,cAAA,CAAeU,IAAI;EAC3C,IAAII,MAAA,GAASP,OAAA,CAAQQ,GAAA,CAAIJ,GAAG;EAC5B,IAAI,CAACG,MAAA,EAAQ;IACXA,MAAA,GAASd,cAAA,CAAeU,IAAI;IAC5BH,OAAA,CAAQS,GAAA,CAAIL,GAAA,EAAKG,MAAM;EACzB;EACA,OAAOA,MAAA;AACT;AAOA,eAAsBG,OACpBC,MAAA,EACAC,OAAA,GAAyB,CAAC,GAC2B;EACrD,MAAM;IAAEC,IAAA;IAAMC;EAAQ,IAAIxB,MAAA,CAAOqB,MAAM;EAEvC,MAAMI,EAAA,GACJH,OAAA,CAAQnB,cAAA,KAAmB,QACvB,EAAC,GACD,CAACS,iBAAA,CAAkBU,OAAA,CAAQnB,cAAA,IAAkBK,UAAU,CAAC;EAE9D,MAAM;IAAEkB;EAAK,IAAI,MAAMxB,OAAA,CAAQmB,MAAA,EAAQ;IACrCM,YAAA,EAAc;IACdC,eAAA,EAAiB;IACjBC,QAAA,EAAU;MAAEC,GAAA,EAAK;MAAMC,gBAAA,EAAkB;MAAMC,WAAA,EAAa;IAAK;IACjEC,YAAA,EAAc,CAAC,IAAIX,OAAA,CAAQW,YAAA,IAAgB,EAAG;IAC9CC,WAAA,EAAa,CAAC5B,UAAA,EAAYC,qBAAA,EAAuB,GAAGkB,EAAA,EAAI,IAAIH,OAAA,CAAQY,WAAA,IAAe,EAAG;EACxF,CAAC;EAED,IAAIC,SAAA;EACJ,IAAIZ,IAAA,CAAKa,KAAA,IAAS,OAAOb,IAAA,CAAKa,KAAA,KAAU,UAAU;IAChD,MAAMC,IAAA,GAAO,MAAMhC,gBAAA,CAAiBkB,IAAA,CAAKa,KAAA,EAAO;MAAEE,SAAA,EAAWhB,OAAA,CAAQgB;IAAU,CAAC;IAChF,IAAID,IAAA,EAAMF,SAAA,GAAYE,IAAA;EACxB;EAEA,OAAO;IACLL,WAAA,EAAa;MACX,GAAGT,IAAA;MACHgB,QAAA,EAAUnC,WAAA,CAAYiB,MAAM;MAC5BpB,WAAA,EAAaA,WAAA,CAAYuB,OAAO;MAChCW;IACF;IACAT;EACF;AACF","ignoreList":[]}

package/dist/getMDXBySlug.mjs

@@ -0,0 +1,22 @@
+import fs from "node:fs";
+import path from "node:path";
+import compareVersions from "compare-versions";
+import { getMDX } from "./getMDX.mjs";
+import { notifyFileRead } from "./watchFile.mjs";
+const getMDXBySlug = async (basePath, slug, options) => {
+  let mdxPath = slug;
+  if (!slug.includes(".") && basePath.includes("components")) {
+    const versions = getAllVersionsFromPath(path.join(basePath, slug));
+    mdxPath += `/${versions[0]}`;
+  }
+  const filePath = path.join(basePath, `${mdxPath}.mdx`);
+  notifyFileRead(filePath);
+  const source = fs.readFileSync(filePath, "utf8");
+  return getMDX(source, options);
+};
+function getAllVersionsFromPath(fromPath) {
+  if (!fs.existsSync(fromPath)) return [];
+  return fs.readdirSync(fromPath).map(fileName => fileName.replace(".mdx", "")).sort(compareVersions).reverse();
+}
+export { getAllVersionsFromPath, getMDXBySlug };
+//# sourceMappingURL=getMDXBySlug.mjs.map

package/dist/getMDXBySlug.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["fs","path","compareVersions","getMDX","notifyFileRead","getMDXBySlug","basePath","slug","options","mdxPath","includes","versions","getAllVersionsFromPath","join","filePath","source","readFileSync","fromPath","existsSync","readdirSync","map","fileName","replace","sort","reverse"],"sources":["../src/getMDXBySlug.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAOA,EAAA,MAAQ;AACf,OAAOC,IAAA,MAAU;AACjB,OAAOC,eAAA,MAAqB;AAC5B,SAA6BC,MAAA,QAAc;AAE3C,SAASC,cAAA,QAAsB;AAExB,MAAMC,YAAA,GAAe,MAAAA,CAC1BC,QAAA,EACAC,IAAA,EACAC,OAAA,KACwD;EACxD,IAAIC,OAAA,GAAUF,IAAA;EAGd,IAAI,CAACA,IAAA,CAAKG,QAAA,CAAS,GAAG,KAAKJ,QAAA,CAASI,QAAA,CAAS,YAAY,GAAG;IAC1D,MAAMC,QAAA,GAAWC,sBAAA,CAAuBX,IAAA,CAAKY,IAAA,CAAKP,QAAA,EAAUC,IAAI,CAAC;IACjEE,OAAA,IAAW,IAAIE,QAAA,CAAS,CAAC,CAAC;EAC5B;EAEA,MAAMG,QAAA,GAAWb,IAAA,CAAKY,IAAA,CAAKP,QAAA,EAAU,GAAGG,OAAO,MAAM;EACrDL,cAAA,CAAeU,QAAQ;EACvB,MAAMC,MAAA,GAASf,EAAA,CAAGgB,YAAA,CAAaF,QAAA,EAAU,MAAM;EAC/C,OAAOX,MAAA,CAAOY,MAAA,EAAQP,OAAO;AAC/B;AAEO,SAASI,uBAAuBK,QAAA,EAA4B;EACjE,IAAI,CAACjB,EAAA,CAAGkB,UAAA,CAAWD,QAAQ,GAAG,OAAO,EAAC;EACtC,OAAOjB,EAAA,CACJmB,WAAA,CAAYF,QAAQ,EACpBG,GAAA,CAAKC,QAAA,IAAaA,QAAA,CAASC,OAAA,CAAQ,QAAQ,EAAE,CAAC,EAC9CC,IAAA,CAAKrB,eAAe,EACpBsB,OAAA,CAAQ;AACb","ignoreList":[]}

package/dist/index.js

@@ -0,0 +1,10 @@
+import { getMDX } from "./getMDX.mjs";
+import { getAllVersionsFromPath, getMDXBySlug } from "./getMDXBySlug.mjs";
+import { getAllFrontmatter } from "./getAllFrontmatter.mjs";
+import { getHeadings } from "./getHeadings.mjs";
+import { slugPlugin } from "./slugPlugin.mjs";
+import { tableWhitespacePlugin } from "./tableWhitespacePlugin.mjs";
+import { processImageMeta } from "./processImageMeta.mjs";
+import { notifyFileRead } from "./watchFile.mjs";
+export { getAllFrontmatter, getAllVersionsFromPath, getHeadings, getMDX, getMDXBySlug, notifyFileRead, processImageMeta, slugPlugin, tableWhitespacePlugin };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getMDX","getAllVersionsFromPath","getMDXBySlug","getAllFrontmatter","getHeadings","slugPlugin","tableWhitespacePlugin","processImageMeta","notifyFileRead"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAkC;AAC3C,SAASC,sBAAA,EAAwBC,YAAA,QAAoB;AACrD,SAASC,iBAAA,QAAyB;AAClC,SAASC,WAAA,QAAmB;AAC5B,SAASC,UAAA,QAAkB;AAC3B,SAASC,qBAAA,QAA6B;AACtC,SAASC,gBAAA,QAAwB;AACjC,SAASC,cAAA,QAAsB","ignoreList":[]}

package/dist/index.mjs

@@ -0,0 +1,10 @@
+import { getMDX } from "./getMDX.mjs";
+import { getAllVersionsFromPath, getMDXBySlug } from "./getMDXBySlug.mjs";
+import { getAllFrontmatter } from "./getAllFrontmatter.mjs";
+import { getHeadings } from "./getHeadings.mjs";
+import { slugPlugin } from "./slugPlugin.mjs";
+import { tableWhitespacePlugin } from "./tableWhitespacePlugin.mjs";
+import { processImageMeta } from "./processImageMeta.mjs";
+import { notifyFileRead } from "./watchFile.mjs";
+export { getAllFrontmatter, getAllVersionsFromPath, getHeadings, getMDX, getMDXBySlug, notifyFileRead, processImageMeta, slugPlugin, tableWhitespacePlugin };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["getMDX","getAllVersionsFromPath","getMDXBySlug","getAllFrontmatter","getHeadings","slugPlugin","tableWhitespacePlugin","processImageMeta","notifyFileRead"],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAkC;AAC3C,SAASC,sBAAA,EAAwBC,YAAA,QAAoB;AACrD,SAASC,iBAAA,QAAyB;AAClC,SAASC,WAAA,QAAmB;AAC5B,SAASC,UAAA,QAAkB;AAC3B,SAASC,qBAAA,QAA6B;AACtC,SAASC,gBAAA,QAAwB;AACjC,SAASC,cAAA,QAAsB","ignoreList":[]}

package/dist/processImageMeta.mjs

@@ -0,0 +1,37 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+async function getSharp() {
+  try {
+    const sharpModule = await import("sharp");
+    return sharpModule.default || sharpModule;
+  } catch {
+    return null;
+  }
+}
+async function processImageMeta(imagePath, opts) {
+  const publicDir = opts?.publicDir ?? "./public";
+  const filePath = imagePath.startsWith("/") ? resolve(publicDir, imagePath.slice(1)) : resolve(imagePath);
+  if (!existsSync(filePath)) return null;
+  const sharp = await getSharp();
+  if (!sharp) return null;
+  try {
+    const image = sharp(filePath);
+    const {
+      width = 0,
+      height = 0
+    } = await image.metadata();
+    const blurBuffer = await image.resize(10).blur().jpeg({
+      quality: 40
+    }).toBuffer();
+    const blurDataURL = `data:image/jpeg;base64,${blurBuffer.toString("base64")}`;
+    return {
+      width,
+      height,
+      blurDataURL
+    };
+  } catch {
+    return null;
+  }
+}
+export { processImageMeta };
+//# sourceMappingURL=processImageMeta.mjs.map

package/dist/processImageMeta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["existsSync","resolve","getSharp","sharpModule","default","processImageMeta","imagePath","opts","publicDir","filePath","startsWith","slice","sharp","image","width","height","metadata","blurBuffer","resize","blur","jpeg","quality","toBuffer","blurDataURL","toString"],"sources":["../src/processImageMeta.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,UAAA,QAAkB;AAC3B,SAASC,OAAA,QAAe;AAGxB,eAAeC,SAAA,EAAmD;EAChE,IAAI;IACF,MAAMC,WAAA,GAAc,MAAM,OAAO,OAAO;IACxC,OAAQA,WAAA,CAAoBC,OAAA,IAAWD,WAAA;EACzC,QAAQ;IACN,OAAO;EACT;AACF;AAIA,eAAsBE,iBACpBC,SAAA,EACAC,IAAA,EAC2B;EAC3B,MAAMC,SAAA,GAAYD,IAAA,EAAMC,SAAA,IAAa;EACrC,MAAMC,QAAA,GAAWH,SAAA,CAAUI,UAAA,CAAW,GAAG,IACrCT,OAAA,CAAQO,SAAA,EAAWF,SAAA,CAAUK,KAAA,CAAM,CAAC,CAAC,IACrCV,OAAA,CAAQK,SAAS;EAErB,IAAI,CAACN,UAAA,CAAWS,QAAQ,GAAG,OAAO;EAClC,MAAMG,KAAA,GAAQ,MAAMV,QAAA,CAAS;EAC7B,IAAI,CAACU,KAAA,EAAO,OAAO;EAEnB,IAAI;IACF,MAAMC,KAAA,GAAQD,KAAA,CAAMH,QAAQ;IAC5B,MAAM;MAAEK,KAAA,GAAQ;MAAGC,MAAA,GAAS;IAAE,IAAI,MAAMF,KAAA,CAAMG,QAAA,CAAS;IACvD,MAAMC,UAAA,GAAa,MAAMJ,KAAA,CAAMK,MAAA,CAAO,EAAE,EAAEC,IAAA,CAAK,EAAEC,IAAA,CAAK;MAAEC,OAAA,EAAS;IAAG,CAAC,EAAEC,QAAA,CAAS;IAChF,MAAMC,WAAA,GAAc,0BAA0BN,UAAA,CAAWO,QAAA,CAAS,QAAQ,CAAC;IAC3E,OAAO;MAAEV,KAAA;MAAOC,MAAA;MAAQQ;IAAY;EACtC,QAAQ;IACN,OAAO;EACT;AACF","ignoreList":[]}

package/dist/slugPlugin.mjs

@@ -0,0 +1,29 @@
+import GithubSlugger from "github-slugger";
+import { defineHastPlugin } from "satteri";
+function textOf(node) {
+  if (node.type === "text") return node.value || "";
+  if (node.children) return node.children.map(textOf).join("");
+  return "";
+}
+const slugPlugin = () => {
+  const slugger = new GithubSlugger();
+  return defineHastPlugin({
+    name: "vxrn-heading-slugs",
+    element: {
+      filter: ["h1", "h2", "h3", "h4", "h5", "h6"],
+      visit(node, ctx) {
+        if (node.properties?.id) return;
+        const id = slugger.slug(textOf(node));
+        ctx.replaceNode(node, {
+          ...node,
+          properties: {
+            ...node.properties,
+            id
+          }
+        });
+      }
+    }
+  });
+};
+export { slugPlugin };
+//# sourceMappingURL=slugPlugin.mjs.map

package/dist/slugPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["GithubSlugger","defineHastPlugin","textOf","node","type","value","children","map","join","slugPlugin","slugger","name","element","filter","visit","ctx","properties","id","slug","replaceNode"],"sources":["../src/slugPlugin.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAOA,aAAA,MAAmB;AAC1B,SAASC,gBAAA,QAAwB;AAEjC,SAASC,OAAOC,IAAA,EAAmB;EACjC,IAAIA,IAAA,CAAKC,IAAA,KAAS,QAAQ,OAAOD,IAAA,CAAKE,KAAA,IAAS;EAC/C,IAAIF,IAAA,CAAKG,QAAA,EAAU,OAAOH,IAAA,CAAKG,QAAA,CAASC,GAAA,CAAIL,MAAM,EAAEM,IAAA,CAAK,EAAE;EAC3D,OAAO;AACT;AAIO,MAAMC,UAAA,GAAaA,CAAA,KAAM;EAC9B,MAAMC,OAAA,GAAU,IAAIV,aAAA,CAAc;EAClC,OAAOC,gBAAA,CAAiB;IACtBU,IAAA,EAAM;IACNC,OAAA,EAAS;MACPC,MAAA,EAAQ,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;MAC3CC,MAAMX,IAAA,EAAWY,GAAA,EAAU;QACzB,IAAIZ,IAAA,CAAKa,UAAA,EAAYC,EAAA,EAAI;QACzB,MAAMA,EAAA,GAAKP,OAAA,CAAQQ,IAAA,CAAKhB,MAAA,CAAOC,IAAI,CAAC;QACpCY,GAAA,CAAII,WAAA,CAAYhB,IAAA,EAAM;UACpB,GAAGA,IAAA;UACHa,UAAA,EAAY;YAAE,GAAGb,IAAA,CAAKa,UAAA;YAAYC;UAAG;QACvC,CAAC;MACH;IACF;EACF,CAAC;AACH","ignoreList":[]}

package/dist/tableWhitespacePlugin.mjs

@@ -0,0 +1,19 @@
+import { defineHastPlugin } from "satteri";
+const tableWhitespacePlugin = defineHastPlugin({
+  name: "vxrn-strip-table-whitespace",
+  element: {
+    filter: ["table", "thead", "tbody", "tr"],
+    visit(node, ctx) {
+      const children = node.children || [];
+      const cleaned = children.filter(c => !(c.type === "text" && typeof c.value === "string" && c.value.trim() === ""));
+      if (cleaned.length !== children.length) {
+        ctx.replaceNode(node, {
+          ...node,
+          children: cleaned
+        });
+      }
+    }
+  }
+});
+export { tableWhitespacePlugin };
+//# sourceMappingURL=tableWhitespacePlugin.mjs.map

package/dist/tableWhitespacePlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineHastPlugin","tableWhitespacePlugin","name","element","filter","visit","node","ctx","children","cleaned","c","type","value","trim","length","replaceNode"],"sources":["../src/tableWhitespacePlugin.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,gBAAA,QAAwB;AAO1B,MAAMC,qBAAA,GAAwBD,gBAAA,CAAiB;EACpDE,IAAA,EAAM;EACNC,OAAA,EAAS;IACPC,MAAA,EAAQ,CAAC,SAAS,SAAS,SAAS,IAAI;IACxCC,MAAMC,IAAA,EAAWC,GAAA,EAAU;MACzB,MAAMC,QAAA,GAAWF,IAAA,CAAKE,QAAA,IAAY,EAAC;MACnC,MAAMC,OAAA,GAAUD,QAAA,CAASJ,MAAA,CACtBM,CAAA,IACC,EAAEA,CAAA,CAAEC,IAAA,KAAS,UAAU,OAAOD,CAAA,CAAEE,KAAA,KAAU,YAAYF,CAAA,CAAEE,KAAA,CAAMC,IAAA,CAAK,MAAM,GAC7E;MACA,IAAIJ,OAAA,CAAQK,MAAA,KAAWN,QAAA,CAASM,MAAA,EAAQ;QACtCP,GAAA,CAAIQ,WAAA,CAAYT,IAAA,EAAM;UAAE,GAAGA,IAAA;UAAME,QAAA,EAAUC;QAAQ,CAAC;MACtD;IACF;EACF;AACF,CAAC","ignoreList":[]}

package/dist/types.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}

package/dist/watchFile.mjs

@@ -0,0 +1,7 @@
+const WATCH_FILE_KEY = "__oneWatchFile";
+function notifyFileRead(filePath) {
+  const watchFile = globalThis[WATCH_FILE_KEY];
+  if (watchFile) watchFile(filePath);
+}
+export { notifyFileRead };
+//# sourceMappingURL=watchFile.mjs.map

package/dist/watchFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["WATCH_FILE_KEY","notifyFileRead","filePath","watchFile","globalThis"],"sources":["../src/watchFile.ts"],"sourcesContent":[null],"mappings":"AAAA,MAAMA,cAAA,GAAiB;AAMhB,SAASC,eAAeC,QAAA,EAAwB;EACrD,MAAMC,SAAA,GAAaC,UAAA,CAAmBJ,cAAc;EAGpD,IAAIG,SAAA,EAAWA,SAAA,CAAUD,QAAQ;AACnC","ignoreList":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@vxrn/mdx-rust",
+  "version": "1.20.3",
+  "type": "module",
+  "sideEffects": false,
+  "module": "dist",
+  "types": "./types/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./client": {
+      "types": "./types/client.d.ts",
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs"
+    }
+  },
+  "files": [
+    "src",
+    "types",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tamagui-build --skip-native",
+    "clean": "tamagui-build clean",
+    "clean:build": "tamagui-build clean:build",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "typecheck": "tsc --noEmit",
+    "watch": "bun run build --watch"
+  },
+  "optionalDependencies": {
+    "sharp": "^0.34.5"
+  },
+  "dependencies": {
+    "compare-versions": "^4.1.3",
+    "fast-glob": "^3.3.3",
+    "github-slugger": "^2.0.0",
+    "gray-matter": "^4.0.3",
+    "reading-time": "1.3.0",
+    "satteri": "^0.9.4",
+    "satteri-expressive-code": "^0.1.17"
+  },
+  "peerDependencies": {
+    "react": "*"
+  },
+  "devDependencies": {
+    "@tamagui/build": "2.3.0",
+    "react": "^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/client.ts

@@ -0,0 +1,20 @@
+import * as runtime from 'react/jsx-runtime'
+
+/**
+ * Evaluate the `code` returned by `getMDX` into a React component.
+ *
+ * satteri compiles MDX to a `function-body` module that reads its JSX runtime
+ * from `arguments[0]` and returns `{ default, ...exports }`. Render the result
+ * with a `components` prop: `<Component components={components} />`.
+ *
+ * Browser-safe: imports only React, never satteri's native binding.
+ */
+export function getMDXComponent(
+  code: string,
+  globals: Record<string, unknown> = {}
+): (props: { components?: Record<string, unknown> }) => any {
+  // eslint-disable-next-line no-new-func
+  const fn = new Function(String(code))
+  const mod = fn({ ...runtime, ...globals })
+  return mod.default
+}

package/src/getAllFrontmatter.ts

@@ -0,0 +1,33 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import glob from 'fast-glob'
+import matter from 'gray-matter'
+import readingTime from 'reading-time'
+import { getHeadings } from './getHeadings'
+import type { Frontmatter } from './types'
+import { notifyFileRead } from './watchFile'
+
+// frontmatter for every mdx file under `fromPath`, newest first. reads only the
+// frontmatter, so it stays cheap over hundreds of files.
+export const getAllFrontmatter = (fromPath: string): Frontmatter[] => {
+  const paths = glob.sync(`${fromPath}/**/*.mdx`)
+  return paths
+    .map((filePath) => {
+      notifyFileRead(filePath)
+      const source = fs.readFileSync(filePath, 'utf8')
+      const { data, content } = matter(source)
+      const slug = filePath
+        .replace(`${fromPath.replaceAll('\\', '/')}/`, '')
+        .replace('.mdx', '')
+      return {
+        ...data,
+        slug,
+        headings: getHeadings(source),
+        readingTime: readingTime(content),
+      } as Frontmatter
+    })
+    .sort(
+      (a, b) =>
+        Number(new Date(b.publishedAt || '')) - Number(new Date(a.publishedAt || ''))
+    )
+}

package/src/getHeadings.ts

@@ -0,0 +1,18 @@
+import GithubSlugger from 'github-slugger'
+import type { Heading } from './types'
+
+const getTitle = (source: string) => source.replace(/^#+\s+/, '').replace(/<.*>/, ' ')
+
+// extract headings for a table of contents. ids match the slugs added by
+// slugPlugin during compilation, so anchor links resolve.
+export const getHeadings = (source: string): Heading[] => {
+  const slugger = new GithubSlugger()
+  return source
+    .split('\n')
+    .filter((x) => x.startsWith('#'))
+    .map((x) => ({
+      title: getTitle(x),
+      priority: x.trim().split(' ')[0].length,
+      id: slugger.slug(getTitle(x)),
+    }))
+}

package/src/getMDX.ts

@@ -0,0 +1,90 @@
+import matter from 'gray-matter'
+import readingTime from 'reading-time'
+import { type HastPluginInput, type MdastPluginInput, mdxToJs } from 'satteri'
+import expressiveCode, {
+  type SatteriExpressiveCodeOptions,
+} from 'satteri-expressive-code'
+import { getHeadings } from './getHeadings'
+import { processImageMeta } from './processImageMeta'
+import { slugPlugin } from './slugPlugin'
+import { tableWhitespacePlugin } from './tableWhitespacePlugin'
+import type { Frontmatter, ImageMeta } from './types'
+
+export type GetMDXOptions = {
+  /** public directory for resolving image paths that start with `/` (default: ./public) */
+  publicDir?: string
+  /**
+   * Expressive Code (Shiki) options: themes, frames, styleOverrides, plugins.
+   * Pass `false` to skip syntax highlighting entirely. Defaults to the
+   * `github-dark` theme.
+   */
+  expressiveCode?: SatteriExpressiveCodeOptions | false
+  /** extra satteri mdast plugins, e.g. a hero/demo source injector */
+  mdastPlugins?: MdastPluginInput[]
+  /** extra satteri hast plugins */
+  hastPlugins?: HastPluginInput[]
+}
+
+const DEFAULT_EC: SatteriExpressiveCodeOptions = { themes: ['github-dark'] }
+
+// the Expressive Code plugin caches its Shiki renderer (themes + grammars) for
+// its lifetime, so we reuse one instance per config across every getMDX call
+// instead of paying the warmup on every file.
+const ecByKey = new Map<string, ReturnType<typeof expressiveCode>>()
+function getExpressiveCode(opts: SatteriExpressiveCodeOptions) {
+  const key = (() => {
+    try {
+      return JSON.stringify(opts)
+    } catch {
+      return null
+    }
+  })()
+  if (key == null) return expressiveCode(opts)
+  let plugin = ecByKey.get(key)
+  if (!plugin) {
+    plugin = expressiveCode(opts)
+    ecByKey.set(key, plugin)
+  }
+  return plugin
+}
+
+/**
+ * Compile an MDX string to an evaluatable component module using satteri (Rust)
+ * for parsing/compilation and Expressive Code (Shiki) for code highlighting.
+ * Evaluate the returned `code` with `getMDXComponent` from `@vxrn/mdx-rust/client`.
+ */
+export async function getMDX(
+  source: string,
+  options: GetMDXOptions = {}
+): Promise<{ frontmatter: Frontmatter; code: string }> {
+  const { data, content } = matter(source)
+
+  const ec =
+    options.expressiveCode === false
+      ? []
+      : [getExpressiveCode(options.expressiveCode ?? DEFAULT_EC)]
+
+  const { code } = await mdxToJs(source, {
+    outputFormat: 'function-body',
+    jsxImportSource: 'react',
+    features: { gfm: true, smartPunctuation: true, frontmatter: true },
+    mdastPlugins: [...(options.mdastPlugins ?? [])],
+    hastPlugins: [slugPlugin, tableWhitespacePlugin, ...ec, ...(options.hastPlugins ?? [])],
+  })
+
+  let imageMeta: ImageMeta | undefined
+  if (data.image && typeof data.image === 'string') {
+    const meta = await processImageMeta(data.image, { publicDir: options.publicDir })
+    if (meta) imageMeta = meta
+  }
+
+  return {
+    frontmatter: {
+      ...data,
+      headings: getHeadings(source),
+      readingTime: readingTime(content),
+      imageMeta,
+    } as Frontmatter,
+    code,
+  }
+}

package/src/getMDXBySlug.ts

@@ -0,0 +1,34 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import compareVersions from 'compare-versions'
+import { type GetMDXOptions, getMDX } from './getMDX'
+import type { Frontmatter } from './types'
+import { notifyFileRead } from './watchFile'
+
+export const getMDXBySlug = async (
+  basePath: string,
+  slug: string,
+  options?: GetMDXOptions
+): Promise<{ frontmatter: Frontmatter; code: string }> => {
+  let mdxPath = slug
+
+  // if no version given, resolve to the latest
+  if (!slug.includes('.') && basePath.includes('components')) {
+    const versions = getAllVersionsFromPath(path.join(basePath, slug))
+    mdxPath += `/${versions[0]}`
+  }
+
+  const filePath = path.join(basePath, `${mdxPath}.mdx`)
+  notifyFileRead(filePath)
+  const source = fs.readFileSync(filePath, 'utf8')
+  return getMDX(source, options)
+}
+
+export function getAllVersionsFromPath(fromPath: string): string[] {
+  if (!fs.existsSync(fromPath)) return []
+  return fs
+    .readdirSync(fromPath)
+    .map((fileName) => fileName.replace('.mdx', ''))
+    .sort(compareVersions)
+    .reverse()
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+export { getMDX, type GetMDXOptions } from './getMDX'
+export { getAllVersionsFromPath, getMDXBySlug } from './getMDXBySlug'
+export { getAllFrontmatter } from './getAllFrontmatter'
+export { getHeadings } from './getHeadings'
+export { slugPlugin } from './slugPlugin'
+export { tableWhitespacePlugin } from './tableWhitespacePlugin'
+export { processImageMeta } from './processImageMeta'
+export { notifyFileRead } from './watchFile'
+export type { Frontmatter, Heading, ImageMeta } from './types'

package/src/processImageMeta.ts

@@ -0,0 +1,38 @@
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+import type { ImageMeta } from './types'
+
+async function getSharp(): Promise<typeof import('sharp') | null> {
+  try {
+    const sharpModule = await import('sharp')
+    return (sharpModule as any).default || sharpModule
+  } catch {
+    return null
+  }
+}
+
+/** Read an image's dimensions and a tiny blur placeholder. Null if sharp is
+ *  not installed or the file is missing. */
+export async function processImageMeta(
+  imagePath: string,
+  opts?: { publicDir?: string }
+): Promise<ImageMeta | null> {
+  const publicDir = opts?.publicDir ?? './public'
+  const filePath = imagePath.startsWith('/')
+    ? resolve(publicDir, imagePath.slice(1))
+    : resolve(imagePath)
+
+  if (!existsSync(filePath)) return null
+  const sharp = await getSharp()
+  if (!sharp) return null
+
+  try {
+    const image = sharp(filePath)
+    const { width = 0, height = 0 } = await image.metadata()
+    const blurBuffer = await image.resize(10).blur().jpeg({ quality: 40 }).toBuffer()
+    const blurDataURL = `data:image/jpeg;base64,${blurBuffer.toString('base64')}`
+    return { width, height, blurDataURL }
+  } catch {
+    return null
+  }
+}

package/src/slugPlugin.ts

@@ -0,0 +1,28 @@
+import GithubSlugger from 'github-slugger'
+import { defineHastPlugin } from 'satteri'
+
+function textOf(node: any): string {
+  if (node.type === 'text') return node.value || ''
+  if (node.children) return node.children.map(textOf).join('')
+  return ''
+}
+
+// adds github-style id slugs to headings so table-of-contents anchors resolve.
+// used as a factory so the slugger's dedupe counter resets per document.
+export const slugPlugin = () => {
+  const slugger = new GithubSlugger()
+  return defineHastPlugin({
+    name: 'vxrn-heading-slugs',
+    element: {
+      filter: ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'],
+      visit(node: any, ctx: any) {
+        if (node.properties?.id) return
+        const id = slugger.slug(textOf(node))
+        ctx.replaceNode(node, {
+          ...node,
+          properties: { ...node.properties, id },
+        })
+      },
+    },
+  })
+}

package/src/tableWhitespacePlugin.ts

@@ -0,0 +1,23 @@
+import { defineHastPlugin } from 'satteri'
+
+// satteri (via pulldown-cmark) keeps the newline text nodes between table
+// elements; they become stray children of the table/row nodes, which trips
+// React's "whitespace text nodes cannot be a child of <table>" hydration
+// warning and can spawn anonymous table cells. strip whitespace-only children
+// from table structural elements, matching remark-rehype's clean output.
+export const tableWhitespacePlugin = defineHastPlugin({
+  name: 'vxrn-strip-table-whitespace',
+  element: {
+    filter: ['table', 'thead', 'tbody', 'tr'],
+    visit(node: any, ctx: any) {
+      const children = node.children || []
+      const cleaned = children.filter(
+        (c: any) =>
+          !(c.type === 'text' && typeof c.value === 'string' && c.value.trim() === '')
+      )
+      if (cleaned.length !== children.length) {
+        ctx.replaceNode(node, { ...node, children: cleaned })
+      }
+    },
+  },
+})

package/src/types.ts

@@ -0,0 +1,30 @@
+export type ImageMeta = {
+  width: number
+  height: number
+  blurDataURL: string
+}
+
+export type Heading = { title: string; priority: number; id: string }
+
+export type Frontmatter = {
+  title: string
+  headings?: Heading[]
+  description?: string
+  name?: string
+  versions?: string[]
+  version?: string
+  by?: string
+  publishedAt?: string
+  draft?: boolean
+  relatedIds?: string[]
+  type?: 'changelog' | string
+  readingTime?: { text: string; minutes: number; time: number; words: number }
+  poster?: string
+  slug: string
+  image?: string
+  /** image dimensions and blur placeholder, populated if `image` exists and sharp is installed */
+  imageMeta?: ImageMeta
+  component?: string
+  package?: string
+  demoName?: string
+}

package/src/watchFile.ts

@@ -0,0 +1,12 @@
+const WATCH_FILE_KEY = '__oneWatchFile'
+
+/**
+ * Notifies One's HMR system about a file dependency so the page hot-reloads
+ * when the file changes. No-op when One is not present or in production.
+ */
+export function notifyFileRead(filePath: string): void {
+  const watchFile = (globalThis as any)[WATCH_FILE_KEY] as
+    | ((path: string) => void)
+    | undefined
+  if (watchFile) watchFile(filePath)
+}

package/types/client.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Evaluate the `code` returned by `getMDX` into a React component.
+ *
+ * satteri compiles MDX to a `function-body` module that reads its JSX runtime
+ * from `arguments[0]` and returns `{ default, ...exports }`. Render the result
+ * with a `components` prop: `<Component components={components} />`.
+ *
+ * Browser-safe: imports only React, never satteri's native binding.
+ */
+export declare function getMDXComponent(code: string, globals?: Record<string, unknown>): (props: {
+    components?: Record<string, unknown>;
+}) => any;
+//# sourceMappingURL=client.d.ts.map

package/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,CAAC,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAK,GAAG,CAK1D"}

package/types/getAllFrontmatter.d.ts

@@ -0,0 +1,3 @@
+import type { Frontmatter } from './types';
+export declare const getAllFrontmatter: (fromPath: string) => Frontmatter[];
+//# sourceMappingURL=getAllFrontmatter.d.ts.map

package/types/getAllFrontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAllFrontmatter.d.ts","sourceRoot":"","sources":["../src/getAllFrontmatter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAK1C,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,WAAW,EAqB/D,CAAA"}

package/types/getHeadings.d.ts

@@ -0,0 +1,3 @@
+import type { Heading } from './types';
+export declare const getHeadings: (source: string) => Heading[];
+//# sourceMappingURL=getHeadings.d.ts.map

package/types/getHeadings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHeadings.d.ts","sourceRoot":"","sources":["../src/getHeadings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMtC,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,OAAO,EAUnD,CAAA"}

package/types/getMDX.d.ts

@@ -0,0 +1,27 @@
+import { type HastPluginInput, type MdastPluginInput } from 'satteri';
+import { type SatteriExpressiveCodeOptions } from 'satteri-expressive-code';
+import type { Frontmatter } from './types';
+export type GetMDXOptions = {
+    /** public directory for resolving image paths that start with `/` (default: ./public) */
+    publicDir?: string;
+    /**
+     * Expressive Code (Shiki) options: themes, frames, styleOverrides, plugins.
+     * Pass `false` to skip syntax highlighting entirely. Defaults to the
+     * `github-dark` theme.
+     */
+    expressiveCode?: SatteriExpressiveCodeOptions | false;
+    /** extra satteri mdast plugins, e.g. a hero/demo source injector */
+    mdastPlugins?: MdastPluginInput[];
+    /** extra satteri hast plugins */
+    hastPlugins?: HastPluginInput[];
+};
+/**
+ * Compile an MDX string to an evaluatable component module using satteri (Rust)
+ * for parsing/compilation and Expressive Code (Shiki) for code highlighting.
+ * Evaluate the returned `code` with `getMDXComponent` from `@vxrn/mdx-rust/client`.
+ */
+export declare function getMDX(source: string, options?: GetMDXOptions): Promise<{
+    frontmatter: Frontmatter;
+    code: string;
+}>;
+//# sourceMappingURL=getMDX.d.ts.map

package/types/getMDX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMDX.d.ts","sourceRoot":"","sources":["../src/getMDX.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAW,MAAM,SAAS,CAAA;AAC9E,OAAuB,EACrB,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,SAAS,CAAA;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,4BAA4B,GAAG,KAAK,CAAA;IACrD,oEAAoE;IACpE,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACjC,iCAAiC;IACjC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;CAChC,CAAA;AAyBD;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BrD"}

package/types/getMDXBySlug.d.ts

@@ -0,0 +1,8 @@
+import { type GetMDXOptions } from './getMDX';
+import type { Frontmatter } from './types';
+export declare const getMDXBySlug: (basePath: string, slug: string, options?: GetMDXOptions) => Promise<{
+    frontmatter: Frontmatter;
+    code: string;
+}>;
+export declare function getAllVersionsFromPath(fromPath: string): string[];
+//# sourceMappingURL=getMDXBySlug.d.ts.map

package/types/getMDXBySlug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMDXBySlug.d.ts","sourceRoot":"","sources":["../src/getMDXBySlug.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,UAAU,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,UAAU,aAAa,KACtB,OAAO,CAAC;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAapD,CAAA;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjE"}

package/types/index.d.ts

@@ -0,0 +1,10 @@
+export { getMDX, type GetMDXOptions } from './getMDX';
+export { getAllVersionsFromPath, getMDXBySlug } from './getMDXBySlug';
+export { getAllFrontmatter } from './getAllFrontmatter';
+export { getHeadings } from './getHeadings';
+export { slugPlugin } from './slugPlugin';
+export { tableWhitespacePlugin } from './tableWhitespacePlugin';
+export { processImageMeta } from './processImageMeta';
+export { notifyFileRead } from './watchFile';
+export type { Frontmatter, Heading, ImageMeta } from './types';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/types/processImageMeta.d.ts

@@ -0,0 +1,7 @@
+import type { ImageMeta } from './types';
+/** Read an image's dimensions and a tiny blur placeholder. Null if sharp is
+ *  not installed or the file is missing. */
+export declare function processImageMeta(imagePath: string, opts?: {
+    publicDir?: string;
+}): Promise<ImageMeta | null>;
+//# sourceMappingURL=processImageMeta.d.ts.map

package/types/processImageMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processImageMeta.d.ts","sourceRoot":"","sources":["../src/processImageMeta.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAWxC;4CAC4C;AAC5C,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAmB3B"}

package/types/slugPlugin.d.ts

@@ -0,0 +1,8 @@
+export declare const slugPlugin: () => {
+    name: string;
+    element: {
+        filter: string[];
+        visit(node: any, ctx: any): void;
+    };
+};
+//# sourceMappingURL=slugPlugin.d.ts.map

package/types/slugPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugPlugin.d.ts","sourceRoot":"","sources":["../src/slugPlugin.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,UAAU;;;;oBAML,GAAG,OAAO,GAAG;;CAU9B,CAAA"}

package/types/tableWhitespacePlugin.d.ts

@@ -0,0 +1,8 @@
+export declare const tableWhitespacePlugin: {
+    name: string;
+    element: {
+        filter: string[];
+        visit(node: any, ctx: any): void;
+    };
+};
+//# sourceMappingURL=tableWhitespacePlugin.d.ts.map

package/types/tableWhitespacePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableWhitespacePlugin.d.ts","sourceRoot":"","sources":["../src/tableWhitespacePlugin.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,qBAAqB;;;;oBAIlB,GAAG,OAAO,GAAG;;CAW3B,CAAA"}

package/types/types.d.ts

@@ -0,0 +1,38 @@
+export type ImageMeta = {
+    width: number;
+    height: number;
+    blurDataURL: string;
+};
+export type Heading = {
+    title: string;
+    priority: number;
+    id: string;
+};
+export type Frontmatter = {
+    title: string;
+    headings?: Heading[];
+    description?: string;
+    name?: string;
+    versions?: string[];
+    version?: string;
+    by?: string;
+    publishedAt?: string;
+    draft?: boolean;
+    relatedIds?: string[];
+    type?: 'changelog' | string;
+    readingTime?: {
+        text: string;
+        minutes: number;
+        time: number;
+        words: number;
+    };
+    poster?: string;
+    slug: string;
+    image?: string;
+    /** image dimensions and blur placeholder, populated if `image` exists and sharp is installed */
+    imageMeta?: ImageMeta;
+    component?: string;
+    package?: string;
+    demoName?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/types/watchFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Notifies One's HMR system about a file dependency so the page hot-reloads
+ * when the file changes. No-op when One is not present or in production.
+ */
+export declare function notifyFileRead(filePath: string): void;
+//# sourceMappingURL=watchFile.d.ts.map

package/types/watchFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchFile.d.ts","sourceRoot":"","sources":["../src/watchFile.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKrD"}