@bendyline/squisq 2.11.7 → 2.11.9

package/dist/{Doc-BkxT7G80.d.ts → Doc-DmElSKmg.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
@@ -1374,6 +1581,17 @@ interface ProgressIndicatorConfig {
  */
 declare const PAGE_SECTION_KINDS: readonly ["hero", "banner", "stat-band", "quote-band", "feature-split", "media-figure", "gallery", "callout", "card-grid", "item-list", "timeline-rail", "table-section", "canvas-embed", "prose", "footer"];
 type PageSectionKind = (typeof PAGE_SECTION_KINDS)[number];
+/**
+ * How a page rendition reads. `page` (the default) is the art-directed
+ * scrolling site: a centered cover hero, display type, section bands, and
+ * content-aware templates. `document` is the working-document register for
+ * reports, notes, and previews: a left-aligned masthead, one heading scale
+ * that follows the markdown hierarchy whatever section carries it, one flat
+ * surface, and markdown structure kept as written — auto-picked templates
+ * render as prose, while authored `{[template]}` annotations still apply.
+ */
+declare const PAGE_VARIANTS: readonly ["page", "document"];
+type PageVariant = (typeof PAGE_VARIANTS)[number];
 /** Relative visual weight of a section within the page. */
 type PageEmphasis = 'lead' | 'strong' | 'standard' | 'quiet';
 /** Which background treatment a section sits on. */
@@ -2847,4 +3065,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 QuoteBlockInput 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, PAGE_VARIANTS as aD, type PageAccentRotation as aE, type PageBackground as aF, type PageDesignFamily as aG, type PageEmphasis as aH, type PageHeadingTreatment as aI, type PageSectionKind as aJ, type PageSectionOverride as aK, type PageTokens as aL, type PageVariant as aM, type PathLayer as aN, type PatternBackgroundConfig as aO, type PersistentLayer as aP, type PersistentLayerConfig as aQ, type PersistentLayerTemplate as aR, type PersistentLayerTemplateConfig as aS, type PersistentLayerTemplateType as aT, type PhotoGridInput as aU, type PieChartInput as aV, type PipStyle as aW, type Position as aX, type ProgressIndicatorConfig as aY, type PromotedBodyAnnotation as aZ, type PullQuoteInput 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, getAspectRatioString as b$, type RawLayersInput as b0, type RenderStyle as b1, type RightFeatureInput as b2, type ScatterChartInput as b3, type ScheduledClip as b4, type SectionHeaderInput as b5, type ShapeFilter as b6, type ShapeLayer as b7, type ShapePattern as b8, type SolidBackgroundConfig as b9, type TitleCaptionConfig as bA, type TranscriptBlockInput as bB, type TreeBlockInput as bC, type TreeLayer as bD, type TreeLayerItem as bE, type TreeLayerStyle as bF, type TreeTemplateItem as bG, type TwoColumnInput as bH, VIEWPORT_PRESETS as bI, type VideoLayer as bJ, type VideoPipPosition as bK, type VideoPipShape as bL, type VideoPipSize as bM, type VideoPlacement as bN, type VideoPresentation as bO, type VideoPullQuoteInput as bP, type VideoWithCaptionInput as bQ, type ViewportConfig as bR, type ViewportOrientation as bS, type ViewportPreset as bT, type VignetteConfig as bU, applySurface as bV, calculateDuration as bW, calculateFontScale as bX, createTemplateContext as bY, createTheme as bZ, createThemeRegistry as b_, type StartBlockConfig as ba, type StatHighlightInput as bb, type SurfaceScheme as bc, THEME_SCHEMA_VERSION as bd, type TableLayer as be, type TableLayerStyle as bf, type TemplateBlock as bg, type TemplateContext as bh, type TemplateFunction as bi, type TemplateRegistry as bj, type TextLayer as bk, type TextStyle as bl, type Theme as bm, type ThemeColorPalette as bn, type ThemeColorScheme as bo, type ThemePageStyle as bp, type ThemeRegistry as bq, type ThemeSchemaVersion as br, type ThemeSeedColors as bs, type ThemeStyle as bt, type ThemeTypography as bu, type TimelineBlockInput as bv, type TimelineTemplateEvent as bw, type TimelineTemplateLink as bx, type TimelineTemplateTrack as by, type TitleBlockInput as bz, type Animation as c, getBlockAtTime as c0, getCaptionAtTime as c1, getDocPlaybackDuration as c2, getLayoutHints as c3, getSafeTextBounds as c4, getSegmentAtTime as c5, getTwoColumnPositions as c6, getViewport as c7, getViewportOrientation as c8, isCustomTemplateDefinition as c9, parseMediaFx as cA, serializeMediaCrop as cB, serializeMediaCuts as cC, serializeMediaEdits as cD, serializeMediaFx as cE, isPersistentLayerTemplate as ca, isTemplateBlock as cb, scaledFontSize$1 as cc, resolveMediaSchedule as cd, scaledFontSize as ce, scheduleMediaClip as cf, validateCustomTemplateDefinition as cg, type MediaFxOpId as ch, type MediaFxChain as ci, MEDIA_EDIT_PARAMS as cj, MEDIA_FX_ORDER as ck, MEDIA_FX_SPECS as cl, type MediaEditParamKey as cm, type MediaEditParamValues as cn, type MediaFxOp as co, formatMediaNumber as cp, hasRenderableFx as cq, mediaEditHtmlAttribute as cr, mediaEditValuesFromAttributes as cs, mediaEditValuesFromParams as ct, mediaRenderKey as cu, normalizeMediaCrop as cv, normalizeMediaCuts as cw, parseMediaCrop as cx, parseMediaCuts as cy, parseMediaEdits 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-Dm_BETxC.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, bk as TextLayer, b7 as ShapeLayer, aN as PathLayer } from './Doc-DmElSKmg.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-EF353KGH.js → chunk-2PGC4JDT.js}

@@ -1,7 +1,7 @@
 import {
   flattenRenderableBlocks,
   getBlockBodyText
-} from "./chunk-3YNFMFNK.js";
+} from "./chunk-QOVINAB2.js";
 import {
   estimateSpokenWordCount
 } from "./chunk-GHOPHGOK.js";

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

