npm - @suzumiyaaoba/mdxr - Versions diffs - 0.1.0 - Mend

@suzumiyaaoba/mdxr 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (236) hide show

package/LICENSE +21 -0
package/README.md +56 -0
package/dist/cli.d.mts +1 -0
package/dist/cli.mjs +2902 -0
package/dist/components.d.mts +791 -0
package/dist/components.mjs +2 -0
package/dist/config-SI9IyFiC.mjs +184 -0
package/dist/doc-context-CEqzMYKv.d.mts +568 -0
package/dist/index.d.mts +20 -0
package/dist/index.mjs +4 -0
package/dist/ui-GKFD0mx5.mjs +15986 -0
package/package.json +131 -0
package/skill/SKILL.md +49 -0
package/skill/references/components/charts.md +172 -0
package/skill/references/components/document.md +98 -0
package/skill/references/components/forms.md +35 -0
package/skill/references/components/investigation.md +198 -0
package/skill/references/components/layout.md +68 -0
package/skill/references/components/output.md +158 -0
package/skill/references/components/planning.md +155 -0
package/skill/references/components/reports.md +252 -0
package/skill/references/components/shadcn.md +19 -0
package/skill/references/components.md +186 -0
package/skill/references/extending.md +48 -0
package/src/ask-sheet.ts +40 -0
package/src/assets/css.ts +392 -0
package/src/assets/scripts.ts +78 -0
package/src/catalog.ts +287 -0
package/src/cli.ts +178 -0
package/src/client/doc-events.ts +1108 -0
package/src/client/entry.ts +27 -0
package/src/client-js.ts +47 -0
package/src/component-map.ts +47 -0
package/src/components/ui/accordion.tsx +77 -0
package/src/components/ui/alert-dialog.tsx +185 -0
package/src/components/ui/alert.tsx +76 -0
package/src/components/ui/aspect-ratio.tsx +22 -0
package/src/components/ui/attachment.tsx +208 -0
package/src/components/ui/avatar.tsx +106 -0
package/src/components/ui/badge.tsx +52 -0
package/src/components/ui/breadcrumb.tsx +121 -0
package/src/components/ui/bubble.tsx +128 -0
package/src/components/ui/button-group.tsx +88 -0
package/src/components/ui/button.tsx +58 -0
package/src/components/ui/calendar.tsx +226 -0
package/src/components/ui/card.tsx +102 -0
package/src/components/ui/carousel.tsx +246 -0
package/src/components/ui/chart.tsx +379 -0
package/src/components/ui/checkbox.tsx +27 -0
package/src/components/ui/collapsible.tsx +19 -0
package/src/components/ui/combobox.tsx +298 -0
package/src/components/ui/command.tsx +193 -0
package/src/components/ui/context-menu.tsx +271 -0
package/src/components/ui/dialog.tsx +159 -0
package/src/components/ui/direction.tsx +4 -0
package/src/components/ui/drawer.tsx +227 -0
package/src/components/ui/dropdown-menu.tsx +269 -0
package/src/components/ui/empty.tsx +104 -0
package/src/components/ui/field.tsx +237 -0
package/src/components/ui/fieldset.tsx +32 -0
package/src/components/ui/frame.tsx +87 -0
package/src/components/ui/hover-card.tsx +50 -0
package/src/components/ui/input-group.tsx +159 -0
package/src/components/ui/input-otp.tsx +83 -0
package/src/components/ui/input.tsx +19 -0
package/src/components/ui/item.tsx +202 -0
package/src/components/ui/kbd.tsx +26 -0
package/src/components/ui/label.tsx +19 -0
package/src/components/ui/marker.tsx +71 -0
package/src/components/ui/menubar.tsx +284 -0
package/src/components/ui/message-scroller.tsx +128 -0
package/src/components/ui/message.tsx +91 -0
package/src/components/ui/meter.tsx +80 -0
package/src/components/ui/native-select.tsx +64 -0
package/src/components/ui/navigation-menu.tsx +170 -0
package/src/components/ui/pagination.tsx +133 -0
package/src/components/ui/popover.tsx +87 -0
package/src/components/ui/progress.tsx +82 -0
package/src/components/ui/questionnaire.tsx +328 -0
package/src/components/ui/radio-group.tsx +35 -0
package/src/components/ui/resizable.tsx +49 -0
package/src/components/ui/scroll-area.tsx +50 -0
package/src/components/ui/select.tsx +201 -0
package/src/components/ui/separator.tsx +22 -0
package/src/components/ui/sheet.tsx +135 -0
package/src/components/ui/sidebar.tsx +730 -0
package/src/components/ui/skeleton.tsx +13 -0
package/src/components/ui/slider.tsx +51 -0
package/src/components/ui/spinner.tsx +16 -0
package/src/components/ui/switch.tsx +31 -0
package/src/components/ui/table.tsx +113 -0
package/src/components/ui/tabs.tsx +82 -0
package/src/components/ui/textarea.tsx +17 -0
package/src/components/ui/toast.tsx +229 -0
package/src/components/ui/toggle-group.tsx +87 -0
package/src/components/ui/toggle.tsx +43 -0
package/src/components/ui/tooltip.tsx +65 -0
package/src/components.ts +78 -0
package/src/config.ts +56 -0
package/src/define.ts +122 -0
package/src/doc-context.ts +20 -0
package/src/editor.ts +94 -0
package/src/format-error.ts +78 -0
package/src/guards.ts +84 -0
package/src/hooks/use-mobile.ts +21 -0
package/src/html.ts +91 -0
package/src/hydrate/export-index.ts +232 -0
package/src/hydrate/import-scan.ts +169 -0
package/src/hydrate/plugins.ts +118 -0
package/src/hydrate/runtime-module.ts +145 -0
package/src/hydrate-runtime.ts +67 -0
package/src/hydrate.ts +147 -0
package/src/index.ts +16 -0
package/src/init.ts +57 -0
package/src/langs.ts +148 -0
package/src/lines.ts +53 -0
package/src/load-user-module.ts +191 -0
package/src/mdx.ts +248 -0
package/src/paths.ts +36 -0
package/src/rehype/shiki.ts +533 -0
package/src/remark/alerts.ts +53 -0
package/src/remark/ast.ts +96 -0
package/src/remark/callouts.ts +25 -0
package/src/remark/code-file.ts +85 -0
package/src/remark/code-meta.ts +21 -0
package/src/remark/directives.ts +170 -0
package/src/remark/file-paths.ts +64 -0
package/src/remark/headings.ts +131 -0
package/src/remark/no-js.ts +40 -0
package/src/render.ts +337 -0
package/src/serve.ts +322 -0
package/src/styles/globals.css +134 -0
package/src/styles/shadcn.css +641 -0
package/src/tailwind.ts +119 -0
package/src/ui/approvals.tsx +76 -0
package/src/ui/ask-question.tsx +386 -0
package/src/ui/ask.tsx +206 -0
package/src/ui/attrs.ts +51 -0
package/src/ui/audit.tsx +139 -0
package/src/ui/bar-chart.tsx +334 -0
package/src/ui/benchmarks.tsx +143 -0
package/src/ui/bits.tsx +537 -0
package/src/ui/board.tsx +173 -0
package/src/ui/bridge.tsx +207 -0
package/src/ui/bumps.tsx +178 -0
package/src/ui/callout.tsx +106 -0
package/src/ui/changes.tsx +89 -0
package/src/ui/chart-bits.tsx +52 -0
package/src/ui/chart.ts +577 -0
package/src/ui/checks.tsx +203 -0
package/src/ui/child-index.tsx +44 -0
package/src/ui/children.ts +43 -0
package/src/ui/chips.tsx +49 -0
package/src/ui/cmd.tsx +27 -0
package/src/ui/columns.tsx +31 -0
package/src/ui/comments.tsx +544 -0
package/src/ui/compare.tsx +67 -0
package/src/ui/decision.tsx +79 -0
package/src/ui/deps.tsx +78 -0
package/src/ui/details.tsx +43 -0
package/src/ui/diff-parse.ts +307 -0
package/src/ui/diff.tsx +458 -0
package/src/ui/diffstat.tsx +58 -0
package/src/ui/due.tsx +65 -0
package/src/ui/effort.tsx +29 -0
package/src/ui/endpoints.tsx +118 -0
package/src/ui/envvars.tsx +96 -0
package/src/ui/figure.tsx +37 -0
package/src/ui/file-icon.ts +1020 -0
package/src/ui/file-link.ts +32 -0
package/src/ui/file-ref.tsx +39 -0
package/src/ui/files.tsx +112 -0
package/src/ui/findings.tsx +85 -0
package/src/ui/flow.tsx +73 -0
package/src/ui/funnel.tsx +121 -0
package/src/ui/gantt.tsx +443 -0
package/src/ui/gauges.tsx +135 -0
package/src/ui/glossary.tsx +29 -0
package/src/ui/graph-layout.ts +149 -0
package/src/ui/graph-specs.tsx +102 -0
package/src/ui/graph.tsx +278 -0
package/src/ui/grid.tsx +119 -0
package/src/ui/hypothesis.tsx +94 -0
package/src/ui/icon.tsx +80 -0
package/src/ui/incident.tsx +130 -0
package/src/ui/index.ts +342 -0
package/src/ui/ins-del.tsx +41 -0
package/src/ui/json.tsx +190 -0
package/src/ui/layout.ts +9 -0
package/src/ui/line-chart.tsx +251 -0
package/src/ui/matrix.tsx +208 -0
package/src/ui/meta.tsx +73 -0
package/src/ui/option.tsx +64 -0
package/src/ui/owner.tsx +40 -0
package/src/ui/packages.tsx +104 -0
package/src/ui/pathway.tsx +96 -0
package/src/ui/phase.tsx +41 -0
package/src/ui/pie-chart.tsx +170 -0
package/src/ui/plan.tsx +77 -0
package/src/ui/pre.tsx +175 -0
package/src/ui/priority.tsx +51 -0
package/src/ui/props.tsx +77 -0
package/src/ui/quadrant.tsx +172 -0
package/src/ui/radar.tsx +200 -0
package/src/ui/ref.tsx +160 -0
package/src/ui/release.tsx +178 -0
package/src/ui/req.tsx +42 -0
package/src/ui/review.tsx +133 -0
package/src/ui/risk.tsx +67 -0
package/src/ui/sankey.tsx +287 -0
package/src/ui/scatter.tsx +237 -0
package/src/ui/schema.tsx +113 -0
package/src/ui/score.tsx +105 -0
package/src/ui/search.tsx +120 -0
package/src/ui/series.tsx +38 -0
package/src/ui/severity.tsx +69 -0
package/src/ui/shadcn.tsx +216 -0
package/src/ui/spark.tsx +86 -0
package/src/ui/stack.tsx +57 -0
package/src/ui/stats.tsx +63 -0
package/src/ui/status-badge.tsx +66 -0
package/src/ui/statuspage.tsx +238 -0
package/src/ui/steps.tsx +74 -0
package/src/ui/summary.tsx +41 -0
package/src/ui/symbol-ref.tsx +73 -0
package/src/ui/terminal.tsx +117 -0
package/src/ui/tests.tsx +218 -0
package/src/ui/timeline.tsx +63 -0
package/src/ui/toc.tsx +56 -0
package/src/ui/tones.ts +187 -0
package/src/ui/trace.tsx +69 -0
package/src/ui/tree.tsx +281 -0
package/src/ui/treemap.tsx +128 -0
package/src/ui/venn.tsx +258 -0
package/src/ui/verdict.tsx +78 -0
package/src/ui/waterfall.tsx +142 -0

