chore: update version to 1.1.0, enhance API design, and improve documentation

Author: iota9star

.github/workflows/precompile-binaries.yml

@@ -1,5 +1,9 @@
 name: Precompile Binaries
 
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: true
+
 on:
   workflow_dispatch:
     inputs:
@@ -8,8 +12,6 @@ on:
         required: true
         default: ''
   push:
-    tags:
-      - v*
 
 env:
   GITHUB_REPOSITORY: fluttercandies/fjs
@@ -71,6 +73,9 @@ jobs:
         if: matrix.os == 'macos-latest'
         run: |
           export IPHONEOS_DEPLOYMENT_TARGET=12.0
+          export MACOSX_DEPLOYMENT_TARGET=12.0
+          # Set environment variables that work for both iOS device and simulator builds
+          export BINDGEN_EXTRA_CLANG_ARGS="-target aarch64-apple-ios12.0"
           dart run cargokit/build_tool/bin/build_tool.dart precompile-binaries -v --manifest-dir=${{ env.RUST_CRATE_DIR }} --repository=${{ env.GITHUB_REPOSITORY }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.1.0
+
+* **FEATURE**: Enhanced API design with improved high-level interface
+* **FEATURE**: Advanced example application with interactive playground, responsive layout, haptic feedback, and local storage
+* **FEATURE**: New module management methods `declareNewModule`, `declareNewModules`, and `clearNewModules` for better module handling
+* **FEATURE**: Built-in modules are now configured during runtime creation via `JsAsyncRuntime.withOptions()`
+* **DEPRECATED**: Removed `enableBuiltinModule()` method - use runtime options instead
+* **DEPRECATED**: Removed `declareModule()` method - use `declareNewModule()` instead
+* **DEPRECATED**: Removed `importModule()` method
+* **DOCS**: Comprehensive documentation updates with detailed examples and API reference
+* **DOCS**: Enhanced quick start guide and advanced usage examples
+* **PERF**: Improved memory management and garbage collection controls
+* **PERF**: Better error handling and recovery mechanisms
+* **INTERNAL**: Updated dependencies for better compatibility
+* **INTERNAL**: Enhanced build system for faster development cycles
+
+## 1.0.9
+
+* Bug fixes and stability improvements
+
 ## 1.0.3
 
 * Precompiled binaries support for macOS, iOS, Linux, Windows, and Android

README.md

@@ -72,9 +72,17 @@ Future<void> main() async {
 ### 🔧 2. Create a JavaScript Engine
 
 ```dart
-// Create runtime and context
-final runtime = JsAsyncRuntime();
-final context = await JsAsyncContext.from(rt: runtime);
+// Create runtime with built-in options
+final runtime = await JsAsyncRuntime.withOptions(
+  builtin: JsBuiltinOptions(
+    fetch: true,
+    console: true,
+    timers: true,
+  ),
+);
+
+// Create context
+final context = await JsAsyncContext.from(runtime);
 
 // Create engine with bridge support
 final engine = JsEngine(context);
@@ -101,16 +109,10 @@ final asyncResult = await engine.eval(JsCode.code('''
 '''));
 ```
 
-### 🌐 4. Enable Built-in Modules
+### 🌐 4. Use Built-in Modules
 
 ```dart
-// Enable fetch and console APIs
-await engine.enableBuiltinModule(const JsBuiltinOptions(
-  fetch: true,
-  console: true,
-  timers: true,
-));
-
+// Built-in modules are enabled during runtime creation
 // Now you can use fetch, console.log, setTimeout, etc.
 await engine.eval(JsCode.code('''
   console.log('Hello from JavaScript!');
@@ -121,7 +123,7 @@ await engine.eval(JsCode.code('''
 ### 📦 5. Work with Modules
 
 ```dart
-// Declare a module
+// Declare a single module
 const moduleCode = '''
 export function greet(name) {
   return `Hello, ${name}!`;
@@ -130,15 +132,26 @@ export function greet(name) {
 export const version = '1.0.0';
 ''';
 
-await engine.declareModule(
+await engine.declareNewModule(
   JsModule.code(module: 'greeting', code: moduleCode)
 );
 
-// Use the module
+// Declare multiple modules at once
+await engine.declareNewModules([
+  JsModule.code('math', 'export const add = (a, b) => a + b;'),
+  JsModule.code('string', 'export const reverse = (s) => s.split("").reverse().join("");'),
+]);
+
+// Use the modules
 await engine.eval(JsCode.code('''
   import { greet, version } from 'greeting';
+  import { add } from 'math';
+  import { reverse } from 'string';
+  
   console.log(greet('Flutter'));
   console.log('Version:', version);
+  console.log('Add 2 + 3:', add(2, 3));
+  console.log('Reverse hello:', reverse('hello'));
 '''));
 ```
 
@@ -242,13 +255,11 @@ class JsEngine {
   // Execute JavaScript code
   Future<JsValue> eval(JsCode source, {JsEvalOptions? options, Duration? timeout});
   
-  // Enable built-in modules
-  Future<JsValue> enableBuiltinModule(JsBuiltinOptions options, {Duration? timeout});
-  
   // Module operations
-  Future<JsValue> declareModule(JsModule module, {Duration? timeout});
+  Future<JsValue> declareNewModule(JsModule module, {Duration? timeout});
+  Future<JsValue> declareNewModules(List<JsModule> modules, {Duration? timeout});
   Future<JsValue> evaluateModule(JsModule module, {Duration? timeout});
-  Future<JsValue> importModule(String specifier, {Duration? timeout});
+  Future<JsValue> clearNewModules({Duration? timeout});
   
   // Cleanup
   Future<void> dispose();
@@ -318,11 +329,6 @@ Check out the [example](example/) directory for more comprehensive examples incl
 - **Production**: Real iOS devices (arm64) are fully supported with normal performance
 - **Minimum iOS Version**: Requires iOS 12.0 or later due to native library dependencies
 
-### Android Platform Limitations
-
-- **Crypto Module**: The built-in crypto module is not supported on Android platform
-- **Impact**: Applications requiring cryptographic functions on Android should use Dart's crypto libraries or platform-specific implementations
-
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

README_zh.md

@@ -72,9 +72,17 @@ Future<void> main() async {
 ### 🔧 2. 创建 JavaScript 引擎
 
 ```dart
-// 创建运行时和上下文
-final runtime = JsAsyncRuntime();
-final context = await JsAsyncContext.from(rt: runtime);
+// 创建带内置选项的运行时
+final runtime = await JsAsyncRuntime.withOptions(
+  builtin: JsBuiltinOptions(
+    fetch: true,
+    console: true,
+    timers: true,
+  ),
+);
+
+// 创建上下文
+final context = await JsAsyncContext.from(runtime);
 
 // 创建支持桥接的引擎
 final engine = JsEngine(context);
@@ -101,16 +109,10 @@ final asyncResult = await engine.eval(JsCode.code('''
 '''));
 ```
 
-### 🌐 4. 启用内置模块
+### 🌐 4. 使用内置模块
 
 ```dart
-// 启用 fetch 和 console API
-await engine.enableBuiltinModule(const JsBuiltinOptions(
-  fetch: true,
-  console: true,
-  timers: true,
-));
-
+// 内置模块在运行时创建期间启用
 // 现在可以使用 fetch、console.log、setTimeout 等
 await engine.eval(JsCode.code('''
   console.log('你好，来自 JavaScript！');
@@ -121,7 +123,7 @@ await engine.eval(JsCode.code('''
 ### 📦 5. 使用模块
 
 ```dart
-// 声明模块
+// 声明单个模块
 const moduleCode = '''
 export function greet(name) {
   return `你好，${name}！`;
@@ -130,15 +132,26 @@ export function greet(name) {
 export const version = '1.0.0';
 ''';
 
-await engine.declareModule(
+await engine.declareNewModule(
   JsModule.code(module: 'greeting', code: moduleCode)
 );
 
+// 一次声明多个模块
+await engine.declareNewModules([
+  JsModule.code('math', 'export const add = (a, b) => a + b;'),
+  JsModule.code('string', 'export const reverse = (s) => s.split("").reverse().join("");'),
+]);
+
 // 使用模块
 await engine.eval(JsCode.code('''
   import { greet, version } from 'greeting';
+  import { add } from 'math';
+  import { reverse } from 'string';
+  
   console.log(greet('Flutter'));
   console.log('版本:', version);
+  console.log('加法 2 + 3:', add(2, 3));
+  console.log('反转 hello:', reverse('hello'));
 '''));
 ```
 
@@ -242,13 +255,11 @@ class JsEngine {
   // 执行 JavaScript 代码
   Future<JsValue> eval(JsCode source, {JsEvalOptions? options, Duration? timeout});
   
-  // 启用内置模块
-  Future<JsValue> enableBuiltinModule(JsBuiltinOptions options, {Duration? timeout});
-  
   // 模块操作
-  Future<JsValue> declareModule(JsModule module, {Duration? timeout});
+  Future<JsValue> declareNewModule(JsModule module, {Duration? timeout});
+  Future<JsValue> declareNewModules(List<JsModule> modules, {Duration? timeout});
   Future<JsValue> evaluateModule(JsModule module, {Duration? timeout});
-  Future<JsValue> importModule(String specifier, {Duration? timeout});
+  Future<JsValue> clearNewModules({Duration? timeout});
   
   // 清理
   Future<void> dispose();
@@ -318,11 +329,6 @@ sealed class JsValue {
 - **生产环境**: 真实 iOS 设备 (arm64) 完全支持，性能正常
 - **最低系统要求**: 需要 iOS 12.0 或更高版本，由于原生库依赖
 
-### Android 平台限制
-
-- **Crypto 模块**: Android 平台不支持内置的 crypto 模块
-- **影响**: 在 Android 上需要加密功能的应用应使用 Dart 的 crypto 库或平台特定的实现
-
 ## 🤝 贡献
 
 欢迎贡献代码！请随时提交 Pull Request。

build.yaml

@@ -4,5 +4,4 @@ targets:
       freezed:
         generate_for:
           include:
-            - lib/src/frb/api/js.dart
-            - lib/src/frb/api/value.dart
+            - lib/src/frb/api/*.dart

cargokit/build_tool/lib/src/target.dart

@@ -55,13 +55,8 @@ class Target {
       flutter: 'linux-arm64',
     ),
     Target(
-      rust: 'x86_64-apple-darwin',
-      darwinPlatform: 'macosx',
-      darwinArch: 'x86_64',
-    ),
-    Target(
-      rust: 'aarch64-apple-darwin',
-      darwinPlatform: 'macosx',
+      rust: 'aarch64-apple-ios-sim',
+      darwinPlatform: 'iphonesimulator',
       darwinArch: 'arm64',
     ),
     Target(
@@ -70,13 +65,18 @@ class Target {
       darwinArch: 'x86_64',
     ),
     Target(
-      rust: 'aarch64-apple-ios-sim',
-      darwinPlatform: 'iphonesimulator',
+      rust: 'aarch64-apple-ios',
+      darwinPlatform: 'iphoneos',
       darwinArch: 'arm64',
     ),
     Target(
-      rust: 'aarch64-apple-ios',
-      darwinPlatform: 'iphoneos',
+      rust: 'x86_64-apple-darwin',
+      darwinPlatform: 'macosx',
+      darwinArch: 'x86_64',
+    ),
+    Target(
+      rust: 'aarch64-apple-darwin',
+      darwinPlatform: 'macosx',
       darwinArch: 'arm64',
     ),
   ];

example/README.md

@@ -23,7 +23,7 @@ android {
         applicationId = "app.fjs_example"
         // You can update the following values to match your application needs.
         // For more information, see: https://flutter.dev/to/review-gradle-config.
-        minSdk = 21
+        minSdkVersion = flutter.minSdkVersion
         targetSdk = 36
         versionCode = flutter.versionCode
         versionName = flutter.versionName

example/android/app/build.gradle

@@ -21,6 +21,6 @@
   <key>CFBundleVersion</key>
   <string>1.0</string>
   <key>MinimumOSVersion</key>
-  <string>12.0</string>
+  <string>13.0</string>
 </dict>
 </plist>

example/ios/Flutter/AppFrameworkInfo.plist

@@ -1,5 +1,5 @@
 # Uncomment this line to define a global platform for your project
-# platform :ios, '12.0'
+# platform :ios, '13.0'
 
 # CocoaPods analytics sends network stats synchronously affecting flutter build latency.
 ENV['COCOAPODS_DISABLE_STATS'] = 'true'