@onerjs/smart-filters 8.25.1 → 8.25.3

package/dist/blockFoundation/shaderBlock.js

@@ -0,0 +1,125 @@
+import { __decorate } from "@onerjs/core/tslib.es6.js";
+import "@onerjs/core/Engines/Extensions/engine.renderTarget.js";
+import { ShaderRuntime } from "../runtime/shaderRuntime.js";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+import { CreateCommand } from "../command/command.js";
+import { UndecorateSymbol } from "../utils/shaderCodeUtils.js";
+import { RegisterFinalRenderCommand } from "../utils/renderTargetUtils.js";
+import { BaseBlock } from "./baseBlock.js";
+import { TextureFormat, TextureType } from "./textureOptions.js";
+import { EditableInPropertyPage, PropertyTypeForEdition } from "../editorUtils/editableInPropertyPage.js";
+const OutputTexturePropertiesGroupName = "OUTPUT TEXTURE PROPERTIES";
+/**
+ * This is the base class for all shader blocks.
+ *
+ * It contains the redundant part of wrapping a shader for a full screen pass.
+ *
+ * The only required function to implement is the bind function.
+ */
+export class ShaderBlock extends BaseBlock {
+    /**
+     * Disconnects the block from the graph.
+     * @param disconnectedConnections - Stores the connections that have been broken in the process. You can reconnect them later if needed.
+     */
+    disconnectFromGraph(disconnectedConnections) {
+        const input = this._getConnectionForMainInputTexture();
+        for (const endpoint of this.output.endpoints) {
+            disconnectedConnections?.push([endpoint, this.output]);
+            input.connectTo(endpoint);
+        }
+    }
+    _getConnectionForMainInputTexture() {
+        const mainInputTextureName = this.getShaderProgram().fragment.mainInputTexture;
+        if (!mainInputTextureName) {
+            throw `The block named "${this.name}" does not have a main input texture defined!`;
+        }
+        const mainInputTexture = this.findInput(UndecorateSymbol(mainInputTextureName));
+        if (!mainInputTexture || !mainInputTexture.connectedTo) {
+            throw `The main input texture "${mainInputTextureName}" of block named "${this.name}" is not connected!`;
+        }
+        return mainInputTexture.connectedTo;
+    }
+    /**
+     * Instantiates a new block.
+     * @param smartFilter - Defines the smart filter the block belongs to
+     * @param name - Defines the name of the block
+     * @param disableOptimization - Defines if the block should not be optimized (default: false)
+     */
+    constructor(smartFilter, name, disableOptimization = false) {
+        super(smartFilter, name, disableOptimization);
+        /**
+         * The output connection point of the block.
+         */
+        this.output = this._registerOutput("output", ConnectionPointType.Texture);
+        /**
+         * The options used when creating the texture this block outputs to
+         */
+        this.outputTextureOptions = {
+            ratio: 1,
+            format: TextureFormat.RGBA,
+            type: TextureType.UNSIGNED_BYTE,
+        };
+    }
+    /**
+     * Gets the shader program to use to render the block.
+     * @returns The shader program to use to render the block
+     */
+    getShaderProgram() {
+        return this.constructor.ShaderCode;
+    }
+    /**
+     * Generates the commands needed to execute the block at runtime and gathers promises for initialization work
+     * @param initializationData - The initialization data to use
+     * @param finalOutput - Defines if the block is the final output of the smart filter
+     */
+    generateCommandsAndGatherInitPromises(initializationData, finalOutput) {
+        const runtime = initializationData.runtime;
+        const shaderBlockRuntime = new ShaderRuntime(runtime.effectRenderer, this.getShaderProgram(), this.getShaderBinding());
+        initializationData.initializationPromises.push(shaderBlockRuntime.onReadyAsync);
+        runtime.registerResource(shaderBlockRuntime);
+        if (finalOutput) {
+            RegisterFinalRenderCommand(initializationData.outputBlock, runtime, this, shaderBlockRuntime);
+        }
+        else {
+            const renderTargetTexture = this.output.runtimeData?.value;
+            if (!renderTargetTexture) {
+                throw new Error(`${this.blockType} did not have a render target texture.`);
+            }
+            runtime.registerCommand(CreateCommand(`${this.blockType}.render`, this, () => {
+                shaderBlockRuntime.renderToTargetTexture(renderTargetTexture);
+            }));
+        }
+        super.generateCommandsAndGatherInitPromises(initializationData, finalOutput);
+    }
+}
+/**
+ * The class name of the block.
+ */
+ShaderBlock.ClassName = "ShaderBlock";
+__decorate([
+    EditableInPropertyPage("Ratio", PropertyTypeForEdition.Float, OutputTexturePropertiesGroupName, {
+        min: 0.1,
+        max: 10.0,
+        notifiers: { rebuild: true },
+        subPropertyName: "ratio",
+    }),
+    EditableInPropertyPage("Format", PropertyTypeForEdition.List, OutputTexturePropertiesGroupName, {
+        notifiers: { rebuild: true },
+        subPropertyName: "format",
+        options: [
+            { label: "R", value: TextureFormat.R },
+            { label: "RG", value: TextureFormat.RG },
+            { label: "RGBA", value: TextureFormat.RGBA },
+        ],
+    }),
+    EditableInPropertyPage("Type", PropertyTypeForEdition.List, OutputTexturePropertiesGroupName, {
+        notifiers: { rebuild: true },
+        subPropertyName: "type",
+        options: [
+            { label: "UByte", value: TextureType.UNSIGNED_BYTE },
+            { label: "Float", value: TextureType.FLOAT },
+            { label: "Half Float", value: TextureType.HALF_FLOAT },
+        ],
+    })
+], ShaderBlock.prototype, "outputTextureOptions", void 0);
+//# sourceMappingURL=shaderBlock.js.map

