@prudentbird/voxx-core 1.0.0

package/dist/content.cjs

@@ -0,0 +1,147 @@
+const require_errors = require("./errors.cjs");
+const require_frontmatter = require("./frontmatter.cjs");
+const require_render = require("./render.cjs");
+const require_util = require("./util.cjs");
+let effect = require("effect");
+let _effect_platform = require("@effect/platform");
+//#region src/content.ts
+const MD_RE = /\.md$/;
+const orderKey = (order, slug) => `${String(order ?? 9999).padStart(4, "0")} ${slug}`;
+const buildPost = (config, absPath, rel) => effect.Effect.gen(function* () {
+	const fs = yield* _effect_platform.FileSystem.FileSystem;
+	const { data, content } = yield* require_frontmatter.parseFrontmatter(rel, yield* fs.readFileString(absPath));
+	const isDocs = config.content.type === "docs";
+	const isChangelog = config.content.type === "changelog";
+	const segments = rel.replace(MD_RE, "").split(/[\\/]/).filter(Boolean);
+	const fileBase = segments.pop() ?? rel;
+	const dirOrders = [];
+	const dirSlugs = segments.map((seg) => {
+		const { order, rest } = isDocs ? require_util.splitOrderPrefix(seg) : {
+			order: void 0,
+			rest: seg
+		};
+		dirOrders.push(order);
+		return require_util.slugify(rest);
+	});
+	const { date: filenameDate, rest: dateRest } = require_util.splitDatePrefix(fileBase);
+	const { order: fileOrder, rest } = isDocs ? require_util.splitOrderPrefix(dateRest) : {
+		order: void 0,
+		rest: dateRest
+	};
+	const baseSlug = data.slug ? require_util.slugify(data.slug) : require_util.slugify(rest);
+	const isIndex = isDocs && !data.slug && baseSlug === "index";
+	const path = isDocs ? isIndex ? dirSlugs : [...dirSlugs, baseSlug] : [baseSlug];
+	const slug = path[path.length - 1] ?? "";
+	const order = data.order ?? fileOrder ?? (isIndex ? dirOrders[dirOrders.length - 1] : void 0);
+	const version = isChangelog ? data.version ?? require_util.parseVersion(dateRest) : data.version;
+	const baseUrl = require_util.joinPath(config.content.basePath, "/").replace(/(.)\/+$/, "$1");
+	const urlPath = path.join("/");
+	const url = isChangelog ? `${baseUrl}#${slug}` : urlPath ? require_util.joinPath(config.content.basePath, urlPath) : baseUrl;
+	const levelKeys = dirSlugs.map((s, i) => orderKey(dirOrders[i], s));
+	if (isIndex) {
+		if (levelKeys.length > 0) levelKeys[levelKeys.length - 1] = orderKey(order, slug);
+	} else levelKeys.push(orderKey(order, slug));
+	const sortKey = levelKeys.join("/");
+	const dirRel = rel.split(/[\\/]/).slice(0, -1).join("/");
+	const { html, toc } = yield* require_render.renderMarkdownEffect(content, config, { assetBase: dirRel ? require_util.joinPath(config.content.basePath, dirRel) : config.content.basePath });
+	let date = data.date ?? filenameDate;
+	if (!date) {
+		if (!isDocs) yield* effect.Effect.logWarning(`${rel}: no date in frontmatter or filename — falling back to the file's creation time, which is not stable across checkouts.`);
+		const info = yield* fs.stat(absPath);
+		date = (effect.Option.getOrUndefined(info.birthtime) ?? effect.Option.getOrUndefined(info.mtime) ?? /* @__PURE__ */ new Date()).toISOString();
+	}
+	return {
+		post: {
+			slug,
+			path,
+			url,
+			title: data.title,
+			description: data.description,
+			date,
+			updated: data.updated,
+			tags: [...data.tags],
+			category: data.category,
+			order,
+			version,
+			draft: data.draft,
+			image: data.image,
+			author: data.author,
+			excerpt: data.excerpt ?? require_util.deriveExcerpt(content),
+			readingTimeMinutes: require_util.readingTimeMinutes(content),
+			html,
+			toc,
+			content
+		},
+		sortKey
+	};
+});
+/**
+* Reads all Markdown files from the configured content directory,
+* renders them, and returns sorted posts.
+*
+* - **docs** — sorted by numeric directory/file order prefix.
+* - **changelog** — sorted by date descending, then semver descending.
+* - **blog** — sorted by date descending.
+*
+* @param config - Resolved Voxx config.
+* @param opts - Optional collection filter and draft visibility.
+*/
+const getPostsEffect = (config, opts = {}) => effect.Effect.gen(function* () {
+	if (opts.collection) {
+		const active = config.collections?.find((c) => c.name === opts.collection);
+		if (!active) return yield* new require_errors.ConfigError({ message: `Unknown collection "${opts.collection}" — defined: ${(config.collections ?? []).map((c) => c.name).join(", ")}` });
+		config = {
+			...config,
+			content: active
+		};
+	}
+	const fs = yield* _effect_platform.FileSystem.FileSystem;
+	const path = yield* _effect_platform.Path.Path;
+	const dir = config.content.dir;
+	if (!(yield* fs.exists(dir).pipe(effect.Effect.orElseSucceed(() => false)))) return yield* new require_errors.ContentDirMissing({ dir });
+	const files = (yield* fs.readDirectory(dir, { recursive: true })).filter((f) => MD_RE.test(f));
+	const includeDrafts = opts.includeDrafts ?? config.content.drafts;
+	const built = yield* effect.Effect.forEach(files, (rel) => buildPost(config, path.join(dir, rel), rel), { concurrency: 8 });
+	const seen = /* @__PURE__ */ new Map();
+	for (let i = 0; i < built.length; i++) {
+		const key = built[i].post.path.join("/");
+		const previous = seen.get(key);
+		if (previous !== void 0) yield* effect.Effect.logWarning(`Duplicate slug "${key}": ${files[i]} collides with ${previous} — only one will be reachable.`);
+		else seen.set(key, files[i]);
+	}
+	const visible = built.filter((b) => includeDrafts || !b.post.draft);
+	if (config.content.type === "docs") return visible.sort((a, b) => a.sortKey.localeCompare(b.sortKey)).map((b) => b.post);
+	const isChangelog = config.content.type === "changelog";
+	return visible.map((b) => b.post).sort((a, b) => {
+		const byDate = b.date.localeCompare(a.date);
+		if (byDate !== 0) return byDate;
+		if (isChangelog && a.version && b.version) return require_util.compareVersions(b.version, a.version);
+		return a.slug.localeCompare(b.slug);
+	});
+});
+/**
+* Finds a post in an already-loaded array by slug or path.
+*
+* @param posts - Array returned by `getPosts`.
+* @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+* @returns The matching post, or `undefined` if not found.
+*/
+function findPost(posts, slug) {
+	const wanted = slug.split("/").filter(Boolean).map(require_util.slugify).join("/");
+	return posts.find((p) => p.path.join("/") === wanted || p.path.length <= 1 && p.slug === wanted);
+}
+/**
+* Loads all posts and returns the one matching `slug`.
+* Throws `PostNotFound` if no match exists.
+*/
+const getPostEffect = (config, slug, opts = {}) => effect.Effect.gen(function* () {
+	const post = findPost(yield* getPostsEffect(config, opts), slug);
+	if (!post) return yield* new require_errors.PostNotFound({ slug });
+	return post;
+});
+//#endregion
+exports.findPost = findPost;
+exports.getPostEffect = getPostEffect;
+exports.getPostsEffect = getPostsEffect;
+
+//# sourceMappingURL=content.cjs.map

