@motionscript/sdk 0.1.0-alpha.6 → 0.1.0-alpha.8

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @motionscript/sdk
 
+## 0.1.0-alpha.8
+
+## 0.1.0-alpha.7
+
+### Minor Changes
+
+- 737f7d0: What was left of the class authoring system is gone. Each piece existed to write or extend a node class, and a node type is a component now; no built-in, kit or host used them.
+
+  Removed from `@motionscript/core`:
+
+  - the registration functions `property`, `node`, `command` and `withdraw`, and the thirteen typed property helpers (`fillProperty`, `strokeProperty`, `shadowProperty`, `effectsProperty`, `colorProperty`, `cornerRadiusProperty`, `cornerStyleProperty`, `pathProperty`, `insetsProperty`, `alignmentProperty`, `vector2Property`, `sizeProperty`, `textProperty`) with their `AttributePropOptions` type. A component declares its entries with `Types`. `getPropertyMeta`, `getNodeDescriptor`, `getCommandMeta` and the metadata types stay;
+  - `TextSelection`, `TextSelectionHost`, `TextSelectionProps`, `TextRange`, `SelectionOverrides` and `normalizeRanges`: the component `Text` has no selection API, so nothing could make one. Style a range with `runs`;
+  - `AudioScope` and the `declareAudio` hook on `Node`: sound plays from commands (`timeline.sound`). `busPathOf` and `busPathTo` take a function answering a node's span instead of an `AudioScope`;
+  - the `Node.tick` hook and the `Node2D` hooks `beforeRender`, `afterRender`, `renderStroke`, `clipPathSelf`, `resolveSizeInput` and `constraints`, which only a subclass could reach;
+  - `NodeTypeRecord.withdrawn` and `CommandMeta.withdrawn`. `PropertyMeta.withdrawn` stays, deprecated: nothing sets it.
+
+  Removed from `@motionscript/core/component`, and so from `@motionscript/sdk/component` and `@motionscript/charts/kit`, which re-export it: the seekable composition `at`, `hold`, `sequence` and `together`, with the `Seekable` and `Placed` types. A component command returns timeline pieces.
+
+  Removed from `@motionscript/sdk`: `TextSelection`, `TextSelectionProps`, `TextRange`, `SelectionOverrides`, `AudioScope` and `AudioClip`.
+
 ## 0.1.0-alpha.6
 
 ### Minor Changes

package/NOTICE

@@ -4,24 +4,25 @@ Copyright 2026 Motionscript LLC
 This product includes the third-party code below, each part under the MIT
 License reproduced at the end of this file.
 
