@jboltai/tokui 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jboltai/tokui",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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",

package/src/index.d.ts

@@ -49,6 +49,13 @@ export interface TokUIOptions {
   locale?: string;
   /** 是否启用流式渲染模式，默认 true */
   streaming?: boolean;
+  /**
+   * 流式入场动画开关，默认 true。
+   * true：流式挂载的顶层元素挂 tokui-fade-in 淡入（嵌套元素与纯文本 chunk 不挂）；
+   * false：流式路径完全关闭入场动画（大对话/高频流式性能场景）。
+   * 不影响一次性 render() 的入场动画。
+   */
+  streamAnimation?: boolean;
   /** 事件回调：('streamEnd', {}) 流结束；('component', TokUIComponentEvent) 组件交互统一出口 */
   onEvent?: TokUIEventCallback | null;
   /** 组件交互事件过滤器：返回 false 丢弃该事件（onEvent 降噪用，如只看某类组件） */

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

@@ -95,6 +95,10 @@ export declare class TokUIBuilder {
   floatButton(attrs?: BuilderAttrs): this;
   masonry(attrs?: BuilderAttrs): this;
 
+  // —— 高级网格布局（容器，需 end() 闭合）——
+  grid(attrs?: BuilderAttrs): this;
+  cell(attrs?: BuilderAttrs): this;
+
   // —— 表格辅助 ——
   thead(attrs?: BuilderAttrs): this;
   theadCols(cols: any[]): this;
@@ -102,4 +106,8 @@ export declare class TokUIBuilder {
 
   // —— 代码块（容器）——
   code(attrs?: BuilderAttrs): this;
+
+  // —— AI 对话组件（plan-step 支持 [upd id:] 步骤推进）——
+  plan(attrs?: BuilderAttrs): this;
+  planStep(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）。