@flare-engine/render 0.4.7 → 0.4.10

package/dist/index.d.mts

@@ -498,7 +498,8 @@ interface SpriteDrawCommand {
    * Participates in the batch key. Flipped sprites are drawn via
    * `drawImageRect` with a canvas scale(-1, 1) transform — one draw call
    * per sprite (per-sprite draw call trade-off, documented).
-   * Unsupported in combination with rotation (same constraint as stretch mode).
+   * `rotation` is honoured: the renderer rotates about the anchor point (as
+   * the atlas path does) and then mirrors about the sprite centre.
    */
   flipX: boolean;
   /**
@@ -642,6 +643,16 @@ interface PaintLike {
    */
   setBlendMode?(mode: number): void;
 }
+/** Texture sampling mode for `FrameRenderer.setImageSampling`. */
+type ImageSampling = 'nearest' | 'linear';
+/**
+ * RN Skia's `FilterOptions` shape: `filter` is the FilterMode (0 = Nearest,
+ * 1 = Linear), `mipmap` the MipmapMode (0 = None, 1 = Nearest, 2 = Linear).
+ */
+interface SamplingOptionsLike {
+  filter: number;
+  mipmap?: number;
+}
 /** Minimal draw surface the frame-renderer calls into. */
 interface DrawSurfaceLike {
   save(): number;
@@ -651,8 +662,21 @@ interface DrawSurfaceLike {
   /** rotate(degrees, cx, cy) — DEGREES, forwarded verbatim (both Skia backends take degrees). */
   rotate(degrees: number, cx: number, cy: number): void;
   clear(color: Float32Array): void;
-  drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike): void;
+  /**
+   * `blendMode` and `colors` are positional placeholders in RN Skia's argument
+   * order; the renderer never fills them. `sampling` is passed only for an
+   * image with a `setImageSampling` setting — otherwise the call stops at `paint`.
+   */
+  drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike, blendMode?: undefined, colors?: undefined, sampling?: SamplingOptionsLike): void;
   drawImageRect(image: unknown, src: RectLike, dst: RectLike, paint: PaintLike): void;
+  /**
+   * Sampled stretch/flip draw — `filterMode` and `mipmapMode` are the numeric
+   * Skia enum values (see `SamplingOptionsLike`). `paint` is optional only to
+   * mirror RN Skia's `paint?: SkPaint | null`; the renderer always passes one.
+   * Optional — absent on some test stubs; when it is missing, a stretch draw
+   * of an image with a sampling setting falls back to `drawImageRect`.
+   */
+  drawImageRectOptions?(image: unknown, src: RectLike, dst: RectLike, filterMode: number, mipmapMode: number, paint?: PaintLike | null): void;
   drawRect(rect: RectLike, paint: PaintLike): void;
 }
 /**
@@ -730,7 +754,24 @@ interface FrameRenderer {
   readonly canvas: CanvasLike;
   beginFrame(viewportWidth: number, viewportHeight: number, time?: number, pixelDensity?: number): void;
   drawAtlas(image: SkImageLike, commands: SpriteDrawCommand[]): void;
+  /**
+   * Set the texture sampling for every draw of `image` (an atlas or a texture)
+   * on both the atlas path and the stretch/flip path. The last call wins. An
+   * image with no setting keeps each path's own Skia default: linear on the
+   * atlas path (`drawAtlas`), nearest on the stretch path (`drawImageRect`).
+   * Throws `RangeError` for a mode other than `'nearest'` or `'linear'`.
+   */
+  setImageSampling(image: SkImageLike, sampling: ImageSampling): void;
   buildPostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererPostFxDescriptor[];
+  /**
+   * The compiled passes exactly as the runtime builds them — `uniforms` is the
+   * packed Float32Array `makeShaderWithChildren` takes. `buildPostFxPasses`
+   * derives its named JSX descriptors from these; an imperative compositor
+   * (GameView's web path) draws from them directly. Same null/unsupported/
+   * no-chain rules as `buildPostFxPasses` (empty array), same
+   * `runtime ?? bound`, `chain ?? bound` resolution.
+   */
+  compilePostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererCompiledPass[];
   setPostFxBinding(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null): void;
   /**
    * Whether `buildPostFxPasses` would attempt to build passes from the bound
@@ -931,5 +972,5 @@ export declare function measureText(font: BitmapFont, text: string): number;
  * Characters are batched as individual sprites from the font texture.
  */
 export declare function drawText(batch: SpriteBatch, font: BitmapFont, image: SkImageLike, text: string, x: number, y: number, scale?: number): void;
