anseronui 0.0.1 → 0.0.2

package/README.md

@@ -38,26 +38,6 @@ npm run android
 
 `setup` 使用随 npm 包提供的编译器源码准备构建环境，首次会安装依赖，无需 Git。升级 AnseronUI 后需重新执行 `npm run setup`。
 
-<details>
-<summary>尚未发布时：使用仓库生成本地 npm 包体验</summary>
-
-从框架仓库根目录执行以下命令。生成后的应用使用与 npm 发布包相同的工程结构和开发命令：
-
-```sh
-npm ci --ignore-scripts
-npm pack --pack-destination /tmp
-node scripts/anseronui.mjs create ../awesomeAnseron --application-id com.example.awesomeanseron --package /tmp/anseronui-0.1.0.tgz
-cd ../awesomeAnseron
-npm install
-npm run setup
-npm run ios
-# 或运行 Android：npm run android
-```
-
-保留本地 tarball，供后续重新安装依赖使用；不要覆盖已有 App 目录。
-
-</details>
-
 ### iOS
 
 在应用目录执行 `npm run ios`，CLI 会构建应用、安装到模拟器并启动。默认使用唯一已启动模拟器；没有已启动的模拟器时，会选择并启动一个可用 iPhone。存在多个候选时，指定设备名称或 UUID：
