feat: support function type for extraCssVarPrefixCls to dynamically resolve prefixes

Allow extraCssVarPrefixCls to accept a function that receives { prefixCls, rootCls }
and returns a string array. This enables dynamic generation of CSS variable scope
names based on runtime values.

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

Author: zombieJ

src/util/genStyleUtils.ts

@@ -166,15 +166,22 @@ function genStyleUtils<
       /**
        * Extra prefixCls to inject CSS variables.
        * 为额外的 prefixCls 注入 CSS 变量（不注入样式）。
+       * 支持传入 function 类型，动态生成 prefixCls 数组。
        *
        * @example
        * ```typescript
        * {
        *   extraCssVarPrefixCls: ['my-comp-compact', 'my-comp-large']
        * }
+       * // 或者
+       * {
+       *   extraCssVarPrefixCls: ({ prefixCls, rootCls }) => [`${prefixCls}-container`]
+       * }
        * ```
        */
-      extraCssVarPrefixCls?: string[];
+      extraCssVarPrefixCls?:
+        | string[]
+        | ((info: { prefixCls: string; rootCls: string }) => string[]);
     },
   ) {
     const componentName = Array.isArray(component) ? component[0] : component;
@@ -212,8 +219,16 @@ function genStyleUtils<
 
     return (prefixCls: string, rootCls: string = prefixCls) => {
       const hashId = useStyle(prefixCls, rootCls);
+
+      // 支持 function 类型，动态解析 extraCssVarPrefixCls
+      const extraPrefixCls = options?.extraCssVarPrefixCls;
+      const resolvedExtraPrefixCls =
+        typeof extraPrefixCls === 'function'
+          ? extraPrefixCls({ prefixCls, rootCls })
+          : extraPrefixCls;
+
       const cssVarCls = useCSSVar(
-        options?.extraCssVarPrefixCls?.length ? [rootCls, ...options.extraCssVarPrefixCls] : rootCls,
+        resolvedExtraPrefixCls?.length ? [rootCls, ...resolvedExtraPrefixCls] : rootCls,
       );
 
       return [hashId, cssVarCls] as const;

tests/extraCssVarPrefixCls.test.tsx

@@ -93,4 +93,45 @@ describe('extraCssVarPrefixCls', () => {
     expect(totalStyle).toContain('.custom-a');
     expect(totalStyle).toContain('.custom-b');
   });
+
+  it('should support function type for extraCssVarPrefixCls', () => {
+    const hooks = genStyleHooks(
+      'TestComponent',
+      (token) => ({
+        [`${token.componentCls}`]: {
+          color: token.colorPrimary,
+          fontSize: token.fontSize,
+        },
+      }),
+      () => ({
+        colorPrimary: '#ff0000',
+        fontSize: 16,
+      }),
+      {
+        extraCssVarPrefixCls: ({ prefixCls, rootCls }) => [
+          `${prefixCls}-container`,
+          `${rootCls}-wrapper`,
+        ],
+      },
+    );
+
+    const TestComponent = () => {
+      const [hashId, cssVarCls] = hooks('custom-list', 'custom');
+      const className = [hashId, cssVarCls].filter(Boolean).join(' ');
+      return <div className={className}>{hashId}</div>;
+    };
+
+    render(
+      <StyleProvider cache={createCache()}>
+        <TestComponent />
+      </StyleProvider>,
+    );
+
+    const totalStyle = Array.from(document.querySelectorAll('style'))
+      .map((el) => el.textContent)
+      .join('\n');
+
+    expect(totalStyle).toContain('.custom-list-container');
+    expect(totalStyle).toContain('.custom-wrapper');
+  });
 });