@staticcanvas/typeflow 0.34.0 → 0.34.1

package/dist/{typeflow/dist/typeflow.cjs → typeflow.cjs}

@@ -1,4 +1,4 @@
-/*! typeflow v0.34.0 | https://staticcanvas.gitlab.io/typeflow | MIT */
+/*! typeflow v0.34.1 | https://staticcanvas.gitlab.io/typeflow | MIT */
 !function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).Typeflow={})}(this,function(e){"use strict";var t=Object.defineProperty,n=Object.defineProperties,r=Object.getOwnPropertyDescriptors,l=Object.getOwnPropertySymbols,o=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable,i=e=>{throw TypeError(e)},s=(e,n,r)=>n in e?t(e,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[n]=r,c=(e,t)=>{for(var n in t||(t={}))o.call(t,n)&&s(e,n,t[n]);if(l)for(var n of l(t))a.call(t,n)&&s(e,n,t[n]);return e},u=(e,t)=>n(e,r(t)),d=(e,t,n)=>s(e,"symbol"!=typeof t?t+"":t,n),p=(e,t,n)=>t.has(e)||i("Cannot "+n),f=(e,t,n)=>(p(e,t,"read from private field"),n?n.call(e):t.get(e)),m=(e,t,n)=>t.has(e)?i("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),h=(e,t,n)=>(p(e,t,"access private method"),n),y=(e,t,n)=>new Promise((r,l)=>{var o=e=>{try{i(n.next(e))}catch(e){l(e)}},a=e=>{try{i(n.throw(e))}catch(e){l(e)}},i=e=>e.done?r(e.value):Promise.resolve(e.value).then(o,a);i((n=n.apply(e,t)).next())});
 /**
    * TypeFlow - A lightweight, interruptible, framework-agnostic typewriter library

package/dist/{typeflow/dist/typeflow.esm.js → typeflow.esm.js}

@@ -1,4 +1,4 @@
-/*! typeflow v0.34.0 | https://staticcanvas.gitlab.io/typeflow | MIT */
+/*! typeflow v0.34.1 | https://staticcanvas.gitlab.io/typeflow | MIT */
 var e=Object.defineProperty,t=Object.defineProperties,n=Object.getOwnPropertyDescriptors,r=Object.getOwnPropertySymbols,l=Object.prototype.hasOwnProperty,o=Object.prototype.propertyIsEnumerable,a=e=>{throw TypeError(e)},i=(t,n,r)=>n in t?e(t,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[n]=r,s=(e,t)=>{for(var n in t||(t={}))l.call(t,n)&&i(e,n,t[n]);if(r)for(var n of r(t))o.call(t,n)&&i(e,n,t[n]);return e},c=(e,r)=>t(e,n(r)),u=(e,t,n)=>i(e,"symbol"!=typeof t?t+"":t,n),d=(e,t,n)=>t.has(e)||a("Cannot "+n),p=(e,t,n)=>(d(e,t,"read from private field"),n?n.call(e):t.get(e)),f=(e,t,n)=>t.has(e)?a("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),m=(e,t,n)=>(d(e,t,"access private method"),n),h=(e,t,n)=>new Promise((r,l)=>{var o=e=>{try{i(n.next(e))}catch(e){l(e)}},a=e=>{try{i(n.throw(e))}catch(e){l(e)}},i=e=>e.done?r(e.value):Promise.resolve(e.value).then(o,a);i((n=n.apply(e,t)).next())});
 /**
  * TypeFlow - A lightweight, interruptible, framework-agnostic typewriter library

package/dist/{typeflow/dist/typeflow.js → typeflow.js}

@@ -1,4 +1,4 @@
-/*! typeflow v0.34.0 | https://staticcanvas.gitlab.io/typeflow | MIT */
+/*! typeflow v0.34.1 | https://staticcanvas.gitlab.io/typeflow | MIT */
 !function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).Typeflow={})}(this,function(e){"use strict";var t=Object.defineProperty,n=Object.defineProperties,r=Object.getOwnPropertyDescriptors,l=Object.getOwnPropertySymbols,o=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable,i=e=>{throw TypeError(e)},s=(e,n,r)=>n in e?t(e,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[n]=r,c=(e,t)=>{for(var n in t||(t={}))o.call(t,n)&&s(e,n,t[n]);if(l)for(var n of l(t))a.call(t,n)&&s(e,n,t[n]);return e},u=(e,t)=>n(e,r(t)),d=(e,t,n)=>s(e,"symbol"!=typeof t?t+"":t,n),p=(e,t,n)=>t.has(e)||i("Cannot "+n),f=(e,t,n)=>(p(e,t,"read from private field"),n?n.call(e):t.get(e)),m=(e,t,n)=>t.has(e)?i("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),h=(e,t,n)=>(p(e,t,"access private method"),n),y=(e,t,n)=>new Promise((r,l)=>{var o=e=>{try{i(n.next(e))}catch(e){l(e)}},a=e=>{try{i(n.throw(e))}catch(e){l(e)}},i=e=>e.done?r(e.value):Promise.resolve(e.value).then(o,a);i((n=n.apply(e,t)).next())});
 /**
    * TypeFlow - A lightweight, interruptible, framework-agnostic typewriter library

package/dist/{typeflow/dist/typeflow.mjs → typeflow.mjs}

@@ -1,4 +1,4 @@
-/*! typeflow v0.34.0 | https://staticcanvas.gitlab.io/typeflow | MIT */
+/*! typeflow v0.34.1 | https://staticcanvas.gitlab.io/typeflow | MIT */
 var e=Object.defineProperty,t=Object.defineProperties,n=Object.getOwnPropertyDescriptors,r=Object.getOwnPropertySymbols,l=Object.prototype.hasOwnProperty,o=Object.prototype.propertyIsEnumerable,a=e=>{throw TypeError(e)},i=(t,n,r)=>n in t?e(t,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[n]=r,s=(e,t)=>{for(var n in t||(t={}))l.call(t,n)&&i(e,n,t[n]);if(r)for(var n of r(t))o.call(t,n)&&i(e,n,t[n]);return e},c=(e,r)=>t(e,n(r)),u=(e,t,n)=>i(e,"symbol"!=typeof t?t+"":t,n),d=(e,t,n)=>t.has(e)||a("Cannot "+n),p=(e,t,n)=>(d(e,t,"read from private field"),n?n.call(e):t.get(e)),f=(e,t,n)=>t.has(e)?a("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),m=(e,t,n)=>(d(e,t,"access private method"),n),h=(e,t,n)=>new Promise((r,l)=>{var o=e=>{try{i(n.next(e))}catch(e){l(e)}},a=e=>{try{i(n.throw(e))}catch(e){l(e)}},i=e=>e.done?r(e.value):Promise.resolve(e.value).then(o,a);i((n=n.apply(e,t)).next())});
 /**
  * TypeFlow - A lightweight, interruptible, framework-agnostic typewriter library

package/jsr.jsonc

@@ -7,7 +7,7 @@
   // The name must be scoped with an '@' (e.g. @username/pkgname)
   "name": "@staticcanvas/typeflow",
   // Must be a valid SemVer version (e.g. 0.1.0, 1.0.0-rc.1)
-  "version": "0.34.0",
+  "version": "0.34.1",
   // ---------------------------------------------------------
   // EXPORTS
   // ---------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staticcanvas/typeflow",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Typeflow library.",
   "type": "module",
   "main": "./dist/typeflow.cjs",
@@ -54,46 +54,6 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "src",
-    "branding",
-    "README.md",
-    "LICENSE",
-    "jsr.jsonc"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "serve:demo": "vite --open docs/static/webutil/index.html",
-    "docs:build": "npm run build && hugo --source docs",
-    "docs:serve": "npm run build && hugo server --source docs --buildDrafts --disableFastRender --ignoreCache --noHTTPCache --gc",
-    "build": "vite build && npm_config_mode=metrics vite build --config vite.optional.config.js && npm_config_mode=debug vite build --config vite.optional.config.js && npm_config_mode=caret vite build --config vite.optional.config.js && npm_config_mode=webaudio vite build --config vite.optional.config.js && npm_config_mode=parallel vite build --config vite.optional.config.js && npm_config_mode=keystroke vite build --config vite.optional.config.js && npm_config_mode=extchars vite build --config vite.optional.config.js",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:bun": "bun test",
-    "test:coverage:bun": "bun test --coverage",
-    "test:e2e": "npm run build && playwright test",
-    "test:e2e:ui": "npm run build && playwright test --ui",
-    "benchmark": "node --expose-gc scripts/run-benchmark.mjs",
-    "benchmark:quick": "node --expose-gc scripts/run-benchmark.mjs --quick",
-    "benchmark:md": "node --expose-gc scripts/run-benchmark.mjs --markdown",
-    "benchmark:json": "node --expose-gc scripts/run-benchmark.mjs --json",
-    "benchmark:browser": "npm run build && hugo --source docs --baseURL=http://127.0.0.1/ --gc && node scripts/run-browser-benchmark.mjs",
-    "benchmark:browser:quick": "npm run build && hugo --source docs --baseURL=http://127.0.0.1/ --gc && node scripts/run-browser-benchmark.mjs --quick",
-    "benchmark:profile": "npm run build && hugo --source docs --baseURL=http://127.0.0.1/ --gc && node scripts/profile-runtime.mjs",
-    "check:size": "node scripts/check-bundle-size.mjs",
-    "validate:docs-data": "node scripts/validate-doc-data.mjs",
-    "validate:doc-links": "hugo --source docs --gc && node scripts/validate-doc-links.mjs",
-    "release:docs:preview": "pwsh -NoProfile -File scripts/update-release-docs.ps1",
-    "release:docs": "pwsh -NoProfile -File scripts/update-release-docs.ps1 -Apply",
-    "release:docs:rebuild:preview": "pwsh -NoProfile -File scripts/update-release-docs.ps1 -Rebuild",
-    "release:docs:rebuild": "pwsh -NoProfile -File scripts/update-release-docs.ps1 -Rebuild -Apply",
-    "validate:release": "node scripts/validate-release.mjs",
-    "check:quality": "npm run validate:docs-data && npm run build && npm run check:size && npm test"
-  },
   "keywords": [
     "staticcanvas",
     "esm"
@@ -115,19 +75,5 @@
   "homepage": "https://staticcanvas.gitlab.io/typeflow",
   "bugs": {
     "url": "https://gitlab.com/staticcanvas/typeflow/-/issues"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.20.0",
-    "@playwright/test": "^1.62.1",
-    "@rollup/plugin-terser": "^1.0.0",
-    "@vitest/coverage-v8": "^3.2.7",
-    "eslint": "^9.20.0",
-    "eslint-config-prettier": "^10.0.1",
-    "globals": "^15.14.0",
-    "jsdom": "^26.0.0",
-    "prettier": "^3.5.0",
-    "rollup-plugin-copy": "^3.5.0",
-    "vite": "^6.1.0",
-    "vitest": "^3.0.5"
   }
-}
+}

package/dist/typeflow/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Garvey K. Snow / Staticcanvas
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/typeflow/README.md

@@ -1,231 +0,0 @@
-<img src="https://gitlab.com/staticcanvas/typeflow/-/raw/develop/branding/typeflow-logo.svg" width="64" height="64" alt="TypeFlow logo" />
-
-# **@staticcanvas/typeflow**
-
-[![npm-version](https://img.shields.io/npm/v/@staticcanvas/typeflow?style=flat-square&color=%2342275a)](https://www.npmjs.com/package/@staticcanvas/typeflow)
-[![jsr-version](https://img.shields.io/jsr/v/%40staticcanvas/typeflow?style=flat-square&logo=jsr&color=%2342275a)](https://jsr.io/%40staticcanvas/typeflow)
-[![codecov](https://codecov.io/gl/staticcanvas/typeflow/branch/v0.34.0-release/graph/badge.svg?token=)](https://codecov.io/gl/staticcanvas/typeflow)
-[![license](https://img.shields.io/npm/l/@staticcanvas/typeflow?style=flat-square&color=%2342275a)](https://gitlab.com/staticcanvas/typeflow)
-
-> **TypeFlow** is a lightweight, interruptible, framework-agnostic typewriter animation library designed for modern web applications and static sites.
-
----
-
-## Highlights
-
-- **Zero Dependencies**: Pure ECMAScript with native DOM batching (<7KB gzipped).
-- **Safe HTML**: Parses structured markup without breaking tags or exposing script vectors.
-- **Intl.Segmenter**: International character cluster and compound emoji safety (`🚀`, `👨‍👩‍👧‍👦`).
-- **Multi-Directional Reveals**: Type left-to-right, right-to-left, or middle-outward (`direction: 'center'`).
-- **Directional Erasing**: Backspace (`end`), left-erosion (`start`), inward shrink (`center`), `scramble`, `fade`, or `instant`.
-- **Scramble Charset Presets**: Built-in glyph presets (`matrix`, `blocks`, `ascii`, `ascii-extended`, `binary`, `hex`, `braille`, `runic`, `cyber`).
-- **Procedural Web Audio**: Built-in zero-asset keystrokes (`mechanical`, `beep`, `synth`).
-- **Smart Morph Diffing**: Diff-erases only changed suffixes (`TypeFlow.morph()`).
-- **Real-Time Stream Ingestion**: FIFO chunk stream buffer for LLM token streams (`TypeFlow.stream()`).
-- **Animation Presets**: One-line profiles for common styles (`TypeFlow.preset('cyberpunk')`).
-- **CLS Layout Shift Prevention**: Automatic dimension stabilization (`TypeFlow.fit()`).
-- **Sequence Orchestration**: Coordinate multi-step flows with `seq.type`, `seq.erase`, `seq.pause`, `seq.visible`, and `seq.call`.
-- **Framework Ready**: First-class adapters for React, Vue, Svelte, Solid.js, and Alpine.js, plus native Web Components and Astro client-side integration.
-
----
-
-## Installation
-
-```bash
-# npm
-npm install @staticcanvas/typeflow
-
-# pnpm
-pnpm add @staticcanvas/typeflow
-
-# JSR
-npx jsr add @staticcanvas/typeflow
-```
-
----
-
-## Quickstart
-
-### Vanilla JavaScript
-
-```javascript
-import { TypeFlow, seq } from '@staticcanvas/typeflow';
-
-// 1. Basic Typewriter with Natural Cadence & Procedural Audio
-TypeFlow.type('#headline', 'Fast. Resilient. Zero dependencies.', {
-  speed: 40,
-  naturalCadence: true,
-  audio: 'mechanical',
-  cursor: '|',
-});
-
-// 2. Scramble / Decrypt Effect with Presets
-TypeFlow.type('#terminal', 'SYSTEM ONLINE', TypeFlow.preset('cyberpunk'));
-
-// 3. Smart Morph Diffing
-await TypeFlow.type('#target', 'Hello World');
-await TypeFlow.morph('#target', 'Hello Universe');
-
-// 4. Real-Time Stream Ingestion
-const stream = TypeFlow.stream('#ai-output', { speed: 15 });
-stream.push('First token chunk ');
-stream.push('Second token chunk');
-
-// 5. Sequential Multi-Step Orchestration
-TypeFlow.sequence([
-  seq.visible('#step-1'), // Waits until element scrolls into view
-  seq.type('#step-1', 'Initializing kernel...'),
-  seq.pause(500),
-  seq.erase('#step-1', { eraseStyle: 'center' }),
-  seq.type('#step-1', 'Kernel active.'),
-]);
-```
-
----
-
-## Framework Adapters
-
-### React
-
-```jsx
-import React from 'react';
-import { createTypeFlowReact } from '@staticcanvas/typeflow';
-
-const useTypeFlow = createTypeFlowReact(React);
-
-export function Headline() {
-  const headlineRef = useTypeFlow('Modern React Typewriter', { speed: 40 });
-  return <h1 ref={headlineRef} />;
-}
-```
-
-### Vue
-
-```vue
-<script setup>
-import * as Vue from 'vue';
-import { createTypeFlowVue } from '@staticcanvas/typeflow';
-
-const useTypeFlow = createTypeFlowVue(Vue);
-const message = Vue.ref('Reactive Typewriter');
-const ref = useTypeFlow(() => message.value, { speed: 45 });
-</script>
-
-<template>
-  <h1 ref="ref"></h1>
-</template>
-```
-
-### Svelte
-
-```svelte
-<script>
-  import { createTypeFlowSvelte } from '@staticcanvas/typeflow';
-  const typeflow = createTypeFlowSvelte();
-</script>
-
-<h1 use:typeflow={{ text: 'Svelte Action', config: { speed: 40 } }}></h1>
-```
-
-### Solid.js
-
-```jsx
-import * as Solid from 'solid-js';
-import { createTypeFlowSolid } from '@staticcanvas/typeflow';
-
-const useTypeFlow = createTypeFlowSolid(Solid);
-
-export function Hero() {
-  const [text] = Solid.createSignal('Solid Typography');
-  const ref = useTypeFlow(text, { speed: 40 });
-  return <h1 ref={ref} />;
-}
-```
-
-### Alpine.js
-
-```html
-<script type="module">
-  import Alpine from 'alpinejs';
-  import { createTypeFlowAlpine } from '@staticcanvas/typeflow';
-
-  createTypeFlowAlpine(Alpine);
-  Alpine.start();
-</script>
-
-<div x-data="{ title: 'Alpine.js Typography' }">
-  <h1 x-typeflow="{ text: title, config: { speed: 40 } }"></h1>
-</div>
-```
-
-### Astro and Web Components
-
-Astro uses the browser-native ESM API from a client-side script or client island; it does not need a separate Astro runtime adapter. The native `<type-flow>` custom element is also available when a declarative integration is preferred. See the [framework adapter guide](https://staticcanvas.gitlab.io/typeflow/guides/framework-adapters/) for complete Astro and Web Components examples.
-
----
-
-## API Summary
-
-```typescript
-// Core Engine
-TypeFlow.type(target, text, config?): TypeFlowController
-TypeFlow.erase(target, config?): TypeFlowController
-TypeFlow.morph(target, nextText, config?): TypeFlowController
-TypeFlow.stream(target, config?): TypeFlowStreamController
-TypeFlow.preset(name, overrides?): TypeFlowConfig
-TypeFlow.fit(target, candidates): void
-TypeFlow.stagger(targets, texts?, config?): TypeFlowController
-TypeFlow.sequence(steps, seqConfig?): TypeFlowController
-TypeFlow.rotate(target, words, config?): TypeFlowController
-TypeFlow.watch(container, selector, callback): { disconnect(): void }
-TypeFlow.stop(target): void
-TypeFlow.stopAll(): void
-TypeFlow.isTyping(target): boolean
-
-// Companion Subpaths:
-// @staticcanvas/typeflow/metrics   -> TypeFlowMetrics
-// @staticcanvas/typeflow/debug     -> TypeFlowDebug
-// @staticcanvas/typeflow/webaudio  -> TypeFlowWebAudio, createKeystrokeAudio
-// @staticcanvas/typeflow/keystroke -> TypeFlowKeystroke, calculateKeyDistance
-// @staticcanvas/typeflow/extchars  -> TypeFlowExtChars, getExtendedCharset
-```
-
----
-
-## Development & NPM Scripts
-
-| Script                      | Command                                                                | Description                                                 |
-| :-------------------------- | :--------------------------------------------------------------------- | :---------------------------------------------------------- |
-| **`npm run dev`**           | `vite`                                                                 | Starts local Vite development server.                       |
-| **`npm run build`**         | `vite build`                                                           | Compiles production ESM, CJS, and UMD bundles into `dist/`. |
-| **`npm test`**              | `vitest run`                                                           | Runs the full unit test suite.                              |
-| **`npm run benchmark`**     | `node --expose-gc scripts/run-benchmark.mjs`                           | Runs repeated 10k, 50k, 100k, and concurrency benchmarks.  |
-| **`npm run benchmark:md`**  | `node --expose-gc scripts/run-benchmark.mjs --markdown`                | Generates a Markdown benchmark table.                      |
-| **`npm run benchmark:json`**| `node --expose-gc scripts/run-benchmark.mjs --json`                    | Generates machine-readable benchmark data.                 |
-| **`npm run check:quality`** | `npm run validate:docs-data && npm run build && npm run check:size && npm test` | Runs deterministic release checks.              |
-
----
-
-## Benchmarks
-
-The JSDOM suite uses warm-up rounds and seven measured samples at 10,000, 50,000, and 100,000 characters. It reports minimum, median, p95, maximum, standard deviation, and heap delta for plain text, word segmentation, safe HTML, morph, and instant erase operations. It also measures 1–1,000 concurrent short instances.
-
-These synthetic results do not measure browser layout, paint, frame rate, long tasks, or GPU composition and therefore do not define a supported browser instance limit.
-
-```bash
-npm run benchmark:md
-npm run --silent benchmark:json > typeflow-benchmark.json
-```
-
----
-
-## Documentation
-
-Full interactive documentation, API specifications, and live workbench:
-👉 **[https://staticcanvas.gitlab.io/typeflow](https://staticcanvas.gitlab.io/typeflow)**
-
----
-
-### **License**
-
-Distributed under the **MIT License**. See `LICENSE` for more information.

package/dist/typeflow/branding/gen-logo.ps1

@@ -1,14 +0,0 @@
-# [cmdletbinding()]
-# param(
-#     [parameter(Mandatory,position=0)]
-#     [string]$project,
-#     [parameter(Mandatory,position=1)]
-#     [string]$LogoName
-# )
-# Logo
-mystro config -Source "./branding/typeflow-logo.svg" -OutputDir "./branding/dist" -AutoScale | mystro Gen
-
-# Banner
-#mystro config -Source "./lume-banner.svg" -OutputDir "./dist" -AutoScale | mystro Gen
-
-# mystro config -Source "./" -OutputDir "./dist" -AutoScale | mystro Gen