package/src/html.ts ADDED Viewed

@@ -0,0 +1,91 @@
+import { icons as lucide } from "@iconify-json/lucide";
+import {
+  KATEX_CDN_URL,
+  LIVE_RELOAD_JS,
+  MERMAID_JS,
+  THEME_JS,
+} from "./assets/scripts.js";
+/**
+ * JS destined for an inline `<script>` element: neutralize the two byte
+ * sequences the HTML parser treats specially (`</script` ends the element,
+ * `<!--` opens a comment escape). `\u003C` keeps the meaning in strings,
+ * comments, and regex literals alike. Applied centrally here so every
+ * snippet — authored constants, the client bundle, the hydrate bundle —
+ * is safe regardless of its producer.
+ */
+export const inlineScript = (js: string): string =>
+  js
+    .replaceAll(/<\/script/giu, "\\u003C/script")
+    .replaceAll("<!--", "\\u003C!--");
+/**
+ * Inline `<style>` content: a `</style` byte sequence inside the CSS (e.g. a
+ * `content:` string in user theme CSS) would end the element early. `<\/`
+ * reads identically inside CSS strings/comments, so it's safe to emit.
+ */
+export const inlineStyle = (css: string): string =>
+  css.replaceAll(/<\/style/giu, "<\\/style");
+const ESCAPES: Record<string, string> = {
+  '"': "&quot;",
+  "&": "&amp;",
+  "'": "&#39;",
+  "<": "&lt;",
+  ">": "&gt;",
+};
+const escapeHtml = (s: string): string =>
+  s.replaceAll(/[&<>"']/gu, (c) => ESCAPES[c] ?? c);
+/** Inline SVG from the bundled lucide set (bodies carry stroke attrs). */
+const iconSvg = (name: string): string => {
+  const icon = lucide.icons[name];
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 ${icon?.width ?? 24} ${icon?.height ?? 24}" class="lucide" aria-hidden="true">${icon?.body ?? ""}</svg>`;
+};
+/**
+ * Theme toggle button — document chrome fixed to the top-right corner.
+ * `data-mode` selects the visible icon (auto → light → dark, cycled by
+ * `handleDocEvent`); THEME_JS restores the stored choice before paint.
+ */
+const THEME_TOGGLE_HTML = `<button type="button" class="mdxr-theme" data-mdxr-theme data-mode="auto" title="Theme: auto" aria-label="Switch theme (current: auto)"><span class="mdxr-theme-i mdxr-theme-i-auto">${iconSvg("sun-moon")}</span><span class="mdxr-theme-i mdxr-theme-i-light">${iconSvg("sun")}</span><span class="mdxr-theme-i mdxr-theme-i-dark">${iconSvg("moon")}</span></button>`;
+export interface DocumentOptions {
+  title: string;
+  body: string;
+  css: string;
+  /** Vanilla client bundle from `clientJs()` (copy/ask/theme handlers). */
+  clientJs: string;
+  needsMermaid: boolean;
+  needsKatex?: boolean;
+  liveReload?: boolean;
+  /**
+   * Client bundle that `hydrateRoot`s the compiled MDX module onto
+   * `<main id="mdxr-root">`, making Base UI primitives interactive.
+   */
+  hydrateJs?: string;
+}
+export const htmlDocument = (o: DocumentOptions): string => `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="generator" content="mdxr">
+<title>${escapeHtml(o.title)}</title>
+<script>${inlineScript(THEME_JS)}</script>
+${o.needsKatex === true ? `<link rel="stylesheet" href="${KATEX_CDN_URL}">` : ""}
+<style>${inlineStyle(o.css)}</style>
+</head>
+<body class="bg-white text-neutral-900 antialiased dark:bg-neutral-950 dark:text-neutral-100">
+${THEME_TOGGLE_HTML}
+<main id="mdxr-root" class="prose prose-neutral dark:prose-invert mx-auto max-w-3xl px-6 py-10">${o.body}</main>
+<script>${inlineScript(o.clientJs)}</script>
+${o.needsMermaid ? `<script type="module">${inlineScript(MERMAID_JS)}</script>` : ""}
+${o.liveReload === true ? `<script>${inlineScript(LIVE_RELOAD_JS)}</script>` : ""}
+${o.hydrateJs === undefined ? "" : `<script>${inlineScript(o.hydrateJs)}</script>`}
+</body>
+</html>
+`;

package/src/hydrate/export-index.ts ADDED Viewed

@@ -0,0 +1,232 @@
+/**
+ * Export-surface scanning for the hydration bundle: which leaf module
+ * provides each public name, and which names each public specifier
+ * (`@suzumiyaaoba/mdxr`, `…/components`) actually exports. Derived by
+ * scanning the
+ * leaf modules under `src/ui/` + `src/components/ui/` rather than parsing
+ * barrels: any export form (`export *`, `export const`, `export {X}` lists,
+ * re-export chains like ask→ask-question) resolves correctly, and new leaf
+ * files self-register.
+ */
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { srcDir } from "../paths.js";
+import { shadcnModules } from "../ui/shadcn.js";
+let exportIndexCache: ExportIndex | undefined;
+const DECLARE_RE = /export\s+(?:const|function|class)\s+(?<name>\w+)/gu;
+const REEXPORT_RE =
+  /export\s+(?!type\b)\{(?<names>[^}]*)\}\s*from\s*"(?<mod>\.[^"]+)"/gu;
+/** `export * as name from "x"` — the exported name is `name`. */
+const STAR_AS_RE = /export\s+\*\s+as\s+(?<name>\w+)\s+from\s*"[^"]+"/gu;
+/** `export * from "./x.js"` — the surface walk follows relative targets. */
+const STAR_RE = /export\s+\*\s+from\s*"(?<mod>\.[^"]+)"/gu;
+/** `export { A, B as C }` with no `from` — local re-export list (shadcn style). */
+const LOCAL_EXPORT_RE = /export\s+(?!type\b)\{(?<names>[^}]*)\}(?!\s*from\b)/gu;
+/**
+ * `{ A, type B, C as D }` clause → runtime names importers see (`A`, `D`).
+ * `type`-marked parts are erased at runtime — emitting `export { B } from "m"`
+ * for one would explode the whole bundle with "no matching export".
+ */
+const exportedNames = (names: string | undefined): string[] =>
+  (names ?? "")
+    .split(",")
+    .map((part) => part.trim())
+    .filter((part) => part !== "" && !part.startsWith("type "))
+    .map(
+      (part) =>
+        part
+          .split(/\s+as\s+/u)
+          .pop()
+          ?.trim() ?? ""
+    )
+    .filter((name) => name !== "");
+/** `[exportName, target]` pairs a leaf module re-exports (`export {X as Y} from "./z"`). */
+const reexportTargets = (
+  source: string,
+  dir: string
+): (readonly [string, string])[] => {
+  const pairs: (readonly [string, string])[] = [];
+  for (const m of source.matchAll(REEXPORT_RE)) {
+    const mod = path.join(dir, m.groups?.mod ?? "");
+    for (const name of exportedNames(m.groups?.names)) {
+      pairs.push([name, mod]);
+    }
+  }
+  return pairs;
+};
+/** A `./x.js` specifier in our sources maps to `./x.ts`/`.tsx` on disk. */
+const sourceFile = (spec: string, dir: string): string | undefined => {
+  const stem = path.resolve(dir, spec).replace(/\.js$/u, "");
+  for (const ext of [".ts", ".tsx", ".js"]) {
+    const p = `${stem}${ext}`;
+    if (existsSync(p)) {
+      return p;
+    }
+  }
+  return undefined;
+};
+/** Every runtime-exported name in `source` lands in `out`. */
+const collectNames = (source: string, out: Set<string>): void => {
+  for (const m of source.matchAll(DECLARE_RE)) {
+    const name = m.groups?.name;
+    if (name !== undefined) {
+      out.add(name);
+    }
+  }
+  for (const m of source.matchAll(STAR_AS_RE)) {
+    const name = m.groups?.name;
+    if (name !== undefined) {
+      out.add(name);
+    }
+  }
+  for (const re of [REEXPORT_RE, LOCAL_EXPORT_RE]) {
+    for (const m of source.matchAll(re)) {
+      for (const name of exportedNames(m.groups?.names)) {
+        out.add(name);
+      }
+    }
+  }
+};
+/**
+ * Every name `entry` re-exports, chasing `export *` targets — the surface the
+ * real package shows importers. Type-only exports never match the regexes
+ * (`export type`, `type X` parts), so the set holds runtime names only.
+ */
+const collectSurface = async (entry: string): Promise<Set<string>> => {
+  const out = new Set<string>();
+  const seen = new Set<string>();
+  const walk = async (file: string): Promise<void> => {
+    if (seen.has(file)) {
+      return;
+    }
+    seen.add(file);
+    let source: string;
+    try {
+      source = await readFile(file, "utf-8");
+    } catch {
+      return;
+    }
+    collectNames(source, out);
+    const dir = path.dirname(file);
+    const starTargets: string[] = [];
+    for (const m of source.matchAll(STAR_RE)) {
+      const mod = m.groups?.mod;
+      if (mod === undefined) {
+        continue;
+      }
+      const target = sourceFile(mod, dir);
+      if (target !== undefined) {
+        starTargets.push(target);
+      }
+    }
+    await Promise.all(starTargets.map(walk));
+  };
+  await walk(entry);
+  return out;
+};
+export interface ExportIndex {
+  /** export name → leaf module, for every name a public entry can produce. */
+  map: Map<string, string>;
+  /**
+   * Names each public specifier actually exports — the virtual module must
+   * not resolve beyond this, or the client would see a real value where SSR's
+   * import failed or bound `undefined` (e.g. `mountDocument`, leaf internals
+   * like `fileIcon` under the root entry, or `v` under `/components`).
+   */
+  surfaces: { components: Set<string>; mdxr: Set<string> };
+}
+/**
+ * All `name → module` pairs a leaf file claims — declarations plus every
+ * re-export form. Returned rather than written into a shared map: callers
+ * merge in sorted filename order, so a duplicated export name resolves
+ * deterministically instead of racing whichever `readFile` finished last.
+ */
+const scanLeaf = async (
+  filePath: string
+): Promise<(readonly [string, string])[]> => {
+  const source = await readFile(filePath, "utf-8");
+  const dir = path.dirname(filePath);
+  const pairs: (readonly [string, string])[] = [];
+  for (const m of source.matchAll(DECLARE_RE)) {
+    const name = m.groups?.name;
+    if (name !== undefined) {
+      pairs.push([name, filePath]);
+    }
+  }
+  for (const [name, mod] of reexportTargets(source, dir)) {
+    pairs.push([name, mod]);
+  }
+  for (const m of source.matchAll(LOCAL_EXPORT_RE)) {
+    for (const name of exportedNames(m.groups?.names)) {
+      pairs.push([name, filePath]);
+    }
+  }
+  for (const m of source.matchAll(STAR_AS_RE)) {
+    const name = m.groups?.name;
+    if (name !== undefined) {
+      pairs.push([name, filePath]);
+    }
+  }
+  return pairs;
+};
+/**
+ * export name → module specifier for every name the catalog can produce,
+ * plus the real export surface of each public specifier.
+ */
+// Exported for tests — the surface contract is what keeps SSR and the
+// hydration bundle in agreement; it deserves direct assertions.
+export const exportIndex = async (): Promise<ExportIndex> => {
+  if (exportIndexCache !== undefined) {
+    return exportIndexCache;
+  }
+  const map = new Map<string, string>([
+    ["DocContext", path.join(srcDir, "doc-context.js")],
+  ]);
+  const leafDirs = [
+    path.join(srcDir, "ui"),
+    path.join(srcDir, "components/ui"),
+  ];
+  const scanned = await Promise.all(
+    leafDirs.map(async (dir) => {
+      const entries = await readdir(dir);
+      const files = entries
+        .filter((f) => /\.tsx?$/u.test(f) && f !== "index.ts")
+        .toSorted();
+      return await Promise.all(
+        files.map(async (f) => await scanLeaf(path.join(dir, f)))
+      );
+    })
+  );
+  // Serial merge in sorted order — the parallel scans above must not make
+  // a name collision's winner depend on I/O timing.
+  for (const pairs of scanned.flat()) {
+    for (const [name, mod] of pairs) {
+      map.set(name, mod);
+    }
+  }
+  for (const [name, mod] of Object.entries(shadcnModules)) {
+    map.set(name, path.join(srcDir, "ui", mod));
+  }
+  const index: ExportIndex = {
+    map,
+    surfaces: {
+      components: await collectSurface(path.join(srcDir, "components.ts")),
+      mdxr: await collectSurface(path.join(srcDir, "index.ts")),
+    },
+  };
+  exportIndexCache = index;
+  return index;
+};

