@kvman/kvvideo 0.1.0 → 0.1.1

package/dist/ui.js

@@ -1,5 +1,5 @@
 import { z } from '@kvman/sdk';
-// kvvideo's configuration on its extension page (plan 16 §16.2): three cards of setting rows, and nothing else. The
+// kvvideo's configuration on its extension page (plan 16 §16.2): four cards of setting rows, and nothing else. The
 // keys' secrets are added in the page's own Secrets section (plan 06 §6.6).
 const settings = (keys) => keys.map((key) => ({ type: 'setting', key }));
 const configuration = {
@@ -7,7 +7,8 @@ const configuration = {
     direction: 'vertical',
     gap: 'md',
     children: [
-        { type: 'card', title: 'kvvideo.config.narration', children: settings(['kvvideo.narration.service', 'kvvideo.narration.voice', 'kvvideo.narration.model']) },
+        { type: 'card', title: 'kvvideo.config.narration', children: settings(['kvvideo.narration.service', 'kvvideo.narration.voice', 'kvvideo.narration.model', 'kvvideo.narration.pronunciations']) },
+        { type: 'card', title: 'kvvideo.config.brand', children: settings(['kvvideo.brand']) },
         { type: 'card', title: 'kvvideo.config.recording', children: settings(['kvvideo.browser']) },
         { type: 'card', title: 'kvvideo.config.programs', children: settings(['kvvideo.programs.ffmpeg', 'kvvideo.programs.ffprobe', 'kvvideo.programs.piper']) },
     ],

package/dist/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,oHAAoH;AACpH,4EAA4E;AAE5E,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE5F,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,UAAU;IACrB,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,2BAA2B,EAAE,yBAAyB,EAAE,yBAAyB,CAAC,CAAC,EAAE;QAC5J,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE;QAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,CAAC,CAAC,EAAE;KAC1J;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAE1K,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,GAAG,CAAC,aAAa,CAAC,gBAAgB,EAAE;QAClC,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,mHAAmH;AACnH,4EAA4E;AAE5E,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE5F,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,UAAU;IACrB,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,2BAA2B,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,kCAAkC,CAAC,CAAC,EAAE;QAChM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,EAAE;QACtF,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE;QAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,CAAC,CAAC,EAAE;KAC1J;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAE1K,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,GAAG,CAAC,aAAa,CAAC,gBAAgB,EAAE;QAClC,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}

package/dist/web/components/player.css

@@ -1,2 +1,2 @@
-.kvvideo-player{padding:var(--kv-space-sm);border:1px solid var(--kv-color-border);border-radius:var(--kv-radius);background:var(--kv-color-surface);max-inline-size:640px;margin:0}.kvvideo-player-head{gap:var(--kv-space-sm);color:var(--kv-color-muted);justify-content:space-between;padding-block-end:var(--kv-space-sm);font-size:.85em;display:flex}.kvvideo-player-file{text-overflow:ellipsis;white-space:nowrap;font-family:var(--kv-font-mono);overflow:hidden}.kvvideo-player-video{border-radius:calc(var(--kv-radius) / 2);background:#000;max-block-size:360px;inline-size:100%;display:block}.kvvideo-player-unavailable{color:var(--kv-color-text);margin:0}
+.kvvideo-player{padding:var(--kv-space-sm);border:1px solid var(--kv-color-border);border-radius:var(--kv-radius);background:var(--kv-color-surface);max-inline-size:640px;margin:0}.kvvideo-player-head{gap:var(--kv-space-sm);color:var(--kv-color-muted);justify-content:space-between;padding-block-end:var(--kv-space-sm);font-size:.85em;display:flex}.kvvideo-player-file{text-overflow:ellipsis;white-space:nowrap;font-family:var(--kv-font-mono);overflow:hidden}.kvvideo-player-video{border-radius:calc(var(--kv-radius) / 2);background:#000;max-block-size:360px;inline-size:100%;display:block}.kvvideo-player-unavailable{color:var(--kv-color-text);margin:0}.kvvideo-player-others{color:var(--kv-color-muted);font-family:var(--kv-font-mono);margin:0;padding-block-start:var(--kv-space-sm);padding-inline-start:0;font-size:.85em;list-style:none}
 /*$vite$:1*/

package/dist/web/components/player.js

@@ -1,43 +1,55 @@
-import { computed as e, createElementBlock as t, createElementVNode as n, defineComponent as r, inject as i, openBlock as a, ref as o, toDisplayString as s, unref as c } from "vue";
+import { Fragment as e, computed as t, createCommentVNode as n, createElementBlock as r, createElementVNode as i, defineComponent as a, inject as o, openBlock as s, ref as c, renderList as l, toDisplayString as u, unref as d } from "vue";
 //#region web/components/player.vue?vue&type=script&setup=true&lang.ts
-var l = {
+var f = {
 	class: "kvvideo-player",
 	"data-test": "player"
-}, u = { class: "kvvideo-player-head" }, d = {
+}, p = { class: "kvvideo-player-head" }, m = {
 	class: "kvvideo-player-file",
 	dir: "auto",
 	"data-test": "file"
-}, f = {
+}, h = {
 	class: "kvvideo-player-length",
 	dir: "ltr",
 	"data-test": "length"
-}, p = ["src"], m = {
+}, g = ["src", "poster"], _ = {
 	key: 1,
 	class: "kvvideo-player-unavailable",
 	"data-test": "unavailable"
-}, h = /* @__PURE__ */ r({
+}, v = {
+	key: 2,
+	class: "kvvideo-player-others",
+	"data-test": "others"
+}, y = /* @__PURE__ */ a({
 	__name: "player",
 	props: {
 		payload: {},
 		output: {}
 	},
-	setup(r) {
-		let h = r, g = i("kvman");
-		if (g === void 0) throw Error("kvvideo components run inside kvwebui, which provides kvman.");
-		let { t: _, workspace: v } = g, y = o(!1), b = e(() => typeof h.output.file == "string" ? h.output.file : ""), x = e(() => typeof h.output.fileId == "string" ? h.output.fileId : void 0), S = e(() => x.value === void 0 ? void 0 : `/api/files/${encodeURIComponent(x.value)}?workspaceId=${encodeURIComponent(v.value.id)}`), C = e(() => {
-			let e = Math.round((typeof h.output.durationMs == "number" ? h.output.durationMs : 0) / 1e3);
+	setup(a) {
+		let y = a, b = o("kvman");
+		if (b === void 0) throw Error("kvvideo components run inside kvwebui, which provides kvman.");
+		let { t: x, workspace: S } = b, C = c(!1), w = t(() => typeof y.output.file == "string" ? y.output.file : ""), T = t(() => typeof y.output.fileId == "string" ? y.output.fileId : void 0), E = (e) => `/api/files/${encodeURIComponent(e)}?workspaceId=${encodeURIComponent(S.value.id)}`, D = t(() => T.value === void 0 ? void 0 : E(T.value)), O = t(() => typeof y.output.posterFileId == "string" ? E(y.output.posterFileId) : void 0), k = t(() => Array.isArray(y.output.others) ? y.output.others.flatMap((e) => typeof e == "object" && e && "file" in e && typeof e.file == "string" ? [e.file] : []) : []), A = t(() => {
+			let e = Math.round((typeof y.output.durationMs == "number" ? y.output.durationMs : 0) / 1e3);
 			return `${String(Math.floor(e / 60))}:${String(e % 60).padStart(2, "0")}`;
 		});
-		return (e, r) => (a(), t("figure", l, [n("figcaption", u, [n("span", d, s(b.value), 1), n("span", f, s(C.value), 1)]), S.value !== void 0 && !y.value ? (a(), t("video", {
-			key: 0,
-			class: "kvvideo-player-video",
-			"data-test": "video",
-			src: S.value,
-			controls: "",
-			preload: "metadata",
-			onError: r[0] ||= (e) => y.value = !0
-		}, null, 40, p)) : (a(), t("p", m, s(c(_)("kvvideo.player.unavailable", { file: b.value })), 1))]));
+		return (t, a) => (s(), r("figure", f, [
+			i("figcaption", p, [i("span", m, u(w.value), 1), i("span", h, u(A.value), 1)]),
+			D.value !== void 0 && !C.value ? (s(), r("video", {
+				key: 0,
+				class: "kvvideo-player-video",
+				"data-test": "video",
+				src: D.value,
+				poster: O.value,
+				controls: "",
+				preload: "metadata",
+				onError: a[0] ||= (e) => C.value = !0
+			}, null, 40, g)) : (s(), r("p", _, u(d(x)("kvvideo.player.unavailable", { file: w.value })), 1)),
+			k.value.length > 0 ? (s(), r("ul", v, [(s(!0), r(e, null, l(k.value, (e) => (s(), r("li", {
+				key: e,
+				dir: "auto"
+			}, u(e), 1))), 128))])) : n("v-if", !0)
+		]));
 	}
 });
 //#endregion
-export { h as default };
+export { y as default };

package/docs/guide.md

@@ -1,16 +1,28 @@
-You can make videos with the `video` connector: tutorials that show how to use the person's app, demos, and promotional videos. A video is composed from pages of an app running on this computer, recorded in the installed browser, a narration of your script, and captions burned into the picture.
+You can make any kind of video with the `video` connector: a lesson, an explainer, a tutorial of an app or a website, a promotion, an announcement, a story, a social clip. A video is composed, not generated: websites and HTML pages you write, recorded in the installed browser; the person's images and clips, and licensed ones from the web; a narration from a voice service or recorded by the person; captions; joined with ffmpeg. Make it polished unless the person asks otherwise: the script's "Look and sound" section lists your choices, and the person's agreement to the script covers them.
 
-How to make one:
+How a good video is made:
 
-1. Run `video check` first. When something is missing, tell the person in plain words what to install or set, and stop until it is there: ffmpeg (with libass) from https://ffmpeg.org/download.html; Google Chrome or Microsoft Edge; a narration service chosen on kvvideo's extension page, with its key added there as a secret (`elevenlabs.apiKey` or `openai.apiKey`), or Piper (`pip install piper-tts`) with a voice file.
-2. Make sure the app runs: start its dev server in the background with `shell`, and use its localhost address. Only pages on this computer can be recorded.
-3. Write the script as a Markdown artifact: one section per scene, each with its narration and what is on screen. Keep scenes short, a few sentences each. Have the person agree to it before you narrate, since narration with ElevenLabs or OpenAI costs money.
-4. For each scene, run `narrate` first: its answer has the narration's length and its captions. Then `record` the scene, with `wait` steps so the picture lasts about as long as the narration; each step's `atMs` says when it happened.
-5. Run `compose` last, with each scene's clip, narration, and captions. Tell the person where the file is; the chat shows a player.
+- **Story.** Fit the video to its kind, purpose, and audience: a lesson teaches step by step, a promotion leads to its offer, a story has its arc, a social clip hooks in its first seconds. Open with what the viewer gets, keep one idea per scene in a logical order, and end with the next step or a call to action. Show rather than tell: the narration explains what the picture can't, and on-screen text is a few words. No filler, repetition, or long still shots; scenes of 3 to 12 s unless the content needs more.
+- **Look.** Use the workspace's brand (`video brand`). For the first video, take the colours, font, and logo from what the person gave or what the video is about (their app's or site's styles, their logo file), or design them for the video; list them in the script and save them with `video brand-set` once the person agrees. Keep colours, type, and style the same in every scene. Design each HTML scene with a clear hierarchy, alignment, contrast, and space, and keep important things inside the middle 90% of the frame. Draw titles, diagrams, charts, and illustrations as HTML, CSS, and SVG pages, and use the person's images and clips and licensed ones from the web for what drawing can't show; never generate images. Show a recorded website in a `window` frame, a phone site in a `phone` frame.
+- **Motion.** Let `record` and `compose` move the pointer and the camera. In an HTML scene, animate with eased motion (an ease-out entrance of 300 to 600 ms, never linear), one thing moving at a time, and kinetic text only for the key words. Use `crossfade` between scenes, `slide` for a step forward in a sequence, and `fade-black` before the ending.
+- **Text.** Short, correctly spelled, readable on its background, and in the video's language. Arabic text reads right to left in an Arabic font, with `dir="auto"` on every text element of an HTML scene.
+- **Sound.** Narration in a clear, natural voice whose `tone` and `speed` fit the purpose; names said right through the pronunciation list (`kvvideo.narration.pronunciations`). Sound effects stay on unless the person asks otherwise. There is no music.
+- **Accuracy and licences.** Say only what is true: what the person gave, what was recorded, or what a source read through a connector says; no invented numbers, features, quotes, or claims. Blur emails, keys, names, and other personal data on screen. A font, library, image, or clip from the web is used only under a licence that allows it, saved in the video's folder, with its source and licence written in the script and its credit in the end scene when the licence asks for one; pin a library's exact version.
+- **Review.** Before telling the person the video is ready, run `video review` and look at every sheet for typos, cut-off or overlapping text, bad zooms, and empty frames; fix what is wrong, and compose again.
+
+The steps:
+
+1. Run `video check`. When something is missing, tell the person in plain words what to install or set, and stop until it is there: ffmpeg (with libass and libfreetype) from https://ffmpeg.org/download.html; Google Chrome or Microsoft Edge; a narration service chosen on kvvideo's extension page, with its key added there as a secret (`elevenlabs.apiKey` or `openai.apiKey`), or Piper (`pip install piper-tts`) with a voice file.
+2. Gather what the video uses: the person's files, the sources its facts come from, and licensed media from the web. When it shows an app of the workspace, start the app in the background with `shell` and use its local address.
+3. Write the script as a Markdown artifact: a "Look and sound" section (the shapes, the brand, the framing, the caption style, the transitions, the sound effects, and the voice: generated, with its service, tone, and speed, or recorded by the person, with what the examples cost), then one section per scene with its narration and what is on screen, then the media from the web with their sources and licences. Have the person agree to it before anything is narrated, since narration with ElevenLabs or OpenAI costs money.
+4. For each scene, make the narration first: `narrate`; or, for the person's own voice, `narrate` each sentence as an example, `ask record` with one card per scene (each sentence a line, with the words to stress and where to pause), and `voice` with the takes it answers.
+5. Write each HTML scene, then `record` each website and HTML scene with its `narration`, starting each action at its caption line with `atLine`. An image or a clip goes to `compose` as it is.
+6. `compose`, then `review`, fix, and compose again. Tell the person where the file is; the chat shows a player.
 
 Rules:
 
-- Narrate a scene again only when its text changed.
+- A chat without `ask` (Decide for me) can't record the person's voice: use a generated one, and say so in the script.
+- Narrate a sentence again only when it changed; the cache makes an unchanged one free.
 - Put the parts of a video in their own folder, such as `videos/<name>/`, and the video beside it.
-- When the person asks for a font, find it on the web, save its .ttf or .otf file in the workspace, and name that file in `compose`'s `captions.font`. `video fonts` lists the bundled ones.
+- When the person asks for a font, find it on the web, save its `.ttf` or `.otf` file in the workspace, and name that file.
 - A target in `record` is a Playwright selector: prefer `role=button[name="Save"]` or `text=Save` to CSS classes.

package/locales/ar.json

@@ -33,5 +33,16 @@
   "kvvideo.errors.NARRATION_KEY_MISSING": "مفتاح {service} مفقود: أضف السر {secret} في صفحة إضافة kvvideo.",
   "kvvideo.errors.NARRATION_FAILED": "تعذّر على {service} التعليق الصوتي: {reason}",
   "kvvideo.errors.RENDER_FAILED": "تعذّر على ffmpeg صنع الفيديو: {reason}",
-  "kvvideo.player.unavailable": "لا يمكن تشغيل هذا الفيديو هنا. افتح {file} في مساحة العمل."
+  "kvvideo.player.unavailable": "لا يمكن تشغيل هذا الفيديو هنا. افتح {file} في مساحة العمل.",
+  "kvvideo.progress.step": "تسجيل الخطوة {n} من {of}",
+  "kvvideo.narration.pronunciations.title": "النطق",
+  "kvvideo.narration.pronunciations.description": "كلمات يُنطق بها الراوي بطريقة مختلفة، في قائمة من { \"word\", \"say\" }: تُقرأ \"kvman\" كـ \"kay-vee-man\". تبقى الكلمة في الترجمة النصية كما كُتبت.",
+  "kvvideo.progress.sentence": "قراءة الجملة {n} من {of}",
+  "kvvideo.config.brand": "الهوية",
+  "kvvideo.brand.title": "الهوية",
+  "kvvideo.brand.description": "شعار فيديوهات مساحة العمل هذه وألوانها وخطها، بالصيغة { \"logo\", \"colors\": { \"primary\", \"background\", \"text\" }, \"font\" }. يقترحها الوكيل في نص الفيديو ويحفظها حين توافق.",
+  "kvvideo.progress.scene": "المشهد {n} من {of}",
+  "kvvideo.progress.final": "المرحلة الأخيرة، {percent}%",
+  "kvvideo.progress.sheet": "الورقة {n} من {of}",
+  "kvvideo.progress.take": "تنقية التسجيل {n} من {of}"
 }

package/locales/en.json

@@ -33,5 +33,16 @@
   "kvvideo.errors.NARRATION_KEY_MISSING": "The {service} key is missing: add the secret {secret} on kvvideo's extension page.",
   "kvvideo.errors.NARRATION_FAILED": "{service} couldn't narrate: {reason}",
   "kvvideo.errors.RENDER_FAILED": "ffmpeg couldn't make the video: {reason}",
-  "kvvideo.player.unavailable": "This video can't play here. Open {file} in the workspace."
+  "kvvideo.player.unavailable": "This video can't play here. Open {file} in the workspace.",
+  "kvvideo.progress.step": "Recording step {n} of {of}",
+  "kvvideo.narration.pronunciations.title": "Pronunciations",
+  "kvvideo.narration.pronunciations.description": "Words the narration says differently, as a list of { \"word\", \"say\" }: \"kvman\" said as \"kay-vee-man\". The captions keep the word as written.",
+  "kvvideo.progress.sentence": "Narrating sentence {n} of {of}",
+  "kvvideo.config.brand": "Brand",
+  "kvvideo.brand.title": "Brand",
+  "kvvideo.brand.description": "The logo, colours, and font of this workspace's videos, as { \"logo\", \"colors\": { \"primary\", \"background\", \"text\" }, \"font\" }. The agent proposes it in a video's script and saves it once you agree.",
+  "kvvideo.progress.scene": "Scene {n} of {of}",
+  "kvvideo.progress.final": "Final pass, {percent}%",
+  "kvvideo.progress.sheet": "Sheet {n} of {of}",
+  "kvvideo.progress.take": "Cleaning take {n} of {of}"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kvman/kvvideo",
-  "version": "0.1.0",
-  "description": "kvvideo: the kvcoder extension that makes videos of the person's app, recorded, narrated, and captioned.",
+  "version": "0.1.1",
+  "description": "kvvideo: the kvcoder extension that makes any kind of video, from websites and pages recorded in the browser, narrated, and captioned.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,8 @@
     "dist",
     "docs",
     "fonts",
-    "locales"
+    "locales",
+    "sounds"
   ],
   "peerDependencies": {
     "@kvman/sdk": "^0.1.5"
@@ -36,8 +37,8 @@
     "vue": "3.5.43"
   },
   "devDependencies": {
-    "@kvman/kvai": "0.1.8",
-    "@kvman/kvcoder": "0.1.16",
+    "@kvman/kvai": "0.1.9",
+    "@kvman/kvcoder": "0.1.20",
     "@kvman/kvwebui": "0.1.8",
     "@kvman/sdk": "0.1.5",
     "@kvman/testkit": "0.1.10",
@@ -60,6 +61,11 @@
         [
           "path"
         ]
+      ],
+      "narrations": [
+        [
+          "key"
+        ]
       ]
     }
   },

package/sounds/SOURCES.md

@@ -0,0 +1,13 @@
+# kvvideo's sound effects
+
+kvvideo made these four sounds itself with ffmpeg (plan 16 §16.8, ADR 0115, 62). They are released under CC0 1.0
+(public domain): https://creativecommons.org/publicdomain/zero/1.0/
+
+Each was made as 48 kHz mono 16-bit PCM from the source below, then turned up or down so its peak is −3 dBFS.
+
+| File | Length | Source (`ffmpeg -f lavfi -i <source> -af <filters> -ac 1 -ar 48000 -c:a pcm_s16le`) |
+|---|---|---|
+| `click.wav` | 45 ms | `aevalsrc='0.6*sin(2*PI*2400*t)*exp(-t*180)+0.4*(random(0)-0.5)*exp(-t*320)':d=0.045:s=48000`, filters `highpass=f=900` |
+| `keys.wav` | 2.07 s, a loop of key taps every 115 ms | `aevalsrc='(random(0)-0.5)*exp(-mod(t,0.115)*380)*(0.7+0.3*sin(2*PI*t*0.9))':d=2.07:s=48000`, filters `highpass=f=1800,lowpass=f=9000` |
+| `whoosh.wav` | 550 ms | `aevalsrc='(random(0)-0.5)*pow(sin(PI*t/0.55),2)':d=0.55:s=48000`, filters `highpass=f=250,lowpass=f=2600` |
+| `pop.wav` | 140 ms | `aevalsrc='0.9*sin(2*PI*(380*t+2600*t*t))*exp(-t*38)':d=0.14:s=48000`, filters `afade=t=in:d=0.004` |