cubeforge 0.4.3 → 0.4.5

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import * as React from 'react';
 import React__default, { CSSProperties, ReactNode, ReactElement } from 'react';
 import { Plugin, EntityId, ECSWorld, ScriptUpdateFn, NavGrid, WorldSnapshot, EventBus, AccessibilityOptions } from '@cubeforge/core';
 export { AccessibilityOptions, AssetProgress, Component, ECSWorld, Ease, EntityId, GameTimer, HierarchyComponent, HierarchySystem, HotReloadablePlugin, MergedRect, NavGrid, Plugin, PreloadManifest, ScriptUpdateFn, SpatialHash, TimelineEntry, TransformComponent, TweenHandle, TweenTimeline, Vec2Like, WorldSnapshot, WorldTransformComponent, announceToScreenReader, arrive, createHierarchy, createTag, createTimeline, createTimer, createTransform, definePlugin, findByTag, flee, getAccessibilityOptions, getDescendants, hmrClearState, hmrLoadState, hmrSaveState, hotReloadPlugin, mergeTileColliders, patrol, preloadManifest, removeParent, seek, setAccessibilityOptions, setParent, tween, wander } from '@cubeforge/core';
-import { Sampling, BlendMode, AnimatorStateDefinition, AnimatorParamValue, GradientType, GradientStop, MaskShape, PostProcessEffect } from '@cubeforge/renderer';
-export { AnimationClipDefinition, AnimationStateComponent, AnimatorComponent, AnimatorCondition, AnimatorParamValue, AnimatorStateDefinition, AnimatorTransition, BlendMode, CircleShapeComponent, GradientComponent, GradientStop, GradientType, LineShapeComponent, MagFilterValue, MaskComponent, MaskShape, NineSliceComponent, ParallaxLayerComponent, Particle, ParticlePoolComponent, PolygonShapeComponent, PostProcessEffect, PostProcessStack, RenderLayer, RenderLayerManager, RenderSystem, Sampling, SpriteComponent, SquashStretchComponent, TextComponent, TextureFilter, TextureFilterValue, TrailComponent, chromaticAberrationEffect, createCircleShape, createGradient, createLineShape, createMask, createNineSlice, createPolygonShape, createPostProcessStack, createRenderLayerManager, createSprite, defaultLayers, scanlineEffect, vignetteEffect } from '@cubeforge/renderer';
+import { Sampling, BlendMode, SpriteShape, AnimatorStateDefinition, AnimatorParamValue, GradientType, GradientStop, MaskShape, PostProcessEffect } from '@cubeforge/renderer';
+export { AnimationClipDefinition, AnimationStateComponent, AnimatorComponent, AnimatorCondition, AnimatorParamValue, AnimatorStateDefinition, AnimatorTransition, BlendMode, CircleShapeComponent, GradientComponent, GradientStop, GradientType, LineShapeComponent, MagFilterValue, MaskComponent, MaskShape, NineSliceComponent, ParallaxLayerComponent, Particle, ParticlePoolComponent, PolygonShapeComponent, PostProcessEffect, PostProcessStack, RenderLayer, RenderLayerManager, RenderSystem, Sampling, SpriteComponent, SpriteShape, SquashStretchComponent, TextComponent, TextureFilter, TextureFilterValue, TrailComponent, chromaticAberrationEffect, createCircleShape, createGradient, createLineShape, createMask, createNineSlice, createPolygonShape, createPostProcessStack, createRenderLayerManager, createSprite, defaultLayers, scanlineEffect, vignetteEffect } from '@cubeforge/renderer';
 import { CombineRule, ColliderShape, JointType } from '@cubeforge/physics';
 export { AxisLock, BVH, BoxColliderComponent, BroadPhaseAABB, BroadPhasePair, COLLISION_DYNAMIC_DYNAMIC, COLLISION_DYNAMIC_KINEMATIC, COLLISION_DYNAMIC_STATIC, COLLISION_KINEMATIC_KINEMATIC, COLLISION_KINEMATIC_STATIC, CapsuleColliderComponent, CharacterCollision, CharacterController, CharacterControllerConfig, CircleColliderComponent, ColliderShape, CollisionPair, CollisionPipeline, CollisionPipelineResult, CombineRule, CompoundColliderComponent, ContactManifold, ContactPoint, ConvexPolygonColliderComponent, ConvexShape, DEFAULT_ACTIVE_COLLISION_TYPES, DebugCircle, DebugLine, DebugPoint, DebugRenderBackend, DebugRenderColors, DebugRenderFlags, DebugRenderOutput, DebugRenderPipeline, EPAResult, Float64Pool, GJKContactManifold, GJKResult, HalfSpaceColliderComponent, HeightFieldColliderComponent, Island, IslandDetector, JointComponent, JointMotor, JointSnapshot, JointType, KahanSum, MotorMode, MoveResult, MultibodyArticulation, MultibodyLink, PhysicsBodySnapshot, PhysicsHooks, ObjectPool as PhysicsObjectPool, PhysicsSnapshot, PointProjection, QueryOpts, QueryShape, RaycastHit, RigidBodyComponent, SegmentColliderComponent, Spatial3, SpatialInertia3, SweepAndPrune, TOIBody, TOIResult, TriMeshColliderComponent, Triangle2D, TriangleColliderComponent, addForce, addForceAtPoint, addTorque, applyImpulse, applyImpulseAtPoint, applyTorqueImpulse, boxArea, boxShape, buildBVH, capsuleArea, capsuleShape, circleArea, circleShape, computeTOI, containsPoint, createCompoundCollider, createConvexPolygonCollider, createHalfSpaceCollider, createHeightFieldCollider, createJoint, createLink, createMultibody, createSegmentCollider, createTriMeshCollider, createTriangleCollider, dMath, deterministicAtan2, deterministicCos, deterministicSin, deterministicSqrt, epa, generateDeterministicPairs, gjk, gjkEpaQuery, intersectAABB, intersectRay, intersectShape, isDeterministicMode, kineticEnergy, overlapBox, overlapCircle, pairKey, polygonArea, polygonMassProperties, polygonShape, potentialEnergy, predictPosition, projectPoint, queryBVH, queryBVHCircle, raycast, raycastAll, recomputeMassFromColliders, resetAllPools, resetForces, resetTorques, resolveTOI, restoreSnapshot, setAdditionalMass, setDeterministicMode, setMassProperties, setNextKinematicPosition, setNextKinematicRotation, shapeCast, snapshotFromBytes, snapshotFromJSON, snapshotHash, snapshotToBytes, snapshotToJSON, sortEntities, sweepBox, takeSnapshot, triangleArea, triangleMassProperties, velocityAtPoint } from '@cubeforge/physics';
 import { InputManager, ActionBindings, InputContextName, PlayerInput, InputRecorderControls, TouchPoint, InputBufferOptions, InputBuffer, ComboDefinition } from '@cubeforge/input';
