@kvman/kvvideo 0.0.0-stage → 0.1.1

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 (345) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/dist/api.d.ts +105 -0
  4. package/dist/api.d.ts.map +1 -0
  5. package/dist/api.js +2 -0
  6. package/dist/api.js.map +1 -0
  7. package/dist/brand/brand.d.ts +17 -0
  8. package/dist/brand/brand.d.ts.map +1 -0
  9. package/dist/brand/brand.js +44 -0
  10. package/dist/brand/brand.js.map +1 -0
  11. package/dist/browser/channels.d.ts +6 -0
  12. package/dist/browser/channels.d.ts.map +1 -0
  13. package/dist/browser/channels.js +5 -0
  14. package/dist/browser/channels.js.map +1 -0
  15. package/dist/browser/launch.d.ts +6 -0
  16. package/dist/browser/launch.d.ts.map +1 -0
  17. package/dist/browser/launch.js +14 -0
  18. package/dist/browser/launch.js.map +1 -0
  19. package/dist/browser/start-browser.d.ts +5 -0
  20. package/dist/browser/start-browser.d.ts.map +1 -0
  21. package/dist/browser/start-browser.js +17 -0
  22. package/dist/browser/start-browser.js.map +1 -0
  23. package/dist/compose/ass-file.d.ts +17 -0
  24. package/dist/compose/ass-file.d.ts.map +1 -0
  25. package/dist/compose/ass-file.js +65 -0
  26. package/dist/compose/ass-file.js.map +1 -0
  27. package/dist/compose/background.d.ts +23 -0
  28. package/dist/compose/background.d.ts.map +1 -0
  29. package/dist/compose/background.js +31 -0
  30. package/dist/compose/background.js.map +1 -0
  31. package/dist/compose/camera.d.ts +32 -0
  32. package/dist/compose/camera.d.ts.map +1 -0
  33. package/dist/compose/camera.js +98 -0
  34. package/dist/compose/camera.js.map +1 -0
  35. package/dist/compose/caption-font.d.ts +8 -0
  36. package/dist/compose/caption-font.d.ts.map +1 -0
  37. package/dist/compose/caption-font.js +24 -0
  38. package/dist/compose/caption-font.js.map +1 -0
  39. package/dist/compose/compose-drawing.d.ts +19 -0
  40. package/dist/compose/compose-drawing.d.ts.map +1 -0
  41. package/dist/compose/compose-drawing.js +38 -0
  42. package/dist/compose/compose-drawing.js.map +1 -0
  43. package/dist/compose/compose-input.d.ts +187 -0
  44. package/dist/compose/compose-input.d.ts.map +1 -0
  45. package/dist/compose/compose-input.js +76 -0
  46. package/dist/compose/compose-input.js.map +1 -0
  47. package/dist/compose/compose-plan.d.ts +36 -0
  48. package/dist/compose/compose-plan.d.ts.map +1 -0
  49. package/dist/compose/compose-plan.js +55 -0
  50. package/dist/compose/compose-plan.js.map +1 -0
  51. package/dist/compose/compose-size.d.ts +50 -0
  52. package/dist/compose/compose-size.d.ts.map +1 -0
  53. package/dist/compose/compose-size.js +72 -0
  54. package/dist/compose/compose-size.js.map +1 -0
  55. package/dist/compose/drawn-images.d.ts +19 -0
  56. package/dist/compose/drawn-images.d.ts.map +1 -0
  57. package/dist/compose/drawn-images.js +75 -0
  58. package/dist/compose/drawn-images.js.map +1 -0
  59. package/dist/compose/final-pass.d.ts +34 -0
  60. package/dist/compose/final-pass.d.ts.map +1 -0
  61. package/dist/compose/final-pass.js +106 -0
  62. package/dist/compose/final-pass.js.map +1 -0
  63. package/dist/compose/frame-layout.d.ts +30 -0
  64. package/dist/compose/frame-layout.d.ts.map +1 -0
  65. package/dist/compose/frame-layout.js +33 -0
  66. package/dist/compose/frame-layout.js.map +1 -0
  67. package/dist/compose/overlays.d.ts +20 -0
  68. package/dist/compose/overlays.d.ts.map +1 -0
  69. package/dist/compose/overlays.js +30 -0
  70. package/dist/compose/overlays.js.map +1 -0
  71. package/dist/compose/page-again.d.ts +26 -0
  72. package/dist/compose/page-again.d.ts.map +1 -0
  73. package/dist/compose/page-again.js +50 -0
  74. package/dist/compose/page-again.js.map +1 -0
  75. package/dist/compose/player-copies.d.ts +10 -0
  76. package/dist/compose/player-copies.d.ts.map +1 -0
  77. package/dist/compose/player-copies.js +34 -0
  78. package/dist/compose/player-copies.js.map +1 -0
  79. package/dist/compose/register-compose.d.ts +3 -0
  80. package/dist/compose/register-compose.d.ts.map +1 -0
  81. package/dist/compose/register-compose.js +151 -0
  82. package/dist/compose/register-compose.js.map +1 -0
  83. package/dist/compose/render.d.ts +25 -0
  84. package/dist/compose/render.d.ts.map +1 -0
  85. package/dist/compose/render.js +61 -0
  86. package/dist/compose/render.js.map +1 -0
  87. package/dist/compose/scene-args.d.ts +37 -0
  88. package/dist/compose/scene-args.d.ts.map +1 -0
  89. package/dist/compose/scene-args.js +103 -0
  90. package/dist/compose/scene-args.js.map +1 -0
  91. package/dist/compose/scene-look.d.ts +31 -0
  92. package/dist/compose/scene-look.d.ts.map +1 -0
  93. package/dist/compose/scene-look.js +46 -0
  94. package/dist/compose/scene-look.js.map +1 -0
  95. package/dist/compose/scene-plan.d.ts +26 -0
  96. package/dist/compose/scene-plan.d.ts.map +1 -0
  97. package/dist/compose/scene-plan.js +34 -0
  98. package/dist/compose/scene-plan.js.map +1 -0
  99. package/dist/compose/sound-effects.d.ts +23 -0
  100. package/dist/compose/sound-effects.d.ts.map +1 -0
  101. package/dist/compose/sound-effects.js +40 -0
  102. package/dist/compose/sound-effects.js.map +1 -0
  103. package/dist/compose/srt.d.ts +3 -0
  104. package/dist/compose/srt.d.ts.map +1 -0
  105. package/dist/compose/srt.js +10 -0
  106. package/dist/compose/srt.js.map +1 -0
  107. package/dist/compose/transitions.d.ts +16 -0
  108. package/dist/compose/transitions.d.ts.map +1 -0
  109. package/dist/compose/transitions.js +38 -0
  110. package/dist/compose/transitions.js.map +1 -0
  111. package/dist/connector.d.ts +132 -0
  112. package/dist/connector.d.ts.map +1 -0
  113. package/dist/connector.js +63 -0
  114. package/dist/connector.js.map +1 -0
  115. package/dist/files/answer-path.d.ts +3 -0
  116. package/dist/files/answer-path.d.ts.map +1 -0
  117. package/dist/files/answer-path.js +6 -0
  118. package/dist/files/answer-path.js.map +1 -0
  119. package/dist/files/place-output.d.ts +8 -0
  120. package/dist/files/place-output.d.ts.map +1 -0
  121. package/dist/files/place-output.js +24 -0
  122. package/dist/files/place-output.js.map +1 -0
  123. package/dist/files/sidecar.d.ts +209 -0
  124. package/dist/files/sidecar.d.ts.map +1 -0
  125. package/dist/files/sidecar.js +66 -0
  126. package/dist/files/sidecar.js.map +1 -0
  127. package/dist/files/workspace-paths.d.ts +7 -0
  128. package/dist/files/workspace-paths.d.ts.map +1 -0
  129. package/dist/files/workspace-paths.js +48 -0
  130. package/dist/files/workspace-paths.js.map +1 -0
  131. package/dist/fonts/bundled-fonts.d.ts +10 -0
  132. package/dist/fonts/bundled-fonts.d.ts.map +1 -0
  133. package/dist/fonts/bundled-fonts.js +10 -0
  134. package/dist/fonts/bundled-fonts.js.map +1 -0
  135. package/dist/fonts/font-family.d.ts +2 -0
  136. package/dist/fonts/font-family.d.ts.map +1 -0
  137. package/dist/fonts/font-family.js +43 -0
  138. package/dist/fonts/font-family.js.map +1 -0
  139. package/dist/fonts/register-fonts.d.ts +3 -0
  140. package/dist/fonts/register-fonts.d.ts.map +1 -0
  141. package/dist/fonts/register-fonts.js +12 -0
  142. package/dist/fonts/register-fonts.js.map +1 -0
  143. package/dist/guide.d.ts +3 -0
  144. package/dist/guide.d.ts.map +1 -0
  145. package/dist/guide.js +6 -0
  146. package/dist/guide.js.map +1 -0
  147. package/dist/index.d.ts +5 -0
  148. package/dist/index.d.ts.map +1 -0
  149. package/dist/index.js +30 -0
  150. package/dist/index.js.map +1 -0
  151. package/dist/narration/alignment.d.ts +15 -0
  152. package/dist/narration/alignment.d.ts.map +1 -0
  153. package/dist/narration/alignment.js +21 -0
  154. package/dist/narration/alignment.js.map +1 -0
  155. package/dist/narration/captions.d.ts +28 -0
  156. package/dist/narration/captions.d.ts.map +1 -0
  157. package/dist/narration/captions.js +70 -0
  158. package/dist/narration/captions.js.map +1 -0
  159. package/dist/narration/join-args.d.ts +3 -0
  160. package/dist/narration/join-args.d.ts.map +1 -0
  161. package/dist/narration/join-args.js +19 -0
  162. package/dist/narration/join-args.js.map +1 -0
  163. package/dist/narration/narration-cache.d.ts +25 -0
  164. package/dist/narration/narration-cache.d.ts.map +1 -0
  165. package/dist/narration/narration-cache.js +36 -0
  166. package/dist/narration/narration-cache.js.map +1 -0
  167. package/dist/narration/piper.d.ts +4 -0
  168. package/dist/narration/piper.d.ts.map +1 -0
  169. package/dist/narration/piper.js +13 -0
  170. package/dist/narration/piper.js.map +1 -0
  171. package/dist/narration/pronunciations.d.ts +11 -0
  172. package/dist/narration/pronunciations.d.ts.map +1 -0
  173. package/dist/narration/pronunciations.js +40 -0
  174. package/dist/narration/pronunciations.js.map +1 -0
  175. package/dist/narration/register-narration.d.ts +25 -0
  176. package/dist/narration/register-narration.d.ts.map +1 -0
  177. package/dist/narration/register-narration.js +103 -0
  178. package/dist/narration/register-narration.js.map +1 -0
  179. package/dist/narration/register-voice.d.ts +27 -0
  180. package/dist/narration/register-voice.d.ts.map +1 -0
  181. package/dist/narration/register-voice.js +82 -0
  182. package/dist/narration/register-voice.js.map +1 -0
  183. package/dist/narration/sentence-speaker.d.ts +35 -0
  184. package/dist/narration/sentence-speaker.d.ts.map +1 -0
  185. package/dist/narration/sentence-speaker.js +44 -0
  186. package/dist/narration/sentence-speaker.js.map +1 -0
  187. package/dist/narration/speech-services.d.ts +39 -0
  188. package/dist/narration/speech-services.d.ts.map +1 -0
  189. package/dist/narration/speech-services.js +67 -0
  190. package/dist/narration/speech-services.js.map +1 -0
  191. package/dist/narration/voice-args.d.ts +3 -0
  192. package/dist/narration/voice-args.d.ts.map +1 -0
  193. package/dist/narration/voice-args.js +10 -0
  194. package/dist/narration/voice-args.js.map +1 -0
  195. package/dist/problems.d.ts +12 -0
  196. package/dist/problems.d.ts.map +1 -0
  197. package/dist/problems.js +19 -0
  198. package/dist/problems.js.map +1 -0
  199. package/dist/programs/kill-tree.d.ts +16 -0
  200. package/dist/programs/kill-tree.d.ts.map +1 -0
  201. package/dist/programs/kill-tree.js +28 -0
  202. package/dist/programs/kill-tree.js.map +1 -0
  203. package/dist/programs/media-duration.d.ts +22 -0
  204. package/dist/programs/media-duration.d.ts.map +1 -0
  205. package/dist/programs/media-duration.js +23 -0
  206. package/dist/programs/media-duration.js.map +1 -0
  207. package/dist/programs/piped-program.d.ts +7 -0
  208. package/dist/programs/piped-program.d.ts.map +1 -0
  209. package/dist/programs/piped-program.js +45 -0
  210. package/dist/programs/piped-program.js.map +1 -0
  211. package/dist/programs/programs.d.ts +6 -0
  212. package/dist/programs/programs.d.ts.map +1 -0
  213. package/dist/programs/programs.js +6 -0
  214. package/dist/programs/programs.js.map +1 -0
  215. package/dist/programs/run-program.d.ts +23 -0
  216. package/dist/programs/run-program.d.ts.map +1 -0
  217. package/dist/programs/run-program.js +47 -0
  218. package/dist/programs/run-program.js.map +1 -0
  219. package/dist/record/address.d.ts +5 -0
  220. package/dist/record/address.d.ts.map +1 -0
  221. package/dist/record/address.js +26 -0
  222. package/dist/record/address.js.map +1 -0
  223. package/dist/record/cursor-script.d.ts +3 -0
  224. package/dist/record/cursor-script.d.ts.map +1 -0
  225. package/dist/record/cursor-script.js +59 -0
  226. package/dist/record/cursor-script.js.map +1 -0
  227. package/dist/record/encoder-args.d.ts +3 -0
  228. package/dist/record/encoder-args.d.ts.map +1 -0
  229. package/dist/record/encoder-args.js +13 -0
  230. package/dist/record/encoder-args.js.map +1 -0
  231. package/dist/record/frame-writer.d.ts +8 -0
  232. package/dist/record/frame-writer.d.ts.map +1 -0
  233. package/dist/record/frame-writer.js +30 -0
  234. package/dist/record/frame-writer.js.map +1 -0
  235. package/dist/record/motion.d.ts +19 -0
  236. package/dist/record/motion.d.ts.map +1 -0
  237. package/dist/record/motion.js +59 -0
  238. package/dist/record/motion.js.map +1 -0
  239. package/dist/record/narration-cues.d.ts +14 -0
  240. package/dist/record/narration-cues.d.ts.map +1 -0
  241. package/dist/record/narration-cues.js +12 -0
  242. package/dist/record/narration-cues.js.map +1 -0
  243. package/dist/record/own-port.d.ts +2 -0
  244. package/dist/record/own-port.d.ts.map +1 -0
  245. package/dist/record/own-port.js +23 -0
  246. package/dist/record/own-port.js.map +1 -0
  247. package/dist/record/page-ready.d.ts +4 -0
  248. package/dist/record/page-ready.d.ts.map +1 -0
  249. package/dist/record/page-ready.js +15 -0
  250. package/dist/record/page-ready.js.map +1 -0
  251. package/dist/record/page-route.d.ts +13 -0
  252. package/dist/record/page-route.d.ts.map +1 -0
  253. package/dist/record/page-route.js +64 -0
  254. package/dist/record/page-route.js.map +1 -0
  255. package/dist/record/pointer.d.ts +8 -0
  256. package/dist/record/pointer.d.ts.map +1 -0
  257. package/dist/record/pointer.js +24 -0
  258. package/dist/record/pointer.js.map +1 -0
  259. package/dist/record/recorder.d.ts +34 -0
  260. package/dist/record/recorder.d.ts.map +1 -0
  261. package/dist/record/recorder.js +99 -0
  262. package/dist/record/recorder.js.map +1 -0
  263. package/dist/record/register-record.d.ts +3 -0
  264. package/dist/record/register-record.d.ts.map +1 -0
  265. package/dist/record/register-record.js +83 -0
  266. package/dist/record/register-record.js.map +1 -0
  267. package/dist/record/run-step.d.ts +20 -0
  268. package/dist/record/run-step.d.ts.map +1 -0
  269. package/dist/record/run-step.js +69 -0
  270. package/dist/record/run-step.js.map +1 -0
  271. package/dist/record/screencast.d.ts +9 -0
  272. package/dist/record/screencast.d.ts.map +1 -0
  273. package/dist/record/screencast.js +38 -0
  274. package/dist/record/screencast.js.map +1 -0
  275. package/dist/record/steps.d.ts +124 -0
  276. package/dist/record/steps.d.ts.map +1 -0
  277. package/dist/record/steps.js +47 -0
  278. package/dist/record/steps.js.map +1 -0
  279. package/dist/register-with-kvcoder.d.ts +3 -0
  280. package/dist/register-with-kvcoder.d.ts.map +1 -0
  281. package/dist/register-with-kvcoder.js +15 -0
  282. package/dist/register-with-kvcoder.js.map +1 -0
  283. package/dist/review/analysis.d.ts +19 -0
  284. package/dist/review/analysis.d.ts.map +1 -0
  285. package/dist/review/analysis.js +36 -0
  286. package/dist/review/analysis.js.map +1 -0
  287. package/dist/review/frames.d.ts +9 -0
  288. package/dist/review/frames.d.ts.map +1 -0
  289. package/dist/review/frames.js +28 -0
  290. package/dist/review/frames.js.map +1 -0
  291. package/dist/review/register-review.d.ts +24 -0
  292. package/dist/review/register-review.d.ts.map +1 -0
  293. package/dist/review/register-review.js +81 -0
  294. package/dist/review/register-review.js.map +1 -0
  295. package/dist/review/sheet-args.d.ts +11 -0
  296. package/dist/review/sheet-args.d.ts.map +1 -0
  297. package/dist/review/sheet-args.js +24 -0
  298. package/dist/review/sheet-args.js.map +1 -0
  299. package/dist/settings.d.ts +33 -0
  300. package/dist/settings.d.ts.map +1 -0
  301. package/dist/settings.js +29 -0
  302. package/dist/settings.js.map +1 -0
  303. package/dist/setup/browser-readiness.d.ts +14 -0
  304. package/dist/setup/browser-readiness.d.ts.map +1 -0
  305. package/dist/setup/browser-readiness.js +16 -0
  306. package/dist/setup/browser-readiness.js.map +1 -0
  307. package/dist/setup/ffmpeg-readiness.d.ts +19 -0
  308. package/dist/setup/ffmpeg-readiness.d.ts.map +1 -0
  309. package/dist/setup/ffmpeg-readiness.js +33 -0
  310. package/dist/setup/ffmpeg-readiness.js.map +1 -0
  311. package/dist/setup/narration-readiness.d.ts +21 -0
  312. package/dist/setup/narration-readiness.d.ts.map +1 -0
  313. package/dist/setup/narration-readiness.js +18 -0
  314. package/dist/setup/narration-readiness.js.map +1 -0
  315. package/dist/setup/register-setup.d.ts +3 -0
  316. package/dist/setup/register-setup.d.ts.map +1 -0
  317. package/dist/setup/register-setup.js +51 -0
  318. package/dist/setup/register-setup.js.map +1 -0
  319. package/dist/ui.d.ts +3 -0
  320. package/dist/ui.d.ts.map +1 -0
  321. package/dist/ui.js +26 -0
  322. package/dist/ui.js.map +1 -0
  323. package/dist/video-start.d.ts +3 -0
  324. package/dist/video-start.d.ts.map +1 -0
  325. package/dist/video-start.js +28 -0
  326. package/dist/video-start.js.map +1 -0
  327. package/dist/web/components/player.css +2 -0
  328. package/dist/web/components/player.js +55 -0
  329. package/docs/guide.md +28 -0
  330. package/fonts/Amiri-Bold.ttf +0 -0
  331. package/fonts/IBMPlexSansArabic-Bold.ttf +0 -0
  332. package/fonts/Lato-Bold.ttf +0 -0
  333. package/fonts/OFL-Amiri.txt +94 -0
  334. package/fonts/OFL-IBMPlexSansArabic.txt +93 -0
  335. package/fonts/OFL-Lato.txt +93 -0
  336. package/fonts/OFL-Poppins.txt +93 -0
  337. package/fonts/Poppins-Bold.ttf +0 -0
  338. package/locales/ar.json +48 -0
  339. package/locales/en.json +48 -0
  340. package/package.json +73 -3
  341. package/sounds/SOURCES.md +13 -0
  342. package/sounds/click.wav +0 -0
  343. package/sounds/keys.wav +0 -0
  344. package/sounds/pop.wav +0 -0
  345. package/sounds/whoosh.wav +0 -0
