@pibbl/core 0.0.1

package/dist/lib/textures/texture-protocol.d.ts

@@ -0,0 +1,124 @@
+import type { FillStyle, StrokeStyle } from "../types.js";
+import type { Texture, TextureDefinition } from "./texture.js";
+import type { RenderingContext2D } from "../types.js";
+declare const textureBrand: unique symbol;
+/**
+ * How a texture raster is positioned and scaled when used as paint.
+ *
+ * @see {@link Texture}
+ * @see {@link TextureDefinition}
+ */
+export interface TexturePlacement {
+    /** Selects the supported mapping, placement, or result policy. See {@link TexturePlacement}. */
+    readonly mode?: "repeat" | "stretch";
+    /** Width of one texture tile in logical paint coordinates. See {@link TexturePlacement}. */
+    readonly tileWidth?: number;
+    /** Height of one texture tile in logical paint coordinates. See {@link TexturePlacement}. */
+    readonly tileHeight?: number;
+    /** Horizontal offset applied to the texture or shadow. See {@link TexturePlacement}. */
+    readonly offsetX?: number;
+    /** Vertical offset applied to the texture or shadow. See {@link TexturePlacement}. */
+    readonly offsetY?: number;
+    /** Rotation applied to the containing geometry. See {@link TexturePlacement}. */
+    readonly rotation?: number;
+}
+/**
+ * Opaque paint value produced by a mounted texture owner.
+ *
+ * @see {@link FillStyle}
+ * @see {@link StrokeStyle}
+ * @see {@link Texture}
+ */
+export interface TexturePaint {
+    readonly [textureBrand]: true;
+}
+/**
+ * A temporary raster view valid only during the borrowing callback.
+ *
+ * @see {@link TexturePlacement}
+ * @see {@link borrowTextureRaster}
+ */
+export interface BorrowedTextureRaster {
+    /** Borrowed raster image; valid only within the borrowing callback. See {@link BorrowedTextureRaster}. */
+    readonly source: OffscreenCanvas;
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See
+     * {@link BorrowedTextureRaster}.
+     */
+    readonly width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See
+     * {@link BorrowedTextureRaster}.
+     */
+    readonly height: number;
+    /**
+     * Revision used to detect changes to the underlying state or geometry. See
+     * {@link BorrowedTextureRaster}.
+     */
+    readonly revision: number;
+    /** Resource identity underlying the borrowed raster. See {@link BorrowedTextureRaster}. */
+    readonly resource: object;
+    /**
+     * Preferred placement relative to the anchor or containing geometry. See
+     * {@link TexturePlacement}.
+     */
+    readonly placement: Readonly<TexturePlacement>;
+}
+interface TexturePaintCapability {
+    validate(): void;
+    resolvePaint(ctx: RenderingContext2D, bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): string | CanvasGradient | CanvasPattern;
+    borrow<T>(callback: (raster: BorrowedTextureRaster) => T): T;
+}
+/** @internal Registers a value-owned capability; there is no producer registry. */
+export declare function registerTexturePaint(value: TexturePaint, capability: TexturePaintCapability): void;
+/**
+ * @internal Borrows only committed pixels for one synchronous consumer action.
+ *
+ * @param value - Texture paint descriptor to validate. See {@link TexturePaint}.
+ *
+ * @see {@link TexturePaint}
+ */
+export declare function validateTexturePaint(value: TexturePaint): void;
+/**
+ * Borrows a texture raster for synchronous use without transferring ownership to the caller.
+ *
+ * @param value - Texture paint whose raster is borrowed. See {@link TexturePaint}.
+ * @param callback - Synchronous callback using the raster while its lease is active. See
+ * {@link BorrowedTextureRaster} .
+ * @returns The callback's return value; the raster lease ends when the callback returns.
+ *
+ * @see {@link TexturePaint}
+ * @see {@link BorrowedTextureRaster}
+ */
+export declare function borrowTextureRaster<T>(value: TexturePaint, callback: (raster: BorrowedTextureRaster) => T): T;
+/**
+ * Internal paint resolution shared by Canvas built-ins.
+ *
+ * @param value - Native Canvas paint or Pibbl texture placement. See {@link TexturePaint}.
+ * @param ctx - Canvas context that will consume the resolved paint. See {@link RenderingContext2D}
+ * .
+ * @param bounds - Destination bounds in local logical coordinates.
+ * @returns Native Canvas paint ready to assign to the drawing context.
+ *
+ * @see {@link TexturePaint}
+ * @see {@link RenderingContext2D}
+ */
+export declare function resolveTexturePaint(value: string | CanvasGradient | CanvasPattern | TexturePaint, ctx: RenderingContext2D, bounds: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): string | CanvasGradient | CanvasPattern;
+/** Internal Rectangle-only fast path for the exact simple stretch-fill case. */
+export declare function drawSimpleStretchedTexture(value: string | CanvasGradient | CanvasPattern | TexturePaint | undefined, ctx: RenderingContext2D, bounds: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): boolean;
+export {};

