@aura3d/workflows 1.4.0 → 1.4.1

package/README.md

@@ -0,0 +1,28 @@
+# @aura3d/workflows
+
+`@aura3d/workflows` owns asset viewer, product configurator, material studio,
+scene showcase, interactive scene, animation lab, comparison, and production
+workflow helpers for Aura3D.
+
+## Public API
+
+- `createAssetViewerWorkflow`
+- `createProductConfiguratorWorkflow`
+- `createMaterialStudioWorkflow`
+- `createSceneShowcaseWorkflow`
+- `createInteractiveSceneWorkflow`
+- `createAnimationLabWorkflow`
+- `createComparisonWorkflow`
+- `createWorkflowDiagnostics`
+- `externalParityWorkflows`
+
+Production-runtime helpers include `PRODUCTION_WORKFLOWS`,
+`createProductionWorkflowPlan`, `runProductionExample`,
+`createProductionAssetPreflight`, `createProductionRendererDefaults`, and
+`createProductionVisualQAResult`.
+
+## Package Boundary
+
+This package creates workflow data and production-runtime workflow plans. Public
+claims still need matching evidence for the workflow output and the renderer/API
+path used to display it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/workflows",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "type": "module",
   "exports": {
     ".": {
@@ -11,12 +11,43 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/animation": "1.4.0",
-    "@aura3d/assets": "1.4.0",
-    "@aura3d/product-studio": "1.4.0",
-    "@aura3d/engine": "1.4.0",
-    "@aura3d/rendering": "1.4.0",
-    "@aura3d/scene": "1.4.0"
+    "@aura3d/animation": "1.4.1",
+    "@aura3d/assets": "1.4.1",
+    "@aura3d/engine": "1.4.1",
+    "@aura3d/product-studio": "1.4.1",
+    "@aura3d/scene": "1.4.1",
+    "@aura3d/rendering": "1.4.1"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "description": "Asset viewer, product configurator, material studio, scene showcase, interactive scene, animation lab, comparison, and production workflow helpers for Aura3D.",
+  "keywords": [
+    "aura3d",
+    "3d",
+    "browser-3d",
+    "web-3d",
+    "typescript",
+    "workflows",
+    "asset-viewer",
+    "product-configurator",
+    "material-studio",
+    "scene-showcase",
+    "production-runtime"
+  ],
+  "homepage": "https://aura3d.auraone.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/auraoneai/aura3d.git",
+    "directory": "packages/workflows"
+  },
+  "bugs": {
+    "url": "https://github.com/auraoneai/aura3d/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ]
 }

package/src/AnimationLabWorkflow.ts

@@ -1,165 +0,0 @@
-import { AnimationClip, AnimationTrack } from "@aura3d/animation";
-import { composeMat4 } from "@aura3d/scene";
-import { Geometry, PBRMaterial, createLightingDefault } from "@aura3d/rendering";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { AnimationLabWorkflowOptions, AnimationLabWorkflowResult } from "./WorkflowTypes";
-
-type Vec3 = readonly [number, number, number];
-
-export function createAnimationLabWorkflow(options: AnimationLabWorkflowOptions = {}): AnimationLabWorkflowResult {
-  const speed = Number.isFinite(options.speed) && options.speed !== undefined && options.speed > 0 ? options.speed : 1;
-  const clips = createAnimationClips();
-  const activeClip = clips.find((clip) => clip.name === (options.clip ?? "walk")) ?? clips[1]!;
-  const lighting = createLightingDefault("studioProduct");
-  const material = new PBRMaterial({ name: "animation-lab-character", baseColor: [0.72, 0.55, 0.32, 1], metallic: 0.18, roughness: 0.42 });
-  const accent = new PBRMaterial({ name: "animation-lab-accent", baseColor: [0.18, 0.3, 0.28, 1], metallic: 0.08, roughness: 0.5 });
-
-  const sample = (timeSeconds: number) => {
-    const t = wrapTime(timeSeconds * speed, activeClip.duration);
-    const root = sampleVec3(activeClip, "root.position", t);
-    const armSwing = sampleScalar(activeClip, "arms.swing", t);
-    const legSwing = sampleScalar(activeClip, "legs.swing", t);
-    const headBob = sampleScalar(activeClip, "head.bob", t);
-    const renderItems = [
-      {
-        label: "animation-lab-body",
-        geometry: Geometry.capsule({ radius: 0.34, height: 1.25, segments: 24, rings: 12, textured: true }),
-        material,
-        modelMatrix: composeMat4([root[0], 0.78 + root[1], root[2]], [0, 0, 0, 1], [1.05, 1, 0.85])
-      },
-      {
-        label: "animation-lab-head",
-        geometry: Geometry.uvSphere(0.28, 32, 16, { textured: true }),
-        material,
-        modelMatrix: composeMat4([root[0], 1.66 + headBob, root[2]], [0, 0, 0, 1], [1, 1, 1])
-      },
-      {
-        label: "animation-lab-left-arm",
-        geometry: Geometry.cylinder({ radius: 0.09, height: 0.78, segments: 18, textured: true }),
-        material: accent,
-        modelMatrix: composeMat4([root[0] - 0.44, 0.9, root[2] + armSwing], [0.18, 0, 0, 0.98], [1, 1, 1])
-      },
-      {
-        label: "animation-lab-right-arm",
-        geometry: Geometry.cylinder({ radius: 0.09, height: 0.78, segments: 18, textured: true }),
-        material: accent,
-        modelMatrix: composeMat4([root[0] + 0.44, 0.9, root[2] - armSwing], [-0.18, 0, 0, 0.98], [1, 1, 1])
-      },
-      {
-        label: "animation-lab-left-leg",
-        geometry: Geometry.cylinder({ radius: 0.12, height: 0.78, segments: 18, textured: true }),
-        material: accent,
-        modelMatrix: composeMat4([root[0] - 0.18, 0.18, root[2] - legSwing], [0.12, 0, 0, 0.99], [1, 1, 1])
-      },
-      {
-        label: "animation-lab-right-leg",
-        geometry: Geometry.cylinder({ radius: 0.12, height: 0.78, segments: 18, textured: true }),
-        material: accent,
-        modelMatrix: composeMat4([root[0] + 0.18, 0.18, root[2] + legSwing], [-0.12, 0, 0, 0.99], [1, 1, 1])
-      }
-    ];
-    return {
-      renderItems,
-      cameraPolicy: "auto-frame" as const,
-      cameraFrameOptions: { paddingRatio: 0.24, yawRadians: -0.28, pitchRadians: -0.08 },
-      environmentLighting: lighting.environmentLighting,
-      shadow: false,
-      postprocess: { ...lighting.postprocess, targetFormat: "rgba8" as const }
-    };
-  };
-
-  const source = sample(0);
-  return {
-    kind: "animation-lab",
-    source,
-    renderItems: source.renderItems,
-    clips,
-    mixer: {
-      timeScale: speed,
-      actionCount: 1,
-      actions: [{ clipName: activeClip.name, duration: activeClip.duration, time: 0, weight: 1, timeScale: speed, playing: true, paused: false, loopMode: "repeat" }],
-      layers: [],
-      values: {
-        "root.position": [0, 0, 0],
-        "arms.swing": 0,
-        "legs.swing": 0,
-        "head.bob": 0
-      },
-      applyErrors: []
-    },
-    diagnostics: createWorkflowDiagnostics("animation-lab", {
-      featureChecklist: ["keyframe-clips", "clip-switching", "animated-transforms", "timeline-sampling", "camera-framing", "postprocess"]
-    }),
-    update: sample,
-    dispose: () => undefined
-  };
-}
-
-function createAnimationClips(): readonly AnimationClip[] {
-  return [
-    createClip("idle", 1.6, [0, 0, 0], 0.05, 0.02, 0.03),
-    createClip("walk", 1.2, [0, 0, 0.1], 0.24, 0.22, 0.06),
-    createClip("run", 0.8, [0, 0, 0.16], 0.34, 0.32, 0.09)
-  ];
-}
-
-function createClip(name: string, duration: number, rootEnd: Vec3, arm: number, leg: number, bob: number): AnimationClip {
-  return new AnimationClip({
-    name,
-    duration,
-    tracks: [
-      new AnimationTrack<Vec3>({
-        target: "root.position",
-        valueType: "vector3",
-        keyframes: [
-          { time: 0, value: [0, 0, 0] },
-          { time: duration / 2, value: [rootEnd[0], bob, rootEnd[2] / 2] },
-          { time: duration, value: rootEnd }
-        ]
-      }),
-      new AnimationTrack<number>({
-        target: "arms.swing",
-        valueType: "scalar",
-        keyframes: [
-          { time: 0, value: -arm },
-          { time: duration / 2, value: arm },
-          { time: duration, value: -arm }
-        ]
-      }),
-      new AnimationTrack<number>({
-        target: "legs.swing",
-        valueType: "scalar",
-        keyframes: [
-          { time: 0, value: leg },
-          { time: duration / 2, value: -leg },
-          { time: duration, value: leg }
-        ]
-      }),
-      new AnimationTrack<number>({
-        target: "head.bob",
-        valueType: "scalar",
-        keyframes: [
-          { time: 0, value: 0 },
-          { time: duration / 2, value: bob },
-          { time: duration, value: 0 }
-        ]
-      })
-    ]
-  });
-}
-
-function sampleVec3(clip: AnimationClip, target: string, time: number): Vec3 {
-  const value = clip.tracks.find((track) => track.target === target)?.sample(time);
-  return Array.isArray(value) && value.length === 3 ? [value[0]!, value[1]!, value[2]!] : [0, 0, 0];
-}
-
-function sampleScalar(clip: AnimationClip, target: string, time: number): number {
-  const value = clip.tracks.find((track) => track.target === target)?.sample(time);
-  return typeof value === "number" ? value : 0;
-}
-
-function wrapTime(timeSeconds: number, duration: number): number {
-  if (duration <= 0) return 0;
-  const wrapped = timeSeconds % duration;
-  return wrapped < 0 ? wrapped + duration : wrapped;
-}

package/src/AssetViewerWorkflow.ts

@@ -1,37 +0,0 @@
-import { createRenderableScene, loadRenderableAsset } from "@aura3d/assets";
-import type { LoadRenderableAssetOptions } from "@aura3d/assets";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { AssetViewerWorkflowOptions, AssetViewerWorkflowResult } from "./WorkflowTypes";
-
-export async function createAssetViewerWorkflow(options: AssetViewerWorkflowOptions): Promise<AssetViewerWorkflowResult> {
-  const loadOptions: LoadRenderableAssetOptions = {
-    baseUrl: options.baseUrl,
-    signal: options.signal,
-    dependencyChain: options.dependencyChain,
-    manager: options.manager,
-    type: options.type
-  };
-  const asset = await loadRenderableAsset(options.url, loadOptions);
-  const scene = await createRenderableScene(asset, {
-    camera: options.camera ?? "auto-frame",
-    lighting: options.lighting ?? "studioProduct",
-    shadows: options.shadows ?? true,
-    postprocess: options.postprocess ?? "product-default",
-    viewport: options.viewport,
-    qualityPreset: options.qualityPreset,
-    renderResources: options.renderResources
-  });
-  return {
-    kind: "asset-viewer",
-    asset,
-    scene,
-    source: scene.source,
-    camera: scene.rendererInput?.camera,
-    diagnostics: createWorkflowDiagnostics("asset-viewer", {
-      asset,
-      warnings: scene.warnings,
-      featureChecklist: ["asset-loading", "render-resources", "auto-camera", "lighting", "shadows", "postprocess"]
-    }),
-    dispose: () => scene.dispose()
-  };
-}

package/src/ComparisonWorkflow.ts

@@ -1,68 +0,0 @@
-import { composeMat4 } from "@aura3d/scene";
-import { Geometry, PBRMaterial, createLightingDefault } from "@aura3d/rendering";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { ComparisonWorkflowOptions, ComparisonWorkflowResult } from "./WorkflowTypes";
-
-export function createComparisonWorkflow(options: ComparisonWorkflowOptions = {}): ComparisonWorkflowResult {
-  const focus = options.focus ?? "setup";
-  const lighting = createLightingDefault("studioProduct");
-  const a3dMaterial = new PBRMaterial({ name: "comparison-a3d", baseColor: [0.12, 0.48, 0.82, 1], metallic: 0.1, roughness: 0.34 });
-  const threeMaterial = new PBRMaterial({ name: "comparison-three-baseline", baseColor: [0.75, 0.75, 0.75, 1], metallic: 0.05, roughness: 0.5 });
-  const migrationMaterial = new PBRMaterial({ name: "comparison-migration", baseColor: [0.88, 0.56, 0.2, 1], metallic: 0.18, roughness: 0.38 });
-  const renderItems = [
-    {
-      label: "comparison-a3d-workflow",
-      geometry: Geometry.uvSphere(0.48, 40, 20, { textured: true }),
-      material: a3dMaterial,
-      modelMatrix: composeMat4([-1.15, 0.05, 0], [0, 0, 0, 1], [1, 1, 1])
-    },
-    {
-      label: "comparison-threejs-reference",
-      geometry: Geometry.texturedCube(0.88),
-      material: threeMaterial,
-      modelMatrix: composeMat4([0, 0, 0], [0, 0.25, 0, 0.97], [1, 1, 1])
-    },
-    {
-      label: "comparison-migration-output",
-      geometry: Geometry.cylinder({ radius: 0.36, height: 1, segments: 32, textured: true }),
-      material: migrationMaterial,
-      modelMatrix: composeMat4([1.15, 0, 0], [0, 0, 0, 1], [1, 1, 1])
-    }
-  ];
-  const comparison = {
-    focus,
-    a3dSteps: [
-      "create workflow render source",
-      "load optional asset/environment through public package APIs",
-      "render through Renderer.create with diagnostics"
-    ],
-    threeJsSteps: [
-      "create scene, camera, renderer, lights, controls, loader, material setup, and animation loop separately",
-      "wire resource disposal and resize handling manually",
-      "add diagnostics through user-land instrumentation"
-    ],
-    migrationNotes: [
-      "A3D comparison workflow renders a A3D-owned parity scene; it does not embed Three.js at runtime.",
-      "Use @aura3d/three-compat for adapter coverage and warnings when moving Three.js example code."
-    ]
-  };
-  const source = {
-    renderItems,
-    cameraPolicy: "auto-frame" as const,
-    cameraFrameOptions: { paddingRatio: 0.22, yawRadians: -0.36, pitchRadians: -0.1 },
-    environmentLighting: lighting.environmentLighting,
-    shadow: false,
-    postprocess: { ...lighting.postprocess, targetFormat: "rgba8" as const }
-  };
-  return {
-    kind: "comparison",
-    source,
-    renderItems,
-    comparison,
-    diagnostics: createWorkflowDiagnostics("comparison", {
-      warnings: ["Comparison workflow summarizes migration/setup parity; same-scene Three.js visual superiority still requires benchmark reports."],
-      featureChecklist: ["a3d-workflow-source", "threejs-setup-comparison", "migration-notes", "render-diagnostics", "postprocess"]
-    }),
-    dispose: () => undefined
-  };
-}

package/src/InteractiveSceneWorkflow.ts

@@ -1,44 +0,0 @@
-import { composeMat4 } from "@aura3d/scene";
-import { Geometry, PBRMaterial, createLightingDefault } from "@aura3d/rendering";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { InteractiveSceneWorkflowOptions, InteractiveSceneWorkflowResult } from "./WorkflowTypes";
-
-export function createInteractiveSceneWorkflow(_options: InteractiveSceneWorkflowOptions = {}): InteractiveSceneWorkflowResult {
-  const lighting = createLightingDefault("studioProduct");
-  const material = new PBRMaterial({ name: "interactive-workflow-material", baseColor: [0.95, 0.62, 0.18, 1], metallic: 0.25, roughness: 0.36 });
-  const createSource = (timeSeconds: number) => {
-    const renderItems = [
-      {
-        label: "interactive-orbit-a",
-        geometry: Geometry.uvSphere(0.42, 32, 16, { textured: true }),
-        material,
-        modelMatrix: composeMat4([Math.cos(timeSeconds) * 0.9, 0, Math.sin(timeSeconds) * 0.35], [0, 0, 0, 1], [1, 1, 1])
-      },
-      {
-        label: "interactive-orbit-b",
-        geometry: Geometry.texturedCube(1),
-        material: new PBRMaterial({ name: "interactive-workflow-blue", baseColor: [0.2, 0.48, 0.92, 1], metallic: 0.1, roughness: 0.44 }),
-        modelMatrix: composeMat4([Math.cos(timeSeconds + Math.PI) * 0.9, 0, Math.sin(timeSeconds + Math.PI) * 0.35], [0, 0, 0, 1], [0.62, 0.62, 0.62])
-      }
-    ];
-    return {
-      renderItems,
-      cameraPolicy: "auto-frame" as const,
-      cameraFrameOptions: { paddingRatio: 0.28, yawRadians: -0.5, pitchRadians: -0.14 },
-      environmentLighting: lighting.environmentLighting,
-      shadow: false,
-      postprocess: { ...lighting.postprocess, targetFormat: "rgba8" as const }
-    };
-  };
-  const source = createSource(0);
-  return {
-    kind: "interactive-scene",
-    source,
-    renderItems: source.renderItems,
-    diagnostics: createWorkflowDiagnostics("interactive-scene", {
-      featureChecklist: ["update-loop", "animated-transforms", "input-ready-scene", "camera-framing", "postprocess"]
-    }),
-    update: createSource,
-    dispose: () => undefined
-  };
-}

package/src/MaterialStudioWorkflow.ts

@@ -1,48 +0,0 @@
-import { composeMat4 } from "@aura3d/scene";
-import { Geometry, NormalMappedPBRMaterial, PBRMaterial, TexturedPBRMaterial, Texture, createLightingDefault } from "@aura3d/rendering";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { MaterialStudioWorkflowOptions, MaterialStudioWorkflowResult } from "./WorkflowTypes";
-
-export function createMaterialStudioWorkflow(options: MaterialStudioWorkflowOptions = {}): MaterialStudioWorkflowResult {
-  const white = new Texture({ width: 1, height: 1, colorSpace: "srgb", data: new Uint8Array([240, 236, 220, 255]) });
-  const rough = new Texture({ width: 1, height: 1, colorSpace: "linear", data: new Uint8Array([255, 128, 255, 255]) });
-  const normal = new Texture({ width: 1, height: 1, colorSpace: "linear", data: new Uint8Array([128, 128, 255, 255]) });
-  const lighting = createLightingDefault(options.mode === "transparent" ? "interiorGallery" : "studioProduct");
-  const renderItems = [
-    {
-      label: "workflow-polished-metal",
-      geometry: Geometry.uvSphere(0.58, 48, 24, { textured: true }),
-      material: new PBRMaterial({ name: "workflow-polished-metal", baseColor: [0.86, 0.82, 0.72, 1], metallic: 1, roughness: 0.18 }),
-      modelMatrix: composeMat4([-1.25, 0, 0], [0, 0, 0, 1], [1, 1, 1])
-    },
-    {
-      label: "workflow-textured-pbr",
-      geometry: Geometry.uvSphere(0.58, 48, 24, { textured: true }),
-      material: new TexturedPBRMaterial({ name: "workflow-textured-pbr", baseColorTexture: white, metallicRoughnessTexture: rough, normalTexture: normal, roughness: 0.45 }),
-      modelMatrix: composeMat4([0, 0, 0], [0, 0, 0, 1], [1, 1, 1])
-    },
-    {
-      label: "workflow-normal-material",
-      geometry: Geometry.texturedCube(1),
-      material: new NormalMappedPBRMaterial({ name: "workflow-normal-material", normalTexture: normal, baseColor: [0.28, 0.58, 0.9, 1], normalScale: 0.8 }),
-      modelMatrix: composeMat4([1.25, 0, 0], [0, 0, 0, 1], [0.85, 0.85, 0.85])
-    }
-  ];
-  const source = {
-    renderItems,
-    cameraPolicy: "auto-frame" as const,
-    cameraFrameOptions: { paddingRatio: 0.18, yawRadians: -0.36, pitchRadians: -0.12 },
-    environmentLighting: lighting.environmentLighting,
-    shadow: false,
-    postprocess: { ...lighting.postprocess, targetFormat: "rgba8" as const }
-  };
-  return {
-    kind: "material-studio",
-    source,
-    renderItems,
-    diagnostics: createWorkflowDiagnostics("material-studio", {
-      featureChecklist: ["pbr", "textured-pbr", "normal-mapped-pbr", "material-comparison", "postprocess"]
-    }),
-    dispose: () => undefined
-  };
-}

package/src/ProductConfiguratorWorkflow.ts

@@ -1,32 +0,0 @@
-import {
-  createProductCameraFrame,
-  createProductLightingPreset,
-  createProductMaterialMode,
-  createProductRenderScene,
-  loadProductAsset
-} from "@aura3d/product-studio";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { ProductConfiguratorWorkflowOptions, ProductConfiguratorWorkflowResult } from "./WorkflowTypes";
-
-export async function createProductConfiguratorWorkflow(options: ProductConfiguratorWorkflowOptions): Promise<ProductConfiguratorWorkflowResult> {
-  const asset = await loadProductAsset(options.asset);
-  const lighting = createProductLightingPreset(options.lighting ?? "catalog-softbox");
-  const camera = createProductCameraFrame(asset, {
-    preset: options.camera ?? "front-three-quarter",
-    viewport: options.viewport ?? { width: 1280, height: 900 }
-  });
-  const materialMode = createProductMaterialMode(options.materialMode ?? "asset");
-  const scene = createProductRenderScene(asset, { lighting, camera, materialMode });
-  return {
-    kind: "product-configurator",
-    asset,
-    scene,
-    source: scene.source,
-    camera: scene.camera,
-    diagnostics: createWorkflowDiagnostics("product-configurator", {
-      asset,
-      featureChecklist: ["product-asset", "material-modes", "lighting-presets", "camera-presets", "export-ready"]
-    }),
-    dispose: () => asset.resources.dispose()
-  };
-}

package/src/SceneShowcaseWorkflow.ts

@@ -1,45 +0,0 @@
-import { composeMat4 } from "@aura3d/scene";
-import { Geometry, PBRMaterial, createLightingDefault } from "@aura3d/rendering";
-import { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-import type { SceneShowcaseWorkflowOptions, SceneShowcaseWorkflowResult } from "./WorkflowTypes";
-
-export function createSceneShowcaseWorkflow(options: SceneShowcaseWorkflowOptions = {}): SceneShowcaseWorkflowResult {
-  const lighting = createLightingDefault(options.preset === "dramatic" ? "gameNight" : options.preset === "gallery" ? "interiorGallery" : "studioProduct");
-  const renderItems = [
-    {
-      label: "showcase-center",
-      geometry: Geometry.uvSphere(0.72, 48, 24, { textured: true }),
-      material: new PBRMaterial({ name: "showcase-center-material", baseColor: [0.9, 0.3, 0.16, 1], metallic: 0.35, roughness: 0.32 }),
-      modelMatrix: composeMat4([0, 0.25, 0], [0, 0, 0, 1], [1, 1, 1])
-    },
-    {
-      label: "showcase-left",
-      geometry: Geometry.texturedCube(1),
-      material: new PBRMaterial({ name: "showcase-left-material", baseColor: [0.18, 0.45, 0.9, 1], metallic: 0.1, roughness: 0.48 }),
-      modelMatrix: composeMat4([-1.25, -0.15, -0.2], [0, 0.18, 0, 0.98], [0.72, 0.72, 0.72])
-    },
-    {
-      label: "showcase-right",
-      geometry: Geometry.cylinder({ radius: 0.42, height: 1.1, textured: true }),
-      material: new PBRMaterial({ name: "showcase-right-material", baseColor: [0.2, 0.72, 0.42, 1], metallic: 0.05, roughness: 0.55 }),
-      modelMatrix: composeMat4([1.25, -0.1, -0.15], [0, 0, 0, 1], [1, 1, 1])
-    }
-  ];
-  const source = {
-    renderItems,
-    cameraPolicy: "auto-frame" as const,
-    cameraFrameOptions: { paddingRatio: 0.2, yawRadians: -0.42, pitchRadians: -0.16 },
-    environmentLighting: lighting.environmentLighting,
-    shadow: false,
-    postprocess: { ...lighting.postprocess, targetFormat: "rgba8" as const }
-  };
-  return {
-    kind: "scene-showcase",
-    source,
-    renderItems,
-    diagnostics: createWorkflowDiagnostics("scene-showcase", {
-      featureChecklist: ["multi-object-scene", "pbr", "lighting-preset", "camera-framing", "postprocess"]
-    }),
-    dispose: () => undefined
-  };
-}

package/src/WorkflowDiagnostics.ts

@@ -1,47 +0,0 @@
-import type { RenderDeviceDiagnostics } from "@aura3d/rendering";
-import type { RenderableAsset } from "@aura3d/assets";
-import type { ProductAsset } from "@aura3d/product-studio";
-import type { A3DWorkflowDiagnostics, A3DWorkflowKind } from "./WorkflowTypes";
-
-export function createWorkflowDiagnostics(
-  workflow: A3DWorkflowKind,
-  options: {
-    readonly warnings?: readonly string[];
-    readonly featureChecklist?: readonly string[];
-    readonly asset?: RenderableAsset | ProductAsset;
-    readonly renderDiagnostics?: RenderDeviceDiagnostics;
-  } = {}
-): A3DWorkflowDiagnostics {
-  return {
-    workflow,
-    warnings: options.warnings ?? [],
-    featureChecklist: options.featureChecklist ?? [],
-    ...(options.asset ? { asset: summarizeAsset(options.asset) } : {}),
-    ...(options.renderDiagnostics ? { renderDiagnostics: options.renderDiagnostics } : {})
-  };
-}
-
-function summarizeAsset(asset: RenderableAsset | ProductAsset): A3DWorkflowDiagnostics["asset"] {
-  if ("gltf" in asset && asset.gltf) {
-    return {
-      kind: "gltf",
-      meshCount: asset.gltf.loaderDiagnostics.meshCount,
-      materialCount: asset.gltf.loaderDiagnostics.materialCount,
-      textureCount: asset.gltf.loaderDiagnostics.textureCount
-    };
-  }
-  if ("resources" in asset) {
-    return {
-      kind: asset.category,
-      meshCount: asset.gltf.loaderDiagnostics.meshCount,
-      materialCount: asset.gltf.loaderDiagnostics.materialCount,
-      textureCount: asset.gltf.loaderDiagnostics.textureCount
-    };
-  }
-  return {
-    kind: asset.kind,
-    meshCount: 0,
-    materialCount: 0,
-    textureCount: 0
-  };
-}

package/src/WorkflowTypes.ts

@@ -1,113 +0,0 @@
-import type { AnimationClip, AnimationMixerSnapshot } from "@aura3d/animation";
-import type { RenderDeviceDiagnostics, RenderItem, RenderSource, CameraLike } from "@aura3d/rendering";
-import type { RenderableAsset, RenderableScene, CreateRenderableSceneOptions, LoadRenderableAssetOptions } from "@aura3d/assets";
-import type { ProductAsset, ProductAssetLoadOptions, ProductRenderScene } from "@aura3d/product-studio";
-
-export type A3DWorkflowKind =
-  | "asset-viewer"
-  | "product-configurator"
-  | "material-studio"
-  | "scene-showcase"
-  | "interactive-scene"
-  | "animation-lab"
-  | "comparison";
-
-export interface A3DWorkflowDiagnostics {
-  readonly workflow: A3DWorkflowKind;
-  readonly warnings: readonly string[];
-  readonly featureChecklist: readonly string[];
-  readonly asset?: {
-    readonly kind: string;
-    readonly meshCount: number;
-    readonly materialCount: number;
-    readonly textureCount: number;
-  };
-  readonly renderDiagnostics?: RenderDeviceDiagnostics;
-}
-
-export interface A3DWorkflowResult {
-  readonly kind: A3DWorkflowKind;
-  readonly source: RenderSource;
-  readonly camera?: CameraLike;
-  readonly renderItems?: readonly RenderItem[];
-  readonly diagnostics: A3DWorkflowDiagnostics;
-  dispose(): void;
-}
-
-export interface AssetViewerWorkflowOptions extends CreateRenderableSceneOptions, LoadRenderableAssetOptions {
-  readonly url: string;
-}
-
-export interface AssetViewerWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "asset-viewer";
-  readonly asset: RenderableAsset;
-  readonly scene: RenderableScene;
-}
-
-export interface ProductConfiguratorWorkflowOptions {
-  readonly asset: ProductAssetLoadOptions;
-  readonly materialMode?: "asset" | "clay" | "matte" | "metal-check" | "contrast";
-  readonly lighting?: "catalog-softbox" | "inspection-bay" | "hero-contrast";
-  readonly camera?: "front-three-quarter" | "side-profile" | "top-detail" | "macro-detail";
-  readonly viewport?: {
-    readonly width: number;
-    readonly height: number;
-  };
-}
-
-export interface ProductConfiguratorWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "product-configurator";
-  readonly asset: ProductAsset;
-  readonly scene: ProductRenderScene;
-}
-
-export interface MaterialStudioWorkflowOptions {
-  readonly mode?: "comparison" | "metals" | "transparent";
-}
-
-export interface MaterialStudioWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "material-studio";
-}
-
-export interface SceneShowcaseWorkflowOptions {
-  readonly preset?: "studio" | "gallery" | "dramatic";
-}
-
-export interface SceneShowcaseWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "scene-showcase";
-}
-
-export interface InteractiveSceneWorkflowOptions {
-  readonly preset?: "orbiting-products" | "input-ready";
-}
-
-export interface InteractiveSceneWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "interactive-scene";
-  update(timeSeconds: number): RenderSource;
-}
-
-export interface AnimationLabWorkflowOptions {
-  readonly clip?: "idle" | "walk" | "run";
-  readonly speed?: number;
-}
-
-export interface AnimationLabWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "animation-lab";
-  readonly clips: readonly AnimationClip[];
-  readonly mixer: AnimationMixerSnapshot;
-  update(timeSeconds: number): RenderSource;
-}
-
-export interface ComparisonWorkflowOptions {
-  readonly focus?: "setup" | "rendering" | "migration";
-}
-
-export interface ComparisonWorkflowResult extends A3DWorkflowResult {
-  readonly kind: "comparison";
-  readonly comparison: {
-    readonly focus: "setup" | "rendering" | "migration";
-    readonly a3dSteps: readonly string[];
-    readonly threeJsSteps: readonly string[];
-    readonly migrationNotes: readonly string[];
-  };
-}

