@rxdrag/website-lib-core 0.0.6 → 0.0.8

package/src/motion/convertToGsapVars.ts

@@ -0,0 +1,102 @@
+import { AnimationConfig, EaseConfig, EaseString } from "./types";
+import { gsap } from "gsap/dist/gsap";
+
+/**
+ * 将AnimationConfig转换为GSAP兼容的TweenVars
+ * @param animation 动画配置
+ * @returns GSAP兼容的动画配置
+ */
+export function convertToGsapVars(animation: AnimationConfig): gsap.TweenVars {
+  // 创建基础TweenVars对象
+  const gsapVars: gsap.TweenVars = {};
+
+  // 如果传入的是直接包含属性的对象（如initial），直接使用其中的属性
+  if (
+    typeof animation === "object" &&
+    !animation.to &&
+    !animation.from &&
+    !animation.fromTo
+  ) {
+    // 检查是否有initial属性
+    if (animation.initial) {
+      // initial属性是TweenVars类型，可以直接使用
+      Object.assign(gsapVars, animation.initial);
+    } else {
+      // 复制除了控制参数外的所有属性
+      // 这里使用安全的类型方式处理
+      const copyProps = (obj: Record<string, unknown>) => {
+        Object.keys(obj).forEach((key) => {
+          // 跳过动画控制参数
+          if (
+            key !== "duration" &&
+            key !== "delay" &&
+            key !== "ease" &&
+            key !== "preset"
+          ) {
+            gsapVars[key] = obj[key];
+          }
+        });
+      };
+
+      copyProps(animation as Record<string, unknown>);
+    }
+  } else {
+    // 标准动画配置处理
+    // 复制所有属性
+    if (animation.to) {
+      Object.assign(gsapVars, animation.to);
+    }
+
+    if (animation.from) {
+      Object.assign(gsapVars, animation.from);
+    }
+
+    if (animation.fromTo) {
+      Object.assign(gsapVars, animation.fromTo.to);
+    }
+  }
+
+  // 复制动画控制参数
+  if (animation.duration) gsapVars.duration = animation.duration;
+  if (animation.delay) gsapVars.delay = animation.delay;
+
+  // 处理ease属性
+  if (animation.ease) {
+    if (typeof animation.ease === "string") {
+      // 字符串直接使用
+      gsapVars.ease = animation.ease as EaseString;
+    } else if (typeof animation.ease === "function") {
+      // 如果是函数，直接使用
+      gsapVars.ease = animation.ease;
+    } else if (typeof animation.ease === "object" && "type" in animation.ease) {
+      // 处理EaseConfig对象
+      const easeConfig = animation.ease as EaseConfig;
+      if (easeConfig.type) {
+        // 将EaseConfig转换为字符串
+        let easeStr = easeConfig.type;
+
+        // 添加方向后缀，如.out
+        easeStr += ".out";
+
+        // 添加参数
+        if (easeConfig.config) {
+          const params = [];
+          if (easeConfig.config.overshoot !== undefined)
+            params.push(easeConfig.config.overshoot);
+          if (easeConfig.config.amplitude !== undefined)
+            params.push(easeConfig.config.amplitude);
+          if (easeConfig.config.period !== undefined)
+            params.push(easeConfig.config.period);
+
+          if (params.length > 0) {
+            easeStr += `(${params.join(",")})`;
+          }
+        }
+
+        gsapVars.ease = easeStr;
+      }
+    }
+  }
+
+  return gsapVars;
+}

package/src/motion/index.ts

@@ -1,2 +1,6 @@
 export * from "./consts";
-export * from "./types";
+export * from "./types";
+export * from "./normalizeAnimation";
+export * from "./normalizeAosAnimation";
+export * from "./normalizePopupAnimation";
+export * from "./convertToGsapVars";

package/src/motion/normalizeAnimation.ts

