@prestyj/cli 5.28.0 → 5.29.0

package/assets/motion/fonts/finger-paint/OFL.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2011 by Ralph du Carrois, with Reserved Font Name 'Finger Paint'
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/motion/fonts/fonts.json

@@ -205,5 +205,61 @@
         "stretch": "75% 112.5%"
       }
     ]
+  },
+  {
+    "family": "Unbounded",
+    "dir": "unbounded",
+    "license": "OFL-1.1",
+    "use": "Wide, rounded display face for big titles.",
+    "files": [
+      {
+        "file": "unbounded-normal.woff2",
+        "style": "normal",
+        "weight": "200 900",
+        "stretch": null
+      }
+    ]
+  },
+  {
+    "family": "Sora",
+    "dir": "sora",
+    "license": "OFL-1.1",
+    "use": "Clean geometric sans for body text and captions.",
+    "files": [
+      {
+        "file": "sora-normal.woff2",
+        "style": "normal",
+        "weight": "100 800",
+        "stretch": null
+      }
+    ]
+  },
+  {
+    "family": "Short Stack",
+    "dir": "short-stack",
+    "license": "OFL-1.1",
+    "use": "Casual handwritten feel.",
+    "files": [
+      {
+        "file": "short-stack-normal.woff2",
+        "style": "normal",
+        "weight": "400",
+        "stretch": null
+      }
+    ]
+  },
+  {
+    "family": "Finger Paint",
+    "dir": "finger-paint",
+    "license": "OFL-1.1",
+    "use": "Playful painted, childlike handwritten feel.",
+    "files": [
+      {
+        "file": "finger-paint-normal.woff2",
+        "style": "normal",
+        "weight": "400",
+        "stretch": null
+      }
+    ]
   }
 ]