package/src/index.ts

@@ -1,34 +0,0 @@
-export { createAssetViewerWorkflow } from "./AssetViewerWorkflow";
-export { createProductConfiguratorWorkflow } from "./ProductConfiguratorWorkflow";
-export { createMaterialStudioWorkflow } from "./MaterialStudioWorkflow";
-export { createSceneShowcaseWorkflow } from "./SceneShowcaseWorkflow";
-export { createInteractiveSceneWorkflow } from "./InteractiveSceneWorkflow";
-export { createAnimationLabWorkflow } from "./AnimationLabWorkflow";
-export { createComparisonWorkflow } from "./ComparisonWorkflow";
-export { createWorkflowDiagnostics } from "./WorkflowDiagnostics";
-export { workflows as externalParityWorkflows } from "./workflow-foundation/index";
-export {
-  PRODUCTION_WORKFLOWS,
-  createProductionAssetPreflight,
-  createProductionRendererDefaults,
-  createProductionVisualQAResult,
-  createProductionWorkflowPlan,
-  listProductionWorkflowDefinitions,
-  runProductionExample
-} from "./production-runtime";
-export type {
-  ProductionAssetPreflightInput,
-  ProductionAssetPreflightResult,
-  ProductionExampleAsset,
-  ProductionExampleDefinition,
-  ProductionExampleEnvironment,
-  ProductionExampleRuntime,
-  ProductionExampleRuntimeMetrics,
-  ProductionRendererDefaults,
-  ProductionVisualQAInput,
-  ProductionVisualQAResult,
-  ProductionWorkflowDefinition,
-  ProductionWorkflowId,
-  ProductionWorkflowPlan
-} from "./production-runtime";
-export type * from "./WorkflowTypes";

