@aura3d/cli 1.3.3 → 1.4.1

package/README.md

@@ -0,0 +1,88 @@
+# @aura3d/cli
+
+Aura3D CLI for typed GLB/glTF assets, asset provenance, validation,
+diagnostics, screenshots, and deploy checks.
+
+```bash
+npx @aura3d/cli@latest doctor
+```
+
+## Asset Workflow
+
+Add a local GLB/glTF asset and generate typed references:
+
+```bash
+npx @aura3d/cli@latest assets add ./assets/robot.glb --name robot
+npx @aura3d/cli@latest assets typegen
+```
+
+Search the Aura3D asset catalog:
+
+```bash
+npx @aura3d/cli@latest assets search "battle-worn knight helmet"
+```
+
+Resolve a verified catalog candidate into the local typed asset pipeline:
+
+```bash
+npx @aura3d/cli@latest assets resolve "battle-worn knight helmet" --name helmet
+```
+
+Then render the generated asset reference from a public Aura3D route:
+
+```ts
+import { createAuraApp, lights, model, scene } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+
+createAuraApp("#app", {
+  scene: scene().add(model(assets.helmet)).add(lights.studio())
+});
+```
+
+## Commands
+
+Common commands:
+
+```bash
+npx @aura3d/cli@latest assets add ./model.glb --name model
+npx @aura3d/cli@latest assets search "studio robot" --json
+npx @aura3d/cli@latest assets resolve "studio robot" --name robot
+npx @aura3d/cli@latest assets inspect ./model.glb --animation --humanoid
+npx @aura3d/cli@latest assets validate --source --release
+npx @aura3d/cli@latest assets validate-game --profile fighting-character --asset fighter
+npx @aura3d/cli@latest assets validate-animation --clips idle,walk,run
+npx @aura3d/cli@latest assets assemble-character --name hero --body heroBody --part hair=heroHair
+npx @aura3d/cli@latest check-deploy --dist dist
+npx @aura3d/cli@latest init --agent all
+```
+
+## What It Writes
+
+The asset commands maintain:
+
+- `aura.assets.json` for asset manifest, source, license, quality, role, and
+  provenance metadata;
+- `src/aura-assets.ts` for generated TypeScript asset references;
+- copied asset files under the configured public asset directory.
+
+Public Aura3D examples should use generated `assets.name` references and
+`model(assets.name)`. Avoid raw `.glb` or `.gltf` URLs, guessed model IDs,
+direct loader code, and primitive-only primary subjects for named real objects.
+
+## Package Roles
+
+- `@aura3d/cli`: asset pipeline, validation, provenance, diagnostics, and
+  deploy checks.
+- `create-aura3d`: Vite starter scaffolds.
+- `@aura3d/engine`: public browser 3D runtime APIs such as `createAuraApp`.
+
+The CLI proves CLI asset-pipeline behavior. Renderer, game, animation, WebGPU,
+PBR, postprocess, skinning, and morph-target claims still need matching browser
+or package evidence for the exact API path being claimed.
+
+## Links
+
+- Website: https://aura3d.auraone.ai
+- Repository: https://github.com/auraoneai/aura3d
+- Engine package: https://www.npmjs.com/package/@aura3d/engine
+- Scaffolder package: https://www.npmjs.com/package/create-aura3d

package/dist/asset-constants.d.ts

@@ -0,0 +1,5 @@
+export declare const DEFAULT_AURA_ASSET_MANIFEST = "aura.assets.json";
+export declare const DEFAULT_AURA_ASSET_OUTPUT_DIR = "public/aura-assets";
+export declare const DEFAULT_AURA_ASSET_PUBLIC_PATH = "/aura-assets/";
+export declare const DEFAULT_AURA_ASSET_TYPEGEN = "src/aura-assets.ts";
+//# sourceMappingURL=asset-constants.d.ts.map

package/dist/asset-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-constants.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAC9D,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAC9D,eAAO,MAAM,0BAA0B,uBAAuB,CAAC"}

package/dist/asset-constants.js

@@ -0,0 +1,5 @@
+export const DEFAULT_AURA_ASSET_MANIFEST = "aura.assets.json";
+export const DEFAULT_AURA_ASSET_OUTPUT_DIR = "public/aura-assets";
+export const DEFAULT_AURA_ASSET_PUBLIC_PATH = "/aura-assets/";
+export const DEFAULT_AURA_ASSET_TYPEGEN = "src/aura-assets.ts";
+//# sourceMappingURL=asset-constants.js.map

