feat: 添加接口

Author: YingFeng256

package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-flow-interface",
-  "version": "0.23.15",
+  "version": "0.23.16",
   "description": "Interface package for NEXT FlOW. You can use this package to build your own plugin that can control anything.",
   "type": "module",
   "module": "dist/index.js",

src/api/index.ts

@@ -38,6 +38,7 @@ import { UseLastSelectedInfo } from '@/hook/use-last-selected-info.type'
 import { UseSelectedInfo } from '@/hook/use-selected-info.type'
 import { UseSelectedMaterialInfo } from '@/hook/use-selected-material-info.type'
 import { UseStepOptions } from '@/hook/use-step-options.type'
+import { UseTNodeAttribute } from '@/hook/use-t-node-attribute.type'
 import { UseTNode } from '@/hook/use-t-node.type'
 import { UseTStep } from '@/hook/use-t-step.type'
 import RvLoopAttributeApi from '@/service/attributes/animation/loop/rv-loop-attribute-api'
@@ -101,6 +102,7 @@ import RvSceneServiceApi from '@/service/sync/scene/rv-scene-service-api'
 import RvNodeServiceApi from '@/service/sync/step/node/rv-node-service-api'
 import RvStepServiceApi from '@/service/sync/step/rv-step-service-api'
 import SyncServiceApi from '@/service/sync/sync-service-api'
+import TMultiNodeServiceApi from '@/service/target/t-multi-node-service-api'
 import TNodeServiceApi from '@/service/target/t-node-service-api'
 import TStepServiceApi from '@/service/target/t-step-service-api'
 import { MaterialSymbolOptions } from '@/utils/material-symbol-utils'
@@ -178,6 +180,7 @@ export let rvModelService: RvModelServiceApi
 export let rvNodeService: RvNodeServiceApi
 export let rvNodeMaterialAnalyzer: RvNodeMaterialAnalyzerApi
 
+export let tMultiNodeService: TMultiNodeServiceApi
 export let tStepService: TStepServiceApi
 export let tNodeService: TNodeServiceApi
 
@@ -190,6 +193,7 @@ export let useSelectedInfo: UseSelectedInfo
 export let useSelectedMaterialInfo: UseSelectedMaterialInfo
 export let useTStep: UseTStep
 export let useTNode: UseTNode
+export let useTNodeAttribute: UseTNodeAttribute
 export let useStepOptions: UseStepOptions
 
 export let ThemeProvider: FunctionComponent<ThemeProviderProps>

src/hook/use-t-node-attribute.type.ts

@@ -0,0 +1,12 @@
+import { StoredRhineVar } from 'rhine-var'
+
+import TNodeAttribute from '@/service/sync/attribute/dto/target/t-node-attribute.interface'
+
+export interface UseTNodeAttribute<T extends object = never> {
+  state: StoredRhineVar<T> | T
+  sid: string
+  sidList: string[]
+  nid: string
+  nidList: string[]
+  tna: TNodeAttribute<T>
+}

src/index.ts

@@ -17,6 +17,8 @@ import {
   RvMaterialNodeInput,
 } from '@/service/sync/interface/step/node/material/node/rv-material-node.interface'
 import { RvMaterialPBR } from '@/service/sync/interface/step/node/material/pbr/rv-material-pbr.interface'
+import { RvPresetType } from '@/service/sync/interface/step/node/material/preset/rv-preset-type.enum'
+import { RvMaterialTexture } from '@/service/sync/interface/step/node/material/texture/rv-material-texture.interface'
 import RvNodeServiceApi from '@/service/sync/step/node/rv-node-service-api'
 
 import { AntCheckboxProps } from './components/ant/ant-checkbox-props'
@@ -67,6 +69,7 @@ import { UseLastSelectedInfo } from './hook/use-last-selected-info.type'
 import { UseSelectedInfo } from './hook/use-selected-info.type'
 import { UseSelectedMaterialInfo } from './hook/use-selected-material-info.type'
 import { UseStepOptions } from './hook/use-step-options.type'
+import { UseTNodeAttribute } from './hook/use-t-node-attribute.type'
 import { UseTNode } from './hook/use-t-node.type'
 import { UseTStep } from './hook/use-t-step.type'
 import BasePlugin from './plugin/base-plugin'
@@ -233,6 +236,7 @@ import UserInfo from './service/main/user/dto/user-info.interface'
 import UserServiceApi from './service/main/user/user-service-api'
 import AttributeServiceApi from './service/sync/attribute/attribute-service-api'
 import { AttributeType } from './service/sync/attribute/dto/attribute-type.enum'
