@vmz/test 0.0.2 → 0.0.3

package/README.md

@@ -26,24 +26,29 @@ safe server boundaries, SSR that does not needlessly replay, and application beh
 
 ## One scenario, several kinds of evidence
 
-| Surface | Evidence VMZ can collect |
-|---|---|
-| Compile | Diagnostics, graph identities, and generated boundaries |
-| Logic | State transitions, derived work, and cancellation |
-| Browser | Real input, semantic locators, DOM, accessibility, and screenshots |
-| Router | Matched RouteId, layout retention, loading, errors, and disposal |
-| SSR / Resume | HTML, serialized state, event entries, and replay avoidance |
-| Deployment | Client/server reachability, capabilities, artifacts, and traces |
+| Surface      | Evidence VMZ can collect                                           |
+|--------------|--------------------------------------------------------------------|
+| Compile      | Diagnostics, graph identities, and generated boundaries            |
+| Logic        | State transitions, derived work, and cancellation                  |
+| Browser      | Real input, semantic locators, DOM, accessibility, and screenshots |
+| Router       | Matched RouteId, layout retention, loading, errors, and disposal   |
+| SSR / Resume | HTML, serialized state, event entries, and replay avoidance        |
+| Deployment   | Client/server reachability, capabilities, artifacts, and traces    |
 
 ### UI automation without a borrowed worldview
 
-VMZ can use a real browser protocol as transport while owning locator, action, waiting, and expectation semantics. Tests can find elements by role, label, text, RouteId, or stable test identity; CSS remains an escape hatch rather than the default contract.
+VMZ can use a real browser protocol as transport while owning locator, action, waiting, and expectation semantics. Tests
+can find elements by role, label, text, RouteId, or stable test identity; CSS remains an escape hatch rather than the
+default contract.
 
-Auto-waiting can observe navigation, pending work, region commits, and server activity instead of guessing with arbitrary delays. A failure can connect the visible symptom to the application work that produced it.
+Auto-waiting can observe navigation, pending work, region commits, and server activity instead of guessing with
+arbitrary delays. A failure can connect the visible symptom to the application work that produced it.
 
 ### Precision is testable
 
-A fine-grained compiler should prove that nothing unrelated ran. VMZ tests can check that the intended binding changed, unrelated computations stayed idle, an obsolete generation was cancelled, and a disposed owner received no late write. That turns testing into a competitive feature rather than a bundled convenience.
+A fine-grained compiler should prove that nothing unrelated ran. VMZ tests can check that the intended binding changed,
+unrelated computations stayed idle, an obsolete generation was cancelled, and a disposed owner received no late write.
+That turns testing into a competitive feature rather than a bundled convenience.
 
 ## License
 

package/dist/browser.d.ts

