@givolt/i3-composer-agent 2.3.1 → 2.3.3

package/skills/i3-ui-prototype/assets/capabilities/management.json

@@ -0,0 +1,294 @@
+{
+  "schemaVersion": 1,
+  "id": "management",
+  "version": "1.3.0",
+  "regionModes": [
+    "management-list",
+    "edit-form",
+    "application-shell",
+    "content-reference",
+    "content"
+  ],
+  "capabilities": [
+    {
+      "id": "theme",
+      "title": "四种命名主题",
+      "appliesTo": [
+        "application-shell"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "defaultTheme": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "light"
+          ]
+        },
+        "presets": {
+          "type": "array",
+          "required": true,
+          "includes": [
+            "light",
+            "dark",
+            "fresh",
+            "tech"
+          ]
+        }
+      },
+      "scenarios": [
+        {
+          "id": "switch",
+          "title": "原生组件主题一致且保留业务状态",
+          "expected": "明亮、暗黑、清新、科技按名称选择；Table/Form/Drawer/Select浮层同步，切换不重挂、不丢筛选选择与未保存输入"
+        },
+        {
+          "id": "persistence",
+          "title": "实例主题偏好隔离与恢复",
+          "expected": "独立namespace主题键，刷新恢复；同源第二实例隔离；坏缓存与拒存储安全回退"
+        },
+        {
+          "id": "accessibility",
+          "title": "四主题可访问与窄屏",
+          "expected": "实际文字对比度、键盘焦点、320/375窄屏和减少动效均可验证"
+        }
+      ]
+    },
+    {
+      "id": "filter",
+      "title": "查询与重置",
+      "appliesTo": [
+        "management-list"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "resetPage": {
+          "type": "boolean",
+          "required": true,
+          "enum": [
+            true
+          ]
+        },
+        "clearSelection": {
+          "type": "boolean",
+          "required": true,
+          "enum": [
+            true
+          ]
+        }
+      },
+      "scenarios": [
+        {
+          "id": "query",
+          "title": "查询命中与无结果",
+          "expected": "条件只显示匹配记录，无匹配时显示空结果"
+        },
+        {
+          "id": "reset",
+          "title": "重置查询",
+          "expected": "条件清空、回到第一页并清空选择"
+        }
+      ]
+    },
+    {
+      "id": "selection",
+      "title": "当前页多选",
+      "appliesTo": [
+        "management-list"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "strategy": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "current-page-clear-on-change"
+          ]
+        }
+      },
+      "scenarios": [
+        {
+          "id": "select-page",
+          "title": "单选、全选与部分选中",
+          "expected": "选中数量和当前页全选状态与记录一致"
+        },
+        {
+          "id": "clear-on-change",
+          "title": "换页或筛选清空选择",
+          "expected": "翻页或重新筛选后选中数量为零"
+        }
+      ]
+    },
+    {
+      "id": "pagination",
+      "title": "分页",
+      "appliesTo": [
+        "management-list"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "mode": {
+          "type": "string",
+          "required": false,
+          "enum": [
+            "fixed",
+            "adjustable"
+          ],
+          "default": "fixed"
+        },
+        "fixedPageSize": {
+          "type": "integer",
+          "required": false,
+          "minimum": 1,
+          "requiredInMode": "fixed"
+        },
+        "defaultPageSize": {
+          "type": "integer",
+          "required": false,
+          "minimum": 1,
+          "requiredInMode": "adjustable"
+        },
+        "pageSizeOptions": {
+          "type": "array",
+          "required": false,
+          "items": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "minItems": 2,
+          "uniqueItems": true,
+          "requiredInMode": "adjustable"
+        },
+        "minimumTestPages": {
+          "type": "integer",
+          "required": true,
+          "minimum": 3
+        }
+      },
+      "scenarios": [
+        {
+          "id": "pages",
+          "title": "默认容量下至少三页记录",
+          "expected": "按固定容量或可调模式的默认容量核对首、中、末页及总数"
+        },
+        {
+          "id": "page-size",
+          "title": "绑定分页容量",
+          "expected": "fixed 只允许 fixedPageSize 且无容量切换；adjustable 只允许 defaultPageSize 与唯一正整数 pageSizeOptions，默认值必须包含其中；实际切换每个绑定选项并恢复默认值，重置页码与选择"
+        }
+      ]
+    },
+    {
+      "id": "bulk",
+      "title": "批量状态变更",
+      "appliesTo": [
+        "management-list"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "target": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "selected-only"
+          ]
+        }
+      },
+      "scenarios": [
+        {
+          "id": "selected-only",
+          "title": "批量操作正确对象",
+          "expected": "未选择时禁用；操作只更新选中记录并反馈结果"
+        }
+      ]
+    },
+    {
+      "id": "edit",
+      "title": "编辑表单",
+      "appliesTo": [
+        "edit-form"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "presentation": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "drawer"
+          ]
+        },
+        "preserveOnFailure": {
+          "type": "boolean",
+          "required": true,
+          "enum": [
+            true
+          ]
+        }
+      },
+      "scenarios": [
+        {
+          "id": "validation",
+          "title": "必填校验",
+          "expected": "空名称不保存并定位错误"
+        },
+        {
+          "id": "save",
+          "title": "保存同步",
+          "expected": "保存后列表中的正确记录更新，其他记录不变"
+        },
+        {
+          "id": "retry",
+          "title": "提交失败与重试",
+          "expected": "失败保留输入，重试成功后同步列表"
+        },
+        {
+          "id": "drawer-motion",
+          "title": "抽屉进入退出与模糊遮罩",
+          "expected": "进入退出动画完整，关闭后恢复焦点和滚动，遮罩实际具有滤镜"
+        }
+      ]
+    },
+    {
+      "id": "feedback",
+      "title": "数据状态与反馈",
+      "appliesTo": [
+        "management-list",
+        "edit-form",
+        "content"
+      ],
+      "requirement": "required",
+      "parameters": {
+        "states": {
+          "type": "array",
+          "required": true,
+          "includesByMode": {
+            "management-list": [
+              "loading",
+              "empty",
+              "error",
+              "success"
+            ],
+            "edit-form": [
+              "loading",
+              "error",
+              "success"
+            ],
+            "content": [
+              "loading",
+              "empty",
+              "error",
+              "success"
+            ]
+          }
+        }
+      },
+      "scenarios": [
+        {
+          "id": "states",
+          "title": "适用状态可触发并恢复",
+          "expected": "绑定 states 中的各状态可确定性触发；失败后保留必要输入，恢复后显示正确数据"
+        }
+      ]
+    }
+  ]
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/acceptance.json