+import ITNodeAttribute from './service/sync/attribute/dto/target/t-node-attribute.interface'
 import AwarenessServiceApi, {
   AwarenessChanges,
   AwarenessChangeSubscriber,
@@ -280,16 +284,12 @@ import RvResource from './service/sync/interface/resource/rv-resource.interface'
 import RvBase from './service/sync/interface/rv-base.interface'
 import RvSceneNode from './service/sync/interface/scene/rv-scene-node.interface'
 import RvSeparate from './service/sync/interface/separate/rv-separate.interface'
-import { RvPresetType } from '@/service/sync/interface/step/node/material/preset/rv-preset-type.enum'
-
 import RvAudio from './service/sync/interface/step/configuration/audio-info/rv-audio.interface'
 import RvConfiguration from './service/sync/interface/step/configuration/rv-configuration.interface'
 import RvCameraLocation from './service/sync/interface/step/environment/camera/location/rv-camera-location.interface'
 import RvCamera from './service/sync/interface/step/environment/camera/rv-camera.interface'
 import RvEnvironment from './service/sync/interface/step/environment/rv-environment.interface'
 import RvMaterial from './service/sync/interface/step/node/material/rv-material.interface'
-import { RvMaterialTexture } from '@/service/sync/interface/step/node/material/texture/rv-material-texture.interface'
-
 import RvNode from './service/sync/interface/step/node/rv-node.interface'
 import RvStep from './service/sync/interface/step/rv-step.interface'
 import RvVersion from './service/sync/interface/version/rv-version.interface'
@@ -310,6 +310,7 @@ import SyncServiceApi from './service/sync/sync-service-api'
 import { TNodeSubscriber } from './service/target/dto/t-attributes-subscriber.type'
 import { TChangeType } from './service/target/dto/t-change-type.enum'
 import { TStepSubscriber } from './service/target/dto/t-step-subscriber.type'
+import TMultiNodeServiceApi from './service/target/t-multi-node-service-api'
 import TNodeServiceApi from './service/target/t-node-service-api'
 import TStepServiceApi from './service/target/t-step-service-api'
 import { C3, C4 } from './type/general/color.type'
@@ -566,6 +567,9 @@ export type {
   ShowAttributeContextMenu,
   ShowAttributeContextMenuOptions,
   StepBlockSelectProps,
+  TMultiNodeServiceApi,
+  UseTNodeAttribute,
+  ITNodeAttribute,
 }
 
 export {

src/service/sync/attribute/attribute-service-api.ts

@@ -6,6 +6,8 @@ import IGlobalAttribute from '@/service/sync/attribute/dto/instance/global-attri
 import INodeAttribute from '@/service/sync/attribute/dto/instance/node-attribute.interface'
 import IStepAttribute from '@/service/sync/attribute/dto/instance/step-attribute.interface'
 
+import ITNodeAttribute from './dto/target/t-node-attribute.interface'
+
 /**
  * 属性服务 API 接口
  *
@@ -56,6 +58,12 @@ export default interface AttributeServiceApi {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   globalAttributes: IGlobalAttribute<any>[]
 
+  /**
+   * 已注册的 TNode 类型属性列表
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  tNodeAttributes: ITNodeAttribute<any>[]
+
   /**
    * 注册属性
    *
@@ -89,6 +97,15 @@ export default interface AttributeServiceApi {
    */
   getNodeAttribute<T extends object = never>(path: RvPath | string): INodeAttribute<T> | undefined
 
+
+  /**
+   * 通过路径获取 TNodeAttribute
+   *
+   * @param path - 属性路径，支持 RvPath 数组或字符串格式
+   * @returns 匹配的 TNodeAttribute 实例，未找到返回 undefined
+   */
+  getTNodeAttribute<T extends object = never>(path: RvPath | string): ITNodeAttribute<T> | undefined
+
   /**
    * 通过路径获取 StepAttribute
    *

src/service/sync/attribute/dto/target/t-node-attribute.interface.ts

@@ -0,0 +1,42 @@
+import { RecursiveCrossRhineVar, RvPath, StoredRhineVar } from 'rhine-var'
+
+import { TChangeType } from '@/service/target/dto/t-change-type.enum'
+import TMultiNodeServiceApi from '@/service/target/t-multi-node-service-api'
+
+import INodeAttribute from '../instance/node-attribute.interface'
+
+export type TNodeAttributeSubscriber<T extends object = never> = (
+  type: TChangeType,
+  path: RvPath,
+  value: unknown,
+  oldValue: unknown,
+  sid: string,
+  nid: string,
+  rvNode: StoredRhineVar<T> | null,
+) => void
+
+export default interface ITNodeAttribute<T extends object = never> {
+  attribute: INodeAttribute<T>
+  tMultiNodeService: TMultiNodeServiceApi
+  path(): RvPath
+  sid(): string
+  sidList(): string[]
+  nid(): string
+  nidList(): string[]
+  initialize(nid: string): void
+  isInitialize(nid: string): boolean
+  multiInitialize(nidList: string[]): void
+  isAllInitialized(nidList: string[]): boolean
+  mark(path: string | RvPath, sid: string, nid: string): void
+  multiMark(path: string | RvPath, sidList: string[], nidList: string[]): void
+  get(sid: string, nid: string): RecursiveCrossRhineVar<T> | undefined
+  multiGet(sidList: string[], nidList: string[]): Map<string, Map<string, StoredRhineVar<T>>>
+  set(path: string | RvPath, value: unknown, sid: string, nid: string): void
+  multiSet(path: string | RvPath, value: unknown, sidList: string[], nidList: string[]): void
+  read(sid: string, nid: string): StoredRhineVar<T> | T | undefined
+  multiRead(sidList: string[], nidList: string[]): Map<string, Map<string, StoredRhineVar<T> | T>>
+  edit(path: string | RvPath, value: unknown, sid: string, nid: string): void
+  multiEdit(path: string | RvPath, value: unknown, sidList: string[], nidList: string[]): void
+  subscribe(subscriber: TNodeAttributeSubscriber<T>): () => void
+  unsubscribe(subscriber: TNodeAttributeSubscriber<T>): void
+}

src/service/target/t-multi-node-service-api.ts

@@ -0,0 +1,22 @@
+import { RvPath, StoredRhineVar } from 'rhine-var'
+
+import RvNode from '@/service/sync/interface/step/node/rv-node.interface'
+import { TNodeSubscriber } from '@/service/target/dto/t-attributes-subscriber.type'
+
+export default interface TMultiNodeServiceApi {
+  sid: string
+
+  nidList: string[]
+
+  lastNid: string
+
+  state: StoredRhineVar<RvNode> | null
+
+  get<T = unknown>(path: string | RvPath): T | null
+
+  set<T = unknown>(path: string | RvPath, value: T): void
+
+  subscribe(subscriber: TNodeSubscriber): () => void
+
+  unsubscribe(subscriber: TNodeSubscriber): void
+}