@geajs/core

中文文档
1.5.1发布于 2026/09/30MITTypeScriptES Module近 30 天下载 4971

编译器首个反应 JavaScript UI 框架,包含编译时间 JSX 和基于代理商店

中文使用文档
文档目录29 节
  1. 编译到几乎无
  2. 当应用有效时保持倾斜
  3. 哲学
  4. 业绩
  5. 快速启动
  6. 类型脚本
  7. 核心概念
  8. 存储
  9. 类组件
  10. 函数组件
  11. 程序和数据流
  12. 传递组件作为道具
  13. 计算值
  14. JSX 语法
  15. 有条件渲染
  16. 列表渲染
  17. 生命周期
  18. DOM 帮助者
  19. 渲染
  20. 路由器
  21. 快速示例
  22. 路由模式
  23. 构成部分
  24. 程序导航
  25. 组件路由参数
  26. 相关软件包
  27. 文档
  28. AI - 辅助发展
  29. 许可证
Gea

npm version License: MIT

盖亚

一个编译器-第一反应JavaScript UI框架,有编译时间JSX和代理商店. 没有虚拟 DOM —— Vite 插件在构建时分析您的 JSX 并生成只更新变化的外科 DOM 补丁. 一个Hello-world生产建筑是121 B brotli;一个等效的交互多事船 4.9 kb of brotli JavaScript.

斯维尔特使"将框架编为去"出名. Gea从字面上取出:在一个静态的Hello-worldapp中,框架运行时间从捆绑中消失.

编译到几乎无

在新鲜的Vite出品中... ...Hello -world building, Gea ships... ...Gea ships.. 121个B brotli Java 脚本。 等同的固体建造船为3.6克b,斯维尔特船为8.5克b,Vue船为20.7克b,反应船为50.8克b.

框架版本初步改进的联署材料布罗特利联署材料布罗特利对盖亚
盖亚1.3.0 (单位:千美元)214 B类121个B1.0x 单曲
固态1.9.12 国家10 196个B3 601个B级29.8辆
丝绒5.55.5 (韩语)23 461个B8 537个B级70.6x 车次
阴道3.5.33 (中文(简体) )58,174 B (韩语)20 711个B17.1.2x (中文(简体) )
反应19.2.5 反应DOM 19.2.5189 717个B50 816个B420.0x (英语)

从新鲜的Vite 8.0.10 生产应用软件中测量出,仅用JavaScript robts来进行. Gea 使用了已编译的组件输出; React, Vue, 和 Svelte 使用了等同的最小 Hello-world 组件.

当应用有效时保持倾斜

哈罗世界证明编译器可以消失. Todo证明当应用实际有所作为时,运行时间会保持倾斜.

在具有反应状态、输入处理、过滤、项目更新和相同CSS的等同交互式多功能应用程序中,Gea船 4.9 kb (中文(简体) ) brotli Java 脚本。 固体船 5.7克b,斯维尔特船 13.7克b,Vue船 22.6克b,反应船 51.5克b.

框架版本已取消资格的联署材料JS Brotli 残疾原联署材料+共计 支助科联合来文+共计 支助科
盖亚1.3.0 (单位:千美元)15 364个B4 896个B级18 075个B级5 664个B级
固态1.9.12 国家16 181个B5 721个B级18 892个B6 485个B级
丝绒5.55.5 (韩语)38 812 B (韩语)13 661个B级41 523个B14 429个B级
阴道3.5.33 (中文(简体) )63,676 B (韩语)22 585个B66 387个B23 411 B (韩语)
反应19.2.5 反应DOM 19.2.5192 330 B (韩语)51,460 B (单位:千美元)195 041 B (韩语)52 287 B (韩语)

从新鲜活性生产中测量 /tmp/gea-todo-framework-size-compare所有建筑的CSS相同:2 711 B生,746 B brotli.

哲学

Gea的指导原则是JavaScript代码应该简单易懂. 一个框架不应该发明出新的编程概念或者期望你遵守任意的规则. 你写规律的,平庸的JavaScript——具有状态和方法的类,返回标记的功能,获得衍生值的得到者——而Gea使它在罩下反应.

没有信号,没有钩子,没有依赖矩阵,没有编译指令,也没有框架特有的原始. Gea提出的唯一概念是 Store 类,它只是一个普通类,其属性恰好被代理观测到. 其他一切——阶级继承,方法调用,财产获取, Array.map, ternary 表达式 — 是您已经知道的标准的 JavaScript .

