@jbpark/use-hooks 2.1.0 → 2.2.0

package/dist/hooks/index.d.mts

@@ -8,5 +8,6 @@ import { useLocalStorage } from "./useLocalStorage/index.mjs";
 import { useRecursiveTimeout } from "./useRecursiveTimeout/index.mjs";
 import { useScrollToElements } from "./useScrollToElements/index.mjs";
 import { useThrottle } from "./useThrottle/index.mjs";
+import { useTimeline } from "./useTimeline/index.mjs";
 import { useWindowScroll } from "./useWindowScroll/index.mjs";
 import { useViewport } from "./useViewport/index.mjs";

package/dist/hooks/index.mjs

@@ -8,6 +8,7 @@ import useLocalStorage from "./useLocalStorage/index.mjs";
 import useRecursiveTimeout from "./useRecursiveTimeout/index.mjs";
 import useScrollToElements from "./useScrollToElements/index.mjs";
 import useThrottle from "./useThrottle/index.mjs";
+import useTimeline from "./useTimeline/index.mjs";
 import useWindowScroll from "./useWindowScroll/index.mjs";
 import useViewport from "./useViewport/index.mjs";
 

package/dist/hooks/useTimeline/index.d.mts

@@ -0,0 +1,50 @@
+import * as react from "react";
+
+//#region src/hooks/useTimeline/index.d.ts
+interface TimelineStep {
+  scale?: number;
+  rotate?: {
+    x?: number;
+    y?: number;
+    z?: number;
+  };
+  position?: {
+    x?: number;
+    y?: number;
+  };
+  top?: number;
+  left?: number;
+  width?: number;
+  height?: number;
+  zIndex?: number;
+  filter?: string;
+  backgroundColor?: string;
+  opacity?: number;
+  selector: string;
+  transition: Transition;
+}
+interface Transition {
+  duration: number;
+  ease?: string;
+  delay?: number;
+  easeX?: string;
+  easeY?: string;
+}
+interface Options {
+  steps?: TimelineStep[];
+  loading?: boolean;
+  immediate?: boolean;
+  loop?: boolean;
+}
+declare const useTimeline: ({
+  steps,
+  loading,
+  immediate,
+  loop
+}: Options) => {
+  ref: react.RefObject<HTMLDivElement | null>;
+  completed: boolean;
+};
+//#endregion
+export { useTimeline };
+//# sourceMappingURL=index.d.mts.map

package/dist/hooks/useTimeline/index.mjs

