vizmatic 0.8.0 → 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/PROMPT.md +10 -9
  2. package/README.md +167 -61
  3. package/ROADMAP.md +5 -4
  4. package/SCIENCE.md +1 -2
  5. package/assets/THIRD_PARTY_LICENSES.md +3 -3
  6. package/assets/fonts/SourceSerif4-24pt-SemiBold.ttf +0 -0
  7. package/assets/licenses/raster-codecs-MIT.txt +2 -2
  8. package/dist/{chunk-ZB3HK7RM.js → chunk-4MXGLMBG.js} +274 -24
  9. package/dist/chunk-GGFDBJ25.js +88 -0
  10. package/dist/{chunk-USDVNKO7.js → chunk-I745F4QK.js} +2323 -357
  11. package/dist/{chunk-DZHX76RS.js → chunk-JZPMGVBP.js} +32 -3
  12. package/dist/cli.js +443 -104
  13. package/dist/index.cjs +1055 -98
  14. package/dist/index.d.cts +216 -4
  15. package/dist/index.d.ts +216 -4
  16. package/dist/index.js +734 -63
  17. package/dist/scene-browser-chunks/chunk-RQNLYYJN.js +70 -0
  18. package/dist/scene-browser-chunks/{scene-browser-layout-M3XSXMV4.js → scene-browser-layout-RC3ECYRK.js} +1 -1
  19. package/dist/scene-browser.js +16 -16
  20. package/dist/scene-cli.js +1 -1
  21. package/dist/scene-runtime.cjs +24 -3
  22. package/dist/scene-runtime.js +1 -1
  23. package/dist/{server-2FYHZ4UO.js → server-Q4COUZHV.js} +3 -3
  24. package/dist/stage-browser/browser.d.ts +8240 -315
  25. package/dist/stage-browser/stage.js +22 -5
  26. package/dist/stage-export.cjs +3640 -298
  27. package/dist/stage-export.d.cts +56 -3
  28. package/dist/stage-export.d.ts +56 -3
  29. package/dist/stage-export.js +677 -149
  30. package/dist/stage.cjs +33026 -7554
  31. package/dist/stage.d.cts +7809 -286
  32. package/dist/stage.d.ts +7809 -286
  33. package/dist/stage.js +26066 -2599
  34. package/dist/{svg-import-C-RG1t7s.d.cts → svg-import-B5BGbC1t.d.cts} +455 -53
  35. package/dist/{svg-import-C-RG1t7s.d.ts → svg-import-B5BGbC1t.d.ts} +455 -53
  36. package/dist/{video-BSwNJZkn.d.ts → video-CiN1MDCS.d.cts} +27 -2
  37. package/dist/{video-BSwNJZkn.d.cts → video-CiN1MDCS.d.ts} +27 -2
  38. package/examples/README.md +1 -1
  39. package/examples/_teaching/layer-stack-connector.ts +36 -0
  40. package/examples/_teaching/layer-stack-recurrence.ts +29 -0
  41. package/examples/_teaching/layer-stack-tiny-gpt.ts +37 -0
  42. package/examples/_teaching/layer-stack-transformer.ts +44 -0
  43. package/examples/catalog-convolution-kernel.tsx +6 -7
  44. package/examples/{aurora-incident.tsx → checkout-incident.tsx} +1 -1
  45. package/examples/films/beam-search.ts +52 -0
  46. package/examples/films/cache-miss.ts +4 -3
  47. package/examples/films/catalog.json +30 -0
  48. package/examples/films/forecast.ts +354 -0
  49. package/examples/films/passage/chunking.ts +40 -0
  50. package/examples/films/passage/evidence.ts +44 -0
  51. package/examples/films/passage/prompt.ts +34 -0
  52. package/examples/films/paxos.ts +596 -0
  53. package/examples/films/taylor-series.ts +1 -1
  54. package/examples/narrated-cues/README.md +32 -0
  55. package/examples/narrated-cues/data/numbers.json +1 -0
  56. package/examples/narrated-cues/film.json +9 -0
  57. package/examples/narrated-cues/film.ts +78 -0
  58. package/examples/narrated-cues/package.json +1 -0
  59. package/examples/narrated-cues/script.json +57 -0
  60. package/examples/narrated-cues/timing.json +1 -0
  61. package/examples/narrated-cues/tsconfig.json +1 -0
  62. package/examples/proofs/decoding-bars.ts +67 -0
  63. package/examples/proofs/pipeline.ts +27 -0
  64. package/examples/proofs/table/evaluation.ts +41 -0
  65. package/examples/proofs/table/ledger.ts +47 -0
  66. package/examples/proofs/table/routing.ts +46 -0
  67. package/package.json +9 -4
  68. package/templates/narrated/README.md +61 -0
  69. package/templates/narrated/data/numbers.json +5 -0
  70. package/templates/narrated/film.json +12 -0
  71. package/templates/narrated/film.ts +14 -0
  72. package/templates/narrated/gitignore +8 -0
  73. package/templates/narrated/package.json +1 -0
  74. package/templates/narrated/scenes/answer.ts +25 -0
  75. package/templates/narrated/scenes/kit.ts +39 -0
  76. package/templates/narrated/scenes/question.ts +31 -0
  77. package/templates/narrated/script.json +26 -0
  78. package/templates/narrated/sources.md +22 -0
  79. package/templates/narrated/timing.json +1 -0
  80. package/templates/narrated/tsconfig.json +1 -0
  81. package/tools/narration/README.md +123 -0
  82. package/tools/narration/beats.py +43 -0
  83. package/tools/narration/checks.py +587 -0
  84. package/tools/narration/draft.py +73 -0
  85. package/tools/narration/film.py +341 -0
  86. package/tools/narration/lag.py +58 -0
  87. package/tools/narration/mix.py +265 -0
  88. package/tools/narration/probe.py +99 -0
  89. package/tools/narration/record.py +33 -0
  90. package/tools/narration/resound.py +170 -0
  91. package/tools/narration/soundbed.py +404 -0
  92. package/tools/narration/sync.py +93 -0
  93. package/tools/narration/transcribe.py +84 -0
  94. package/tools/narration/verify.py +59 -0
  95. package/tools/narration/voice.py +113 -0
  96. package/dist/chunk-6N6P2GJG.js +0 -88
  97. package/dist/scene-browser-chunks/chunk-5MVLYGXM.js +0 -70
