@nocobase/client-v2 2.4.0-alpha.1 → 2.4.0-alpha.11

package/es/RouteRepository.d.ts

@@ -72,6 +72,12 @@ export declare class RouteRepository {
      * @returns 当前可访问的路由数组
      */
     ensureAccessibleLoaded(): Promise<any>;
+    /**
+     * 清空所有布局的路由缓存，并丢弃清空前发起的请求结果。
+     *
+     * 用于登录态失效（如退出登录）时，避免下一个用户沿用上一个用户的可访问路由。
+     */
+    clear(): void;
     /**
      * 订阅路由缓存变化，用于驱动 React 上下文刷新。
      *

package/es/components/form/ScanInput/useCodeScanner.d.ts

@@ -6,6 +6,7 @@
  * 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 { RefObject } from 'react';
 import type { CodeFormatsToSupport } from './types';
 type ScannerSize = {
     width: number;
@@ -16,17 +17,26 @@ type UseCodeScannerOptions = {
     elementId: string;
     formatsToSupport?: CodeFormatsToSupport;
     onScannerSizeChanged?: (size: ScannerSize) => void;
+    scanViewportRef?: RefObject<HTMLElement | null>;
     onScanSuccess: (text: string) => void;
     onScanFailure?: () => void;
     onCameraStartFailure?: (error: unknown) => void;
 };
+type QrFrameCaptureLimits = {
+    maxHeight: number;
+    maxPixels: number;
+    maxWidth: number;
+};
 export declare const DEFAULT_CODE_FORMATS: CodeFormatsToSupport;
 export declare function getCodeScanBoxSize(width: number, height: number): {
     width: number;
     height: number;
 };
-export declare function scanQrVideoFrame(video: HTMLVideoElement, canvas: HTMLCanvasElement): string;
-export declare function useCodeScanner({ enabled, elementId, formatsToSupport, onScannerSizeChanged, onScanSuccess, onScanFailure, onCameraStartFailure, }: UseCodeScannerOptions): {
+export declare function isIOSBrowser(): boolean;
+export declare function getQrVideoFrameImageData(video: HTMLVideoElement, canvas: HTMLCanvasElement, scanViewport?: Element, limits?: QrFrameCaptureLimits): ImageData;
+export declare function scanQrVideoFrame(video: HTMLVideoElement, canvas: HTMLCanvasElement, scanViewport?: Element): string;
+export declare function scanQrVideoFrameWithZxingWasm(video: HTMLVideoElement, canvas: HTMLCanvasElement, scanViewport: Element): Promise<string>;
+export declare function useCodeScanner({ enabled, elementId, formatsToSupport, onScannerSizeChanged, scanViewportRef, onScanSuccess, onScanFailure, onCameraStartFailure, }: UseCodeScannerOptions): {
     startScanFile: (file: File) => Promise<void>;
 };
 export {};

package/es/components/form/ScanInput/zxingWasmDecoder.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 decodeQrCodeWithZxingWasm(imageData: ImageData): Promise<string>;

package/es/flow/components/FieldAssignValueInput.d.ts

@@ -34,6 +34,8 @@ interface Props {
     enableDateVariableAsConstant?: boolean;
     /** 是否允许在变量选择器中使用 RunJS。默认 true，保持历史行为。 */
     allowRunJS?: boolean;
+    /** 是否允许在变量选择器中使用内置日期变量。默认 true。 */
+    allowDateVariables?: boolean;
     maxAssociationFieldDepth?: number;
     disabled?: boolean;
     variableConverters?: VariableInputProps['converters'];

package/es/flow/components/field-value-variable/FieldValueVariableInput.d.ts

@@ -25,6 +25,7 @@ export type FieldValueVariableInputProps = Omit<VariableInputProps, 'value' | 'o
     isDateLikeField: boolean;
     dateComponentProps: DateVariableComponentProps;
     allowRunJS?: boolean;
+    allowDateVariables?: boolean;
     converters?: VariableInputProps['converters'];
 };
 export declare const FieldValueVariableInput: React.FC<FieldValueVariableInputProps>;

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

