@sanity/ailf 4.2.0 → 4.3.1

package/dist/sanity/queries.d.ts

@@ -20,34 +20,34 @@ export declare const FEATURE_AREA_QUERIES: {
     /**
      * Other Frameworks — Nuxt, React Router/Remix, Astro
      */
-    readonly frameworks: "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref in [\n          \"b2c937d0-34b3-435e-818b-d0c8520ea9b8\",\n          \"e223241c-e207-41e0-8e12-f80e78203cf1\",\n          \"73bebb61-e508-42b7-b44b-c4703ae42d01\"\n        ]\n        || (primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n            && (title match \"Remix*\" || title match \"Nuxt*\"\n                || title match \"Astro*\" || title match \"SvelteKit*\"))\n      )\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly frameworks: "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref in [\n          \"b2c937d0-34b3-435e-818b-d0c8520ea9b8\",\n          \"e223241c-e207-41e0-8e12-f80e78203cf1\",\n          \"73bebb61-e508-42b7-b44b-c4703ae42d01\"\n        ]\n        || (primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n            && (title match \"Remix*\" || title match \"Nuxt*\"\n                || title match \"Astro*\" || title match \"SvelteKit*\"))\n      )\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
     /**
      * Functions / Compute / AI — serverless functions, webhooks
      * Section: "Compute and AI" (12 articles)
      */
-    readonly functions: "\n    *[_type == \"article\"\n      && primarySection._ref == \"3024ce79-c196-49ee-a237-a327d6a6348f\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly functions: "\n    *[_type == \"article\"\n      && primarySection._ref == \"3024ce79-c196-49ee-a237-a327d6a6348f\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
     /**
      * GROQ Query Language — introduction, syntax, joins, filtering, projections
      * Combines: Content Lake section GROQ articles + Developer Guides articles
      * about querying + title-matched GROQ articles across all sections.
      */
-    readonly groq: "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref == \"60a6bcb5-9706-4cab-9153-57725e28f4d0\"\n        || primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n      )\n      && (\n        title match \"GROQ*\"\n        || title match \"*GROQ*\"\n        || title match \"Query*\"\n        || title match \"How Queries*\"\n        || slug.current match \"groq-*\"\n        || slug.current match \"query-*\"\n        || slug.current match \"how-queries-*\"\n        || slug.current match \"paginating-with-groq\"\n        || slug.current match \"high-performance-groq\"\n      )\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly groq: "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref == \"60a6bcb5-9706-4cab-9153-57725e28f4d0\"\n        || primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n      )\n      && (\n        title match \"GROQ*\"\n        || title match \"*GROQ*\"\n        || title match \"Query*\"\n        || title match \"How Queries*\"\n        || slug.current match \"groq-*\"\n        || slug.current match \"query-*\"\n        || slug.current match \"how-queries-*\"\n        || slug.current match \"paginating-with-groq\"\n        || slug.current match \"high-performance-groq\"\n      )\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
     /**
      * Next.js integration + Live Content API
      * Combines: Next.js quickstart section + developer-guide articles
      * mentioning Next.js or Live Content.
      */
-    readonly "nextjs-live": "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref == \"6208dff1-bba7-487a-a6bb-a0ffccb5846c\"\n        || (primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n            && (title match \"Next*\" || title match \"*Live*\"))\n      )\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly "nextjs-live": "\n    *[_type == \"article\"\n      && !(_id in path(\"drafts.**\"))\n      && (\n        primarySection._ref == \"6208dff1-bba7-487a-a6bb-a0ffccb5846c\"\n        || (primarySection._ref == \"ea6b80fa-d0d2-4daa-8220-eb8abdcc9deb\"\n            && (title match \"Next*\" || title match \"*Live*\"))\n      )\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
     /**
      * Studio Setup & Customization
      * Section: "Studio" (116 articles)
      */
-    readonly "studio-setup": "\n    *[_type == \"article\"\n      && primarySection._ref == \"d67e3879-0342-4a80-8a2d-e35908df35cc\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly "studio-setup": "\n    *[_type == \"article\"\n      && primarySection._ref == \"d67e3879-0342-4a80-8a2d-e35908df35cc\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
     /**
      * Visual Editing — Presentation tool, overlays, live preview
      * Section: "Visual Editing" (24 articles)
      */
-    readonly "visual-editing": "\n    *[_type == \"article\"\n      && primarySection._ref == \"4e0ef463-01e2-48db-9a31-38b3912ececd\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
+    readonly "visual-editing": "\n    *[_type == \"article\"\n      && primarySection._ref == \"4e0ef463-01e2-48db-9a31-38b3912ececd\"\n      && !(_id in path(\"drafts.**\"))\n    ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n  ";
 };
 export type FeatureArea = keyof typeof FEATURE_AREA_QUERIES;
 export declare const ALL_FEATURE_AREAS: FeatureArea[];
@@ -55,11 +55,11 @@ export declare const ALL_FEATURE_AREAS: FeatureArea[];
  * Fetch a single article by its slug.
  * Returns the same projection shape as the feature-area queries.
  */
-export declare const ARTICLE_BY_SLUG_QUERY = "\n  *[_type == \"article\"\n    && slug.current == $slug\n    && !(_id in path(\"drafts.**\"))\n  ][0] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
+export declare const ARTICLE_BY_SLUG_QUERY = "\n  *[_type == \"article\"\n    && slug.current == $slug\n    && !(_id in path(\"drafts.**\"))\n  ][0] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
 /**
  * Fetch all published articles (for full-corpus generation).
  */
-export declare const ALL_ARTICLES_QUERY = "\n  *[_type == \"article\"\n    && !(_id in path(\"drafts.**\"))\n  ] | order(primarySection->slug.current, title) {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
+export declare const ALL_ARTICLES_QUERY = "\n  *[_type == \"article\"\n    && !(_id in path(\"drafts.**\"))\n  ] | order(primarySection->slug.current, title) {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
 /**
  * Fetch article metadata for a list of slugs.
  *
@@ -76,7 +76,7 @@ export declare const ARTICLES_METADATA_BY_SLUGS_QUERY = "\n  *[_type == \"articl
  *
  * Returns the full article projection for content comparison.
  */
-export declare const ARTICLE_BY_SLUG_WITH_PERSPECTIVE_QUERY = "\n  *[_type == \"article\"\n    && slug.current == $slug\n  ][0] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
+export declare const ARTICLE_BY_SLUG_WITH_PERSPECTIVE_QUERY = "\n  *[_type == \"article\"\n    && slug.current == $slug\n  ][0] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
 /**
  * Fetch articles by their document IDs.
  *
@@ -86,7 +86,7 @@ export declare const ARTICLE_BY_SLUG_WITH_PERSPECTIVE_QUERY = "\n  *[_type == \"
  *
  * @param $ids — array of document ID strings
  */
-export declare const ARTICLES_BY_IDS_QUERY = "\n  *[_type == \"article\"\n    && _id in $ids\n  ] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
+export declare const ARTICLES_BY_IDS_QUERY = "\n  *[_type == \"article\"\n    && _id in $ids\n  ] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
 /**
  * Fetch arbitrary documents by their `_id` — no `_type` filter.
  *
@@ -117,7 +117,7 @@ export declare const DOCS_BY_IDS_QUERY = "\n  *[_id in $ids] {\n    _id,\n    _t
  *
  * @param $id — document ID string
  */
-export declare const ARTICLE_BY_ID_QUERY = "\n  *[_type == \"article\"\n    && _id == $id\n  ][0] {\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
+export declare const ARTICLE_BY_ID_QUERY = "\n  *[_type == \"article\"\n    && _id == $id\n  ][0] {\n  _id,\n  _type,\n  _rev,\n  title,\n  description,\n  \"slug\": slug.current,\n  \"section\": primarySection->{ \"slug\": slug.current, title },\n  \"content\": content[] {\n    // Pass through all standard blocks unchanged\n    _type != \"docsCardCollection\" => { ... },\n    // Resolve references inside card collections so we get titles/slugs\n    _type == \"docsCardCollection\" => {\n      ...,\n      cards[] {\n        ...,\n        \"resolvedTitle\": reference->title,\n        \"resolvedSlug\": reference->slug.current\n      }\n    }\n  }\n}\n";
 /**
  * Resolve an article slug from a URL path segment.
  *

package/dist/sanity/queries.js

@@ -43,8 +43,15 @@ const SECTION_IDS = {
  * Returns the raw Portable Text `content` array so that the Node-side
  * converter (@portabletext/markdown) can produce well-structured Markdown
  * with headings, code fences, tables, callouts, etc.
+ *
+ * `_id`, `_type`, and `_rev` are projected so a result satisfies the
+ * `DocumentForRender` shape and can dispatch through the renderer
+ * registry uniformly with id-ref-resolved docs (W0197).
  */
 const ARTICLE_PROJECTION = `{
+  _id,
+  _type,
+  _rev,
   title,
   description,
   "slug": slug.current,

package/dist/sanity/symbol-index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * symbol-index — Programmatic extractor that produces a flat list of
+ * identifiers the canonical reference legitimizes, each with a one-line
+ * provenance snippet.
+ *
+ * Used by the grader-context pathway (W0196 / W0197) so the LLM judge sees
+ * a compact, deterministic recognition reference instead of the full
+ * narrative doc — addresses the DOC-2117 prior-collision failure mode
+ * where a grader claimed `useEditDocument` did not exist.
+ *
+ * Two upstream sources, both fully programmatic (no LLM in the extractor):
+ *
+ *   - `extractSymbolIndex(blocks)` — walks Sanity Portable Text content
+ *     (article docs).
+ *   - `extractSymbolsFromTypedoc(json, packageName)` — parses typedoc
+ *     JSON (typesReference docs).
+ *
+ * `mergeSymbolIndexes(indexes)` combines indexes from multiple references
+ * into a single deduped index for a task.
+ *
+ * Source precedence (higher wins on dedup):
+ *   1. type-def      — typedoc declarations: literal authoritative type
+ *                      surface, no editorial layer between extracted
+ *                      symbol and the package's actual exports.
+ *   2. heading       — Section headings (`block` style h1..h4), including
+ *                      inline `code` marks within heading spans.
+ *   3. inline-code   — Inline `code` marks within non-heading `block` spans.
+ *   4. code-block    — Identifiers from `import` statements in `codeBlock`
+ *                      bodies. Body identifiers (`const foo = ...`) are
+ *                      intentionally not extracted — those are usage demos.
+ */
+export type SymbolProvenanceKind = "type-def" | "heading" | "inline-code" | "code-block";
+/** Declaration kinds we surface from typedoc JSON for `type-def` provenance. */
+export type TypeDefDeclarationKind = "function" | "class" | "interface" | "type" | "enum" | "variable" | "namespace";
+export interface SymbolProvenance {
+    kind: SymbolProvenanceKind;
+    /** Human-readable line that locates the symbol in the source doc. */
+    snippet: string;
+    /** Heading style when kind === "heading". */
+    style?: "h1" | "h2" | "h3" | "h4";
+    /** Source filename when kind === "code-block" and one is set on the block. */
+    filename?: string;
+    /** Code block language tag when kind === "code-block". */
+    language?: string;
+    /** Declaration kind when kind === "type-def". */
+    declarationKind?: TypeDefDeclarationKind;
+    /** Source package (e.g. `@sanity/sdk-react`) when kind === "type-def". */
+    package?: string;
+}
+export interface SymbolEntry {
+    symbol: string;
+    provenance: SymbolProvenance;
+}
+export interface SymbolIndex {
+    symbols: SymbolEntry[];
+}
+export declare function extractSymbolIndex(blocks: unknown): SymbolIndex;
+/**
+ * Extract a symbol index from a typedoc JSON document (schema 2.x — the
+ * shape produced by `typedoc --json`). Each top-level export becomes a
+ * `type-def` provenance entry with the symbol name, declaration kind
+ * (function / interface / type / etc.), and the JSDoc summary as snippet.
+ *
+ * Type-def is the highest-precedence source: typedoc declarations are
+ * literal authoritative type surface, no editorial layer between them
+ * and the package's actual exports. If a symbol also appears in narrative
+ * docs (heading, inline code, code-block import) the type-def entry wins
+ * on dedup.
+ *
+ * `body` is the raw JSON string fetched from the typesReference's
+ * attachment URL. Returns an empty index for any unparseable input — this
+ * is best-effort recognition material; callers fall back to full-doc
+ * injection when extraction yields nothing.
+ */
+export declare function extractSymbolsFromTypedoc(body: string, packageName?: string): SymbolIndex;
+/**
+ * Compute per-tier counts for a SymbolIndex. Used by the fetcher to
+ * populate the per-task manifest entry's `tierBreakdown` field.
+ */
+export declare function symbolIndexTierBreakdown(index: SymbolIndex): {
+    typeDef: number;
+    heading: number;
+    inlineCode: number;
+    codeBlock: number;
+};
+/**
+ * Combine multiple `SymbolIndex` instances (typically from different
+ * canonical references for the same task) into a single deduped index
+ * preserving precedence.
+ */
+export declare function mergeSymbolIndexes(indexes: readonly SymbolIndex[]): SymbolIndex;
+/**
+ * Render a SymbolIndex as a compact markdown reference suitable for
+ * injection into a grader's `rubricPrompt` as ground-truth recognition
+ * material. Layout intentionally puts headings first so the most
+ * authoritative symbols anchor the top of the list.
+ */
+export declare function renderSymbolIndex(index: SymbolIndex, title?: string): string;