@motionscript/sdk 0.1.0-alpha.0 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @motionscript/sdk
 
+## 0.1.0-alpha.3
+
+### Patch Changes
+
+- 6697bb4: Every chart command runs from a document.
+
+  - Thirteen of the twenty chart commands returned a composition of seekable parts rather than a `Command`, so a document naming one failed to compile with `TypeError: made.at is not a function`: `enter` on all three charts, `showSeries`, `hideSeries` and `spotlightSeries` on the line and bar charts, and `selectSlice`, `deselectSlice`, `selectOnlySlice` and `clearSelection` on the pie. So did `zoomTo` with a region naming neither axis, and `resetZoom` before any zoom. Each now returns a `Command` that lasts the duration it was given. A line or bar `enter` without a legend, whose beats end before that, holds its last frame for the rest of it.
+  - `@motionscript/sdk/component` gains `asCommand(part, duration?)`, which makes a composition built with `at`, `sequence`, `together`, `hold`, `compose` or `drive` the `Command` a `@command()` method returns. A part that ends before `duration` holds its last frame, and one that runs longer is played faster, so the command always ends where the part does.
+  - A line chart's first `zoomTo` from an auto axis tweens. It started from the unset range and ticks, which the axis tween steps at the midpoint, so the first zoom cut halfway through and only later ones moved. A zoom, and `resetZoom`, now start from the range and ticks the axis draws.
+
+- ffd26fd: A `protein`'s `color` now paints. The prop resolves to an RGBA tuple when it is written, and `hexOf` turned anything that was not a string into `#ffffff`. So `colorScheme: 'uniform'` painted every atom, bond, tube and ribbon white whatever `color` was, the `residue` scheme's fallback was white, and a tween of `color` changed nothing. `hexOf` now writes any `Color` as hex through `colorOps`, so `color` drives `uniform` and the fallbacks, and a change to it rebuilds the cached tints. The `element`, `chain`, `secondary` and `residue` colours are unchanged.
+
+  `colorOps` is now exported from `@motionscript/sdk`, and it gains `hex(value)`, which writes any `Color` as `#rrggbb`, or as `#rrggbbaa` when it is not opaque.
+
+- 59c9944: A subclass that redeclares a `@property` or a `@command()` its base already declares now overrides it. `getPropertyMeta` and `getCommandMeta` kept the base's declaration and dropped the subclass's, so a redeclared default, mapper, tween or editor option, or a command's `args` and `name`, never took effect. The most-derived declaration of each key now wins, whole, in the position the base gave it, and an inherited key the subclass does not redeclare is kept as declared. `Registry.describe`, a node type's command table and a new instance's values all read that one declaration.
+
+  A bare `Globe` now starts at its own camera and key light (orbit −10, elevation 25, zoom 2.8, ambient 0.55, key 1.9) rather than `Canvas3D`'s (35, 20, 12, 0.45, 2.4), which framed it as a small disc twelve radii away. A bare `Protein` likewise starts at elevation 18, zoom 2.6, ambient 0.55 and key 1.6. `describe("graph3d")` no longer reports `Canvas3D`'s defaults for `orbit`, `elevation` and `zoom`, which a graph derives from `camera.initialPosition`.
+
+## 0.1.0-alpha.2
+
+### Patch Changes
+
+- 0227e28: A command published under a key of its own, `@command({ key: "press" }) pulse()`, runs the method it decorates. The registry recorded the key as the method to call, so dispatching it from a document called whatever the class had under that name: a prop (`Command "press" needs a "press" method`), an inherited method, or nothing. `CommandMeta` now carries `method` beside `key`, and `Registry.addNode` stores it as `NodeCommandEntry.method`. A command whose key is a core command's but whose method is not is no longer taken for the core command when compile decides whether it reads or writes layout. A command declared without a `key` is unchanged.
+
+## 0.1.0-alpha.1
+
+### Minor Changes
+
+- 59cecba: The SDK carries what a component is written against, so a kit no longer reaches into `@motionscript/core`. New in `@motionscript/sdk` (and `@motionscript/core/sdk`, which it passes through):
+
+  - `PathShape` and `PathShapeProps`, the document's `"path"` node, whose `data` is in its own box's unit space.
+  - `pathOps`, with the `PathSampler`, `PathAnchor`, `PathSubpath` and `VectorPath` types it takes and returns.
+  - `textOps`.
+  - `toPathString`, plus the `PathBounds` and `GraphicsOp` types.
+  - `InsetsProps`, what a `padding`-style prop accepts, and `SizeConstraints`, what an overriding `measure()` is handed.
+  - `SpaceCamera`, what `_spaceCamera()` returns to open a 2.5D space.
+  - `BufferGeometry3D`.
+
+  `@motionscript/sdk/component` is a new subpath over `@motionscript/core/component`: seekable entrances (`at`, `sequence`, `together`, `hold`, `compose`, `drive`), `declarePaints`, number formatting and the orbit-camera lerps. It is a subpath because a scene author never needs it, and because its `hold` (a seekable pause) is not the barrel's `hold` (an audio curve).
+
+  Host machinery stays in core: the asset catalog and declaration pass, render and measure contexts, `SceneTimeline`, `Engine` and `Session`.
+
+- 59cecba: Ship a browser build in `dist/browser/`, like every other package: one ES module per export (`.`, `./component`, `./jsx-runtime`, `./jsx-dev-runtime`) and a `manifest.json` mapping each to its file. It imports `@motionscript/core` rather than bundling it, so an import map names core once and the SDK, the backend and every kit share it.
+
+  `@motionscript/core` is now a peer dependency of the SDK rather than a dependency, as it is of everything else built on core. npm and pnpm install a missing peer for you; with a package manager that does not, add `@motionscript/core` beside `@motionscript/sdk`.
+
 ## 0.1.0-alpha.0
 
 Initial release.

