@ignifx/2d 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -954,6 +954,35 @@ export declare class SpriteLayerRegistry {
954
954
  readonly key: string;
955
955
  readonly handle: LiteSprite2DHandle;
956
956
  };
957
+ /**
958
+ * Adds one tile of a tilemap layer, which no `SpriteRenderer` owns.
959
+ *
960
+ * @remarks
961
+ * A tilemap rebuilds a chunk by removing its sprites, and Lite removes by swapping the last sprite
962
+ * into the freed slot. In a layer shared by several tilemap layers that moves one layer's tiles in
963
+ * front of another's. So on a sorting layer that is not Y-sorted, each pair of `orderInLayer` and
964
+ * layer index gets a Lite layer of its own. Those layers draw by `orderInLayer`, then by the
965
+ * layer's index in its document, and behind the sorting layer's sprites when `orderInLayer` ties.
966
+ *
967
+ * On a Y-sorted sorting layer the tile shares the sprites' layer, so it sorts with characters by
968
+ * world Y, and `orderInLayer` becomes its Y-sort bias, as for a `SpriteRenderer`. Lite's Y-sort
969
+ * breaks ties by insertion, which a removal does not reorder.
970
+ *
971
+ * Like {@link SpriteLayerRegistry.placeRaw}, the tile takes no slot in the pick map.
972
+ *
973
+ * @param sortingLayer - The sorting layer's name.
974
+ * @param atlas - The atlas the tile draws from.
975
+ * @param orderInLayer - The tilemap layer's `orderInLayer`.
976
+ * @param layerIndex - The tilemap layer's index in its document.
977
+ * @param scratch - The reusable props record, already written.
978
+ * @returns The key and the handle, for {@link SpriteLayerRegistry.removeRaw}.
979
+ *
980
+ * @internal
981
+ */
982
+ placeTile(sortingLayer: string, atlas: SpriteAtlasAsset, orderInLayer: number, layerIndex: number, scratch: SpriteScratch): {
983
+ readonly key: string;
984
+ readonly handle: LiteSprite2DHandle;
985
+ };
957
986
  /**
958
987
  * Claims `capacity` sprite slots in one layer at once — what `app.twoD.createSpriteBatch` is
959
988
  * built on.
@@ -4193,14 +4222,17 @@ export declare function importTiledMap(tmj: unknown, options?: TiledImportOption
4193
4222
  export declare class TilemapAsset {
4194
4223
  /** The type name the asset service registers tilemaps under. */
4195
4224
  static assetType: string;
4196
- /** The address the document was loaded from. */
4225
+ /**
4226
+ * The address the document was loaded from. For a map built with {@link createTilemapAsset}, the
4227
+ * `address` option it was given, or `""`.
4228
+ */
4197
4229
  readonly address: string;
4198
4230
  /** The parsed document, with every tile layer decoded to a dense array. */
4199
4231
  readonly definition: TilemapDefinition;
4200
4232
  /** Each tileset's atlas address, resolved against this document's address. */
4201
4233
  readonly atlasAddresses: readonly string[];
4202
4234
  /**
4203
- * Wraps a parsed document. The `tilemap` loader constructs these.
4235
+ * Wraps a parsed document. The `tilemap` loader and {@link createTilemapAsset} construct these.
4204
4236
  *
4205
4237
  * @param address - The address it was loaded from.
4206
4238
  * @param definition - The parsed document.
@@ -4229,6 +4261,49 @@ export declare class TilemapAsset {
4229
4261
  * @public
4230
4262
  */
4231
4263
  export declare function createTilemapLoader(): AssetLoader<TilemapAsset>;
4264
+ /**
4265
+ * Options for {@link createTilemapAsset}.
4266
+ *
4267
+ * @public
4268
+ */
4269
+ interface CreateTilemapAssetOptions {
4270
+ /**
4271
+ * Treat the map as if it had been loaded from this address: its tilesets' `atlas` references
4272
+ * resolve against it, and an error names it. Default `""`, which reads every `atlas` reference
4273
+ * as a project-root address and names the map `"\<inline\>"` in errors.
4274
+ */
4275
+ readonly address?: string;
4276
+ }
4277
+ /**
4278
+ * Publishes a tilemap built in code as an asset, so a `Tilemap` component can hold it.
4279
+ *
4280
+ * @remarks
4281
+ * The document goes through the same `defineTilemap` check the `.tilemap.json` loader runs, so a
4282
+ * map built here and the same map written to a file are interchangeable, and a bad one fails with
4283
+ * the loader's error. The handle is a `memory:` asset (`AssetService.register`): serializing a
4284
+ * component that references it writes `null`.
4285
+ *
4286
+ * @param app - The app.
4287
+ * @param input - The document, in the shape a `.tilemap.json` file holds.
4288
+ * @param options - The address to resolve the tilesets' atlases against.
4289
+ * @returns A handle with one holder, already loaded.
4290
+ * @throws IgnifxError with code `IGX-1105` when the document is malformed (see `defineTilemap`).
4291
+ *
4292
+ * @example
4293
+ * ```ts
4294
+ * const map = createTilemapAsset(app, {
4295
+ * tileWidth: 16,
4296
+ * width: 2,
4297
+ * height: 1,
4298
+ * tilesets: [{ name: "terrain", atlas: "2d/terrain.atlas.json", firstId: 1, tiles: [] }],
4299
+ * layers: [{ name: "Ground", tiles: [1, 2] }],
4300
+ * });
4301
+ * world.createEntity("Level").addComponent(Tilemap, { map });
4302
+ * ```
4303
+ *
4304
+ * @public
4305
+ */
4306
+ export declare function createTilemapAsset(app: App, input: TilemapInput, options?: CreateTilemapAssetOptions): AssetHandle<TilemapAsset>;
4232
4307
  //#endregion
4233
4308
  //#region src/tilemap/tilemap.d.ts
4234
4309
  /**
@@ -4477,6 +4552,12 @@ export declare class Tilemap extends Component implements ComponentHooks {
4477
4552
  /**
4478
4553
  * A tilemap renderer.
4479
4554
  *
4555
+ * @remarks
4556
+ * Each tilemap layer draws by its `orderInLayer`, then by its place in the document, however often
4557
+ * its chunks are rebuilt. On a sorting layer without Y-sort, tiles draw behind that sorting layer's
4558
+ * sprites when the orders tie. On a Y-sorted sorting layer, tiles sort with sprites by world Y and
4559
+ * `orderInLayer` is their Y-sort bias, as for a `SpriteRenderer`.
4560
+ *
4480
4561
  * @example
4481
4562
  * ```ts
4482
4563
  * const level = app.world.createEntity({ name: "level" });
@@ -4596,5 +4677,5 @@ export declare class TilemapRenderer extends Component implements ComponentHooks
4596
4677
  */
4597
4678
  export declare const VERSION: string;
4598
4679
  //#endregion