@@ -0,0 +1,28 @@
+import { ANIMATIONS } from "./consts";
+import { AnimationConfig } from "./types";
+import { merge } from "lodash-es";
+
+/**
+ * 标准化动画配置，把预置动画补全
+ * @param motion 动画配置
+ * @param isDual 是否为双态动画
+ * @returns 标准化后的动画配置
+ */
+export function normalizeAnimation(motion?: AnimationConfig | string) {
+  let presetKey: string | undefined;
+  let normalMotion: AnimationConfig | undefined;
+  if (typeof motion === "string") {
+    presetKey = motion;
+  } else {
+    presetKey = motion?.preset;
+    normalMotion = motion;
+  }
+
+  if (presetKey) {
+    const presetMotion = ANIMATIONS[presetKey];
+    if (presetMotion) {
+      return merge(presetMotion, normalMotion);
+    }
+  }
+  return normalMotion;
+}

package/src/motion/normalizeAosAnimation.ts

@@ -0,0 +1,22 @@
+import { merge } from "lodash-es";
+import { AOS_ANIMATIONS } from "./consts";
+import { AnimationConfig, AosAnimationConfig } from "./types";
+
+export function normalizeAosAnimation(motion?: AosAnimationConfig | string) {
+  let presetKey: string | undefined;
+  let normalMotion: AnimationConfig | undefined;
+  if (typeof motion === "string") {
+    presetKey = motion;
+  } else {
+    presetKey = motion?.preset;
+    normalMotion = motion;
+  }
+
+  if (presetKey) {
+    const presetMotion = AOS_ANIMATIONS[presetKey];
+    if (presetMotion) {
+      return merge(presetMotion, normalMotion);
+    }
+  }
+  return normalMotion;
+}

package/src/motion/normalizePopupAnimation.ts

@@ -0,0 +1,24 @@
+import { merge } from "lodash-es";
+import { PopupAnimationConfig } from "./types";
+import { POPUP_ANIMATIONS } from "./consts";
+
+export function normalizePopupAnimation(
+  motion?: PopupAnimationConfig | string
+) {
+  let presetKey: string | undefined;
+  let normalMotion: PopupAnimationConfig | undefined;
+  if (typeof motion === "string") {
+    presetKey = motion;
+  } else {
+    presetKey = motion?.preset;
+    normalMotion = motion;
+  }
+
+  if (presetKey) {
+    const presetMotion = POPUP_ANIMATIONS[presetKey];
+    if (presetMotion) {
+      return merge(presetMotion, normalMotion);
+    }
+  }
+  return normalMotion;
+}

package/src/motion/types.ts

