@oud-idk/markdown 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @oud-idk/markdown
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Private markdown rendering system for React/Next.js projects.
+
+Includes `MarkdownRenderer`, `MarkdownWithToc`, table of contents, scroller, copy button, remark/rehype plugin lists, reading time, and language detection helpers.
+
+## Development
+
+```sh
+pnpm install
+pnpm --filter @oud-idk/markdown build
+```
+
+## Consuming in this workspace
+
+The portfolio depends on this package via `workspace:*`.
+
+## Publish
+
+```sh
+pnpm --filter @oud-idk/markdown publish
+```
+
+`prepublishOnly` rebuilds the package first.
+
+This package ships compiled output from `dist/` and expects the consumer to
+provide the Tailwind design tokens/classes it uses (e.g. `bg-surface`,
+`text-muted-foreground`, `border-border`, `text-brand`).

package/dist/components/CopyButton.d.ts

@@ -0,0 +1,4 @@
+export declare function CopyButton({ code }: {
+    code: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/components/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../src/components/CopyButton.tsx"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,+BAkCpD"}

package/dist/components/CopyButton.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { ClipboardCopyIcon, CheckIcon } from "lucide-react";
+export function CopyButton({ code }) {
+    const [isCopied, setIsCopied] = useState(false);
+    const handleCopy = async () => {
+        if (!code)
+            return;
+        try {
+            await navigator.clipboard.writeText(code);
+            setIsCopied(true);
+            setTimeout(() => setIsCopied(false), 2000);
+        }
+        catch (err) {
+            console.error("Failed to copy code: ", err);
+        }
+    };
+    return (_jsx("button", { onClick: () => void handleCopy(), "aria-label": "Copy code", type: "button", className: "inline-flex items-center gap-1.5 px-2 py-1 bg-surface rounded-md text-xs font-sans text-muted-foreground hover:text-foreground hover:bg-surface-active border border-border-subtle transition-all focus-ring", children: isCopied ? (_jsxs(_Fragment, { children: [_jsx(CheckIcon, { className: "h-3.5 w-3.5 text-success" }), _jsx("span", { className: "text-success font-medium", children: "Copied!" })] })) : (_jsxs(_Fragment, { children: [_jsx(ClipboardCopyIcon, { className: "h-3.5 w-3.5" }), _jsx("span", { children: "Copy" })] })) }));
+}
+//# sourceMappingURL=CopyButton.js.map

package/dist/components/CopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../src/components/CopyButton.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAoB;IACjD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,CACH,iBACI,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,UAAU,EAAE,gBACrB,WAAW,EACtB,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,8MAA8M,YAEvN,QAAQ,CAAC,CAAC,CAAC,CACR,8BACI,KAAC,SAAS,IAAC,SAAS,EAAC,0BAA0B,GAAG,EAClD,eAAM,SAAS,EAAC,0BAA0B,wBAAe,IAC1D,CACN,CAAC,CAAC,CAAC,CACA,8BACI,KAAC,iBAAiB,IAAC,SAAS,EAAC,aAAa,GAAG,EAC7C,kCAAiB,IAClB,CACN,GACI,CACZ,CAAC;AACN,CAAC"}

package/dist/components/MarkdownLayout.d.ts

@@ -0,0 +1,16 @@
+import React, { type ReactNode } from "react";
+import type { TocItem } from "../lib/markdown-toc";
+interface MarkdownLayoutProps {
+    /** Server-rendered document. Kept opaque here — only the ref matters to the ToC. */
+    children: ReactNode;
+    /** Heading outline, extracted from the markdown while it was rendered. */
+    headings: TocItem[];
+    showToc?: boolean;
+}
+/**
+ * Client half of the markdown view: layout, the scroll container the ToC
+ * measures, and the ToC's own scroll-spy. Everything else arrives as children.
+ */
+export declare const MarkdownLayout: React.FC<MarkdownLayoutProps>;
+export {};
+//# sourceMappingURL=MarkdownLayout.d.ts.map

package/dist/components/MarkdownLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownLayout.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownLayout.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAU,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,UAAU,mBAAmB;IACzB,oFAAoF;IACpF,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyBxD,CAAC"}

package/dist/components/MarkdownLayout.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef } from "react";
+import { TableOfContents } from "./TableOfContents";
+import { cn } from "cn";
+/**
+ * Client half of the markdown view: layout, the scroll container the ToC
+ * measures, and the ToC's own scroll-spy. Everything else arrives as children.
+ */
+export const MarkdownLayout = ({ children, headings, showToc = true }) => {
+    const contentRef = useRef(null);
+    const hasToc = showToc && headings.length > 0;
+    return (_jsxs("div", { className: "relative flex w-full justify-center gap-8", children: [_jsx("div", { ref: contentRef, className: cn("min-w-0 flex-1 max-w-7xl"), children: children }), hasToc && (_jsx("aside", { className: "hidden xl:block max-w-80 shrink-0", children: _jsx("div", { className: "sticky top-20 max-h-[calc(100vh-30rem)] overflow-y-auto pr-2 scrollbar-thin", children: _jsx(TableOfContents, { containerRef: contentRef, headings: headings }) }) }))] }));
+};
+//# sourceMappingURL=MarkdownLayout.js.map

