asciify-engine 4.0.0 → 4.1.0

package/skills/asciify-engine/SKILL.md

@@ -2,13 +2,13 @@
 name: asciify-engine
 description: Build and tune browser ASCII images, video, GIFs, text, and interactive heroes with asciify-engine. Use for media conversion, character and color choices, hover integration, layered HTML typography, scroll-synced video, and rendering performance in apps using this package.
 metadata:
-  tested-engine: "4.0.0"
+  tested-engine: "4.1.0"
   updated: "2026-09-09"
 ---
 
 # Asciify Engine
 
-Use the published `asciify-engine` npm package for browser canvas rendering. Tested against **4.0.0**. Check the application's installed version and its public types before using newer options; a local checkout can contain unpublished changes.
+Use the published `asciify-engine` npm package for browser canvas rendering. Tested against **4.1.0**. Check the application's installed version and its public types before using newer options; a local checkout can contain unpublished changes.
 
 - Agent entry: https://asciify.org/skill (redirects to this Markdown document).
 - Playground: https://asciify.org/editor
@@ -83,7 +83,7 @@ const letters = [...new Set('ASCIIFY'.toUpperCase().replace(/[^A-Z]/g, ''))].joi
 const charset = ` .:-=+${letters}#%@`;
 ```
 
-Preview it: letter glyph densities differ, so arbitrary words are not automatically an evenly ordered ramp. Keep the leading space and the light/dense symbols. Use `CHARSETS.standard`, `dense`, `blocks`, or `braille` when they better suit the subject.
+Preview it: letter glyph densities differ, so arbitrary words are not automatically an evenly ordered ramp. Keep the leading space and the light/dense symbols. Use the curated `CHARACTER_SETS.standard.chars`, `detailed.chars`, `blocks.chars`, or `braille.chars` from `/core` when appropriate.
 
 ## Engine effects versus studio effects
 
@@ -136,6 +136,6 @@ Version 1.3.0 adds text-shaped charcoal cutouts (`textMask`), peripheral scanlin
 
 For optional wallpaper/backdrops, alternate renderers, palettes, masks, saved looks, text fonts, or deterministic MP4/GIF export, read [references/studio-workspace.md](references/studio-workspace.md). The new `/studio` API is separate from `/hover` and `AsciiOptions`; do not replace an existing hero pipeline just to add a backdrop. Use version 1.4.0 or newer for these APIs after verifying the installed package.
 
-## Standard catalogs in 2.0
+## Current catalogs (4.1)
 
-`CHARSETS` and `ART_STYLE_PRESETS` no longer include `emoji`, `musical` or `starfield`. Do not recommend or generate those names. For character selection in a Studio integration, use `STUDIO_CHARACTER_SETS` from `asciify-engine/studio` and assign an entry's `chars` to `settings.charset`. These ramps apply to the `ascii` style; other styles define their own marks. Custom Unicode strings remain supported. Read the upgrade reference when migrating 1.x preset names. The site now opens its primary workspace at `/editor`; `/editor/classic` preserves earlier workflows. Keep the engine imports modular: new editor defaults do not require importing Studio into an existing hero.
+Legacy `CHARSETS`, `ART_STYLE_PRESETS`, `CHARSET_SEQUENCES`, `LIVING_STYLE_PRESETS` and their key types are removed. Do not import them or generate old names such as Katakana, Binary, Waves or Smoke. Use the 15 `STUDIO_STYLES` for render-style selectors and `/studio` rendering. For ASCII-only character ramps use `CHARACTER_SETS` from `/core` or `STUDIO_CHARACTER_SETS` from `/studio`; custom Unicode and user-provided frame arrays remain supported. Core `artStyle` only accepts `classic`; use explicit options instead of preset shortcuts. Despite the requested 4.1.0 version number, migrating these removed APIs is a breaking change.

package/skills/asciify-engine/references/hero-finish.md

@@ -105,7 +105,7 @@ Do not promise a 120 FPS minimum on every mobile device or arbitrary character c
 
 ### Hero character catalog
 
-Hero → Customize → Character set exposes every preset from the published engine `CHARSETS` catalog, plus the Asciify brand set. Selecting a set clears a custom-letter override; Apply letters modifies only the selected set, and Reset set restores it. Selection works while paused or with reduced motion. The hero remains gray; these are character ramps, not the playground’s Halftone/Dither rendering modes. Prism at 95% with 35% edge softness is the default hero finish: red/cyan separation with short soft shoulders at the perimeter, a clear center, and no blur on HTML text or controls. The same Prism shader is used by the playground and optional engine hover surface.
+Hero → Customize → Characters uses the same 15 render-style tiles as the editor, with six primary styles and nine under More render styles. Custom letters are available under ASCII. Alternate styles use the published Studio renderer and share the hero's video; they are not aliases for old alphabets. Default ASCII retains its GPU hover and Prism finish. Selecting styles works while paused or with reduced motion.
 
 The default Trail radius is now `0.45` in the hero, playground preset and optional engine mount. This widens the nominal fluid impulse by about 51% versus `0.2`, while preserving the same strength, bounded flow field. Pass `radius: 0.2` explicitly for the previous narrower reach. Other hover presets keep their existing sizes.
 

package/skills/asciify-engine/references/upgrading.md

@@ -30,7 +30,7 @@ After updating, read the installed SKILL.md and its linked references, confirm i
 
 ## 2.0 catalog migration
 
-2.0.0 removes the `emoji`, `musical`, and `starfield` keys from `CHARSETS`, `ArtStyle`, and `ART_STYLE_PRESETS`. Before upgrading, search application settings and saved presets for those names. Use `classic` plus a custom `charset` to retain an application-owned alphabet, or use `circles`, `braille`, or `geometric` for structural alternatives. The existing cosmic sequence now uses sparse marks/circles/shadows, and angular uses geometry/shards/blocks. Other core options and renderers retain their behavior. Do not pass retired keys or tell users that custom Unicode has been removed.
+2.0.0 removes the `emoji`, `musical`, and `starfield` keys from `CHARSETS`, `ArtStyle`, and `ART_STYLE_PRESETS`. Before upgrading, search application settings and saved presets for those names. For current releases, use a custom `charset` or a current StudioStyle. The existing cosmic sequence now uses sparse marks/circles/shadows, and angular uses geometry/shards/blocks. Other core options and renderers retain their behavior. Do not pass retired keys or tell users that custom Unicode has been removed.
 
 The curated `STUDIO_CHARACTER_SETS` export is available from `/studio` in 2.0.0. Its values contain `label` and `chars`; assign `chars` to Studio settings only for `style: 'ascii'`. The primary editor at `/editor` uses Studio; earlier webcam and classic-editor workflows remain at `/editor/classic`.
 
@@ -48,4 +48,9 @@ Use one motion owner: `animationStyle` for core, `motion` for `/hover`, or `moti
 
 Remove imports from `asciify-engine/backgrounds` and generator imports from the root package. Download the chosen `.js` template from https://asciify.org/backgrounds and change the import to `./wave.js` (or your selected file). The template exports `asciiBackground`; keep calling `destroy()` on unmount. It handles resizing, hidden/offscreen suspension, reduced motion, and cleanup. A selected template contains only that generator; backgrounds.js is the optional full collection. Application-owned source templates are separate from npm updates. Existing installations can stay on 3.x while migrating. Text and media rendering remain supported, including text backgrounds.
 
