@gorilla-engine-sdk/gorilla-engine-react 1.6.1

package/dist/nativeWrappers/GEToggle.d.ts

@@ -0,0 +1,18 @@
+import { GEComponent } from './common/GEComponent';
+import { ClickableHandlers } from './common/clickableHandlerMappings';
+import { ReactElementProps } from './common/ReactElementProps';
+/**
+ * Props for {@link GEToggle}.
+ * Combines native ToggleProps with React element props, click handlers, and a value change callback.
+ * @property onChange - Fires when the toggle value changes (maps to native `value` event).
+ */
+export declare type GEToggleProps = GorillaEngine.UI.ToggleProps & ReactElementProps & ClickableHandlers & {
+    onChange?: (value: boolean) => void;
+};
+/**
+ * Wraps the native `GorillaEngine.UI.Toggle` component.
+ * Maps `onChange` to the native `value` event. Supports clickable handler mappings.
+ */
+export declare class GEToggle extends GEComponent<GorillaEngine.UI.Toggle> {
+    constructor(props: GEToggleProps);
+}

package/dist/nativeWrappers/GEToggle.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEToggle = void 0;
+const GEComponent_1 = require("./common/GEComponent");
+const clickableHandlerMappings_1 = require("./common/clickableHandlerMappings");
+/**
+ * Wraps the native `GorillaEngine.UI.Toggle` component.
+ * Maps `onChange` to the native `value` event. Supports clickable handler mappings.
+ */
+class GEToggle extends GEComponent_1.GEComponent {
+    constructor(props) {
+        super(GorillaEngine.UI.Toggle, props, { ...clickableHandlerMappings_1.clickableHandlerMappings, onChange: 'value' });
+    }
+}
+exports.GEToggle = GEToggle;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0VUb2dnbGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbmF0aXZlV3JhcHBlcnMvR0VUb2dnbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBRUEsc0RBQW1EO0FBQ25ELGdGQUFnRztBQWFoRzs7O0dBR0c7QUFDSCxNQUFhLFFBQVMsU0FBUSx5QkFBb0M7SUFDaEUsWUFBWSxLQUFvQjtRQUM5QixLQUFLLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsS0FBSyxFQUFFLEVBQUUsR0FBRyxtREFBd0IsRUFBRSxRQUFRLEVBQUUsT0FBTyxFQUFDLENBQUMsQ0FBQztJQUMzRixDQUFDO0NBQ0Y7QUFKRCw0QkFJQyJ9

package/dist/nativeWrappers/GEWaveform.d.ts

@@ -0,0 +1,17 @@
+import { ReactElementProps } from './common/ReactElementProps';
+import { GEComponent } from './common/GEComponent';
+/**
+ * Props for {@link GEWaveform}, combining native WaveformProps with React element props
+ * and a custom drag-zone position change handler.
+ */
+export type GEWaveformProps = GorillaEngine.UI.WaveformProps & ReactElementProps & {
+    /** Handler called when the drag-zone position changes. Mapped to the native `dragzonePosition` event. */
+    onDragzonePositionChanged?: any;
+};
+/**
+ * React wrapper for the native {@link GorillaEngine.UI.Waveform} component.
+ * Maps `onDragzonePositionChanged` to the native `dragzonePosition` event.
+ */
+export declare class GEWaveform extends GEComponent<GorillaEngine.UI.Waveform> {
+    constructor(props: GEWaveformProps);
+}

package/dist/nativeWrappers/GEWaveform.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEWaveform = void 0;
+const GEComponent_1 = require("./common/GEComponent");
+/**
+ * React wrapper for the native {@link GorillaEngine.UI.Waveform} component.
+ * Maps `onDragzonePositionChanged` to the native `dragzonePosition` event.
+ */
+class GEWaveform extends GEComponent_1.GEComponent {
+    constructor(props) {
+        super(GorillaEngine.UI.Waveform, props, {
+            onDragzonePositionChanged: 'dragzonePosition'
+        });
+    }
+}
+exports.GEWaveform = GEWaveform;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0VXYXZlZm9ybS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9uYXRpdmVXcmFwcGVycy9HRVdhdmVmb3JtLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUVBLHNEQUFtRDtBQVduRDs7O0dBR0c7QUFDSCxNQUFhLFVBQVcsU0FBUSx5QkFBc0M7SUFDcEUsWUFBWSxLQUFzQjtRQUNoQyxLQUFLLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQyxRQUFRLEVBQUUsS0FBSyxFQUFDO1lBQ3JDLHlCQUF5QixFQUFFLGtCQUFrQjtTQUM5QyxDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0Y7QUFORCxnQ0FNQyJ9

