@foir/sdk 0.7.0 → 0.9.0

package/dist/chunk-IGNLWT3H.js

@@ -0,0 +1,35 @@
+import {
+  DEFAULT_GRAPHQL_IMPORT,
+  DEFAULT_SDK_IMPORT,
+  collectItemMembers
+} from "./chunk-TAL5H6VA.js";
+
+// src/codegen/item-registry.ts
+var plugin = (schema, _documents, config = {}) => {
+  const members = collectItemMembers(schema, config.unions);
+  const graphqlImport = config.graphqlImport ?? DEFAULT_GRAPHQL_IMPORT;
+  const sdkImport = config.sdkImport ?? DEFAULT_SDK_IMPORT;
+  const registryName = config.registryName ?? "ItemRegistry";
+  return [
+    "/* eslint-disable */",
+    "// Generated by @foir/sdk/codegen/item-registry. Do not edit by hand.",
+    "// Regenerated on every codegen run \u2014 omitting an item type is a compile error.",
+    `import type { ItemComponent } from '${sdkImport}';`,
+    `import type {`,
+    ...members.map((m) => `  ${m},`),
+    `} from '${graphqlImport}';`,
+    "",
+    `/**`,
+    ` * Exhaustive map of every item \`__typename\` in the project schema to the`,
+    ` * component that renders it. Pass an instance to \`createContentRenderer\`.`,
+    ` */`,
+    `export type ${registryName}<Ctx = unknown> = {`,
+    ...members.map((m) => `  ${m}: ItemComponent<${m}, Ctx>;`),
+    `};`,
+    ""
+  ].join("\n");
+};
+
+export {
+  plugin
+};

package/dist/chunk-OHYVKTGB.js

@@ -0,0 +1,45 @@
+import {
+  DEFAULT_GRAPHQL_IMPORT,
+  DEFAULT_SDK_IMPORT,
+  collectItemMembers
+} from "./chunk-TAL5H6VA.js";
+
+// src/codegen/item-scaffold.ts
+var plugin = (schema, _documents, config = {}) => {
+  const members = collectItemMembers(schema, config.unions);
+  const graphqlImport = config.graphqlImport ?? DEFAULT_GRAPHQL_IMPORT;
+  const sdkImport = config.sdkImport ?? DEFAULT_SDK_IMPORT;
+  const registryImport = config.registryImport ?? "./item-registry";
+  const ctx = config.ctxType ?? "unknown";
+  const stub = (m) => [
+    `function ${m}View(props: ItemComponentProps<${m}, ${ctx}>) {`,
+    `  // TODO: render ${m} from props.item (props.ctx, props.priority available)`,
+    `  void props;`,
+    `  return null;`,
+    `}`
+  ].join("\n");
+  return [
+    "/* eslint-disable */",
+    "// Scaffolded once by @foir/sdk/codegen/item-scaffold \u2014 you own this file.",
+    "// Implement each stub; the build stays green until you do.",
+    `import { createContentRenderer, type ItemComponentProps } from '${sdkImport}';`,
+    `import type { ItemRegistry } from '${registryImport}';`,
+    `import type {`,
+    ...members.map((m) => `  ${m},`),
+    `} from '${graphqlImport}';`,
+    ...config.ctxImport ? ["", config.ctxImport] : [],
+    "",
+    ...members.map(stub),
+    "",
+    `export const itemRegistry: ItemRegistry<${ctx}> = {`,
+    ...members.map((m) => `  ${m}: ${m}View,`),
+    `};`,
+    "",
+    `export const ContentRenderer = createContentRenderer<${ctx}>(itemRegistry);`,
+    ""
+  ].join("\n");
+};
+
+export {
+  plugin
+};

package/dist/chunk-TAL5H6VA.js