@@ -1,12 +1,11 @@
 /**
- * Browser Host for `vmz test --mode browser` (T2 close slice).
+ * Browser Host for `vmz test --mode browser` ( close slice).
  *
  * Real Chromium/Chrome via CDP. Transport may use puppeteer-core as a CDP
  * client — that is NOT the Playwright/Puppeteer *test model*. Manifest actions
  * and assertions remain the VMZ Browser Host protocol; same Direct schedule as
  * production (`__vmzCreate` in a real document).
  *
- * Design: 规划设计/vmz/16 §T2 · §5 浏览器连接
  */
 type Diag = {
     severity: string;

package/dist/browser.js

@@ -1,12 +1,11 @@
 /**
- * Browser Host for `vmz test --mode browser` (T2 close slice).
+ * Browser Host for `vmz test --mode browser` ( close slice).
  *
  * Real Chromium/Chrome via CDP. Transport may use puppeteer-core as a CDP
  * client — that is NOT the Playwright/Puppeteer *test model*. Manifest actions
  * and assertions remain the VMZ Browser Host protocol; same Direct schedule as
  * production (`__vmzCreate` in a real document).
  *
- * Design: 规划设计/vmz/16 §T2 · §5 浏览器连接
  */
 import { spawn } from 'node:child_process';
 import fs from 'node:fs';

package/dist/compile.d.ts

@@ -1,5 +1,5 @@
 /**
- * Compile-mode host for `vmz test` / `@vmz/test` (T1+).
+ * Compile-mode host for `vmz test` / `@vmz/test` (+).
  * Builds the project and checks graph/plan/view assertions against dist artifacts.
  */
 export type CreateWorkspaceFn = (opts: {

package/dist/compile.js

@@ -1,5 +1,5 @@
 /**
- * Compile-mode host for `vmz test` / `@vmz/test` (T1+).
+ * Compile-mode host for `vmz test` / `@vmz/test` (+).
  * Builds the project and checks graph/plan/view assertions against dist artifacts.
  */
 import fs from 'node:fs';
@@ -256,7 +256,7 @@ export function runCompileManifest(manifest, ctx) {
                 }
                 if (expect.noRender === true || expect.noRenderFallback === true) {
                     if (clientJs.includes('prototype.render')) {
-                        fail('production client must not emit prototype.render (Gate 3)');
+                        fail('production client must not emit prototype.render (production Direct emit)');
                     }
                 }
                 if (typeof expect.includes === 'string' && !clientJs.includes(expect.includes)) {

package/dist/deployment.d.ts

@@ -1,5 +1,5 @@
 /**
- * Deployment host for `vmz test --mode deployment` (T3).
+ * Deployment host for `vmz test --mode deployment` .
  * Proves deployment IR + server capability isolation (client stubs vs #server body).
  */
 type Diag = {

package/dist/deployment.js

@@ -1,5 +1,5 @@
 /**
- * Deployment host for `vmz test --mode deployment` (T3).
+ * Deployment host for `vmz test --mode deployment` .
  * Proves deployment IR + server capability isolation (client stubs vs #server body).
  */
 import fs from 'node:fs';

package/dist/discover.d.ts

@@ -1,5 +1,5 @@
 /**
- * Discover VMZ native test manifests (T0).
+ * Discover VMZ native test manifests .
  */
 export declare function listManifestFiles(root: string): string[];
 export type DiscoveredManifest = Record<string, unknown> & {

package/dist/discover.js

@@ -1,5 +1,5 @@
 /**
- * Discover VMZ native test manifests (T0).
+ * Discover VMZ native test manifests .
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/logic.d.ts

@@ -1,6 +1,5 @@
 /**
  * Logic-mode host — headless document (linkedom), same Direct __vmzCreate as production.
- * Design: 规划设计/vmz/16 — not Browser Host / Playwright.
  */
 export declare function installHeadlessDocument(): Document;
 export type LogicHost = {

package/dist/logic.js

@@ -1,6 +1,5 @@
 /**
  * Logic-mode host — headless document (linkedom), same Direct __vmzCreate as production.
- * Design: 规划设计/vmz/16 — not Browser Host / Playwright.
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/protocol.d.ts

@@ -1,7 +1,6 @@
 /**
- * VMZ native test protocol (T0) — validators + report builders.
+ * VMZ native test protocol — validators + report builders.
  * Schema ids live in `@vmz/protocol` (mirrors Rust `vmz-protocol`).
- * Design: 规划设计/vmz/16 — not a Test IR; references Program Graph + Execution Plan.
  */
 export { EXECUTION_PLAN_REF_SCHEMA, PLAN_SCHEMA, TEST_ACTION_SCHEMA, TEST_ASSERTION_SCHEMA, TEST_MANIFEST_SCHEMA, TEST_PROTOCOL, TEST_REPORT_SCHEMA, testCatalog, } from '@vmz/protocol';
 export type TestMode = 'compile' | 'logic' | 'browser' | 'ssr' | 'resume' | 'deployment' | 'all';
@@ -16,7 +15,7 @@ export type ManifestValidation = {
     ok: false;
     error: string;
 };
-/** Validate a discovered manifest object (narrow T0 checks). */
+/** Validate a discovered manifest object (narrow checks). */
 export declare function validateManifest(raw: unknown, file: string): ManifestValidation;
 export type TestReportEntryInput = {
     testId: string;

package/dist/protocol.js

@@ -1,7 +1,6 @@
 /**
- * VMZ native test protocol (T0) — validators + report builders.
+ * VMZ native test protocol — validators + report builders.
  * Schema ids live in `@vmz/protocol` (mirrors Rust `vmz-protocol`).
- * Design: 规划设计/vmz/16 — not a Test IR; references Program Graph + Execution Plan.
  */
 import { EXECUTION_PLAN_REF_SCHEMA, PLAN_SCHEMA, TEST_MANIFEST_SCHEMA, TEST_REPORT_SCHEMA } from '@vmz/protocol';
 export { EXECUTION_PLAN_REF_SCHEMA, PLAN_SCHEMA, TEST_ACTION_SCHEMA, TEST_ASSERTION_SCHEMA, TEST_MANIFEST_SCHEMA, TEST_PROTOCOL, TEST_REPORT_SCHEMA, testCatalog, } from '@vmz/protocol';
@@ -26,7 +25,7 @@ export function parseModes(raw) {
     }
     return parts;
 }
-/** Validate a discovered manifest object (narrow T0 checks). */
+/** Validate a discovered manifest object (narrow checks). */
 export function validateManifest(raw, file) {
     if (!raw || typeof raw !== 'object') {
         return { ok: false, error: `${file}: manifest must be an object` };

package/dist/resume.d.ts

@@ -1,5 +1,5 @@
 /**
- * Resume host for `vmz test --mode resume` (T2/T3 first slice).
+ * Resume host for `vmz test --mode resume` (/ first slice).
  * SSR shell → resume adopt → event patch; onMount must not run.
  */
 type Diag = {

package/dist/resume.js

@@ -1,5 +1,5 @@
 /**
- * Resume host for `vmz test --mode resume` (T2/T3 first slice).
+ * Resume host for `vmz test --mode resume` (/ first slice).
  * SSR shell → resume adopt → event patch; onMount must not run.
  */
 import path from 'node:path';
@@ -138,7 +138,7 @@ export async function runResumeManifest(manifest, ctx) {
                 }
                 island = el;
                 el.click();
-                // EventEntry resume is async via Promise.resolve(fn()).
+                // EventEntry resume is async via Promise.resolve(fn).
                 await Promise.resolve();
                 await Promise.resolve();
                 await new Promise((r) => setTimeout(r, Number(a.waitMs ?? 10)));

package/dist/ssr.d.ts

@@ -1,5 +1,5 @@
 /**
- * SSR / hydrate / stream host for `vmz test --mode ssr` (T2).
+ * SSR / hydrate / stream host for `vmz test --mode ssr` .
  * Same Direct schedule as production via linkedom + renderToString / renderToStream / hydrate.
  */
 type Diag = {

package/dist/ssr.js

@@ -1,5 +1,5 @@
 /**
- * SSR / hydrate / stream host for `vmz test --mode ssr` (T2).
+ * SSR / hydrate / stream host for `vmz test --mode ssr` .
  * Same Direct schedule as production via linkedom + renderToString / renderToStream / hydrate.
  */
 import path from 'node:path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/test",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "VMZ native test protocol + Compile/Logic/Browser/SSR/Resume/Deployment hosts",
   "main": "./dist/index.js",
@@ -21,15 +21,14 @@
   },
   "files": [
     "dist",
-    "src",
     "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@vmz/core": "0.0.2",
-    "@vmz/protocol": "0.0.2",
+    "@vmz/core": "0.0.3",
+    "@vmz/protocol": "0.0.3",
     "linkedom": "^0.18.13",
     "puppeteer-core": "^24.11.2"
   },