@zylem/game-lib 0.6.4 → 0.8.0

package/dist/debug-state-BPT6jEog.d.ts

@@ -0,0 +1,17 @@
+import { G as GameEntity } from './entity-BdSI8CL3.js';
+
+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;
+declare function setSelectedEntity(entity: GameEntity<any> | null): void;
+
+export { type DebugTools as D, setPaused as a, setSelectedEntity as b, debugState as d, setDebugTool as s };

package/dist/debug.d.ts

@@ -0,0 +1,76 @@
+export { D as DebugTools, d as debugState, s as setDebugTool, a as setPaused, b as setSelectedEntity } from './debug-state-BPT6jEog.js';
+import { Object3D, Vector3 } from 'three';
+import { G as GameEntity } from './entity-BdSI8CL3.js';
+import { WebGPURenderer } from 'three/webgpu';
+import '@zylem/behaviors/core';
+import './vector-CiSHbivc.js';
+import './material-9vJ6SZaI.js';
+import './collision-builder-jF-toPIl.js';
+import './base-node-life-cycle-D2NuN1VB.js';
+import './stage-transition-CmGpV4tc.js';
+import './events.js';
+import 'mitt';
+
+/**
+ * Context registered by the active stage so the editor can focus entities
+ * without importing stage internals.
+ */
+interface EntityFocusContext {
+    /** Resolve a live entity by UUID from the current stage. */
+    resolveEntity(uuid: string): GameEntity<any> | null;
+    /** Frame the debug camera on an Object3D (group/mesh). */
+    frameObject(object: Object3D): void;
+    /** Ensure debugMap / orbit wiring is ready (e.g. enable debug visuals). */
+    ensureDebugReady?(): void;
+}
+/**
+ * Register the active stage's focus context. Returns an unregister function.
+ */
+declare function registerEntityFocusContext(context: EntityFocusContext): () => void;
+/**
+ * Select an entity by UUID and frame the debug camera to fit it.
+ * Enables debug mode so orbit controls are active.
+ *
+ * @returns true if the entity was found and framed
+ */
+declare function focusEntity(uuid: string): boolean;
+
+interface ObjectBounds {
+    width: number;
+    height: number;
+    depth: number;
+    center: Vector3;
+    maxDim: number;
+}
+
+interface EntityThumbnailResult {
+    dataUrl: string;
+    bounds: Pick<ObjectBounds, 'width' | 'height' | 'depth'>;
+}
+interface EntityThumbnailCacheEntry extends EntityThumbnailResult {
+    uuid: string;
+}
+/**
+ * Generates and caches entity thumbnail previews for the editor entity list.
+ * Renders a cloned Object3D into an offscreen RenderTarget on the shared WebGPU renderer.
+ */
+declare class EntityThumbnailCache {
+    private cache;
+    private inFlight;
+    private renderer;
+    private size;
+    constructor(size?: number);
+    setRenderer(renderer: WebGPURenderer | null): void;
+    get(uuid: string): EntityThumbnailCacheEntry | null;
+    invalidate(uuid: string): void;
+    clear(): void;
+    /**
+     * Return a cached thumbnail or generate one asynchronously.
+     */
+    ensure(uuid: string, object: Object3D | null | undefined): Promise<EntityThumbnailCacheEntry | null>;
+    private render;
+}
+/** Shared cache used by the running game to feed editor entity payloads. */
+declare const entityThumbnailCache: EntityThumbnailCache;
+
+export { type EntityFocusContext, EntityThumbnailCache, type EntityThumbnailCacheEntry, type EntityThumbnailResult, entityThumbnailCache, focusEntity, registerEntityFocusContext };

package/dist/debug.js

@@ -0,0 +1 @@
+import"./chunk-DFLI7ICU.js";import{a as e,b as f}from"./chunk-COM6HJ2L.js";import{c as g,d as h}from"./chunk-VS2D4B3W.js";import{a,c as b,e as c,f as d}from"./chunk-JQKS42G4.js";export{e as EntityThumbnailCache,a as debugState,f as entityThumbnailCache,h as focusEntity,g as registerEntityFocusContext,c as setDebugTool,b as setPaused,d as setSelectedEntity};

package/dist/default-controls-0-vCnli7.d.ts

@@ -0,0 +1,111 @@
+import { b as InputPlayer } from './base-node-life-cycle-D2NuN1VB.js';
+import { d as VirtualTouchButtonSlot, e as VirtualTouchConfig, G as GameInputConfig } from './game-interfaces-mchNYSZE.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, resolveButtonAccent as a, type TouchThemeName as b, defaultTouchControls as d, resolveTouchTheme as r, touchThemes as t };