@@ -1,46 +1,133 @@
-import { AnimationOptions, DOMKeyframesDefinition } from "motion";
-import { ANIMATION } from "./consts";
-
-// 基础动画配置
-export type BaseAnimation = {
-  preset?: ANIMATION;
-  keyframes?: DOMKeyframesDefinition;
-  transition?: AnimationOptions;
-};
-
-// 简单的单向动画（如 hover, tap 等）
-export type SimpleAnimation = BaseAnimation;
-
-// 双向动画（如 inView 的进入和离开）
-export type DualAnimation = {
-  preset?: ANIMATION;
-  in?: SimpleAnimation;
-  out?: SimpleAnimation;
-};
-
-// 导出具体用途的类型别名，方便代码阅读和维护
-export type HoverAnimation = DualAnimation;
-export type TapAnimation = DualAnimation;
-export type ScrollAnimation = SimpleAnimation;
-export type ViewportAnimation = DualAnimation & {
-  once?: boolean;
-};
-export type SelectionAnimation = DualAnimation;
-
-export type AnchorPlacement =
-  | "top-bottom"
-  | "top-center"
-  | "top-top"
-  | "center-bottom"
-  | "center-center"
-  | "center-top"
-  | "bottom-bottom"
-  | "bottom-center"
-  | "bottom-top";
-
-export type AnchorOffset = {
-  element: number;
-  viewport: number;
-};
-
-export type AnchorOffsets = Record<AnchorPlacement, AnchorOffset>;
+import { PresetAnimations } from "./consts";
+
+// ease配置对象类型，修改为与GSAP兼容的类型
+export type EaseFunction = (progress: number) => number;
+export type EaseString = string;
+
+export interface EaseConfig {
+  type?: string; // 如 "back", "elastic", "bounce" 等
+  config?: {
+    // 配置参数
+    amplitude?: number;
+    period?: number;
+    overshoot?: number;
+    friction?: number;
+    velocity?: number;
+  };
+}
+
+export type AnimationStyles = {
+  // CSS变换属性
+  x?: number | string;
+  y?: number | string;
+  z?: number | string;
+  rotation?: number | string;
+  rotationX?: number | string;
+  rotationY?: number | string;
+  rotationZ?: number | string;
+  scale?: number | string;
+  scaleX?: number | string;
+  scaleY?: number | string;
+  opacity?: number;
+
+  // 其他常用属性
+  transformOrigin?: string;
+  transform?: string;
+  backgroundColor?: string;
+  color?: string;
+  width?: number | string;
+  height?: number | string;
+  // 允许任意CSS属性
+  [prop: string]: unknown;
+};
+
+// GSAP TweenVars类型定义
+export type TweenVars = AnimationStyles & {
+  // 动画控制参数 (也存在于IAnimation中，可保留做细粒度控制)
+  delay?: number;
+  duration?: number;
+  ease?: EaseString | EaseFunction;
+  repeat?: number;
+  repeatDelay?: number;
+  yoyo?: boolean;
+  stagger?: number | object;
+};
+
+export type AnchorPlacement =
+  | "top-bottom"
+  | "top-center"
+  | "top-top"
+  | "center-bottom"
+  | "center-center"
+  | "center-top"
+  | "bottom-bottom"
+  | "bottom-center"
+  | "bottom-top";
+
+export type AnchorOffset = {
+  element: number;
+  viewport: number;
+};
+
+export type AnchorOffsets = Record<AnchorPlacement, AnchorOffset>;
+
+export type BaseAnimationConfig = {
+  // 初始状态设置 (gsap.set) - 立即应用，不产生动画
+  initial?: AnimationStyles;
+  // 主动画配置 - 三选一
+  to?: TweenVars; // 到目标状态 (gsap.to)
+  from?: TweenVars; // 从起始状态 (gsap.from)
+  fromTo?: {
+    // 从起始到目标状态 (gsap.fromTo)
+    from: TweenVars;
+    to: TweenVars;
+  };
+  // 通用动画配置
+  duration?: number;
+  delay?: number;
+  ease?: EaseString | EaseFunction;
+  opacity?: number;
+  autoAlpha?: number;
+  visibility?: string;
+};
+
+export type AnimationConfig = BaseAnimationConfig & {
+  preset?: PresetAnimations;
+};
+
+// 视口动画配置扩展接口
+export type AosAnimationConfig = AnimationConfig & {
+  // 进入视口时的动画
+  enter?: AnimationConfig;
+
+  // 离开视口时的动画
+  exit?: AnimationConfig;
+
+  // 是否只触发一次 (默认false)
+  once?: boolean;
+
+  // 可选：触发阈值 (0-1之间，表示元素多少比例可见时触发)
+  threshold?: number;
+
+  // 可选：触发边距 (类似于IntersectionObserver的rootMargin)
+  margin?: string;
+};
+
+// Hover动画配置扩展接口
+export type HoverAnimationConfig = AnimationConfig & {
+  // 鼠标进入时的动画
+  enter?: AnimationConfig;
+
+  // 鼠标离开时的动画
+  exit?: AnimationConfig;
+};
+
+export type PopupAnimationConfig = AnimationConfig & {
+  // 初始状态设置 (gsap.set) - 立即应用，不产生动画
+  initial?: AnimationStyles;
+  // 打开时的动画
+  open?: AnimationConfig;
+
+  // 关闭时的动画
+  close?: AnimationConfig;
+};

package/src/react/components/AttachmentIcon/index.tsx