package/README.md

@@ -15,9 +15,13 @@ Install it with a rendering backend such as
 [`@motionscript/browser`](../browser):
 
 ```bash
-npm install @motionscript/sdk @motionscript/browser @motionscript/canvaskit
+npm install @motionscript/sdk @motionscript/core @motionscript/browser @motionscript/canvaskit
 ```
 
+`@motionscript/core` is a peer dependency rather than a bundled one: the
+backend and every component kit share the one copy your project installs,
+because two copies of the engine in one module graph break class identity.
+
 ## Quick example
 
 ```ts
@@ -68,12 +72,26 @@ all supported. See the
 - **JSX runtime**: `@motionscript/sdk/jsx-runtime` and
   `@motionscript/sdk/jsx-dev-runtime`, so a composite node can build its children
   as TSX.
+- **Component machinery**: `@motionscript/sdk/component`, what a component
+  package needs beyond the 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.
 
 Component kits such as [`@motionscript/code`](../components/code) and
-[`@motionscript/latex`](../components/latex) are not bundled here. Install one
-as a dependency, or copy a component's source into your project with
+[`@motionscript/latex`](../components/latex) are not bundled here. They are
+built on this package and take it as a peer dependency. Install one as a
+dependency, or copy a component's source into your project with
 `ms add <name>` (see [`@motionscript/cli`](../cli)).
 
+## Loading from a CDN
+
+`dist/browser/` holds one ES module per export, with `@motionscript/core` left
+as an import, and `dist/browser/manifest.json` maps each export to its file. An
+import map names `@motionscript/sdk` (and its subpaths) and
+`@motionscript/core` (and its subpaths) once, and every kit loaded beside them
+shares both.
+
 This package has no rendering backend of its own. Pair it with
 [`@motionscript/browser`](../browser) (Skia/CanvasKit), and use
 [`@motionscript/react`](../react) to mount a player in a React app.

package/dist/browser/component.js

@@ -0,0 +1,2 @@
+export*from"@motionscript/core/component";
+//# sourceMappingURL=component.js.map

package/dist/browser/component.js.map

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

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+export*from"@motionscript/core/sdk";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["/**\n * `@motionscript/sdk` — the published, friendly name over `@motionscript/core`.\n *\n * The curation lives in `@motionscript/core`'s own `\"./sdk\"` subpath\n * (`packages/core/src/sdk/index.ts`), not here: a hand-curated copy in a\n * different package than the classes it names is exactly the \"two\n * definitions that can silently disagree\" shape this codebase avoids\n * elsewhere. This file exists so the published package name and its own\n * versioning stay stable — only its implementation is a passthrough.\n */\nexport * from \"@motionscript/core/sdk\";\n"],
+  "mappings": "AAUA,WAAc",
+  "names": []
+}