@@ -0,0 +1,39 @@
+// src/codegen/shared.ts
+import { isUnionType } from "graphql";
+var DEFAULT_GRAPHQL_IMPORT = "./graphql";
+var DEFAULT_SDK_IMPORT = "@foir/sdk/content";
+var PASSAGE = "Passage";
+function collectItemMembers(schema, unionNames) {
+  const members = /* @__PURE__ */ new Set();
+  const missing = [];
+  if (unionNames && unionNames.length > 0) {
+    for (const name of unionNames) {
+      const type = schema.getType(name);
+      if (!type || !isUnionType(type)) {
+        missing.push(name);
+        continue;
+      }
+      for (const member of type.getTypes()) members.add(member.name);
+    }
+  } else {
+    for (const type of Object.values(schema.getTypeMap())) {
+      if (!isUnionType(type)) continue;
+      const names = type.getTypes().map((m) => m.name);
+      if (!names.includes(PASSAGE)) continue;
+      for (const name of names) members.add(name);
+    }
+  }
+  members.delete(PASSAGE);
+  if (members.size === 0) {
+    throw new Error(
+      `[foir codegen] no item members found. ` + (unionNames && unionNames.length > 0 ? `Looked for union(s): ${unionNames.join(", ")}` + (missing.length ? ` (not found or not a union: ${missing.join(", ")})` : "") : `No prose entries union (a union containing Passage) exists in the schema`) + `. Run \`foir push\`, then confirm the schema has a prose field that places models \u2014 a prose field's entries union is named by its materialised member set.`
+    );
+  }
+  return [...members].sort();
+}
+
+export {
+  DEFAULT_GRAPHQL_IMPORT,
+  DEFAULT_SDK_IMPORT,
+  collectItemMembers
+};

package/dist/client.js

@@ -129,18 +129,14 @@ function readFoirEnvelope(json) {
   return json.data;
 }
 