@@ -0,0 +1,34 @@
1
+ import path from 'node:path';
2
+ import { invalid } from "../problems.js";
3
+ import { narrationLeadMs } from "../record/narration-cues.js";
4
+ // A scene's length (plan 16 §16.8; ADR 0115, 41): its `durationMs`, else 300 ms plus its narration's length plus
5
+ // 300 ms, else its video part's. A video part shorter than the scene holds its last frame, and a longer one is cut.
6
+ export const videoExtensions = ['.webm', '.mp4', '.mov', '.mkv'];
7
+ export const imageExtensions = ['.png', '.jpg', '.jpeg', '.webp'];
8
+ export const audioExtensions = ['.mp3', '.wav', '.m4a'];
9
+ export function isImage(file) {
10
+ return imageExtensions.includes(path.extname(file).toLowerCase());
11
+ }
12
+ /** Checks what a scene needs before any file is read: an image has no part and has a length. */
13
+ export function checkScene(number, scene) {
14
+ if (!isImage(scene.clip))
15
+ return;
16
+ if (scene.from !== undefined || scene.to !== undefined)
17
+ throw invalid(`Scene ${String(number)} is an image, which has no from or to.`, { scene: number });
18
+ if (scene.durationMs === undefined && scene.narration === undefined)
19
+ throw invalid(`Scene ${String(number)} is an image without a narration or durationMs, so it has no length.`, { scene: number });
20
+ }
21
+ export function planScene(number, scene, files, durations) {
22
+ checkScene(number, scene);
23
+ const base = { number, clip: files.clip, narration: files.narration };
24
+ const narrated = durations.narrationMs === undefined ? undefined : narrationLeadMs + durations.narrationMs + narrationLeadMs;
25
+ if (isImage(files.clip))
26
+ return { ...base, kind: 'image', startMs: 0, partMs: 0, lengthMs: scene.durationMs ?? narrated ?? 0 };
27
+ const clipMs = durations.clipMs ?? 0;
28
+ const startMs = scene.from ?? 0;
29
+ if (startMs >= clipMs)
30
+ throw invalid(`Scene ${String(number)} starts at ${String(startMs)} ms, past its clip's end.`, { scene: number });
31
+ const partMs = Math.min(scene.to ?? clipMs, clipMs) - startMs;
32
+ return { ...base, kind: 'video', startMs, partMs, lengthMs: scene.durationMs ?? narrated ?? partMs };
33
+ }
34
+ //# sourceMappingURL=scene-plan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scene-plan.js","sourceRoot":"","sources":["../../src/compose/scene-plan.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,iHAAiH;AACjH,oHAAoH;AAEpH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAQxD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAY;IACrD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1J,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,sEAAsE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACvM,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAY,EAAE,KAAiB,EAAE,SAAyB;IAClG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,GAAG,SAAS,CAAC,WAAW,GAAG,eAAe,CAAC;IAC7H,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;IAC/H,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,IAAI,MAAM;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACzI,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;AACvG,CAAC"}
@@ -0,0 +1,23 @@
1
+ import type { Action } from '../record/steps.ts';
2
+ import type { Transition } from './transitions.ts';
3
+ export type Sound = 'click' | 'keys' | 'whoosh' | 'pop';
4
+ export type SoundEvent = {
5
+ sound: Sound;
6
+ atMs: number;
7
+ untilMs?: number;
8
+ };
9
+ /** The folder that holds the bundled sounds, from the source and the build alike. */
10
+ export declare const soundsFolder: string;
11
+ /** What a scene gives for its sounds: where it starts in the video, its part of the recording, and its callouts. */
12
+ export type SceneSounds = {
13
+ startMs: number;
14
+ lengthMs: number;
15
+ fromMs: number;
16
+ partMs: number;
17
+ actions: readonly Action[];
18
+ calloutsFromMs: readonly number[];
19
+ on: boolean;
20
+ };
21
+ /** The video's sound effects, in time order. */
22
+ export declare function soundEvents(scenes: readonly SceneSounds[], transitions: readonly Transition[], on: boolean): SoundEvent[];
23
+ //# sourceMappingURL=sound-effects.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sound-effects.d.ts","sourceRoot":"","sources":["../../src/compose/sound-effects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,qFAAqF;AACrF,eAAO,MAAM,YAAY,QAA2D,CAAC;AAErF,oHAAoH;AACpH,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC;AAoB5K,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,GAAG,UAAU,EAAE,CAQzH"}
@@ -0,0 +1,40 @@
1
+ import { fileURLToPath } from 'node:url';
2
+ /** The folder that holds the bundled sounds, from the source and the build alike. */
3
+ export const soundsFolder = fileURLToPath(new URL('../../sounds/', import.meta.url));
4
+ function sceneEvents(scene) {
5
+ if (!scene.on)
6
+ return [];
7
+ const shown = (recordingMs) => {
8
+ const inScene = recordingMs - scene.fromMs;
9
+ return inScene >= 0 && inScene < Math.min(scene.partMs, scene.lengthMs) ? scene.startMs + inScene : undefined;
10
+ };
11
+ const events = [];
12
+ for (const action of scene.actions) {
13
+ if (action.actMs === undefined)
14
+ continue;
15
+ const at = shown(action.do === 'type' ? action.actMs + 120 : action.actMs);
16
+ if (at === undefined || (action.do !== 'click' && action.do !== 'type'))
17
+ continue;
18
+ if (action.do === 'click')
19
+ events.push({ sound: 'click', atMs: at });
20
+ else
21
+ events.push({ sound: 'keys', atMs: at, untilMs: scene.startMs + Math.min(action.endMs - scene.fromMs, scene.lengthMs) });
22
+ }
23
+ for (const fromMs of scene.calloutsFromMs)
24
+ if (fromMs < scene.lengthMs)
25
+ events.push({ sound: 'pop', atMs: scene.startMs + fromMs });
26
+ return events;
27
+ }
28
+ /** The video's sound effects, in time order. */
29
+ export function soundEvents(scenes, transitions, on) {
30
+ if (!on)
31
+ return [];
32
+ const events = scenes.flatMap(sceneEvents);
33
+ transitions.forEach((transition, index) => {
34
+ const next = scenes[index + 1];
35
+ if (transition.kind === 'slide' && transition.ms > 0 && next !== undefined && (scenes[index]?.on ?? false))
36
+ events.push({ sound: 'whoosh', atMs: next.startMs });
37
+ });
38
+ return events.filter((event) => event.untilMs === undefined || event.untilMs > event.atMs).sort((a, b) => a.atMs - b.atMs);
39
+ }
40
+ //# sourceMappingURL=sound-effects.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sound-effects.js","sourceRoot":"","sources":["../../src/compose/sound-effects.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { Caption } from '../narration/captions.ts';
2
+ export declare function srtFile(captions: readonly Caption[]): string;
3
+ //# sourceMappingURL=srt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"srt.d.ts","sourceRoot":"","sources":["../../src/compose/srt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAUxD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE5D"}
@@ -0,0 +1,10 @@
1
+ // The `.srt` beside a video (plan 16 §16.8; ADR 0115, 18): its captions on the video's time line, numbered from 1, for
2
+ // players and sites that show their own captions.
3
+ function srtTime(ms) {
4
+ const pad = (value, size = 2) => String(value).padStart(size, '0');
5
+ return `${pad(Math.floor(ms / 3_600_000))}:${pad(Math.floor(ms / 60_000) % 60)}:${pad(Math.floor(ms / 1000) % 60)},${pad(ms % 1000, 3)}`;
6
+ }
7
+ export function srtFile(captions) {
8
+ return captions.map((caption, index) => `${String(index + 1)}\n${srtTime(caption.startMs)} --> ${srtTime(caption.endMs)}\n${caption.text.replace(/\s+/g, ' ').trim()}\n`).join('\n');
9
+ }
10
+ //# sourceMappingURL=srt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"srt.js","sourceRoot":"","sources":["../../src/compose/srt.ts"],"names":[],"mappings":"AAEA,uHAAuH;AACvH,kDAAkD;AAElD,SAAS,OAAO,CAAC,EAAU;IACzB,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3I,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAA4B;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvL,CAAC"}
@@ -0,0 +1,16 @@
1
+ import type { Scene } from './compose-input.ts';
2
+ export type Transition = {
3
+ kind: 'cut' | 'crossfade' | 'fade-black' | 'slide';
4
+ toward: 'start' | 'end' | 'up' | 'down';
5
+ ms: number;
6
+ };
7
+ /** Each transition, between scene `i` and `i + 1`, from the scenes and their lengths. */
8
+ export declare function transitionsOf(scenes: readonly Scene[], lengths: readonly number[]): Transition[];
9
+ /** Where each scene starts in the video, and the video's length. */
10
+ export declare function sceneStarts(lengths: readonly number[], transitions: readonly Transition[]): {
11
+ starts: number[];
12
+ durationMs: number;
13
+ };
14
+ /** The transition as ffmpeg's `xfade` names it, or `undefined` for a cut. */
15
+ export declare function xfadeName(transition: Transition, direction: 'ltr' | 'rtl'): string | undefined;
16
+ //# sourceMappingURL=transitions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/compose/transitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAMhD,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,KAAK,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrI,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE,CAUhG;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAQpI;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAM9F"}
@@ -0,0 +1,38 @@
1
+ import { invalid } from "../problems.js";
2
+ const defaultMs = 500;
3
+ /** Each transition, between scene `i` and `i + 1`, from the scenes and their lengths. */
4
+ export function transitionsOf(scenes, lengths) {
5
+ const last = scenes.at(-1);
6
+ if (last?.transition !== undefined)
7
+ throw invalid(`Scene ${String(scenes.length)} is the last, so it has no transition.`, { scene: scenes.length });
8
+ return scenes.slice(0, -1).map((scene, index) => {
9
+ const most = Math.floor(Math.min(lengths[index] ?? 0, lengths[index + 1] ?? 0) / 2);
10
+ const kind = scene.transition?.kind ?? 'crossfade';
11
+ const ms = kind === 'cut' ? 0 : (scene.transition?.ms ?? Math.min(defaultMs, most));
12
+ if (ms > most)
13
+ throw invalid(`Scene ${String(index + 1)}'s transition of ${String(ms)} ms is longer than half of a scene it joins (${String(most)} ms).`, { scene: index + 1, ms, most });
14
+ return { kind, toward: scene.transition?.toward ?? 'start', ms };
15
+ });
16
+ }
17
+ /** Where each scene starts in the video, and the video's length. */
18
+ export function sceneStarts(lengths, transitions) {
19
+ const starts = [];
20
+ let at = 0;
21
+ lengths.forEach((length, index) => {
22
+ starts.push(at);
23
+ at += length - (transitions[index]?.ms ?? 0);
24
+ });
25
+ return { starts, durationMs: at };
26
+ }
27
+ /** The transition as ffmpeg's `xfade` names it, or `undefined` for a cut. */
28
+ export function xfadeName(transition, direction) {
29
+ if (transition.kind === 'cut' || transition.ms === 0)
30
+ return undefined;
31
+ if (transition.kind === 'crossfade')
32
+ return 'fade';
33
+ if (transition.kind === 'fade-black')
34
+ return 'fadeblack';
35
+ const sideways = { start: direction === 'ltr' ? 'left' : 'right', end: direction === 'ltr' ? 'right' : 'left', up: 'up', down: 'down' };
36
+ return `slide${sideways[transition.toward]}`;
37
+ }
38
+ //# sourceMappingURL=transitions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/compose/transitions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,132 @@
1
+ export declare const connectorName = "video";
2
+ export declare const videoConnector: {
3
+ name: string;
4
+ optIn: true;
5
+ description: string;
6
+ commands: ({
7
+ name: string;
8
+ command: string;
9
+ examples: {
10
+ description: string;
11
+ input: {};
12
+ }[];
13
+ card?: never;
14
+ images?: never;
15
+ } | {
16
+ name: string;
17
+ command: string;
18
+ examples: {
19
+ description: string;
20
+ input: {
21
+ logo: string;
22
+ colors: {
23
+ primary: string;
24
+ background: string;
25
+ text: string;
26
+ };
27
+ font: string;
28
+ };
29
+ }[];
30
+ card?: never;
31
+ images?: never;
32
+ } | {
33
+ name: string;
34
+ command: string;
35
+ examples: {
36
+ description: string;
37
+ input: {
38
+ url: string;
39
+ file: string;
40
+ narration: string;
41
+ steps: ({
42
+ do: string;
43
+ target: string;
44
+ text: string;
45
+ atLine: number;
46
+ } | {
47
+ do: string;
48
+ target: string;
49
+ atLine: number;
50
+ text?: never;
51
+ })[];
52
+ };
53
+ }[];
54
+ card?: never;
55
+ images?: never;
56
+ } | {
57
+ name: string;
58
+ command: string;
59
+ examples: {
60
+ description: string;
61
+ input: {
62
+ text: string;
63
+ file: string;
64
+ tone: string;
65
+ speed: number;
66
+ };
67
+ }[];
68
+ card?: never;
69
+ images?: never;
70
+ } | {
71
+ name: string;
72
+ command: string;
73
+ examples: {
74
+ description: string;
75
+ input: {
76
+ lines: {
77
+ take: string;
78
+ text: string;
79
+ }[];
80
+ file: string;
81
+ };
82
+ }[];
83
+ card?: never;
84
+ images?: never;
85
+ } | {
86
+ name: string;
87
+ command: string;
88
+ card: string;
89
+ examples: {
90
+ description: string;
91
+ input: {
92
+ file: string;
93
+ extraSizes: {
94
+ width: number;
95
+ height: number;
96
+ }[];
97
+ scenes: ({
98
+ clip: string;
99
+ narration: string;
100
+ transition: {
101
+ kind: string;
102
+ };
103
+ overlays?: never;
104
+ } | {
105
+ clip: string;
106
+ narration: string;
107
+ overlays: {
108
+ kind: string;
109
+ step: number;
110
+ text: string;
111
+ fromMs: number;
112
+ toMs: number;
113
+ }[];
114
+ transition?: never;
115
+ })[];
116
+ };
117
+ }[];
118
+ images?: never;
119
+ } | {
120
+ name: string;
121
+ command: string;
122
+ images: true;
123
+ examples: {
124
+ description: string;
125
+ input: {
126
+ file: string;
127
+ };
128
+ }[];
129
+ card?: never;
130
+ })[];
131
+ };
132
+ //# sourceMappingURL=connector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D1B,CAAC"}
@@ -0,0 +1,63 @@
1
+ // The `video` connector (plan 16 §16.1 and §16.3; ADR 0107, 11; ADR 0115, 55): `optIn`, so a chat has it only after
2
+ // `/video`. Each command has one example of what it takes.
3
+ export const connectorName = 'video';
4
+ export const videoConnector = {
5
+ name: connectorName,
6
+ optIn: true,
7
+ description: "Make any kind of video: record websites and HTML pages you write, use the person's images and clips and licensed ones from the web, narrate a script or have the person record it, and compose them with camera moves, transitions, captions, and sound into an MP4. Use it when the person asks for a video of any kind.",
8
+ commands: [
9
+ { name: 'check', command: 'kvvideo.setup.get', examples: [{ description: 'See what is ready before making a video', input: {} }] },
10
+ { name: 'fonts', command: 'kvvideo.font.list', examples: [{ description: 'List the bundled caption fonts', input: {} }] },
11
+ { name: 'brand', command: 'kvvideo.brand.get', examples: [{ description: "Read the workspace's brand", input: {} }] },
12
+ {
13
+ name: 'brand-set',
14
+ command: 'kvvideo.brand.set',
15
+ examples: [{ description: 'Save the brand the person agreed to', input: { logo: 'brand/logo.svg', colors: { primary: '#2563EB', background: '#0F172A', text: '#F8FAFC' }, font: 'Poppins' } }],
16
+ },
17
+ {
18
+ name: 'record',
19
+ command: 'kvvideo.clip.record',
20
+ examples: [
21
+ {
22
+ description: 'Record signing in to an app, each action as the narration says it',
23
+ input: { url: 'http://localhost:5173/', file: 'videos/tour/01.mp4', narration: 'videos/tour/01.mp3', steps: [{ do: 'type', target: 'role=textbox[name="Email"]', text: 'sam@example.com', atLine: 1 }, { do: 'click', target: 'role=button[name="Sign in"]', atLine: 2 }] },
24
+ },
25
+ ],
26
+ },
27
+ {
28
+ name: 'narrate',
29
+ command: 'kvvideo.narration.make',
30
+ examples: [{ description: "Narrate a scene's script, warm and a little slower", input: { text: 'This is Notes. Sign in with your email to see your notes.', file: 'videos/tour/01.mp3', tone: 'warm and friendly', speed: 0.95 } }],
31
+ },
32
+ {
33
+ name: 'voice',
34
+ command: 'kvvideo.voice.make',
35
+ examples: [{ description: "Make a scene's narration from the person's takes", input: { lines: [{ take: 'videos/tour/voice-1/line-1.webm', text: 'This is Notes.' }, { take: 'videos/tour/voice-1/line-2.webm', text: 'Sign in with your email.' }], file: 'videos/tour/01.mp3' } }],
36
+ },
37
+ {
38
+ name: 'compose',
39
+ command: 'kvvideo.video.compose',
40
+ card: 'kvvideo.player',
41
+ examples: [
42
+ {
43
+ description: 'Compose a title page and a narrated recording, with a callout, a slide, and a phone version',
44
+ input: {
45
+ file: 'videos/tour.mp4',
46
+ extraSizes: [{ width: 1080, height: 1920 }],
47
+ scenes: [
48
+ { clip: 'videos/tour/00-title.mp4', narration: 'videos/tour/00.mp3', transition: { kind: 'slide' } },
49
+ { clip: 'videos/tour/01.mp4', narration: 'videos/tour/01.mp3', overlays: [{ kind: 'callout', step: 2, text: 'Sign in here', fromMs: 1500, toMs: 4000 }] },
50
+ ],
51
+ },
52
+ },
53
+ ],
54
+ },
55
+ {
56
+ name: 'review',
57
+ command: 'kvvideo.video.review',
58
+ images: true,
59
+ examples: [{ description: 'Look over a composed video before telling the person it is ready', input: { file: 'videos/tour.mp4' } }],
60
+ },
61
+ ],
62
+ };
63
+ //# sourceMappingURL=connector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,2DAA2D;AAE3D,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,IAAa;IACpB,WAAW,EACT,2TAA2T;IAC7T,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QAClI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QACzH,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QACrH;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;SAC/L;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,mEAAmE;oBAChF,KAAK,EAAE,EAAE,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE;iBAC5Q;aACF;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,2DAA2D,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;SACpO;QACD;YACE,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC;SACpR;QACD;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,6FAA6F;oBAC1G,KAAK,EAAE;wBACL,IAAI,EAAE,iBAAiB;wBACvB,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;wBAC3C,MAAM,EAAE;4BACN,EAAE,IAAI,EAAE,0BAA0B,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;4BACpG,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE;yBAC1J;qBACF;iBACF;aACF;SACF;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sBAAsB;YAC/B,MAAM,EAAE,IAAa;YACrB,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,kEAAkE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,CAAC;SACpI;KACF;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** A workspace file as an answer names it: relative to the workspace, with `/` on every OS. */
2
+ export declare function answerPath(root: string, absolute: string): string;
3
+ //# sourceMappingURL=answer-path.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answer-path.d.ts","sourceRoot":"","sources":["../../src/files/answer-path.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE"}
@@ -0,0 +1,6 @@
1
+ import path from 'node:path';
2
+ /** A workspace file as an answer names it: relative to the workspace, with `/` on every OS. */
3
+ export function answerPath(root, absolute) {
4
+ return path.relative(root, absolute).split(path.sep).join('/');
5
+ }
6
+ //# sourceMappingURL=answer-path.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answer-path.js","sourceRoot":"","sources":["../../src/files/answer-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC"}
@@ -0,0 +1,8 @@
1
+ /** A temporary folder for one call's work, deleted with `remove`. */
2
+ export declare function workFolder(): {
3
+ folder: string;
4
+ remove(): void;
5
+ };
6
+ /** Puts a finished file at its output path. */
7
+ export declare function placeOutput(made: string, output: string): void;
8
+ //# sourceMappingURL=place-output.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"place-output.d.ts","sourceRoot":"","sources":["../../src/files/place-output.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,wBAAgB,UAAU,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CAG/D;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9D"}
@@ -0,0 +1,24 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { copyFileSync, mkdtempSync, renameSync, rmSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import path from 'node:path';
5
+ // Outputs are made in a temporary folder and placed beside their path under a temporary name, then renamed over it,
6
+ // so a failed call leaves no file and the old one in place (plan 16 §16.3). The temporary folder may be on another
7
+ // disk, so the file is copied beside its path first.
8
+ /** A temporary folder for one call's work, deleted with `remove`. */
9
+ export function workFolder() {
10
+ const folder = mkdtempSync(path.join(tmpdir(), 'kvvideo-'));
11
+ return { folder, remove: () => rmSync(folder, { recursive: true, force: true }) };
12
+ }
13
+ /** Puts a finished file at its output path. */
14
+ export function placeOutput(made, output) {
15
+ const beside = path.join(path.dirname(output), `.${path.basename(output)}.${randomUUID()}.tmp`);
16
+ try {
17
+ copyFileSync(made, beside);
18
+ renameSync(beside, output);
19
+ }
20
+ finally {
21
+ rmSync(beside, { force: true });
22
+ }
23
+ }
24
+ //# sourceMappingURL=place-output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"place-output.js","sourceRoot":"","sources":["../../src/files/place-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,oHAAoH;AACpH,mHAAmH;AACnH,qDAAqD;AAErD,qEAAqE;AACrE,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}