@easy-editor/core 1.0.1 → 1.0.3

package/dist/materials/component-meta.d.ts

@@ -1,12 +1,15 @@
 import type { Designer } from '../designer';
-import type { ComponentMetadata } from '../types';
+import type { ComponentMetadata, NpmInfo } from '../types';
 export declare enum COMPONENT_META_EVENT {
     CHANGE = "componentMeta:metadata.change"
 }
 export declare class ComponentMeta {
     readonly designer: Designer;
     readonly isComponentMeta = true;
+    private _npm?;
     private emitter;
+    get npm(): any;
+    set npm(_npm: any);
     private _componentName?;
     get componentName(): string;
     private _isContainer?;
@@ -23,10 +26,21 @@ export declare class ComponentMeta {
     get advanced(): import("..").Advanced;
     get snippets(): import("..").Snippet[];
     constructor(designer: Designer, metadata: ComponentMetadata);
+    setNpm(info: NpmInfo): void;
     private parseMetadata;
     refreshMetadata(): void;
     setMetadata(metadata: ComponentMetadata): void;
     getMetadata(): ComponentMetadata;
     onMetadataChange(fn: (args: any) => void): () => void;
+    /**
+     * 销毁 ComponentMeta，清理事件监听器
+     */
+    dispose(): void;
+    /**
+     * 判断当前节点是否为远程物料组件
+     * 远程物料是指通过 CDN 或 NPM 动态加载的组件，而非内置组件
+     * @returns boolean 是否为远程物料
+     */
+    isRemoteMaterial(): boolean;
 }
 export declare function isComponentMeta(obj: any): obj is ComponentMeta;

package/dist/materials/index.d.ts

@@ -1,2 +1,3 @@
 export * from './component-meta';
 export * from './materials';
+export * from './registry';

package/dist/materials/materials.d.ts

@@ -1,24 +1,74 @@
 import type { Designer } from '../designer';
 import type { Component, ComponentMetadata, Editor } from '../types';
-import { ComponentMeta } from './component-meta';
+import { type ComponentMeta } from './component-meta';
+import { MaterialRegistry, type RegisterOptions } from './registry';
 export declare class Materials {
     readonly editor: Editor;
-    private accessor _componentMetasMap;
-    private _lostComponentMetasMap;
+    /** 物料注册表（新架构核心） */
+    private _registry;
     get designer(): Designer;
+    /** 获取物料注册表 */
+    get registry(): MaterialRegistry;
+    /** 获取版本号（用于缓存失效） */
+    get version(): number;
     constructor(editor: Editor);
+    /**
+     * 批量构建组件元数据
+     */
     buildComponentMetasMap: (metas: ComponentMetadata[]) => void;
-    createComponentMeta(data: ComponentMetadata): ComponentMeta | null;
+    /**
+     * 创建或更新组件元数据
+     */
+    createComponentMeta(data: ComponentMetadata, options?: RegisterOptions): ComponentMeta | null;
+    /**
+     * 移除组件元数据
+     * @deprecated 推荐使用 registry.unload() 并检查使用情况
+     */
+    removeComponentMeta(componentName: string): boolean;
+    /**
+     * 获取组件元数据（带懒加载）
+     */
     getComponentMeta(componentName: string, generateMetadata?: () => ComponentMetadata | null): ComponentMeta;
-    getComponentSnippets(): import("..").Snippet[];
+    /**
+     * 获取所有代码片段
+     */
+    getComponentSnippets(): unknown[];
+    /**
+     * 获取组件元数据映射（Map）
+     */
     getComponentMetasMap(): Map<string, ComponentMeta>;
+    /**
+     * 组件元数据映射（Record）
+     */
     get componentMetasMap(): Record<string, ComponentMetadata>;
+    /**
+     * 组件实现映射
+     */
     get componentsMap(): {
         [key: string]: Component;
     };
     /**
-     * 刷新 componentMetasMap，可间接触发模拟器里的 buildComponents
+     * 刷新映射，触发依赖更新
      */
     refreshComponentMetasMap(): void;
-    isComponentMeta(obj: any): obj is ComponentMeta;
+    /**
+     * 增加组件使用计数
+     */
+    incrementUsage(componentName: string): void;
+    /**
+     * 减少组件使用计数
+     */
+    decrementUsage(componentName: string): void;
+    /**
+     * 检查组件是否可以安全卸载
+     */
+    canUnload(componentName: string): boolean;
+    /**
+     * 检查是否为 ComponentMeta
+     */
+    isComponentMeta(obj: unknown): obj is ComponentMeta;
+    /**
+     * 销毁 Materials 实例
+     */
+    dispose(): void;
 }

package/dist/materials/registry/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Material Registry Module
+ * 物料注册表模块导出
+ */
+export { MaterialRegistry } from './material-registry';
+export { type IMaterialRegistry, type MaterialEntry, MaterialSource, MaterialStatus, type RegisterOptions, type RegistryEvent, RegistryEventType, type RegistryEventListener, type UnloadOptions, } from './types';

package/dist/materials/registry/material-registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Material Registry Implementation
+ * 物料注册表实现
+ */
+import type { Designer } from '../../designer';
+import type { ComponentMetadata } from '../../types';
+import { ComponentMeta } from '../component-meta';
+import { type IMaterialRegistry, type MaterialEntry, MaterialSource, type RegisterOptions, type RegistryEventListener, type UnloadOptions } from './types';
+/**
+ * 物料注册表
+ * 统一管理所有物料的注册、卸载、状态追踪
+ */
+export declare class MaterialRegistry implements IMaterialRegistry {
+    private readonly designer;
+    /** 物料条目映射 */
+    private accessor entries;
+    /** 待激活物料（懒加载时创建的占位） */
+    private accessor pendingEntries;
+    /** 版本号（用于触发依赖更新） */
+    private accessor _version;
+    /** 事件监听器 */
+    private listeners;
+    /** 是否已销毁 */
+    private disposed;
+    constructor(designer: Designer);
+    /** 获取版本号 */
+    get version(): number;
+    /**
+     * 验证组件名称
+     */
+    private validateComponentName;
+    /**
+     * 发送事件
+     */
+    private emit;
+    /**
+     * 创建物料条目
+     */
+    private createEntry;
+    register(metadata: ComponentMetadata, options?: RegisterOptions): ComponentMeta;
+    unload(componentName: string, options?: UnloadOptions): Promise<boolean>;
+    get(componentName: string): MaterialEntry | undefined;
+    getOrCreate(componentName: string, generateMetadata?: () => ComponentMetadata | null): ComponentMeta;
+    has(componentName: string): boolean;
+    incrementUsage(componentName: string): void;
+    decrementUsage(componentName: string): void;
+    canUnload(componentName: string): boolean;
+    subscribe(listener: RegistryEventListener): () => void;
+    getAll(): Map<string, MaterialEntry>;
+    getBySource(source: MaterialSource): MaterialEntry[];
+    refresh(): void;
+    /** 获取所有组件元数据映射 */
+    get componentMetasMap(): Record<string, ComponentMetadata>;
+    /** 获取所有组件映射 */
+    get componentsMap(): Record<string, unknown>;
+    /** 获取所有代码片段 */
+    getComponentSnippets(): unknown[];
+    dispose(): void;
+}

package/dist/materials/registry/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Material Registry Types
+ * 物料注册表类型定义
+ */
+import type { Component, ComponentMetadata } from '../../types';
+import type { ComponentMeta } from '../component-meta';
+/** 物料状态 */
+export declare enum MaterialStatus {
+    /** 加载中 */
+    LOADING = "loading",
+    /** 已注册（元数据已加载） */
+    REGISTERED = "registered",
+    /** 活跃（组件已加载且可用） */
+    ACTIVE = "active",
+    /** 卸载中 */
+    UNLOADING = "unloading",
+    /** 错误状态 */
+    ERROR = "error"
+}
+/** 物料来源 */
+export declare enum MaterialSource {
+    /** 内置物料（打包时包含） */
+    BUILTIN = "builtin",
+    /** 远程物料（CDN/NPM） */
+    REMOTE = "remote",
+    /** 本地调试物料 */
+    DEBUG = "debug"
+}
+/** 物料条目 */
+export interface MaterialEntry {
+    /** 组件名称（唯一标识） */
+    componentName: string;
+    /** 物料状态 */
+    status: MaterialStatus;
+    /** 物料来源 */
+    source: MaterialSource;
+    /** 组件元数据包装 */
+    meta: ComponentMeta;
+    /** 组件实现（可选，懒加载时可能未加载） */
+    component?: Component;
+    /** 版本号（远程物料） */
+    version?: string;
+    /** 加载时间戳 */
+    loadedAt: number;
+    /** 最后访问时间戳 */
+    lastAccessedAt: number;
+    /** 使用计数（画布上的实例数） */
+    usageCount: number;
+    /** 扩展数据 */
+    extensions?: Map<string, unknown>;
+}
+/** 注册选项 */
+export interface RegisterOptions {
+    /** 物料来源 */
+    source?: MaterialSource;
+    /** 版本号 */
+    version?: string;
+    /** 组件实现 */
+    component?: Component;
+    /** 是否覆盖已存在的物料 */
+    override?: boolean;
+}
+/** 卸载选项 */
+export interface UnloadOptions {
+    /** 强制卸载（即使有使用中的实例） */
+    force?: boolean;
+}
+/** 注册表事件类型 */
+export declare enum RegistryEventType {
+    /** 物料注册 */
+    REGISTERED = "registered",
+    /** 物料更新 */
+    UPDATED = "updated",
+    /** 物料卸载 */
+    UNLOADED = "unloaded",
+    /** 状态变更 */
+    STATUS_CHANGED = "status_changed",
+    /** 使用计数变更 */
+    USAGE_CHANGED = "usage_changed",
+    /** 错误 */
+    ERROR = "error"
+}
+/** 注册表事件 */
+export interface RegistryEvent {
+    type: RegistryEventType;
+    componentName: string;
+    entry?: MaterialEntry;
+    previousStatus?: MaterialStatus;
+    error?: Error;
+    timestamp: number;
+}
+/** 注册表事件监听器 */
+export type RegistryEventListener = (event: RegistryEvent) => void;
+/** 物料注册表接口 */
+export interface IMaterialRegistry {
+    /**
+     * 注册物料
+     * @param metadata 组件元数据
+     * @param options 注册选项
+     * @returns ComponentMeta 实例
+     */
+    register(metadata: ComponentMetadata, options?: RegisterOptions): ComponentMeta;
+    /**
+     * 卸载物料
+     * @param componentName 组件名称
+     * @param options 卸载选项
+     * @returns 是否成功卸载
+     */
+    unload(componentName: string, options?: UnloadOptions): Promise<boolean>;
+    /**
+     * 获取物料条目
+     * @param componentName 组件名称
+     */
+    get(componentName: string): MaterialEntry | undefined;
+    /**
+     * 获取或创建物料（懒加载）
+     * @param componentName 组件名称
+     * @param generateMetadata 元数据生成函数
+     */
+    getOrCreate(componentName: string, generateMetadata?: () => ComponentMetadata | null): ComponentMeta;
+    /**
+     * 检查物料是否存在
+     * @param componentName 组件名称
+     */
+    has(componentName: string): boolean;
+    /**
+     * 增加使用计数
+     * @param componentName 组件名称
+     */
+    incrementUsage(componentName: string): void;
+    /**
+     * 减少使用计数
+     * @param componentName 组件名称
+     */
+    decrementUsage(componentName: string): void;
+    /**
+     * 检查物料是否可以安全卸载
+     * @param componentName 组件名称
+     */
+    canUnload(componentName: string): boolean;
+    /**
+     * 订阅注册表事件
+     * @param listener 事件监听器
+     * @returns 取消订阅函数
+     */
+    subscribe(listener: RegistryEventListener): () => void;
+    /**
+     * 获取所有物料条目
+     */
+    getAll(): Map<string, MaterialEntry>;
+    /**
+     * 获取按来源分组的物料
+     * @param source 物料来源
+     */
+    getBySource(source: MaterialSource): MaterialEntry[];
+    /**
+     * 获取版本号（用于缓存失效）
+     */
+    readonly version: number;
+    /**
+     * 刷新版本号（触发依赖更新）
+     */
+    refresh(): void;
+    /**
+     * 销毁注册表
+     */
+    dispose(): void;
+}

package/dist/remote/core/errors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Remote Load Errors
+ * 远程资源加载统一错误定义
+ */
+/** 远程资源加载错误类型 */
+export declare enum RemoteLoadErrorType {
+    /** 网络错误 */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** 包不存在 */
+    PACKAGE_NOT_FOUND = "PACKAGE_NOT_FOUND",
+    /** 版本不存在 */
+    VERSION_NOT_FOUND = "VERSION_NOT_FOUND",
+    /** 脚本加载失败 */
+    SCRIPT_LOAD_FAILED = "SCRIPT_LOAD_FAILED",
+    /** CSS 加载失败 */
+    CSS_LOAD_FAILED = "CSS_LOAD_FAILED",
+    /** 全局变量未找到 */
+    GLOBAL_NOT_FOUND = "GLOBAL_NOT_FOUND",
+    /** 元数据格式无效 */
+    METADATA_INVALID = "METADATA_INVALID",
+    /** 所有 CDN 都失败 */
+    CDN_ALL_FAILED = "CDN_ALL_FAILED",
+    /** 加载超时 */
+    TIMEOUT = "TIMEOUT"
+}
+/** 资源类型 */
+export type ResourceType = 'material' | 'setter';
+/**
+ * 远程资源加载错误
+ */
+export declare class RemoteLoadError extends Error {
+    /** 错误类型 */
+    readonly type: RemoteLoadErrorType;
+    /** 资源名称（包名或全局变量名） */
+    readonly resourceName: string;
+    /** 资源类型 */
+    readonly resourceType: ResourceType;
+    /** 原始错误 */
+    readonly originalError?: unknown | undefined;
+    readonly name = "RemoteLoadError";
+    constructor(
+    /** 错误类型 */
+    type: RemoteLoadErrorType, 
+    /** 资源名称（包名或全局变量名） */
+    resourceName: string, 
+    /** 资源类型 */
+    resourceType: ResourceType, 
+    /** 错误消息 */
+    message: string, 
+    /** 原始错误 */
+    originalError?: unknown | undefined);
+    /**
+     * 获取用户友好的错误消息
+     */
+    toUserMessage(): string;
+    /**
+     * 创建错误实例的便捷方法
+     */
+    static create(type: RemoteLoadErrorType, resourceName: string, resourceType: ResourceType, message?: string, originalError?: unknown): RemoteLoadError;
+}

package/dist/remote/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Remote Core Module
+ * 远程资源加载核心模块导出（纯类型和错误定义，无浏览器依赖）
+ */
+export { RemoteLoadError, RemoteLoadErrorType, type ResourceType } from './errors';
+export type { LoadOptions, LoadProgress, MaterialInfo, SetterInfo } from './types';
+export { DEFAULT_TIMEOUT, LoadingStatus } from './types';

package/dist/remote/core/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Remote Load Types
+ * 远程资源加载公共类型定义（纯 TypeScript，无浏览器依赖）
+ */
+import type { NpmInfo } from '../../types/npm-info';
+import type { ResourceType } from './errors';
+/** 加载状态枚举 */
+export declare enum LoadingStatus {
+    /** 空闲 */
+    IDLE = "idle",
+    /** 加载中 */
+    LOADING = "loading",
+    /** 已加载 */
+    LOADED = "loaded",
+    /** 错误 */
+    ERROR = "error"
+}
+/**
+ * 物料信息
+ * 继承自 NpmInfo，添加远程加载所需的额外字段
+ */
+export interface MaterialInfo extends NpmInfo {
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/**
+ * 设置器信息
+ */
+export interface SetterInfo {
+    /** NPM 包名 */
+    package: string;
+    /** 版本号 */
+    version?: string;
+    /** UMD 全局变量名 */
+    globalName: string;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/** 加载选项（不包含浏览器特定内容） */
+export interface LoadOptions {
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 是否使用缓存 */
+    useCache?: boolean;
+    /** 是否加载 CSS */
+    loadCSS?: boolean;
+}
+/** 加载进度信息 */
+export interface LoadProgress {
+    /** 资源类型 */
+    type: ResourceType;
+    /** 资源名称 */
+    name: string;
+    /** 当前阶段 */
+    stage: 'resolving' | 'loading' | 'parsing' | 'registering';
+    /** 进度百分比 (0-100) */
+    percent: number;
+}
+/** 默认超时时间（毫秒） */
+export declare const DEFAULT_TIMEOUT = 30000;

package/dist/remote/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remote Module
+ * 远程资源加载模块统一导出
+ */
+export * from './core';
+export * from './state';

package/dist/remote/state/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remote State Module
+ * 远程资源状态管理模块导出
+ */
+export { LoadingStateManager, LoadingStatus, loadingState, type ResourceState, type StateChangeListener, } from './loading-state';
+export { ResourceRegistry, resourceRegistry, type LoadedResource } from './resource-registry';

package/dist/remote/state/loading-state.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Loading State Manager
+ * 远程资源加载状态管理器
+ */
+import type { ResourceType } from '../core/errors';
+import { LoadingStatus } from '../core/types';
+export { LoadingStatus };
+/** 资源状态条目 */
+export interface ResourceState {
+    /** 资源类型 */
+    type: ResourceType;
+    /** 资源名称（包名） */
+    name: string;
+    /** 加载状态 */
+    status: LoadingStatus;
+    /** 进度百分比 (0-100) */
+    progress?: number;
+    /** 错误信息 */
+    error?: Error;
+    /** 加载完成时间 */
+    loadedAt?: number;
+}
+/** 状态变化监听器 */
+export type StateChangeListener = (states: Map<string, ResourceState>) => void;
+/**
+ * 加载状态管理器
+ * 使用 MobX 管理远程资源的加载状态
+ */
+export declare class LoadingStateManager {
+    /** 资源状态映射 */
+    private accessor states;
+    /** 状态变化监听器 */
+    private listeners;
+    /**
+     * 是否有资源正在加载
+     */
+    get isLoading(): boolean;
+    /**
+     * 获取所有正在加载的资源
+     */
+    get loadingResources(): ResourceState[];
+    /**
+     * 获取所有错误
+     */
+    get errors(): ResourceState[];
+    /**
+     * 获取所有已加载的资源
+     */
+    get loadedResources(): ResourceState[];
+    /**
+     * 获取指定类型的加载状态
+     */
+    isTypeLoading(type: ResourceType): boolean;
+    /**
+     * 获取资源状态
+     */
+    getState(key: string): ResourceState | undefined;
+    /**
+     * 更新资源状态
+     */
+    updateState(key: string, state: Partial<ResourceState>): void;
+    /**
+     * 开始加载资源
+     */
+    startLoading(key: string, type: ResourceType, name: string): void;
+    /**
+     * 更新加载进度
+     */
+    updateProgress(key: string, progress: number): void;
+    /**
+     * 标记加载完成
+     */
+    markLoaded(key: string): void;
+    /**
+     * 标记加载错误
+     */
+    markError(key: string, error: Error): void;
+    /**
+     * 清除资源状态
+     */
+    clearState(key: string): void;
+    /**
+     * 清除所有状态
+     */
+    clearAll(): void;
+    /**
+     * 等待所有资源加载完成
+     */
+    waitForAll(timeout?: number): Promise<void>;
+    /**
+     * 等待指定类型资源加载完成
+     */
+    waitForType(type: ResourceType, timeout?: number): Promise<void>;
+    /**
+     * 订阅状态变化
+     */
+    subscribe(listener: StateChangeListener): () => void;
+    /**
+     * 等待条件满足
+     */
+    private waitFor;
+    /**
+     * 通知所有监听器
+     */
+    private notifyListeners;
+}
+/** 导出单例 */
+export declare const loadingState: LoadingStateManager;

package/dist/remote/state/resource-registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Resource Registry
+ * 已加载资源注册表
+ */
+import type { ResourceType } from '../core/errors';
+/** 已加载资源条目 */
+export interface LoadedResource<T = unknown> {
+    /** 资源类型 */
+    type: ResourceType;
+    /** 资源名称（包名） */
+    name: string;
+    /** 版本号 */
+    version: string;
+    /** UMD 全局变量名 */
+    globalName: string;
+    /** 资源数据 */
+    data: T;
+    /** 加载完成时间 */
+    loadedAt: number;
+}
+/**
+ * 资源注册表
+ * 管理已加载的远程资源
+ */
+export declare class ResourceRegistry {
+    /** 物料资源 */
+    private accessor materials;
+    /** 设置器资源 */
+    private accessor setters;
+    /**
+     * 获取所有物料数量
+     */
+    get materialCount(): number;
+    /**
+     * 获取所有设置器数量
+     */
+    get setterCount(): number;
+    /**
+     * 注册资源
+     */
+    register<T>(resource: LoadedResource<T>): void;
+    /**
+     * 获取资源
+     */
+    get<T>(type: ResourceType, name: string): LoadedResource<T> | undefined;
+    /**
+     * 检查资源是否已加载
+     */
+    has(type: ResourceType, name: string): boolean;
+    /**
+     * 卸载资源
+     */
+    unload(type: ResourceType, name: string): boolean;
+    /**
+     * 获取所有资源
+     */
+    getAll(type?: ResourceType): LoadedResource[];
+    /**
+     * 获取所有物料名称
+     */
+    getMaterialNames(): string[];
+    /**
+     * 获取所有设置器名称
+     */
+    getSetterNames(): string[];
+    /**
+     * 清除指定类型的所有资源
+     */
+    clearType(type: ResourceType): void;
+    /**
+     * 清除所有资源
+     */
+    clearAll(): void;
+    /**
+     * 获取资源映射
+     */
+    private getMap;
+}
+/** 导出单例 */
+export declare const resourceRegistry: ResourceRegistry;