import type { AssetSpace } from "./assetSpace.js";
import type { CollisionMeshData } from "./collisionMesh.js";
/** Measured horizontal footprint, footprint center, and lowest Y of a model in model space. */
export interface ModelDims {
    footprint: {
        w: number;
        d: number;
    };
    center: {
        x: number;
        z: number;
    };
    minY: number;
    /** Highest Y in model space (pre-scale). `maxY - minY` is the measured model height; absent in indexes generated before it was measured. */
    maxY?: number;
}
export interface ModelAssetRef {
    url: string;
    /** Preserve a composed prefab's authored local origin instead of recentering its measured bounds. */
    anchor?: "center" | "origin";
    /** Measured at asset reindex: horizontal footprint, footprint center, and lowest Y in model space (pre-scale). Lets the shell auto-center and ground-snap corner-pivot kit models. */
    dims?: ModelDims;
    /** Opt-in compact triangle mesh extracted at asset reindex (see {@link "scene/collisionMesh".CollisionMeshData}) — feeds mesh-accurate hitboxes for concave models. */
    collisionMesh?: CollisionMeshData;
    /** Authored asset-space metadata — canonical facing (degrees), source-unit scale, footprint, anchor, bounds, and rotation policy. The upstream owner of placement corrections; see {@link "scene/assetSpace".AssetSpace}. */
    space?: AssetSpace;
    /** Animation clip names read from the GLB at asset reindex. Lets the shell auto-animate rigged catalog assets (semantic clip roles → default idle/walk/run + one-shots) with no game-side clip strings. */
    clips?: readonly string[];
}
/**
 * A catalog entry backed by a registered {@link registerAssetGenerator} instead of a GLB URL — a
 * slider-driven parametric prop (bookcase, building). `defaults` seeds a fresh placement's params.
 * Placed instances persist `{ assetId, params, seed }` in the scene and re-resolve at runtime.
 */
export interface GeneratorAssetRef {
    kind: "generator";
    /** Id of the registered generator this asset resolves through. */
    generatorId: string;
    /** Default params stamped onto a fresh placement's meta. */
    defaults?: Record<string, unknown>;
    /** Authored asset-space metadata — canonical facing (degrees), footprint, anchor, bounds, and rotation policy; see {@link "scene/assetSpace".AssetSpace}. */
    space?: AssetSpace;
}
/** A catalog entry: a static GLB model, or a parametric generator. */
export type AssetRef = ModelAssetRef | GeneratorAssetRef;
/** True when a catalog entry is a parametric generator rather than a static GLB. @internal */
export declare function isGeneratorAsset(ref: AssetRef): ref is GeneratorAssetRef;
export interface AssetCatalog<TMeta extends ModelAssetRef = ModelAssetRef> {
    register(id: string, asset: TMeta): void;
    resolve(id: string): TMeta | null;
    has(id: string): boolean;
    ids(): readonly string[];
}
export declare function createAssetCatalog<TMeta extends ModelAssetRef = ModelAssetRef>(): AssetCatalog<TMeta>;