运行时 API

业务代码能导入的 fjs* 模块。它们都不是真实的 npm 包名，而是构建时解析的虚拟模块，类型由 @ufjs/runtime/ambient 提供。

fjs/app

import { createFjsApp } from 'fjs/app';

createFjsApp({ routes, plugins, shell, transition, setup }).mount();

选项见配置 · createFjsApp。

fjs/pages / fjs/plugins

import { routes } from 'fjs/pages';     // src/pages 生成的路由表
import { plugins } from 'fjs/plugins';  // src/plugins + 模块组件

routes 是当前平台真正存在的页面，每项有 path、name、meta 等字段，可以直接用来渲染目录。

fjs/router

import { useRouter, useRoute, onPageSettled } from 'fjs/router';
import type { RouteLocation } from 'fjs/router';

API	说明
useRouter()	push(to) / replace(to) / back() / go(-n)
useRoute()	当前页面的 route：path fullPath params query meta（响应式）
onPageSettled(cb)	本页转场动画结束后调用一次

to 可以是路径字符串，或 { path, query } / { name, params, query }。详见页面与路由。

fjs

宿主通信

API	说明
hasNativeHost: boolean	是否跑在 App 里（有 Dart 宿主）
invokeHost<T>(name, ...args)	同步调用 Dart 宿主函数。参数只能是 string | number | boolean | null。无宿主时抛错
invokeHostAsync<T>(name, ...args)	异步调用，返回 Promise。无宿主时 reject
engineInfo	引擎信息（ABI 版本等）

网络

API	说明
fetch(url, init?)	WHATWG fetch 子集，额外支持 init.timeout（毫秒）。两端行为一致
Headers / Response / AbortController	配套类型

App 端这些也装成了全局对象，第三方库里的裸 fetch 可以直接用。

其它

API	说明
toast(message)	轻提示
nowMs()	引擎单调时钟（毫秒）
Worker	new Worker('/workers/<name>.js')，对应 src/workers/<name>.ts
setTimeout / setInterval / clearTimeout / clearInterval	同全局

类型

类型	说明
FjsTouchEvent	触摸事件对象：touches changedTouches targetTouches timeStamp target
FjsCanvasApi	<canvas ref> 拿到的对象：getContext('2d') toDataURL() width height
FjsHostValue	string | number | boolean | null

element API（不用框架时）

import { h, create, createRoot, insert, remove, setText, setProps, setStyle, flush } from 'fjs';

API	说明
createRoot(tag?)	创建挂在宿主根容器上的根元素
create(tag)	创建元素
h(tag, props?, children?)	创建并设置属性、子节点
insert(parent, child, index?)	插入
remove(el)	移除（连同子树）
setText(el, text)	设置文本
setProps(el, props)	合并属性；值为 null 删除；onTap 等函数进事件注册表
setStyle(el, style, activeStyle?)	设置样式
flush()	立即提交当前帧（通常由微任务自动完成）

用法见 examples/hello-js 和渲染管线。

vue

照常 import { ref, computed, watch, onMounted } from 'vue'。构建时 vue 被 alias 到 @vue/runtime-core（App）/ 官方 vue（Web）/ @ufjs/runtime/wx（小程序）。

不可用：v-model 指令、vue-router（用 fjs/router）、直接操作 DOM 的 API。

内置标签

标签、属性、事件的完整清单见内置组件和仓库的 UI API 参考。