-export type { AnySpriteEffect, BatchCullBounds, BitmapFont, CanvasLike, CaveInteriorEffect, ColorFilterFactoryLike, CompiledShader, CustomShaderEffect, DrawSurfaceLike, Drawable, DropShadowEffect, FireEffect, FlashEffect, FogEffect, FollowOptions, ForestCanopyEffect, FrameRenderer, FrameRendererCompiledPass, FrameRendererModule, FrameRendererPostFxChain, FrameRendererPostFxDescriptor, FrameRendererPostFxRuntime, Glyph, GrayscaleEffect, ImageFilterFactoryLike, KerningPair, MoonCraterEffect, MountainHillsEffect, OutlineEffect, PaintLike, PictureLike, PictureRecorderLike, PositionData, RSXformLike, RectLike, RenderStats, RiverWaveEffect, RoofsCityEffect, RuntimeEffectFactoryLike, RuntimeEffectLike, ShaderUniforms, SpriteAnchor, SpriteColor, SpriteData, SpriteDrawCommand, SpriteEffect, TintEffect, WaterEffect };
+export type { AnySpriteEffect, BatchCullBounds, BitmapFont, CanvasLike, CaveInteriorEffect, ColorFilterFactoryLike, CompiledShader, CustomShaderEffect, DrawSurfaceLike, Drawable, DropShadowEffect, FireEffect, FlashEffect, FogEffect, FollowOptions, ForestCanopyEffect, FrameRenderer, FrameRendererCompiledPass, FrameRendererModule, FrameRendererPostFxChain, FrameRendererPostFxDescriptor, FrameRendererPostFxRuntime, Glyph, GrayscaleEffect, ImageFilterFactoryLike, ImageSampling, KerningPair, MoonCraterEffect, MountainHillsEffect, OutlineEffect, PaintLike, PictureLike, PictureRecorderLike, PositionData, RSXformLike, RectLike, RenderStats, RiverWaveEffect, RoofsCityEffect, RuntimeEffectFactoryLike, RuntimeEffectLike, SamplingOptionsLike, ShaderUniforms, SpriteAnchor, SpriteColor, SpriteData, SpriteDrawCommand, SpriteEffect, TintEffect, WaterEffect };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/camera2d.ts","../src/draw-order.ts","../src/renderer.ts","../src/sprite-effects.ts","../src/sprite-batch.ts","../src/frame-renderer.ts","../src/nine-slice.ts","../src/render-system.ts","../src/shaders.ts","../src/sprite-font.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/camera2d.ts","../src/draw-order.ts","../src/renderer.ts","../src/sprite-effects.ts","../src/sprite-batch.ts","../src/frame-renderer.ts","../src/nine-slice.ts","../src/render-system.ts","../src/shaders.ts","../src/sprite-font.ts"],"mappings":";;;;UAGiB;;EAEf;;EAEA,SAAS;;EAET,WAAW;;;;;;;qBAiGA;;EAEX;EACA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,QAAQ;UAEA;UACA;UACA;UACA;UACA;UACA;;EAGR,YAAY,eAAe;;EAM3B,OAAO,QAAQ,MAAM,UAAU;;EAK/B;;;;;;;;;;;;EAeA,eAAe;;MAKX;;EAKJ,MAAM,mBAAmB;;;;;EAoBzB,YAAY,mBAAmB;;;;;EAoB/B,OAAO;;MAuEH;;MAKA;;EAKJ,cAAc,gBAAgB,iBAAiB;;EAK/C,kBAAkB,gBAAgB,gBAAgB,KAAK,OAAO;;EAW9D,cAAc,iBAAiB,kBAAkB;;EAKjD,kBAAkB,iBAAiB,iBAAiB,KAAK,OAAO;;EAahE,aAAa;;EAKb,cAAc,KAAK,OAAO;UAUlB;;;UCnVO;;EAEf;;;;;;;;;;;;;wBAcc,gBAAgB,UAAU,UAAU,OAAO,KAAK,kBAAkB;;;;;wBAmBlE,iBAAiB,GAAG,UAAU,GAAG;;UCnChC;EACf;EACA;EACA,UAAU,WAAW;EACrB,MAAM,YAAY;;EAElB,OAAO,iBAAiB,YAAY;EACpC,MAAM;;;UAIS;;;;;;;;;;EAUf;;;;;;;;EAQA;;;;;;qBAOW;;WAEF,OAAO;UAER;UACA;;EAGR,UAAU,QAAQ;;MAKd,UAAU;;MAQV;;;;;EAQJ,MAAM;;;;EAcN;;;;;EAYA,YACE,iBACA,iBACA,cACA,kBACA,uBACA;;;EAkBF;;;EAMA;;;UCzHe;WACN;WACA;WACA;WACA;;;UAIM;WACN;;;UAIM,mBAAmB;WACzB;WACA,OAAO;WACP;;;UAIM,oBAAoB;WAC1B;WACA,OAAO;WACP;WACA;;;UAIM,wBAAwB;WAC9B;WACA;;;UAIM,sBAAsB;WAC5B;WACA,OAAO;WACP;;;;;;;;KASC;;KAGA,iBAAiB;;UAGZ,2BAA2B;WACjC;WACA,QAAQ;WACR,UAAU;;;UAIJ,oBAAoB;WAC1B;WACA,OAAO;WACP,WAAW;WACX;WACA;;;UAIM,kBAAkB;WACxB;WACA,OAAO;WACP;WACA;WACA;;;UAIM,mBAAmB;WACzB;WACA,OAAO;WACP,UAAU;WACV;WACA;;;;;;;;UASM,yBAAyB;WAC/B;;WAEA;;WAEA;;WAEA;;WAEA,OAAO;;;UAQD,wBAAwB;WAC9B;WACA,UAAU;WACV,WAAW;WACX;WACA;;WAEA;;WAEA;;;UAIM,2BAA2B;WACjC;WACA,UAAU;WACV,WAAW;WACX;WACA;WACA;WACA;;;UAIM,wBAAwB;WAC9B;WACA,YAAY;WACZ,WAAW;WACX;WACA;WACA;WACA;;;UAIM,yBAAyB;WAC/B;WACA,WAAW;WACX,aAAa;WACb;WACA;WACA;WACA;;;UAIM,2BAA2B;WACjC;WACA,WAAW;WACX,WAAW;WACX;WACA;WACA;WACA;;;UAIM,4BAA4B;WAClC;WACA,UAAU;WACV,WAAW;WACX;WACA;WACA;WACA;;;KAIC,kBACR,aACA,cACA,kBACA,gBACA,qBACA,cACA,YACA,aACA,mBACA,kBACA,qBACA,kBACA,mBACA,qBACA;;wBAGY,KAAK,OAAO,aAAa,iBAAiB;;wBAK1C,MAAM,OAAO,aAAa,sBAAsB;;wBAKhD,UAAU,iBAAiB;;wBAK3B,QAAQ,OAAO,aAAa,gBAAgB;;;;wBAO5C,OAAO,QAAQ,gBAAgB,UAAU,iBAAiB;;;wBAM1D,MACd,OAAO,aACP,WAAW,aACX,mBACA,wBACC;;;wBAMa,IAAI,OAAO,aAAa,kBAAe,gBAAa,iBAAc;;;wBAMlE,KAAK;EACnB,OAAO;EACP,UAAU;EACV;EACA;IACE;;;wBAYY,WAAW;EACzB,OAAO;EACP;EACA;EACA;IACE;;wBAWY,UAAU;EACxB,UAAU;EACV,WAAW;EACX;EACA;EACA;EACA;IACE;;wBAaY,aAAa;EAC3B,UAAU;EACV,WAAW;EACX;EACA;EACA;EACA;IACE;;wBAaY,UAAU;EACxB,YAAY;EACZ,WAAW;EACX;EACA;EACA;EACA;IACE;;wBAaY,WAAW;EACzB,WAAW;EACX,aAAa;EACb;EACA;EACA;EACA;IACE;;wBAaY,aAAa;EAC3B,WAAW;EACX,WAAW;EACX;EACA;EACA;EACA;IACE;;wBAaY,cAAc;EAC5B,UAAU;EACV,WAAW;EACX;EACA;EACA;EACA;IACE;;;;;;;;;;;wBAsBY,aAAa,QAAQ,iBAAiB,aAAa;;;;wBAYnD,eAAe,QAAQ;;;;;UCtZtB;WACN;WACA;WACA;WACA;;;UAIM;;EAEf,OAAO;;EAEP;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;;;EAGA,QAAQ;;;;;EAKR;;;EAGA;;EAEA;;EAEA;;;;;;;;;;;;;;EAcA;;;;;;;;EAQA;;;;;;;;;EASA;;;;;EAKA;;;;;;;;;;;;;;;;;qBA8BW;UACH;UACA;UACA;UACA;UACA;;MAGJ;;;MAMA;;;;;;MASA,cAAc;;;EAMlB,cAAc,cAAc,cAAc,cAAc;;EAYxD;;;;;;;;;EAYA,KACE,OAAO,aACP,OAAO,aACP,cACA,cACA,eACA,eACA,SAAS,iBACT,kBACA,kBACA,gBACA,mBACA,mBACA,+BACA,iBACA;;;;;EA8BF,QACE,OAAO,aACP,cACA,cACA,cACA,cACA,cACA,cACA,cACA,cACA,SAAS,iBACT,kBACA,kBACA,gBACA,mBACA,mBACA,+BACA,iBACA;;;;;;;;;;;;;EAoCF,MACE,YAAY,OAAO,aAAa,UAAU,8BAC1C,WAAW;;EAsEb;UAOQ;;;;;;;;;UCzQO;EACf;EACA;EACA;EACA;EACA,QAAQ,WAAW,WAAW,WAAW;;;;;;;;;UAU1B;EACf;EACA;EACA;EACA;EACA,IAAI,cAAc,cAAc,YAAY;;;UAI7B;EACf,WAAW;EACX;EACA;EACA,eAAe;EACf,WAAW;IAAkB;IAAiB;IAAc;;;;UAI7C;EACf,UAAU,OAAO,cAAc;EAC/B,WAAW;;;UAII;EACf,eACE,YACA,YACA,gBACA,gBACA,OAAO,cACP;;;UAKa;EACf,KAAK,eAAe;;;UAIL;EACf,UAAU;EACV,UAAU,OAAO;EACjB,eAAe;EACf,UAAU;EACV,eAAe;;;;;;EAMf,cAAc;;;KAIJ;;;;;UAMK;EACf;EACA;;;UAIe;EACf;EACA;EACA,UAAU,WAAW;EACrB,MAAM,YAAY;;EAElB,OAAO,iBAAiB,YAAY;EACpC,MAAM,OAAO;;;;;;EAMb,UACE,gBACA,UAAU,YACV,WAAW,eACX,OAAO,WACP,uBACA,oBACA,WAAW;EAEb,cAAc,gBAAgB,KAAK,UAAU,KAAK,UAAU,OAAO;;;;;;;;EAQnE,sBACE,gBACA,KAAK,UACL,KAAK,UACL,oBACA,oBACA,QAAQ;EAEV,SAAS,MAAM,UAAU,OAAO;;;;;;;;KAStB;;UAGK;EACf,eAAe,QAAQ,WAAW;EAClC,4BAA4B;;;;;;;;;;UAWb;EACf,SAAS,WAAW,WAAW,WAAW,YAAY;EACtD,QAAQ,cAAc,cAAc,YAAY,aAAa;EAC7D,SAAS;EACT,mBAAmB;EACnB,aAAa;EACb,gBAAgB;EAChB,cAAc;;;;;UAMC;WACN;WACA;IACP,uBAAuB,UAAU,yBAAyB;IAC1D;IACA,gBAAgB;IAChB,YAAY;MAAkB;MAAiB;MAAc;;;WAEtD,UAAU;WACV;;;UAIM;WACN;EACT,WACE,OAAO,0BACP,eACA,0BACU;;;UAIG;EACf,WAAW;;;UAII;WACN;WACA;WACA,UAAU;WACV;;;;;;;;;;UAWM;WACN,QAAQ;EACjB,WACE,uBACA,wBACA,eACA;EAEF,UAAU,OAAO,aAAa,UAAU;;;;;;;;EAQxC,iBAAiB,OAAO,aAAa,UAAU;EAC/C,kBACE,SAAS,mCACT,OAAO,iCACP,eACA,0BACU;;;;;;;;;EASZ,oBACE,SAAS,mCACT,OAAO,iCACP,eACA,0BACU;EACZ,iBACE,SAAS,mCACT,OAAO;;;;;;EAOT;EACA,YAAY;;;;;;;;wBAkDE,oBAAoB,MAAM,sBAAsB;;wBAqsBhD;;;;;;;;;;;;;wBAiBA;EAAsB;EAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBCziCvC,cACd,OAAO,aACP,OAAO,aACP,OAAO,aACP,WACA,WACA,WACA,WACA,eACA,SAAS,iBACT;;UCrCe;EACf;EACA;;;;;;UAOe;EACf;EACA;;;UAIe;EACf,OAAO;EACP,OAAO;EACP;EACA;EACA;;;;EAIA,SAAS;;EAET,SAAS;;;;EAIT;;;;EAIA;;;;;;;;;;;EAWA;;;;;;;EAOA;;;;EAIA;;EAEA;;;;;;;;;;;;;;;;;;;;wBA2Bc,mBACd,OAAO,OACP,OAAO,OACP,aAAa,aAAa,eAC1B,WAAW,aAAa,aACxB,OAAO;;qBA6DI,QAAM,aAAA;qBC/JN;qBAmCA;qBA0CA;qBA0BA;qBA6BA;qBA8BA;qBAyBA;qBAkCA;qBAgCA;;UCzPI;;EAEf;;EAEA;EACA;EACA;EACA;;EAEA;EACA;;EAEA;;;UAIe;EACf;EACA;EACA;;;UAIe;;EAEf;;EAEA;;EAEA,QAAQ,YAAY;;EAEpB,UAAU;;;;;wBAMI,gBAAgB,gBAAgB;;wBA8ChC,WAAW,MAAM,YAAY,eAAe;;wBAK5C,YAAY,MAAM,YAAY;;;;;wBAoB9B,SACd,OAAO,aACP,MAAM,YACN,OAAO,aACP,cACA,WACA,WACA"}

