📝 [Skill]: Update compose-hooks refs

Author: junerver

.claude/skills/compose-hooks/SKILL.md

@@ -5,8 +5,8 @@ description: |
   使用此技能当需要：(1) 在 Compose 中管理组件状态 (useState, useGetState, useReducer)，
   (2) 处理副作用和生命周期 (useEffect, useMount, useUnmount)，
   (3) 管理网络请求 (useRequest)，(4) 使用防抖/节流 (useDebounce, useThrottle)，
-  (5) 管理列表/Map状态 (useList, useMap)，(6) 使用定时器 (useInterval, useTimeout)，
-  (7) 全局状态管理 (useSelector, useDispatch)。
+  (5) 管理列表/Map状态 (useList, useMap)，(6) 使用定时器 (useInterval, useTimeoutFn/useTimeoutPoll/useCountdown)，
+  (7) 全局状态管理 (useSelector, useDispatch)，(8) 使用无头表格 (useTable/useTableRequest)。
   关键词: Compose, Hooks, 状态管理, useRequest, useReducer, useState, useEffect
 ---
 
@@ -54,7 +54,7 @@ ComposeHooks 是一个为 Jetpack Compose/Compose Multiplatform 设计的 Hooks
 | `useDebounce` | 防抖值 | `val debouncedValue = useDebounce(value)` |
 | `useThrottle` | 节流值 | `val throttledValue = useThrottle(value)` |
 | `useInterval` | 定时器 | `useInterval { tick() }` |
-| `useTimeout` | 延时执行 | `useTimeoutFn(fn, 1.seconds)` |
+| `useTimeoutFn` | 延时执行 | `useTimeoutFn(fn, 1.seconds)` |
 | `useUndo` | 撤销/重做 | `val (state, set, reset, undo, redo) = useUndo(initial)` |
 
 ## 详细参考
@@ -63,6 +63,7 @@ ComposeHooks 是一个为 Jetpack Compose/Compose Multiplatform 设计的 Hooks
 - **副作用 Hooks**: 见 [references/effect-hooks.md](references/effect-hooks.md)
 - **工具 Hooks**: 见 [references/utility-hooks.md](references/utility-hooks.md)
 - **网络请求 Hooks**: 见 [references/request-hooks.md](references/request-hooks.md)
+- **Table 相关 Hooks**: 见 [references/table-hooks.md](references/table-hooks.md)
 
 ## 常见模式
 

.claude/skills/compose-hooks/references/effect-hooks.md

@@ -50,22 +50,11 @@ useEffect(page, pageSize) {
 }
 ```
 
-### 清理函数
+### 注意事项
 
-useEffect 内部是协程作用域，使用 try-finally 进行清理：
+useEffect 只是协程作用域，**没有卸载清理回调**。需要卸载清理请用 useUnmount。
 
-```kotlin
-useEffect(Unit) {
-    val job = startBackgroundTask()
-    try {
-        // Effect body
-    } finally {
-        job.cancel()
-    }
-}
-```
-
-**注意**：useEffect 是 LaunchedEffect 的别名，内部是协程作用域，可以直接使用 suspend 函数。
+**说明**：useEffect 是 LaunchedEffect 的别名，内部是协程作用域，可以直接使用 suspend 函数。
 
 ---
 
@@ -305,14 +294,10 @@ useThrottleEffect(scroll) { updateHeader(scroll) }
 ### 2. 清理资源
 
 ```kotlin
