@dazhicheng/ui 1.6.2 → 1.6.3

package/dist/components/tt-table/src/hooks/useTableRender.d.ts

@@ -34,12 +34,12 @@ export type TtUseTableRenderReturnType<Row = any> = [
  *
  * 返回 [FormTable 组件, TableFormApi API]。
  *
- * `options` 的类型不含 `Row`，`Row` 只出现在返回类型上。这是为了打断业务常见写法里的循环推断：
- * `const [FormTable, api] = useTableFormRender({ form: { schemas: [{ onChange: () => f(api) }] } })`
- * 中 `api` 的类型来自返回值，而实参字面量里的回调又引用 `api`。只要参数类型带 `Row`，
- * TS 就必须先检查实参才能定下返回类型，于是判定为循环并把 `api` 退化成隐式 any（TS7022/TS7023）。
- * `NoInfer` 只能阻止推断、阻止不了这次实参检查，所以这里直接让参数与 `Row` 解耦。
- * 需要行类型时显式写 `useTableFormRender<Row>({ ... })`，不写则为 `any`。
+ * `options` 用 `NoInfer` 包裹，`Row` 不再从传入的配置反向推断。业务常见写法是在
+ * `form.schemas` 的回调里引用解构出来的 api：
+ * `const [FormTable, api] = useTableFormRender({ form: { schemas: [{ onChange: () => f(api) }] } })`，
+ * 若 `Row` 从 `options` 推断，则 api 的类型依赖 options、options 又引用 api，TS 判定为循环，
+ * 整个变量退化成隐式 any 并报 TS7022/TS7023。代价是需要显式写
+ * `useTableFormRender<Row>({ ... })` 才能拿到行类型推断，不写则为 `any`。
  *
  * @param options 表格渲染配置项
  * @returns [FormTable组件, TableFormApi API]
@@ -61,16 +61,16 @@ export type TtUseTableRenderReturnType<Row = any> = [
  * // 在模板中使用
  * <FormTable />
  */
-export declare function useTableFormRender<Row = any>(options: TtTableFormProps<any>): TtUseTableFormRenderReturnType<Row>;
+export declare function useTableFormRender<Row = any>(options: NoInfer<TtTableFormProps<Row>>): TtUseTableFormRenderReturnType<Row>;
 /**
  * 用于渲染表格的 hooks，返回 [TableRender 组件, 表格API]。
  *
  * options 只接受表格配置；单向数据使用 data，双向数据绑定到返回的 TableRender 组件。
  *
- * `options` 的类型不含 `Row`，与 `useTableFormRender` 保持一致：`Row` 参与参数类型时，
- * 业务写 `useTableRender({ data: [], columns: [...] })` 会让 `Row` 从空数组推断成 `never`，
- * 组件的 `data` prop 类型退化为 `MaybeRef<never[]>`，之后传入任何具体行类型都报 TS2322。
- * 需要行类型时显式写 `useTableRender<Row>({ ... })`，不写则为 `any`。
+ * `options` 用 `NoInfer` 包裹，`Row` 不从配置反向推断。业务常见写法是初始化时给 `data: []`，
+ * 若 `Row` 从空数组推断会退化成 `never`，组件的 `data` prop 类型变成 `MaybeRef<never[]>`，
+ * 之后传入任何具体行类型都会报 TS2322。代价是需要显式写 `useTableRender<Row>({ ... })`
+ * 才能拿到行类型推断，不写则为 `any`。
  *
  * @param options 表格渲染配置项
  * @returns [TableRender组件, 表格API]
@@ -91,5 +91,5 @@ export declare function useTableFormRender<Row = any>(options: TtTableFormProps<
  * // 在模板中使用
  * <TableRender />
  */
-export declare function useTableRender<Row = any>(options: TtTableProps<any>): TtUseTableRenderReturnType<Row>;
+export declare function useTableRender<Row = any>(options: NoInfer<TtTableProps<Row>>): TtUseTableRenderReturnType<Row>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dazhicheng/ui",
-  "version": "1.6.2",
+  "version": "1.6.3",
   "description": "",
   "main": "./dist/index.js",
   "module": "./dist/index.js",