@jboltai/tokui 0.2.0 → 0.2.2

package/package.json

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

@@ -149,6 +149,34 @@ export declare function el(
   textContent?: string
 ): HTMLElement;
 
+/**
+ * modal.confirm 命令式确认对话框选项
+ */
+export interface TokUIModalConfirmOptions {
+  /** 标题（缺省取 i18n modal.aria） */
+  tt?: string;
+  /** 正文文本 */
+  tx?: string;
+  /** 确认按钮类型：'danger' 红色警示，缺省 primary */
+  t?: 'danger' | 'primary';
+  /** 确认按钮文案（缺省 i18n common.ok） */
+  'ok-text'?: string;
+  /** 取消按钮文案（缺省 i18n common.cancel） */
+  'cancel-text'?: string;
+  /** 确认回调（Promise resolve(true) 之前触发） */
+  onOk?: () => void;
+  /** 取消/关闭回调（Promise resolve(false) 之前触发） */
+  onCancel?: () => void;
+}
+
+/**
+ * 命令式确认对话框 API（宿主侧 JS 调用，不经 DSL）。
+ * `TokUI.modal.confirm(opts)` / `TokUI.confirm(opts)` → Promise<boolean>（确认 true / 取消·Esc·遮罩 false）
+ */
+export interface TokUIModalApi {
+  confirm(opts?: TokUIModalConfirmOptions): Promise<boolean>;
+}
+
 /** 公共命名空间对象（ESM default 导出） */
 export interface TokUINamespace {
   TokUI: typeof TokUI;
@@ -160,6 +188,10 @@ export interface TokUINamespace {
   getLocale: typeof getLocale;
   registerLocale: typeof registerLocale;
   el: typeof el;
+  /** 命令式确认对话框（浏览器环境可用；SSR 为 undefined） */
+  readonly modal?: TokUIModalApi;
+  /** modal.confirm 的便捷别名 */
+  readonly confirm?: (opts?: TokUIModalConfirmOptions) => Promise<boolean>;
 }
 
 declare const TokUINamespace: TokUINamespace;

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

@@ -78,6 +78,22 @@ export declare class TokUIBuilder {
   btngroup(attrs?: BuilderAttrs): this;
   picker(attrs?: BuilderAttrs): this;
   toggleGroup(attrs?: BuilderAttrs): this;
+  affix(attrs?: BuilderAttrs): this;
+  tour(attrs?: BuilderAttrs): this;
+  previewGroup(attrs?: BuilderAttrs): this;
+
+  // —— Phase 4 自闭合 ——
+  segmented(attrs?: BuilderAttrs): this;
+  colorPicker(attrs?: BuilderAttrs): this;
+  anchor(attrs?: BuilderAttrs): this;
+  lk(attrs?: BuilderAttrs): this;
+  tourStep(attrs?: BuilderAttrs): this;
+
+  // —— P2 组件 ——
+  kbd(content?: string, attrs?: BuilderAttrs): this;
+  editable(attrs?: BuilderAttrs): this;
+  floatButton(attrs?: BuilderAttrs): this;
+  masonry(attrs?: BuilderAttrs): this;
 
   // —— 表格辅助 ——
   thead(attrs?: BuilderAttrs): this;

package/src/server/tokui-builder.js

@@ -552,6 +552,35 @@ class TokUIBuilder {
   /** 菜单容器 */
   menu(attrs) { return this._open('menu', attrs); }
 
+  /** 分段控制器（自闭合，opt:"v:label;..."） */
+  segmented(attrs) { return this._selfClosing('segmented', null, attrs); }
+  /** 颜色选择器（自闭合） */
+  colorPicker(attrs) { return this._selfClosing('color-picker', null, attrs); }
+  /** 固钉容器 */
+  affix(attrs) { return this._open('affix', attrs); }
+  /** 锚点导航（带 opt 简写 → 原子自闭合；否则容器收 lk 子项） */
+  anchor(attrs) {
+    if (attrs && attrs.opt) return this._selfClosing('anchor', null, attrs);
+    return this._open('anchor', attrs);
+  }
+  /** 锚点子项（自闭合，anchor 容器模式用；d 为层级深度） */
+  lk(attrs) { return this._selfClosing('lk', null, attrs); }
+
+  /** 键盘按键（行内自闭合） */
+  kbd(content, attrs) { return this._selfClosing('kbd', content, attrs); }
+  /** 行内编辑（自闭合） */
+  editable(attrs) { return this._selfClosing('editable', null, attrs); }
+  /** 浮动按钮组容器 */
+  floatButton(attrs) { return this._open('float-button', attrs); }
+  /** 瀑布流容器 */
+  masonry(attrs) { return this._open('masonry', attrs); }
+  /** 漫游引导容器 */
+  tour(attrs) { return this._open('tour', attrs); }
+  /** 漫游引导步骤（自闭合标记） */
+  tourStep(attrs) { return this._selfClosing('tour-step', null, attrs); }
+  /** 图片预览组容器 */
+  previewGroup(attrs) { return this._open('preview-group', attrs); }
+
   /** 对话输入框（容器模式，支持自定义子节点） */
   chatInput(attrs) { return this._open('chat-input', attrs); }