@anov/cic-standard-sdk 0.0.9 → 0.0.11

package/dist/sdk/CICSDK.d.ts

@@ -8,9 +8,6 @@ export type { Result as GeneratorResult } from './generators/common';
  */
 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;
@@ -21,13 +18,6 @@ export declare class CICSDK implements ICICSDK {
     }, 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 语法）
      */
@@ -40,32 +30,29 @@ export declare class CICSDK implements ICICSDK {
     /** 创建 DataSource */
     static createDataSource: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").DataSourceItem>;
     static validateDataSource: (input: unknown) => import("./generators/common").Result<null>;
-    static normalizeDataSource: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").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, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").Meta>;
     static createLayout: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").Layout>;
     static validateMeta: (input: unknown) => import("./generators/common").Result<null>;
     static validateLayout: (input: unknown) => import("./generators/common").Result<null>;
-    static normalizeMeta: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").Meta;
-    static normalizeLayout: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").Layout;
     /** 创建 Variables */
     static createVariables: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").Variables>;
     static validateVariables: (input: unknown) => import("./generators/common").Result<null>;
-    static normalizeVariables: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").Variables;
     /** 创建 Dependency */
     static createDependency: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").Dependency>;
     static validateDependency: (input: unknown) => import("./generators/common").Result<null>;
-    static normalizeDependency: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").Dependency;
     /** 创建 Registry 组件项 */
     static createRegistryComponent: (input: unknown, options?: import("./generators/common").CreateOptions) => import("./generators/common").Result<import("../types").RegistryComponents>;
     static validateRegistryComponent: (input: unknown) => import("./generators/common").Result<null>;
-    static normalizeRegistryComponent: (input: unknown, options?: import("./generators/common").CreateOptions) => import("../types").RegistryComponents;
+    /** 顶层导入/导出 验证(基于 JSON Schema)*/
+    static importCIC: (input: string | CICConfig, options?: import("./generators/cicConfig").CICCreateOptions) => import("./generators/common").Result<CICConfig>;
+    static exportCIC: (config: CICConfig) => import("./generators/common").Result<string>;
+    static validateCIC: (config: CICConfig) => import("./generators/common").Result<null>;
+    static importCICAsync: (input: string | CICConfig, options?: import("./generators/cicConfig").CICCreateOptions) => Promise<import("./generators/common").Result<CICConfig>>;
 }

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

@@ -0,0 +1,40 @@
+import { CICConfig } from '../../types';
+import { Result, CreateOptions } from './common';
+export type CICCreateOptions = {
+    strict?: boolean;
+    defaults?: Partial<CICConfig>;
+    meta?: CreateOptions;
+    layout?: CreateOptions;
+    page?: CreateOptions;
+    component?: CreateOptions;
+    dataSource?: CreateOptions;
+    variables?: CreateOptions;
+    registry?: CreateOptions;
+    dependency?: CreateOptions;
+};
+/**
+ * 校验 CIC 配置
+ * @param config CIC 配置对象
+ * @returns 校验结果
+ */
+export declare const validateCIC: (config: CICConfig) => Result<null>;
+/**
+ * 导入 CIC 配置
+ * @param input CIC 配置的 JSON 字符串或对象
+ * @param options 导入选项
+ * @returns 导入结果
+ */
+export declare const importCIC: (input: string | CICConfig, options?: CICCreateOptions) => Result<CICConfig>;
+/**
+ * 异步导入 CIC 配置（支持路径/URL）
+ * @param input CIC 配置的 JSON 字符串或对象或路径/URL
+ * @param options 导入选项
+ * @returns 导入结果
+ */
+export declare const importCICAsync: (input: string | CICConfig, options?: CICCreateOptions) => Promise<Result<CICConfig>>;
+/**
+ * 导出 CIC 配置
+ * @param config CIC 配置对象
+ * @returns 导出结果
+ */
+export declare const exportCIC: (config: CICConfig) => Result<string>;

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

@@ -28,3 +28,13 @@ export declare const uuid: () => any;
 export declare const formatAjvErrors: (errs: any[]) => FormattedError[];
 /** 仅对缺失字段应用默认值（浅合并）；不覆盖已有值 */
 export declare const applyDefaults: <T>(target: any, defaults?: Partial<T>) => any;
