@jboltai/tokui 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jboltai/tokui",
-  "version": "0.1.2",
+  "version": "0.1.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",
@@ -89,7 +89,7 @@
     "typecheck": "tsc",
     "coverage": "c8 --include='src/**/*.js' --exclude='src/server/**' npm run test:all",
     "server": "node demo/server/sse-server.js",
-    "demo:sync": "npm run build && cp dist/tokui.umd.js dist/tokui.css demo/lib/",
+    "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",
     "build:lib": "vite build --mode lib",

package/src/index.d.ts

@@ -25,6 +25,13 @@ export interface TokUIOptions {
   container?: string | HTMLElement | null;
   /** 主题名称，如 'default' / 'dark'，默认 'default' */
   theme?: string;
+  /**
+   * 界面语言（组件骨架级文案：aria-label / placeholder / 空态 / 默认按钮字等）。
+   * 接受 'zh-CN' / 'en-US' / 'en' / 'zh' 等，自动规整；缺省按
+   * documentElement.lang → navigator.language → 'zh-CN' 自动探测。
+   * 注：业务 DSL 文案（tt:/l:/tx:/opt: 等）不归此管，需后端按 locale 发不同 DSL。
+   */
+  locale?: string;
   /** 是否启用流式渲染模式，默认 true */
   streaming?: boolean;
   /** 事件回调，如接收到 ('streamEnd', {}) */
@@ -58,6 +65,12 @@ export class TokUI {
   /** 一次性渲染完整 DSL 文本到容器 */
   render(tokuiString: string, targetContainer?: HTMLElement): void;
 
+  /**
+   * 用当前 locale / theme 就地重画最近一次渲染的内容（清容器 + 重新 render 缓存的 DSL）。
+   * 典型用途：setLocale() 后刷新已渲染 DOM 的 chrome 文案。无缓存内容或无容器返回 false。
+   */
+  rerender(targetContainer?: HTMLElement): boolean;
+
   /** 开始流式渲染（初始化流式解析器） */
   startStream(targetContainer?: HTMLElement): void;
 
@@ -90,6 +103,23 @@ export declare function setTheme(themeName: string): void;
 /** 获取当前主题名称 */
 export declare function getTheme(): string;
 
+/**
+ * 设置当前界面语言（组件骨架级文案）。已渲染的 DOM 不会自动更新，
+ * 需重新渲染或应用层自行刷新。接受 'zh-CN' / 'en-US' / 'en' / 'zh' 等，自动规整。
+ * @returns 规整后实际生效的 locale（如传 'en' 返回 'en-US'）
+ */
+export declare function setLocale(locale: string): string;
+
+/** 获取当前界面语言（规整后的 locale，如 'zh-CN' / 'en-US'） */
+export declare function getLocale(): string;
+
+/**
+ * 注册/合并新语种字典（内置仅 zh-CN + en-US，其余语种由此注入）。
+ * @param locale - 语种 key，如 'ja-JP'
+ * @param dict   - key→译文 映射，可仅传部分 key（增量合并）
+ */
+export declare function registerLocale(locale: string, dict: Record<string, string>): void;
+
 /**
  * DOM 创建快捷方法
  * @param tag         - 标签名
@@ -109,6 +139,9 @@ export interface TokUINamespace {
   removeHandler: typeof removeHandler;
   setTheme: typeof setTheme;
   getTheme: typeof getTheme;
+  setLocale: typeof setLocale;
+  getLocale: typeof getLocale;
+  registerLocale: typeof registerLocale;
   el: typeof el;
 }
 

package/src/server/tokui-builder.js

@@ -36,8 +36,9 @@ class TokUIBuilder {
         let val = String(v);
         // 转义值中的双引号
         val = val.replace(/"/g, '\\"');
-        // 值含空格、引号、换行符或 ] 时用双引号包裹
-        if (val.includes(' ') || val.includes('"') || val.includes('\n') || val.includes(']')) {
+        // opt 简写值含 : ; 分隔符，必须强制双引号（parser 引号感知整串作字面值）；
+        // 其余含空格/引号/换行/] 的值同样需引号
+        if (k === 'opt' || val.includes(' ') || val.includes('"') || val.includes('\n') || val.includes(']')) {
           return `${k}:"${val}"`;
         }
         return `${k}:${val}`;
@@ -228,13 +229,26 @@ class TokUIBuilder {
   /** 自定义选择器 */
   picker(attrs) { return this._open('picker', attrs); }
   /** 下拉选择框 */
-  select(attrs) { return this._open('select', attrs); }
+  select(attrs) {
+    return attrs && attrs.opt
+      ? this._selfClosing('select', null, attrs)
+      : this._open('select', attrs);
+  }
   /** 选项 */
   opt(attrs) { return this._selfClosing('opt', null, attrs); }
   /** 单选按钮组 */
-  radio(attrs) { return this._open('radio', attrs); }
+  radio(attrs) {
+    return attrs && attrs.opt
+      ? this._selfClosing('radio', null, attrs)
+      : this._open('radio', attrs);
+  }
   /** 复选框 */
-  checkbox(attrs) { return this._selfClosing('checkbox', null, attrs); }
+  checkbox(attrs) {
+    // 简写 opt:"..." → 自闭合；多选容器 multi → _open；单布尔 → 自闭合
+    if (attrs && attrs.opt) return this._selfClosing('checkbox', null, attrs);
+    if (attrs && attrs.multi !== undefined) return this._open('checkbox', attrs);
+    return this._selfClosing('checkbox', null, attrs);
+  }
   /** 开关组件（方法名 switcher 避开 JS 关键字） */
   switcher(attrs) { return this._selfClosing('switch', null, attrs); }
   /** 多行文本框 */
@@ -355,6 +369,10 @@ class TokUIBuilder {
 
   /** Empty 空状态（自闭合） */
   empty(attrs) { return this._selfClosing('empty', null, attrs); }
+  /** Code128 条形码：tx 数据 / l 标签 / s 尺寸(sm/md/lg) */
+  barcode(attrs) { return this._selfClosing('barcode', null, attrs); }
+  /** QR 二维码：tx 数据 / l 标签 / s 尺寸 / ec 纠错级(L/M/Q/H) */
+  qrcode(attrs) { return this._selfClosing('qrcode', null, attrs); }
   /** Result 结果页（自闭合） */
   result(attrs) { return this._selfClosing('result', null, attrs); }
   /** Stat 统计数值（自闭合） */
@@ -407,8 +425,21 @@ class TokUIBuilder {
 
   // ========== 动态更新 ==========
 
-  /** Upd 异步更新指令（自闭合），推送状态更新到已有组件 */
-  upd(attrs) { return this._selfClosing('upd', null, attrs); }
+  /** Upd 异步更新指令（自闭合），推送状态更新到已有组件
+   *  注意：serializeAttrs 默认跳过 false 值（初始渲染 [input dis:false] 会被 parser
+   *  读成字符串 'false' 误判为 truthy → 反而禁用，故 false 必须省略）。
+   *  但 upd 的 dis:false / ro:false / chk:false 是「主动关闭」语义，渲染端 _update
+   *  专门判 === 'false'。故此处把 false 预规范成 'false' 字符串再序列化，让 toggle-off 生效。*/
+  upd(attrs) {
+    if (attrs && typeof attrs === 'object') {
+      const norm = {};
+      for (const [k, v] of Object.entries(attrs)) {
+        norm[k] = v === false ? 'false' : v;
+      }
+      return this._selfClosing('upd', null, norm);
+    }
+    return this._selfClosing('upd', null, attrs);
+  }
 
   // ========== 交互组件 ==========