@c2-markdown-ui/mdui-lang 0.0.0-stage → 0.4.4

package/README.md

@@ -1,3 +1,98 @@
-# Temporary Holding Version
+# @c2-markdown-ui/mdui-lang
+**Write widgets 60% faster with concise DSL syntax.**
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Transform verbose JSON into elegant one-liners that actually make sense.
+
+```
+select env [dev staging prod] dev
+```
+↓
+```json
+{"type": "select", "id": "env", "choices": ["dev", "staging", "prod"], "default": "dev"}
+```
+
+## Installation
+
+```bash
+npm install @c2-markdown-ui/mdui-lang
+```
+
+## Usage
+
+```typescript
+import { parseDSL } from '@c2-markdown-ui/mdui-lang';
+
+const result = parseDSL('text-input username "Username" "Enter username"');
+console.log(result.widget);
+// Perfect JSON output, ready to use
+```
+
+## DSL patterns
+
+**Single-line widgets**
+```
+text-input username "Username" "Enter here"
+button-group env [dev staging prod] dev
+select region [us-east us-west] us-east
+slider cpu 1 32 1 4
+```
+
+**Multi-line forms**
+```
+form deploy "Launch"
+  text-input name "App Name"
+  select env [dev prod] dev
+  slider replicas 1 10 1 3
+```
+
+**Interactive charts**
+```
+chart-line
+title: Monthly Sales
+height: 300
+Month,Sales,Target
+Jan,100,120
+Feb,150,140
+Mar,200,180
+```
+
+All parameters after `id` are optional and positional.
+
+## Simple rules
+
+- **Spaces separate tokens**: `text-input username "User Name"`
+- **Brackets for arrays**: `[dev staging prod]`  
+- **Quotes for strings**: `"Enter your name here"`
+- **2-space indentation**: For forms only
+- **Everything optional**: Except widget type and id
+
+## API
+
+```typescript
+interface ParseResult {
+  success: boolean;
+  widget?: Widget;      // Parsed widget if successful  
+  error?: string;       // Error message if failed
+}
+
+const result = parseDSL('select env [dev prod]');
+if (result.success) {
+  console.log(result.widget); // Ready-to-use JSON
+}
+```
+
+**Why DSL beats JSON**
+
+❌ **JSON** (130 chars)
+```json
+{"type": "text-input", "id": "username", "label": "Username", "placeholder": "Enter username", "default": "john"}
+```
+
+✅ **DSL** (52 chars)
+```
+text-input username "Username" "Enter username" "john"
+```
+
+**60% fewer keystrokes. 100% more readable.**
+
+MIT © 2025

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DSLParser, parseDSL, parseDSLStreaming } from './parser.js';
+export { serializeDSL, serializeFieldWithSpan } from './serialize.js';
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { DSLParser, parseDSL, parseDSLStreaming } from './parser.js';
+export { serializeDSL, serializeFieldWithSpan } from './serialize.js';
+export * from './types.js';

package/dist/parser.d.ts

