@rxflow/terminal-bloodline 0.0.3 → 0.0.4-alpha.1

package/cjs/hooks/expandState/useToggleExpandState.js

@@ -18,10 +18,10 @@ var _state = require("../state");
 
 const useToggleExpandState = () => {
   const setState = (0, _state.useSetState)();
-  const getProps = (0, _base.useGetProps)();
+  const getInputProps = (0, _base.useGetInputProps)();
   return (0, _react.useCallback)(id => {
     // 如果仅支持单个呢，直接清空Set
-    const allowExpandMultiples = getProps().allowExpandMultiples;
+    const allowExpandMultiples = getInputProps().allowExpandMultiples;
     setState(state => {
       const expandSet = allowExpandMultiples ? state.expandSet || new Set() : new Set();
       const expand = !state.expandSet?.has(id);

package/cjs/hooks/useGetTerminalList.d.ts

@@ -10,7 +10,7 @@ import { BaseBloodNode } from "../types";
 export declare const useGetTerminalList: () => () => (BaseBloodNode & {
     [key: string]: any;
     collapsed?: boolean | undefined;
-    nodeList?: (Omit<BaseBloodNode, "upstream" | "downstream"> & {
+    nodeList?: (Omit<BaseBloodNode, "downstream" | "upstream"> & {
         parentIdList: string[];
     })[] | undefined;
 })[];

package/cjs/hooks/useGetTerminalList.js

@@ -16,9 +16,9 @@ var _react = require("react");
  */
 
 const useGetTerminalList = () => {
-  const getProps = (0, _base.useGetProps)();
+  const getFlowProps = (0, _base.useGetFlowProps)();
   return (0, _react.useCallback)(() => {
-    const nodes = getProps().nodes;
+    const nodes = getFlowProps().nodes;
     if (!nodes || nodes.length == 0) {
       return [];
     }

package/cjs/hooks/useTerminalBloodlineProps.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @author: yanxianliang
+ * @date: 2025-01-17
+ * @desc: Terminal Bloodline Props hooks - 类型化的 props 访问
+ *
+ * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
+ */
+import { IBaseFlowProps } from '@rxflow/base';
+import { TerminalBloodlineFlowProps, TerminalBloodlineExtendProps, BaseBloodNode } from '../types';
+type TerminalBloodlineFullFlowProps = IBaseFlowProps & TerminalBloodlineExtendProps;
+/**
+ * 获取原始输入 props
+ *
+ * @example
+ * const inputProps = useTerminalBloodlineInputProps();
+ * const root = useTerminalBloodlineInputProps(state => state.root);
+ */
+export declare function useTerminalBloodlineInputProps(): TerminalBloodlineFlowProps;
+export declare function useTerminalBloodlineInputProps<U>(selector: (state: TerminalBloodlineFlowProps) => U): U;
+/**
+ * 获取转换后的 Flow props
+ *
+ * @example
+ * const flowProps = useTerminalBloodlineFlowProps();
+ * const nodes = useTerminalBloodlineFlowProps(state => state.nodes);
+ */
+export declare function useTerminalBloodlineFlowProps(): TerminalBloodlineFullFlowProps;
+export declare function useTerminalBloodlineFlowProps<U>(selector: (state: TerminalBloodlineFullFlowProps) => U): U;
+/**
+ * 获取原始输入 props 的 getter（非响应式）
+ */
+export declare const useGetTerminalBloodlineInputProps: () => {
+    (): TerminalBloodlineFlowProps;
+    <U>(selector: (state: TerminalBloodlineFlowProps) => U): U;
+};
+/**
+ * 获取转换后 Flow props 的 getter（非响应式）
+ */
+export declare const useGetTerminalBloodlineFlowProps: () => {
+    (): TerminalBloodlineFullFlowProps;
+    <U>(selector: (state: TerminalBloodlineFullFlowProps) => U): U;
+};
+/**
+ * 获取 root 节点数据
+ */
+export declare const useTerminalRoot: () => BaseBloodNode | undefined;
+/**
+ * 获取主题配置
+ */
+export declare const useTerminalBloodlineTheme: () => import("../types").IBloodlineTheme | undefined;
+/**
+ * 获取是否允许展开多个
+ */
+export declare const useAllowExpandMultiples: () => boolean | undefined;
+/**
+ * 获取过滤函数
+ */
+export declare const useOnFilter: () => ((data: Record<string, any>, value: string) => boolean) | undefined;
+export {};
+//# sourceMappingURL=useTerminalBloodlineProps.d.ts.map

package/cjs/hooks/useTerminalBloodlineProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminalBloodlineProps.d.ts","sourceRoot":"","sources":["useTerminalBloodlineProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAkE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnG,KAAK,8BAA8B,GAAG,cAAc,GAAG,4BAA4B,CAAC;AAEpF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,0BAA0B,CAAC;AAC7E,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,CAAC,GAAG,CAAC,CAAC;AAKzG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,8BAA8B,CAAC;AAChF,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,CAAC,GAAG,CAAC,CAAC;AAK5G;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;CAE7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;CAE5C,CAAC;AAGF;;GAEG;AACH,eAAO,MAAM,eAAe,iCAA4D,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,yBAAyB,sDAA6D,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,uBAAuB,2BAA4E,CAAC;AAEjH;;GAEG;AACH,eAAO,MAAM,WAAW,2EAAgE,CAAC"}

package/cjs/hooks/useTerminalBloodlineProps.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useOnFilter = exports.useGetTerminalBloodlineInputProps = exports.useGetTerminalBloodlineFlowProps = exports.useAllowExpandMultiples = void 0;
+exports.useTerminalBloodlineFlowProps = useTerminalBloodlineFlowProps;
+exports.useTerminalBloodlineInputProps = useTerminalBloodlineInputProps;
+exports.useTerminalRoot = exports.useTerminalBloodlineTheme = void 0;
+var _base = require("@rxflow/base");
+/**
+ * @author: yanxianliang
+ * @date: 2025-01-17
+ * @desc: Terminal Bloodline Props hooks - 类型化的 props 访问
+ *
+ * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
+ */
+
+/**
+ * 获取原始输入 props
+ *
+ * @example
+ * const inputProps = useTerminalBloodlineInputProps();
+ * const root = useTerminalBloodlineInputProps(state => state.root);
+ */
+
+function useTerminalBloodlineInputProps(selector) {
+  return (0, _base.useInputProps)(selector);
+}
+
+/**
+ * 获取转换后的 Flow props
+ *
+ * @example
+ * const flowProps = useTerminalBloodlineFlowProps();
+ * const nodes = useTerminalBloodlineFlowProps(state => state.nodes);
+ */
+
+function useTerminalBloodlineFlowProps(selector) {
+  return (0, _base.useFlowProps)(selector);
+}
+
+/**
+ * 获取原始输入 props 的 getter（非响应式）
+ */
+const useGetTerminalBloodlineInputProps = () => {
+  return (0, _base.useGetInputProps)();
+};
+
+/**
+ * 获取转换后 Flow props 的 getter（非响应式）
+ */
+exports.useGetTerminalBloodlineInputProps = useGetTerminalBloodlineInputProps;
+const useGetTerminalBloodlineFlowProps = () => {
+  return (0, _base.useGetFlowProps)();
+};
+
+// 便捷 hooks
+/**
+ * 获取 root 节点数据
+ */
+exports.useGetTerminalBloodlineFlowProps = useGetTerminalBloodlineFlowProps;
+const useTerminalRoot = () => useTerminalBloodlineInputProps(state => state.root);
+
+/**
+ * 获取主题配置
+ */
+exports.useTerminalRoot = useTerminalRoot;
+const useTerminalBloodlineTheme = () => useTerminalBloodlineInputProps(state => state.theme);
+
+/**
+ * 获取是否允许展开多个
+ */
+exports.useTerminalBloodlineTheme = useTerminalBloodlineTheme;
+const useAllowExpandMultiples = () => useTerminalBloodlineInputProps(state => state.allowExpandMultiples);
+
+/**
+ * 获取过滤函数
+ */
+exports.useAllowExpandMultiples = useAllowExpandMultiples;
+const useOnFilter = () => useTerminalBloodlineInputProps(state => state.onFilter);
+exports.useOnFilter = useOnFilter;

package/cjs/hooks/useTerminalCount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTerminalCount.d.ts","sourceRoot":"","sources":["useTerminalCount.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,cAS5B,CAAA"}
+{"version":3,"file":"useTerminalCount.d.ts","sourceRoot":"","sources":["useTerminalCount.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,cAS5B,CAAC"}

package/cjs/hooks/useTerminalCount.js

@@ -8,14 +8,14 @@ var _base = require("@rxflow/base");
 /**
  * @author: yanxianliang
  * @date: 2025-10-19 19:24
- * @modified：2025/10/19 19:24 by yanxianliang
+ * @modified：2025/1/17 by yanxianliang
  * @desc: 获取末级节点数量
  *
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
 
 const useTerminalCount = () => {
-  return (0, _base.usePropsSelector)(state => {
+  return (0, _base.useFlowProps)(state => {
     const nodes = state.nodes;
     if (!nodes || nodes.length == 0) {
       return 0;

package/cjs/index.d.ts

@@ -4,4 +4,5 @@ declare const TerminalBloodlineFlow: (props: import("react").PropsWithChildren<T
 export default TerminalBloodlineFlow;
 export * from './types';
 export * from './constants';
+export * from './hooks/useTerminalBloodlineProps';
 //# sourceMappingURL=index.d.ts.map

package/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAA+B,0BAA0B,EAAC,MAAM,SAAS,CAAC;AA0BjF,QAAA,MAAM,qBAAqB,mHA8CzB,CAAA;AAGF,eAAe,qBAAqB,CAAC;AAErC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAAgC,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAkEnF,QAAA,MAAM,qBAAqB,mHAG1B,CAAC;AAEF,eAAe,qBAAqB,CAAC;AAGrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAG5B,cAAc,mCAAmC,CAAC"}

package/cjs/index.js

@@ -39,11 +39,24 @@ Object.keys(_constants).forEach(function (key) {
     }
   });
 });
+var _useTerminalBloodlineProps = require("./hooks/useTerminalBloodlineProps");
+Object.keys(_useTerminalBloodlineProps).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useTerminalBloodlineProps[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useTerminalBloodlineProps[key];
+    }
+  });
+});
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /*
  * @author: yanxianliang
  * @date: 2025-06-01 18:36
- * @desc: 血缘视图
+ * @modified：2025/1/17 by yanxianliang
+ * @desc: 末级血缘视图
  *
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
@@ -53,7 +66,8 @@ const fitViewOptions = {
   minZoom: 1,
   maxZoom: 1
 };
-const omitProps = ['root', 'getRelation', 'mode', "allowExpandMultiples", 'onFilter'];
+
+// 内置节点类型
 const innerNodeTypes = [{
   type: 'search',
   hideInLegend: true,
@@ -63,7 +77,11 @@ const innerNodeTypes = [{
   hideInLegend: true,
   component: _Pagination.Pagination
 }];
-const TerminalBloodlineFlow = (0, _base.createFlow)(_base.Flow, props => {
+
+/**
+ * Props 转换 hook
+ */
+const useTerminalBloodlinePropsTransform = props => {
   const {
     root,
     nodeTypes,
@@ -72,36 +90,40 @@ const TerminalBloodlineFlow = (0, _base.createFlow)(_base.Flow, props => {
   const setPageIndex = (0, _useSetPageIndex.useSetPageIndex)();
   const setFilter = (0, _useSetFilter.useSetFilter)();
   const cleanExpandState = (0, _useCleanExpandState.useCleanExpandState)();
+
+  // 将 root 转换为 nodes
   const nodes = (0, _react.useMemo)(() => {
     setPageIndex(1);
     setFilter('');
-    cleanExpandState(); // root 变化，清除所有展开配置
+    cleanExpandState();
     return root ? [(0, _cloneDeep.default)(root)] : [];
   }, [root]);
-  const _nodeTypes = (0, _react.useMemo)(() => {
-    return [...innerNodeTypes, ...(nodeTypes || []).map(nodeType => {
-      return {
-        ...nodeType,
-        _component: nodeType.component,
-        // 真实的节点组件
-        component: _BaseNodeWrapper.BaseNodeWrapper
-      };
-    })];
+
+  // 包装 nodeTypes
+  const wrappedNodeTypes = (0, _react.useMemo)(() => {
+    return [...innerNodeTypes, ...(nodeTypes || []).map(nodeType => ({
+      ...nodeType,
+      _component: nodeType.component,
+      component: _BaseNodeWrapper.BaseNodeWrapper
+    }))];
   }, [nodeTypes]);
+
+  // 绑定 onFilter 到 layout
   const layout = (0, _react.useMemo)(() => {
     return _layoutCells.layoutCells.bind(undefined, onFilter);
-  }, []);
+  }, [onFilter]);
   return {
     ...props,
     edgesFocusable: false,
     fitViewOptions,
     autoCenter: true,
     nodes,
-    layout: layout,
-    nodeTypes: _nodeTypes,
-    omitProps,
+    layout,
+    nodeTypes: wrappedNodeTypes,
     selectionOnDrag: false,
     nodesDraggable: false
   };
-});
-var _default = exports.default = TerminalBloodlineFlow;
+};
+const TerminalBloodlineFlow = (0, _base.createFlow)(_base.Flow, useTerminalBloodlinePropsTransform);
+var _default = exports.default = TerminalBloodlineFlow; // 类型导出
+// Hooks 导出

package/cjs/nodes/Search/index.js

@@ -35,7 +35,7 @@ const Search = () => {
   const setPageIndex = (0, _useSetPageIndex.useSetPageIndex)();
   const [open, setOpen] = (0, _react.useState)(false);
   const getTerminalList = (0, _useGetTerminalList.useGetTerminalList)();
-  const getProps = (0, _base.useGetProps)();
+  const getInputProps = (0, _base.useGetInputProps)();
   const [messageApi, contextHolder] = _antd.message.useMessage();
   const count = (0, _useTerminalCount.useTerminalCount)();
   const showInput = (0, _react.useCallback)(() => {
@@ -43,7 +43,7 @@ const Search = () => {
   }, []);
   const onSearch = (0, _react.useCallback)(value => {
     const list = getTerminalList();
-    const onFilter = getProps().onFilter || _layoutCells.defaultFilter;
+    const onFilter = getInputProps().onFilter || _layoutCells.defaultFilter;
     const hasItem = list.find(item => {
       const data = item.data;
       return onFilter(data, value);

package/esm/hooks/expandState/useToggleExpandState.js

@@ -6,15 +6,15 @@
  *
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
-import { useGetProps } from "@rxflow/base";
+import { useGetInputProps } from "@rxflow/base";
 import { useCallback } from "react";
 import { useSetState } from "../state";
 export var useToggleExpandState = function useToggleExpandState() {
   var setState = useSetState();
-  var getProps = useGetProps();
+  var getInputProps = useGetInputProps();
   return useCallback(function (id) {
     // 如果仅支持单个呢，直接清空Set
-    var allowExpandMultiples = getProps().allowExpandMultiples;
+    var allowExpandMultiples = getInputProps().allowExpandMultiples;
     setState(function (state) {
       var _state$expandSet;
       var expandSet = allowExpandMultiples ? state.expandSet || new Set() : new Set();

package/esm/hooks/useGetTerminalList.d.ts

@@ -10,7 +10,7 @@ import { BaseBloodNode } from "../types";
 export declare const useGetTerminalList: () => () => (BaseBloodNode & {
     [key: string]: any;
     collapsed?: boolean | undefined;
-    nodeList?: (Omit<BaseBloodNode, "upstream" | "downstream"> & {
+    nodeList?: (Omit<BaseBloodNode, "downstream" | "upstream"> & {
         parentIdList: string[];
     })[] | undefined;
 })[];

package/esm/hooks/useGetTerminalList.js

@@ -7,12 +7,12 @@
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
 
-import { useGetProps } from "@rxflow/base";
+import { useGetFlowProps } from "@rxflow/base";
 import { useCallback } from "react";
 export var useGetTerminalList = function useGetTerminalList() {
-  var getProps = useGetProps();
+  var getFlowProps = useGetFlowProps();
   return useCallback(function () {
-    var nodes = getProps().nodes;
+    var nodes = getFlowProps().nodes;
     if (!nodes || nodes.length == 0) {
       return [];
     }

package/esm/hooks/useTerminalBloodlineProps.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @author: yanxianliang
+ * @date: 2025-01-17
+ * @desc: Terminal Bloodline Props hooks - 类型化的 props 访问
+ *
+ * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
+ */
+import { IBaseFlowProps } from '@rxflow/base';
+import { TerminalBloodlineFlowProps, TerminalBloodlineExtendProps, BaseBloodNode } from '../types';
+type TerminalBloodlineFullFlowProps = IBaseFlowProps & TerminalBloodlineExtendProps;
+/**
+ * 获取原始输入 props
+ *
+ * @example
+ * const inputProps = useTerminalBloodlineInputProps();
+ * const root = useTerminalBloodlineInputProps(state => state.root);
+ */
+export declare function useTerminalBloodlineInputProps(): TerminalBloodlineFlowProps;
+export declare function useTerminalBloodlineInputProps<U>(selector: (state: TerminalBloodlineFlowProps) => U): U;
+/**
+ * 获取转换后的 Flow props
+ *
+ * @example
+ * const flowProps = useTerminalBloodlineFlowProps();
+ * const nodes = useTerminalBloodlineFlowProps(state => state.nodes);
+ */
+export declare function useTerminalBloodlineFlowProps(): TerminalBloodlineFullFlowProps;
+export declare function useTerminalBloodlineFlowProps<U>(selector: (state: TerminalBloodlineFullFlowProps) => U): U;
+/**
+ * 获取原始输入 props 的 getter（非响应式）
+ */
+export declare const useGetTerminalBloodlineInputProps: () => {
+    (): TerminalBloodlineFlowProps;
+    <U>(selector: (state: TerminalBloodlineFlowProps) => U): U;
+};
+/**
+ * 获取转换后 Flow props 的 getter（非响应式）
+ */
+export declare const useGetTerminalBloodlineFlowProps: () => {
+    (): TerminalBloodlineFullFlowProps;
+    <U>(selector: (state: TerminalBloodlineFullFlowProps) => U): U;
+};
+/**
+ * 获取 root 节点数据
+ */
+export declare const useTerminalRoot: () => BaseBloodNode | undefined;
+/**
+ * 获取主题配置
+ */
+export declare const useTerminalBloodlineTheme: () => import("../types").IBloodlineTheme | undefined;
+/**
+ * 获取是否允许展开多个
+ */
+export declare const useAllowExpandMultiples: () => boolean | undefined;
+/**
+ * 获取过滤函数
+ */
+export declare const useOnFilter: () => ((data: Record<string, any>, value: string) => boolean) | undefined;
+export {};
+//# sourceMappingURL=useTerminalBloodlineProps.d.ts.map

package/esm/hooks/useTerminalBloodlineProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminalBloodlineProps.d.ts","sourceRoot":"","sources":["useTerminalBloodlineProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAkE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnG,KAAK,8BAA8B,GAAG,cAAc,GAAG,4BAA4B,CAAC;AAEpF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,0BAA0B,CAAC;AAC7E,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,CAAC,GAAG,CAAC,CAAC;AAKzG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,8BAA8B,CAAC;AAChF,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,CAAC,GAAG,CAAC,CAAC;AAK5G;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;CAE7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;CAE5C,CAAC;AAGF;;GAEG;AACH,eAAO,MAAM,eAAe,iCAA4D,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,yBAAyB,sDAA6D,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,uBAAuB,2BAA4E,CAAC;AAEjH;;GAEG;AACH,eAAO,MAAM,WAAW,2EAAgE,CAAC"}

package/esm/hooks/useTerminalBloodlineProps.js

@@ -0,0 +1,83 @@
+/**
+ * @author: yanxianliang
+ * @date: 2025-01-17
+ * @desc: Terminal Bloodline Props hooks - 类型化的 props 访问
+ *
+ * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
+ */
+import { useInputProps, useFlowProps, useGetInputProps, useGetFlowProps } from '@rxflow/base';
+
+/**
+ * 获取原始输入 props
+ *
+ * @example
+ * const inputProps = useTerminalBloodlineInputProps();
+ * const root = useTerminalBloodlineInputProps(state => state.root);
+ */
+
+export function useTerminalBloodlineInputProps(selector) {
+  return useInputProps(selector);
+}
+
+/**
+ * 获取转换后的 Flow props
+ *
+ * @example
+ * const flowProps = useTerminalBloodlineFlowProps();
+ * const nodes = useTerminalBloodlineFlowProps(state => state.nodes);
+ */
+
+export function useTerminalBloodlineFlowProps(selector) {
+  return useFlowProps(selector);
+}
+
+/**
+ * 获取原始输入 props 的 getter（非响应式）
+ */
+export var useGetTerminalBloodlineInputProps = function useGetTerminalBloodlineInputProps() {
+  return useGetInputProps();
+};
+
+/**
+ * 获取转换后 Flow props 的 getter（非响应式）
+ */
+export var useGetTerminalBloodlineFlowProps = function useGetTerminalBloodlineFlowProps() {
+  return useGetFlowProps();
+};
+
+// 便捷 hooks
+/**
+ * 获取 root 节点数据
+ */
+export var useTerminalRoot = function useTerminalRoot() {
+  return useTerminalBloodlineInputProps(function (state) {
+    return state.root;
+  });
+};
+
+/**
+ * 获取主题配置
+ */
+export var useTerminalBloodlineTheme = function useTerminalBloodlineTheme() {
+  return useTerminalBloodlineInputProps(function (state) {
+    return state.theme;
+  });
+};
+
+/**
+ * 获取是否允许展开多个
+ */
+export var useAllowExpandMultiples = function useAllowExpandMultiples() {
+  return useTerminalBloodlineInputProps(function (state) {
+    return state.allowExpandMultiples;
+  });
+};
+
+/**
+ * 获取过滤函数
+ */
+export var useOnFilter = function useOnFilter() {
+  return useTerminalBloodlineInputProps(function (state) {
+    return state.onFilter;
+  });
+};

package/esm/hooks/useTerminalCount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTerminalCount.d.ts","sourceRoot":"","sources":["useTerminalCount.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,cAS5B,CAAA"}
+{"version":3,"file":"useTerminalCount.d.ts","sourceRoot":"","sources":["useTerminalCount.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,cAS5B,CAAC"}

package/esm/hooks/useTerminalCount.js

@@ -1,14 +1,14 @@
 /**
  * @author: yanxianliang
  * @date: 2025-10-19 19:24
- * @modified：2025/10/19 19:24 by yanxianliang
+ * @modified：2025/1/17 by yanxianliang
  * @desc: 获取末级节点数量
  *
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
-import { usePropsSelector } from "@rxflow/base";
+import { useFlowProps } from "@rxflow/base";
 export var useTerminalCount = function useTerminalCount() {
-  return usePropsSelector(function (state) {
+  return useFlowProps(function (state) {
     var nodes = state.nodes;
     if (!nodes || nodes.length == 0) {
       return 0;

package/esm/index.d.ts

@@ -4,4 +4,5 @@ declare const TerminalBloodlineFlow: (props: import("react").PropsWithChildren<T
 export default TerminalBloodlineFlow;
 export * from './types';
 export * from './constants';
+export * from './hooks/useTerminalBloodlineProps';
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAA+B,0BAA0B,EAAC,MAAM,SAAS,CAAC;AA0BjF,QAAA,MAAM,qBAAqB,mHA8CzB,CAAA;AAGF,eAAe,qBAAqB,CAAC;AAErC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAAgC,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAkEnF,QAAA,MAAM,qBAAqB,mHAG1B,CAAC;AAEF,eAAe,qBAAqB,CAAC;AAGrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAG5B,cAAc,mCAAmC,CAAC"}

package/esm/index.js

@@ -13,7 +13,8 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 /*
  * @author: yanxianliang
  * @date: 2025-06-01 18:36
- * @desc: 血缘视图
+ * @modified：2025/1/17 by yanxianliang
+ * @desc: 末级血缘视图
  *
  * Copyright (c) 2025 by yanxianliang, All Rights Reserved.
  */
@@ -33,7 +34,8 @@ var fitViewOptions = {
   minZoom: 1,
   maxZoom: 1
 };
-var omitProps = ['root', 'getRelation', 'mode', "allowExpandMultiples", 'onFilter'];
+
+// 内置节点类型
 var innerNodeTypes = [{
   type: 'search',
   hideInLegend: true,
@@ -43,43 +45,57 @@ var innerNodeTypes = [{
   hideInLegend: true,
   component: Pagination
 }];
-var TerminalBloodlineFlow = createFlow(Flow, function (props) {
+
+/**
+ * Props 转换 hook
+ */
+var useTerminalBloodlinePropsTransform = function useTerminalBloodlinePropsTransform(props) {
   var root = props.root,
     nodeTypes = props.nodeTypes,
     onFilter = props.onFilter;
   var setPageIndex = useSetPageIndex();
   var setFilter = useSetFilter();
   var cleanExpandState = useCleanExpandState();
+
+  // 将 root 转换为 nodes
   var nodes = useMemo(function () {
     setPageIndex(1);
     setFilter('');
-    cleanExpandState(); // root 变化，清除所有展开配置
+    cleanExpandState();
     return root ? [cloneDeep(root)] : [];
   }, [root]);
-  var _nodeTypes = useMemo(function () {
+
+  // 包装 nodeTypes
+  var wrappedNodeTypes = useMemo(function () {
     return [].concat(innerNodeTypes, _toConsumableArray((nodeTypes || []).map(function (nodeType) {
       return _objectSpread(_objectSpread({}, nodeType), {}, {
         _component: nodeType.component,
-        // 真实的节点组件
         component: BaseNodeWrapper
       });
     })));
   }, [nodeTypes]);
+
+  // 绑定 onFilter 到 layout
   var layout = useMemo(function () {
     return layoutCells.bind(undefined, onFilter);
-  }, []);
+  }, [onFilter]);
   return _objectSpread(_objectSpread({}, props), {}, {
     edgesFocusable: false,
     fitViewOptions: fitViewOptions,
     autoCenter: true,
     nodes: nodes,
     layout: layout,
-    nodeTypes: _nodeTypes,
-    omitProps: omitProps,
+    nodeTypes: wrappedNodeTypes,
     selectionOnDrag: false,
     nodesDraggable: false
   });
-});
+};
+var TerminalBloodlineFlow = createFlow(Flow, useTerminalBloodlinePropsTransform);
 export default TerminalBloodlineFlow;
+
+// 类型导出
 export * from "./types";
-export * from "./constants";
+export * from "./constants";
+
+// Hooks 导出
+export * from "./hooks/useTerminalBloodlineProps";

package/esm/nodes/Search/index.js

@@ -16,7 +16,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  */
 
 import SearchOutlined from "@ant-design/icons/lib/icons/SearchOutlined";
-import { useGetProps } from "@rxflow/base";
+import { useGetInputProps } from "@rxflow/base";
 import { Button, Input, message } from 'antd';
 import "./index.less";
 import { useCallback, useState } from "react";
@@ -39,7 +39,7 @@ export var Search = function Search() {
     open = _useState2[0],
     setOpen = _useState2[1];
   var getTerminalList = useGetTerminalList();
-  var getProps = useGetProps();
+  var getInputProps = useGetInputProps();
   var _message$useMessage = message.useMessage(),
     _message$useMessage2 = _slicedToArray(_message$useMessage, 2),
     messageApi = _message$useMessage2[0],
@@ -50,7 +50,7 @@ export var Search = function Search() {
   }, []);
   var onSearch = useCallback(function (value) {
     var list = getTerminalList();
-    var onFilter = getProps().onFilter || defaultFilter;
+    var onFilter = getInputProps().onFilter || defaultFilter;
     var hasItem = list.find(function (item) {
       var data = item.data;
       return onFilter(data, value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rxflow/terminal-bloodline",
-  "version": "0.0.3",
+  "version": "0.0.4-alpha.1",
   "description": "末级血缘关系图",
   "homepage": "https://tree-graph.publib.cn/packages/terminal-bloodline",
   "repository": {
@@ -31,7 +31,7 @@
     "build": "father build"
   },
   "dependencies": {
-    "@rxflow/base": "^0.0.3",
+    "@rxflow/base": "^0.0.4-alpha.1",
     "antd": "^5.0.0"
   },
   "peerDependencies": {