-- packages/skia-render/src/fills/fractal-noise.ts: `hash2` is "Hash without
-  Sine" by David Hoskins (https://www.shadertoy.com/view/4djSRW).
+- packages/renderer/crates/renderer/src/shaders/prim.wgsl (`fn_hash2`):
+  "Hash without Sine" by David Hoskins (https://www.shadertoy.com/view/4djSRW).
   Copyright (c) 2014 David Hoskins.
 
-- packages/skia-render/src/fills/fractal-noise.ts: `simplexNoise` follows
-  "Noise - simplex - 2D" by Inigo Quilez (https://www.shadertoy.com/view/Msf3WH).
-  Copyright (c) 2013 Inigo Quilez.
+- packages/renderer/crates/renderer/src/shaders/prim.wgsl (`simplex_noise`): "Noise - simplex - 2D" by Inigo Quilez
+  (https://www.shadertoy.com/view/Msf3WH). Copyright (c) 2013 Inigo Quilez.
 
-The project website, which is in the source repository only and in no npm
-package, also includes MIT code: its landing-page background
-(packages/site/components/landing/GradientBackground.tsx) uses 3D simplex
-noise from webgl-noise by Ian McEwan, Ashima Arts
-(https://github.com/ashima/webgl-noise). Copyright (C) 2011 by Ashima Arts.
+- packages/renderer/crates/render3d (in @motionscript/renderer's WebAssembly):
+  its shaders (src/shaders/mesh.wgsl) port three.js r185's mesh programs and
+  src/geometry.rs its primitive generators (https://threejs.org).
+  Copyright (c) 2010-2026 three.js authors.
 
-@motionscript/canvaskit is a build of Skia's CanvasKit (BSD-3-Clause,
-Copyright (c) 2011 Google Inc.) and carries FreeType, HarfBuzz, ICU, zlib,
-libpng, Brotli, WOFF2, Emscripten and musl; their notices are in
-packages/canvaskit/THIRD_PARTY_NOTICES.txt.
+@motionscript/renderer's WebAssembly (dist/ms_renderer_bg.wasm) compiles in
+Rust crates under MIT, Apache-2.0, Zlib and Unicode-3.0 terms (wgpu, naga,
+harfrust, read-fonts, kurbo, wasm-bindgen and others); their notices are in
+packages/renderer/THIRD_PARTY_NOTICES.txt.
+
+MP3 export loads @mediabunny/mp3-encoder (MPL-2.0), a WebAssembly build of
+the LAME MP3 encoder (LGPL, https://lame.sourceforge.io), on first use.
 
 The browser builds under dist/browser/ bundle each package's npm dependencies;
 dist/browser/THIRD_PARTY_LICENSES.txt in each package lists them with their

package/README.md

@@ -15,7 +15,7 @@ Install it with a rendering backend such as
 [`@motionscript/browser`](https://github.com/motionscript-dev/motionscript/tree/main/packages/browser):
 
 ```bash
-npm install @motionscript/sdk @motionscript/core @motionscript/browser @motionscript/canvaskit
+npm install @motionscript/sdk @motionscript/core @motionscript/browser
 ```
 
 `@motionscript/core` is a peer dependency rather than a bundled one: the
@@ -44,8 +44,7 @@ const doc: CompositionDocument = {
   ],
 };
 
-// Serve canvaskit.wasm from @motionscript/canvaskit as a static file.
-const engine = await createBrowserEngine({ wasmUrl: '/canvaskit.wasm' });
+const engine = await createBrowserEngine();
 const session = engine.open({ document: doc, target: document.querySelector('canvas')! });
 session.playback!.play();
 ```
@@ -54,7 +53,7 @@ A scene is data: nodes, and commands placed at times, so any frame can be asked
 for directly and a seek costs the same in either direction. Custom drawing, and
 anything JSON cannot express, belongs in a component registered with the engine
 and named by key (see [Writing a node type](#writing-a-node-type)). Flow layout,
-fills, gradients, filters, SkSL shader effects, paths, text, audio and 3D are
+fills, gradients, filters, WGSL shader effects, paths, text, audio and 3D are
 all supported. See the
 [docs](https://motionscript.dev/docs) for the full feature set.
 
@@ -62,7 +61,9 @@ all supported. See the
 
 - **Documents & projects**: the `ProjectDocument`, `StillDocument`,
   `CompositionDocument` and `AudioDocument` types, `asProjectDocument`,
-  `validateDocument`, and the `Registry` a document compiles against.
+  `validateDocument`, `migrateDocument` (and `DOCUMENT_FORMAT_VERSION`,
+  `DocumentTooNewError`, `migrateNodeProps`) for documents saved by older
+  releases, and the `Registry` a document compiles against.
 - **Nodes**: geometry (`Rect`, `Ellipse`, `Path`, `Polygon`,
   `Polygram`, `MaskGroup`, `BooleanGroup`), text (`Text`,
   `RichText`, `NumberNode`), structure (`Canvas2D`, `Canvas3D`, `Camera`), and
@@ -78,10 +79,11 @@ all supported. See the
   type's own), each placed at a time, easing (`linear`, `easeIn`,
   `easeOut`, `easeInOut`), and interpolation (`lerpNumber`).
 - **Styling & effects**: `Fills`, `Effects`, `Adjustments`, `VideoAdjustments`,
-  `AudioFilters`, plus the `Stroke`/`Shadow`/`Corners` attribute types.
+  `AudioEffects`, plus the `Stroke`/`Shadow`/`Corners` attribute types.
   `ImageFilters` and `VideoFilters` remain as `@deprecated` aliases until the
   next major.
-- **Audio**: the `SoundNode` and `AudioBus` nodes.
+- **Audio**: the `SoundNode` and `AudioBus` nodes, and `ramp`/`hold` for
+  JSON automation of their levels, speed and effects.
 - **Utilities**: `createRef`, `clamp`, `generateList`, `createContext`,
   `Random`.
 - **Component machinery**: `@motionscript/sdk/component`, what a component
@@ -111,8 +113,8 @@ lists live in core, in `src/sdk/index.ts` (named exports, no wildcards) and
 `src/component.ts` (eight `export *` lines), so there is one list rather than two
 that drift. A name an author would reasonably reach for is added to core's
 `src/sdk/index.ts`; rebuilding core adds it here with no edit in this package.
-One that only a host or a test needs stays in core. `Curve` and `FillChain` are
-classes in core but exported as types here: named, never constructed.
+One that only a host or a test needs stays in core. `FillChain` is a class in
+core but exported as a type here: named, never constructed.
 
 The types and values resolve through core's built `dist/`, so nothing imports
 until core has been built. `src/tests/sdk-parity.test.ts` in core compares this
@@ -138,7 +140,7 @@ export const Gauge = component2d({
   })),
 });
 
-const engine = await createBrowserEngine({ wasmUrl: '/canvaskit.wasm', nodes: [Gauge] });
+const engine = await createBrowserEngine({ nodes: [Gauge] });
 ```
 
 The factory generates the node class, declares its key and writes its entries
@@ -157,7 +159,7 @@ export to its file and lists core under `peers`. An import map names
 subpaths) once, and every kit loaded beside them shares both.
 
 This package has no rendering backend of its own. Pair it with
-[`@motionscript/browser`](https://github.com/motionscript-dev/motionscript/tree/main/packages/browser) (Skia/CanvasKit), and use
+[`@motionscript/browser`](https://github.com/motionscript-dev/motionscript/tree/main/packages/browser) (WebGPU), and use
 [`@motionscript/react`](https://github.com/motionscript-dev/motionscript/tree/main/packages/react) to mount a player in a React app. See the
 [docs](https://motionscript.dev/docs) for the full API reference.
 

package/dist/browser/component.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/component.ts"],
-  "sourcesContent": ["/**\r\n * `@motionscript/sdk/component` — what a component package needs beyond the\r\n * authoring barrel: seekable entrances (`at`, `sequence`, `together`, `hold`,\r\n * `compose`, `drive`, and `asCommand` to return one from a `@command()` method),\r\n * `declarePaints`, number formatting and the orbit-camera lerps.\r\n *\r\n * A subpath, not part of `.`, because a scene author never reaches for it and\r\n * one name collides: `hold` here is a seekable pause, where the barrel's `hold`\r\n * is an audio curve. The curation is `@motionscript/core/component`'s, for the\r\n * same reason `index.ts` passes through `@motionscript/core/sdk`.\r\n */\r\nexport * from \"@motionscript/core/component\";\r\n"],
-  "mappings": "AAWA,WAAc",
+  "sourcesContent": ["/**\r\n * `@motionscript/sdk/component` — what a component package needs beyond the\r\n * authoring barrel: number formatting, text defaults, the named shape outlines\r\n * and the orbit-camera lerps.\r\n *\r\n * A subpath, not part of `.`, because a scene author never reaches for it. The\r\n * curation is `@motionscript/core/component`'s, for the same reason\r\n * `index.ts` passes through `@motionscript/core/sdk`.\r\n */\r\nexport * from \"@motionscript/core/component\";\r\n"],
+  "mappings": "AASA,WAAc",
   "names": []
 }

package/dist/browser/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/sdk",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "exports": {
     ".": "dist/browser/index.js",
     "./component": "dist/browser/component.js"

package/dist/component.d.ts

@@ -1,13 +1,11 @@
 /**
  * `@motionscript/sdk/component` — what a component package needs beyond the
- * authoring barrel: seekable entrances (`at`, `sequence`, `together`, `hold`,
- * `compose`, `drive`, and `asCommand` to return one from a `@command()` method),
- * `declarePaints`, number formatting and the orbit-camera lerps.
+ * authoring barrel: number formatting, text defaults, the named shape outlines
+ * and the orbit-camera lerps.
  *
- * A subpath, not part of `.`, because a scene author never reaches for it and
- * one name collides: `hold` here is a seekable pause, where the barrel's `hold`
- * is an audio curve. The curation is `@motionscript/core/component`'s, for the
- * same reason `index.ts` passes through `@motionscript/core/sdk`.
+ * A subpath, not part of `.`, because a scene author never reaches for it. The
+ * curation is `@motionscript/core/component`'s, for the same reason
+ * `index.ts` passes through `@motionscript/core/sdk`.
  */
 export * from "@motionscript/core/component";
 //# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,8BAA8B,CAAC"}

package/dist/component.js

@@ -1,13 +1,11 @@
 /**
  * `@motionscript/sdk/component` — what a component package needs beyond the
- * authoring barrel: seekable entrances (`at`, `sequence`, `together`, `hold`,
- * `compose`, `drive`, and `asCommand` to return one from a `@command()` method),
- * `declarePaints`, number formatting and the orbit-camera lerps.
+ * authoring barrel: number formatting, text defaults, the named shape outlines
+ * and the orbit-camera lerps.
  *
- * A subpath, not part of `.`, because a scene author never reaches for it and
- * one name collides: `hold` here is a seekable pause, where the barrel's `hold`
- * is an audio curve. The curation is `@motionscript/core/component`'s, for the
- * same reason `index.ts` passes through `@motionscript/core/sdk`.
+ * A subpath, not part of `.`, because a scene author never reaches for it. The
+ * curation is `@motionscript/core/component`'s, for the same reason
+ * `index.ts` passes through `@motionscript/core/sdk`.
  */
 export * from "@motionscript/core/component";
 //# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC","sourcesContent":["/**\r\n * `@motionscript/sdk/component` — what a component package needs beyond the\r\n * authoring barrel: seekable entrances (`at`, `sequence`, `together`, `hold`,\r\n * `compose`, `drive`, and `asCommand` to return one from a `@command()` method),\r\n * `declarePaints`, number formatting and the orbit-camera lerps.\r\n *\r\n * A subpath, not part of `.`, because a scene author never reaches for it and\r\n * one name collides: `hold` here is a seekable pause, where the barrel's `hold`\r\n * is an audio curve. The curation is `@motionscript/core/component`'s, for the\r\n * same reason `index.ts` passes through `@motionscript/core/sdk`.\r\n */\r\nexport * from \"@motionscript/core/component\";\r\n"]}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,8BAA8B,CAAC","sourcesContent":["/**\r\n * `@motionscript/sdk/component` — what a component package needs beyond the\r\n * authoring barrel: number formatting, text defaults, the named shape outlines\r\n * and the orbit-camera lerps.\r\n *\r\n * A subpath, not part of `.`, because a scene author never reaches for it. The\r\n * curation is `@motionscript/core/component`'s, for the same reason\r\n * `index.ts` passes through `@motionscript/core/sdk`.\r\n */\r\nexport * from \"@motionscript/core/component\";\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/sdk",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "type": "module",
   "description": "The Motion Script authoring surface behind one import: document types, components and their modules, commands, styling, and the machinery component kits build on.",
   "repository": {
@@ -18,6 +18,7 @@
     "animation"
   ],
   "license": "Apache-2.0",
+  "author": "Motionscript",
   "publishConfig": {
     "access": "public"
   },
@@ -41,7 +42,7 @@
     }
   },
   "peerDependencies": {
-    "@motionscript/core": "^0.1.0-alpha.6"
+    "@motionscript/core": "^0.1.0-alpha.8"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",
@@ -53,7 +54,7 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.48.0",
     "vitest": "^4.1.5",
-    "@motionscript/core": "0.1.0-alpha.6"
+    "@motionscript/core": "0.1.0-alpha.8"
   },
   "scripts": {
     "build": "eslint . && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node ../../scripts/build-browser.mjs",