@aura3d/engine 1.3.3 → 1.4.1

package/dist/engine/agent-api/SceneGroundingUtils.d.ts

@@ -36,8 +36,50 @@ export interface GroundedPlacement {
     readonly position: readonly [number, number, number];
     readonly scale: number;
 }
+export interface RenderGroundedPlacementOptions {
+    /** Desired rendered height in Aura world units. Mutually exclusive with `targetMaxDimension`. */
+    readonly targetHeight?: number | undefined;
+    /** Desired rendered largest dimension in Aura world units. Used when `targetHeight` is omitted. */
+    readonly targetMaxDimension?: number | undefined;
+    /** Floor X position for the placement (defaults to 0). */
+    readonly x?: number | undefined;
+    /** Floor Z position for the placement (defaults to 0). */
+    readonly z?: number | undefined;
+    /** World Y of the floor the asset should rest on (defaults to 0). */
+    readonly floorY?: number | undefined;
+    /**
+     * The default largest dimension produced by Aura3D's safe model renderer
+     * before user scale is applied. Keep this aligned with the renderer's
+     * internal `createModelMatrix(..., normalizeToUnit = true)` fit size.
+     */
+    readonly normalizedMaxDimension?: number | undefined;
+}
+export interface SceneAssetBoundsMetadata {
+    readonly min?: readonly number[] | undefined;
+    readonly max?: readonly number[] | undefined;
+    readonly size?: readonly number[] | undefined;
+    readonly center?: readonly number[] | undefined;
+}
+export interface SceneAssetLike {
+    readonly bounds?: readonly number[] | undefined;
+    readonly metadata?: {
+        readonly boundsMetadata?: SceneAssetBoundsMetadata | undefined;
+    } | undefined;
+}
+export interface AssetGroundedPlacement extends GroundedPlacement {
+    readonly bounds: SceneBounds;
+    readonly height: number;
+}
+export interface RenderGroundedAssetPlacement extends AssetGroundedPlacement {
+    readonly maxDimension: number;
+}
+export declare const AURA_NORMALIZED_MODEL_MAX_DIMENSION = 1.55;
 /** Height (Y extent) of the bounds in the asset's own local units. */
 export declare function boundsHeight(bounds: SceneBounds): number;
+/** Width/depth/height extents for a bounds object. */
+export declare function boundsSize(bounds: SceneBounds): Vec3;
+/** Largest finite positive extent for a bounds object. */
+export declare function boundsMaxDimension(bounds: SceneBounds): number;
 /**
  * Y translation that puts the asset's lowest point on the floor.
  *
@@ -56,6 +98,25 @@ export declare function groundedYOffset(bounds: SceneBounds): number;
  * is non-positive, so callers never produce NaN/Infinity scales.
  */
 export declare function normalizedScaleForTargetHeight(bounds: SceneBounds, targetHeight: number): number;
+/** Uniform scale factor so the largest bounds extent equals `targetMaxDimension`. */
+export declare function normalizedScaleForTargetMaxDimension(bounds: SceneBounds, targetMaxDimension: number): number;
+/**
+ * Scale for Aura3D's safe model renderer, which first normalizes GLBs to a
+ * stable largest dimension and then applies user scale.
+ *
+ * Use this when writing normal `model(asset).scale(...)` examples. Use
+ * `normalizedScaleForTargetMaxDimension` only when you are bypassing the safe
+ * model renderer and working in raw asset-local units.
+ */
+export declare function normalizedRenderScaleForTargetMaxDimension(targetMaxDimension: number, normalizedMaxDimension?: number): number;
+/**
+ * Scale for Aura3D's safe model renderer so the rendered height hits a target.
+ *
+ * The renderer's default maximum dimension is fixed, but the default rendered
+ * height depends on the GLB's aspect ratio. This preserves each asset's aspect
+ * ratio while making characters and props comparable on screen.
+ */
+export declare function normalizedRenderScaleForTargetHeight(bounds: SceneBounds, targetHeight: number, normalizedMaxDimension?: number): number;
 /**
  * Resolve a deterministic grounded placement for an asset.
  *
@@ -64,6 +125,31 @@ export declare function normalizedScaleForTargetHeight(bounds: SceneBounds, targ
  * same scale so the lowest point lands precisely on the floor after scaling.
  */
 export declare function groundedPlacement(bounds: SceneBounds, options: GroundedPlacementOptions): GroundedPlacement;
