@lobehub/ui 2.18.4 → 2.19.0

package/es/awesome/TypewriterEffect/TypewriterEffect.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import type { TypewriterEffectProps } from './type';
+declare const TypewriterEffect: import("react").NamedExoticComponent<TypewriterEffectProps>;
+export default TypewriterEffect;

package/es/awesome/TypewriterEffect/TypewriterEffect.js

@@ -0,0 +1,250 @@
+'use client';
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["sentences", "as", "typingSpeed", "initialDelay", "pauseDuration", "deletingSpeed", "loop", "className", "color", "showCursor", "hideCursorWhileTyping", "cursorCharacter", "cursorClassName", "cursorColor", "cursorBlinkDuration", "cursorStyle", "textColors", "variableSpeed", "onSentenceComplete", "startOnVisible", "reverseMode"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { motion } from 'framer-motion';
+import { createElement, memo, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useStyles } from "./style";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var TypewriterEffect = /*#__PURE__*/memo(function (_ref) {
+  var sentences = _ref.sentences,
+    _ref$as = _ref.as,
+    Component = _ref$as === void 0 ? 'div' : _ref$as,
+    _ref$typingSpeed = _ref.typingSpeed,
+    typingSpeed = _ref$typingSpeed === void 0 ? 100 : _ref$typingSpeed,
+    _ref$initialDelay = _ref.initialDelay,
+    initialDelay = _ref$initialDelay === void 0 ? 0 : _ref$initialDelay,
+    _ref$pauseDuration = _ref.pauseDuration,
+    pauseDuration = _ref$pauseDuration === void 0 ? 2000 : _ref$pauseDuration,
+    _ref$deletingSpeed = _ref.deletingSpeed,
+    deletingSpeed = _ref$deletingSpeed === void 0 ? 50 : _ref$deletingSpeed,
+    _ref$loop = _ref.loop,
+    loop = _ref$loop === void 0 ? true : _ref$loop,
+    _ref$className = _ref.className,
+    className = _ref$className === void 0 ? '' : _ref$className,
+    color = _ref.color,
+    _ref$showCursor = _ref.showCursor,
+    showCursor = _ref$showCursor === void 0 ? true : _ref$showCursor,
+    _ref$hideCursorWhileT = _ref.hideCursorWhileTyping,
+    hideCursorWhileTyping = _ref$hideCursorWhileT === void 0 ? false : _ref$hideCursorWhileT,
+    cursorCharacter = _ref.cursorCharacter,
+    _ref$cursorClassName = _ref.cursorClassName,
+    cursorClassName = _ref$cursorClassName === void 0 ? '' : _ref$cursorClassName,
+    cursorColor = _ref.cursorColor,
+    _ref$cursorBlinkDurat = _ref.cursorBlinkDuration,
+    cursorBlinkDuration = _ref$cursorBlinkDurat === void 0 ? 0.8 : _ref$cursorBlinkDurat,
+    _ref$cursorStyle = _ref.cursorStyle,
+    cursorStyle = _ref$cursorStyle === void 0 ? 'pipe' : _ref$cursorStyle,
+    _ref$textColors = _ref.textColors,
+    textColors = _ref$textColors === void 0 ? [] : _ref$textColors,
+    variableSpeed = _ref.variableSpeed,
+    onSentenceComplete = _ref.onSentenceComplete,
+    _ref$startOnVisible = _ref.startOnVisible,
+    startOnVisible = _ref$startOnVisible === void 0 ? false : _ref$startOnVisible,
+    _ref$reverseMode = _ref.reverseMode,
+    reverseMode = _ref$reverseMode === void 0 ? false : _ref$reverseMode,
+    props = _objectWithoutProperties(_ref, _excluded);
+  var _useStyles = useStyles(),
+    styles = _useStyles.styles,
+    cx = _useStyles.cx;
+  var _useState = useState(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    displayedText = _useState2[0],
+    setDisplayedText = _useState2[1];
+  var _useState3 = useState(0),
+    _useState4 = _slicedToArray(_useState3, 2),
+    currentCharIndex = _useState4[0],
+    setCurrentCharIndex = _useState4[1];
+  var _useState5 = useState(false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isDeleting = _useState6[0],
+    setIsDeleting = _useState6[1];
+  var _useState7 = useState(0),
+    _useState8 = _slicedToArray(_useState7, 2),
+    currentTextIndex = _useState8[0],
+    setCurrentTextIndex = _useState8[1];
+  var _useState9 = useState(!startOnVisible),
+    _useState10 = _slicedToArray(_useState9, 2),
+    isVisible = _useState10[0],
+    setIsVisible = _useState10[1];
+  var containerRef = useRef(null);
+  var textArray = useMemo(function () {
+    return Array.isArray(sentences) ? sentences : [sentences];
+  }, [sentences]);
+  var getRandomSpeed = useCallback(function () {
+    if (!variableSpeed) return typingSpeed;
+    var min = variableSpeed.min,
+      max = variableSpeed.max;
+    return Math.random() * (max - min) + min;
+  }, [variableSpeed, typingSpeed]);
+  var getCurrentTextColor = function getCurrentTextColor() {
+    if (textColors.length > 0) {
+      return textColors[currentTextIndex % textColors.length];
+    }
+    return color;
+  };
+  var getCurrentCursorColor = function getCurrentCursorColor() {
+    return cursorColor || color;
+  };
+  useEffect(function () {
+    if (!startOnVisible || !containerRef.current) return;
+    var observer = new IntersectionObserver(function (entries) {
+      entries.forEach(function (entry) {
+        if (entry.isIntersecting) {
+          setIsVisible(true);
+        }
+      });
+    }, {
+      threshold: 0.1
+    });
+    observer.observe(containerRef.current);
+    return function () {
+      return observer.disconnect();
+    };
+  }, [startOnVisible]);
+  useEffect(function () {
+    if (!isVisible) return;
+    var timeout;
+    var currentText = textArray[currentTextIndex];
+    var processedText = reverseMode ? currentText.split('').reverse().join('') : currentText;
+    var executeTypingAnimation = function executeTypingAnimation() {
+      if (isDeleting) {
+        if (displayedText === '') {
+          setIsDeleting(false);
+          if (currentTextIndex === textArray.length - 1 && !loop) {
+            return;
+          }
+          if (onSentenceComplete) {
+            onSentenceComplete(textArray[currentTextIndex], currentTextIndex);
+          }
+          setCurrentTextIndex(function (prev) {
+            return (prev + 1) % textArray.length;
+          });
+          setCurrentCharIndex(0);
+          timeout = setTimeout(function () {}, pauseDuration);
+        } else {
+          timeout = setTimeout(function () {
+            setDisplayedText(function (prev) {
+              return prev.slice(0, -1);
+            });
+          }, deletingSpeed);
+        }
+      } else {
+        if (currentCharIndex < processedText.length) {
+          timeout = setTimeout(function () {
+            setDisplayedText(function (prev) {
+              return prev + processedText[currentCharIndex];
+            });
+            setCurrentCharIndex(function (prev) {
+              return prev + 1;
+            });
+          }, variableSpeed ? getRandomSpeed() : typingSpeed);
+        } else if (textArray.length >= 1) {
+          if (!loop && currentTextIndex === textArray.length - 1) return;
+          timeout = setTimeout(function () {
+            setIsDeleting(true);
+          }, pauseDuration);
+        }
+      }
+    };
+    if (currentCharIndex === 0 && !isDeleting && displayedText === '') {
+      timeout = setTimeout(executeTypingAnimation, initialDelay);
+    } else {
+      executeTypingAnimation();
+    }
+    return function () {
+      return clearTimeout(timeout);
+    };
+  }, [currentCharIndex, displayedText, isDeleting, typingSpeed, deletingSpeed, pauseDuration, textArray, currentTextIndex, loop, initialDelay, isVisible, reverseMode, variableSpeed, onSentenceComplete, getRandomSpeed]);
+  var getCursorStyle = function getCursorStyle() {
+    if (cursorCharacter) return styles.cursorCustom;
+    switch (cursorStyle) {
+      case 'block':
+        {
+          return styles.cursorBlock;
+        }
+      case 'dot':
+        {
+          return styles.cursorDot;
+        }
+      case 'underscore':
+        {
+          return styles.cursorUnderscore;
+        }
+      case 'pipe':
+        {
+          return styles.cursor;
+        }
+    }
+  };
+  var shouldHideCursor = hideCursorWhileTyping && (currentCharIndex < textArray[currentTextIndex].length || isDeleting);
+  var textColor = getCurrentTextColor();
+  var finalCursorColor = getCurrentCursorColor();
+
+  // Split displayed text into characters for animation
+  var characters = displayedText.split('');
+  return /*#__PURE__*/createElement(Component, _objectSpread({
+    className: cx(styles.container, className),
+    ref: containerRef
+  }, props), /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx("span", {
+      className: styles.text,
+      style: textColor ? {
+        color: textColor
+      } : undefined,
+      children: characters.map(function (char, index) {
+        return /*#__PURE__*/_jsx(motion.span, {
+          animate: {
+            opacity: 1
+          },
+          initial: {
+            opacity: 0
+          },
+          style: {
+            display: 'inline-block'
+          },
+          transition: {
+            duration: typingSpeed / 500,
+            ease: 'easeInOut'
+          },
+          children: char === ' ' ? "\xA0" : char
+        }, "".concat(currentTextIndex, "-").concat(index));
+      })
+    }), showCursor && /*#__PURE__*/_jsx(motion.span, {
+      animate: {
+        opacity: 1
+      },
+      className: cx(getCursorStyle(), cursorClassName, shouldHideCursor && styles.cursorHidden),
+      initial: {
+        opacity: 0
+      },
+      style: finalCursorColor ? {
+        backgroundColor: finalCursorColor
+      } : undefined,
+      transition: {
+        duration: cursorBlinkDuration,
+        ease: 'easeInOut',
+        repeat: Number.POSITIVE_INFINITY,
+        repeatType: 'reverse'
+      },
+      children: cursorCharacter
+    })]
+  }));
+});
+TypewriterEffect.displayName = 'TypewriterEffect';
+export default TypewriterEffect;

