@prudentbird/voxx-core 1.1.0 → 1.2.0

package/dist/config.d.cts

@@ -118,7 +118,7 @@ declare const loadConfigEffect: (opts?: LoadConfigOptions) => Effect.Effect<{
     jsonLd: boolean;
     defaultImage: string | null;
   };
-}, ConfigError, Path.Path | FileSystem.FileSystem>;
+}, ConfigError, FileSystem.FileSystem | Path.Path>;
 //#endregion
 export { CollectionInput, LoadConfigOptions, loadConfigEffect, resolveCollectionDefaults, resolveConfig };
 //# sourceMappingURL=config.d.cts.map

package/dist/config.d.mts

@@ -118,7 +118,7 @@ declare const loadConfigEffect: (opts?: LoadConfigOptions) => Effect.Effect<{
     jsonLd: boolean;
     defaultImage: string | null;
   };
-}, ConfigError, Path.Path | FileSystem.FileSystem>;
+}, ConfigError, FileSystem.FileSystem | Path.Path>;
 //#endregion
 export { CollectionInput, LoadConfigOptions, loadConfigEffect, resolveCollectionDefaults, resolveConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/content.d.cts

@@ -22,7 +22,7 @@ interface GetPostsEffectOptions {
  * @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>;
+declare const getPostsEffect: (config: VoxxConfig, opts?: GetPostsEffectOptions) => Effect.Effect<Post[], ConfigError | ContentDirMissing | import("@effect/platform/Error").PlatformError | InvalidFrontmatter | RenderError, FileSystem.FileSystem | Path.Path>;
 /**
  * Finds a post in an already-loaded array by slug or path.
  *
@@ -35,7 +35,7 @@ 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>;
+declare const getPostEffect: (config: VoxxConfig, slug: string, opts?: GetPostsEffectOptions) => Effect.Effect<Post, ConfigError | ContentDirMissing | import("@effect/platform/Error").PlatformError | InvalidFrontmatter | RenderError | PostNotFound, FileSystem.FileSystem | Path.Path>;
 //#endregion
 export { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect };
 //# sourceMappingURL=content.d.cts.map

package/dist/content.d.cts.map

@@ -1 +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"}
+{"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,iBAAA,oCAAA,aAAA,GAAA,kBAAA,GAAA,WAAA,EAAA,UAAA,CAAA,UAAA,GAAA,IAAA,CAAA,IAAA;;;;;;;;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,iBAAA,oCAAA,aAAA,GAAA,kBAAA,GAAA,WAAA,GAAA,YAAA,EAAA,UAAA,CAAA,UAAA,GAAA,IAAA,CAAA,IAAA"}

package/dist/content.d.mts

@@ -22,7 +22,7 @@ interface GetPostsEffectOptions {
  * @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>;
+declare const getPostsEffect: (config: VoxxConfig, opts?: GetPostsEffectOptions) => Effect.Effect<Post[], ConfigError | ContentDirMissing | import("@effect/platform/Error").PlatformError | InvalidFrontmatter | RenderError, FileSystem.FileSystem | Path.Path>;
 /**
  * Finds a post in an already-loaded array by slug or path.
  *
@@ -35,7 +35,7 @@ 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>;
+declare const getPostEffect: (config: VoxxConfig, slug: string, opts?: GetPostsEffectOptions) => Effect.Effect<Post, ConfigError | ContentDirMissing | import("@effect/platform/Error").PlatformError | InvalidFrontmatter | RenderError | PostNotFound, FileSystem.FileSystem | Path.Path>;
 //#endregion
 export { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect };
 //# sourceMappingURL=content.d.mts.map

package/dist/content.d.mts.map

@@ -1 +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"}
+{"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,iBAAA,oCAAA,aAAA,GAAA,kBAAA,GAAA,WAAA,EAAA,UAAA,CAAA,UAAA,GAAA,IAAA,CAAA,IAAA;;;;;;;;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,iBAAA,oCAAA,aAAA,GAAA,kBAAA,GAAA,WAAA,GAAA,YAAA,EAAA,UAAA,CAAA,UAAA,GAAA,IAAA,CAAA,IAAA"}

package/dist/frontmatter.d.cts

@@ -9,6 +9,7 @@ interface ParsedFile {
 }
 declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
   data: {
+    readonly order?: number | undefined;
     readonly title: string;
     readonly description?: string | undefined;
     readonly date?: string | undefined;
@@ -16,7 +17,6 @@ declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
     readonly slug?: string | undefined;
     readonly tags: readonly string[];
     readonly category?: string | undefined;
-    readonly order?: number | undefined;
     readonly version?: string | undefined;
     readonly draft: boolean;
     readonly image?: string | undefined;

package/dist/frontmatter.d.mts

@@ -9,6 +9,7 @@ interface ParsedFile {
 }
 declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
   data: {
+    readonly order?: number | undefined;
     readonly title: string;
     readonly description?: string | undefined;
     readonly date?: string | undefined;
@@ -16,7 +17,6 @@ declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
     readonly slug?: string | undefined;
     readonly tags: readonly string[];
     readonly category?: string | undefined;
-    readonly order?: number | undefined;
     readonly version?: string | undefined;
     readonly draft: boolean;
     readonly image?: string | undefined;

package/dist/next.cjs

@@ -0,0 +1,54 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+//#region src/next.ts
+const CORE_PACKAGE = "@prudentbird/voxx-core";
+const DEFAULT_CONTENT_DIR = "content";
+/**
+* Reads the relative content directories declared in `voxx.json`, falling back
+* to the default `content` directory when the file is missing or unreadable.
+*/
+function contentDirs(cwd) {
+	try {
+		const data = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(cwd, "voxx.json"), "utf8"));
+		const dirs = /* @__PURE__ */ new Set();
+		for (const c of data.collections ?? []) dirs.add(c.dir ?? `${DEFAULT_CONTENT_DIR}/${c.name ?? c.type ?? "blog"}`);
+		if (data.content?.dir) dirs.add(data.content.dir);
+		return dirs.size > 0 ? [...dirs] : [DEFAULT_CONTENT_DIR];
+	} catch {
+		return [DEFAULT_CONTENT_DIR];
+	}
+}
+/**
+* Wraps a Next.js config with the settings every Voxx app needs to run
+* correctly on serverless platforms.
+*
+* Enables Cache Components, marks `@prudentbird/voxx-core` as an external
+* server package, and traces `voxx.json` plus every content directory into the
+* serverless function bundle so runtime config and content reads resolve. Voxx
+* content is filesystem-backed and read at request time during cache
+* revalidation, so without these includes those reads fail on platforms that
+* bundle each route into an isolated function.
+*
+* @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.
+* @param options - Optional `cwd` override for locating `voxx.json`.
+* @returns The base config merged with Voxx's required settings.
+*/
+function withVoxx(config = {}, options = {}) {
+	const base = config;
+	const includes = ["./voxx.json", ...contentDirs(options.cwd ?? process.cwd()).map((dir) => `./${dir}/**/*`)];
+	const existing = base.outputFileTracingIncludes ?? {};
+	return {
+		...base,
+		cacheComponents: base.cacheComponents ?? true,
+		serverExternalPackages: [...new Set([...base.serverExternalPackages ?? [], CORE_PACKAGE])],
+		outputFileTracingIncludes: {
+			...existing,
+			"/*": [...new Set([...existing["/*"] ?? [], ...includes])]
+		}
+	};
+}
+//#endregion
+exports.withVoxx = withVoxx;
+
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.cjs","names":[],"sources":["../src/next.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CORE_PACKAGE = \"@prudentbird/voxx-core\";\nconst DEFAULT_CONTENT_DIR = \"content\";\n\n/** Options for {@link withVoxx}. */\nexport interface WithVoxxOptions {\n  /** Directory containing `voxx.json`. Defaults to `process.cwd()`. */\n  cwd?: string;\n}\n\n/** The Next.js config fields {@link withVoxx} manages; all other fields pass through unchanged. */\ninterface ManagedConfig {\n  cacheComponents?: boolean;\n  serverExternalPackages?: string[];\n  outputFileTracingIncludes?: Record<string, string[]>;\n}\n\ninterface RawCollection {\n  name?: string;\n  type?: string;\n  dir?: string;\n}\n\ninterface RawConfig {\n  content?: { dir?: string; type?: string };\n  collections?: RawCollection[];\n}\n\n/**\n * Reads the relative content directories declared in `voxx.json`, falling back\n * to the default `content` directory when the file is missing or unreadable.\n */\nfunction contentDirs(cwd: string): string[] {\n  try {\n    const data = JSON.parse(\n      readFileSync(join(cwd, \"voxx.json\"), \"utf8\"),\n    ) as RawConfig;\n    const dirs = new Set<string>();\n    for (const c of data.collections ?? []) {\n      dirs.add(c.dir ?? `${DEFAULT_CONTENT_DIR}/${c.name ?? c.type ?? \"blog\"}`);\n    }\n    if (data.content?.dir) dirs.add(data.content.dir);\n    return dirs.size > 0 ? [...dirs] : [DEFAULT_CONTENT_DIR];\n  } catch {\n    return [DEFAULT_CONTENT_DIR];\n  }\n}\n\n/**\n * Wraps a Next.js config with the settings every Voxx app needs to run\n * correctly on serverless platforms.\n *\n * Enables Cache Components, marks `@prudentbird/voxx-core` as an external\n * server package, and traces `voxx.json` plus every content directory into the\n * serverless function bundle so runtime config and content reads resolve. Voxx\n * content is filesystem-backed and read at request time during cache\n * revalidation, so without these includes those reads fail on platforms that\n * bundle each route into an isolated function.\n *\n * @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.\n * @param options - Optional `cwd` override for locating `voxx.json`.\n * @returns The base config merged with Voxx's required settings.\n */\nexport function withVoxx<T extends object>(\n  config: T = {} as T,\n  options: WithVoxxOptions = {},\n): T & {\n  cacheComponents: boolean;\n  serverExternalPackages: string[];\n  outputFileTracingIncludes: Record<string, string[]>;\n} {\n  const base = config as T & ManagedConfig;\n  const dirs = contentDirs(options.cwd ?? process.cwd());\n  const includes = [\"./voxx.json\", ...dirs.map((dir) => `./${dir}/**/*`)];\n  const existing = base.outputFileTracingIncludes ?? {};\n\n  return {\n    ...base,\n    cacheComponents: base.cacheComponents ?? true,\n    serverExternalPackages: [\n      ...new Set([...(base.serverExternalPackages ?? []), CORE_PACKAGE]),\n    ],\n    outputFileTracingIncludes: {\n      ...existing,\n      \"/*\": [...new Set([...(existing[\"/*\"] ?? []), ...includes])],\n    },\n  };\n}\n"],"mappings":";;;;AAGA,MAAM,eAAe;AACrB,MAAM,sBAAsB;;;;;AA8B5B,SAAS,YAAY,KAAuB;CAC1C,IAAI;EACF,MAAM,OAAO,KAAK,OAAA,GAAA,QAAA,aAAA,EAAA,GAAA,UAAA,KAAA,CACE,KAAK,WAAW,GAAG,MAAM,CAC7C;EACA,MAAM,uBAAO,IAAI,IAAY;EAC7B,KAAK,MAAM,KAAK,KAAK,eAAe,CAAC,GACnC,KAAK,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,EAAE,QAAQ,EAAE,QAAQ,QAAQ;EAE1E,IAAI,KAAK,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG;EAChD,OAAO,KAAK,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,mBAAmB;CACzD,QAAQ;EACN,OAAO,CAAC,mBAAmB;CAC7B;AACF;;;;;;;;;;;;;;;;AAiBA,SAAgB,SACd,SAAY,CAAC,GACb,UAA2B,CAAC,GAK5B;CACA,MAAM,OAAO;CAEb,MAAM,WAAW,CAAC,eAAe,GADpB,YAAY,QAAQ,OAAO,QAAQ,IAAI,CACb,CAAC,CAAC,KAAK,QAAQ,KAAK,IAAI,MAAM,CAAC;CACtE,MAAM,WAAW,KAAK,6BAA6B,CAAC;CAEpD,OAAO;EACL,GAAG;EACH,iBAAiB,KAAK,mBAAmB;EACzC,wBAAwB,CACtB,GAAG,IAAI,IAAI,CAAC,GAAI,KAAK,0BAA0B,CAAC,GAAI,YAAY,CAAC,CACnE;EACA,2BAA2B;GACzB,GAAG;GACH,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAI,SAAS,SAAS,CAAC,GAAI,GAAG,QAAQ,CAAC,CAAC;EAC7D;CACF;AACF"}

