@hi-ui/schema-editable-table 4.0.0-experimental.1

package/lib/types/features/row-edit/hooks.d.ts

@@ -0,0 +1 @@
+export declare function useRuntimeRowEditable(rowIndex: number): boolean | undefined;

package/lib/types/features/row-edit/index.d.ts

@@ -0,0 +1,2 @@
+export * from './hooks';
+export * from './actions';

package/lib/types/features/row-expanding/index.d.ts

@@ -0,0 +1,3 @@
+export { RowExpandingWrapper } from './wrapper';
+export { useRowExpandedOpts } from './use-opts';
+export type { ExpandedOpts } from './use-opts';

package/lib/types/features/row-expanding/use-opts.d.ts

@@ -0,0 +1,12 @@
+import type { ExpandedOptions } from '@tanstack/react-table';
+import { StaticOptsRefType } from '../../hooks/use-global-static';
+export type ExpandedOpts = {};
+type UseExpandedOptsCtxType = {
+    staticOptsRef: StaticOptsRefType;
+};
+export declare function useRowExpandedOpts<TData extends AnyObject>(ctx: UseExpandedOptsCtxType): ExpandedOptions<TData>;
+/**
+ * 获取行展开配置选项
+ */
+export declare function getRowExpandedOptions<TData extends AnyObject>(ctx: UseExpandedOptsCtxType): ExpandedOptions<TData>;
+export {};

package/lib/types/features/row-expanding/wrapper.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { Cell } from '@tanstack/react-table';
+import type { FieldControlType } from '@hi-ui/schema-core';
+import type { BodyCellRenderCaseType } from '../../body/wrapper';
+type RowExpandingWrapperProps = {
+    cell: Cell<AnyType, unknown>;
+    textAlign?: FieldControlType['align'];
+    renderCase: BodyCellRenderCaseType;
+};
+export declare function RowExpandingWrapper(props: React.PropsWithChildren<RowExpandingWrapperProps>): JSX.Element;
+export {};

package/lib/types/features/row-operation/buttons.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import type { Row } from '@tanstack/react-table';
+import type { ActionFnParams, ActionConfigType } from '@hi-ui/schema-core';
+import type { ActionsProps } from '@hi-ui/schema-action-trigger';
+import { createEditButtons } from '../row-edit/actions';
+import type { TableCtxRefType } from '../../table';
+/** 按钮相关函数的参数类型 */
+type OpFnParams<TData extends AnyObject> = ActionFnParams<TData, OpButtonRenderCtx<TData>>;
+/** 配置式按钮的配置选项类型 */
+export type OpButtonConfigType<TData extends AnyObject = AnyObject> = ActionConfigType<TData, OpButtonRenderCtx<TData>>;
+/** 自定义渲染按钮函数的上下文类型 */
+export type OpButtonRenderCtx<TData extends AnyObject> = TableCtxRefType<TData> & {
+    row: Row<TData>;
+    rowIndex: number;
+    /**
+     * 行编辑相关
+     * @desc 未开启行编辑时会有默认的空值
+     */
+    rowEdit: {
+        /** 是否处于编辑状态 */
+        isEditing: boolean;
+        /** 编辑按钮对象 */
+        buttons: ReturnType<typeof createEditButtons>;
+    };
+};
+/** 【操作按钮组】组件的配置选项类型 */
+export type OpButtonsProps<TData extends AnyObject = AnyObject> = {
+    /** 行实例 */
+    row: Row<TData>;
+    /** 操作按钮配置 */
+    buttons?: ActionsProps<TData, OpButtonRenderCtx<TData>>['actions'];
+    /** 自定义渲染函数 */
+    render?: (...args: OpFnParams<TData>) => React.ReactElement[];
+    /** 是否启用行编辑 */
+    rowEdit?: boolean;
+    /** 最大显示数量，超出后显示更多按钮 */
+    maxCount?: ActionsProps['maxCount'];
+};
+/** 【操作按钮组】组件 */
+export declare function OpButtons<TData extends AnyObject = AnyObject>(props: OpButtonsProps<TData>): JSX.Element | null;
+export {};

package/lib/types/features/row-operation/cell.d.ts