package/es/awesome/TypewriterEffect/index.d.ts

@@ -0,0 +1,2 @@
+export type { CursorStyle, TypewriterEffectProps } from './type';
+export { default } from './TypewriterEffect';

package/es/awesome/TypewriterEffect/index.js

@@ -0,0 +1 @@
+export { default } from "./TypewriterEffect";

package/es/awesome/TypewriterEffect/style.d.ts

@@ -0,0 +1,10 @@
+export declare const useStyles: (props?: unknown) => import("antd-style").ReturnStyles<{
+    container: import("antd-style").SerializedStyles;
+    cursor: import("antd-style").SerializedStyles;
+    cursorBlock: import("antd-style").SerializedStyles;
+    cursorCustom: import("antd-style").SerializedStyles;
+    cursorDot: import("antd-style").SerializedStyles;
+    cursorHidden: import("antd-style").SerializedStyles;
+    cursorUnderscore: import("antd-style").SerializedStyles;
+    text: import("antd-style").SerializedStyles;
+}>;

package/es/awesome/TypewriterEffect/style.js

@@ -0,0 +1,18 @@
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5, _templateObject6, _templateObject7, _templateObject8;
+function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
+import { createStyles } from 'antd-style';
+export var useStyles = createStyles(function (_ref) {
+  var css = _ref.css,
+    token = _ref.token,
+    isDarkMode = _ref.isDarkMode;
+  return {
+    container: css(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n    display: inline-block;\n    white-space: pre-wrap;\n  "]))),
+    cursor: css(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["\n    transform: translateY(10%);\n\n    display: inline-block;\n    align-items: center;\n\n    width: 3px;\n    height: 1em;\n    margin-inline-start: 0.25rem;\n    border-radius: 2px;\n\n    opacity: 1;\n    background-color: ", ";\n  "])), token.colorPrimary),
+    cursorBlock: css(_templateObject3 || (_templateObject3 = _taggedTemplateLiteral(["\n    transform: translateY(10%);\n\n    display: inline-block;\n    align-items: center;\n\n    width: 0.5em;\n    height: 1em;\n    margin-inline-start: 0.25rem;\n    border-radius: 2px;\n\n    opacity: 1;\n    background-color: ", ";\n  "])), token.colorPrimary),
+    cursorCustom: css(_templateObject4 || (_templateObject4 = _taggedTemplateLiteral(["\n    display: inline-block;\n    align-items: center;\n    margin-inline-start: 0.25rem;\n    opacity: 1;\n  "]))),
+    cursorDot: css(_templateObject5 || (_templateObject5 = _taggedTemplateLiteral(["\n    display: inline-block;\n    align-items: center;\n\n    width: 0.75em;\n    height: 0.75em;\n    margin-inline-start: 0.25rem;\n    border-radius: 50%;\n\n    opacity: 1;\n    background-color: ", ";\n  "])), token.colorPrimary),
+    cursorHidden: css(_templateObject6 || (_templateObject6 = _taggedTemplateLiteral(["\n    display: none;\n  "]))),
+    cursorUnderscore: css(_templateObject7 || (_templateObject7 = _taggedTemplateLiteral(["\n    transform: translateY(0.3em);\n\n    display: inline-block;\n    align-items: center;\n\n    width: 0.6em;\n    height: 0.15em;\n    margin-inline-start: 0.25rem;\n    border-radius: 2px;\n\n    opacity: 1;\n    background-color: ", ";\n  "])), token.colorPrimary),
+    text: css(_templateObject8 || (_templateObject8 = _taggedTemplateLiteral(["\n    color: ", ";\n  "])), isDarkMode ? token.colorTextLightSolid : token.colorText)
+  };
+});