"魔人"完全活在了建设的一步. Vite 插件在编译时分析您的代码, 计算DOM 节点依赖于哪个状态, 并生成线程 。 在运行时间,你得到干净,可读,面向对象的代码,只是工作.

业绩

Gea是编译速度最快的UI框架 js-框架基准 套间,涵盖行创建,更新,互换,选择,以及大表格上删除的行业标准压力测试.

框架加权几何平均值
香草酱1.00 (中文(简体) )
盖亚1.31.02 (中文(简体) )
固态 1.91.10 国家
斯维尔特5号1.10 国家
第3.6号1.22 联合国
反应 19.21.43 国家

更低(1.00=最快). Gea 超越了每一个被编译的框架,同时需要零框架特定的概念——没有信号,没有钩子,没有编译指令. 这不仅仅是DX——也是最快的. 全面基准报告

快速启动

npm create gea@latest my-app
cd my-app
npm install
npm run dev

或将 Gea 添加到现有的 Vite 项目中 :

npm install @geajs/core @geajs/vite-plugin
// vite.config.ts
import { defineConfig } from 'vite'
import { geaPlugin } from '@geajs/vite-plugin'

export default defineConfig({
  plugins: [geaPlugin()]
})

类型脚本

Gea通过TypeScript提供完整的JSX类型检查 jsxImportSource中添加此选项 tsconfig.json数字 :

{
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "@geajs/core"
  }
}

这使得您获得了道具自动补全,在无效属性上键入错误,并在任何TypeScript-aware编辑器中徘徊类型——VS代码,Cursor,Vim,Zed——没有特定框架插件.

使用 declare props 输入道具的类组件 :

export default class UserCard extends Component {
  declare props: { name: string; email: string; onSelect?: () => void }

  template({ name, email, onSelect }: this['props']) {
    return (
      <div class="user-card" click={onSelect}>
        <span>{name}</span>
        <span>{email}</span>
      </div>
    )
  }
}

declare props 定义已接受的 JSX 属性——没有释放 JavaScript . : this['props'] 编辑 template() 参数是可选的但被推荐的——它为完全端到端类型安全在方法内键入已解结构的变量.

核心概念

存储

A Store 持有共享应用程序状态 。 扩展 Store,将反应属性声明为类字段,并添加可使其变异的方法,导出单通实例。 店里的东西是深层的 Proxy 跟踪每一个突变和批量通知通过 queueMicrotask。 。 。 .

import { Store } from '@geajs/core'

class CounterStore extends Store {
  count = 0

  increment() { this.count++ }
  decrement() { this.count-- }
}

export default new CounterStore()

突变状态直接——代理自动处理反应. 阵列方法( E)push, (中文(简体) ), pop, (中文(简体) ), splice, (中文(简体) ), sort, (中文(简体) ), reverse, (中文(简体) ), shift, (中文(简体) ), unshift)被截取以产生精细的磨损变化事件,如: append, (中文(简体) ), reorder,以及 swap。 。 。 .

类组件

扩展 Component 执行 template() 返回JSX的方法。 类组件继承自 Store,因此它们有自己的反应性能——当你需要本地的,瞬态的UI表示没有其他组件在意时使用.

import { Component } from '@geajs/core'

export default class Counter extends Component {
  count = 0

  increment() { this.count++ }
  decrement() { this.count-- }

  template() {
    return (
      <div class="counter">
        <span>{this.count}</span>
        <button click={this.increment}>+</button>
        <button click={this.decrement}>-</button>
      </div>
    )
  }
}

事件处理者接受两种方法的引用(click={this.increment})和箭头函数(click={() => this.increment()}) (中文(简体) ). 编译器将两种表格都接入组件的事件授权系统. 使用简单转发的方法引用;在需要通过参数或作曲逻辑时使用箭头函数.

需要本地状态或生命周期钩时使用类组件.

函数组件

导出一个接收道具并返回JSX的默认函数. Vite插件在构建时将其转换为类组件.

export default function Greeting({ name }) {
  return <h1>Hello, {name}!</h1>
}

对无国籍者使用函数组件,演示式UI.

程序和数据流

Gea的道具遵循标准的JavaScript语义学——没有框架发明的概念像 v-model, (中文(简体) ), emit,或基于回调的状态提升。 当父母将数据传递给一个子组件时,它的工作就像将参数传递给JavaScript中的函数:

  • 初级 (数字,字符串,布尔斯)被传递 按数值儿童收到一份副本。 在孩子中重新分配道具并不影响父母——就像在平庸的JS中重新分配函数参数一样.
  • 对象和阵列 通过 参考文献。孩子得到父母拥有的同一代理。 突变子中的对象或阵列会自动更新母体状态和DOM——因为它是同一个对象.
