Repository navigation
·
15 commits
to primary
since this release
This release adds TypeScript 7 type checking behind --unstable-tsc7, gives desktop apps a stable app:// origin so their web storage persists on macOS and Windows, and brings structuredClone, the global object and many other web APIs closer to the specs. It also fixes a long list of CLI and desktop packaging bugs. Many fixes are ported from Deno v2.9 and upstream pull requests, with the original authors credited in the commit history.
Breaking and behavior changes
- Desktop update manifests need
targetSha256. Each patch entry in a desktop app’s update manifest now needstargetSha256, the SHA-256 of the new version’s library after the patch is applied:An app built with this release checks the patched library against it before staging the update. An entry without it is rejected: the app logs an error and stages nothing. Apps built with earlier releases ignore the field, so add it to existing manifests now.{ "name": "…", "sha256": "…", "targetSha256": "…" } - Desktop apps need a valid app identifier. The app identifier now becomes the page’s origin (see "New"), so a build fails if
desktop.app.identifier, or the name it falls back to, can’t form a valid host name: for example, a name made only of digits, orlocalhost. Whendesktop.app.identifieris unset, the build warns: renaming the app later would change its origin and lose its stored data. - The macOS bundle id follows the app identifier. Without
desktop.app.identifier, the bundle id is now derived the same way as the app’s origin, somy_appgivessh.ende.desktop.my-app. It used to keep_and., and Apple doesn’t allow_. This affects only apps whose name has characters other than letters, digits and single spaces. An installed copy of such an app loses its notification permissions and WebKit data once. The build warns when the id changes. Setdesktop.app.identifierto keep it stable. A name that derives no id now fails the build with the same advice. - Desktop app storage moves under the identifier. A desktop app’s own
localStorageandcaches(the main module’s, not the webview’s) move from<data>/<app name>to<data>/<identifier>/storage.<data>is~/Library/Application Supporton macOS,%LOCALAPPDATA%on Windows and~/.local/shareon Linux. On first launch the old folder is renamed into place if the new one doesn’t exist yet. Nothing is merged or deleted: if both exist, the new one is used. If the rename fails, the app logs why and keeps using the old folder.ende compilebinaries are unchanged. - MSI installers replace older versions and refuse downgrades. Installing a new version used to add a second entry to Apps & features. Now it removes the older version, and installing an older version over a newer one stops with "A newer version of is already installed." Apps installed by earlier MSIs are found and replaced too. Bump
versionin ende.json for every MSI release: only its first three numeric fields count, and a rebuild with the same version installs as a repair, not an upgrade. --compressworks again on macOS, and opens through LaunchServices. Building and signing a--compressapp failed for every app. The compressed app now extracts once and opens the real app with LaunchServices, so tray icons (Ende.Tray) show, the app has one Dock icon, and opening it again brings it to the front. Because of the handoff, running the compressed app’s executable from a terminal no longer shows the app’s output, environment or exit code, andopen -Wreturns at once. Run the uncompressed build to debug.- structuredClone and postMessage follow the specs more closely.
- Many platform objects that aren’t serializable now throw a
DataCloneErrorinstead of arriving as{}, both at the top level and nested in a value: AbortController, Navigator, WorkerNavigator, NavigatorUAData, Location, WorkerLocation, OffscreenCanvas, ImageBitmapRenderingContext, CacheStorage, Cache, LockManager, Lock, Storage, the stream readers, writers and controllers, WebSocketStream, the WebTransport interfaces and every WebGPU interface. - DOMMatrix, DOMPoint, DOMRect and DOMQuad (and their ReadOnly variants), ImageData and ImageBitmap are now copied as the same interface with the same values, also into a worker. They used to arrive as
{}. - ImageBitmap and OffscreenCanvas are transferable: transferring one moves its pixels and detaches the source. An OffscreenCanvas that has a rendering context can’t be transferred (
InvalidStateError, per the HTML spec). - QuotaExceededError, WebSocketError, WebTransportError and GPUPipelineError keep their class and their own fields (
quota,closeCode,source,reason, …). They used to come back as a plain DOMException. - A value whose type has no deserializer throws a
DataCloneErrorinstead of crashing the process. An error thrown while deserializing now reaches the caller (and amessageerrorevent) instead of "could not deserialize value". - The transfer list is validated before serializing, and buffers are detached only when serializing succeeds.
- Many platform objects that aren’t serializable now throw a
- Global getters and event handlers check their receiver. The getters of
self,navigator,localStorage,sessionStorage,caches,crypto,locationandclosedthrow a TypeError when called on anything other than the global object, as in browsers. So do event handler properties (onerror,onload,onmessage, …): on the global they throw for any other receiver, including a Proxy of the global, and on an EventTarget interface (such asAbortSignal,WebSocketorWorker) they throw unless the receiver is an instance of it. A nullish receiver means the global object, so a detached getter or setter of the global works (it used to throw). - WebGPU flag namespaces are plain objects.
GPUBufferUsage,GPUMapMode,GPUTextureUsage,GPUShaderStageandGPUColorWriteare now objects with read-only constants, not classes, as in browsers. Their types are namespaces too. The values are unchanged.WGSLLanguageFeatures, the type ofnavigator.gpu.wgslLanguageFeatures, is now a global and declared in the types. Intl.FormattableandIntl.DateTimeFormatRangePartare removed. Use TypeScript’sIntl.FormattableTemporalObjectandIntl.DateTimeRangeFormatPart. Passing aTemporal.ZonedDateTimetoIntl.DateTimeFormat#format()orformatRange()is now a type error; it already threw a TypeError at run time.WebSocketCloseInfo.codeis nowcloseCode, matching the WebSocketStream spec and the runtime. Readinginfo.codetype-checked but was alwaysundefined; rename it tocloseCode.- Inspecting buffers and DataView marks getters.
byteLengthon anArrayBufferorSharedArrayBuffer, andbyteLength,byteOffsetandbufferon aDataView, now print in brackets after the contents, as in Node.js:ArrayBuffer { [Uint8Contents]: <01 02>, [byteLength]: 2 }. Tests that compareEnde.inspectorconsole.logoutput may need updating. Inspecting aDataViewwhose buffer was detached or shrunk no longer prints an internal formatting error. on<event> = nullremoves the listener. Setting an event handler property tonullnow unregisters its listener, so, for example, a process no longer waits for anAbortSignal.timeout()whoseonabortwas cleared. Setting a handler again adds it at the end of the listener list, not at its old position.- WebSocket abnormal closures report code 1006. A connection that fails (refused, bad handshake,
close()while connecting) or drops without a close frame now firesclosewith code 1006 andwasClean: false, as in browsers. It used to be code 0. This applies to sockets fromEnde.upgradeWebSockettoo. *.localhostnames connect to loopback. Names such asapp.localhostresolve likelocalhostinfetch, WebSocket,Ende.connect,Ende.connectTls,Ende.listenand QUIC, as in browsers. They used to go to the system resolver, which fails in many containers. A hosts-file entry that points such a name elsewhere is now ignored, and--deny-importchecks see the loopback address.- URLPattern returns named full-wildcard groups by name. A group spanning a whole component, such as
{ hostname: ":domain(.*)" }, is returned as{ domain: "localhost" }instead of{ "0": "localhost" }. ende runandende servefollow a symlinked entrypoint. A local entrypoint is loaded from its real path, so a script symlinked into abindirectory resolves its relative imports next to the real file.import.meta.urlnow names the real path, also when a directory on the way is a symlink (such as/tmpon macOS).- Doc tests load only what a snippet uses. A snippet now imports just the exports it references, so
compilerOptions.noUnusedLocalsno longer fails on generated imports. A snippet that references no export no longer loads the documented module, so that module’s top-level code doesn’t run for it. This applies toende test --docandende check --doc. ende fmtmay reformat Markdown once.ende fmtnow uses dprint-plugin-markdown 0.29. It keeps definition lists and formats documents the old version rejected, such as escaped brackets in image alt text. Existing Markdown may reformat once (about 1 in 9 files in our tests), mostly[//]: # (comment)becoming[//]: # "comment", code spans split across lines being rejoined, and some rewrapping. The rendered output doesn’t change. HTML and code spans are left as written; set"html.skipFormat": falseor"wrapCodeSpans": trueunderfmt.markdownto opt in.ende upgradewon’t overwrite a packaged binary. On Linux, if the runningendewas installed by a Debian package (apt/dpkg),ende upgradestops and names the package; upgrade with the package manager instead.--outputstill writes a new binary anywhere, including over the packaged one.ende upgrade --unsafely-ignore-certificate-errorsneeds=for hosts. Write--unsafely-ignore-certificate-errors=host,.... A bare flag means all hosts, soende upgrade --unsafely-ignore-certificate-errors 2026.10.14now upgrades to that version. It used to read the version as a host and upgrade to the latest release.--unstable-tsgois gone. It was a leftover that did nothing. The flag is now rejected as unsupported, andENDE_UNSTABLE_TSGOis ignored. Use--unstable-tsc7(see "New").
New
ende check --unstable-tsc7type-checks with TypeScript 7. TypeScript 7.0.2’s native compiler ships insideendeand is unpacked to Ende’s cache the first time it runs, after a checksum check. Turn it on with--unstable-tsc7or"unstable": ["tsc7"]in ende.json. It’s used by every command that type-checks:check(including--watch,--docand--doc-only),run --check,test,bench,compileandpublish. TS 6 stays the default, and the language server stays on TS 6.- Same input, same output. Remote and JSR modules, import maps,
/// <reference lib>, Wasm, CSS and bytes/text imports, and@ts-types/@deno-types/X-TypeScript-Typesresolve as they do under TS 6. Diagnostics point at your files and URLs in the usual format, with related information and exact underlines. Ende’s additions to the DOM types, such as"brotli"inCompressionFormat, are available. A check that passed is cached until something changes. Nothing is written into your project: the generated tsconfig and module copies live in Ende’s cache. - Known differences from TS 6. They come from TypeScript 7 itself: some overload errors are worded differently; isolated declarations report TS9013;
esModuleInteropis always on, so TS1192 no longer appears for default imports ofexport =modules; and diagnostics may be listed in a different file order. baseUrl. TypeScript 7 removedbaseUrl. Under--unstable-tsc7it’s dropped with a warning, and Ende still resolves"paths"and"rootDirs"against it. Other compiler options that TS 7 removed give an error that names the option.- The cache cleans up after itself. Module copies that left the module graph are removed after each check. When Ende extracts a new compiler, it removes older extractions, unless another Ende process is using the cache. Checks of the same workspace now run one at a time.
ENDE_TSC_BINpoints Ende at a differenttscbinary instead of the bundled one.
- Same input, same output. Remote and JSR modules, import maps,
// @ende-types="..."works as an alias of// @ts-types="..."everywhere:check(TS 6 and TS 7),info,doc,run --check,test,bench,compile, the language server and theno-sloppy-importslint rule.ende publishrewrites it to@ts-typesin the published files, so packages keep working in Deno and on JSR. Your files on disk are unchanged.- Desktop storage persists on macOS and Windows. Pages load from
app://<identifier>instead of a random loopback port, so localStorage, IndexedDB and other per-origin storage survive restarts. Linux, CEF and the raw backend keep the loopback port for now.request.urlinEnde.serveis stillhttp://<identifier>/….info.remoteAddr.transportis"memory"for requests from the window.- WebSockets go through a loopback relay. Its URL is in
ENDE_DESKTOP_WS_URL. - macOS: same-origin redirects work, and cookies are kept between launches (session cookies aren’t).
- Limits: on Windows, SSE and long polls don’t stream. On macOS,
Blobrequest bodies arrive empty, and cookies set in an XHR response are not stored. On macOS, CSPframe-ancestorsandX-Frame-Optionsaren’t enforced onapp://pages, so a page that mustn’t be framed has to checkwindow.topitself.
BrowserWindow.printToPdf(options?)renders the page to a PDF and resolves with its bytes. Writing topathneeds write permission, as withEnde.writeFile.new BrowserWindow({ visible: false })creates a window that stays off screen.desktop.initialWindowin ende.json configures the first window:width,height,frameless,noActivate,transparentTitlebar,transparentandshowOnFirstLoad. Invalid values fail the build and name the key.
Runtime and web APIs
- HTTP server (
Ende.serve):- Honors
Connection: close. - Closes the connection after an early response when the request body is unread.
- A request body stays readable alongside a streamed response.
- Request body reads survive graceful shutdown.
- Backpressure applies while an HTTP/1.1 response is pending.
completedrejects when a raw HTTP/1 stream fails.
- Honors
- fetch: aborting still cancels a body after the
Responseis collected. - WebSocket: frames are flushed after writing, and the closing handshake times out.
- WebTransport: stream resources are finished and released.
- URL:
URL.parseconstructs a plainURL. - Web IDL sequences (Headers init, Blob and File parts, the transfer list,
URLSearchParams, …): iteration ends on any truthydone, not onlytrue, and a primitive iterator or iterator result throws a TypeError. - Streams and text:
- With
a.readable.pipeThrough(b)and an identityTransformStream, writes toa.writableno longer wait for someone to readb.readable. - BOMs after streamed ASCII chunks are kept.
- Oversized resource stream buffers are no longer retained.
- With
- Inspection:
- Inspecting an interface prototype, a subclass prototype or
Object.create(X.prototype)no longer throws or leaves an unhandled rejection. This covered about 80 interfaces, including URL, the streams, Request, Response, the Event subclasses, AbortSignal, Blob, File and the WebGPU interfaces. Symbol.toStringTagis defined on every interface prototype. On the global scope interfaces (Window, WorkerGlobalScope, DedicatedWorkerGlobalScope) it’s a data property, as Web IDL specifies.GPUBindGroupLayout,GPUCompilationInfoandGPUCompilationMessageinstances show their contents, andGPUCompilationMessageshowslineNumandlinePos(it printedline_numandline_pos).console.tableright-aligns a column only when its values are integers asNumber()reads them.
- Inspecting an interface prototype, a subclass prototype or
- Events:
addEventListenerignores an inheritedsignalin its options. - WebGPU:
GPUBuffer.mapAsync()andGPUQueue.onSubmittedWorkDone()no longer add a 10 ms delay to every call. - File system and processes:
Ende.utimeandEnde.utimeSyncwork on read-only files on Windows. Numeric timestamps passed to them and toFsFile.utimekeep their sub-millisecond part.Ende.Commandthrows aTypeErrornaming the variable when anenvvalue isn’t a string.Ende.watchFs: a watcher opened right after closing one for the same path gets events.
- OpenTelemetry: export keeps non-ASCII Latin-1 text (such as "Médicale") in log lines and in span, event and metric names and attributes.
- Core:
- Passing a Symbol to a built-in API that takes an arbitrary value throws instead of crashing the process.
- A throwing indexed accessor on
Array.prototypeno longer crashes stack trace formatting. - Cached async modules are awaited before dynamic imports resolve.
- Built-in modules that load lazily resolve their internal imports.
- An out-of-range source map line no longer overflows.
- Op contexts stay alive until the isolate is disposed, and inherited extension sources are kept across chained snapshots.
- Built-in APIs no longer allocate an options object on each call that omits it.
CLI and tooling
- fmt: CSS, HTML, XML, SVG, Vue, Svelte, Astro, Vento, Nunjucks, Mustache, SQL and YAML files follow
fmt.newLineKind. They were always written with LF. Embedded CSS and JS follow the file’s line endings. - lint:
--fixwrites through symlinks (it used to replace the link with a file) and keeps file permissions.- Plugin specifiers and
!exclusions resolve through the import map, in the CLI, watch mode and the language server. A plugin mapped tonullis reported. ||was removed from theEnde.lint.BinaryExpressionoperator type.ende lint --exthelp no longer runs its sentences together.
- publish:
- The specifiers in
@ts-types,@deno-types,@ende-typesand@ts-self-typespragmas are rewritten like import specifiers, so a published package no longer carries pragmas that only resolve with the author’s import map. - Reachable JSR self imports are rejected.
- The specifiers in
- compile:
- The
no-legacy-abortunstable feature works in compiled binaries:request.signalno longer aborts after a successful response, and the legacy-behavior warning is gone. --excludeandcompile.excludematch../paths and paths under a symlinked working directory. The excluded files used to be embedded.
- The
- upgrade: the new binary is unpacked next to the output executable, also for
--prand--branch, so upgrading works where the system temp folder is mountednoexec. - watch:
- A restart kills child processes the run spawned and
unref()’d, with--watch,--watch-hmrandserve --watch. Detached children still survive. - A SIGTERM handler that removes itself and re-raises the signal (as signal-exit, used by Vite 8 and rolldown, does) no longer kills the watcher on restart.
- A restart kills child processes the run spawned and
- coverage:
--includeand--excludematch decoded paths.- The V8 code cache is skipped while collecting.
- Files whose coverage doesn’t match their source are skipped.
- cache:
- A cached 404 is retried with auth tokens.
- SQLite first-time init is serialized across threads.
- Module info that JSR supplies is used instead of parsing the module again.
- test: failing tests no longer print a Rust backtrace.
- HMR: source map URLs are preserved in inspector patches.
- repl: multi-line input containing a regex literal waits for the closing brace instead of being submitted early.
- env files: a leading UTF-8 BOM is stripped, so the first entry is no longer lost (
--env-fileandende compile). - resolver: sloppy-import hints are scoped to prepared modules.
- completions: zsh completes script paths for a bare
ende run.
Type checking
ende check --allno longer fails with TS1046 on bytes, text and CSS raw imports."lib": ["dom"]includesError.captureStackTraceagain.RegExp.escapeandUint8Array’s base64 and hex methods are declared once, so editor hovers no longer show "(+1 overload)".- A type error with two or more related-information entries prints each on its own lines. They used to run together.
Argon2Paramsis declared forSubtleCrypto.deriveBits(), so Argon2 calls type-check without a cast.- Custom inspection callback types are declared.
- Language server:
// @ts-ignoreand// @ts-expect-errorsilence missing-import errors, asende checkdoes.- Go to definition on a bytes, text or CSS import opens the imported file.
Desktop
- Updates:
- Updates apply in the same launch. A downloaded update used to run one launch late, and rollback never covered it. The app now restarts into the staged update right away.
- A bad update rolls back. An update is confirmed only after its main module has run (top-level
awaitincluded) and the event loop has turned once. An update that throws at startup, rejects in top-levelawaitor leaves an unhandled rejection is rolled back. A failed rollback is no longer reported as done. - An update that was rolled back isn’t staged again, so it no longer crashes every other launch until the release server changes. It’s still downloaded on each check, then refused.
- A second copy of the app started while an update’s first launch is still running no longer rolls back the good update.
- On Windows,
Ende.autoUpdatenow logs that auto-update isn’t supported on Windows yet, instead of "no version in ende.json". - On macOS, an app that restarts into an update now relaunches through LaunchServices, so its tray icon survives the update. The restarted app gets the same environment as a Finder or Dock launch, not the old process’s, and an app started from a terminal no longer shows its output or exit status after an update restart. This applies to updates from this version on: the old version does the restart.
- Windows and events:
- The window
closeevent is cancelable. A listener can callpreventDefault()to keep the window open (for example, to ask about unsaved changes). If JS doesn’t answer within 5 seconds, the window closes anyway, so a hung app can still be closed.win.close()fires no event. - A WebGPU window that the 5-second timeout hid counts as closed, so a late
closelistener can’t leave it hidden for good. - A WebGPU render loop keeps running while its window is hidden, minimised or covered.
getCurrentTexture()used to throw every frame, which exited the app. getNativeWindow()on the webview and CEF backends throws an error saying it needs the raw backend, and how to select it.- The initial window is no longer shown a second time 10 seconds after it loaded.
- Discrete events (such as close requests) are never dropped when the queue is full.
- The WebGPU surface is created on the UI thread.
- Desktop APIs called outside the main thread throw instead of crashing.
- The window
- Notifications:
close()fires thecloseevent.- A notification that the system didn’t show gets an
errorevent. - On macOS, the raw backend refuses notifications (
Notification.permissionis"denied"and the notification gets anerrorevent).new Notification()used to hang the app there. - Closing a notification no longer blocks.
- Other runtime fixes:
- The uncaught-error dialog shows again.
Dock.setBadge(null)clears the badge.- A desktop app’s missing-permission errors and prompts name
ende desktopinstead ofende compile.
- Build and config:
desktop.output.<os>anddesktop.app.icons.<os>are picked by--target, not by the build host, and--all-targetsapplies them per target. A Windows MSI built on macOS used the macOS icon.desktop.app,app.icons,output,release,errorReportingandmacosmust be objects. An array used to be read field by field. Errors inside them name the key.- The config schema has the desktop keys it lacked (
errorReporting,macos, therawbackend, icon sets), so editors no longer flag valid configs.
- macOS:
- The raw backend gets a minimal
.appbundle, and its first download no longer warns about re-signing. - Webview bundles get the JIT entitlement, and so do CEF helper apps when signed with a Developer ID.
- The raw backend gets a minimal
- Windows:
- Each app gets its own WebView2 data folder (
%LOCALAPPDATA%\<identifier>\WebView2), so apps installed under Program Files no longer open a white window. Processes the app starts don’t inherit the folder setting. - The app icon is embedded in the exe and the MSI, and shows in Apps & features.
- The MSI no longer installs build marker files, and Windows Installer checks the app’s exe to decide whether it’s installed.
ende desktop --hmrandende desktop --inspectshow console output.- Stopping a dev run also ends the backend’s process tree.
- Each app gets its own WebView2 data folder (
- Linux:
- Deep links (
desktop.app.deepLinks) work for installed.deband.rpmpackages. They were registered only in a copy the desktop never reads. - Packages no longer install build marker files.
- The
.desktopentry’sName=usesdesktop.app.name. - Wayland shows the configured icon (app_id is set).
- Packages built on Windows write symlink targets with
/.
- Deep links (
Packaging and releases
- Every
ende,endertandlibendertzip now containsLICENSE.mdandNOTICE. NOTICE holds Ende’s third-party notices, followed by TypeScript’sNOTICE.txt(Apache-2.0), and credits the LGPL-2.1 sine and cosine routines V8 takes from glibc. Those are linked intoendebut unused unless--v8-flags=--use-libm-trig-functionsis passed. The installers,ende upgradeandende compileignore both files. - The release binary is about 7.5 MB larger, because it includes the compressed TypeScript 7 compiler.
Security and dependencies
- WebSocket: a connection fails when the server’s
Sec-WebSocket-Acceptdoesn’t match. - Permissions: a doubled comma in path flags (
--allow-read=a,,bfor the patha,b) works again.ende installandende xused to split such a path in two, which granted paths the user never named and undid a deny. Both now escape it. - JSR: a JSR package can no longer reach non-JSR remote code through an inline module. The check that blocks such imports now also applies to
data:andblob:modules a JSR module imports, and to their imports. - Cache: remote lockfile hashes are checked after charset decoding.
ENDE_SERVE_ADDRESS: it no longer applies toEnde.servein Workers.memory:<host>addresses are reserved for the desktop runtime: set in the environment (or withEnde.env.set), one is refused with an error and the server listens where it asked.- Desktop: laufey archives with absolute entry names are refused.
- Dependencies: hyper 1.11.1, hyper-util 0.1.21.
Internal: CI now lints on Windows and runs the Windows-only Rust and unit tests on pushes to primary, plus fixes to the test harness and the release tooling.
Full Changelog: v2026.11.06...v2026.11.10