@bendyline/squisq 2.13.13 → 2.13.15

package/dist/transform/index.d.ts

@@ -1,6 +1,6 @@
-import { T as Doc, t as ColorScheme, k as Block, by as TemplateBlock } from '../Doc-BhvotZx_.js';
-import { l as PageTransformHints, n as PresentationBeatLayout, o as PresentationLayout, p as PresentationPlan } from '../materializePageSection-CWxou4mX.js';
-export { A as AUTHORED_PRESENTATION_LAYOUT, P as PRESENTATION_KEY, b as PRESENTATION_LAYOUTS, c as PRESENTATION_LIMITS, m as PresentationBeat, s as parsePresentationPlan, t as presentationLayoutFits, u as presentationStat, w as serializePresentationPlan } from '../materializePageSection-CWxou4mX.js';
+import { U as Doc, t as ColorScheme, k as Block, bE as TemplateBlock } from '../Doc-C_Sh49ot.js';
+import { s as PageTransformHints, u as PresentationBeatExtras, w as PresentationLayout, v as PresentationBeatLayout, x as PresentationPlan, t as PresentationBeat, g as ConceptTemplateName } from '../materializePageSection-Dmf-rf1b.js';
+export { A as AUTHORED_PRESENTATION_LAYOUT, b as CONCEPT_TEMPLATES, P as PRESENTATION_KEY, i as PRESENTATION_LAYOUTS, j as PRESENTATION_LIMITS, E as conceptTemplate, H as parsePresentationPlan, I as presentationBeatExtras, J as presentationLayoutFits, K as presentationLayoutNeeds, L as presentationLayoutProblem, N as presentationStat, Q as serializePresentationPlan } from '../materializePageSection-Dmf-rf1b.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import { f as BuildSpec, M as MarkdownBlockNode } from '../types-Zk8qYuaT.js';
 
@@ -327,6 +327,14 @@ declare const DYNAMIC_PRESENTATION_STYLE = "dynamic-slides";
 /** A short, stable name for one slide's exact source passage. Saving it rather
  * than the passage keeps the document text out of the hints. */
 declare function presentationPassageKey(passage: string): string;
