@tiny-design/react 1.1.2 → 1.3.0

package/lib/transition/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Transition"],"sources":["../../src/transition/index.tsx"],"sourcesContent":["import Transition from './transition';\n\nexport type { AnimationName, TransitionProps } from './transition';\nexport default Transition;\n"],"mappings":";AAGA,IAAA,gDAAeA"}
+{"version":3,"file":"index.js","names":["Transition"],"sources":["../../src/transition/index.tsx"],"sourcesContent":["import Transition from './transition';\n\nexport type { AnimationName, TransitionProps } from './transition';\nexport { default as useTransition } from './use-transition';\nexport type { TransitionState, UseTransitionOptions, UseTransitionResult } from './use-transition';\nexport default Transition;\n"],"mappings":";;AAKA,IAAA,gDAAeA"}

package/lib/transition/transition.d.ts

@@ -1,16 +1,31 @@
 import React from "react";
-import { CSSTransitionProps } from "react-transition-group/CSSTransition";
 
 //#region src/transition/transition.d.ts
 type AnimationName = 'zoom-center-top' | 'zoom-center-bottom' | 'zoom-center-left' | 'zoom-center-right' | 'zoom-top-start' | 'zoom-top' | 'zoom-top-end' | 'zoom-bottom-start' | 'zoom-bottom' | 'zoom-bottom-end' | 'zoom-left-start' | 'zoom-left' | 'zoom-left-end' | 'zoom-right-start' | 'zoom-right' | 'zoom-right-end' | 'slide-up' | 'slide-down';
 type TransitionProps = {
-  /** Animation prefix */prefix?: string; /** Preset animation name */
-  animation?: AnimationName; /** Prevent the transition conflict with the inner component */
+  in?: boolean;
+  timeout?: number | {
+    enter: number;
+    exit: number;
+  };
+  appear?: boolean;
+  unmountOnExit?: boolean;
+  mountOnEnter?: boolean; /** Animation prefix */
+  prefix?: string; /** Preset animation name */
+  animation?: AnimationName; /** Custom class name base (overrides prefix + animation) */
+  classNames?: string; /** Prevent the transition conflict with the inner component */
   wrapper?: boolean;
+  nodeRef?: React.RefObject<HTMLElement | null>;
+  onEnter?: () => void;
+  onEntering?: () => void;
+  onEntered?: () => void;
+  onExit?: () => void;
+  onExiting?: () => void;
+  onExited?: () => void;
   children?: React.ReactNode;
-} & Partial<CSSTransitionProps<HTMLElement>>;
+};
 declare const Transition: {
-  (props: TransitionProps): React.ReactElement;
+  (props: TransitionProps): React.ReactElement | null;
   displayName: string;
 };
 //#endregion

package/lib/transition/transition.js

@@ -1,20 +1,45 @@
 const require_runtime = require("../_virtual/_rolldown/runtime.js");
+const require_use_transition = require("./use-transition.js");
 let react = require("react");
 react = require_runtime.__toESM(react);
 let react_jsx_runtime = require("react/jsx-runtime");
-let react_transition_group = require("react-transition-group");
 //#region src/transition/transition.tsx
+function getTransitionClasses(base, state) {
+	switch (state) {
+		case "enter": return `${base}-enter`;
+		case "entering": return `${base}-enter ${base}-enter-active`;
+		case "entered": return `${base}-enter-done`;
+		case "exit": return `${base}-exit`;
+		case "exiting": return `${base}-exit ${base}-exit-active`;
+		case "exited": return `${base}-exit-done`;
+		default: return "";
+	}
+}
 const Transition = (props) => {
-	const { timeout = 300, unmountOnExit = true, appear = true, prefix = "ty", animation, classNames, nodeRef, children, wrapper, ...otherProps } = props;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_transition_group.CSSTransition, {
-		...otherProps,
+	const { in: inProp = false, timeout = 300, unmountOnExit = true, mountOnEnter, appear = true, prefix = "ty", animation, classNames: classNamesProp, nodeRef, children, wrapper, onEnter, onEntering, onEntered, onExit, onExiting, onExited } = props;
+	const { state, shouldMount } = require_use_transition.default({
+		in: inProp,
 		timeout,
 		appear,
 		unmountOnExit,
-		nodeRef,
-		classNames: classNames ? classNames : `${prefix}-${animation}`,
-		children: wrapper ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children }) : children
+		mountOnEnter,
+		onEnter,
+		onEntering,
+		onEntered,
+		onExit,
+		onExiting,
+		onExited,
+		nodeRef
 	});
+	if (!shouldMount) return null;
+	const transitionClasses = getTransitionClasses(classNamesProp ? classNamesProp : `${prefix}-${animation}`, state);
+	const child = wrapper ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children }) : children;
+	if (react.default.isValidElement(child)) {
+		const existingClassName = child.props.className || "";
+		const mergedClassName = existingClassName ? `${existingClassName} ${transitionClasses}`.trim() : transitionClasses;
+		return react.default.cloneElement(child, { className: mergedClassName || void 0 });
+	}
+	return child;
 };
 Transition.displayName = "Transition";
 //#endregion

package/lib/transition/transition.js.map

