content-query 0.2.0 → 0.4.0

package/dist/build-DL1GzmRy.d.mts

@@ -0,0 +1,55 @@
+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<{
+  collection: string;
+  id: string;
+  filePath?: string;
+}>;
+/** Format-neutral integration metadata; the revision token is opaque and session-scoped. */
+type ContentSourceSnapshot = Readonly<{
+  revision: string;
+  entries: readonly ContentSourceEntry[];
+}>;
+/** Notifications are delivered only after atomic publication, or after a failed attempt. */
+type ContentSourceEvent = {
+  type: "ready";
+  snapshot: ContentSourceSnapshot;
+} | {
+  type: "error";
+  error: ContentError;
+};
+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. */
+  subscribe(listener: (event: ContentSourceEvent) => void): () => void;
+  dispose(): Promise<void>;
+};
+//#endregion
+//#region src/preparation/build.d.ts
+/** Options shared by standalone content builds and host integrations. */
+type BuildContentOptions = {
+  /** Exact config path; omission discovers one content-query.config.{ts,mts,cts,js,mjs,cjs} file. */
+  config?: string;
+  backend?: "in-memory" | "generated";
+  /** Generated backend output directory, relative to the application root; defaults to ./.content-query. */
+  outDir?: string;
+  watch?: boolean;
+};
+/**
+ * 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 = {}, 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 { n as buildContent, r as ContentSession, t as BuildContentOptions } from "./build-DfKd2bpf.mjs";
-export { type BuildContentOptions, type ContentSession, buildContent };
+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-Dxz7P1ur.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-Dxz7P1ur.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.2.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 { p as MaybePromise } from "./types-ChaNhj42.mjs";
-import { a as ComputedContext } from "./types-C-kdMblM.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. */