package/dist/components/MarkdownLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownLayout.js","sourceRoot":"","sources":["../../src/components/MarkdownLayout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,CAAC;AAUxB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE;IACpG,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9C,OAAO,CACH,eAAK,SAAS,EAAC,2CAA2C,aACtD,cACI,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,EAAE,CACT,0BAA0B,CAC7B,YAEA,QAAQ,GACP,EAEL,MAAM,IAAI,CACP,gBAAO,SAAS,EAAC,mCAAmC,YAChD,cAAK,SAAS,EAAC,6EAA6E,YACxF,KAAC,eAAe,IAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAI,GAC/D,GACF,CACX,IACC,CACT,CAAC;AACN,CAAC,CAAC"}

package/dist/components/MarkdownRenderer.d.ts

@@ -0,0 +1,10 @@
+import "katex/dist/katex.min.css";
+import React from "react";
+import { type TocItem } from "../lib/markdown-toc";
+export interface MarkdownRendererProps {
+    content?: string;
+    className?: string;
+    headings?: TocItem[];
+}
+export declare function MarkdownRenderer({ content, className, headings }: MarkdownRendererProps): Promise<React.JSX.Element>;
+//# sourceMappingURL=MarkdownRenderer.d.ts.map

package/dist/components/MarkdownRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownRenderer.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAElC,OAAO,KAAyB,MAAM,OAAO,CAAC;AAM9C,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA6G1E,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB;AAyCD,wBAAsB,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,qBAAqB,8BAoB7F"}

