@staticcanvas/typeflow 0.34.0 → 0.34.1

package/dist/typeflow/branding/typeflow-logo.svg

@@ -1,162 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-<!-- Author: Garvey K. Snow / StaticCanvas -->
-<!-- License: Creative Commons Attribution (CC BY 4.0) -->
-
-<svg
-   width="512"
-   height="512"
-   viewBox="0 0 135.46667 135.46667"
-   version="1.1"
-   id="svg1"
-   inkscape:version="1.4 (e7c3feb100, 2024-10-09)"
-   sodipodi:docname="typeflow-logosvg"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:xlink="http://www.w3.org/1999/xlink"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview1"
-     pagecolor="#ffffff"
-     bordercolor="#000000"
-     borderopacity="0.25"
-     inkscape:showpageshadow="2"
-     inkscape:pageopacity="0.0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#d1d1d1"
-     inkscape:document-units="mm"
-     inkscape:zoom="0.83276505"
-     inkscape:cx="4.2028661"
-     inkscape:cy="309.21086"
-     inkscape:window-width="1440"
-     inkscape:window-height="899"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="layer1" />
-  <defs
-     id="defs1">
-    <linearGradient
-       id="linearGradient15"
-       inkscape:collect="always">
-      <stop
-         style="stop-color:#ff0c05;stop-opacity:1;"
-         offset="0"
-         id="stop15" />
-      <stop
-         style="stop-color:#fdbb4f;stop-opacity:1;"
-         offset="1"
-         id="stop16" />
-    </linearGradient>
-    <inkscape:path-effect
-       effect="powerclip"
-       message=""
-       id="path-effect14"
-       is_visible="true"
-       lpeversion="1"
-       inverse="true"
-       flatten="false"
-       hide_clip="false" />
-    <linearGradient
-       id="linearGradient9"
-       inkscape:collect="always">
-      <stop
-         style="stop-color:#ff0000;stop-opacity:1;"
-         offset="0"
-         id="stop9" />
-      <stop
-         style="stop-color:#fdcf58;stop-opacity:1;"
-         offset="1"
-         id="stop11" />
-    </linearGradient>
-    <inkscape:path-effect
-       effect="powerclip"
-       message=""
-       id="path-effect8"
-       is_visible="true"
-       lpeversion="1"
-       inverse="true"
-       flatten="false"
-       hide_clip="false" />
-    <linearGradient
-       id="linearGradient1"
-       inkscape:collect="always">
-      <stop
-         style="stop-color:#152331;stop-opacity:1;"
-         offset="0"
-         id="stop1" />
-      <stop
-         style="stop-color:#252b33;stop-opacity:1;"
-         offset="0.545663"
-         id="stop14" />
-      <stop
-         style="stop-color:#494949;stop-opacity:1;"
-         offset="0.97742236"
-         id="stop3" />
-    </linearGradient>
-    <linearGradient
-       inkscape:collect="always"
-       xlink:href="#linearGradient1"
-       id="linearGradient2"
-       x1="53.244328"
-       y1="67.510217"
-       x2="125.41869"
-       y2="63.438999"
-       gradientUnits="userSpaceOnUse"
-       gradientTransform="matrix(1.5316336,0,0,0.9502836,-73.067166,6.6824504)" />
-    <linearGradient
-       inkscape:collect="always"
-       xlink:href="#linearGradient9"
-       id="linearGradient10"
-       x1="2.2222646"
-       y1="67.526265"
-       x2="133.40492"
-       y2="67.526265"
-       gradientUnits="userSpaceOnUse"
-       gradientTransform="matrix(0.97562941,0,0,0.97562941,0.06430015,2.3289887)" />
-    <clipPath
-       clipPathUnits="userSpaceOnUse"
-       id="clipPath14">
-      <path
-         style="font-weight:900;font-size:85.9333px;font-family:Timmana;-inkscape-font-specification:'Timmana Heavy';display:none;fill:#4de276;stroke-width:36.7496;stroke-dasharray:881.991, 881.991"
-         d="M 62.121174,50.305851 H 51.580021 L 45.507402,93.387077 H 34.50794 L 40.465984,50.305851 H 29.810255 L 30.95603,41.368789 H 63.496105 Z M 86.417507,72.992242 H 73.011914 l -2.864443,20.394835 h -11.11404 l 7.332975,-52.018288 h 27.15492 l -1.260353,8.937062 H 76.22009 l -2.062398,14.207638 h 13.405593 z m 30.664703,-36.32114 q -1.83325,3.437332 -5.156,10.426573 -3.20818,6.874663 -7.44755,15.926305 -4.1248,9.051639 -8.937065,19.59279 -4.697688,10.541151 -9.395373,21.54061 h -9.509953 q 4.812265,-10.999459 9.509953,-21.54061 4.697685,-10.541151 8.822484,-19.59279 4.239376,-9.051642 7.447554,-15.926305 3.32275,-6.989241 5.156,-10.426573 z"
-         id="path14"
-         aria-label="TF/" />
-      <path
-         id="lpe_path-effect14"
-         style="font-weight:900;font-size:85.9333px;font-family:Timmana;-inkscape-font-specification:'Timmana Heavy';fill:#4de276;stroke-width:36.7496;stroke-dasharray:881.991, 881.991"
-         class="powerclip"
-         d="M -0.99145186,2.2282375 H 134.1298 V 138.60146 H -0.99145186 Z M 62.121174,50.305851 63.496105,41.368789 H 30.95603 l -1.145775,8.937062 H 40.465984 L 34.50794,93.387077 h 10.999462 l 6.072619,-43.081226 z m 24.296333,22.686391 1.145778,-8.478753 H 74.157692 L 76.22009,50.305851 h 16.040883 l 1.260353,-8.937062 h -27.15492 l -7.332975,52.018288 h 11.11404 l 2.864443,-20.394835 z m 30.664703,-36.32114 h -9.50995 q -1.83325,3.437332 -5.156,10.426573 -3.208178,6.874663 -7.447554,15.926305 -4.124799,9.051639 -8.822484,19.59279 -4.697688,10.541151 -9.509953,21.54061 h 9.509953 q 4.697685,-10.999459 9.395373,-21.54061 4.812265,-10.541151 8.937065,-19.59279 4.23937,-9.051642 7.44755,-15.926305 3.32275,-6.989241 5.156,-10.426573 z" />
-    </clipPath>
-    <linearGradient
-       inkscape:collect="always"
-       xlink:href="#linearGradient15"
-       id="linearGradient16"
-       x1="4.3812527"
-       y1="70.414794"
-       x2="129.1298"
-       y2="70.414794"
-       gradientUnits="userSpaceOnUse" />
-  </defs>
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1">
-    <path
-       id="rect1-0"
-       style="display:inline;fill:url(#linearGradient10);fill-opacity:1;stroke:none;stroke-width:7.73234;stroke-dasharray:185.577, 185.577"
-       d="M 66.225236,2.6986748 C 101.7823,2.2567532 149.52676,4.2503538 130.21805,68.209597 120.37569,100.81197 101.08916,133.42648 66.225236,133.72052 30.77447,134.01952 -6.0050013,103.55547 2.2324068,68.209597 9.8323743,35.59892 31.053259,3.1358101 66.225236,2.6986748 Z"
-       inkscape:label="background"
-       sodipodi:nodetypes="sssss" />
-    <path
-       id="rect1"
-       style="fill:url(#linearGradient2);stroke:url(#linearGradient16);stroke-width:3.868;stroke-dasharray:92.8322, 92.8322;stroke-dashoffset:0"
-       d="m 66.979985,10.952257 c 32.406976,0 60.215815,-11.12007734 60.215815,22.055685 0,33.175759 -11.78736,80.083628 -59.580381,95.488398 C 23.815672,142.61398 -2.6580111,107.12136 8.4836391,70.836305 18.221809,39.121966 34.57301,10.952257 66.979985,10.952257 Z"
-       clip-path="url(#clipPath14)"
-       sodipodi:nodetypes="sssss"
-       inkscape:path-effect="#path-effect14"
-       inkscape:original-d="m 66.979985,10.952257 c 32.406976,0 60.215815,-11.12007734 60.215815,22.055685 0,33.175759 -11.78736,80.083628 -59.580381,95.488398 C 23.815672,142.61398 -2.6580111,107.12136 8.4836391,70.836305 18.221809,39.121966 34.57301,10.952257 66.979985,10.952257 Z"
-       transform="matrix(1.0197765,0,0,1.0197765,-0.02319825,-3.6171792)" />
-  </g>
-</svg>