@@ -135,8 +135,22 @@ interface SpriteProps {
     tintOpacity?: number;
     /** Overall opacity 0-1 (default 1) */
     opacity?: number;
+    /** Shape to draw: 'rect' (default), 'circle', 'ellipse', 'roundedRect', 'triangle', 'star', 'pentagon', 'hexagon' */
+    shape?: SpriteShape;
+    /** Border radius for 'roundedRect' shape (px) */
+    borderRadius?: number;
+    /** Stroke outline color */
+    strokeColor?: string;
+    /** Stroke outline width in pixels */
+    strokeWidth?: number;
+    /** Custom draw callback */
+    customDraw?: (ctx: CanvasRenderingContext2D, width: number, height: number) => void;
+    /** Number of points for 'star' shape (default 5) */
+    starPoints?: number;
+    /** Inner radius ratio for 'star' shape (0-1, default 0.4) */
+    starInnerRadius?: number;
 }
-declare function Sprite({ width, height, color, src, offsetX, offsetY, zIndex, visible, flipX, flipY, anchorX, anchorY, frameIndex, frameWidth, frameHeight, frameColumns, atlas, frame, tileX, tileY, tileSizeX, tileSizeY, sampling, blendMode, layer, tint, tintOpacity, opacity, }: SpriteProps): null;
+declare function Sprite({ width, height, color, src, offsetX, offsetY, zIndex, visible, flipX, flipY, anchorX, anchorY, frameIndex, frameWidth, frameHeight, frameColumns, atlas, frame, tileX, tileY, tileSizeX, tileSizeY, sampling, blendMode, layer, tint, tintOpacity, opacity, shape, borderRadius, strokeColor, strokeWidth, customDraw, starPoints, starInnerRadius, }: SpriteProps): null;
 
 interface TextProps {
     text: string;

package/dist/index.js

@@ -1831,6 +1831,11 @@ function createSprite(opts) {
     blendMode: "normal",
     layer: "default",
     opacity: 1,
+    shape: "rect",
+    borderRadius: 0,
+    strokeWidth: 0,
+    starPoints: 5,
+    starInnerRadius: 0.4,
     ...opts
   };
 }
