oneko 0.0.0-stage → 0.3.0

package/dist/types/lib/oneko/debug-controls/index.d.ts

@@ -0,0 +1,14 @@
+import type { CatRuntimeState } from "../types";
+export interface DebugControlsParams {
+    stateRef: {
+        current: CatRuntimeState;
+    };
+    el: HTMLDivElement;
+    bubbleEl: HTMLDivElement;
+    bubbleTextEl: HTMLDivElement;
+    frame: () => void;
+    showBubble: () => void;
+    hideBubble: () => void;
+    bubbleDisplayFrames: number;
+}
+export declare function createDebugControls({ stateRef, el, bubbleEl, bubbleTextEl, frame, showBubble, hideBubble, bubbleDisplayFrames, }: DebugControlsParams): HTMLDivElement;

package/dist/types/lib/oneko/debug-controls/playback.d.ts

@@ -0,0 +1,4 @@
+import type { CatRuntimeState } from "../types";
+export declare function appendPlaybackSection(body: HTMLElement, stateRef: {
+    current: CatRuntimeState;
+}, frame: () => void): void;

package/dist/types/lib/oneko/debug-controls/position.d.ts

@@ -0,0 +1,4 @@
+import type { CatRuntimeState } from "../types";
+export declare function appendPositionSection(body: HTMLElement, stateRef: {
+    current: CatRuntimeState;
+}, el: HTMLDivElement): void;

package/dist/types/lib/oneko/debug-controls/speed.d.ts

@@ -0,0 +1,4 @@
+import type { CatRuntimeState } from "../types";
+export declare function appendSpeedSection(body: HTMLElement, stateRef: {
+    current: CatRuntimeState;
+}): void;

package/dist/types/lib/oneko/debug-controls/ui.d.ts

@@ -0,0 +1,5 @@
+export declare const BASE_STYLE: string;
+export declare const selectStyle: string;
+export declare function sectionLabel(text: string): HTMLDivElement;
+export declare function makeRow(...children: HTMLElement[]): HTMLDivElement;
+export declare function makeBtn(label: string, onClick: () => void): HTMLButtonElement;

package/dist/types/lib/oneko/defaults.d.ts

@@ -0,0 +1,39 @@
+import type { OnekoProps } from "./types";
+export declare const ONEKO_DEFAULTS: {
+    paused: boolean;
+    followCursor: boolean;
+    sleepEnabled: boolean;
+    bubblePlacement: NonNullable<OnekoProps["bubblePlacement"]>;
+    bubbleScale: number;
+    soundBasePath: string;
+    storageKey: string;
+    zoneAttractionChance: number;
+    zoneAttractionDuration: number;
+    skin: NonNullable<OnekoProps["skin"]>;
+    persistPosition: boolean;
+    reducedMotion: NonNullable<OnekoProps["reducedMotion"]>;
+    zIndex: number;
+    speed: number;
+    scale: number;
+    opacity: number;
+    rotationAmount: number;
+    idleThreshold: number;
+    meow: boolean;
+    freerunChance: number;
+    freerunDuration: number;
+    bubbleEnabled: boolean;
+    bubbleDisplayFrames: number;
+    bubbleCooldown: number;
+    hueRotate: number;
+    bubbleChance: number;
+    followDistance: number;
+    animationSpeed: number;
+    bubbleText: string;
+    volume: number;
+    laserPointer: boolean;
+    chase: NonNullable<OnekoProps["chase"]>;
+    napWhileTyping: boolean;
+    followFocus: boolean;
+    perchOnHover: boolean;
+    pettable: boolean;
+};

package/dist/types/lib/oneko/dom.d.ts

@@ -0,0 +1,10 @@
+import type { CatRuntimeState } from "./types";
+export interface BubbleElements {
+    wrapper: HTMLDivElement;
+    textEl: HTMLDivElement;
+    tailWrap: HTMLDivElement;
+}
+export declare function createCatElement(state: CatRuntimeState, zIndex: number): HTMLDivElement;
+export declare function createDebugSVG(zIndex: number): SVGSVGElement;
+export declare function createBubble(zIndex: number): BubbleElements;
+export declare function createDebugHUD(): HTMLDivElement;

package/dist/types/lib/oneko/initial-state.d.ts