-// src/graphql/cdn-route.ts
-var CDN_PATH = "/cdn/graphql";
-function isCdnEligible(env, documentText, bearerToken) {
-  if (bearerToken) return false;
-  if (isFoirPreview(env)) return false;
-  const apiKey = resolveFoirApiKey(env);
-  if (!apiKey?.startsWith("pk_")) return false;
-  return !/\bmutation\b/.test(documentText);
+// src/transport/persisted-query.ts
+var FOIR_CDN_GRAPHQL_PATH = "/cdn/graphql";
+function persistedQueryExtension(hash) {
+  return { persistedQuery: { version: 1, sha256Hash: hash } };
 }
 function buildCdnUrl(endpoint, apiKey, hash, variables) {
   const url = new URL(endpoint);
-  url.pathname = url.pathname.replace(/\/graphql\/?$/, "") + CDN_PATH;
+  url.pathname = url.pathname.replace(/\/graphql\/?$/, "") + FOIR_CDN_GRAPHQL_PATH;
   url.searchParams.set("key", apiKey);
   url.searchParams.set("extensions", JSON.stringify(persistedQueryExtension(hash)));
   if (variables && Object.keys(variables).length > 0) {
@@ -148,18 +144,29 @@ function buildCdnUrl(endpoint, apiKey, hash, variables) {
   }
   return url.toString();
 }
-function persistedQueryExtension(hash) {
-  return { persistedQuery: { version: 1, sha256Hash: hash } };
-}
 async function documentHash(documentText) {
-  const digest = await crypto.subtle.digest(
-    "SHA-256",
-    new TextEncoder().encode(documentText)
-  );
+  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(documentText));
   return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 var PERSISTED_QUERY_NOT_FOUND = "PERSISTED_QUERY_NOT_FOUND";
 var NOT_SHAREABLE = "NOT_SHAREABLE";
+async function hasFoirErrorCode(res, ...codes) {
+  try {
+    const body = await res.clone().json();
+    return body.errors?.some((e) => e.extensions?.code !== void 0 && codes.includes(e.extensions.code)) ?? false;
+  } catch {
+    return false;
+  }
+}
+
+// src/graphql/cdn-route.ts
+function isCdnEligible(env, documentText, bearerToken) {
+  if (bearerToken) return false;
+  if (isFoirPreview(env)) return false;
+  const apiKey = resolveFoirApiKey(env);
+  if (!apiKey?.startsWith("pk_")) return false;
+  return !/\bmutation\b/.test(documentText);
+}
 
 // src/transport/retry.ts
 var DEFAULT_ATTEMPTS = 3;
@@ -288,23 +295,10 @@ async function readErrorEnvelope(res) {
   return errors;
 }
 async function isSharedRefusal(res) {
-  if (res.ok) return false;
-  try {
-    const body = await res.clone().json();
-    return body.errors?.some((e) => e.extensions?.code === NOT_SHAREABLE) ?? false;
-  } catch {
-    return false;
-  }
+  return hasFoirErrorCode(res, NOT_SHAREABLE);
 }
 async function isPersistedQueryMiss(res) {
-  try {
-    const body = await res.clone().json();
-    return body.errors?.some(
-      (e) => e.extensions?.code === PERSISTED_QUERY_NOT_FOUND
-    ) ?? false;
-  } catch {
-    return false;
-  }
+  return hasFoirErrorCode(res, PERSISTED_QUERY_NOT_FOUND);
 }
 
 // src/graphql/content-client.ts

package/dist/codegen/block-registry.d.ts

@@ -1,23 +1,17 @@
 /**
- * `@foir/sdk/codegen/block-registry` — a graphql-codegen plugin.
+ * `@foir/sdk/codegen/block-registry` — DEPRECATED alias.
  *
- * Introspects the project's public schema, collects every member of the block
- * union(s), and emits an EXHAUSTIVE `BlockRegistry` type — one key per block
- * `__typename`, each typed `BlockComponent<ThatBlock, Ctx>`. Because the type
- * requires every key, a project that adds an inline model (→ a new block
- * `__typename`) breaks the consumer's build until the new component is wired:
- * exhaustiveness by construction, replacing the hand-synced switch the
- * storefront's `BlockDigester` used to carry.
+ * `block` was one project's name for a flexible field, never a platform
+ * concept (TTS-1391). The plugin moved to `@foir/sdk/codegen/item-registry`;
+ * this path re-exports it unchanged so an existing `codegen.ts` keeps working.
+ * Repoint the `plugins:` entry when convenient — this will be removed in a
+ * future major.
  *
- * Wired automatically by `foirCodegen()`. The generated file imports the block
- * types from the codegen output (`./graphql`) and `BlockComponent` from
- * `@foir/sdk/content`, so it pairs directly with `createContentRenderer`.
+ * Note that the emitted type is now named `ItemRegistry` by default and its
+ * components are typed `ItemComponent`. If you import the generated
+ * `BlockRegistry` by name, either pass `registryName: 'BlockRegistry'` or
+ * update the import; `@foir/sdk/content` still exports `BlockRegistry` as a
+ * deprecated alias of `ItemRegistry`, so the types remain compatible.
  */
-import type { GraphQLSchema } from 'graphql';
-import { type BlockPluginConfig } from './shared';
-export interface BlockRegistryConfig extends BlockPluginConfig {
-    /** Name of the generated registry type. Default `BlockRegistry`. */
-    registryName?: string;
-}
-/** graphql-codegen plugin entrypoint. */
-export declare const plugin: (schema: GraphQLSchema, _documents: unknown, config?: BlockRegistryConfig) => string;
+export { plugin } from './item-registry';
+export type { ItemRegistryConfig, BlockRegistryConfig, } from './item-registry';

package/dist/codegen/block-registry.js

@@ -1,35 +1,7 @@
 import {
-  DEFAULT_GRAPHQL_IMPORT,
-  DEFAULT_SDK_IMPORT,
-  DEFAULT_UNIONS,
-  collectBlockMembers
-} from "../chunk-ADO5FJNM.js";
-
-// src/codegen/block-registry.ts
-var plugin = (schema, _documents, config = {}) => {
-  const members = collectBlockMembers(schema, config.unions ?? DEFAULT_UNIONS);
-  const graphqlImport = config.graphqlImport ?? DEFAULT_GRAPHQL_IMPORT;
-  const sdkImport = config.sdkImport ?? DEFAULT_SDK_IMPORT;
-  const registryName = config.registryName ?? "BlockRegistry";
-  return [
-    "/* eslint-disable */",
-    "// Generated by @foir/sdk/codegen/block-registry. Do not edit by hand.",
-    "// Regenerated on every codegen run \u2014 omitting a block type is a compile error.",
-    `import type { BlockComponent } from '${sdkImport}';`,
-    `import type {`,
-    ...members.map((m) => `  ${m},`),
-    `} from '${graphqlImport}';`,
-    "",
-    `/**`,
-    ` * Exhaustive map of every block \`__typename\` in the project schema to the`,
-    ` * component that renders it. Pass an instance to \`createContentRenderer\`.`,
-    ` */`,
-    `export type ${registryName}<Ctx = unknown> = {`,
-    ...members.map((m) => `  ${m}: BlockComponent<${m}, Ctx>;`),
-    `};`,
-    ""
-  ].join("\n");
-};
+  plugin
+} from "../chunk-IGNLWT3H.js";
+import "../chunk-TAL5H6VA.js";
 export {
   plugin
 };

package/dist/codegen/block-scaffold.d.ts

@@ -1,24 +1,15 @@
 /**
- * `@foir/sdk/codegen/block-scaffold` — a one-shot graphql-codegen plugin.
+ * `@foir/sdk/codegen/block-scaffold` — DEPRECATED alias.
  *
- * Emits a ContentRenderer shell: a stub component per block `__typename`, a
- * `blockRegistry` of the (exhaustive) `BlockRegistry` type, and a
- * `createContentRenderer` wiring. Unlike the block-registry plugin (which
- * regenerates every run), this is a STARTING POINT the dev then owns — run it
- * once via `foirScaffold()`, then implement each stub. It compiles out of the
- * box (each stub is a typed no-op) so the build stays green while you fill them
- * in. Adding a new block type later surfaces as a compile error on
- * `blockRegistry` (via the regenerated `BlockRegistry` type), not here.
+ * `block` was one project's name for a flexible field, never a platform
+ * concept (TTS-1391). The plugin moved to `@foir/sdk/codegen/item-scaffold`;
+ * this path re-exports it unchanged so an existing `codegen.ts` keeps working.
+ * Repoint the `plugins:` entry when convenient — this will be removed in a
+ * future major.
+ *
+ * The scaffold is a one-shot generator, so a file scaffolded under the old name
+ * is yours and is untouched by this. Newly scaffolded files export
+ * `itemRegistry` rather than `blockRegistry` and take `props.item`.
  */
-import type { GraphQLSchema } from 'graphql';
-import { type BlockPluginConfig } from './shared';
-export interface BlockScaffoldConfig extends BlockPluginConfig {
-    /** Import path for the generated registry type. Default `./block-registry`. */
-    registryImport?: string;
-    /** Render-context type name threaded to every component. Default `unknown`. */
-    ctxType?: string;
-    /** Optional import line for the ctx type, e.g. `import type { Ctx } from '~/ctx'`. */
-    ctxImport?: string;
-}
-/** graphql-codegen plugin entrypoint. */
-export declare const plugin: (schema: GraphQLSchema, _documents: unknown, config?: BlockScaffoldConfig) => string;
+export { plugin } from './item-scaffold';
+export type { ItemScaffoldConfig, BlockScaffoldConfig, } from './item-scaffold';

package/dist/codegen/block-scaffold.js

@@ -1,45 +1,7 @@
 import {
-  DEFAULT_GRAPHQL_IMPORT,
-  DEFAULT_SDK_IMPORT,
-  DEFAULT_UNIONS,
-  collectBlockMembers
-} from "../chunk-ADO5FJNM.js";
-
-// src/codegen/block-scaffold.ts
-var plugin = (schema, _documents, config = {}) => {
-  const members = collectBlockMembers(schema, config.unions ?? DEFAULT_UNIONS);
-  const graphqlImport = config.graphqlImport ?? DEFAULT_GRAPHQL_IMPORT;
-  const sdkImport = config.sdkImport ?? DEFAULT_SDK_IMPORT;
-  const registryImport = config.registryImport ?? "./block-registry";
-  const ctx = config.ctxType ?? "unknown";
-  const stub = (m) => [
-    `function ${m}View(props: BlockComponentProps<${m}, ${ctx}>) {`,
-    `  // TODO: render ${m} from props.block (props.ctx, props.priority available)`,
-    `  void props;`,
-    `  return null;`,
-    `}`
-  ].join("\n");
-  return [
-    "/* eslint-disable */",
-    "// Scaffolded once by @foir/sdk/codegen/block-scaffold \u2014 you own this file.",
-    "// Implement each stub; the build stays green until you do.",
-    `import { createContentRenderer, type BlockComponentProps } from '${sdkImport}';`,
-    `import type { BlockRegistry } from '${registryImport}';`,
-    `import type {`,
-    ...members.map((m) => `  ${m},`),
-    `} from '${graphqlImport}';`,
-    ...config.ctxImport ? ["", config.ctxImport] : [],
-    "",
-    ...members.map(stub),
-    "",
-    `export const blockRegistry: BlockRegistry<${ctx}> = {`,
-    ...members.map((m) => `  ${m}: ${m}View,`),
-    `};`,
-    "",
-    `export const ContentRenderer = createContentRenderer<${ctx}>(blockRegistry);`,
-    ""
-  ].join("\n");
-};
+  plugin
+} from "../chunk-OHYVKTGB.js";
+import "../chunk-TAL5H6VA.js";
 export {
   plugin
 };