package/dist/index.d.cts CHANGED
@@ -1,5 +1,5 @@
1
- import { T as ThemeColors, a as ToneName, D as Density, t as typography, b as ThemeMode, C as ColorName, W as WatermarkInput, R as RenderBackground, c as DefinedAnimation } from './video-BSwNJZkn.cjs';
2
- export { A as AnimationCadenceAnalysis, d as AnimationDefinition, e as AnimationEasing, f as AnimationEasingName, g as AnimationFrameContext, h as AnimationHoldStep, i as AnimationInterpolator, j as AnimationKeyframeStep, k as AnimationParallelStep, l as AnimationParallelTracks, m as AnimationPropertyStep, n as AnimationTimelineStep, o as AnimationTweenStep, p as AnimationVideoOptions, q as DEFAULT_DENSITY, r as DENSITY_NAMES, s as DensityName, u as DensityRadiusScale, v as DensitySpaceScale, w as DensityStrokeScale, x as DensityTokens, y as DensityTypeScale, z as RgbaVideoFrameRenderer, B as RgbaVideoOptions, E as RgbaVideoOutput, S as SampleAnimationOptions, F as SampledAnimationFrame, G as ThemeOptions, H as ThemePreset, I as TypographyVariant, V as VideoCodec, J as VideoFrameInfo, K as Watermark, L as WatermarkElementProps, M as WatermarkImageOptions, N as WatermarkOptions, O as WatermarkPosition, P as analyzeAnimationCadence, Q as assertDensity, U as canvas, X as captionsToSrt, Y as chapterMetadata, Z as colors, _ as compositeColor, $ as defineAnimation, a0 as densityOf, a1 as densityTokens, a2 as getColor, a3 as getGradient, a4 as getReadableColor, a5 as getReadableTextColor, a6 as getReadableToneColor, a7 as getStyles, a8 as getThemeColors, a9 as getToneColor, aa as getToneFill, ab as getToneGradient, ac as gradients, ad as hasShadow, ae as heatColor, af as hold, ag as keyframe, ah as normalizeWatermark, ai as parallel, aj as parseDensity, ak as renderAnimationVideo, al as renderRgbaVideo, am as sampleAnimation, an as sampleAnimationFrame, ao as sampleAnimationFrames, ap as setDefaultDensity, aq as setDensityResolver, ar as styles, as as toneGradients, at as tween, au as typeOf, av as videoFrameSchedule, aw as withColorAlpha, ax as withDensity, ay as wrapWithBrand, az as wrapWithWatermark } from './video-BSwNJZkn.cjs';
1
+ import { T as ThemeColors, a as ToneName, D as Density, t as typography, b as ThemeMode, C as ColorName, W as WatermarkInput, R as RenderBackground, c as DefinedAnimation } from './video-CiN1MDCS.cjs';
2
+ export { A as AnimationCadenceAnalysis, d as AnimationDefinition, e as AnimationEasing, f as AnimationEasingName, g as AnimationFrameContext, h as AnimationHoldStep, i as AnimationInterpolator, j as AnimationKeyframeStep, k as AnimationParallelStep, l as AnimationParallelTracks, m as AnimationPropertyStep, n as AnimationTimelineStep, o as AnimationTweenStep, p as AnimationVideoOptions, q as DEFAULT_DENSITY, r as DENSITY_NAMES, s as DensityName, u as DensityRadiusScale, v as DensitySpaceScale, w as DensityStrokeScale, x as DensityTokens, y as DensityTypeScale, H as H264Encoder, z as RgbaVideoFrameRenderer, B as RgbaVideoOptions, E as RgbaVideoOutput, S as SampleAnimationOptions, F as SampledAnimationFrame, G as ThemeOptions, I as ThemePreset, J as TypographyVariant, V as VideoCodec, K as VideoFrameInfo, L as Watermark, M as WatermarkElementProps, N as WatermarkImageOptions, O as WatermarkOptions, P as WatermarkPosition, Q as analyzeAnimationCadence, U as assertDensity, X as canvas, Y as captionsToSrt, Z as chapterMetadata, _ as colors, $ as compositeColor, a0 as defineAnimation, a1 as densityOf, a2 as densityTokens, a3 as getColor, a4 as getGradient, a5 as getReadableColor, a6 as getReadableTextColor, a7 as getReadableToneColor, a8 as getStyles, a9 as getThemeColors, aa as getToneColor, ab as getToneFill, ac as getToneGradient, ad as gradients, ae as hasShadow, af as heatColor, ag as hold, ah as keyframe, ai as normalizeWatermark, aj as parallel, ak as parseDensity, al as renderAnimationVideo, am as renderRgbaVideo, an as resolveH264Encoder, ao as sampleAnimation, ap as sampleAnimationFrame, aq as sampleAnimationFrames, ar as setDefaultDensity, as as setDensityResolver, at as styles, au as toneGradients, av as tween, aw as typeOf, ax as videoFrameSchedule, ay as withColorAlpha, az as withDensity, aA as wrapWithBrand, aB as wrapWithWatermark } from './video-CiN1MDCS.cjs';
3
3
  import React, { ReactNode } from 'react';
4
4
  import { SceneFrameRequest, SceneRequest } from './scene-runtime.cjs';
5
5
  export { EvaluatedSceneFrame, PreparedScene, SCENE_LIMITS, SCENE_RUNTIME_VERSION, evaluateSceneSource, prepareScene } from './scene-runtime.cjs';
@@ -2194,6 +2194,15 @@ declare function dotProduct(left: readonly number[], right: readonly number[]):
2194
2194
  declare function multiplyMatrices(left: readonly (readonly number[])[], right: readonly (readonly number[])[]): number[][];
