@ticatec/dyna-js 0.0.2 → 0.0.4

package/README.md

@@ -11,14 +11,12 @@ A TypeScript library for safe dynamic code execution using `new Function()` that
 
 ## Features
 
-✅ **Universal Compatibility** - Works in both Node.js and browser environments  
-✅ **TypeScript Support** - Full type safety with comprehensive type definitions  
-✅ **Singleton Pattern** - Initialize once, use anywhere  
-✅ **Module Imports** - Pre-define classes and functions for dynamic code  
-✅ **Proxy-based Sandbox** - Safe variable access control with proxy mechanism  
-✅ **Configurable Security** - Fine-grained control over allowed APIs and operations  
-✅ **Form Class Creation** - Special method for creating dynamic form classes  
-✅ **Multiple Build Formats** - CommonJS and ESM support  
+✅ **Universal Compatibility** - Works in both Node.js and browser environments
+✅ **TypeScript Support** - Full type safety with comprehensive type definitions
+✅ **Singleton Pattern** - Initialize once, use anywhere
+✅ **Module Imports** - Pre-define classes and functions for dynamic code
+✅ **Configurable Security** - Fine-grained control over allowed APIs and operations
+✅ **Multiple Build Formats** - CommonJS and ESM support
 ✅ **Performance Monitoring** - Built-in execution time tracking  
 
 ## Installation
@@ -44,8 +42,6 @@ initializeDynaJs({
     FlexiContext: FlexiContextClass,
     ModuleLoader: ModuleLoaderClass
   },
-  defaultInjectedKeys: ['Dialog', 'MessageBox', 'Indicator', 'Toast'],
-  useProxyByDefault: true,
   allowBrowserAPIs: false, // Secure by default
   validateCode: true
 });
@@ -59,18 +55,18 @@ import { getDynaJs } from '@ticatec/dyna-js';
 // Get the initialized loader
 const loader = getDynaJs();
 