@@ -0,0 +1,6 @@
+import type { Row } from '@tanstack/react-table';
+type OperationBodyCellProps<TData extends AnyObject> = {
+    row: Row<TData>;
+};
+export declare function OperationBodyCell<TData extends AnyObject>(props: OperationBodyCellProps<TData>): JSX.Element | null;
+export {};

package/lib/types/features/row-operation/index.d.ts

@@ -0,0 +1,18 @@
+import { OperationHeader, OperationBody, OperationFooter } from './wrapper';
+import type { OpButtonsProps } from './buttons';
+export type { OpButtonConfigType } from './buttons';
+export type RowOperationOptsType<TData extends AnyObject = AnyObject> = Omit<OpButtonsProps<TData>, 'row'> & {
+    /** 列宽 */
+    width?: number;
+    /**
+     * 表头文本
+     * - 默认值为中文【操作】
+     */
+    headerText?: string;
+};
+export declare const dftOpButtonCount = 3;
+export declare const RowOperation: {
+    Header: typeof OperationHeader;
+    Body: typeof OperationBody;
+    Footer: typeof OperationFooter;
+};

package/lib/types/features/row-operation/wrapper.d.ts

@@ -0,0 +1,3 @@
+export declare function OperationHeader(): JSX.Element;
+export declare function OperationBody(): JSX.Element;
+export declare function OperationFooter(): JSX.Element;

package/lib/types/features/row-selection/cell.d.ts

@@ -0,0 +1,62 @@
+import type { Row } from '@tanstack/react-table';
+import type { BoolConfig } from '@hi-ui/schema-utils';
+import type { RowSelectionIndicatorOpts } from './indicator';
+type RowSelectionOnCheckAllChangeCtxType = {
+    checked: boolean;
+    indeterminate: boolean;
+};
+export type RowSelectionOptsType<TData extends AnyObject = AnyObject> = {
+    type?: 'checkbox' | 'radio';
+    onChange?: (selected: {
+        keys: string[];
+        rows: TData[];
+    }) => void;
+    onCheckAllChange?: (ctx: RowSelectionOnCheckAllChangeCtxType) => void;
+    /**
+     * 是否在数据被删除时，仍保留已选择的数据
+     * - 建议在启用后端分页时打开该选项
+     */
+    preserveSelectedRows?: boolean;
+    /**
+     * 根据行数据决定是否启用行选择
+     * @desc 会在行选择状态变化时重新调用
+     * @desc 默认全部可以选中
+     */
+    enableRowSelection?: (rowData: TData, ctx: {
+        row: Row<TData>;
+    }) => boolean;
+    /**
+     * 根据行数据决定是否启用子行选择
+     * @desc 会在行选择状态变化时重新调用
+     * @desc 默认全部可以选中子行
+     */
+    enableSubRowSelection?: (rowData: TData, ctx: {
+        row: Row<TData>;
+    }) => boolean;
+    /**
+     * 是否启用动态行可选状态支持
+     * @deprecated 经过性能优化，已无需通过此处配置来控制是否订阅
+     * @desc 启用后 SelectionCell 会在任意行选择状态发生变化时触发重渲染
+     * @desc 会有性能下降，避免在大数据量的表格使用
+     */
+    enableDynamicRowSelection?: boolean;
+    /** 初次加载时默认选中的行 */
+    dftSelectedRowKeys?: (string | number)[];
+    /**
+     * 是否启用点击行选择
+     * @desc 启用后，点击行的任意只读单元格均会触发选中
+     * @desc 若与分页同时启用，则必须传入 rowKey 配置，否则无法正确选中
+     */
+    enableClickSelect?: boolean;
+    /**
+     * 是否启用行选择指示器
+     * @desc 启用后，会在表格底部显示一个行选择指示器，展示当前选中的行的数量
+     */
+    enableIndicator?: BoolConfig<RowSelectionIndicatorOpts>;
+};
+export declare function SelectionHeaderCell(): JSX.Element | null;
+type SelectionBodyCellProps<TData extends AnyObject> = {
+    row: Row<TData>;
+};
+export declare function SelectionBodyCell<TData extends AnyObject>(props: SelectionBodyCellProps<TData>): JSX.Element | null;
+export {};

package/lib/types/features/row-selection/const.d.ts

@@ -0,0 +1 @@
+export declare const dftSelectionType: "checkbox";

package/lib/types/features/row-selection/hooks/index.d.ts

