@osmo.inc/cli-linux-arm64 0.1.19 → 0.1.21

package/node_modules/zod/v4/package.json

@@ -0,0 +1,7 @@
+{ 
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.cts",
+  "sideEffects": false
+}

package/node_modules/zod/v4-mini/index.cjs

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+const z = __importStar(require("../v4/mini/external.cjs"));
+exports.z = z;
+__exportStar(require("../v4/mini/external.cjs"), exports);
+
+// seal-cjs-exports
+(function () {
+  var keys = Object.getOwnPropertyNames(exports);
+  for (var i = 0; i < keys.length; i++) {
+    var desc = Object.getOwnPropertyDescriptor(exports, keys[i]);
+    if (!desc || !desc.get || !desc.configurable) continue;
+    var value;
+    try {
+      value = desc.get();
+    } catch (e) {
+      continue;
+    }
+    // a circular require may not have settled this one yet, so leave it live
+    if (value === undefined) continue;
+    Object.defineProperty(exports, keys[i], { value: value, writable: false, enumerable: desc.enumerable, configurable: false });
+  }
+  Object.freeze(exports);
+})();

package/node_modules/zod/v4-mini/index.d.cts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.cjs";
+export * from "../v4/mini/external.cjs";
+export { z };

package/node_modules/zod/v4-mini/index.d.ts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };

package/node_modules/zod/v4-mini/index.js

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };

package/node_modules/zod/v4-mini/package.json