4599
- export type { AnimatedTilemapSink, AsepriteAnimationImportOptions, AsepriteImportOptions, CollisionMergeOptions, GridAtlasImportOptions, LdtkImportOptions, LiteAtlasTexture, LiteBounds2D, LiteSprite2DHandle, LiteSprite2DLayer, LiteSprite2DView, LiteSpriteAtlas, LiteSpriteBlendMode, LiteSpriteFrame, LiteSpritePickInfo, LiteSpriteRenderer, LiteSpriteSampling, PlayClipOptions, SpriteAnimationDefinition, SpriteAnimationEvent, SpriteAnimationInput, SpriteAsset, SpriteAtlasAssetLiteHandles, SpriteAtlasDefinition, SpriteAtlasInput, SpriteBatch, SpriteBatchLiteHandles, SpriteBatchOptions, SpriteBlendName, SpriteClip, SpriteClipDefinition, SpriteClipTiming, SpriteEffectKind, SpriteFrameDefinition, SpriteFrameInfo, SpriteFrameTrim, SpriteLayerEntry, SpriteLayerKey, TexturePackerImportOptions, TileAnimationFrame, TileChange, TileColliderDefinition, TileCollisionInfo, TileCollisionShape, TileDefinition, TileRleData, TileWrite, TiledImportOptions, TilemapCollisionChunk, TilemapCollisionData, TilemapDefinition, TilemapInput, TilemapLayerDefinition, TilemapLayerInput, TilemapObjectDefinition, TilesetDefinition, TwoDErrorOptions, TwoDLiteHandles, TwoDMode, TwoDOptions, TwoDPick, TwoDPickAllOptions, TwoDPickOptions, TwoDSettings, Vec2Json, WorldBox };
4680
+ export type { AnimatedTilemapSink, AsepriteAnimationImportOptions, AsepriteImportOptions, CollisionMergeOptions, CreateTilemapAssetOptions, GridAtlasImportOptions, LdtkImportOptions, LiteAtlasTexture, LiteBounds2D, LiteSprite2DHandle, LiteSprite2DLayer, LiteSprite2DView, LiteSpriteAtlas, LiteSpriteBlendMode, LiteSpriteFrame, LiteSpritePickInfo, LiteSpriteRenderer, LiteSpriteSampling, PlayClipOptions, SpriteAnimationDefinition, SpriteAnimationEvent, SpriteAnimationInput, SpriteAsset, SpriteAtlasAssetLiteHandles, SpriteAtlasDefinition, SpriteAtlasInput, SpriteBatch, SpriteBatchLiteHandles, SpriteBatchOptions, SpriteBlendName, SpriteClip, SpriteClipDefinition, SpriteClipTiming, SpriteEffectKind, SpriteFrameDefinition, SpriteFrameInfo, SpriteFrameTrim, SpriteLayerEntry, SpriteLayerKey, TexturePackerImportOptions, TileAnimationFrame, TileChange, TileColliderDefinition, TileCollisionInfo, TileCollisionShape, TileDefinition, TileRleData, TileWrite, TiledImportOptions, TilemapCollisionChunk, TilemapCollisionData, TilemapDefinition, TilemapInput, TilemapLayerDefinition, TilemapLayerInput, TilemapObjectDefinition, TilesetDefinition, TwoDErrorOptions, TwoDLiteHandles, TwoDMode, TwoDOptions, TwoDPick, TwoDPickAllOptions, TwoDPickOptions, TwoDSettings, Vec2Json, WorldBox };
4600
4681
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/service/sorting-layers.ts","../src/atlas/definition.ts","../src/lite/types.ts","../src/atlas/sprite-atlas-asset.ts","../src/lite/sprite-layer.ts","../src/sprite/sprite-renderer.ts","../src/service/layer-registry.ts","../src/camera/camera-2d.ts","../src/sprite/parallax-layer.ts","../src/settings.ts","../src/service/runtime.ts","../src/service/sprite-batch.ts","../src/service/two-d-service.ts","../src/augmentation.ts","../src/tilemap/animated-tiles.ts","../src/animation/animation-system.ts","../src/animation/clip-time.ts","../src/animation/definition.ts","../src/animation/importers.ts","../src/animation/sprite-animation-asset.ts","../src/animation/loader.ts","../src/animation/sprite-animator.ts","../src/assets/relative.ts","../src/atlas/importers.ts","../src/atlas/loader.ts","../src/camera/camera-2d-follow.ts","../src/errors.ts","../src/extension.ts","../src/file-schemas.ts","../src/math/coords.ts","../src/schemas.ts","../src/service/sync-system.ts","../src/sprite/sprite-layer-effect.ts","../src/tilemap/collision-data.ts","../src/tilemap/collision-merge.ts","../src/tilemap/definition.ts","../src/tilemap/importers/ldtk.ts","../src/tilemap/importers/tiled.ts","../src/tilemap/tilemap-asset.ts","../src/tilemap/tilemap.ts","../src/tilemap/tilemap-renderer.ts","../src/version.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAiBa;;;;;;;;;;;qBAYA;;;;;;;;;;;;qBAaA;;;;;;;EAUX,YAAY;;;;;;MAuBR;;;;;;;EAUJ,QAAQ;;;;;;;;EAWR,QAAQ;;;;;;;;EAkBR,QAAQ;;;;;;;;;;;;;;;;;qBCjGG;;;;;;qBAOA;;;;;;qBAOA;;;;;;qBAOA;;;;;;qBAOA;;;;;;;KAQD,WAAW;;;;;;;;;;wBAWP,SAAS,OAAO,sBAAsB,UAAU,WAAW;;;;;;UAyB1D;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;;;;WAKA,QAAQ;;;;;;WAMR,aAAa;;;;;;WAMb,eAAe;;;;;;;;;;;;;;;;UAiBT;;WAEN,eAAe;;WAEf;;WAEA;;WAEA;;WAEA;;WAEA,iBAAiB;;;;;;;UAQX;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,iBAAiB;;;;;;;;;;;;;wBAcZ,kBAAkB,OAAO,kBAAkB,mBAAuB;;;;;;;;;;;;;;wBA+GlE,oBAAoB;;;;;;;;;;;;;;;;;;;;KCjQxB,qBAAqB;;;;;;;;;;KAWrB,oBAAoB;;;;;;;;;;KAWpB,qBAAqB;;;;;;;;;;;;KAarB,mBAAmB;;;;;;;;;KAUnB,kBAAkB;;;;;;;;;;;;KAalB,kBAAkB;;;;;;;;;KAUlB,sBAAsB;;;;;;;;;KAUtB,qBAAqB;;;;;;;;;;KAWrB,qBAAqB;;;;;;;;;;KAWrB,eAAe;;;;;;;;;KAUf,yBAAyB;;;;;;;;;KAUzB,mBAAmB;;;;;;;;;;;;;UCxId;;WAEN,OAAO;;;;;;;UAQD;;WAEN;;WAEA;;WAEA;;WAEA;;;;;;;UAQM;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,OAAO;;;;;WAKP,MAAM;;;;;;;;;;;;;;;;;;;qBAoBJ;;;SAEJ;;WAGE;;WAGA,YAAY;;;;;;;;;;;EAkBrB,YACE,iBACA,YAAY,uBACZ,OAAO,wBACP;;;;;;;MAsBE,QAAQ;;;;;;MASR;;;;;;;EAUJ,WAAW;;;;;;;;EAWX,aAAa;;;;;;EAgBb;;;;;;;EAiBA,MAAM,gBAAgB;;;;;;;;;EAwBtB,UAAU,gBAAgB;;;;;;MAStB;;;;;;EASJ;;;;;;;;;;;;;;;;;;;UA6Be;;WAEN,OAAO;;WAEP;;WAEA;;;;;;;;;;;;;;;;;;;;;;;qBCvNE;;;;;;;KAQD,0BAA0B;;;;;;;;;;;UAgGrB;;WAEN,OAAO;;;;;;;;;;;;;;;;;;;;;;;UCxHD;;WAEN;;WAEA,OAAO;;WAEP,OAAO;;WAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BE,uBAAuB,qBAAqB;;;SAEhD;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf,QAAgB,YAAY;;EAG5B,OAAe;;EAGf;;EAGA;;EAGA;;EAGA;;EAGA,OAAe;;EAGf,eAAuB;;EAGvB;;EAGA;;;;EAyCA;;;;EAQA;;;;;EAWA;;;;;;;;;;MAaI;;;;;;;MAaA,MAAM;;;;;;;;;;;;;MAoBN;;;;;;MASA,UAAU;;;;;;;MAaV;aAAmB,QAAQ;;;;;;;;;;;;;;MAgB3B;aAAqB,KAAK;aAAmB,KAAK;;;;;;;MAYlD,SAAS;;;;;;;;;;;;;;EAmBb,eAAe;;;;;;;;;;EAwBf,UAAU,mBAAmB;;;;;;;;;;;;;EA4B7B,WAAW,mBAAmB,uBAAuB,cAAc,cAAc,cAAc;;;;;;EAgB/F;;;;;;;;EAYA;aAAwB,QAAQ;aAA6B;;;;;;;;;;EAc7D,aAAa,QAAQ,2BAA2B;;;;;;;;;UCtWjC;;WAEN;;WAEA;;WAEA,OAAO;;WAEP;;WAEA;;WAEA;;;;;;;;;;;;;wBA2BK,eACd,sBACA,sBACA,OAAO,iBACP;;;;;;qBAUW;;;;;;;;;;EA6BX,YACE,eAAe,mBACf,OAAO,SAAS,0BAChB,iBAAiB,OAAO,4BACxB,iBAAiB,OAAO;;;;;;;;;;;;;EAoB1B,kBAAkB,WAAW,yBAAyB;;;;;;;;;EAYtD,kBAAkB,sBAAsB,QAAQ;;;;;;EAchD,qBAAqB;;;;;;;;EAyBrB,cAAc,oBAAoB,KAAK,sBAAsB;;;;;;;;EAkB7D,aAAa,QAAQ,OAAO,mBAAmB;;;;;;;;;;;EAmB/C,MAAM,WAAW,gBAAgB,OAAO,kBAAkB,SAAS;;;;;;;;EA0BnE,OAAO,WAAW;;;;;;;;;;;;;;;;;;;EAmClB,SACE,sBACA,OAAO,kBACP,OAAO,iBACP,sBACA,SAAS;aACG;aAAsB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqC5C,WACE,sBACA,OAAO,kBACP,OAAO,iBACP,sBACA,kBACA,SAAS,eACT,KAAK;aACO;aAAsB,OAAO;;;;;;;;;;EAuB3C,UAAU,aAAa,QAAQ;;;;;;;;;;;;;;;;;EA2B/B,kBAAkB,aAAa,QAAQ,oBAAoB;;;;;;;;;;EAe3D,YAAY,OAAO,mBAAmB,sBAAsB;;;;;;EAe5D;;;;;;;;;;;;;;;;;;qBCtYW;;;;;;qBAOA,8BAA8B;;;;;;;;;;;;;;;;;;;;qBAqB9B,iBAAiB;;;SAErB;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf;;EAGA;;EAGA,qBAA6B;;EAG7B,WAAmB;;EAGnB,WAAmB;;EAGnB,QAAgB;;EAGhB;;EAGA,cAAsB;;EAGtB,UAAkB;;EAGlB;;;;EA0BA;;;;;;MAUI;;;;;;MASA,kBAAkB;;;;;;MASlB,UAAU;;;;;;;;;;;;;EAiBd,QACE,gBACA,gBACA,yBACA,0BACA;;;;;;;;;;;;;;;;;;;;EAmDF,cAAc,WAAW,WAAW,MAAK,cAA2B;;;;;;;;EA0BpE,cAAc,OAAO,UAAU,MAAK,cAA2B;;;;;;;;;;;;;;;;;;;;;;;;;qBC3NpD,sBAAsB;;;SAE1B;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf;;EAGA,QAAgB;;EAGhB;;EAGA;;EAGA;;EAGA;;;;EAQA;;;;;;;;;;;;;;;;EAoBA,QAAQ,kBAAkB,oBAAoB,QAAQ,UAAU;;;;;;;;;;;;;;;qBCvErD;;;;;;;qBAQA;;;;;;;;;;;KAYD,mBAAmB;;;;;;;;;;;;;;;UAgBd;;WAEN,MAAM;;WAEN;;;;;WAKA,OAAO,SAAS;;;;;;;;;wBAUX,uBAAuB;;;;;;;;;wBAYvB,sBAAsB;;;;;;;;;;;;;UCtDrB;;WAEN,UAAU;;;;;;;UAQJ;;WAEN,KAAK;;WAEL,UAAU;;WAEV;;WAEA,uBAAuB;;WAEvB,cAAc,UAAU,oBAAoB,OAAO;;WAEnD,cAAc,UAAU,oBAAoB,OAAO;;WAEnD,kBAAkB,UAAU;;;;;;;cAQ1B;;;;;;;EAoDX,YAAY,SAAS;;;;;;MA+BjB,YAAY;;;;;;MASZ;;;;;;MASA,iBAAiB;;;;;;MASjB,UAAU;;;;;;MASV,YAAY;;;;;;;;;;;;;MAgBZ,cAAc;;;;;;MASd,cAAc;;;;;;MASd;;;;;;MASA;;;;;;MASA;;;;;;MAUA;;;;;;;;;;;;EAgBJ,gBAAgB,UAAU,OAAO;;;;;;EASjC,YAAY,OAAO;;;;EAUnB;;;;;;EAUA,cAAc,UAAU;;;;;;EASxB,cAAc,QAAQ;;;;;;EAStB,kBAAkB,iBAAiB;;;;;EAQnC;;;;;;;;;;;;EA0BA,gBAAgB;;;;;;;;;;;EAiBhB,qBAAqB,OAAO,OAAO;;;;;;;EAgBnC,eAAe,OAAO;;;;EAuBtB;;;;;;;EAkCA,aAAa,gBAAgB;;;;;;;;EAY7B;;;;EAoBA;;;;;;;;;UCvYe;;;;;;;;WAQN,OAAO,YAAY;;WAEnB;;WAEA;;WAEA,QAAQ;;WAER;;;;;;;;UASM;;;;;;;WAON,kBAAkB;;;;;;;;;;;;;;;;;;;UAoBZ;;WAEN;;;;;;;;;;;;EAYT;;;;;;;;;;;;;;;;;;;;;;;;;EA0BA,MACE,eACA,WACA,WACA,eACA,gBACA,eACA,kBACA,WACA,WACA,WACA,WACA,iBACA;;;;;;;;EASF,KAAK;;;;EAIL;;;;;WAKS,MAAM;;GAEd,OAAO;;;;;;;;;;;;;;;;UCjKO;;WAEN,QAAQ;;WAER,WAAW;;WAEX;;WAEA;;;;;;;UAQM;;;;;;;;;;;;;;;;WAgBN,UAAU,QAAQ,QAAQ,WAAW;;;;;WAKrC;;WAEA,kBAAkB;;;;;;;UAQZ,2BAA2B;;WAEjC;;;;;;;;;;;qBAYE;;;;;;UAOI;;WAEN,KAAK;;WAEL,KAAK;;;;;;;;;;;;;;;qBAgBH;;;;;;;;;EAkCX,YAAY,SAAS;;;;;;MASjB;;;;;;MASA,QAAQ;;;;;;MASR,YAAY;;;;;;MASZ,cAAc;;;;;;MASd;;;;;;;;;MAYA,mBAAmB;;;;;;;MAUnB,QAAQ;;;;;;;;;;MAaR;;;;;;MASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCJ,OAAO,aAAa,aAAa,UAAU,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EA2B7D,UAAU,aAAa,aAAa,UAAU,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8InE,kBAAkB,SAAS,qBAAqB;;;;;;;EAUhD,mBAAmB,KAAK;;;;;;;;;EA6BxB,cAAc,aAAa,aAAa,MAAK,cAA2B;;;;;;;;EAiBxE,cAAc,OAAO,UAAU,MAAK,cAA2B;;;;;;;;;;YC/erD;;;;;aAKC,MAAM;;;;;;;;;;;;;;;;;;UCCF;;;;;;;EAOf,qBAAqB,OAAO,OAAO;;;;;;;;;;;;;;;;;;qBCJxB;;;;;;qBAOA,+BAA+B;;;WAEjC;;;;;;EAST,YAAY,UAAU;;;;;;EAStB,OAAO,KAAK;;;;;;;;;;;;;;UCnCG;;WAEN;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;;;;;;wBAwBK,sBAAsB,MAAM,kBAAkB,iBAAiB;;;;;;;;;;;;;;;;;;qBCvBlE;;;;;;qBAOA;;;;;;qBAOA;;;;;;qBAOA;;;;;;UAOI;;WAEN;;WAEA;;;;;;;;;;;;;;;;;;;;UAqBM;;WAEN;;;;;WAKA;;;;;WAKA;;;;;WAKA;;WAEA;;WAEA;;WAEA,kBAAkB;;;;;;;UAQZ;;WAEN,eAAe;;WAEf;;WAEA;;WAEA,gBAAgB;;;;;;;UAQV;;WAEN;;WAEA;;WAEA;;WAEA,gBAAgB;;;;;;;qBAQd;;;;;;;;;;;wBAYG,sBAAsB,OAAO,sBAAsB,mBAAuB;;;;;;;;;;;;;;;;wBA8D1E,kBAAkB,MAAM,sBAAsB,UAAU;;;;;;;;UC1EvD;;WAEN;;WAEA;;;;;;WAMA,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+CV,yBACd,eACA,UAAU,iCACT;;;;;;;;;;;;;UClLc;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,iBAAiB;;WAEjB;;;;;;;;;;;;;;;;;;;qBAoBE;;;SAEJ;;WAGE;;WAGA,YAAY;;WAGZ;;;;;;;;;;EAeT,YAAY,iBAAiB,YAAY,2BAA2B;;;;;;EAWpE;;;;;;MAgBI;;;;;;;;;;;EAcJ,QAAQ,OAAO,mBAAmB,oBAAoB;;;;;;;;;EA2BtD,YAAY,cAAc,OAAO,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;wBCnHtC,+BAA+B,YAAY;;;;;;;;;;;;;;;;;UCH1C;;WAEN;;;;;;;;;;;;;;;qBAgBE,uBAAuB,qBAAqB;;;SAEhD;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf,YAAoB,YAAY;;EAGhC;;EAGA;;EAGA;;;;EA2BA;;;;EAQA;;;;EAYA;;;;;;MASI,eAAe;;;;;;;;;;;MAcf,WAAW;;;;;;MASX;;;;;;MASA,QAAQ;;;;;;MASR;;;;;;MASA;;;;;;MASA,SAAS;;;;;;;;;;;;;EAiBb,KAAK,cAAc,UAAU;;;;EAwB7B;;;;EAUA;;;;EAOA;;;;;;;;;;;;;;;;;EAsBA,OAAO,cAAc;;;;;;;;;;;;;;;;;EAuCrB,WAAW,cAAc;;;;;;;;;;;;;;;EAyBzB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBCnSM,gBAAgB,cAAc;;;;;;;;;wBA2B9B,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBC8Pd,kBAAkB;;;;;;UAajB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,QAAQ;;WAER;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuCK,UAAU,SAAS,yBAAyB;;;;;;UAgF3C;;WAEN;;WAEA;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoCK,yBAAyB,eAAe,UAAU,6BAA6B;;;;;;UAoF9E;;WAEN;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuCK,oBAAoB,eAAe,UAAU,wBAAwB;;;;;;;;;;;;;;;wBCzerE,2BAA2B,YAAY;;;;;;;;;;;;;;;;;;;;;;qBCpI1C,uBAAuB;;;SAE3B;;SAGA;;;;EAWP;;;;;;;;;;;EAcA,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCzBA;;WAEX;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAIA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;;;;;YAQU,wBAAwB,4BAA4B;;;;;;;qBAQnD,sBAAsB,SAAS;;;;;;UAyB3B;;WAEN,UAAU;;WAEV;;WAEA;;;;;;;;;;;;;;;;;;;wBAoBK,UAAU,MAAM,eAAe,iBAAiB,UAAU,mBAAmB;;;;;;;;;;;;;;;UC/E5E;;WAEN,OAAO;;WAEP;;WAEA,QAAQ,SAAS;;;;;;;;;;;;;;;;;;qBA2Mf,OAAO,UAAU,gBAAgB;;;;;;;;;;;;;;wBCpP9B,yBAAyB;;;;;;;;wBA2CzB,6BAA6B;;;;;;;;wBAqD7B,qBAAqB;;;;;;;;;;;;;;;;;qBChGxB;;;;;;;;;;;;;;;;;wBAkBG,mBAAmB,aAAa,aAC9C,WACA,WACA,uBACA,KAAK,OACJ;;;;;;;;;;;;wBAiBa,mBAAmB,aAAa,aAC9C,aACA,aACA,uBACA,KAAK,OACJ;;;;;;;;;;;;;;;wBAoBa,qBAAqB;;;;;;;;;wBAYrB,uBAAuB;;;;;;;;;;;;;;;wBAkBvB,mBAAmB;;;;;;;;;;;;wBAenB,YAAY,0BAA0B,0BAA0B;;;;;;;;;;;wBAmBhE,YAAY,0BAA0B,cAAc;;;;;;;;;;;;;;wBAoBpD,kBAAkB;;;;;;;;;;wBAmBlB,UAAU,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;wBA6B3B,qBAAqB,aAAa,aAChD,mBACA,mBACA,OAAO,UACP,iBACA,kBACA,yBACA,KAAK,OACJ;;;;;;;;;;;;;;;;;;;wBChMa,6BAA6B;;;;;;;;wBAe7B,iCAAiC;;;;;;;;wBAqBjC,yBAAyB;;;;;;;;wBAezB,yBAAyB;;;;;;;;wBAWzB,6BAA6B;;;;;;;;wBAW7B,qBAAqB;;;;;;;;;;;;;wBAgBrB,uBAAuB,SAAS,eAAe;;;;;;;;wBAoC/C,mBAAmB,SAAS,eAAe;;;;;;;;;;;;;;;;qBC5H9C;;;;;;qBAOA,0BAA0B;;;WAE5B;;;;;;;;EA8BT,YAAY,SAAS;;;;;;EASrB,OAAO,KAAK;;;;;;;;;;;EAqBZ,eAAe,OAAO;;;;;;EAStB,gBAAgB,QAAQ;;;;;;;;;;wBA0PV,aAAa,OAAO,QAAQ;;;;;;;;;;;;qBCzV/B;;;;;;KAOD,2BAA2B;;;;;;;;;;;qBAY1B;;;;;;;;;;;;;;qBAgBA,0BAA0B;;SAE9B;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf;;EAGA,MAAc;;EAGd;aAAyB;aAAoB;aAAoB;aAAoB;;;EAGrF,QAAgB;;EAGhB;;;;EAKA;;;;;;;EAWA;;;;;;;;;EAqBA,YAAY,KAAK,eAAe;;;;;;;;;;;;;;KCrGtB;;WAGG;;WAEA;;WAEA;;WAEA;;WAEA;;;WAIA;;WAEA,iBAAiB;;;WAIjB;;;;;;;UAQE;;WAEN,OAAO;;WAEP;;WAEA,YAAY,SAAS;;;;;;;;;;;;UAaf;;WAEN;;WAEA;;WAEA,6BAA6B;;WAE7B,iCAAiC,UAAU;;;;;;;;;;;;;UAcrC;;WAEN;;WAEA;;WAEA,iBAAiB;;WAEjB;;;;;;;;;;;;;;;;;;UCxEM;;WAEN;;WAEA;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;wBA+BK,gBAAgB,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4DzC,oBACd,SAAS,WAAW,cAAc,mBAClC,SAAS,uBACT,kBACC;;;;;;;;;;;;;qBCxGU;;;;;;qBAOA;;;;;;qBAOA;;;;;;qBAOA;;;;;;qBAOA;;;;;;;;;;;;;;;KA0BD;;WAGG;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;WAIA;;WAEA,iBAAiB;;WAEjB;;;WAIA;;;;;;;UAQE;;WAEN;;WAEA;;;;;;;UAQM;;WAEN;;WAEA;;WAEA,WAAW;;WAEX,aAAa,SAAS;;WAEtB,qBAAqB;;;;;;;UAQf;;WAEN;;WAEA;;WAEA;;WAEA,gBAAgB;;;;;;;;;;;;;UAcV;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,UAAU;;WAEV;;WAEA;;WAEA;;WAEA;;;;;;;;;;;;;;;;UAiBM;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,YAAY,SAAS;;;;;;;;;;;;;;;;;;;UAoBf;;WAEN,eAAe;;WAEf;;WAEA;;WAEA;;;;;;;;;WASA;;WAEA;;WAEA;;WAEA,mBAAmB;;WAEnB,iBAAiB;;WAEjB,kBAAkB;;WAElB,YAAY,SAAS;;;;;;;UAQf;;WAEN;;;;;;;;UASM;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,WAAW;;WAEX;;WAEA;;WAEA;;WAEA,2BAA2B;;;;;;;UAQrB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,oBAAoB;;WAEpB,kBAAkB;;WAElB,mBAAmB;;WAEnB,aAAa,SAAS;;;;;;;;;;;;;;;;;;;;wBAqBjB,cAAc;;;;;;;;;;;;;;;;wBA8Bd,cAAc;;;;;;;;;;;;;;wBAuCd,cAAc,OAAO,cAAc,mBAAuB;;;;;;;;;;;;;;;wBAyG1D,YAAY,KAAK,mBAAmB,iBAAiB;;;;;;;;;;;;;;;wBAuDrD,cAAc,KAAK,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgCtC,kBAAkB,KAAK,mBAAmB,iBAAiB;;;;;;;;qBC/iB9D;;;;;;;;;;;;;qBAcA,gCAAgC,SAAS,eAAe;;;;;;UAUpD;;WAEN;;WAEA;;WAEA;;;;;WAKA,YAAY;;WAEZ,mBAAmB,SAAS,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4CtC,gBAAgB,eAAe,UAAS,oBAAyB;;;;;;;;;;;;;;;;;;;;wBA8HjE,uBAAuB,kBAAkB,SAAS;;;;;;;;UC1NjD;;WAEN;;WAEA;;;;;WAKA,YAAY;;;;;;;;;;;;;;;;;;;;;wBAsBP,wBAAwB,sBAAsB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqDvD,eAAe,cAAc,UAAS,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;qBC1FnE;;SAEJ;;WAGE;;WAGA,YAAY;;WAGZ;;;;;;;;;EAUT,YAAY,iBAAiB,YAAY;;;;;;;EAiBzC,SAAS;;;;;;;;;;;;;;wBAiBK,uBAAuB,YAAY;;;;;;;;;;;;;qBC9DtC;;;;;;UAOI;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;;;;;;UAQM;;WAEN;;WAEA;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;qBAmBE,gBAAgB,qBAAqB;;;SAEzC;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf,KAAa,YAAY;;EAGzB;;EAGA;;;;EAoCA;;;;EAQA;;;;EAWA;;;;;;MAUI,iBAAiB,OAAO;;;;;;;;;;;;MAexB,sBAAsB;;;;;;MAStB,SAAS;;;;;;MAUT,cAAc;;;;;;MASd;;;;;;MAYA;;;;;;;;;;;MAcA,iBAAiB;;;;;;;;;EAiBrB,QAAQ,eAAe,WAAW;;;;;;;;;;EAoBlC,QAAQ,eAAe,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C7C,SAAS,gBAAgB;;;;;;;;;;;EAmDzB,WAAW,gBAAgB;;;;;;;EAe3B,UAAU,gBAAgB;;;;;;;;;;;;;EAiB1B,YAAY,aAAa,aAAa,OAAO,UAAU,KAAK,OAAO;;;;;;;;;EAuBnE,YAAY,aAAa,aAAa,WAAW,WAAW,KAAK,OAAO;;;;;;;;EAexE,YAAY,WAAW,YAAY;;;;;;EAuBnC;;;;;;;;;;;;;;;;;qBCxZW,wBAAwB,qBAAqB;;;SAEjD;;SAGA;;SAGA;;SAGA,QAAQ;;EAGf,OAAe,YAAY;;EAG3B;;EAGA;;;;EAoBA;;;;EAQA;;;;EAOA;;;;;;MASI;;;;;;MASA;;;;;;MAaA,eAAe;;;;;;;;;;;EAenB;;;;;;;;;;;;EAeA,KAAK,KAAK,SAAS,UAAU,qBAAqB,QAAQ,qBAAqB;;;;;;;;;EA6C/E,iBAAiB;;;;;;;;MAmBb;;;;;;;;EAWJ,QAAQ,UAAU;;;;;;;;;;;;;;qBC7NP"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/service/sorting-layers.ts","../src/atlas/definition.ts","../src/lite/types.ts","../src/atlas/sprite-atlas-asset.ts","../src/lite/sprite-layer.ts","../src/sprite/sprite-renderer.ts","../src/service/layer-registry.ts","../src/camera/camera-2d.ts","../src/sprite/parallax-layer.ts","../src/settings.ts","../src/service/runtime.ts","../src/service/sprite-batch.ts","../src/service/two-d-service.ts","../src/augmentation.ts","../src/tilemap/animated-tiles.ts","../src/animation/animation-system.ts","../src/animation/clip-time.ts","../src/animation/definition.ts","../src/animation/importers.ts","../src/animation/sprite-animation-asset.ts","../src/animation/loader.ts","../src/animation/sprite-animator.ts","../src/assets/relative.ts","../src/atlas/importers.ts","../src/atlas/loader.ts","../src/camera/camera-2d-follow.ts","../src/errors.ts","../src/extension.ts","../src/file-schemas.ts","../src/math/coords.ts","../src/schemas.ts","../src/service/sync-system.ts","../src/sprite/sprite-layer-effect.ts","../src/tilemap/collision-data.ts","../src/tilemap/collision-merge.ts","../src/tilemap/definition.ts","../src/tilemap/importers/ldtk.ts","../src/tilemap/importers/tiled.ts","../src/tilemap/tilemap-asset.ts","../src/tilemap/tilemap.ts","../src/tilemap/tilemap-renderer.ts","../src/version.ts"],"mappings":"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"}
package/dist/index.js CHANGED
@@ -706,6 +706,21 @@ function spriteIndexOf(handle) {
706
706
  return isSprite2DHandleAlive(handle) ? getSprite2DHandleIndex(handle) : -1;
707
707
  }
