@prudentbird/voxx-core 1.0.0

package/dist/frontmatter.cjs

@@ -0,0 +1,22 @@
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_schema = require("./schema.cjs");
+const require_errors = require("./errors.cjs");
+let effect = require("effect");
+let gray_matter = require("gray-matter");
+gray_matter = require_runtime.__toESM(gray_matter, 1);
+//#region src/frontmatter.ts
+const parseFrontmatter = (file, raw) => effect.Effect.gen(function* () {
+	const parsed = (0, gray_matter.default)(raw);
+	return {
+		data: yield* effect.Schema.decodeUnknown(require_schema.Frontmatter)(parsed.data).pipe(effect.Effect.mapError((cause) => new require_errors.InvalidFrontmatter({
+			file,
+			message: effect.ParseResult.TreeFormatter.formatErrorSync(cause),
+			cause
+		}))),
+		content: parsed.content
+	};
+});
+//#endregion
+exports.parseFrontmatter = parseFrontmatter;
+
+//# sourceMappingURL=frontmatter.cjs.map

package/dist/frontmatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.cjs","names":["Effect","Schema","Frontmatter","InvalidFrontmatter","ParseResult"],"sources":["../src/frontmatter.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport matter from \"gray-matter\";\nimport { Frontmatter, type FrontmatterData } from \"./schema\";\nimport { InvalidFrontmatter } from \"./errors\";\n\nexport interface ParsedFile {\n  data: FrontmatterData;\n  content: string;\n}\n\nexport const parseFrontmatter = (file: string, raw: string) =>\n  Effect.gen(function* () {\n    const parsed = matter(raw);\n    const data = yield* Schema.decodeUnknown(Frontmatter)(parsed.data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new InvalidFrontmatter({\n            file,\n            message: ParseResult.TreeFormatter.formatErrorSync(cause),\n            cause,\n          }),\n      ),\n    );\n    return { data, content: parsed.content } satisfies ParsedFile;\n  });\n"],"mappings":";;;;;;;AAUA,MAAa,oBAAoB,MAAc,QAC7CA,OAAAA,OAAO,IAAI,aAAa;CACtB,MAAM,UAAA,GAAA,YAAA,QAAA,CAAgB,GAAG;CAWzB,OAAO;EAAE,MAAA,OAVWC,OAAAA,OAAO,cAAcC,eAAAA,WAAW,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KACjEF,OAAAA,OAAO,UACJ,UACC,IAAIG,eAAAA,mBAAmB;GACrB;GACA,SAASC,OAAAA,YAAY,cAAc,gBAAgB,KAAK;GACxD;EACF,CAAC,CACL,CACF;EACe,SAAS,OAAO;CAAQ;AACzC,CAAC"}

package/dist/frontmatter.d.cts

@@ -0,0 +1,30 @@
+import { InvalidFrontmatter } from "./errors.cjs";
+import { FrontmatterData } from "./schema.cjs";
+import { Effect } from "effect";
+
+//#region src/frontmatter.d.ts
+interface ParsedFile {
+  data: FrontmatterData;
+  content: string;
+}
+declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
+  data: {
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly date?: string | undefined;
+    readonly updated?: string | undefined;
+    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;
+    readonly author?: string | undefined;
+    readonly excerpt?: string | undefined;
+  };
+  content: string;
+}, InvalidFrontmatter, never>;
+//#endregion
+export { ParsedFile, parseFrontmatter };
+//# sourceMappingURL=frontmatter.d.cts.map

package/dist/frontmatter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.cts","names":[],"sources":["../src/frontmatter.ts"],"mappings":";;;;;UAKiB,UAAA;EACf,IAAA,EAAM,eAAe;EACrB,OAAA;AAAA;AAAA,cAGW,gBAAA,GAAoB,IAAA,UAAc,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;GActD,kBAAA"}

package/dist/frontmatter.d.mts

@@ -0,0 +1,30 @@
+import { InvalidFrontmatter } from "./errors.mjs";
+import { FrontmatterData } from "./schema.mjs";
+import { Effect } from "effect";
+
+//#region src/frontmatter.d.ts
+interface ParsedFile {
+  data: FrontmatterData;
+  content: string;
+}
+declare const parseFrontmatter: (file: string, raw: string) => Effect.Effect<{
+  data: {
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly date?: string | undefined;
+    readonly updated?: string | undefined;
+    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;
+    readonly author?: string | undefined;
+    readonly excerpt?: string | undefined;
+  };
+  content: string;
+}, InvalidFrontmatter, never>;
+//#endregion
+export { ParsedFile, parseFrontmatter };
+//# sourceMappingURL=frontmatter.d.mts.map

package/dist/frontmatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.mts","names":[],"sources":["../src/frontmatter.ts"],"mappings":";;;;;UAKiB,UAAA;EACf,IAAA,EAAM,eAAe;EACrB,OAAA;AAAA;AAAA,cAGW,gBAAA,GAAoB,IAAA,UAAc,GAAA,aAAW,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;GActD,kBAAA"}

package/dist/frontmatter.mjs

@@ -0,0 +1,20 @@
+import { Frontmatter } from "./schema.mjs";
+import { InvalidFrontmatter } from "./errors.mjs";
+import { Effect, ParseResult, Schema } from "effect";
+import matter from "gray-matter";
+//#region src/frontmatter.ts
+const parseFrontmatter = (file, raw) => Effect.gen(function* () {
+	const parsed = matter(raw);
+	return {
+		data: yield* Schema.decodeUnknown(Frontmatter)(parsed.data).pipe(Effect.mapError((cause) => new InvalidFrontmatter({
+			file,
+			message: ParseResult.TreeFormatter.formatErrorSync(cause),
+			cause
+		}))),
+		content: parsed.content
+	};
+});
+//#endregion
+export { parseFrontmatter };
+
+//# sourceMappingURL=frontmatter.mjs.map