package/dist/blockFoundation/shaderBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaderBlock.js","sourceRoot":"","sources":["../../src/blockFoundation/shaderBlock.ts"],"names":[],"mappings":"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"}

package/dist/blockFoundation/textureOptions.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The format of a texture - corresponds to the Babylon.js TextureFormat constants
+ */
+export declare enum TextureFormat {
+    /** Babylon Constants.TEXTUREFORMAT_RGBA */
+    RGBA = 5,
+    /** Babylon Constants.TEXTUREFORMAT_R */
+    R = 6,
+    /** Babylon Constants.TEXTUREFORMAT_RG */
+    RG = 7
+}
+/**
+ * The type of a texture - corresponds to the Babylon.js TextureType constants
+ */
+export declare enum TextureType {
+    /** Babylon Constants.TEXTURETYPE_UNSIGNED_BYTE */
+    UNSIGNED_BYTE = 0,
+    /** Babylon Constants.TEXTURETYPE_FLOAT */
+    FLOAT = 1,
+    /** Babylon Constants.TEXTURETYPE_HALF_FLOAT */
+    HALF_FLOAT = 2
+}
+/**
+ * Describes the requirements for the output texture of a shader block.
+ */
+export type OutputTextureOptions = {
+    /**
+     * The texture size ratio (output size of this block / size of the Smart Filter output)
+     */
+    ratio: number;
+    /**
+     * The format of the texture
+     */
+    format: TextureFormat;
+    /**
+     * The type of the texture
+     */
+    type: TextureType;
+};
+/**
+ * Compares two OutputTextureOptions to see if they match.
+ * @param a - The first OutputTextureOptions
+ * @param b - The second OutputTextureOptions
+ * @returns True if the two options match, false otherwise
+ */
+export declare function TextureOptionsMatch(a: OutputTextureOptions | undefined, b: OutputTextureOptions | undefined): boolean;
+//# sourceMappingURL=textureOptions.d.ts.map

package/dist/blockFoundation/textureOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureOptions.d.ts","sourceRoot":"","sources":["../../src/blockFoundation/textureOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACrB,2CAA2C;IAC3C,IAAI,IAAI;IACR,wCAAwC;IACxC,CAAC,IAAI;IACL,yCAAyC;IACzC,EAAE,IAAI;CACT;AAED;;GAEG;AACH,oBAAY,WAAW;IACnB,kDAAkD;IAClD,aAAa,IAAI;IACjB,0CAA0C;IAC1C,KAAK,IAAI;IACT,+CAA+C;IAC/C,UAAU,IAAI;CACjB;AAGD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,CAAC,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAKrH"}

package/dist/blockFoundation/textureOptions.js