@@ -0,0 +1,53 @@
+import { forwardRef } from "react";
+
+export type AttachmentIconProps = {
+  extName?: string;
+  className?: string;
+};
+
+export const AttachmentIcon = forwardRef<HTMLDivElement, AttachmentIconProps>(
+  (props, ref) => {
+    const { extName, ...rest } = props;
+    return (
+      <div ref={ref} {...rest}>
+        {extName && extName === ".pdf" ? (
+          <svg
+            fill="currentColor"
+            viewBox="0 0 1024 1024"
+            version="1.1"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path d="M905.185809 178.844158C898.576738 172.685485 891.19337 165.824412 883.21687 158.436127 860.422682 137.322863 837.434925 116.207791 815.697647 96.487895 813.243072 94.261877 813.243072 94.261877 810.786411 92.037081 781.783552 65.781062 757.590948 44.376502 739.713617 29.293612 729.254178 20.469111 721.020606 13.860686 714.970549 9.501727 710.955023 6.608611 707.690543 4.524745 704.47155 2.998714 700.417679 1.07689 696.638044-0.094029 691.307277 0.005928 677.045677 0.273349 665.6 11.769337 665.6 26.182727L665.6 77.352844 665.6 128.522961 665.6 230.863194 665.6 256.448252 691.2 256.448252 896 256.448252 870.4 230.863194 870.4 998.414942 896 972.829884 230.381436 972.829884C187.90385 972.829884 153.6 938.623723 153.6 896.20663L153.6 26.182727 128 51.767786 588.8 51.767786C602.93849 51.767786 614.4 40.312965 614.4 26.182727 614.4 12.05249 602.93849 0.597669 588.8 0.597669L128 0.597669 102.4 0.597669 102.4 26.182727 102.4 896.20663C102.4 966.91021 159.652833 1024 230.381436 1024L896 1024 921.6 1024 921.6 998.414942 921.6 230.863194 921.6 205.278135 896 205.278135 691.2 205.278135 716.8 230.863194 716.8 128.522961 716.8 77.352844 716.8 26.182727C716.8 39.813762 705.748075 50.91427 692.267725 51.167041 687.705707 51.252584 685.069822 50.435995 682.52845 49.231204 682.259458 49.103682 683.344977 49.796618 685.029451 51.010252 689.779394 54.432502 697.145822 60.34494 706.686383 68.394196 724.009052 83.009121 747.816448 104.072869 776.413589 129.961594 778.850014 132.168064 778.850014 132.168064 781.285216 134.376514 802.876774 153.964212 825.739479 174.96442 848.413564 195.966437 856.350957 203.3185 863.697005 210.144893 870.269888 216.269843 874.209847 219.941299 877.019309 222.565641 878.499674 223.951409 888.81866 233.610931 905.019017 233.081212 914.684179 222.768247 924.349344 212.455283 923.819315 196.264383 913.500326 186.604861 911.981323 185.182945 909.155025 182.542876 905.185809 178.844158ZM102.4 461.128719 0 461.128719 0 896.074709 512 896.074709 1024 896.074709 1024 461.128719 153.6 461.128719 153.6 460.531049 102.4 460.531049 102.4 461.128719ZM208.2 711 208.2 819.2 157.6 819.2 157.6 528 269 528C301.533495 528 327.366571 536.466581 346.5 553.4 365.633429 570.333419 375.2 592.733195 375.2 620.6 375.2 649.133476 365.833427 671.333254 347.1 687.2 328.366573 703.066746 302.133502 711 268.4 711L208.2 711ZM208.2 670.4 269 670.4C287.00009 670.4 300.733286 666.166709 310.2 657.7 319.666714 649.233291 324.4 637.000079 324.4 621 324.4 605.266588 319.600047 592.700047 310 583.3 300.399951 573.899953 287.200083 569.066669 270.4 568.8L208.2 568.8 208.2 670.4ZM419.4 819.2 419.4 528 505.4 528C531.133461 528 553.966566 533.733276 573.9 545.2 593.833434 556.666724 609.266611 572.933229 620.2 594 631.133389 615.066771 636.6 639.199863 636.6 666.4L636.6 681C636.6 708.600139 631.100055 732.866562 620.1 753.8 609.099945 774.733438 593.433436 790.866609 573.1 802.2 552.766564 813.533391 529.466799 819.2 503.2 819.2L419.4 819.2ZM470 568.8 470 778.8 503 778.8C529.533466 778.8 549.89993 770.500083 564.1 753.9 578.30007 737.299917 585.533331 713.466822 585.8 682.4L585.8 666.2C585.8 634.599842 578.933402 610.46675 565.2 593.8 551.466598 577.13325 531.533463 568.8 505.4 568.8L470 568.8ZM854.8 695.8 737.6 695.8 737.6 819.2 687 819.2 687 528 872 528 872 568.8 737.6 568.8 737.6 655.4 854.8 655.4 854.8 695.8Z" />
+          </svg>
+        ) : extName && (extName === ".xls" || extName === ".xlsx") ? (
+          <svg
+            fill="currentColor"
+            viewBox="0 0 1024 1024"
+            version="1.1"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path d="M810.18 949.8H213.821c-20.551 0-37.271-16.649-37.271-37.1V111.3c0-20.45 16.72-37.1 37.271-37.1h395.27v143.74c0 52.25 46.97 94.77 104.71 94.77h133.65V912.7c0 20.451-16.72 37.1-37.27 37.1zM678.9 118.68l130.85 130.85H713.8c-19.25 0-34.9-14.169-34.9-31.59v-99.26z m168.551 55.41l-99.89-99.89L673.36 0H213.82C152.16 0 102 49.93 102 111.3v801.4c0 61.371 50.16 111.3 111.821 111.3h596.36C871.84 1024 922 974.071 922 912.7V248.64l-74.55-74.55z" />
+            <path d="M810.18 949.8H213.821c-20.551 0-37.271-16.649-37.271-37.1V111.3c0-20.45 16.72-37.1 37.271-37.1h395.27v143.74c0 52.25 46.97 94.77 104.71 94.77h133.65V912.7c0 20.451-16.72 37.1-37.27 37.1zM678.9 118.68l130.85 130.85H713.8c-19.25 0-34.9-14.169-34.9-31.59v-99.26z m168.551 55.41l-99.89-99.89L673.36 0H213.82C152.16 0 102 49.93 102 111.3v801.4c0 61.371 50.16 111.3 111.821 111.3h596.36C871.84 1024 922 974.071 922 912.7V248.64l-74.55-74.55z" />
+            <path d="M559.714 579.272L668.11 404.855a0.2 0.2 0 0 0-0.17-0.305h-89.12a0.2 0.2 0 0 0-0.174 0.102l-67.604 120.3-70.265-120.303a0.2 0.2 0 0 0-0.173-0.1h-85.779a0.2 0.2 0 0 0-0.168 0.308L461.02 571.401 347.653 746.24a0.2 0.2 0 0 0 0.168 0.309h88.007a0.2 0.2 0 0 0 0.17-0.095l74.362-120.51 75.153 120.51a0.2 0.2 0 0 0 0.17 0.095h89.835a0.2 0.2 0 0 0 0.164-0.314L559.714 579.272z" />
+          </svg>
+        ) : extName && (extName === ".doc" || extName === ".docx") ? (
+          <svg
+            fill="currentColor"
+            viewBox="0 0 1024 1024"
+            version="1.1"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path d="M854.6 288.6L639.4 73.4c-6-6-14.1-9.4-22.6-9.4H192c-17.7 0-32 14.3-32 32v832c0 17.7 14.3 32 32 32h640c17.7 0 32-14.3 32-32V311.3c0-8.5-3.4-16.7-9.4-22.7zM790.2 326H602V137.8L790.2 326z m1.8 562H232V136h302v216c0 23.2 18.8 42 42 42h216v494zM528.1 472h-32.2c-5.5 0-10.3 3.7-11.6 9.1L434.6 680l-46.1-198.7c-1.3-5.4-6.1-9.3-11.7-9.3h-35.4c-1.1 0-2.1 0.1-3.1 0.4-6.4 1.7-10.2 8.3-8.5 14.7l74.2 276c1.4 5.2 6.2 8.9 11.6 8.9h32c5.4 0 10.2-3.6 11.6-8.9l52.8-197 52.8 197c1.4 5.2 6.2 8.9 11.6 8.9h31.8c5.4 0 10.2-3.6 11.6-8.9l74.4-276c0.3-1 0.4-2.1 0.4-3.1 0-6.6-5.4-12-12-12H647c-5.6 0-10.4 3.9-11.7 9.3l-45.8 199.1-49.8-199.3c-1.3-5.4-6.1-9.1-11.6-9.1z" />
+          </svg>
+        ) : (
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path
+              fill="currentColor"
+              d="M14 11a3 3 0 0 1-3-3V4H7a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2h9a2 2 0 0 0 2-2v-8zm-2-3a2 2 0 0 0 2 2h3.59L12 4.41zM7 3h5l7 7v9a3 3 0 0 1-3 3H7a3 3 0 0 1-3-3V6a3 3 0 0 1 3-3"
+            />
+          </svg>
+        )}
+      </div>
+    );
+  }
+);