-useEffect(key) {
-    val job = scope.launch { /* ... */ }
-    val listener = addListener { /* ... */ }
-
-    onCleanup {
-        job.cancel()
-        removeListener(listener)
-    }
+useUnmount {
+    // 组件卸载时清理资源
+    job.cancel()
+    removeListener(listener)
 }
 ```
 

.claude/skills/compose-hooks/references/table-hooks.md

@@ -0,0 +1,74 @@
+# Table Hooks
+
+## useTable
+
+无头表格，负责行模型与状态，不负责 UI 渲染。
+
+```kotlin
+val table = useTable(
+    data = users,
+    columns = listOf(
+        column<User, String>("name") { it.name },
+        column<User, Int>("age") { it.age },
+    ),
+) {
+    enableSorting = true
+    enableFiltering = true
+    enablePagination = true
+    pageSize = 10
+}
+```
+
+- 行模型：`table.rowModel.value.rows`
+- 表格状态：`table.state.value`
+- 排序/过滤/分页：使用 `table.toggleSorting`、`table.setGlobalFilter`、`table.setPageIndex` 等
+
+## Table 组合
+
+```kotlin
+Table(table) {
+    TableHeader { columns, state ->
+        // 渲染表头
+    }
+
+    TableBody { rows ->
+        // 渲染行
+    }
+
+    TablePagination { page ->
+        // page.pageIndex / page.pageCount / page.nextPage()
+    }
+}
+```
+
+## useTableRequest
+
+分页请求 + 表格组合用法：
+
+```kotlin
+val tableRequest = useTableRequest<User>(
+    requestFn = { page, pageSize -> api.fetch(page, pageSize) },
+    optionsOf = { initialPageSize = 20 },
+)
+
+val table = useTable(
+    data = tableRequest.rows.value,
+    columns = columns,
+) {
+    enablePagination = true
+}
+```
+
+- `tableRequest.rows` / `tableRequest.total` 为 `State`
+- 翻页时把 `tableRequest.pageIndex` / `pageSize` 传入请求
+
+## remember 别名
+
+- `rememberTable` 目前没有专用别名，可直接使用 `useTable`
+- `rememberTableRequest` 目前没有专用别名，可直接使用 `useTableRequest`
+
+## 依据
+
+- useTable: hooks/src/commonMain/kotlin/xyz/junerver/compose/hooks/usetable/hooks.kt
+- Table/Scope: hooks/src/commonMain/kotlin/xyz/junerver/compose/hooks/usetable/Table.kt
+- useTableRequest: hooks/src/commonMain/kotlin/xyz/junerver/compose/hooks/userequest/UseTableRequest.kt

.claude/skills/compose-hooks/references/utility-hooks.md

@@ -5,7 +5,7 @@
 - [useDebounce / useDebounceFn](#usedebounce--usedebouncefn)
 - [useThrottle / useThrottleFn](#usethrottle--usethrottlefn)
 - [useInterval](#useinterval)
-- [useTimeout / useTimeoutFn](#usetimeout--usetimeoutfn)
+- [useTimeoutFn](#usetimeoutfn)
 - [useTimeoutPoll](#usetimeoutpoll)
 - [useCountdown](#usecountdown)
 - [useCounter](#usecounter)
@@ -136,27 +136,26 @@ optionsOf = {
 
 ---
 
-## useTimeout / useTimeoutFn
+## useTimeoutFn
 
 延时执行。
 
-### useTimeoutFn
-
 ```kotlin
-val (run, cancel, isPending) = useTimeoutFn(
+val (isPending, start, stop) = useTimeoutFn(
     fn = { showNotification() },
     interval = 3.seconds
 )
 
-run()      // 开始计时
-cancel()   // 取消
+start()      // 开始计时
+stop()       // 取消
 // isPending.value 表示是否在等待中
 ```
 
 **配置选项**：
 ```kotlin
 useTimeoutFn(fn, interval, optionsOf = {
     immediate = false  // 是否立即开始
+    immediateCallback = false // 是否在开始时立即执行
 })
 ```
 
@@ -167,11 +166,13 @@ useTimeoutFn(fn, interval, optionsOf = {
 超时轮询，上一次任务完成后才开始下一次。
 
 ```kotlin
-val (run, cancel, isPolling) = useTimeoutPoll(
+val timeoutPoll = useTimeoutPoll(
     fn = { fetchData() },
     interval = 5.seconds
 )
 
+// timeoutPoll.isActive.value / timeoutPoll.pause() / timeoutPoll.resume()
+
 // 自动开始
 useTimeoutPoll(
     fn = { fetchData() },
@@ -188,7 +189,7 @@ useTimeoutPoll(
 
 ```kotlin
 val (countdown, formattedRes) = useCountdown {
-    targetDate = Clock.System.now() + 10.minutes
+    targetDate = Clock.System.now() + 10.minutes // kotlin.time.Clock
     interval = 1.seconds
     onEnd = { showComplete() }
 }
@@ -408,7 +409,7 @@ val now = useNow {
 // 自定义格式
 val now = useNow {
     interval = 1.seconds
-    format = { instant -> instant.toString() }
+    format = { epochMillis -> epochMillis.toString() }
 }
 ```