@@ -0,0 +1,9 @@
+import { type CatRuntimeConfig } from "./runtime-config";
+import type { CatRuntimeState } from "./types";
+export type InitialCatStateOptions = CatRuntimeConfig & {
+    initialPos?: {
+        x: number;
+        y: number;
+    };
+};
+export declare function createInitialCatState(options: InitialCatStateOptions): CatRuntimeState;

package/dist/types/lib/oneko/konami.d.ts

@@ -0,0 +1,4 @@
+import type { CatRuntimeState } from "./types";
+export declare function createKonamiHandler(stateRef: {
+    current: CatRuntimeState;
+}, debugSVG: SVGSVGElement, debugWrapper: HTMLDivElement): (e: KeyboardEvent) => void;

package/dist/types/lib/oneko/laser-cursor-dom.d.ts

@@ -0,0 +1 @@
+export declare function mountLaserCursor(zIndex: number): () => void;

package/dist/types/lib/oneko/obstacle-filters.d.ts

@@ -0,0 +1,12 @@
+import type { ObstacleRect } from "./types";
+type RectLike = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};
+export declare function shouldIncludeObstacleRect(rect: RectLike, viewportWidth: number, viewportHeight: number): boolean;
+export declare function toObstacleRect(rect: RectLike): ObstacleRect;
+export {};

package/dist/types/lib/oneko/pack.d.ts

@@ -0,0 +1,12 @@
+import type { CatRuntimeState, PathPoint } from "./types";
+export declare function joinPack(state: CatRuntimeState): () => void;
+/** Where the cat ahead of this one is, or null when it leads (or chases the cursor). */
+export declare function leaderPosition(state: CatRuntimeState): PathPoint | null;
+/** True when another cat is asleep close enough to curl up next to. */
+export declare function napmateNearby(state: CatRuntimeState): boolean;
+/** Visitor preference, shared by every cat on the site and remembered across visits. */
+export declare const HIDDEN_STORAGE_KEY = "oneko:hidden";
+export declare function areCatsHidden(): boolean;
+export declare function setCatsHidden(hidden: boolean): void;
+/** Calls back when cats are hidden or shown, in this tab or another one. */
+export declare function onCatsHiddenChange(callback: () => void): () => void;

package/dist/types/lib/oneko/pathfinding.d.ts

@@ -0,0 +1,6 @@
+import type { ObstacleRect, PathPoint } from "./types";
+export declare function collectObstacles(): ObstacleRect[];
+export declare function buildGrid(rects: ObstacleRect[], cols: number, rows: number): Uint8Array;
+export declare function worldToCell(worldX: number, worldY: number, cols: number, rows: number): number;
+export declare function nearestWalkable(startIdx: number, grid: Uint8Array, cols: number, rows: number): number;
+export declare function findRoute(startIdx: number, goalIdx: number, grid: Uint8Array, cols: number, rows: number): PathPoint[];

package/dist/types/lib/oneko/persistence.d.ts

@@ -0,0 +1,18 @@
+import type { CatRuntimeState } from "./types";
+export type PersistedPosition = {
+    version: 1;
+    x: number;
+    y: number;
+};
+export declare function parsePersistedPosition(value: unknown): PersistedPosition | null;
+/** Saved position clamped to the viewport, or null when absent or invalid. */
+export declare function readPersistedPosition(storageKey?: string): {
+    x: number;
+    y: number;
+} | null;
+export declare function loadPersistedCatState(stateRef: {
+    current: CatRuntimeState;
+}, el: HTMLDivElement, storageKey?: string): void;
+export declare function createPersistHandler(stateRef: {
+    current: CatRuntimeState;
+}, storageKey?: string): () => void;

package/dist/types/lib/oneko/runtime-config.d.ts

