asciify-engine 4.18.0 → 4.19.0

package/dist/kit.d.cts

@@ -982,6 +982,8 @@ declare function pullRefresh(element: HTMLElement, options: PullRefreshOptions):
 
 /** `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 {
@@ -1002,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). */
@@ -1019,6 +1026,7 @@ interface BackgroundSettings {
     cellSize: number;
     charset: string | undefined;
     cursor: BackgroundCursor;
+    mark: BackgroundMark | undefined;
     clear: HTMLElement | false;
     dither: number;
     accent: string | undefined;
@@ -1074,89 +1082,170 @@ 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;
-
-/** The drifting ground drawn as dots, clear around your content. `cellSize` is the dot spacing. */
-declare const halftone: 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. */
+/**
+ * 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;
 
+/** 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;
 
 /** 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;
+
+/** 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;
 
-/** Double helices scroll past with base-pair letters. */
+/**
+ * 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. */
@@ -1292,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, 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, 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, swell, 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 };

package/dist/kit.d.ts

@@ -982,6 +982,8 @@ declare function pullRefresh(element: HTMLElement, options: PullRefreshOptions):
 
 /** `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 {
@@ -1002,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). */
@@ -1019,6 +1026,7 @@ interface BackgroundSettings {
     cellSize: number;
     charset: string | undefined;
     cursor: BackgroundCursor;
+    mark: BackgroundMark | undefined;
     clear: HTMLElement | false;
     dither: number;
     accent: string | undefined;
@@ -1074,89 +1082,170 @@ 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;
-
-/** The drifting ground drawn as dots, clear around your content. `cellSize` is the dot spacing. */
-declare const halftone: 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. */
+/**
+ * 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;
 
+/** 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;
 
 /** 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;
+
+/** 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;
 
-/** Double helices scroll past with base-pair letters. */
+/**
+ * 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. */
@@ -1292,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, 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, 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, swell, 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 };