@@ -0,0 +1,37 @@
+/**
+ * The format of a texture - corresponds to the Babylon.js TextureFormat constants
+ */
+export var TextureFormat;
+(function (TextureFormat) {
+    /** Babylon Constants.TEXTUREFORMAT_RGBA */
+    TextureFormat[TextureFormat["RGBA"] = 5] = "RGBA";
+    /** Babylon Constants.TEXTUREFORMAT_R */
+    TextureFormat[TextureFormat["R"] = 6] = "R";
+    /** Babylon Constants.TEXTUREFORMAT_RG */
+    TextureFormat[TextureFormat["RG"] = 7] = "RG";
+})(TextureFormat || (TextureFormat = {}));
+/**
+ * The type of a texture - corresponds to the Babylon.js TextureType constants
+ */
+export var TextureType;
+(function (TextureType) {
+    /** Babylon Constants.TEXTURETYPE_UNSIGNED_BYTE */
+    TextureType[TextureType["UNSIGNED_BYTE"] = 0] = "UNSIGNED_BYTE";
+    /** Babylon Constants.TEXTURETYPE_FLOAT */
+    TextureType[TextureType["FLOAT"] = 1] = "FLOAT";
+    /** Babylon Constants.TEXTURETYPE_HALF_FLOAT */
+    TextureType[TextureType["HALF_FLOAT"] = 2] = "HALF_FLOAT";
+})(TextureType || (TextureType = {}));
+/**
+ * Compares two OutputTextureOptions to see if they match.
+ * @param a - The first OutputTextureOptions
+ * @param b - The second OutputTextureOptions
+ * @returns True if the two options match, false otherwise
+ */
+export function TextureOptionsMatch(a, b) {
+    if (a === undefined || b === undefined) {
+        return false;
+    }
+    return a.ratio === b.ratio && a.format === b.format && a.type === b.type;
+}
+//# sourceMappingURL=textureOptions.js.map

package/dist/blockFoundation/textureOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureOptions.js","sourceRoot":"","sources":["../../src/blockFoundation/textureOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACrB,2CAA2C;IAC3C,iDAAQ,CAAA;IACR,wCAAwC;IACxC,2CAAK,CAAA;IACL,yCAAyC;IACzC,6CAAM,CAAA;AACV,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACnB,kDAAkD;IAClD,+DAAiB,CAAA;IACjB,0CAA0C;IAC1C,+CAAS,CAAA;IACT,+CAA+C;IAC/C,yDAAc,CAAA;AAClB,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAuBD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAmC,EAAE,CAAmC;IACxG,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC"}

package/dist/command/command.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Represents the owner of a command.
+ */
+export interface ICommandOwner {
+    /**
+     * The friendly name of the owner.
+     */
+    readonly name: string;
+    /**
+     * The blockType of the owner;
+     */
+    readonly blockType: string;
+}
+/**
+ * Represents a the action of a @see Command. This is what will be executed during a command buffer execution.
+ */
+export type CommandAction = () => void;
+/**
+ * Represents a command to execute.
+ *
+ * A command contains a function that will be executed at runtime by the smart filter.
+ *
+ * It also contains the owner of the command for debugging purposes.
+ */
+export type Command = {
+    /**
+     * The friendly name of the command.
+     */
+    readonly name: string;
+    /**
+     * The owner of the command.
+     * In practice, it will mostly be a block, the smart filter or a tool injecting commands.
+     */
+    readonly owner: ICommandOwner;
+    /**
+     * Defines the action to execute.
+     */
+    readonly action: CommandAction;
+};
+/**
+ * Creates a new command.
+ * @param name - The friendly name of the command
+ * @param owner - The owner of the command
+ * @param action - The action to execute when the command is executed
+ * @returns The new command
+ */
+export declare function CreateCommand(name: string, owner: ICommandOwner, action: CommandAction): Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/command/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAMhG"}

package/dist/command/command.js

