docs: add JSDoc comments to hooks and update examples

- Add JSDoc documentation to useClosable, useListPosition, useSizes, useNoticeTimer, useNotification, and useStack
- Update example files to use geek.less and inline motion config
- Remove unused motion leave animations from hooks example

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: zombieJ

docs/examples/context.tsx

@@ -1,8 +1,15 @@
 /* eslint-disable no-console */
 import React from 'react';
-import '../../assets/index.less';
+import type { CSSMotionProps } from '@rc-component/motion';
+import '../../assets/geek.less';
 import { useNotification } from '../../src';
-import motion from './motion';
+
+const motion: CSSMotionProps = {
+  motionName: 'notification-fade',
+  motionAppear: true,
+  motionEnter: true,
+  motionLeave: true,
+};
 
 const Context = React.createContext({ name: 'light' });
 
@@ -15,7 +22,10 @@ const NOTICE = {
 };
 
 const Demo = () => {
-  const [{ open }, holder] = useNotification({ motion });
+  const [{ open }, holder] = useNotification({
+    motion,
+    prefixCls: 'notification',
+  });
 
   return (
     <Context.Provider value={{ name: 'bamboo' }}>

docs/examples/hooks.tsx

@@ -9,11 +9,6 @@ const motion: CSSMotionProps = {
   motionAppear: true,
   motionEnter: true,
   motionLeave: true,
-  onLeaveStart: (ele) => {
-    const { offsetHeight } = ele;
-    return { height: offsetHeight };
-  },
-  onLeaveActive: () => ({ height: 0, opacity: 0, margin: 0 }),
 };
 
 const App = () => {

docs/examples/maxCount.tsx

@@ -1,11 +1,22 @@
 /* eslint-disable no-console */
 import React from 'react';
-import '../../assets/index.less';
+import type { CSSMotionProps } from '@rc-component/motion';
+import '../../assets/geek.less';
 import { useNotification } from '../../src';
-import motion from './motion';
+
+const motion: CSSMotionProps = {
+  motionName: 'notification-fade',
+  motionAppear: true,
+  motionEnter: true,
+  motionLeave: true,
+};
 
 export default () => {
-  const [notice, contextHolder] = useNotification({ motion, maxCount: 3 });
+  const [notice, contextHolder] = useNotification({
+    motion,
+    maxCount: 3,
+    prefixCls: 'notification',
+  });
 
   return (
     <>

docs/examples/showProgress.tsx

@@ -1,11 +1,22 @@
 /* eslint-disable no-console */
 import React from 'react';
-import '../../assets/index.less';
+import type { CSSMotionProps } from '@rc-component/motion';
+import '../../assets/geek.less';
 import { useNotification } from '../../src';
-import motion from './motion';
+
+const motion: CSSMotionProps = {
+  motionName: 'notification-fade',
+  motionAppear: true,
+  motionEnter: true,
+  motionLeave: true,
+};
 
 export default () => {
-  const [notice, contextHolder] = useNotification({ motion, showProgress: true });
+  const [notice, contextHolder] = useNotification({
+    motion,
+    showProgress: true,
+    prefixCls: 'notification',
+  });
 
   return (
     <>

src/hooks/useClosable.ts

@@ -12,6 +12,9 @@ export type ClosableType = boolean | ClosableConfig | null | undefined;
 export type ParsedClosableConfig = ClosableConfig &
   Required<Pick<ClosableConfig, 'closeIcon' | 'disabled'>>;
 
+/**
+ * Normalizes the closable option into a boolean flag, config, and aria props.
+ */
 export default function useClosable(
   closable?: ClosableType,
 ): [boolean, ParsedClosableConfig, ReturnType<typeof pickAttrs>] {

src/hooks/useListPosition/index.ts

@@ -7,6 +7,9 @@ export type NodePosition = {
   y: number;
 };
 
+/**
+ * Calculates each notification's position and the full list height.
+ */
 export default function useListPosition(
   configList: { key: React.Key }[],
   stack?: StackConfig,

src/hooks/useListPosition/useSizes.ts

@@ -7,6 +7,9 @@ export type NodeSize = {
 
 export type NodeSizeMap = Record<string, NodeSize>;
 
+/**
+ * Stores measured node sizes by key and exposes a ref callback to update them.
+ */
 export default function useSizes() {
   const [sizeMap, setSizeMap] = React.useState<NodeSizeMap>({});
 

src/hooks/useNoticeTimer.ts

@@ -2,6 +2,10 @@ import * as React from 'react';
 import raf from '@rc-component/util/es/raf';
 import useEvent from '@rc-component/util/es/hooks/useEvent';
 
+/**
+ * Runs the notice auto-close timer and reports progress updates.
+ * Returns controls to pause and resume the timer.
+ */
 export default function useNoticeTimer(
   duration: number | false | null,
   onClose: VoidFunction,

src/hooks/useNotification.tsx

@@ -69,6 +69,10 @@ function mergeConfig<T>(...objList: Partial<T>[]): T {
   return clone;
 }
 
+/**
+ * Creates the notification API and the React holder element.
+ * Queueing is handled internally until the notification instance is ready.
+ */
 export default function useNotification(
   rootConfig: NotificationConfig = {},
 ): [NotificationAPI, React.ReactElement] {

src/hooks/useStack.ts

@@ -7,6 +7,9 @@ type StackParams = Required<StackConfig>;
 
 type UseStack = (config?: boolean | StackConfig) => [boolean, StackParams];
 
+/**
+ * Resolves the stack setting into an enabled flag and normalized stack params.
+ */
 const useStack: UseStack = (config) => {
   const result: StackParams = {
     offset: DEFAULT_OFFSET,