@@ -211,3 +191,135 @@ AnseronUI 支持把共享页面嵌入已有宿主。iOS 和 Android 使用 `Anse
 AnseronUI 自有代码采用 [MIT 协议](LICENSE)，允许商业使用、修改和再分发，分发时需保留版权及许可声明。
 
 [Flexily](https://github.com/beorn/flexily) 保留上游 MIT 协议；[scriptc](https://github.com/vercel-labs/scriptc) 及本仓库对其的 async embedding 适配继续使用 Apache-2.0。分发 SDK 或包含第三方 runtime 的 App 时，还需保留适用的许可证与声明，详见[第三方声明](THIRD_PARTY_NOTICES.md)。
+
+## 安装 npm 原生插件
+
+独立 App（通过 `anseronui create` 创建）支持从 npm 自动接入原生模块、自定义原生组件和 Web 适配。安装到应用的生产依赖，然后重新构建：
+
+```bash
+npm install @your-scope/anseronui-device
+npm run check
+npm run ios
+# 或 npm run android / npm run build:web
+```
+
+上面的包名是占位示例。构建会扫描已安装的 `dependencies`、`optionalDependencies` 及其传递依赖，读取包的 `anseronui` 声明，生成注册表，将插件源码、平台依赖和权限配置加入工程。无需在 App 入口逐个手写注册；`devDependencies` 和仅声明为 peer 的包不参与扫描。`npm run check` 在安装依赖后会列出发现的插件。新增、升级或卸载插件后必须重新构建，`--no-build` 仅运行已有 App。
+
+插件生成文件位于应用的 `.anseronui/plugins/`，每次 setup/build 都会重新生成，勿手动修改。插件缺少当前平台适配时，构建会提前报错；插件之间重复的模块/组件名在宿主创建注册表时报错，框架保留模块名也不能覆盖。
+
+## 发布带原生能力的 npm 包
+
+可以把 TS API、Swift/Kotlin 原生实现和 Web 适配放在同一个 npm 包中。完整可复制示例位于 [`examples/native-plugin`](examples/native-plugin)，它提供 `useDevice().info()`，通过现有异步 Module 接口读取设备信息。发布自己的插件时，替换示例包名、工厂类型和模块名。
+
+推荐目录：
+
+```text
+anseronui-device/
+├── package.json
+├── src/index.ts          # 共享 TS API，参与 AOT 编译
+├── ios/DevicePlugin.swift
+├── android/DevicePlugin.kt
+└── web/index.ts          # 浏览器适配，与共享 Core 分开编译
+```
+
+在 `package.json` 中声明发布文件、框架 peer 依赖和插件清单：
+
+```json
+{
+  "name": "@your-scope/anseronui-device",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": { ".": "./src/index.ts" },
+  "files": ["src", "ios", "android", "web"],
+  "peerDependencies": { "anseronui": "^0.0.1" },
+  "anseronui": {
+    "schemaVersion": 1,
+    "typescript": "src/index.ts",
+    "ios": {
+      "sources": ["ios"],
+      "factory": "AnseronDevicePlugin",
+      "frameworks": ["UIKit"]
+    },
+    "android": {
+      "sources": ["android"],
+      "factory": "org.anseronui.device.DevicePlugin"
+    },
+    "web": { "entry": "web/index.ts" }
+  }
+}
+```
+
+所有源码路径相对于插件包根目录，必须包含在 npm 发布包内，不能越出包目录。`sources` 是目录列表：iOS 递归纳入 `.swift` 文件，Android 纳入 Kotlin/Java 源码目录。Swift 工厂类型需使用简单标识符，Android 工厂使用完整类名；为类型加上自己的命名前缀，避免不同插件冲突。
+
+三端工厂约定如下，原生模块和组件都通过返回的注册表声明：
+
+| 平台 | 工厂入口 | 返回值 |
+| --- | --- | --- |
+| iOS | `@MainActor` 类型的 `static func createExtensions()` | `IOSPlatformExtensions` |
+| Android | Kotlin `object` 的 `fun createExtensions(context: Context)` | `AndroidPlatformExtensions` |
+| Web | `web.entry` 导出的 `createExtensions()` | `PlatformExtensions` |
+
+iOS 插件 Swift 源码与渲染器一起编译进 App target，直接使用 `IOSPlatformExtensions` 等类型，不需要 `import AnseronUIRenderIOS`。Android 使用 `org.anseronui.render` 中的公开类型；工厂接收当前宿主 Context，可由此使用 Activity 能力。Web 的 `createExtensions()` 同步返回 `modules` / `components`，其中模块处理器可以异步执行。每次创建宿主都会调用工厂，请将监听器和资源释放接到现有取消函数或组件 `dispose()` 上。具体 Module、组件、JSON 数据与生命周期约束见[原生扩展](docs/native-extensions.md)。
+
+共享 TS 入口可以这样包装平台模块，供业务组件使用：
+
+```ts
+import { useServices } from 'anseronui/ui';
+
+export interface DeviceInfo { platform: string; version: string }
+
+export function useDevice() {
+  const services = useServices();
+  return {
+    info(): Promise<DeviceInfo> {
+      return services.invoke<DeviceInfo>('example.device', 'info');
+    },
+  };
+}
+```
+
+用户在函数组件内调用 `useDevice()`，再在事件或 effect 中调用 `device.info()`。共享 TS 入口必须是 `.ts` 源码，内部可通过相对路径引用同一源码目录下的 TS/TSX 文件；当前自动映射插件包的主入口，不支持包子路径 exports。仍需遵守 [TS/TSX 编写限制](docs/typescript-limitations.md)，插件声明不会让任意 Node.js、React Native 或浏览器 API 自动获得跨端支持。
+
+需要权限或 Android Maven 依赖时，可在对应平台声明中增加以下字段（仅按插件实际需要声明）：
+
+```json
+{
+  "ios": {
+    "sources": ["ios"],
+    "factory": "AnseronCameraPlugin",
+    "frameworks": ["AVFoundation"],
+    "infoPlist": { "NSCameraUsageDescription": "用于扫描二维码" }
+  },
+  "android": {
+    "sources": ["android"],
+    "factory": "com.example.camera.CameraPlugin",
+    "dependencies": ["androidx.core:core-ktx:1.15.0"],
+    "permissions": ["android.permission.CAMERA"]
+  }
+}
+```
+
+`ios.infoPlist` 当前只接受 `NS…UsageDescription` 字符串。构建使用合并后的生成 plist，保留应用自己的 `platforms/ios/Info.plist`；应用中的同名说明优先，不同插件的默认说明不一致时会报错。Android 权限自动进入 Debug/Release 合并清单；危险权限的运行时请求仍由插件实现。Maven 依赖使用固定 `group:artifact:version` 坐标，从工程现有仓库解析。
+
+当前版本自动接入的范围是 Swift 源码、Kotlin/Java 源码、iOS 系统 framework、Android Maven 依赖、权限和 Web 适配。CocoaPods、Swift Package 依赖、二进制 SDK、原生资源、entitlements、Android 自定义清单组件等仍需宿主额外配置；React Native 插件需要按本协议适配。旧版生成工程需对照新模板接入生成注册表、iOS 工程生成脚本和 Android Gradle 配置；已有原生工程的 `integrate` 模式继续由宿主管理平台构建和注册。
+
+发布前先在插件目录检查真实发布内容，再在测试 App 中安装本地压缩包，验证目标平台：
+
+```bash
+# 插件目录
+npm pack --dry-run
+npm pack
+
+# 测试 App 目录；替换为 npm pack 输出文件的绝对路径
+npm install /absolute/path/your-scope-anseronui-device-0.1.0.tgz
+npm run check
+npm run typecheck
+npm run ios
+npm run android
+npm run build:web
+
+# 验证通过后，回到插件目录发布公开的 scoped 包
+npm publish --access public
+```
+
+提交锁文件并验证所有声明支持的平台。插件包的 `files` 必须包含 TS 源码和原生实现，不能只发布编译后的 JS 或 `.d.ts`。框架本身尚未发布到 npm 时，测试 App 应先按本文的本地 npm 包流程安装 `anseronui`，再安装插件。

package/dist/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anseronui-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "license": "MIT"
 }

package/dist/sdk/packages/render-android/src/main/java/org/anseronui/render/AndroidRenderer.kt

@@ -221,13 +221,20 @@ class AndroidRenderer(val root: FrameLayout, private val extensions: AndroidPlat
 
     fun viewFor(nodeId: Long): View? = nodes[nodeId]?.view
 
+    private fun systemButton() = Button(root.context).apply {
+        setAllCaps(false)
+        minWidth = 0
+        minHeight = 0
+        setPadding((12 * density).roundToInt(), (6 * density).roundToInt(), (12 * density).roundToInt(), (6 * density).roundToInt())
+    }
+
     /** Call on the UI thread; real controls measure their own text and padding. */
     fun measure(kind: String, text: String, fontSize: Float, maxWidth: Float, props: JSONObject? = null): TextSize {
         require(Looper.myLooper() == Looper.getMainLooper()) { "Measurement must run on the UI thread" }
         require(fontSize.isFinite() && fontSize >= 0 && maxWidth.isFinite() && maxWidth >= 0)
         val view: TextView = when (kind) {
             "Text", "RichText" -> TextView(root.context)
-            "Button" -> Button(root.context)
+            "Button" -> systemButton()
             "TextInput" -> EditText(root.context)
             else -> error("Unknown text kind")
         }
@@ -282,7 +289,7 @@ class AndroidRenderer(val root: FrameLayout, private val extensions: AndroidPlat
                 "View" -> { view = FrameLayout(root.context); content = view }
                 "Text" -> { view = TextView(root.context); content = null }
                 "RichText" -> { view = TextView(root.context); content = null }
-                "Button" -> { view = Button(root.context); content = null }
+                "Button" -> { view = systemButton(); content = null }
                 "TextInput" -> { view = EditText(root.context); content = null }
                 "ScrollView" -> {
                     val scroll = TouchScrollView().apply { isFillViewport = true }
@@ -444,7 +451,7 @@ class AndroidRenderer(val root: FrameLayout, private val extensions: AndroidPlat
         background.setStroke((props.optDouble("borderWidth", 0.0) * density).roundToInt(), parseColor(props.optString("borderColor", ""), Color.TRANSPARENT))
         if (view is TextView) {
             view.textSize = props.optDouble("fontSize", 16.0).toFloat()
-            view.setTextColor(parseColor(props.optString("color", ""), Color.BLACK))
+            view.setTextColor(parseColor(props.optString("color", ""), if (record.kind == "Button") Color.rgb(0, 122, 255) else Color.BLACK))
             view.typeface = android.graphics.Typeface.create(view.typeface, if (props.optString("fontWeight") == "bold") android.graphics.Typeface.BOLD else android.graphics.Typeface.NORMAL)
             if (props.optString("fontStyle") == "italic") view.setTypeface(view.typeface, android.graphics.Typeface.ITALIC)
             view.gravity = when (props.optString("textAlign")) { "center" -> android.view.Gravity.CENTER_HORIZONTAL; "right" -> android.view.Gravity.RIGHT; else -> android.view.Gravity.LEFT }
@@ -490,9 +497,12 @@ class AndroidRenderer(val root: FrameLayout, private val extensions: AndroidPlat
                     view.movementMethod = LinkMovementMethod.getInstance()
                 }
                 "Button" -> {
+                    view.setAllCaps(false)
                     view.text = props.optString("title", "")
-                    val normal = parseColor(props.optString("color", ""), Color.BLACK)
-                    val disabled = Color.argb((Color.alpha(normal) * 0.45f).roundToInt(), Color.red(normal), Color.green(normal), Color.blue(normal))
+                    val normal = parseColor(props.optString("color", ""), Color.rgb(0, 122, 255))
+                    val disabled = if (props.has("color")) {
+                        Color.argb((Color.alpha(normal) * 0.4f).roundToInt(), Color.red(normal), Color.green(normal), Color.blue(normal))
+                    } else Color.rgb(142, 142, 147)
                     view.setTextColor(ColorStateList(
                         arrayOf(intArrayOf(-android.R.attr.state_enabled), intArrayOf()),
                         intArrayOf(disabled, normal)

package/dist/sdk/packages/render-web/src/renderer.ts

@@ -191,7 +191,14 @@ export class DOMRenderer {
         video.addEventListener("loadeddata", () => record.enabled.has("firstFrameDidDisplay") && this.onEvent({ type: "NativeEvent", nodeId: command.nodeId, revision: this.revision, event: "firstFrameDidDisplay" }));
         video.addEventListener("timeupdate", () => record.enabled.has("playTimeDidChanged") && this.onEvent({ type: "NativeEvent", nodeId: command.nodeId, revision: this.revision, event: "playTimeDidChanged", x: Math.round(video.currentTime * 1000), duration: Number.isFinite(video.duration) ? Math.round(video.duration * 1000) : 0 }));
       }
-      if (command.kind === "Button") element.setAttribute("type", "button");
+      if (command.kind === "Button") {
+        element.setAttribute("type", "button");
+        Object.assign(element.style, {
+          appearance: "none", boxSizing: "border-box", border: "0", borderRadius: "0",
+          background: "transparent", padding: "6px 12px", color: "#007aff",
+          font: "16px system-ui, -apple-system, BlinkMacSystemFont, sans-serif", cursor: "pointer",
+        });
+      }
       const record: NodeRecord = { element, animation: new NodeAnimation(values => paintElement(element, values)), native, kind: command.kind, enabled: new Set(), composing: false, inputRevision: 0, pendingInputRevision: 0, pendingValue: null };
       this.records.set(command.nodeId, record);
       element.dataset.tsnNode = String(command.nodeId);
@@ -341,8 +348,8 @@ export class DOMRenderer {
     const visual = { ...visualDefaults, ...colorValues(String(props.backgroundColor ?? "transparent")) };
     for (const key of ["opacity", "translateX", "translateY", "scaleX", "scaleY", "rotate", "borderRadius"]) if (typeof props[key] === "number") visual[key] = props[key] as number;
     record.animation.stage(visual);
-    element.style.color = String(props.color ?? "");
-    element.style.fontSize = props.fontSize === undefined ? "" : props.fontSize + "px";
+    element.style.color = String(props.color ?? (record.kind === "Button" ? (props.disabled === true ? "#8e8e93" : "#007aff") : ""));
+    element.style.fontSize = props.fontSize === undefined ? (record.kind === "Button" ? "16px" : "") : props.fontSize + "px";
     element.style.fontWeight = String(props.fontWeight ?? "");
     element.style.fontStyle = String(props.fontStyle ?? "");
     element.style.textAlign = String(props.textAlign ?? "");

package/dist/sdk/scripts/anseronui.mjs

@@ -7,6 +7,8 @@ import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
 import { createStandalone, buildStandalone, runStandalone, setupStandalone, typecheckStandalone, devStandalone } from "./standalone-app.mjs";
 
+import { discoverNativePlugins } from "./native-plugins.mjs";
+
 const frameworkRoot = resolve(fileURLToPath(new URL("../", import.meta.url)));
 const requestedCommand = process.argv[2] ?? "help";
 const command = ["--help", "-h"].includes(requestedCommand) ? "help" : ["--version", "-v"].includes(requestedCommand) ? "version" : requestedCommand;
@@ -77,6 +79,10 @@ function checkApp() {
     const sourceCandidates = config.schemaVersion === 2 ? [resolve(dirname(configPath), page.source)] : [resolve(frameworkRoot, page.source), resolve(dirname(configPath), page.source)];
     if (!sourceCandidates.some(existsSync)) throw new Error(`Page source not found: ${page.source}`);
   }
+  if (config.app && existsSync(join(dirname(configPath), "node_modules"))) {
+    const plugins = discoverNativePlugins(dirname(configPath));
+    console.log(`Native plugins: ${plugins.map(plugin => plugin.name).join(", ") || "(none)"}`);
+  }
   console.log(`AnseronUI config OK: ${configPath}`);
   console.log(`Pages: ${config.pages.map(page => page.source).join(", ")}`);
 }

package/dist/sdk/scripts/native-plugins.mjs

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, realpathSync, readdirSync, mkdirSync, writeFileSync, renameSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve, relative, sep, isAbsolute } from 'node:path';
+
+const read = file => JSON.parse(readFileSync(file, 'utf8'));
+const posix = path => path.split(sep).join('/');
+const identifier = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const qualified = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/;
+const packageName = /^(?:@[a-z0-9._-]+\/)?[a-z0-9][a-z0-9._-]*$/;
+function check(condition, message) { if (!condition) throw new Error(`Native plugin: ${message}`); }
+function fields(value, allowed, label) {
+  check(value && typeof value === 'object' && !Array.isArray(value), `${label} must be an object`);
+  for (const key of Object.keys(value)) check(allowed.includes(key), `${label}: unknown field ${key}`);
+}
+function strings(value, label, pattern) {
+  check(Array.isArray(value) && value.every(item => typeof item === 'string' && (!pattern || pattern.test(item))), `${label} must be an array of valid strings`);
+  return value;
+}
+function inside(root, path) {
+  check(typeof path === 'string' && path.length && !isAbsolute(path), `expected package-relative path: ${path}`);
+  const result = realpathSync(resolve(root, path));
+  const rel = relative(root, result);
+  check(rel !== '..' && !rel.startsWith('..' + sep) && !isAbsolute(rel), `path escapes package: ${path}`);
+  return result;
+}
+function sourceFiles(root, paths, extensions) {
+  const files = new Set();
+  function walk(path) {
+    const entries = readdirSync(path, { withFileTypes: true });
+    for (const entry of entries) {
+      check(!entry.isSymbolicLink(), `source symlinks are unsupported: ${join(path, entry.name)}`);
+      if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue;
+      const next = join(path, entry.name);
+      if (entry.isDirectory()) walk(next);
+      else if (extensions.some(ext => entry.name.endsWith(ext))) files.add(next);
+    }
+  }
+  for (const path of strings(paths, 'sources')) walk(inside(root, path));
+  check(files.size, `no ${extensions.join('/')} sources found in ${root}`);
+  return [...files].sort();
+}
+function locate(from, name) {
+  check(packageName.test(name), `invalid dependency name ${name}`);
+  const resolver = createRequire(join(from, 'package.json'));
+  for (const directory of resolver.resolve.paths(name) ?? []) {
+    const file = join(directory, name, 'package.json');
+    if (existsSync(file)) return realpathSync(file);
+  }
+  return null;
+}
+
+/** Discover installed production dependencies, including transitive and scoped packages. */
+export function discoverNativePlugins(app) {
+  const seen = new Set(); const plugins = new Map();
+  function visit(file) {
+    file = realpathSync(file);
+    if (seen.has(file)) return;
+    seen.add(file);
+    const pkg = read(file); const root = dirname(file); const spec = pkg.anseronui;
+    if (spec !== undefined) {
+      check(packageName.test(pkg.name), `invalid package name ${pkg.name}`);
+      check(!plugins.has(pkg.name), `multiple installed versions of ${pkg.name}`);
+      fields(spec, ['schemaVersion', 'typescript', 'ios', 'android', 'web'], pkg.name);
+      check(spec.schemaVersion === 1, `${pkg.name}: schemaVersion must be 1`);
+      const entry = inside(root, spec.typescript);
+      check(entry.endsWith('.ts') && !entry.endsWith('.d.ts'), `${pkg.name}: typescript must point to a .ts source entry`);
+      const plugin = { name: pkg.name, root, entry };
+      if (spec.ios !== undefined) {
+        fields(spec.ios, ['sources', 'factory', 'frameworks', 'infoPlist'], `${pkg.name}.ios`);
+        check(typeof spec.ios.factory === 'string' && identifier.test(spec.ios.factory), `${pkg.name}: invalid Swift factory type`);
+        const frameworks = strings(spec.ios.frameworks ?? [], 'ios.frameworks', identifier);
+        const infoPlist = spec.ios.infoPlist ?? {};
+        fields(infoPlist, Object.keys(infoPlist), 'ios.infoPlist');
+        for (const [key, value] of Object.entries(infoPlist)) check(/^NS[A-Za-z0-9]+UsageDescription$/.test(key) && typeof value === 'string' && value.trim(), `invalid iOS usage description ${key}`);
+        plugin.ios = { sources: sourceFiles(root, spec.ios.sources, ['.swift']), factory: spec.ios.factory, frameworks, infoPlist };
+      }
+      if (spec.android !== undefined) {
+        fields(spec.android, ['sources', 'factory', 'dependencies', 'permissions'], `${pkg.name}.android`);
+        check(typeof spec.android.factory === 'string' && qualified.test(spec.android.factory), `${pkg.name}: invalid Kotlin factory type`);
+        plugin.android = {
+          sources: strings(spec.android.sources, 'android.sources').map(path => inside(root, path)),
+          factory: spec.android.factory,
+          dependencies: strings(spec.android.dependencies ?? [], 'android.dependencies', /^[A-Za-z0-9_.-]+:[A-Za-z0-9_.-]+:[A-Za-z0-9_.+-]+$/),
+          permissions: strings(spec.android.permissions ?? [], 'android.permissions', qualified),
+        };
+        sourceFiles(root, spec.android.sources, ['.kt', '.java']);
+      }
+      if (spec.web !== undefined) {
+        fields(spec.web, ['entry'], `${pkg.name}.web`);
+        plugin.web = { entry: inside(root, spec.web.entry) };
+      }
+      check(plugin.ios || plugin.android || plugin.web, `${pkg.name}: declare at least one platform`);
+      plugins.set(pkg.name, plugin);
+    }
+    const optional = pkg.optionalDependencies ?? {};
+    for (const name of Object.keys({ ...pkg.dependencies, ...optional }).sort()) {
+      const dependency = locate(root, name);
+      if (!dependency) { check(name in optional, `missing dependency ${name}; run npm install`); continue; }
+      visit(dependency);
+    }
+  }
+  visit(join(app, 'package.json'));
+  return [...plugins.values()].sort((a, b) => a.name.localeCompare(b.name, 'en'));
+}
+
+/** Generated outputs belong to the app and are replaced on each setup/build. */
+export function generateNativePlugins(app, plugins, target) {
+  const platform = target?.startsWith('ios') ? 'ios' : target;
+  if (platform) for (const plugin of plugins) check(plugin[platform], `${plugin.name} does not support ${platform}`);
+  const directory = join(app, '.anseronui/plugins');
+  // Validate before replacing any previous output.
+  const infoPlist = {};
+  for (const plugin of plugins) for (const [key, value] of Object.entries(plugin.ios?.infoPlist ?? {})) {
+    check(!(key in infoPlist) || infoPlist[key] === value, `conflicting iOS usage description ${key}`);
+    infoPlist[key] = value;
+  }
+  mkdirSync(directory, { recursive: true });
+  const write = (file, text) => {
+    const destination = join(directory, file);
+    if (existsSync(destination) && readFileSync(destination, 'utf8') === text) return;
+    const temporary = destination + `.${process.pid}.tmp`;
+    writeFileSync(temporary, text);
+    renameSync(temporary, destination);
+  };
+  const ios = plugins.filter(plugin => plugin.ios);
+  write('ios.json', JSON.stringify({ sources: ios.flatMap(plugin => plugin.ios.sources), frameworks: [...new Set(ios.flatMap(plugin => plugin.ios.frameworks))], infoPlist }, null, 2));
+  write('GeneratedPlugins.swift', `// Generated by AnseronUI. Do not edit.\nimport Foundation\n@MainActor enum AnseronUIPlugins {\n    static func makeExtensions() -> IOSPlatformExtensions {\n        let result = IOSPlatformExtensions()\n${ios.map(plugin => `        do {\n            let next = ${plugin.ios.factory}.createExtensions()\n            for (name, handler) in next.modules {\n                precondition(!["http", "timer", "__view", "router"].contains(name) && result.modules[name] == nil, "Duplicate or reserved native module: \\(name)")\n                result.modules[name] = handler\n            }\n            for (name, factory) in next.components {\n                precondition(result.components[name] == nil, "Duplicate native component: \\(name)")\n                result.components[name] = factory\n            }\n        }`).join('\n')}\n        return result\n    }\n}\n`);
+  const android = plugins.filter(plugin => plugin.android);
+  write('GeneratedPlugins.kt', `// Generated by AnseronUI. Do not edit.\npackage org.anseronui.generated\nimport android.content.Context\nimport org.anseronui.render.*\nobject AnseronUIPlugins {\n    fun makeExtensions(context: Context): AndroidPlatformExtensions {\n        val modules = mutableMapOf<String, NativeModuleHandler>()\n        val components = mutableMapOf<String, NativeComponentFactory>()\n${android.map(plugin => `        run {\n            val next = ${plugin.android.factory}.createExtensions(context)\n            for ((name, handler) in next.modules) {\n                require(name !in listOf("http", "timer", "__view", "router") && name !in modules) { "Duplicate or reserved native module: $name" }\n                modules[name] = handler\n            }\n            for ((name, factory) in next.components) {\n                require(name !in components) { "Duplicate native component: $name" }\n                components[name] = factory\n            }\n        }`).join('\n')}\n        return AndroidPlatformExtensions(modules, components)\n    }\n}\n`);
+  // Gradle consumes JSON instead of executable snippets from package metadata.
+  write('android.json', JSON.stringify({ sources: android.flatMap(plugin => plugin.android.sources), dependencies: [...new Set(android.flatMap(plugin => plugin.android.dependencies))], permissions: [...new Set(android.flatMap(plugin => plugin.android.permissions))] }, null, 2));
+  const typeImport = read(join(app, 'anseronui.config.json')).schemaVersion === 2 ? 'anseronui/render-web' : '@anseronui/render-web';
+  const web = plugins.filter(plugin => plugin.web);
+  write('web.ts', `${web.map((plugin, i) => `import { createExtensions as plugin${i} } from ${JSON.stringify('./' + posix(relative(directory, plugin.web.entry)).replace(/\.ts$/, ''))};`).join('\n')}\nimport type { PlatformExtensions } from '${typeImport}';\nexport function createPluginExtensions(): PlatformExtensions {\n  const result: PlatformExtensions = { modules: Object.create(null), components: Object.create(null) };\n  const plugins: PlatformExtensions[] = [${web.map((_, i) => `plugin${i}()`).join(', ')}];\n  for (const next of plugins) {\n    for (const [name, handler] of Object.entries(next.modules ?? {})) {\n      if (['http', 'timer', '__view', 'router'].includes(name) || Object.hasOwn(result.modules!, name)) throw new Error('Duplicate or reserved native module: ' + name);\n      result.modules![name] = handler;\n    }\n    for (const [name, factory] of Object.entries(next.components ?? {})) {\n      if (Object.hasOwn(result.components!, name)) throw new Error('Duplicate native component: ' + name);\n      result.components![name] = factory;\n    }\n  }\n  return result;\n}\n`);
+  return directory;
+}
+
+export function pluginBuildConfig(config, framework, plugins) {
+  const result = structuredClone(config);
+  result.npmPlugins = plugins.map(plugin => ({ name: plugin.name, entry: posix(relative(framework, plugin.entry)) }));
+  result.sourceDirs = [...new Set([...result.sourceDirs, ...plugins.map(plugin => posix(relative(framework, dirname(plugin.entry))))])];
+  return result;
+}

