@nice2dev/game-engine 0.1.0

package/dist/types/ui/GameUI.d.ts

@@ -0,0 +1,97 @@
+import type { Vec2, Color } from '../core/types';
+import { EventBus } from '../core/EventBus';
+export type UIAnchor = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+export type UIElementType = 'text' | 'bar' | 'image' | 'panel' | 'button' | 'container';
+export interface UIStyle {
+    fontSize?: number;
+    fontFamily?: string;
+    color?: Color;
+    backgroundColor?: Color;
+    borderColor?: Color;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: number;
+    opacity?: number;
+    visible?: boolean;
+}
+export interface UIElement {
+    id: string;
+    type: UIElementType;
+    /** Position relative to anchor (px). */
+    position: Vec2;
+    anchor: UIAnchor;
+    size: {
+        width: number;
+        height: number;
+    };
+    style: UIStyle;
+    /** For text/button elements. */
+    text?: string;
+    /** For bar elements (0-1). */
+    value?: number;
+    /** For image elements. */
+    imageId?: string;
+    /** Children for container type. */
+    children?: string[];
+    /** Whether this element can receive focus. */
+    focusable?: boolean;
+    /** Callback action name for button click/select. */
+    action?: string;
+    /** Custom data. */
+    data?: Record<string, unknown>;
+    enabled: boolean;
+    visible: boolean;
+}
+export interface UITheme {
+    name: string;
+    fontFamily: string;
+    fontSize: number;
+    textColor: Color;
+    panelColor: Color;
+    panelBorder: Color;
+    accentColor: Color;
+    focusColor: Color;
+    disabledColor: Color;
+    buttonColor: Color;
+    buttonHoverColor: Color;
+    barFillColor: Color;
+    barBgColor: Color;
+}
+export declare class GameUI {
+    readonly events: EventBus;
+    private elements;
+    private layers;
+    private _theme;
+    private _focusedId;
+    private _focusOrder;
+    private _screenSize;
+    get theme(): Readonly<UITheme>;
+    set theme(t: Partial<UITheme>);
+    get focusedElement(): string | null;
+    setScreenSize(w: number, h: number): void;
+    addElement(el: UIElement, layerIndex?: number): void;
+    removeElement(id: string): void;
+    getElement(id: string): UIElement | undefined;
+    clear(): void;
+    focusNext(): void;
+    focusPrev(): void;
+    setFocus(id: string | null): void;
+    /** Activate (select/click) the currently focused element. */
+    activateFocused(): void;
+    createText(id: string, text: string, anchor?: UIAnchor, pos?: Vec2, style?: Partial<UIStyle>): UIElement;
+    createBar(id: string, value: number, anchor?: UIAnchor, pos?: Vec2, size?: {
+        width: number;
+        height: number;
+    }): UIElement;
+    createButton(id: string, text: string, action: string, anchor?: UIAnchor, pos?: Vec2): UIElement;
+    createPanel(id: string, anchor?: UIAnchor, pos?: Vec2, size?: {
+        width: number;
+        height: number;
+    }): UIElement;
+    render(ctx: CanvasRenderingContext2D): void;
+    private renderText;
+    private renderBar;
+    private renderButton;
+    private renderPanel;
+    private resolveAnchorPosition;
+}

package/dist/types/ui/index.d.ts

@@ -0,0 +1,2 @@
+export { GameUI } from './GameUI';
+export type { UIElement, UIStyle, UITheme, UIAnchor, UIElementType } from './GameUI';

package/dist/types/xr/ARVR.d.ts

