@codexo/exojs 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -12,6 +12,131 @@ merged pull requests and commits since the previous tag (each with its commit /
 PR link); `pnpm release:notes` then renders that section into the published
 GitHub release with a `PREVIOUS_TAG...CURRENT_TAG` compare link.
 
+## [0.13.0] - 2026-06-13
+
+The scalable-sprites and tilemap release. `TextureRegion`, `NineSliceSprite`,
+and `RepeatingSprite` bring nine-slice and tiled-repeat rendering to both
+backends. `@codexo/exojs-tilemap` is introduced as a generic, format-independent
+tilemap runtime foundation. `@codexo/exojs-tiled` is expanded from its v0.12
+stub into the parsed Tiled source adapter and runtime conversion layer.
+
+### Added
+
+- **Scalable sprites.** `NineSliceSprite` renders a texture subdivided into
+  nine regions (four corners, four edges, and a centre) with per-edge repeat
+  modes (`stretch`, `repeat`, `mirror-repeat`) and size fits (`clip`, `round`).
+  Dedicated WebGL2 and WebGPU instanced renderers batch by texture and blend
+  mode. Source slices and destination borders are independently configured
+  through `edgeFit` and `centerFit` (#110).
+
+- **`RepeatingSprite`** tiles a `Texture` or `TextureRegion` across a target
+  area with independent `modeX`/`modeY` (`stretch`, `repeat`, `mirror-repeat`)
+  and `fitX`/`fitY` (`clip`, `round`). A bare `Texture` uses the shader/sampler
+  path; a `TextureRegion` uses the geometry path. Dedicated WebGL2 and WebGPU
+  renderers batch by texture and blend mode; sampler and strategy changes
+  create additional batch boundaries (#111).
+
+- **`TextureRegion`.** An immutable structural type identifying a sub-rectangle
+  of a `Texture` without duplicating GPU resources. Used by nine-slice and
+  repeating sprites, tilemap tiles, and any consumer that operates on a
+  sub-area of an atlas (#109).
+
+- **Render-only pixel snapping.** `Drawable.pixelSnapMode` accepts `none`,
+  `position`, or `geometry`, snapping only the visual transform without
+  disturbing the logical model. The effective mode degrades automatically for
+  non-axis-aligned sprites (#116).
+
+- **TransformBuffer upload coalescing.** `RenderPlanPlayer` prepares all
+  transforms for a render scope before draw execution. The first renderer
+  flush uploads the stable transform range; subsequent flushes reuse it
+  through the hash guard, eliminating repeated uploads of growing ranges
+  within a scope (#118).
+
+- **Renderer performance benchmark harness.** Structural metric sweep for
+  `Sprite`, `NineSliceSprite`, `RepeatingSprite`, and `Tilemap` renderers
+  (WebGL2, recording fake GL context for deterministic GPU-free metrics).
+  Profiling mode gated behind `EXOJS_PERF_PROFILE` (#117).
+
+- **`@codexo/exojs-tilemap` — generic tilemap runtime.** `TileMap` manages
+  tilesets, layers, and mutation. `TileLayer` holds a sparse packed-tile array
+  with configurable chunk dimensions (default 32×32). `TileSet` indexes tile
+  definitions by local ID. Scene-graph nodes (`TileMapNode`, `TileLayerNode`)
+  provide per-pixel positioning with `Container` children, chunk-level culling,
+  and `TileMapBand` for actor interleaving. `TileMapView` maps layer selections
+  to bands declaratively. Chunk rendering uses instanced WebGL2 and WebGPU
+  renderers batched by compatible state and tileset texture. `ReadonlyTileChunk`
+  is the public immutable chunk view (#112, #114, #115).
+
+- **`@codexo/exojs-tiled` — Tiled map format adapter.** Loads finite orthogonal
+  TMJ/TSJ maps through `Loader.load(TileMap, 'map.tmj')` for a ready-to-use
+  runtime `TileMap` or `Loader.load(TiledMap, 'map.tmj')` for the structured,
+  dependency-resolved source model. `TiledMap` resolves external tileset
+  references, validates the source against the Tiled schema, and exposes
+  `toTileMap()` for synchronous runtime conversion. Supports multiple tilesets
+  (external and embedded), tile flip flags, custom properties, and sub-URL
+  resolution. Ships `tiledExtension` for one-line setup (#113).
+
+- **Extension descriptor dependencies.** The `Extension` interface accepts
+  `dependencies?: readonly Extension[]`. Each dependency references another
+  extension descriptor object. Dependencies are materialised before dependents;
+  the snapshot resolver deduplicates the same descriptor object, rejects
+  same-ID/different-object conflicts, and detects cycles. This ensures
+  `@codexo/exojs-tiled`'s tilemap foundation is loaded before Tiled bindings
+  are registered (#107).
+
+- **Typed declarative asset bindings.** `AssetBinding<Result, Options>` and
+  `AssetHandler<Result, Options>` carry typed result and option generics.
+  Handlers may provide `getIdentityKey(request)` to define deterministic
+  result-sensitive cache identity. The `Loader.load(type, path)` overloads
+  return the declared `Result` type without manual casting (#108).
+
+### Fixed
+
+- **Extension package CI path coverage.** A PR touching only extension-package
+  source no longer skips the unit, package-verify, and browser lanes (#120).
+
+- **Package ESLint hardening.** Extension package source files are linted
+  with typed `@typescript-eslint` rules through `projectService`, resolving
+  the prior exit-code-2 crash. Package lint is enforced in CI alongside root
+  lint. Genuine import-sorting and type-annotation lint defects in extension
+  tests are fixed.
+
+- **API documentation synchronisation.** `site/scripts/build-api.ts` now
+  processes `@codexo/exojs-tilemap` alongside the other official extension
+  packages. The `tilemap` subsystem appears in the API index and content
+  collection schema. A deterministic `docs:api:check` command verifies that
+  committed API docs match a fresh generation from source.
+
+### Known Limitations
+
+- **Infinite Tiled maps** are parsed but not converted to runtime `TileMap`
+  instances (internal chunk grid requires finite bounds).
+- **Object/image/group layers** parse correctly but do not produce rendered
+  scene nodes — only tile layers are converted.
+- **Tilemap atlas bleeding** may occur at tile edges with linear or mipmap
+  texture filtering when atlas tile regions lack sufficient padding or
+  extrusion, causing neighbouring texel bleeding.
+- **No runtime autotiling.** Tiled terrain/wang sets are not evaluated.
+- **Single-texture batching.** NineSlice, RepeatingSprite, and Tilemap
+  renderers support different textures, but they do not combine several
+  textures into a single multi-texture draw batch. Texture changes therefore
+  create batch boundaries. For RepeatingSprite, sampler and strategy changes
+  also create batch boundaries. For Tilemap, batches are grouped by compatible
+  state and tileset texture.
+
+### Package Graph
+
+After this release the published lockstep package set is:
+
+```
+@codexo/exojs         0.13.0
+@codexo/exojs-particles  0.13.0  (peer @codexo/exojs 0.13.x)
+@codexo/exojs-tilemap    0.13.0  (peer @codexo/exojs 0.13.x)
+@codexo/exojs-tiled      0.13.0  (peer @codexo/exojs 0.13.x, dep @codexo/exojs-tilemap 0.13.0)
+```
+
+`create-exo-app` is independently versioned and not in engine lockstep.
+
 ## [0.12.0] - 2026-06-09
 
 The rendering-architecture and extension-system release. A composable,

package/dist/esm/core/BuildInfo.js

@@ -1,6 +1,6 @@
 const buildInfo = Object.freeze({
-    version: "0.12.0",
-    revision: "599bc56",
+    version: "0.13.0",
+    revision: "735089b",
     development: false,
 });
 

package/dist/esm/extensions/Extension.d.ts

@@ -4,12 +4,17 @@ import type { DrawableConstructor, Renderer } from '#rendering/Renderer';
 import type { AssetConstructor } from '#resources/FactoryRegistry';
 import type { AssetLoaderContext, Loader } from '#resources/Loader';
 /**
- * Per-load request passed to {@link AssetHandler.load}.
+ * Per-load request passed to {@link AssetHandler.load} and
+ * {@link AssetHandler.getIdentityKey}.
+ *
+ * `Options` is `undefined` by default — a handler without typed options receives
+ * `request.options: undefined`. A handler with typed options receives
+ * `request.options: Options | undefined` (options remain optional even when typed).
  * @advanced
  */
-export interface AssetLoadRequest {
+export interface AssetLoadRequest<Options = undefined> {
     readonly source: string;
-    readonly options?: Readonly<Record<string, unknown>>;
+    readonly options?: Options;
 }
 /**
  * A loader-local instance produced by {@link AssetBinding.create}; owned and destroyed
@@ -18,8 +23,26 @@ export interface AssetLoadRequest {
  * NOT by this handler or the asset returned by `load`.
  * @advanced
  */
-export interface AssetHandler<Result = unknown> {
-    load(request: AssetLoadRequest, context: AssetLoaderContext): Promise<Result>;
+export interface AssetHandler<Result = unknown, Options = undefined> {
+    /**
+     * Returns the deterministic identity key used for in-flight deduplication and
+     * loaded-resource reuse (and cache/resource-store identity where applicable).
+     *
+     * Include every option that **changes the produced resource** (format, locale,
+     * variant, color space, decoding mode, strictness when it affects output).
+     * Exclude control-only values that do not alter the resource (callbacks,
+     * `AbortSignal`, logger, request priority, timeout).
+     *
+     * Do **not** use `JSON.stringify(request.options)` — property-order instability,
+     * control-only field inclusion, and unbounded key size make it unsuitable.
+     * Explicitly select the identity-relevant fields instead.
+     *
+     * The Loader namespaces the key with the asset type, so the returned string may
+     * be type-local. Omit this hook to use the default (source-only) identity.
+     * @advanced
+     */
+    getIdentityKey?(request: AssetLoadRequest<Options>): string;
+    load(request: AssetLoadRequest<Options>, context: AssetLoaderContext): Promise<Result>;
     destroy?(): void;
 }
 /**
@@ -41,9 +64,17 @@ export interface RendererBinding<Target extends Drawable = Drawable> {
  * `create(loader)` is called once per Loader at Application construction, producing
  * an {@link AssetHandler} instance that the Loader owns for its entire lifetime.
  * The handler may hold loader-local state (Workers, WASM modules, parsed caches).
+ *
+ * `Result` is the produced asset instance type (e.g. `TileMap`). `Options` is the
+ * typed options object, defaulting to `undefined` (no options). The runtime `type`
+ * field must be a constructor that produces `Result`; the handler returned by
+ * `create` must also produce `Result` — both relationships are enforced by TypeScript.
+ *
+ * Use `satisfies AssetBinding<MyAsset, MyLoadOptions>` on an object literal to get
+ * typed options in the handler and enforce the result type without repeating it.
  * @advanced
  */
-export interface AssetBinding<Result = unknown> {
+export interface AssetBinding<Result = unknown, Options = undefined> {
     readonly type: AssetConstructor<Result>;
     /**
      * Config-map type names that resolve to this handler, e.g. `['tiledMap']`.
@@ -53,7 +84,7 @@ export interface AssetBinding<Result = unknown> {
      */
     readonly typeNames?: readonly string[];
     readonly extensions?: readonly string[];
-    create(loader: Loader): AssetHandler<Result>;
+    create(loader: Loader): AssetHandler<Result, Options>;
 }
 /**
  * An ExoJS extension: an immutable descriptor that contributes renderer bindings
@@ -64,6 +95,7 @@ export interface AssetBinding<Result = unknown> {
  */
 export interface Extension {
     readonly id: string;
+    readonly dependencies?: readonly Extension[];
     readonly renderers?: readonly RendererBinding[];
     readonly assets?: readonly AssetBinding[];
 }

package/dist/esm/extensions/Extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/Extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACjE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7E;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C"}
+{"version":3,"file":"Extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/Extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,SAAS;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS;IACjE;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACjE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7E;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS;IACjE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C"}

package/dist/esm/extensions/ExtensionRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExtensionRegistry.d.ts","sourceRoot":"","sources":["../../../src/extensions/ExtensionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOnE,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,IAAI,iBAAiB,CAS7D;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO;IAEP;;;;OAIG;WACW,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAyClD,8DAA8D;WAChD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC,0DAA0D;WAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS;IAI9D;;;;OAIG;WACW,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;CAGzD"}
+{"version":3,"file":"ExtensionRegistry.d.ts","sourceRoot":"","sources":["../../../src/extensions/ExtensionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAiB,KAAK,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAOpF,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,IAAI,iBAAiB,CAS7D;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO;IAEP;;;;OAIG;WACW,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAoBlD,8DAA8D;WAChD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC,0DAA0D;WAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS;IAI9D;;;;OAIG;WACW,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;CAGzD"}

package/dist/esm/extensions/ExtensionRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExtensionRegistry.js","sources":["../../../../src/extensions/ExtensionRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;AACA,IAAI,KAAK,GAAG,IAAI,GAAG,EAAqB;AACxC,IAAI,SAAS,GAAG,CAAC;AACjB,IAAI,MAAqE;AASzE;SACgB,yBAAyB,GAAA;AACvC,IAAA,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE;QAClC,OAAO,MAAM,CAAC,QAAQ;IACxB;AAEA,IAAA,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;AAE1C,IAAA,OAAO,QAAQ;AACjB;AAEA;;;;;;;;AAQG;MACU,iBAAiB,CAAA;AAC5B,IAAA,WAAA,GAAA,EAAuB;AAEvB;;;;AAIG;IACI,OAAO,QAAQ,CAAC,SAAoB,EAAA;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAExC,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,QAAQ,KAAK,SAAS;gBAAE;AAC5B,YAAA,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,CAAC,EAAE,CAAA,qDAAA,CAAuD;AAC1F,gBAAA,CAAA,wGAAA,CAA0G,CAC7G;QACH;QAEA,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC;AAClC,QAAA,SAAS,EAAE;QACX,MAAM,GAAG,SAAS;IA0BpB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;AAEA;;;;AAIG;AACI,IAAA,OAAO,IAAI,GAAA;AAChB,QAAA,OAAO,yBAAyB,EAAE,CAAC,UAAU;IAC/C;AACD;;;;"}
+{"version":3,"file":"ExtensionRegistry.js","sources":["../../../../src/extensions/ExtensionRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;AACA,IAAI,KAAK,GAAG,IAAI,GAAG,EAAqB;AACxC,IAAI,SAAS,GAAG,CAAC;AACjB,IAAI,MAAqE;AASzE;SACgB,yBAAyB,GAAA;AACvC,IAAA,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE;QAClC,OAAO,MAAM,CAAC,QAAQ;IACxB;AAEA,IAAA,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;AAE1C,IAAA,OAAO,QAAQ;AACjB;AAEA;;;;;;;;AAQG;MACU,iBAAiB,CAAA;AAC5B,IAAA,WAAA,GAAA,EAAuB;AAEvB;;;;AAIG;IACI,OAAO,QAAQ,CAAC,SAAoB,EAAA;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAExC,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,QAAQ,KAAK,SAAS;gBAAE;AAC5B,YAAA,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,CAAC,EAAE,CAAA,qDAAA,CAAuD;AAC1F,gBAAA,CAAA,wGAAA,CAA0G,CAC7G;QACH;QAEA,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC;AAClC,QAAA,SAAS,EAAE;QACX,MAAM,GAAG,SAAS;IAKpB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;AAEA;;;;AAIG;AACI,IAAA,OAAO,IAAI,GAAA;AAChB,QAAA,OAAO,yBAAyB,EAAE,CAAC,UAAU;IAC/C;AACD;;;;"}

package/dist/esm/extensions/snapshot.d.ts

@@ -7,8 +7,18 @@ export interface ExtensionSnapshot {
 declare const emptySnapshot: ExtensionSnapshot;
 export { emptySnapshot as EMPTY_SNAPSHOT };
 /**
- * Flatten an ordered extension list into a snapshot.
- * De-duplicates same-id/same-object entries; throws on same-id/different-object.
+ * Freeze an extension descriptor and its nested arrays in development builds.
+ * Idempotent — safe to call on already-frozen descriptors.
+ * Called from buildSnapshot (every visited extension) so global and local
+ * descriptors receive consistent treatment.
+ * @param ext — the descriptor to freeze
+ * @internal
+ */
+export declare function freezeExtension(ext: Extension): void;
+/**
+ * Flatten an ordered extension list into a snapshot using stable depth-first
+ * post-order traversal. Dependencies are materialised before their dependents.
+ * De-duplicates same-object entries; throws on same-id/different-object or cycles.
  * Binding-level conflicts are checked per Application at materialisation time.
  * @internal
  */

package/dist/esm/extensions/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/extensions/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAGD,QAAA,MAAM,aAAa,EAAE,iBAInB,CAAC;AAEH,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAuC5E"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/extensions/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAGD,QAAA,MAAM,aAAa,EAAE,iBAInB,CAAC;AAEH,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAmCpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CA+E5E"}

package/dist/esm/extensions/snapshot.js

@@ -5,8 +5,9 @@ const emptySnapshot = Object.freeze({
     assets: Object.freeze([]),
 });
 /**
- * Flatten an ordered extension list into a snapshot.
- * De-duplicates same-id/same-object entries; throws on same-id/different-object.
+ * Flatten an ordered extension list into a snapshot using stable depth-first
+ * post-order traversal. Dependencies are materialised before their dependents.
+ * De-duplicates same-object entries; throws on same-id/different-object or cycles.
  * Binding-level conflicts are checked per Application at materialisation time.
  * @internal
  */
@@ -14,19 +15,47 @@ function buildSnapshot(input) {
     if (input.length === 0) {
         return emptySnapshot;
     }
-    const seenById = new Map();
-    const extensions = [];
+    const byId = new Map();
+    const visiting = new Set();
+    const visited = new Set();
+    const stack = [];
+    const ordered = [];
+    function visit(ext) {
+        // (1) Reserve ID + mismatch check FIRST — before dependency traversal.
+        //     This catches nested same-id/different-object descriptors immediately.
+        const existing = byId.get(ext.id);
+        if (existing !== undefined && existing !== ext) {
+            throw new Error(`Extension "${ext.id}" was provided by multiple descriptor objects.`);
+        }
+        if (existing === undefined) {
+            byId.set(ext.id, ext);
+        }
+        // (2) Already fully processed — diamond / shared dependency.
+        if (visited.has(ext))
+            return;
+        // (3) Back-edge in current DFS stack — cycle.
+        if (visiting.has(ext)) {
+            const cyclePath = [...stack.slice(stack.indexOf(ext)), ext].map(e => e.id).join(' → ');
+            throw new Error(`Extension dependency cycle detected: ${cyclePath}`);
+        }
+        // (4) Recurse into dependencies (post-order: deps before this extension).
+        visiting.add(ext);
+        stack.push(ext);
+        for (const dep of ext.dependencies ?? []) {
+            visit(dep);
+        }
+        stack.pop();
+        visiting.delete(ext);
+        // (5) Finalise — remove from in-progress, mark as fully processed, push to output.
+        visited.add(ext);
+        ordered.push(ext);
+    }
+    for (const ext of input)
+        visit(ext);
+    // Flatten in topological (post-order) order — deps before dependents.
     const renderers = [];
     const assets = [];
-    for (const ext of input) {
-        const existing = seenById.get(ext.id);
-        if (existing !== undefined) {
-            if (existing === ext)
-                continue;
-            throw new Error(`Duplicate extension id "${ext.id}" with a different descriptor in the provided extensions list.`);
-        }
-        seenById.set(ext.id, ext);
-        extensions.push(ext);
+    for (const ext of ordered) {
         if (ext.renderers) {
             for (const binding of ext.renderers) {
                 renderers.push(binding);
@@ -39,7 +68,7 @@ function buildSnapshot(input) {
         }
     }
     return Object.freeze({
-        extensions: Object.freeze(extensions),
+        extensions: Object.freeze(ordered),
         renderers: Object.freeze(renderers),
         assets: Object.freeze(assets),
     });

package/dist/esm/extensions/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sources":["../../../../src/extensions/snapshot.ts"],"sourcesContent":[null],"names":[],"mappings":"AASA;AACA,MAAM,aAAa,GAAsB,MAAM,CAAC,MAAM,CAAC;AACrD,IAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7B,IAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5B,IAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,CAAA;AAID;;;;;AAKG;AACG,SAAU,aAAa,CAAC,KAA2B,EAAA;AACvD,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,aAAa;IACtB;AAEA,IAAA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB;IAC7C,MAAM,UAAU,GAAgB,EAAE;IAClC,MAAM,SAAS,GAAsB,EAAE;IACvC,MAAM,MAAM,GAAmB,EAAE;AAEjC,IAAA,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AAErC,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,QAAQ,KAAK,GAAG;gBAAE;YACtB,MAAM,IAAI,KAAK,CAAC,CAAA,wBAAA,EAA2B,GAAG,CAAC,EAAE,CAAA,8DAAA,CAAgE,CAAC;QACpH;QAEA,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC;AACzB,QAAA,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;AAEpB,QAAA,IAAI,GAAG,CAAC,SAAS,EAAE;AACjB,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE;AACnC,gBAAA,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YACzB;QACF;AAEA,QAAA,IAAI,GAAG,CAAC,MAAM,EAAE;AACd,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE;AAChC,gBAAA,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACtB;QACF;IACF;IAEA,OAAO,MAAM,CAAC,MAAM,CAAC;AACnB,QAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;AACrC,QAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;AACnC,QAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;AAC9B,KAAA,CAAC;AACJ;;;;"}
+{"version":3,"file":"snapshot.js","sources":["../../../../src/extensions/snapshot.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -121,6 +121,8 @@ export { ShaderAttribute } from './rendering/shader/ShaderAttribute.js';
 export { ShaderUniform } from './rendering/shader/ShaderUniform.js';
 export { upgradeFragmentShaderToGl300 } from './rendering/shader/upgradeFragmentShaderToGl300.js';
 export { AnimatedSprite } from './rendering/sprite/AnimatedSprite.js';
+export { NineSliceSprite } from './rendering/sprite/NineSliceSprite.js';
+export { RepeatingSprite } from './rendering/sprite/RepeatingSprite.js';
 export { Sprite, SpriteFlags } from './rendering/sprite/Sprite.js';
 export { Spritesheet } from './rendering/sprite/Spritesheet.js';
 export { AbstractText } from './rendering/text/AbstractText.js';
@@ -134,14 +136,18 @@ export { buildTextPageQuads, layoutText, measureText } from './rendering/text/Te
 export { TextStyle } from './rendering/text/TextStyle.js';
 export { DataTexture } from './rendering/texture/DataTexture.js';
 export { RenderTexture } from './rendering/texture/RenderTexture.js';
+export { planRepeat } from './rendering/texture/repeat.js';
 export { Sampler } from './rendering/texture/Sampler.js';
 export { Texture } from './rendering/texture/Texture.js';
+export { TextureRegion } from './rendering/texture/TextureRegion.js';
 export { Video } from './rendering/video/Video.js';
 export { AbstractWebGl2BatchedRenderer } from './rendering/webgl2/AbstractWebGl2BatchedRenderer.js';
 export { AbstractWebGl2Renderer } from './rendering/webgl2/AbstractWebGl2Renderer.js';
 export { WebGl2Backend } from './rendering/webgl2/WebGl2Backend.js';
 export { WebGl2MeshRenderer } from './rendering/webgl2/WebGl2MeshRenderer.js';
+export { WebGl2NineSliceSpriteRenderer } from './rendering/webgl2/WebGl2NineSliceSpriteRenderer.js';
 export { WebGl2RenderBuffer } from './rendering/webgl2/WebGl2RenderBuffer.js';
+export { WebGl2RepeatingSpriteRenderer } from './rendering/webgl2/WebGl2RepeatingSpriteRenderer.js';
 export { WebGl2ShaderBlock } from './rendering/webgl2/WebGl2ShaderBlock.js';
 export { webGl2PrimitiveArrayConstructors, webGl2PrimitiveByteSizeMapping, webGl2PrimitiveTypeNames } from './rendering/webgl2/WebGl2ShaderMappings.js';
 export { createWebGl2ShaderProgram } from './rendering/webgl2/WebGl2ShaderProgram.js';
@@ -154,6 +160,8 @@ export { WebGpuStorageBuffer } from './rendering/webgpu/compute/WebGpuStorageBuf
 export { WebGpuBackend } from './rendering/webgpu/WebGpuBackend.js';
 export { getWebGpuBlendState } from './rendering/webgpu/WebGpuBlendState.js';
 export { WebGpuMeshRenderer } from './rendering/webgpu/WebGpuMeshRenderer.js';
+export { WebGpuNineSliceSpriteRenderer } from './rendering/webgpu/WebGpuNineSliceSpriteRenderer.js';
+export { WebGpuRepeatingSpriteRenderer } from './rendering/webgpu/WebGpuRepeatingSpriteRenderer.js';
 export { WebGpuSpriteRenderer } from './rendering/webgpu/WebGpuSpriteRenderer.js';
 export { WebGpuTextRenderer } from './rendering/webgpu/WebGpuTextRenderer.js';
 export { AbstractAssetFactory } from './resources/AbstractAssetFactory.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/rendering/Drawable.d.ts

@@ -1,5 +1,6 @@
 import { Color } from '#core/Color';
 import type { RenderPlanBuilder } from '#rendering/plan/RenderPlanBuilder';
+import { type PixelSnapMode } from './pixelSnap';
 import { RenderNode } from './RenderNode';
 import { BlendModes } from './types';
 /**
@@ -12,10 +13,32 @@ import { BlendModes } from './types';
 export declare class Drawable extends RenderNode {
     private _tint;
     private _blendMode;
+    private _pixelSnapMode;
     get tint(): Color;
     set tint(tint: Color);
     get blendMode(): BlendModes;
     set blendMode(blendMode: BlendModes);
+    /**
+     * Render-only pixel-snapping policy for this drawable. Aligns the rendered
+     * origin (`'position'`) or origin plus shared geometry boundaries
+     * (`'geometry'`) to the active render target's device-pixel grid. Purely
+     * visual: logical `x`/`y`, transforms, bounds, collision, tween and physics
+     * state are never affected, and {@link getBounds}/{@link getGlobalTransform}
+     * keep returning logical values.
+     *
+     * `'geometry'` is guaranteed only for axis-aligned transforms; rotation or
+     * skew (on this node, an ancestor, or the view) downgrade it to `'position'`
+     * for the affected frame, with no logical-state change. Snapping targets
+     * device pixels (× view scale × pixel ratio), not integer world units.
+     *
+     * Setting the current value is a no-op. Setting a value outside the
+     * {@link PixelSnapMode} union throws and leaves the prior mode unchanged.
+     *
+     * @default 'none'
+     * @stable
+     */
+    get pixelSnapMode(): PixelSnapMode;
+    set pixelSnapMode(mode: PixelSnapMode);
     /**
      * Set the tint colour by copying `color` into the internal {@link Color} instance.
      * Invalidates the render cache so the change is picked up on the next frame.

package/dist/esm/rendering/Drawable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drawable.d.ts","sourceRoot":"","sources":["../../../src/rendering/Drawable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAiC;IAEnD,IAAW,IAAI,IAAI,KAAK,CAEvB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,KAAK,EAE1B;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,SAAS,CAAC,SAAS,EAAE,UAAU,EAEzC;IAED;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASlC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAShD,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIpE,gBAAgB;IACA,wBAAwB,IAAI,OAAO;IAInD,gBAAgB;IACA,uBAAuB,IAAI,UAAU;IAIrC,OAAO,IAAI,IAAI;CAKhC"}
+{"version":3,"file":"Drawable.d.ts","sourceRoot":"","sources":["../../../src/rendering/Drawable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAyB;IAE/C,IAAW,IAAI,IAAI,KAAK,CAEvB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,KAAK,EAE1B;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,SAAS,CAAC,SAAS,EAAE,UAAU,EAEzC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,IAAI,EAAE,aAAa,EAW3C;IAED;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASlC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAShD,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIpE,gBAAgB;IACA,wBAAwB,IAAI,OAAO;IAInD,gBAAgB;IACA,uBAAuB,IAAI,UAAU;IAIrC,OAAO,IAAI,IAAI;CAKhC"}

package/dist/esm/rendering/Drawable.js

@@ -1,4 +1,5 @@
 import { Color } from '../core/Color.js';
+import { isPixelSnapMode } from './pixelSnap.js';
 import { RenderNode } from './RenderNode.js';
 import { BlendModes } from './types.js';
 
@@ -12,6 +13,7 @@ import { BlendModes } from './types.js';
 class Drawable extends RenderNode {
     _tint = Color.white.clone();
     _blendMode = BlendModes.Normal;
+    _pixelSnapMode = 'none';
     get tint() {
         return this._tint;
     }
@@ -24,6 +26,38 @@ class Drawable extends RenderNode {
     set blendMode(blendMode) {
         this.setBlendMode(blendMode);
     }
+    /**
+     * Render-only pixel-snapping policy for this drawable. Aligns the rendered
+     * origin (`'position'`) or origin plus shared geometry boundaries
+     * (`'geometry'`) to the active render target's device-pixel grid. Purely
+     * visual: logical `x`/`y`, transforms, bounds, collision, tween and physics
+     * state are never affected, and {@link getBounds}/{@link getGlobalTransform}
+     * keep returning logical values.
+     *
+     * `'geometry'` is guaranteed only for axis-aligned transforms; rotation or
+     * skew (on this node, an ancestor, or the view) downgrade it to `'position'`
+     * for the affected frame, with no logical-state change. Snapping targets
+     * device pixels (× view scale × pixel ratio), not integer world units.
+     *
+     * Setting the current value is a no-op. Setting a value outside the
+     * {@link PixelSnapMode} union throws and leaves the prior mode unchanged.
+     *
+     * @default 'none'
+     * @stable
+     */
+    get pixelSnapMode() {
+        return this._pixelSnapMode;
+    }
+    set pixelSnapMode(mode) {
+        if (mode === this._pixelSnapMode) {
+            return;
+        }
+        if (!isPixelSnapMode(mode)) {
+            throw new Error(`Drawable.pixelSnapMode must be 'none', 'position', or 'geometry' (got ${String(mode)}).`);
+        }
+        this._pixelSnapMode = mode;
+        this.invalidateCache();
+    }
     /**
      * Set the tint colour by copying `color` into the internal {@link Color} instance.
      * Invalidates the render cache so the change is picked up on the next frame.

package/dist/esm/rendering/Drawable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Drawable.js","sources":["../../../../src/rendering/Drawable.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;;;;AAMG;AACG,MAAO,QAAS,SAAQ,UAAU,CAAA;AAC9B,IAAA,KAAK,GAAU,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;AAClC,IAAA,UAAU,GAAe,UAAU,CAAC,MAAM;AAElD,IAAA,IAAW,IAAI,GAAA;QACb,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,IAAW,IAAI,CAAC,IAAW,EAAA;AACzB,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACpB;AAEA,IAAA,IAAW,SAAS,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,IAAW,SAAS,CAAC,SAAqB,EAAA;AACxC,QAAA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;IAC9B;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,KAAY,EAAA;QACzB,IAAI,KAAK,EAAE;AACT,YAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,SAAqB,EAAA;AACvC,QAAA,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AACjC,YAAA,IAAI,CAAC,UAAU,GAAG,SAAS;YAC3B,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;;AAGmB,IAAA,eAAe,CAAC,OAA0B,EAAA;AAC3D,QAAA,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxB;;IAGgB,wBAAwB,GAAA;AACtC,QAAA,OAAO,IAAI;IACb;;IAGgB,uBAAuB,GAAA;QACrC,OAAO,IAAI,CAAC,UAAU;IACxB;IAEgB,OAAO,GAAA;QACrB,KAAK,CAAC,OAAO,EAAE;AAEf,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;IACtB;AACD;;;;"}
+{"version":3,"file":"Drawable.js","sources":["../../../../src/rendering/Drawable.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAOA;;;;;;AAMG;AACG,MAAO,QAAS,SAAQ,UAAU,CAAA;AAC9B,IAAA,KAAK,GAAU,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;AAClC,IAAA,UAAU,GAAe,UAAU,CAAC,MAAM;IAC1C,cAAc,GAAkB,MAAM;AAE9C,IAAA,IAAW,IAAI,GAAA;QACb,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,IAAW,IAAI,CAAC,IAAW,EAAA;AACzB,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACpB;AAEA,IAAA,IAAW,SAAS,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,IAAW,SAAS,CAAC,SAAqB,EAAA;AACxC,QAAA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;IAC9B;AAEA;;;;;;;;;;;;;;;;;;AAkBG;AACH,IAAA,IAAW,aAAa,GAAA;QACtB,OAAO,IAAI,CAAC,cAAc;IAC5B;IAEA,IAAW,aAAa,CAAC,IAAmB,EAAA;AAC1C,QAAA,IAAI,IAAI,KAAK,IAAI,CAAC,cAAc,EAAE;YAChC;QACF;AAEA,QAAA,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,CAAA,sEAAA,EAAyE,MAAM,CAAC,IAAI,CAAC,CAAA,EAAA,CAAI,CAAC;QAC5G;AAEA,QAAA,IAAI,CAAC,cAAc,GAAG,IAAI;QAC1B,IAAI,CAAC,eAAe,EAAE;IACxB;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,KAAY,EAAA;QACzB,IAAI,KAAK,EAAE;AACT,YAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,SAAqB,EAAA;AACvC,QAAA,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AACjC,YAAA,IAAI,CAAC,UAAU,GAAG,SAAS;YAC3B,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;;AAGmB,IAAA,eAAe,CAAC,OAA0B,EAAA;AAC3D,QAAA,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxB;;IAGgB,wBAAwB,GAAA;AACtC,QAAA,OAAO,IAAI;IACb;;IAGgB,uBAAuB,GAAA;QACrC,OAAO,IAAI,CAAC,UAAU;IACxB;IAEgB,OAAO,GAAA;QACrB,KAAK,CAAC,OAAO,EAAE;AAEf,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;IACtB;AACD;;;;"}

package/dist/esm/rendering/coreRendererBindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coreRendererBindings.d.ts","sourceRoot":"","sources":["../../../src/rendering/coreRendererBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAe7D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,GAAG,eAAe,EAAE,CAiCjG"}
+{"version":3,"file":"coreRendererBindings.d.ts","sourceRoot":"","sources":["../../../src/rendering/coreRendererBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAqB7D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,GAAG,eAAe,EAAE,CAiDjG"}

package/dist/esm/rendering/coreRendererBindings.js

@@ -1,11 +1,17 @@
 import { Mesh } from './mesh/Mesh.js';
+import { NineSliceSprite } from './sprite/NineSliceSprite.js';
+import { RepeatingSprite } from './sprite/RepeatingSprite.js';
 import { Sprite } from './sprite/Sprite.js';
 import { BitmapText } from './text/BitmapText.js';
 import { Text } from './text/Text.js';
 import { WebGl2MeshRenderer } from './webgl2/WebGl2MeshRenderer.js';
+import { WebGl2NineSliceSpriteRenderer } from './webgl2/WebGl2NineSliceSpriteRenderer.js';
+import { WebGl2RepeatingSpriteRenderer } from './webgl2/WebGl2RepeatingSpriteRenderer.js';
 import { WebGl2SpriteRenderer } from './webgl2/WebGl2SpriteRenderer.js';
 import { WebGl2TextRenderer } from './webgl2/WebGl2TextRenderer.js';
 import { WebGpuMeshRenderer } from './webgpu/WebGpuMeshRenderer.js';
+import { WebGpuNineSliceSpriteRenderer } from './webgpu/WebGpuNineSliceSpriteRenderer.js';
+import { WebGpuRepeatingSpriteRenderer } from './webgpu/WebGpuRepeatingSpriteRenderer.js';
 import { WebGpuSpriteRenderer } from './webgpu/WebGpuSpriteRenderer.js';
 import { WebGpuTextRenderer } from './webgpu/WebGpuTextRenderer.js';
 import { RenderBackendType } from './RenderBackendType.js';
@@ -30,6 +36,14 @@ function buildCoreRendererBindings(options) {
         [RenderBackendType.WebGl2]: () => new WebGl2TextRenderer(),
         [RenderBackendType.WebGpu]: () => new WebGpuTextRenderer(),
     };
+    const nineSliceRenderers = {
+        [RenderBackendType.WebGl2]: () => new WebGl2NineSliceSpriteRenderer(spriteRendererBatchSize),
+        [RenderBackendType.WebGpu]: () => new WebGpuNineSliceSpriteRenderer(),
+    };
+    const repeatingSpriteRenderers = {
+        [RenderBackendType.WebGl2]: () => new WebGl2RepeatingSpriteRenderer(spriteRendererBatchSize),
+        [RenderBackendType.WebGpu]: () => new WebGpuRepeatingSpriteRenderer(),
+    };
     return [
         {
             targets: [Sprite],
@@ -44,6 +58,14 @@ function buildCoreRendererBindings(options) {
             targets: [Text, BitmapText],
             create: backend => textRenderers[backend.backendType]?.(),
         },
+        {
+            targets: [NineSliceSprite],
+            create: backend => nineSliceRenderers[backend.backendType]?.(),
+        },
+        {
+            targets: [RepeatingSprite],
+            create: backend => repeatingSpriteRenderers[backend.backendType]?.(),
+        },
     ];
 }
 

package/dist/esm/rendering/coreRendererBindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreRendererBindings.js","sources":["../../../../src/rendering/coreRendererBindings.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;AAgBA;;;;;AAKG;AACG,SAAU,yBAAyB,CAAC,OAAoC,EAAA;AAC5E,IAAA,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI;AAIvE,IAAA,MAAM,eAAe,GAAuB;AAC1C,QAAA,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,CAAC;QACnF,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,oBAAoB,EAAE;KAC7D;AACD,IAAA,MAAM,aAAa,GAAuB;QACxC,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;QAC1D,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;KAC3D;AACD,IAAA,MAAM,aAAa,GAAuB;QACxC,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;QAC1D,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;KAC3D;IAED,OAAO;AACL,QAAA;YACE,OAAO,EAAE,CAAC,MAAM,CAAC;AACjB,YAAA,MAAM,EAAE,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC5D,SAAA;AACD,QAAA;YACE,OAAO,EAAE,CAAC,IAAI,CAAC;AACf,YAAA,MAAM,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC1D,SAAA;AACD,QAAA;;AAEE,YAAA,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;AAC3B,YAAA,MAAM,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC1D,SAAA;KACF;AACH;;;;"}
+{"version":3,"file":"coreRendererBindings.js","sources":["../../../../src/rendering/coreRendererBindings.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAsBA;;;;;AAKG;AACG,SAAU,yBAAyB,CAAC,OAAoC,EAAA;AAC5E,IAAA,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI;AAIvE,IAAA,MAAM,eAAe,GAAuB;AAC1C,QAAA,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,CAAC;QACnF,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,oBAAoB,EAAE;KAC7D;AACD,IAAA,MAAM,aAAa,GAAuB;QACxC,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;QAC1D,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;KAC3D;AACD,IAAA,MAAM,aAAa,GAAuB;QACxC,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;QAC1D,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,kBAAkB,EAAE;KAC3D;AACD,IAAA,MAAM,kBAAkB,GAAuB;AAC7C,QAAA,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,6BAA6B,CAAC,uBAAuB,CAAC;QAC5F,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,6BAA6B,EAAE;KACtE;AACD,IAAA,MAAM,wBAAwB,GAAuB;AACnD,QAAA,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,6BAA6B,CAAC,uBAAuB,CAAC;QAC5F,CAAC,iBAAiB,CAAC,MAAM,GAAG,MAAM,IAAI,6BAA6B,EAAE;KACtE;IAED,OAAO;AACL,QAAA;YACE,OAAO,EAAE,CAAC,MAAM,CAAC;AACjB,YAAA,MAAM,EAAE,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC5D,SAAA;AACD,QAAA;YACE,OAAO,EAAE,CAAC,IAAI,CAAC;AACf,YAAA,MAAM,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC1D,SAAA;AACD,QAAA;;AAEE,YAAA,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;AAC3B,YAAA,MAAM,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC1D,SAAA;AACD,QAAA;YACE,OAAO,EAAE,CAAC,eAAe,CAAC;AAC1B,YAAA,MAAM,EAAE,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AAC/D,SAAA;AACD,QAAA;YACE,OAAO,EAAE,CAAC,eAAe,CAAC;AAC1B,YAAA,MAAM,EAAE,OAAO,IAAI,wBAAwB,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;AACrE,SAAA;KACF;AACH;;;;"}