@prudentbird/voxx-core 1.0.0 → 1.2.0

package/dist/config.cjs

@@ -60,6 +60,7 @@ function mergeConfig(input) {
 			title: input.site.title,
 			description: input.site.description ?? d.site.description,
 			url: input.site.url,
+			...input.site.titleHref !== void 0 ? { titleHref: input.site.titleHref } : {},
 			author: input.site.author ? {
 				name: input.site.author.name,
 				url: input.site.author.url

package/dist/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":["DEFAULT_CONFIG","Effect","Path","Schema","ConfigInput","ConfigError","ParseResult","FileSystem"],"sources":["../src/config.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { ConfigInput, type VoxxConfigInput } from \"./schema\";\nimport { ConfigError } from \"./errors\";\nimport {\n  DEFAULT_CONFIG,\n  type CollectionConfig,\n  type ContentType,\n  type VoxxConfig,\n} from \"./types\";\n\n/** Options for locating the `voxx.json` config file. */\nexport interface LoadConfigOptions {\n  /** Working directory to resolve relative paths from. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to `voxx.json`. Overrides `cwd`. */\n  path?: string;\n}\n\nconst TYPE_FEATURE_DEFAULTS: Record<\n  ContentType,\n  Partial<VoxxConfig[\"features\"]>\n> = {\n  blog: {},\n  docs: { rss: false, readingTime: false, tags: false },\n  changelog: {\n    toc: false,\n    sitemap: false,\n    readingTime: false,\n    tags: false,\n  },\n};\n\n/** Partial collection definition accepted in `voxx.json`. */\nexport interface CollectionInput {\n  readonly name?: string;\n  readonly type?: ContentType;\n  readonly dir?: string;\n  readonly basePath?: string;\n  readonly drafts?: boolean;\n}\n\n/**\n * Fills in missing fields on a collection definition with type-appropriate defaults.\n *\n * @param c - Partial collection input from config.\n * @returns A fully resolved `CollectionConfig`.\n */\nexport function resolveCollectionDefaults(\n  c: CollectionInput,\n): CollectionConfig {\n  const type = c.type ?? \"blog\";\n  const name = c.name ?? type;\n  return {\n    name,\n    type,\n    dir: c.dir ?? `content/${name}`,\n    basePath: c.basePath ?? `/${name}`,\n    drafts: c.drafts ?? false,\n  };\n}\n\nfunction mergeCollections(input: VoxxConfigInput): CollectionConfig[] {\n  const d = DEFAULT_CONFIG;\n  if (input.collections && input.collections.length > 0) {\n    return input.collections.map(resolveCollectionDefaults);\n  }\n  const type = input.content?.type ?? d.content.type;\n  return [\n    {\n      name: type,\n      type,\n      dir: input.content?.dir ?? d.content.dir,\n      basePath: input.content?.basePath ?? d.content.basePath,\n      drafts: input.content?.drafts ?? d.content.drafts,\n    },\n  ];\n}\n\nfunction mergeConfig(input: VoxxConfigInput): VoxxConfig {\n  const d = DEFAULT_CONFIG;\n  const collections = mergeCollections(input);\n  const first = collections[0]!;\n  const featureDefaults = {\n    ...d.features,\n    ...TYPE_FEATURE_DEFAULTS[first.type],\n  };\n  return {\n    site: {\n      title: input.site.title,\n      description: input.site.description ?? d.site.description,\n      url: input.site.url,\n      author: input.site.author\n        ? { name: input.site.author.name, url: input.site.author.url }\n        : d.site.author,\n      locale: input.site.locale ?? d.site.locale,\n    },\n    content: {\n      type: first.type,\n      dir: first.dir,\n      basePath: first.basePath,\n      drafts: first.drafts,\n    },\n    collections,\n    theme: {\n      preset: input.theme?.preset ?? d.theme.preset,\n      css: input.theme?.css ?? d.theme.css,\n      codeTheme: input.theme?.codeTheme ?? d.theme.codeTheme,\n    },\n    features: {\n      toc: input.features?.toc ?? featureDefaults.toc,\n      rss: input.features?.rss ?? featureDefaults.rss,\n      sitemap: input.features?.sitemap ?? featureDefaults.sitemap,\n      llmsTxt: input.features?.llmsTxt ?? featureDefaults.llmsTxt,\n      tags: input.features?.tags ?? featureDefaults.tags,\n      readingTime: input.features?.readingTime ?? featureDefaults.readingTime,\n    },\n    seo: {\n      openGraph: input.seo?.openGraph ?? d.seo.openGraph,\n      twitter: input.seo?.twitter ?? d.seo.twitter,\n      jsonLd: input.seo?.jsonLd ?? d.seo.jsonLd,\n      defaultImage: input.seo?.defaultImage ?? d.seo.defaultImage,\n    },\n  };\n}\n\n/**\n * Validates raw JSON data against the config schema and resolves all paths\n * relative to `cwd`.\n */\nexport const resolveConfig = (data: unknown, cwd: string) =>\n  Effect.gen(function* () {\n    const path = yield* Path.Path;\n    const decoded = yield* Schema.decodeUnknown(ConfigInput)(data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `voxx.json failed validation:\\n${ParseResult.TreeFormatter.formatErrorSync(cause)}`,\n            cause,\n          }),\n      ),\n    );\n    const merged = mergeConfig(decoded);\n    const resolveDir = (dir: string) =>\n      path.isAbsolute(dir) ? dir : path.join(cwd, dir);\n    return {\n      ...merged,\n      content: { ...merged.content, dir: resolveDir(merged.content.dir) },\n      collections: merged.collections.map((c) => ({\n        ...c,\n        dir: resolveDir(c.dir),\n      })),\n    } satisfies VoxxConfig;\n  });\n\n/**\n * Reads, parses, and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit `path` to the config file.\n */\nexport const loadConfigEffect = (opts: LoadConfigOptions = {}) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const cwd = opts.cwd ?? process.cwd();\n    const configPath = opts.path ?? path.join(cwd, \"voxx.json\");\n\n    const exists = yield* fs.exists(configPath).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `Could not access ${configPath}`,\n            cause,\n          }),\n      ),\n    );\n    if (!exists) {\n      return yield* new ConfigError({\n        message: `No voxx.json found at ${configPath}. Run \\`voxx init\\` to create one.`,\n      });\n    }\n\n    const raw = yield* fs\n      .readFileString(configPath)\n      .pipe(\n        Effect.mapError(\n          (cause) =>\n            new ConfigError({ message: `Could not read ${configPath}`, cause }),\n        ),\n      );\n\n    const data = yield* Effect.try({\n      try: () => JSON.parse(raw) as unknown,\n      catch: (cause) =>\n        new ConfigError({ message: `${configPath} is not valid JSON`, cause }),\n    });\n\n    return yield* resolveConfig(data, cwd);\n  });\n"],"mappings":"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"}
+{"version":3,"file":"config.cjs","names":["DEFAULT_CONFIG","Effect","Path","Schema","ConfigInput","ConfigError","ParseResult","FileSystem"],"sources":["../src/config.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { ConfigInput, type VoxxConfigInput } from \"./schema\";\nimport { ConfigError } from \"./errors\";\nimport {\n  DEFAULT_CONFIG,\n  type CollectionConfig,\n  type ContentType,\n  type VoxxConfig,\n} from \"./types\";\n\n/** Options for locating the `voxx.json` config file. */\nexport interface LoadConfigOptions {\n  /** Working directory to resolve relative paths from. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to `voxx.json`. Overrides `cwd`. */\n  path?: string;\n}\n\nconst TYPE_FEATURE_DEFAULTS: Record<\n  ContentType,\n  Partial<VoxxConfig[\"features\"]>\n> = {\n  blog: {},\n  docs: { rss: false, readingTime: false, tags: false },\n  changelog: {\n    toc: false,\n    sitemap: false,\n    readingTime: false,\n    tags: false,\n  },\n};\n\n/** Partial collection definition accepted in `voxx.json`. */\nexport interface CollectionInput {\n  readonly name?: string;\n  readonly type?: ContentType;\n  readonly dir?: string;\n  readonly basePath?: string;\n  readonly drafts?: boolean;\n}\n\n/**\n * Fills in missing fields on a collection definition with type-appropriate defaults.\n *\n * @param c - Partial collection input from config.\n * @returns A fully resolved `CollectionConfig`.\n */\nexport function resolveCollectionDefaults(\n  c: CollectionInput,\n): CollectionConfig {\n  const type = c.type ?? \"blog\";\n  const name = c.name ?? type;\n  return {\n    name,\n    type,\n    dir: c.dir ?? `content/${name}`,\n    basePath: c.basePath ?? `/${name}`,\n    drafts: c.drafts ?? false,\n  };\n}\n\nfunction mergeCollections(input: VoxxConfigInput): CollectionConfig[] {\n  const d = DEFAULT_CONFIG;\n  if (input.collections && input.collections.length > 0) {\n    return input.collections.map(resolveCollectionDefaults);\n  }\n  const type = input.content?.type ?? d.content.type;\n  return [\n    {\n      name: type,\n      type,\n      dir: input.content?.dir ?? d.content.dir,\n      basePath: input.content?.basePath ?? d.content.basePath,\n      drafts: input.content?.drafts ?? d.content.drafts,\n    },\n  ];\n}\n\nfunction mergeConfig(input: VoxxConfigInput): VoxxConfig {\n  const d = DEFAULT_CONFIG;\n  const collections = mergeCollections(input);\n  const first = collections[0]!;\n  const featureDefaults = {\n    ...d.features,\n    ...TYPE_FEATURE_DEFAULTS[first.type],\n  };\n  return {\n    site: {\n      title: input.site.title,\n      description: input.site.description ?? d.site.description,\n      url: input.site.url,\n      ...(input.site.titleHref !== undefined\n        ? { titleHref: input.site.titleHref }\n        : {}),\n      author: input.site.author\n        ? { name: input.site.author.name, url: input.site.author.url }\n        : d.site.author,\n      locale: input.site.locale ?? d.site.locale,\n    },\n    content: {\n      type: first.type,\n      dir: first.dir,\n      basePath: first.basePath,\n      drafts: first.drafts,\n    },\n    collections,\n    theme: {\n      preset: input.theme?.preset ?? d.theme.preset,\n      css: input.theme?.css ?? d.theme.css,\n      codeTheme: input.theme?.codeTheme ?? d.theme.codeTheme,\n    },\n    features: {\n      toc: input.features?.toc ?? featureDefaults.toc,\n      rss: input.features?.rss ?? featureDefaults.rss,\n      sitemap: input.features?.sitemap ?? featureDefaults.sitemap,\n      llmsTxt: input.features?.llmsTxt ?? featureDefaults.llmsTxt,\n      tags: input.features?.tags ?? featureDefaults.tags,\n      readingTime: input.features?.readingTime ?? featureDefaults.readingTime,\n    },\n    seo: {\n      openGraph: input.seo?.openGraph ?? d.seo.openGraph,\n      twitter: input.seo?.twitter ?? d.seo.twitter,\n      jsonLd: input.seo?.jsonLd ?? d.seo.jsonLd,\n      defaultImage: input.seo?.defaultImage ?? d.seo.defaultImage,\n    },\n  };\n}\n\n/**\n * Validates raw JSON data against the config schema and resolves all paths\n * relative to `cwd`.\n */\nexport const resolveConfig = (data: unknown, cwd: string) =>\n  Effect.gen(function* () {\n    const path = yield* Path.Path;\n    const decoded = yield* Schema.decodeUnknown(ConfigInput)(data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `voxx.json failed validation:\\n${ParseResult.TreeFormatter.formatErrorSync(cause)}`,\n            cause,\n          }),\n      ),\n    );\n    const merged = mergeConfig(decoded);\n    const resolveDir = (dir: string) =>\n      path.isAbsolute(dir) ? dir : path.join(cwd, dir);\n    return {\n      ...merged,\n      content: { ...merged.content, dir: resolveDir(merged.content.dir) },\n      collections: merged.collections.map((c) => ({\n        ...c,\n        dir: resolveDir(c.dir),\n      })),\n    } satisfies VoxxConfig;\n  });\n\n/**\n * Reads, parses, and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit `path` to the config file.\n */\nexport const loadConfigEffect = (opts: LoadConfigOptions = {}) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const cwd = opts.cwd ?? process.cwd();\n    const configPath = opts.path ?? path.join(cwd, \"voxx.json\");\n\n    const exists = yield* fs.exists(configPath).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `Could not access ${configPath}`,\n            cause,\n          }),\n      ),\n    );\n    if (!exists) {\n      return yield* new ConfigError({\n        message: `No voxx.json found at ${configPath}. Run \\`voxx init\\` to create one.`,\n      });\n    }\n\n    const raw = yield* fs\n      .readFileString(configPath)\n      .pipe(\n        Effect.mapError(\n          (cause) =>\n            new ConfigError({ message: `Could not read ${configPath}`, cause }),\n        ),\n      );\n\n    const data = yield* Effect.try({\n      try: () => JSON.parse(raw) as unknown,\n      catch: (cause) =>\n        new ConfigError({ message: `${configPath} is not valid JSON`, cause }),\n    });\n\n    return yield* resolveConfig(data, cwd);\n  });\n"],"mappings":"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"}