package/dist/frontmatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.mjs","names":[],"sources":["../src/frontmatter.ts"],"sourcesContent":["import { Effect, ParseResult, Schema } from \"effect\";\nimport matter from \"gray-matter\";\nimport { Frontmatter, type FrontmatterData } from \"./schema\";\nimport { InvalidFrontmatter } from \"./errors\";\n\nexport interface ParsedFile {\n  data: FrontmatterData;\n  content: string;\n}\n\nexport const parseFrontmatter = (file: string, raw: string) =>\n  Effect.gen(function* () {\n    const parsed = matter(raw);\n    const data = yield* Schema.decodeUnknown(Frontmatter)(parsed.data).pipe(\n      Effect.mapError(\n        (cause) =>\n          new InvalidFrontmatter({\n            file,\n            message: ParseResult.TreeFormatter.formatErrorSync(cause),\n            cause,\n          }),\n      ),\n    );\n    return { data, content: parsed.content } satisfies ParsedFile;\n  });\n"],"mappings":";;;;;AAUA,MAAa,oBAAoB,MAAc,QAC7C,OAAO,IAAI,aAAa;CACtB,MAAM,SAAS,OAAO,GAAG;CAWzB,OAAO;EAAE,MAAA,OAVW,OAAO,cAAc,WAAW,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KACjE,OAAO,UACJ,UACC,IAAI,mBAAmB;GACrB;GACA,SAAS,YAAY,cAAc,gBAAgB,KAAK;GACxD;EACF,CAAC,CACL,CACF;EACe,SAAS,OAAO;CAAQ;AACzC,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,90 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_types = require("./types.cjs");
+const require_config = require("./config.cjs");
+const require_render = require("./render.cjs");
+const require_util = require("./util.cjs");
+const require_content = require("./content.cjs");
+const require_seo = require("./seo.cjs");
+const require_feeds = require("./feeds.cjs");
+const require_llms = require("./llms.cjs");
+const require_dev = require("./dev.cjs");
+const require_nav = require("./nav.cjs");
+let effect = require("effect");
+let _effect_platform_node = require("@effect/platform-node");
+//#region src/index.ts
+const run = (effect$1) => effect.Effect.runPromise(effect.Effect.provide(effect$1, _effect_platform_node.NodeContext.layer));
+/**
+* Reads and validates `voxx.json` from disk.
+*
+* @param opts - Optional `cwd` or explicit config file `path`.
+* @returns Fully resolved `VoxxConfig`.
+*/
+function loadConfig(opts) {
+	return run(require_config.loadConfigEffect(opts));
+}
+/**
+* Returns all published posts for the active collection, sorted by the
+* collection type's natural order (date, semver, or manual order prefix).
+*
+* @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+*/
+function getPosts(opts = {}) {
+	return run(effect.Effect.gen(function* () {
+		return yield* require_content.getPostsEffect(opts.config ?? (yield* require_config.loadConfigEffect(opts)), opts);
+	}));
+}
+/**
+* Returns a single post by slug.
+*
+* @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+* @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+* @throws `PostNotFound` if no matching post exists.
+*/
+function getPost(slug, opts = {}) {
+	return run(effect.Effect.gen(function* () {
+		return yield* require_content.getPostEffect(opts.config ?? (yield* require_config.loadConfigEffect(opts)), slug, opts);
+	}));
+}
+/**
+* Converts a Markdown string to HTML with syntax highlighting and TOC extraction.
+*
+* @param markdown - Raw Markdown source.
+* @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.
+*/
+function renderMarkdown(markdown, config = require_types.DEFAULT_CONFIG) {
+	return run(require_render.renderMarkdownEffect(markdown, config));
+}
+//#endregion
+exports.DEFAULT_CONFIG = require_types.DEFAULT_CONFIG;
+exports.absoluteUrl = require_util.absoluteUrl;
+exports.buildNavTree = require_nav.buildNavTree;
+exports.buildSeo = require_seo.buildSeo;
+exports.compareVersions = require_util.compareVersions;
+exports.deriveExcerpt = require_util.deriveExcerpt;
+exports.escapeXml = require_util.escapeXml;
+exports.findPost = require_content.findPost;
+exports.formatDate = require_util.formatDate;
+exports.getPost = getPost;
+exports.getPosts = getPosts;
+exports.humanize = require_util.humanize;
+exports.joinPath = require_util.joinPath;
+exports.loadConfig = loadConfig;
+exports.parseVersion = require_util.parseVersion;
+exports.readingTimeMinutes = require_util.readingTimeMinutes;
+exports.registerContentWatcher = require_dev.registerContentWatcher;
+exports.renderLlmsFull = require_llms.renderLlmsFull;
+exports.renderLlmsTxt = require_llms.renderLlmsTxt;
+exports.renderLlmsTxtSections = require_llms.renderLlmsTxtSections;
+exports.renderMarkdown = renderMarkdown;
+exports.renderRobotsTxt = require_feeds.renderRobotsTxt;
+exports.renderRss = require_feeds.renderRss;
+exports.renderSitemap = require_feeds.renderSitemap;
+exports.resolveCollectionDefaults = require_config.resolveCollectionDefaults;
+exports.rssPath = require_feeds.rssPath;
+exports.sectionHeading = require_llms.sectionHeading;
+exports.serializeJsonLd = require_util.serializeJsonLd;
+exports.slugify = require_util.slugify;
+exports.splitDatePrefix = require_util.splitDatePrefix;
+exports.splitOrderPrefix = require_util.splitOrderPrefix;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Effect","effect","NodeContext","loadConfigEffect","getPostsEffect","getPostEffect","DEFAULT_CONFIG","renderMarkdownEffect"],"sources":["../src/index.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { NodeContext } from \"@effect/platform-node\";\nimport { loadConfigEffect, type LoadConfigOptions } from \"./config\";\nimport {\n  getPostEffect,\n  getPostsEffect,\n  type GetPostsEffectOptions,\n} from \"./content\";\nimport { renderMarkdownEffect, type RenderResult } from \"./render\";\nimport { DEFAULT_CONFIG, type Post, type VoxxConfig } from \"./types\";\n\ntype Services = FileSystem.FileSystem | Path.Path;\n\nconst run = <A, E>(effect: Effect.Effect<A, E, Services>): Promise<A> =>\n  Effect.runPromise(Effect.provide(effect, NodeContext.layer));\n\n/** Options accepted by `getPosts` and `getPost`. */\nexport interface GetPostsOptions\n  extends GetPostsEffectOptions, LoadConfigOptions {\n  /** Pre-loaded config — skips reading `voxx.json` when provided. */\n  config?: VoxxConfig;\n}\n\n/**\n * Reads and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit config file `path`.\n * @returns Fully resolved `VoxxConfig`.\n */\nexport function loadConfig(opts?: LoadConfigOptions): Promise<VoxxConfig> {\n  return run(loadConfigEffect(opts));\n}\n\n/**\n * Returns all published posts for the active collection, sorted by the\n * collection type's natural order (date, semver, or manual order prefix).\n *\n * @param opts - Collection filter, draft visibility, and optional pre-loaded config.\n */\nexport function getPosts(opts: GetPostsOptions = {}): Promise<Post[]> {\n  return run(\n    Effect.gen(function* () {\n      const config = opts.config ?? (yield* loadConfigEffect(opts));\n      return yield* getPostsEffect(config, opts);\n    }),\n  );\n}\n\n/**\n * Returns a single post by slug.\n *\n * @param slug - Slash-separated path, e.g. `\"getting-started/install\"`.\n * @param opts - Collection filter, draft visibility, and optional pre-loaded config.\n * @throws `PostNotFound` if no matching post exists.\n */\nexport function getPost(\n  slug: string,\n  opts: GetPostsOptions = {},\n): Promise<Post> {\n  return run(\n    Effect.gen(function* () {\n      const config = opts.config ?? (yield* loadConfigEffect(opts));\n      return yield* getPostEffect(config, slug, opts);\n    }),\n  );\n}\n\n/**\n * Converts a Markdown string to HTML with syntax highlighting and TOC extraction.\n *\n * @param markdown - Raw Markdown source.\n * @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.\n */\nexport function renderMarkdown(\n  markdown: string,\n  config: VoxxConfig = DEFAULT_CONFIG,\n): Promise<RenderResult> {\n  return run(renderMarkdownEffect(markdown, config));\n}\n\nexport { buildSeo } from \"./seo\";\nexport { renderRss, renderSitemap, renderRobotsTxt, rssPath } from \"./feeds\";\nexport type { RenderRssOptions, RenderSitemapOptions } from \"./feeds\";\nexport {\n  renderLlmsTxt,\n  renderLlmsTxtSections,\n  renderLlmsFull,\n  sectionHeading,\n} from \"./llms\";\nexport type { LlmsSection } from \"./llms\";\nexport { findPost } from \"./content\";\nexport { registerContentWatcher } from \"./dev\";\nexport type { ContentWatcherOptions } from \"./dev\";\nexport { buildNavTree } from \"./nav\";\nexport { DEFAULT_CONFIG } from \"./types\";\nexport {\n  slugify,\n  joinPath,\n  absoluteUrl,\n  readingTimeMinutes,\n  deriveExcerpt,\n  splitDatePrefix,\n  splitOrderPrefix,\n  humanize,\n  formatDate,\n  parseVersion,\n  compareVersions,\n  escapeXml,\n  serializeJsonLd,\n} from \"./util\";\n\nexport type {\n  VoxxConfig,\n  VoxxAuthor,\n  ContentType,\n  CollectionConfig,\n  Post,\n  TocItem,\n  NavNode,\n  SeoData,\n  OpenGraphData,\n  TwitterData,\n} from \"./types\";\nexport type { RenderResult } from \"./render\";\nexport { resolveCollectionDefaults } from \"./config\";\nexport type { CollectionInput, LoadConfigOptions } from \"./config\";\nexport type {\n  ConfigError,\n  InvalidFrontmatter,\n  PostNotFound,\n  ContentDirMissing,\n  RenderError,\n  VoxxError,\n} from \"./errors\";\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAM,OAAa,aACjBA,OAAAA,OAAO,WAAWA,OAAAA,OAAO,QAAQC,UAAQC,sBAAAA,YAAY,KAAK,CAAC;;;;;;;AAe7D,SAAgB,WAAW,MAA+C;CACxE,OAAO,IAAIC,eAAAA,iBAAiB,IAAI,CAAC;AACnC;;;;;;;AAQA,SAAgB,SAAS,OAAwB,CAAC,GAAoB;CACpE,OAAO,IACLH,OAAAA,OAAO,IAAI,aAAa;EAEtB,OAAO,OAAOI,gBAAAA,eADC,KAAK,WAAW,OAAOD,eAAAA,iBAAiB,IAAI,IACtB,IAAI;CAC3C,CAAC,CACH;AACF;;;;;;;;AASA,SAAgB,QACd,MACA,OAAwB,CAAC,GACV;CACf,OAAO,IACLH,OAAAA,OAAO,IAAI,aAAa;EAEtB,OAAO,OAAOK,gBAAAA,cADC,KAAK,WAAW,OAAOF,eAAAA,iBAAiB,IAAI,IACvB,MAAM,IAAI;CAChD,CAAC,CACH;AACF;;;;;;;AAQA,SAAgB,eACd,UACA,SAAqBG,cAAAA,gBACE;CACvB,OAAO,IAAIC,eAAAA,qBAAqB,UAAU,MAAM,CAAC;AACnD"}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError } from "./errors.cjs";
+import { CollectionConfig, ContentType, DEFAULT_CONFIG, NavNode, OpenGraphData, Post, SeoData, TocItem, TwitterData, VoxxAuthor, VoxxConfig } from "./types.cjs";
+import { CollectionInput, LoadConfigOptions, resolveCollectionDefaults } from "./config.cjs";
+import { GetPostsEffectOptions, findPost } from "./content.cjs";
+import { RenderResult } from "./render.cjs";
+import { buildSeo } from "./seo.cjs";
+import { RenderRssOptions, RenderSitemapOptions, renderRobotsTxt, renderRss, renderSitemap, rssPath } from "./feeds.cjs";
+import { LlmsSection, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading } from "./llms.cjs";
+import { ContentWatcherOptions, registerContentWatcher } from "./dev.cjs";
+import { buildNavTree } from "./nav.cjs";
+import { absoluteUrl, compareVersions, deriveExcerpt, escapeXml, formatDate, humanize, joinPath, parseVersion, readingTimeMinutes, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix } from "./util.cjs";
+
+//#region src/index.d.ts
+/** Options accepted by `getPosts` and `getPost`. */
+interface GetPostsOptions extends GetPostsEffectOptions, LoadConfigOptions {
+  /** Pre-loaded config — skips reading `voxx.json` when provided. */
+  config?: VoxxConfig;
+}
+/**
+ * Reads and validates `voxx.json` from disk.
+ *
+ * @param opts - Optional `cwd` or explicit config file `path`.
+ * @returns Fully resolved `VoxxConfig`.
+ */
+declare function loadConfig(opts?: LoadConfigOptions): Promise<VoxxConfig>;
+/**
+ * Returns all published posts for the active collection, sorted by the
+ * collection type's natural order (date, semver, or manual order prefix).
+ *
+ * @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+ */
+declare function getPosts(opts?: GetPostsOptions): Promise<Post[]>;
+/**
+ * Returns a single post by slug.
+ *
+ * @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+ * @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+ * @throws `PostNotFound` if no matching post exists.
+ */
+declare function getPost(slug: string, opts?: GetPostsOptions): Promise<Post>;
+/**
+ * Converts a Markdown string to HTML with syntax highlighting and TOC extraction.
+ *
+ * @param markdown - Raw Markdown source.
+ * @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.
+ */
+declare function renderMarkdown(markdown: string, config?: VoxxConfig): Promise<RenderResult>;
+//#endregion
+export { type CollectionConfig, type CollectionInput, type ConfigError, type ContentDirMissing, type ContentType, type ContentWatcherOptions, DEFAULT_CONFIG, GetPostsOptions, type InvalidFrontmatter, type LlmsSection, type LoadConfigOptions, type NavNode, type OpenGraphData, type Post, type PostNotFound, type RenderError, type RenderResult, type RenderRssOptions, type RenderSitemapOptions, type SeoData, type TocItem, type TwitterData, type VoxxAuthor, type VoxxConfig, type VoxxError, absoluteUrl, buildNavTree, buildSeo, compareVersions, deriveExcerpt, escapeXml, findPost, formatDate, getPost, getPosts, humanize, joinPath, loadConfig, parseVersion, readingTimeMinutes, registerContentWatcher, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, renderMarkdown, renderRobotsTxt, renderRss, renderSitemap, resolveCollectionDefaults, rssPath, sectionHeading, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;UAkBiB,eAAA,SACP,qBAAA,EAAuB,iBAAA;;EAE/B,MAAA,GAAS,UAAA;AAAA;;;;;AAHX;;iBAYgB,UAAA,CAAW,IAAA,GAAO,iBAAA,GAAoB,OAAA,CAAQ,UAAA;;;;;;;iBAU9C,QAAA,CAAS,IAAA,GAAM,eAAA,GAAuB,OAAA,CAAQ,IAAA;;;;AAnBzC;AASrB;;;iBA0BgB,OAAA,CACd,IAAA,UACA,IAAA,GAAM,eAAA,GACL,OAAA,CAAQ,IAAA;;;;;;;iBAeK,cAAA,CACd,QAAA,UACA,MAAA,GAAQ,UAAA,GACP,OAAA,CAAQ,YAAA"}

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError } from "./errors.mjs";
+import { CollectionConfig, ContentType, DEFAULT_CONFIG, NavNode, OpenGraphData, Post, SeoData, TocItem, TwitterData, VoxxAuthor, VoxxConfig } from "./types.mjs";
+import { CollectionInput, LoadConfigOptions, resolveCollectionDefaults } from "./config.mjs";
+import { GetPostsEffectOptions, findPost } from "./content.mjs";
+import { RenderResult } from "./render.mjs";
+import { buildSeo } from "./seo.mjs";
+import { RenderRssOptions, RenderSitemapOptions, renderRobotsTxt, renderRss, renderSitemap, rssPath } from "./feeds.mjs";
+import { LlmsSection, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading } from "./llms.mjs";
+import { ContentWatcherOptions, registerContentWatcher } from "./dev.mjs";
+import { buildNavTree } from "./nav.mjs";
+import { absoluteUrl, compareVersions, deriveExcerpt, escapeXml, formatDate, humanize, joinPath, parseVersion, readingTimeMinutes, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix } from "./util.mjs";
+
+//#region src/index.d.ts
+/** Options accepted by `getPosts` and `getPost`. */
+interface GetPostsOptions extends GetPostsEffectOptions, LoadConfigOptions {
+  /** Pre-loaded config — skips reading `voxx.json` when provided. */
+  config?: VoxxConfig;
+}
+/**
+ * Reads and validates `voxx.json` from disk.
+ *
+ * @param opts - Optional `cwd` or explicit config file `path`.
+ * @returns Fully resolved `VoxxConfig`.
+ */
+declare function loadConfig(opts?: LoadConfigOptions): Promise<VoxxConfig>;
+/**
+ * Returns all published posts for the active collection, sorted by the
+ * collection type's natural order (date, semver, or manual order prefix).
+ *
+ * @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+ */
+declare function getPosts(opts?: GetPostsOptions): Promise<Post[]>;
+/**
+ * Returns a single post by slug.
+ *
+ * @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+ * @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+ * @throws `PostNotFound` if no matching post exists.
+ */
+declare function getPost(slug: string, opts?: GetPostsOptions): Promise<Post>;
+/**
+ * Converts a Markdown string to HTML with syntax highlighting and TOC extraction.
+ *
+ * @param markdown - Raw Markdown source.
+ * @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.
+ */
+declare function renderMarkdown(markdown: string, config?: VoxxConfig): Promise<RenderResult>;
+//#endregion
+export { type CollectionConfig, type CollectionInput, type ConfigError, type ContentDirMissing, type ContentType, type ContentWatcherOptions, DEFAULT_CONFIG, GetPostsOptions, type InvalidFrontmatter, type LlmsSection, type LoadConfigOptions, type NavNode, type OpenGraphData, type Post, type PostNotFound, type RenderError, type RenderResult, type RenderRssOptions, type RenderSitemapOptions, type SeoData, type TocItem, type TwitterData, type VoxxAuthor, type VoxxConfig, type VoxxError, absoluteUrl, buildNavTree, buildSeo, compareVersions, deriveExcerpt, escapeXml, findPost, formatDate, getPost, getPosts, humanize, joinPath, loadConfig, parseVersion, readingTimeMinutes, registerContentWatcher, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, renderMarkdown, renderRobotsTxt, renderRss, renderSitemap, resolveCollectionDefaults, rssPath, sectionHeading, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;UAkBiB,eAAA,SACP,qBAAA,EAAuB,iBAAA;;EAE/B,MAAA,GAAS,UAAA;AAAA;;;;;AAHX;;iBAYgB,UAAA,CAAW,IAAA,GAAO,iBAAA,GAAoB,OAAA,CAAQ,UAAA;;;;;;;iBAU9C,QAAA,CAAS,IAAA,GAAM,eAAA,GAAuB,OAAA,CAAQ,IAAA;;;;AAnBzC;AASrB;;;iBA0BgB,OAAA,CACd,IAAA,UACA,IAAA,GAAM,eAAA,GACL,OAAA,CAAQ,IAAA;;;;;;;iBAeK,cAAA,CACd,QAAA,UACA,MAAA,GAAQ,UAAA,GACP,OAAA,CAAQ,YAAA"}

package/dist/index.mjs

@@ -0,0 +1,59 @@
+import { DEFAULT_CONFIG } from "./types.mjs";
+import { loadConfigEffect, resolveCollectionDefaults } from "./config.mjs";
+import { renderMarkdownEffect } from "./render.mjs";
+import { absoluteUrl, compareVersions, deriveExcerpt, escapeXml, formatDate, humanize, joinPath, parseVersion, readingTimeMinutes, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix } from "./util.mjs";
+import { findPost, getPostEffect, getPostsEffect } from "./content.mjs";
+import { buildSeo } from "./seo.mjs";
+import { renderRobotsTxt, renderRss, renderSitemap, rssPath } from "./feeds.mjs";
+import { renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading } from "./llms.mjs";
+import { registerContentWatcher } from "./dev.mjs";
+import { buildNavTree } from "./nav.mjs";
+import { Effect } from "effect";
+import { NodeContext } from "@effect/platform-node";
+//#region src/index.ts
+const run = (effect) => Effect.runPromise(Effect.provide(effect, NodeContext.layer));
+/**
+* Reads and validates `voxx.json` from disk.
+*
+* @param opts - Optional `cwd` or explicit config file `path`.
+* @returns Fully resolved `VoxxConfig`.
+*/
+function loadConfig(opts) {
+	return run(loadConfigEffect(opts));
+}
+/**
+* Returns all published posts for the active collection, sorted by the
+* collection type's natural order (date, semver, or manual order prefix).
+*
+* @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+*/
+function getPosts(opts = {}) {
+	return run(Effect.gen(function* () {
+		return yield* getPostsEffect(opts.config ?? (yield* loadConfigEffect(opts)), opts);
+	}));
+}
+/**
+* Returns a single post by slug.
+*
+* @param slug - Slash-separated path, e.g. `"getting-started/install"`.
+* @param opts - Collection filter, draft visibility, and optional pre-loaded config.
+* @throws `PostNotFound` if no matching post exists.
+*/
+function getPost(slug, opts = {}) {
+	return run(Effect.gen(function* () {
+		return yield* getPostEffect(opts.config ?? (yield* loadConfigEffect(opts)), slug, opts);
+	}));
+}
+/**
+* Converts a Markdown string to HTML with syntax highlighting and TOC extraction.
+*
+* @param markdown - Raw Markdown source.
+* @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.
+*/
+function renderMarkdown(markdown, config = DEFAULT_CONFIG) {
+	return run(renderMarkdownEffect(markdown, config));
+}
+//#endregion
+export { DEFAULT_CONFIG, absoluteUrl, buildNavTree, buildSeo, compareVersions, deriveExcerpt, escapeXml, findPost, formatDate, getPost, getPosts, humanize, joinPath, loadConfig, parseVersion, readingTimeMinutes, registerContentWatcher, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, renderMarkdown, renderRobotsTxt, renderRss, renderSitemap, resolveCollectionDefaults, rssPath, sectionHeading, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { NodeContext } from \"@effect/platform-node\";\nimport { loadConfigEffect, type LoadConfigOptions } from \"./config\";\nimport {\n  getPostEffect,\n  getPostsEffect,\n  type GetPostsEffectOptions,\n} from \"./content\";\nimport { renderMarkdownEffect, type RenderResult } from \"./render\";\nimport { DEFAULT_CONFIG, type Post, type VoxxConfig } from \"./types\";\n\ntype Services = FileSystem.FileSystem | Path.Path;\n\nconst run = <A, E>(effect: Effect.Effect<A, E, Services>): Promise<A> =>\n  Effect.runPromise(Effect.provide(effect, NodeContext.layer));\n\n/** Options accepted by `getPosts` and `getPost`. */\nexport interface GetPostsOptions\n  extends GetPostsEffectOptions, LoadConfigOptions {\n  /** Pre-loaded config — skips reading `voxx.json` when provided. */\n  config?: VoxxConfig;\n}\n\n/**\n * Reads and validates `voxx.json` from disk.\n *\n * @param opts - Optional `cwd` or explicit config file `path`.\n * @returns Fully resolved `VoxxConfig`.\n */\nexport function loadConfig(opts?: LoadConfigOptions): Promise<VoxxConfig> {\n  return run(loadConfigEffect(opts));\n}\n\n/**\n * Returns all published posts for the active collection, sorted by the\n * collection type's natural order (date, semver, or manual order prefix).\n *\n * @param opts - Collection filter, draft visibility, and optional pre-loaded config.\n */\nexport function getPosts(opts: GetPostsOptions = {}): Promise<Post[]> {\n  return run(\n    Effect.gen(function* () {\n      const config = opts.config ?? (yield* loadConfigEffect(opts));\n      return yield* getPostsEffect(config, opts);\n    }),\n  );\n}\n\n/**\n * Returns a single post by slug.\n *\n * @param slug - Slash-separated path, e.g. `\"getting-started/install\"`.\n * @param opts - Collection filter, draft visibility, and optional pre-loaded config.\n * @throws `PostNotFound` if no matching post exists.\n */\nexport function getPost(\n  slug: string,\n  opts: GetPostsOptions = {},\n): Promise<Post> {\n  return run(\n    Effect.gen(function* () {\n      const config = opts.config ?? (yield* loadConfigEffect(opts));\n      return yield* getPostEffect(config, slug, opts);\n    }),\n  );\n}\n\n/**\n * Converts a Markdown string to HTML with syntax highlighting and TOC extraction.\n *\n * @param markdown - Raw Markdown source.\n * @param config - Voxx config (controls code theme). Defaults to `DEFAULT_CONFIG`.\n */\nexport function renderMarkdown(\n  markdown: string,\n  config: VoxxConfig = DEFAULT_CONFIG,\n): Promise<RenderResult> {\n  return run(renderMarkdownEffect(markdown, config));\n}\n\nexport { buildSeo } from \"./seo\";\nexport { renderRss, renderSitemap, renderRobotsTxt, rssPath } from \"./feeds\";\nexport type { RenderRssOptions, RenderSitemapOptions } from \"./feeds\";\nexport {\n  renderLlmsTxt,\n  renderLlmsTxtSections,\n  renderLlmsFull,\n  sectionHeading,\n} from \"./llms\";\nexport type { LlmsSection } from \"./llms\";\nexport { findPost } from \"./content\";\nexport { registerContentWatcher } from \"./dev\";\nexport type { ContentWatcherOptions } from \"./dev\";\nexport { buildNavTree } from \"./nav\";\nexport { DEFAULT_CONFIG } from \"./types\";\nexport {\n  slugify,\n  joinPath,\n  absoluteUrl,\n  readingTimeMinutes,\n  deriveExcerpt,\n  splitDatePrefix,\n  splitOrderPrefix,\n  humanize,\n  formatDate,\n  parseVersion,\n  compareVersions,\n  escapeXml,\n  serializeJsonLd,\n} from \"./util\";\n\nexport type {\n  VoxxConfig,\n  VoxxAuthor,\n  ContentType,\n  CollectionConfig,\n  Post,\n  TocItem,\n  NavNode,\n  SeoData,\n  OpenGraphData,\n  TwitterData,\n} from \"./types\";\nexport type { RenderResult } from \"./render\";\nexport { resolveCollectionDefaults } from \"./config\";\nexport type { CollectionInput, LoadConfigOptions } from \"./config\";\nexport type {\n  ConfigError,\n  InvalidFrontmatter,\n  PostNotFound,\n  ContentDirMissing,\n  RenderError,\n  VoxxError,\n} from \"./errors\";\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAM,OAAa,WACjB,OAAO,WAAW,OAAO,QAAQ,QAAQ,YAAY,KAAK,CAAC;;;;;;;AAe7D,SAAgB,WAAW,MAA+C;CACxE,OAAO,IAAI,iBAAiB,IAAI,CAAC;AACnC;;;;;;;AAQA,SAAgB,SAAS,OAAwB,CAAC,GAAoB;CACpE,OAAO,IACL,OAAO,IAAI,aAAa;EAEtB,OAAO,OAAO,eADC,KAAK,WAAW,OAAO,iBAAiB,IAAI,IACtB,IAAI;CAC3C,CAAC,CACH;AACF;;;;;;;;AASA,SAAgB,QACd,MACA,OAAwB,CAAC,GACV;CACf,OAAO,IACL,OAAO,IAAI,aAAa;EAEtB,OAAO,OAAO,cADC,KAAK,WAAW,OAAO,iBAAiB,IAAI,IACvB,MAAM,IAAI;CAChD,CAAC,CACH;AACF;;;;;;;AAQA,SAAgB,eACd,UACA,SAAqB,gBACE;CACvB,OAAO,IAAI,qBAAqB,UAAU,MAAM,CAAC;AACnD"}

package/dist/llms.cjs

@@ -0,0 +1,81 @@
+const require_util = require("./util.cjs");
+//#region src/llms.ts
+const SECTION_HEADING = {
+	blog: "Posts",
+	docs: "Pages",
+	changelog: "Releases"
+};
+const oneLine = (s) => s.replace(/\s*\n\s*/g, " ").trim();
+const escLinkText = (s) => oneLine(s).replace(/([[\]])/g, "\\$1");
+const escHeading = (s) => oneLine(s);
+/**
+* Returns the default section heading for a content type.
+*
+* @param type - Content type from the Voxx config.
+* @returns Human-readable heading, e.g. `"Posts"`, `"Pages"`, `"Releases"`.
+*/
+function sectionHeading(type) {
+	return SECTION_HEADING[type];
+}
+/**
+* Renders a `llms.txt` file from one or more labeled post sections.
+*
+* @param sections - Ordered list of headings with their associated posts.
+* @param config - Resolved Voxx config (used for site title and description).
+* @returns `llms.txt` Markdown string.
+*/
+function renderLlmsTxtSections(sections, config) {
+	const lines = [`# ${config.site.title}`, ""];
+	if (config.site.description) lines.push(`> ${config.site.description}`, "");
+	for (const section of sections) {
+		lines.push(`## ${section.heading}`, "");
+		for (const p of section.posts) {
+			const link = require_util.absoluteUrl(config.site.url, p.url);
+			const summary = p.description ?? p.excerpt;
+			const title = escLinkText(p.title);
+			const safeSummary = summary ? oneLine(summary) : "";
+			lines.push(`- [${title}](${link})${safeSummary ? `: ${safeSummary}` : ""}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Renders a `llms.txt` index linking all posts with one-line summaries.
+*
+* @param posts - All posts to include.
+* @param config - Resolved Voxx config.
+* @returns `llms.txt` Markdown string.
+*/
+function renderLlmsTxt(posts, config) {
+	return renderLlmsTxtSections([{
+		heading: SECTION_HEADING[config.content.type],
+		posts
+	}], config);
+}
+/**
+* Renders an `llms-full.txt` file containing the complete Markdown content
+* of every post, separated by `---` dividers.
+*
+* @param posts - All posts to include.
+* @param config - Resolved Voxx config.
+* @returns Full-content `llms-full.txt` string.
+*/
+function renderLlmsFull(posts, config) {
+	const out = [`# ${config.site.title}`, ""];
+	if (config.site.description) out.push(config.site.description, "");
+	for (const p of posts) {
+		const link = require_util.absoluteUrl(config.site.url, p.url);
+		out.push("---", "", `# ${escHeading(p.title)}`, "", `Source: ${link}`, `Date: ${p.date}`);
+		if (p.tags.length) out.push(`Tags: ${p.tags.join(", ")}`);
+		out.push("", p.content.trim(), "");
+	}
+	return out.join("\n");
+}
+//#endregion
+exports.renderLlmsFull = renderLlmsFull;
+exports.renderLlmsTxt = renderLlmsTxt;
+exports.renderLlmsTxtSections = renderLlmsTxtSections;
+exports.sectionHeading = sectionHeading;
+
+//# sourceMappingURL=llms.cjs.map

package/dist/llms.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.cjs","names":["absoluteUrl"],"sources":["../src/llms.ts"],"sourcesContent":["import { absoluteUrl } from \"./util\";\nimport type { ContentType, Post, VoxxConfig } from \"./types\";\n\nconst SECTION_HEADING: Record<ContentType, string> = {\n  blog: \"Posts\",\n  docs: \"Pages\",\n  changelog: \"Releases\",\n};\n\nconst oneLine = (s: string) => s.replace(/\\s*\\n\\s*/g, \" \").trim();\nconst escLinkText = (s: string) => oneLine(s).replace(/([[\\]])/g, \"\\\\$1\");\nconst escHeading = (s: string) => oneLine(s);\n\n/** A titled group of posts for use in `renderLlmsTxtSections`. */\nexport interface LlmsSection {\n  heading: string;\n  posts: Post[];\n}\n\n/**\n * Returns the default section heading for a content type.\n *\n * @param type - Content type from the Voxx config.\n * @returns Human-readable heading, e.g. `\"Posts\"`, `\"Pages\"`, `\"Releases\"`.\n */\nexport function sectionHeading(type: ContentType): string {\n  return SECTION_HEADING[type];\n}\n\n/**\n * Renders a `llms.txt` file from one or more labeled post sections.\n *\n * @param sections - Ordered list of headings with their associated posts.\n * @param config - Resolved Voxx config (used for site title and description).\n * @returns `llms.txt` Markdown string.\n */\nexport function renderLlmsTxtSections(\n  sections: LlmsSection[],\n  config: VoxxConfig,\n): string {\n  const lines: string[] = [`# ${config.site.title}`, \"\"];\n  if (config.site.description) lines.push(`> ${config.site.description}`, \"\");\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`, \"\");\n    for (const p of section.posts) {\n      const link = absoluteUrl(config.site.url, p.url);\n      const summary = p.description ?? p.excerpt;\n      const title = escLinkText(p.title);\n      const safeSummary = summary ? oneLine(summary) : \"\";\n      lines.push(\n        `- [${title}](${link})${safeSummary ? `: ${safeSummary}` : \"\"}`,\n      );\n    }\n    lines.push(\"\");\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Renders a `llms.txt` index linking all posts with one-line summaries.\n *\n * @param posts - All posts to include.\n * @param config - Resolved Voxx config.\n * @returns `llms.txt` Markdown string.\n */\nexport function renderLlmsTxt(posts: Post[], config: VoxxConfig): string {\n  return renderLlmsTxtSections(\n    [{ heading: SECTION_HEADING[config.content.type], posts }],\n    config,\n  );\n}\n\n/**\n * Renders an `llms-full.txt` file containing the complete Markdown content\n * of every post, separated by `---` dividers.\n *\n * @param posts - All posts to include.\n * @param config - Resolved Voxx config.\n * @returns Full-content `llms-full.txt` string.\n */\nexport function renderLlmsFull(posts: Post[], config: VoxxConfig): string {\n  const out: string[] = [`# ${config.site.title}`, \"\"];\n  if (config.site.description) out.push(config.site.description, \"\");\n  for (const p of posts) {\n    const link = absoluteUrl(config.site.url, p.url);\n    out.push(\n      \"---\",\n      \"\",\n      `# ${escHeading(p.title)}`,\n      \"\",\n      `Source: ${link}`,\n      `Date: ${p.date}`,\n    );\n    if (p.tags.length) out.push(`Tags: ${p.tags.join(\", \")}`);\n    out.push(\"\", p.content.trim(), \"\");\n  }\n  return out.join(\"\\n\");\n}\n"],"mappings":";;AAGA,MAAM,kBAA+C;CACnD,MAAM;CACN,MAAM;CACN,WAAW;AACb;AAEA,MAAM,WAAW,MAAc,EAAE,QAAQ,aAAa,GAAG,CAAC,CAAC,KAAK;AAChE,MAAM,eAAe,MAAc,QAAQ,CAAC,CAAC,CAAC,QAAQ,YAAY,MAAM;AACxE,MAAM,cAAc,MAAc,QAAQ,CAAC;;;;;;;AAc3C,SAAgB,eAAe,MAA2B;CACxD,OAAO,gBAAgB;AACzB;;;;;;;;AASA,SAAgB,sBACd,UACA,QACQ;CACR,MAAM,QAAkB,CAAC,KAAK,OAAO,KAAK,SAAS,EAAE;CACrD,IAAI,OAAO,KAAK,aAAa,MAAM,KAAK,KAAK,OAAO,KAAK,eAAe,EAAE;CAC1E,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,KAAK,MAAM,QAAQ,WAAW,EAAE;EACtC,KAAK,MAAM,KAAK,QAAQ,OAAO;GAC7B,MAAM,OAAOA,aAAAA,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;GAC/C,MAAM,UAAU,EAAE,eAAe,EAAE;GACnC,MAAM,QAAQ,YAAY,EAAE,KAAK;GACjC,MAAM,cAAc,UAAU,QAAQ,OAAO,IAAI;GACjD,MAAM,KACJ,MAAM,MAAM,IAAI,KAAK,GAAG,cAAc,KAAK,gBAAgB,IAC7D;EACF;EACA,MAAM,KAAK,EAAE;CACf;CACA,OAAO,MAAM,KAAK,IAAI;AACxB;;;;;;;;AASA,SAAgB,cAAc,OAAe,QAA4B;CACvE,OAAO,sBACL,CAAC;EAAE,SAAS,gBAAgB,OAAO,QAAQ;EAAO;CAAM,CAAC,GACzD,MACF;AACF;;;;;;;;;AAUA,SAAgB,eAAe,OAAe,QAA4B;CACxE,MAAM,MAAgB,CAAC,KAAK,OAAO,KAAK,SAAS,EAAE;CACnD,IAAI,OAAO,KAAK,aAAa,IAAI,KAAK,OAAO,KAAK,aAAa,EAAE;CACjE,KAAK,MAAM,KAAK,OAAO;EACrB,MAAM,OAAOA,aAAAA,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EAC/C,IAAI,KACF,OACA,IACA,KAAK,WAAW,EAAE,KAAK,KACvB,IACA,WAAW,QACX,SAAS,EAAE,MACb;EACA,IAAI,EAAE,KAAK,QAAQ,IAAI,KAAK,SAAS,EAAE,KAAK,KAAK,IAAI,GAAG;EACxD,IAAI,KAAK,IAAI,EAAE,QAAQ,KAAK,GAAG,EAAE;CACnC;CACA,OAAO,IAAI,KAAK,IAAI;AACtB"}

package/dist/llms.d.cts

@@ -0,0 +1,43 @@
+import { ContentType, Post, VoxxConfig } from "./types.cjs";
+
+//#region src/llms.d.ts
+/** A titled group of posts for use in `renderLlmsTxtSections`. */
+interface LlmsSection {
+  heading: string;
+  posts: Post[];
+}
+/**
+ * Returns the default section heading for a content type.
+ *
+ * @param type - Content type from the Voxx config.
+ * @returns Human-readable heading, e.g. `"Posts"`, `"Pages"`, `"Releases"`.
+ */
+declare function sectionHeading(type: ContentType): string;
+/**
+ * Renders a `llms.txt` file from one or more labeled post sections.
+ *
+ * @param sections - Ordered list of headings with their associated posts.
+ * @param config - Resolved Voxx config (used for site title and description).
+ * @returns `llms.txt` Markdown string.
+ */
+declare function renderLlmsTxtSections(sections: LlmsSection[], config: VoxxConfig): string;
+/**
+ * Renders a `llms.txt` index linking all posts with one-line summaries.
+ *
+ * @param posts - All posts to include.
+ * @param config - Resolved Voxx config.
+ * @returns `llms.txt` Markdown string.
+ */
+declare function renderLlmsTxt(posts: Post[], config: VoxxConfig): string;
+/**
+ * Renders an `llms-full.txt` file containing the complete Markdown content
+ * of every post, separated by `---` dividers.
+ *
+ * @param posts - All posts to include.
+ * @param config - Resolved Voxx config.
+ * @returns Full-content `llms-full.txt` string.
+ */
+declare function renderLlmsFull(posts: Post[], config: VoxxConfig): string;
+//#endregion
+export { LlmsSection, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading };
+//# sourceMappingURL=llms.d.cts.map

package/dist/llms.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.cts","names":[],"sources":["../src/llms.ts"],"mappings":";;;;UAciB,WAAA;EACf,OAAA;EACA,KAAA,EAAO,IAAI;AAAA;;;;;;AAAA;iBASG,cAAA,CAAe,IAAiB,EAAX,WAAW;;;;AAAA;AAWhD;;;iBAAgB,qBAAA,CACd,QAAA,EAAU,WAAA,IACV,MAAA,EAAQ,UAAU;;;;;;AAAA;AA2BpB;iBAAgB,aAAA,CAAc,KAAA,EAAO,IAAA,IAAQ,MAAA,EAAQ,UAAU;;;;;;;;AAAA;iBAe/C,cAAA,CAAe,KAAA,EAAO,IAAA,IAAQ,MAAA,EAAQ,UAAU"}

package/dist/llms.d.mts

@@ -0,0 +1,43 @@
+import { ContentType, Post, VoxxConfig } from "./types.mjs";
+
+//#region src/llms.d.ts
+/** A titled group of posts for use in `renderLlmsTxtSections`. */
+interface LlmsSection {
+  heading: string;
+  posts: Post[];
+}
+/**
+ * Returns the default section heading for a content type.
+ *
+ * @param type - Content type from the Voxx config.
+ * @returns Human-readable heading, e.g. `"Posts"`, `"Pages"`, `"Releases"`.
+ */
+declare function sectionHeading(type: ContentType): string;
+/**
+ * Renders a `llms.txt` file from one or more labeled post sections.
+ *
+ * @param sections - Ordered list of headings with their associated posts.
+ * @param config - Resolved Voxx config (used for site title and description).
+ * @returns `llms.txt` Markdown string.
+ */
+declare function renderLlmsTxtSections(sections: LlmsSection[], config: VoxxConfig): string;
+/**
+ * Renders a `llms.txt` index linking all posts with one-line summaries.
+ *
+ * @param posts - All posts to include.
+ * @param config - Resolved Voxx config.
+ * @returns `llms.txt` Markdown string.
+ */
+declare function renderLlmsTxt(posts: Post[], config: VoxxConfig): string;
+/**
+ * Renders an `llms-full.txt` file containing the complete Markdown content
+ * of every post, separated by `---` dividers.
+ *
+ * @param posts - All posts to include.
+ * @param config - Resolved Voxx config.
+ * @returns Full-content `llms-full.txt` string.
+ */
+declare function renderLlmsFull(posts: Post[], config: VoxxConfig): string;
+//#endregion
+export { LlmsSection, renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading };
+//# sourceMappingURL=llms.d.mts.map

package/dist/llms.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.mts","names":[],"sources":["../src/llms.ts"],"mappings":";;;;UAciB,WAAA;EACf,OAAA;EACA,KAAA,EAAO,IAAI;AAAA;;;;;;AAAA;iBASG,cAAA,CAAe,IAAiB,EAAX,WAAW;;;;AAAA;AAWhD;;;iBAAgB,qBAAA,CACd,QAAA,EAAU,WAAA,IACV,MAAA,EAAQ,UAAU;;;;;;AAAA;AA2BpB;iBAAgB,aAAA,CAAc,KAAA,EAAO,IAAA,IAAQ,MAAA,EAAQ,UAAU;;;;;;;;AAAA;iBAe/C,cAAA,CAAe,KAAA,EAAO,IAAA,IAAQ,MAAA,EAAQ,UAAU"}