@@ -0,0 +1,6 @@
+import type { RowSelectionState } from '@tanstack/react-table';
+export declare function useRowSelectionState(): {
+    rowSelectionState: import("@hi-ui/use-subscription").SubscriptionType<RowSelectionState>;
+};
+export { useRowSelectionOpts } from './use-opts';
+export { useSyncHoverStyle } from './use-sync-hover-style';

package/lib/types/features/row-selection/hooks/use-click-select.d.ts

@@ -0,0 +1 @@
+export declare const useClickSelect: () => void;

package/lib/types/features/row-selection/hooks/use-opts.d.ts

@@ -0,0 +1,15 @@
+import type { PaginationState, TableOptions } from '@tanstack/react-table';
+import type { InnerRefType } from '../../../ctx';
+import type { RowSelectionOptsType } from '../index';
+type UseRowSelectionOptsCtxType<TData extends AnyObject> = {
+    rowSelection: RowSelectionOptsType<TData> | undefined;
+    innerRef: InnerRefType<TData>;
+};
+export declare function useRowSelectionOpts<TData extends AnyObject>(ctx: UseRowSelectionOptsCtxType<TData>): Pick<TableOptions<TData>, "enableRowSelection" | "enableMultiRowSelection" | "onRowSelectionChange" | "enableSubRowSelection">;
+/** 如果开启了后端分页，并且没有配置 preserveSelectedRows，则需要在分页变化时清空选中状态 */
+export declare function resetRowSelectionAfterPaginationChange<TData extends AnyObject>(ctx: {
+    innerRef: InnerRefType<TData>;
+    state: PaginationState;
+    newState: PaginationState;
+}): void;
+export {};

package/lib/types/features/row-selection/hooks/use-set-selected-row-keys.d.ts

@@ -0,0 +1,9 @@
+import type { InnerRefType } from '../../../ctx';
+type SetSelectedRowKeysCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+};
+type RowKeyType = string | number;
+type GetRowKeysType = (keys: RowKeyType[]) => RowKeyType[] | null;
+export type InnerSetSelectedRowKeys = (keys: RowKeyType[] | GetRowKeysType | null) => void;
+export declare function useSetSelectedRowKeys<TData extends AnyObject>(ctx: SetSelectedRowKeysCtxType<TData>): InnerSetSelectedRowKeys;
+export {};

package/lib/types/features/row-selection/hooks/use-sync-hover-style.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 同步表格行的 hover 状态
+ * @desc 当表格分为选择列和主内容两部分时，确保 hover 效果能同步显示在两边
+ */
+export declare function useSyncHoverStyle(): void;

package/lib/types/features/row-selection/index.d.ts

@@ -0,0 +1,7 @@
+export { RowSelection } from './wrapper';
+export { SelectionHeaderCell, SelectionBodyCell } from './cell';
+export { useRowSelectionState } from './hooks';
+export { RowSelectionIndicator } from './indicator';
+export type { RowSelectionOptsType } from './cell';
+export { useSetSelectedRowKeys } from './hooks/use-set-selected-row-keys';
+export type { InnerSetSelectedRowKeys } from './hooks/use-set-selected-row-keys';

package/lib/types/features/row-selection/indicator.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export type RowSelectionIndicatorOpts = {
+    /** 开启仅显示已选功能 */
+    enableOnlyShowSelected?: boolean;
+    /** 格式化已选数量 */
+    formatter?: (selectedCount: number) => React.ReactNode;
+};
+export declare function RowSelectionIndicator(): JSX.Element;

package/lib/types/features/row-selection/wrapper.d.ts

@@ -0,0 +1,9 @@
+declare function SelectionHeader(): JSX.Element;
+declare function SelectionBody(): JSX.Element;
+declare function SelectionFooter(): JSX.Element;
+export declare const RowSelection: {
+    Header: typeof SelectionHeader;
+    Body: typeof SelectionBody;
+    Footer: typeof SelectionFooter;
+};
+export {};

package/lib/types/features/setting-bridge.d.ts

