@softure-ai/marketing-kit 0.33.0 → 0.35.0

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 (93) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/NOTICE +6 -0
  3. package/README.md +39 -0
  4. package/dist/config/schema.d.ts +8 -0
  5. package/dist/config/schema.d.ts.map +1 -1
  6. package/dist/config/schema.js +1 -1
  7. package/dist/config/schema.js.map +1 -1
  8. package/dist/footage/camera.d.ts +67 -0
  9. package/dist/footage/camera.d.ts.map +1 -0
  10. package/dist/footage/camera.js +89 -0
  11. package/dist/footage/camera.js.map +1 -0
  12. package/dist/footage/compose.d.ts +7 -1
  13. package/dist/footage/compose.d.ts.map +1 -1
  14. package/dist/footage/compose.js +45 -10
  15. package/dist/footage/compose.js.map +1 -1
  16. package/dist/footage/draft-overlays.d.ts +6 -0
  17. package/dist/footage/draft-overlays.d.ts.map +1 -1
  18. package/dist/footage/draft-overlays.js +194 -9
  19. package/dist/footage/draft-overlays.js.map +1 -1
  20. package/dist/footage/draft.d.ts +21 -2
  21. package/dist/footage/draft.d.ts.map +1 -1
  22. package/dist/footage/draft.js +70 -31
  23. package/dist/footage/draft.js.map +1 -1
  24. package/dist/footage/drawn-transitions.d.ts +63 -0
  25. package/dist/footage/drawn-transitions.d.ts.map +1 -0
  26. package/dist/footage/drawn-transitions.js +177 -0
  27. package/dist/footage/drawn-transitions.js.map +1 -0
  28. package/dist/footage/edl.d.ts +39 -0
  29. package/dist/footage/edl.d.ts.map +1 -1
  30. package/dist/footage/edl.js +48 -1
  31. package/dist/footage/edl.js.map +1 -1
  32. package/dist/footage/film.d.ts +4 -3
  33. package/dist/footage/film.d.ts.map +1 -1
  34. package/dist/footage/film.js +3 -2
  35. package/dist/footage/film.js.map +1 -1
  36. package/dist/footage/hand-font.d.ts +16 -0
  37. package/dist/footage/hand-font.d.ts.map +1 -0
  38. package/dist/footage/hand-font.js +43 -0
  39. package/dist/footage/hand-font.js.map +1 -0
  40. package/dist/footage/overlay-html.d.ts +1 -0
  41. package/dist/footage/overlay-html.d.ts.map +1 -1
  42. package/dist/footage/overlay-html.js +138 -9
  43. package/dist/footage/overlay-html.js.map +1 -1
  44. package/dist/footage/overlay-motion.d.ts +35 -0
  45. package/dist/footage/overlay-motion.d.ts.map +1 -1
  46. package/dist/footage/overlay-motion.js +45 -0
  47. package/dist/footage/overlay-motion.js.map +1 -1
  48. package/dist/footage/overlay-schema.d.ts +57 -8
  49. package/dist/footage/overlay-schema.d.ts.map +1 -1
  50. package/dist/footage/overlay-schema.js +87 -21
  51. package/dist/footage/overlay-schema.js.map +1 -1
  52. package/dist/footage/overlays.d.ts +127 -1
  53. package/dist/footage/overlays.d.ts.map +1 -1
  54. package/dist/footage/overlays.js +277 -12
  55. package/dist/footage/overlays.js.map +1 -1
  56. package/dist/footage/picture.d.ts +8 -2
  57. package/dist/footage/picture.d.ts.map +1 -1
  58. package/dist/footage/picture.js +41 -15
  59. package/dist/footage/picture.js.map +1 -1
  60. package/dist/footage/pipeline.d.ts.map +1 -1
  61. package/dist/footage/pipeline.js +7 -1
  62. package/dist/footage/pipeline.js.map +1 -1
  63. package/dist/footage/tools.d.ts +1 -1
  64. package/dist/footage/tools.d.ts.map +1 -1
  65. package/dist/footage/tools.js +1 -1
  66. package/dist/footage/tools.js.map +1 -1
  67. package/dist/index.d.ts +8 -5
  68. package/dist/index.d.ts.map +1 -1
  69. package/dist/index.js +8 -5
  70. package/dist/index.js.map +1 -1
  71. package/fonts/Caveat-SemiBold-Latin.ttf +0 -0
  72. package/fonts/LICENSE-Caveat.txt +93 -0
  73. package/fonts/README.md +14 -0
  74. package/package.json +1 -1
  75. package/schema/edl.schema.json +108 -13
  76. package/schema/marketing.schema.json +10 -2
  77. package/src/config/schema.ts +1 -1
  78. package/src/footage/camera.ts +129 -0
  79. package/src/footage/compose.ts +42 -11
  80. package/src/footage/draft-overlays.ts +223 -7
  81. package/src/footage/draft.ts +83 -32
  82. package/src/footage/drawn-transitions.ts +214 -0
  83. package/src/footage/edl.ts +45 -1
  84. package/src/footage/film.ts +3 -2
  85. package/src/footage/hand-font.ts +47 -0
  86. package/src/footage/overlay-html.ts +145 -8
  87. package/src/footage/overlay-motion.ts +49 -0
  88. package/src/footage/overlay-schema.ts +100 -23
  89. package/src/footage/overlays.ts +332 -15
  90. package/src/footage/picture.ts +48 -17
  91. package/src/footage/pipeline.ts +7 -1
  92. package/src/footage/tools.ts +1 -1
  93. package/src/index.ts +56 -0
