@12ui/design 0.2.28 → 0.2.30

package/dist/prototype-runner.js

@@ -0,0 +1,159 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { evaluatePrototypeGates } from './prototype-gates.js';
+import { prototypeLabelRequests } from './prototype-requests.js';
+import { runPrototypeStage } from './prototype-process.js';
+import { prototypeSourceDirectory } from './prototype-source.js';
+import { BRANCH_COMPLETION_FILENAME, BRANCH_PLAN_FILENAME } from './branch-run-record.js';
+export const PROTOTYPE_MANIFEST_FILENAME = 'proto-manifest.json';
+export const PROTOTYPE_DIRECTORY = 'prototype';
+export const PROTOTYPE_WORK_DIRECTORY = '.prototype-work';
+export const PROTOTYPE_PIPELINE_REVISION = 'prototype-v2';
+const kitDirectory = () => path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../prototype-kit');
+export const runPrototypePipeline = async (args) => {
+    const branchDir = path.resolve(args.branchDir);
+    const sourceDir = await prototypeSourceDirectory(branchDir);
+    const planPath = path.join(sourceDir, BRANCH_PLAN_FILENAME);
+    const completionPath = path.join(branchDir, BRANCH_COMPLETION_FILENAME);
+    const completion = JSON.parse(await readFile(completionPath, 'utf8'));
+    if (typeof completion.runId !== 'string' || !completion.runId) {
+        throw new Error(`Prototype input error: ${completionPath} has no create run id.`);
+    }
+    const kit = kitDirectory();
+    const workDir = path.join(branchDir, PROTOTYPE_WORK_DIRECTORY);
+    const labelsDir = path.join(workDir, 'labels');
+    const inventoryFile = path.join(workDir, 'inventory.json');
+    const modelFile = path.join(workDir, 'model.json');
+    const runtimeAuditFile = path.join(workDir, 'runtime-audit.json');
+    const gateAuditFile = path.join(workDir, 'gate-audit.json');
+    const stagingDir = path.join(branchDir, `.prototype-${randomUUID()}.tmp`);
+    const outputDir = path.join(branchDir, PROTOTYPE_DIRECTORY);
+    await rm(workDir, { recursive: true, force: true });
+    await mkdir(labelsDir, { recursive: true });
+    await mkdir(stagingDir, { recursive: true });
+    const stages = [];
+    try {
+        stages.push(await runPrototypeStage({
+            stage: 'inventory',
+            script: path.join(kit, 'inventory.mjs'),
+            argv: [sourceDir, inventoryFile],
+            workDir,
+            ...(args.signal ? { signal: args.signal } : {}),
+        }));
+        stages.push(await runPrototypeStage({
+            stage: 'analyze',
+            script: path.join(kit, 'analyze.mjs'),
+            argv: [inventoryFile, modelFile],
+            workDir,
+            ...(args.signal ? { signal: args.signal } : {}),
+        }));
+        const model = JSON.parse(await readFile(modelFile, 'utf8'));
+        const requests = prototypeLabelRequests(model);
+        let labelCostMicros = 0;
+        let labeledScreenCount = 0;
+        if (args.labelClient) {
+            for (const request of requests) {
+                const response = await args.labelClient.labelScreen(completion.runId, request, args.signal);
+                labelCostMicros += response.costMicros;
+                labeledScreenCount += 1;
+                await writeFile(path.join(labelsDir, `${request.screen.id}.json`), `${JSON.stringify({ actions: response.actions }, null, 2)}\n`);
+            }
+        }
+        stages.push(await runPrototypeStage({
+            stage: 'build',
+            script: path.join(kit, 'build.mjs'),
+            argv: [sourceDir, inventoryFile, modelFile, labelsDir, stagingDir],
+            workDir,
+            ...(args.signal ? { signal: args.signal } : {}),
+        }));
+        stages.push(await runPrototypeStage({
+            stage: 'runtime',
+            script: path.join(kit, 'verify-runtime.mjs'),
+            argv: [stagingDir, runtimeAuditFile],
+            workDir,
+            ...(args.signal ? { signal: args.signal } : {}),
+        }));
+        const manifestPath = path.join(stagingDir, PROTOTYPE_MANIFEST_FILENAME);
+        const kitManifest = JSON.parse(await readFile(manifestPath, 'utf8'));
+        const inventory = JSON.parse(await readFile(inventoryFile, 'utf8'));
+        const runtimeAudit = JSON.parse(await readFile(runtimeAuditFile, 'utf8'));
+        const evaluation = evaluatePrototypeGates(kitManifest);
+        const planStatus = Array.isArray(inventory.plan?.pages) && Array.isArray(inventory.plan?.screens)
+            ? 'passed'
+            : 'accepted-partial';
+        const gates = {
+            exportedHtml: 'passed',
+            branchPlan: planStatus,
+            semanticViewportSections: 'passed',
+            runtime: 'passed',
+            zeroActionRealPages: evaluation.facts.zeroActionRealPages.length > 0 ? 'failed' : 'passed',
+            dropdownValidity: evaluation.facts.invalidDropdowns > 0 ? 'failed' : 'passed',
+            holdingRatio: evaluation.facts.holdingRatio > 0.5 ? 'failed' : 'passed',
+        };
+        await writeFile(gateAuditFile, `${JSON.stringify({
+            version: 1,
+            revision: PROTOTYPE_PIPELINE_REVISION,
+            input: {
+                exportedHtmlFiles: Array.isArray(inventory.pages) ? inventory.pages.length : 0,
+                semanticViewportSections: model.states.length,
+                planStatus,
+            },
+            gates,
+            facts: evaluation.facts,
+            warnings: evaluation.warnings,
+            blockers: evaluation.blockers,
+        }, null, 2)}\n`);
+        if (evaluation.blockers.length > 0) {
+            throw new Error(`Prototype product gate failed: ${evaluation.blockers.join(' ')}`);
+        }
+        await writeFile(manifestPath, `${JSON.stringify({
+            ...kitManifest,
+            version: 1,
+            revision: PROTOTYPE_PIPELINE_REVISION,
+            source: { branchDir, sourceDir, runId: completion.runId, planPath },
+            input: {
+                exportedHtmlFiles: Array.isArray(inventory.pages) ? inventory.pages.length : 0,
+                semanticViewportSections: model.states.length,
+                planStatus,
+            },
+            labels: {
+                requestedScreens: requests.length,
+                labeledScreens: labeledScreenCount,
+                costMicros: labelCostMicros,
+                precedence: 'deterministic navigation and dropdown rules override model labels',
+            },
+            gates,
+            runtime: {
+                auditPath: runtimeAuditFile,
+                pageCount: runtimeAudit.pages.length,
+                pageErrors: runtimeAudit.pageErrors,
+                consoleErrors: runtimeAudit.consoleErrors,
+                duplicateIds: runtimeAudit.duplicateIds,
+                brokenTargets: runtimeAudit.brokenTargets.length,
+                interactionFailures: runtimeAudit.interactionFailures,
+                deepLinkBack: runtimeAudit.deepLinkBack,
+            },
+            facts: evaluation.facts,
+            warnings: evaluation.warnings,
+        }, null, 2)}\n`);
+        await rm(outputDir, { recursive: true, force: true });
+        await rename(stagingDir, outputDir);
+        return {
+            branchDir,
+            outputDir,
+            manifestPath: path.join(outputDir, PROTOTYPE_MANIFEST_FILENAME),
+            stages,
+            screenCount: model.states.length,
+            labeledScreenCount,
+            labelCostMicros,
+            warnings: evaluation.warnings,
+        };
+    }
+    catch (error) {
+        await rm(stagingDir, { recursive: true, force: true });
+        throw error;
+    }
+};
+//# sourceMappingURL=prototype-runner.js.map

