@twick/core 0.11.0

package/lib/utils/range.js

@@ -0,0 +1,18 @@
+export function range(first, second, step) {
+    let from = 0;
+    let to = first;
+    if (second !== undefined) {
+        from = first;
+        to = second;
+    }
+    step = step === undefined ? (from < to ? 1 : -1) : step;
+    const array = [];
+    let length = Math.max(Math.ceil((to - from) / step), 0);
+    let index = 0;
+    while (length--) {
+        array[index++] = from;
+        from += step;
+    }
+    return array;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmFuZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvcmFuZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBdUNBLE1BQU0sVUFBVSxLQUFLLENBQUMsS0FBYSxFQUFFLE1BQWUsRUFBRSxJQUFhO0lBQ2pFLElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQztJQUNiLElBQUksRUFBRSxHQUFHLEtBQUssQ0FBQztJQUNmLElBQUksTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO1FBQ3pCLElBQUksR0FBRyxLQUFLLENBQUM7UUFDYixFQUFFLEdBQUcsTUFBTSxDQUFDO0lBQ2QsQ0FBQztJQUVELElBQUksR0FBRyxJQUFJLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBRXhELE1BQU0sS0FBSyxHQUFHLEVBQUUsQ0FBQztJQUNqQixJQUFJLE1BQU0sR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxFQUFFLEdBQUcsSUFBSSxDQUFDLEdBQUcsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDeEQsSUFBSSxLQUFLLEdBQUcsQ0FBQyxDQUFDO0lBRWQsT0FBTyxNQUFNLEVBQUUsRUFBRSxDQUFDO1FBQ2hCLEtBQUssQ0FBQyxLQUFLLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FBQztRQUN0QixJQUFJLElBQUksSUFBSSxDQUFDO0lBQ2YsQ0FBQztJQUVELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQyJ9

package/lib/utils/useContext.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provide a function to access the Context2D before the scene is rendered.
+ *
+ * @param callback - The function that will be provided the context before render.
+ */
+export declare function useContext(callback: (ctx: CanvasRenderingContext2D) => void): () => void;
+/**
+ * Provide a function to access the Context2D after the scene is rendered.
+ *
+ * @param callback - The function that will be provided the context after render.
+ */
+export declare function useContextAfter(callback: (ctx: CanvasRenderingContext2D) => void): () => void;
+//# sourceMappingURL=useContext.d.ts.map

package/lib/utils/useContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContext.d.ts","sourceRoot":"","sources":["../../src/utils/useContext.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAChD,MAAM,IAAI,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAChD,MAAM,IAAI,CAEZ"}

package/lib/utils/useContext.js

@@ -0,0 +1,18 @@
+import { useScene } from './useScene';
+/**
+ * Provide a function to access the Context2D before the scene is rendered.
+ *
+ * @param callback - The function that will be provided the context before render.
+ */
+export function useContext(callback) {
+    return useScene().lifecycleEvents.onBeginRender.subscribe(callback);
+}
+/**
+ * Provide a function to access the Context2D after the scene is rendered.
+ *
+ * @param callback - The function that will be provided the context after render.
+ */
+export function useContextAfter(callback) {
+    return useScene().lifecycleEvents.onFinishRender.subscribe(callback);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlQ29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy91c2VDb250ZXh0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBQyxRQUFRLEVBQUMsTUFBTSxZQUFZLENBQUM7QUFFcEM7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxVQUFVLENBQ3hCLFFBQWlEO0lBRWpELE9BQU8sUUFBUSxFQUFFLENBQUMsZUFBZSxDQUFDLGFBQWEsQ0FBQyxTQUFTLENBQUMsUUFBUSxDQUFDLENBQUM7QUFDdEUsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsZUFBZSxDQUM3QixRQUFpRDtJQUVqRCxPQUFPLFFBQVEsRUFBRSxDQUFDLGVBQWUsQ0FBQyxjQUFjLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0FBQ3ZFLENBQUMifQ==

package/lib/utils/usePlayback.d.ts

@@ -0,0 +1,8 @@
+import type { PlaybackStatus } from '../app';
+/**
+ * Get a reference to the playback status.
+ */
+export declare function usePlayback(): PlaybackStatus;
+export declare function startPlayback(playback: PlaybackStatus): void;
+export declare function endPlayback(playback: PlaybackStatus): void;
+//# sourceMappingURL=usePlayback.d.ts.map

package/lib/utils/usePlayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlayback.d.ts","sourceRoot":"","sources":["../../src/utils/usePlayback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,QAAQ,CAAC;AAI3C;;GAEG;AACH,wBAAgB,WAAW,mBAM1B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,QAErD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,QAInD"}

package/lib/utils/usePlayback.js

@@ -0,0 +1,20 @@
+const PlaybackStack = [];
+/**
+ * Get a reference to the playback status.
+ */
+export function usePlayback() {
+    const playback = PlaybackStack.at(-1);
+    if (!playback) {
+        throw new Error('The playback is not available in the current context.');
+    }
+    return playback;
+}
+export function startPlayback(playback) {
+    PlaybackStack.push(playback);
+}
+export function endPlayback(playback) {
+    if (PlaybackStack.pop() !== playback) {
+        throw new Error('startPlayback/endPlayback were called out of order.');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlUGxheWJhY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvdXNlUGxheWJhY2sudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxhQUFhLEdBQXFCLEVBQUUsQ0FBQztBQUUzQzs7R0FFRztBQUNILE1BQU0sVUFBVSxXQUFXO0lBQ3pCLE1BQU0sUUFBUSxHQUFHLGFBQWEsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN0QyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDZCxNQUFNLElBQUksS0FBSyxDQUFDLHVEQUF1RCxDQUFDLENBQUM7SUFDM0UsQ0FBQztJQUNELE9BQU8sUUFBUSxDQUFDO0FBQ2xCLENBQUM7QUFFRCxNQUFNLFVBQVUsYUFBYSxDQUFDLFFBQXdCO0lBQ3BELGFBQWEsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7QUFDL0IsQ0FBQztBQUVELE1BQU0sVUFBVSxXQUFXLENBQUMsUUFBd0I7SUFDbEQsSUFBSSxhQUFhLENBQUMsR0FBRyxFQUFFLEtBQUssUUFBUSxFQUFFLENBQUM7UUFDckMsTUFBTSxJQUFJLEtBQUssQ0FBQyxxREFBcUQsQ0FBQyxDQUFDO0lBQ3pFLENBQUM7QUFDSCxDQUFDIn0=

package/lib/utils/useScene.d.ts

@@ -0,0 +1,17 @@
+import type { Scene } from '../scenes';
+/**
+ * Get a reference to the current scene.
+ */
+export declare function useScene(): Scene;
+export declare function startScene(scene: Scene): void;
+export declare function endScene(scene: Scene): void;
+export declare function useLogger(): import("..").Logger | Console;
+/**
+ * Mark the current scene as ready to transition out.
+ *
+ * @remarks
+ * Usually used together with transitions. When a scene is marked as finished,
+ * the transition will start but the scene generator will continue running.
+ */
+export declare function finishScene(): void;
+//# sourceMappingURL=useScene.d.ts.map

package/lib/utils/useScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScene.d.ts","sourceRoot":"","sources":["../../src/utils/useScene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAIrC;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAMhC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,QAEtC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,QAIpC;AAED,wBAAgB,SAAS,kCAExB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,SAE1B"}

package/lib/utils/useScene.js

@@ -0,0 +1,33 @@
+const SceneStack = [];
+/**
+ * Get a reference to the current scene.
+ */
+export function useScene() {
+    const scene = SceneStack.at(-1);
+    if (!scene) {
+        throw new Error('The scene is not available in the current context.');
+    }
+    return scene;
+}
+export function startScene(scene) {
+    SceneStack.push(scene);
+}
+export function endScene(scene) {
+    if (SceneStack.pop() !== scene) {
+        throw new Error('startScene/endScene were called out of order.');
+    }
+}
+export function useLogger() {
+    return SceneStack.at(-1)?.logger ?? console;
+}
+/**
+ * Mark the current scene as ready to transition out.
+ *
+ * @remarks
+ * Usually used together with transitions. When a scene is marked as finished,
+ * the transition will start but the scene generator will continue running.
+ */
+export function finishScene() {
+    useScene().enterCanTransitionOut();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlU2NlbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvdXNlU2NlbmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxVQUFVLEdBQVksRUFBRSxDQUFDO0FBRS9COztHQUVHO0FBQ0gsTUFBTSxVQUFVLFFBQVE7SUFDdEIsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ2hDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNYLE1BQU0sSUFBSSxLQUFLLENBQUMsb0RBQW9ELENBQUMsQ0FBQztJQUN4RSxDQUFDO0lBQ0QsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDO0FBRUQsTUFBTSxVQUFVLFVBQVUsQ0FBQyxLQUFZO0lBQ3JDLFVBQVUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDekIsQ0FBQztBQUVELE1BQU0sVUFBVSxRQUFRLENBQUMsS0FBWTtJQUNuQyxJQUFJLFVBQVUsQ0FBQyxHQUFHLEVBQUUsS0FBSyxLQUFLLEVBQUUsQ0FBQztRQUMvQixNQUFNLElBQUksS0FBSyxDQUFDLCtDQUErQyxDQUFDLENBQUM7SUFDbkUsQ0FBQztBQUNILENBQUM7QUFFRCxNQUFNLFVBQVUsU0FBUztJQUN2QixPQUFPLFVBQVUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxNQUFNLElBQUksT0FBTyxDQUFDO0FBQzlDLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsV0FBVztJQUN6QixRQUFRLEVBQUUsQ0FBQyxxQkFBcUIsRUFBRSxDQUFDO0FBQ3JDLENBQUMifQ==

package/lib/utils/useThread.d.ts

@@ -0,0 +1,8 @@
+import type { Thread } from '../threading';
+/**
+ * Get a reference to the current thread.
+ */
+export declare function useThread(): Thread;
+export declare function startThread(thread: Thread): void;
+export declare function endThread(thread: Thread): void;
+//# sourceMappingURL=useThread.d.ts.map

package/lib/utils/useThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThread.d.ts","sourceRoot":"","sources":["../../src/utils/useThread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AAKzC;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAWlC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,QAEzC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,QAIvC"}

package/lib/utils/useThread.js

@@ -0,0 +1,24 @@
+import { DetailedError } from './DetailedError';
+const ThreadStack = [];
+/**
+ * Get a reference to the current thread.
+ */
+export function useThread() {
+    const thread = ThreadStack.at(-1);
+    if (!thread) {
+        throw new DetailedError('The thread is not available in the current context.', 
+        // language=markdown
+        `\`useThread()\` can only be called from within generator functions.
+      It's not available during rendering.`);
+    }
+    return thread;
+}
+export function startThread(thread) {
+    ThreadStack.push(thread);
+}
+export function endThread(thread) {
+    if (ThreadStack.pop() !== thread) {
+        throw new Error('startThread/endThread was called out of order.');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlVGhyZWFkLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL3VzZVRocmVhZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUMsYUFBYSxFQUFDLE1BQU0saUJBQWlCLENBQUM7QUFFOUMsTUFBTSxXQUFXLEdBQWEsRUFBRSxDQUFDO0FBRWpDOztHQUVHO0FBQ0gsTUFBTSxVQUFVLFNBQVM7SUFDdkIsTUFBTSxNQUFNLEdBQUcsV0FBVyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ2xDLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUNaLE1BQU0sSUFBSSxhQUFhLENBQ3JCLHFEQUFxRDtRQUNyRCxvQkFBb0I7UUFDcEI7MkNBQ3FDLENBQ3RDLENBQUM7SUFDSixDQUFDO0lBQ0QsT0FBTyxNQUFNLENBQUM7QUFDaEIsQ0FBQztBQUVELE1BQU0sVUFBVSxXQUFXLENBQUMsTUFBYztJQUN4QyxXQUFXLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQzNCLENBQUM7QUFFRCxNQUFNLFVBQVUsU0FBUyxDQUFDLE1BQWM7SUFDdEMsSUFBSSxXQUFXLENBQUMsR0FBRyxFQUFFLEtBQUssTUFBTSxFQUFFLENBQUM7UUFDakMsTUFBTSxJQUFJLEtBQUssQ0FBQyxnREFBZ0QsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7QUFDSCxDQUFDIn0=

package/lib/utils/useTime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Get the real time since the start of the animation.
+ *
+ * @remarks
+ * The returned value accounts for offsets caused by functions such as
+ * {@link flow.waitFor}.
+ *
+ * @example
+ * ```ts
+ * // current time: 0s
+ * yield* waitFor(0.02);
+ *
+ * // current time: 0.016(6)s
+ * // real time: 0.02s
+ * const realTime = useTime();
+ * ```
+ */
+export declare function useTime(): number;
+//# sourceMappingURL=useTime.d.ts.map

package/lib/utils/useTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTime.d.ts","sourceRoot":"","sources":["../../src/utils/useTime.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,WAEtB"}

package/lib/utils/useTime.js

@@ -0,0 +1,22 @@
+import { useThread } from './useThread';
+/**
+ * Get the real time since the start of the animation.
+ *
+ * @remarks
+ * The returned value accounts for offsets caused by functions such as
+ * {@link flow.waitFor}.
+ *
+ * @example
+ * ```ts
+ * // current time: 0s
+ * yield* waitFor(0.02);
+ *
+ * // current time: 0.016(6)s
+ * // real time: 0.02s
+ * const realTime = useTime();
+ * ```
+ */
+export function useTime() {
+    return useThread().time();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlVGltZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy91c2VUaW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBQyxTQUFTLEVBQUMsTUFBTSxhQUFhLENBQUM7QUFFdEM7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFNLFVBQVUsT0FBTztJQUNyQixPQUFPLFNBQVMsRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDO0FBQzVCLENBQUMifQ==

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@twick/core",
+  "version": "0.11.0",
+  "description": "A web-based framework for creating videos programmatically",
+  "main": "lib/index.js",
+  "author": "twick",
+  "homepage": "https://re.video/",
+  "bugs": "https://github.com/ncounterspecialist/twick/issues",
+  "license": "MIT",
+  "scripts": {
+    "dev": "tsc -p tsconfig.build.json -w",
+    "build": "tsc -p tsconfig.build.json",
+    "bundle": "rollup -c rollup.config.mjs",
+    "test": "vitest"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ncounterspecialist/twick-base.git"
+  },
+  "files": [
+    "lib",
+    "tsconfig.project.json",
+    "project.d.ts",
+    "shaders"
+  ],
+  "dependencies": {
+    "culori": "^4.0.1",
+    "mp4-wasm": "^1.0.6"
+  },
+  "devDependencies": {
+    "@types/culori": "^2.1.1",
+    "jsdom": "^22.1.0"
+  },
+  "gitHead": "59f38f4e7d3a9a30943bbad830dc0201eaa57ce7"
+}

package/project.d.ts

@@ -0,0 +1,24 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/// <reference types="vite/client" />
+
+declare module '*?img' {
+  const value: Promise<HTMLImageElement>;
+  export = value;
+}
+
+declare module '*?anim' {
+  const value: Promise<HTMLImageElement[]>;
+  export = value;
+}
+
+declare module '*.csv' {
+  const value: unknown;
+  export = value;
+}
+
+declare module '*.glsl' {
+  const value: string;
+  export = value;
+}
+
+declare type Callback = (...args: any[]) => void;

package/shaders/common.glsl

@@ -0,0 +1,15 @@
+in vec2 screenUV;
+in vec2 sourceUV;
+in vec2 destinationUV;
+
+out vec4 outColor;
+
+uniform float time;
+uniform float deltaTime;
+uniform float framerate;
+uniform int frame;
+uniform vec2 resolution;
+uniform sampler2D sourceTexture;
+uniform sampler2D destinationTexture;
+uniform mat4 sourceMatrix;
+uniform mat4 destinationMatrix;

package/shaders/fragment.glsl

@@ -0,0 +1,8 @@
+#version 300 es
+precision highp float;
+
+#include "./common.glsl"
+
+void main() {
+    outColor = textureLod(sourceTexture, sourceUV, 0.0);
+}

package/tsconfig.project.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "sourceMap": true,
+    "noImplicitAny": true,
+    "module": "esnext",
+    "target": "es2020",
+    "allowJs": true,
+    "noEmit": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true
+  }
+}