@aura3d/cli 1.3.2 → 1.4.0

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

@@ -0,0 +1,164 @@
+import type { AuraCliAssetEntry, AuraCliAssetType, AuraCliAssetProvenance } from "./asset-core-types.js";
+export type AuraAssetReadinessProfile = "game" | "animation";
+export type AuraGameAssetReadinessProfile = "fighting-character";
+export type AuraAssetReadinessStatus = "passed" | "failed";
+export interface AssetReadinessOptions {
+    readonly projectDir?: string;
+    readonly output?: string;
+    readonly gameProfile?: AuraGameAssetReadinessProfile;
+    readonly episode?: boolean;
+    readonly noPlaceholders?: boolean;
+    readonly requireLicense?: boolean;
+    readonly provenanceFile?: string;
+    readonly assetIds?: readonly string[];
+}
+export interface AssetReadinessReport {
+    readonly schema: "aura3d.asset-readiness/1.0";
+    readonly profile: AuraAssetReadinessProfile;
+    readonly gameProfile?: AuraGameAssetReadinessProfile;
+    readonly ok: boolean;
+    readonly status: AuraAssetReadinessStatus;
+    readonly validator: AssetReadinessValidatorEvidence;
+    readonly checkedAt: string;
+    readonly manifestPath: string;
+    readonly artifacts: AssetReadinessArtifacts;
+    readonly contracts: readonly AssetReadinessValidationContract[];
+    readonly animationEpisode?: AnimationEpisodeReadinessReport;
+    readonly summary: {
+        readonly totalAssets: number;
+        readonly modelAssets: number;
+        readonly animatedModels: number;
+        readonly textureAssets: number;
+        readonly audioAssets: number;
+        readonly environmentAssets: number;
+        readonly animationClips: number;
+        readonly humanoidModels: number;
+        readonly animationCharacters?: number;
+        readonly animationSets?: number;
+        readonly animationProps?: number;
+        readonly episodeReadyCharacters?: number;
+        readonly mouthReadyCharacters?: number;
+        readonly animationReadyCharacters?: number;
+        readonly profileTargetAssets?: number;
+        readonly profileReadyAssets?: number;
+        readonly profileSkippedAssets?: number;
+    };
+    readonly assets: readonly AssetReadinessAssetReport[];
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+    readonly messages: readonly string[];
+}
+export type AnimationEpisodeAssetRole = "character" | "set" | "prop" | "environment" | "audio" | "texture" | "unknown";
+export type AnimationEpisodeMouthReadinessMode = "blendshape-lip-sync" | "primitive-mouth-card" | "amplitude-only" | "missing-mouth-motion";
+export interface AnimationEpisodeAssetReadiness {
+    readonly id: string;
+    readonly role: AnimationEpisodeAssetRole;
+    readonly episodeReady: boolean;
+    readonly distinctHash?: string;
+    readonly licenseVerified: boolean;
+    readonly provenanceReady: boolean;
+    readonly placeholderFree: boolean;
+    readonly animationReady: boolean;
+    readonly mouthReady: boolean;
+    readonly mouthMode?: AnimationEpisodeMouthReadinessMode;
+    readonly setReady?: boolean;
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface AnimationEpisodeReadinessReport {
+    readonly enabled: boolean;
+    readonly ok: boolean;
+    readonly mode: "episode-ready";
+    readonly requirements: {
+        readonly minDistinctCharacters: number;
+        readonly minSets: number;
+        readonly requireLicense: boolean;
+        readonly noPlaceholders: boolean;
+        readonly requireAnimation: boolean;
+        readonly requireMouthMotion: boolean;
+        readonly requireSetScale: boolean;
+    };
+    readonly selectedCharacters: readonly string[];
+    readonly selectedSets: readonly string[];
+    readonly selectedProps: readonly string[];
+    readonly selectedAudio: readonly string[];
+    readonly readiness: readonly AnimationEpisodeAssetReadiness[];
+    readonly assetProvenanceArtifact: string;
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface AssetReadinessValidatorEvidence {
+    readonly id: "aura-clash-game-assets" | "aura-voice-animation-assets";
+    readonly command: "assets validate-game" | "assets validate-animation";
+    readonly label: string;
+}
+export interface AssetReadinessValidationContract {
+    readonly id: string;
+    readonly label: string;
+    readonly profile: AuraAssetReadinessProfile;
+    readonly sourceFamily?: "Quaternius" | "AuraVoice" | "custom";
+    readonly intendedUse?: "fighter" | "animation-character" | "set" | "prop";
+    readonly sourceOnly: boolean;
+    readonly requiredChecks: readonly string[];
+    readonly requiredAnimationClips?: readonly string[];
+    readonly evidenceBoundary: string;
+}
+export interface AssetReadinessArtifacts {
+    readonly manifestPath: string;
+    readonly typedAssetsPath: string;
+    readonly outputDir: string;
+    readonly assetBasePath: string;
+    readonly evidencePath?: string;
+    readonly assetFiles: readonly AssetReadinessAssetArtifacts[];
+}
+export interface AssetReadinessAssetArtifacts {
+    readonly id: string;
+    readonly sourcePath: string;
+    readonly outputPath: string;
+    readonly publicUrl: string;
+    readonly thumbnailPath?: string;
+    readonly thumbnailUrl?: string;
+    readonly dependencyPaths: readonly string[];
+}
+export interface AssetReadinessAnimationMetadata {
+    readonly clipCount: number;
+    readonly clips: readonly AssetReadinessAnimationClipMetadata[];
+}
+export interface AssetReadinessAnimationClipMetadata {
+    readonly index: number;
+    readonly name: string;
+}
+export interface AssetReadinessAssetReport {
+    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?: AuraCliAssetEntry["boundsMetadata"];
+    readonly animations: readonly string[];
+    readonly animation: AssetReadinessAnimationMetadata;
+    readonly animationMetadata?: AuraCliAssetEntry["animationMetadata"];
+    readonly humanoid?: AuraCliAssetEntry["humanoid"];
+    readonly skeleton?: AuraCliAssetEntry["skeleton"];
+    readonly morphTargets?: AuraCliAssetEntry["morphTargets"];
+    readonly provenance?: AuraCliAssetProvenance;
+    readonly placeholderFree: boolean;
+    readonly licenseVerified: boolean;
+    readonly materials: readonly string[];
+    readonly materialMetadata?: AuraCliAssetEntry["materialMetadata"];
+    readonly textures: readonly string[];
+    readonly orientation?: AuraCliAssetEntry["orientation"];
+    readonly nodeNames?: readonly string[];
+    readonly artifactPaths: AssetReadinessAssetArtifacts;
+    readonly gameReady: boolean;
+    readonly animationReady: boolean;
+    readonly profileTarget?: boolean;
+    readonly profileReady?: boolean;
+    readonly profileSkippedReason?: string;
+    readonly warnings: readonly string[];
+}
+//# sourceMappingURL=asset-readiness-types.d.ts.map

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

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

package/dist/asset-readiness-types.js

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

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

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

package/dist/asset-source-ast.d.ts

@@ -0,0 +1,8 @@
+import type { AssetSourceTypedAssetUsage } from "./index.js";
+export interface SourceAstScanReport {
+    readonly typedAssetUsages: readonly Omit<AssetSourceTypedAssetUsage, "file" | "occurrences">[];
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+}
+export declare function scanAssetSourceAst(relativeFile: string, source: string): SourceAstScanReport;
+//# sourceMappingURL=asset-source-ast.d.ts.map

package/dist/asset-source-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-ast.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-source-ast.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,IAAI,CAAC,0BAA0B,EAAE,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAOD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA0G5F"}

package/dist/asset-source-ast.js

@@ -0,0 +1,241 @@
+import { extname } from "node:path";
+import * as ts from "typescript";
+import { isPrimaryRoleIdentifier, isPrimitiveConstructorName, isSupportingPrimitiveIdentifier, } from "./asset-source-roles.js";
+export function scanAssetSourceAst(relativeFile, source) {
+    const sourceFile = ts.createSourceFile(relativeFile, source, ts.ScriptTarget.Latest, true, scriptKindForSource(relativeFile));
+    const typedAssetUsages = [];
+    const failures = new Set();
+    const warnings = new Set();
+    const typedAssetAliases = new Map();
+    const addTypedAssetUsage = (reference) => {
+        if (!reference)
+            return;
+        typedAssetUsages.push(reference);
+    };
+    const collectAliases = (node) => {
+        if (ts.isVariableDeclaration(node) && node.initializer) {
+            if (ts.isIdentifier(node.name)) {
+                const reference = getDirectTypedAssetReference(node.initializer);
+                if (reference)
+                    typedAssetAliases.set(node.name.text, reference);
+            }
+            else if (ts.isObjectBindingPattern(node.name) && isIdentifierNamed(unwrapExpression(node.initializer), "assets")) {
+                for (const element of node.name.elements) {
+                    if (!ts.isIdentifier(element.name))
+                        continue;
+                    const propertyName = element.propertyName ?? element.name;
+                    const assetId = getBindingPropertyName(propertyName);
+                    if (!assetId)
+                        continue;
+                    const reference = { assetId, typedAsset: `assets.${assetId}` };
+                    typedAssetAliases.set(element.name.text, reference);
+                    addTypedAssetUsage(reference);
+                }
+            }
+        }
+        ts.forEachChild(node, collectAliases);
+    };
+    const scan = (node) => {
+        if (isStringLiteralNode(node)) {
+            const value = node.text;
+            if (isRawModelUrlOrPath(value)) {
+                failures.add(`raw GLB/glTF URL or path "${value}" found in source. Add it with assets add/resolve and use model(assets.x).`);
+            }
+        }
+        if (ts.isImportDeclaration(node) && isStringLiteralNode(node.moduleSpecifier)) {
+            const specifier = node.moduleSpecifier.text;
+            if (isForbiddenThreeImport(specifier)) {
+                failures.add("direct three imports are not allowed in public examples. Use @aura3d/engine public APIs.");
+            }
+            if (isForbiddenRendererInternalImport(specifier)) {
+                failures.add("renderer internals are not allowed in public examples. Use @aura3d/engine public APIs.");
+            }
+            if (node.importClause && importsName(node.importClause, "GLTFLoader")) {
+                failures.add("GLTFLoader is not allowed in public examples. Use model(assets.x) from @aura3d/engine.");
+            }
+        }
+        if (ts.isCallExpression(node)) {
+            if (isRequireOfForbiddenThreeImport(node)) {
+                failures.add("direct three imports are not allowed in public examples. Use @aura3d/engine public APIs.");
+            }
+            if (isRequireOfForbiddenRendererInternalImport(node)) {
+                failures.add("renderer internals are not allowed in public examples. Use @aura3d/engine public APIs.");
+            }
+            if (isCallNamed(node, "model")) {
+                const [firstArgument] = node.arguments;
+                if (firstArgument && isStringLiteralNode(firstArgument)) {
+                    failures.add(`raw model string id "${firstArgument.text}" passed to model(). Use generated typed assets, for example model(assets.${sanitizeAssetId(firstArgument.text || "asset")}).`);
+                }
+            }
+            if (isCallNamed(node, "unsafeModelUrl")) {
+                failures.add("unsafeModelUrl is not allowed in public examples. Preserve typed asset safety with generated assets from ./src/aura-assets.");
+            }
+        }
+        if (ts.isIdentifier(node)) {
+            if (node.text === "unsafeModelUrl") {
+                failures.add("unsafeModelUrl is not allowed in public examples. Preserve typed asset safety with generated assets from ./src/aura-assets.");
+            }
+            if (node.text === "GLTFLoader") {
+                failures.add("GLTFLoader is not allowed in public examples. Use model(assets.x) from @aura3d/engine.");
+            }
+        }
+        if (ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) {
+            addTypedAssetUsage(getDirectTypedAssetReference(node));
+        }
+        if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer) {
+            const candidateName = node.name.text;
+            if (isPrimaryRoleIdentifier(candidateName) &&
+                !isSupportingPrimitiveIdentifier(candidateName) &&
+                isPrimitivePrimaryInitializer(node.initializer, typedAssetAliases)) {
+                warnings.add(`primitive "${candidateName}" appears assigned to a primary-role object. Primary characters, vehicles, worlds, tracks, products, and weapons must use typed model(assets.x) assets or be marked abstract/prototype.`);
+            }
+        }
+        ts.forEachChild(node, scan);
+    };
+    collectAliases(sourceFile);
+    scan(sourceFile);
+    return {
+        typedAssetUsages,
+        failures: [...failures].sort(),
+        warnings: [...warnings].sort(),
+    };
+}
+function scriptKindForSource(path) {
+    const extension = extname(path).toLowerCase();
+    if (extension === ".tsx")
+        return ts.ScriptKind.TSX;
+    if (extension === ".jsx")
+        return ts.ScriptKind.JSX;
+    if (extension === ".js" || extension === ".mjs" || extension === ".cjs")
+        return ts.ScriptKind.JS;
+    return ts.ScriptKind.TS;
+}
+function isStringLiteralNode(node) {
+    return ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node);
+}
+function getBindingPropertyName(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name))
+        return name.text;
+    return undefined;
+}
+function unwrapExpression(expression) {
+    let current = expression;
+    while (ts.isParenthesizedExpression(current) || ts.isAsExpression(current) || ts.isTypeAssertionExpression(current) || ts.isNonNullExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+function getDirectTypedAssetReference(expression) {
+    const unwrapped = unwrapExpression(expression);
+    if (ts.isPropertyAccessExpression(unwrapped) && isIdentifierNamed(unwrapExpression(unwrapped.expression), "assets")) {
+        const assetId = unwrapped.name.text;
+        return { assetId, typedAsset: `assets.${assetId}` };
+    }
+    if (ts.isElementAccessExpression(unwrapped) && isIdentifierNamed(unwrapExpression(unwrapped.expression), "assets")) {
+        const argument = unwrapped.argumentExpression;
+        if (argument && isStringLiteralNode(argument)) {
+            const assetId = argument.text;
+            return { assetId, typedAsset: `assets[${JSON.stringify(assetId)}]` };
+        }
+    }
+    return undefined;
+}
+function isIdentifierNamed(expression, name) {
+    return ts.isIdentifier(expression) && expression.text === name;
+}
+function isRawModelUrlOrPath(value) {
+    return /\.gl(?:b|tf)(?:$|[?#/\\])/i.test(value) || /\.gl(?:b|tf)\b/i.test(value);
+}
+function isForbiddenThreeImport(specifier) {
+    return specifier === "three" || specifier.startsWith("three/");
+}
+function isForbiddenRendererInternalImport(specifier) {
+    return [
+        "@aura3d/rendering",
+        "@aura3d/engine/rendering",
+        "@aura3d/engine/production-runtime",
+        "@aura3d/engine/advanced-runtime",
+    ].some((forbidden) => specifier === forbidden || specifier.startsWith(`${forbidden}/`));
+}
+function importsName(importClause, name) {
+    if (importClause.name?.text === name)
+        return true;
+    const bindings = importClause.namedBindings;
+    if (!bindings)
+        return false;
+    if (ts.isNamespaceImport(bindings))
+        return bindings.name.text === name;
+    return bindings.elements.some((element) => (element.propertyName ?? element.name).text === name || element.name.text === name);
+}
+function isRequireOfForbiddenThreeImport(node) {
+    const [specifier] = node.arguments;
+    return isIdentifierNamed(unwrapExpression(node.expression), "require") &&
+        specifier !== undefined &&
+        isStringLiteralNode(specifier) &&
+        isForbiddenThreeImport(specifier.text);
+}
+function isRequireOfForbiddenRendererInternalImport(node) {
+    const [specifier] = node.arguments;
+    return isIdentifierNamed(unwrapExpression(node.expression), "require") &&
+        specifier !== undefined &&
+        isStringLiteralNode(specifier) &&
+        isForbiddenRendererInternalImport(specifier.text);
+}
+function isCallNamed(node, name) {
+    const callee = unwrapExpression(node.expression);
+    if (ts.isIdentifier(callee))
+        return callee.text === name;
+    return ts.isPropertyAccessExpression(callee) && callee.name.text === name;
+}
+function isPrimitivePrimaryInitializer(expression, typedAssetAliases) {
+    return isPrimitiveBuilderExpression(expression) && !containsTypedModelCall(expression, typedAssetAliases);
+}
+function isPrimitiveBuilderExpression(expression) {
+    const unwrapped = unwrapExpression(expression);
+    if (!ts.isCallExpression(unwrapped))
+        return false;
+    const callee = unwrapExpression(unwrapped.expression);
+    if (isPrimitiveConstructorCallee(callee))
+        return true;
+    if (ts.isPropertyAccessExpression(callee) && callee.name.text === "add") {
+        const receiver = unwrapExpression(callee.expression);
+        const receiverIsPrimitive = isPrimitiveBuilderExpression(receiver);
+        const primitiveArgument = unwrapped.arguments.some((argument) => ts.isExpression(argument) && isPrimitiveBuilderExpression(argument));
+        return receiverIsPrimitive || primitiveArgument;
+    }
+    return false;
+}
+function isPrimitiveConstructorCallee(callee) {
+    if (ts.isIdentifier(callee))
+        return isPrimitiveConstructorName(callee.text);
+    return ts.isPropertyAccessExpression(callee) &&
+        isIdentifierNamed(unwrapExpression(callee.expression), "primitives") &&
+        isPrimitiveConstructorName(callee.name.text);
+}
+function containsTypedModelCall(expression, typedAssetAliases) {
+    let found = false;
+    const visit = (node) => {
+        if (found)
+            return;
+        if (ts.isCallExpression(node) && isCallNamed(node, "model")) {
+            const [firstArgument] = node.arguments;
+            if (firstArgument && isTypedAssetModelArgument(firstArgument, typedAssetAliases)) {
+                found = true;
+                return;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(expression);
+    return found;
+}
+function isTypedAssetModelArgument(expression, typedAssetAliases) {
+    const unwrapped = unwrapExpression(expression);
+    if (getDirectTypedAssetReference(unwrapped))
+        return true;
+    return ts.isIdentifier(unwrapped) && typedAssetAliases.has(unwrapped.text);
+}
+function sanitizeAssetId(value) {
+    return value.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^(\d)/, "_$1");
+}
+//# sourceMappingURL=asset-source-ast.js.map

package/dist/asset-source-ast.js.map

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

package/dist/asset-source-roles.d.ts

@@ -0,0 +1,4 @@
+export declare function isPrimitiveConstructorName(name: string): boolean;
+export declare function isPrimaryRoleIdentifier(name: string): boolean;
+export declare function isSupportingPrimitiveIdentifier(name: string): boolean;
+//# sourceMappingURL=asset-source-roles.d.ts.map

package/dist/asset-source-roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-roles.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-source-roles.ts"],"names":[],"mappings":"AA6DA,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrE"}

package/dist/asset-source-roles.js

@@ -0,0 +1,79 @@
+const SOURCE_PRIMITIVE_CONSTRUCTORS = new Set([
+    "box",
+    "capsule",
+    "cone",
+    "cube",
+    "cylinder",
+    "group",
+    "plane",
+    "primitive",
+    "sphere",
+    "torus",
+]);
+const SOURCE_PRIMARY_ROLE_KEYWORDS = [
+    "hero",
+    "player",
+    "character",
+    "avatar",
+    "enemy",
+    "boss",
+    "vehicle",
+    "car",
+    "truck",
+    "ship",
+    "plane",
+    "drone",
+    "weapon",
+    "gun",
+    "sword",
+    "product",
+    "sneaker",
+    "phone",
+    "world",
+    "track",
+    "city",
+    "environment",
+    "arena",
+    "level",
+    "map",
+    "fighter",
+    "kart",
+    "creature",
+    "terrain",
+];
+const SOURCE_SUPPORTING_PRIMITIVE_KEYWORDS = [
+    "marker",
+    "checkpoint",
+    "guide",
+    "collider",
+    "collision",
+    "trigger",
+    "hitbox",
+    "debug",
+    "label",
+    "hud",
+    "anchor",
+    "gizmo",
+    "helper",
+];
+export function isPrimitiveConstructorName(name) {
+    return SOURCE_PRIMITIVE_CONSTRUCTORS.has(name);
+}
+export function isPrimaryRoleIdentifier(name) {
+    const readable = readableIdentifier(name);
+    return SOURCE_PRIMARY_ROLE_KEYWORDS.some((keyword) => new RegExp(`\\b${escapeRegExp(keyword)}\\b`, "i").test(readable));
+}
+export function isSupportingPrimitiveIdentifier(name) {
+    const readable = readableIdentifier(name);
+    return SOURCE_SUPPORTING_PRIMITIVE_KEYWORDS.some((keyword) => new RegExp(`\\b${escapeRegExp(keyword)}\\b`, "i").test(readable));
+}
+function readableIdentifier(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_-]+/g, " ")
+        .toLowerCase();
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=asset-source-roles.js.map

package/dist/asset-source-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-roles.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-source-roles.ts"],"names":[],"mappings":"AAAA,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC;IAC5C,KAAK;IACL,SAAS;IACT,MAAM;IACN,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;IACP,WAAW;IACX,QAAQ;IACR,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG;IACnC,MAAM;IACN,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,aAAa;IACb,OAAO;IACP,OAAO;IACP,KAAK;IACL,SAAS;IACT,MAAM;IACN,UAAU;IACV,SAAS;CACV,CAAC;AAEF,MAAM,oCAAoC,GAAG;IAC3C,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;IACT,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAY;IAC1D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,oCAAoC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClI,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/asset-source-validation.d.ts

@@ -0,0 +1,4 @@
+import type { AssetSourceValidationReport, AssetValidationOptions, AuraCliAssetManifest } from "./index.js";
+export declare function shouldScanSource(options: AssetValidationOptions): boolean;
+export declare function validateAssetSource(projectDir: string, sourceOption: AssetValidationOptions["source"], manifest: AuraCliAssetManifest): AssetSourceValidationReport;
+//# sourceMappingURL=asset-source-validation.d.ts.map

package/dist/asset-source-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-source-validation.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/asset-source-validation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAEzE;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EAC9C,QAAQ,EAAE,oBAAoB,GAC7B,2BAA2B,CAkF7B"}