package/src/production-runtime/ArchitectureWorkflow.ts

@@ -1,2 +0,0 @@
-export interface ArchitectureWorkflowSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createArchitectureWorkflowSummary(): ArchitectureWorkflowSummary { return { id: 'architecture', ready: true, workflow: 'ArchitectureWorkflow' }; }

package/src/production-runtime/AssetInspectionWorkflow.ts

@@ -1,2 +0,0 @@
-export interface AssetInspectionWorkflowSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createAssetInspectionWorkflowSummary(): AssetInspectionWorkflowSummary { return { id: 'asset-inspection', ready: true, workflow: 'AssetInspectionWorkflow' }; }

package/src/production-runtime/CinematicWorkflow.ts

@@ -1,2 +0,0 @@
-export interface CinematicWorkflowSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createCinematicWorkflowSummary(): CinematicWorkflowSummary { return { id: 'cinematic', ready: true, workflow: 'CinematicWorkflow' }; }

package/src/production-runtime/MaterialAuthoringWorkflow.ts

@@ -1,2 +0,0 @@
-export interface MaterialAuthoringWorkflowSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createMaterialAuthoringWorkflowSummary(): MaterialAuthoringWorkflowSummary { return { id: 'material-authoring', ready: true, workflow: 'MaterialAuthoringWorkflow' }; }