@@ -0,0 +1,28 @@
+import type { OnekoZone } from "./zones";
+import type { CatRuntimeState, OnekoProps } from "./types";
+type RuntimeConfigStateFields = Pick<CatRuntimeState, "pausedCfg" | "followCursorCfg" | "sleepEnabledCfg" | "bubblePlacementCfg" | "bubbleScaleCfg" | "soundBasePathCfg" | "currentSpeed" | "scale" | "opacity" | "rotationAmount" | "idleThresholdMs" | "freerunChanceCfg" | "freerunDurationCfg" | "bubbleEnabledCfg" | "bubbleDisplayFramesCfg" | "bubbleCooldownFramesCfg" | "bubbleChanceCfg" | "followDistanceCfg" | "animationSpeedCfg" | "customBubbleText" | "currentRotation" | "enableMeow" | "soundVolumeCfg" | "soundCooldown" | "bubbleTimer" | "bubbleCooldown" | "bubbleVisible" | "lastBubbleMsg" | "laserPointerCfg" | "laserCaught" | "chaseCfg" | "napWhileTypingCfg" | "followFocusCfg" | "perchOnHoverCfg">;
+export declare function defaultRuntimeConfigState(): RuntimeConfigStateFields;
+export type CatRuntimeConfig = Pick<OnekoProps, "paused" | "followCursor" | "sleepEnabled" | "bubblePlacement" | "bubbleScale" | "soundBasePath" | "chase" | "napWhileTyping" | "followFocus" | "perchOnHover"> & {
+    zones?: readonly OnekoZone[];
+    zoneAttractionChance?: number;
+    zoneAttractionDuration?: number;
+    speed: number;
+    scale: number;
+    opacity: number;
+    rotationAmount: number;
+    idleThreshold: number;
+    freerunChance: number;
+    freerunDuration: number;
+    bubbleEnabled: boolean;
+    bubbleDisplayFrames: number;
+    bubbleCooldown: number;
+    bubbleChance: number;
+    followDistance: number;
+    animationSpeed: number;
+    bubbleText: NonNullable<OnekoProps["bubbleText"]>;
+    meow: boolean;
+    volume: number;
+    laserPointer: boolean;
+};
+export declare function applyRuntimeConfig(state: CatRuntimeState, config: CatRuntimeConfig): void;
+export {};

package/dist/types/lib/oneko/skin-catalog.d.ts

@@ -0,0 +1,98 @@
+/** Labels stay independent of the bundled sheets so registry variants share one implementation. */
+export declare const SKIN_CATALOG: readonly [{
+    readonly id: "classic";
+    readonly name: "Classic";
+    readonly description: "The little cat that started it all";
+}, {
+    readonly id: "black";
+    readonly name: "Black";
+    readonly description: "A tiny midnight shadow";
+}, {
+    readonly id: "gray";
+    readonly name: "Gray";
+    readonly description: "Soft fur, softer footsteps";
+}, {
+    readonly id: "calico";
+    readonly name: "Calico";
+    readonly description: "A patchwork of mischief";
+}, {
+    readonly id: "tora";
+    readonly name: "Tora";
+    readonly description: "A little tiger at heart";
+}, {
+    readonly id: "catppuccin";
+    readonly name: "Catppuccin";
+    readonly description: "A warm cup of cat";
+}, {
+    readonly id: "ghost";
+    readonly name: "Ghost";
+    readonly description: "A pleasantly spooky companion";
+}, {
+    readonly id: "silver";
+    readonly name: "Silver";
+    readonly description: "Moonlight on little paws";
+}, {
+    readonly id: "spirit";
+    readonly name: "Spirit";
+    readonly description: "A curious little daydream";
+}, {
+    readonly id: "valentine";
+    readonly name: "Valentine";
+    readonly description: "Wears a heart on every paw";
+}, {
+    readonly id: "maia";
+    readonly name: "Maia";
+    readonly description: "Small paws, big personality";
+}, {
+    readonly id: "vaporwave";
+    readonly name: "Vaporwave";
+    readonly description: "Dreaming in pink and purple";
+}, {
+    readonly id: "ginger";
+    readonly name: "Ginger";
+    readonly description: "Golden fur and cream-colored paws";
+}, {
+    readonly id: "sage";
+    readonly name: "Sage";
+    readonly description: "A little garden companion";
+}, {
+    readonly id: "siamese";
+    readonly name: "Siamese";
+    readonly description: "Chocolate points and bright blue eyes";
+}, {
+    readonly id: "strawberry-milk";
+    readonly name: "Strawberry Milk";
+    readonly description: "Soft pink with a splash of cream";
+}, {
+    readonly id: "blue-frost";
+    readonly name: "Blue Frost";
+    readonly description: "Snowy paws and an icy blue coat";
+}, {
+    readonly id: "lavender";
+    readonly name: "Lavender";
+    readonly description: "Lilac fur and a little daydream";
+}, {
+    readonly id: "tuxedo";
+    readonly name: "Tuxedo";
+    readonly description: "Dressed up in a white bib and socks";
+}, {
+    readonly id: "peach";
+    readonly name: "Peach";
+    readonly description: "Apricot fur with a touch of vanilla";
+}, {
+    readonly id: "honey";
+    readonly name: "Honey";
+    readonly description: "Golden fur and a sunny disposition";
+}, {
+    readonly id: "mocha";
+    readonly name: "Mocha";
+    readonly description: "Cocoa fur with a splash of milk";
+}, {
+    readonly id: "mint";
+    readonly name: "Mint";
+    readonly description: "Fresh turquoise and snowy little paws";
+}, {
+    readonly id: "midnight-blue";
+    readonly name: "Midnight Blue";
+    readonly description: "Navy fur with a silver lining";
+}];