@@ -0,0 +1,252 @@
+export type XRSessionMode = 'inline' | 'immersive-vr' | 'immersive-ar';
+export type XRReferenceSpaceType = 'viewer' | 'local' | 'local-floor' | 'bounded-floor' | 'unbounded';
+export interface XRSessionConfig {
+    mode: XRSessionMode;
+    referenceSpace: XRReferenceSpaceType;
+    requiredFeatures: string[];
+    optionalFeatures: string[];
+    frameRate?: number;
+    depthSensing?: boolean;
+    handTracking?: boolean;
+    hitTest?: boolean;
+    anchors?: boolean;
+    lightEstimation?: boolean;
+}
+export declare const VR_SESSION_DEFAULT: XRSessionConfig;
+export declare const AR_SESSION_DEFAULT: XRSessionConfig;
+export interface XRCapabilities {
+    vrSupported: boolean;
+    arSupported: boolean;
+    handTrackingSupported: boolean;
+    depthSensingSupported: boolean;
+    hitTestSupported: boolean;
+}
+export declare function detectXRCapabilities(): Promise<XRCapabilities>;
+export type XRHandedness = 'left' | 'right' | 'none';
+export type XRTargetRay = 'gaze' | 'tracked-pointer' | 'screen' | 'transient-pointer';
+export interface XRInputState {
+    handedness: XRHandedness;
+    targetRayMode: XRTargetRay;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    orientation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    buttons: XRButtonState[];
+    axes: number[];
+    gripPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    gripOrientation?: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+}
+export interface XRButtonState {
+    pressed: boolean;
+    touched: boolean;
+    value: number;
+}
+export interface XRControllerMapping {
+    trigger: number;
+    grip: number;
+    thumbstick: number;
+    trackpad?: number;
+    buttonA?: number;
+    buttonB?: number;
+    thumbstickPress?: number;
+}
+export declare const STANDARD_CONTROLLER_MAPPING: XRControllerMapping;
+export type HandJointName = 'wrist' | 'thumb-metacarpal' | 'thumb-phalanx-proximal' | 'thumb-phalanx-distal' | 'thumb-tip' | 'index-finger-metacarpal' | 'index-finger-phalanx-proximal' | 'index-finger-phalanx-intermediate' | 'index-finger-phalanx-distal' | 'index-finger-tip' | 'middle-finger-metacarpal' | 'middle-finger-phalanx-proximal' | 'middle-finger-phalanx-intermediate' | 'middle-finger-phalanx-distal' | 'middle-finger-tip' | 'ring-finger-metacarpal' | 'ring-finger-phalanx-proximal' | 'ring-finger-phalanx-intermediate' | 'ring-finger-phalanx-distal' | 'ring-finger-tip' | 'pinky-finger-metacarpal' | 'pinky-finger-phalanx-proximal' | 'pinky-finger-phalanx-intermediate' | 'pinky-finger-phalanx-distal' | 'pinky-finger-tip';
+export interface HandJointPose {
+    joint: HandJointName;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    orientation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    radius: number;
+}
+export interface HandGesture {
+    name: string;
+    detect(joints: Map<HandJointName, HandJointPose>): boolean;
+}
+export declare function createPinchGesture(threshold?: number): HandGesture;
+export declare function createGrabGesture(curlThreshold?: number): HandGesture;
+export interface ARHitResult {
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    orientation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    planeType?: 'horizontal' | 'vertical';
+    planeId?: string;
+}
+export interface ARAnchor {
+    id: string;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    orientation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    createdAt: number;
+    persistent: boolean;
+}
+export interface ARPlacementConfig {
+    snapToSurface: boolean;
+    alignToNormal: boolean;
+    gridSnap: number;
+    minScale: number;
+    maxScale: number;
+    defaultScale: number;
+    allowRotation: boolean;
+    rotationSnapDeg: number;
+    allowVertical: boolean;
+    shadowEnabled: boolean;
+}
+export declare const DEFAULT_AR_PLACEMENT: ARPlacementConfig;
+export declare function snapPlacement(hit: ARHitResult, config: ARPlacementConfig, currentRotationY: number): {
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotationY: number;
+};
+export interface LightEstimate {
+    primaryLightDirection: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    primaryLightIntensity: number;
+    sphericalHarmonics?: Float32Array;
+    ambientIntensity: number;
+    ambientColorTemperature: number;
+}
+export interface SpatialPanel {
+    id: string;
+    width: number;
+    height: number;
+    pixelsPerMeter: number;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    orientation: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    followGaze: boolean;
+    curved: boolean;
+    curveRadius?: number;
+    opacity: number;
+    interactable: boolean;
+    grabbable: boolean;
+}
+export declare function createSpatialPanel(id: string, partial?: Partial<SpatialPanel>): SpatialPanel;
+/** Billboard: rotate panel to face camera. */
+export declare function billboardToward(panelPos: {
+    x: number;
+    y: number;
+    z: number;
+}, cameraPos: {
+    x: number;
+    y: number;
+    z: number;
+}): {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+};
+export type PanoProjection = 'equirectangular' | 'cubemap';
+export type StereoMode = 'mono' | 'top-bottom' | 'side-by-side';
+export interface PanoVideoConfig {
+    src: string;
+    projection: PanoProjection;
+    stereo: StereoMode;
+    loop: boolean;
+    autoplay: boolean;
+    muted: boolean;
+    fov: number;
+    initialYaw: number;
+    initialPitch: number;
+    dragSensitivity: number;
+    gyroscope: boolean;
+}
+export declare const DEFAULT_PANO_CONFIG: Partial<PanoVideoConfig>;
+export interface VRGameConfig {
+    locomotion: VRLocomotion;
+    comfort: VRComfort;
+    interactionMode: 'controllers' | 'hands' | 'gaze' | 'hybrid';
+    seatedMode: boolean;
+    roomScale: boolean;
+    playAreaSize?: {
+        width: number;
+        depth: number;
+    };
+}
+export type VRLocomotion = 'teleport' | 'smooth' | 'arm-swing' | 'room-scale' | 'on-rails';
+export interface VRComfort {
+    vignette: boolean;
+    vignetteIntensity: number;
+    snapTurning: boolean;
+    snapAngleDeg: number;
+    smoothTurnSpeed: number;
+    heightAdjustment: boolean;
+    motionSicknessLevel: 'none' | 'low' | 'medium' | 'high';
+}
+export declare const DEFAULT_VR_COMFORT: VRComfort;
+export interface VRTeleportConfig {
+    maxDistance: number;
+    arcResolution: number;
+    validColor: string;
+    invalidColor: string;
+    hapticOnTeleport: boolean;
+    fadeTransition: boolean;
+    fadeDurationMs: number;
+}
+export declare const DEFAULT_VR_TELEPORT: VRTeleportConfig;
+export interface VRInteractionConfig {
+    grabDistance: number;
+    throwMultiplier: number;
+    hapticIntensity: number;
+    hapticDurationMs: number;
+    highlightColor: string;
+    laserPointer: boolean;
+    laserColor: string;
+    laserWidth: number;
+}
+export declare const DEFAULT_VR_INTERACTION: VRInteractionConfig;