package/dist/typeflow/jsr.jsonc

@@ -1,27 +0,0 @@
-{
-  // URL to the schema. This gives you autocompletion and validation in VS Code.
-  "$schema": "https://jsr.io/schema/config-file.v1.json",
-  // ---------------------------------------------------------
-  // PACKAGE IDENTITY
-  // ---------------------------------------------------------
-  // 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",
-  // ---------------------------------------------------------
-  // EXPORTS
-  // ---------------------------------------------------------
-  // Defines what files users can import.
-  // "." is the default import
-  "exports": {
-    ".": "./src/typeflow.js"
-  },
-  // ---------------------------------------------------------
-  // PUBLISHING CONTROLS
-  // ---------------------------------------------------------
-  // Controls which files are uploaded to JSR.
-  "publish": {
-    "include": ["src/**", "dist/**", "package.json", "README.md", "LICENSE"],
-    "exclude": ["src/**/*.test.js"],
-  },
-}

package/dist/typeflow/package.json

@@ -1,79 +0,0 @@
-{
-  "name": "@staticcanvas/typeflow",
-  "version": "0.34.0",
-  "description": "Typeflow library.",
-  "type": "module",
-  "main": "./dist/typeflow.cjs",
-  "module": "./dist/typeflow.mjs",
-  "browser": "./dist/typeflow.js",
-  "types": "./src/typeflow.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/typeflow.mjs",
-      "require": "./dist/typeflow.cjs",
-      "default": "./dist/typeflow.js"
-    },
-    "./metrics": {
-      "import": "./dist/typeflow-metrics.mjs",
-      "require": "./dist/typeflow-metrics.cjs",
-      "default": "./dist/typeflow-metrics.js"
-    },
-    "./debug": {
-      "import": "./dist/typeflow-debug.mjs",
-      "require": "./dist/typeflow-debug.cjs",
-      "default": "./dist/typeflow-debug.js"
-    },
-    "./caret": {
-      "import": "./dist/typeflow-caret.mjs",
-      "require": "./dist/typeflow-caret.cjs",
-      "default": "./dist/typeflow-caret.js"
-    },
-    "./webaudio": {
-      "types": "./src/typeflow-webaudio.d.ts",
-      "import": "./dist/typeflow-webaudio.mjs",
-      "require": "./dist/typeflow-webaudio.cjs",
-      "default": "./dist/typeflow-webaudio.js"
-    },
-    "./parallel": {
-      "types": "./src/typeflow-parallel.d.ts",
-      "import": "./dist/typeflow-parallel.mjs",
-      "require": "./dist/typeflow-parallel.cjs",
-      "default": "./dist/typeflow-parallel.js"
-    },
-    "./keystroke": {
-      "types": "./src/typeflow-keystroke.d.ts",
-      "import": "./dist/typeflow-keystroke.mjs",
-      "require": "./dist/typeflow-keystroke.cjs",
-      "default": "./dist/typeflow-keystroke.js"
-    },
-    "./extchars": {
-      "types": "./src/typeflow-extchars.d.ts",
-      "import": "./dist/typeflow-extchars.mjs",
-      "require": "./dist/typeflow-extchars.cjs",
-      "default": "./dist/typeflow-extchars.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "keywords": [
-    "staticcanvas",
-    "esm"
-  ],
-  "author": "Garvey K. Snow",
-  "license": "MIT",
-  "peerDependencies": {
-    "@staticcanvas/logcad": "^0.6.0"
-  },
-  "peerDependenciesMeta": {
-    "@staticcanvas/logcad": {
-      "optional": true
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://gitlab.com/staticcanvas/typeflow.git"
-  },
-  "homepage": "https://staticcanvas.gitlab.io/typeflow",
-  "bugs": {
-    "url": "https://gitlab.com/staticcanvas/typeflow/-/issues"
-  }
-}