@@ -0,0 +1,14 @@
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { TableColumn, TableSettingProps } from '@hi-ui/schema-table-extensions';
+import type { TableCtxRefType } from '../table';
+/**
+ * 将字段配置转换为列设置需要的格式
+ */
+export declare function mapFieldsToColumns(fields: FieldConfigType[]): TableColumn[];
+export type UseTableSettingProps = {
+    fields: FieldConfigType[];
+    tableRef: React.RefObject<TableCtxRefType>;
+    storageKey?: string;
+    onChange?: TableSettingProps['onChange'];
+};
+export declare function useTableSetting(props: UseTableSettingProps): TableSettingProps;

package/lib/types/features/sorter/bridge.d.ts

@@ -0,0 +1,8 @@
+import type { HeaderContext } from '@tanstack/react-table';
+import type { FieldConfigType, FieldSorterConfigType } from '@hi-ui/schema-core';
+export type TableSorterBridgeProps<TData extends AnyObject> = {
+    column: HeaderContext<TData, unknown>['column'];
+    field: FieldConfigType;
+    sorter?: FieldSorterConfigType;
+};
+export declare function TableSorterBridge<TData extends AnyObject>(props: TableSorterBridgeProps<TData>): JSX.Element;

package/lib/types/features/sorter/get-sorter-config.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltInSortingFn as TanStackBuiltInSortingFn } from '@tanstack/react-table';
+import type { FieldConfigType, FieldSorterConfigType } from '@hi-ui/schema-core';
+import { PropsRefType } from '../../ctx';
+export type BuiltInSortingFn = TanStackBuiltInSortingFn | 'textLocalCompare';
+export declare function getSorterConfig(field: FieldConfigType, ctx: {
+    propsRef: PropsRefType<AnyObject>;
+}): FieldSorterConfigType | undefined;

package/lib/types/features/sorter/index.d.ts

@@ -0,0 +1,8 @@
+import type { SortingState } from '@tanstack/react-table';
+export { useSorterOpts, getSorterOptions } from './use-opts';
+export { getSorterConfig } from './get-sorter-config';
+export { TableSorterBridge } from './bridge';
+export type { SorterOpts } from './use-opts';
+export declare function useSorterState(): {
+    sorterState: import("@hi-ui/use-subscription").SubscriptionType<SortingState>;
+};

package/lib/types/features/sorter/use-opts.d.ts

@@ -0,0 +1,71 @@
+import type { SortingState, TableOptions, SortingColumnDef } from '@tanstack/react-table';
+import type { TableSorterProps } from '@hi-ui/schema-table-extensions';
+import { type OnChangeFnCtxType } from '../../utils';
+import type { InnerRefType, PropsRefType } from '../../ctx';
+import type { StaticOptsRefType } from '../../hooks/use-global-static';
+export type SorterOpts = {
+    remote?: boolean;
+    tooltip?: TableSorterProps['tooltip'];
+    onChange?: (state: SortingState, ctx: OnChangeFnCtxType<SortingState>) => void;
+    /**
+     * 是否开启多排序
+     * @default true
+     */
+    enableMultiSort?: TableOptions<AnyObject>['enableMultiSort'];
+    /**
+     * 最大多排序列数
+     */
+    maxMultiSortColCount?: TableOptions<AnyObject>['maxMultiSortColCount'];
+    /**
+     * 如何排序 undefined 值
+     * @default 'last' 也就是默认全部排在最后
+     */
+    sortUndefined?: SortingColumnDef<AnyObject>['sortUndefined'];
+};
+type UseSorterOptsCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+    propsRef: PropsRefType<TData>;
+    staticOptsRef: StaticOptsRefType;
+};
+export declare function useSorterOpts<TData extends AnyObject>(ctx: UseSorterOptsCtxType<TData>): {
+    manualSorting?: undefined;
+    enableMultiSort?: undefined;
+    maxMultiSortColCount?: undefined;
+    onSortingChange?: undefined;
+    getSortedRowModel?: undefined;
+} | {
+    manualSorting: boolean;
+    enableMultiSort: boolean | undefined;
+    maxMultiSortColCount: number | undefined;
+    onSortingChange: import("@tanstack/react-table").OnChangeFn<SortingState>;
+    getSortedRowModel?: undefined;
+} | {
+    manualSorting: boolean;
+    enableMultiSort: boolean | undefined;
+    maxMultiSortColCount: number | undefined;
+    getSortedRowModel: (table: import("@tanstack/react-table").Table<unknown>) => () => import("@tanstack/react-table").RowModel<unknown>;
+    onSortingChange: import("@tanstack/react-table").OnChangeFn<SortingState>;
+};
+/**
+ * 获取表格排序配置选项
+ */
+export declare function getSorterOptions<TData extends AnyObject>(ctx: UseSorterOptsCtxType<TData>): {
+    manualSorting?: undefined;
+    enableMultiSort?: undefined;
+    maxMultiSortColCount?: undefined;
+    onSortingChange?: undefined;
+    getSortedRowModel?: undefined;
+} | {
+    manualSorting: boolean;
+    enableMultiSort: boolean | undefined;
+    maxMultiSortColCount: number | undefined;
+    onSortingChange: import("@tanstack/react-table").OnChangeFn<SortingState>;
+    getSortedRowModel?: undefined;
+} | {
+    manualSorting: boolean;
+    enableMultiSort: boolean | undefined;
+    maxMultiSortColCount: number | undefined;
+    getSortedRowModel: (table: import("@tanstack/react-table").Table<unknown>) => () => import("@tanstack/react-table").RowModel<unknown>;
+    onSortingChange: import("@tanstack/react-table").OnChangeFn<SortingState>;
+};
+export {};

