@jboltai/tokui 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jboltai/tokui",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "TokUI — Zero-dependency streaming UI description & rendering framework for AI chat. Describe UI with a tiny DSL, stream over SSE, render to real DOM incrementally.",
   "keywords": [
     "tokui",
@@ -91,6 +91,7 @@
     "typecheck": "tsc",
     "coverage": "c8 --include='src/**/*.js' --exclude='src/server/**' npm run test:all",
     "server": "node demo/server/sse-server.js",
+    "demo:validate": "node demo/server/validate-demos.js",
     "demo:sync": "npm run build && cp dist/tokui.umd.js dist/tokui.css demo/lib/ && perl -i -ne 'print unless m{^//# sourceMappingURL=}' demo/lib/tokui.umd.js && cp src/server/tokui-builder.js demo/server/tokui-builder.js",
     "dev": "vite",
     "build": "vite build --mode lib",

package/src/server/tokui-builder.d.ts

@@ -94,6 +94,31 @@ export declare class TokUIBuilder {
   editable(attrs?: BuilderAttrs): this;
   floatButton(attrs?: BuilderAttrs): this;
   masonry(attrs?: BuilderAttrs): this;
+  scrollArea(attrs?: BuilderAttrs): this;
+  /** 科技边框容器（容器） */
+  panel(attrs?: BuilderAttrs): this;
+  /** 指标卡（容器） */
+  kpi(attrs?: BuilderAttrs): this;
+  /** 数字翻牌器（自闭合） */
+  flipNum(attrs?: BuilderAttrs): this;
+  /** 轮播榜单（容器） */
+  scrollboard(attrs?: BuilderAttrs): this;
+  /** 大屏缩放容器 */
+  fitScreen(attrs?: BuilderAttrs): this;
+
+  // —— 应用壳（M2 / T2.1，容器，需 end() 闭合）——
+  /** 应用壳（三件套落位 grid areas） */
+  page(attrs?: BuilderAttrs): this;
+  /** 页头（子节点为右侧动作区；bc 面包屑、sticky 吸顶） */
+  pageHeader(attrs?: BuilderAttrs): this;
+  /** 侧栏（品牌行 + 折叠钮 + 滚动主体） */
+  pageSidebar(attrs?: BuilderAttrs): this;
+  /** 主区薄包装 */
+  pageContent(attrs?: BuilderAttrs): this;
+  /** 多页签容器（act 初始激活 key） */
+  pageTabs(attrs?: BuilderAttrs): this;
+  /** 单页签（n 为 key，closeable 可关闭） */
+  pageTab(attrs?: BuilderAttrs): this;
 
   // —— 高级网格布局（容器，需 end() 闭合）——
   grid(attrs?: BuilderAttrs): this;

package/src/server/tokui-builder.js

@@ -218,13 +218,19 @@ class TokUIBuilder {
   tbody() { return this._open('tbody'); }
   /** 表格数据行，多个值用逗号拼接，含逗号的值自动加双引号 */
   row(...values) {
+    // T2.3：尾参可为 attrs 对象（tr id/pid/clk 等）——[tr id:x pid:y] 树形行/行点击
+    let attrs;
+    const last = values[values.length - 1];
+    if (last && typeof last === 'object' && !Array.isArray(last)) {
+      attrs = values.pop();
+    }
     const escaped = values.map(v => {
       const s = String(v);
       // 只对含逗号的 cell 加引号，含冒号的交给 _selfClosing 统一处理
       if (s.includes(',')) return `"${s}"`;
       return s;
     });
-    return this._selfClosing('tr', escaped.join(','));
+    return this._selfClosing('tr', escaped.join(','), attrs);
   }
 
   // ========== 表单组件 ==========
@@ -348,9 +354,9 @@ class TokUIBuilder {
     var a = attrs || {};
     // hasInline 判定：凡带内联数据载体的 chart 均自闭合。
     // d=柱/折/面积/饼/雷达/散点/气泡/直方/瀑布/箱线/K线/树图; tasks=甘特;
-    // rows=热力; nodes+flows=桑基; v=仪表盘/进度条(单值)。
+    // rows=热力; nodes+flows=桑基; v=仪表盘/进度条(单值); region=地图省级热力。
     // 漏判会让本应自闭合的 chart 走容器分支，.end() 错位闭合 → 后续栅格结构串味乱套。
-    var hasInline = a.d || a.tasks || a.rows || (a.nodes && a.flows) ||
+    var hasInline = a.d || a.tasks || a.rows || a.region || (a.nodes && a.flows) ||
       (a.v !== undefined && (a.t === 'gauge' || a.t === 'progress'));
     // 布局属性前置：流式预览阶段 d/tasks 边到边长，若 orient/stack/smooth/area 排在数据后，
     // parser 半成品看不到 → 预览用默认布局，] 闭合才翻转（如 orient:h 末尾到达致纵向→横向闪）。
@@ -668,6 +674,43 @@ class TokUIBuilder {
 
   /** 终端输出（容器） */
   terminal(attrs) { return this._open('terminal', attrs); }
+  // ========== 数据大屏组件（M1 Dashboard Pack） ==========
+
+  /** 科技边框容器（容器） */
+  panel(attrs) { return this._open('panel', attrs); }
+
+  /** 指标卡（容器，子节点为底部说明行） */
+  kpi(attrs) { return this._open('kpi', attrs); }
+
+  /** 数字翻牌器（自闭合） */
+  flipNum(attrs) { return this._selfClosing('flip-num', null, attrs); }
+
+  /** 轮播榜单（容器，可加 tr 子节点行） */
+  scrollboard(attrs) { return this._open('scrollboard', attrs); }
+
+  /** 大屏缩放容器（1920×1080 设计稿等比适配） */
+  fitScreen(attrs) { return this._open('fit-screen', attrs); }
+
+  // ========== 应用壳组件（M2 Admin Pack / T2.1，均为容器需 .end()） ==========
+
+  /** 应用壳（page-header/page-sidebar/page-content 三件套落位 grid areas） */
+  page(attrs) { return this._open('page', attrs); }
+
+  /** 页头（子节点为右侧动作区；bc 逗号分级面包屑，sticky 吸顶） */
+  pageHeader(attrs) { return this._open('page-header', attrs); }
+
+  /** 侧栏（内置品牌行 + 折叠钮，子节点为主体内容） */
+  pageSidebar(attrs) { return this._open('page-sidebar', attrs); }
+
+  /** 主区薄包装（自滚动 + 裁剪防护） */
+  pageContent(attrs) { return this._open('page-content', attrs); }
+
+  /** 多页签容器（act 指定初始激活页签 key） */
+  pageTabs(attrs) { return this._open('page-tabs', attrs); }
+
+  /** 单页签（n 为 key，closeable 可关闭，del 整签移除） */
+  pageTab(attrs) { return this._open('page-tab', attrs); }
+
 
   /** 流式闪光加载（自闭合） */
   shimmer(attrs) { return this._selfClosing('shimmer', null, attrs); }