canvasengine 2.0.0-beta.4 → 2.0.0-beta.41

package/dist/utils/RadialGradient.d.ts

@@ -0,0 +1,58 @@
+import { Texture, Matrix } from 'pixi.js';
+
+/**
+ * Creates a radial gradient texture that can be used in PixiJS.
+ * @example
+ * const gradient = new RadialGradient(size, size, 0, size, size, 0);
+ * gradient.addColorStop(0, "rgba(255, 255, 0, 1)");
+ * gradient.addColorStop(0.5, "rgba(255, 255, 0, 0.3)");
+ * gradient.addColorStop(0.8, "rgba(255, 255, 0, 0)");
+ */
+export declare class RadialGradient {
+    private x0;
+    private y0;
+    private x1;
+    private y1;
+    private x2;
+    private y2;
+    private focalPoint;
+    private canvas;
+    private ctx;
+    private gradient;
+    private texture;
+    transform: Matrix;
+    size: number;
+    /**
+     * Creates a new RadialGradient instance
+     * @param x0 - The x-coordinate of the starting circle
+     * @param y0 - The y-coordinate of the starting circle
+     * @param x1 - The x-coordinate of the ending circle
+     * @param y1 - The y-coordinate of the ending circle
+     * @param x2 - The x-coordinate for gradient transformation
+     * @param y2 - The y-coordinate for gradient transformation
+     * @param focalPoint - The focal point of the gradient (0-1), defaults to 0
+     */
+    constructor(x0: number, y0: number, x1: number, y1: number, x2: number, y2: number, focalPoint?: number);
+    /**
+     * Adds a color stop to the gradient
+     * @param offset - The position of the color stop (0-1)
+     * @param color - The color value (any valid CSS color string)
+     */
+    addColorStop(offset: number, color: string): void;
+    /**
+     * Renders the gradient and returns the texture with its transformation matrix
+     * @param options - Render options
+     * @param options.translate - Optional translation coordinates
+     * @returns Object containing the texture and transformation matrix
+     */
+    render({ translate }?: {
+        translate?: {
+            x: number;
+            y: number;
+        };
+    }): {
+        texture: Texture<import('pixi.js').TextureSource<any>>;
+        matrix: Matrix;
+    };
+}
+//# sourceMappingURL=RadialGradient.d.ts.map

package/dist/utils/RadialGradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadialGradient.d.ts","sourceRoot":"","sources":["../../src/utils/RadialGradient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA2B,MAAM,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;GAOG;AACH,qBAAa,cAAc;IAoBvB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAzBpB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAwB;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,SAAO;IAElB;;;;;;;;;OASG;gBAEO,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,GAAE,MAAU;IAsBhC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAM1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,GAAE;QAAE,SAAS,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAO;;;;CAuCpE"}

package/dist/utils/functions.d.ts

@@ -0,0 +1,2 @@
+export declare function isPercent(value?: string | number): boolean;
+//# sourceMappingURL=functions.d.ts.map

package/dist/utils/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/utils/functions.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,WAMhD"}

package/package.json

@@ -1,22 +1,28 @@
 {
   "name": "canvasengine",
-  "version": "2.0.0-beta.4",
+  "version": "2.0.0-beta.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "pixi.js": "^8.9.2"
+  },
   "dependencies": {
     "@barvynkoa/particle-emitter": "^0.0.1",
-    "@signe/reactive": "^1.0.1",
+    "@pixi/layout": "^3.0.2",
+    "@signe/reactive": "^2.6.0",
     "howler": "^2.2.4",
+    "joypad.js": "^2.3.5",
     "pixi-filters": "^6.0.5",
     "pixi-viewport": "^6.0.3",
-    "pixi.js": "^8.6.4",
     "popmotion": "^11.0.5",
     "rxjs": "^7.8.1",
-    "yoga-layout": "^2.0.1"
+    "yoga-layout": "^3.2.1"
   },
   "devDependencies": {
-    "@types/howler": "^2.2.11"
+    "@types/howler": "^2.2.11",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.0.0"
   },
   "author": "Samuel Ronce",
   "license": "MIT",
@@ -38,7 +44,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
+    "build": "vite build",
+    "dev": "vite build --watch"
   }
 }

package/src/components/Button.ts

