Typewriter

<p class="kodza-typewriter" data-words='["No framework needed.", "Just HTML, CSS and JS.", "Copy. Paste. Ship."]'>No framework needed.</p>

<p class="kodza-typewriter" data-mode="retype" data-words='["It works on my machine.", "It works on your machine.", "It works on every machine."]'>It works on my machine.</p>

<p class="kodza-typewriter" data-mode="select" data-words='["Ship it on Friday.", "Ship it on Monday.", "Ship it someday."]'>Ship it on Friday.</p>

/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Typewriter
   Types a list of phrases with a human rhythm: a little irregular, with a breath after
   punctuation. The caret stays solid while typing and only blinks when it waits.
   Three ways to move from one phrase to the next, picked with data-mode:
     (default)  delete everything, type the next phrase
     "retype"   only delete what changes, keep what the phrases share
     "select"   select the part that changes, like in an editor, then type over it
   Everything is tuned with the --kz-type-* variables. */
.kodza-typewriter {
  --kz-type-caret: currentColor;
  --kz-type-selection: rgba(10, 10, 10, 0.14);
}

.kodza-typewriter__text {
  white-space: pre-wrap;
}

.kodza-typewriter__selected {
  background: var(--kz-type-selection);
  border-radius: 0.08em;
}

.kodza-typewriter__caret {
  display: inline-block;
  width: 0.07em;
  min-width: 2px;
  height: 1em;
  margin-left: 0.04em;
  background: var(--kz-type-caret);
  vertical-align: -0.12em;
  animation: kodza-type-blink 1s steps(1) infinite;
}

/* Solid while typing, like a real caret */
.kodza-typewriter.is-typing .kodza-typewriter__caret {
  animation: none;
}

.kodza-typewriter__sr {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
}

@keyframes kodza-type-blink {
  50% { opacity: 0; }
}

@media (prefers-reduced-motion: reduce) {
  .kodza-typewriter__caret {
    animation: none;
  }
}

/* kodza-guard 8fb60aee2266 — generated by Kodza, do not edit.
   Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
   component. :not(#_) is always true and weighs as much as an id, so these lines win over
   theme rules made of classes and tags. Customise the component through its --kz-* variables. */

/* What the browser gives, on everything the component leaves to it */