708
708
  /**
709
+ * Moves a layer to another draw order.
710
+ *
711
+ * @remarks
712
+ * Lite re-sorts its layers by `order` every frame (`lib/sprite/sprite-renderer.js`,
713
+ * `spriteRendererUpdate`), so a new value takes effect on the next frame.
714
+ *
715
+ * @param layer - The layer.
716
+ * @param order - The new draw order; lower draws first.
717
+ *
718
+ * @internal
719
+ */
720
+ function setLayerOrder(layer, order) {
721
+ layer.order = order;
722
+ }
723
+ /**
709
724
  * Removes every sprite from a layer, keeping the layer itself.
710
725
  *
711
726
  * @param layer - The layer to empty.
@@ -4438,6 +4453,12 @@ function tileCollisionInfo(map, tileId) {
4438
4453
  /**
4439
4454
  * A tilemap renderer.
4440
4455
  *
4456
+ * @remarks
4457
+ * Each tilemap layer draws by its `orderInLayer`, then by its place in the document, however often
4458
+ * its chunks are rebuilt. On a sorting layer without Y-sort, tiles draw behind that sorting layer's
4459
+ * sprites when the orders tie. On a Y-sorted sorting layer, tiles sort with sprites by world Y and
4460
+ * `orderInLayer` is their Y-sort bias, as for a `SpriteRenderer`.
4461
+ *
4441
4462
  * @example
4442
4463
  * ```ts
4443
4464
  * const level = app.world.createEntity({ name: "level" });
@@ -4663,7 +4684,7 @@ var TilemapRenderer = class TilemapRenderer extends Component {
4663
4684
  if (frame < 0) continue;
4664
4685
  const centre = worldToPixelsToRef(originX + (x + .5) * cellSize, originY + (y + .5) * cellSize, pixelsPerUnit, this.#pixels);
4665
4686
  writeScratch(this.#scratch, centre.x, centre.y, sizePx, sizePx, frame, 0, 1, 1, 1, alpha, false, false, true);
4666
- sprites.push(registry.placeRaw(sortingLayer, atlas, "alpha", false, this.#scratch));
4687
+ sprites.push(registry.placeTile(sortingLayer, atlas, layer.orderInLayer, layerIndex, this.#scratch));
4667
4688
  }
4668
4689
  }
4669
4690
  this.#chunks.set(`${String(chunkX)},${String(chunkY)}`, {
@@ -4739,6 +4760,8 @@ function tilemapRendererSchema() {
4739
4760
  * Pool sprite layers by sorting layer, atlas, blend mode, and screen-space mode.
4740
4761
  * A changed key needs a new handle because a layer's atlas and blend mode cannot change.
4741
4762
  * The picking map mirrors Lite's swap removal so each index still identifies the right component.
4763
+ * Tilemap layers get Lite layers of their own on a sorting layer that is not Y-sorted, because a
4764
+ * swap removal would otherwise move one tilemap layer's tiles in front of another's.
4742
4765
  */