package/dist/typeflow/src/typeflow-audio-presets.js

@@ -1,137 +0,0 @@
-export const AUDIO_PRESET_SCHEMA_VERSION = 1;
-
-const freeze = (value) => {
-  if (value && typeof value === 'object' && !Object.isFrozen(value)) {
-    Object.values(value).forEach(freeze);
-    Object.freeze(value);
-  }
-  return value;
-};
-
-const layer = (oscillator, start, end, gain, duration, extras = {}) => ({
-  oscillator,
-  frequency: { start, end },
-  gain: { start: gain, end: 0.001 },
-  duration,
-  filter: extras.filter ?? null,
-  detune: { base: extras.detune ?? 0, variance: extras.variance ?? 0.06 },
-});
-
-const preset = (type, erase) => ({
-  version: AUDIO_PRESET_SCHEMA_VERSION,
-  actions: { type, erase: erase ?? type },
-});
-
-export const AUDIO_PRESETS = freeze({
-  'mechanical-blue': preset(
-    [layer('triangle', 3400, 900, 0.18, 0.008), layer('sine', 200, 50, 0.32, 0.035)],
-    [layer('triangle', 900, 180, 0.12, 0.025)]
-  ),
-  'mechanical-red': preset(
-    [layer('sine', 220, 70, 0.26, 0.028)],
-    [layer('sine', 150, 55, 0.12, 0.022)]
-  ),
-  'mechanical-brown': preset(
-    [layer('triangle', 240, 75, 0.27, 0.032)],
-    [layer('triangle', 170, 60, 0.13, 0.024)]
-  ),
-  'soft-keyboard': preset(
-    [
-      layer('sine', 520, 280, 0.08, 0.018, {
-        filter: { type: 'lowpass', frequency: 1200, q: 0.7 },
-      }),
-    ],
-    [layer('sine', 320, 180, 0.06, 0.016)]
-  ),
-  typewriter: preset(
-    [layer('square', 320, 90, 0.17, 0.022)],
-    [layer('square', 180, 70, 0.13, 0.026)]
-  ),
-  'terminal-beep': preset(
-    [layer('square', 880, 880, 0.08, 0.025)],
-    [layer('square', 440, 330, 0.06, 0.03)]
-  ),
-  synth: preset(
-    [layer('sawtooth', 950, 180, 0.12, 0.045)],
-    [layer('sawtooth', 420, 120, 0.09, 0.04)]
-  ),
-  correction: preset(
-    [layer('triangle', 360, 110, 0.1, 0.035)],
-    [layer('triangle', 260, 80, 0.14, 0.045)]
-  ),
-});
-
-export const AUDIO_PRESET_ALIASES = freeze({
-  clicky: 'mechanical-blue',
-  mechanical: 'mechanical-red',
-  tactile: 'mechanical-brown',
-  teletype: 'typewriter',
-  vintage: 'typewriter',
-  'terminal-8bit': 'terminal-beep',
-  '8bit': 'terminal-beep',
-  beep: 'terminal-beep',
-  'cyber-synth': 'synth',
-  neon: 'synth',
-  bubble: 'soft-keyboard',
-  pop: 'soft-keyboard',
-});
-
-export function validateAudioPreset(config) {
-  if (
-    !config ||
-    config.version !== AUDIO_PRESET_SCHEMA_VERSION ||
-    !config.actions ||
-    typeof config.actions !== 'object'
-  ) {
-    throw new TypeError(
-      `TypeFlowWebAudio: preset must use schema version ${AUDIO_PRESET_SCHEMA_VERSION}.`
-    );
-  }
-  const output = { version: AUDIO_PRESET_SCHEMA_VERSION, actions: {} };
-  for (const action of ['type', 'erase']) {
-    const layers = config.actions[action];
-    if (!Array.isArray(layers) || layers.length === 0 || layers.length > 4) {
-      throw new TypeError(
-        `TypeFlowWebAudio: actions.${action} must contain 1-4 oscillator layers.`
-      );
-    }
-    output.actions[action] = layers.map((candidate) => {
-      const oscillator = String(candidate.oscillator ?? 'sine');
-      if (!['sine', 'square', 'sawtooth', 'triangle'].includes(oscillator))
-        throw new RangeError('TypeFlowWebAudio: invalid oscillator type.');
-      const duration = Number(candidate.duration);
-      const start = Number(candidate.frequency?.start);
-      const end = Number(candidate.frequency?.end);
-      const gainStart = Number(candidate.gain?.start);
-      const gainEnd = Number(candidate.gain?.end);
-      if (!(duration >= 0.001 && duration <= 2))
-        throw new RangeError('TypeFlowWebAudio: duration must be 0.001-2 seconds.');
-      if (!(start >= 20 && start <= 20000 && end >= 20 && end <= 20000))
-        throw new RangeError('TypeFlowWebAudio: frequency must be 20-20000 Hz.');
-      if (!(gainStart >= 0 && gainStart <= 1 && gainEnd > 0 && gainEnd <= 1))
-        throw new RangeError('TypeFlowWebAudio: gain must be within safe bounds.');
-      const variance = Number(candidate.detune?.variance ?? 0);
-      if (!(variance >= 0 && variance <= 0.5))
-        throw new RangeError('TypeFlowWebAudio: detune variance must be 0-0.5.');
-      const filter =
-        candidate.filter === null || candidate.filter === undefined
-          ? null
-          : {
-              type: String(candidate.filter.type ?? 'lowpass'),
-              frequency: Math.max(20, Math.min(20000, Number(candidate.filter.frequency) || 1000)),
-              q: Math.max(0.0001, Math.min(1000, Number(candidate.filter.q) || 1)),
-            };
-      if (filter && !['lowpass', 'highpass', 'bandpass', 'notch'].includes(filter.type))
-        throw new RangeError('TypeFlowWebAudio: invalid filter type.');
-      return {
-        oscillator,
-        frequency: { start, end },
-        gain: { start: gainStart, end: gainEnd },
-        duration,
-        filter,
-        detune: { base: Number(candidate.detune?.base) || 0, variance },
-      };
-    });
-  }
-  return freeze(output);
-}

