trace-avatar-render 0.2.1 → 0.2.2

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.
package/dist/cli.js CHANGED
@@ -5,7 +5,7 @@ import {
5
5
  main,
6
6
  parse,
7
7
  reportOf
8
- } from "./chunk-MC2ZHX5Z.js";
8
+ } from "./chunk-NFJMQBQ4.js";
9
9
  export {
10
10
  USAGE,
11
11
  UsageError,
package/dist/index.d.ts CHANGED
@@ -1082,6 +1082,11 @@ interface Shot {
1082
1082
  * The frames finish() gets: each screencast frame, and one every 1/30 s while the cursor moves or a click ring shows,
1083
1083
  * all with the cursor drawn. A still page with a still cursor needs no more frames.
1084
1084
  */
1085
+ /**
1086
+ * The scale of the captured frames (frame pixels per CSS pixel). Chrome's screencast does not always send frames at
1087
+ * the device scale factor (headless, a 414×736 page at scale 2 comes as 414×736), so it is measured, not assumed.
1088
+ */
1089
+ declare function frameScale(shots: readonly Shot[], viewportWidth: number, fallback?: number): number;
1085
1090
  declare function withCursor(shots: readonly Shot[], moves: readonly Move[], clicks: readonly Move[], o?: {
1086
1091
  scale?: number;
1087
1092
  sprite?: Sprite;
@@ -1123,6 +1128,8 @@ interface DirectorCard {
1123
1128
  * A director's cards for finish(): each in the look of the video's end card (its logo and colour, else the title
1124
1129
  * card's), with its own title; the product's address only on those that ask for it.
1125
1130
  */
1131
+ /** What a card reads, as one line: its title, then its address when it shows one. */
1132
+ declare function cardCaption(title: string, url?: string): string;
1126
1133
  declare function cardsOf(cards: readonly DirectorCard[], finishCards?: FinishOptions['cards'], appName?: string): {
1127
1134
  t: number;
1128
1135
  ms: number;
@@ -1463,4 +1470,4 @@ declare function makeCampaign(c: LoadedCampaign, o?: MakeOptions): Promise<{
1463
1470
  */
1464
1471
  declare function saysOf(c: Pick<LoadedCampaign, 'out'>, renderId: string): string[] | null;
1465
1472
 
1466
- export { type Action, type Alias, type Brand, CAMPAIGN_KINDS, CAMPAIGN_SHAPES, CANVASES, CATALOGUE_FORMATS, CATALOGUE_KINDS, CATALOGUE_REQUIRED, CATALOGUE_SHAPES, CATALOGUE_SPEC, CORNERS, type CameraOptions, type Campaign, type CampaignApp, type CampaignLook, type CampaignRender, type CampaignVideo, type Canvas, type CanvasSpec, type Capture, type CaptureOptions, type CapturedFrame, type CardOptions, type Catalogue, type CatalogueCheck, type CatalogueEntry, type CheckOptions, type Corner, type Cue, DEFAULT_BACKGROUND, DEFAULT_MAX_WAIT_MS, DIRECTOR_VIEWPORT, type DirectOptions, type DirectResult, type Director, type DirectorCard, type EditOptions, type FinishOptions, type FrameStyle, GEMINI_TTS, type GifOptions, type GifResult, type GifWriter, type Image, type Layers, type Layout, type LoadedCampaign, type LookOf, type Made, type MakeOptions, type Move, type NarrationPlan, type OutFormat, type OutSpec, type Pcm, type Phase, type PlanOptions, type PlannedLine, type Point, type Progress, type Rect, RenderError, type RenderOptions, type RenderOutput, type RenderResult, type RepairOutcome, type RepairSuggestion, SKIP_KEEP_MS, type Scene, type Script, type Segment, type Session, type Shot, type Span, type Sprite, TRACK_RATE, type TimelineEvent, type Unresolved, type Voice, type Watermark, ZOOM_KINDS, actionsOf, aliasOf, arrowSprite, badgeAt, blank, brandFile, brandOf, cached, cameraKeys, cameraPath, canvasOf, captionCues, capture, cardFrames, cardOf, cardsOf, catalogueId, chapterCues, checkCampaign, checkCatalogue, createGifWriter, createLayers, crop, crossfade, cueAt, cursorAt, dataUri, direct, drawCursor, drawRegion, durationOf, editList, encodeGif, encodeMp4, endsWithOf, ensureApp, filesOf, findFfmpeg, findPlayer, finish, fitWidth, formatOf, frameTimes, fromS16le, fromWav, geminiVoice, layoutOf, linesOf, loadCampaign, lookOptions, makeCampaign, mix, mp4Args, mp4Head, msOf, narrationText, openAiVoice, outputAt, overlay, pageAt, paletteOf, parseScript, pathOf, pickFrames, pixel, planNarration, progressOf, providerOf, readCampaign, render, rendersOf, repairGuide, repairScriptOf, resample, resize, runQa, sayFrom, sayVoice, saysOf, shapeTag, sourceAt, spansOf, stallInspector, statusOf, stepCues, suggestScript, toVtt, toWav, travelMs, trimSilence, voiceOf, vttEnds, watermarkOf, withCards, withCursor, withHolds };
1473
+ export { type Action, type Alias, type Brand, CAMPAIGN_KINDS, CAMPAIGN_SHAPES, CANVASES, CATALOGUE_FORMATS, CATALOGUE_KINDS, CATALOGUE_REQUIRED, CATALOGUE_SHAPES, CATALOGUE_SPEC, CORNERS, type CameraOptions, type Campaign, type CampaignApp, type CampaignLook, type CampaignRender, type CampaignVideo, type Canvas, type CanvasSpec, type Capture, type CaptureOptions, type CapturedFrame, type CardOptions, type Catalogue, type CatalogueCheck, type CatalogueEntry, type CheckOptions, type Corner, type Cue, DEFAULT_BACKGROUND, DEFAULT_MAX_WAIT_MS, DIRECTOR_VIEWPORT, type DirectOptions, type DirectResult, type Director, type DirectorCard, type EditOptions, type FinishOptions, type FrameStyle, GEMINI_TTS, type GifOptions, type GifResult, type GifWriter, type Image, type Layers, type Layout, type LoadedCampaign, type LookOf, type Made, type MakeOptions, type Move, type NarrationPlan, type OutFormat, type OutSpec, type Pcm, type Phase, type PlanOptions, type PlannedLine, type Point, type Progress, type Rect, RenderError, type RenderOptions, type RenderOutput, type RenderResult, type RepairOutcome, type RepairSuggestion, SKIP_KEEP_MS, type Scene, type Script, type Segment, type Session, type Shot, type Span, type Sprite, TRACK_RATE, type TimelineEvent, type Unresolved, type Voice, type Watermark, ZOOM_KINDS, actionsOf, aliasOf, arrowSprite, badgeAt, blank, brandFile, brandOf, cached, cameraKeys, cameraPath, canvasOf, captionCues, capture, cardCaption, cardFrames, cardOf, cardsOf, catalogueId, chapterCues, checkCampaign, checkCatalogue, createGifWriter, createLayers, crop, crossfade, cueAt, cursorAt, dataUri, direct, drawCursor, drawRegion, durationOf, editList, encodeGif, encodeMp4, endsWithOf, ensureApp, filesOf, findFfmpeg, findPlayer, finish, fitWidth, formatOf, frameScale, frameTimes, fromS16le, fromWav, geminiVoice, layoutOf, linesOf, loadCampaign, lookOptions, makeCampaign, mix, mp4Args, mp4Head, msOf, narrationText, openAiVoice, outputAt, overlay, pageAt, paletteOf, parseScript, pathOf, pickFrames, pixel, planNarration, progressOf, providerOf, readCampaign, render, rendersOf, repairGuide, repairScriptOf, resample, resize, runQa, sayFrom, sayVoice, saysOf, shapeTag, sourceAt, spansOf, stallInspector, statusOf, stepCues, suggestScript, toVtt, toWav, travelMs, trimSilence, voiceOf, vttEnds, watermarkOf, withCards, withCursor, withHolds };
package/dist/index.js CHANGED
@@ -29,6 +29,7 @@ import {
29
29
  canvasOf,
30
30
  captionCues,
31
31
  capture,
32
+ cardCaption,
32
33
  cardFrames,
33
34
  cardOf,
34
35
  cardsOf,
@@ -58,6 +59,7 @@ import {
58
59
  finish,
59
60
  fitWidth,
60
61
  formatOf,
62
+ frameScale,
61
63
  frameTimes,
62
64
  fromS16le,
63
65
  fromWav,
@@ -112,7 +114,7 @@ import {
112
114
  withCards,
113
115
  withCursor,
114
116
  withHolds
115
- } from "./chunk-MC2ZHX5Z.js";
117
+ } from "./chunk-NFJMQBQ4.js";
116
118
  export {
117
119
  CAMPAIGN_KINDS,
118
120
  CAMPAIGN_SHAPES,
@@ -144,6 +146,7 @@ export {
144
146
  canvasOf,
145
147
  captionCues,
146
148
  capture,
149
+ cardCaption,
147
150
  cardFrames,
148
151
  cardOf,
149
152
  cardsOf,
@@ -173,6 +176,7 @@ export {
173
176
  finish,
174
177
  fitWidth,
175
178
  formatOf,
179
+ frameScale,
176
180
  frameTimes,
177
181
  fromS16le,
178
182
  fromWav,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "trace-avatar-render",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Render a trace-avatar guide to a GIF or MP4 by playing it on your real app in headless Chromium.",
5
5
  "type": "module",
6
6
  "bin": {