// parent.tsx
import { Component } from '@geajs/core'

export default class Parent extends Component {
  count = 0
  user = { name: 'Alice', age: 30 }
  items = ['a', 'b']

  template() {
    return (
      <div>
        <span>{this.count}</span>
        <span>{this.user.name}</span>
        <span>{this.items.length} items</span>
        <Child count={this.count} user={this.user} items={this.items} />
      </div>
    )
  }
}
// child.tsx
export default function Child({ count, user, items }) {
  return (
    <div>
      <span>{count}</span>
      <span>{user.name}</span>
      <span>{items.length} items</span>
    </div>
  )
}

在此设置中:

  • user.name = 'Bob' 在孩子身上更新了父母和孩子的DOM——这是相同的反应代用.
  • items.push('c') 在孩子身上更新两个——相同的数组引用.
  • count = 99 在孩子中只更新孩子的DOM——父母仍然持有原始值.

JavaScript就是这样工作的. 没有 emit,没有 defineModel,不为对象/阵列突变调回线。 框架没有增加一层间接——它尊重语言的本土通取值和通取参考语义.

对于深筑巢穴(外孙,外孙等),适用同一规则. 只要同一对象的引用被传下,任何后人都可以变异,而变化传播到每一个观察到它的祖先——因为他们都拥有相同的代名词.

传递组件作为道具

传递组件作为多命名区域构建布局的道具——同样的想法其他框架称为"名位",没有单独的API.

// Parent passes components as named props
<Layout header={<Title />} sidebar={<Nav />} main={<Content />} />

// Layout renders each region wherever it wants
export default class Layout extends Component {
  template({ header, sidebar, main }) {
    return (
      <div class="layout">
        <aside>{sidebar}</aside>
        <main>{main}</main>
        <header>{header}</header>
      </div>
    )
  }
}

对a 单人 默认区域, 组件标记内的嵌入内容并读取 children 儿童:

// Parent nests content between opening and closing tags
<Card>
  <h2>Title</h2>
  <p>Body text goes here.</p>
</Card>

// Card renders whatever was nested inside it
export default class Card extends Component {
  template({ children }) {
    return <div class="card">{children}</div>
  }
}

计算值

为衍生状态使用商店上的获取器 。 它们在每个访问上重新评价——维特插件轨迹,这些轨迹显示模板读取的路径,并在这些路径改变时触发更新.

class TodoStore extends Store {
  todos = []
  filter = 'all'

  get filteredTodos() {
    const { todos, filter } = this
    if (filter === 'active') return todos.filter(t => !t.done)
    if (filter === 'completed') return todos.filter(t => t.done)
    return todos
  }

  get activeCount() {
    return this.todos.filter(t => !t.done).length
  }
}

JSX 语法

Gea JSX与HTML关系密切. 与 React 的密钥差异 :

特性盖亚反应
CSS课程class="foo"className="foo"
事件处理器click={fn} 或者说 onClick={fn}onClick={fn}
投入活动input={fn} 或者说 onInput={fn}onChange={fn}
键盘事件keydown={fn} 或者说 onKeyDown={fn}onKeyDown={fn}

两种土著风格(click, (中文(简体) ), change)和反应风格(onClick, (中文(简体) ), onChange) 事件属性名称得到支持.

支持的事件属性 : click, (中文(简体) ), dblclick, (中文(简体) ), input, (中文(简体) ), change, (中文(简体) ), keydown, (中文(简体) ), keyup, (中文(简体) ), blur, (中文(简体) ), focus, (中文(简体) ), mousedown, (中文(简体) ), mouseup, (中文(简体) ), submit, (中文(简体) ), dragstart, (中文(简体) ), dragend, (中文(简体) ), dragover, (中文(简体) ), dragleave, (中文(简体) ), drop。 。 。 .

与 @geajs/mobile数字 : tap, (中文(简体) ), longTap, (中文(简体) ), swipeRight, (中文(简体) ), swipeUp, (中文(简体) ), swipeLeft, (中文(简体) ), swipeDown。 。 。 .

有条件渲染

{step === 1 && <StepOne />}
{!done ? <Form /> : <Success />}

列表渲染

<ul>
  {todos.map(todo => (
    <TodoItem key={todo.id} todo={todo} onToggle={() => store.toggle(todo.id)} />
  ))}
</ul>