@@ -1 +1 @@
-{"version":3,"file":"transition.js","names":["CSSTransition"],"sources":["../../src/transition/transition.tsx"],"sourcesContent":["import React from 'react';\nimport { CSSTransition } from 'react-transition-group';\nimport { CSSTransitionProps } from 'react-transition-group/CSSTransition';\n\nexport type AnimationName =\n  | 'zoom-center-top'\n  | 'zoom-center-bottom'\n  | 'zoom-center-left'\n  | 'zoom-center-right'\n  | 'zoom-top-start'\n  | 'zoom-top'\n  | 'zoom-top-end'\n  | 'zoom-bottom-start'\n  | 'zoom-bottom'\n  | 'zoom-bottom-end'\n  | 'zoom-left-start'\n  | 'zoom-left'\n  | 'zoom-left-end'\n  | 'zoom-right-start'\n  | 'zoom-right'\n  | 'zoom-right-end'\n  | 'slide-up'\n  | 'slide-down';\n\nexport type TransitionProps = {\n  /** Animation prefix */\n  prefix?: string;\n\n  /** Preset animation name */\n  animation?: AnimationName;\n\n  /** Prevent the transition conflict with the inner component */\n  wrapper?: boolean;\n  children?: React.ReactNode;\n} & Partial<CSSTransitionProps<HTMLElement>>;\n\nconst Transition = (props: TransitionProps): React.ReactElement => {\n  const {\n    timeout = 300,\n    unmountOnExit = true,\n    appear = true,\n    prefix = 'ty',\n    animation,\n    classNames,\n    nodeRef,\n    children,\n    wrapper,\n    ...otherProps\n  } = props;\n\n  return (\n    <CSSTransition\n      {...(otherProps as CSSTransitionProps<HTMLElement>)}\n      timeout={timeout}\n      appear={appear}\n      unmountOnExit={unmountOnExit}\n      nodeRef={nodeRef}\n      classNames={classNames ? classNames : `${prefix}-${animation}`}>\n      {wrapper ? <div>{children}</div> : (children as React.ReactElement)}\n    </CSSTransition>\n  );\n};\n\nTransition.displayName = 'Transition';\n\nexport default Transition;\n"],"mappings":";;;;;;AAoCA,MAAM,cAAc,UAA+C;CACjE,MAAM,EACJ,UAAU,KACV,gBAAgB,MAChB,SAAS,MACT,SAAS,MACT,WACA,YACA,SACA,UACA,SACA,GAAG,eACD;AAEJ,QACE,iBAAA,GAAA,kBAAA,KAACA,uBAAAA,eAAD;EACE,GAAK;EACI;EACD;EACO;EACN;EACT,YAAY,aAAa,aAAa,GAAG,OAAO,GAAG;YAClD,UAAU,iBAAA,GAAA,kBAAA,KAAC,OAAD,EAAM,UAAe,CAAA,GAAI;EACtB,CAAA;;AAIpB,WAAW,cAAc"}
+{"version":3,"file":"transition.js","names":["useTransition","React"],"sources":["../../src/transition/transition.tsx"],"sourcesContent":["import React from 'react';\nimport useTransition, { TransitionState } from './use-transition';\n\nexport type AnimationName =\n  | 'zoom-center-top'\n  | 'zoom-center-bottom'\n  | 'zoom-center-left'\n  | 'zoom-center-right'\n  | 'zoom-top-start'\n  | 'zoom-top'\n  | 'zoom-top-end'\n  | 'zoom-bottom-start'\n  | 'zoom-bottom'\n  | 'zoom-bottom-end'\n  | 'zoom-left-start'\n  | 'zoom-left'\n  | 'zoom-left-end'\n  | 'zoom-right-start'\n  | 'zoom-right'\n  | 'zoom-right-end'\n  | 'slide-up'\n  | 'slide-down';\n\nexport type TransitionProps = {\n  in?: boolean;\n  timeout?: number | { enter: number; exit: number };\n  appear?: boolean;\n  unmountOnExit?: boolean;\n  mountOnEnter?: boolean;\n\n  /** Animation prefix */\n  prefix?: string;\n\n  /** Preset animation name */\n  animation?: AnimationName;\n\n  /** Custom class name base (overrides prefix + animation) */\n  classNames?: string;\n\n  /** Prevent the transition conflict with the inner component */\n  wrapper?: boolean;\n\n  nodeRef?: React.RefObject<HTMLElement | null>;\n\n  onEnter?: () => void;\n  onEntering?: () => void;\n  onEntered?: () => void;\n  onExit?: () => void;\n  onExiting?: () => void;\n  onExited?: () => void;\n\n  children?: React.ReactNode;\n};\n\nfunction getTransitionClasses(base: string, state: TransitionState): string {\n  switch (state) {\n    case 'enter':\n      return `${base}-enter`;\n    case 'entering':\n      return `${base}-enter ${base}-enter-active`;\n    case 'entered':\n      return `${base}-enter-done`;\n    case 'exit':\n      return `${base}-exit`;\n    case 'exiting':\n      return `${base}-exit ${base}-exit-active`;\n    case 'exited':\n      return `${base}-exit-done`;\n    default:\n      return '';\n  }\n}\n\nconst Transition = (props: TransitionProps): React.ReactElement | null => {\n  const {\n    in: inProp = false,\n    timeout = 300,\n    unmountOnExit = true,\n    mountOnEnter,\n    appear = true,\n    prefix = 'ty',\n    animation,\n    classNames: classNamesProp,\n    nodeRef,\n    children,\n    wrapper,\n    onEnter,\n    onEntering,\n    onEntered,\n    onExit,\n    onExiting,\n    onExited,\n  } = props;\n\n  const { state, shouldMount } = useTransition({\n    in: inProp,\n    timeout,\n    appear,\n    unmountOnExit,\n    mountOnEnter,\n    onEnter,\n    onEntering,\n    onEntered,\n    onExit,\n    onExiting,\n    onExited,\n    nodeRef,\n  });\n\n  if (!shouldMount) {\n    return null;\n  }\n\n  const base = classNamesProp ? classNamesProp : `${prefix}-${animation}`;\n  const transitionClasses = getTransitionClasses(base, state);\n\n  const child = wrapper ? <div>{children}</div> : children;\n\n  if (React.isValidElement(child)) {\n    const existingClassName = (child.props as { className?: string }).className || '';\n    const mergedClassName = existingClassName\n      ? `${existingClassName} ${transitionClasses}`.trim()\n      : transitionClasses;\n\n    return React.cloneElement(child as React.ReactElement<{ className?: string }>, {\n      className: mergedClassName || undefined,\n    });\n  }\n\n  return child as React.ReactElement;\n};\n\nTransition.displayName = 'Transition';\n\nexport default Transition;\n"],"mappings":";;;;;;AAsDA,SAAS,qBAAqB,MAAc,OAAgC;AAC1E,SAAQ,OAAR;EACE,KAAK,QACH,QAAO,GAAG,KAAK;EACjB,KAAK,WACH,QAAO,GAAG,KAAK,SAAS,KAAK;EAC/B,KAAK,UACH,QAAO,GAAG,KAAK;EACjB,KAAK,OACH,QAAO,GAAG,KAAK;EACjB,KAAK,UACH,QAAO,GAAG,KAAK,QAAQ,KAAK;EAC9B,KAAK,SACH,QAAO,GAAG,KAAK;EACjB,QACE,QAAO;;;AAIb,MAAM,cAAc,UAAsD;CACxE,MAAM,EACJ,IAAI,SAAS,OACb,UAAU,KACV,gBAAgB,MAChB,cACA,SAAS,MACT,SAAS,MACT,WACA,YAAY,gBACZ,SACA,UACA,SACA,SACA,YACA,WACA,QACA,WACA,aACE;CAEJ,MAAM,EAAE,OAAO,gBAAgBA,uBAAAA,QAAc;EAC3C,IAAI;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;AAEF,KAAI,CAAC,YACH,QAAO;CAIT,MAAM,oBAAoB,qBADb,iBAAiB,iBAAiB,GAAG,OAAO,GAAG,aACP,MAAM;CAE3D,MAAM,QAAQ,UAAU,iBAAA,GAAA,kBAAA,KAAC,OAAD,EAAM,UAAe,CAAA,GAAG;AAEhD,KAAIC,MAAAA,QAAM,eAAe,MAAM,EAAE;EAC/B,MAAM,oBAAqB,MAAM,MAAiC,aAAa;EAC/E,MAAM,kBAAkB,oBACpB,GAAG,kBAAkB,GAAG,oBAAoB,MAAM,GAClD;AAEJ,SAAOA,MAAAA,QAAM,aAAa,OAAqD,EAC7E,WAAW,mBAAmB,KAAA,GAC/B,CAAC;;AAGJ,QAAO;;AAGT,WAAW,cAAc"}

