@nova-lang/cli 0.1.0 → 0.1.1

package/README.md

@@ -1,13 +1,17 @@
-我设计了一种全新的标记语言，命名为 **Nova**（全称：**N**ested **O**rdered **V**ersatile **A**rchitecture）。它并非将 HTML、YAML、TeX 等语法简单堆砌，而是从它们各自的优势中抽象出**统一节点模型**——一切皆是可带属性、可含子节点的**函数式块（Block）**。Nova 的语法规则如下。
+# Nova
+
+**N**ested **O**rdered **V**ersatile **A**rchitecture — a programmable markup language.
+
+Nova is not a simple mashup of HTML, YAML, and TeX. It abstracts their strengths into a **unified node model** — everything is a **functional Block** with attributes and children.
 
 ---
 
-## 安装
+## 安装 / Install
 
-### npm（推荐）
+### npm (recommended)
 ```bash
 npm install -g @nova-lang/cli
-# 需要先安装 Zig 编译器：https://ziglang.org/download/
+# Requires Zig compiler: https://ziglang.org/download/
 nova examples/sample.nv output.html
 ```
 
@@ -17,7 +21,7 @@ pip install -e .
 nova examples/sample.nv output.html
 ```
 
-### Zig 编译
+### Zig
 ```bash
 zig build
 ./zig-out/bin/nova examples/sample.nv output.html
@@ -25,194 +29,202 @@ zig build
 
 ---
 
-## Nova 语法规范 v1.0
+## Nova 语法规范 v1.0 / Language Specification
+
+### 核心理念 / Core Design
 