package/dist/components/MarkdownRenderer.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import "katex/dist/katex.min.css";
+import React from "react";
+import { MarkdownAsync } from "react-markdown";
+import { getLinguist } from "../lib/linguist";
+import { rehypePlugins, remarkPlugins } from "../lib/markdown-plugins";
+import { rehypeCollectHeadings } from "../lib/markdown-toc";
+import { CopyButton } from "./CopyButton";
+function extractText(node) {
+    if (typeof node === "string")
+        return node;
+    if (typeof node === "number")
+        return String(node);
+    if (Array.isArray(node))
+        return node.map(extractText).join("");
+    if (React.isValidElement(node)) {
+        return extractText(node.props.children);
+    }
+    return "";
+}
+/**
+ * react-markdown passes every component override the hast `node` alongside the
+ * real DOM props. Spreading it through emits `node="[object Object]"` into the
+ * markup, so drop it once, here, instead of at each call site.
+ */
+function withoutNode(props) {
+    const { node, ...rest } = props;
+    void node;
+    return rest;
+}
+const CodeBlock = (raw) => {
+    const { children, className, "data-language": language, ...props } = withoutNode(raw);
+    if (!language && !className?.includes("shiki")) {
+        return (_jsx("pre", { className: `${className ?? ""} border border-border rounded-xl`, ...props, children: children }));
+    }
+    const code = extractText(children).replace(/\n$/, "");
+    const languageName = language ? getLinguist(language) : "Plaintext";
+    return (_jsxs("div", { className: "relative group bg-surface my-4 rounded-xl border border-border overflow-hidden shadow-xs transition-all", children: [_jsxs("div", { className: "flex items-center justify-between px-4 py-2 border-b border-border-subtle bg-surface/50 text-xs font-mono text-muted-foreground", children: [_jsx("span", { className: "font-medium tracking-wide uppercase", children: languageName ?? language }), _jsx(CopyButton, { code: code })] }), _jsx("div", { className: "p-3 overflow-x-auto text-sm min-h-10", children: _jsx("pre", { className: `${className ?? ""} bg-transparent! p-0! m-0!`, ...props, children: children }) })] }));
+};
+const markdownComponents = {
+    hr() {
+        return _jsx("hr", { className: "my-8 border-border" });
+    },
+    p({ children }) {
+        return _jsx("p", { className: "mb-4 leading-relaxed text-foreground", children: children });
+    },
+    code(raw) {
+        const { className, children, ...props } = withoutNode(raw);
+        if ("data-block" in props) {
+            return _jsx("code", { className: className, ...props, children: children });
+        }
+        return (_jsx("code", { className: `${className ?? ""} bg-surface text-foreground border border-border px-1.5 py-0.5 rounded-md text-xs font-mono font-normal inline-block`, style: { fontFamily: "var(--font-geist-mono)" }, ...props, children: children }));
+    },
+    pre: CodeBlock,
+    input({ type, checked }) {
+        return (_jsx("input", { type: type, checked: checked, readOnly: true, className: "mr-2 rounded border-border text-brand accent-brand align-middle focus-ring" }));
+    },
+    a(raw) {
+        const { className, ...props } = withoutNode(raw);
+        return (_jsx("a", { className: `${className ?? ""} text-link hover:text-link-hover underline underline-offset-4 decoration-link/40 hover:decoration-link-hover font-medium transition-colors wrap-break-word break-all focus-ring rounded-xs`, ...props }));
+    },
+};
+/**
+ * Server component: parses and renders markdown here, so the browser receives
+ * finished markup instead of the source plus a parser.
+ */
+/**
+ * Cross-request cache of rendered markdown. The Shiki highlighter and KaTeX
+ * are expensive (~1s+ cold each), and the body copy rarely changes, so we
+ * render once per unique (content, headings) key and reuse the elements.
+ */
+const markdownCache = new Map();
+function getMarkdownBody(content, headings) {
+    return getMarkdown(content, headings !== undefined).then((r) => {
+        if (headings !== undefined)
+            headings.push(...r.headings);
+        return r.body;
+    });
+}
+function getMarkdown(content, collectToc) {
+    const key = `${collectToc ? "toc" : "plain"}:${content}`;
+    let hit = markdownCache.get(key);
+    if (!hit) {
+        const collected = [];
+        const rehype = collectToc
+            ? [...rehypePlugins, [rehypeCollectHeadings, { into: collected }]]
+            : rehypePlugins;
+        hit = MarkdownAsync({
+            remarkPlugins,
+            rehypePlugins: rehype,
+            components: markdownComponents,
+            children: content,
+        }).then((body) => ({ body, headings: collected }));
+        hit.catch(() => markdownCache.delete(key));
+        markdownCache.set(key, hit);
+    }
+    return hit;
+}
+export async function MarkdownRenderer({ content, className, headings }) {
+    // Must await to render elements for ToC
+    const body = await getMarkdownBody(content ?? "", headings);
+    return (_jsx("div", { className: `
+                prose dark:prose-invert max-w-none w-full wrap-break-word
+                prose-headings:scroll-mt-24
+                prose-headings:text-foreground prose-headings:font-semibold prose-headings:tracking-tight prose-h1:mt-8
+                prose-h2:text-xl prose-h2:mb-3 prose-li:my-0
+                prose-blockquote:border-l-brand prose-blockquote:py-0.5 prose-blockquote:px-4 prose-blockquote:rounded-r-xl prose-blockquote:not-italic
+                prose-pre:bg-surface
+                prose-img:rounded-xl prose-img:border prose-img:border-border
+                ${className ?? ''} 
+            `, children: body }));
+}
+//# sourceMappingURL=MarkdownRenderer.js.map

