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

package/dist/ComponentFactory.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const GELabel_1 = require("./nativeWrappers/GELabel");
+const GEButton_1 = require("./nativeWrappers/GEButton");
+const GETextBox_1 = require("./nativeWrappers/GETextBox");
+const GEScrollView_1 = require("./nativeWrappers/GEScrollView");
+const GEToggle_1 = require("./nativeWrappers/GEToggle");
+const GEComboBox_1 = require("./nativeWrappers/GEComboBox");
+const GECurve_1 = require("./nativeWrappers/GECurve");
+const GEMidiKeyboard_1 = require("./nativeWrappers/GEMidiKeyboard");
+const GEKnob_1 = require("./nativeWrappers/GEKnob");
+const GEPad_1 = require("./nativeWrappers/GEPad");
+const GESliceEditor_1 = require("./nativeWrappers/GESliceEditor");
+const GELevelMeter_1 = require("./nativeWrappers/GELevelMeter");
+const GEWaveform_1 = require("./nativeWrappers/GEWaveform");
+const GEAmpEnv_1 = require("./nativeWrappers/GEAmpEnv");
+const GEListBox_1 = require("./nativeWrappers/GEListBox");
+const GEBarStepEditor_1 = require("./nativeWrappers/GEBarStepEditor");
+const GEStepEditor_1 = require("./nativeWrappers/GEStepEditor");
+const GEDragContainer_1 = require("./nativeWrappers/GEDragContainer");
+const GEDropZone_1 = require("./nativeWrappers/GEDropZone");
+const GEDragTarget_1 = require("./nativeWrappers/GEDragTarget");
+const GELottieAnimation_1 = require("./nativeWrappers/GELottieAnimation");
+const GESlider_1 = require("./nativeWrappers/GESlider");
+const GEXYPad_1 = require("./nativeWrappers/GEXYPad");
+const GERubberband_1 = require("./nativeWrappers/GERubberband");
+const GETagBrowser_1 = require("./nativeWrappers/GETagBrowser");
+const GETagEditor_1 = require("./nativeWrappers/GETagEditor");
+const GEMappingEditor_1 = require("./nativeWrappers/GEMappingEditor");
+/**
+ * Factory that instantiates Gorilla Engine native component wrappers
+ * from JSX element type strings and props.
+ *
+ * Used by the reconciler's `createInstance` and `createTextInstance` hooks
+ * to translate React elements into native {@link GEComponent} instances.
+ */
+class ComponentFactory {
+    /**
+     * Creates a {@link GEComponent} wrapper for the given component type.
+     *
+     * @param type - The Gorilla Engine component type identifier (e.g., `'geKnob'`).
+     * @param newProps - Props to pass to the native component constructor.
+     * @returns A new `GEComponent` wrapping the corresponding native component.
+     * @throws If `type` is not a recognized {@link GEComponentType}.
+     */
+    static createComponent(type, newProps) {
+        switch (type) {
+            case 'geButton':
+                return new GEButton_1.GEButton({
+                    keyboardFocus: {
+                        color: '00FFFFFF',
+                    },
+                    ...newProps,
+                });
+            case 'geLabel':
+                return new GELabel_1.GELabel(newProps);
+            case 'geTextBox':
+                return new GETextBox_1.GETextBox(newProps);
+            case 'geScrollView':
+                return new GEScrollView_1.GEScrollView(newProps);
+            case 'geToggle':
+                return new GEToggle_1.GEToggle(newProps);
+            case 'geComboBox':
+                return new GEComboBox_1.GEComboBox(newProps);
+            case 'geCurve':
+                return new GECurve_1.GECurve(newProps);
+            case 'geMidiKeyboard':
+                return new GEMidiKeyboard_1.GEMidiKeyboard(newProps);
+            case 'geKnob':
+                return new GEKnob_1.GEKnob(newProps);
+            case 'geSlider':
+                return new GESlider_1.GESlider(newProps);
+            case 'gePad':
+                return new GEPad_1.GEPad({
+                    keyboardFocus: {
+                        color: '00FFFFFF',
+                    },
+                    ...newProps,
+                });
+            case 'geSliceEditor':
+                return new GESliceEditor_1.GESliceEditor(newProps);
+            case 'geLevelMeter':
+                return new GELevelMeter_1.GELevelMeter(newProps);
+            case 'geWaveform':
+                return new GEWaveform_1.GEWaveform(newProps);
+            case 'geAmpEnv':
+                return new GEAmpEnv_1.GEAmpEnv(newProps);
+            case 'geListBox':
+                return new GEListBox_1.GEListBox(newProps);
+            case 'geStepEditor':
+                return new GEStepEditor_1.GEStepEditor(newProps);
+            case 'geBarStepEditor':
+                return new GEBarStepEditor_1.GEBarStepEditor(newProps);
+            case 'geDragContainer':
+                return new GEDragContainer_1.GEDragContainer(newProps);
+            case 'geDragTarget':
+                return new GEDragTarget_1.GEDragTarget(newProps);
+            case 'geDropZone':
+                return new GEDropZone_1.GEDropZone(newProps);
+            case 'geLottieAnimation':
+                return new GELottieAnimation_1.GELottieAnimation(newProps);
+            case 'geXYPad':
+                return new GEXYPad_1.GEXYPad(newProps);
+            case 'geRubberband':
+                return new GERubberband_1.GERubberband(newProps);
+            case 'geTagBrowser':
+                return new GETagBrowser_1.GETagBrowser(newProps);
+            case 'geTagEditor':
+                return new GETagEditor_1.GETagEditor(newProps);
+            case 'geMappingEditor':
+                return new GEMappingEditor_1.GEMappingEditor(newProps);
+            default:
+                throw new Error(`Unknown component type ${type}`);
+        }
+    }
+}
+exports.default = ComponentFactory;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ29tcG9uZW50RmFjdG9yeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9Db21wb25lbnRGYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQ0Esc0RBQWlFO0FBQ2pFLHdEQUFvRTtBQUNwRSwwREFBdUU7QUFDdkUsZ0VBQWdGO0FBQ2hGLHdEQUFvRTtBQUNwRSw0REFBMEU7QUFDMUUsc0RBQWlFO0FBQ2pFLG9FQUFzRjtBQUN0RixvREFBOEQ7QUFDOUQsa0RBQTJEO0FBQzNELGtFQUFtRjtBQUNuRixnRUFBZ0Y7QUFDaEYsNERBQTBFO0FBQzFFLHdEQUFvRTtBQUNwRSwwREFBdUU7QUFDdkUsc0VBQXlGO0FBQ3pGLGdFQUFnRjtBQUNoRixzRUFBeUY7QUFDekYsNERBQTBFO0FBQzFFLGdFQUFnRjtBQUNoRiwwRUFBK0Y7QUFDL0Ysd0RBQW9FO0FBQ3BFLHNEQUFpRTtBQUNqRSxnRUFBZ0Y7QUFDaEYsZ0VBQWdGO0FBQ2hGLDhEQUE2RTtBQUM3RSxzRUFBeUY7QUFnTXpGOzs7Ozs7R0FNRztBQUNILE1BQU0sZ0JBQWdCO0lBQ3BCOzs7Ozs7O09BT0c7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUNwQixJQUFxQixFQUNyQixRQUFtQztRQUVuQyxRQUFRLElBQUksRUFBRSxDQUFDO1lBQ2IsS0FBSyxVQUFVO2dCQUNiLE9BQU8sSUFBSSxtQkFBUSxDQUFDO29CQUNsQixhQUFhLEVBQUU7d0JBQ2IsS0FBSyxFQUFFLFVBQVU7cUJBQ2xCO29CQUNELEdBQUcsUUFBUTtpQkFDSyxDQUFDLENBQUM7WUFDdEIsS0FBSyxTQUFTO2dCQUNaLE9BQU8sSUFBSSxpQkFBTyxDQUFDLFFBQXdCLENBQUMsQ0FBQztZQUMvQyxLQUFLLFdBQVc7Z0JBQ2QsT0FBTyxJQUFJLHFCQUFTLENBQUMsUUFBMEIsQ0FBQyxDQUFDO1lBQ25ELEtBQUssY0FBYztnQkFDakIsT0FBTyxJQUFJLDJCQUFZLENBQUMsUUFBNkIsQ0FBQyxDQUFDO1lBQ3pELEtB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