package/dist/types/lib/oneko/skin-classic.json.d.ts

@@ -0,0 +1,4 @@
+declare const sheets: {
+  "classic": string;
+};
+export = sheets;

package/dist/types/lib/oneko/skin-sheets.json.d.ts

@@ -0,0 +1,27 @@
+declare const sheets: {
+  "classic": string;
+  "black": string;
+  "gray": string;
+  "calico": string;
+  "tora": string;
+  "catppuccin": string;
+  "ghost": string;
+  "silver": string;
+  "spirit": string;
+  "valentine": string;
+  "maia": string;
+  "vaporwave": string;
+  "ginger": string;
+  "sage": string;
+  "siamese": string;
+  "strawberry-milk": string;
+  "blue-frost": string;
+  "lavender": string;
+  "tuxedo": string;
+  "peach": string;
+  "honey": string;
+  "mocha": string;
+  "mint": string;
+  "midnight-blue": string;
+};
+export = sheets;

package/dist/types/lib/oneko/skins.d.ts

@@ -0,0 +1,14 @@
+import { SKIN_CATALOG } from "./skin-catalog";
+/** Type-only: the sheets themselves load on demand in `loadSkinSource`. */
+export type OnekoSkin = keyof typeof import("./skin-sheets.json");
+type AvailableSkin = Extract<(typeof SKIN_CATALOG)[number], {
+    id: OnekoSkin;
+}>;
+/** Only expose coats included in this installation. See docs/oneko-skins.md for credits. */
+export declare const ONEKO_SKINS: AvailableSkin[];
+export declare function isOnekoSkin(value: unknown): value is OnekoSkin;
+/** Sprite sheet for a skin if it is ready, otherwise undefined. Unknown IDs use classic. */
+export declare function getSkinSource(skin?: OnekoSkin): string | undefined;
+/** Resolve a skin's sprite sheet, loading the bundled sheets once when needed. */
+export declare function loadSkinSource(skin?: OnekoSkin): Promise<string>;
+export {};

package/dist/types/lib/oneko/start-cat-animation.d.ts

@@ -0,0 +1,24 @@
+import type { CatActivityState, CatLiveState, CatRuntimeState } from "./types";
+export interface StartCatAnimationOptions {
+    stateRef: {
+        current: CatRuntimeState;
+    };
+    elRef: {
+        current: HTMLDivElement | null;
+    };
+    lastStateRef: {
+        current: CatActivityState;
+    };
+    onStateChangeRef: {
+        current: ((state: CatActivityState) => void) | undefined;
+    };
+    liveStateRef?: {
+        current: CatLiveState;
+    };
+    persistPosition: boolean;
+    storageKey?: string;
+    zIndex: number;
+    /** Make the cat a keyboard-reachable "Pet the cat" button. */
+    pettable?: boolean;
+}
+export declare function startCatAnimation({ stateRef, elRef, lastStateRef, onStateChangeRef, liveStateRef, persistPosition, storageKey, zIndex, pettable, }: StartCatAnimationOptions): () => void;

package/dist/types/lib/oneko/teardown.d.ts

@@ -0,0 +1,17 @@
+type CatAnimationElements = {
+    el: HTMLDivElement;
+    debugSVG: SVGSVGElement;
+    debugWrapper: HTMLDivElement;
+    bubbleEl: HTMLDivElement;
+};
+type CatAnimationListeners = {
+    onMouseMove: (ev: MouseEvent) => void;
+    onPointerDown: (event: PointerEvent) => void;
+    onKeyDown: (e: KeyboardEvent) => void;
+    invalidateObstacles: () => void;
+    persist: (() => void) | null;
+    onVisibilityChange: () => void;
+    stopAnimationLoop: () => void;
+};
+export declare function teardownCatAnimation({ el, debugSVG, debugWrapper, bubbleEl }: CatAnimationElements, { onMouseMove, onPointerDown, onKeyDown, invalidateObstacles, persist, onVisibilityChange, stopAnimationLoop, }: CatAnimationListeners): void;
+export {};