package/lib/transition/use-transition.js

@@ -0,0 +1,138 @@
+require("../_virtual/_rolldown/runtime.js");
+let react = require("react");
+//#region src/transition/use-transition.ts
+function normalizeTimeout(timeout) {
+	if (timeout == null) return {
+		enter: 300,
+		exit: 300
+	};
+	if (typeof timeout === "number") return {
+		enter: timeout,
+		exit: timeout
+	};
+	return timeout;
+}
+function useTransition(options) {
+	const { in: inProp, timeout, appear = true, unmountOnExit = true, mountOnEnter = false, onEnter, onEntering, onEntered, onExit, onExiting, onExited, nodeRef } = options;
+	const normalizedTimeout = normalizeTimeout(timeout);
+	const getInitialState = () => {
+		if (inProp) return appear ? "enter" : "entered";
+		if (unmountOnExit || mountOnEnter) return "unmounted";
+		return "exited";
+	};
+	const [state, setState] = (0, react.useState)(getInitialState);
+	const rafRef = (0, react.useRef)(0);
+	const timerRef = (0, react.useRef)(0);
+	const transitionEndRef = (0, react.useRef)(null);
+	const initialMountRef = (0, react.useRef)(true);
+	const callbacksRef = (0, react.useRef)({
+		onEnter,
+		onEntering,
+		onEntered,
+		onExit,
+		onExiting,
+		onExited
+	});
+	callbacksRef.current = {
+		onEnter,
+		onEntering,
+		onEntered,
+		onExit,
+		onExiting,
+		onExited
+	};
+	const cleanup = (0, react.useCallback)(() => {
+		if (rafRef.current) {
+			cancelAnimationFrame(rafRef.current);
+			rafRef.current = 0;
+		}
+		if (timerRef.current) {
+			clearTimeout(timerRef.current);
+			timerRef.current = 0;
+		}
+		if (transitionEndRef.current && nodeRef?.current) {
+			nodeRef.current.removeEventListener("transitionend", transitionEndRef.current);
+			transitionEndRef.current = null;
+		}
+	}, [nodeRef]);
+	const waitForTransition = (0, react.useCallback)((phase, done) => {
+		const safetyDuration = phase === "enter" ? normalizedTimeout.enter : normalizedTimeout.exit;
+		if (safetyDuration === 0) {
+			done();
+			return;
+		}
+		const finish = () => {
+			cleanup();
+			done();
+		};
+		const node = nodeRef?.current;
+		if (node) {
+			const handler = (e) => {
+				if (e.target === node) finish();
+			};
+			transitionEndRef.current = handler;
+			node.addEventListener("transitionend", handler);
+		}
+		timerRef.current = window.setTimeout(finish, safetyDuration + 50);
+	}, [
+		cleanup,
+		nodeRef,
+		normalizedTimeout.enter,
+		normalizedTimeout.exit
+	]);
+	(0, react.useLayoutEffect)(() => {
+		if (state === "enter") {
+			callbacksRef.current.onEnter?.();
+			rafRef.current = requestAnimationFrame(() => {
+				setState("entering");
+				callbacksRef.current.onEntering?.();
+				waitForTransition("enter", () => {
+					setState("entered");
+					callbacksRef.current.onEntered?.();
+				});
+			});
+		}
+	}, [state]);
+	(0, react.useLayoutEffect)(() => {
+		if (state === "exit") {
+			callbacksRef.current.onExit?.();
+			rafRef.current = requestAnimationFrame(() => {
+				setState("exiting");
+				callbacksRef.current.onExiting?.();
+				waitForTransition("exit", () => {
+					setState((prev) => {
+						if (prev === "exiting") {
+							callbacksRef.current.onExited?.();
+							return unmountOnExit ? "unmounted" : "exited";
+						}
+						return prev;
+					});
+				});
+			});
+		}
+	}, [state]);
+	(0, react.useEffect)(() => {
+		if (initialMountRef.current) {
+			initialMountRef.current = false;
+			return;
+		}
+		if (inProp) {
+			cleanup();
+			setState("enter");
+		} else {
+			cleanup();
+			setState("exit");
+		}
+	}, [inProp]);
+	(0, react.useEffect)(() => {
+		return cleanup;
+	}, [cleanup]);
+	return {
+		state,
+		shouldMount: state !== "unmounted"
+	};
+}
+//#endregion
+exports.default = useTransition;
+
+//# sourceMappingURL=use-transition.js.map