package/dist/GEReact.d.ts

@@ -0,0 +1,53 @@
+import * as React from 'react';
+import { GEComponent } from './nativeWrappers/common/GEComponent';
+import { Logger } from './instance';
+/**
+ * A Gorilla Engine native UI component extended with a cached reconciler container.
+ * The `_rootContainer` field is attached lazily by {@link render} on first mount.
+ */
+declare interface RootContainer extends GorillaEngine.UI.Component {
+    _rootContainer?: GEComponent<any>;
+}
+/**
+ * Renders a React element tree into a Gorilla Engine native container.
+ *
+ * Creates a reconciler root on the container if one does not already exist,
+ * then performs an update. This is the low-level entry point — most consumers
+ * should use {@link loadUI} or {@link createUI} instead.
+ *
+ * @param reactElement - The React element tree to render.
+ * @param container - A native Gorilla Engine UI component to render into.
+ * @param callback - Optional callback invoked after the render commits.
+ */
+export declare function render(reactElement: React.ReactNode, container: RootContainer, callback?: any): void;
+/**
+ * Loads a plugin UI from a YAML layout file and mounts a React tree into it.
+ *
+ * This is the standard entry point for plugins that define their root layout
+ * in YAML. The YAML is loaded via `GorillaEngine.UI.loadUIfromYAML`, and the
+ * React tree is rendered into the container identified by `rootNodeId`.
+ *
+ * @param app - The root React element to render.
+ * @param ymlPath - Path to the YAML layout file. Defaults to `<resourcePath>/<pluginName>.yaml`.
+ * @param rootNodeId - ID of the native container node in the YAML layout. Defaults to `'root'`.
+ * @param logger - Optional custom {@link Logger} to replace the default console logger.
+ */
+export declare function loadUI(app: React.ReactNode, ymlPath?: string | null, rootNodeId?: string, logger?: Logger): void;
+/**
+ * Creates a new native window and mounts a React tree into it.
+ *
+ * Use this instead of {@link loadUI} when no YAML layout is needed —
+ * the entire UI is built programmatically from React components.
+ *
+ * @param app - The root React element to render.
+ * @param width - Window width in pixels. Defaults to `1280`.
+ * @param height - Window height in pixels. Defaults to `760`.
+ * @param options - Optional settings:
+ *   - `rootNodeId` – ID assigned to the root window (defaults to `"root"`).
+ *   - `logger` – Custom {@link Logger} instance.
+ */
+export declare function createUI(app: React.ReactNode, width?: number, height?: number, options?: {
+    rootNodeId?: string;
+    logger?: Logger;
+}): void;
+export {};