package/dist/config.d.cts

@@ -48,6 +48,7 @@ declare const resolveConfig: (data: unknown, cwd: string) => Effect.Effect<{
     title: string;
     description: string;
     url: string;
+    titleHref?: string;
     author?: VoxxAuthor;
     locale: string;
   };
@@ -94,6 +95,7 @@ declare const loadConfigEffect: (opts?: LoadConfigOptions) => Effect.Effect<{
     title: string;
     description: string;
     url: string;
+    titleHref?: string;
     author?: VoxxAuthor;
     locale: string;
   };
@@ -116,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.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;UAYiB,iBAAA;EAAA;EAEf,GAAA;;EAEA,IAAI;AAAA;AAkBN;AAAA,UAAiB,eAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA,GAAO,WAAW;EAAA,SAClB,GAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;AAAM;AASjB;;iBAAgB,yBAAA,CACd,CAAA,EAAG,eAAA,GACF,gBAAgB;;;;;cAgFN,aAAA,GAAiB,IAAA,WAAe,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8B3C,gBAAA,GAAoB,IAAA,GAAM,iBAAA,KAAsB,MAAA,CAAA,MAAA"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;UAYiB,iBAAA;EAAA;EAEf,GAAA;;EAEA,IAAI;AAAA;AAkBN;AAAA,UAAiB,eAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA,GAAO,WAAW;EAAA,SAClB,GAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;AAAM;AASjB;;iBAAgB,yBAAA,CACd,CAAA,EAAG,eAAA,GACF,gBAAgB;;;;;cAmFN,aAAA,GAAiB,IAAA,WAAe,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8B3C,gBAAA,GAAoB,IAAA,GAAM,iBAAA,KAAsB,MAAA,CAAA,MAAA"}

package/dist/config.d.mts

@@ -48,6 +48,7 @@ declare const resolveConfig: (data: unknown, cwd: string) => Effect.Effect<{
     title: string;
     description: string;
     url: string;
+    titleHref?: string;
     author?: VoxxAuthor;
     locale: string;
   };
@@ -94,6 +95,7 @@ declare const loadConfigEffect: (opts?: LoadConfigOptions) => Effect.Effect<{
     title: string;
     description: string;
     url: string;
+    titleHref?: string;
     author?: VoxxAuthor;
     locale: string;
   };
@@ -116,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/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;UAYiB,iBAAA;EAAA;EAEf,GAAA;;EAEA,IAAI;AAAA;AAkBN;AAAA,UAAiB,eAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA,GAAO,WAAW;EAAA,SAClB,GAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;AAAM;AASjB;;iBAAgB,yBAAA,CACd,CAAA,EAAG,eAAA,GACF,gBAAgB;;;;;cAgFN,aAAA,GAAiB,IAAA,WAAe,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8B3C,gBAAA,GAAoB,IAAA,GAAM,iBAAA,KAAsB,MAAA,CAAA,MAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;UAYiB,iBAAA;EAAA;EAEf,GAAA;;EAEA,IAAI;AAAA;AAkBN;AAAA,UAAiB,eAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA,GAAO,WAAW;EAAA,SAClB,GAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;AAAM;AASjB;;iBAAgB,yBAAA,CACd,CAAA,EAAG,eAAA,GACF,gBAAgB;;;;;cAmFN,aAAA,GAAiB,IAAA,WAAe,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8B3C,gBAAA,GAAoB,IAAA,GAAM,iBAAA,KAAsB,MAAA,CAAA,MAAA"}

package/dist/config.mjs

@@ -60,6 +60,7 @@ function mergeConfig(input) {
 			title: input.site.title,
 			description: input.site.description ?? d.site.description,
 			url: input.site.url,
+			...input.site.titleHref !== void 0 ? { titleHref: input.site.titleHref } : {},
 			author: input.site.author ? {
 				name: input.site.author.name,
 				url: input.site.author.url

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { ConfigInput, type VoxxConfigInput } from \"./schema\";\nimport { ConfigError } from \"./errors\";\nimport {\n  DEFAULT_CONFIG,\n  type CollectionConfig,\n  type ContentType,\n  type VoxxConfig,\n} from \"./types\";\n\n/** Options for locating the `voxx.json` config file. */\nexport interface LoadConfigOptions {\n  /** Working directory to resolve relative paths from. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to `voxx.json`. Overrides `cwd`. */\n  path?: string;\n}\n\nconst TYPE_FEATURE_DEFAULTS: Record<\n  ContentType,\n  Partial<VoxxConfig[\"features\"]>\n> = {\n  blog: {},\n  docs: { rss: false, readingTime: false, tags: false },\n  changelog: {\n    toc: false,\n    sitemap: false,\n    readingTime: false,\n    tags: false,\n  },\n};\n\n/** Partial collection definition accepted in `voxx.json`. */\nexport interface CollectionInput {\n  readonly name?: string;\n  readonly type?: ContentType;\n  readonly dir?: string;\n  readonly basePath?: string;\n  readonly drafts?: boolean;\n}\n\n/**\n * Fills in missing fields on a collection definition with type-appropriate defaults.\n *\n * @param c - Partial collection input from config.\n * @returns A fully resolved `CollectionConfig`.\n */\nexport function resolveCollectionDefaults(\n  c: CollectionInput,\n): CollectionConfig {\n  const type = c.type ?? \"blog\";\n  const name = c.name ?? type;\n  return {\n    name,\n    type,\n    dir: c.dir ?? `content/${name}`,\n    basePath: c.basePath ?? `/${name}`,\n    drafts: c.drafts ?? false,\n  };\n}\n\nfunction mergeCollections(input: VoxxConfigInput): CollectionConfig[] {\n  const d = DEFAULT_CONFIG;\n  if (input.collections && input.collections.length > 0) {\n    return input.collections.map(resolveCollectionDefaults);\n  }\n  const type = input.content?.type ?? d.content.type;\n  return [\n    {\n      name: type,\n      type,\n      dir: input.content?.dir ?? d.content.dir,\n      basePath: input.content?.basePath ?? d.content.basePath,\n      drafts: input.content?.drafts ?? d.content.drafts,\n    },\n  ];\n}\n\nfunction mergeConfig(input: VoxxConfigInput): VoxxConfig {\n  const d = DEFAULT_CONFIG;\n  const collections = mergeCollections(input);\n  const first = collections[0]!;\n  const featureDefaults = {\n    ...d.features,\n    ...TYPE_FEATURE_DEFAULTS[first.type],\n  };\n  return {\n    site: {\n      title: input.site.title,\n      description: input.site.description ?? d.site.description,\n      url: input.site.url,\n      author: input.site.author\n        ? { name: input.site.author.name, url: input.site.author.url }\n        : d.site.author,\n      locale: input.site.locale ?? d.site.locale,\n    },\n    content: {\n      type: first.type,\n      dir: first.dir,\n      basePath: first.basePath,\n      drafts: first.drafts,\n    },\n    collections,\n    theme: {\n      preset: input.theme?.preset ?? d.theme.preset,\n      css: input.theme?.css ?? d.theme.css,\n      codeTheme: input.theme?.codeTheme ?? d.theme.codeTheme,\n    },\n    features: {\n      toc: input.features?.toc ?? featureDefaults.toc,\n      rss: input.features?.rss ?? featureDefaults.rss,\n      sitemap: input.features?.sitemap ?? featureDefaults.sitemap,\n      llmsTxt: input.features?.llmsTxt ?? featureDefaults.llmsTxt,\n      tags: input.features?.tags ?? featureDefaults.tags,\n      readingTime: input.features?.readingTime ?? featureDefaults.readingTime,\n    },\n    seo: {\n      openGraph: input.seo?.openGraph ?? d.seo.openGraph,\n      twitter: input.seo?.twitter ?? d.seo.twitter,\n      jsonLd: input.seo?.jsonLd ?? d.seo.jsonLd,\n      defaultImage: input.seo?.defaultImage ?? d.seo.defaultImage,\n    },\n  };\n}\n\n/**\n * Validates raw JSON data against the config schema and resolves all paths\n * relative to `cwd`.\n */\nexport const resolveConfig = (data: unknown, cwd: string) =>\n  Effect.gen(function* () {\n    const path = yield* Path.Path;\n    const decoded = yield* Schema.decodeUnknown(ConfigInput)(data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `voxx.json failed validation:\\n${ParseResult.TreeFormatter.formatErrorSync(cause)}`,\n            cause,\n          }),\n      ),\n    );\n    const merged = mergeConfig(decoded);\n    const resolveDir = (dir: string) =>\n      path.isAbsolute(dir) ? dir : path.join(cwd, dir);\n    return {\n      ...merged,\n      content: { ...merged.content, dir: resolveDir(merged.content.dir) },\n      collections: merged.collections.map((c) => ({\n        ...c,\n        dir: resolveDir(c.dir),\n      })),\n    } satisfies VoxxConfig;\n  });\n\n/**\n * Reads, parses, and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit `path` to the config file.\n */\nexport const loadConfigEffect = (opts: LoadConfigOptions = {}) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const cwd = opts.cwd ?? process.cwd();\n    const configPath = opts.path ?? path.join(cwd, \"voxx.json\");\n\n    const exists = yield* fs.exists(configPath).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `Could not access ${configPath}`,\n            cause,\n          }),\n      ),\n    );\n    if (!exists) {\n      return yield* new ConfigError({\n        message: `No voxx.json found at ${configPath}. Run \\`voxx init\\` to create one.`,\n      });\n    }\n\n    const raw = yield* fs\n      .readFileString(configPath)\n      .pipe(\n        Effect.mapError(\n          (cause) =>\n            new ConfigError({ message: `Could not read ${configPath}`, cause }),\n        ),\n      );\n\n    const data = yield* Effect.try({\n      try: () => JSON.parse(raw) as unknown,\n      catch: (cause) =>\n        new ConfigError({ message: `${configPath} is not valid JSON`, cause }),\n    });\n\n    return yield* resolveConfig(data, cwd);\n  });\n"],"mappings":"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"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { ConfigInput, type VoxxConfigInput } from \"./schema\";\nimport { ConfigError } from \"./errors\";\nimport {\n  DEFAULT_CONFIG,\n  type CollectionConfig,\n  type ContentType,\n  type VoxxConfig,\n} from \"./types\";\n\n/** Options for locating the `voxx.json` config file. */\nexport interface LoadConfigOptions {\n  /** Working directory to resolve relative paths from. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to `voxx.json`. Overrides `cwd`. */\n  path?: string;\n}\n\nconst TYPE_FEATURE_DEFAULTS: Record<\n  ContentType,\n  Partial<VoxxConfig[\"features\"]>\n> = {\n  blog: {},\n  docs: { rss: false, readingTime: false, tags: false },\n  changelog: {\n    toc: false,\n    sitemap: false,\n    readingTime: false,\n    tags: false,\n  },\n};\n\n/** Partial collection definition accepted in `voxx.json`. */\nexport interface CollectionInput {\n  readonly name?: string;\n  readonly type?: ContentType;\n  readonly dir?: string;\n  readonly basePath?: string;\n  readonly drafts?: boolean;\n}\n\n/**\n * Fills in missing fields on a collection definition with type-appropriate defaults.\n *\n * @param c - Partial collection input from config.\n * @returns A fully resolved `CollectionConfig`.\n */\nexport function resolveCollectionDefaults(\n  c: CollectionInput,\n): CollectionConfig {\n  const type = c.type ?? \"blog\";\n  const name = c.name ?? type;\n  return {\n    name,\n    type,\n    dir: c.dir ?? `content/${name}`,\n    basePath: c.basePath ?? `/${name}`,\n    drafts: c.drafts ?? false,\n  };\n}\n\nfunction mergeCollections(input: VoxxConfigInput): CollectionConfig[] {\n  const d = DEFAULT_CONFIG;\n  if (input.collections && input.collections.length > 0) {\n    return input.collections.map(resolveCollectionDefaults);\n  }\n  const type = input.content?.type ?? d.content.type;\n  return [\n    {\n      name: type,\n      type,\n      dir: input.content?.dir ?? d.content.dir,\n      basePath: input.content?.basePath ?? d.content.basePath,\n      drafts: input.content?.drafts ?? d.content.drafts,\n    },\n  ];\n}\n\nfunction mergeConfig(input: VoxxConfigInput): VoxxConfig {\n  const d = DEFAULT_CONFIG;\n  const collections = mergeCollections(input);\n  const first = collections[0]!;\n  const featureDefaults = {\n    ...d.features,\n    ...TYPE_FEATURE_DEFAULTS[first.type],\n  };\n  return {\n    site: {\n      title: input.site.title,\n      description: input.site.description ?? d.site.description,\n      url: input.site.url,\n      ...(input.site.titleHref !== undefined\n        ? { titleHref: input.site.titleHref }\n        : {}),\n      author: input.site.author\n        ? { name: input.site.author.name, url: input.site.author.url }\n        : d.site.author,\n      locale: input.site.locale ?? d.site.locale,\n    },\n    content: {\n      type: first.type,\n      dir: first.dir,\n      basePath: first.basePath,\n      drafts: first.drafts,\n    },\n    collections,\n    theme: {\n      preset: input.theme?.preset ?? d.theme.preset,\n      css: input.theme?.css ?? d.theme.css,\n      codeTheme: input.theme?.codeTheme ?? d.theme.codeTheme,\n    },\n    features: {\n      toc: input.features?.toc ?? featureDefaults.toc,\n      rss: input.features?.rss ?? featureDefaults.rss,\n      sitemap: input.features?.sitemap ?? featureDefaults.sitemap,\n      llmsTxt: input.features?.llmsTxt ?? featureDefaults.llmsTxt,\n      tags: input.features?.tags ?? featureDefaults.tags,\n      readingTime: input.features?.readingTime ?? featureDefaults.readingTime,\n    },\n    seo: {\n      openGraph: input.seo?.openGraph ?? d.seo.openGraph,\n      twitter: input.seo?.twitter ?? d.seo.twitter,\n      jsonLd: input.seo?.jsonLd ?? d.seo.jsonLd,\n      defaultImage: input.seo?.defaultImage ?? d.seo.defaultImage,\n    },\n  };\n}\n\n/**\n * Validates raw JSON data against the config schema and resolves all paths\n * relative to `cwd`.\n */\nexport const resolveConfig = (data: unknown, cwd: string) =>\n  Effect.gen(function* () {\n    const path = yield* Path.Path;\n    const decoded = yield* Schema.decodeUnknown(ConfigInput)(data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `voxx.json failed validation:\\n${ParseResult.TreeFormatter.formatErrorSync(cause)}`,\n            cause,\n          }),\n      ),\n    );\n    const merged = mergeConfig(decoded);\n    const resolveDir = (dir: string) =>\n      path.isAbsolute(dir) ? dir : path.join(cwd, dir);\n    return {\n      ...merged,\n      content: { ...merged.content, dir: resolveDir(merged.content.dir) },\n      collections: merged.collections.map((c) => ({\n        ...c,\n        dir: resolveDir(c.dir),\n      })),\n    } satisfies VoxxConfig;\n  });\n\n/**\n * Reads, parses, and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit `path` to the config file.\n */\nexport const loadConfigEffect = (opts: LoadConfigOptions = {}) =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const path = yield* Path.Path;\n    const cwd = opts.cwd ?? process.cwd();\n    const configPath = opts.path ?? path.join(cwd, \"voxx.json\");\n\n    const exists = yield* fs.exists(configPath).pipe(\n      Effect.mapError(\n        (cause) =>\n          new ConfigError({\n            message: `Could not access ${configPath}`,\n            cause,\n          }),\n      ),\n    );\n    if (!exists) {\n      return yield* new ConfigError({\n        message: `No voxx.json found at ${configPath}. Run \\`voxx init\\` to create one.`,\n      });\n    }\n\n    const raw = yield* fs\n      .readFileString(configPath)\n      .pipe(\n        Effect.mapError(\n          (cause) =>\n            new ConfigError({ message: `Could not read ${configPath}`, cause }),\n        ),\n      );\n\n    const data = yield* Effect.try({\n      try: () => JSON.parse(raw) as unknown,\n      catch: (cause) =>\n        new ConfigError({ message: `${configPath} is not valid JSON`, cause }),\n    });\n\n    return yield* resolveConfig(data, cwd);\n  });\n"],"mappings":"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"}

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/dist/schema.cjs

