@aura3d/product-studio 1.0.6

package/src/ProductShowcaseLayout.ts

@@ -0,0 +1,90 @@
+export type ProductShowcaseSlot = "hero" | "left-detail" | "left-transparent" | "right-variant";
+
+export interface ProductShowcaseSlotInput {
+  readonly assetId: string;
+  readonly slot: ProductShowcaseSlot;
+  readonly materialVariantControl?: string;
+  readonly defaultMaterialVariant?: string;
+}
+
+export interface ProductShowcaseLayoutItem {
+  readonly assetId: string;
+  readonly slot: ProductShowcaseSlot;
+  readonly position: readonly [number, number, number];
+  readonly scale: readonly [number, number, number];
+  readonly targetHeight: number;
+  readonly yawRadians: number;
+  readonly turntableSpeedRadiansPerSecond: number;
+  readonly materialVariantControl?: string;
+  readonly defaultMaterialVariant?: string;
+}
+
+export interface ProductShowcaseFrame {
+  readonly boundsMin: readonly [number, number, number];
+  readonly boundsMax: readonly [number, number, number];
+  readonly heroPaddingRatio: number;
+}
+
+export interface ProductShowcaseLayout {
+  readonly schema: "a3d-product-showcase-layout";
+  readonly mode: "hero-product-with-secondary-detail";
+  readonly items: readonly ProductShowcaseLayoutItem[];
+  readonly frame: ProductShowcaseFrame;
+  readonly limitations: readonly string[];
+}
+
+const COMPACT_SLOT_LAYOUT: Record<ProductShowcaseSlot, Omit<ProductShowcaseLayoutItem, "assetId" | "slot" | "materialVariantControl" | "defaultMaterialVariant">> = {
+  hero: {
+    position: [-0.28, -0.88, 0.0],
+    scale: [1, 1, 1],
+    targetHeight: 0.92,
+    yawRadians: -0.38,
+    turntableSpeedRadiansPerSecond: 0.001
+  },
+  "left-detail": {
+    position: [-2.28, -0.86, -0.72],
+    scale: [1, 1, 1],
+    targetHeight: 0.24,
+    yawRadians: 0.34,
+    turntableSpeedRadiansPerSecond: 0.1
+  },
+  "left-transparent": {
+    position: [-2.36, -0.87, 0.68],
+    scale: [1, 1, 1],
+    targetHeight: 0.11,
+    yawRadians: 0.58,
+    turntableSpeedRadiansPerSecond: 0.06
+  },
+  "right-variant": {
+    position: [2.34, -0.86, 0.58],
+    scale: [1, 1, 1],
+    targetHeight: 0.24,
+    yawRadians: -0.82,
+    turntableSpeedRadiansPerSecond: 0.08
+  }
+};
+
+const COMPACT_FRAME: ProductShowcaseFrame = {
+  boundsMin: [-1.3, -1.0, -0.78],
+  boundsMax: [1.3, 0.5, 0.86],
+  heroPaddingRatio: 0.02
+};
+
+export function createProductShowcaseLayout(slots: readonly ProductShowcaseSlotInput[]): ProductShowcaseLayout {
+  return {
+    schema: "a3d-product-showcase-layout",
+    mode: "hero-product-with-secondary-detail",
+    items: slots.map((slot) => ({
+      assetId: slot.assetId,
+      slot: slot.slot,
+      ...COMPACT_SLOT_LAYOUT[slot.slot],
+      ...(slot.materialVariantControl ? { materialVariantControl: slot.materialVariantControl } : {}),
+      ...(slot.defaultMaterialVariant ? { defaultMaterialVariant: slot.defaultMaterialVariant } : {})
+    })),
+    frame: COMPACT_FRAME,
+    limitations: [
+      "This layout helper owns deterministic hero-first product staging and camera bounds; secondary products remain loaded but are kept outside the default hero frame so they cannot read as debris attached to the car.",
+      "The layout does not infer a semantic part graph from imported GLBs; imported mesh triangle picking, authored exploded timelines, and physical contact shadows remain separate engine/runtime capabilities."
+    ]
+  };
+}

package/src/ProductStudio.ts

