@jk2908/mdsrc 0.1.4 → 0.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/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.0 - 2026-05-21
4
+
5
+ - Breaking: moved markdown customization under the `markdown` key, replacing the old root-level `plugins` option with `markdown.plugins`.
6
+ - Replaced the HTML renderer dependency with `markdown-it-ts` and added `markdown.config` support for renderer options.
7
+ - Re-exported `MarkdownItConfig` from `@jk2908/mdsrc` so consumers can type markdown renderer config without importing from `markdown-it-ts` directly.
8
+ - Updated the README examples to document the nested markdown config and the default renderer options merge.
9
+
10
+ ## 0.2.0 - 2026-05-07
11
+
12
+ - Breaking: replaced the generated `body` field with `html` and `markdown` on every entry.
13
+ - Added markdown rendering through `markdown-it`, with hard line breaks preserved and raw HTML escaped by default.
14
+ - Added root-level `plugins` support for shared markdown-it plugins across every collection.
15
+ - Moved the publishable package into `packages/mdsrc` and updated the examples to consume `@jk2908/mdsrc` like a normal installed package.
16
+ - Fixed generated `.mdsrc` declarations so consumers pick up the `html` and `markdown` fields correctly.
17
+
3
18
  ## 0.1.4 - 2026-04-27
4
19
 
5
20
  - Fixed generated `.mdsrc/index.d.ts` to export collection symbols directly, so root `.mdsrc` imports like `import { allPosts } from '../../.mdsrc'` typecheck correctly.
package/README.md CHANGED
@@ -11,37 +11,69 @@ npm install @jk2908/mdsrc
11
11
  ## Usage
12
12
 
13
13
  ```ts
14
- import plugin from '@jk2908/mdsrc'
14
+ import plugin, { type MarkdownItConfig } from '@jk2908/mdsrc'
15
+ import comark from '@comark/markdown-it'
15
16
  import { defineConfig } from 'vite'
16
17
 
18
+ const markdownItConfig: MarkdownItConfig = {
19
+ linkify: true,
20
+ }
21
+
17
22
  export default defineConfig({
18
23
  plugins: [
19
- plugin([
20
- {
21
- dir: 'content',
22
- name: 'post',
23
- schema: {
24
- title: { type: 'string' },
25
- },
24
+ plugin({
25
+ markdown: {
26
+ plugins: [comark],
27
+ config: markdownItConfig,
26
28
  },
27
- ]),
29
+ collections: [
30
+ {
31
+ dir: 'content',
32
+ name: 'post',
33
+ schema: {
34
+ title: { type: 'string' },
35
+ },
36
+ },
37
+ ],
38
+ }),
28
39
  ],
29
40
  })
30
41
  ```
31
42
 
32
- The plugin reads markdown content, validates frontmatter against your schema, and generates typed modules during build and watch. Collection config currently uses `name`, `dir`, and `schema`.
43
+ The plugin reads markdown content, validates frontmatter against your schema, and generates typed modules during build and watch. Root config uses `collections`, optional `markdown`, and `logger`. Collection config uses `name`, `dir`, and `schema`.
44
+
45
+ Each entry exports both `html` and `markdown`.
46
+
47
+ - `html` is rendered with `markdown-it-ts`, with hard line breaks preserved by default.
48
+ - Raw HTML is escaped by default because the renderer runs with `html: false`.
49
+ - `markdown` preserves the original body for custom renderers like `@comark/react`.
50
+
51
+ Use `markdown.plugins` for `markdown-it-ts` compatible plugins, and `markdown.config` to pass renderer options.
52
+ `MarkdownItConfig` is re-exported from `@jk2908/mdsrc`, and `markdown.config` is merged with the default renderer options `{ html: false, breaks: true }`.
33
53
 
34
- If you configure a collection with `name: 'post'`, the generated module exports `allPosts` from the package root.
54
+ See `examples/basic` for the default HTML output flow and `examples/components` for the shared `@comark/markdown-it` plugin used with React.
55
+
56
+ If you configure a collection with `name: 'post'`, `mdsrc` exposes `allPosts` from the package root.
35
57
 
36
58
  ```ts
37
- import { allPosts } from '.mdsrc'
59
+ import { allPosts } from '@jk2908/mdsrc'
38
60
 
39
61
  export const summaries = allPosts.map(post => ({
40
62
  title: post.title,
41
63
  slug: post.__mdsrc.slug,
64
+ html: post.html,
65
+ markdown: post.markdown,
42
66
  }))
43
67
  ```
44
68
 
69
+ If you want the generated collection module directly, you can also import the collection subpath.
70
+
71
+ ```ts
72
+ import { allPosts } from '@jk2908/mdsrc/post'
73
+ ```
74
+
75
+ The generated files live in `./.mdsrc` on disk, so you can import them directly via paths like `./.mdsrc/index.js`, but `.mdsrc` itself is not a module ID the plugin resolves. The stable import IDs are `@jk2908/mdsrc` and `@jk2908/mdsrc/<collection>`.
76
+
45
77
  ## License
46
78
 
47
79
  MIT
package/dist/index.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type { Plugin } from 'vite';
2
- import type { BuildContext, Collection } from './types.js';
2
+ import type { BuildContext, PluginConfig } from './types.js';
3
+ export type { MarkdownItConfig } from './types.js';
3
4
  /**
4
5
  * Read every markdown file in a collection and turn it into the raw entry shape
5
6
  * add mdsrc metadata like slug and filename alongside the trimmed body
@@ -10,11 +11,12 @@ export declare function create(dir: string, buildContext: BuildContext): Promise
10
11
  slug: string;
11
12
  filename: string;
12
13
  };
13
- body: string;
14
+ html: string;
15
+ markdown: string;
14
16
  }[]>;
15
17
  /**
16
- * Build the vite plugin that validates collections and writes the generated modules
18
+ * Build the Vite plugin that validates collections and writes the generated modules
17
19
  * keep the runtime data and declaration files in the same pass
18
20
  * resolve package imports from the generated directory
19
21
  */