package/dist/components/MarkdownRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownRenderer.js","sourceRoot":"","sources":["../../src/components/MarkdownRenderer.tsx"],"names":[],"mappings":";AAAA,OAAO,0BAA0B,CAAC;AAElC,OAAO,KAAyB,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAgB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,SAAS,WAAW,CAAC,IAAe;IAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,cAAc,CAA2B,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAA+B,KAAQ;IACvD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAChC,KAAK,IAAI,CAAC;IACV,OAAO,IAAI,CAAC;AAChB,CAAC;AAUD,MAAM,SAAS,GAAG,CAAC,GAAa,EAAE,EAAE;IAChC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEtF,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,CACH,cAAK,SAAS,EAAE,GAAG,SAAS,IAAI,EAAE,kCAAkC,KAAM,KAAK,YAC1E,QAAQ,GACP,CACT,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAEpE,OAAO,CACH,eAAK,SAAS,EAAC,yGAAyG,aACpH,eAAK,SAAS,EAAC,iIAAiI,aAC5I,eAAM,SAAS,EAAC,qCAAqC,YAAE,YAAY,IAAI,QAAQ,GAAQ,EACvF,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,GAAI,IACxB,EAEN,cAAK,SAAS,EAAC,sCAAsC,YACjD,cAAK,SAAS,EAAE,GAAG,SAAS,IAAI,EAAE,4BAA4B,KAAM,KAAK,YACpE,QAAQ,GACP,GACJ,IACJ,CACT,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAmD;IACvE,EAAE;QACE,OAAO,aAAI,SAAS,EAAC,oBAAoB,GAAG,CAAC;IACjD,CAAC;IACD,CAAC,CAAC,EAAE,QAAQ,EAAE;QACV,OAAO,YAAG,SAAS,EAAC,sCAAsC,YAAE,QAAQ,GAAK,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,GAA6E;QAC9E,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAE3D,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;YACxB,OAAO,eAAM,SAAS,EAAE,SAAS,KAAM,KAAK,YAAG,QAAQ,GAAQ,CAAC;QACpE,CAAC;QAED,OAAO,CACH,eACI,SAAS,EAAE,GAAG,SAAS,IAAI,EAAE,sHAAsH,EACnJ,KAAK,EAAE,EAAE,UAAU,EAAE,wBAAwB,EAAE,KAC3C,KAAK,YAER,QAAQ,GACN,CACV,CAAC;IACN,CAAC;IACD,GAAG,EAAE,SAAS;IACd,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;QACnB,OAAO,CACH,gBACI,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,QACR,SAAS,EAAC,4EAA4E,GACxF,CACL,CAAC;IACN,CAAC;IACD,CAAC,CAAC,GAAmD;QACjD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAEjD,OAAO,CACH,YACI,SAAS,EAAE,GAAG,SAAS,IAAI,EAAE,4LAA4L,KACrN,KAAK,GACX,CACL,CAAC;IACN,CAAC;CACJ,CAAC;AAQF;;;GAGG;AACH;;;;GAIG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6D,CAAC;AAE3F,SAAS,eAAe,CAAC,OAAe,EAAE,QAAoB;IAC1D,OAAO,WAAW,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3D,IAAI,QAAQ,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,UAAmB;IACrD,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACzD,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,SAAS,GAAc,EAAE,CAAC;QAChC,MAAM,MAAM,GAAkB,UAAU;YACpC,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YAClE,CAAC,CAAC,aAAa,CAAC;QAEpB,GAAG,GAAG,aAAa,CAAC;YAChB,aAAa;YACb,aAAa,EAAE,MAAM;YACrB,UAAU,EAAE,kBAAkB;YAC9B,QAAQ,EAAE,OAAO;SACpB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACnD,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAyB;IAC1F,wCAAwC;IACxC,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE5D,OAAO,CACH,cACI,SAAS,EAAE;;;;;;;;kBAQL,SAAS,IAAI,EAAE;aACpB,YAEA,IAAI,GACH,CACT,CAAC;AACN,CAAC"}