package/dist/browser/jsx-dev-runtime.js

@@ -0,0 +1,2 @@
+import{jsxDEV as m,Fragment as o}from"@motionscript/core/jsx/jsx-dev-runtime";export{o as Fragment,m as jsxDEV};
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/browser/jsx-dev-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/jsx-dev-runtime.ts"],
+  "sourcesContent": ["export { jsxDEV, Fragment } from '@motionscript/core/jsx/jsx-dev-runtime';\nexport type { JSX } from '@motionscript/core/jsx/jsx-runtime';\n"],
+  "mappings": "AAAA,OAAS,UAAAA,EAAQ,YAAAC,MAAgB",
+  "names": ["jsxDEV", "Fragment"]
+}

package/dist/browser/jsx-runtime.js

@@ -0,0 +1,2 @@
+import{jsx as x,jsxs as e,Fragment as j}from"@motionscript/core/jsx/jsx-runtime";export{j as Fragment,x as jsx,e as jsxs};
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/browser/jsx-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/jsx-runtime.ts"],
+  "sourcesContent": ["export { jsx, jsxs, Fragment } from '@motionscript/core/jsx/jsx-runtime';\nexport type { JSX } from '@motionscript/core/jsx/jsx-runtime';\n"],
+  "mappings": "AAAA,OAAS,OAAAA,EAAK,QAAAC,EAAM,YAAAC,MAAgB",
+  "names": ["jsx", "jsxs", "Fragment"]
+}

package/dist/browser/manifest.json

@@ -0,0 +1,14 @@
+{
+  "name": "@motionscript/sdk",
+  "version": "0.1.0-alpha.3",
+  "exports": {
+    ".": "dist/browser/index.js",
+    "./component": "dist/browser/component.js",
+    "./jsx-runtime": "dist/browser/jsx-runtime.js",
+    "./jsx-dev-runtime": "dist/browser/jsx-dev-runtime.js"
+  },
+  "peers": [
+    "@motionscript/core"
+  ],
+  "assets": {}
+}

package/dist/component.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@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.
+ *
+ * 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`.
+ */
+export * from "@motionscript/core/component";
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

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

package/dist/component.js

@@ -0,0 +1,13 @@
+/**
+ * `@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.
+ *
+ * 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`.
+ */
+export * from "@motionscript/core/component";
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/sdk",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.3",
   "type": "module",
   "description": "Engine-agnostic animation library for Motion Script: scenes, nodes, props, tweens, layout, and the JSX runtime.",
   "repository": {
@@ -34,6 +34,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./component": {
+      "types": "./dist/component.d.ts",
+      "default": "./dist/component.js"
+    },
     "./jsx-runtime": {
       "types": "./dist/jsx-runtime.d.ts",
       "default": "./dist/jsx-runtime.js"
@@ -43,8 +47,8 @@
       "default": "./dist/jsx-dev-runtime.js"
     }
   },
-  "dependencies": {
-    "@motionscript/core": "^0.1.0-alpha.0"
+  "peerDependencies": {
+    "@motionscript/core": "^0.1.0-alpha.3"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",
@@ -55,10 +59,11 @@
     "tsc-alias": "^1.8.16",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.48.0",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.5",
+    "@motionscript/core": "0.1.0-alpha.3"
   },
   "scripts": {
-    "build": "eslint . && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build": "eslint . && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node ../../scripts/build-browser.mjs",
     "dev": "concurrently \"tsc -p tsconfig.build.json --watch\" \"tsc-alias -p tsconfig.build.json -w\"",
     "clean": "rimraf --glob dist .turbo *.tsbuildinfo",
     "test": "vitest",