asciify-engine 4.18.0 → 4.20.0

package/skills/asciify-engine/references/media-api.md

@@ -98,12 +98,10 @@ For GSAP, pass your installed `gsap` and `ScrollTrigger` instances through `scro
 ## Procedural backgrounds
 
 ```js
-import { asciiBackground } from './wave.js'; // 4.0–4.13: a template downloaded from asciify.org/backgrounds
-const background = asciiBackground(host, {
-  type: 'aurora', fontSize: 14, speed: 0.8, density: 0.55,
-});
+import { background, halo } from 'asciify-engine/kit';
+const bg = background(host, { preset: halo, clear: headline, cursor: false });
 // On unmount:
-background.destroy();
+bg.destroy();
 ```
 
-From 4.0 to 4.13, procedural backgrounds were downloadable templates at asciify.org/backgrounds, outside npm, and existing imports keep working. Newer kits ship them all as `background(host, { preset })` from `asciify-engine/kit`, Fluid included; use that for new work ([kit.md](kit.md#backgrounds), [applying-asciify.md](applying-asciify.md#9-backgrounds)).
+Procedural backgrounds ship in `asciify-engine/kit` as `background(host, { preset })`, Fluid included ([kit.md](kit.md#backgrounds), [applying-asciify.md](applying-asciify.md#9-backgrounds)). From 4.0 to 4.13 they were single-file templates downloaded from asciify.org/backgrounds (`asciiBackground` from `./wave.js`); copies already in an app keep working, but the site no longer offers them.

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

@@ -46,7 +46,7 @@ Use one motion owner: `animationStyle` for core, `motion` for `/hover`, or `moti
 
 ## 4.0 background migration
 
-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. Since 4.14 the kit exports every background as `background(host, { preset })` from `asciify-engine/kit`; prefer that to a downloaded template when the installed kit has it. Text and media rendering remain supported, including text backgrounds.
+Remove imports from `asciify-engine/backgrounds` and generator imports from the root package. Use `background(host, { preset })` from `asciify-engine/kit` (4.14 and later) with the closest curated preset; [kit.md](kit.md#backgrounds) maps each retired one. The single-file templates once downloadable from asciify.org/backgrounds (`asciiBackground` from `./wave.js`) are no longer offered; copies already in an app keep working and keep calling `destroy()` on unmount. 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 import the removed `CHARSETS` object.