@caperjs/plugin-crunch 0.1.0

package/lib/types.d.ts

@@ -0,0 +1,246 @@
+import { PointLike, SizeLike } from '@caperjs/core';
+import { Container } from 'pixi.js';
+import { Actor } from './Actor';
+import { Entity } from './Entity';
+import { Group } from './Group';
+import { Sensor } from './Sensor';
+import { Solid } from './Solid';
+export interface Vector2 {
+    x: number;
+    y: number;
+}
+export interface Rectangle {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type CollisionShape = 'rectangle';
+export type EntityData = {
+    [key: string]: any;
+};
+export type PhysicsEntityClass = new (config?: PhysicsEntityConfig) => Actor | Solid | Sensor;
+/**
+ * Collision layers using bitwise flags
+ * Each entity can belong to multiple layers (using bitwise OR)
+ * and can collide with multiple layers (using bitwise AND)
+ */
+export declare enum CollisionLayer {
+    NONE = 0,
+    DEFAULT = 1,
+    PLAYER = 2,
+    ENEMY = 4,
+    PROJECTILE = 8,
+    PLATFORM = 16,
+    TRIGGER = 32,
+    ITEM = 64,
+    WALL = 128,
+    FX = 256,
+    ALL = 4294967295
+}
+/**
+ * Interface for a registered collision layer
+ */
+export interface RegisteredCollisionLayer {
+    /** Name of the collision layer */
+    name: string;
+    /** Numeric value of the collision layer (bitwise) */
+    value: number;
+    /** Description of the collision layer (optional) */
+    description?: string;
+}
+/**
+ * Registry for tracking custom collision layers
+ */
+export declare class CollisionLayerRegistry {
+    private static _instance;
+    private _layers;
+    private _usedIndices;
+    /**
+     * Get the singleton instance of the registry
+     */
+    static get instance(): CollisionLayerRegistry;
+    /**
+     * Register a new collision layer
+     *
+     * @param name Name of the collision layer
+     * @param index Index from 0-15 representing which user bit to use (gets shifted to bits 16-31)
+     * @param description Optional description of the layer
+     * @returns The registered collision layer
+     */
+    register(name: string, index: number, description?: string): RegisteredCollisionLayer;
+    /**
+     * Get a registered collision layer by name
+     *
+     * @param name Name of the collision layer
+     * @returns The registered collision layer or undefined if not found
+     */
+    get(name: string): RegisteredCollisionLayer | undefined;
+    /**
+     * Get all registered collision layers
+     *
+     * @returns Array of all registered collision layers
+     */
+    getAll(): RegisteredCollisionLayer[];
+    /**
+     * Check if a collision layer with the given name exists
+     *
+     * @param name Name of the collision layer
+     * @returns True if the layer exists
+     */
+    has(name: string): boolean;
+    /**
+     * Remove a registered collision layer
+     *
+     * @param name Name of the collision layer to remove
+     * @returns True if the layer was removed, false if it didn't exist
+     */
+    remove(name: string): boolean;
+    /**
+     * Clear all registered collision layers
+     */
+    clear(): void;
+    /**
+     * Get the next available index for a custom collision layer
+     *
+     * @returns The next available index or -1 if all indices are used
+     */
+    getNextAvailableIndex(): number;
+}
+/**
+ * Utility functions for working with collision layers
+ */
+export declare const CollisionLayers: {
+    /**
+     * Creates a custom collision layer using bits 16-31 (user space)
+     *
+     * @param index Index from 0-15 representing which user bit to use (gets shifted to bits 16-31)
+     * @returns A unique collision layer value
+     *
+     * @example
+     * ```typescript
+     * // Create custom collision layers
+     * const WATER_LAYER = CollisionLayers.createLayer(0);  // 1 << 16
+     * const LAVA_LAYER = CollisionLayers.createLayer(1);   // 1 << 17
+     * const CLOUD_LAYER = CollisionLayers.createLayer(2);  // 1 << 18
+     *
+     * // Use in entity creation
+     * const waterEntity = physics.createActor({
+     *   type: 'Water',
+     *   position: [100, 400],
+     *   size: [800, 100],
+     *   collisionLayer: WATER_LAYER,
+     *   collisionMask: CollisionLayer.PLAYER | CollisionLayer.ENEMY
+     * });
+     * ```
+     */
+    createLayer(index: number): number;
+    /**
+     * Creates a collision mask from multiple layers
+     *
+     * @param layers Array of collision layers to combine
+     * @returns A combined collision mask
+     *
+     * @example
+     * ```typescript
+     * // Create a mask that collides with players, enemies and projectiles
+     * const mask = CollisionLayers.createMask([
+     *   CollisionLayer.PLAYER,
+     *   CollisionLayer.ENEMY,
+     *   CollisionLayer.PROJECTILE
+     * ]);
+     * ```
+     */
+    createMask(layers: number[]): number;
+    /**
+     * Checks if a layer is included in a mask
+     *
+     * @param layer The layer to check
+     * @param mask The mask to check against
+     * @returns True if the layer is included in the mask
+     *
+     * @example
+     * ```typescript
+     * // Check if player layer is in the mask
+     * if (CollisionLayers.isLayerInMask(CollisionLayer.PLAYER, entity.collisionMask)) {
+     *   console.log('Entity can collide with players');
+     * }
+     * ```
+     */
+    isLayerInMask(layer: number, mask: number): boolean;
+    /**
+     * Get the registry for custom collision layers
+     *
+     * @returns The collision layer registry
+     */
+    getRegistry(): CollisionLayerRegistry;
+};
+export interface PhysicsEntityConfig<D extends EntityData = EntityData> {
+    id?: string;
+    class?: PhysicsEntityClass;
+    type?: PhysicsEntityType;
+    position?: PointLike;
+    size?: SizeLike;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    restitution?: number;
+    view?: PhysicsEntityView;
+    data?: Partial<D>;
+    group?: Group;
+    groupOffset?: PointLike;
+    follows?: Entity;
+    followOffset?: PointLike;
+    /** Collision layer this entity belongs to (bitwise) */
+    collisionLayer?: number;
+    /** Collision mask defining which layers this entity collides with (bitwise) */
+    collisionMask?: number;
+    /** Whether to disable actor-to-actor collisions for this entity */
+    disableActorCollisions?: boolean;
+}
+export interface CollisionResult {
+    collided: boolean;
+    normal?: Vector2;
+    penetration?: number;
+    solid: Solid;
+}
+export interface SensorOverlap {
+    type: `${PhysicsEntityType}|${PhysicsEntityType}`;
+    actor: Actor;
+    sensor: Sensor;
+}
+export interface CollisionResult {
+    collided: boolean;
+    normal?: Vector2;
+    penetration?: number;
+    solid: Solid;
+    pushingSolid?: Solid;
+}
+/**
+ * Result of an actor-to-actor collision
+ */
+export interface ActorCollisionResult {
+    collided: boolean;
+    normal?: Vector2;
+    penetration?: number;
+    actor: Actor;
+}
+export interface Collision {
+    type: `${PhysicsEntityType}|${PhysicsEntityType}`;
+    entity1: Actor | Sensor;
+    entity2: Actor | Solid;
+    result: CollisionResult;
+}
+/**
+ * Represents a collision between two actors
+ */
+export interface ActorCollision {
+    type: `${PhysicsEntityType}|${PhysicsEntityType}`;
+    actor1: Actor;
+    actor2: Actor;
+    result: ActorCollisionResult;
+}
+export type PhysicsEntityView = Container;
+export type PhysicsEntityType = 'Actor' | 'Solid' | 'Sensor' | 'Group' | string;
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/utils.d.ts

@@ -0,0 +1,63 @@
+import { PhysicsEntityConfig } from './types';
+/**
+ * Utility functions for resolving entity positions and sizes from various input formats.
+ * These functions handle the conversion of different coordinate and size specifications
+ * into standardized formats used by the physics system.
+ */
+/**
+ * Resolves an entity's position from various input formats.
+ * Supports direct x/y values or a position object/array.
+ *
+ * @param config - Entity configuration containing position information
+ * @returns Resolved {x, y} coordinates
+ *
+ * @example
+ * ```typescript
+ * // Using direct x/y values
+ * resolveEntityPosition({ x: 100, y: 200 })
+ * // → { x: 100, y: 200 }
+ *
+ * // Using position array
+ * resolveEntityPosition({ position: [100, 200] })
+ * // → { x: 100, y: 200 }
+ *
+ * // Using position object
+ * resolveEntityPosition({ position: { x: 100, y: 200 } })
+ * // → { x: 100, y: 200 }
+ * ```
+ */
+export declare function resolveEntityPosition(config: PhysicsEntityConfig): {
+    x: number;
+    y: number;
+};
+/**
+ * Resolves an entity's size from various input formats.
+ * Supports direct width/height values or a size object/array.
+ *
+ * @param config - Entity configuration containing size information
+ * @returns Resolved {width, height} dimensions
+ *
+ * @example
+ * ```typescript
+ * // Using direct width/height values
+ * resolveEntitySize({ width: 100, height: 200 })
+ * // → { width: 100, height: 200 }
+ *
+ * // Using size array
+ * resolveEntitySize({ size: [100, 200] })
+ * // → { width: 100, height: 200 }
+ *
+ * // Using size object
+ * resolveEntitySize({ size: { width: 100, height: 200 } })
+ * // → { width: 100, height: 200 }
+ *
+ * // Using defaults
+ * resolveEntitySize({})
+ * // → { width: 32, height: 32 }
+ * ```
+ */
+export declare function resolveEntitySize(config: PhysicsEntityConfig): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOhG"}

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@caperjs/plugin-crunch",
+  "description": "Crunch Physics",
+  "keywords": [
+    "physics",
+    "crunch",
+    "physics-crunch",
+    "@caperjs/core",
+    "caper"
+  ],
+  "version": "0.1.0",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "main": "lib/caper-plugin-crunch.mjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "default": "./lib/caper-plugin-crunch.mjs",
+      "types": "./lib/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "vite": "^8.0.7",
+    "vite-plugin-dts": "^4.5.3",
+    "@caperjs/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "gsap": "^3.15.0",
+    "pixi.js": "8.19.0",
+    "@caperjs/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "pnpm run generate-version && vite build",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "generate-version": "node generateVersion.mjs"
+  }
+}