package/dist/content.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.cjs","names":["Effect","FileSystem","parseFrontmatter","splitOrderPrefix","slugify","splitDatePrefix","parseVersion","joinPath","renderMarkdownEffect","Option","deriveExcerpt","readingTimeMinutes","ConfigError","Path","ContentDirMissing","compareVersions","PostNotFound"],"sources":["../src/content.ts"],"sourcesContent":["import { Effect, Option } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { parseFrontmatter } from \"./frontmatter\";\nimport { renderMarkdownEffect } from \"./render\";\nimport { ConfigError, ContentDirMissing, PostNotFound } from \"./errors\";\nimport {\n  compareVersions,\n  deriveExcerpt,\n  joinPath,\n  parseVersion,\n  readingTimeMinutes,\n  slugify,\n  splitDatePrefix,\n  splitOrderPrefix,\n} from \"./util\";\nimport type { Post, VoxxConfig } from \"./types\";\n\nconst MD_RE = /\\.md$/;\n\n/** Options for filtering posts returned by `getPostsEffect`. */\nexport interface GetPostsEffectOptions {\n  /** When `true`, includes posts whose frontmatter sets `draft: true`. */\n  includeDrafts?: boolean;\n  /** Restricts results to a named collection defined in `config.collections`. */\n  collection?: string;\n}\nconst orderKey = (order: number | undefined, slug: string) =>\n  `${String(order ?? 9999).padStart(4, \"0\")} ${slug}`;\n\ninterface BuiltPost {\n  post: Post;\n  sortKey: string;\n}\n\nconst buildPost = (config: VoxxConfig, absPath: string, rel: string) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const raw = yield* fs.readFileString(absPath);\n    const { data, content } = yield* parseFrontmatter(rel, raw);\n    const isDocs = config.content.type === \"docs\";\n    const isChangelog = config.content.type === \"changelog\";\n\n    const segments = rel.replace(MD_RE, \"\").split(/[\\\\/]/).filter(Boolean);\n    const fileBase = segments.pop() ?? rel;\n\n    const dirOrders: Array<number | undefined> = [];\n    const dirSlugs = segments.map((seg) => {\n      const { order, rest } = isDocs\n        ? splitOrderPrefix(seg)\n        : { order: undefined, rest: seg };\n      dirOrders.push(order);\n      return slugify(rest);\n    });\n\n    const { date: filenameDate, rest: dateRest } = splitDatePrefix(fileBase);\n    const { order: fileOrder, rest } = isDocs\n      ? splitOrderPrefix(dateRest)\n      : { order: undefined, rest: dateRest };\n    const baseSlug = data.slug ? slugify(data.slug) : slugify(rest);\n\n    const isIndex = isDocs && !data.slug && baseSlug === \"index\";\n    const path = isDocs\n      ? isIndex\n        ? dirSlugs\n        : [...dirSlugs, baseSlug]\n      : [baseSlug];\n    const slug = path[path.length - 1] ?? \"\";\n    const order =\n      data.order ??\n      fileOrder ??\n      (isIndex ? dirOrders[dirOrders.length - 1] : undefined);\n\n    const version = isChangelog\n      ? (data.version ?? parseVersion(dateRest))\n      : data.version;\n\n    const baseUrl = joinPath(config.content.basePath, \"/\").replace(\n      /(.)\\/+$/,\n      \"$1\",\n    );\n    const urlPath = path.join(\"/\");\n    const url = isChangelog\n      ? `${baseUrl}#${slug}`\n      : urlPath\n        ? joinPath(config.content.basePath, urlPath)\n        : baseUrl;\n\n    const levelKeys = dirSlugs.map((s, i) => orderKey(dirOrders[i], s));\n    if (isIndex) {\n      if (levelKeys.length > 0)\n        levelKeys[levelKeys.length - 1] = orderKey(order, slug);\n    } else {\n      levelKeys.push(orderKey(order, slug));\n    }\n    const sortKey = levelKeys.join(\"/\");\n\n    const dirRel = rel.split(/[\\\\/]/).slice(0, -1).join(\"/\");\n    const assetBase = dirRel\n      ? joinPath(config.content.basePath, dirRel)\n      : config.content.basePath;\n    const { html, toc } = yield* renderMarkdownEffect(content, config, {\n      assetBase,\n    });\n\n    let date = data.date ?? filenameDate;\n    if (!date) {\n      if (!isDocs) {\n        yield* Effect.logWarning(\n          `${rel}: no date in frontmatter or filename — falling back to the file's creation time, which is not stable across checkouts.`,\n        );\n      }\n      const info = yield* fs.stat(absPath);\n      const created =\n        Option.getOrUndefined(info.birthtime) ??\n        Option.getOrUndefined(info.mtime);\n      date = (created ?? new Date()).toISOString();\n    }\n\n    const post: Post = {\n      slug,\n      path,\n      url,\n      title: data.title,\n      description: data.description,\n      date,\n      updated: data.updated,\n      tags: [...data.tags],\n      category: data.category,\n      order,\n      version,\n      draft: data.draft,\n      image: data.image,\n      author: data.author,\n      excerpt: data.excerpt ?? deriveExcerpt(content),\n      readingTimeMinutes: readingTimeMinutes(content),\n      html,\n      toc,\n      content,\n    };\n    return { post, sortKey } satisfies BuiltPost;\n  });\n\n/**\n * Reads all Markdown files from the configured content directory,\n * renders them, and returns sorted posts.\n *\n * - **docs** — sorted by numeric directory/file order prefix.\n * - **changelog** — sorted by date descending, then semver descending.\n * - **blog** — sorted by date descending.\n *\n * @param config - Resolved Voxx config.\n * @param opts - Optional collection filter and draft visibility.\n */\nexport const getPostsEffect = (\n  config: VoxxConfig,\n  opts: GetPostsEffectOptions = {},\n) =>\n  Effect.gen(function* () {\n    if (opts.collection) {\n      const active = config.collections?.find(\n        (c) => c.name === opts.collection,\n      );\n      if (!active) {\n        return yield* new ConfigError({\n          message: `Unknown collection \"${opts.collection}\" — defined: ${(\n            config.collections ?? []\n          )\n            .map((c) => c.name)\n            .join(\", \")}`,\n        });\n      }\n      config = { ...config, content: active };\n    }\n\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const dir = config.content.dir;\n\n    const exists = yield* fs\n      .exists(dir)\n      .pipe(Effect.orElseSucceed(() => false));\n    if (!exists) return yield* new ContentDirMissing({ dir });\n\n    const entries = yield* fs.readDirectory(dir, { recursive: true });\n    const files = entries.filter((f) => MD_RE.test(f));\n    const includeDrafts = opts.includeDrafts ?? config.content.drafts;\n\n    const built = yield* Effect.forEach(\n      files,\n      (rel) => buildPost(config, path.join(dir, rel), rel),\n      { concurrency: 8 },\n    );\n\n    const seen = new Map<string, string>();\n    for (let i = 0; i < built.length; i++) {\n      const key = built[i]!.post.path.join(\"/\");\n      const previous = seen.get(key);\n      if (previous !== undefined) {\n        yield* Effect.logWarning(\n          `Duplicate slug \"${key}\": ${files[i]} collides with ${previous} — only one will be reachable.`,\n        );\n      } else {\n        seen.set(key, files[i]!);\n      }\n    }\n\n    const visible = built.filter((b) => includeDrafts || !b.post.draft);\n\n    if (config.content.type === \"docs\") {\n      return visible\n        .sort((a, b) => a.sortKey.localeCompare(b.sortKey))\n        .map((b) => b.post);\n    }\n\n    const isChangelog = config.content.type === \"changelog\";\n\n    return visible\n      .map((b) => b.post)\n      .sort((a, b) => {\n        const byDate = b.date.localeCompare(a.date);\n        if (byDate !== 0) return byDate;\n        if (isChangelog && a.version && b.version) {\n          return compareVersions(b.version, a.version);\n        }\n        return a.slug.localeCompare(b.slug);\n      });\n  });\n\n/**\n * Finds a post in an already-loaded array by slug or path.\n *\n * @param posts - Array returned by `getPosts`.\n * @param slug - Slash-separated path, e.g. `\"getting-started/install\"`.\n * @returns The matching post, or `undefined` if not found.\n */\nexport function findPost(posts: Post[], slug: string): Post | undefined {\n  const wanted = slug.split(\"/\").filter(Boolean).map(slugify).join(\"/\");\n  return posts.find(\n    (p) =>\n      p.path.join(\"/\") === wanted || (p.path.length <= 1 && p.slug === wanted),\n  );\n}\n\n/**\n * Loads all posts and returns the one matching `slug`.\n * Throws `PostNotFound` if no match exists.\n */\nexport const getPostEffect = (\n  config: VoxxConfig,\n  slug: string,\n  opts: GetPostsEffectOptions = {},\n) =>\n  Effect.gen(function* () {\n    const posts = yield* getPostsEffect(config, opts);\n    const post = findPost(posts, slug);\n    if (!post) return yield* new PostNotFound({ slug });\n    return post;\n  });\n"],"mappings":"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"}

