asciify-engine 4.14.2 → 4.16.0

package/dist/kit.d.cts

@@ -249,7 +249,7 @@ type SkeletonBlock = 'text' | 'photo' | 'avatar';
 interface SkeletonOptions extends KitOptions {
     /** Selector for the placeholder blocks inside the element. `data-block` may name the kind (`text`, `photo`, `avatar`); images default to photo. Default `[data-block]`. */
     blocks?: string;
-    /** One shimmer cycle in ms: an eased sweep, then a short rest. Default 1600. */
+    /** One shimmer pass in ms. The wave loops without a pause until `resolve()`. Default 1400. */
     shimmer?: number;
     /** Each block resolves over this many ms. Default 420. */
     resolve?: number;
@@ -790,6 +790,15 @@ interface StreamTextOptions extends KitOptions {
     onState?: (state: StreamState) => void;
     /** Reasoning lines `reasoning()` keeps in view above the reply; older ones scroll up and fade. Default 2. */
     reasoningLines?: number;
+    /**
+     * How characters land, set at creation. `flicker`: a glyph cell flickers, then resolves into the letter. `roll`: each
+     * character rolls up through glyphs in the text's own font and settles on the crisp letter, like the odometer. Default `flicker`.
+     */
+    transition?: 'flicker' | 'roll';
+    /** Ms one character rolls under `transition: 'roll'`; each next character starts `stagger` ms later. Default 300. */
+    roll?: number;
+    /** Glyphs a character rolls through. Default `#%*+=-:`. */
+    glyphs?: string;
 }
 interface StreamTextHandle extends KitHandle<StreamTextOptions> {
     /** Appends a token: its characters land as flickering glyph cells that resolve into letters, left to right. */

package/dist/kit.d.ts

@@ -249,7 +249,7 @@ type SkeletonBlock = 'text' | 'photo' | 'avatar';
 interface SkeletonOptions extends KitOptions {
     /** Selector for the placeholder blocks inside the element. `data-block` may name the kind (`text`, `photo`, `avatar`); images default to photo. Default `[data-block]`. */
     blocks?: string;
-    /** One shimmer cycle in ms: an eased sweep, then a short rest. Default 1600. */
+    /** One shimmer pass in ms. The wave loops without a pause until `resolve()`. Default 1400. */
     shimmer?: number;
     /** Each block resolves over this many ms. Default 420. */
     resolve?: number;
@@ -790,6 +790,15 @@ interface StreamTextOptions extends KitOptions {
     onState?: (state: StreamState) => void;
     /** Reasoning lines `reasoning()` keeps in view above the reply; older ones scroll up and fade. Default 2. */
     reasoningLines?: number;
+    /**
+     * How characters land, set at creation. `flicker`: a glyph cell flickers, then resolves into the letter. `roll`: each
+     * character rolls up through glyphs in the text's own font and settles on the crisp letter, like the odometer. Default `flicker`.
+     */
+    transition?: 'flicker' | 'roll';
+    /** Ms one character rolls under `transition: 'roll'`; each next character starts `stagger` ms later. Default 300. */
+    roll?: number;
+    /** Glyphs a character rolls through. Default `#%*+=-:`. */
+    glyphs?: string;
 }
 interface StreamTextHandle extends KitHandle<StreamTextOptions> {
     /** Appends a token: its characters land as flickering glyph cells that resolve into letters, left to right. */