package/lib/types/field-bridge/bridge.d.ts

@@ -0,0 +1,18 @@
+import type { ToolbarConfigType } from '@hi-ui/schema-action-trigger';
+import type { EditTableProps, TableCtxRefType } from '../index';
+export type EditTableBridgeInnerCtxType = {
+    tableCtx: TableCtxRefType | null;
+};
+export type EditTableBridgeProps = EditTableProps & {
+    toolbar?: false | ToolbarConfigType;
+    actions?: ToolbarConfigType['right'];
+    /** 捕获 innerCtxRef 引用 */
+    catchInnerCtx?: (ctx: EditTableBridgeInnerCtxType) => void;
+    /**
+     * 不要触发完全重渲染
+     * - 默认情况时，表单绑定的数据变化时，会触发完全重渲染
+     * - 本质是给 subscription.setValue 传入 complete: false
+     */
+    doNotCompleteRerender?: boolean;
+};
+export declare function EditTableBridge(props: EditTableBridgeProps): JSX.Element;

package/lib/types/field-bridge/index.d.ts

@@ -0,0 +1,11 @@
+import { ProField } from '@hi-ui/schema-fields';
+import type { ProFieldRenderCtx, ProFieldRenderFormItemCtx } from '@hi-ui/schema-fields';
+import { EditTableBridge, type EditTableBridgeProps } from './bridge';
+export { EditTableBridge, EditTableBridgeProps };
+export type { FormEditTableToolbarCtxType } from './toolbar';
+export type ProEditTableProps = EditTableBridgeProps & {};
+export declare class ProEditTable extends ProField {
+    render(data: AnyObject[] | undefined, ctx: ProFieldRenderCtx<EditTableBridgeProps>): JSX.Element;
+    renderCell(): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<EditTableBridgeProps>): JSX.Element;
+}

package/lib/types/field-bridge/toolbar.d.ts

@@ -0,0 +1,9 @@
+import type { TableToolbarCtxType, TableToolbarProps } from '@hi-ui/schema-action-trigger';
+export type FormEditTableToolbarCtxType = TableToolbarCtxType & {
+    readonly?: boolean;
+};
+type ToolbarProps = Omit<TableToolbarProps, 'className'> & {
+    ctx: FormEditTableToolbarCtxType;
+};
+export declare function Toolbar(props: ToolbarProps): JSX.Element;
+export {};

package/lib/types/footer/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export type EditTableFooterProps = {
+    className?: string;
+};
+declare const _default: React.NamedExoticComponent<EditTableFooterProps>;
+export default _default;

package/lib/types/footer/use-first-cell-patch.d.ts

@@ -0,0 +1 @@
+export declare function useFirstCellPatch(): void;

