@chayns-components/typewriter 5.0.53-alpha.0 → 5.0.53

package/lib/cjs/components/typewriter/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["_speed","require","getSubTextFromHTML","html","length","div","document","createElement","innerHTML","text","currLength","escapeText","value","replace","escapeAttr","String","VOID_ELEMENTS","Set","traverse","node","nodeType","textContent","nodeText","remaining","substring","element","nodeName","toLowerCase","attributes","attribute","name","isVoid","has","i","childNodes","childNode","exports","getCharactersCount","count","trim","Array","from","forEach","shuffleArray","array","result","j","Math","floor","random","calculateAutoSpeed","ema","MINIMUM_TIMEOUT","speed","TypewriterSpeed","ExtraSlow","steps","msPerChar","min","max","calculateEMA","currentEMA","newValue","alpha","updateChunkStreamingSpeedEMA","currentLength","state","now","Date","deltaTime","lastTimestamp","deltaLength","lastLength","charsPerSecond","newEMA"],"sources":["../../../../src/components/typewriter/utils.ts"],"sourcesContent":["import { TypewriterSpeed } from '../../types/speed';\n\n/**\n * Returns a substring of an HTML string while preserving HTML structure.\n *\n * Core rules:\n * - Element nodes are re-serialized as tags (start/end) to keep structure.\n * - Text nodes are always HTML-escaped on output. This prevents that previously\n *   escaped text (like \"&lt;div&gt;\") turns into real tags during the DOM round trip.\n * - Attribute values are HTML-escaped on output.\n * - Void elements are serialized without closing tags.\n * - For TWIGNORE/TW-IGNORE elements, the innerHTML is passed through so that\n *   their content (including real HTML) remains untouched.\n * - On early cutoff (once the length limit is reached), already opened tags are\n *   properly closed to keep the result valid HTML.\n *\n * Note on length counting:\n * - The length is based on the decoded textContent length (as the DOM provides),\n *   not on byte length nor escaped entity length. This mirrors how the text is perceived.\n *\n * @param html   The input HTML string; may contain a mix of real HTML and already escaped HTML.\n * @param length The maximum number of text characters (based on textContent) to include.\n * @returns A valid HTML string containing up to the specified number of text characters,\n *          preserving HTML tags and keeping escaped text escaped.\n */\nexport const getSubTextFromHTML = (html: string, length: number): string => {\n    const div = document.createElement('div');\n\n    div.innerHTML = html;\n\n    let text = '';\n    let currLength = 0;\n\n    // Escape text node content to ensure that decoded \"<\" and \">\" do not become real tags.\n    const escapeText = (value: string): string =>\n        value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\n    // Escape attribute values safely.\n    const escapeAttr = (value: string): string =>\n        String(value)\n            .replace(/&/g, '&amp;')\n            .replace(/\"/g, '&quot;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;');\n\n    // HTML void elements (must not have closing tags)\n    const VOID_ELEMENTS = new Set([\n        'area',\n        'base',\n        'br',\n        'col',\n        'embed',\n        'hr',\n        'img',\n        'input',\n        'link',\n        'meta',\n        'param',\n        'source',\n        'track',\n        'wbr',\n    ]);\n\n    // Traverses nodes and appends to \"text\".\n    // Returns false to signal \"stop traversal\" once the length limit is reached.\n    const traverse = (node: Node): boolean => {\n        // Text node\n        if (node.nodeType === 3 && typeof node.textContent === 'string') {\n            const nodeText = node.textContent;\n            const remaining = length - currLength;\n\n            if (remaining <= 0) {\n                return false;\n            }\n\n            if (nodeText.length <= remaining) {\n                // Always escape text before writing to output\n                text += escapeText(nodeText);\n                currLength += nodeText.length;\n            } else {\n                // Cut the text and stop traversal\n                text += escapeText(nodeText.substring(0, remaining));\n                currLength += remaining;\n                return false;\n            }\n\n            return true;\n        }\n\n        // Element node\n        if (node.nodeType === 1) {\n            const element = node as Element;\n\n            // Pass-through for TWIGNORE/TW-IGNORE: keep their HTML as-is.\n            if (element.nodeName === 'TWIGNORE' || element.nodeName === 'TW-IGNORE') {\n                // element.innerHTML serializes children; escaped text stays escaped,\n                // real HTML stays HTML — exactly what we want here.\n                text += element.innerHTML;\n                return true;\n            }\n\n            const nodeName = element.nodeName.toLowerCase();\n\n            // Serialize attributes safely\n            let attributes = '';\n            // @ts-expect-error: attributes is a NodeListOf<Attr>\n            // eslint-disable-next-line no-restricted-syntax\n            for (const attribute of element.attributes) {\n                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/restrict-template-expressions,@typescript-eslint/no-unsafe-argument\n                attributes += ` ${attribute.name}=\"${escapeAttr(attribute.value)}\"`;\n            }\n\n            // Open tag\n            text += `<${nodeName}${attributes}>`;\n\n            // Void elements: do not recurse children and do not emit a closing tag\n            const isVoid = VOID_ELEMENTS.has(nodeName);\n            if (!isVoid) {\n                // Recurse through children until limit is reached\n                for (let i = 0; i < element.childNodes.length; i++) {\n                    const childNode = element.childNodes[i];\n                    if (childNode && !traverse(childNode)) {\n                        // On early stop: close this tag to keep valid HTML, then bubble stop.\n                        text += `</${nodeName}>`;\n                        return false;\n                    }\n                }\n\n                // Close tag after all children\n                text += `</${nodeName}>`;\n            }\n\n            return true;\n        }\n\n        // Other node types (comments, etc.) are ignored for text length\n        return true;\n    };\n\n    // Traverse top-level children\n    for (let i = 0; i < div.childNodes.length; i++) {\n        const childNode = div.childNodes[i];\n        if (childNode && !traverse(childNode)) {\n            return text;\n        }\n    }\n\n    return text;\n};\n\nexport const getCharactersCount = (html: string): number => {\n    const div = document.createElement('div');\n\n    div.innerHTML = html;\n\n    let count = 0;\n\n    const traverse = (node: Node): void => {\n        if (node.nodeName === 'TWIGNORE') {\n            count += 1;\n        } else if (node.nodeType === 3 && typeof node.textContent === 'string') {\n            count += node.textContent.trim().length;\n        } else if (node.nodeType === 1) {\n            if (node.nodeName === 'CODE' && node.textContent !== null) {\n                count += node.textContent.length;\n\n                return;\n            }\n\n            Array.from(node.childNodes).forEach(traverse);\n        }\n    };\n\n    Array.from(div.childNodes).forEach(traverse);\n\n    return count;\n};\n\nexport const shuffleArray = <T>(array: T[]): T[] => {\n    const result = Array.from(array);\n\n    for (let i = result.length - 1; i > 0; i--) {\n        const j = Math.floor(Math.random() * (i + 1));\n\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        [result[i], result[j]] = [result[j]!, result[i]!];\n    }\n\n    return result;\n};\n\nexport const calculateAutoSpeed = (ema: number): { speed: number; steps: number } => {\n    // nested timer calls are clamped to a 4ms minimum\n    // https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#reasons_for_longer_delays_than_specified\n    const MINIMUM_TIMEOUT = 4;\n\n    if (ema <= 0) {\n        return { speed: TypewriterSpeed.ExtraSlow, steps: 1 };\n    }\n\n    const msPerChar = Math.min(1000 / ema, TypewriterSpeed.ExtraSlow);\n\n    if (msPerChar >= MINIMUM_TIMEOUT) {\n        return { speed: msPerChar, steps: 1 };\n    }\n\n    const steps = Math.max(1, MINIMUM_TIMEOUT / msPerChar);\n    return { speed: MINIMUM_TIMEOUT, steps };\n};\n\ninterface CalculateEMAProps {\n    currentEMA: number;\n    newValue: number;\n    alpha?: number;\n}\n\nexport const calculateEMA = ({ currentEMA, newValue, alpha = 0.25 }: CalculateEMAProps): number =>\n    alpha * newValue + (1 - alpha) * currentEMA;\n\nexport interface ChunkStreamingSpeedState {\n    lastTimestamp?: number;\n    lastLength: number;\n    ema: number;\n}\n\ninterface ChunkStreamingSpeedProps {\n    currentLength: number;\n    state: ChunkStreamingSpeedState;\n}\n\nexport const updateChunkStreamingSpeedEMA = ({\n    currentLength,\n    state,\n}: ChunkStreamingSpeedProps): ChunkStreamingSpeedState => {\n    const now = Date.now();\n    const deltaTime = now - (state?.lastTimestamp ?? now);\n\n    if (deltaTime <= 0) return { ...state, lastTimestamp: now };\n\n    const deltaLength = currentLength - state.lastLength;\n\n    const charsPerSecond = Math.max(0, (deltaLength / deltaTime) * 1000);\n\n    const newEMA = calculateEMA({\n        currentEMA: state.ema,\n        newValue: charsPerSecond,\n    });\n\n    return {\n        lastTimestamp: now,\n        lastLength: currentLength,\n        ema: newEMA,\n    };\n};\n"],"mappings":"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","ignoreList":[]}

package/lib/esm/components/typewriter/{typewrite-view/animated-typewriter-text/AnimatedTypewriterText.js → AnimatedTypewriterText.js}

@@ -1,5 +1,5 @@
 import React, { useCallback, useMemo } from 'react';