.kodza-typewriter:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-style: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-typewriter__sr:not(#_),
.kodza-typewriter__text:not(#_),
.kodza-typewriter__caret:not(#_),
.kodza-typewriter span:where(:not([class*="kodza-"])):not(#_) {
  box-sizing: revert;
}

.kodza-typewriter:not(#_):where(:not([hidden])) {
  display: revert;
}

.kodza-typewriter:not(#_):where([hidden]) {
  display: none;
}

// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Typewriter
// Types each phrase of data-words, waits, then moves to the next one in the chosen
// data-mode. Screen readers get all the phrases once, as plain text. It pauses while
// off screen, and shows the first phrase without moving for reduced motion.
(() => {
  const SELECTOR = '.kodza-typewriter';
  const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

  // Common start and end of two phrases (by character)
  // What two phrases share at the start and at the end, in whole words: the word that changes
  // is retyped entirely (every → my, not ever → m, which left the caret inside the word)
  const isWord = (char) => char !== undefined && /\S/.test(char);
  function overlap(a, b) {
    let start = 0;
    while (start < a.length && start < b.length && a[start] === b[start]) start++;
    while (start > 0 && isWord(a[start - 1]) && (isWord(a[start]) || isWord(b[start]))) start--;
    let end = 0;
    while (end < a.length - start && end < b.length - start && a[a.length - 1 - end] === b[b.length - 1 - end]) end++;
    while (end > 0 && isWord(a[a.length - end]) && (isWord(a[a.length - end - 1]) || isWord(b[b.length - end - 1]))) end--;
    return { start, end };
  }

  // One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
  function mount(root, signal) {
    let words;
    try {
      words = JSON.parse(root.dataset.words || '[]');
    } catch {
      words = [];
    }
    if (!words.length) words = [root.textContent.trim()];
    const mode = root.dataset.mode || 'loop';
    const speed = Number(root.dataset.speed) || 70; // ms per character
    const hold = Number(root.dataset.hold) || 1800;

    const sr = document.createElement('span');
    sr.className = 'kodza-typewriter__sr';
    sr.textContent = words.join(' ');
    const visual = document.createElement('span');
    visual.setAttribute('aria-hidden', 'true');
    const before = document.createElement('span');
    const selected = document.createElement('span');
    const after = document.createElement('span');
    before.className = selected.className = after.className = 'kodza-typewriter__text';
    selected.classList.add('kodza-typewriter__selected');
    const caret = document.createElement('span');
    caret.className = 'kodza-typewriter__caret';
    visual.append(before, selected, caret, after);
    root.replaceChildren(sr, visual);
    root.classList.add('is-ready');

    const show = (head, sel = '', tail = '') => {
      before.textContent = head;
      selected.textContent = sel;
      after.textContent = tail;
    };
    if (reduceMotion) return show(words[0]);

    // Typing only runs while the element is on screen
    let onScreen = false;
    let wake = null;
    const observer = new IntersectionObserver(([entry]) => {
      onScreen = entry.isIntersecting;
      if (onScreen && wake) wake();
    });
    observer.observe(root);
    signal.addEventListener('abort', () => observer.disconnect());
    const ready = () => (onScreen ? Promise.resolve() : new Promise((r) => (wake = r)));
    // Once the instance is destroyed, every pause lasts forever: the typing simply stops
    const wait = (ms) => sleep(ms).then(() => signal.aborted && new Promise(() => {}));

    // A human rhythm: irregular, with a breath after punctuation
    const keystroke = (char) => wait(speed * (0.55 + Math.random() * 0.9) + (/[.,!?;:]/.test(char) ? speed * 2.5 : 0));

    async function type(head, text, tail) {
      root.classList.add('is-typing');
      for (let i = 1; i <= text.length; i++) {
        await ready();
        show(head + text.slice(0, i), '', tail);
        await keystroke(text[i - 1]);
      }
      root.classList.remove('is-typing');
    }

    async function erase(head, text, tail) {
      root.classList.add('is-typing');
      for (let i = text.length - 1; i >= 0; i--) {
        await ready();
        show(head + text.slice(0, i), '', tail);
        await wait(speed * 0.45);
      }
      root.classList.remove('is-typing');
    }

    (async () => {
      show('');
      await type('', words[0], '');
      for (let i = 0; ; i = (i + 1) % words.length) {
        const current = words[i];
        const next = words[(i + 1) % words.length];
        await wait(hold);
        await ready();
        if (mode === 'loop') {
          await erase('', current, '');
          await wait(speed * 4);
          await type('', next, '');
          continue;
        }
        const { start, end } = overlap(current, next);
        const head = current.slice(0, start);
        const tail = end ? current.slice(current.length - end) : '';
        const changed = current.slice(start, current.length - end);
        const typed = next.slice(start, next.length - end);
        if (mode === 'select' && changed) {
          // Select the part that changes, then type over it
          for (let n = 1; n <= changed.length; n++) {
            show(head, changed.slice(0, n), changed.slice(n) + tail);
            await wait(28);
          }
          await wait(380);
          show(head, '', tail);
          await wait(speed * 2);
        } else {
          await erase(head, changed, tail);
          await wait(speed * 3);
        }
        await type(head, typed, tail);
      }
    })();
  }

  // Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
  // event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
  // markup back. For themes and apps that swap content without a page load.
  const instances = new WeakMap();
  const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
  const init = (scope) => find(scope).forEach((root) => {
    if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
    const controller = new AbortController();
    instances.set(root, { controller, html: root.innerHTML, attrs: [...root.attributes].map((a) => [a.name, a.value]) });
    mount(root, controller.signal);
    root.classList.add('is-ready');
  });
  const destroy = (scope) => find(scope).forEach((root) => {
    const instance = instances.get(root);
    if (!instance) return;
    instances.delete(root);
    instance.controller.abort();
    [...root.attributes].forEach((a) => root.removeAttribute(a.name));
    instance.attrs.forEach(([name, value]) => root.setAttribute(name, value));
    root.innerHTML = instance.html;
  });
  document.addEventListener('kodza:init', (event) => init(event.detail?.root));
  document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
  init();
  // Loaded in <head>, the script runs before the markup exists: once more when it is parsed
  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();

'use client';
// Kodza — Typewriter, for React. From https://kodza.dev/components/typewriter-effect/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: typewriter-effect.css and typewriter-effect.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './typewriter-effect.css';

export type TypewriterProps = Omit<ComponentPropsWithoutRef<'p'>, "children" | "vars" | "words" | "mode"> & {
  /** data-words on the root (default: ["No framework needed.", "Just HTML, CSS and JS.", "Copy. Paste. Ship."]) */
  words?: "[\"No framework needed.\", \"Just HTML, CSS and JS.\", \"Copy. Paste. Ship.\"]" | "[\"It works on my machine.\", \"It works on your machine.\", \"It works on every machine.\"]" | "[\"Ship it on Friday.\", \"Ship it on Monday.\", \"Ship it someday.\"]";
  /** data-mode on the root */
  mode?: "retype" | "select";
  /** Settings, as CSS variables on the root */
  vars?: {
    /** default: currentColor */
    "--kz-type-caret"?: string | number;
    /** default: rgba(10, 10, 10, 0.14) */
    "--kz-type-selection"?: string | number;
  };
  /** The text, plain: the script reads it and rebuilds the markup around it */
  children?: string;
  className?: string;
};

export function Typewriter({ words = "[\"No framework needed.\", \"Just HTML, CSS and JS.\", \"Copy. Paste. Ship.\"]", mode, vars, children = "No framework needed.", className, style, ...rest }: TypewriterProps) {
  const ref = useRef<ComponentRef<'p'>>(null);
  const classes = ["kodza-typewriter", className].filter(Boolean).join(' ');
  // Everything the markup is made of: when it changes, React gets a fresh element (see the top)
  const key = JSON.stringify([classes, words, mode, vars, children, style, rest]);

  // Starts the script on this element once React has rendered it, stops it when it goes
  useEffect(() => {
    const root = ref.current;
    let live = true;
    // @ts-ignore: a plain script, no types to find
    import('./typewriter-effect.js').then(() => {
      if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
    });
    return () => {
      live = false;
      document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
    };
  }, [key]);

  return (
    <p key={key} {...rest} className={classes} data-words={words} data-mode={mode} style={{ ...vars, ...style } as CSSProperties} ref={ref}>{children}</p>
  );
}