@@ -0,0 +1,175 @@
+import { useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+
+//#region src/hooks/useTimeline/index.ts
+const registeredProperties = /* @__PURE__ */ new Set();
+const registerCSSProperty = (name, syntax = "<length>", initialValue = "0px") => {
+	if (registeredProperties.has(name) || typeof CSS === "undefined" || !CSS.registerProperty) return;
+	try {
+		CSS.registerProperty({
+			name,
+			syntax,
+			inherits: false,
+			initialValue
+		});
+		registeredProperties.add(name);
+	} catch {}
+};
+const buildTimeline = (steps) => {
+	const groups = [];
+	for (const step of steps) if (step.transition.delay === 0 && groups.length > 0) groups[groups.length - 1]?.push(step);
+	else groups.push([step]);
+	return groups;
+};
+const buildTransform = (step) => {
+	const parts = [];
+	if (step.position?.x != null || step.position?.y != null) parts.push(`translate(${step.position.x ?? 0}px, ${step.position.y ?? 0}px)`);
+	if (step.scale != null) parts.push(`scale(${step.scale})`);
+	if (step.rotate?.x != null) parts.push(`rotateX(${step.rotate.x}deg)`);
+	if (step.rotate?.y != null) parts.push(`rotateY(${step.rotate.y}deg)`);
+	if (step.rotate?.z != null) parts.push(`rotateZ(${step.rotate.z}deg)`);
+	return parts.join(" ") || void 0;
+};
+const applyStep = (container, step, skipTransition) => {
+	const elements = container.matches(step.selector) ? [container] : Array.from(container.querySelectorAll(step.selector));
+	if (!elements.length) return;
+	const dur = `${step.transition.duration}ms`;
+	const eas = step.transition.ease ?? "ease-out";
+	const easX = step.transition.easeX;
+	const easY = step.transition.easeY;
+	const hasCurve = !!(easX || easY);
+	const timers = [];
+	elements.forEach((el) => {
+		if (skipTransition) el.style.transition = "none";
+		else if (hasCurve) {
+			const xEase = easX ?? eas;
+			const yEase = easY ?? eas;
+			el.style.transition = [
+				`--tx ${dur} ${xEase}`,
+				`--ty ${dur} ${yEase}`,
+				`--s ${dur} ${eas}`,
+				`rotate ${dur} ${eas}`,
+				`width ${dur} ${eas}`,
+				`height ${dur} ${eas}`,
+				`filter ${dur} ${eas}`,
+				`opacity ${dur} ${eas}`
+			].join(", ");
+		} else el.style.transition = `all ${dur} ${eas}`;
+		if (step.backgroundColor) el.style.backgroundColor = step.backgroundColor;
+		if (step.opacity !== void 0) el.style.opacity = String(step.opacity);
+		if (step.top !== void 0) el.style.top = `${step.top}px`;
+		if (step.left !== void 0) el.style.left = `${step.left}px`;
+		if (step.width !== void 0) el.style.width = `${step.width}px`;
+		if (step.height !== void 0) el.style.height = `${step.height}px`;
+		if (step.zIndex !== void 0) if (skipTransition) el.style.zIndex = String(step.zIndex);
+		else {
+			const timerId = setTimeout(() => {
+				el.style.zIndex = String(step.zIndex);
+			}, step.transition.duration / 2);
+			timers.push(timerId);
+		}
+		if (step.filter !== void 0) el.style.filter = step.filter;
+		if (step.rotate?.z !== void 0) el.style.rotate = `${step.rotate.z}deg`;
+		if (hasCurve) {
+			if (step.position?.x != null || step.position?.y != null) {
+				el.style.setProperty("--tx", `${step.position.x ?? 0}px`);
+				el.style.setProperty("--ty", `${step.position.y ?? 0}px`);
+			}
+			if (step.scale != null) el.style.setProperty("--s", String(step.scale));
+			el.style.transform = `translate(var(--tx), var(--ty)) scale(var(--s, 1))`;
+		} else {
+			const transform = buildTransform(step);
+			if (transform) el.style.transform = transform;
+		}
+	});
+	return timers;
+};
+const useTimeline = ({ steps = [], loading, immediate, loop }) => {
+	const [slotIndex, setSlotIndex] = useState(-1);
+	const [completed, setCompleted] = useState(() => !!immediate);
+	const ref = useRef(null);
+	const timeline = useMemo(() => buildTimeline(steps), [steps]);
+	const hasCurveSteps = useMemo(() => steps.some((s) => s.transition.easeX || s.transition.easeY), [steps]);
+	useLayoutEffect(() => {
+		if (hasCurveSteps) {
+			registerCSSProperty("--tx");
+			registerCSSProperty("--ty");
+			registerCSSProperty("--s", "<number>", "1");
+		}
+	}, [hasCurveSteps]);
+	useLayoutEffect(() => {
+		if (!immediate || !ref.current || !steps.length) return;
+		const container = ref.current;
+		steps.forEach((step) => applyStep(container, step, true));
+	}, [immediate, steps]);
+	useEffect(() => {
+		if (immediate || loading || !timeline.length) return;
+		const firstDelay = timeline[0]?.[0]?.transition.delay ?? 0;
+		const timerId = window.setTimeout(() => {
+			requestAnimationFrame(() => setSlotIndex(0));
+		}, firstDelay);
+		return () => clearTimeout(timerId);
+	}, [
+		loading,
+		timeline,
+		immediate
+	]);
+	useEffect(() => {
+		if (immediate || loading || slotIndex < 0) return;
+		const isLast = slotIndex >= timeline.length - 1;
+		if (isLast && !loop) return;
+		const currentSlot = timeline[slotIndex];
+		const maxDuration = Math.max(...currentSlot?.map((s) => s.transition.duration) ?? [0]);
+		const nextIndex = isLast ? 0 : slotIndex + 1;
+		const nextDelay = timeline[nextIndex]?.[0]?.transition.delay ?? 0;
+		const timerId = window.setTimeout(() => {
+			setSlotIndex(nextIndex);
+		}, maxDuration + nextDelay);
+		return () => clearTimeout(timerId);
+	}, [
+		loading,
+		slotIndex,
+		timeline,
+		immediate,
+		loop
+	]);
+	useEffect(() => {
+		if (immediate || slotIndex < 0 || !ref.current) return;
+		const container = ref.current;
+		const timers = [];
+		requestAnimationFrame(() => {
+			timeline[slotIndex]?.forEach((step) => {
+				const stepTimers = applyStep(container, step);
+				if (stepTimers) timers.push(...stepTimers);
+			});
+		});
+		return () => {
+			timers.forEach(clearTimeout);
+		};
+	}, [
+		immediate,
+		slotIndex,
+		timeline
+	]);
+	useEffect(() => {
+		if (immediate || loop || slotIndex < 0 || slotIndex < timeline.length - 1 || !timeline.length) return;
+		const lastSlot = timeline[slotIndex];
+		const maxDuration = Math.max(...lastSlot?.map((s) => s.transition.duration) ?? [0]);
+		const timerId = window.setTimeout(() => {
+			setCompleted(true);
+		}, maxDuration);
+		return () => clearTimeout(timerId);
+	}, [
+		slotIndex,
+		timeline,
+		immediate,
+		loop
+	]);
+	return {
+		ref,
+		completed
+	};
+};
+
+//#endregion
+export { useTimeline as default };
+//# sourceMappingURL=index.mjs.map

package/dist/hooks/useTimeline/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/hooks/useTimeline/index.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';\n\nconst registeredProperties = new Set<string>();\n\nconst registerCSSProperty = (\n  name: string,\n  syntax = '<length>',\n  initialValue = '0px',\n) => {\n  if (\n    registeredProperties.has(name) ||\n    typeof CSS === 'undefined' ||\n    !CSS.registerProperty\n  ) {\n    return;\n  }\n\n  try {\n    CSS.registerProperty({\n      name,\n      syntax,\n      inherits: false,\n      initialValue,\n    });\n    registeredProperties.add(name);\n  } catch {\n    // 이미 등록된 경우 무시\n  }\n};\n\nexport interface TimelineStep {\n  scale?: number;\n  rotate?: { x?: number; y?: number; z?: number };\n  position?: { x?: number; y?: number };\n  top?: number;\n  left?: number;\n  width?: number;\n  height?: number;\n  zIndex?: number;\n  filter?: string;\n  backgroundColor?: string;\n  opacity?: number;\n  selector: string;\n  transition: Transition;\n}\n\ninterface Transition {\n  duration: number;\n  ease?: string;\n  delay?: number;\n  easeX?: string;\n  easeY?: string;\n}\n\ninterface Options {\n  steps?: TimelineStep[];\n  loading?: boolean;\n  immediate?: boolean;\n  loop?: boolean;\n}\n\nconst buildTimeline = (steps: TimelineStep[]): TimelineStep[][] => {\n  const groups: TimelineStep[][] = [];\n\n  for (const step of steps) {\n    if (step.transition.delay === 0 && groups.length > 0) {\n      groups[groups.length - 1]?.push(step);\n    } else {\n      groups.push([step]);\n    }\n  }\n\n  return groups;\n};\n\nconst buildTransform = (step: TimelineStep) => {\n  const parts: string[] = [];\n\n  if (step.position?.x != null || step.position?.y != null) {\n    parts.push(\n      `translate(${step.position.x ?? 0}px, ${step.position.y ?? 0}px)`,\n    );\n  }\n\n  if (step.scale != null) {\n    parts.push(`scale(${step.scale})`);\n  }\n\n  if (step.rotate?.x != null) {\n    parts.push(`rotateX(${step.rotate.x}deg)`);\n  }\n\n  if (step.rotate?.y != null) {\n    parts.push(`rotateY(${step.rotate.y}deg)`);\n  }\n\n  if (step.rotate?.z != null) {\n    parts.push(`rotateZ(${step.rotate.z}deg)`);\n  }\n\n  return parts.join(' ') || undefined;\n};\n\nconst applyStep = (\n  container: HTMLElement,\n  step: TimelineStep,\n  skipTransition?: boolean,\n) => {\n  const elements = container.matches(step.selector)\n    ? [container]\n    : Array.from(container.querySelectorAll<HTMLElement>(step.selector));\n\n  if (!elements.length) {\n    return;\n  }\n\n  const dur = `${step.transition.duration}ms`;\n  const eas = step.transition.ease ?? 'ease-out';\n  const easX = step.transition.easeX;\n  const easY = step.transition.easeY;\n  const hasCurve = !!(easX || easY);\n  const timers: ReturnType<typeof setTimeout>[] = [];\n\n  elements.forEach(el => {\n    if (skipTransition) {\n      el.style.transition = 'none';\n    } else if (hasCurve) {\n      const xEase = easX ?? eas;\n      const yEase = easY ?? eas;\n      el.style.transition = [\n        `--tx ${dur} ${xEase}`,\n        `--ty ${dur} ${yEase}`,\n        `--s ${dur} ${eas}`,\n        `rotate ${dur} ${eas}`,\n        `width ${dur} ${eas}`,\n        `height ${dur} ${eas}`,\n        `filter ${dur} ${eas}`,\n        `opacity ${dur} ${eas}`,\n      ].join(', ');\n    } else {\n      el.style.transition = `all ${dur} ${eas}`;\n    }\n\n    if (step.backgroundColor) {\n      el.style.backgroundColor = step.backgroundColor;\n    }\n\n    if (step.opacity !== undefined) {\n      el.style.opacity = String(step.opacity);\n    }\n\n    if (step.top !== undefined) {\n      el.style.top = `${step.top}px`;\n    }\n\n    if (step.left !== undefined) {\n      el.style.left = `${step.left}px`;\n    }\n\n    if (step.width !== undefined) {\n      el.style.width = `${step.width}px`;\n    }\n\n    if (step.height !== undefined) {\n      el.style.height = `${step.height}px`;\n    }\n\n    if (step.zIndex !== undefined) {\n      if (skipTransition) {\n        el.style.zIndex = String(step.zIndex);\n      } else {\n        const timerId = setTimeout(() => {\n          el.style.zIndex = String(step.zIndex);\n        }, step.transition.duration / 2);\n        timers.push(timerId);\n      }\n    }\n\n    if (step.filter !== undefined) {\n      el.style.filter = step.filter;\n    }\n\n    if (step.rotate?.z !== undefined) {\n      el.style.rotate = `${step.rotate.z}deg`;\n    }\n\n    if (hasCurve) {\n      if (step.position?.x != null || step.position?.y != null) {\n        el.style.setProperty('--tx', `${step.position.x ?? 0}px`);\n        el.style.setProperty('--ty', `${step.position.y ?? 0}px`);\n      }\n      if (step.scale != null) {\n        el.style.setProperty('--s', String(step.scale));\n      }\n      el.style.transform = `translate(var(--tx), var(--ty)) scale(var(--s, 1))`;\n    } else {\n      const transform = buildTransform(step);\n\n      if (transform) {\n        el.style.transform = transform;\n      }\n    }\n  });\n\n  return timers;\n};\n\nconst useTimeline = ({ steps = [], loading, immediate, loop }: Options) => {\n  const [slotIndex, setSlotIndex] = useState(-1);\n  const [completed, setCompleted] = useState(() => !!immediate);\n\n  const ref = useRef<HTMLDivElement>(null);\n  const timeline = useMemo(() => buildTimeline(steps), [steps]);\n  const hasCurveSteps = useMemo(\n    () => steps.some(s => s.transition.easeX || s.transition.easeY),\n    [steps],\n  );\n\n  useLayoutEffect(() => {\n    if (hasCurveSteps) {\n      registerCSSProperty('--tx');\n      registerCSSProperty('--ty');\n      registerCSSProperty('--s', '<number>', '1');\n    }\n  }, [hasCurveSteps]);\n\n  useLayoutEffect(() => {\n    if (!immediate || !ref.current || !steps.length) {\n      return;\n    }\n\n    const container = ref.current;\n    steps.forEach(step => applyStep(container, step, true));\n  }, [immediate, steps]);\n\n  useEffect(() => {\n    if (immediate || loading || !timeline.length) {\n      return;\n    }\n\n    const firstDelay = timeline[0]?.[0]?.transition.delay ?? 0;\n    const timerId = window.setTimeout(() => {\n      requestAnimationFrame(() => setSlotIndex(0));\n    }, firstDelay);\n\n    return () => clearTimeout(timerId);\n  }, [loading, timeline, immediate]);\n\n  useEffect(() => {\n    if (immediate || loading || slotIndex < 0) {\n      return;\n    }\n\n    const isLast = slotIndex >= timeline.length - 1;\n\n    if (isLast && !loop) {\n      return;\n    }\n\n    const currentSlot = timeline[slotIndex];\n    const maxDuration = Math.max(\n      ...(currentSlot?.map(s => s.transition.duration) ?? [0]),\n    );\n\n    const nextIndex = isLast ? 0 : slotIndex + 1;\n    const nextDelay = timeline[nextIndex]?.[0]?.transition.delay ?? 0;\n\n    const timerId = window.setTimeout(() => {\n      setSlotIndex(nextIndex);\n    }, maxDuration + nextDelay);\n\n    return () => clearTimeout(timerId);\n  }, [loading, slotIndex, timeline, immediate, loop]);\n\n  useEffect(() => {\n    if (immediate || slotIndex < 0 || !ref.current) {\n      return;\n    }\n\n    const container = ref.current;\n    const timers: ReturnType<typeof setTimeout>[] = [];\n\n    requestAnimationFrame(() => {\n      timeline[slotIndex]?.forEach(step => {\n        const stepTimers = applyStep(container, step);\n\n        if (stepTimers) {\n          timers.push(...stepTimers);\n        }\n      });\n    });\n\n    return () => {\n      timers.forEach(clearTimeout);\n    };\n  }, [immediate, slotIndex, timeline]);\n\n  useEffect(() => {\n    if (\n      immediate ||\n      loop ||\n      slotIndex < 0 ||\n      slotIndex < timeline.length - 1 ||\n      !timeline.length\n    ) {\n      return;\n    }\n\n    const lastSlot = timeline[slotIndex];\n    const maxDuration = Math.max(\n      ...(lastSlot?.map(s => s.transition.duration) ?? [0]),\n    );\n\n    const timerId = window.setTimeout(() => {\n      setCompleted(true);\n    }, maxDuration);\n\n    return () => clearTimeout(timerId);\n  }, [slotIndex, timeline, immediate, loop]);\n\n  return { ref, completed };\n};\n\nexport default useTimeline;\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -8,7 +8,8 @@ import { useLocalStorage } from "./hooks/useLocalStorage/index.mjs";
 import { useRecursiveTimeout } from "./hooks/useRecursiveTimeout/index.mjs";
 import { useScrollToElements } from "./hooks/useScrollToElements/index.mjs";
 import { useThrottle } from "./hooks/useThrottle/index.mjs";
+import { useTimeline } from "./hooks/useTimeline/index.mjs";
 import { useWindowScroll } from "./hooks/useWindowScroll/index.mjs";
 import { useViewport } from "./hooks/useViewport/index.mjs";
 import "./hooks/index.mjs";
-export { useBodyScrollLock, useDebounce, useElementPosition, useElementScroll, useImage, useLocalStorage, useRecursiveTimeout, useResponsiveSize, useScrollToElements, useThrottle, useViewport, useWindowScroll };
+export { useBodyScrollLock, useDebounce, useElementPosition, useElementScroll, useImage, useLocalStorage, useRecursiveTimeout, useResponsiveSize, useScrollToElements, useThrottle, useTimeline, useViewport, useWindowScroll };

package/dist/index.mjs

@@ -8,8 +8,9 @@ import useLocalStorage from "./hooks/useLocalStorage/index.mjs";
 import useRecursiveTimeout from "./hooks/useRecursiveTimeout/index.mjs";
 import useScrollToElements from "./hooks/useScrollToElements/index.mjs";
 import useThrottle from "./hooks/useThrottle/index.mjs";
+import useTimeline from "./hooks/useTimeline/index.mjs";
 import useWindowScroll from "./hooks/useWindowScroll/index.mjs";
 import useViewport from "./hooks/useViewport/index.mjs";
 import "./hooks/index.mjs";
 
-export { useBodyScrollLock, useDebounce, useElementPosition, useElementScroll, useImage, useLocalStorage, useRecursiveTimeout, useResponsiveSize, useScrollToElements, useThrottle, useViewport, useWindowScroll };
+export { useBodyScrollLock, useDebounce, useElementPosition, useElementScroll, useImage, useLocalStorage, useRecursiveTimeout, useResponsiveSize, useScrollToElements, useThrottle, useTimeline, useViewport, useWindowScroll };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jbpark/use-hooks",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A collection of reusable React 19 hooks for common UI and interaction patterns",
   "keywords": [
     "react",