asciify-engine 4.20.0 → 4.22.0

package/skills/asciify-engine/references/studio-effects.md

@@ -30,29 +30,78 @@ The positioned host must fit the displayed source canvas. The surface appends a
 
 ## Hover choices
 
-| Module `effect` | Behavior |
-| --- | --- |
-| `trail` | Density wake with a fading tail; glyph grid remains fixed. |
-| `water` | Local refraction; opt into protected boundaries with `edgeSafe: true`. |
-| `contour` | Expanding ring echoes along the pointer path. |
-| `dissolve` | Fading/reforming density trace with a lingering tail. |
-| `silk` | Directional folds following the stroke. |
-| `vortex` | Local rotational wake. |
-| `magnetic` | Attracts the field toward a stroke, then relaxes. |
-| `scatter` | Spatially varied radial scatter with a decaying wake. |
-| `etch` | Signed light-and-shadow impression; the glyph grid stays fixed. |
-| `elastic` | Directional momentum, damped recoil and a return to rest. |
-| `rake` | Alternating strips shear with the pointer, then align again. |
-| `lens` | Smooth local magnification, relaxing when the pointer stops. |
-| `smudge` | Directional source drag with a non-oscillating release. |
-| `ripple` | Expanding signed tonal wave packets; speed-sensitive and fixed-grid. |
-| `none` | No hover effect. |
+Nineteen hovers plus Off, in three families. All share `strength` (0–1), `radius` (0.1–1), `decay` (0–1, default .5: lower snaps back, higher lingers), `edgeSafe` and `scope` (below), in both `mountStudio` settings (`hover: {...}`) and `mountHover` options.
+
+| Module `effect` | Family | Behavior | Good for |
+| --- | --- | --- | --- |
+| `trail` | Change characters | Density wake with a fading tail; glyph grid stays fixed. The signature Asciify hover. | Any portrait or hero; the default. |
+| `dissolve` | Change characters | Erases a soft path through the characters; the image reforms. | Quiet editorial pages. |
+| `contour` | Change characters | Fine tonal rings trace the path. | Line-art and print looks. |
+| `etch` | Change characters | Signed light-and-shadow impression (“Emboss”). | Engraving, paper. |
+| `ripple` | Change characters | Expanding signed tonal wave packets; faster strokes ring stronger. | Dot, LED and tile looks. |
+| `bleed` | Change characters | Ink bleed: ink wells up where the cursor rests, spreads along a fibrous paper grain, then dries back from its edges. | Sumi, woodcut, stipple, pen and ink. |
+| `water` | Move the image | Damped height-field refraction that settles after the stroke. | Frosted glass, water, calm heroes. |
+| `silk` | Move the image | Directional folds that follow the hand. | Fabric, fashion, slow motion. |
+| `vortex` | Move the image | A swirling wake. | Playful, music. |
+| `magnetic` | Move the image | The image gathers toward the stroke, then relaxes. | Product details. |
+| `scatter` | Move the image | Characters scatter in soft low-frequency drifts and spring back with one rebound. | Playful campaigns. |
+| `elastic` | Move the image | Pushes with the stroke, recoils past rest once, settles in about a second. | Toys, mascots. |
+| `lens` | Move the image | Lens wake: a magnifying wake along the stroke. | Detail-rich photos. |
+| `smudge` | Move the image | Drags the image along the stroke, no bounce. | Painterly looks. |
+| `loupe` | Follow the cursor | A flat-topped glass loupe rides a slightly springy follow, magnifies what it covers and compresses through a soft rim with a faint glint. Shrinks a little while moving fast, settles when you stop. | Products, cut-outs, halo overlays. |
+| `reveal` | Follow the cursor | A soft spotlight shows the original photograph through the thinned characters (Studio). On `/hover`, which has no photograph, it lights the characters instead. | Editorial, cinema, cut-outs (`scope: 'subject'`). |
+| `repel` | Follow the cursor | Characters part around the cursor into a packed ring, leaving a soft clearing; on leave they spring back with one soft rebound. | Stickers, tiles, mosaics. |
+| `tilt` | Follow the cursor | The image leans toward the cursor like a parallax card; bright areas sit nearer and move more (depth from smoothed brightness). | Album covers, posters, lock screens. |
+| `haze` | Follow the cursor | Heat haze: a rising shimmer bends the characters above the cursor, livelier while moving, calm at rest. | Neon, broadcast, dusk gradients. |
+| `none` | | No hover effect. | |
+
+Retired: `rake` (its combed strips tore the image) now plays `silk`. Saved settings and old integrations keep working; `DEPRECATED_STUDIO_HOVERS` lists the mapping. Cursor hovers (`loupe`, `reveal`, `repel`, `tilt`, `haze`) store a fraction of the artwork, so they scale with it; stroke hovers keep their CSS-pixel reach.
 
 These are `/hover` module `effect` IDs, not the root engine’s legacy `HoverEffect` values. For example, passing `hoverEffect: 'water'` to the published engine is invalid.
 