@@ -0,0 +1,396 @@
+import { effect, signal, computed, isSignal } from "@signe/reactive";
+import { FederatedPointerEvent } from "pixi.js";
+import { h } from "../engine/signal";
+import { useDefineProps } from "../hooks/useProps";
+import { Container } from "./Container";
+import { Rect, Circle, Ellipse } from "./Graphic";
+import { Text } from "./Text";
+import { ControlsDirective } from "../directives/Controls";
+import { JoystickControls } from "../directives/JoystickControls";
+import { Element } from "../engine/reactive";
+
+/**
+ * Button states for visual feedback
+ */
+export enum ButtonState {
+  Normal = "normal",
+  Hover = "hover",
+  Pressed = "pressed",
+  Disabled = "disabled"
+}
+
+/**
+ * Button style configuration for different visual approaches
+ */
+export interface ButtonStyle {
+  /** Background color for each state */
+  backgroundColor?: {
+    [ButtonState.Normal]?: string;
+    [ButtonState.Hover]?: string;
+    [ButtonState.Pressed]?: string;
+    [ButtonState.Disabled]?: string;
+  };
+  /** Border configuration */
+  border?: {
+    color?: string;
+    width?: number;
+    radius?: number;
+  };
+  /** Text styling */
+  text?: {
+    color?: string;
+    fontSize?: number;
+    fontFamily?: string;
+  };
+  /** Sprite textures for each state (alternative to backgroundColor) */
+  textures?: {
+    [ButtonState.Normal]?: string;
+    [ButtonState.Hover]?: string;
+    [ButtonState.Pressed]?: string;
+    [ButtonState.Disabled]?: string;
+  };
+}
+
+/**
+ * Properties for the Button component
+ */
+export interface ButtonProps {
+  /** Button text content */
+  text?: string;
+  /** Button disabled state */
+  disabled?: boolean;
+  /** Click event handler */
+  click?: (event: FederatedPointerEvent) => void;
+  /** Hover enter event handler */
+  hoverEnter?: (event: FederatedPointerEvent) => void;
+  /** Hover leave event handler */
+  hoverLeave?: (event: FederatedPointerEvent) => void;
+  /** Press down event handler */
+  pressDown?: (event: FederatedPointerEvent) => void;
+  /** Press up event handler */
+  pressUp?: (event: FederatedPointerEvent) => void;
+  /** Visual style configuration */
+  style?: ButtonStyle;
+  /** Button width */
+  width?: number;
+  /** Button height */
+  height?: number;
+  /** Button position X */
+  x?: number;
+  /** Button position Y */
+  y?: number;
+  /** Button alpha/opacity */
+  alpha?: number;
+  /** Button visibility */
+  visible?: boolean;
+  /** Button cursor */
+  cursor?: string;
+  /** Controls instance to automatically apply button events to (e.g., ControlsDirective or JoystickControls) */
+  controls?: ControlsDirective | JoystickControls | any;
+  /** Name of the control to trigger with applyControl when button is clicked */
+  controlName?: string;
+  /** Shape of the button background: 'rect', 'circle', or 'ellipse' */
+  shape?: 'rect' | 'circle' | 'ellipse';
+  /** Custom background component or element (replaces default background if provided) */
+  background?: Element | any;
+  /** Custom children components for button content (takes priority over text if provided) */
+  children?: Element[];
+}
+
+/**
+ * Creates a Button component with interactive states and customizable styling.
+ * 
+ * This component provides a fully interactive button with visual feedback
+ * for different states (normal, hover, pressed, disabled). It supports both
+ * sprite-based and graphics-based rendering approaches.
+ * 
+ * The button is built using a Container with background and text elements,
+ * providing reactive state management and event handling.
+ * 
+ * ## Features
+ * 
+ * - **Controls Integration**: Automatically trigger controls via `applyControl` when clicked
+ * - **Multiple Shapes**: Support for rect, circle, and ellipse shapes
+ * - **Custom Content**: Use children components for custom button content
+ * - **Custom Background**: Provide a custom background component
+ * 
+ * @param props - Button configuration including text, styling, controls, shape, and event handlers
+ * @returns A reactive Button component
+ * @example
+ * ```typescript
+ * // Simple button with text and click handler
+ * const simpleButton = Button({
+ *   text: "Click Me",
+ *   click: () => console.log("Button clicked!"),
+ *   width: 150,
+ *   height: 50
+ * });
+ * 
+ * // Button with controls integration
+ * const jumpButton = Button({
+ *   text: "Jump",
+ *   controls: controlsInstance,
+ *   controlName: "jump",
+ *   width: 120,
+ *   height: 40
+ * });
+ * 
+ * // Circular button
+ * const circleButton = Button({
+ *   text: "Action",
+ *   shape: "circle",
+ *   width: 100,
+ *   height: 100
+ * });
+ * 
+ * // Button with custom content (children)
+ * const customButton = Button({
+ *   shape: "circle",
+ *   width: 80,
+ *   height: 80,
+ *   children: [
+ *     h(Sprite, { image: "icon.png", width: 50, height: 50 })
+ *   ]
+ * });
+ * 
+ * // Styled button with custom colors
+ * const styledButton = Button({
+ *   text: "Styled Button",
+ *   style: {
+ *     backgroundColor: {
+ *       normal: "#28a745",
+ *       hover: "#218838",
+ *       pressed: "#1e7e34",
+ *       disabled: "#6c757d"
+ *     },
+ *     border: {
+ *       radius: 8,
+ *       width: 2,
+ *       color: "#ffffff"
+ *     },
+ *     text: {
+ *       fontSize: 18,
+ *       color: "#ffffff"
+ *     }
+ *   }
+ * });
+ * 
+ * // Sprite-based button
+ * const spriteButton = Button({
+ *   text: "Play Game",
+ *   style: {
+ *     textures: {
+ *       normal: "/assets/button-normal.png",
+ *       hover: "/assets/button-hover.png",
+ *       pressed: "/assets/button-pressed.png"
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export function Button(props: ButtonProps) {
+  // Internal state signals
+  const currentState = signal(ButtonState.Normal);
+  const isPressed = signal(false);
+  const isHovered = signal(false);
+
+  // Define reactive props with defaults
+  const defineProps = useDefineProps(props);
+  const { text, disabled, width, height, style, shape, controlName } = defineProps({
+    text: {
+      type: String,
+      default: ""
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    width: {
+      type: Number,
+      default: 120
+    },
+    height: {
+      type: Number,
+      default: 40
+    },
+    style: {
+      type: Object,
+      default: () => ({})
+    },
+    shape: {
+      type: String,
+      default: "rect"
+    },
+    controlName: {
+      type: String,
+      default: undefined
+    }
+  });
+
+  // Helper function to get controls instance (handles signals like Joystick)
+  const getControls = () => {
+    if (!props.controls) return null;
+    if (isSignal(props.controls)) {
+      return props.controls();
+    }
+    return props.controls;
+  };
+
+  // Update button state based on disabled and interaction states
+  effect(() => {
+    const isDisabled = disabled();
+    const pressed = isPressed();
+    const hovered = isHovered();
+
+    if (isDisabled) {
+      currentState.set(ButtonState.Disabled);
+    } else if (pressed) {
+      currentState.set(ButtonState.Pressed);
+    } else if (hovered) {
+      currentState.set(ButtonState.Hover);
+    } else {
+      currentState.set(ButtonState.Normal);
+    }
+  });
+
+  // Event handlers
+  const eventHandlers = {
+    pointerenter: (event: FederatedPointerEvent) => {
+      if (!disabled()) {
+        isHovered.set(true);
+        props.hoverEnter?.(event);
+      }
+    },
+    pointerleave: (event: FederatedPointerEvent) => {
+      isHovered.set(false);
+      isPressed.set(false);
+      props.hoverLeave?.(event);
+    },
+    pointerdown: async (event: FederatedPointerEvent) => {
+      if (!disabled()) {
+        isPressed.set(true);
+        props.pressDown?.(event);
+        
+        // Apply control if controls and controlName are provided
+        const controls = getControls();
+        const name = controlName();
+        if (controls && name && controls.applyControl) {
+          await controls.applyControl(name, true);
+        }
+      }
+    },
+    pointerup: async (event: FederatedPointerEvent) => {
+      if (!disabled() && isPressed()) {
+        isPressed.set(false);
+        props.pressUp?.(event);
+        
+        // Apply control release if controls and controlName are provided
+        const controls = getControls();
+        const name = controlName();
+        if (controls && name && controls.applyControl) {
+          await controls.applyControl(name, false);
+        }
+      }
+    },
+    pointertap: async (event: FederatedPointerEvent) => {
+      if (!disabled()) {
+        props.click?.(event);
+        
+        // Apply control if controls and controlName are provided (press and release)
+        const controls = getControls();
+        const name = controlName();
+        if (controls && name && controls.applyControl) {
+          await controls.applyControl(name);
+        }
+      }
+    }
+  };
+
+  // Generate background element
+  const getBackgroundElement = () => {
+    // If custom background is provided, use it
+    if (props.background) {
+      return props.background;
+    }
+
+    // Otherwise, use shape-based background
+    const currentShape = shape();
+    const bgColor = computed(() => {
+      const currentStyle = style();
+      const backgroundColor = currentStyle.backgroundColor || {
+        [ButtonState.Normal]: "#007bff",
+        [ButtonState.Hover]: "#0056b3",
+        [ButtonState.Pressed]: "#004085",
+        [ButtonState.Disabled]: "#6c757d"
+      };
+      const state = currentState();
+      return backgroundColor[state] || backgroundColor[ButtonState.Normal];
+    });
+
+    if (currentShape === 'circle') {
+      // For circle, use the smaller dimension as radius
+      const radius = computed(() => Math.min(width(), height()) / 2);
+      return h(Circle, {
+        radius: radius,
+        x: computed(() => width() / 2),
+        y: computed(() => height() / 2),
+        color: bgColor
+      });
+    } else if (currentShape === 'ellipse') {
+      return h(Ellipse, {
+        width: width,
+        height: height,
+        color: bgColor
+      });
+    } else {
+      // Default: rect
+      return h(Rect, {
+        width: width,
+        height: height,
+        color: bgColor
+      });
+    }
+  };
+
+  // Generate content element(s)
+  const getContentElements = () => {
+    // If children are provided, use them (priority over text)
+    if (props.children && props.children.length > 0) {
+      return props.children;
+    }
+
+    // Otherwise, use text
+    return [
+      h(Text, {
+        text: text,
+        x: computed(() => width() / 2),
+        y: computed(() => height() / 2),
+        anchor: { x: 0.5, y: 0.5 },
+        style: computed(() => {
+          const currentStyle = style();
+          const textStyle = currentStyle.text || {};
+          return {
+            fontSize: textStyle.fontSize || 16,
+            fontFamily: textStyle.fontFamily || "Arial",
+            fill: textStyle.color || "#ffffff"
+          };
+        })()
+      })
+    ];
+  };
+
+  // Return Container with h() children
+  return h(Container, {
+    x: props.x,
+    y: props.y,
+    width: props.width,
+    height: props.height,
+    alpha: props.alpha,
+    visible: props.visible,
+    cursor: props.cursor || "pointer",
+    ...eventHandlers
+  }, [
+    getBackgroundElement(),
+    ...getContentElements()
+  ]);
+}

package/src/components/Canvas.ts

@@ -1,21 +1,26 @@
 import { effect, Signal, signal } from "@signe/reactive";
-import { Container, autoDetectRenderer } from "pixi.js";
-import { loadYoga } from "yoga-layout";
-import { Props, createComponent, registerComponent, Element } from "../engine/reactive";
+import { Application, Container } from "pixi.js";
+import {
+  Props,
+  createComponent,
+  registerComponent,
+  Element,
+} from "../engine/reactive";
 import { useProps } from "../hooks/useProps";
 import { ComponentInstance, DisplayObject } from "./DisplayObject";
 import { ComponentFunction } from "../engine/signal";
 import { SignalOrPrimitive } from "./types";
 import { Size } from "./types/DisplayObject";
 import { Scheduler, Tick } from "../directives/Scheduler";
+import { GlobalAssetLoader } from "../utils/GlobalAssetLoader";
 
 interface CanvasElement extends Element<ComponentInstance> {
-  render: (rootElement: HTMLElement) => void;
+  render: (rootElement: HTMLElement, app?: Application) => void;
   directives: {
-    tick: Scheduler
+    tick: Scheduler;
   };
   propObservables: {
-    tick: Signal<Tick>
+    tick: Signal<Tick>;
   };
 }
 
@@ -30,33 +35,28 @@ export interface CanvasProps extends Props {
   isRoot?: boolean;
   tick?: any;
   class?: SignalOrPrimitive<string>;
+  background?: string;
 }
 
 export const Canvas: ComponentFunction<CanvasProps> = async (props = {}) => {
   let { cursorStyles, width, height, class: className } = useProps(props);
-  const Yoga = await loadYoga();
 
-  if (!props.width) width = signal<Size>(800)
-  if (!props.height) height = signal<Size>(600)
-
-  const renderer = await autoDetectRenderer({
-    ...props,
-    width: width?.(),
-    height: height?.(),
-  });
+  if (!props.width) width = signal<Size>(800);
+  if (!props.height) height = signal<Size>(600);
 
   const canvasSize = signal({
-    width: renderer.width,
-    height: renderer.height,
+    width: 0,
+    height: 0,
   });
 
   props.isRoot = true;
+  const globalLoader = new GlobalAssetLoader();
   const options: CanvasProps = {
     ...props,
     context: {
-      Yoga,
-      renderer,
       canvasSize,
+      app: signal(null),
+      globalLoader,
     },
     width: width?.(),
     height: height?.(),
@@ -69,10 +69,21 @@ export const Canvas: ComponentFunction<CanvasProps> = async (props = {}) => {
       frame: 0,
       deltaRatio: 1,
     });
+  } else {
+    options.context!.tick = props.tick;
   }
+
+  // Register the tick signal globally so animatedSignal can use it by default
+  (globalThis as any).__CANVAS_ENGINE_TICK__ = options.context!.tick;
+
   const canvasElement = createComponent("Canvas", options) as CanvasElement;
 
-  canvasElement.render = (rootElement: HTMLElement) => {
+  canvasElement.render = (rootElement: HTMLElement, app?: Application) => {
+    if (!app) {
+      return;
+    }
+
+    const renderer = app.renderer;
     const canvasEl = renderer.view.canvas as HTMLCanvasElement;
 
     (globalThis as any).__PIXI_STAGE__ = canvasElement.componentInstance;
@@ -85,6 +96,34 @@ export const Canvas: ComponentFunction<CanvasProps> = async (props = {}) => {
       renderer.render(canvasElement.componentInstance as any);
     });
 
+    app.stage = canvasElement.componentInstance as any;
+
+    app.stage.layout = {
+      width: app.screen.width,
+      height: app.screen.height,
+      justifyContent: props.justifyContent,
+      alignItems: props.alignItems,
+    };
+
+    canvasSize.set({ width: app.screen.width, height: app.screen.height })
+
+    app.renderer.on('resize', (width: number, height: number) => {
+      canvasSize.set({ width, height });
+
+      if (app.stage.layout) {
+        app.stage.layout = {
+          width,
+          height
+        }
+      }
+    });
+
+    if (props.tickStart !== false) canvasElement.directives.tick.start();
+
+    app.ticker.add(() => {
+      canvasElement.propObservables!.tick();
+    });
+
     if (cursorStyles) {
       effect(() => {
         renderer.events.cursorStyles = cursorStyles();
@@ -97,37 +136,14 @@ export const Canvas: ComponentFunction<CanvasProps> = async (props = {}) => {
       });
     }
 
-    const resizeCanvas = async () => {
-      let w, h;
-      if (width?.() === "100%" && height?.() === "100%") {
-        const parent = canvasEl.parentElement;
-        w = parent ? parent.clientWidth : window.innerWidth;
-        h = parent ? parent.clientHeight : window.innerHeight;
-      } else {
-        w = width?.() ?? canvasEl.offsetWidth;
-        h = height?.() ?? canvasEl.offsetHeight;
-      }
-      renderer.resize(w, h);
-      canvasSize.set({ width: w, height: h });
-      canvasElement.componentInstance.setWidth(w)
-      canvasElement.componentInstance.setHeight(h)
-    };
-
-    // Listen for window resize events
-    window.addEventListener("resize", resizeCanvas);
-
-    // Check if a canvas already exists in the rootElement
-    const existingCanvas = rootElement.querySelector('canvas');
+    const existingCanvas = rootElement.querySelector("canvas");
     if (existingCanvas) {
-      // If it exists, replace it with the new canvas
       rootElement.replaceChild(canvasEl, existingCanvas);
     } else {
-      // If it doesn't exist, append the new canvas
       rootElement.appendChild(canvasEl);
     }
 
-     // Initial resize
-     resizeCanvas();
+    options.context!.app.set(app)
   };
 
   return canvasElement;