@motionscript/grids 0.0.0-stage → 0.1.0-alpha.10

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# @motionscript/grids
+
+## 0.1.0-alpha.10
+
+## 0.1.0-alpha.9
+
+## 0.1.0-alpha.8
+
+## 0.1.0-alpha.7
+
+## 0.1.0-alpha.6
+
+### Minor Changes
+
+- 163b708: Node types are components: one spec object handed to `component2d`, `component3d` or `componentAudio`, with no classes, decorators or JSX.
+
+  - **Writing a node type.** A component is one object literal: `key`, `state` (literals and `Types`), `defaults`, `commands`, `children`, `allowedChildren`/`allowedParents`, `provide`, `load`, and its tree's own fields (`measure`, `layout`, `render` for 2D). Behaviour comes from modules you spread in and call: `Paint`, `Flow`, `Shapes`, `Typeface`, `TextLayout`, `Aim`, `Material`, `View3D`. ADR 0007 and the custom-node docs cover it.
+  - **Building nodes in code** uses calls: `Rect({ fill: 'tomato', children: [Text({ text: 'Hi' })] })`, or `new Rect({...})` for the node itself.
+  - **Every built-in and every kit node is a component**, under the same document key. Code that tested `instanceof` a class now uses the component's `.is`, or `instanceof X.node`. Changed members:
+    - `SurfacePlot3d.valueAt` and `FunctionPlot.valueAt` are now the functions `surfaceValueAt` and `curveValue`.
+    - A system's `coordinates` is replaced by `planeMap`/`axesMap`/`systemMap`.
+    - `PieChart.isSelected` is replaced by `isSliceSelected`.
+    - `ItemGrid` is a kit module (`ItemGrid.isGrid`, `ItemGrid.define`), not a base class.
+  - **The sdk no longer exports the class surface:**
+    - the decorators: `node`, `property` and every `*Property`, `command`, `withdraw`, `driveCommand`;
+    - the authoring bases: `PaintNode`, `ShapeNode`, `TextBase`, `Mesh3DBase`, `Canvas3DBase` and the `*Base` geometry classes;
+    - `asCommand`, `compose`, `drive` and `declarePaints` from `@motionscript/sdk/component`;
+    - the `jsx-runtime` and `jsx-dev-runtime` subpaths.
+    - `Node`, `Node2D`, `Node3D` and `NodeAudio` remain as types.
+  - **Editor metadata leaves the engine.** The kits no longer declare `parentKey`, `forkable`, `layout`, `seed`, `within`, `beside` or `closed`; a host keeps those in its own configs. `describe()` now reports `holds`, the trees a type takes children from, and the placement checks use it, so a 2D viewport of your own that takes 3D children places them.
+  - A command called from code with no argument runs, and a refused child is told what its parent takes (`allowedChildren`) or where it goes (`allowedParents`).
+
+## 0.1.0-alpha.5
+
+### Patch Changes
+
+- da6f97a: Every package ships a `NOTICE`, and a browser build lists what it bundles.
+
+  - Each tarball carries the repository `NOTICE`: the copyright line and the MIT attributions for the noise functions in `skia-render`'s fractal-noise fill (David Hoskins' "Hash without Sine", Inigo Quilez's 2D simplex noise).
+  - `@motionscript/canvaskit` ships `THIRD_PARTY_NOTICES.txt` with the licences of the libraries compiled into the binary: FreeType, HarfBuzz, ICU 74, zlib, libpng, Brotli, WOFF2, Emscripten and musl.
+  - `dist/browser/manifest.json` gains `thirdParty`, the packages the browser build bundled (`name`, `version`, `license`), and their licence and NOTICE files are written to `dist/browser/THIRD_PARTY_LICENSES.txt`. `@motionscript/browser` bundles mediabunny (MPL-2.0, unmodified; source at https://github.com/Vanilagy/mediabunny), esbuild-wasm and three; `@motionscript/math` bundles MathJax.
+
+- 1778355: The published packages carry what a user needs and say what they are.
+
+  - `@motionscript/code` no longer ships `dist/tests/diff.bench.*`, and `@motionscript/math` no longer ships `dist/tests/harness.*` or `mathjax.setup.*`: test helpers under a `tests` folder are left out of every package's build.
+  - `@motionscript/sdk`'s description no longer repeats core's, and `@motionscript/math`'s names the coordinate systems, plots, 3D graphs and network graphs it has as well as formulas.
+  - The READMEs of `@motionscript/canvaskit`, `@motionscript/charts`, `@motionscript/geo`, `@motionscript/grids`, `@motionscript/skia-render` and `@motionscript/geography` say what to install, and `@motionscript/sdk`'s example now opens the document in an engine and plays it. Links between packages point at the repository, so they work on npm.
+
+## 0.1.0-alpha.4
+
+### Minor Changes
+
+- 3eefc7e: Package reshuffle.
+
+  - `@motionscript/layout-grid` is now `@motionscript/grids` (`@motionscript/grids/kit`, and `packages/components/grids`), and its `LayoutGrid` base class is `ItemGrid` (`ItemGridProps`, `ITEM_GRID_TYPES`). `RectangularGrid`, `RadialGrid`, `PathGrid` and `SphereGrid` keep their names and document keys. Update the dependency, the imports, and any `@motionscript/layout-grid/kit` specifier a copied component carries.
+  - `@motionscript/geo-data` is now `@motionscript/geography`. The data format on disk (`data/v1/…`) is unchanged, so `@motionscript/geo` reads it as before and a host that serves `@motionscript/geo-data/data` serves `@motionscript/geography/data` the same way.
+  - `@motionscript/ui` is removed: its `Switch`, `Button`, `Window` and `Cursor` nodes, and the `ControlNode` base class, no longer ship. They are plain nodes over `@motionscript/sdk`, so a project that needs one writes its own and shapes it to taste.
+  - `@motionscript/patterns` is new. It holds the pattern nodes (`LineGridPattern`, `DotGridPattern`, `GridPattern`, `ViewportPattern`) that `@motionscript/core` and `@motionscript/sdk` no longer ship.
+
+### Patch Changes
+
+- 7f8b4d0: A node can give its children coordinates of its own, which is what a coordinate system needs: a child's `x`/`y` are then in the parent's units and the child keeps its size.
+
+  - A parent answers `_planeOf(child)` with a `ChildPlane` (`toOffset` and `toCoords`, exported). Paint, `global`, the anchor getters, `moveTo({ target })` and `parentPlanePointAt` all read it, and the last two answer in the parent's coordinates. A node whose parent publishes none is unchanged.
+  - `childPlanePointAt(root, path, point)`, and `childPlanePoint` on the player, say where a point lands in the coordinates a node positions its children in, for a host placing a node that is not there yet. They answer `null` for a node whose children are in pixels, and `_planeOf(null)` is what they ask.
+  - `findNode2D(from, id)` and `frameIn(host, node)` are exported from the SDK, for a node that follows another by id. `@motionscript/grids` now uses them and still exports both names.
+
+- e78f716: Kit gaps in waveforms, item grids, graphs and protein node.
+
+  - `@motionscript/audio`: documents that the host supplies the baked envelope and states its JSON form. `AudioEnvelope.magnitude` and `speaker` are typed `ArrayLike<number>`, which accepts the plain arrays a document stores as well as typed arrays. The package description no longer claims the meter responds to a signal.
+  - `@motionscript/grids`: the grids' descriptors name `children: "freeform"`, the one answer that is true of slot-placed children, in place of `flow` and `grid`.
+  - `@motionscript/molecule`: `Protein` refuses children, as its descriptor says, and declares `quality` non-animatable.
+  - `@motionscript/plot`: new `curveEquationIssues`, `surfaceEquationIssues` and `equationIssues` return a `ValidationIssue` for each equation whose expression does not compile and so is not drawn, which `validateDocument` cannot see. The `Canvas3D` scene props that `Graph3D` inherits and ignores are documented in its docs and a README.
+
+## 0.1.0-alpha.3
+
+## 0.1.0-alpha.2
+
+## 0.1.0-alpha.1
+
+### Minor Changes
+
+- 59cecba: Build on `@motionscript/sdk` instead of `@motionscript/core`. The peer dependency is now `@motionscript/sdk`, every import goes through it (and `@motionscript/sdk/component` for the component machinery), and the browser build leaves `@motionscript/sdk` an import, so an import map names it once. A component copied with `ms add` imports the SDK too, and its registry item depends on `@motionscript/sdk` rather than `@motionscript/core`. `@motionscript/charts/kit` re-exports `@motionscript/sdk/component` where it re-exported `@motionscript/core/component`.
+
+## 0.1.0-alpha.0
+
+Initial release.

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,49 @@
+Motionscript
+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/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/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.
+
+- 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/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
+licences.
+
+MIT License
+
+Permission 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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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.

package/README.md

@@ -1,3 +1,118 @@
-# Temporary Holding Version
+# @motionscript/grids
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Grid layouts for [Motion Script](https://motionscript.dev): a node that places
+its children in a rectangular, radial, path or spherical arrangement, with
+staggered reveals, waves, focus, reordering and morphs between arrangements.
+Written against [`@motionscript/sdk`](https://github.com/motionscript-dev/motionscript/tree/main/packages/sdk), a peer dependency.
+
+```ts
+import { NODES } from '@motionscript/grids';
+
+export const nodes = NODES; // [RectangularGrid, RadialGrid, PathGrid, SphereGrid]
+```
+
+Importing registers nothing (see [`packages/components/CLAUDE.md`](https://github.com/motionscript-dev/motionscript/blob/main/packages/components/CLAUDE.md)). Each grid
+is a component (`component2d`); `ItemGrid`, the module the four are built from,
+is no node type and is not in `NODES`.
+
+## Install
+
+```bash
+npm install @motionscript/grids @motionscript/sdk
+```
+
+## Exports
+
+| Path | Source | What |
+|---|---|---|
+| `@motionscript/grids` | `src/index.ts` | the four grids, `PATH_GRID_SHAPES`, `NODES`, and `src/engine.ts` |
+| `@motionscript/grids/kit` | `src/engine.ts` | the `ItemGrid` module and what it uses (`src/kit/`): slot functions per arrangement, stagger, reveal and wave styles, order helpers, seeded random |
+
+## Nodes
+
+The items are the grid's children, in layer order; a group is one item. A grid is
+`hug` by default, except `pathGrid` (640 x 400, fixed).
+
+| Key | Arrangement props | Own commands |
+|---|---|---|
+| `rectangularGrid` | `columns`, `fillDirection`, `cellMode` (`fit`/`fixed`/`fill`), `cellWidth/Height`, `columnGap`, `rowGap`, `lastLineAlign`, `rowOffset`, `columnOffset` | `columnsTo`, `gapTo`, `cellSizeTo`, `focusRow`, `focusColumn` |
+| `radialGrid` | `radius`, `startAngle`, `sweep`, `direction`, `rotateItems`, `spinSpeed` | `spin`, `turnTo`, `radiusTo`, `sweepTo` |
+| `pathGrid` | `shape` (a template or `custom`), `path`, `pathNode`, `spacing`, `spacingDistance`, `offset`, `flowSpeed`, `trimStart/End`, `alignToPath` | `flow`, `trimTo`, `setPath` |
+| `sphereGrid` | `radius`, `yaw`, `pitch`, `roll`, `facing`, `focalLength`, `depthFade`, `cullBackfaces`, `spinSpeed` | `spin`, `orientTo`, `turnTo`, `radiusTo`, `focalLengthTo` |
+
+Every grid also has `order`, `spread` and `arrangeLike`, and these commands from
+the `ItemGrid` module: `reveal`, `conceal`, `wave`, `focus`, `unfocus`, `spreadTo`, `shuffle`,
+`swap`, `reorder`, `morphInto`. Per-item commands take `staggerOrder` (`index`,
+`reverse`, `random`, `centerOut`, `edgesIn`, `row`, `column`, `angle`, `path`,
+`depth`) and `stagger` (0 to 0.95); `shuffle`, `swap`, `reorder`, `morphInto`,
+`columnsTo` and `setPath` are *transitions*.
+
+## Rules worth knowing
+
+- **A slot is a parent transform.** Each item is laid out where its slot is, and the
+  rest of the slot (turn, scale, tilt, depth, fade) rides on its layout placement,
+  applied about the item's centre before its own transform, so an item's own `x`,
+  `y`, `rotation` and its commands keep working relative to the slot. A grid whose
+  arrangement has depth (the sphere) opens a camera of its own with its render's
+  `ctx.space`, unless it already sits in a space (`ctx.inSpace`).
+- **`flowOps` sizes; it never places.** The grid's size is what its slots come to
+  (`extentOf`), seen through the camera it has that frame, so a grid of grids is a
+  grid of items.
+- **`revealState`, `waveState`, `focusState` and `transition` are written by
+  commands, not authored.** They are rewritten every frame as a pure function of
+  time and set to `null` at the command's end, so a seek reproduces them. `reveal`
+  hides every item at its start (place it where the grid enters); `conceal` leaves
+  them hidden until a later `reveal`.
+- **The stagger lives inside the duration**: a command lasts its row's `duration`.
+- **An arrangement is data.** A transition keeps the arrangement it leaves as a
+  `GridSnapshot` and re-evaluates it each frame, so a morph can start from any
+  arrangement, including another grid's. `morphInto` writes `arrangeLike` (a node
+  reference: the grid reads a view of the one it names, and where it stands) and keeps
+  following that grid; a grid that cannot find `arrangeLike` or `pathNode` draws its
+  own arrangement. Another grid's arrangement is worked out from its state by the
+  `Arranger` it was defined with, so a grid is borrowable once `ItemGrid.define` has
+  seen it.
+- **A command reads the grid as its predecessors leave it.** Ranks for a stagger, the
+  rows `focusRow` picks and the cell `cellSizeTo` starts from are worked out afresh from
+  the command's state, its children's sizes and the grid's box, against the clock the
+  timeline builds commands at (time 0).
+- **`order[k]` is the child in slot `k`**, and `normalizeOrder` repairs any order
+  (missing, repeated or out-of-range entries), so a stale order never throws.
+- **The kit stays an import.** A copy of `rectangular-grid` (or `radial-grid`,
+  `path-grid`, `sphere-grid`) takes one grid's two files and rewrites their kit
+  imports to `@motionscript/grids/kit` (`registry.json`): a second copy of
+  `ItemGrid` would keep a second register of grids, and a morph would not find the
+  grids it should.
+
+## A grid of your own
+
+```ts
+import { component2d, Types, type Values } from '@motionscript/sdk';
+import { ItemGrid, type Arrangement } from '@motionscript/grids/kit';
+
+const own = { radius: Types.number(120) };
+const arranger: ItemGrid.Arranger<Values<typeof own>> = {
+  arrangement: (s): Arrangement => ({ kind: 'radial', radius: s.radius, startAngle: 0, sweep: 180, direction: 'clockwise', rotateItems: false, spinSpeed: 0 }),
+};
+
+export const ArcGrid = ItemGrid.define(component2d({
+  key: 'arcGrid',
+  state: { ...ItemGrid.state, ...own },
+  defaults: ItemGrid.defaults,
+  commands: { ...ItemGrid.commands },
+  ...ItemGrid.fields(arranger),
+}), arranger);
+```
+
+`define` registers the arranger, which is what another grid and a host know it by:
+`ItemGrid.isGrid(node)` tells a grid from any other node.
+
+## Development
+
+```bash
+pnpm --filter @motionscript/grids build
+pnpm --filter @motionscript/grids test
+```
+
+Tests are in `src/tests/` (`grid.test.ts`, `slots.test.ts`, `descriptors.test.ts`);
+`harness.ts` builds, seeks and renders a document.

package/dist/browser/chunks/chunk-TYNFMZ3D.js

@@ -0,0 +1,2 @@
+var Dt=Object.defineProperty;var Yt=(t,e)=>{for(var n in e)Dt(t,n,{get:e[n],enumerable:!0})};import{pathOps as st}from"@motionscript/sdk";function y(t,e,n){return{x:t,y:e,depth:0,rotation:0,rotationX:0,rotationY:0,scale:1,opacity:1,meta:n}}function rt(t,e,n){if(n<=0)return t;if(n>=1)return e;let o=(r,a)=>r+(a-r)*n;return{x:o(t.x,e.x),y:o(t.y,e.y),depth:o(t.depth,e.depth),rotation:o(t.rotation,e.rotation),rotationX:o(t.rotationX,e.rotationX),rotationY:o(t.rotationY,e.rotationY),scale:o(t.scale,e.scale),opacity:o(t.opacity,e.opacity),meta:n<.5?t.meta:e.meta}}function Z(t,e){return e===1?t:{...t,x:t.x*e,y:t.y*e,depth:t.depth*e}}function at(t){let e=0,n=0;for(let o of t)o.width>e&&(e=o.width),o.height>n&&(n=o.height);return{width:e,height:n}}var be=["distribute","fixed"],P=new Map,Bt=32;function Xt(t){let e=P.get(t);if(e)return e;let n=st.contours(t),o={sampler:st.sampler(t),closed:n.length===1&&n[0].closed};return P.size>=Bt&&P.delete(P.keys().next().value),P.set(t,o),o}function ct(t,e){let{count:n}=e;if(n===0)return[];let{sampler:o,closed:r}=Xt(t.path),a=o.length,s=_(Math.min(t.trimStart,t.trimEnd)),c=_(Math.max(t.trimStart,t.trimEnd)),i=s*a,u=(c-s)*a,h=r&&s===0&&c===1,f=t.offset+t.flowSpeed*e.time,l=t.placement,m=l.rotation*Math.PI/180,k=Math.cos(m),A=Math.sin(m),g=[];for(let x=0;x<n;x++){let d;t.spacing==="fixed"&&u>0?d=f+x*t.spacingDistance/u:h?d=f+x/n:d=f+(n===1?.5:x/(n-1));let E=!0;h?d=d-Math.floor(d):(d<-1e-9||d>1+1e-9)&&(E=!1);let M=o.frameAt(i+_(d)*u);if(!M){let X=y(0,0,{kind:"path",t:_(d)});X.opacity=0,g.push(X);continue}let T=l.flipY?-1:1,R=(M.x-l.originX)*l.scale,G=(M.y-l.originY)*l.scale*T,O=y(l.x+R*k+G*A,l.y-R*A+G*k,{kind:"path",t:_(d)});t.alignToPath&&(O.rotation=-Math.atan2(M.ty*T,M.tx)*180/Math.PI+l.rotation),E||(O.opacity=0),g.push(O)}return g}function _(t){return t<0?0:t>1?1:t}var Re=["clockwise","counterclockwise"];function it(t,e,n){let o=t.sweep,r=Math.min(1,Math.abs(o)/360)**8,a=e<=1?0:o/(e-1+r),s=t.direction==="counterclockwise"?-1:1,c=t.startAngle+t.spinSpeed*n,i=[];for(let u=0;u<e;u++)i.push(c+s*u*a);return i}function ut(t,e){let n=it(t,e.count,e.time),o=n[0]??0;return n.map(r=>{let a=r*Math.PI/180,s=y(t.radius*Math.sin(a),t.radius*Math.cos(a),{kind:"radial",angle:Math.abs(r-o)});return t.rotateItems&&(s.rotation=r),s})}function Ge(t,e,n){let o=it({...t,spinSpeed:0},e,0)[n]??t.startAngle;return-Ft(o)}function Ft(t){let e=(t%360+360)%360;return e>180?e-360:e}var ve=["row","column"],Ce=["fit","fixed","fill"],Ne=["start","center","end"];function ft(t,e){let n=Math.max(1,Math.round(t.columns)),o=Math.max(1,Math.ceil(e/n));return t.fillDirection==="column"?{rows:o,columns:Math.max(1,Math.ceil(e/o))}:{rows:o,columns:n}}function Ht(t,e,n,o){let{rows:r,columns:a}=ft(t,e);switch(t.cellMode){case"fixed":return{width:Math.max(0,t.cellWidth),height:Math.max(0,t.cellHeight)};case"fill":return{width:Math.max(0,(o.width-t.columnGap*(a-1))/a),height:Math.max(0,(o.height-t.rowGap*(r-1))/r)};default:return at(n)}}function lt(t,e){let{count:n}=e;if(n===0)return[];let{rows:o,columns:r}=ft(t,n),a=t.fillDirection==="column",s=a?r:o,c=a?o:r,i=Ht(t,n,e.sizes,e.box),u=i.width+t.columnGap,h=i.height+t.rowGap,f=s-1,l=n-f*c,m=c-l,k=t.lastLineAlign==="center"?m/2:t.lastLineAlign==="end"?m:0,A=t.rowOffset*u,g=t.columnOffset*h,x=[];for(let d=0;d<n;d++){let E=Math.floor(d/c),M=d%c;E===f&&(M+=k);let T=a?M:E,R=a?E:M,G=Math.round(T),O=Math.round(R),X=(R-(r-1)/2)*u+(G%2===1?A:0)-(o>1?A/2:0),zt=((o-1)/2-T)*h-(O%2===1?g:0)+(r>1?g/2:0);x.push(y(X,zt,{kind:"rectangular",row:G,column:O}))}return x}var Ye=["outward","billboard"],Be=["x","y","z"],Wt=Math.PI*(3-Math.sqrt(5)),w=180/Math.PI;function ht(t,e){if(e<=1)return[0,0,1];let n=1-2*(t+.5)/e,o=Math.sqrt(Math.max(0,1-n*n)),r=t*Wt;return[Math.cos(r)*o,n,Math.sin(r)*o]}function qt(t,e,n,o){let[r,a,s]=t,c=e/w,i=n/w,u=o/w,h=r*Math.cos(c)+s*Math.sin(c),f=-r*Math.sin(c)+s*Math.cos(c),l=a*Math.cos(i)-f*Math.sin(i),m=a*Math.sin(i)+f*Math.cos(i);return[h*Math.cos(u)+l*Math.sin(u),-h*Math.sin(u)+l*Math.cos(u),m]}function pt(t,e){let{count:n}=e,o=t.radius,r=t.yaw+t.spinSpeed*e.time,a=t.facing==="outward",s=[];for(let c=0;c<n;c++){let i=ht(c,n),[u,h,f]=qt(i,r,t.pitch,t.roll),l=y(u*o,h*o,{kind:"sphere",lat:Math.asin(Math.max(-1,Math.min(1,i[1])))*w,lon:Math.atan2(i[2],i[0])*w,depth:f});l.depth=f*o,a&&(l.rotationY=Math.asin(Math.max(-1,Math.min(1,u)))*w,l.rotationX=Math.atan2(h,f)*w),l.opacity=1-t.depthFade*(1-(f+1)/2),a&&t.cullBackfaces&&Vt(l,[u,h,f],t.focalLength)&&(l.opacity=0),s.push(l)}return s}function Vt(t,e,n){return n<=0?e[2]<0:e[0]*-t.x+e[1]*-t.y+e[2]*(n-t.depth)<0}function Xe(t,e){let[n,o,r]=ht(e,t);return{yaw:-Math.atan2(n,r)*w,pitch:Math.atan2(o,Math.hypot(n,r))*w}}var He=["circle","square","star","heart","infinity","wave","spiral","arc","line"];var v=new Map,$t=64;function We(t,e){let n=`${t}:${Math.round(e.width*100)}:${Math.round(e.height*100)}`,o=v.get(n);if(o)return o;let r=Kt(t,e);return v.size>=$t&&v.delete(v.keys().next().value),v.set(n,r),r}function Kt(t,e){let n=e.width>0?e.width:400,o=e.height>0?e.height:400,r=n/2,a=o/2;switch(t){case"square":return F([[-r,a],[r,a],[r,-a],[-r,-a]]);case"star":{let s=[];for(let c=0;c<10;c++){let i=c*Math.PI/5,u=c%2===0?1:.45;s.push([Math.sin(i)*r*u,Math.cos(i)*a*u])}return F(s)}case"heart":return F(C(96,s=>{let c=s*2*Math.PI,i=16*Math.sin(c)**3,u=13*Math.cos(c)-5*Math.cos(2*c)-2*Math.cos(3*c)-Math.cos(4*c);return[i/17*r,(u+2.5)/15.5*a]}).slice(0,-1));case"infinity":return F(C(96,s=>{let c=s*2*Math.PI,i=1+Math.sin(c)**2;return[Math.cos(c)/i*r,Math.sin(c)*Math.cos(c)/i*a*2]}).slice(0,-1));case"wave":return H(C(96,s=>[(-1+2*s)*r,Math.sin(s*4*Math.PI)*a*.6]));case"spiral":return H(C(160,s=>{let c=s*3*2*Math.PI,i=.08+.92*s;return[Math.sin(c)*r*i,Math.cos(c)*a*i]}));case"arc":return H(C(64,s=>{let c=-Math.PI/2+s*Math.PI;return[Math.sin(c)*r,-a+Math.cos(c)*o]}));case"line":return[{type:"M",x:-r,y:0},{type:"L",x:r,y:0}];default:return Zt(r,a)}}function Zt(t,e){let n=.5522847498;return[{type:"M",x:0,y:e},{type:"C",x1:n*t,y1:e,x2:t,y2:n*e,x:t,y:0},{type:"C",x1:t,y1:-n*e,x2:n*t,y2:-e,x:0,y:-e},{type:"C",x1:-n*t,y1:-e,x2:-t,y2:-n*e,x:-t,y:0},{type:"C",x1:-t,y1:n*e,x2:-n*t,y2:e,x:0,y:e},{type:"Z"}]}function C(t,e){let n=[];for(let o=0;o<=t;o++)n.push(e(o/t));return n}function H(t){return t.map(([e,n],o)=>o===0?{type:"M",x:e,y:n}:{type:"L",x:e,y:n})}function F(t){return[...H(t),{type:"Z"}]}function j(t,e){switch(t.kind){case"rectangular":return lt(t,e);case"radial":return ut(t,e);case"path":return ct(t,e);case"sphere":return pt(t,e)}}function J(t){return t.kind==="sphere"?Math.max(1,t.focalLength):0}function jt(t){let e=Math.floor(t)>>>0;return()=>{e=e+1831565813>>>0;let n=e;return n=Math.imul(n^n>>>15,n|1),n^=n+Math.imul(n^n>>>7,n|61),((n^n>>>14)>>>0)/4294967296}}function W(t,e){let n=[...t],o=jt(e);for(let r=n.length-1;r>0;r--){let a=Math.floor(o()*(r+1));[n[r],n[a]]=[n[a],n[r]]}return n}function dt(t){let e=2166136261;for(let n=0;n<t.length;n++)e=Math.imul(e^t.charCodeAt(n),16777619);return e>>>0}var mt=["index","reverse","random","centerOut","edgesIn","row","column","angle","path","depth"],Jt=.95;function gt(t,e,n){let o=e.length,r=Qt(t,e,n),a=1/0,s=-1/0;for(let i of r)i<a&&(a=i),i>s&&(s=i);let c=s-a;return c>1e-9?r.map(i=>(i-a)/c):new Array(o).fill(0)}function N(t,e,n){let o=Math.max(0,Math.min(Jt,n)),r=o===0?e:(e-t*o)/(1-o);return r<0?0:r>1?1:r}function Qt(t,e,n){switch(t){case"reverse":return e.map((o,r)=>-r);case"random":{let o=W(e.map((a,s)=>s),n),r=new Array(e.length);return o.forEach((a,s)=>{r[a]=s}),r}case"centerOut":return e.map(o=>Math.round(Math.hypot(o.x,o.y,o.depth)*1e3)/1e3);case"edgesIn":return e.map(o=>-Math.round(Math.hypot(o.x,o.y,o.depth)*1e3)/1e3);case"row":return e.map(o=>o.meta.kind==="rectangular"?o.meta.row:-Math.round(o.y));case"column":return e.map(o=>o.meta.kind==="rectangular"?o.meta.column:Math.round(o.x));case"angle":return e.map((o,r)=>o.meta.kind==="radial"?o.meta.angle:o.meta.kind==="rectangular"||o.meta.kind==="sphere"?Ut(o):r);case"path":return e.map((o,r)=>o.meta.kind==="path"?o.meta.t:r);case"depth":return e.map((o,r)=>o.meta.kind==="sphere"?-o.meta.depth:r);default:return e.map((o,r)=>r)}}function Ut(t){let e=Math.atan2(t.x,t.y)*180/Math.PI;return e<0?e+360:e}var Q=["scale","fade","center","rise","flip","spin"],xt=["scale","lift","fade","spin"];function Mt(t,e,n,o,r,a){o&&te(t,o.style,o.values[e]??1,n),r&&ee(t,r,r.values[e]??0,n),a&&ne(t,a,a.values[e]??0)}function te(t,e,n,o){if(n===1)return;let r=q(n);switch(e){case"fade":t.opacity*=r;break;case"center":t.x*=n,t.y*=n,t.depth*=n,t.opacity*=q(n*4);break;case"rise":t.y-=(1-n)*Math.max(40,o.height),t.opacity*=r;break;case"flip":t.rotationX+=(1-n)*90;break;case"spin":t.rotation-=(1-n)*180,t.scale*=Math.max(0,n);break;default:t.scale*=Math.max(0,n)}}function ee(t,e,n,o){if(n!==0)switch(e.style){case"lift":t.y+=e.amount*n*Math.max(40,o.height);break;case"fade":t.opacity*=q(1-e.amount*n);break;case"spin":t.rotation+=e.amount*n*360;break;default:t.scale*=1+e.amount*n}}function ne(t,e,n){if(n!==0){if(n>0){t.scale*=1+e.grow*n;return}t.opacity*=q(1-e.dim*-n),t.scale*=Math.max(0,1+e.grow*.5*n)}}function q(t){return t<0?0:t>1?1:t}function I(t,e){let n=[],o=new Array(e).fill(!1);for(let r of t??[]){let a=Math.round(r);a>=0&&a<e&&!o[a]&&(o[a]=!0,n.push(a))}for(let r=0;r<e;r++)o[r]||n.push(r);return n}function U(t){let e=new Array(t.length);return t.forEach((n,o)=>{e[n]=o}),e}function yt(t){return Array.isArray(t)?t.map(Number).filter(Number.isFinite):typeof t!="string"?[]:t.split(/[\s,]+/).filter(e=>e!=="").map(Number).filter(Number.isFinite)}var Nt={};Yt(Nt,{ITEM_GRID_TYPES:()=>$,TRANSITION_STAGGER:()=>b,commands:()=>pe,contentBox:()=>L,contentBoxOf:()=>Lt,defaults:()=>se,define:()=>ce,fields:()=>ue,focusOn:()=>Rt,hinted:()=>ae,isGrid:()=>ie,itemSlots:()=>Tt,layout:()=>Ot,measure:()=>Et,nodeRef:()=>kt,nodeRefArg:()=>At,ranks:()=>Y,render:()=>bt,staggerArgs:()=>S,state:()=>It,transitionTo:()=>z});import{commandsFor as oe,easeIn as re,easeInOut as D,easeOut as wt,flowOps as tt,insetsOps as St,Types as p}from"@motionscript/sdk";var $=["rectangularGrid","radialGrid","pathGrid","sphereGrid"],b=.3;function kt(t){let e={kind:"nodeRef",nodeTypes:t,animatable:!1};return p.custom("",e)}function S(t){return{staggerOrder:p.oneOf(mt,{default:"index"}),stagger:p.number(t,{min:0,max:.95,step:.05})}}function ae(t,e={}){let n={...e,default:t};return p.custom(void 0,n)}function At(t){let e={kind:"nodeRef",nodeTypes:t};return p.custom(void 0,e)}var It={order:p.custom([],{kind:"order",animatable:!1}),spread:p.number(1,{min:0,max:3,step:.05}),arrangeLike:kt($),revealState:p.custom(void 0,{kind:"state",animatable:!1}),waveState:p.custom(void 0,{kind:"state",animatable:!1}),focusState:p.custom(void 0,{kind:"state",animatable:!1}),transition:p.custom(void 0,{kind:"state",animatable:!1}),transitionSource:p.custom("",{kind:"nodeRef",private:!0})},se={width:"hug",height:"hug"},B=new Map;function ce(t,e){return B.set(t.key,{component:t,arranger:e}),t}function ie(t){for(let{component:e}of B.values())if(t instanceof e.node)return!0;return!1}function ue(t){return{measure:(e,n,o)=>Et(e,n,o,t),layout:(e,n,o)=>Ot(e,n,o,t),render:(e,n)=>bt(e,n,t)}}var fe={width:0,height:0},le={x:0,y:0},V=new WeakMap;function Et(t,e,n,o){let r={maxWidth:t.max.width,maxHeight:t.max.height},a=e.padding;if(n.length===0)return V.delete(e),tt.size(e,r,a,fe);let s=tt.contentBox(e,r,a),c=_t(n,s,e,o);V.set(e,{space:s,sizes:c});let i={state:e,arranger:o,children:n,isSelf:Gt(n)},u=ot(i,c.length,c,s,t.time.total);return tt.size(e,r,a,we(u.slots,c,vt(e,u.arrangement)))}function Ot(t,e,n,o){let r=V.get(e);if(V.delete(e),n.length===0)return[];let a=St.insetBounds(t.width,t.height,e.padding),s=r&&r.sizes.length===n.length&&ke(r.space,a)?r.sizes:_t(n,a,e,o);return xe({state:e,arranger:o,children:n,isSelf:Gt(n)},s,a,t.time.total).map((i,u)=>ye(a,i,s[u]))}function bt(t,e,n){let o=e.children.length===0?0:vt(e,ge({state:e,arranger:n,children:[],isSelf:()=>!1},L(t.size,e.padding)));o>0&&!t.inSpace?t.space(Me(o)):t.children()}function Lt(t){let e=t.layoutBounds;return L({width:e.width,height:e.height},t.effectivePadding())}function Tt(t,e,n){let o=Pt(t,e,n),r=n.map(a=>a.size);return ot(o,n.length,r,L(t.node.size,e.padding),0).slots}function Y(t,e,n,o){return gt(o??"index",Tt(t,e,n),dt(t.node.id))}function z(t,e,n,o,r=b){let a=me(t,e,n),s=t.easing??D("cubic"),c=Y(t,e,n,t.args.staggerOrder),i=t.args.stagger??r;return t.animate(u=>{if(u>=1)return{...o,transition:null,transitionSource:""};let h=c.map(f=>s(N(f,u,i)));return{...o,transition:{from:a,mix:h},transitionSource:a.source}},{eased:!1})}function Rt(t,e,n,o,r,a){let s=e.focusState,c=Array.from({length:o},(u,h)=>n(h)?1:-1),i=t.easing??D("cubic");return t.animate(u=>{let h=i(u);return{focusState:{dim:et(s?.dim??r,r,h),grow:et(s?.grow??a,a,h),values:c.map((f,l)=>et(s?.values[l]??0,f,h))}}},{eased:!1})}var he={...It,padding:p.insets},pe=oe(he,{reveal:{args:{style:p.oneOf(Q,{default:"scale"}),...S(.5)},run:(t,e,n)=>{let o=t.args.style??"scale",r=t.easing??(o==="scale"||o==="flip"?wt("back"):wt("cubic")),a=Y(t,e,n,t.args.staggerOrder),s=t.args.stagger??.5;return t.animate(c=>c>=1?{revealState:null}:{revealState:{style:o,values:a.map(i=>r(N(i,c,s)))}},{eased:!1})}},conceal:{args:{style:p.oneOf(Q,{default:"scale"}),...S(.5)},run:(t,e,n)=>{let o=t.args.style??"scale",r=t.easing??(o==="scale"||o==="flip"?re("back"):D("cubic")),a=Y(t,e,n,t.args.staggerOrder),s=t.args.stagger??.5,c=e.revealState?.values;return t.animate(i=>({revealState:{style:o,values:a.map((u,h)=>(c?.[h]??1)*(1-r(N(u,i,s))))}}),{eased:!1})}},wave:{args:{style:p.oneOf(xt,{default:"scale"}),amount:p.number(.3,{min:0,max:2,step:.05}),...S(.7)},run:(t,e,n)=>{let o=t.args.style??"scale",r=t.args.amount??.3,a=t.easing??D("sine"),s=Y(t,e,n,t.args.staggerOrder),c=t.args.stagger??.7;return t.animate(i=>i>=1?{waveState:null}:{waveState:{style:o,amount:r,values:s.map(u=>Math.sin(Math.PI*a(N(u,i,c))))}},{eased:!1})}},focus:{args:{item:p.number(0,{min:0,step:1}),dim:p.number(.7,{min:0,max:1,step:.05}),grow:p.number(.15,{min:0,max:1,step:.05})},run:(t,e,n)=>{let o=Math.round(t.args.item??0);return Rt(t,e,r=>r===o,n.length,t.args.dim??.7,t.args.grow??.15)}},unfocus:(t,e)=>{let n=e.focusState,o=t.easing??D("cubic");return t.animate(r=>{if(r>=1||!n)return{focusState:null};let a=1-o(r);return{focusState:{...n,values:n.values.map(s=>s*a)}}},{eased:!1})},spreadTo:{args:{spread:p.number(1,{min:0,max:3,step:.05})},run:t=>t.tween({spread:t.args.spread??1})},shuffle:{args:{seed:p.number(1,{min:0,step:1}),...S(b)},run:(t,e,n)=>{let o=I(e.order,n.length),r=W(o,t.args.seed??1);return r.length>1&&r.every((a,s)=>a===o[s])&&(r=[...r.slice(1),r[0]]),z(t,e,n,{order:r})}},swap:{args:{first:p.number(0,{min:0,step:1}),second:p.number(1,{min:0,step:1}),...S(0)},run:(t,e,n)=>{let o=I(e.order,n.length),r=o.indexOf(Math.round(t.args.first??0)),a=o.indexOf(Math.round(t.args.second??1));return r>=0&&a>=0&&([o[r],o[a]]=[o[a],o[r]]),z(t,e,n,{order:o},0)}},reorder:{args:{order:p.text(""),...S(b)},run:(t,e,n)=>{let o=I(yt(t.args.order),n.length);return z(t,e,n,{order:o})}},morphInto:{args:{target:At($),...S(b)},run:(t,e,n)=>z(t,e,n,{arrangeLike:t.args.target??""})}});function de(t){let e=B.get(t);if(!e)throw new Error(`"${t}" is no grid: pass its component through ItemGrid.define.`);return e.arranger}function nt(t,e){if(!t)return null;let n=B.get(t.key);return!n||e.isSelf(t)?null:{view:t,arranger:n.arranger}}function Gt(t){return e=>t.length===0?!1:e.state.children?.[0]===t[0]}function Pt(t,e,n){return{state:e,arranger:de(t.node.key),children:n,isSelf:o=>o.id===t.node.id}}function me(t,e,n){let o=Pt(t,e,n),r=nt(e.arrangeLike,o);return{arrangement:r?r.arranger.arrangement(r.view.state,K(r.view)):o.arranger.arrangement(e,L(t.node.size,e.padding)),source:r?.view.id??"",order:I(e.order,n.length),spread:e.spread}}function _t(t,e,n,o){let r=t.map(s=>s.measure(e)),a=o.itemSpace?o.itemSpace(n,t.length,e):e;return a===e?r:t.map(s=>s.measure(a))}function ge(t,e){let n=nt(t.state.arrangeLike,t);return n?n.arranger.arrangement(n.view.state,K(n.view)):t.arranger.arrangement(t.state,e)}function ot(t,e,n,o,r){let a=t.state,s=nt(a.arrangeLike,t),c=s?K(s.view):o,i=s?s.arranger.arrangement(s.view.state,c):t.arranger.arrangement(a,o),u=j(i,{count:e,sizes:n,box:c,time:r});return s&&(u=Ct(s.view.frame,u)),{slots:U(I(a.order,e)).map(f=>Z(u[f],a.spread)),arrangement:i}}function xe(t,e,n,o){let r=t.state,a=e.length,s=ot(t,a,e,n,o).slots,c=r.transition;if(c){let{from:f}=c,l=f.source?r.transitionSource:null,m=l&&l.id===f.source&&B.has(l.key)?l:null,k=m!==null&&t.isSelf(m),A=m&&!k?K(m):n,g=j(f.arrangement,{count:a,sizes:e,box:A,time:o});m&&!k&&(g=Ct(m.frame,g));let x=U(I(f.order,a));for(let d=0;d<a;d++)s[d]=rt(Z(g[x[d]],f.spread),s[d],c.mix[d]??1)}let i=r.revealState,u=r.waveState,h=r.focusState;if(i||u||h)for(let f=0;f<a;f++)Mt(s[f],f,e[f],i,u,h);return s}function vt(t,e){return J(e)||(t.transition?J(t.transition.from.arrangement):0)}function Me(t){return{perspective:t,orbit:0,elevation:0,dolly:0,lookAt:le,zoom:1,heading:0,viewportX:0,viewportY:0}}function ye(t,e,n){let o={x:t.x+e.x,y:e.y-t.y,width:n.width,height:n.height};return e.rotation===0&&e.scale===1&&e.rotationX===0&&e.rotationY===0&&e.depth===0&&e.opacity===1?o:{...o,rotation:e.rotation,scale:e.scale,rotationX:e.rotationX,rotationY:e.rotationY,depth:e.depth,opacity:e.opacity}}function Ct(t,e){return e.map(n=>{let o=Se(n.x*t.scale,n.y*t.scale,t.rotation);return{...n,x:t.x+o.x,y:t.y+o.y,depth:n.depth*t.scale,rotation:n.rotation+t.rotation,scale:n.scale*t.scale}})}function K(t){return L(t.size,t.state.padding)}function L(t,e){let n=St.insetBounds(t.width,t.height,e);return{width:n.width,height:n.height}}function we(t,e,n){let o=0,r=0;for(let a=0;a<t.length;a++){let s=t[a],c=e[a],i=s.rotation*Math.PI/180,u=Math.abs(Math.cos(i)),h=Math.abs(Math.sin(i)),f=n>0&&n-s.depth>1?n/(n-s.depth):1,l=(c.width*u+c.height*h)/2*s.scale*f,m=(c.width*h+c.height*u)/2*s.scale*f;o=Math.max(o,Math.abs(s.x)*f+l),r=Math.max(r,Math.abs(s.y)*f+m)}return{width:o*2,height:r*2}}function Se(t,e,n){if(n===0)return{x:t,y:e};let o=n*Math.PI/180,r=Math.cos(o),a=Math.sin(o);return{x:t*r+e*a,y:-t*a+e*r}}function ke(t,e){return Math.abs(t.width-e.width)<1e-6&&Math.abs(t.height-e.height)<1e-6}function et(t,e,n){return t+(e-t)*n}import{findNode2D as An,frameIn as In}from"@motionscript/sdk";export{y as a,rt as b,Z as c,at as d,be as e,ct as f,Re as g,it as h,ut as i,Ge as j,Ft as k,ve as l,Ce as m,Ne as n,ft as o,Ht as p,lt as q,Ye as r,Be as s,ht as t,qt as u,pt as v,Xe as w,He as x,We as y,j as z,J as A,jt as B,W as C,dt as D,mt as E,gt as F,N as G,Q as H,xt as I,Mt as J,I as K,U as L,yt as M,$ as N,b as O,S as P,Lt as Q,Nt as R,An as S,In as T};
+//# sourceMappingURL=chunk-TYNFMZ3D.js.map