package/dist/components/MarkdownWithToC.d.ts

@@ -0,0 +1,12 @@
+interface MarkdownWithTocProps {
+    content?: string;
+    className?: string;
+    showToc?: boolean;
+}
+/**
+ * Server component: renders the document and derives its ToC from the same
+ * parse, then hands both to the client shell that owns the scroll-spy.
+ */
+export declare function MarkdownWithToc({ content, className, showToc }: MarkdownWithTocProps): Promise<import("react").JSX.Element>;
+export {};
+//# sourceMappingURL=MarkdownWithToC.d.ts.map

package/dist/components/MarkdownWithToC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownWithToC.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownWithToC.tsx"],"names":[],"mappings":"AAIA,UAAU,oBAAoB;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,EAAE,OAAO,EAAE,SAAc,EAAE,OAAc,EAAE,EAAE,oBAAoB,wCAUtG"}

package/dist/components/MarkdownWithToC.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MarkdownLayout } from "./MarkdownLayout";
+import { MarkdownRenderer } from "./MarkdownRenderer";
+/**
+ * Server component: renders the document and derives its ToC from the same
+ * parse, then hands both to the client shell that owns the scroll-spy.
+ */
+export async function MarkdownWithToc({ content, className = "", showToc = true }) {
+    const headings = [];
+    const document = await MarkdownRenderer({ content, className, headings });
+    return (_jsx(MarkdownLayout, { headings: headings, showToc: showToc, children: document }));
+}
+//# sourceMappingURL=MarkdownWithToC.js.map

package/dist/components/MarkdownWithToC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownWithToC.js","sourceRoot":"","sources":["../../src/components/MarkdownWithToC.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAStD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,GAAG,EAAE,EAAE,OAAO,GAAG,IAAI,EAAwB;IACnG,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE1E,OAAO,CACH,KAAC,cAAc,IAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,YAC/C,QAAQ,GACI,CACpB,CAAC;AACN,CAAC"}

package/dist/components/ScrollableMarkdownViewer.d.ts

@@ -0,0 +1,13 @@
+import React, { type ReactNode } from 'react';
+interface ScrollableMarkdownViewerProps {
+    /** Server-rendered markdown, e.g. `<MarkdownRenderer content={...} />`. */
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * Scroll container with in-container anchor scrolling. Takes children rather
+ * than a source string because the document itself is rendered on the server.
+ */
+export declare const ScrollableMarkdownViewer: React.FC<ScrollableMarkdownViewerProps>;
+export {};
+//# sourceMappingURL=ScrollableMarkdownViewer.d.ts.map

package/dist/components/ScrollableMarkdownViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollableMarkdownViewer.d.ts","sourceRoot":"","sources":["../../src/components/ScrollableMarkdownViewer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK9C,UAAU,6BAA6B;IACnC,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CAe5E,CAAC"}

package/dist/components/ScrollableMarkdownViewer.js

@@ -0,0 +1,13 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMarkdownScroller } from "./useMarkdownScroller";
+import { cn } from "cn";
+/**
+ * Scroll container with in-container anchor scrolling. Takes children rather
+ * than a source string because the document itself is rendered on the server.
+ */
+export const ScrollableMarkdownViewer = ({ children, className, }) => {
+    const { containerRef, handleLinkClick } = useMarkdownScroller();
+    return (_jsx("div", { ref: containerRef, onClick: handleLinkClick, className: cn("overflow-auto", className), children: children }));
+};
+//# sourceMappingURL=ScrollableMarkdownViewer.js.map

package/dist/components/ScrollableMarkdownViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollableMarkdownViewer.js","sourceRoot":"","sources":["../../src/components/ScrollableMarkdownViewer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAIb,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,CAAC;AAQxB;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4C,CAAC,EAC9E,QAAQ,EACR,SAAS,GACZ,EAAE,EAAE;IACD,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEhE,OAAO,CACH,cACI,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC,YAExC,QAAQ,GACP,CACT,CAAC;AACN,CAAC,CAAC"}

