@bendyline/squisq 2.11.4 → 2.11.6

package/dist/timing/index.js

@@ -1,17 +1,19 @@
 import {
-  estimateNarrationTime,
-  estimateReadingTime
-} from "../chunk-XOFT65EX.js";
+  buildCaptionTrack
+} from "../chunk-44BJ42GT.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,
+  estimateNarrationTime,
+  estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "../chunk-67L6WRJN.js";
+} from "../chunk-GHOPHGOK.js";
 export {
   DEFAULT_WORDS_PER_SECOND,
+  buildCaptionTrack,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,

package/dist/transform/index.d.ts

@@ -1,4 +1,4 @@
-import { r as ColorScheme, O as Doc, k as Block } from '../Doc-BkxT7G80.js';
+import { O as Doc, r as ColorScheme, k as Block, bb as TemplateBlock } from '../Doc-BkxT7G80.js';
 import { i as PageTransformHints } from '../materializePageSection-Dp2aHFbc.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-Be6sBUBx.js';
@@ -145,6 +145,67 @@ interface TransformResult {
  */
 declare function applyTransform(doc: Doc, style: TransformStyleInput, options?: TransformOptions): TransformResult;
 
+/**
+ * Narrated Segment Transformation
+ *
+ * Converts a narrated text segment and its media into a timed Doc using the
+ * canonical squisq transform pipeline. This is the reusable bridge for hosts
+ * that generate one visual sequence per narration segment.
+ */
+
+interface NarratedSegmentVideo {
+    src: string;
+    posterSrc?: string;
+    alt?: string;
+    clipStart: number;
+    clipEnd: number;
+    sourceDuration?: number;
+    credit?: string;
+    license?: string;
+}
+interface NarratedSegmentInput {
+    articleId: string;
+    segmentId: string;
+    title: string;
+    text: string;
+    duration: number;
+    audioSrc: string;
+    audioName?: string;
+    images?: TransformImage[];
+    videos?: NarratedSegmentVideo[];
+    includeTitleBlock?: boolean;
+}
+interface NarratedSegmentTransformOptions extends Pick<TransformOptions, 'themeId' | 'registry'> {
+    style?: TransformStyleInput;
+    seed?: number;
+    minConfidence?: number;
+    slidesPerMinute?: number;
+}
+interface NarratedSegmentResult extends TransformResult {
+    seed: number;
+}
+declare function transformNarratedSegment(input: NarratedSegmentInput, options?: NarratedSegmentTransformOptions): NarratedSegmentResult;
+
+/**
+ * Timing Allocator
+ *
+ * Distributes timing (startTime, duration) across transformed blocks.
+ * When the source Doc has audio, blocks are fitted to the overall duration.
+ * When no audio is present, uses reading-time estimation.
+ */
+
+/**
+ * Allocate startTime and duration across a mixed array of blocks and
+ * template blocks. Template blocks get timing assigned; existing blocks
+ * retain their original timing when possible.
+ *
+ * @param blocks - The output from templateSelector (mixed Block | TemplateBlock).
+ * @param totalDuration - The Doc's total duration (from audio or estimation).
+ * @returns A new array of Blocks with consistent timing. Template blocks
+ *          are returned as Blocks (with startTime/duration set, layers empty).
+ */
+declare function allocateTiming(blocks: Array<Block | TemplateBlock>, totalDuration: number): Block[];
+
 /**
  * Transform Style Registry
  *
@@ -220,4 +281,4 @@ declare function extractDocImages(blocks: Block[]): TransformImage[];
  */
 declare function analyzeBlocks(blocks: Block[], options?: ExtractionOptions): AnalyzedBlock[];
 
-export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, analyzeBlocks, applyTransform, createTransformStyleRegistry, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, resolveTransformStyle };
+export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, allocateTiming, analyzeBlocks, applyTransform, createTransformStyleRegistry, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, resolveTransformStyle, transformNarratedSegment };

package/dist/transform/index.js

@@ -1,25 +1,36 @@
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
+  allocateTiming,
   analyzeBlocks,
   applyTransform,
   createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  resolveTransformStyle
-} from "../chunk-ZSU5DJLX.js";
-import "../chunk-NKNMGIIN.js";
-import "../chunk-BAOV476U.js";
+  resolveTransformStyle,
+  transformNarratedSegment
+} from "../chunk-J2IPSQKP.js";
+import "../chunk-SVN7T6BK.js";
+import "../chunk-WAGJK36Q.js";
+import "../chunk-PUS54YU6.js";
+import "../chunk-C3NAY5YP.js";
+import "../chunk-Y4D6TDZT.js";
+import "../chunk-CW24CH7I.js";
+import "../chunk-TMOHAFYE.js";
+import "../chunk-7N4G32LG.js";
 import "../chunk-X7BNDUNI.js";
-import "../chunk-67L6WRJN.js";
+import "../chunk-4VOD55SX.js";
+import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
+  allocateTiming,
   analyzeBlocks,
   applyTransform,
   createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  resolveTransformStyle
