create-yss-spec 3.5.3 → 3.5.4

package/template/.codex/skills/yss-prototype-stage/scripts/prototype-contract.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
 import { assertUserDecisionRequirement, decisionDigest, decisionIO } from "../../../../scripts/lib/user-decision.mjs";
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
@@ -176,7 +177,7 @@ function validateProfileV4(data, errors, allowTemplate) {
     const facts = evidence.prototype_library_facts;
     required(facts, "applicable", "profile_evidence.flow_review.prototype_library_facts", errors);
     requiredString(facts, "component_basis", "profile_evidence.flow_review.prototype_library_facts", errors);
-    if (["html-css-js", "react-antd-prebuilt"].includes(facts?.component_basis)) {
+    if (["html-css-js", "react-antd-prebuilt", "react-shadcn-prebuilt", "vue-shadcn-prebuilt"].includes(facts?.component_basis)) {
       if (implementation?.runtime_build_required !== false || implementation?.framework !== facts.component_basis || (facts.component_basis === "html-css-js" && facts.applicable !== false)) errors.push("HTML H2 必须声明无组件 Provider、无运行时构建及 html-css-js framework");
       if (data.browser_delivery?.delivery_contract !== "offline-html-v1") errors.push("HTML H2 缺少 offline-html-v1 交付证据");
       for (const field of ["scenario_replay_ref", "scenario_reset_result"]) requiredString(evidence, field, "profile_evidence.flow_review", errors);
@@ -187,18 +188,22 @@ function validateProfileV4(data, errors, allowTemplate) {
       requiredString(facts, "build_provenance_ref", "prototype_library_facts", errors);
       requiredString(implementation, "selection_reason", "prototype_implementation", errors);
     }
+    if (["react-shadcn-prebuilt", "vue-shadcn-prebuilt"].includes(facts?.component_basis)) {
+      if (facts.applicable !== true || facts.library_package !== (facts.component_basis === "vue-shadcn-prebuilt" ? "shadcn-vue" : "shadcn/ui") || (!allowTemplate && !/^[a-f0-9]{40}$/.test(facts.registry_revision ?? ""))) errors.push("shadcn 使用固定源码 revision，不能用 CLI 版本冒充组件版本");
+      requiredString(facts, "build_provenance_ref", "prototype_library_facts", errors);
+    }
     if (facts?.applicable === true) {
       for (const field of ["source", "manifest_ref", "manifest_digest", "canonical_design_digest", "project_token_baseline_digest"]) requiredString(facts, field, "profile_evidence.flow_review.prototype_library_facts", errors);
       requireArray(facts, "components_covered", "profile_evidence.flow_review.prototype_library_facts", errors, { nonEmpty: true });
       if (facts.component_basis === "react-antd-6" && facts.actual_antd_version !== undefined) {
         if (!allowTemplate && !antdSemver.test(facts.actual_antd_version ?? "")) errors.push("H2 actual_antd_version 必须是明确 antd 6.x semver");
-      } else {
+      } else if (!["react-shadcn-prebuilt", "vue-shadcn-prebuilt"].includes(facts.component_basis)) {
         for (const field of ["library_package", "library_version"]) requiredString(facts, field, "profile_evidence.flow_review.prototype_library_facts", errors);
         if (!allowTemplate && !exactSemver.test(facts.library_version ?? "")) errors.push("H2 library_version 必须是明确 semver");
         if (facts.component_basis === "vue-antdv-next" && facts.library_package !== "antdv-next") errors.push("vue-antdv-next 必须使用 antdv-next package");
         if (facts.component_basis === "react-antd-6" && (facts.library_package !== "antd" || (!allowTemplate && !antdSemver.test(facts.library_version ?? "")))) errors.push("react-antd-6 必须使用明确的 antd 6.x 版本");
       }
-      if (!["fact-pack", "cli-run"].includes(facts.source)) errors.push("H2 prototype_library_facts.source 必须为 fact-pack/cli-run");
+      if (!["fact-pack", "cli-run", ...(["react-shadcn-prebuilt", "vue-shadcn-prebuilt"].includes(facts.component_basis) ? ["source-snapshot"] : [])].includes(facts.source)) errors.push("H2 prototype_library_facts.source 必须为 fact-pack/cli-run；shadcn 使用 source-snapshot");
       if (!allowTemplate && facts.project_token_baseline_digest !== data.design_baseline.project_token_baseline_digest) errors.push("H2 fact pack 的项目 Token digest 已失效");
       if (!allowTemplate && facts.canonical_design_digest !== data.design_baseline.canonical_design_digest) errors.push("H2 fact pack 的 DESIGN.md digest 已失效");
       if (!allowTemplate && facts.new_api_uncertainty !== false) errors.push("H2 fact pack 存在新 API 疑问，必须增量查询");
@@ -222,8 +227,8 @@ export function validatePrototypeEvidence(data, { allowTemplate = false, allowLe
   }
   if (data.schema_version !== 4) return { errors: ["schema_version 必须为 4"], warnings };
   const oldBasis = data.profile_evidence?.flow_review?.prototype_library_facts?.component_basis;
-  if (["vue-antdv-next", "react-antd-6"].includes(oldBasis)) {
-    if (!allowLegacy && !allowTemplate) errors.push("Provider 已退役；旧证据仅 --allow-legacy 只读检查，在途需迁移 HTML");
+  if (["vue-antdv-next", "react-antd-6", "react-antd-prebuilt", "react-shadcn-prebuilt"].includes(oldBasis)) {
+    if (!allowLegacy && !allowTemplate) errors.push("Provider 已退役；旧证据仅 --allow-legacy 只读检查，在途需迁移 Vue 或原生 HTML");
     else warnings.push("历史 Provider 证据只读，不代表当前原型通过");
   }
   validateCommonV4(data, errors, allowTemplate);
@@ -243,16 +248,16 @@ export async function prepareStaticPrototype(options) {
 }
 
 export async function prepareFlowPrototype(options) {
-  if (options.targetAntdVersion || options.libraryVersion || options.factPackRef || (options.componentBasis && options.componentBasis !== "html-css-js")) throw new TypeError("原型 Provider 已退役；请迁移到 html-css-js 离线交付，历史原型保持只读");
+  if (options.targetAntdVersion || options.libraryVersion || options.factPackRef || (options.componentBasis && options.componentBasis !== "html-css-js")) throw new TypeError("原型 Provider 已退役；新原型使用 build-shadcn-vue-prototype 或 html-css-js 离线交付，历史原型保持只读");
   return prepareOfflineHtml({ ...options, profile: "H2" });
 }
 
 export const preparePrototype = prepareFlowPrototype;
 
-export async function validatePrototypeProject({ root, profile = "H2", componentBasis, targetAntdVersion }) {
+export async function validatePrototypeProject({ root, profile = "H2", componentBasis, targetAntdVersion, allowLegacy = false, projectRoot }) {
   if (!Object.hasOwn(PROFILE_KIND, profile)) return { errors: ["prototype_profile 必须为 H1/H2"] };
-  if (targetAntdVersion || (componentBasis && !["html-css-js", "react-antd-prebuilt"].includes(componentBasis))) return { errors: ["旧 Provider 项目不进入当前生成路线；请保留历史快照并迁移"] };
-  const result = await validateOfflineHtml(root, profile);
+  if (targetAntdVersion || (componentBasis && !["html-css-js", "vue-shadcn-prebuilt", ...(allowLegacy ? ["react-antd-prebuilt", "react-shadcn-prebuilt"] : [])].includes(componentBasis))) return { errors: ["旧 Provider 项目不进入当前生成路线；请保留历史快照并迁移"] };
+  const result = await validateOfflineHtml(root, profile, { allowLegacy, projectRoot });
   if (componentBasis && !result.errors.length) {
     const manifest = JSON.parse(await readFile(path.join(root, "yss-prototype-adapter.json"), "utf8"));
     if (manifest.component_basis !== componentBasis) result.errors.push("componentBasis 与原型 manifest 不一致");
@@ -283,11 +288,11 @@ async function main(argv) {
   const parsed = args(argv);
   const command = parsed._[0];
   if (command === "prepare-static") {
-    process.stdout.write(`${JSON.stringify(await prepareStaticPrototype({ projectRoot: parsed["project-root"], root: parsed.root, feature: parsed.feature, pattern: parsed.pattern }), null, 2)}\n`);
+    process.stdout.write(`${JSON.stringify(await prepareStaticPrototype({ projectRoot: parsed["project-root"], root: parsed.root, feature: parsed.feature, pattern: parsed.pattern, density: parsed.density, scenarios: parsed.scenarios, title: parsed.title }), null, 2)}\n`);
     return;
   }
   if (["prepare", "prepare-flow"].includes(command)) {
-    process.stdout.write(`${JSON.stringify(await prepareFlowPrototype({ projectRoot: parsed["project-root"], root: parsed.root, feature: parsed.feature, pattern: parsed.pattern, componentBasis: parsed["component-basis"], libraryVersion: parsed["library-version"], targetAntdVersion: parsed["target-antd-version"], pnpmVersion: parsed["pnpm-version"], factPackRef: parsed["fact-pack-ref"] }), null, 2)}\n`);
+    process.stdout.write(`${JSON.stringify(await prepareFlowPrototype({ projectRoot: parsed["project-root"], root: parsed.root, feature: parsed.feature, pattern: parsed.pattern, density: parsed.density, scenarios: parsed.scenarios, title: parsed.title, componentBasis: parsed["component-basis"], libraryVersion: parsed["library-version"], targetAntdVersion: parsed["target-antd-version"], pnpmVersion: parsed["pnpm-version"], factPackRef: parsed["fact-pack-ref"] }), null, 2)}\n`);
     return;
   }
   if (command === "seal-project") {
@@ -295,13 +300,13 @@ async function main(argv) {
     return;
   }
   if (command === "validate-project") {
-    const result = await validatePrototypeProject({ root: parsed.root, profile: parsed.profile ?? "H2", componentBasis: parsed["component-basis"], libraryVersion: parsed["library-version"], targetAntdVersion: parsed["target-antd-version"] });
+    const result = await validatePrototypeProject({ root: parsed.root, profile: parsed.profile ?? "H2", componentBasis: parsed["component-basis"], libraryVersion: parsed["library-version"], targetAntdVersion: parsed["target-antd-version"], allowLegacy: Boolean(parsed["allow-legacy"]), projectRoot: parsed["project-root"] });
     if (result.errors.length > 0) throw new TypeError(result.errors.join("\n"));
     process.stdout.write("prototype project contract passed\n");
     return;
   }
   if (command === "validate-evidence") {
-    const result = validatePrototypeEvidence(await loadYaml(parsed._[1]), { allowTemplate: Boolean(parsed["allow-template"]), allowLegacy: Boolean(parsed["allow-legacy"]) });
+    const result = validatePrototypeEvidence(await loadYaml(parsed._[1]), { allowTemplate: Boolean(parsed["allow-template"]), allowLegacy: Boolean(parsed["allow-legacy"]), projectRoot: parsed["project-root"] });
     if (result.errors.length > 0) throw new TypeError(result.errors.join("\n"));
     process.stdout.write(`prototype evidence passed${result.warnings.length ? ` with warnings: ${result.warnings.join(", ")}` : ""}\n`);
     return;
@@ -309,4 +314,4 @@ async function main(argv) {
   throw new TypeError("usage: prototype-contract.mjs prepare-static|prepare-flow|seal-project|validate-project|validate-evidence ...");
 }
 
-if (import.meta.url === pathToFileURL(process.argv[1]).href) main(process.argv.slice(2)).catch((error) => { process.stderr.write(`${error.message}\n`); process.exitCode = 1; });
+if (process.argv[1] && existsSync(process.argv[1]) && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) main(process.argv.slice(2)).catch((error) => { process.stderr.write(`${error.message}\n`); process.exitCode = 1; });

package/template/.codex/skills/yss-prototype-stage/scripts/scenario-contract.mjs

@@ -0,0 +1,31 @@
+import {createHash} from 'node:crypto';
+import {readFile,writeFile,lstat,mkdir} from 'node:fs/promises';
+import path from 'node:path';
+export const digest = bytes => `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+export const safeId = value => typeof value === 'string' && /^[a-z0-9][a-z0-9-]*$/.test(value);
+export async function localPath(root,ref) {
+ if(typeof ref!=='string'||!ref||/[\\?#%\x00-\x1f]/.test(ref)||path.isAbsolute(ref)||/^[a-z][\w+.-]*:/i.test(ref)||ref.split('/').some(p=>!p||p==='.'||p==='..'))throw Error(`需要包内相对路径: ${ref}`);
+ let current=path.resolve(root);
+ for(const part of [null,...ref.split('/')]){if(part)current=path.join(current,part);try{if((await lstat(current)).isSymbolicLink())throw Error(`不允许符号链接: ${ref}`);}catch(e){if(e.code!=='ENOENT')throw e;}}
+ return current;
+}
+export function parseScenarios(bytes) {
+ const doc=JSON.parse(String(bytes));
+ if(doc.schema_version!==1||!Array.isArray(doc.scenarios)||!doc.scenarios.length||!doc.scenarios.some(s=>s.id==='primary'))throw Error('场景需要 schema_version=1、scenarios 和 primary 入口');
+ const ids=new Set();
+ for(const s of doc.scenarios){
+  if(!safeId(s.id)||ids.has(s.id)||!s.label?.trim()||!s.state_ref?.trim()||!s.initial_data||typeof s.initial_data!=='object'||Array.isArray(s.initial_data))throw Error('场景 ID/来源/初始数据缺失或重复');
+  if(Object.keys(s).some(k=>!['id','label','state_ref','initial_data'].includes(k)))throw Error('场景包含未知字段');
+  ids.add(s.id);
+ }
+ return doc;
+}
+export function scenarioScript(bytes) {
+ const doc=parseScenarios(bytes);
+ const packet={...doc,digest:digest(bytes),data_digests:Object.fromEntries(doc.scenarios.map(s=>[s.id,digest(JSON.stringify(s.initial_data))]))};
+ return `window.prototypeScenarioContract = ${JSON.stringify(packet).replaceAll('<','\\u003c').replaceAll('\u2028','\\u2028').replaceAll('\u2029','\\u2029')};\nwindow.prototypeScenarios = window.prototypeScenarioContract.scenarios;\n`;
+}
+export async function writeScenarios(root,bytes) {
+ parseScenarios(bytes);await mkdir(root,{recursive:true});await writeFile(path.join(root,'scenarios.json'),bytes);await writeFile(path.join(root,'scenarios.js'),scenarioScript(bytes));
+ await writeFile(path.join(root,'scenario-runtime.js'),await readFile(new URL('../assets/scenario-runtime.js',import.meta.url)));
+}

package/template/.codex/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// One strict entrypoint for source, build and actual browser evidence.
+import {readFile,writeFile,mkdir,mkdtemp,readdir,realpath,cp} from 'node:fs/promises';
+import {existsSync,realpathSync} from 'node:fs';
+import {createHash} from 'node:crypto';
+import {spawn} from 'node:child_process';
+import path from 'node:path';
+import os from 'node:os';
+import {fileURLToPath,pathToFileURL} from 'node:url';
+const skill=fileURLToPath(new URL('../',import.meta.url));
+const repository=path.resolve(skill,'../../..');
+const sha=bytes=>'sha256:'+createHash('sha256').update(bytes).digest('hex');
+async function sourceSnapshot(){
+ const files={};
+ async function walk(target){const stat=await import('node:fs/promises').then(fs=>fs.lstat(target));if(stat.isSymbolicLink())throw Error(`来源不接受符号链接: ${target}`);if(stat.isDirectory()){for(const name of (await readdir(target)).sort())await walk(path.join(target,name));}else files[path.relative(repository,target)]=sha(await readFile(target));}
+ for(const target of [skill,path.resolve(skill,'../yss-design-system'),path.resolve(skill,'../prototype-review'),...['DESIGN.md','.template-spec','scripts/lib','scripts/vendor'].map(ref=>path.join(repository,ref))])await walk(target);
+ // Optional aliases are not inputs to the canonical entry. Bind their absence too.
+ for(const ref of ['scripts/verify-prototype-design','scripts/verify-yss-prototype-contract-scenarios']){const target=path.join(repository,ref);if(existsSync(target))await walk(target);else files[ref]=null;}
+ return {digest:sha(JSON.stringify(files)),files};
+}
+export async function verifyPrototypeDesign({scope='all',toolchain=process.env.YSS_VUE_TOOLCHAIN,browserTools=process.env.YSS_PLAYWRIGHT_MODULE,output}={}){
+ if(!['contract','browser','all'].includes(scope))throw Error('scope 必须为 contract、browser 或 all');
+ output=output?path.resolve(output):await mkdtemp(path.join(os.tmpdir(),'yss-prototype-design-'));
+ await mkdir(output,{recursive:true});output=await realpath(output);
+ const sourceRoot=await realpath(repository);if(output===sourceRoot||output.startsWith(sourceRoot+path.sep))throw Error('验证输出必须在仓库外');
+ if((await readdir(output)).length)throw Error('验证输出非空，拒绝覆盖历史证据');
+ const report={schema_version:1,scope,status:'running',started_at:new Date().toISOString(),output,source:null,tools:{node:process.version},checks:[],counts:{passed:0,failed:0,'not-executed':0,'not-applicable':0},limitations:['自动化结果不构成人工视觉批准、读屏结论或真实用户效果。']};
+ const env={...process.env,TMPDIR:output,YSS_PROTOTYPE_EVIDENCE_DIR:output};
+ const add=(id,status,reason,extra={})=>report.checks.push({id,status,...(reason?{reason}:{}),...extra});
+ async function run(id,args){
+  const log=path.join(output,id+'.log'),command=[process.execPath,...args];
+  const started=Date.now();let bytes='';
+  const exitCode=await new Promise(resolve=>{const p=spawn(command[0],command.slice(1),{cwd:repository,env,stdio:['ignore','pipe','pipe']});for(const stream of [p.stdout,p.stderr])stream.on('data',d=>{bytes+=d;});p.on('error',e=>{bytes+=e.stack;resolve(-1);});p.on('close',code=>resolve(code??-1));});
+  await writeFile(log,bytes);const skips=Number([...bytes.matchAll(/^# skipped (\d+)/gm)].reduce((n,m)=>n+Number(m[1]),0));
+  const reports=bytes.split('\n').filter(line=>line.startsWith(output+path.sep)&&line.endsWith('.json'));
+  const assertions=Object.fromEntries(['tests','pass','fail','skipped','cancelled'].map(key=>[key,[...bytes.matchAll(new RegExp('^# '+key+' (\\d+)','gm'))].reduce((n,m)=>n+Number(m[1]),0)]));
+  const details=[];let evidenceError='';
+  for(const file of reports){try{const item=JSON.parse(await readFile(file));const cases=item.cases||item.rows||item.results;details.push({report:file,status:item.status||item.result,count:Array.isArray(cases)?cases.length:0});}catch(e){evidenceError=e.message;}}
+  if(['contracts','vue-workspace'].includes(id)&&!assertions.tests)evidenceError='所选合同检查没有测试计数';
+  if(!['contracts','vue-workspace','build-browser-fixtures'].includes(id)&&(!details.length||details.some(d=>d.status!=='passed'||!d.count)))evidenceError='所选浏览器检查缺少已执行且通过的场景报告';
+  const passed=exitCode===0&&skips===0&&!evidenceError;
+  add(id,passed?'passed':'failed',evidenceError|| (skips?`所选检查跳过 ${skips} 项`:exitCode?`进程退出 ${exitCode}`:null),{command,exit_code:exitCode,elapsed_ms:Date.now()-started,log,reports,details,assertions,skipped:skips});
+  process.stdout.write(`${id}: ${passed?'passed':'failed'} (${log})\n`);return passed;
+ }
+ try{
+  report.source=await sourceSnapshot();
+  let authorReady=false,browserReady=false;
+  try{
+   if(!toolchain)throw Error('缺少作者工具目录：--toolchain 或 YSS_VUE_TOOLCHAIN');
+   toolchain=await realpath(toolchain);env.YSS_VUE_TOOLCHAIN=toolchain;
+   const pkg=JSON.parse(await readFile(path.join(skill,'assets/shadcn-vue-authoring/package.json')));
+   const lock=await readFile(path.join(skill,'assets/shadcn-vue-authoring/pnpm-lock.yaml'));
+   if(sha(lock)!==sha(await readFile(path.join(toolchain,'pnpm-lock.yaml'))))throw Error('作者工具锁文件不符');
+   const versions={};for(const [name,version]of Object.entries({...pkg.dependencies,...pkg.devDependencies})){const actual=JSON.parse(await readFile(path.join(toolchain,'node_modules',name,'package.json'))).version;if(actual!==version)throw Error(`${name} 版本不符：${actual} != ${version}`);versions[name]=actual;}
+   report.tools.author={directory:toolchain,lock_digest:sha(lock),versions};authorReady=true;add('author-preflight','passed');
+  }catch(error){add('author-preflight','failed',error.message);}
+  if(scope!=='contract'){
+   try{
+    if(!browserTools)throw Error('缺少浏览器工具目录：--browser-tools 或 YSS_PLAYWRIGHT_MODULE');
+    let module=path.resolve(browserTools);if(!/\.[cm]?js$/.test(module))module=path.join(module,'index.mjs');
+    const pw=await import(pathToFileURL(module).href);const versions={};
+    for(const name of ['chromium','webkit']){const b=await pw[name].launch();versions[name]=b.version();await b.close();}
+    env.YSS_PLAYWRIGHT_MODULE=module;report.tools.browser={module,playwright:JSON.parse(await readFile(path.join(path.dirname(module),'package.json'))).version,versions};browserReady=true;add('browser-preflight','passed');
+   }catch(error){add('browser-preflight','failed',error.message);}
+  }
+  const tests=path.join(skill,'tests');
+  if(scope!=='browser'){
+   if(authorReady){
+    await run('contracts',['--test-reporter=tap',path.join(tests,'run-scenarios.mjs')]);
+    await run('vue-workspace',['--test','--test-reporter=tap',path.join(tests,'shadcn-vue.test.mjs'),path.join(tests,'workspace.test.mjs'),path.join(tests,'retirement.test.mjs'),path.join(tests,'business-controls.test.mjs'),path.join(tests,'verification-entry.test.mjs')]);
+   }else for(const id of ['contracts','vue-workspace'])add(id,'not-executed','作者工具前置检查未通过');
+  }
+  if(scope!=='contract'){
+   if(authorReady&&browserReady){
+    const bundle=path.join(output,'patterns'),portable=path.join(output,'independent-copy');
+    if(await run('build-browser-fixtures',[path.join(skill,'scripts/export-vue-patterns.mjs'),'--project-root',repository,'--output',bundle,'--toolchain',toolchain])){
+     await cp(bundle,portable,{recursive:true});
+     const packageFiles={};async function walk(dir){for(const entry of (await readdir(dir,{withFileTypes:true})).sort((a,b)=>a.name.localeCompare(b.name))){const p=path.join(dir,entry.name);if(entry.isDirectory())await walk(p);else packageFiles[path.relative(portable,p)]=sha(await readFile(p));}}await walk(portable);
+     report.package={directory:portable,digest:sha(JSON.stringify(packageFiles)),files:packageFiles};
+     for(const name of ['patterns-browser','components-browser','compact-theme-browser','workspace-browser','business-controls-browser','zoom-browser'])await run(name,[path.join(tests,name+'.mjs'),portable]);
+     for(const name of ['workbench-smoke','comparison-browser-smoke'])await run(name,[path.join(tests,name+'.mjs')]);
+    }else add('browser-scenarios','not-executed','浏览器样例构建失败');
+   }else add('browser-scenarios','not-executed','作者工具或浏览器前置检查未通过');
+  }
+  const after=await sourceSnapshot();report.source_after_digest=after.digest;add('input-drift',after.digest===report.source.digest?'passed':'failed',after.digest===report.source.digest?null:'验证期间输入发生漂移，请固定输入重新运行');
+ }catch(error){add('runner','failed',error.stack);}
+ for(const check of report.checks)report.counts[check.status]++;
+ report.status=report.counts.failed||report.counts['not-executed']?'failed':'passed';report.finished_at=new Date().toISOString();
+ await writeFile(path.join(output,'report.json'),JSON.stringify(report,null,2)+'\n');
+ process.stdout.write(path.join(output,'report.json')+'\n');return report;
+}
+export async function main(argv=process.argv.slice(2)){
+ const options={};const keys={'--scope':'scope','--toolchain':'toolchain','--browser-tools':'browserTools','--output':'output'};
+ for(let i=0;i<argv.length;i+=2){if(argv[i]==='--help'){console.log('verify-prototype-design --scope contract|browser|all --toolchain DIR --browser-tools PLAYWRIGHT_DIR --output OUTSIDE_REPOSITORY');return;}if(!keys[argv[i]]||!argv[i+1]||argv[i+1].startsWith('--'))throw Error(`非法参数 ${argv[i]}`);options[keys[argv[i]]]=argv[i+1];}
+ const result=await verifyPrototypeDesign(options);if(result.status!=='passed')process.exitCode=1;
+}
+if(process.argv[1]&&existsSync(process.argv[1])&&import.meta.url===pathToFileURL(realpathSync(process.argv[1])).href)await main();

package/template/.codex/skills/yss-prototype-stage/tests/antd-reference.test.mjs

@@ -1,24 +1,4 @@
-import {test} from 'node:test';
-import assert from 'node:assert/strict';
-import {mkdtempSync,mkdirSync,writeFileSync,existsSync,rmSync} from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import {collectAntdReference} from '../scripts/collect-antd-reference.mjs';
-test('reference collection distinguishes exact evidence from minor fallback and refuses fabricated coverage',()=>{
- const temp=mkdtempSync(path.join(os.tmpdir(),'antd-metadata-contract-'));
- try{
-  const pkg=path.join(temp,'node_modules/@ant-design/cli');mkdirSync(path.join(pkg,'data'),{recursive:true});
-  writeFileSync(path.join(pkg,'package.json'),JSON.stringify({name:'@ant-design/cli',version:'6.6.4'}));
-  writeFileSync(path.join(pkg,'data/versions.json'),JSON.stringify({v6:{'6.6':'6.6.4'}}));
-  writeFileSync(path.join(pkg,'data/v6.6.4.json'),JSON.stringify({version:'6.6.4',components:[{name:'Button',props:[{name:'disabled'}]}]}));
-  const run=(version,name,components=['Button'])=>collectAntdReference({toolchain:temp,version,output:path.join(temp,name),components});
-  assert.equal(run('6.6.4','exact').version_match,'exact');
-  assert.equal(run('6.6.3','fallback').version_match,'minor-snapshot-only');
-  assert.throws(()=>run('6.5.0','unavailable'),/未收录该 minor/);
-  assert.throws(()=>run('6.6.4','util',['Util']),/不可补造 API/);
-  assert.equal(existsSync(path.join(temp,'util')),false);
-  assert.throws(()=>run('6.6.4','exact'),/输出已存在/);
-  writeFileSync(path.join(pkg,'data/v6.6.4.json'),JSON.stringify({version:'6.6.3',components:[]}));
-  assert.throws(()=>run('6.6.4','drift'),/版本不一致/);
- }finally{rmSync(temp,{recursive:true,force:true});}
-});
+// Compatibility entry: same strict implementation, including mandatory Vue builds.
+import {verifyPrototypeDesign} from '../scripts/verify-prototype-design.mjs';
+const report=await verifyPrototypeDesign({scope:'contract'});
+if(report.status!=='passed')throw Error('原型验证未通过: '+report.output+'/report.json');

package/template/.codex/skills/yss-prototype-stage/tests/browser-harness.mjs

@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import {mkdtemp,writeFile,readFile} from 'node:fs/promises';
+import path from 'node:path';import os from 'node:os';import {pathToFileURL} from 'node:url';import {createHash} from 'node:crypto';
+import {visual} from './browser-visual.mjs';
+export const bundle=path.resolve(process.argv[2]||'.');
+export const entry=(mode,scene='primary',page='')=>pathToFileURL(path.join(bundle,mode,'index.html')).href+(page?'?page='+page:'')+'#scenario='+scene;
+export async function reset(page){const panel=page.locator('.prototype-review-panel details');if(!await page.locator('#reset').isVisible())await page.locator('summary').click();await page.locator('#reset').click();}
+export async function layout(page){
+ await visual(page);
+ for(const popover of await page.locator('[data-slot="popover-content"],[data-slot="combobox-list"]').all())assert(await popover.evaluate(e=>e.scrollWidth<=e.clientWidth+1),'overlay content must reflow, not hide a horizontal overflow');
+ assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth>innerWidth+1),false,'page reflow');
+ const sizes=await page.evaluate(()=>[...document.querySelectorAll('button,input:not([type=hidden]),select,textarea,[role=option]')].filter(e=>e.checkVisibility()&&!e.closest('[inert]')&&!e.matches(':disabled,[data-disabled],[aria-disabled=true]')).map(e=>{const hit=e.matches('input[type=checkbox]')&&e.labels?.length?e.labels[0]:e;const r=hit.getBoundingClientRect();if(e.getAttribute('data-slot')==='checkbox'){const p=getComputedStyle(e,'::after');r.width-=parseFloat(p.left)+parseFloat(p.right);r.height-=parseFloat(p.top)+parseFloat(p.bottom)}return {label:e.getAttribute('aria-label')||e.id||e.textContent?.slice(0,30),width:r.width,height:r.height}}).filter(r=>r.width&&r.height&&(r.width<24||r.height<24)));
+ assert.deepEqual(sizes,[],'visible controls have at least 24 CSS px targets');
+}
+export async function keyboardReach(page,selector){
+ await page.locator('main').focus();for(let i=0;i<100;i++){await page.keyboard.press('Tab');if(await page.locator(selector).evaluate(e=>e===document.activeElement)){const r=await page.locator(selector).boundingBox();assert(r&&r.y>=0&&r.y+r.height<=await page.evaluate(()=>innerHeight),'focused action is not clipped');assert(await page.locator(selector).evaluate(e=>{const r=e.getBoundingClientRect();return e.contains(document.elementFromPoint(r.x+r.width/2,r.y+r.height/2));}),'focused action is not obscured');return;}}
+ throw Error('Tab 无法到达 '+selector);
+}
+export async function browserHarness(name,exercise,{timezones=['Asia/Shanghai']}={}){
+ const {chromium,webkit}=await import(process.env.YSS_PLAYWRIGHT_MODULE||'playwright');
+ const output=await mkdtemp(path.join(os.tmpdir(),`yss-${name}-`)),report={status:'running',output,package_root:bundle,package_manifests:{},cases:[],errors:[],screenshots:[],limitations:['维护者自动操作；不代表读屏结果或真实用户观察。首次截图待审，不与自身比较。']};
+ for(const mode of ['workspace','combined-query','owner-validity']){const file=path.join(bundle,mode,'yss-prototype-adapter.json');report.package_manifests[mode]='sha256:'+createHash('sha256').update(await readFile(file)).digest('hex');}
+ for(const [engine,type]of [['chromium',chromium],['webkit',webkit]]){
+  const browser=await type.launch();try{for(const width of engine==='chromium'?[1440,1024,390,320]:[1440,390])for(const timezoneId of timezones){
+   const context=await browser.newContext({viewport:{width,height:900},locale:'zh-CN',timezoneId,reducedMotion:'reduce',offline:engine==='chromium'});
+   if(engine==='webkit')await context.route(/^https?:/,r=>r.abort('internetdisconnected'));
+   const page=await context.newPage();page.setDefaultTimeout(8000);const runtime=[];
+   page.on('pageerror',e=>runtime.push(e.message));page.on('console',m=>{if(['error','warning'].includes(m.type()))runtime.push(m.text());});page.on('requestfailed',r=>runtime.push(r.url()));page.on('request',r=>{if(/^https?:/.test(r.url()))runtime.push('unexpected network '+r.url());});
+   async function capture(id){const screenshot=path.join(output,`${engine}-${width}-${timezoneId.replaceAll('/','_')}-${id}.png`);await page.screenshot({path:screenshot,animations:'disabled'});report.screenshots.push(screenshot);return screenshot;}
+   async function check(id,fn){const row={id,engine,version:browser.version(),width,timezoneId,status:'running'};try{await fn();row.status='passed';}catch(e){row.status='failed';row.error=e.stack;row.screenshot=await capture(id+'-failed');}report.cases.push(row);await writeFile(path.join(output,'result.json'),JSON.stringify(report,null,2));}
+   try{await exercise({page,width,engine,check,capture});}catch(e){report.errors.push(e.stack);await capture('unhandled');}
+   if(runtime.length)report.errors.push({engine,width,runtime});await context.close();
+  }}finally{await browser.close();}
+ }
+ report.status=report.errors.length||report.cases.some(c=>c.status!=='passed')?'failed':'passed';report.counts={passed:report.cases.filter(c=>c.status==='passed').length,failed:report.cases.filter(c=>c.status==='failed').length};
+ await writeFile(path.join(output,'result.json'),JSON.stringify(report,null,2));console.log(path.join(output,'result.json'));assert.equal(report.status,'passed',`${name} browser checks failed; inspect report`);
+}

package/template/.codex/skills/yss-prototype-stage/tests/browser-visual.mjs

@@ -0,0 +1,22 @@
+import assert from 'node:assert/strict';
+export async function visual(page){
+ assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth>innerWidth),false,'page overflow');
+ const violations=await page.evaluate(()=>{
+  const cv=document.createElement('canvas'),ctx=cv.getContext('2d',{willReadFrequently:true});
+  const rgba=c=>{ctx.clearRect(0,0,1,1);ctx.fillStyle=c;ctx.fillRect(0,0,1,1);const a=[...ctx.getImageData(0,0,1,1).data];return [...a.slice(0,3),a[3]/255];};
+  const blend=(a,b)=>a.slice(0,3).map((x,i)=>x*a[3]+b[i]*(1-a[3]));
+  const lum=c=>c.map(x=>{x/=255;return x<=.04045?x/12.92:((x+.055)/1.055)**2.4;}).reduce((s,v,i)=>s+v*[.2126,.7152,.0722][i],0),bad=[];
+  for(const el of document.querySelectorAll('body *')){
+   if(![...el.childNodes].some(n=>n.nodeType===3&&n.textContent.trim()))continue;
+   const s=getComputedStyle(el),r=el.getBoundingClientRect();
+   if(!r.width||!r.height||s.visibility==='hidden'||el.closest('[hidden],[inert],:disabled,[aria-disabled="true"],[data-disabled],.sr-only')||s.clip!=='auto')continue;
+   if(el.tagName==='SCRIPT'||el.tagName==='STYLE')continue;
+   const chain=[];for(let p=el;p;p=p.parentElement)chain.unshift(p);let bg=[255,255,255];for(const p of chain)bg=blend(rgba(getComputedStyle(p).backgroundColor),bg);
+   const l=[lum(blend(rgba(s.color),bg)),lum(bg)].sort((a,b)=>b-a),ratio=(l[0]+.05)/(l[1]+.05),large=parseFloat(s.fontSize)>=24||(parseFloat(s.fontSize)>=18.666&&+s.fontWeight>=700);
+   if(ratio<(large?3:4.5))bad.push({text:el.textContent.slice(0,45),ratio,color:s.color});
+  }return bad;
+ });assert.deepEqual(violations,[],'computed contrast');
+ assert.deepEqual(await page.evaluate(()=>[...document.querySelectorAll('*')].filter(el=>{const s=getComputedStyle(el);return s.animationName!=='none'||s.transitionDuration.split(',').some(x=>parseFloat(x)>0);}).map(e=>e.tagName)),[],'computed reduced motion');
+ const undersized=await page.evaluate(()=>[...document.querySelectorAll('button,a[href],[role="menuitem"],[role="checkbox"],input:not([type="hidden"]),select,textarea')].filter(el=>{const target=el.matches('input[type=checkbox]')&&el.labels?.length?el.labels[0]:el;const r=target.getBoundingClientRect();return el.checkVisibility()&&r.width&&r.height&&!el.closest('[inert]')&&!el.matches(':disabled,[data-disabled],[aria-disabled="true"]')&&(r.width<24||r.height<24)&&el.getAttribute('data-slot')!=='checkbox';}).map(el=>({tag:el.tagName,name:el.textContent?.slice(0,30),rect:el.getBoundingClientRect().toJSON()})));
+ assert.deepEqual(undersized,[],'actual target bounds (checkbox extended hit area checked separately)');
+}

package/template/.codex/skills/yss-prototype-stage/tests/business-controls-browser.mjs

@@ -0,0 +1,43 @@
+import assert from 'node:assert/strict';
+import {browserHarness,entry,layout,keyboardReach,reset} from './browser-harness.mjs';
+await browserHarness('business-controls',async({page,check,capture})=>{
+ const go=async(mode='combined-query',scene='primary')=>{await page.goto('about:blank');await page.goto(entry(mode,scene));};
+ const select=async(id,term,choice)=>{await page.locator('#'+id).fill(term);await page.getByRole('option',{name:choice,exact:true}).click();};
+ const editDates=async(id,start,end)=>{await page.locator('#'+id).click();await page.locator('#'+id+'-start').fill(start);await page.locator('#'+id+'-end').fill(end);};
+ await check('S01-name-id-keyboard-ime-cancel',async()=>{
+  await go();const input=page.locator('#query-owner');await input.fill('张明');assert.equal(await page.locator('[data-slot=combobox-list]').getByRole('option').count(),2);
+  await input.dispatchEvent('compositionstart');await page.keyboard.press('ArrowDown');await page.keyboard.press('Enter');assert.equal(await page.locator('#query-owner-selected').textContent(),'未选择');await input.dispatchEvent('compositionend');
+  await page.keyboard.press('ArrowDown');await page.keyboard.press('Enter');assert.match(await page.locator('#query-owner-selected').textContent(),/U-00[12]/);
+  const selected=await page.locator('#query-owner-selected').textContent();await input.fill('李华');await page.keyboard.press('Escape');assert.equal(await page.locator('#query-owner-selected').textContent(),selected);
+  await select('query-owner','u-002','张明 · U-002');await page.getByRole('button',{name:'应用查询',exact:true}).click();assert.match(await page.locator('#applied-query').textContent(),/U-002.*共 1 条/);
+  await input.fill('不存在');await page.getByText('无匹配选项，请更换名称或编号。',{exact:true}).waitFor();await page.keyboard.press('Escape');await page.getByRole('button',{name:'清空负责人',exact:true}).click();assert.equal(await page.locator('#query-owner-selected').textContent(),'未选择');await layout(page);
+ });
+ await check('S02-load-retry-disabled-invalid',async()=>{
+  await go('combined-query','failure');await page.locator('#query-owner').fill('U-002');await page.getByRole('button',{name:'重试加载',exact:true}).click();assert.equal(await page.locator('#query-owner').inputValue(),'U-002');assert.match(await page.locator('#query-owner-selected').textContent(),/U-001/);await page.getByRole('option',{name:'张明 · U-002',exact:true}).click();
+  await go('combined-query','loading');await page.locator('#query-owner').fill('张');await page.getByText('正在加载选项（固定评审状态）',{exact:true}).waitFor();assert.equal(await page.locator('[data-slot=combobox-list]').getByRole('option').count(),0);await page.keyboard.press('Escape');
+  await go('combined-query','no-permission');assert(await page.locator('#query-owner').isDisabled());assert(await page.locator('#query-range').isDisabled());
+  await go('combined-query','invalid-value');await page.getByRole('button',{name:'应用查询',exact:true}).click();assert.equal(await page.evaluate(()=>document.activeElement.id),'query-owner');await page.keyboard.press('Escape');
+  await go();await page.locator('#query-owner').fill('U-004');assert.equal(await page.locator('[data-slot=combobox-list]').getByRole('option').getAttribute('data-disabled'),'');await page.keyboard.press('Enter');assert.equal(await page.locator('#query-owner-selected').textContent(),'未选择');await page.keyboard.press('Escape');
+ });
+ await check('D01-validation-leap-same-day-inclusive',async()=>{
+  await go();await editDates('query-range','2024-02-29','');await page.getByRole('button',{name:'应用日期',exact:true}).click();assert.equal(await page.evaluate(()=>document.activeElement.id),'query-range-end');assert.equal(await page.locator('#query-range-summary').textContent(),'不限日期');
+  await page.locator('#query-range-end').fill('2024-02-28');await page.getByRole('button',{name:'应用日期',exact:true}).click();assert.equal(await page.evaluate(()=>document.activeElement.id),'query-range-start');
+  await page.locator('#query-range-end').fill('2024-02-29');await page.getByRole('button',{name:'应用日期',exact:true}).click();assert.equal(await page.locator('#query-range-summary').textContent(),'2024-02-29 至 2024-02-29');await page.getByRole('button',{name:'应用查询',exact:true}).click();assert.match(await page.locator('#applied-query').textContent(),/共 1 条/);
+  await editDates('query-range','2023-12-31','2025-01-01');await page.getByRole('button',{name:'应用日期',exact:true}).click();await page.getByRole('button',{name:'应用查询',exact:true}).click();assert.match(await page.locator('#applied-query').textContent(),/共 3 条/);
+ });
+ await check('D02-cancel-escape-clear-focus-calendar',async()=>{
+  await go();await editDates('query-range','2024-02-29','2024-03-01');await page.getByRole('button',{name:'取消',exact:true}).click();assert.equal(await page.locator('#query-range-summary').textContent(),'不限日期');await page.waitForFunction(()=>document.activeElement.id==='query-range');
+  await editDates('query-range','2024-12-31','2025-01-01');await page.keyboard.press('Escape');await page.waitForFunction(()=>document.activeElement.id==='query-range');assert.equal(await page.locator('#query-range-summary').textContent(),'不限日期');
+  await page.locator('#query-range').click();const day=page.locator('[data-slot="range-calendar-trigger"]').filter({hasText:/^15$/});await day.click();await page.getByRole('button',{name:'应用日期',exact:true}).click();await page.getByRole('alert').filter({hasText:'请填写截止日期'}).waitFor();
+  await day.click();await page.getByRole('button',{name:'应用日期',exact:true}).click();assert.equal(await page.locator('#query-range-summary').textContent(),'2024-02-15 至 2024-02-15');
+  await page.locator('#query-range').click();await page.getByRole('button',{name:'清空临时日期',exact:true}).click();assert.equal(await page.locator('#query-range-summary').textContent(),'2024-02-15 至 2024-02-15');await page.getByRole('button',{name:'应用日期',exact:true}).click();assert.equal(await page.locator('#query-range-summary').textContent(),'不限日期');
+ });
+ await check('F01-form-text-not-value-save-retry',async()=>{
+  await go('owner-validity');await page.locator('#validity-name').fill('维护示例');await page.locator('#form-owner').fill('张明');await page.keyboard.press('Escape');await page.getByRole('button',{name:'保存资料',exact:true}).click();assert.equal(await page.evaluate(()=>document.activeElement.id),'form-owner');
+  await go('owner-validity','failure');await page.locator('#validity-name').fill('维护示例');await editDates('form-range','2024-02-29','2025-01-01');await page.getByRole('button',{name:'应用日期',exact:true}).click();await page.getByRole('button',{name:'保存资料',exact:true}).click();await page.getByRole('alert').filter({hasText:'保存失败'}).waitFor();assert.match(await page.locator('#form-owner-selected').textContent(),/U-001/);assert.equal(await page.locator('#form-range-summary').textContent(),'2024-02-29 至 2025-01-01');await page.getByRole('button',{name:'重试保存',exact:true}).click();await page.getByText(/保存成功（本地模拟）：U-001/).waitFor();
+ });
+ await check('A01-reflow-keyboard-overlay-reset',async()=>{
+  await go();await layout(page);await keyboardReach(page,'#query-owner');await keyboardReach(page,'#query-range');await page.keyboard.press('Enter');await layout(page);await capture('date-popover');await page.keyboard.press('Escape');await capture('query');
+  await reset(page);await reset(page);assert.equal(await page.locator('#query-owner-selected').textContent(),'未选择');assert.equal(await page.locator('[data-slot="popover-content"]').count(),0);await layout(page);
+ });
+});

package/template/.codex/skills/yss-prototype-stage/tests/business-controls.test.mjs

@@ -0,0 +1,20 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {execFileSync} from 'node:child_process';
+import {validDate,rangeError,inRange,filterOptions,selectedOption} from '../assets/vue-business-patterns/business-controls.js';
+test('date-only ranges reject incomplete, invalid and reversed values; include both ends',()=>{
+ for(const date of ['2024-02-29','2000-02-29','2024-12-31','0001-01-01'])assert(validDate(date));
+ for(const date of ['1900-02-29','2023-02-29','2024-04-31','2024-00-12','0000-01-01','2024-2-01','2024-01-01T00:00:00Z'])assert(!validDate(date));
+ assert.equal(rangeError({start:'',end:''}),null);assert.equal(rangeError({start:'2024-02-29',end:''}).field,'end');assert.equal(rangeError({start:'',end:'2024-03-01'}).field,'start');
+ assert.equal(rangeError({start:'2024-03-01',end:'2024-02-29'}).field,'start');
+ for(const range of [{start:'2024-02-29',end:'2024-02-29'},{start:'2023-12-31',end:'2024-03-01'}]){assert.equal(rangeError(range),null);assert(inRange(range.start,range));assert(inRange(range.end,range));assert(!inRange('2024-03-02',range));}
+});
+test('search binds stable IDs and distinguishes equal names from text',()=>{
+ const options=[{id:'U-001',name:'张明'},{id:'U-002',name:'张明'},{id:'U-003',name:'李华'}];
+ assert.equal(filterOptions(options,'张明').length,2);assert.equal(filterOptions(options,'u-002')[0].id,'U-002');assert.equal(filterOptions(options,'不存在').length,0);
+ assert.equal(selectedOption(options,'张明'),null);assert.equal(selectedOption(options,'missing'),null);assert.equal(selectedOption(options,'U-002').id,'U-002');
+});
+test('date semantics stay identical across system timezones',()=>{
+ const script=`import {rangeError,inRange} from ${JSON.stringify(new URL('../assets/vue-business-patterns/business-controls.js',import.meta.url).href)};console.log(JSON.stringify([rangeError({start:'2024-02-29',end:'2025-01-01'}),inRange('2024-12-31',{start:'2024-02-29',end:'2025-01-01'})]));`;
+ const results=['Asia/Shanghai','America/Los_Angeles','Pacific/Kiritimati'].map(TZ=>execFileSync(process.execPath,['--input-type=module','-e',script],{env:{...process.env,TZ},encoding:'utf8'}));assert.equal(new Set(results).size,1);assert.equal(results[0].trim(),'[null,true]');
+});

package/template/.codex/skills/yss-prototype-stage/tests/compact-theme-browser.mjs

@@ -0,0 +1,53 @@
+// Maintainer check against the normative source, not a visual approval.
+import assert from 'node:assert/strict';
+import {readFile,writeFile,mkdtemp} from 'node:fs/promises';
+import path from 'node:path';import os from 'node:os';import {pathToFileURL} from 'node:url';
+import {parseDocument} from '../../../../scripts/vendor/yaml.mjs';
+import {buildShadcnVuePrototype} from '../scripts/build-shadcn-vue-prototype.mjs';
+const {chromium}=await import(process.env.YSS_PLAYWRIGHT_MODULE||'playwright');
+const projectRoot=new URL('../../../../',import.meta.url).pathname,patterns=path.resolve(process.argv[2]);
+const source=await readFile(path.join(projectRoot,'DESIGN.md'),'utf8'),spec=parseDocument(source.slice(4,source.indexOf('\n---',4))).toJS();
+const output=await mkdtemp(path.join(os.tmpdir(),'yss-compact-theme-check-')),browser=await chromium.launch(),report={result:'passed',source:'DESIGN.md',cases:[],artifacts:output};
+const resolve=v=>v.replace(/\{(\w+)\.([\w-]+)\}/g,(_,g,k)=>spec[g][k]);
+try{
+ const context=await browser.newContext({offline:true}),page=await context.newPage();
+ for(const width of [1440,390]){
+  await page.setViewportSize({width,height:width===390?844:900});
+  for(const mode of ['list-detail','multi-step','approval','conflict','analysis']){
+   await page.goto(pathToFileURL(path.join(patterns,mode,'index.html')).href);await page.locator('h1').waitFor();
+   const actual=await page.evaluate(()=>{
+    const get=(selector,property)=>getComputedStyle(document.querySelector(selector))[property];
+    const button=document.querySelector('[data-slot="button"]');
+    return {density:document.documentElement.dataset.density,body:get('body','fontSize'),h1:get('h1','fontSize'),headingLine:get('h1','lineHeight'),control:button.getBoundingClientRect().height,surface:get(document.querySelector('.form-body')?'.form-body':'.surface','paddingTop'),radius:get('.surface','borderTopLeftRadius')};
+   });
+   assert.equal(actual.density,'compact');assert.equal(actual.body,spec.typography.body.fontSize);assert.equal(actual.h1,spec.typography[spec.components['workspace-title'].typography.match(/typography\.([^}]+)/)[1]].fontSize);
+   assert(Math.abs(parseFloat(actual.headingLine)-parseFloat(spec.typography[spec.components['workspace-title'].typography.match(/typography\.([^}]+)/)[1]].fontSize)*Number(spec.typography[spec.components['workspace-title'].typography.match(/typography\.([^}]+)/)[1]].lineHeight))<.02);
+   assert.equal(actual.control,parseFloat(spec.components[width===390?'button-primary':'button-compact'].height));
+   assert.equal(actual.surface,width===390?spec.spacing.sm:resolve(spec.components['card-compact'].padding));assert.equal(actual.radius,spec.rounded.lg);
+   report.cases.push({mode,width,actual,result:'passed'});
+  }
+  await page.goto(pathToFileURL(path.join(patterns,'list-detail/index.html')).href);await page.getByRole('checkbox',{name:'选择 M-001',exact:true}).click();
+  const row=page.locator('tr[data-state="selected"]');assert.equal(await row.count(),1);
+  async function color(locator,property,value){const expected=await page.evaluate(({p,v})=>{const el=document.createElement('i');el.style[p]=v;document.body.append(el);const result=getComputedStyle(el)[p];el.remove();return result;},{p:property,v:value});await locator.evaluate((el,{property,expected})=>new Promise((resolve,reject)=>{const started=performance.now();function check(){if(getComputedStyle(el)[property]===expected)return resolve();if(performance.now()-started>1000)return reject(Error(`${property}: ${getComputedStyle(el)[property]} != ${expected}`));requestAnimationFrame(check);}check();}),{property,expected});}
+  await color(row,'backgroundColor',spec.colors['primary-bg']);
+  await page.getByRole('button',{name:'查看 M-001',exact:true}).click();const dialog=width>=1200?page.locator('.inline-detail'):page.getByRole('dialog');
+  if(width<1200){assert.equal(await dialog.evaluate(el=>getComputedStyle(el).paddingTop),'0px');assert.equal(await page.locator('[data-slot=sheet-header]').evaluate(el=>getComputedStyle(el).paddingTop),spec.spacing.lg);assert.equal(await dialog.locator('dl').evaluate(el=>getComputedStyle(el).paddingTop),spec.spacing.md);await page.keyboard.press('Escape');}else{assert.equal(await dialog.evaluate(e=>e.getBoundingClientRect().width),384);await page.getByRole('button',{name:'关闭详情',exact:true}).click();}
+  await page.goto(pathToFileURL(path.join(patterns,'multi-step/index.html')).href);const next=page.getByRole('button',{name:'下一步',exact:true});
+  await next.hover();await page.waitForTimeout(150);await color(next,'backgroundColor',spec.colors['primary-control-hover']);
+  await page.mouse.down();await page.waitForTimeout(150);await color(next,'backgroundColor',spec.colors['primary-active']);await page.mouse.up();
+  assert.equal(await page.evaluate(()=>document.activeElement.id),'name');
+  await color(page.locator('[data-slot="input-group"]'),'borderTopColor','var(--brand-color-error-active)');
+  await page.locator('#name').focus();const focus=await page.locator('[data-slot="input-group"]').evaluate(el=>({style:getComputedStyle(el).outlineStyle,width:getComputedStyle(el).outlineWidth}));assert.equal(focus.style,'solid');assert(parseFloat(focus.width)>0);
+  await page.screenshot({path:path.join(output,`form-invalid-${width}.png`)});
+  report.cases.push({width,checks:['selected-row','modal-padding','primary-hover-active','error-focus'],result:'passed'});
+ }
+ // A preserved comfortable density is an explicit author choice.
+ const feature='comfortable',root=path.join(output,`docs/.scratch/${feature}/design/prototypes`);
+ const {mkdir,cp}=await import('node:fs/promises');await mkdir(path.join(output,'.template-spec/design/tokens'),{recursive:true});
+ for(const ref of ['DESIGN.md','.template-spec/design/tokens/variables.css'])await cp(path.join(projectRoot,ref),path.join(output,ref));
+ await buildShadcnVuePrototype({projectRoot:output,root,feature,toolchain:process.env.YSS_VUE_TOOLCHAIN,density:'comfortable'});
+ await page.setViewportSize({width:1440,height:900});await page.goto(pathToFileURL(path.join(root,'index.html')).href);await page.locator('#keyword').waitFor();
+ assert.equal(await page.locator('#keyword').evaluate(el=>el.getBoundingClientRect().height),parseFloat(spec.components['button-primary'].height));
+ report.cases.push({density:'comfortable',result:'passed'});await context.close();
+}finally{await browser.close();}
+await writeFile(path.join(output,'result.json'),JSON.stringify(report,null,2));console.log(path.join(output,'result.json'));

package/template/.codex/skills/yss-prototype-stage/tests/comparison-browser-smoke.mjs

@@ -0,0 +1,77 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, cp, readFile, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { comparisonFixture } from './comparison-fixture.mjs';
+import { exportCraftExamples } from '../../yss-design-system/scripts/export-craft-examples.mjs';
+const {chromium} = await import(process.env.YSS_PLAYWRIGHT_MODULE || 'playwright');
+const temp = await mkdtemp(path.join(os.tmpdir(),'yss-comparison-browser-'));
+const f = await comparisonFixture();const prepared = await f.prepare();const portable=path.join(temp,'comparison');await cp(prepared.root,portable,{recursive:true});
+const examples = await exportCraftExamples({projectRoot:fileURLToPath(new URL('../../../../',import.meta.url)),output:path.join(temp,'examples')});
+await assert.rejects(exportCraftExamples({projectRoot:f.root,output:examples.root}),/拒绝覆盖/);
+const browser=await chromium.launch(process.env.YSS_BROWSER_CHANNEL?{channel:process.env.YSS_BROWSER_CHANNEL}:{});
+const results=[];
+try {
+ const context=await browser.newContext({offline:true,deviceScaleFactor:1,reducedMotion:'reduce',locale:'zh-CN',timezoneId:'Asia/Shanghai'});
+ const page=await context.newPage();const errors=[];
+ page.on('pageerror',e=>errors.push(e.message));page.on('console',m=>{if(['warning','error'].includes(m.type()))errors.push(m.text());});page.on('requestfailed',r=>errors.push(r.url()));page.on('request',r=>{if(/^https?:/.test(r.url()))errors.push(r.url());});
+ const url=pathToFileURL(path.join(portable,'index.html')).href;
+ for(const width of [1440,390]) {
+  await page.setViewportSize({width,height:width===390?844:900});await page.goto(url+'#variant=a&case=retry');
+  const frame=()=>page.frameLocator('iframe');
+  await frame().locator('#content').fill('失败后必须保留的本地输入');await frame().locator('#save').click();assert.equal(await frame().locator('body').getAttribute('data-state'),'error');
+  assert.equal(await frame().locator('#content').inputValue(),'失败后必须保留的本地输入');
+  await page.locator('#variant').selectOption('b');await frame().locator('#content').waitFor();assert.equal(await frame().locator('#content').inputValue(),'失败后应保留的输入');
+  await frame().locator('#content').fill('改变内容');await page.locator('#reset').click();await frame().locator('#content').waitFor();assert.equal(await frame().locator('#content').inputValue(),'失败后应保留的输入');
+  await page.reload();await frame().locator('#content').waitFor();assert.equal(await page.locator('#variant').inputValue(),'b');assert.equal(await page.locator('#case').inputValue(),'retry');
+  assert.equal(await page.locator('iframe').evaluate(e=>e.getBoundingClientRect().width),width);
+  await page.locator('#variant').focus();await page.keyboard.press('Tab');assert.equal(await page.evaluate(()=>document.activeElement.id),'case');
+  assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth>innerWidth),false);
+  await page.getByText('场景已初始化；实际业务行为仍须评审。',{exact:true}).waitFor();
+  await page.screenshot({path:path.join(temp,`comparison-${width}.png`),animations:'disabled'});
+  await page.goto(url+'#variant=missing&case=retry');assert.equal(await page.locator('iframe').count(),0);assert.equal(await page.locator('#error').isVisible(),true);
+  await page.goto(url+'#variant=a&case=missing');assert.equal(await page.locator('iframe').count(),0);assert.equal(await page.locator('#error').isVisible(),true);
+  results.push({kind:'comparison',width,result:'passed'});
+  const exampleURL=pathToFileURL(examples.entry).href;
+  for(const pair of ['list','form','approval']) {
+   const states=[];
+   for(const variant of ['before','after']) {
+    await page.goto(`${exampleURL}#pair=${pair}&variant=${variant}&scenario=failure`);
+    if(pair==='form')await page.locator('#name').fill('用户尚未保存的长中文资料名称');
+    await page.locator('#submit').click();await page.getByText('保存失败，当前输入已保留。请重试。',{exact:true}).waitFor();
+    if(pair==='form')assert.equal(await page.locator('#name').inputValue(),'用户尚未保存的长中文资料名称');
+    await page.locator('#retry').click();await page.getByText('操作成功（本地模拟）。',{exact:true}).waitFor();
+    assert.equal(await page.evaluate(()=>document.activeElement.id),'submit');
+    await page.locator('#reset').click();
+    states.push(await page.locator('#content').innerText());
+    if(pair==='list'){await page.getByRole('button',{name:'查看 M-001',exact:true}).click();await page.keyboard.press('Escape');assert.equal(await page.getByRole('button',{name:'查看 M-001',exact:true}).evaluate(e=>e===document.activeElement),true);}
+    assert.equal(await page.evaluate(()=>document.documentElement.scrollWidth>innerWidth),false);
+    await page.screenshot({path:path.join(temp,`${pair}-${variant}-${width}.png`),animations:'disabled'});
+    await page.locator('#scenario').selectOption('no-permission');assert.equal(await page.locator('#submit').isDisabled(),true);await page.getByText('无操作权限：可以查看资料，请联系负责人。',{exact:true}).waitFor();
+    await page.locator('#scenario').selectOption('conflict');await page.locator('#submit').click();if(pair==='form')await page.locator('#name').fill('冲突草稿');page.once('dialog',d=>d.dismiss());await page.locator('#reload').click();if(pair==='form')assert.equal(await page.locator('#name').inputValue(),'冲突草稿');page.once('dialog',d=>d.accept());await page.locator('#reload').click();if(pair==='form'){assert.equal(await page.locator('#name').inputValue(),'服务端最新资料名称');assert.equal(await page.locator('#owner').inputValue(),'最新负责人');assert.equal(await page.locator('#version').textContent(),'2');}await page.locator('#submit').click();await page.getByText('操作成功（本地模拟）。',{exact:true}).waitFor();await page.locator('#reset').click();page.once('dialog',d=>d.accept());await page.locator('#submit').click();await page.locator('#reload').click();await page.getByText('已重新加载，可继续核对和提交。',{exact:true}).waitFor();
+   }
+   assert.equal(states[0],states[1],'两侧内容必须一致');results.push({kind:'craft',pair,width,result:'passed'});
+  }
+ }
+ assert.deepEqual(errors,[]);const unexpectedErrors=[...errors];
+ // Initialization failure must never become a successful load indication.
+ const appPath=path.join(portable,'variants/a/app.js'),originalApp=await readFile(appPath,'utf8');
+ await writeFile(appPath,'throw new Error("fixture startup failure");\n'+originalApp);
+ await page.goto('about:blank');await page.goto(url+'#variant=a&case=normal');await page.locator('#error').filter({hasText:'候选初始化失败'}).waitFor();assert.equal(await page.locator('#status').textContent(),'');
+ await writeFile(appPath,'const initial=window.prototypeRuntime.initialize("failure");window.prototypeRuntime.ready(initial.ticket);');
+ await page.goto('about:blank');await page.goto(url+'#variant=a&case=normal');await page.locator('#error').filter({hasText:'场景或数据不一致'}).waitFor();
+ await writeFile(appPath,'addEventListener("message",e=>{if(e.data?.type==="yss-scenario-request")parent.postMessage({type:"yss-scenario-result",requestId:"stale",status:"error",error:"late"},"*");});\n'+originalApp);
+ await page.goto('about:blank');await page.goto(url+'#variant=a&case=normal');await page.getByText('场景已初始化；实际业务行为仍须评审。',{exact:true}).waitFor();assert.equal(await page.locator('#error').isVisible(),false);
+ await writeFile(appPath,originalApp);
+ const candidateHTML=path.join(portable,'variants/a/index.html'),originalHTML=await readFile(candidateHTML,'utf8');
+ await writeFile(candidateHTML,originalHTML.replace('<script src="./scenario-runtime.js"></script>','<script src="./scenario-runtime.js"></script><script src="missing-startup.js"></script>'));
+ assert.notEqual(await readFile(candidateHTML,'utf8'),originalHTML);
+ await page.goto('about:blank');await page.goto(url+'#variant=a&case=normal');await page.locator('#error').filter({hasText:'候选初始化失败'}).waitFor();assert.equal(await page.locator('#status').textContent(),'');
+ await writeFile(candidateHTML,originalHTML);
+ // A corrupt entry must show a load error, not a fallback successful candidate.
+ const broken=path.join(portable,'variants/a/index.html');await writeFile(broken,'<!doctype html><html><body>broken entry</body></html>');
+ await page.goto('about:blank');await page.goto(url+'#variant=a&case=normal');await page.locator('#error').waitFor({state:'visible',timeout:12000});assert.equal(await page.locator('iframe').count(),0);
+ const report={result:'passed',scope:'maintenance examples/comparison only; no product approval',browser:browser.version(),delivery:'isolated file:// offline=true',errors:unexpectedErrors,negativeProbeErrors:errors,results,artifacts:temp};
+ await writeFile(path.join(temp,'result.json'),JSON.stringify(report,null,2));console.log(JSON.stringify(report));console.log(path.join(temp,'result.json'));
+}finally{await browser.close();}

package/template/.codex/skills/yss-prototype-stage/tests/comparison-fixture.mjs

@@ -0,0 +1,16 @@
+import { mkdtemp, mkdir, writeFile, cp } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { prepareFlowPrototype } from '../scripts/prototype-contract.mjs';
+import { prepareComparison } from '../scripts/prototype-comparison.mjs';
+
+export async function comparisonFixture() {
+  const root = await mkdtemp(path.join(os.tmpdir(), 'yss-comparison-'));
+  await mkdir(path.join(root,'.template-spec/design/tokens'),{recursive:true});
+  for (const ref of ['DESIGN.md','.template-spec/design/tokens/variables.css']) await cp(new URL(`../../../../${ref}`,import.meta.url),path.join(root,ref));
+  for (const feature of ['a','b']) await prepareFlowPrototype({projectRoot:root,root:path.join(root,`docs/.scratch/${feature}/design/prototypes`),feature});
+  await writeFile(path.join(root,'interaction.md'),'# 比较记录\n问题：页面组织。共同任务、输入、保真度保持。此文件仅为维护 fixture。\n');
+  const input = {schema_version:2,comparison_id:'options',title:'方案比较',comparison_ref:'interaction.md',scenario_ref:'docs/.scratch/a/design/prototypes/scenarios.json',cases:[{id:'normal',label:'正常',scenario:'primary'},{id:'retry',label:'恢复',scenario:'failure'}],variants:['a','b'].map(id=>({id,label:`方案 ${id}`,root:`docs/.scratch/${id}/design/prototypes`,entry:'index.html',cases:['normal','retry']}))};
+  await writeFile(path.join(root,'input.json'),JSON.stringify(input));
+  return {root,input,prepare:()=>prepareComparison({projectRoot:root,feature:'fixture',input:'input.json'})};
+}