+## Scope: on the subject, or around it
+
+`scope: 'all' | 'subject' | 'outside'` (default `'all'`; labels in `HOVER_SCOPES`: Everywhere, Subject, Around) decides where a hover acts.
+
+```ts
+await mountStudio(canvas, '/product-on-black.jpg', {
+  settings: { style: 'mixed', backdrop: { mode: 'transparent' }, hover: { effect: 'reveal', scope: 'subject' } },
+});
+mountHover(host, canvas, { effect: 'trail', scope: 'outside' }); // a wake around a cut-out, never across it
+```
+
+How the subject is found, in order:
+1. **Source alpha.** A transparent PNG, WebM or canvas: coverage is its alpha.
+2. **A drawn Studio mask** (`mask.enabled`): the mask is the subject (inverted masks invert it), multiplied with alpha.
+3. **A plain ground.** An opaque image whose border is one even tone (a product or figure on black or white, as the Cutout, Halo overlay and Mascot sticker looks expect) is keyed by each area's distance from that tone.
+4. **Otherwise** (a busy edge-to-edge photo) there is no reliable subject, so every scope behaves like `'all'` rather than guessing.
+
+Coverage is feathered over about 2% of the short side, so a scoped hover fades softly at the boundary and never clips hard. Displacement, tone and light are all weighted by it. With `'outside'` on a transparent ground, tone hovers (Trail, Contour, Emboss, Ripple, Ink bleed, Heat haze) draw their own marks in the ink colour on the empty ground. In `/hover` the subject is read from the drawn canvas once per still (`invalidate()` rereads it); for video the first frame's subject is kept.
+
+## Smart behaviour
+
+- Cursor hovers ease in on entry (no overshoot), start under the pointer instead of sliding in from the last exit, settle when the pointer rests and decay after it leaves; Repel releases with one soft rebound.
+- Touch: `mountHover` follows a finger while it drags (`touch: false` turns this off) and lets go when it lifts; a vertical swipe still scrolls the page. `mountStudio` follows touch drags on its canvas.
+- Reduced motion turns hovers off; hidden or offscreen surfaces stop drawing; a resting loupe stays drawn without redrawing every frame.
+
 ## Still-image motion and dither
 
-The module's `motion` IDs are `none`, `caustics` (traveling light on a fixed grid), `current` (Slow Current), `reform` (Reveal & Reform), `sheen` (diagonal light sweep), `tidal` (Tidal Rings), and `grain` (Living Grain). 4.4 adds `parallax` (shallow drift), `weave` (interlaced flow), `print` (staggered row registration), and `trace` (light that follows source-image tonal contours). Sheen, Living Grain and Contour Light keep the grid anchored. Contour Light uses source luminance; pass `getFrame` for exact source tones when layering a surface over an existing canvas. Keep source-video motion alone unless the user intentionally wants another animation layered onto it. For a still, select one motion and a restrained `motionSpeed`, rather than stacking effects.
+Still-image motion reads the photograph itself (its soft luminance, a relief normal, highlight nearness, local detail and an estimated depth, rebuilt per source frame) so light and movement are motivated by the image instead of laid over it. The `motion` IDs:
+
+| ID | Label | Group | What moves | Grid |
+|---|---|---|---|---|
+| `relight` | Relight | Light | A key light circles the subject and models its own relief; flat areas stay put. | anchored |
+| `sheen` | Specular sweep | Light | One slow pass of light across the upper midtones and highlights, bent by their form, then a rest. | anchored |
+| `glow` | Highlight bloom | Light | The brightest areas breathe a halo outward; deep shadows stay deep. | anchored |
+| `shimmer` | Glints | Light | Sparse, phased glints only on bright fine detail (water, metal, eyes). | anchored |
+| `parallax` | Parallax | Depth | Slow camera drift; near and far move against each other. | resampled |
+| `push` | Slow push | Depth | Ken Burns push toward the subject's center and back; nearer areas move slightly more. Never samples outside the frame. | resampled |
+| `focus` | Focus pull | Depth | Focus racks from subject to background and back; out-of-focus areas flatten toward their neighbourhood. | anchored |
+| `mist` | Mist | Atmosphere | Soft mist drifts through the distance and plain areas only. | anchored |
+| `current` | Drift | Atmosphere | Cinemagraph flow in smooth, distant areas; the detailed subject holds. | resampled |
+| `develop` | Develop | Reveal | Holds, fades, then develops back in from highlights to shadows. | anchored |
+
+"Anchored" motions change light only. "Resampled" motions move the image through a fixed character grid, so every glyph stays aligned and readable. Light motions mostly brighten the ink and change character density for only part of the shift, so light glows instead of flickering. Every motion except Relight, Glints and Mist shows the untouched still at time 0, which is what reduced motion and a paused preview display. Retired IDs still load as their closest replacement (`DEPRECATED_STUDIO_MOTIONS`): `caustics` → `sheen`, `grain` → `shimmer`, `trace` → `relight`, `tidal`/`weave`/`breeze` → `current`, `reform`/`print`/`unfold` → `develop`. Keep source-video motion alone unless the user intentionally wants another animation layered onto it. For a still, select one motion and a restrained `motionSpeed`, rather than stacking effects.
 
 For the website's fine-dither treatment, use the module's `fineDither: true` and `ditherStrength` after matching the backing canvas's character settings. This is separate from the core renderer’s built-in dither behavior. Check a still and a moving scene for flicker before choosing the default.
 
