@nocobase/client 2.1.0-alpha.1 → 2.1.0-alpha.10

package/es/pm/AdminSettingsLayoutModel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 { FlowModel } from '@nocobase/flow-engine';
+import React from 'react';
+export declare class AdminSettingsLayoutModel extends FlowModel {
+    render(): React.JSX.Element;
+}

package/es/pm/PluginSetting.d.ts

@@ -8,4 +8,5 @@
  */
 import React from 'react';
 export declare const SettingsCenterContext: React.Context<any>;
-export declare const AdminSettingsLayout: () => React.JSX.Element;
+export declare const InternalAdminSettingsLayout: () => React.JSX.Element;
+export declare const AdminSettingsLayout: (props: any) => React.JSX.Element;

package/es/pm/index.d.ts

@@ -7,6 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Plugin } from '../application/Plugin';
+export * from './AdminSettingsLayoutModel';
 export * from './PluginManager';
 export * from './PluginManagerLink';
 export * from './PluginSetting';

package/es/route-switch/antd/admin-layout/AdminLayoutModel.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.
+ */
+import { FlowModel } from '@nocobase/flow-engine';
+import React from 'react';
+import { type RoutePageMeta } from './AdminLayoutRouteCoordinator';
+export declare class AdminLayoutModel extends FlowModel {
+    private routeCoordinator?;
+    private routeDisposer?;
+    private activePageUid;
+    private layoutContentElement;
+    private routePageMetaMap;
+    private getCoordinator;
+    private getCurrentRouteByActivePage;
+    registerRoutePage(pageUid: string, meta: RoutePageMeta): FlowModel<import("@nocobase/flow-engine").DefaultStructure>;
+    updateRoutePage(pageUid: string, meta: Partial<RoutePageMeta>): void;
+    unregisterRoutePage(pageUid: string): void;
+    setLayoutContentElement(element: HTMLElement | null): void;
+    protected onMount(): void;
+    protected onUnmount(): void;
+    render(): React.JSX.Element;
+}

package/es/route-switch/antd/admin-layout/AdminLayoutRouteCoordinator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 { FlowEngine, FlowModel, type ViewParam } from '@nocobase/flow-engine';
+export interface RoutePageMeta {
+    active: boolean;
+    currentRoute?: Record<string, any>;
+    refreshDesktopRoutes?: () => void;
+    layoutContentElement?: HTMLElement | null;
+}
+interface RouteLike {
+    params?: {
+        name?: string;
+    };
+    pathname?: string;
+}
+/**
+ * 管理 admin 场景下每个 page 的 v2 视图栈编排。
+ * 该协调器只负责状态机和开关视图，不直接绑定 React 生命周期。
+ */
+export declare class AdminLayoutRouteCoordinator {
+    private readonly flowEngine;
+    private readonly runtimes;
+    private layoutContentElement;
+    constructor(flowEngine: FlowEngine);
+    setLayoutContentElement(element: HTMLElement | null): void;
+    registerPage(pageUid: string, meta: RoutePageMeta): FlowModel<import("@nocobase/flow-engine").DefaultStructure>;
+    syncPageMeta(pageUid: string, meta: Partial<RoutePageMeta>): void;
+    unregisterPage(pageUid: string): void;
+    syncRoute(routeLike: RouteLike): void;
+    cleanupPage(pageUid: string): void;
+    destroy(): void;
+    private syncRuntimeWithPathname;
+    private shouldStepNavigate;
+    private stepNavigate;
+    private handleOpenViews;
+    private openViews;
+    private ensureRouteModelContext;
+    private getOrCreateRouteModel;
+}
+/**
+ * 将 pathname 解析结果和 pageUid 对齐，便于测试里复用。
+ */
+export declare function toViewStack(pathname: string): ViewParam[];
+export {};

package/es/route-switch/antd/admin-layout/index.d.ts

@@ -27,7 +27,7 @@ export declare const useMobileLayout: () => {
     isMobileLayout: boolean;
     setIsMobileLayout: React.Dispatch<React.SetStateAction<boolean>>;
 };