package/dist/sdk/scripts/sdk-files.mjs

@@ -14,7 +14,7 @@ const files = [
   'packages/flexily/LICENSE', 'packages/render-ios/Package.swift',
   'packages/render-android/src/main/AndroidManifest.xml',
   'internal/toolchain/build-library.mjs', 'internal/toolchain/async-embedding.patch', 'internal/toolchain/scriptc.vendor.json',
-  ...['anseronui', 'standalone-app', 'sdk-files', 'prepare-compiler', 'prepare-tools',
+  ...['anseronui', 'standalone-app', 'native-plugins', 'sdk-files', 'prepare-compiler', 'prepare-tools',
     'build-core', 'build-app', 'stage-core', 'core-inputs', 'lower-timers'].map(name => `scripts/${name}.mjs`),
 ];
 export const toolchainHost = `${process.platform}-${process.arch}${process.platform === 'linux' ? (process.report.getReport().header.glibcVersionRuntime ? '-gnu' : '-musl') : process.platform === 'win32' ? '-msvc' : ''}`;
@@ -28,7 +28,7 @@ export function sdkFiles(root) {
   const result = [...files, ...vendor.sdkFiles.map(path => `internal/toolchain/scriptc/${path}`)];
   function walk(path) {
     for (const entry of readdirSync(join(root, path), { withFileTypes: true })) {
-      if (['AGENTS.md', '.DS_Store', 'node_modules', 'test', 'tests'].includes(entry.name)) continue;
+      if (['AGENTS.md', '.DS_Store', '__pycache__', 'node_modules', 'test', 'tests'].includes(entry.name)) continue;
       const next = `${path}/${entry.name}`;
       if (entry.isDirectory()) walk(next); else result.push(next);
     }

package/dist/sdk/scripts/stage-core.mjs

@@ -29,6 +29,11 @@ const aliases = new Map([
 ]);
 function stagedPath(path) {
  const absolute = resolve(root, path);
+ const plugin = (config.npmPlugins ?? []).find(plugin => {
+  const base = dirname(resolve(root, plugin.entry));
+  return absolute === base || absolute.startsWith(base + '/');
+ });
+ if (plugin) return join('__npm_plugins__', createHash('sha1').update(plugin.name).digest('hex').slice(0, 12), relative(dirname(resolve(root, plugin.entry)), absolute));
  const projectPath = relative(root, absolute);
  if (!projectPath.startsWith('..')) return projectPath;
  const candidates = (config.sourceDirs ?? []).map(dir => resolve(root, dir))
@@ -38,6 +43,7 @@ function stagedPath(path) {
  const identity = createHash('sha1').update(base).digest('hex').slice(0, 12);
  return join('__external__', identity, relative(base, absolute));
 }
+for (const plugin of config.npmPlugins ?? []) aliases.set(plugin.name, stagedPath(plugin.entry));
 async function copy(path, outputPath = stagedPath(path)) {
  const absolute = resolve(root, path);
  for (const item of await readdir(absolute,{withFileTypes:true})) {

package/dist/sdk/scripts/standalone-app.mjs

@@ -6,7 +6,8 @@ import { spawn, spawnSync } from 'node:child_process';
 import { setTimeout as delay } from 'node:timers/promises';
 import { createHash } from 'node:crypto';
 import { createRequire } from 'node:module';
-import { copySDK, sdkFingerprint, toolchainHost } from './sdk-files.mjs';
+import { copySDK, sdkFingerprint, toolchainHost, sdkAliases } from './sdk-files.mjs';
+import { discoverNativePlugins, generateNativePlugins, pluginBuildConfig } from './native-plugins.mjs';
 
 const framework = fileURLToPath(new URL('../', import.meta.url));
 const templates = fileURLToPath(new URL('./templates/app/', import.meta.url));
@@ -77,6 +78,19 @@ export function createStandalone(targetPath, { name, applicationId, force = fals
       writeFileSync(path, contents);
     }
   }
+  if (localFramework) {
+    // npm plugins use the public package name even while developing against a checkout.
+    const aliases = { anseronui: resolve(framework, 'packages/ui/src/index.ts'),
+      ...Object.fromEntries(Object.entries(sdkAliases).map(([name, path]) => [name.replace('@anseronui/', 'anseronui/'), resolve(framework, path)])) };
+    const tsconfigPath = join(target, 'tsconfig.json');
+    const tsconfig = json(tsconfigPath);
+    tsconfig.compilerOptions.paths = Object.fromEntries(Object.entries(aliases).map(([name, path]) => [name, [path]]));
+    write(tsconfigPath, JSON.stringify(tsconfig, null, 2) + '\n');
+    const vitePath = join(target, 'web/vite.config.ts');
+    // Use exact RegExp aliases so the bare package alias cannot consume its subpaths.
+    const viteAliases = Object.entries(aliases).map(([name, path]) => `{ find: new RegExp(${JSON.stringify('^' + name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '$')}), replacement: ${JSON.stringify(path)} }`).join(', ');
+    write(vitePath, readFileSync(vitePath, 'utf8').replace('defineConfig({', `defineConfig({ resolve: { alias: [${viteAliases}] },`));
+  }
   chmodSync(join(target, 'platforms/android/gradlew'), 0o755);
   write(join(target, 'anseronui.config.json'), JSON.stringify(config, null, 2) + '\n');
   const cli = posix(relative(target, join(framework, 'scripts/anseronui.mjs')));
@@ -95,7 +109,8 @@ export function createStandalone(targetPath, { name, applicationId, force = fals
   write(join(target, 'platforms/android/settings.gradle'), `pluginManagement { repositories { google(); mavenCentral(); gradlePluginPortal() } }\ndependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS); repositories { google(); mavenCentral() } }\nrootProject.name = '${displayName}'\ninclude ':app', ':render'\n`);
   const renderer = posix(relative(join(target, 'platforms/android'), resolve(target, config.app.framework, 'packages/render-android')));
   write(join(target, 'platforms/android/render/build.gradle'), `plugins { id 'com.android.library'; id 'org.jetbrains.kotlin.android' }\nandroid {\n namespace 'org.anseronui.render'\n compileSdk 35\n defaultConfig { minSdk 26 }\n compileOptions { sourceCompatibility JavaVersion.VERSION_17; targetCompatibility JavaVersion.VERSION_17 }\n kotlinOptions { jvmTarget = '17' }\n sourceSets.main {\n  java.srcDirs = [rootProject.file(${JSON.stringify(renderer + '/src/main/java')})]\n  manifest.srcFile rootProject.file(${JSON.stringify(renderer + '/src/main/AndroidManifest.xml')})\n  jniLibs.srcDirs = [rootProject.file('../../.verification/android-jni')]\n }\n}\n`);
-  write(join(target, 'README.md'), `# ${displayName}\n\nAnseronUI 跨平台应用，应用标识 \`${identifier}\`。\n\n\`npm install\` → \`npm run setup\` → \`npm run ios\` / \`npm run android\`。\n\nsetup 使用 npm 包内的固定版本编译器源码构建工具链，无需 Git。iOS 需要 macOS、Xcode、模拟器 runtime 和 Python 3。Android 需要 SDK 35、NDK、JDK 17–22 及 arm64-v8a 设备或模拟器。\n\n指定设备：\`npm run ios -- --device <UUID或名称>\`、\`npm run android -- --device <serial>\`，或 \`npm run android -- --avd <AVD名称>\`。\`--no-build\` 复用已有产物，\`--dry-run\` 预览操作。\n\n\`npm run check\` 检查配置；\`npm run typecheck\` 检查 TSX。\`npm run build:ios\` / \`npm run build:android\` 只构建；\`build:ios-device\` 生成未签名真机产物，需自行配置 Xcode 签名。\n\nWeb：\`npm run build:web\`，然后 \`npm run dev:web\`。修改 TSX 后需重新编译 Wasm。\n\n页面位于 \`src/pages\`；页面清单位于 \`anseronui.config.json\`。${localFramework ? '本地源码模式：页面路径相对于框架目录。' : '配置中的页面、源码及 Web 路径相对于本工程，可整体移动工程。npm 依赖固定版本，提交 package-lock.json 以锁定依赖。SDK 与编译器缓存位于 .anseronui/，构建产物位于 .verification/、platforms/android/app/build/ 和 dist/web/。无需框架源码仓库。'}\n\n三端仅显示 TSX 页面，系统栏背景跟随页面根节点 backgroundColor。\n`);
+  write(join(target, 'README.md'), `# ${displayName}\n\nAnseronUI 跨平台应用，应用标识 \`${identifier}\`。\n\n\`npm install\` → \`npm run setup\` → \`npm run ios\` / \`npm run android\`。\n\nsetup 使用 npm 包内的固定版本编译器源码构建工具链，无需 Git。iOS 需要 macOS、Xcode、模拟器 runtime 和 Python 3。Android 需要 SDK 35、NDK、JDK 17–22 及 arm64-v8a 设备或模拟器。\n\n指定设备：\`npm run ios -- --device <UUID或名称>\`、\`npm run android -- --device <serial>\`，或 \`npm run android -- --avd <AVD名称>\`。\`--no-build\` 复用已有产物，\`--dry-run\` 预览操作。\n\n\`npm run check\` 检查配置；\`npm run typecheck\` 检查 TSX。\`npm run build:ios\` / \`npm run build:android\` 只构建；\`build:ios-device\` 生成未签名真机产物，需自行配置 Xcode 签名。\n\nWeb：\`npm run build:web\`，然后 \`npm run dev:web\`。修改 TSX 后需重新编译 Wasm。\n\n页面位于 \`src/pages\`；页面清单位于 \`anseronui.config.json\`。${localFramework ? '本地源码模式：页面路径相对于框架目录。' : '配置中的页面、源码及 Web 路径相对于本工程，可整体移动工程。npm 依赖固定版本，提交 package-lock.json 以锁定依赖。SDK 与编译器缓存位于 .anseronui/，构建产物位于 .verification/、platforms/android/app/build/ 和 dist/web/。无需框架源码仓库。'}\n\n三端仅显示 TSX 页面，系统栏背景跟随页面根节点 backgroundColor。\n\n原生插件：使用 \`npm install <插件包>\` 安装到生产依赖，\`npm run check\` 查看已发现插件，再重新构建目标平台。构建自动接入包内的原生源码和注册表；生成文件位于 \`.anseronui/plugins/\`，请勿手动修改。插件发布协议见 AnseronUI 框架 README。\n`);
+  generateNativePlugins(target, []);
   console.log(`Created independent AnseronUI app: ${target}\nApplication ID: ${identifier}\nNext: cd ${JSON.stringify(target)}${localFramework ? '' : ' && npm install'} && npm run setup && npm run ios\nAndroid: npm run android`);
 }
 
@@ -105,7 +120,12 @@ export function setupStandalone(configPath, { prepareCompiler = false } = {}) {
     if (!existsSync(join(framework, 'node_modules/.bin/tsc'))) throw new Error('Install framework dependencies first: npm ci --ignore-scripts');
     const modules = join(ctx.app, 'node_modules');
     if (!existsSync(modules)) symlinkSync(join(framework, 'node_modules'), modules, 'dir');
-    return { ...ctx, framework };
+    const plugins = discoverNativePlugins(ctx.app);
+    generateNativePlugins(ctx.app, plugins);
+    const config = pluginBuildConfig(ctx.config, framework, plugins);
+    const file = join(ctx.app, '.anseronui/build.config.json');
+    write(file, JSON.stringify(config, null, 2) + '\n');
+    return { ...ctx, framework, config, file };
   }
   // The package is immutable. Each app owns its SDK, compiler sources and AOT staging.
   if (ctx.config.app.framework !== '.anseronui/sdk') throw new Error('schemaVersion 2 requires app.framework = .anseronui/sdk');
@@ -150,20 +170,23 @@ export function setupStandalone(configPath, { prepareCompiler = false } = {}) {
     rmSync(link, { recursive: true, force: true });
     mkdirSync(dirname(link), { recursive: true }); symlinkSync(path, link, 'dir');
   }
+  const plugins = discoverNativePlugins(ctx.app);
+  generateNativePlugins(ctx.app, plugins);
   const config = structuredClone(ctx.config);
   const sdkPath = path => posix(relative(sdk, resolve(ctx.app, path)));
   config.sourceDirs = config.sourceDirs.map(sdkPath);
   config.pages.forEach(page => { page.source = sdkPath(page.source); });
   config.web = { ...config.web, viteConfig: sdkPath(config.web.viteConfig), publicDir: sdkPath(config.web.publicDir) };
   const file = join(ctx.app, '.anseronui/build.config.json');
-  const text = JSON.stringify(config, null, 2) + '\n';
+  const buildConfig = pluginBuildConfig(config, sdk, plugins);
+  const text = JSON.stringify(buildConfig, null, 2) + '\n';
   if (!existsSync(file) || readFileSync(file, 'utf8') !== text) write(file, text);
   const compilerStamp = join(sdk, '.compiler-fingerprint');
   if (prepareCompiler && (!existsSync(compilerStamp) || readFileSync(compilerStamp, 'utf8') !== fingerprint || !existsSync(join(sdk, 'internal/toolchain/scriptc/packages/compiler/dist/index.js')))) {
     run(process.execPath, ['scripts/prepare-compiler.mjs'], { cwd: sdk, env: { ...process.env, ANSERONUI_SDK_WORKSPACE: '1' } });
     write(compilerStamp, fingerprint);
   }
-  return { ...ctx, config, file, framework: sdk };
+  return { ...ctx, config: buildConfig, file, framework: sdk };
 }
 function androidEnvironment() {
   const sdk = process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? join(homedir(), process.platform === 'darwin' ? 'Library/Android/sdk' : 'Android/Sdk');
@@ -190,6 +213,7 @@ export function buildStandalone(configPath, target) {
   if (target.startsWith('ios') && process.platform !== 'darwin') throw new Error('iOS builds require macOS and Xcode.');
   const ctx = setupStandalone(configPath);
   const { app, config, file, framework } = ctx;
+  generateNativePlugins(app, discoverNativePlugins(app), target);
   if (config.schemaVersion === 2 && (!existsSync(join(framework, '.compiler-fingerprint')) || readFileSync(join(framework, '.compiler-fingerprint'), 'utf8') !== readFileSync(join(framework, '.sdk-fingerprint'), 'utf8'))) throw new Error('SDK changed; run npm run setup before building.');
   if (!existsSync(join(framework, 'internal/toolchain/scriptc/packages/compiler/dist/index.js'))) throw new Error('Run npm run setup from the app first.');
   const env = target === 'android' ? javaEnvironment(androidEnvironment()) : process.env;

package/dist/sdk/scripts/templates/app/platforms/android/app/build.gradle

@@ -15,3 +15,16 @@ android {
     sourceSets.main.assets.srcDirs += rootProject.file('../../assets')
 }
 dependencies { implementation project(':render') }
+
+// Generated from installed npm plugins by AnseronUI setup/build.
+def pluginDir = rootProject.file('../../.anseronui/plugins')
+def nativePlugins = new groovy.json.JsonSlurper().parse(new File(pluginDir, 'android.json'))
+android.sourceSets.main.java.srcDirs += nativePlugins.sources
+android.sourceSets.main.java.srcDirs += pluginDir
+nativePlugins.dependencies.each { coordinate -> dependencies.add('implementation', coordinate) }
+// An overlay manifest adds permissions without modifying the app's own manifest.
+def permissionsManifest = new File(pluginDir, 'AndroidManifest.xml')
+permissionsManifest.text = '<manifest xmlns:android="http://schemas.android.com/apk/res/android">' +
+    nativePlugins.permissions.collect { '<uses-permission android:name="' + it + '" />' }.join('') + '</manifest>'
+android.sourceSets.debug.manifest.srcFile permissionsManifest
+android.sourceSets.release.manifest.srcFile permissionsManifest

package/dist/sdk/scripts/templates/app/platforms/android/app/src/main/java/MainActivity.kt

@@ -36,7 +36,8 @@ class MainActivity : Activity() {
         content = AnseronUIRenderView(
             this,
             baseUrl = URL("http://127.0.0.1:5175"),
-            createCore = { NativeCore("__BUILD_ID__") }
+            createCore = { NativeCore("__BUILD_ID__") },
+            extensions = org.anseronui.generated.AnseronUIPlugins.makeExtensions(this)
         ).apply {
             onDiagnostic = { code, message -> android.util.Log.w("__APP_NAME__", "$code: $message") }
             onFailure = { error -> android.util.Log.e("__APP_NAME__", "Host failed", error) }

package/dist/sdk/scripts/templates/app/platforms/ios/App.swift

@@ -16,6 +16,7 @@ final class AppController: UIViewController {
     override var preferredStatusBarStyle: UIStatusBarStyle { statusBarStyle }
     private let content = AnseronUIRenderView(
         baseURL: URL(string: "http://127.0.0.1:5175"),
+        extensions: AnseronUIPlugins.makeExtensions(),
         createCore: { try NativeCore(bundleBuildId: "__BUILD_ID__") }
     )
 

package/dist/sdk/scripts/templates/app/scripts/check-ios-core.mjs

@@ -7,7 +7,7 @@ const app = fileURLToPath(new URL('../', import.meta.url));
 let configPath = join(app, 'anseronui.config.json');
 const config = JSON.parse(readFileSync(configPath, 'utf8'));
 const framework = resolve(app, config.app.framework);
-if (config.schemaVersion === 2) configPath = join(app, '.anseronui/build.config.json');
+configPath = join(app, '.anseronui/build.config.json');
 const { coreFingerprint } = await import(pathToFileURL(join(framework, 'scripts/core-inputs.mjs')));
 const target = process.env.PLATFORM_NAME === 'iphoneos' ? 'ios-device' : 'ios-simulator';
 try {

package/dist/sdk/scripts/templates/app/scripts/generate-ios-project.py

@@ -4,6 +4,7 @@ import json
 import shutil
 import shlex
 import os
+import plistlib
 root = Path(__file__).resolve().parent.parent
 config = json.loads((root/'anseronui.config.json').read_text())
 framework = (root/config['app']['framework']).resolve()
@@ -15,9 +16,17 @@ def add(kind, **values):
     key = f'{len(objects)+1:024X}'
     objects[key] = {'isa': kind, **values}
     return key
+plugin_dir = root/'.anseronui/plugins'
+plugins = json.loads((plugin_dir/'ios.json').read_text())
+with (ios/'Info.plist').open('rb') as file:
+    info = plistlib.load(file)
+# App-owned descriptions take precedence over library defaults.
+info = {**plugins['infoPlist'], **info}
+with (plugin_dir/'Info.plist').open('wb') as file:
+    plistlib.dump(info, file)
 files = []
 build_files = []
-for path, filetype in [
+source_inputs = [
     ('App.swift', 'sourcecode.swift'),
     (framework_path('packages/render-ios/Sources/AnseronUIRenderIOS/Extensions.swift'), 'sourcecode.swift'),
     (framework_path('packages/render-ios/Sources/AnseronUIRenderIOS/Renderer.swift'), 'sourcecode.swift'),
@@ -26,7 +35,10 @@ for path, filetype in [
     (framework_path('packages/render-ios/Sources/AnseronUIRenderIOS/AnseronUIRenderView.swift'), 'sourcecode.swift'),
     (framework_path('packages/render-ios/Sources/AnseronUIRenderIOS/NativeCore.swift'), 'sourcecode.swift'),
     (framework_path('packages/core/native/transport.c'), 'sourcecode.c.c'),
-]:
+]
+source_inputs += [(os.path.relpath(plugin_dir/'GeneratedPlugins.swift', ios), 'sourcecode.swift')]
+source_inputs += [(os.path.relpath(path, ios), 'sourcecode.swift') for path in plugins['sources']]
+for path, filetype in source_inputs:
     ref = add('PBXFileReference', lastKnownFileType=filetype, path=path, sourceTree='SOURCE_ROOT')
     files.append(ref)
     build_files.append(add('PBXBuildFile', fileRef=ref))
@@ -36,7 +48,7 @@ group = add('PBXGroup', children=[*files, products], sourceTree='<group>')
 sources = add('PBXSourcesBuildPhase', buildActionMask='2147483647', files=build_files, runOnlyForDeploymentPostprocessing='0')
 settings = {
     'PRODUCT_NAME': 'App', 'PRODUCT_BUNDLE_IDENTIFIER': config['app']['applicationId'],
-    'INFOPLIST_FILE': 'Info.plist', 'SDKROOT': 'iphoneos', 'SUPPORTED_PLATFORMS': 'iphoneos iphonesimulator',
+    'INFOPLIST_FILE': '../../.anseronui/plugins/Info.plist', 'SDKROOT': 'iphoneos', 'SUPPORTED_PLATFORMS': 'iphoneos iphonesimulator',
     'IPHONEOS_DEPLOYMENT_TARGET': '15.0', 'TARGETED_DEVICE_FAMILY': '1,2',
     'ARCHS': 'arm64', 'SWIFT_VERSION': '5.0', 'CLANG_ENABLE_MODULES': 'YES', 'CODE_SIGN_STYLE': 'Automatic',
     'HEADER_SEARCH_PATHS': ['$(inherited)', '$(SRCROOT)/' + framework_path('packages/core/native/include')],
@@ -44,6 +56,7 @@ settings = {
     'CORE_LIBRARY': '$(SRCROOT)/../../.verification/core-ios-device/entry.lib.a',
     'CORE_LIBRARY[sdk=iphonesimulator*]': '$(SRCROOT)/../../.verification/core-ios-simulator/entry.lib.a',
 }
+settings['OTHER_LDFLAGS'] = ['$(inherited)'] + [flag for name in plugins['frameworks'] for flag in ['-framework', name]]
 configs = [add('XCBuildConfiguration', name=name, buildSettings={**settings, 'SWIFT_OPTIMIZATION_LEVEL': '-Onone' if name=='Debug' else '-O', 'ENABLE_TESTABILITY': 'YES' if name=='Debug' else 'NO'}) for name in ['Debug', 'Release']]
 config_list = add('XCConfigurationList', buildConfigurations=configs, defaultConfigurationIsVisible='0', defaultConfigurationName='Release')
 core_ref = add('PBXFileReference', lastKnownFileType='archive.ar', path='$(CORE_LIBRARY)', sourceTree='<absolute>')

package/dist/sdk/scripts/templates/app/web/main.ts

@@ -1,5 +1,6 @@
 import { BrowserHost, WasmRuntime } from "@anseronui/render-web";
 import "./style.css";
+import { createPluginExtensions } from "../.anseronui/plugins/web";
 
 const container = document.querySelector<HTMLElement>("#app")!;
 const routeStack = ["home"];
@@ -10,7 +11,7 @@ function select(page: string) {
     await host?.destroy();
     const root = document.createElement("div"); root.className = "surface"; container.replaceChildren(root);
     const runtime = await WasmRuntime.load("/core.wasm", undefined, "__BUILD_ID__");
-    host = new BrowserHost(root, runtime, undefined, { router: async (method, args) => {
+    host = new BrowserHost(root, runtime, undefined, { ...createPluginExtensions(), router: async (method, args) => {
       const target = typeof args === "object" && args !== null && "page" in args ? String((args as { page: unknown }).page) : "";
       if (method === "push") { if (!target) throw new Error("INVALID_ROUTE"); routeStack.push(target); setTimeout(() => { void select(target); }, 0); return null; }
       if (method === "replace") { if (!target || routeStack.length === 0) throw new Error("INVALID_ROUTE"); routeStack[routeStack.length - 1] = target; setTimeout(() => { void select(target); }, 0); return null; }

package/package.json

@@ -17,10 +17,11 @@
     "test:layout:upstream": "vitest run --config scripts/flexily.vitest.config.ts",
     "bench:layout": "vitest bench --run --config scripts/flexily.bench.config.ts",
     "typecheck:layout": "tsc --noEmit -p packages/layout/tsconfig.json",
+    "pretypecheck:framework": "npm run lower:counter",
     "typecheck:framework": "tsc --noEmit -p tsconfig.framework.json",
     "test:framework": "vitest run --config scripts/framework.vitest.config.ts",
     "test:build": "node --test scripts/core-inputs.test.mjs scripts/lower-timers.test.mjs",
-    "test:tooling": "node --test scripts/anseronui.test.mjs",
+    "test:tooling": "node --test scripts/anseronui.test.mjs scripts/native-plugins.test.mjs",
     "lower:counter": "node --import tsx scripts/lower-tsx.mjs examples/counter/page.tsx .verification/framework/counter.ts",
     "dev:counter": "vite --config examples/counter/vite.config.ts",
     "build:counter:web": "vite build --config examples/counter/vite.config.ts",
@@ -58,9 +59,13 @@
     "@scriptc/runtime-darwin-arm64": "0.4.8",
     "@scriptc/runtime-wasm32-wasi": "0.4.8"
   },
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Create and build AnseronUI apps for iOS, Android and Web from shared TSX pages",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ailuoku6/AnseronUI.git"
+  },
   "files": [
     "dist/sdk",
     "THIRD_PARTY_NOTICES.md"