@aura3d/workflows 1.0.6

package/dist/production-runtime/ProductionWorkflows.js

@@ -0,0 +1,128 @@
+export const PRODUCTION_WORKFLOWS = [
+    {
+        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() {
+    return PRODUCTION_WORKFLOWS;
+}
+export function createProductionAssetPreflight(input) {
+    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) {
+    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) {
+    const cameraByWorkflow = {
+        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) {
+    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
+    };
+}
+//# sourceMappingURL=ProductionWorkflows.js.map

package/dist/production-runtime/ProductionWorkflows.js.map

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

package/dist/production-runtime/WorkflowDiagnostics.d.ts

@@ -0,0 +1,7 @@
+export interface WorkflowDiagnosticsSummary {
+    readonly id: string;
+    readonly ready: boolean;
+    readonly workflow: string;
+}
+export declare function createWorkflowDiagnosticsSummary(): WorkflowDiagnosticsSummary;
+//# sourceMappingURL=WorkflowDiagnostics.d.ts.map

package/dist/production-runtime/WorkflowDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowDiagnostics.d.ts","sourceRoot":"","sources":["../../../../../packages/workflows/src/production-runtime/WorkflowDiagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAAE;AACxH,wBAAgB,gCAAgC,IAAI,0BAA0B,CAAgF"}

package/dist/production-runtime/WorkflowDiagnostics.js

@@ -0,0 +1,2 @@
+export function createWorkflowDiagnosticsSummary() { return { id: 'diagnostics', ready: true, workflow: 'WorkflowDiagnostics' }; }
+//# sourceMappingURL=WorkflowDiagnostics.js.map

package/dist/production-runtime/WorkflowDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowDiagnostics.js","sourceRoot":"","sources":["../../../../../packages/workflows/src/production-runtime/WorkflowDiagnostics.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,gCAAgC,KAAiC,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC"}

package/dist/production-runtime/index.d.ts

@@ -0,0 +1,11 @@
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/production-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/workflows/src/production-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,+BAA+B,EAChC,MAAM,4BAA4B,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/production-runtime/index.js

@@ -0,0 +1,9 @@
+export { PRODUCTION_WORKFLOWS, createProductionAssetPreflight, createProductionRendererDefaults, createProductionVisualQAResult, createProductionWorkflowPlan, listProductionWorkflowDefinitions } from "./ProductionWorkflows.js";
+export { runProductionExample } from "./ProductionExampleRuntime.js";
+export * from './ProductRenderWorkflow.js';
+export * from './AssetInspectionWorkflow.js';
+export * from './MaterialAuthoringWorkflow.js';
+export * from './ArchitectureWorkflow.js';
+export * from './CinematicWorkflow.js';
+export * from './WorkflowDiagnostics.js';
+//# sourceMappingURL=index.js.map

package/dist/production-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/workflows/src/production-runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAQlE,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/workflow-foundation/index.d.ts

@@ -0,0 +1,26 @@
+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 declare const workflows: {
+    readonly assetViewer: typeof createAssetViewerWorkflow;
+    readonly productConfigurator: typeof createProductConfiguratorWorkflow;
+    readonly materialStudio: typeof createMaterialStudioWorkflow;
+    readonly sceneShowcase: typeof createSceneShowcaseWorkflow;
+    readonly interactiveScene: typeof createInteractiveSceneWorkflow;
+    readonly animationLab: typeof createAnimationLabWorkflow;
+    readonly comparison: typeof createComparisonWorkflow;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow-foundation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/workflows/src/workflow-foundation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,mBAAmB,kBAAkB,CAAC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC"}

package/dist/workflow-foundation/index.js

@@ -0,0 +1,25 @@
+export { createAssetViewerWorkflow } from "../AssetViewerWorkflow.js";
+export { createProductConfiguratorWorkflow } from "../ProductConfiguratorWorkflow.js";
+export { createMaterialStudioWorkflow } from "../MaterialStudioWorkflow.js";
+export { createSceneShowcaseWorkflow } from "../SceneShowcaseWorkflow.js";
+export { createInteractiveSceneWorkflow } from "../InteractiveSceneWorkflow.js";
+export { createAnimationLabWorkflow } from "../AnimationLabWorkflow.js";
+export { createComparisonWorkflow } from "../ComparisonWorkflow.js";
+export { createWorkflowDiagnostics } from "../WorkflowDiagnostics.js";
+import { createAnimationLabWorkflow } from "../AnimationLabWorkflow.js";
+import { createAssetViewerWorkflow } from "../AssetViewerWorkflow.js";
+import { createComparisonWorkflow } from "../ComparisonWorkflow.js";
+import { createInteractiveSceneWorkflow } from "../InteractiveSceneWorkflow.js";
+import { createMaterialStudioWorkflow } from "../MaterialStudioWorkflow.js";
+import { createProductConfiguratorWorkflow } from "../ProductConfiguratorWorkflow.js";
+import { createSceneShowcaseWorkflow } from "../SceneShowcaseWorkflow.js";
+export const workflows = {
+    assetViewer: createAssetViewerWorkflow,
+    productConfigurator: createProductConfiguratorWorkflow,
+    materialStudio: createMaterialStudioWorkflow,
+    sceneShowcase: createSceneShowcaseWorkflow,
+    interactiveScene: createInteractiveSceneWorkflow,
+    animationLab: createAnimationLabWorkflow,
+    comparison: createComparisonWorkflow
+};
+//# sourceMappingURL=index.js.map

package/dist/workflow-foundation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/workflows/src/workflow-foundation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,yBAAyB;IACtC,mBAAmB,EAAE,iCAAiC;IACtD,cAAc,EAAE,4BAA4B;IAC5C,aAAa,EAAE,2BAA2B;IAC1C,gBAAgB,EAAE,8BAA8B;IAChD,YAAY,EAAE,0BAA0B;IACxC,UAAU,EAAE,wBAAwB;CAC5B,CAAC"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@aura3d/workflows",
+  "version": "1.0.6",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@aura3d/animation": "1.0.6",
+    "@aura3d/assets": "1.0.6",
+    "@aura3d/product-studio": "1.0.6",
+    "@aura3d/engine": "1.0.6",
+    "@aura3d/scene": "1.0.6",
+    "@aura3d/rendering": "1.0.6"
+  },
+  "sideEffects": false
+}

package/src/AnimationLabWorkflow.ts

@@ -0,0 +1,165 @@
+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

@@ -0,0 +1,37 @@
+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

@@ -0,0 +1,68 @@
+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

@@ -0,0 +1,44 @@
+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

@@ -0,0 +1,48 @@
+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
+  };
+}