-Use `CHARACTER_SETS` from root or `/core` for the same eight choices as the editor's `STUDIO_CHARACTER_SETS`. This data-only import does not load Studio. Keep custom characters available separately; do not populate standard UI choices from the larger legacy `CHARSETS` object.
+Use `CHARACTER_SETS` from root or `/core` for the same eight choices as the editor's `STUDIO_CHARACTER_SETS`. This data-only import does not load Studio. Keep custom characters available separately; do not import the removed `CHARSETS` object.
+
+
+## 4.1.0 — remove legacy catalogs
+
+This requested minor version contains breaking API removals: `CHARSETS`, `ART_STYLE_PRESETS`, `CHARSET_SEQUENCES`, `LIVING_STYLE_PRESETS`, `CharsetKey`, `CharsetSequenceKey`, and `LivingStylePresetKey`. Search source, saved settings, generated snippets, and documentation before upgrading. Use `/studio`'s 15 `STUDIO_STYLES` for render styles; use `/core`'s curated `CHARACTER_SETS` for ASCII alphabets. Replace old shorthand `artStyle` names with actual Studio rendering or explicit core charset/renderMode/colorMode options. Core only accepts `artStyle: 'classic'`. Custom `charset` and `charsetFrames` remain supported. Fine-dither hover integration uses explicit `fineDither: true`, not the removed terminal preset.

package/dist/characters-BNTu2oEF.d.cts

