@bendyline/squisq 2.9.0 → 2.11.0

package/dist/narration/index.d.ts

@@ -1,5 +1,5 @@
-import { O as Doc, f as AudioBookmark } from '../Doc-DBadkoP4.js';
-import '../types-CcrDFdWH.js';
+import { O as Doc, f as AudioBookmark } from '../Doc-CRPQCkHn.js';
+import '../types-Be6sBUBx.js';
 
 /**
  * Shared types + tuning configs for the narration engine.
@@ -610,10 +610,19 @@ interface NarrationTimingJsonV3 {
     /** Provenance of the timing data. */
     generator?: {
         name: string;
-        method: 'dsp-align';
+        method: NarrationTimingMethod;
         baseWpm?: number;
     };
 }
+/**
+ * How a sidecar's block ranges were produced.
+ *
+ * - `'dsp-align'` — the teleprompter's offline banded-DTW aligner inferred
+ *   them from the take's audio against the expected script.
+ * - `'presenter-advance'` — the presenter drove them directly, by advancing
+ *   slides in the recorder while the take rolled. Observed, not inferred.
+ */
+type NarrationTimingMethod = 'dsp-align' | 'presenter-advance';
 interface BuildNarrationTimingOptions {
     cameraOffsetSec?: number;
     baseWpm?: number;
@@ -628,4 +637,100 @@ declare function buildNarrationTimingJson(script: NarrationScript, alignment: Na
  */
 declare function parseNarrationTimingJson(data: ArrayBuffer | Uint8Array | string): NarrationTimingJsonV3 | null;
 
-export { type AlignConfig, type AlignInput, type BandpassState, type BuildNarrationTimingOptions, type BuildScriptOptions, DEFAULT_ALIGN_CONFIG, DEFAULT_FEATURE_CONFIG, DEFAULT_NUCLEI_CONFIG, DEFAULT_PACING_CONFIG, DEFAULT_VAD_CONFIG, type FeatureConfig, type FeatureState, type FrameFeatures, type NarrationAlignment, type NarrationBlockRange, type NarrationScript, type NarrationSessionConfig, type NarrationSessionState, type NarrationTimingBlock, type NarrationTimingJsonV3, type NarrationTrace, type NucleiConfig, type NucleiState, type PacingConfig, type PacingState, type PacingTick, type ScriptBlockRange, type ScriptToken, type TraceSample, type VadConfig, type VadState, type WordTiming, alignNarration, bandpassRun, buildNarrationScript, buildNarrationTimingJson, createBandpass, createFeatureState, createNarrationSession, createNucleiState, createPacingState, createVadState, detectSyllableOnsets, downsampleTrace, estimateSyllables, expectedSyllablesAt, extractFrameFeatures, featureStep, narrationSessionStep, nucleiStep, pacingStep, parseNarrationTimingJson, reanchorPacing, reanchorSession, traceWordPosAt, vadStep, wordIndexAtChar, wordIndexAtTime, wordPosAtExpectedSyllables };
+/**
+ * Presenter-advance block timings — the observed sibling of the DTW aligner.
+ *
+ * The teleprompter INFERS where each block began by matching the take's audio
+ * against the expected script (`alignNarration` → `deriveBlockRanges`). This
+ * module takes the other route: while a take rolls, the presenter advances
+ * slides themselves, and each first showing is stamped with take-relative
+ * time. Those observations ARE the block boundaries — nothing is inferred.
+ *
+ * The output is an ordinary {@link NarrationTimingJsonV3}, so the entire read
+ * path is unchanged: the recorder writes it to `<media>.timing.json`,
+ * `applyNarrationTiming` finds it through the doc-anchored clip, matches its
+ * entries to blocks (id → text similarity → order zip), and writes
+ * `block.startTime` / `block.duration`. Only `generator.method` distinguishes
+ * the two provenances.
+ *
+ * ## First-shown-only
+ *
+ * A revisit is a no-op ({@link recordSlideShown} returns its input). Block *k*
+ * therefore runs from its first showing until block *k+1*'s first showing —
+ * an excursion back to an earlier slide is billed to the slide the presenter
+ * was on. That is the direct consequence of "note the time a slide is first
+ * introduced", and it keeps the log monotonic, which every downstream
+ * consumer assumes.
+ *
+ * ## Blocks the presenter never showed
+ *
+ * They collapse to a ZERO-LENGTH range at the next shown block's start.
+ * `getBlockAtTime` selects on `time >= startTime && time < startTime +
+ * duration`, so a zero-length block is never on screen — it is skipped in
+ * playback, which is exactly what "never shown" means. Emitting them anyway
+ * (rather than omitting them) is what keeps the sidecar contiguous and
+ * complete: `applyNarrationTiming` places UNMATCHED doc blocks at its running
+ * cursor with their own reading-time duration, which would silently push
+ * every later block out of sync with the audio.
+ */
+
+/** One block the presenter put on screen for the first time, in take-relative ms. */
+interface SlideAdvance {
+    blockId: string;
+    atMs: number;
+}
+/**
+ * An ordered, first-shown-only advance log. Invariants, maintained by
+ * {@link recordSlideShown}: each `blockId` appears at most once, and `atMs` is
+ * non-decreasing.
+ */
+type SlideAdvanceLog = readonly SlideAdvance[];
+declare const EMPTY_ADVANCE_LOG: SlideAdvanceLog;
+/**
+ * Append a first showing.
+ *
+ * Returns the SAME reference — not a copy — when the block is already logged
+ * (the presenter went backwards) or the stamp is unusable. Reference stability
+ * is what makes this safe to call from a React state updater: a no-op advance
+ * cannot trigger a re-render.
+ *
+ * `atMs` is clamped to at least the previous entry's, so a non-monotonic wall
+ * clock (an NTP step mid-take) can never produce a decreasing log.
+ */
+declare function recordSlideShown(log: SlideAdvanceLog, blockId: string, atMs: number): SlideAdvanceLog;
+interface BuildAdvanceTimingOptions {
+    /**
+     * Forwarded to `buildNarrationScript`. Must match whatever produced the
+     * script the sidecar's `sourceText` will be compared against.
+     */
+    script?: BuildScriptOptions;
+    /** `generator.name` written into provenance. Defaults to `'squisq-recorder'`. */
+    generatorName?: string;
+}
+/**
+ * Build a v3 timing sidecar from observed slide advances.
+ *
+ * Takes the `doc` rather than a prebuilt script on purpose: the payload needs
+ * BOTH `flattenRenderableBlocks` (the authoritative block list — the script
+ * skips blocks with no spoken text) and `buildNarrationScript` (`sourceText`
+ * plus the char ranges that make matching survive an id change). Deriving both
+ * here is what guarantees they cannot disagree.
+ *
+ * Pure — no clock, no I/O.
+ */
+declare function buildAdvanceTimingJson(doc: Doc, advances: SlideAdvanceLog, durationSec: number, options?: BuildAdvanceTimingOptions): NarrationTimingJsonV3;
+/** How much of the deck the presenter actually got through. */
+interface AdvanceCoverage {
+    /** Renderable blocks in the doc. */
+    total: number;
+    /** Blocks shown at least once during the take. */
+    shown: number;
+    /** Blocks never shown — they save as zero-length and are skipped in playback. */
+    unshown: number;
+    /** Headings of the unshown blocks, in document order, for user-facing copy. */
+    unshownHeadings: string[];
+}
+/** Summarize an advance log against a doc. Pure; drives the review-panel warning. */
+declare function advanceCoverage(doc: Doc, advances: SlideAdvanceLog): AdvanceCoverage;
+
+export { type AdvanceCoverage, type AlignConfig, type AlignInput, type BandpassState, type BuildAdvanceTimingOptions, type BuildNarrationTimingOptions, type BuildScriptOptions, DEFAULT_ALIGN_CONFIG, DEFAULT_FEATURE_CONFIG, DEFAULT_NUCLEI_CONFIG, DEFAULT_PACING_CONFIG, DEFAULT_VAD_CONFIG, EMPTY_ADVANCE_LOG, type FeatureConfig, type FeatureState, type FrameFeatures, type NarrationAlignment, type NarrationBlockRange, type NarrationScript, type NarrationSessionConfig, type NarrationSessionState, type NarrationTimingBlock, type NarrationTimingJsonV3, type NarrationTimingMethod, type NarrationTrace, type NucleiConfig, type NucleiState, type PacingConfig, type PacingState, type PacingTick, type ScriptBlockRange, type ScriptToken, type SlideAdvance, type SlideAdvanceLog, type TraceSample, type VadConfig, type VadState, type WordTiming, advanceCoverage, alignNarration, bandpassRun, buildAdvanceTimingJson, buildNarrationScript, buildNarrationTimingJson, createBandpass, createFeatureState, createNarrationSession, createNucleiState, createPacingState, createVadState, detectSyllableOnsets, downsampleTrace, estimateSyllables, expectedSyllablesAt, extractFrameFeatures, featureStep, narrationSessionStep, nucleiStep, pacingStep, parseNarrationTimingJson, reanchorPacing, reanchorSession, recordSlideShown, traceWordPosAt, vadStep, wordIndexAtChar, wordIndexAtTime, wordPosAtExpectedSyllables };

package/dist/narration/index.js

@@ -4,8 +4,11 @@ import {
   DEFAULT_NUCLEI_CONFIG,
   DEFAULT_PACING_CONFIG,
   DEFAULT_VAD_CONFIG,
+  EMPTY_ADVANCE_LOG,
+  advanceCoverage,
   alignNarration,
   bandpassRun,
+  buildAdvanceTimingJson,
   createBandpass,
   createFeatureState,
   createNarrationSession,
@@ -21,9 +24,10 @@ import {
   pacingStep,
   reanchorPacing,
   reanchorSession,
+  recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "../chunk-HEYR3TPL.js";
+} from "../chunk-ZWID3HM5.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -33,12 +37,12 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-W2GIFNLN.js";
+} from "../chunk-ZYCSRDSX.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-CUYHFOFL.js";
 import "../chunk-SBAX4ZPO.js";
 import "../chunk-BAOV476U.js";
-import "../chunk-NBKAXPSX.js";
+import "../chunk-TMOHAFYE.js";
 import "../chunk-O7JILDEF.js";
 import "../chunk-4VOD55SX.js";
 import "../chunk-XOFT65EX.js";
@@ -50,8 +54,11 @@ export {
   DEFAULT_NUCLEI_CONFIG,
   DEFAULT_PACING_CONFIG,
   DEFAULT_VAD_CONFIG,
+  EMPTY_ADVANCE_LOG,
+  advanceCoverage,
   alignNarration,
   bandpassRun,
+  buildAdvanceTimingJson,
   buildNarrationScript,
   buildNarrationTimingJson,
   createBandpass,
@@ -72,6 +79,7 @@ export {
   parseNarrationTimingJson,
   reanchorPacing,
   reanchorSession,
+  recordSlideShown,
   traceWordPosAt,
   vadStep,
   wordIndexAtChar,

package/dist/proof/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Plain-data types for the proofing (grammar + spellcheck) pipeline.
+ *
+ * These types are engine-agnostic: an editor host adapts a concrete
+ * engine (harper.js, a service, a test fake) to produce `ProofFinding`s,
+ * while this module stays pure and dependency-free so the mapping and
+ * masking helpers can run in Node tests and any consumer bundle.
+ */
+/** Severity/color tier of a finding: red, green, or blue squiggle. */
+type ProofCategory = 'spelling' | 'grammar' | 'style';
+/** How a suggestion is applied relative to the finding's span. */
+type ProofSuggestionKind = 'replace' | 'remove' | 'insertAfter';
+/** One candidate fix for a finding. */
+interface ProofSuggestion {
+    /** Replacement/insertion text (empty for `remove`). */
+    text: string;
+    kind: ProofSuggestionKind;
+}
+/** A half-open `[start, end)` range in UTF-16 code units. */
+interface ProofRange {
+    start: number;
+    end: number;
+}
+/**
+ * One issue found in a linted text. Offsets index into the exact string
+ * that was linted (UTF-16 code units — the same coordinate space as
+ * ProseMirror, Monaco, and DOM Range).
+ */
+interface ProofFinding extends ProofRange {
+    /** Stable within one lint pass; the provider maps id → engine handle. */
+    id: string;
+    category: ProofCategory;
+    /** Raw engine kind (e.g. `Typo`), for diagnostics and future filtering. */
+    kind: string;
+    /** Human-readable description of the issue. */
+    message: string;
+    /** Text at `[start, end)` when linted — staleness check before applying. */
+    originalText: string;
+    suggestions: ProofSuggestion[];
+}
+/** English dialects supported by the proofing engine. */
+type ProofDialect = 'American' | 'British' | 'Australian' | 'Canadian' | 'Indian';
+/** All supported dialects, in display order. */
+declare const PROOF_DIALECTS: readonly ProofDialect[];
+
+/**
+ * Mapping from harper's `LintKind` vocabulary to squisq's three proofing
+ * tiers. The keys pin the full 21-kind union of harper.js 2.7.0; a unit
+ * test asserts the map stays in sync with the installed engine so an
+ * upgrade that adds a kind is caught at review time rather than falling
+ * through silently. Unknown kinds degrade to `style` (the least alarming
+ * tier) instead of throwing.
+ */
+
+/** harper `LintKind` → squisq tier. Spelling = red, grammar = green, style = blue. */
+declare const LINT_KIND_CATEGORIES: Readonly<Record<string, ProofCategory>>;
+/**
+ * Categorize a raw engine kind. Kinds this build doesn't know (added by a
+ * future harper release) fall back to `style` so they render as the least
+ * alarming squiggle rather than breaking the pass.
+ */
+declare function categorizeLintKind(kind: string): ProofCategory;
+
+/**
+ * Protected-span masking for proofing.
+ *
+ * Squisq markdown carries `{[…]}` annotations (block templates, inline
+ * icons, media directives) whose contents are machine vocabulary, not
+ * prose — a grammar engine flags `src`/`webm`/template ids as spelling
+ * errors. The engine's own masking option is unusable (inclusion-mask
+ * semantics and silent failure on an invalid pattern), so we blank the
+ * spans ourselves: replace each annotation with an equal-length run of
+ * spaces — every surrounding offset stays byte-identical — and afterwards
+ * drop any finding that intersects a blanked range (which also swallows
+ * the whitespace-formatting lints the blank runs themselves can induce).
+ */
+
+interface BlankedText {
+    /** Input with every protected span replaced by spaces; same length. */
+    text: string;
+    /** The replaced ranges, in ascending order. */
+    blanked: ProofRange[];
+}
+/** Blank `{[…]}` annotation spans to equal-length spaces. */
+declare function blankProtectedSpans(text: string): BlankedText;
+/** Keep only findings whose span does not intersect any blanked range. */
+declare function dropMaskedFindings<T extends ProofRange>(findings: readonly T[], blanked: readonly ProofRange[]): T[];
+
+/**
+ * Joined-segment linting.
+ *
+ * The Write view lints many textblocks (paragraphs, headings, list
+ * items, table cells) in ONE engine call by joining their texts with a
+ * blank-line separator: one RPC per pass instead of one per block, and —
+ * measured — the engine treats each segment as its own paragraph while
+ * still using sentence context (`Its` → `It's` fires only with context).
+ * Findings come back in the joined coordinate space and are mapped back
+ * to their segment; a span that touches a separator or crosses segments
+ * is dropped rather than guessed at.
+ */
+
+/** Separator between joined segments — a paragraph boundary to the engine. */
+declare const PROOF_JOIN_SEPARATOR = "\n\n";
+interface JoinedSegments {
+    /** All segments joined with {@link PROOF_JOIN_SEPARATOR}. */
+    text: string;
+    /** Start offset of each segment within `text`, ascending. */
+    starts: number[];
+    /** Length of each segment. */
+    lengths: number[];
+}
+/** Join segment texts, recording where each lands in the joined string. */
+declare function buildJoinedText(segments: readonly string[]): JoinedSegments;
+interface SegmentSpan extends ProofRange {
+    /** Index into the segment list handed to {@link buildJoinedText}. */
+    segmentIndex: number;
+}
+/**
+ * Map a `[start, end)` span in the joined text back to segment-local
+ * coordinates. Returns `null` for an empty span, a span outside every
+ * segment, or one that touches a separator / crosses segments.
+ */
+declare function mapJoinedSpanToSegment(joined: JoinedSegments, start: number, end: number): SegmentSpan | null;
+
+/**
+ * Doc-level proofing settings, persisted in frontmatter — the proofing
+ * analog of `coverSlideSettings`. Three keys:
+ *
+ *   - `squisq-proofing`         — per-doc enable override (boolean)
+ *   - `squisq-proof-dialect`    — English dialect for this doc
+ *   - `squisq-proof-dictionary` — comma-separated accepted words
+ *
+ * Deliberately NOT here: ignored findings. Dismissing a finding is a
+ * personal preference about one person's editing session, not document
+ * content — it would otherwise land in everyone's copy through git. The
+ * editor hands that state to the host instead, scoped per document
+ * (`ProofingIgnoreStore` in `@bendyline/squisq-editor-react/proofing`).
+ */
+
+/** Frontmatter keys (canonical `squisq-*` plus tolerated bare spellings). */
+declare const PROOF_FRONTMATTER_KEYS: Readonly<{
+    enabled: {
+        canonical: string;
+        legacy: string;
+    };
+    dialect: {
+        canonical: string;
+        legacy: string;
+    };
+    dictionary: {
+        canonical: string;
+        legacy: string;
+    };
+}>;
+interface ProofingSettings {
+    /** Per-doc enable override; `undefined` = defer to the host default. */
+    enabled?: boolean;
+    /** Dialect override; `undefined` = provider/config default. */
+    dialect?: ProofDialect;
+    /** Doc-local accepted words (always an array; empty when unset). */
+    dictionary: string[];
+}
+declare const DEFAULT_PROOF_SETTINGS: Readonly<{
+    enabled: true;
+    dialect: ProofDialect;
+}>;
+/** Resolve a dialect value case-insensitively; `undefined` when unrecognized. */
+declare function resolveProofDialect(value: unknown): ProofDialect | undefined;
+/**
+ * Parse a dictionary value into a word list. Accepts the canonical
+ * comma-separated string plus (defensively) a parsed YAML list.
+ */
+declare function parseProofDictionary(value: unknown): string[];
+/** Encode a dictionary for frontmatter; `null` (remove the key) when empty. */
+declare function formatProofDictionary(words: readonly string[]): string | null;
+/** Read all proofing settings from a parsed frontmatter record. */
+declare function readProofingSettings(frontmatter: Record<string, unknown> | undefined): ProofingSettings;
+
+export { type BlankedText, DEFAULT_PROOF_SETTINGS, type JoinedSegments, LINT_KIND_CATEGORIES, PROOF_DIALECTS, PROOF_FRONTMATTER_KEYS, PROOF_JOIN_SEPARATOR, type ProofCategory, type ProofDialect, type ProofFinding, type ProofRange, type ProofSuggestion, type ProofSuggestionKind, type ProofingSettings, type SegmentSpan, blankProtectedSpans, buildJoinedText, categorizeLintKind, dropMaskedFindings, formatProofDictionary, mapJoinedSpanToSegment, parseProofDictionary, readProofingSettings, resolveProofDialect };

package/dist/proof/index.js

@@ -0,0 +1,32 @@
+import {
+  DEFAULT_PROOF_SETTINGS,
+  LINT_KIND_CATEGORIES,
+  PROOF_DIALECTS,
+  PROOF_FRONTMATTER_KEYS,
+  PROOF_JOIN_SEPARATOR,
+  blankProtectedSpans,
+  buildJoinedText,
+  categorizeLintKind,
+  dropMaskedFindings,
+  formatProofDictionary,
+  mapJoinedSpanToSegment,
+  parseProofDictionary,
+  readProofingSettings,
+  resolveProofDialect
+} from "../chunk-T3B4WJBR.js";
+export {
+  DEFAULT_PROOF_SETTINGS,
+  LINT_KIND_CATEGORIES,
+  PROOF_DIALECTS,
+  PROOF_FRONTMATTER_KEYS,
+  PROOF_JOIN_SEPARATOR,
+  blankProtectedSpans,
+  buildJoinedText,
+  categorizeLintKind,
+  dropMaskedFindings,
+  formatProofDictionary,
+  mapJoinedSpanToSegment,
+  parseProofDictionary,
+  readProofingSettings,
+  resolveProofDialect
+};

package/dist/recommend/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MarkdownBlockNode } from '../types-CcrDFdWH.js';
+import { M as MarkdownBlockNode } from '../types-Be6sBUBx.js';
 
 /**
  * Block template recommendations.

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { O as Doc, bh as Theme, bk as ThemePageStyle, bj as ThemeColorScheme, I as DeepPartial, bn as ThemeSeedColors, bi as ThemeColorPalette, X as FontFamilyKind, W as FontFamily } from '../Doc-DBadkoP4.js';
-export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CustomTemplateDefinition, x as CustomTemplateLayer, y as CustomTemplateValidationError, z as CustomTemplateValidationResult, D as DARK_SURFACE, E as DEFAULT_DOC_FONT, F as DEFAULT_TITLE_FONT, G as DataTableInput, H as DateEventInput, J as DefinitionCardInput, K as DiagramBlockInput, L as DiagramEdgeAnchor, M as DiagramTemplateEdge, N as DiagramTemplateNode, P as DocBlock, Q as DocDiagnostic, R as DonutChartInput, S as DrawingBlockInput, T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, V as FactCardInput, Y as FullBleedQuoteInput, Z as GradientBackgroundConfig, _ as ImageBackgroundConfig, $ as ImageLayer, a0 as ImageTreatment, a1 as ImageWithCaptionInput, a2 as LIGHT_SURFACE, a3 as Layer, a4 as LayerRepeat, a5 as LayoutHints, a6 as LeftFeatureInput, a7 as LineChartInput, a8 as LinearGradient, a9 as ListBlockInput, aa as MapBlockInput, ab as MapLayer, ac as MapMarker, ad as MapTileStyle, ae as MarkerStyle, af as MediaClip, ag as MediaScheduleOptions, ah as MermaidLayer, ai as PAGE_ACCENT_STRATEGIES, aj as PAGE_BACKGROUNDS, ak as PAGE_BACKGROUND_RHYTHMS, al as PAGE_DESIGN_FAMILIES, am as PAGE_DIVIDERS, an as PAGE_EMPHASES, ao as PAGE_EYEBROWS, ap as PAGE_HEADING_CASES, aq as PAGE_HEADING_SCALES, ar as PAGE_HEADING_UNDERLINES, as as PAGE_HERO_STYLES, at as PAGE_IMAGE_FRAMINGS, au as PAGE_NUMERAL_STYLES, av as PAGE_PATTERNS, aw as PAGE_QUOTE_MARKS, ax as PAGE_SECTION_KINDS, ay as PAGE_SECTION_SPACINGS, az as PAGE_SHADOWS, aA as PageAccentRotation, aB as PageBackground, aC as PageDesignFamily, aD as PageEmphasis, aE as PageHeadingTreatment, aF as PageSectionKind, aG as PageSectionOverride, aH as PageTokens, aI as PathLayer, aJ as PatternBackgroundConfig, aK as PersistentLayer, aL as PersistentLayerConfig, aM as PersistentLayerTemplate, aN as PersistentLayerTemplateConfig, aO as PersistentLayerTemplateType, aP as PhotoGridInput, aQ as PieChartInput, aR as PipStyle, aS as Position, aT as ProgressIndicatorConfig, aU as PromotedBodyAnnotation, aV as PullQuoteInput, aW as QuoteBlockInput, aX as RawLayersInput, aY as RenderStyle, aZ as RightFeatureInput, a_ as ScatterChartInput, a$ as ScheduledClip, b0 as SectionHeaderInput, b1 as ShapeFilter, b2 as ShapeLayer, b3 as ShapePattern, b4 as SolidBackgroundConfig, b5 as StartBlockConfig, b6 as StatHighlightInput, b7 as SurfaceScheme, b8 as THEME_SCHEMA_VERSION, b9 as TableLayer, ba as TableLayerStyle, bb as TemplateBlock, bc as TemplateContext, bd as TemplateFunction, be as TemplateRegistry, bf as TextLayer, bg as TextStyle, bl as ThemeRegistry, bm as ThemeSchemaVersion, bo as ThemeStyle, bp as ThemeTypography, bq as TimelineBlockInput, br as TimelineTemplateEvent, bs as TimelineTemplateLink, bt as TimelineTemplateTrack, bu as TitleBlockInput, bv as TitleCaptionConfig, bw as TreeBlockInput, bx as TreeLayer, by as TreeLayerItem, bz as TreeLayerStyle, bA as TreeTemplateItem, bB as TwoColumnInput, bC as VIEWPORT_PRESETS, bD as VideoLayer, bE as VideoPipPosition, bF as VideoPipShape, bG as VideoPipSize, bH as VideoPlacement, bI as VideoPresentation, bJ as VideoPullQuoteInput, bK as VideoWithCaptionInput, bL as ViewportConfig, bM as ViewportOrientation, bN as ViewportPreset, bO as VignetteConfig, bP as applySurface, bQ as calculateDuration, bR as calculateFontScale, bS as createTemplateContext, bT as createTheme, bU as createThemeRegistry, bV as getAspectRatioString, bW as getBlockAtTime, bX as getCaptionAtTime, bY as getDocPlaybackDuration, bZ as getLayoutHints, b_ as getSafeTextBounds, b$ as getSegmentAtTime, c0 as getTwoColumnPositions, c1 as getViewport, c2 as getViewportOrientation, c3 as isCustomTemplateDefinition, c4 as isPersistentLayerTemplate, c5 as isTemplateBlock, c6 as layoutScaledFontSize, c7 as resolveMediaSchedule, c8 as scaledFontSize, c9 as validateCustomTemplateDefinition } from '../Doc-DBadkoP4.js';
-export { a as DEFAULT_TRANSITION_DURATION_SECONDS, $ as TRANSITION_DIRECTIONS, a0 as TRANSITION_TYPES, a1 as Transition, a2 as TransitionDirection, a3 as TransitionType, a6 as isTransitionType, a7 as normalizeTransitionDirection, a8 as normalizeTransitionType, a9 as resolveBlockTransition, ab as resolveTransitionDuration } from '../types-CcrDFdWH.js';
-export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-8BQMY2HV.js';
+import { O as Doc, bh as Theme, bk as ThemePageStyle, bj as ThemeColorScheme, I as DeepPartial, bn as ThemeSeedColors, bi as ThemeColorPalette, X as FontFamilyKind, W as FontFamily } from '../Doc-CRPQCkHn.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CustomTemplateDefinition, x as CustomTemplateLayer, y as CustomTemplateValidationError, z as CustomTemplateValidationResult, D as DARK_SURFACE, E as DEFAULT_DOC_FONT, F as DEFAULT_TITLE_FONT, G as DataTableInput, H as DateEventInput, J as DefinitionCardInput, K as DiagramBlockInput, L as DiagramEdgeAnchor, M as DiagramTemplateEdge, N as DiagramTemplateNode, P as DocBlock, Q as DocDiagnostic, R as DonutChartInput, S as DrawingBlockInput, T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, V as FactCardInput, Y as FullBleedQuoteInput, Z as GradientBackgroundConfig, _ as ImageBackgroundConfig, $ as ImageLayer, a0 as ImageTreatment, a1 as ImageWithCaptionInput, a2 as LIGHT_SURFACE, a3 as Layer, a4 as LayerRepeat, a5 as LayoutHints, a6 as LeftFeatureInput, a7 as LineChartInput, a8 as LinearGradient, a9 as ListBlockInput, aa as MapBlockInput, ab as MapLayer, ac as MapMarker, ad as MapTileStyle, ae as MarkerStyle, af as MediaClip, ag as MediaScheduleOptions, ah as MermaidLayer, ai as PAGE_ACCENT_STRATEGIES, aj as PAGE_BACKGROUNDS, ak as PAGE_BACKGROUND_RHYTHMS, al as PAGE_DESIGN_FAMILIES, am as PAGE_DIVIDERS, an as PAGE_EMPHASES, ao as PAGE_EYEBROWS, ap as PAGE_HEADING_CASES, aq as PAGE_HEADING_SCALES, ar as PAGE_HEADING_UNDERLINES, as as PAGE_HERO_STYLES, at as PAGE_IMAGE_FRAMINGS, au as PAGE_NUMERAL_STYLES, av as PAGE_PATTERNS, aw as PAGE_QUOTE_MARKS, ax as PAGE_SECTION_KINDS, ay as PAGE_SECTION_SPACINGS, az as PAGE_SHADOWS, aA as PageAccentRotation, aB as PageBackground, aC as PageDesignFamily, aD as PageEmphasis, aE as PageHeadingTreatment, aF as PageSectionKind, aG as PageSectionOverride, aH as PageTokens, aI as PathLayer, aJ as PatternBackgroundConfig, aK as PersistentLayer, aL as PersistentLayerConfig, aM as PersistentLayerTemplate, aN as PersistentLayerTemplateConfig, aO as PersistentLayerTemplateType, aP as PhotoGridInput, aQ as PieChartInput, aR as PipStyle, aS as Position, aT as ProgressIndicatorConfig, aU as PromotedBodyAnnotation, aV as PullQuoteInput, aW as QuoteBlockInput, aX as RawLayersInput, aY as RenderStyle, aZ as RightFeatureInput, a_ as ScatterChartInput, a$ as ScheduledClip, b0 as SectionHeaderInput, b1 as ShapeFilter, b2 as ShapeLayer, b3 as ShapePattern, b4 as SolidBackgroundConfig, b5 as StartBlockConfig, b6 as StatHighlightInput, b7 as SurfaceScheme, b8 as THEME_SCHEMA_VERSION, b9 as TableLayer, ba as TableLayerStyle, bb as TemplateBlock, bc as TemplateContext, bd as TemplateFunction, be as TemplateRegistry, bf as TextLayer, bg as TextStyle, bl as ThemeRegistry, bm as ThemeSchemaVersion, bo as ThemeStyle, bp as ThemeTypography, bq as TimelineBlockInput, br as TimelineTemplateEvent, bs as TimelineTemplateLink, bt as TimelineTemplateTrack, bu as TitleBlockInput, bv as TitleCaptionConfig, bw as TranscriptBlockInput, bx as TreeBlockInput, by as TreeLayer, bz as TreeLayerItem, bA as TreeLayerStyle, bB as TreeTemplateItem, bC as TwoColumnInput, bD as VIEWPORT_PRESETS, bE as VideoLayer, bF as VideoPipPosition, bG as VideoPipShape, bH as VideoPipSize, bI as VideoPlacement, bJ as VideoPresentation, bK as VideoPullQuoteInput, bL as VideoWithCaptionInput, bM as ViewportConfig, bN as ViewportOrientation, bO as ViewportPreset, bP as VignetteConfig, bQ as applySurface, bR as calculateDuration, bS as calculateFontScale, bT as createTemplateContext, bU as createTheme, bV as createThemeRegistry, bW as getAspectRatioString, bX as getBlockAtTime, bY as getCaptionAtTime, bZ as getDocPlaybackDuration, b_ as getLayoutHints, b$ as getSafeTextBounds, c0 as getSegmentAtTime, c1 as getTwoColumnPositions, c2 as getViewport, c3 as getViewportOrientation, c4 as isCustomTemplateDefinition, c5 as isPersistentLayerTemplate, c6 as isTemplateBlock, c7 as layoutScaledFontSize, c8 as resolveMediaSchedule, c9 as scaledFontSize, ca as validateCustomTemplateDefinition } from '../Doc-CRPQCkHn.js';
+export { a as DEFAULT_TRANSITION_DURATION_SECONDS, a1 as TRANSITION_DIRECTIONS, a2 as TRANSITION_TYPES, a3 as Transition, a4 as TransitionDirection, a5 as TransitionType, a8 as isTransitionType, a9 as normalizeTransitionDirection, aa as normalizeTransitionType, ab as resolveBlockTransition, ad as resolveTransitionDuration } from '../types-Be6sBUBx.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BG3jr6mT.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-Cq2a3c30.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-MbvJM1HE.js';
 
 /**
  * Runtime validation for the canonical {@link Doc} JSON shape.

package/dist/storage/index.js

@@ -7,7 +7,7 @@ import {
   createMediaProviderFromContainer,
   findDocumentPath,
   scopeContainer
-} from "../chunk-FCG3BIZN.js";
+} from "../chunk-UNVHAK3A.js";
 export {
   LocalForageAdapter,
   LocalStorageAdapter,

package/dist/table/index.d.ts

@@ -0,0 +1,123 @@
+import { T as TableViewState, V as ViewIssue } from '../viewState-lTZS-hP_.js';
+export { E as EMPTY_TABLE_VIEW_STATE, F as FilterClause, a as FilterOp, P as ParsedTableViewState, S as SortTerm, i as inferNumericColumn, b as isEmptyViewState, c as isNumericCellText, m as makeTableCollator, p as parseTableViewState, q as quoteViewToken, s as serializeTableViewState } from '../viewState-lTZS-hP_.js';
+
+/**
+ * Reference implementation of table view state over a plain string matrix —
+ * the semantics contract the grid's worker kernel is parity-tested against,
+ * and what the sidecar data readers apply before windowing so previews and
+ * exports show the author's curated view.
+ *
+ * Semantics:
+ *  - filter first (AND conjunction), then a STABLE multi-term sort;
+ *  - a column is numeric per `inferNumericColumn` (all non-blank cells
+ *    numeric, no leading-zero strings) — numeric columns compare by value,
+ *    everything else via the shared collator (`numeric: true`, so "v2" <
+ *    "v10" in text columns too);
+ *  - blank cells sort LAST regardless of direction (Excel behavior) and
+ *    match only `= ''` / `!=` filters;
+ *  - text-matching ops (`= != ~ !~ ^~ $~`) are case-INSENSITIVE by default
+ *    (Excel AutoFilter semantics); `clause.caseSensitive` (`*` in the
+ *    grammar) makes them exact-case. Numeric equality is unaffected.
+ */
+
+interface AppliedTableView {
+    /** Filtered + sorted rows (the same row arrays, re-ordered — not copies). */
+    rows: string[][];
+    /** Source-row index (0-based, header excluded) per output row. */
+    rowIds: number[];
+    /** Row count before filtering (equals `rows.length` with no filter). */
+    unfilteredRowCount: number;
+}
+/**
+ * Apply `view` to `rows`. Row identity is positional: `rowIds[i]` is the
+ * index of output row `i` in the input `rows`.
+ */
+declare function applyTableViewState(headers: readonly string[], rows: readonly (readonly string[])[], view: TableViewState): AppliedTableView;
+
+/**
+ * TableQueryProvider — the async, worker-ready contract a data grid renders
+ * against and a query backend implements. The default implementation is the
+ * in-house columnar worker store in `@bendyline/squisq-grid-react`; heavier
+ * backends (SQL engines, remote services) implement the same surface later.
+ *
+ * Design constraints baked in:
+ *  - Everything is async: the reference backend lives in a Web Worker, and
+ *    retrofitting async under a sync grid API is painful — so the contract
+ *    is async from day one and renderers use windowed prefetch.
+ *  - View state (sort/filter) is provider-side: the renderer never holds
+ *    more than a window of rows, so ordering/filtering must happen where
+ *    the full dataset lives.
+ *  - Row identity is the immutable SOURCE row index (`rowId`), assigned at
+ *    ingest — stable under any permutation and unaffected by edits changing
+ *    sort keys.
+ */
+
+type TableColumnKind = 'number' | 'string' | 'date' | 'boolean';
+interface TableColumnSchema {
+    name: string;
+    kind: TableColumnKind;
+}
+interface TableSchema {
+    columns: TableColumnSchema[];
+    /** Total data rows in the source (before any filter). */
+    rowCount: number;
+}
+/** A cell value as providers exchange it. `null` = blank. */
+type TableCellValue = string | number | boolean | null;
+interface TableRowsPage {
+    /** View-coordinate index of the first returned row. */
+    start: number;
+    /** Source row id per returned row (edit/selection identity). */
+    rowIds: number[];
+    /** Raw values; formatting is the renderer's job. */
+    cells: TableCellValue[][];
+}
+interface TableViewResult {
+    /** Row count AFTER the active filter (the virtualizer's row count). */
+    viewRowCount: number;
+    issues: ViewIssue[];
+}
+interface TableCellEdit {
+    rowId: number;
+    col: number;
+    value: TableCellValue;
+}
+interface TableEditResult {
+    /**
+     * True when an edited cell touched an active sort/filter column — the
+     * current permutation may be outdated. Providers NEVER auto re-sort on
+     * edit (a row teleporting out from under the caret is hostile); the
+     * renderer offers an explicit refresh.
+     */
+    staleView: boolean;
+}
+/** Result of a {@link TableQueryProvider.distinct} sweep over one column. */
+interface TableDistinctResult {
+    /**
+     * Distinct non-blank values as display text, sorted (numerically for
+     * numeric columns, collated otherwise), capped at the requested limit.
+     */
+    values: string[];
+    /** Total distinct non-blank values in the column (may exceed `values`). */
+    totalDistinct: number;
+    /** Whether any cell in the column is blank. */
+    hasBlank: boolean;
+}
+interface TableQueryProvider {
+    describe(): Promise<TableSchema>;
+    /** Apply a view; subsequent `rows()` windows are in view coordinates. */
+    setView(view: TableViewState): Promise<TableViewResult>;
+    rows(start: number, count: number): Promise<TableRowsPage>;
+    /** Optional: providers without write support omit it (read-only grid). */
+    applyEdits?(edits: TableCellEdit[]): Promise<TableEditResult>;
+    /**
+     * Optional: distinct values of one column over the FULL source (not the
+     * filtered view), for value-picker UIs. Cheap for the columnar store —
+     * string columns are dictionary-encoded — so renderers feature-detect
+     * this rather than aggregating rows themselves.
+     */
+    distinct?(col: number, limit: number): Promise<TableDistinctResult>;
+    dispose(): void;
+}
+
+export { type AppliedTableView, type TableCellEdit, type TableCellValue, type TableColumnKind, type TableColumnSchema, type TableDistinctResult, type TableEditResult, type TableQueryProvider, type TableRowsPage, type TableSchema, type TableViewResult, TableViewState, ViewIssue, applyTableViewState };