package/dist/typeflow/src/typeflow-caret.d.ts

@@ -1,65 +0,0 @@
-/**
- * TypeFlow Caret - Interactive Cursor Positioning & Mid-String Editing.
- */
-export interface TypeFlowCaretConfig {
-  /** Initial text. Defaults to the target's current text content. */
-  text?: string;
-  /** Initial caret index in graphemes. Defaults to the end of the text. */
-  position?: number;
-  /** Cursor glyph. Empty string hides it. Default: '|' */
-  cursor?: string;
-  /** Default: true */
-  cursorBlink?: boolean;
-  /** Default ms per character for `insert()`. Default: 40 */
-  speed?: number;
-  /** Instantly complete `insert()` instead of animating if the user prefers reduced motion. Default: true */
-  respectReducedMotion?: boolean;
-}
-
-export interface TypeFlowCaretInsertConfig {
-  /** Ms per character. Defaults to the speed passed to the constructor. */
-  speed?: number;
-  respectReducedMotion?: boolean;
-  onStart?: () => void;
-  onComplete?: (text: string) => void;
-  onInterrupt?: () => void;
-}
-
-export interface TypeFlowCaretResult {
-  completed: boolean;
-  text: string;
-}
-
-export interface TypeFlowCaretController {
-  stop: () => void;
-  promise: Promise<TypeFlowCaretResult>;
-}
-
-export class TypeFlowCaret {
-  constructor(target: Element | string, config?: TypeFlowCaretConfig);
-
-  /** Current plain-text content, cursor excluded. */
-  readonly text: string;
-  /** Current caret index, in graphemes, from the start of the text. */
-  readonly position: number;
-  /** Total number of graphemes in the current text. */
-  readonly length: number;
-
-  /** Moves the caret to an absolute grapheme index, clamped to bounds. */
-  jump(position: number): this;
-  /** Moves the caret by a relative number of graphemes (positive = right, negative = left). */
-  move(delta: number): this;
-  /** Deletes one grapheme at the caret: 'backward' (Backspace, default) or 'forward' (Delete). */
-  deleteChar(direction?: "backward" | "forward"): this;
-  /** Deletes the whitespace-delimited word adjacent to the caret. */
-  deleteWord(direction?: "backward" | "forward"): this;
-  /** Types `text` at the current caret position, shifting following content to the right. */
-  insert(text: string, config?: TypeFlowCaretInsertConfig): TypeFlowCaretController;
-  /** Stops an in-flight `insert()`, if any. */
-  stop(): this;
-  /** Stops any in-flight `insert()` and clears the blink interval. */
-  destroy(): this;
-}
-
-/** Factory form of `new TypeFlowCaret(target, config)`. */
-export function Caret(target: Element | string, config?: TypeFlowCaretConfig): TypeFlowCaret;