asciify-engine 4.21.0 → 4.23.0

package/README.md

@@ -646,6 +646,19 @@ const field = mountGlyphField(canvas, {
 
 It needs WebGL2 on a GPU: `isGlyphFieldSupported()` is false without it or on software WebGL, and slow devices step down to 1× pixels and then still ambient motion. Keep a poster or the `/studio` renderer as the fallback. A still field stops drawing once its wake settles. Measured in Playwright Chromium on an Apple M4 Pro at 1440 × 900 and device pixel ratio 2, a full-viewport field held 120 fps (9 ms 95th-percentile frame) under continuous pointer movement; measure your own targets. See the [field guide](skills/asciify-engine/references/glyph-field.md) and [brand field example](examples/glyph-field.ts). It is a separate entry: the root, `/core`, `/hover` and `/studio` never load it.
 
+## 4.23: dialogs always render, sharper motion cues, cleaner hovers
+
+- Kit fields inside an open modal dialog always get a WebGL context: fields covered by the dialog give theirs up and come back when it closes. A released field hands its canvas back at once (Safari counts dead contexts toward its limit), and a field whose context is lost recovers onto a fresh canvas.
+- Depth is fused from focus, haze, a horizon prior, texture and saliency with an edge-aware filter; Drift finds water (including non-blue seas by reflection), sky, cloud and falling water, and holds everything else still. The classic core renderer shares the same motion code. Analysis follows grid changes and reads the ungraded photo.
+- Water settles cleanly; Ripple and Emboss draw their own rings on dark or transparent ground; glyph fields take `scope`; video subjects update as the video plays; the hover catalog (`HOVER_CONTROLS`, `DEFAULT_HOVER`, `resolveHover`) is exported once. On the GPU path, Trail keeps the artwork's ground and Water moves whole cells.
+
+## 4.22: photo-aware motion and finish
+
+- A new set of still-image motions read the photo's own light, form, highlights, detail and estimated depth: `relight`, `sheen` (specular sweep), `glow` (highlight bloom), `shimmer` (glints), `parallax`, `push`, `focus`, `mist`, `current` (drift) and `develop`.
+- Retired motions keep working through `DEPRECATED_STUDIO_MOTIONS`: caustics → sheen, grain → shimmer, trace → relight, tidal/weave/breeze → current, reform/print/unfold → develop.
+- Optical finish: bloom is a wide soft glow around highlights, and grain is fine film grain weighted to the midtones.
+- Animation presets are re-paired with the new motions, plus a new Depth study.
+
 ## 4.21: premium hovers that know the subject
 
 - Six new hovers: `loupe`, `reveal`, `repel`, `tilt`, `haze` and `bleed`; `scatter`, `elastic` and `ripple` are refined, and `rake` is deprecated (it plays `silk`).

package/dist/{animation-presets-DztfFvTc.d.cts → animation-presets-CzM3jLT6.d.cts}

@@ -1,4 +1,4 @@
-import { A as AmbientMotion, S as SurfaceHover } from './hover-guide-DKRQPtDO.cjs';
+import { A as AmbientMotion, S as SurfaceHover } from './hover-catalog-CrmxlmUe.cjs';
 
 interface StudioAnimationPreset {
     readonly id: string;
@@ -19,11 +19,11 @@ interface StudioAnimationPreset {
 declare const STUDIO_ANIMATION_PRESETS: readonly [{
     readonly id: "quiet-light";
     readonly label: "Quiet light";
-    readonly description: "Stationary detail with slowly turning light and a soft magnifying wake.";
+    readonly description: "A key light circles the subject’s own relief, with a soft magnifying wake.";
     readonly motion: {
         readonly type: "relight";
         readonly speed: 0.6;
-        readonly amount: 0.7;
+        readonly amount: 0.8;
     };
     readonly hover: {
         readonly effect: "lens";
@@ -32,26 +32,26 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "living-paper";
-    readonly label: "Living paper";
-    readonly description: "A gentle traveling bend and a directional pull under your cursor.";
+    readonly label: "Memory";
+    readonly description: "A slow push toward the subject; the image leans toward your cursor.";
     readonly motion: {
-        readonly type: "breeze";
-        readonly speed: 0.8;
-        readonly amount: 0.6;
+        readonly type: "push";
+        readonly speed: 0.5;
+        readonly amount: 0.8;
     };
     readonly hover: {
-        readonly effect: "smudge";
-        readonly radius: 0.4;
-        readonly strength: 0.5;
+        readonly effect: "tilt";
+        readonly radius: 0.5;
+        readonly strength: 0.45;
     };
 }, {
     readonly id: "silver-grain";
-    readonly label: "Silver grain";
-    readonly description: "Slow highlight glints with a fluid character trail.";
+    readonly label: "Silver light";
+    readonly description: "Sparse glints on bright detail, with a fluid character trail.";
     readonly motion: {
         readonly type: "shimmer";
-        readonly speed: 0.75;
-        readonly amount: 0.85;
+        readonly speed: 0.6;
+        readonly amount: 0.9;
     };
     readonly hover: {
         readonly effect: "trail";
@@ -60,26 +60,26 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "ripple-study";
-    readonly label: "Ripple study";
-    readonly description: "Soft moving light and expanding tonal rings on an anchored grid.";
+    readonly label: "Still water";
+    readonly description: "Smooth water and sky drift like a cinemagraph; your stroke sends out rings.";
     readonly motion: {
-        readonly type: "caustics";
+        readonly type: "current";
         readonly speed: 0.6;
-        readonly amount: 0.55;
+        readonly amount: 0.8;
     };
     readonly hover: {
         readonly effect: "ripple";
         readonly radius: 0.45;
-        readonly strength: 0.75;
+        readonly strength: 0.7;
     };
 }, {
     readonly id: "unfolding-print";
-    readonly label: "Unfolding print";
-    readonly description: "Panels turn and reassemble; your cursor dissolves a soft path.";
+    readonly label: "Darkroom";
+    readonly description: "The print develops from its highlights; your cursor dissolves a soft path.";
     readonly motion: {
-        readonly type: "unfold";
+        readonly type: "develop";
         readonly speed: 0.7;
-        readonly amount: 0.75;
+        readonly amount: 1;
     };
     readonly hover: {
         readonly effect: "dissolve";
@@ -88,18 +88,32 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "silk-flow";
-    readonly label: "Silk flow";
-    readonly description: "A slow current with directional folds that follow your hand.";
+    readonly label: "Morning mist";
+    readonly description: "Mist drifts through the distance; directional folds follow your hand.";
     readonly motion: {
-        readonly type: "current";
+        readonly type: "mist";
         readonly speed: 0.6;
-        readonly amount: 0.55;
+        readonly amount: 1;
     };
     readonly hover: {
         readonly effect: "silk";
         readonly radius: 0.4;
         readonly strength: 0.5;
     };
+}, {
+    readonly id: "depth-study";
+    readonly label: "Depth study";
+    readonly description: "A slow parallax drift from the photo’s own depth, with a loupe under your cursor.";
+    readonly motion: {
+        readonly type: "parallax";
+        readonly speed: 0.6;
+        readonly amount: 0.9;
+    };
+    readonly hover: {
+        readonly effect: "loupe";
+        readonly radius: 0.35;
+        readonly strength: 0.55;
+    };
 }];
 
 export { STUDIO_ANIMATION_PRESETS as S, type StudioAnimationPreset as a };

package/dist/{animation-presets-Bqupq1Gx.d.ts → animation-presets-a8WDzKDj.d.ts}

@@ -1,4 +1,4 @@
-import { A as AmbientMotion, S as SurfaceHover } from './hover-guide-DKRQPtDO.js';
+import { A as AmbientMotion, S as SurfaceHover } from './hover-catalog-CrmxlmUe.js';
 
 interface StudioAnimationPreset {
     readonly id: string;
@@ -19,11 +19,11 @@ interface StudioAnimationPreset {
 declare const STUDIO_ANIMATION_PRESETS: readonly [{
     readonly id: "quiet-light";
     readonly label: "Quiet light";
-    readonly description: "Stationary detail with slowly turning light and a soft magnifying wake.";
+    readonly description: "A key light circles the subject’s own relief, with a soft magnifying wake.";
     readonly motion: {
         readonly type: "relight";
         readonly speed: 0.6;
-        readonly amount: 0.7;
+        readonly amount: 0.8;
     };
     readonly hover: {
         readonly effect: "lens";
@@ -32,26 +32,26 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "living-paper";
-    readonly label: "Living paper";
-    readonly description: "A gentle traveling bend and a directional pull under your cursor.";
+    readonly label: "Memory";
+    readonly description: "A slow push toward the subject; the image leans toward your cursor.";
     readonly motion: {
-        readonly type: "breeze";
-        readonly speed: 0.8;
-        readonly amount: 0.6;
+        readonly type: "push";
+        readonly speed: 0.5;
+        readonly amount: 0.8;
     };
     readonly hover: {
-        readonly effect: "smudge";
-        readonly radius: 0.4;
-        readonly strength: 0.5;
+        readonly effect: "tilt";
+        readonly radius: 0.5;
+        readonly strength: 0.45;
     };
 }, {
     readonly id: "silver-grain";
-    readonly label: "Silver grain";
-    readonly description: "Slow highlight glints with a fluid character trail.";
+    readonly label: "Silver light";
+    readonly description: "Sparse glints on bright detail, with a fluid character trail.";
     readonly motion: {
         readonly type: "shimmer";
-        readonly speed: 0.75;
-        readonly amount: 0.85;
+        readonly speed: 0.6;
+        readonly amount: 0.9;
     };
     readonly hover: {
         readonly effect: "trail";
@@ -60,26 +60,26 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "ripple-study";
-    readonly label: "Ripple study";
-    readonly description: "Soft moving light and expanding tonal rings on an anchored grid.";
+    readonly label: "Still water";
+    readonly description: "Smooth water and sky drift like a cinemagraph; your stroke sends out rings.";
     readonly motion: {
-        readonly type: "caustics";
+        readonly type: "current";
         readonly speed: 0.6;
-        readonly amount: 0.55;
+        readonly amount: 0.8;
     };
     readonly hover: {
         readonly effect: "ripple";
         readonly radius: 0.45;
-        readonly strength: 0.75;
+        readonly strength: 0.7;
     };
 }, {
     readonly id: "unfolding-print";
-    readonly label: "Unfolding print";
-    readonly description: "Panels turn and reassemble; your cursor dissolves a soft path.";
+    readonly label: "Darkroom";
+    readonly description: "The print develops from its highlights; your cursor dissolves a soft path.";
     readonly motion: {
-        readonly type: "unfold";
+        readonly type: "develop";
         readonly speed: 0.7;
-        readonly amount: 0.75;
+        readonly amount: 1;
     };
     readonly hover: {
         readonly effect: "dissolve";
@@ -88,18 +88,32 @@ declare const STUDIO_ANIMATION_PRESETS: readonly [{
     };
 }, {
     readonly id: "silk-flow";
-    readonly label: "Silk flow";
-    readonly description: "A slow current with directional folds that follow your hand.";
+    readonly label: "Morning mist";
+    readonly description: "Mist drifts through the distance; directional folds follow your hand.";
     readonly motion: {
-        readonly type: "current";
+        readonly type: "mist";
         readonly speed: 0.6;
-        readonly amount: 0.55;
+        readonly amount: 1;
     };
     readonly hover: {
         readonly effect: "silk";
         readonly radius: 0.4;
         readonly strength: 0.5;
     };
+}, {
+    readonly id: "depth-study";
+    readonly label: "Depth study";
+    readonly description: "A slow parallax drift from the photo’s own depth, with a loupe under your cursor.";
+    readonly motion: {
+        readonly type: "parallax";
+        readonly speed: 0.6;
+        readonly amount: 0.9;
+    };
+    readonly hover: {
+        readonly effect: "loupe";
+        readonly radius: 0.35;
+        readonly strength: 0.55;
+    };
 }];
 
 export { STUDIO_ANIMATION_PRESETS as S, type StudioAnimationPreset as a };