package/dist/nativeWrappers/GEXYPad.d.ts

@@ -0,0 +1,16 @@
+import { ReactElementProps } from './common/ReactElementProps';
+import { GEComponent } from './common/GEComponent';
+import { ClickableHandlers } from './common/clickableHandlerMappings';
+/**
+ * Props for the {@link GEXYPad} component.
+ * Combines native XYPad props with React element props and clickable handlers.
+ */
+export type GEXYPadProps = GorillaEngine.UI.XYPadProps & ReactElementProps & ClickableHandlers;
+/**
+ * React wrapper for the Gorilla Engine XYPad component.
+ * Provides a 2D control surface for adjusting two parameters simultaneously.
+ */
+export declare class GEXYPad extends GEComponent<GorillaEngine.UI.XYPad> {
+    /** @param props - Partial XY pad configuration and click handlers. */
+    constructor(props: Partial<GEXYPadProps>);
+}

package/dist/nativeWrappers/GEXYPad.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEXYPad = void 0;
+const GEComponent_1 = require("./common/GEComponent");
+const clickableHandlerMappings_1 = require("./common/clickableHandlerMappings");
+/**
+ * React wrapper for the Gorilla Engine XYPad component.
+ * Provides a 2D control surface for adjusting two parameters simultaneously.
+ */
+class GEXYPad extends GEComponent_1.GEComponent {
+    /** @param props - Partial XY pad configuration and click handlers. */
+    constructor(props) {
+        super(GorillaEngine.UI.XYPad, props, clickableHandlerMappings_1.clickableHandlerMappings);
+    }
+}
+exports.GEXYPad = GEXYPad;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0VYWVBhZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9uYXRpdmVXcmFwcGVycy9HRVhZUGFkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLHNEQUFtRDtBQUNuRCxnRkFBZ0c7QUFRaEc7OztHQUdHO0FBQ0gsTUFBYSxPQUFRLFNBQVEseUJBQW1DO0lBQzlELHNFQUFzRTtJQUN0RSxZQUFZLEtBQTRCO1FBQ3RDLEtBQUssQ0FBQyxhQUFhLENBQUMsRUFBRSxDQUFDLEtBQUssRUFBRSxLQUFLLEVBQUUsbURBQXdCLENBQUMsQ0FBQztJQUNqRSxDQUFDO0NBQ0Y7QUFMRCwwQkFLQyJ9