package/lib/transition/use-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transition.js","names":[],"sources":["../../src/transition/use-transition.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';\n\nexport type TransitionState =\n  | 'unmounted'\n  | 'enter'\n  | 'entering'\n  | 'entered'\n  | 'exit'\n  | 'exiting'\n  | 'exited';\n\nexport interface UseTransitionOptions {\n  in: boolean;\n  timeout?: number | { enter: number; exit: number };\n  appear?: boolean;\n  unmountOnExit?: boolean;\n  mountOnEnter?: boolean;\n  onEnter?: () => void;\n  onEntering?: () => void;\n  onEntered?: () => void;\n  onExit?: () => void;\n  onExiting?: () => void;\n  onExited?: () => void;\n  nodeRef?: React.RefObject<HTMLElement | null>;\n}\n\nexport interface UseTransitionResult {\n  state: TransitionState;\n  shouldMount: boolean;\n}\n\nfunction normalizeTimeout(\n  timeout: number | { enter: number; exit: number } | undefined\n): { enter: number; exit: number } {\n  if (timeout == null) return { enter: 300, exit: 300 };\n  if (typeof timeout === 'number') return { enter: timeout, exit: timeout };\n  return timeout;\n}\n\nfunction useTransition(options: UseTransitionOptions): UseTransitionResult {\n  const {\n    in: inProp,\n    timeout,\n    appear = true,\n    unmountOnExit = true,\n    mountOnEnter = false,\n    onEnter,\n    onEntering,\n    onEntered,\n    onExit,\n    onExiting,\n    onExited,\n    nodeRef,\n  } = options;\n\n  const normalizedTimeout = normalizeTimeout(timeout);\n\n  // Determine initial state\n  const getInitialState = (): TransitionState => {\n    if (inProp) {\n      return appear ? 'enter' : 'entered';\n    }\n    if (unmountOnExit || mountOnEnter) {\n      return 'unmounted';\n    }\n    return 'exited';\n  };\n\n  const [state, setState] = useState<TransitionState>(getInitialState);\n  const rafRef = useRef<number>(0);\n  const timerRef = useRef<number>(0);\n  const transitionEndRef = useRef<(() => void) | null>(null);\n  const initialMountRef = useRef(true);\n\n  // Store latest callbacks in refs to avoid re-triggering effects\n  const callbacksRef = useRef({\n    onEnter,\n    onEntering,\n    onEntered,\n    onExit,\n    onExiting,\n    onExited,\n  });\n  callbacksRef.current = {\n    onEnter,\n    onEntering,\n    onEntered,\n    onExit,\n    onExiting,\n    onExited,\n  };\n\n  const cleanup = useCallback(() => {\n    if (rafRef.current) {\n      cancelAnimationFrame(rafRef.current);\n      rafRef.current = 0;\n    }\n    if (timerRef.current) {\n      clearTimeout(timerRef.current);\n      timerRef.current = 0;\n    }\n    if (transitionEndRef.current && nodeRef?.current) {\n      nodeRef.current.removeEventListener('transitionend', transitionEndRef.current);\n      transitionEndRef.current = null;\n    }\n  }, [nodeRef]);\n\n  const waitForTransition = useCallback(\n    (phase: 'enter' | 'exit', done: () => void) => {\n      const safetyDuration =\n        phase === 'enter' ? normalizedTimeout.enter : normalizedTimeout.exit;\n\n      // timeout=0 means \"don't wait\" — advance immediately.\n      // This matches react-transition-group's behavior where timeout=0\n      // skips straight to the done state, letting CSS handle the animation\n      // via the base element's transition property.\n      if (safetyDuration === 0) {\n        done();\n        return;\n      }\n\n      const finish = () => {\n        cleanup();\n        done();\n      };\n\n      // Try transitionend listener first\n      const node = nodeRef?.current;\n      if (node) {\n        const handler = (e: Event) => {\n          if ((e as TransitionEvent).target === node) {\n            finish();\n          }\n        };\n        transitionEndRef.current = handler as () => void;\n        node.addEventListener('transitionend', handler);\n      }\n\n      // Safety timeout fallback\n      timerRef.current = window.setTimeout(finish, safetyDuration + 50);\n    },\n    [cleanup, nodeRef, normalizedTimeout.enter, normalizedTimeout.exit]\n  );\n\n  // Continue the enter animation after DOM is committed (state === 'enter').\n  // useLayoutEffect fires synchronously after DOM mutations, guaranteeing\n  // the child is mounted and refs are populated before onEnter runs.\n  useLayoutEffect(() => {\n    if (state === 'enter') {\n      callbacksRef.current.onEnter?.();\n\n      // Single rAF: useLayoutEffect runs before paint, so one rAF is enough\n      // to ensure the browser has painted the -enter class before we add -enter-active.\n      rafRef.current = requestAnimationFrame(() => {\n        setState('entering');\n        callbacksRef.current.onEntering?.();\n\n        waitForTransition('enter', () => {\n          setState('entered');\n          callbacksRef.current.onEntered?.();\n        });\n      });\n    }\n  }, [state]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // Continue the exit animation after DOM reflects exit state\n  useLayoutEffect(() => {\n    if (state === 'exit') {\n      callbacksRef.current.onExit?.();\n\n      rafRef.current = requestAnimationFrame(() => {\n        setState('exiting');\n        callbacksRef.current.onExiting?.();\n\n        waitForTransition('exit', () => {\n          setState((prev) => {\n            if (prev === 'exiting') {\n              callbacksRef.current.onExited?.();\n              return unmountOnExit ? 'unmounted' : 'exited';\n            }\n            return prev;\n          });\n        });\n      });\n    }\n  }, [state]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // React to `in` prop changes — only set the initial phase state.\n  // The useLayoutEffect above handles the rest after DOM commit.\n  useEffect(() => {\n    if (initialMountRef.current) {\n      initialMountRef.current = false;\n      // On initial mount with appear=true, state is already 'enter' from getInitialState,\n      // and the useLayoutEffect above will pick it up.\n      return;\n    }\n\n    if (inProp) {\n      cleanup();\n      setState('enter');\n    } else {\n      cleanup();\n      setState('exit');\n    }\n  }, [inProp]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return cleanup;\n  }, [cleanup]);\n\n  const shouldMount = state !== 'unmounted';\n\n  return { state, shouldMount };\n}\n\nexport default useTransition;\n"],"mappings":"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"}

