@bendyline/squisq 2.10.0 → 2.11.1

package/dist/{chunk-XSW4QTMB.js → chunk-QQ4I5HWV.js}

@@ -30,7 +30,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-DRFJU4MK.js";
+} from "./chunk-B26DU2RH.js";
 import {
   iconMarker
 } from "./chunk-7ZAAICW4.js";
@@ -45,11 +45,12 @@ import {
   detectAsciiDiagram,
   isHoriz,
   isJunction,
+  isLineChar,
   isVert,
   toCells,
   toGrid,
   traceBoxes
-} from "./chunk-CUYHFOFL.js";
+} from "./chunk-6ATZOUCQ.js";
 import {
   defaultPageStyle,
   resolveMediaSchedule
@@ -75,15 +76,16 @@ import {
 } from "./chunk-BAOV476U.js";
 import {
   parseMarkdown
-} from "./chunk-MIKKUKOD.js";
+} from "./chunk-UBFT2CDQ.js";
 import {
   KNOWN_BLOCK_META_KEYS,
+  TABLE_FED_TEMPLATES,
   TEMPLATE_ALIASES,
   coerceAnnotationValues,
   isContainerTemplate,
   resolveTemplateName,
   serializeAnnotation
-} from "./chunk-NBKAXPSX.js";
+} from "./chunk-TMOHAFYE.js";
 import {
   extractPlainText,
   getChildren,
@@ -1148,6 +1150,19 @@ var content = (input) => {
     slots: { title: c.title, body: bodyRichText(input) }
   };
 };