-### 核心设计理念
-- **一切皆块**：文档元素、元数据、样式、数据类型、宏都是块，语法形式统一。
-- **缩进定界**：块内容由缩进界定，省略闭合标记，类似 YAML 和 Python。
-- **标签即函数**：块类型通过 `@命令名` 调用，属性写在圆括号 `()` 里，子块写在缩进大括号 `{}` 里——这是一种**函数式标记**。
-- **双模数据**：内联采用自然书写，数据表可采用紧凑的类 CSV 表示或外部引用。
-- **强类型可编译**：可内嵌类型定义和接口，直接生成代码或验证数据。
-- **数学与宏不变质**：保留 TeX 强大排版，但将其融入统一语法。
+- **一切皆块 / Everything is a Block** — document elements, metadata, styles, data types, and macros all share one syntax form.
+- **缩进定界 / Indentation-based** — block content is delimited by indentation (like YAML/Python), no closing tags needed.
+- **标签即函数 / Tags are Functions** — block types are invoked with `@command`, attributes in `()`, children in indented `{}` — **functional markup**.
+- **双模数据 / Dual-mode Data** — natural inline writing for prose, compact CSV-like tables or external references for data.
+- **强类型可编译 / Strongly Typed** — embed type definitions and interfaces, generate code or validate data directly.
+- **数学与宏不变质 / Math & Macros** — retains TeX's powerful typesetting, unified into one syntax.
+
+English · [中文](#nova-语法规范-v10)
 
 ---
 
-### 1. 基础词法
+### 1. 基础词法 / Lexical Basics
 
 ```nova
-// 单行注释
-/* 多行
-   注释 */
+// single-line comment
+/* multi-line
+    comment */
 
-// 文档元数据块
+// document metadata
 @meta {
-    title: "Nova 示例"
+    title: "Nova Example"
     author: Li Hua
     date: 2026-06-20
 }
 
-// 引入外部包（如预定义类型、宏集）
+// importing external packages
 @use "nova/std/typography"
 @use "nova/schema/gencode"
 ```
 
-- 字符串：`"双引号"` 或 `'单引号'`，支持 `#{...}` 插值。
-- 数字：`42`、`3.14`、`6.02e23`、`0xAB`。
-- 布尔与空：`true`、`false`、`null`。
-- 标识符：`[a-zA-Z_][a-zA-Z0-9_-]*`。
+| Token | Examples | Notes |
+|-------|----------|-------|
+| 字符串 / String | `"double"` `'single'` | Supports `#{...}` interpolation |
+| 数字 / Number | `42` `3.14` `6.02e23` `0xAB` | Integer, float, hex, scientific |
+| 布尔与空 / Bool & Null | `true` `false` `null` | |
+| 标识符 / Identifier | `[a-zA-Z_][a-zA-Z0-9_-]*` | |
 
 ---
 
-### 2. 块语法（融合 HTML/XML 结构 + YAML 简洁）
+### 2. 块语法 / Block Syntax
 
-一个块的基本形式为：
+A block's basic form:
 
 ```nova
-@块名(属性1: 值, 属性2: 值) 可选内联正文 {
-    子块1
-    子块2
+@BlockName(attr1: val, attr2: val) optional inline text {
+    child block 1
+    child block 2
 }
 ```
 
-- **无子块**可省略大括号和缩进：  
-  `@image(src: "photo.png", alt: "头像")`
-- **块名省略**时为无名容器，等价于 `<div>` 或 YAML 映射。
-- **属性列表**写在紧跟的 `()` 中，逗号分隔，键值对用 `:` 分隔（也可用 `=`），布尔属性可省略值。
-- **子块**必须比父块缩进一层（2 个空格）。
+- **No children** → omit braces: `@image(src: "photo.png", alt: "avatar")`
+- **Anonymous block** → unnamed container, acts like `<div>` or YAML mapping.
+- **Attributes** in `()`, comma-separated, `:` or `=` for key-value pairs, boolean attrs can omit value.
+- **Children** must be indented 2 spaces deeper than parent.
+
+#### 示例 / Example
 
-#### 示例
 ```nova
 @page {
     @header {
-        @title "Nova 语言手册"
+        @title "Nova Language Manual"
         @author "Li Hua"
     }
     @body {
         @section(id: "intro") {
-            @p "Nova 是一种全新的可编程标记语言。"
+            @p "Nova is a new programmable markup language."
         }
     }
 }
 ```
-相当于 HTML 的 `<page><header><title>...</title>`…，但无需闭合标签，且结构由缩进清晰表达。
+
+Equivalent to HTML `<page><header><title>...</title>`… but without closing tags, structure clearly expressed by indentation.
 
 ---
 
-### 3. 内联元素与格式（融合 HTML 行内标签 + TeX 命令）
+### 3. 内联元素与格式 / Inline Elements & Formatting
+
+Inline content uses `@tag{ text }` or `@tag(attrs){ text }`:
 
-内联内容使用 `@标记{ 文本 }` 或 `@标记(属性){ 文本 }`：
 ```nova
-这是一段包含 @em{强调} 和 @strong{粗体} 的文本，
-还有 @a(href: "https://nova-lang.org"){链接} 和 @code{print(x)}。
+Text with @em{emphasis} and @strong{bold},
+a @a(href: "https://nova-lang.org"){link} and @code{print(x)}.
 ```
-与 TeX 的 `\emph{...}` 相似，但统一了属性传递方式。
 
-数学公式直接内嵌，支持 TeX 语法：
-- 行内：`$E = mc^2$`
-- 展示：`$$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$`
-- 也可使用块形式：`@equation { x = \frac{-b \pm \sqrt{b^2-4ac}}{2a} }`
+Similar to TeX's `\emph{...}`, but with unified attribute syntax.
+
+**Math** — TeX syntax embedded directly:
+- Inline: `$E = mc^2$`
+- Display: `$$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$`
+- Block form: `@equation { x = \frac{-b \pm \sqrt{b^2-4ac}}{2a} }`
 
 ---
 
-### 4. 列表与映射（YAML 优势）
-
-- **无序列表**用 `-` 或 `*` 引导：
-  ```nova
-  @ul {
-      - 苹果
-      - 香蕉
-      - 橘子
-  }
-  ```
-- **有序列表**用 `+` 后跟数字或 `#`：
-  ```nova
-  @ol {
-      + 1. 第一步
-      + 2. 第二步
-  }
-  ```
-- **映射**用键值对，可内联或展开：
-  ```nova
-  @config {
-      host: "localhost"
-      port: 8080
-      timeout: 30s
-  }
-  ```
-
-列表项本身可以是块，允许包含多段落或其他块：
+### 4. 列表与映射 / Lists & Maps
+
+**Unordered** (`-` or `*`):
 ```nova
-- @p "第一点详细说明"
-  @note "补充信息"
-- @p "第二点"
+@ul {
+    - Apple
+    - Banana
+    - Orange
+}
 ```
 
----
+**Ordered** (`+`):
+```nova
+@ol {
+    + Step one
+    + Step two
+}
+```
+
+**Maps** — key-value pairs:
+```nova
+@config {
+    host: "localhost"
+    port: 8080
+    timeout: 30s
+}
+```
 
-### 5. 表格系统（融合 CSV 紧凑 + 管道表可读性）
+List items can be blocks themselves:
+```nova
+- @p "First point with details"
+  @note "Supplementary info"
+- @p "Second point"
+```
 
-Nova 提供三种表格写法，适应不同场景。
+---
 
-#### 5.1 内联二维数组（CSV 风格）
+### 5. 表格系统 / Tables
+
+#### 5.1 Inline 2D Array (CSV style)
 ```nova
 @table {
-    [["姓名", "年龄", "城市"],
-     ["张三", 30, "北京"],
-     ["李四", 25, "上海"]]
+    [["Name", "Age", "City"],
+     ["Alice", 30, "Beijing"],
+     ["Bob", 25, "Shanghai"]]
 }
 ```
 
-#### 5.2 带表头的块表（可读性）
+#### 5.2 Block table with headers
 ```nova
 @table {
-    @header { 姓名, 年龄, 城市 }
-    @row { 张三, 30, 北京 }
-    @row { 李四, 25, 上海 }
+    @header { Name, Age, City }
+    @row { Alice, 30, Beijing }
+    @row { Bob, 25, Shanghai }
 }
 ```
 
-#### 5.3 外部数据引用（CSV 文件绑定）
+#### 5.3 External data reference
 ```nova
-@table(src: @csv("data/measurements.csv"), caption: "测量数据")
+@table(src: @csv("data/measurements.csv"), caption: "Measurement Data")
 ```
-这样保留了 CSV 的简单数据交换能力，同时能被解析器直接处理。
 
 ---
 
-### 6. 宏与变量（TeX 宏 + 现代模板）
+### 6. 宏与变量 / Macros & Variables
+
+Define macros with `@def` or `@macro`, supporting positional, keyword, and block parameters.
 
-宏定义使用 `@def` 或 `@macro`，支持位置参数和块参数。
 ```nova
 @def greet(name) {
-    @p "您好，#{name}！"
+    @p "Hello, #{name}!"
 }
 
-@def framed(title: String = "提示", @content) {
+@def framed(title: String = "Notice", @content) {
     @div(style: "border") {
         @strong "#{title}"
         @content
     }
 }
 
-@greet("世界")
-@framed("警告") {
-    这是一条重要信息。
+@greet("World")
+@framed("Warning") {
+    This is important information.
 }
 ```
-调用方式与普通块完全一致，实现了 **标记即代码**。
 
-还支持**命名参数**、**默认值**和**块参数**（如 `@content`），这吸收了 LaTeX3 的新特性，但语法更清晰。
+Calls are syntactically identical to regular blocks — **markup is code**.
 
 ---
 
-### 7. 类型定义与代码生成（gencode / 接口描述语言）
+### 7. 类型定义与代码生成 / Types & Code Generation
+
+Define strongly-typed schemas for code generation, data validation, or API contracts.
 
-Nova 可直接定义强类型消息，用于生成序列化代码、验证数据，或作为 API 合同。
 ```nova
 @schema(Person) {
     id: Int32 @1
     name: String @2 = ""
-    email: String? @3       // ? 表示可选
+    email: String? @3       // ? means optional
     tags: List<String> @4
 }
 
@@ -222,20 +234,24 @@ Nova 可直接定义强类型消息，用于生成序列化代码、验证数据
     updateUser(id: Int32, data: UpdateMask) -> Person
 }
 ```
-编译器可根据这些定义输出 Go struct、Protobuf、JSON Schema 或 Python dataclass。这继承了 gencode 的核心优势，并且语法与文档其他部分无缝融合。
+
+The compiler can output Go structs, Protobuf, JSON Schema, or Python dataclasses.
 
 ---
 
-### 8. 交叉引用与参考文献（LaTeX 优势）
+### 8. 交叉引用与参考文献 / Cross-references & Bibliography
+
+- **Label**: `@label(identifier)`
+- **Reference**: `@ref(identifier)`
+- **Citation**: `@cite(key)`
 
-**标签**使用 `@label(标识符)`，**引用**使用 `@ref(标识符)`，**文献**使用 `@cite(key)`。
 ```nova
 @chapter(id: "intro") {
-    @title "简介"
+    @title "Introduction"
     @label(sec:intro)
 }
 
-参见 @ref(sec:intro) 的讨论。该方法源自 @cite(lamport94)。
+See @ref(sec:intro) for discussion. This method originates from @cite(lamport94).
 
 @bibliography {
     @entry(key: lamport94, type: book,
@@ -244,70 +260,68 @@ Nova 可直接定义强类型消息，用于生成序列化代码、验证数据
             year: 1994)
 }
 ```
-文档的元数据中可指定参考文献风格，生成 PDF 或 HTML 时自动格式化。
 
 ---
 
-### 9. 环境与条件（TeX 环境 + 现代流程控制）
-
-- **环境块**：`@if(条件) { ... }`，`@for(item in list) { ... }`。
-- **条件显示**：
-  ```nova
-  @if(@defined(debug)) {
-      @warn "调试模式开启，当前值：#{value}"
-  }
-  ```
-- **循环生成列表项**：
-  ```nova
-  @ul {
-      @for(user in users) {
-          - @strong(user.name) (#{user.email})
-      }
-  }
-  ```
-
-这使得文档不仅仅是静态文本，而是带有轻量逻辑的**活文档**。
+### 9. 流程控制 / Flow Control
+
+- **Conditional**: `@if(condition) { ... }` `@else { ... }`
+- **Loop**: `@for(item in list) { ... }`
+
+```nova
+@if(@defined(debug)) {
+    @warn "Debug mode: #{value}"
+}
+
+@ul {
+    @for(user in users) {
+        - @strong(user.name) (#{user.email})
+    }
+}
+```
+
+Documents become **living documents** with lightweight logic, not just static text.
 
 ---
 
-### 10. 完整综合示例
+### 10. 完整综合示例 / Complete Example
 
 ```nova
 @use "nova/std"
 @use "nova/plot"
 
 @meta {
-    title: "Nova 语言白皮书"
+    title: "Nova Language Whitepaper"
     authors: ["Li Hua", "Zhang Wei"]
     version: 1.0
 }
 
 @page {
-    @title "Nova 语言白皮书"
+    @title "Nova Language Whitepaper"
 
     @abstract {
-        Nova 统一了文档与数据，提供前所未有的编写体验。
-        详见 @ref(sec:design)。
+        Nova unifies document and data, providing an unprecedented authoring experience.
+        See @ref(sec:design) for details.
     }
 
     @chapter(id: "intro") @label(sec:intro) {
-        @p "本文介绍 Nova 的语法及设计理念。"
-        @p "数学示例：能量守恒 $E = mc^2$。"
+        @p "This paper describes Nova's syntax and design philosophy."
+        @p "Math example: conservation of energy $E = mc^2$."
     }
 
     @chapter(id: "design") @label(sec:design) {
-        @p "核心架构基于统一函数式块。"
-        @table(caption: "主流语言对比") {
-            @header { 特性, HTML, YAML, TeX, Nova }
-            @row { 标签, ✅, ❌, ✅, ✅ 函数式 }
-            @row { 缩进块, ❌, ✅, 部分, ✅ }
-            @row { 数学, ❌, ❌, ✅, ✅ }
-            @row { 类型定义, ❌, ❌, ❌, ✅ }
+        @p "Core architecture is based on unified functional blocks."
+        @table(caption: "Language Comparison") {
+            @header { Feature, HTML, YAML, TeX, Nova }
+            @row { Tags, ✅, ❌, ✅, ✅ Functional }
+            @row { Indentation, ❌, ✅, Partial, ✅ }
+            @row { Math, ❌, ❌, ✅, ✅ }
+            @row { Type Defs, ❌, ❌, ❌, ✅ }
         }
     }
 
     @chapter(id: "api") {
-        @p "数据模型定义："
+        @p "Data model definition:"
         @schema(Measurement) {
             sensor_id: Int32 @1
             value: Float64 @2 = 0.0
@@ -319,4 +333,4 @@ Nova 可直接定义强类型消息，用于生成序列化代码、验证数据
         @entry(key: nova2026, title: "Nova Language Spec", year: 2026)
     }
 }
-```
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nova-lang/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Nova: Nested Ordered Versatile Architecture — a programmable markup language CLI",
   "license": "MIT",
   "keywords": [