package/assets/motion/fonts/short-stack/OFL.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2011 by Sorkin Type Co (www.sorkintype.com),
+with Reserved Font Name "Short Stack".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/motion/fonts/sora/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2019 The Sora Project Authors (https://github.com/sora-xor/sora-font)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/motion/fonts/unbounded/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2022 The Unbounded Project Authors (https://github.com/googlefonts/unbounded)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/motion/library/README.md

@@ -19,19 +19,19 @@ bundled HyperFrames and fails on any rule below.
 Every look's `tokens.css` defines all of these on `.look-<id>`; every piece
 reads only these (plus its own literal geometry):
 
-| Token | Meaning |
-|---|---|
-| `--field` | Main background color |
-| `--field-2` | Alternate field for scene changes (color-field cuts) |
-| `--ink` | Primary type and line color; at least 4.5:1 on `--field` (aim for 7:1 on light and dark fields) |
-| `--accent` | The one emphasis color (may equal `--ink` in two-color looks) |
-| `--muted` | Secondary text / annotations; must reach 4.5:1 on `--field` (it is used for small labels) |
-| `--line` | Hairlines, grids, dots |
-| `--display` | Headline font stack |
-| `--display-weight` / `--display-stretch` / `--display-tracking` | Headline cut |
-| `--text` | Supporting text font stack |
-| `--mono` | Labels, readouts, code |
-| `--radius` | Corner radius for cards and UI |
+| Token                                                           | Meaning                                                                                         |
+| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `--field`                                                       | Main background color                                                                           |
+| `--field-2`                                                     | Alternate field for scene changes (color-field cuts)                                            |
+| `--ink`                                                         | Primary type and line color; at least 4.5:1 on `--field` (aim for 7:1 on light and dark fields) |
+| `--accent`                                                      | The one emphasis color (may equal `--ink` in two-color looks)                                   |
+| `--muted`                                                       | Secondary text / annotations; must reach 4.5:1 on `--field` (it is used for small labels)       |
+| `--line`                                                        | Hairlines, grids, dots                                                                          |
+| `--display`                                                     | Headline font stack                                                                             |
+| `--display-weight` / `--display-stretch` / `--display-tracking` | Headline cut                                                                                    |
+| `--text`                                                        | Supporting text font stack                                                                      |
+| `--mono`                                                        | Labels, readouts, code                                                                          |
+| `--radius`                                                      | Corner radius for cards and UI                                                                  |
 
 Pieces may set local fallbacks (`var(--ink, #111)`) but must not hardcode
 brand colors or font names.
@@ -42,7 +42,7 @@ brand colors or font names.
 block:
 
 - Root: `<div id="<id>-root" data-composition-id="<id>" data-start="0"
-  data-duration="<s>" data-width="1920" data-height="1080">`.
+data-duration="<s>" data-width="1920" data-height="1080">`.
 - Styles scoped under `[data-composition-id="<id>"]`. In scripts, find the
   root with `document.querySelector('[data-composition-id="<id>"]')`, never
   `getElementById("<id>-root")`: HyperFrames drops that id when it mounts
@@ -62,6 +62,9 @@ block:
   `three/addons/...` in a `<script type="module">`. The bundled Three.js
   and its importmap are installed into the project by `library.mjs add`
   (the importmap goes in the root `index.html` head).
+- Pieces built on the move kit set `"requires": ["kit"]` and call
+  `window.GGMotionKit`. `library.mjs add` installs the kit and returns the
+  `<script>` for the root `index.html` head (after GSAP).
 - Editable copy is plain text in the markup, marked with
   `<!-- edit: ... -->` comments; parameters are CSS variables or constants
   at the top of the script, documented in a header comment.
@@ -89,6 +92,39 @@ texture. `license` is `"original"` or `"MIT"`; MIT pieces also need
 `"source": { "url": "...", "author": "..." }` and are credited in the
 project's `CREDITS.md` when added.
 
+## Move kit
+
+`kit/moves.js` is EZ's own motion toolkit. Install it with
+`node library.mjs kit <project>` (or through any kit piece), put the printed
+`<script src="assets/kit/moves.js">` in the root head after GSAP, then use
+`window.GGMotionKit` from any composition script. It follows the library's
+determinism rules and is unit-tested. Every call, option and default is in
+the [Build sheet](../references/build-sheet.md); build from that, not from
+the kit's source.
+
+Every move takes the timeline, the element and a start time, adds its
+tweens, and returns the time of its key moment (landing, press, arrival), so
+the next move can start from it: `const landed = kit.dropLetters(tl, el, 0.4);
+kit.knock(tl, blocks, landed);`.
+
+| Family   | Moves                                                                                                                                    | Use for                                                                                                                                                                                                                         |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Timing   | `spring(t, name)`, `settleTime`, `springEase`, `ring`, `ease.{snap,drop,glide,travel,whip,settle,bounce,firm,cut}`, `rng(seed)`, `noise` | Springs (`snappy`, `bouncy`, `soft`, `heavy`, `whip`), contact ring-down, curves chosen by feel, seeded randomness                                                                                                              |
+| Arrivals | `liftWords`, `dropLetters`, `reveal`, `typewrite`, `tick`, `pop`, `stamp`                                                                | Words rising from their line, letters landing with squash, masks, typing with a caret, drawn checks, pop-ins, a seal slamming down                                                                                              |
+| Handoffs | `reshape`, `openFrom`, `diveThrough`, `converge`                                                                                         | A box becoming the next frame, a stage opening from the subject, pushing through a card, the cast travelling into the logo                                                                                                      |
+| Contact  | `hop` / `hopAt`, `impact`, `knock`                                                                                                       | A hop and landing, a hit that shakes or splits, a chain reaction passing momentum on                                                                                                                                            |
+| Camera   | `camera(tl, world, keys, opts)`, `cameraAt`, `handheld`, `shakeAt`, `atDepth`, `toScreen`                                                | An operated camera on one world layer: keyed whips and glides with lead, a hand-held float that is exactly zero in `rests`, shakes on impact, parallax `layers: [{ el, depth }]` (0 pinned, 0.5 far, 1 the world, above 1 near) |
+| Cursor   | `cursorPath(tl, cursor, at, stops)`, `cursorPlan`, `cursorAt`                                                                            | A cursor travelling on gentle arcs to real element centres (`{ el }` stops), pressing where `click` is set; returns press times to drive UI states and sounds                                                                   |
+| Sound    | `cue(tl, at, sfx, { gain, x, pan, send, name })`, `cues()`, `air()`                                                                      | Mark a sound on the event that makes it, panned with its screen `x` and at its own distance (`send`); `cues.mjs` exports them and the camera's speed (`air()`) for the score                                                    |
+| Helpers  | `drive(tl, at, dur, draw)`, `split`, `centerOf`, `rectOf`                                                                                | Draw anything as a pure function of local time; split text; measure layout without transforms                                                                                                                                   |
+
+Camera keys are where the camera looks: `{ at, x, y, zoom, rotate, move,
+duration }` in world pixels, `move` naming a curve (`whip` by default,
+`glide` for slow pushes, `cut` for a jump). The `camera-rig` piece shows the whole
+rig; `morph-carry`, `zoom-into-card`, `open-from-subject`, `gather-to-logo`,
+`chain-knock`, `one-shape-journey`, `scale-dive`, `request-to-result` and
+`screen-replica-steps` show the other moves in context.
+
 ## Look rules
 
 `looks/<id>/` contains:
@@ -102,3 +138,5 @@ project's `CREDITS.md` when added.
   2–3 scene recipes.
 - `sample.html`: a one-scene composition that shows the look, used for its
   preview. It links `assets/fonts/fonts.css` and `assets/looks/<id>.css`.
+  Videos should instead paste the `head` that `library.mjs look` returns: it
+  declares the fonts in the page, which `hf check` requires.