content-query 0.0.2 → 0.2.0

package/dist/errors-C2iuBM0G.mjs

@@ -0,0 +1,72 @@
+//#region src/shared/errors.ts
+const contentErrorBrand = Symbol.for("content-query.error");
+/** A contextual library failure; inspect code and diagnostics instead of message text. */
+var ContentError = class extends Error {
+	/** Recognizes contextual errors across preparation and separately bundled loader modules. */
+	static [Symbol.hasInstance](value) {
+		return !!value && typeof value === "object" && value[contentErrorBrand] === true;
+	}
+	code;
+	operation;
+	collection;
+	id;
+	source;
+	path;
+	issues;
+	diagnostics;
+	/** Creates one failure or a grouped report preserving individual causes and issues. */
+	constructor(options) {
+		super(options.message, { cause: options.cause });
+		Object.defineProperty(this, contentErrorBrand, { value: true });
+		this.name = "ContentError";
+		this.code = options.code;
+		this.operation = options.operation;
+		this.collection = options.collection;
+		this.id = options.id;
+		this.source = options.source;
+		this.path = options.path;
+		this.issues = options.issues;
+		this.diagnostics = options.diagnostics ?? [{ ...options }];
+	}
+};
+/** Rejects invalid query structure before any execution or payload access. */
+function invalidQuery(message) {
+	throw new ContentError({
+		code: "invalid-query",
+		operation: "query",
+		message
+	});
+}
+/** Converts an acquisition/processing failure without discarding contextual library errors. */
+function contentError(cause, context) {
+	return cause instanceof ContentError ? cause : new ContentError({
+		...context,
+		cause
+	});
+}
+/** Describes a foreign failure for diagnostic text while its original remains the cause. */
+function describeCause(cause) {
+	return cause instanceof Error ? cause.message : String(cause);
+}
+/** Groups independent diagnostics under the primary code while preserving every report. */
+function groupDiagnostics(diagnostics) {
+	return new ContentError({
+		...diagnostics[0],
+		diagnostics,
+		message: diagnostics.map((diagnostic) => diagnostic.message).join("\n")
+	});
+}
+/** Adds missing operation/collection context to each diagnostic, keeping codes and causes. */
+function withContext(cause, context) {
+	return groupDiagnostics((cause instanceof ContentError ? cause : new ContentError({
+		...context,
+		message: `${context.message}: ${describeCause(cause)}`,
+		cause
+	})).diagnostics.map((diagnostic) => ({
+		...diagnostic,
+		operation: diagnostic.operation ?? context.operation,
+		collection: diagnostic.collection ?? context.collection
+	})));
+}
+//#endregion
+export { invalidQuery as a, groupDiagnostics as i, contentError as n, withContext as o, describeCause as r, ContentError as t };

package/dist/github-slugger-BMgR_Q0I.mjs