@@ -27,7 +27,9 @@ export interface VariableFilterItemProps {
     rightAsVariable?: boolean;
     /**
      * 右侧 VariableInput 的 metaTree 提供器；
-     * 默认使用整棵 ctx 的 metaTree：model.context.getPropertyMetaTree()
+     * 默认使用视图上下文的 metaTree：useFlowViewContext().getPropertyMetaTree()。
+     * 注意它取自视图上下文而非 `model.context`：当调用方传入的 model 与打开设置弹窗的模型不是同一个时，
+     * 右侧变量不会跟随 model 变化，需要显式传入本属性。
      */
     rightMetaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
     /**
@@ -36,6 +38,13 @@ export interface VariableFilterItemProps {
     rightVariableConverters?: Pick<Converters, 'resolvePathFromValue' | 'resolveValueFromPath'>;
     ignoreFieldNames?: string[];
     maxAssociationFieldDepth?: number;
+    /**
+     * 右侧变量树的关联层级上限，默认与 `maxAssociationFieldDepth` 一致。
+     * 传 `null` 表示不限制：右侧是变量树而非集合字段树，其深度可能已由调用方约束
+     * （例如工作流的变量树由触发器的「预加载关系数据」决定），此时再按左侧的层级上限裁剪
+     * 会让已配置好的深层变量选不到。
+     */
+    rightMaxAssociationFieldDepth?: number | null;
 }
 /**
  * 上下文筛选项组件

package/es/flow/internal/utils/quickEditDataScope.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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 { FlowEngineContext, ModelConstructor } from '@nocobase/flow-engine';
+import { CollectionField, FlowModel } from '@nocobase/flow-engine';
+import React from 'react';
+export declare const QUICK_EDIT_DATA_SCOPE_FLOW_KEY = "tableColumnSettings";
+export declare const QUICK_EDIT_DATA_SCOPE_STEP_KEY = "quickEditDataScope";
+export type DataScopeStepLocation = {
+    flowKey: string;
+    stepKey: string;
+};
+type DataScopeFilter = {
+    logic?: string;
+    items?: unknown[];
+} | undefined;
+/**
+ * Locate the flow and step that carry the shared `dataScope` action on a field model class. Both association editors
+ * currently keep it under `selectSettings`, but the lookup resolves it from the class instead of hard-coding that name,
+ * so an editor registered later is picked up without touching the quick edit path. Returns the first match.
+ */
+export declare function findDataScopeStep(ModelClass: ModelConstructor | typeof FlowModel | undefined | null): DataScopeStepLocation | null;
+/**
+ * Resolve the data scope step of the editor model that the quick edit popover builds for `collectionField`. Returns null
+ * when the field is not an association or when its default editor has no data scope step, which is what the column
+ * setting uses to decide whether to offer the item at all.
+ */
+export declare function resolveQuickEditDataScopeStep(ctx: FlowEngineContext, collectionField: CollectionField): DataScopeStepLocation | null;
+export declare function isEmptyDataScopeFilter(filter: DataScopeFilter): boolean;
+/** Read the quick edit data scope filter stored on the table column that owns `sourceFieldModel`. */
+export declare function getQuickEditDataScopeFilter(sourceFieldModel?: FlowModel): DataScopeFilter;
+/**
+ * Context the filter builder is configured against. The setting lives on the table column, but the filter describes
+ * records of the association target, so `collection` points at the target collection to drive the left-hand field list.
+ * `record` is declared with meta only so that "Current record" is offered as a right-hand variable and describes the row
+ * being edited rather than whatever record an enclosing popup happens to supply; it has no value while configuring and
+ * resolves per row once the popover opens.
+ */
+export declare function createQuickEditDataScopeContext(columnModel: FlowModel): Promise<import("@nocobase/flow-engine").FlowModelContext>;
+export declare function QuickEditDataScopeInput(props: {
+    value?: Record<string, any>;
+}): React.JSX.Element;
+export {};

package/es/flow/internal/utils/quickEditViewContainer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+type QuickEditViewContainerLike = {
+    update?: (newConfig: {
+        preventClose?: boolean;
+    }) => unknown;
+};
+type QuickEditFieldModelLike = {
+    parent?: {
+        use?: string;
+        viewContainer?: QuickEditViewContainerLike;
+    } | null;
+};
+export declare function getQuickEditViewContainer(model: QuickEditFieldModelLike | undefined): QuickEditViewContainerLike;
+/**
+ * Keeps the quick edit popover open while a nested dropdown (Select / Cascader) is open. The outside click that
+ * closes the dropdown would otherwise also close the popover and drop the unsaved edit. Releasing is deferred so the
+ * closing click itself never reaches the popover as a close request.
+ */
+export declare function syncQuickEditPreventClose(model: QuickEditFieldModelLike | undefined, dropdownOpen: boolean): void;
+export {};

package/es/flow/models/blocks/form/QuickEditFormModel.d.ts

@@ -37,6 +37,7 @@ export declare class QuickEditFormModel extends FlowModel {
     __onSubmitSuccess: any;
     _fieldProps: any;
     _onOk: any;
+    _dataScopeFilter: Record<string, any> | undefined;
     get form(): any;
     useHooksBeforeRender(): void;
     static open(options: {