Files
Miguel Ángel 590c192498 feat(catalog): add 3D objects, cursors, snow, starfield and paper transitions (#4349)
* feat(catalog): shelve 3D objects and cursors in their own catalog sections

Carries the generator grouping rules from #4310 and #4308.

* feat(registry): add a starfield ambient overlay

From #4313.

* feat(registry): add a falling snow ambient overlay

From #4331.

* feat(registry): add a torn-paper-rip transition

From #4321.

* feat(registry): add a paper-collage-reveal transition

From #4322.

* feat(registry): add a curtain-reveal transition

From #4323.

* feat(registry): add 3D objects: product turntable, glass hero, exploded stack, extruded logo

From #4310.

* feat(registry): add eight cursor animations and the dart cursor

From #4308.

* fix(catalog): find items by everyday editor words and accept a bare search word

From #4311.

* chore(registry): remove the simulated-cursor component

The Cursors section's new pointer animations replace it (from #4308).

* fix(registry): take cursor-zoom-follow's screenshot from runtime variables only

The declared default is empty, so page markup never becomes an image URL.

Clears the code-scanning alert raised on #4308.

* docs(cli): show a catalog search example that finds items

"smoke" matches nothing in the catalog; "crossfade" finds fade-through.

* chore(ci): allow the simulated-cursor removal in the deletion guard

* fix(ci): skip tracked files missing from disk in the player CDN pin check

Catalog regeneration removes a deleted item's pages before the publish PR untracks them,

so the check crashed on every catalog deletion PR.

* chore(cli): drop comments that narrate catalog search history

* fix(registry): drag-drop keeps the family arrow and shows the drop slot only while hovering

* fix(registry): agent cursor labels its steps in an accent tag, no glow or sparkles, in 4.8 s

* fix(registry): annotate cursor draws a tapered marker stroke and clears the circled value

* fix(registry): show real file thumbnails and end the context menu demo sooner

* fix(registry): give marquee select real photos, a Finder-blue marquee and a tighter loop

* fix(registry): centre the text-select toolbar on the selection and tighten its timing

* fix(registry): selection cursors default to the macOS system blue

* style(registry): format the agent and annotate cursor sources

* fix(registry): dart-cursor stops covering the choice it makes and shows the export finishing

* fix(registry): frame the product turntable fully and light it with two studio softboxes

* fix(registry): touch-indicator taps like a real phone and the post it taps gets liked

* fix(registry): press-ripple confirms with a check and small click rings at the cursor

* fix(registry): exploded stack separates at once and marks each layer in blue as it is labelled

* fix(registry): extruded logo settles facing the camera, set in Geist Bold with a neutral rim

* fix(registry): magnetic cursor docks its toolbar on the selection and ends after the press

* style(registry): format the exploded stack source

* fix(registry): glyph trail becomes a tutorial cursor path with numbered steps on a settings screen

* fix(registry): make glass-hero a clear lens that shows the headline through it

* fix(registry): snow reads as real snowfall with bokeh flakes over a winter title card

* fix(registry): oversized cursor is a 3.5x arrow that clicks a real editor toggle on

* fix(registry): starfield reads as a drifting night sky over a real title card

* style(registry): format the glass hero source

* fix(registry): make the paper tear show a white fibrous edge and lift the torn sheet away

* fix(registry): curtain reveal draws velvet folds that gather onto a title card

* fix(registry): make every zoom-follow click change the screen and read at zoom

* fix(registry): paper collage pieces stay opaque, tear with deckled grain and lift away on an arc

* refactor(registry): drop dead code and correct stale comments in reworked items

* fix(registry): agent cursor scrubs cleanly, docs match press-ripple, fictional demo names

* docs(registry): catalog notes say oversized-cursor exits and how it differs from press-ripple

* docs(registry): plain lowercase comments in oversized-cursor and touch-indicator

* docs(registry): oversized-cursor names CLICK_AT as the click cue
2026-09-28 22:03:59 +00:00
..

cursor-glyph-trail

A tutorial cursor path. On a Settings screen the arrow clicks through three steps: turn on the email digest, pick Weekly, save. Each move leaves a dotted trail spaced evenly by distance (not by time), each click leaves a numbered step marker, and a step's trail fades as the next move begins, so a viewer can follow the path without the screen filling with noise. The markers stay, so the last frame reads as the recap.

3.5s authored, elastic HOLD, exit none by default.

Variables

id type default notes
glyphs string "" Deprecated and ignored; still accepted so existing mounts keep working.
density enum med Spacing between trail dots: low (30), med (21), high (15) px at 1920 wide.
path enum sweep How each move bends: sweep a gentle curve, arc a deeper one, zigzag a straight line.
fade number 0.5 Seconds a step trail takes to fade once the next move begins, clamped 0.3 to 1.5.
accent enum green Trail and marker color: green rides --brand, blue rides --accent, violet rides --accent-2.
exit enum none none holds until the cut; fade departs opacity-only; up rises out.

Actor slot

The arrow can be replaced. Place an inert template anywhere in the HOST page (templates never render, and the runtime wipes the host clip's own children on mount, so the slot lives at document level); its content is centred on the click point:

<template data-slot="cursor-glyph-trail-actor">
  <img src="./assets/cursor.svg" alt="" style="width: 4cqmin" />
</template>

With no slot, the component draws the family arrow (64 px at 1920 wide).

Mount

<div
  class="clip"
  data-composition-id="cursor-glyph-trail"
  data-composition-src="./cursor-glyph-trail.html"
  data-variable-values='{"path":"sweep","density":"med","accent":"green"}'
  data-start="0"
  data-duration="3.5"
  data-track-index="0"
></div>

Elastic root: no data-width/data-height; it fills whatever box the host clip gives it. Timeline registers under the literal cursor-glyph-trail key.

Notes

  • Seek-safe: every frame is render(t). The trail at time t is the part of each move's curve the cursor has covered by t, so seeking in any order lands the same frame.
  • Dots are a round-capped zero-length dash pattern along the covered part of the curve, which is what spaces them by distance.
  • Shorter durations compress every beat evenly.