package/lib/waterfall/hooks/use-breakpoint.js

@@ -0,0 +1,49 @@
+require("../../_virtual/_rolldown/runtime.js");
+let react = require("react");
+//#region src/waterfall/hooks/use-breakpoint.ts
+const breakpointMap = {
+	xxl: "(min-width: 1600px)",
+	xl: "(min-width: 1200px)",
+	lg: "(min-width: 992px)",
+	md: "(min-width: 768px)",
+	sm: "(min-width: 576px)",
+	xs: "(max-width: 575.98px)"
+};
+const responsiveArray = [
+	"xxl",
+	"xl",
+	"lg",
+	"md",
+	"sm",
+	"xs"
+];
+function useBreakpoint() {
+	const [screens, setScreens] = (0, react.useState)({});
+	(0, react.useEffect)(() => {
+		if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
+		const queries = /* @__PURE__ */ new Map();
+		const update = () => {
+			const next = {};
+			for (const bp of responsiveArray) {
+				const mql = queries.get(bp);
+				if (mql) next[bp] = mql.matches;
+			}
+			setScreens(next);
+		};
+		for (const bp of responsiveArray) {
+			const mql = window.matchMedia(breakpointMap[bp]);
+			queries.set(bp, mql);
+			mql.addEventListener("change", update);
+		}
+		update();
+		return () => {
+			for (const [, mql] of queries) mql.removeEventListener("change", update);
+		};
+	}, []);
+	return screens;
+}
+//#endregion
+exports.default = useBreakpoint;
+exports.responsiveArray = responsiveArray;
+
+//# sourceMappingURL=use-breakpoint.js.map