package/dist/content.d.cts

@@ -0,0 +1,41 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError } from "./errors.cjs";
+import { Post, VoxxConfig } from "./types.cjs";
+import { Effect } from "effect";
+import { FileSystem, Path } from "@effect/platform";
+
+//#region src/content.d.ts
+/** Options for filtering posts returned by `getPostsEffect`. */
+interface GetPostsEffectOptions {
+  /** When `true`, includes posts whose frontmatter sets `draft: true`. */
+  includeDrafts?: boolean;
+  /** Restricts results to a named collection defined in `config.collections`. */
+  collection?: string;
+}
+/**
+ * Reads all Markdown files from the configured content directory,
+ * renders them, and returns sorted posts.
+ *
+ * - **docs** — sorted by numeric directory/file order prefix.
+ * - **changelog** — sorted by date descending, then semver descending.
+ * - **blog** — sorted by date descending.
+ *
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional collection filter and draft visibility.
+ */
+declare const getPostsEffect: (config: VoxxConfig, opts?: GetPostsEffectOptions) => Effect.Effect<Post[], ConfigError | InvalidFrontmatter | ContentDirMissing | RenderError | import("@effect/platform/Error").PlatformError, Path.Path | FileSystem.FileSystem>;
+/**
+ * Finds a post in an already-loaded array by slug or path.
+ *
+ * @param posts - Array returned by `getPosts`.
+ * @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+ * @returns The matching post, or `undefined` if not found.
+ */
+declare function findPost(posts: Post[], slug: string): Post | undefined;
+/**
+ * Loads all posts and returns the one matching `slug`.
+ * Throws `PostNotFound` if no match exists.
+ */
+declare const getPostEffect: (config: VoxxConfig, slug: string, opts?: GetPostsEffectOptions) => Effect.Effect<Post, ConfigError | InvalidFrontmatter | PostNotFound | ContentDirMissing | RenderError | import("@effect/platform/Error").PlatformError, Path.Path | FileSystem.FileSystem>;
+//#endregion
+export { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect };
+//# sourceMappingURL=content.d.cts.map

package/dist/content.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.cts","names":[],"sources":["../src/content.ts"],"mappings":";;;;;;;UAoBiB,qBAAA;EAAA;EAEf,aAAA;;EAEA,UAAU;AAAA;AAiIZ;;;;;;;;;;;AAAA,cAAa,cAAA,GACX,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,qBAAA,KAA0B,MAAA,CAAA,MAAA,CAAA,IAAA,IAAA,WAAA,GAAA,kBAAA,GAAA,iBAAA,GAAA,WAAA,oCAAA,aAAA,EAAA,IAAA,CAAA,IAAA,GAAA,UAAA,CAAA,UAAA;;;;;;;;iBAgFlB,QAAA,CAAS,KAAA,EAAO,IAAA,IAAQ,IAAA,WAAe,IAAI;;;;;cAY9C,aAAA,GACX,MAAA,EAAQ,UAAA,EACR,IAAA,UACA,IAAA,GAAM,qBAAA,KAA0B,MAAA,CAAA,MAAA,CAAA,IAAA,EAAA,WAAA,GAAA,kBAAA,GAAA,YAAA,GAAA,iBAAA,GAAA,WAAA,oCAAA,aAAA,EAAA,IAAA,CAAA,IAAA,GAAA,UAAA,CAAA,UAAA"}

