格鲁巴基斯
当前发布 : 0.12.0 (中文(简体) )。解析器输入是宣布的参数;读取时间为一次性读取。 见 BREAKING_CHANGES.md。 。 。 .
0.11.0——打破API: 读取 摄取和安排迁移说明 在升级附属项目之前.
类型脚本/ Java脚本端口 外科医生 - 具有XML序列化、构建器模式和编译器系统的分级数据容器.
状态
发展状况: 前阿尔法(文件和规划)
概览
genro-bag-js将 Python genro-bag 架构带到 JavaScript/ TypeScript 用于:
- 浏览器: DOM 操作,UI框架,被动更新
- 节点.js: 服务器侧处理, CLI 工具
- 互通性: XML/JSON 格式与 Python 版本相同
- 现代运行时间: Deno, Bun 支持
建筑
┌─────────────────────────────────────────────────────────────────┐
│ SERVER (Python) │
│ │
│ Builder Python → creates "recipe" (structured Bag) │
│ bag.to_xml() → serializes for transport │
└─────────────────────────────────────────────────────────────────┘
│
▼ (HTTP / WebSocket)
┌─────────────────────────────────────────────────────────────────┐
│ BROWSER (JavaScript) │
│ │
│ Bag.fromXml() → reconstructs structure │
│ Expander → expands macros/components (optional) │
│ DOMCompiler → builds DOM/widgets dynamically │
└─────────────────────────────────────────────────────────────────┘
核心类
| 类 | 说明 |
|---|---|
Bag | 标有节点的分级容器 |
BagNode | 有值和属性的个人节点 |
BagBuilderBase | 申报结构建造者的基础类 |
BagCompilerBase | 输出生成器(DOM、HTML等)的基础类 |
BagResolver | 懒惰加载支持 |
安装
在两个登记册上公布了同样的一揽子计划:
# npm
npm install @genrojs/bag
# JSR
npx jsr add @genro/bag
从 npm 从导入 @genrojs/bag; 从 JSR 从 @genro/bag。 。 。 .
使用量
import { Bag } from '@genrojs/bag';
// Create a Bag
const bag = new Bag();
bag.set('config.name', 'My App');
bag.set('config.version', '1.0.0');
// Serialize
const xml = bag.toXml();
const json = bag.toJson();
// Parse
const restored = Bag.fromXml(xml);
使用构建器
import { Bag, BagBuilderBase, element } from '@genrojs/bag';
class GUIBuilder extends BagBuilderBase {
@element({ subTags: 'button,textfield' })
panel(title: string) {}
@element({ subTags: '' })
button(label: string, action?: string) {}
}
const gui = new Bag({ builder: GUIBuilder });
const panel = gui.panel('Settings');
panel.button('Save', 'doSave');
panel.button('Cancel', 'doCancel');
使用编译器
import { BagCompilerBase, compiler } from '@genrojs/bag';
class DOMCompiler extends BagCompilerBase {
@compiler
panel(node, children): HTMLElement {
const div = document.createElement('div');
div.className = 'panel';
children.forEach(child => div.appendChild(child));
return div;
}
@compiler
button(node, children): HTMLElement {
const btn = document.createElement('button');
btn.textContent = node.attr.label;
btn.onclick = () => this.handleAction(node.attr.action);
return btn;
}
}
文档
发展
# Install dependencies
pnpm install
# Run tests
pnpm test
# Build
pnpm build
# Type check
pnpm typecheck
许可证
Apache 许可证 2. 0 - 见 自由主义 详细情况.
版权:2025 Softwell S.r.l.
JSR分发
JavaScript 软件包发布为 @genro/bag 关于JSR. 使用
bunx jsr add @genro/bag 或者说 npx jsr add @genro/bag。 。 。 .
Node.js 22+, Bun和有Web Crypto的现代浏览器是被支持的目标.
TYTX由JSR解决;不需要GitHub软件包取出.
Deno 出版物为外部依赖和豁免保持24小时冷却
Genro JSR 软件包(jsr:@genro/* 联合国 npm:@jsr/genro__* 兼容性
页:1 仅发布给 JSR; npm 格式下载
npm.jsr.io,而不是npmjs.com. (中文(简体) ). 在通过之前, 检查每个已公布的依赖性 .
可选开发者 HTML 表示
实验检查员是一个单独的切入点,不包括主切入点 模块和浏览器捆绑。 可在将来释放时取出.
import { htmlRepr } from '@genrojs/bag/devtools';
// With a bundler that supports CSS imports:
import '@genrojs/bag/devtools/html-repr.css';
const html = htmlRepr(bag, {title: 'Inspect Bag', showTypes: true});
不使用 CSS 意识捆绑器时, 单独装入样式表 。 职能
返回已逃出 HTML 碎片; 渲染它不需要额外的脚本.
袋面板和属性开始崩溃 。 选项 openDepth (默认 ) ,
openAttributes (默认为假), showTypes 和 className
控制演示文稿。 渲染器读取静态值而不引用
解决者。 可选 resolverParameters(resolver) 额外车钩用品
元数据,包括命名的回调; 钩子不能执行解析器.
解析器徽章使用构造器名,而微分化可能改变.
所有节点即使倒塌也会被排放出来: 这是一个静态开发者检查员,
不是大数据集的虚拟查看器。 祖先周期没有标记
变异"包". 检查官被故意不安装在 Bag.prototype。 。 。 .