next-flow-interface 0.25.14 → 0.26.7

package/index.d.ts

@@ -9,20 +9,16 @@ import { Attributes } from "react";
 import { Awareness } from "rhine-var";
 import { BaseTexture } from "@babylonjs/core";
 import { ClipboardEventHandler } from "react";
-import { Color } from "antd/es/color-picker";
 import { Color3 } from "@babylonjs/core";
 import { Color3 as Color3_2 } from "@babylonjs/core/Maths/math.color";
 import { Color4 } from "@babylonjs/core";
-import { ColorPickerProps } from "antd/es/color-picker";
 import { CompositionEventHandler } from "react";
 import { CSSProperties } from "react";
 import { CubeTexture } from "@babylonjs/core";
-import { DefaultOptionType } from "antd/es/select";
 import { DetailedHTMLProps } from "react";
 import { DragEvent as DragEvent_2 } from "react";
 import { DragEventHandler } from "react";
 import { DynamicTexture } from "@babylonjs/core";
-import { EmptyProps } from "antd";
 import { Engine } from "@babylonjs/core";
 import { EventType } from "rhine-var";
 import { FocusEventHandler } from "react";
@@ -35,7 +31,6 @@ import { HTMLAttributeReferrerPolicy } from "react";
 import { HTMLAttributes } from "react";
 import { InputBlock } from "@babylonjs/core";
 import { InputEventHandler } from "react";
-import { InputNumberProps } from "antd";
 import { IParticleSystem } from "@babylonjs/core";
 import { JSX } from "react/jsx-runtime";
 import { Key } from "react";
@@ -77,13 +72,11 @@ import { Root } from "react-dom/client";
 import { RvKey } from "rhine-var";
 import { RvPath } from "rhine-var";
 import { Scene } from "@babylonjs/core";
-import { SelectProps } from "antd";
 import { ShadowGenerator } from "@babylonjs/core";
 import { SixDofDragBehavior } from "@babylonjs/core/Behaviors/Meshes/sixDofDragBehavior";
 import { Skeleton } from "@babylonjs/core";
 import { StandardMaterial } from "@babylonjs/core";
 import { StoredRhineVar } from "rhine-var";
-import { SwitchProps } from "antd";
 import { Texture } from "@babylonjs/core";
 import { TextureBlock } from "@babylonjs/core";
 import { ToggleEventHandler } from "react";
@@ -233,115 +226,6 @@ export declare class AnimationNativeAttribute extends NodeAttribute<RvNative> {
   generate(sid: string, nid: string): RvNative;
 }
 