-// Create form classes 
-const MyFormClass = loader.createFormClass(`
+// Create form classes
+const MyFormClass = loader.executeSync(`
   class CustomForm extends FlexiForm {
     constructor() {
       super();
-      this.dialog = Dialog; // Auto-injected
+      this.dialog = Dialog;
     }
-    
+
     show() {
-      MessageBox.info('Form is ready!'); // Auto-injected
+      MessageBox.info('Form is ready!');
     }
-    
+
     render() {
       return new FlexiCard({
         title: 'Dynamic Form',
@@ -90,51 +86,27 @@ form.show();
 
 ### Core Methods
 
-#### `createFormClass<T>(code: string, context?: object, injectedKeys?: string[]): T`
+#### `executeSync<T>(code: string, options?: ExecutionOptions): T`
 
-Creates a form class with proxy-based sandbox execution.
+Synchronously execute code and return the result directly.
 
 ```typescript
-const FormClass = loader.createFormClass(`
-  class MyForm extends FlexiForm {
-    constructor() {
-      super();
-      this.setupDialog();
-    }
-    
-    setupDialog() {
-      this.dialog = new Dialog({
-        title: 'Dynamic Dialog'
-      });
-    }
-  }
-  return MyForm;
-`, {
-  customData: 'additional context'
-}, ['extraKey']);
-```
-
-#### `executeSync<T>(code: string, options?: ExecutionOptions): ExecutionResult<T>`
-
-Synchronously execute code with result and timing information.
-
-```typescript
-const result = loader.executeSync(`
+const form = loader.executeSync(`
   const form = new FlexiForm();
   form.setTitle('Dynamic Form');
   return form;
 `);
 
-console.log(result.result); // FlexiForm instance
-console.log(result.executionTime); // Execution time in milliseconds
+console.log(form); // FlexiForm instance
+// Execution time is logged to console automatically
 ```
 
-#### `execute<T>(code: string, options?: ExecutionOptions): Promise<ExecutionResult<T>>`
+#### `execute<T>(code: string, options?: ExecutionOptions): Promise<T>`
 
 Asynchronously execute code with timeout support.
 
 ```typescript
-const result = await loader.execute(`
+const form = await loader.execute(`
   return new Promise(resolve => {
     const form = new FlexiForm();
     resolve(form);
@@ -143,14 +115,16 @@ const result = await loader.execute(`
   timeout: 3000,
   context: { customVar: 'value' }
 });
+
+console.log(form); // FlexiForm instance
 ```
 
-#### `executeWithImports<T>(code: string, imports: object, options?: ExecutionOptions): ExecutionResult<T>`
+#### `executeWithImports<T>(code: string, imports: object, options?: ExecutionOptions): T`
 
 Execute code with additional temporary imports.
 
 ```typescript
-const result = loader.executeWithImports(`
+const component = loader.executeWithImports(`
   return new CustomComponent({
     message: 'Hello from dynamic code!'
   });
@@ -169,8 +143,6 @@ interface DynaJsConfig {
   allowedGlobals?: string[];         // Whitelist of allowed global variables
   blockedGlobals?: string[];         // Blacklist of blocked variables
   defaultImports?: object;           // Pre-imported classes/functions
-  defaultInjectedKeys?: string[];    // Auto-injected variable names
-  useProxyByDefault?: boolean;       // Default: true
   allowTimers?: boolean;             // Allow setTimeout/setInterval (Default: false)
   allowDynamicImports?: boolean;     // Allow import()/require() (Default: false)
   validateCode?: boolean;            // Enable code validation (Default: true)
@@ -229,8 +201,7 @@ initializeDynaJs({
   },
   allowBrowserAPIs: false,     // Still secure
   allowTimers: false,          // No timers needed for forms
-  validateCode: true,          // Keep validation
-  defaultInjectedKeys: ['window'] // Only inject window reference
+  validateCode: true           // Keep validation
 });
 ```
 
@@ -239,14 +210,14 @@ initializeDynaJs({
 ### Creating Dynamic Form Components
 
 ```typescript
-const DynamicFormBuilder = loader.createFormClass(`
+const DynamicFormBuilder = loader.executeSync(`
   class FormBuilder extends FlexiForm {
     constructor(config) {
       super();
       this.config = config;
       this.components = [];
     }
-    
+
     addField(fieldConfig) {
       const field = new FlexiCard({
         title: fieldConfig.label,
@@ -255,7 +226,7 @@ const DynamicFormBuilder = loader.createFormClass(`
       this.components.push(field);
       return this;
     }
-    
+
     createInput(type) {
       switch(type) {
         case 'text':
@@ -266,11 +237,11 @@ const DynamicFormBuilder = loader.createFormClass(`
           return '<input type="text" />';
       }
     }
-    
+
     build() {
       return this.components;
     }
-    
+
     show() {
       const dialog = new Dialog({
         title: this.config.title,
@@ -278,12 +249,12 @@ const DynamicFormBuilder = loader.createFormClass(`
       });
       dialog.show();
     }
-    
+
     render() {
       return this.components.map(c => c.render()).join('');
     }
   }
-  
+
   return FormBuilder;
 `);
 
@@ -337,7 +308,7 @@ try {
   `);
 } catch (error) {
   console.error('Execution failed:', error.message);
-  // Error includes execution time and detailed error information
+  // Error message includes execution time and detailed error information
 }
 ```
 

package/README_CN.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://badge.fury.io/js/@ticatec%2Fdyna-js.svg)](https://badge.fury.io/js/@ticatec%2Fdyna-js)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org())
 [![Node.js](https://img.shields.io/badge/Node.js-14%2B-green.svg)](https://nodejs.org/)
 
 [English Documentation](README.md)
@@ -11,15 +11,13 @@
 
 ## 功能特性
 
-✅ **通用兼容性** - 同时支持 Node.js 和浏览器环境  
-✅ **TypeScript 支持** - 完整的类型安全和类型定义  
-✅ **单例模式** - 一次初始化，全局使用  
-✅ **模块导入** - 为动态代码预定义类和函数  
-✅ **基于代理的沙盒** - 使用代理机制的安全变量访问控制  
-✅ **可配置安全性** - 对允许的 API 和操作进行细粒度控制  
-✅ **表单类创建** - 专门用于创建动态表单类的方法  
-✅ **多种构建格式** - 支持 CommonJS 和 ESM  
-✅ **性能监控** - 内置执行时间跟踪  
+✅ **通用兼容性** - 同时支持 Node.js 和浏览器环境
+✅ **TypeScript 支持** - 完整的类型安全和类型定义
+✅ **单例模式** - 一次初始化，全局使用
+✅ **模块导入** - 为动态代码预定义类和函数
+✅ **可配置安全性** - 对允许的 API 和操作进行细粒度控制
+✅ **多种构建格式** - 支持 CommonJS 和 ESM
+✅ **性能监控** - 内置执行时间跟踪
 
 ## 安装
 
@@ -44,8 +42,6 @@ initializeDynaJs({
     FlexiContext: FlexiContextClass,
     ModuleLoader: ModuleLoaderClass
   },
-  defaultInjectedKeys: ['Dialog', 'MessageBox', 'Indicator', 'Toast'],
-  useProxyByDefault: true,
   allowBrowserAPIs: false, // 默认安全
   validateCode: true
 });
@@ -60,17 +56,17 @@ import { getDynaJs } from '@ticatec/dyna-js';
 const loader = getDynaJs();
 
 // 创建表单类
-const MyFormClass = loader.createFormClass(`
+const MyFormClass = loader.executeSync(`
   class CustomForm extends FlexiForm {
     constructor() {
       super();
-      this.dialog = Dialog; // 自动注入
+      this.dialog = Dialog;
     }
-    
+
     show() {
-      MessageBox.info('表单已就绪！'); // 自动注入
+      MessageBox.info('表单已就绪！');
     }
-    
+
     render() {
       return new FlexiCard({
         title: '动态表单',
@@ -90,51 +86,27 @@ form.show();
 
 ### 核心方法
 
-#### `createFormClass<T>(code: string, context?: object, injectedKeys?: string[]): T`
-
-使用基于代理的沙盒执行创建表单类。
-
-```typescript
-const FormClass = loader.createFormClass(`
-  class MyForm extends FlexiForm {
-    constructor() {
-      super();
-      this.setupDialog();
-    }
-    
-    setupDialog() {
-      this.dialog = new Dialog({
-        title: '动态对话框'
-      });
-    }
-  }
-  return MyForm;
-`, {
-  customData: '附加上下文'
-}, ['extraKey']);
-```
-
-#### `executeSync<T>(code: string, options?: ExecutionOptions): ExecutionResult<T>`
+#### `executeSync<T>(code: string, options?: ExecutionOptions): T`
 
-同步执行代码并返回结果和计时信息。
+同步执行代码并直接返回结果。
 
 ```typescript
-const result = loader.executeSync(`
+const form = loader.executeSync(`
   const form = new FlexiForm();
   form.setTitle('动态表单');
   return form;
 `);
 
-console.log(result.result); // FlexiForm 实例
-console.log(result.executionTime); // 执行时间（毫秒）
+console.log(form); // FlexiForm 实例
+// 执行时间会自动记录到控制台
 ```
 
-#### `execute<T>(code: string, options?: ExecutionOptions): Promise<ExecutionResult<T>>`
+#### `execute<T>(code: string, options?: ExecutionOptions): Promise<T>`
 
 异步执行代码，支持超时控制。
 
 ```typescript
-const result = await loader.execute(`
+const form = await loader.execute(`
   return new Promise(resolve => {
     const form = new FlexiForm();
     resolve(form);
@@ -143,14 +115,16 @@ const result = await loader.execute(`
   timeout: 3000,
   context: { customVar: 'value' }
 });
+
+console.log(form); // FlexiForm 实例
 ```
 
-#### `executeWithImports<T>(code: string, imports: object, options?: ExecutionOptions): ExecutionResult<T>`
+#### `executeWithImports<T>(code: string, imports: object, options?: ExecutionOptions): T`
 
 使用额外的临时导入执行代码。
 
 ```typescript
-const result = loader.executeWithImports(`
+const component = loader.executeWithImports(`
   return new CustomComponent({
     message: '来自动态代码的问候！'
   });
@@ -169,8 +143,6 @@ interface DynaJsConfig {
   allowedGlobals?: string[];         // 允许的全局变量白名单
   blockedGlobals?: string[];         // 阻止的变量黑名单
   defaultImports?: object;           // 预导入的类/函数
-  defaultInjectedKeys?: string[];    // 自动注入的变量名
-  useProxyByDefault?: boolean;       // 默认：true
   allowTimers?: boolean;             // 允许 setTimeout/setInterval（默认：false）
   allowDynamicImports?: boolean;     // 允许 import()/require()（默认：false）
   validateCode?: boolean;            // 启用代码验证（默认：true）
@@ -229,8 +201,7 @@ initializeDynaJs({
   },
   allowBrowserAPIs: false,     // 仍然安全
   allowTimers: false,          // 表单不需要定时器
-  validateCode: true,          // 保持验证
-  defaultInjectedKeys: ['window'] // 只注入 window 引用
+  validateCode: true           // 保持验证
 });
 ```
 
@@ -239,14 +210,14 @@ initializeDynaJs({
 ### 创建动态表单组件
 
 ```typescript
-const DynamicFormBuilder = loader.createFormClass(`
+const DynamicFormBuilder = loader.executeSync(`
   class FormBuilder extends FlexiForm {
     constructor(config) {
       super();
       this.config = config;
       this.components = [];
     }
-    
+
     addField(fieldConfig) {
       const field = new FlexiCard({
         title: fieldConfig.label,
@@ -255,7 +226,7 @@ const DynamicFormBuilder = loader.createFormClass(`
       this.components.push(field);
       return this;
     }
-    
+
     createInput(type) {
       switch(type) {
         case 'text':
@@ -266,11 +237,11 @@ const DynamicFormBuilder = loader.createFormClass(`
           return '<input type="text" />';
       }
     }
-    
+
     build() {
       return this.components;
     }
-    
+
     show() {
       const dialog = new Dialog({
         title: this.config.title,
@@ -278,12 +249,12 @@ const DynamicFormBuilder = loader.createFormClass(`
       });
       dialog.show();
     }
-    
+
     render() {
       return this.components.map(c => c.render()).join('');
     }
   }
-  
+
   return FormBuilder;
 `);
 
@@ -304,15 +275,15 @@ formBuilder
 const dynamicValidator = loader.createFunction(`
   return function validateForm(formData) {
     const errors = [];
-    
+
     if (!formData.name) {
       errors.push('姓名是必填项');
     }
-    
+
     if (!formData.email || !formData.email.includes('@')) {
       errors.push('需要有效的邮箱地址');
     }
-    
+
     return {
       isValid: errors.length === 0,
       errors: errors
@@ -337,7 +308,7 @@ try {
   `);
 } catch (error) {
   console.error('执行失败：', error.message);
-  // 错误包含执行时间和详细的错误信息
+  // 错误信息包含执行时间和详细的错误信息
 }
 ```
 
@@ -354,11 +325,11 @@ try {
 具有完整类型定义的 TypeScript 支持：
 
 ```typescript
-import { 
+import {
   DynaJs,
   ExecutionResult,
   ExecutionOptions,
-  ModuleImports 
+  ModuleImports
 } from '@ticatec/dyna-js';
 ```
 
@@ -395,9 +366,9 @@ MIT 许可证 - 详情请查看 [LICENSE](LICENSE) 文件。
 ### 动态表单创建
 ```typescript
 // 适合创建各种动态表单组件
-const ContactForm = loader.createFormClass(`...`);
-const SurveyForm = loader.createFormClass(`...`);
-const RegistrationForm = loader.createFormClass(`...`);
+const ContactForm = loader.executeSync(`...`);
+const SurveyForm = loader.executeSync(`...`);
+const RegistrationForm = loader.executeSync(`...`);
 ```
 
 ### 业务规则执行
@@ -414,7 +385,7 @@ const businessRule = loader.executeSync(`
 ### 模板渲染
 ```typescript
 // 动态模板处理
-const templateEngine = loader.createFormClass(`
+const templateEngine = loader.executeSync(`
   class TemplateEngine {
     render(template, data) {
       // 模板渲染逻辑