package/dist/index.d.ts

@@ -498,7 +498,8 @@ interface SpriteDrawCommand {
    * Participates in the batch key. Flipped sprites are drawn via
    * `drawImageRect` with a canvas scale(-1, 1) transform — one draw call
    * per sprite (per-sprite draw call trade-off, documented).
-   * Unsupported in combination with rotation (same constraint as stretch mode).
+   * `rotation` is honoured: the renderer rotates about the anchor point (as
+   * the atlas path does) and then mirrors about the sprite centre.
    */
   flipX: boolean;
   /**
@@ -642,6 +643,16 @@ interface PaintLike {
    */
   setBlendMode?(mode: number): void;
 }
+/** Texture sampling mode for `FrameRenderer.setImageSampling`. */
+type ImageSampling = 'nearest' | 'linear';
+/**
+ * RN Skia's `FilterOptions` shape: `filter` is the FilterMode (0 = Nearest,
+ * 1 = Linear), `mipmap` the MipmapMode (0 = None, 1 = Nearest, 2 = Linear).
+ */
+interface SamplingOptionsLike {
+  filter: number;
+  mipmap?: number;
+}
 /** Minimal draw surface the frame-renderer calls into. */
 interface DrawSurfaceLike {
   save(): number;
@@ -651,8 +662,21 @@ interface DrawSurfaceLike {
   /** rotate(degrees, cx, cy) — DEGREES, forwarded verbatim (both Skia backends take degrees). */
   rotate(degrees: number, cx: number, cy: number): void;
   clear(color: Float32Array): void;
-  drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike): void;
+  /**
+   * `blendMode` and `colors` are positional placeholders in RN Skia's argument
+   * order; the renderer never fills them. `sampling` is passed only for an
+   * image with a `setImageSampling` setting — otherwise the call stops at `paint`.
+   */
+  drawAtlas(image: unknown, srcRects: RectLike[], dstXforms: RSXformLike[], paint: PaintLike, blendMode?: undefined, colors?: undefined, sampling?: SamplingOptionsLike): void;
   drawImageRect(image: unknown, src: RectLike, dst: RectLike, paint: PaintLike): void;
+  /**
+   * Sampled stretch/flip draw — `filterMode` and `mipmapMode` are the numeric
+   * Skia enum values (see `SamplingOptionsLike`). `paint` is optional only to
+   * mirror RN Skia's `paint?: SkPaint | null`; the renderer always passes one.
+   * Optional — absent on some test stubs; when it is missing, a stretch draw
+   * of an image with a sampling setting falls back to `drawImageRect`.
+   */
+  drawImageRectOptions?(image: unknown, src: RectLike, dst: RectLike, filterMode: number, mipmapMode: number, paint?: PaintLike | null): void;
   drawRect(rect: RectLike, paint: PaintLike): void;
 }
 /**
@@ -730,7 +754,24 @@ interface FrameRenderer {
   readonly canvas: CanvasLike;
   beginFrame(viewportWidth: number, viewportHeight: number, time?: number, pixelDensity?: number): void;
   drawAtlas(image: SkImageLike, commands: SpriteDrawCommand[]): void;
+  /**
+   * Set the texture sampling for every draw of `image` (an atlas or a texture)
+   * on both the atlas path and the stretch/flip path. The last call wins. An
+   * image with no setting keeps each path's own Skia default: linear on the
+   * atlas path (`drawAtlas`), nearest on the stretch path (`drawImageRect`).
+   * Throws `RangeError` for a mode other than `'nearest'` or `'linear'`.
+   */
+  setImageSampling(image: SkImageLike, sampling: ImageSampling): void;
   buildPostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererPostFxDescriptor[];