+var transcript = (input) => {
+  const t = input;
+  const attribution = t.counterpartName ? `${t.speaker} \u2192 ${t.counterpartName}` : t.speaker;
+  return {
+    kind: "quote-band",
+    variant: "plain",
+    slots: {
+      title: t.variant === "tool" ? t.toolName : void 0,
+      body: { text: t.text ?? "" },
+      attribution
+    }
+  };
+};
 var statHighlight = (input) => {
   const s = input;
   return {
@@ -1426,6 +1441,7 @@ var sectionExtractors = {
   title,
   sectionHeader,
   bigText,
+  transcript,
   content,
   statHighlight,
   quote,
@@ -4267,6 +4283,177 @@ function assignSegmentIndices(blocks, blockToSegment, inheritedSegment) {
   });
 }
 
+// src/doc/dataReferences.ts
+var DATA_FILE_EXTENSIONS = ["csv", "tsv", "xlsx", "parquet"];
+var WORKBOOK_EXTENSIONS = /* @__PURE__ */ new Set(["xlsx"]);
+function extensionOf(path) {
+  const base = path.split("/").pop() ?? path;
+  const dot = base.lastIndexOf(".");
+  return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+}
+function isDataFilePath(path) {
+  if (!path || /^(?:[a-z][a-z0-9+.-]*:|\/\/|\/)/i.test(path)) return false;
+  return DATA_FILE_EXTENSIONS.includes(extensionOf(path));
+}
+function dataSidecarPrefix(docBasename) {
+  return `${docBasename}_files/data/`;
+}
+var DEFAULT_MAX_PREVIEW_ROWS = 50;
+function hasAuthoredData(block) {
+  const provided = (key) => !!(block.templateData && key in block.templateData) || !!(block.templateOverrides && key in block.templateOverrides);
+  return provided("headers") || provided("rows");
+}
+function isEligible(block) {
+  return !!block.templateOverrides?.src && TABLE_FED_TEMPLATES.has(resolveTemplateName(block.template ?? ""));
+}
+async function resolveDataReferences(doc, container, options) {
+  const diagnostics = [];
+  const maxPreviewRows = options.maxPreviewRows ?? DEFAULT_MAX_PREVIEW_ROWS;
+  const readerByExt = /* @__PURE__ */ new Map();
+  for (const reader of options.readers) {
+    for (const ext of reader.extensions) readerByExt.set(ext.toLowerCase(), reader);
+  }
+  const fileCache = /* @__PURE__ */ new Map();
+  const readCached = (path) => {
+    let pending = fileCache.get(path);
+    if (!pending) {
+      pending = container.readFile(path).catch(() => null);
+      fileCache.set(path, pending);
+    }
+    return pending;
+  };
+  const resolveBlock = async (block) => {
+    const overrides = block.templateOverrides;
+    const src = overrides.src;
+    const ext = extensionOf(src);
+    if (!isDataFilePath(src)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "data-src-no-reader",
+        message: `Block "${block.id}": src "${src}" is not a relative data-file path (.${DATA_FILE_EXTENSIONS.join("/.")}).`,
+        blockId: block.id
+      });
+      return null;
+    }
+    const reader = readerByExt.get(ext);
+    if (!reader) {
+      diagnostics.push({
+        severity: "warning",
+        code: "data-src-no-reader",
+        message: `Block "${block.id}": no data reader registered for ".${ext}" (src "${src}").`,
+        blockId: block.id
+      });
+      return null;
+    }
+    if ((overrides.sheet || overrides.anchor) && !WORKBOOK_EXTENSIONS.has(ext)) {
+      diagnostics.push({
+        severity: "info",
+        code: "data-src-param-ignored",
+        message: `Block "${block.id}": sheet/anchor only address workbook sources; ignored for ".${ext}".`,
+        blockId: block.id
+      });
+    }
+    const bytes = await readCached(src);
+    if (!bytes) {
+      diagnostics.push({
+        severity: "warning",
+        code: "data-src-missing",
+        message: `Block "${block.id}": data file "${src}" was not found in the document container.`,
+        blockId: block.id
+      });
+      return null;
+    }
+    const parsedPreviewRows = Number.parseInt(overrides.previewRows ?? "", 10);
+    const maxRows = Number.isFinite(parsedPreviewRows) && parsedPreviewRows > 0 ? parsedPreviewRows : maxPreviewRows;
+    const readOpts = {
+      ...overrides.sheet ? { sheet: overrides.sheet } : {},
+      ...overrides.anchor ? { anchor: overrides.anchor } : {},
+      ...overrides.headerRow !== void 0 ? { headerRow: overrides.headerRow !== "false" } : {},
+      ...overrides.sort ? { sort: overrides.sort } : {},
+      ...overrides.filter ? { filter: overrides.filter } : {},
+      maxRows
+    };
+    let table;
+    try {
+      const cacheKey = [
+        src,
+        readOpts.sheet ?? "",
+        readOpts.anchor ?? "",
+        String(readOpts.headerRow ?? ""),
+        readOpts.sort ?? "",
+        readOpts.filter ?? "",
+        String(maxRows)
+      ].join("\0");
+      let pending = options.tableCache?.get(cacheKey);
+      if (!pending) {
+        pending = reader.read(bytes, readOpts);
+        options.tableCache?.set(cacheKey, pending);
+      }
+      table = await pending;
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      const sheetMiss = /sheet|worksheet/i.test(reason) && WORKBOOK_EXTENSIONS.has(ext);
+      diagnostics.push({
+        severity: sheetMiss ? "warning" : "error",
+        code: sheetMiss ? "data-src-sheet-missing" : "data-src-parse",
+        message: `Block "${block.id}": could not read "${src}": ${reason}`,
+        blockId: block.id
+      });
+      return null;
+    }
+    for (const issue of table.viewIssues ?? []) {
+      diagnostics.push({
+        severity: "info",
+        code: issue.code,
+        message: `Block "${block.id}": ${issue.message}`,
+        blockId: block.id
+      });
+    }
+    const srcStats = {
+      totalRows: table.totalRows,
+      totalCols: table.totalCols,
+      previewRows: table.rows.length,
+      truncated: table.rows.length < table.totalRows,
+      ...table.unfilteredTotalRows !== void 0 ? { unfilteredTotalRows: table.unfilteredTotalRows } : {}
+    };
+    return {
+      ...block,
+      templateData: {
+        headers: table.headers,
+        rows: table.rows,
+        ...table.align ? { align: table.align } : {},
+        srcStats,
+        ...block.templateData
+      }
+    };
+  };
+  let changed = false;
+  const resolveBlocks = async (blocks2) => {
+    const next = await Promise.all(
+      blocks2.map(async (block) => {
+        let replacement = null;
+        if (isEligible(block) && !hasAuthoredData(block)) {
+          replacement = await resolveBlock(block);
+        }
+        let children = block.children;
+        if (block.children && block.children.length > 0) {
+          children = await resolveBlocks(block.children);
+        }
+        if (!replacement && children === block.children) return block;
+        changed = true;
+        const base = replacement ?? block;
+        return children === block.children ? base : { ...base, children };
+      })
+    );
+    return next.some((b, i) => b !== blocks2[i]) ? next : blocks2;
+  };
+  const blocks = await resolveBlocks(doc.blocks);
+  return {
+    doc: changed ? { ...doc, blocks } : doc,
+    diagnostics
+  };
+}
+
 // src/doc/validate.ts
 function validateMarkdownSource(source, options) {
   return validateMarkdownDoc(parseMarkdown(source), options);
@@ -4929,6 +5116,19 @@ function pickSides(s, t) {
   gaps.sort((a, b) => a.gap - b.gap);
   return { exit: gaps[0].side, enter: gaps[0].side };
 }
+function blockedAttachmentColumns(p) {
+  const blocked = /* @__PURE__ */ new Set();
+  const innerW = p.rect.c1 - p.rect.c0 - 1;
+  const lines = p.isContainer ? p.labelLines.slice(1) : p.labelLines;
+  for (const line of lines) {
+    const cells = toCells(line);
+    const pad = Math.max(0, Math.floor((innerW - cells.length) / 2));
+    cells.forEach((ch, j) => {
+      if (isLineChar(ch)) blocked.add(p.rect.c0 + 1 + pad + j);
+    });
+  }
+  return blocked;
+}
 function assignAttachments(plans, placed) {
   const bySide = /* @__PURE__ */ new Map();
   plans.forEach((plan, i) => {
@@ -4957,13 +5157,31 @@ function assignAttachments(plans, placed) {
     const to = horizontal ? node.rect.c1 - 1 : node.rect.r1 - 1;
     const inner = Math.max(1, to - from + 1);
     const k = list2.length;
+    const blocked = horizontal ? blockedAttachmentColumns(node) : /* @__PURE__ */ new Set();
+    const taken = [];
+    const place = (want) => {
+      const free = (pos) => pos >= from && pos <= to && !blocked.has(pos) && taken.every((t) => Math.abs(t - pos) >= 2);
+      for (let d = 0; d <= inner; d++) {
+        for (const pos of d === 0 ? [want] : [want - d, want + d]) {
+          if (!free(pos)) continue;
+          taken.push(pos);
+          return pos;
+        }
+      }
+      taken.push(want);
+      return want;
+    };
     if (k === 1) {
-      result.set(list2[0].key, { pos: from + Math.floor((inner - 1) / 2), index: 0, count: 1 });
+      result.set(list2[0].key, {
+        pos: place(from + Math.floor((inner - 1) / 2)),
+        index: 0,
+        count: 1
+      });
     } else {
       const span = 2 * k - 1;
       const start = from + Math.max(0, Math.floor((inner - span) / 2));
       list2.forEach((req, i) => {
-        result.set(req.key, { pos: Math.min(to, start + 2 * i), index: i, count: k });
+        result.set(req.key, { pos: place(Math.min(to, start + 2 * i)), index: i, count: k });
       });
     }
   }
@@ -5874,6 +6092,10 @@ export {
   applyNarrationTiming,
   scoreTextSimilarity,
   resolveAudioMapping,
+  DATA_FILE_EXTENSIONS,
+  isDataFilePath,
+  dataSidecarPrefix,
+  resolveDataReferences,
   validateMarkdownSource,
   validateMarkdownDoc,
   renderAsciiDiagram,

package/dist/{chunk-NBKAXPSX.js → chunk-TMOHAFYE.js}

@@ -35,6 +35,7 @@ var TEMPLATE_TOKEN_NAMES = /* @__PURE__ */ new Set([
   "title",
   "sectionHeader",
   "bigText",
+  "transcript",
   "content",
   "statHighlight",
   "quote",

package/dist/{chunk-MIKKUKOD.js → chunk-UBFT2CDQ.js}

@@ -6,7 +6,7 @@ import {
   quoteAttrValue,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-NBKAXPSX.js";
+} from "./chunk-TMOHAFYE.js";
 import {
   resolveIcon
 } from "./chunk-7N4G32LG.js";
@@ -259,7 +259,8 @@ function convertInlineChildren(children, parseHtml, applyIconSplit = true) {
     if (node) result.push(node);
   }
   const mentioned = coalesceMentions(result);
-  const split = applyIconSplit ? splitInlineIcons(mentioned) : mentioned;
+  const repaired = recombineDirectiveTokens(mentioned);
+  const split = applyIconSplit ? splitInlineIcons(repaired) : repaired;
   return foldPairedInlineHtml(split);
 }
 var PAIRED_INLINE_HTML = /* @__PURE__ */ new Map([
@@ -341,24 +342,38 @@ function recombineDirectiveTokens(nodes) {
   const out = [];
   for (let i = 0; i < nodes.length; i++) {
     const cur = nodes[i];
-    const next = nodes[i + 1];
-    const after = nodes[i + 2];
-    if (cur?.type === "text" && next?.type === "textDirective" && after?.type === "text" && /\{\[[a-zA-Z0-9_-]+$/.test(cur.value) && /^\]\}/.test(after.value)) {
-      const directive = next;
-      const directiveName = directive.name ?? "";
-      const merged = {
-        type: "text",
-        value: cur.value + ":" + directiveName + after.value,
-        ...cur.position ? { position: cur.position } : {}
-      };
-      out.push(merged);
-      i += 2;
-      continue;
+    if (cur?.type === "text") {
+      let value = cur.value;
+      let j = i;
+      while (hasUnclosedAnnotationSpan(value) && nodes[j + 1]?.type === "textDirective") {
+        const directive = nodes[j + 1];
+        value += ":" + (directive.name ?? "");
+        j += 1;
+        const following = nodes[j + 1];
+        if (following?.type === "text") {
+          value += following.value;
+          j += 1;
+        }
+      }
+      if (j !== i) {
+        out.push({
+          type: "text",
+          value,
+          ...cur.position ? { position: cur.position } : {}
+        });
+        i = j;
+        continue;
+      }
     }
     out.push(cur);
   }
   return out;
 }
+function hasUnclosedAnnotationSpan(text) {
+  const open = text.lastIndexOf("{[");
+  if (open === -1) return false;
+  return !text.includes("]}", open);
+}
 var ICON_TOKEN_RE = /\{\[([a-zA-Z0-9_:-]+)\]\}/g;
 function splitTextOnIcons(value, position) {
   if (!value) return [];

package/dist/{chunk-FCG3BIZN.js → chunk-UNVHAK3A.js}

@@ -230,7 +230,11 @@ var EXTENSION_MIME_MAP = {
   ".ogg": "audio/ogg",
   ".css": "text/css",
   ".html": "text/html",
-  ".js": "application/javascript"
+  ".js": "application/javascript",
+  ".csv": "text/csv",
+  ".tsv": "text/tab-separated-values",
+  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ".parquet": "application/vnd.apache.parquet"
 };
 function guessMimeType(path) {
   const dot = path.lastIndexOf(".");

package/dist/{chunk-NFHMHYUV.js → chunk-UXKFSYTQ.js}

@@ -3,7 +3,7 @@ import {
   expectedSyllablesAt,
   flattenRenderableBlocks,
   wordPosAtExpectedSyllables
-} from "./chunk-DRFJU4MK.js";
+} from "./chunk-B26DU2RH.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/doc/index.d.ts

@@ -1,11 +1,12 @@
-import { bb as TemplateBlock, bc as TemplateContext, a3 as Layer, w as CustomTemplateDefinition, be as TemplateRegistry, bh as Theme, bL as ViewportConfig, aL as PersistentLayerConfig, P as DocBlock, bM as ViewportOrientation, aK as PersistentLayer, bu as TitleBlockInput, b0 as SectionHeaderInput, j as BigTextInput, u as ContentBlockInput, b6 as StatHighlightInput, aW as QuoteBlockInput, V as FactCardInput, bB as TwoColumnInput, H as DateEventInput, a1 as ImageWithCaptionInput, a6 as LeftFeatureInput, aZ as RightFeatureInput, aa as MapBlockInput, b5 as StartBlockConfig, Y as FullBleedQuoteInput, a9 as ListBlockInput, aP as PhotoGridInput, J as DefinitionCardInput, t as ComparisonBarInput, aV as PullQuoteInput, bK as VideoWithCaptionInput, bJ as VideoPullQuoteInput, G as DataTableInput, K as DiagramBlockInput, bw as TreeBlockInput, bq as TimelineBlockInput, k as Block, S as DrawingBlockInput, ae as MarkerStyle, A as AccentImage, a0 as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, bj as ThemeColorScheme, O as Doc, bl as ThemeRegistry, aD as PageEmphasis, bk as ThemePageStyle, Q as DocDiagnostic, N as DiagramTemplateNode, M as DiagramTemplateEdge, bt as TimelineTemplateTrack, bs as TimelineTemplateLink } from '../Doc-DTyeaFuW.js';
-export { T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, a5 as LayoutHints, aY as RenderStyle, bi as ThemeColorPalette, bo as ThemeStyle, bp as ThemeTypography, bC as VIEWPORT_PRESETS, bN as ViewportPreset, bS as createTemplateContext, bZ as getLayoutHints, c0 as getTwoColumnPositions, c1 as getViewport, c2 as getViewportOrientation, c5 as isTemplateBlock, c8 as scaledFontSize } from '../Doc-DTyeaFuW.js';
+import { bb as TemplateBlock, bc as TemplateContext, a3 as Layer, w as CustomTemplateDefinition, be as TemplateRegistry, bh as Theme, bM as ViewportConfig, aL as PersistentLayerConfig, P as DocBlock, bN as ViewportOrientation, aK as PersistentLayer, bu as TitleBlockInput, b0 as SectionHeaderInput, j as BigTextInput, u as ContentBlockInput, b6 as StatHighlightInput, aW as QuoteBlockInput, V as FactCardInput, bC as TwoColumnInput, H as DateEventInput, a1 as ImageWithCaptionInput, a6 as LeftFeatureInput, aZ as RightFeatureInput, aa as MapBlockInput, b5 as StartBlockConfig, Y as FullBleedQuoteInput, a9 as ListBlockInput, aP as PhotoGridInput, J as DefinitionCardInput, t as ComparisonBarInput, aV as PullQuoteInput, bL as VideoWithCaptionInput, bK as VideoPullQuoteInput, G as DataTableInput, K as DiagramBlockInput, bx as TreeBlockInput, bq as TimelineBlockInput, k as Block, S as DrawingBlockInput, ae as MarkerStyle, A as AccentImage, a0 as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, bj as ThemeColorScheme, O as Doc, bl as ThemeRegistry, aD as PageEmphasis, bk as ThemePageStyle, Q as DocDiagnostic, N as DiagramTemplateNode, M as DiagramTemplateEdge, bt as TimelineTemplateTrack, bs as TimelineTemplateLink } from '../Doc-CRPQCkHn.js';
+export { T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, a5 as LayoutHints, aY as RenderStyle, bi as ThemeColorPalette, bo as ThemeStyle, bp as ThemeTypography, bD as VIEWPORT_PRESETS, bO as ViewportPreset, bT as createTemplateContext, b_ as getLayoutHints, c1 as getTwoColumnPositions, c2 as getViewport, c3 as getViewportOrientation, c6 as isTemplateBlock, c9 as scaledFontSize } from '../Doc-CRPQCkHn.js';
 import { L as MarkdownNode, a5 as TransitionType, a4 as TransitionDirection, M as MarkdownBlockNode, r as MarkdownHeading, n as MarkdownDocument, V as MarkdownTable, i as MarkdownCodeBlock, G as MarkdownList } from '../types-Be6sBUBx.js';
 import { C as CoercedBlockMeta } from '../annotationCoercion-Ckqpu33y.js';
-import { c as PageSection } from '../materializePageSection-BRNIINlU.js';
-export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-BRNIINlU.js';
+import { c as PageSection } from '../materializePageSection-BeUPHeCl.js';
+export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-BeUPHeCl.js';
 import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-xaxN5UYu.js';
+import { V as ViewIssue } from '../viewState-lTZS-hP_.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BG3jr6mT.js';
 
 /** Runtime registry composition for built-in and document-scoped templates. */
 
@@ -149,6 +150,12 @@ declare const TEMPLATE_AUTHORING_METADATA: {
         readonly safeForContentFirst: true;
         readonly placement: "heading";
     };
+    readonly transcript: {
+        readonly role: "content";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
     readonly statHighlight: {
         readonly role: "highlight";
         readonly bodyPolicy: "derived";
@@ -403,6 +410,15 @@ declare const BLOCK_MEDIA_LAYOUT_POLICIES: {
         readonly unconsumedMedia: "reserve-when-no-native-media";
         readonly variants: SupplementalMediaVariantMatrix;
     };
+    readonly transcript: {
+        readonly summary: "Speaker avatars are native media (initials medallions when absent); other media stays supplemental.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
     readonly content: {
         readonly summary: "Preserves the complete heading and body; supplemental media receives a companion field.";
         readonly noMedia: "template-default";
@@ -3164,6 +3180,107 @@ interface NarrationResolution {
  */
 declare function applyNarrationTiming(doc: Doc, container: ContentContainer): Promise<NarrationResolution>;
 
+/** File extensions (lowercase, no dot) recognized as sidecar data files. */
+declare const DATA_FILE_EXTENSIONS: readonly ["csv", "tsv", "xlsx", "parquet"];
+/**
+ * True when `path` is a relative container path ending in a data extension.
+ * Absolute/protocol URLs are never data sidecar references.
+ */
+declare function isDataFilePath(path: string): boolean;
+/**
+ * The sidecar directory for a document's data files:
+ * `<docbasename>_files/data/`. One helper owns the convention so importers,
+ * the editor's drop pipeline, and hosts agree on where data lives.
+ */
+declare function dataSidecarPrefix(docBasename: string): string;
+/** A bounded window of tabular data read from a sidecar file. */
+interface DataSourceTable {
+    headers: string[];
+    /** Preview window of data rows, cells stringified for display. */
+    rows: string[][];
+    align?: ('left' | 'center' | 'right' | null)[];
+    /**
+     * Full data-row count in the source AFTER any view-state filter (not just
+     * the preview window). With no filter this is the raw row count.
+     */
+    totalRows: number;
+    totalCols: number;
+    /** Raw row count before filtering, when a filter was applied. */
+    unfilteredTotalRows?: number;
+    /** Problems parsing/applying `sort`/`filter` (see `@bendyline/squisq/table`). */
+    viewIssues?: ViewIssue[];
+}
+interface DataSourceReadOptions {
+    /** Worksheet name (workbook sources only). */
+    sheet?: string;
+    /** Top-left cell of the region, e.g. `'B7'` (workbook sources only). */
+    anchor?: string;
+    /** Whether row 1 of the source is a header row. Default true. */
+    headerRow?: boolean;
+    /** Maximum data rows to return in `rows`. */
+    maxRows: number;
+    /**
+     * Raw view-state params (`{[dataTable … sort=… filter=…]}`). Readers parse
+     * them against their REAL headers and apply `applyTableViewState` on the
+     * full body BEFORE windowing to `maxRows` — the resolver cannot do it, the
+     * rows are already gone by then. Problems surface via
+     * `DataSourceTable.viewIssues`, never a throw.
+     */
+    sort?: string;
+    filter?: string;
+}
+/**
+ * Decodes one family of data files. `extensions` are lowercase without the
+ * dot (`['csv', 'tsv']`). `read` may throw — the resolver converts failures
+ * into diagnostics rather than propagating them.
+ */
+interface DataSourceReader {
+    extensions: readonly string[];
+    read(data: ArrayBuffer, opts: DataSourceReadOptions): Promise<DataSourceTable>;
+}
+interface ResolveDataReferencesOptions {
+    readers: readonly DataSourceReader[];
+    /** Preview window size when a block has no `previewRows` param. Default 50. */
+    maxPreviewRows?: number;
+    /**
+     * Caller-owned memo of reader reads, keyed by src + read options. A
+     * reader read is a FULL-body parse (view state applies before
+     * windowing), and the editor's projection path re-resolves on every
+     * debounce — for a 20 MB sidecar that cost per keystroke is not
+     * acceptable. The CALLER owns invalidation: clear or replace the map
+     * when the underlying bytes may have changed (the editor scopes its
+     * cache to the container and clears it on every mediaRevision bump).
+     */
+    tableCache?: Map<string, Promise<DataSourceTable>>;
+}
+interface ResolvedDataReferences {
+    /** The doc with previews filled in — the SAME object when nothing changed. */
+    doc: Doc;
+    diagnostics: DocDiagnostic[];
+}
+/** Stats recorded on `templateData.srcStats` alongside the preview rows. */
+interface DataSourceStats {
+    /** Data rows after any view-state filter. */
+    totalRows: number;
+    totalCols: number;
+    previewRows: number;
+    truncated: boolean;
+    /** Raw source rows before filtering, when a filter was applied. */
+    unfilteredTotalRows?: number;
+}
+/**
+ * Resolve every `src`-referenced table/chart block against the container.
+ *
+ * - Author data wins: blocks that already carry `headers`/`rows` (data fence,
+ *   `{[…]}` params) are left untouched.
+ * - Failures never throw: a missing file, unknown extension, or reader error
+ *   becomes a diagnostic and the block is left as-is — its body link still
+ *   renders in every projection.
+ * - Identity short-circuit: when no block changed, the input doc object is
+ *   returned unchanged.
+ */
+declare function resolveDataReferences(doc: Doc, container: ContentContainer, options: ResolveDataReferencesOptions): Promise<ResolvedDataReferences>;
+
 /**
  * Structured template data from markdown body content.
  *
@@ -3911,4 +4028,4 @@ declare function treeFromMarkdownList(list: MarkdownList): Tree;
 /** Find the first top-level markdown list in a block's body, if any. */
 declare function findFirstList(contents: MarkdownBlockNode[] | undefined): MarkdownList | undefined;
 
-export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, BUILTIN_DASHBOARD_LAYOUTS, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuildPreviewDocOptions, type BuiltInTemplateName, CONTAINER_TEMPLATES, COVER_SLIDE_FRONTMATTER_KEYS, COVER_SLIDE_TEMPLATE_OPTIONS, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, type CoverSlidePlayback, type CoverSlideSettings, type CoverSlideTemplate, type CoverSlideTemplateOption, DASHBOARD_AUTO_LAYOUT_ID, DASHBOARD_FRONTMATTER_KEYS, DASHBOARD_STYLES, DASHBOARD_STYLE_IDS, DASHBOARD_ZOOM_LEVELS, DEFAULT_COVER_SLIDE_SETTINGS, DEFAULT_DASHBOARD_SETTINGS, DEFAULT_DASHBOARD_STYLE, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DashboardCell, type DashboardCellChrome, type DashboardCellDefinition, type DashboardCellFrame, type DashboardDiagnostic, type DashboardLayoutDefinition, type DashboardLayoutSummary, type DashboardLayoutValidationError, type DashboardLayoutValidationResult, type DashboardMaterialization, type DashboardRectPct, type DashboardSettings, type DashboardSettingsOverrides, type DashboardStyleId, type DashboardStyleSummary, type DashboardTitle, type DashboardTitleSlotDefinition, type DashboardZoomCandidate, type DashboardZoomLevel, type DashboardZoomMode, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, FRONTMATTER_DASHBOARD_LAYOUTS_KEY, type FirstImage, type Flashcard, type FlashcardChoice, type FlashcardDeck, type FlashcardDiagnostic, type FlashcardDiagnosticCode, type FlashcardFace, type FlashcardKind, type FlashcardSourceMode, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, MAX_COVER_SLIDE_DURATION_SECONDS, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type MaterializeDashboardOptions, type MaterializeFlashcardsOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedDashboardCell, type ResolvedPageBlock, type RichListItem, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TABLE_FED_TEMPLATES, TEMPLATE_AUTHORING_METADATA, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, type TemplateAuthoringMetadata, type TemplateAuthoringRole, TemplateBlock, type TemplateBodyPolicy, TemplateContext, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, bigText, buildDashboardCellChrome, buildPageCss, buildPageCssVars, buildPreviewDoc, buildRegistry, canvasToAsciiCell, chooseDashboardLayout, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, composeDashboardLayers, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, contentBlock, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dashboardCanvasFill, dashboardCellAccent, dataTable, dateEvent, definitionCard, deriveTemplateInputs, desiredCellZoom, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, documentTitleFromFileName, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitBigTextSize, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDashboardLayoutSummaries, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, layoutCapacity, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, listDashboardLayouts, mapBlock, markdownBlockSeparatorLines, markdownToDoc, markerPath, materializeBlockLayers, materializeDashboard, materializeFlashcards, nearestSnapPoint, normalizeDashboardZoom, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, readDashboardLayoutsFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderMarkdownBlocksHtml, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolveCoverSlideSettings, resolveDashboardLayoutDefinition, resolveDashboardSettings, resolveDashboardStyleId, resolveDashboardZooms, resolveFlashcardMarker, resolveLayoutCells, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, stripBlockBackdropLayer, stripsBlockBackdrop, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, transposeCells, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateDashboardLayoutDefinition, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter, writeDashboardLayoutsToFrontmatter };
+export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, BUILTIN_DASHBOARD_LAYOUTS, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuildPreviewDocOptions, type BuiltInTemplateName, CONTAINER_TEMPLATES, COVER_SLIDE_FRONTMATTER_KEYS, COVER_SLIDE_TEMPLATE_OPTIONS, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, type CoverSlidePlayback, type CoverSlideSettings, type CoverSlideTemplate, type CoverSlideTemplateOption, DASHBOARD_AUTO_LAYOUT_ID, DASHBOARD_FRONTMATTER_KEYS, DASHBOARD_STYLES, DASHBOARD_STYLE_IDS, DASHBOARD_ZOOM_LEVELS, DATA_FILE_EXTENSIONS, DEFAULT_COVER_SLIDE_SETTINGS, DEFAULT_DASHBOARD_SETTINGS, DEFAULT_DASHBOARD_STYLE, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DashboardCell, type DashboardCellChrome, type DashboardCellDefinition, type DashboardCellFrame, type DashboardDiagnostic, type DashboardLayoutDefinition, type DashboardLayoutSummary, type DashboardLayoutValidationError, type DashboardLayoutValidationResult, type DashboardMaterialization, type DashboardRectPct, type DashboardSettings, type DashboardSettingsOverrides, type DashboardStyleId, type DashboardStyleSummary, type DashboardTitle, type DashboardTitleSlotDefinition, type DashboardZoomCandidate, type DashboardZoomLevel, type DashboardZoomMode, type DataFenceParseResult, type DataSourceReadOptions, type DataSourceReader, type DataSourceStats, type DataSourceTable, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, FRONTMATTER_DASHBOARD_LAYOUTS_KEY, type FirstImage, type Flashcard, type FlashcardChoice, type FlashcardDeck, type FlashcardDiagnostic, type FlashcardDiagnosticCode, type FlashcardFace, type FlashcardKind, type FlashcardSourceMode, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, MAX_COVER_SLIDE_DURATION_SECONDS, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type MaterializeDashboardOptions, type MaterializeFlashcardsOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolveDataReferencesOptions, type ResolvedDashboardCell, type ResolvedDataReferences, type ResolvedPageBlock, type RichListItem, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TABLE_FED_TEMPLATES, TEMPLATE_AUTHORING_METADATA, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, type TemplateAuthoringMetadata, type TemplateAuthoringRole, TemplateBlock, type TemplateBodyPolicy, TemplateContext, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, bigText, buildDashboardCellChrome, buildPageCss, buildPageCssVars, buildPreviewDoc, buildRegistry, canvasToAsciiCell, chooseDashboardLayout, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, composeDashboardLayers, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, contentBlock, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dashboardCanvasFill, dashboardCellAccent, dataSidecarPrefix, dataTable, dateEvent, definitionCard, deriveTemplateInputs, desiredCellZoom, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, documentTitleFromFileName, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitBigTextSize, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDashboardLayoutSummaries, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isDataFilePath, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, layoutCapacity, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, listDashboardLayouts, mapBlock, markdownBlockSeparatorLines, markdownToDoc, markerPath, materializeBlockLayers, materializeDashboard, materializeFlashcards, nearestSnapPoint, normalizeDashboardZoom, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, readDashboardLayoutsFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderMarkdownBlocksHtml, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolveCoverSlideSettings, resolveDashboardLayoutDefinition, resolveDashboardSettings, resolveDashboardStyleId, resolveDashboardZooms, resolveDataReferences, resolveFlashcardMarker, resolveLayoutCells, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, stripBlockBackdropLayer, stripsBlockBackdrop, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, transposeCells, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateDashboardLayoutDefinition, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter, writeDashboardLayoutsToFrontmatter };