asciify-engine 4.15.0 → 4.17.0

package/dist/kit.d.cts

@@ -748,9 +748,7 @@ declare function toastStack(container: HTMLElement, options?: ToastStackOptions)
 
 type ThinkingState = 'thinking' | 'streaming' | 'done';
 interface ThinkingOptions extends KitOptions {
-    /** Line-shaped bands of drifting dots shown while thinking. Default 3. */
-    lines?: number;
-    /** An element to write the status into: `Thinking…`, then `Thought for 2s`. */
+    /** The status element: `Thinking…` while a wave of rolling characters runs through it, then `Thought for 2s`. */
     label?: HTMLElement | null;
     /** The status texts. */
     labels?: {
@@ -759,23 +757,32 @@ interface ThinkingOptions extends KitOptions {
     };
     /** Start thinking at once. Default true; false waits for `think()`. */
     start?: boolean;
-    /** Ms between one word and the next fading in. Default 38. */
+    /** Ms between one word of the answer and the next fading in. Default 38. */
     stagger?: number;
-    /** A dotted rule under the finished answer. Default true. */
-    rule?: boolean;
+    /** Ms one character of the label takes to roll through its glyphs and back. Default 520. */
+    roll?: number;
+    /** Ms between neighbouring characters as the wave runs across the label. Default 55. */
+    wave?: number;
+    /** Glyphs the label rolls through. Default `#%*+=-:`. */
+    glyphs?: string;
     /** Called on each state change; `seconds` is how long it thought, once known. For a status you render yourself. */
     onState?: (state: ThinkingState, seconds: number) => void;
+    /** @deprecated The dot bands were removed in 4.17; ignored. */
+    lines?: number;
+    /** @deprecated The dotted rule was removed in 4.17; ignored. */
+    rule?: boolean;
 }
 interface ThinkingHandle extends KitHandle<ThinkingOptions> {
     /** Clears the answer and thinks again, as for Regenerate. */
     think(): void;
-    /** Writes the answer, word by word, as the dots give way. Pass a string or an async iterable of chunks. Resolves when it has settled. */
+    /** Writes the answer, word by word, as the label settles. Pass a string or an async iterable of chunks. Resolves when it has settled. */
     stream(text: string | AsyncIterable<string>): Promise<void>;
     readonly state: ThinkingState;
 }
 /**
- * The thinking state of an assistant reply: line-shaped bands of drifting dots while the model thinks, then the answer
- * fades in word by word as the dots give way, leaving a quiet dotted rule under it.
+ * The thinking state of an assistant reply. While the model thinks, a wave runs through the status label: each letter in
+ * turn rolls up through glyphs and lands back on itself, in the label's own font. When the answer starts, every letter rolls
+ * once more into `Thought for 2s`, and the answer fades in word by word.
  */
 declare function thinking(element: HTMLElement, options?: ThinkingOptions): ThinkingHandle;
 
@@ -790,6 +797,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

@@ -748,9 +748,7 @@ declare function toastStack(container: HTMLElement, options?: ToastStackOptions)
 
 type ThinkingState = 'thinking' | 'streaming' | 'done';
 interface ThinkingOptions extends KitOptions {
-    /** Line-shaped bands of drifting dots shown while thinking. Default 3. */
-    lines?: number;
-    /** An element to write the status into: `Thinking…`, then `Thought for 2s`. */
+    /** The status element: `Thinking…` while a wave of rolling characters runs through it, then `Thought for 2s`. */
     label?: HTMLElement | null;
     /** The status texts. */
     labels?: {
@@ -759,23 +757,32 @@ interface ThinkingOptions extends KitOptions {
     };
     /** Start thinking at once. Default true; false waits for `think()`. */
     start?: boolean;
-    /** Ms between one word and the next fading in. Default 38. */
+    /** Ms between one word of the answer and the next fading in. Default 38. */
     stagger?: number;
-    /** A dotted rule under the finished answer. Default true. */
-    rule?: boolean;
+    /** Ms one character of the label takes to roll through its glyphs and back. Default 520. */
+    roll?: number;
+    /** Ms between neighbouring characters as the wave runs across the label. Default 55. */
+    wave?: number;
+    /** Glyphs the label rolls through. Default `#%*+=-:`. */
+    glyphs?: string;
     /** Called on each state change; `seconds` is how long it thought, once known. For a status you render yourself. */
     onState?: (state: ThinkingState, seconds: number) => void;
+    /** @deprecated The dot bands were removed in 4.17; ignored. */
+    lines?: number;
+    /** @deprecated The dotted rule was removed in 4.17; ignored. */
+    rule?: boolean;
 }
 interface ThinkingHandle extends KitHandle<ThinkingOptions> {
     /** Clears the answer and thinks again, as for Regenerate. */
     think(): void;
-    /** Writes the answer, word by word, as the dots give way. Pass a string or an async iterable of chunks. Resolves when it has settled. */
+    /** Writes the answer, word by word, as the label settles. Pass a string or an async iterable of chunks. Resolves when it has settled. */
     stream(text: string | AsyncIterable<string>): Promise<void>;
     readonly state: ThinkingState;
 }
 /**
- * The thinking state of an assistant reply: line-shaped bands of drifting dots while the model thinks, then the answer
- * fades in word by word as the dots give way, leaving a quiet dotted rule under it.
+ * The thinking state of an assistant reply. While the model thinks, a wave runs through the status label: each letter in
+ * turn rolls up through glyphs and lands back on itself, in the label's own font. When the answer starts, every letter rolls
+ * once more into `Thought for 2s`, and the answer fades in word by word.
  */
 declare function thinking(element: HTMLElement, options?: ThinkingOptions): ThinkingHandle;
 
@@ -790,6 +797,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. */