refactor: 重构当前状态相关服务 TStepService TNodeService useTStep useTNode

Author: HRan2004

package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-flow-interface",
-  "version": "0.23.4",
+  "version": "0.23.5",
   "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,7 +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 { UseTAttributes } from '@/hook/use-t-attributes.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'
 import RvNativeAttributeApi from '@/service/attributes/animation/native/rv-native-attribute-api'
@@ -100,8 +100,8 @@ 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 TAttributesServiceApi from '@/service/target/attribute/t-attributes-service-api'
-import TStepServiceApi from '@/service/target/step/t-step-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'
 
 import type { FunctionComponent } from 'react'
@@ -177,7 +177,7 @@ export let rvNodeService: RvNodeServiceApi
 export let rvNodeMaterialAnalyzer: RvNodeMaterialAnalyzerApi
 
 export let tStepService: TStepServiceApi
-export let tAttributesService: TAttributesServiceApi
+export let tNodeService: TNodeServiceApi
 
 export let showAttributeContextMenu: ShowAttributeContextMenu<unknown>
 
@@ -187,7 +187,7 @@ export let useLastSelectedInfo: UseLastSelectedInfo
 export let useSelectedInfo: UseSelectedInfo
 export let useSelectedMaterialInfo: UseSelectedMaterialInfo
 export let useTStep: UseTStep
-export let useTAttributes: UseTAttributes
+export let useTNode: UseTNode
 export let useStepOptions: UseStepOptions
 
 export let ThemeProvider: FunctionComponent<ThemeProviderProps>

src/hook/use-t-attributes.type.ts src/hook/use-t-node.type.tssrc/hook/use-t-attributes.type.ts renamed to src/hook/use-t-node.type.ts

@@ -1,7 +1,7 @@
 import { RvPath } from 'rhine-var'
 
