A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
fix(assets): the 9-slice border actually reaches the renderer
yhh52bd0728ce43
diff --git a/desktop/src/project/ProjectStore.ts b/desktop/src/project/ProjectStore.tsindex af6dd5a7b..186fa4ad8 100644--- a/desktop/src/project/ProjectStore.ts+++ b/desktop/src/project/ProjectStore.ts@@ -1,8 +1,8 @@// SPDX-License-Identifier: Apache-2.0// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Teamimport { createStore } from 'zustand/vanilla';-import { getComponent, getEditorType, Assets, migratePrefabData, extractPrefab, flattenPrefab, collectExternalEntityRefs, collapseInstance, applyDeltaToSource, buildVariant, validateOverrides, setTextureParams, TextureFilter, TextureWrap, Renderer, RETIRED_COMPONENT_TYPES, parseThemeOverrides, resolveAssetGroup, folderGroupMode, withFolderGroup, folderAlwaysInclude, withFolderAlwaysInclude, withActiveRemoteRoot } from 'esengine';-import { readTextureImportSettings, importerDefaults, applyImporterEdit } from './assetImporter';+import { getComponent, getEditorType, Assets, migratePrefabData, extractPrefab, flattenPrefab, collectExternalEntityRefs, collapseInstance, applyDeltaToSource, buildVariant, validateOverrides, setTextureParams, setTextureSliceBorder, textureImportSettingsFrom, TextureFilter, TextureWrap, Renderer, RETIRED_COMPONENT_TYPES, parseThemeOverrides, resolveAssetGroup, folderGroupMode, withFolderGroup, folderAlwaysInclude, withFolderAlwaysInclude, withActiveRemoteRoot } from 'esengine';+import { importerDefaults, applyImporterEdit } from './assetImporter';import type { SceneData, PrefabData, ExtractEntity, ProcessedEntity, PhysicsPluginConfig, AudioProjectConfig, AssetsData, ThemeOverrides, StaleOverride, PrefabOverride, AddressableManifest, AssetGroupsConfig, AssetGroupMode } from 'esengine';import { EngineHost } from '@/engine/EngineHost';import { applyWidgetTheme } from '@/engine/widgetTheme';@@ -752,9 +752,9 @@ class ProjectStoreImpl {/** The texture filter/wrap for a ref (`@uuid:` or path), from its `.meta`* importer — the shape `Assets`'s TextureLoader consumes. Undefined ⇒ defaults. */- private textureImportFor(ref: string): ReturnType<typeof readTextureImportSettings> {+ private textureImportFor(ref: string): ReturnType<typeof textureImportSettingsFrom> {const uuid = refUuid(ref) ?? this.pathToUuid.get(ref);- return readTextureImportSettings(uuid ? this.uuidToImporter.get(uuid) : undefined);+ return textureImportSettingsFrom(uuid ? this.uuidToImporter.get(uuid) : undefined);}/** Push a texture's just-saved import settings to its LIVE gl handle so the edit@@ -763,13 +763,19 @@ class ProjectStoreImpl {* after the asset inspector writes the `.meta` + refreshAssets. */applyLiveTextureSettings(path: string): void {const uuid = this.pathToUuid.get(path);- const s = readTextureImportSettings(uuid ? this.uuidToImporter.get(uuid) : undefined);+ const s = textureImportSettingsFrom(uuid ? this.uuidToImporter.get(uuid) : undefined);const handle = uuid ? EngineHost.getResource(Assets)?.getTexture(UUID_PREFIX + uuid)?.handle : undefined;if (!s || !handle) return;const filter = s.filter === 'nearest' ? TextureFilter.Nearest : TextureFilter.Linear;const wrap =s.wrap === 'clamp' ? TextureWrap.ClampToEdge : s.wrap === 'mirror' ? TextureWrap.MirroredRepeat : TextureWrap.Repeat;setTextureParams(handle, filter, filter, wrap, wrap);+ // The 9-slice border is applied at load; re-stamp it so dragging a border in+ // the asset inspector re-slices the live viewport without a scene reload.+ if (s.sliceBorder) {+ const b = s.sliceBorder;+ setTextureSliceBorder(handle, b.left, b.right, b.top, b.bottom);+ }}/**diff --git a/desktop/src/project/assetImporter.ts b/desktop/src/project/assetImporter.tsindex adb5386eb..c5f666678 100644--- a/desktop/src/project/assetImporter.ts+++ b/desktop/src/project/assetImporter.ts@@ -234,18 +234,12 @@ export function readTextureCookSettings(importer: Record<string, unknown> | undereturn resolved;}-/** A texture's sampler settings, in the string shape the engine's TextureLoader- * and the runtime importer-resolver consume (filterMode/wrapMode → filter/wrap).- * Undefined when the `.meta` carries neither ⇒ loader defaults. */-export function readTextureImportSettings(- importer: Record<string, unknown> | undefined,-): { filter?: 'linear' | 'nearest'; wrap?: 'repeat' | 'clamp' | 'mirror'; srgb?: boolean } | undefined {- if (!importer) return undefined;- const filter = importer.filterMode as 'linear' | 'nearest' | undefined;- const wrap = importer.wrapMode as 'repeat' | 'clamp' | 'mirror' | undefined;- const srgb = typeof importer.sRGB === 'boolean' ? importer.sRGB : undefined;- return filter || wrap || srgb !== undefined ? { filter, wrap, srgb } : undefined;-}+// A texture's LOAD-time settings (sampler + 9-slice border) are parsed by the+// SDK's `textureImportSettingsFrom`, not here: the editor and a shipped build+// read the same `.meta` importer block, and a second reader is how "works in+// the editor, not in the build" gets born. This module stays engine-free (the+// Electron main process imports it for the cook), which is why the parser lives+// on the SDK side rather than the other way round./** Apply one inspector edit to a copy of the `importer` block (dotted keys →* nested), returning the new block. Pure — the caller owns dirty/save. */diff --git a/desktop/tests/asset-importer.test.ts b/desktop/tests/asset-importer.test.tsindex 55ff522de..e03ec24ed 100644--- a/desktop/tests/asset-importer.test.ts+++ b/desktop/tests/asset-importer.test.ts@@ -13,7 +13,6 @@ import {buildImporterComponent,applyImporterEdit,hasImporterSettings,- readTextureImportSettings,readTextureCookSettings,} from '../src/project/assetImporter';@@ -91,18 +90,6 @@ describe('buildImporterComponent (inspector fields)', () => {});});-describe('readTextureImportSettings (edit-viewport = runtime)', () => {- it('maps filterMode/wrapMode to the loader filter/wrap shape', () => {- expect(readTextureImportSettings({ filterMode: 'nearest', wrapMode: 'clamp' })).toEqual({ filter: 'nearest', wrap: 'clamp' });- expect(readTextureImportSettings({ filterMode: 'linear' })).toEqual({ filter: 'linear', wrap: undefined });- });- it('is undefined when neither is present (loader defaults) or no importer', () => {- expect(readTextureImportSettings({ maxSize: 2048 })).toBeUndefined();- expect(readTextureImportSettings(undefined)).toBeUndefined();- expect(readTextureImportSettings({})).toBeUndefined();- });-});-describe('applyImporterEdit (dotted keys → nested, pure)', () => {it('sets a nested key without mutating the input', () => {const before = { filterMode: 'linear', sliceBorder: { left: 0, right: 0 } };diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.mdindex 11000b454..28cd1ca23 100644--- a/sdk/etc/index.api.md+++ b/sdk/etc/index.api.md@@ -1,7 +1,7 @@# API surface — esengine/index<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 1366 stable · 17 beta · 1 deprecated+Symbols: 1369 stable · 17 beta · 1 deprecated## ABI_LAYOUT_HASH — const```@@ -4324,6 +4324,14 @@ BuiltinComponentDef<ParentData>entity: number```+## ParsedTextureImportSettings — interface+```+filter: "linear" | "nearest" | undefined+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined+srgb: boolean | undefined+wrap: "repeat" | "clamp" | "mirror" | undefined+```+## Particle — const```ResourceDef<ParticleAPI>@@ -10127,6 +10135,11 @@ Plugin(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void```+## setTextureSliceBorder — function+```+(textureId: number, left: number, right: number, top: number, bottom: number): void+```+## setTextureWrap — function```(textureId: number, wrap: TextureWrap): void@@ -10252,6 +10265,11 @@ TextInputPluginTextPlugin```+## textureImportSettingsFrom — function+```+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined+```+## themeButtonStates — function```(): Record<string, ButtonStateVisual>diff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.mdindex 4a8afb2ea..c1beaf04b 100644--- a/sdk/etc/index.native.api.md+++ b/sdk/etc/index.native.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.native<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 1385 stable · 22 beta · 1 deprecated+Symbols: 1388 stable · 22 beta · 1 deprecated## ABI_LAYOUT_HASH — const```@@ -4478,6 +4478,14 @@ BuiltinComponentDef<ParentData>entity: number```+## ParsedTextureImportSettings — interface+```+filter: "linear" | "nearest" | undefined+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined+srgb: boolean | undefined+wrap: "repeat" | "clamp" | "mirror" | undefined+```+## Particle — const```ResourceDef<ParticleAPI>@@ -10341,6 +10349,11 @@ Plugin(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void```+## setTextureSliceBorder — function+```+(textureId: number, left: number, right: number, top: number, bottom: number): void+```+## setTextureWrap — function```(textureId: number, wrap: TextureWrap): void@@ -10466,6 +10479,11 @@ TextInputPluginTextPlugin```+## textureImportSettingsFrom — function+```+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined+```+## themeButtonStates — function```(): Record<string, ButtonStateVisual>diff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.mdindex bb34e28b3..ed5f07567 100644--- a/sdk/etc/index.node.api.md+++ b/sdk/etc/index.node.api.md@@ -1,7 +1,7 @@# API surface — esengine/index.node<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 1365 stable · 19 beta · 1 deprecated+Symbols: 1368 stable · 19 beta · 1 deprecated## ANCHOR_AXES — const```@@ -4319,6 +4319,14 @@ BuiltinComponentDef<ParentData>entity: number```+## ParsedTextureImportSettings — interface+```+filter: "linear" | "nearest" | undefined+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined+srgb: boolean | undefined+wrap: "repeat" | "clamp" | "mirror" | undefined+```+## Particle — const```ResourceDef<ParticleAPI>@@ -10132,6 +10140,11 @@ Plugin(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void```+## setTextureSliceBorder — function+```+(textureId: number, left: number, right: number, top: number, bottom: number): void+```+## setTextureWrap — function```(textureId: number, wrap: TextureWrap): void@@ -10257,6 +10270,11 @@ TextInputPluginTextPlugin```+## textureImportSettingsFrom — function+```+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined+```+## themeButtonStates — function```(): Record<string, ButtonStateVisual>diff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.mdindex 5bd35132c..e524ef8e8 100644--- a/sdk/etc/minigame.api.md+++ b/sdk/etc/minigame.api.md@@ -1,7 +1,7 @@# API surface — esengine/minigame<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 1386 stable · 17 beta · 1 deprecated+Symbols: 1389 stable · 17 beta · 1 deprecated## ANCHOR_AXES — const```@@ -4534,6 +4534,14 @@ BuiltinComponentDef<ParentData>entity: number```+## ParsedTextureImportSettings — interface+```+filter: "linear" | "nearest" | undefined+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined+srgb: boolean | undefined+wrap: "repeat" | "clamp" | "mirror" | undefined+```+## Particle — const```ResourceDef<ParticleAPI>@@ -10352,6 +10360,11 @@ Plugin(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void```+## setTextureSliceBorder — function+```+(textureId: number, left: number, right: number, top: number, bottom: number): void+```+## setTextureWrap — function```(textureId: number, wrap: TextureWrap): void@@ -10477,6 +10490,11 @@ TextInputPluginTextPlugin```+## textureImportSettingsFrom — function+```+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined+```+## themeButtonStates — function```(): Record<string, ButtonStateVisual>diff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.mdindex a49203dc7..833cccbd4 100644--- a/sdk/etc/wechat.api.md+++ b/sdk/etc/wechat.api.md@@ -1,7 +1,7 @@# API surface — esengine/wechat<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->-Symbols: 1376 stable · 17 beta · 1 deprecated+Symbols: 1379 stable · 17 beta · 1 deprecated## ANCHOR_AXES — const```@@ -4326,6 +4326,14 @@ BuiltinComponentDef<ParentData>entity: number```+## ParsedTextureImportSettings — interface+```+filter: "linear" | "nearest" | undefined+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined+srgb: boolean | undefined+wrap: "repeat" | "clamp" | "mirror" | undefined+```+## Particle — const```ResourceDef<ParticleAPI>@@ -10151,6 +10159,11 @@ Plugin(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void```+## setTextureSliceBorder — function+```+(textureId: number, left: number, right: number, top: number, bottom: number): void+```+## setTextureWrap — function```(textureId: number, wrap: TextureWrap): void@@ -10276,6 +10289,11 @@ TextInputPluginTextPlugin```+## textureImportSettingsFrom — function+```+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined+```+## themeButtonStates — function```(): Record<string, ButtonStateVisual>diff --git a/sdk/src/asset/Assets.ts b/sdk/src/asset/Assets.tsindex 774e5641d..8b2b5361a 100644--- a/sdk/src/asset/Assets.ts+++ b/sdk/src/asset/Assets.ts@@ -40,6 +40,7 @@ import type { SceneData } from '../scene';import { SceneHandle, type ReleaseCallback } from './SceneHandle';import type { AssetRegistry } from './AssetRegistry';import { UUID_REF_PREFIX } from './AssetRegistry';+import { textureImportSettingsFrom } from './textureImportSettings';import type { AssetRefCounter } from './AssetRefCounter';import { log } from '../logger';@@ -295,6 +296,15 @@ export class Assets {});this.textureRefCounts_.set(cacheKey, (this.textureRefCounts_.get(cacheKey) ?? 0) + 1);this.recordHandlePath_('texture', result.handle, path);+ // The 9-slice border belongs to the IMAGE, so it rides its import+ // settings and is stamped onto the handle here — the one place every+ // creation path (decode, revive, external, cooked) funnels through, and+ // where the settings are already resolved. Without this a UIVisual set+ // to NineSlice finds no texture metadata and stretches its corners.+ if (settings?.sliceBorder) {+ const b = settings.sliceBorder;+ requireResourceManager().setTextureMetadata(result.handle, b.left, b.right, b.top, b.bottom);+ }return result;}@@ -1335,6 +1345,18 @@ export class Assets {setAssetRegistry(registry: AssetRegistry): void {this.assetRegistry_ = registry;this.assetRefResolver_ = (ref) => registry.resolveRef(ref);+ // The registry carries each asset's importer block (the cook copies it+ // into the ship manifest verbatim), so a shipped game has the same+ // import settings the editor does — it just never read them. Default the+ // texture resolver to it, so filter/wrap/sRGB and the 9-slice border+ // survive the build. A host that installed its own resolver keeps it.+ if (!this.textureImportResolver_) {+ this.textureImportResolver_ = (ref) => {+ const path = this.resolveLoadPath_(ref);+ const entry = registry.getEntryByPath(path) ?? registry.getEntryByPath(ref);+ return textureImportSettingsFrom(entry?.importer);+ };+ }}getAssetRegistry(): AssetRegistry | null {diff --git a/sdk/src/asset/index.ts b/sdk/src/asset/index.tsindex b0f0c32bc..99a4db13b 100644--- a/sdk/src/asset/index.ts+++ b/sdk/src/asset/index.ts@@ -30,6 +30,7 @@ export {} from './assetGroups';export { xxh64, contentHashHex, contentHashOf } from './contentHash';export { AsyncCache } from './AsyncCache';+export { textureImportSettingsFrom, type ParsedTextureImportSettings } from './textureImportSettings';export { Assets, AssetPlugin, assetPlugin, type AssetsData } from './AssetPlugin';export { decodeImageBitmap, decodeImagePixels, imageBitmapOptions, type DecodedPixels, fetchDecodePixels } from './imageDecode';export { AssetRefCounter, type AssetRefInfo } from './AssetRefCounter';diff --git a/sdk/src/asset/loaders/TextureLoader.ts b/sdk/src/asset/loaders/TextureLoader.tsindex 3b2c6419c..dfb48bc37 100644--- a/sdk/src/asset/loaders/TextureLoader.ts+++ b/sdk/src/asset/loaders/TextureLoader.ts@@ -38,6 +38,13 @@ export interface TextureImportSettings {* data (normal maps, masks) sets false so the linear pipeline skips the* hardware EOTF. Ignored in gamma mode. */readonly srgb?: boolean;+ /**+ * 9-slice border in texture pixels. A property of the IMAGE (where its+ * corners end), not of any one entity — so it is authored once at import+ * and every `UIVisual` set to NineSlice inherits it. Applied to the texture+ * handle's metadata at load; a UIVisual may still override per entity.+ */+ readonly sliceBorder?: { readonly left: number; readonly right: number; readonly top: number; readonly bottom: number };}export type TextureImportSettingsResolver = (ref: string) => TextureImportSettings | undefined;diff --git a/sdk/src/asset/textureImportSettings.ts b/sdk/src/asset/textureImportSettings.tsnew file mode 100644index 000000000..bfeb022a8--- /dev/null+++ b/sdk/src/asset/textureImportSettings.ts@@ -0,0 +1,51 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file asset/textureImportSettings.ts+ * @brief The `.meta` importer block → {@link TextureImportSettings}.+ *+ * One parser, because there is one source: the importer block the asset+ * inspector edits, which the cook copies verbatim into the ship manifest. The+ * editor reads it from its own asset database and the runtime from the+ * AssetRegistry, but they must agree on what it MEANS — a second reader is how+ * "works in the editor, not in the build" gets born.+ */++/** Import-time texture settings, as the loader consumes them. */+export interface ParsedTextureImportSettings {+ filter?: 'linear' | 'nearest';+ wrap?: 'repeat' | 'clamp' | 'mirror';+ srgb?: boolean;+ sliceBorder?: { left: number; right: number; top: number; bottom: number };+}++/**+ * A 9-slice border, or undefined when the block slices nothing. All-zero is the+ * "not 9-sliced" default and must NOT be stamped onto the texture: doing so+ * would clear a border another consumer authored.+ */+function readSliceBorder(raw: unknown): ParsedTextureImportSettings['sliceBorder'] {+ if (!raw || typeof raw !== 'object') return undefined;+ const b = raw as Record<string, unknown>;+ const n = (v: unknown): number => (typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : 0);+ const border = { left: n(b.left), right: n(b.right), top: n(b.top), bottom: n(b.bottom) };+ return border.left || border.right || border.top || border.bottom ? border : undefined;+}++/** Parse an importer block; undefined when it carries nothing the loader needs. */+export function textureImportSettingsFrom(+ importer: Record<string, unknown> | undefined | null,+): ParsedTextureImportSettings | undefined {+ if (!importer) return undefined;+ const filter = importer.filterMode === 'nearest' || importer.filterMode === 'linear'+ ? importer.filterMode+ : undefined;+ const wrap = importer.wrapMode === 'repeat' || importer.wrapMode === 'clamp' || importer.wrapMode === 'mirror'+ ? importer.wrapMode+ : undefined;+ const srgb = typeof importer.sRGB === 'boolean' ? importer.sRGB : undefined;+ const sliceBorder = readSliceBorder(importer.sliceBorder);+ return filter || wrap || srgb !== undefined || sliceBorder+ ? { filter, wrap, srgb, sliceBorder }+ : undefined;+}diff --git a/sdk/src/core-content.ts b/sdk/src/core-content.tsindex af4787181..cf729acfc 100644--- a/sdk/src/core-content.ts+++ b/sdk/src/core-content.ts@@ -89,6 +89,8 @@ export {type SpineLoadResult,type LocaleResult,type AssetRefInfo,+ textureImportSettingsFrom,+ type ParsedTextureImportSettings,} from './asset';// =============================================================================diff --git a/sdk/src/core-render.ts b/sdk/src/core-render.tsindex ecbbc18ff..b07091a21 100644--- a/sdk/src/core-render.ts+++ b/sdk/src/core-render.ts@@ -33,7 +33,7 @@ export { Graphics } from './graphics';// Texture// =============================================================================-export { TextureFilter, TextureWrap, setTextureFilter, setTextureWrap, setTextureParams } from './textureParams';+export { TextureFilter, TextureWrap, setTextureFilter, setTextureWrap, setTextureParams, setTextureSliceBorder } from './textureParams';// =============================================================================// Cameradiff --git a/sdk/src/textureParams.ts b/sdk/src/textureParams.tsindex d14570e1b..cce17658b 100644--- a/sdk/src/textureParams.ts+++ b/sdk/src/textureParams.ts@@ -1,6 +1,7 @@// SPDX-License-Identifier: Apache-2.0// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Teamimport { Renderer } from './renderer';+import { requireResourceManager } from './resourceManager';export const TextureFilter = {Nearest: 0,@@ -34,3 +35,20 @@ export function setTextureParams(): void {Renderer.setTextureParams(textureId, minFilter, magFilter, wrapS, wrapT);}++/**+ * The texture's 9-slice border, in texture pixels from each edge. A property of+ * the IMAGE — every `UIVisual` set to NineSlice reads it, so a frame is sliced+ * once at import rather than re-typed on every entity that uses it. Normally+ * applied by the asset pipeline at load; call it directly to re-slice a texture+ * already resident (an authoring tool editing the border live).+ */+export function setTextureSliceBorder(+ textureId: number,+ left: number,+ right: number,+ top: number,+ bottom: number,+): void {+ requireResourceManager().setTextureMetadata(textureId, left, right, top, bottom);+}diff --git a/sdk/tests/texture-import-settings.test.ts b/sdk/tests/texture-import-settings.test.tsnew file mode 100644index 000000000..131b37b35--- /dev/null+++ b/sdk/tests/texture-import-settings.test.ts@@ -0,0 +1,74 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file The `.meta` importer block → texture load settings.+ *+ * One parser for the editor viewport and a shipped build, so this is where the+ * meaning of that block is pinned. The 9-slice rule earns its own cases: an+ * all-zero border means "not sliced" and must stay ABSENT, because a present+ * border is stamped onto the texture and would clear one set elsewhere.+ */+import { describe, it, expect } from 'vitest';+import { textureImportSettingsFrom } from '../src/asset/textureImportSettings';++describe('textureImportSettingsFrom', () => {+ it('maps filterMode/wrapMode to the loader filter/wrap shape', () => {+ expect(textureImportSettingsFrom({ filterMode: 'nearest', wrapMode: 'clamp' }))+ .toEqual({ filter: 'nearest', wrap: 'clamp', srgb: undefined, sliceBorder: undefined });+ expect(textureImportSettingsFrom({ filterMode: 'linear' }))+ .toEqual({ filter: 'linear', wrap: undefined, srgb: undefined, sliceBorder: undefined });+ });++ it('carries sRGB only when the block states it', () => {+ expect(textureImportSettingsFrom({ sRGB: false })?.srgb).toBe(false);+ expect(textureImportSettingsFrom({ sRGB: true })?.srgb).toBe(true);+ expect(textureImportSettingsFrom({ filterMode: 'linear' })?.srgb).toBeUndefined();+ });++ it('is undefined when the block carries nothing the loader needs', () => {+ expect(textureImportSettingsFrom({ maxSize: 2048 })).toBeUndefined();+ expect(textureImportSettingsFrom({})).toBeUndefined();+ expect(textureImportSettingsFrom(undefined)).toBeUndefined();+ expect(textureImportSettingsFrom(null)).toBeUndefined();+ });++ it('ignores junk values rather than passing them to the loader', () => {+ expect(textureImportSettingsFrom({ filterMode: 'wobbly', wrapMode: 7 })).toBeUndefined();+ expect(textureImportSettingsFrom({ sRGB: 'yes' })).toBeUndefined();+ });++ describe('9-slice border', () => {+ it('reads a full border', () => {+ expect(textureImportSettingsFrom({ sliceBorder: { left: 12, right: 13, top: 14, bottom: 15 } })?.sliceBorder)+ .toEqual({ left: 12, right: 13, top: 14, bottom: 15 });+ });++ it('keeps a partial border, zero-filling the edges that do not slice', () => {+ expect(textureImportSettingsFrom({ sliceBorder: { left: 24, right: 24 } })?.sliceBorder)+ .toEqual({ left: 24, right: 24, top: 0, bottom: 0 });+ });++ it('treats an all-zero border as NOT sliced, so it is never stamped', () => {+ expect(textureImportSettingsFrom({ sliceBorder: { left: 0, right: 0, top: 0, bottom: 0 } }))+ .toBeUndefined();+ });++ it('drops negative and non-finite edges', () => {+ expect(textureImportSettingsFrom({ sliceBorder: { left: -5, right: NaN, top: 8, bottom: 'x' } })?.sliceBorder)+ .toEqual({ left: 0, right: 0, top: 8, bottom: 0 });+ });++ it('survives a hand-edited block that is not an object', () => {+ expect(textureImportSettingsFrom({ sliceBorder: 12 })).toBeUndefined();+ expect(textureImportSettingsFrom({ sliceBorder: null })).toBeUndefined();+ });++ it('comes through alongside sampler settings', () => {+ expect(textureImportSettingsFrom({ filterMode: 'nearest', sliceBorder: { left: 4 } }))+ .toEqual({+ filter: 'nearest', wrap: undefined, srgb: undefined,+ sliceBorder: { left: 4, right: 0, top: 0, bottom: 0 },+ });+ });+ });+});