@@ -0,0 +1,7 @@
+{ 
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.cts",
+  "sideEffects": false
+}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "files": [
     "dist",
@@ -18,10 +18,12 @@
   },
   "dependencies": {
     "typescript": "5.9.3",
+    "zod": "4.6.5",
     "esbuild": "0.27.4"
   },
   "bundleDependencies": [
-    "typescript"
+    "typescript",
+    "zod"
   ],
   "osmo": {
     "sceneVersion": "0.1.0"

package/release.json

@@ -1,36 +1,37 @@
 {
-  "version": "0.1.19",
+  "version": "0.1.21",
   "package": "@osmo.inc/cli-linux-arm64",
   "platform": "linux-arm64",
   "channel": "latest",
-  "sourceCommit": "8256a0d29c67b090c37504207a379b0924c735e7",
+  "sourceCommit": "4b080c211a2f5b025d0911a28a2999d17aec21d9",
   "sourceDirty": false,
   "signing": "unsigned",
   "licenseFileIncluded": false,
-  "dependencyCount": 232,
+  "dependencyCount": 298,
   "nativeDefaultFeatures": false,
   "contents": {
-    "totalBytes": 53140218,
-    "fileCount": 947,
+    "totalBytes": 60478252,
+    "fileCount": 1925,
     "groups": {
-      "vendor": 18350716,
-      "studio": 17122088,
+      "vendor": 18527757,
+      "studio": 17834718,
       "node_modules/typescript": 9913238,
-      "third-party": 4722136,
+      "node_modules/zod": 6140311,
+      "third-party": 4941579,
       "src": 2622428,
-      "dist": 269721,
-      "runtime": 137987,
+      "dist": 339125,
+      "runtime": 157161,
       "THIRD_PARTY_NOTICES.md": 1090,
-      "package.json": 814
+      "package.json": 845
     },
     "largestFiles": [
       {
         "path": "vendor/osmo-lite",
-        "bytes": 18314952
+        "bytes": 18486984
       },
       {
         "path": "studio/src/engine_bg.wasm",
-        "bytes": 12010921
+        "bytes": 12109447
       },
       {
         "path": "node_modules/typescript/lib/typescript.js",
@@ -38,7 +39,7 @@
       },
       {
         "path": "studio/src/app.js",
-        "bytes": 4767135
+        "bytes": 5244027
       },
       {
         "path": "node_modules/typescript/lib/lib.dom.d.ts",
@@ -65,57 +66,57 @@
         "bytes": 370430
       },
       {
-        "path": "third-party/rust-standard-library/COPYRIGHT-library.html",
-        "bytes": 279302
+        "path": "dist/studio.js",
+        "bytes": 339125
       },
       {
-        "path": "dist/studio.js",
-        "bytes": 269721
+        "path": "third-party/rust-standard-library/COPYRIGHT-library.html",
+        "bytes": 279302
       },
       {
         "path": "node_modules/typescript/lib/lib.es5.d.ts",
         "bytes": 218439
       },
       {
-        "path": "src/starter/animations/osmo/shape34-0.tsx",
-        "bytes": 139902
+        "path": "node_modules/zod/src/v4/core/schemas.ts",
+        "bytes": 175664
       },
       {
-        "path": "third-party/npm/mediabunny@1.52.2/source/src/isobmff/isobmff-demuxer.ts",
-        "bytes": 118682
+        "path": "studio/src/app.css",
+        "bytes": 168192
       },
       {
-        "path": "src/starter/animations/osmo/shape8-83.tsx",
-        "bytes": 112489
+        "path": "node_modules/zod/src/v3/types.ts",
+        "bytes": 160442
       },
       {
-        "path": "third-party/npm/mediabunny@1.52.2/source/src/sample.ts",
-        "bytes": 107841
+        "path": "node_modules/zod/src/v4/classic/tests/to-json-schema.test.ts",
+        "bytes": 144923
       },
       {
-        "path": "third-party/npm/mediabunny@1.52.2/source/src/media-source.ts",
-        "bytes": 97606
+        "path": "node_modules/zod/v3/types.cjs",
+        "bytes": 140924
       },
       {
-        "path": "studio/src/app.css",
-        "bytes": 95067
+        "path": "src/starter/animations/osmo/shape34-0.tsx",
+        "bytes": 139902
       },
       {
-        "path": "third-party/npm/mediabunny@1.52.2/source/src/codec-data.ts",
-        "bytes": 92683
+        "path": "node_modules/zod/v3/types.js",
+        "bytes": 131408
       }
     ]
   },
   "hashes": {
-    "dist/studio.js": "be67ed4c321a22a87a446d893f89b4bd342f30290bf519a85c1aea784b612acd",
-    "vendor/osmo-lite": "4a81a51e3c3121597e64c3b2d9b06d72d471fd993a79af61086cebcb70fe3bf8",
-    "studio/src/engine_bg.wasm": "889927bd262b27f34e2495a90810fae3295adcfda80c7fda7b2dbd7d13eb8ee1",
-    "studio/src/app.js": "ca23cc9220cb68e3d23eb3c771c80b1221a971c1c1ace207ebf2acc4e1f24272",
-    "studio/src/app.css": "aa53a4e2206280c169981d9940f042539e70b2c665895a3e041830c6f41d8ffe",
-    "third-party/inventory.json": "fe5ca3c8784ad803bf5ecdc227071301115eec6ea2d220fe96aa2024f59902e6"
+    "dist/studio.js": "268493181e06000c539daa723ad1b760967970b023ed25e42a84dee8489fa8f3",
+    "vendor/osmo-lite": "f222c6e4f861cf219af736545e66d03cc35bb16b240d1bd64d224f364042fbeb",
+    "studio/src/engine_bg.wasm": "fadf7cc6517dc6b4e78b0e1df6d0f58b3eee19174bf0fc7348d30bd55524e0af",
+    "studio/src/app.js": "6c3062c4d57ffb4d5c3e24927836e6e0ac278af2739487d16f0d3da3353761b4",
+    "studio/src/app.css": "2d97ea2031a434deaf6bd6cd31a9f9536837592ec4ce3d10a7e8a215d42ea59e",
+    "third-party/inventory.json": "49062ad067631946356ecb120f0b461beb5fd75e16c660cec42b19de31f62502"
   },
   "lockfiles": {
-    "package-lock.json": "a7fb6b84762aeb4f3ce90166df48f53c2853d2684282ed1c019502f840602e28",
+    "package-lock.json": "98649cc0705b11ac56bf94f5ce3eee9e8c725d32981968de0a44e4c7730eb2fb",
     "apps/native/Cargo.lock": "cf31d67cf167c5f32438abfeb42159eb50da61d36e4e482bae50ed3d71241373",
     "packages/render-engine/Cargo.lock": "a1a68051e1eea30ef0fa46bf17cd0685bb2c6a327defed0405e0d63dd61017a7"
   }

package/runtime/apps/native/tools/compile.mjs

@@ -33,14 +33,15 @@ const result = await build({
 			const overridden = Object.hasOwn(sources, file);
 			const text = overridden ? sources[file] : await readFile(file, "utf8");
             const loader = /tsx$/.test(file) ? "tsx" : /jsx$/.test(file) ? "jsx" : /[cm]?ts$/.test(file) ? "ts" : "js";
-            if (!text.includes("defineEffect")) return overridden ? {contents:text,loader} : undefined;
+            if (!text.includes("defineEffect") && !text.includes("defineKnobs")) return overridden ? {contents:text,loader} : undefined;
 			const ast = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
-			const names = new Set(), namespaces = new Set();
+			const names = new Set(), knobNames = new Set(), namespaces = new Set();
 			for (const statement of ast.statements) {
 				if (!ts.isImportDeclaration(statement) || statement.moduleSpecifier.text !== "@osmo/scene") continue;
 				const imports = statement.importClause?.namedBindings;
 				if (imports && ts.isNamedImports(imports)) for (const item of imports.elements) {
 					if ((item.propertyName ?? item.name).text === "defineEffect") names.add(item.name.text);
+                    if ((item.propertyName ?? item.name).text === "defineKnobs") knobNames.add(item.name.text);
 				}
 				if (imports && ts.isNamespaceImport(imports)) namespaces.add(imports.name.text);
 			}
@@ -51,6 +52,12 @@ const result = await build({
 						ts.isPropertyAccessExpression(node.expression) && ts.isIdentifier(node.expression.expression) && namespaces.has(node.expression.expression.text) && node.expression.name.text === "defineEffect")) {
 						return ts.factory.updateCallExpression(node, node.expression, node.typeArguments, [ts.visitNode(node.arguments[0], visit), ts.factory.createStringLiteral(file)]);
 					}
+                    if (ts.isCallExpression(node) && node.arguments.length <= 2 &&
+                        (ts.isIdentifier(node.expression) && knobNames.has(node.expression.text) ||
+                        ts.isPropertyAccessExpression(node.expression) && ts.isIdentifier(node.expression.expression) && namespaces.has(node.expression.expression.text) && node.expression.name.text === "defineKnobs")) {
+                        return ts.factory.updateCallExpression(node, node.expression, node.typeArguments,
+                            [node.arguments[0], node.arguments[1] ?? ts.factory.createObjectLiteralExpression(), ts.factory.createStringLiteral(file)]);
+                    }
 					return ts.visitEachChild(node, visit, context);
 				};
 				return ts.visitNode(root, visit);
@@ -128,6 +135,7 @@ async function collectEffects(target) {
 async function collectFonts(nodes) {
 	for (const node of nodes) {
 		await collectEffects(node);
+        for (const state of node.animate?.states ?? []) await collectEffects(state);
         if(node.type === "composition") { await collectEffects(node.scene); await collectFonts(node.scene.children); }
 		if (["group","model","surface"].includes(node.type)) await collectFonts(node.children);
 		if (["image", "video", "audio", "model"].includes(node.type)) {

package/runtime/packages/scene/scripts/validate-strict.mjs

@@ -30,8 +30,11 @@ export function validate(file, mode, options = {}) {
     const ast = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
     const errors = [];
     const fail = (n, msg) => { const p = ast.getLineAndCharacterOfPosition(n.getStart(ast)); errors.push(`${p.line + 1}:${p.character + 1} ${msg}`); };
-    for (const d of ast.parseDiagnostics)
-        errors.push(ts.flattenDiagnosticMessageText(d.messageText, '\n'));
+    // A syntax error is placed like every other error: line:col, then what is wrong.
+    for (const d of ast.parseDiagnostics) {
+        const p = ast.getLineAndCharacterOfPosition(d.start);
+        errors.push(`${p.line + 1}:${p.character + 1} ${ts.flattenDiagnosticMessageText(d.messageText, '\n')}`);
+    }
     const allowed = new Set(['Scene', 'Camera', 'Group', 'Rect', 'Path', 'Text', 'Image', 'Video', 'Audio', 'Model', 'Surface', 'Fragment', 'defineMotion', 'defineKnobs', 'Shader', 'sampleMotion', 'describeMotion', 'blur', 'grain']);
     allowed.add('defineEffect');
     const importedGroups = new Set(), sourceIds = new Set(), effects = new Set();
@@ -177,7 +180,7 @@ export function validate(file, mode, options = {}) {
             }
             if (['hidden', 'solo'].includes(a.name.text)) {
                 try {
-                    if (tag !== 'Group' && !importedGroups.has(tag)) throw new Error('hidden and solo belong to Groups only');
+                    if (a.name.text === 'solo' && tag !== 'Group' && !importedGroups.has(tag)) throw new Error('solo belongs to Groups only');
                     readGroupPlayback({[a.name.text]: a.initializer ? metadataLiteral(a.initializer) : true});
                 } catch (error) { fail(a, error.message); }
             }

package/runtime/packages/scene/src/assets.ts

@@ -0,0 +1,27 @@
+/** Local asset contracts shared by authoring, evaluation and the editor. */
+export type AssetKind = "image" | "video" | "audio" | "font" | "model";
+/** Plain paths remain valid; typed knob references retain their asset kind. */
+export type AssetPath<K extends AssetKind> = string & {
+	readonly __assetKind?: K;
+};
+export const assetExtensions: Record<AssetKind, readonly string[]> = {
+	image: ["png", "jpg", "jpeg", "webp", "gif", "svg"],
+	video: ["mp4", "webm", "mov", "m4v"],
+	audio: ["wav", "mp3", "m4a", "aac", "ogg", "flac"],
+	font: ["ttf", "otf"],
+	model: ["glb"],
+};
+export function validAssetPath(
+	kind: AssetKind,
+	value: unknown,
+): value is string {
+	return (
+		Object.hasOwn(assetExtensions, kind) &&
+		typeof value === "string" &&
+		value.length > 0 &&
+		value.length <= 4096 &&
+		value === value.trim() &&
+		!/^[a-z][a-z0-9+.-]*:|^[/\\]|[\x00-\x1f?#\\]/i.test(value) &&
+		assetExtensions[kind].includes(value.split(".").at(-1)!.toLowerCase())
+	);
+}

package/runtime/packages/scene/src/elements.ts

@@ -1,3 +1,5 @@
+import type { AssetPath } from "./assets.js";
+import type { TextAnimation } from "./text-animation.js";
 import type { EffectInstance } from "./effects.js";
 import type { KnobRef, KnobSet, KnobBindings } from "./knobs.js";
 import type { Knobs } from "./knob-schema.js";
@@ -13,7 +15,7 @@ export type Input<T> = KnobRef<T> | (T extends number
 	? T | Motion<T>
 	: T extends readonly number[]
 		? T | Motion<T> | { readonly [K in keyof T]: Input<T[K]> }
-		: T extends object
+		: T extends string ? T : T extends object
 			? { readonly [K in keyof T]: Input<T[K]> }
 			: T);
 export type InputProps<P> = {
@@ -61,6 +63,8 @@ export interface ClipProps {
 /** Explicit contract for root clips; JSX parent placement is checked by the validator. */
 export interface RootClipProps extends ClipProps { track: number; }
 export interface TransformProps extends ClipProps {
+	/** Exclude this layer and its descendants from evaluation and layout; preserve authored opacity. */
+	hidden?: boolean;
 	/** Applied in array order; each pass receives the previous result. Default: none. */
 	effects?: readonly EffectInstance[];
 	/** Local [x, y] in pixels; +X right, +Y down. Default: [0, 0]. */
@@ -69,14 +73,14 @@ export interface TransformProps extends ClipProps {
 	z?: number;
 	/** Clockwise degrees around origin. Default: 0. */
 	rotation?: number;
-	/** Uniform factor or [x, y] factors. Default: 1. */
-	scale?: number | Vec2;
+	/** Uniform factor applied to both axes. Default: 1. */
+	scale?: number;
 	/** Local pivot in pixels, not a fraction. Default: [0, 0]. */
 	origin?: Vec2;
 	/** 0–1. Group opacity composites its children together. Default: 1. */
 	opacity?: number;
 }
-export interface SceneProps {
+export interface SceneStyleProps {
 	/** Optional lane metadata keyed by track number (0–99). Labels are static, one word maximum. Does not change paint order. */
 	tracks?: Readonly<Record<number, TrackMetadata>>;
 	/** Filter the complete viewport, including 3D surfaces; array order matters. */
@@ -90,9 +94,14 @@ export interface SceneProps {
 	/** Positive frames per second; static. Default: 30. */
 	fps?: number;
 	/** Fixed viewport backdrop, independent of camera and layout. Default: transparent. */
-	background?: Color;
+	background?: Input<Color>;
 	children?: Child;
 }
+/** Scene controls follow the same ownership and instance rules as Groups. */
+export type SceneProps<K extends Knobs = Knobs> = SceneStyleProps & (
+  | { knobs: KnobSet<K>; values?: KnobBindings<NoInfer<K>> }
+  | { knobs?: never; values?: never }
+);
 /** Timeline lane metadata; independent of the clips occupying the lane. */
 export interface TrackMetadata {
 	/** Optional static display name, one word maximum, e.g. "Titles". */
@@ -179,12 +188,16 @@ export type SceneInstanceProps = InputProps<TransformProps & {
     width?: number;
     /** Viewport height in pixels; defaults to the source scene height. Does not scale content. */
     height?: number;
-}> & { label?: string; hidden?: boolean; solo?: boolean; trimIn?: number };
+}> & {
+    label?: string; hidden?: boolean; solo?: boolean; trimIn?: number;
+    /** Overrides for the controls declared by the source Scene. */
+    values?: Readonly<Record<string, MotionValue | Motion | KnobRef>>;
+};
 /** JSX attribute contract for imported static Group documents (legacy) and Scenes. */
-export type GroupInstance = (props: GroupInstanceProps) => Element;
+export type GroupInstance = (props: GroupInstanceProps | SceneInstanceProps) => Element;
 export interface ImageProps extends TransformProps {
 	/** Local PNG/JPEG/WebP/SVG path, relative to this TSX file; no remote URLs. */
-	src: string;
+	src: AssetPath<"image">;
 	/** Positive box width in pixels. */
 	width: number;
 	/** Positive box height in pixels. */
@@ -213,8 +226,10 @@ export interface ShaderProps extends TransformProps {
 /** A selector is a unique GLB name or its document index. */
 export type ModelSelector = string | number;
 export interface ModelProps extends ClipProps {
+    /** Exclude this model and its children from the evaluated scene. */
+    hidden?: boolean;
 	/** Local .glb path. Uses the default GLB scene; inspect node/material/clip names before targeting them. */
-	src: string;
+	src: AssetPath<"model">;
 	/** Composition [x, y] in pixels. Default: scene center. */
 	position?: Vec2;
 	/** Depth in pixels; positive toward the viewer. Default: 0. */
@@ -269,10 +284,10 @@ export interface MediaTiming extends ClipProps {
 	/** Gain from 0–1; animatable in JSX. Use 0 to mute video audio. Default: 1. */
 	volume?: number;
 }
-export interface VideoProps extends ImageProps, MediaTiming {}
+export interface VideoProps extends Omit<ImageProps, "src">, MediaTiming { src: AssetPath<"video"> }
 export interface AudioProps extends MediaTiming {
 	/** Local audio file path, relative to this TSX file. */
-	src: string;
+	src: AssetPath<"audio">;
 }
 
 /** SVG-style stroke painted along the contour, centered on its geometry. */
@@ -338,7 +353,7 @@ export interface TextStyleProps extends TransformProps {
 	/** Whole string or number; the renderer handles shaping, kerning and glyph placement. */
 	children: string | number;
 	/** Bundled Inter or a local .ttf/.otf path relative to this TSX file. Default: Inter. */
-	font?: string;
+	font?: AssetPath<"font">;
 	/** Positive size in pixels. Default: 48. */
 	fontSize?: number;
 	/** Requested font weight; omitted uses the selected face’s default. */
@@ -351,6 +366,8 @@ export interface TextStyleProps extends TransformProps {
 export type TextProps = TextStyleProps & (
 	| {
       path?: never;
+      /** Staggered post-layout character, word or visual-line animation. */
+      animate?: TextAnimation;
       /** Positive wrapping width in pixels; omitted uses natural text width. */
       width?: number;
       /** Positive text-box height. Overflow remains visible; use a clipping Group to crop. */
@@ -367,6 +384,7 @@ export type TextProps = TextStyleProps & (
 	| {
       /** Move a whole string along a curve by animating progress. No width, align, lineHeight or line breaks. */
       path: TextPath;
+      animate?: never;
       width?: never;
       height?: never;
       verticalAlign?: never;
@@ -402,6 +420,8 @@ export interface Element {
 	readonly props: Readonly<Record<string, unknown>>;
 	readonly key?: string | number;
 	readonly sourceFile?: string;
+    /** File supplying each literal instance override. */
+    readonly valueSources?: Readonly<Record<string, string>>;
 }
 export function element(
 	type: Element["type"],
@@ -418,7 +438,7 @@ export function element(
 /** Root composition with fixed dimensions, duration and FPS.
  * @example <Scene width={1080} height={1080} duration={4} fps={30} background="#141414"><Text track={0}>Hello</Text></Scene> */
 export const Scene = Object.assign(
-	(props: SceneProps): Element => element("scene", props),
+	<const K extends Knobs = Knobs>(props: SceneProps<K>): Element => element("scene", props),
 	{ sceneRoot: true as const },
 );
 /** Layout, transform and style children together; also draws boxes, ellipses and thin lines.