@peekling/runtime 0.1.0 → 0.1.2

package/dist/peekling.min.js.sri

@@ -1 +1 @@
-sha384-iJtnL5uLVg+cNs8qk9f4hwjOyplSaORCqdss7xunkEfv9w1j5rUCkFqBcK1WslGW
+sha384-1p+Dobs8owBmemeSfa0ciVA+xFHqPe9FXpAO4pbheJPfZowG117I/+kFlsDa4jUq

package/dist/plan-compiler.d.ts

@@ -3,7 +3,9 @@ export interface PlanCompileContext {
     states?: ReadonlySet<string>;
     capabilities?: ReadonlySet<PlanCapability>;
     contentIds?: ReadonlySet<string>;
+    targets?: ReadonlySet<string>;
     validateSelector?: (selector: string) => boolean;
+    validatePath?: (path: string) => boolean;
 }
 export interface CompiledPlanStateSelection {
     readonly kind: "state" | "capability";

package/dist/plan-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-compiler.d.ts","sourceRoot":"","sources":["../src/plan-compiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-compiler.d.ts","sourceRoot":"","sources":["../src/plan-compiler.ts"],"names":[],"mappings":"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"}

package/dist/plan-compiler.js

@@ -316,7 +316,7 @@ function compileEffect(input, path, context, allowPayload) {
         : compileState(input.state, `${path}.state`, context);
     const motion = input.motion === undefined
         ? undefined
-        : compileMotion(input.motion, `${path}.motion`);
+        : compileMotion(input.motion, `${path}.motion`, context);
     const surfaces = input.surfaces === undefined ? [] : input.surfaces;
     if (!Array.isArray(surfaces) || surfaces.length > SURFACE_LIMIT) {
         fail("surface-limit", `${path}.surfaces`, `must contain at most ${SURFACE_LIMIT} surfaces`);
@@ -421,21 +421,78 @@ function compileState(input, path, context) {
     }
     return freeze({ kind: "capability", name: input.capability });
 }
-function compileMotion(input, path) {
+function compileMotion(input, path, context) {
     object(input, path);
-    closed(input, ["type", "speed", "arrivalRadius"], path);
-    if (input.type !== "follow-pointer") {
-        fail("invalid-motion", `${path}.type`, "must be follow-pointer");
+    switch (input.type) {
+        case "follow-pointer":
+            closed(input, ["type", "speed", "arrivalRadius"], path);
+            bounded(input.speed, `${path}.speed`, 1, 1_000);
+            bounded(input.arrivalRadius, `${path}.arrivalRadius`, 0, 1_000);
+            break;
+        case "horizontal-patrol":
+            closed(input, ["type", "speed", "edgeInset"], path);
+            bounded(input.speed, `${path}.speed`, 1, 1_000);
+            bounded(input.edgeInset, `${path}.edgeInset`, 0, 1_000);
+            break;
+        case "viewport-traverse":
+            closed(input, ["type", "speed", "edgeInset", "clockwise"], path);
+            bounded(input.speed, `${path}.speed`, 1, 1_000);
+            bounded(input.edgeInset, `${path}.edgeInset`, 0, 1_000);
+            if (input.clockwise !== undefined &&
+                typeof input.clockwise !== "boolean") {
+                fail("invalid-motion", `${path}.clockwise`, "must be boolean");
+            }
+            break;
+        case "move-to":
+            closed(input, ["type", "x", "y", "speed", "arrivalRadius"], path);
+            bounded(input.x, `${path}.x`, -100_000, 100_000);
+            bounded(input.y, `${path}.y`, -100_000, 100_000);
+            bounded(input.speed, `${path}.speed`, 1, 1_000);
+            bounded(input.arrivalRadius, `${path}.arrivalRadius`, 0, 1_000);
+            break;
+        case "move-to-target":
+            closed(input, ["type", "target", "anchor", "speed", "arrivalRadius"], path);
+            id(input.target, `${path}.target`, "Target");
+            if (context.targets && !context.targets.has(input.target)) {
+                fail("unknown-target", `${path}.target`, `references unknown target ${input.target}`);
+            }
+            if (input.anchor !== undefined &&
+                !["center", "top", "right", "bottom", "left"].includes(input.anchor)) {
+                fail("invalid-motion", `${path}.anchor`, "is not supported");
+            }
+            bounded(input.speed, `${path}.speed`, 1, 1_000);
+            bounded(input.arrivalRadius, `${path}.arrivalRadius`, 0, 1_000);
+            break;
+        case "jump-to":
+            closed(input, ["type", "x", "y", "duration", "height"], path);
+            bounded(input.x, `${path}.x`, -100_000, 100_000);
+            bounded(input.y, `${path}.y`, -100_000, 100_000);
+            bounded(input.duration, `${path}.duration`, 100, 10_000);
+            bounded(input.height, `${path}.height`, 0, 2_000);
+            break;
+        case "svg-path": {
+            closed(input, ["type", "path", "duration", "loop", "relative"], path);
+            if (typeof input.path !== "string" ||
+                input.path.length < 1 ||
+                input.path.length > 4_096 ||
+                /[\0\r\n]/.test(input.path)) {
+                fail("invalid-path", `${path}.path`, "must be bounded SVG path data");
+            }
+            if (context.validatePath && !context.validatePath(input.path)) {
+                fail("invalid-path", `${path}.path`, "must be valid SVG path data");
+            }
+            bounded(input.duration, `${path}.duration`, 100, 60_000);
+            for (const field of ["loop", "relative"]) {
+                if (input[field] !== undefined && typeof input[field] !== "boolean") {
+                    fail("invalid-motion", `${path}.${field}`, "must be boolean");
+                }
+            }
+            break;
+        }
+        default:
+            fail("invalid-motion", `${path}.type`, "is not a supported motion type");
     }
-    bounded(input.speed, `${path}.speed`, 1, 1_000);
-    bounded(input.arrivalRadius, `${path}.arrivalRadius`, 0, 1_000);
-    return freeze({
-        type: "follow-pointer",
-        ...(input.speed === undefined ? {} : { speed: input.speed }),
-        ...(input.arrivalRadius === undefined
-            ? {}
-            : { arrivalRadius: input.arrivalRadius }),
-    });
+    return freeze({ ...input });
 }
 function compileSurface(input, path, context, allowPayload) {
     object(input, path);

package/dist/plan.d.ts

@@ -1,11 +1,13 @@
 import { type CompiledPlan, type PlanEventEvaluation } from "./plan-compiler.js";
-import { type BehaviorRequest, type Plan, type World } from "./types.js";
+import { type BehaviorRequest, type HorizontalPatrolMotionEffect, type MotionRequest, type Plan, type PeeklingPreset, type ViewportTraverseMotionEffect, type World } from "./types.js";
 export declare function compiledPlanSectionRequirements(plan: CompiledPlan): {
     selectors: readonly string[];
     thresholds: readonly number[];
 };
 /** The engine-owned default Plan policy. It uses the public Plan shape. */
 export declare function createDefaultPlan(locomotion: boolean): Plan;
+/** Small named starting points that compile into the canonical Plan. */
+export declare function createPresetPlan(preset: PeeklingPreset, locomotion: boolean): Plan;
 /** Instance-owned evaluator for one immutable compiled Plan. */
 export declare class PlanRuntime {
     #private;
@@ -18,4 +20,28 @@ export declare class PlanRuntime {
     nextWakeAt(): number | undefined;
     rebase(delta: number): void;
 }
+export type PatrolDirection = boolean;
+interface PatrolWorld {
+    readonly position: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly viewport: Readonly<{
+        width: number;
+        height: number;
+    }>;
+    readonly characterSize: Readonly<{
+        width: number;
+        height: number;
+    }>;
+}
+export declare function evaluateHorizontalPatrol(effect: Readonly<HorizontalPatrolMotionEffect>, world: Readonly<PatrolWorld>, direction: PatrolDirection): readonly [PatrolDirection, MotionRequest | undefined];
+export declare function evaluateViewportTraverse(effect: Readonly<ViewportTraverseMotionEffect>, world: Readonly<PatrolWorld>, phase?: number): readonly [number, MotionRequest | undefined];
+export declare function motionToward(effect: Readonly<{
+    speed?: number;
+}>, position: Readonly<{
+    x: number;
+    y: number;
+}>, x: number, y: number, arrivalRadius?: number, bounds?: Readonly<Partial<Pick<World, "viewport" | "characterSize">>>): MotionRequest | undefined;
+export {};
 //# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EAGjB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,IAAI,EAGT,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,YAAY,GAAG;IACnE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAgBA;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAsB3D;AAaD,gEAAgE;AAChE,qBAAa,WAAW;;IAatB,YAAY,IAAI,EAAE,YAAY,EAE7B;IAED,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,IAAI,eAAe,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE/D;IAED,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,kBAAkB,CAAC,CAEjE;IAED,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,eAAe,CAwIhD;IAED,KAAK,IAAI,IAAI,CAQZ;IAED,UAAU,IAAI,MAAM,GAAG,SAAS,CAU/B;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM1B;CAmFF"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EAGjB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,4BAA4B,EAEjC,KAAK,aAAa,EAClB,KAAK,IAAI,EAGT,KAAK,cAAc,EAInB,KAAK,4BAA4B,EACjC,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,YAAY,GAAG;IACnE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAgBA;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,OAAO,GAClB,IAAI,CA6CN;AAaD,gEAAgE;AAChE,qBAAa,WAAW;;IAmBtB,YAAY,IAAI,EAAE,YAAY,EAE7B;IAED,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,IAAI,eAAe,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE/D;IAED,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,kBAAkB,CAAC,CAEjE;IAED,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,eAAe,CAwMhD;IAED,KAAK,IAAI,IAAI,CAcZ;IAED,UAAU,IAAI,MAAM,GAAG,SAAS,CAU/B;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM1B;CAgKF;AAgBD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;AAEtC,UAAU,WAAW;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAC9C,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC5B,SAAS,EAAE,eAAe,GACzB,SAAS,CAAC,eAAe,EAAE,aAAa,GAAG,SAAS,CAAC,CAkBvD;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAC9C,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAoC9C;AA6DD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACpC,QAAQ,EAAE,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5C,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,aAAa,SAAI,EACjB,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,GACpE,aAAa,GAAG,SAAS,CAwB3B"}

package/dist/plan.js

@@ -19,6 +19,32 @@ export function compiledPlanSectionRequirements(plan) {
 }
 /** The engine-owned default Plan policy. It uses the public Plan shape. */
 export function createDefaultPlan(locomotion) {
+    return createPresetPlan("companion", locomotion);
+}
+/** Small named starting points that compile into the canonical Plan. */
+export function createPresetPlan(preset, locomotion) {
+    const state = locomotion
+        ? { capability: "locomotion" }
+        : { state: "idle" };
+    if (preset === "still") {
+        return {
+            baseline: {
+                channels: ["state"],
+                state: { state: "idle" },
+            },
+        };
+    }
+    if (preset === "bottom-patrol" || preset === "viewport-roam") {
+        return {
+            baseline: {
+                channels: ["motion", "state"],
+                state,
+                motion: preset === "bottom-patrol"
+                    ? { type: "horizontal-patrol", speed: DEFAULT_SPEED }
+                    : { type: "viewport-traverse", speed: DEFAULT_SPEED },
+            },
+        };
+    }
     return {
         baseline: {
             channels: ["state"],
@@ -47,6 +73,12 @@ export class PlanRuntime {
     #eventState = createPlanEventState();
     #activeChannels = new Map();
     #activeSurfaces = new Map();
+    #patrolDirections = new WeakMap();
+    #traversePhases = new WeakMap();
+    #jumpOwner;
+    #jumpState;
+    #pathOwner;
+    #pathState;
     #activeInterrupts = [];
     #surfaceVersion = 0;
     #lastEventStatus;
@@ -144,26 +176,78 @@ export class PlanRuntime {
         if (state?.kind === "capability") {
             output.capability = state.name;
         }
-        const motion = channels.get("motion")?.motion;
-        if (motion && world.pointer) {
-            const dx = world.pointer.x - world.position.x;
-            const dy = world.pointer.y - world.position.y;
-            const distance = Math.hypot(dx, dy);
-            const arrivalRadius = motion.arrivalRadius ?? 0;
-            if (distance > arrivalRadius) {
-                output.motion = {
-                    x: dx / distance,
-                    y: dy / distance,
-                    speed: motion.speed ?? DEFAULT_SPEED,
-                    maxDistance: distance - arrivalRadius,
-                };
-            }
-            else if (channels.get("motion") === channels.get("state")) {
-                delete output.capability;
-                const baseline = this.#baselineState();
-                if (!output.state && baseline)
-                    output.state = baseline;
-            }
+        const motionOwner = channels.get("motion");
+        const motion = motionOwner?.motion;
+        const settleCapability = () => {
+            if (output.capability !== "locomotion")
+                return;
+            delete output.capability;
+            const baseline = this.#baselineState();
+            if (!output.state && baseline)
+                output.state = baseline;
+        };
+        if (motion?.type !== "jump-to") {
+            this.#jumpOwner = undefined;
+            this.#jumpState = undefined;
+        }
+        if (motion?.type !== "svg-path") {
+            this.#pathOwner = undefined;
+            this.#pathState = undefined;
+        }
+        if (motion?.type === "horizontal-patrol" && world.characterSize) {
+            const [direction, request] = evaluateHorizontalPatrol(motion, world, this.#patrolDirections.get(motionOwner) ?? true);
+            this.#patrolDirections.set(motionOwner, direction);
+            if (request)
+                output.motion = request;
+        }
+        else if (motion?.type === "viewport-traverse" && world.characterSize) {
+            const [phase, request] = evaluateViewportTraverse(motion, world, this.#traversePhases.get(motionOwner));
+            this.#traversePhases.set(motionOwner, phase);
+            if (request)
+                output.motion = request;
+        }
+        else if (motion?.type === "follow-pointer") {
+            const request = world.pointer
+                ? motionToward(motion, world.position, world.pointer.x, world.pointer.y, motion.arrivalRadius, world)
+                : undefined;
+            if (request)
+                output.motion = request;
+            else
+                settleCapability();
+        }
+        else if (motion?.type === "move-to") {
+            const request = motionToward(motion, world.position, motion.x, motion.y, motion.arrivalRadius, world);
+            if (request)
+                output.motion = request;
+            else
+                settleCapability();
+        }
+        else if (motion?.type === "move-to-target") {
+            const target = world.targets?.[motion.target];
+            const point = target && world.characterSize
+                ? targetPoint(target, motion.anchor, world.characterSize)
+                : undefined;
+            const request = point
+                ? motionToward(motion, world.position, point.x, point.y, motion.arrivalRadius, world)
+                : undefined;
+            if (request)
+                output.motion = { ...request, trackTarget: true };
+            else
+                settleCapability();
+        }
+        else if (motion?.type === "jump-to") {
+            const request = this.#evaluateJump(motionOwner, motion, world);
+            if (request)
+                output.motion = request;
+            else
+                settleCapability();
+        }
+        else if (motion?.type === "svg-path") {
+            const request = this.#evaluatePath(motionOwner, motion, world);
+            if (request)
+                output.motion = request;
+            else
+                settleCapability();
         }
         const selected = new Map();
         for (const surface of this.#plan.baseline.surfaces) {
@@ -198,6 +282,12 @@ export class PlanRuntime {
         this.#activeChannels.clear();
         this.#activeSurfaces.clear();
         this.#activeInterrupts = [];
+        this.#patrolDirections = new WeakMap();
+        this.#traversePhases = new WeakMap();
+        this.#jumpOwner = undefined;
+        this.#jumpState = undefined;
+        this.#pathOwner = undefined;
+        this.#pathState = undefined;
         this.#eventState.ordering.clear();
         this.#eventState.sessions.clear();
         this.#lastEventStatus = undefined;
@@ -224,6 +314,67 @@ export class PlanRuntime {
         const state = this.#plan.baseline.state;
         return state?.kind === "state" ? state.name : undefined;
     }
+    #evaluateJump(owner, effect, world) {
+        if (this.#jumpOwner !== owner || !this.#jumpState) {
+            this.#jumpOwner = owner;
+            this.#jumpState = {
+                startedAt: world.now,
+                from: { ...world.position },
+            };
+        }
+        const duration = effect.duration ?? 800;
+        const progress = Math.max(0, Math.min(1, (world.now - this.#jumpState.startedAt) / duration));
+        const target = boundedPoint(effect, world);
+        const desired = {
+            x: this.#jumpState.from.x + (target.x - this.#jumpState.from.x) * progress,
+            y: this.#jumpState.from.y + (target.y - this.#jumpState.from.y) * progress,
+        };
+        const lift = progress === 0 || progress === 1
+            ? 0
+            : Math.sin(Math.PI * progress) *
+                (effect.height ?? world.characterSize?.height ?? 32);
+        const request = directMotion(world.position, desired, lift);
+        if (progress < 1 || request.maxDistance)
+            return request;
+        return;
+    }
+    #evaluatePath(owner, effect, world) {
+        const sample = world.samplePath;
+        if (!sample)
+            return;
+        const first = sample(effect.path, 0);
+        if (!first)
+            return;
+        if (this.#pathOwner !== owner || !this.#pathState) {
+            this.#pathOwner = owner;
+            this.#pathState = {
+                startedAt: world.now,
+                offset: effect.relative === false
+                    ? { x: 0, y: 0 }
+                    : {
+                        x: world.position.x - first.x,
+                        y: world.position.y - first.y,
+                    },
+            };
+        }
+        const duration = effect.duration ?? 4_000;
+        const elapsed = Math.max(0, world.now - this.#pathState.startedAt);
+        const complete = effect.loop !== true && elapsed >= duration;
+        const progress = effect.loop
+            ? (elapsed % duration) / duration
+            : Math.min(1, elapsed / duration);
+        const point = sample(effect.path, progress);
+        if (!point)
+            return;
+        const desired = {
+            x: point.x + this.#pathState.offset.x,
+            y: point.y + this.#pathState.offset.y,
+        };
+        const request = directMotion(world.position, boundedPoint(desired, world));
+        if (!complete || request.maxDistance)
+            return request;
+        return;
+    }
     #isContinuous(rule, world) {
         const condition = rule.when;
         if (condition.source !== "browser")
@@ -232,9 +383,9 @@ export class PlanRuntime {
             if (!world.pointer)
                 return false;
             const motion = rule.effect.motion;
-            if (!motion)
+            if (!motion || motion.type !== "follow-pointer")
                 return true;
-            return (Math.hypot(world.pointer.x - world.position.x, world.pointer.y - world.position.y) > (motion.arrivalRadius ?? 0));
+            return Boolean(motionToward(motion, world.position, world.pointer.x, world.pointer.y, motion.arrivalRadius, world));
         }
         if (condition.event !== "section.visibility")
             return false;
@@ -285,3 +436,111 @@ export class PlanRuntime {
 function completionSource(name) {
     return browserCompletionEvent(name) ? "browser" : "application";
 }
+export function evaluateHorizontalPatrol(effect, world, direction) {
+    const halfWidth = world.characterSize.width / 2;
+    const inset = effect.edgeInset ?? 0;
+    const left = Math.min(world.viewport.width / 2, halfWidth + inset);
+    const right = world.viewport.width - left;
+    const halfHeight = world.characterSize.height / 2;
+    const y = Math.max(halfHeight, world.viewport.height - halfHeight);
+    let request = motionToward(effect, world.position, direction ? right : left, y);
+    if (!request) {
+        direction = !direction;
+        request = motionToward(effect, world.position, direction ? right : left, y);
+    }
+    return [direction, request];
+}
+export function evaluateViewportTraverse(effect, world, phase) {
+    const inset = effect.edgeInset ?? 0;
+    const halfWidth = world.characterSize.width / 2;
+    const halfHeight = world.characterSize.height / 2;
+    const left = Math.min(world.viewport.width / 2, halfWidth + inset);
+    const right = Math.max(left, world.viewport.width - left);
+    const top = Math.min(world.viewport.height / 2, halfHeight + inset);
+    const bottom = Math.max(top, world.viewport.height - halfHeight - inset);
+    const points = [
+        { x: left, y: bottom },
+        { x: right, y: bottom },
+        { x: right, y: top },
+        { x: left, y: top },
+    ];
+    if (phase === undefined) {
+        phase = points.reduce((nearest, point, index) => Math.hypot(point.x - world.position.x, point.y - world.position.y) <
+            Math.hypot(points[nearest].x - world.position.x, points[nearest].y - world.position.y)
+            ? index
+            : nearest, 0);
+    }
+    let target = points[phase];
+    let request = motionToward(effect, world.position, target.x, target.y);
+    if (!request) {
+        const direction = effect.clockwise === false ? -1 : 1;
+        phase = (phase + direction + points.length) % points.length;
+        target = points[phase];
+        request = motionToward(effect, world.position, target.x, target.y);
+    }
+    return [phase, request];
+}
+function targetPoint(target, anchor = "center", character) {
+    const center = {
+        x: target.left + target.width / 2,
+        y: target.top + target.height / 2,
+    };
+    switch (anchor) {
+        case "top":
+            return { x: center.x, y: target.top - character.height / 2 };
+        case "right":
+            return { x: target.right + character.width / 2, y: center.y };
+        case "bottom":
+            return { x: center.x, y: target.bottom + character.height / 2 };
+        case "left":
+            return { x: target.left - character.width / 2, y: center.y };
+        default:
+            return center;
+    }
+}
+function boundedPoint(point, world) {
+    const size = world.characterSize;
+    if (!size)
+        return { x: point.x, y: point.y };
+    return {
+        x: Math.max(size.width / 2, Math.min(world.viewport.width - size.width / 2, point.x)),
+        y: Math.max(size.height / 2, Math.min(world.viewport.height - size.height / 2, point.y)),
+    };
+}
+function directMotion(position, target, lift = 0) {
+    const dx = target.x - position.x;
+    const dy = target.y - position.y;
+    const distance = Math.hypot(dx, dy);
+    return {
+        x: distance ? dx / distance : 0,
+        y: distance ? dy / distance : 0,
+        speed: 0,
+        maxDistance: distance,
+        lift,
+        direct: true,
+    };
+}
+export function motionToward(effect, position, x, y, arrivalRadius = 0, bounds) {
+    const size = bounds?.characterSize;
+    const viewport = bounds?.viewport;
+    if (size && viewport) {
+        const pointerX = x;
+        const pointerY = y;
+        x = Math.max(size.width / 2, Math.min(viewport.width - size.width / 2, x));
+        y = Math.max(size.height / 2, Math.min(viewport.height - size.height / 2, y));
+        if (x !== pointerX || y !== pointerY)
+            arrivalRadius = 0;
+    }
+    const dx = x - position.x;
+    const dy = y - position.y;
+    const distance = Math.hypot(dx, dy);
+    const maxDistance = distance - arrivalRadius;
+    if (maxDistance <= 4)
+        return;
+    return {
+        x: dx / distance,
+        y: dy / distance,
+        speed: effect.speed ?? DEFAULT_SPEED,
+        maxDistance,
+    };
+}

package/dist/registry.js

@@ -1,10 +1,10 @@
 import { runtimeMessage } from "./runtime-diagnostics.js";
 const PEEK_REFERENCE_URL = typeof __PEEK_PACK_URL__ === "string"
     ? __PEEK_PACK_URL__
-    : "https://cdn.jsdelivr.net/npm/@peekling/pack-peek@0.1.0/character.json";
+    : "https://cdn.jsdelivr.net/npm/@peekling/pack-peek@0.1.1/character.json";
 const PEEK_REFERENCE_SHA256 = typeof __PEEK_PACK_SHA256__ === "string"
     ? __PEEK_PACK_SHA256__
-    : "bc01840e84f72edca4b0421dca4d07623b38d971d851bfc647e1cada03e1cbcc";
+    : "9a2e2a41e85f7c4b8d3487a3655db40872675bd9c0780e139a946eabdf71d75f";
 const REGISTRY = {
     peek: Object.freeze({
         url: PEEK_REFERENCE_URL,

package/dist/renderer.d.ts

@@ -1,8 +1,24 @@
 import type { NormalizedPack, Point, StateDefinition } from "./types.js";
 import { type RuntimeStyleAsset } from "./styles.js";
+export interface CharacterRenderer {
+    readonly ready: Promise<void>;
+    swapAtlas(pack: NormalizedPack, atlasUrl: string): void | Promise<void>;
+    setHidden(hidden: boolean): void;
+    nextFrameIn(now: number): number | undefined;
+    render(stateName: string, now: number, position: Point, devicePixelRatio?: number, lift?: number): void;
+    destroy(): void;
+}
+export interface CharacterRendererOptions {
+    document: Document;
+    pack: NormalizedPack;
+    atlasUrl: string;
+    scale: number;
+    styles: RuntimeStyleAsset;
+}
+export type CharacterRendererFactory = (options: Readonly<CharacterRendererOptions>) => CharacterRenderer;
 export declare function frameAt(state: StateDefinition, elapsed: number): number;
 export declare function snapToDevicePixel(value: number, devicePixelRatio?: number): number;
-export declare class AtlasRenderer {
+export declare class AtlasRenderer implements CharacterRenderer {
     #private;
     readonly host: HTMLElement;
     readonly ready: Promise<void>;
@@ -13,4 +29,5 @@ export declare class AtlasRenderer {
     render(stateName: string, now: number, position: Point, devicePixelRatio?: number, lift?: number): void;
     destroy(): void;
 }
+export declare const createAtlasRenderer: CharacterRendererFactory;
 //# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,wBAAgB,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,SAAI,GAAG,MAAM,CAM7E;AAED,qBAAa,aAAa;;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAe9B,YACE,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EAoB1B;IAED,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtD;IAoBD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG/B;IAED,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB3C;IAED,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,KAAK,EACf,gBAAgB,SAAI,EACpB,IAAI,SAAI,GACP,IAAI,CAkDN;IAED,OAAO,IAAI,IAAI,CAKd;CAkBF"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,KAAK,EACf,gBAAgB,CAAC,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAAC;IACR,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,KACxC,iBAAiB,CAAC;AAEvB,wBAAgB,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,SAAI,GAAG,MAAM,CAM7E;AAED,qBAAa,aAAc,YAAW,iBAAiB;;IACrD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAe9B,YACE,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EAoB1B;IAED,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtD;IAoBD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG/B;IAED,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB3C;IAED,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,KAAK,EACf,gBAAgB,SAAI,EACpB,IAAI,SAAI,GACP,IAAI,CAkDN;IAED,OAAO,IAAI,IAAI,CAKd;CAkBF;AAED,eAAO,MAAM,mBAAmB,EAAE,wBAO/B,CAAC"}

package/dist/renderer.js

@@ -174,3 +174,4 @@ export class AtlasRenderer {
             this.host.setAttribute("aria-hidden", "true");
     }
 }
+export const createAtlasRenderer = (options) => new AtlasRenderer(options.document, options.pack, options.atlasUrl, options.scale, options.styles);

package/dist/runtime-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-validation.d.ts","sourceRoot":"","sources":["../src/runtime-validation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC,CA0B3C"}
+{"version":3,"file":"runtime-validation.d.ts","sourceRoot":"","sources":["../src/runtime-validation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EACL,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC,CA2B3C"}

package/dist/runtime-validation.js

@@ -16,6 +16,7 @@ export function validateRuntimeConfiguration(options, baseUrl) {
         try {
             compilePlan(options.plan, {
                 contentIds: new Set(Object.keys(content)),
+                targets: new Set(Object.keys(options.targets ?? {})),
             });
         }
         catch (cause) {
@@ -98,6 +99,40 @@ function configurationMessage(code, path, detail) {
             return `${detail ?? field} must be a function`;
         case "invalid-plan":
             return detail ?? "Plan is invalid";
+        case "incompatible-behavior":
+            return "Choose preset or plan, not both";
+        case "invalid-preset":
+            return "preset must be companion, still, bottom-patrol, or viewport-roam";
+        case "invalid-targets":
+            return "targets must be an object of target IDs and CSS selectors";
+        case "target-limit":
+            return "targets supports at most 16 entries";
+        case "invalid-target":
+            return "target IDs must be bounded lowercase IDs";
+        case "invalid-target-selector":
+            return "target selectors must be bounded CSS selector text";
+        case "invalid-interaction":
+            return "interaction contains an unsupported value";
+        case "invalid-interaction-event":
+            return "interaction events must be bounded application Event names";
+        case "missing-interaction-event":
+            return "pressEvent is required when press is emit";
+        case "incompatible-interaction-event":
+            return "pressEvent can be used only with the emit press action";
+        case "invalid-interaction-state":
+            return "interaction states must be valid Pack State names";
+        case "invalid-interaction-range":
+            return "interaction physics value is outside its supported range";
+        case "invalid-interaction-label":
+            return "interaction label must be short plain text";
+        case "invalid-catch-target":
+            return "catchTarget must reference a configured target";
+        case "invalid-catch-anchor":
+            return "catchAnchor is not supported";
+        case "invalid-indicator":
+            return "indicator must include a label and valid dot or count settings";
+        case "incompatible-indicator":
+            return "indicator requires character interaction";
         default:
             return detail ?? code;
     }