-/**
- * @public
- */
-export declare function AntCheckbox(props: AntCheckboxProps): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntCheckboxProps extends SwitchProps {
-  value: boolean;
-  onChange: (value: boolean) => void;
-  className?: string | undefined;
-  label?: string;
-}
-
-/**
- * @public
- */
-export declare function AntColor(props: AntColorProps): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntColorProps extends ColorPickerProps {
-  value: Color | string | null;
-  onColorChange: (value: string) => void;
-  className?: string;
-  classNameInner?: string;
-  theme?: string;
-}
-
-/**
- * @public
- */
-export declare function AntEmpty(props: AntEmptyProps): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntEmptyProps extends EmptyProps {
-  className?: string;
-  classNameInner?: string;
-  image?: ReactNode;
-  description?: ReactNode;
-  children?: ReactNode;
-}
-
-/**
- * @public
- */
-export declare function AntNumber(props: AntNumberProps): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntNumberProps extends Omit<
-  InputNumberProps,
-  "onChange"
-> {
-  value: number | null;
-  onChange: (value: number | null) => void;
-  placeholder?: string;
-  className?: string;
-  classNameInner?: string;
-  theme?: string;
-}
-
-/**
- * @public
- */
-export declare function AntSelect<ValueType>(
-  props: AntSelectProps<ValueType>,
-): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntSelectProps<
-  ValueType,
-> extends SelectProps<ValueType> {
-  value?: ValueType;
-  onChange?: (
-    value: ValueType,
-    option?: DefaultOptionType | DefaultOptionType[],
-  ) => void;
-  showSearch?: boolean;
-  onClick?: MouseEventHandler<HTMLDivElement>;
-  className?: string;
-  classNameInner?: string;
-  placeholder?: string;
-  optionFilterProp?: string;
-  size?: "small" | "middle" | "large" | undefined;
-  options?: DefaultOptionType[];
-}
-
-/**
- * @public
- */
-export declare function AntSwitch(props: AntSwitchProps): JSX.Element;
-
-/**
- * @public
- */
-export declare interface AntSwitchProps extends SwitchProps {
-  value: boolean;
-  onChange: (value: boolean) => void;
-  className?: string | undefined;
-}
-
 declare function approximatelyEqual(
   n1: number,
   n2: number,
@@ -943,6 +827,31 @@ declare function checkRvPathStartWith(
 
 declare function chunkHash(file: File): Promise<string>;
 
+/**
+ * 剪贴板工具集
+ *
+ * 提供剪贴板读写操作，支持普通文本和节点列表的复制粘贴
+ *
+ * @remarks
+ * 节点列表使用特定格式 `<nodes nid-a nid-b...>` 存储在剪贴板中，
+ * 便于在应用内识别和解析节点数据
+ *
+ * @example
+ * ```typescript
+ * // 复制节点
+ * await ClipboardUtils.copyNodes(['node-1', 'node-2'])
+ *
+ * // 粘贴节点
+ * const nodes = await ClipboardUtils.getNodes()
+ * ```
+ */
+export declare const ClipboardUtils: {
+  copy: typeof copy;
+  copyNodes: typeof copyNodes;
+  getText: typeof getText;
+  getNodes: typeof getNodes;
+};
+
 declare function computeSHA256(buffer: BufferSource): Promise<string>;
 
 /**
@@ -1145,10 +1054,50 @@ declare function convertBytesToHigherUnit(bn: number): string;
 
 declare function convertTimeText(seconds: number): string;
 
+/**
+ * 复制文本到剪贴板
+ *
+ * @param text - 要复制的文本内容
+ * @returns 复制完成的 Promise
+ * @throws 当剪贴板 API 不可用或权限被拒绝时抛出异常
+ *
+ * @example
+ * ```typescript
+ * await ClipboardUtils.copy('Hello World')
+ * ```
+ */
+declare function copy(text: string): Promise<void>;
+
 declare function copyCurrentUrlToClipboard(): Promise<boolean>;
 
+/**
+ * 复制节点列表到剪贴板
+ *
+ * 将节点 ID 列表格式化为 `<nodes nid-a nid-b...>` 格式并复制到剪贴板
+ *
+ * @param nidList - 节点 ID 列表
+ * @returns 复制完成的 Promise
+ * @throws 当剪贴板 API 不可用或权限被拒绝时抛出异常
+ *
+ * @example
+ * ```typescript
+ * await ClipboardUtils.copyNodes(['node-1', 'node-2', 'node-3'])
+ * // 剪贴板内容: <nodes node-1 node-2 node-3>
+ * ```
+ */
+declare function copyNodes(nidList: string[]): Promise<void>;
+
 declare function copyText(text: string): Promise<boolean>;
 
+/**
+ * @public
+ */
+export declare class Counter {
+  value: number;
+  constructor(defaultValue?: number);
+  add(): number;
+}
+
 /**
  * 创建属性右键菜单
  *
@@ -2226,6 +2175,27 @@ export declare function getNearestAngleVector3(
 
 declare function getNearestNumberIndex(x: number, list: number[]): number;
 
+/**
+ * 获取剪贴板中的节点列表
+ *
+ * 解析剪贴板中 `<nodes nid-a nid-b...>` 格式的文本，提取节点 ID 列表
+ *
+ * @returns 节点 ID 列表，格式不符合时返回空数组
+ * @throws 当剪贴板 API 不可用或权限被拒绝时抛出异常
+ *
+ * @example
+ * ```typescript
+ * // 假设剪贴板内容为: <nodes node-1 node-2 node-3>
+ * const nodes = await ClipboardUtils.getNodes()
+ * console.log(nodes) // ['node-1', 'node-2', 'node-3']
+ *
+ * // 假设剪贴板内容为普通文本
+ * const nodes = await ClipboardUtils.getNodes()
+ * console.log(nodes) // []
+ * ```
+ */
+declare function getNodes(): Promise<string[]>;
+
 declare function getPageTypeBySpaceText(space: string): PageType;
 
 declare function getParam(name: string): string;
@@ -2237,6 +2207,20 @@ export declare function getPointDistance(p1: Vector3, p2: Vector3): number;
 
 declare function getSearchParams(key: string): string | undefined;
 
+/**
+ * 获取剪贴板中的文本
+ *
+ * @returns 剪贴板中的文本内容
+ * @throws 当剪贴板 API 不可用或权限被拒绝时抛出异常
+ *
+ * @example
+ * ```typescript
+ * const text = await ClipboardUtils.getText()
+ * console.log(text)
+ * ```
+ */
+declare function getText(): Promise<string>;
+
 /**
  * @public
  */
@@ -4342,7 +4326,7 @@ declare function roundToX(num: number, x: number): number;
 export declare class RsAnimationManager {
   constructor();
   static initialize(): Promise<void>;
-  static analysisAnimationDuration(
+  static analyzeAnimationDuration(
     step: StoredRhineVar<RvStep>,
     lastStep?: RvStep,
   ): number;
@@ -4941,6 +4925,7 @@ export declare class RsNodeMaterialManager {
  * - mid: model id，模型ID
  * - level: 节点在树中的层级（从0开始）
  * - index: 节点在当前生成过程中的序号（深度优先遍历顺序）
+ * 注意 nid 的格式并非绝对，请勿从 nid 中截取信息，来用于后续的计算
  *
  * @example
  * ```typescript
@@ -4959,51 +4944,6 @@ export declare class RsNodeService {
    */
   static get instance(): RsNodeService;
   private constructor();
-  /**
-   * 解析节点映射关系
-   *
-   * 从 RvModelService 中读取压缩的节点结构数据，解压并重建 nodePairs 映射表。
-   * 使用场景：当模型从服务器加载或从 RhineVar 同步时，需要恢复节点映射关系。
-   *
-   * @param mid - 模型ID
-   * @param root - 模型的根节点对象
-   *
-   * @remarks
-   * 数据压缩格式：将 `":[]"},{"` 替换为 `\x11` 以减少存储空间
-   *
-   * @example
-   * ```typescript
-   * // 模型加载完成后，解析节点映射
-   * const rootNode = container.meshes[0]
-   * RsNodeService.instance.analysisNodePairs('model-123', rootNode)
-   * ```
-   */
-  analysisNodePairs(mid: string, root: Node_2): void;
-  /**
-   * 生成节点映射对并保存到 RvModel
-   *
-   * 遍历 Babylon.js 节点树，为每个节点生成 nid 并创建 NodePair 映射。
-   * 将节点结构序列化、压缩后存储到 RvModelService 中。
-   *
-   * 使用场景：首次加载模型时，或者模型节点结构发生变化时调用。
-   *
-   * @param mid - 模型ID
-   * @param root - 模型的根节点对象
-   *
-   * @remarks
-   * - 采用深度优先遍历生成节点序号
-   * - 压缩算法：将重复的 `":[]"},{"` 字符串替换为 `\x11` 以节省空间
-   * - 生成完成后会通过发布订阅机制通知所有订阅者
-   *
-   * @example
-   * ```typescript
-   * // 首次加载模型后生成映射
-   * const container = await SceneLoader.ImportMeshAsync(...)
-   * const root = container.meshes[0]
-   * RsNodeService.instance.generateNodePairs('model-123', root)
-   * ```
-   */
-  generateNodePairs(mid: string, root: Node_2): void;
   /**
    * 生成场景节点结构并添加到 RvScene
    *
@@ -5015,20 +4955,23 @@ export declare class RsNodeService {
    * @param mid - 模型ID
    * @param root - 模型的根节点对象
    *
-   * @remarks
-   * 与 generateNodePairs 的区别：
-   * - generateNodePairs: 生成压缩的节点结构存储到 RvModel（用于节点查询）
-   * - generateSceneNode: 生成完整的场景节点树存储到 RvScene（用于场景编辑和同步）
-   *
    * @example
    * ```typescript
    * // 添加模型到场景
-   * const container = await SceneLoader.ImportMeshAsync(...)
-   * const root = container.meshes[0]
    * RsNodeService.instance.generateSceneNode('model-123', root)
    * ```
    */
   generateSceneNode(mid: string, root: Node_2): void;
+  /**
+   * 生成节点指纹
+   *
+   * 根据节点的多种属性生成唯一指纹，用于区分同名节点。
+   * 包含：位置、旋转、缩放、子节点数量、Mesh 顶点等信息。
+   *
+   * @param node - Babylon.js 节点对象
+   * @returns 指纹字符串
+   */
+  generateFingerprint(node: Node_2): string;
   /**
    * 根据 nid 获取节点映射信息
    *
@@ -5107,6 +5050,16 @@ export declare class RsNodeService {
    * ```
    */
   getMidByNid(nid: string): string | null;
+  /**
+   * 分析指定mid的模型加载内部所有节点
+   *
+   * 从 RvSceneService 中获取所有来自该 mid 的 RvSceneNode，
+   * 并将 root 及其内部的所有节点与 RvSceneNode 对应上，调用 addNodePair 完成加载。
+   *
+   * @param mid - 模型的 mid
+   * @param root - 该模型的根节点
+   */
+  analyzeSceneNode(mid: string, root: Node_2): void;
   /**
    * 根据模型ID获取文件ID (fid)
    *
@@ -5312,9 +5265,10 @@ export declare class RsSeparateService {
   checkMaterialType(material: Material, type: RvMaterialType): boolean;
   /**
    * 分析所有模型，找到其中所有有使用相同材质的模型，分组他们的id
-   * @param meshes -
+   *
+   * @param meshes
    */
-  analysisByMeshes(meshes: AbstractMesh[]): void;
+  analyzeByMeshes(meshes: AbstractMesh[]): void;
 }
 
 /**
@@ -6022,7 +5976,6 @@ export declare interface RvModel {
   origin: RvModelOrigin;
   fid?: string;
   config?: RvBasicConfig | Record<string, unknown>;
-  node?: string;
 }
 
 /**
@@ -6055,15 +6008,11 @@ export declare class RvModelService {
   ): Promise<void>;
   addByFid(fid: string, provide?: boolean): string;
   models: RecursiveMap<RvModel>;
-  hadAddList: string[];
   get(mid: string): RecursiveObject<RvModel> | undefined;
   has(mid: string): boolean;
   hasFid(fid: string): boolean;
   add(rvModel: RvModel): string;
   remove(mid: string): boolean;
-  hasNode(mid: string): boolean;
-  setNode(mid: string, node: string): boolean;
-  getNode(mid: string): string | undefined;
   generateId(): string;
 }
 
@@ -6121,6 +6070,7 @@ export declare class RvNodeService {
   isInitialized(nid: string): boolean;
   multiInitialize(nidList: string[]): void;
   isAllInitialized(nidList: string[]): boolean;
+  copy(fromNid: string, toNid: string): void;
   forEachAny(
     callback: (node: StoredRhineVar<RvNode>, sid: string, nid: string) => void,
     nidList?: string[],
@@ -6331,15 +6281,13 @@ export declare enum RvResourceType {
 export declare interface RvSceneNode {
   nid: string;
   name: string;
-  from: string;
-}
-
-/**
- * @public
- */
-export declare interface RvSceneNodeWithRelatedInfo extends RvSceneNode {
-  children: string[];
-  parents: string[];
+  parentNode: string;
+  source: {
+    mid: string;
+    name: string;
+    fingerprint?: string;
+    copy?: string;
+  };
 }
 
 /**
@@ -6350,11 +6298,17 @@ export declare class RvSceneService {
   private constructor();
   scene: RecursiveMap<RvSceneNode>;
   isDescendant(nid: string, of: string): boolean;
+  /**
+   * 是否存在来自指定mid的节点
+   *
+   * @param mid
+   */
+  hasNodeFromMid(mid: string): boolean;
   isAncestor(nid: string, of: string): boolean;
   isParent(nid: string, of: string): boolean;
   isChild(nid: string, of: string): boolean;
   move(nid: string, newParent?: string): void;
-  getSortedRvSceneNodeWithRelatedInfoList(): RvSceneNodeWithRelatedInfo[];
+  getSortedRvSceneNodeWithRelatedInfoList(): SceneNodeWithRelatedInfo[];
 }
 
 /**
@@ -6442,6 +6396,14 @@ declare function scaleV3(ratio: number, v: V3): V3;
 
 declare function scaleV4(ratio: number, v: V4): V4;
 
+/**
+ * @public
+ */
+export declare interface SceneNodeWithRelatedInfo extends RvSceneNode {
+  children: string[];
+  parents: string[];
+}
+
 /**
  * @public
  */
@@ -6455,6 +6417,7 @@ export declare class SceneService {
     offsetX: number;
     offsetY: number;
   };
+  copy(fromNid: string, parent?: string): string;
 }
 
 /**
@@ -6624,6 +6587,10 @@ export declare class SpaceService {
   page: Page;
   screen: Screen_2;
   private constructor();
+  /**
+   * @public
+   */
+  updateScreenSize(): void;
   /**
    * @public
    */
@@ -6924,17 +6891,6 @@ export declare type SupportAnimationTarget =
  * @public
  */
 export declare class SyncService {
-  /**
-   * RhineVar 同步覆写模式标志
-   *
-   * @description
-   * 启用时，允许本地状态在初始化时覆盖远程状态。
-   * 通常仅用于开发或调试目的。
-   *
-   * @defaultValue false
-   * @public
-   */
-  OVERWRITE_MODE: boolean;
   /**
    * 启用 RhineVar 内部日志
    *

package/package.json

@@ -27,7 +27,6 @@
   ],
   "peerDependencies": {
     "@babylonjs/core": "8.33.0",
-    "antd": "5.27.0",
     "brotli-wasm": "^3.0.1",
     "clsx": "2.1.1",
     "file-type": "^21.0.0",
@@ -37,7 +36,7 @@
     "valtio": "2.1.7",
     "rhine-var": "0.11.2"
   },
-  "version": "0.25.14",
+  "version": "0.26.7",
   "author": "NextFlow",
   "license": "Apache-2.0",
   "keywords": [