package/dist/next.d.cts

@@ -0,0 +1,29 @@
+//#region src/next.d.ts
+/** Options for {@link withVoxx}. */
+interface WithVoxxOptions {
+  /** Directory containing `voxx.json`. Defaults to `process.cwd()`. */
+  cwd?: string;
+}
+/**
+ * Wraps a Next.js config with the settings every Voxx app needs to run
+ * correctly on serverless platforms.
+ *
+ * Enables Cache Components, marks `@prudentbird/voxx-core` as an external
+ * server package, and traces `voxx.json` plus every content directory into the
+ * serverless function bundle so runtime config and content reads resolve. Voxx
+ * content is filesystem-backed and read at request time during cache
+ * revalidation, so without these includes those reads fail on platforms that
+ * bundle each route into an isolated function.
+ *
+ * @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.
+ * @param options - Optional `cwd` override for locating `voxx.json`.
+ * @returns The base config merged with Voxx's required settings.
+ */
+declare function withVoxx<T extends object>(config?: T, options?: WithVoxxOptions): T & {
+  cacheComponents: boolean;
+  serverExternalPackages: string[];
+  outputFileTracingIncludes: Record<string, string[]>;
+};
+//#endregion
+export { WithVoxxOptions, withVoxx };
+//# sourceMappingURL=next.d.cts.map