4743
4766
  /** How many sprites a new layer pre-allocates room for. */
4744
4767
  const INITIAL_LAYER_CAPACITY = 64;
@@ -4765,6 +4788,8 @@ var SpriteLayerRegistry = class {
4765
4788
  #records = /* @__PURE__ */ new Map();
4766
4789
  /** Records in draw order, rebuilt whenever a layer is created. */
4767
4790
  #ordered = [];
4791
+ /** How many sprite layers have been created, so each gets the next creation sequence. */
4792
+ #created = 0;
4768
4793
  #sortingLayers;
4769
4794
  #ySort;
4770
4795
  #onLayerCreated;
@@ -4935,6 +4960,50 @@ var SpriteLayerRegistry = class {
4935
4960
  };
4936
4961
  }
4937
4962
  /**
4963
+ * Adds one tile of a tilemap layer, which no `SpriteRenderer` owns.
4964
+ *
4965
+ * @remarks
4966
+ * A tilemap rebuilds a chunk by removing its sprites, and Lite removes by swapping the last sprite
4967
+ * into the freed slot. In a layer shared by several tilemap layers that moves one layer's tiles in
4968
+ * front of another's. So on a sorting layer that is not Y-sorted, each pair of `orderInLayer` and
4969
+ * layer index gets a Lite layer of its own. Those layers draw by `orderInLayer`, then by the
4970
+ * layer's index in its document, and behind the sorting layer's sprites when `orderInLayer` ties.
4971
+ *
4972
+ * On a Y-sorted sorting layer the tile shares the sprites' layer, so it sorts with characters by
4973
+ * world Y, and `orderInLayer` becomes its Y-sort bias, as for a `SpriteRenderer`. Lite's Y-sort
4974
+ * breaks ties by insertion, which a removal does not reorder.
4975
+ *
4976
+ * Like {@link SpriteLayerRegistry.placeRaw}, the tile takes no slot in the pick map.
4977
+ *
4978
+ * @param sortingLayer - The sorting layer's name.
4979
+ * @param atlas - The atlas the tile draws from.
4980
+ * @param orderInLayer - The tilemap layer's `orderInLayer`.
4981
+ * @param layerIndex - The tilemap layer's index in its document.
4982
+ * @param scratch - The reusable props record, already written.
4983
+ * @returns The key and the handle, for {@link SpriteLayerRegistry.removeRaw}.
4984
+ *
4985
+ * @internal
4986
+ */
4987
+ placeTile(sortingLayer, atlas, orderInLayer, layerIndex, scratch) {
4988
+ const shared = spriteLayerKey(sortingLayer, atlas.address, "alpha", false);
4989
+ const ySort = this.#ySort[sortingLayer] === true;
4990
+ const key = ySort ? shared : `${shared}|tile:${String(orderInLayer)}:${String(layerIndex)}`;
4991
+ const rank = ySort ? null : {
4992
+ orderInLayer,
4993
+ group: 0,
4994
+ tie: layerIndex
4995
+ };
4996
+ const record = this.#ensure(key, sortingLayer, "alpha", false, atlas, INITIAL_LAYER_CAPACITY, rank);
4997
+ const handle = addSprite(record.layer, scratch);
4998
+ const index = spriteIndexOf(handle);
4999
+ if (index >= 0) record.components[index] = null;
5000
+ if (record.ySort) setYSortOrder(handle, orderInLayer);
5001
+ return {
5002
+ key,
5003
+ handle
5004
+ };
5005
+ }
5006
+ /**
4938
5007
  * Claims `capacity` sprite slots in one layer at once — what `app.twoD.createSpriteBatch` is
4939
5008
  * built on.
4940
5009
  *
@@ -5052,16 +5121,18 @@ var SpriteLayerRegistry = class {
5052
5121
  * @param screenSpace - Whether the layer ignores the camera.
5053
5122
  * @param atlas - The atlas to bind the layer to.
5054
5123
  * @param capacity - How many sprites a layer this call creates pre-allocates room for.
5124
+ * @param rank - Where a tilemap layer sits in its sorting layer, or `null` for a sprite layer.
5055
5125
  * @returns The record.
5056
5126
  */
