@givolt/i3-composer-agent 3.2.1 → 4.0.0

package/skills/i3-ui-prototype/scripts/native-browser.cjs

@@ -1,785 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-// Installable native-pilot acceptance. Dedicated browser contexts; no user profile or auto-install.
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const { pathToFileURL } = require('node:url');
-const { spawnSync } = require('node:child_process');
-const lib = require('./native-pilot-lib.cjs');
-const digest = bytes => crypto.createHash('sha256').update(bytes).digest('hex');
-const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
-
-function paginationPlan(directory) {
-  const inputs = read(path.join(directory, 'inputs/capabilities.json'));
-  const bindings = inputs.bindings.filter(binding => binding.id === 'devices/device-list/pagination');
-  assert.equal(bindings.length, 1, 'Exactly one fixed device-list pagination binding required');
-  return { source: 'inputs/capabilities.json', bindingId: bindings[0].id, ...require('./template-contract.cjs').resolvePaginationParameters(bindings[0].parameters) };
-}
-function themePlan(directory) {
-  const binding=read(path.join(directory,'inputs/capabilities.json')).bindings.find(item=>item.id==='devices/device-list/theme');
-  return binding?{source:'inputs/capabilities.json',bindingId:binding.id,...require('./template-contract.cjs').resolveThemeParameters(binding.parameters)}:null;
-}
-function paginationFocusPlan(directory) {
-  const value=read(path.join(directory,'inputs/framework.json')).acceptance?.paginationFocusGuard;
-  if(value===undefined)return false;
-  assert.equal(value,true,'A fixed pagination focus guard cannot silently opt out');
-  return true;
-}
-
-async function run(directory, options, runtime) {
-  const { chromium } = require(runtime.modulePath);
-  assert.ok(chromium?.launch, 'Playwright provider has no Chromium launcher');
-  directory = path.resolve(directory);
-  const startedAt = new Date().toISOString();
-  const runId = `chrome-${Date.now()}`;
-  const runRelative = `qa/runs/${runId}`;
-  const runRoot = path.join(directory, runRelative);
-  fs.mkdirSync(runRoot, { recursive: true });
-  const before = lib.manifest(directory);
-  const required = read(path.join(directory, 'inputs/acceptance.json'));
-  const pagination = paginationPlan(directory);
-  const themes = themePlan(directory);
-  const checkPaginationFocus = paginationFocusPlan(directory);
-  assert.equal(pagination.defaultPageSize, 10, 'The admin-list browser adapter requires a bound default capacity of ten; another default needs an explicit adapter');
-  const preview = await lib.preview(directory, {});
-  const runtimeConfig = read(path.join(preview.build.directory,'site/prototype-config.json'));
-  const browser = await chromium.launch({ channel: options.browserChannel || process.env.PILOT_BROWSER_CHANNEL || 'chrome', headless: true }).catch(async error => { await new Promise(resolve => preview.server.close(resolve)); throw error; });
-  const context = await browser.newContext({ viewport: { width: 1440, height: 1000 }, reducedMotion: 'no-preference' }).catch(async error => { await browser.close(); await new Promise(resolve => preview.server.close(resolve)); throw error; });
-  await context.tracing.start({ screenshots: true, snapshots: true, sources: true });
-  const consoleErrors = [], consoleWarnings = [], journeys = [], screenshots = [], observations = { paginationContract: pagination };
-  const temporary = [];
-  let traceSaved = false;
-  const page = await context.newPage();
-  const accessibilitySession=checkPaginationFocus?await context.newCDPSession(page):null;
-  if(accessibilitySession)await accessibilitySession.send('Accessibility.enable');
-  const source = path.resolve(__filename);
-  const categoryInput = options.expectedCategories || process.env.PILOT_EXPECTED_CATEGORIES;
-  const expectedCategories = typeof categoryInput === 'string' ? JSON.parse(categoryInput) : categoryInput || null;
-  if (expectedCategories) assert.ok(Array.isArray(expectedCategories) && expectedCategories.length && expectedCategories.every(item => typeof item === 'string' && item.trim()), 'PILOT_EXPECTED_CATEGORIES must be a nonempty JSON string array');
-  const prefix = 'devices/device-list/';
-  const editor = 'devices/device-editor/';
-  function observe(target) {
-    target.on('pageerror', error => consoleErrors.push(error.message));
-    target.on('console', message => {
-      if (message.type() === 'error') consoleErrors.push(message.text());
-      if (message.type() === 'warning') consoleWarnings.push(message.text());
-    });
-  }
-  observe(page);
-  const mark = (ids, checks) => {
-    for (const id of ids) {
-      assert.ok(!journeys.some(item => item.id === id), `Duplicate scenario ${id}`);
-      journeys.push({ id, status: 'passed', checks });
-    }
-  };
-  const rows = () => page.locator('tbody tr[data-row-key]');
-  const row = id => page.locator(`tbody tr[data-row-key="device-${id}"]`);
-  async function textContains(locator, text) { await locator.filter({ hasText: text }).first().waitFor({ state: 'visible' }); }
-  async function assertNoHiddenFocus(target=page) {
-    const focus=await target.evaluate(()=>{const active=document.activeElement,hidden=active?.closest('[aria-hidden="true"]');return {tag:active?.tagName,role:active?.getAttribute('role'),name:active?.getAttribute('aria-label'),hiddenAncestor:hidden?.outerHTML??null};});
-    assert.equal(focus.hiddenAncestor,null,'Pagination retained focus within aria-hidden content');
-    return focus;
-  }
-  async function verifyHiddenFocusFault() {
-    const fault=await context.newPage(),warnings=[];
-    try {
-      fault.on('console',message=>{if(message.type()==='warning')warnings.push(message.text());});
-      const session=await context.newCDPSession(fault);await session.send('Accessibility.enable');
-      await fault.setContent('<!doctype html><button aria-hidden="true" tabindex="-1">Hidden focus fault</button>');
-      await session.send('Accessibility.getFullAXTree');
-      const warning=fault.waitForEvent('console',{predicate:message=>message.type()==='warning'&&message.text().includes('Blocked aria-hidden'),timeout:5000});
-      await fault.locator('button').click();
-      await assert.rejects(assertNoHiddenFocus(fault),/retained focus within aria-hidden/);
-      await session.send('Accessibility.getFullAXTree');
-      await warning;
-      assert.ok(warnings.some(message=>message.includes('Blocked aria-hidden')),'The independent hidden-focus fault must produce the browser warning');
-      return {rejected:true,warnings,scope:'Independent adversarial page; excluded from candidate console warnings'};
-    } finally {await fault.close();}
-  }
-  async function assertSelectName(testId,label) {
-    const control=page.getByTestId(testId),combobox=control.getByRole('combobox');
-    assert.equal(await combobox.count(),1,`${testId}: one native combobox input required`);
-    const associated=await combobox.evaluate(input=>[...(input.labels??[])].map(element=>({text:element.textContent.replace(/\s+/g,' ').trim(),before:getComputedStyle(element,'::before').content})));
-    assert.deepEqual(associated.map(item=>item.text),[label],`${testId}: visible label must associate with the native input`);
-    const requiredMark=associated[0].before.replace(/^['"]|['"]$/g,'').trim()==='*';
-    const escaped=label.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
-    const fullName=requiredMark?new RegExp(`^(?:\\*\\s*)?${escaped}$`):label;
-    assert.equal(await control.getByRole('combobox',{name:fullName,exact:true}).count(),1,`${testId}: complete accessible name must match its label and actual required marker`);
-    (observations.selectNames??=[]).push({control:testId,label,requiredMark,snapshot:await combobox.ariaSnapshot()});
-  }
-  async function screenshot(name, target = page) {
-    const relative = `${runRelative}/${name}.png`;
-    const overlayVisible = await target.locator('.ant-drawer-mask').first().isVisible();
-    await target.screenshot({ path: path.join(directory, relative), fullPage: !overlayVisible, animations: 'allow' });
-    screenshots.push(relative);
-    return relative;
-  }
-  async function waitClosed() {
-    await page.locator('.app-shell[data-editor-lifecycle="closed"]').waitFor();
-    assert.equal(await page.getByTestId('editor-content').count(), 0);
-  }
-  async function assertVisibleCategories() {
-    if (!expectedCategories) return;
-    const values = await rows().locator('td:nth-child(4)').allTextContents();
-    assert.ok(values.length && values.every(value => expectedCategories.includes(value.trim())), `Visible record category does not match fixed PRD: ${values.join(', ')}`);
-  }
-  async function reset() {
-    if (await page.getByTestId('editor-content').count()) { await page.getByTestId('cancel-edit').click(); await waitClosed(); }
-    const details = page.locator('details.demo-tools');
-    if (!(await details.getAttribute('open'))) {
-      if (!(await details.evaluate(element => element.open))) await details.locator('summary').click();
-    }
-    await page.getByTestId('reset-data').click();
-    await textContains(page.getByTestId('success-notice'), '21');
-    assert.equal(await rows().count(), 10);
-  }
-  async function motionClick(testId) {
-    // Register before the real user action; sampling starts on the actual click event.
-    await page.evaluate(id => {
-      const button = document.querySelector(`[data-testid="${id}"]`);
-      window.__pilotMotion = new Promise(resolve => {
-        button.addEventListener('click', () => {
-          const samples = [], start = performance.now();
-          function sample() {
-            const panel = document.querySelector('.ant-drawer-content-wrapper');
-            const style = panel && getComputedStyle(panel);
-            samples.push({ ms: performance.now() - start, exists: !!panel, content: !!document.querySelector('[data-testid="editor-content"]'), transform: style?.transform || null, width: panel?.getBoundingClientRect().width || 0 });
-            if (performance.now() - start < 800) requestAnimationFrame(sample); else resolve(samples);
-          }
-          requestAnimationFrame(sample);
-        }, { capture: true, once: true });
-      });
-    }, testId);
-    await page.getByTestId(testId).click();
-    return page.evaluate(() => window.__pilotMotion);
-  }
-  function assertMotion(samples, phase) {
-    const partial = samples.filter(sample => {
-      const match = sample.transform?.match(/^matrix\([^,]+,[^,]+,[^,]+,[^,]+,\s*([^,]+),/);
-      const x = match ? Math.abs(Number(match[1])) : 0;
-      return x > 1 && x < sample.width - 1;
-    });
-    assert.ok(partial.length >= 2, `${phase}: no multiple intermediate native transforms`);
-    assert.ok(partial.every(sample => sample.content), `${phase}: editor was destroyed before animation completed`);
-    if (phase === 'exit') assert.ok(samples.some(sample => !sample.content), 'exit: editor not destroyed after hidden');
-    return { intermediateFrames: partial.length, samples };
-  }
-  async function assertBlur() {
-    const actual = await page.locator('.ant-drawer-mask').evaluate(element => ({ filter: getComputedStyle(element).backdropFilter, rect: element.getBoundingClientRect().toJSON(), panel: document.querySelector('.ant-drawer-content-wrapper')?.getBoundingClientRect().toJSON(), viewport: { width: innerWidth, height: innerHeight } }));
-    assert.match(actual.filter, /blur\((?!0(?:px)?\))[^)]+\)/, 'mask class exists but effective backdrop blur is missing');
-    assert.ok(actual.rect.width >= 1000 && actual.rect.height >= 600, 'visible mask does not cover background');
-    assert.ok(Math.abs(actual.rect.top) <= 1 && Math.abs(actual.rect.left) <= 1 && Math.abs(actual.rect.bottom - actual.viewport.height) <= 1 && Math.abs(actual.rect.right - actual.viewport.width) <= 1, 'mask does not cover current viewport bounds');
-    assert.ok(actual.panel && Math.abs(actual.panel.top) <= 1 && Math.abs(actual.panel.bottom - actual.viewport.height) <= 1, 'drawer panel does not cover viewport height');
-    return actual;
-  }
-  async function chooseTheme(target,id,picker='theme-picker-main') {
-    const labels={light:'明亮',dark:'暗黑',fresh:'清新',tech:'科技'};
-    assert.equal(await target.getByTestId(picker).getByRole('combobox',{name:'主题',exact:true}).count(),1,'The native theme combobox needs its own accessible name');
-    await target.getByTestId(picker).click();
-    const options=target.locator('.ant-select-dropdown:visible .ant-select-item-option');
-    await options.first().waitFor();
-    assert.deepEqual((await options.allTextContents()).map(text=>text.trim()),Object.values(labels),'Theme menu must show the four names without numeric aliases');
-    await options.filter({hasText:new RegExp(`^${labels[id]}$`)}).click();
-    await target.locator('.ant-select-dropdown:visible').waitFor({state:'hidden'});
-    await target.waitForFunction(value=>document.documentElement.dataset.prototypeTheme===value,id);
-    await target.evaluate(async()=>{await Promise.all(document.getAnimations().filter(animation=>animation.effect?.getTiming().iterations!==Infinity).map(animation=>animation.finished.catch(()=>{})));});
-  }
-  async function contrast(target) {
-    return target.evaluate(element=>{
-      const canvas=document.createElement('canvas'),context=canvas.getContext('2d',{willReadFrequently:true});canvas.width=canvas.height=1;
-      function rgba(color){context.clearRect(0,0,1,1);context.fillStyle=color;context.fillRect(0,0,1,1);return [...context.getImageData(0,0,1,1).data].map((v,i)=>i===3?v/255:v);}
-      const ancestors=[];for(let node=element;node;node=node.parentElement)ancestors.unshift(node);
-      let background=[255,255,255];for(const node of ancestors){const value=rgba(getComputedStyle(node).backgroundColor);background=background.map((channel,i)=>value[i]*value[3]+channel*(1-value[3]));}
-      const style=getComputedStyle(element),text=rgba(style.color),foreground=background.map((channel,i)=>text[i]*text[3]+channel*(1-text[3])),luminance=rgb=>rgb.map(v=>{v/=255;return v<=.04045?v/12.92:((v+.055)/1.055)**2.4}).reduce((sum,v,i)=>sum+v*[.2126,.7152,.0722][i],0);
-      const a=luminance(foreground),b=luminance(background);
-      return {color:style.color,background:background.map(Math.round),ratio:(Math.max(a,b)+.05)/(Math.min(a,b)+.05),luminance:b};
-    });
-  }
-  async function verifyThemes() {
-    if(!themes){assert.equal(await page.getByTestId('theme-picker-main').count(),0,'Unbound legacy instances must not acquire a theme menu');return;}
-    observations.theme={contract:themes,presets:[]};
-    const key=`${runtimeConfig.storageNamespace}:ui-theme:v1`;
-    assert.equal(await page.getByTestId('theme-picker-main').innerText(),'明亮');
-    await page.getByTestId('name-filter').fill('区');await page.getByTestId('query').click();
-    assert.match(await page.locator('.ant-pagination-total-text').innerText(),/共\s*20\s*条/,'The submitted filter must exclude device-21 while retaining two pages');
-    await page.getByRole('button',{name:'页 2',exact:true}).click();
-    if(checkPaginationFocus)await assertNoHiddenFocus();
-    const secondPageIds=await rows().evaluateAll(elements=>elements.map(element=>element.getAttribute('data-row-key')));
-    assert.deepEqual(secondPageIds,Array.from({length:10},(_,index)=>`device-${index+11}`));
-    await row(11).getByRole('checkbox').check();await page.getByTestId('edit-device-11').click();
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    await page.getByTestId('edit-name').fill('主题切换未保存输入');
-    const originalInput=await page.getByTestId('edit-name').elementHandle();
-    for(const id of themes.presets){
-      await chooseTheme(page,id,'theme-picker-editor');
-      assert.equal(await originalInput.evaluate(element=>element.isConnected),true,'Theme switching remounted the editor');
-      assert.equal(await page.getByTestId('edit-name').inputValue(),'主题切换未保存输入');
-      assert.equal(await page.getByTestId('name-filter').inputValue(),'区');
-      assert.match(await page.locator('.ant-pagination-total-text').innerText(),/共\s*20\s*条/,'Theme switching lost the submitted filter');
-      assert.equal(await page.locator('.ant-pagination-item-active').innerText(),'2','Theme switching reset the current page');
-      assert.deepEqual(await rows().evaluateAll(elements=>elements.map(element=>element.getAttribute('data-row-key'))),secondPageIds,'Theme switching changed visible records');
-      assert.equal(await row(11).getByRole('checkbox').isChecked(),true,'Theme switching changed the selected identity');
-      await textContains(page.getByTestId('selection-count'),'已选择 1 项');
-      const samples={};
-      for(const [name,locator]of Object.entries({heading:page.locator('h1'),description:page.locator('.page-description'),selection:page.getByTestId('selection-count'),table:row(12).locator('td').nth(2),selectedTable:row(11).locator('td').nth(2),tableHeading:page.locator('thead th').nth(2),editLink:page.getByTestId('edit-device-11'),statusTag:row(11).locator('.ant-tag'),form:page.locator('.ant-form-item-label label').first(),input:page.getByTestId('edit-name'),primaryButton:page.getByTestId('save-device')})){
-        samples[name]=await contrast(locator);assert.ok(samples[name].ratio>=4.5,`${id} ${name}: contrast ${samples[name].ratio} below 4.5`);
-      }
-      await page.getByTestId('edit-name').fill('');await page.getByTestId('save-device').click();
-      const validation=page.locator('.ant-form-item-explain-error');await validation.waitFor();
-      samples.validation=await contrast(validation);assert.ok(samples.validation.ratio>=4.5,`${id} Form validation contrast below 4.5`);
-      await screenshot(`theme-${id}-validation`);
-      await page.getByTestId('edit-name').fill('主题切换未保存输入');await validation.waitFor({state:'hidden'});
-      await page.getByTestId('edit-category').click();
-      const popup=page.locator('.ant-select-dropdown:visible .ant-select-item-option-content').first();await popup.waitFor();
-      await page.locator('.ant-select-dropdown:visible').evaluate(async element=>{await new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));await Promise.all(element.getAnimations({subtree:true}).map(animation=>animation.finished.catch(()=>{})));});
-      samples.popup=await contrast(popup);
-      samples.popupSurface=await contrast(page.locator('.ant-select-dropdown:visible'));
-      samples.drawerSurface=await contrast(page.locator('.ant-drawer-body'));
-      assert.ok(samples.popup.ratio>=4.5,`${id} popup contrast below 4.5`);
-      const dark=['dark','tech'].includes(id);
-      assert.ok(dark?samples.table.luminance<.15:samples.table.luminance>.7,`${id} Table surface did not follow native algorithm/tokens`);
-      assert.ok(dark?samples.popupSurface.luminance<.15:samples.popupSurface.luminance>.7,`${id} teleported Select did not follow theme`);
-      assert.ok(dark?samples.drawerSurface.luminance<.15:samples.drawerSurface.luminance>.7,`${id} Drawer surface did not follow theme`);
-      await screenshot(`theme-${id}-drawer`);
-      await page.getByTestId('edit-name').click();await page.locator('.ant-select-dropdown:visible').waitFor({state:'hidden'});
-      const combo=page.getByTestId('theme-picker-editor').getByRole('combobox');await combo.focus();await page.keyboard.press('ArrowDown');
-      await page.locator('.ant-select-dropdown:visible').waitFor();await page.keyboard.press('Escape');await page.locator('.ant-select-dropdown:visible').waitFor({state:'hidden'});
-      assert.equal(await page.getByRole('dialog').evaluate(element=>element.contains(document.activeElement)),true);
-      const picker=page.getByTestId('theme-picker-editor');
-      const appearance=()=>picker.evaluate(async element=>{await Promise.all(element.getAnimations({subtree:true}).map(animation=>animation.finished.catch(()=>{})));const style=getComputedStyle(element),rect=element.getBoundingClientRect();return {border:style.border,shadow:style.boxShadow,outline:style.outline,outlineWidth:style.outlineWidth,outlineStyle:style.outlineStyle,width:rect.width,height:rect.height};});
-      const focused=await appearance();await page.keyboard.press('Tab');const unfocused=await appearance();
-      assert.ok(focused.width>5&&focused.height>5&&(focused.shadow!=='none'||(focused.outlineStyle!=='none'&&Number.parseFloat(focused.outlineWidth)>0)),`${id} theme control has no visible keyboard focus`);
-      assert.ok(focused.border!==unfocused.border||focused.shadow!==unfocused.shadow||focused.outline!==unfocused.outline,`${id} theme focus indicator does not change on blur`);
-      const focus={focused,unfocused};
-      const narrowLayout=[];
-      for(const width of [375,320]){
-        await page.setViewportSize({width,height:850});assert.ok(await page.evaluate(()=>document.documentElement.scrollWidth<=innerWidth+1));
-        await page.locator('.ant-drawer-content-wrapper').evaluate(async element=>{await new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));await Promise.all(element.getAnimations({subtree:true}).map(animation=>animation.finished.catch(()=>{})));});
-        const layout=await page.locator('.ant-drawer-content-wrapper').evaluate(element=>({panel:element.getBoundingClientRect().toJSON(),input:document.querySelector('[data-testid="edit-name"]').getBoundingClientRect().toJSON(),viewport:innerWidth}));
-        for(const rect of [layout.panel,layout.input])assert.ok(rect.left>=-1&&rect.right<=layout.viewport+1,`${id} narrow Drawer clips controls outside the viewport`);
-        narrowLayout.push(layout);await screenshot(`theme-${id}-${width}`);
-      }
-      await page.setViewportSize({width:1440,height:1000});
-      await page.emulateMedia({reducedMotion:'reduce'});
-      const duration=await page.locator('.ant-drawer-content-wrapper').evaluate(element=>getComputedStyle(element).transitionDuration.split(',').map(value=>parseFloat(value)*(value.trim().endsWith('ms')?1:1000)));
-      assert.ok(duration.every(value=>value<=1),'Theme must respect reduced motion');await page.emulateMedia({reducedMotion:'no-preference'});
-      observations.theme.presets.push({id,label:{light:'明亮',dark:'暗黑',fresh:'清新',tech:'科技'}[id],samples,focus,narrow:[375,320],narrowLayout,reducedMotion:duration});
-    }
-    observations.theme.statePreserved={filter:'区',filteredTotal:20,excludedIds:['device-21'],page:2,selectedIds:['device-11'],visibleIds:secondPageIds,unsavedInput:'主题切换未保存输入',inputNodeRetained:true};
-    await page.getByTestId('cancel-edit').click();await waitClosed();assert.ok(!(await row(11).innerText()).includes('主题切换未保存输入'));
-    for(const id of themes.presets){await chooseTheme(page,id);await screenshot(`theme-${id}-list`);}
-    await page.reload({waitUntil:'networkidle'});await page.getByTestId('edit-device-1').waitFor();assert.equal(await page.getByTestId('theme-picker-main').innerText(),'科技','Theme preference must survive reload');
-    const malformed=[];
-    for(const raw of ['{','{"version":99,"themeId":"tech"}','{"version":1,"themeId":"unknown"}','{"version":1,"themeId":2}']){
-      await page.evaluate(({key,raw})=>localStorage.setItem(key,raw),{key,raw});await page.reload({waitUntil:'networkidle'});await page.getByTestId('edit-device-1').waitFor();assert.equal(await page.getByTestId('theme-picker-main').innerText(),'明亮');malformed.push(raw);
-    }
-    const deniedCases=[];
-    for(const mode of ['getter','write']){
-      const denied=await context.newPage();observe(denied);await denied.addInitScript(mode=>{
-        if(mode==='getter')Object.defineProperty(window,'localStorage',{get(){throw new DOMException('Storage denied','SecurityError');}});
-        else {const original=Storage.prototype.setItem;Storage.prototype.setItem=function(key,value){if(key.endsWith(':ui-theme:v1'))throw new DOMException('Theme storage denied','QuotaExceededError');return original.call(this,key,value);};}
-      },mode);
-      await denied.goto(preview.url,{waitUntil:'networkidle'});await denied.getByTestId('edit-device-1').waitFor();assert.equal(await denied.getByTestId('theme-picker-main').innerText(),'明亮');
-      await chooseTheme(denied,'dark');await denied.getByTestId('theme-storage-warning').waitFor();assert.equal(await denied.locator('tbody tr[data-row-key]').count(),10);
-      await screenshot(`theme-denied-${mode}`,denied);await denied.reload({waitUntil:'networkidle'});await denied.getByTestId('edit-device-1').waitFor();assert.equal(await denied.getByTestId('theme-picker-main').innerText(),'明亮');await denied.close();deniedCases.push(mode);
-    }
-    await chooseTheme(page,'light');observations.theme.storage={key,reload:true,malformed,deniedCases};
-    mark([`${prefix}theme/switch`],['four named native presets','Table/Form/Drawer/teleported Select follow tokens','input node, unsaved value, active filter excluding device-21, total 20, page two, exact visible records and selected identity preserved']);
-    mark([`${prefix}theme/accessibility`],['sampled computed text contrast at least 4.5','keyboard opens and escapes theme menu inside dialog','320/375 layouts','reduced motion computed duration']);
-    await reset();
-  }
-
-  try {
-    // Compare actual browser response bytes against the build manifest.
-    const requests = [];
-    page.on('response', response => {
-      if (!response.url().startsWith(preview.url)) return;
-      requests.push((async () => {
-        const relative = new URL(response.url()).pathname.replace(/^\//, '') || 'index.html';
-        if (!preview.build.files[relative]) return;
-        return { path: relative, url: response.url(), sha256: digest(await response.body()), status: response.status(), resourceType: response.request().resourceType() };
-      })());
-    });
-    await page.goto(preview.url, { waitUntil: 'networkidle' });
-    if(accessibilitySession)await accessibilitySession.send('Accessibility.getFullAXTree');
-    await page.getByTestId('edit-device-1').waitFor();
-    const responses = (await Promise.all(requests)).filter(Boolean);
-    for (const response of responses) assert.equal(response.sha256, preview.build.files[response.path], `Loaded bytes differ: ${response.path}`);
-    for (const extension of ['index.html', '.js', '.css', 'prototype-config.json']) assert.ok(responses.some(item => item.path.endsWith(extension)), `No actual loaded ${extension} proof`);
-    const meta = await page.evaluate(() => window.__PROTOTYPE_META__);
-    assert.equal(meta.candidateId, before.digest);
-    observations.loadedResources = responses;
-    if (options.expectedDescription) {
-      const description = page.getByText(options.expectedDescription, { exact: true });
-      await description.waitFor();
-      observations.expectedDescription = await description.innerText();
-      await screenshot('expected-description');
-    }
-    await reset();
-    await assertVisibleCategories();
-    await assertSelectName('status-filter',runtimeConfig.content?.fields?.queryStatus?.label||'运行状态');
-    await verifyThemes();
-
-    // Query combines both filters and handles no results.
-    await page.getByTestId('name-filter').fill('北区');
-    await page.getByTestId('status-filter').click();
-    await page.locator('.ant-select-dropdown:visible .ant-select-item-option').filter({ hasText: '已停用' }).click();
-    await page.getByTestId('query').click();
-    assert.equal(await rows().count(), 2);
-    assert.ok((await rows().allTextContents()).every(text => text.includes('北区') && text.includes('已停用')));
-    await page.getByTestId('name-filter').fill('无此设备');
-    await page.getByTestId('query').click();
-    assert.equal(await rows().count(), 0);
-    await textContains(page.getByTestId('device-table'), '暂无符合条件');
-    mark([`${prefix}filter/query`], ['combined name/status yields two correct records', 'unmatched query yields actionable empty state']);
-    await page.getByTestId('reset-filter').click();
-    assert.equal(await page.getByTestId('name-filter').inputValue(), '');
-    assert.equal(await rows().count(), 10);
-    assert.match(await page.getByTestId('status-filter').innerText(), /全部状态/);
-    mark([`${prefix}filter/reset`], ['clears both conditions', 'restores page one and ten records']);
-
-    const checks = page.getByRole('checkbox');
-    await checks.nth(1).check();
-    await textContains(page.getByTestId('selection-count'), '已选择 1 项');
-    if (options.verifyAtomicStatus === true) {
-      const attributes = await page.getByTestId('selection-count').evaluate(element => ({ role: element.getAttribute('role'), live: element.getAttribute('aria-live'), atomic: element.getAttribute('aria-atomic'), text: element.textContent.trim() }));
-      assert.deepEqual({ role: attributes.role, live: attributes.live, atomic: attributes.atomic }, { role: 'status', live: 'polite', atomic: 'true' });
-      assert.match(attributes.text, /^已选择 1 项/);
-      observations.atomicStatus = { ...attributes, scope: 'DOM accessibility semantics; speech output was not simulated' };
-    }
-    assert.equal(await checks.first().evaluate(element => element.indeterminate), true);
-    await checks.first().check();
-    await textContains(page.getByTestId('selection-count'), '已选择 10 项');
-    assert.equal(await page.getByRole('checkbox', { checked: true }).count(), 11);
-    await checks.first().uncheck();
-    await textContains(page.getByTestId('selection-count'), '已选择 0 项');
-    mark([`${prefix}selection/select-page`], ['single and partial state', 'current-page all ten', 'clear all']);
-    await checks.nth(1).check();
-    await page.getByRole('button', { name: '页 2', exact: true }).click();
-    if(checkPaginationFocus){
-      const pointer=await assertNoHiddenFocus();
-      assert.deepEqual({tag:pointer.tag,role:pointer.role,name:pointer.name},{tag:'LI',role:'button',name:'页 2'},'Page-number pointer focus must stay on the native accessible outer control');
-      observations.paginationFocus={pointer,fault:await verifyHiddenFocusFault()};
-    }
-    await textContains(page.getByTestId('selection-count'), '已选择 0 项');
-    assert.equal(await rows().count(), 10);
-    assert.match(await rows().first().innerText(), /DEV-011/);
-    await assertVisibleCategories();
-    await page.getByRole('button', { name: '页 3', exact: true }).click();
-    if(checkPaginationFocus)await assertNoHiddenFocus();
-    assert.equal(await rows().count(), 1);
-    assert.match(await rows().first().innerText(), /DEV-021/);
-    await assertVisibleCategories();
-    assert.match(await page.locator('.ant-pagination-total-text').innerText(), /21/);
-    mark([`${prefix}pagination/pages`], ['default capacity has three pages containing 10/10/1 records', 'correct first/middle/last IDs and total']);
-    if (pagination.mode === 'fixed') {
-      assert.equal(await page.locator('.ant-pagination-options').count(), 0, 'Fixed pagination must not expose a capacity changer');
-      mark([`${prefix}pagination/page-size`], ['fixed capacity ten', 'no capacity changer']);
-    } else {
-      const changer = page.locator('.ant-pagination-options .ant-select');
-      assert.equal(await changer.count(), 1, 'Adjustable pagination requires one native capacity changer');
-      const transitions = [];
-      for (const size of [...pagination.pageSizeOptions.filter(value => value !== pagination.defaultPageSize), pagination.defaultPageSize]) {
-        const beforePage = Number(await page.locator('.ant-pagination-item-active').innerText());
-        await page.getByRole('checkbox').nth(1).check();
-        await textContains(page.getByTestId('selection-count'), '已选择 1 项');
-        await changer.click();
-        const options = page.locator('.ant-select-dropdown:visible .ant-select-item-option');
-        await options.first().waitFor();
-        const offered = (await options.allTextContents()).map(text => Number.parseInt(text.trim(), 10));
-        assert.deepEqual([...offered].sort((a,b) => a-b), [...pagination.pageSizeOptions].sort((a,b) => a-b), 'Visible page-size options differ from the fixed binding');
-        const desired = options.filter({ hasText: new RegExp(`^\\s*${size}(?=\\D|$)`) });
-        assert.equal(await desired.count(), 1, `No unique native option for page size ${size}`);
-        await desired.click();
-        await page.locator('.ant-select-dropdown:visible').waitFor({ state: 'hidden' });
-        await textContains(page.getByTestId('selection-count'), '已选择 0 项');
-        const expectedRows = Math.min(size, 21);
-        await page.waitForFunction(count => document.querySelectorAll('tbody tr[data-row-key]').length === count, expectedRows);
-        assert.equal(Number(await page.locator('.ant-pagination-item-active').innerText()), 1, 'Capacity change must return to page one');
-        assert.match(await rows().first().innerText(), /DEV-001/);
-        assert.match(await page.locator('.ant-pagination-total-text').innerText(), /21/);
-        const pages = (await page.locator('.ant-pagination-item').allTextContents()).map(text => Number(text.trim()));
-        const totalPages = Math.ceil(21/size);
-        assert.equal(pages[0], 1, 'Native pagination must expose its first page');
-        assert.equal(pages.at(-1), totalPages, 'Native last-page control differs from the chosen capacity');
-        assert.ok(pages.every((value,index) => Number.isInteger(value) && value >= 1 && value <= totalPages && (!index || value > pages[index-1])), 'Visible native page controls must be unique, ordered and in range');
-        const observation = { requestedPageSize: size, previousPage: beforePage, activePage: 1, rows: await rows().count(), total: 21, totalPages, visiblePages: pages, selectionCleared: true, offeredOptions: offered };
-        await assertVisibleCategories();
-        await screenshot(`pagination-capacity-${size}`);
-        if (size < 21) {
-          await page.getByRole('button', { name: '页 2', exact: true }).click();
-          assert.equal(await rows().count(), Math.min(size, 21-size));
-          observation.secondPageRows = await rows().count();
-        }
-        if (totalPages > 1) await page.getByRole('button', { name: `页 ${totalPages}`, exact: true }).click();
-        assert.equal(await rows().count(), 21-(totalPages-1)*size, 'Last-page remainder differs from the fixed data count');
-        assert.match(await rows().first().innerText(), new RegExp(`DEV-${String((totalPages-1)*size+1).padStart(3,'0')}`));
-        assert.match(await rows().last().innerText(), /DEV-021/);
-        observation.lastPageRows = await rows().count();
-        transitions.push(observation);
-      }
-      await page.getByRole('button', { name: '页 1', exact: true }).click();
-      assert.equal(await rows().count(), pagination.defaultPageSize);
-      observations.paginationSizes = { mode: pagination.mode, binding: pagination.bindingId, transitions, restoredDefault: pagination.defaultPageSize };
-      mark([`${prefix}pagination/page-size`], ['native options equal the fixed binding', 'every declared capacity selected through the actual dropdown', 'row counts and page totals match 21 records', 'each capacity change resets page and selection', 'default capacity restored']);
-    }
-    await page.getByRole('checkbox').nth(1).check();
-    await page.getByTestId('query').click();
-    await textContains(page.getByTestId('selection-count'), '已选择 0 项');
-    assert.equal(await rows().count(), 10);
-    mark([`${prefix}selection/clear-on-change`], ['page change clears selection', 'query clears selection and returns page one']);
-
-    assert.equal(await page.getByTestId('bulk-disable').isDisabled(), true);
-    await row(1).getByRole('checkbox').check();
-    await row(2).getByRole('checkbox').check();
-    await page.getByTestId('bulk-disable').click();
-    assert.match(await row(1).innerText(), /已停用/);
-    assert.match(await row(2).innerText(), /已停用/);
-    assert.match(await row(3).innerText(), /运行中/);
-    await textContains(page.getByTestId('success-notice'), '2 台');
-    assert.equal(await page.getByTestId('bulk-disable').isDisabled(), true);
-    mark([`${prefix}bulk/selected-only`], ['disabled with none', 'only records one and two change', 'record three unchanged', 'affected count and selection reset']);
-    await reset();
-
-    const entry = assertMotion(await motionClick('edit-device-1'), 'entry');
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    observations.entryMotion = entry;
-    await assertSelectName('edit-category',runtimeConfig.content?.fields?.editCategory?.label||'设备分类');
-    await assertSelectName('edit-status',runtimeConfig.content?.fields?.editStatus?.label||'运行状态');
-    observations.blur = await assertBlur();
-    if (expectedCategories) {
-      await page.getByTestId('edit-category').click();
-      const options = page.locator('.ant-select-dropdown:visible .ant-select-item-option');
-      await options.first().waitFor();
-      const actual = (await options.allTextContents()).map(value => value.trim());
-      assert.deepEqual([...actual].sort(), [...expectedCategories].sort(), 'Editor categories do not match fixed PRD');
-      await page.getByTestId('edit-name').click();
-      await page.locator('.ant-select-dropdown:visible').waitFor({ state: 'hidden' });
-      observations.businessCategoryMapping = { expected: expectedCategories, actual, verifiedAcrossThreePages: true };
-    }
-    await screenshot('desktop-editor-blur');
-    const blurClip = { x: 100, y: 350, width: 300, height: 300 };
-    const blurCropPath = `${runRelative}/background-blurred.png`;
-    const blurred = await page.screenshot({ path: path.join(directory, blurCropPath), clip: blurClip, animations: 'allow' });
-    screenshots.push(blurCropPath);
-    // A class-only mask must fail the same real-style predicate.
-    await page.locator('.ant-drawer-mask').evaluate(element => element.style.setProperty('backdrop-filter', 'none', 'important'));
-    await assert.rejects(assertBlur(), /effective backdrop blur/);
-    await screenshot('fault-mask-no-filter');
-    const clearCropPath = `${runRelative}/background-no-filter.png`;
-    const unblurred = await page.screenshot({ path: path.join(directory, clearCropPath), clip: blurClip, animations: 'allow' });
-    screenshots.push(clearCropPath);
-    assert.notEqual(digest(blurred), digest(unblurred), 'effective blur did not change rendered background pixels');
-    observations.blurRenderDifference = { blurred: digest(blurred), unblurred: digest(unblurred), clip: blurClip };
-    await page.locator('.ant-drawer-mask').evaluate(element => element.style.removeProperty('backdrop-filter'));
-    await assertBlur();
-    mark(['framework-mask-blur'], ['computed native blur(4px)', 'background screenshot', 'retaining class but removing effective filter is rejected']);
-
-    if (options.verifyBlurValidation === true) {
-      const name = page.getByTestId('edit-name');
-      const item = name.locator('xpath=ancestor::div[contains(concat(" ", normalize-space(@class), " "), " ant-form-item ")][1]');
-      const errors = item.locator('.ant-form-item-explain-error');
-      await name.fill('   ');
-      assert.equal(await errors.count(), 0, 'Validation ran on change before first blur');
-      await page.getByTestId('edit-category').click();
-      await errors.waitFor();
-      observations.blurValidation = { beforeBlurNoError: true, afterBlurMessage: await errors.innerText() };
-      await name.click(); await name.fill('验证有效输入');
-      await page.getByTestId('edit-category').click();
-      await errors.waitFor({ state: 'hidden' });
-      await name.click();
-      await page.locator('.ant-select-dropdown:visible').waitFor({ state: 'hidden' });
-    }
-    await page.getByTestId('edit-name').fill('   ');
-    await page.getByTestId('save-device').click();
-    await page.getByText(`请输入${meta.content?.fields.editName.label || '设备名称'}`, { exact: true }).waitFor();
-    assert.equal(await page.getByTestId('editor-content').count(), 1);
-    assert.equal(await page.getByTestId('edit-name').evaluate(element => document.activeElement === element), true, 'required field was not focused');
-    assert.match(await row(1).innerText(), /北区设备 01/);
-    mark([`${editor}edit/validation`], ['whitespace required error', 'drawer stays open', 'record unchanged']);
-    const newName = '北区设备 01 · 浏览器验收';
-    await page.getByTestId('edit-name').fill(newName);
-    await page.getByTestId('fail-next-save').click();
-    await page.getByTestId('save-device').click();
-    await page.getByTestId('save-device').locator('.anticon-loading').waitFor();
-    assert.equal(await page.getByTestId('edit-name').isDisabled(), true);
-    await page.getByTestId('save-error').waitFor();
-    assert.equal(await page.getByTestId('edit-name').inputValue(), newName);
-    assert.doesNotMatch(await row(1).innerText(), /浏览器验收/);
-    await page.getByTestId('save-device').click();
-    await waitClosed();
-    assert.match(await row(1).innerText(), /浏览器验收/);
-    assert.match(await row(2).innerText(), /北区设备 02/);
-    await textContains(page.getByTestId('success-notice'), 'DEV-001');
-    mark([`${editor}edit/retry`, `${editor}edit/save`, `${editor}feedback/states`], ['submitting disables input', 'failure preserves entered name without changing record', 'retry success updates one record and reports success']);
-
-    await page.getByTestId('edit-device-1').focus();
-    await page.getByTestId('edit-device-1').press('Enter');
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    assert.equal(await page.getByTestId('edit-name').evaluate(element => document.activeElement === element), true);
-    observations.focusIndicators = [];
-    const settle = target => target.evaluate(async element => { await Promise.all(element.getAnimations({ subtree: true }).map(animation => animation.finished.catch(() => {}))); });
-    const appearance = target => target.evaluate(element => { const style = getComputedStyle(element), rect = element.getBoundingClientRect(); return { tag: element.tagName, classes: element.className, outline: style.outline, outlineStyle: style.outlineStyle, outlineWidth: style.outlineWidth, outlineColor: style.outlineColor, boxShadow: style.boxShadow, border: style.border, width: rect.width, height: rect.height }; });
-    for (let index = 0; index < 12; index++) {
-      const active = await page.evaluateHandle(() => document.activeElement);
-      const target = await active.evaluateHandle(element => element.closest('.ant-select') || element);
-      assert.equal(await active.evaluate(element => element.matches(':focus-visible')), true);
-      await settle(target); const focused = await appearance(target);
-      await page.keyboard.press('Tab');
-      await settle(target); const unfocused = await appearance(target);
-      const outline = focused.outlineStyle !== 'none' && Number.parseFloat(focused.outlineWidth) > 0 && focused.outlineColor !== 'rgba(0, 0, 0, 0)';
-      const shadow = focused.boxShadow !== 'none' && !focused.boxShadow.startsWith('rgba(0, 0, 0, 0) ');
-      assert.ok(focused.width > 5 && focused.height > 5 && (outline || shadow), 'No visible focus indicator on the rendered control');
-      assert.ok(focused.outline !== unfocused.outline || focused.boxShadow !== unfocused.boxShadow || focused.border !== unfocused.border, 'Rendered focus indicator does not change on blur');
-      observations.focusIndicators.push({ focused, unfocused });
-      await active.dispose(); await target.dispose();
-      assert.equal(await page.getByRole('dialog').evaluate(element => element.contains(document.activeElement)), true, 'Tab focus escaped dialog');
-    }
-    assert.match(await page.locator('body').evaluate(element => getComputedStyle(element).overflow), /hidden/);
-    await page.keyboard.press('Escape');
-    await waitClosed();
-    assert.equal(await page.getByTestId('edit-device-1').evaluate(element => document.activeElement === element), true);
-    assert.doesNotMatch(await page.locator('body').evaluate(element => getComputedStyle(element).overflow), /hidden/);
-    mark(['framework-focus-scroll'], ['keyboard open', 'initial field focus', 'Tab focus trap', 'body lock', 'Escape close and opener/scroll restoration']);
-
-    await page.getByTestId('edit-device-1').click();
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    observations.exitMotion = assertMotion(await motionClick('cancel-edit'), 'exit');
-    await waitClosed();
-    mark([`${editor}edit/drawer-motion`, 'framework-drawer-motion'], ['multiple intermediate native entry/exit transforms', 'content survives partial exit', 'content destroyed after exit']);
-    // Adversarial DOM mutation only: source/build bytes stay fixed.
-    await page.getByTestId('edit-device-1').click();
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    await page.getByTestId('cancel-edit').evaluate(element => element.addEventListener('click', () => document.querySelector('[data-testid="editor-content"]')?.remove(), { capture: true, once: true }));
-    await assert.rejects(async () => assertMotion(await motionClick('cancel-edit'), 'exit'), /destroyed before animation/);
-    observations.earlyUnmountFaultRejected = true;
-    await page.reload({ waitUntil: 'networkidle' });
-    await page.getByTestId('edit-device-1').waitFor();
-
-    await reset();
-    await page.getByTestId('show-loading').click();
-    await page.locator('.ant-spin-spinning').waitFor();
-    await page.getByTestId('restore-list').click();
-    await page.getByTestId('show-empty').click();
-    assert.equal(await rows().count(), 0);
-    await page.getByTestId('clear-empty').click();
-    assert.equal(await rows().count(), 10);
-    await page.getByTestId('show-error').click();
-    await page.getByTestId('list-error').waitFor();
-    await page.getByTestId('retry-list').click();
-    assert.equal(await rows().count(), 10);
-    await page.getByTestId('reset-data').click();
-    await textContains(page.getByTestId('success-notice'), '21');
-    mark([`${prefix}feedback/states`, 'framework-states'], ['deterministic loading', 'empty with recovery', 'error with retry', 'success and deterministic reset']);
-
-    observations.viewports = [];
-    for (const width of [1440, 768, 375, 320]) {
-      await page.setViewportSize({ width, height: 1000 });
-      assert.equal(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth + 1), true, `document overflow at ${width}`);
-      await page.getByTestId('query').waitFor();
-      await screenshot(`list-${width}`);
-      observations.viewports.push(width);
-    }
-    await page.setViewportSize({ width: 1440, height: 1000 });
-    await page.emulateMedia({ reducedMotion: 'reduce' });
-    await page.getByTestId('edit-device-1').click();
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    const durations = await page.locator('.ant-drawer-content-wrapper').evaluate(element => ({ transition: getComputedStyle(element).transitionDuration, animation: getComputedStyle(element).animationDuration }));
-    const seconds = value => value.split(',').map(part => part.trim().endsWith('ms') ? Number.parseFloat(part) / 1000 : Number.parseFloat(part));
-    assert.ok([...seconds(durations.transition), ...seconds(durations.animation)].every(value => value < .02), 'reduced motion still has long transitions');
-    await screenshot('reduced-motion-editor');
-    await page.getByTestId('cancel-edit').click();
-    await waitClosed();
-    await page.emulateMedia({ reducedMotion: 'no-preference' });
-    observations.reducedMotion = durations;
-    mark(['framework-responsive'], ['1440/768/375/320 screenshots and no page overflow', 'reduced-motion actual computed durations', 'close lifecycle intact']);
-
-    // A second real generated build is routed under the same origin to test namespace isolation.
-    const isolationProject = fs.mkdtempSync(path.join(os.tmpdir(), 'native-isolation-'));
-    temporary.push(isolationProject);
-    const authoring = lib.prepareTemplate({ project: isolationProject });
-    const authoringFile = path.join(authoring.directory, 'index.html');
-    let authored = fs.readFileSync(authoringFile, 'utf8');
-    authored = authored.replace('<h1>设备管理</h1>', '<h1>模板手改资产管理</h1>')
-      .replace('<h2 id="list-title">设备清单</h2>', '<h2 id="list-title">资产台账</h2>')
-      .replace('<h2 id="editor-title">编辑设备</h2>', '<h2 id="editor-title">编辑资产</h2>')
-      .replace(/(<th data-field-id="device-name">)[^<]+/, '$1资产名称')
-      .replace('<label>设备名称 <span', '<label>资产名称 <span')
-      .replace('data-field-id="edit-name"', 'data-field-id="edit-name" placeholder="请输入资产登记名称"')
-      .replace(/(data-action-id="query"[^>]*>)[^<]+/, '$1检索设备')
-      .replace(/(data-action-id="save-edit"[^>]*>)[^<]+/, '$1保存修改');
-    if(themes)authored=authored.replace('<nav class="pagination"',`<aside data-capability-id="theme" data-capability-parameters='{"defaultTheme":"light","presets":["light","dark","fresh","tech"]}'>可选主题</aside><nav class="pagination"`);
-    fs.writeFileSync(authoringFile, authored);
-    require('./template-contract.cjs').syncTemplate(authoring.directory);
-    let themeScope;
-    if(themes){themeScope=path.join(isolationProject,'theme-scope.json');fs.writeFileSync(themeScope,JSON.stringify({schemaVersion:1,requirements:[{id:'THEME-ISOLATION',text:'同源命名主题隔离回归',source:{type:'user',reference:'native-browser/theme-isolation',statement:'Regression fixture only; verify isolated preferences'},capabilities:[{pageId:'devices',regionId:'device-list',capabilityId:'theme'}]}],exemptions:[]}));}
-    const second = lib.createPrototype({ project: isolationProject, id: 'isolation-b', expertMode: 'template', templateRoot: authoring.directory,...(themeScope?{scope:themeScope}:{}) });
-    // Keep the isolation fixture, dependency install and npm cache in the
-    // agreed temporary directory; this tool never owns a user-level cache.
-    const child = spawnSync(process.execPath, [path.join(__dirname, 'native-pilot.cjs'), 'build', second.directory, '--install'], {
-      encoding: 'utf8', timeout: 180000, maxBuffer: 5 * 1024 * 1024,
-      env: { ...process.env, npm_config_cache: path.join(isolationProject, '.npm-cache'), npm_config_update_notifier: 'false' },
-    });
-    assert.equal(child.status, 0, `Isolation build failed: ${child.stderr || child.stdout || child.error}`);
-    const secondBuild = JSON.parse(child.stdout);
-    const secondSite = path.join(secondBuild.directory, 'site');
-    const mime = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json' };
-    await context.route(`${preview.url}isolation/**`, async route => {
-      const relative = new URL(route.request().url()).pathname.replace(/^\/isolation\/?/, '') || 'index.html';
-      assert.ok(!relative.includes('..'));
-      await route.fulfill({ path: path.join(secondSite, relative), contentType: mime[path.extname(relative)] || 'application/octet-stream' });
-    });
-    const other = await context.newPage(); observe(other);
-    await other.goto(`${preview.url}isolation/`, { waitUntil: 'networkidle' });
-    await other.getByTestId('edit-device-1').waitFor();
-    assert.equal(await other.locator('h1').innerText(), '模板手改资产管理');
-    assert.equal(await other.locator('.list-toolbar h2').innerText(), '资产台账');
-    await other.getByRole('columnheader', { name: '资产名称', exact: true }).first().waitFor();
-    assert.equal(await other.getByTestId('query').innerText(), '检索设备');
-    await other.getByTestId('edit-device-1').click();
-    await other.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    await other.getByRole('dialog', { name: /编辑资产/ }).waitFor();
-    assert.equal(await other.getByTestId('save-device').innerText(), '保存修改');
-    assert.equal(await other.getByTestId('edit-name').getAttribute('placeholder'), '请输入资产登记名称');
-    const projectedLabels=await other.getByTestId('edit-name').evaluate(input=>[...(input.labels??[])].map(label=>label.textContent.replace(/\s+/g,' ').trim()));
-    assert.deepEqual(projectedLabels,['资产名称'],'Projected text must label the actual native editor input');
-    await screenshot('edited-template-projection', other);
-    await other.getByTestId('cancel-edit').click();
-    await other.locator('.app-shell[data-editor-lifecycle="closed"]').waitFor();
-    mark(['template-content-projection'], ['HTML title/list title/header/editor field/action changed before sync', 'new real generated build visibly displays each edit']);
-    const otherMeta = await other.evaluate(() => window.__PROTOTYPE_META__);
-    assert.notEqual(otherMeta.storageNamespace, meta.storageNamespace);
-    await page.getByTestId('edit-device-1').click();
-    await page.locator('.app-shell[data-editor-lifecycle="open"]').waitFor();
-    await page.getByTestId('edit-name').fill('实例 A 独有修改');
-    await page.getByTestId('save-device').click(); await waitClosed();
-    await page.reload({ waitUntil: 'networkidle' });
-    assert.match(await row(1).innerText(), /实例 A 独有修改/);
-    await other.reload({ waitUntil: 'networkidle' });
-    assert.match(await other.locator('tr[data-row-key="device-1"]').innerText(), /北区设备 01/);
-    await other.locator('details summary').click();
-    await other.getByTestId('reset-data').click();
-    await page.reload({ waitUntil: 'networkidle' });
-    assert.match(await row(1).innerText(), /实例 A 独有修改/);
-    observations.instanceIsolation = { first: meta.instanceId, second: otherMeta.instanceId, sameOrigin: true, secondBuild: secondBuild.buildId };
-    if(themes){
-      const secondConfig=read(path.join(secondBuild.directory,'site/prototype-config.json'));
-      assert.equal(await other.getByTestId('theme-picker-main').innerText(),'明亮');
-      await chooseTheme(page,'tech');await chooseTheme(other,'dark');
-      await page.reload({waitUntil:'networkidle'});await other.reload({waitUntil:'networkidle'});await page.getByTestId('edit-device-1').waitFor();await other.getByTestId('edit-device-1').waitFor();
-      assert.equal(await page.getByTestId('theme-picker-main').innerText(),'科技');assert.equal(await other.getByTestId('theme-picker-main').innerText(),'暗黑');
-      const firstKey=observations.theme.storage.key,secondKey=`${secondConfig.storageNamespace}:ui-theme:v1`;
-      assert.notEqual(firstKey,secondKey);
-      observations.theme.storage.isolation={sameOrigin:true,firstKey,secondKey,first:'tech',second:'dark',secondBuild:secondBuild.buildId};
-      await screenshot('theme-second-instance',other);await chooseTheme(page,'light');
-      mark([`${prefix}theme/persistence`],['preference survives reload','bad cache safely uses light','denied localStorage getter/write keeps app usable','same-origin instances independently persist tech and dark']);
-    }
-    await screenshot('second-instance', other);
-    await other.close(); await reset();
-    mark(['framework-instance-isolation'], ['two generated builds on same origin', 'different namespace', 'first instance edit survives reload', 'second instance remains seed', 'reset second does not change first']);
-
-    // file:// authoring reference works with all HTTP(S) traffic blocked.
-    const offline = await context.newPage(); observe(offline);
-    const network = [];
-    await offline.route(/^https?:/, route => { network.push(route.request().url()); return route.abort(); });
-    await offline.goto(pathToFileURL(path.resolve(directory, '../../ui-templates/admin-list/index.html')).href);
-    await offline.locator('h1').waitFor();
-    assert.match(await offline.title(), /内容模板/);
-    await offline.locator('[data-field-id="preview-state"]').selectOption('error');
-    assert.match(await offline.locator('[data-preview-message]').innerText(), /失败/);
-    assert.deepEqual(network, []);
-    observations.offlineReference = { scheme: 'file:', externalRequests: network.length, stateSwitch: 'error' };
-    await screenshot('offline-reference', offline); await offline.close();
-
-    // Clone only the necessary candidate/build files; stale bytes are rejected without editing the real candidate.
-    const stale = fs.mkdtempSync(path.join(os.tmpdir(), 'native-stale-')); temporary.push(stale);
-    for (const item of ['prototype.json', 'inputs', 'requirements-map.json', 'app', 'mocks', 'design-system']) fs.cpSync(path.join(directory, item), path.join(stale, item), { recursive: true, filter: file => !file.split(path.sep).includes('node_modules') });
-    fs.mkdirSync(path.join(stale, 'builds'), { recursive: true });
-    fs.cpSync(preview.build.directory, path.join(stale, 'builds', preview.build.buildId), { recursive: true });
-    fs.appendFileSync(path.join(stale, 'app/src/App.vue'), '\n<!-- changed candidate, old build -->\n');
-    assert.throws(() => lib.verifyBuild(stale, preview.build.buildId), /old candidate|旧构建/);
-    observations.staleBuildRejected = true;
-
-    const allRequired = [...required.requiredScenarios, ...required.frameworkScenarios];
-    for (const id of allRequired) assert.ok(journeys.some(item => item.id === id), `Required scenario has no executed assertions: ${id}`);
-    assert.equal(lib.manifest(directory).digest, before.digest, 'Candidate changed during browser acceptance');
-    assert.deepEqual(consoleErrors, []);
-    assert.deepEqual(consoleWarnings, []);
-    const trace = `${runRelative}/trace.zip`;
-    await context.tracing.stop({ path: path.join(directory, trace) }); traceSaved = true;
-    const report = { id: runId, status: 'passed', candidateDigest: before.digest, revision: before.revision, buildId: preview.build.buildId, buildDigest: preview.build.buildDigest, previewBaseURL: preview.url, baseUrl: preview.url, observedResources: responses, executor: options.executor || process.env.PILOT_EXECUTOR || 'prototype-native-browser', tool: `Playwright ${runtime.version}; ${options.browserChannel || process.env.PILOT_BROWSER_CHANNEL || 'chrome'} ${browser.version()}; ${os.platform()} ${os.release()}`, startedAt, completedAt: new Date().toISOString(), source, consoleErrors, consoleWarnings, journeys, screenshots, trace, viewports: observations.viewports, observations };
-    fs.writeFileSync(path.join(runRoot, 'observations.json'), JSON.stringify(observations, null, 2));
-    const result = lib.recordRun(directory, report);
-    return { ...result, report: path.join(runRoot, 'report.json'), journeys: journeys.length };
-  } catch (error) {
-    if (!traceSaved) { await context.tracing.stop({ path: path.join(runRoot, 'failure-trace.zip') }).catch(() => {}); traceSaved = true; }
-    await page.screenshot({ path: path.join(runRoot, 'failure.png'), fullPage: true }).catch(() => {});
-    fs.writeFileSync(path.join(runRoot, 'failure.json'), JSON.stringify({ error: error.stack, journeys, observations, consoleErrors, consoleWarnings }, null, 2));
-    throw error;
-  } finally {
-    await context.close(); await browser.close();
-    await new Promise(resolve => preview.server.close(resolve));
-    for (const folder of temporary) fs.rmSync(folder, { recursive: true, force: true });
-  }
-}
-
-function resolvePlaywright(directory, options = {}) {
-  const explicit = options.playwrightModule || process.env.PLAYWRIGHT_MODULE;
-  const root = path.resolve(directory), project = path.resolve(root, '../..');
-  const locations = require('./prototype-locations.cjs');
-  const context = explicit ? null : locations.resolveLocations({ ...options, project });
-  const prepared = context ? locations.toolBases(context).flatMap(([base]) => [path.join(base, 'tools/i3-prototype/playwright'), path.join(base, 'tools/i3-prototype')]) : [];
-  const search = [...prepared, path.join(project, '.prototype-tools'), path.join(root, 'app'), root, project];
-  // Resolve existing package directories individually: Node caches name-based
-  // lookups, which can otherwise hide a newly prepared local tool provider.
-  const candidates = explicit ? [explicit] : search.flatMap(base => ['playwright', 'playwright-core'].map(name => path.join(base, 'node_modules', name))).filter(file => fs.existsSync(file));
-  const errors = [];
-  for (const candidate of candidates) {
-    try {
-      const modulePath = require.resolve(candidate, { paths: search });
-      let folder = path.dirname(modulePath), found;
-      while (folder !== path.dirname(folder)) {
-        const file = path.join(folder, 'package.json');
-        if (fs.existsSync(file)) {
-          const data = read(file);
-          if (['playwright', 'playwright-core'].includes(data.name)) { found = { modulePath, packageRoot: folder, name: data.name, version: data.version }; break; }
-        }
-        folder = path.dirname(folder);
-      }
-      assert.ok(found, 'Provider must be an existing Playwright package');
-      return found;
-    } catch (error) { errors.push(error.message.split('\n')[0]); }
-  }
-  throw new Error(`Existing Playwright provider required / 缺少已安装浏览器模块。Use --playwright-module <existing package path> or install it only with separate authorization. ${errors.join('; ')}`);
-}
-
-async function main(directory, options = {}) {
-  assert.ok(!read(path.join(directory,'prototype.json')).runtime?.contentReference,
-    'This regression runner targets historical device-list inputs only. Verify business acceptance.json with i3-browser-testing-with-devtools and record-run; do not reuse device scenarios.');
-  directory = path.resolve(directory);
-  const before = lib.manifest(directory), owner = `browser-${crypto.randomUUID()}`;
-  // A browser run writes QA and verification metadata, so it owns this candidate
-  // for the whole run. Competing revisions cannot race its evidence publication.
-  lib.claim(directory, { owner, expectedRevision: before.revision, expectedDigest: before.digest });
-  try {
-    assert.equal(lib.inspect(directory).status, 'passed', 'Native structure must pass before browser acceptance');
-    lib.inspectDesignReview(directory, before);
-    const input = options.expectedCategories || process.env.PILOT_EXPECTED_CATEGORIES;
-    if (input) {
-      const categories = typeof input === 'string' ? JSON.parse(input) : input;
-      assert.ok(Array.isArray(categories) && categories.length && categories.every(value => typeof value === 'string' && value.trim()), 'expectedCategories must be a nonempty JSON string array');
-      options = { ...options, expectedCategories: categories };
-    }
-    return await run(directory, options, resolvePlaywright(directory, options));
-  } finally { lib.release(directory, owner); }
-}
-
-if (require.main === module) {
-  if (!process.argv[2]) { process.stderr.write('Usage: node native-browser.cjs <prototype-directory> [PLAYWRIGHT_MODULE=existing-package]\n'); process.exitCode = 1; }
-  else main(process.argv[2]).then(result => process.stdout.write(JSON.stringify(result, null, 2) + '\n')).catch(error => { process.stderr.write(JSON.stringify({ status: 'failed', operation: 'browser', errors: [error.message] }) + '\n'); process.exitCode = 1; });
-}
-module.exports = { main, resolvePlaywright, paginationPlan, themePlan, paginationFocusPlan };