package/dist/content.d.mts

@@ -0,0 +1,41 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError } from "./errors.mjs";
+import { Post, VoxxConfig } from "./types.mjs";
+import { Effect } from "effect";
+import { FileSystem, Path } from "@effect/platform";
+
+//#region src/content.d.ts
+/** Options for filtering posts returned by `getPostsEffect`. */
+interface GetPostsEffectOptions {
+  /** When `true`, includes posts whose frontmatter sets `draft: true`. */
+  includeDrafts?: boolean;
+  /** Restricts results to a named collection defined in `config.collections`. */
+  collection?: string;
+}
+/**
+ * Reads all Markdown files from the configured content directory,
+ * renders them, and returns sorted posts.
+ *
+ * - **docs** — sorted by numeric directory/file order prefix.
+ * - **changelog** — sorted by date descending, then semver descending.
+ * - **blog** — sorted by date descending.
+ *
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional collection filter and draft visibility.
+ */
+declare const getPostsEffect: (config: VoxxConfig, opts?: GetPostsEffectOptions) => Effect.Effect<Post[], ConfigError | InvalidFrontmatter | ContentDirMissing | RenderError | import("@effect/platform/Error").PlatformError, Path.Path | FileSystem.FileSystem>;
+/**
+ * Finds a post in an already-loaded array by slug or path.
+ *
+ * @param posts - Array returned by `getPosts`.
+ * @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+ * @returns The matching post, or `undefined` if not found.
+ */
+declare function findPost(posts: Post[], slug: string): Post | undefined;
+/**
+ * Loads all posts and returns the one matching `slug`.
+ * Throws `PostNotFound` if no match exists.
+ */
+declare const getPostEffect: (config: VoxxConfig, slug: string, opts?: GetPostsEffectOptions) => Effect.Effect<Post, ConfigError | InvalidFrontmatter | PostNotFound | ContentDirMissing | RenderError | import("@effect/platform/Error").PlatformError, Path.Path | FileSystem.FileSystem>;
+//#endregion
+export { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect };
+//# sourceMappingURL=content.d.mts.map

package/dist/content.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.mts","names":[],"sources":["../src/content.ts"],"mappings":";;;;;;;UAoBiB,qBAAA;EAAA;EAEf,aAAA;;EAEA,UAAU;AAAA;AAiIZ;;;;;;;;;;;AAAA,cAAa,cAAA,GACX,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,qBAAA,KAA0B,MAAA,CAAA,MAAA,CAAA,IAAA,IAAA,WAAA,GAAA,kBAAA,GAAA,iBAAA,GAAA,WAAA,oCAAA,aAAA,EAAA,IAAA,CAAA,IAAA,GAAA,UAAA,CAAA,UAAA;;;;;;;;iBAgFlB,QAAA,CAAS,KAAA,EAAO,IAAA,IAAQ,IAAA,WAAe,IAAI;;;;;cAY9C,aAAA,GACX,MAAA,EAAQ,UAAA,EACR,IAAA,UACA,IAAA,GAAM,qBAAA,KAA0B,MAAA,CAAA,MAAA,CAAA,IAAA,EAAA,WAAA,GAAA,kBAAA,GAAA,YAAA,GAAA,iBAAA,GAAA,WAAA,oCAAA,aAAA,EAAA,IAAA,CAAA,IAAA,GAAA,UAAA,CAAA,UAAA"}

package/dist/content.mjs