@@ -32,6 +32,7 @@ const ConfigInput = effect.Schema.Struct({
 		title: effect.Schema.String,
 		description: effect.Schema.optional(effect.Schema.String),
 		url: effect.Schema.String,
+		titleHref: effect.Schema.optional(effect.Schema.String),
 		author: effect.Schema.optional(effect.Schema.Struct({
 			name: effect.Schema.String,
 			url: effect.Schema.optional(effect.Schema.String)

package/dist/schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.cjs","names":["Schema"],"sources":["../src/schema.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nconst DateLike = Schema.transform(\n  Schema.Union(Schema.String, Schema.DateFromSelf),\n  Schema.String,\n  {\n    strict: false,\n    decode: (value) => (value instanceof Date ? value.toISOString() : value),\n    encode: (value) => value,\n  },\n);\n\nconst optionalString = Schema.optionalWith(Schema.String, { nullable: true });\n\nexport const Frontmatter = Schema.Struct({\n  title: Schema.String,\n  description: optionalString,\n  date: Schema.optionalWith(DateLike, { nullable: true }),\n  updated: Schema.optionalWith(DateLike, { nullable: true }),\n  slug: optionalString,\n  tags: Schema.optionalWith(Schema.Array(Schema.String), {\n    default: () => [],\n    nullable: true,\n  }),\n  category: optionalString,\n  order: Schema.optionalWith(Schema.Number, { nullable: true }),\n  version: optionalString,\n  draft: Schema.optionalWith(Schema.Boolean, {\n    default: () => false,\n    nullable: true,\n  }),\n  image: optionalString,\n  author: optionalString,\n  excerpt: optionalString,\n});\n\nexport type FrontmatterData = typeof Frontmatter.Type;\n\nexport const ConfigInput = Schema.Struct({\n  site: Schema.Struct({\n    title: Schema.String,\n    description: Schema.optional(Schema.String),\n    url: Schema.String,\n    author: Schema.optional(\n      Schema.Struct({\n        name: Schema.String,\n        url: Schema.optional(Schema.String),\n      }),\n    ),\n    locale: Schema.optional(Schema.String),\n  }),\n  content: Schema.optional(\n    Schema.Struct({\n      type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n      dir: Schema.optional(Schema.String),\n      basePath: Schema.optional(Schema.String),\n      drafts: Schema.optional(Schema.Boolean),\n    }),\n  ),\n\n  collections: Schema.optional(\n    Schema.Array(\n      Schema.Struct({\n        name: Schema.optional(Schema.String),\n        type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n        dir: Schema.optional(Schema.String),\n        basePath: Schema.optional(Schema.String),\n        drafts: Schema.optional(Schema.Boolean),\n      }),\n    ),\n  ),\n  theme: Schema.optional(\n    Schema.Struct({\n      preset: Schema.optional(Schema.Literal(\"shadcn\")),\n      css: Schema.optional(Schema.NullOr(Schema.String)),\n      codeTheme: Schema.optional(Schema.String),\n    }),\n  ),\n  features: Schema.optional(\n    Schema.Struct({\n      toc: Schema.optional(Schema.Boolean),\n      rss: Schema.optional(Schema.Boolean),\n      sitemap: Schema.optional(Schema.Boolean),\n      llmsTxt: Schema.optional(Schema.Boolean),\n      tags: Schema.optional(Schema.Boolean),\n      readingTime: Schema.optional(Schema.Boolean),\n    }),\n  ),\n  seo: Schema.optional(\n    Schema.Struct({\n      openGraph: Schema.optional(Schema.Boolean),\n      twitter: Schema.optional(Schema.NullOr(Schema.String)),\n      jsonLd: Schema.optional(Schema.Boolean),\n      defaultImage: Schema.optional(Schema.NullOr(Schema.String)),\n    }),\n  ),\n});\n\nexport type VoxxConfigInput = typeof ConfigInput.Type;\n"],"mappings":";;AAEA,MAAM,WAAWA,OAAAA,OAAO,UACtBA,OAAAA,OAAO,MAAMA,OAAAA,OAAO,QAAQA,OAAAA,OAAO,YAAY,GAC/CA,OAAAA,OAAO,QACP;CACE,QAAQ;CACR,SAAS,UAAW,iBAAiB,OAAO,MAAM,YAAY,IAAI;CAClE,SAAS,UAAU;AACrB,CACF;AAEA,MAAM,iBAAiBA,OAAAA,OAAO,aAAaA,OAAAA,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;AAE5E,MAAa,cAAcA,OAAAA,OAAO,OAAO;CACvC,OAAOA,OAAAA,OAAO;CACd,aAAa;CACb,MAAMA,OAAAA,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACtD,SAASA,OAAAA,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACzD,MAAM;CACN,MAAMA,OAAAA,OAAO,aAAaA,OAAAA,OAAO,MAAMA,OAAAA,OAAO,MAAM,GAAG;EACrD,eAAe,CAAC;EAChB,UAAU;CACZ,CAAC;CACD,UAAU;CACV,OAAOA,OAAAA,OAAO,aAAaA,OAAAA,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;CAC5D,SAAS;CACT,OAAOA,OAAAA,OAAO,aAAaA,OAAAA,OAAO,SAAS;EACzC,eAAe;EACf,UAAU;CACZ,CAAC;CACD,OAAO;CACP,QAAQ;CACR,SAAS;AACX,CAAC;AAID,MAAa,cAAcA,OAAAA,OAAO,OAAO;CACvC,MAAMA,OAAAA,OAAO,OAAO;EAClB,OAAOA,OAAAA,OAAO;EACd,aAAaA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EAC1C,KAAKA,OAAAA,OAAO;EACZ,QAAQA,OAAAA,OAAO,SACbA,OAAAA,OAAO,OAAO;GACZ,MAAMA,OAAAA,OAAO;GACb,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EACpC,CAAC,CACH;EACA,QAAQA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;CACvC,CAAC;CACD,SAASA,OAAAA,OAAO,SACdA,OAAAA,OAAO,OAAO;EACZ,MAAMA,OAAAA,OAAO,SAASA,OAAAA,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EAClC,UAAUA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EACvC,QAAQA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;CACxC,CAAC,CACH;CAEA,aAAaA,OAAAA,OAAO,SAClBA,OAAAA,OAAO,MACLA,OAAAA,OAAO,OAAO;EACZ,MAAMA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EACnC,MAAMA,OAAAA,OAAO,SAASA,OAAAA,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EAClC,UAAUA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;EACvC,QAAQA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;CACxC,CAAC,CACH,CACF;CACA,OAAOA,OAAAA,OAAO,SACZA,OAAAA,OAAO,OAAO;EACZ,QAAQA,OAAAA,OAAO,SAASA,OAAAA,OAAO,QAAQ,QAAQ,CAAC;EAChD,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAOA,OAAAA,OAAO,MAAM,CAAC;EACjD,WAAWA,OAAAA,OAAO,SAASA,OAAAA,OAAO,MAAM;CAC1C,CAAC,CACH;CACA,UAAUA,OAAAA,OAAO,SACfA,OAAAA,OAAO,OAAO;EACZ,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACnC,KAAKA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACnC,SAASA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACvC,SAASA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACvC,MAAMA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACpC,aAAaA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;CAC7C,CAAC,CACH;CACA,KAAKA,OAAAA,OAAO,SACVA,OAAAA,OAAO,OAAO;EACZ,WAAWA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACzC,SAASA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAOA,OAAAA,OAAO,MAAM,CAAC;EACrD,QAAQA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAO;EACtC,cAAcA,OAAAA,OAAO,SAASA,OAAAA,OAAO,OAAOA,OAAAA,OAAO,MAAM,CAAC;CAC5D,CAAC,CACH;AACF,CAAC"}
+{"version":3,"file":"schema.cjs","names":["Schema"],"sources":["../src/schema.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nconst DateLike = Schema.transform(\n  Schema.Union(Schema.String, Schema.DateFromSelf),\n  Schema.String,\n  {\n    strict: false,\n    decode: (value) => (value instanceof Date ? value.toISOString() : value),\n    encode: (value) => value,\n  },\n);\n\nconst optionalString = Schema.optionalWith(Schema.String, { nullable: true });\n\nexport const Frontmatter = Schema.Struct({\n  title: Schema.String,\n  description: optionalString,\n  date: Schema.optionalWith(DateLike, { nullable: true }),\n  updated: Schema.optionalWith(DateLike, { nullable: true }),\n  slug: optionalString,\n  tags: Schema.optionalWith(Schema.Array(Schema.String), {\n    default: () => [],\n    nullable: true,\n  }),\n  category: optionalString,\n  order: Schema.optionalWith(Schema.Number, { nullable: true }),\n  version: optionalString,\n  draft: Schema.optionalWith(Schema.Boolean, {\n    default: () => false,\n    nullable: true,\n  }),\n  image: optionalString,\n  author: optionalString,\n  excerpt: optionalString,\n});\n\nexport type FrontmatterData = typeof Frontmatter.Type;\n\nexport const ConfigInput = Schema.Struct({\n  site: Schema.Struct({\n    title: Schema.String,\n    description: Schema.optional(Schema.String),\n    url: Schema.String,\n    titleHref: Schema.optional(Schema.String),\n    author: Schema.optional(\n      Schema.Struct({\n        name: Schema.String,\n        url: Schema.optional(Schema.String),\n      }),\n    ),\n    locale: Schema.optional(Schema.String),\n  }),\n  content: Schema.optional(\n    Schema.Struct({\n      type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n      dir: Schema.optional(Schema.String),\n      basePath: Schema.optional(Schema.String),\n      drafts: Schema.optional(Schema.Boolean),\n    }),\n  ),\n\n  collections: Schema.optional(\n    Schema.Array(\n      Schema.Struct({\n        name: Schema.optional(Schema.String),\n        type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n        dir: Schema.optional(Schema.String),\n        basePath: Schema.optional(Schema.String),\n        drafts: Schema.optional(Schema.Boolean),\n      }),\n    ),\n  ),\n  theme: Schema.optional(\n    Schema.Struct({\n      preset: Schema.optional(Schema.Literal(\"shadcn\")),\n      css: Schema.optional(Schema.NullOr(Schema.String)),\n      codeTheme: Schema.optional(Schema.String),\n    }),\n  ),\n  features: Schema.optional(\n    Schema.Struct({\n      toc: Schema.optional(Schema.Boolean),\n      rss: Schema.optional(Schema.Boolean),\n      sitemap: Schema.optional(Schema.Boolean),\n      llmsTxt: Schema.optional(Schema.Boolean),\n      tags: Schema.optional(Schema.Boolean),\n      readingTime: Schema.optional(Schema.Boolean),\n    }),\n  ),\n  seo: Schema.optional(\n    Schema.Struct({\n      openGraph: Schema.optional(Schema.Boolean),\n      twitter: Schema.optional(Schema.NullOr(Schema.String)),\n      jsonLd: Schema.optional(Schema.Boolean),\n      defaultImage: Schema.optional(Schema.NullOr(Schema.String)),\n    }),\n  ),\n});\n\nexport type VoxxConfigInput = typeof ConfigInput.Type;\n"],"mappings":"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"}

package/dist/schema.d.cts

@@ -48,6 +48,7 @@ declare const ConfigInput: Schema.Struct<{
     title: typeof Schema.String;
     description: Schema.optional<typeof Schema.String>;
     url: typeof Schema.String;
+    titleHref: Schema.optional<typeof Schema.String>;
     author: Schema.optional<Schema.Struct<{
       name: typeof Schema.String;
       url: Schema.optional<typeof Schema.String>;

package/dist/schema.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.cts","names":[],"sources":["../src/schema.ts"],"mappings":";;;cAca,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBZ,eAAA,UAAyB,WAAA,CAAY,IAAI;AAAA,cAExC,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4DZ,eAAA,UAAyB,WAAA,CAAY,IAAI"}
+{"version":3,"file":"schema.d.cts","names":[],"sources":["../src/schema.ts"],"mappings":";;;cAca,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBZ,eAAA,UAAyB,WAAA,CAAY,IAAI;AAAA,cAExC,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6DZ,eAAA,UAAyB,WAAA,CAAY,IAAI"}

package/dist/schema.d.mts

@@ -48,6 +48,7 @@ declare const ConfigInput: Schema.Struct<{
     title: typeof Schema.String;
     description: Schema.optional<typeof Schema.String>;
     url: typeof Schema.String;
+    titleHref: Schema.optional<typeof Schema.String>;
     author: Schema.optional<Schema.Struct<{
       name: typeof Schema.String;
       url: Schema.optional<typeof Schema.String>;

package/dist/schema.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.mts","names":[],"sources":["../src/schema.ts"],"mappings":";;;cAca,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBZ,eAAA,UAAyB,WAAA,CAAY,IAAI;AAAA,cAExC,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4DZ,eAAA,UAAyB,WAAA,CAAY,IAAI"}
+{"version":3,"file":"schema.d.mts","names":[],"sources":["../src/schema.ts"],"mappings":";;;cAca,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBZ,eAAA,UAAyB,WAAA,CAAY,IAAI;AAAA,cAExC,WAAA,EAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6DZ,eAAA,UAAyB,WAAA,CAAY,IAAI"}

package/dist/schema.mjs

@@ -32,6 +32,7 @@ const ConfigInput = Schema.Struct({
 		title: Schema.String,
 		description: Schema.optional(Schema.String),
 		url: Schema.String,
+		titleHref: Schema.optional(Schema.String),
 		author: Schema.optional(Schema.Struct({
 			name: Schema.String,
 			url: Schema.optional(Schema.String)

package/dist/schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.mjs","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nconst DateLike = Schema.transform(\n  Schema.Union(Schema.String, Schema.DateFromSelf),\n  Schema.String,\n  {\n    strict: false,\n    decode: (value) => (value instanceof Date ? value.toISOString() : value),\n    encode: (value) => value,\n  },\n);\n\nconst optionalString = Schema.optionalWith(Schema.String, { nullable: true });\n\nexport const Frontmatter = Schema.Struct({\n  title: Schema.String,\n  description: optionalString,\n  date: Schema.optionalWith(DateLike, { nullable: true }),\n  updated: Schema.optionalWith(DateLike, { nullable: true }),\n  slug: optionalString,\n  tags: Schema.optionalWith(Schema.Array(Schema.String), {\n    default: () => [],\n    nullable: true,\n  }),\n  category: optionalString,\n  order: Schema.optionalWith(Schema.Number, { nullable: true }),\n  version: optionalString,\n  draft: Schema.optionalWith(Schema.Boolean, {\n    default: () => false,\n    nullable: true,\n  }),\n  image: optionalString,\n  author: optionalString,\n  excerpt: optionalString,\n});\n\nexport type FrontmatterData = typeof Frontmatter.Type;\n\nexport const ConfigInput = Schema.Struct({\n  site: Schema.Struct({\n    title: Schema.String,\n    description: Schema.optional(Schema.String),\n    url: Schema.String,\n    author: Schema.optional(\n      Schema.Struct({\n        name: Schema.String,\n        url: Schema.optional(Schema.String),\n      }),\n    ),\n    locale: Schema.optional(Schema.String),\n  }),\n  content: Schema.optional(\n    Schema.Struct({\n      type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n      dir: Schema.optional(Schema.String),\n      basePath: Schema.optional(Schema.String),\n      drafts: Schema.optional(Schema.Boolean),\n    }),\n  ),\n\n  collections: Schema.optional(\n    Schema.Array(\n      Schema.Struct({\n        name: Schema.optional(Schema.String),\n        type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n        dir: Schema.optional(Schema.String),\n        basePath: Schema.optional(Schema.String),\n        drafts: Schema.optional(Schema.Boolean),\n      }),\n    ),\n  ),\n  theme: Schema.optional(\n    Schema.Struct({\n      preset: Schema.optional(Schema.Literal(\"shadcn\")),\n      css: Schema.optional(Schema.NullOr(Schema.String)),\n      codeTheme: Schema.optional(Schema.String),\n    }),\n  ),\n  features: Schema.optional(\n    Schema.Struct({\n      toc: Schema.optional(Schema.Boolean),\n      rss: Schema.optional(Schema.Boolean),\n      sitemap: Schema.optional(Schema.Boolean),\n      llmsTxt: Schema.optional(Schema.Boolean),\n      tags: Schema.optional(Schema.Boolean),\n      readingTime: Schema.optional(Schema.Boolean),\n    }),\n  ),\n  seo: Schema.optional(\n    Schema.Struct({\n      openGraph: Schema.optional(Schema.Boolean),\n      twitter: Schema.optional(Schema.NullOr(Schema.String)),\n      jsonLd: Schema.optional(Schema.Boolean),\n      defaultImage: Schema.optional(Schema.NullOr(Schema.String)),\n    }),\n  ),\n});\n\nexport type VoxxConfigInput = typeof ConfigInput.Type;\n"],"mappings":";;AAEA,MAAM,WAAW,OAAO,UACtB,OAAO,MAAM,OAAO,QAAQ,OAAO,YAAY,GAC/C,OAAO,QACP;CACE,QAAQ;CACR,SAAS,UAAW,iBAAiB,OAAO,MAAM,YAAY,IAAI;CAClE,SAAS,UAAU;AACrB,CACF;AAEA,MAAM,iBAAiB,OAAO,aAAa,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;AAE5E,MAAa,cAAc,OAAO,OAAO;CACvC,OAAO,OAAO;CACd,aAAa;CACb,MAAM,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACtD,SAAS,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACzD,MAAM;CACN,MAAM,OAAO,aAAa,OAAO,MAAM,OAAO,MAAM,GAAG;EACrD,eAAe,CAAC;EAChB,UAAU;CACZ,CAAC;CACD,UAAU;CACV,OAAO,OAAO,aAAa,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;CAC5D,SAAS;CACT,OAAO,OAAO,aAAa,OAAO,SAAS;EACzC,eAAe;EACf,UAAU;CACZ,CAAC;CACD,OAAO;CACP,QAAQ;CACR,SAAS;AACX,CAAC;AAID,MAAa,cAAc,OAAO,OAAO;CACvC,MAAM,OAAO,OAAO;EAClB,OAAO,OAAO;EACd,aAAa,OAAO,SAAS,OAAO,MAAM;EAC1C,KAAK,OAAO;EACZ,QAAQ,OAAO,SACb,OAAO,OAAO;GACZ,MAAM,OAAO;GACb,KAAK,OAAO,SAAS,OAAO,MAAM;EACpC,CAAC,CACH;EACA,QAAQ,OAAO,SAAS,OAAO,MAAM;CACvC,CAAC;CACD,SAAS,OAAO,SACd,OAAO,OAAO;EACZ,MAAM,OAAO,SAAS,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAK,OAAO,SAAS,OAAO,MAAM;EAClC,UAAU,OAAO,SAAS,OAAO,MAAM;EACvC,QAAQ,OAAO,SAAS,OAAO,OAAO;CACxC,CAAC,CACH;CAEA,aAAa,OAAO,SAClB,OAAO,MACL,OAAO,OAAO;EACZ,MAAM,OAAO,SAAS,OAAO,MAAM;EACnC,MAAM,OAAO,SAAS,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAK,OAAO,SAAS,OAAO,MAAM;EAClC,UAAU,OAAO,SAAS,OAAO,MAAM;EACvC,QAAQ,OAAO,SAAS,OAAO,OAAO;CACxC,CAAC,CACH,CACF;CACA,OAAO,OAAO,SACZ,OAAO,OAAO;EACZ,QAAQ,OAAO,SAAS,OAAO,QAAQ,QAAQ,CAAC;EAChD,KAAK,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;EACjD,WAAW,OAAO,SAAS,OAAO,MAAM;CAC1C,CAAC,CACH;CACA,UAAU,OAAO,SACf,OAAO,OAAO;EACZ,KAAK,OAAO,SAAS,OAAO,OAAO;EACnC,KAAK,OAAO,SAAS,OAAO,OAAO;EACnC,SAAS,OAAO,SAAS,OAAO,OAAO;EACvC,SAAS,OAAO,SAAS,OAAO,OAAO;EACvC,MAAM,OAAO,SAAS,OAAO,OAAO;EACpC,aAAa,OAAO,SAAS,OAAO,OAAO;CAC7C,CAAC,CACH;CACA,KAAK,OAAO,SACV,OAAO,OAAO;EACZ,WAAW,OAAO,SAAS,OAAO,OAAO;EACzC,SAAS,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;EACrD,QAAQ,OAAO,SAAS,OAAO,OAAO;EACtC,cAAc,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;CAC5D,CAAC,CACH;AACF,CAAC"}
+{"version":3,"file":"schema.mjs","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nconst DateLike = Schema.transform(\n  Schema.Union(Schema.String, Schema.DateFromSelf),\n  Schema.String,\n  {\n    strict: false,\n    decode: (value) => (value instanceof Date ? value.toISOString() : value),\n    encode: (value) => value,\n  },\n);\n\nconst optionalString = Schema.optionalWith(Schema.String, { nullable: true });\n\nexport const Frontmatter = Schema.Struct({\n  title: Schema.String,\n  description: optionalString,\n  date: Schema.optionalWith(DateLike, { nullable: true }),\n  updated: Schema.optionalWith(DateLike, { nullable: true }),\n  slug: optionalString,\n  tags: Schema.optionalWith(Schema.Array(Schema.String), {\n    default: () => [],\n    nullable: true,\n  }),\n  category: optionalString,\n  order: Schema.optionalWith(Schema.Number, { nullable: true }),\n  version: optionalString,\n  draft: Schema.optionalWith(Schema.Boolean, {\n    default: () => false,\n    nullable: true,\n  }),\n  image: optionalString,\n  author: optionalString,\n  excerpt: optionalString,\n});\n\nexport type FrontmatterData = typeof Frontmatter.Type;\n\nexport const ConfigInput = Schema.Struct({\n  site: Schema.Struct({\n    title: Schema.String,\n    description: Schema.optional(Schema.String),\n    url: Schema.String,\n    titleHref: Schema.optional(Schema.String),\n    author: Schema.optional(\n      Schema.Struct({\n        name: Schema.String,\n        url: Schema.optional(Schema.String),\n      }),\n    ),\n    locale: Schema.optional(Schema.String),\n  }),\n  content: Schema.optional(\n    Schema.Struct({\n      type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n      dir: Schema.optional(Schema.String),\n      basePath: Schema.optional(Schema.String),\n      drafts: Schema.optional(Schema.Boolean),\n    }),\n  ),\n\n  collections: Schema.optional(\n    Schema.Array(\n      Schema.Struct({\n        name: Schema.optional(Schema.String),\n        type: Schema.optional(Schema.Literal(\"blog\", \"docs\", \"changelog\")),\n        dir: Schema.optional(Schema.String),\n        basePath: Schema.optional(Schema.String),\n        drafts: Schema.optional(Schema.Boolean),\n      }),\n    ),\n  ),\n  theme: Schema.optional(\n    Schema.Struct({\n      preset: Schema.optional(Schema.Literal(\"shadcn\")),\n      css: Schema.optional(Schema.NullOr(Schema.String)),\n      codeTheme: Schema.optional(Schema.String),\n    }),\n  ),\n  features: Schema.optional(\n    Schema.Struct({\n      toc: Schema.optional(Schema.Boolean),\n      rss: Schema.optional(Schema.Boolean),\n      sitemap: Schema.optional(Schema.Boolean),\n      llmsTxt: Schema.optional(Schema.Boolean),\n      tags: Schema.optional(Schema.Boolean),\n      readingTime: Schema.optional(Schema.Boolean),\n    }),\n  ),\n  seo: Schema.optional(\n    Schema.Struct({\n      openGraph: Schema.optional(Schema.Boolean),\n      twitter: Schema.optional(Schema.NullOr(Schema.String)),\n      jsonLd: Schema.optional(Schema.Boolean),\n      defaultImage: Schema.optional(Schema.NullOr(Schema.String)),\n    }),\n  ),\n});\n\nexport type VoxxConfigInput = typeof ConfigInput.Type;\n"],"mappings":";;AAEA,MAAM,WAAW,OAAO,UACtB,OAAO,MAAM,OAAO,QAAQ,OAAO,YAAY,GAC/C,OAAO,QACP;CACE,QAAQ;CACR,SAAS,UAAW,iBAAiB,OAAO,MAAM,YAAY,IAAI;CAClE,SAAS,UAAU;AACrB,CACF;AAEA,MAAM,iBAAiB,OAAO,aAAa,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;AAE5E,MAAa,cAAc,OAAO,OAAO;CACvC,OAAO,OAAO;CACd,aAAa;CACb,MAAM,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACtD,SAAS,OAAO,aAAa,UAAU,EAAE,UAAU,KAAK,CAAC;CACzD,MAAM;CACN,MAAM,OAAO,aAAa,OAAO,MAAM,OAAO,MAAM,GAAG;EACrD,eAAe,CAAC;EAChB,UAAU;CACZ,CAAC;CACD,UAAU;CACV,OAAO,OAAO,aAAa,OAAO,QAAQ,EAAE,UAAU,KAAK,CAAC;CAC5D,SAAS;CACT,OAAO,OAAO,aAAa,OAAO,SAAS;EACzC,eAAe;EACf,UAAU;CACZ,CAAC;CACD,OAAO;CACP,QAAQ;CACR,SAAS;AACX,CAAC;AAID,MAAa,cAAc,OAAO,OAAO;CACvC,MAAM,OAAO,OAAO;EAClB,OAAO,OAAO;EACd,aAAa,OAAO,SAAS,OAAO,MAAM;EAC1C,KAAK,OAAO;EACZ,WAAW,OAAO,SAAS,OAAO,MAAM;EACxC,QAAQ,OAAO,SACb,OAAO,OAAO;GACZ,MAAM,OAAO;GACb,KAAK,OAAO,SAAS,OAAO,MAAM;EACpC,CAAC,CACH;EACA,QAAQ,OAAO,SAAS,OAAO,MAAM;CACvC,CAAC;CACD,SAAS,OAAO,SACd,OAAO,OAAO;EACZ,MAAM,OAAO,SAAS,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAK,OAAO,SAAS,OAAO,MAAM;EAClC,UAAU,OAAO,SAAS,OAAO,MAAM;EACvC,QAAQ,OAAO,SAAS,OAAO,OAAO;CACxC,CAAC,CACH;CAEA,aAAa,OAAO,SAClB,OAAO,MACL,OAAO,OAAO;EACZ,MAAM,OAAO,SAAS,OAAO,MAAM;EACnC,MAAM,OAAO,SAAS,OAAO,QAAQ,QAAQ,QAAQ,WAAW,CAAC;EACjE,KAAK,OAAO,SAAS,OAAO,MAAM;EAClC,UAAU,OAAO,SAAS,OAAO,MAAM;EACvC,QAAQ,OAAO,SAAS,OAAO,OAAO;CACxC,CAAC,CACH,CACF;CACA,OAAO,OAAO,SACZ,OAAO,OAAO;EACZ,QAAQ,OAAO,SAAS,OAAO,QAAQ,QAAQ,CAAC;EAChD,KAAK,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;EACjD,WAAW,OAAO,SAAS,OAAO,MAAM;CAC1C,CAAC,CACH;CACA,UAAU,OAAO,SACf,OAAO,OAAO;EACZ,KAAK,OAAO,SAAS,OAAO,OAAO;EACnC,KAAK,OAAO,SAAS,OAAO,OAAO;EACnC,SAAS,OAAO,SAAS,OAAO,OAAO;EACvC,SAAS,OAAO,SAAS,OAAO,OAAO;EACvC,MAAM,OAAO,SAAS,OAAO,OAAO;EACpC,aAAa,OAAO,SAAS,OAAO,OAAO;CAC7C,CAAC,CACH;CACA,KAAK,OAAO,SACV,OAAO,OAAO;EACZ,WAAW,OAAO,SAAS,OAAO,OAAO;EACzC,SAAS,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;EACrD,QAAQ,OAAO,SAAS,OAAO,OAAO;EACtC,cAAc,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,CAAC;CAC5D,CAAC,CACH;AACF,CAAC"}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** Author metadata attached to a site or post. */\nexport interface VoxxAuthor {\n  name: string;\n  url?: string;\n}\n\n/** The rendering mode for a content collection. */\nexport type ContentType = \"blog\" | \"docs\" | \"changelog\";\n\n/** A resolved content collection with all defaults applied. */\nexport interface CollectionConfig {\n  name: string;\n  type: ContentType;\n  /** Filesystem path to the content directory. */\n  dir: string;\n  /** URL prefix for all posts in this collection. */\n  basePath: string;\n  /** Whether draft posts are included by default. */\n  drafts: boolean;\n}\n\n/** Resolved Voxx configuration merged from `voxx.json` and defaults. */\nexport interface VoxxConfig {\n  site: {\n    title: string;\n    description: string;\n    /** Canonical origin, e.g. `https://example.com`. */\n    url: string;\n    author?: VoxxAuthor;\n    /** BCP 47 locale tag, e.g. `en-US`. */\n    locale: string;\n  };\n  /** Primary content collection (mirrors `collections[0]`). */\n  content: {\n    type: ContentType;\n    dir: string;\n    basePath: string;\n    drafts: boolean;\n  };\n  collections: CollectionConfig[];\n  theme: {\n    preset: \"shadcn\";\n    /** Path to a custom CSS file, or `null` to use the preset default. */\n    css: string | null;\n    /** One or two Shiki theme names separated by a space (light dark). */\n    codeTheme: string;\n  };\n  features: {\n    toc: boolean;\n    rss: boolean;\n    sitemap: boolean;\n    llmsTxt: boolean;\n    tags: boolean;\n    readingTime: boolean;\n  };\n  seo: {\n    openGraph: boolean;\n    /** Twitter/X handle including `@`, or `null` to omit. */\n    twitter: string | null;\n    jsonLd: boolean;\n    /** Fallback OG image path relative to the site root. */\n    defaultImage: string | null;\n  };\n}\n\n/** A single entry in a page's table of contents. */\nexport interface TocItem {\n  id: string;\n  text: string;\n  /** Heading level — `2` for `h2`, `3` for `h3`. */\n  depth: number;\n}\n\n/** A fully processed content post ready to render. */\nexport interface Post {\n  /** Final path segment(s), e.g. `[\"getting-started\", \"install\"]`. */\n  slug: string;\n  path: string[];\n  /** Absolute URL path, e.g. `/blog/my-post`. */\n  url: string;\n  title: string;\n  description?: string;\n  /** ISO 8601 publish date. */\n  date: string;\n  /** ISO 8601 last-modified date. */\n  updated?: string;\n  tags: string[];\n  category?: string;\n  /** Sort order within the parent directory (docs only). */\n  order?: number;\n  /** Semver string extracted from the filename or frontmatter (changelog only). */\n  version?: string;\n  draft: boolean;\n  image?: string;\n  author?: string;\n  /** Plain-text excerpt derived from the first 180 characters of content. */\n  excerpt: string;\n  readingTimeMinutes: number;\n  /** Rendered HTML string. */\n  html: string;\n  toc: TocItem[];\n  /** Raw Markdown source. */\n  content: string;\n}\n\n/** A node in the sidebar navigation tree. */\nexport interface NavNode {\n  title: string;\n  /** Present on leaf nodes; absent on category nodes. */\n  url?: string;\n  children: NavNode[];\n}\n\n/** Open Graph article metadata. */\nexport interface OpenGraphData {\n  title: string;\n  description: string;\n  url: string;\n  type: \"article\";\n  siteName: string;\n  locale: string;\n  images: string[];\n  publishedTime?: string;\n  modifiedTime?: string;\n  authors: string[];\n  tags: string[];\n}\n\n/** Twitter card metadata. */\nexport interface TwitterData {\n  card: \"summary_large_image\";\n  site?: string;\n  creator?: string;\n  title: string;\n  description: string;\n  images: string[];\n}\n\n/** Aggregated SEO metadata for a single page. */\nexport interface SeoData {\n  title: string;\n  description: string;\n  canonical: string;\n  openGraph?: OpenGraphData;\n  twitter?: TwitterData;\n  /** JSON-LD structured data object — serialize with `serializeJsonLd`. */\n  jsonLd?: Record<string, unknown>;\n}\n\nexport const DEFAULT_CONFIG: VoxxConfig = {\n  site: {\n    title: \"Blog\",\n    description: \"\",\n    url: \"\",\n    locale: \"en-US\",\n  },\n  content: {\n    type: \"blog\",\n    dir: \"content/blog\",\n    basePath: \"/blog\",\n    drafts: false,\n  },\n  collections: [\n    {\n      name: \"blog\",\n      type: \"blog\",\n      dir: \"content/blog\",\n      basePath: \"/blog\",\n      drafts: false,\n    },\n  ],\n  theme: {\n    preset: \"shadcn\",\n    css: null,\n    codeTheme: \"github-light github-dark\",\n  },\n  features: {\n    toc: true,\n    rss: true,\n    sitemap: true,\n    llmsTxt: true,\n    tags: true,\n    readingTime: true,\n  },\n  seo: {\n    openGraph: true,\n    twitter: null,\n    jsonLd: true,\n    defaultImage: null,\n  },\n};\n"],"mappings":";AAqJA,MAAa,iBAA6B;CACxC,MAAM;EACJ,OAAO;EACP,aAAa;EACb,KAAK;EACL,QAAQ;CACV;CACA,SAAS;EACP,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV;CACA,aAAa,CACX;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV,CACF;CACA,OAAO;EACL,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,UAAU;EACR,KAAK;EACL,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;EACN,aAAa;CACf;CACA,KAAK;EACH,WAAW;EACX,SAAS;EACT,QAAQ;EACR,cAAc;CAChB;AACF"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** Author metadata attached to a site or post. */\nexport interface VoxxAuthor {\n  name: string;\n  url?: string;\n}\n\n/** The rendering mode for a content collection. */\nexport type ContentType = \"blog\" | \"docs\" | \"changelog\";\n\n/** A resolved content collection with all defaults applied. */\nexport interface CollectionConfig {\n  name: string;\n  type: ContentType;\n  /** Filesystem path to the content directory. */\n  dir: string;\n  /** URL prefix for all posts in this collection. */\n  basePath: string;\n  /** Whether draft posts are included by default. */\n  drafts: boolean;\n}\n\n/** Resolved Voxx configuration merged from `voxx.json` and defaults. */\nexport interface VoxxConfig {\n  site: {\n    title: string;\n    description: string;\n    /** Canonical origin, e.g. `https://example.com`. */\n    url: string;\n    /** Link target for the header / sidebar title. Falls back to the collection `basePath` when unset. Distinct from `url`, which is the canonical origin used for SEO. */\n    titleHref?: string;\n    author?: VoxxAuthor;\n    /** BCP 47 locale tag, e.g. `en-US`. */\n    locale: string;\n  };\n  /** Primary content collection (mirrors `collections[0]`). */\n  content: {\n    type: ContentType;\n    dir: string;\n    basePath: string;\n    drafts: boolean;\n  };\n  collections: CollectionConfig[];\n  theme: {\n    preset: \"shadcn\";\n    /** Path to a custom CSS file, or `null` to use the preset default. */\n    css: string | null;\n    /** One or two Shiki theme names separated by a space (light dark). */\n    codeTheme: string;\n  };\n  features: {\n    toc: boolean;\n    rss: boolean;\n    sitemap: boolean;\n    llmsTxt: boolean;\n    tags: boolean;\n    readingTime: boolean;\n  };\n  seo: {\n    openGraph: boolean;\n    /** Twitter/X handle including `@`, or `null` to omit. */\n    twitter: string | null;\n    jsonLd: boolean;\n    /** Fallback OG image path relative to the site root. */\n    defaultImage: string | null;\n  };\n}\n\n/** A single entry in a page's table of contents. */\nexport interface TocItem {\n  id: string;\n  text: string;\n  /** Heading level — `2` for `h2`, `3` for `h3`. */\n  depth: number;\n}\n\n/** A fully processed content post ready to render. */\nexport interface Post {\n  /** Final path segment(s), e.g. `[\"getting-started\", \"install\"]`. */\n  slug: string;\n  path: string[];\n  /** Absolute URL path, e.g. `/blog/my-post`. */\n  url: string;\n  title: string;\n  description?: string;\n  /** ISO 8601 publish date. */\n  date: string;\n  /** ISO 8601 last-modified date. */\n  updated?: string;\n  tags: string[];\n  category?: string;\n  /** Sort order within the parent directory (docs only). */\n  order?: number;\n  /** Semver string extracted from the filename or frontmatter (changelog only). */\n  version?: string;\n  draft: boolean;\n  image?: string;\n  author?: string;\n  /** Plain-text excerpt derived from the first 180 characters of content. */\n  excerpt: string;\n  readingTimeMinutes: number;\n  /** Rendered HTML string. */\n  html: string;\n  toc: TocItem[];\n  /** Raw Markdown source. */\n  content: string;\n}\n\n/** A node in the sidebar navigation tree. */\nexport interface NavNode {\n  title: string;\n  /** Present on leaf nodes; absent on category nodes. */\n  url?: string;\n  children: NavNode[];\n}\n\n/** Open Graph article metadata. */\nexport interface OpenGraphData {\n  title: string;\n  description: string;\n  url: string;\n  type: \"article\";\n  siteName: string;\n  locale: string;\n  images: string[];\n  publishedTime?: string;\n  modifiedTime?: string;\n  authors: string[];\n  tags: string[];\n}\n\n/** Twitter card metadata. */\nexport interface TwitterData {\n  card: \"summary_large_image\";\n  site?: string;\n  creator?: string;\n  title: string;\n  description: string;\n  images: string[];\n}\n\n/** Aggregated SEO metadata for a single page. */\nexport interface SeoData {\n  title: string;\n  description: string;\n  canonical: string;\n  openGraph?: OpenGraphData;\n  twitter?: TwitterData;\n  /** JSON-LD structured data object — serialize with `serializeJsonLd`. */\n  jsonLd?: Record<string, unknown>;\n}\n\nexport const DEFAULT_CONFIG: VoxxConfig = {\n  site: {\n    title: \"Blog\",\n    description: \"\",\n    url: \"\",\n    locale: \"en-US\",\n  },\n  content: {\n    type: \"blog\",\n    dir: \"content/blog\",\n    basePath: \"/blog\",\n    drafts: false,\n  },\n  collections: [\n    {\n      name: \"blog\",\n      type: \"blog\",\n      dir: \"content/blog\",\n      basePath: \"/blog\",\n      drafts: false,\n    },\n  ],\n  theme: {\n    preset: \"shadcn\",\n    css: null,\n    codeTheme: \"github-light github-dark\",\n  },\n  features: {\n    toc: true,\n    rss: true,\n    sitemap: true,\n    llmsTxt: true,\n    tags: true,\n    readingTime: true,\n  },\n  seo: {\n    openGraph: true,\n    twitter: null,\n    jsonLd: true,\n    defaultImage: null,\n  },\n};\n"],"mappings":";AAuJA,MAAa,iBAA6B;CACxC,MAAM;EACJ,OAAO;EACP,aAAa;EACb,KAAK;EACL,QAAQ;CACV;CACA,SAAS;EACP,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV;CACA,aAAa,CACX;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV,CACF;CACA,OAAO;EACL,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,UAAU;EACR,KAAK;EACL,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;EACN,aAAa;CACf;CACA,KAAK;EACH,WAAW;EACX,SAAS;EACT,QAAQ;EACR,cAAc;CAChB;AACF"}

package/dist/types.d.cts

@@ -22,7 +22,8 @@ interface VoxxConfig {
   site: {
     title: string;
     description: string; /** Canonical origin, e.g. `https://example.com`. */
-    url: string;
+    url: string; /** Link target for the header / sidebar title. Falls back to the collection `basePath` when unset. Distinct from `url`, which is the canonical origin used for SEO. */
+    titleHref?: string;
     author?: VoxxAuthor; /** BCP 47 locale tag, e.g. `en-US`. */
     locale: string;
   };

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;UACiB,UAAA;EACf,IAAA;EACA,GAAG;AAAA;AAAA;AAAA,KAIO,WAAA;;UAGK,gBAAA;EACf,IAAA;EACA,IAAA,EAAM,WAAW;EAFF;EAIf,GAAA;;EAEA,QAAA;EALA;EAOA,MAAA;AAAA;;UAIe,UAAA;EACf,IAAA;IACE,KAAA;IACA,WAAA,UAHa;IAKb,GAAA;IACA,MAAA,GAAS,UAAA,EAAA;IAET,MAAA;EAAA;EAS2B;EAN7B,OAAA;IACE,IAAA,EAAM,WAAA;IACN,GAAA;IACA,QAAA;IACA,MAAA;EAAA;EAEF,WAAA,EAAa,gBAAA;EACb,KAAA;IACE,MAAA,YAPA;IASA,GAAA,iBARA;IAUA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA;IACA,GAAA;IACA,OAAA;IACA,OAAA;IACA,IAAA;IACA,WAAA;EAAA;EAEF,GAAA;IACE,SAAA,WALA;IAOA,OAAA;IACA,MAAA,WAJF;IAME,YAAA;EAAA;AAAA;;UAKa,OAAA;EACf,EAAA;EACA,IAAA;EAFsB;EAItB,KAAA;AAAA;;UAIe,IAAA;EAJf;EAMA,IAAA;EACA,IAAA;EAHe;EAKf,GAAA;EACA,KAAA;EACA,WAAA;EALA;EAOA,IAAA;EAJA;EAMA,OAAA;EACA,IAAA;EACA,QAAA;EAFA;EAIA,KAAA;EAFA;EAIA,OAAA;EACA,KAAA;EACA,KAAA;EACA,MAAA;EAAA;EAEA,OAAA;EACA,kBAAA;EAEA;EAAA,IAAA;EACA,GAAA,EAAK,OAAO;EAEZ;EAAA,OAAA;AAAA;AAIF;AAAA,UAAiB,OAAA;EACf,KAAA;EAGiB;EADjB,GAAA;EACA,QAAA,EAAU,OAAO;AAAA;;UAIF,aAAA;EACf,KAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA;EACA,MAAA;EACA,MAAA;EACA,aAAA;EACA,YAAA;EACA,OAAA;EACA,IAAA;AAAA;;UAIe,WAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;EACA,KAAA;EACA,WAAA;EACA,MAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA,GAAY,aAAA;EACZ,OAAA,GAAU,WAAA;EATJ;EAWN,MAAA,GAAS,MAAA;AAAA;AAAA,cAGE,cAAA,EAAgB,UAyC5B"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;UACiB,UAAA;EACf,IAAA;EACA,GAAG;AAAA;AAAA;AAAA,KAIO,WAAA;;UAGK,gBAAA;EACf,IAAA;EACA,IAAA,EAAM,WAAW;EAFF;EAIf,GAAA;;EAEA,QAAA;EALA;EAOA,MAAA;AAAA;;UAIe,UAAA;EACf,IAAA;IACE,KAAA;IACA,WAAA,UAHa;IAKb,GAAA,UALuB;IAOvB,SAAA;IACA,MAAA,GAAS,UAAA,EAWE;IATX,MAAA;EAAA;EATF;EAYA,OAAA;IACE,IAAA,EAAM,WAAA;IACN,GAAA;IACA,QAAA;IACA,MAAA;EAAA;EAEF,WAAA,EAAa,gBAAA;EACb,KAAA;IACE,MAAA,YAPM;IASN,GAAA,iBAPA;IASA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA;IACA,GAAA;IACA,OAAA;IACA,OAAA;IACA,IAAA;IACA,WAAA;EAAA;EAEF,GAAA;IACE,SAAA,WAJA;IAMA,OAAA;IACA,MAAA,WAHA;IAKA,YAAA;EAAA;AAAA;;UAKa,OAAA;EACf,EAAA;EACA,IAAA;;EAEA,KAAA;AAAA;;UAIe,IAAA;EAJV;EAML,IAAA;EACA,IAAA;EAHmB;EAKnB,GAAA;EACA,KAAA;EACA,WAAA;EAJA;EAMA,IAAA;EAHA;EAKA,OAAA;EACA,IAAA;EACA,QAAA;EADA;EAGA,KAAA;EAAA;EAEA,OAAA;EACA,KAAA;EACA,KAAA;EACA,MAAA;EAEA;EAAA,OAAA;EACA,kBAAA;EAGA;EADA,IAAA;EACA,GAAA,EAAK,OAAO;EAEL;EAAP,OAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EAAA;EAEA,GAAA;EACA,QAAA,EAAU,OAAO;AAAA;;UAIF,aAAA;EACf,KAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA;EACA,MAAA;EACA,MAAA;EACA,aAAA;EACA,YAAA;EACA,OAAA;EACA,IAAA;AAAA;;UAIe,WAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;EACA,KAAA;EACA,WAAA;EACA,MAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA,GAAY,aAAA;EACZ,OAAA,GAAU,WAAA;EATJ;EAWN,MAAA,GAAS,MAAA;AAAA;AAAA,cAGE,cAAA,EAAgB,UAyC5B"}

package/dist/types.d.mts

@@ -22,7 +22,8 @@ interface VoxxConfig {
   site: {
     title: string;
     description: string; /** Canonical origin, e.g. `https://example.com`. */
-    url: string;
+    url: string; /** Link target for the header / sidebar title. Falls back to the collection `basePath` when unset. Distinct from `url`, which is the canonical origin used for SEO. */
+    titleHref?: string;
     author?: VoxxAuthor; /** BCP 47 locale tag, e.g. `en-US`. */
     locale: string;
   };

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;UACiB,UAAA;EACf,IAAA;EACA,GAAG;AAAA;AAAA;AAAA,KAIO,WAAA;;UAGK,gBAAA;EACf,IAAA;EACA,IAAA,EAAM,WAAW;EAFF;EAIf,GAAA;;EAEA,QAAA;EALA;EAOA,MAAA;AAAA;;UAIe,UAAA;EACf,IAAA;IACE,KAAA;IACA,WAAA,UAHa;IAKb,GAAA;IACA,MAAA,GAAS,UAAA,EAAA;IAET,MAAA;EAAA;EAS2B;EAN7B,OAAA;IACE,IAAA,EAAM,WAAA;IACN,GAAA;IACA,QAAA;IACA,MAAA;EAAA;EAEF,WAAA,EAAa,gBAAA;EACb,KAAA;IACE,MAAA,YAPA;IASA,GAAA,iBARA;IAUA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA;IACA,GAAA;IACA,OAAA;IACA,OAAA;IACA,IAAA;IACA,WAAA;EAAA;EAEF,GAAA;IACE,SAAA,WALA;IAOA,OAAA;IACA,MAAA,WAJF;IAME,YAAA;EAAA;AAAA;;UAKa,OAAA;EACf,EAAA;EACA,IAAA;EAFsB;EAItB,KAAA;AAAA;;UAIe,IAAA;EAJf;EAMA,IAAA;EACA,IAAA;EAHe;EAKf,GAAA;EACA,KAAA;EACA,WAAA;EALA;EAOA,IAAA;EAJA;EAMA,OAAA;EACA,IAAA;EACA,QAAA;EAFA;EAIA,KAAA;EAFA;EAIA,OAAA;EACA,KAAA;EACA,KAAA;EACA,MAAA;EAAA;EAEA,OAAA;EACA,kBAAA;EAEA;EAAA,IAAA;EACA,GAAA,EAAK,OAAO;EAEZ;EAAA,OAAA;AAAA;AAIF;AAAA,UAAiB,OAAA;EACf,KAAA;EAGiB;EADjB,GAAA;EACA,QAAA,EAAU,OAAO;AAAA;;UAIF,aAAA;EACf,KAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA;EACA,MAAA;EACA,MAAA;EACA,aAAA;EACA,YAAA;EACA,OAAA;EACA,IAAA;AAAA;;UAIe,WAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;EACA,KAAA;EACA,WAAA;EACA,MAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA,GAAY,aAAA;EACZ,OAAA,GAAU,WAAA;EATJ;EAWN,MAAA,GAAS,MAAA;AAAA;AAAA,cAGE,cAAA,EAAgB,UAyC5B"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;UACiB,UAAA;EACf,IAAA;EACA,GAAG;AAAA;AAAA;AAAA,KAIO,WAAA;;UAGK,gBAAA;EACf,IAAA;EACA,IAAA,EAAM,WAAW;EAFF;EAIf,GAAA;;EAEA,QAAA;EALA;EAOA,MAAA;AAAA;;UAIe,UAAA;EACf,IAAA;IACE,KAAA;IACA,WAAA,UAHa;IAKb,GAAA,UALuB;IAOvB,SAAA;IACA,MAAA,GAAS,UAAA,EAWE;IATX,MAAA;EAAA;EATF;EAYA,OAAA;IACE,IAAA,EAAM,WAAA;IACN,GAAA;IACA,QAAA;IACA,MAAA;EAAA;EAEF,WAAA,EAAa,gBAAA;EACb,KAAA;IACE,MAAA,YAPM;IASN,GAAA,iBAPA;IASA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA;IACA,GAAA;IACA,OAAA;IACA,OAAA;IACA,IAAA;IACA,WAAA;EAAA;EAEF,GAAA;IACE,SAAA,WAJA;IAMA,OAAA;IACA,MAAA,WAHA;IAKA,YAAA;EAAA;AAAA;;UAKa,OAAA;EACf,EAAA;EACA,IAAA;;EAEA,KAAA;AAAA;;UAIe,IAAA;EAJV;EAML,IAAA;EACA,IAAA;EAHmB;EAKnB,GAAA;EACA,KAAA;EACA,WAAA;EAJA;EAMA,IAAA;EAHA;EAKA,OAAA;EACA,IAAA;EACA,QAAA;EADA;EAGA,KAAA;EAAA;EAEA,OAAA;EACA,KAAA;EACA,KAAA;EACA,MAAA;EAEA;EAAA,OAAA;EACA,kBAAA;EAGA;EADA,IAAA;EACA,GAAA,EAAK,OAAO;EAEL;EAAP,OAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EAAA;EAEA,GAAA;EACA,QAAA,EAAU,OAAO;AAAA;;UAIF,aAAA;EACf,KAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA;EACA,MAAA;EACA,MAAA;EACA,aAAA;EACA,YAAA;EACA,OAAA;EACA,IAAA;AAAA;;UAIe,WAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;EACA,KAAA;EACA,WAAA;EACA,MAAA;AAAA;;UAIe,OAAA;EACf,KAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA,GAAY,aAAA;EACZ,OAAA,GAAU,WAAA;EATJ;EAWN,MAAA,GAAS,MAAA;AAAA;AAAA,cAGE,cAAA,EAAgB,UAyC5B"}

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** Author metadata attached to a site or post. */\nexport interface VoxxAuthor {\n  name: string;\n  url?: string;\n}\n\n/** The rendering mode for a content collection. */\nexport type ContentType = \"blog\" | \"docs\" | \"changelog\";\n\n/** A resolved content collection with all defaults applied. */\nexport interface CollectionConfig {\n  name: string;\n  type: ContentType;\n  /** Filesystem path to the content directory. */\n  dir: string;\n  /** URL prefix for all posts in this collection. */\n  basePath: string;\n  /** Whether draft posts are included by default. */\n  drafts: boolean;\n}\n\n/** Resolved Voxx configuration merged from `voxx.json` and defaults. */\nexport interface VoxxConfig {\n  site: {\n    title: string;\n    description: string;\n    /** Canonical origin, e.g. `https://example.com`. */\n    url: string;\n    author?: VoxxAuthor;\n    /** BCP 47 locale tag, e.g. `en-US`. */\n    locale: string;\n  };\n  /** Primary content collection (mirrors `collections[0]`). */\n  content: {\n    type: ContentType;\n    dir: string;\n    basePath: string;\n    drafts: boolean;\n  };\n  collections: CollectionConfig[];\n  theme: {\n    preset: \"shadcn\";\n    /** Path to a custom CSS file, or `null` to use the preset default. */\n    css: string | null;\n    /** One or two Shiki theme names separated by a space (light dark). */\n    codeTheme: string;\n  };\n  features: {\n    toc: boolean;\n    rss: boolean;\n    sitemap: boolean;\n    llmsTxt: boolean;\n    tags: boolean;\n    readingTime: boolean;\n  };\n  seo: {\n    openGraph: boolean;\n    /** Twitter/X handle including `@`, or `null` to omit. */\n    twitter: string | null;\n    jsonLd: boolean;\n    /** Fallback OG image path relative to the site root. */\n    defaultImage: string | null;\n  };\n}\n\n/** A single entry in a page's table of contents. */\nexport interface TocItem {\n  id: string;\n  text: string;\n  /** Heading level — `2` for `h2`, `3` for `h3`. */\n  depth: number;\n}\n\n/** A fully processed content post ready to render. */\nexport interface Post {\n  /** Final path segment(s), e.g. `[\"getting-started\", \"install\"]`. */\n  slug: string;\n  path: string[];\n  /** Absolute URL path, e.g. `/blog/my-post`. */\n  url: string;\n  title: string;\n  description?: string;\n  /** ISO 8601 publish date. */\n  date: string;\n  /** ISO 8601 last-modified date. */\n  updated?: string;\n  tags: string[];\n  category?: string;\n  /** Sort order within the parent directory (docs only). */\n  order?: number;\n  /** Semver string extracted from the filename or frontmatter (changelog only). */\n  version?: string;\n  draft: boolean;\n  image?: string;\n  author?: string;\n  /** Plain-text excerpt derived from the first 180 characters of content. */\n  excerpt: string;\n  readingTimeMinutes: number;\n  /** Rendered HTML string. */\n  html: string;\n  toc: TocItem[];\n  /** Raw Markdown source. */\n  content: string;\n}\n\n/** A node in the sidebar navigation tree. */\nexport interface NavNode {\n  title: string;\n  /** Present on leaf nodes; absent on category nodes. */\n  url?: string;\n  children: NavNode[];\n}\n\n/** Open Graph article metadata. */\nexport interface OpenGraphData {\n  title: string;\n  description: string;\n  url: string;\n  type: \"article\";\n  siteName: string;\n  locale: string;\n  images: string[];\n  publishedTime?: string;\n  modifiedTime?: string;\n  authors: string[];\n  tags: string[];\n}\n\n/** Twitter card metadata. */\nexport interface TwitterData {\n  card: \"summary_large_image\";\n  site?: string;\n  creator?: string;\n  title: string;\n  description: string;\n  images: string[];\n}\n\n/** Aggregated SEO metadata for a single page. */\nexport interface SeoData {\n  title: string;\n  description: string;\n  canonical: string;\n  openGraph?: OpenGraphData;\n  twitter?: TwitterData;\n  /** JSON-LD structured data object — serialize with `serializeJsonLd`. */\n  jsonLd?: Record<string, unknown>;\n}\n\nexport const DEFAULT_CONFIG: VoxxConfig = {\n  site: {\n    title: \"Blog\",\n    description: \"\",\n    url: \"\",\n    locale: \"en-US\",\n  },\n  content: {\n    type: \"blog\",\n    dir: \"content/blog\",\n    basePath: \"/blog\",\n    drafts: false,\n  },\n  collections: [\n    {\n      name: \"blog\",\n      type: \"blog\",\n      dir: \"content/blog\",\n      basePath: \"/blog\",\n      drafts: false,\n    },\n  ],\n  theme: {\n    preset: \"shadcn\",\n    css: null,\n    codeTheme: \"github-light github-dark\",\n  },\n  features: {\n    toc: true,\n    rss: true,\n    sitemap: true,\n    llmsTxt: true,\n    tags: true,\n    readingTime: true,\n  },\n  seo: {\n    openGraph: true,\n    twitter: null,\n    jsonLd: true,\n    defaultImage: null,\n  },\n};\n"],"mappings":";AAqJA,MAAa,iBAA6B;CACxC,MAAM;EACJ,OAAO;EACP,aAAa;EACb,KAAK;EACL,QAAQ;CACV;CACA,SAAS;EACP,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV;CACA,aAAa,CACX;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV,CACF;CACA,OAAO;EACL,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,UAAU;EACR,KAAK;EACL,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;EACN,aAAa;CACf;CACA,KAAK;EACH,WAAW;EACX,SAAS;EACT,QAAQ;EACR,cAAc;CAChB;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** Author metadata attached to a site or post. */\nexport interface VoxxAuthor {\n  name: string;\n  url?: string;\n}\n\n/** The rendering mode for a content collection. */\nexport type ContentType = \"blog\" | \"docs\" | \"changelog\";\n\n/** A resolved content collection with all defaults applied. */\nexport interface CollectionConfig {\n  name: string;\n  type: ContentType;\n  /** Filesystem path to the content directory. */\n  dir: string;\n  /** URL prefix for all posts in this collection. */\n  basePath: string;\n  /** Whether draft posts are included by default. */\n  drafts: boolean;\n}\n\n/** Resolved Voxx configuration merged from `voxx.json` and defaults. */\nexport interface VoxxConfig {\n  site: {\n    title: string;\n    description: string;\n    /** Canonical origin, e.g. `https://example.com`. */\n    url: string;\n    /** Link target for the header / sidebar title. Falls back to the collection `basePath` when unset. Distinct from `url`, which is the canonical origin used for SEO. */\n    titleHref?: string;\n    author?: VoxxAuthor;\n    /** BCP 47 locale tag, e.g. `en-US`. */\n    locale: string;\n  };\n  /** Primary content collection (mirrors `collections[0]`). */\n  content: {\n    type: ContentType;\n    dir: string;\n    basePath: string;\n    drafts: boolean;\n  };\n  collections: CollectionConfig[];\n  theme: {\n    preset: \"shadcn\";\n    /** Path to a custom CSS file, or `null` to use the preset default. */\n    css: string | null;\n    /** One or two Shiki theme names separated by a space (light dark). */\n    codeTheme: string;\n  };\n  features: {\n    toc: boolean;\n    rss: boolean;\n    sitemap: boolean;\n    llmsTxt: boolean;\n    tags: boolean;\n    readingTime: boolean;\n  };\n  seo: {\n    openGraph: boolean;\n    /** Twitter/X handle including `@`, or `null` to omit. */\n    twitter: string | null;\n    jsonLd: boolean;\n    /** Fallback OG image path relative to the site root. */\n    defaultImage: string | null;\n  };\n}\n\n/** A single entry in a page's table of contents. */\nexport interface TocItem {\n  id: string;\n  text: string;\n  /** Heading level — `2` for `h2`, `3` for `h3`. */\n  depth: number;\n}\n\n/** A fully processed content post ready to render. */\nexport interface Post {\n  /** Final path segment(s), e.g. `[\"getting-started\", \"install\"]`. */\n  slug: string;\n  path: string[];\n  /** Absolute URL path, e.g. `/blog/my-post`. */\n  url: string;\n  title: string;\n  description?: string;\n  /** ISO 8601 publish date. */\n  date: string;\n  /** ISO 8601 last-modified date. */\n  updated?: string;\n  tags: string[];\n  category?: string;\n  /** Sort order within the parent directory (docs only). */\n  order?: number;\n  /** Semver string extracted from the filename or frontmatter (changelog only). */\n  version?: string;\n  draft: boolean;\n  image?: string;\n  author?: string;\n  /** Plain-text excerpt derived from the first 180 characters of content. */\n  excerpt: string;\n  readingTimeMinutes: number;\n  /** Rendered HTML string. */\n  html: string;\n  toc: TocItem[];\n  /** Raw Markdown source. */\n  content: string;\n}\n\n/** A node in the sidebar navigation tree. */\nexport interface NavNode {\n  title: string;\n  /** Present on leaf nodes; absent on category nodes. */\n  url?: string;\n  children: NavNode[];\n}\n\n/** Open Graph article metadata. */\nexport interface OpenGraphData {\n  title: string;\n  description: string;\n  url: string;\n  type: \"article\";\n  siteName: string;\n  locale: string;\n  images: string[];\n  publishedTime?: string;\n  modifiedTime?: string;\n  authors: string[];\n  tags: string[];\n}\n\n/** Twitter card metadata. */\nexport interface TwitterData {\n  card: \"summary_large_image\";\n  site?: string;\n  creator?: string;\n  title: string;\n  description: string;\n  images: string[];\n}\n\n/** Aggregated SEO metadata for a single page. */\nexport interface SeoData {\n  title: string;\n  description: string;\n  canonical: string;\n  openGraph?: OpenGraphData;\n  twitter?: TwitterData;\n  /** JSON-LD structured data object — serialize with `serializeJsonLd`. */\n  jsonLd?: Record<string, unknown>;\n}\n\nexport const DEFAULT_CONFIG: VoxxConfig = {\n  site: {\n    title: \"Blog\",\n    description: \"\",\n    url: \"\",\n    locale: \"en-US\",\n  },\n  content: {\n    type: \"blog\",\n    dir: \"content/blog\",\n    basePath: \"/blog\",\n    drafts: false,\n  },\n  collections: [\n    {\n      name: \"blog\",\n      type: \"blog\",\n      dir: \"content/blog\",\n      basePath: \"/blog\",\n      drafts: false,\n    },\n  ],\n  theme: {\n    preset: \"shadcn\",\n    css: null,\n    codeTheme: \"github-light github-dark\",\n  },\n  features: {\n    toc: true,\n    rss: true,\n    sitemap: true,\n    llmsTxt: true,\n    tags: true,\n    readingTime: true,\n  },\n  seo: {\n    openGraph: true,\n    twitter: null,\n    jsonLd: true,\n    defaultImage: null,\n  },\n};\n"],"mappings":";AAuJA,MAAa,iBAA6B;CACxC,MAAM;EACJ,OAAO;EACP,aAAa;EACb,KAAK;EACL,QAAQ;CACV;CACA,SAAS;EACP,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV;CACA,aAAa,CACX;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,UAAU;EACV,QAAQ;CACV,CACF;CACA,OAAO;EACL,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,UAAU;EACR,KAAK;EACL,KAAK;EACL,SAAS;EACT,SAAS;EACT,MAAM;EACN,aAAa;CACf;CACA,KAAK;EACH,WAAW;EACX,SAAS;EACT,QAAQ;EACR,cAAc;CAChB;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prudentbird/voxx-core",
-  "version": "1.0.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,12 +98,11 @@
     "@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",
-    "@voxx/typescript-config": "0.0.1",
-    "@voxx/eslint-config": "0.0.1"
+    "@voxx/eslint-config": "0.0.1",
+    "@voxx/typescript-config": "0.0.1"
   },
   "scripts": {
     "build": "tsdown && node ./scripts/gen-schema.ts",

package/theme/voxx.css

@@ -365,11 +365,32 @@
 }
 
 .voxx-article {
-  max-width: 44rem;
+  max-width: 45rem;
   margin: 0 auto;
   min-width: 0;
 }
 
+.voxx-article__back {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  margin-bottom: 1.5rem;
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--muted-foreground, var(--voxx-muted-fg));
+  text-decoration: none;
+  transition: color 0.15s ease;
+}
+
+.voxx-article__back:hover {
+  color: var(--foreground, var(--voxx-fg));
+}
+
+.voxx-article__back svg {
+  width: 1rem;
+  height: 1rem;
+}
+
 .voxx-article__header {
   margin-bottom: 2.5rem;
 }
@@ -406,10 +427,6 @@
   .voxx-layout {
     grid-template-columns: minmax(0, 1fr) 16rem;
   }
-
-  .voxx-article {
-    margin: 0;
-  }
 }
 
 .voxx-aside {
@@ -428,7 +445,7 @@
 }
 
 .voxx-index {
-  max-width: 44rem;
+  max-width: 45rem;
   margin: 0 auto;
   padding: 3.5rem 1.5rem 5rem;
 }
@@ -547,8 +564,6 @@
 .voxx-docs {
   display: grid;
   grid-template-columns: minmax(0, 1fr);
-  max-width: 90rem;
-  margin: 0 auto;
   min-height: 100dvh;
 }
 
@@ -558,6 +573,11 @@
   }
 }
 
+.voxx-docs .voxx-layout {
+  max-width: none;
+  margin: 0;
+}
+
 .voxx-docs__nav-header {
   display: flex;
   align-items: center;

package/voxx.schema.json

@@ -22,6 +22,9 @@
         "url": {
           "type": "string"
         },
+        "titleHref": {
+          "type": "string"
+        },
         "author": {
           "type": "object",
           "required": [