package/src/production-runtime/ProductRenderWorkflow.ts

@@ -1,2 +0,0 @@
-export interface ProductRenderWorkflowSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createProductRenderWorkflowSummary(): ProductRenderWorkflowSummary { return { id: 'product-render', ready: true, workflow: 'ProductRenderWorkflow' }; }

package/src/production-runtime/ProductionExampleRuntime.ts

@@ -1,267 +0,0 @@
-import { loadProductionGLTFRenderPipeline, type ProductionGLTFRenderMetadata as ProductionGLTFRenderMetadata } from "@aura3d/engine/assets/browser";
-import {
-  ProductionWebGL2Renderer,
-  createProductionEnvironmentLightingResources as createProductionEnvironmentLightingResources,
-  createProductionPbrHdrPipelineFromRadiance as createProductionPbrHdrPipelineFromRadiance,
-  createProductionWebGPUReport,
-  summarizeProductionWebGL2Proof as summarizeProductionWebGL2Proof,
-  type ProductionRenderProof as ProductionRenderProof,
-  type ProductionWebGPUReport
-} from "@aura3d/engine/rendering";
-
-export interface ProductionExampleAsset {
-  readonly id: string;
-  readonly label: string;
-  readonly file: string;
-  readonly role: "primary" | "secondary";
-}
-
-export interface ProductionExampleEnvironment {
-  readonly id: string;
-  readonly label: string;
-  readonly file: string;
-  readonly exposure: number;
-  readonly intensity: number;
-  readonly rotation: number;
-}
-
-export interface ProductionExampleDefinition {
-  readonly appId: string;
-  readonly sceneId: string;
-  readonly title: string;
-  readonly workflow: string;
-  readonly assets: readonly ProductionExampleAsset[];
-  readonly environment: ProductionExampleEnvironment;
-  readonly postprocess: boolean;
-  readonly webgpuReport: boolean;
-  readonly expectedPostprocessChain: readonly string[];
-}
-
-export interface ProductionExampleRuntimeMetrics {
-  readonly appId: string;
-  readonly sceneId: string;
-  readonly workflow: string;
-  readonly rendererBackend: "webgl2";
-  readonly assetIds: readonly string[];
-  readonly primaryAssetId: string;
-  readonly hdrEnvironmentId: string;
-  readonly drawCalls: number;
-  readonly triangleCount: number;
-  readonly materialCount: number;
-  readonly textureCount: number;
-  readonly textureMemoryEstimate: number;
-  readonly postprocessChain: readonly string[];
-  readonly frameTimeMs: number;
-  readonly warnings: readonly string[];
-}
-
-export interface ProductionExampleRuntime {
-  readonly status: "loading" | "ready" | "error";
-  readonly appId: string;
-  readonly sceneId: string;
-  readonly error?: string;
-  readonly rendererBackend?: "webgl2";
-  readonly runtime?: ProductionExampleRuntimeMetrics;
-  readonly metadata?: ProductionGLTFRenderMetadata;
-  readonly secondaryMetadata?: readonly ProductionGLTFRenderMetadata[];
-  readonly proof?: ProductionRenderProof;
-  readonly proofSummary?: ReturnType<typeof summarizeProductionWebGL2Proof>;
-  readonly webgpu?: ProductionWebGPUReport;
-  readonly interactionCount: number;
-  readonly lastInteraction?: string;
-}
-
-declare global {
-  interface Window {
-    __a3dProductionExample?: ProductionExampleRuntime;
-  }
-}
-
-export async function runProductionExample(definition: ProductionExampleDefinition): Promise<void> {
-  const root = document.getElementById("app");
-  const canvas = document.getElementById("viewport");
-  if (!(root instanceof HTMLElement) || !(canvas instanceof HTMLCanvasElement)) {
-    throw new Error(`${definition.appId} requires #app and canvas#viewport.`);
-  }
-
-  window.__a3dProductionExample = {
-    status: "loading",
-    appId: definition.appId,
-    sceneId: definition.sceneId,
-    interactionCount: 0
-  };
-  mountProductionExampleShell(root, definition, window.__a3dProductionExample);
-
-  try {
-    const primary = definition.assets.find((asset) => asset.role === "primary") ?? definition.assets[0];
-    if (!primary) throw new Error(`${definition.appId} has no primary asset.`);
-    const hdr = await fetchArrayBuffer(resolveEnvironmentUrl(definition.environment.file));
-    const hdrPipeline = createProductionPbrHdrPipelineFromRadiance(hdr, {
-      id: definition.environment.id,
-      label: definition.environment.label,
-      intensity: definition.environment.intensity,
-      backgroundIntensity: 0.9,
-      rotation: definition.environment.rotation,
-      toneMapping: { operator: "filmic", exposure: definition.environment.exposure, whitePoint: 11.2 }
-    });
-    const lighting = createProductionEnvironmentLightingResources(hdrPipeline);
-    const pipeline = await loadProductionGLTFRenderPipeline({
-      url: resolveAssetUrl(primary.file),
-      assetId: primary.id,
-      assetName: primary.label,
-      width: canvas.width,
-      height: canvas.height,
-      rendererInput: {
-        environmentLighting: lighting.lighting,
-        qualityPreset: definition.postprocess ? "hdr-studio-preview" : "studio-preview",
-        cameraPolicy: "require",
-        postprocess: false
-      }
-    });
-    const secondaryMetadata = await loadSecondaryMetadata(definition, primary.id, canvas.width, canvas.height);
-    const renderer = await ProductionWebGL2Renderer.create({
-      canvas,
-      width: canvas.width,
-      height: canvas.height,
-      preserveDrawingBuffer: true,
-      clearColor: [0.01, 0.012, 0.016, 1]
-    });
-    const frameStart = performance.now();
-    const proof = renderer.renderImportedAsset({
-      source: pipeline.source,
-      camera: pipeline.camera,
-      metadata: {
-        assetId: pipeline.metadata.assetId,
-        assetName: pipeline.metadata.assetName,
-        assetUri: pipeline.metadata.assetUri,
-        meshCount: pipeline.metadata.meshCount,
-        primitiveCount: pipeline.metadata.primitiveCount,
-        materialCount: pipeline.metadata.materialCount,
-        textureCount: pipeline.metadata.textureCount,
-        imageCount: pipeline.metadata.imageCount,
-        animationCount: pipeline.metadata.animationCount,
-        skinCount: pipeline.metadata.skinCount,
-        morphTargetCount: pipeline.metadata.morphTargetCount,
-        extensionsUsed: pipeline.metadata.extensionsUsed,
-        environmentId: definition.environment.id,
-        hdrEnvironmentUri: resolveEnvironmentUrl(definition.environment.file)
-      }
-    });
-    const webgpu = definition.webgpuReport
-      ? await createProductionWebGPUReport((navigator as Navigator & { gpu?: unknown }).gpu as Parameters<typeof createProductionWebGPUReport>[0])
-      : undefined;
-    const runtime: ProductionExampleRuntime = {
-      status: "ready",
-      appId: definition.appId,
-      sceneId: definition.sceneId,
-      rendererBackend: "webgl2",
-      runtime: {
-        appId: definition.appId,
-        sceneId: definition.sceneId,
-        workflow: definition.workflow,
-        rendererBackend: "webgl2",
-        assetIds: definition.assets.map((asset) => asset.id),
-        primaryAssetId: pipeline.metadata.assetId,
-        hdrEnvironmentId: definition.environment.id,
-        drawCalls: proof.diagnostics.drawCalls,
-        triangleCount: Math.max(1, Math.floor(pipeline.metadata.indexCount / 3)),
-        materialCount: pipeline.metadata.materialCount,
-        textureCount: pipeline.metadata.textureCount,
-        textureMemoryEstimate: proof.diagnostics.textureBytes ?? 0,
-        postprocessChain: [],
-        frameTimeMs: Number((performance.now() - frameStart).toFixed(3)),
-        warnings: [
-          ...(definition.postprocess ? ["Template runtime renders the proof frame without postprocess so WebGL2 pixel readback validates the imported asset directly."] : []),
-          ...(webgpu?.warnings ?? [])
-        ]
-      },
-      metadata: pipeline.metadata,
-      secondaryMetadata,
-      proof,
-      proofSummary: summarizeProductionWebGL2Proof(proof),
-      ...(webgpu ? { webgpu } : {}),
-      interactionCount: 0
-    };
-    window.__a3dProductionExample = runtime;
-    mountProductionExampleShell(root, definition, runtime);
-  } catch (error) {
-    window.__a3dProductionExample = {
-      status: "error",
-      appId: definition.appId,
-      sceneId: definition.sceneId,
-      error: error instanceof Error ? error.stack ?? error.message : String(error),
-      interactionCount: window.__a3dProductionExample?.interactionCount ?? 0
-    };
-    mountProductionExampleShell(root, definition, window.__a3dProductionExample);
-  }
-}
-
-function mountProductionExampleShell(root: HTMLElement, definition: ProductionExampleDefinition, runtime: ProductionExampleRuntime): void {
-  const metrics = runtime.runtime;
-  root.innerHTML = `
-    <section class="a3d-production-runtime-panel">
-      <div>
-        <h1>${definition.title}</h1>
-        <p>${definition.workflow}</p>
-      </div>
-      <button id="a3d-production-runtime-action" type="button">Inspect</button>
-    </section>
-    <section class="a3d-production-runtime-metrics">
-      <span>${runtime.status}</span>
-      <span>${metrics ? `${metrics.drawCalls} draw calls` : definition.environment.label}</span>
-      <span>${metrics ? `${metrics.triangleCount} triangles` : definition.assets.map((asset) => asset.id).join(", ")}</span>
-      <span>${metrics ? `${metrics.textureCount} textures` : "HDR IBL"}</span>
-    </section>
-  `;
-  root.querySelector("#a3d-production-runtime-action")?.addEventListener("click", () => {
-    const current = window.__a3dProductionExample;
-    if (!current) return;
-    window.__a3dProductionExample = {
-      ...current,
-      interactionCount: current.interactionCount + 1,
-      lastInteraction: "Inspect"
-    };
-    mountProductionExampleShell(root, definition, window.__a3dProductionExample);
-  });
-}
-
-async function loadSecondaryMetadata(
-  definition: ProductionExampleDefinition,
-  primaryAssetId: string,
-  width: number,
-  height: number
-): Promise<readonly ProductionGLTFRenderMetadata[]> {
-  const metadata: ProductionGLTFRenderMetadata[] = [];
-  for (const asset of definition.assets.filter((item) => item.id !== primaryAssetId)) {
-    const pipeline = await loadProductionGLTFRenderPipeline({
-      url: resolveAssetUrl(asset.file),
-      assetId: asset.id,
-      assetName: asset.label,
-      width,
-      height,
-      rendererInput: { qualityPreset: "studio-preview", cameraPolicy: "require", postprocess: false }
-    });
-    metadata.push(pipeline.metadata);
-  }
-  return metadata;
-}
-
-function resolveAssetUrl(file: string): string {
-  if (file.startsWith("/")) return file;
-  if (file.startsWith("fixtures/")) return `/${file}`;
-  if (file.includes("/")) return `/fixtures/${file}`;
-  return `/fixtures/asset-corpus/${file}`;
-}
-
-function resolveEnvironmentUrl(file: string): string {
-  if (file.startsWith("/")) return file;
-  if (file.startsWith("fixtures/")) return `/${file}`;
-  if (file.includes("/")) return `/fixtures/${file}`;
-  return `/fixtures/environment-corpus/hdri/${file}`;
-}
-
-async function fetchArrayBuffer(url: string): Promise<ArrayBuffer> {
-  const response = await fetch(url);
-  if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.status}`);
-  return await response.arrayBuffer();
-}

package/src/production-runtime/ProductionWorkflows.ts

@@ -1,203 +0,0 @@
-export type ProductionWorkflowId = "product" | "asset" | "material" | "architecture" | "cinematic";
-
-export interface ProductionWorkflowDefinition {
-  readonly id: ProductionWorkflowId;
-  readonly label: string;
-  readonly requiredAssetClasses: readonly string[];
-  readonly requiredRendererFeatures: readonly string[];
-  readonly requiredProof: readonly string[];
-  readonly differentiation: readonly string[];
-}
-
-export interface ProductionAssetPreflightInput {
-  readonly id: string;
-  readonly localPath?: string;
-  readonly sourceUri?: string;
-  readonly sha256?: string;
-  readonly bytes?: number;
-  readonly license?: string;
-  readonly tags?: readonly string[];
-  readonly renderRequirements?: readonly string[];
-}
-
-export interface ProductionAssetPreflightResult {
-  readonly assetId: string;
-  readonly pass: boolean;
-  readonly missing: readonly string[];
-  readonly warnings: readonly string[];
-}
-
-export interface ProductionVisualQAInput {
-  readonly screenshotPath: string;
-  readonly rendererBackend: string;
-  readonly realRendererProof: boolean;
-  readonly width: number;
-  readonly height: number;
-  readonly nonBlackPixels: number;
-  readonly uniqueColorBuckets: number;
-  readonly drawCalls: number;
-  readonly textureMemory: number;
-}
-
-export interface ProductionVisualQAResult {
-  readonly screenshotPath: string;
-  readonly pass: boolean;
-  readonly score: number;
-  readonly failures: readonly string[];
-}
-
-export interface ProductionRendererDefaults {
-  readonly workflowId: ProductionWorkflowId;
-  readonly backend: "webgl2";
-  readonly hdrEnvironmentId: "studio-small-08";
-  readonly qualityPreset: "hdr-studio-preview";
-  readonly camera: {
-    readonly policy: "require";
-    readonly paddingRatio: number;
-    readonly yawRadians: number;
-    readonly pitchRadians: number;
-  };
-  readonly postprocess: readonly string[];
-  readonly runtimeMetrics: readonly string[];
-}
-
-export interface ProductionWorkflowPlan {
-  readonly workflow: ProductionWorkflowDefinition;
-  readonly defaults: ProductionRendererDefaults;
-  readonly preflightRequired: true;
-  readonly visualQARequired: true;
-}
-
-export const PRODUCTION_WORKFLOWS: readonly ProductionWorkflowDefinition[] = [
-  {
-    id: "product",
-    label: "Product Configurator",
-    requiredAssetClasses: ["product"],
-    requiredRendererFeatures: ["real-webgl2-context", "pbr-materials", "hdr-ibl-ready", "pixel-readback"],
-    requiredProof: ["imported-glb", "hdr-environment", "draw-calls", "texture-memory", "canvas-screenshot"],
-    differentiation: ["runtime proof bundle", "material variant workflow", "developer metrics"]
-  },
-  {
-    id: "asset",
-    label: "Asset Inspector",
-    requiredAssetClasses: ["product", "character", "material"],
-    requiredRendererFeatures: ["real-webgl2-context", "imported-gltf-render-source", "pixel-readback"],
-    requiredProof: ["asset metadata", "skinning-or-morph-visibility", "corpus provenance"],
-    differentiation: ["asset preflight", "metadata and visual proof in one report"]
-  },
-  {
-    id: "material",
-    label: "Material Studio",
-    requiredAssetClasses: ["material"],
-    requiredRendererFeatures: ["pbr-materials", "hdr-ibl-ready", "texture-upload-diagnostics"],
-    requiredProof: ["material-extension-metadata", "hdr-lighting", "texture bindings"],
-    differentiation: ["extension coverage reporting", "visual QA score per material"]
-  },
-  {
-    id: "architecture",
-    label: "Architecture Viewer",
-    requiredAssetClasses: ["architecture", "product"],
-    requiredRendererFeatures: ["hdr-ibl-ready", "camera-framing", "pixel-readback"],
-    requiredProof: ["day-night-environment", "camera defaults", "visual quality metrics"],
-    differentiation: ["environment comparison", "inspection-ready camera defaults"]
-  },
-  {
-    id: "cinematic",
-    label: "Cinematic Postprocess",
-    requiredAssetClasses: ["product"],
-    requiredRendererFeatures: ["postprocess-presentation", "tone-mapping", "bloom", "fxaa"],
-    requiredProof: ["postprocess-chain", "nonblank diffable screenshot", "renderer diagnostics"],
-    differentiation: ["proof-backed postprocess presets", "gallery-ready output"]
-  }
-];
-
-export function listProductionWorkflowDefinitions(): readonly ProductionWorkflowDefinition[] {
-  return PRODUCTION_WORKFLOWS;
-}
-
-export function createProductionAssetPreflight(input: ProductionAssetPreflightInput): ProductionAssetPreflightResult {
-  const renderRequirements = input.renderRequirements ?? [];
-  const missing = [
-    ...(!input.id ? ["id"] : []),
-    ...(!input.localPath ? ["localPath"] : []),
-    ...(!input.sourceUri ? ["sourceUri"] : []),
-    ...(!input.sha256 ? ["sha256"] : []),
-    ...(!input.license ? ["license"] : []),
-    ...(!input.bytes || input.bytes <= 0 ? ["bytes"] : []),
-    ...(renderRequirements.length === 0 ? ["renderRequirements"] : [])
-  ];
-  const warnings = [
-    ...(!input.tags?.includes("pbr") ? ["Asset is not tagged as PBR; workflow may need material fallback."] : []),
-    ...(!renderRequirements.includes("hdrIbl") ? ["Asset does not declare HDR IBL as an asset-specific requirement; renderer workflow must provide fallback HDR lighting proof."] : []),
-    ...((input.bytes ?? 0) < 10_000 ? ["Asset is very small for visual parity proof."] : [])
-  ];
-  return {
-    assetId: input.id,
-    pass: missing.length === 0,
-    missing,
-    warnings
-  };
-}
-
-export function createProductionVisualQAResult(input: ProductionVisualQAInput): ProductionVisualQAResult {
-  const totalPixels = Math.max(1, input.width * input.height);
-  const coverage = input.nonBlackPixels / totalPixels;
-  const score = Number(Math.min(100, (
-    (input.realRendererProof ? 22 : 0) +
-    (input.rendererBackend === "webgl2" ? 12 : 0) +
-    Math.min(24, coverage * 30) +
-    Math.min(24, input.uniqueColorBuckets / 8) +
-    Math.min(10, input.drawCalls * 1.5) +
-    Math.min(8, input.textureMemory / 4_000_000)
-  )).toFixed(3));
-  const failures = [
-    ...(!input.realRendererProof ? ["missing-real-renderer-proof"] : []),
-    ...(input.rendererBackend !== "webgl2" ? ["unexpected-renderer-backend"] : []),
-    ...(input.width < 128 || input.height < 128 ? ["screenshot-too-small"] : []),
-    ...(input.nonBlackPixels <= 1000 ? ["blank-or-nearly-blank"] : []),
-    ...(input.uniqueColorBuckets <= 4 ? ["low-color-entropy"] : []),
-    ...(input.drawCalls <= 0 ? ["missing-draw-calls"] : [])
-  ];
-  return {
-    screenshotPath: input.screenshotPath,
-    pass: failures.length === 0 && score >= 40,
-    score,
-    failures
-  };
-}
-
-export function createProductionRendererDefaults(workflowId: ProductionWorkflowId): ProductionRendererDefaults {
-  const cameraByWorkflow: Record<ProductionWorkflowId, { readonly yawRadians: number; readonly pitchRadians: number; readonly paddingRatio: number }> = {
-    product: { yawRadians: -0.38, pitchRadians: -0.16, paddingRatio: 0.18 },
-    asset: { yawRadians: -0.34, pitchRadians: -0.14, paddingRatio: 0.2 },
-    material: { yawRadians: -0.42, pitchRadians: -0.16, paddingRatio: 0.22 },
-    architecture: { yawRadians: -0.52, pitchRadians: -0.2, paddingRatio: 0.24 },
-    cinematic: { yawRadians: -0.36, pitchRadians: -0.14, paddingRatio: 0.18 }
-  };
-  const camera = cameraByWorkflow[workflowId];
-  return {
-    workflowId,
-    backend: "webgl2",
-    hdrEnvironmentId: "studio-small-08",
-    qualityPreset: "hdr-studio-preview",
-    camera: {
-      policy: "require",
-      paddingRatio: camera.paddingRatio,
-      yawRadians: camera.yawRadians,
-      pitchRadians: camera.pitchRadians
-    },
-    postprocess: ["tone-mapping", "color-grade", "bloom", "fxaa"],
-    runtimeMetrics: ["appId", "sceneId", "rendererBackend", "assetIds", "hdrEnvironmentId", "drawCalls", "triangleCount", "materialCount", "textureCount", "textureMemoryEstimate", "frameTime"]
-  };
-}
-
-export function createProductionWorkflowPlan(workflowId: ProductionWorkflowId): ProductionWorkflowPlan {
-  const workflow = PRODUCTION_WORKFLOWS.find((item) => item.id === workflowId);
-  if (!workflow) throw new Error(`Unknown Production workflow: ${workflowId}`);
-  return {
-    workflow,
-    defaults: createProductionRendererDefaults(workflowId),
-    preflightRequired: true,
-    visualQARequired: true
-  };
-}

package/src/production-runtime/WorkflowDiagnostics.ts

@@ -1,2 +0,0 @@
-export interface WorkflowDiagnosticsSummary { readonly id: string; readonly ready: boolean; readonly workflow: string; }
-export function createWorkflowDiagnosticsSummary(): WorkflowDiagnosticsSummary { return { id: 'diagnostics', ready: true, workflow: 'WorkflowDiagnostics' }; }

package/src/production-runtime/index.ts

@@ -1,32 +0,0 @@
-export {
-  PRODUCTION_WORKFLOWS,
-  createProductionAssetPreflight,
-  createProductionRendererDefaults,
-  createProductionVisualQAResult,
-  createProductionWorkflowPlan,
-  listProductionWorkflowDefinitions
-} from "./ProductionWorkflows";
-export type {
-  ProductionAssetPreflightInput,
-  ProductionAssetPreflightResult,
-  ProductionRendererDefaults,
-  ProductionVisualQAInput,
-  ProductionVisualQAResult,
-  ProductionWorkflowDefinition,
-  ProductionWorkflowId,
-  ProductionWorkflowPlan
-} from "./ProductionWorkflows";
-export { runProductionExample } from "./ProductionExampleRuntime";
-export type {
-  ProductionExampleAsset,
-  ProductionExampleDefinition,
-  ProductionExampleEnvironment,
-  ProductionExampleRuntime,
-  ProductionExampleRuntimeMetrics
-} from "./ProductionExampleRuntime";
-export * from './ProductRenderWorkflow';
-export * from './AssetInspectionWorkflow';
-export * from './MaterialAuthoringWorkflow';
-export * from './ArchitectureWorkflow';
-export * from './CinematicWorkflow';
-export * from './WorkflowDiagnostics';

package/src/workflow-foundation/index.ts

@@ -1,27 +0,0 @@
-export { createAssetViewerWorkflow } from "../AssetViewerWorkflow";
-export { createProductConfiguratorWorkflow } from "../ProductConfiguratorWorkflow";
-export { createMaterialStudioWorkflow } from "../MaterialStudioWorkflow";
-export { createSceneShowcaseWorkflow } from "../SceneShowcaseWorkflow";
-export { createInteractiveSceneWorkflow } from "../InteractiveSceneWorkflow";
-export { createAnimationLabWorkflow } from "../AnimationLabWorkflow";
-export { createComparisonWorkflow } from "../ComparisonWorkflow";
-export { createWorkflowDiagnostics } from "../WorkflowDiagnostics";
-export type * from "../WorkflowTypes";
-
-import { createAnimationLabWorkflow } from "../AnimationLabWorkflow";
-import { createAssetViewerWorkflow } from "../AssetViewerWorkflow";
-import { createComparisonWorkflow } from "../ComparisonWorkflow";
-import { createInteractiveSceneWorkflow } from "../InteractiveSceneWorkflow";
-import { createMaterialStudioWorkflow } from "../MaterialStudioWorkflow";
-import { createProductConfiguratorWorkflow } from "../ProductConfiguratorWorkflow";
-import { createSceneShowcaseWorkflow } from "../SceneShowcaseWorkflow";
-
-export const workflows = {
-  assetViewer: createAssetViewerWorkflow,
-  productConfigurator: createProductConfiguratorWorkflow,
-  materialStudio: createMaterialStudioWorkflow,
-  sceneShowcase: createSceneShowcaseWorkflow,
-  interactiveScene: createInteractiveSceneWorkflow,
-  animationLab: createAnimationLabWorkflow,
-  comparison: createComparisonWorkflow
-} as const;