package/dist/nativeWrappers/common/GEComponent.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Describes a mapping between a React event handler prop and its native Gorilla Engine event name.
+ */
+interface ComponentEvent {
+    /** The React-side prop name (e.g. `onClick`). */
+    geReactName: any;
+    /** The corresponding native Gorilla Engine event name (e.g. `click`). */
+    nativeName: any;
+    /** The callback function provided via React props. */
+    handler?: any;
+}
+/**
+ * Base wrapper class that bridges a React component to a native Gorilla Engine UI component.
+ *
+ * Responsibilities:
+ * - Instantiates the native handle from React props, expanding binding syntax
+ *   (e.g. `{ bindings: { x: 'vm.x' } }` becomes `{ 'x&': 'vm.x' }`).
+ * - Manages a list of child components.
+ * - Maps React event handler prop names to native event names and wires them up.
+ * - Provides `prepareUpdate` / `commitUpdate` for the React reconciler diff cycle.
+ *
+ * @typeParam T - The specific `GorillaEngine.UI.Component` subtype this wrapper manages.
+ */
+export declare class GEComponent<T extends GorillaEngine.UI.Component> {
+    /** The underlying native Gorilla Engine component instance. */
+    _nativeHandle: T;
+    /** Ordered list of child wrapper components. */
+    children: GEComponent<any>[];
+    /** Whether debug logging is enabled for this component. */
+    loggingEnabled: boolean;
+    /** Map of React event prop names to their {@link ComponentEvent} descriptors. */
+    events: {
+        [key: string]: ComponentEvent;
+    };
+    /** The native constructor function used to create the handle (e.g. `GorillaEngine.UI.Label`). */
+    nativeCtor: any;
+    /** The React `key` prop associated with this component instance. */
+    reactKey: any;
+    /** The unique identifier of the underlying native component. */
+    get id(): string;
+    /** The underlying native Gorilla Engine component instance. */
+    get nativeHandle(): T;
+    /**
+     * Creates a new GEComponent, instantiating the native handle and wiring up event handlers.
+     *
+     * @param nativeCtor - The native Gorilla Engine constructor (e.g. `GorillaEngine.UI.Slider`).
+     * @param props - The React element props, including bindings and event handlers.
+     * @param handlerMappings - A map of React event prop names to native event names
+     *   (e.g. `{ onClick: 'click' }`).
+     */
+    constructor(nativeCtor: any, props: any, handlerMappings?: {});
+    /**
+     * Creates the native Gorilla Engine component instance from the given props.
+     *
+     * Expands binding syntax at both the top level and within nested object props,
+     * converting `{ bindings: { prop: 'path' } }` into `{ 'prop&': 'path' }`.
+     * Skips React-internal props (`children`, `ref`, `key`) and undefined values.
+     *
+     * @param ctor - The native constructor function.
+     * @param externalProps - The processed React props (with event handlers already removed).
+     * @returns A new native component instance with a generated id.
+     */
+    private createNativeHandle;
+    /**
+     * Appends a child component to this component's native handle and internal child list.
+     * @param child - The child wrapper to append.
+     */
+    appendChild(child: GEComponent<any>): void;
+    /**
+     * Removes a child component from this component's native handle and internal child list.
+     * @param child - The child wrapper to remove.
+     */
+    removeChild(child: GEComponent<any>): void;
+    /**
+     * Inserts a child component before another child in both the native handle and internal list.
+     * @param child - The child wrapper to insert.
+     * @param beforeChild - The existing child to insert before.
+     */
+    insertBefore(child: GEComponent<any>, beforeChild: GEComponent<any>): void;
+    /**
+     * Diffs previous and next props to produce an update payload for the React reconciler.
+     *
+     * @param prevProps - The previous set of props.
+     * @param nextProps - The incoming set of props.
+     * @returns An object containing only the changed key/value pairs, or `null` if nothing changed.
+     */
+    prepareUpdate(prevProps: any, nextProps: any): any;
+    /**
+     * Applies a previously prepared update payload to the native handle.
+     *
+     * Processes changes in three categories:
+     * 1. Event handlers -- updates the stored callback reference.
+     * 2. Bindings -- delegates to the native `setBindings` method when available.
+     * 3. Regular props -- recursively assigns values to the native handle.
+     *
+     * @param updatePayload - The changed props object produced by {@link prepareUpdate}.
+     */
+    commitUpdate(updatePayload: any): void;
+    /** Shortcut to the global Gorilla Engine logger. */
+    get log(): import("../../instance").Logger;
+    /** Returns a formatted string of all native handle properties for debugging. */
+    get propsString(): string;
+}
+export {};

