[ { "path": ".gitignore", "content": "packages/**/LICENSE\n\n# Node\nnode_modules\ndist\ncoverage\ntsconfig.tsbuildinfo\n*.log\n\n# Configuration\n.env\n\n# Editors\n*.code-*\n*.sublime-*\n\n# Generated\nbundle.js\n\n# Operating system\n.DS_Store\n\n# static files\n*.mp4\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) Yuri Sulyma\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "README.md", "content": "# Liqvid\n\n[Liqvid](https://liqvidjs.org/) is a library for creating **interactive** videos in React.\n\n## Links\n\n[Documentation](https://liqvidjs.org/docs/)\n\n[Discord](https://discord.gg/u8Qab99zHx)\n\n## Repository structure\n\nThis is a monorepo. Here is what the various packages do:\n\n### Frontend Core\n\n* `main` \nProvides the main `liqvid` package.\n\n* `host` \nScript for pages hosting Liqvid videos; currently just handles [fake fullscreen](https://liqvidjs.org/docs/guide/mobile#fake-fullscreen)\n\n* `keymap` \nProvides the [`Keymap`](https://liqvidjs.org/docs/reference/Keymap) class\n\n* `playback` \nProvides the [`Playback`](https://liqvidjs.org/docs/reference/Playback) class\n\n* `polyfills` \nPolyfills for Liqvid videos; currently just handles [Web Animations](https://liqvidjs.org/docs/guide/mobile/#web-animations)\n\n* `utils` \nProvides the various helper functions in [`Utils`](https://liqvidjs.org/docs/reference/Utils/animation)\n\n### Backend Tools\n\n* `cli` \nThe Liqvid [CLI tool](https://liqvidjs.org/docs/cli/tool)\n\n* `magic` \nProvides wacky[resource macro](https://liqvidjs.org/docs/cli/macros) syntax\n\n* `renderer` \nHandles the [`audio`](https://liqvidjs.org/docs/cli/audio), [`build`](https://liqvidjs.org/docs/cli/build), [`render`](https://liqvidjs.org/docs/cli/render), and [`thumbs`](https://liqvidjs.org/docs/cli/thumbs) CLI commands\n\n* `serve` \nDevelopment server; provides the [`serve`](https://liqvidjs.org/docs/cli/tool) CLI command\n\n### Integrations\n\n* `katex` \nProvides [KaTeX integration](https://liqvidjs.org/docs/integrations/katex)\n\n* `react-three` \nProvides [React Three Fiber](https://liqvidjs.org/docs/integrations/three) integration\n\n### In-development\n\n* `captioning` \nCaptions editor\n\n* `gsap` \n[GSAP](https://greensock.com/gsap/) integration (maybe already works???)\n\n* `i18n` \nInternationalization utilities\n\n* `player` \nNew Web Components-based ``\n\n* `mathjax` \n[MathJax](https://www.mathjax.org/) integration\n\n* `react` \nProbably for when Liqvid goes to Web Components (v3)\n\n* `xyjax` \n[XyJax](https://github.com/sonoisa/XyJax-v3/) integration\n" }, { "path": "biome.json", "content": "{\n \"$schema\": \"https://biomejs.dev/schemas/2.3.8/schema.json\",\n \"assist\": {\n \"actions\": {\n \"source\": {\n \"organizeImports\": {\n \"level\": \"on\",\n \"options\": {\n \"groups\": [\n \":NODE:\",\n \":BLANK_LINE:\",\n\n \":PACKAGE:\",\n \":BLANK_LINE:\",\n\n \":ALIAS:\",\n \":BLANK_LINE:\",\n\n [\"../**\", \"!**/*.css\", \"!**/*.json\", \"!**/*.scss\"],\n \":BLANK_LINE:\",\n\n [\"./**\", \"!**/*.css\", \"!**/*.json\", \"!**/*.scss\"],\n \":BLANK_LINE:\",\n\n [\"**/*.css\", \"**/*.scss\"],\n \":BLANK_LINE:\",\n\n \"**/*.json\"\n ]\n }\n },\n \"useSortedAttributes\": \"on\",\n \"useSortedKeys\": \"on\"\n }\n }\n },\n \"css\": {\n \"parser\": {\n \"tailwindDirectives\": true\n }\n },\n \"files\": {\n \"ignoreUnknown\": false,\n \"includes\": [\n \"**\",\n \"!build\",\n \"!**/dist\",\n \"!**/package.json\",\n \"!**/package-lock.json\",\n \"!**/node_modules\",\n \"!public/vendor/mathjax/*\",\n \"!**/recordings/*.json\",\n \"!**/recordings.json\",\n \"!**/bundle.js\"\n ]\n },\n \"formatter\": {\n \"attributePosition\": \"auto\",\n \"bracketSpacing\": true,\n \"enabled\": true,\n \"formatWithErrors\": false,\n \"indentStyle\": \"space\",\n \"indentWidth\": 2,\n \"lineEnding\": \"lf\",\n \"lineWidth\": 80,\n \"useEditorconfig\": true\n },\n \"javascript\": {\n \"formatter\": {\n \"arrowParentheses\": \"always\",\n \"attributePosition\": \"auto\",\n \"bracketSameLine\": false,\n \"bracketSpacing\": true,\n \"jsxQuoteStyle\": \"double\",\n \"quoteProperties\": \"asNeeded\",\n \"quoteStyle\": \"double\",\n \"semicolons\": \"always\",\n \"trailingCommas\": \"all\"\n }\n },\n \"linter\": {\n \"enabled\": true,\n \"rules\": {\n \"correctness\": {\n \"useExhaustiveDependencies\": \"error\",\n \"useUniqueElementIds\": \"off\"\n },\n \"nursery\": {\n \"useSortedClasses\": {\n \"fix\": \"safe\",\n \"level\": \"info\",\n \"options\": {\n \"functions\": [\"clsx\", \"cva\", \"tw\", \"classNames\"]\n }\n }\n },\n \"recommended\": true,\n \"style\": {\n \"useTemplate\": \"off\"\n },\n \"suspicious\": {\n \"noUnknownAtRules\": \"off\"\n }\n }\n },\n \"vcs\": {\n \"clientKind\": \"git\",\n \"enabled\": false,\n \"useIgnoreFile\": true\n }\n}\n" }, { "path": "build.mjs", "content": "/* Horrifying fixer-upper for ESM imports */\nimport * as fs from \"fs\";\nimport {existsSync, promises as fsp, readFileSync} from \"fs\";\nimport * as path from \"path\";\n\nconst DIST = path.join(process.cwd(), \"dist\");\nconst NODE_MODULES = path.join(process.cwd(), \"node_modules\");\n\nbuild();\n\nasync function build() {\n for (const type of [\"esm\", \"cjs\"]) {\n const dir = path.join(DIST, type);\n const extn = type === \"esm\" ? \"mjs\" : \"cjs\";\n\n // rename files first\n await walkDir(dir, async (filename) => {\n if (!filename.endsWith(\".js\")) return;\n await renameExtension(filename, extn);\n });\n\n // now fix imports\n await walkDir(dir, async (filename) => {\n if (!filename.endsWith(`.${extn}`)) return;\n await fixImports(filename, type);\n });\n }\n}\n\n/**\n * Recursively walk a directory\n * @param {string} dirname Name of directory to walk\n * @param {(filename: string) => Promise} callback Callback\n */\nasync function walkDir(dirname, callback) {\n const files = (await fsp.readdir(dirname)).map((filename) =>\n path.join(dirname, filename),\n );\n\n /* first rename all files */\n\n await Promise.all(\n files.map(async (filename) => {\n const stat = await fsp.stat(filename);\n if (stat.isDirectory()) {\n return walkDir(filename, callback);\n }\n await callback(filename);\n }),\n );\n}\n\n/**\n * Add extensions to relative imports\n * @param {string} filename File to operate on.\n * @param {\"esm\" | \"cjs\"} type Javascript module system in use.\n */\nasync function fixImports(filename, type = \"esm\") {\n let content = await fsp.readFile(filename, \"utf8\");\n const regex =\n type === \"esm\"\n ? /^((?:ex|im)port .+? from\\s+)([\"'])(.+?)(\\2;?)$/gm\n : /(require\\()(['\"])(.+?)(\\2\\))/gm;\n content = content.replaceAll(regex, (match, head, q, name, tail) => {\n // already has extension\n if (name.match(/\\.[cm]?js$/)) {\n return match;\n }\n\n // relative imports\n if (name.startsWith(\".\")) {\n // figure out which file it's referring to\n const target = findExtension(path.dirname(filename), name);\n return head + q + target + tail;\n } else {\n }\n return match;\n });\n\n await fsp.writeFile(filename, content);\n}\n\n/**\n * Find extension\n */\nfunction findExtension(pathname, relative) {\n const filename = path.resolve(pathname, relative);\n for (const extn of [\"mjs\", \"js\", \"cjs\"]) {\n const full = filename + \".\" + extn;\n\n if (existsSync(full)) {\n let rewrite = path.relative(pathname, full);\n if (!rewrite.startsWith(\".\")) {\n rewrite = \"./\" + rewrite;\n }\n return rewrite;\n }\n }\n throw new Error(`Could not resolve ${filename}`);\n}\n\n/**\n * Find package.json\n * @param {string} name Name of package.\n */\nfunction findPackageJson(name) {\n const packageName = getPackageName(name);\n let dirname = NODE_MODULES;\n while (true) {\n const filename = path.join(dirname, packageName, \"package.json\");\n if (fs.existsSync(filename)) return filename;\n dirname = path.normalize(path.join(dirname, \"..\"));\n if (dirname === \"/\")\n throw new Error(`Could not find package.json for ${name}`);\n }\n}\n\n/**\n * Get name of NPM package\n * @param {string} name Import string to resolve.\n */\nfunction getPackageName(name) {\n const parts = name.split(\"/\");\n if (name.startsWith(\"@\")) {\n return parts.slice(0, 2).join(\"/\");\n }\n return parts[0];\n}\n\n/**\n * Change file extension\n */\nasync function renameExtension(filename, extn = \"mjs\") {\n await fsp.rename(filename, filename.replace(/\\.js$/, `.${extn}`));\n}\n" }, { "path": "package.json", "content": "{\n \"name\": \"root\",\n \"private\": true,\n \"workspaces\": [\"packages/*\"],\n \"devDependencies\": {\n \"@babel/core\": \"^7.17.10\",\n \"@babel/plugin-transform-modules-umd\": \"^7.16.7\",\n \"@babel/preset-env\": \"^7.17.10\",\n \"@biomejs/biome\": \"1.9.4\",\n \"@playwright/experimental-ct-react\": \"^1.27.1\",\n \"@playwright/test\": \"^1.27.1\",\n \"@rollup/plugin-babel\": \"^5.3.1\",\n \"@rollup/plugin-commonjs\": \"^22.0.0\",\n \"@rollup/plugin-node-resolve\": \"^13.3.0\",\n \"@testing-library/dom\": \"^8.13.0\",\n \"@testing-library/react\": \"^13.2.0\",\n \"@testing-library/user-event\": \"^14.2.0\",\n \"@types/jest\": \"^27.5.1\",\n \"@types/node\": \"^22.10.10\",\n \"@types/react\": \"^18.0.9\",\n \"@types/react-dom\": \"^18.0.4\",\n \"concurrently\": \"^7.5.0\",\n \"dotenv\": \"^16.0.3\",\n \"jest\": \"^28.1.0\",\n \"jest-environment-jsdom\": \"^28.1.0\",\n \"playwright\": \"^1.27.1\",\n \"react\": \"^18.1.0\",\n \"react-dom\": \"^18.1.0\",\n \"rollup\": \"^2.73.0\",\n \"rollup-plugin-dts\": \"^4.2.1\",\n \"rollup-plugin-terser\": \"^7.0.2\",\n \"serve\": \"^14.1.1\",\n \"ts-jest\": \"^28.0.2\",\n \"ts-node\": \"^10.7.0\",\n \"typescript\": \"^5.7.3\"\n },\n \"overrides\": {\n \"@types/node\": \"^22.10.10\",\n \"yargs\": \"^17.7.2\",\n \"yargs-parser\": \"^21.1.1\"\n },\n \"packageManager\": \"pnpm@9.15.4+sha512.b2dc20e2fc72b3e18848459b37359a32064663e5627a51e4c74b2c29dd8e8e0491483c3abb40789cfd578bf362fb6ba8261b05f0387d76792ed6e23ea3b1b6a0\"\n}\n" }, { "path": "packages/captioning/README.md", "content": "# @liqvid/captioning\n\nThis package provides audio transcription and captioning utilities for [Liqvid](https://liqvidjs.org). It is used internally by [@liqvid/cli](../cli).\n" }, { "path": "packages/captioning/package.json", "content": "{\n \"name\": \"@liqvid/captioning\",\n \"version\": \"1.0.0\",\n \"description\": \"Audio transcription and captioning for Liqvid\",\n \"files\": [\"dist/*\"],\n \"main\": \"dist/index.js\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/liqvidjs/liqvid.git\"\n },\n \"author\": \"Yuri Sulyma \",\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/liqvidjs/liqvid/issues\"\n },\n \"homepage\": \"https://github.com/liqvidjs/liqvid/tree/main/packages/renderer#readme\",\n \"devDependencies\": {\n \"ibm-watson\": \"^6.2.1\"\n },\n \"peerDependencies\": {\n \"ibm-watson\": \"^6.2.1\"\n },\n \"peerDependenciesMeta\": {\n \"ibm-watson\": {\n \"optional\": true\n }\n }\n}\n" }, { "path": "packages/captioning/src/index.ts", "content": "export {transcribe} from \"./transcription\";\nexport {toWebVTT} from \"./webvtt\";\n" }, { "path": "packages/captioning/src/transcription.ts", "content": "import fs, {promises as fsp} from \"fs\";\nimport {IamAuthenticator} from \"ibm-watson/auth\";\nimport SpeechToTextV1 from \"ibm-watson/speech-to-text/v1\";\nimport path from \"path\";\nimport {toWebVTT} from \"./webvtt\";\n\n/**\n * Transcript with per-word timings\n */\nexport type Transcript = [string, number, number][][];\n\n/**\n * Transcribe audio file\n */\nexport async function transcribe(args: {\n /** Path to audio file */\n input: string;\n\n /** Path for WebVTT captions */\n captions: string;\n\n /** Params to pass to IBM Watson. */\n params: Partial[0]>;\n\n /** Path for rich transcript */\n transcript: string;\n\n /** IBM Cloud API key */\n apiKey: string;\n\n /** IBM Watson endpoint URL */\n apiUrl: string;\n}) {\n const filename = path.resolve(process.cwd(), args.input);\n const output = path.resolve(process.cwd(), args.transcript);\n\n const extn = path.extname(filename);\n\n // SpeechToText instance\n const speechToText = new SpeechToTextV1({\n authenticator: new IamAuthenticator({\n apikey: args.apiKey,\n }),\n serviceUrl: args.apiUrl,\n });\n\n const params = Object.assign(\n {\n audio: fs.createReadStream(filename),\n contentType: `audio/${extn.slice(1)}`,\n\n objectMode: true,\n model: \"en-US_BroadbandModel\",\n profanityFilter: false,\n smartFormatting: true,\n timestamps: true,\n },\n args.params,\n );\n\n // transcribe\n const {result: json} = await speechToText.recognize(params);\n await fsp.writeFile(args.transcript, JSON.stringify(json, null, 2));\n\n // format\n const blockSize = 8;\n const words = json.results\n .map((_) => _.alternatives[0].timestamps)\n .reduce((a, b) => a.concat(b), [] as [string, number, number][])\n .map(\n ([word, t1, t2]: [string, number, number]) =>\n [word, Math.floor(t1 * 1000), Math.floor(t2 * 1000)] as [\n string,\n number,\n number,\n ],\n );\n\n const blocks: Transcript = [];\n\n for (let i = 0; i < words.length; i += blockSize) {\n blocks.push(words.slice(i, i + blockSize));\n }\n\n // save new version\n let str = JSON.stringify(blocks, null, 2);\n str = str.replace(/(? \" +\n formatTimeMs(line[line.length - 1][2]),\n );\n captions.push(line.map((_) => _[0]).join(\" \"));\n captions.push(\"\");\n }\n\n return captions.join(\"\\n\");\n}\n\n/* WebVTT requires mm:ss whereas @liqvid/utils/time produces [m]m:ss */\nfunction formatTime(time: number): string {\n if (time < 0) {\n return \"-\" + formatTime(-time);\n }\n const minutes = Math.floor(time / 60 / 1000),\n seconds = Math.floor((time / 1000) % 60);\n\n return `${minutes.toString().padStart(2, \"0\")}:${seconds.toString().padStart(2, \"0\")}`;\n}\n\nfunction formatTimeMs(time: number): string {\n if (time < 0) {\n return \"-\" + formatTimeMs(-time);\n }\n const milliseconds = Math.floor(time % 1000);\n\n return `${formatTime(time)}.${milliseconds.toString().padStart(3, \"0\")}`;\n}\n" }, { "path": "packages/captioning/tsconfig.json", "content": "{\n \"extends\": \"../../tsconfig.json\",\n \"compilerOptions\": {\n \"composite\": true,\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\"\n },\n \"include\": [\"./src\"]\n}\n" }, { "path": "packages/cli/liqvid-cli.mjs", "content": "#! /usr/bin/env node\nimport * as pkg from \"./dist/index.mjs\";\n\npkg\n .main()\n .then(() => process.exit(0))\n .catch((err) => {\n // eslint-disable-next-line no-console\n console.error(err);\n process.exit(1);\n });\n" }, { "path": "packages/cli/package.json", "content": "{\n \"name\": \"@liqvid/cli\",\n \"version\": \"1.0.5\",\n \"description\": \"Liqvid command line utility\",\n \"main\": \"dist/index.js\",\n \"bin\": {\n \"liqvid\": \"liqvid-cli.mjs\"\n },\n \"files\": [\"dist/*\", \"liqvid-cli.mjs\"],\n \"sideEffects\": false,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/liqvidjs/liqvid.git\"\n },\n \"author\": \"Yuri Sulyma \",\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/liqvidjs/liqvid/issues\"\n },\n \"homepage\": \"https://github.com/liqvidjs/liqvid#readme\",\n \"scripts\": {\n \"lint\": \"eslint --ext mts,ts --fix src/\"\n },\n \"devDependencies\": {\n \"@types/cli-progress\": \"^3.9.2\",\n \"@types/yargs\": \"^17.0.10\"\n },\n \"dependencies\": {\n \"@liqvid/captioning\": \"workspace:^\",\n \"@liqvid/magic\": \"workspace:^\",\n \"@liqvid/renderer\": \"workspace:^\",\n \"@liqvid/server\": \"workspace:^\",\n \"@liqvid/utils\": \"workspace:^\",\n \"@types/node\": \"^17.0.23\",\n \"cli-progress\": \"^3.10.0\",\n \"execa\": \"^6.1.0\",\n \"ts-node\": \"^10.7.0\",\n \"webpack\": \"^5.70.0\",\n \"yargs\": \"^17.4.1\",\n \"yargs-parser\": \"^21.0.1\"\n }\n}\n" }, { "path": "packages/cli/src/index.mts", "content": "import {readFile} from \"fs/promises\";\nimport * as path from \"path\";\nimport {fileURLToPath} from \"url\";\nimport yargs from \"yargs\";\nimport {hideBin} from \"yargs/helpers\";\n\n// shared options\n\nimport {audio} from \"./tasks/audio.mjs\";\nimport {build} from \"./tasks/build.mjs\";\nimport {serve} from \"./tasks/serve.mjs\";\nimport {render} from \"./tasks/render.mjs\";\nimport {thumbs} from \"./tasks/thumbs.mjs\";\n\n// entry\nexport async function main() {\n let config = // WTF\n yargs(hideBin(process.argv))\n .scriptName(\"liqvid\")\n .strict()\n .usage(\"$0 [args]\")\n .demandCommand(1, \"Must specify a command\");\n\n config = audio(config);\n config = build(config);\n config = serve(config);\n config = render(config);\n config = thumbs(config);\n\n // version\n const __dirname = path.dirname(fileURLToPath(import.meta.url));\n const {version} = JSON.parse(\n await readFile(path.join(__dirname, \"..\", \"package.json\"), \"utf8\"),\n );\n config.version(version);\n\n return config.help().argv;\n}\n\nimport type {createServer} from \"@liqvid/server\";\nimport type {solidify, thumbs as captureThumbs} from \"@liqvid/renderer\";\nimport type {buildProject} from \"./tasks/build.mjs\";\nimport type {transcribe} from \"@liqvid/captioning\";\n\n/**\n * Configuration object\n */\nexport interface LiqvidConfig {\n audio?: {\n transcribe: Partial[0]>;\n };\n build?: Partial[0]>;\n render?: Partial[0]>;\n serve?: Partial[0]>;\n thumbs?: Partial[0]>;\n}\n" }, { "path": "packages/cli/src/tasks/audio.mts", "content": "import path from \"path\";\nimport type Yargs from \"yargs\";\nimport {DEFAULT_CONFIG, parseConfig} from \"./config.mjs\";\n\n/**\n * Audio utilities\n */\nexport const audio = (yargs: typeof Yargs) =>\n yargs.command(\"audio\", \"Audio helpers\", (yargs) => {\n return (\n yargs\n // convert command\n .command(\n \"convert \",\n \"Repair and convert webm recordings\",\n (yargs) =>\n yargs.positional(\"filename\", {\n describe: \"WebM File to convert\",\n type: \"string\",\n }),\n async (opts) => {\n const {convert} = await import(\"@liqvid/renderer/convert\");\n await convert(opts);\n },\n )\n // join command\n .command(\n \"join [filenames..]\",\n \"Join audio files into a single file\",\n (yargs) =>\n yargs\n .positional(\"filenames\", {\n desc: \"Filenames to join\",\n coerce: (filenames: string[]) =>\n filenames ? filenames.map((_) => path.resolve(_)) : [],\n })\n .option(\"output\", {\n alias: \"o\",\n desc: \"Output file. If not specified, defaults to last input filename.\",\n coerce: (output?: string) =>\n output ? path.resolve(output) : output,\n }),\n async (opts) => {\n const {join} = await import(\"@liqvid/renderer/join\");\n await join(opts);\n },\n )\n // transcribe command\n .command(\n \"transcribe\",\n \"Transcribe audio\",\n (yargs) =>\n yargs\n .config(\"config\", parseConfig(\"audio\", \"transcribe\"))\n .default(\"config\", DEFAULT_CONFIG)\n .option(\"api-key\", {\n desc: \"IBM API key\",\n demandOption: true,\n type: \"string\",\n })\n .option(\"api-url\", {\n desc: \"IBM Watson endpoint URL\",\n demandOption: true,\n type: \"string\",\n })\n .option(\"input\", {\n alias: \"i\",\n desc: \"Audio filename\",\n normalize: true,\n demandOption: true,\n })\n .option(\"captions\", {\n alias: \"c\",\n default: \"./captions.vtt\",\n desc: \"Captions input filename\",\n normalize: true,\n })\n .option(\"transcript\", {\n alias: \"t\",\n default: \"./transcript.json\",\n desc: \"Rich transcript filename\",\n normalize: true,\n })\n .option(\"params\", {\n desc: \"Parameters for IBM Watson\",\n default: {},\n }),\n async (opts) => {\n const {transcribe} = await import(\"@liqvid/captioning\");\n await transcribe(opts);\n },\n )\n .demandCommand(1, \"Must specify an audio command\")\n );\n });\n" }, { "path": "packages/cli/src/tasks/build.mts", "content": "import {\n ScriptData,\n scripts as defaultScripts,\n StyleData,\n styles as defaultStyles,\n transform,\n} from \"@liqvid/magic\";\nimport {promises as fsp} from \"fs\";\nimport path from \"path\";\nimport webpack from \"webpack\";\nimport type Yargs from \"yargs\";\nimport {DEFAULT_CONFIG, parseConfig} from \"./config.mjs\";\n// @ts-expect-error TypeScript complains about this not being a module\nimport loadSync from \"./load-sync.cjs\";\n\n/**\n * Build project\n */\nexport const build = (yargs: typeof Yargs) =>\n yargs.command(\n \"build\",\n \"Build project\",\n (yargs) => {\n return yargs\n .config(\"config\", parseConfig(\"build\"))\n .default(\"config\", DEFAULT_CONFIG)\n .option(\"clean\", {\n alias: \"C\",\n default: false,\n desc: \"Delete old dist directory before starting\",\n type: \"boolean\",\n })\n .option(\"out\", {\n alias: \"o\",\n coerce: path.resolve,\n desc: \"Output directory\",\n default: \"./dist\",\n normalize: true,\n })\n .option(\"static\", {\n alias: \"s\",\n coerce: path.resolve,\n desc: \"Static directory\",\n default: \"./static\",\n })\n .option(\"scripts\", {\n coerce: coerceScripts,\n desc: \"Script aliases\",\n default: {},\n })\n .option(\"styles\", {\n desc: \"Style aliases\",\n default: {},\n });\n },\n (args) => {\n return buildProject(args);\n },\n );\n\nexport async function buildProject(config: {\n /** Clean build directory */\n clean: boolean;\n\n /** Output directory */\n out: string;\n\n /** Static directory */\n static: string;\n\n scripts: Record;\n\n styles: Record;\n}) {\n // clean build directory\n if (config.clean) {\n console.log(\"Cleaning build directory...\");\n await fsp.rm(config.out, {force: true, recursive: true});\n }\n\n // ensure build directory exists\n await fsp.mkdir(config.out, {recursive: true});\n\n // copy static files\n console.log(\"Copying files...\");\n await buildStatic(config);\n\n // webpack\n console.log(\"Creating production bundle...\");\n await buildBundle(config);\n}\n\n/**\n * Copy over static files.\n */\nasync function buildStatic(config: {\n out: string;\n static: string;\n scripts: Record;\n styles: Record;\n}) {\n const staticDir = path.resolve(process.cwd(), config.static);\n const scripts = Object.assign({}, defaultScripts, config.scripts);\n const styles = Object.assign({}, defaultStyles, config.styles);\n\n await walkDir(staticDir, async (filename) => {\n const relative = path.relative(staticDir, filename);\n const dest = path.join(config.out, relative);\n\n // apply html magic\n if (filename.endsWith(\".html\")) {\n const file = await fsp.readFile(filename, \"utf8\");\n await idemWrite(\n dest,\n transform(file, {mode: \"production\", scripts, styles}),\n );\n } else if (relative === \"bundle.js\") {\n } else {\n await fsp.mkdir(path.dirname(dest), {recursive: true});\n await fsp.copyFile(filename, dest);\n }\n });\n}\n\n/**\n * Compile bundle in production mode.\n */\nasync function buildBundle(config: {\n out: string;\n}) {\n // configure webpack\n process.env.NODE_ENV = \"production\";\n const webpackConfig = loadSync(path.join(process.cwd(), \"webpack.config.js\"));\n webpackConfig.mode = \"production\";\n webpackConfig.output.path = config.out;\n\n const compiler = webpack(webpackConfig);\n\n // watch\n return new Promise((resolve) => {\n compiler.run((err, stats) => {\n if (err) console.error(err);\n else {\n console.info(stats.toString({color: true}));\n }\n compiler.close((err, stats) => {\n resolve();\n });\n });\n });\n}\n\n/**\n * Write a file idempotently.\n */\nasync function idemWrite(filename: string, data: string) {\n try {\n const old = await fsp.readFile(filename, \"utf8\");\n if (old !== data) await fsp.writeFile(filename, data);\n } catch (e) {\n await fsp.mkdir(path.dirname(filename), {recursive: true});\n await fsp.writeFile(filename, data);\n }\n}\n\n/**\n * Recursively walk a directory.\n */\nasync function walkDir(\n dirname: string,\n callback: (filename: string) => Promise,\n) {\n const files = (await fsp.readdir(dirname)).map((_) => path.join(dirname, _));\n await Promise.all(\n files.map(async (file) => {\n const stats = await fsp.stat(file);\n if (stats.isDirectory()) {\n return walkDir(file, callback);\n } else {\n return callback(file);\n }\n }),\n );\n}\n\n/**\n * Fix files.\n */\nfunction coerceScripts(\n json: Record<\n string,\n | {\n crossorigin?: boolean | string;\n development?: string;\n production?: string;\n }\n | string\n >,\n) {\n for (const key in json) {\n const record = json[key];\n if (typeof record === \"object\") {\n if (\n typeof record.crossorigin === \"string\" &&\n [\"true\", \"false\"].includes(record.crossorigin)\n ) {\n record.crossorigin = record.crossorigin === \"true\";\n }\n }\n }\n return json;\n}\n" }, { "path": "packages/cli/src/tasks/config.mts", "content": "import \"ts-node/register/transpile-only\";\nimport os from \"os\";\nimport path from \"path\";\n// @ts-expect-error TypeScript complains about this not being a module\nimport loadSync from \"./load-sync.cjs\";\n\nexport const DEFAULT_LIST = [\n \"liqvid.config.ts\",\n \"liqvid.config.js\",\n \"liqvid.config.json\",\n];\nexport const DEFAULT_CONFIG = DEFAULT_LIST[0];\n\nexport function parseConfig(...keys: string[]) {\n return (configPath: string) => {\n try {\n return access(loadSync(configPath), keys);\n } catch (e) {\n if (e.code === \"MODULE_NOT_FOUND\") {\n // default value => assume not specified\n if (path.join(process.cwd(), DEFAULT_CONFIG) === configPath) {\n return {};\n }\n throw e;\n } else {\n throw e;\n }\n }\n };\n}\n\n// function require(filename: string) {\n// return JSON.parse(readFileSync(path.resolve(process.cwd(), filename), \"utf8\"));\n// }\n\nfunction access(o: any, keys: string[]): any {\n if (keys.length === 0) return o;\n const key = keys.shift();\n if (!o[key]) return {};\n return access(o[key], keys);\n}\n\nexport const BROWSER_EXECUTABLE = {\n alias: \"x\",\n desc: \"Path to a Chrome/ium executable. If not specified and a suitable executable cannot be found, one will be downloaded during rendering.\",\n normalize: true,\n type: \"string\",\n} as const;\n\nexport const CONCURRENCY = {\n alias: \"n\",\n default: Math.floor(os.cpus().length / 2),\n desc: \"How many threads to use\",\n type: \"number\",\n} as const;\n" }, { "path": "packages/cli/src/tasks/index.mts", "content": "import {audio} from \"./audio.mjs\";\nimport {build} from \"./build.mjs\";\nimport {serve} from \"./serve.mjs\";\nimport {render} from \"./render.mjs\";\nimport {thumbs} from \"./thumbs.mjs\";\n\nexport const commands = [audio, build, render, serve, thumbs];\n" }, { "path": "packages/cli/src/tasks/load-sync.cts", "content": "module.exports = function loadSync(path: string) {\n return require(path);\n};\n" }, { "path": "packages/cli/src/tasks/render.mts", "content": "import {parseTime} from \"@liqvid/utils/time\";\nimport type Yargs from \"yargs\";\nimport {\n BROWSER_EXECUTABLE,\n CONCURRENCY,\n DEFAULT_CONFIG,\n parseConfig,\n} from \"./config.mjs\";\n\n/** Render to static video. */\nexport const render = (yargs: typeof Yargs) =>\n yargs.command(\n \"render\",\n \"Render static video\",\n (yargs) =>\n yargs\n .config(\"config\", parseConfig(\"render\"))\n .default(\"config\", DEFAULT_CONFIG)\n .example([\n [\"liqvid render\"],\n [\"liqvid render -a ./audio/audio.webm -o video.webm\"],\n [\"liqvid render -u http://localhost:8080/dist/\"],\n ])\n // Selection\n .group([\"audio-file\", \"output\", \"url\"], \"What to render\")\n .option(\"audio-file\", {\n alias: \"a\",\n desc: \"Path to audio file\",\n normalize: true,\n })\n .option(\"output\", {\n alias: \"o\",\n default: \"./video.mp4\",\n desc: \"Output filename\",\n normalize: true,\n demandOption: true,\n })\n .option(\"url\", {\n alias: \"u\",\n desc: \"URL of video to render\",\n default: \"http://localhost:3000/dist/\",\n })\n // General configuration\n .group(\n [\"browser-executable\", \"concurrency\", \"config\", \"help\"],\n \"General options\",\n )\n .option(\"browser-executable\", BROWSER_EXECUTABLE)\n .option(\"concurrency\", CONCURRENCY)\n // Input options\n .group(\n [\"duration\", \"end\", \"sequence\", \"start\", \"color-scheme\"],\n \"Input options\",\n )\n .option(\"start\", {\n alias: \"s\",\n coerce: coerceTime,\n default: \"00:00\",\n desc: \"Start time, specify as [hh:]mm:ss[.ms]\",\n type: \"string\",\n })\n .option(\"duration\", {\n alias: \"d\",\n conflicts: \"end\",\n desc: \"Duration, specify as [hh:]mm:ss[.ms]\",\n type: \"string\",\n })\n .coerce(\"duration\", coerceTime)\n .option(\"end\", {\n alias: \"e\",\n desc: \"End time, specify as [hh:]mm:ss[.ms]\",\n type: \"string\",\n })\n .coerce(\"end\", coerceTime)\n .option(\"sequence\", {\n alias: \"S\",\n desc: \"Output image sequence instead of video. If this flag is set, --output will be interpreted as a directory.\",\n type: \"boolean\",\n })\n .option(\"color-scheme\", {\n default: \"light\" as \"light\" | \"dark\",\n choices: [\"light\", \"dark\"] as const,\n desc: \"Color scheme\",\n })\n // Frames\n .group(\n [\"height\", \"image-format\", \"quality\", \"width\"],\n \"Frame formatting\",\n )\n .option(\"height\", {\n alias: \"h\",\n default: 800,\n desc: \"Video height\",\n })\n .option(\"image-format\", {\n alias: \"F\",\n choices: [\"jpeg\", \"png\"] as const,\n default: \"jpeg\" as \"jpeg\" | \"png\",\n desc: \"Image format for frames\",\n })\n .option(\"quality\", {\n alias: \"q\",\n default: 80,\n desc: 'Quality for images. Only applies when --image-format is \"jpeg\"',\n })\n .option(\"width\", {\n alias: \"w\",\n default: 1280,\n desc: \"Video width\",\n })\n // ffmpeg\n .group(\n [\"audio-args\", \"fps\", \"pixel-format\", \"video-args\"],\n \"Video options\",\n )\n .option(\"audio-args\", {\n alias: \"A\",\n desc: \"Additional flags to pass to ffmpeg, applying to the audio file\",\n type: \"string\",\n })\n .option(\"fps\", {\n alias: \"r\",\n default: 30,\n desc: \"Frames per second\",\n })\n .option(\"pixel-format\", {\n alias: \"P\",\n default: \"yuv420p\",\n desc: \"Pixel format for ffmpeg\",\n })\n .option(\"video-args\", {\n alias: \"V\",\n desc: \"Additional flags to pass to ffmpeg, applying to the output video\",\n type: \"string\",\n })\n .version(false),\n async (argv) => {\n const {solidify} = await import(\"@liqvid/renderer/solidify\");\n await solidify(argv);\n process.exit(0);\n },\n );\n\nfunction coerceTime(v: string): number {\n if (typeof v === \"undefined\") {\n return v;\n }\n try {\n return parseTime(v);\n } catch (e) {\n console.error(`Invalid time: ${v}. Specify as [hh:]mm:ss[.ms]`);\n process.exit(1);\n }\n}\n" }, { "path": "packages/cli/src/tasks/serve.mts", "content": "import path from \"path\";\nimport type Yargs from \"yargs\";\nimport {DEFAULT_CONFIG, parseConfig} from \"./config.mjs\";\n\n/**\n * Run preview server\n */\nexport const serve = (yargs: typeof Yargs) =>\n yargs.command(\n \"serve\",\n \"Run preview server\",\n (yargs) =>\n yargs\n .config(\"config\", parseConfig(\"serve\"))\n .default(\"config\", DEFAULT_CONFIG)\n .option(\"build\", {\n alias: \"b\",\n coerce: path.resolve,\n desc: \"Build directory\",\n default: \"./dist\",\n })\n .option(\"livereload-port\", {\n alias: \"L\",\n desc: \"Port to run LiveReload on\",\n default: 0,\n })\n .option(\"port\", {\n alias: \"p\",\n desc: \"Port to run on\",\n default: 3000,\n })\n .option(\"static\", {\n alias: \"s\",\n coerce: path.resolve,\n desc: \"Static directory\",\n default: \"./static\",\n })\n .option(\"scripts\", {\n desc: \"Script aliases\",\n default: {},\n })\n .option(\"styles\", {\n desc: \"Style aliases\",\n default: {},\n }),\n async (argv) => {\n const {createServer} = await import(\"@liqvid/server\");\n // await so script doesn't close\n await new Promise(() => {\n createServer(argv);\n });\n },\n );\n" }, { "path": "packages/cli/src/tasks/thumbs.mts", "content": "import type Yargs from \"yargs\";\nimport {\n BROWSER_EXECUTABLE,\n CONCURRENCY,\n DEFAULT_CONFIG,\n parseConfig,\n} from \"./config.mjs\";\n\nexport const thumbs = (yargs: typeof Yargs) =>\n yargs.command(\n \"thumbs\",\n \"Generate thumbnails\",\n (yargs) =>\n yargs\n .config(\"config\", parseConfig(\"thumbs\"))\n .default(\"config\", DEFAULT_CONFIG)\n .example([\n [\"liqvid thumbs\"],\n [\n \"liqvid thumbs -u http://localhost:8080/dist/ -o ./dist/thumbs/%s.jpeg\",\n ],\n ])\n // Selection\n .group([\"output\", \"url\"], \"What to render\")\n .option(\"output\", {\n alias: \"o\",\n default: \"./thumbs/%s.jpeg\",\n desc: \"Pattern for output filenames.\",\n normalize: true,\n })\n .option(\"url\", {\n alias: \"u\",\n desc: \"URL of video to generate thumbs for\",\n default: \"http://localhost:3000/dist/\",\n })\n // General\n .group(\n [\"browser-executable\", \"concurrency\", \"config\", \"help\"],\n \"General options\",\n )\n .option(\"browser-executable\", BROWSER_EXECUTABLE)\n .option(\"concurrency\", CONCURRENCY)\n // Format\n .group(\n [\n \"color-scheme\",\n \"browser-height\",\n \"browser-width\",\n \"cols\",\n \"frequency\",\n \"height\",\n \"image-format\",\n \"quality\",\n \"rows\",\n \"width\",\n ],\n \"Formatting\",\n )\n .option(\"color-scheme\", {\n default: \"light\" as \"light\" | \"dark\",\n choices: [\"light\", \"dark\"] as const,\n desc: \"Color scheme\",\n })\n .option(\"cols\", {\n alias: \"c\",\n default: 5,\n desc: \"The number of columns per sheet\",\n })\n .option(\"frequency\", {\n alias: \"f\",\n default: 4,\n desc: \"How many seconds between screenshots\",\n })\n .option(\"rows\", {\n alias: \"r\",\n default: 5,\n desc: \"The number of rows per sheet\",\n })\n .option(\"quality\", {\n alias: \"q\",\n default: 80,\n desc: 'Quality for images. Only applies when --image-format is \"jpeg\"',\n })\n .option(\"height\", {\n alias: \"h\",\n default: 100,\n desc: \"Height of each thumbnail\",\n })\n .option(\"width\", {\n alias: \"w\",\n default: 160,\n desc: \"Width of each thumbnail\",\n })\n .option(\"browser-height\", {\n alias: \"H\",\n desc: \"Height of screenshot before resizing\",\n type: \"number\",\n })\n .option(\"browser-width\", {\n alias: \"W\",\n desc: \"Width of screenshot before resizing\",\n type: \"number\",\n })\n .option(\"image-format\", {\n alias: \"F\",\n choices: [\"jpeg\", \"png\"] as const,\n default: \"jpeg\" as \"jpeg\" | \"png\",\n desc: \"Image format for thumbnails\",\n })\n .version(false),\n async (argv) => {\n const {thumbs: renderThumbs} = await import(\"@liqvid/renderer/thumbs\");\n await renderThumbs(argv);\n process.exit(0);\n },\n );\n" }, { "path": "packages/cli/tsconfig.json", "content": "{\n \"extends\": \"../../tsconfig.json\",\n \"compilerOptions\": {\n \"composite\": true,\n \"esModuleInterop\": true,\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\",\n \"module\": \"esnext\",\n \"target\": \"esnext\"\n },\n \"include\": [\"./src\"]\n}\n" }, { "path": "packages/diff/CHANGELOG.md", "content": "## 1.1.0 (April 15, 2024)\n\nAdd generics\n\n## 1.0.0 (April 14, 2024)\n\nInitial release\n" }, { "path": "packages/diff/README.md", "content": "# @liqvid/diff\n\nThis package provides functions to diff Javascript objects and arrays. It is used internally by recording plugins, and as such aims to produce very compact output.\n" }, { "path": "packages/diff/jest.config.js", "content": "module.exports = {\n preset: \"ts-jest\",\n testPathIgnorePatterns: [\"dist\"],\n transform: {},\n};\n" }, { "path": "packages/diff/package.json", "content": "{\n \"name\": \"@liqvid/diff\",\n \"version\": \"1.1.0\",\n \"description\": \"Object-diffing utility\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/esm/index.mjs\",\n \"require\": \"./dist/cjs/index.cjs\",\n \"types\": \"./dist/types/index.d.ts\"\n }\n },\n \"typesVersions\": {\n \"*\": {\n \"*\": [\"./dist/types/*.d.ts\"]\n }\n },\n \"files\": [\"dist/*\"],\n \"scripts\": {\n \"build\": \"pnpm build:clean; pnpm build:js; pnpm build:postclean\",\n \"build:clean\": \"rm -rf dist\",\n \"build:js\": \"tsc --outDir dist/esm --module esnext; tsc --outDir dist/cjs --module commonjs; node ../../build.mjs\",\n \"build:postclean\": \"rm dist/tsconfig.tsbuildinfo\",\n \"lint\": \"eslint --ext ts,tsx --fix src && eslint --ext ts,tsx --fix tests\",\n \"test\": \"eslint src --ext ts,tsx && jest --coverage\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/liqvidjs/liqvid.git\"\n },\n \"author\": \"Yuri Sulyma \",\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/liqvidjs/liqvid/issues\"\n },\n \"homepage\": \"https://github.com/liqvidjs/liqvid/tree/main/packages/diff#readme\",\n \"dependencies\": {\n \"@liqvid/utils\": \"workspace:^\"\n },\n \"sideEffects\": false\n}\n" }, { "path": "packages/diff/src/apply.ts", "content": "import type {ArrayDiff, ObjectDiff} from \"./types\";\nimport {matchItemDiff, matchRunes, objectKeys} from \"./utils\";\n\n/**\n * Apply a diff to an object.\n * @param a - The object to apply the diff to.\n * @param b - The diff to apply.\n * @returns A new object with the diff applied.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function applyDiff(a: T, b: ObjectDiff): T {\n const copy = structuredClone(a);\n\n for (const rkey of objectKeys(b)) {\n matchRunes(b, rkey, {\n create(key, item) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n copy[key] = item as any;\n },\n delete(key) {\n delete copy[key];\n },\n array(key, item) {\n const target = copy[key];\n\n if (!Array.isArray(target)) {\n throw new TypeError(\"Expected array\");\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n copy[key] = applyArrayDiff(target, item) as any;\n },\n object(key, item) {\n const target = copy[key];\n\n if (typeof target !== \"object\" || target === null) {\n throw new TypeError(\"Expected object\");\n }\n\n copy[key] = applyDiff(target, item);\n },\n change(key, item) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n copy[key] = item as any;\n },\n });\n }\n\n return copy;\n}\n\n/**\n * Apply a diff to an array.\n * @param arr - The array to apply the diff to.\n * @param diff - The diff to apply.\n * @returns A new array with the diff applied.\n */\nexport function applyArrayDiff(arr: T[], diff: ArrayDiff): T[] {\n const [delta, itemDiffs = [], ...appends] = diff;\n const copy = arr.slice();\n\n for (const diff of itemDiffs) {\n matchItemDiff(diff, {\n set(offset, item) {\n copy[copy.length - offset] = item as T;\n },\n array(offset, item) {\n copy[copy.length - offset] = applyArrayDiff(\n copy[copy.length - offset] as unknown[],\n item,\n ) as T;\n },\n object(offset, item) {\n copy[copy.length - offset] = applyDiff(\n copy[copy.length - offset],\n item,\n ) as T;\n },\n });\n }\n\n if (delta < 0) {\n copy.splice(copy.length + delta, -delta);\n } else {\n for (const append of appends) {\n copy.push(append as T);\n }\n }\n\n return copy;\n}\n" }, { "path": "packages/diff/src/builders.ts", "content": "import {deletePlaceholder, runes} from \"./runes\";\nimport type {\n ArrayDiff,\n ArrayItemDiff,\n ChangeItemDiff,\n DeletePlaceholder,\n ObjectDiff,\n RunedKey,\n} from \"./types\";\n\n/**\n * Make a diff to create a value.\n * @param key Key to use.\n * @param value Value to create.\n */\nexport function creationDiff(key: string, value: V) {\n return {[`${runes.create}${key}`]: value} as Record, V>;\n}\n\n/**\n * Make a diff to delete a value.\n * @param key Key to use.\n * @returns Diff to delete the value.\n */\nexport function deletionDiff(key: K) {\n return {[`${runes.delete}${key}`]: deletePlaceholder} as Record<\n RunedKey<\"delete\", K>,\n DeletePlaceholder\n >;\n}\n\n/**\n * Make a diff to update an array.\n * @param key Key to use.\n * @param diff Array diff to apply.\n */\nexport function arrayDiff>(\n key: K,\n diff: D,\n) {\n return {[`${runes.array}${key}`]: diff} as Record, D>;\n}\n\n/**\n * Make a diff to update an object.\n * @param key Key to use.\n * @param diff Object diff to apply.\n */\nexport function objectDiff>(\n key: K,\n diff: D,\n) {\n return {[`${runes.object}${key}`]: diff} as Record, D>;\n}\n\n/**\n * Make a diff to set a value.\n * @param key Key to use.\n * @value Value to set.\n */\nexport function changeDiff(key: string, value: V) {\n return {[`${runes.change}${key}`]: value} as Record, V>;\n}\n\n// item diffs\n\n/**\n * Make an item diff to change a value.\n * @param offset Offset from the end to change.\n * @param value Value to change to.\n */\nexport function changeItemDiff(offset: number, value: T): ChangeItemDiff {\n return [offset, value];\n}\n\n/**\n * Make an item diff to change an array item.\n * @param offset Offset from the end to change.\n * @param diff Array diff to apply.\n */\nexport function arrayItemDiff(\n offset: number,\n diff: ArrayDiff,\n): ArrayItemDiff {\n return [`${runes.array}${offset}`, diff];\n}\n\n/**\n * Make an item diff to change an object item.\n * @param index Index to change.\n * @param diff Object diff to apply.\n */\nexport function objectItemDiff>(\n offset: number,\n diff: D,\n) {\n return [`${runes.object}${offset}`, diff] as [RunedKey<\"object\">, D];\n}\n" }, { "path": "packages/diff/src/compute.ts", "content": "import {assertType} from \"@liqvid/utils/types\";\nimport {\n arrayDiff,\n arrayItemDiff,\n changeDiff,\n creationDiff,\n deletionDiff,\n objectDiff,\n objectItemDiff,\n} from \"./builders\";\nimport type {ArrayDiff, ObjectDiff} from \"./types\";\nimport {cmp} from \"./utils\";\n\n/** Compute the diff between two arrays. */\nexport function diffArrays(a: T[], b: T[]): ArrayDiff {\n // diffs\n const itemDiffs: Exclude[1], undefined> = [];\n\n for (let i = 0; i < Math.min(a.length, b.length); ++i) {\n const itemA = a[i];\n const itemB = b[i];\n\n const offset = a.length - i;\n\n if (!cmp(itemA, itemB)) {\n // simple replace\n if (\n typeof itemA !== typeof itemB ||\n typeof itemA === \"bigint\" ||\n typeof itemA === \"boolean\" ||\n typeof itemA === \"number\" ||\n typeof itemA === \"string\" ||\n itemA === null ||\n itemB === null ||\n Array.isArray(itemA) != Array.isArray(itemB)\n ) {\n itemDiffs.push([offset, itemB]);\n continue;\n }\n\n if (Array.isArray(itemA)) {\n assertType(itemB);\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n itemDiffs.push(arrayItemDiff(offset, diffArrays(itemA, itemB)));\n } else {\n assertType>(itemA);\n assertType>(itemB);\n itemDiffs.push(objectItemDiff(offset, diffObjects(itemA, itemB)));\n }\n }\n }\n\n const delta = b.length - a.length;\n\n // pure deletion\n if (itemDiffs.length === 0 && delta <= 0) {\n return [delta];\n } else {\n return [b.length - a.length, itemDiffs, ...b.slice(a.length)];\n }\n}\n\n/**\n * Compute the diff between two objects.\n */\nexport function diffObjects(a: T, b: T): ObjectDiff {\n assertType>(a);\n assertType>(b);\n\n const ret: ObjectDiff = {};\n\n const keysA = Object.keys(a);\n const keysB = new Set(Object.keys(b));\n\n for (const key of keysA) {\n if (!keysB.has(key)) {\n Object.assign(ret, deletionDiff(key));\n continue;\n }\n\n const valueA = a[key] as unknown;\n const valueB = b[key] as unknown;\n\n if (typeof valueA !== typeof valueB) {\n console.warn(\"Expected same type\");\n } else {\n if (!cmp(valueA, valueB)) {\n switch (typeof valueA) {\n case \"string\":\n case \"number\":\n case \"boolean\":\n case \"bigint\":\n Object.assign(ret, changeDiff(key, valueB));\n break;\n case \"object\":\n if (\n valueA === null ||\n valueB === null ||\n Array.isArray(valueA) !== Array.isArray(valueB)\n ) {\n Object.assign(ret, changeDiff(key, valueB));\n } else if (Array.isArray(valueA)) {\n assertType(valueB);\n Object.assign(ret, arrayDiff(key, diffArrays(valueA, valueB)));\n } else {\n assertType(valueB);\n Object.assign(ret, objectDiff(key, diffObjects(valueA, valueB)));\n }\n break;\n }\n }\n }\n\n keysB.delete(key);\n }\n\n for (const key of keysB) {\n Object.assign(ret, creationDiff(key, b[key]));\n }\n\n return ret;\n}\n" }, { "path": "packages/diff/src/index.ts", "content": "export {applyArrayDiff, applyDiff} from \"./apply\";\nexport {\n arrayDiff,\n arrayItemDiff,\n changeDiff,\n changeItemDiff,\n creationDiff,\n deletionDiff,\n objectDiff,\n objectItemDiff,\n} from \"./builders\";\nexport {diffArrays, diffObjects as diffObjects} from \"./compute\";\nexport {mergeArrayDiffs, mergeDiffs} from \"./merge\";\nexport type {\n ArrayDiff,\n ArrayItemDiff,\n ChangeItemDiff,\n DeletePlaceholder,\n ItemDiff,\n ObjectDiff,\n ObjectItemDiff,\n Rune,\n RuneName,\n RunedKey,\n} from \"./types\";\nexport {cmp, invertDiff, matchItemDiff, matchRunes} from \"./utils\";\n" }, { "path": "packages/diff/src/merge.ts", "content": "import {assertDefined, assertType} from \"@liqvid/utils/types\";\nimport {applyArrayDiff, applyDiff} from \"./apply\";\nimport {\n arrayDiff,\n arrayItemDiff,\n changeDiff,\n changeItemDiff,\n creationDiff,\n deletionDiff,\n objectDiff,\n objectItemDiff,\n} from \"./builders\";\nimport type {ArrayDiff, ItemDiff, ObjectDiff} from \"./types\";\nimport {\n consume,\n getOffset,\n matchItemDiff,\n matchRunes,\n objectKeys,\n} from \"./utils\";\n\n/** Merge two array diffs. */\nexport function mergeArrayDiffs(\n a: ArrayDiff,\n b: ArrayDiff,\n): ArrayDiff {\n const [deltaA, itemDiffsA = [], ...tailA] = a;\n const [deltaB, itemDiffsB = [], ...tailB] = b;\n\n const delta = deltaA + deltaB;\n\n // combine item diffs\n const itemDiffs: ItemDiff[] = [];\n\n let iterA = 0;\n let iterB = 0;\n\n for (; iterA < itemDiffsA.length || iterB < itemDiffsB.length; ) {\n const itemA = itemDiffsA.at(iterA);\n const itemB = itemDiffsB.at(iterB);\n\n const offsetA = itemA ? getOffset(itemA[0]) : 0;\n const offsetB = itemB ? getOffset(itemB[0]) : 0;\n\n const newOffsetB = offsetB - deltaA;\n\n if (offsetA > newOffsetB) {\n assertDefined(itemA);\n // skip if deleted by b\n if (offsetA > -deltaB) {\n itemDiffs.push(itemA);\n }\n iterA++;\n } else if (newOffsetB > offsetA) {\n assertDefined(itemB);\n if (deltaA >= 0) {\n // adjust the tail of A\n if (offsetB <= tailA.length) {\n const tailOffset = tailA.length - offsetB;\n const valueA = tailA[tailOffset];\n\n matchItemDiff(itemB, {\n // set\n set(_, valueB) {\n tailA[tailOffset] = valueB;\n },\n // array\n array(_, valueB) {\n assertType(valueA);\n tailA[tailOffset] = applyArrayDiff(valueA, valueB);\n },\n object(_, valueB) {\n assertType>(valueA);\n tailA[tailOffset] = applyDiff(valueA, valueB);\n },\n });\n } else {\n itemDiffs.push([newOffsetB, itemB[1]] as ItemDiff);\n }\n } else {\n itemDiffs.push([newOffsetB, itemB[1]] as ItemDiff);\n }\n\n iterB++;\n } else {\n assertDefined(itemA);\n assertDefined(itemB);\n // offsetA === newOffsetB\n matchItemDiff(itemA, {\n set(_, valueA) {\n matchItemDiff(itemB, {\n // change(a) * change(b) = change(b)\n set(_, valueB) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n itemDiffs.push(changeItemDiff(offsetA, valueB));\n },\n // change(a) * array(b) = change(a*b)\n array(_, valueB) {\n assertType(valueA);\n itemDiffs.push(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n changeItemDiff(offsetA, applyArrayDiff(valueA, valueB)),\n );\n },\n // change(a) * object(b) = change(a*b)\n object(_, valueB) {\n assertType(valueA);\n itemDiffs.push(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n changeItemDiff(offsetA, applyDiff(valueA, valueB)),\n );\n },\n });\n },\n array(_, valueA) {\n matchItemDiff(itemB, {\n // array(a) * change(b) = change(b)\n set(_, valueB) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n itemDiffs.push(changeItemDiff(offsetA, valueB));\n },\n // array(a) * array(b) = array(a*b)\n array(_, valueB) {\n itemDiffs.push(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n arrayItemDiff(offsetA, mergeArrayDiffs(valueA, valueB)),\n );\n },\n });\n },\n object(_, valueA) {\n matchItemDiff(itemB, {\n // object(a) * change(b) = change(b)\n set(_, valueB) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n itemDiffs.push(changeItemDiff(offsetA, valueB));\n },\n // object(a) * object(b) = object(a*b)\n object(_, valueB) {\n itemDiffs.push(\n objectItemDiff(offsetA, mergeDiffs(valueA, valueB)),\n );\n },\n });\n },\n });\n\n iterA++;\n iterB++;\n }\n }\n\n // needs to come afterwards since we modify tailA above\n const tail = [\n ...tailA.slice(0, tailA.length + Math.min(0, deltaB)),\n ...tailB,\n ];\n\n return [delta, itemDiffs, ...tail];\n}\n\n/** Merge two object diffs. */\nexport function mergeDiffs(\n a: ObjectDiff,\n b: ObjectDiff,\n): ObjectDiff {\n const ret: ObjectDiff = {};\n\n for (const rKeyB of objectKeys(b)) {\n matchRunes(b, rKeyB, {\n // create\n create(key, valueB) {\n consume(a, key, {\n // delete * create(b) = set(b)\n delete() {\n Object.assign(ret, changeDiff(key, valueB));\n },\n none() {\n Object.assign(ret, creationDiff(key, valueB));\n },\n else(name) {\n throw new Error(`Invalid merge: ${name}-add`);\n },\n });\n },\n // delete\n delete(key) {\n consume(a, key, {\n delete() {\n throw new Error(\"Invalid merge: delete-delete\");\n },\n });\n Object.assign(ret, deletionDiff(key));\n },\n // set\n change(key, valueB) {\n consume(a, key, {\n // create * set(b) = create(b)\n create() {\n Object.assign(ret, creationDiff(key, valueB));\n },\n // invalid\n delete() {\n throw new Error(\"Invalid merge: delete-set\");\n },\n // _ * set(b) = set(b)\n else() {\n Object.assign(ret, changeDiff(key, valueB));\n },\n none() {\n Object.assign(ret, changeDiff(key, valueB));\n },\n });\n },\n // array\n array(key, valueB) {\n consume(a, key, {\n // create(a) * array(b) = create(a*b)\n create(valueA) {\n assertType(valueA);\n Object.assign(\n ret,\n creationDiff(key, applyArrayDiff(valueA, valueB)),\n );\n },\n // set(a) * array(b) = set(a*b)\n change(valueA) {\n assertType(valueA);\n Object.assign(ret, changeDiff(key, applyArrayDiff(valueA, valueB)));\n },\n else(name) {\n throw new Error(`Invalid merge: ${name}-array`);\n },\n array(valueA) {\n Object.assign(ret, arrayDiff(key, mergeArrayDiffs(valueA, valueB)));\n },\n none() {\n Object.assign(ret, arrayDiff(key, valueB));\n },\n });\n },\n // object\n object(key, valueB) {\n consume(a, key, {\n // create(a) * object(b) = object(a*b)\n create(valueA) {\n assertType(valueA);\n Object.assign(ret, creationDiff(key, applyDiff(valueA, valueB)));\n },\n // set(a) * object(b) = set(a*b)\n change(valueA) {\n assertType(valueA);\n Object.assign(ret, changeDiff(key, applyDiff(valueA, valueB)));\n },\n else(name) {\n throw new Error(`Invalid merge: ${name}-array`);\n },\n // object(a) * object(b) = object(a*b)\n object(valueA) {\n Object.assign(ret, objectDiff(key, mergeDiffs(valueA, valueB)));\n },\n none() {\n Object.assign(ret, objectDiff(key, valueB));\n },\n });\n },\n });\n }\n\n // add anything remaining from a\n Object.assign(ret, a);\n\n return ret;\n}\n" }, { "path": "packages/diff/src/runes.ts", "content": "export const runes = {\n array: \"#\",\n change: \"=\",\n create: \"+\",\n delete: \"-\",\n object: \"@\",\n} as const;\n\nexport const deletePlaceholder = 0;\n" }, { "path": "packages/diff/src/types.ts", "content": "import type {deletePlaceholder, runes} from \"./runes\";\n\n// runes\nexport type RuneName = keyof typeof runes;\nexport type Rune = (typeof runes)[RuneName];\nexport type RunedKey<\n K extends RuneName,\n Name extends string = string,\n> = `${(typeof runes)[K]}${Name}`;\n\n// array diffs\nexport type ChangeItemDiff = [offset: number, value: T];\nexport type ObjectItemDiff = [\n offset: RunedKey<\"object\">,\n diff: ObjectDiff,\n];\nexport type ArrayItemDiff = [offset: RunedKey<\"array\">, diff: ArrayDiff];\n\n/**\n * Note that offsets are relative to the **end** of the array.\n */\nexport type ItemDiff =\n | ArrayItemDiff\n | ChangeItemDiff\n | ObjectItemDiff;\n\n/**\n * A record describing how to make changes to an array.\n */\nexport type ArrayDiff = [\n delta: number,\n itemDiffs?: ItemDiff[],\n ...tail: unknown[],\n];\n\n// delete placeholder\nexport type DeletePlaceholder = typeof deletePlaceholder;\n\n/**\n * A record describing how to make changes to an object.\n */\nexport type ObjectDiff = {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [key: RunedKey<\"array\">]: ArrayDiff;\n [key: RunedKey<\"change\">]: unknown;\n [key: RunedKey<\"create\">]: unknown;\n [key: RunedKey<\"delete\">]: DeletePlaceholder;\n [key: RunedKey<\"object\">]: ObjectDiff;\n};\n" }, { "path": "packages/diff/src/utils.ts", "content": "import {assertType} from \"@liqvid/utils/types\";\nimport {applyDiff} from \"./apply\";\nimport {diffObjects} from \"./compute\";\nimport {runes} from \"./runes\";\nimport type {\n ArrayDiff,\n ItemDiff,\n ObjectDiff,\n Rune,\n RuneName,\n RunedKey,\n} from \"./types\";\n\n/** Typed {@link Object.keys} */\nexport function objectKeys(obj: T): (keyof T)[] {\n return Object.keys(obj) as (keyof T)[];\n}\n\n/** Comparison function */\nexport function cmp(a: unknown, b: unknown): boolean {\n if (typeof a !== typeof b) return false;\n\n switch (typeof a) {\n case \"bigint\":\n case \"boolean\":\n case \"function\":\n case \"number\":\n case \"string\":\n case \"symbol\":\n case \"undefined\":\n return a === b;\n }\n\n if (a === null || b === null) return a === b;\n\n assertType>(a);\n assertType>(b);\n\n const keysA = Object.keys(a);\n const keysB = new Set(Object.keys(b));\n\n if (keysA.length !== keysB.size) return false;\n return keysA.every((key) => keysB.has(key) && cmp(a[key], b[key]));\n}\n\n/**\n * Pattern-match on an item diff.\n */\nexport function matchItemDiff(\n [offset, item]: ItemDiff,\n fns: {\n set?: (offset: number, value: unknown) => R;\n array?: (offset: number, value: ArrayDiff) => R;\n object?: (offset: number, value: ObjectDiff) => R;\n },\n): R | undefined {\n if (typeof offset === \"number\") {\n return fns.set?.(offset, item);\n }\n\n const numeric = getOffset(offset);\n\n if (isRune(offset, runes.array)) {\n assertType>(item);\n return fns?.array?.(numeric, item);\n } else if (isRune(offset, runes.object)) {\n assertType>(item);\n return fns?.object?.(numeric, item);\n }\n}\n\nexport function isRune(\n key: string,\n rune: R,\n): key is `${R}${string}` {\n return key.startsWith(rune as string);\n}\n\n/** Pattern-match on an object diff. */\nexport function matchRunes(\n diff: ObjectDiff,\n key: keyof ObjectDiff,\n fns: {\n [name in RuneName]?: (\n key: string & keyof T,\n rkey: ObjectDiff[RunedKey],\n ) => R;\n },\n): R | undefined {\n for (const name of Object.keys(fns) as RuneName[]) {\n const rune = runes[name];\n if (key.startsWith(rune)) {\n const fn = fns[name];\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return fn(key.slice(rune.length) as any, diff[key] as any);\n }\n }\n}\n\nexport function consume(\n a: ObjectDiff,\n key: string,\n fns: {\n [$name in RuneName | \"else\" | \"none\"]?: $name extends RuneName\n ? (value: ObjectDiff[RunedKey<$name>]) => unknown\n : $name extends \"else\"\n ? (\n name: K,\n value: ObjectDiff[RunedKey],\n ) => unknown\n : () => unknown;\n } = {},\n) {\n for (const name of objectKeys(runes)) {\n const rune = runes[name];\n const keyA = `${rune}${key}` as const;\n\n if (!(keyA in a)) continue;\n\n const valueA = a[keyA];\n delete a[keyA];\n\n const fn = fns[name];\n if (fn) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return fn(valueA as any);\n }\n\n if (fns.else) {\n return fns.else(name, valueA);\n }\n }\n\n // if nothing matched\n return fns.none?.();\n}\n\nexport function getOffset(offset: ItemDiff[0]): number {\n if (typeof offset === \"number\") return offset;\n\n if (isRune(offset, runes.array)) {\n return parseInt(offset.slice(runes.array.length), 10);\n } else if (isRune(offset, runes.object)) {\n return parseInt(offset.slice(runes.object.length), 10);\n }\n\n throw new Error(`Invalid index: ${offset}`);\n}\n\nexport function addToOffset[0]>(\n offset: O,\n delta: number,\n): O {\n const result = getOffset(offset) + delta;\n if (typeof offset === \"number\") return result as O;\n\n if (isRune(offset, runes.array)) {\n return `${runes.array}${result}` as O;\n }\n\n return `${runes.object}${result}` as O;\n}\n\n/**\n * Invert a diff with respect to an object.\n * Note that it is not possible to invert a lone diff.\n */\nexport function invertDiff(state: T, diff: ObjectDiff): ObjectDiff {\n return diffObjects(applyDiff(state, diff), state);\n}\n" }, { "path": "packages/diff/tests/suite.test.ts", "content": "/* eslint-disable @typescript-eslint/no-explicit-any */\nimport {applyDiff, diffObjects} from \"../src\";\n\ndescribe(\"diffObjects and applyDiff\", () => {\n test(\"property deletion\", () => {\n const a = {x: 1};\n const b = {};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"-x\": 0});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"property additions\", () => {\n const a = {};\n const b = {x: 1};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"+x\": 1});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"property changes\", () => {\n const a = {x: 1};\n const b = {x: 2};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"=x\": 2});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"array appends\", () => {\n const a = {x: [0, 1, 2]};\n const b = {x: [0, 1, 2, 3, 4]};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"#x\": [2, [], 3, 4]});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"array deletions\", () => {\n const a = {x: [0, 1, 2]};\n const b = {x: [0]};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"#x\": [-2]});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"array changes\", () => {\n const a = {x: [0, 1, 2]};\n const b = {x: [0, 3]};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\"#x\": [-1, [[2, 3]]]});\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"nested objects\", () => {\n const a = {x: {fruit: \"apple\", color: \"red\"}};\n const b = {x: {fruit: \"potato\", kind: \"mashed\"}};\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\n \"@x\": {\"=fruit\": \"potato\", \"+kind\": \"mashed\", \"-color\": 0},\n });\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"objects nested in arrays\", () => {\n const a = {\n shapes: {\n square: {\n segments: [{type: \"free\", points: [0, 1]}],\n },\n },\n };\n const b = {\n shapes: {\n square: {\n segments: [{type: \"free\", points: [0, 1, 2, 3]}],\n },\n },\n };\n\n const diff = diffObjects(a, b);\n expect(diff).toEqual({\n \"@shapes\": {\n \"@square\": {\n \"#segments\": [\n 0,\n [\n [\n \"@1\",\n {\n \"#points\": [2, [], 2, 3],\n },\n ],\n ],\n ],\n },\n },\n });\n expect(applyDiff(a, diff)).toEqual(b);\n });\n\n test(\"kitchen sink\", () => {\n const a = {\n x: 1,\n y: 2,\n z: 3,\n arr: [1, 2, 3],\n obj: {fruit: \"apple\", color: \"red\"},\n };\n const b = {\n x: 3,\n z: 3,\n w: 4,\n arr: [1, 5, 4, \"x\", \"y\"],\n obj: {fruit: \"potato\", kind: \"mashed\"},\n };\n\n const diff = diffObjects(a, b);\n\n expect(diff).toEqual({\n \"=x\": 3,\n \"-y\": 0,\n \"+w\": 4,\n \"#arr\": [\n 2,\n [\n [2, 5],\n [1, 4],\n ],\n \"x\",\n \"y\",\n ],\n \"@obj\": {\n \"=fruit\": \"potato\",\n \"+kind\": \"mashed\",\n \"-color\": 0,\n },\n });\n expect(applyDiff(a, diff)).toEqual(b);\n });\n});\n" }, { "path": "packages/diff/tsconfig.json", "content": "{\n \"extends\": \"../../tsconfig.json\",\n \"compilerOptions\": {\n \"composite\": true,\n \"declarationDir\": \"./dist/types\",\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\"\n },\n \"include\": [\"./src\"]\n}\n" }, { "path": "packages/duration/README.md", "content": "# @liqvid/duration\n\nProvides an opaque `Duration` type to handle relative times, avoiding millisecond/second mismatches.\n" }, { "path": "packages/duration/package.json", "content": "{\n \"name\": \"@liqvid/duration\",\n \"version\": \"1.1.0\",\n \"description\": \"Class for unitless time intervals\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/esm/index.mjs\",\n \"require\": \"./dist/cjs/index.cjs\",\n \"types\": \"./dist/types/index.d.ts\"\n }\n },\n \"typesVersions\": {\n \"*\": {\n \"*\": [\n \"./dist/types/*.d.ts\"\n ]\n }\n },\n \"files\": [\n \"dist/*\"\n ],\n \"scripts\": {\n \"build\": \"pnpm build:clean; pnpm build:js; pnpm build:postclean\",\n \"build:clean\": \"rm -rf dist\",\n \"build:js\": \"pnpm build:js:cjs; pnpm build:js:esm; pnpm build:js:fix\",\n \"build:js:cjs\": \"tsc --module commonjs --outDir dist/cjs\",\n \"build:js:esm\": \"tsc --module esnext --outDir dist/esm\",\n \"build:js:fix\": \"node ../../build.mjs\",\n \"build:postclean\": \"rm dist/tsconfig.tsbuildinfo\",\n \"lint\": \"biome check --fix\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/liqvidjs/liqvid.git\"\n },\n \"author\": \"Yuri Sulyma \",\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/liqvidjs/liqvid/issues\"\n },\n \"homepage\": \"https://github.com/liqvidjs/liqvid/tree/main/packages/duration#readme\",\n \"devDependencies\": {\n \"@biomejs/biome\": \"catalog:\",\n \"typescript\": \"catalog:\"\n },\n \"sideEffects\": false\n}\n" }, { "path": "packages/duration/src/index.ts", "content": "const SECONDS = 1000,\n MINUTES = 60 * SECONDS,\n HOURS = 60 * MINUTES,\n DAYS = 24 * HOURS,\n WEEKS = 7 * DAYS;\n\n/**\n * Convenience type representing either a {@link Duration}\n * or creation options for one\n */\nexport type DurationLike = Duration | DurationOptions;\n\n/**\n * These are additive, e.g. passing `{seconds: 20, minutes: 5}` is\n * equivalent to passing `{seconds: 320}`.\n */\nexport interface DurationOptions {\n milliseconds?: number;\n seconds?: number;\n minutes?: number;\n hours?: number;\n days?: number;\n weeks?: number;\n}\n\n/**\n * Interval between two points in time, agnostic of units.\n */\nexport class Duration {\n private __valueMs: number;\n\n constructor({\n milliseconds = 0,\n seconds = 0,\n minutes = 0,\n hours = 0,\n days = 0,\n weeks = 0,\n }: DurationOptions = {}) {\n this.__valueMs =\n weeks * WEEKS +\n days * DAYS +\n hours * HOURS +\n minutes * MINUTES +\n seconds * SECONDS +\n milliseconds;\n }\n\n /**\n * Coerce a DurationLike into a Duration\n */\n static from(val: DurationLike): Duration {\n if (val instanceof Duration) return val;\n return new Duration(val);\n }\n\n /**\n * Create a new {@link Duration} object and receive a callback\n * to imperatively set its value. This is useful when you need\n * to keep a {@link Duration} object in sync with some changing\n * value (e.g. wrapping `currentTime` on a `