5057
- #ensure(key, sortingLayer, blend, screenSpace, atlas, capacity) {
5127
+ #ensure(key, sortingLayer, blend, screenSpace, atlas, capacity, rank = null) {
5058
5128
  const existing = this.#records.get(key);
5059
5129
  if (existing !== void 0) return existing;
5060
5130
  const liteAtlas = atlas.lite.atlas;
5061
5131
  if (liteAtlas === null) throw new Error("a sprite layer needs an uploaded atlas; this app is headless");
5132
+ const base = this.#sortingLayers.orderOf(sortingLayer);
5062
5133
  const layer = createLayer(liteAtlas, {
5063
5134
  blend,
5064
- order: this.#sortingLayers.orderOf(sortingLayer) + this.#countIn(sortingLayer),
5135
+ order: base,
5065
5136
  capacity,
5066
5137
  customShader: this.#shaderFor(sortingLayer)
5067
5138
  });
@@ -5073,27 +5144,52 @@ var SpriteLayerRegistry = class {
5073
5144
  layer,
5074
5145
  screenSpace,
5075
5146
  ySort,
5076
- components: []
5147
+ components: [],
5148
+ rank: rank ?? {
5149
+ orderInLayer: 0,
5150
+ group: 1,
5151
+ tie: this.#created
5152
+ }
5077
5153
  };