@@ -1,6 +1,6 @@
 import {
   defaultPageStyle
-} from "./chunk-GAZKTT4R.js";
+} from "./chunk-YNO6JV36.js";
 import {
   FONT_FALLBACKS,
   THEME_SCHEMA_VERSION,
@@ -15,7 +15,7 @@ import {
   relativeLuminance,
   resolveFontFamily,
   withAlpha
-} from "./chunk-Y4D6TDZT.js";
+} from "./chunk-PCCQLD3G.js";
 
 // src/schemas/Doc.ts
 function calculateDuration(audio) {

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

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

package/dist/{chunk-VU4T74LI.js → chunk-DTM4FG7S.js}

@@ -2,7 +2,7 @@ import {
   DEFAULT_THEME,
   applySurface,
   resolveFontFamily
-} from "./chunk-Y4D6TDZT.js";
+} from "./chunk-PCCQLD3G.js";
 
 // src/jsonForm/chooseControl.ts
 var ENUM_SEGMENTED_LIMIT = 4;

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-L7QZORLB.js

@@ -0,0 +1,230 @@
+// src/mediaEdit/recipe.ts
+var MEDIA_FX_ORDER = ["highpass", "denoise", "debreath", "loudness"];
+var MEDIA_FX_SPECS = Object.freeze({
+  highpass: { defaultValue: 80, min: 20, max: 300 },
+  denoise: { defaultValue: 0.8, min: 0, max: 1 },
+  debreath: { defaultValue: -15, min: -40, max: 0 },
+  loudness: { defaultValue: -16, min: -31, max: -5 }
+});
+var MEDIA_EDIT_PARAMS = [
+  { key: "fx", htmlSuffix: "fx" },
+  { key: "cuts", htmlSuffix: "cuts" },
+  { key: "gain", htmlSuffix: "gain" },
+  { key: "fadeIn", htmlSuffix: "fade-in" },
+  { key: "fadeOut", htmlSuffix: "fade-out" },
+  { key: "crop", htmlSuffix: "crop" },
+  { key: "group", htmlSuffix: "group" }
+];
+function mediaEditHtmlAttribute(kind, key) {
+  const param = MEDIA_EDIT_PARAMS.find((p) => p.key === key);
+  return `data-squisq-${kind}-${param?.htmlSuffix ?? key}`;
+}
+function formatMediaNumber(value, digits = 3) {
+  const rounded = Number(value.toFixed(digits));
+  return Object.is(rounded, -0) ? "0" : String(rounded);
+}
+function finiteNumber(raw) {
+  if (raw == null) return null;
+  const trimmed = raw.trim();
+  if (!/^[-+]?(\d+(\.\d*)?|\.\d+)$/.test(trimmed)) return null;
+  const n = Number(trimmed);
+  return Number.isFinite(n) ? n : null;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function parseSeconds(raw) {
+  const trimmed = raw.trim();
+  const bare = finiteNumber(trimmed);
+  if (bare != null) return bare >= 0 ? bare : null;
+  const ms = trimmed.match(/^(\d+(?:\.\d+)?)ms$/i);
+  if (ms) return Number(ms[1]) / 1e3;
+  const mmss = trimmed.match(/^(\d+):([0-5]?\d)(?:\.(\d+))?$/);
+  if (mmss) return Number(mmss[1]) * 60 + Number(mmss[2]) + Number(`0.${mmss[3] ?? "0"}`);
+  return null;
+}
+function isFxOpId(name) {
+  return MEDIA_FX_ORDER.includes(name);
+}
+function parseMediaFx(raw) {
+  if (raw == null) return null;
+  const tokens = raw.split(/[\s,]+/).filter(Boolean);
+  if (tokens.length === 0) return null;
+  const byId = /* @__PURE__ */ new Map();
+  const unknown = [];
+  for (const token of tokens) {
+    const colon = token.indexOf(":");
+    const name = (colon === -1 ? token : token.slice(0, colon)).toLowerCase();
+    if (!isFxOpId(name)) {
+      unknown.push(token);
+      continue;
+    }
+    const spec = MEDIA_FX_SPECS[name];
+    let value = spec.defaultValue;
+    if (colon !== -1) {
+      value = finiteNumber(token.slice(colon + 1));
+      if (value != null && name === "debreath") value = -Math.abs(value);
+    }
+    if (value == null) {
+      unknown.push(token);
+      continue;
+    }
+    byId.set(name, clamp(value, spec.min, spec.max));
+  }
+  const ops = MEDIA_FX_ORDER.filter((id) => byId.has(id)).map((id) => ({
+    id,
+    value: byId.get(id)
+  }));
+  return { ops, unknown };
+}
+function serializeMediaFx(chain) {
+  return [
+    ...chain.ops.map((op) => `${op.id}:${formatMediaNumber(op.value)}`),
+    ...chain.unknown
+  ].join(" ");
+}
+function hasRenderableFx(chain) {
+  return chain != null && chain.ops.length > 0;
+}
+var CUT_EPSILON = 1e-3;
+function normalizeMediaCuts(cuts, windowStart = 0, windowEnd = Number.POSITIVE_INFINITY) {
+  const clamped = cuts.filter((c) => Number.isFinite(c.start) && Number.isFinite(c.end)).map((c) => ({
+    start: Math.max(windowStart, Math.min(c.start, c.end)),
+    end: Math.min(windowEnd, Math.max(c.start, c.end))
+  })).filter((c) => c.end - c.start >= CUT_EPSILON).sort((a, b) => a.start - b.start);
+  const merged = [];
+  for (const cut of clamped) {
+    const last = merged[merged.length - 1];
+    if (last && cut.start <= last.end + CUT_EPSILON) {
+      last.end = Math.max(last.end, cut.end);
+    } else {
+      merged.push({ ...cut });
+    }
+  }
+  return merged;
+}
+function parseMediaCuts(raw) {
+  if (raw == null) return null;
+  const cuts = [];
+  for (const token of raw.split(/[\s,]+/).filter(Boolean)) {
+    const dash = token.indexOf("-", 1);
+    if (dash === -1) continue;
+    const start = parseSeconds(token.slice(0, dash));
+    const end = parseSeconds(token.slice(dash + 1));
+    if (start == null || end == null || end <= start) continue;
+    cuts.push({ start, end });
+  }
+  const normalized = normalizeMediaCuts(cuts);
+  return normalized.length > 0 ? normalized : null;
+}
+function serializeMediaCuts(cuts) {
+  return normalizeMediaCuts(cuts).map((c) => `${formatMediaNumber(c.start)}-${formatMediaNumber(c.end)}`).join(" ");
+}
+var MIN_CROP_EDGE = 0.02;
+function parseMediaCrop(raw) {
+  if (raw == null) return null;
+  const parts = raw.split(/[\s,]+/).filter(Boolean).map((p) => finiteNumber(p));
+  if (parts.length !== 4 || parts.some((p) => p == null)) return null;
+  return normalizeMediaCrop({
+    x: parts[0],
+    y: parts[1],
+    w: parts[2],
+    h: parts[3]
+  });
+}
+function normalizeMediaCrop(crop) {
+  const x = clamp(crop.x, 0, 1 - MIN_CROP_EDGE);
+  const y = clamp(crop.y, 0, 1 - MIN_CROP_EDGE);
+  const w = clamp(crop.w, MIN_CROP_EDGE, 1 - x);
+  const h = clamp(crop.h, MIN_CROP_EDGE, 1 - y);
+  const full = x < 1e-4 && y < 1e-4 && w > 1 - 1e-4 && h > 1 - 1e-4;
+  return full ? null : { x, y, w, h };
+}
+function serializeMediaCrop(crop) {
+  return [crop.x, crop.y, crop.w, crop.h].map((n) => formatMediaNumber(n, 4)).join(" ");
+}
+var GAIN_RANGE = { min: -60, max: 24 };
+var GROUP_RE = /^[A-Za-z0-9_-]{1,64}$/;
+function parseMediaEdits(values) {
+  const edits = {};
+  const fx = parseMediaFx(values.fx);
+  if (fx && (fx.ops.length > 0 || fx.unknown.length > 0)) edits.fx = fx;
+  const cuts = parseMediaCuts(values.cuts);
+  if (cuts) edits.cuts = cuts;
+  const gain = finiteNumber(values.gain);
+  if (gain != null && gain !== 0) edits.gain = clamp(gain, GAIN_RANGE.min, GAIN_RANGE.max);
+  const fadeIn = values.fadeIn == null ? null : parseSeconds(values.fadeIn);
+  if (fadeIn != null && fadeIn > 0) edits.fadeIn = fadeIn;
+  const fadeOut = values.fadeOut == null ? null : parseSeconds(values.fadeOut);
+  if (fadeOut != null && fadeOut > 0) edits.fadeOut = fadeOut;
+  const crop = parseMediaCrop(values.crop);
+  if (crop) edits.crop = crop;
+  const group = values.group?.trim();
+  if (group && GROUP_RE.test(group)) edits.group = group;
+  return Object.keys(edits).length > 0 ? edits : void 0;
+}
+function serializeMediaEdits(edits) {
+  const fx = edits?.fx && (edits.fx.ops.length > 0 || edits.fx.unknown.length > 0);
+  return {
+    fx: fx && edits?.fx ? serializeMediaFx(edits.fx) : null,
+    cuts: edits?.cuts && edits.cuts.length > 0 ? serializeMediaCuts(edits.cuts) : null,
+    gain: edits?.gain ? formatMediaNumber(edits.gain, 2) : null,
+    fadeIn: edits?.fadeIn ? formatMediaNumber(edits.fadeIn) : null,
+    fadeOut: edits?.fadeOut ? formatMediaNumber(edits.fadeOut) : null,
+    crop: edits?.crop ? serializeMediaCrop(edits.crop) : null,
+    group: edits?.group ?? null
+  };
+}
+function mediaEditValuesFromParams(params) {
+  const out = {};
+  for (const { key } of MEDIA_EDIT_PARAMS) {
+    if (params[key] != null) out[key] = params[key];
+  }
+  return out;
+}
+function mediaEditValuesFromAttributes(kind, attributes) {
+  const out = {};
+  for (const { key } of MEDIA_EDIT_PARAMS) {
+    const value = attributes[mediaEditHtmlAttribute(kind, key)];
+    if (value != null) out[key] = value;
+  }
+  return out;
+}
+function fnv1a64Hex(text) {
+  let h1 = 2166136261;
+  let h2 = 16777619 ^ 1540483477;
+  for (let i = 0; i < text.length; i++) {
+    const c = text.charCodeAt(i);
+    h1 = Math.imul(h1 ^ c, 16777619);
+    h2 = Math.imul(h2 ^ c, 1540483477);
+    h2 ^= h2 >>> 15;
+  }
+  return (h1 >>> 0).toString(16).padStart(8, "0") + (h2 >>> 0).toString(16).padStart(8, "0");
+}
+function mediaRenderKey(src, fx) {
+  const canonical = fx.ops.map((op) => `${op.id}:${formatMediaNumber(op.value)}`).join(" ");
+  return fnv1a64Hex(`${src}
+${canonical}`).slice(0, 12);
+}
+
+export {
+  MEDIA_FX_ORDER,
+  MEDIA_FX_SPECS,
+  MEDIA_EDIT_PARAMS,
+  mediaEditHtmlAttribute,
+  formatMediaNumber,
+  parseMediaFx,
+  serializeMediaFx,
+  hasRenderableFx,
+  normalizeMediaCuts,
+  parseMediaCuts,
+  serializeMediaCuts,
+  parseMediaCrop,
+  normalizeMediaCrop,
+  serializeMediaCrop,
+  parseMediaEdits,
+  serializeMediaEdits,
+  mediaEditValuesFromParams,
+  mediaEditValuesFromAttributes,
+  mediaRenderKey
+};