@rainbow-oh/yee-c 0.12.2 → 0.14.0

package/dist/cjs/Field/demo/standalone.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const _default: () => React.JSX.Element;
+export default _default;

package/dist/cjs/Field/demo/standalone.js

@@ -0,0 +1,56 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Field/demo/standalone.tsx
+var standalone_exports = {};
+__export(standalone_exports, {
+  default: () => standalone_default
+});
+module.exports = __toCommonJS(standalone_exports);
+var import_yee_c = require("../..");
+var import_react = __toESM(require("react"));
+var standalone_default = () => {
+  const [name, setName] = (0, import_react.useState)("");
+  const [remark, setRemark] = (0, import_react.useState)("");
+  return /* @__PURE__ */ import_react.default.createElement("div", { style: { maxWidth: 400 } }, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, { label: "Name", required: true }, /* @__PURE__ */ import_react.default.createElement(
+    import_yee_c.Input,
+    {
+      value: name,
+      onChange: (v) => setName(v),
+      placeholder: "Standalone controlled Input"
+    }
+  )), /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, { label: "Remark" }, /* @__PURE__ */ import_react.default.createElement(
+    import_yee_c.TextArea,
+    {
+      value: remark,
+      onChange: (v) => setRemark(v),
+      placeholder: "Standalone controlled TextArea",
+      rows: 3
+    }
+  )), /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, null, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Input, { placeholder: "Field without label" })));
+};

package/dist/cjs/Field/field.js

@@ -55,7 +55,7 @@ var Field = (props) => {
     disabled
   } = props;
   const [, forceUpdate] = (0, import_react2.useReducer)((x) => x + 1, 0);