package/dist/types/xr/index.d.ts

@@ -0,0 +1 @@
+export * from './ARVR';

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@nice2dev/game-engine",
+  "version": "0.1.0",
+  "description": "Nice2Dev Game Engine — No-code game engine and editor for React",
+  "author": "NiceToDev <contact@nicetodev.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/NiceToDev/NiceToDev.UI#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiceToDev/NiceToDev.UI.git",
+    "directory": "nice2dev-game-engine"
+  },
+  "bugs": {
+    "url": "https://github.com/NiceToDev/NiceToDev.UI/issues"
+  },
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./style.css": "./dist/nice2dev-game-engine.css"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "build": "npm run build:types && rollup -c",
+    "build:types": "tsc -p tsconfig.types.json",
+    "dev": "rollup -c -w",
+    "demo": "vite --config vite.demo.config.ts",
+    "demo:build": "vite build --config vite.demo.config.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react",
+    "game-engine",
+    "game-editor",
+    "no-code",
+    "visual-scripting",
+    "ecs",
+    "2d",
+    "gamepad",
+    "multiplayer",
+    "splitscreen",
+    "nicetodev"
+  ],
+  "peerDependencies": {
+    "@nice2dev/ui": "^1.0.0",
+    "@nice2dev/ui-graphics": "^1.0.0",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@microsoft/signalr": "^10.0.0",
+    "@rollup/plugin-commonjs": "^28.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-typescript": "^12.0.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "jsdom": "^29.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "rollup": "^4.24.0",
+    "rollup-plugin-postcss": "^4.0.2",
+    "tslib": "^2.7.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0",
+    "vitest": "^4.1.0"
+  }
+}