package/dist/lib/textures/texture-protocol.js

@@ -0,0 +1,40 @@
+const capabilities = /* @__PURE__ */ new WeakMap();
+function registerTexturePaint(value, capability) {
+  capabilities.set(value, capability);
+}
+function validateTexturePaint(value) {
+  const capability = typeof value === "object" && value !== null ? capabilities.get(value) : void 0;
+  if (!capability) throw new TypeError("Expected a Pibbl texture paint value.");
+  capability.validate();
+}
+function borrowTextureRaster(value, callback) {
+  const capability = typeof value === "object" && value !== null ? capabilities.get(value) : void 0;
+  if (!capability) throw new TypeError("Expected a Pibbl texture paint value.");
+  return capability.borrow(callback);
+}
+function resolveTexturePaint(value, ctx, bounds) {
+  const capability = typeof value === "object" && value !== null ? capabilities.get(value) : void 0;
+  return capability ? capability.resolvePaint(ctx, bounds) : value;
+}
+function drawSimpleStretchedTexture(value, ctx, bounds) {
+  const capability = typeof value === "object" && value !== null ? capabilities.get(value) : void 0;
+  if (!capability || ctx.globalCompositeOperation !== "source-over" || ctx.filter !== "none" || ctx.shadowBlur !== 0 || ctx.shadowOffsetX !== 0 || ctx.shadowOffsetY !== 0 || ctx.shadowColor !== "rgba(0, 0, 0, 0)") return false;
+  const transform = ctx.getTransform();
+  if (!Number.isInteger(bounds.x) || !Number.isInteger(bounds.y) || !Number.isInteger(bounds.width) || !Number.isInteger(bounds.height) || bounds.width <= 0 || bounds.height <= 0 || transform.b !== 0 || transform.c !== 0 || transform.a !== 1 || transform.d !== 1 || !Number.isInteger(transform.e) || !Number.isInteger(transform.f)) return false;
+  capability.validate();
+  return capability.borrow((raster) => {
+    const placement = raster.placement;
+    if (placement.mode !== "stretch" || placement.offsetX || placement.offsetY || placement.rotation) return false;
+    if (raster.width !== bounds.width || raster.height !== bounds.height) return false;
+    ctx.drawImage(raster.source, bounds.x, bounds.y, bounds.width, bounds.height);
+    return true;
+  });
+}
+export {
+  borrowTextureRaster,
+  drawSimpleStretchedTexture,
+  registerTexturePaint,
+  resolveTexturePaint,
+  validateTexturePaint
+};
+//# sourceMappingURL=texture-protocol.js.map