package/dist/nativeWrappers/common/GEComponent.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEComponent = void 0;
+const instance_1 = require("../../instance");
+const node_util_1 = require("node:util");
+/**
+ * Base wrapper class that bridges a React component to a native Gorilla Engine UI component.
+ *
+ * Responsibilities:
+ * - Instantiates the native handle from React props, expanding binding syntax
+ *   (e.g. `{ bindings: { x: 'vm.x' } }` becomes `{ 'x&': 'vm.x' }`).
+ * - Manages a list of child components.
+ * - Maps React event handler prop names to native event names and wires them up.
+ * - Provides `prepareUpdate` / `commitUpdate` for the React reconciler diff cycle.
+ *
+ * @typeParam T - The specific `GorillaEngine.UI.Component` subtype this wrapper manages.
+ */
+class GEComponent {
+    /** The underlying native Gorilla Engine component instance. */
+    _nativeHandle;
+    /** Ordered list of child wrapper components. */
+    children = [];
+    /** Whether debug logging is enabled for this component. */
+    loggingEnabled = false;
+    /** Map of React event prop names to their {@link ComponentEvent} descriptors. */
+    events = {};
+    /** The native constructor function used to create the handle (e.g. `GorillaEngine.UI.Label`). */
+    nativeCtor;
+    /** The React `key` prop associated with this component instance. */
+    reactKey;
+    /** The unique identifier of the underlying native component. */
+    get id() {
+        return this.nativeHandle.id;
+    }
+    /** The underlying native Gorilla Engine component instance. */
+    get nativeHandle() {
+        return this._nativeHandle;
+    }
+    /**
+     * Creates a new GEComponent, instantiating the native handle and wiring up event handlers.
+     *
+     * @param nativeCtor - The native Gorilla Engine constructor (e.g. `GorillaEngine.UI.Slider`).
+     * @param props - The React element props, including bindings and event handlers.
+     * @param handlerMappings - A map of React event prop names to native event names
+     *   (e.g. `{ onClick: 'click' }`).
+     */
+    constructor(nativeCtor, props, handlerMappings = {}) {
+        this.nativeCtor = nativeCtor;
+        const propsWithoutEvents = {};
+        for (const key in props) {
+            if (!(key in handlerMappings)) {
+                propsWithoutEvents[key] = props[key];
+            }
+            else {
+                this.events[key] = {
+                    geReactName: key,
+                    nativeName: handlerMappings[key],
+                    handler: props[key]
+                };
+            }
+        }
+        this._nativeHandle = this.createNativeHandle(nativeCtor, propsWithoutEvents);
+        const handleEvent = (key, eventArg) => {
+            const event = this.events[key];
+            if (event.handler) {
+                event.handler(eventArg);
+            }
+        };
+        try {
+            for (const key in this.events) {
+                this._nativeHandle.on(this.events[key].nativeName, e => handleEvent(key, e));
+            }
+        }
+        catch (e) {
+            instance_1.instance.log.error('error setting event handler', e);
+        }
+    }
+    /**
+     * Creates the native Gorilla Engine component instance from the given props.
+     *
+     * Expands binding syntax at both the top level and within nested object props,
+     * converting `{ bindings: { prop: 'path' } }` into `{ 'prop&': 'path' }`.
+     * Skips React-internal props (`children`, `ref`, `key`) and undefined values.
+     *
+     * @param ctor - The native constructor function.
+     * @param externalProps - The processed React props (with event handlers already removed).
+     * @returns A new native component instance with a generated id.
+     */
+    createNativeHandle(ctor, externalProps) {
+        const props = {};
+        for (const key in externalProps) {
+            if (key === 'bindings') {
+                for (const bindingKey in externalProps.bindings) {
+                    props[bindingKey + '&'] = externalProps.bindings[bindingKey];
+                }
+            }
+            else if (key === 'children' || key === 'ref' || key === 'key') {
+                //ignore
+            }
+            else if (externalProps[key] !== undefined) { // avoid undefined values
+                props[key] = externalProps[key];
+                if (externalProps[key] !== null && typeof externalProps[key] === 'object' &&
+                    'bindings' in externalProps[key]) {
+                    for (const bindingKey in externalProps[key].bindings) {
+                        instance_1.instance.log.info('add sub binding', key, bindingKey + '&', externalProps[key].bindings[bindingKey]);
+                        props[key][bindingKey + '&'] = externalProps[key].bindings[bindingKey];
+                    }
+                }
+            }
+        }
+        // This calls e.g. new GorillaEngine.UI.Label({ ... }) and therefore the C++ constructor
+        return new ctor({
+            id: `${Math.random() * 1e6}-` + ctor.name,
+            ...props
+        });
+    }
+    /**
+     * Appends a child component to this component's native handle and internal child list.
+     * @param child - The child wrapper to append.
+     */
+    appendChild(child) {
+        this.nativeHandle.appendChild(child.nativeHandle);
+        this.children.push(child);
+    }
+    /**
+     * Removes a child component from this component's native handle and internal child list.
+     * @param child - The child wrapper to remove.
+     */
+    removeChild(child) {
+        this.nativeHandle.removeChild(child.nativeHandle);
+        this.children = this.children.filter(c => c !== child);
+    }
+    /**
+     * Inserts a child component before another child in both the native handle and internal list.
+     * @param child - The child wrapper to insert.
+     * @param beforeChild - The existing child to insert before.
+     */
+    insertBefore(child, beforeChild) {
+        this.nativeHandle.insertBefore(child.nativeHandle, beforeChild.nativeHandle);
+        this.children.splice(this.children.findIndex(c => c === beforeChild), 0, child);
+    }
+    /**
+     * Diffs previous and next props to produce an update payload for the React reconciler.
+     *
+     * @param prevProps - The previous set of props.
+     * @param nextProps - The incoming set of props.
+     * @returns An object containing only the changed key/value pairs, or `null` if nothing changed.
+     */
+    prepareUpdate(prevProps, nextProps) {
+        const changedKeys = Array.from(new Set(Object.keys(nextProps).concat(Object.keys(prevProps))))
+            .filter(key => key !== 'children' && nextProps[key] !== undefined)
+            .filter(key => !(0, node_util_1.isDeepStrictEqual)(prevProps[key], nextProps[key]));
+        if (!changedKeys.length) {
+            return null;
+        }
+        else {
+            return changedKeys.reduce((acc, key) => Object.assign(acc, { [key]: nextProps[key] }), {});
+        }
+    }
+    /**
+     * Applies a previously prepared update payload to the native handle.
+     *
+     * Processes changes in three categories:
+     * 1. Event handlers -- updates the stored callback reference.
+     * 2. Bindings -- delegates to the native `setBindings` method when available.
+     * 3. Regular props -- recursively assigns values to the native handle.
+     *
+     * @param updatePayload - The changed props object produced by {@link prepareUpdate}.
+     */
+    commitUpdate(updatePayload) {
+        const props = [];
+        let bindings;
+        // event handlers first
+        for (const [k, v] of Object.entries(updatePayload)) {
+            if (k in this.events) {
+                this.events[k].handler = v;
+            }
+            else if (k === 'bindings') {
+                bindings = v;
+            }
+            else {
+                props.push([k, v]);
+            }
+        }
+        if (bindings) {
+            if ('setBindings' in this.nativeHandle) {
+                this.nativeHandle.setBindings(bindings);
+            }
+            else {
+                instance_1.instance.log.info('Binding updates not supported in the version of ge-shell.');
+            }
+        }
+        const assignPropValue = (target, k, v) => {
+            if (!Array.isArray(v) && typeof v === 'object') {
+                for (const subkey in v) {
+                    try {
+                        assignPropValue(target[k], subkey, v[subkey]);
+                    }
+                    catch (e) {
+                        instance_1.instance.log.info('error assigning prop', e);
+                    }
+                }
+            }
+            else {
+                target[k] = v;
+            }
+        };
+        for (const [k, v] of props) {
+            assignPropValue(this.nativeHandle, k, v);
+        }
+    }
+    /** Shortcut to the global Gorilla Engine logger. */
+    get log() {
+        return instance_1.instance.log;
+    }
+    /** Returns a formatted string of all native handle properties for debugging. */
+    get propsString() {
+        let out = '';
+        for (const key in this.nativeHandle) {
+            out += key + '=' + this.nativeHandle[key] + '\n';
+        }
+        return out;
+    }
+}
+exports.GEComponent = GEComponent;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0VDb21wb25lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbmF0aXZlV3JhcHBlcnMvY29tbW9uL0dFQ29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZDQUEwQztBQUMxQyx5Q0FBOEM7QUFjOUM7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFhLFdBQVc7SUFFdEIsK0RBQStEO0lBQy9ELGFBQWEsQ0FBSTtJQUNqQixnREFBZ0Q7SUFDaEQsUUFBUSxHQUF1QixFQUFFLENBQUM7SUFDbEMsMkRBQTJEO0lBQzNELGNBQWMsR0FBRyxLQUFLLENBQUM7SUFDdkIsaUZBQWlGO0lBQ2pGLE1BQU0sR0FBc0MsRUFBRSxDQUFBO0lBQzlDLGlHQUFpRztJQUNqRyxVQUFVLENBQUM7SUFDWCxvRUFBb0U7SUFDcEUsUUFBUSxDQUFDO0lBRVQsZ0VBQWdFO0lBQ2hFLElBQUksRUFBRTtRQUNKLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQyxFQUFFLENBQUM7SUFDOUIsQ0FBQztJQUVELCtEQUErRDtJQUMvRCxJQUFJLFlBQVk7UUFDZCxPQUFPLElBQUksQ0FBQyxhQUFhLENBQUE7SUFDM0IsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSCxZQUFZLFVBQVUsRUFBRSxLQUFLLEVBQUUsZUFBZSxHQUFHLEVBQUU7UUFFakQsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUM7UUFDN0IsTUFBTSxrQkFBa0IsR0FBRyxFQUFFLENBQUE7UUFDN0IsS0FBSyxNQUFNLEdBQUcsSUFBSSxLQUFLLEVBQUUsQ0FBQztZQUN4QixJQUFJLENBQUMsQ0FBQyxHQUFHLElBQUksZUFBZSxDQUFDLEVBQUUsQ0FBQztnQkFDOUIsa0JBQWtCLENBQUMsR0FBRyxDQUFDLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFBO1lBQ3RDLENBQUM7aUJBQU0sQ0FBQztnQkFDTixJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFH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