@@ -0,0 +1,51 @@
+{
+  "schemaVersion": 1,
+  "frameworkId": "vue-antdv-next",
+  "version": "1.1.0",
+  "paginationFocusGuard": true,
+  "browserReview": {
+    "schemaVersion": 1,
+    "required": true,
+    "skill": "i3-browser-testing-with-devtools",
+    "provider": "chrome-devtools-mcp",
+    "observations": ["dom", "screenshot", "console", "network", "accessibility", "performance"]
+  },
+  "requiredChecks": ["typecheck", "unit-test", "production-build", "real-browser"],
+  "scenarios": [
+    {
+      "id": "template-content-projection", "required": true,
+      "steps": ["Edit supported HTML titles, labels and action text in a separate working template", "Sync and create a new native instance", "Build it and inspect the projected content through real components"],
+      "expected": "The new build visibly renders the changed HTML content through native components; the original instance remains unchanged. This existing browser journey is included in the fixed 20 baseline scenarios, or 23 when theme is explicitly enabled."
+    },
+    {
+      "id": "drawer-motion", "capabilityId": "edit", "required": true,
+      "steps": ["Open first record with normal motion", "Observe multiple nonterminal panel transforms during entry", "Close while recording DOM presence and transforms", "Wait for afterOpenChange(false)"],
+      "expected": "Native enter and exit occur; editor content remains during exit and is removed after exit. Do not replace this with a static screenshot or runtime declaration."
+    },
+    {
+      "id": "mask-blur", "capabilityId": "edit", "required": true,
+      "steps": ["Open editor", "Inspect visible native mask computed backdrop-filter and screenshot background", "Mutation check: remove actual filter while preserving class"],
+      "expected": "Mask has an effective non-none blur filter and visible background blur; class-only mutation fails."
+    },
+    {
+      "id": "focus-scroll", "capabilityId": "edit", "required": true,
+      "steps": ["Keyboard-open editor from a focused row action", "Check focus is in editor and cannot Tab out", "Check body scroll lock", "Close with Escape", "Check editor closes and focus returns to opener, scrolling unlocked"],
+      "expected": "Focus and scroll are restored after native exit; if the original row disappears, query is the fallback focus target."
+    },
+    {
+      "id": "reduced-motion", "capabilityId": "edit", "required": true,
+      "steps": ["Emulate prefers-reduced-motion: reduce", "Open and close editor", "Inspect actual animation and transition durations"],
+      "expected": "Motion is suppressed/reduced, close lifecycle still completes and focus restores."
+    },
+    {
+      "id": "instance-isolation", "capabilityId": "feedback", "required": true,
+      "steps": ["Use two generated instances on the same origin with distinct storageNamespace", "Edit one, reload both", "Reset one, reload both"],
+      "expected": "Each retains only its own data and reset has no effect on the other. Mock-version change loads deterministic seed."
+    },
+    {
+      "id": "build-identity", "required": true,
+      "steps": ["Build fixed candidate into immutable output", "Hash actual index/config/loaded resources", "Compare browser network-loaded build and candidate identity", "Try serving an older build"],
+      "expected": "Current build passes; stale build fails even if page metadata claims a current candidate."
+    }
+  ]
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/component-map.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "frameworkId": "vue-antdv-next",
+  "version": "1.0.0",
+  "capabilities": {
+    "filter": { "components": ["Input", "Select", "Button"], "implementation": "src/useDevices.ts", "applicationResponsibilities": ["compose committed name/status filters", "reset page and selection on query", "empty-result recovery"] },
+    "selection": { "components": ["Table.rowSelection"], "implementation": "src/App.vue", "applicationResponsibilities": ["controlled selectedRowKeys", "current-page select-all and indeterminate via native Table", "clear on query/page changes", "selected count"] },
+    "pagination": { "components": ["Table.pagination"], "implementation": "src/App.vue", "applicationResponsibilities": ["21 deterministic records", "page size 10", "three pages", "filtered total and actual visible records", "clear selection on page change"] },
+    "bulk": { "components": ["Button", "Alert"], "implementation": "src/useDevices.ts", "applicationResponsibilities": ["disable without selection", "update selected identities only", "persist instance data", "clear selection and report affected count"] },
+    "edit": { "components": ["Drawer", "Form", "FormItem", "Input", "Select", "Button", "Alert"], "implementation": "src/components/DeviceEditor.vue", "applicationResponsibilities": ["required non-whitespace name", "preserve input on simulated failure", "successful retry updates one identity", "keep component mounted during exit", "explicit native mask blur", "focus restoration"] },
+    "feedback": { "components": ["Table.loading", "Empty", "Alert", "Switch"], "implementation": "src/App.vue", "applicationResponsibilities": ["deterministic loading/empty/error/success controls", "retry list without data loss", "reset fixed seed", "namespace storage by instance and mock version"] }
+  }
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/generation-component-map.json

@@ -0,0 +1,300 @@
+{
+  "schemaVersion": 1,
+  "frameworkId": "vue-antdv-next",
+  "version": "1.0.0",
+  "boundary": "Native controls provide primitives. Business rules, graph behavior and persistence require application implementation and actual browser verification.",
+  "capabilities": {
+    "layout": {
+      "components": [
+        "Layout",
+        "LayoutHeader",
+        "LayoutSider",
+        "LayoutContent",
+        "Drawer"
+      ],
+      "applicationResponsibilities": [
+        "所选导航与内容布局实际呈现，区域顺序和滚动边界与固定选择一致",
+        "桌面、平板与窄屏主要内容和操作可达，不通过隐藏必需字段适配"
+      ]
+    },
+    "navigation": {
+      "components": [
+        "Menu",
+        "Breadcrumb",
+        "Button",
+        "Result"
+      ],
+      "applicationResponsibilities": [
+        "每个声明页面可达，当前项、返回、深链接及不存在页面状态正确",
+        "按固定规则检查折叠、移动菜单、返回后的筛选和页码状态"
+      ]
+    },
+    "accessibility": {
+      "components": [
+        "Form",
+        "Button",
+        "Input",
+        "Drawer"
+      ],
+      "applicationResponsibilities": [
+        "名称、标签、Tab顺序、焦点可见及主要操作键盘可达",
+        "实际文字与浮层可读；窄屏无阻断性裁剪，减少动效仍可操作"
+      ]
+    },
+    "theme": {
+      "components": [
+        "ConfigProvider",
+        "Select"
+      ],
+      "applicationResponsibilities": [
+        "明亮、暗黑、清新、科技均实际覆盖组件、浮层与外壳，默认明亮且切换保留业务状态",
+        "刷新恢复、非法偏好和拒绝存储安全回退，实例间隔离"
+      ]
+    },
+    "visual": {
+      "components": [
+        "ConfigProvider",
+        "Flex",
+        "Space"
+      ],
+      "applicationResponsibilities": [
+        "实际风格、间距密度、圆角、边框与阴影符合所选预设，未覆盖框架和客户明确要求"
+      ]
+    },
+    "interaction": {
+      "components": [
+        "Button",
+        "Form",
+        "Alert",
+        "Spin"
+      ],
+      "applicationResponsibilities": [
+        "每个声明业务操作有有效结果；不可用操作说明原因，忙碌时防止重复提交",
+        "操作失败后对象和输入保留，可按规定重试，不用提示文字冒充操作完成"
+      ]
+    },
+    "collection": {
+      "components": [
+        "Table",
+        "List"
+      ],
+      "applicationResponsibilities": [
+        "记录稳定身份、总数、可见行与行操作对象对应，不串记录",
+        "逐项检查列表工具栏和行操作，不以一个按钮代替全部操作"
+      ]
+    },
+    "filter": {
+      "components": [
+        "Form",
+        "Input",
+        "Select",
+        "TreeSelect",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "命中、无结果、重置正确；页码与选择按合同重置"
+      ]
+    },
+    "selection": {
+      "components": [
+        "Table.rowSelection",
+        "Checkbox"
+      ],
+      "applicationResponsibilities": [
+        "当前页单选、全选、半选及不可选记录正确",
+        "筛选、翻页或容量变化按约定清空选择"
+      ]
+    },
+    "pagination": {
+      "components": [
+        "Table.pagination",
+        "Pagination"
+      ],
+      "applicationResponsibilities": [
+        "默认容量覆盖首中末页，总数与实际行一致",
+        "逐一切换固定选项、恢复默认，页码及选择符合约定"
+      ]
+    },
+    "bulk": {
+      "components": [
+        "Button",
+        "Alert",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "无选择不可提交，只影响选中身份；成功范围与失败策略来自本次PRD"
+      ]
+    },
+    "feedback": {
+      "components": [
+        "Spin",
+        "Empty",
+        "Alert",
+        "Result",
+        "message"
+      ],
+      "applicationResponsibilities": [
+        "逐区域触发加载、无数据、筛选无结果、失败和恢复；不存在记录与权限限制有明确状态"
+      ]
+    },
+    "columns": {
+      "components": [
+        "Table",
+        "Checkbox",
+        "Dropdown",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "显示／隐藏、上移／下移、锁定列和恢复默认均生效",
+        "刷新恢复约定列偏好，存储失败仍可本轮操作，宽表可滚动且操作列可达"
+      ]
+    },
+    "deletion": {
+      "components": [
+        "Modal",
+        "Alert",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "核对对象身份、数量、可删除与受阻原因，取消不改变数据",
+        "失败保留选择；记录变化重新核对，结果与本次PRD的整批／部分成功策略一致"
+      ]
+    },
+    "edit": {
+      "components": [
+        "Form",
+        "FormItem",
+        "Input",
+        "Select",
+        "Drawer",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "字段类型、必填、格式、长度、联动和只读状态逐项对应需求",
+        "校验失败定位字段，提交失败保留输入，再试成功更新正确记录"
+      ]
+    },
+    "dirty": {
+      "components": [
+        "Modal",
+        "Drawer",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "关闭、返回、切页和身份变化按约定保留／确认丢弃，不静默丢失输入",
+        "需要草稿恢复时验证恢复与版本；不需要时明确丢弃策略"
+      ]
+    },
+    "dialog": {
+      "components": [
+        "Drawer",
+        "Modal"
+      ],
+      "applicationResponsibilities": [
+        "实际打开与关闭的生命周期完整，抽屉进出中间态存在，未提前卸载",
+        "遮罩、Escape、取消、背景滚动与焦点恢复符合固定呈现参数，嵌套弹层不串状态"
+      ]
+    },
+    "menu": {
+      "components": [
+        "Dropdown",
+        "Menu",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "菜单键盘开关和焦点正确，逐操作核对对象、权限与结果"
+      ]
+    },
+    "detail": {
+      "components": [
+        "Descriptions",
+        "Tabs",
+        "Timeline",
+        "Card"
+      ],
+      "applicationResponsibilities": [
+        "详情对象、分组、状态与列表对应",
+        "采用Tab／历史时切换和返回保留约定上下文，未声明的示例业务不自动移植"
+      ]
+    },
+    "hierarchy": {
+      "components": [
+        "Tree",
+        "TreeSelect",
+        "Table.expandable"
+      ],
+      "applicationResponsibilities": [
+        "逐层展开／收起，路径和节点身份稳定，无数据和不可用节点明确",
+        "父子选择策略、半选、搜索和关联列表按声明类型实测，树表展开不丢行或误选"
+      ]
+    },
+    "wizard": {
+      "components": [
+        "Steps",
+        "Form",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "每步校验，非法输入不能越过；前后切换保留正确数据",
+        "最终复核与提交对象一致，失败保留可重试，关闭和继续符合草稿策略"
+      ]
+    },
+    "canvas": {
+      "components": [
+        "Button",
+        "Tooltip",
+        "Form"
+      ],
+      "applicationResponsibilities": [
+        "节点选择与属性联动，移动和键盘操作作用于同一节点",
+        "缩放、适合画布、滚动正确，拖动坐标随缩放换算",
+        "新增删除节点与连线、连线规则及校验反馈正确",
+        "只读不能编辑，未保存保护与保存结果符合本次业务状态"
+      ]
+    },
+    "authorization": {
+      "components": [
+        "Tree",
+        "Checkbox",
+        "Button",
+        "Alert"
+      ],
+      "applicationResponsibilities": [
+        "菜单、按钮、字段的隐藏／禁用和原因符合实际PRD角色",
+        "切换范围及直达路由按模拟权限合同处理；不把前端演示称为服务端授权"
+      ]
+    },
+    "lifecycle": {
+      "components": [
+        "Tag",
+        "Steps",
+        "Timeline",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "允许操作随业务状态变化，拒绝无效转移；版本冲突和历史展示有依据"
+      ]
+    },
+    "persistence": {
+      "components": [
+        "Alert",
+        "Button"
+      ],
+      "applicationResponsibilities": [
+        "本次实例、用户、范围和页面的偏好或草稿按约定隔离",
+        "坏缓存与拒存储有恢复，不静默覆盖其他实例"
+      ]
+    },
+    "relation": {
+      "components": [
+        "Modal",
+        "Tree",
+        "Table",
+        "Input"
+      ],
+      "applicationResponsibilities": [
+        "检索、范围过滤、选择、取消和回填对象一致"
+      ]
+    }
+  }
+}

package/skills/i3-ui-prototype/assets/frameworks/vue-antdv-next/legacy-starter/index.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="color-scheme" content="light">
+    <link rel="icon" href="data:,">
+    <title>设备管理 · 原型</title>
+  </head>
+  <body><div id="app"></div><script type="module" src="/src/main.ts"></script></body>
+</html>