@blocklet/pages-kit-block-studio 0.4.65 → 0.4.67

package/lib/types/types/properties.d.ts

@@ -0,0 +1,17 @@
+export type PropertyType = Text | Multiline | Decimal | Boolean | Color | URL | JSON;
+export type Text = string;
+export type Multiline = string;
+export type Decimal = number;
+export type Boolean = boolean;
+export type Color = string;
+export type URL = {
+    url: string;
+    mediaKitUrl?: string;
+    width?: string;
+    height?: string;
+};
+export type JSON = {
+    [key: string]: PropertyType;
+};
+export type Array = PropertyType[];
+export type YAML = string;

package/lib/types/utils/block-props-utils.d.ts

@@ -0,0 +1,103 @@
+/**
+ * BlockProps 接口处理工具
+ * 基于 Zod 重构设计，提供接口解析和转换功能
+ */
+import * as ts from 'typescript';
+/**
+ * 基本组件部分类型定义
+ * 提供常用组件的TypeScript类型定义
+ */
+export declare const BASIC_COMPONENT_SECTION_TYPES: {
+    iframe: string;
+    section: string;
+    'section-card-list': string;
+    toc: string;
+};
+/**
+ * 基本组件部分JSON Schema定义
+ * 提供常用组件的JSON Schema定义
+ */
+export declare const BASIC_COMPONENT_SECTION_JSON_SCHEMAS: {
+    iframe: {
+        src: {
+            type: string;
+        };
+        title: {
+            type: string;
+        };
+        description: {
+            type: string;
+        };
+    };
+    section: {
+        title: {
+            type: string;
+        };
+        description: {
+            type: string;
+        };
+        image: {
+            type: string;
+        };
+        imageMeta: {
+            type: string;
+            properties: {
+                naturalWidth: {
+                    type: string;
+                };
+                naturalHeight: {
+                    type: string;
+                };
+                filename: {
+                    type: string;
+                };
+            };
+        };
+    };
+    'section-card-list': {
+        title: {
+            type: string;
+        };
+        description: {
+            type: string;
+        };
+        list: {
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    id: {
+                        type: string;
+                    };
+                    title: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    image: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+    toc: {
+        title: {
+            type: string;
+        };
+        description: {
+            type: string;
+        };
+    };
+};
+/**
+ * 查找并解析BlockProps接口
+ */
+export declare function findBlockPropsInterface(sourceFile: ts.SourceFile): {
+    found: boolean;
+    interfaceStart: number;
+    interfaceEnd: number;
+    interfaceText: string;
+    leadingComments: string;
+};

package/lib/types/utils/generate-wrapper-code.d.ts

@@ -1,5 +1,29 @@
+import { LLMConfigProperty } from './zod-utils';
 export declare function generateWrapperCode({ project, state, version }: any): Promise<{
     fileName: string;
     content: string;
 }[]>;
+/**
+ * 使用Zod生成JSON Schema
+ * 替代generatePropertiesJsonSchema
+ */
+export declare function generatePropertiesJsonSchemaWithZod({ properties, llmConfig, }: {
+    properties: Record<string, any>;
+    llmConfig: Record<string, LLMConfigProperty>;
+}): any;
+/**
+ * 使用Zod生成页面数据JSON Schema
+ * 替代generatePageDataJsonSchemas
+ */
+export declare function generatePageDataJsonSchemasWithZod(state: any): string;
+/**
+ * 使用Zod生成页面数据类型
+ * 替代generatePageDataTypes
+ */
+export declare function generatePageDataTypesWithZod(state: any): string;
+/**
+ * 使用Zod生成TypeScript类型属性
+ * 与现有generatePropertiesTypes函数保持相同签名
+ */
+export declare function generatePropertiesTypesWithZod(properties: Record<string, any>): string;
 export default generateWrapperCode;

package/lib/types/utils/ts-morph-utils.d.ts

@@ -0,0 +1,33 @@
+import { Project } from 'ts-morph';
+import { z } from 'zod';
+/**
+ * 创建 ts-morph 项目
+ * @param tsConfigFilePath tsconfig.json 文件路径
+ */
+export declare function createTsMorphProject(tsConfigFilePath?: string): Project;
+/**
+ * 解析类型定义文件，提取指定类型及其依赖
+ * @param sourceFilePath 源文件路径
+ * @param typeName 要提取的类型名称
+ * @param tsConfigFilePath tsconfig.json 文件路径
+ */
+export declare function extractTypeWithDependencies(sourceFilePath: string, typeName: string, tsConfigFilePath?: string): {
+    typeText: string;
+    dependencies: Map<string, string>;
+    imports: string[];
+};
+/**
+ * 组合类型及其依赖为完整的类型定义文本
+ * @param typeText 主类型文本
+ * @param dependencies 依赖类型集合
+ * @param imports 导入语句集合
+ */
+export declare function combineTypeDefinitions(typeText: string, dependencies: Map<string, string>, imports?: string[]): string;
+/**
+ * 从TypeScript文件中的类型声明生成Zod schema
+ * 支持处理外部引用类型
+ * @param sourceFilePath 源文件路径
+ * @param typeName 类型名称
+ * @param tsConfigFilePath tsconfig.json 路径，默认为项目根目录下的tsconfig.json
+ */
+export declare function tsFileToZodSchema(sourceFilePath: string, typeName: string): Promise<z.ZodTypeAny>;

package/lib/types/utils/zod-utils.d.ts

@@ -0,0 +1,51 @@
+import { CustomComponentProperty } from '@blocklet/pages-kit/types';
+import { z } from 'zod';
+export type LLMConfigProperty = {
+    key: string;
+    displayName?: string;
+    isNeedGenerate: boolean;
+    describe: string;
+    subProperties?: Record<string, LLMConfigProperty>;
+};
+type PropertyToZodFn = (properties: CustomComponentProperty, { addZodDescribe, propLLMConfig }: {
+    addZodDescribe?: boolean;
+    propLLMConfig?: LLMConfigProperty;
+}) => z.ZodTypeAny;
+/**
+ * Properties 类型与 Schema 类型的映射关系
+ * blocklets/pages-kit/src/pages/page-maker/custom-component/setting.tsx
+ */
+export declare const PROPERTIES_TYPE_SCHEMA: {
+    propertyToZod: Record<string, PropertyToZodFn>;
+};
+/**
+ * 从 Properties 对象创建 Zod schema
+ */
+export declare function propertiesToZodSchema(properties: Record<string, any>, { addZodDescribe, isOptional, llmConfig, }?: {
+    addZodDescribe?: boolean;
+    isOptional?: boolean;
+    llmConfig?: Record<string, LLMConfigProperty>;
+}): z.ZodTypeAny;
+/**
+ * 从JSON Schema生成Properties对象
+ */
+export declare function jsonSchemaToProperties(jsonSchema: any, { existingProperties, key, isRoot, index, }?: {
+    existingProperties?: Record<string, any>;
+    key?: string;
+    isRoot?: boolean;
+    index?: number;
+}): Record<string, any>;
+/**
+ * 从Zod schema生成TypeScript类型字符串
+ */
+export declare function zodSchemaToTypeString(schema: z.ZodTypeAny, typeName: string, removeUndefined?: boolean): string;
+/**
+ * 从Zod schema生成JSON Schema
+ */
+export declare function zodSchemaToJsonSchema(schema: z.ZodTypeAny): import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocklet/pages-kit-block-studio",
-  "version": "0.4.65",
+  "version": "0.4.67",
   "description": "Pages Kit block studio for blocklet(s)",
   "publishConfig": {
     "access": "public"
@@ -43,6 +43,10 @@
     "./init-block-studio-router": {
       "import": "./lib/esm/middlewares/init-block-studio-router.js",
       "require": "./lib/cjs/middlewares/init-block-studio-router.js"
+    },
+    "./frontend": {
+      "import": "./lib/esm/plugins/_theme.js",
+      "require": "./lib/cjs/plugins/_theme.js"
     }
   },
   "typesVersions": {
@@ -76,6 +80,10 @@
       "init-block-studio-router": [
         "./lib/types/middlewares/init-block-studio-router.d.ts",
         "./lib/types/middlewares/init-block-studio-router.d.ts"
+      ],
+      "frontend": [
+        "./lib/types/plugins/_theme.d.ts",
+        "./lib/types/plugins/_theme.d.ts"
       ]
     }
   },
@@ -112,6 +120,8 @@
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.26.1",
     "rollup-plugin-external-globals": "^0.12.1",
+    "ts-morph": "^21.0.1",
+    "ts-to-zod": "^3.15.0",
     "typescript": "^5.7.2",
     "ufo": "^1.5.4",
     "vite": "^5.4.11",
@@ -119,7 +129,10 @@
     "vite-plugin-node-polyfills": "^0.23.0",
     "vite-plugin-react-pages": "^5.0.0",
     "yaml": "^2.5.0",
-    "@blocklet/pages-kit": "0.4.65"
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.24.4",
+    "zod-to-ts": "^1.2.0",
+    "@blocklet/pages-kit": "0.4.67"
   },
   "devDependencies": {
     "@rollup/plugin-typescript": "^11.1.6",
@@ -141,7 +154,10 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.26.1",
-    "@blocklet/pages-kit": "0.4.65"
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.24.4",
+    "zod-to-ts": "^1.2.0",
+    "@blocklet/pages-kit": "0.4.67"
   },
   "scripts": {
     "lint": "eslint src --ext .mjs,.js,.jsx,.ts,.tsx",