fuxi-topology 0.2.8 → 0.3.8

package/dist/action/definitions.d.ts

@@ -0,0 +1,12 @@
+import { ActionDef } from './types';
+declare const GLOBAL: ActionDef[];
+declare const SCENE: ActionDef[];
+declare const OBJECT: ActionDef[];
+declare const OBJECT_GROUP: ActionDef[];
+/** 所有动作定义 */
+export declare const ACTION_DEFINITIONS: ActionDef[];
+/** 按 type 索引的动作定义 Map */
+export declare const ACTION_DEF_MAP: Map<string, ActionDef>;
+/** 按维度分组 */
+export declare const ACTION_DEFS_BY_DIMENSION: Record<ActionDef["dimension"], ActionDef[]>;
+export { GLOBAL, SCENE, OBJECT, OBJECT_GROUP };

package/dist/action/handlers.d.ts

@@ -0,0 +1,17 @@
+import { Topology } from '../topology';
+import { ActionHandler } from './types';
+/**
+ * 创建动作类型到处理器函数的映射表
+ *
+ * 每个 handler 通过闭包捕获 topology 实例，调用时只需传入 params。
+ *
+ * @param topology - Topology 实例
+ * @returns Map<string, ActionHandler>
+ *
+ * @example
+ * ```ts
+ * const handlerMap = createHandlerMap(topology);
+ * await handlerMap.get("fitView")!({ sceneId: "main" });
+ * ```
+ */
+export declare function createHandlerMap(topology: Topology): Map<string, ActionHandler>;

package/dist/action/index.d.ts

@@ -0,0 +1,5 @@
+export type { ActionDimension, ActionParamValueType, ActionParamDef, ActionDef, Action, ActionGroup, ActionHandler, ResolvedElement, ResolvedGroup, } from './types';
+export { createHandlerMap } from './handlers';
+export { ACTION_DEFINITIONS, ACTION_DEF_MAP, ACTION_DEFS_BY_DIMENSION } from './definitions';
+export { resolveScene, resolveSceneSafe, resolveElement, resolveElementById, resolveGroup, getElementContainer, findElementById, ELEMENT_TYPES, } from './ref-resolver';
+export { asString, asNumber, asBoolean, asNumberArray, asStringArray, asObject, asArray, } from './utils';

package/dist/action/ref-resolver.d.ts

@@ -0,0 +1,47 @@
+import { Topology } from '../topology';
+import { Scene, SceneItemType } from '../scene/scene';
+import { SceneItem } from '../scene/items';
+import { ResolvedElement, ResolvedGroup } from './types';
+/** 所有支持的元素类型 */
+export declare const ELEMENT_TYPES: SceneItemType[];
+/**
+ * 根据 sceneId 解析 Scene 实例
+ */
+export declare function resolveScene(topology: Topology, sceneId: string): Scene;
+/**
+ * 解析场景（安全版本，返回 undefined 而非抛出）
+ */
+export declare function resolveSceneSafe(topology: Topology, sceneId: string): Scene | undefined;
+/**
+ * 根据 sceneId + elementType + elementId 解析元素实例
+ */
+export declare function resolveElement(topology: Topology, sceneId: string, elementType: SceneItemType, elementId: string): ResolvedElement;
+/**
+ * 根据场景中的元素 ID 自动判断元素类型并返回
+ * 注意：此函数遍历所有容器，效率较低，仅应在无法确定类型时使用
+ */
+export declare function resolveElementById(topology: Topology, sceneId: string, elementId: string): ResolvedElement | undefined;
+/**
+ * 按元素 ID 在整个场景中查找元素（遍历所有容器）
+ * 与 resolveElementById 类似，但额外检查场景是否存在
+ */
+export declare function findElementById(topology: Topology, sceneId: string, elementId: string): ResolvedElement | undefined;
+/**
+ * 根据 sceneId + groupId 解析分组实例
+ */
+export declare function resolveGroup(topology: Topology, sceneId: string, groupId: string): ResolvedGroup;
+/**
+ * 获取元素容器（用于 CRUD 操作）
+ * 返回 Scene 上对应的容器实例（Nodes / Lines / ...）
+ */
+export declare function getElementContainer(scene: Scene, elementType: SceneItemType): {
+    add(options: Record<string, any> & {
+        id: string;
+    }): SceneItem<any>;
+    remove(id: string): void;
+    get(id: string): SceneItem<any> | undefined;
+    update(id: string, updates: Record<string, any>): SceneItem<any> | undefined;
+    has(id: string): boolean;
+    getAll(): SceneItem<any>[];
+    count: number;
+};

package/dist/action/types.d.ts

@@ -0,0 +1,53 @@
+import { Scene, SceneItemType } from '../scene/scene';
+import { GroupElement } from '../scene/layer-manager';
+import { SceneItem } from '../scene/items';
+/** 动作四维划分 */
+export type ActionDimension = "global" | "scene" | "object" | "objectGroup";
+/** 参数值类型 */
+export type ActionParamValueType = "string" | "number" | "boolean" | "number-array" | "string-array" | "select" | "color" | "element-type" | "scene-ref" | "element-ref" | "group-ref";
+/** 参数定义 —— 描述一个参数的元信息 */
+export interface ActionParamDef {
+    name: string;
+    label: string;
+    valueType: ActionParamValueType;
+    required?: boolean;
+    default?: unknown;
+    options?: {
+        label: string;
+        value: string;
+    }[];
+    placeholder?: string;
+}
+/** 动作定义 —— 描述一类动作的元信息 */
+export interface ActionDef {
+    type: string;
+    label: string;
+    dimension: ActionDimension;
+    description: string;
+    params: ActionParamDef[];
+}
+/** 动作实例 —— 用户配置的具体动作 */
+export interface Action {
+    id: string;
+    type: string;
+    params: Record<string, unknown>;
+}
+/** 动作容器 —— 一个命名的动作集合 */
+export interface ActionGroup {
+    id: string;
+    name: string;
+    actions: Action[];
+}
+/** 动作处理器函数签名 */
+export type ActionHandler = (params: Record<string, unknown>) => Promise<void>;
+/** 解析后的元素引用 */
+export interface ResolvedElement {
+    scene: Scene;
+    elementType: SceneItemType;
+    item: SceneItem<any>;
+}
+/** 解析后的分组引用 */
+export interface ResolvedGroup {
+    scene: Scene;
+    group: GroupElement;
+}

package/dist/action/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 将 params 中的值安全转为 string
+ */
+export declare function asString(v: unknown, fallback?: string): string;
+/**
+ * 将 params 中的值安全转为 number
+ */
+export declare function asNumber(v: unknown, fallback?: number): number | undefined;
+/**
+ * 将 params 中的值安全转为 boolean
+ */
+export declare function asBoolean(v: unknown, fallback?: boolean): boolean;
+/**
+ * 将 params 中的值安全转为 number[]
+ */
+export declare function asNumberArray(v: unknown): number[];
+/**
+ * 将 params 中的值安全转为 string[]
+ */
+export declare function asStringArray(v: unknown): string[];
+/**
+ * 将 params 中的值安全转为 object（可能是 JSON 字符串）
+ */
+export declare function asObject(v: unknown): Record<string, any>;
+/**
+ * 将 params 中的值安全转为数组（可能是 JSON 字符串）
+ */
+export declare function asArray(v: unknown): any[];