asciify-engine 4.21.0 → 4.23.0

package/dist/{hover-guide-DKRQPtDO.d.ts → hover-catalog-CrmxlmUe.d.ts}

@@ -1,4 +1,7 @@
-type AmbientMotion = 'none' | 'caustics' | 'current' | 'reform' | 'sheen' | 'tidal' | 'grain' | 'parallax' | 'weave' | 'print' | 'trace' | 'relight' | 'shimmer' | 'breeze' | 'unfold';
+type AmbientMotion = 'none' | 'relight' | 'sheen' | 'glow' | 'shimmer' | 'parallax' | 'push' | 'focus' | 'mist' | 'current' | 'develop';
+/** Retired after 4.21: each still loads, as its closest photo-aware replacement. */
+type LegacyAmbientMotion = 'caustics' | 'grain' | 'trace' | 'tidal' | 'weave' | 'breeze' | 'reform' | 'print' | 'unfold';
+declare const DEPRECATED_MOTIONS: Readonly<Record<LegacyAmbientMotion, AmbientMotion>>;
 declare const MOTION_STYLES: readonly [{
     readonly value: "none";
     readonly mode: "none";
@@ -6,89 +9,65 @@ declare const MOTION_STYLES: readonly [{
     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: "relight";
+    readonly mode: "relight";
+    readonly group: "Light";
+    readonly label: "Relight";
+    readonly description: "A key light circles the subject and models its own relief, like moving a lamp around a sculpture.";
 }, {
     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 group: "Light";
+    readonly label: "Specular sweep";
+    readonly description: "One slow pass of light glances across the highlights and follows their form, then rests.";
+}, {
+    readonly value: "glow";
+    readonly mode: "glow";
+    readonly group: "Light";
+    readonly label: "Highlight bloom";
+    readonly description: "The brightest areas breathe a soft halo into their surroundings. Shadows stay deep.";
+}, {
+    readonly value: "shimmer";
+    readonly mode: "shimmer";
+    readonly group: "Light";
+    readonly label: "Glints";
+    readonly description: "Sparse glints on bright fine detail, like light on water, metal or an eye. Everything else holds still.";
 }, {
     readonly value: "parallax";
     readonly mode: "parallax";
-    readonly group: "Flow and depth";
+    readonly group: "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 description: "A slow camera drift: the subject moves against its background, read from the photo’s own depth cues.";
+}, {
+    readonly value: "push";
+    readonly mode: "push";
+    readonly group: "Depth";
+    readonly label: "Slow push";
+    readonly description: "A gentle push toward the subject and back, with nearer areas moving slightly more.";
+}, {
+    readonly value: "focus";
+    readonly mode: "focus";
+    readonly group: "Depth";
+    readonly label: "Focus pull";
+    readonly description: "Focus racks from the subject to the background and back; the characters soften out of focus.";
+}, {
+    readonly value: "mist";
+    readonly mode: "mist";
+    readonly group: "Atmosphere";
+    readonly label: "Mist";
+    readonly description: "Soft mist drifts through the distance and plain areas, leaving the subject clear.";
 }, {
-    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.";
+    readonly value: "current";
+    readonly mode: "current";
+    readonly group: "Atmosphere";
+    readonly label: "Drift";
+    readonly description: "Water swells and glints, falls stream down, sky and clouds drift slowly, like a cinemagraph. Subjects and buildings hold still.";
+}, {
+    readonly value: "develop";
+    readonly mode: "develop";
+    readonly group: "Reveal";
+    readonly label: "Develop";
+    readonly description: "The image holds, fades, then develops back in from its highlights to its shadows, like a print in the tray.";
 }];
 
 /** One public catalog for the hero, studio, documentation and integrations. */
@@ -199,13 +178,40 @@ declare const DEPRECATED_SURFACE_HOVERS: {
 };
 type DeprecatedSurfaceHover = keyof typeof DEPRECATED_SURFACE_HOVERS;
 type SurfaceHover = typeof SURFACE_HOVERS[number]['value'];
+/** Ranges, steps and defaults of the controls every hover shares, as the Studio and `mountHover` read them. */
+declare const HOVER_CONTROLS: {
+    readonly radius: {
+        readonly label: "Hover size";
+        readonly min: 0.1;
+        readonly max: 1;
+        readonly step: 0.05;
+        readonly default: 0.2;
+    };
+    readonly strength: {
+        readonly label: "Hover strength";
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.05;
+        readonly default: 0.55;
+    };
+    readonly decay: {
+        readonly label: "Linger";
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.05;
+        readonly default: 0.5;
+    };
+};
+/** The Studio's default hover. `mountHover` matches it, except that Trail starts with a wider radius (.45). */
+declare const DEFAULT_HOVER: {
+    readonly effect: "trail";
+    readonly strength: 0.55;
+    readonly radius: 0.2;
+    readonly decay: 0.5;
+    readonly scope: "all";
+    readonly edgeSafe: false;
+};
+/** A current hover ID for any saved or legacy value, or undefined when it is unknown. */
+declare function resolveSurfaceHover(value: unknown): SurfaceHover | undefined;
 
-/** Where a hover may act. `all` is the whole artwork; `subject` keeps it on the subject; `outside` keeps it off. */
-type HoverScope = 'all' | 'subject' | 'outside';
-declare const HOVER_SCOPES: readonly {
-    value: HoverScope;
-    label: string;
-    description: string;
-}[];
-
-export { type AmbientMotion as A, type DeprecatedSurfaceHover as D, type HoverScope as H, MOTION_STYLES as M, type SurfaceHover as S, DEPRECATED_SURFACE_HOVERS as a, HOVER_SCOPES as b, SURFACE_HOVERS as c };
+export { type AmbientMotion as A, type DeprecatedSurfaceHover as D, HOVER_CONTROLS as H, type LegacyAmbientMotion as L, MOTION_STYLES as M, type SurfaceHover as S, DEFAULT_HOVER as a, DEPRECATED_SURFACE_HOVERS as b, DEPRECATED_MOTIONS as c, SURFACE_HOVERS as d, resolveSurfaceHover as r };

package/dist/hover-guide-DdFnAnfU.d.cts

@@ -0,0 +1,9 @@
+/** Where a hover may act. `all` is the whole artwork; `subject` keeps it on the subject; `outside` keeps it off. */
+type HoverScope = 'all' | 'subject' | 'outside';
+declare const HOVER_SCOPES: readonly {
+    value: HoverScope;
+    label: string;
+    description: string;
+}[];
+
+export { type HoverScope as H, HOVER_SCOPES as a };

package/dist/hover-guide-DdFnAnfU.d.ts

@@ -0,0 +1,9 @@
+/** Where a hover may act. `all` is the whole artwork; `subject` keeps it on the subject; `outside` keeps it off. */
+type HoverScope = 'all' | 'subject' | 'outside';
+declare const HOVER_SCOPES: readonly {
+    value: HoverScope;
+    label: string;
+    description: string;
+}[];
+
+export { type HoverScope as H, HOVER_SCOPES as a };