package/dist/lib/textures/texture-protocol.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/textures/texture-protocol.ts"],
+  "sourcesContent": ["import type { FillStyle, StrokeStyle } from '../types.js';\nimport type { Texture, TextureDefinition } from './texture.js';\nimport type { RenderingContext2D } from \"../types.js\";\n\ndeclare const textureBrand: unique symbol;\n\n/**\n * How a texture raster is positioned and scaled when used as paint.\n *\n * @see {@link Texture}\n * @see {@link TextureDefinition}\n */\nexport interface TexturePlacement {\n  /** Selects the supported mapping, placement, or result policy. See {@link TexturePlacement}. */\n  readonly mode?: \"repeat\" | \"stretch\";\n  /** Width of one texture tile in logical paint coordinates. See {@link TexturePlacement}. */\n  readonly tileWidth?: number;\n  /** Height of one texture tile in logical paint coordinates. See {@link TexturePlacement}. */\n  readonly tileHeight?: number;\n  /** Horizontal offset applied to the texture or shadow. See {@link TexturePlacement}. */\n  readonly offsetX?: number;\n  /** Vertical offset applied to the texture or shadow. See {@link TexturePlacement}. */\n  readonly offsetY?: number;\n  /** Rotation applied to the containing geometry. See {@link TexturePlacement}. */\n  readonly rotation?: number;\n}\n\n/**\n * Opaque paint value produced by a mounted texture owner.\n *\n * @see {@link FillStyle}\n * @see {@link StrokeStyle}\n * @see {@link Texture}\n */\nexport interface TexturePaint {\n  readonly [textureBrand]: true;\n}\n\n/**\n * A temporary raster view valid only during the borrowing callback.\n *\n * @see {@link TexturePlacement}\n * @see {@link borrowTextureRaster}\n */\nexport interface BorrowedTextureRaster {\n  /** Borrowed raster image; valid only within the borrowing callback. See {@link BorrowedTextureRaster}. */\n  readonly source: OffscreenCanvas;\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See\n   * {@link BorrowedTextureRaster}.\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See\n   * {@link BorrowedTextureRaster}.\n   */\n  readonly height: number;\n  /**\n   * Revision used to detect changes to the underlying state or geometry. See\n   * {@link BorrowedTextureRaster}.\n   */\n  readonly revision: number;\n  /** Resource identity underlying the borrowed raster. See {@link BorrowedTextureRaster}. */\n  readonly resource: object;\n  /**\n   * Preferred placement relative to the anchor or containing geometry. See\n   * {@link TexturePlacement}.\n   */\n  readonly placement: Readonly<TexturePlacement>;\n}\n\ninterface TexturePaintCapability {\n  validate(): void;\n  resolvePaint(\n    ctx: RenderingContext2D,\n    bounds: { x: number; y: number; width: number; height: number },\n  ): string | CanvasGradient | CanvasPattern;\n  borrow<T>(callback: (raster: BorrowedTextureRaster) => T): T;\n}\n\nconst capabilities = new WeakMap<object, TexturePaintCapability>();\n\n/** @internal Registers a value-owned capability; there is no producer registry. */\nexport function registerTexturePaint(\n  value: TexturePaint,\n  capability: TexturePaintCapability,\n): void {\n  capabilities.set(value, capability);\n}\n\n/**\n * @internal Borrows only committed pixels for one synchronous consumer action.\n *\n * @param value - Texture paint descriptor to validate. See {@link TexturePaint}.\n *\n * @see {@link TexturePaint}\n */\nexport function validateTexturePaint(value: TexturePaint): void {\n  const capability =\n    typeof value === \"object\" && value !== null ? capabilities.get(value) : undefined;\n  if (!capability) throw new TypeError(\"Expected a Pibbl texture paint value.\");\n  capability.validate();\n}\n\n/**\n * Borrows a texture raster for synchronous use without transferring ownership to the caller.\n *\n * @param value - Texture paint whose raster is borrowed. See {@link TexturePaint}.\n * @param callback - Synchronous callback using the raster while its lease is active. See\n * {@link BorrowedTextureRaster} .\n * @returns The callback's return value; the raster lease ends when the callback returns.\n *\n * @see {@link TexturePaint}\n * @see {@link BorrowedTextureRaster}\n */\nexport function borrowTextureRaster<T>(\n  value: TexturePaint,\n  callback: (raster: BorrowedTextureRaster) => T,\n): T {\n  const capability =\n    typeof value === \"object\" && value !== null ? capabilities.get(value) : undefined;\n  if (!capability) throw new TypeError(\"Expected a Pibbl texture paint value.\");\n  return capability.borrow(callback);\n}\n\n/**\n * Internal paint resolution shared by Canvas built-ins.\n *\n * @param value - Native Canvas paint or Pibbl texture placement. See {@link TexturePaint}.\n * @param ctx - Canvas context that will consume the resolved paint. See {@link RenderingContext2D}\n * .\n * @param bounds - Destination bounds in local logical coordinates.\n * @returns Native Canvas paint ready to assign to the drawing context.\n *\n * @see {@link TexturePaint}\n * @see {@link RenderingContext2D}\n */\nexport function resolveTexturePaint(\n  value: string | CanvasGradient | CanvasPattern | TexturePaint,\n  ctx: RenderingContext2D,\n  bounds: { x: number; y: number; width: number; height: number },\n): string | CanvasGradient | CanvasPattern {\n  const capability =\n    typeof value === \"object\" && value !== null ? capabilities.get(value) : undefined;\n  return capability ? capability.resolvePaint(ctx, bounds) : value as string | CanvasGradient | CanvasPattern;\n}\n\n/** Internal Rectangle-only fast path for the exact simple stretch-fill case. */\nexport function drawSimpleStretchedTexture(\n  value: string | CanvasGradient | CanvasPattern | TexturePaint | undefined,\n  ctx: RenderingContext2D,\n  bounds: { x: number; y: number; width: number; height: number },\n): boolean {\n  const capability = typeof value === \"object\" && value !== null ? capabilities.get(value) : undefined;\n  if (!capability || ctx.globalCompositeOperation !== \"source-over\" || ctx.filter !== \"none\" ||\n    ctx.shadowBlur !== 0 || ctx.shadowOffsetX !== 0 || ctx.shadowOffsetY !== 0 ||\n    ctx.shadowColor !== \"rgba(0, 0, 0, 0)\") return false;\n  // CanvasPattern and drawImage use different sampling rules when either is\n  // scaled, especially around transparent source pixels. Keep the\n  // allocation-free path to the exact 1:1, pixel-aligned case only.\n  const transform = ctx.getTransform();\n  if (!Number.isInteger(bounds.x) || !Number.isInteger(bounds.y) ||\n    !Number.isInteger(bounds.width) || !Number.isInteger(bounds.height) ||\n    bounds.width <= 0 || bounds.height <= 0 || transform.b !== 0 || transform.c !== 0 ||\n    transform.a !== 1 || transform.d !== 1 ||\n    !Number.isInteger(transform.e) || !Number.isInteger(transform.f)) return false;\n  capability.validate();\n  return capability.borrow(raster => {\n    const placement = raster.placement;\n    if (placement.mode !== \"stretch\" || placement.offsetX || placement.offsetY || placement.rotation) return false;\n    if (raster.width !== bounds.width || raster.height !== bounds.height) return false;\n    ctx.drawImage(raster.source, bounds.x, bounds.y, bounds.width, bounds.height);\n    return true;\n  });\n}\n"],
+  "mappings": "AAgFA,MAAM,eAAe,oBAAI,QAAwC;AAG1D,SAAS,qBACd,OACA,YACM;AACN,eAAa,IAAI,OAAO,UAAU;AACpC;AASO,SAAS,qBAAqB,OAA2B;AAC9D,QAAM,aACJ,OAAO,UAAU,YAAY,UAAU,OAAO,aAAa,IAAI,KAAK,IAAI;AAC1E,MAAI,CAAC,WAAY,OAAM,IAAI,UAAU,uCAAuC;AAC5E,aAAW,SAAS;AACtB;AAaO,SAAS,oBACd,OACA,UACG;AACH,QAAM,aACJ,OAAO,UAAU,YAAY,UAAU,OAAO,aAAa,IAAI,KAAK,IAAI;AAC1E,MAAI,CAAC,WAAY,OAAM,IAAI,UAAU,uCAAuC;AAC5E,SAAO,WAAW,OAAO,QAAQ;AACnC;AAcO,SAAS,oBACd,OACA,KACA,QACyC;AACzC,QAAM,aACJ,OAAO,UAAU,YAAY,UAAU,OAAO,aAAa,IAAI,KAAK,IAAI;AAC1E,SAAO,aAAa,WAAW,aAAa,KAAK,MAAM,IAAI;AAC7D;AAGO,SAAS,2BACd,OACA,KACA,QACS;AACT,QAAM,aAAa,OAAO,UAAU,YAAY,UAAU,OAAO,aAAa,IAAI,KAAK,IAAI;AAC3F,MAAI,CAAC,cAAc,IAAI,6BAA6B,iBAAiB,IAAI,WAAW,UAClF,IAAI,eAAe,KAAK,IAAI,kBAAkB,KAAK,IAAI,kBAAkB,KACzE,IAAI,gBAAgB,mBAAoB,QAAO;AAIjD,QAAM,YAAY,IAAI,aAAa;AACnC,MAAI,CAAC,OAAO,UAAU,OAAO,CAAC,KAAK,CAAC,OAAO,UAAU,OAAO,CAAC,KAC3D,CAAC,OAAO,UAAU,OAAO,KAAK,KAAK,CAAC,OAAO,UAAU,OAAO,MAAM,KAClE,OAAO,SAAS,KAAK,OAAO,UAAU,KAAK,UAAU,MAAM,KAAK,UAAU,MAAM,KAChF,UAAU,MAAM,KAAK,UAAU,MAAM,KACrC,CAAC,OAAO,UAAU,UAAU,CAAC,KAAK,CAAC,OAAO,UAAU,UAAU,CAAC,EAAG,QAAO;AAC3E,aAAW,SAAS;AACpB,SAAO,WAAW,OAAO,YAAU;AACjC,UAAM,YAAY,OAAO;AACzB,QAAI,UAAU,SAAS,aAAa,UAAU,WAAW,UAAU,WAAW,UAAU,SAAU,QAAO;AACzG,QAAI,OAAO,UAAU,OAAO,SAAS,OAAO,WAAW,OAAO,OAAQ,QAAO;AAC7E,QAAI,UAAU,OAAO,QAAQ,OAAO,GAAG,OAAO,GAAG,OAAO,OAAO,OAAO,MAAM;AAC5E,WAAO;AAAA,EACT,CAAC;AACH;",
+  "names": []
+}