+  /**
+   * The compiled passes exactly as the runtime builds them — `uniforms` is the
+   * packed Float32Array `makeShaderWithChildren` takes. `buildPostFxPasses`
+   * derives its named JSX descriptors from these; an imperative compositor
+   * (GameView's web path) draws from them directly. Same null/unsupported/
+   * no-chain rules as `buildPostFxPasses` (empty array), same
+   * `runtime ?? bound`, `chain ?? bound` resolution.
+   */
+  compilePostFxPasses(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null, width: number, height: number): readonly FrameRendererCompiledPass[];
   setPostFxBinding(runtime: FrameRendererPostFxRuntime | null, chain: FrameRendererPostFxChain | null): void;
   /**
    * Whether `buildPostFxPasses` would attempt to build passes from the bound
@@ -931,5 +972,5 @@ export declare function measureText(font: BitmapFont, text: string): number;
  * Characters are batched as individual sprites from the font texture.
  */
 export declare function drawText(batch: SpriteBatch, font: BitmapFont, image: SkImageLike, text: string, x: number, y: number, scale?: number): void;
-export type { AnySpriteEffect, BatchCullBounds, BitmapFont, CanvasLike, CaveInteriorEffect, ColorFilterFactoryLike, CompiledShader, CustomShaderEffect, DrawSurfaceLike, Drawable, DropShadowEffect, FireEffect, FlashEffect, FogEffect, FollowOptions, ForestCanopyEffect, FrameRenderer, FrameRendererCompiledPass, FrameRendererModule, FrameRendererPostFxChain, FrameRendererPostFxDescriptor, FrameRendererPostFxRuntime, Glyph, GrayscaleEffect, ImageFilterFactoryLike, KerningPair, MoonCraterEffect, MountainHillsEffect, OutlineEffect, PaintLike, PictureLike, PictureRecorderLike, PositionData, RSXformLike, RectLike, RenderStats, RiverWaveEffect, RoofsCityEffect, RuntimeEffectFactoryLike, RuntimeEffectLike, ShaderUniforms, SpriteAnchor, SpriteColor, SpriteData, SpriteDrawCommand, SpriteEffect, TintEffect, WaterEffect };
+export type { AnySpriteEffect, BatchCullBounds, BitmapFont, CanvasLike, CaveInteriorEffect, ColorFilterFactoryLike, CompiledShader, CustomShaderEffect, DrawSurfaceLike, Drawable, DropShadowEffect, FireEffect, FlashEffect, FogEffect, FollowOptions, ForestCanopyEffect, FrameRenderer, FrameRendererCompiledPass, FrameRendererModule, FrameRendererPostFxChain, FrameRendererPostFxDescriptor, FrameRendererPostFxRuntime, Glyph, GrayscaleEffect, ImageFilterFactoryLike, ImageSampling, KerningPair, MoonCraterEffect, MountainHillsEffect, OutlineEffect, PaintLike, PictureLike, PictureRecorderLike, PositionData, RSXformLike, RectLike, RenderStats, RiverWaveEffect, RoofsCityEffect, RuntimeEffectFactoryLike, RuntimeEffectLike, SamplingOptionsLike, ShaderUniforms, SpriteAnchor, SpriteColor, SpriteData, SpriteDrawCommand, SpriteEffect, TintEffect, WaterEffect };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/camera2d.ts","../src/draw-order.ts","../src/renderer.ts","../src/sprite-effects.ts","../src/sprite-batch.ts","../src/frame-renderer.ts","../src/nine-slice.ts","../src/render-system.ts","../src/shaders.ts","../src/sprite-font.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/camera2d.ts","../src/draw-order.ts","../src/renderer.ts","../src/sprite-effects.ts","../src/sprite-batch.ts","../src/frame-renderer.ts","../src/nine-slice.ts","../src/render-system.ts","../src/shaders.ts","../src/sprite-font.ts"],"mappings":"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"}

