@docubook/core 1.1.2 → 1.3.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.
- package/README.md +46 -23
- package/dist/compile.d.ts +7 -0
- package/dist/compile.d.ts.map +1 -1
- package/dist/compile.js +1 -1
- package/dist/compile.js.map +1 -1
- package/dist/content.d.ts +11 -0
- package/dist/content.d.ts.map +1 -1
- package/dist/content.js +27 -6
- package/dist/content.js.map +1 -1
- package/dist/extract.d.ts +8 -0
- package/dist/extract.d.ts.map +1 -1
- package/dist/extract.js +55 -10
- package/dist/extract.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -71,31 +71,33 @@ const tocs = await docsService.getTocsForSlug("getting-started/introduction");
|
|
|
71
71
|
|
|
72
72
|
#### Runtime APIs
|
|
73
73
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
74
|
+
| Function | Description | Returns |
|
|
75
|
+
| -------- | ----------- | ------- |
|
|
76
|
+
| `parseMdx` | Compile raw MDX string with optional custom parse options | `MdxCompileResult<Frontmatter>` |
|
|
77
|
+
| `createMdxContentService` | Create slug-based docs service (`getParsedForSlug`, `getCompiledForSlug`, `getFrontmatterForSlug`, `getTocsForSlug`). Accepts optional `frontmatterEnricher` to inject computed or fallback values after parsing | service object |
|
|
78
|
+
| `readMdxFileBySlug` | Read `slug.mdx` or `slug/index.mdx` from docs directory | `ReadMdxFileResult` |
|
|
79
|
+
| `parseMdxFile` | Convert raw file result into `frontmatter`, `tocs`, `content`, `filePath` | `ParsedMdxFile<Frontmatter, TocItem>` |
|
|
80
|
+
| `compileParsedMdxFile` | Compile parsed MDX while preserving metadata and TOCs | `CompiledMdxFile<Frontmatter, TocItem>` |
|
|
81
|
+
| `extractFrontmatter` | Parse frontmatter only from raw markdown/MDX | `Frontmatter` |
|
|
82
|
+
| `extractTocsFromRawMdx` | Extract headings for table of contents generation | `TocItem[]` |
|
|
83
|
+
| `sluggify` | Convert heading text into URL-safe slug | `string` |
|
|
84
|
+
| `createDefaultRehypePlugins` | Get default DocuBook rehype plugin stack | `unknown[]` |
|
|
85
|
+
| `createDefaultRemarkPlugins` | Get default DocuBook remark plugin stack | `unknown[]` |
|
|
86
|
+
| `preProcess` | Add pre-processing behavior for code blocks (advanced) | transformer function |
|
|
87
|
+
| `postProcess` | Add post-processing behavior for code blocks (advanced) | transformer function |
|
|
88
|
+
| `handleCodeTitles` | Move code title metadata to `<pre>` attributes (advanced) | transformer function |
|
|
87
89
|
|
|
88
90
|
#### Type Exports
|
|
89
91
|
|
|
90
|
-
| Type |
|
|
91
|
-
| -------------------------------- |
|
|
92
|
-
| `MdxCompileResult` | Result shape for compiled MDX content
|
|
93
|
-
| `TocItem` | Heading item structure used by TOC extraction
|
|
94
|
-
| `ParseMdxOptions` | Options for `parseMdx` compile behavior
|
|
95
|
-
| `ReadMdxFileResult` | Return type for `readMdxFileBySlug`
|
|
96
|
-
| `ParsedMdxFile` | Parsed file structure before compile
|
|
97
|
-
| `CompiledMdxFile` | Compiled file structure with metadata and TOC
|
|
98
|
-
| `CreateMdxContentServiceOptions` | Options for creating the content service
|
|
92
|
+
| Type | Purpose |
|
|
93
|
+
| -------------------------------- | ------------------------------------------------------------------------- |
|
|
94
|
+
| `MdxCompileResult` | Result shape for compiled MDX content |
|
|
95
|
+
| `TocItem` | Heading item structure used by TOC extraction |
|
|
96
|
+
| `ParseMdxOptions` | Options for `parseMdx` compile behavior |
|
|
97
|
+
| `ReadMdxFileResult` | Return type for `readMdxFileBySlug` |
|
|
98
|
+
| `ParsedMdxFile` | Parsed file structure before compile |
|
|
99
|
+
| `CompiledMdxFile` | Compiled file structure with metadata and TOC |
|
|
100
|
+
| `CreateMdxContentServiceOptions` | Options for creating the content service, including `frontmatterEnricher` |
|
|
99
101
|
|
|
100
102
|
### Quick Import Recipes
|
|
101
103
|
|
|
@@ -131,7 +133,28 @@ import { createMdxContentService } from "@docubook/core";
|
|
|
131
133
|
|
|
132
134
|
Use this as the default app-level integration for frontmatter, TOC, and compiled docs in one service.
|
|
133
135
|
|
|
134
|
-
#### 5.
|
|
136
|
+
#### 5. Frontmatter enrichment (date fallback, computed fields)
|
|
137
|
+
|
|
138
|
+
```ts
|
|
139
|
+
import { createMdxContentService } from "@docubook/core";
|
|
140
|
+
|
|
141
|
+
const docsService = createMdxContentService<Frontmatter, TocItem>({
|
|
142
|
+
parseOptions: { components },
|
|
143
|
+
cacheFn: cache,
|
|
144
|
+
frontmatterEnricher: async (frontmatter, absoluteFilePath) => {
|
|
145
|
+
if (!frontmatter.date) {
|
|
146
|
+
const { promises: fs } = await import("fs");
|
|
147
|
+
const stat = await fs.stat(absoluteFilePath);
|
|
148
|
+
return { ...frontmatter, date: stat.mtime };
|
|
149
|
+
}
|
|
150
|
+
return frontmatter;
|
|
151
|
+
},
|
|
152
|
+
});
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
Use this to inject computed or fallback values into frontmatter after parsing — such as a last-modified date from the filesystem or a git commit timestamp. The enricher receives the already-parsed frontmatter and the absolute path of the MDX file on disk, and runs once per slug before caching.
|
|
156
|
+
|
|
157
|
+
#### 6. Low-level file pipeline (advanced)
|
|
135
158
|
|
|
136
159
|
```ts
|
|
137
160
|
import {
|
package/dist/compile.d.ts
CHANGED
|
@@ -8,6 +8,13 @@ export type ParseMdxOptions = {
|
|
|
8
8
|
components?: CompileMdxInput["components"];
|
|
9
9
|
rehypePlugins?: CompilerMdxOptions["rehypePlugins"];
|
|
10
10
|
remarkPlugins?: CompilerMdxOptions["remarkPlugins"];
|
|
11
|
+
/**
|
|
12
|
+
* Whether to parse frontmatter during MDX compilation.
|
|
13
|
+
* Set to `false` when frontmatter is already extracted separately
|
|
14
|
+
* (e.g. via gray-matter) to avoid redundant parsing.
|
|
15
|
+
* Defaults to `true`.
|
|
16
|
+
*/
|
|
17
|
+
parseFrontmatter?: boolean;
|
|
11
18
|
};
|
|
12
19
|
export declare const handleCodeTitles: () => (tree: Node) => void;
|
|
13
20
|
export declare const preProcess: () => (tree: Node) => void;
|
package/dist/compile.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
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;IACpD;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,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/dist/compile.js
CHANGED
package/dist/compile.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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"}
|
package/dist/content.d.ts
CHANGED
|
@@ -3,9 +3,13 @@ import type { MdxCompileResult, TocItem } from "./types";
|
|
|
3
3
|
type CacheFn = <T extends (...args: any[]) => any>(fn: T) => T;
|
|
4
4
|
export type ReadMdxFileResult = {
|
|
5
5
|
content: string;
|
|
6
|
+
/** Relative path used for UI links (e.g. "docs/getting-started/index.mdx"). */
|
|
6
7
|
filePath: string;
|
|
8
|
+
/** Absolute path on disk — available when file was read by readMdxFileBySlug. */
|
|
9
|
+
absoluteFilePath?: string;
|
|
7
10
|
};
|
|
8
11
|
export type ParsedMdxFile<Frontmatter, T extends TocItem = TocItem> = {
|
|
12
|
+
/** Raw content with frontmatter block stripped — ready to pass to compileMDX. */
|
|
9
13
|
content: string;
|
|
10
14
|
filePath: string;
|
|
11
15
|
frontmatter: Frontmatter;
|
|
@@ -30,6 +34,13 @@ export type CreateMdxContentServiceOptions<Frontmatter, T extends TocItem = TocI
|
|
|
30
34
|
readOptions?: ReadMdxBySlugOptions;
|
|
31
35
|
tocsExtractor?: (rawMdx: string) => T[];
|
|
32
36
|
cacheFn?: CacheFn;
|
|
37
|
+
/**
|
|
38
|
+
* Optional hook to enrich or transform frontmatter after parsing.
|
|
39
|
+
* Called with the parsed frontmatter and the absolute file path.
|
|
40
|
+
* Runs at build time during static generation — ideal for injecting
|
|
41
|
+
* fallback values (e.g. git last-modified date when `date` is absent).
|
|
42
|
+
*/
|
|
43
|
+
frontmatterEnricher?: (frontmatter: Frontmatter, absoluteFilePath: string) => Frontmatter | Promise<Frontmatter>;
|
|
33
44
|
};
|
|
34
45
|
export declare function createMdxContentService<Frontmatter, T extends TocItem = TocItem>(options?: CreateMdxContentServiceOptions<Frontmatter, T>): {
|
|
35
46
|
getParsedForSlug: (slug: string) => Promise<ParsedMdxFile<Frontmatter, T>>;
|
package/dist/content.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
1
|
+
{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"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"}
|
package/dist/content.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import path from "path";
|
|
2
2
|
import { promises as fs } from "fs";
|
|
3
|
-
import {
|
|
3
|
+
import { extractFrontmatterWithContent, extractTocsFromRawMdx } from "./extract";
|
|
4
4
|
import { parseMdx } from "./compile";
|
|
5
5
|
export async function readMdxFileBySlug(slug, options = {}) {
|
|
6
6
|
const docsDir = options.docsDir ?? "docs";
|
|
@@ -9,35 +9,52 @@ export async function readMdxFileBySlug(slug, options = {}) {
|
|
|
9
9
|
const docsRoot = options.rootDir
|
|
10
10
|
? path.join(/*turbopackIgnore: true*/ options.rootDir, docsDir)
|
|
11
11
|
: path.join(/*turbopackIgnore: true*/ process.cwd(), docsDir);
|
|
12
|
+
// Resolve once for path-traversal guard — all candidate paths must stay
|
|
13
|
+
// inside docsRoot. This prevents "../../etc/passwd" style slugs from
|
|
14
|
+
// escaping the docs directory, especially important with dynamicParams=true.
|
|
15
|
+
const resolvedRoot = path.resolve(/*turbopackIgnore: true*/ docsRoot);
|
|
12
16
|
const paths = [
|
|
13
17
|
path.join(/*turbopackIgnore: true*/ docsRoot, `${slug}.mdx`),
|
|
14
18
|
path.join(/*turbopackIgnore: true*/ docsRoot, slug, "index.mdx"),
|
|
15
19
|
];
|
|
20
|
+
const attempted = [];
|
|
16
21
|
for (const p of paths) {
|
|
22
|
+
attempted.push(p);
|
|
23
|
+
// Guard: reject any path that escapes the docs root.
|
|
24
|
+
const resolvedP = path.resolve(/*turbopackIgnore: true*/ p);
|
|
25
|
+
if (!resolvedP.startsWith(resolvedRoot + path.sep) && resolvedP !== resolvedRoot) {
|
|
26
|
+
continue;
|
|
27
|
+
}
|
|
17
28
|
try {
|
|
18
29
|
const content = await fs.readFile(/*turbopackIgnore: true*/ p, "utf-8");
|
|
19
30
|
return {
|
|
20
31
|
content,
|
|
21
32
|
filePath: `${docsDir}/${path.relative(/*turbopackIgnore: true*/ docsRoot, p)}`,
|
|
33
|
+
absoluteFilePath: p,
|
|
22
34
|
};
|
|
23
35
|
}
|
|
24
36
|
catch {
|
|
25
37
|
// ignore and try next candidate
|
|
26
38
|
}
|
|
27
39
|
}
|
|
28
|
-
throw new Error(
|
|
40
|
+
throw new Error("Could not find mdx file for the requested slug.");
|
|
29
41
|
}
|
|
30
42
|
export function parseMdxFile(raw, options = {}) {
|
|
31
43
|
const tocsExtractor = options.tocsExtractor ?? ((mdx) => extractTocsFromRawMdx(mdx));
|
|
44
|
+
// Extract frontmatter and stripped content in one gray-matter call.
|
|
45
|
+
// strippedContent is passed to compileMDX so it doesn't need to re-parse frontmatter.
|
|
46
|
+
const { frontmatter, strippedContent } = extractFrontmatterWithContent(raw.content);
|
|
32
47
|
return {
|
|
33
|
-
content:
|
|
48
|
+
content: strippedContent,
|
|
34
49
|
filePath: raw.filePath,
|
|
35
|
-
frontmatter
|
|
50
|
+
frontmatter,
|
|
36
51
|
tocs: tocsExtractor(raw.content),
|
|
37
52
|
};
|
|
38
53
|
}
|
|
39
54
|
export async function compileParsedMdxFile(parsed, options = {}) {
|
|
40
|
-
|
|
55
|
+
// Content in parsed is already stripped of frontmatter by parseMdxFile.
|
|
56
|
+
// Set parseFrontmatter:false — no re-parse needed, avoids double work.
|
|
57
|
+
const compiled = await parseMdx(parsed.content, { ...options, parseFrontmatter: false });
|
|
41
58
|
return {
|
|
42
59
|
...compiled,
|
|
43
60
|
frontmatter: parsed.frontmatter,
|
|
@@ -50,7 +67,11 @@ export function createMdxContentService(options = {}) {
|
|
|
50
67
|
const cacheFn = options.cacheFn ?? identityCache;
|
|
51
68
|
const getParsedForSlug = cacheFn(async (slug) => {
|
|
52
69
|
const raw = await readMdxFileBySlug(slug, options.readOptions);
|
|
53
|
-
|
|
70
|
+
const parsed = parseMdxFile(raw, { tocsExtractor: options.tocsExtractor });
|
|
71
|
+
if (options.frontmatterEnricher && raw.absoluteFilePath) {
|
|
72
|
+
parsed.frontmatter = await options.frontmatterEnricher(parsed.frontmatter, raw.absoluteFilePath);
|
|
73
|
+
}
|
|
74
|
+
return parsed;
|
|
54
75
|
});
|
|
55
76
|
const getCompiledForSlug = cacheFn(async (slug) => {
|
|
56
77
|
const parsed = await getParsedForSlug(slug);
|
package/dist/content.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"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"}
|
package/dist/extract.d.ts
CHANGED
|
@@ -2,4 +2,12 @@ import type { TocItem } from "./types";
|
|
|
2
2
|
export declare function sluggify(text: string): string;
|
|
3
3
|
export declare function extractTocsFromRawMdx(rawMdx: string): TocItem[];
|
|
4
4
|
export declare function extractFrontmatter<Frontmatter>(content: string): Frontmatter;
|
|
5
|
+
/**
|
|
6
|
+
* Extract frontmatter and return both the parsed data and the content
|
|
7
|
+
* with the frontmatter block stripped. Avoids a second parse by compileMDX.
|
|
8
|
+
*/
|
|
9
|
+
export declare function extractFrontmatterWithContent<Frontmatter>(content: string): {
|
|
10
|
+
frontmatter: Frontmatter;
|
|
11
|
+
strippedContent: string;
|
|
12
|
+
};
|
|
5
13
|
//# sourceMappingURL=extract.d.ts.map
|
package/dist/extract.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAyBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAmD/D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG;IACzE,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CAC3B,CAGA"}
|
package/dist/extract.js
CHANGED
|
@@ -1,19 +1,56 @@
|
|
|
1
1
|
import matter from "gray-matter";
|
|
2
|
+
const FENCE_MARKER_REGEX = /^(````|```)(?!`)/;
|
|
3
|
+
const HEADING_REGEX = /^(#{2,4})\s+(.+)$/;
|
|
4
|
+
const RELEASE_VERSION_ATTR_REGEX = /\bversion\s*=\s*"([^"]+)"/;
|
|
2
5
|
export function sluggify(text) {
|
|
3
6
|
const slug = text.toLowerCase().replace(/\s+/g, "-");
|
|
4
7
|
return slug.replace(/[^a-z0-9-]/g, "");
|
|
5
8
|
}
|
|
9
|
+
function parseReleaseVersionFromLine(line) {
|
|
10
|
+
const releaseStart = line.indexOf("<Release");
|
|
11
|
+
if (releaseStart === -1) {
|
|
12
|
+
return null;
|
|
13
|
+
}
|
|
14
|
+
// Parse only the first tag fragment on the line to avoid broad regex scans.
|
|
15
|
+
const fragment = line.slice(releaseStart, releaseStart + 512);
|
|
16
|
+
const closingIndex = fragment.indexOf(">");
|
|
17
|
+
if (closingIndex === -1) {
|
|
18
|
+
return null;
|
|
19
|
+
}
|
|
20
|
+
const tag = fragment.slice(0, closingIndex + 1);
|
|
21
|
+
if (!/^<Release\b/.test(tag)) {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
const attrMatch = RELEASE_VERSION_ATTR_REGEX.exec(tag);
|
|
25
|
+
const version = attrMatch?.[1] ?? "";
|
|
26
|
+
return version.trim() || null;
|
|
27
|
+
}
|
|
6
28
|
export function extractTocsFromRawMdx(rawMdx) {
|
|
7
|
-
// Match code blocks, markdown headings, and <Release version="x.y.z" />.
|
|
8
|
-
const combinedRegex = /(```[\s\S]*?```)|^(#{2,4})\s(.+)$|<Release\s+version="([^"]+)"/gm;
|
|
9
29
|
const extractedHeadings = [];
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
30
|
+
const lines = rawMdx.split(/\r?\n/);
|
|
31
|
+
let inFence = false;
|
|
32
|
+
let fenceLength = 0;
|
|
33
|
+
for (const line of lines) {
|
|
34
|
+
const trimmed = line.trimStart();
|
|
35
|
+
const fenceMatch = FENCE_MARKER_REGEX.exec(trimmed);
|
|
36
|
+
if (fenceMatch) {
|
|
37
|
+
const marker = fenceMatch[1];
|
|
38
|
+
if (!inFence) {
|
|
39
|
+
inFence = true;
|
|
40
|
+
fenceLength = marker.length;
|
|
41
|
+
}
|
|
42
|
+
else if (marker.length === fenceLength) {
|
|
43
|
+
inFence = false;
|
|
44
|
+
}
|
|
13
45
|
continue;
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
46
|
+
}
|
|
47
|
+
if (inFence) {
|
|
48
|
+
continue;
|
|
49
|
+
}
|
|
50
|
+
const headingMatch = HEADING_REGEX.exec(trimmed);
|
|
51
|
+
if (headingMatch) {
|
|
52
|
+
const headingLevel = headingMatch[1].length;
|
|
53
|
+
const headingText = headingMatch[2].trim().replace(/\s+#+\s*$/, "");
|
|
17
54
|
extractedHeadings.push({
|
|
18
55
|
level: headingLevel,
|
|
19
56
|
text: headingText,
|
|
@@ -21,8 +58,8 @@ export function extractTocsFromRawMdx(rawMdx) {
|
|
|
21
58
|
});
|
|
22
59
|
continue;
|
|
23
60
|
}
|
|
24
|
-
|
|
25
|
-
|
|
61
|
+
const version = parseReleaseVersionFromLine(line);
|
|
62
|
+
if (version) {
|
|
26
63
|
extractedHeadings.push({
|
|
27
64
|
level: 2,
|
|
28
65
|
text: `v${version}`,
|
|
@@ -35,4 +72,12 @@ export function extractTocsFromRawMdx(rawMdx) {
|
|
|
35
72
|
export function extractFrontmatter(content) {
|
|
36
73
|
return matter(content).data;
|
|
37
74
|
}
|
|
75
|
+
/**
|
|
76
|
+
* Extract frontmatter and return both the parsed data and the content
|
|
77
|
+
* with the frontmatter block stripped. Avoids a second parse by compileMDX.
|
|
78
|
+
*/
|
|
79
|
+
export function extractFrontmatterWithContent(content) {
|
|
80
|
+
const { data, content: strippedContent } = matter(content);
|
|
81
|
+
return { frontmatter: data, strippedContent };
|
|
82
|
+
}
|
|
38
83
|
//# sourceMappingURL=extract.js.map
|
package/dist/extract.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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,
|
|
1
|
+
{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export type { TocItem, MdxCompileResult } from "./types";
|
|
2
2
|
export { parseMdx, preProcess, postProcess, handleCodeTitles, createDefaultRehypePlugins, createDefaultRemarkPlugins, } from "./compile";
|
|
3
|
-
export { extractFrontmatter, extractTocsFromRawMdx, sluggify } from "./extract";
|
|
3
|
+
export { extractFrontmatter, extractFrontmatterWithContent, extractTocsFromRawMdx, sluggify } from "./extract";
|
|
4
4
|
export type { ParseMdxOptions } from "./compile";
|
|
5
5
|
export { readMdxFileBySlug, parseMdxFile, compileParsedMdxFile, createMdxContentService, } from "./content";
|
|
6
6
|
export type { ReadMdxFileResult, ParsedMdxFile, CompiledMdxFile, CreateMdxContentServiceOptions, } from "./content";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
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,6BAA6B,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/G,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
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
export { parseMdx, preProcess, postProcess, handleCodeTitles, createDefaultRehypePlugins, createDefaultRemarkPlugins, } from "./compile";
|
|
2
|
-
export { extractFrontmatter, extractTocsFromRawMdx, sluggify } from "./extract";
|
|
2
|
+
export { extractFrontmatter, extractFrontmatterWithContent, extractTocsFromRawMdx, sluggify } from "./extract";
|
|
3
3
|
export { readMdxFileBySlug, parseMdxFile, compileParsedMdxFile, createMdxContentService, } from "./content";
|
|
4
4
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
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,6BAA6B,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE/G,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,WAAW,CAAC"}
|