总是提供 key 道具 (英语). Gea使用它来高效地进行列表分解——处理添加,删除,重排,并互换而不重报整个列表.

生命周期

方法当呼叫时
created(props)建造者之后,在制作之前
onAfterRender()DOM 插入和孩子安装后
onAfterRenderAsync()下一个 requestAnimationFrame 提交之后
dispose()从 DOM 中删除,清理观察者和孩子

DOM 帮助者

方法说明
$(selector)第一个匹配的后人( 范围) querySelector(中文(简体) )
$$(selector)所有匹配的后代( 范围) querySelectorAll(中文(简体) )

渲染

import App from './app'

const app = new App()
app.render(document.getElementById('app'))

组件完成一次。 随后的状态变化会触发外科DOM补丁——不是完全重接.

路由器

Gea包括用于单页应用程序的内置客户端-侧路由器.

路由器 API 是主要 Gea API 的一部分, 因此您可以导入 Link, (中文(简体) ), RouterView,以及 router 从 @geajs/core。 。 。 .

快速示例

import { Component, Link, RouterView } from '@geajs/core'
import Home from './views/Home'
import About from './views/About'
import UserProfile from './views/UserProfile'

export default class App extends Component {
  template() {
    return (
      <div class="app">
        <nav>
          <Link to="/" label="Home" />
          <Link to="/about" label="About" />
          <Link to="/users/1" label="Alice" />
        </nav>
        <RouterView routes={[
          { path: '/', component: Home },
          { path: '/about', component: About },
          { path: '/users/:id', component: UserProfile },
        ]} />
      </div>
    )
  }
}

路由模式

图案实例 URL参数
/about/about{}
/users/:id/users/42{ id: '42' }
/repo/:owner/*/repo/dashersw/src/index.ts{ owner: 'dashersw', '*': 'src/index.ts' }

构成部分

  • RouterView ——使组件匹配当前 URL。 接受一个 routes 数组 { path, component } 对象。 支持类和函数组件.
  • Link - 让一个 <a> 导航的标签 history.pushState 而不是重新装入完整页面。 修改键( Cmd/ Ctrl+ 点击) 按预期在新标签中打开 .

程序导航

import { router } from '@geajs/core'

router.navigate('/about')          // push new entry
router.replace('/login')           // replace current entry
router.back()                      // history.back()
router.forward()                   // history.forward()

console.log(router.path)           // '/about'
console.log(router.query)          // { q: 'hello' } for ?q=hello

组件路由参数

函数组件作为道具接收匹配的参数 :

export default function UserProfile({ id }) {
  return <h1>User {id}</h1>
}

类组件通过 created(props) 财务报告和审定财务报表 template(props)。 。 。 .

  • @geajs/移动 ——移动UI原始:取景,导航,手势,侧边栏,分页,牵引至再生,无穷卷.
  • @geajs/vite-plugin (英语) ——维特插件,能使编译时间JSX变换,活性接线,和HMR.
  • 创建- gea 项目脚手架: npm create gea@latest。 。 。 .

文档

完整文档: 文档

AI - 辅助发展

该寄存器包括 代理技能 教AI编码助理如何和Gea合作 在相容的环境下,这为您的编辑提供了理解Gea的商店,组件,JSX常规,以及反应模型所需要的上下文,这样你就可以用更好的AI协助来脚手架和去除Gea应用软件上.

许可证

麻省理工学院 ——版权(c) 2017年至今 阿玛干·安卡拉尔

版本与发布记录

@geajs/core 共发布 33 个版本,首次发布于 2026/03/18;过去 12 个月发布了 33 个版本。

版本发布日期距今
1.5.1latest2026/09/301 个月前
1.5.02026/09/301 个月前
1.4.32026/09/241 个月前
1.4.22026/09/231 个月前
1.4.02026/06/284 个月前
1.3.02026/04/276 个月前

关于 @geajs/core 的常见问题

@geajs/core 是什么?

编译器首个反应 JavaScript UI 框架,包含编译时间 JSX 和基于代理商店

如何安装 @geajs/core?

在项目目录运行 npm install @geajs/core,或使用 pnpm add / yarn add / bun add。

@geajs/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@geajs/core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@geajs/core 可以商用吗?

@geajs/core 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@geajs/core 的下载量有多少?

根据 npm 官方下载统计,@geajs/core 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,971 次,日均约 166 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@geajs/core 还在维护吗?

最新版本 1.5.1 发布于 2026/09/30(1 个月前);至今共发布 33 个版本,其中过去 12 个月发布了 33 个;首次发布于 2026/03/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。