package/dist/lib/textures/texture.d.ts

@@ -0,0 +1,170 @@
+import { type TexturePaint, type TexturePlacement } from "./texture-protocol.js";
+export type { TexturePaint, TexturePlacement } from "./texture-protocol.js";
+declare const recipeBrand: unique symbol;
+/**
+ * A mount-owned texture handle that provides paint and accepts recipe messages.
+ *
+ * @see {@link TexturePaint}
+ * @see {@link TexturePlacement}
+ * @see {@link useTexture}
+ */
+export interface Texture<Message = never> extends TexturePaint {
+    /**
+     * Delivers a typed message to the mounted recipe instance. See {@link Texture}.
+     * @param message - Message delivered to the texture definition's receive callback.
+     */
+    send(message: Message): void;
+    /**
+     * Returns a paint view with the requested placement while retaining the same texture ownership.
+     * See {@link TexturePaint}.
+     * @param placement - Destination bounds and texture placement policy. See
+     * {@link TexturePlacement} .
+     * @returns A paint descriptor referencing this mounted texture. See {@link TexturePaint}.
+     */
+    paint(placement: TexturePlacement): TexturePaint;
+}
+/**
+ * Resolution and runtime configuration for a mounted texture recipe.
+ *
+ * @see {@link useTexture}
+ */
+export interface TextureOptions {
+    /** Dimensions of the simulation or raster grid. See {@link TextureOptions}. */
+    readonly resolution?: {
+        /**
+         * Horizontal extent in the units of the containing geometry or surface. See
+         * {@link TextureOptions}.
+         */
+        readonly width: number;
+        /**
+         * Vertical extent in the units of the containing geometry or surface. See
+         * {@link TextureOptions}.
+         */
+        readonly height: number;
+    };
+    /** Ordered colors used to present texture intensity. See {@link TextureOptions}. */
+    readonly palette?: readonly string[];
+}
+/**
+ * Surface and invalidation facilities supplied to texture lifecycle callbacks.
+ *
+ * @see {@link TextureDefinition}
+ */
+export interface TextureContext {
+    /** Canvas surface associated with this resource or mount. See {@link TextureContext}. */
+    readonly canvas: OffscreenCanvas;
+    /** Ordered colors used to present texture intensity. See {@link TextureContext}. */
+    readonly palette: readonly string[] | undefined;
+    /** Marks the source pixels dirty and requests a Pibbl update. */
+    invalidate(): void;
+    /** Requests another Pibbl frame; implementations stop by not requesting again. */
+    requestFrame(): void;
+}
+/**
+ * Shared logical time and elapsed milliseconds supplied while advancing a texture.
+ *
+ * @see {@link TextureDefinition}
+ */
+export interface TextureFrame {
+    /** Elapsed time since the preceding texture frame, in milliseconds. See {@link TextureFrame}. */
+    readonly delta: number;
+    /** Current shared logical time, in milliseconds. See {@link TextureFrame}. */
+    readonly time: number;
+}
+/**
+ * Lifecycle callbacks for creating, updating, painting, and disposing texture resources.
+ *
+ * @see {@link TexturePlacement}
+ * @see {@link TextureContext}
+ * @see {@link TextureFrame}
+ * @see {@link defineTexture}
+ */
+export interface TextureDefinition<Config, State, Message = never> {
+    /**
+     * Texture placement used when no paint-specific override is supplied. See
+     * {@link TexturePlacement}.
+     */
+    readonly defaultPlacement?: TexturePlacement;
+    /**
+     * Allocates state for a mounted texture recipe. See {@link TextureDefinition}.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     * @param config - Initial recipe configuration.
+     * @returns State retained for this mounted texture lifetime.
+     */
+    create(context: TextureContext, config: Readonly<Config>): State;
+    /**
+     * Updates existing state when the recipe configuration changes. See {@link TextureDefinition}.
+     * @param state - State returned by create.
+     * @param config - Latest recipe configuration.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     */
+    update?(state: State, config: Readonly<Config>, context: TextureContext): void;
+    /**
+     * Handles a typed application message for this recipe instance. See {@link TextureDefinition}.
+     * @param state - State returned by create.
+     * @param message - Message sent through the mounted texture handle.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     */
+    receive?(state: State, message: Message, context: TextureContext): void;
+    /**
+     * Advances simulation using the shared Pibbl frame timing. See {@link TextureDefinition}.
+     * @param state - State returned by create.
+     * @param frame - Shared animation time and delta. See {@link TextureFrame}.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     */
+    advance?(state: State, frame: TextureFrame, context: TextureContext): void;
+    /**
+     * Draws current texture pixels into the owned offscreen surface. See {@link TextureDefinition}.
+     * @param state - State returned by create.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     */
+    rasterize(state: State, context: TextureContext): void;
+    /**
+     * Releases state and resources when the mounted texture is disposed. See
+     * {@link TextureDefinition}.
+     * @param state - State returned by create.
+     * @param context - Texture-owned drawing surface and scheduling services. See
+     * {@link TextureContext} .
+     */
+    dispose?(state: State, context: TextureContext): void;
+}
+/**
+ * A reusable texture definition together with the options used to instantiate it.
+ *
+ * @see {@link defineTexture}
+ * @see {@link useTexture}
+ */
+export interface TextureRecipe<Message = never> {
+    readonly [recipeBrand]: (message: Message) => Message;
+}
+/**
+ * Defines a pure recipe factory; resource allocation starts at useTexture.
+ *
+ * @param definition - State creation, update, simulation, rasterization, and disposal callbacks.
+ * See {@link TextureDefinition} .
+ * @returns A configuration-to-recipe factory; resources are allocated when a recipe is mounted.
+ * See {@link TextureRecipe} .
+ *
+ * @see {@link TextureDefinition}
+ * @see {@link TextureRecipe}
+ */
+export declare function defineTexture<Config, State, Message = never>(definition: TextureDefinition<Config, State, Message>): (config: Config) => TextureRecipe<Message>;
+/**
+ * Owns one persistent texture resource for the current mounted hook slot.
+ *
+ * @param input - Texture recipe to mount or update. See {@link TextureRecipe}.
+ * @param options - Resolution and lifecycle options for the mounted texture. See
+ * {@link TextureOptions} .
+ * @returns A mount-owned texture handle for sending messages and creating paint placements. See
+ * {@link Texture} .
+ *
+ * @see {@link TextureRecipe}
+ * @see {@link TextureOptions}
+ * @see {@link Texture}
+ */
+export declare function useTexture<Message>(input: TextureRecipe<Message>, options?: TextureOptions): Texture<Message>;