@@ -0,0 +1,145 @@
+import { ConfigError, ContentDirMissing, PostNotFound } from "./errors.mjs";
+import { parseFrontmatter } from "./frontmatter.mjs";
+import { renderMarkdownEffect } from "./render.mjs";
+import { compareVersions, deriveExcerpt, joinPath, parseVersion, readingTimeMinutes, slugify, splitDatePrefix, splitOrderPrefix } from "./util.mjs";
+import { Effect, Option } from "effect";
+import { FileSystem, Path } from "@effect/platform";
+//#region src/content.ts
+const MD_RE = /\.md$/;
+const orderKey = (order, slug) => `${String(order ?? 9999).padStart(4, "0")} ${slug}`;
+const buildPost = (config, absPath, rel) => Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const { data, content } = yield* parseFrontmatter(rel, yield* fs.readFileString(absPath));
+	const isDocs = config.content.type === "docs";
+	const isChangelog = config.content.type === "changelog";
+	const segments = rel.replace(MD_RE, "").split(/[\\/]/).filter(Boolean);
+	const fileBase = segments.pop() ?? rel;
+	const dirOrders = [];
+	const dirSlugs = segments.map((seg) => {
+		const { order, rest } = isDocs ? splitOrderPrefix(seg) : {
+			order: void 0,
+			rest: seg
+		};
+		dirOrders.push(order);
+		return slugify(rest);
+	});
+	const { date: filenameDate, rest: dateRest } = splitDatePrefix(fileBase);
+	const { order: fileOrder, rest } = isDocs ? splitOrderPrefix(dateRest) : {
+		order: void 0,
+		rest: dateRest
+	};
+	const baseSlug = data.slug ? slugify(data.slug) : slugify(rest);
+	const isIndex = isDocs && !data.slug && baseSlug === "index";
+	const path = isDocs ? isIndex ? dirSlugs : [...dirSlugs, baseSlug] : [baseSlug];
+	const slug = path[path.length - 1] ?? "";
+	const order = data.order ?? fileOrder ?? (isIndex ? dirOrders[dirOrders.length - 1] : void 0);
+	const version = isChangelog ? data.version ?? parseVersion(dateRest) : data.version;
+	const baseUrl = joinPath(config.content.basePath, "/").replace(/(.)\/+$/, "$1");
+	const urlPath = path.join("/");
+	const url = isChangelog ? `${baseUrl}#${slug}` : urlPath ? joinPath(config.content.basePath, urlPath) : baseUrl;
+	const levelKeys = dirSlugs.map((s, i) => orderKey(dirOrders[i], s));
+	if (isIndex) {
+		if (levelKeys.length > 0) levelKeys[levelKeys.length - 1] = orderKey(order, slug);
+	} else levelKeys.push(orderKey(order, slug));
+	const sortKey = levelKeys.join("/");
+	const dirRel = rel.split(/[\\/]/).slice(0, -1).join("/");
+	const { html, toc } = yield* renderMarkdownEffect(content, config, { assetBase: dirRel ? joinPath(config.content.basePath, dirRel) : config.content.basePath });
+	let date = data.date ?? filenameDate;
+	if (!date) {
+		if (!isDocs) yield* Effect.logWarning(`${rel}: no date in frontmatter or filename — falling back to the file's creation time, which is not stable across checkouts.`);
+		const info = yield* fs.stat(absPath);
+		date = (Option.getOrUndefined(info.birthtime) ?? Option.getOrUndefined(info.mtime) ?? /* @__PURE__ */ new Date()).toISOString();
+	}
+	return {
+		post: {
+			slug,
+			path,
+			url,
+			title: data.title,
+			description: data.description,
+			date,
+			updated: data.updated,
+			tags: [...data.tags],
+			category: data.category,
+			order,
+			version,
+			draft: data.draft,
+			image: data.image,
+			author: data.author,
+			excerpt: data.excerpt ?? deriveExcerpt(content),
+			readingTimeMinutes: readingTimeMinutes(content),
+			html,
+			toc,
+			content
+		},
+		sortKey
+	};
+});
+/**
+* Reads all Markdown files from the configured content directory,
+* renders them, and returns sorted posts.
+*
+* - **docs** — sorted by numeric directory/file order prefix.
+* - **changelog** — sorted by date descending, then semver descending.
+* - **blog** — sorted by date descending.
+*
+* @param config - Resolved Voxx config.
+* @param opts - Optional collection filter and draft visibility.
+*/
+const getPostsEffect = (config, opts = {}) => Effect.gen(function* () {
+	if (opts.collection) {
+		const active = config.collections?.find((c) => c.name === opts.collection);
+		if (!active) return yield* new ConfigError({ message: `Unknown collection "${opts.collection}" — defined: ${(config.collections ?? []).map((c) => c.name).join(", ")}` });
+		config = {
+			...config,
+			content: active
+		};
+	}
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const dir = config.content.dir;
+	if (!(yield* fs.exists(dir).pipe(Effect.orElseSucceed(() => false)))) return yield* new ContentDirMissing({ dir });
+	const files = (yield* fs.readDirectory(dir, { recursive: true })).filter((f) => MD_RE.test(f));
+	const includeDrafts = opts.includeDrafts ?? config.content.drafts;
+	const built = yield* Effect.forEach(files, (rel) => buildPost(config, path.join(dir, rel), rel), { concurrency: 8 });
+	const seen = /* @__PURE__ */ new Map();
+	for (let i = 0; i < built.length; i++) {
+		const key = built[i].post.path.join("/");
+		const previous = seen.get(key);
+		if (previous !== void 0) yield* Effect.logWarning(`Duplicate slug "${key}": ${files[i]} collides with ${previous} — only one will be reachable.`);
+		else seen.set(key, files[i]);
+	}
+	const visible = built.filter((b) => includeDrafts || !b.post.draft);
+	if (config.content.type === "docs") return visible.sort((a, b) => a.sortKey.localeCompare(b.sortKey)).map((b) => b.post);
+	const isChangelog = config.content.type === "changelog";
+	return visible.map((b) => b.post).sort((a, b) => {
+		const byDate = b.date.localeCompare(a.date);
+		if (byDate !== 0) return byDate;
+		if (isChangelog && a.version && b.version) return compareVersions(b.version, a.version);
+		return a.slug.localeCompare(b.slug);
+	});
+});
+/**
+* Finds a post in an already-loaded array by slug or path.
+*
+* @param posts - Array returned by `getPosts`.
+* @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+* @returns The matching post, or `undefined` if not found.
+*/
+function findPost(posts, slug) {
+	const wanted = slug.split("/").filter(Boolean).map(slugify).join("/");
+	return posts.find((p) => p.path.join("/") === wanted || p.path.length <= 1 && p.slug === wanted);
+}
+/**
+* Loads all posts and returns the one matching `slug`.
+* Throws `PostNotFound` if no match exists.
+*/
+const getPostEffect = (config, slug, opts = {}) => Effect.gen(function* () {
+	const post = findPost(yield* getPostsEffect(config, opts), slug);
+	if (!post) return yield* new PostNotFound({ slug });
+	return post;
+});
+//#endregion
+export { findPost, getPostEffect, getPostsEffect };
+
+//# sourceMappingURL=content.mjs.map

