@aura3d/engine 1.4.5 → 1.5.1

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

@@ -0,0 +1,387 @@
+/**
+ * Reusable depth-layered environment composition.
+ *
+ * ## Why this exists
+ *
+ * Skyline Runner reads as a clean prototype rather than a game, and the measured reason is
+ * composition, not asset quality: in the retained route-primary frame a single flat sky bucket covers
+ * **44.3%** of the scene viewport, and flat sky plus flat ground together cover **24.9%** even after
+ * quantisation, with the playable content compressed into one horizontal band. There is no
+ * foreground, no middle distance, and no atmospheric separation -- so every element reads at the same
+ * apparent depth and the frame has no hierarchy.
+ *
+ * The instinct is to hand-place more props in the route. That is exactly what produced 30,141 lines of
+ * route-local visual code across four showcase games against 3,072 reusable lines. Skyline needs the
+ * *capability*, not the placements: a route should declare depth layers, density targets and spacing
+ * constraints, and reusable code should produce a deterministic composition from them.
+ *
+ * ## What this module does and does not do
+ *
+ * It is a pure **placement planner**. It consumes a declarative spec and returns typed placements with
+ * layer identity, depth, scale and a variation seed. It deliberately does not construct scene nodes,
+ * reference any renderer type, or know about Skyline, platformers, or any specific asset -- so the same
+ * planner serves racing set dressing, city blocks, or arena surrounds.
+ *
+ * Determinism is a hard requirement, not a convenience: retained screenshot evidence is only
+ * comparable if the same spec yields byte-identical placements. Placement therefore uses an explicit
+ * seeded PRNG, never `Math.random`.
+ */
+/**
+ * Plan a deterministic layered composition.
+ *
+ * Placement is rejection-sampled against `minSpacing` and `protectedZones` rather than nudged, because
+ * nudging a rejected placement biases props toward zone edges and produces visible clumping at exactly
+ * the boundaries gameplay cares about.
+ */
+export function planLayeredSceneComposition(spec) {
+    const densityScale = positiveOr(spec.densityScale, 1);
+    const placements = [];
+    const layerReports = [];
+    // One stream per layer, seeded from the spec seed and the layer index, so adding or removing a
+    // layer cannot reshuffle the layers before it.
+    for (const [layerIndex, layer] of spec.layers.entries()) {
+        const random = createSeededRandom(spec.seed + layerIndex * 0x9e37);
+        const span = normalizedRange(layer.span);
+        const spanWidth = Math.max(0, span[1] - span[0]);
+        const requested = Math.max(0, Math.round(spanWidth * Math.max(0, layer.densityPerUnit) * densityScale));
+        const candidates = weightedPropKinds(layer.props);
+        const heightRange = normalizedRange(layer.heightRange ?? [0, 0]);
+        const scaleRange = normalizedRange(layer.scaleRange);
+        const minSpacing = Math.max(0, layer.minSpacing ?? 0);
+        const atmosphere = clamp01(layer.atmosphere ?? 0);
+        const zones = (spec.protectedZones ?? []).filter((zone) => !zone.roles || zone.roles.includes(layer.role));
+        const placedXs = [];
+        let rejectedForSpacing = 0;
+        let rejectedForProtectedZone = 0;
+        const usedProps = new Set();
+        if (candidates.length > 0 && requested > 0 && spanWidth > 0) {
+            // Bounded attempts: a dense layer inside a tight span can be genuinely unsatisfiable, and a
+            // planner must degrade to fewer props rather than loop forever.
+            const maxAttempts = requested * 12 + 24;
+            for (let attempt = 0; attempt < maxAttempts && placedXs.length < requested; attempt += 1) {
+                const x = round4(span[0] + random() * spanWidth);
+                if (zones.some((zone) => withinRange(x, normalizedRange(zone.span)))) {
+                    rejectedForProtectedZone += 1;
+                    continue;
+                }
+                if (minSpacing > 0 && placedXs.some((existing) => Math.abs(existing - x) < minSpacing)) {
+                    rejectedForSpacing += 1;
+                    continue;
+                }
+                const kind = pickWeighted(candidates, random());
+                const baseScale = scaleRange[0] + random() * (scaleRange[1] - scaleRange[0]);
+                placedXs.push(x);
+                usedProps.add(kind.id);
+                placements.push({
+                    layer: layer.role,
+                    prop: kind.id,
+                    x,
+                    y: round4(heightRange[0] + random() * (heightRange[1] - heightRange[0])),
+                    z: round4(layer.depth),
+                    scale: round4(baseScale * positiveOr(kind.scaleBias, 1)),
+                    // Full-circle yaw variation: repeated props are the main source of visible cloning.
+                    rotationY: round4(random() * Math.PI * 2),
+                    variation: round4(random()),
+                    atmosphere
+                });
+            }
+        }
+        layerReports.push({
+            role: layer.role,
+            depth: round4(layer.depth),
+            requested,
+            placed: placedXs.length,
+            rejectedForSpacing,
+            rejectedForProtectedZone,
+            distinctProps: usedProps.size,
+            atmosphere
+        });
+    }
+    return {
+        kind: "aura-layered-scene-composition",
+        seed: spec.seed,
+        placements,
+        layers: layerReports,
+        populatedRoles: layerReports.filter((report) => report.placed > 0).map((report) => report.role)
+    };
+}
+export function platformerCompositionSpec(options) {
+    const span = normalizedRange(options.span);
+    const width = Math.max(0.001, span[1] - span[0]);
+    return {
+        seed: options.seed,
+        ...(options.densityScale !== undefined ? { densityScale: options.densityScale } : {}),
+        ...(options.protectedZones ? { protectedZones: options.protectedZones } : {}),
+        layers: [
+            {
+                // Nearest band, in front of the play plane. Sparse and large: it frames the shot and creates
+                // parallax without ever occluding gameplay, which is why its density is the lowest.
+                //
+                // Density is per *unit*, so a level whose visible window is only a fraction of its full span
+                // gets very few near props in frame. `0.5` keeps a near band present at typical side-scroller
+                // camera distances; the earlier `0.12` produced two props across the whole level, both of which
+                // fell outside the camera's view of the start area.
+                role: "foreground",
+                depth: options.gameplayDepth + width * 0.06,
+                span,
+                props: options.foregroundProps,
+                densityPerUnit: 0.28,
+                scaleRange: [0.9, 1.4],
+                minSpacing: width * 0.07,
+                heightRange: [-0.05, 0.05],
+                atmosphere: 0
+            },
+            {
+                // The layer Skyline is missing entirely. Densest of the set: middle distance is what makes a
+                // frame read as a populated world rather than props on an empty plane.
+                role: "midground",
+                depth: options.gameplayDepth - width * 0.1,
+                span: [span[0] - width * 0.08, span[1] + width * 0.08],
+                props: options.midgroundProps,
+                densityPerUnit: 1.0,
+                scaleRange: [0.55, 0.95],
+                minSpacing: width * 0.012,
+                heightRange: [-0.1, 0.25],
+                atmosphere: 0.35
+            },
+            {
+                // Far silhouettes. Heavily attenuated so they separate from the midground by value rather
+                // than by detail, which is what stops a low-poly asset set reading as flat.
+                role: "far-background",
+                depth: options.gameplayDepth - width * 0.34,
+                span: [span[0] - width * 0.2, span[1] + width * 0.2],
+                props: options.backgroundProps,
+                densityPerUnit: 0.5,
+                scaleRange: [1.1, 2.2],
+                minSpacing: width * 0.03,
+                heightRange: [-0.2, 0.5],
+                atmosphere: 0.72
+            }
+        ]
+    };
+}
+/**
+ * Measure how much of a frame is flat, unbroken sky or ground.
+ *
+ * Skyline's core defect is measurable and therefore gateable. This computes the dominant-flat-region
+ * fraction so a composition change can be held to a documented threshold instead of an opinion.
+ */
+export function measureFlatRegionFraction(pixels, width, height, options = {}) {
+    const channels = options.channels ?? 4;
+    const shift = Math.max(0, Math.min(7, options.quantiseBits ?? 4));
+    const total = Math.max(1, width * height);
+    const counts = new Map();
+    for (let index = 0; index + channels - 1 < pixels.length; index += channels) {
+        const r = (pixels[index] ?? 0) >> shift;
+        const g = (pixels[index + 1] ?? 0) >> shift;
+        const b = (pixels[index + 2] ?? 0) >> shift;
+        const key = (r << 16) | (g << 8) | b;
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    const sorted = [...counts.values()].sort((a, b) => b - a);
+    const dominant = sorted[0] ?? 0;
+    // Flat region = the two largest buckets, which for an outdoor frame are sky and ground.
+    const flat = dominant + (sorted[1] ?? 0);
+    return {
+        flatFraction: round4(flat / total),
+        dominantBucketFraction: round4(dominant / total),
+        distinctBuckets: counts.size
+    };
+}
+/**
+ * Small deterministic PRNG (mulberry32).
+ *
+ * Chosen over any ambient randomness because retained screenshot evidence must be reproducible: the
+ * same spec has to yield identical placements on every machine and every run.
+ */
+function createSeededRandom(seed) {
+    let state = (seed | 0) + 0x6d2b79f5;
+    return () => {
+        state = (state + 0x6d2b79f5) | 0;
+        let t = Math.imul(state ^ (state >>> 15), 1 | state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+function weightedPropKinds(props) {
+    const out = [];
+    let cumulative = 0;
+    for (const prop of props) {
+        const weight = positiveOr(prop.weight, 1);
+        cumulative += weight;
+        out.push({ ...prop, cumulative });
+    }
+    return out;
+}
+function pickWeighted(candidates, sample) {
+    const last = candidates[candidates.length - 1];
+    if (!last)
+        throw new Error("planLayeredSceneComposition requires at least one prop kind per populated layer.");
+    const target = sample * last.cumulative;
+    for (const candidate of candidates) {
+        if (target < candidate.cumulative)
+            return candidate;
+    }
+    return last;
+}
+function normalizedRange(range) {
+    return range[0] <= range[1] ? [range[0], range[1]] : [range[1], range[0]];
+}
+function withinRange(value, range) {
+    return value >= range[0] && value <= range[1];
+}
+function positiveOr(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function clamp01(value) {
+    return Math.min(1, Math.max(0, value));
+}
+function round4(value) {
+    const rounded = Math.round(value * 10_000) / 10_000;
+    return rounded === 0 ? 0 : rounded;
+}
+/**
+ * Plan a banded sky backdrop from declarative intent.
+ *
+ * Bands above the horizon band are distributed with increasing height, because a linear split puts
+ * equal value change into the zenith (where a viewer reads none) and the horizon (where all of it is).
+ */
+export function planSkyBackdrop(spec) {
+    const span = normalizedRange(spec.span);
+    // Widen well past the span: a backdrop whose edge enters frame is worse than no backdrop, and the
+    // camera's horizontal view at side-scroller distances exceeds the level span.
+    const width = round4(Math.max(0.001, (span[1] - span[0]) * 1.6 + 12));
+    const height = Math.max(0.001, spec.height);
+    const bandCount = resolveBandCount(spec.bands, 4);
+    const horizonFraction = Math.min(0.8, Math.max(0.05, positiveOr(spec.horizonBandFraction, 0.22)));
+    const z = round4(spec.depth);
+    const bands = [];
+    // Sky side, upward from the horizon.
+    for (const band of gradedBands(height, bandCount, horizonFraction)) {
+        bands.push({
+            index: band.index,
+            side: "sky",
+            centerY: round4(spec.horizonY + band.offset + band.height / 2),
+            height: round4(band.height),
+            width,
+            z,
+            blend: round4(band.blend),
+            // Horizon glow: strongest at blend 0, never fully dark at the zenith.
+            emissiveIntensity: round4(0.52 - band.blend * 0.34)
+        });
+    }
+    // Ground side, downward from the horizon. Requested explicitly, because many scenes show nothing there.
+    const belowHeight = Math.max(0, spec.belowHorizonHeight ?? 0);
+    if (belowHeight > 0) {
+        const belowCount = resolveBandCount(spec.belowHorizonBands, Math.max(2, Math.round(bandCount / 2)));
+        for (const band of gradedBands(belowHeight, belowCount, horizonFraction)) {
+            bands.push({
+                index: band.index,
+                side: "ground",
+                centerY: round4(spec.horizonY - band.offset - band.height / 2),
+                height: round4(band.height),
+                width,
+                z,
+                blend: round4(band.blend),
+                // Ground darkens away from the horizon, mirroring the sky's falloff rather than repeating it.
+                emissiveIntensity: round4(0.34 - band.blend * 0.26)
+            });
+        }
+    }
+    return {
+        kind: "aura-sky-backdrop-plan",
+        bands,
+        horizonY: round4(spec.horizonY),
+        zenithY: round4(spec.horizonY + height),
+        nadirY: round4(spec.horizonY - belowHeight)
+    };
+}
+/**
+ * Clamp an explicitly provided band count rather than falling back to the default.
+ *
+ * `positiveOr(count, fallback)` would turn an explicit `0` into the default, which is unpredictable: a
+ * caller who computed a count and got zero would silently receive the default instead of the documented
+ * floor. `undefined` means "use the default"; any provided number is clamped into the supported range.
+ */
+function resolveBandCount(requested, fallback) {
+    if (requested === undefined || !Number.isFinite(requested))
+        return fallback;
+    // Upper bound raised from 12 to 32: at 5 bands over Skyline's own ramp the measured step was 21 per
+    // channel, which reads as visible banding rather than a gradient (see `skyBandCountForRamp`). Keeping a
+    // bound at all still prevents a caller from requesting thousands of quads by accident.
+    return Math.max(2, Math.min(32, Math.round(requested)));
+}
+/**
+ * Distribute one side of the backdrop into contiguous bands, finest at the horizon.
+ *
+ * Band heights grow away from the horizon because a linear split puts equal value change into the zenith
+ * (where a viewer reads none) and the horizon (where all of it is).
+ */
+function gradedBands(height, count, horizonFraction) {
+    const horizonHeight = height * horizonFraction;
+    const remaining = height - horizonHeight;
+    const weights = [];
+    for (let index = 1; index < count; index += 1)
+        weights.push(index);
+    const weightTotal = weights.reduce((sum, weight) => sum + weight, 0) || 1;
+    const out = [];
+    let offset = 0;
+    for (let index = 0; index < count; index += 1) {
+        const bandHeight = index === 0 ? horizonHeight : (remaining * (weights[index - 1] ?? 1)) / weightTotal;
+        out.push({ index, offset, height: bandHeight, blend: count === 1 ? 0 : index / (count - 1) });
+        offset += bandHeight;
+    }
+    return out;
+}
+/**
+ * Interpolate a hex colour ramp for a band's `blend`.
+ *
+ * Provided here rather than left to each route because "gradient sky" is only reusable if producing the
+ * per-band colour is reusable too; a route that has to write its own hex mixing has not been relieved
+ * of the art-direction code this layer exists to absorb.
+ */
+export function blendSkyBandColor(horizonColor, zenithColor, blend) {
+    const from = parseHexColor(horizonColor);
+    const to = parseHexColor(zenithColor);
+    const t = clamp01(blend);
+    const mix = (a, b) => Math.round(a + (b - a) * t);
+    return `#${[mix(from[0], to[0]), mix(from[1], to[1]), mix(from[2], to[2])]
+        .map((channel) => Math.min(255, Math.max(0, channel)).toString(16).padStart(2, "0"))
+        .join("")}`;
+}
+/**
+ * Minimum band count that keeps a colour ramp from reading as visible banding.
+ *
+ * ## Why this is a reusable function and not a constant
+ *
+ * A banded backdrop trades one defect for another if the band count is chosen by eye. Skyline's first
+ * banded sky used 5 bands over `#4e93b4 -> #173a5c`; sampling the rendered frame down a backdrop-only
+ * column measured hard steps of **21 per channel** at the horizon and 18 in the ground ramp -- a visible
+ * stair, replacing "flat sky" with "banded sky".
+ *
+ * The step size is a property of the *ramp*, not of taste: it is the largest per-channel endpoint
+ * distance divided by the number of gaps between bands. So the correct band count is derivable, and any
+ * route with any pair of colours can derive it instead of guessing. `maxChannelStep` defaults to 8, which
+ * is below the threshold where adjacent flat quads read as an edge at typical viewing sizes.
+ */
+export function skyBandCountForRamp(fromColor, toColor, maxChannelStep = 8) {
+    const from = parseHexColor(fromColor);
+    const to = parseHexColor(toColor);
+    const widestChannelRange = Math.max(Math.abs(from[0] - to[0]), Math.abs(from[1] - to[1]), Math.abs(from[2] - to[2]));
+    const step = Math.max(1, maxChannelStep);
+    // `+ 1` converts gaps to bands; a 2-band backdrop has one gap.
+    return Math.max(2, Math.ceil(widestChannelRange / step) + 1);
+}
+function parseHexColor(value) {
+    const hex = value.trim().replace(/^#/, "");
+    const expanded = hex.length === 3 ? hex.split("").map((char) => char + char).join("") : hex;
+    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {
+        throw new Error(`blendSkyBandColor requires a 3- or 6-digit hex colour, received "${value}".`);
+    }
+    return [
+        Number.parseInt(expanded.slice(0, 2), 16),
+        Number.parseInt(expanded.slice(2, 4), 16),
+        Number.parseInt(expanded.slice(4, 6), 16)
+    ];
+}
+//# sourceMappingURL=LayeredSceneComposition.js.map

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

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

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

@@ -0,0 +1,177 @@
+/**
+ * Reusable platformer motion tuning and level solvability.
+ *
+ * ## The defects this addresses
+ *
+ * Skyline Runner's jump was reported as unnatural, floaty, and unreliable to land,
+ * with a world that read as disconnected floating strips and a session that ended in
+ * about half a minute. Those are not four unrelated complaints; three of them follow
+ * from one number.
+ *
+ * The level ships `jumpVelocity: 7.4` and inherits the kit default `gravity: -22`.
+ * That gives an apex of `v^2 / 2g = 1.245` world units and an airtime of
+ * `2v / g = 0.673` seconds. The level's platforms step up by at most **0.36** units
+ * and are separated by gaps of at most **0.30** units. So every jump rises about
+ * 3.5x higher than the tallest step it needs to clear and travels well past the
+ * widest gap, with the character spending two thirds of a second in the air on a
+ * course whose obstacles need a fraction of that. The character therefore appears to
+ * float above the level rather than move through it, landings arrive long after the
+ * player expects them, and because the apex dwarfs the platform spacing the platforms
+ * read as unrelated strips rather than as a connected route.
+ *
+ * The engine defect is that nothing related jump tuning to level geometry, so a level
+ * could ship physically inconsistent with its own platforms and every gate would pass:
+ * the level is *solvable* (an over-powered jump clears everything), the screenshots
+ * look fine, and no metric compares apex to step height.
+ *
+ * This module closes that gap. {@link solvePlatformerMotion} derives gravity, jump
+ * velocity and move speed from what a level actually asks the player to do, and
+ * {@link validatePlatformerMotion} reports when a level's tuning is inconsistent with
+ * its geometry -- both over-powered (floaty) and under-powered (unclearable).
+ *
+ * Pure and dependency-free.
+ */
+export interface PlatformerPlatformLike {
+    readonly id?: string | undefined;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height?: number | undefined;
+}
+export interface PlatformerGeometryFacts {
+    /** Largest upward step between consecutive platforms, in world units. */
+    readonly maxRise: number;
+    /** Largest horizontal gap between consecutive platforms, in world units. */
+    readonly maxGap: number;
+    /** Total horizontal span of the course. */
+    readonly courseLength: number;
+    /** Narrowest platform, which bounds how precise a landing must be. */
+    readonly minPlatformWidth: number;
+    readonly platformCount: number;
+}
+/**
+ * Measure what a level asks the player to do.
+ *
+ * Consecutive platforms are taken in x order, which matches how a side-scrolling
+ * course is traversed. Gaps are measured edge to edge and rises top to top.
+ */
+export declare function measurePlatformerGeometry(platforms: readonly PlatformerPlatformLike[]): PlatformerGeometryFacts;
+export interface PlatformerMotionRequest {
+    /**
+     * Time from leaving the ground to the apex, in seconds.
+     *
+     * This is the parameter that decides how a jump *feels*, and it is a genuine design
+     * value rather than something to derive: platformers land between roughly 0.22s
+     * (snappy, arcade) and 0.42s (floaty, deliberate). Everything else follows from it
+     * plus the level's geometry.
+     */
+    readonly riseSeconds?: number | undefined;
+    /**
+     * Headroom above the tallest step the jump must clear, as a multiple of that step.
+     *
+     * 1.0 would only just reach the next platform, which leaves no margin for a slightly
+     * late input. Around 1.6 reads as comfortable without floating.
+     */
+    readonly apexHeadroom?: number | undefined;
+    /**
+     * Horizontal margin over the widest gap, as a multiple of that gap.
+     *
+     * Above 1 the player can clear the widest gap without a frame-perfect jump.
+     */
+    readonly gapMargin?: number | undefined;
+    /** Minimum apex, so a level with no rises still has a usable jump. */
+    readonly minApex?: number | undefined;
+    /**
+     * Target session length in seconds, used to derive move speed from course length.
+     *
+     * A course is only as long as the time it takes to cross; deriving speed from an
+     * intended duration is how a level gets a session length on purpose rather than by
+     * accident. Skyline's 16.6-unit course at 1.15 units/second crosses in 14 seconds,
+     * which is why the session felt like it ended arbitrarily.
+     */
+    readonly targetSessionSeconds?: number | undefined;
+    /**
+     * Fraction of the session spent traversing rather than jumping, retrying and
+     * exploring. Below 1 because a player does not walk the course in a straight line.
+     */
+    readonly traversalFraction?: number | undefined;
+}
+export interface PlatformerMotionSolution {
+    readonly kind: "aura-platformer-motion";
+    /** Gravity, negative (downward), in world units per second squared. */
+    readonly gravity: number;
+    /** Initial upward velocity of a full jump. */
+    readonly jumpVelocity: number;
+    /** Horizontal move speed. */
+    readonly moveSpeed: number;
+    /** Apex height above the takeoff surface. */
+    readonly apex: number;
+    /** Total airtime of a full jump, rise plus fall. */
+    readonly airtime: number;
+    /** Horizontal distance covered during a full jump at `moveSpeed`. */
+    readonly jumpReach: number;
+    /** Coyote time in milliseconds, scaled to airtime. */
+    readonly coyoteMs: number;
+    /** Jump buffer in milliseconds, scaled to airtime. */
+    readonly jumpBufferMs: number;
+    /** Terminal fall speed, so a long drop does not accelerate without limit. */
+    readonly terminalVelocity: number;
+    /** Geometry the solution was derived from. */
+    readonly geometry: PlatformerGeometryFacts;
+    /** Estimated time to traverse the course at `moveSpeed`. */
+    readonly traversalSeconds: number;
+    /** Estimated full session length including jumping and retries. */
+    readonly estimatedSessionSeconds: number;
+}
+/**
+ * Derive platformer motion from a level's own geometry.
+ *
+ * The apex is sized to the tallest step the player must clear, not chosen freely, so a
+ * jump cannot overshoot the level by 3.5x. Gravity then follows from the apex and the
+ * chosen rise time, and jump velocity from gravity and rise time. Move speed is sized
+ * so the jump clears the widest gap and the course takes a chosen amount of time.
+ */
+export declare function solvePlatformerMotion(platforms: readonly PlatformerPlatformLike[], request?: PlatformerMotionRequest): PlatformerMotionSolution;
+export interface PlatformerMotionCheck {
+    readonly id: string;
+    readonly description: string;
+    readonly passes: boolean;
+    readonly detail: string;
+}
+export interface PlatformerMotionReport {
+    readonly schema: "aura3d-platformer-motion-invariants/1.0";
+    readonly geometry: PlatformerGeometryFacts;
+    readonly measured: {
+        readonly apex: number;
+        readonly airtime: number;
+        readonly jumpReach: number;
+        readonly apexToRiseRatio: number;
+        readonly reachToGapRatio: number;
+    };
+    readonly checks: readonly PlatformerMotionCheck[];
+    readonly passes: boolean;
+}
+/**
+ * Check that a level's motion tuning is consistent with its geometry.
+ *
+ * This is the check that was missing. A level can be perfectly solvable and still feel
+ * wrong: an over-powered jump clears every obstacle, so solvability passes, while the
+ * character visibly floats. Both directions are failures.
+ */
+export declare function validatePlatformerMotion(platforms: readonly PlatformerPlatformLike[], motion: {
+    readonly gravity: number;
+    readonly jumpVelocity: number;
+    readonly moveSpeed: number;
+}, limits?: {
+    /** Maximum apex as a multiple of the tallest step. Above this the jump floats. */
+    readonly maxApexToRiseRatio?: number | undefined;
+    /** Minimum apex as a multiple of the tallest step. Below this a step is unclearable. */
+    readonly minApexToRiseRatio?: number | undefined;
+    /** Maximum jump reach as a multiple of the widest gap. */
+    readonly maxReachToGapRatio?: number | undefined;
+    /** Minimum jump reach as a multiple of the widest gap. */
+    readonly minReachToGapRatio?: number | undefined;
+    /** Maximum airtime in seconds before a jump reads as floaty regardless of ratios. */
+    readonly maxAirtimeSeconds?: number | undefined;
+}): PlatformerMotionReport;
+//# sourceMappingURL=PlatformerMotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformerMotion.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PlatformerMotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAAG,uBAAuB,CAwB/G;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,mEAAmE;IACnE,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,sBAAsB,EAAE,EAC5C,OAAO,GAAE,uBAA4B,GACpC,wBAAwB,CAmD1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,yCAAyC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,sBAAsB,EAAE,EAC5C,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC/F,MAAM,GAAE;IACN,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,qFAAqF;IACrF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,GACL,sBAAsB,CAsExB"}