-export declare const InternalAdminLayout: () => React.JSX.Element;
+export declare const InternalAdminLayout: (props: any) => React.JSX.Element;
 export declare const AdminProvider: (props: any) => React.JSX.Element;
 export declare const AdminLayout: (props: any) => React.JSX.Element;
 export declare class AdminLayoutPlugin extends Plugin {
@@ -35,4 +35,8 @@ export declare class AdminLayoutPlugin extends Plugin {
     load(): Promise<void>;
 }
 export declare function findRouteBySchemaUid(schemaUid: string, treeArray: any[]): any;
+export declare const shouldRenderIconInTitle: ({ depth, isMobile }: {
+    depth: number;
+    isMobile: boolean;
+}) => boolean;
 export declare function findFirstPageRoute(routes: NocoBaseDesktopRoute[]): any;

package/es/route-switch/antd/admin-layout/mobileMenuNavigation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 const MOBILE_MENU_CLOSE_DELAY_MS = 220;
+export declare const runAfterMobileMenuClosed: ({ isMobile, closeMobileMenu, callback, delayMs, }: {
+    isMobile: boolean;
+    closeMobileMenu: () => void;
+    callback: () => void;
+    delayMs?: number;
+}) => void;

package/es/schema-component/antd/association-field/Table.d.ts

@@ -6,61 +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 useColumnsDeepMemoized: (columns: any[]) => Pick<import("@formily/react").Stringify<{
-    [key: symbol]: any;
-    [key: `x-${string}`]: any;
-    [key: `x-${number}`]: any;
-    version?: string;
-    name?: import("@formily/react").SchemaKey;
-    title?: any;
-    description?: any;
-    default?: any;
-    readOnly?: boolean;
-    writeOnly?: boolean;
-    type?: import("@formily/react").SchemaTypes;
-    enum?: import("@formily/react").SchemaEnum<any>;
-    const?: any;
-    multipleOf?: number;
-    maximum?: number;
-    exclusiveMaximum?: number;
-    minimum?: number;
-    exclusiveMinimum?: number;
-    maxLength?: number;
-    minLength?: number;
-    pattern?: string | RegExp;
-    maxItems?: number;
-    minItems?: number;
-    uniqueItems?: boolean;
-    maxProperties?: number;
-    minProperties?: number;
-    required?: string | boolean | string[];
-    format?: string;
-    $ref?: string;
-    $namespace?: string;
-    definitions?: import("@formily/react").SchemaProperties<any, any, any, any, any, any, any, any>;
-    properties?: import("@formily/react").SchemaProperties<any, any, any, any, any, any, any, any>;
-    items?: import("@formily/react").SchemaItems<any, any, any, any, any, any, any, any>;
-    additionalItems?: import("@formily/react").Stringify<any>;
-    patternProperties?: import("@formily/react").SchemaProperties<any, any, any, any, any, any, any, any>;
-    additionalProperties?: import("@formily/react").Stringify<any>;
-    "x-value"?: any;
-    "x-index"?: number;
-    "x-pattern"?: any;
-    "x-display"?: any;
-    "x-validator"?: any;
-    "x-decorator"?: any;
-    "x-decorator-props"?: any;
-    "x-component"?: any;
-    "x-component-props"?: any;
-    "x-reactions"?: import("@formily/react").SchemaReactions<any>;
-    "x-content"?: any;
-    "x-data"?: any;
-    "x-visible"?: boolean;
-    "x-hidden"?: boolean;
-    "x-disabled"?: boolean;
-    "x-editable"?: boolean;
-    "x-read-only"?: boolean;
-    "x-read-pretty"?: boolean;
-    "x-compile-omitted"?: string[];
-}>, symbol | "name" | "title" | "pattern" | "default" | "maximum" | "type" | "maxLength" | "minLength" | "readOnly" | "required" | "description" | `x-${string}` | `x-${number}` | "version" | "writeOnly" | "enum" | "const" | "multipleOf" | "exclusiveMaximum" | "minimum" | "exclusiveMinimum" | "maxItems" | "minItems" | "uniqueItems" | "maxProperties" | "minProperties" | "format" | "$ref" | "$namespace" | "definitions" | "items" | "additionalItems" | "patternProperties" | "additionalProperties">[];
 export declare const Table: any;

package/es/schema-component/antd/date-picker/DatePicker.d.ts

@@ -10,6 +10,32 @@ import React from 'react';
 interface IDatePickerProps {
     utc?: boolean;
 }
+/**
+ * 解析筛选日期组件的展示格式。
+ *
+ * 这里优先使用 schema 上显式配置的 dateFormat / format，
+ * 只有在当前 picker 没有自定义格式时才回退到默认 picker 格式。
+ *
+ * @param options 当前筛选日期组件的格式参数
+ * @returns 适用于当前 picker 的最终展示格式
+ * @example
+ * ```typescript
+ * resolveFilterPickerFormat({
+ *   targetPicker: 'date',
+ *   picker: 'date',
+ *   dateFormat: 'MM/DD/YY',
+ *   showTime: false,
+ * });
+ * ```
+ */
+export declare const resolveFilterPickerFormat: (options: {
+    targetPicker: string;
+    picker?: string;
+    format?: string;
+    dateFormat?: string;
+    showTime?: boolean;
+    timeFormat?: string;
+}) => any;
 export declare const useDatePickerContext: () => IDatePickerProps;
 export declare const DatePickerProvider: React.Provider<IDatePickerProps>;
 export declare const DatePicker: {

package/es/schema-component/antd/form-item/hooks/useLazyLoadDisplayAssociationFieldsOfForm.d.ts

@@ -14,3 +14,29 @@
  */
 declare const useLazyLoadDisplayAssociationFieldsOfForm: () => void;
 export default useLazyLoadDisplayAssociationFieldsOfForm;
+/**
+ * Remove circular references from an object while preserving shared references.
+ *
+ * This function distinguishes between:
+ * - Circular references: Objects that reference themselves in the recursion path (removed)
+ * - Shared references: Objects that appear multiple times but aren't circular (preserved)
+ *
+ * @param value - The value to process
+ * @param seen - WeakMap cache of processed objects
+ * @param path - WeakSet tracking current recursion path
+ * @returns The processed value with circular references removed
+ *
+ * @example
+ * // Shared reference (preserved)
+ * const shared = { name: "shared" };
+ * removeCircularReferences({ a: shared, b: shared });
+ * // Returns: { a: { name: "shared" }, b: { name: "shared" } }
+ *
+ * @example
+ * // Circular reference (removed)
+ * const circular = { name: "circular" };
+ * circular.self = circular;
+ * removeCircularReferences(circular);
+ * // Returns: { name: "circular" }
+ */
+export declare function removeCircularReferences(value: any, seen?: WeakMap<object, any>, path?: WeakSet<object>): any;

package/es/schema-settings/SchemaSettingsDefaultValue.d.ts

@@ -8,6 +8,24 @@
  */
 import { Schema } from '@formily/react';
 import React from 'react';
+/**
+ * 将 CollectionField 的 uiSchema 映射到默认值弹窗里真正渲染的字段 schema。
+ *
+ * 默认值弹窗不会直接渲染 CollectionField，而是会把它替换成实际的表单组件。
+ * 这里必须把选项字段依赖的 `enum` 也带过去，否则下拉 / 单选 / 多选在弹窗里会没有可选项。
+ *
+ * @param clonedSchema 当前字段 schema 的克隆副本
+ * @param collectionFieldUiSchema 数据表字段上的 uiSchema
+ * @example
+ * ```typescript
+ * const schema = { 'x-component': 'CollectionField' };
+ * applyCollectionFieldUiSchemaToDefaultValueSchema(schema, {
+ *   'x-component': 'Select',
+ *   enum: [{ label: 'Option 1', value: 'option1' }],
+ * });
+ * ```
+ */
+export declare const applyCollectionFieldUiSchemaToDefaultValueSchema: (clonedSchema: Record<string, any>, collectionFieldUiSchema: Record<string, any>) => void;
 export declare const SchemaSettingsDefaultValue: (props: {
     fieldSchema?: Schema;
     hideVariableButton?: boolean;

package/es/schema-settings/VariableInput/hooks/useParentIterationVariable.d.ts

@@ -13,8 +13,8 @@ export declare const useParentObjectContext: () => {
     shouldDisplayParentObject: boolean;
     /** 变量的值 */
     parentObjectCtx: any;
-    collectionName: string;
-    dataSource: string;
+    collectionName: any;
+    dataSource: any;
 };
 /**
  * 变量：`上级对象`
@@ -34,5 +34,5 @@ export declare const useParentObjectVariable: ({ collectionField, schema, noDisa
     shouldDisplayParentObject: boolean;
     /** 变量的值 */
     parentObjectCtx: any;
-    collectionName: string;
+    collectionName: any;
 };

package/es/user/CurrentUserProvider.d.ts

@@ -8,7 +8,7 @@
  */
 import React from 'react';
 export declare const CurrentUserContext: React.Context<import("../api-client").UseRequestResult<any>>;
-export declare const useCurrentUserContext: () => import("../api-client").UseRequestResult<any>;
+export declare const useCurrentUserContext: () => any;
 export declare const useIsLoggedIn: () => boolean;
 export declare const useCurrentRoles: () => any;
 export declare const CurrentUserProvider: (props: any) => React.JSX.Element;

package/es/variables/index.d.ts

@@ -16,4 +16,4 @@ export * from './utils/isVariable';
 export * from './utils/transformVariableValue';
 export * from './constants';
 export type { VariablesContextType } from './types';
-export { useVariableScopeInfo } from './VariableScope';
+export { VariableScope, useVariableScopeInfo } from './VariableScope';