@@ -71,19 +120,19 @@ Version 1.3.0 adds text-shaped charcoal cutouts (`textMask`), peripheral scanlin
 
 ## Catalogs and useful combinations (4.4)
 
-Build controls from `STUDIO_HOVERS` and `STUDIO_MOTIONS`, exported by `/studio` and `/hover`. Each entry includes `value`, `label`, `group`, and `description`. Use the `value` as the API ID; “Emboss” is `etch` and “Contour Light” is `trace`. Do not maintain a second hard-coded menu or use the legacy core hover IDs for these interactions.
+Build controls from `STUDIO_HOVERS`, `HOVER_SCOPES` and `STUDIO_MOTIONS`, exported by `/studio` and `/hover`. Each entry includes `value`, `label` and `description` (hovers also a `group`). Show the scope control as a segmented choice next to the hover settings. Use the `value` as the API ID; “Emboss” is `etch`, “Specular sweep” is `sheen` and “Drift” is `current`. Do not maintain a second hard-coded menu or use the legacy core hover IDs for these interactions.
 
-For a fixed grid, try Contour Light with Emboss. For continuous spatial movement, try Parallax with Elastic. For a fabric-like treatment, try Woven Flow with Rake. These are combinations of two independent settings, not additional art styles. Keep strength restrained until you have checked the source at actual display size.
+For a fixed grid, try Relight with Emboss. For depth, try Parallax or Slow push with Tilt. For water and sky, try Drift with Ripple rings. These are combinations of two independent settings, not additional art styles. Keep strength restrained until you have checked the source at actual display size.
 
 All ambient modes repeat after `12 / speed` seconds. Looping the motion does not guarantee that a source video, film grain, dust, glitch or animated dither has the same boundary. Exported PNG/JPEG captures one frame; MP4/WebM/GIF carries autonomous motion, not live pointer movement. For complete composition export, use `/studio` rather than capturing the hover overlay.
 
 The pointer simulations have bounded storage. Elastic allocates its two velocity buffers only when first selected; idle effects stop. This is not a device-independent FPS promise. Test dense grids, fast reversal and the actual finish stack on the target device.
 
-## Lively images (4.10)
+## Lively images
 
-The catalogs contain fourteen active hover effects and fourteen active ambient motions, plus Off for each. New motion IDs are `relight`, `shimmer`, `breeze`, and `unfold`. Relight models midtones with a rotating light field; Shimmer slowly animates source highlights. Both keep geometry stationary. Breeze bends the image with a traveling sway. Unfold closes and opens staggered panels, then holds the complete image. All use deterministic 12-second base cycles; `motion.speed` changes cycle duration, `motion.amount` changes strength. These are local image treatments, not AI-generated scene or subject motion.
+The catalogs contain nineteen active hover effects and ten active ambient motions, plus Off for each (see the table above). All use deterministic 12-second base cycles; `motion.speed` changes cycle duration, `motion.amount` (0–2) changes strength. These are local image treatments driven by the photo's own light and depth estimate, not AI-generated scene or subject motion; the depth estimate favours a subject found from alpha or a plain ground, then sharp, central, lower detail.
 