package/dist/components/TableOfContents.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import type { TocItem } from "../lib/markdown-toc";
+export type { TocItem };
+interface TableOfContentsProps {
+    containerRef: React.RefObject<HTMLElement | null>;
+    /** Heading outline, extracted from the markdown so it renders server-side. */
+    headings: TocItem[];
+}
+export declare const TableOfContents: React.FC<TableOfContentsProps>;
+//# sourceMappingURL=TableOfContents.d.ts.map

package/dist/components/TableOfContents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableOfContents.d.ts","sourceRoot":"","sources":["../../src/components/TableOfContents.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,YAAY,EAAE,OAAO,EAAE,CAAC;AAExB,UAAU,oBAAoB;IAC1B,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAClD,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,EAAE,CAAC;CACvB;AAeD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAiP1D,CAAC"}

package/dist/components/TableOfContents.js

@@ -0,0 +1,169 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState, useCallback, useMemo } from "react";
+function getScrollContainer(element) {
+    if (typeof window === "undefined" || !element)
+        return window;
+    let parent = element.parentElement;
+    while (parent && parent !== document.body && parent !== document.documentElement) {
+        const { overflowY } = window.getComputedStyle(parent);
+        if (overflowY === "auto" || overflowY === "scroll") {
+            return parent;
+        }
+        parent = parent.parentElement;
+    }
+    return window;
+}
+export const TableOfContents = ({ containerRef, headings }) => {
+    const [activeId, setActiveId] = useState(headings[0]?.id ?? "");
+    const itemRefs = useRef(new Map());
+    const navRef = useRef(null);
+    const [indicator, setIndicator] = useState({ top: 0, height: 0, visible: false });
+    const isClickScrollingRef = useRef(false);
+    const scrollTimeoutRef = useRef(null);
+    // Calculate minimum level so indentation starts from 0 even if page starts at H2
+    const minLevel = useMemo(() => {
+        if (headings.length === 0)
+            return 1;
+        return Math.min(...headings.map((h) => h.level));
+    }, [headings]);
+    // Re-runs (and re-syncs `activeId`) whenever the outline changes, which is
+    // what resets the active entry when navigating to another document.
+    const updateActiveHeading = useCallback(() => {
+        if (headings.length === 0 || isClickScrollingRef.current)
+            return;
+        const activationOffset = Math.max(120, window.innerHeight * 0.35);
+        let currentActive = headings[0].id;
+        for (const heading of headings) {
+            const escapedId = CSS.escape(heading.id);
+            const el = containerRef.current?.querySelector(`#${escapedId}`) ??
+                document.getElementById(heading.id);
+            if (!el)
+                continue;
+            const rect = el.getBoundingClientRect();
+            if (rect.top <= activationOffset) {
+                currentActive = heading.id;
+            }
+            else {
+                break;
+            }
+        }
+        setActiveId(currentActive);
+    }, [headings, containerRef]);
+    useEffect(() => {
+        if (headings.length === 0) {
+            return undefined;
+        }
+        const scrollContainer = getScrollContainer(containerRef.current);
+        const target = scrollContainer === window ? window : scrollContainer;
+        let ticking = false;
+        const handleScroll = () => {
+            if (isClickScrollingRef.current)
+                return;
+            if (!ticking) {
+                window.requestAnimationFrame(() => {
+                    if (!isClickScrollingRef.current) {
+                        updateActiveHeading();
+                    }
+                    ticking = false;
+                });
+                ticking = true;
+            }
+        };
+        target.addEventListener("scroll", handleScroll, { passive: true });
+        updateActiveHeading();
+        return () => {
+            target.removeEventListener("scroll", handleScroll);
+            if (scrollTimeoutRef.current) {
+                clearTimeout(scrollTimeoutRef.current);
+            }
+        };
+    }, [headings, containerRef, updateActiveHeading]);
+    useEffect(() => {
+        const el = activeId !== "" ? (itemRefs.current.get(activeId) ?? null) : null;
+        if (!el) {
+            setIndicator((prev) => ({ ...prev, visible: false }));
+            return;
+        }
+        setIndicator({ top: el.offsetTop, height: el.offsetHeight, visible: true });
+        const sidebarContainer = navRef.current?.parentElement;
+        if (sidebarContainer && sidebarContainer.scrollHeight > sidebarContainer.clientHeight) {
+            const elRect = el.getBoundingClientRect();
+            const containerRect = sidebarContainer.getBoundingClientRect();
+            const diffTop = elRect.top - (containerRect.top + 16);
+            const diffBottom = elRect.bottom - (containerRect.bottom - 16);
+            if (diffTop < 0) {
+                sidebarContainer.scrollBy({ top: diffTop, behavior: "smooth" });
+            }
+            else if (diffBottom > 0) {
+                sidebarContainer.scrollBy({ top: diffBottom, behavior: "smooth" });
+            }
+        }
+    }, [activeId, headings]);
+    // 4. Click handler with smooth scroll lock
+    const scrollToHeading = (id) => {
+        const escapedId = CSS.escape(id);
+        const el = containerRef.current?.querySelector(`#${escapedId}`) ??
+            document.getElementById(id);
+        if (!el)
+            return;
+        isClickScrollingRef.current = true;
+        setActiveId(id);
+        if (scrollTimeoutRef.current) {
+            clearTimeout(scrollTimeoutRef.current);
+        }
+        scrollTimeoutRef.current = setTimeout(() => {
+            isClickScrollingRef.current = false;
+        }, 800);
+        const scrollContainer = getScrollContainer(containerRef.current);
+        const headerOffset = 80;
+        if (scrollContainer === window) {
+            const elementPosition = el.getBoundingClientRect().top + window.scrollY;
+            window.scrollTo({
+                top: elementPosition - headerOffset,
+                behavior: "smooth",
+            });
+        }
+        else if (scrollContainer instanceof HTMLElement) {
+            const containerRect = scrollContainer.getBoundingClientRect();
+            const elementRect = el.getBoundingClientRect();
+            const offsetTop = elementRect.top - containerRect.top + scrollContainer.scrollTop - headerOffset;
+            scrollContainer.scrollTo({
+                top: offsetTop,
+                behavior: "smooth",
+            });
+        }
+    };
+    if (headings.length === 0)
+        return null;
+    const INDENT_WIDTH_REM = 1.0;
+    return (_jsxs("nav", { ref: navRef, "aria-label": "Table of contents", className: "w-full text-sm select-none", children: [_jsx("h4", { className: "font-semibold text-muted-foreground mb-3 text-xs tracking-wider uppercase", children: "On This Page" }), _jsxs("div", { className: "relative border-l border-border/60 pl-2", children: [_jsx("div", { className: "absolute -left-px w-0.5 bg-brand-active rounded-full transition-all duration-300 ease-out pointer-events-none", style: {
+                            top: indicator.top,
+                            height: indicator.height,
+                            opacity: indicator.visible ? 1 : 0,
+                        } }), _jsx("ul", { className: "relative space-y-0.5", children: headings.map(({ id, text, level }) => {
+                            const isActive = activeId === id;
+                            const depth = Math.max(0, level - minLevel);
+                            return (_jsxs("li", { ref: (node) => {
+                                    if (node)
+                                        itemRefs.current.set(id, node);
+                                    else
+                                        itemRefs.current.delete(id);
+                                }, className: "relative flex items-center", style: {
+                                    paddingLeft: depth > 0 ? `${(depth * INDENT_WIDTH_REM).toString()}rem` : undefined,
+                                }, children: [depth > 0 && (_jsx("div", { className: "absolute top-0 bottom-0 left-0 flex pointer-events-none", style: { width: `${(depth * INDENT_WIDTH_REM).toString()}rem` }, "aria-hidden": "true", children: Array.from({ length: depth }).map((_, i) => {
+                                            const isLastLevel = i === depth - 1;
+                                            return (_jsxs("div", { className: "relative h-full", style: { width: `${INDENT_WIDTH_REM.toString()}rem` }, children: [_jsx("span", { className: `absolute left-2 top-0 bottom-0 w-px transition-colors duration-200 ${isActive
+                                                            ? "bg-brand-active/40"
+                                                            : "bg-border/60"}` }), isLastLevel && (_jsx("span", { className: `absolute left-2 top-1/2 -translate-y-1/2 w-2 h-px transition-colors duration-200 ${isActive
+                                                            ? "bg-brand-active/50"
+                                                            : "bg-border/60"}` }))] }, i));
+                                        }) })), _jsx("button", { type: "button", title: text, "aria-current": isActive ? "location" : undefined, onClick: (e) => {
+                                            e.preventDefault();
+                                            scrollToHeading(id);
+                                        }, className: `w-full rounded-md px-2 py-1.5 text-left leading-snug transition-colors duration-200 cursor-pointer hover:bg-muted/80 hover:text-foreground ${isActive
+                                            ? "text-brand-active bg-muted/40"
+                                            : "text-muted-foreground"}`, children: text })] }, id));
+                        }) })] })] }));
+};
+//# sourceMappingURL=TableOfContents.js.map

