create-aura3d 1.4.2 → 1.4.4

package/README.md

@@ -40,8 +40,8 @@ npx create-aura3d@latest --help
   code renders `model(assets.product)` instead of guessed URLs or string IDs.
 - **AI output stays maintainable.** Coding agents can generate scenes while
   developers keep normal TypeScript, package scripts, and browser tests.
-- **Proof is part of the starter.** Route-health, screenshot, gameplay, or
-  template checks are included where the template needs them.
+- **Proof is part of the starter.** Route-health, screenshot, gameplay, composition, generated geometry-contract, or template checks are included where the template needs them.
+- **Game routes fail closed.** Public racing/platformer generation uses certified assets and compiler-emitted geometry contracts rather than guessed route-local rectangles or centerlines.
 - **Static deploys are first-class.** Build output is a browser app you can
   deploy like any Vite project.
 

package/dist/index.d.ts

@@ -13,4 +13,8 @@ export interface CreateA3DProjectResult {
 }
 export declare function createA3DProject(options: CreateA3DProjectOptions): CreateA3DProjectResult;
 export declare function writeCreateA3DReport(path: string, result: CreateA3DProjectResult): void;
+export { probeShowcaseGameGeometry, type ShowcaseGameGeometryCategory, type ShowcaseGameGeometryProbeResult } from "./showcase-spec-game-geometry-probe.js";
+export type { ExtractOptions as ShowcaseGameGeometryExtractOptions, GeometryExtractionFailure as ShowcaseGameGeometryExtractionFailure, GeometryExtractionResult as ShowcaseGameGeometryExtractionResult, GeometryExtractionSuccess as ShowcaseGameGeometryExtractionSuccess } from "./showcase-spec-game-geometry-extractor.js";
+export type { ShowcasePlatformerPlayableSurfaceMap, ShowcaseRacingTrackTopology } from "./showcase-spec-types.js";
+export { SHOWCASE_ASSET_PAIR_COMPOSITION_THRESHOLDS, validateShowcaseAssetPairComposition, validateShowcaseAssetPairCompositionFromDisk, type ShowcaseAssetPairCompositionCategory, type ShowcaseAssetPairCompositionCheck, type ShowcaseAssetPairCompositionInput, type ShowcaseAssetPairCompositionReport, type ValidateShowcaseAssetPairCompositionFromDiskOptions } from "./showcase-spec-asset-pair-composition.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,kgBAoB1B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6BzF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,kgBAoB1B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6BzF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGvF;AA0BD,OAAO,EACL,yBAAyB,EACzB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACrC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,cAAc,IAAI,kCAAkC,EACpD,yBAAyB,IAAI,qCAAqC,EAClE,wBAAwB,IAAI,oCAAoC,EAChE,yBAAyB,IAAI,qCAAqC,EACnE,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,oCAAoC,EACpC,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,0CAA0C,EAC1C,oCAAoC,EACpC,4CAA4C,EAC5C,KAAK,oCAAoC,EACzC,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,kCAAkC,EACvC,KAAK,mDAAmD,EACzD,MAAM,2CAA2C,CAAC"}

package/dist/index.js