-  const { form } = (0, import_useVirtualField.default)(formName, name, {
+  const { form } = (0, import_useVirtualField.default)(formName != null ? formName : "", name != null ? name : "", {
     props,
     onStoreChange: forceUpdate
   });
@@ -71,11 +71,20 @@ var Field = (props) => {
     return Array.isArray(rules) && rules.some((rule) => rule.required) || required;
   };
   const getControlled = (children2) => {
-    const mergedDisabled = disabled || children2.props.disabled;
+    const childProps = children2.props;
+    if (!form || name === void 0) {
+      if (disabled === void 0)
+        return children2;
+      return import_react2.default.cloneElement(children2, {
+        disabled: disabled || childProps.disabled
+      });
+    }
+    const mergedDisabled = disabled || childProps.disabled;
+    const fieldName = name;
     const attr = {
-      value: getFieldValue == null ? void 0 : getFieldValue(name),
+      value: getFieldValue == null ? void 0 : getFieldValue(fieldName),
       name: formName,
-      id: name,
+      id: fieldName,
       disabled: mergedDisabled,
       onChange: (value, ...rest) => {
         var _a, _b, _c;
@@ -84,21 +93,21 @@ var Field = (props) => {
         const fieldsValue = getFieldsValue == null ? void 0 : getFieldsValue();
         const feedback = (_a = callbacks == null ? void 0 : callbacks.onValuesBeforeChange) == null ? void 0 : _a.call(
           callbacks,
-          { [name]: _value },
+          { [fieldName]: _value },
           fieldsValue
         );
         if (feedback !== void 0) {
           _value = feedback;
         }
-        setFieldsValue == null ? void 0 : setFieldsValue({ [name]: _value }, "onChange");
+        setFieldsValue == null ? void 0 : setFieldsValue({ [fieldName]: _value }, "onChange");
         if ((_b = children2.props) == null ? void 0 : _b.onChange) {
           children2.props.onChange(_value, ...rest);
         }
-        (_c = callbacks == null ? void 0 : callbacks["onValuesChange"]) == null ? void 0 : _c.call(callbacks, { [name]: _value }, fieldsValue);
+        (_c = callbacks == null ? void 0 : callbacks["onValuesChange"]) == null ? void 0 : _c.call(callbacks, { [fieldName]: _value }, fieldsValue);
         forceUpdate();
       },
       onBlur: (event) => {
-        void (validateField == null ? void 0 : validateField(name, "onBlur"));
+        void (validateField == null ? void 0 : validateField(fieldName, "onBlur"));
         if (children2.props.onBlur) {
           children2.props.onBlur(event);
         }
@@ -106,7 +115,7 @@ var Field = (props) => {
     };
     return import_react2.default.cloneElement(children2, attr);
   };
-  const validate = getFieldValidate == null ? void 0 : getFieldValidate(name);
+  const validate = name !== void 0 ? getFieldValidate == null ? void 0 : getFieldValidate(name) : void 0;
   return /* @__PURE__ */ import_react2.default.createElement(
     "div",
     {
@@ -120,7 +129,7 @@ var Field = (props) => {
       ),
       style
     },
-    /* @__PURE__ */ import_react2.default.createElement(
+    label ? /* @__PURE__ */ import_react2.default.createElement(
       "label",
       {
         className: (0, import_clsx.default)(
@@ -133,7 +142,7 @@ var Field = (props) => {
         style: styles == null ? void 0 : styles.label
       },
       label
-    ),
+    ) : null,
     /* @__PURE__ */ import_react2.default.createElement(
       "div",
       {

package/dist/cjs/Field/interface.d.ts

@@ -27,13 +27,16 @@ export interface FieldProps {
      */
     label?: React.ReactNode;
     /**
-     * Field name
+     * Field name (required only when used with a registered virtual form)
      */
-    name: string;
+    name?: string;
     /**
-     * Name of the parent form
+     * Name of the parent form.
+     * When omitted (or no form is registered under this name), Field renders
+     * as a pure layout wrapper: the child keeps its own value/onChange and
+     * no validation runs.
      */
-    formName: string;
+    formName?: string;
     /**
      * Whether disabled
      */

package/dist/cjs/Field/style/index.less

@@ -25,6 +25,7 @@
   &-content {
     position: relative;
     padding-bottom: var(--yee-field-content-padding-bottom);
+    width: stretch;
   }
 
   &-error {

package/dist/cjs/Table/demo/controlled-filter.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const _default: () => React.JSX.Element;
+export default _default;

package/dist/cjs/Table/demo/controlled-filter.js

@@ -0,0 +1,105 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Table/demo/controlled-filter.tsx
+var controlled_filter_exports = {};
+__export(controlled_filter_exports, {
+  default: () => controlled_filter_default
+});
+module.exports = __toCommonJS(controlled_filter_exports);
+var import_yee_c = require("../..");
+var import_react = __toESM(require("react"));
+var allData = [
+  { key: "1", name: "John Brown", age: 32, gender: "male" },
+  { key: "2", name: "Jim Green", age: 42, gender: "male" },
+  { key: "3", name: "Joe Black", age: 32, gender: "male" },
+  { key: "4", name: "Jon Snow", age: 42, gender: "female" },
+  { key: "5", name: "Arya Stark", age: 16, gender: "female" }
+];
+var controlled_filter_default = () => {
+  const { messageApi, messageHolder } = import_yee_c.message.useMessage();
+  const [nameKeyword, setNameKeyword] = (0, import_react.useState)("");
+  const [genders, setGenders] = (0, import_react.useState)([]);
+  const columns = [
+    {
+      title: "Name",
+      dataIndex: "name",
+      key: "name",
+      filter: {
+        searchable: true,
+        // No onFilter: no local matching, the search hits the "server".
+        filteredValue: nameKeyword
+      }
+    },
+    {
+      title: "Age",
+      dataIndex: "age",
+      key: "age"
+    },
+    {
+      title: "Gender",
+      dataIndex: "gender",
+      key: "gender",
+      filter: {
+        filterMode: "tree",
+        items: [
+          { label: "Male", key: "male" },
+          { label: "Female", key: "female" }
+        ],
+        filteredValue: genders,
+        onFilter: (value, record) => value === record.gender
+      }
+    }
+  ];
+  const handleChange = (info) => {
+    var _a, _b, _c;
+    if (info.action !== "filter")
+      return;
+    const filters = (_a = info.filters) != null ? _a : {};
+    const name = (_b = filters.name) != null ? _b : "";
+    if (name !== nameKeyword) {
+      messageApi.info(`Fetch: /api/users?name=${name}`);
+      setNameKeyword(name);
+    }
+    setGenders((_c = filters.gender) != null ? _c : []);
+  };
+  const data = allData.filter((item) => {
+    const matchName = nameKeyword ? item.name.toLowerCase().includes(nameKeyword.toLowerCase()) : true;
+    const matchGender = genders.length ? genders.includes(item.gender) : true;
+    return matchName && matchGender;
+  });
+  return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, messageHolder, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Space, { block: true, style: { marginBottom: 16 } }, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Button, { onClick: () => setNameKeyword("") }, "Reset name search"), /* @__PURE__ */ import_react.default.createElement(import_yee_c.Button, { onClick: () => setGenders([]) }, "Reset gender filter")), /* @__PURE__ */ import_react.default.createElement(
+    import_yee_c.Table,
+    {
+      columns,
+      dataSource: data,
+      onChange: handleChange,
+      pagination: false
+    }
+  ));
+};

package/dist/cjs/Table/hooks/useFilter.d.ts

@@ -8,12 +8,16 @@ type FilterRecord = {
     value: FilterInput;
     dataIndex: string;
 };
+export declare const isControlledFilter: (column?: ColumnProps) => boolean;
 export default function useFilter({ data, columns, }: {
     data: Array<Record<string, unknown>>;
     columns: ColumnProps[];
 }): {
     data: Record<string, unknown>[];
     filterRecords: FilterRecord[];
-    onFilter: ({ value, dataIndex }: FilterOptions) => void;
+    onFilter: ({ value, dataIndex }: FilterOptions) => {
+        data: Record<string, unknown>[];
+        filterRecords: FilterRecord[];
+    };
 };
 export {};

package/dist/cjs/Table/hooks/useFilter.js

@@ -36,17 +36,71 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/Table/hooks/useFilter.ts
 var useFilter_exports = {};
 __export(useFilter_exports, {
-  default: () => useFilter
+  default: () => useFilter,
+  isControlledFilter: () => isControlledFilter
 });
 module.exports = __toCommonJS(useFilter_exports);
 var import_react = require("react");
 var isEmptyFilterValue = (value) => value === "" || Array.isArray(value) && value.length === 0;
+var isControlledFilter = (column) => {
+  var _a;
+  return ((_a = column == null ? void 0 : column.filter) == null ? void 0 : _a.filteredValue) !== void 0;
+};
 var normalizeValue = (value) => value === null || value === void 0 ? "" : String(value).toLowerCase();
+var mergeRecords = (internalRecords, columnMap) => {
+  const controlled = [];
+  columnMap.forEach((column, dataIndex) => {
+    var _a;
+    if (!isControlledFilter(column))
+      return;
+    const value = (_a = column.filter) == null ? void 0 : _a.filteredValue;
+    if (!isEmptyFilterValue(value)) {
+      controlled.push({ dataIndex, value });
+    }
+  });
+  const merged = internalRecords.filter(
+    (record) => !isControlledFilter(columnMap.get(record.dataIndex))
+  );
+  if (!controlled.length && merged.length === internalRecords.length) {
+    return internalRecords;
+  }
+  return [...merged, ...controlled];
+};
+var applyFilters = (data, records, columnMap) => {
+  const handled = records.filter(
+    ({ dataIndex, value }) => Boolean(dataIndex) && columnMap.has(dataIndex) && !isEmptyFilterValue(value)
+  );
+  if (!handled.length) {
+    return data;
+  }
+  return data.filter((item) => {
+    return handled.every(({ dataIndex, value }) => {
+      var _a, _b;
+      const column = columnMap.get(dataIndex);
+      if (isControlledFilter(column) && !((_a = column == null ? void 0 : column.filter) == null ? void 0 : _a.onFilter)) {
+        return true;
+      }
+      const customFilter = (_b = column == null ? void 0 : column.filter) == null ? void 0 : _b.onFilter;
+      if (customFilter) {
+        return Array.isArray(value) ? value.some((filterValue) => customFilter(filterValue, item)) : customFilter(value, item);
+      }
+      const targetValue = normalizeValue(item[dataIndex]);
+      if (Array.isArray(value)) {
+        return value.some(
+          (filterValue) => targetValue === normalizeValue(filterValue)
+        );
+      }
+      return targetValue.includes(normalizeValue(value));
+    });
+  });
+};
 function useFilter({
   data,
   columns
 }) {
-  const [filterRecords, setFilterRecords] = (0, import_react.useState)([]);
+  const [internalRecords, setInternalRecords] = (0, import_react.useState)(
+    []
+  );
   const columnMap = (0, import_react.useMemo)(
     () => new Map(
       columns.flatMap(
@@ -56,52 +110,36 @@ function useFilter({
     [columns]
   );
   (0, import_react.useEffect)(() => {
-    setFilterRecords((current) => {
+    setInternalRecords((current) => {
       const next = current.filter(({ dataIndex }) => columnMap.has(dataIndex));
       return next.length === current.length ? current : next;
     });
   }, [columnMap]);
-  const onFilter = ({ value, dataIndex }) => {
-    setFilterRecords((current) => {
-      if (isEmptyFilterValue(value)) {
-        return current.filter((item) => item.dataIndex !== dataIndex);
-      }
-      const index = current.findIndex((item) => item.dataIndex === dataIndex);
-      if (index === -1) {
-        return [...current, { dataIndex, value }];
-      }
-      return current.map(
-        (item, itemIndex) => itemIndex === index ? __spreadProps(__spreadValues({}, item), { value }) : item
-      );
-    });
-  };
-  const filtered = (0, import_react.useMemo)(() => {
-    const handled = filterRecords.filter(
-      ({ dataIndex, value }) => Boolean(dataIndex) && columnMap.has(dataIndex) && !isEmptyFilterValue(value)
-    );
-    if (!handled.length) {
-      return data;
-    }
-    return data.filter((item) => {
-      return handled.every(({ dataIndex, value }) => {
-        var _a, _b;
-        const customFilter = (_b = (_a = columnMap.get(dataIndex)) == null ? void 0 : _a.filter) == null ? void 0 : _b.onFilter;
-        if (customFilter) {
-          return Array.isArray(value) ? value.some((filterValue) => customFilter(filterValue, item)) : customFilter(value, item);
-        }
-        const targetValue = normalizeValue(item[dataIndex]);
-        if (Array.isArray(value)) {
-          return value.some(
-            (filterValue) => targetValue === normalizeValue(filterValue)
-          );
-        }
-        return targetValue.includes(normalizeValue(value));
-      });
-    });
-  }, [columnMap, data, filterRecords]);
+  const activeRecords = (0, import_react.useMemo)(
+    () => mergeRecords(internalRecords, columnMap),
+    [internalRecords, columnMap]
+  );
+  const filtered = (0, import_react.useMemo)(
+    () => applyFilters(data, activeRecords, columnMap),
+    [columnMap, data, activeRecords]
+  );
+  const onFilter = (0, import_react.useCallback)(
+    ({ value, dataIndex }) => {
+      const nextInternal = isEmptyFilterValue(value) ? internalRecords.filter((item) => item.dataIndex !== dataIndex) : internalRecords.some((item) => item.dataIndex === dataIndex) ? internalRecords.map(
+        (item) => item.dataIndex === dataIndex ? __spreadProps(__spreadValues({}, item), { value }) : item
+      ) : [...internalRecords, { dataIndex, value }];
+      setInternalRecords(nextInternal);
+      const nextActive = mergeRecords(nextInternal, columnMap);
+      return {
+        data: applyFilters(data, nextActive, columnMap),
+        filterRecords: nextActive
+      };
+    },
+    [internalRecords, columnMap, data]
+  );
   return {
     data: filtered,
-    filterRecords,
+    filterRecords: activeRecords,
     onFilter
   };
 }

package/dist/cjs/Table/index.d.ts

@@ -2,7 +2,7 @@ import Column from './column';
 import Summary from './summary';
 import InternalTable from './table';
 import Head from './theader';
-export type { ColumnProps, HeaderCell, PaginationType, RowSelectionType, TableBodyComponents, TableComponents, TableProps, TableRowRendererProps, onChangeParams, } from './interface';
+export type { ColumnProps, FilterValue, HeaderCell, PaginationType, RowSelectionType, TableBodyComponents, TableComponents, TableProps, TableRowRendererProps, onChangeParams, } from './interface';
 type TableType = typeof InternalTable & {
     Column: typeof Column;
     Summary: typeof Summary;

package/dist/cjs/Table/interface.d.ts

@@ -62,11 +62,13 @@ export interface HeadCellProps extends Omit<WrapedColumnProps, 'title'> {
         [prop: string]: number;
     };
     showSorterTooltip?: boolean;
-    internalFilters?: {
-        [dataIndex: string]: boolean;
-    };
     onSort?: (dataIndex: string, sorter: any) => void;
-    onInternalFilter?: (dataIndex: string, value: string) => void;
+    onInternalFilter?: (options: {
+        dataIndex: string;
+        value: FilterValue | FilterValue[];
+        type?: 'filter' | 'search';
+        column: WrapedColumnProps;
+    }) => void;
     /**
      * `resizeKey` of the column currently being dragged, if any
      */
@@ -188,6 +190,14 @@ export interface ColumnProps {
          * Whether searchable, when items is undefined, it acts as a search component
          */
         searchable?: boolean;
+        /**
+         * Controlled filter state. When defined, this column's filter state is
+         * controlled: the dropdown echo, icon highlight and the `filters` in
+         * onChange all derive from it. With no `onFilter`, local matching is
+         * skipped entirely (server mode — filter in your onChange handler).
+         * Reset with `[]` / `''`.
+         */
+        filteredValue?: FilterValue | FilterValue[];
         /**
          * Filter icon
          */

package/dist/cjs/Table/table.js

@@ -248,6 +248,27 @@ var Table = import_react.default.forwardRef((baseprops, ref) => {
     },
     [onSortInternal, onChange, pagination, current, pageSize, filters]
   );
+  const handleFilter = import_react.default.useCallback(
+    (options) => {
+      const next = onFilterInternal(options);
+      const emitted = next.filterRecords.filter(
+        (record) => record.dataIndex !== options.dataIndex
+      );
+      emitted.push({ dataIndex: options.dataIndex, value: options.value });
+      onChange == null ? void 0 : onChange({
+        pagination: pagination === false ? void 0 : { current, pageSize },
+        sorter: sorters,
+        filters: Object.fromEntries(
+          emitted.map(({ dataIndex, value }) => [dataIndex, value])
+        ),
+        // Filtered but not yet re-sorted; symmetric with handleSort, whose
+        // payload is sorted but not re-paginated.
+        currentDataSource: next.data,
+        action: "filter"
+      });
+    },
+    [onFilterInternal, onChange, pagination, current, pageSize, sorters]
+  );
   const { expandedRowKeys, onExpand } = (0, import_useExpand.default)(
     expandable,
     allKeys,
@@ -259,7 +280,6 @@ var Table = import_react.default.forwardRef((baseprops, ref) => {
     onCheckAll,
     onChange: onSelectionChange
   } = (0, import_useSelection.default)({ pageData, dataSource, getRowKey, rowSelection, allKeys });
-  const prevFilterRecordsRef = (0, import_react.useRef)(filterRecords);
   const [horizontalScroll, setHorizontalScroll] = import_react.default.useState({
     left: false,
     right: false
@@ -309,29 +329,6 @@ var Table = import_react.default.forwardRef((baseprops, ref) => {
       return unchanged ? current2 : nextWidths;
     });
   }, [wrapedColumnsRef]);
-  (0, import_react.useEffect)(() => {
-    if (prevFilterRecordsRef.current === filterRecords)
-      return;
-    prevFilterRecordsRef.current = filterRecords;
-    if (!onChange)
-      return;
-    onChange({
-      pagination: pagination === false ? void 0 : { current, pageSize },
-      sorter: sorters,
-      filters,
-      currentDataSource: sortedData,
-      action: "filter"
-    });
-  }, [
-    filterRecords,
-    filters,
-    sortedData,
-    pagination,
-    current,
-    pageSize,
-    sorters,
-    onChange
-  ]);
   (0, import_react.useEffect)(() => {
     const content = contentRef.current;
     const tableElement = tableRef.current;
@@ -387,7 +384,7 @@ var Table = import_react.default.forwardRef((baseprops, ref) => {
         sorters,
         onSort: handleSort,
         onCheckAll,
-        onInternalFilter: onFilterInternal,
+        onInternalFilter: handleFilter,
         resizingKey,
         onResizeStart,
         onResizeStep

package/dist/cjs/Table/theader/cell.js

@@ -84,7 +84,6 @@ var HeadCell = (props) => {
     classNames,
     showSorterTooltip = true,
     tableActionBarShowOnHover,
-    internalFilters,
     style,
     width,
     colSpan,
@@ -112,7 +111,6 @@ var HeadCell = (props) => {
     "classNames",
     "showSorterTooltip",
     "tableActionBarShowOnHover",
-    "internalFilters",
     "style",
     "width",
     "colSpan",
@@ -190,7 +188,6 @@ var HeadCell = (props) => {
         __spreadProps(__spreadValues({}, rest), {
           filter,
           column: props,
-          internalFilters,
           onInternalFilter,
           dataIndex
         })

package/dist/cjs/Table/theader/filter.js

@@ -56,6 +56,7 @@ var areFilterValuesEqual = (a, b) => {
 };
 var hasFilterValue = (value) => Array.isArray(value) ? value.length > 0 : value !== "";
 var HeaderFilter = import_react.default.memo((props) => {
+  var _a;
   const { filter, column, getPopupContainer, onInternalFilter } = props;
   const { prefixCls } = (0, import_react.useContext)(import_table.TableCtx);
   const { locale } = (0, import_locale.useLocale)();
@@ -77,12 +78,28 @@ var HeaderFilter = import_react.default.memo((props) => {
   const [open, setOpen] = (0, import_react.useState)(false);
   const [selectNodes, setSelectNodes] = (0, import_react.useState)([]);
   const [searchValue, setSearchValue] = (0, import_react.useState)("");
+  const controlled = filter.filteredValue !== void 0;
+  (0, import_react.useEffect)(() => {
+    if (!controlled || open)
+      return;
+    const value = filter.filteredValue;
+    if (Array.isArray(value)) {
+      setSelectNodes([...value]);
+      setSearchValue("");
+    } else {
+      setSearchValue(String(value));
+      setSelectNodes([]);
+    }
+    const committed = Array.isArray(value) ? [...value] : value;
+    committedValueRef.current = committed;
+    setCommittedValue(committed);
+  }, [controlled, filter.filteredValue, open]);
   (0, import_react.useEffect)(() => {
     if (!open)
       return;
     const raf = requestAnimationFrame(() => {
-      var _a;
-      (_a = inputRef.current) == null ? void 0 : _a.focus({ preventScroll: true });
+      var _a2;
+      (_a2 = inputRef.current) == null ? void 0 : _a2.focus({ preventScroll: true });
     });
     return () => cancelAnimationFrame(raf);
   }, [open]);
@@ -139,8 +156,8 @@ var HeaderFilter = import_react.default.memo((props) => {
     const inputValue = getStrLower(searchValue);
     const filteredItems = inputValue ? items.filter(
       (item) => {
-        var _a;
-        return (_a = getStrLower(item.label)) == null ? void 0 : _a.includes(getStrLower(searchValue));
+        var _a2;
+        return (_a2 = getStrLower(item.label)) == null ? void 0 : _a2.includes(getStrLower(searchValue));
       }
     ) : items;
     if (filterMode === "menu") {
@@ -186,7 +203,7 @@ var HeaderFilter = import_react.default.memo((props) => {
     }
     setOpen(nextOpen);
   };
-  const isFiltered = filtered != null ? filtered : hasFilterValue(committedValue);
+  const isFiltered = filtered != null ? filtered : controlled ? hasFilterValue((_a = filter.filteredValue) != null ? _a : "") : hasFilterValue(committedValue);
   const renderTrigger = () => {
     const trigger = typeof icon === "function" ? icon(isFiltered) : /* @__PURE__ */ import_react.default.createElement(
       import_Button.default,

package/dist/cjs/style/themes.css

@@ -1,7 +1,7 @@
 /*!
  * @rainbow-oh/yee-c CSS Variables
  * Auto-generated, do not edit manually
- * Generated on 2026-09-14T02:29:50.905Z
+ * Generated on 2026-09-17T09:06:26.119Z
  */
 
 /* ========== color.blue.css ========== */