@nocobase/client-v2 2.1.0-beta.35 → 2.1.0-beta.37

package/es/flow/components/filter/useFilterOptions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { Collection } from '@nocobase/flow-engine';
+/**
+ * One operator entry on a `FilterOption`. Mirrors v1's interface-defined operator shape so the v2 filter value renderer can pick up the same per-operator value-side schema (e.g. datetime operators wanting the smart date picker, array/enum operators wanting a tag-mode Select).
+ */
+export type FilterOperator = {
+    value: string;
+    label: string;
+    /**
+     * Per-operator override for the value-side renderer. Wins over the field's own `uiSchema` when set. The `x-component` string is looked up against the v2 filter component registry.
+     */
+    schema?: {
+        'x-component'?: string;
+        'x-component-props'?: Record<string, any>;
+    } & Record<string, any>;
+    /** Operator takes no right-hand value (e.g. `$empty`, `$notEmpty`). */
+    noValue?: boolean;
+    [key: string]: any;
+};
+/** Single field-tree node returned by `useFilterOptions`. */
+export type FilterOption = {
+    name: string;
+    type?: string;
+    target?: string;
+    title: string;
+    schema?: Record<string, any>;
+    operators?: FilterOperator[];
+    children?: FilterOption[];
+};
+export interface UseFilterOptionsArgs {
+    /**
+     * Whitelist of root-level field names to expose. Empty/undefined means "all filterable fields". The whitelist applies only at depth 1 — nested fields under an allowed association field are always included, matching the legacy v1 `Filter.Action` behaviour.
+     */
+    filterableFieldNames?: string[];
+    /** Bypass the `filterableFieldNames` whitelist (mirrors v1 `noIgnore`). */
+    noIgnore?: boolean;
+    /** Translator used for field/operator labels. Defaults to identity. */
+    t?: (key: string) => string;
+}
+/**
+ * v2 equivalent of v1's `useFilterOptions`/`useFilterFieldOptions`. Walks a `Collection`'s fields and returns the nested option tree consumed by antd `Cascader` in `CollectionFilterItem` (and any other v2 filter surface that wants the same field picker).
+ *
+ * Mirrors v1 in two ways that matter:
+ * - association fields (belongsTo / hasMany / m2m / etc.) are kept and recursed into via `fieldsToOptions`'s `nested` branch — so picking `user.username` is a first-class action, just like the legacy cascader.
+ * - the whitelist applies at depth 1 only, so capping the root field list (e.g. to `['lockedTs', 'unlockTs', 'user']`) doesn't accidentally hide the nested `user.username` / `user.nickname` leaves.
+ */
+export declare function useFilterOptions(collection: Collection | undefined, args?: UseFilterOptionsArgs): FilterOption[];

package/es/flow/models/base/ActionModelCore.d.ts

@@ -20,10 +20,12 @@ export declare const ActionSceneEnum: {
 export declare class ActionModel<T extends DefaultStructure = DefaultStructure> extends FlowModel<T> {
     props: ButtonProps & {
         tooltip?: string;
+        iconOnly?: boolean;
     };
     scene: ActionSceneType;
     defaultProps: ButtonProps & {
         tooltip?: string;
+        iconOnly?: boolean;
     };
     enableEditTooltip: boolean;
     enableEditTitle: boolean;
@@ -31,6 +33,10 @@ export declare class ActionModel<T extends DefaultStructure = DefaultStructure>
     enableEditType: boolean;
     enableEditDanger: boolean;
     enableEditColor: boolean;
+    buttonTypeOptions: {
+        value: string;
+        label: string;
+    }[];
     static _getScene(): any[];
     static _isScene(scene: ActionSceneType): boolean;
     getAclActionName(): any;

package/es/flow/models/base/GridModel.d.ts

@@ -55,6 +55,7 @@ export declare class GridModel<T extends {
     private buildResizedCells;
     private getResizeRowPath;
     private getResizeContainerWidth;
+    private prunePlaceholderOnlyRows;
     private resizeGridLayout;
     onMount(): void;
     saveGridLayout(layout?: GridLayoutData | GridLayoutV2): void;
@@ -82,6 +83,7 @@ export declare class GridModel<T extends {
      * 运行态按可见 block 过滤行/列，避免“整行都是 hidden block”但依然保留行间距占位。
      * - 配置态（flowSettingsEnabled）保持原始 rows/sizes 以便拖拽和布局编辑。
      * - 运行态仅在判断为“整列/整行都不可见”时做过滤，不写回 props/stepParams，布局元数据保持不变。
+     * - 空列是拖拽缩窄后保存的布局占位，运行态需要保留其宽度，但 Grid 渲染层不会渲染其内容。
      */
     private getVisibleLayout;
     render(): React.JSX.Element;

package/es/flow/utils/dataScopeFormValueClear.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { FlowContext } from '@nocobase/flow-engine';
+/**
+ * When a field's dataScope filter references other form values (e.g. `{{ ctx.formValues.school.id }}`),
+ * clear current field value after the dependency changes, so users don't keep an invalid stale selection.
+ */
+export declare function ensureFormValueDrivenDataScopeClear(ctx: FlowContext, params: any): void;

package/es/flow-compat/passwordUtils.d.ts

@@ -6,4 +6,4 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
-export declare const getStrength: (val: any) => 60 | 0 | 20 | 100 | 40 | 80;
+export declare const getStrength: (val: any) => 60 | 0 | 100 | 80 | 40 | 20;

package/es/hooks/index.d.ts

@@ -7,5 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 export * from './useApp';
+export * from './useCurrentAppInfo';
 export * from './usePlugin';
 export * from './useRouter';
+export { escapeHTML, getAppVersionHTML } from '../utils/appVersionHTML';

package/es/hooks/useCurrentAppInfo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export declare function useCurrentAppInfo<TAppInfo extends Record<string, any> = Record<string, any>>(): TAppInfo;

package/es/index.d.ts

@@ -30,6 +30,7 @@ export * from './nocobase-buildin-plugin';
 export * from './collection-field-interface/CollectionFieldInterface';
 export * from './collection-field-interface/CollectionFieldInterfaceManager';
 export * from './collection-manager/interfaces';
+export * from './data-source';
 export * from './flow';
 export { DEFAULT_DATA_SOURCE_KEY, isTitleField, isTitleFieldInterface } from './flow-compat';
 export { default as AntdAppProvider } from './theme/AntdAppProvider';