@anov/cic-standard-sdk 0.0.1 → 0.0.2

package/README.md

@@ -30,16 +30,9 @@ CIC-Standard-1.0/
 └── vite.config.ts      # Vite 构建配置
 ```
 
-## 1. 协议核心概念
+## 1. 简介
 
-CIC 协议通过 JSON 描述一个完整的应用页面结构与行为：
-
-- **Config**: 全局配置根节点，包含页面列表、全局变量、资源依赖等。
-- **Page**: 页面定义，包含布局配置、组件树、页面级数据源。
-- **Component**: 组件实例，分为 View (视图)、Container (容器)、Logic (逻辑) 三类。
-- **Event**: 强大的事件 DSL，支持变量操作、页面跳转、组件控制、自定义脚本等，支持条件执行与调度（Order/Delay）。
-- **Variable**: 多级作用域（Global > Page > Component）的变量管理，支持 string/number/object/array/function。
-- **DataSource**: 统一的数据源定义（REST, WebSocket, Static），支持轮询与依赖。
+提供 CIC 标准的 TypeScript 类型与 SDK，支持 JSON Schema 校验、页面/组件/数据源等核心能力，适用于发布后的使用者。
 
 ## 2. SDK 使用指南
 
@@ -50,12 +43,12 @@ SDK 提供了操作 CIC 标准的常用工具方法，现已重构为面向对
 推荐使用 `pnpm` 安装依赖：
 
 ```bash
-pnpm install cic-standard-sdk
+pnpm add @anov/cic-standard-sdk
 ```
 
 ```typescript
-import { CICSDK } from 'cic-standard-sdk';
-import { CICConfig } from 'cic-standard-sdk/types';
+import { CICSDK } from '@anov/cic-standard-sdk'
+import { CICConfig } from '@anov/cic-standard-sdk/types';
 
 const config: CICConfig = { ... };
 const sdk = new CICSDK(config); // 实例化时自动执行 Schema 校验
@@ -63,7 +56,7 @@ const sdk = new CICSDK(config); // 实例化时自动执行 Schema 校验
 
 ### 常用 API
 
-**1. 验证配置**（`sdk/CICSDK.ts:174`）
+**1. 验证配置**
 
 SDK 集成了完整的 JSON Schema (Draft-07)，可验证字段类型、必填项、枚举值等。
 
@@ -83,7 +76,7 @@ try {
 }
 ```
 
-**2. 查找组件**（`sdk/CICSDK.ts:47`、`sdk/CICSDK.ts:62`）
+**2. 查找组件**
 
 ```typescript
 // 按 ID 查找（支持跨页面）
@@ -97,7 +90,7 @@ const page = sdk.findPageByComponent('comp_btn_01')
 console.log('所在页面:', page?.id)
 ```
 
-**3. 获取变量值（自动处理作用域）**（`sdk/CICSDK.ts:80`、`sdk/CICSDK.ts:109`）
+**3. 获取变量值（自动处理作用域）**
 
 ```typescript
 // 优先查找组件级 -> 页面级 -> 全局
@@ -107,7 +100,7 @@ const val = sdk.getVariable({ pageId: 'p1', componentId: 'c1' }, 'theme')
 const val2 = sdk.getVariableByRef('global.theme')
 ```
 
-**4. 遍历组件树**（`sdk/CICSDK.ts:125`、`sdk/CICSDK.ts:220`）
+**4. 遍历组件树**
 
 ```typescript
 // 遍历整个配置的所有组件
@@ -118,7 +111,7 @@ sdk.walkComponents((comp, page, parent) => {
 })
 ```
 
-**5. 静态工具**（`sdk/CICSDK.ts:199`、`sdk/CICSDK.ts:220`）
+**5. 静态工具**
 
 ### 生成器 API（严格校验 + 规范化）
 
@@ -143,30 +136,22 @@ CICSDK.traverseTree(someComponent, c => {
 })
 ```
 
-## 3. 开发与测试
-
-本项目使用 Vite 进行构建，Vitest 进行单元测试，推荐使用 `pnpm` 管理依赖。
-
-### 命令脚本
-
-- `pnpm install`: 安装依赖
-- `pnpm run dev`: 启动开发模式
-- `pnpm run build`: 构建 SDK（输出 `dist/`）
-- `pnpm test`: 运行单元测试
+## 3. 构建与类型
 
 ### 构建产物
 
