@jboltai/tokui 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jboltai/tokui",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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,21 @@ 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;
+
+  // —— 高级网格布局（容器，需 end() 闭合）——
+  grid(attrs?: BuilderAttrs): this;
+  cell(attrs?: BuilderAttrs): this;
 
   // —— 表格辅助 ——
   thead(attrs?: BuilderAttrs): this;

package/src/server/tokui-builder.js

@@ -296,6 +296,10 @@ class TokUIBuilder {
   row_layout(attrs) { return this._open('row', attrs); }
   /** 栅格列 */
   col_layout(attrs) { return this._open('col', attrs); }
+  /** 高级网格容器（显式二维网格：cols/rows 轨道、areas 模板区域、gap/h 等） */
+  grid(attrs) { return this._open('grid', attrs); }
+  /** 网格单元（grid 子容器：area 区域名 / c 列跨 / r 行跨 / align / justify） */
+  cell(attrs) { return this._open('cell', attrs); }
   /** 列表 */
   list(attrs) { return this._open('list', attrs); }
   /** 列表项（有内容自闭合 [item 文本]，无内容开容器供嵌套子 list）。
@@ -344,9 +348,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 末尾到达致纵向→横向闪）。
@@ -664,6 +668,23 @@ 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); }
+
 
   /** 流式闪光加载（自闭合） */
   shimmer(attrs) { return this._selfClosing('shimmer', null, attrs); }