@@ -0,0 +1,137 @@
+import { ParseResult, StreamingParseResult } from './types.js';
+export declare class DSLParser {
+    parse(input: string): ParseResult;
+    private tokenize;
+    /** 从位置 i（指向 [ 或 {）开始，按引号感知 + 深度追踪，返回完整 data:[...]/data:{...} token 串。
+     *  起始是 { 时按对象深度配平；输入被截断（流式未写完）时取到末尾，由 parseCascadeNodes 报错兜底 */
+    private scanDataArray;
+    /**
+     * Normalize array syntax to handle common AI output variations.
+     * Converts formats like ["a","b","c"] or ["a", "b", "c"] to ["a" "b" "c"]
+     */
+    private normalizeArraySyntax;
+    private parseArray;
+    /** 从字段 token 中提取 label:/hint:/pattern:/message: 修饰符（key:value 形式，与位置参数顺序无关）
+     *  及 required 布尔标记，返回剩余位置参数（不含类型名）与各修饰值。
+     *  含空格的值写作 key:"含 空格"，tokenize 剥引号后仍是单 token */
+    private extractFieldMods;
+    private parseTextInput;
+    /** 解析单个按钮：button id "文字" color:#3b82f6 size:large */
+    /** 纯文字组件：text [id] "内容" [size:N] [color:xx] [bold] [align:xx]
+     *  非参数 token：1 个=纯内容（id 自动生成）；≥2 个=第一个是 id，第二个是内容 */
+    private parseText;
+    private parseButton;
+    private parseButtonGroup;
+    private parseSelect;
+    private parseSelectMulti;
+    /** 解析单选组件：radio-group id [choices] [default] [button] [label:xx] [hint:xx] [required]
+     *  [message:xx] [url:xx] [direction:horizontal|vertical] [columns:N] [disabled]
+     *  choices 兼容字符串数组（key:label）与对象数组（{key|value,label}）；default 为单值；
+     *  button 标记切换为按钮组样式（参考 antd Radio optionType:button） */
+    private parseRadioGroup;
+    /** 解析 select-multi choices：token 以 [{ 开头视为对象数组（[{key|value,label} ...]），
+     *  容错 JSON 解析（单引号、未引号 key/值、尾逗号、元素间空格分隔、截断补齐）并归一化为
+     *  {value,label} 数组（key 作为 value 别名，value > key）；否则按普通字符串数组解析 */
+    private parseObjectChoices;
+    /** 容错修复对象数组 choices 文本（整体含外层 []），返回解析结果（失败抛错）。
+     *  支持的 AI 风格写法：单引号、\xxx\ 反斜杠引号、未引号 key、未引号字符串值、
+     *  尾逗号、元素间空格分隔（} { → },{）、输入截断自动补齐 */
+    private repairObjectChoices;
+    /** 解析级联选择器：cascade id [路径数组] [default路径] [label:xx] [hint:xx] [required] [disabled] [placeholder:xx]
+     *  [url:xx] [data:[{...}]]
+     *  静态数据源兼容共存：
+     *  - choices 扁平路径数组：每项用 / 分隔层级，每段支持 key:label（如 zj:浙江/hz:杭州）
+     *  - data 嵌套对象树：CascadeNode[]，如 [{"value":"zj","label":"浙江","children":[...]}]（优先于 choices）
+     *  - data/url 单独出现时（无 choices）也合法：choices 退化为 [] */
+    private parseCascade;
+    /** 解析树形选择器：tree-select id [路径数组] [default值] [label:xx] [hint:xx] [required] [disabled]
+     *  [placeholder:xx] [url:xx] [data:[{...}]]
+     *  [multiple] [checkStrictly] [strategy:all|parent|child] [maxTagCount:N] [treeLine] [searchable]
+     *  静态数据源兼容共存（与 cascade 一致）；多选/单选对齐 antd（multiple 开启多选，默认单选）；
+     *  searchable 显式开启搜索（默认关闭，对齐 antd showSearch 默认 false） */
+    private parseTreeSelect;
+    /** 把 data:[...] token 解析为嵌套对象树（CascadeNode[]）。token 形如 [{...}] / {...}（data: 前缀已被 extractFieldMods 剥除）。
+     *  先按严格 JSON 解析；失败再容错修复 AI 风格写法：
+     *  - 单引号 → 双引号；反斜杠引号 \xxx\ → "xxx"（键值两侧成对出现时）
+     *  - 未加引号的 key（{value: / ,value: / ,children: → 补双引号）
+     *  - 行尾/值后多余逗号；输入被截断（末尾缺引号/]/}）自动补齐
+     *  - value/label 支持数字字面量；字段名兼容 key（key 作为 value 别名，由渲染端 nodesToTree 处理）
+     *  - 顶层是单个对象（{...} 或 {data:[...]} 包裹）时提取其内部数组 */
+    private parseCascadeNodes;
+    /** 容错修复 AI 风格/截断的 data 树文本，返回解析结果（失败抛错） */
+    private repairCascadeData;
+    private parseSlider;
+    /** 解析开关：switch id [true|false] [label:xx] [checkedText:xx] [unCheckedText:xx]
+     *  [hint:xx] [required] [disabled]（default 位置参数接受 true/false 字面量） */
+    private parseSwitch;
+    /** 解析日期选择框：date-picker id [default] [picker:datetime] [range] [format:YYYY-MM-DD]
+     *  [disableBeforeNow] [disableAfterNow] [placeholder:xx] [label:xx] [hint:xx] [required]
+     *  default 接受时间戳（毫秒数字）或格式化时间字符串；range 模式为 [start end] 数组 */
+    private parseDatePicker;
+    /** 解析数字输入框：number-input id [label] [default] [min:N] [max:N] [step:N] [precision:N]
+     *  [placeholder:xx] [label:xx] [hint:xx] [required] [message:xx]
+     *  label/default 均为位置参数：像数字（整数/小数/负数）的当 default，其余当 label（与 date-picker 约定一致） */
+    private parseNumberInput;
+    /** 从字段行提取尾部 span:N 修饰符（类似 antd Col 的 span），返回 [剩余行, span] */
+    private extractFieldSpan;
+    /** 从字段行提取尾部 when:字段id:值1,值2 修饰符（form 内联动显隐），返回 [剩余行, when] */
+    private extractFieldWhen;
+    /** 解析 when 值段的比较运算符前缀（> >= < <= !=）：返回 [op, 值列表]。
+     *  无前缀或前缀后无有效值时返回 ['eq', 原值列表]（向后兼容） */
+    private parseWhenOp;
+    /** 循环提取字段行尾部的 when/when-any/span 修饰符（支持任意书写顺序），
+     *  返回 [剩余行, span, when]。多个 when: 为 AND 组合；多个 when-any: 为 OR 组合；
+     *  两组同时存在时取交集（all 且 any）。仅且组时保持对象/数组形态（向后兼容）；
+     *  含或组时输出 FieldWhenGroup { all, any } */
+    private extractFieldModifiers;
+    /** 判断字段首行是否为多行块组件（chart 系列）的起始行 */
+    private isMultiLineFieldStart;
+    /** 从 "row" 行提取 gutter:N 参数（类似 antd Row 的 gutter），返回 [gutter] */
+    private parseRowGutter;
+    private parseForm;
+    /** 解析独立栅格组件：
+     *  row [id] [gutter:N] [justify:left|center|right|between] [align:top|middle|bottom]
+     *    col [span:N] [offset:N] [align:top|middle|bottom]
+     *      <任意 widget DSL>
+     */
+    private parseRow;
+    private parseChart;
+    private parseMultipleChoiceQuestion;
+    private parseShortAnswerQuestion;
+    private parseQuiz;
+    /**
+     * Streaming-aware parsing that returns partial results for incomplete input.
+     * This is designed for AI streaming scenarios where content arrives incrementally.
+     */
+    parseStreaming(input: string): StreamingParseResult;
+    /**
+     * Detect if input has unclosed brackets or quotes
+     */
+    private detectPendingState;
+    /**
+     * Parse widget with incomplete input, filling in defaults for missing parts
+     */
+    private parsePartialWidget;
+    /**
+     * Auto-complete unclosed arrays by adding closing bracket
+     */
+    private autoCompleteArrays;
+    /**
+     * Parse partial quiz, extracting whatever questions are complete
+     */
+    private parsePartialQuiz;
+    /**
+     * Parse a single question line, handling incomplete input
+     */
+    private parsePartialQuestion;
+    /**
+     * Parse partial form
+     */
+    private parsePartialForm;
+    /**
+     * Parse partial chart
+     */
+    private parsePartialChart;
+}
+export declare function parseDSL(input: string): ParseResult;
+export declare function parseDSLStreaming(input: string): StreamingParseResult;