@docubook/core 1.0.0 → 1.1.1

package/README.md

@@ -32,32 +32,118 @@ Bun (independent runtime/package manager):
 bun add @docubook/core
 ```
 
-## Dependency Management Policy
+## Usage
 
-Dependencies required for markdown processing are managed in this package and updated by the DocuBook author.
+### Quick Start (Recommended)
 
-This means app-level users should focus on content and integration. Plugin upgrades, compatibility checks, and pipeline maintenance are handled centrally by DocuBook.
+```ts
+import { cache } from "react";
+import { createMdxContentService } from "@docubook/core";
 
-### Managed Markdown Dependencies
+type Frontmatter = {
+  title: string;
+  description: string;
+  image: string;
+  date: string;
+};
 
-- gray-matter
-- rehype-autolink-headings
-- rehype-code-titles
-- rehype-prism-plus
-- rehype-slug
-- remark-gfm
-- unist-util-visit
+type TocItem = {
+  level: number;
+  text: string;
+  href: string;
+};
 
-The most important part is the `remark` and `rehype` plugin stack, which is intentionally owned by this package to avoid dependency drift across apps.
+const components = {
+  // your MDX components
+};
 
-## Why This Matters
+const docsService = createMdxContentService<Frontmatter, TocItem>({
+  parseOptions: { components },
+  cacheFn: cache,
+});
 