package/dist/prototype-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-runner.js","sourceRoot":"","sources":["../src/prototype-runner.ts"],"names":[],"mappings":"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"}

package/dist/prototype-source.d.ts

@@ -0,0 +1,9 @@
+export declare const PROTOTYPE_SOURCES_DIRECTORY = "prototype-sources";
+export declare const prototypeSourceDirectory: (branchDir: string) => Promise<string>;
+/**
+ * A filled holding page extends a private source copy. The shipped branch
+ * plan/pages stay immutable evidence; every later fill resumes from this one
+ * overlay instead of copying the original again and losing earlier gaps.
+ */
+export declare const preparePrototypeSourceOverlay: (branchDir: string) => Promise<string>;
+//# sourceMappingURL=prototype-source.d.ts.map

package/dist/prototype-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-source.d.ts","sourceRoot":"","sources":["../src/prototype-source.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAU/D,eAAO,MAAM,wBAAwB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,CAIhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,CA4BrF,CAAC"}

package/dist/prototype-source.js

@@ -0,0 +1,48 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { cp, mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { BRANCH_PLAN_FILENAME, BRANCH_PAGES_DIRECTORY } from './branch-run-record.js';
+export const PROTOTYPE_SOURCES_DIRECTORY = 'prototype-sources';
+const exists = async (target) => (stat(target).then(() => true).catch(() => false));
+const sha256 = (bytes) => (createHash('sha256').update(bytes).digest('hex'));
+export const prototypeSourceDirectory = async (branchDir) => {
+    const resolved = path.resolve(branchDir);
+    const overlay = path.join(resolved, PROTOTYPE_SOURCES_DIRECTORY);
+    return await exists(path.join(overlay, BRANCH_PLAN_FILENAME)) ? overlay : resolved;
+};
+/**
+ * A filled holding page extends a private source copy. The shipped branch
+ * plan/pages stay immutable evidence; every later fill resumes from this one
+ * overlay instead of copying the original again and losing earlier gaps.
+ */
+export const preparePrototypeSourceOverlay = async (branchDir) => {
+    const resolved = path.resolve(branchDir);
+    const overlay = path.join(resolved, PROTOTYPE_SOURCES_DIRECTORY);
+    if (await exists(path.join(overlay, BRANCH_PLAN_FILENAME)))
+        return overlay;
+    const plan = await readFile(path.join(resolved, BRANCH_PLAN_FILENAME));
+    const pages = path.join(resolved, BRANCH_PAGES_DIRECTORY);
+    if (!(await exists(pages)))
+        throw new Error(`Prototype source pages do not exist: ${pages}`);
+    const staging = path.join(resolved, `.${PROTOTYPE_SOURCES_DIRECTORY}-${randomUUID()}.tmp`);
+    try {
+        await mkdir(staging, { recursive: true });
+        await writeFile(path.join(staging, BRANCH_PLAN_FILENAME), plan, { flag: 'wx', mode: 0o600 });
+        await cp(pages, path.join(staging, BRANCH_PAGES_DIRECTORY), {
+            recursive: true,
+            errorOnExist: true,
+            force: false,
+        });
+        await writeFile(path.join(staging, 'source.json'), `${JSON.stringify({
+            version: 1,
+            branchDir: resolved,
+            basePlanSha256: sha256(plan),
+        }, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+        await rename(staging, overlay);
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+    return overlay;
+};
+//# sourceMappingURL=prototype-source.js.map

package/dist/prototype-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-source.js","sourceRoot":"","sources":["../src/prototype-source.ts"],"names":[],"mappings":"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"}

package/dist/review-discovery.d.ts

@@ -0,0 +1,11 @@
+import type { ReviewModel, ReviewRun } from './review-types.js';
+export declare const discoverReviewModel: (args: {
+    target?: string;
+    all?: boolean;
+    cwd?: string;
+    tempRoot?: string;
+    editAvailable?: boolean;
+    prototypeAvailable?: boolean;
+}) => Promise<ReviewModel>;
+export declare const reviewFileUrl: (run: ReviewRun, file: string) => string;
+//# sourceMappingURL=review-discovery.d.ts.map

package/dist/review-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-discovery.d.ts","sourceRoot":"","sources":["../src/review-discovery.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAIV,WAAW,EAGX,SAAS,EACV,MAAM,mBAAmB,CAAC;AAma3B,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,KAAG,OAAO,CAAC,WAAW,CA+BtB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,EAAE,MAAM,MAAM,KAAG,MAM5D,CAAC"}