package/dist/GEReact.js

@@ -0,0 +1,237 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render = render;
+exports.loadUI = loadUI;
+exports.createUI = createUI;
+const React = __importStar(require("react"));
+const ReactReconciler = __importStar(require("react-reconciler"));
+const path = __importStar(require("path"));
+const ComponentFactory_1 = __importDefault(require("./ComponentFactory"));
+const instance_1 = require("./instance");
+const Root_1 = require("./Root");
+const rootHostContext = {};
+const childHostContext = {};
+/**
+ * React Reconciler host config that maps React lifecycle operations
+ * (create, append, update, remove) to Gorilla Engine native UI components
+ * via {@link ComponentFactory} and {@link GEComponent}.
+ */
+const hostConfig = {
+    supportsMutation: true,
+    supportsPersistence: false,
+    supportsHydration: false,
+    noTimeout: -1,
+    isPrimaryRenderer: true,
+    getRootHostContext() {
+        return rootHostContext;
+    },
+    prepareForCommit() {
+        return null;
+    },
+    resetAfterCommit() { },
+    getChildHostContext() {
+        return childHostContext;
+    },
+    shouldSetTextContent(type, props) {
+        return false;
+    },
+    createInstance(type, newProps, rootContainerInstance, _currentHostContext, workInProgress) {
+        return ComponentFactory_1.default.createComponent(type, newProps);
+    },
+    createTextInstance(text, rootContainerInstance, hostContext, internalInstanceHandle) {
+        return ComponentFactory_1.default.createComponent('geLabel', { text });
+    },
+    appendInitialChild(parentInstance, child) {
+        parentInstance.appendChild(child);
+    },
+    appendChild(parentInstance, child) {
+        parentInstance.appendChild(child);
+    },
+    finalizeInitialChildren(instance, type, props, rootContainer, hostContext) {
+        return false;
+    },
+    appendChildToContainer(container, child) {
+        container.appendChild(child.nativeHandle);
+    },
+    commitUpdate(instance, type, prevProps, nextProps, internalHandle) {
+        const updatePayload = instance.prepareUpdate(prevProps, nextProps);
+        if (updatePayload) {
+            instance.commitUpdate(updatePayload);
+        }
+    },
+    commitTextUpdate(textInstance, oldText, newText) {
+        textInstance.commitUpdate(textInstance.prepareUpdate({ text: oldText }, { text: newText }));
+    },
+    removeChild(parentInstance, child) {
+        parentInstance.removeChild(child);
+    },
+    removeChildFromContainer(container, child) {
+        container.removeChild(child.nativeHandle);
+    },
+    clearContainer(container) {
+        while (container.children.length) {
+            container.removeChild(container.children[0]);
+        }
+    },
+    insertBefore(parentInstance, child, beforeChild) {
+        parentInstance.insertBefore(child, beforeChild);
+    },
+    getPublicInstance(instance) {
+        return instance;
+    },
+    preparePortalMount(containerInfo) { },
+    scheduleTimeout: setTimeout,
+    cancelTimeout: clearTimeout,
+    setCurrentUpdatePriority(_priority) { },
+    getCurrentUpdatePriority() {
+        return 0;
+    },
+    resolveUpdatePriority() {
+        return 32; // DefaultEventPriority
+    },
+    trackSchedulerEvent() { },
+    resolveEventType() {
+        return null;
+    },
+    resolveEventTimeStamp() {
+        return -1;
+    },
+    shouldAttemptEagerTransition() {
+        return false;
+    },
+    detachDeletedInstance(_instance) { },
+    getInstanceFromNode(_node) {
+        return null;
+    },
+    beforeActiveInstanceBlur() { },
+    afterActiveInstanceBlur() { },
+    prepareScopeUpdate(_scopeInstance, _instance) { },
+    getInstanceFromScope(_scopeInstance) {
+        return null;
+    },
+    resetFormInstance(_form) { },
+    requestPostPaintCallback(_callback) { },
+    maySuspendCommit(_type, _props) {
+        return false;
+    },
+    preloadInstance(_type, _props) {
+        return true;
+    },
+    startSuspendingCommit() { },
+    suspendInstance(_type, _props) { },
+    waitForCommitToBeReady() {
+        return null;
+    },
+    NotPendingTransition: null,
+    HostTransitionContext: React.createContext(null),
+};
+const reconciler = ReactReconciler(hostConfig);
+/**
+ * Renders a React element tree into a Gorilla Engine native container.
+ *
+ * Creates a reconciler root on the container if one does not already exist,
+ * then performs an update. This is the low-level entry point — most consumers
+ * should use {@link loadUI} or {@link createUI} instead.
+ *
+ * @param reactElement - The React element tree to render.
+ * @param container - A native Gorilla Engine UI component to render into.
+ * @param callback - Optional callback invoked after the render commits.
+ */
+function render(reactElement, container, callback) {
+    // Create a root Container if it doesnt exist
+    if (!container._rootContainer) {
+        container._rootContainer = reconciler.createContainer(container, 0, null, null, null, null, (error) => {
+            throw error;
+        }, (error) => {
+            throw error;
+        }, (error) => {
+            console.error(error);
+        }, null);
+    }
+    // update the root Container
+    reconciler.updateContainer(reactElement, container._rootContainer, null, callback);
+}
+/**
+ * Loads a plugin UI from a YAML layout file and mounts a React tree into it.
+ *
+ * This is the standard entry point for plugins that define their root layout
+ * in YAML. The YAML is loaded via `GorillaEngine.UI.loadUIfromYAML`, and the
+ * React tree is rendered into the container identified by `rootNodeId`.
+ *
+ * @param app - The root React element to render.
+ * @param ymlPath - Path to the YAML layout file. Defaults to `<resourcePath>/<pluginName>.yaml`.
+ * @param rootNodeId - ID of the native container node in the YAML layout. Defaults to `'root'`.
+ * @param logger - Optional custom {@link Logger} to replace the default console logger.
+ */
+function loadUI(app, ymlPath = null, rootNodeId = 'root', logger) {
+    instance_1.instance.rootNodeId = rootNodeId;
+    const _ymlPath = ymlPath ?? path.join(GorillaEngine.getResourcePath(), `${GorillaEngine.getPluginName()}.yaml`);
+    GorillaEngine.UI.loadUIfromYAML(_ymlPath);
+    const container = GorillaEngine.UI.getControlById(rootNodeId);
+    if (logger) {
+        instance_1.instance.log = logger;
+    }
+    render(React.createElement(Root_1.Root, { app: app }), container);
+}
+/**
+ * Creates a new native window and mounts a React tree into it.
+ *
+ * Use this instead of {@link loadUI} when no YAML layout is needed —
+ * the entire UI is built programmatically from React components.
+ *
+ * @param app - The root React element to render.
+ * @param width - Window width in pixels. Defaults to `1280`.
+ * @param height - Window height in pixels. Defaults to `760`.
+ * @param options - Optional settings:
+ *   - `rootNodeId` – ID assigned to the root window (defaults to `"root"`).
+ *   - `logger` – Custom {@link Logger} instance.
+ */
+function createUI(app, width = 1280, height = 760, options) {
+    const container = new GorillaEngine.UI.Window({
+        id: options?.rootNodeId ?? 'root',
+        width,
+        height,
+    });
+    GorillaEngine.UI.createWindow(container);
+    if (options?.logger) {
+        instance_1.instance.log = options.logger;
+    }
+    render(React.createElement(Root_1.Root, { app: app }), container);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0VSZWFjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9HRVJlYWN0LnRzeCJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQTJPQSx3QkF5QkM7QUFjRCx3QkFtQkM7QUFlRCw0QkFxQkM7QUF6VUQsNkNBQStCO0FBQy9CLGtFQUFvRDtBQUNwRCwyQ0FBNkI7QUFHN0IsMEVBQXlGO0FBRXpGLHlDQUE4QztBQUU5QyxpQ0FBOEI7QUFZOUIsTUFBTSxlQUFlLEdBQVcsRUFBRSxDQUFDO0FBQ25DLE1BQU0sZ0JBQWdCLEdBQVcsRUFBRSxDQUFDO0FBRXBDOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsR0FlWjtJQUNGLGdCQUFnQixFQUFFLElBQUk7SUFDdEIsbUJBQW1CLEVBQUUsS0FBSztJQUMxQixpQkFBaUIsRUFBRSxLQUFLO0lBQ3hCLFNBQVMsRUFBRSxDQUFDLENBQUM7SUFDYixpQkFBaUIsRUFBRSxJQUFJO0lBRXZCLGtCQUFrQjtRQUNoQixPQUFPLGVBQWUsQ0FBQztJQUN6QixDQUFDO0lBRUQsZ0JBQWdCO1FBQ2QsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQsZ0JBQWdCLEtBQVUsQ0FBQztJQUUzQixtQkFBbUI7UUFDakIsT0FBTyxnQkFBZ0IsQ0FBQztJQUMxQixDQUFDO0lBRUQsb0JBQW9CLENBQUMsSUFBcUIsRUFBRSxLQUFVO1FBQ3BELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVELGNBQWMsQ0FDWixJQUFxQixFQUNyQixRQUFhLEVBQ2IscUJBQWlELEVBQ2pELG1CQUFnQyxFQUNoQyxjQUFtQjtRQUVuQixPQUFPLDBCQUFnQixDQUFDLGVBQWUsQ0FBQyxJQUFJLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFDMUQsQ0FBQztJQUVELGtCQUFrQixDQUNoQixJQUFZLEVBQ1oscUJBQWlELEVBQ2pELFdBQXdCLEVBQ3hCLHNCQUF3QztRQUV4QyxPQUFP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

package/dist/Root.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+/**
+ * Top-level wrapper component used internally by the reconciler.
+ *
+ * Acts as the React root that renders the user-supplied `app` element
+ * into the Gorilla Engine native component tree. This is not intended
+ * to be used directly by consumers — it is created by {@link render},
+ * {@link loadUI}, and {@link createUI}.
+ */
+export declare class Root extends React.Component {
+    props: {
+        app: any;
+    };
+    render(): React.JSX.Element;
+}

package/dist/Root.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Root = void 0;
+const React = __importStar(require("react"));
+/**
+ * Top-level wrapper component used internally by the reconciler.
+ *
+ * Acts as the React root that renders the user-supplied `app` element
+ * into the Gorilla Engine native component tree. This is not intended
+ * to be used directly by consumers — it is created by {@link render},
+ * {@link loadUI}, and {@link createUI}.
+ */
+class Root extends React.Component {
+    render() {
+        return (React.createElement(React.Fragment, null, this.props.app));
+    }
+}
+exports.Root = Root;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUm9vdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9Sb290LnRzeCJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSw2Q0FBOEI7QUFFOUI7Ozs7Ozs7R0FPRztBQUNILE1BQWEsSUFBSyxTQUFRLEtBQUssQ0FBQyxTQUFTO0lBSXZDLE1BQU07UUFDSixPQUFPLENBQ0wsMENBQ0csSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQ2QsQ0FDSixDQUFBO0lBQ0gsQ0FBQztDQUNGO0FBWEQsb0JBV0MifQ==

package/dist/hooks/useInstrument.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Return type for {@link useInstrument}.
+ *
+ * Tuple of `[instrument, instrumentName, blob, setBlobPath]`.
+ */
+type UseInstrumentReturnValue<T extends GorillaEngine.Instrument = GorillaEngine.Instrument> = [
+    T | null,
+    string,
+    GorillaEngine.Blob | null,
+    (blobPath: string) => void
+];
+interface UseInstrumentOptions {
+    /** Whether to automatically call `GorillaEngine.setActiveInstrument()`. Defaults to `true`. */
+    setActive?: boolean;
+}
+/**
+ * Loads a Gorilla Engine blob and its first instrument, optionally setting it as the active instrument.
+ *
+ * Defaults to the plugin's primary blob. The blob and instrument are reloaded
+ * reactively when the blob path changes via the returned setter.
+ *
+ * @param overrideBlobPath - Custom path to a `.blob` file. Defaults to `${GorillaEngine.getPluginName()}_part1.blob` in the plugin's resource path.
+ * @param options - `{ setActive?: boolean }` — whether to call `setActiveInstrument`. Defaults to `true`.
+ * @returns A tuple of `[instrument, instrumentName, blob, setBlobPath]`.
+ */
+export declare function useInstrument<T extends GorillaEngine.Instrument = GorillaEngine.Instrument>(overrideBlobPath?: string | null, options?: UseInstrumentOptions): UseInstrumentReturnValue<T>;
+export {};

package/dist/hooks/useInstrument.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInstrument = useInstrument;
+const path = __importStar(require("path"));
+const react_1 = require("react");
+function loadBlobAndInstrument(blobPath, setActive) {
+    let blob = null;
+    let instrumentName = '';
+    let instrument = null;
+    // console.log('[useInstrument] Loading blob from:', blobPath);
+    try {
+        blob = GorillaEngine.loadBlob(blobPath);
+    }
+    catch (e) {
+        console.error('[useInstrument] Failed to load blob:', e);
+        return { blob, instrumentName, instrument };
+    }
+    const names = blob.getInstrumentNames();
+    instrumentName = names.length > 0 ? names[0] : '';
+    // console.log('[useInstrument] Instrument names in blob:', names);
+    if (!instrumentName) {
+        console.warn('[useInstrument] No instruments found in blob');
+        return { blob, instrumentName, instrument };
+    }
+    // console.log('[useInstrument] Loading instrument:', instrumentName);
+    try {
+        instrument = blob.loadInstrument(instrumentName);
+    }
+    catch (e) {
+        console.error('[useInstrument] Failed to load instrument:', e);
+        return { blob, instrumentName, instrument };
+    }
+    if (instrument && setActive) {
+        // console.log('[useInstrument] Setting active instrument:', instrumentName);
+        GorillaEngine.setActiveInstrument(instrument);
+    }
+    return { blob, instrumentName, instrument };
+}
+/**
+ * Loads a Gorilla Engine blob and its first instrument, optionally setting it as the active instrument.
+ *
+ * Defaults to the plugin's primary blob. The blob and instrument are reloaded
+ * reactively when the blob path changes via the returned setter.
+ *
+ * @param overrideBlobPath - Custom path to a `.blob` file. Defaults to `${GorillaEngine.getPluginName()}_part1.blob` in the plugin's resource path.
+ * @param options - `{ setActive?: boolean }` — whether to call `setActiveInstrument`. Defaults to `true`.
+ * @returns A tuple of `[instrument, instrumentName, blob, setBlobPath]`.
+ */
+function useInstrument(overrideBlobPath = null, options = {}) {
+    const { setActive = true } = options;
+    const [blobPath, setBlobPath] = (0, react_1.useState)(overrideBlobPath ??
+        path.join(GorillaEngine.getResourcePath(), `${GorillaEngine.getPluginName()}_part1.blob`));
+    // console.log('[useInstrument] Render');
+    const [blobInstrumentState, setBlobInstrumentState] = (0, react_1.useState)(() => {
+        // console.log('[useInstrument] Initial state (useState initializer)');
+        return loadBlobAndInstrument(blobPath, setActive);
+    });
+    const isInitialMount = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => {
+        if (isInitialMount.current) {
+            // console.log('[useInstrument] useEffect skipped (initial mount)');
+            isInitialMount.current = false;
+            return;
+        }
+        // console.log('[useInstrument] useEffect triggered (blobPath changed)');
+        setBlobInstrumentState(loadBlobAndInstrument(blobPath, setActive));
+    }, [blobPath]);
+    // console.log('[useInstrument] Returning from hook');
+    return [
+        blobInstrumentState.instrument,
+        blobInstrumentState.instrumentName,
+        blobInstrumentState.blob,
+        setBlobPath,
+    ];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlSW5zdHJ1bWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ob29rcy91c2VJbnN0cnVtZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBMEVBLHNDQXFDQztBQS9HRCwyQ0FBNkI7QUFDN0IsaUNBQW9EO0FBeUJwRCxTQUFTLHFCQUFxQixDQUFDLFFBQWdCLEVBQUUsU0FBa0I7SUFDakUsSUFBSSxJQUFJLEdBQThCLElBQUksQ0FBQztJQUMzQyxJQUFJLGNBQWMsR0FBRyxFQUFFLENBQUM7SUFDeEIsSUFBSSxVQUFVLEdBQW9DLElBQUksQ0FBQztJQUV2RCwrREFBK0Q7SUFDL0QsSUFBSSxDQUFDO1FBQ0gsSUFBSSxHQUFHLGFBQWEsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDMUMsQ0FBQztJQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7UUFDWCxPQUFPLENBQUMsS0FBSyxDQUFDLHNDQUFzQyxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ3pELE9BQU8sRUFBRSxJQUFJLEVBQUUsY0FBYyxFQUFFLFVBQVUsRUFBRSxDQUFDO0lBQzlDLENBQUM7SUFFRCxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsa0JBQWtCLEVBQUUsQ0FBQztJQUN4QyxjQUFjLEdBQUcsS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ2xELG1FQUFtRTtJQUVuRSxJQUFJLENBQUMsY0FBYyxFQUFFLENBQUM7UUFDcEIsT0FBTyxDQUFDLElBQUksQ0FBQyw4Q0FBOEMsQ0FBQyxDQUFDO1FBQzdELE9BQU8sRUFBRSxJQUFJLEVBQUUsY0FBYyxFQUFFLFVBQVUsRUFBRSxDQUFDO0lBQzlDLENBQUM7SUFFRCxzRUFBc0U7SUFDdEUsSUFBSSxDQUFDO1FBQ0gsVUFBVSxHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDbkQsQ0FBQztJQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7UUFDWCxPQUFPLENBQUMsS0FBSyxDQUFDLDRDQUE0QyxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQy9ELE9BQU8sRUFBRSxJQUFJLEVBQUUsY0FBYyxFQUFFLFVBQVUsRUFBRSxDQUFDO0lBQzlDLENBQUM7SUFFRCxJQUFJLFVBQVUsSUFBSSxTQUFTLEVBQUUsQ0FBQztRQUM1Qiw2RUFBNkU7UUFDN0UsYUFBYSxDQUFDLG1CQUFtQixDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRCxPQUFPLEVBQUUsSUFBSSxFQUFFLGNBQWMsRUFBRSxVQUFVLEVBQUUsQ0FBQztBQUM5QyxDQUFDO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBZ0IsYUFBYSxDQUMzQixtQkFBa0MsSUFBSSxFQUN0QyxVQUFnQyxFQUFFO0lBRWxDLE1BQU0sRUFBRSxTQUFTLEdBQUcsSUFBSSxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBRXJDLE1BQU0sQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLEdBQUcsSUFBQSxnQkFBUSxFQUN0QyxnQkFBZ0I7UUFDZCxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxlQUFlLEVBQUUsRUFBRSxHQUFHLGFBQWEsQ0FBQyxhQUFhLEVBQUUsYUFBYSxDQUFDLENBQzVGLENBQUM7SUFFRix5Q0FBeUM7SUFFekMsTUFBTSxDQUFDLG1CQUFtQixFQUFFLHNCQUFzQixDQUFDLEdBQUcsSUFBQSxnQkFBUSxFQUFzQixHQUFHLEVBQUU7UUFDdkYsdUVBQXVFO1FBQ3ZFLE9BQU8scUJBQXFCLENBQUMsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0lBQ3BELENBQUMsQ0FBQyxDQUFDO0lBRUgsTUFBTSxjQUFjLEdBQUcsSUFBQSxjQUFNLEVBQUMsSUFBSSxDQUFDLENBQUM7SUFFcEMsSUFBQSxpQkFBUyxFQUFDLEdBQUcsRUFBRTtRQUNiLElBQUksY0FBYyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQzNCLG9FQUFvRTtZQUNwRSxjQUFjLENBQUMsT0FBTyxHQUFHLEtBQUssQ0FBQztZQUMvQixPQUFPO1FBQ1QsQ0FBQztRQUNELHlFQUF5RTtRQUN6RSxzQkFBc0IsQ0FBQyxxQkFBcUIsQ0FBQyxRQUFRLEVBQUUsU0FBUyxDQUFDLENBQUMsQ0FBQztJQUNyRSxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDO0lBRWYsc0RBQXNEO0lBQ3RELE9BQU87UUFDTCxtQkFBbUIsQ0FBQyxVQUFzQjtRQUMxQyxtQkFBbUIsQ0FBQyxjQUFjO1FBQ2xDLG1CQUFtQixDQUFDLElBQUk7UUFDeEIsV0FBVztLQUNaLENBQUM7QUFDSixDQUFDIn0=