package/dist/components/TableOfContents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableOfContents.js","sourceRoot":"","sources":["../../src/components/TableOfContents.tsx"],"names":[],"mappings":"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"}

package/dist/components/useMarkdownScroller.d.ts

@@ -0,0 +1,8 @@
+import React, { RefObject } from 'react';
+interface UseMarkdownScrollerReturn {
+    containerRef: RefObject<HTMLDivElement | null>;
+    handleLinkClick: (e: React.MouseEvent<HTMLDivElement>) => void;
+}
+export declare const useMarkdownScroller: () => UseMarkdownScrollerReturn;
+export {};
+//# sourceMappingURL=useMarkdownScroller.d.ts.map

package/dist/components/useMarkdownScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownScroller.d.ts","sourceRoot":"","sources":["../../src/components/useMarkdownScroller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAuB,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,UAAU,yBAAyB;IAC/B,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAClE;AAGD,eAAO,MAAM,mBAAmB,QAAO,yBAsCtC,CAAC"}

package/dist/components/useMarkdownScroller.js

@@ -0,0 +1,32 @@
+"use client";
+import { useRef, useCallback } from 'react';
+export const useMarkdownScroller = () => {
+    const containerRef = useRef(null);
+    const handleLinkClick = useCallback((event) => {
+        if (!(event.target instanceof Element)) {
+            return;
+        }
+        const link = event.target.closest("a");
+        if (link !== null &&
+            link.hash.length > 0 &&
+            link.pathname === window.location.pathname) {
+            event.preventDefault();
+            event.stopPropagation();
+            const id = decodeURIComponent(link.hash.substring(1));
+            const container = containerRef.current;
+            // Using CSS.escape prevents errors if your heading ID starts with a number or special char
+            const element = container?.querySelector(`#${CSS.escape(id)}`);
+            if (element !== null && element !== undefined && container !== null) {
+                const targetTop = element.getBoundingClientRect().top;
+                const containerTop = container.getBoundingClientRect().top;
+                const scrollPosition = targetTop - containerTop + container.scrollTop;
+                container.scrollTo({
+                    top: scrollPosition,
+                    behavior: "smooth",
+                });
+            }
+        }
+    }, []);
+    return { containerRef, handleLinkClick };
+};
+//# sourceMappingURL=useMarkdownScroller.js.map

package/dist/components/useMarkdownScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownScroller.js","sourceRoot":"","sources":["../../src/components/useMarkdownScroller.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAc,EAAE,MAAM,EAAE,WAAW,EAAa,MAAM,OAAO,CAAC;AAQ9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAA8B,EAAE;IAC/D,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,KAAuC,EAAQ,EAAE;QAClF,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,IACI,IAAI,KAAK,IAAI;YACb,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YACpB,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAC5C,CAAC;YACC,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;YAExB,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;YAEvC,2FAA2F;YAC3F,MAAM,OAAO,GAAG,SAAS,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAE/D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC;gBACtD,MAAM,YAAY,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC;gBAC3D,MAAM,cAAc,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC;gBAEtE,SAAS,CAAC,QAAQ,CAAC;oBACf,GAAG,EAAE,cAAc;oBACnB,QAAQ,EAAE,QAAQ;iBACrB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AAC7C,CAAC,CAAC"}