package/dist/next.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.cts","names":[],"sources":["../src/next.ts"],"mappings":";;UAOiB,eAAA;EAAe;EAE9B,GAAG;AAAA;AAAA;AAwDL;;;;;;;;;;;;;;AAxDK,iBAwDW,QAAA,mBACd,MAAA,GAAQ,CAAA,EACR,OAAA,GAAS,eAAA,GACR,CAAA;EACD,eAAA;EACA,sBAAA;EACA,yBAAA,EAA2B,MAAA;AAAA"}

package/dist/next.d.mts

@@ -0,0 +1,29 @@
+//#region src/next.d.ts
+/** Options for {@link withVoxx}. */
+interface WithVoxxOptions {
+  /** Directory containing `voxx.json`. Defaults to `process.cwd()`. */
+  cwd?: string;
+}
+/**
+ * Wraps a Next.js config with the settings every Voxx app needs to run
+ * correctly on serverless platforms.
+ *
+ * Enables Cache Components, marks `@prudentbird/voxx-core` as an external
+ * server package, and traces `voxx.json` plus every content directory into the
+ * serverless function bundle so runtime config and content reads resolve. Voxx
+ * content is filesystem-backed and read at request time during cache
+ * revalidation, so without these includes those reads fail on platforms that
+ * bundle each route into an isolated function.
+ *
+ * @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.
+ * @param options - Optional `cwd` override for locating `voxx.json`.
+ * @returns The base config merged with Voxx's required settings.
+ */
+declare function withVoxx<T extends object>(config?: T, options?: WithVoxxOptions): T & {
+  cacheComponents: boolean;
+  serverExternalPackages: string[];
+  outputFileTracingIncludes: Record<string, string[]>;
+};
+//#endregion
+export { WithVoxxOptions, withVoxx };
+//# sourceMappingURL=next.d.mts.map