package/lib/types/header/index.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { Header, Table } from '@tanstack/react-table';
+export type EditTableHeaderProps = {
+    className?: string;
+};
+type HeaderCellWrapperDynamicAttrsCtxType = {
+    header: Header<AnyType, unknown>;
+};
+type HeaderCellWrapperDynamicAttrsType = React.ThHTMLAttributes<HTMLTableCellElement>;
+export type GetHeaderCellWrapperDynamicAttrsFnType = (ctx: HeaderCellWrapperDynamicAttrsCtxType) => HeaderCellWrapperDynamicAttrsType;
+declare const _default: React.NamedExoticComponent<EditTableHeaderProps>;
+export default _default;
+export declare function groupHeaders(headers: Header<AnyType, unknown>[], table: Table<AnyType>): {
+    left: typeof headers;
+    center: typeof headers;
+    right: typeof headers;
+};

package/lib/types/header/validate.d.ts

@@ -0,0 +1,10 @@
+import type { Header } from '@tanstack/react-table';
+type HeaderValidationResult = {
+    isValid: false;
+} | {
+    isValid: true;
+    rowSpan: number;
+    type: 'PLACEHOLDER-NO-PARENT' | 'PLACEHOLDER-WITH-PARENT' | 'NORMAL-NO-PARENT' | 'NORMAL-WITH-PARENT';
+};
+export declare function validateHeaderCell(header: Header<AnyObject, unknown>, totalHeaderRows: number): HeaderValidationResult;
+export {};

package/lib/types/hooks/use-get-fields-value.d.ts

@@ -0,0 +1,14 @@
+import { EditableSchemaTableCtxType } from '../ctx';
+type UseGetFieldsValueCtxType<TData extends AnyObject> = {
+    innerRef: React.MutableRefObject<EditableSchemaTableCtxType<TData>>;
+};
+type GetFieldsValueExtraOptsType = {
+    /** 额外需要获取的 fields */
+    extraFields?: string[];
+};
+export declare function useGetFieldsValue<TData extends AnyObject = AnyObject>(ctx: UseGetFieldsValueCtxType<TData>): <DataType extends AnyObject = Partial<TData>>(opts?: GetFieldsValueExtraOptsType) => DataType[];
+export declare function useGetGroupedValues<TData extends AnyObject = AnyObject>(ctx: UseGetFieldsValueCtxType<TData>): () => {
+    editable: Pick<TData, string>;
+    readonly: Omit<TData, string>;
+}[];
+export {};

package/lib/types/hooks/use-global-actions.d.ts

@@ -0,0 +1,24 @@
+import type { ReadonlyRefObject } from '@hi-ui/schema-hooks';
+import type { InnerRefType } from '../ctx';
+import type { InnerGetDataSourceType, InnerUpdateDataSourceType, InnerResetDataSourceType } from '../features/async-data';
+import type { InnerSetSelectedRowKeys } from '../features/row-selection';
+export type GlobalStaticActionsType<TData extends AnyObject> = {
+    /** 获取异步数据源（仅获取数据） */
+    getDataSource: InnerGetDataSourceType<TData>;
+    /** 更新异步数据源（获取数据并更新表格） */
+    updateDataSource: InnerUpdateDataSourceType;
+    /** 重置分页、筛选状态 */
+    resetDataSource: InnerResetDataSourceType;
+    /** 设置表格数据源 */
+    setDataSource: (newValue: TData[] | ((prev: TData[]) => TData[])) => void;
+    /** 设置行选择状态 */
+    setSelectedRowKeys: InnerSetSelectedRowKeys;
+};
+type UseGlobalStaticActionsCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+};
+/**
+ * 全局静态函数
+ */
+export declare function useGlobalStaticActions<TData extends AnyObject>(ctx: UseGlobalStaticActionsCtxType<TData>): ReadonlyRefObject<GlobalStaticActionsType<TData>>;
+export {};

package/lib/types/hooks/use-global-static.d.ts