2195
2195
  /** Subtract the largest logit before exponentiation, including at small temperatures. */
2196
2196
  declare function stableSoftmax(values: readonly number[], temperature?: number): number[];
2197
+ interface SoftmaxMass {
2198
+ reference: number;
2199
+ mass: number;
2200
+ weightedSum: number;
2201
+ }
2202
+ /** Combine scalar tile summaries at their largest reference, or at a supplied higher reference. */
2203
+ declare function combineSoftmaxMass(tiles: readonly SoftmaxMass[], reference?: number): SoftmaxMass;
2204
+ /** Summarize finite scores and scalar values. A false mask entry excludes the pair. */
2205
+ declare function softmaxTileMass(scores: readonly number[], values: readonly number[], allowed?: readonly boolean[]): SoftmaxMass;
2197
2206
  /** Shannon entropy of a normalized probability distribution. Zero terms contribute zero. */
2198
2207
  declare function entropy(probabilities: readonly number[], base?: number): number;
2199
2208
  /** Unit-length vector; the zero vector stays zero. Scaling avoids intermediate overflow. */
@@ -2247,6 +2256,14 @@ interface CrossCorrelateOptions {
2247
2256
  stride?: number;
2248
2257
  padding?: KernelPadding;
2249
2258
  }
2259
+ interface CrossCorrelationTerm {
2260
+ inputRow: number;
2261
+ inputColumn: number;
2262
+ inputValue: number;
2263
+ weight: number;
2264
+ product: number;
2265
+ padded: boolean;
2266
+ }
2250
2267
  /**
2251
2268
  * Slide a kernel over an image and sum elementwise products without flipping
2252
2269
  * the kernel. This is cross-correlation, the operation commonly called
@@ -2255,6 +2272,17 @@ interface CrossCorrelateOptions {
2255
2272
  * bottom or right.
2256
2273
  */
2257
2274
  declare function crossCorrelate2d(input: NumericImage, kernel: NumericImage, options?: CrossCorrelateOptions): number[][];
2275
+ /**
2276
+ * Explain one zero-based output cell of crossCorrelate2d. Each terms[r][c]
2277
+ * describes kernel[r][c] and its aligned input coordinate. A tap outside the
2278
+ * image keeps that coordinate and has padded = true, inputValue = 0 and product = 0.
2279
+ */
2280
+ declare function traceCrossCorrelation2d(input: NumericImage, kernel: NumericImage, outputRow: number, outputColumn: number, options?: CrossCorrelateOptions): {
2281
+ outputRow: number;
2282
+ outputColumn: number;
2283
+ terms: CrossCorrelationTerm[][];
2284
+ sum: number;
2285
+ };
2258
2286
  /** Return a normalized, sampled square Gaussian kernel with odd dimensions. */
2259
2287
  declare function gaussianKernel(size: number, sigma: number): number[][];
2260
2288
 