package/dist/next.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.mts","names":[],"sources":["../src/next.ts"],"mappings":";;UAOiB,eAAA;EAAe;EAE9B,GAAG;AAAA;AAAA;AAwDL;;;;;;;;;;;;;;AAxDK,iBAwDW,QAAA,mBACd,MAAA,GAAQ,CAAA,EACR,OAAA,GAAS,eAAA,GACR,CAAA;EACD,eAAA;EACA,sBAAA;EACA,yBAAA,EAA2B,MAAA;AAAA"}

package/dist/next.mjs

@@ -0,0 +1,53 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+//#region src/next.ts
+const CORE_PACKAGE = "@prudentbird/voxx-core";
+const DEFAULT_CONTENT_DIR = "content";
+/**
+* Reads the relative content directories declared in `voxx.json`, falling back
+* to the default `content` directory when the file is missing or unreadable.
+*/
+function contentDirs(cwd) {
+	try {
+		const data = JSON.parse(readFileSync(join(cwd, "voxx.json"), "utf8"));
+		const dirs = /* @__PURE__ */ new Set();
+		for (const c of data.collections ?? []) dirs.add(c.dir ?? `${DEFAULT_CONTENT_DIR}/${c.name ?? c.type ?? "blog"}`);
+		if (data.content?.dir) dirs.add(data.content.dir);
+		return dirs.size > 0 ? [...dirs] : [DEFAULT_CONTENT_DIR];
+	} catch {
+		return [DEFAULT_CONTENT_DIR];
+	}
+}
+/**
+* Wraps a Next.js config with the settings every Voxx app needs to run
+* correctly on serverless platforms.
+*
+* Enables Cache Components, marks `@prudentbird/voxx-core` as an external
+* server package, and traces `voxx.json` plus every content directory into the
+* serverless function bundle so runtime config and content reads resolve. Voxx
+* content is filesystem-backed and read at request time during cache
+* revalidation, so without these includes those reads fail on platforms that
+* bundle each route into an isolated function.
+*
+* @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.
+* @param options - Optional `cwd` override for locating `voxx.json`.
+* @returns The base config merged with Voxx's required settings.
+*/
+function withVoxx(config = {}, options = {}) {
+	const base = config;
+	const includes = ["./voxx.json", ...contentDirs(options.cwd ?? process.cwd()).map((dir) => `./${dir}/**/*`)];
+	const existing = base.outputFileTracingIncludes ?? {};
+	return {
+		...base,
+		cacheComponents: base.cacheComponents ?? true,
+		serverExternalPackages: [...new Set([...base.serverExternalPackages ?? [], CORE_PACKAGE])],
+		outputFileTracingIncludes: {
+			...existing,
+			"/*": [...new Set([...existing["/*"] ?? [], ...includes])]
+		}
+	};
+}
+//#endregion
+export { withVoxx };
+
+//# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.mjs","names":[],"sources":["../src/next.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CORE_PACKAGE = \"@prudentbird/voxx-core\";\nconst DEFAULT_CONTENT_DIR = \"content\";\n\n/** Options for {@link withVoxx}. */\nexport interface WithVoxxOptions {\n  /** Directory containing `voxx.json`. Defaults to `process.cwd()`. */\n  cwd?: string;\n}\n\n/** The Next.js config fields {@link withVoxx} manages; all other fields pass through unchanged. */\ninterface ManagedConfig {\n  cacheComponents?: boolean;\n  serverExternalPackages?: string[];\n  outputFileTracingIncludes?: Record<string, string[]>;\n}\n\ninterface RawCollection {\n  name?: string;\n  type?: string;\n  dir?: string;\n}\n\ninterface RawConfig {\n  content?: { dir?: string; type?: string };\n  collections?: RawCollection[];\n}\n\n/**\n * Reads the relative content directories declared in `voxx.json`, falling back\n * to the default `content` directory when the file is missing or unreadable.\n */\nfunction contentDirs(cwd: string): string[] {\n  try {\n    const data = JSON.parse(\n      readFileSync(join(cwd, \"voxx.json\"), \"utf8\"),\n    ) as RawConfig;\n    const dirs = new Set<string>();\n    for (const c of data.collections ?? []) {\n      dirs.add(c.dir ?? `${DEFAULT_CONTENT_DIR}/${c.name ?? c.type ?? \"blog\"}`);\n    }\n    if (data.content?.dir) dirs.add(data.content.dir);\n    return dirs.size > 0 ? [...dirs] : [DEFAULT_CONTENT_DIR];\n  } catch {\n    return [DEFAULT_CONTENT_DIR];\n  }\n}\n\n/**\n * Wraps a Next.js config with the settings every Voxx app needs to run\n * correctly on serverless platforms.\n *\n * Enables Cache Components, marks `@prudentbird/voxx-core` as an external\n * server package, and traces `voxx.json` plus every content directory into the\n * serverless function bundle so runtime config and content reads resolve. Voxx\n * content is filesystem-backed and read at request time during cache\n * revalidation, so without these includes those reads fail on platforms that\n * bundle each route into an isolated function.\n *\n * @param config - Base Next.js config. Existing values are preserved; `cacheComponents` defaults to `true` when unset.\n * @param options - Optional `cwd` override for locating `voxx.json`.\n * @returns The base config merged with Voxx's required settings.\n */\nexport function withVoxx<T extends object>(\n  config: T = {} as T,\n  options: WithVoxxOptions = {},\n): T & {\n  cacheComponents: boolean;\n  serverExternalPackages: string[];\n  outputFileTracingIncludes: Record<string, string[]>;\n} {\n  const base = config as T & ManagedConfig;\n  const dirs = contentDirs(options.cwd ?? process.cwd());\n  const includes = [\"./voxx.json\", ...dirs.map((dir) => `./${dir}/**/*`)];\n  const existing = base.outputFileTracingIncludes ?? {};\n\n  return {\n    ...base,\n    cacheComponents: base.cacheComponents ?? true,\n    serverExternalPackages: [\n      ...new Set([...(base.serverExternalPackages ?? []), CORE_PACKAGE]),\n    ],\n    outputFileTracingIncludes: {\n      ...existing,\n      \"/*\": [...new Set([...(existing[\"/*\"] ?? []), ...includes])],\n    },\n  };\n}\n"],"mappings":";;;AAGA,MAAM,eAAe;AACrB,MAAM,sBAAsB;;;;;AA8B5B,SAAS,YAAY,KAAuB;CAC1C,IAAI;EACF,MAAM,OAAO,KAAK,MAChB,aAAa,KAAK,KAAK,WAAW,GAAG,MAAM,CAC7C;EACA,MAAM,uBAAO,IAAI,IAAY;EAC7B,KAAK,MAAM,KAAK,KAAK,eAAe,CAAC,GACnC,KAAK,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,EAAE,QAAQ,EAAE,QAAQ,QAAQ;EAE1E,IAAI,KAAK,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG;EAChD,OAAO,KAAK,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,mBAAmB;CACzD,QAAQ;EACN,OAAO,CAAC,mBAAmB;CAC7B;AACF;;;;;;;;;;;;;;;;AAiBA,SAAgB,SACd,SAAY,CAAC,GACb,UAA2B,CAAC,GAK5B;CACA,MAAM,OAAO;CAEb,MAAM,WAAW,CAAC,eAAe,GADpB,YAAY,QAAQ,OAAO,QAAQ,IAAI,CACb,CAAC,CAAC,KAAK,QAAQ,KAAK,IAAI,MAAM,CAAC;CACtE,MAAM,WAAW,KAAK,6BAA6B,CAAC;CAEpD,OAAO;EACL,GAAG;EACH,iBAAiB,KAAK,mBAAmB;EACzC,wBAAwB,CACtB,GAAG,IAAI,IAAI,CAAC,GAAI,KAAK,0BAA0B,CAAC,GAAI,YAAY,CAAC,CACnE;EACA,2BAA2B;GACzB,GAAG;GACH,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAI,SAAS,SAAS,CAAC,GAAI,GAAG,QAAQ,CAAC,CAAC;EAC7D;CACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prudentbird/voxx-core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "The portable content engine behind Voxx: markdown + frontmatter -> SEO-ready blogs, docs, and changelogs.",
   "license": "MIT",
   "author": "prudentbird <me@prudentbird.com> (https://prudentbird.com)",
@@ -30,7 +30,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "files": [
     "dist",
@@ -59,6 +59,16 @@
         "default": "./dist/effect.cjs"
       }
     },
+    "./next": {
+      "import": {
+        "types": "./dist/next.d.mts",
+        "default": "./dist/next.mjs"
+      },
+      "require": {
+        "types": "./dist/next.d.cts",
+        "default": "./dist/next.cjs"
+      }
+    },
     "./theme/voxx.css": "./theme/voxx.css",
     "./theme/demo-globals.css": "./theme/demo-globals.css",
     "./voxx.schema.json": "./voxx.schema.json",
@@ -88,7 +98,6 @@
     "@types/node": "^25.9.3",
     "@typescript/native-preview": "7.0.0-dev.20260610.1",
     "eslint": "^10.0.2",
-    "jiti": "^2.7.0",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8",