package/dist/asset-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-constants.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AAC9D,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC"}

package/dist/asset-core-types.d.ts

@@ -0,0 +1,222 @@
+import type { AuraCliAnimationInspection, AuraCliAssetBoundsInspection, AuraCliHumanoidInspection, AuraCliMaterialInspection, AuraCliMorphTargetInspection, AuraCliOrientationInspection, AuraCliSceneHierarchyInspection, AuraCliSkeletonInspection } from "./asset-inspection-types.js";
+export type AuraCliAssetType = "model" | "texture" | "environment" | "audio";
+export type AuraAssetQuality = "ungraded" | "blocked" | "prototype" | "candidate" | "release";
+export type AuraCliAssetRole = "character" | "vehicle" | "world" | "environment" | "track" | "product" | "weapon" | "prop" | "set-dressing" | "debug" | "abstract" | "unknown";
+export type AuraCliRenderedProbeKind = "browser-screenshot" | "aura-probe-render" | "manual-inspection" | "unknown";
+export type AuraCliGameAssetCertification = "not-game-ready" | "candidate-needs-geometry" | "certified-racing-track" | "certified-racing-vehicle" | "certified-platformer-world" | "certified-platformer-character" | "certified-generated-game-world";
+export interface AuraCliGameGeometryEvidence {
+    readonly routePrimaryScreenshot?: string;
+    readonly routePrimaryScreenshotSha256?: string;
+    readonly geometryReport?: string;
+    readonly manifestHash?: string;
+    readonly visualReview?: "pass" | "fail";
+    readonly assetPairPass?: boolean;
+    readonly blockers?: readonly string[];
+}
+export interface AuraCliGameGeometryMetadata {
+    readonly certification?: AuraCliGameAssetCertification;
+    readonly evidence?: AuraCliGameGeometryEvidence;
+    readonly racingTopology?: Readonly<Record<string, unknown>>;
+    readonly playableSurfaceMap?: Readonly<Record<string, unknown>>;
+}
+export interface AuraCliRenderedProbeForegroundBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface AuraCliRenderedProbe {
+    readonly url: string;
+    readonly kind: AuraCliRenderedProbeKind;
+    readonly renderer?: string;
+    readonly route?: string;
+    readonly sha256?: string;
+    readonly assetHash?: string;
+    readonly nonBlankPixels?: number;
+    readonly colorBuckets?: number;
+    readonly width?: number;
+    readonly height?: number;
+    readonly checkedAt?: string;
+    readonly foregroundBounds?: AuraCliRenderedProbeForegroundBounds;
+}
+export interface AuraCliResolveCandidateProvenance {
+    readonly catalogId: string;
+    readonly query: string;
+    readonly source: string;
+    readonly sourceFamily?: string;
+    readonly retrievedAt?: string;
+    readonly scoreTotal: number;
+    readonly scoreBreakdown: {
+        readonly semantic: number;
+        readonly sourceQuality: number;
+        readonly license: number;
+        readonly inspection: number;
+        readonly roleFit: number;
+    };
+    readonly reasons: readonly string[];
+    readonly penalties: readonly string[];
+    readonly sourcePage?: string;
+    readonly downloadUrl?: string;
+    readonly license?: string;
+    readonly licenseName?: string;
+    readonly licenseUrl?: string;
+    readonly licenseRaw?: string;
+    readonly author?: string;
+    readonly attribution?: string;
+    readonly semanticScore?: number;
+    readonly workerScore?: number;
+    readonly qualityScore?: number;
+    readonly bounds?: readonly [number, number, number];
+    readonly dimensions?: readonly [number, number, number];
+    readonly triangleCount?: number;
+    readonly meshCount?: number;
+    readonly materialCount?: number;
+    readonly textureCount?: number;
+    readonly animationClipCount?: number;
+    readonly animationClips?: readonly string[];
+    readonly skinCount?: number;
+    readonly morphTargetCount?: number;
+    readonly intendedRole?: string;
+    readonly roleSuitability?: string;
+    readonly qualityWarnings?: readonly string[];
+    readonly duplicateHash?: string;
+    readonly duplicateOkReason?: string;
+    readonly postDownloadInspection?: {
+        readonly bounds?: readonly [number, number, number];
+        readonly materialCount: number;
+        readonly textureCount: number;
+        readonly animationClipCount: number;
+        readonly skinCount: number;
+        readonly morphTargetCount: number;
+        readonly warnings: readonly string[];
+    };
+    readonly rawCatalogMetadata?: Readonly<Record<string, unknown>>;
+}
+export interface AuraCliAssetProvenance {
+    readonly sourcePath: string;
+    readonly sourcePage?: string;
+    readonly downloadUrl?: string;
+    readonly sourceUrl?: string;
+    readonly license?: string;
+    readonly licenseName?: string;
+    readonly licenseUrl?: string;
+    readonly licenseRaw?: string;
+    readonly author?: string;
+    readonly sourceFamily?: string;
+    readonly attribution?: string;
+    readonly sha256?: string;
+    readonly retrievedAt?: string;
+    readonly resolveCandidate?: AuraCliResolveCandidateProvenance;
+    readonly evidence?: readonly string[];
+    readonly checkedAt: string;
+}
+export interface AuraCliAssetManifest {
+    readonly schema: "aura3d.assets/1.0";
+    readonly assetBasePath: string;
+    readonly outputDir: string;
+    readonly typegen: string;
+    readonly assets: readonly AuraCliAssetEntry[];
+}
+export interface AuraCliAssetEntry {
+    readonly id: string;
+    readonly type: AuraCliAssetType;
+    readonly format: string;
+    readonly source: string;
+    readonly outputPath: string;
+    readonly url: string;
+    readonly hash: string;
+    readonly sizeBytes: number;
+    readonly bounds?: readonly [number, number, number];
+    readonly boundsMetadata?: AuraCliAssetBoundsInspection;
+    readonly materials: readonly string[];
+    readonly materialMetadata?: readonly AuraCliMaterialInspection[];
+    readonly animations: readonly string[];
+    readonly animationMetadata?: AuraCliAnimationInspection;
+    readonly humanoid?: AuraCliHumanoidInspection;
+    readonly skeleton?: AuraCliSkeletonInspection;
+    readonly morphTargets?: AuraCliMorphTargetInspection;
+    readonly hierarchy?: AuraCliSceneHierarchyInspection;
+    readonly provenance?: AuraCliAssetProvenance;
+    readonly textures: readonly string[];
+    readonly dependencies?: readonly string[];
+    readonly orientation?: AuraCliOrientationInspection;
+    readonly nodeNames?: readonly string[];
+    readonly thumbnailUrl?: string;
+    readonly quality?: AuraAssetQuality;
+    readonly role?: AuraCliAssetRole;
+    readonly suitabilityReason?: string;
+    readonly renderedProbe?: AuraCliRenderedProbe;
+    readonly gameGeometry?: AuraCliGameGeometryMetadata;
+    readonly warnings: readonly string[];
+}
+export interface AddAssetOptions {
+    readonly projectDir?: string;
+    readonly file: string;
+    readonly name: string;
+    readonly type?: AuraCliAssetType;
+    readonly publicPath?: string;
+    readonly outputDir?: string;
+    readonly typegen?: string;
+    readonly copy?: boolean;
+    readonly sourcePage?: string;
+    readonly downloadUrl?: string;
+    readonly sourceUrl?: string;
+    readonly license?: string;
+    readonly licenseName?: string;
+    readonly licenseUrl?: string;
+    readonly licenseRaw?: string;
+    readonly author?: string;
+    readonly sourceFamily?: string;
+    readonly attribution?: string;
+    readonly sha256?: string;
+    readonly resolveCandidate?: AuraCliResolveCandidateProvenance;
+    readonly quality?: AuraAssetQuality;
+    readonly role?: AuraCliAssetRole;
+    readonly suitabilityReason?: string;
+    readonly renderedProbe?: AuraCliRenderedProbe;
+    readonly gameGeometry?: AuraCliGameGeometryMetadata;
+    readonly retrievedAt?: string;
+}
+export interface ReadRenderedProbeMetadataOptions {
+    readonly projectDir?: string;
+    readonly file: string;
+}
+export interface AssetCliResult {
+    readonly ok: boolean;
+    readonly manifestPath: string;
+    readonly manifest: AuraCliAssetManifest;
+    readonly messages: readonly string[];
+}
+export interface AssetValidationResult extends AssetCliResult {
+    readonly source?: AssetSourceValidationReport;
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface AssetValidationOptions {
+    readonly projectDir?: string;
+    readonly noPlaceholders?: boolean;
+    readonly requireLicense?: boolean;
+    readonly provenanceFile?: string;
+    readonly assetIds?: readonly string[];
+    readonly source?: boolean | string;
+    readonly release?: boolean;
+}
+export interface CheckDeployOptions extends AssetValidationOptions {
+    readonly distDir?: string;
+}
+export interface AssetSourceValidationReport {
+    readonly enabled: boolean;
+    readonly roots: readonly string[];
+    readonly files: readonly string[];
+    readonly typedAssetUsages: readonly AssetSourceTypedAssetUsage[];
+    readonly filesByAsset: Readonly<Record<string, readonly string[]>>;
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface AssetSourceTypedAssetUsage {
+    readonly assetId: string;
+    readonly typedAsset: string;
+    readonly file: string;
+    readonly occurrences: number;
+}
+//# sourceMappingURL=asset-core-types.d.ts.map

package/dist/asset-core-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-core-types.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-core-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAC9F,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,SAAS,CAAC;AACpH,MAAM,MAAM,6BAA6B,GACrC,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,0BAA0B,GAC1B,4BAA4B,GAC5B,gCAAgC,GAChC,gCAAgC,CAAC;AAErC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,6BAA6B,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oCAAoC,CAAC;CAClE;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,CAAC,EAAE;QAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,iCAAiC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,4BAA4B,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,+BAA+B,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,iCAAiC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACjE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/asset-core-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-core-types.js.map

package/dist/asset-core-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-core-types.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-core-types.ts"],"names":[],"mappings":""}

package/dist/asset-inspection-types.d.ts

@@ -0,0 +1,131 @@
+import type { AuraCliAssetProvenance } from "./asset-core-types.js";
+export type AuraCliHumanoidStatus = "humanoid" | "non-humanoid" | "unknown";
+export type AuraCliHumanoidConfidence = "high" | "medium" | "low";
+export interface AuraCliAnimationInspection {
+    readonly clipCount: number;
+    readonly clips: readonly AuraCliAnimationClipInspection[];
+    readonly messages: readonly string[];
+}
+export interface AuraCliAnimationClipInspection {
+    readonly index: number;
+    readonly name: string;
+    readonly channelCount: number;
+    readonly samplerCount: number;
+    readonly targetPaths: readonly string[];
+    readonly targetNodes: readonly string[];
+}
+export interface AuraCliSkeletonInspection {
+    readonly skinCount: number;
+    readonly jointCount: number;
+    readonly skins: readonly AuraCliSkeletonSkinInspection[];
+    readonly messages: readonly string[];
+}
+export interface AuraCliSkeletonSkinInspection {
+    readonly index: number;
+    readonly name: string;
+    readonly jointCount: number;
+    readonly joints: readonly string[];
+    readonly skeleton?: string;
+}
+export interface AuraCliMorphTargetInspection {
+    readonly targetCount: number;
+    readonly targetNames: readonly string[];
+    readonly meshes: readonly AuraCliMorphTargetMeshInspection[];
+    readonly messages: readonly string[];
+}
+export interface AuraCliMorphTargetMeshInspection {
+    readonly index: number;
+    readonly name: string;
+    readonly targetNames: readonly string[];
+}
+export interface AuraCliSceneHierarchyInspection {
+    readonly nodeCount: number;
+    readonly meshCount: number;
+    readonly materialCount: number;
+    readonly textureCount: number;
+    readonly animationClipCount: number;
+    readonly skinCount: number;
+    readonly morphTargetCount: number;
+    readonly rootNodeNames: readonly string[];
+    readonly maxDepth: number;
+    readonly messages: readonly string[];
+}
+export interface AuraCliAssetBoundsInspection {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+    readonly size: readonly [number, number, number];
+    readonly center: readonly [number, number, number];
+    readonly maxDimension: number;
+    readonly grounded: boolean;
+}
+export interface AuraCliMaterialInspection {
+    readonly name: string;
+    readonly visible: boolean;
+    readonly readable: boolean;
+    readonly opacity: number;
+    readonly alphaMode?: string;
+    readonly reasons: readonly string[];
+}
+export interface AuraCliOrientationRenderedProbeEvidence {
+    readonly url?: string;
+    readonly sha256?: string;
+    readonly assetHash?: string;
+    readonly checkedAt?: string;
+    readonly route?: string;
+}
+export interface AuraCliOrientationInspection {
+    readonly source: "gltf-extras" | "manifest-override" | "unknown";
+    readonly forwardAxis?: string;
+    readonly upAxis?: string;
+    readonly view?: string;
+    readonly assetHash?: string;
+    readonly generatedBy?: string;
+    readonly checkedAt?: string;
+    readonly route?: string;
+    readonly renderedProbe?: AuraCliOrientationRenderedProbeEvidence;
+    readonly evidence?: readonly string[];
+    readonly messages: readonly string[];
+}
+export interface AuraCliHumanoidInspection {
+    readonly humanoid: boolean;
+    readonly status: AuraCliHumanoidStatus;
+    readonly confidence: AuraCliHumanoidConfidence;
+    readonly skinCount: number;
+    readonly jointCount: number;
+    readonly matchedBones: readonly string[];
+    readonly missingBones: readonly string[];
+    readonly messages: readonly string[];
+}
+export interface AssetInspectionReport {
+    readonly ok: boolean;
+    readonly schema: "aura3d.asset-inspection/1.0";
+    readonly file: string;
+    readonly format: string;
+    readonly sizeBytes: number;
+    readonly bounds?: readonly [number, number, number];
+    readonly boundsMetadata?: AuraCliAssetBoundsInspection;
+    readonly materials: readonly string[];
+    readonly materialMetadata?: readonly AuraCliMaterialInspection[];
+    readonly animations: readonly string[];
+    readonly animation?: AuraCliAnimationInspection;
+    readonly humanoid?: AuraCliHumanoidInspection;
+    readonly skeleton?: AuraCliSkeletonInspection;
+    readonly morphTargets?: AuraCliMorphTargetInspection;
+    readonly provenance?: Partial<AuraCliAssetProvenance>;
+    readonly textures: readonly string[];
+    readonly orientation?: AuraCliOrientationInspection;
+    readonly nodeNames?: readonly string[];
+    readonly dependencies: readonly string[];
+    readonly warnings: readonly string[];
+    readonly messages: readonly string[];
+}
+export interface InspectAssetOptions {
+    readonly projectDir?: string;
+    readonly file: string;
+    readonly animation?: boolean;
+    readonly humanoid?: boolean;
+    readonly skeleton?: boolean;
+    readonly morphs?: boolean;
+    readonly license?: boolean;
+}
+//# sourceMappingURL=asset-inspection-types.d.ts.map

package/dist/asset-inspection-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-inspection-types.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-inspection-types.ts"],"names":[],"mappings":"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"}

package/dist/asset-inspection-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-inspection-types.js.map

package/dist/asset-inspection-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-inspection-types.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-inspection-types.ts"],"names":[],"mappings":""}

package/dist/asset-manifest.d.ts

@@ -0,0 +1,8 @@
+import type { AuraCliAssetEntry, AuraCliAssetManifest } from "./index.js";
+export declare function readAssetManifest(projectDir: string): AuraCliAssetManifest;
+export declare function writeAssetManifest(projectDir: string, manifest: AuraCliAssetManifest): void;
+export declare function writeTypedAssets(projectDir: string, manifest?: AuraCliAssetManifest): string;
+export declare function listAssets(options?: {
+    readonly projectDir?: string;
+}): readonly AuraCliAssetEntry[];
+//# sourceMappingURL=asset-manifest.d.ts.map

package/dist/asset-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manifest.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAiB1E;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,uBAAgC,GAAG,MAAM,CAwDrG;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,iBAAiB,EAAE,CAEvG"}

package/dist/asset-manifest.js

@@ -0,0 +1,116 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { DEFAULT_AURA_ASSET_MANIFEST, DEFAULT_AURA_ASSET_OUTPUT_DIR, DEFAULT_AURA_ASSET_PUBLIC_PATH, DEFAULT_AURA_ASSET_TYPEGEN, } from "./asset-constants.js";
+export function readAssetManifest(projectDir) {
+    const manifestPath = resolve(projectDir, DEFAULT_AURA_ASSET_MANIFEST);
+    if (!existsSync(manifestPath)) {
+        return {
+            schema: "aura3d.assets/1.0",
+            assetBasePath: DEFAULT_AURA_ASSET_PUBLIC_PATH,
+            outputDir: DEFAULT_AURA_ASSET_OUTPUT_DIR,
+            typegen: DEFAULT_AURA_ASSET_TYPEGEN,
+            assets: [],
+        };
+    }
+    const parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+    if (!isAssetManifest(parsed)) {
+        const schema = schemaField(parsed);
+        throw new Error(`Unsupported Aura3D asset manifest schema: ${String(schema)}`);
+    }
+    return parsed;
+}
+export function writeAssetManifest(projectDir, manifest) {
+    writeFileSync(resolve(projectDir, DEFAULT_AURA_ASSET_MANIFEST), `${JSON.stringify(manifest, null, 2)}\n`);
+}
+export function writeTypedAssets(projectDir, manifest = readAssetManifest(projectDir)) {
+    const path = resolve(projectDir, manifest.typegen);
+    mkdirSync(dirname(path), { recursive: true });
+    const lines = [
+        "import { defineAuraAssets } from \"@aura3d/engine\";",
+        "",
+        "export const assets = defineAuraAssets({",
+        ...manifest.assets.map((asset) => {
+            const metadata = {
+                materials: asset.materials,
+                animations: asset.animations,
+                animationClips: asset.animations,
+                animationMetadata: asset.animationMetadata ?? createReadinessAnimationMetadata(asset.animations),
+                humanoid: asset.humanoid?.humanoid ?? false,
+                humanoidStatus: asset.humanoid?.status ?? "unknown",
+                humanoidConfidence: asset.humanoid?.confidence ?? "low",
+                skeleton: asset.skeleton,
+                morphTargets: asset.morphTargets,
+                hierarchy: asset.hierarchy,
+                provenance: asset.provenance,
+                sourcePath: asset.source,
+                outputPath: asset.outputPath,
+                license: asset.provenance?.license,
+                author: asset.provenance?.author,
+                boundsMetadata: asset.boundsMetadata,
+                materialMetadata: asset.materialMetadata,
+                orientation: asset.orientation,
+                nodeNames: asset.nodeNames ?? [],
+                textures: asset.textures,
+                dependencies: asset.dependencies ?? [],
+                thumbnailUrl: asset.thumbnailUrl,
+                quality: asset.quality ?? "ungraded",
+                role: asset.role ?? "unknown",
+                suitabilityReason: asset.suitabilityReason,
+                renderedProbe: asset.renderedProbe,
+                gameGeometry: asset.gameGeometry,
+            };
+            return [
+                `  ${JSON.stringify(asset.id)}: {`,
+                formatField("type", asset.type),
+                formatField("format", asset.format),
+                formatField("url", asset.url),
+                formatField("hash", asset.hash),
+                formatField("bounds", asset.bounds ?? [0, 0, 0]),
+                `    sizeBytes: ${asset.sizeBytes},`,
+                formatField("metadata", metadata),
+                "  },",
+            ].join("\n");
+        }),
+        "} as const);",
+        "",
+        "export type AuraGeneratedAssets = typeof assets;",
+        "",
+    ];
+    writeFileSync(path, lines.join("\n"));
+    return path;
+}
+export function listAssets(options = {}) {
+    return readAssetManifest(resolve(options.projectDir ?? process.cwd())).assets;
+}
+function formatField(name, value) {
+    return `    ${name}: ${formatLiteral(value, 4)},`;
+}
+function formatLiteral(value, indent) {
+    const raw = JSON.stringify(value, null, 2);
+    if (raw === undefined)
+        return "undefined";
+    return raw
+        .split("\n")
+        .map((line, index) => (index === 0 ? line : `${" ".repeat(indent)}${line}`))
+        .join("\n");
+}
+function createReadinessAnimationMetadata(animations) {
+    return {
+        clipCount: animations.length,
+        clips: animations.map((name, index) => ({ index, name })),
+    };
+}
+function isAssetManifest(value) {
+    return value !== null &&
+        typeof value === "object" &&
+        "schema" in value &&
+        value.schema === "aura3d.assets/1.0" &&
+        "assets" in value &&
+        Array.isArray(value.assets);
+}
+function schemaField(value) {
+    if (value === null || typeof value !== "object" || !("schema" in value))
+        return undefined;
+    return value.schema;
+}
+//# sourceMappingURL=asset-manifest.js.map

package/dist/asset-manifest.js.map

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