@@ -41,7 +41,7 @@ export function createA3DProject(options) {
     const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
     packageJson.dependencies = {
         ...(packageJson.dependencies ?? {}),
-        "@aura3d/engine": options.packageVersion ?? packageJson.dependencies?.["@aura3d/engine"] ?? "1.4.2"
+        "@aura3d/engine": options.packageVersion ?? packageJson.dependencies?.["@aura3d/engine"] ?? "1.4.4"
     };
     writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
     return {
@@ -80,4 +80,6 @@ function findDefaultTemplateRoot() {
     }
     return process.cwd();
 }
+export { probeShowcaseGameGeometry } from "./showcase-spec-game-geometry-probe.js";
+export { SHOWCASE_ASSET_PAIR_COMPOSITION_THRESHOLDS, validateShowcaseAssetPairComposition, validateShowcaseAssetPairCompositionFromDisk } from "./showcase-spec-asset-pair-composition.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/showcase-spec-artifacts.d.ts

@@ -1,5 +1,6 @@
 import type { ShowcaseCategoryPlan, ShowcaseSpec, ShowcaseSpecFinalStatus } from "./showcase-spec-types.js";
 export declare function createRouteSource(spec: ShowcaseSpec): string;
+export declare function createRouteArtifacts(spec: ShowcaseSpec): Readonly<Record<string, string>>;
 export declare function createReadme(spec: ShowcaseSpec, finalStatus: ShowcaseSpecFinalStatus, blockers: readonly string[]): string;
 export declare function createRouteHealth(spec: ShowcaseSpec, finalStatus: ShowcaseSpecFinalStatus, blockers: readonly string[]): {
     categoryPlan?: ShowcaseCategoryPlan | undefined;
@@ -12,6 +13,7 @@ export declare function createRouteHealth(spec: ShowcaseSpec, finalStatus: Showc
         routePrimaryProbe: string | undefined;
         screenshotSha256: string | undefined;
         geometryEvidence: import("./showcase-spec-types.js").ShowcaseGameGeometryEvidence | undefined;
+        compositionReport: string | undefined;
         verdict: import("./showcase-spec-types.js").ShowcaseGameAssetPairEvidenceVerdict;
         notes: string;
         blockers: readonly string[];
@@ -49,6 +51,7 @@ export declare function createRouteHealth(spec: ShowcaseSpec, finalStatus: Showc
     blockers: readonly string[];
     evidence: {
         releaseAssetProbes?: Readonly<Record<string, string>> | undefined;
+        visualReviewPassed?: boolean | undefined;
         gameplayPassed?: boolean | undefined;
         gameplayProof?: string | undefined;
         global: string;
@@ -98,6 +101,8 @@ export declare function createEvidenceChecklist(spec: ShowcaseSpec, finalStatus:
         readonly routePrimaryPassed: boolean;
         readonly gameplayProof?: string;
         readonly gameplayPassed?: boolean;
+        readonly visualReviewPassed?: boolean;
+        readonly assetPairCompositionReport?: string;
         readonly releaseAssetProbes?: Readonly<Record<string, string>>;
     };
     capabilities: readonly import("./showcase-spec-types.js").ShowcaseSpecCapability[];

package/dist/showcase-spec-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"showcase-spec-artifacts.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAEZ,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAM5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1H;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CtH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB;;;;;;;;;;;;;;;;;EAiB5F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;EAa5H"}
+{"version":3,"file":"showcase-spec-artifacts.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-artifacts.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAEZ,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAM5D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAMzF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1H;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CtH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB;;;;;;;;;;;;;;;;;EAiB5F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;EAa5H"}

package/dist/showcase-spec-artifacts.js

@@ -1,6 +1,6 @@
 import { cameraForCategoryPlan } from "./showcase-spec-category-plan.js";
-import { createPlatformerRouteSource } from "./showcase-spec-platformer-artifacts.js";
-import { createRacingRouteSource } from "./showcase-spec-racing-artifacts.js";
+import { createPlatformerGeometryContractSource, createPlatformerRouteSource } from "./showcase-spec-platformer-artifacts.js";
+import { createRacingGeometryContractSource, createRacingRouteSource } from "./showcase-spec-racing-artifacts.js";
 export function createRouteSource(spec) {
     if (spec.platformer)
         return createPlatformerRouteSource(spec, spec.platformer);
@@ -11,6 +11,13 @@ export function createRouteSource(spec) {
     const heroAsset = requireAsset(spec, spec.layout.heroAsset);
     return createBasicRouteSource(spec, heroAsset);
 }
+export function createRouteArtifacts(spec) {
+    return {
+        "src/main.ts": createRouteSource(spec),
+        ...(spec.platformer ? { "src/generated/game-geometry.ts": createPlatformerGeometryContractSource(spec, spec.platformer) } : {}),
+        ...(spec.racing ? { "src/generated/game-geometry.ts": createRacingGeometryContractSource(spec, spec.racing) } : {})
+    };
+}
 export function createReadme(spec, finalStatus, blockers) {
     return `# ${spec.label}\n\nStatus: ${finalStatus}\n\nClaim label: ${spec.claimLabel}\n\nPrimary asset: ${spec.layout.heroAsset}\n\n${blockers.length === 0 ? "Release evidence is present for this bounded generated route." : `Blocked by:\n${blockers.map((blocker) => `- ${blocker}`).join("\n")}`}\n`;
 }
@@ -107,6 +114,7 @@ function createRouteHealthEvidence(spec) {
         routePrimaryPassed: spec.evidence.routePrimaryPassed,
         ...("gameplayProof" in spec.evidence ? { gameplayProof: spec.evidence.gameplayProof } : {}),
         ...("gameplayPassed" in spec.evidence ? { gameplayPassed: spec.evidence.gameplayPassed } : {}),
+        ...("visualReviewPassed" in spec.evidence ? { visualReviewPassed: spec.evidence.visualReviewPassed } : {}),
         ...("releaseAssetProbes" in spec.evidence ? { releaseAssetProbes: spec.evidence.releaseAssetProbes } : {})
     };
 }
@@ -121,6 +129,7 @@ function createGameAssetPairRouteHealth(spec) {
         routePrimaryProbe: assetPairEvidence.routePrimaryProbe,
         screenshotSha256: assetPairEvidence.screenshotSha256,
         geometryEvidence: assetPairEvidence.geometryEvidence,
+        compositionReport: assetPairEvidence.compositionReport,
         verdict: assetPairEvidence.verdict,
         notes: assetPairEvidence.notes,
         blockers: assetPairEvidence.blockers

package/dist/showcase-spec-artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"showcase-spec-artifacts.js","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-artifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"showcase-spec-artifacts.js","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-artifacts.ts"],"names":[],"mappings":"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"}

package/dist/showcase-spec-asset-pair-composition.d.ts

@@ -0,0 +1,116 @@
+export type ShowcaseAssetPairCompositionCategory = "racing" | "platformer";
+export type ShowcaseAssetPairCompositionCheckId = "binding-overlap" | "contact" | "camera-readability" | "scale-contract" | "debug-guide-absence";
+export interface ShowcaseCompositionRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface ShowcaseAssetPairCompositionThresholds {
+    readonly minBindingOverlapRatio: number;
+    readonly maxContactOffsetRatio: number;
+    readonly maxScreenContactDistanceRatio: number;
+    readonly minPlaySpaceAreaRatio: number;
+    readonly maxPlaySpaceAreaRatio: number;
+    readonly minSubjectWorldRatio: number;
+    readonly maxSubjectWorldRatio: number;
+    readonly maxPlatformerScaleDelta: number;
+}
+export declare const SHOWCASE_ASSET_PAIR_COMPOSITION_THRESHOLDS: ShowcaseAssetPairCompositionThresholds;
+export interface ShowcaseAssetPairCompositionInput {
+    readonly routeId: string;
+    readonly category: ShowcaseAssetPairCompositionCategory;
+    readonly screenshot: {
+        readonly path: string;
+        readonly sha256: string;
+        readonly width: number;
+        readonly height: number;
+        readonly crop: ShowcaseCompositionRect;
+        readonly foregroundBounds: ShowcaseCompositionRect;
+        readonly foregroundClipped: boolean;
+        readonly subjectBounds: ShowcaseCompositionRect;
+        readonly subjectClipped: boolean;
+        readonly projectedPlaySpaceBounds: ShowcaseCompositionRect;
+        readonly projectedContactPoint: {
+            readonly x: number;
+            readonly y: number;
+        };
+        readonly projectedSubjectHeight?: number;
+    };
+    readonly assets: readonly {
+        readonly id: string;
+        readonly manifestHash: string;
+        readonly evidenceHash: string;
+    }[];
+    readonly geometry: {
+        readonly report: string;
+        readonly assetId: string;
+        readonly assetHash: string;
+        readonly source: string;
+        readonly modelAnchorCount: number;
+    };
+    readonly sceneBinding: {
+        readonly assetHash: string;
+        readonly geometryBinding: string;
+        readonly overlay: string;
+        readonly averageBindingError: number;
+        readonly modelPresentationOffset: {
+            readonly x: number;
+            readonly y: number;
+            readonly z: number;
+        };
+    };
+    readonly contact: {
+        readonly proven: boolean;
+        readonly normalizedOffset: number;
+    };
+    readonly camera: {
+        readonly mode: string;
+        readonly followsSubject: boolean;
+    };
+    readonly scale: {
+        readonly characterScaleRatio?: number;
+        readonly projectedTargetHeight?: number;
+    };
+    readonly debugGuidesAbsent: boolean;
+    readonly freshnessFailures?: readonly string[];
+    readonly thresholds?: Partial<ShowcaseAssetPairCompositionThresholds>;
+}
+export interface ShowcaseAssetPairCompositionCheck {
+    readonly id: ShowcaseAssetPairCompositionCheckId;
+    readonly verdict: "pass" | "fail";
+    readonly tolerance: Readonly<Record<string, number | boolean | string>>;
+    readonly measured: Readonly<Record<string, number | boolean | string>>;
+    readonly blockers: readonly string[];
+}
+export interface ShowcaseAssetPairCompositionReport {
+    readonly schema: "aura3d-showcase-asset-pair-composition/1.0";
+    readonly routeId: string;
+    readonly category: ShowcaseAssetPairCompositionCategory;
+    readonly verdict: "pass" | "fail";
+    readonly pass: boolean;
+    readonly screenshot: {
+        readonly path: string;
+        readonly sha256: string;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly geometry: ShowcaseAssetPairCompositionInput["geometry"];
+    readonly assets: ShowcaseAssetPairCompositionInput["assets"];
+    readonly thresholds: ShowcaseAssetPairCompositionThresholds;
+    readonly checks: readonly ShowcaseAssetPairCompositionCheck[];
+    readonly blockers: readonly string[];
+}
+export interface ValidateShowcaseAssetPairCompositionFromDiskOptions {
+    readonly projectDir?: string;
+    readonly routeId: string;
+    readonly category: ShowcaseAssetPairCompositionCategory;
+    readonly routePrimaryProbe: string;
+    readonly gameplayProof: string;
+    readonly geometryReport: string;
+    readonly manifest?: string;
+    readonly outputPath?: string;
+}
+export declare function validateShowcaseAssetPairComposition(input: ShowcaseAssetPairCompositionInput): ShowcaseAssetPairCompositionReport;
+export declare function validateShowcaseAssetPairCompositionFromDisk(options: ValidateShowcaseAssetPairCompositionFromDiskOptions): ShowcaseAssetPairCompositionReport;
+//# sourceMappingURL=showcase-spec-asset-pair-composition.d.ts.map

package/dist/showcase-spec-asset-pair-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-spec-asset-pair-composition.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-asset-pair-composition.ts"],"names":[],"mappings":"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"}

package/dist/showcase-spec-asset-pair-composition.js

@@ -0,0 +1,336 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { mkdirSync } from "node:fs";
+export const SHOWCASE_ASSET_PAIR_COMPOSITION_THRESHOLDS = Object.freeze({
+    minBindingOverlapRatio: 0.02,
+    maxContactOffsetRatio: 1,
+    maxScreenContactDistanceRatio: 0.35,
+    minPlaySpaceAreaRatio: 0.04,
+    maxPlaySpaceAreaRatio: 0.78,
+    minSubjectWorldRatio: 0.08,
+    maxSubjectWorldRatio: 0.78,
+    maxPlatformerScaleDelta: 0.18
+});
+export function validateShowcaseAssetPairComposition(input) {
+    const thresholds = { ...SHOWCASE_ASSET_PAIR_COMPOSITION_THRESHOLDS, ...(input.thresholds ?? {}) };
+    const cropArea = area(input.screenshot.crop);
+    const playSpaceAreaRatio = ratio(area(input.screenshot.projectedPlaySpaceBounds), cropArea);
+    const subjectWorldRatio = ratio(input.screenshot.subjectBounds.height, input.screenshot.crop.height);
+    const overlapRatio = input.screenshot.subjectClipped
+        ? 0
+        : input.category === "platformer"
+            ? horizontalIntersectionRatio(input.screenshot.subjectBounds, input.screenshot.projectedPlaySpaceBounds)
+            : intersectionRatio(input.screenshot.subjectBounds, input.screenshot.projectedPlaySpaceBounds);
+    const subjectBase = {
+        x: input.screenshot.subjectBounds.x + input.screenshot.subjectBounds.width / 2,
+        y: input.screenshot.subjectBounds.y + input.screenshot.subjectBounds.height
+    };
+    const screenContactDistance = Math.hypot(subjectBase.x - input.screenshot.projectedContactPoint.x, subjectBase.y - input.screenshot.projectedContactPoint.y);
+    const screenContactDistanceRatio = ratio(screenContactDistance, input.screenshot.subjectBounds.height);
+    const bindingBlocker = input.category === "racing"
+        ? "asset-pair:car-route-not-visibly-bound-to-road-surface"
+        : "asset-pair:character-foot-contact-not-visibly-bound-to-platform-surface";
+    const cameraBlocker = input.category === "racing"
+        ? "asset-pair:track-camera-composition-reads-as-proof-harness"
+        : "asset-pair:platform-camera-composition-not-public-quality";
+    const scaleBlocker = input.category === "racing"
+        ? "asset-pair:vehicle-track-scale-contract-mismatch"
+        : "asset-pair:character-world-scale-and-art-direction-not-public-quality";
+    const zeroPresentationOffset = input.sceneBinding.modelPresentationOffset.x === 0
+        && input.sceneBinding.modelPresentationOffset.y === 0
+        && input.sceneBinding.modelPresentationOffset.z === 0;
+    const overlayMatches = input.geometry.source === "asset-mesh-extracted"
+        ? input.sceneBinding.overlay === "" || input.sceneBinding.overlay === input.screenshot.path
+        : input.sceneBinding.overlay === input.screenshot.path;
+    const bindingPass = (input.freshnessFailures?.length ?? 0) === 0
+        && input.sceneBinding.assetHash === input.geometry.assetHash
+        && overlayMatches
+        && input.geometry.modelAnchorCount > 0
+        && input.sceneBinding.averageBindingError <= 0.06
+        && zeroPresentationOffset
+        && overlapRatio >= thresholds.minBindingOverlapRatio;
+    const contactPass = input.contact.proven
+        && input.contact.normalizedOffset <= thresholds.maxContactOffsetRatio
+        && screenContactDistanceRatio <= thresholds.maxScreenContactDistanceRatio;
+    const selectedRacingCameraMode = input.category === "racing"
+        ? input.camera.followsSubject && input.camera.mode === "follow"
+            ? "chase"
+            : input.camera.mode === "overview" || input.camera.mode === "perspective" || input.camera.mode === "top-down"
+                ? "top-down"
+                : undefined
+        : undefined;
+    const cameraBehaviorPass = input.category === "racing" ? selectedRacingCameraMode !== undefined : input.camera.followsSubject;
+    const cameraPass = !input.screenshot.foregroundClipped
+        && !input.screenshot.subjectClipped
+        && playSpaceAreaRatio >= thresholds.minPlaySpaceAreaRatio
+        && playSpaceAreaRatio <= thresholds.maxPlaySpaceAreaRatio
+        && cameraBehaviorPass;
+    const characterScaleRatio = input.scale.characterScaleRatio;
+    const projectedTargetHeight = input.scale.projectedTargetHeight;
+    const scaleDelta = projectedTargetHeight === undefined
+        ? Number.POSITIVE_INFINITY
+        : Math.abs(input.screenshot.subjectBounds.height - projectedTargetHeight) / Math.max(projectedTargetHeight, 0.001);
+    const platformerScalePass = input.category !== "platformer" || (characterScaleRatio !== undefined
+        && characterScaleRatio > 0
+        && characterScaleRatio <= 1.25
+        && projectedTargetHeight !== undefined
+        && projectedTargetHeight > 0
+        && scaleDelta <= thresholds.maxPlatformerScaleDelta);
+    const scalePass = subjectWorldRatio >= thresholds.minSubjectWorldRatio
+        && subjectWorldRatio <= thresholds.maxSubjectWorldRatio
+        && platformerScalePass;
+    const checks = [
+        makeCheck("binding-overlap", bindingPass, {
+            minOverlapRatio: thresholds.minBindingOverlapRatio,
+            maxAverageBindingError: 0.06,
+            requiresCurrentHashes: true,
+            requiresZeroPresentationOffset: true
+        }, {
+            overlapRatio,
+            averageBindingError: input.sceneBinding.averageBindingError,
+            modelAnchorCount: input.geometry.modelAnchorCount,
+            sceneAssetHashMatches: input.sceneBinding.assetHash === input.geometry.assetHash,
+            overlayMatches,
+            zeroPresentationOffset
+        }, bindingBlocker),
+        makeCheck("contact", contactPass, {
+            maxNormalizedOffset: thresholds.maxContactOffsetRatio,
+            maxScreenContactDistanceRatio: thresholds.maxScreenContactDistanceRatio
+        }, {
+            contactProven: input.contact.proven,
+            normalizedOffset: input.contact.normalizedOffset,
+            screenContactDistance,
+            screenContactDistanceRatio
+        }, bindingBlocker),
+        makeCheck("camera-readability", cameraPass, {
+            minPlaySpaceAreaRatio: thresholds.minPlaySpaceAreaRatio,
+            maxPlaySpaceAreaRatio: thresholds.maxPlaySpaceAreaRatio,
+            clippedAllowed: false,
+            requiresSubjectFollow: input.category !== "racing" || selectedRacingCameraMode === "chase",
+            acceptedRacingModes: "chase|top-down"
+        }, {
+            playSpaceAreaRatio,
+            foregroundClipped: input.screenshot.foregroundClipped,
+            subjectClipped: input.screenshot.subjectClipped,
+            cameraMode: input.camera.mode,
+            followsSubject: input.camera.followsSubject,
+            ...(selectedRacingCameraMode ? { selectedMode: selectedRacingCameraMode } : {})
+        }, cameraBlocker),
+        makeCheck("scale-contract", scalePass, {
+            minSubjectWorldRatio: thresholds.minSubjectWorldRatio,
+            maxSubjectWorldRatio: thresholds.maxSubjectWorldRatio,
+            maxPlatformerScaleDelta: thresholds.maxPlatformerScaleDelta
+        }, {
+            subjectWorldRatio,
+            characterScaleRatio: characterScaleRatio ?? "not-required",
+            projectedTargetHeight: projectedTargetHeight ?? "not-required",
+            renderedSubjectHeight: input.screenshot.subjectBounds.height,
+            scaleDelta: Number.isFinite(scaleDelta) ? scaleDelta : "missing"
+        }, scaleBlocker),
+        makeCheck("debug-guide-absence", input.debugGuidesAbsent, {
+            visibleDebugGuidesAllowed: false
+        }, {
+            debugGuidesAbsent: input.debugGuidesAbsent
+        }, "asset-pair:debug-guides-visible")
+    ];
+    const blockers = unique([
+        ...(input.freshnessFailures ?? []),
+        ...checks.flatMap((check) => check.blockers)
+    ]);
+    return {
+        schema: "aura3d-showcase-asset-pair-composition/1.0",
+        routeId: input.routeId,
+        category: input.category,
+        verdict: blockers.length === 0 ? "pass" : "fail",
+        pass: blockers.length === 0,
+        screenshot: {
+            path: input.screenshot.path,
+            sha256: input.screenshot.sha256,
+            width: input.screenshot.width,
+            height: input.screenshot.height
+        },
+        geometry: input.geometry,
+        assets: input.assets,
+        thresholds,
+        checks,
+        blockers
+    };
+}
+export function validateShowcaseAssetPairCompositionFromDisk(options) {
+    const root = resolve(options.projectDir ?? process.cwd());
+    const probe = readJsonObject(root, options.routePrimaryProbe, "route-primary-probe");
+    const gameplay = readJsonObject(root, options.gameplayProof, "gameplay-proof");
+    const geometryReport = readJsonObject(root, options.geometryReport, "geometry-report");
+    const manifest = readJsonObject(root, options.manifest ?? "aura.assets.json", "manifest");
+    const screenshotPath = readString(readObject(probe, "renderedProbe"), "screenshotPath");
+    const screenshotAbsolute = safePath(root, screenshotPath, "screenshot");
+    const screenshotSha256 = sha256(readFileSync(screenshotAbsolute));
+    const renderedProbe = readObject(probe, "renderedProbe");
+    const crop = readRect(renderedProbe, "analysisCrop");
+    const foregroundBounds = readRect(renderedProbe, "foregroundBounds");
+    const compositionProbe = readObject(probe, "compositionProbe");
+    const subjectBounds = readRect(compositionProbe, "subjectBounds");
+    const projectedPlaySpaceBounds = readRect(compositionProbe, "projectedPlaySpaceBounds");
+    const projectedContactPoint = readPoint(compositionProbe, "projectedContactPoint");
+    const evidence = readObject(readObject(gameplay, "evidence"), "before");
+    const sceneContainer = readObject(evidence, options.category === "racing" ? "racing" : "platformer");
+    const sceneBinding = readObject(sceneContainer, "sceneBinding");
+    const geometry = geometryRecord(options.category, geometryReport);
+    const manifestAssets = readArray(manifest, "assets");
+    const primaryAssets = readStringArray(evidence, "primaryAssets");
+    const routeProbeAssets = readArray(probe, "primaryAssets");
+    const freshnessFailures = [];
+    if (readString(renderedProbe, "sha256") !== screenshotSha256)
+        freshnessFailures.push("asset-pair:stale-screenshot-hash");
+    if (readString(probe, "routeId") !== options.routeId || readString(geometryReport, "routeId") !== options.routeId) {
+        freshnessFailures.push("asset-pair:route-id-mismatch");
+    }
+    const assets = primaryAssets.map((id) => {
+        const manifestAsset = manifestAssets.find((value) => isRecord(value) && value.id === id);
+        const probeAsset = routeProbeAssets.find((value) => isRecord(value) && value.id === id);
+        const manifestHash = isRecord(manifestAsset) && typeof manifestAsset.hash === "string" ? manifestAsset.hash : "missing";
+        const evidenceHash = isRecord(probeAsset) && typeof probeAsset.manifestHash === "string" ? probeAsset.manifestHash : "missing";
+        if (manifestHash !== evidenceHash)
+            freshnessFailures.push(`asset-pair:stale-manifest-hash:${id}`);
+        return { id, manifestHash, evidenceHash };
+    });
+    if (!assets.some((asset) => asset.id === geometry.assetId && asset.manifestHash === geometry.assetHash)) {
+        freshnessFailures.push(`asset-pair:geometry-asset-hash-mismatch:${geometry.assetId}`);
+    }
+    const contact = compositionContact(options.category, evidence);
+    const cameraEvidence = readObject(readObject(readObject(evidence, "diagnostics"), "evidence"), "camera");
+    const mode = optionalString(cameraEvidence, "mode") ?? "missing";
+    const levelDesign = options.category === "platformer" ? readOptionalObject(evidence, "levelDesign") : undefined;
+    const gameplayEvidence = readObject(evidence, "gameplay");
+    const debugGuidesAbsent = options.category === "racing"
+        ? gameplayEvidence.noDebugLocatorDisk === true
+        : levelDesign?.noDebugSurfaceGuides === true;
+    const source = readString(geometry.record, "source");
+    const modelAlignment = readObject(geometry.record, "modelAlignment");
+    const anchorPairs = Array.isArray(modelAlignment.anchorPairs) ? modelAlignment.anchorPairs : [];
+    const overlay = optionalString(sceneBinding, options.category === "racing" ? "routeOverlay" : "surfaceOverlay") ?? "";
+    const averageBindingError = readNumber(sceneBinding, options.category === "racing" ? "averageRouteTopologyError" : "averageSurfaceBindingError");
+    const characterScaleRatio = options.category === "platformer" ? optionalNumber(sceneBinding, "characterScaleRatio") : undefined;
+    const projectedTargetHeight = options.category === "platformer" ? optionalNumber(compositionProbe, "projectedSubjectHeight") : undefined;
+    const report = validateShowcaseAssetPairComposition({
+        routeId: options.routeId,
+        category: options.category,
+        screenshot: {
+            path: screenshotPath,
+            sha256: screenshotSha256,
+            width: readNumber(renderedProbe, "width"),
+            height: readNumber(renderedProbe, "height"),
+            crop,
+            foregroundBounds,
+            foregroundClipped: renderedProbe.clipped === true,
+            subjectBounds,
+            subjectClipped: compositionProbe.subjectClipped === true,
+            projectedPlaySpaceBounds,
+            projectedContactPoint,
+            ...(projectedTargetHeight !== undefined ? { projectedSubjectHeight: projectedTargetHeight } : {})
+        },
+        assets,
+        geometry: {
+            report: options.geometryReport,
+            assetId: geometry.assetId,
+            assetHash: geometry.assetHash,
+            source,
+            modelAnchorCount: Math.max(anchorPairs.length, 1)
+        },
+        sceneBinding: {
+            assetHash: readString(sceneBinding, "assetHash"),
+            geometryBinding: readString(sceneBinding, "geometryBinding"),
+            overlay,
+            averageBindingError,
+            modelPresentationOffset: readOffset(sceneBinding, "modelPresentationOffset")
+        },
+        contact,
+        camera: {
+            mode,
+            followsSubject: mode === "follow" && typeof cameraEvidence.followTarget === "string"
+        },
+        scale: { characterScaleRatio, projectedTargetHeight },
+        debugGuidesAbsent,
+        freshnessFailures
+    });
+    if (options.outputPath) {
+        const output = safePath(root, options.outputPath, "composition-output");
+        mkdirSync(dirname(output), { recursive: true });
+        writeFileSync(output, `${JSON.stringify(report, null, 2)}\n`);
+    }
+    return report;
+}
+function geometryRecord(category, report) {
+    const key = category === "racing" ? "topology" : "surfaceMap";
+    const record = readObject(report, key);
+    return { record, assetId: readString(record, "assetId"), assetHash: readString(record, "assetHash") };
+}
+function compositionContact(category, evidence) {
+    if (category === "racing") {
+        const alignment = readObject(readObject(evidence, "raceState"), "roadAlignment");
+        return { proven: alignment.onRoad === true, normalizedOffset: readNumber(alignment, "normalizedOffset") };
+    }
+    const diagnostics = readObject(evidence, "diagnostics");
+    const alignment = readOptionalObject(diagnostics, "surfaceContactAlignment");
+    const gameplay = readObject(evidence, "gameplay");
+    return {
+        proven: alignment?.feetOnSurface === true && gameplay.surfaceContactProven === true,
+        normalizedOffset: Math.abs(optionalNumber(alignment ?? {}, "verticalGap") ?? Number.POSITIVE_INFINITY)
+    };
+}
+function makeCheck(id, pass, tolerance, measured, blocker) {
+    return { id, verdict: pass ? "pass" : "fail", tolerance, measured, blockers: pass ? [] : [blocker] };
+}
+function horizontalIntersectionRatio(left, right) {
+    const x1 = Math.max(left.x, right.x);
+    const x2 = Math.min(left.x + left.width, right.x + right.width);
+    return ratio(Math.max(0, x2 - x1), Math.max(0, left.width));
+}
+function intersectionRatio(left, right) {
+    const x1 = Math.max(left.x, right.x);
+    const y1 = Math.max(left.y, right.y);
+    const x2 = Math.min(left.x + left.width, right.x + right.width);
+    const y2 = Math.min(left.y + left.height, right.y + right.height);
+    return ratio(Math.max(0, x2 - x1) * Math.max(0, y2 - y1), area(left));
+}
+function area(rect) { return Math.max(0, rect.width) * Math.max(0, rect.height); }
+function ratio(value, total) { return total > 0 ? Number((value / total).toFixed(4)) : 0; }
+function unique(values) { return [...new Set(values)]; }
+function sha256(value) { return `sha256-${createHash("sha256").update(value).digest("hex")}`; }
+function readJsonObject(root, path, label) {
+    const absolute = safePath(root, path, label);
+    if (!existsSync(absolute))
+        throw new Error(`${label} is missing: ${path}`);
+    const parsed = JSON.parse(readFileSync(absolute, "utf8"));
+    if (!isRecord(parsed))
+        throw new Error(`${label} must contain a JSON object: ${path}`);
+    return parsed;
+}
+function safePath(root, path, label) {
+    if (!path || isAbsolute(path) || path.includes("\0"))
+        throw new Error(`${label} path must be repository-relative`);
+    const absolute = resolve(root, path);
+    const rel = relative(root, absolute);
+    if (rel.startsWith("..") || isAbsolute(rel))
+        throw new Error(`${label} path escapes the repository`);
+    return absolute;
+}
+function isRecord(value) { return typeof value === "object" && value !== null && !Array.isArray(value); }
+function readObject(value, key) { const result = value[key]; if (!isRecord(result))
+    throw new Error(`${key} must be an object`); return result; }
+function readOptionalObject(value, key) { const result = value[key]; return isRecord(result) ? result : undefined; }
+function readArray(value, key) { const result = value[key]; if (!Array.isArray(result))
+    throw new Error(`${key} must be an array`); return result; }
+function readString(value, key) { const result = value[key]; if (typeof result !== "string" || !result)
+    throw new Error(`${key} must be a non-empty string`); return result; }
+function optionalString(value, key) { const result = value[key]; return typeof result === "string" ? result : undefined; }
+function readNumber(value, key) { const result = value[key]; if (typeof result !== "number" || !Number.isFinite(result))
+    throw new Error(`${key} must be finite`); return result; }
+function optionalNumber(value, key) { const result = value[key]; return typeof result === "number" && Number.isFinite(result) ? result : undefined; }
+function readStringArray(value, key) { return readArray(value, key).map((item) => { if (typeof item !== "string")
+    throw new Error(`${key} must contain strings`); return item; }); }
+function readRect(value, key) { const rect = readObject(value, key); return { x: readNumber(rect, "x"), y: readNumber(rect, "y"), width: readNumber(rect, "width"), height: readNumber(rect, "height") }; }
+function readPoint(value, key) { const point = readObject(value, key); return { x: readNumber(point, "x"), y: readNumber(point, "y") }; }
+function readOffset(value, key) { const offset = readObject(value, key); return { x: readNumber(offset, "x"), y: readNumber(offset, "y"), z: readNumber(offset, "z") }; }
+//# sourceMappingURL=showcase-spec-asset-pair-composition.js.map