20
- export default function plugin(src: Collection[]): Plugin;
22
+ export default function mdsrc(config: PluginConfig): Plugin;
package/dist/index.js CHANGED
@@ -2,6 +2,7 @@
2
2
  import { realpathSync } from "node:fs";
3
3
  import fs from "node:fs/promises";
4
4
  import path from "node:path";
5
+ import MarkdownIt from "markdown-it-ts";
5
6
 
6
7
  // src/config.ts
7
8
  var NAME = "mdsrc";
@@ -115,6 +116,10 @@ function debounce(fn, wait) {
115
116
 
116
117
  // src/index.ts
117
118
  var fileCache = new Map;
119
+ var DEFAULT_MARKDOWN_CONFIG = {
120
+ html: false,
121
+ breaks: true
122
+ };
118
123
  function toModuleName(name) {
119
124
  return name.toLowerCase();
120
125
  }
@@ -123,7 +128,7 @@ function parse(content) {
123
128
  const match = content.match(regex);
124
129
  const metadata = {};
125
130
  if (!match)
126
- throw new Error("invalid frontmatter");
131
+ throw new Error("Invalid frontmatter");
127
132
  const [, frontmatter, body] = match;
128
133
  if (frontmatter) {
129
134
  for (const line of frontmatter.split(`
@@ -136,6 +141,18 @@ function parse(content) {
136
141
  }
137
142
  async function create(dir, buildContext) {
138
143
  const { logger: logger2 } = buildContext;
144
+ const markdown = new MarkdownIt({
145
+ ...DEFAULT_MARKDOWN_CONFIG,
146
+ ...buildContext.markdown?.config
147
+ });
148
+ for (const plugin of buildContext.markdown?.plugins ?? []) {
149
+ if (typeof plugin === "function" || "default" in plugin) {
150
+ markdown.use(plugin);
151
+ continue;
152
+ }
153
+ const [applyPlugin, ...params] = plugin;
154
+ markdown.use(applyPlugin, ...params);
155
+ }
139
156
  try {
140
157
  const files = (await fs.readdir(dir)).filter((file) => path.extname(file) === ".md");
141
158
  const filePaths = files.map((file) => path.join(dir, file));
@@ -145,14 +162,16 @@ async function create(dir, buildContext) {
145
162
  }
146
163
  return Promise.all(filePaths.map(async (filePath) => {
147
164
  const file = path.basename(filePath);
148
- const { metadata, body } = parse(await fs.readFile(filePath, "utf-8"));
165
+ const parsed = parse(await fs.readFile(filePath, "utf-8"));
166
+ const body = parsed.body ? parsed.body.trim() : "";
149
167
  return {
150
- ...metadata,
168
+ ...parsed.metadata,
151
169
  __mdsrc: {
152
170
  slug: path.basename(file, ".md").toLowerCase().replace(/\s+/g, "-"),
153
171
  filename: file
154
172
  },
155
- body: body.trim()
173
+ html: body ? markdown.render(body).trim() : body,
174
+ markdown: body
156
175
  };
157
176
  }));
158
177
  } catch (err) {
@@ -282,12 +301,13 @@ async function build(src, buildContext) {
282
301
  const raw = await create(path.join(process.cwd(), collection.dir), buildContext);
283
302
  const validated = await Promise.all(raw.map(async (item) => {
284
303
  try {
285
- const { body, __mdsrc, ...metadata } = item;
304
+ const { html, markdown, __mdsrc, ...metadata } = item;
286
305
  const res = validate(metadata, collection.schema);
287
306
  if (res.issues)
288
307
  throw new Error(JSON.stringify(res.issues, null, 2));
289
308
  return {
290
- body,
309
+ html,
310
+ markdown,
291
311
  ...res.value,
292
312
  __mdsrc
293
313
  };
@@ -306,7 +326,8 @@ async function build(src, buildContext) {
306
326
  promises.push(maybeWrite(path.join(outDir, "types.ts"), `
307
327
  ${names.map((name) => `
308
328
  export type ${capitalise(name)} = {
309
- body?: string
329
+ html: string
330
+ markdown: string
310
331
  ${Object.entries(collections[name].schema).map(([key, entry]) => `${key}${entry.optional ? "?" : ""}: ${entry.type === "date" ? "string" : entry.type}`).join(`
311
332
  `)}
312
333
  __mdsrc: {
@@ -350,8 +371,9 @@ async function build(src, buildContext) {
350
371
  }
351
372
  }
352
373
  var normaliseWatchPath = (p) => p.replace(/\\/g, "/");
353
- function plugin(src) {
354
- const logger2 = new Logger("debug");
374
+ function mdsrc(config) {
375
+ const src = config.collections;
376
+ const logger2 = new Logger(config.logger?.level ?? "debug");
355
377
  const outDir = path.join(process.cwd(), GENERATED_DIR);
356
378
  const watchRoot = normaliseWatchPath(realpathSync.native(process.cwd()));
357
379
  const watchedRoots = src.map((c) => `${normaliseWatchPath(path.join(watchRoot, c.dir))}/`);
@@ -368,6 +390,7 @@ function plugin(src) {
368
390
  const isWatchedFile = (filePath) => watchedRoots.some((root) => resolveWatchFile(filePath).startsWith(root));
369
391
  const buildContext = {
370
392
  logger: logger2,
393
+ markdown: config.markdown,
371
394
  outDir,
372
395
  names: []
373
396
  };
@@ -448,8 +471,8 @@ function plugin(src) {
448
471
  };
449
472
  }
450
473
  export {
451
- plugin as default,
474
+ mdsrc as default,
452
475
  create
453
476
  };
454
477
 
455
- //# debugId=C119839BC806C05964756E2164756E21
478
+ //# debugId=99F5D645BFF7D65564756E2164756E21
@@ -0,0 +1,13 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/index.ts", "../src/config.ts", "../src/logger.ts", "../src/utils.ts"],
4
+ "sourcesContent": [
5
+ "import { realpathSync } from 'node:fs'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\n\nimport type { Plugin, ViteDevServer } from 'vite'\n\nimport MarkdownIt from 'markdown-it-ts'\n\nimport type {\n\tBuildContext,\n\tCollection,\n\tEntries,\n\tIssue,\n\tMarkdownItConfig,\n\tPluginConfig,\n\tRaw,\n\tResult,\n\tSchema,\n} from './types.js'\nimport { GENERATED_DIR, PKG_NAME } from './config.js'\nimport { Logger } from './logger.js'\nimport { capitalise, debounce, pluralise } from './utils.js'\n\nconst fileCache = new Map<string, string>()\n\nconst DEFAULT_MARKDOWN_CONFIG = {\n\thtml: false,\n\tbreaks: true,\n} satisfies MarkdownItConfig\n\nexport type { MarkdownItConfig } from './types.js'\n\nfunction toModuleName(name: string) {\n\treturn name.toLowerCase()\n}\n\n/**\n * Split a markdown file into frontmatter data and the body content\n * keep the format small so the parser stays easy to trust\n * fail fast if the opening fence is missing\n */\nfunction parse(content: string) {\n\t// look for one fenced frontmatter block right at the top\n\t// leave the rest of the markdown body alone\n\tconst regex = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---([\\s\\S]*)$/\n\tconst match = content.match(regex)\n\tconst metadata: Entries = {}\n\n\tif (!match) throw new Error('Invalid frontmatter')\n\n\tconst [, frontmatter, body] = match\n\n\tif (frontmatter) {\n\t\t// treat each line as a simple key: value pair\n\t\t// this is a small subset, not full yaml\n\t\tfor (const line of frontmatter.split('\\n')) {\n\t\t\tconst [key, value] = line.split(': ').map(str => str.trim())\n\t\t\tmetadata[key as keyof Entries] = value\n\t\t}\n\t}\n\n\treturn { metadata, body }\n}\n\n/**\n * Read every markdown file in a collection and turn it into the raw entry shape\n * add mdsrc metadata like slug and filename alongside the trimmed body\n * return an empty list if the directory read fails\n */\nexport async function create(dir: string, buildContext: BuildContext) {\n\tconst { logger } = buildContext\n\tconst markdown = new MarkdownIt({\n\t\t...DEFAULT_MARKDOWN_CONFIG,\n\t\t...buildContext.markdown?.config,\n\t})\n\n\tfor (const plugin of buildContext.markdown?.plugins ?? []) {\n\t\tif (typeof plugin === 'function' || 'default' in plugin) {\n\t\t\tmarkdown.use(plugin)\n\t\t\tcontinue\n\t\t}\n\n\t\tconst [applyPlugin, ...params] = plugin\n\t\tmarkdown.use(applyPlugin, ...params)\n\t}\n\n\ttry {\n\t\t// only pick up markdown files from this directory\n\t\t// leave everything else alone\n\t\tconst files = (await fs.readdir(dir)).filter(\n\t\t\t(file: string) => path.extname(file) === '.md',\n\t\t)\n\t\tconst filePaths = files.map(file => path.join(dir, file))\n\n\t\tif (!files.length) {\n\t\t\tconsole.warn(`mdsrc: ${dir} is empty`)\n\t\t\treturn []\n\t\t}\n\n\t\treturn Promise.all(\n\t\t\tfilePaths.map(async filePath => {\n\t\t\t\tconst file = path.basename(filePath)\n\n\t\t\t\t// keep the parsed fields, body, and mdsrc metadata together\n\t\t\t\t// build the slug from the filename\n\t\t\t\tconst parsed = parse(await fs.readFile(filePath, 'utf-8'))\n\n\t\t\t\tconst body = parsed.body ? parsed.body.trim() : ''\n\n\t\t\t\treturn {\n\t\t\t\t\t...parsed.metadata,\n\t\t\t\t\t__mdsrc: {\n\t\t\t\t\t\tslug: path.basename(file, '.md').toLowerCase().replace(/\\s+/g, '-'),\n\t\t\t\t\t\tfilename: file,\n\t\t\t\t\t},\n\t\t\t\t\thtml: body ? markdown.render(body).trim() : body,\n\t\t\t\t\tmarkdown: body,\n\t\t\t\t} satisfies Raw\n\t\t\t}),\n\t\t)\n\t} catch (err) {\n\t\tlogger.error('[create]: failed to create entries', err)\n\t\treturn []\n\t}\n}\n\n/**\n * Write a file only if the content has changed since the last build\n */\nasync function maybeWrite(filePath: string, content: string) {\n\tconst cached = fileCache.get(filePath)\n\n\tif (cached === content) {\n\t\ttry {\n\t\t\tawait fs.access(filePath)\n\t\t\treturn false\n\t\t} catch (err) {\n\t\t\tif (!(err instanceof Error) || !('code' in err) || err.code !== 'ENOENT') {\n\t\t\t\tthrow err\n\t\t\t}\n\n\t\t\t// file was deleted since the last build, fall through and write it again\n\t\t}\n\t}\n\n\tif (cached === undefined) {\n\t\ttry {\n\t\t\tconst current = await fs.readFile(filePath, 'utf-8')\n\t\t\tfileCache.set(filePath, current)\n\n\t\t\tif (current === content) {\n\t\t\t\tfileCache.set(filePath, content)\n\t\t\t\treturn false\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tif (!(err instanceof Error) || !('code' in err) || err.code !== 'ENOENT') {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t}\n\t}\n\n\t// file is new or changed since the last build, write it and refresh the cache\n\tawait fs.writeFile(filePath, content)\n\tfileCache.set(filePath, content)\n\n\treturn true\n}\n\n/**\n * Check one entry against the declared schema and coerce what can be coerced\n * leave missing optional keys alone instead of treating them as errors\n * normalise dates to iso strings for output\n */\nfunction validate(input: Entries, schema: Schema) {\n\t// keep valid values separate so bad fields never sneak into output\n\tconst validated: Entries = {}\n\t// collect every problem so one pass can report the lot\n\tconst issues: Issue[] = []\n\n\t// bail out early if the frontmatter is not even an object\n\tif (typeof input !== 'object' || input === null) {\n\t\tissues.push({ message: 'Input must be an object' })\n\t\treturn { issues } satisfies Result<Entries>\n\t}\n\n\t// drive validation from the schema so the rules always stay in charge\n\tfor (const key in schema) {\n\t\tconst entry = schema[key]\n\n\t\t// if the key is missing, only complain when the schema says it must exist\n\t\tif (!(key in input)) {\n\t\t\tif (!entry.optional) {\n\t\t\t\tissues.push({ message: `Missing required key: ${key}` })\n\t\t\t}\n\n\t\t\tcontinue\n\t\t}\n\n\t\t// once the key exists, coerce it into the shape the schema expects\n\t\tconst value = input[key]\n\n\t\tswitch (entry.type) {\n\t\t\tcase 'string': {\n\t\t\t\t// strings just need the basic type check and any length limits\n\t\t\t\tif (typeof value !== 'string') {\n\t\t\t\t\tissues.push({ message: `Key ${key} must be a string` })\n\t\t\t\t} else {\n\t\t\t\t\tif (entry.minLength && value.length < entry.minLength) {\n\t\t\t\t\t\tissues.push({\n\t\t\t\t\t\t\tmessage: `Key ${key} must be at least ${entry.minLength} characters`,\n\t\t\t\t\t\t})\n\t\t\t\t\t}\n\n\t\t\t\t\tif (entry.maxLength && value.length > entry.maxLength) {\n\t\t\t\t\t\tissues.push({\n\t\t\t\t\t\t\tmessage: `Key ${key} must be at most ${entry.maxLength} characters`,\n\t\t\t\t\t\t})\n\t\t\t\t\t}\n\n\t\t\t\t\tvalidated[key] = value\n\t\t\t\t}\n\n\t\t\t\tbreak\n\t\t\t}\n\t\t\tcase 'number': {\n\t\t\t\tlet num = value\n\n\t\t\t\t// frontmatter usually starts life as text, so numeric strings still count\n\t\t\t\tif (typeof value === 'string' && !Number.isNaN(Number(value))) {\n\t\t\t\t\tnum = Number(value)\n\t\t\t\t}\n\n\t\t\t\tif (typeof num !== 'number') {\n\t\t\t\t\tissues.push({ message: `Key ${key} must be a number` })\n\t\t\t\t} else {\n\t\t\t\t\tvalidated[key] = num\n\t\t\t\t}\n\n\t\t\t\tbreak\n\t\t\t}\n\t\t\tcase 'boolean': {\n\t\t\t\tlet bool = value\n\t\t\t\t// booleans often come through as the words true or false\n\t\t\t\tif (typeof value === 'string') {\n\t\t\t\t\tif (value.toLowerCase() === 'true') {\n\t\t\t\t\t\tbool = true\n\t\t\t\t\t} else if (value.toLowerCase() === 'false') {\n\t\t\t\t\t\tbool = false\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (typeof bool !== 'boolean') {\n\t\t\t\t\tissues.push({ message: `Key ${key} must be a boolean` })\n\t\t\t\t} else {\n\t\t\t\t\tvalidated[key] = bool\n\t\t\t\t}\n\n\t\t\t\tbreak\n\t\t\t}\n\t\t\tcase 'date': {\n\t\t\t\t// keep dates as iso strings because that is what generated output exposes\n\t\t\t\tif (typeof value !== 'string') {\n\t\t\t\t\tissues.push({ message: `Key ${key} must be a date` })\n\t\t\t\t} else {\n\t\t\t\t\tconst date = new Date(value)\n\n\t\t\t\t\tif (Number.isNaN(date.getTime())) {\n\t\t\t\t\t\tissues.push({ message: `Key ${key} must be a valid date` })\n\t\t\t\t\t} else {\n\t\t\t\t\t\tvalidated[key] = date.toISOString()\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tbreak\n\t\t\t}\n\t\t}\n\t}\n\n\t// hand back the clean entry when validation passes\n\t// otherwise return the full issue list\n\treturn (issues.length ? { issues } : { value: validated }) satisfies Result<Entries>\n}\n\nasync function build(src: Collection[], buildContext: BuildContext) {\n\tconst { logger, outDir } = buildContext\n\tlet names: string[] = []\n\n\t// keep each validated collection beside its schema so emit stays in sync\n\tconst collections: Record<\n\t\tstring,\n\t\t{\n\t\t\titems: Raw[]\n\t\t\tschema: Schema\n\t\t}\n\t> = {}\n\n\ttry {\n\t\tif (!outDir) throw new Error('Output directory is not defined')\n\n\t\t// make sure the output directory exists before the writes begin\n\t\t// that way the emit step can stay simple\n\t\tawait fs.mkdir(outDir, { recursive: true })\n\n\t\t// read and validate every collection before writing anything out\n\t\t// this keeps the js and dts outputs in step\n\t\tfor (const collection of src) {\n\t\t\tconst raw = await create(path.join(process.cwd(), collection.dir), buildContext)\n\n\t\t\t// check each raw item before it makes it into the generated collection\n\t\t\t// bad entries get logged and dropped\n\t\t\tconst validated = await Promise.all(\n\t\t\t\traw.map(async item => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst { html, markdown, __mdsrc, ...metadata } = item\n\t\t\t\t\t\tconst res = validate(metadata, collection.schema)\n\n\t\t\t\t\t\tif (res.issues) throw new Error(JSON.stringify(res.issues, null, 2))\n\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\thtml,\n\t\t\t\t\t\t\tmarkdown,\n\t\t\t\t\t\t\t...res.value,\n\t\t\t\t\t\t\t__mdsrc,\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tlogger.error(\n\t\t\t\t\t\t\t`[buildStart]: failed to validate item in ${collection.name}`,\n\t\t\t\t\t\t\terr,\n\t\t\t\t\t\t)\n\t\t\t\t\t\treturn null\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t)\n\n\t\t\tcollections[collection.name] = {\n\t\t\t\t// keep the cleaned items with the schema they came from\n\t\t\t\t// both js and dts generation read from this shape\n\t\t\t\titems: validated.filter(e => e !== null),\n\t\t\t\tschema: collection.schema,\n\t\t\t}\n\t\t}\n\n\t\t// take the collection names after validation has settled\n\t\t// every generated file then works from the same list\n\t\tnames = Object.keys(collections)\n\t\t// queue the file writes first so the emit phase can run together\n\t\t// wait for them once every output is ready\n\t\tconst promises = []\n\n\t\t// build the type file from the schema rather than the observed data\n\t\t// that keeps optional fields and date output honest\n\t\tpromises.push(\n\t\t\tmaybeWrite(\n\t\t\t\tpath.join(outDir, 'types.ts'),\n\t\t\t\t`\n\t\t\t\t\t${names\n\t\t\t\t\t\t// make one named type per collection so the dts mirrors the js surface.\n\t\t\t\t\t\t// html and markdown are always present on generated entries\n\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\tname => `\n\t\t\t\t\t\t\t\texport type ${capitalise(name)} = {\n\t\t\t\t\t\t\t\t\thtml: string\n\t\t\t\t\t\t\t\t\tmarkdown: string\n\t\t\t\t\t\t\t\t\t${Object.entries(collections[name].schema)\n\t\t\t\t\t\t\t\t\t\t// turn each schema field into a ts property line\n\t\t\t\t\t\t\t\t\t\t// keep optional markers and date strings in step with validation\n\t\t\t\t\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\t\t\t\t\t([key, entry]) =>\n\t\t\t\t\t\t\t\t\t\t\t\t`${key}${entry.optional ? '?' : ''}: ${entry.type === 'date' ? 'string' : entry.type}`,\n\t\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t\t\t.join('\\n ')}\n\t\t\t\t\t\t\t\t\t__mdsrc: {\n\t\t\t\t\t\t\t\t\t\tslug: string\n\t\t\t\t\t\t\t\t\t\tfilename: string\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.join('\\n\\n')}`.trim(),\n\t\t\t),\n\t\t)\n\n\t\t// write the package surface separately so consumers get typed named exports\n\t\t// this mirrors the generated js entry file\n\t\tpromises.push(\n\t\t\tmaybeWrite(\n\t\t\t\tpath.join(outDir, 'index.d.ts'),\n\t\t\t\t`\t\n\t\t\t\t\timport type { ${names.map(name => capitalise(name)).join(', ')} } from './types.js'\n\n\t\t\t\t\t${names\n\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\tname => `\n\t\t\t\t\t\t\t\texport const all${capitalise(pluralise(name, 2))}: ${capitalise(name)}[]\n\t\t\t\t\t\t\t`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.join('\\n\\n')}\n\n\t\t\t\t\tdeclare module '${PKG_NAME}' {\n\t\t\t\t\t\t${names\n\t\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\t\tname => `\n\t\t\t\t\t\t\t\t\texport const all${capitalise(pluralise(name, 2))}: ${capitalise(name)}[]\n\t\t\t\t\t\t\t\t`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.join('\\n\\n')}\n\t\t\t\t\t}\n\t\t\t\t`.trim(),\n\t\t\t),\n\t\t)\n\n\t\t// serialise each validated collection as a plain module for Vite to load\n\t\t// empty collections still export a stable array shape\n\t\tfor (const name of names) {\n\t\t\tconst collection = collections[name]?.items\n\t\t\tconst fileName = toModuleName(name)\n\n\t\t\tpromises.push(\n\t\t\t\tmaybeWrite(\n\t\t\t\t\tpath.join(outDir, `${fileName}.js`),\n\t\t\t\t\t`export const all${capitalise(pluralise(name, 2))} = ${collection?.length ? JSON.stringify(collection) : '[]'}`.trim(),\n\t\t\t\t),\n\t\t\t)\n\t\t}\n\n\t\t// stitch the per-collection modules into the public js entrypoint\n\t\t// this is the file the root package import resolves to\n\t\tpromises.push(\n\t\t\tmaybeWrite(\n\t\t\t\tpath.join(outDir, 'index.js'),\n\t\t\t\tnames.map(name => `export * from './${toModuleName(name)}.js'`).join('\\n'),\n\t\t\t),\n\t\t)\n\n\t\t// flush every generated artifact once all the content is ready\n\t\t// let any failed write fail the build\n\t\tconst writes = await Promise.all(promises)\n\t\tbuildContext.names = names\n\n\t\treturn writes.some(changed => changed)\n\t} catch (err) {\n\t\tlogger.error('[build]: failed to generate data', err)\n\t\tthrow err\n\t}\n}\n\n// convert watcher paths to a consistent slash format before comparing them\nconst normaliseWatchPath = (p: string) => p.replace(/\\\\/g, '/')\n\n/**\n * Build the Vite plugin that validates collections and writes the generated modules\n * keep the runtime data and declaration files in the same pass\n * resolve package imports from the generated directory\n */\nexport default function mdsrc(config: PluginConfig): Plugin {\n\tconst src = config.collections\n\n\t// use one logger for the whole build so every step reports the same way\n\t// stay chatty outside production\n\tconst logger = new Logger(\n\t\tconfig.logger?.level ?? (process.env.NODE_ENV === 'production' ? 'error' : 'debug'),\n\t)\n\n\t// write generated files into a hidden folder at the project root\n\t// keep the generated surface out of src\n\tconst outDir = path.join(process.cwd(), GENERATED_DIR)\n\tconst watchRoot = normaliseWatchPath(realpathSync.native(process.cwd()))\n\tconst watchedRoots = src.map(c => `${normaliseWatchPath(path.join(watchRoot, c.dir))}/`)\n\n\t// watcher events can arrive through symlinked paths like /var while cwd has\n\t// already resolved to /private/var, so canonicalise the parent dir once and\n\t// reattach the file name for stable prefix checks\n\tconst resolveWatchFile = (filePath: string) => {\n\t\tconst absolutePath = path.resolve(watchRoot, filePath)\n\t\tconst parentPath = path.dirname(absolutePath)\n\n\t\ttry {\n\t\t\tconst resolvedParentPath = normaliseWatchPath(realpathSync.native(parentPath))\n\t\t\treturn normaliseWatchPath(\n\t\t\t\tpath.join(resolvedParentPath, path.basename(absolutePath)),\n\t\t\t)\n\t\t} catch {\n\t\t\treturn normaliseWatchPath(absolutePath)\n\t\t}\n\t}\n\n\tconst isWatchedFile = (filePath: string) =>\n\t\twatchedRoots.some(root => resolveWatchFile(filePath).startsWith(root))\n\n\t// pass shared build tools into helpers without dragging lots of state around\n\t// keep the helper signatures small\n\tconst buildContext = {\n\t\tlogger,\n\t\tmarkdown: config.markdown,\n\t\toutDir,\n\t\tnames: [],\n\t} satisfies BuildContext\n\n\tlet rebuildRunning = false\n\tlet rebuildQueued = false\n\tlet rebuildReason = 'change'\n\tconst rebuild = debounce((event: string, filePath: string) => {\n\t\tconst queue = () => {\n\t\t\tvoid (async () => {\n\t\t\t\t// collapse bursts of file events into one active rebuild plus a single\n\t\t\t\t// queued rerun when changes land mid-build\n\t\t\t\tif (rebuildRunning) {\n\t\t\t\t\trebuildQueued = true\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\trebuildRunning = true\n\n\t\t\t\tdo {\n\t\t\t\t\trebuildQueued = false\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst changed = await build(src, buildContext)\n\n\t\t\t\t\t\tif (changed) logger.info(`[watch]: content rebuilt (${rebuildReason})`)\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tlogger.error('[watch] content rebuild failed', err)\n\t\t\t\t\t}\n\t\t\t\t} while (rebuildQueued)\n\n\t\t\t\trebuildRunning = false\n\t\t\t})()\n\t\t}\n\n\t\t// ignore anything outside the watched content dirs\n\t\tif (!isWatchedFile(filePath)) return\n\n\t\tconst file = resolveWatchFile(filePath)\n\n\t\trebuildReason = `${event}: ${path.relative(watchRoot, file)}`\n\t\tqueue()\n\t}, 75)\n\n\treturn {\n\t\tname: 'mdsrc',\n\t\tenforce: 'pre',\n\t\tconfig(viteConfig) {\n\t\t\tviteConfig.optimizeDeps ??= {}\n\t\t\tviteConfig.optimizeDeps.exclude = [\n\t\t\t\t...new Set([...(viteConfig.optimizeDeps.exclude ?? []), PKG_NAME]),\n\t\t\t]\n\n\t\t\tviteConfig.resolve ??= {}\n\n\t\t\tif (Array.isArray(viteConfig.resolve.alias)) {\n\t\t\t\tviteConfig.resolve.alias = [\n\t\t\t\t\t...viteConfig.resolve.alias,\n\t\t\t\t\t{\n\t\t\t\t\t\tfind: PKG_NAME,\n\t\t\t\t\t\treplacement: path.join(outDir, 'index.js'),\n\t\t\t\t\t},\n\t\t\t\t]\n\t\t\t} else {\n\t\t\t\tviteConfig.resolve.alias = {\n\t\t\t\t\t...viteConfig.resolve.alias,\n\t\t\t\t\t[PKG_NAME]: path.join(outDir, 'index.js'),\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\tasync buildStart() {\n\t\t\tawait build(src, buildContext)\n\t\t},\n\t\tconfigureServer(server: ViteDevServer) {\n\t\t\tlogger.info(\n\t\t\t\t`[configureServer]: Watching for changes in ./${src.map(c => c.dir).join(', ')}...`,\n\t\t\t)\n\n\t\t\tserver.watcher\n\t\t\t\t.on('add', (p: string) => rebuild('add', p))\n\t\t\t\t.on('change', (p: string) => rebuild('change', p))\n\t\t\t\t.on('unlink', (p: string) => rebuild('unlink', p))\n\t\t},\n\t\tresolveId(id) {\n\t\t\t// point imports at generated files rather than source files\n\t\t\t// that makes the package behave like a normal module\n\t\t\tif (id === PKG_NAME) {\n\t\t\t\treturn path.join(outDir, 'index.js')\n\t\t\t}\n\n\t\t\tif (id.startsWith(`${PKG_NAME}/`)) {\n\t\t\t\t// allow collection subpath imports once the build knows their names\n\t\t\t\t// leave unknown subpaths unresolved\n\t\t\t\tconst subpath = id.slice(PKG_NAME.length + 1)\n\t\t\t\tconst match = buildContext.names.find(\n\t\t\t\t\tname => name === subpath || toModuleName(name) === subpath,\n\t\t\t\t)\n\n\t\t\t\tif (match) {\n\t\t\t\t\treturn path.join(outDir, `${toModuleName(match)}.js`)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn null\n\t\t},\n\t}\n}\n",
6
+ "export const NAME = 'mdsrc'\nexport const PKG_NAME = `@jk2908/${NAME}`\nexport const GENERATED_DIR = `.${NAME}`",
7
+ "import { NAME } from './config.js'\n\nconst LEVELS = {\n\tdebug: 0,\n\tinfo: 1,\n\twarn: 2,\n\terror: 3,\n\tfatal: 4,\n} as const\n\nexport type LogLevel = keyof typeof LEVELS\n\ntype LogEntry = {\n\tts: number\n\tlevel: LogLevel\n\tmessage: string\n\terror?:\n\t\t| Error\n\t\t| {\n\t\t\t\tmessage: string\n\t\t\t\tstack?: string\n\t\t\t\tcause?: unknown\n\t\t }\n}\n\n/**\n * Log messages with different severity levels\n */\nexport class Logger {\n\tstatic #defaultLevel: LogLevel = 'info'\n\n\t#level?: LogLevel\n\n\tconstructor(level?: LogLevel) {\n\t\tthis.#level = level\n\t}\n\n\tstatic set defaultLevel(level: LogLevel) {\n\t\tLogger.#defaultLevel = level\n\t}\n\n\tstatic get defaultLevel() {\n\t\treturn Logger.#defaultLevel\n\t}\n\n\t/**\n\t * Convert a value to an Error instance\n\t */\n\tstatic toError(err: unknown) {\n\t\treturn err instanceof Error ? err : new Error(String(err), { cause: err })\n\t}\n\n\t/**\n\t * Stringify the error for logging\n\t */\n\tstatic print(err: unknown) {\n\t\tif (err instanceof Error) {\n\t\t\treturn err.message + (err.stack ? `\\n${err.stack}` : '')\n\t\t}\n\n\t\t// for plain objects, attempt to stringify with indentation\n\t\t// for readability\n\t\tif (typeof err === 'object' && err !== null) {\n\t\t\ttry {\n\t\t\t\treturn JSON.stringify(err, null, 2)\n\t\t\t} catch {\n\t\t\t\t// if stringify fails (e.g. circular reference), fall back\n\t\t\t\t// to basic string conversion\n\t\t\t\treturn String(err)\n\t\t\t}\n\t\t}\n\n\t\treturn String(err)\n\t}\n\n\tset level(level: LogLevel) {\n\t\tthis.#level = level\n\t}\n\n\tget level() {\n\t\treturn this.#level ?? Logger.#defaultLevel\n\t}\n\n\t/**\n\t * Log a message with a specific level\n\t */\n\tlog(level: LogLevel, message: string, error?: Error) {\n\t\tif (LEVELS[level] < LEVELS[this.level]) return\n\n\t\tconst entry: LogEntry = {\n\t\t\tts: Date.now(),\n\t\t\tlevel,\n\t\t\tmessage,\n\t\t}\n\n\t\tif (level === 'error' || level === 'fatal') {\n\t\t\tentry.error = error ? Logger.toError(error) : new Error(message)\n\t\t}\n\n\t\tconst line = `[${NAME}] [${entry.ts}] [${level.toUpperCase()}] ${message}`\n\t\tconst extra = entry.error ? `\\n${Logger.print(entry.error)}` : ''\n\n\t\tif (level === 'warn') {\n\t\t\tconsole.warn(line, extra)\n\t\t\treturn\n\t\t}\n\n\t\tif (level === 'error' || level === 'fatal') {\n\t\t\tconsole.error(line, extra)\n\t\t\treturn\n\t\t}\n\n\t\tconsole.log(line, extra)\n\t}\n\n\t/**\n\t * Log a debug message\n\t */\n\tdebug(...messages: string[]) {\n\t\tthis.log('debug', messages.join(' '))\n\t}\n\n\t/**\n\t * Log an info message\n\t */\n\tinfo(...messages: string[]) {\n\t\tthis.log('info', messages.join(' '))\n\t}\n\n\t/**\n\t * Log a warning message\n\t */\n\twarn(...messages: string[]) {\n\t\tthis.log('warn', messages.join(' '))\n\t}\n\n\t/**\n\t * Log an error message\n\t */\n\terror(message: string, error?: unknown) {\n\t\tthis.log('error', message, error === undefined ? undefined : Logger.toError(error))\n\t}\n\n\t/**\n\t * Log a fatal error message\n\t */\n\tfatal(message: string, error?: unknown) {\n\t\tthis.log('fatal', message, error === undefined ? undefined : Logger.toError(error))\n\t}\n}\n\nexport const logger = new Logger(\n\tprocess.env.NODE_ENV === 'production' ? 'error' : 'debug',\n)\n",
8
+ "export function capitalise(str: string) {\n\treturn str.charAt(0).toUpperCase() + str.slice(1)\n}\n\nexport function pluralise(str: string, count: number) {\n\treturn count === 1 ? str : str.endsWith('s') ? str : `${str}s`\n}\n\nexport function debounce<T extends unknown[]>(fn: (...args: T) => void, wait: number) {\n\tlet timeoutId: ReturnType<typeof setTimeout> | null = null\n\n\treturn (...args: T) => {\n\t\tif (timeoutId) {\n\t\t\tclearTimeout(timeoutId)\n\t\t}\n\n\t\ttimeoutId = setTimeout(() => {\n\t\t\tfn.apply(null, args)\n\t\t}, wait)\n\t}\n}\n"
9
+ ],
10
+ "mappings": "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",
11
+ "debugId": "99F5D645BFF7D65564756E2164756E21",
12
+ "names": []
13
+ }
package/dist/types.d.ts CHANGED
@@ -1,11 +1,26 @@
1
+ import type { MarkdownIt, MarkdownItOptions } from 'markdown-it-ts';
1
2
  import type { LogLevel, Logger } from './logger.js';
3
+ type MarkdownItUseArgs = Parameters<MarkdownIt['use']>;
4
+ export type MarkdownItConfig = MarkdownItOptions;
5
+ export type MarkdownPlugin = MarkdownItUseArgs[0];
6
+ export type MarkdownPluginUse = MarkdownPlugin | readonly [
7
+ plugin: MarkdownPlugin,
8
+ ...params: MarkdownItUseArgs extends [unknown, ...infer Params] ? Params : never
9
+ ];
10
+ export type MarkdownConfig = {
11
+ plugins?: MarkdownPluginUse[];
12
+ config?: MarkdownItConfig;
13
+ };
2
14
  export type PluginConfig = {
15
+ collections: Collection[];
3
16
  logger?: {
4
17
  level?: LogLevel;
5
18
  };
19
+ markdown?: MarkdownConfig;
6
20
  };
7
21
  export type BuildContext = {
8
22
  logger: InstanceType<typeof Logger>;
23
+ markdown?: MarkdownConfig;
9
24
  outDir?: string;
10
25
  names?: string[];
11
26
  };
@@ -27,7 +42,8 @@ export type Raw = {
27
42
  slug: string;
28
43
  filename: string;
29
44
  };
30
- body?: string;
45
+ html: string;
46
+ markdown: string;
31
47
  } & Entries;
32
48
  export type Types = Record<string, string>;
33
49
  export type Issue = {
@@ -42,3 +58,4 @@ export type Success<Output> = {
42
58
  readonly types?: Record<string, string>;
43
59
  };
44
60
  export type Result<Output> = Success<Output> | Fail;
61
+ export {};
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "name": "@jk2908/mdsrc",
3
- "version": "0.1.4",
3
+ "version": "0.3.0",
4
4
  "type": "module",
5
5
  "author": "Jerome Kenway",
6
+ "description": "A Vite plugin for turning structured Markdown content into importable, type-safe modules",
6
7
  "repository": {
7
8
  "type": "git",
8
9
  "url": "git+https://github.com/jk2908/mdsrc.git"
@@ -11,18 +12,13 @@
11
12
  "types": "./dist/index.d.ts",
12
13
  "scripts": {
13
14
  "build": "bun run ./build.ts && bun x tsc --project tsconfig.json --emitDeclarationOnly",
14
- "test": "bun test"
15
+ "test": "cd ../.. && bun test"
15
16
  },
16
- "devDependencies": {
17
- "@types/bun": "^1.3.13",
18
- "@typescript/native-preview": "^7.0.0-dev.20260421.2",
19
- "@types/node": "^24.0.1",
20
- "oxfmt": "^0.35.0",
21
- "oxlint": "^1.50.0",
22
- "vite": "^5.4.2"
17
+ "dependencies": {
18
+ "markdown-it-ts": "^1.0.0"
23
19
  },
24
20
  "peerDependencies": {
25
- "vite": "^4.0.0"
21
+ "vite": "^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
26
22
  },
27
23
  "publishConfig": {
28
24
  "access": "public"
@@ -36,11 +32,11 @@
36
32
  "bugs": {
37
33
  "url": "https://github.com/jk2908/mdsrc/issues"
38
34
  },
39
- "description": "A Vite plugin for managing markdown content with type safety",
40
35
  "files": [
41
- "dist/*.js",
42
- "dist/*.d.ts",
43
- "CHANGELOG.md"
36
+ "dist",
37
+ "README.md",
38
+ "CHANGELOG.md",
39
+ "LICENSE"
44
40
  ],
45
41
  "homepage": "https://github.com/jk2908/mdsrc#readme",
46
42
  "keywords": [
@@ -51,4 +47,4 @@
51
47
  "frontmatter"
52
48
  ],
53
49
  "license": "MIT"
54
- }
50
+ }