+/** One slide's AI wording: a layout, a headline, points, and what the layout
+ * draws beyond them (a hub's centre, a matrix's axes). */
+interface PresentationAiSuggestion extends PresentationBeatExtras {
+    source: string;
+    layout: PresentationLayout;
+    headline: string;
+    points: string[];
+}
 interface PresentationBlockHint {
     build?: BuildSpec;
     blockId: string;
@@ -337,12 +345,7 @@ interface PresentationBlockHint {
      * Changing a passage, or how the section is split, shows its slide again. */
     hidden?: string[];
     /** Optional AI-authored display text, keyed to the exact passage it summarizes. */
-    ai?: Array<{
-        source: string;
-        layout: PresentationLayout;
-        headline: string;
-        points: string[];
-    }>;
+    ai?: PresentationAiSuggestion[];
     /** Explicit user wording, applied only while this section's source still matches. */
     wording?: {
         source: string;
@@ -516,8 +519,165 @@ declare function statedRanges(source: string): StatedRange[];
 declare function rangeEndOnly(value: string | number, source: string): StatedRange | undefined;
 
 /**
- * Concept reveals: a concept slide (`cards`, `process`, `cycle`, `layers`)
- * that shows its ideas one at a time, each as the narration reaches it.
+ * Presentation author — the protocol a model follows to word a deck's slides.
+ *
+ * Squisq plans a deck from prose on its own (`createPresentationPlan`). A
+ * host with a model can improve it: the model plans every slide's layout
+ * together (the storyboard), then words each slide (a layout, a headline and
+ * points). This module is everything about that exchange that is not
+ * transport, so every host asks the same questions and holds the answers to
+ * the same standard:
+ *
+ * - what the model is told ({@link presentationSlidePrompt},
+ *   {@link presentationStoryboardPrompt}), rendered from the authoring guide,
+ *   so a layout added to Squisq reaches every host's prompt;
+ * - what it is sent ({@link presentationSlideRequest},
+ *   {@link presentationStoryboardRequest}) and the reply shape a host that can
+ *   enforce structured output pins it to ({@link PRESENTATION_SLIDE_FORMAT},
+ *   {@link PRESENTATION_STORYBOARD_FORMAT});
+ * - how a reply is read ({@link readPresentationSlideReply},
+ *   {@link readPresentationStoryboardReply}): the fields, the plan's own
+ *   limits, then faithfulness ({@link groundPresentationBeat}). A refused
+ *   reply says why, in words a correction request can quote.
+ *
+ * The model chooses display wording and a layout, nothing else: source spans,
+ * order, media and timing stay the plan's. The host makes the calls (one for
+ * the storyboard, one per slide, a retry with {@link presentationCorrection})
+ * and keeps the automatic slide whenever a reply is refused.
+ *
+ * Related: `presentationPlanner.ts` (the automatic deck), `grounding.ts` (the
+ * fact checks), `recommend/listShape.ts` (whether a shape is stated),
+ * `doc/templates/authoringGuide.ts` (the layout guide and the craft).
+ */
+
+/** What a host needs to size its requests; none of it is enforced here. */
+declare const PRESENTATION_AUTHOR_LIMITS: {
+    /** A passage longer than this keeps its automatic slide: it would not fit a small model. */
+    readonly passageCharacters: 2400;
+    /** A reply longer than this is not a slide. */
+    readonly replyCharacters: 6000;
+    /** Output tokens that hold any valid slide. */
+    readonly slideTokens: 550;
+    readonly temperature: 0.3;
+    /** A deck of at least this many slides to word is storyboarded first… */
+    readonly storyboardMinimum: 3;
+    /** …and one of more than this many is not: a small model cannot see it at once. */
+    readonly storyboardLimit: 16;
+    /** How much of each passage the storyboard sees: enough to recognize its shape. */
+    readonly storyboardGist: 240;
+};
+/** Output tokens that hold a storyboard of `slides` layouts. */
+declare function presentationStoryboardTokens(slides: number): number;
+/** A reply shape for hosts that can enforce structured output (a JSON schema). */
+interface PresentationAuthorFormat {
+    name: string;
+    schema: Record<string, unknown>;
+}
+/**
+ * One slide's wording. Without enforcement some small models answer with a
+ * key per layout name; with it, a reply can only be these fields.
+ */
+declare const PRESENTATION_SLIDE_FORMAT: PresentationAuthorFormat;
+declare const PRESENTATION_STORYBOARD_FORMAT: PresentationAuthorFormat;
+/** The system prompt for wording one slide. */
+declare function presentationSlidePrompt(): string;
+/** The system prompt for planning every slide's layout together. */
+declare function presentationStoryboardPrompt(): string;
+/** Whether a passage addresses a model rather than a reader. */
+declare function addressesAModel(passage: string): boolean;
+/**
+ * The slides a model is asked about, by index. An authored section keeps its
+ * own block and a hidden slide is not shown; a passage too long for a small
+ * model, or one that addresses the model, keeps its automatic slide.
+ */
+declare function presentationSlidesToWord(plan: PresentationPlan): number[];
+/** Whether a deck with these slides to word is storyboarded first. */
+declare function presentationUsesStoryboard(asked: readonly number[]): boolean;
+/** The user message that asks for a storyboard of the slides at `asked`. */
+declare function presentationStoryboardRequest(plan: PresentationPlan, asked: readonly number[]): string;
+/**
+ * The layout a storyboard reply plans for each asked slide. Empty when the
+ * reply does not name one layout per slide; a picture keeps its image slide,
+ * and no other slide becomes one.
+ */
+declare function readPresentationStoryboardReply(text: string, plan: PresentationPlan, asked: readonly number[]): Map<number, PresentationLayout>;
+interface PresentationSlideContext {
+    /** The layout the storyboard planned for this slide. */
+    planned?: PresentationLayout;
+    /**
+     * Without a storyboard, the layouts of the slides just before (as they now
+     * stand), so the model can vary the deck.
+     */
+    previous?: readonly string[];
+    /** Why the prior reply for this slide was refused (`presentationCorrection`). */
+    correction?: string;
+}
+/** The user message that asks for one slide's wording. */
+declare function presentationSlideRequest(plan: PresentationPlan, index: number, context?: PresentationSlideContext): string;
+/**
+ * What to tell the model after a refused reply: what was wrong, then the
+ * rules it bears on. A layout the passage cannot fill is answered by asking
+ * for another one, since the same layout would be refused again.
+ */
+declare function presentationCorrection(problem: string, kind?: PresentationRefusal): string;
+/**
+ * The context for a second request after `read` was refused: the correction,
+ * and no planned layout when the planned one is what could not be filled
+ * (told to use it "unless the passage cannot fill it", a small model tries it again).
+ */
+declare function presentationRetryContext(context: PresentationSlideContext, read: PresentationSlideReply): PresentationSlideContext;
+interface GroundedPresentationBeat {
+    /** The beat as it may be shown, or null when it cannot be shown at all. */
+    beat: PresentationBeat | null;
+    /** Why it cannot be shown: an invented number, words the passage does not use. */
+    problem?: string;
+    /** What was changed to keep it faithful (a shape the passage does not state, drawn as cards). */
+    notes: string[];
+}
+interface GroundPresentationBeatOptions {
+    /** The heading over the passage, which may state its shape ("The water cycle"). */
+    heading?: string;
+}
+/**
+ * Hold a model-worded slide to its passage. Points may condense the passage
+ * but not add to it; the headline may paraphrase freely but cannot invent a
+ * number; a key figure the passage gives only as one end of a range must show
+ * the whole range. Those refuse the slide.
+ *
+ * A layout that asserts a relationship the passage does not state (a cycle
+ * that never comes round, a pyramid without a hierarchy) is not refused: its
+ * wording is good, only its claim is not, so it is drawn as cards or a
+ * process instead. A hub centre or an axis name with words the source does
+ * not use is dropped the same way.
+ */
+declare function groundPresentationBeat(beat: PresentationBeat, passage: string, options?: GroundPresentationBeatOptions): GroundedPresentationBeat;
+/**
+ * What was wrong with a refused reply: it was not the JSON asked for
+ * (`reply`), its layout cannot be filled from what it wrote (`layout`), or it
+ * says something the passage does not (`facts`).
+ */
+type PresentationRefusal = 'reply' | 'layout' | 'facts';
+interface PresentationSlideReply {
+    /** The slide to show, or null when the automatic one is kept. */
+    beat: PresentationBeat | null;
+    /** Why the reply was refused, for a log and for `presentationCorrection`. */
+    problem?: string;
+    /** What kind of problem it was, which decides how to ask again. */
+    kind?: PresentationRefusal;
+    /** What was changed to keep an accepted slide faithful. */
+    notes: string[];
+}
+/**
+ * Read a model's reply for the slide at `index`. The reply is refused (the
+ * automatic slide stands) when it is not the JSON asked for, breaks the
+ * plan's limits, cannot fill its layout, or fails {@link groundPresentationBeat}.
+ */
+declare function readPresentationSlideReply(text: string, plan: PresentationPlan, index: number): PresentationSlideReply;
+
+/**
+ * Concept reveals: a concept slide (`cards`, `process`, `cycle`, `layers`,
+ * `stats`, `pyramid`, `funnel`, `hub`, `venn`, `matrix`) that shows its ideas
+ * one at a time, each as the narration reaches it.
  *
  * Two steps, so any host with narration can use them: find where in the
  * script each idea is spoken ({@link matchPointsToSentences}), then turn
@@ -535,10 +695,7 @@ declare function rangeEndOnly(value: string | number, source: string): StatedRan
  * (`resolveBuildTimeline`), `transform/presentationCompiler.ts`.
  */
 
-declare const CONCEPT_TEMPLATES: readonly ["cards", "process", "cycle", "layers"];
-type ConceptTemplate = (typeof CONCEPT_TEMPLATES)[number];
-/** The concept template a name denotes, or `undefined`. */
-declare function conceptTemplate(template: string): ConceptTemplate | undefined;
+type ConceptTemplate = ConceptTemplateName;
 /**
  * Where in `sourceText[start, end)` each point is spoken: the offset of the
  * sentence it shares the most words with (at least two). Points must land
@@ -558,4 +715,4 @@ declare function conceptBuildSpec(): BuildSpec;
  */
 declare function conceptRevealTiming(template: ConceptTemplate, items: readonly string[], itemTimes: readonly number[] | undefined, start: number, end: number): Pick<Block, 'build' | 'buildTiming'>;
 
-export { type AnalyzedBlock, type BlockImage, CONCEPT_TEMPLATES, type ConceptTemplate, DEFAULT_TRANSFORM_STYLE_ID, DYNAMIC_PRESENTATION_STYLE, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, PRESENTATION_HINTS_KEY, type ParaphraseOptions, PresentationBeatLayout, type PresentationBlockHint, type PresentationHints, PresentationLayout, type PresentationMediaItem, PresentationPlan, type StatedRange, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, type VerbatimQuoteOptions, allocateTiming, analyzeBlocks, applySavedPresentation, applyTransform, collectPresentationMedia, compilePresentationPlan, conceptBuildSpec, conceptRevealTiming, conceptTemplate, createPresentationPlan, createTransformStyleRegistry, defaultPresentationHints, distinctiveStems, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, groundingSentences, isGroundedParaphrase, isVerbatimQuote, matchPointsToSentences, normalizeGroundingText, numbersIn, parsePresentationHints, presentationPassageKey, presentationSections, rangeEndOnly, resolveTransformStyle, restatesHeadline, serializePresentationHints, sourceNumbers, spelledNumbers, statedRanges, transformNarratedSegment, ungroundedNumber, usesDynamicPresentation };
+export { type AnalyzedBlock, type BlockImage, type ConceptTemplate, DEFAULT_TRANSFORM_STYLE_ID, DYNAMIC_PRESENTATION_STYLE, type GroundPresentationBeatOptions, type GroundedPresentationBeat, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, PRESENTATION_AUTHOR_LIMITS, PRESENTATION_HINTS_KEY, PRESENTATION_SLIDE_FORMAT, PRESENTATION_STORYBOARD_FORMAT, type ParaphraseOptions, type PresentationAiSuggestion, type PresentationAuthorFormat, PresentationBeat, PresentationBeatExtras, PresentationBeatLayout, type PresentationBlockHint, type PresentationHints, PresentationLayout, type PresentationMediaItem, PresentationPlan, type PresentationRefusal, type PresentationSlideContext, type PresentationSlideReply, type StatedRange, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, type VerbatimQuoteOptions, addressesAModel, allocateTiming, analyzeBlocks, applySavedPresentation, applyTransform, collectPresentationMedia, compilePresentationPlan, conceptBuildSpec, conceptRevealTiming, createPresentationPlan, createTransformStyleRegistry, defaultPresentationHints, distinctiveStems, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, groundPresentationBeat, groundingSentences, isGroundedParaphrase, isVerbatimQuote, matchPointsToSentences, normalizeGroundingText, numbersIn, parsePresentationHints, presentationCorrection, presentationPassageKey, presentationRetryContext, presentationSections, presentationSlidePrompt, presentationSlideRequest, presentationSlidesToWord, presentationStoryboardPrompt, presentationStoryboardRequest, presentationStoryboardTokens, presentationUsesStoryboard, rangeEndOnly, readPresentationSlideReply, readPresentationStoryboardReply, resolveTransformStyle, restatesHeadline, serializePresentationHints, sourceNumbers, spelledNumbers, statedRanges, transformNarratedSegment, ungroundedNumber, usesDynamicPresentation };

package/dist/transform/index.js

@@ -1,26 +1,37 @@
 import {
+  PRESENTATION_AUTHOR_LIMITS,
+  PRESENTATION_SLIDE_FORMAT,
+  PRESENTATION_STORYBOARD_FORMAT,
+  addressesAModel,
   distinctiveStems,
+  groundPresentationBeat,
   groundingSentences,
   isGroundedParaphrase,
   isVerbatimQuote,
   normalizeGroundingText,
   numbersIn,
+  presentationCorrection,
+  presentationRetryContext,
+  presentationSlidePrompt,
+  presentationSlideRequest,
+  presentationSlidesToWord,
+  presentationStoryboardPrompt,
+  presentationStoryboardRequest,
+  presentationStoryboardTokens,
+  presentationUsesStoryboard,
   rangeEndOnly,
+  readPresentationSlideReply,
+  readPresentationStoryboardReply,
   restatesHeadline,
   sourceNumbers,
   spelledNumbers,
   statedRanges,
   ungroundedNumber
-} from "../chunk-FCB6JLWB.js";
+} from "../chunk-N3FQSUVT.js";
 import {
-  AUTHORED_PRESENTATION_LAYOUT,
-  CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
-  PRESENTATION_KEY,
-  PRESENTATION_LAYOUTS,
-  PRESENTATION_LIMITS,
   allocateTiming,
   analyzeBlocks,
   applySavedPresentation,
@@ -29,7 +40,6 @@ import {
   compilePresentationPlan,
   conceptBuildSpec,
   conceptRevealTiming,
-  conceptTemplate,
   createPresentationPlan,
   createTransformStyleRegistry,
   defaultPresentationHints,
@@ -38,25 +48,35 @@ import {
   getTransformStyleSummaries,
   matchPointsToSentences,
   parsePresentationHints,
-  parsePresentationPlan,
-  presentationLayoutFits,
   presentationPassageKey,
   presentationSections,
-  presentationStat,
   resolveTransformStyle,
   serializePresentationHints,
-  serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "../chunk-YQQWE4HG.js";
-import "../chunk-CTT4XAGO.js";
-import "../chunk-SGNWO7OF.js";
+} from "../chunk-OJCAKUHW.js";
+import {
+  AUTHORED_PRESENTATION_LAYOUT,
+  CONCEPT_TEMPLATES,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
+  conceptTemplate,
+  parsePresentationPlan,
+  presentationBeatExtras,
+  presentationLayoutFits,
+  presentationLayoutNeeds,
+  presentationLayoutProblem,
+  presentationStat,
+  serializePresentationPlan
+} from "../chunk-4HQ7QZKB.js";
+import "../chunk-OFE5RZWW.js";
 import "../chunk-SVN7T6BK.js";
 import "../chunk-FUBMT6SJ.js";
 import "../chunk-JNUNNQ74.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-C4SB3NN4.js";
-import "../chunk-7MS26OXD.js";
+import "../chunk-DDJHIZED.js";
+import "../chunk-UDPPWYYM.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-CZ7AUSLI.js";
 import "../chunk-P53Z4RYC.js";
@@ -68,10 +88,14 @@ export {
   CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
+  PRESENTATION_AUTHOR_LIMITS,
   PRESENTATION_HINTS_KEY,
   PRESENTATION_KEY,
   PRESENTATION_LAYOUTS,
   PRESENTATION_LIMITS,
+  PRESENTATION_SLIDE_FORMAT,
+  PRESENTATION_STORYBOARD_FORMAT,
+  addressesAModel,
   allocateTiming,
   analyzeBlocks,
   applySavedPresentation,
@@ -88,6 +112,7 @@ export {
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  groundPresentationBeat,
   groundingSentences,
   isGroundedParaphrase,
   isVerbatimQuote,
@@ -96,11 +121,25 @@ export {
   numbersIn,
   parsePresentationHints,
   parsePresentationPlan,
+  presentationBeatExtras,
+  presentationCorrection,
   presentationLayoutFits,
+  presentationLayoutNeeds,
+  presentationLayoutProblem,
   presentationPassageKey,
+  presentationRetryContext,
   presentationSections,
+  presentationSlidePrompt,
+  presentationSlideRequest,
+  presentationSlidesToWord,
   presentationStat,
+  presentationStoryboardPrompt,
+  presentationStoryboardRequest,
+  presentationStoryboardTokens,
+  presentationUsesStoryboard,
   rangeEndOnly,
+  readPresentationSlideReply,
+  readPresentationStoryboardReply,
   resolveTransformStyle,
   restatesHeadline,
   serializePresentationHints,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.13.13",
+  "version": "2.13.15",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",

package/dist/chunk-FCB6JLWB.js

@@ -1,125 +0,0 @@
-// src/transform/grounding.ts
-var NUMBER = /\d[\d,]*(?:\.\d+)?/gu;
-function normalizeGroundingText(text) {
-  return text.toLowerCase().replace(/[‘’ʼ`]/gu, "'").replace(/[“”]/gu, '"').replace(/[–—]/gu, "-").replace(/[^a-z0-9'%\s-]/gu, " ").replace(/\s+/gu, " ").trim();
-}
-function numbersIn(value) {
-  if (typeof value === "number") return Number.isFinite(value) ? [String(value)] : [];
-  return (value.match(NUMBER) ?? []).map((number) => number.replace(/,/gu, ""));
-}
-var UNIT_WORDS = ["one", "two", "three", "four", "five", "six", "seven", "eight", "nine"];
-var TEEN_WORDS = [
-  "ten",
-  "eleven",
-  "twelve",
-  "thirteen",
-  "fourteen",
-  "fifteen",
-  "sixteen",
-  "seventeen",
-  "eighteen",
-  "nineteen"
-];
-var TENS_WORDS = ["twenty", "thirty", "forty", "fifty", "sixty", "seventy", "eighty", "ninety"];
-var NUMBER_WORD = new RegExp(
-  `\\b(?:(${TENS_WORDS.join("|")})(?:[-\\s](${UNIT_WORDS.join("|")}))?|(${[...UNIT_WORDS.slice(1), ...TEEN_WORDS].join("|")}))\\b`,
-  "giu"
-);
-function spelledNumbers(source) {
-  return [...source.matchAll(NUMBER_WORD)].map((match) => {
-    const [, tens, unit, small] = match;
-    const value = small ? [...UNIT_WORDS, ...TEEN_WORDS].indexOf(small.toLowerCase()) + 1 : (TENS_WORDS.indexOf(tens.toLowerCase()) + 2) * 10 + (unit ? UNIT_WORDS.indexOf(unit.toLowerCase()) + 1 : 0);
-    return { value: String(value), index: match.index };
-  });
-}
-function sourceNumbers(source) {
-  return /* @__PURE__ */ new Set([...numbersIn(source), ...spelledNumbers(source).map(({ value }) => value)]);
-}
-function ungroundedNumber(values, source) {
-  const stated = typeof source === "string" ? sourceNumbers(source) : source;
-  const list = Array.isArray(values) ? values : [values];
-  for (const value of list) {
-    const missing = numbersIn(value).find((number) => !stated.has(number));
-    if (missing !== void 0) return missing;
-  }
-  return void 0;
-}
-function groundingSentences(text) {
-  return (text.match(/[^.!?\n]+[.!?]*/gu) ?? []).map((sentence) => sentence.trim()).filter(Boolean);
-}
-function isVerbatimQuote(quote, source, options = {}) {
-  const q = normalizeGroundingText(quote);
-  if (!q) return false;
-  if (normalizeGroundingText(source).includes(q)) return true;
-  const words = q.split(" ").filter((word) => word.length > 1);
-  if (words.length === 0) return false;
-  const minShare = options.minShare ?? 0.9;
-  for (const sentence of options.sentences ?? groundingSentences(source)) {
-    const present = new Set(normalizeGroundingText(sentence).split(" "));
-    const hits = words.filter((word) => present.has(word)).length;
-    if (hits / words.length >= minShare) return true;
-  }
-  return false;
-}
-var COMMON = new Set(
-  "about after also because been before being both could does each from have into just like more most much only other over same should some such than that their them then there these they this those through very what when where which while will with would your ours".split(
-    " "
-  )
-);
-function distinctiveStems(text) {
-  return (text.toLowerCase().replace(/[‘’]/gu, "'").replace(/[“”]/gu, '"').replace(/[‐‑]/gu, "-").replace(/[‒–—―]/gu, " ").match(/[\p{L}\p{N}][\p{L}\p{N}'-]*/gu) ?? []).filter((word) => word.length >= 4 && !COMMON.has(word)).map((word) => word.slice(0, 4));
-}
-function isGroundedParaphrase(text, source, options = {}) {
-  if (ungroundedNumber(text, source) !== void 0) return false;
-  const stems = new Set(distinctiveStems(source));
-  const words = distinctiveStems(text);
-  const minShare = options.minShare ?? 2 / 3;
-  return words.filter((word) => stems.has(word)).length >= Math.ceil(words.length * minShare);
-}
-function restatesHeadline(point, headline) {
-  const title = distinctiveStems(headline);
-  const words = distinctiveStems(point);
-  const shared = words.filter((word) => title.includes(word)).length;
-  return words.length > 0 && shared >= words.length * 0.6 || title.length >= 3 && title.every((word) => words.includes(word));
-}
-var RANGE = /(?:\bbetween\s+(\d[\d,]*(?:\.\d+)?)\s+and\s+(\d[\d,]*(?:\.\d+)?))|(?:(\d[\d,]*(?:\.\d+)?)\s*(?:[-–—]|\bto\b)\s*(\d[\d,]*(?:\.\d+)?))/giu;
-function statedRanges(source) {
-  return [...source.matchAll(RANGE)].map((match) => ({
-    low: (match[1] ?? match[3]).replace(/,/gu, ""),
-    high: (match[2] ?? match[4]).replace(/,/gu, ""),
-    text: match[0],
-    index: match.index
-  }));
-}
-function rangeEndOnly(value, source) {
-  const [number] = numbersIn(value);
-  if (number === void 0) return void 0;
-  const ranges = statedRanges(source);
-  if (ranges.length === 0) return void 0;
-  if (spelledNumbers(source).some((spelled) => spelled.value === number)) return void 0;
-  let first;
-  for (const match of source.matchAll(NUMBER)) {
-    if (match[0].replace(/,/gu, "") !== number) continue;
-    const range = ranges.find(
-      (candidate) => match.index >= candidate.index && match.index < candidate.index + candidate.text.length
-    );
-    if (!range) return void 0;
-    first ?? (first = range);
-  }
-  return first;
-}
-
-export {
-  normalizeGroundingText,
-  numbersIn,
-  spelledNumbers,
-  sourceNumbers,
-  ungroundedNumber,
-  groundingSentences,
-  isVerbatimQuote,
-  distinctiveStems,
-  isGroundedParaphrase,
-  restatesHeadline,
-  statedRanges,
-  rangeEndOnly
-};