package/dist/content.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.mjs","names":[],"sources":["../src/content.ts"],"sourcesContent":["import { Effect, Option } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { parseFrontmatter } from \"./frontmatter\";\nimport { renderMarkdownEffect } from \"./render\";\nimport { ConfigError, ContentDirMissing, PostNotFound } from \"./errors\";\nimport {\n  compareVersions,\n  deriveExcerpt,\n  joinPath,\n  parseVersion,\n  readingTimeMinutes,\n  slugify,\n  splitDatePrefix,\n  splitOrderPrefix,\n} from \"./util\";\nimport type { Post, VoxxConfig } from \"./types\";\n\nconst MD_RE = /\\.md$/;\n\n/** Options for filtering posts returned by `getPostsEffect`. */\nexport interface GetPostsEffectOptions {\n  /** When `true`, includes posts whose frontmatter sets `draft: true`. */\n  includeDrafts?: boolean;\n  /** Restricts results to a named collection defined in `config.collections`. */\n  collection?: string;\n}\nconst orderKey = (order: number | undefined, slug: string) =>\n  `${String(order ?? 9999).padStart(4, \"0\")} ${slug}`;\n\ninterface BuiltPost {\n  post: Post;\n  sortKey: string;\n}\n\nconst buildPost = (config: VoxxConfig, absPath: string, rel: string) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const raw = yield* fs.readFileString(absPath);\n    const { data, content } = yield* parseFrontmatter(rel, raw);\n    const isDocs = config.content.type === \"docs\";\n    const isChangelog = config.content.type === \"changelog\";\n\n    const segments = rel.replace(MD_RE, \"\").split(/[\\\\/]/).filter(Boolean);\n    const fileBase = segments.pop() ?? rel;\n\n    const dirOrders: Array<number | undefined> = [];\n    const dirSlugs = segments.map((seg) => {\n      const { order, rest } = isDocs\n        ? splitOrderPrefix(seg)\n        : { order: undefined, rest: seg };\n      dirOrders.push(order);\n      return slugify(rest);\n    });\n\n    const { date: filenameDate, rest: dateRest } = splitDatePrefix(fileBase);\n    const { order: fileOrder, rest } = isDocs\n      ? splitOrderPrefix(dateRest)\n      : { order: undefined, rest: dateRest };\n    const baseSlug = data.slug ? slugify(data.slug) : slugify(rest);\n\n    const isIndex = isDocs && !data.slug && baseSlug === \"index\";\n    const path = isDocs\n      ? isIndex\n        ? dirSlugs\n        : [...dirSlugs, baseSlug]\n      : [baseSlug];\n    const slug = path[path.length - 1] ?? \"\";\n    const order =\n      data.order ??\n      fileOrder ??\n      (isIndex ? dirOrders[dirOrders.length - 1] : undefined);\n\n    const version = isChangelog\n      ? (data.version ?? parseVersion(dateRest))\n      : data.version;\n\n    const baseUrl = joinPath(config.content.basePath, \"/\").replace(\n      /(.)\\/+$/,\n      \"$1\",\n    );\n    const urlPath = path.join(\"/\");\n    const url = isChangelog\n      ? `${baseUrl}#${slug}`\n      : urlPath\n        ? joinPath(config.content.basePath, urlPath)\n        : baseUrl;\n\n    const levelKeys = dirSlugs.map((s, i) => orderKey(dirOrders[i], s));\n    if (isIndex) {\n      if (levelKeys.length > 0)\n        levelKeys[levelKeys.length - 1] = orderKey(order, slug);\n    } else {\n      levelKeys.push(orderKey(order, slug));\n    }\n    const sortKey = levelKeys.join(\"/\");\n\n    const dirRel = rel.split(/[\\\\/]/).slice(0, -1).join(\"/\");\n    const assetBase = dirRel\n      ? joinPath(config.content.basePath, dirRel)\n      : config.content.basePath;\n    const { html, toc } = yield* renderMarkdownEffect(content, config, {\n      assetBase,\n    });\n\n    let date = data.date ?? filenameDate;\n    if (!date) {\n      if (!isDocs) {\n        yield* Effect.logWarning(\n          `${rel}: no date in frontmatter or filename — falling back to the file's creation time, which is not stable across checkouts.`,\n        );\n      }\n      const info = yield* fs.stat(absPath);\n      const created =\n        Option.getOrUndefined(info.birthtime) ??\n        Option.getOrUndefined(info.mtime);\n      date = (created ?? new Date()).toISOString();\n    }\n\n    const post: Post = {\n      slug,\n      path,\n      url,\n      title: data.title,\n      description: data.description,\n      date,\n      updated: data.updated,\n      tags: [...data.tags],\n      category: data.category,\n      order,\n      version,\n      draft: data.draft,\n      image: data.image,\n      author: data.author,\n      excerpt: data.excerpt ?? deriveExcerpt(content),\n      readingTimeMinutes: readingTimeMinutes(content),\n      html,\n      toc,\n      content,\n    };\n    return { post, sortKey } satisfies BuiltPost;\n  });\n\n/**\n * Reads all Markdown files from the configured content directory,\n * renders them, and returns sorted posts.\n *\n * - **docs** — sorted by numeric directory/file order prefix.\n * - **changelog** — sorted by date descending, then semver descending.\n * - **blog** — sorted by date descending.\n *\n * @param config - Resolved Voxx config.\n * @param opts - Optional collection filter and draft visibility.\n */\nexport const getPostsEffect = (\n  config: VoxxConfig,\n  opts: GetPostsEffectOptions = {},\n) =>\n  Effect.gen(function* () {\n    if (opts.collection) {\n      const active = config.collections?.find(\n        (c) => c.name === opts.collection,\n      );\n      if (!active) {\n        return yield* new ConfigError({\n          message: `Unknown collection \"${opts.collection}\" — defined: ${(\n            config.collections ?? []\n          )\n            .map((c) => c.name)\n            .join(\", \")}`,\n        });\n      }\n      config = { ...config, content: active };\n    }\n\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const dir = config.content.dir;\n\n    const exists = yield* fs\n      .exists(dir)\n      .pipe(Effect.orElseSucceed(() => false));\n    if (!exists) return yield* new ContentDirMissing({ dir });\n\n    const entries = yield* fs.readDirectory(dir, { recursive: true });\n    const files = entries.filter((f) => MD_RE.test(f));\n    const includeDrafts = opts.includeDrafts ?? config.content.drafts;\n\n    const built = yield* Effect.forEach(\n      files,\n      (rel) => buildPost(config, path.join(dir, rel), rel),\n      { concurrency: 8 },\n    );\n\n    const seen = new Map<string, string>();\n    for (let i = 0; i < built.length; i++) {\n      const key = built[i]!.post.path.join(\"/\");\n      const previous = seen.get(key);\n      if (previous !== undefined) {\n        yield* Effect.logWarning(\n          `Duplicate slug \"${key}\": ${files[i]} collides with ${previous} — only one will be reachable.`,\n        );\n      } else {\n        seen.set(key, files[i]!);\n      }\n    }\n\n    const visible = built.filter((b) => includeDrafts || !b.post.draft);\n\n    if (config.content.type === \"docs\") {\n      return visible\n        .sort((a, b) => a.sortKey.localeCompare(b.sortKey))\n        .map((b) => b.post);\n    }\n\n    const isChangelog = config.content.type === \"changelog\";\n\n    return visible\n      .map((b) => b.post)\n      .sort((a, b) => {\n        const byDate = b.date.localeCompare(a.date);\n        if (byDate !== 0) return byDate;\n        if (isChangelog && a.version && b.version) {\n          return compareVersions(b.version, a.version);\n        }\n        return a.slug.localeCompare(b.slug);\n      });\n  });\n\n/**\n * Finds a post in an already-loaded array by slug or path.\n *\n * @param posts - Array returned by `getPosts`.\n * @param slug - Slash-separated path, e.g. `\"getting-started/install\"`.\n * @returns The matching post, or `undefined` if not found.\n */\nexport function findPost(posts: Post[], slug: string): Post | undefined {\n  const wanted = slug.split(\"/\").filter(Boolean).map(slugify).join(\"/\");\n  return posts.find(\n    (p) =>\n      p.path.join(\"/\") === wanted || (p.path.length <= 1 && p.slug === wanted),\n  );\n}\n\n/**\n * Loads all posts and returns the one matching `slug`.\n * Throws `PostNotFound` if no match exists.\n */\nexport const getPostEffect = (\n  config: VoxxConfig,\n  slug: string,\n  opts: GetPostsEffectOptions = {},\n) =>\n  Effect.gen(function* () {\n    const posts = yield* getPostsEffect(config, opts);\n    const post = findPost(posts, slug);\n    if (!post) return yield* new PostNotFound({ slug });\n    return post;\n  });\n"],"mappings":"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"}

package/dist/dev.cjs