5154
+ this.#created += 1;
5078
5155
  this.#records.set(key, record);
5156
+ this.#renumber(sortingLayer, base);
5079
5157
  this.#ordered.push(record);
5080
5158
  this.#ordered.sort(byOrder);
5081
5159
  this.#onLayerCreated(layer);
5082
5160
  return record;
5083
5161
  }
5084
5162
  /**
5085
- * How many layers a sorting layer already has, so the next one gets the next sub-order.
5163
+ * Gives a sorting layer's Lite layers consecutive orders from `base`, in rank order.
5164
+ *
5165
+ * @remarks
5166
+ * Sprite layers rank by creation, which is stable across a run. The orders never leave the
5167
+ * sorting layer's slice, which `SORTING_LAYER_ORDER_STEP` sizes.
5086
5168
  *
5087
5169
  * @param sortingLayer - The sorting layer's name.
5088
- * @returns The count.
5089
- */
5090
- #countIn(sortingLayer) {
5091
- let count = 0;
5092
- for (const record of this.#records.values()) if (record.sortingLayer === sortingLayer) count += 1;
5093
- return count;
5170
+ * @param base - The sorting layer's base order.
5171
+ */
5172
+ #renumber(sortingLayer, base) {
5173
+ const members = [];
5174
+ for (const record of this.#records.values()) if (record.sortingLayer === sortingLayer) members.push(record);
5175
+ members.sort(byRank);
5176
+ for (let index = 0; index < members.length; index += 1) {
5177
+ const member = members[index];
5178
+ if (member !== void 0) setLayerOrder(member.layer, base + index);
5179
+ }
5094
5180
  }
5095
5181
  };