@@ -1,71 +0,0 @@
-/** Curated ASCII ramps. Use custom text to supply a different alphabet. */
-declare const CHARACTER_SETS: {
-    readonly standard: {
-        readonly label: "Classic ASCII";
-        readonly chars: " .:-=+*#%@";
-    };
-    readonly asciify: {
-        readonly label: "Asciify";
-        readonly chars: " .:-=+ASCIIFY#@";
-    };
-    readonly minimal: {
-        readonly label: "Minimal";
-        readonly chars: " .:+";
-    };
-    readonly detailed: {
-        readonly label: "Detailed";
-        readonly chars: " .,:;i1tfLCG08@";
-    };
-    readonly letters: {
-        readonly label: "Letters";
-        readonly chars: " .ilLCFTYASMW";
-    };
-    readonly technical: {
-        readonly label: "Technical";
-        readonly chars: " .:;>_/[{}]=+*#@$";
-    };
-    readonly blocks: {
-        readonly label: "Tonal blocks";
-        readonly chars: " ░▒▓█";
-    };
-    readonly braille: {
-        readonly label: "Braille";
-        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
-    };
-};
-declare const STUDIO_CHARACTER_SETS: {
-    readonly standard: {
-        readonly label: "Classic ASCII";
-        readonly chars: " .:-=+*#%@";
-    };
-    readonly asciify: {
-        readonly label: "Asciify";
-        readonly chars: " .:-=+ASCIIFY#@";
-    };
-    readonly minimal: {
-        readonly label: "Minimal";
-        readonly chars: " .:+";
-    };
-    readonly detailed: {
-        readonly label: "Detailed";
-        readonly chars: " .,:;i1tfLCG08@";
-    };
-    readonly letters: {
-        readonly label: "Letters";
-        readonly chars: " .ilLCFTYASMW";
-    };
-    readonly technical: {
-        readonly label: "Technical";
-        readonly chars: " .:;>_/[{}]=+*#@$";
-    };
-    readonly blocks: {
-        readonly label: "Tonal blocks";
-        readonly chars: " ░▒▓█";
-    };
-    readonly braille: {
-        readonly label: "Braille";
-        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
-    };
-};
-
-export { CHARACTER_SETS as C, STUDIO_CHARACTER_SETS as S };

package/dist/characters-BNTu2oEF.d.ts

@@ -1,71 +0,0 @@
-/** Curated ASCII ramps. Use custom text to supply a different alphabet. */
-declare const CHARACTER_SETS: {
-    readonly standard: {
-        readonly label: "Classic ASCII";
-        readonly chars: " .:-=+*#%@";
-    };
-    readonly asciify: {
-        readonly label: "Asciify";
-        readonly chars: " .:-=+ASCIIFY#@";
-    };
-    readonly minimal: {
-        readonly label: "Minimal";
-        readonly chars: " .:+";
-    };
-    readonly detailed: {
-        readonly label: "Detailed";
-        readonly chars: " .,:;i1tfLCG08@";
-    };
-    readonly letters: {
-        readonly label: "Letters";
-        readonly chars: " .ilLCFTYASMW";
-    };
-    readonly technical: {
-        readonly label: "Technical";
-        readonly chars: " .:;>_/[{}]=+*#@$";
-    };
-    readonly blocks: {
-        readonly label: "Tonal blocks";
-        readonly chars: " ░▒▓█";
-    };
-    readonly braille: {
-        readonly label: "Braille";
-        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
-    };
-};
-declare const STUDIO_CHARACTER_SETS: {
-    readonly standard: {
-        readonly label: "Classic ASCII";
-        readonly chars: " .:-=+*#%@";
-    };
-    readonly asciify: {
-        readonly label: "Asciify";
-        readonly chars: " .:-=+ASCIIFY#@";
-    };
-    readonly minimal: {
-        readonly label: "Minimal";
-        readonly chars: " .:+";
-    };
-    readonly detailed: {
-        readonly label: "Detailed";
-        readonly chars: " .,:;i1tfLCG08@";
-    };
-    readonly letters: {
-        readonly label: "Letters";
-        readonly chars: " .ilLCFTYASMW";
-    };
-    readonly technical: {
-        readonly label: "Technical";
-        readonly chars: " .:;>_/[{}]=+*#@$";
-    };
-    readonly blocks: {
-        readonly label: "Tonal blocks";
-        readonly chars: " ░▒▓█";
-    };
-    readonly braille: {
-        readonly label: "Braille";
-        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
-    };
-};
-
-export { CHARACTER_SETS as C, STUDIO_CHARACTER_SETS as S };