用途 tui-popup 用于为 Popup 组件生成 ASCII 文本界面（TUI）表示。它把 Popup 的布局、样式与状态转成等宽字符渲染图，并同时给出可供 Pencil MCP 使用的结构化规格与批处理设计计划。它不嵌入外部文档链接，如需要规范参考，应使用团队的组件文档或设计系统来源。
主要能力 技能固定输出以下块：
- TUI_RENDER：仅含等宽字符的文本渲染结果。
- COMPONENT_SPEC：JSON 规格，包含 id、name、type、bbox（topPx/leftPx/widthPx/heightPx）、zIndex、layout（paddingPx、gapPx、align、valign）、style（fillColor、textColor、strokeColor、strokeThickness、cornerRadius、opacity）、typography（fontFamily、fontSize、fontWeight、lineHeight）、overflow（mode、ellipsis、maxLines）、state（focused、disabled、loading、error）与 hotkeys。
- PENCIL_SPEC：包含 canvas（widthPx、heightPx、backgroundColor）、grid（cellWidthPx、cellHeightPx）、nodes、components。
- PENCIL_BATCH_DESIGN：Pencil MCP 的批处理设计计划，按调用组织，每次调用不超过 25 个操作，使用 G/I/U 等操作语句构建 screen、背景矩形与文本节点。 技能始终输出布局属性（top/left/width/height、间距、颜色、排版、zIndex）。
使用方式 推荐输入模型为一个 JSON 对象，字段包括 widthCols、grid（cellWidthPx、cellHeightPx）、props、modelValue、state（focused、disabled、loading、error）、style、typography、layout、hotkeys。例如默认输入示例中 widthCols 为 70，cellWidthPx 为 8，cellHeightPx 为 16，字体为 Inter、字号 14、字重 400、行高 20，paddingPx 16、gapPx 8，填充色 #ffffff、文字色 #111111、描边 #e5e7eb、描边宽度 1、圆角 12。 渲染遵循 tui-front-ui 的共享规则：不使用 TAB 字符；不超过 widthCols；提供表头行、主体区以及交互时的最小热键；disabled=true 时抑制交互提示；loading=true 时显示稳定占位；error!=null 时在单行页脚打印并按宽度截断。
示例行为 示例 1（最小/默认）输出默认 Popup 渲染，COMPONENT_SPEC 中 bbox 为 top 24、left 24、width 342、height 96，zIndex 1。 示例 2（自定义样式）渲染出带“Confirm action?”与 [Cancel]/[Confirm] 的弹窗，高度 104，paddingPx 20、gapPx 10，描边色 #111111、描边宽度 2。 示例 3（disabled/error 边界情况）渲染显示 [Popup] Disabled，标注“(overlay hidden)”，state 中 disabled 为 true、error 为“Something went wrong”，并以“Error: Something went wrong…”单行页脚呈现。
适用场景 适用于需要将 Popup 组件以纯文本 TUI 形式表达、并同时产出可直接供 Pencil MCP 使用的组件规格与批处理设计计划的流程；也适用于聚合页面时按组件汇总行（id、name、top、left、width、height、z、keyProps、state、hotkeys）进行汇总。
限制 该技能明确不嵌入外部文档链接；不提供收费、价格、平台或效果等未在资料中说明的信息；资料中未列出具体安装命令，因此暂未提供。输出必须包含全部四类输出块，且 PENCIL_BATCH_DESIGN 每次调用不超过 25 个操作。