@@ -0,0 +1,83 @@
+import type { ReadonlyRefObject } from '@hi-ui/schema-hooks';
+import type { EditableSchemaTableCtxType, PropsRefType } from '../ctx';
+export type GlobalStaticConfigType = {
+    /** 是否启用异步数据 */
+    enableAsyncData: boolean;
+    /** 是否为空 */
+    isEmpty: boolean;
+    /** 是否展示表尾 */
+    showFooter: boolean;
+    /** 是否存在粘性 Footer */
+    hasStickyFooter: true | undefined;
+    /** 是否存在嵌套表头 */
+    hasNestHeader: boolean;
+    /** 是否存在左固定列(不包括选择列) */
+    hasLeftFixed: boolean;
+    /** 是否存在右固定列(不包括操作列) */
+    hasRightFixed: boolean;
+    /** 启用行选择偏移 */
+    enableRowSelection: boolean;
+    /** 启用行操作偏移 */
+    enableRowOperation: boolean;
+    /** 启用行编辑 */
+    enableRowEdit: boolean;
+    /** 操作列列宽 */
+    operationColWidth: number;
+    /** 所有可编辑字段的 key */
+    editableFieldKeys: string[];
+    /** 是否启用分页 */
+    enablePagination: boolean;
+    /** 是否仅在 hover 时显示表头操作 */
+    enableHeaderActionHoverOnly: boolean;
+    /** 是否启用表头过滤 */
+    enableFilter: boolean;
+    /** 表头过滤是否启用远程数据 */
+    enableRemoteFilter: boolean;
+    /** 是否启用表头排序 */
+    enableSorter: boolean;
+    /** 表头排序是否启用远程数据 */
+    enableRemoteSorter: boolean;
+    /** 是否启用行展开 */
+    enableRowExpanding: boolean;
+    /** 是否启用列分组 */
+    enableRowGrouping: boolean;
+    /** 底部容器是否为空 */
+    isBottomEmpty: boolean;
+};
+type UseGlobalStaticCtxType = Pick<EditableSchemaTableCtxType<AnyType>, 'table' | 'propsRef' | 'subscription'> & {
+    staticOptsRef: StaticOptsRefType;
+};
+export type PropsStaticOptsType = ReturnType<typeof genStaticOptsFromPropsRef>;
+/**
+ * 从 propsRef 中生成的静态配置的引用
+ * @desc 仅用于 globalStaticRef 生成前，生成后则应统一使用 globalStaticRef
+ */
+export type StaticOptsRefType = ReadonlyRefObject<PropsStaticOptsType>;
+/**
+ * 从 propsRef 中生成静态配置
+ * @desc 是 useGlobalStatic 返回值的子集
+ * @desc 也就是仅包含能直接从 propsRef 中获取的选项配置
+ */
+export declare function genStaticOptsFromPropsRef(propsRef: PropsRefType<AnyType>): {
+    enableAsyncData: boolean;
+    hasNestHeader: boolean;
+    enableRowSelection: boolean;
+    enableRowOperation: boolean;
+    enableRowEdit: boolean;
+    operationColWidth: number;
+    enablePagination: boolean;
+    enableHeaderActionHoverOnly: boolean;
+    enableFilter: boolean;
+    enableRemoteFilter: boolean;
+    enableSorter: boolean;
+    enableRemoteSorter: boolean;
+    enableRowExpanding: boolean;
+    enableRowGrouping: boolean;
+    isBottomEmpty: boolean;
+};
+/**
+ * 全局静态配置
+ * @desc 实际上并不是完全静态，而是指由配置生成后，禁止主动变化
+ */
+export declare function useGlobalStatic(ctx: UseGlobalStaticCtxType): ReadonlyRefObject<GlobalStaticConfigType>;
+export {};

package/lib/types/hooks/use-initial-render.d.ts

@@ -0,0 +1 @@
+export declare function useInitialRender(): void;

package/lib/types/hooks/use-inner-ctx.d.ts

@@ -0,0 +1,12 @@
+import { EditableSchemaTableCtxType } from '../ctx';
+import type { TableCtxRefType } from '../table';
+type InnerCtxType<TData extends AnyObject = AnyObject> = Omit<EditableSchemaTableCtxType<TData>, 'exposeCtxValueRef'> & Omit<TableCtxRefType<TData>, 'innerRef' | 'scrollIntoView' | 'getDataSource' | 'updateDataSource' | 'resetDataSource' | 'setDataSource' | 'getCellValue' | 'setCellValue' | 'setSelectedRowKeys'>;
+/**
+ * 组装内部上下文
+ * @desc 没啥特殊逻辑，完全是Table里代码太多了，精简拆分一下
+ */
+export declare function useTableInnerCtx<TData extends AnyObject = AnyObject>(ctx: InnerCtxType<TData>): {
+    ctxValue: EditableSchemaTableCtxType<TData>;
+    exposeCtxValue: () => TableCtxRefType<TData>;
+};
+export {};