package/lib/waterfall/hooks/use-breakpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-breakpoint.js","names":[],"sources":["../../../src/waterfall/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\nimport { Breakpoint } from '../types';\n\nconst breakpointMap: Record<Breakpoint, string> = {\n  xxl: '(min-width: 1600px)',\n  xl: '(min-width: 1200px)',\n  lg: '(min-width: 992px)',\n  md: '(min-width: 768px)',\n  sm: '(min-width: 576px)',\n  xs: '(max-width: 575.98px)',\n};\n\nconst responsiveArray: Breakpoint[] = ['xxl', 'xl', 'lg', 'md', 'sm', 'xs'];\n\ntype Screens = Partial<Record<Breakpoint, boolean>>;\n\nexport { responsiveArray };\n\nexport default function useBreakpoint(): Screens {\n  const [screens, setScreens] = useState<Screens>({});\n\n  useEffect(() => {\n    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return;\n\n    const queries = new Map<Breakpoint, MediaQueryList>();\n\n    const update = () => {\n      const next: Screens = {};\n      for (const bp of responsiveArray) {\n        const mql = queries.get(bp);\n        if (mql) {\n          next[bp] = mql.matches;\n        }\n      }\n      setScreens(next);\n    };\n\n    for (const bp of responsiveArray) {\n      const mql = window.matchMedia(breakpointMap[bp]);\n      queries.set(bp, mql);\n      mql.addEventListener('change', update);\n    }\n\n    update();\n\n    return () => {\n      for (const [, mql] of queries) {\n        mql.removeEventListener('change', update);\n      }\n    };\n  }, []);\n\n  return screens;\n}\n"],"mappings":";;;AAGA,MAAM,gBAA4C;CAChD,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACL;AAED,MAAM,kBAAgC;CAAC;CAAO;CAAM;CAAM;CAAM;CAAM;CAAK;AAM3E,SAAwB,gBAAyB;CAC/C,MAAM,CAAC,SAAS,eAAA,GAAA,MAAA,UAAgC,EAAE,CAAC;AAEnD,EAAA,GAAA,MAAA,iBAAgB;AACd,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAAY;EAE9E,MAAM,0BAAU,IAAI,KAAiC;EAErD,MAAM,eAAe;GACnB,MAAM,OAAgB,EAAE;AACxB,QAAK,MAAM,MAAM,iBAAiB;IAChC,MAAM,MAAM,QAAQ,IAAI,GAAG;AAC3B,QAAI,IACF,MAAK,MAAM,IAAI;;AAGnB,cAAW,KAAK;;AAGlB,OAAK,MAAM,MAAM,iBAAiB;GAChC,MAAM,MAAM,OAAO,WAAW,cAAc,IAAI;AAChD,WAAQ,IAAI,IAAI,IAAI;AACpB,OAAI,iBAAiB,UAAU,OAAO;;AAGxC,UAAQ;AAER,eAAa;AACX,QAAK,MAAM,GAAG,QAAQ,QACpB,KAAI,oBAAoB,UAAU,OAAO;;IAG5C,EAAE,CAAC;AAEN,QAAO"}

package/lib/waterfall/hooks/use-positions.js

@@ -0,0 +1,29 @@
+require("../../_virtual/_rolldown/runtime.js");
+let react = require("react");
+//#region src/waterfall/hooks/use-positions.ts
+function usePositions(itemHeights, columnCount, verticalGutter) {
+	return (0, react.useMemo)(() => {
+		const columnHeights = new Array(columnCount).fill(0);
+		const positions = /* @__PURE__ */ new Map();
+		for (let i = 0; i < itemHeights.length; i += 1) {
+			const [itemKey, itemHeight, itemColumn] = itemHeights[i];
+			let targetColumn = itemColumn ?? columnHeights.indexOf(Math.min(...columnHeights));
+			targetColumn = Math.min(targetColumn, columnCount - 1);
+			const top = columnHeights[targetColumn];
+			positions.set(itemKey, {
+				column: targetColumn,
+				top
+			});
+			columnHeights[targetColumn] += itemHeight + verticalGutter;
+		}
+		return [positions, Math.max(0, Math.max(...columnHeights) - verticalGutter)];
+	}, [
+		columnCount,
+		itemHeights,
+		verticalGutter
+	]);
+}
+//#endregion
+exports.default = usePositions;
+
+//# sourceMappingURL=use-positions.js.map

package/lib/waterfall/hooks/use-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-positions.js","names":[],"sources":["../../../src/waterfall/hooks/use-positions.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nexport type ItemHeightData = [key: React.Key, height: number, column?: number];\n\nexport type ItemPositions = Map<\n  React.Key,\n  {\n    column: number;\n    top: number;\n  }\n>;\n\nexport default function usePositions(\n  itemHeights: ItemHeightData[],\n  columnCount: number,\n  verticalGutter: number,\n): [ItemPositions, number] {\n  return useMemo(() => {\n    const columnHeights = new Array(columnCount).fill(0) as number[];\n    const positions: ItemPositions = new Map();\n\n    for (let i = 0; i < itemHeights.length; i += 1) {\n      const [itemKey, itemHeight, itemColumn] = itemHeights[i];\n\n      let targetColumn = itemColumn ?? columnHeights.indexOf(Math.min(...columnHeights));\n      targetColumn = Math.min(targetColumn, columnCount - 1);\n\n      const top = columnHeights[targetColumn];\n      positions.set(itemKey, { column: targetColumn, top });\n\n      columnHeights[targetColumn] += itemHeight + verticalGutter;\n    }\n\n    const totalHeight = Math.max(0, Math.max(...columnHeights) - verticalGutter);\n    return [positions, totalHeight];\n  }, [columnCount, itemHeights, verticalGutter]);\n}\n"],"mappings":";;;AAYA,SAAwB,aACtB,aACA,aACA,gBACyB;AACzB,SAAA,GAAA,MAAA,eAAqB;EACnB,MAAM,gBAAgB,IAAI,MAAM,YAAY,CAAC,KAAK,EAAE;EACpD,MAAM,4BAA2B,IAAI,KAAK;AAE1C,OAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK,GAAG;GAC9C,MAAM,CAAC,SAAS,YAAY,cAAc,YAAY;GAEtD,IAAI,eAAe,cAAc,cAAc,QAAQ,KAAK,IAAI,GAAG,cAAc,CAAC;AAClF,kBAAe,KAAK,IAAI,cAAc,cAAc,EAAE;GAEtD,MAAM,MAAM,cAAc;AAC1B,aAAU,IAAI,SAAS;IAAE,QAAQ;IAAc;IAAK,CAAC;AAErD,iBAAc,iBAAiB,aAAa;;AAI9C,SAAO,CAAC,WADY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,cAAc,GAAG,eAAe,CAC7C;IAC9B;EAAC;EAAa;EAAa;EAAe,CAAC"}

