cubeforge 0.4.13 → 0.4.14

package/dist/index.d.ts

@@ -750,8 +750,30 @@ interface TilemapProps {
      * row-run (legacy behaviour).
      */
     mergeColliders?: boolean;
+    /**
+     * Array of tile GIDs (global IDs) to treat as solid, regardless of layer.
+     * When set, only tiles whose GID is in this array generate colliders in
+     * the collision layer. Without this, ALL non-zero tiles in the collision
+     * layer produce colliders.
+     */
+    solidTiles?: number[];
+    /**
+     * When true, also scan visual layers for tiles whose GID matches
+     * `solidTiles` and auto-generate colliders from them — no separate
+     * collision layer required. Default: false.
+     */
+    autoColliders?: boolean;
+    /**
+     * Per-tile-GID collider properties. Keys are tile GIDs.
+     * Example: `{ 6: { isTrigger: true }, 7: { oneWay: true } }`
+     */
+    tileColliderProps?: Record<number, {
+        isTrigger?: boolean;
+        oneWay?: boolean;
+        layer?: string;
+    }>;
 }
-declare function Tilemap({ src, onSpawnObject, layerFilter, zIndex, collisionLayer, triggerLayer: triggerLayerName, onTileProperty, navGrid, mergeColliders, }: TilemapProps): React__default.ReactElement | null;
+declare function Tilemap({ src, onSpawnObject, layerFilter, zIndex, collisionLayer, triggerLayer: triggerLayerName, onTileProperty, navGrid, mergeColliders, solidTiles, autoColliders, tileColliderProps: _tileColliderProps, }: TilemapProps): React__default.ReactElement | null;
 
 interface ParallaxLayerProps {
     /** Image URL to use as the background layer */
@@ -1832,6 +1854,100 @@ interface SceneManagerControls {
  */
 declare function useSceneManager(initialScene: string): SceneManagerControls;
 
+type TransitionEffect = {
+    type: 'fade';
+    duration?: number;
+    color?: string;
+} | {
+    type: 'wipe';
+    duration?: number;
+    direction?: 'left' | 'right' | 'up' | 'down';
+    color?: string;
+} | {
+    type: 'circle-close';
+    duration?: number;
+    color?: string;
+} | {
+    type: 'instant';
+};
+interface SceneTransitionControls {
+    /** Currently active scene (after transition completes). */
+    current: string;
+    /** Full scene stack. */
+    stack: string[];
+    /** Push scene with transition. */
+    push(scene: string, transition?: TransitionEffect): void;
+    /** Pop top scene with transition. Returns popped scene name. */
+    pop(transition?: TransitionEffect): string | undefined;
+    /** Replace current scene with transition. */
+    replace(scene: string, transition?: TransitionEffect): void;
+    /** Reset to a single scene with transition. */
+    reset(scene: string, transition?: TransitionEffect): void;
+    /** Transition progress 0–1 (0 = no overlay, 1 = fully covered). */
+    progress: number;
+    /** Current transition phase. */
+    phase: 'idle' | 'out' | 'in';
+    /** Active transition effect (for overlay rendering). */
+    activeTransition: TransitionEffect | null;
+}
+/**
+ * Scene manager with built-in visual transitions.
+ *
+ * @example
+ * const scenes = useSceneTransition('gameplay')
+ * scenes.push('pause', { type: 'fade', duration: 0.4, color: '#000' })
+ * scenes.replace('gameOver', { type: 'circle-close', duration: 0.6 })
+ *
+ * // Render the overlay component to see transitions:
+ * <SceneTransitionOverlay controls={scenes} />
+ */
+declare function useSceneTransition(initialScene: string, defaultTransition?: TransitionEffect): SceneTransitionControls;
+
+interface SceneTransitionOverlayProps {
+    controls: SceneTransitionControls;
+}
+/**
+ * Renders the visual overlay during scene transitions.
+ * Place this as a sibling after your scene content, inside the Game wrapper.
+ *
+ * @example
+ * const scenes = useSceneTransition('gameplay')
+ *
+ * <div style={{ position: 'relative' }}>
+ *   {scenes.current === 'gameplay' && <GameplayScene />}
+ *   {scenes.current === 'pause' && <PauseMenu />}
+ *   <SceneTransitionOverlay controls={scenes} />
+ * </div>
+ */
+declare function SceneTransitionOverlay({ controls }: SceneTransitionOverlayProps): React__default.DetailedReactHTMLElement<{
+    style: {
+        position: "absolute";
+        inset: number;
+        backgroundColor: string;
+        WebkitMaskImage: `radial-gradient(circle ${number}vmax at 50% 50%, transparent 100%, black 100%)`;
+        maskImage: `radial-gradient(circle ${number}vmax at 50% 50%, transparent 100%, black 100%)`;
+        pointerEvents: "none";
+        zIndex: number;
+    };
+}, HTMLElement> | React__default.DetailedReactHTMLElement<{
+    style: React__default.CSSProperties;
+}, HTMLElement> | null;
+
+/**
+ * Freeze gameplay for a short duration — physics and scripts stop
+ * but the last frame stays rendered. Creates impactful collision feedback.
+ *
+ * @example
+ * const hitstop = useHitstop()
+ *
+ * useCollisionEnter(() => {
+ *   hitstop.freeze(0.08) // 80ms freeze on hit
+ * })
+ */
+declare function useHitstop(): {
+    freeze: (seconds: number) => void;
+};
+
 /**
  * Returns a stable `InputBuffer` instance that persists across renders.
  *
@@ -2106,4 +2222,4 @@ declare function useRemotePlayer(config: {
     opts?: RemotePlayerOptions;
 }): RemotePlayerControls;
 
-export { type AccessibilityControls, AnimatedSprite, type AnimatedSpriteProps, Animation, type AnimationSet, Animator, AssetLoader, type BoundInputMap, BoxCollider, Camera2D, type CameraControls, type CameraLookaheadOptions, CameraZone, CapsuleCollider, Checkpoint, Circle, CircleCollider, type ComboDetectorResult, CompoundCollider, ConvexCollider, type CoordinateHelpers, type CoroutineControls, type CoroutineFactory, type CoroutineYield, Entity, Game, type GameControls, type GamepadState, type GestureHandlers, type GestureOptions, Gradient, type HMRControls, HalfSpaceCollider, HeightFieldCollider, type InputContextControls, Joint, Line, Mask, MovingPlatform, type NetworkSyncOptions, NineSlice, ParallaxLayer, ParticleEmitter, type ParticlePreset, type PauseControls, type PinchEvent, Polygon, type PreloadState, type ProfilerData, type RemotePlayerControls, type RemotePlayerOptions, RigidBody, type SceneManagerControls, ScreenFlash, type ScreenFlashHandle, Script, SegmentCollider, type SnapshotControls, Sprite, type SpriteAtlas, SquashStretch, type SquashStretchControls, type SwipeEvent, Text, type TiledLayer, type TiledObject, Tilemap, type TimerControls, type TouchControls, Trail, Transform, TriMeshCollider, TriangleCollider, type VirtualInputState, VirtualJoystick, type VirtualJoystickProps, type Waypoint, World, createAtlas, defineAnimations, definePrefab, playClip, setAnimationState, setAnimatorParam, useAccessibility, useAudioListener, useCamera, useCameraLookahead, useComboDetector, useCoordinates, useCoroutine, useDestroyEntity, useEntity, useEvent, useEvents, useGame, useGamepad, useGamepadHaptics, useGestures, useHMR, useInput, useInputBuffer, useInputContext, useInputMap, useInputRecorder, useLocalMultiplayer, useNetworkSync, useParent, usePause, usePlayerInput, usePostProcess, usePreload, useProfiler, useRemotePlayer, useSceneManager, useSnapshot, useSquashStretch, useTimer, useTouch, useVirtualInput, useWebGLPostProcess, useWorldQuery, wait, waitFrames, waitUntil };
+export { type AccessibilityControls, AnimatedSprite, type AnimatedSpriteProps, Animation, type AnimationSet, Animator, AssetLoader, type BoundInputMap, BoxCollider, Camera2D, type CameraControls, type CameraLookaheadOptions, CameraZone, CapsuleCollider, Checkpoint, Circle, CircleCollider, type ComboDetectorResult, CompoundCollider, ConvexCollider, type CoordinateHelpers, type CoroutineControls, type CoroutineFactory, type CoroutineYield, Entity, Game, type GameControls, type GamepadState, type GestureHandlers, type GestureOptions, Gradient, type HMRControls, HalfSpaceCollider, HeightFieldCollider, type InputContextControls, Joint, Line, Mask, MovingPlatform, type NetworkSyncOptions, NineSlice, ParallaxLayer, ParticleEmitter, type ParticlePreset, type PauseControls, type PinchEvent, Polygon, type PreloadState, type ProfilerData, type RemotePlayerControls, type RemotePlayerOptions, RigidBody, type SceneManagerControls, type SceneTransitionControls, SceneTransitionOverlay, ScreenFlash, type ScreenFlashHandle, Script, SegmentCollider, type SnapshotControls, Sprite, type SpriteAtlas, SquashStretch, type SquashStretchControls, type SwipeEvent, Text, type TiledLayer, type TiledObject, Tilemap, type TimerControls, type TouchControls, Trail, Transform, type TransitionEffect, TriMeshCollider, TriangleCollider, type VirtualInputState, VirtualJoystick, type VirtualJoystickProps, type Waypoint, World, createAtlas, defineAnimations, definePrefab, playClip, setAnimationState, setAnimatorParam, useAccessibility, useAudioListener, useCamera, useCameraLookahead, useComboDetector, useCoordinates, useCoroutine, useDestroyEntity, useEntity, useEvent, useEvents, useGame, useGamepad, useGamepadHaptics, useGestures, useHMR, useHitstop, useInput, useInputBuffer, useInputContext, useInputMap, useInputRecorder, useLocalMultiplayer, useNetworkSync, useParent, usePause, usePlayerInput, usePostProcess, usePreload, useProfiler, useRemotePlayer, useSceneManager, useSceneTransition, useSnapshot, useSquashStretch, useTimer, useTouch, useVirtualInput, useWebGLPostProcess, useWorldQuery, wait, waitFrames, waitUntil };