package/dist/codegen/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * `@foir/sdk/codegen` — Foir graphql-codegen preset + block-registry plugin.
+ * `@foir/sdk/codegen` — Foir graphql-codegen preset + item-registry plugin.
  *
  * Build-time only. `@graphql-codegen/cli` + `@graphql-codegen/client-preset`
- * are optional peer dependencies (the consumer's devDeps). The block-registry
- * and block-scaffold plugins are wired by the preset and also available at
- * `@foir/sdk/codegen/block-registry` / `@foir/sdk/codegen/block-scaffold`.
+ * are optional peer dependencies (the consumer's devDeps). The item-registry
+ * and item-scaffold plugins are wired by the preset and also available at
+ * `@foir/sdk/codegen/item-registry` / `@foir/sdk/codegen/item-scaffold`.
+ *
+ * The pre-TTS-1391 paths `@foir/sdk/codegen/block-registry` and
+ * `/block-scaffold` still resolve, re-exporting those modules unchanged.
  */
 export { foirCodegen, foirScaffold } from './preset';
 export type { FoirCodegenOptions, FoirScaffoldOptions } from './preset';
+export type { ItemPluginConfig } from './shared';
+/** @deprecated Renamed to `ItemPluginConfig`. */
 export type { BlockPluginConfig } from './shared';

package/dist/codegen/index.js

@@ -1,7 +1,3 @@
-import {
-  DEFAULT_UNIONS
-} from "../chunk-ADO5FJNM.js";
-
 // src/codegen/preset.ts
 var DEFAULT_OUTPUT_DIR = "./app/gql/foir/";
 var DEFAULT_DOCUMENTS = "app/graphql/foir/**/*.graphql";
@@ -30,8 +26,8 @@ function foirCodegen(options) {
   const previewKey = options.previewKey ?? options.apiKey;
   const outputDir = normalizeDir(options.outputDir ?? DEFAULT_OUTPUT_DIR);
   const documents = options.documents ?? DEFAULT_DOCUMENTS;
-  const blockUnions = options.blockUnions ?? DEFAULT_UNIONS;
-  const registryFile = options.registryFile ?? `${outputDir}block-registry.ts`;
+  const unions = options.itemUnions ?? options.blockUnions;
+  const registryFile = options.registryFile ?? `${outputDir}item-registry.ts`;
   return {
     schema: schemaEntry(options.apiUrl, previewKey),
     documents,
@@ -47,8 +43,8 @@ function foirCodegen(options) {
         }
       },
       [registryFile]: {
-        plugins: ["@foir/sdk/codegen/block-registry"],
-        config: { unions: blockUnions }
+        plugins: ["@foir/sdk/codegen/item-registry"],
+        config: { unions }
       }
     }
   };
@@ -57,15 +53,15 @@ function foirScaffold(options) {
   const previewKey = options.previewKey ?? options.apiKey;
   const outputDir = normalizeDir(options.outputDir ?? DEFAULT_OUTPUT_DIR);
   const scaffoldFile = options.scaffoldFile ?? `${outputDir}ContentRenderer.tsx`;
-  const blockUnions = options.blockUnions ?? DEFAULT_UNIONS;
+  const unions = options.itemUnions ?? options.blockUnions;
   return {
     schema: schemaEntry(options.apiUrl, previewKey),
     ignoreNoDocuments: true,
     generates: {
       [scaffoldFile]: {
-        plugins: ["@foir/sdk/codegen/block-scaffold"],
+        plugins: ["@foir/sdk/codegen/item-scaffold"],
         config: {
-          unions: blockUnions,
+          unions,
           ctxType: options.ctxType,
           ctxImport: options.ctxImport,
           registryImport: options.registryImport

package/dist/codegen/item-registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@foir/sdk/codegen/item-registry` — a graphql-codegen plugin.
+ *
+ * Introspects the project's public schema, collects every member of the
+ * flexible union(s), and emits an EXHAUSTIVE `ItemRegistry` type — one key per
+ * item `__typename`, each typed `ItemComponent<ThatItem, Ctx>`. Because the
+ * type requires every key, a project that adds an inline model (→ a new item
+ * `__typename`) breaks the consumer's build until the new component is wired:
+ * exhaustiveness by construction, replacing the hand-synced switch a storefront
+ * would otherwise carry.
+ *
+ * Wired automatically by `foirCodegen()`. The generated file imports the item
+ * types from the codegen output (`./graphql`) and `ItemComponent` from
+ * `@foir/sdk/content`, so it pairs directly with `createContentRenderer`.
+ *
+ * Reachable at the pre-TTS-1391 path `@foir/sdk/codegen/block-registry` too,
+ * which re-exports this module unchanged.
+ */
+import type { GraphQLSchema } from 'graphql';
+import { type ItemPluginConfig } from './shared';
+export interface ItemRegistryConfig extends ItemPluginConfig {
+    /** Name of the generated registry type. Default `ItemRegistry`. */
+    registryName?: string;
+}
+/** @deprecated Renamed to {@link ItemRegistryConfig}. */
+export type BlockRegistryConfig = ItemRegistryConfig;
+/** graphql-codegen plugin entrypoint. */
+export declare const plugin: (schema: GraphQLSchema, _documents: unknown, config?: ItemRegistryConfig) => string;

package/dist/codegen/item-registry.js

@@ -0,0 +1,7 @@
+import {
+  plugin
+} from "../chunk-IGNLWT3H.js";
+import "../chunk-TAL5H6VA.js";
+export {
+  plugin
+};

package/dist/codegen/item-scaffold.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `@foir/sdk/codegen/item-scaffold` — a one-shot graphql-codegen plugin.
+ *
+ * Emits a ContentRenderer shell: a stub component per item `__typename`, an
+ * `itemRegistry` of the (exhaustive) `ItemRegistry` type, and a
+ * `createContentRenderer` wiring. Unlike the item-registry plugin (which
+ * regenerates every run), this is a STARTING POINT the dev then owns — run it
+ * once via `foirScaffold()`, then implement each stub. It compiles out of the
+ * box (each stub is a typed no-op) so the build stays green while you fill them
+ * in. Adding a new item type later surfaces as a compile error on
+ * `itemRegistry` (via the regenerated `ItemRegistry` type), not here.
+ *
+ * Reachable at the pre-TTS-1391 path `@foir/sdk/codegen/block-scaffold` too,
+ * which re-exports this module unchanged.
+ */
+import type { GraphQLSchema } from 'graphql';
+import { type ItemPluginConfig } from './shared';
+export interface ItemScaffoldConfig extends ItemPluginConfig {
+    /** Import path for the generated registry type. Default `./item-registry`. */
+    registryImport?: string;
+    /** Render-context type name threaded to every component. Default `unknown`. */
+    ctxType?: string;
+    /** Optional import line for the ctx type, e.g. `import type { Ctx } from '~/ctx'`. */
+    ctxImport?: string;
+}
+/** @deprecated Renamed to {@link ItemScaffoldConfig}. */
+export type BlockScaffoldConfig = ItemScaffoldConfig;
+/** graphql-codegen plugin entrypoint. */
+export declare const plugin: (schema: GraphQLSchema, _documents: unknown, config?: ItemScaffoldConfig) => string;

package/dist/codegen/item-scaffold.js

@@ -0,0 +1,7 @@
+import {
+  plugin
+} from "../chunk-OHYVKTGB.js";
+import "../chunk-TAL5H6VA.js";
+export {
+  plugin
+};

package/dist/codegen/preset.d.ts

@@ -5,7 +5,7 @@
  * a consumer's `codegen.ts` is ~3 lines instead of the ~109 every storefront
  * hand-copies. It standardizes the Foir conventions (custom scalars,
  * `enumValues: 'keep'`, the `X-Foir-Schema-Channel: draft` introspection header)
- * AND wires the block-registry plugin so the exhaustive `BlockRegistry` type is
+ * AND wires the item-registry plugin so the exhaustive `ItemRegistry` type is
  * regenerated alongside the typed documents.
  *
  * `foirScaffold()` is the separate one-shot that writes the ContentRenderer
@@ -30,31 +30,38 @@ export interface FoirCodegenOptions {
     outputDir?: string;
     /** Operation document glob(s). Default `app/graphql/foir/**\/*.graphql`. */
     documents?: string | string[];
-    /** Block union name(s) for the registry. Default `['Block']`. */
+    /**
+     * Entries union name(s) for the registry. When unset, every prose
+     * entries union in the schema (the unions carrying `Passage`) is
+     * discovered at introspection time. Set explicitly to narrow the
+     * registry to specific fields' unions.
+     */
+    itemUnions?: string[];
+    /** @deprecated Renamed to `itemUnions`. Honoured when `itemUnions` is unset. */
     blockUnions?: string[];
-    /** Generated registry file path. Default `<outputDir>block-registry.ts`. */
+    /** Generated registry file path. Default `<outputDir>item-registry.ts`. */
     registryFile?: string;
     /** Extra/override custom scalars merged onto the Foir defaults. */
     scalars?: Record<string, unknown>;
 }
 /**
  * Build the continuous Foir codegen config: typed documents + the exhaustive
- * block registry. Drop it into `codegen.ts` and run `graphql-codegen`.
+ * item registry. Drop it into `codegen.ts` and run `graphql-codegen`.
  */
 export declare function foirCodegen(options: FoirCodegenOptions): CodegenConfig;
 export interface FoirScaffoldOptions extends FoirCodegenOptions {
     /** Output path for the scaffold. Default `<outputDir>ContentRenderer.tsx`. */
     scaffoldFile?: string;
-    /** Render-context type threaded to every block component. Default `unknown`. */
+    /** Render-context type threaded to every item component. Default `unknown`. */
     ctxType?: string;
     /** Optional ctx-type import line, e.g. `import type { Ctx } from '~/ctx'`. */
     ctxImport?: string;
-    /** Import path for the generated registry type. Default `./block-registry`. */
+    /** Import path for the generated registry type. Default `./item-registry`. */
     registryImport?: string;
 }
 /**
  * Build the one-shot scaffold config — writes a ContentRenderer shell with a
- * typed stub per block type. Run once (`graphql-codegen --config scaffold.ts`),
+ * typed stub per item type. Run once (`graphql-codegen --config scaffold.ts`),
  * then own and implement the output.
  */
 export declare function foirScaffold(options: FoirScaffoldOptions): CodegenConfig;

package/dist/codegen/shared.d.ts

@@ -2,11 +2,14 @@
  * Shared introspection helpers for the Foir codegen plugins.
  */
 import { type GraphQLSchema } from 'graphql';
-export interface BlockPluginConfig {
+export interface ItemPluginConfig {
     /**
-     * Union type name(s) to collect block members from. Defaults to `['Block']`
-     * (the canonical Foir block union). A project with a distinct content-field
-     * segment union lists it here too.
+     * Union type name(s) to collect item members from. When unset, the
+     * plugins DISCOVER the project's prose entries unions: every union whose
+     * member set includes `Passage` (each prose field's entries union is
+     * named by its materialised member set, so there is no single fixed
+     * name to configure). Set explicitly to narrow the registry to specific
+     * fields' unions.
      */
     unions?: string[];
     /** Import path for the codegen-generated types. Default `./graphql`. */
@@ -14,12 +17,20 @@ export interface BlockPluginConfig {
     /** Import path for the SDK content primitives. Default `@foir/sdk/content`. */
     sdkImport?: string;
 }
-export declare const DEFAULT_UNIONS: string[];
+/** @deprecated Renamed to {@link ItemPluginConfig}. */
+export type BlockPluginConfig = ItemPluginConfig;
 export declare const DEFAULT_GRAPHQL_IMPORT = "./graphql";
 export declare const DEFAULT_SDK_IMPORT = "@foir/sdk/content";
 /**
- * Collect the deduped, sorted set of object-type member names across the named
- * union(s). Throws when none of the unions resolve to members — that almost
- * always means a misconfigured union name or a schema that hasn't been pushed.
+ * Collect the deduped, sorted set of object-type member names across the
+ * named union(s) — or, when no names are given, across every prose entries
+ * union in the schema (the unions whose members include `Passage`).
+ * `Passage` itself is excluded: the content renderer owns passage
+ * rendering, so no registry component exists for it.
+ *
+ * Throws when nothing resolves — that almost always means a misconfigured
+ * union name, or a schema with no prose fields that place models.
  */
-export declare function collectBlockMembers(schema: GraphQLSchema, unionNames: string[]): string[];
+export declare function collectItemMembers(schema: GraphQLSchema, unionNames?: string[]): string[];
+/** @deprecated Renamed to {@link collectItemMembers}. */
+export declare const collectBlockMembers: typeof collectItemMembers;