@kvman/kvvideo 0.0.0-stage → 0.1.1

package/dist/web/components/player.js

@@ -0,0 +1,55 @@
+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 f = {
+	class: "kvvideo-player",
+	"data-test": "player"
+}, p = { class: "kvvideo-player-head" }, m = {
+	class: "kvvideo-player-file",
+	dir: "auto",
+	"data-test": "file"
+}, h = {
+	class: "kvvideo-player-length",
+	dir: "ltr",
+	"data-test": "length"
+}, g = ["src", "poster"], _ = {
+	key: 1,
+	class: "kvvideo-player-unavailable",
+	"data-test": "unavailable"
+}, v = {
+	key: 2,
+	class: "kvvideo-player-others",
+	"data-test": "others"
+}, y = /* @__PURE__ */ a({
+	__name: "player",
+	props: {
+		payload: {},
+		output: {}
+	},
+	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 (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 { y as default };

package/docs/guide.md

@@ -0,0 +1,28 @@
+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 a good video is made:
+
+- **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:
+
+- 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.
+- A target in `record` is a Playwright selector: prefer `role=button[name="Save"]` or `text=Save` to CSS classes.

package/fonts/OFL-Amiri.txt

@@ -0,0 +1,94 @@
+Copyright 2010-2022 The Amiri Project Authors (https://github.com/aliftype/amiri).
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org/
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+

package/fonts/OFL-IBMPlexSansArabic.txt

@@ -0,0 +1,93 @@
+Copyright © 2017 IBM Corp. with Reserved Font Name "Plex"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/fonts/OFL-Lato.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2010-2014 by tyPoland Lukasz Dziedzic (team@latofonts.com) with Reserved Font Name "Lato"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/fonts/OFL-Poppins.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Poppins Project Authors (https://github.com/itfoundry/Poppins)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/locales/ar.json

@@ -0,0 +1,48 @@
+{
+  "kvvideo.title": "kvman video",
+  "kvvideo.slash.video": "اصنع فيديوهات في هذه المحادثة",
+  "kvvideo.slash.video.message": "أريد صنع فيديو.",
+  "kvvideo.video.started": "صنع الفيديوهات مفعّل في هذه المحادثة",
+  "kvvideo.config.narration": "التعليق الصوتي",
+  "kvvideo.config.recording": "التسجيل",
+  "kvvideo.config.programs": "البرامج",
+  "kvvideo.narration.service.title": "خدمة التعليق الصوتي",
+  "kvvideo.narration.service.description": "خدمة تحويل النص إلى كلام التي تقرأ نصوصك. تحتاج ElevenLabs وOpenAI إلى مفتاحهما، يُضاف أدناه سرًّا؛ ويعمل Piper على هذا الجهاز مجانًا.",
+  "kvvideo.narration.service.options.elevenlabs": "ElevenLabs (نحو 0.05–0.09 دولار للدقيقة)",
+  "kvvideo.narration.service.options.openai": "OpenAI (نحو 0.015 دولار للدقيقة)",
+  "kvvideo.narration.service.options.piper": "Piper (مجاني، على هذا الجهاز)",
+  "kvvideo.narration.voice.title": "الصوت",
+  "kvvideo.narration.voice.description": "معرّف صوت لـ ElevenLabs أو OpenAI، أو مسار ملف ‎.onnx‎ لصوت Piper. الفراغ يستخدم الصوت الافتراضي للخدمة.",
+  "kvvideo.narration.model.title": "النموذج",
+  "kvvideo.narration.model.description": "نموذج ElevenLabs أو OpenAI الذي يتكلم. الفراغ يستخدم النموذج الافتراضي للخدمة.",
+  "kvvideo.browser.title": "المتصفح",
+  "kvvideo.browser.description": "المتصفح المثبّت الذي يسجّل الصفحات.",
+  "kvvideo.browser.options.auto": "Chrome، وإلا Edge",
+  "kvvideo.browser.options.chrome": "Google Chrome",
+  "kvvideo.browser.options.msedge": "Microsoft Edge",
+  "kvvideo.programs.ffmpeg.title": "ffmpeg",
+  "kvvideo.programs.ffmpeg.description": "برنامج ffmpeg الذي يجمع الفيديوهات: اسم في PATH، أو مسار كامل.",
+  "kvvideo.programs.ffprobe.title": "ffprobe",
+  "kvvideo.programs.ffprobe.description": "برنامج ffprobe الذي يقيس الفيديو والصوت: اسم في PATH، أو مسار كامل.",
+  "kvvideo.programs.piper.title": "Piper",
+  "kvvideo.programs.piper.description": "برنامج Piper الذي يعلّق صوتيًا على هذا الجهاز: اسم في PATH، أو مسار كامل.",
+  "kvvideo.errors.PROGRAM_MISSING": "تعذّر تشغيل {program}. ثبّته، أو حدّد مكانه في إعدادات kvvideo.",
+  "kvvideo.errors.BROWSER_MISSING": "تعذّر تشغيل أي متصفح مثبّت. ثبّت Google Chrome أو Microsoft Edge.",
+  "kvvideo.errors.STEP_FAILED": "فشلت الخطوة {step} من التسجيل: {reason}",
+  "kvvideo.errors.NARRATION_NOT_SET": "التعليق الصوتي غير مُعدّ: اختره في إعدادات kvvideo ({setting}).",
+  "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.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

@@ -0,0 +1,48 @@
+{
+  "kvvideo.title": "kvman video",
+  "kvvideo.slash.video": "Make videos in this chat",
+  "kvvideo.slash.video.message": "I want to make a video.",
+  "kvvideo.video.started": "Making videos is on for this chat",
+  "kvvideo.config.narration": "Narration",
+  "kvvideo.config.recording": "Recording",
+  "kvvideo.config.programs": "Programs",
+  "kvvideo.narration.service.title": "Narration service",
+  "kvvideo.narration.service.description": "The text-to-speech service that reads your scripts. ElevenLabs and OpenAI need their key, added below as a secret; Piper runs on this computer for free.",
+  "kvvideo.narration.service.options.elevenlabs": "ElevenLabs (about $0.05–0.09 a minute)",
+  "kvvideo.narration.service.options.openai": "OpenAI (about $0.015 a minute)",
+  "kvvideo.narration.service.options.piper": "Piper (free, on this computer)",
+  "kvvideo.narration.voice.title": "Voice",
+  "kvvideo.narration.voice.description": "A voice id for ElevenLabs or OpenAI, or the path of a Piper voice's .onnx file. Empty uses the service's default voice.",
+  "kvvideo.narration.model.title": "Model",
+  "kvvideo.narration.model.description": "The ElevenLabs or OpenAI model that speaks. Empty uses the service's default.",
+  "kvvideo.browser.title": "Browser",
+  "kvvideo.browser.description": "The installed browser that records pages.",
+  "kvvideo.browser.options.auto": "Chrome, else Edge",
+  "kvvideo.browser.options.chrome": "Google Chrome",
+  "kvvideo.browser.options.msedge": "Microsoft Edge",
+  "kvvideo.programs.ffmpeg.title": "ffmpeg",
+  "kvvideo.programs.ffmpeg.description": "The ffmpeg program that joins videos: a name on the PATH, or a full path.",
+  "kvvideo.programs.ffprobe.title": "ffprobe",
+  "kvvideo.programs.ffprobe.description": "The ffprobe program that measures videos and audio: a name on the PATH, or a full path.",
+  "kvvideo.programs.piper.title": "Piper",
+  "kvvideo.programs.piper.description": "The Piper program that narrates on this computer: a name on the PATH, or a full path.",
+  "kvvideo.errors.PROGRAM_MISSING": "{program} can't be started. Install it, or set where it is in kvvideo's configuration.",
+  "kvvideo.errors.BROWSER_MISSING": "No installed browser could start. Install Google Chrome or Microsoft Edge.",
+  "kvvideo.errors.STEP_FAILED": "Step {step} of the recording failed: {reason}",
+  "kvvideo.errors.NARRATION_NOT_SET": "Narration isn't set up: choose it in kvvideo's configuration ({setting}).",
+  "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.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,6 +1,76 @@
 {
   "name": "@kvman/kvvideo",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "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",
+    "url": "git+https://github.com/ibndeif/kvman.git",
+    "directory": "extensions/kvvideo"
+  },
+  "homepage": "https://github.com/ibndeif/kvman#readme",
+  "bugs": {
+    "url": "https://github.com/ibndeif/kvman/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "@kvman/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "fonts",
+    "locales",
+    "sounds"
+  ],
+  "peerDependencies": {
+    "@kvman/sdk": "^0.1.5"
+  },
+  "dependencies": {
+    "playwright-core": "1.63.0",
+    "vue": "3.5.43"
+  },
+  "devDependencies": {
+    "@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",
+    "@vitejs/plugin-vue": "6.0.9",
+    "@vue/test-utils": "2.5.1",
+    "happy-dom": "20.14.5",
+    "vite": "8.3.1",
+    "vue-tsc": "3.3.11"
+  },
+  "kvman": {
+    "namespace": "kvvideo",
+    "source": "src/index.ts",
+    "web": "dist/web",
+    "dependencies": {
+      "@kvman/kvcoder": "^0.1.2",
+      "@kvman/kvwebui": "^0.1.0"
+    },
+    "indexes": {
+      "players": [
+        [
+          "path"
+        ]
+      ],
+      "narrations": [
+        [
+          "key"
+        ]
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node web-build.config.ts",
+    "typecheck": "tsc -p tsconfig.json && vue-tsc -p tsconfig.web.json"
+  }
 }