@@ -0,0 +1,72 @@
+//#region ../../node_modules/.pnpm/github-slugger@2.0.0/node_modules/github-slugger/regex.js
+const regex = /[\0-\x1F!-,\.\/:-@\[-\^`\{-\xA9\xAB-\xB4\xB6-\xB9\xBB-\xBF\xD7\xF7\u02C2-\u02C5\u02D2-\u02DF\u02E5-\u02EB\u02ED\u02EF-\u02FF\u0375\u0378\u0379\u037E\u0380-\u0385\u0387\u038B\u038D\u03A2\u03F6\u0482\u0530\u0557\u0558\u055A-\u055F\u0589-\u0590\u05BE\u05C0\u05C3\u05C6\u05C8-\u05CF\u05EB-\u05EE\u05F3-\u060F\u061B-\u061F\u066A-\u066D\u06D4\u06DD\u06DE\u06E9\u06FD\u06FE\u0700-\u070F\u074B\u074C\u07B2-\u07BF\u07F6-\u07F9\u07FB\u07FC\u07FE\u07FF\u082E-\u083F\u085C-\u085F\u086B-\u089F\u08B5\u08C8-\u08D2\u08E2\u0964\u0965\u0970\u0984\u098D\u098E\u0991\u0992\u09A9\u09B1\u09B3-\u09B5\u09BA\u09BB\u09C5\u09C6\u09C9\u09CA\u09CF-\u09D6\u09D8-\u09DB\u09DE\u09E4\u09E5\u09F2-\u09FB\u09FD\u09FF\u0A00\u0A04\u0A0B-\u0A0E\u0A11\u0A12\u0A29\u0A31\u0A34\u0A37\u0A3A\u0A3B\u0A3D\u0A43-\u0A46\u0A49\u0A4A\u0A4E-\u0A50\u0A52-\u0A58\u0A5D\u0A5F-\u0A65\u0A76-\u0A80\u0A84\u0A8E\u0A92\u0AA9\u0AB1\u0AB4\u0ABA\u0ABB\u0AC6\u0ACA\u0ACE\u0ACF\u0AD1-\u0ADF\u0AE4\u0AE5\u0AF0-\u0AF8\u0B00\u0B04\u0B0D\u0B0E\u0B11\u0B12\u0B29\u0B31\u0B34\u0B3A\u0B3B\u0B45\u0B46\u0B49\u0B4A\u0B4E-\u0B54\u0B58-\u0B5B\u0B5E\u0B64\u0B65\u0B70\u0B72-\u0B81\u0B84\u0B8B-\u0B8D\u0B91\u0B96-\u0B98\u0B9B\u0B9D\u0BA0-\u0BA2\u0BA5-\u0BA7\u0BAB-\u0BAD\u0BBA-\u0BBD\u0BC3-\u0BC5\u0BC9\u0BCE\u0BCF\u0BD1-\u0BD6\u0BD8-\u0BE5\u0BF0-\u0BFF\u0C0D\u0C11\u0C29\u0C3A-\u0C3C\u0C45\u0C49\u0C4E-\u0C54\u0C57\u0C5B-\u0C5F\u0C64\u0C65\u0C70-\u0C7F\u0C84\u0C8D\u0C91\u0CA9\u0CB4\u0CBA\u0CBB\u0CC5\u0CC9\u0CCE-\u0CD4\u0CD7-\u0CDD\u0CDF\u0CE4\u0CE5\u0CF0\u0CF3-\u0CFF\u0D0D\u0D11\u0D45\u0D49\u0D4F-\u0D53\u0D58-\u0D5E\u0D64\u0D65\u0D70-\u0D79\u0D80\u0D84\u0D97-\u0D99\u0DB2\u0DBC\u0DBE\u0DBF\u0DC7-\u0DC9\u0DCB-\u0DCE\u0DD5\u0DD7\u0DE0-\u0DE5\u0DF0\u0DF1\u0DF4-\u0E00\u0E3B-\u0E3F\u0E4F\u0E5A-\u0E80\u0E83\u0E85\u0E8B\u0EA4\u0EA6\u0EBE\u0EBF\u0EC5\u0EC7\u0ECE\u0ECF\u0EDA\u0EDB\u0EE0-\u0EFF\u0F01-\u0F17\u0F1A-\u0F1F\u0F2A-\u0F34\u0F36\u0F38\u0F3A-\u0F3D\u0F48\u0F6D-\u0F70\u0F85\u0F98\u0FBD-\u0FC5\u0FC7-\u0FFF\u104A-\u104F\u109E\u109F\u10C6\u10C8-\u10CC\u10CE\u10CF\u10FB\u1249\u124E\u124F\u1257\u1259\u125E\u125F\u1289\u128E\u128F\u12B1\u12B6\u12B7\u12BF\u12C1\u12C6\u12C7\u12D7\u1311\u1316\u1317\u135B\u135C\u1360-\u137F\u1390-\u139F\u13F6\u13F7\u13FE-\u1400\u166D\u166E\u1680\u169B-\u169F\u16EB-\u16ED\u16F9-\u16FF\u170D\u1715-\u171F\u1735-\u173F\u1754-\u175F\u176D\u1771\u1774-\u177F\u17D4-\u17D6\u17D8-\u17DB\u17DE\u17DF\u17EA-\u180A\u180E\u180F\u181A-\u181F\u1879-\u187F\u18AB-\u18AF\u18F6-\u18FF\u191F\u192C-\u192F\u193C-\u1945\u196E\u196F\u1975-\u197F\u19AC-\u19AF\u19CA-\u19CF\u19DA-\u19FF\u1A1C-\u1A1F\u1A5F\u1A7D\u1A7E\u1A8A-\u1A8F\u1A9A-\u1AA6\u1AA8-\u1AAF\u1AC1-\u1AFF\u1B4C-\u1B4F\u1B5A-\u1B6A\u1B74-\u1B7F\u1BF4-\u1BFF\u1C38-\u1C3F\u1C4A-\u1C4C\u1C7E\u1C7F\u1C89-\u1C8F\u1CBB\u1CBC\u1CC0-\u1CCF\u1CD3\u1CFB-\u1CFF\u1DFA\u1F16\u1F17\u1F1E\u1F1F\u1F46\u1F47\u1F4E\u1F4F\u1F58\u1F5A\u1F5C\u1F5E\u1F7E\u1F7F\u1FB5\u1FBD\u1FBF-\u1FC1\u1FC5\u1FCD-\u1FCF\u1FD4\u1FD5\u1FDC-\u1FDF\u1FED-\u1FF1\u1FF5\u1FFD-\u203E\u2041-\u2053\u2055-\u2070\u2072-\u207E\u2080-\u208F\u209D-\u20CF\u20F1-\u2101\u2103-\u2106\u2108\u2109\u2114\u2116-\u2118\u211E-\u2123\u2125\u2127\u2129\u212E\u213A\u213B\u2140-\u2144\u214A-\u214D\u214F-\u215F\u2189-\u24B5\u24EA-\u2BFF\u2C2F\u2C5F\u2CE5-\u2CEA\u2CF4-\u2CFF\u2D26\u2D28-\u2D2C\u2D2E\u2D2F\u2D68-\u2D6E\u2D70-\u2D7E\u2D97-\u2D9F\u2DA7\u2DAF\u2DB7\u2DBF\u2DC7\u2DCF\u2DD7\u2DDF\u2E00-\u2E2E\u2E30-\u3004\u3008-\u3020\u3030\u3036\u3037\u303D-\u3040\u3097\u3098\u309B\u309C\u30A0\u30FB\u3100-\u3104\u3130\u318F-\u319F\u31C0-\u31EF\u3200-\u33FF\u4DC0-\u4DFF\u9FFD-\u9FFF\uA48D-\uA4CF\uA4FE\uA4FF\uA60D-\uA60F\uA62C-\uA63F\uA673\uA67E\uA6F2-\uA716\uA720\uA721\uA789\uA78A\uA7C0\uA7C1\uA7CB-\uA7F4\uA828-\uA82B\uA82D-\uA83F\uA874-\uA87F\uA8C6-\uA8CF\uA8DA-\uA8DF\uA8F8-\uA8FA\uA8FC\uA92E\uA92F\uA954-\uA95F\uA97D-\uA97F\uA9C1-\uA9CE\uA9DA-\uA9DF\uA9FF\uAA37-\uAA3F\uAA4E\uAA4F\uAA5A-\uAA5F\uAA77-\uAA79\uAAC3-\uAADA\uAADE\uAADF\uAAF0\uAAF1\uAAF7-\uAB00\uAB07\uAB08\uAB0F\uAB10\uAB17-\uAB1F\uAB27\uAB2F\uAB5B\uAB6A-\uAB6F\uABEB\uABEE\uABEF\uABFA-\uABFF\uD7A4-\uD7AF\uD7C7-\uD7CA\uD7FC-\uD7FF\uE000-\uF8FF\uFA6E\uFA6F\uFADA-\uFAFF\uFB07-\uFB12\uFB18-\uFB1C\uFB29\uFB37\uFB3D\uFB3F\uFB42\uFB45\uFBB2-\uFBD2\uFD3E-\uFD4F\uFD90\uFD91\uFDC8-\uFDEF\uFDFC-\uFDFF\uFE10-\uFE1F\uFE30-\uFE32\uFE35-\uFE4C\uFE50-\uFE6F\uFE75\uFEFD-\uFF0F\uFF1A-\uFF20\uFF3B-\uFF3E\uFF40\uFF5B-\uFF65\uFFBF-\uFFC1\uFFC8\uFFC9\uFFD0\uFFD1\uFFD8\uFFD9\uFFDD-\uFFFF]|\uD800[\uDC0C\uDC27\uDC3B\uDC3E\uDC4E\uDC4F\uDC5E-\uDC7F\uDCFB-\uDD3F\uDD75-\uDDFC\uDDFE-\uDE7F\uDE9D-\uDE9F\uDED1-\uDEDF\uDEE1-\uDEFF\uDF20-\uDF2C\uDF4B-\uDF4F\uDF7B-\uDF7F\uDF9E\uDF9F\uDFC4-\uDFC7\uDFD0\uDFD6-\uDFFF]|\uD801[\uDC9E\uDC9F\uDCAA-\uDCAF\uDCD4-\uDCD7\uDCFC-\uDCFF\uDD28-\uDD2F\uDD64-\uDDFF\uDF37-\uDF3F\uDF56-\uDF5F\uDF68-\uDFFF]|\uD802[\uDC06\uDC07\uDC09\uDC36\uDC39-\uDC3B\uDC3D\uDC3E\uDC56-\uDC5F\uDC77-\uDC7F\uDC9F-\uDCDF\uDCF3\uDCF6-\uDCFF\uDD16-\uDD1F\uDD3A-\uDD7F\uDDB8-\uDDBD\uDDC0-\uDDFF\uDE04\uDE07-\uDE0B\uDE14\uDE18\uDE36\uDE37\uDE3B-\uDE3E\uDE40-\uDE5F\uDE7D-\uDE7F\uDE9D-\uDEBF\uDEC8\uDEE7-\uDEFF\uDF36-\uDF3F\uDF56-\uDF5F\uDF73-\uDF7F\uDF92-\uDFFF]|\uD803[\uDC49-\uDC7F\uDCB3-\uDCBF\uDCF3-\uDCFF\uDD28-\uDD2F\uDD3A-\uDE7F\uDEAA\uDEAD-\uDEAF\uDEB2-\uDEFF\uDF1D-\uDF26\uDF28-\uDF2F\uDF51-\uDFAF\uDFC5-\uDFDF\uDFF7-\uDFFF]|\uD804[\uDC47-\uDC65\uDC70-\uDC7E\uDCBB-\uDCCF\uDCE9-\uDCEF\uDCFA-\uDCFF\uDD35\uDD40-\uDD43\uDD48-\uDD4F\uDD74\uDD75\uDD77-\uDD7F\uDDC5-\uDDC8\uDDCD\uDDDB\uDDDD-\uDDFF\uDE12\uDE38-\uDE3D\uDE3F-\uDE7F\uDE87\uDE89\uDE8E\uDE9E\uDEA9-\uDEAF\uDEEB-\uDEEF\uDEFA-\uDEFF\uDF04\uDF0D\uDF0E\uDF11\uDF12\uDF29\uDF31\uDF34\uDF3A\uDF45\uDF46\uDF49\uDF4A\uDF4E\uDF4F\uDF51-\uDF56\uDF58-\uDF5C\uDF64\uDF65\uDF6D-\uDF6F\uDF75-\uDFFF]|\uD805[\uDC4B-\uDC4F\uDC5A-\uDC5D\uDC62-\uDC7F\uDCC6\uDCC8-\uDCCF\uDCDA-\uDD7F\uDDB6\uDDB7\uDDC1-\uDDD7\uDDDE-\uDDFF\uDE41-\uDE43\uDE45-\uDE4F\uDE5A-\uDE7F\uDEB9-\uDEBF\uDECA-\uDEFF\uDF1B\uDF1C\uDF2C-\uDF2F\uDF3A-\uDFFF]|\uD806[\uDC3B-\uDC9F\uDCEA-\uDCFE\uDD07\uDD08\uDD0A\uDD0B\uDD14\uDD17\uDD36\uDD39\uDD3A\uDD44-\uDD4F\uDD5A-\uDD9F\uDDA8\uDDA9\uDDD8\uDDD9\uDDE2\uDDE5-\uDDFF\uDE3F-\uDE46\uDE48-\uDE4F\uDE9A-\uDE9C\uDE9E-\uDEBF\uDEF9-\uDFFF]|\uD807[\uDC09\uDC37\uDC41-\uDC4F\uDC5A-\uDC71\uDC90\uDC91\uDCA8\uDCB7-\uDCFF\uDD07\uDD0A\uDD37-\uDD39\uDD3B\uDD3E\uDD48-\uDD4F\uDD5A-\uDD5F\uDD66\uDD69\uDD8F\uDD92\uDD99-\uDD9F\uDDAA-\uDEDF\uDEF7-\uDFAF\uDFB1-\uDFFF]|\uD808[\uDF9A-\uDFFF]|\uD809[\uDC6F-\uDC7F\uDD44-\uDFFF]|[\uD80A\uD80B\uD80E-\uD810\uD812-\uD819\uD824-\uD82B\uD82D\uD82E\uD830-\uD833\uD837\uD839\uD83D\uD83F\uD87B-\uD87D\uD87F\uD885-\uDB3F\uDB41-\uDBFF][\uDC00-\uDFFF]|\uD80D[\uDC2F-\uDFFF]|\uD811[\uDE47-\uDFFF]|\uD81A[\uDE39-\uDE3F\uDE5F\uDE6A-\uDECF\uDEEE\uDEEF\uDEF5-\uDEFF\uDF37-\uDF3F\uDF44-\uDF4F\uDF5A-\uDF62\uDF78-\uDF7C\uDF90-\uDFFF]|\uD81B[\uDC00-\uDE3F\uDE80-\uDEFF\uDF4B-\uDF4E\uDF88-\uDF8E\uDFA0-\uDFDF\uDFE2\uDFE5-\uDFEF\uDFF2-\uDFFF]|\uD821[\uDFF8-\uDFFF]|\uD823[\uDCD6-\uDCFF\uDD09-\uDFFF]|\uD82C[\uDD1F-\uDD4F\uDD53-\uDD63\uDD68-\uDD6F\uDEFC-\uDFFF]|\uD82F[\uDC6B-\uDC6F\uDC7D-\uDC7F\uDC89-\uDC8F\uDC9A-\uDC9C\uDC9F-\uDFFF]|\uD834[\uDC00-\uDD64\uDD6A-\uDD6C\uDD73-\uDD7A\uDD83\uDD84\uDD8C-\uDDA9\uDDAE-\uDE41\uDE45-\uDFFF]|\uD835[\uDC55\uDC9D\uDCA0\uDCA1\uDCA3\uDCA4\uDCA7\uDCA8\uDCAD\uDCBA\uDCBC\uDCC4\uDD06\uDD0B\uDD0C\uDD15\uDD1D\uDD3A\uDD3F\uDD45\uDD47-\uDD49\uDD51\uDEA6\uDEA7\uDEC1\uDEDB\uDEFB\uDF15\uDF35\uDF4F\uDF6F\uDF89\uDFA9\uDFC3\uDFCC\uDFCD]|\uD836[\uDC00-\uDDFF\uDE37-\uDE3A\uDE6D-\uDE74\uDE76-\uDE83\uDE85-\uDE9A\uDEA0\uDEB0-\uDFFF]|\uD838[\uDC07\uDC19\uDC1A\uDC22\uDC25\uDC2B-\uDCFF\uDD2D-\uDD2F\uDD3E\uDD3F\uDD4A-\uDD4D\uDD4F-\uDEBF\uDEFA-\uDFFF]|\uD83A[\uDCC5-\uDCCF\uDCD7-\uDCFF\uDD4C-\uDD4F\uDD5A-\uDFFF]|\uD83B[\uDC00-\uDDFF\uDE04\uDE20\uDE23\uDE25\uDE26\uDE28\uDE33\uDE38\uDE3A\uDE3C-\uDE41\uDE43-\uDE46\uDE48\uDE4A\uDE4C\uDE50\uDE53\uDE55\uDE56\uDE58\uDE5A\uDE5C\uDE5E\uDE60\uDE63\uDE65\uDE66\uDE6B\uDE73\uDE78\uDE7D\uDE7F\uDE8A\uDE9C-\uDEA0\uDEA4\uDEAA\uDEBC-\uDFFF]|\uD83C[\uDC00-\uDD2F\uDD4A-\uDD4F\uDD6A-\uDD6F\uDD8A-\uDFFF]|\uD83E[\uDC00-\uDFEF\uDFFA-\uDFFF]|\uD869[\uDEDE-\uDEFF]|\uD86D[\uDF35-\uDF3F]|\uD86E[\uDC1E\uDC1F]|\uD873[\uDEA2-\uDEAF]|\uD87A[\uDFE1-\uDFFF]|\uD87E[\uDE1E-\uDFFF]|\uD884[\uDF4B-\uDFFF]|\uDB40[\uDC00-\uDCFF\uDDF0-\uDFFF]/g;
+//#endregion
+//#region ../../node_modules/.pnpm/github-slugger@2.0.0/node_modules/github-slugger/index.js
+const own = Object.hasOwnProperty;
+/**
+* Slugger.
+*/
+var BananaSlug = class {
+	/**
+	* Create a new slug class.
+	*/
+	constructor() {
+		/** @type {Record<string, number>} */
+		this.occurrences;
+		this.reset();
+	}
+	/**
+	* Generate a unique slug.
+	*
+	* Tracks previously generated slugs: repeated calls with the same value
+	* will result in different slugs.
+	* Use the `slug` function to get same slugs.
+	*
+	* @param  {string} value
+	*   String of text to slugify
+	* @param  {boolean} [maintainCase=false]
+	*   Keep the current case, otherwise make all lowercase
+	* @return {string}
+	*   A unique slug string
+	*/
+	slug(value, maintainCase) {
+		const self = this;
+		let result = slug(value, maintainCase === true);
+		const originalSlug = result;
+		while (own.call(self.occurrences, result)) {
+			self.occurrences[originalSlug]++;
+			result = originalSlug + "-" + self.occurrences[originalSlug];
+		}
+		self.occurrences[result] = 0;
+		return result;
+	}
+	/**
+	* Reset - Forget all previous slugs
+	*
+	* @return void
+	*/
+	reset() {
+		this.occurrences = Object.create(null);
+	}
+};
+/**
+* Generate a slug.
+*
+* Does not track previously generated slugs: repeated calls with the same value
+* will result in the exact same slug.
+* Use the `GithubSlugger` class to get unique slugs.
+*
+* @param  {string} value
+*   String of text to slugify
+* @param  {boolean} [maintainCase=false]
+*   Keep the current case, otherwise make all lowercase
+* @return {string}
+*   A unique slug string
+*/
+function slug(value, maintainCase) {
+	if (typeof value !== "string") return "";
+	if (!maintainCase) value = value.toLowerCase();
+	return value.replace(regex, "").replace(/ /g, "-");
+}
+//#endregion
+export { slug as n, BananaSlug as t };

package/dist/glob-Bv0dpvCQ.mjs

@@ -0,0 +1,159 @@
+import { n as normalizeSnapshot, o as builtinPath, s as builtinSymbol } from "./validation-D_XdE1pF.mjs";
+import { i as groupDiagnostics, n as contentError, r as describeCause, t as ContentError } from "./errors-C2iuBM0G.mjs";
+import { n as slug } from "./github-slugger-BMgR_Q0I.mjs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { glob } from "tinyglobby";
+import matter from "gray-matter";
+import { parse } from "yaml";
+import { parse as parse$1 } from "smol-toml";
+//#region src/loaders/populate.ts
+/** Validates a complete built-in source before replacing its collection store. */
+async function populateStore(context, entries) {
+	normalizeSnapshot(entries, context.collection);
+	const results = await Promise.allSettled(entries.map(async (entry) => ({
+		id: entry.id,
+		data: await context.parseData({
+			id: entry.id,
+			data: entry.data,
+			filePath: entry.source
+		}),
+		...entry.body === void 0 ? {} : { body: entry.body },
+		...entry.rendered === void 0 ? {} : { rendered: entry.rendered },
+		...entry.source === void 0 ? {} : { filePath: entry.source },
+		...entry.sourceData === void 0 ? {} : { source: entry.sourceData }
+	})));
+	const failures = results.flatMap((result) => result.status === "rejected" ? result.reason.diagnostics : []);
+	if (failures.length) throw groupDiagnostics(failures);
+	context.store.clear();
+	for (const result of results) if (result.status === "fulfilled") context.store.set(result.value);
+}
+//#endregion
+//#region src/loaders/parse.ts
+/** Parses one of the built-in data formats without applying collection validation. */
+function parseData(text, filename) {
+	switch (path.extname(filename).toLowerCase()) {
+		case ".json": return JSON.parse(text);
+		case ".yaml":
+		case ".yml": return parse(text);
+		case ".toml": return parse$1(text);
+		default: throw new Error(`Unsupported data extension: ${path.extname(filename)}.`);
+	}
+}
+/** Checks the record boundary before identity normalization or Standard Schema validation. */
+function recordData(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value) || Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) throw new Error("Entry metadata must be a record.");
+	return value;
+}
+/** Follows Astro's deliberate String(value) normalization for transport identities. */
+function coerceIdentity(value) {
+	return String(value);
+}
+//#endregion
+//#region src/loaders/glob.ts
+/** Declares local files with Astro-style IDs and typed, project-relative source paths. */
+function glob$1(options) {
+	if (!options || !(typeof options.pattern === "string" || Array.isArray(options.pattern) && options.pattern.every((pattern) => typeof pattern === "string"))) throw new TypeError("glob() requires a string or string[] pattern.");
+	const descriptor = {
+		kind: "glob",
+		options
+	};
+	return {
+		[builtinSymbol]: descriptor,
+		name: "content-query/glob",
+		async load(context) {
+			await populateStore(context, await loadGlob(descriptor, fileURLToPath(context.config.root), context.signal ?? new AbortController().signal));
+		}
+	};
+}
+/** Captures complete matching Markdown and data sources before deployment. */
+async function loadGlob(descriptor, root, signal) {
+	const resolved = builtinPath(descriptor, root);
+	const entries = await glob(descriptor.options.pattern, {
+		cwd: resolved,
+		onlyFiles: true,
+		dot: false
+	});
+	if (entries.length === 0) console.warn(`[content-query] No content matched ${JSON.stringify(descriptor.options.pattern)} in ${resolved}.`);
+	const base = pathToFileURL(`${resolved}${path.sep}`);
+	entries.sort();
+	const results = [];
+	let next = 0;
+	/** Bounds outstanding reads while retaining source order and every contextual failure. */
+	async function loadNext() {
+		while (next < entries.length) {
+			const index = next++;
+			const entry = entries[index];
+			signal.throwIfAborted();
+			const filename = path.join(resolved, entry);
+			try {
+				results[index] = {
+					status: "fulfilled",
+					value: {
+						...await loadEntry(descriptor, entry, filename, base, signal),
+						sourceData: { filePath: path.relative(root, filename).split(path.sep).join("/") }
+					}
+				};
+			} catch (cause) {
+				results[index] = {
+					status: "rejected",
+					reason: contentError(cause, {
+						code: "source-error",
+						source: filename,
+						message: `Could not load "${entry}": ${describeCause(cause)}`,
+						cause
+					})
+				};
+			}
+		}
+	}
+	await Promise.all(Array.from({ length: Math.min(entries.length, 64) }, loadNext));
+	signal.throwIfAborted();
+	const failures = results.flatMap((result) => result.status === "rejected" ? result.reason.diagnostics : []);
+	if (failures.length) throw groupDiagnostics(failures);
+	return results.map((result) => result.value);
+}
+/** Captures one matched file's metadata and Markdown body from a single read. */
+async function loadEntry(descriptor, entry, filename, base, signal) {
+	const text = await readFile(filename, {
+		encoding: "utf8",
+		signal
+	});
+	const markdown = path.extname(entry).toLowerCase() === ".md";
+	let data;
+	let body;
+	if (markdown) {
+		const frontmatter = matter(text, {
+			engines: {
+				yaml: (source) => parse(source),
+				toml: (source) => parse$1(source)
+			},
+			...text.startsWith("+++") ? {
+				delimiters: "+++",
+				language: "toml"
+			} : {}
+		});
+		data = recordData(frontmatter.data);
+		body = frontmatter.content.replace(/^(?:[ \t]*\r?\n)+/, "");
+	} else data = recordData(parseData(text, filename));
+	const defaultId = data.slug ? coerceIdentity(data.slug) : entry.replace(/\\/g, "/").replace(/\.[^.]+$/, "").split("/").map((segment) => slug(segment)).join("/").replace(/\/index$/, "");
+	const id = descriptor.options.generateId ? descriptor.options.generateId({
+		entry: entry.replace(/\\/g, "/"),
+		base,
+		data
+	}) : defaultId;
+	if (typeof id !== "string" || !id) throw new ContentError({
+		code: "source-error",
+		source: filename,
+		message: "generateId must produce a nonempty string."
+	});
+	return {
+		id,
+		data,
+		...body === void 0 ? {} : { body },
+		source: filename
+	};
+}
+//#endregion
+export { populateStore as a, recordData as i, coerceIdentity as n, parseData as r, glob$1 as t };

package/dist/index.d.mts

@@ -0,0 +1,78 @@
+import { a as Loader, c as LoaderLogger, d as MetaStore, f as RecordLoader, i as FileSource, l as LoaderSource, n as DataStore, o as LoaderConfig, p as MaybePromise, r as FileEntrySource, s as LoaderContext, t as DataEntry, u as LoaderWatcher } from "./types-ChaNhj42.mjs";
+import { n as ContentRenderResult, r as RenderedContent, t as ContentHeading } from "./types-Dh-Sydyw.mjs";
+import { a as ComputedContext, c as Relationship, d as SchemaOutput, i as CollectionRegistry, n as BuiltinPayloads, o as PayloadsOf, r as CollectionDefinition, s as QueryData, t as BuiltinPayloadMarker, u as Schema } from "./types-C-kdMblM.mjs";
+import { n as GlobOptions } from "./descriptor-D9Th5hzk.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/collection/source.d.ts
+type CollectionSource = string | ({
+  type: "markdown" | "json" | "yaml" | "toml";
+  directory: string | URL;
+  include?: string | string[];
+} & Pick<GlobOptions, "generateId" | "retainBody" | "deferRender">);
+//#endregion
+//#region src/collection/define.d.ts
+/** Local sources whose entries are data records, without bodies or rendered output. */
+type RecordSource = Extract<CollectionSource, object> & {
+  type: "json" | "yaml" | "toml";
+};
+type CollectionFields<SourceSchema extends Schema | undefined, ComputedSchemas extends Record<string, Schema>, Relationships extends Record<string, Relationship>, Source> = {
+  schema?: SourceSchema;
+  computed?: { [Name in keyof ComputedSchemas]: {
+    schema: ComputedSchemas[Name];
+    resolve(context: ComputedContext<SchemaOutput<NoInfer<SourceSchema>>, Source>): unknown;
+  }; };
+  relationships?: Relationships & { [Name in keyof Relationships]: {
+    from: keyof (SchemaOutput<NoInfer<SourceSchema>> & {
+      id: string;
+    } & { [Field in keyof ComputedSchemas]: SchemaOutput<ComputedSchemas[Field]>; }) & string;
+  }; };
+};
+type Definition<SourceSchema extends Schema | undefined, ComputedSchemas extends Record<string, Schema>, Relationships extends Record<string, Relationship>, ContentLoader extends Loader> = ({
+  source: CollectionSource;
+  loader?: never;
+} & CollectionFields<SourceSchema, ComputedSchemas, Relationships, FileSource>) | ({
+  loader: ContentLoader;
+  source?: never;
+} & CollectionFields<SourceSchema, ComputedSchemas, Relationships, LoaderSource<NoInfer<ContentLoader>>>);
+/** Normalizes either declaration form into a definition with a native loader. */
+declare function collectionOf<SourceSchema extends StandardSchemaV1<unknown, Record<string, unknown>> | undefined, ComputedSchemas extends Record<string, Schema>, Relationships extends Record<string, Relationship>, ContentLoader extends Loader>(definition: Definition<SourceSchema, ComputedSchemas, Relationships, ContentLoader>): {
+  loader: ContentLoader | Loader<FileSource>;
+  schema: SourceSchema;
+  computed: { [Name in keyof ComputedSchemas]: {
+    schema: ComputedSchemas[Name];
+    resolve(context: ComputedContext<SchemaOutput<NoInfer<SourceSchema>>, FileSource>): unknown;
+  }; } | { [Name_1 in keyof ComputedSchemas]: {
+    schema: ComputedSchemas[Name_1];
+    resolve(context: ComputedContext<SchemaOutput<NoInfer<SourceSchema>>, LoaderSource<NoInfer<ContentLoader>>>): unknown;
+  }; };
+  relationships: Relationships;
+  source: CollectionSource;
+} | {
+  loader: ContentLoader | Loader<FileSource>;
+  schema: SourceSchema;
+  computed: { [Name in keyof ComputedSchemas]: {
+    schema: ComputedSchemas[Name];
+    resolve(context: ComputedContext<SchemaOutput<NoInfer<SourceSchema>>, FileSource>): unknown;
+  }; } | { [Name_1 in keyof ComputedSchemas]: {
+    schema: ComputedSchemas[Name_1];
+    resolve(context: ComputedContext<SchemaOutput<NoInfer<SourceSchema>>, LoaderSource<NoInfer<ContentLoader>>>): unknown;
+  }; };
+  relationships: Relationships;
+  source?: never;
+};
+type Defined<SourceSchema extends StandardSchemaV1<unknown, Record<string, unknown>> | undefined, ComputedSchemas extends Record<string, Schema>, Relationships extends Record<string, Relationship>, ContentLoader extends Loader> = ReturnType<typeof collectionOf<SourceSchema, ComputedSchemas, Relationships, ContentLoader>>;
+/**
+ * Declares fields with inferred schema data and optional loader source metadata, plus relationships.
+ * JSON, YAML, and TOML sources carry no built-in `_body` or `_rendered` payloads.
+ */
+export declare function defineCollection<const SourceSchema extends StandardSchemaV1<unknown, Record<string, unknown>> | undefined = undefined, const ComputedSchemas extends Record<string, Schema> = {}, const Relationships extends Record<string, Relationship> = {}>(definition: {
+  source: RecordSource;
+  loader?: never;
+} & CollectionFields<SourceSchema, ComputedSchemas, Relationships, FileSource>): Defined<SourceSchema, ComputedSchemas, Relationships, Loader> & BuiltinPayloadMarker<false>;
+/**
+ * Declares fields with inferred schema data and optional loader source metadata, plus relationships.
+ * Record loaders such as `file()` carry no built-in `_body` or `_rendered` payloads.
+ */
+export declare function defineCollection<const SourceSchema extends StandardSchemaV1<unknown, Record<string, unknown>> | undefined = undefined, const ComputedSchemas extends Record<string, Schema> = {}, const Relationships extends Record<string, Relationship> = {}, const ContentLoader extends Loader = Loader>(definition: Definition<SourceSchema, ComputedSchemas, Relationships, ContentLoader>): Defined<SourceSchema, ComputedSchemas, Relationships, ContentLoader> & BuiltinPayloadMarker<[ContentLoader] extends [RecordLoader] ? false : true>;
+//#endregion
+export type { BuiltinPayloads, CollectionDefinition, CollectionRegistry, CollectionSource, ComputedContext, ContentHeading, ContentRenderResult, DataEntry, DataStore, FileEntrySource, FileSource, Loader, LoaderConfig, LoaderContext, LoaderLogger, LoaderSource, LoaderWatcher, MaybePromise, MetaStore, PayloadsOf, QueryData, RecordLoader, Relationship, RenderedContent };

package/dist/index.mjs

@@ -0,0 +1,46 @@
+import { t as glob } from "./glob-Bv0dpvCQ.mjs";
+import { t as assertServerOnly } from "./server-only-CIJUlyL-.mjs";
+//#region src/collection/source.ts
+const patterns = {
+	markdown: "**/*.md",
+	json: "**/*.json",
+	yaml: "**/*.{yaml,yml}",
+	toml: "**/*.toml"
+};
+/** Normalizes local-source convenience declarations into the existing native glob loader. */
+function sourceLoader(source) {
+	const options = typeof source === "string" ? {
+		type: "markdown",
+		directory: source
+	} : source;
+	if (!options || !Object.hasOwn(patterns, options.type) || !options.directory || typeof options.directory !== "string" && !(options.directory instanceof URL)) throw new TypeError("source requires a directory and a supported type: markdown, json, yaml, or toml.");
+	return glob({
+		base: options.directory,
+		pattern: options.include ?? patterns[options.type],
+		..."generateId" in options ? { generateId: options.generateId } : {},
+		..."retainBody" in options ? { retainBody: options.retainBody } : {},
+		..."deferRender" in options ? { deferRender: options.deferRender } : {}
+	});
+}
+//#endregion
+//#region src/collection/define.ts
+/** Normalizes either declaration form into a definition with a native loader. */
+function collectionOf(definition) {
+	if (definition.source !== void 0 && definition.loader !== void 0) throw new TypeError("Specify either source or loader, not both.");
+	const loader = definition.loader ?? sourceLoader(definition.source);
+	return {
+		...definition,
+		loader,
+		schema: definition.schema,
+		computed: definition.computed ?? {},
+		relationships: definition.relationships ?? {}
+	};
+}
+function defineCollection(definition) {
+	return collectionOf(definition);
+}
+//#endregion
+//#region src/index.ts
+assertServerOnly();
+//#endregion
+export { defineCollection };

package/dist/internal/markdown.d.mts

@@ -0,0 +1,5 @@
+import { n as ContentRenderResult } from "../types-Dh-Sydyw.mjs";
+//#region src/runtime/markdown.d.ts
+/** Compiles captured Markdown using only library-owned, portable processing code. */
+export declare function renderMarkdown(body: string): Promise<ContentRenderResult>;
+//#endregion

package/dist/internal/markdown.mjs

@@ -0,0 +1 @@
+export { t as renderMarkdown } from "../markdown-CHvBBJNa.mjs";

package/dist/internal.d.mts

@@ -0,0 +1,54 @@
+import { n as ContentRenderResult } from "./types-Dh-Sydyw.mjs";
+import { i as CollectionRegistry } from "./types-C-kdMblM.mjs";
+import { a as ContentError, n as createLiveRuntime, r as PreparedRevision, t as Content } from "./content-G69dPPuo.mjs";
+import { v as QueryRegistry } from "./relational-types-DgK3rLuw.mjs";
+//#region src/artifacts/types.d.ts
+type ArtifactManifest = {
+  version: number;
+  codec: string;
+  collections: QueryRegistry;
+};
+type EncodedCollection = {
+  records: readonly string[];
+  /** Lazy encoded built-in payloads, keyed by entry ID. */
+  builtins: Record<string, () => Promise<{
+    default: string;
+  }>>;
+};
+//#endregion
+//#region src/artifacts/runtime.d.ts
+/** Initializes generated/embedded prepared content. This versioned wiring is internal. */
+export declare function createArtifactRevision(manifest: ArtifactManifest, collections: Record<string, EncodedCollection>, renderMarkdown?: (body: string) => Promise<ContentRenderResult>): PreparedRevision;
+/** Initializes the public generated server export from a complete immutable artifact revision. */
+export declare function createArtifactRuntime<Registry extends CollectionRegistry>(manifest: ArtifactManifest, collections: Record<string, EncodedCollection>, renderMarkdown?: (body: string) => Promise<ContentRenderResult>): Content<Registry>;
+//#endregion
+//#region src/artifacts/payloads.d.ts
+/**
+ * Restores gzip/base64 JSON using a synchronous, portable decoder. Generated metadata indexes
+ * can initialize without asynchronous module evaluation or runtime-specific compression APIs.
+ *
+ * @param encoded - The base64 representation of a gzip-compressed JSON document.
+ * @returns The original JSON value; malformed input throws to the artifact error boundary.
+ */
+export declare function decodeCompressed<Value>(encoded: string): Value;
+type PayloadChunk = {
+  ids: readonly string[];
+  load(): Promise<{
+    default: string | Record<string, string>;
+  }>;
+};
+/**
+ * Creates lazy entry loaders from compact chunk descriptors. Each chunk is imported and,
+ * when compressed, expanded once on first payload access. Encoded entry graphs retain the
+ * ordinary artifact codec; failed imports or decompression can be retried.
+ *
+ * @param chunks - Entry identities and lazy imports for raw or gzip/base64 payload maps.
+ * @returns One encoded-payload loader for each entry, without loading any content yet.
+ */
+export declare function createPayloadLoaders(chunks: readonly PayloadChunk[]): EncodedCollection["builtins"];
+//#endregion
+//#region src/runtime/diagnostics.d.ts
+/** Restores the library error and its causes in a generated or isolated development runtime. */
+export declare function restoreContentError(encoded: string): ContentError;
+//#endregion
+export { createLiveRuntime };

package/dist/internal.mjs

@@ -0,0 +1,89 @@
+import { t as ContentError } from "./errors-C2iuBM0G.mjs";
+import { r as decode } from "./values-BbTV4QT-.mjs";
+import { i as prepareRelationships, n as createRuntime, t as createLiveRuntime } from "./content-N1gYshjg.mjs";
+import { t as restoreContentError } from "./diagnostics-Cu94mZhl.mjs";
+import { gunzipSync } from "fflate/browser";
+//#region src/artifacts/runtime.ts
+/** Initializes generated/embedded prepared content. This versioned wiring is internal. */
+function createArtifactRevision(manifest, collections, renderMarkdown) {
+	try {
+		if (manifest.version !== 2 || manifest.codec !== "devalue-6.0.2") throw new Error("Incompatible content artifact or codec version; regenerate content.");
+		const revision = {
+			registry: manifest.collections,
+			collections: Object.create(null),
+			relations: /* @__PURE__ */ new Map(),
+			active: 0,
+			payloadCache: /* @__PURE__ */ new Map(),
+			renderCache: /* @__PURE__ */ new Map(),
+			renderMarkdown
+		};
+		for (const [name, descriptor] of Object.entries(manifest.collections)) {
+			const encoded = collections[name];
+			if (!encoded || !Array.isArray(encoded.records)) throw new Error(`Missing collection artifact "${name}".`);
+			const records = encoded.records.map((record) => decode(record));
+			if (records.some((record) => !record || typeof record !== "object" || Array.isArray(record) || !Object.hasOwn(record, "id") || typeof record.id !== "string" || !record.id || Object.hasOwn(record, "_adjacent") || Object.hasOwn(record, "_payloads")) || new Set(records.map((record) => record.id)).size !== records.length) throw new Error(`Invalid query records for collection "${name}".`);
+			revision.collections[name] = {
+				records,
+				relationships: descriptor.relationships,
+				builtins: new Map(Object.entries(encoded.builtins ?? {}).map(([id, load]) => [id, async () => decode((await load()).default)]))
+			};
+		}
+		const errors = prepareRelationships(revision);
+		if (errors.length) throw errors[0];
+		return revision;
+	} catch (cause) {
+		throw new ContentError({
+			code: "artifact-error",
+			message: "Could not initialize prepared content.",
+			cause
+		});
+	}
+}
+/** Initializes the public generated server export from a complete immutable artifact revision. */
+function createArtifactRuntime(manifest, collections, renderMarkdown) {
+	return createRuntime({ revision: createArtifactRevision(manifest, collections, renderMarkdown) });
+}
+//#endregion
+//#region src/artifacts/payloads.ts
+/**
+* Restores gzip/base64 JSON using a synchronous, portable decoder. Generated metadata indexes
+* can initialize without asynchronous module evaluation or runtime-specific compression APIs.
+*
+* @param encoded - The base64 representation of a gzip-compressed JSON document.
+* @returns The original JSON value; malformed input throws to the artifact error boundary.
+*/
+function decodeCompressed(encoded) {
+	const binary = atob(encoded);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);
+	return JSON.parse(new TextDecoder().decode(gunzipSync(bytes)));
+}
+/**
+* Creates lazy entry loaders from compact chunk descriptors. Each chunk is imported and,
+* when compressed, expanded once on first payload access. Encoded entry graphs retain the
+* ordinary artifact codec; failed imports or decompression can be retried.
+*
+* @param chunks - Entry identities and lazy imports for raw or gzip/base64 payload maps.
+* @returns One encoded-payload loader for each entry, without loading any content yet.
+*/
+function createPayloadLoaders(chunks) {
+	const loaders = Object.create(null);
+	for (const chunk of chunks) {
+		let loaded;
+		/** Shares one chunk import and decompression across concurrent entry requests. */
+		function load() {
+			loaded ??= Promise.resolve().then(() => chunk.load()).then((module) => {
+				if (typeof module.default !== "string") return module.default;
+				return decodeCompressed(module.default);
+			}).catch((cause) => {
+				loaded = void 0;
+				throw cause;
+			});
+			return loaded;
+		}
+		for (const id of chunk.ids) loaders[id] = async () => ({ default: (await load())[id] });
+	}
+	return loaders;
+}
+//#endregion
+export { createArtifactRevision, createArtifactRuntime, createLiveRuntime, createPayloadLoaders, decodeCompressed, restoreContentError };

package/dist/loaders.d.mts

@@ -0,0 +1,11 @@
+import { a as Loader, c as LoaderLogger, d as MetaStore, f as RecordLoader, i as FileSource, l as LoaderSource, n as DataStore, o as LoaderConfig, r as FileEntrySource, s as LoaderContext, t as DataEntry, u as LoaderWatcher } from "./types-ChaNhj42.mjs";
+import { n as GlobOptions, t as FileOptions } from "./descriptor-D9Th5hzk.mjs";
+//#region src/loaders/file.d.ts
+/** Declares a multi-entry data file with typed source paths and record keys, plus an optional parser. */
+export declare function file(filename: string, options?: FileOptions): RecordLoader<FileEntrySource>;
+//#endregion
+//#region src/loaders/glob.d.ts
+/** Declares local files with Astro-style IDs and typed, project-relative source paths. */
+export declare function glob(options: GlobOptions): Loader<FileSource>;
+//#endregion
+export type { DataEntry, DataStore, FileEntrySource, FileOptions, FileSource, GlobOptions, Loader, LoaderConfig, LoaderContext, LoaderLogger, LoaderSource, LoaderWatcher, MetaStore, RecordLoader };