@@ -0,0 +1,15 @@
+/**
+ * Creates a new command.
+ * @param name - The friendly name of the command
+ * @param owner - The owner of the command
+ * @param action - The action to execute when the command is executed
+ * @returns The new command
+ */
+export function CreateCommand(name, owner, action) {
+    return {
+        name,
+        owner,
+        action,
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/command/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/command/command.ts"],"names":[],"mappings":"AA6CA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAoB,EAAE,MAAqB;IACnF,OAAO;QACH,IAAI;QACJ,KAAK;QACL,MAAM;KACT,CAAC;AACN,CAAC"}

package/dist/command/commandBuffer.d.ts

@@ -0,0 +1,40 @@
+import type { Command } from "./command.js";
+/**
+ * Represents the action to run when calling `visitCommands` on a @see CommandBuffer.
+ */
+export type CommandsVisitor = (command: Command) => void;
+/**
+ * A command buffer is a list of commands to execute.
+ * This is used to store the list of tasks the current smart filter needs to execute.
+ */
+export declare class CommandBuffer {
+    private readonly _commands;
+    /**
+     * Creates a new command buffer.
+     * @param args - the list of commands to add to the command buffer
+     */
+    constructor(...args: Command[]);
+    /**
+     * Adds a command to the command buffer.
+     * @param command - the command to add
+     */
+    push(command: Command): void;
+    /**
+     * Clears the command buffer and empty the list of commands.
+     */
+    clear(): void;
+    /**
+     * Visits all the commands in the command buffer.
+     * @param commandVisitor - The action to execute on each command
+     */
+    visitCommands(commandVisitor: CommandsVisitor): void;
+    /**
+     * Execute all the commands in the command buffer.
+     */
+    execute(): void;
+    /**
+     * Dispose the resources associated to the command buffer.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=commandBuffer.d.ts.map

package/dist/command/commandBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBuffer.d.ts","sourceRoot":"","sources":["../../src/command/commandBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAUzD;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAE3C;;;OAGG;gBACS,GAAG,IAAI,EAAE,OAAO,EAAE;IAM9B;;;OAGG;IACI,IAAI,CAAC,OAAO,EAAE,OAAO;IAI5B;;OAEG;IACI,KAAK;IAIZ;;;OAGG;IACI,aAAa,CAAC,cAAc,EAAE,eAAe,GAAG,IAAI;IAM3D;;OAEG;IACI,OAAO;IAId;;OAEG;IACI,OAAO;CAGjB"}

package/dist/command/commandBuffer.js

@@ -0,0 +1,58 @@
+/**
+ * @see CommandsVisitor used to execute the commands of a @see CommandBuffer.
+ * @param command - The command to execute.
+ */
+function ExecuteCommandsVisitor(command) {
+    command.action();
+}
+/**
+ * A command buffer is a list of commands to execute.
+ * This is used to store the list of tasks the current smart filter needs to execute.
+ */
+export class CommandBuffer {
+    /**
+     * Creates a new command buffer.
+     * @param args - the list of commands to add to the command buffer
+     */
+    constructor(...args) {
+        this._commands = [];
+        for (const command of args) {
+            this.push(command);
+        }
+    }
+    /**
+     * Adds a command to the command buffer.
+     * @param command - the command to add
+     */
+    push(command) {
+        this._commands.push(command);
+    }
+    /**
+     * Clears the command buffer and empty the list of commands.
+     */
+    clear() {
+        this._commands.length = 0;
+    }
+    /**
+     * Visits all the commands in the command buffer.
+     * @param commandVisitor - The action to execute on each command
+     */
+    visitCommands(commandVisitor) {
+        for (const command of this._commands) {
+            commandVisitor(command);
+        }
+    }
+    /**
+     * Execute all the commands in the command buffer.
+     */
+    execute() {
+        this.visitCommands(ExecuteCommandsVisitor);
+    }
+    /**
+     * Dispose the resources associated to the command buffer.
+     */
+    dispose() {
+        this.clear();
+    }
+}
+//# sourceMappingURL=commandBuffer.js.map

package/dist/command/commandBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBuffer.js","sourceRoot":"","sources":["../../src/command/commandBuffer.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,SAAS,sBAAsB,CAAC,OAAgB;IAC5C,OAAO,CAAC,MAAM,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAGtB;;;OAGG;IACH,YAAY,GAAG,IAAe;QANb,cAAS,GAAc,EAAE,CAAC;QAOvC,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,IAAI,CAAC,OAAgB;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,cAA+B;QAChD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAED;;OAEG;IACI,OAAO;QACV,IAAI,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,OAAO;QACV,IAAI,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;CACJ"}

package/dist/command/commandBufferDebugger.d.ts

@@ -0,0 +1,7 @@
+import type { CommandBuffer } from "./commandBuffer.js";
+/**
+ * Logs all the commands associated to a command buffer.
+ * @param commandBuffer - The command buffer to log
+ */
+export declare function LogCommands(commandBuffer: Readonly<CommandBuffer>): void;
+//# sourceMappingURL=commandBufferDebugger.d.ts.map

package/dist/command/commandBufferDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBufferDebugger.d.ts","sourceRoot":"","sources":["../../src/command/commandBufferDebugger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,QAMjE"}

package/dist/command/commandBufferDebugger.js

@@ -0,0 +1,13 @@
+import { Logger } from "@onerjs/core/Misc/logger.js";
+/**
+ * Logs all the commands associated to a command buffer.
+ * @param commandBuffer - The command buffer to log
+ */
+export function LogCommands(commandBuffer) {
+    Logger.Log("----- Command buffer commands -----");
+    commandBuffer.visitCommands((command) => {
+        Logger.Log(`  Owner: ${command.owner.blockType} (${command.owner.name}) - Command: ${command.name}`);
+    });
+    Logger.Log("-----------------------------------");
+}
+//# sourceMappingURL=commandBufferDebugger.js.map

package/dist/command/commandBufferDebugger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandBufferDebugger.js","sourceRoot":"","sources":["../../src/command/commandBufferDebugger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,oCAA4B;AAG7C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,aAAsC;IAC9D,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAClD,aAAa,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,gBAAgB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AACtD,CAAC"}

package/dist/command/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./command.js";
+export { CreateCommand as createCommand } from "./command.js";
+export * from "./commandBuffer.js";
+export { LogCommands } from "./commandBufferDebugger.js";
+export { LogCommands as logCommands } from "./commandBufferDebugger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/command/index.js

@@ -0,0 +1,8 @@
+export * from "./command.js";
+// Back compat for when camelCase was used
+export { CreateCommand as createCommand } from "./command.js";
+export * from "./commandBuffer.js";
+export { LogCommands } from "./commandBufferDebugger.js";
+// Back compat for when camelCase was used
+export { LogCommands as logCommands } from "./commandBufferDebugger.js";
+//# sourceMappingURL=index.js.map

package/dist/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,0CAA0C;AAC1C,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,0CAA0C;AAC1C,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/connection/connectionPoint.d.ts

@@ -0,0 +1,110 @@
+import type { Nullable } from "@onerjs/core/types.js";
+import { ConnectionPointCompatibilityState } from "./connectionPointCompatibilityState.js";
+import { ConnectionPointDirection } from "./connectionPointDirection.js";
+import type { BaseBlock } from "../blockFoundation/baseBlock.js";
+import type { ConnectionPointType, ConnectionPointValue } from "./connectionPointType.js";
+import type { StrongRef } from "../runtime/strongRef.js";
+/**
+ * This represents a strong reference to the data being passed through a connection point.
+ */
+export type RuntimeData<U extends ConnectionPointType> = StrongRef<ConnectionPointValue<U>>;
+/**
+ * This defines a connection point.
+ *
+ * A connection point is any input/output of a block.
+ * It can be linked to another connection point following some rules:
+ *  - The type of the connection point must be compatible with the other one.
+ *  - The direction of the connection point must be different from the other one.
+ *  - The connection cannot create a cycle in the list of blocks.
+ * The relationship is always 1:N for input:output
+ */
+export declare class ConnectionPoint<U extends ConnectionPointType = ConnectionPointType> {
+    /**
+     * The name of the connection point.
+     * This is used to identify the connection point inside a block.
+     */
+    readonly name: string;
+    /**
+     * The type of the connection point (float, texture, etc.)
+     */
+    readonly type: U;
+    /**
+     * The direction of the connection point (input or output)
+     */
+    readonly direction: ConnectionPointDirection;
+    /**
+     * The smart filter block the connection point belongs to.
+     */
+    readonly ownerBlock: BaseBlock;
+    /**
+     * User provided name for the connection point.
+     */
+    displayName: Nullable<string>;
+    /**
+     * The @see RunTimeData used during the init phase to reference the result of the previous block.
+     * Those are only used for input connection points.
+     * The previous block are "pushing" this in during the init stage.
+     */
+    runtimeData: Nullable<RuntimeData<U>>;
+    /**
+     * The default runtimeData used when no connection is made to the connection point.
+     */
+    readonly defaultRuntimeData: Nullable<RuntimeData<U>>;
+    private _connectedTo;
+    private _endpoints;
+    /**
+     * Create a new connection point.
+     * @param name - The name the connection point has in the block
+     * @param ownerBlock - The block the connection point belongs to
+     * @param type - The type of the connection point
+     * @param direction - The direction of the connection point
+     * @param defaultRuntimeData - The default runtime data to use when no connection is made to the connection point
+     */
+    constructor(name: string, ownerBlock: BaseBlock, type: U, direction: ConnectionPointDirection, defaultRuntimeData?: Nullable<RuntimeData<U>>);
+    /**
+     * @returns The connection point this connection point is connected to.
+     * (the one on the other side of the connection)
+     * Only input connection points have a connected point which they received their value from.
+     * (Relation is always 1:N for input:output)
+     */
+    get connectedTo(): Nullable<ConnectionPoint<U>>;
+    /**
+     * @returns The connection points this output connection point is connected to.
+     * (the ones on the other side of the connection)
+     * Only output connection points have a list of endpoints which they provide their value to.
+     * (Relation is always 1:N for input:output)
+     */
+    get endpoints(): ReadonlyArray<ConnectionPoint<U>>;
+    /**
+     * Gets a state indicating if the current point can be connected to another point
+     * @param other - defines the other connection point
+     * @returns the compatibility state
+     */
+    checkCompatibilityState(other: ConnectionPoint<U>): ConnectionPointCompatibilityState;
+    /**
+     * Checks if the connection point can be connected to another one.
+     * @param connectionPoint - The other connection point to check compatibility with
+     * @returns true if the connection point can be connected to the other one
+     */
+    canConnectTo(connectionPoint: ConnectionPoint<U>): boolean;
+    /**
+     * Connect this connection point to another one.
+     * @param other - The other connection point to connect to
+     * @throws if the connection point cannot be connected to the other one
+     */
+    connectTo(other: ConnectionPoint<U>): void;
+    /**
+     * Disconnects this point from one of his endpoint
+     * @param endpoint - defines the other connection point
+     */
+    disconnectFrom(endpoint: ConnectionPoint<U>): void;
+    /**
+     * Disconnects this point from all its endpoints.
+     */
+    disconnectAllEndpoints(): void;
+    /**
+     * Propagates the current runtime data to all endpoints.
+     */
+    propagateRuntimeData(): void;
+}
+//# sourceMappingURL=connectionPoint.d.ts.map

package/dist/connection/connectionPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionPoint.d.ts","sourceRoot":"","sources":["../../src/connection/connectionPoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAAsB;AAC9C,OAAO,EAAE,iCAAiC,EAAgC,MAAM,wCAAwC,CAAC;AACzH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,mBAAmB,IAAI,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5F;;;;;;;;;GASG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAC5E;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,IAAI,EAAE,CAAC,CAAC;IAExB;;OAEG;IACH,SAAgB,SAAS,EAAE,wBAAwB,CAAC;IAEpD;;OAEG;IACH,SAAgB,UAAU,EAAE,SAAS,CAAC;IAEtC;;OAEG;IACI,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAQ;IAE5C;;;;OAIG;IACI,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAQ;IAEpD;;OAEG;IACH,SAAgB,kBAAkB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAQ;IAEpE,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;;;;;OAOG;gBACS,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,wBAAwB,EAAE,kBAAkB,GAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAQ;IASlJ;;;;;OAKG;IACH,IAAW,WAAW,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAErD;IAED;;;;;OAKG;IACH,IAAW,SAAS,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAExD;IAED;;;;OAIG;IACI,uBAAuB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,iCAAiC;IAwB5F;;;;OAIG;IACI,YAAY,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;IAIvD;;;;OAIG;IACI,SAAS,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAmBjD;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAczD;;OAEG;IACI,sBAAsB,IAAI,IAAI;IAQrC;;OAEG;IACI,oBAAoB,IAAI,IAAI;CAStC"}