package/es/awesome/TypewriterEffect/type.d.ts

@@ -0,0 +1,104 @@
+import type { ElementType, ReactNode } from 'react';
+export type CursorStyle = 'pipe' | 'underscore' | 'dot' | 'block';
+export interface TypewriterEffectProps {
+    /**
+     * Custom element type for the container
+     * @default 'div'
+     */
+    as?: ElementType;
+    /**
+     * Additional class name for the container
+     */
+    className?: string;
+    /**
+     * Text color
+     */
+    color?: string;
+    /**
+     * Cursor blink duration in seconds
+     * @default 0.8
+     */
+    cursorBlinkDuration?: number;
+    /**
+     * Custom cursor character or ReactNode
+     * @default undefined (uses cursorStyle)
+     */
+    cursorCharacter?: string | ReactNode;
+    /**
+     * Additional class name for the cursor
+     */
+    cursorClassName?: string;
+    /**
+     * Cursor color (defaults to color if not provided)
+     */
+    cursorColor?: string;
+    /**
+     * Style of the cursor (ignored if cursorCharacter is provided)
+     * @default 'pipe'
+     */
+    cursorStyle?: CursorStyle;
+    /**
+     * Speed of deleting characters (milliseconds per character)
+     * @default 50
+     */
+    deletingSpeed?: number;
+    /**
+     * Hide cursor while typing
+     * @default false
+     */
+    hideCursorWhileTyping?: boolean;
+    /**
+     * Initial delay before starting animation (milliseconds)
+     * @default 0
+     */
+    initialDelay?: number;
+    /**
+     * Whether to loop through sentences
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Callback when a sentence is completed
+     */
+    onSentenceComplete?: (sentence: string, index: number) => void;
+    /**
+     * Pause duration after typing complete before deleting (milliseconds)
+     * @default 2000
+     */
+    pauseDuration?: number;
+    /**
+     * Reverse mode: type from end to start
+     * @default false
+     */
+    reverseMode?: boolean;
+    /**
+     * Array of sentences to display
+     */
+    sentences: string[];
+    /**
+     * Whether to show cursor
+     * @default true
+     */
+    showCursor?: boolean;
+    /**
+     * Start animation when element becomes visible
+     * @default false
+     */
+    startOnVisible?: boolean;
+    /**
+     * Colors for each sentence (cycles through array)
+     */
+    textColors?: string[];
+    /**
+     * Speed of typing characters (milliseconds per character)
+     * @default 100
+     */
+    typingSpeed?: number;
+    /**
+     * Variable typing speed range
+     */
+    variableSpeed?: {
+        max: number;
+        min: number;
+    };
+}

package/es/awesome/TypewriterEffect/type.js

@@ -0,0 +1 @@
+export {};

package/es/awesome/index.d.ts

@@ -7,3 +7,4 @@ export { default as GridBackground, type GridBackgroundProps, GridShowcase, type
 export { default as Hero, type HeroAction, type HeroProps } from './Hero';
 export { default as Spotlight, type SpotlightProps } from './Spotlight';
 export { default as SpotlightCard, type SpotlightCardProps } from './SpotlightCard';
+export { type CursorStyle, default as TypewriterEffect, type TypewriterEffectProps, } from './TypewriterEffect';

package/es/awesome/index.js

@@ -6,4 +6,5 @@ export { default as GradientButton } from "./GradientButton";
 export { default as GridBackground, GridShowcase } from "./GridBackground";
 export { default as Hero } from "./Hero";
 export { default as Spotlight } from "./Spotlight";
-export { default as SpotlightCard } from "./SpotlightCard";
+export { default as SpotlightCard } from "./SpotlightCard";
+export { default as TypewriterEffect } from "./TypewriterEffect";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/ui",
-  "version": "2.18.4",
+  "version": "2.19.0",
   "description": "Lobe UI is an open-source UI component library for building AIGC web apps",
   "keywords": [
     "lobehub",