+/** 在已格式化错误上追加路径前缀 */
+export declare const prefixErrors: (prefix: string, errors?: FormattedError[]) => FormattedError[];
+/** 安全解析 JSON 文本，统一错误输出（中文） */
+export declare const safeParseJSON: (text: string) => Result<any>;
+/** 生成缺失必填字段的聚焦错误列表 */
+export declare const missingRequiredErrors: (keys: string[]) => FormattedError[];
+/** 通用判别联合校验（按 discriminant 路由分支） */
+export declare const validateDiscriminated: (input: any, baseValidator: any, branchValidators: Record<string, any>, key: string) => Result<null>;
+/** 通用判别联合创建（规范化+分支校验+聚焦错误） */
+export declare const createDiscriminated: <T>(input: unknown, options: CreateOptions | undefined, normalize: (x: any, o?: CreateOptions) => any, baseValidator: any, branchValidators: Record<string, any>, key: string, missingKeys?: string[]) => Result<T>;

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

@@ -1,5 +1,10 @@
 import { Result, CreateOptions } from './common';
 import { ComponentInstance } from '../../types/componets';
 export declare const validateComponent: (input: unknown) => Result<null>;
+/**
+ * 创建组件实例
+ * @param input 组件输入对象
+ * @param options 创建选项
+ * @returns 创建结果
+ */
 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

@@ -2,4 +2,3 @@ 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

@@ -2,4 +2,3 @@ import { Result, CreateOptions } from './common';
 import { Dependency } from '../../types/deps';
 export declare const validateDependency: (input: unknown) => Result<null>;
 export declare const createDependency: (input: unknown, options?: CreateOptions) => Result<Dependency>;
-export declare const normalizeDependency: (input: unknown, options?: CreateOptions) => Dependency;

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

@@ -2,7 +2,11 @@ import { Result, CreateOptions } from './common';
 import { Meta, Layout } from '../../types/meta';
 export declare const validateMeta: (input: unknown) => Result<null>;
 export declare const validateLayout: (input: unknown) => Result<null>;
+/**
+ * 创建 Meta
+ * - 严格模式：不注入默认值
+ * - 非严格模式：仅在 defaults 提供时进行浅合并
+ */
 export declare const createMeta: (input: unknown, options?: CreateOptions) => Result<Meta>;
+/** 创建 Layout（规则同 createMeta） */
 export declare const createLayout: (input: unknown, options?: CreateOptions) => Result<Layout>;
-export declare const normalizeMeta: (input: unknown, options?: CreateOptions) => Meta;
-export declare const normalizeLayout: (input: unknown, options?: CreateOptions) => Layout;

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

@@ -1,5 +1,9 @@
 import { Result, CreateOptions } from './common';
 import { CICPage } from '../../types/page';
 export declare const validatePage: (input: unknown) => Result<null>;
+/**
+ * 创建 Page
+ * - 非严格模式：支持 defaults 注入与自动生成 id
+ * - 严格模式：仅校验原始输入
+ */
 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

@@ -1,5 +1,9 @@
 import { Result, CreateOptions } from './common';
 import { RegistryComponents } from '../../types/registry';
 export declare const validateRegistryComponent: (input: unknown) => Result<null>;
+/**
+ * 创建 RegistryComponents
+ * - 严格模式：不注入默认值
+ * - 非严格模式：仅在 defaults 提供时进行浅合并
+ */
 export declare const createRegistryComponent: (input: unknown, options?: CreateOptions) => Result<RegistryComponents>;
-export declare const normalizeRegistryComponent: (input: unknown, options?: CreateOptions) => RegistryComponents;

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

@@ -1,5 +1,9 @@
 import { Result, CreateOptions } from './common';
 import { Variables } from '../../types/variables';
 export declare const validateVariables: (input: unknown) => Result<null>;
+/**
+ * 创建 Variables
+ * - 严格模式：不注入默认值
+ * - 非严格模式：仅在 defaults 提供时进行浅合并
+ */
 export declare const createVariables: (input: unknown, options?: CreateOptions) => Result<Variables>;
-export declare const normalizeVariables: (input: unknown, options?: CreateOptions) => Variables;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anov/cic-standard-sdk",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "CIC Standard SDK with TypeScript support",
   "main": "dist/cic-sdk.cjs.js",
   "module": "dist/cic-sdk.es.js",