package/dist/nativeWrappers/common/ReactElementProps.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+/**
+ * Base props shared by all Gorilla Engine React elements.
+ *
+ * Extends the standard React intrinsic props (`key`, `children`, `ref`)
+ * with a `bindings` map for declarative view-model binding.
+ */
+export interface ReactElementProps {
+    /** React key for list reconciliation. */
+    key?: string | number;
+    /** Nested React child elements. */
+    children?: any;
+    /** React ref for accessing the underlying {@link GEComponent} wrapper. */
+    ref?: React.RefObject<any>;
+    /**
+     * Declarative bindings map. Keys are native property names and values are
+     * view-model paths (e.g. `{ value: 'vm.sliderValue' }`).
+     */
+    bindings?: any;
+}

package/dist/nativeWrappers/common/ReactElementProps.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmVhY3RFbGVtZW50UHJvcHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbmF0aXZlV3JhcHBlcnMvY29tbW9uL1JlYWN0RWxlbWVudFByb3BzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/nativeWrappers/common/clickableHandlerMappings.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Maps React click/mouse event handler prop names to their corresponding
+ * native Gorilla Engine event names.
+ *
+ * Used by {@link GEComponent} to wire React callbacks to native events.
+ */
+export declare const clickableHandlerMappings: {
+    onClick: string;
+    onClickWithInfo: string;
+    onDoubleClick: string;
+    onMouseUp: string;
+    onMouseDown: string;
+    onMouseDownWithInfo: string;
+    onMouseDrag: string;
+    onMouseEnter: string;
+    onMouseExit: string;
+};
+/**
+ * Optional React event handler props available on clickable Gorilla Engine components.
+ */
+export interface ClickableHandlers {
+    /** Fired on a single click. */
+    onClick: (args: any) => void;
+    /** Fired on click, providing additional hit-test info. */
+    onClickWithInfo: (args: any) => void;
+    /** Fired on a double click. */
+    onDoubleClick: (args: any) => void;
+    /** Fired when the mouse button is released. */
+    onMouseUp: (args: any) => void;
+    /** Fired when the mouse button is pressed. */
+    onMouseDown: (args: any) => void;
+    /** Fired when the mouse button is pressed, providing additional hit-test info. */
+    onMouseDownWithInfo: (args: any) => void;
+    /** Fired while the mouse is dragged over the component. */
+    onMouseDrag: (args: any) => void;
+    /** Fired when the mouse cursor enters the component bounds. */
+    onMouseEnter: (args: any) => void;
+    /** Fired when the mouse cursor exits the component bounds. */
+    onMouseExit: (args: any) => void;
+}