package/lib/waterfall/index.js

@@ -0,0 +1,8 @@
+require('../style/base.css');
+require('./style/index.css');
+//#region src/waterfall/index.tsx
+var waterfall_default = require("./waterfall.js").default;
+//#endregion
+exports.default = waterfall_default;
+
+//# sourceMappingURL=index.js.map

package/lib/waterfall/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Waterfall"],"sources":["../../src/waterfall/index.tsx"],"sourcesContent":["import Waterfall from './waterfall';\n\nexport type { WaterfallProps, WaterfallItem, Breakpoint } from './types';\n\nexport default Waterfall;\n"],"mappings":";AAIA,IAAA,8CAAeA"}

package/lib/waterfall/style/_index.scss

@@ -0,0 +1,22 @@
+@use '../../style/variables' as *;
+
+.#{$prefix}-waterfall {
+  position: relative;
+  width: 100%;
+  box-sizing: border-box;
+
+  &__item {
+    position: absolute;
+    box-sizing: border-box;
+  }
+
+  // Exit animation
+  &__item-fade-exit {
+    opacity: 1;
+  }
+
+  &__item-fade-exit-active {
+    opacity: 0;
+    transition: opacity 0.3s ease;
+  }
+}

package/lib/waterfall/style/index.css

@@ -0,0 +1,16 @@
+.ty-waterfall {
+  position: relative;
+  width: 100%;
+  box-sizing: border-box;
+}
+.ty-waterfall__item {
+  position: absolute;
+  box-sizing: border-box;
+}
+.ty-waterfall__item-fade-exit {
+  opacity: 1;
+}
+.ty-waterfall__item-fade-exit-active {
+  opacity: 0;
+  transition: opacity 0.3s ease;
+}

package/lib/waterfall/style/index.d.ts

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

package/lib/waterfall/style/index.js

@@ -0,0 +1 @@
+require("./_index.css");

package/lib/waterfall/types.d.ts

@@ -0,0 +1,35 @@
+import { BaseProps } from "../_utils/props.js";
+import React, { ReactNode } from "react";
+
+//#region src/waterfall/types.d.ts
+type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+interface WaterfallItem<T = any> {
+  key: React.Key;
+  /** Pin this item to a specific column index */
+  column?: number;
+  /** Direct content — takes priority over itemRender */
+  children?: ReactNode;
+  /** Custom data passed to itemRender */
+  data?: T;
+}
+interface WaterfallProps<T = any> extends BaseProps, Omit<React.PropsWithRef<JSX.IntrinsicElements['div']>, 'children'> {
+  /** Number of columns, or responsive breakpoint config. Default: 3 */
+  columns?: number | Partial<Record<Breakpoint, number>>;
+  /** Spacing between items: number or [horizontal, vertical] */
+  gutter?: number | [number, number];
+  /** Array of items to render */
+  items?: WaterfallItem<T>[];
+  /** Custom render function for each item */
+  itemRender?: (item: WaterfallItem<T> & {
+    index: number;
+    column: number;
+  }) => ReactNode;
+  /** Callback when layout order changes */
+  onLayoutChange?: (sortInfo: {
+    key: React.Key;
+    column: number;
+  }[]) => void;
+}
+//#endregion
+export { WaterfallProps };
+//# sourceMappingURL=types.d.ts.map

package/lib/waterfall/waterfall.d.ts

@@ -0,0 +1,8 @@
+import { WaterfallProps } from "./types.js";
+import React from "react";
+
+//#region src/waterfall/waterfall.d.ts
+declare const Waterfall: React.ForwardRefExoticComponent<Omit<WaterfallProps<any>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { Waterfall };
+//# sourceMappingURL=waterfall.d.ts.map

package/lib/waterfall/waterfall.js