@@ -2347,6 +2352,8 @@ var RenderSystem = class {
     gl.enable(gl.BLEND);
     gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
   }
+  /** Default background used when no Camera2D component exists */
+  defaultBackground = "#1a1a2e";
   gl;
   program;
   quadVAO;
@@ -2617,7 +2624,7 @@ var RenderSystem = class {
     const W = canvas.width;
     const H = canvas.height;
     let camX = 0, camY = 0, zoom = 1;
-    let background = "#000000";
+    let background = this.defaultBackground;
     let shakeX = 0, shakeY = 0;
     const camId = world.queryOne("Camera2D");
     if (camId !== void 0) {
@@ -3264,7 +3271,7 @@ var Canvas2DRenderer = class {
   }
   ctx;
   clear(color) {
-    if (color) {
+    if (color && color !== "transparent") {
       this.ctx.fillStyle = color;
       this.ctx.fillRect(0, 0, this.canvas.width, this.canvas.height);
     } else {
@@ -12720,7 +12727,14 @@ function Sprite({
   layer = "default",
   tint,
   tintOpacity,
-  opacity = 1
+  opacity = 1,
+  shape = "rect",
+  borderRadius = 0,
+  strokeColor,
+  strokeWidth = 0,
+  customDraw,
+  starPoints = 5,
+  starInnerRadius = 0.4
 }) {
   const resolvedFrameIndex = atlas && frame != null ? atlas[frame] ?? 0 : frameIndex;
   const engine = useContext6(EngineContext);
@@ -12762,7 +12776,14 @@ function Sprite({
       layer,
       tint,
       tintOpacity,
-      opacity
+      opacity,
+      shape,
+      borderRadius,
+      strokeColor,
+      strokeWidth,
+      customDraw,
+      starPoints,
+      starInnerRadius
     });
     engine.ecs.addComponent(entityId, comp);
     if (src) {
@@ -12790,6 +12811,13 @@ function Sprite({
     comp.tint = tint;
     comp.tintOpacity = tintOpacity;
     comp.opacity = opacity;
+    comp.shape = shape;
+    comp.borderRadius = borderRadius;
+    comp.strokeColor = strokeColor;
+    comp.strokeWidth = strokeWidth;
+    comp.customDraw = customDraw;
+    comp.starPoints = starPoints;
+    comp.starInnerRadius = starInnerRadius;
   }, [
     color,
     visible,
@@ -12802,6 +12830,13 @@ function Sprite({
     tint,
     tintOpacity,
     opacity,
+    shape,
+    borderRadius,
+    strokeColor,
+    strokeWidth,
+    customDraw,
+    starPoints,
+    starInnerRadius,
     engine,
     entityId
   ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cubeforge",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "React-first 2D browser game engine",
   "type": "module",
   "main": "./dist/index.js",