asciify-engine 4.17.0 → 4.19.0

package/dist/kit.d.ts

@@ -1,5 +1,5 @@
 import { GlyphField, GlyphFieldOptions } from './field.js';
-import { C as CHARACTER_SETS } from './characters-BgG9AZQl.js';
+import { C as CHARACTER_SETS } from './characters-BgECi5Lf.js';
 
 /** Options every kit component takes. */
 interface KitOptions {
@@ -270,30 +270,33 @@ declare function skeleton(element: HTMLElement, options?: SkeletonOptions): Skel
 
 type PillTone = 'green' | 'amber' | 'red' | 'neutral' | 'new';
 interface PillOptions extends KitOptions {
-    /** The tone of a pill without `data-tone`. `new` is a solid pill that takes a sheen on hover. Default `neutral`. */
+    /** The tone of a pill without `data-tone`. `new` is a solid pill led by a sparkle. Default `neutral`. */
     tone?: PillTone;
-    /** A live state such as Live or Syncing: the indicator breathes and a sweep crosses the pill every few seconds. `data-live` on a pill wins. Default false. */
+    /**
+     * A live state: the indicator moves. Amber turns a half-filled dot like a spinner (syncing); any other tone breathes its dot.
+     * `data-live` on a pill wins. Default false. Neutral shows an open ring, and a pill turning red blinks its dot open twice.
+     */
     live?: boolean;
-    /** A three-character indicator on status pills, drawn over the pill's `[data-dot]` element (one is added when missing). Default true. */
+    /** A one-cell glyph before the label, drawn over the pill's `[data-dot]` element (one is added when missing): a status dot, or a `new` pill's sparkle. Default true. */
     indicator?: boolean;
-    /** A gradient sheen of characters passes once across a `new` pill when the pointer enters it. Default true. */
+    /** A `new` pill's sparkle twinkles when the pointer enters it. Default true. */
     sheen?: boolean;
     /** Glyph hues to paint, as `[r, g, b]` 0–255, for the light and dark ground. */
     tones?: Partial<Record<'light' | 'dark', Partial<Record<PillTone, [number, number, number]>>>>;
 }
 interface PillHandle extends KitHandle<PillOptions> {
-    /** Runs the sheen once across one pill, or every `new` pill. */
+    /** Twinkles the sparkle on one pill, or on every `new` pill. */
     sheen(pill?: HTMLElement): void;
     /** Sets a count pill (`data-count`) to `value`; only the changed digits roll. Without `pill`, the first count pill. */
     count(value: number | string, pill?: HTMLElement): void;
     /** Re-reads each pill's `data-tone` and `data-live`; tone changes ease over 240ms. `update()` does this too. */
     refresh(): void;
 }
-/** Glyph hues painted into the source. The field normalises each hue and takes the glyph from its brightness. */
+/** Glyph hues painted into the source. The field normalises each hue and takes the glyph from its brightness. `new` is the neutral sparkle. */
 declare const PILL_TONES: Record<'light' | 'dark', Record<PillTone, [number, number, number]>>;
 /**
- * Pills and badges with a strip of characters in their tone: a breathing live indicator, a sweep across live states, a sheen on
- * `new` pills and rolling digits on count pills. One element gets a field under its text; a list shares one field over their common
+ * Pills and badges whose characters stay inside them: a glyph dot in each status pill's tone that breathes while live, turns
+ * while syncing and blinks on failure, a sparkle on `new` pills and rolling digits on count pills. One element gets a field under its text; a list shares one field over their common
  * container (one WebGL context for all), with each pill's labels lifted above it.
  */
 declare function pill(target: HTMLElement | Iterable<HTMLElement>, options?: PillOptions): PillHandle;
@@ -303,7 +306,7 @@ interface TabsOptions extends KitOptions {
     tabs?: string;
     /** The tab shown first. Default: the one with `aria-selected="true"`, else 0. */
     active?: number;
-    /** How long the indicator streams to a new tab, in ms. Default 280. */
+    /** How long the indicator glides to a new tab, in ms. Default 440. */
     duration?: number;
     /** How the kit shows panels named by `aria-controls`: `hidden` toggles the attribute, `attribute` toggles `data-active`, `none` leaves them. Default `hidden`. */
     panels?: 'hidden' | 'attribute' | 'none';
@@ -313,11 +316,15 @@ interface TabsOptions extends KitOptions {
     onChange?: (index: number, tab: HTMLElement) => void;
 }
 interface TabsHandle extends KitHandle<TabsOptions> {
-    /** Selects a tab; the indicator streams across to it. `focus` moves keyboard focus too. */
+    /** Selects a tab; the indicator glides across to it. `focus` moves keyboard focus too. */
     select(index: number, focus?: boolean): void;
     readonly active: number;
 }
-/** Segmented tabs whose active indicator is a pill of characters that streams across and condenses under the new tab. */
+/**
+ * Segmented tabs with a gliding indicator. The pill itself is yours to style from `--tabs-x`, `--tabs-y`, `--tabs-w` and `--tabs-h`,
+ * which the kit sets on the tablist every frame, so its outline stays crisp; the field draws a row of characters along its foot
+ * that streaks dense toward the leading end in flight and settles into an even, tapered line as it lands.
+ */
 declare function tabs(tablist: HTMLElement, options?: TabsOptions): TabsHandle;
 
 /** One update from an image provider. Either may be a Blob or a URL. */
@@ -521,6 +528,10 @@ interface CommandPaletteOptions extends KitOptions {
     onRun?: (index: number, row: HTMLElement) => void;
     /** Called after the palette opens or closes. */
     onOpenChange?: (open: boolean) => void;
+    /** A highlight that glides behind the selected row. `false` when your rows style `aria-selected` themselves. Default true. */
+    highlight?: boolean;
+    /** Rows that carry the AI signature: a sweep of characters runs through their highlight while selected. Default `[data-ai]`. */
+    ai?: string;
 }
 interface CommandPaletteHandle extends KitHandle<CommandPaletteOptions> {
     /** Condenses the palette out of the trigger. `focus` moves focus to the input (default true). */
@@ -528,7 +539,7 @@ interface CommandPaletteHandle extends KitHandle<CommandPaletteOptions> {
     /** Dissolves the palette back into the trigger. */
     close(): void;
     toggle(): void;
-    /** Moves the selection; the marker glides to the row. */
+    /** Moves the selection; the highlight glides to the row. */
     select(index: number): void;
     /** Runs a row as if it were clicked. */
     run(index?: number): void;
@@ -536,8 +547,8 @@ interface CommandPaletteHandle extends KitHandle<CommandPaletteOptions> {
     readonly selected: number;
 }
 /**
- * A command palette that condenses out of its trigger in blocks of characters and dissolves back into it, with a glyph marker
- * in the selected row's gutter that glides between rows.
+ * A command palette that condenses out of its trigger in blocks of characters and dissolves back into it. A highlight glides
+ * between rows, rows that a search brings in resolve out of characters, and an AI row's highlight carries a sweep of characters.
  */
 declare function commandPalette(panel: HTMLElement, options?: CommandPaletteOptions): CommandPaletteHandle;
 
@@ -602,15 +613,15 @@ declare function likeBurst(button: HTMLElement, options?: LikeBurstOptions): Lik
 interface BlockChartOptions extends KitOptions {
     /** The bars, left to right. */
     values?: readonly number[];
-    /** A name per bar, read by screen readers and passed to `onHover`. */
+    /** A name per bar, read by screen readers and passed to `onHover`. `set()` matches old and new bars by label, so shared bars glide into place. */
     labels?: readonly string[];
     /** The value the top of the plot stands for. Default: the largest value plus 4%. */
     max?: number;
-    /** How long each bar grows, in ms. Default 520. */
+    /** How long bars grow, glide and resize, in ms. Default 560. */
     duration?: number;
     /** Grow the bars in the first time the chart comes into view. `false` draws them in place at once, as in a view that is swapped in. Default true. */
     intro?: boolean;
-    /** Ms between bars growing. Default 45 for up to 7 bars, else 9. */
+    /** Ms between bars growing. Default 45 for up to 7 bars, else 12. */
     stagger?: number;
     /** Formats values for the screen reader table. Default `toLocaleString()`. */
     format?: (value: number) => string;
@@ -618,31 +629,31 @@ interface BlockChartOptions extends KitOptions {
     onHover?: (index: number | null, value: number | null, label: string | null) => void;
 }
 interface BlockChartHandle extends KitHandle<BlockChartOptions> {
-    /** New values (and labels); the bars grow again. */
+    /** New values (and labels); bars with a matching label glide and resize, new ones grow in, dropped ones sink away. */
     set(values: readonly number[], labels?: readonly string[]): void;
-    /** Lights one bar and dims the rest, or `null` for the resting emphasis on the last bar. */
+    /** Lights one bar and fades the rest, or `null` for the resting emphasis on the last bar. */
     highlight(index: number | null): void;
     readonly active: number | null;
     readonly values: readonly number[];
 }
-/** A bar chart drawn in columns of characters: bars grow in staggered, the last is emphasised, and hover lights one and dims the rest. */
+/** A bar chart drawn in columns of characters on a whole-cell grid: bars grow in staggered, the last is lit, hover lights one and fades the rest. */
 declare function blockChart(element: HTMLElement, options?: BlockChartOptions): BlockChartHandle;
 
 interface PageDissolveOptions extends KitOptions {
-    /** Where the dissolve starts: an element (such as the tab that was clicked) or a point in the container's CSS pixels. Default: top centre. */
+    /** Where the wave starts: an element (such as the tab that was clicked) or a point in the container's CSS pixels. Default: top centre. */
     origin?: HTMLElement | {
         x: number;
         y: number;
     } | null;
-    /** Ms the old view takes to break up. Default 140. */
+    /** Ms the old view takes to break up from the origin outward. Default 300. */
     dissolve?: number;
-    /** Ms the new view takes to condense. Default 160. */
+    /** Ms the new view takes to condense in behind it, from the same origin. Default 300. */
     condense?: number;
 }
 interface PageDissolveHandle extends KitHandle<PageDissolveOptions> {
     /**
-     * The view breaks into its own characters from `origin`, `render` swaps the content underneath, and the new view condenses
-     * out of characters. Swaps queue; each promise resolves once its view is crisp again.
+     * The crisp view hands over to its own characters, a wave from `origin` breaks it up, `render` swaps the content underneath and the
+     * new view condenses in behind the same wave, then hands back to crisp HTML. Swaps queue; each promise resolves once its view is crisp.
      */
     swap(render: () => void | Promise<void>, origin?: HTMLElement | {
         x: number;
@@ -650,7 +661,7 @@ interface PageDissolveHandle extends KitHandle<PageDissolveOptions> {
     } | null): Promise<void>;
     readonly busy: boolean;
 }
-/** A page or panel transition: the view dissolves into characters from where the user clicked and the next view condenses in. */
+/** A page or panel transition: one wave of characters from where the user clicked carries the old view out and the next one in. */
 declare function pageDissolve(container: HTMLElement, options?: PageDissolveOptions): PageDissolveHandle;
 
 interface SwipeDeckOptions extends KitOptions {
@@ -727,13 +738,15 @@ interface ToastStackOptions extends KitOptions {
     render?: (toast: Toast, id: number) => HTMLElement;
     /** Accessible name of the list. Default `Notifications`. */
     label?: string;
-    /** At rest a comet of characters runs round the newest toast's edge every few seconds, outside its text. Default true. */
+    /** @deprecated Ignored: toasts no longer draw anything round their edge at rest. */
     glint?: boolean;
+    /** Drag a toast sideways to dismiss it; it breaks into characters that carry on the way it was thrown. Default true. */
+    swipe?: boolean;
 }
 interface ToastStackHandle extends KitHandle<ToastStackOptions> {
     /** Adds a toast at the front, gathering out of scattered characters. Returns its id. */
     push(toast: Toast): number;
-    /** Takes a toast out: it breaks into characters that drift up and away while the stack closes up. */
+    /** Takes a toast out: it breaks into characters that drift away while the stack closes up behind it. */
     dismiss(id: number): void;
     /** Dismisses every toast. */
     clear(): void;
@@ -864,7 +877,7 @@ interface AccordionOptions extends KitOptions {
     images: (string | AccordionImage)[];
     /** The panel open at first. Default 0. */
     open?: number;
-    /** Ms a panel takes to open. Default 280. */
+    /** Ms a panel takes to settle open; the panels move on one critically damped spring, so a change mid-move carries its speed. Default 420. */
     duration?: number;
     /** Accessible name of the group. Default `Images`. */
     label?: string;
@@ -877,7 +890,8 @@ interface AccordionHandle extends KitHandle<AccordionOptions> {
 }
 /**
  * A strip of image panels: the open one shows its photo, the closed ones the same photos in characters. Pointing at,
- * pressing or focusing a panel opens it, and as it opens its characters flare denser for a beat, then give way to the photo.
+ * pressing or focusing a panel opens it. Width, photo and caption all follow one spring per panel, so the characters and the photo
+ * cross over without a gap and a change of mind mid-move carries on smoothly.
  */
 declare function accordion(element: HTMLElement, options: AccordionOptions): AccordionHandle;
 
@@ -895,7 +909,7 @@ interface DropzoneOptions extends KitOptions {
     onError?: (message: string, file: File) => void;
     /** Largest file accepted, in bytes. Default 10 MB. */
     maxBytes?: number;
-    /** Ms the image takes to develop in characters. Default 720. */
+    /** Ms the image takes to develop in characters. Default 900. */
     develop?: number;
     /** File name for `download()`. Default `<name>-ascii.png`. */
     filename?: string;
@@ -914,8 +928,8 @@ interface DropzoneHandle extends KitHandle<DropzoneOptions> {
     readonly state: DropState;
 }
 /**
- * An image dropzone whose border is a quiet ring of characters that thickens and breathes while a file is dragged over.
- * A dropped image develops in characters, in its own colours. Any element inside with `data-dropzone="pick"`, `"clear"`
+ * An image dropzone whose border is a quiet ring of characters that comes alive while a file is dragged over.
+ * A dropped image opens out from the drop point in characters, in its own colours. Any element inside with `data-dropzone="pick"`, `"clear"`
  * or `"download"` is wired to that action. Without content of your own it adds a title, hint and Choose file button.
  */
 declare function dropzone(element: HTMLElement, options?: DropzoneOptions): DropzoneHandle;
@@ -942,7 +956,7 @@ interface PullRefreshOptions extends KitOptions {
     onRefresh: () => unknown;
     /** The element that moves down with the pull. Default the first child. */
     content?: HTMLElement | null;
-    /** Pull distance in px that triggers a refresh on release. Default 88. */
+    /** Pull distance in px that triggers a refresh on release. Default 64. */
     threshold?: number;
     /** What a screen reader hears. */
     messages?: {
@@ -961,13 +975,15 @@ interface PullRefreshHandle extends KitHandle<PullRefreshOptions> {
     readonly state: PullState;
 }
 /**
- * Pull to refresh: dragging the content down at the top gathers an orb of characters in the gap, which tightens into a
- * ring at the threshold. Let go past it and the ring spins while `onRefresh` runs, then draws a check and springs back.
+ * Pull to refresh: dragging the content down at the top draws a small ring of characters round in the gap, closing it at the
+ * threshold with a small pop. Let go past it and the ring opens into a spinning arc while `onRefresh` runs, then draws a check and springs back.
  */
 declare function pullRefresh(element: HTMLElement, options: PullRefreshOptions): PullRefreshHandle;
 
 /** `true` follows the pointer with the preset's own response; the GPU presets also take a named hover. */
 type BackgroundCursor = boolean | 'trail' | 'fluid' | 'lantern';
+/** What the GPU presets draw in each cell: characters, or halftone dots sized by the tone. */
+type BackgroundMark = 'glyph' | 'dot';
 /** A named ramp from the engine's character sets, `'dots'`, or your own characters from empty to dense. */
 type BackgroundCharset = keyof typeof CHARACTER_SETS | 'dots' | (string & {});
 interface BackgroundOptions extends KitOptions {
@@ -988,8 +1004,13 @@ interface BackgroundOptions extends KitOptions {
     cellSize?: number;
     /** Characters from empty to dense, or a named set (`blocks`, `braille`, `dots`, ...). Default: the preset's own. */
     charset?: BackgroundCharset;
-    /** Pointer response. Default: on for the presets that answer the cursor. */
+    /**
+     * Pointer response. `false` turns it off: the background never reacts to the pointer. `true` keeps the preset's own response;
+     * the GPU presets also take a named hover. Default: on for the presets that answer the cursor.
+     */
     cursor?: BackgroundCursor;
+    /** GPU presets: characters (`'glyph'`) or halftone dots (`'dot'`). Default: the preset's own; a `charset` asks for characters. */
+    mark?: BackgroundMark;
     /** An element to keep clear: the field fades out around it so text over it stays readable. */
     clear?: HTMLElement | false;
     /** Canvas opacity, 0–1. Default 1 (`fluid` 0.7). */
@@ -1005,6 +1026,7 @@ interface BackgroundSettings {
     cellSize: number;
     charset: string | undefined;
     cursor: BackgroundCursor;
+    mark: BackgroundMark | undefined;
     clear: HTMLElement | false;
     dither: number;
     accent: string | undefined;
@@ -1060,15 +1082,18 @@ interface BackgroundHandle extends KitHandle<BackgroundOptions> {
 declare function backgroundCharset(charset: string | undefined): string | undefined;
 /**
  * An animated ASCII background under an element's content: any of the /backgrounds presets, drawn the same way as on the site.
- * Canvas templates draw with a 2D canvas; `drift`, `halftone`, `wordField` and `fluid` drive the GPU glyph field.
+ * The curated presets drive the GPU glyph field, so they follow `setGlobalLook`; the deprecated canvas templates draw with a 2D canvas.
  */
 declare function background(element: HTMLElement, options: BackgroundOptions): BackgroundHandle;
 
-/** Characters that drift slowly and stay clear around your content, drawn on the GPU. */
-declare const drift: BackgroundPreset;
+/**
+ * A fine dot grid that swells in slow rolling waves, quiet in the middle; dots rise under the pointer. `cellSize` is the dot
+ * spacing. `mark: 'glyph'` or a `charset` writes the waves in characters, and the page's global look does the same.
+ */
+declare const swell: BackgroundPreset;
 
-/** The drifting ground drawn as dots, clear around your content. `cellSize` is the dot spacing. */
-declare const halftone: BackgroundPreset;
+/** Characters that drift slowly in broad lobes and stay clear around your content. `mark: 'dot'` draws them as a halftone. */
+declare const drift: BackgroundPreset;
 
 /** A word becomes the background, drawn by the GPU with a soft wake. Set it with `text`; `look: { scene: 'orb' }` for the orb. */
 declare const wordField: BackgroundPreset;
@@ -1076,70 +1101,151 @@ declare const wordField: BackgroundPreset;
 /** Flowing folds with a soft wake behind the cursor: the original Asciify hero, driven through the GPU field. */
 declare const fluid: BackgroundPreset;
 
-/** Soft bands of light drift across the page and ripple under the cursor. */
+/** Light focused by moving water: fine bright lines that fold, part and meet again across the page. */
+declare const caustics: BackgroundPreset;
+
+/** Survey lines over a slowly shifting terrain, one character wide at any size, every fifth an index line. */
+declare const contour: BackgroundPreset;
+
+/** Three curtains of light fold slowly across the top of the page, sharp along their hems and soft above them. */
 declare const aurora: BackgroundPreset;
 
-/** Fine pools of light that drift like water across stone. */
-declare const caustics: BackgroundPreset;
+/** Still water: drops land here and there and ring outward; the pointer drops its own as it moves. */
+declare const ripple: BackgroundPreset;
 
-/** Circuit traces with signals running along them. */
-declare const circuit: BackgroundPreset;
+/** A corona breathes slowly round the middle of the page, its rays turning; the centre stays empty for a headline. */
+declare const halo: BackgroundPreset;
 
-/** Fine topographic lines with a slow, rolling drift. */
-declare const contour: BackgroundPreset;
+/** Two fine ring grids from slowly orbiting centres; where they cross, broad moiré bands open and close. */
+declare const interference: BackgroundPreset;
 
-/** Double helices scroll past with base-pair letters. */
+/** Four soft lights on slow paths: a gradient mesh written in characters, the whole ramp from empty to dense. */
+declare const mesh: BackgroundPreset;
+
+/** Streaks fall in three depths: far ones fine, faint and slow, near ones rare, bright and quick. */
+declare const cascade: BackgroundPreset;
+
+/** Points wander in their own cells, and neighbours close enough are linked by fine lines that come and go. */
+declare const constellation: BackgroundPreset;
+
+/**
+ * The drifting ground drawn as dots, clear around your content. `cellSize` is the dot spacing.
+ * @deprecated The same field as `drift`: use `drift` with `mark: 'dot'` (and `cellSize: 14` for this spacing).
+ */
+declare const halftone: BackgroundPreset;
+
+/**
+ * Circuit traces with signals running along them.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `constellation` is the closest current preset.
+ */
+declare const circuit: BackgroundPreset;
+
+/**
+ * Double helices scroll past with base-pair letters.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `halo` is the closest current preset.
+ */
 declare const dna: BackgroundPreset;
 
-/** Layered sand ridges with slow-moving light and fine grain. */
+/**
+ * Layered sand ridges with slow-moving light and fine grain.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `contour` is the closest current preset.
+ */
 declare const dune: BackgroundPreset;
 
-/** Cut-grain lines follow a slow, sculpted current. */
+/**
+ * Cut-grain lines follow a slow, sculpted current.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `contour` is the closest current preset.
+ */
 declare const etch: BackgroundPreset;
 
-/** Quiet folded planes catch light along their edges. */
+/**
+ * Quiet folded planes catch light along their edges.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `caustics` is the closest current preset.
+ */
 declare const facet: BackgroundPreset;
 
-/** A cellular flame rising from the bottom edge. */
+/**
+ * A cellular flame rising from the bottom edge.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `aurora` is the closest current preset.
+ */
 declare const fire: BackgroundPreset;
 
-/** Scan bands roll down a character grid and glitch near the cursor. */
+/**
+ * Scan bands roll down a character grid and glitch near the cursor.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `interference` is the closest current preset.
+ */
 declare const grid: BackgroundPreset;
 
-/** Two fine line fields overlap into broad, shifting bands. */
+/**
+ * Two fine line fields overlap into broad, shifting bands.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `interference` is the closest current preset.
+ */
 declare const moire: BackgroundPreset;
 
-/** Every cell shimmers at its own frequencies. */
+/**
+ * Every cell shimmers at its own frequencies.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `mesh` is the closest current preset.
+ */
 declare const morph: BackgroundPreset;
 
-/** A slow fractal noise field that warps around the cursor. */
+/**
+ * A slow fractal noise field that warps around the cursor.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `mesh` is the closest current preset.
+ */
 declare const noise: BackgroundPreset;
 
-/** Rings of characters ripple out from the cursor. */
+/**
+ * Rings of characters ripple out from the cursor.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `ripple` is the closest current preset.
+ */
 declare const pulse: BackgroundPreset;
 
-/** Columns of falling characters with bright heads. */
+/**
+ * Columns of falling characters with bright heads.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `cascade` is the closest current preset.
+ */
 declare const rain: BackgroundPreset;
 
-/** Long ribbons that follow a slow flow field. */
+/**
+ * Long ribbons that follow a slow flow field.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `aurora` is the closest current preset.
+ */
 declare const silk: BackgroundPreset;
 
-/** A sparse starfield that twinkles, drifts and leans toward the cursor. */
+/**
+ * A sparse starfield that twinkles, drifts and leans toward the cursor.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `constellation` is the closest current preset.
+ */
 declare const stars: BackgroundPreset;
 
-/** A side-scrolling landscape drawn in density characters. */
+/**
+ * A side-scrolling landscape drawn in density characters.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `contour` is the closest current preset.
+ */
 declare const terrain: BackgroundPreset;
 
-/** Tall folds of light drifting across a quiet ground. */
+/**
+ * Tall folds of light drifting across a quiet ground.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `aurora` is the closest current preset.
+ */
 declare const veil: BackgroundPreset;
 
-/** A gravity well that spirals characters around the cursor. */
+/**
+ * A gravity well that spirals characters around the cursor.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `halo` is the closest current preset.
+ */
 declare const voidWell: BackgroundPreset;
 
-/** An interference field with a soft vortex at the cursor and a slow breath. */
+/**
+ * An interference field with a soft vortex at the cursor and a slow breath.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `swell` is the closest current preset.
+ */
 declare const wave: BackgroundPreset;
 
-/** Interlaced threads with a subtle change in tension. */
+/**
+ * Interlaced threads with a subtle change in tension.
+ * @deprecated Retired from the curated set; kept so existing code still runs. `interference` is the closest current preset.
+ */
 declare const weave: BackgroundPreset;
 
 /** What a canvas template is drawn with each frame. */
@@ -1166,10 +1272,102 @@ type TemplateDraw = (ctx: CanvasRenderingContext2D, width: number, height: numbe
  */
 declare function mountCanvas(context: BackgroundContext, draw: TemplateDraw, warmFrames?: number): BackgroundRun | null;
 
+/**
+ * The Studio's 24 render styles as the glyph field draws them: the glyph-like styles are ramps, the halftone is the dot mark,
+ * and the tile and print styles are field marks of the same name.
+ */
+declare const KIT_STYLES: {
+    readonly ascii: {
+        readonly mark: "glyph";
+        readonly charset: " .:-=+*#%@";
+    };
+    readonly blocks: {
+        readonly mark: "glyph";
+        readonly charset: " ░▒▓█";
+    };
+    readonly braille: {
+        readonly mark: "glyph";
+        readonly charset: " ⠁⠃⠇⡇⣇⣧⣷⣿";
+    };
+    readonly dots: {
+        readonly mark: "dot";
+    };
+    readonly lines: {
+        readonly mark: "glyph";
+        readonly charset: " -═╪╬";
+    };
+    readonly cross: {
+        readonly mark: "glyph";
+        readonly charset: " ·+xX#";
+    };
+    readonly diagonal: {
+        readonly mark: "glyph";
+        readonly charset: " /╱╳";
+    };
+    readonly diamond: {
+        readonly mark: "glyph";
+        readonly charset: " ·◇◈◆";
+    };
+    readonly mixed: {
+        readonly mark: "glyph";
+        readonly charset: " .:+/◇#@";
+    };
+    readonly pixel: {
+        readonly mark: "pixel";
+    };
+    readonly mosaic: {
+        readonly mark: "mosaic";
+    };
+    readonly lego: {
+        readonly mark: "lego";
+    };
+    readonly voxel: {
+        readonly mark: "voxel";
+    };
+    readonly disco: {
+        readonly mark: "disco";
+    };
+    readonly dither: {
+        readonly mark: "dither";
+    };
+    readonly hex: {
+        readonly mark: "hex";
+    };
+    readonly led: {
+        readonly mark: "led";
+    };
+    readonly cmyk: {
+        readonly mark: "cmyk";
+    };
+    readonly stipple: {
+        readonly mark: "stipple";
+    };
+    readonly engraving: {
+        readonly mark: "engraving";
+    };
+    readonly crosshatch: {
+        readonly mark: "crosshatch";
+    };
+    readonly woodblock: {
+        readonly mark: "woodblock";
+    };
+    readonly risograph: {
+        readonly mark: "risograph";
+    };
+    readonly pointillism: {
+        readonly mark: "pointillism";
+    };
+};
+type KitStyle = keyof typeof KIT_STYLES;
 /** The page-wide look `setGlobalLook` lays over every glyph field. */
 interface GlobalLook {
     /** Characters for every glyph field that keeps none of letters of its own. Empty keeps each field's own. */
     charset?: string;
+    /**
+     * One of the Studio's render styles (`KIT_STYLES`): what every such field draws in each cell. A glyph-like style brings its
+     * ramp, which `charset` overrides; a tile or print style changes the mark and keeps each field's own charset for its blanks.
+     */
+    style?: KitStyle;
 }
 /** Re-skins every glyph field on the page at once; `null` gives each field its own characters back. */
 declare function setGlobalLook(next: GlobalLook | null): void;
@@ -1183,4 +1381,4 @@ declare function subscribeGlobalLook(listener: (look: GlobalLook | null) => void
 declare function setFieldBudget(n: number): void;
 declare const getFieldBudget: () => number;
 
-export { type AccordionHandle, type AccordionImage, type AccordionOptions, type ArtPanelHandle, type ArtPanelOptions, type AsciiVideoHandle, type AsciiVideoOptions, BEAM_PALETTES, type BackgroundCharset, type BackgroundContext, type BackgroundCursor, type BackgroundHandle, type BackgroundOptions, type BackgroundPreset, type BackgroundRun, type BackgroundSettings, type BeamHandle, type BeamMode, type BeamOptions, type BeamPalette, type BlockChartHandle, type BlockChartOptions, type Box, type ButtonLoadingHandle, type ButtonLoadingOptions, type ButtonState, type CodeInputHandle, type CodeInputOptions, type CodeState, type CommandPaletteHandle, type CommandPaletteOptions, type CompareHandle, type CompareOptions, type DecodeHandle, type DecodeOptions, type DisintegrateOptions, type DropState, type DroppedImage, type DropzoneHandle, type DropzoneOptions, type FieldBackgroundHandle, type FieldBackgroundOptions, type FieldPreset, type GenerateState, type GlobalLook, type ImageGenerateHandle, type ImageGenerateOptions, type ImageStream, type ImageUpdate, type KitHandle, type KitOptions, type LikeBurstHandle, type LikeBurstOptions, type LikeMark, type OdometerHandle, type OdometerOptions, type OrbState, PILL_TONES, type PageDissolveHandle, type PageDissolveOptions, type PaintFrame, type PillHandle, type PillOptions, type PillTone, type PricingGlowHandle, type PricingGlowOptions, type PullRefreshHandle, type PullRefreshOptions, type PullState, type SkeletonBlock, type SkeletonHandle, type SkeletonOptions, type SlideToConfirmHandle, type SlideToConfirmOptions, type StatusOrbHandle, type StatusOrbOptions, type StreamState, type StreamTextHandle, type StreamTextOptions, type Surface, type SurfaceConfig, type SwipeDeckHandle, type SwipeDeckOptions, type TabsHandle, type TabsOptions, type TemplateDraw, type TemplateFrame, type ThinkingHandle, type ThinkingOptions, type ThinkingState, type Toast, type ToastStackHandle, type ToastStackOptions, VOICE_PALETTES, type VoiceOrbHandle, type VoiceOrbOptions, type VoicePalette, type VoiceState, type WordmarkHandle, type WordmarkOptions, accordion, artPanel, asciiVideo, aurora, background, backgroundCharset, beam, beamPalette, blockChart, buttonLoading, caustics, circuit, codeInput, commandPalette, compare, contour, decode, disintegrate, dna, drift, dropzone, dune, etch, facet, fieldBackground, fire, fluid, getFieldBudget, getGlobalLook, grid, halftone, imageGenerate, likeBurst, moire, morph, mountCanvas, mountSurface, noise, odometer, pageDissolve, pill, pricingGlow, pullRefresh, pulse, rain, resolveColor, setFieldBudget, setGlobalLook, silk, skeleton, slideToConfirm, stars, statusOrb, streamText, subscribeGlobalLook, swipeDeck, tabs, terrain, thinking, toastStack, veil, voiceOrb, voidWell, wave, weave, wordField, wordmark };
+export { type AccordionHandle, type AccordionImage, type AccordionOptions, type ArtPanelHandle, type ArtPanelOptions, type AsciiVideoHandle, type AsciiVideoOptions, BEAM_PALETTES, type BackgroundCharset, type BackgroundContext, type BackgroundCursor, type BackgroundHandle, type BackgroundMark, type BackgroundOptions, type BackgroundPreset, type BackgroundRun, type BackgroundSettings, type BeamHandle, type BeamMode, type BeamOptions, type BeamPalette, type BlockChartHandle, type BlockChartOptions, type Box, type ButtonLoadingHandle, type ButtonLoadingOptions, type ButtonState, type CodeInputHandle, type CodeInputOptions, type CodeState, type CommandPaletteHandle, type CommandPaletteOptions, type CompareHandle, type CompareOptions, type DecodeHandle, type DecodeOptions, type DisintegrateOptions, type DropState, type DroppedImage, type DropzoneHandle, type DropzoneOptions, type FieldBackgroundHandle, type FieldBackgroundOptions, type FieldPreset, type GenerateState, type GlobalLook, type ImageGenerateHandle, type ImageGenerateOptions, type ImageStream, type ImageUpdate, KIT_STYLES, type KitHandle, type KitOptions, type KitStyle, type LikeBurstHandle, type LikeBurstOptions, type LikeMark, type OdometerHandle, type OdometerOptions, type OrbState, PILL_TONES, type PageDissolveHandle, type PageDissolveOptions, type PaintFrame, type PillHandle, type PillOptions, type PillTone, type PricingGlowHandle, type PricingGlowOptions, type PullRefreshHandle, type PullRefreshOptions, type PullState, type SkeletonBlock, type SkeletonHandle, type SkeletonOptions, type SlideToConfirmHandle, type SlideToConfirmOptions, type StatusOrbHandle, type StatusOrbOptions, type StreamState, type StreamTextHandle, type StreamTextOptions, type Surface, type SurfaceConfig, type SwipeDeckHandle, type SwipeDeckOptions, type TabsHandle, type TabsOptions, type TemplateDraw, type TemplateFrame, type ThinkingHandle, type ThinkingOptions, type ThinkingState, type Toast, type ToastStackHandle, type ToastStackOptions, VOICE_PALETTES, type VoiceOrbHandle, type VoiceOrbOptions, type VoicePalette, type VoiceState, type WordmarkHandle, type WordmarkOptions, accordion, artPanel, asciiVideo, aurora, background, backgroundCharset, beam, beamPalette, blockChart, buttonLoading, cascade, caustics, circuit, codeInput, commandPalette, compare, constellation, contour, decode, disintegrate, dna, drift, dropzone, dune, etch, facet, fieldBackground, fire, fluid, getFieldBudget, getGlobalLook, grid, halftone, halo, imageGenerate, interference, likeBurst, mesh, moire, morph, mountCanvas, mountSurface, noise, odometer, pageDissolve, pill, pricingGlow, pullRefresh, pulse, rain, resolveColor, ripple, setFieldBudget, setGlobalLook, silk, skeleton, slideToConfirm, stars, statusOrb, streamText, subscribeGlobalLook, swell, swipeDeck, tabs, terrain, thinking, toastStack, veil, voiceOrb, voidWell, wave, weave, wordField, wordmark };