+/**
+ * Build bounds from a generated typed asset record.
+ *
+ * Prefer `metadata.boundsMetadata.min/max` because it preserves the real pivot
+ * and grounding offset from inspection. Fall back to the legacy `bounds` size
+ * array when only extents are available.
+ */
+export declare function boundsFromAsset(asset: SceneAssetLike): SceneBounds;
+/**
+ * Resolve a grounded placement directly from a typed asset record.
+ *
+ * This is the helper public examples should use instead of route-local scale
+ * math. It keeps primary GLBs grounded even when the catalog asset has a
+ * center-origin or extreme native units.
+ */
+export declare function groundedAssetPlacement(asset: SceneAssetLike, options: GroundedPlacementOptions): AssetGroundedPlacement;
+/**
+ * Resolve placement for normal public `model(asset)` usage.
+ *
+ * Aura3D's safe renderer already translates GLBs so their lowest local point
+ * rests on the node's `position.y` after normalization. Therefore render-safe
+ * grounded placement sets `position.y` directly to `floorY` and returns a scale
+ * compatible with the renderer's normalized model size.
+ */
+export declare function groundedRenderedAssetPlacement(asset: SceneAssetLike, options: RenderGroundedPlacementOptions): RenderGroundedAssetPlacement;
 /**
  * Convenience adapter: build {@link SceneBounds} from a `size` extent and an
  * optional `center`, matching the shape stored in `boundsMetadata`. When no

package/dist/engine/agent-api/SceneGroundingUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneGroundingUtils.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/SceneGroundingUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAIhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAO3G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,IAAgB,GAAG,WAAW,CAKhF"}
+{"version":3,"file":"SceneGroundingUtils.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/SceneGroundingUtils.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/SceneGroundingUtils.js

@@ -16,10 +16,23 @@
  * They are intentionally dependency-free and side-effect-free so they can be
  * unit tested in isolation and reused by any template or runtime.
  */
+export const AURA_NORMALIZED_MODEL_MAX_DIMENSION = 1.55;
 /** Height (Y extent) of the bounds in the asset's own local units. */
 export function boundsHeight(bounds) {
     return bounds.max[1] - bounds.min[1];
 }