package/dist/types/lib/oneko/types.d.ts

@@ -0,0 +1,183 @@
+import type { OnekoZone } from "./zones";
+import type { ZoneRuntimeState } from "./zone-runtime";
+import type { OnekoSkin } from "./skins";
+export type CatActivityState = "idle" | "moving" | "sleeping" | "scratchSelf" | "tired" | "alert" | "scratchWallN" | "scratchWallS" | "scratchWallE" | "scratchWallW" | "freerun";
+export type IdleActivityState = Exclude<CatActivityState, "idle" | "moving" | "freerun">;
+export interface CatLiveState {
+    state: CatActivityState;
+    posX: number;
+    posY: number;
+    velMag: number;
+    idleTime: number;
+    distToMouse: number;
+    frameCount: number;
+    freerunActive: boolean;
+    freerunTimer: number;
+    bubbleVisible: boolean;
+    pathLength: number;
+    obstacleCount: number;
+}
+export interface OnekoProps {
+    /** Freeze animation in place without unmounting. Default false. */
+    paused?: boolean;
+    /** Chase the pointer and visit favorite spots. False keeps the cat resting in place. Default true. */
+    followCursor?: boolean;
+    /** Allow the cat to nap while idle. Default true. */
+    sleepEnabled?: boolean;
+    /** Preferred bubble side; auto chooses the side with room. Default auto. */
+    bubblePlacement?: "auto" | "above" | "below";
+    /** Bubble size multiplier, in addition to scale (0.5–2). Default 1. */
+    bubbleScale?: number;
+    /** Directory URL for the optional .ogg sounds. Default /cat-sounds. */
+    soundBasePath?: string;
+    /** localStorage key for position persistence. Default oneko. */
+    storageKey?: string;
+    /** Strict keep-out areas and occasional favorite spots. DOM data-oneko-zone attributes also work. */
+    zones?: readonly OnekoZone[];
+    /** Chance to visit a favorite at each five-second check (0–1). Default 0.3. */
+    zoneAttractionChance?: number;
+    /** Time spent pursuing a favorite, in milliseconds. Default 4000. */
+    zoneAttractionDuration?: number;
+    /** Built-in pixel-art skin. Default classic. */
+    skin?: OnekoSkin;
+    /** Custom 256×128 sprite-sheet URL using the classic 8×4 layout. Overrides skin. */
+    spriteSrc?: string;
+    persistPosition?: boolean;
+    zIndex?: number;
+    initialPos?: {
+        x: number;
+        y: number;
+    };
+    speed?: number;
+    scale?: number;
+    opacity?: number;
+    rotationAmount?: number;
+    idleThreshold?: number;
+    /** Enable optional sound assets supplied by the host app. Default false. */
+    meow?: boolean;
+    onStateChange?: (state: CatActivityState) => void;
+    /** Probability per frame cat enters freerun mode (0–1). Default 0.06 */
+    freerunChance?: number;
+    /** Duration of freerun in frames. Default 40 */
+    freerunDuration?: number;
+    /** Whether chat bubbles are enabled. Default true */
+    bubbleEnabled?: boolean;
+    /** How many frames a bubble stays visible. Default 180 */
+    bubbleDisplayFrames?: number;
+    /** Cooldown frames between bubbles. Default 120 */
+    bubbleCooldown?: number;
+    /** CSS hue-rotate degrees (0–360). Default 0 */
+    hueRotate?: number;
+    /** Mutable ref that oneko writes live state to every frame */
+    liveStateRef?: {
+        current: CatLiveState;
+    };
+    /** Bubble trigger probability while idle (0–1). Default 0.5 */
+    bubbleChance?: number;
+    /** Distance in px at which cat stops chasing cursor. Default 20 */
+    followDistance?: number;
+    /** Multiplier for idle animation speed (0.5–2). Default 1 */
+    animationSpeed?: number;
+    /** Custom awake bubble text, or a pool of thoughts picked without immediate repeats. */
+    bubbleText?: string | readonly string[];
+    /** Sound volume (0–1). Default 0.5 */
+    volume?: number;
+    /** Show a red laser dot in place of the system cursor. Default false */
+    laserPointer?: boolean;
+    /** With reduced motion: "hide" the cat, or let it "rest" as a still, sleeping sprite. Default "hide" */
+    reducedMotion?: "hide" | "rest";
+    /** What to chase: the cursor, or the cat mounted just before this one. Default "cursor" */
+    chase?: "cursor" | "cat";
+    /** Doze off while the visitor types in a field; wake on the next pointer move. Default false */
+    napWhileTyping?: boolean;
+    /** Walk over to whatever receives keyboard focus. Default false */
+    followFocus?: boolean;
+    /** Sit on a link or button after the pointer rests on it. Default false */
+    perchOnHover?: boolean;
+    /** Make the cat a keyboard-reachable "Pet the cat" button. Default false */
+    pettable?: boolean;
+}
+export interface ObstacleRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface PathPoint {
+    x: number;
+    y: number;
+}
+export interface CatRuntimeState {
+    zoneState: ZoneRuntimeState;
+    nekoPosX: number;
+    nekoPosY: number;
+    nekoVelX: number;
+    nekoVelY: number;
+    mousePosX: number;
+    mousePosY: number;
+    frameCount: number;
+    idleTime: number;
+    idleAnimation: IdleActivityState | null;
+    idleAnimationFrame: number;
+    obstacleRects: ObstacleRect[];
+    lastObstacleRefresh: number;
+    grid: Uint8Array | null;
+    gridCols: number;
+    gridRows: number;
+    currentPath: PathPoint[];
+    pathWaypointIdx: number;
+    lastPathRecalcFrame: number;
+    lastPathTargetCol: number;
+    lastPathTargetRow: number;
+    debugMode: boolean;
+    paused: boolean;
+    pausedCfg: boolean;
+    followCursorCfg: boolean;
+    sleepEnabledCfg: boolean;
+    bubblePlacementCfg: NonNullable<OnekoProps["bubblePlacement"]>;
+    bubbleScaleCfg: number;
+    soundBasePathCfg: string;
+    stateLocked: boolean;
+    noFollow: boolean;
+    currentSpeed: number;
+    scale: number;
+    opacity: number;
+    rotationAmount: number;
+    idleThresholdMs: number;
+    freerunChanceCfg: number;
+    freerunDurationCfg: number;
+    bubbleEnabledCfg: boolean;
+    bubbleDisplayFramesCfg: number;
+    bubbleCooldownFramesCfg: number;
+    bubbleChanceCfg: number;
+    followDistanceCfg: number;
+    animationSpeedCfg: number;
+    customBubbleText: string | readonly string[];
+    currentRotation: number;
+    enableMeow: boolean;
+    soundVolumeCfg: number;
+    soundCooldown: number;
+    bubbleTimer: number;
+    bubbleCooldown: number;
+    bubbleVisible: boolean;
+    lastBubbleMsg: number;
+    loopPrevAngle: number | null;
+    mouseCircleWinding: number;
+    freerunMode: boolean;
+    freerunTimer: number;
+    lastFreerunMsg: number;
+    laserPointerCfg: boolean;
+    laserCaught: boolean;
+    chaseCfg: NonNullable<OnekoProps["chase"]>;
+    napWhileTypingCfg: boolean;
+    followFocusCfg: boolean;
+    perchOnHoverCfg: boolean;
+    /** Dozing because the visitor is typing; cleared by pointer movement. */
+    typingNap: boolean;
+    /** Holding still while keyboard focus is on the cat. */
+    held: boolean;
+    /** Top of the hovered element the cat walks to and sits on. */
+    perchTarget: PathPoint | null;
+    /** Position of the cat this one chases, when chase is "cat" and one exists. */
+    leaderTarget: PathPoint | null;
+}