-`STUDIO_ANIMATION_PRESETS` is exported by `/studio` and `/hover`. Its six entries have `id`, `label`, `description`, `motion: {type,speed,amount}`, and `hover: {effect,radius,strength}`. These are editable combinations, not additional renderer styles. Do not overwrite the rest of a user's settings to apply one:
+`STUDIO_ANIMATION_PRESETS` is exported by `/studio` and `/hover`. Its seven entries have `id`, `label`, `description`, `motion: {type,speed,amount}`, and `hover: {effect,radius,strength}`. These are editable combinations, not additional renderer styles. Do not overwrite the rest of a user's settings to apply one:
 
 ```ts
 import { mountStudio, STUDIO_ANIMATION_PRESETS } from 'asciify-engine/studio';
@@ -101,6 +150,6 @@ For a complete integration with independent PNG/MP4 export, copy the repository'
 
 For `/hover`, the same catalog needs an explicit shape conversion: `surface.update({ motion: preset.motion.type, motionSpeed: preset.motion.speed, effect: preset.hover.effect, radius: preset.hover.radius, strength: preset.hover.strength })`. `/hover` has no `motion.amount` option; use Studio for independently adjustable motion strength. Do not spread the nested Studio groups directly into surface options.
 
-Ripple rings uses at most eight wave packets and a fixed-resolution field. It does not allocate particles per character. Lens and Smudge reuse the existing field; their release integrates elapsed time, not a fixed frame count. Zero strength suppresses hover input; completed wakes sleep. These bounds and tests are not a guaranteed frame rate on every device.
+Every hover runs on one fixed field (128 cells on the long side) whatever the image size; cursor hovers are a few springs plus that field, and Ink bleed diffuses on it in fixed sub-steps. Measured in the Studio renderer at 640×480, 6px cells: 5–7ms per frame p50 for every hover, under 10ms p95. Ripple rings uses at most eight wave packets and a fixed-resolution field. It does not allocate particles per character. Lens and Smudge reuse the existing field; their release integrates elapsed time, not a fixed frame count. Zero strength suppresses hover input; completed wakes sleep. These bounds and tests are not a guaranteed frame rate on every device.
 
 To export a loop of a photo, use duration `12 / speed`. Restrict the speed/duration to your encoder's limits and use a frame count that fits whole cycles. Film grain, dust, glitch, pattern animation and input videos may not loop at that boundary. Pointer paths are not included in offline export. Respect reduced motion and provide pause; do not advertise artificial depth as true scene reconstruction.

package/skills/asciify-engine/references/studio-workspace.md

@@ -113,7 +113,7 @@ For PNG/JPEG, pass `time: player.time` and `motionTime: player.motionTime` to `e
 
 ## Still-image motion (3.0)
 
-Import `STUDIO_MOTIONS` from `/studio` to populate controls; each item has `value`, `label`, and `description`. Use `motion: { type: 'caustics' | 'current' | 'reform' | 'none', speed: 1 }`. Off is the default. Caustics preserves the grid, Current introduces fluid displacement, and Reform uses a staggered dissolve with a readable hold. Loops last 12 / speed seconds and preserve source/accent/gray color choice. Speed is 0.1–3. Do not combine source video with ambient motion unless requested. Hover remains independently configurable. Retired saved motion names normalize to Off. See [upgrading.md](upgrading.md) before moving an existing integration to 3.0.
+Import `STUDIO_MOTIONS` from `/studio` to populate controls; each item has `value`, `label`, and `description`. Use `motion: { type: 'relight' | 'sheen' | 'glow' | 'shimmer' | 'parallax' | 'push' | 'focus' | 'mist' | 'current' | 'develop' | 'none', speed: 1 }`. Off is the default. Every motion reads the photo's own light and depth ([studio-effects.md](studio-effects.md#still-image-motion-and-dither)); retired IDs such as `caustics` load as their closest replacement. Loops last 12 / speed seconds and preserve source/accent/gray color choice. Speed is 0.1–3. Do not combine source video with ambient motion unless requested. Hover remains independently configurable. Names retired in 3.0 normalize to Off; later retired names map to a current motion. See [upgrading.md](upgrading.md) before moving an existing integration to 3.0.
 
 ## Sharp previews (3.0.1)
 
@@ -166,9 +166,8 @@ and `scatter` (radial, spatially varied scatter that relaxes). Both retain a
 bounded field after cursor exit; radius and strength control the response.
 Use `hover.effect` in Studio and `effect` in mountHover. Defaults remain unchanged.
 