+/** Width/depth/height extents for a bounds object. */
+export function boundsSize(bounds) {
+    return [
+        bounds.max[0] - bounds.min[0],
+        bounds.max[1] - bounds.min[1],
+        bounds.max[2] - bounds.min[2]
+    ];
+}
+/** Largest finite positive extent for a bounds object. */
+export function boundsMaxDimension(bounds) {
+    return Math.max(...boundsSize(bounds).filter((value) => Number.isFinite(value) && value > 0), 0);
+}
 /**
  * Y translation that puts the asset's lowest point on the floor.
  *
@@ -45,6 +58,41 @@ export function normalizedScaleForTargetHeight(bounds, targetHeight) {
         return 1;
     return targetHeight / height;
 }
+/** Uniform scale factor so the largest bounds extent equals `targetMaxDimension`. */
+export function normalizedScaleForTargetMaxDimension(bounds, targetMaxDimension) {
+    const maxDimension = boundsMaxDimension(bounds);
+    if (!(maxDimension > 0) || !(targetMaxDimension > 0))
+        return 1;
+    return targetMaxDimension / maxDimension;
+}
+/**
+ * Scale for Aura3D's safe model renderer, which first normalizes GLBs to a
+ * stable largest dimension and then applies user scale.
+ *
+ * Use this when writing normal `model(asset).scale(...)` examples. Use
+ * `normalizedScaleForTargetMaxDimension` only when you are bypassing the safe
+ * model renderer and working in raw asset-local units.
+ */
+export function normalizedRenderScaleForTargetMaxDimension(targetMaxDimension, normalizedMaxDimension = AURA_NORMALIZED_MODEL_MAX_DIMENSION) {
+    if (!(targetMaxDimension > 0) || !(normalizedMaxDimension > 0))
+        return 1;
+    return targetMaxDimension / normalizedMaxDimension;
+}
+/**
+ * Scale for Aura3D's safe model renderer so the rendered height hits a target.
+ *
+ * The renderer's default maximum dimension is fixed, but the default rendered
+ * height depends on the GLB's aspect ratio. This preserves each asset's aspect
+ * ratio while making characters and props comparable on screen.
+ */
+export function normalizedRenderScaleForTargetHeight(bounds, targetHeight, normalizedMaxDimension = AURA_NORMALIZED_MODEL_MAX_DIMENSION) {
+    const rawMaxDimension = boundsMaxDimension(bounds);
+    const rawHeight = boundsHeight(bounds);
+    if (!(rawMaxDimension > 0) || !(rawHeight > 0) || !(targetHeight > 0) || !(normalizedMaxDimension > 0))
+        return 1;
+    const defaultRenderedHeight = rawHeight / rawMaxDimension * normalizedMaxDimension;
+    return targetHeight / defaultRenderedHeight;
+}
 /**
  * Resolve a deterministic grounded placement for an asset.
  *
@@ -60,6 +108,68 @@ export function groundedPlacement(bounds, options) {
     const y = floorY + groundedYOffset(bounds) * scale;
     return { position: [x, y, z], scale };
 }
+/**
+ * Build bounds from a generated typed asset record.
+ *
+ * Prefer `metadata.boundsMetadata.min/max` because it preserves the real pivot
+ * and grounding offset from inspection. Fall back to the legacy `bounds` size
+ * array when only extents are available.
+ */
+export function boundsFromAsset(asset) {
+    const metadata = asset.metadata?.boundsMetadata;
+    const min = toVec3(metadata?.min);
+    const max = toVec3(metadata?.max);
+    if (min && max)
+        return { min, max };
+    const size = toVec3(metadata?.size) ?? toVec3(asset.bounds);
+    const center = toVec3(metadata?.center);
+    if (size)
+        return boundsFromSize(size, center ?? [0, 0, 0]);
+    return boundsFromSize([1, 1, 1]);
+}
+/**
+ * Resolve a grounded placement directly from a typed asset record.
+ *
+ * This is the helper public examples should use instead of route-local scale
+ * math. It keeps primary GLBs grounded even when the catalog asset has a
+ * center-origin or extreme native units.
+ */
+export function groundedAssetPlacement(asset, options) {
+    const bounds = boundsFromAsset(asset);
+    const placement = groundedPlacement(bounds, options);
+    return {
+        ...placement,
+        bounds,
+        height: boundsHeight(bounds) * placement.scale
+    };
+}
+/**
+ * Resolve placement for normal public `model(asset)` usage.
+ *
+ * Aura3D's safe renderer already translates GLBs so their lowest local point
+ * rests on the node's `position.y` after normalization. Therefore render-safe
+ * grounded placement sets `position.y` directly to `floorY` and returns a scale
+ * compatible with the renderer's normalized model size.
+ */
+export function groundedRenderedAssetPlacement(asset, options) {
+    const bounds = boundsFromAsset(asset);
+    const rawMaxDimension = boundsMaxDimension(bounds);
+    const normalizedMaxDimension = options.normalizedMaxDimension ?? AURA_NORMALIZED_MODEL_MAX_DIMENSION;
+    const scale = options.targetHeight !== undefined
+        ? normalizedRenderScaleForTargetHeight(bounds, options.targetHeight, normalizedMaxDimension)
+        : normalizedRenderScaleForTargetMaxDimension(options.targetMaxDimension ?? normalizedMaxDimension, normalizedMaxDimension);
+    const height = rawMaxDimension > 0
+        ? boundsHeight(bounds) / rawMaxDimension * normalizedMaxDimension * scale
+        : boundsHeight(bounds) * scale;
+    const maxDimension = normalizedMaxDimension * scale;
+    return {
+        position: [options.x ?? 0, options.floorY ?? 0, options.z ?? 0],
+        scale,
+        bounds,
+        height,
+        maxDimension
+    };
+}
 /**
  * Convenience adapter: build {@link SceneBounds} from a `size` extent and an
  * optional `center`, matching the shape stored in `boundsMetadata`. When no
@@ -71,4 +181,10 @@ export function boundsFromSize(size, center = [0, 0, 0]) {
         max: [center[0] + size[0] / 2, center[1] + size[1] / 2, center[2] + size[2] / 2]
     };
 }
+function toVec3(value) {
+    if (!value || value.length < 3)
+        return undefined;
+    const vec = [Number(value[0]), Number(value[1]), Number(value[2])];
+    return vec.every((component) => Number.isFinite(component)) ? vec : undefined;
+}
 //# sourceMappingURL=SceneGroundingUtils.js.map

package/dist/engine/agent-api/SceneGroundingUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneGroundingUtils.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/SceneGroundingUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0BH,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAmB,EAAE,YAAoB;IACtF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACnD,OAAO,YAAY,GAAG,MAAM,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,OAAiC;IACtF,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,MAAM,CAAC,GAAG,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;IACnD,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,SAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO;QACL,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChF,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;KACjF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"SceneGroundingUtils.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/SceneGroundingUtils.ts"],"names":[],"mappings":"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"}