package/dist/types/lib/oneko/vanilla.d.ts

@@ -0,0 +1,13 @@
+import type { OnekoProps } from "./types";
+export type OnekoOptions = Omit<OnekoProps, "liveStateRef">;
+export interface OnekoInstance {
+    /** Merge new options into the running cat; undefined resets one. Engine-level options restart it in place. */
+    update(options: OnekoOptions): void;
+    /** Remove the cat, bubble, laser, and listeners. Saves the position when persistence is on. */
+    destroy(): void;
+}
+/**
+ * Mount a cat on document.body. `base` overrides the built-in defaults, so options passed as
+ * undefined (now or in a later update) return to the base value.
+ */
+export declare function createOneko(initial?: OnekoOptions, base?: OnekoOptions): OnekoInstance;

package/dist/types/lib/oneko/zone-runtime.d.ts

@@ -0,0 +1,20 @@
+import { type OnekoZone, type ResolvedZone } from "./zones";
+import type { CatRuntimeState, ObstacleRect, PathPoint } from "./types";
+import type { CatAnimationDeps } from "./animation/deps";
+export declare const EMPTY_ZONES: readonly OnekoZone[];
+export type ZoneRuntimeState = {
+    definitions: readonly OnekoZone[];
+    blocked: ObstacleRect[];
+    favorites: ResolvedZone[];
+    signature: string;
+    targetId: string | null;
+    visitFrames: number;
+    cooldownFrames: number;
+    chance: number;
+    duration: number;
+    movementTarget: PathPoint;
+};
+export declare function createZoneState(): ZoneRuntimeState;
+export declare function refreshZones(deps: CatAnimationDeps): boolean;
+/** Favorites are sampled every five seconds, with a quiet gap after each visit. */
+export declare function updateZoneTarget(s: CatRuntimeState, width: number, height: number, random?: () => number): void;

