@pkhex-everywhere/engine 0.16.0 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @pkhex-everywhere/engine
 
+## 0.18.0
+
+### Minor Changes
+
+- db3c07e: A transfer to an older game keeps a copy of the Pokémon, so a later transfer forward restores what the older game dropped. Each offer has `keepsCopy`, and `transfer.commit` returns a `keptCopy` for each Pokémon that moved to an older game. Pass stored copies in the offer's new `keptCopies`: a copy with the Pokémon's `identityKey` puts back its ball, met data, origin game, ribbons and ability, with the new reason `restored`. `PokemonSummary` and `PokemonPreview` gain `identityKey`, built from the PID, trainer ID and secret ID, and null in Gen 1 and 2.
+
+## 0.17.0
+
+### Minor Changes
+
+- 1572d36: `pokemon.read` reads Gen 5 Pokémon from Black, White, Black 2 and White 2, in their 220-byte party and 136-byte box layouts.
+- 881c351: The `trade` namespace is now `transfer`. `trade.*` calls become `transfer.*`, `useTrade` becomes `useTransfer`, every `Trade*` type becomes `Transfer*`, `TradedPokemon` becomes `TransferredPokemon`, the `trade` topic becomes `transfer`, and the `trade-refused` and `no-trade` errors become `transfer-refused` and `no-transfer`. The `link` route and the `link` and `tradeEvolution` change reasons keep their names.
+- 2251534: Transfers take the new `unofficial` route between any two saves no game connects, such as Platinum to Ruby. It strips the moves, item, ball and ability the destination doesn't have, with the reason `notInGame`, and reports every other change with the reason `unofficial`. Each offer has a `route`, `TransferField` gains `level`, `nature`, `gender`, `shiny`, `language`, `originalTrainer`, `trainerId`, `originGame` and `metDate`, and a Pokémon PKHeX can't convert is refused with `conversionFailed`. `noRoute` is left for ROM hack formats and Let's Go.
+  
+  `box.previewFile(bytes)` shows how a Pokémon file would arrive, with `unofficial: true` when no game can move it. `box.addFromFile(bytes, { allowUnofficial: true })` adds such a file; without the option it still fails with `conversion-failed`.
+
 ## 0.16.0
 
 ### Minor Changes

package/_framework/dotnet.js