-- `dist/cic-sdk.es.js`: ESM 格式，适用于现代前端项目（Vite/Webpack）。
-- `dist/cic-sdk.cjs.js`: CJS 格式，适用于 Node.js `require`。
-- `dist/cic-sdk.umd.js`: UMD 格式，适用于 `<script>` 引入。
+- `dist/cic-sdk.es.js`（ESM）
+- `dist/cic-sdk.cjs.js`（CJS）
+- `dist/cic-sdk.umd.js`（UMD）
+- 类型声明：`dist/sdk/CICSDK.d.ts`
 
-在 `package.json` 中已配置 `exports` 字段与 `sideEffects: false`，支持 Tree‑shaking 与正确的导入解析。
+`package.json` 设置了 `sideEffects: false` 并使用 `exports` 指定导入/require 入口，方便 Tree‑shaking。
 
 ## 4. JSON Schema 校验
 
 `schema/cic.schema.json` 提供了完整的协议约束。
 
-### 在 VS Code 中启用智能提示
+### VS Code 智能提示
 
 在你的 JSON 配置文件头部添加 `$schema` 字段：
 
@@ -184,7 +169,7 @@ CICSDK.traverseTree(someComponent, c => {
 - 枚举值提示（如 `type`: `view` | `container`）
 - 结构校验（必填字段检查）
 
-### 常见报错与排查
+### 报错与排查
 
 - Ajv 错误输出包含 `instancePath`：根据路径定位到具体字段（如 `/pages/0/components/1/role must be equal to constant`）。
 - 组件判别联合：`view` 必须提供 `component`；`container` 必须提供 `children`；`logic` 必须提供 `component`（`LogicRef`）。
@@ -196,34 +181,9 @@ CICSDK.traverseTree(someComponent, c => {
 - 按需引入：仅从 `CICSDK` 静态导出使用所需生成器函数，减少打包体积。
 - ID 规范：通过生成器的 `generateId` 自动生成 `uuid`，避免冲突。
 
-## 5. Schema 与 Mock 脚本
-
-### Schema 生成脚本（`scripts/generate-schema.ts`）
-
-- 通过配置项裁剪复杂度、保留必要字段，输出更简洁可用的 JSON Schema。
-
-### Mock 生成与清洗（`scripts/generate-mock.ts`）
-
-- 基于 Schema 随机生成后，使用 `deepClean` 进行规范化：
-  - 修正非法数组项、补齐 `id`（uuid）、规范 `url`/`ws` 链接。
-  - 为 `code` 字段提供可执行的默认实现。
-
-示例输出能直接通过 Ajv 校验并用于演示与测试。
-
-## 5. 示例说明
-
-请查看 `examples/full-demo.json`，它展示了：
-
-- 如何定义全局主题变量。
-- 如何引入外部 ECharts 库与字体资源。
-- 如何配置 REST 数据源。
-- 如何构建包含图表与按钮的组件树。
-- 如何通过点击事件触发变量更新与自定义逻辑。
-
-## 安全声明
+## 5. 许可与版本
 
-CIC 允许执行动态代码（Custom Events, Logic Components）。在生产环境中渲染不可信的 CIC 配置时，请务必：
+- 语义化版本（SemVer）发布
+- 请在 issue 中反馈使用问题与建议
 
-1. 使用 iframe 或 Web Worker 隔离渲染环境。
-2. 限制代码执行的上下文访问权限。
-3. 对 `CustomRemoteEvent` 加载的外部脚本进行域名白名单控制。
+（本 README 为发布版自述，专注使用信息；开发演示与内部脚本说明已省略。）

package/dist/sdk/CICSDK.d.ts

@@ -0,0 +1,71 @@
+import { CICConfig } from '../types';
+import { ComponentInstance } from '../types/componets';
+import { ICICSDK } from './ICICSDK';
+import { CICPage } from '../types/page';
+/**
+ * CIC SDK 类
+ * 提供对 CIC 配置的封装访问与操作
+ */
+export declare class CICSDK implements ICICSDK {
+    private config;
+    private static validator;
+    private static validate;
+    private static schemaHash;
+    constructor(config: CICConfig);
+    getConfig(): CICConfig;
+    findComponent(id: string): ComponentInstance | undefined;
+    findPageByComponent(componentId: string): CICPage | undefined;
+    getVariable(scopeContext: {
+        pageId?: string;
+        componentId?: string;
+    }, key: string): any;
+    getVariableByRef(ref: string): any;
+    walkComponents(callback: (component: ComponentInstance, page: CICPage, parent?: ComponentInstance) => void | boolean): void;
+    /**
+     * 全面配置校验 (基于 JSON Schema)
+     */
+    static validateConfig(config: CICConfig): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * 按路径获取对象值（支持 a.b[0].c 语法）
+     */
+    static getValueByPath(obj: any, path: string, fallback?: any): any;
+    /**
+     * 深度遍历组件树（纯函数递归版本）
+     * 用于单独处理某个组件树片段
+     */
+    static traverseTree(root: ComponentInstance | ComponentInstance[], callback: (component: ComponentInstance, parent?: ComponentInstance) => void | boolean, parent?: ComponentInstance): void;
+    /** 创建 DataSource */
+    static createDataSource: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types/dataSources").DataSourceItem>;
+    static validateDataSource: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeDataSource: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types/dataSources").DataSourceItem;
+    /** 创建 Component */
+    static createComponent: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<ComponentInstance>;
+    static validateComponent: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeComponent: (input: unknown, options?: import("./generators/common").CreateOptions) => ComponentInstance;
+    /** 创建 Page */
+    static createPage: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<CICPage>;
+    static validatePage: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizePage: (input: unknown, options?: import("./generators/common").CreateOptions) => CICPage;
+    /** 创建 Meta/Layout */
+    static createMeta: (input: unknown) => import("./generators/common").Result<import("../types/meta").MetaInfo>;
+    static createLayout: (input: unknown) => import("./generators/common").Result<import("../types/meta").LayoutConfig>;
+    static validateMeta: (input: unknown) => import("./generators/common").Result<null>;
+    static validateLayout: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeMeta: (input: unknown) => import("../types/meta").MetaInfo;
+    static normalizeLayout: (input: unknown) => import("../types/meta").LayoutConfig;
+    /** 创建 Variables */
+    static createVariables: (input: unknown) => import("./generators/common").Result<import("../types/variables").Variables>;
+    static validateVariables: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeVariables: (input: unknown) => import("../types/variables").Variables;
+    /** 创建 Dependency */
+    static createDependency: (input: unknown) => import("./generators/common").Result<import("../types/deps").Dependency>;
+    static validateDependency: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeDependency: (input: unknown) => import("../types/deps").Dependency;
+    /** 创建 Registry 组件项 */
+    static createRegistryComponent: (input: unknown) => import("./generators/common").Result<import("../types/registry").RegistryComponents>;
+    static validateRegistryComponent: (input: unknown) => import("./generators/common").Result<null>;
+    static normalizeRegistryComponent: (input: unknown) => import("../types/registry").RegistryComponents;
+}

package/dist/sdk/ICICSDK.d.ts

@@ -0,0 +1,43 @@
+import { CICConfig } from '../types';
+import { CICPage } from '../types/page';
+import { ComponentInstance } from '../types/componets';
+/**
+ * CIC SDK 接口定义
+ * 定义了 SDK 必须提供的核心能力，实现与定义解耦。
+ */
+export interface ICICSDK {
+    /**
+     * 获取当前完整的配置对象
+     */
+    getConfig(): CICConfig;
+    /**
+     * 按 ID 查找组件实例
+     * @param id 组件 ID
+     */
+    findComponent(id: string): ComponentInstance | undefined;
+    /**
+     * 查找组件所属的页面
+     * @param componentId 组件 ID
+     */
+    findPageByComponent(componentId: string): CICPage | undefined;
+    /**
+     * 获取变量值
+     * 遵循作用域链：Component -> Page -> Global
+     * @param scopeContext 作用域上下文 { pageId?, componentId? }
+     * @param key 变量名
+     */
+    getVariable(scopeContext: {
+        pageId?: string;
+        componentId?: string;
+    }, key: string): any;
+    /**
+     * 通过引用字符串获取变量
+     * @param ref 引用字符串 (e.g. "global.theme", "page:p1.title")
+     */
+    getVariableByRef(ref: string): any;
+    /**
+     * 遍历所有组件
+     * @param callback 回调函数，返回 false 可终止遍历
+     */
+    walkComponents(callback: (component: ComponentInstance, page: CICPage, parent?: ComponentInstance) => void | boolean): void;
+}

package/dist/sdk/generators/ajv.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Ajv 单例与子 Schema 校验器
+ * 说明：复用项目主 Schema（Draft-07），按需编译子定义（#/definitions/...）。
+ * 注意：strict 关闭以兼容联合与 const/enum 的复杂组合。
+ */
+import Ajv from 'ajv';
+export declare const getAjv: () => Ajv;
+export declare const getValidator: (ref: string) => any;

package/dist/sdk/generators/common.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 生成器通用工具与类型
+ * 说明：统一 Result/Options 定义与常用规范化工具（uuid/url/数组/数值）。
+ * 原则：严格模式默认不做隐式容错；仅在 defaults 显式提供时才补齐默认值。
+ */
+export type Result<T> = {
+    ok: boolean;
+    value?: T;
+    errors?: any[];
+};
+export type CreateOptions = {
+    defaults?: Record<string, any>;
+    generateId?: boolean;
+    strict?: boolean;
+    throw?: boolean;
+};
+/** 将值规范为数组 */
+export declare const ensureArray: <T>(v: any) => T[];
+/** 判断为有限正数 */
+export declare const isPositive: (n: any) => boolean;
+/** 生成 uuid（浏览器环境降级） */
+export declare const uuid: () => any;
+/** 规范 http(s) 链接 */
+export declare const httpUrl: (s: any, fallback?: string) => string;
+/** 规范 ws(s) 链接 */
+export declare const wsUrl: (s: any, fallback?: string) => string;

package/dist/sdk/generators/component.d.ts

@@ -0,0 +1,5 @@
+import { Result, CreateOptions } from './common';
+import { ComponentInstance } from '../../types/componets';
+export declare const validateComponent: (input: unknown) => Result<null>;
+export declare const createComponent: (input: unknown, options?: CreateOptions) => Result<ComponentInstance>;
+export declare const normalizeComponent: (input: unknown, options?: CreateOptions) => ComponentInstance;

package/dist/sdk/generators/dataSource.d.ts

@@ -0,0 +1,5 @@
+import { Result, CreateOptions } from './common';
+import { DataSourceItem } from '../../types/dataSources';
+export declare const validateDataSource: (input: unknown) => Result<null>;
+export declare const createDataSource: (input: unknown, options?: CreateOptions) => Result<DataSourceItem>;
+export declare const normalizeDataSource: (input: unknown, options?: CreateOptions) => DataSourceItem;

package/dist/sdk/generators/dependency.d.ts

@@ -0,0 +1,5 @@
+import { Result } from './common';
+import { Dependency } from '../../types/deps';
+export declare const validateDependency: (input: unknown) => Result<null>;
+export declare const createDependency: (input: unknown) => Result<Dependency>;
+export declare const normalizeDependency: (input: unknown) => Dependency;

package/dist/sdk/generators/meta.d.ts

@@ -0,0 +1,8 @@
+import { Result } from './common';
+import { MetaInfo, LayoutConfig } from '../../types/meta';
+export declare const validateMeta: (input: unknown) => Result<null>;
+export declare const validateLayout: (input: unknown) => Result<null>;
+export declare const createMeta: (input: unknown) => Result<MetaInfo>;
+export declare const createLayout: (input: unknown) => Result<LayoutConfig>;
+export declare const normalizeMeta: (input: unknown) => MetaInfo;
+export declare const normalizeLayout: (input: unknown) => LayoutConfig;

package/dist/sdk/generators/page.d.ts

@@ -0,0 +1,5 @@
+import { Result, CreateOptions } from './common';
+import { CICPage } from '../../types/page';
+export declare const validatePage: (input: unknown) => Result<null>;
+export declare const createPage: (input: unknown, options?: CreateOptions) => Result<CICPage>;
+export declare const normalizePage: (input: unknown, options?: CreateOptions) => CICPage;

package/dist/sdk/generators/registry.d.ts

@@ -0,0 +1,5 @@
+import { Result } from './common';
+import { RegistryComponents } from '../../types/registry';
+export declare const validateRegistryComponent: (input: unknown) => Result<null>;
+export declare const createRegistryComponent: (input: unknown) => Result<RegistryComponents>;
+export declare const normalizeRegistryComponent: (input: unknown) => RegistryComponents;

package/dist/sdk/generators/variables.d.ts

@@ -0,0 +1,5 @@
+import { Result } from './common';
+import { Variables } from '../../types/variables';
+export declare const validateVariables: (input: unknown) => Result<null>;
+export declare const createVariables: (input: unknown) => Result<Variables>;
+export declare const normalizeVariables: (input: unknown) => Variables;

package/dist/types/componets.d.ts

@@ -0,0 +1,48 @@
+import { CICEventMap } from './events';
+import { Data } from './data';
+/** 通用表达式（用于条件、模板等） */
+export type Expr = string;
+/** 样式值可以是静态或表达式 */
+export type StyleValue = string | number | Expr;
+/** component 引用：字符串或 object 描述 */
+export type ComponentRef = string | {
+    type: "id";
+    value: string;
+};
+export type LogicRef = string | {
+    type: "url" | "code";
+    value: string;
+};
+/**
+ * 组件的语义分类（view/container/logic）
+ * - view: 可视化渲染组件
+ * - container: 容器，包含 children
+ * - logic: 逻辑/脚本组件
+ */
+export type ComponentType = 'view' | 'container' | 'logic';
+/** 组件实例 */
+export interface ComponentBase {
+    id: string;
+    props?: Record<string, any>;
+    style?: Record<string, StyleValue>;
+    events?: CICEventMap;
+    data?: Data;
+    deps?: string[];
+    extensions?: Record<string, any>;
+}
+export interface ViewComponentInstance extends ComponentBase {
+    role: 'view';
+    component: ComponentRef;
+    children?: never;
+}
+export interface ContainerComponentInstance extends ComponentBase {
+    role: 'container';
+    children: ComponentInstance[];
+    component?: never;
+}
+export interface LogicComponentInstanceRef extends ComponentBase {
+    role: 'logic';
+    component: LogicRef;
+    children?: never;
+}
+export type ComponentInstance = ViewComponentInstance | ContainerComponentInstance | LogicComponentInstanceRef;

package/dist/types/data.d.ts

@@ -0,0 +1,35 @@
+/** 字段映射配置 */
+export interface IMapping {
+    use: boolean;
+    mapFields: Array<{
+        /** 源字段名 */
+        field: string;
+        /** 目标字段名 */
+        mapField: string;
+        /** 映射值或公式 */
+        value?: any;
+        /** 映射类型：默认(普通映射)、copy(复制) const(常量)、formula(公式) */
+        type?: 'copy' | 'const' | 'formula';
+        /** 描述 */
+        description?: string;
+    }>;
+}
+/** 转换规则配置 */
+export interface IConverse {
+    use: boolean;
+    data: Array<{
+        /** 转换代码 */
+        code: string;
+        /** 依赖变量列表（用于响应式重执行） */
+        depeedVars?: Array<string>;
+    }>;
+}
+/** 数据配置 */
+export interface Data {
+    /** 数据ID */
+    id: string;
+    /** 字段映射配置 */
+    mapping?: IMapping;
+    /** 转换规则配置 */
+    converse?: IConverse;
+}

package/dist/types/dataSources.d.ts

@@ -0,0 +1,37 @@
+export type Milliseconds = number;
+export interface DataSourceBase {
+    id: string;
+    type: string;
+    order?: number;
+    pollInterval?: Milliseconds;
+    transform?: string | ((res: any) => any);
+}
+export interface DataSourceRest extends DataSourceBase {
+    type: "rest";
+    url: string;
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    body?: any;
+    timeout?: Milliseconds;
+}
+export interface DataSourceWebSocket extends DataSourceBase {
+    type: "websocket";
+    url: string;
+    protocols?: string | string[];
+    subscribeMessage?: any;
+    heartbeat?: {
+        interval: Milliseconds;
+        message: any;
+    };
+}
+export interface DataSourceStatic extends DataSourceBase {
+    type: "static";
+    value: any;
+}
+export interface DataSourceFunction extends DataSourceBase {
+    type: "function";
+    code: string;
+    timeout?: Milliseconds;
+}
+export type DataSourceItem = DataSourceRest | DataSourceWebSocket | DataSourceStatic | DataSourceFunction;

package/dist/types/deps.d.ts

@@ -0,0 +1,73 @@
+/** 资源类型 */
+export type ResourceType = 'js' | 'css' | 'font' | 'image' | 'json' | 'wasm' | 'other';
+/** JS 格式 */
+export type JSFormat = 'esm' | 'umd' | 'iife' | 'cjs';
+/**
+ * 公共字段
+ */
+export interface BaseDependency {
+    /** 全局唯一 ID，用于运行时索引 */
+    id: string;
+    /** 可选：人类可读名称（展示用） */
+    name?: string;
+    /** 版本号（语义化版本 / 字体权重皆可） */
+    version?: string;
+    /** 资源 URL，可以是绝对地址或相对地址 */
+    url?: string;
+    /** 本地路径（构建后使用） */
+    localPath?: string;
+    /** 分组：方便批量加载 */
+    group?: string;
+    /** 加载策略 */
+    strategy?: {
+        /** 预加载/预取 */
+        preload?: boolean | 'module' | 'style';
+        prefetch?: boolean;
+        /** 是否异步加载 */
+        async?: boolean;
+        /** 仅在某些条件下加载（如主题） */
+        when?: string;
+    };
+}
+/** JS 资源 */
+export interface JSDependency extends BaseDependency {
+    type: 'js';
+    format: JSFormat;
+    crossOrigin?: 'anonymous' | 'use-credentials';
+    module?: boolean;
+}
+/** CSS */
+export interface CSSDependency extends BaseDependency {
+    type: 'css';
+    media?: string;
+}
+/** 字体 */
+export interface FontDependency extends BaseDependency {
+    type: 'font';
+    family?: string;
+    weight?: number | string;
+    style?: 'normal' | 'italic';
+}
+/** 图片 */
+export interface ImageDependency extends BaseDependency {
+    type: 'image';
+    mime?: string;
+}
+/** JSON */
+export interface JSONDependency extends BaseDependency {
+    type: 'json';
+}
+/** WASM */
+export interface WasmDependency extends BaseDependency {
+    type: 'wasm';
+    init?: 'async' | 'sync';
+}
+/** 其他 */
+export interface OtherDependency extends BaseDependency {
+    type: 'other';
+    kind?: string;
+}
+/** 判别联合 */
+export type Dependency = JSDependency | CSSDependency | FontDependency | ImageDependency | JSONDependency | WasmDependency | OtherDependency;
+/** 依赖数组 */
+export type Dependencies = Dependency[];

package/dist/types/events.d.ts

@@ -0,0 +1,133 @@
+/** 所有事件大类 */
+export type EventType = 'vars' | 'navigate' | 'comp' | 'toggle' | 'camera' | 'material' | 'custom' | string;
+/** 变量事件动作 */
+export type VarsAction = 'add' | 'update' | 'delete';
+/** 跳转事件动作 */
+export type NavigateAction = 'internal' | 'external';
+/** 组件事件动作 */
+export type CompAction = 'add' | 'update' | 'delete';
+/** 切换事件动作 */
+export type ToggleAction = 'visibility';
+/** 相机动作 */
+export type CameraAction = 'focus';
+/** 材质动作 */
+export type MaterialAction = 'change';
+/** 自定义动作 */
+export type CustomAction = 'local' | 'remote';
+export interface VarsParams {
+    key: string;
+    value: any;
+    exclude?: string[];
+}
+export interface NavigateInternalParams {
+    name: string;
+    params?: Record<string, any>;
+}
+export interface NavigateExternalParams {
+    url: string;
+    openNewTab?: boolean;
+}
+export interface CompParams {
+    comps: string[];
+    props?: Record<string, any>;
+}
+export interface ToggleParams {
+    show?: string[];
+    hide?: string[];
+}
+export interface CameraFocusParams {
+    target: string | number;
+    duration?: number;
+}
+export interface MaterialChangeParams {
+    target: string;
+    materials: string;
+}
+export interface CustomLocalParams {
+    code: string;
+    depends?: string[];
+}
+export interface CustomRemoteParams {
+    url: string;
+    depends?: string[];
+}
+export type ConditionOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not-in' | 'exists' | 'not-exists';
+export interface KeyCondition {
+    key: string;
+    op?: ConditionOperator;
+    value?: any;
+}
+/** 表达式条件：支持如 "ctx.id === 5 && ctx.level > 1" */
+export interface ExpressionCondition {
+    expression: string;
+}
+/** 多条件（AND） + 表达式 */
+export type EventCondition = KeyCondition | KeyCondition[] | ExpressionCondition;
+/** 不同事件类型对应不同结构 */
+/** 变量事件 */
+export interface VarsEvent {
+    type: 'vars';
+    action: VarsAction;
+    params: VarsParams;
+}
+/** 内部跳转事件 */
+export interface NavigateInternalEvent {
+    type: 'navigate';
+    action: 'internal';
+    params: NavigateInternalParams;
+}
+/** 外部跳转事件 */
+export interface NavigateExternalEvent {
+    type: 'navigate';
+    action: 'external';
+    params: NavigateExternalParams;
+}
+/** 组件事件 */
+export interface CompEvent {
+    type: 'comp';
+    action: CompAction;
+    params: CompParams;
+}
+/** 显示隐藏切换事件 */
+export interface ToggleEvent {
+    type: 'toggle';
+    action: 'visibility';
+    params: ToggleParams;
+}
+/** 相机事件 */
+export interface CameraEvent {
+    type: 'camera';
+    action: 'focus';
+    params: CameraFocusParams;
+}
+/** 材质事件 */
+export interface MaterialEvent {
+    type: 'material';
+    action: 'change';
+    params: MaterialChangeParams;
+}
+/** 自定义本地事件 */
+export interface CustomLocalEvent {
+    type: 'custom';
+    action: 'local';
+    params: CustomLocalParams;
+}
+/** 自定义远程事件 */
+export interface CustomRemoteEvent {
+    type: 'custom';
+    action: 'remote';
+    params: CustomRemoteParams;
+}
+/** 最终事件联合类型 */
+export type CICEvent = VarsEvent | NavigateInternalEvent | NavigateExternalEvent | CompEvent | ToggleEvent | CameraEvent | MaterialEvent | CustomLocalEvent | CustomRemoteEvent;
+/** 带调度信息 */
+export type CICEventWithMeta = CICEvent & {
+    order: number;
+    delay?: number;
+    condition?: EventCondition;
+};
+/** 某组件的所有事件
+ * 说明：定义了 CIC 项目中组件的所有事件，包含事件类型、动作、参数、调度顺序、延迟时间和条件。
+ * （key: 事件名, value: 处理逻辑数组）
+ */
+export type CICEventMap = Record<string, CICEventWithMeta[]>;

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+import { MetaInfo } from './meta';
+import { Registry } from './registry';
+import { Variables } from './variables';
+import { Dependencies } from './deps';
+import { CICPage } from './page';
+/**
+ * CIC 配置定义
+ * 说明：定义了 CIC 项目的全局配置，包含版本、元数据、页面、组件、变量、依赖等。
+ */
+export interface CICConfig {
+    version: string;
+    meta: MetaInfo;
+    pages: CICPage[];
+    registry?: Registry;
+    variables?: Variables;
+    deps?: Dependencies;
+    extensions?: Record<string, any>;
+}

package/dist/types/meta.d.ts

@@ -0,0 +1,53 @@
+export interface LayoutConfig {
+    /** 布局类型: free(自由布局) 或 grid(网格布局) */
+    type: "free" | "grid";
+    config: {
+        /**
+         * 设计稿宽度
+         * @minimum 1
+         * @default 1920
+         */
+        width: number;
+        /**
+         * 设计稿高度
+         * @minimum 1
+         * @default 1080
+         */
+        height: number;
+        /**
+         * 缩放模式
+         * @default "aspectFit"
+         */
+        scaleMode: "aspectFit" | "fill";
+    };
+}
+/**
+ * 项目元信息
+ * 包含项目的基本信息、布局配置、语言、创建时间、更新时间、作者和扩展信息。
+ */
+export interface MetaInfo {
+    /** 项目唯一标识符 */
+    projectId?: string;
+    /** 项目名称 */
+    projectName?: string;
+    /** 项目描述 */
+    description?: string;
+    /** 布局配置 */
+    layout?: LayoutConfig;
+    /** 语言代码 (e.g. zh-CN, en-US) */
+    language?: string;
+    /**
+     * 创建时间 (ISO 8601)
+     * @format date-time
+     */
+    createTime?: string;
+    /**
+     * 更新时间 (ISO 8601)
+     * @format date-time
+     */
+    updateTime?: string;
+    /** 作者 */
+    author?: string;
+    /** 扩展字段 */
+    extensions?: Record<string, any>;
+}

package/dist/types/page.d.ts

@@ -0,0 +1,16 @@
+import { ComponentInstance } from './componets';
+import { DataSourceItem } from './dataSources';
+import { LayoutConfig } from './meta';
+/**
+ * CIC 页面定义
+ * 说明：定义了 CIC 中页面的结构，包含页面 ID、名称、路径、布局、组件等。
+ */
+export interface CICPage {
+    id: string;
+    name: string;
+    path: string;
+    layout?: LayoutConfig;
+    components?: ComponentInstance[];
+    dataSources?: DataSourceItem[];
+    extensions?: Record<string, any>;
+}

package/dist/types/registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 注册中心组件项
+ * 说明：定义了 CIC 项目中组件注册中心的组件项，包含组件 ID、类型和配置。
+ * @example
+ * {
+ *   "id": "comp_echarts_line",
+ *   "name": "折线图",
+ *   "description": "用于展示时间序列数据的折线图组件",
+ *   "version": "1.0.0",
+ *   "author": "component_dev",
+ *   "defaultProps": {
+ *     "title": {
+ *       "type": "string",
+ *       "default": "折线图标题",
+ *       "description": "图表的标题"
+ *     },
+ *     "xAxis": {
+ *       "type": "array",
+ *       "default": [],
+ *       "description": "X轴数据"
+ *     },
+ *     "yAxis": {
+ *       "type": "array",
+ *       "default": [],
+ *       "description": "Y轴数据"
+ *   },
+ *   "lineColor": {
+ *     "type": "string",
+ *     "default": "#5470C6",
+ *     "description": "折线颜色"
+ *   }
+ * },
+ * "data": {
+ *   "x": 123,
+ *  "y": 456
+ * },
+ * "deps": ["1", "2"]
+ * }
+ */
+export interface RegistryComponents {
+    id: string;
+    name?: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    defaultProps?: Record<string, any>;
+    data?: any;
+    deps?: string[];
+}
+/**
+ * 注册表
+ */
+export interface Registry {
+    components?: RegistryComponents[];
+    /**插件后期可扩展 */
+    plugins?: Record<string, any>;
+}

package/dist/types/variables.d.ts

@@ -0,0 +1,58 @@
+/** 变量类型枚举，限定变量的基础类型：字符串、数字、布尔、数组、对象和函数。 */
+export type VariableType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'function';
+/** 字符串变量，包含当前值与默认值，可选描述。 */
+export interface StringVariable {
+    type: 'string';
+    value: string;
+    default: string;
+    description?: string;
+}
+/** 数字变量，包含当前值与默认值，可选描述。 */
+export interface NumberVariable {
+    type: 'number';
+    value: number;
+    default: number;
+    description?: string;
+}
+/** 布尔变量，包含当前值与默认值，可选描述。 */
+export interface BooleanVariable {
+    type: 'boolean';
+    value: boolean;
+    default: boolean;
+    description?: string;
+}
+/** 数组变量，元素类型不做限制，包含当前值与默认值，可选描述。 */
+export interface ArrayVariable {
+    type: 'array';
+    value: unknown[];
+    default: unknown[];
+    description?: string;
+}
+/** 函数变量，以字符串保存函数实现；支持 `args` 指定入参名列表。 */
+export interface FunctionVariable {
+    type: 'function';
+    value: string;
+    default: string;
+    description?: string;
+    args?: string[];
+}
+/** 对象变量，键到变量的映射；支持递归嵌套。 */
+export interface ObjectVariable {
+    type: 'object';
+    value: Record<string, Variable>;
+    default: Record<string, Variable>;
+    description?: string;
+}
+/** 变量联合类型，涵盖五类变量定义。 */
+export type Variable = StringVariable | NumberVariable | BooleanVariable | ArrayVariable | FunctionVariable | ObjectVariable;
+/** 变量映射，键为变量名，值为变量定义。 */
+export type VariablesMap = Record<string, Variable>;
+/** 变量集合，按作用域组织：global/page/component。 */
+export interface Variables {
+    /** 全局变量，对所有页面和组件均生效。 */
+    global: VariablesMap;
+    /** 页面级变量，键为页面 ID，值为该页面的变量映射。 */
+    page: Record<string, VariablesMap>;
+    /** 组件级变量，键为组件 ID，值为该组件的变量映射。 */
+    component: Record<string, VariablesMap>;
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@anov/cic-standard-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "CIC Standard SDK with TypeScript support",
   "main": "dist/cic-sdk.cjs.js",
   "module": "dist/cic-sdk.es.js",
-  "types": "dist/index.d.ts",
+  "types": "dist/sdk/CICSDK.d.ts",
   "exports": {
     ".": {
       "import": "./dist/cic-sdk.es.js",
@@ -20,7 +20,8 @@
   "sideEffects": false,
   "scripts": {
     "dev": "vite",
-    "build": "vite build",
+    "build": "vite build && npm run build:types",
+    "build:types": "tsc -p tsconfig.json",
     "test": "vitest",
     "test:coverage": "vitest run --coverage",
     "gen:schema": "tsx scripts/generate-schema.ts",