-Still-image motion now has six active choices: `caustics`, `current`, `reform`,
-`sheen`, `tidal`, and `grain`, plus `none`. Sheen and Living Grain change tone
-without displacement; Tidal Rings moves the image with protected edges.
+Still-image motion: see the current catalog in [studio-effects.md](studio-effects.md#still-image-motion-and-dither).
+Light motions change tone without displacement; depth motions move the image through a fixed grid.
 Set Studio `motion: { type: 'sheen', speed: 0.7, amount: 0.6 }`.
 Core uses `animationStyle`; mountHover uses `motion` and `motionSpeed`.
 Base cycles last 12 seconds; speed scales duration. Studio amount scales strength.
@@ -182,9 +181,9 @@ Stationary artwork, masks, lights, backdrops and character bloom are cached whil
 
 ## Expanded motion library (4.4)
 
-Use `STUDIO_HOVERS` and `STUDIO_MOTIONS` to show all available hovers and still-image motions, plus Off, grouped by behavior. New hover IDs are `etch`, `elastic`, `rake`; new motion IDs are `parallax`, `weave`, `print`, `trace`. `hover.radius` and `hover.strength` are independent of `motion.speed` and `motion.amount`. All remain serialized in look links and saved projects. A static photo needs no video input or AI service to animate.
+Use `STUDIO_HOVERS` and `STUDIO_MOTIONS` to show all available hovers and still-image motions, plus Off, grouped by behavior. New hover IDs are `etch`, `elastic`, `rake`; the 4.4 motions were later replaced by photo-aware ones (see [upgrading.md](upgrading.md)). `hover.radius` and `hover.strength` are independent of `motion.speed` and `motion.amount`. All remain serialized in look links and saved projects. A static photo needs no video input or AI service to animate.
 
-Example: `player.update({ motion: { type: 'trace', speed: 1, amount: .7 }, hover: { effect: 'etch', radius: .45, strength: .65 } })`. Tone and character choices remain yours. See [effect behaviors and combinations](studio-effects.md#catalogs-and-useful-combinations-44). Do not run several looping thumbnail canvases just to display this catalog; apply the selected treatment to one shared preview.
+Example: `player.update({ motion: { type: 'relight', speed: 1, amount: .7 }, hover: { effect: 'etch', radius: .45, strength: .65 } })`. Tone and character choices remain yours. See [effect behaviors and combinations](studio-effects.md#catalogs-and-useful-combinations-44). Do not run several looping thumbnail canvases just to display this catalog; apply the selected treatment to one shared preview.
 
 ## Tonal detail and blue noise (4.5)
 
@@ -202,7 +201,7 @@ const player = await mountStudio(canvas, '/portrait.jpg', {
     style: 'dither',
     color: { gamma: 1.12, shadows: .15, highlights: -.12 },
     dither: { algorithm: 'blue-noise', palette: 'gray8', scale: 3 },
-    motion: { type: 'trace', speed: .7, amount: .25 },
+    motion: { type: 'relight', speed: .7, amount: .4 },
   },
   maxDimension: 960,
   maxCells: 65536,

package/skills/asciify-engine/references/upgrading.md

@@ -85,3 +85,9 @@ Six additional `STUDIO_STYLES` use optional `print` settings. Existing v1 settin
 ## 4.10 interaction expansion
 
 Adds `lens`, `smudge`, `ripple` hover and `relight`, `shimmer`, `breeze`, `unfold` ambient motion. No IDs are removed and existing defaults remain. `STUDIO_ANIMATION_PRESETS` is exported by Studio and hover; its nested settings are shaped for `player.update`. Core accepts the new ambient IDs through `animationStyle`, with its existing simpler opacity treatment. Do not pass the new surface hover IDs to core `hoverEffect`. Update the npm dependency and refresh the agent skill separately; older packages do not implement these IDs.
+
+## Photo-aware motion and finish (after 4.21)
+
+The still-image motions are rebuilt to read the photograph's own light, relief, highlights, detail and depth instead of laying a pattern over it. The catalog is `relight`, `sheen` (Specular sweep), `glow` (Highlight bloom, new), `shimmer` (Glints), `parallax`, `push` (Slow push, new), `focus` (Focus pull, new), `mist` (new), `current` (Drift) and `develop` (new), plus `none`. Retired IDs keep working everywhere (Studio settings, share links, `mountHover` `motion`, core `animationStyle`) and load as their closest replacement, listed in `DEPRECATED_STUDIO_MOTIONS`: `caustics` → `sheen`, `grain` → `shimmer`, `trace` → `relight`, `tidal`, `weave`, `breeze` → `current`, `reform`, `print`, `unfold` → `develop`. Normalized settings store the new ID. Depth motions now move the image through a fixed character grid instead of moving glyphs. `STUDIO_ANIMATION_PRESETS` keeps its six IDs with new pairings and adds `depth-study`; the `wallpaper` look uses Relight.
+
+The optical finish's `bloom` is now a wide, soft-kneed halation screened over the image (no offset ghosts), and `grain` is fine triangular film grain weighted to the midtones. IDs and ranges are unchanged; existing looks render slightly softer and cleaner.

package/dist/hover-catalog-D85jh6dR.d.cts

@@ -1,173 +0,0 @@
-type AmbientMotion = 'none' | 'caustics' | 'current' | 'reform' | 'sheen' | 'tidal' | 'grain' | 'parallax' | 'weave' | 'print' | 'trace' | 'relight' | 'shimmer' | 'breeze' | 'unfold';
-declare const MOTION_STYLES: readonly [{
-    readonly value: "none";
-    readonly mode: "none";
-    readonly group: "Still";
-    readonly label: "Off";
-    readonly description: "Keep the image still. Hover stays available.";
-}, {
-    readonly value: "caustics";
-    readonly mode: "caustics";
-    readonly group: "Light and texture";
-    readonly label: "Caustics";
-    readonly description: "Soft ribbons of light travel across a stationary character grid.";
-}, {
-    readonly value: "current";
-    readonly mode: "current";
-    readonly group: "Flow and depth";
-    readonly label: "Slow Current";
-    readonly description: "A gentle flow through the image, with steady edges.";
-}, {
-    readonly value: "reform";
-    readonly mode: "reform";
-    readonly group: "Rebuild";
-    readonly label: "Reveal & Reform";
-    readonly description: "Disperse, gather, then hold the complete image.";
-}, {
-    readonly value: "sheen";
-    readonly mode: "sheen";
-    readonly group: "Light and texture";
-    readonly label: "Sheen";
-    readonly description: "A broad diagonal light sweep; characters stay anchored.";
-}, {
-    readonly value: "tidal";
-    readonly mode: "tidal";
-    readonly group: "Flow and depth";
-    readonly label: "Tidal Rings";
-    readonly description: "Concentric currents travel outward, with protected edges.";
-}, {
-    readonly value: "grain";
-    readonly mode: "grain";
-    readonly group: "Light and texture";
-    readonly label: "Living Grain";
-    readonly description: "Slow, individually phased tonal changes on a stationary grid.";
-}, {
-    readonly value: "parallax";
-    readonly mode: "parallax";
-    readonly group: "Flow and depth";
-    readonly label: "Parallax";
-    readonly description: "A shallow, continuous drift through the image, with the edges held in place.";
-}, {
-    readonly value: "weave";
-    readonly mode: "weave";
-    readonly group: "Flow and depth";
-    readonly label: "Woven Flow";
-    readonly description: "Interlaced bands move in opposing directions, like a flexible printed fabric.";
-}, {
-    readonly value: "print";
-    readonly mode: "print";
-    readonly group: "Rebuild";
-    readonly label: "Print Shift";
-    readonly description: "Staggered rows lift, soften and register back into the image.";
-}, {
-    readonly value: "trace";
-    readonly mode: "trace";
-    readonly group: "Light and texture";
-    readonly label: "Contour Light";
-    readonly description: "Light follows the source image’s tonal contours; every character stays anchored.";
-}, {
-    readonly value: "relight";
-    readonly mode: "relight";
-    readonly group: "Light and texture";
-    readonly label: "Relight";
-    readonly description: "A slow orbit of light models the image’s midtones, while the character grid stays fixed.";
-}, {
-    readonly value: "shimmer";
-    readonly mode: "shimmer";
-    readonly group: "Light and texture";
-    readonly label: "Shimmer";
-    readonly description: "Small highlights glint at different moments. Shadows stay quiet and the image stays in place.";
-}, {
-    readonly value: "breeze";
-    readonly mode: "breeze";
-    readonly group: "Flow and depth";
-    readonly label: "Breeze";
-    readonly description: "A traveling bend gently sways the image, like a print suspended in moving air.";
-}, {
-    readonly value: "unfold";
-    readonly mode: "unfold";
-    readonly group: "Rebuild";
-    readonly label: "Unfold";
-    readonly description: "Narrow panels turn, soften and return to a complete image, with a readable hold between cycles.";
-}];
-
-/** One public catalog for the hero, studio, documentation and integrations. */
-declare const SURFACE_HOVERS: readonly [{
-    readonly value: "none";
-    readonly label: "Off";
-    readonly group: "Still";
-    readonly description: "Keep the artwork still under the pointer.";
-}, {
-    readonly value: "trail";
-    readonly label: "Trail";
-    readonly group: "Change characters";
-    readonly description: "A fluid wake changes character density and settles behind your cursor.";
-}, {
-    readonly value: "dissolve";
-    readonly label: "Dissolve";
-    readonly group: "Change characters";
-    readonly description: "Erase a soft path through the characters; the image gradually reforms.";
-}, {
-    readonly value: "contour";
-    readonly label: "Contour";
-    readonly group: "Change characters";
-    readonly description: "Fine tonal rings trace your path without moving the grid.";
-}, {
-    readonly value: "etch";
-    readonly label: "Emboss";
-    readonly group: "Change characters";
-    readonly description: "Press a light-and-shadow impression into the characters; the grid stays fixed.";
-}, {
-    readonly value: "ripple";
-    readonly label: "Ripple rings";
-    readonly group: "Change characters";
-    readonly description: "Expanding light-and-shadow rings follow your stroke. Faster movement excites stronger rings; the grid stays still.";
-}, {
-    readonly value: "water";
-    readonly label: "Water";
-    readonly group: "Move the image";
-    readonly description: "Soft ripples refract the image and settle after your stroke.";
-}, {
-    readonly value: "silk";
-    readonly label: "Silk";
-    readonly group: "Move the image";
-    readonly description: "Directional folds follow the movement of your hand.";
-}, {
-    readonly value: "vortex";
-    readonly label: "Vortex";
-    readonly group: "Move the image";
-    readonly description: "A swirling wake curls through the image.";
-}, {
-    readonly value: "magnetic";
-    readonly label: "Magnetic Pull";
-    readonly group: "Move the image";
-    readonly description: "The image gathers toward your stroke, then relaxes.";
-}, {
-    readonly value: "scatter";
-    readonly label: "Scatter";
-    readonly group: "Move the image";
-    readonly description: "A textured outward scatter settles behind your cursor.";
-}, {
-    readonly value: "elastic";
-    readonly label: "Elastic";
-    readonly group: "Move the image";
-    readonly description: "Push the image with your stroke; it recoils and springs back into place.";
-}, {
-    readonly value: "rake";
-    readonly label: "Rake";
-    readonly group: "Move the image";
-    readonly description: "Comb the image into alternating ribbons that glide back into alignment.";
-}, {
-    readonly value: "lens";
-    readonly label: "Lens wake";
-    readonly group: "Move the image";
-    readonly description: "A soft magnifying wake brings details closer, then relaxes back into focus.";
-}, {
-    readonly value: "smudge";
-    readonly label: "Smudge";
-    readonly group: "Move the image";
-    readonly description: "Drag the image in the direction of your stroke; a smooth, lingering pull settles without a bounce.";
-}];
-type SurfaceHover = typeof SURFACE_HOVERS[number]['value'];
-
-export { type AmbientMotion as A, MOTION_STYLES as M, type SurfaceHover as S, SURFACE_HOVERS as a };

package/dist/hover-catalog-D85jh6dR.d.ts

@@ -1,173 +0,0 @@
-type AmbientMotion = 'none' | 'caustics' | 'current' | 'reform' | 'sheen' | 'tidal' | 'grain' | 'parallax' | 'weave' | 'print' | 'trace' | 'relight' | 'shimmer' | 'breeze' | 'unfold';
-declare const MOTION_STYLES: readonly [{
-    readonly value: "none";
-    readonly mode: "none";
-    readonly group: "Still";
-    readonly label: "Off";
-    readonly description: "Keep the image still. Hover stays available.";
-}, {
-    readonly value: "caustics";
-    readonly mode: "caustics";
-    readonly group: "Light and texture";
-    readonly label: "Caustics";
-    readonly description: "Soft ribbons of light travel across a stationary character grid.";
-}, {
-    readonly value: "current";
-    readonly mode: "current";
-    readonly group: "Flow and depth";
-    readonly label: "Slow Current";
-    readonly description: "A gentle flow through the image, with steady edges.";
-}, {
-    readonly value: "reform";
-    readonly mode: "reform";
-    readonly group: "Rebuild";
-    readonly label: "Reveal & Reform";
-    readonly description: "Disperse, gather, then hold the complete image.";
-}, {
-    readonly value: "sheen";
-    readonly mode: "sheen";
-    readonly group: "Light and texture";
-    readonly label: "Sheen";
-    readonly description: "A broad diagonal light sweep; characters stay anchored.";
-}, {
-    readonly value: "tidal";
-    readonly mode: "tidal";
-    readonly group: "Flow and depth";
-    readonly label: "Tidal Rings";
-    readonly description: "Concentric currents travel outward, with protected edges.";
-}, {
-    readonly value: "grain";
-    readonly mode: "grain";
-    readonly group: "Light and texture";
-    readonly label: "Living Grain";
-    readonly description: "Slow, individually phased tonal changes on a stationary grid.";
-}, {
-    readonly value: "parallax";
-    readonly mode: "parallax";
-    readonly group: "Flow and depth";
-    readonly label: "Parallax";
-    readonly description: "A shallow, continuous drift through the image, with the edges held in place.";
-}, {
-    readonly value: "weave";
-    readonly mode: "weave";
-    readonly group: "Flow and depth";
-    readonly label: "Woven Flow";
-    readonly description: "Interlaced bands move in opposing directions, like a flexible printed fabric.";
-}, {
-    readonly value: "print";
-    readonly mode: "print";
-    readonly group: "Rebuild";
-    readonly label: "Print Shift";
-    readonly description: "Staggered rows lift, soften and register back into the image.";
-}, {
-    readonly value: "trace";
-    readonly mode: "trace";
-    readonly group: "Light and texture";
-    readonly label: "Contour Light";
-    readonly description: "Light follows the source image’s tonal contours; every character stays anchored.";
-}, {
-    readonly value: "relight";
-    readonly mode: "relight";
-    readonly group: "Light and texture";
-    readonly label: "Relight";
-    readonly description: "A slow orbit of light models the image’s midtones, while the character grid stays fixed.";
-}, {
-    readonly value: "shimmer";
-    readonly mode: "shimmer";
-    readonly group: "Light and texture";
-    readonly label: "Shimmer";
-    readonly description: "Small highlights glint at different moments. Shadows stay quiet and the image stays in place.";
-}, {
-    readonly value: "breeze";
-    readonly mode: "breeze";
-    readonly group: "Flow and depth";
-    readonly label: "Breeze";
-    readonly description: "A traveling bend gently sways the image, like a print suspended in moving air.";
-}, {
-    readonly value: "unfold";
-    readonly mode: "unfold";
-    readonly group: "Rebuild";
-    readonly label: "Unfold";
-    readonly description: "Narrow panels turn, soften and return to a complete image, with a readable hold between cycles.";
-}];
-
-/** One public catalog for the hero, studio, documentation and integrations. */
-declare const SURFACE_HOVERS: readonly [{
-    readonly value: "none";
-    readonly label: "Off";
-    readonly group: "Still";
-    readonly description: "Keep the artwork still under the pointer.";
-}, {
-    readonly value: "trail";
-    readonly label: "Trail";
-    readonly group: "Change characters";
-    readonly description: "A fluid wake changes character density and settles behind your cursor.";
-}, {
-    readonly value: "dissolve";
-    readonly label: "Dissolve";
-    readonly group: "Change characters";
-    readonly description: "Erase a soft path through the characters; the image gradually reforms.";
-}, {
-    readonly value: "contour";
-    readonly label: "Contour";
-    readonly group: "Change characters";
-    readonly description: "Fine tonal rings trace your path without moving the grid.";
-}, {
-    readonly value: "etch";
-    readonly label: "Emboss";
-    readonly group: "Change characters";
-    readonly description: "Press a light-and-shadow impression into the characters; the grid stays fixed.";
-}, {
-    readonly value: "ripple";
-    readonly label: "Ripple rings";
-    readonly group: "Change characters";
-    readonly description: "Expanding light-and-shadow rings follow your stroke. Faster movement excites stronger rings; the grid stays still.";
-}, {
-    readonly value: "water";
-    readonly label: "Water";
-    readonly group: "Move the image";
-    readonly description: "Soft ripples refract the image and settle after your stroke.";
-}, {
-    readonly value: "silk";
-    readonly label: "Silk";
-    readonly group: "Move the image";
-    readonly description: "Directional folds follow the movement of your hand.";
-}, {
-    readonly value: "vortex";
-    readonly label: "Vortex";
-    readonly group: "Move the image";
-    readonly description: "A swirling wake curls through the image.";
-}, {
-    readonly value: "magnetic";
-    readonly label: "Magnetic Pull";
-    readonly group: "Move the image";
-    readonly description: "The image gathers toward your stroke, then relaxes.";
-}, {
-    readonly value: "scatter";
-    readonly label: "Scatter";
-    readonly group: "Move the image";
-    readonly description: "A textured outward scatter settles behind your cursor.";
-}, {
-    readonly value: "elastic";
-    readonly label: "Elastic";
-    readonly group: "Move the image";
-    readonly description: "Push the image with your stroke; it recoils and springs back into place.";
-}, {
-    readonly value: "rake";
-    readonly label: "Rake";
-    readonly group: "Move the image";
-    readonly description: "Comb the image into alternating ribbons that glide back into alignment.";
-}, {
-    readonly value: "lens";
-    readonly label: "Lens wake";
-    readonly group: "Move the image";
-    readonly description: "A soft magnifying wake brings details closer, then relaxes back into focus.";
-}, {
-    readonly value: "smudge";
-    readonly label: "Smudge";
-    readonly group: "Move the image";
-    readonly description: "Drag the image in the direction of your stroke; a smooth, lingering pull settles without a bounce.";
-}];
-type SurfaceHover = typeof SURFACE_HOVERS[number]['value'];
-
-export { type AmbientMotion as A, MOTION_STYLES as M, type SurfaceHover as S, SURFACE_HOVERS as a };