# @geajs/core 中文文档

规范地址：https://npmcn.com/package/%40geajs/core/

版本：1\.5\.1
npm 元数据更新时间：2026-09-30T01:58:42.064Z
中文译文更新时间：2026-11-16T01:22:13.258Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40geajs/core
原文对照：https://npmcn.com/package/%40geajs/core/?lang=original
项目主页：https://github.com/dashersw/gea#readme
源码仓库：https://github.com/dashersw/gea

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：990 kB，113 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-03-18T11:03:33.346Z
- 最新版本发布：2026-09-30T01:58:41.855Z
- 近 30 天下载量：4971（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

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

## 安装

```sh
npm install @geajs/core
```

也可以使用：`pnpm add @geajs/core`、`yarn add @geajs/core`、`bun add @geajs/core`

## README

![Gea](https://raw.githubusercontent.com/dashersw/gea/master/docs/public/logo.jpg)

[![npm version](https://badge.fury.io/js/%40geajs%2Fcore.svg)](https://www.npmjs.com/package/@geajs/core) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/dashersw/gea/blob/master/LICENSE)

# 盖亚

一个编译器-第一反应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个B** | 1.0x 单曲 |
| 固态 | 1.9.12 国家 | 10 196个B | 3 601个B级 | 29.8辆 |
| 丝绒 | 5.55.5 (韩语) | 23 461个B | 8 537个B级 | 70.6x 车次 |
| 阴道 | 3.5.33 (中文(简体) ) | 58,174 B (韩语) | 20 711个B | 17.1.2x (中文(简体) ) |
| 反应 | 19.2.5 反应DOM 19.2.5 | 189 717个B | 50 816个B | 420.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个B | **4 896个B级** | 18 075个B级 | **5 664个B级** |
| 固态 | 1.9.12 国家 | 16 181个B | 5 721个B级 | 18 892个B | 6 485个B级 |
| 丝绒 | 5.55.5 (韩语) | 38 812 B (韩语) | 13 661个B级 | 41 523个B | 14 429个B级 |
| 阴道 | 3.5.33 (中文(简体) ) | 63,676 B (韩语) | 22 585个B | 66 387个B | 23 411 B (韩语) |
| 反应 | 19.2.5 反应DOM 19.2.5 | 192 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-框架基准](https://github.com/krausest/js-framework-benchmark) 套间,涵盖行创建,更新,互换,选择,以及大表格上删除的行业标准压力测试.

| 框架 | 加权几何平均值 |
| --- | --- |
| 香草酱 | 1.00 (中文(简体) ) |
| **盖亚1.3** | **1.02 (中文(简体) )** |
| 固态 1.9 | 1.10 国家 |
| 斯维尔特5号 | 1.10 国家 |
| 第3.6号 | 1.22 联合国 |
| 反应 19.2 | 1.43 国家 |

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

## 快速启动

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

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

```bash
npm install @geajs/core @geajs/vite-plugin
```

```js
// vite.config.ts
import { defineConfig } from 'vite'
import { geaPlugin } from '@geajs/vite-plugin'

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

## 类型脚本

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

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

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

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

```tsx
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`。 。 。 .

```ts
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表示没有其他组件在意时使用.

```jsx
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插件在构建时将其转换为类组件.

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

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

### 程序和数据流

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

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

```jsx
// 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>
    )
  }
}
```

```jsx
// 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.

```jsx
// 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` 儿童:

```jsx
// 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>
  }
}
```

### 计算值

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

```ts
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`。 。 。 .

### 有条件渲染

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

### 列表渲染

```jsx
<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`(中文(简体) ) |

## 渲染

```ts
import App from './app'

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

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

## 路由器

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

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

### 快速示例

```jsx
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+ 点击) 按预期在新标签中打开 .

### 程序导航

```ts
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
```

### 组件路由参数

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

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

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

## 相关软件包

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

## 文档

完整文档: [文档](https://github.com/dashersw/gea/tree/main/docs)

## AI - 辅助发展

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

## 许可证

[麻省理工学院](https://npmcn.com/package/%40geajs/core/LICENSE) ——版权(c) 2017年至今 阿玛干·安卡拉尔

## 常见问题

### @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 和提交记录判断。