-export type UseTAttributes = <T = unknown>(
-  path?: string,
+export type UseTNode = <T = unknown>(
+  path?: string | RvPath,
 ) => {
   sid: string
   nid: string

src/hook/use-t-step.type.ts

@@ -1,7 +1,7 @@
 import { RvPath } from 'rhine-var'
 
 export type UseTStep = <T = unknown>(
-  path?: string,
+  path?: string | RvPath,
 ) => {
   sid: string
   state: T

src/index.ts

@@ -48,7 +48,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 { UseTAttributes } from './hook/use-t-attributes.type'
+import { UseTNode } from './hook/use-t-node.type'
 import { UseTStep } from './hook/use-t-step.type'
 import BasePlugin from './plugin/base-plugin'
 import DialogPlugin from './plugin/dialog-plugin'
@@ -300,11 +300,11 @@ import RvSceneServiceApi, {
 import { StepOptions } from './service/sync/step/dto/step-options.type'
 import RvStepServiceApi from './service/sync/step/rv-step-service-api'
 import SyncServiceApi from './service/sync/sync-service-api'
-import TAttributesServiceApi from './service/target/attribute/t-attributes-service-api'
-import { TAttributesSubscriber } from './service/target/dto/t-attributes-subscriber.type'
+import { TNodeSubscriber } from './service/target/dto/t-attributes-subscriber.type'
 import { TChangeType } from './service/target/dto/t-change-type.enum'
-import { TSubscriber } from './service/target/dto/t-subscriber.type'
-import TStepServiceApi from './service/target/step/t-step-service-api'
+import { TStepSubscriber } from './service/target/dto/t-step-subscriber.type'
+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'
 import { V2, V3, V4 } from './type/general/vector.type'
 import { MixView } from './type/view/mix-view'
@@ -395,10 +395,10 @@ export type {
   RvVersion,
   RvStepServiceApi,
   RvModel,
+  TStepSubscriber,
+  TNodeSubscriber,
   TStepServiceApi,
-  TSubscriber,
-  TAttributesSubscriber,
-  TAttributesServiceApi,
+  TNodeServiceApi,
   StepOptions,
   PluginViewProps,
   MessageServiceApi,
@@ -469,7 +469,7 @@ export type {
   RsSelectionState,
   UseBase,
   UseTStep,
-  UseTAttributes,
+  UseTNode,
   UseStepOptions,
   V2,
   V3,

src/service/target/dto/t-attributes-subscriber.type.ts

@@ -4,12 +4,12 @@ import RvNode from '@/service/sync/interface/step/attributes/rv-node.interface'
 
 import { TChangeType } from './t-change-type.enum'
 
-export type TAttributesSubscriber = (
+export type TNodeSubscriber = (
   type: TChangeType,
   path: RvPath,
   value: unknown,
   oldValue: unknown,
   sid: string,
   nid: string,
-  nodeAttributes: StoredRhineVar<RvNode> | null,
+  rvNode: StoredRhineVar<RvNode> | null,
 ) => void

…/service/target/dto/t-subscriber.type.ts …ice/target/dto/t-step-subscriber.type.tssrc/service/target/dto/t-subscriber.type.ts renamed to src/service/target/dto/t-step-subscriber.type.ts src/service/target/dto/t-subscriber.type.ts renamed to src/service/target/dto/t-step-subscriber.type.ts

@@ -2,7 +2,7 @@ import { RvPath } from 'rhine-var'
 
 import { TChangeType } from './t-change-type.enum'
 
-export type TSubscriber = (
+export type TStepSubscriber = (
   type: TChangeType,
   path: RvPath,
   value: unknown,

src/service/target/step/t-step-service-api.ts

@@ -1,18 +1,16 @@
 import { RvPath, StoredRhineVar } from 'rhine-var'
 
 import RvNode from '@/service/sync/interface/step/attributes/rv-node.interface'
-import { TAttributesSubscriber } from '@/service/target/dto/t-attributes-subscriber.type'
+import { TNodeSubscriber } from '@/service/target/dto/t-attributes-subscriber.type'
 
-export default interface TAttributesServiceApi {
+export default interface TNodeServiceApi {
   sid: string
 
   nid: string
 
   state: StoredRhineVar<RvNode> | null
 
-  subscribe(subscriber: TAttributesSubscriber): () => void
-
-  unsubscribe(subscriber: TAttributesSubscriber): void
+  get<T>(path: string | RvPath): T | null
 
   set<T>(path: string | RvPath, value: T): void
 
@@ -22,5 +20,7 @@ export default interface TAttributesServiceApi {
 
   multiCheck<T>(path: string | RvPath): void
 
-  get<T>(path: string | RvPath): T | null
+  subscribe(subscriber: TNodeSubscriber): () => void
+
+  unsubscribe(subscriber: TNodeSubscriber): void
 }

…et/attribute/t-attributes-service-api.ts src/service/target/t-node-service-api.tssrc/service/target/attribute/t-attributes-service-api.ts renamed to src/service/target/t-node-service-api.ts src/service/target/attribute/t-attributes-service-api.ts renamed to src/service/target/t-node-service-api.ts

@@ -0,0 +1,23 @@
+import { RvPath, StoredRhineVar } from 'rhine-var'
+
+import RvStep from '@/service/sync/interface/step/rv-step.interface'
+import { TNodeSubscriber } from '@/service/target/dto/t-attributes-subscriber.type'
+import { TStepSubscriber } from '@/service/target/dto/t-step-subscriber.type'
+
+export default interface TStepServiceApi {
+  sid: string
+
+  state: StoredRhineVar<RvStep>
+
+  get(path: string | RvPath): unknown
+
+  set(path: string | RvPath, value: unknown): void
+
+  subscribe(subscriber: TStepSubscriber): () => void
+
+  unsubscribe(subscriber: TStepSubscriber): void
+
+  subscribeNode(subscriber: TNodeSubscriber): () => void
+
+  unsubscribeNode(subscriber: TNodeSubscriber): void
+}