@@ -0,0 +1,154 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.js");
+const require_config_context = require("../config-provider/config-context.js");
+const require_general = require("../_utils/general.js");
+const require_index = require("../transition/index.js");
+const require_use_breakpoint = require("./hooks/use-breakpoint.js");
+const require_use_positions = require("./hooks/use-positions.js");
+let react = require("react");
+react = require_runtime.__toESM(react);
+let classnames = require("classnames");
+classnames = require_runtime.__toESM(classnames);
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/waterfall/waterfall.tsx
+const Waterfall = react.default.forwardRef((props, ref) => {
+	const { prefixCls: customisedCls, className, style, columns = 3, gutter = 0, items, itemRender, onLayoutChange, ...otherProps } = props;
+	const prefixCls = require_general.getPrefixCls("waterfall", (0, react.useContext)(require_config_context.ConfigContext).prefixCls, customisedCls);
+	const screens = require_use_breakpoint.default();
+	const columnCount = react.default.useMemo(() => {
+		if (typeof columns === "number") return columns;
+		const matchingBreakpoint = require_use_breakpoint.responsiveArray.find((bp) => screens[bp] && columns[bp] !== void 0);
+		if (matchingBreakpoint) return columns[matchingBreakpoint];
+		return columns.xs ?? 1;
+	}, [columns, screens]);
+	const [horizontalGutter, verticalGutter] = Array.isArray(gutter) ? gutter : [gutter, gutter];
+	const itemRefsMap = (0, react.useRef)(/* @__PURE__ */ new Map());
+	const setItemRef = (0, react.useCallback)((key, el) => {
+		itemRefsMap.current.set(key, el);
+	}, []);
+	const [itemHeights, setItemHeights] = (0, react.useState)([]);
+	const collectItemSizes = (0, react.useCallback)(() => {
+		if (!items || items.length === 0) {
+			setItemHeights([]);
+			return;
+		}
+		const nextHeights = items.map((item, index) => {
+			const key = item.key ?? index;
+			const el = itemRefsMap.current.get(key);
+			return [
+				key,
+				el ? el.getBoundingClientRect().height : 0,
+				item.column
+			];
+		});
+		setItemHeights((prev) => {
+			return prev.length === nextHeights.length && prev.every((p, i) => p[0] === nextHeights[i][0] && p[1] === nextHeights[i][1]) ? prev : nextHeights;
+		});
+	}, [items]);
+	const [itemPositions, totalHeight] = require_use_positions.default(itemHeights, columnCount, verticalGutter);
+	(0, react.useEffect)(() => {
+		collectItemSizes();
+	}, [
+		items,
+		columnCount,
+		collectItemSizes
+	]);
+	(0, react.useEffect)(() => {
+		if (typeof ResizeObserver === "undefined") return;
+		const observer = new ResizeObserver(() => {
+			collectItemSizes();
+		});
+		for (const [, el] of itemRefsMap.current) if (el) observer.observe(el);
+		return () => observer.disconnect();
+	}, [items, collectItemSizes]);
+	(0, react.useEffect)(() => {
+		if (!onLayoutChange || !items || items.length === 0) return;
+		if (!items.every((item) => itemPositions.has(item.key))) return;
+		onLayoutChange(items.map((item) => ({
+			key: item.key,
+			column: itemPositions.get(item.key).column
+		})));
+	}, [
+		itemPositions,
+		items,
+		onLayoutChange
+	]);
+	const prevItemsRef = (0, react.useRef)(items || []);
+	const [exitingItems, setExitingItems] = (0, react.useState)(/* @__PURE__ */ new Map());
+	(0, react.useEffect)(() => {
+		const currentKeys = new Set((items || []).map((item, i) => item.key ?? i));
+		const removed = /* @__PURE__ */ new Map();
+		prevItemsRef.current.forEach((item, index) => {
+			const key = item.key ?? index;
+			if (!currentKeys.has(key)) removed.set(key, item);
+		});
+		if (removed.size > 0) setExitingItems((prev) => {
+			const next = new Map(prev);
+			removed.forEach((item, key) => next.set(key, item));
+			return next;
+		});
+		prevItemsRef.current = items || [];
+	}, [items]);
+	const handleExited = (0, react.useCallback)((key) => {
+		itemRefsMap.current.delete(key);
+		setExitingItems((prev) => {
+			const next = new Map(prev);
+			next.delete(key);
+			return next;
+		});
+		collectItemSizes();
+	}, [collectItemSizes]);
+	const cls = (0, classnames.default)(prefixCls, className);
+	const containerStyle = {
+		...style,
+		position: "relative",
+		height: totalHeight || void 0
+	};
+	const mergedItems = items || [];
+	const renderItem = (item, index, isExiting) => {
+		const key = item.key ?? index;
+		const position = itemPositions.get(key);
+		const hasPosition = !!position;
+		const columnIndex = position?.column ?? 0;
+		const itemStyle = {
+			position: "absolute",
+			width: `calc((100% - ${horizontalGutter * (columnCount - 1)}px) / ${columnCount})`,
+			left: `calc((100% - ${horizontalGutter * (columnCount - 1)}px) / ${columnCount} * ${columnIndex} + ${horizontalGutter * columnIndex}px)`,
+			top: position?.top ?? 0,
+			transition: hasPosition ? "top 0.3s ease, left 0.3s ease, opacity 0.3s ease" : "none",
+			opacity: hasPosition ? 1 : 0
+		};
+		const content = item.children ?? itemRender?.({
+			...item,
+			index,
+			column: columnIndex
+		});
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_index.default, {
+			in: !isExiting,
+			timeout: 300,
+			appear: false,
+			unmountOnExit: true,
+			classNames: `${prefixCls}__item-fade`,
+			onExited: () => handleExited(key),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				ref: (el) => setItemRef(key, el),
+				className: `${prefixCls}__item`,
+				style: itemStyle,
+				children: content
+			})
+		}, key);
+	};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		ref,
+		...otherProps,
+		className: cls,
+		style: containerStyle,
+		onLoad: collectItemSizes,
+		onError: collectItemSizes,
+		children: [mergedItems.map((item, index) => renderItem(item, index, false)), Array.from(exitingItems.entries()).map(([key, item]) => renderItem(item, Number(key), true))]
+	});
+});
+Waterfall.displayName = "Waterfall";
+//#endregion
+exports.default = Waterfall;
+
+//# sourceMappingURL=waterfall.js.map