package/dist/types/lib/oneko/zones.d.ts

@@ -0,0 +1,26 @@
+import type { ObstacleRect, PathPoint } from "./types";
+export type OnekoZone = {
+    id: string;
+    type: "avoid" | "attract";
+    /** CSS selector. All matching visible elements become zones. */
+    selector?: string;
+    /** Fixed viewport coordinates in CSS pixels; selector takes precedence. */
+    rect?: ObstacleRect;
+    /** Extra space outside a keep-out zone, in pixels. */
+    padding?: number;
+};
+export type ResolvedZone = {
+    id: string;
+    type: OnekoZone["type"];
+    rect: ObstacleRect;
+};
+export declare function isValidRect(rect: ObstacleRect): boolean;
+export declare function expandRect(rect: ObstacleRect, padding: number): ObstacleRect;
+export declare function containsPoint(rect: ObstacleRect, point: PathPoint): boolean;
+/** Conservative radius also protects the corners when a scaled cat tilts. */
+export declare function catZoneRadius(scale: number): number;
+export declare function collectZones(zones: readonly OnekoZone[]): ResolvedZone[];
+/** Find a safe center even when zones overlap or appear around a resting cat. */
+export declare function nearestSafePoint(point: PathPoint, blocked: ObstacleRect[], width: number, height: number, margin: number): PathPoint | null;
+/** Swept collision: a fast cat cannot jump over a thin forbidden zone between ticks. */
+export declare function constrainZoneMovement(from: PathPoint, to: PathPoint, blocked: ObstacleRect[]): PathPoint;

package/dist/types/packages/oneko/src/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { OnekoInstance, OnekoOptions } from "./vanilla";
+/** Removed props return to engine defaults, just like a prop explicitly set to undefined. */
+export declare function createPropsUpdater(cat: OnekoInstance): (next: OnekoOptions) => void;

package/dist/types/packages/oneko/src/index.d.ts

@@ -0,0 +1,3 @@
+export { default, default as Oneko, useCatsHidden } from "../../../components/oneko";
+export type { OnekoProps, CatLiveState } from "../../../lib/oneko/types";
+export * from "./vanilla";

package/dist/types/packages/oneko/src/solid.d.ts

@@ -0,0 +1,3 @@
+import { type OnekoOptions } from "./vanilla";
+export default function Oneko(props: OnekoOptions): null;
+export type { OnekoOptions } from "./vanilla";

package/dist/types/packages/oneko/src/vanilla.d.ts

@@ -0,0 +1,7 @@
+export { createOneko } from "../../../lib/oneko/vanilla";
+export type { OnekoInstance, OnekoOptions } from "../../../lib/oneko/vanilla";
+export { areCatsHidden, setCatsHidden, onCatsHiddenChange } from "../../../lib/oneko/pack";
+export { ONEKO_SKINS, isOnekoSkin } from "../../../lib/oneko/skins";
+export type { OnekoSkin } from "../../../lib/oneko/skins";
+export type { CatActivityState } from "../../../lib/oneko/types";
+export type { OnekoZone } from "../../../lib/oneko/zones";