package/dist/nativeWrappers/common/clickableHandlerMappings.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickableHandlerMappings = void 0;
+/**
+ * Maps React click/mouse event handler prop names to their corresponding
+ * native Gorilla Engine event names.
+ *
+ * Used by {@link GEComponent} to wire React callbacks to native events.
+ */
+exports.clickableHandlerMappings = {
+    onClick: 'click',
+    onClickWithInfo: 'clickWithInfo',
+    onDoubleClick: 'doubleClick',
+    onMouseUp: 'mouseUp',
+    onMouseDown: 'mouseDown',
+    onMouseDownWithInfo: 'mouseDownWithInfo',
+    onMouseDrag: 'mouseDrag',
+    onMouseEnter: 'mouseEnter',
+    onMouseExit: 'mouseExit',
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpY2thYmxlSGFuZGxlck1hcHBpbmdzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL25hdGl2ZVdyYXBwZXJzL2NvbW1vbi9jbGlja2FibGVIYW5kbGVyTWFwcGluZ3MudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUE7Ozs7O0dBS0c7QUFDVSxRQUFBLHdCQUF3QixHQUFHO0lBQ3RDLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLGVBQWUsRUFBRSxlQUFlO0lBQ2hDLGFBQWEsRUFBRSxhQUFhO0lBQzVCLFNBQVMsRUFBRSxTQUFTO0lBQ3BCLFdBQVcsRUFBRSxXQUFXO0lBQ3hCLG1CQUFtQixFQUFFLG1CQUFtQjtJQUN4QyxXQUFXLEVBQUUsV0FBVztJQUN4QixZQUFZLEVBQUUsWUFBWTtJQUMxQixXQUFXLEVBQUUsV0FBVztDQUN6QixDQUFDIn0=

package/dist/nativeWrappers/common/keyableHandlerMappings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Maps React keyboard event handler prop names to their corresponding
+ * native Gorilla Engine event names.
+ *
+ * Used by {@link GEComponent} to wire React callbacks to native events.
+ */
+export declare const keyableHandlerMappings: {
+    onKeyPressed: string;
+};
+/**
+ * Optional React event handler props available on keyboard-interactive Gorilla Engine components.
+ */
+export interface KeyableHandlers {
+    /** Fired when a key is pressed while the component has focus. */
+    onKeyPressed: (args: any) => void;
+}

package/dist/nativeWrappers/common/keyableHandlerMappings.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keyableHandlerMappings = void 0;
+/**
+ * Maps React keyboard event handler prop names to their corresponding
+ * native Gorilla Engine event names.
+ *
+ * Used by {@link GEComponent} to wire React callbacks to native events.
+ */
+exports.keyableHandlerMappings = {
+    onKeyPressed: 'keyPressed',
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia2V5YWJsZUhhbmRsZXJNYXBwaW5ncy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9uYXRpdmVXcmFwcGVycy9jb21tb24va2V5YWJsZUhhbmRsZXJNYXBwaW5ncy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7Ozs7R0FLRztBQUNVLFFBQUEsc0JBQXNCLEdBQUc7SUFDcEMsWUFBWSxFQUFFLFlBQVk7Q0FDM0IsQ0FBQyJ9

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@gorilla-engine-sdk/gorilla-engine-react",
+  "version": "1.6.1",
+  "description": "React bindings for Gorilla Engine, providing a simple and efficient way to create plugins using React.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "start": "npm run watch",
+    "build": "npx tsc --preserveWatchOutput",
+    "watch": "npx tsc-watch --preserveWatchOutput",
+    "prepack": "npm run build",
+    "test": "npx jest",
+    "docs": "npx typedoc ./src/index.ts --theme default --out ./docs",
+    "lint": "eslint src",
+    "ci:publish": "node ../../scripts/ci-publish.js"
+  },
+  "author": "UJAM Music Technology GmbH",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@types/gorilla-engine": "^1.1.33",
+    "@types/node": "^18.11.9",
+    "react-reconciler": "^0.33.0"
+  },
+  "devDependencies": {
+    "react": "^19.0.0",
+    "@eslint-react/eslint-plugin": "^5.8.10",
+    "@eslint/js": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.2.16",
+    "@types/react-reconciler": "^0.33.0",
+    "@typescript-eslint/eslint-plugin": "^8.60.1",
+    "@typescript-eslint/parser": "^8.60.1",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.6.0",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
+    "tsc-watch": "^7.2.0",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3"
+  },
+  "homepage": "https://www.gorilla-engine.com/",
+  "keywords": [
+    "gorilla-engine",
+    "UJAM"
+  ]
+}