-import { StyledTypewriterText } from '../TypewriterView.styles';
+import { StyledTypewriterText } from './Typewriter.styles';
 const AnimatedTypewriterText = ({
   shouldHideCursor,
   shownText,

package/lib/esm/components/typewriter/AnimatedTypewriterText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedTypewriterText.js","names":["React","useCallback","useMemo","StyledTypewriterText","AnimatedTypewriterText","shouldHideCursor","shownText","shouldRemainSingleLine","textStyle","updateTypewriterCursor","ref","traverseNodes","node","nodeType","Node","TEXT_NODE","textContent","trim","parentElement","childNodes","Array","from","i","length","result","lastParentWithContent","classList","remove","querySelectorAll","forEach","element","add","createElement","dangerouslySetInnerHTML","__html","$shouldRemainSingleLine","style","$isAnimatingText"],"sources":["../../../../src/components/typewriter/AnimatedTypewriterText.tsx"],"sourcesContent":["import React, { FC, useCallback, useMemo } from 'react';\nimport { CSSPropertiesWithVars } from 'styled-components/dist/types';\nimport { StyledTypewriterText } from './Typewriter.styles';\n\ntype AnimatedTypewriterTextProps = {\n    shouldHideCursor: boolean;\n    shownText: string;\n    textStyle?: CSSPropertiesWithVars;\n    shouldRemainSingleLine: boolean;\n};\n\nconst AnimatedTypewriterText: FC<AnimatedTypewriterTextProps> = ({\n    shouldHideCursor,\n    shownText,\n    shouldRemainSingleLine,\n    textStyle,\n}) => {\n    const updateTypewriterCursor = useCallback(\n        (ref: HTMLSpanElement | null) => {\n            if (ref && !shouldHideCursor) {\n                // Finds the last text node with content.\n                const traverseNodes = (node: Node): HTMLElement | null => {\n                    if (node.nodeType === Node.TEXT_NODE && node.textContent?.trim()) {\n                        return node.parentElement;\n                    }\n\n                    const childNodes = Array.from(node.childNodes);\n                    for (let i = childNodes.length - 1; i >= 0; i--) {\n                        const result = traverseNodes(childNodes[i] as Node);\n                        if (result) {\n                            return result;\n                        }\n                    }\n\n                    return null;\n                };\n\n                const lastParentWithContent = traverseNodes(ref);\n\n                // Removes lastWithContent class from all elements\n                ref.classList.remove('typewriter-lastWithContent');\n                ref.querySelectorAll('.lastWithContent').forEach((element) => {\n                    element.classList.remove('typewriter-lastWithContent');\n                });\n\n                // Adds lastWithContent class to the last element with content\n                if (lastParentWithContent) {\n                    lastParentWithContent.classList.add('typewriter-lastWithContent');\n                } else {\n                    ref.classList.add('typewriter-lastWithContent');\n                }\n            }\n        },\n        [shouldHideCursor],\n    );\n\n    return useMemo(\n        () => (\n            <StyledTypewriterText\n                ref={(ref) => updateTypewriterCursor(ref)}\n                dangerouslySetInnerHTML={{ __html: shownText }}\n                $shouldRemainSingleLine={shouldRemainSingleLine}\n                style={textStyle}\n                $isAnimatingText\n            />\n        ),\n        [shownText, shouldRemainSingleLine, textStyle, updateTypewriterCursor],\n    );\n};\n\nexport default AnimatedTypewriterText;\n"],"mappings":"AAAA,OAAOA,KAAK,IAAQC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AAEvD,SAASC,oBAAoB,QAAQ,qBAAqB;AAS1D,MAAMC,sBAAuD,GAAGA,CAAC;EAC7DC,gBAAgB;EAChBC,SAAS;EACTC,sBAAsB;EACtBC;AACJ,CAAC,KAAK;EACF,MAAMC,sBAAsB,GAAGR,WAAW,CACrCS,GAA2B,IAAK;IAC7B,IAAIA,GAAG,IAAI,CAACL,gBAAgB,EAAE;MAC1B;MACA,MAAMM,aAAa,GAAIC,IAAU,IAAyB;QACtD,IAAIA,IAAI,CAACC,QAAQ,KAAKC,IAAI,CAACC,SAAS,IAAIH,IAAI,CAACI,WAAW,EAAEC,IAAI,CAAC,CAAC,EAAE;UAC9D,OAAOL,IAAI,CAACM,aAAa;QAC7B;QAEA,MAAMC,UAAU,GAAGC,KAAK,CAACC,IAAI,CAACT,IAAI,CAACO,UAAU,CAAC;QAC9C,KAAK,IAAIG,CAAC,GAAGH,UAAU,CAACI,MAAM,GAAG,CAAC,EAAED,CAAC,IAAI,CAAC,EAAEA,CAAC,EAAE,EAAE;UAC7C,MAAME,MAAM,GAAGb,aAAa,CAACQ,UAAU,CAACG,CAAC,CAAS,CAAC;UACnD,IAAIE,MAAM,EAAE;YACR,OAAOA,MAAM;UACjB;QACJ;QAEA,OAAO,IAAI;MACf,CAAC;MAED,MAAMC,qBAAqB,GAAGd,aAAa,CAACD,GAAG,CAAC;;MAEhD;MACAA,GAAG,CAACgB,SAAS,CAACC,MAAM,CAAC,4BAA4B,CAAC;MAClDjB,GAAG,CAACkB,gBAAgB,CAAC,kBAAkB,CAAC,CAACC,OAAO,CAAEC,OAAO,IAAK;QAC1DA,OAAO,CAACJ,SAAS,CAACC,MAAM,CAAC,4BAA4B,CAAC;MAC1D,CAAC,CAAC;;MAEF;MACA,IAAIF,qBAAqB,EAAE;QACvBA,qBAAqB,CAACC,SAAS,CAACK,GAAG,CAAC,4BAA4B,CAAC;MACrE,CAAC,MAAM;QACHrB,GAAG,CAACgB,SAAS,CAACK,GAAG,CAAC,4BAA4B,CAAC;MACnD;IACJ;EACJ,CAAC,EACD,CAAC1B,gBAAgB,CACrB,CAAC;EAED,OAAOH,OAAO,CACV,mBACIF,KAAA,CAAAgC,aAAA,CAAC7B,oBAAoB;IACjBO,GAAG,EAAGA,GAAG,IAAKD,sBAAsB,CAACC,GAAG,CAAE;IAC1CuB,uBAAuB,EAAE;MAAEC,MAAM,EAAE5B;IAAU,CAAE;IAC/C6B,uBAAuB,EAAE5B,sBAAuB;IAChD6B,KAAK,EAAE5B,SAAU;IACjB6B,gBAAgB;EAAA,CACnB,CACJ,EACD,CAAC/B,SAAS,EAAEC,sBAAsB,EAAEC,SAAS,EAAEC,sBAAsB,CACzE,CAAC;AACL,CAAC;AAED,eAAeL,sBAAsB","ignoreList":[]}

package/lib/esm/components/typewriter/Typewriter.js

@@ -1,12 +1,14 @@
 import { ColorSchemeProvider, useColorScheme } from '@chayns-components/core';
 import { ChaynsProvider, useFunctions, useValues } from 'chayns-api';
-import React, { useCallback, useMemo, useState } from 'react';
+import React, { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { createPortal } from 'react-dom';
 import { renderToString } from 'react-dom/server';
 import { CursorType } from '../../types/cursor';
 import { TypewriterDelay, TypewriterSpeed } from '../../types/speed';
-import TypewriterView from './typewrite-view/TypewriterView';
-import useTypewriterAnimation from '../../hooks/useTypewriterAnimation';
-import { getCharactersCount, getSubTextFromHTML, shuffleArray } from '../../utils/utils';
+import AnimatedTypewriterText from './AnimatedTypewriterText';
+import { StyledTypewriter, StyledTypewriterPseudoText, StyledTypewriterText } from './Typewriter.styles';
+import { calculateAutoSpeed, getCharactersCount, getSubTextFromHTML, shuffleArray, updateChunkStreamingSpeedEMA } from './utils';
+const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
 const Typewriter = ({
   children,
   cursorType = CursorType.Default,
@@ -34,99 +36,247 @@ const Typewriter = ({
   autoSpeedBaseFactor = 2000
 }) => {
   const [currentChildrenIndex, setCurrentChildrenIndex] = useState(0);
+  const [hasRenderedChildrenOnce, setHasRenderedChildrenOnce] = useState(false);
+  const [shouldPreventBlinkingCursor, setShouldPreventBlinkingCursor] = useState(false);
+  const [isResetAnimationActive, setIsResetAnimationActive] = useState(false);
+  const [shouldStopAnimation, setShouldStopAnimation] = useState(false);
+  const autoSpeed = useRef();
+  const autoSteps = useRef(animationSteps);
   const functions = useFunctions();
   const values = useValues();
   const colorScheme = useColorScheme();
+  useIsomorphicLayoutEffect(() => {
+    if (children) {
+      setHasRenderedChildrenOnce(false);
+    }
+  }, [children]);
+  useEffect(() => {
+    if (!hasRenderedChildrenOnce) {
+      setHasRenderedChildrenOnce(true);
+    }
+  }, [hasRenderedChildrenOnce]);
   const sortedChildren = useMemo(() => Array.isArray(children) && shouldSortChildrenRandomly ? shuffleArray(children) : children, [children, shouldSortChildrenRandomly]);
   const areMultipleChildrenGiven = Array.isArray(sortedChildren);
   const childrenCount = areMultipleChildrenGiven ? sortedChildren.length : 1;
-  const renderChildToString = useCallback(child => /*#__PURE__*/React.isValidElement(child) ? renderToString(/*#__PURE__*/React.createElement(ChaynsProvider, {
-    data: values,
-    functions: functions,
-    isModule: true
-  }, /*#__PURE__*/React.createElement(ColorSchemeProvider, {
-    color: colorScheme?.designSettings?.color,
-    colorMode: colorScheme?.designSettings?.colorMode,
-    style: {
-      display: 'inline'
-    }
-  }, /*#__PURE__*/React.createElement("span", {
-    className: "notranslate"
-  }, child)))) : child, [colorScheme?.designSettings?.color, colorScheme?.designSettings?.colorMode, functions, values]);
-  const handleSetNextChildrenIndex = useCallback(() => setCurrentChildrenIndex(prevIndex => {
-    let newIndex = prevIndex + 1;
-    if (newIndex > childrenCount - 1) {
-      newIndex = 0;
-    }
-    return newIndex;
-  }), [childrenCount]);
   const textContent = useMemo(() => {
     if (areMultipleChildrenGiven) {
       const currentChildren = sortedChildren[currentChildrenIndex];
       if (currentChildren) {
-        return renderChildToString(currentChildren);
+        return /*#__PURE__*/React.isValidElement(currentChildren) ? renderToString(/*#__PURE__*/React.createElement(ChaynsProvider, {
+          data: values,
+          functions: functions,
+          isModule: true
+        }, /*#__PURE__*/React.createElement(ColorSchemeProvider, {
+          color: colorScheme?.designSettings?.color,
+          colorMode: colorScheme?.designSettings?.colorMode,
+          style: {
+            display: 'inline'
+          }
+        }, /*#__PURE__*/React.createElement("span", {
+          className: "notranslate"
+        }, currentChildren)))) : currentChildren;
       }
       return '';
     }
-    return renderChildToString(sortedChildren);
-  }, [areMultipleChildrenGiven, currentChildrenIndex, renderChildToString, sortedChildren]);
+    return /*#__PURE__*/React.isValidElement(sortedChildren) ? renderToString(/*#__PURE__*/React.createElement(ChaynsProvider, {
+      data: values,
+      functions: functions,
+      isModule: true
+    }, /*#__PURE__*/React.createElement(ColorSchemeProvider, {
+      color: colorScheme?.designSettings?.color,
+      colorMode: colorScheme?.designSettings?.colorMode,
+      style: {
+        display: 'inline'
+      }
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "notranslate"
+    }, sortedChildren)))) : sortedChildren;
+  }, [areMultipleChildrenGiven, colorScheme?.designSettings?.color, colorScheme?.designSettings?.colorMode, currentChildrenIndex, functions, sortedChildren, values]);
   const charactersCount = useMemo(() => getCharactersCount(textContent), [textContent]);
-  const {
-    effectiveShownCharCount,
-    hasRenderedChildrenOnce,
-    handleClick,
-    isAnimatingText,
-    isTypingAnimationActive,
-    shouldPreventBlinkingCursor
-  } = useTypewriterAnimation({
-    autoSpeedBaseFactor,
-    charactersCount,
-    childrenKey: children,
-    childrenCount,
-    currentTextLength: textContent.length,
-    cursorType,
-    nextTextDelay,
-    onAdvanceChild: handleSetNextChildrenIndex,
-    onFinish,
-    onResetAnimationEnd,
-    onResetAnimationStart,
-    onTypingAnimationEnd,
-    onTypingAnimationStart,
-    resetDelay,
-    resetSpeed,
-    shouldCalcAutoSpeed,
-    shouldForceCursorAnimation,
-    shouldUseResetAnimation,
-    shouldWaitForContent,
-    speed,
-    startDelay
+  const chunkIntervalExponentialMovingAverage = useRef({
+    lastLength: charactersCount,
+    ema: charactersCount / (autoSpeedBaseFactor / 1000)
   });
-  const shownText = useMemo(() => getSubTextFromHTML(textContent, effectiveShownCharCount) || '​', [effectiveShownCharCount, textContent]);
+  const [shownCharCount, setShownCharCount] = useState(charactersCount > 0 ? 0 : textContent.length);
+  const currentPosition = useRef(0);
+  useEffect(() => {
+    if (shouldUseResetAnimation) {
+      chunkIntervalExponentialMovingAverage.current = {
+        ema: charactersCount / (autoSpeedBaseFactor / 1000),
+        lastLength: charactersCount
+      };
+    }
+    chunkIntervalExponentialMovingAverage.current = updateChunkStreamingSpeedEMA({
+      currentLength: charactersCount,
+      state: chunkIntervalExponentialMovingAverage.current
+    });
+  }, [autoSpeedBaseFactor, charactersCount, shouldUseResetAnimation]);
+  useEffect(() => {
+    if (!shouldCalcAutoSpeed) {
+      autoSpeed.current = undefined;
+      autoSteps.current = animationSteps;
+      return;
+    }
+    const {
+      speed: calculatedAutoSpeed,
+      steps
+    } = calculateAutoSpeed(chunkIntervalExponentialMovingAverage.current.ema);
+    autoSpeed.current = calculatedAutoSpeed;
+    autoSteps.current = steps;
+  }, [animationSteps, charactersCount, shouldCalcAutoSpeed]);
+  const isAnimatingText = shownCharCount < textContent.length || shouldForceCursorAnimation || areMultipleChildrenGiven || textContent.length === 0;
+  const handleClick = useCallback(event => {
+    event.stopPropagation();
+    event.preventDefault();
+    setShouldStopAnimation(true);
+  }, []);
+  const handleSetNextChildrenIndex = useCallback(() => setCurrentChildrenIndex(() => {
+    let newIndex = currentChildrenIndex + 1;
+    if (newIndex > childrenCount - 1) {
+      newIndex = 0;
+    }
+    return newIndex;
+  }), [childrenCount, currentChildrenIndex]);
+  useEffect(() => {
+    let interval;
+    if (shouldStopAnimation || charactersCount === 0) {
+      setShownCharCount(textContent.length);
+      currentPosition.current = textContent.length;
+    } else if (isResetAnimationActive) {
+      if (typeof onResetAnimationStart === 'function') {
+        onResetAnimationStart();
+      }
+      interval = window.setInterval(() => {
+        setShownCharCount(prevState => {
+          const nextState = prevState - autoSteps.current;
+          currentPosition.current = nextState;
+          if (nextState === 0) {
+            window.clearInterval(interval);
+            if (typeof onResetAnimationEnd === 'function') {
+              onResetAnimationEnd();
+            }
+            if (areMultipleChildrenGiven) {
+              setTimeout(() => {
+                setIsResetAnimationActive(false);
+                handleSetNextChildrenIndex();
+              }, nextTextDelay);
+            }
+          }
+          return nextState;
+        });
+      }, resetSpeed);
+    } else {
+      const startTypingAnimation = () => {
+        if (cursorType === CursorType.Thin) {
+          setShouldPreventBlinkingCursor(true);
+        }
+        if (typeof onTypingAnimationStart === 'function') {
+          onTypingAnimationStart();
+        }
+        const runTypingInterval = () => {
+          setShownCharCount(prevState => {
+            let nextState = Math.min(prevState + autoSteps.current, charactersCount);
+            if (nextState >= charactersCount && !shouldWaitForContent) {
+              window.clearInterval(interval);
+              if (cursorType === CursorType.Thin) {
+                setShouldPreventBlinkingCursor(false);
+              }
+              if (typeof onTypingAnimationEnd === 'function') {
+                onTypingAnimationEnd();
+              }
+
+              /**
+               * At this point, the next value for "shownCharCount" is deliberately set to
+               * the length of the textContent to correctly display HTML elements
+               * after the last letter.
+               */
+              nextState = textContent.length;
+              if (areMultipleChildrenGiven) {
+                setTimeout(() => {
+                  if (shouldUseResetAnimation) {
+                    setIsResetAnimationActive(true);
+                  } else {
+                    setShownCharCount(0);
+                    setTimeout(handleSetNextChildrenIndex, nextTextDelay);
+                  }
+                }, resetDelay);
+              }
+            }
+            currentPosition.current = nextState;
+            return nextState;
+          });
+        };
+        interval = window.setInterval(runTypingInterval, autoSpeed.current ?? speed);
+      };
+      if (startDelay) {
+        setTimeout(startTypingAnimation, startDelay);
+      } else {
+        startTypingAnimation();
+      }
+    }
+    return () => {
+      window.clearInterval(interval);
+    };
+  }, [areMultipleChildrenGiven, autoSteps, charactersCount, cursorType, handleSetNextChildrenIndex, isResetAnimationActive, nextTextDelay, onResetAnimationEnd, onResetAnimationStart, onTypingAnimationEnd, onTypingAnimationStart, resetDelay, resetSpeed, shouldStopAnimation, shouldUseResetAnimation, shouldWaitForContent, speed, startDelay, textContent.length]);
+  useEffect(() => {
+    if (!isAnimatingText && typeof onFinish === 'function') {
+      onFinish();
+    }
+  }, [isAnimatingText, onFinish]);
+  const shownText = useMemo(() => getSubTextFromHTML(textContent, shownCharCount), [shownCharCount, textContent]);
   const pseudoTextHTML = useMemo(() => {
     if (pseudoChildren) {
-      const pseudoText = renderChildToString(pseudoChildren);
+      const pseudoText = /*#__PURE__*/React.isValidElement(pseudoChildren) ? renderToString(/*#__PURE__*/React.createElement(ChaynsProvider, {
+        data: values,
+        functions: functions,
+        isModule: true
+      }, /*#__PURE__*/React.createElement(ColorSchemeProvider, {
+        color: colorScheme?.designSettings?.color,
+        colorMode: colorScheme?.designSettings?.colorMode,
+        style: {
+          display: 'inline'
+        }
+      }, pseudoChildren))) : pseudoChildren;
       if (shouldUseAnimationHeight) {
-        return getSubTextFromHTML(pseudoText, effectiveShownCharCount);
+        return getSubTextFromHTML(pseudoText, shownCharCount);
       }
       return pseudoText;
     }
     if (shouldUseAnimationHeight && textContent) {
-      return getSubTextFromHTML(textContent, effectiveShownCharCount);
+      return getSubTextFromHTML(textContent, shownCharCount);
     }
     return textContent || '&#8203;';
-  }, [effectiveShownCharCount, pseudoChildren, renderChildToString, shouldUseAnimationHeight, textContent]);
-  return /*#__PURE__*/React.createElement(TypewriterView, {
-    cursorType: cursorType,
-    handleClick: isTypingAnimationActive ? handleClick : undefined,
-    hasRenderedChildrenOnce: hasRenderedChildrenOnce,
-    isAnimatingText: isAnimatingText,
-    pseudoTextHTML: pseudoTextHTML,
+  }, [colorScheme?.designSettings?.color, colorScheme?.designSettings?.colorMode, functions, pseudoChildren, shouldUseAnimationHeight, shownCharCount, textContent, values]);
+  return useMemo(() => /*#__PURE__*/React.createElement(StyledTypewriter, {
+    $cursorType: cursorType,
+    onClick: isAnimatingText ? handleClick : undefined,
+    $isAnimatingText: isAnimatingText,
+    $shouldHideCursor: shouldHideCursor,
+    $shouldPreventBlinkAnimation: shouldPreventBlinkingCursor
+  }, isAnimatingText ? /*#__PURE__*/React.createElement(AnimatedTypewriterText, {
     shouldHideCursor: shouldHideCursor,
-    shouldPreventBlinkingCursor: shouldPreventBlinkingCursor,
     shouldRemainSingleLine: shouldRemainSingleLine,
     shownText: shownText,
     textStyle: textStyle
-  }, sortedChildren);
+  }) : /*#__PURE__*/React.createElement(StyledTypewriterText, {
+    className: "notranslate",
+    $shouldRemainSingleLine: shouldRemainSingleLine,
+    dangerouslySetInnerHTML: typeof sortedChildren === 'string' ? {
+      __html: shownText
+    } : undefined,
+    style: textStyle
+  }, typeof sortedChildren !== 'string' ? sortedChildren : undefined), isAnimatingText && /*#__PURE__*/React.createElement(StyledTypewriterPseudoText, {
+    $isAnimatingText: isAnimatingText,
+    $shouldHideCursor: shouldHideCursor,
+    dangerouslySetInnerHTML: {
+      __html: pseudoTextHTML
+    }
+  }), !hasRenderedChildrenOnce && /*#__PURE__*/createPortal(/*#__PURE__*/React.createElement("div", {
+    style: {
+      position: 'absolute',
+      visibility: 'hidden'
+    }
+  }, children), document.body)), [children, cursorType, handleClick, hasRenderedChildrenOnce, isAnimatingText, pseudoTextHTML, shouldHideCursor, shouldPreventBlinkingCursor, shouldRemainSingleLine, shownText, sortedChildren, textStyle]);
 };
 Typewriter.displayName = 'Typewriter';
 export default Typewriter;

package/lib/esm/components/typewriter/Typewriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Typewriter.js","names":["ColorSchemeProvider","useColorScheme","ChaynsProvider","useFunctions","useValues","React","useCallback","useMemo","useState","renderToString","CursorType","TypewriterDelay","TypewriterSpeed","TypewriterView","useTypewriterAnimation","getCharactersCount","getSubTextFromHTML","shuffleArray","Typewriter","children","cursorType","Default","nextTextDelay","Medium","onFinish","onResetAnimationEnd","animationSteps","onResetAnimationStart","onTypingAnimationEnd","onTypingAnimationStart","pseudoChildren","resetDelay","shouldForceCursorAnimation","shouldHideCursor","shouldRemainSingleLine","shouldSortChildrenRandomly","shouldUseAnimationHeight","shouldUseResetAnimation","shouldWaitForContent","speed","resetSpeed","startDelay","None","textStyle","shouldCalcAutoSpeed","autoSpeedBaseFactor","currentChildrenIndex","setCurrentChildrenIndex","functions","values","colorScheme","sortedChildren","Array","isArray","areMultipleChildrenGiven","childrenCount","length","renderChildToString","child","isValidElement","createElement","data","isModule","color","designSettings","colorMode","style","display","className","handleSetNextChildrenIndex","prevIndex","newIndex","textContent","currentChildren","charactersCount","effectiveShownCharCount","hasRenderedChildrenOnce","handleClick","isAnimatingText","isTypingAnimationActive","shouldPreventBlinkingCursor","childrenKey","currentTextLength","onAdvanceChild","shownText","pseudoTextHTML","pseudoText","undefined","displayName"],"sources":["../../../../src/components/typewriter/Typewriter.tsx"],"sourcesContent":["import { ColorSchemeProvider, useColorScheme } from '@chayns-components/core';\nimport { ChaynsProvider, useFunctions, useValues } from 'chayns-api';\nimport React, { FC, ReactElement, useCallback, useMemo, useState } from 'react';\nimport { renderToString } from 'react-dom/server';\nimport { CSSPropertiesWithVars } from 'styled-components/dist/types';\nimport { CursorType } from '../../types/cursor';\nimport { TypewriterDelay, TypewriterSpeed } from '../../types/speed';\nimport TypewriterView from './typewrite-view/TypewriterView';\nimport useTypewriterAnimation from '../../hooks/useTypewriterAnimation';\nimport { getCharactersCount, getSubTextFromHTML, shuffleArray } from '../../utils/utils';\n\nexport type TypewriterProps = {\n    /**\n     * The number of characters that will be animated per animation cycle.\n     */\n    animationSteps?: number;\n    /**\n     * The text to type\n     */\n    children: ReactElement | ReactElement[] | string | string[];\n    /**\n     * The type of the cursor. Use the CursorType enum for this prop.\n     */\n    cursorType?: CursorType;\n    /**\n     * The delay in milliseconds before the next text is shown.\n     * This prop is only used if multiple texts are given.\n     */\n    nextTextDelay?: TypewriterDelay;\n    /**\n     * Function that is executed when the typewriter animation has finished. This function will not\n     * be executed if multiple texts are used.\n     */\n    onFinish?: VoidFunction;\n    /**\n     * Function that is executed when the reset animation has finished. This function will not be\n     * executed if `shouldUseResetAnimation` is not set to `true`.\n     */\n    onResetAnimationEnd?: VoidFunction;\n    /**\n     * Function that is executed when the reset animation has started. This function will not be\n     * executed if `shouldUseResetAnimation` is not set to `true`.\n     */\n    onResetAnimationStart?: VoidFunction;\n    /**\n     * Function that is executed when the typing animation has finished. If multiple texts are given,\n     * this function will be executed for each text.\n     */\n    onTypingAnimationEnd?: VoidFunction;\n    /**\n     * Function that is executed when the typing animation has started. If multiple texts are given,\n     * this function will be executed for each text.\n     */\n    onTypingAnimationStart?: VoidFunction;\n    /**\n     * Pseudo-element to be rendered invisible during animation to define the size of the element\n     * for the typewriter effect. By default, the \"children\" is used for this purpose.\n     */\n    pseudoChildren?: ReactElement | string;\n    /**\n     * Waiting time in milliseconds before the typewriter resets the text.\n     * This prop is only used if multiple texts are given.\n     */\n    resetDelay?: TypewriterDelay;\n    /**\n     * The reset speed of the animation. Use the TypewriterSpeed enum for this prop.\n     */\n    resetSpeed?: TypewriterSpeed | number;\n    /**\n     * Specifies whether the cursor should be forced to animate even if no text is currently animated.\n     */\n    shouldForceCursorAnimation?: boolean;\n    /**\n     * Specifies whether the cursor should be hidden\n     */\n    shouldHideCursor?: boolean;\n    /**\n     * Whether the content should remain a single line.\n     */\n    shouldRemainSingleLine?: boolean;\n    /**\n     * Specifies whether the children should be sorted randomly if there are multiple texts.\n     * This makes the typewriter start with a different text each time and also changes them\n     * in a random order.\n     */\n    shouldSortChildrenRandomly?: boolean;\n    /**\n     * Specifies whether the animation should use its full height or the height of the current\n     * chunk.\n     */\n    shouldUseAnimationHeight?: boolean;\n    /**\n     * Whether the animation speed should be calculated with the chunk interval.\n     */\n    shouldCalcAutoSpeed?: boolean;\n    /**\n     * Sets how long the animation should last when `shouldCalcAutoSpeed` is enabled in milliseconds.\n     * When chunks are streamed, this value will only be used for the initial speed and then change to the speed characters are added at\n     */\n    autoSpeedBaseFactor?: number;\n    /**\n     * Specifies whether the reset of the text should be animated with a backspace animation for\n     * multiple texts.\n     */\n    shouldUseResetAnimation?: boolean;\n    /**\n     * Whether the typewriter should wait for new content\n     */\n    shouldWaitForContent?: boolean;\n    /**\n     * The speed of the animation. Use the TypewriterSpeed enum for this prop.\n     */\n    speed?: TypewriterSpeed | number;\n    /**\n     * The delay in milliseconds before the typewriter starts typing.\n     */\n    startDelay?: TypewriterDelay;\n    /**\n     * The style of the typewriter text element\n     */\n    textStyle?: CSSPropertiesWithVars;\n};\n\nconst Typewriter: FC<TypewriterProps> = ({\n    children,\n    cursorType = CursorType.Default,\n    nextTextDelay = TypewriterDelay.Medium,\n    onFinish,\n    onResetAnimationEnd,\n    animationSteps = 1,\n    onResetAnimationStart,\n    onTypingAnimationEnd,\n    onTypingAnimationStart,\n    pseudoChildren,\n    resetDelay = TypewriterDelay.Medium,\n    shouldForceCursorAnimation = false,\n    shouldHideCursor = false,\n    shouldRemainSingleLine = false,\n    shouldSortChildrenRandomly = false,\n    shouldUseAnimationHeight = false,\n    shouldUseResetAnimation = false,\n    shouldWaitForContent,\n    speed = TypewriterSpeed.Medium,\n    resetSpeed = speed,\n    startDelay = TypewriterDelay.None,\n    textStyle,\n    shouldCalcAutoSpeed = false,\n    autoSpeedBaseFactor = 2000,\n}) => {\n    const [currentChildrenIndex, setCurrentChildrenIndex] = useState(0);\n\n    const functions = useFunctions();\n    const values = useValues();\n\n    const colorScheme = useColorScheme();\n\n    const sortedChildren = useMemo(\n        () =>\n            Array.isArray(children) && shouldSortChildrenRandomly\n                ? shuffleArray<ReactElement | string>(children)\n                : children,\n        [children, shouldSortChildrenRandomly],\n    );\n\n    const areMultipleChildrenGiven = Array.isArray(sortedChildren);\n    const childrenCount = areMultipleChildrenGiven ? sortedChildren.length : 1;\n\n    const renderChildToString = useCallback(\n        (child: ReactElement | ReactElement[] | string | string[]) =>\n            React.isValidElement(child)\n                ? renderToString(\n                      <ChaynsProvider data={values} functions={functions} isModule>\n                          <ColorSchemeProvider\n                              color={colorScheme?.designSettings?.color}\n                              colorMode={colorScheme?.designSettings?.colorMode}\n                              style={{ display: 'inline' }}\n                          >\n                              <span className=\"notranslate\">{child}</span>\n                          </ColorSchemeProvider>\n                      </ChaynsProvider>,\n                  )\n                : (child as string),\n        [\n            colorScheme?.designSettings?.color,\n            colorScheme?.designSettings?.colorMode,\n            functions,\n            values,\n        ],\n    );\n\n    const handleSetNextChildrenIndex = useCallback(\n        () =>\n            setCurrentChildrenIndex((prevIndex) => {\n                let newIndex = prevIndex + 1;\n\n                if (newIndex > childrenCount - 1) {\n                    newIndex = 0;\n                }\n\n                return newIndex;\n            }),\n        [childrenCount],\n    );\n\n    const textContent = useMemo(() => {\n        if (areMultipleChildrenGiven) {\n            const currentChildren = sortedChildren[currentChildrenIndex];\n\n            if (currentChildren) {\n                return renderChildToString(currentChildren);\n            }\n\n            return '';\n        }\n\n        return renderChildToString(sortedChildren);\n    }, [areMultipleChildrenGiven, currentChildrenIndex, renderChildToString, sortedChildren]);\n\n    const charactersCount = useMemo(() => getCharactersCount(textContent), [textContent]);\n\n    const {\n        effectiveShownCharCount,\n        hasRenderedChildrenOnce,\n        handleClick,\n        isAnimatingText,\n        isTypingAnimationActive,\n        shouldPreventBlinkingCursor,\n    } = useTypewriterAnimation({\n        autoSpeedBaseFactor,\n        charactersCount,\n        childrenKey: children,\n        childrenCount,\n        currentTextLength: textContent.length,\n        cursorType,\n        nextTextDelay,\n        onAdvanceChild: handleSetNextChildrenIndex,\n        onFinish,\n        onResetAnimationEnd,\n        onResetAnimationStart,\n        onTypingAnimationEnd,\n        onTypingAnimationStart,\n        resetDelay,\n        resetSpeed,\n        shouldCalcAutoSpeed,\n        shouldForceCursorAnimation,\n        shouldUseResetAnimation,\n        shouldWaitForContent,\n        speed,\n        startDelay,\n    });\n\n    const shownText = useMemo(\n        () => getSubTextFromHTML(textContent, effectiveShownCharCount) || '&#8203;',\n        [effectiveShownCharCount, textContent],\n    );\n\n    const pseudoTextHTML = useMemo(() => {\n        if (pseudoChildren) {\n            const pseudoText = renderChildToString(pseudoChildren);\n\n            if (shouldUseAnimationHeight) {\n                return getSubTextFromHTML(pseudoText, effectiveShownCharCount);\n            }\n\n            return pseudoText;\n        }\n\n        if (shouldUseAnimationHeight && textContent) {\n            return getSubTextFromHTML(textContent, effectiveShownCharCount);\n        }\n\n        return textContent || '&#8203;';\n    }, [\n        effectiveShownCharCount,\n        pseudoChildren,\n        renderChildToString,\n        shouldUseAnimationHeight,\n        textContent,\n    ]);\n\n    return (\n        <TypewriterView\n            cursorType={cursorType}\n            handleClick={isTypingAnimationActive ? handleClick : undefined}\n            hasRenderedChildrenOnce={hasRenderedChildrenOnce}\n            isAnimatingText={isAnimatingText}\n            pseudoTextHTML={pseudoTextHTML}\n            shouldHideCursor={shouldHideCursor}\n            shouldPreventBlinkingCursor={shouldPreventBlinkingCursor}\n            shouldRemainSingleLine={shouldRemainSingleLine}\n            shownText={shownText}\n            textStyle={textStyle}\n        >\n            {sortedChildren}\n        </TypewriterView>\n    );\n};\n\nTypewriter.displayName = 'Typewriter';\n\nexport default Typewriter;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Typewriter.js","names":["ColorSchemeProvider","useColorScheme","ChaynsProvider","useFunctions","useValues","React","useCallback","useEffect","useLayoutEffect","useMemo","useRef","useState","createPortal","renderToString","CursorType","TypewriterDelay","TypewriterSpeed","AnimatedTypewriterText","StyledTypewriter","StyledTypewriterPseudoText","StyledTypewriterText","calculateAutoSpeed","getCharactersCount","getSubTextFromHTML","shuffleArray","updateChunkStreamingSpeedEMA","useIsomorphicLayoutEffect","window","Typewriter","children","cursorType","Default","nextTextDelay","Medium","onFinish","onResetAnimationEnd","animationSteps","onResetAnimationStart","onTypingAnimationEnd","onTypingAnimationStart","pseudoChildren","resetDelay","shouldForceCursorAnimation","shouldHideCursor","shouldRemainSingleLine","shouldSortChildrenRandomly","shouldUseAnimationHeight","shouldUseResetAnimation","shouldWaitForContent","speed","resetSpeed","startDelay","None","textStyle","shouldCalcAutoSpeed","autoSpeedBaseFactor","currentChildrenIndex","setCurrentChildrenIndex","hasRenderedChildrenOnce","setHasRenderedChildrenOnce","shouldPreventBlinkingCursor","setShouldPreventBlinkingCursor","isResetAnimationActive","setIsResetAnimationActive","shouldStopAnimation","setShouldStopAnimation","autoSpeed","autoSteps","functions","values","colorScheme","sortedChildren","Array","isArray","areMultipleChildrenGiven","childrenCount","length","textContent","currentChildren","isValidElement","createElement","data","isModule","color","designSettings","colorMode","style","display","className","charactersCount","chunkIntervalExponentialMovingAverage","lastLength","ema","shownCharCount","setShownCharCount","currentPosition","current","currentLength","state","undefined","calculatedAutoSpeed","steps","isAnimatingText","handleClick","event","stopPropagation","preventDefault","handleSetNextChildrenIndex","newIndex","interval","setInterval","prevState","nextState","clearInterval","setTimeout","startTypingAnimation","Thin","runTypingInterval","Math","min","shownText","pseudoTextHTML","pseudoText","$cursorType","onClick","$isAnimatingText","$shouldHideCursor","$shouldPreventBlinkAnimation","$shouldRemainSingleLine","dangerouslySetInnerHTML","__html","position","visibility","document","body","displayName"],"sources":["../../../../src/components/typewriter/Typewriter.tsx"],"sourcesContent":["import { ColorSchemeProvider, useColorScheme } from '@chayns-components/core';\nimport { ChaynsProvider, useFunctions, useValues } from 'chayns-api';\nimport React, {\n    FC,\n    ReactElement,\n    useCallback,\n    useEffect,\n    useLayoutEffect,\n    useMemo,\n    useRef,\n    useState,\n} from 'react';\nimport { createPortal } from 'react-dom';\nimport { renderToString } from 'react-dom/server';\nimport { CSSPropertiesWithVars } from 'styled-components/dist/types';\nimport { CursorType } from '../../types/cursor';\nimport { TypewriterDelay, TypewriterSpeed } from '../../types/speed';\nimport AnimatedTypewriterText from './AnimatedTypewriterText';\nimport {\n    StyledTypewriter,\n    StyledTypewriterPseudoText,\n    StyledTypewriterText,\n} from './Typewriter.styles';\nimport {\n    calculateAutoSpeed,\n    ChunkStreamingSpeedState,\n    getCharactersCount,\n    getSubTextFromHTML,\n    shuffleArray,\n    updateChunkStreamingSpeedEMA,\n} from './utils';\n\nconst useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n\nexport type TypewriterProps = {\n    /**\n     * The number of characters that will be animated per animation cycle.\n     */\n    animationSteps?: number;\n    /**\n     * The text to type\n     */\n    children: ReactElement | ReactElement[] | string | string[];\n    /**\n     * The type of the cursor. Use the CursorType enum for this prop.\n     */\n    cursorType?: CursorType;\n    /**\n     * The delay in milliseconds before the next text is shown.\n     * This prop is only used if multiple texts are given.\n     */\n    nextTextDelay?: TypewriterDelay;\n    /**\n     * Function that is executed when the typewriter animation has finished. This function will not\n     * be executed if multiple texts are used.\n     */\n    onFinish?: VoidFunction;\n    /**\n     * Function that is executed when the reset animation has finished. This function will not be\n     * executed if `shouldUseResetAnimation` is not set to `true`.\n     */\n    onResetAnimationEnd?: VoidFunction;\n    /**\n     * Function that is executed when the reset animation has started. This function will not be\n     * executed if `shouldUseResetAnimation` is not set to `true`.\n     */\n    onResetAnimationStart?: VoidFunction;\n    /**\n     * Function that is executed when the typing animation has finished. If multiple texts are given,\n     * this function will be executed for each text.\n     */\n    onTypingAnimationEnd?: VoidFunction;\n    /**\n     * Function that is executed when the typing animation has started. If multiple texts are given,\n     * this function will be executed for each text.\n     */\n    onTypingAnimationStart?: VoidFunction;\n    /**\n     * Pseudo-element to be rendered invisible during animation to define the size of the element\n     * for the typewriter effect. By default, the \"children\" is used for this purpose.\n     */\n    pseudoChildren?: ReactElement | string;\n    /**\n     * Waiting time in milliseconds before the typewriter resets the text.\n     * This prop is only used if multiple texts are given.\n     */\n    resetDelay?: TypewriterDelay;\n    /**\n     * The reset speed of the animation. Use the TypewriterSpeed enum for this prop.\n     */\n    resetSpeed?: TypewriterSpeed | number;\n    /**\n     * Specifies whether the cursor should be forced to animate even if no text is currently animated.\n     */\n    shouldForceCursorAnimation?: boolean;\n    /**\n     * Specifies whether the cursor should be hidden\n     */\n    shouldHideCursor?: boolean;\n    /**\n     * Whether the content should remain a single line.\n     */\n    shouldRemainSingleLine?: boolean;\n    /**\n     * Specifies whether the children should be sorted randomly if there are multiple texts.\n     * This makes the typewriter start with a different text each time and also changes them\n     * in a random order.\n     */\n    shouldSortChildrenRandomly?: boolean;\n    /**\n     * Specifies whether the animation should use its full height or the height of the current\n     * chunk.\n     */\n    shouldUseAnimationHeight?: boolean;\n    /**\n     * Whether the animation speed should be calculated with the chunk interval.\n     */\n    shouldCalcAutoSpeed?: boolean;\n    /**\n     * Sets how long the animation should last when `shouldCalcAutoSpeed` is enabled in milliseconds.\n     * When chunks are streamed, this value will only be used for the initial speed and then change to the speed characters are added at\n     */\n    autoSpeedBaseFactor?: number;\n    /**\n     * Specifies whether the reset of the text should be animated with a backspace animation for\n     * multiple texts.\n     */\n    shouldUseResetAnimation?: boolean;\n    /**\n     * Whether the typewriter should wait for new content\n     */\n    shouldWaitForContent?: boolean;\n    /**\n     * The speed of the animation. Use the TypewriterSpeed enum for this prop.\n     */\n    speed?: TypewriterSpeed | number;\n    /**\n     * The delay in milliseconds before the typewriter starts typing.\n     */\n    startDelay?: TypewriterDelay;\n    /**\n     * The style of the typewriter text element\n     */\n    textStyle?: CSSPropertiesWithVars;\n};\n\nconst Typewriter: FC<TypewriterProps> = ({\n    children,\n    cursorType = CursorType.Default,\n    nextTextDelay = TypewriterDelay.Medium,\n    onFinish,\n    onResetAnimationEnd,\n    animationSteps = 1,\n    onResetAnimationStart,\n    onTypingAnimationEnd,\n    onTypingAnimationStart,\n    pseudoChildren,\n    resetDelay = TypewriterDelay.Medium,\n    shouldForceCursorAnimation = false,\n    shouldHideCursor = false,\n    shouldRemainSingleLine = false,\n    shouldSortChildrenRandomly = false,\n    shouldUseAnimationHeight = false,\n    shouldUseResetAnimation = false,\n    shouldWaitForContent,\n    speed = TypewriterSpeed.Medium,\n    resetSpeed = speed,\n    startDelay = TypewriterDelay.None,\n    textStyle,\n    shouldCalcAutoSpeed = false,\n    autoSpeedBaseFactor = 2000,\n}) => {\n    const [currentChildrenIndex, setCurrentChildrenIndex] = useState(0);\n    const [hasRenderedChildrenOnce, setHasRenderedChildrenOnce] = useState(false);\n    const [shouldPreventBlinkingCursor, setShouldPreventBlinkingCursor] = useState(false);\n    const [isResetAnimationActive, setIsResetAnimationActive] = useState(false);\n    const [shouldStopAnimation, setShouldStopAnimation] = useState(false);\n    const autoSpeed = useRef<number>();\n    const autoSteps = useRef<number>(animationSteps);\n\n    const functions = useFunctions();\n    const values = useValues();\n\n    const colorScheme = useColorScheme();\n\n    useIsomorphicLayoutEffect(() => {\n        if (children) {\n            setHasRenderedChildrenOnce(false);\n        }\n    }, [children]);\n\n    useEffect(() => {\n        if (!hasRenderedChildrenOnce) {\n            setHasRenderedChildrenOnce(true);\n        }\n    }, [hasRenderedChildrenOnce]);\n\n    const sortedChildren = useMemo(\n        () =>\n            Array.isArray(children) && shouldSortChildrenRandomly\n                ? shuffleArray<ReactElement | string>(children)\n                : children,\n        [children, shouldSortChildrenRandomly],\n    );\n\n    const areMultipleChildrenGiven = Array.isArray(sortedChildren);\n    const childrenCount = areMultipleChildrenGiven ? sortedChildren.length : 1;\n\n    const textContent = useMemo(() => {\n        if (areMultipleChildrenGiven) {\n            const currentChildren = sortedChildren[currentChildrenIndex];\n\n            if (currentChildren) {\n                return React.isValidElement(currentChildren)\n                    ? renderToString(\n                          <ChaynsProvider data={values} functions={functions} isModule>\n                              <ColorSchemeProvider\n                                  color={colorScheme?.designSettings?.color}\n                                  colorMode={colorScheme?.designSettings?.colorMode}\n                                  style={{ display: 'inline' }}\n                              >\n                                  <span className=\"notranslate\">{currentChildren}</span>\n                              </ColorSchemeProvider>\n                          </ChaynsProvider>,\n                      )\n                    : (currentChildren as string);\n            }\n\n            return '';\n        }\n\n        return React.isValidElement(sortedChildren)\n            ? renderToString(\n                  <ChaynsProvider data={values} functions={functions} isModule>\n                      <ColorSchemeProvider\n                          color={colorScheme?.designSettings?.color}\n                          colorMode={colorScheme?.designSettings?.colorMode}\n                          style={{ display: 'inline' }}\n                      >\n                          <span className=\"notranslate\">{sortedChildren}</span>\n                      </ColorSchemeProvider>\n                  </ChaynsProvider>,\n              )\n            : (sortedChildren as string);\n    }, [\n        areMultipleChildrenGiven,\n        colorScheme?.designSettings?.color,\n        colorScheme?.designSettings?.colorMode,\n        currentChildrenIndex,\n        functions,\n        sortedChildren,\n        values,\n    ]);\n\n    const charactersCount = useMemo(() => getCharactersCount(textContent), [textContent]);\n    const chunkIntervalExponentialMovingAverage = useRef<ChunkStreamingSpeedState>({\n        lastLength: charactersCount,\n        ema: charactersCount / (autoSpeedBaseFactor / 1000),\n    });\n\n    const [shownCharCount, setShownCharCount] = useState(\n        charactersCount > 0 ? 0 : textContent.length,\n    );\n\n    const currentPosition = useRef(0);\n\n    useEffect(() => {\n        if (shouldUseResetAnimation) {\n            chunkIntervalExponentialMovingAverage.current = {\n                ema: charactersCount / (autoSpeedBaseFactor / 1000),\n                lastLength: charactersCount,\n            };\n        }\n        chunkIntervalExponentialMovingAverage.current = updateChunkStreamingSpeedEMA({\n            currentLength: charactersCount,\n            state: chunkIntervalExponentialMovingAverage.current,\n        });\n    }, [autoSpeedBaseFactor, charactersCount, shouldUseResetAnimation]);\n\n    useEffect(() => {\n        if (!shouldCalcAutoSpeed) {\n            autoSpeed.current = undefined;\n            autoSteps.current = animationSteps;\n            return;\n        }\n        const { speed: calculatedAutoSpeed, steps } = calculateAutoSpeed(\n            chunkIntervalExponentialMovingAverage.current.ema,\n        );\n\n        autoSpeed.current = calculatedAutoSpeed;\n        autoSteps.current = steps;\n    }, [animationSteps, charactersCount, shouldCalcAutoSpeed]);\n\n    const isAnimatingText =\n        shownCharCount < textContent.length ||\n        shouldForceCursorAnimation ||\n        areMultipleChildrenGiven ||\n        textContent.length === 0;\n\n    const handleClick = useCallback((event: React.MouseEvent) => {\n        event.stopPropagation();\n        event.preventDefault();\n\n        setShouldStopAnimation(true);\n    }, []);\n\n    const handleSetNextChildrenIndex = useCallback(\n        () =>\n            setCurrentChildrenIndex(() => {\n                let newIndex = currentChildrenIndex + 1;\n\n                if (newIndex > childrenCount - 1) {\n                    newIndex = 0;\n                }\n\n                return newIndex;\n            }),\n        [childrenCount, currentChildrenIndex],\n    );\n\n    useEffect(() => {\n        let interval: number | undefined;\n\n        if (shouldStopAnimation || charactersCount === 0) {\n            setShownCharCount(textContent.length);\n            currentPosition.current = textContent.length;\n        } else if (isResetAnimationActive) {\n            if (typeof onResetAnimationStart === 'function') {\n                onResetAnimationStart();\n            }\n\n            interval = window.setInterval(() => {\n                setShownCharCount((prevState) => {\n                    const nextState = prevState - autoSteps.current;\n                    currentPosition.current = nextState;\n\n                    if (nextState === 0) {\n                        window.clearInterval(interval);\n\n                        if (typeof onResetAnimationEnd === 'function') {\n                            onResetAnimationEnd();\n                        }\n\n                        if (areMultipleChildrenGiven) {\n                            setTimeout(() => {\n                                setIsResetAnimationActive(false);\n                                handleSetNextChildrenIndex();\n                            }, nextTextDelay);\n                        }\n                    }\n\n                    return nextState;\n                });\n            }, resetSpeed);\n        } else {\n            const startTypingAnimation = () => {\n                if (cursorType === CursorType.Thin) {\n                    setShouldPreventBlinkingCursor(true);\n                }\n\n                if (typeof onTypingAnimationStart === 'function') {\n                    onTypingAnimationStart();\n                }\n\n                const runTypingInterval = () => {\n                    setShownCharCount((prevState) => {\n                        let nextState = Math.min(prevState + autoSteps.current, charactersCount);\n\n                        if (nextState >= charactersCount && !shouldWaitForContent) {\n                            window.clearInterval(interval);\n\n                            if (cursorType === CursorType.Thin) {\n                                setShouldPreventBlinkingCursor(false);\n                            }\n\n                            if (typeof onTypingAnimationEnd === 'function') {\n                                onTypingAnimationEnd();\n                            }\n\n                            /**\n                             * At this point, the next value for \"shownCharCount\" is deliberately set to\n                             * the length of the textContent to correctly display HTML elements\n                             * after the last letter.\n                             */\n                            nextState = textContent.length;\n\n                            if (areMultipleChildrenGiven) {\n                                setTimeout(() => {\n                                    if (shouldUseResetAnimation) {\n                                        setIsResetAnimationActive(true);\n                                    } else {\n                                        setShownCharCount(0);\n                                        setTimeout(handleSetNextChildrenIndex, nextTextDelay);\n                                    }\n                                }, resetDelay);\n                            }\n                        }\n\n                        currentPosition.current = nextState;\n\n                        return nextState;\n                    });\n                };\n                interval = window.setInterval(runTypingInterval, autoSpeed.current ?? speed);\n            };\n\n            if (startDelay) {\n                setTimeout(startTypingAnimation, startDelay);\n            } else {\n                startTypingAnimation();\n            }\n        }\n\n        return () => {\n            window.clearInterval(interval);\n        };\n    }, [\n        areMultipleChildrenGiven,\n        autoSteps,\n        charactersCount,\n        cursorType,\n        handleSetNextChildrenIndex,\n        isResetAnimationActive,\n        nextTextDelay,\n        onResetAnimationEnd,\n        onResetAnimationStart,\n        onTypingAnimationEnd,\n        onTypingAnimationStart,\n        resetDelay,\n        resetSpeed,\n        shouldStopAnimation,\n        shouldUseResetAnimation,\n        shouldWaitForContent,\n        speed,\n        startDelay,\n        textContent.length,\n    ]);\n\n    useEffect(() => {\n        if (!isAnimatingText && typeof onFinish === 'function') {\n            onFinish();\n        }\n    }, [isAnimatingText, onFinish]);\n\n    const shownText = useMemo(\n        () => getSubTextFromHTML(textContent, shownCharCount),\n        [shownCharCount, textContent],\n    );\n\n    const pseudoTextHTML = useMemo(() => {\n        if (pseudoChildren) {\n            const pseudoText = React.isValidElement(pseudoChildren)\n                ? renderToString(\n                      <ChaynsProvider data={values} functions={functions} isModule>\n                          <ColorSchemeProvider\n                              color={colorScheme?.designSettings?.color}\n                              colorMode={colorScheme?.designSettings?.colorMode}\n                              style={{ display: 'inline' }}\n                          >\n                              {pseudoChildren}\n                          </ColorSchemeProvider>\n                      </ChaynsProvider>,\n                  )\n                : (pseudoChildren as string);\n\n            if (shouldUseAnimationHeight) {\n                return getSubTextFromHTML(pseudoText, shownCharCount);\n            }\n\n            return pseudoText;\n        }\n\n        if (shouldUseAnimationHeight && textContent) {\n            return getSubTextFromHTML(textContent, shownCharCount);\n        }\n\n        return textContent || '&#8203;';\n    }, [\n        colorScheme?.designSettings?.color,\n        colorScheme?.designSettings?.colorMode,\n        functions,\n        pseudoChildren,\n        shouldUseAnimationHeight,\n        shownCharCount,\n        textContent,\n        values,\n    ]);\n\n    return useMemo(\n        () => (\n            <StyledTypewriter\n                $cursorType={cursorType}\n                onClick={isAnimatingText ? handleClick : undefined}\n                $isAnimatingText={isAnimatingText}\n                $shouldHideCursor={shouldHideCursor}\n                $shouldPreventBlinkAnimation={shouldPreventBlinkingCursor}\n            >\n                {isAnimatingText ? (\n                    <AnimatedTypewriterText\n                        shouldHideCursor={shouldHideCursor}\n                        shouldRemainSingleLine={shouldRemainSingleLine}\n                        shownText={shownText}\n                        textStyle={textStyle}\n                    />\n                ) : (\n                    <StyledTypewriterText\n                        className=\"notranslate\"\n                        $shouldRemainSingleLine={shouldRemainSingleLine}\n                        dangerouslySetInnerHTML={\n                            typeof sortedChildren === 'string' ? { __html: shownText } : undefined\n                        }\n                        style={textStyle}\n                    >\n                        {typeof sortedChildren !== 'string' ? sortedChildren : undefined}\n                    </StyledTypewriterText>\n                )}\n                {isAnimatingText && (\n                    <StyledTypewriterPseudoText\n                        $isAnimatingText={isAnimatingText}\n                        $shouldHideCursor={shouldHideCursor}\n                        dangerouslySetInnerHTML={{ __html: pseudoTextHTML }}\n                    />\n                )}\n                {/*\n                    The following is needed because some components like the CodeHighlighter will not render correct\n                    if the element is not rendered on a client before...\n                */}\n                {!hasRenderedChildrenOnce &&\n                    createPortal(\n                        <div style={{ position: 'absolute', visibility: 'hidden' }}>\n                            {children}\n                        </div>,\n                        document.body,\n                    )}\n            </StyledTypewriter>\n        ),\n        [\n            children,\n            cursorType,\n            handleClick,\n            hasRenderedChildrenOnce,\n            isAnimatingText,\n            pseudoTextHTML,\n            shouldHideCursor,\n            shouldPreventBlinkingCursor,\n            shouldRemainSingleLine,\n            shownText,\n            sortedChildren,\n            textStyle,\n        ],\n    );\n};\n\nTypewriter.displayName = 'Typewriter';\n\nexport default Typewriter;\n"],"mappings":"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","ignoreList":[]}

package/lib/esm/components/typewriter/{typewrite-view/TypewriterView.styles.js → Typewriter.styles.js}

@@ -1,5 +1,5 @@
 import styled, { css, keyframes } from 'styled-components';
-import { CursorType } from '../../../types/cursor';
+import { CursorType } from '../../types/cursor';
 const typewriterCursorElement = ({
   $cursorType,
   $isAnimatingText,
@@ -94,4 +94,4 @@ export const StyledTypewriterText = styled.span`
             width: 100%;
         `}
 `;
-//# sourceMappingURL=TypewriterView.styles.js.map
+//# sourceMappingURL=Typewriter.styles.js.map

package/lib/esm/components/typewriter/Typewriter.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typewriter.styles.js","names":["styled","css","keyframes","CursorType","typewriterCursorElement","$cursorType","$isAnimatingText","$shouldHideCursor","$shouldPreventBlinkAnimation","Thin","blinkAnimation","theme","text","StyledTypewriter","div","StyledTypewriterPseudoText","span","StyledTypewriterText","$shouldRemainSingleLine"],"sources":["../../../../src/components/typewriter/Typewriter.styles.ts"],"sourcesContent":["import type { WithTheme } from '@chayns-components/core';\nimport styled, { css, keyframes } from 'styled-components';\nimport { CursorType } from '../../types/cursor';\nimport type { TypewriterProps } from './Typewriter';\n\ntype StyledTypewriterProps = WithTheme<{\n    $cursorType: TypewriterProps['cursorType'];\n    $isAnimatingText: boolean;\n    $shouldHideCursor: TypewriterProps['shouldHideCursor'];\n    $shouldPreventBlinkAnimation: boolean;\n}>;\n\nconst typewriterCursorElement = ({\n    $cursorType,\n    $isAnimatingText,\n    $shouldHideCursor,\n    $shouldPreventBlinkAnimation,\n}: StyledTypewriterProps) => {\n    if (!$isAnimatingText || $shouldHideCursor) {\n        return '';\n    }\n\n    if ($cursorType === CursorType.Thin) {\n        return css`\n            .typewriter-lastWithContent {\n                &:after {\n                    animation: ${$shouldPreventBlinkAnimation ? 'none' : blinkAnimation} 1s steps(2, start) infinite;\n                    color: inherit;\n                    content: '|';\n                    font-size: 25px;\n                    position: relative;\n                    line-height: 0;\n                    vertical-align: baseline;\n                }\n        `;\n    }\n\n    return css`\n        .typewriter-lastWithContent {\n            &:after {\n                animation: ${blinkAnimation} 1s steps(2, start) infinite;\n                color: ${({ theme }) => (theme as { text: string }).text};\n                content: '▋';\n                margin-left: 0.25rem;\n                opacity: 0.85;\n                position: relative;\n                vertical-align: baseline;\n            }\n        }\n    `;\n};\n\nexport const StyledTypewriter = styled.div<StyledTypewriterProps>`\n    align-items: inherit;\n    display: flex;\n    position: relative;\n    width: 100%;\n    ${typewriterCursorElement}\n`;\n\nconst blinkAnimation = keyframes`\n    100% {\n        visibility: hidden;\n    }\n`;\n\ntype StyledTypewriterPseudoTextProps = WithTheme<{\n    $isAnimatingText?: boolean;\n    $shouldHideCursor: TypewriterProps['shouldHideCursor'];\n}>;\n\nexport const StyledTypewriterPseudoText = styled.span<StyledTypewriterPseudoTextProps>`\n    opacity: 0;\n    pointer-events: none;\n    user-select: none;\n    width: fit-content;\n\n    ${({ $isAnimatingText, $shouldHideCursor }) =>\n        $isAnimatingText &&\n        !$shouldHideCursor &&\n        css`\n            &:after {\n                animation: ${blinkAnimation} 1s steps(2, start) infinite;\n                color: inherit;\n                content: '|';\n                font-size: 25px;\n                position: relative;\n                line-height: 0;\n                vertical-align: baseline;\n            }\n        `}\n`;\n\ntype StyledTypewriterTextProps = WithTheme<{\n    $isAnimatingText?: boolean;\n    $shouldRemainSingleLine: boolean;\n}>;\n\nexport const StyledTypewriterText = styled.span<StyledTypewriterTextProps>`\n    color: inherit;\n    position: ${({ $isAnimatingText }) => ($isAnimatingText ? 'absolute' : 'relative')};\n    width: fit-content;\n\n    ${({ $isAnimatingText }) =>\n        $isAnimatingText &&\n        css`\n            pointer-events: none;\n        `}\n\n    ${({ $shouldRemainSingleLine }) =>\n        $shouldRemainSingleLine &&\n        css`\n            white-space: nowrap;\n            overflow: hidden;\n            text-overflow: ellipsis;\n            width: 100%;\n        `}\n`;\n"],"mappings":"AACA,OAAOA,MAAM,IAAIC,GAAG,EAAEC,SAAS,QAAQ,mBAAmB;AAC1D,SAASC,UAAU,QAAQ,oBAAoB;AAU/C,MAAMC,uBAAuB,GAAGA,CAAC;EAC7BC,WAAW;EACXC,gBAAgB;EAChBC,iBAAiB;EACjBC;AACmB,CAAC,KAAK;EACzB,IAAI,CAACF,gBAAgB,IAAIC,iBAAiB,EAAE;IACxC,OAAO,EAAE;EACb;EAEA,IAAIF,WAAW,KAAKF,UAAU,CAACM,IAAI,EAAE;IACjC,OAAOR,GAAG;AAClB;AACA;AACA,iCAAiCO,4BAA4B,GAAG,MAAM,GAAGE,cAAc;AACvF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS;EACL;EAEA,OAAOT,GAAG;AACd;AACA;AACA,6BAA6BS,cAAc;AAC3C,yBAAyB,CAAC;IAAEC;EAAM,CAAC,KAAMA,KAAK,CAAsBC,IAAI;AACxE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK;AACL,CAAC;AAED,OAAO,MAAMC,gBAAgB,GAAGb,MAAM,CAACc,GAA0B;AACjE;AACA;AACA;AACA;AACA,MAAMV,uBAAuB;AAC7B,CAAC;AAED,MAAMM,cAAc,GAAGR,SAAS;AAChC;AACA;AACA;AACA,CAAC;AAOD,OAAO,MAAMa,0BAA0B,GAAGf,MAAM,CAACgB,IAAqC;AACtF;AACA;AACA;AACA;AACA;AACA,MAAM,CAAC;EAAEV,gBAAgB;EAAEC;AAAkB,CAAC,KACtCD,gBAAgB,IAChB,CAACC,iBAAiB,IAClBN,GAAG;AACX;AACA,6BAA6BS,cAAc;AAC3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS;AACT,CAAC;AAOD,OAAO,MAAMO,oBAAoB,GAAGjB,MAAM,CAACgB,IAA+B;AAC1E;AACA,gBAAgB,CAAC;EAAEV;AAAiB,CAAC,KAAMA,gBAAgB,GAAG,UAAU,GAAG,UAAW;AACtF;AACA;AACA,MAAM,CAAC;EAAEA;AAAiB,CAAC,KACnBA,gBAAgB,IAChBL,GAAG;AACX;AACA,SAAS;AACT;AACA,MAAM,CAAC;EAAEiB;AAAwB,CAAC,KAC1BA,uBAAuB,IACvBjB,GAAG;AACX;AACA;AACA;AACA;AACA,SAAS;AACT,CAAC","ignoreList":[]}

package/lib/esm/{utils → components/typewriter}/utils.js

@@ -1,4 +1,4 @@
-import { TypewriterSpeed } from '../types/speed';
+import { TypewriterSpeed } from '../../types/speed';
 
 /**
  * Returns a substring of an HTML string while preserving HTML structure.
@@ -148,16 +148,33 @@ export const shuffleArray = array => {
   }
   return result;
 };
-export const getSafeAutoSpeed = ema => {
+export const calculateAutoSpeed = ema => {
+  // nested timer calls are clamped to a 4ms minimum
+  // https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#reasons_for_longer_delays_than_specified
+  const MINIMUM_TIMEOUT = 4;
   if (ema <= 0) {
-    return TypewriterSpeed.ExtraSlow;
+    return {
+      speed: TypewriterSpeed.ExtraSlow,
+      steps: 1
+    };
   }
-  return 1000 / ema;
+  const msPerChar = Math.min(1000 / ema, TypewriterSpeed.ExtraSlow);
+  if (msPerChar >= MINIMUM_TIMEOUT) {
+    return {
+      speed: msPerChar,
+      steps: 1
+    };
+  }
+  const steps = Math.max(1, MINIMUM_TIMEOUT / msPerChar);
+  return {
+    speed: MINIMUM_TIMEOUT,
+    steps
+  };
 };
 export const calculateEMA = ({
   currentEMA,
   newValue,
-  alpha = 0.75
+  alpha = 0.25
 }) => alpha * newValue + (1 - alpha) * currentEMA;
 export const updateChunkStreamingSpeedEMA = ({
   currentLength,

package/lib/esm/components/typewriter/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["TypewriterSpeed","getSubTextFromHTML","html","length","div","document","createElement","innerHTML","text","currLength","escapeText","value","replace","escapeAttr","String","VOID_ELEMENTS","Set","traverse","node","nodeType","textContent","nodeText","remaining","substring","element","nodeName","toLowerCase","attributes","attribute","name","isVoid","has","i","childNodes","childNode","getCharactersCount","count","trim","Array","from","forEach","shuffleArray","array","result","j","Math","floor","random","calculateAutoSpeed","ema","MINIMUM_TIMEOUT","speed","ExtraSlow","steps","msPerChar","min","max","calculateEMA","currentEMA","newValue","alpha","updateChunkStreamingSpeedEMA","currentLength","state","now","Date","deltaTime","lastTimestamp","deltaLength","lastLength","charsPerSecond","newEMA"],"sources":["../../../../src/components/typewriter/utils.ts"],"sourcesContent":["import { TypewriterSpeed } from '../../types/speed';\n\n/**\n * Returns a substring of an HTML string while preserving HTML structure.\n *\n * Core rules:\n * - Element nodes are re-serialized as tags (start/end) to keep structure.\n * - Text nodes are always HTML-escaped on output. This prevents that previously\n *   escaped text (like \"&lt;div&gt;\") turns into real tags during the DOM round trip.\n * - Attribute values are HTML-escaped on output.\n * - Void elements are serialized without closing tags.\n * - For TWIGNORE/TW-IGNORE elements, the innerHTML is passed through so that\n *   their content (including real HTML) remains untouched.\n * - On early cutoff (once the length limit is reached), already opened tags are\n *   properly closed to keep the result valid HTML.\n *\n * Note on length counting:\n * - The length is based on the decoded textContent length (as the DOM provides),\n *   not on byte length nor escaped entity length. This mirrors how the text is perceived.\n *\n * @param html   The input HTML string; may contain a mix of real HTML and already escaped HTML.\n * @param length The maximum number of text characters (based on textContent) to include.\n * @returns A valid HTML string containing up to the specified number of text characters,\n *          preserving HTML tags and keeping escaped text escaped.\n */\nexport const getSubTextFromHTML = (html: string, length: number): string => {\n    const div = document.createElement('div');\n\n    div.innerHTML = html;\n\n    let text = '';\n    let currLength = 0;\n\n    // Escape text node content to ensure that decoded \"<\" and \">\" do not become real tags.\n    const escapeText = (value: string): string =>\n        value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\n    // Escape attribute values safely.\n    const escapeAttr = (value: string): string =>\n        String(value)\n            .replace(/&/g, '&amp;')\n            .replace(/\"/g, '&quot;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;');\n\n    // HTML void elements (must not have closing tags)\n    const VOID_ELEMENTS = new Set([\n        'area',\n        'base',\n        'br',\n        'col',\n        'embed',\n        'hr',\n        'img',\n        'input',\n        'link',\n        'meta',\n        'param',\n        'source',\n        'track',\n        'wbr',\n    ]);\n\n    // Traverses nodes and appends to \"text\".\n    // Returns false to signal \"stop traversal\" once the length limit is reached.\n    const traverse = (node: Node): boolean => {\n        // Text node\n        if (node.nodeType === 3 && typeof node.textContent === 'string') {\n            const nodeText = node.textContent;\n            const remaining = length - currLength;\n\n            if (remaining <= 0) {\n                return false;\n            }\n\n            if (nodeText.length <= remaining) {\n                // Always escape text before writing to output\n                text += escapeText(nodeText);\n                currLength += nodeText.length;\n            } else {\n                // Cut the text and stop traversal\n                text += escapeText(nodeText.substring(0, remaining));\n                currLength += remaining;\n                return false;\n            }\n\n            return true;\n        }\n\n        // Element node\n        if (node.nodeType === 1) {\n            const element = node as Element;\n\n            // Pass-through for TWIGNORE/TW-IGNORE: keep their HTML as-is.\n            if (element.nodeName === 'TWIGNORE' || element.nodeName === 'TW-IGNORE') {\n                // element.innerHTML serializes children; escaped text stays escaped,\n                // real HTML stays HTML — exactly what we want here.\n                text += element.innerHTML;\n                return true;\n            }\n\n            const nodeName = element.nodeName.toLowerCase();\n\n            // Serialize attributes safely\n            let attributes = '';\n            // @ts-expect-error: attributes is a NodeListOf<Attr>\n            // eslint-disable-next-line no-restricted-syntax\n            for (const attribute of element.attributes) {\n                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access,@typescript-eslint/restrict-template-expressions,@typescript-eslint/no-unsafe-argument\n                attributes += ` ${attribute.name}=\"${escapeAttr(attribute.value)}\"`;\n            }\n\n            // Open tag\n            text += `<${nodeName}${attributes}>`;\n\n            // Void elements: do not recurse children and do not emit a closing tag\n            const isVoid = VOID_ELEMENTS.has(nodeName);\n            if (!isVoid) {\n                // Recurse through children until limit is reached\n                for (let i = 0; i < element.childNodes.length; i++) {\n                    const childNode = element.childNodes[i];\n                    if (childNode && !traverse(childNode)) {\n                        // On early stop: close this tag to keep valid HTML, then bubble stop.\n                        text += `</${nodeName}>`;\n                        return false;\n                    }\n                }\n\n                // Close tag after all children\n                text += `</${nodeName}>`;\n            }\n\n            return true;\n        }\n\n        // Other node types (comments, etc.) are ignored for text length\n        return true;\n    };\n\n    // Traverse top-level children\n    for (let i = 0; i < div.childNodes.length; i++) {\n        const childNode = div.childNodes[i];\n        if (childNode && !traverse(childNode)) {\n            return text;\n        }\n    }\n\n    return text;\n};\n\nexport const getCharactersCount = (html: string): number => {\n    const div = document.createElement('div');\n\n    div.innerHTML = html;\n\n    let count = 0;\n\n    const traverse = (node: Node): void => {\n        if (node.nodeName === 'TWIGNORE') {\n            count += 1;\n        } else if (node.nodeType === 3 && typeof node.textContent === 'string') {\n            count += node.textContent.trim().length;\n        } else if (node.nodeType === 1) {\n            if (node.nodeName === 'CODE' && node.textContent !== null) {\n                count += node.textContent.length;\n\n                return;\n            }\n\n            Array.from(node.childNodes).forEach(traverse);\n        }\n    };\n\n    Array.from(div.childNodes).forEach(traverse);\n\n    return count;\n};\n\nexport const shuffleArray = <T>(array: T[]): T[] => {\n    const result = Array.from(array);\n\n    for (let i = result.length - 1; i > 0; i--) {\n        const j = Math.floor(Math.random() * (i + 1));\n\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        [result[i], result[j]] = [result[j]!, result[i]!];\n    }\n\n    return result;\n};\n\nexport const calculateAutoSpeed = (ema: number): { speed: number; steps: number } => {\n    // nested timer calls are clamped to a 4ms minimum\n    // https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#reasons_for_longer_delays_than_specified\n    const MINIMUM_TIMEOUT = 4;\n\n    if (ema <= 0) {\n        return { speed: TypewriterSpeed.ExtraSlow, steps: 1 };\n    }\n\n    const msPerChar = Math.min(1000 / ema, TypewriterSpeed.ExtraSlow);\n\n    if (msPerChar >= MINIMUM_TIMEOUT) {\n        return { speed: msPerChar, steps: 1 };\n    }\n\n    const steps = Math.max(1, MINIMUM_TIMEOUT / msPerChar);\n    return { speed: MINIMUM_TIMEOUT, steps };\n};\n\ninterface CalculateEMAProps {\n    currentEMA: number;\n    newValue: number;\n    alpha?: number;\n}\n\nexport const calculateEMA = ({ currentEMA, newValue, alpha = 0.25 }: CalculateEMAProps): number =>\n    alpha * newValue + (1 - alpha) * currentEMA;\n\nexport interface ChunkStreamingSpeedState {\n    lastTimestamp?: number;\n    lastLength: number;\n    ema: number;\n}\n\ninterface ChunkStreamingSpeedProps {\n    currentLength: number;\n    state: ChunkStreamingSpeedState;\n}\n\nexport const updateChunkStreamingSpeedEMA = ({\n    currentLength,\n    state,\n}: ChunkStreamingSpeedProps): ChunkStreamingSpeedState => {\n    const now = Date.now();\n    const deltaTime = now - (state?.lastTimestamp ?? now);\n\n    if (deltaTime <= 0) return { ...state, lastTimestamp: now };\n\n    const deltaLength = currentLength - state.lastLength;\n\n    const charsPerSecond = Math.max(0, (deltaLength / deltaTime) * 1000);\n\n    const newEMA = calculateEMA({\n        currentEMA: state.ema,\n        newValue: charsPerSecond,\n    });\n\n    return {\n        lastTimestamp: now,\n        lastLength: currentLength,\n        ema: newEMA,\n    };\n};\n"],"mappings":"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","ignoreList":[]}