5096
5182
  /**
5183
+ * Orders two layer records of one sorting layer by their rank.
5184
+ *
5185
+ * @param left - One record.
5186
+ * @param right - The other.
5187
+ * @returns The comparison.
5188
+ */
5189
+ function byRank(left, right) {
5190
+ return left.rank.orderInLayer - right.rank.orderInLayer || left.rank.group - right.rank.group || left.rank.tie - right.rank.tie;
5191
+ }
5192
+ /**
5097
5193
  * Orders two layer records by their Lite draw order.
5098
5194
  *
5099
5195
  * @param left - One record.
@@ -5792,14 +5888,17 @@ function topEdge(shape, offsetX, offsetY) {
5792
5888
  var TilemapAsset = class {
5793
5889
  /** The type name the asset service registers tilemaps under. */
5794
5890
  static assetType = TILEMAP_ASSET_TYPE;
5795
- /** The address the document was loaded from. */
5891
+ /**
5892
+ * The address the document was loaded from. For a map built with {@link createTilemapAsset}, the
5893
+ * `address` option it was given, or `""`.
5894
+ */
5796
5895
  address;
5797
5896
  /** The parsed document, with every tile layer decoded to a dense array. */
5798
5897
  definition;
5799
5898
  /** Each tileset's atlas address, resolved against this document's address. */
5800
5899
  atlasAddresses;
5801
5900
  /**
5802
- * Wraps a parsed document. The `tilemap` loader constructs these.
5901
+ * Wraps a parsed document. The `tilemap` loader and {@link createTilemapAsset} construct these.
5803
5902
  *
5804
5903
  * @param address - The address it was loaded from.
5805
5904
  * @param definition - The parsed document.
@@ -5848,6 +5947,40 @@ function createTilemapLoader() {
5848
5947
  }
5849
5948
  };
5850
5949
  }
5950
+ /**
5951
+ * Publishes a tilemap built in code as an asset, so a `Tilemap` component can hold it.
5952
+ *
5953
+ * @remarks
5954
+ * The document goes through the same `defineTilemap` check the `.tilemap.json` loader runs, so a
5955
+ * map built here and the same map written to a file are interchangeable, and a bad one fails with
5956
+ * the loader's error. The handle is a `memory:` asset (`AssetService.register`): serializing a
5957
+ * component that references it writes `null`.
5958
+ *
5959
+ * @param app - The app.
5960
+ * @param input - The document, in the shape a `.tilemap.json` file holds.
5961
+ * @param options - The address to resolve the tilesets' atlases against.
5962
+ * @returns A handle with one holder, already loaded.
5963
+ * @throws IgnifxError with code `IGX-1105` when the document is malformed (see `defineTilemap`).
5964
+ *
5965
+ * @example
5966
+ * ```ts
5967
+ * const map = createTilemapAsset(app, {
5968
+ * tileWidth: 16,
5969
+ * width: 2,
5970
+ * height: 1,
5971
+ * tilesets: [{ name: "terrain", atlas: "2d/terrain.atlas.json", firstId: 1, tiles: [] }],
5972
+ * layers: [{ name: "Ground", tiles: [1, 2] }],
5973
+ * });
5974
+ * world.createEntity("Level").addComponent(Tilemap, { map });
5975
+ * ```
5976
+ *
5977
+ * @public
5978
+ */
5979
+ function createTilemapAsset(app, input, options = {}) {
5980
+ const address = options.address ?? "";
5981
+ const definition = defineTilemap(input, address === "" ? void 0 : address);
5982
+ return app.assets.register(new TilemapAsset(address, definition), { type: TILEMAP_ASSET_TYPE });
5983
+ }
5851
5984
  //#endregion