+  resolveTransformStyle,
+  transformNarratedSegment
 };

package/dist/types-BQWu0gzi.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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[];
+
+export { PROOF_DIALECTS as P, type ProofCategory as a, type ProofDialect as b, type ProofFinding as c, type ProofRange as d, type ProofSuggestion as e, type ProofSuggestionKind as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.11.4",
+  "version": "2.11.6",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",
@@ -132,6 +132,11 @@
       "import": "./dist/proof/index.js",
       "default": "./dist/proof/index.js"
     },
+    "./review": {
+      "types": "./dist/review/index.d.ts",
+      "import": "./dist/review/index.js",
+      "default": "./dist/review/index.js"
+    },
     "./table": {
       "types": "./dist/table/index.d.ts",
       "import": "./dist/table/index.js",

package/dist/chunk-BAOV476U.js

@@ -1,214 +0,0 @@
-// src/schemas/Viewport.ts
-var VIEWPORT_PRESETS = {
-  /** 16:9 landscape (default, 1080p) */
-  landscape: { width: 1920, height: 1080, name: "16:9 Landscape" },
-  /** 9:16 portrait (vertical video, stories) */
-  portrait: { width: 1080, height: 1920, name: "9:16 Portrait" },
-  /** 1:1 square (social media) */
-  square: { width: 1080, height: 1080, name: "1:1 Square" },
-  /** 4:3 standard */
-  standard: { width: 1440, height: 1080, name: "4:3 Standard" }
-};
-function getViewport(viewport) {
-  if (typeof viewport === "string") {
-    return VIEWPORT_PRESETS[viewport];
-  }
-  return viewport;
-}
-var REFERENCE_DIAGONAL = Math.sqrt(1920 * 1920 + 1080 * 1080);
-function calculateFontScale(viewport) {
-  const currentDiagonal = Math.sqrt(
-    viewport.width * viewport.width + viewport.height * viewport.height
-  );
-  return currentDiagonal / REFERENCE_DIAGONAL;
-}
-function getViewportOrientation(viewport) {
-  const ratio = viewport.width / viewport.height;
-  if (Math.abs(ratio - 1) < 0.05) return "square";
-  return ratio > 1 ? "landscape" : "portrait";
-}
-function getAspectRatioString(viewport) {
-  const gcd = (a, b) => b === 0 ? a : gcd(b, a % b);
-  const divisor = gcd(viewport.width, viewport.height);
-  return `${viewport.width / divisor}:${viewport.height / divisor}`;
-}
-
-// src/schemas/LayoutStrategy.ts
-var LAYOUT_CONFIGS = {
-  landscape: {
-    primaryY: "35%",
-    secondaryY: "55%",
-    tertiaryY: "75%",
-    titleScale: 1,
-    bodyScale: 1,
-    columnLeftX: "25%",
-    columnRightX: "75%",
-    columnTopY: "35%",
-    columnBottomY: "65%",
-    stackColumns: false,
-    maxTextWidth: "80%",
-    horizontalPadding: "10%",
-    captionY: "85%",
-    captionScale: 1
-  },
-  portrait: {
-    // Content positioned higher for thumb-reach zone on mobile
-    primaryY: "25%",
-    secondaryY: "42%",
-    tertiaryY: "58%",
-    // Titles scale down for narrower width; body text scales up to fill vertical space
-    titleScale: 0.7,
-    bodyScale: 1.5,
-    // Stacked columns instead of side-by-side
-    columnLeftX: "50%",
-    columnRightX: "50%",
-    columnTopY: "30%",
-    columnBottomY: "55%",
-    stackColumns: true,
-    // Wider relative to viewport to use available space
-    maxTextWidth: "90%",
-    horizontalPadding: "5%",
-    captionY: "75%",
-    captionScale: 0.85
-  },
-  square: {
-    primaryY: "30%",
-    secondaryY: "50%",
-    tertiaryY: "70%",
-    titleScale: 0.85,
-    bodyScale: 0.9,
-    columnLeftX: "25%",
-    columnRightX: "75%",
-    columnTopY: "35%",
-    columnBottomY: "65%",
-    stackColumns: false,
-    maxTextWidth: "85%",
-    horizontalPadding: "7.5%",
-    captionY: "82%",
-    captionScale: 0.9
-  }
-};
-function getLayoutHints(orientation) {
-  return LAYOUT_CONFIGS[orientation];
-}
-function scaledFontSize(basePx, viewport, orientation, isTitle = false) {
-  const fontScale = calculateFontScale(viewport);
-  const layout = getLayoutHints(orientation);
-  const typeScale = isTitle ? layout.titleScale : layout.bodyScale;
-  return Math.round(basePx * fontScale * typeScale);
-}
-function getTwoColumnPositions(orientation) {
-  const layout = getLayoutHints(orientation);
-  if (layout.stackColumns) {
-    return {
-      left: { x: "50%", y: layout.columnTopY },
-      right: { x: "50%", y: layout.columnBottomY }
-    };
-  }
-  return {
-    left: { x: layout.columnLeftX, y: "50%" },
-    right: { x: layout.columnRightX, y: "50%" }
-  };
-}
-function getSafeTextBounds(orientation) {
-  const layout = getLayoutHints(orientation);
-  return {
-    left: layout.horizontalPadding,
-    right: layout.horizontalPadding,
-    top: "10%",
-    bottom: "10%"
-  };
-}
-
-// src/schemas/BlockTemplates.ts
-var DEFAULT_DOC_FONT = 'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif';
-var DEFAULT_TITLE_FONT = 'Georgia, "Times New Roman", serif';
-function isTemplateBlock(block) {
-  return "template" in block && typeof block.template === "string";
-}
-function createTemplateContext(theme, blockIndex, totalBlocks, viewport = VIEWPORT_PRESETS.landscape) {
-  const orientation = getViewportOrientation(viewport);
-  const overrides = theme.renderStyle.layoutOverrides;
-  const baseLayout = getLayoutHints(orientation);
-  return {
-    theme,
-    blockIndex,
-    totalBlocks,
-    viewport,
-    fontScale: calculateFontScale(viewport),
-    orientation,
-    layout: overrides ? { ...baseLayout, ...overrides } : baseLayout
-  };
-}
-function scaledFontSize2(basePx, context, isTitle = false) {
-  return scaledFontSize(basePx, context.viewport, context.orientation, isTitle);
-}
-function isPersistentLayerTemplate(layer) {
-  return "template" in layer && typeof layer.template === "string";
-}
-
-// src/internal/immutable.ts
-function cloneData(value, seen = /* @__PURE__ */ new WeakMap()) {
-  if (value === null || typeof value !== "object") return value;
-  const existing = seen.get(value);
-  if (existing !== void 0) return existing;
-  const tag = Object.prototype.toString.call(value);
-  if (tag === "[object ArrayBuffer]") {
-    const source2 = new Uint8Array(value);
-    const copy2 = new Uint8Array(source2.byteLength);
-    copy2.set(source2);
-    return copy2.buffer;
-  }
-  if (tag === "[object Date]") {
-    return new Date(Date.prototype.getTime.call(value));
-  }
-  if (Array.isArray(value)) {
-    const copy2 = [];
-    seen.set(value, copy2);
-    for (const item of value) copy2.push(cloneData(item, seen));
-    return copy2;
-  }
-  const source = value;
-  const copy = {};
-  seen.set(value, copy);
-  for (const key of Object.keys(source)) {
-    Object.defineProperty(copy, key, {
-      value: cloneData(source[key], seen),
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  }
-  return copy;
-}
-function deepFreezeData(value, seen = /* @__PURE__ */ new WeakSet()) {
-  if (value === null || typeof value !== "object" || seen.has(value)) return value;
-  seen.add(value);
-  for (const key of Object.keys(value)) {
-    deepFreezeData(value[key], seen);
-  }
-  return Object.freeze(value);
-}
-function cloneAndFreezeData(value) {
-  return deepFreezeData(cloneData(value));
-}
-
-export {
-  VIEWPORT_PRESETS,
-  getViewport,
-  calculateFontScale,
-  getViewportOrientation,
-  getAspectRatioString,
-  getLayoutHints,
-  scaledFontSize,
-  getTwoColumnPositions,
-  getSafeTextBounds,
-  DEFAULT_DOC_FONT,
-  DEFAULT_TITLE_FONT,
-  isTemplateBlock,
-  createTemplateContext,
-  scaledFontSize2,
-  isPersistentLayerTemplate,
-  cloneData,
-  cloneAndFreezeData
-};

package/dist/chunk-XOFT65EX.js

@@ -1,34 +0,0 @@
-import {
-  DEFAULT_WORDS_PER_SECOND,
-  countSpokenWords
-} from "./chunk-67L6WRJN.js";
-
-// src/timing/readingTime.ts
-var DEFAULT_READING_WPM = 200;
-function estimateReadingTime(text, options) {
-  const configuredWpm = options?.wordsPerMinute;
-  const wpm = typeof configuredWpm === "number" && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;
-  const words = text.split(/\s+/).filter((w) => w.length > 0).length;
-  const minutes = words / wpm;
-  return {
-    words,
-    minutes,
-    seconds: Math.round(minutes * 60)
-  };
-}
-function estimateNarrationTime(text, options) {
-  const providedWps = options?.wordsPerSecond;
-  const wps = typeof providedWps === "number" && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;
-  const spokenWords = countSpokenWords(text);
-  const totalSeconds = spokenWords / wps;
-  return {
-    spokenWords,
-    minutes: totalSeconds / 60,
-    seconds: Math.round(totalSeconds)
-  };
-}
-
-export {
-  estimateReadingTime,
-  estimateNarrationTime
-};