@@ -0,0 +1,72 @@
+import { Renderer } from "@aura3d/rendering";
+import { createProductCameraFrame } from "./ProductCamera";
+import { exportProductRender, exportProductSceneManifest } from "./ProductExport";
+import { createProductLightingPreset } from "./ProductLighting";
+import { createProductMaterialMode } from "./ProductMaterials";
+import type {
+  ProductAsset,
+  ProductCameraFrame,
+  ProductCameraPreset,
+  ProductExportResult,
+  ProductLightingConfig,
+  ProductLightingPreset,
+  ProductMaterialMode,
+  ProductMaterialModeId,
+  ProductRenderScene,
+  ProductSceneManifest,
+  ProductStudio,
+  ProductStudioOptions
+} from "./ProductTypes";
+
+export async function createProductStudio(options: ProductStudioOptions = {}): Promise<ProductStudio> {
+  const renderer = await Renderer.create({
+    clearColor: [0.03, 0.035, 0.038, 1],
+    width: options.width ?? 1280,
+    height: options.height ?? 900,
+    ...options
+  });
+  return new ProductStudioRuntime(renderer, options.canvas);
+}
+
+class ProductStudioRuntime implements ProductStudio {
+  constructor(
+    public readonly renderer: Renderer,
+    private readonly canvas?: HTMLCanvasElement | OffscreenCanvas
+  ) {}
+
+  render(scene: ProductRenderScene) {
+    return this.renderer.render(scene.source, scene.camera);
+  }
+
+  resize(width: number, height: number): void {
+    this.renderer.resize(width, height);
+  }
+
+  setLighting(preset: ProductLightingPreset): ProductLightingConfig {
+    return createProductLightingPreset(preset);
+  }
+
+  setCamera(asset: ProductAsset, preset: ProductCameraPreset, viewport = { width: 1280, height: 900 }): ProductCameraFrame {
+    return createProductCameraFrame(asset, { preset, viewport });
+  }
+
+  setMaterialMode(mode: ProductMaterialModeId): ProductMaterialMode {
+    return createProductMaterialMode(mode);
+  }
+
+  async exportPng(scene: ProductRenderScene): Promise<ProductExportResult> {
+    if (!this.canvas) {
+      throw new Error("ProductStudio exportPng requires a canvas-backed studio.");
+    }
+    this.render(scene);
+    return exportProductRender(this.canvas, scene);
+  }
+
+  exportSceneManifest(scene: ProductRenderScene): ProductSceneManifest {
+    return exportProductSceneManifest(scene);
+  }
+
+  dispose(): void {
+    this.renderer.dispose();
+  }
+}

package/src/ProductTypes.ts