-- Consistent behavior across all DocuBook-based projects
-- Easier maintenance and safer upgrades
-- Less dependency duplication in app-level package.json files
-- Faster onboarding for users who only need to write docs
+const doc = await docsService.getCompiledForSlug("getting-started/introduction");
+const frontmatter = await docsService.getFrontmatterForSlug("getting-started/introduction");
+const tocs = await docsService.getTocsForSlug("getting-started/introduction");
+```
 
-## Usage
+### Importable APIs and What They Do
+
+#### Runtime APIs
+
+- `parseMdx`: Compile raw MDX string with optional custom parse options. Returns `MdxCompileResult<Frontmatter>`.
+- `createMdxContentService`: Create slug-based docs service (`getParsedForSlug`, `getCompiledForSlug`, `getFrontmatterForSlug`, `getTocsForSlug`). Returns a service object.
+- `readMdxFileBySlug`: Read `slug.mdx` or `slug/index.mdx` from docs directory. Returns `ReadMdxFileResult`.
+- `parseMdxFile`: Convert raw file result into `frontmatter`, `tocs`, `content`, `filePath`. Returns `ParsedMdxFile<Frontmatter, TocItem>`.
+- `compileParsedMdxFile`: Compile parsed MDX while preserving metadata and TOCs. Returns `CompiledMdxFile<Frontmatter, TocItem>`.
+- `extractFrontmatter`: Parse frontmatter only from raw markdown/MDX. Returns `Frontmatter`.
+- `extractTocsFromRawMdx`: Extract headings for table of contents generation. Returns `TocItem[]`.
+- `sluggify`: Convert heading text into URL-safe slug. Returns `string`.
+- `createDefaultRehypePlugins`: Get default DocuBook rehype plugin stack. Returns `unknown[]`.
+- `createDefaultRemarkPlugins`: Get default DocuBook remark plugin stack. Returns `unknown[]`.
+- `preProcess`: Add pre-processing behavior for code blocks (advanced customization). Returns a transformer function.
+- `postProcess`: Add post-processing behavior for code blocks (advanced customization). Returns a transformer function.
+- `handleCodeTitles`: Move code title metadata to `<pre>` attributes (advanced customization). Returns a transformer function.
+
+#### Type Exports
+
+|               Type               |                    Purpose                    |
+| -------------------------------- | --------------------------------------------- |
+| `MdxCompileResult`               | Result shape for compiled MDX content         |
+| `TocItem`                        | Heading item structure used by TOC extraction |
+| `ParseMdxOptions`                | Options for `parseMdx` compile behavior       |
+| `ReadMdxFileResult`              | Return type for `readMdxFileBySlug`           |
+| `ParsedMdxFile`                  | Parsed file structure before compile          |
+| `CompiledMdxFile`                | Compiled file structure with metadata and TOC |
+| `CreateMdxContentServiceOptions` | Options for creating the content service      |
+
+### Quick Import Recipes
+
+#### 1. Compile raw MDX only
+
+```ts
+import { parseMdx } from "@docubook/core";
+```
+
+Use this when your source is already in memory and you only need compiled content.
+
+#### 2. Read frontmatter only
+
+```ts
+import { extractFrontmatter } from "@docubook/core";
+```
+
+Use this for metadata pages where full MDX compilation is unnecessary.
+
+#### 3. Build TOC from raw content
+
+```ts
+import { extractTocsFromRawMdx } from "@docubook/core";
+```
+
+Use this when you need heading navigation from markdown/MDX text.
+
+#### 4. Slug-based docs service (recommended for app integration)
+
+```ts
+import { createMdxContentService } from "@docubook/core";
+```
+
+Use this as the default app-level integration for frontmatter, TOC, and compiled docs in one service.
+
+#### 5. Low-level file pipeline (advanced)
+
+```ts
+import {
+  readMdxFileBySlug,
+  parseMdxFile,
+  compileParsedMdxFile,
+} from "@docubook/core";
+```
+
+Use this when you need full control over each pipeline step.
+
+### Basic Compile Helpers
 
 ```ts
 import {
@@ -109,20 +195,38 @@ const docsService = createMdxContentService<Frontmatter>({
 const doc = await docsService.getCompiledForSlug("getting-started/introduction");
 ```
 
-## API Overview
+## Dependency Management Policy
 
-- `parseMdx` - Compiles raw MDX with default or custom plugin options
-- `createMdxContentService` - Unified high-level API for read/parse/compile/getters
-- `readMdxFileBySlug` - Reads `slug.mdx` or `slug/index.mdx` from docs directory
-- `parseMdxFile` - Converts raw file result into `frontmatter` + `tocs` + `content`
-- `compileParsedMdxFile` - Compiles a parsed document while preserving metadata
-- `extractFrontmatter` - Parses frontmatter from raw markdown/MDX
-- `extractTocsFromRawMdx` - Extracts headings for TOC generation
-- `sluggify` - Converts heading text into URL-friendly slugs
+Dependencies required for markdown processing are managed in this package and updated by the DocuBook author.
+
+This means app-level users should focus on content and integration. Plugin upgrades, compatibility checks, and pipeline maintenance are handled centrally by DocuBook.
+
+### Managed Markdown Dependencies
+
+- gray-matter
+- rehype-autolink-headings
+- rehype-code-titles
+- rehype-prism-plus
+- rehype-slug
+- remark-gfm
+- unist-util-visit
+
+The `remark` and `rehype` plugin stack is intentionally owned by this package to avoid dependency drift across apps.
+
+## Why This Matters
+
+- Consistent behavior across all DocuBook-based projects
+- Easier maintenance and safer upgrades
+- Less dependency duplication in app-level package.json files
+- Faster onboarding for users who only need to write docs
 
 ## Notes
 
-If your app uses `next-mdx-remote` directly for rendering in custom components, keep that direct dependency in the app.
+`@docubook/core` already includes and manages the MDX runtime/compile dependencies (including `next-mdx-remote`) as part of the package contract.
+
+In most integrations, users only need to install `@docubook/core` and use the core APIs.
+
+Only add `next-mdx-remote` directly in your app if your app explicitly imports it in app-level code.
 
 For compile pipeline plugins (especially `remark` and `rehype` plugins), rely on this package and avoid re-declaring them at app level unless you have a specific override requirement.
 

package/dist/compile.d.ts

@@ -0,0 +1,19 @@
+import { compileMDX } from "next-mdx-remote/rsc";
+import type { Node } from "unist";
+import type { MdxCompileResult } from "./types";
+type CompileMdxInput = Parameters<typeof compileMDX<Record<string, unknown>>>[0];
+type CompileMdxOptions = NonNullable<CompileMdxInput["options"]>;
+type CompilerMdxOptions = NonNullable<CompileMdxOptions["mdxOptions"]>;
+export type ParseMdxOptions = {
+    components?: CompileMdxInput["components"];
+    rehypePlugins?: CompilerMdxOptions["rehypePlugins"];
+    remarkPlugins?: CompilerMdxOptions["remarkPlugins"];
+};
+export declare const handleCodeTitles: () => (tree: Node) => void;
+export declare const preProcess: () => (tree: Node) => void;
+export declare const postProcess: () => (tree: Node) => void;
+export declare function createDefaultRehypePlugins(): unknown[];
+export declare function createDefaultRemarkPlugins(): unknown[];
+export declare function parseMdx<Frontmatter>(rawMdx: string, options?: ParseMdxOptions): Promise<MdxCompileResult<Frontmatter>>;
+export {};
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAU,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAkBhD,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,KAAK,iBAAiB,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpD,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CACvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,SAAU,MAAM,IAAI,SAgChD,CAAC;AAEF,eAAO,MAAM,UAAU,SAAU,MAAM,IAAI,SAa1C,CAAC;AAEF,eAAO,MAAM,WAAW,SAAU,MAAM,IAAI,SAS3C,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,OAAO,EAAE,CAUtD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,EAAE,CAEtD;AAED,wBAAsB,QAAQ,CAAC,WAAW,EACtC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAexC"}

package/{src/compile.ts → dist/compile.js}

@@ -1,61 +1,29 @@
 import { compileMDX } from "next-mdx-remote/rsc";
-import type { Node, Parent } from "unist";
 import { visit } from "unist-util-visit";
 import remarkGfm from "remark-gfm";
 import rehypePrism from "rehype-prism-plus";
 import rehypeAutolinkHeadings from "rehype-autolink-headings";
 import rehypeSlug from "rehype-slug";
 import rehypeCodeTitles from "rehype-code-titles";
-import type { MdxCompileResult } from "./types";
-
-interface Element extends Node {
-    type: string;
-    tagName?: string;
-    properties?: Record<string, unknown> & {
-        className?: string[];
-        raw?: string;
-    };
-    children?: Node[];
-    raw?: string;
-}
-
-interface TextNode extends Node {
-    type: "text";
-    value: string;
-}
-
-type CompileMdxInput = Parameters<typeof compileMDX<Record<string, unknown>>>[0];
-type CompileMdxOptions = NonNullable<CompileMdxInput["options"]>;
-type CompilerMdxOptions = NonNullable<CompileMdxOptions["mdxOptions"]>;
-
-export type ParseMdxOptions = {
-    components?: CompileMdxInput["components"];
-    rehypePlugins?: CompilerMdxOptions["rehypePlugins"];
-    remarkPlugins?: CompilerMdxOptions["remarkPlugins"];
-};
-
-export const handleCodeTitles = () => (tree: Node) => {
-    visit(tree, "element", (node: Element, index: number | null, parent: Parent | null) => {
+export const handleCodeTitles = () => (tree) => {
+    visit(tree, "element", (node, index, parent) => {
         if (!parent || index === null || node.tagName !== "div") {
             return;
         }
-
         const isTitleDiv = node.properties?.className?.includes("rehype-code-title");
         if (!isTitleDiv) {
             return;
         }
-
-        let nextElement: Element | null = null;
+        let nextElement = null;
         for (let i = index + 1; i < parent.children.length; i++) {
             const sibling = parent.children[i];
             if (sibling.type === "element") {
-                nextElement = sibling as Element;
+                nextElement = sibling;
                 break;
             }
         }
-
         if (nextElement?.tagName === "pre") {
-            const titleNode = node.children?.[0] as TextNode;
+            const titleNode = node.children?.[0];
             if (titleNode?.type === "text") {
                 if (!nextElement.properties) {
                     nextElement.properties = {};
@@ -67,25 +35,23 @@ export const handleCodeTitles = () => (tree: Node) => {
         }
     });
 };
-
-export const preProcess = () => (tree: Node) => {
-    visit(tree, (node: Node) => {
-        const element = node as Element;
+export const preProcess = () => (tree) => {
+    visit(tree, (node) => {
+        const element = node;
         if (element?.type === "element" && element?.tagName === "pre" && element.children) {
-            const [codeEl] = element.children as Element[];
-            if (codeEl.tagName !== "code" || !codeEl.children?.[0]) return;
-
-            const textNode = codeEl.children[0] as TextNode;
+            const [codeEl] = element.children;
+            if (codeEl.tagName !== "code" || !codeEl.children?.[0])
+                return;
+            const textNode = codeEl.children[0];
             if (textNode.type === "text" && textNode.value) {
                 element.raw = textNode.value;
             }
         }
     });
 };
-
-export const postProcess = () => (tree: Node) => {
-    visit(tree, "element", (node: Node) => {
-        const element = node as Element;
+export const postProcess = () => (tree) => {
+    visit(tree, "element", (node) => {
+        const element = node;
         if (element?.type === "element" && element?.tagName === "pre") {
             if (element.properties && element.raw) {
                 element.properties.raw = element.raw;
@@ -93,8 +59,7 @@ export const postProcess = () => (tree: Node) => {
         }
     });
 };
-
-export function createDefaultRehypePlugins(): unknown[] {
+export function createDefaultRehypePlugins() {
     return [
         preProcess,
         rehypeCodeTitles,
@@ -105,19 +70,13 @@ export function createDefaultRehypePlugins(): unknown[] {
         postProcess,
     ];
 }
-
-export function createDefaultRemarkPlugins(): unknown[] {
+export function createDefaultRemarkPlugins() {
     return [remarkGfm];
 }
-
-export async function parseMdx<Frontmatter>(
-    rawMdx: string,
-    options: ParseMdxOptions = {}
-): Promise<MdxCompileResult<Frontmatter>> {
-    const rehypePlugins = options.rehypePlugins ?? (createDefaultRehypePlugins() as CompilerMdxOptions["rehypePlugins"]);
-    const remarkPlugins = options.remarkPlugins ?? (createDefaultRemarkPlugins() as CompilerMdxOptions["remarkPlugins"]);
-
-    return await compileMDX<Frontmatter>({
+export async function parseMdx(rawMdx, options = {}) {
+    const rehypePlugins = options.rehypePlugins ?? createDefaultRehypePlugins();
+    const remarkPlugins = options.remarkPlugins ?? createDefaultRemarkPlugins();
+    return await compileMDX({
         source: rawMdx,
         options: {
             parseFrontmatter: true,
@@ -129,3 +88,4 @@ export async function parseMdx<Frontmatter>(
         components: options.components,
     });
 }
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,41 @@
+import { type ParseMdxOptions } from "./compile";
+import type { MdxCompileResult, TocItem } from "./types";
+type CacheFn = <T extends (...args: any[]) => any>(fn: T) => T;
+export type ReadMdxFileResult = {
+    content: string;
+    filePath: string;
+};
+export type ParsedMdxFile<Frontmatter, T extends TocItem = TocItem> = {
+    content: string;
+    filePath: string;
+    frontmatter: Frontmatter;
+    tocs: T[];
+};
+export type CompiledMdxFile<Frontmatter, T extends TocItem = TocItem> = MdxCompileResult<Frontmatter> & {
+    filePath: string;
+    tocs: T[];
+};
+type ReadMdxBySlugOptions = {
+    rootDir?: string;
+    docsDir?: string;
+};
+export declare function readMdxFileBySlug(slug: string, options?: ReadMdxBySlugOptions): Promise<ReadMdxFileResult>;
+type ParseMdxFileOptions<T extends TocItem> = {
+    tocsExtractor?: (rawMdx: string) => T[];
+};
+export declare function parseMdxFile<Frontmatter, T extends TocItem = TocItem>(raw: ReadMdxFileResult, options?: ParseMdxFileOptions<T>): ParsedMdxFile<Frontmatter, T>;
+export declare function compileParsedMdxFile<Frontmatter, T extends TocItem = TocItem>(parsed: ParsedMdxFile<Frontmatter, T>, options?: ParseMdxOptions): Promise<CompiledMdxFile<Frontmatter, T>>;
+export type CreateMdxContentServiceOptions<Frontmatter, T extends TocItem = TocItem> = {
+    parseOptions?: ParseMdxOptions;
+    readOptions?: ReadMdxBySlugOptions;
+    tocsExtractor?: (rawMdx: string) => T[];
+    cacheFn?: CacheFn;
+};
+export declare function createMdxContentService<Frontmatter, T extends TocItem = TocItem>(options?: CreateMdxContentServiceOptions<Frontmatter, T>): {
+    getParsedForSlug: (slug: string) => Promise<ParsedMdxFile<Frontmatter, T>>;
+    getCompiledForSlug: (slug: string) => Promise<CompiledMdxFile<Frontmatter, T>>;
+    getFrontmatterForSlug: (slug: string) => Promise<Frontmatter>;
+    getTocsForSlug: (slug: string) => Promise<T[]>;
+};
+export {};
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,CAAC,EAAE,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,GAAG;IACpG,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,CAAC;CACb,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyBpH;AAED,KAAK,mBAAmB,CAAC,CAAC,SAAS,OAAO,IAAI;IAC1C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;CAC3C,CAAC;AAEF,wBAAgB,YAAY,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,EACjE,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,mBAAmB,CAAC,CAAC,CAAM,GACrC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAS/B;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,EAC/E,MAAM,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,EACrC,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAS1C;AAED,MAAM,MAAM,8BAA8B,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IACnF,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,EAC5E,OAAO,GAAE,8BAA8B,CAAC,WAAW,EAAE,CAAC,CAAM;6BAKd,MAAM,KAAG,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;+BAK7C,MAAM,KAAG,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;kCAKtD,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC;2BAKpC,MAAM,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;EAW5D"}

package/dist/content.js

@@ -0,0 +1,74 @@
+import path from "path";
+import { promises as fs } from "fs";
+import { extractFrontmatter, extractTocsFromRawMdx } from "./extract";
+import { parseMdx } from "./compile";
+export async function readMdxFileBySlug(slug, options = {}) {
+    const docsDir = options.docsDir ?? "docs";
+    // Keep file-system path operations ignored by Turbopack tracing.
+    // The runtime path is constrained to docsDir and slug candidates below.
+    const docsRoot = options.rootDir
+        ? path.join(/*turbopackIgnore: true*/ options.rootDir, docsDir)
+        : path.join(/*turbopackIgnore: true*/ process.cwd(), docsDir);
+    const paths = [
+        path.join(/*turbopackIgnore: true*/ docsRoot, `${slug}.mdx`),
+        path.join(/*turbopackIgnore: true*/ docsRoot, slug, "index.mdx"),
+    ];
+    for (const p of paths) {
+        try {
+            const content = await fs.readFile(/*turbopackIgnore: true*/ p, "utf-8");
+            return {
+                content,
+                filePath: `${docsDir}/${path.relative(/*turbopackIgnore: true*/ docsRoot, p)}`,
+            };
+        }
+        catch {
+            // ignore and try next candidate
+        }
+    }
+    throw new Error(`Could not find mdx file for slug: ${slug}`);
+}
+export function parseMdxFile(raw, options = {}) {
+    const tocsExtractor = options.tocsExtractor ?? ((mdx) => extractTocsFromRawMdx(mdx));
+    return {
+        content: raw.content,
+        filePath: raw.filePath,
+        frontmatter: extractFrontmatter(raw.content),
+        tocs: tocsExtractor(raw.content),
+    };
+}
+export async function compileParsedMdxFile(parsed, options = {}) {
+    const compiled = await parseMdx(parsed.content, options);
+    return {
+        ...compiled,
+        frontmatter: parsed.frontmatter,
+        filePath: parsed.filePath,
+        tocs: parsed.tocs,
+    };
+}
+export function createMdxContentService(options = {}) {
+    const identityCache = (fn) => fn;
+    const cacheFn = options.cacheFn ?? identityCache;
+    const getParsedForSlug = cacheFn(async (slug) => {
+        const raw = await readMdxFileBySlug(slug, options.readOptions);
+        return parseMdxFile(raw, { tocsExtractor: options.tocsExtractor });
+    });
+    const getCompiledForSlug = cacheFn(async (slug) => {
+        const parsed = await getParsedForSlug(slug);
+        return compileParsedMdxFile(parsed, options.parseOptions);
+    });
+    async function getFrontmatterForSlug(slug) {
+        const parsed = await getParsedForSlug(slug);
+        return parsed.frontmatter;
+    }
+    async function getTocsForSlug(slug) {
+        const parsed = await getParsedForSlug(slug);
+        return parsed.tocs;
+    }
+    return {
+        getParsedForSlug,
+        getCompiledForSlug,
+        getFrontmatterForSlug,
+        getTocsForSlug,
+    };
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,5 @@
+import type { TocItem } from "./types";
+export declare function sluggify(text: string): string;
+export declare function extractTocsFromRawMdx(rawMdx: string): TocItem[];
+export declare function extractFrontmatter<Frontmatter>(content: string): Frontmatter;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CA+B/D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAE5E"}

package/{src/extract.ts → dist/extract.js}

@@ -1,20 +1,16 @@
 import matter from "gray-matter";
-import type { TocItem } from "./types";
-
-export function sluggify(text: string): string {
+export function sluggify(text) {
     const slug = text.toLowerCase().replace(/\s+/g, "-");
     return slug.replace(/[^a-z0-9-]/g, "");
 }
-
-export function extractTocsFromRawMdx(rawMdx: string): TocItem[] {
+export function extractTocsFromRawMdx(rawMdx) {
     // Match code blocks, markdown headings, and <Release version="x.y.z" />.
     const combinedRegex = /(```[\s\S]*?```)|^(#{2,4})\s(.+)$|<Release[^>]*version="([^"]+)"/gm;
-    const extractedHeadings: TocItem[] = [];
-
-    let match: RegExpExecArray | null;
+    const extractedHeadings = [];
+    let match;
     while ((match = combinedRegex.exec(rawMdx)) !== null) {
-        if (match[1]) continue;
-
+        if (match[1])
+            continue;
         if (match[2]) {
             const headingLevel = match[2].length;
             const headingText = match[3].trim();
@@ -25,7 +21,6 @@ export function extractTocsFromRawMdx(rawMdx: string): TocItem[] {
             });
             continue;
         }
-
         if (match[4]) {
             const version = match[4];
             extractedHeadings.push({
@@ -35,10 +30,9 @@ export function extractTocsFromRawMdx(rawMdx: string): TocItem[] {
             });
         }
     }
-
     return extractedHeadings;
 }
-
-export function extractFrontmatter<Frontmatter>(content: string): Frontmatter {
-    return matter(content).data as Frontmatter;
+export function extractFrontmatter(content) {
+    return matter(content).data;
 }
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAChD,yEAAyE;IACzE,MAAM,aAAa,GAAG,oEAAoE,CAAC;IAC3F,MAAM,iBAAiB,GAAc,EAAE,CAAC;IAExC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnD,IAAI,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QAEvB,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,iBAAiB,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE;aACpC,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QAED,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,iBAAiB,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,IAAI,OAAO,EAAE;gBACnB,IAAI,EAAE,IAAI,OAAO,EAAE;aACtB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAc,OAAe;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,IAAmB,CAAC;AAC/C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { TocItem, MdxCompileResult } from "./types";
+export { parseMdx, preProcess, postProcess, handleCodeTitles, createDefaultRehypePlugins, createDefaultRemarkPlugins, } from "./compile";
+export { extractFrontmatter, extractTocsFromRawMdx, sluggify } from "./extract";
+export type { ParseMdxOptions } from "./compile";
+export { readMdxFileBySlug, parseMdxFile, compileParsedMdxFile, createMdxContentService, } from "./content";
+export type { ReadMdxFileResult, ParsedMdxFile, CompiledMdxFile, CreateMdxContentServiceOptions, } from "./content";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACH,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,8BAA8B,GACjC,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { parseMdx, preProcess, postProcess, handleCodeTitles, createDefaultRehypePlugins, createDefaultRemarkPlugins, } from "./compile";
+export { extractFrontmatter, extractTocsFromRawMdx, sluggify } from "./extract";
+export { readMdxFileBySlug, parseMdxFile, compileParsedMdxFile, createMdxContentService, } from "./content";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEhF,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,WAAW,CAAC"}

package/{src/types.ts → dist/types.d.ts}

@@ -1,13 +1,12 @@
 import type { ReactNode } from "react";
-
 export type TocItem = {
     level: number;
     text: string;
     href: string;
 };
-
 export type MdxCompileResult<Frontmatter> = {
     content: ReactNode;
     frontmatter: Frontmatter;
     scope?: Record<string, unknown>;
 };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,OAAO,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,WAAW,IAAI;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,14 +1,24 @@
 {
     "name": "@docubook/core",
-    "version": "1.0.0",
+    "version": "1.1.1",
     "description": "Shared MDX compile pipeline and markdown utilities for DocuBook",
     "type": "module",
-    "main": "./src/index.ts",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
     "exports": {
-        ".": "./src/index.ts"
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
     },
+    "files": [
+        "dist"
+    ],
     "scripts": {
-        "build": "echo 'core uses source exports'"
+        "build": "tsc -p tsconfig.json",
+        "clean": "rm -rf dist",
+        "prepublishOnly": "pnpm run clean && pnpm run build"
     },
     "keywords": [
         "docubook",

package/src/content.ts

@@ -1,129 +0,0 @@
-import path from "path";
-import { promises as fs } from "fs";
-import { extractFrontmatter, extractTocsFromRawMdx } from "./extract";
-import { parseMdx, type ParseMdxOptions } from "./compile";
-import type { MdxCompileResult, TocItem } from "./types";
-
-type CacheFn = <T extends (...args: any[]) => any>(fn: T) => T;
-
-export type ReadMdxFileResult = {
-    content: string;
-    filePath: string;
-};
-
-export type ParsedMdxFile<Frontmatter, T extends TocItem = TocItem> = {
-    content: string;
-    filePath: string;
-    frontmatter: Frontmatter;
-    tocs: T[];
-};
-
-export type CompiledMdxFile<Frontmatter, T extends TocItem = TocItem> = MdxCompileResult<Frontmatter> & {
-    filePath: string;
-    tocs: T[];
-};
-
-type ReadMdxBySlugOptions = {
-    rootDir?: string;
-    docsDir?: string;
-};
-
-export async function readMdxFileBySlug(slug: string, options: ReadMdxBySlugOptions = {}): Promise<ReadMdxFileResult> {
-    const docsDir = options.docsDir ?? "docs";
-    // Keep file-system path operations ignored by Turbopack tracing.
-    // The runtime path is constrained to docsDir and slug candidates below.
-    const docsRoot = options.rootDir
-        ? path.join(/*turbopackIgnore: true*/ options.rootDir, docsDir)
-        : path.join(/*turbopackIgnore: true*/ process.cwd(), docsDir);
-    const paths = [
-        path.join(/*turbopackIgnore: true*/ docsRoot, `${slug}.mdx`),
-        path.join(/*turbopackIgnore: true*/ docsRoot, slug, "index.mdx"),
-    ];
-
-    for (const p of paths) {
-        try {
-            const content = await fs.readFile(/*turbopackIgnore: true*/ p, "utf-8");
-            return {
-                content,
-                filePath: `${docsDir}/${path.relative(/*turbopackIgnore: true*/ docsRoot, p)}`,
-            };
-        } catch {
-            // ignore and try next candidate
-        }
-    }
-
-    throw new Error(`Could not find mdx file for slug: ${slug}`);
-}
-
-type ParseMdxFileOptions<T extends TocItem> = {
-    tocsExtractor?: (rawMdx: string) => T[];
-};
-
-export function parseMdxFile<Frontmatter, T extends TocItem = TocItem>(
-    raw: ReadMdxFileResult,
-    options: ParseMdxFileOptions<T> = {}
-): ParsedMdxFile<Frontmatter, T> {
-    const tocsExtractor = options.tocsExtractor ?? ((mdx) => extractTocsFromRawMdx(mdx) as T[]);
-
-    return {
-        content: raw.content,
-        filePath: raw.filePath,
-        frontmatter: extractFrontmatter<Frontmatter>(raw.content),
-        tocs: tocsExtractor(raw.content),
-    };
-}
-
-export async function compileParsedMdxFile<Frontmatter, T extends TocItem = TocItem>(
-    parsed: ParsedMdxFile<Frontmatter, T>,
-    options: ParseMdxOptions = {}
-): Promise<CompiledMdxFile<Frontmatter, T>> {
-    const compiled = await parseMdx<Frontmatter>(parsed.content, options);
-
-    return {
-        ...compiled,
-        frontmatter: parsed.frontmatter,
-        filePath: parsed.filePath,
-        tocs: parsed.tocs,
-    };
-}
-
-export type CreateMdxContentServiceOptions<Frontmatter, T extends TocItem = TocItem> = {
-    parseOptions?: ParseMdxOptions;
-    readOptions?: ReadMdxBySlugOptions;
-    tocsExtractor?: (rawMdx: string) => T[];
-    cacheFn?: CacheFn;
-};
-
-export function createMdxContentService<Frontmatter, T extends TocItem = TocItem>(
-    options: CreateMdxContentServiceOptions<Frontmatter, T> = {}
-) {
-    const identityCache: CacheFn = (fn) => fn;
-    const cacheFn = options.cacheFn ?? identityCache;
-
-    const getParsedForSlug = cacheFn(async (slug: string): Promise<ParsedMdxFile<Frontmatter, T>> => {
-        const raw = await readMdxFileBySlug(slug, options.readOptions);
-        return parseMdxFile<Frontmatter, T>(raw, { tocsExtractor: options.tocsExtractor });
-    });
-
-    const getCompiledForSlug = cacheFn(async (slug: string): Promise<CompiledMdxFile<Frontmatter, T>> => {
-        const parsed = await getParsedForSlug(slug);
-        return compileParsedMdxFile<Frontmatter, T>(parsed, options.parseOptions);
-    });
-
-    async function getFrontmatterForSlug(slug: string): Promise<Frontmatter> {
-        const parsed = await getParsedForSlug(slug);
-        return parsed.frontmatter;
-    }
-
-    async function getTocsForSlug(slug: string): Promise<T[]> {
-        const parsed = await getParsedForSlug(slug);
-        return parsed.tocs;
-    }
-
-    return {
-        getParsedForSlug,
-        getCompiledForSlug,
-        getFrontmatterForSlug,
-        getTocsForSlug,
-    };
-}

package/src/index.ts

@@ -1,23 +0,0 @@
-export type { TocItem, MdxCompileResult } from "./types";
-export {
-    parseMdx,
-    preProcess,
-    postProcess,
-    handleCodeTitles,
-    createDefaultRehypePlugins,
-    createDefaultRemarkPlugins,
-} from "./compile";
-export { extractFrontmatter, extractTocsFromRawMdx, sluggify } from "./extract";
-export type { ParseMdxOptions } from "./compile";
-export {
-    readMdxFileBySlug,
-    parseMdxFile,
-    compileParsedMdxFile,
-    createMdxContentService,
-} from "./content";
-export type {
-    ReadMdxFileResult,
-    ParsedMdxFile,
-    CompiledMdxFile,
-    CreateMdxContentServiceOptions,
-} from "./content";

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2020",
-        "module": "ESNext",
-        "moduleResolution": "Bundler",
-        "strict": true,
-        "skipLibCheck": true,
-        "declaration": true,
-        "declarationMap": true,
-        "jsx": "preserve"
-    },
-    "include": [
-        "src/**/*"
-    ]
-}