@@ -0,0 +1,82 @@
+const require_config = require("./config.cjs");
+let effect = require("effect");
+let _effect_platform_node = require("@effect/platform-node");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+//#region src/dev.ts
+const run = (effect$1) => effect.Effect.runPromise(effect.Effect.provide(effect$1, _effect_platform_node.NodeContext.layer));
+const SKIP_DIRS = new Set([
+	"node_modules",
+	".next",
+	".git",
+	".turbo",
+	"dist",
+	"out"
+]);
+const VERSION_FILE = "content-version.ts";
+function writeVersion(file, value) {
+	(0, node_fs.mkdirSync)((0, node_path.dirname)(file), { recursive: true });
+	(0, node_fs.writeFileSync)(file, `export const CONTENT_VERSION = ${value};\n`);
+}
+function findVersionModules(root, depth = 6) {
+	const found = [];
+	const walk = (dir, left) => {
+		let entries;
+		try {
+			entries = (0, node_fs.readdirSync)(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) if (entry.isDirectory()) {
+			if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+			if (left > 0) walk((0, node_path.join)(dir, entry.name), left - 1);
+		} else if (entry.name === VERSION_FILE && (0, node_path.basename)(dir) === "_voxx") found.push((0, node_path.join)(dir, entry.name));
+	};
+	walk(root, depth);
+	return found;
+}
+let registered = false;
+/**
+* Watches content directories and `voxx.json` for changes, then bumps a
+* `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`
+* file to trigger Next.js hot reload.
+*
+* No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).
+* Safe to call multiple times — only the first call registers watchers.
+*
+* @param opts - Optional cwd, explicit version module paths, and debounce delay.
+*/
+async function registerContentWatcher(opts = {}) {
+	if (process.env["NEXT_RUNTIME"] && process.env["NEXT_RUNTIME"] !== "nodejs") return;
+	if (process.env.NODE_ENV !== "development") return;
+	if (registered) return;
+	registered = true;
+	const cwd = opts.cwd ?? process.cwd();
+	const versionModules = opts.versionModules && opts.versionModules.length > 0 ? opts.versionModules : findVersionModules(cwd);
+	if (versionModules.length === 0) return;
+	const dirs = /* @__PURE__ */ new Set();
+	try {
+		const config = await run(require_config.loadConfigEffect({ cwd }));
+		for (const collection of config.collections) dirs.add(collection.dir);
+	} catch {}
+	const paths = new Set([(0, node_path.join)(cwd, "voxx.json"), ...dirs]);
+	let timer;
+	const bump = () => {
+		clearTimeout(timer);
+		timer = setTimeout(() => {
+			const value = Date.now();
+			for (const file of versionModules) writeVersion(file, value);
+		}, opts.debounceMs ?? 80);
+	};
+	const watchers = [];
+	for (const path of paths) {
+		if (!(0, node_fs.existsSync)(path)) continue;
+		try {
+			watchers.push((0, node_fs.watch)(path, { recursive: true }, bump));
+		} catch {}
+	}
+}
+//#endregion
+exports.registerContentWatcher = registerContentWatcher;
+
+//# sourceMappingURL=dev.cjs.map

package/dist/dev.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.cjs","names":["Effect","effect","NodeContext","loadConfigEffect"],"sources":["../src/dev.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  watch,\n  writeFileSync,\n  type Dirent,\n  type FSWatcher,\n} from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport { Effect } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { NodeContext } from \"@effect/platform-node\";\nimport { loadConfigEffect } from \"./config\";\n\ntype Services = FileSystem.FileSystem | Path.Path;\n\nconst run = <A, E>(effect: Effect.Effect<A, E, Services>): Promise<A> =>\n  Effect.runPromise(Effect.provide(effect, NodeContext.layer));\n\n/** Options for `registerContentWatcher`. */\nexport interface ContentWatcherOptions {\n  /** Working directory used to locate `voxx.json` and content dirs. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit paths to `content-version.ts` files to bump on change. Auto-discovered when omitted. */\n  versionModules?: string[];\n  /** Milliseconds to wait before writing after the last change event. Defaults to `80`. */\n  debounceMs?: number;\n}\n\nconst SKIP_DIRS = new Set([\n  \"node_modules\",\n  \".next\",\n  \".git\",\n  \".turbo\",\n  \"dist\",\n  \"out\",\n]);\nconst VERSION_FILE = \"content-version.ts\";\n\nfunction writeVersion(file: string, value: number): void {\n  mkdirSync(dirname(file), { recursive: true });\n  writeFileSync(file, `export const CONTENT_VERSION = ${value};\\n`);\n}\n\nfunction findVersionModules(root: string, depth = 6): string[] {\n  const found: string[] = [];\n  const walk = (dir: string, left: number): void => {\n    let entries: Dirent<string>[];\n    try {\n      entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(\".\")) continue;\n        if (left > 0) walk(join(dir, entry.name), left - 1);\n      } else if (entry.name === VERSION_FILE && basename(dir) === \"_voxx\") {\n        found.push(join(dir, entry.name));\n      }\n    }\n  };\n  walk(root, depth);\n  return found;\n}\n\nlet registered = false;\n\n/**\n * Watches content directories and `voxx.json` for changes, then bumps a\n * `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`\n * file to trigger Next.js hot reload.\n *\n * No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).\n * Safe to call multiple times — only the first call registers watchers.\n *\n * @param opts - Optional cwd, explicit version module paths, and debounce delay.\n */\nexport async function registerContentWatcher(\n  opts: ContentWatcherOptions = {},\n): Promise<void> {\n  if (process.env[\"NEXT_RUNTIME\"] && process.env[\"NEXT_RUNTIME\"] !== \"nodejs\") {\n    return;\n  }\n  if (process.env.NODE_ENV !== \"development\") return;\n  if (registered) return;\n  registered = true;\n\n  const cwd = opts.cwd ?? process.cwd();\n\n  const versionModules =\n    opts.versionModules && opts.versionModules.length > 0\n      ? opts.versionModules\n      : findVersionModules(cwd);\n  if (versionModules.length === 0) return;\n\n  const dirs = new Set<string>();\n  try {\n    const config = await run(loadConfigEffect({ cwd }));\n    for (const collection of config.collections) dirs.add(collection.dir);\n  } catch {}\n\n  const paths = new Set<string>([join(cwd, \"voxx.json\"), ...dirs]);\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const bump = () => {\n    clearTimeout(timer);\n    timer = setTimeout(() => {\n      const value = Date.now();\n      for (const file of versionModules) writeVersion(file, value);\n    }, opts.debounceMs ?? 80);\n  };\n\n  const watchers: FSWatcher[] = [];\n  for (const path of paths) {\n    if (!existsSync(path)) continue;\n    try {\n      watchers.push(watch(path, { recursive: true }, bump));\n    } catch {}\n  }\n}\n"],"mappings":";;;;;;AAiBA,MAAM,OAAa,aACjBA,OAAAA,OAAO,WAAWA,OAAAA,OAAO,QAAQC,UAAQC,sBAAAA,YAAY,KAAK,CAAC;AAY7D,MAAM,YAAY,IAAI,IAAI;CACxB;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,MAAM,eAAe;AAErB,SAAS,aAAa,MAAc,OAAqB;CACvD,CAAA,GAAA,QAAA,UAAA,EAAA,GAAA,UAAA,QAAA,CAAkB,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;CAC5C,CAAA,GAAA,QAAA,cAAA,CAAc,MAAM,kCAAkC,MAAM,IAAI;AAClE;AAEA,SAAS,mBAAmB,MAAc,QAAQ,GAAa;CAC7D,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAQ,KAAa,SAAuB;EAChD,IAAI;EACJ,IAAI;GACF,WAAA,GAAA,QAAA,YAAA,CAAsB,KAAK,EAAE,eAAe,KAAK,CAAC;EACpD,QAAQ;GACN;EACF;EACA,KAAK,MAAM,SAAS,SAClB,IAAI,MAAM,YAAY,GAAG;GACvB,IAAI,UAAU,IAAI,MAAM,IAAI,KAAK,MAAM,KAAK,WAAW,GAAG,GAAG;GAC7D,IAAI,OAAO,GAAG,MAAA,GAAA,UAAA,KAAA,CAAU,KAAK,MAAM,IAAI,GAAG,OAAO,CAAC;EACpD,OAAO,IAAI,MAAM,SAAS,iBAAA,GAAA,UAAA,SAAA,CAAyB,GAAG,MAAM,SAC1D,MAAM,MAAA,GAAA,UAAA,KAAA,CAAU,KAAK,MAAM,IAAI,CAAC;CAGtC;CACA,KAAK,MAAM,KAAK;CAChB,OAAO;AACT;AAEA,IAAI,aAAa;;;;;;;;;;;AAYjB,eAAsB,uBACpB,OAA8B,CAAC,GAChB;CACf,IAAI,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,oBAAoB,UACjE;CAEF,IAAI,QAAQ,IAAI,aAAa,eAAe;CAC5C,IAAI,YAAY;CAChB,aAAa;CAEb,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI;CAEpC,MAAM,iBACJ,KAAK,kBAAkB,KAAK,eAAe,SAAS,IAChD,KAAK,iBACL,mBAAmB,GAAG;CAC5B,IAAI,eAAe,WAAW,GAAG;CAEjC,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI;EACF,MAAM,SAAS,MAAM,IAAIC,eAAAA,iBAAiB,EAAE,IAAI,CAAC,CAAC;EAClD,KAAK,MAAM,cAAc,OAAO,aAAa,KAAK,IAAI,WAAW,GAAG;CACtE,QAAQ,CAAC;CAET,MAAM,QAAQ,IAAI,IAAY,EAAA,GAAA,UAAA,KAAA,CAAM,KAAK,WAAW,GAAG,GAAG,IAAI,CAAC;CAE/D,IAAI;CACJ,MAAM,aAAa;EACjB,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,QAAQ,KAAK,IAAI;GACvB,KAAK,MAAM,QAAQ,gBAAgB,aAAa,MAAM,KAAK;EAC7D,GAAG,KAAK,cAAc,EAAE;CAC1B;CAEA,MAAM,WAAwB,CAAC;CAC/B,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,EAAA,GAAA,QAAA,WAAA,CAAY,IAAI,GAAG;EACvB,IAAI;GACF,SAAS,MAAA,GAAA,QAAA,MAAA,CAAW,MAAM,EAAE,WAAW,KAAK,GAAG,IAAI,CAAC;EACtD,QAAQ,CAAC;CACX;AACF"}

