content-query 0.3.0 → 0.4.0

package/dist/{build-jKnjDjQE.d.mts → build-DL1GzmRy.d.mts}

@@ -1,5 +1,6 @@
-import { i as InvalidRelationships, o as ContentError, t as Content } from "./content-lwPxE9Yu.mjs";
-import { i as CollectionRegistry } from "./types-BC8gVJ6u.mjs";
+import { i as InvalidRelationships, o as ContentError, t as Content } from "./content-CwTKqRs9.mjs";
+import { i as CollectionRegistry } from "./types-DbFfF6JE.mjs";
+import { n as QueryStyle } from "./query-style-eXENQJ0O.mjs";
 //#region src/preparation/session.d.ts
 /** A local source captured by a successfully prepared content revision. */
 type ContentSourceEntry = Readonly<{
@@ -20,8 +21,9 @@ type ContentSourceEvent = {
   type: "error";
   error: ContentError;
 };
-type ContentSession<Registry extends CollectionRegistry = {}> = {
-  content: Content<Registry>;
+type ContentSession<Registry extends CollectionRegistry = {}, Style extends QueryStyle = QueryStyle> = {
+  /** Root query APIs are typed by `Style`; the configured `queryStyle` is enforced at runtime. */
+  content: Content<Registry, Style>;
   /** Reads the latest successful source snapshot; current preparation errors are rethrown. */
   sources(): ContentSourceSnapshot;
   /** Observes subsequent publications and failures; returns an idempotent unsubscribe function. */
@@ -42,7 +44,12 @@ type BuildContentOptions = {
 /**
  * Builds content independently of a bundler; bind the registry through an erased type import.
  * Generated watch sessions prune previous-run artifacts after their first successful publication.
+ *
+ * @param arguments_ - Optional build options.
+ * @returns A session whose `content` exposes the root query APIs allowed by `Style`. Pass
+ * `typeof queryStyle` from the config to type it; the configured `queryStyle` is always enforced
+ * at runtime.
  */
-declare function buildContent<Registry extends CollectionRegistry = {}>(...arguments_: InvalidRelationships<Registry> extends never ? [options?: BuildContentOptions] : [invalidRegistry: never]): Promise<ContentSession<Registry>>;
+declare function buildContent<Registry extends CollectionRegistry = {}, Style extends QueryStyle = QueryStyle>(...arguments_: InvalidRelationships<Registry> extends never ? [options?: BuildContentOptions] : [invalidRegistry: never]): Promise<ContentSession<Registry, Style>>;
 //#endregion
 export { ContentSourceEvent as a, ContentSourceEntry as i, buildContent as n, ContentSourceSnapshot as o, ContentSession as r, BuildContentOptions as t };

package/dist/build.d.mts

@@ -1,2 +1,2 @@
-import { a as ContentSourceEvent, i as ContentSourceEntry, n as buildContent, o as ContentSourceSnapshot, r as ContentSession, t as BuildContentOptions } from "./build-jKnjDjQE.mjs";
+import { a as ContentSourceEvent, i as ContentSourceEntry, n as buildContent, o as ContentSourceSnapshot, r as ContentSession, t as BuildContentOptions } from "./build-DL1GzmRy.mjs";
 export { type BuildContentOptions, type ContentSession, type ContentSourceEntry, type ContentSourceEvent, type ContentSourceSnapshot, buildContent };

package/dist/build.mjs

@@ -1 +1 @@
-export { n as buildContent } from "./build-CI4s0oFP.mjs";
+export { n as buildContent } from "./build-CcqIpkes.mjs";

package/dist/cli.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { t as ContentError } from "./errors-C2iuBM0G.mjs";
-import { t as buildAtRoot } from "./build-CI4s0oFP.mjs";
+import { o as payloadIdentity, t as ContentError } from "./errors-Bfd0R4_P.mjs";
+import { t as buildAtRoot } from "./build-CcqIpkes.mjs";
 import { cac } from "cac";
 //#region package.json
-var version = "0.3.0";
+var version = "0.4.0";
 //#endregion
 //#region src/integrations/cli/arguments.ts
 /** Validates one path option after CAC's automatic numeric conversion. */
@@ -62,13 +62,19 @@ function parseArguments(arguments_) {
 }
 //#endregion
 //#region src/integrations/cli/report.ts
-/** Prints structured contextual diagnostics without depending on a framework display. */
-function report(cause) {
-	if (cause instanceof ContentError) for (const diagnostic of cause.diagnostics) console.error(`[content-query:${diagnostic.code}] ${[
+/** Names where a diagnostic applies: collection, entry, source, payload variant, and field path. */
+function location(diagnostic) {
+	return [
 		diagnostic.collection,
 		diagnostic.id,
-		diagnostic.source
-	].filter(Boolean).join(" ")}: ${diagnostic.message}`);
+		diagnostic.source,
+		diagnostic.payload ? payloadIdentity(diagnostic.payload, diagnostic.variant) : void 0,
+		diagnostic.path?.length ? `at ${diagnostic.path.map(String).join(".")}` : void 0
+	].filter(Boolean).join(" ");
+}
+/** Prints structured contextual diagnostics without depending on a framework display. */
+function report(cause) {
+	if (cause instanceof ContentError) for (const diagnostic of cause.diagnostics) console.error(`[content-query:${diagnostic.code}] ${location(diagnostic)}: ${diagnostic.message}`);
 	else console.error(cause instanceof Error ? cause.message : cause);
 }
 //#endregion

package/dist/computed.d.mts

@@ -1,5 +1,5 @@
-import { m as MaybePromise } from "./types-FmUJ3cH1.mjs";
-import { a as ComputedContext } from "./types-BC8gVJ6u.mjs";
+import { g as MaybePromise } from "./descriptor-bcPa6XLk.mjs";
+import { a as ComputedContext } from "./types-DbFfF6JE.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/computed/text.d.ts
 /** The syntax removed before computing text-derived fields; literal text preserves all characters. */