package/src/hydrate/import-scan.ts ADDED Viewed

@@ -0,0 +1,169 @@
+/**
+ * User-module import scanning: which names an importer pulls from
+ * `@suzumiyaaoba/mdxr`(/components), and which valibot properties it accesses
+ * through
+ * an imported `v` alias. The virtual runtime module generated for each
+ * importer contains only what it requests — a full-surface module would
+ * drag the whole catalog into every hydration bundle.
+ */
+import { readFile } from "node:fs/promises";
+export interface MdxrImports {
+  /** Named imports the file requests, or `"all"` when it needs the whole API. */
+  names: Set<string> | "all";
+  /**
+   * Properties accessed on the imported `v`, or `"all"` when `v` escapes
+   * (bare use, re-export, dynamic access) so the whole namespace is needed.
+   * `null` when `v` is not imported.
+   */
+  vProps: Set<string> | "all" | null;
+}
+/**
+ * Properties accessed on `alias` (`v`'s local name) — or `"all"` when the
+ * namespace escapes (bare use, `alias[key]`, spread, re-export) and the full
+ * valibot namespace must be shipped.
+ */
+const scanVProps = (stripped: string, alias: string): Set<string> | "all" => {
+  const esc = alias.replaceAll(/[$()*+.?[\\\]^{|}]/gu, "\\$&");
+  const access = new RegExp(
+    `\\b${esc}\\s*\\?\\.\\s*(\\w+)|\\b${esc}\\s*\\.\\s*(\\w+)`,
+    "gu"
+  );
+  const props = new Set<string>();
+  for (const use of stripped.matchAll(access)) {
+    const prop = use[1] ?? use[2];
+    if (prop !== undefined) {
+      props.add(prop);
+    }
+  }
+  const leftover = stripped.replaceAll(access, "");
+  return new RegExp(`\\b${esc}\\b`, "u").test(leftover) ? "all" : props;
+};
+/**
+ * `/* … *\/` and `// …` are legal inside a multiline import clause, and a
+ * name polluted with comment text would silently fail the surface check and
+ * kill the hydration build. Clauses never contain string literals, so a
+ * regex strip is safe here.
+ */
+const stripComments = (s: string): string =>
+  s.replaceAll(/\/\*[\s\S]*?\*\//gu, "").replaceAll(/\/\/[^\n]*/gu, "");
+/** Parse `{ a, b as c, type T }` import specifiers into names + `v` aliases. */
+const parseClause = (
+  clause: string,
+  names: Set<string>,
+  vAliases: string[]
+): void => {
+  // The clause may trail past `}` — comments between `}` and `from` are legal
+  // (`import {a} /* x */ from "m"`) and the regex captures them. Strip
+  // comments first (a `}` inside one is comment text), then cut at the last
+  // `}` so `{ a } /* c */` reads as `a`, not `a }`.
+  const inner = stripComments(clause);
+  const close = inner.lastIndexOf("}");
+  const body = close === -1 ? inner.slice(1) : inner.slice(1, close);
+  for (const part of body.split(",")) {
+    const spec = part.trim().replace(/^type\s+/u, "");
+    const [imported, local] = spec.split(/\s+as\s+/u).map((s) => s?.trim());
+    if (imported === undefined || imported === "") {
+      continue;
+    }
+    names.add(imported);
+    if (imported === "v") {
+      vAliases.push(local ?? "v");
+    }
+  }
+};
+/** Merge per-alias prop scans — `"all"` once any alias escapes. */
+const mergeVProps = (
+  stripped: string,
+  vAliases: string[],
+  escapes: boolean
+): Set<string> | "all" | null => {
+  if (escapes) {
+    return "all";
+  }
+  let vProps: Set<string> | null = null;
+  for (const alias of vAliases) {
+    const props = scanVProps(stripped, alias);
+    if (props === "all") {
+      return "all";
+    }
+    vProps = vProps === null ? props : new Set([...vProps, ...props]);
+  }
+  return vProps;
+};
+/**
+ * Which names `importer` pulls from `@suzumiyaaoba/mdxr`(/components),
+ * extracted with a
+ * regex over its source. `names`/`vProps` are `"all"` for namespace, default,
+ * bare, or dynamic imports and for uninspectable importers — the fallback
+ * keeps semantics correct at the cost of emitting every catalog re-export.
+ */
+export const scanMdxrImports = async (
+  importer: string
+): Promise<MdxrImports> => {
+  let source: string;
+  try {
+    source = await readFile(importer, "utf-8");
+  } catch {
+    return { names: "all", vProps: "all" };
+  }
+  const names = new Set<string>();
+  const vAliases: string[] = [];
+  // `\s*` not `\s+`: `import{v}from"@suzumiyaaoba/mdxr"` is legal and must
+  // still register.
+  // `(?!\s*type\b)` puts the whitespace inside the lookahead — a `\s*` outside
+  // would backtrack to zero and let `import type` slip through as a runtime
+  // import (over-shipping the whole surface). The clause pattern alternates
+  // comments with plain chars so a `;`, `'`, or `"` inside a comment doesn't
+  // truncate the clause and hide the whole import.
+  const fromRe =
+    /(?:import|export)\s*(?!\s*type\b)(?<clause>(?:\/\*[\s\S]*?\*\/|\/\/[^\n]*|[^;"'])*?)\s*from\s*["']@suzumiyaaoba\/mdxr(?:\/components)?["']/gu;
+  let stripped = source;
+  // `export { v } from "@suzumiyaaoba/mdxr"` hands the namespace to consumers —
+  // every
+  // property is reachable, so the per-prop access scan can't apply.
+  let vEscapes = false;
+  for (const m of source.matchAll(fromRe)) {
+    const clause = m.groups?.clause ?? "";
+    stripped = stripped.replace(m[0], "");
+    if (!clause.startsWith("{")) {
+      return { names: "all", vProps: "all" };
+    }
+    const found = vAliases.length;
+    parseClause(clause, names, vAliases);
+    vEscapes ||= m[0].startsWith("export") && vAliases.length > found;
+  }
+  // Type-only imports don't run, but a leftover `import type { v }` would
+  // still trip the `\bv\b` leftover scan and force-ship all of valibot.
+  stripped = stripped.replaceAll(
+    /(?:import|export)\s+type\s[^;]*?(?:;|$)/gmu,
+    ""
+  );
+  // Bare/dynamic imports escape analysis entirely. The separator allows
+  // comments — `import /* x */ ("@suzumiyaaoba/mdxr")` is legal and must
+  // still count.
+  const sep = String.raw`(?:\s|/\*[\s\S]*?\*/|//[^\n]*)*`;
+  if (
+    new RegExp(
+      `import${sep}["']@suzumiyaaoba/mdxr(?:/components)?["']`,
+      "u"
+    ).test(source) ||
+    new RegExp(
+      `import${sep}\\(${sep}["']@suzumiyaaoba/mdxr(?:/components)?["']`,
+      "u"
+    ).test(source)
+  ) {
+    return { names: "all", vProps: "all" };
+  }
+  const vProps = mergeVProps(stripped, vAliases, vEscapes);
+  return {
+    names,
+    vProps: vAliases.length === 0 ? null : (vProps ?? new Set()),
+  };
+};

package/src/hydrate/plugins.ts ADDED Viewed

@@ -0,0 +1,118 @@
+/**
+ * esbuild plugins for the hydration bundle: pin shared packages to mdxr's own
+ * node_modules (a second React copy would break hooks/context), feed the
+ * compiled MDX module in as a virtual import, and shrink bundled icon sets to
+ * the names a document actually rendered.
+ */
+import { icons as lucide } from "@iconify-json/lucide";
+import { icons as vscodeIcons } from "@iconify-json/vscode-icons";
+import type { Plugin } from "esbuild";
+import { SHARED_PACKAGES } from "../load-user-module.js";
+import { pkgRoot, srcDir } from "../paths.js";
+/**
+ * Everything the document bundle shares with mdxr itself — React above all
+ * (a second copy would break hooks/context) — is resolved from this package's
+ * own node_modules regardless of where the user's components live.
+ * (esbuild serializes onResolve filters to Go's RE2: no `u` flag.)
+ */
+/* oxlint-disable require-unicode-regexp -- esbuild onResolve filters forbid `u` */
+const SHARED_RE = new RegExp(`^(?:${SHARED_PACKAGES.join("|")})(?:/.*)?$`);
+export const pinShared: Plugin = {
+  name: "mdxr:pin-shared",
+  setup(b) {
+    b.onResolve({ filter: SHARED_RE }, async (args) => {
+      // b.resolve re-enters this plugin — pluginData marks the inner call so
+      // the recursion stops after exactly one delegation.
+      if (args.pluginData === pinShared) {
+        return null;
+      }
+      const r = await b.resolve(args.path, {
+        kind: args.kind,
+        pluginData: pinShared,
+        resolveDir: pkgRoot,
+      });
+      return r.errors.length === 0 ? { path: r.path } : null;
+    });
+  },
+};
+/* oxlint-enable require-unicode-regexp */
+/** The compiled MDX module enters the bundle as a virtual `mdxr:doc` import. */
+/* oxlint-disable require-unicode-regexp -- esbuild onResolve/onLoad filters forbid `u` */
+export const docModule = (code: string): Plugin => ({
+  name: "mdxr:doc",
+  setup(b) {
+    b.onResolve({ filter: /^mdxr:doc$/ }, () => ({
+      namespace: "mdxr-doc",
+      path: "mdxr:doc",
+    }));
+    b.onLoad({ filter: /^mdxr:doc$/, namespace: "mdxr-doc" }, () => ({
+      contents: code,
+      loader: "js",
+      resolveDir: srcDir,
+    }));
+  },
+});
+/* oxlint-enable require-unicode-regexp */
+const ICON_SETS: Record<string, typeof lucide> = {
+  "@iconify-json/lucide": lucide,
+  "@iconify-json/vscode-icons": vscodeIcons,
+};
+/**
+ * The bundled icon sets are several MB of JSON; a document only ever renders
+ * the icons recorded during SSR. Redirecting each `@iconify-json/*` import to
+ * a partial collection (used names only, alias parents included) keeps
+ * `addCollection` calls working while shipping kilobytes, not megabytes.
+ */
+/* oxlint-disable require-unicode-regexp -- esbuild onResolve/onLoad filters forbid `u` */
+export const iconSets = (usedIcons: readonly string[]): Plugin => ({
+  name: "mdxr:icons",
+  setup(b) {
+    b.onResolve({ filter: /^@iconify-json\// }, (args) => ({
+      namespace: "mdxr-icons",
+      path: args.path,
+    }));
+    b.onLoad(
+      { filter: /^@iconify-json\//, namespace: "mdxr-icons" },
+      (args) => {
+        const set = ICON_SETS[args.path];
+        if (set === undefined) {
+          return { contents: "export const icons = {};", loader: "js" };
+        }
+        const icons: Record<string, unknown> = {};
+        const aliases: Record<string, unknown> = {};
+        for (const full of usedIcons) {
+          const [prefix, name] = full.split(":");
+          if (prefix !== set.prefix || name === undefined) {
+            continue;
+          }
+          // hasOwn: names like "toString" must not pull prototype members —
+          // a function would serialize as `{}` and ship a phantom icon.
+          if (Object.hasOwn(set.icons, name)) {
+            icons[name] = set.icons[name];
+          }
+          const alias = Object.hasOwn(set.aliases ?? {}, name)
+            ? set.aliases?.[name]
+            : undefined;
+          if (alias !== undefined) {
+            aliases[name] = alias;
+            if (Object.hasOwn(set.icons, alias.parent)) {
+              icons[alias.parent] = set.icons[alias.parent];
+            }
+          }
+        }
+        return {
+          contents: `export const icons = ${JSON.stringify({ ...set, aliases, icons })};`,
+          loader: "js",
+        };
+      }
+    );
+  },
+});
+/* oxlint-enable require-unicode-regexp */