@givolt/i3-composer-agent 2.3.1 → 2.3.2

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/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>