@@ -16,7 +16,8 @@ import { prepareClipSounds, type SpeechPeaks, type SpeechPreGain } from "./clip-
16
16
  import { readCachedTranscript, writeCacheFile, writeTranscript } from "./cache.js";
17
17
  import { composeFootage, getFootageFilmSeconds, getFootageSfxCues } from "./compose.js";
18
18
  import { getCaptionHighlight } from "./caption-highlight.js";
19
- import { getOverlayTextsByRole, resolveEdlOverlays } from "./overlays.js";
19
+ import { getOverlayTextsByRole, isHandFontNeeded, resolveEdlOverlays } from "./overlays.js";
20
+ import { HAND_FONT } from "./hand-font.js";
20
21
  import { findMissingCaptionGlyphs, getCaptionBounds, getFootageCaptionLayout } from "./captions.js";
21
22
  import { err, getProviderFootageFailure, ok, type FootageResult } from "./failure.js";
22
23
  import { findLowDiskProblems, getFreeBytes, getRenderTempDir, type FreeBytesReader } from "./disk.js";
@@ -849,6 +850,11 @@ async function runRenderFootage(
849
850
  if (!prepared.ok) return prepared;
850
851
  const musicAsset = musicFile === null ? null : "assets/music.mp3";
851
852
  const fonts = copyFonts(options.brand.fonts, join(assetsDir, "fonts"));
853
+ // A note card and an end word are handwritten in the kit's own font, copied next to the brand's.
854
+ if (isHandFontNeeded(overlays.overlays)) {
855
+ mkdirSync(dirname(join(buildDir, HAND_FONT.asset)), { recursive: true });
856
+ cpSync(HAND_FONT.file, join(buildDir, HAND_FONT.asset));
857
+ }
852
858
  // The logo card's own logo wins over the brand's; it keeps its extension, so a PNG is drawn as a PNG.
853
859
  const logoSource = (film.endCard?.layout === "logo" ? film.endCard.logo : undefined) ?? options.brand.logo;
854
860
  const logoAsset = logoSource === null ? null : `assets/logo${extname(logoSource).toLowerCase() || ".svg"}`;
@@ -36,7 +36,7 @@ export interface FootageToolsOptions {
36
36
  export const REQUIRED_DECODERS = ["hevc", "h264"] as const;
37
37
  export const REQUIRED_FILTERS = ["zscale", "tonemap", "lut3d"] as const;
38
38
  /** What the fast draft needs on top: libass (with libfreetype) for the captions, `xfade` for fades, `zoompan` for Ken Burns. */
39
- export const DRAFT_FILTERS = ["ass", "xfade", "zoompan"] as const;
39
+ export const DRAFT_FILTERS = ["ass", "xfade", "zoompan", "gblur", "geq", "rotate", "blend", "noise", "interleave", "hstack"] as const;
40
40
 
41
41
  const DRAFT_INSTALL_HINT = "install an ffmpeg built with libass and libfreetype (macOS: brew install ffmpeg, Debian/Ubuntu: apt install ffmpeg)";
42
42
  const INSTALL_HINT = "install an ffmpeg built with libzimg (macOS: brew install ffmpeg, Debian/Ubuntu: apt install ffmpeg)";
package/src/index.ts CHANGED
@@ -94,6 +94,7 @@ export {
94
94
  MIN_OVERLAY_TYPING_SPEED,
95
95
  OVERLAY_ALIGNED_KINDS,
96
96
  OVERLAY_ALIGNS,
97
+ OVERLAY_KEYWORD_ALIGNS,
97
98
  OVERLAY_EASINGS,
98
99
  OVERLAY_ENTRANCES,
99
100
  OVERLAY_ENTRANCES_BY_KIND,
@@ -101,6 +102,13 @@ export {
101
102
  OVERLAY_PINS,
102
103
  OVERLAY_LIST_LAYOUTS,
103
104
  MAX_OVERLAY_SUBTITLE_DELAY,
105
+ MAX_END_WORD_SECONDS,
106
+ MAX_OVERLAY_END_WORD_LENGTH,
107
+ MAX_OVERLAY_NOTE_LENGTH,
108
+ MIN_END_WORD_SECONDS,
109
+ OVERLAY_BACKDROP_KINDS,
110
+ OVERLAY_BACKDROPS,
111
+ OVERLAY_NOTE_STYLES,
104
112
  OVERLAY_KINDS,
105
113
  OVERLAY_POSITIONS,
106
114
  OVERLAY_POSITIONS_BY_KIND,
@@ -114,6 +122,9 @@ export {
114
122
  type EdlOverlayStyle,
115
123
  type EdlOverlayWord,
116
124
  type OverlayAlign,
125
+ type OverlayBackdrop,
126
+ type OverlayKeywordAlign,
127
+ type OverlayNoteStyle,
117
128
  type OverlayEasing,
118
129
  type OverlayEntrance,
119
130
  type OverlayExit,
@@ -146,6 +157,7 @@ export {
146
157
  type StyleShadow,
147
158
  } from "./footage/brand-style.js";
148
159
  export { createDraftTextMeasure, wrapDraftLine, type DraftTextMeasure } from "./footage/draft-text-width.js";
160
+ export { HAND_FONT } from "./footage/hand-font.js";
149
161
  export {
150
162
  OVERLAY_FONT_ROLES,
151
163
  OVERLAY_FONT_SIZES,
@@ -170,6 +182,11 @@ export {
170
182
  getOverlaySafeZone,
171
183
  getOverlayTexts,
172
184
  getOverlayTextsByRole,
185
+ getNoteColors,
186
+ isHandFontNeeded,
187
+ isTitleBand,
188
+ timeNote,
189
+ wrapNoteText,
173
190
  resolveEdlOverlays,
174
191
  type OverlayBox,
175
192
  type OverlayFontRole,
@@ -186,6 +203,8 @@ export {
186
203
  getEntranceScaleAt,
187
204
  getExitMotion,
188
205
  getListItemStarts,
206
+ getDropLetterTimes,
207
+ getDropOffsetAt,
189
208
  type OverlayEase,
190
209
  type OverlayEntranceMotion,
191
210
  type OverlayExitMotion,
@@ -535,7 +554,43 @@ export {
535
554
  type EdlClip,
536
555
  type EdlSegment,
537
556
  type SegmentMotion,
557
+ MAX_FADE_FRAMES,
558
+ MIN_FADE_FRAMES,
538
559
  } from "./footage/edl.js";
560
+ export {
561
+ CAMERA_EASES,
562
+ CAMERA_ORIGIN,
563
+ MAX_CAMERA_SCALE,
564
+ cameraSchema,
565
+ describeCamera,
566
+ getCameraGsapEase,
567
+ getCameraMoveFrames,
568
+ getCameraMoveSeconds,
569
+ getCameraOrigin,
570
+ getCameraScaleAt,
571
+ getCameraScaleExpression,
572
+ isCameraMoving,
573
+ isSameCamera,
574
+ toTransformOrigin,
575
+ type CameraAnchor,
576
+ type CameraEase,
577
+ type EdlCamera,
578
+ } from "./footage/camera.js";
579
+ export {
580
+ DRAWN_TRANSITIONS,
581
+ DRAWN_TRANSITION_FRAMES,
582
+ FRAME_TIMING,
583
+ PAPER_FADE_FRAMES,
584
+ STUTTER_FRAMES,
585
+ STUTTER_SCALE,
586
+ WHIP_OUT_FRAMES,
587
+ buildDrawnTransitionFilters,
588
+ getCardFrame,
589
+ getTransitionOverlapFrames,
590
+ isDrawnTransition,
591
+ type DrawnTransition,
592
+ type DrawnTransitionFiltersInput,
593
+ } from "./footage/drawn-transitions.js";
539
594
  export { findRetakes, splitFilmSentences, splitSentences, type RetakeKind, type RetakeSuggestion, type Sentence } from "./footage/sentences.js";
540
595
  export {
541
596
  CAPTION_SAFE_ZONES,
@@ -578,6 +633,7 @@ export {
578
633
  getFootageFilmSeconds,
579
634
  getFootageSfxCues,
580
635
  getLogoCardBox,
636
+ getSegmentFadeFrames,
581
637
  getSegmentScales,
582
638
  type FootageComposeAssets,
583
639
  type FootageComposeInput,