package/dist/index.js

@@ -783,12 +783,21 @@ function flashIntensity(effect) {
 // src/frame-renderer.ts
 /** See the dev-flag note at the top of this file. */
 const G = globalThis;
+/** `SpriteDrawCommand.rotation` is radians; `DrawSurfaceLike.rotate` takes degrees. */
+const RAD_TO_DEG = 180 / Math.PI;
 const BLEND_SRC_OVER = 3;
 const BLEND_SRC_IN = 5;
 /** Skia BlendMode.SrcATop — r = s·da + d·(1−sa): keeps the art's alpha, lerps colour by the filter's alpha. */
 const BLEND_SRC_ATOP = 9;
 /** Skia BlendMode.Plus — additive: dst = clamp(src + dst). */
 const BLEND_PLUS = 12;
+/** Shared empty result for `compilePostFxPasses`, so a chain-free frame allocates nothing. */
+const EMPTY_COMPILED_PASSES = [];
+/** The two sampling objects `setImageSampling` hands to the surface — shared, never rebuilt. */
+const SAMPLING_NEAREST = { filter: 0 };
+const SAMPLING_LINEAR = { filter: 1 };
+/** Skia MipmapMode.None — the stretch path never mipmaps. */
+const MIPMAP_NONE = 0;
 const OUTLINE_OFFSETS = [
 	[1, 0],
 	[-1, 0],
@@ -847,6 +856,7 @@ function createFrameRenderer(Skia) {
 	const stretchDstRects = [];
 	let stretchPaint = null;
 	const zoneBgRects = [];
+	const imageSampling = /* @__PURE__ */ new WeakMap();
 	let _cachedSrcSlice = null;
 	let _cachedSrcSliceLen = 0;
 	let _cachedXformSlice = null;
@@ -894,6 +904,17 @@ function createFrameRenderer(Skia) {
 		_loggedOnce.add(msg);
 		console.warn(`[postfx] ${msg}`);
 	}
+	function compilePostFxPasses(runtime, chain, width, height) {
+		const rt = runtime ?? _boundRuntime;
+		const ch = chain ?? _boundChain;
+		if (rt === null || !rt.supported) return EMPTY_COMPILED_PASSES;
+		if (rt.buildPass === void 0) {
+			logOnce("buildPostFxPasses: runtime.supported but buildPass absent — no passes");
+			return EMPTY_COMPILED_PASSES;
+		}
+		if (ch === null) return EMPTY_COMPILED_PASSES;
+		return rt.buildPass(ch, width, height);
+	}
 	const canvas = {
 		save: () => current?.save() ?? 0,
 		restore: () => {
@@ -1202,21 +1223,19 @@ function createFrameRenderer(Skia) {
 		mountainHillsPaint.setShader(mountainHillsEffect.makeShader(mountainHillsUniforms));
 		return mountainHillsPaint;
 	}
-	function drawOutlined(cvs, image, commands, n, effect, alpha) {
+	function drawOutlined(cvs, image, commands, n, effect, alpha, sampling) {
 		const paint = applyOutlinePaint(effect);
 		paint.setAlphaf(alpha);
 		const srcs = getCachedSrcSlice(n);
 		for (let k = 0; k < OUTLINE_OFFSETS.length; k++) {
 			const offset = OUTLINE_OFFSETS[k];
 			fillXforms(commands, n, offset[0] * effect.width, offset[1] * effect.width);
-			const dsts = getCachedXformSlice(n);
-			cvs.drawAtlas(image, srcs, dsts, paint);
+			drawAtlasSampled(cvs, image, srcs, getCachedXformSlice(n), paint, sampling);
 		}
 		paint.setAlphaf(1);
 		defaultPaint.setAlphaf(alpha);
 		fillXforms(commands, n, 0, 0);
-		const mainDsts = getCachedXformSlice(n);
-		cvs.drawAtlas(image, srcs, mainDsts, defaultPaint);
+		drawAtlasSampled(cvs, image, srcs, getCachedXformSlice(n), defaultPaint, sampling);
 		defaultPaint.setAlphaf(1);
 	}
 	function resolveEffectPaint(effect) {
@@ -1260,6 +1279,7 @@ function createFrameRenderer(Skia) {
 			const blendAdditive = cmd0.blend === "additive";
 			const flipX = cmd0.flipX;
 			const flipY = cmd0.flipY;
+			const sampling = imageSampling.get(image);
 			currentSpriteW = cmd0.dstW;
 			currentSpriteH = cmd0.dstH;
 			if (effect?.type === "roofs-city" || effect?.type === "forest-canopy" || effect?.type === "river-wave" || effect?.type === "moon-crater" || effect?.type === "cave-interior" || effect?.type === "mountain-hills") {
@@ -1293,12 +1313,13 @@ function createFrameRenderer(Skia) {
 						const cx = cmd.dstX + cmd.dstW * .5;
 						const cy = cmd.dstY + cmd.dstH * .5;
 						current.save();
+						if (cmd.rotation !== 0) current.rotate(cmd.rotation * RAD_TO_DEG, cmd.dstX + cmd.anchorX * cmd.dstW, cmd.dstY + cmd.anchorY * cmd.dstH);
 						current.translate(cx, cy);
 						current.scale(cmd.flipX ? -1 : 1, cmd.flipY ? -1 : 1);
 						current.translate(-cx, -cy);
-						current.drawImageRect(image, srcR, dstR, sPaint);
+						drawImageRectSampled(current, image, srcR, dstR, sPaint, sampling);
 						current.restore();
-					} else current.drawImageRect(image, srcR, dstR, sPaint);
+					} else drawImageRectSampled(current, image, srcR, dstR, sPaint, sampling);
 				}
 				sPaint.setAlphaf(1);
 				if (blendAdditive) sPaint.setBlendMode?.(BLEND_SRC_OVER);
@@ -1311,7 +1332,7 @@ function createFrameRenderer(Skia) {
 					outlinePaint?.setBlendMode?.(BLEND_PLUS);
 					defaultPaint.setBlendMode?.(BLEND_PLUS);
 				}
-				drawOutlined(current, image, commands, n, effect, alpha);
+				drawOutlined(current, image, commands, n, effect, alpha, sampling);
 				if (blendAdditive) {
 					outlinePaint?.setBlendMode?.(BLEND_SRC_OVER);
 					defaultPaint.setBlendMode?.(BLEND_SRC_OVER);
@@ -1324,10 +1345,15 @@ function createFrameRenderer(Skia) {
 			const paint = effect === void 0 ? defaultPaint : resolveEffectPaint(effect);
 			if (blendAdditive) paint.setBlendMode?.(BLEND_PLUS);
 			paint.setAlphaf(alpha);
-			current.drawAtlas(image, srcs, dsts, paint);
+			drawAtlasSampled(current, image, srcs, dsts, paint, sampling);
 			paint.setAlphaf(1);
 			if (blendAdditive) paint.setBlendMode?.(BLEND_SRC_OVER);
 		},
+		setImageSampling(image, sampling) {
+			if (sampling === "nearest") imageSampling.set(image, SAMPLING_NEAREST);
+			else if (sampling === "linear") imageSampling.set(image, SAMPLING_LINEAR);
+			else throw new RangeError(`setImageSampling: unknown sampling '${String(sampling)}' (expected 'nearest' or 'linear')`);
+		},
 		setPostFxBinding(runtime, chain) {
 			_boundRuntime = runtime;
 			_boundChain = chain;
@@ -1335,16 +1361,9 @@ function createFrameRenderer(Skia) {
 		hasPostFxBinding() {
 			return _boundRuntime !== null && !!_boundRuntime.supported && _boundRuntime.buildPass !== void 0 && _boundChain !== null;
 		},
+		compilePostFxPasses,
 		buildPostFxPasses(runtime, chain, width, height) {
-			const rt = runtime ?? _boundRuntime;
-			const ch = chain ?? _boundChain;
-			if (rt === null || !rt.supported) return [];
-			if (rt.buildPass === void 0) {
-				logOnce("buildPostFxPasses: runtime.supported but buildPass absent — no passes");
-				return [];
-			}
-			if (ch === null) return [];
-			const passes = rt.buildPass(ch, width, height);
+			const passes = compilePostFxPasses(runtime, chain, width, height);
 			if (passes.length === 0) return [];
 			const out = [];
 			for (const pass of passes) {
@@ -1405,6 +1424,15 @@ function getXformCounters() {
 		unrotated: _xformUnrotatedCount
 	};
 }
+/** Without a sampling setting this is exactly the 4-argument call the surface always received. */
+function drawAtlasSampled(cvs, image, srcs, dsts, paint, sampling) {
+	if (sampling === void 0) cvs.drawAtlas(image, srcs, dsts, paint);
+	else cvs.drawAtlas(image, srcs, dsts, paint, void 0, void 0, sampling);
+}
+function drawImageRectSampled(cvs, image, src, dst, paint, sampling) {
+	if (sampling === void 0 || cvs.drawImageRectOptions === void 0) cvs.drawImageRect(image, src, dst, paint);
+	else cvs.drawImageRectOptions(image, src, dst, sampling.filter, MIPMAP_NONE, paint);
+}
 function writeColor(out, color, alphaMul) {
 	out[0] = color.r;
 	out[1] = color.g;