@bendyline/squisq 2.11.7 → 2.11.8

package/dist/{Doc-BkxT7G80.d.ts → Doc-CynsGqL4.d.ts}

@@ -1,5 +1,158 @@
 import { a3 as Transition, a5 as TransitionType, M as MarkdownBlockNode, r as MarkdownHeading } from './types-Be6sBUBx.js';
 
+/**
+ * Media-edit recipes — the non-destructive edit list a media reference carries.
+ *
+ * A recipe lives in the markdown, as parameters on the `{[audio|video …]}`
+ * annotation or `data-squisq-{audio|video}-*` attributes on a standalone
+ * `<audio>` / `<video>` tag. The source file is never modified: timeline ops
+ * (`cuts`, `gain`, `fadeIn`, `fadeOut`, `crop`) are applied at playback and
+ * export, and the signal chain (`fx`) is rendered into a derived, time-aligned
+ * audio file (see `renderStore.ts`). Undo is therefore the editor's ordinary
+ * undo, and a reference with no recipe behaves exactly as before.
+ *
+ * Pure and dependency-free: runs in the browser and in Node.
+ */
+/** Signal operations, in the FIXED order the chain applies them. */
+declare const MEDIA_FX_ORDER: readonly ["highpass", "denoise", "debreath", "loudness"];
+type MediaFxOpId = (typeof MEDIA_FX_ORDER)[number];
+interface MediaFxOpSpec {
+    /** Value used when the token carries none (`denoise` ≡ `denoise:0.8`). */
+    defaultValue: number;
+    min: number;
+    max: number;
+}
+/**
+ * Parameter contract per op. Values are clamped into range on parse, so a
+ * recipe always describes something the engine can render.
+ *
+ * - `highpass` — corner frequency in Hz.
+ * - `denoise` — wet/dry strength, 0…1.
+ * - `debreath` — attenuation applied to detected breaths, in dB (≤ 0).
+ * - `loudness` — integrated loudness target in LUFS.
+ */
+declare const MEDIA_FX_SPECS: Readonly<Record<MediaFxOpId, MediaFxOpSpec>>;
+interface MediaFxOp {
+    id: MediaFxOpId;
+    value: number;
+}
+interface MediaFxChain {
+    /** Known ops, de-duplicated (last wins) and in {@link MEDIA_FX_ORDER}. */
+    ops: MediaFxOp[];
+    /**
+     * Tokens this engine does not understand, preserved verbatim so a recipe
+     * written by a newer engine survives a round-trip through an older one.
+     * They are never rendered.
+     */
+    unknown: string[];
+}
+/** A removed range of the SOURCE file, in seconds (`start < end`). */
+interface MediaCut {
+    start: number;
+    end: number;
+}
+/** A crop rectangle, normalized to the source frame (0…1 on each axis). */
+interface MediaCrop {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** The complete recipe a media reference can carry. Every field is optional. */
+interface MediaEdits {
+    fx?: MediaFxChain;
+    /** Normalized: sorted, merged, non-overlapping. */
+    cuts?: MediaCut[];
+    /** Clip gain in dB. */
+    gain?: number;
+    /** Fade-in length in seconds, at the start of the played clip. */
+    fadeIn?: number;
+    /** Fade-out length in seconds, at the end of the played clip. */
+    fadeOut?: number;
+    crop?: MediaCrop;
+    /**
+     * Links companion clips (a screen + camera capture, a narration audio +
+     * video pair). Editors propagate cuts, trims and `fx` across a group.
+     */
+    group?: string;
+}
+/** Raw string values of a recipe, keyed by {@link MediaEditParamKey}. */
+type MediaEditParamValues = Partial<Record<MediaEditParamKey, string>>;
+type MediaEditParamKey = 'fx' | 'cuts' | 'gain' | 'fadeIn' | 'fadeOut' | 'crop' | 'group';
+/**
+ * Every recipe parameter with its two spellings: the annotation key
+ * (`fadeIn=0.3`) and the HTML attribute suffix, appended to the per-kind
+ * prefix (`data-squisq-video-fade-in="0.3"`). The order is the canonical
+ * serialization order.
+ */
+declare const MEDIA_EDIT_PARAMS: ReadonlyArray<{
+    key: MediaEditParamKey;
+    htmlSuffix: string;
+}>;
+/** `data-squisq-video-fade-in` for (`video`, `fadeIn`). */
+declare function mediaEditHtmlAttribute(kind: 'audio' | 'video', key: MediaEditParamKey): string;
+/** Compact, stable decimal: at most `digits` fraction digits, no `-0`. */
+declare function formatMediaNumber(value: number, digits?: number): string;
+/**
+ * Parse an `fx` value (`"highpass:80 denoise debreath:-15"`). Tokens split on
+ * whitespace or commas. A known op with a missing value gets its default; a
+ * known op with an unparseable value is kept verbatim in `unknown` rather
+ * than guessed at. `debreath:15` is read as −15 dB (attenuation is the only
+ * meaningful direction). Returns null when the value holds no tokens.
+ */
+declare function parseMediaFx(raw: string | undefined): MediaFxChain | null;
+/**
+ * Canonical `fx` string: known ops in chain order with explicit values, then
+ * unknown tokens in their authored order. Explicit values keep a recipe's
+ * meaning stable even if a later engine changes a default.
+ */
+declare function serializeMediaFx(chain: MediaFxChain): string;
+/** True when the chain would render anything (it has at least one known op). */
+declare function hasRenderableFx(chain: MediaFxChain | undefined): chain is MediaFxChain;
+/**
+ * Sort, merge overlapping or touching ranges, and drop empty ones. When a
+ * `[windowStart, windowEnd]` source window is given (the clip's trim), cuts
+ * are clamped into it and anything outside is dropped.
+ */
+declare function normalizeMediaCuts(cuts: readonly MediaCut[], windowStart?: number, windowEnd?: number): MediaCut[];
+/**
+ * Parse `"12.4-13.1 40.2-41"` (also `1:02-1:04.5`, comma separated). Invalid
+ * ranges are dropped. Returns null when nothing valid remains.
+ */
+declare function parseMediaCuts(raw: string | undefined): MediaCut[] | null;
+declare function serializeMediaCuts(cuts: readonly MediaCut[]): string;
+/**
+ * Parse `"x y w h"` (fractions of the source frame). The rectangle is clamped
+ * inside the frame. A full-frame rectangle means "no crop" and returns null.
+ */
+declare function parseMediaCrop(raw: string | undefined): MediaCrop | null;
+/** Clamp a crop rectangle into the frame; null when it covers the whole frame. */
+declare function normalizeMediaCrop(crop: MediaCrop): MediaCrop | null;
+declare function serializeMediaCrop(crop: MediaCrop): string;
+/**
+ * Parse a recipe from raw parameter values. Invalid fields are dropped
+ * (never guessed); neutral values (`gain=0`, `fadeIn=0`, full-frame crop)
+ * are dropped too. Returns undefined when nothing remains, so callers can
+ * leave `MediaClip.edits` unset for an unedited reference.
+ */
+declare function parseMediaEdits(values: MediaEditParamValues): MediaEdits | undefined;
+/**
+ * Serialize a recipe to raw parameter values. A key maps to `null` when its
+ * field is absent, so a writer can remove a stale attribute with the same
+ * call that sets the others.
+ */
+declare function serializeMediaEdits(edits: MediaEdits | undefined): Record<MediaEditParamKey, string | null>;
+/** Read recipe values from annotation params (`fx=…`, `fadeIn=…`). */
+declare function mediaEditValuesFromParams(params: Record<string, string>): MediaEditParamValues;
+/** Read recipe values from HTML attributes (`data-squisq-video-fade-in=…`). */
+declare function mediaEditValuesFromAttributes(kind: 'audio' | 'video', attributes: Record<string, string>): MediaEditParamValues;
+/**
+ * Stable key naming the render of `src` under `fx`. Only the known, canonical
+ * ops take part — unknown tokens are not rendered, so they must not force a
+ * re-render (the render manifest records them instead). 12 hex digits.
+ */
+declare function mediaRenderKey(src: string, fx: MediaFxChain): string;
+
 /**
  * Media-clip timing model.
  *
@@ -76,6 +229,11 @@ interface MediaClip {
      * timed relative to the document start and able to span every block.
      */
     anchor: 'block' | 'document';
+    /**
+     * Non-destructive edit recipe (`fx`, `cuts`, `gain`, fades, `crop`,
+     * `group`). Absent for an unedited reference. See `@bendyline/squisq/mediaEdit`.
+     */
+    edits?: MediaEdits;
     /**
      * 1-based source line of the authoring annotation, when derived from
      * markdown. Enables round-tripping edits (e.g. the timeline editor rewriting
@@ -128,6 +286,36 @@ interface ScheduledClip {
     blockId?: string;
     /** 1-based source line of the authoring annotation, when known. */
     sourceLine?: number;
+    /** Clip gain in dB (from the recipe). */
+    gain?: number;
+    /** Fade-in seconds at this entry's start (first segment of a cut clip only). */
+    fadeIn?: number;
+    /** Fade-out seconds at this entry's end (last segment of a cut clip only). */
+    fadeOut?: number;
+    /** Normalized crop rectangle for a video clip. */
+    crop?: MediaCrop;
+    /**
+     * True when a video's own audio track must stay silent because a processed
+     * companion audio entry (see {@link ScheduledClip.derivedFrom}) plays in its place.
+     */
+    audioMuted?: boolean;
+    /**
+     * Set on the processed companion audio entry emitted for an edited video:
+     * the id of the clip whose audio it replaces. Timeline UIs hide these.
+     */
+    derivedFrom?: string;
+    /** The source reference before processed-audio substitution. */
+    originalSrc?: string;
+    /**
+     * Present when a clip with cuts was expanded into contiguous entries, one
+     * per kept source range. `groupId` is the authored clip's id; entries of
+     * one group play the same source back to back.
+     */
+    segment?: {
+        groupId: string;
+        index: number;
+        count: number;
+    };
 }
 /** Options for {@link resolveMediaSchedule} / {@link getDocPlaybackDuration}. */
 interface MediaScheduleOptions {
@@ -146,7 +334,26 @@ interface MediaScheduleOptions {
      * block by design.
      */
     intrinsicDuration?: (clip: MediaClip) => number | undefined;
+    /**
+     * Optional lookup of a clip's processed (rendered `fx`) audio. When it
+     * returns a path, an audio clip plays that path instead of its source, and a
+     * video clip keeps its picture but mutes its own audio while a companion
+     * audio entry plays the processed track with identical timing. Renders are
+     * sample-aligned with the source, so no timing changes.
+     *
+     * Return undefined when no current render exists (the default when no
+     * lookup is wired): the clip then plays its original audio.
+     */
+    processedAudio?: (clip: MediaClip) => string | undefined;
 }
+/**
+ * Schedule one clip that occupies `[start, end)` on the doc timeline, honoring
+ * its recipe (cuts → contiguous segment entries, gain/fades/crop, processed
+ * audio). {@link resolveMediaSchedule} uses this for every annotated clip;
+ * hosts that schedule media from other sources (body-embedded `<audio>` /
+ * `<video>` tags) call it so edits behave identically there.
+ */
+declare function scheduleMediaClip(clip: MediaClip, start: number, end: number, anchor: 'block' | 'document', blockId?: string, opts?: MediaScheduleOptions): ScheduledClip[];
 /**
  * Flatten every block clip and document clip into absolute-timed
  * `ScheduledClip`s. Pure — depends only on `doc` (plus the optional intrinsic
@@ -2847,4 +3054,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { type ImageLayer as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, DEFAULT_DOC_FONT as E, DEFAULT_TITLE_FONT as F, type DataTableInput as G, type DateEventInput as H, type DeepPartial as I, type DefinitionCardInput as J, type DiagramBlockInput as K, type DiagramEdgeAnchor as L, type DiagramTemplateEdge as M, type DiagramTemplateNode as N, type Doc as O, type DocBlock as P, type DocDiagnostic as Q, type DonutChartInput as R, type DrawingBlockInput as S, FRONTMATTER_CUSTOM_TEMPLATES_KEY as T, FRONTMATTER_CUSTOM_THEMES_KEY as U, type FactCardInput as V, type FontFamily as W, type FontFamilyKind as X, type FullBleedQuoteInput as Y, type GradientBackgroundConfig as Z, type ImageBackgroundConfig as _, type AccentPosition as a, type ScheduledClip as a$, type ImageTreatment as a0, type ImageWithCaptionInput as a1, LIGHT_SURFACE as a2, type Layer as a3, type LayerRepeat as a4, type LayoutHints as a5, type LeftFeatureInput as a6, type LineChartInput as a7, type LinearGradient as a8, type ListBlockInput as a9, type PageAccentRotation as aA, type PageBackground as aB, type PageDesignFamily as aC, type PageEmphasis as aD, type PageHeadingTreatment as aE, type PageSectionKind as aF, type PageSectionOverride as aG, type PageTokens as aH, type PathLayer as aI, type PatternBackgroundConfig as aJ, type PersistentLayer as aK, type PersistentLayerConfig as aL, type PersistentLayerTemplate as aM, type PersistentLayerTemplateConfig as aN, type PersistentLayerTemplateType as aO, type PhotoGridInput as aP, type PieChartInput as aQ, type PipStyle as aR, type Position as aS, type ProgressIndicatorConfig as aT, type PromotedBodyAnnotation as aU, type PullQuoteInput as aV, type QuoteBlockInput as aW, type RawLayersInput as aX, type RenderStyle as aY, type RightFeatureInput as aZ, type ScatterChartInput as a_, type MapBlockInput as aa, type MapLayer as ab, type MapMarker as ac, type MapTileStyle as ad, type MarkerStyle as ae, type MediaClip as af, type MediaScheduleOptions as ag, type MermaidLayer as ah, PAGE_ACCENT_STRATEGIES as ai, PAGE_BACKGROUNDS as aj, PAGE_BACKGROUND_RHYTHMS as ak, PAGE_DESIGN_FAMILIES as al, PAGE_DIVIDERS as am, PAGE_EMPHASES as an, PAGE_EYEBROWS as ao, PAGE_HEADING_CASES as ap, PAGE_HEADING_SCALES as aq, PAGE_HEADING_UNDERLINES as ar, PAGE_HERO_STYLES as as, PAGE_IMAGE_FRAMINGS as at, PAGE_NUMERAL_STYLES as au, PAGE_PATTERNS as av, PAGE_QUOTE_MARKS as aw, PAGE_SECTION_KINDS as ax, PAGE_SECTION_SPACINGS as ay, PAGE_SHADOWS as az, type AmbientGradientConfig as b, getSafeTextBounds as b$, type SectionHeaderInput as b0, type ShapeFilter as b1, type ShapeLayer as b2, type ShapePattern as b3, type SolidBackgroundConfig as b4, type StartBlockConfig as b5, type StatHighlightInput as b6, type SurfaceScheme as b7, THEME_SCHEMA_VERSION as b8, type TableLayer as b9, type TreeLayerStyle as bA, type TreeTemplateItem as bB, type TwoColumnInput as bC, VIEWPORT_PRESETS as bD, type VideoLayer as bE, type VideoPipPosition as bF, type VideoPipShape as bG, type VideoPipSize as bH, type VideoPlacement as bI, type VideoPresentation as bJ, type VideoPullQuoteInput as bK, type VideoWithCaptionInput as bL, type ViewportConfig as bM, type ViewportOrientation as bN, type ViewportPreset as bO, type VignetteConfig as bP, applySurface as bQ, calculateDuration as bR, calculateFontScale as bS, createTemplateContext as bT, createTheme as bU, createThemeRegistry as bV, getAspectRatioString as bW, getBlockAtTime as bX, getCaptionAtTime as bY, getDocPlaybackDuration as bZ, getLayoutHints as b_, type TableLayerStyle as ba, type TemplateBlock as bb, type TemplateContext as bc, type TemplateFunction as bd, type TemplateRegistry as be, type TextLayer as bf, type TextStyle as bg, type Theme as bh, type ThemeColorPalette as bi, type ThemeColorScheme as bj, type ThemePageStyle as bk, type ThemeRegistry as bl, type ThemeSchemaVersion as bm, type ThemeSeedColors as bn, type ThemeStyle as bo, type ThemeTypography as bp, type TimelineBlockInput as bq, type TimelineTemplateEvent as br, type TimelineTemplateLink as bs, type TimelineTemplateTrack as bt, type TitleBlockInput as bu, type TitleCaptionConfig as bv, type TranscriptBlockInput as bw, type TreeBlockInput as bx, type TreeLayer as by, type TreeLayerItem as bz, type Animation as c, getSegmentAtTime as c0, getTwoColumnPositions as c1, getViewport as c2, getViewportOrientation as c3, isCustomTemplateDefinition as c4, isPersistentLayerTemplate as c5, isTemplateBlock as c6, scaledFontSize$1 as c7, resolveMediaSchedule as c8, scaledFontSize as c9, validateCustomTemplateDefinition as ca, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CustomTemplateDefinition as w, type CustomTemplateLayer as x, type CustomTemplateValidationError as y, type CustomTemplateValidationResult as z };
+export { type ImageLayer as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, DEFAULT_DOC_FONT as E, DEFAULT_TITLE_FONT as F, type DataTableInput as G, type DateEventInput as H, type DeepPartial as I, type DefinitionCardInput as J, type DiagramBlockInput as K, type DiagramEdgeAnchor as L, type DiagramTemplateEdge as M, type DiagramTemplateNode as N, type Doc as O, type DocBlock as P, type DocDiagnostic as Q, type DonutChartInput as R, type DrawingBlockInput as S, FRONTMATTER_CUSTOM_TEMPLATES_KEY as T, FRONTMATTER_CUSTOM_THEMES_KEY as U, type FactCardInput as V, type FontFamily as W, type FontFamilyKind as X, type FullBleedQuoteInput as Y, type GradientBackgroundConfig as Z, type ImageBackgroundConfig as _, type AccentPosition as a, type RenderStyle as a$, type ImageTreatment as a0, type ImageWithCaptionInput as a1, LIGHT_SURFACE as a2, type Layer as a3, type LayerRepeat as a4, type LayoutHints as a5, type LeftFeatureInput as a6, type LineChartInput as a7, type LinearGradient as a8, type ListBlockInput as a9, PAGE_SECTION_KINDS as aA, PAGE_SECTION_SPACINGS as aB, PAGE_SHADOWS as aC, type PageAccentRotation as aD, type PageBackground as aE, type PageDesignFamily as aF, type PageEmphasis as aG, type PageHeadingTreatment as aH, type PageSectionKind as aI, type PageSectionOverride as aJ, type PageTokens as aK, type PathLayer as aL, type PatternBackgroundConfig as aM, type PersistentLayer as aN, type PersistentLayerConfig as aO, type PersistentLayerTemplate as aP, type PersistentLayerTemplateConfig as aQ, type PersistentLayerTemplateType as aR, type PhotoGridInput as aS, type PieChartInput as aT, type PipStyle as aU, type Position as aV, type ProgressIndicatorConfig as aW, type PromotedBodyAnnotation as aX, type PullQuoteInput as aY, type QuoteBlockInput as aZ, type RawLayersInput as a_, type MapBlockInput as aa, type MapLayer as ab, type MapMarker as ac, type MapTileStyle as ad, type MarkerStyle as ae, type MediaClip as af, type MediaCrop as ag, type MediaCut as ah, type MediaEdits as ai, type MediaScheduleOptions as aj, type MermaidLayer as ak, PAGE_ACCENT_STRATEGIES as al, PAGE_BACKGROUNDS as am, PAGE_BACKGROUND_RHYTHMS as an, PAGE_DESIGN_FAMILIES as ao, PAGE_DIVIDERS as ap, PAGE_EMPHASES as aq, PAGE_EYEBROWS as ar, PAGE_HEADING_CASES as as, PAGE_HEADING_SCALES as at, PAGE_HEADING_UNDERLINES as au, PAGE_HERO_STYLES as av, PAGE_IMAGE_FRAMINGS as aw, PAGE_NUMERAL_STYLES as ax, PAGE_PATTERNS as ay, PAGE_QUOTE_MARKS as az, type AmbientGradientConfig as b, getCaptionAtTime as b$, type RightFeatureInput as b0, type ScatterChartInput as b1, type ScheduledClip as b2, type SectionHeaderInput as b3, type ShapeFilter as b4, type ShapeLayer as b5, type ShapePattern as b6, type SolidBackgroundConfig as b7, type StartBlockConfig as b8, type StatHighlightInput as b9, type TreeBlockInput as bA, type TreeLayer as bB, type TreeLayerItem as bC, type TreeLayerStyle as bD, type TreeTemplateItem as bE, type TwoColumnInput as bF, VIEWPORT_PRESETS as bG, type VideoLayer as bH, type VideoPipPosition as bI, type VideoPipShape as bJ, type VideoPipSize as bK, type VideoPlacement as bL, type VideoPresentation as bM, type VideoPullQuoteInput as bN, type VideoWithCaptionInput as bO, type ViewportConfig as bP, type ViewportOrientation as bQ, type ViewportPreset as bR, type VignetteConfig as bS, applySurface as bT, calculateDuration as bU, calculateFontScale as bV, createTemplateContext as bW, createTheme as bX, createThemeRegistry as bY, getAspectRatioString as bZ, getBlockAtTime as b_, type SurfaceScheme as ba, THEME_SCHEMA_VERSION as bb, type TableLayer as bc, type TableLayerStyle as bd, type TemplateBlock as be, type TemplateContext as bf, type TemplateFunction as bg, type TemplateRegistry as bh, type TextLayer as bi, type TextStyle as bj, type Theme as bk, type ThemeColorPalette as bl, type ThemeColorScheme as bm, type ThemePageStyle as bn, type ThemeRegistry as bo, type ThemeSchemaVersion as bp, type ThemeSeedColors as bq, type ThemeStyle as br, type ThemeTypography as bs, type TimelineBlockInput as bt, type TimelineTemplateEvent as bu, type TimelineTemplateLink as bv, type TimelineTemplateTrack as bw, type TitleBlockInput as bx, type TitleCaptionConfig as by, type TranscriptBlockInput as bz, type Animation as c, getDocPlaybackDuration as c0, getLayoutHints as c1, getSafeTextBounds as c2, getSegmentAtTime as c3, getTwoColumnPositions as c4, getViewport as c5, getViewportOrientation as c6, isCustomTemplateDefinition as c7, isPersistentLayerTemplate as c8, isTemplateBlock as c9, serializeMediaCuts as cA, serializeMediaEdits as cB, serializeMediaFx as cC, scaledFontSize$1 as ca, resolveMediaSchedule as cb, scaledFontSize as cc, scheduleMediaClip as cd, validateCustomTemplateDefinition as ce, type MediaFxOpId as cf, type MediaFxChain as cg, MEDIA_EDIT_PARAMS as ch, MEDIA_FX_ORDER as ci, MEDIA_FX_SPECS as cj, type MediaEditParamKey as ck, type MediaEditParamValues as cl, type MediaFxOp as cm, formatMediaNumber as cn, hasRenderableFx as co, mediaEditHtmlAttribute as cp, mediaEditValuesFromAttributes as cq, mediaEditValuesFromParams as cr, mediaRenderKey as cs, normalizeMediaCrop as ct, normalizeMediaCuts as cu, parseMediaCrop as cv, parseMediaCuts as cw, parseMediaEdits as cx, parseMediaFx as cy, serializeMediaCrop as cz, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CustomTemplateDefinition as w, type CustomTemplateLayer as x, type CustomTemplateValidationError as y, type CustomTemplateValidationResult as z };

package/dist/{ImageEditDoc-C8ZB54Vv.d.ts → ImageEditDoc-BVZe_5y4.d.ts}

@@ -1,4 +1,4 @@
-import { $ as ImageLayer, bf as TextLayer, b2 as ShapeLayer, aI as PathLayer } from './Doc-BkxT7G80.js';
+import { $ as ImageLayer, bi as TextLayer, b5 as ShapeLayer, aL as PathLayer } from './Doc-CynsGqL4.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-SKKBRLLM.js → chunk-5FBI3ZW4.js}

@@ -1,11 +1,16 @@
+import {
+  biquadRun,
+  highpassCoeffs,
+  lowpassCoeffs
+} from "./chunk-NEWNNLWN.js";
 import {
   buildNarrationScript,
   expectedSyllablesAt,
   wordPosAtExpectedSyllables
-} from "./chunk-EF353KGH.js";
+} from "./chunk-ZEONJCP3.js";
 import {
   flattenRenderableBlocks
-} from "./chunk-3YNFMFNK.js";
+} from "./chunk-RMCUZDW5.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({
@@ -71,32 +76,6 @@ var DEFAULT_ALIGN_CONFIG = Object.freeze({
 });
 
 // src/narration/features.ts
-function highpassCoeffs(sampleRate, freqHz) {
-  const w0 = 2 * Math.PI * freqHz / sampleRate;
-  const cosW0 = Math.cos(w0);
-  const alpha = Math.sin(w0) / (2 * Math.SQRT1_2);
-  const a0 = 1 + alpha;
-  return {
-    b0: (1 + cosW0) / 2 / a0,
-    b1: -(1 + cosW0) / a0,
-    b2: (1 + cosW0) / 2 / a0,
-    a1: -2 * cosW0 / a0,
-    a2: (1 - alpha) / a0
-  };
-}
-function lowpassCoeffs(sampleRate, freqHz) {
-  const w0 = 2 * Math.PI * freqHz / sampleRate;
-  const cosW0 = Math.cos(w0);
-  const alpha = Math.sin(w0) / (2 * Math.SQRT1_2);
-  const a0 = 1 + alpha;
-  return {
-    b0: (1 - cosW0) / 2 / a0,
-    b1: (1 - cosW0) / a0,
-    b2: (1 - cosW0) / 2 / a0,
-    a1: -2 * cosW0 / a0,
-    a2: (1 - alpha) / a0
-  };
-}
 function createBandpass(sampleRate, lowHz = DEFAULT_FEATURE_CONFIG.bandLowHz, highHz = DEFAULT_FEATURE_CONFIG.bandHighHz) {
   return {
     coeffs: { hp: highpassCoeffs(sampleRate, lowHz), lp: lowpassCoeffs(sampleRate, highHz) },
@@ -104,20 +83,6 @@ function createBandpass(sampleRate, lowHz = DEFAULT_FEATURE_CONFIG.bandLowHz, hi
     lp: { x1: 0, x2: 0, y1: 0, y2: 0 }
   };
 }
-function biquadRun(coeffs, state, input, output) {
-  let { x1, x2, y1, y2 } = state;
-  const { b0, b1, b2, a1, a2 } = coeffs;
-  for (let i = 0; i < input.length; i++) {
-    const x0 = input[i];
-    const y0 = b0 * x0 + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2;
-    output[i] = y0;
-    x2 = x1;
-    x1 = x0;
-    y2 = y1;
-    y1 = y0;
-  }
-  return { x1, x2, y1, y2 };
-}
 function bandpassRun(state, input, output) {
   const hp = biquadRun(state.coeffs.hp, state.hp, input, output);
   const lp = biquadRun(state.coeffs.lp, state.lp, output, output);

package/dist/{chunk-YGGYYBJS.js → chunk-JJO6JFNZ.js}

@@ -1,6 +1,6 @@
 import {
   defaultPageStyle
-} from "./chunk-GAZKTT4R.js";
+} from "./chunk-YNO6JV36.js";
 import {
   FONT_FALLBACKS,
   THEME_SCHEMA_VERSION,

package/dist/{chunk-SOIV7KDO.js → chunk-JM2QARY2.js}

@@ -1,7 +1,7 @@
 import {
   buildNarrationScript,
   parseNarrationTimingJson
-} from "./chunk-EF353KGH.js";
+} from "./chunk-ZEONJCP3.js";
 import {
   SHAPE_NAMES,
   buildChartData,
@@ -32,10 +32,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-3YNFMFNK.js";
-import {
-  iconMarker
-} from "./chunk-7ZAAICW4.js";
+} from "./chunk-RMCUZDW5.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -53,10 +50,13 @@ import {
   toGrid,
   traceBoxes
 } from "./chunk-C3NAY5YP.js";
+import {
+  iconMarker
+} from "./chunk-7ZAAICW4.js";
 import {
   defaultPageStyle,
   resolveMediaSchedule
-} from "./chunk-GAZKTT4R.js";
+} from "./chunk-YNO6JV36.js";
 import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
@@ -74,9 +74,15 @@ import {
   resolveTheme,
   withAlpha
 } from "./chunk-Y4D6TDZT.js";
+import {
+  createMediaTimeMap
+} from "./chunk-JSGIWW35.js";
+import {
+  serializeMediaEdits
+} from "./chunk-L7QZORLB.js";
 import {
   parseMarkdown
-} from "./chunk-CW24CH7I.js";
+} from "./chunk-HUXK7EOT.js";
 import {
   KNOWN_BLOCK_META_KEYS,
   TABLE_FED_TEMPLATES,
@@ -596,6 +602,9 @@ function synthesizeMediaParagraph(clip) {
   if (clip.clipStart != null) params.clipStart = String(clip.clipStart);
   if (clip.clipEnd != null) params.clipEnd = String(clip.clipEnd);
   if (clip.spillover) params.spillover = "true";
+  for (const [key, value] of Object.entries(serializeMediaEdits(clip.edits))) {
+    if (value != null) params[key] = value;
+  }
   return {
     type: "paragraph",
     children: [{ type: "text", value: serializeAnnotation(clip.kind, params) }]
@@ -3976,6 +3985,26 @@ function proportionalRanges(doc, timing) {
   });
   return ranges;
 }
+function narrationTimeMap(clip, takeDuration) {
+  const trimmed = clip.clipStart != null || clip.clipEnd != null;
+  if (!trimmed && !clip.edits?.cuts?.length) return null;
+  return createMediaTimeMap({
+    clipStart: clip.clipStart,
+    clipEnd: clip.clipEnd,
+    cuts: clip.edits?.cuts,
+    sourceDuration: takeDuration
+  });
+}
+function mapRangesToPlayed(ranges, map2) {
+  const mapped = /* @__PURE__ */ new Map();
+  for (const [blockId, range] of ranges) {
+    mapped.set(blockId, {
+      startSec: map2.snapSourceToPlayed(range.startSec),
+      endSec: map2.snapSourceToPlayed(range.endSec)
+    });
+  }
+  return mapped;
+}
 function retimeBlocks(blocks, ctx) {
   return blocks.map((block) => {
     const range = ctx.ranges.get(block.id);
@@ -4018,8 +4047,11 @@ async function applyNarrationTiming(doc, container) {
     const timing = parseNarrationTimingJson(sidecarData);
     if (!timing) continue;
     const flat = flattenRenderableBlocks(doc.blocks);
-    const ranges = timing.blocks.length > 0 ? matchSidecarBlocks(flat, timing) : proportionalRanges(doc, timing);
-    if (!ranges || ranges.size === 0) continue;
+    const takeRanges = timing.blocks.length > 0 ? matchSidecarBlocks(flat, timing) : proportionalRanges(doc, timing);
+    if (!takeRanges || takeRanges.size === 0) continue;
+    const timeMap = narrationTimeMap(clip, timing.duration);
+    const ranges = timeMap ? mapRangesToPlayed(takeRanges, timeMap) : takeRanges;
+    const playedDuration = timeMap ? timeMap.playedDuration : timing.duration;
     const ctx = {
       clipStart: clip.startAt,
       ranges,
@@ -4028,7 +4060,7 @@ async function applyNarrationTiming(doc, container) {
       shift: 0
     };
     const blocks = retimeBlocks(doc.blocks, ctx);
-    const duration = Math.max(clip.startAt + timing.duration, ctx.cursor);
+    const duration = Math.max(clip.startAt + playedDuration, ctx.cursor);
     const retimed = {
       ...doc,
       blocks,

package/dist/chunk-JSGIWW35.js

@@ -0,0 +1,70 @@
+import {
+  normalizeMediaCuts
+} from "./chunk-L7QZORLB.js";
+
+// src/mediaEdit/timeMap.ts
+function createMediaTimeMap(input) {
+  const windowStart = Math.max(0, input.clipStart ?? 0);
+  let windowEnd = input.clipEnd ?? Number.POSITIVE_INFINITY;
+  if (input.sourceDuration != null && Number.isFinite(input.sourceDuration)) {
+    windowEnd = Math.min(windowEnd, input.sourceDuration);
+  }
+  windowEnd = Math.max(windowStart, windowEnd);
+  const cuts = normalizeMediaCuts(input.cuts ?? [], windowStart, windowEnd);
+  const kept = [];
+  let cursor = windowStart;
+  for (const cut of cuts) {
+    if (cut.start > cursor) kept.push({ start: cursor, end: cut.start });
+    cursor = Math.max(cursor, cut.end);
+  }
+  if (windowEnd > cursor) kept.push({ start: cursor, end: windowEnd });
+  const offsets = [];
+  let total = 0;
+  for (const range of kept) {
+    offsets.push(total);
+    total += range.end - range.start;
+  }
+  const playedDuration = total;
+  const sourceToPlayed = (t) => {
+    for (let i = 0; i < kept.length; i++) {
+      const range = kept[i];
+      if (t >= range.start && (t < range.end || i === kept.length - 1 && t === range.end)) {
+        return offsets[i] + (t - range.start);
+      }
+    }
+    return null;
+  };
+  const snapSourceToPlayed = (t) => {
+    if (kept.length === 0 || t <= windowStart) return 0;
+    for (let i = 0; i < kept.length; i++) {
+      const range = kept[i];
+      if (t < range.start) return offsets[i];
+      if (t < range.end) return offsets[i] + (t - range.start);
+    }
+    return playedDuration;
+  };
+  const playedToSource = (p) => {
+    if (kept.length === 0) return windowStart;
+    if (p <= 0) return kept[0].start;
+    for (let i = 0; i < kept.length; i++) {
+      const length = kept[i].end - kept[i].start;
+      if (p < offsets[i] + length) return kept[i].start + (p - offsets[i]);
+    }
+    return kept[kept.length - 1].end;
+  };
+  return {
+    windowStart,
+    windowEnd,
+    cuts,
+    hasCuts: cuts.length > 0,
+    playedDuration,
+    keptRanges: () => kept.map((r) => ({ ...r })),
+    sourceToPlayed,
+    snapSourceToPlayed,
+    playedToSource
+  };
+}
+
+export {
+  createMediaTimeMap
+};

package/dist/{chunk-IYZTF4VO.js → chunk-KFZOCWPK.js}

@@ -5,14 +5,14 @@ import {
 } from "./chunk-SVN7T6BK.js";
 import {
   markdownToDoc
-} from "./chunk-3YNFMFNK.js";
+} from "./chunk-RMCUZDW5.js";
 import {
   cloneAndFreezeData,
   isTemplateBlock
 } from "./chunk-Y4D6TDZT.js";
 import {
   parseMarkdown
-} from "./chunk-CW24CH7I.js";
+} from "./chunk-HUXK7EOT.js";
 import {
   extractPlainText,
   getChildren