@@ -4,7 +4,7 @@
 var e=!1;const t=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,0,0,1,4,1,96,0,0,3,2,1,0,10,8,1,6,0,6,64,25,11,11])),o=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,0,0,1,5,1,96,0,1,123,3,2,1,0,10,15,1,13,0,65,1,253,15,65,2,253,15,253,128,2,11])),n=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,0,0,1,5,1,96,0,1,123,3,2,1,0,10,10,1,8,0,65,0,253,15,253,98,11])),r=Symbol.for("wasm promise_control");function i(e,t){let o=null;const n=new Promise((function(n,r){o={isDone:!1,promise:null,resolve:t=>{o.isDone||(o.isDone=!0,n(t),e&&e())},reject:e=>{o.isDone||(o.isDone=!0,r(e),t&&t())}}}));o.promise=n;const i=n;return i[r]=o,{promise:i,promise_control:o}}function s(e){return e[r]}function a(e){e&&function(e){return void 0!==e[r]}(e)||Be(!1,"Promise is not controllable")}const l="__mono_message__",c=["debug","log","trace","warn","info","error"],d="MONO_WASM: ";let u,f,m,g,p,h;function w(e){g=e}function b(e){if(Pe.diagnosticTracing){const t="function"==typeof e?e():e;console.debug(d+t)}}function y(e,...t){console.info(d+e,...t)}function v(e,...t){console.info(e,...t)}function E(e,...t){console.warn(d+e,...t)}function _(e,...t){if(t&&t.length>0&&t[0]&&"object"==typeof t[0]){if(t[0].silent)return;if(t[0].toString)return void console.error(d+e,t[0].toString())}console.error(d+e,...t)}function x(e,t,o){return function(...n){try{let r=n[0];if(void 0===r)r="undefined";else if(null===r)r="null";else if("function"==typeof r)r=r.toString();else if("string"!=typeof r)try{r=JSON.stringify(r)}catch(e){r=r.toString()}t(o?JSON.stringify({method:e,payload:r,arguments:n.slice(1)}):[e+r,...n.slice(1)])}catch(e){m.error(`proxyConsole failed: ${e}`)}}}function j(e,t,o){f=t,g=e,m={...t};const n=`${o}/console`.replace("https://","wss://").replace("http://","ws://");u=new WebSocket(n),u.addEventListener("error",A),u.addEventListener("close",S),function(){for(const e of c)f[e]=x(`console.${e}`,T,!0)}()}function R(e){let t=30;const o=()=>{u?0==u.bufferedAmount||0==t?(e&&v(e),function(){for(const e of c)f[e]=x(`console.${e}`,m.log,!1)}(),u.removeEventListener("error",A),u.removeEventListener("close",S),u.close(1e3,e),u=void 0):(t--,globalThis.setTimeout(o,100)):e&&m&&m.log(e)};o()}function T(e){u&&u.readyState===WebSocket.OPEN?u.send(e):m.log(e)}function A(e){m.error(`[${g}] proxy console websocket error: ${e}`,e)}function S(e){m.debug(`[${g}] proxy console websocket closed: ${e}`,e)}function D(){Pe.preferredIcuAsset=O(Pe.config);let e="invariant"==Pe.config.globalizationMode;if(!e)if(Pe.preferredIcuAsset)Pe.diagnosticTracing&&b("ICU data archive(s) available, disabling invariant mode");else{if("custom"===Pe.config.globalizationMode||"all"===Pe.config.globalizationMode||"sharded"===Pe.config.globalizationMode){const e="invariant globalization mode is inactive and no ICU data archives are available";throw _(`ERROR: ${e}`),new Error(e)}Pe.diagnosticTracing&&b("ICU data archive(s) not available, using invariant globalization mode"),e=!0,Pe.preferredIcuAsset=null}const t="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT",o=Pe.config.environmentVariables;if(void 0===o[t]&&e&&(o[t]="1"),void 0===o.TZ)try{const e=Intl.DateTimeFormat().resolvedOptions().timeZone||null;e&&(o.TZ=e)}catch(e){y("failed to detect timezone, will fallback to UTC")}}function O(e){var t;if((null===(t=e.resources)||void 0===t?void 0:t.icu)&&"invariant"!=e.globalizationMode){const t=e.applicationCulture||(ke?globalThis.navigator&&globalThis.navigator.languages&&globalThis.navigator.languages[0]:Intl.DateTimeFormat().resolvedOptions().locale),o=e.resources.icu;let n=null;if("custom"===e.globalizationMode){if(o.length>=1)return o[0].name}else t&&"all"!==e.globalizationMode?"sharded"===e.globalizationMode&&(n=function(e){const t=e.split("-")[0];return"en"===t||["fr","fr-FR","it","it-IT","de","de-DE","es","es-ES"].includes(e)?"icudt_EFIGS.dat":["zh","ko","ja"].includes(t)?"icudt_CJK.dat":"icudt_no_CJK.dat"}(t)):n="icudt.dat";if(n)for(let e=0;e<o.length;e++){const t=o[e];if(t.virtualPath===n)return t.name}}return e.globalizationMode="invariant",null}(new Date).valueOf();const C=class{constructor(e){this.url=e}toString(){return this.url}};async function k(e,t){try{const o="function"==typeof globalThis.fetch;if(Se){const n=e.startsWith("file://");if(!n&&o)return globalThis.fetch(e,t||{credentials:"same-origin"});p||(h=Ne.require("url"),p=Ne.require("fs")),n&&(e=h.fileURLToPath(e));const r=await p.promises.readFile(e);return{ok:!0,headers:{length:0,get:()=>null},url:e,arrayBuffer:()=>r,json:()=>JSON.parse(r),text:()=>{throw new Error("NotImplementedException")}}}if(o)return globalThis.fetch(e,t||{credentials:"same-origin"});if("function"==typeof read)return{ok:!0,url:e,headers:{length:0,get:()=>null},arrayBuffer:()=>new Uint8Array(read(e,"binary")),json:()=>JSON.parse(read(e,"utf8")),text:()=>read(e,"utf8")}}catch(t){return{ok:!1,url:e,status:500,headers:{length:0,get:()=>null},statusText:"ERR28: "+t,arrayBuffer:()=>{throw t},json:()=>{throw t},text:()=>{throw t}}}throw new Error("No fetch implementation available")}function I(e){return"string"!=typeof e&&Be(!1,"url must be a string"),!M(e)&&0!==e.indexOf("./")&&0!==e.indexOf("../")&&globalThis.URL&&globalThis.document&&globalThis.document.baseURI&&(e=new URL(e,globalThis.document.baseURI).toString()),e}const U=/^[a-zA-Z][a-zA-Z\d+\-.]*?:\/\//,P=/[a-zA-Z]:[\\/]/;function M(e){return Se||Ie?e.startsWith("/")||e.startsWith("\\")||-1!==e.indexOf("///")||P.test(e):U.test(e)}let L,N=0;const $=[],z=[],W=new Map,F={"js-module-threads":!0,"js-module-runtime":!0,"js-module-dotnet":!0,"js-module-native":!0,"js-module-diagnostics":!0},B={...F,"js-module-library-initializer":!0},V={...F,dotnetwasm:!0,heap:!0,manifest:!0},q={...B,manifest:!0},H={...B,dotnetwasm:!0},J={dotnetwasm:!0,symbols:!0},Z={...B,dotnetwasm:!0,symbols:!0},Q={symbols:!0};function G(e){return!("icu"==e.behavior&&e.name!=Pe.preferredIcuAsset)}function K(e,t,o){null!=t||(t=[]),Be(1==t.length,`Expect to have one ${o} asset in resources`);const n=t[0];return n.behavior=o,X(n),e.push(n),n}function X(e){V[e.behavior]&&W.set(e.behavior,e)}function Y(e){Be(V[e],`Unknown single asset behavior ${e}`);const t=W.get(e);if(t&&!t.resolvedUrl)if(t.resolvedUrl=Pe.locateFile(t.name),F[t.behavior]){const e=ge(t);e?("string"!=typeof e&&Be(!1,"loadBootResource response for 'dotnetjs' type should be a URL string"),t.resolvedUrl=e):t.resolvedUrl=ce(t.resolvedUrl,t.behavior)}else if("dotnetwasm"!==t.behavior)throw new Error(`Unknown single asset behavior ${e}`);return t}function ee(e){const t=Y(e);return Be(t,`Single asset for ${e} not found`),t}let te=!1;async function oe(){if(!te){te=!0,Pe.diagnosticTracing&&b("mono_download_assets");try{const e=[],t=[],o=(e,t)=>{!Z[e.behavior]&&G(e)&&Pe.expected_instantiated_assets_count++,!H[e.behavior]&&G(e)&&(Pe.expected_downloaded_assets_count++,t.push(se(e)))};for(const t of $)o(t,e);for(const e of z)o(e,t);Pe.allDownloadsQueued.promise_control.resolve(),Promise.all([...e,...t]).then((()=>{Pe.allDownloadsFinished.promise_control.resolve()})).catch((e=>{throw Pe.err("Error in mono_download_assets: "+e),Xe(1,e),e})),await Pe.runtimeModuleLoaded.promise;const n=async e=>{const t=await e;if(t.buffer){if(!Z[t.behavior]){t.buffer&&"object"==typeof t.buffer||Be(!1,"asset buffer must be array-like or buffer-like or promise of these"),"string"!=typeof t.resolvedUrl&&Be(!1,"resolvedUrl must be string");const e=t.resolvedUrl,o=await t.buffer,n=new Uint8Array(o);pe(t),await Ue.beforeOnRuntimeInitialized.promise,Ue.instantiate_asset(t,e,n)}}else J[t.behavior]?("symbols"===t.behavior&&(await Ue.instantiate_symbols_asset(t),pe(t)),J[t.behavior]&&++Pe.actual_downloaded_assets_count):(t.isOptional||Be(!1,"Expected asset to have the downloaded buffer"),!H[t.behavior]&&G(t)&&Pe.expected_downloaded_assets_count--,!Z[t.behavior]&&G(t)&&Pe.expected_instantiated_assets_count--)},r=[],i=[];for(const t of e)r.push(n(t));for(const e of t)i.push(n(e));Promise.all(r).then((()=>{Ce||Ue.coreAssetsInMemory.promise_control.resolve()})).catch((e=>{throw Pe.err("Error in mono_download_assets: "+e),Xe(1,e),e})),Promise.all(i).then((async()=>{Ce||(await Ue.coreAssetsInMemory.promise,Ue.allAssetsInMemory.promise_control.resolve())})).catch((e=>{throw Pe.err("Error in mono_download_assets: "+e),Xe(1,e),e}))}catch(e){throw Pe.err("Error in mono_download_assets: "+e),e}}}let ne=!1;function re(){if(ne)return;ne=!0;const e=Pe.config,t=[];if(e.assets)for(const t of e.assets)"object"!=typeof t&&Be(!1,`asset must be object, it was ${typeof t} : ${t}`),"string"!=typeof t.behavior&&Be(!1,"asset behavior must be known string"),"string"!=typeof t.name&&Be(!1,"asset name must be string"),t.resolvedUrl&&"string"!=typeof t.resolvedUrl&&Be(!1,"asset resolvedUrl could be string"),t.hash&&"string"!=typeof t.hash&&Be(!1,"asset resolvedUrl could be string"),t.pendingDownload&&"object"!=typeof t.pendingDownload&&Be(!1,"asset pendingDownload could be object"),t.isCore?$.push(t):z.push(t),X(t);else if(e.resources){const o=e.resources;o.wasmNative||Be(!1,"resources.wasmNative must be defined"),o.jsModuleNative||Be(!1,"resources.jsModuleNative must be defined"),o.jsModuleRuntime||Be(!1,"resources.jsModuleRuntime must be defined"),K(z,o.wasmNative,"dotnetwasm"),K(t,o.jsModuleNative,"js-module-native"),K(t,o.jsModuleRuntime,"js-module-runtime"),o.jsModuleDiagnostics&&K(t,o.jsModuleDiagnostics,"js-module-diagnostics");const n=(e,t,o)=>{const n=e;n.behavior=t,o?(n.isCore=!0,$.push(n)):z.push(n)};if(o.coreAssembly)for(let e=0;e<o.coreAssembly.length;e++)n(o.coreAssembly[e],"assembly",!0);if(o.assembly)for(let e=0;e<o.assembly.length;e++)n(o.assembly[e],"assembly",!o.coreAssembly);if(0!=e.debugLevel&&Pe.isDebuggingSupported()){if(o.corePdb)for(let e=0;e<o.corePdb.length;e++)n(o.corePdb[e],"pdb",!0);if(o.pdb)for(let e=0;e<o.pdb.length;e++)n(o.pdb[e],"pdb",!o.corePdb)}if(e.loadAllSatelliteResources&&o.satelliteResources)for(const e in o.satelliteResources)for(let t=0;t<o.satelliteResources[e].length;t++){const r=o.satelliteResources[e][t];r.culture=e,n(r,"resource",!o.coreAssembly)}if(o.coreVfs)for(let e=0;e<o.coreVfs.length;e++)n(o.coreVfs[e],"vfs",!0);if(o.vfs)for(let e=0;e<o.vfs.length;e++)n(o.vfs[e],"vfs",!o.coreVfs);const r=O(e);if(r&&o.icu)for(let e=0;e<o.icu.length;e++){const t=o.icu[e];t.name===r&&n(t,"icu",!1)}if(o.wasmSymbols)for(let e=0;e<o.wasmSymbols.length;e++)n(o.wasmSymbols[e],"symbols",!1)}if(e.appsettings)for(let t=0;t<e.appsettings.length;t++){const o=e.appsettings[t],n=he(o);"appsettings.json"!==n&&n!==`appsettings.${e.applicationEnvironment}.json`||z.push({name:o,behavior:"vfs",cache:"no-cache",useCredentials:!0})}e.assets=[...$,...z,...t]}async function ie(e){const t=await se(e);return await t.pendingDownloadInternal.response,t.buffer}async function se(e){try{return await ae(e)}catch(t){if(!Pe.enableDownloadRetry)throw t;if(Ie||Se)throw t;if(e.pendingDownload&&e.pendingDownloadInternal==e.pendingDownload)throw t;if(e.resolvedUrl&&-1!=e.resolvedUrl.indexOf("file://"))throw t;if(t&&404==t.status)throw t;e.pendingDownloadInternal=void 0,await Pe.allDownloadsQueued.promise;try{return Pe.diagnosticTracing&&b(`Retrying download '${e.name}'`),await ae(e)}catch(t){return e.pendingDownloadInternal=void 0,await new Promise((e=>globalThis.setTimeout(e,100))),Pe.diagnosticTracing&&b(`Retrying download (2) '${e.name}' after delay`),await ae(e)}}}async function ae(e){for(;L;)await L.promise;try{++N,N==Pe.maxParallelDownloads&&(Pe.diagnosticTracing&&b("Throttling further parallel downloads"),L=i());const t=await async function(e){if(e.pendingDownload&&(e.pendingDownloadInternal=e.pendingDownload),e.pendingDownloadInternal&&e.pendingDownloadInternal.response)return e.pendingDownloadInternal.response;if(e.buffer){const t=await e.buffer;return e.resolvedUrl||(e.resolvedUrl="undefined://"+e.name),e.pendingDownloadInternal={url:e.resolvedUrl,name:e.name,response:Promise.resolve({ok:!0,arrayBuffer:()=>t,json:()=>JSON.parse(new TextDecoder("utf-8").decode(t)),text:()=>{throw new Error("NotImplementedException")},headers:{get:()=>{}}})},e.pendingDownloadInternal.response}const t=e.loadRemote&&Pe.config.remoteSources?Pe.config.remoteSources:[""];let o;for(let n of t){n=n.trim(),"./"===n&&(n="");const t=le(e,n);e.name===t?Pe.diagnosticTracing&&b(`Attempting to download '${t}'`):Pe.diagnosticTracing&&b(`Attempting to download '${t}' for ${e.name}`);try{e.resolvedUrl=t;const n=fe(e);if(e.pendingDownloadInternal=n,o=await n.response,!o||!o.ok)continue;return o}catch(e){o||(o={ok:!1,url:t,status:0,statusText:""+e});continue}}const n=e.isOptional||e.name.match(/\.pdb$/)&&Pe.config.ignorePdbLoadErrors;if(o||Be(!1,`Response undefined ${e.name}`),!n){const t=new Error(`download '${o.url}' for ${e.name} failed ${o.status} ${o.statusText}`);throw t.status=o.status,t}y(`optional download '${o.url}' for ${e.name} failed ${o.status} ${o.statusText}`)}(e);return t?(J[e.behavior]||(e.buffer=await t.arrayBuffer(),++Pe.actual_downloaded_assets_count),e):e}finally{if(--N,L&&N==Pe.maxParallelDownloads-1){Pe.diagnosticTracing&&b("Resuming more parallel downloads");const e=L;L=void 0,e.promise_control.resolve()}}}function le(e,t){let o;return null==t&&Be(!1,`sourcePrefix must be provided for ${e.name}`),e.resolvedUrl?o=e.resolvedUrl:(o=""===t?"assembly"===e.behavior||"pdb"===e.behavior?e.name:"resource"===e.behavior&&e.culture&&""!==e.culture?`${e.culture}/${e.name}`:e.name:t+e.name,o=ce(Pe.locateFile(o),e.behavior)),o&&"string"==typeof o||Be(!1,"attemptUrl need to be path or url string"),o}function ce(e,t){return Pe.modulesUniqueQuery&&q[t]&&(e+=Pe.modulesUniqueQuery),e}let de=0;const ue=new Set;function fe(e){try{e.resolvedUrl||Be(!1,"Request's resolvedUrl must be set");const t=function(e){let t=e.resolvedUrl;if(Pe.loadBootResource){const o=ge(e);if(o instanceof Promise)return o;"string"==typeof o&&(t=o)}const o={};return e.cache?o.cache=e.cache:Pe.config.disableNoCacheFetch||(o.cache="no-cache"),e.useCredentials?o.credentials="include":!Pe.config.disableIntegrityCheck&&e.hash&&(o.integrity=e.hash),Pe.fetch_like(t,o)}(e),o={name:e.name,url:e.resolvedUrl,response:t};return ue.add(e.name),o.response.then((()=>{"assembly"==e.behavior&&Pe.loadedAssemblies.push(e.name),de++,Pe.onDownloadResourceProgress&&Pe.onDownloadResourceProgress(de,ue.size)})),o}catch(t){const o={ok:!1,url:e.resolvedUrl,status:500,statusText:"ERR29: "+t,arrayBuffer:()=>{throw t},json:()=>{throw t}};return{name:e.name,url:e.resolvedUrl,response:Promise.resolve(o)}}}const me={resource:"assembly",assembly:"assembly",pdb:"pdb",icu:"globalization",vfs:"configuration",manifest:"manifest",dotnetwasm:"dotnetwasm","js-module-dotnet":"dotnetjs","js-module-native":"dotnetjs","js-module-runtime":"dotnetjs","js-module-threads":"dotnetjs"};function ge(e){var t;if(Pe.loadBootResource){const o=null!==(t=e.hash)&&void 0!==t?t:"",n=e.resolvedUrl,r=me[e.behavior];if(r){const t=Pe.loadBootResource(r,e.name,n,o,e.behavior);return"string"==typeof t?I(t):t}}}function pe(e){e.pendingDownloadInternal=null,e.pendingDownload=null,e.buffer=null,e.moduleExports=null}function he(e){let t=e.lastIndexOf("/");return t>=0&&t++,e.substring(t)}async function we(e){e&&await Promise.all((null!=e?e:[]).map((e=>async function(e){try{const t=e.name;if(!e.moduleExports){const o=ce(Pe.locateFile(t),"js-module-library-initializer");Pe.diagnosticTracing&&b(`Attempting to import '${o}' for ${e}`),e.moduleExports=await import(/*! webpackIgnore: true */o)}Pe.libraryInitializers.push({scriptName:t,exports:e.moduleExports})}catch(t){E(`Failed to import library initializer '${e}': ${t}`)}}(e))))}async function be(e,t){if(!Pe.libraryInitializers)return;const o=[];for(let n=0;n<Pe.libraryInitializers.length;n++){const r=Pe.libraryInitializers[n];r.exports[e]&&o.push(ye(r.scriptName,e,(()=>r.exports[e](...t))))}await Promise.all(o)}async function ye(e,t,o){try{await o()}catch(o){throw E(`Failed to invoke '${t}' on library initializer '${e}': ${o}`),Xe(1,o),o}}function ve(e,t){if(e===t)return e;const o={...t};return void 0!==o.assets&&o.assets!==e.assets&&(o.assets=[...e.assets||[],...o.assets||[]]),void 0!==o.resources&&(o.resources=_e(e.resources||{assembly:[],jsModuleNative:[],jsModuleRuntime:[],wasmNative:[]},o.resources)),void 0!==o.environmentVariables&&(o.environmentVariables={...e.environmentVariables||{},...o.environmentVariables||{}}),void 0!==o.runtimeOptions&&o.runtimeOptions!==e.runtimeOptions&&(o.runtimeOptions=[...e.runtimeOptions||[],...o.runtimeOptions||[]]),Object.assign(e,o)}function Ee(e,t){if(e===t)return e;const o={...t};return o.config&&(e.config||(e.config={}),o.config=ve(e.config,o.config)),Object.assign(e,o)}function _e(e,t){if(e===t)return e;const o={...t};return void 0!==o.coreAssembly&&(o.coreAssembly=[...e.coreAssembly||[],...o.coreAssembly||[]]),void 0!==o.assembly&&(o.assembly=[...e.assembly||[],...o.assembly||[]]),void 0!==o.lazyAssembly&&(o.lazyAssembly=[...e.lazyAssembly||[],...o.lazyAssembly||[]]),void 0!==o.corePdb&&(o.corePdb=[...e.corePdb||[],...o.corePdb||[]]),void 0!==o.pdb&&(o.pdb=[...e.pdb||[],...o.pdb||[]]),void 0!==o.jsModuleWorker&&(o.jsModuleWorker=[...e.jsModuleWorker||[],...o.jsModuleWorker||[]]),void 0!==o.jsModuleNative&&(o.jsModuleNative=[...e.jsModuleNative||[],...o.jsModuleNative||[]]),void 0!==o.jsModuleDiagnostics&&(o.jsModuleDiagnostics=[...e.jsModuleDiagnostics||[],...o.jsModuleDiagnostics||[]]),void 0!==o.jsModuleRuntime&&(o.jsModuleRuntime=[...e.jsModuleRuntime||[],...o.jsModuleRuntime||[]]),void 0!==o.wasmSymbols&&(o.wasmSymbols=[...e.wasmSymbols||[],...o.wasmSymbols||[]]),void 0!==o.wasmNative&&(o.wasmNative=[...e.wasmNative||[],...o.wasmNative||[]]),void 0!==o.icu&&(o.icu=[...e.icu||[],...o.icu||[]]),void 0!==o.satelliteResources&&(o.satelliteResources=function(e,t){if(e===t)return e;for(const o in t)e[o]=[...e[o]||[],...t[o]||[]];return e}(e.satelliteResources||{},o.satelliteResources||{})),void 0!==o.modulesAfterConfigLoaded&&(o.modulesAfterConfigLoaded=[...e.modulesAfterConfigLoaded||[],...o.modulesAfterConfigLoaded||[]]),void 0!==o.modulesAfterRuntimeReady&&(o.modulesAfterRuntimeReady=[...e.modulesAfterRuntimeReady||[],...o.modulesAfterRuntimeReady||[]]),void 0!==o.extensions&&(o.extensions={...e.extensions||{},...o.extensions||{}}),void 0!==o.vfs&&(o.vfs=[...e.vfs||[],...o.vfs||[]]),Object.assign(e,o)}function xe(){const e=Pe.config;if(e.environmentVariables=e.environmentVariables||{},e.runtimeOptions=e.runtimeOptions||[],e.resources=e.resources||{assembly:[],jsModuleNative:[],jsModuleWorker:[],jsModuleRuntime:[],wasmNative:[],vfs:[],satelliteResources:{}},e.assets){Pe.diagnosticTracing&&b("config.assets is deprecated, use config.resources instead");for(const t of e.assets){const o={};switch(t.behavior){case"assembly":o.assembly=[t];break;case"pdb":o.pdb=[t];break;case"resource":o.satelliteResources={},o.satelliteResources[t.culture]=[t];break;case"icu":o.icu=[t];break;case"symbols":o.wasmSymbols=[t];break;case"vfs":o.vfs=[t];break;case"dotnetwasm":o.wasmNative=[t];break;case"js-module-threads":o.jsModuleWorker=[t];break;case"js-module-runtime":o.jsModuleRuntime=[t];break;case"js-module-native":o.jsModuleNative=[t];break;case"js-module-diagnostics":o.jsModuleDiagnostics=[t];break;case"js-module-dotnet":break;default:throw new Error(`Unexpected behavior ${t.behavior} of asset ${t.name}`)}_e(e.resources,o)}}e.debugLevel,e.applicationEnvironment||(e.applicationEnvironment="Production"),e.applicationCulture&&(e.environmentVariables.LANG=`${e.applicationCulture}.UTF-8`),Ue.diagnosticTracing=Pe.diagnosticTracing=!!e.diagnosticTracing,Ue.waitForDebugger=e.waitForDebugger,Pe.maxParallelDownloads=e.maxParallelDownloads||Pe.maxParallelDownloads,Pe.enableDownloadRetry=void 0!==e.enableDownloadRetry?e.enableDownloadRetry:Pe.enableDownloadRetry}let je=!1;async function Re(e){var t;if(je)return void await Pe.afterConfigLoaded.promise;let o;try{if(e.configSrc||Pe.config&&0!==Object.keys(Pe.config).length&&(Pe.config.assets||Pe.config.resources)||(e.configSrc="dotnet.boot.js"),o=e.configSrc,je=!0,o&&(Pe.diagnosticTracing&&b("mono_wasm_load_config"),await async function(e){const t=e.configSrc,o=Pe.locateFile(t);let n=null;void 0!==Pe.loadBootResource&&(n=Pe.loadBootResource("manifest",t,o,"","manifest"));let r,i=null;if(n)if("string"==typeof n)n.includes(".json")?(i=await s(I(n)),r=await Ae(i)):r=(await import(I(n))).config;else{const e=await n;"function"==typeof e.json?(i=e,r=await Ae(i)):r=e.config}else o.includes(".json")?(i=await s(ce(o,"manifest")),r=await Ae(i)):r=(await import(ce(o,"manifest"))).config;function s(e){return Pe.fetch_like(e,{method:"GET",credentials:"include",cache:"no-cache"})}Pe.config.applicationEnvironment&&(r.applicationEnvironment=Pe.config.applicationEnvironment),ve(Pe.config,r)}(e)),xe(),await we(null===(t=Pe.config.resources)||void 0===t?void 0:t.modulesAfterConfigLoaded),await be("onRuntimeConfigLoaded",[Pe.config]),e.onConfigLoaded)try{await e.onConfigLoaded(Pe.config,Le),xe()}catch(e){throw _("onConfigLoaded() failed",e),e}xe(),Pe.afterConfigLoaded.promise_control.resolve(Pe.config)}catch(t){const n=`Failed to load config file ${o} ${t} ${null==t?void 0:t.stack}`;throw Pe.config=e.config=Object.assign(Pe.config,{message:n,error:t,isError:!0}),Xe(1,new Error(n)),t}}function Te(){return!!globalThis.navigator&&(Pe.isChromium||Pe.isFirefox)}async function Ae(e){const t=Pe.config,o=await e.json();t.applicationEnvironment||o.applicationEnvironment||(o.applicationEnvironment=e.headers.get("Blazor-Environment")||e.headers.get("DotNet-Environment")||void 0),o.environmentVariables||(o.environmentVariables={});const n=e.headers.get("DOTNET-MODIFIABLE-ASSEMBLIES");n&&(o.environmentVariables.DOTNET_MODIFIABLE_ASSEMBLIES=n);const r=e.headers.get("ASPNETCORE-BROWSER-TOOLS");return r&&(o.environmentVariables.__ASPNETCORE_BROWSER_TOOLS=r),o}"function"!=typeof importScripts||globalThis.onmessage||(globalThis.dotnetSidecar=!0);const Se="object"==typeof process&&"object"==typeof process.versions&&"string"==typeof process.versions.node,De="function"==typeof importScripts,Oe=De&&"undefined"!=typeof dotnetSidecar,Ce=De&&!Oe,ke="object"==typeof window||De&&!Se,Ie=!ke&&!Se;let Ue={},Pe={},Me={},Le={},Ne={},$e=!1;const ze={},We={config:ze},Fe={mono:{},binding:{},internal:Ne,module:We,loaderHelpers:Pe,runtimeHelpers:Ue,diagnosticHelpers:Me,api:Le};function Be(e,t){if(e)return;const o="Assert failed: "+("function"==typeof t?t():t),n=new Error(o);_(o,n),Ue.nativeAbort(n)}function Ve(){return void 0!==Pe.exitCode}function qe(){return Ue.runtimeReady&&!Ve()}function He(){Ve()&&Be(!1,`.NET runtime already exited with ${Pe.exitCode} ${Pe.exitReason}. You can use runtime.runMain() which doesn't exit the runtime.`),Ue.runtimeReady||Be(!1,".NET runtime didn't start yet. Please call dotnet.create() first.")}function Je(){ke&&(globalThis.addEventListener("unhandledrejection",et),globalThis.addEventListener("error",tt))}let Ze,Qe;function Ge(e){Qe&&Qe(e),Xe(e,Pe.exitReason)}function Ke(e){Ze&&Ze(e||Pe.exitReason),Xe(1,e||Pe.exitReason)}function Xe(t,o){var n,r;const i=o&&"object"==typeof o;t=i&&"number"==typeof o.status?o.status:void 0===t?-1:t;const s=i&&"string"==typeof o.message?o.message:""+o;(o=i?o:Ue.ExitStatus?function(e,t){const o=new Ue.ExitStatus(e);return o.message=t,o.toString=()=>t,o}(t,s):new Error("Exit with code "+t+" "+s)).status=t,o.message||(o.message=s);const a=""+(o.stack||(new Error).stack);try{Object.defineProperty(o,"stack",{get:()=>a})}catch(e){}const l=!!o.silent;if(o.silent=!0,Ve())Pe.diagnosticTracing&&b("mono_exit called after exit");else{try{We.onAbort==Ke&&(We.onAbort=Ze),We.onExit==Ge&&(We.onExit=Qe),ke&&(globalThis.removeEventListener("unhandledrejection",et),globalThis.removeEventListener("error",tt)),Ue.runtimeReady?(Ue.jiterpreter_dump_stats&&Ue.jiterpreter_dump_stats(!1),0===t&&(null===(n=Pe.config)||void 0===n?void 0:n.interopCleanupOnExit)&&Ue.forceDisposeProxies(!0,!0),e&&0!==t&&(null===(r=Pe.config)||void 0===r||r.dumpThreadsOnNonZeroExit)):(Pe.diagnosticTracing&&b(`abort_startup, reason: ${o}`),function(e){Pe.allDownloadsQueued.promise_control.reject(e),Pe.allDownloadsFinished.promise_control.reject(e),Pe.afterConfigLoaded.promise_control.reject(e),Pe.wasmCompilePromise.promise_control.reject(e),Pe.runtimeModuleLoaded.promise_control.reject(e),Ue.dotnetReady&&(Ue.dotnetReady.promise_control.reject(e),Ue.afterInstantiateWasm.promise_control.reject(e),Ue.beforePreInit.promise_control.reject(e),Ue.afterPreInit.promise_control.reject(e),Ue.afterPreRun.promise_control.reject(e),Ue.beforeOnRuntimeInitialized.promise_control.reject(e),Ue.afterOnRuntimeInitialized.promise_control.reject(e),Ue.afterPostRun.promise_control.reject(e))}(o))}catch(e){E("mono_exit A failed",e)}try{l||(function(e,t){if(0!==e&&t){const e=Ue.ExitStatus&&t instanceof Ue.ExitStatus?b:_;"string"==typeof t?e(t):(void 0===t.stack&&(t.stack=(new Error).stack+""),t.message?e(Ue.stringify_as_error_with_stack?Ue.stringify_as_error_with_stack(t.message+"\n"+t.stack):t.message+"\n"+t.stack):e(JSON.stringify(t)))}!Ce&&Pe.config&&(Pe.config.logExitCode?Pe.config.forwardConsoleLogsToWS?R("WASM EXIT "+e):v("WASM EXIT "+e):Pe.config.forwardConsoleLogsToWS&&R())}(t,o),function(e){if(ke&&!Ce&&Pe.config&&Pe.config.appendElementOnExit&&document){const t=document.createElement("label");t.id="tests_done",0!==e&&(t.style.background="red"),t.innerHTML=""+e,document.body.appendChild(t)}}(t))}catch(e){E("mono_exit B failed",e)}Pe.exitCode=t,Pe.exitReason||(Pe.exitReason=o),!Ce&&Ue.runtimeReady&&We.runtimeKeepalivePop()}if(Pe.config&&Pe.config.asyncFlushOnExit&&0===t)throw(async()=>{try{await async function(){try{const e=await import(/*! webpackIgnore: true */"process"),t=e=>new Promise(((t,o)=>{e.on("error",o),e.end("","utf8",t)})),o=t(e.stderr),n=t(e.stdout);let r;const i=new Promise((e=>{r=setTimeout((()=>e("timeout")),1e3)}));await Promise.race([Promise.all([n,o]),i]),clearTimeout(r)}catch(e){_(`flushing std* streams failed: ${e}`)}}()}finally{Ye(t,o)}})(),o;Ye(t,o)}function Ye(e,t){if(Ue.runtimeReady&&Ue.nativeExit)try{Ue.nativeExit(e)}catch(e){!Ue.ExitStatus||e instanceof Ue.ExitStatus||E("set_exit_code_and_quit_now failed: "+e.toString())}if(0!==e||!ke)throw Se&&Ne.process?Ne.process.exit(e):Ue.quit&&Ue.quit(e,t),t}function et(e){ot(e,e.reason,"rejection")}function tt(e){ot(e,e.error,"error")}function ot(e,t,o){e.preventDefault();try{t||(t=new Error("Unhandled "+o)),void 0===t.stack&&(t.stack=(new Error).stack),t.stack=t.stack+"",t.silent||(_("Unhandled error:",t),Xe(1,t))}catch(e){}}!function(e){if($e)throw new Error("Loader module already loaded");$e=!0,Ue=e.runtimeHelpers,Pe=e.loaderHelpers,Me=e.diagnosticHelpers,Le=e.api,Ne=e.internal,Object.assign(Le,{INTERNAL:Ne,invokeLibraryInitializers:be}),Object.assign(e.module,{config:ve(ze,{environmentVariables:{}})});const r={mono_wasm_bindings_is_ready:!1,config:e.module.config,diagnosticTracing:!1,nativeAbort:e=>{throw e||new Error("abort")},nativeExit:e=>{throw new Error("exit:"+e)}},l={gitHash:"95017c711e6afc1085133d440e42b4bd78155701",config:e.module.config,diagnosticTracing:!1,maxParallelDownloads:16,enableDownloadRetry:!0,_loaded_files:[],loadedFiles:[],loadedAssemblies:[],libraryInitializers:[],workerNextNumber:1,actual_downloaded_assets_count:0,actual_instantiated_assets_count:0,expected_downloaded_assets_count:0,expected_instantiated_assets_count:0,afterConfigLoaded:i(),allDownloadsQueued:i(),allDownloadsFinished:i(),wasmCompilePromise:i(),runtimeModuleLoaded:i(),loadingWorkers:i(),is_exited:Ve,is_runtime_running:qe,assert_runtime_running:He,mono_exit:Xe,createPromiseController:i,getPromiseController:s,assertIsControllablePromise:a,mono_download_assets:oe,resolve_single_asset_path:ee,setup_proxy_console:j,set_thread_prefix:w,installUnhandledErrorHandler:Je,retrieve_asset_download:ie,invokeLibraryInitializers:be,isDebuggingSupported:Te,exceptions:t,simd:n,relaxedSimd:o};Object.assign(Ue,r),Object.assign(Pe,l)}(Fe);let nt,rt,it,st=!1,at=!1;async function lt(e){if(!at){if(at=!0,ke&&Pe.config.forwardConsoleLogsToWS&&void 0!==globalThis.WebSocket&&j("main",globalThis.console,globalThis.location.origin),We||Be(!1,"Null moduleConfig"),Pe.config||Be(!1,"Null moduleConfig.config"),"function"==typeof e){const t=e(Fe.api);if(t.ready)throw new Error("Module.ready couldn't be redefined.");Object.assign(We,t),Ee(We,t)}else{if("object"!=typeof e)throw new Error("Can't use moduleFactory callback of createDotnetRuntime function.");Ee(We,e)}await async function(e){if(Se){const e=await import(/*! webpackIgnore: true */"process"),t=14;if(e.versions.node.split(".")[0]<t)throw new Error(`NodeJS at '${e.execPath}' has too low version '${e.versions.node}', please use at least ${t}. See also https://aka.ms/dotnet-wasm-features`)}const t=/*! webpackIgnore: true */import.meta.url,o=t.indexOf("?");var n;if(o>0&&(Pe.modulesUniqueQuery=t.substring(o)),Pe.scriptUrl=t.replace(/\\/g,"/").replace(/[?#].*/,""),Pe.scriptDirectory=(n=Pe.scriptUrl).slice(0,n.lastIndexOf("/"))+"/",Pe.locateFile=e=>"URL"in globalThis&&globalThis.URL!==C?new URL(e,Pe.scriptDirectory).toString():M(e)?e:Pe.scriptDirectory+e,Pe.fetch_like=k,Pe.out=console.log,Pe.err=console.error,Pe.onDownloadResourceProgress=e.onDownloadResourceProgress,ke&&globalThis.navigator){const e=globalThis.navigator,t=e.userAgentData&&e.userAgentData.brands;t&&t.length>0?Pe.isChromium=t.some((e=>"Google Chrome"===e.brand||"Microsoft Edge"===e.brand||"Chromium"===e.brand)):e.userAgent&&(Pe.isChromium=e.userAgent.includes("Chrome"),Pe.isFirefox=e.userAgent.includes("Firefox"))}Ne.require=Se?await import(/*! webpackIgnore: true */"module").then((e=>e.createRequire(/*! webpackIgnore: true */import.meta.url))):Promise.resolve((()=>{throw new Error("require not supported")})),void 0===globalThis.URL&&(globalThis.URL=C)}(We)}}async function ct(e){return await lt(e),Ze=We.onAbort,Qe=We.onExit,We.onAbort=Ke,We.onExit=Ge,We.ENVIRONMENT_IS_PTHREAD?async function(){(function(){const e=new MessageChannel,t=e.port1,o=e.port2;t.addEventListener("message",(e=>{var n,r;n=JSON.parse(e.data.config),r=JSON.parse(e.data.monoThreadInfo),st?Pe.diagnosticTracing&&b("mono config already received"):(ve(Pe.config,n),Ue.monoThreadInfo=r,xe(),Pe.diagnosticTracing&&b("mono config received"),st=!0,Pe.afterConfigLoaded.promise_control.resolve(Pe.config),ke&&n.forwardConsoleLogsToWS&&void 0!==globalThis.WebSocket&&Pe.setup_proxy_console("worker-idle",console,globalThis.location.origin)),t.close(),o.close()}),{once:!0}),t.start(),self.postMessage({[l]:{monoCmd:"preload",port:o}},[o])})(),await Pe.afterConfigLoaded.promise,function(){const e=Pe.config;e.assets||Be(!1,"config.assets must be defined");for(const t of e.assets)X(t),Q[t.behavior]&&z.push(t)}(),setTimeout((async()=>{try{await oe()}catch(e){Xe(1,e)}}),0);const e=dt(),t=await Promise.all(e);return await ut(t),We}():async function(){var e;await Re(We),re();const t=dt();(async function(){try{const e=ee("dotnetwasm");await se(e),e&&e.pendingDownloadInternal&&e.pendingDownloadInternal.response||Be(!1,"Can't load dotnet.native.wasm");const t=await e.pendingDownloadInternal.response,o=t.headers&&t.headers.get?t.headers.get("Content-Type"):void 0;let n;if("function"==typeof WebAssembly.compileStreaming&&"application/wasm"===o)n=await WebAssembly.compileStreaming(t);else{ke&&"application/wasm"!==o&&E('WebAssembly resource does not have the expected content type "application/wasm", so falling back to slower ArrayBuffer instantiation.');const e=await t.arrayBuffer();Pe.diagnosticTracing&&b("instantiate_wasm_module buffered"),n=Ie?await Promise.resolve(new WebAssembly.Module(e)):await WebAssembly.compile(e)}e.pendingDownloadInternal=null,e.pendingDownload=null,e.buffer=null,e.moduleExports=null,Pe.wasmCompilePromise.promise_control.resolve(n)}catch(e){Pe.wasmCompilePromise.promise_control.reject(e)}})(),setTimeout((async()=>{try{D(),await oe()}catch(e){Xe(1,e)}}),0);const o=await Promise.all(t);return await ut(o),await Ue.dotnetReady.promise,await we(null===(e=Pe.config.resources)||void 0===e?void 0:e.modulesAfterRuntimeReady),await be("onRuntimeReady",[Fe.api]),Le}()}function dt(){const e=ee("js-module-runtime"),t=ee("js-module-native");if(nt&&rt)return[nt,rt,it];"object"==typeof e.moduleExports?nt=e.moduleExports:(Pe.diagnosticTracing&&b(`Attempting to import '${e.resolvedUrl}' for ${e.name}`),nt=import(/*! webpackIgnore: true */e.resolvedUrl)),"object"==typeof t.moduleExports?rt=t.moduleExports:(Pe.diagnosticTracing&&b(`Attempting to import '${t.resolvedUrl}' for ${t.name}`),rt=import(/*! webpackIgnore: true */t.resolvedUrl));const o=Y("js-module-diagnostics");return o&&("object"==typeof o.moduleExports?it=o.moduleExports:(Pe.diagnosticTracing&&b(`Attempting to import '${o.resolvedUrl}' for ${o.name}`),it=import(/*! webpackIgnore: true */o.resolvedUrl))),[nt,rt,it]}async function ut(e){const{initializeExports:t,initializeReplacements:o,configureRuntimeStartup:n,configureEmscriptenStartup:r,configureWorkerStartup:i,setRuntimeGlobals:s,passEmscriptenInternals:a}=e[0],{default:l}=e[1],c=e[2];s(Fe),t(Fe),c&&c.setRuntimeGlobals(Fe),await n(We),Pe.runtimeModuleLoaded.promise_control.resolve(),l((e=>(Object.assign(We,{ready:e.ready,__dotnet_runtime:{initializeReplacements:o,configureEmscriptenStartup:r,configureWorkerStartup:i,passEmscriptenInternals:a}}),We))).catch((e=>{if(e.message&&e.message.toLowerCase().includes("out of memory"))throw new Error(".NET runtime has failed to start, because too much memory was requested. Please decrease the memory by adjusting EmccMaximumHeapSize. See also https://aka.ms/dotnet-wasm-features");throw e}))}const ft=new class{withModuleConfig(e){try{return Ee(We,e),this}catch(e){throw Xe(1,e),e}}withOnConfigLoaded(e){try{return Ee(We,{onConfigLoaded:e}),this}catch(e){throw Xe(1,e),e}}withConsoleForwarding(){try{return ve(ze,{forwardConsoleLogsToWS:!0}),this}catch(e){throw Xe(1,e),e}}withExitOnUnhandledError(){try{return ve(ze,{exitOnUnhandledError:!0}),Je(),this}catch(e){throw Xe(1,e),e}}withAsyncFlushOnExit(){try{return ve(ze,{asyncFlushOnExit:!0}),this}catch(e){throw Xe(1,e),e}}withExitCodeLogging(){try{return ve(ze,{logExitCode:!0}),this}catch(e){throw Xe(1,e),e}}withElementOnExit(){try{return ve(ze,{appendElementOnExit:!0}),this}catch(e){throw Xe(1,e),e}}withInteropCleanupOnExit(){try{return ve(ze,{interopCleanupOnExit:!0}),this}catch(e){throw Xe(1,e),e}}withDumpThreadsOnNonZeroExit(){try{return ve(ze,{dumpThreadsOnNonZeroExit:!0}),this}catch(e){throw Xe(1,e),e}}withWaitingForDebugger(e){try{return ve(ze,{waitForDebugger:e}),this}catch(e){throw Xe(1,e),e}}withInterpreterPgo(e,t){try{return ve(ze,{interpreterPgo:e,interpreterPgoSaveDelay:t}),ze.runtimeOptions?ze.runtimeOptions.push("--interp-pgo-recording"):ze.runtimeOptions=["--interp-pgo-recording"],this}catch(e){throw Xe(1,e),e}}withConfig(e){try{return ve(ze,e),this}catch(e){throw Xe(1,e),e}}withConfigSrc(e){try{return e&&"string"==typeof e||Be(!1,"must be file path or URL"),Ee(We,{configSrc:e}),this}catch(e){throw Xe(1,e),e}}withVirtualWorkingDirectory(e){try{return e&&"string"==typeof e||Be(!1,"must be directory path"),ve(ze,{virtualWorkingDirectory:e}),this}catch(e){throw Xe(1,e),e}}withEnvironmentVariable(e,t){try{const o={};return o[e]=t,ve(ze,{environmentVariables:o}),this}catch(e){throw Xe(1,e),e}}withEnvironmentVariables(e){try{return e&&"object"==typeof e||Be(!1,"must be dictionary object"),ve(ze,{environmentVariables:e}),this}catch(e){throw Xe(1,e),e}}withDiagnosticTracing(e){try{return"boolean"!=typeof e&&Be(!1,"must be boolean"),ve(ze,{diagnosticTracing:e}),this}catch(e){throw Xe(1,e),e}}withDebugging(e){try{return null!=e&&"number"==typeof e||Be(!1,"must be number"),ve(ze,{debugLevel:e}),this}catch(e){throw Xe(1,e),e}}withApplicationArguments(...e){try{return e&&Array.isArray(e)||Be(!1,"must be array of strings"),ve(ze,{applicationArguments:e}),this}catch(e){throw Xe(1,e),e}}withRuntimeOptions(e){try{return e&&Array.isArray(e)||Be(!1,"must be array of strings"),ze.runtimeOptions?ze.runtimeOptions.push(...e):ze.runtimeOptions=e,this}catch(e){throw Xe(1,e),e}}withMainAssembly(e){try{return ve(ze,{mainAssemblyName:e}),this}catch(e){throw Xe(1,e),e}}withApplicationArgumentsFromQuery(){try{if(!globalThis.window)throw new Error("Missing window to the query parameters from");if(void 0===globalThis.URLSearchParams)throw new Error("URLSearchParams is supported");const e=new URLSearchParams(globalThis.window.location.search).getAll("arg");return this.withApplicationArguments(...e)}catch(e){throw Xe(1,e),e}}withApplicationEnvironment(e){try{return ve(ze,{applicationEnvironment:e}),this}catch(e){throw Xe(1,e),e}}withApplicationCulture(e){try{return ve(ze,{applicationCulture:e}),this}catch(e){throw Xe(1,e),e}}withResourceLoader(e){try{return Pe.loadBootResource=e,this}catch(e){throw Xe(1,e),e}}async download(){try{await async function(){lt(We),await Re(We),re(),D(),oe(),await Pe.allDownloadsFinished.promise}()}catch(e){throw Xe(1,e),e}}async create(){try{return this.instance||(this.instance=await async function(){return await ct(We),Fe.api}()),this.instance}catch(e){throw Xe(1,e),e}}async run(){try{return We.config||Be(!1,"Null moduleConfig.config"),this.instance||await this.create(),this.instance.runMainAndExit()}catch(e){throw Xe(1,e),e}}},mt=Xe,gt=ct;Ie||"function"==typeof globalThis.URL||Be(!1,"This browser/engine doesn't support URL API. Please use a modern version. See also https://aka.ms/dotnet-wasm-features"),"function"!=typeof globalThis.BigInt64Array&&Be(!1,"This browser/engine doesn't support BigInt64Array API. Please use a modern version. See also https://aka.ms/dotnet-wasm-features"),ft.withConfig(/*json-start*/{
   "mainAssemblyName": "PKHeX.Everywhere.Engine.Host",
   "resources": {
-    "hash": "sha256-nQx/lJGVjcLHnSc6cfpQwwdGz+tKZxKNMwyBFfj+cyA=",
+    "hash": "sha256-cxuQsV8bJZikefEqsR+mU95a7CboO0JmRgEPkj1GCsY=",
     "jsModuleNative": [
       {
         "name": "dotnet.native.b6l13xorvf.js"
@@ -45,8 +45,8 @@ var e=!1;const t=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,
     "coreAssembly": [
       {
         "virtualPath": "System.Private.CoreLib.wasm",
-        "name": "System.Private.CoreLib.xzy0ufsqkn.wasm",
-        "hash": "sha256-05SGrtBvLiKEj6wqlEsl/EkeCHBRxNNTJTncYqV7P7E=",
+        "name": "System.Private.CoreLib.37lagr3mrw.wasm",
+        "hash": "sha256-z5WSYqmzaE8zsDCoCWA4nTQ2FmjtNQ0rDRf2dnm90gU=",
         "cache": "force-cache"
       },
       {
@@ -70,51 +70,51 @@ var e=!1;const t=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,
         "cache": "force-cache"
       },
       {
-        "virtualPath": "PKHeX.Core.AutoMod.wasm",
-        "name": "PKHeX.Core.AutoMod.bcm4nagqid.wasm",
-        "hash": "sha256-5VZLV3g/w9KMo2gpo5Qv+AIEGt1soOYSvFXj/hHa7DM=",
+        "virtualPath": "PKHeX.Core.wasm",
+        "name": "PKHeX.Core.1xasc6dsc1.wasm",
+        "hash": "sha256-u6UVKrOcJRblXkyvwlWtW8aegmCigK5KIA3MmPci1dk=",
         "cache": "force-cache"
       },
       {
-        "virtualPath": "PKHeX.Core.wasm",
-        "name": "PKHeX.Core.kujhtqrpl7.wasm",
-        "hash": "sha256-RKxb4t3sT2y7mrxxyAQLQTAgDisYOBVQ8qS9B5eojJQ=",
+        "virtualPath": "PKHeX.Core.AutoMod.wasm",
+        "name": "PKHeX.Core.AutoMod.czi8ongfah.wasm",
+        "hash": "sha256-GKbGOpREIZ0MseGsn7yaqir2aXh0RMjciZ8O4+JQ3qY=",
         "cache": "force-cache"
       },
       {
-        "virtualPath": "PKHeX.Everywhere.Engine.Host.wasm",
-        "name": "PKHeX.Everywhere.Engine.Host.bed05y4alq.wasm",
-        "hash": "sha256-0/BRFEk/03AIKdBI3zEJQ+aQsXK6tS70WnqDnWRuMPc=",
+        "virtualPath": "PKHeX.Everywhere.Engine.wasm",
+        "name": "PKHeX.Everywhere.Engine.lefi2yju2h.wasm",
+        "hash": "sha256-gydG8lV4M4DmU69v4aFB7nFQj8YYyyQ7QchUJdk9ymw=",
         "cache": "force-cache"
       },
       {
-        "virtualPath": "PKHeX.Everywhere.Engine.PlugIns.wasm",
-        "name": "PKHeX.Everywhere.Engine.PlugIns.m1tlz60fri.wasm",
-        "hash": "sha256-SiHpVgPG+p40BBXGHxxX6i2ILY+yK94iRI4PKa+1Gok=",
+        "virtualPath": "PKHeX.Everywhere.Engine.Host.wasm",
+        "name": "PKHeX.Everywhere.Engine.Host.a3ej0keoiq.wasm",
+        "hash": "sha256-Fn51lv0TWcBK1u5AhdBtsQeH2J+1GMpY09n7jonMNFE=",
         "cache": "force-cache"
       },
       {
-        "virtualPath": "PKHeX.Everywhere.Engine.wasm",
-        "name": "PKHeX.Everywhere.Engine.7r5irmt54y.wasm",
-        "hash": "sha256-oxAzY8I2NcF+jYk0dscncR77nExA2oV42pt/7BQH0FM=",
+        "virtualPath": "PKHeX.Everywhere.Engine.PlugIns.wasm",
+        "name": "PKHeX.Everywhere.Engine.PlugIns.eahx1wxme6.wasm",
+        "hash": "sha256-xoa2Kqhz35EQv2ImlOpxmXEWr8g24CkK9gbvEJVVTYY=",
         "cache": "force-cache"
       },
       {
         "virtualPath": "PKHeX.Everywhere.PlugIns.wasm",
-        "name": "PKHeX.Everywhere.PlugIns.9q1s4wx4qj.wasm",
-        "hash": "sha256-wQufo6VQ1vJjsqAVA1Lp7qrBeroaoN6wc3pesE8Vpkw=",
+        "name": "PKHeX.Everywhere.PlugIns.c21drnk0yt.wasm",
+        "hash": "sha256-pD3VxH2Tz0ollYu7ZIVuTk4lPdLCe1t+rOt7DI8r3qo=",
         "cache": "force-cache"
       },
       {
         "virtualPath": "PKHeX.Everywhere.RomHacks.wasm",
-        "name": "PKHeX.Everywhere.RomHacks.5mnpo7n3f0.wasm",
-        "hash": "sha256-zQfohA2ZSnNPDHNcjS25Q9DV1DZp7wvJ8RZm+D6N8gs=",
+        "name": "PKHeX.Everywhere.RomHacks.2eiw3juwcd.wasm",
+        "hash": "sha256-5utlmnQL9U/HYZpkiZ2KMpqsfFR3VBrwYg2DXOAUXf8=",
         "cache": "force-cache"
       },
       {
         "virtualPath": "PKHeX.Facade.wasm",
-        "name": "PKHeX.Facade.6cjzr56v9a.wasm",
-        "hash": "sha256-WmRYlRYkblj4GR2p4GTN6niXKEmAXZZKL9ddTH7aE3U=",
+        "name": "PKHeX.Facade.ok6fzoms0k.wasm",
+        "hash": "sha256-CJI1xI25VeBdPuyy7v6FxnmDcgV+PjA0BXhxc+kYgMo=",
         "cache": "force-cache"
       },
       {
@@ -257,8 +257,8 @@ var e=!1;const t=async()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,
       },
       {
         "virtualPath": "System.Runtime.wasm",
-        "name": "System.Runtime.7z7c6u2xs5.wasm",
-        "hash": "sha256-ne7ps5I1PRnYDj9/s4cgJLYjxh4Lpl0M9RQUvC3fmYY=",
+        "name": "System.Runtime.vnwhlsf4yw.wasm",
+        "hash": "sha256-ZSviiOdjwtGcjTDCRR4UqHbTsLxh4OPK7KaApXQbpxs=",
         "cache": "force-cache"
       },
       {

package/dist/binary.d.ts

@@ -2,3 +2,4 @@ import type { Binary } from './generated/types';
 export declare function toBase64(data: Binary): Promise<string>;
 export declare function fileNameOf(data: Binary): string | null;
 export declare function withBytes<T>(value: T, paths: readonly string[]): T;
+export declare function withBase64<T>(value: T, paths: readonly string[]): Promise<T>;

package/dist/generated/client.d.ts

@@ -1,7 +1,7 @@
-import type { ActionPlacement, AddedPokemon, Badge, Binary, BoxEntry, CatalogNames, CatalogNamesRequest, Choice, DeclaredPage, EditablePokemon, EncounterRow, EncounterVersions, ExportedPokemon, ExportedSave, FormatEntry, GameProgress, InstalledPlugIn, ItemHandle, LoadedSave, PlugInAction, PlugInDetails, PlugInFailure, PlugInOutcome, PlugInSetting, PlugInState, PokemonHandle, PokemonId, PokemonOptions, PokemonPatch, PokemonSummary, Pouch, PublishedVersion, SaveEvents, SaveSummary, SaveVersion, SpeciesEntry, TradeOffer, TradePreview, TradeResult, TradeSummary, TrainerCard, TrainerGender, VersionEntry } from './types';
+import type { ActionPlacement, AddFromFileOptions, AddedPokemon, Badge, Binary, BoxEntry, CatalogNames, CatalogNamesRequest, Choice, DeclaredPage, EditablePokemon, EncounterRow, EncounterVersions, ExportedPokemon, ExportedSave, FilePreview, FormatEntry, GameProgress, InstalledPlugIn, ItemHandle, LoadedSave, PlugInAction, PlugInDetails, PlugInFailure, PlugInOutcome, PlugInSetting, PlugInState, PokemonHandle, PokemonId, PokemonOptions, PokemonPatch, PokemonSummary, Pouch, PublishedVersion, SaveEvents, SaveSummary, SaveVersion, SpeciesEntry, TrainerCard, TrainerGender, TransferOffer, TransferPreview, TransferResult, TransferSummary, VersionEntry } from './types';
 export type Invoke = <T>(call: CallName, args: unknown[]) => Promise<T>;
-export declare const queries: readonly ['box.get', 'box.list', 'box.showdown', 'catalog.names', 'encounters.search', 'encounters.versions', 'events.flag', 'events.get', 'game.balls', 'game.blankVersions', 'game.formats', 'game.get', 'game.heldItems', 'game.languages', 'game.moves', 'game.natures', 'game.originGames', 'game.progress', 'game.types', 'game.version', 'inventory.get', 'party.get', 'party.showdown', 'plugins.actions', 'plugins.details', 'plugins.failures', 'plugins.installed', 'plugins.isSupported', 'plugins.pageModule', 'plugins.pages', 'plugins.setting', 'plugins.state', 'pokemon.details', 'pokemon.export', 'pokemon.get', 'pokemon.options', 'pokemon.read', 'pokemon.showdown', 'species.list', 'trade.get', 'trade.partnerBoxes', 'trade.preview', 'trainer.badges', 'trainer.get'];
-export declare const commands: readonly ['box.addEncounter', 'box.addFromFile', 'events.giveTickets', 'events.setFlag', 'events.setWork', 'game.close', 'game.enableFormat', 'game.export', 'game.file', 'game.load', 'game.loadBlank', 'inventory.setItem', 'plugins.dismissFailure', 'plugins.newestCompatible', 'plugins.register', 'plugins.run', 'plugins.setEnabled', 'plugins.setHookEnabled', 'plugins.unregister', 'plugins.updateSetting', 'pokemon.addToBox', 'pokemon.clone', 'pokemon.commit', 'pokemon.edit', 'pokemon.setLevel', 'pokemon.update', 'trade.close', 'trade.commit', 'trade.open', 'trainer.setBadges', 'trainer.setBattlePoints', 'trainer.setGender', 'trainer.setMoney', 'trainer.setName'];
+export declare const queries: readonly ['box.get', 'box.list', 'box.previewFile', 'box.showdown', 'catalog.names', 'encounters.search', 'encounters.versions', 'events.flag', 'events.get', 'game.balls', 'game.blankVersions', 'game.formats', 'game.get', 'game.heldItems', 'game.languages', 'game.moves', 'game.natures', 'game.originGames', 'game.progress', 'game.types', 'game.version', 'inventory.get', 'party.get', 'party.showdown', 'plugins.actions', 'plugins.details', 'plugins.failures', 'plugins.installed', 'plugins.isSupported', 'plugins.pageModule', 'plugins.pages', 'plugins.setting', 'plugins.state', 'pokemon.details', 'pokemon.export', 'pokemon.get', 'pokemon.options', 'pokemon.read', 'pokemon.showdown', 'species.list', 'trainer.badges', 'trainer.get', 'transfer.get', 'transfer.partnerBoxes', 'transfer.preview'];
+export declare const commands: readonly ['box.addEncounter', 'box.addFromFile', 'events.giveTickets', 'events.setFlag', 'events.setWork', 'game.close', 'game.enableFormat', 'game.export', 'game.file', 'game.load', 'game.loadBlank', 'inventory.setItem', 'plugins.dismissFailure', 'plugins.newestCompatible', 'plugins.register', 'plugins.run', 'plugins.setEnabled', 'plugins.setHookEnabled', 'plugins.unregister', 'plugins.updateSetting', 'pokemon.addToBox', 'pokemon.clone', 'pokemon.commit', 'pokemon.edit', 'pokemon.setLevel', 'pokemon.update', 'trainer.setBadges', 'trainer.setBattlePoints', 'trainer.setGender', 'trainer.setMoney', 'trainer.setName', 'transfer.close', 'transfer.commit', 'transfer.open'];
 export type QueryName = (typeof queries)[number];
 export type CommandName = (typeof commands)[number];
 export type CallName = QueryName | CommandName;
@@ -9,12 +9,14 @@ export interface EngineClient {
     box: {
         /** Requires a loaded save; throws `no-save` otherwise. */
         addEncounter(index: number): Promise<AddedPokemon>;
-        /** Requires a loaded save; throws `no-save` otherwise. */
-        addFromFile(bytes: Binary): Promise<AddedPokemon>;
+        /** Adds a Pokémon file to the first empty box slot, converted to the loaded save's format. Fails with `unparseable`, `not-in-game` and `conversion-failed` as `box.previewFile` does, and with `box-full` when no slot is empty. A file no game can move into the save fails with `conversion-failed` unless `allowUnofficial` is set. Requires a loaded save; throws `no-save` otherwise. */
+        addFromFile(bytes: Binary, options?: AddFromFileOptions | null): Promise<AddedPokemon>;
         /** Requires a loaded save; throws `no-save` otherwise. */
         get(): Promise<PokemonSummary[]>;
         /** Lists every box in the save in order, empty ones included, with its name and slot count. Requires a loaded save; throws `no-save` otherwise. */
         list(): Promise<BoxEntry[]>;
+        /** Shows how `box.addFromFile` would add a Pokémon file to the loaded save. Nothing is written. Fails with `unparseable` when the bytes aren't a Pokémon, `not-in-game` when the game doesn't have its species, and `conversion-failed` when PKHeX can't convert it at all. Requires a loaded save; throws `no-save` otherwise. */
+        previewFile(bytes: Binary): Promise<FilePreview>;
         /** Requires a loaded save; throws `no-save` otherwise. */
         showdown(): Promise<string>;
     };
@@ -130,10 +132,10 @@ export interface EngineClient {
         /** Requires a loaded save; throws `no-save` otherwise. */
         options(at: PokemonHandle): Promise<PokemonOptions>;
         /**
-         * Reads one Gen 3 or Gen 4 Pokémon from bytes taken from a running game, without a loaded save. Nothing is written, and `legality` is null. Bytes that aren't a Pokémon, such as all zeros, an empty species or a Gen 3 bad egg, fail with `bad-checksum`. From party bytes, `level` is the level the game stores and shows. Box bytes have no level, so theirs comes from the Pokémon's EXP.
+         * Reads one Gen 3, 4 or 5 Pokémon from bytes taken from a running game, without a loaded save. Nothing is written, and `legality` is null. Bytes that aren't a Pokémon, such as all zeros, an empty species or a Gen 3 bad egg, fail with `bad-checksum`. From party bytes, `level` is the level the game stores and shows. Box bytes have no level, so theirs comes from the Pokémon's EXP.
          *
-         * @param bytes The Pokémon as the game keeps it: encrypted and shuffled, in its party (100-byte PK3, 236-byte PK4) or box (80-byte PK3, 136-byte PK4) layout. Another length fails with `bad-arguments`.
-         * @param version The PKHeX game version id the bytes come from. A combined version, such as FireRed/LeafGreen, fails with `bad-arguments`, and a game outside Gen 3 and 4 with `not-supported`.
+         * @param bytes The Pokémon as the game keeps it: encrypted and shuffled, in its party (100-byte PK3, 236-byte PK4, 220-byte PK5) or box (80-byte PK3, 136-byte PK4 or PK5) layout. Another length fails with `bad-arguments`.
+         * @param version The PKHeX game version id the bytes come from. A combined version, such as FireRed/LeafGreen, fails with `bad-arguments`, and a game outside Gen 3 to 5 with `not-supported`.
          * @param formatId The id of a ROM hack's format, from `game.formats()` or `game.version()`, such as `unbound`. The bytes are then read in the hack's party layout, as `pokemon.details` reads the Pokémon in the hack's save. Only party bytes are accepted. `version` must be the format's base game, such as FireRed for Unbound, or the read fails with `bad-arguments`. An unknown or disabled id fails with `not-found`, and `pkhex` with `not-supported`.
          */
         read(bytes: Binary, version: number, formatId?: string | null): Promise<EditablePokemon>;
@@ -148,26 +150,6 @@ export interface EngineClient {
         /** Requires a loaded save; throws `no-save` otherwise. */
         list(): Promise<SpeciesEntry[]>;
     };
-    trade: {
-        /** Closes the open trade, dropping the partner save. Closing with no trade open does nothing. */
-        close(): Promise<void>;
-        /** Moves the offered Pokémon: each leaves its slot and lands in the first empty box slots of the other save. Fails with `trade-refused`, writing nothing, when `trade.preview()` refuses any of them. Requires a loaded save; throws `no-save` otherwise. */
-        commit(offer: TradeOffer): Promise<TradeResult>;
-        /** Reads the open trade's partner, routes and room, or null when no trade is open or no save is loaded. */
-        get(): Promise<TradeSummary | null>;
-        /**
-         * Opens a partner save next to the loaded one, to move Pokémon between them. It replaces the partner opened before, and stays open until `trade.close()`, even when another save is loaded. Requires a loaded save; throws `no-save` otherwise.
-         *
-         * @param data The partner save file's bytes.
-         * @param fileName The file name to export the partner with. Defaults to the name of a `File`, or `partner.sav`.
-         * @param formatId The id of a save format from `game.formats()` to load the partner with, as in `game.load()`.
-         */
-        open(data: Binary, fileName?: string | null, formatId?: string | null): Promise<TradeSummary>;
-        /** Lists the partner's party, then its boxed Pokémon in box and slot order. Handles point into the partner save. */
-        partnerBoxes(): Promise<PokemonSummary[]>;
-        /** Shows what moving the offered Pokémon would change, and which ones can't move. Nothing is written. A handle without a Pokémon fails with `not-found`, and the draft with `draft-not-allowed`. Requires a loaded save; throws `no-save` otherwise. */
-        preview(offer: TradeOffer): Promise<TradePreview>;
-    };
     trainer: {
         /** Lists the gym badges in game order. Gold, Silver and Crystal list the Johto badges, then the Kanto ones. Returns null outside Generations 1 to 3 and for ROM hacks. Requires a loaded save; throws `no-save` otherwise. */
         badges(): Promise<Badge[] | null>;
@@ -184,5 +166,25 @@ export interface EngineClient {
         /** Requires a loaded save; throws `no-save` otherwise. */
         setName(name: string): Promise<void>;
     };
+    transfer: {
+        /** Closes the open transfer, dropping the partner save. Closing with no transfer open does nothing. */
+        close(): Promise<void>;
+        /** Moves the offered Pokémon: each leaves its slot and lands in the first empty box slots of the other save. Fails with `transfer-refused`, writing nothing, when `transfer.preview()` refuses any of them. Requires a loaded save; throws `no-save` otherwise. */
+        commit(offer: TransferOffer): Promise<TransferResult>;
+        /** Reads the open transfer's partner, routes and room, or null when no transfer is open or no save is loaded. */
+        get(): Promise<TransferSummary | null>;
+        /**
+         * Opens a partner save next to the loaded one, to move Pokémon between them. It replaces the partner opened before, and stays open until `transfer.close()`, even when another save is loaded. Requires a loaded save; throws `no-save` otherwise.
+         *
+         * @param data The partner save file's bytes.
+         * @param fileName The file name to export the partner with. Defaults to the name of a `File`, or `partner.sav`.
+         * @param formatId The id of a save format from `game.formats()` to load the partner with, as in `game.load()`.
+         */
+        open(data: Binary, fileName?: string | null, formatId?: string | null): Promise<TransferSummary>;
+        /** Lists the partner's party, then its boxed Pokémon in box and slot order. Handles point into the partner save. */
+        partnerBoxes(): Promise<PokemonSummary[]>;
+        /** Shows what moving the offered Pokémon would change, and which ones can't move. Nothing is written. A handle without a Pokémon fails with `not-found`, and the draft with `draft-not-allowed`. Requires a loaded save; throws `no-save` otherwise. */
+        preview(offer: TransferOffer): Promise<TransferPreview>;
+    };
 }
 export declare function createClient(invoke: Invoke): EngineClient;

package/dist/generated/errors.d.ts

@@ -1,2 +1,2 @@
-export declare const errorCodes: readonly ['no-save', 'invalid-save', 'format-choice-required', 'not-found', 'out-of-range', 'pouch-full', 'box-full', 'unparseable', 'conversion-failed', 'not-in-game', 'unknown-species', 'invalid-patch', 'draft-not-allowed', 'no-slot', 'no-draft', 'unknown-call', 'bad-arguments', 'plugin-failed', 'not-supported', 'no-trade', 'trade-refused', 'bad-checksum', 'unexpected'];
+export declare const errorCodes: readonly ['no-save', 'invalid-save', 'format-choice-required', 'not-found', 'out-of-range', 'pouch-full', 'box-full', 'unparseable', 'conversion-failed', 'not-in-game', 'unknown-species', 'invalid-patch', 'draft-not-allowed', 'no-slot', 'no-draft', 'unknown-call', 'bad-arguments', 'plugin-failed', 'not-supported', 'no-transfer', 'transfer-refused', 'bad-checksum', 'unexpected'];
 export type ErrorCode = (typeof errorCodes)[number];

package/dist/generated/topics.d.ts

@@ -1,4 +1,4 @@
 import type { QueryName } from './client';
-export declare const topics: readonly ['*', 'game', 'party', 'box', 'inventory', 'events', 'trainer', 'draft', 'plugins', 'trade'];
+export declare const topics: readonly ['*', 'game', 'party', 'box', 'inventory', 'events', 'trainer', 'draft', 'plugins', 'transfer'];
 export type Topic = (typeof topics)[number] | `${(typeof topics)[number]}/${string}`;
 export declare const queryTopics: Record<QueryName, readonly Topic[]>;

package/dist/generated/types.d.ts

@@ -1,5 +1,10 @@
 /** Where a plug-in action shows up: `quick` on the home page with no target, `pokemon` in the Pokémon editor, `pokemonStats` on the editor's stats tab. */
 export type ActionPlacement = 'quick' | 'pokemon' | 'pokemonStats';
+/** How `box.addFromFile` adds a Pokémon file. */
+export interface AddFromFileOptions {
+    /** Add a Pokémon no game can move into the loaded save, converted as `box.previewFile` shows. Without it, such a file fails with `conversion-failed`. */
+    allowUnofficial: boolean;
+}
 /** An item the pouch can hold that the trainer doesn't have yet. */
 export interface AddableItem {
     /** The item's id in the save's own item list. From Generation 4 on, and in ROM hack saves, these are PKHeX.Core item ids; other Generation 1 to 3 saves use their game's own numbering. */
@@ -234,6 +239,17 @@ export interface ExportedSave {
     /** The file name the save was loaded with. */
     fileName: string;
 }
+/** A Pokémon file as `box.addFromFile` would add it to the loaded save, returned by `box.previewFile`. */
+export interface FilePreview {
+    /** The Pokémon as it would arrive in the loaded save. */
+    pokemon: PokemonPreview;
+    /** No game can move this Pokémon into the loaded save. `box.addFromFile` needs `allowUnofficial` to add it. */
+    unofficial: boolean;
+    /** The fields the conversion changes, in the order of `TransferField`. */
+    changes: TransferChange[];
+    /** PKHeX's legality check of the Pokémon as it would arrive, judged in the loaded save. Null when the save has no legality check, such as a ROM hack's. */
+    legality: Legality | null;
+}
 /** A save format `game.load()` can load a save with, returned by `game.formats()`. */
 export interface FormatEntry {
     /** The format's id, to pass to `game.load()` as `formatId`. */
@@ -340,6 +356,15 @@ export interface ItemHandle {
     /** The item's id in the save's own item list, as `OwnedItem.id` and `AddableItem.id` give it. */
     itemId: number;
 }
+/** A Pokémon as it was before a transfer to an older game, to restore what that game dropped. Store it and pass it in `keptCopies` when the Pokémon moves to a newer game again. */
+export interface KeptCopy {
+    /** The Pokémon's `identityKey`. */
+    identityKey: string;
+    /** The generation of the game it left. */
+    generation: number;
+    /** The Pokémon as it was in that game, in the bytes `pokemon.export` writes. */
+    bytes: Uint8Array<ArrayBuffer>;
+}
 /** The result of PKHeX's legality check on a Pokémon. */
 export interface Legality {
     /** True when PKHeX finds nothing illegal. */
@@ -368,19 +393,23 @@ export interface MoveSlot {
     /** The slot holds a move PKHeX has no id for, such as a ROM hack's own move, named like `Unknown move #90`. Its `id` can only stay in this slot, and the slot can be set to another move or to 0. */
     isUnknown: boolean;
 }
-/** A Pokémon in the offer that can be traded, and what moving it changes. */
+/** A Pokémon in the offer that can be transferred, and what moving it changes. */
 export interface OfferedPokemon {
-    direction: TradeDirection;
+    direction: TransferDirection;
+    /** How the Pokémon gets to the other save. */
+    route: TransferRoute;
     /** The Pokémon as it is now. Its handle points to the save it leaves. */
     from: PokemonSummary;
     /** The Pokémon as it will be in the other save. Its handle is the box slot it will land in. */
     arrives: PokemonSummary;
-    /** The fields the move changes, in the order of `TradeField`. A move can show up once per move removed. */
-    changes: TradeChange[];
+    /** The fields the move changes, in the order of `TransferField`. A move can show up once per move removed. */
+    changes: TransferChange[];
     /** What the move changes in either save. */
-    saveChanges: TradeSaveChange[];
+    saveChanges: TransferSaveChange[];
     /** PKHeX's legality check of the Pokémon as it arrives, judged in the destination game. */
     legality: Legality;
+    /** `transfer.commit` returns a kept copy of this Pokémon. */
+    keepsCopy: boolean;
 }
 /** An item the trainer holds in a pouch. */
 export interface OwnedItem {
@@ -668,6 +697,30 @@ export interface PokemonPatch {
     /** PKHeX move ids for all four slots, 0 for an empty slot. All zeros changes nothing. */
     moves?: number[] | null;
 }
+/** A `PokemonSummary` without `id` and `at`, for a Pokémon that isn't in a slot. */
+export interface PokemonPreview {
+    /** PKHeX species id, which is the National Pokédex number. Null when `isUnknown` is true. */
+    speciesId: number | null;
+    /** The species as the save stores it: the game's internal index in Gen 1 to 3, Gen 9 and ROM hacks, and the National Pokédex number elsewhere. */
+    speciesIndex: number;
+    /** Species name, or a name like `Unknown (#412)` when `isUnknown` is true. */
+    species: string;
+    /** Neither PKHeX nor the save knows the species. Show a placeholder instead of a sprite. */
+    isUnknown: boolean;
+    /** The Pokémon could be opened with `pokemon.edit()` once added. */
+    editable: boolean;
+    form: PokemonForm;
+    /** The species name when the Pokémon has no nickname. */
+    nickname: string;
+    level: number;
+    isShiny: boolean;
+    gender: PokemonGender;
+    isEgg: boolean;
+    /** Type ids, named by `game.types()`. One entry for a single-type Pokémon. */
+    types: number[];
+    /** The same for this Pokémon in every game it moves to: its PID, trainer ID and secret ID. Null in Gen 1 and 2. */
+    identityKey: string | null;
+}
 /** Fires when an edited or cloned Pokémon is written to the save: by `pokemon.commit` back to its slot, or by `pokemon.addToBox` to the first empty box slot. */
 export interface PokemonSaved {
     type: 'pokemonSaved';
@@ -700,6 +753,8 @@ export interface PokemonSummary {
     isEgg: boolean;
     /** Type ids, named by `game.types()`. One entry for a single-type Pokémon. */
     types: number[];
+    /** The same for this Pokémon in every game it moves to: its PID, trainer ID and secret ID. Null in Gen 1 and 2. */
+    identityKey: string | null;
 }
 /** One bag pouch in the save, returned by `inventory.get`. */
 export interface Pouch {
@@ -717,12 +772,12 @@ export interface PublishedVersion {
     /** The plug-in SDK the version is built against: `1` for the older PKHeX.Web plug-ins, `2` and later for PKHeX.Everywhere plug-ins. The engine runs SDK 3 only. */
     sdk: number;
 }
-/** A Pokémon in the offer that can't be traded. */
+/** A Pokémon in the offer that can't be transferred. */
 export interface RefusedPokemon {
-    direction: TradeDirection;
+    direction: TransferDirection;
     /** Where it is, in the save it would leave. */
     at: PokemonHandle;
-    reason: TradeRefusal;
+    reason: TransferRefusal;
 }
 /** A feature that relies on PKHeX knowing the save's game: the legality check in `pokemon.details()`, AutoLegality, the `encounters` calls, Showdown export, the `events` calls and plug-ins. Without `plugIns`, hooks don't run, `plugins.actions()` and `plugins.pages()` are empty, and `plugins.run()` and `plugins.pageModule()` fail with `not-supported`. */
 export type SaveCapability = 'legality' | 'autoLegality' | 'encounters' | 'showdown' | 'events' | 'plugIns';
@@ -821,105 +876,109 @@ export interface TicketsAndIslands {
     /** Flags for ferry access and the event islands. Empty outside Emerald. */
     islands: EventFlag[];
 }
-/** A field a trade changes. */
-export interface TradeChange {
-    field: TradeField;
+/** The trainer's identity and currencies, returned by `trainer.get`. */
+export interface TrainerCard {
+    /** The trainer ID and secret ID as `TID/SID`, in the format the game displays them. */
+    id: string;
+    name: string;
+    /** The longest name the game allows. `trainer.setName` cuts longer names to this length. */
+    maxNameLength: number;
+    /** The trainer's gender, or null for games without one: Red, Green, Blue, Yellow, Gold, Silver and Pokémon Stadium. `trainer.setGender` fails with `not-in-game` for those. */
+    gender: TrainerGender | null;
+    /** The trainer's money, or null when the save has none. `trainer.setMoney` accepts 0 to 999999 and caps it at the game's maximum. */
+    money: number | null;
+    /** The trainer's Battle Points, or null outside Generation 4 and 6 saves. `trainer.setBattlePoints` accepts 0 to 65535. */
+    battlePoints: number | null;
+    /** The rival's name, or null when the engine can't read one for this game. */
+    rival: string | null;
+}
+/** The trainer's gender, as `trainer.get` returns it and `trainer.setGender` takes it. */
+export type TrainerGender = 'male' | 'female';
+/** A field a transfer changes. */
+export interface TransferChange {
+    field: TransferField;
     /** The value as the source game names it. Null when there was none, such as a move the Pokémon learns. */
     before: string | null;
     /** The value as the destination game names it. Null when there is none, such as a removed move or item. */
     after: string | null;
-    reason: TradeChangeReason;
+    reason: TransferChangeReason;
 }
-/** Why a trade changes a field. */
-export type TradeChangeReason = 'hmRemoved' | 'itemRemapped' | 'itemRemoved' | 'link' | 'timeCapsule' | 'palPark' | 'pokeTransfer' | 'received' | 'tradeEvolution' | 'itemUsed' | 'formReverted';
+/** Why a transfer changes a field. */
+export type TransferChangeReason = 'hmRemoved' | 'itemRemapped' | 'itemRemoved' | 'link' | 'timeCapsule' | 'palPark' | 'pokeTransfer' | 'received' | 'tradeEvolution' | 'itemUsed' | 'formReverted' | 'notInGame' | 'unofficial' | 'restored';
 /** Which way a Pokémon moves: `send` from the loaded save to the partner, `receive` from the partner to the loaded save. */
-export type TradeDirection = 'send' | 'receive';
-/** A field of a Pokémon that a trade can change. */
-export type TradeField = 'species' | 'form' | 'heldItem' | 'moves' | 'metLocation' | 'metLevel' | 'ball' | 'friendship' | 'nickname' | 'ability';
+export type TransferDirection = 'send' | 'receive';
+/** A field of a Pokémon that a transfer can change. */
+export type TransferField = 'species' | 'form' | 'heldItem' | 'moves' | 'metLocation' | 'metLevel' | 'ball' | 'friendship' | 'nickname' | 'ability' | 'level' | 'nature' | 'gender' | 'shiny' | 'language' | 'originalTrainer' | 'trainerId' | 'originGame' | 'metDate';
 /** The Pokémon to move. Each handle points to a party or box slot: in the loaded save for `send`, and in the partner for `receive`. */
-export interface TradeOffer {
+export interface TransferOffer {
     /** Pokémon to move from the loaded save to the partner. */
     send: PokemonHandle[];
     /** Pokémon to move from the partner to the loaded save. */
     receive: PokemonHandle[];
+    /** Copies `transfer.commit` returned from earlier transfers to older games. A copy restores what an older game dropped from the offered Pokémon with its `identityKey`. Copies that apply to none are ignored. */
+    keptCopies?: KeptCopy[] | null;
 }
-/** What `trade.commit` would do with an offer, returned by `trade.preview`. */
-export interface TradePreview {
-    /** The Pokémon that can be traded, sent ones first. */
+/** What `transfer.commit` would do with an offer, returned by `transfer.preview`. */
+export interface TransferPreview {
+    /** The Pokémon that can be transferred, sent ones first. */
     offers: OfferedPokemon[];
-    /** The Pokémon that can't. `trade.commit` fails while any are left. */
+    /** The Pokémon that can't. `transfer.commit` fails while any are left. */
     refused: RefusedPokemon[];
 }
-/** Why a Pokémon can't be traded. */
-export type TradeRefusal = 'noRoute' | 'slotLocked' | 'eggAcrossGenerations' | 'languageMismatch' | 'speciesNotInGame' | 'lastPartyMember' | 'noRoom' | 'bagFull';
-/** Both saves after `trade.commit`, ready to write back. */
-export interface TradeResult {
+/** Why a Pokémon can't be transferred. */
+export type TransferRefusal = 'noRoute' | 'slotLocked' | 'eggAcrossGenerations' | 'languageMismatch' | 'speciesNotInGame' | 'lastPartyMember' | 'noRoom' | 'bagFull' | 'conversionFailed';
+/** Both saves after `transfer.commit`, ready to write back. */
+export interface TransferResult {
     /** The loaded save. */
     save: ExportedSave;
     /** The partner save. */
     partner: ExportedSave;
     /** Where each Pokémon landed, sent ones first. */
-    arrived: TradedPokemon[];
+    arrived: TransferredPokemon[];
 }
 /** How many empty box slots each save has for Pokémon to arrive in. */
-export interface TradeRoom {
+export interface TransferRoom {
     /** Empty box slots in the loaded save. */
     mine: number;
     /** Empty box slots in the partner save. */
     partner: number;
 }
 /** How a Pokémon gets from one save to the other, as the games move it. */
-export type TradeRoute = 'link' | 'timeCapsule' | 'palPark' | 'pokeTransfer';
-/** The routes of an open trade. A null route means the games can't move Pokémon that way, and every Pokémon offered that way is refused with `noRoute`. Saves loaded with a ROM hack format and Let's Go saves have none. */
-export interface TradeRoutes {
+export type TransferRoute = 'link' | 'timeCapsule' | 'palPark' | 'pokeTransfer' | 'unofficial';
+/** The routes of an open transfer. A null route means Pokémon can't move that way, and every Pokémon offered that way is refused with `noRoute`. Only saves loaded with a ROM hack format and Let's Go saves have no route. */
+export interface TransferRoutes {
     /** From the loaded save to the partner. */
-    send: TradeRoute | null;
+    send: TransferRoute | null;
     /** From the partner to the loaded save. */
-    receive: TradeRoute | null;
+    receive: TransferRoute | null;
 }
-/** A change a trade makes to a save. */
-export interface TradeSaveChange {
-    kind: TradeSaveChangeKind;
+/** A change a transfer makes to a save. */
+export interface TransferSaveChange {
+    kind: TransferSaveChangeKind;
     /** The save that changes. */
-    save: TradeSide;
+    save: TransferSide;
     /** What changes, for display: the species caught, the item returned, or the event and its new value. */
     label: string;
 }
-/** What a trade changes in a save besides the Pokémon itself. */
-export type TradeSaveChangeKind = 'pokedexCaught' | 'itemReturned' | 'eventVar';
-/** A save in a trade: `sender` is the one the Pokémon leaves, `receiver` the one it arrives in. */
-export type TradeSide = 'sender' | 'receiver';
-/** The trade `trade.open` opened: the partner save, the routes between the saves and the room in each. */
-export interface TradeSummary {
+/** What a transfer changes in a save besides the Pokémon itself. */
+export type TransferSaveChangeKind = 'pokedexCaught' | 'itemReturned' | 'eventVar';
+/** A save in a transfer: `sender` is the one the Pokémon leaves, `receiver` the one it arrives in. */
+export type TransferSide = 'sender' | 'receiver';
+/** The transfer `transfer.open` opened: the partner save, the routes between the saves and the room in each. */
+export interface TransferSummary {
     partner: SaveSummary;
-    routes: TradeRoutes;
-    room: TradeRoom;
+    routes: TransferRoutes;
+    room: TransferRoom;
 }
-/** A Pokémon a trade moved. */
-export interface TradedPokemon {
-    direction: TradeDirection;
+/** A Pokémon a transfer moved. */
+export interface TransferredPokemon {
+    direction: TransferDirection;
     id: PokemonId;
     /** The box slot it landed in: in the partner for `send`, in the loaded save for `receive`. */
     at: PokemonHandle;
+    /** The Pokémon as it was before it moved to an older game. Null when it didn't. Store it to pass in a later transfer's `keptCopies`. */
+    keptCopy: KeptCopy | null;
 }
-/** The trainer's identity and currencies, returned by `trainer.get`. */
-export interface TrainerCard {
-    /** The trainer ID and secret ID as `TID/SID`, in the format the game displays them. */
-    id: string;
-    name: string;
-    /** The longest name the game allows. `trainer.setName` cuts longer names to this length. */
-    maxNameLength: number;
-    /** The trainer's gender, or null for games without one: Red, Green, Blue, Yellow, Gold, Silver and Pokémon Stadium. `trainer.setGender` fails with `not-in-game` for those. */
-    gender: TrainerGender | null;
-    /** The trainer's money, or null when the save has none. `trainer.setMoney` accepts 0 to 999999 and caps it at the game's maximum. */
-    money: number | null;
-    /** The trainer's Battle Points, or null outside Generation 4 and 6 saves. `trainer.setBattlePoints` accepts 0 to 65535. */
-    battlePoints: number | null;
-    /** The rival's name, or null when the engine can't read one for this game. */
-    rival: string | null;
-}
-/** The trainer's gender, as `trainer.get` returns it and `trainer.setGender` takes it. */
-export type TrainerGender = 'male' | 'female';
 /** A game version with its display name. */
 export interface VersionEntry {
     /** The game's PKHeX `GameVersion` value. */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as createEngine, n as topics, o as wasmHost, r as EngineError } from "./topics-CoiSl0tN.js";
+import { a as createEngine, n as topics, o as wasmHost, r as EngineError } from "./topics-Bx58fcG5.js";
 //#region src/generated/errors.ts
 var errorCodes = [
 	"no-save",
@@ -20,8 +20,8 @@ var errorCodes = [
 	"bad-arguments",
 	"plugin-failed",
 	"not-supported",
-	"no-trade",
-	"trade-refused",
+	"no-transfer",
+	"transfer-refused",
 	"bad-checksum",
 	"unexpected"
 ];

package/dist/internal.js

@@ -1,2 +1,2 @@
-import { i as call, s as affects, t as queryTopics } from "./topics-CoiSl0tN.js";
+import { i as call, s as affects, t as queryTopics } from "./topics-Bx58fcG5.js";
 export { affects, call, queryTopics };

package/dist/{topics-CoiSl0tN.js → topics-Bx58fcG5.js}

@@ -13,6 +13,7 @@ function fileNameOf(data) {
 }
 function withBytes(value, paths) {
 	if (value == null) return value;
+	if (Array.isArray(value)) return value.map((item) => withBytes(item, paths));
 	const converted = { ...value };
 	for (const path of paths) {
 		const [key, ...rest] = path.split(".");
@@ -22,15 +23,28 @@ function withBytes(value, paths) {
 	}
 	return converted;
 }
+async function withBase64(value, paths) {
+	if (value == null) return value;
+	if (Array.isArray(value)) return await Promise.all(value.map((item) => withBase64(item, paths)));
+	const converted = { ...value };
+	for (const path of paths) {
+		const [key, ...rest] = path.split(".");
+		const decoded = converted[key];
+		if (rest.length > 0) converted[key] = await withBase64(decoded, [rest.join(".")]);
+		else if (decoded != null && typeof decoded !== "string") converted[key] = await toBase64(decoded);
+	}
+	return converted;
+}
 //#endregion
 //#region src/generated/client.ts
 function createClient(invoke) {
 	return {
 		box: {
 			addEncounter: (index) => invoke("box.addEncounter", [index]),
-			addFromFile: async (bytes) => invoke("box.addFromFile", [await toBase64(bytes)]),
+			addFromFile: async (bytes, options) => invoke("box.addFromFile", [await toBase64(bytes), options]),
 			get: () => invoke("box.get", []),
 			list: () => invoke("box.list", []),
+			previewFile: async (bytes) => invoke("box.previewFile", [await toBase64(bytes)]),
 			showdown: () => invoke("box.showdown", [])
 		},
 		catalog: { names: (request) => invoke("catalog.names", [request]) },
@@ -119,18 +133,6 @@ function createClient(invoke) {
 			update: (at, patch) => invoke("pokemon.update", [at, patch])
 		},
 		species: { list: () => invoke("species.list", []) },
-		trade: {
-			close: () => invoke("trade.close", []),
-			commit: async (offer) => withBytes(await invoke("trade.commit", [offer]), ["save.bytes", "partner.bytes"]),
-			get: () => invoke("trade.get", []),
-			open: async (data, fileName, formatId) => invoke("trade.open", [
-				await toBase64(data),
-				fileName ?? fileNameOf(data),
-				formatId
-			]),
-			partnerBoxes: () => invoke("trade.partnerBoxes", []),
-			preview: (offer) => invoke("trade.preview", [offer])
-		},
 		trainer: {
 			badges: () => invoke("trainer.badges", []),
 			get: () => invoke("trainer.get", []),
@@ -139,6 +141,22 @@ function createClient(invoke) {
 			setGender: (gender) => invoke("trainer.setGender", [gender]),
 			setMoney: (amount) => invoke("trainer.setMoney", [amount]),
 			setName: (name) => invoke("trainer.setName", [name])
+		},
+		transfer: {
+			close: () => invoke("transfer.close", []),
+			commit: async (offer) => withBytes(await invoke("transfer.commit", [await withBase64(offer, ["keptCopies.bytes"])]), [
+				"save.bytes",
+				"partner.bytes",
+				"arrived.keptCopy.bytes"
+			]),
+			get: () => invoke("transfer.get", []),
+			open: async (data, fileName, formatId) => invoke("transfer.open", [
+				await toBase64(data),
+				fileName ?? fileNameOf(data),
+				formatId
+			]),
+			partnerBoxes: () => invoke("transfer.partnerBoxes", []),
+			preview: async (offer) => invoke("transfer.preview", [await withBase64(offer, ["keptCopies.bytes"])])
 		}
 	};
 }
@@ -149,7 +167,7 @@ var overlaps = (a, b) => covers(a, b) || covers(b, a);
 var affects = (changed, read) => changed.some((c) => read.some((r) => overlaps(c, r)));
 //#endregion
 //#region package.json
-var version = "0.16.0";
+var version = "0.18.0";
 //#endregion
 //#region src/crypto.ts
 var modes = {
@@ -393,11 +411,12 @@ var topics = [
 	"trainer",
 	"draft",
 	"plugins",
-	"trade"
+	"transfer"
 ];
 var queryTopics = {
 	"box.get": ["box"],
 	"box.list": ["box"],
+	"box.previewFile": ["box", "trainer"],
 	"box.showdown": ["box"],
 	"catalog.names": [],
 	"encounters.search": ["game"],
@@ -460,15 +479,15 @@ var queryTopics = {
 		"draft"
 	],
 	"species.list": ["game"],
-	"trade.get": ["trade", "box"],
-	"trade.partnerBoxes": ["trade"],
-	"trade.preview": [
-		"trade",
+	"trainer.badges": ["trainer", "events"],
+	"trainer.get": ["trainer"],
+	"transfer.get": ["transfer", "box"],
+	"transfer.partnerBoxes": ["transfer"],
+	"transfer.preview": [
+		"transfer",
 		"party",
 		"box"
-	],
-	"trainer.badges": ["trainer", "events"],
-	"trainer.get": ["trainer"]
+	]
 };
 //#endregion
 export { createEngine as a, call as i, topics as n, wasmHost as o, EngineError as r, affects as s, queryTopics as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pkhex-everywhere/engine",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "PKHeX in the browser: load, read and edit Pokémon save files.",
   "license": "GPL-3.0-or-later",
   "homepage": "https://docs.pkhex-everywhere.fyi/docs/",