@zylem/game-lib 0.6.3 → 0.7.0

package/dist/debug.d.ts

@@ -0,0 +1,24 @@
+import { G as GameEntity } from './entity-DNkYKfdp.js';
+import 'three';
+import '@dimforge/rapier3d-compat';
+import './material-Wz83vTTp.js';
+import 'three/webgpu';
+import './base-node-life-cycle-CnJ-7zX-.js';
+import './events.js';
+import 'mitt';
+import '@zylem/behaviors/core';
+
+type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'none';
+interface DebugState {
+    enabled: boolean;
+    paused: boolean;
+    tool: DebugTools;
+    selectedEntity: GameEntity<any> | null;
+    hoveredEntity: GameEntity<any> | null;
+    flags: Set<string>;
+}
+declare const debugState: DebugState;
+declare function setPaused(paused: boolean): void;
+declare function setDebugTool(tool: DebugTools): void;
+
+export { type DebugTools, debugState, setDebugTool, setPaused };

package/dist/debug.js

@@ -0,0 +1 @@
+import{a as e,c as o,e as t}from"./chunk-CDPY4VOQ.js";export{e as debugState,t as setDebugTool,o as setPaused};

package/dist/default-controls-BGc61yYl.d.ts

@@ -0,0 +1,111 @@
+import { I as InputPlayer } from './base-node-life-cycle-CnJ-7zX-.js';
+import { a as VirtualTouchButtonSlot, V as VirtualTouchConfig, G as GameInputConfig } from './game-interfaces-tfpM5NBk.js';
+
+/**
+ * Color tokens consumed by the SVG factories in `svg-assets.ts` and the
+ * `defaultTouchControls(...)` preset. All fields are CSS color strings; the
+ * factories compose them into static SVG markup.
+ */
+interface TouchTheme {
+    /** Inner fill of joystick base & button bodies (usually translucent dark). */
+    baseFill: string;
+    /** Outer ring stroke on joystick base. */
+    joystickStroke: string;
+    /** Inner ring stroke on joystick base (subtle highlight). */
+    joystickInnerStroke: string;
+    /** Inner ring fill on joystick base (translucent accent). */
+    joystickAccentFill: string;
+    /** Direction tab fill on the joystick base (the four arrows). */
+    joystickTabFill: string;
+    /** Filled joystick thumb color. */
+    thumbFill: string;
+    /** Joystick thumb border. */
+    thumbStroke: string;
+    /** Inner highlight ring on the thumb. */
+    thumbInnerFill: string;
+    /** Stroke/text accent for buttons when no per-slot accent is provided. */
+    defaultButtonAccent: string;
+    /** Optional per-button accent overrides. */
+    buttonAccents?: Partial<Record<VirtualTouchButtonSlot, string>>;
+}
+/**
+ * Built-in named themes. Pass a key (e.g. `'lagoon'`) anywhere a `TouchTheme`
+ * is accepted. Use {@link resolveTouchTheme} to turn a key or partial input
+ * into a fully-populated theme.
+ */
+declare const touchThemes: {
+    readonly default: TouchTheme;
+    readonly lagoon: TouchTheme;
+};
+type TouchThemeName = keyof typeof touchThemes;
+/**
+ * Normalize a theme input to a fully populated {@link TouchTheme}.
+ *
+ * @param input  Either a built-in theme name (e.g. `'lagoon'`) or a
+ *               full `TouchTheme` object. When omitted, returns the
+ *               `'default'` theme.
+ */
+declare function resolveTouchTheme(input?: TouchTheme | TouchThemeName): TouchTheme;
+/**
+ * Returns the theme accent for a given button slot. Per-slot overrides win
+ * over `theme.defaultButtonAccent`; a caller-provided `accentOverride`
+ * trumps everything.
+ */
+declare function resolveButtonAccent(theme: TouchTheme, slot: VirtualTouchButtonSlot, accentOverride?: string): string;
+
+type JoystickSelection = 'left' | 'right' | 'both' | 'none';
+interface DefaultTouchControlsOptions {
+    /**
+     * Controls whether the touch UI mounts. `'auto'` (default) lets the
+     * provider show controls only on touch/mobile devices. `true` forces it
+     * on (useful for testing on desktop), `false` disables the UI entirely.
+     */
+    enabled?: boolean | 'auto';
+    /** Theme name (`'default'` / `'lagoon'`) or a custom {@link TouchTheme}. */
+    theme?: TouchTheme | TouchThemeName;
+    /**
+     * Buttons to render. Default `['A', 'B']`. Buttons not listed here are
+     * disabled. Pass `[]` to render no buttons.
+     */
+    buttons?: VirtualTouchButtonSlot[];
+    /** Per-button accent color overrides (override theme `buttonAccents`). */
+    buttonAccents?: Partial<Record<VirtualTouchButtonSlot, string>>;
+    /** Custom labels for buttons (default uses the slot name, e.g. `'A'`). */
+    buttonLabels?: Partial<Record<VirtualTouchButtonSlot, string>>;
+    /**
+     * Which joysticks to render. Default `'left'`.
+     *  - `'left'`  : analog left only
+     *  - `'right'` : analog right only
+     *  - `'both'`  : both sticks
+     *  - `'none'`  : disable all joysticks
+     */
+    joysticks?: JoystickSelection;
+    /**
+     * Escape hatch — a raw {@link VirtualTouchConfig} merged on top of the
+     * generated config. Use this when you need fine-grained tweaks
+     * (custom positions, sizes, raw SVG) without reaching for the lower-level
+     * `useVirtualControls(...)` preset.
+     */
+    override?: VirtualTouchConfig;
+}
+/**
+ * Builds a ready-to-use {@link GameInputConfig} that wires up themed
+ * virtual touch controls for a player. Internally composes
+ * {@link useVirtualControls} with theme-aware SVGs from `svg-assets.ts`.
+ *
+ * On desktop runtimes the provider stays dormant (with the default
+ * `enabled: 'auto'`), so it's safe to add this to any game's input
+ * configuration unconditionally.
+ *
+ * @example
+ * stage.setInputConfiguration(
+ *   defaultTouchControls('p1', {
+ *     theme: 'lagoon',
+ *     joysticks: 'left',
+ *     buttons: ['A', 'B'],
+ *   }),
+ * );
+ */
+declare function defaultTouchControls(player?: InputPlayer, options?: DefaultTouchControlsOptions): GameInputConfig;
+
+export { type DefaultTouchControlsOptions as D, type JoystickSelection as J, type TouchTheme as T, type TouchThemeName as a, resolveButtonAccent as b, defaultTouchControls as d, resolveTouchTheme as r, touchThemes as t };