@auraindustry/aurajs 0.1.3 → 0.1.5

package/src/conformance/cases/systems-and-gameplay-cases.mjs

@@ -1404,6 +1404,10 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
           id: 'optional.legacy-steam.not-exposed',
           expression: "typeof aura.steam === 'undefined' && !Object.prototype.hasOwnProperty.call(aura, 'steam')",
         },
+        {
+          id: 'optional.legacy-steam.provider-not-exposed',
+          expression: "typeof aura.providers === 'undefined' || typeof aura.providers.steam === 'undefined'",
+        },
         {
           id: 'optional.legacy-steam.physics-disabled-guidance',
           expression: "(() => { try { aura.physics.step(0.016); return false; } catch (e) { const msg = String(e); return msg.includes('optional module \"physics\" is disabled') && msg.includes('modules.physics = true') && msg.includes('[reason:optional_module_physics_disabled]'); } })()",
@@ -1857,15 +1861,15 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         },
         {
           id: 'draw3d.postfx.target-chain.custom-pass.deterministic',
-          expression: "(() => { const runSample = () => { const baseline = aura.draw3d.getPostFXState(); aura.draw3d.removePostFXPass('bloom'); aura.draw3d.removePostFXPass('colorGrade'); aura.draw3d.removePostFXPass('vignette'); aura.draw3d.removePostFXPass('fxaa'); aura.draw3d.removePostFXPass('custom:filmgrain'); aura.draw3d.removePostFXPass('custom:glow'); const setBloom = aura.draw3d.setPostFXPass('bloom', { strength: 1.1, targetChain: { intermediateTargets: ['mainA', 'mainB', 'mainA'], pingPong: true, composeMode: 'additive' } }); const setCustom = aura.draw3d.setPostFXPass('custom:glow', { customParams: { intensity: 0.75, threshold: 0.33 } }); const updateCustom = aura.draw3d.setPostFXPass('custom:glow', { customParams: { intensity: 0.5, threshold: 0.2 } }); const setFilmgrain = aura.draw3d.setPostFXPass('custom:filmgrain', { customParams: { amount: 0.2, grain: 0.1 } }); const state = aura.draw3d.getPostFXState(); const targetChain = state?.targetChain || {}; const customGlow = Array.isArray(state?.passes) ? state.passes.find((pass) => pass.pass === 'custom:glow') : null; const customParams = customGlow?.customParams || {}; const customParamKeys = Object.keys(customParams).sort().join('|'); return { status: [setBloom?.reasonCode, setCustom?.reasonCode, updateCustom?.reasonCode, setFilmgrain?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((pass) => pass.pass).join('|') : '', enabled: state?.enabledPasses, total: state?.totalPasses, customPassCount: state?.customPassCount, targetChainTargets: Array.isArray(targetChain?.intermediateTargets) ? targetChain.intermediateTargets.join('|') : '', targetChainCount: targetChain?.intermediateTargetCount, targetChainPingPong: targetChain?.pingPong === true, targetChainComposeMode: targetChain?.composeMode, targetChainFingerprint: state?.targetChainFingerprint, customParamFingerprint: state?.customParamFingerprint, customGlowIsCustom: customGlow?.isCustom === true, customGlowParamKeys: customParamKeys, customGlowIntensity: customParams?.intensity, customGlowThreshold: customParams?.threshold, mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'bloom|custom:filmgrain|custom:glow' && first.total === 3 && first.enabled === 3 && first.customPassCount === 2 && first.targetChainTargets === 'maina|mainb' && first.targetChainCount === 2 && first.targetChainPingPong === true && first.targetChainComposeMode === 'additive' && Number.isFinite(first.targetChainFingerprint) && first.targetChainFingerprint > 0 && Number.isFinite(first.customParamFingerprint) && first.customParamFingerprint > 0 && first.customGlowIsCustom === true && first.customGlowParamKeys === 'intensity|threshold' && Math.abs(Number(first.customGlowIntensity) - 0.5) < 1e-3 && Math.abs(Number(first.customGlowThreshold) - 0.2) < 1e-3 && first.mutationDelta === 10 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
+          expression: "(() => { const runSample = () => { const baseline = aura.draw3d.getPostFXState(); aura.draw3d.removePostFXPass('bloom'); aura.draw3d.removePostFXPass('colorGrade'); aura.draw3d.removePostFXPass('vignette'); aura.draw3d.removePostFXPass('fxaa'); aura.draw3d.removePostFXPass('filmGrain'); aura.draw3d.removePostFXPass('custom:glow'); const setBloom = aura.draw3d.setPostFXPass('bloom', { strength: 1.1, targetChain: { intermediateTargets: ['mainA', 'mainB', 'mainA'], pingPong: true, composeMode: 'additive' } }); const setCustom = aura.draw3d.setPostFXPass('custom:glow', { customParams: { intensity: 0.75, threshold: 0.33 } }); const updateCustom = aura.draw3d.setPostFXPass('custom:glow', { customParams: { intensity: 0.5, threshold: 0.2 } }); const setFilmgrain = aura.draw3d.setPostFXPass('filmGrain', { customParams: { amount: 0.2, speed: 0.1 } }); const state = aura.draw3d.getPostFXState(); const targetChain = state?.targetChain || {}; const customGlow = Array.isArray(state?.passes) ? state.passes.find((pass) => pass.pass === 'custom:glow') : null; const customParams = customGlow?.customParams || {}; const customParamKeys = Object.keys(customParams).sort().join('|'); return { status: [setBloom?.reasonCode, setCustom?.reasonCode, updateCustom?.reasonCode, setFilmgrain?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((pass) => pass.pass).join('|') : '', enabled: state?.enabledPasses, total: state?.totalPasses, customPassCount: state?.customPassCount, targetChainTargets: Array.isArray(targetChain?.intermediateTargets) ? targetChain.intermediateTargets.join('|') : '', targetChainCount: targetChain?.intermediateTargetCount, targetChainPingPong: targetChain?.pingPong === true, targetChainComposeMode: targetChain?.composeMode, targetChainFingerprint: state?.targetChainFingerprint, customParamFingerprint: state?.customParamFingerprint, customGlowIsCustom: customGlow?.isCustom === true, customGlowParamKeys: customParamKeys, customGlowIntensity: customParams?.intensity, customGlowThreshold: customParams?.threshold, mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'bloom|filmGrain|custom:glow' && first.total === 3 && first.enabled === 3 && first.customPassCount === 1 && first.targetChainTargets === 'maina|mainb' && first.targetChainCount === 2 && first.targetChainPingPong === true && first.targetChainComposeMode === 'additive' && Number.isFinite(first.targetChainFingerprint) && first.targetChainFingerprint > 0 && Number.isFinite(first.customParamFingerprint) && first.customParamFingerprint > 0 && first.customGlowIsCustom === true && first.customGlowParamKeys === 'intensity|threshold' && Math.abs(Number(first.customGlowIntensity) - 0.5) < 1e-3 && Math.abs(Number(first.customGlowThreshold) - 0.2) < 1e-3 && first.mutationDelta === 10 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
         },
         {
           id: 'draw3d.postfx.motion-blur.state.deterministic',
-          expression: "(() => { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'custom:filmgrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; const runSample = () => { resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const setInitial = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.75, radius: 12, threshold: 1.0, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const disable = aura.draw3d.setPostFXEnabled('motionBlur', false); const reenable = aura.draw3d.setPostFXEnabled('motionBlur', true); const update = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.35, radius: 6, threshold: 0.0 }); const state = aura.draw3d.getPostFXState() || {}; const pass = Array.isArray(state?.passes) ? state.passes.find((entry) => entry.pass === 'motionBlur') : null; return { status: [setInitial?.reasonCode, disable?.reasonCode, reenable?.reasonCode, update?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((entry) => entry.pass).join('|') : '', total: Number(state?.totalPasses || 0), enabled: Number(state?.enabledPasses || 0), strength: Number(pass?.strength || 0), radius: Number(pass?.radius || 0), threshold: Number(pass?.threshold || 0), mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk, targetChainCount: Number(state?.targetChain?.intermediateTargetCount || 0), targetChainPingPong: state?.targetChain?.pingPong === true, targetChainComposeMode: state?.targetChain?.composeMode || null }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'motionBlur' && first.total === 1 && first.enabled === 1 && Math.abs(first.strength - 0.35) < 1e-3 && Math.abs(first.radius - 6.0) < 1e-3 && Math.abs(first.threshold - 0.0) < 1e-3 && first.targetChainCount === 0 && first.targetChainPingPong === false && first.targetChainComposeMode === 'replace' && first.mutationDelta === 4 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
+          expression: "(() => { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'filmGrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; const runSample = () => { resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const setInitial = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.75, radius: 12, threshold: 1.0, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const disable = aura.draw3d.setPostFXEnabled('motionBlur', false); const reenable = aura.draw3d.setPostFXEnabled('motionBlur', true); const update = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.35, radius: 6, threshold: 0.0 }); const state = aura.draw3d.getPostFXState() || {}; const pass = Array.isArray(state?.passes) ? state.passes.find((entry) => entry.pass === 'motionBlur') : null; return { status: [setInitial?.reasonCode, disable?.reasonCode, reenable?.reasonCode, update?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((entry) => entry.pass).join('|') : '', total: Number(state?.totalPasses || 0), enabled: Number(state?.enabledPasses || 0), strength: Number(pass?.strength || 0), radius: Number(pass?.radius || 0), threshold: Number(pass?.threshold || 0), mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk, targetChainCount: Number(state?.targetChain?.intermediateTargetCount || 0), targetChainPingPong: state?.targetChain?.pingPong === true, targetChainComposeMode: state?.targetChain?.composeMode || null }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'motionBlur' && first.total === 1 && first.enabled === 1 && Math.abs(first.strength - 0.35) < 1e-3 && Math.abs(first.radius - 6.0) < 1e-3 && Math.abs(first.threshold - 0.0) < 1e-3 && first.targetChainCount === 0 && first.targetChainPingPong === false && first.targetChainComposeMode === 'replace' && first.mutationDelta === 4 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
         },
         {
           id: 'draw3d.postfx.ssao.state.deterministic',
-          expression: "(() => { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'custom:filmgrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; const runSample = () => { resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const setInitial = aura.draw3d.setPostFXPass('ssao', { strength: 1.1, radius: 0.42, threshold: 0.18, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const disable = aura.draw3d.setPostFXEnabled('ssao', false); const reenable = aura.draw3d.setPostFXEnabled('ssao', true); const update = aura.draw3d.setPostFXPass('ssao', { strength: 0.92, radius: 0.36, threshold: 0.24 }); const state = aura.draw3d.getPostFXState() || {}; const pass = Array.isArray(state?.passes) ? state.passes.find((entry) => entry.pass === 'ssao') : null; return { status: [setInitial?.reasonCode, disable?.reasonCode, reenable?.reasonCode, update?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((entry) => entry.pass).join('|') : '', total: Number(state?.totalPasses || 0), enabled: Number(state?.enabledPasses || 0), strength: Number(pass?.strength || 0), radius: Number(pass?.radius || 0), threshold: Number(pass?.threshold || 0), mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk, targetChainCount: Number(state?.targetChain?.intermediateTargetCount || 0), targetChainPingPong: state?.targetChain?.pingPong === true, targetChainComposeMode: state?.targetChain?.composeMode || null }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'ssao' && first.total === 1 && first.enabled === 1 && Math.abs(first.strength - 0.92) < 1e-3 && Math.abs(first.radius - 0.36) < 1e-3 && Math.abs(first.threshold - 0.24) < 1e-3 && first.targetChainCount === 0 && first.targetChainPingPong === false && first.targetChainComposeMode === 'replace' && first.mutationDelta === 4 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
+          expression: "(() => { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'filmGrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; const runSample = () => { resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const setInitial = aura.draw3d.setPostFXPass('ssao', { strength: 1.1, radius: 0.42, threshold: 0.18, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const disable = aura.draw3d.setPostFXEnabled('ssao', false); const reenable = aura.draw3d.setPostFXEnabled('ssao', true); const update = aura.draw3d.setPostFXPass('ssao', { strength: 0.92, radius: 0.36, threshold: 0.24 }); const state = aura.draw3d.getPostFXState() || {}; const pass = Array.isArray(state?.passes) ? state.passes.find((entry) => entry.pass === 'ssao') : null; return { status: [setInitial?.reasonCode, disable?.reasonCode, reenable?.reasonCode, update?.reasonCode].join('|'), order: Array.isArray(state?.passes) ? state.passes.map((entry) => entry.pass).join('|') : '', total: Number(state?.totalPasses || 0), enabled: Number(state?.enabledPasses || 0), strength: Number(pass?.strength || 0), radius: Number(pass?.radius || 0), threshold: Number(pass?.threshold || 0), mutationDelta: Number(state?.mutationCount || 0) - Number(baseline?.mutationCount || 0), lastReasonCode: state?.lastReasonCode, lastOk: state?.lastOk, targetChainCount: Number(state?.targetChain?.intermediateTargetCount || 0), targetChainPingPong: state?.targetChain?.pingPong === true, targetChainComposeMode: state?.targetChain?.composeMode || null }; }; const first = runSample(); const second = runSample(); return JSON.stringify(first) === JSON.stringify(second) && first.status === 'postfx_ok|postfx_ok|postfx_ok|postfx_ok' && first.order === 'ssao' && first.total === 1 && first.enabled === 1 && Math.abs(first.strength - 0.92) < 1e-3 && Math.abs(first.radius - 0.36) < 1e-3 && Math.abs(first.threshold - 0.24) < 1e-3 && first.targetChainCount === 0 && first.targetChainPingPong === false && first.targetChainComposeMode === 'replace' && first.mutationDelta === 4 && first.lastReasonCode === 'postfx_ok' && first.lastOk === true; })()",
         },
         {
           id: 'draw3d.postfx.reason-codes.stable',
@@ -1873,7 +1877,7 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         },
         {
           id: 'draw3d.postfx.ssr-dof.runtime.setup',
-          expression: `(() => { try { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'custom:filmgrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const meshHandle = aura.mesh.createBox(1, 1, 1); const materialHandle = aura.material.create({ color: { r: 0.35, g: 0.7, b: 0.95, a: 1 }, metallic: 0.1, roughness: 0.6 }); const nodeId = aura.scene3d.createNode({ position: { x: 0, y: 0, z: -2.5 } }); const bind = aura.scene3d.bindRenderNode(nodeId, meshHandle, materialHandle, { layer: 0, visible: true, cull: false }); aura.camera3d.perspective(60, 0.1, 100); aura.camera3d.setPosition(0, 0, 4); aura.camera3d.lookAt(0, 0, 0); const setSsr = aura.draw3d.setPostFXPass('ssr', { strength: 1.0, threshold: 0.35, maxSteps: 96, thickness: 0.25, fadeEdge: 0.8, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const setDof = aura.draw3d.setPostFXPass('dof', { strength: 0.9, focalDistance: 2.5, focalLength: 50, aperture: 2.2, maxBlur: 6.0 }); const setMotionBlur = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.65, radius: 12.0, threshold: 0.0 }); const baseDraw = aura.draw; aura.draw = function () { const frameIndex = Number(globalThis.__postfxRuntimeFrame || 0); aura.camera3d.setPosition(frameIndex * 0.15, 0, 4 - (frameIndex * 0.1)); aura.camera3d.lookAt(0, 0, 0); aura.draw3d.clear3d({ r: 0.02, g: 0.02, b: 0.03, a: 1 }); aura.scene3d.submitRenderBindings(); globalThis.__postfxRuntimeFrame = frameIndex + 1; baseDraw(); }; globalThis.__postfxRuntimeFrame = 0; globalThis.__postfxRuntimeProbe = { meshHandle, materialHandle, nodeId, bindOk: bind?.ok === true, setSsrReason: setSsr?.reasonCode || null, setDofReason: setDof?.reasonCode || null, setMotionBlurReason: setMotionBlur?.reasonCode || null, baselineMutationCount: Number(baseline?.mutationCount || 0) }; return Number.isInteger(meshHandle) && meshHandle > 0 && Number.isInteger(materialHandle) && materialHandle > 0 && Number.isInteger(nodeId) && nodeId > 0 && bind?.ok === true && setSsr?.ok === true && setDof?.ok === true && setMotionBlur?.ok === true; } catch (_) { return false; } })()`,
+          expression: `(() => { try { const resetPasses = () => { for (const passName of ['ssr', 'dof', 'motionBlur', 'bloom', 'colorGrade', 'vignette', 'fxaa', 'ssao', 'filmGrain', 'custom:glow']) { aura.draw3d.removePostFXPass(passName); } }; resetPasses(); const baseline = aura.draw3d.getPostFXState() || {}; const meshHandle = aura.mesh.createBox(1, 1, 1); const materialHandle = aura.material.create({ color: { r: 0.35, g: 0.7, b: 0.95, a: 1 }, metallic: 0.1, roughness: 0.6 }); const nodeId = aura.scene3d.createNode({ position: { x: 0, y: 0, z: -2.5 } }); const bind = aura.scene3d.bindRenderNode(nodeId, meshHandle, materialHandle, { layer: 0, visible: true, cull: false }); aura.camera3d.perspective(60, 0.1, 100); aura.camera3d.setPosition(0, 0, 4); aura.camera3d.lookAt(0, 0, 0); const setSsr = aura.draw3d.setPostFXPass('ssr', { strength: 1.0, threshold: 0.35, maxSteps: 96, thickness: 0.25, fadeEdge: 0.8, targetChain: { intermediateTargets: [], pingPong: false, composeMode: 'replace' } }); const setDof = aura.draw3d.setPostFXPass('dof', { strength: 0.9, focalDistance: 2.5, focalLength: 50, aperture: 2.2, maxBlur: 6.0 }); const setMotionBlur = aura.draw3d.setPostFXPass('motionBlur', { strength: 0.65, radius: 12.0, threshold: 0.0 }); const baseDraw = aura.draw; aura.draw = function () { const frameIndex = Number(globalThis.__postfxRuntimeFrame || 0); aura.camera3d.setPosition(frameIndex * 0.15, 0, 4 - (frameIndex * 0.1)); aura.camera3d.lookAt(0, 0, 0); aura.draw3d.clear3d({ r: 0.02, g: 0.02, b: 0.03, a: 1 }); aura.scene3d.submitRenderBindings(); globalThis.__postfxRuntimeFrame = frameIndex + 1; baseDraw(); }; globalThis.__postfxRuntimeFrame = 0; globalThis.__postfxRuntimeProbe = { meshHandle, materialHandle, nodeId, bindOk: bind?.ok === true, setSsrReason: setSsr?.reasonCode || null, setDofReason: setDof?.reasonCode || null, setMotionBlurReason: setMotionBlur?.reasonCode || null, baselineMutationCount: Number(baseline?.mutationCount || 0) }; return Number.isInteger(meshHandle) && meshHandle > 0 && Number.isInteger(materialHandle) && materialHandle > 0 && Number.isInteger(nodeId) && nodeId > 0 && bind?.ok === true && setSsr?.ok === true && setDof?.ok === true && setMotionBlur?.ok === true; } catch (_) { return false; } })()`,
         },
       ],
       nativePostChecks: [
@@ -2627,5 +2631,262 @@ export const SYSTEMS_AND_GAMEPLAY_CONFORMANCE_CASES = [
         };
       `,
       frames: 4,
+    },
+  {
+      id: 'asset-forward-2d-flagship-runtime',
+      modes: ['native'],
+      namespaces: ['animation', 'audio', 'draw2d', 'tilemap', 'debug'],
+      functions: [
+        'aura.animation.registerAtlas',
+        'aura.animation.resolveAtlasFrame',
+        'aura.animation.createAtlasClip',
+        'aura.animation.stepAtlasClip',
+        'aura.animation.getAtlasClipState',
+        'aura.audio.play',
+        'aura.audio.stopAll',
+        'aura.audio.setBusVolume',
+        'aura.audio.update',
+        'aura.audio.getMixerState',
+        'aura.draw2d.createRenderTarget',
+        'aura.draw2d.destroyRenderTarget',
+        'aura.draw2d.runCompositorGraph',
+        'aura.draw2d.sprite',
+        'aura.draw2d.text',
+        'aura.draw2d.clear',
+        'aura.tilemap.import',
+        'aura.tilemap.draw',
+        'aura.tilemap.setTile',
+        'aura.tilemap.removeRegion',
+        'aura.tilemap.queryRay',
+        'aura.tilemap.unload',
+        'aura.debug.inspectorStats',
+      ],
+      nativeChecks: [
+        {
+          id: 'asset-forward-2d.surface.methods',
+          expression: "(() => ['registerAtlas','resolveAtlasFrame','createAtlasClip','stepAtlasClip','getAtlasClipState'].every((name) => typeof aura.animation?.[name] === 'function') && ['play','stopAll','setBusVolume','update','getMixerState'].every((name) => typeof aura.audio?.[name] === 'function') && ['createRenderTarget','destroyRenderTarget','runCompositorGraph','sprite','text','clear'].every((name) => typeof aura.draw2d?.[name] === 'function') && ['import','draw','setTile','removeRegion','queryRay','unload'].every((name) => typeof aura.tilemap?.[name] === 'function') && typeof aura.debug?.inspectorStats === 'function')()",
+        },
+      ],
+      source: `
+        aura.setup = async function () {
+          if (aura.assets && typeof aura.assets.load === 'function') {
+            await aura.assets.load(['player.png', 'coin.wav']);
+          }
+
+          if (typeof aura.debug?.enableInspector === 'function') {
+            aura.debug.enableInspector(true);
+          }
+
+          const atlas = aura.animation.registerAtlas({
+            image: 'player.png',
+            frames: {
+              drive_0: { x: 0, y: 0, w: 16, h: 16 },
+              drive_1: { x: 0, y: 0, w: 16, h: 16 },
+              drive_2: { x: 0, y: 0, w: 16, h: 16 },
+            },
+            clips: {
+              drive: {
+                frames: ['drive_0', 'drive_1', 'drive_2'],
+                frameDuration: 0.1,
+                loop: true,
+              },
+            },
+          });
+          aura.test.assert(atlas && atlas.ok === true, 'asset-forward atlas registration should succeed');
+
+          const clip = aura.animation.createAtlasClip({
+            atlasId: atlas.atlasId,
+            clipKey: 'drive',
+            playing: true,
+          });
+          aura.test.assert(clip && clip.ok === true, 'asset-forward atlas clip should succeed');
+
+          const mapHandle = aura.tilemap.import({
+            width: 8,
+            height: 4,
+            tilewidth: 16,
+            tileheight: 16,
+            solidLayerNames: ['cover'],
+            layers: [
+              { name: 'ground', type: 'tilelayer', width: 8, height: 4, data: Array.from({ length: 32 }, () => 1) },
+              { name: 'cover', type: 'tilelayer', width: 8, height: 4, data: [
+                0, 0, 0, 0, 0, 0, 0, 0,
+                0, 0, 0, 0, 0, 0, 0, 0,
+                0, 0, 1, 1, 0, 0, 0, 0,
+                0, 0, 0, 0, 0, 0, 0, 0,
+              ], properties: { solid: true } },
+              { name: 'decor', type: 'tilelayer', width: 8, height: 4, data: [
+                0, 1, 0, 1, 0, 1, 0, 1,
+                1, 0, 1, 0, 1, 0, 1, 0,
+                0, 1, 0, 1, 0, 1, 0, 1,
+                1, 0, 1, 0, 1, 0, 1, 0,
+              ] },
+            ],
+            tilesets: [
+              { firstgid: 1, image: 'player.png', tilewidth: 16, tileheight: 16, tilecount: 1, columns: 1 },
+            ],
+          });
+          aura.test.assert(Number.isInteger(mapHandle) && mapHandle > 0, 'asset-forward tilemap import should succeed');
+
+          const panelTarget = aura.draw2d.createRenderTarget(160, 96);
+          const fxTarget = aura.draw2d.createRenderTarget(192, 112);
+          const finalTarget = aura.draw2d.createRenderTarget(224, 128);
+          aura.test.assert(panelTarget?.ok === true && fxTarget?.ok === true && finalTarget?.ok === true, 'asset-forward render targets should succeed');
+
+          const musicHandle = aura.audio.play('coin.wav', { volume: 0.2, loop: true, bus: 'music' });
+          const sfxHandle = aura.audio.play('coin.wav', { volume: 0.08, loop: true, bus: 'sfx' });
+          aura.test.assert(Number.isInteger(musicHandle) && musicHandle > 0, 'asset-forward music handle should be valid');
+          aura.test.assert(Number.isInteger(sfxHandle) && sfxHandle > 0, 'asset-forward sfx handle should be valid');
+          aura.test.assert(aura.audio.setBusVolume('music', 0.55)?.ok === true, 'music bus volume should be configurable');
+          aura.test.assert(aura.audio.setBusVolume('sfx', 0.7)?.ok === true, 'sfx bus volume should be configurable');
+
+          globalThis.__assetForward2dFlagship = {
+            atlasId: atlas.atlasId,
+            clipId: clip.clipId,
+            mapHandle,
+            panelTarget,
+            fxTarget,
+            finalTarget,
+            frames: [],
+            lastStepOk: false,
+          };
+        };
+
+        aura.update = function () {
+          const probe = globalThis.__assetForward2dFlagship;
+          const stepDt = [0.05, 0.06, 0.11, 0.08][probe.frames.length] || 0.05;
+          const step = aura.animation.stepAtlasClip(probe.clipId, stepDt);
+          probe.lastStepOk = !!step && step.ok === true;
+          aura.audio.update(0.125);
+
+          const tileX = 2 + (probe.frames.length % 2);
+          aura.tilemap.setTile(probe.mapHandle, 'cover', { x: tileX, y: 2 }, probe.frames.length >= 2 ? 1 : 0);
+          if (probe.frames.length === 1) {
+            aura.tilemap.removeRegion(probe.mapHandle, 'decor', { x: 6, y: 1, w: 1, h: 1 });
+          }
+        };
+
+        aura.draw = function () {
+          const probe = globalThis.__assetForward2dFlagship;
+          const frameIndex = probe.frames.length;
+          const clipState = aura.animation.getAtlasClipState(probe.clipId);
+          const spriteFrame = aura.animation.resolveAtlasFrame(probe.atlasId, clipState?.frameKey || 'drive_0');
+          const ray = aura.tilemap.queryRay(probe.mapHandle, { x: 0.5, y: 32.5, dx: 1, dy: 0, maxDistance: 128 });
+          const mixer = aura.audio.getMixerState() || {};
+          const musicBus = Array.isArray(mixer.buses)
+            ? mixer.buses.find((entry) => entry.bus === 'music')
+            : null;
+
+          aura.draw2d.clear(4, 6, 10);
+          let graph = null;
+          if (frameIndex === 0) {
+            graph = aura.draw2d.runCompositorGraph('asset-forward-2d-proof', [
+              {
+                id: 'panel',
+                target: probe.panelTarget,
+                draw: () => {
+                  aura.draw2d.clear(0, 0, 0, 0);
+                  aura.tilemap.draw(probe.mapHandle, {
+                    camera: { x: 0, y: 0, width: 128, height: 64 },
+                  });
+                  aura.draw2d.sprite(spriteFrame.image, 34, 22, {
+                    width: 32,
+                    height: 32,
+                    frameX: spriteFrame.frameX,
+                    frameY: spriteFrame.frameY,
+                    frameW: spriteFrame.frameW,
+                    frameH: spriteFrame.frameH,
+                  });
+                  aura.draw2d.text('ASSET-FORWARD', 10, 10, { size: 10, color: aura.colors.white });
+                },
+              },
+              {
+                id: 'fx',
+                target: probe.fxTarget,
+                draw: () => {
+                  aura.draw2d.clear(0, 0, 0, 0);
+                  aura.draw2d.sprite(probe.panelTarget, 0, 0, { width: 192, height: 112 });
+                  aura.draw2d.text('AUDIO x2', 14, 82, { size: 11, color: aura.colors.white });
+                },
+              },
+              {
+                id: 'final',
+                target: probe.finalTarget,
+                draw: () => {
+                  aura.draw2d.clear(0, 0, 0, 0);
+                  aura.draw2d.sprite(probe.fxTarget, 0, 0, { width: 224, height: 128 });
+                },
+              },
+            ]);
+            if (Array.isArray(graph?.stages) && graph.stages.length === 3) {
+              aura.draw2d.sprite(graph.stages[2], 8, 8, { width: 224, height: 128 });
+            }
+          } else {
+            aura.draw2d.sprite(probe.finalTarget, 8, 8, { width: 224, height: 128 });
+          }
+
+          const stats = aura.debug.inspectorStats() || {};
+          const compositor = stats.draw2dRuntime?.compositor || {};
+          probe.frames.push({
+            frameIndex,
+            graphReason: graph?.reasonCode || null,
+            graphStageCount: Number(graph?.stageCount || 0),
+            clipFrame: clipState?.frameKey || null,
+            clipLoops: Number(clipState?.loops || 0),
+            frameResolved: spriteFrame?.ok === true,
+            lastStepOk: probe.lastStepOk === true,
+            rayOk: ray?.ok === true,
+            rayHit: ray?.hit === true,
+            rayLayer: Number(ray?.hitCell?.layerIndex ?? -1),
+            trackCount: Array.isArray(mixer.tracks) ? mixer.tracks.length : -1,
+            musicBusVolume: musicBus ? Number(musicBus.volume.toFixed(6)) : null,
+            knownGraphCount: Number(compositor.knownGraphCount || 0),
+            lastGraphStageCount: Number(compositor.lastGraphStageCount || 0),
+            lastGraphReasonCode: compositor.lastGraphReasonCode || null,
+          });
+
+          if (probe.frames.length !== 4) {
+            return;
+          }
+
+          const trace = probe.frames.map((entry) => entry.clipFrame + ':' + entry.clipLoops);
+          const destroyPanel = aura.draw2d.destroyRenderTarget(probe.panelTarget);
+          const destroyFx = aura.draw2d.destroyRenderTarget(probe.fxTarget);
+          const destroyFinal = aura.draw2d.destroyRenderTarget(probe.finalTarget);
+          const missingDestroy = aura.draw2d.destroyRenderTarget(probe.finalTarget);
+          const unloaded = aura.tilemap.unload(probe.mapHandle);
+          aura.audio.stopAll();
+
+          aura.test.equal(
+            trace.join('|'),
+            'drive_0:0|drive_1:0|drive_2:0|drive_0:1',
+            'asset-forward animation trace should stay deterministic',
+          );
+          aura.test.assert(
+            probe.frames.every((entry) => entry.frameResolved === true && entry.lastStepOk === true),
+            'asset-forward atlas stepping should remain resolved each frame',
+          );
+          aura.test.assert(
+            probe.frames.every((entry) => entry.rayOk === true && entry.rayHit === true && entry.rayLayer === 1),
+            'asset-forward tilemap query pressure should remain deterministic',
+          );
+          aura.test.assert(
+            probe.frames.every((entry) => entry.trackCount === 2 && entry.musicBusVolume === 0.55),
+            'asset-forward audio concurrency should keep two live tracks and the expected bus volume',
+          );
+          aura.test.assert(
+            probe.frames[0].graphReason === 'draw2d_compositor_captured'
+              && probe.frames[0].graphStageCount === 3
+              && probe.frames[0].knownGraphCount === 1
+              && probe.frames[0].lastGraphStageCount === 3
+              && probe.frames[0].lastGraphReasonCode === 'draw2d_compositor_captured',
+            'asset-forward compositor capture should remain stable on the setup frame',
+          );
+          aura.test.assert(destroyPanel?.ok === true && destroyFx?.ok === true && destroyFinal?.ok === true, 'asset-forward render targets should destroy cleanly');
+          aura.test.assert(missingDestroy?.ok === false && missingDestroy?.reasonCode === 'missing_render_target', 'asset-forward render target destroy should remain reason-coded');
+          aura.test.equal(unloaded, true, 'asset-forward tilemap should unload cleanly');
+        };
+      `,
+      nativeFrames: 4,
     }
 ];

package/src/conformance-mobile.mjs

@@ -0,0 +1,166 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+import { buildMobileCapabilityAssertion } from './build-contract/capabilities.mjs';
+import { ANDROID_BUILD_MANIFEST_SCHEMA } from './mobile/android/build.mjs';
+import { IOS_BUILD_MANIFEST_SCHEMA } from './mobile/ios/build.mjs';
+import { normalizeMobileBuildTarget } from './mobile/shared/capabilities.mjs';
+
+function readJsonFile(path, label) {
+  const resolvedPath = resolve(path);
+  if (!existsSync(resolvedPath)) {
+    throw new Error(`${label} is missing: ${resolvedPath}`);
+  }
+  try {
+    return JSON.parse(readFileSync(resolvedPath, 'utf8'));
+  } catch (error) {
+    throw new Error(`Failed to parse ${label}: ${error.message}`);
+  }
+}
+
+export function validateAndroidBuildManifest(manifest) {
+  if (!manifest || typeof manifest !== 'object') {
+    return { ok: false, reasonCode: 'mobile_android_manifest_invalid' };
+  }
+  if (manifest.schema !== ANDROID_BUILD_MANIFEST_SCHEMA || manifest.buildTarget !== 'android') {
+    return { ok: false, reasonCode: 'mobile_android_manifest_invalid' };
+  }
+  if (
+    !manifest.buildStatus
+    || typeof manifest.buildStatus.release !== 'string'
+    || !manifest.toolchain
+    || !Array.isArray(manifest.toolchain.reasonCodes)
+  ) {
+    return { ok: false, reasonCode: 'mobile_android_manifest_invalid' };
+  }
+  return {
+    ok: true,
+    reasonCode: 'android_manifest_contract_ok',
+    buildStatus: manifest.buildStatus,
+    toolchain: manifest.toolchain,
+  };
+}
+
+export function validateIosBuildManifest(manifest) {
+  if (!manifest || typeof manifest !== 'object') {
+    return { ok: false, reasonCode: 'mobile_ios_manifest_invalid' };
+  }
+  if (manifest.schema !== IOS_BUILD_MANIFEST_SCHEMA || manifest.buildTarget !== 'ios') {
+    return { ok: false, reasonCode: 'mobile_ios_manifest_invalid' };
+  }
+  if (
+    !manifest.toolchain
+    || typeof manifest.toolchain.reasonCode !== 'string'
+    || !manifest.signing
+    || typeof manifest.signing.reasonCode !== 'string'
+    || !manifest.buildStatus
+    || typeof manifest.buildStatus.reasonCode !== 'string'
+  ) {
+    return { ok: false, reasonCode: 'mobile_ios_manifest_invalid' };
+  }
+  return {
+    ok: true,
+    reasonCode: 'ios_manifest_contract_ok',
+    buildStatus: manifest.buildStatus,
+    toolchain: manifest.toolchain,
+    signing: manifest.signing,
+  };
+}
+
+export function runMobileTargetConformance(options = {}) {
+  const projectRoot = resolve(options.projectRoot || process.cwd());
+  const target = normalizeMobileBuildTarget(options.target || 'mobile');
+  const capabilityReport = buildMobileCapabilityAssertion({
+    projectRoot,
+    modules: options.modules || {},
+    target,
+  });
+
+  if (!capabilityReport.ok) {
+    return {
+      ok: false,
+      reasonCode: 'mobile_required_api_unsupported',
+      target,
+      capabilityReport,
+      manifests: {},
+    };
+  }
+
+  const manifests = {};
+
+  if (target === 'android' || target === 'mobile') {
+    if (!options.androidManifestPath) {
+      return {
+        ok: false,
+        reasonCode: 'mobile_android_manifest_missing',
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    const resolvedAndroidManifestPath = resolve(options.androidManifestPath);
+    if (!existsSync(resolvedAndroidManifestPath)) {
+      return {
+        ok: false,
+        reasonCode: 'mobile_android_manifest_missing',
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    const androidManifest = readJsonFile(resolvedAndroidManifestPath, 'Android build manifest');
+    const androidReport = validateAndroidBuildManifest(androidManifest);
+    if (!androidReport.ok) {
+      return {
+        ok: false,
+        reasonCode: androidReport.reasonCode,
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    manifests.android = androidReport;
+  }
+
+  if (target === 'ios' || target === 'mobile') {
+    if (!options.iosManifestPath) {
+      return {
+        ok: false,
+        reasonCode: 'mobile_ios_manifest_missing',
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    const resolvedIosManifestPath = resolve(options.iosManifestPath);
+    if (!existsSync(resolvedIosManifestPath)) {
+      return {
+        ok: false,
+        reasonCode: 'mobile_ios_manifest_missing',
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    const iosManifest = readJsonFile(resolvedIosManifestPath, 'iOS build manifest');
+    const iosReport = validateIosBuildManifest(iosManifest);
+    if (!iosReport.ok) {
+      return {
+        ok: false,
+        reasonCode: iosReport.reasonCode,
+        target,
+        capabilityReport,
+        manifests,
+      };
+    }
+    manifests.ios = iosReport;
+  }
+
+  return {
+    ok: true,
+    reasonCode: 'mobile_target_conformance_ok',
+    target,
+    capabilityReport,
+    manifests,
+  };
+}