5852
5985
  //#region src/tilemap/tilemap.ts
5853
5986
  /**
@@ -7358,7 +7491,7 @@ function spriteClearColor(app) {
7358
7491
  *
7359
7492
  * @public
7360
7493
  */
7361
- const VERSION = "0.17.0";
7494
+ const VERSION = "0.19.0";
7362
7495
  //#endregion
7363
7496
  //#region src/extension.ts
7364
7497
  /**
@@ -8770,6 +8903,6 @@ function readArray(source, key) {
8770
8903
  return isUnknownArray(value) ? value : [];
8771
8904
  }
8772
8905
  //#endregion
8773
- export { Camera2D, Camera2DFollow, DEFAULT_CHUNK_SIZE, DEFAULT_CLIP_FPS, DEFAULT_ORTHOGRAPHIC_SIZE, DEFAULT_PICK_ALL_LIMIT, DEFAULT_PIXELS_PER_UNIT, DEFAULT_REFERENCE_RESOLUTION, DEFAULT_SORTING_LAYER, EMPTY_TILE_ID, LDTK_DEFAULT_INTGRID_COLLIDERS, LDTK_INTGRID_TILESET_NAME, ParallaxLayer, SORTING_LAYER_ORDER_STEP, SPRITE_ANIMATION_ASSET_TYPE, SPRITE_ANIMATION_FILE_EXTENSIONS, SPRITE_ANIMATION_FORMAT, SPRITE_ANIMATION_FORMAT_VERSION, SPRITE_ATLAS_ASSET_TYPE, SPRITE_ATLAS_FILE_EXTENSIONS, SPRITE_ATLAS_FORMAT, SPRITE_ATLAS_FORMAT_VERSION, SPRITE_BLEND_MODES, SPRITE_EFFECT_KINDS, SPRITE_FRAME_FRAGMENT_PREFIX, SortingLayerTable, SpriteAnimationAsset, SpriteAnimator, SpriteAtlasAsset, SpriteLayerEffect, SpriteLayerRegistry, SpriteRenderer, TILEMAP_ASSET_TYPE, TILEMAP_FILE_EXTENSIONS, TILEMAP_FORMAT, TILEMAP_FORMAT_VERSION, TINT_EFFECT_WGSL, TWO_D_ANIMATION_ORDER, TWO_D_ERROR_MESSAGES, TWO_D_MODES, TWO_D_SETTINGS_SECTION, TWO_D_SYNC_ORDER, Tilemap, TilemapAsset, TilemapRenderer, TwoDAnimationSystem, TwoDErrorCode, TwoDService, TwoDSyncSystem, VERSION, asepriteFrameName, createSpriteAnimationLoader, createSpriteAtlasLoader, createTilemapLoader, decodeTileRle, defaultTwoDSettings, defineSpriteAnimation, defineSpriteAtlas, defineTilemap, describeSchemas, describeSpriteAnimationFormat, describeSpriteAtlasFormat, describeTilemapFormat, describeTwoDSchemas, encodeTileRle, fieldInstancesToRecord, findTileset, gridAtlas, importAsepriteAnimations, importAsepriteAtlas, importLdtkLevel, importTexturePackerAtlas, importTiledMap, isFullCellSolid, mergeTileCollisions, normalisePath, parseSpriteFragment, pivotedPositionToRef, pixelsToWorldToRef, readVec2, resolveClipFrames, resolveRelative, selectCamera, sizeForZoom, snapPixel, snapZoomToInteger, spriteAnimationFileSchema, spriteAnimationJsonSchema, spriteAtlasFileSchema, spriteAtlasJsonSchema, spriteClipFrameAtTime, spriteLayerKey, spriteRotationFromLite, spriteRotationToLite, tileCollisionInfo, tileFrameName, tiledPropertiesToRecord, tilemapFileSchema, tilemapJsonSchema, twoD, twoDError, twoDSettingsSchema, viewRotationToLite, worldToPixelsToRef, zoomForSize };
8906
+ export { Camera2D, Camera2DFollow, DEFAULT_CHUNK_SIZE, DEFAULT_CLIP_FPS, DEFAULT_ORTHOGRAPHIC_SIZE, DEFAULT_PICK_ALL_LIMIT, DEFAULT_PIXELS_PER_UNIT, DEFAULT_REFERENCE_RESOLUTION, DEFAULT_SORTING_LAYER, EMPTY_TILE_ID, LDTK_DEFAULT_INTGRID_COLLIDERS, LDTK_INTGRID_TILESET_NAME, ParallaxLayer, SORTING_LAYER_ORDER_STEP, SPRITE_ANIMATION_ASSET_TYPE, SPRITE_ANIMATION_FILE_EXTENSIONS, SPRITE_ANIMATION_FORMAT, SPRITE_ANIMATION_FORMAT_VERSION, SPRITE_ATLAS_ASSET_TYPE, SPRITE_ATLAS_FILE_EXTENSIONS, SPRITE_ATLAS_FORMAT, SPRITE_ATLAS_FORMAT_VERSION, SPRITE_BLEND_MODES, SPRITE_EFFECT_KINDS, SPRITE_FRAME_FRAGMENT_PREFIX, SortingLayerTable, SpriteAnimationAsset, SpriteAnimator, SpriteAtlasAsset, SpriteLayerEffect, SpriteLayerRegistry, SpriteRenderer, TILEMAP_ASSET_TYPE, TILEMAP_FILE_EXTENSIONS, TILEMAP_FORMAT, TILEMAP_FORMAT_VERSION, TINT_EFFECT_WGSL, TWO_D_ANIMATION_ORDER, TWO_D_ERROR_MESSAGES, TWO_D_MODES, TWO_D_SETTINGS_SECTION, TWO_D_SYNC_ORDER, Tilemap, TilemapAsset, TilemapRenderer, TwoDAnimationSystem, TwoDErrorCode, TwoDService, TwoDSyncSystem, VERSION, asepriteFrameName, createSpriteAnimationLoader, createSpriteAtlasLoader, createTilemapAsset, createTilemapLoader, decodeTileRle, defaultTwoDSettings, defineSpriteAnimation, defineSpriteAtlas, defineTilemap, describeSchemas, describeSpriteAnimationFormat, describeSpriteAtlasFormat, describeTilemapFormat, describeTwoDSchemas, encodeTileRle, fieldInstancesToRecord, findTileset, gridAtlas, importAsepriteAnimations, importAsepriteAtlas, importLdtkLevel, importTexturePackerAtlas, importTiledMap, isFullCellSolid, mergeTileCollisions, normalisePath, parseSpriteFragment, pivotedPositionToRef, pixelsToWorldToRef, readVec2, resolveClipFrames, resolveRelative, selectCamera, sizeForZoom, snapPixel, snapZoomToInteger, spriteAnimationFileSchema, spriteAnimationJsonSchema, spriteAtlasFileSchema, spriteAtlasJsonSchema, spriteClipFrameAtTime, spriteLayerKey, spriteRotationFromLite, spriteRotationToLite, tileCollisionInfo, tileFrameName, tiledPropertiesToRecord, tilemapFileSchema, tilemapJsonSchema, twoD, twoDError, twoDSettingsSchema, viewRotationToLite, worldToPixelsToRef, zoomForSize };
8774
8907
 
8775
8908
  //# sourceMappingURL=index.js.map