package/dist/dev.d.cts

@@ -0,0 +1,24 @@
+//#region src/dev.d.ts
+/** Options for `registerContentWatcher`. */
+interface ContentWatcherOptions {
+  /** Working directory used to locate `voxx.json` and content dirs. Defaults to `process.cwd()`. */
+  cwd?: string;
+  /** Explicit paths to `content-version.ts` files to bump on change. Auto-discovered when omitted. */
+  versionModules?: string[];
+  /** Milliseconds to wait before writing after the last change event. Defaults to `80`. */
+  debounceMs?: number;
+}
+/**
+ * Watches content directories and `voxx.json` for changes, then bumps a
+ * `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`
+ * file to trigger Next.js hot reload.
+ *
+ * No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).
+ * Safe to call multiple times — only the first call registers watchers.
+ *
+ * @param opts - Optional cwd, explicit version module paths, and debounce delay.
+ */
+declare function registerContentWatcher(opts?: ContentWatcherOptions): Promise<void>;
+//#endregion
+export { ContentWatcherOptions, registerContentWatcher };
+//# sourceMappingURL=dev.d.cts.map

package/dist/dev.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.cts","names":[],"sources":["../src/dev.ts"],"mappings":";;UAqBiB,qBAAA;EAAqB;EAEpC,GAAA;EAFoC;EAIpC,cAAA;EAAA;EAEA,UAAA;AAAA;AAAU;AAoDZ;;;;;;;;AAEU;AAtDE,iBAoDU,sBAAA,CACpB,IAAA,GAAM,qBAAA,GACL,OAAO"}

package/dist/dev.d.mts

@@ -0,0 +1,24 @@
+//#region src/dev.d.ts
+/** Options for `registerContentWatcher`. */
+interface ContentWatcherOptions {
+  /** Working directory used to locate `voxx.json` and content dirs. Defaults to `process.cwd()`. */
+  cwd?: string;
+  /** Explicit paths to `content-version.ts` files to bump on change. Auto-discovered when omitted. */
+  versionModules?: string[];
+  /** Milliseconds to wait before writing after the last change event. Defaults to `80`. */
+  debounceMs?: number;
+}
+/**
+ * Watches content directories and `voxx.json` for changes, then bumps a
+ * `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`
+ * file to trigger Next.js hot reload.
+ *
+ * No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).
+ * Safe to call multiple times — only the first call registers watchers.
+ *
+ * @param opts - Optional cwd, explicit version module paths, and debounce delay.
+ */
+declare function registerContentWatcher(opts?: ContentWatcherOptions): Promise<void>;
+//#endregion
+export { ContentWatcherOptions, registerContentWatcher };
+//# sourceMappingURL=dev.d.mts.map

package/dist/dev.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.mts","names":[],"sources":["../src/dev.ts"],"mappings":";;UAqBiB,qBAAA;EAAqB;EAEpC,GAAA;EAFoC;EAIpC,cAAA;EAAA;EAEA,UAAA;AAAA;AAAU;AAoDZ;;;;;;;;AAEU;AAtDE,iBAoDU,sBAAA,CACpB,IAAA,GAAM,qBAAA,GACL,OAAO"}