@@ -2956,6 +2984,51 @@ interface TeachingGridOptions extends CellGridOptions {
2956
2984
  /** Shared cell geometry for dense diagrams, without creating one panel per cell. */
2957
2985
  declare function layoutCellGrid(options: CellGridOptions): CellGridLayout;
2958
2986
 
2987
+ /** The top-left address of a tile in a grid. */
2988
+ interface GridTileEndpoint {
2989
+ grid: CellGridLayout;
2990
+ row?: number;
2991
+ column?: number;
2992
+ }
2993
+ interface TeachingTileCell {
2994
+ label?: string | number;
2995
+ fill?: string;
2996
+ stroke?: string;
2997
+ textColor?: string;
2998
+ }
2999
+ interface TeachingTileTransferOptions {
3000
+ source: GridTileEndpoint;
3001
+ target: GridTileEndpoint;
3002
+ cells: readonly (readonly TeachingTileCell[])[];
3003
+ progress: number;
3004
+ /** Fraction of the transfer between the launches of the first and last rows. */
3005
+ rowStagger?: number;
3006
+ gap?: number;
3007
+ fontSize?: number;
3008
+ fill?: string;
3009
+ stroke?: string;
3010
+ textColor?: string;
3011
+ }
3012
+ /** Paint each cell at its position between corresponding addresses in two grids. */
3013
+ declare function createTeachingTileTransfer<Shape extends CanvasBounds>(painter: CanvasPainter<Shape>): (options: TeachingTileTransferOptions) => {
3014
+ cells: Shape[][];
3015
+ arrived: number;
3016
+ complete: boolean;
3017
+ };
3018
+
3019
+ interface TeachingRasterWipeOptions<Value> extends CanvasBounds {
3020
+ rows: number;
3021
+ columns: number;
3022
+ /** Row-major samples on the leading and trailing sides of the divider. */
3023
+ left: ArrayLike<Value>;
3024
+ right: ArrayLike<Value>;
3025
+ /** Fraction of the image occupied by the left raster. */
3026
+ split: number;
3027
+ /** Assign each output pixel to the sample under its center. Use final pixel coordinates. */
3028
+ snapToPixels?: boolean;
3029
+ color(value: Value, row: number, column: number): string;
3030
+ }
3031
+
2959
3032
  interface TeachingRoutedEndpoint<Shape extends CanvasBounds = CanvasBounds> {
2960
3033
  id: string;
2961
3034
  shape: Shape;
@@ -3024,6 +3097,34 @@ interface TeachingTransferOptions extends TeachingConnectionOptions {
3024
3097
  };
3025
3098
  }
3026
3099
 
3100
+ interface PcmEnvelope {
3101
+ sampleRate: number;
3102
+ startTime: number;
3103
+ bins: readonly {
3104
+ startSample: number;
3105
+ endSample: number;
3106
+ min: number;
3107
+ max: number;
3108
+ }[];
3109
+ }
3110
+ /** Group consecutive mono PCM samples and retain both signed extremes. */
3111
+ declare function pcmEnvelope(samples: ArrayLike<number>, options: {
3112
+ sampleRate: number;
3113
+ bins: number;
3114
+ startTime?: number;
3115
+ }): PcmEnvelope;
3116
+ interface TeachingWaveformOptions extends CanvasBounds {
3117
+ envelope: PcmEnvelope;
3118
+ domain: readonly [number, number];
3119
+ color?: string;
3120
+ cursorTime?: number;
3121
+ reveal?: boolean;
3122
+ cursorColor?: string;
3123
+ }
3124
+ declare function createTeachingWaveform<Shape extends CanvasBounds>(painter: TeachingPainter<Shape>): ({ x, y, width, height, envelope, domain, color, cursorTime, reveal, cursorColor }: TeachingWaveformOptions) => {
3125
+ cursorX: number | null;
3126
+ };
3127
+
3027
3128
  interface ValueChangeOptions {
3028
3129
  from: number;
3029
3130
  to: number;
@@ -3218,11 +3319,22 @@ declare function createTeachingCanvas<Shape extends CanvasBounds>(painter: Teach
3218
3319
  nodes: Record<string, Shape>;
3219
3320
  routes: TeachingRoute[];
3220
3321
  };
3322
+ waveform: ({ x, y, width, height, envelope, domain, color, cursorTime, reveal, cursorColor }: TeachingWaveformOptions) => {
3323
+ cursorX: number | null;
3324
+ };
3221
3325
  transfer: (options: TeachingTransferOptions) => TeachingRoute | null;
3222
3326
  routedTransfer: (options: TeachingRoutedTransferOptions<Shape>) => TeachingRoutedTransfer<Shape> | null;
3223
3327
  grid: (options: TeachingGridOptions) => CellGridLayout & {
3224
3328
  shape: Shape;
3225
3329
  };
3330
+ rasterWipe: <Value>(options: TeachingRasterWipeOptions<Value>) => {
3331
+ dividerX: number;
3332
+ };
3333
+ tileTransfer: (options: TeachingTileTransferOptions) => {
3334
+ cells: Shape[][];
3335
+ arrived: number;
3336
+ complete: boolean;
3337
+ };
3226
3338
  timeline: (options: TeachingTimelineOptions) => TeachingTimelineResult<Shape>;
3227
3339
  allocation: (options: TeachingAllocationOptions) => AllocationLayout & {
3228
3340
  shapes: (Shape | null)[];
@@ -3303,6 +3415,38 @@ interface CueTrackOptions<Snapshot> {
3303
3415
  declare function createCueTrack<Snapshot>(options: CueTrackOptions<Snapshot>): Readonly<{
3304
3416
  sample(current: CuePosition): Readonly<CueSnapshot<Snapshot>>;
3305
3417
  }>;
3418
+ interface CueRevealOptions {
3419
+ result: string;
3420
+ phrase: string;
3421
+ /** First frame to inspect while the viewer can still predict the result. */
3422
+ fromFrame: number;
3423
+ /** First frame allowed to show the result, resolved from the phrase by the host clock. */
3424
+ cueFrame: number;
3425
+ /** Last frame allowed for the result to appear. Defaults to cueFrame for a cut. */
3426
+ byFrame?: number;
3427
+ /** Observe the named result in this frame. Throw if the evidence is inconclusive. */
3428
+ visibleAt: (frame: number) => boolean;
3429
+ }
3430
+ /** Check one prediction and return the two frames on either side of its observed reveal. */
3431
+ declare function assertCueReveal({ result, phrase, fromFrame, cueFrame, byFrame, visibleAt }: CueRevealOptions): {
3432
+ lastHiddenFrame: number;
3433
+ firstVisibleFrame: number;
3434
+ };
3435
+
3436
+ interface RegionChangeOptions {
3437
+ /** Dimensions of both packed RGBA frames, in pixels. */
3438
+ width: number;
3439
+ height: number;
3440
+ /** Rectangle in decoded frame coordinates, measured from the top left. */
3441
+ region: CropRegion;
3442
+ /** Ignore differences up to this many levels in each 8-bit channel. Defaults to 12. */
3443
+ tolerance?: number;
3444
+ }
3445
+ /** Count changed pixels in the chosen region and locate their bounds in the frame. */
3446
+ declare function measureRegionChange(reference: Uint8Array | Uint8ClampedArray, current: Uint8Array | Uint8ClampedArray, { width, height, region, tolerance }: RegionChangeOptions): {
3447
+ changedPixels: number;
3448
+ bounds: CropRegion | undefined;
3449
+ };
3306
3450
 
3307
3451
  interface TeachingFocusCue {
3308
3452
  id: string;
@@ -3352,6 +3496,26 @@ declare function createTeachingFocus<Shape>(painter: TeachingFocusPainter<Shape>
3352
3496
  }) => void;
3353
3497
  };
3354
3498
 
3499
+ interface SampleSource extends CanvasPoint {
3500
+ id: string;
3501
+ }
3502
+ interface SampleDestination extends CanvasPoint {
3503
+ sourceId: string;
3504
+ }
3505
+ interface SampleCopy extends SampleDestination {
3506
+ /** Zero-based position in the supplied draw sequence. */
3507
+ drawIndex: number;
3508
+ /** How many times this source has appeared, including this draw. */
3509
+ occurrence: number;
3510
+ /** Fraction of the path from the fixed source to this destination. */
3511
+ progress: number;
3512
+ }
3513
+ /** Animate copies of named items along an explicit draw sequence. */
3514
+ declare function planSampleCopies(sources: readonly SampleSource[], destinations: readonly SampleDestination[]): {
3515
+ /** At 1.5 draws, the first copy is in its slot and the next is halfway there. */
3516
+ at(drawCount: number): SampleCopy[];
3517
+ };
3518
+
3355
3519
  /** Camera center in world coordinates and the scale applied to that world. */
3356
3520
  interface Camera2D {
3357
3521
  x: number;
@@ -3388,6 +3552,54 @@ declare function createPolylineMorph(from: readonly MotionPoint[], to: readonly
3388
3552
  /** Morph two polylines by matching points at equal fractions of their arc length. */
3389
3553
  declare function morphPolyline(from: readonly MotionPoint[], to: readonly MotionPoint[], progress: number, options?: PathMorphOptions): MotionPoint[];
3390
3554
 
3555
+ /**
3556
+ * Draw on an exclusively owned, fixed-size native context with a stable font registry.
3557
+ * The callback uses ordinary method and property access on its supplied context.
3558
+ * Native drawing, exceptions and queries always run. Untracked state disables reuse.
3559
+ * readPixels returns an owned snapshot after drawing. The returned pixels are borrowed
3560
+ * read-only until the next frame, as required by a serial video encoder.
3561
+ */
3562
+ declare function createCanvasReadback<C extends {
3563
+ reset(): void;
3564
+ }>(context: C, readPixels: () => Uint8Array): {
3565
+ frame(draw: (context: C) => void): Uint8Array;
3566
+ stats: () => {
3567
+ frames: number;
3568
+ reused: number;
3569
+ tracking: boolean;
3570
+ };
3571
+ };
3572
+
3573
+ /** A half-open range of displayed frames in a local AVC MP4. */
3574
+ interface AvcSpliceSegment {
3575
+ path: string;
3576
+ startFrame: number;
3577
+ endFrame: number;
3578
+ }
3579
+ interface AvcSplicePlan {
3580
+ /** UTF-8 ffconcat input for FFmpeg with -copyts, -safe 0 and -auto_convert 0. Map only 0:v:0. */
3581
+ concatScript: string;
3582
+ frameCount: number;
3583
+ }
3584
+ /** Plan and dry-run a picture-only FFmpeg stream copy across closed GOPs in compatible constant-rate AVC MP4s. */
3585
+ declare function planAvcSplice(segments: readonly AvcSpliceSegment[]): Promise<AvcSplicePlan>;
3586
+
3587
+ interface MediaExcerptOptions {
3588
+ /** Zero-based index of the first displayed frame. */
3589
+ startFrame: number;
3590
+ frameCount: number;
3591
+ /** Constant source frame rate in whole frames per second. */
3592
+ fps: number;
3593
+ /** Source audio sample rate in Hz. */
3594
+ sampleRate: number;
3595
+ }
3596
+ /** Build FFmpeg input options and filters for a half-open excerpt of a zero-origin CFR source. */
3597
+ declare function planMediaExcerpt({ startFrame, frameCount, fps, sampleRate }: MediaExcerptOptions): {
3598
+ inputArgs: string[];
3599
+ videoFilter: string;
3600
+ audioFilter: string;
3601
+ };
3602
+
3391
3603
  interface SceneRasterOptions {
3392
3604
  /** Physical pixels per logical scene pixel, from 0.25 to 1. Scaled dimensions must be even integers. */
3393
3605
  outputScale?: number;
@@ -3571,5 +3783,5 @@ interface CheckFrameReport {
3571
3783
  */
3572
3784
  declare function checkFrame(input: CheckFrameInput, options?: CheckOptions): Promise<CheckFrameReport>;
3573
3785
 
3574
- export { Arrow, ArrowMarkerDef, AttentionMatrix, AxisPlot, Badge, BadgePill, BarChart, Board, Box, CANVAS_ITEM_COMPONENT, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasItem, CanvasOverflowError, Card, ChartFrame, CodeBlock, ColorName, Column, Comparison, Connector, DashedLine, DataTable, DataflowDiagram, DefinedAnimation, Density, DeploymentDiagram, DetailList, DiagramLegend, DonutChart, DotPoint, ELEMENT_SYMBOLS, EntityRelationshipDiagram, EquationCard, FactRows, Flow, FlowArrow, FreeBodyDiagram, GeometryDiagram, GradientChip, GraphDiagram, Grid, Heatmap, Icon, InlineBar, IntervalPlot, KeyValueList, LayeredNetwork, Legend, LineChart, MathText, Matrix, MetricCard, MetricStrip, MiniBarChart, MoleculeDiagram, NumberLine, Panel, ParetoBarChart, ParetoChart, PieChart, Pipeline, PixelGrid, ProgressList, ProgressRow, QuadrantChart, ReactionEnergyDiagram, ReactionEquation, RenderBackground, Row, ScatterPlot, Scene, SceneFrameRequest, SceneRequest, SequenceDiagram, SmallMultiples, Sparkline, Stack, StackedBar, StatusDot, StatusList, StatusRow, StepCard, SvgFrame, SvgMathText, SvgPoint, TagList, TextLabel, ThemeColors, ThemeMode, Tile, TileGrid, TiledMatrix, Timeline, TitleBar, ToneName, ToneStrip, TransformerTopology, TreeDiagram, ValuePill, VectorArrow, VectorSegment, WatermarkInput, WaveDiagram, WindowFrame, arcSwap, assertTokenHistoryTransition, byteDifferenceState, cameraSvgTransform, categoricalSampling, checkFrame, compareByteSequences, createCanvasComponents, createCueTrack, createFocusDirector, createPlotArea, createPolylineMorph, createTeachingByteDifference, createTeachingCanvas, createTeachingCategoricalSampling, createTeachingFocus, createTeachingRoutedTransfer, createTeachingTokenHistory, createTeachingValueChange, createTeachingVectorAccumulation, cropPixels, cropRgbImage, cropRgbRaster, crossCorrelate2d, decodeRgbPng, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectLayoutOverflow, detectOverflow, dotProduct, encodeRgbPng, entropy, escapedByte, estimateTextWidth, flattenRgbImage, formatMathText, formatTensorShape, gaussian, gaussianBlurRgb, gaussianKernel, geometryBounds, getFonts, importD2Graph, importMermaidGraph, interpolateCamera, layoutAllocation, layoutByteDifference, layoutCellGrid, layoutTokenRow, lerpArray, loadAdditionalAsset, mapNumberLine, mergeFocusRegions, morphPolyline, multiplyMatrices, normalizeVector, planTeachingRoutedTransfer, pointAlongPath, projectWorldPoint, reactionBalance, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderMathSvg, renderSceneFrame, renderSceneVideo, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, rgbChannel, sampleFunction, sampleGaussian, sampleWave, scaledDotProductAttention, scopeDensity, seededRandom, smoothstep, stableSoftmax, statusColor, sumForces, tokenHistoryState, tracePolyline, transposeMatrix, typography, valueChangeState, waveValue, weightedVectorState };
3575
- export type { AllocationLayout, AllocationLayoutOptions, AllocationPart, AnimatedScene, AnimationOptions, AnimationOutput, AnimationOverflowContext, ArcSwapOptions, AttentionMatrixProps, AttentionOptions, AttentionResult, AxisPlotPath, AxisPlotPoint, AxisPlotVector, BarChartDatum, BoardProps, ByteDifference, ByteDifferenceColumn, ByteDifferenceKind, ByteDifferenceStateOptions, Camera2D, CameraMotionOptions, CameraViewport, CanvasBounds, CanvasCardOptions, CanvasCardStyle, CanvasItemProps, CanvasMatrixOptions, CanvasPainter, CanvasPanelOptions, CanvasPanelStyle, CanvasParticleOptions, CanvasPoint, CanvasScopeOptions, CanvasTokenRowOptions, CategoricalSamplingModel, CategoricalSamplingOptions, CellGridLayout, CellGridOptions, ChartLegendItem, ChartMargins, ChartValueFormat, CheckAutoSize, CheckAutoSizeAxes, CheckDiagnostic, CheckDiagnosticCode, CheckDiagnosticCounts, CheckDiagnosticLocation, CheckFailurePolicy, CheckFrameInput, CheckFrameReport, CheckOptions, CheckThemeReport, CodeLineSpec, ComparisonSideSpec, CropMode, CropRegion, CrossCorrelateOptions, CuePosition, CueSnapshot, CueTrackOptions, DataflowBoundary, DataflowDiagramProps, DataflowEdge, DataflowEdgeMode, DataflowNode, DataflowNodeKind, DataflowSchema, DataflowSchemaDefinition, DataflowSchemaField, DeploymentBoundary, DeploymentBoundaryKind, DeploymentConnection, DeploymentConnectionKind, DeploymentDiagramProps, DeploymentNode, DeploymentNodeKind, DeploymentPort, DeploymentPortDirection, DeploymentPortInput, DiagnosticSeverity, DiagramIconDefinition, DiagramIconRenderProps, DiagramLegendItem, DiagramStatus, DiscreteCue, DonutChartSegment, ElementComposition, ElementSymbol, EntityRelationship, EntityRelationshipAttribute, EntityRelationshipCardinality, EntityRelationshipDiagramProps, EntityRelationshipEndpoint, EntityRelationshipEntity, FactRow, FlowStageSpec, ForceResultant, ForceVector, FreeBodyDiagramProps, GaussianBlurRgbOptions, GeometryAngle, GeometryBounds, GeometryDiagramProps, GeometryPoint, GeometrySegment, GraphDiagramAnnotation, GraphDiagramEdge, GraphDiagramEdgeArrow, GraphDiagramEdgeKind, GraphDiagramEdgeStyle, GraphDiagramGroup, GraphDiagramNode, GraphDiagramPort, GraphDiagramProps, GraphImportDiagnostic, GraphImportDiagnosticCode, GraphImportDirection, GraphImportGraph, GraphImportResult, GraphImportSource, GraphPortSide, GraphRouting, GridCell, HistoryToken, IconName, IconProps, IllustrationBuilder, IntervalDatum, KernelPadding, KeyValueRow, LayeredNetworkLayer, LegendItem, LineChartSeries, MiniBarDatum, MoleculeAtom, MoleculeAtomId, MoleculeBond, MoleculeBondOrder, MoleculeDiagramProps, MotionEasing, MotionPoint, NumberLineInterval, NumberLineMarker, NumberLineProps, NumberLineTick, NumericImage, NumericMatrix, OverflowResult, ParetoBarChartProps, ParetoChartProps, ParetoObjective, ParetoXScale, PathMorphOptions, PieChartProps, PipelineStage, PixelGridProps, PixelRegion, PlotArea, ProgressRowSpec, QuadrantChartProps, QuadrantRegion, ReactionBalanceResult, ReactionEnergyDiagramProps, ReactionEquationProps, ReactionState, ReactionTerm, RenderMathSvgOptions, RenderMathSvgResult, RenderOptions, RenderOutput, RenderSceneFrameOptions, RenderSceneVideoOptions, RgbChannel, RgbPixel, RgbRaster, SamplingCategory, SatoriNode, ScatterPoint, SceneRenderOutput, SequenceActivation, SequenceDiagramProps, SequenceFragment, SequenceFragmentBranch, SequenceFragmentKind, SequenceItem, SequenceMessage, SequenceMessageKind, SequenceNote, SequenceParticipant, SequenceParticipantKind, SmallMultipleItem, StackedBarSegment, StatusKind, StatusRowSpec, StripMetric, SuppliedCategoricalDraw, TeachingAllocationOptions, TeachingAxesOptions, TeachingBarsOptions, TeachingBarsResult, TeachingByteDifferenceOptions, TeachingCategoricalSamplingOptions, TeachingChangeCueOptions, TeachingConnectionOptions, TeachingCurveOptions, TeachingFlowEdge, TeachingFlowGraphOptions, TeachingFlowNode, TeachingFocusCue, TeachingFocusPainter, TeachingGridHighlight, TeachingGridOptions, TeachingPainter, TeachingPathOptions, TeachingPlot, TeachingRoute, TeachingRouteObstacle, TeachingRoutedEndpoint, TeachingRoutedTransfer, TeachingRoutedTransferOptions, TeachingScatterOptions, TeachingScatterPoint, TeachingTimeInterval, TeachingTimeLane, TeachingTimelineInterval, TeachingTimelineOptions, TeachingTimelineResult, TeachingTokenHistoryOptions, TeachingTransferEndpoint, TeachingTransferOptions, TeachingValueChangeOptions, TeachingVectorAccumulationOptions, TeachingVectorProjection, TeachingVectorSegment, TensorDimension, TensorLayout, TensorShape, TensorShapeObject, TileSpec, TiledMatrixRegion, TimelineEventSpec, TokenHistoryLane, TokenHistoryOptions, TokenHistoryPhase, TokenHistorySnapshot, TokenHistoryState, TokenRowItem, TokenRowLayoutOptions, TransformerBlock, TransformerBlockKind, TransformerRoute, TransformerRouteKind, TransformerTopologyProps, TransitionType, TreeNodeSpec, ValueChangeOptions, ValueChangeState, Wave, WaveDiagramProps, WaveSample, WeightedVectorOptions, WeightedVectorState, WeightedVectorStatus, WeightedVectorTerm, WeightedVectorTermState };
3786
+ export { Arrow, ArrowMarkerDef, AttentionMatrix, AxisPlot, Badge, BadgePill, BarChart, Board, Box, CANVAS_ITEM_COMPONENT, CHECK_DIAGNOSTIC_CODES, CalloutCard, Canvas, CanvasItem, CanvasOverflowError, Card, ChartFrame, CodeBlock, ColorName, Column, Comparison, Connector, DashedLine, DataTable, DataflowDiagram, DefinedAnimation, Density, DeploymentDiagram, DetailList, DiagramLegend, DonutChart, DotPoint, ELEMENT_SYMBOLS, EntityRelationshipDiagram, EquationCard, FactRows, Flow, FlowArrow, FreeBodyDiagram, GeometryDiagram, GradientChip, GraphDiagram, Grid, Heatmap, Icon, InlineBar, IntervalPlot, KeyValueList, LayeredNetwork, Legend, LineChart, MathText, Matrix, MetricCard, MetricStrip, MiniBarChart, MoleculeDiagram, NumberLine, Panel, ParetoBarChart, ParetoChart, PieChart, Pipeline, PixelGrid, ProgressList, ProgressRow, QuadrantChart, ReactionEnergyDiagram, ReactionEquation, RenderBackground, Row, ScatterPlot, Scene, SceneFrameRequest, SceneRequest, SequenceDiagram, SmallMultiples, Sparkline, Stack, StackedBar, StatusDot, StatusList, StatusRow, StepCard, SvgFrame, SvgMathText, SvgPoint, TagList, TextLabel, ThemeColors, ThemeMode, Tile, TileGrid, TiledMatrix, Timeline, TitleBar, ToneName, ToneStrip, TransformerTopology, TreeDiagram, ValuePill, VectorArrow, VectorSegment, WatermarkInput, WaveDiagram, WindowFrame, arcSwap, assertCueReveal, assertTokenHistoryTransition, byteDifferenceState, cameraSvgTransform, categoricalSampling, checkFrame, combineSoftmaxMass, compareByteSequences, createCanvasComponents, createCanvasReadback, createCueTrack, createFocusDirector, createPlotArea, createPolylineMorph, createTeachingByteDifference, createTeachingCanvas, createTeachingCategoricalSampling, createTeachingFocus, createTeachingRoutedTransfer, createTeachingTileTransfer, createTeachingTokenHistory, createTeachingValueChange, createTeachingVectorAccumulation, createTeachingWaveform, cropPixels, cropRgbImage, cropRgbRaster, crossCorrelate2d, decodeRgbPng, defineDiagramIcon, defineIconRegistry, defineIllustration, detectBackgroundColor, detectContentBounds, detectLayoutOverflow, detectOverflow, dotProduct, encodeRgbPng, entropy, escapedByte, estimateTextWidth, flattenRgbImage, formatMathText, formatTensorShape, gaussian, gaussianBlurRgb, gaussianKernel, geometryBounds, getFonts, importD2Graph, importMermaidGraph, interpolateCamera, layoutAllocation, layoutByteDifference, layoutCellGrid, layoutTokenRow, lerpArray, loadAdditionalAsset, mapNumberLine, measureRegionChange, mergeFocusRegions, morphPolyline, multiplyMatrices, normalizeVector, pcmEnvelope, planAvcSplice, planMediaExcerpt, planSampleCopies, planTeachingRoutedTransfer, pointAlongPath, projectWorldPoint, reactionBalance, renderAnimatedGif, renderAnimatedGifWithOutput, renderAnimationGif, renderAnimationGifWithOutput, renderMathSvg, renderSceneFrame, renderSceneVideo, renderToBuffer, renderToPng, renderToPngWithOutput, renderToSvg, rgbChannel, sampleFunction, sampleGaussian, sampleWave, scaledDotProductAttention, scopeDensity, seededRandom, smoothstep, softmaxTileMass, stableSoftmax, statusColor, sumForces, tokenHistoryState, traceCrossCorrelation2d, tracePolyline, transposeMatrix, typography, valueChangeState, waveValue, weightedVectorState };
3787
+ export type { AllocationLayout, AllocationLayoutOptions, AllocationPart, AnimatedScene, AnimationOptions, AnimationOutput, AnimationOverflowContext, ArcSwapOptions, AttentionMatrixProps, AttentionOptions, AttentionResult, AvcSplicePlan, AvcSpliceSegment, AxisPlotPath, AxisPlotPoint, AxisPlotVector, BarChartDatum, BoardProps, ByteDifference, ByteDifferenceColumn, ByteDifferenceKind, ByteDifferenceStateOptions, Camera2D, CameraMotionOptions, CameraViewport, CanvasBounds, CanvasCardOptions, CanvasCardStyle, CanvasItemProps, CanvasMatrixOptions, CanvasPainter, CanvasPanelOptions, CanvasPanelStyle, CanvasParticleOptions, CanvasPoint, CanvasScopeOptions, CanvasTokenRowOptions, CategoricalSamplingModel, CategoricalSamplingOptions, CellGridLayout, CellGridOptions, ChartLegendItem, ChartMargins, ChartValueFormat, CheckAutoSize, CheckAutoSizeAxes, CheckDiagnostic, CheckDiagnosticCode, CheckDiagnosticCounts, CheckDiagnosticLocation, CheckFailurePolicy, CheckFrameInput, CheckFrameReport, CheckOptions, CheckThemeReport, CodeLineSpec, ComparisonSideSpec, CropMode, CropRegion, CrossCorrelateOptions, CrossCorrelationTerm, CuePosition, CueRevealOptions, CueSnapshot, CueTrackOptions, DataflowBoundary, DataflowDiagramProps, DataflowEdge, DataflowEdgeMode, DataflowNode, DataflowNodeKind, DataflowSchema, DataflowSchemaDefinition, DataflowSchemaField, DeploymentBoundary, DeploymentBoundaryKind, DeploymentConnection, DeploymentConnectionKind, DeploymentDiagramProps, DeploymentNode, DeploymentNodeKind, DeploymentPort, DeploymentPortDirection, DeploymentPortInput, DiagnosticSeverity, DiagramIconDefinition, DiagramIconRenderProps, DiagramLegendItem, DiagramStatus, DiscreteCue, DonutChartSegment, ElementComposition, ElementSymbol, EntityRelationship, EntityRelationshipAttribute, EntityRelationshipCardinality, EntityRelationshipDiagramProps, EntityRelationshipEndpoint, EntityRelationshipEntity, FactRow, FlowStageSpec, ForceResultant, ForceVector, FreeBodyDiagramProps, GaussianBlurRgbOptions, GeometryAngle, GeometryBounds, GeometryDiagramProps, GeometryPoint, GeometrySegment, GraphDiagramAnnotation, GraphDiagramEdge, GraphDiagramEdgeArrow, GraphDiagramEdgeKind, GraphDiagramEdgeStyle, GraphDiagramGroup, GraphDiagramNode, GraphDiagramPort, GraphDiagramProps, GraphImportDiagnostic, GraphImportDiagnosticCode, GraphImportDirection, GraphImportGraph, GraphImportResult, GraphImportSource, GraphPortSide, GraphRouting, GridCell, GridTileEndpoint, HistoryToken, IconName, IconProps, IllustrationBuilder, IntervalDatum, KernelPadding, KeyValueRow, LayeredNetworkLayer, LegendItem, LineChartSeries, MediaExcerptOptions, MiniBarDatum, MoleculeAtom, MoleculeAtomId, MoleculeBond, MoleculeBondOrder, MoleculeDiagramProps, MotionEasing, MotionPoint, NumberLineInterval, NumberLineMarker, NumberLineProps, NumberLineTick, NumericImage, NumericMatrix, OverflowResult, ParetoBarChartProps, ParetoChartProps, ParetoObjective, ParetoXScale, PathMorphOptions, PcmEnvelope, PieChartProps, PipelineStage, PixelGridProps, PixelRegion, PlotArea, ProgressRowSpec, QuadrantChartProps, QuadrantRegion, ReactionBalanceResult, ReactionEnergyDiagramProps, ReactionEquationProps, ReactionState, ReactionTerm, RegionChangeOptions, RenderMathSvgOptions, RenderMathSvgResult, RenderOptions, RenderOutput, RenderSceneFrameOptions, RenderSceneVideoOptions, RgbChannel, RgbPixel, RgbRaster, SampleCopy, SampleDestination, SampleSource, SamplingCategory, SatoriNode, ScatterPoint, SceneRenderOutput, SequenceActivation, SequenceDiagramProps, SequenceFragment, SequenceFragmentBranch, SequenceFragmentKind, SequenceItem, SequenceMessage, SequenceMessageKind, SequenceNote, SequenceParticipant, SequenceParticipantKind, SmallMultipleItem, SoftmaxMass, StackedBarSegment, StatusKind, StatusRowSpec, StripMetric, SuppliedCategoricalDraw, TeachingAllocationOptions, TeachingAxesOptions, TeachingBarsOptions, TeachingBarsResult, TeachingByteDifferenceOptions, TeachingCategoricalSamplingOptions, TeachingChangeCueOptions, TeachingConnectionOptions, TeachingCurveOptions, TeachingFlowEdge, TeachingFlowGraphOptions, TeachingFlowNode, TeachingFocusCue, TeachingFocusPainter, TeachingGridHighlight, TeachingGridOptions, TeachingPainter, TeachingPathOptions, TeachingPlot, TeachingRasterWipeOptions, TeachingRoute, TeachingRouteObstacle, TeachingRoutedEndpoint, TeachingRoutedTransfer, TeachingRoutedTransferOptions, TeachingScatterOptions, TeachingScatterPoint, TeachingTileCell, TeachingTileTransferOptions, TeachingTimeInterval, TeachingTimeLane, TeachingTimelineInterval, TeachingTimelineOptions, TeachingTimelineResult, TeachingTokenHistoryOptions, TeachingTransferEndpoint, TeachingTransferOptions, TeachingValueChangeOptions, TeachingVectorAccumulationOptions, TeachingVectorProjection, TeachingVectorSegment, TeachingWaveformOptions, TensorDimension, TensorLayout, TensorShape, TensorShapeObject, TileSpec, TiledMatrixRegion, TimelineEventSpec, TokenHistoryLane, TokenHistoryOptions, TokenHistoryPhase, TokenHistorySnapshot, TokenHistoryState, TokenRowItem, TokenRowLayoutOptions, TransformerBlock, TransformerBlockKind, TransformerRoute, TransformerRouteKind, TransformerTopologyProps, TransitionType, TreeNodeSpec, ValueChangeOptions, ValueChangeState, Wave, WaveDiagramProps, WaveSample, WeightedVectorOptions, WeightedVectorState, WeightedVectorStatus, WeightedVectorTerm, WeightedVectorTermState };