@@ -0,0 +1,158 @@
+import type { GLTFAsset, GLTFRenderResources } from "@aura3d/assets";
+import type {
+  CameraLike,
+  CollectedLight,
+  EnvironmentLightingOptions,
+  PerspectiveCameraFrame,
+  RenderDeviceDiagnostics,
+  RenderItem,
+  Renderer,
+  RendererOptions,
+  RendererPostProcessOptions,
+  RendererShadowOptions,
+  RenderSource
+} from "@aura3d/rendering";
+
+export type ProductAssetId = "camera-kit" | "speaker" | "watch" | (string & {});
+export type ProductLightingPreset = "catalog-softbox" | "inspection-bay" | "hero-contrast";
+export type ProductCameraPreset = "front-three-quarter" | "side-profile" | "top-detail" | "macro-detail";
+export type ProductMaterialModeId = "asset" | "clay" | "matte" | "metal-check" | "contrast";
+
+export interface ProductPartDescriptor {
+  readonly name: string;
+  readonly material: string;
+  readonly shape?: string;
+}
+
+export interface ProductMaterialDescriptor {
+  readonly name: string;
+  readonly metallic: number;
+  readonly roughness: number;
+  readonly alphaMode: "OPAQUE" | "BLEND" | "MASK";
+  readonly textureSet?: string;
+}
+
+export interface ProductManifest {
+  readonly schema: string;
+  readonly id: ProductAssetId;
+  readonly title: string;
+  readonly category: string;
+  readonly gltf: string;
+  readonly parts: readonly ProductPartDescriptor[];
+  readonly materials: readonly ProductMaterialDescriptor[];
+  readonly rejectedInputs?: readonly string[];
+  readonly requirements?: Readonly<Record<string, unknown>>;
+}
+
+export interface ProductAsset {
+  readonly id: ProductAssetId;
+  readonly title: string;
+  readonly category: string;
+  readonly url: string;
+  readonly manifest: ProductManifest;
+  readonly gltf: GLTFAsset;
+  readonly resources: GLTFRenderResources;
+  readonly parts: readonly ProductPartDescriptor[];
+  readonly materials: readonly ProductMaterialDescriptor[];
+}
+
+export interface ProductAssetLoadOptions {
+  readonly url: string;
+  readonly manifestUrl?: string;
+  readonly id?: ProductAssetId;
+  readonly title?: string;
+  readonly category?: string;
+}
+
+export interface ProductLightingConfig {
+  readonly preset: ProductLightingPreset;
+  readonly environmentLighting: EnvironmentLightingOptions;
+  readonly postprocess: RendererPostProcessOptions;
+  readonly shadow: RendererShadowOptions;
+  readonly lights: readonly CollectedLight[];
+}
+
+export interface ProductCameraFrame {
+  readonly preset: ProductCameraPreset;
+  readonly frame: PerspectiveCameraFrame;
+  readonly camera: CameraLike;
+}
+
+export interface ProductCameraOptions {
+  readonly preset?: ProductCameraPreset;
+  readonly viewport?: {
+    readonly width: number;
+    readonly height: number;
+  };
+  readonly paddingRatio?: number;
+}
+
+export interface ProductMaterialMode {
+  readonly id: ProductMaterialModeId;
+  readonly label: string;
+  readonly description: string;
+}
+
+export interface ProductRenderSceneOptions {
+  readonly lighting?: ProductLightingConfig;
+  readonly camera?: ProductCameraFrame;
+  readonly materialMode?: ProductMaterialMode;
+  readonly floor?: boolean;
+}
+
+export interface ProductRenderScene {
+  readonly asset: ProductAsset;
+  readonly source: RenderSource;
+  readonly camera: CameraLike;
+  readonly cameraFrame: ProductCameraFrame;
+  readonly lighting: ProductLightingConfig;
+  readonly materialMode: ProductMaterialMode;
+  readonly renderItems: readonly RenderItem[];
+}
+
+export interface ProductDiagnostics {
+  readonly assetId: ProductAssetId;
+  readonly partCount: number;
+  readonly materialCount: number;
+  readonly textureCount: number;
+  readonly meshCount: number;
+  readonly warnings: readonly string[];
+  readonly renderDiagnostics?: RenderDeviceDiagnostics;
+}
+
+export interface ProductSceneManifest {
+  readonly schema: "a3d-product-studio-scene";
+  readonly assetId: ProductAssetId;
+  readonly title: string;
+  readonly partCount: number;
+  readonly materialCount: number;
+  readonly materialMode: ProductMaterialModeId;
+  readonly lightingPreset: ProductLightingPreset;
+  readonly cameraPreset: ProductCameraPreset;
+  readonly generatedAt: string;
+}
+
+export interface ProductExportResult {
+  readonly mimeType: "image/png";
+  readonly dataUrl: string;
+  readonly byteLength: number;
+  readonly manifest: ProductSceneManifest;
+}
+
+export interface ProductStudioOptions extends RendererOptions {
+  readonly canvas?: HTMLCanvasElement | OffscreenCanvas;
+  readonly width?: number;
+  readonly height?: number;
+}
+
+export interface ProductStudio {
+  readonly renderer: Renderer;
+  render(scene: ProductRenderScene): RenderDeviceDiagnostics;
+  resize(width: number, height: number): void;
+  setLighting(preset: ProductLightingPreset): ProductLightingConfig;
+  setCamera(asset: ProductAsset, preset: ProductCameraPreset, viewport?: { readonly width: number; readonly height: number }): ProductCameraFrame;
+  setMaterialMode(mode: ProductMaterialModeId): ProductMaterialMode;
+  exportPng(scene: ProductRenderScene): Promise<ProductExportResult>;
+  exportSceneManifest(scene: ProductRenderScene): ProductSceneManifest;
+  dispose(): void;
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+export { loadProductAsset } from "./ProductAssetLoader";
+export { createProductCameraFrame, validateProductCameraFrame } from "./ProductCamera";
+export { createProductDiagnostics } from "./ProductDiagnostics";
+export { exportProductRender, exportProductSceneManifest } from "./ProductExport";
+export { createProductFloor } from "./ProductFloor";
+export { createProductLightingPreset } from "./ProductLighting";
+export { applyProductMaterialMode, createProductMaterialMode } from "./ProductMaterials";
+export { createProductRenderScene, updateProductRenderScene } from "./ProductRenderScene";
+export { createProductShowcaseLayout } from "./ProductShowcaseLayout";
+export { createProductStudio } from "./ProductStudio";
+export type * from "./ProductTypes";
+export type * from "./ProductShowcaseLayout";