This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

Release 5.4.0

1st September 2025 at 12:00am

See the detailed change history on GitHub and other releases.

Introduction

Release v5.4.0 is an important release because it deliberately and forensically loosens backwards compatibility where needed to allow significant new features and fundamental improvements to be made.

Please note that this release note is not yet fully completed, please see the change history on GitHub for the full list of changes included in this release.

See the project plan for full details.

Changes

Plugin

EnhancementUpdate highlightjs plugin

GitHub:

Update highlightjs version to 11.11.1

BugfixMarkdown: Fix missing inline support and macrocall args parsing error

GitHub:
  • Fix markdown parser to respect parseAsInline option #8917.
  • Fix improper parsing of macrocall, whenenver args contain > character.
  • Use $tw.log.MARKDOWN flag to enable debug messages.

DeprecationPurge deprecated plugins and editions

Impact:
deprecation: The purged deprecated plugins are no longer availabe in the official plugin library
GitHub:

Remove deprecated plugins and editions and some legacy plugins, including:

Usability

EnhancementSet modal's mask-closable attribute to yes by default

GitHub:

EnhancementImprove switcher (UI) accessibility

GitHub:

Theme

EnhancementReplace CSS property macros in Snow White theme

GitHub:

EnhancementUse currentColor to style SVG

Impact:
compatibility-break: SVG icons will inherit colors instead of using #333333 if its parent element has color property set
GitHub:

Replaces hardcoded fill attributes with one fill: currentColor rule to solve the compatibility issues of migrating to lucide icons.

Widget

EnhancementAllow button widget to use all aria attributes

GitHub:

EnhancementAllow link widget to use all aria attributes

GitHub:

Allow LinkWidget to use all aria attributes directly.

DeprecationRemove support for Internet Explorer in RangeWidget

Impact:
compatibility-break: RangeWidget will not work on Internet Explorer 10
GitHub:

BugfixFix widgets generating leading space in class attribute when additional class is empty

GitHub:

Fixed a bug in the RevealWidget, DroppableWidget, EventcatcherWidget, and KeyboardWidget where an empty class attribute would generate a leading space in the rendered HTML. By trimming the resulting class string, we shorten the HTML and avoid potential confusion.

Filters

BugfixModify output of some math operators for empty inputs

Impact:
compatibility-break: filter output with empty input changes for some math filter operators

These math operators will now output an empty list when the input list is empty:

  • sum[] - previously returned 0
  • product[] - previously returned 1
  • maxall[] - previously returned -Infinity
  • minall[] - previously returned Infinity
  • average[] - previously returned NaN
  • variance[] - previously returned NaN
  • standard-deviation[] - previously returned NaN
GitHub:

The following math operators are changed to output an empty list when the input list is empty:

  • sum[]
  • product[]
  • maxall[]
  • minall[]
  • average[]
  • variance[]
  • standard-deviation[]

FeatureAdded jsondelete operator for deleting properties from JSON objects

GitHub:

Added the jsondelete operator for deleting properties from JSON strings. The operator uses the same code path as jsonset to locate the correct part of the object, ensuring consistency between setting and deleting operations. It supports deleting both object properties and array elements, with support for negative array indexes counted from the end.

Node.js

EnhancementWeb server get-file route now supports HTTP Range headers and streaming

GitHub:

The web server's get-file route now supports HTTP Range requests and file streaming, enabling better loading and playback of large media files.

Features

  • HTTP Range header: Enables partial content delivery with 206 Partial Content responses, which is used when the user drags the progress bar in video/audio playback
  • Streaming file delivery: Browsers can now properly seek and stream video files from the /files/ directory. Files are read using Node.js streams for better performance and memory efficiency.
  • Resumable downloads: To save interrupted downloads

BugfixFix crash when processing large files from tiddlywiki.files

GitHub:
  • skip reading file content when _canonical_uri is present
  • skip loading file when file size is too large

Internal

PerformanceUse sticky flag to improve regexp search performance

Impact:
compatibility-break: Tiddlywiki no longer works on old browsers that doesn't support sticky flag.
GitHub:

DeprecationRender s tag instead of strike

Impact:
compatibility-break: CSS rules using strike selector will broken

strike should be replaced by s.

GitHub:

PerformanceOffload server-only components to a plugin

Impact:
pluginisation: Server components of the core have been moved into a new $:/core-server plugin

It is not necessary for wikis to explicitly include the $:/core-server plugin.

GitHub:

This change reduces the size of the core plugin by 119.3KB or about 4.5%.

EnhancementFix nested span.tc-keyboard element in core

GitHub:

Removes nested <span class="tc-keyboard"> element in core search field.

PerformanceSwitch to native support for converting utf-8 between base64

Impact:
compatibility-break: Encoding & decoding base64 no longer works on browsers that doesn't support TextEncoder or TextDecoder
GitHub:

Replace base64-utf8 module with TextEncoder method to convert between utf-8 and Base64.

EnhancementSplit release notes into individual change notes

GitHub:

Doing so enables us to filter and group changes. For example, we could show all the breaking changes between two releases.

BugfixLet tiddler modules overwrite shadow modules with the same exports but different names

GitHub:

Tiddlers were previously processed before shadows during module registration. The shadow modules registration algorithm only checked for a matching title to prevent overwriting, but a differently named tiddler with the same exports would be overwritten by a shadow. This change swaps the order of $tw.wiki.defineTiddlerModules() and $tw.wiki.defineShadowModules() in boot.js, so that tiddlers are processed after shadows and can therefore override them.

Each group (tiddlers or shadows) is sorted alphabetically, so plugin shadows would previously correctly overwrite core shadows (assuming their name starts with $:/plugins/), which remains unchanged. This change only affects module tiddlers that have the same export as a shadow, but a different name.

PerformanceRemove redundant code in format/json.js

GitHub:

Remove redundant code in core/modules/filters/format/json.js.

DeprecationRemove Opera & Microsoft prefix in browser.js

GitHub:

Remove Opera & Microsoft prefix in $:/core/modules/utils/dom/browser.js.

BugfixFix markup not included in external core edition

GitHub:

Fix the problem that tiddlywiki's raw markup shadow tiddlers in $:/core is not included in HTML.

Developer

FeatureAdd ability to serialize WikiText AST nodes back to wikitext strings

GitHub:

This PR introduces a new utility $tw.utils.serializeWikitextParseTree() that can convert WikiText Abstract Syntax Tree (AST) nodes back into wikitext strings.

There is also a utility serializeAttribute for a single attribute node, like an attribute of a widget.

Use Cases

  • Programmatically manipulating wikitext content by modifying the AST, and use this to write it back
  • Building WYSIWYG editors
  • Creating wikitext formatters and linters

Implementation

  • New core plugin tiddlywiki/wikitext-serialize containing most of the logic
  • Separate serialize handlers for each WikiText rule as module-type: wikiruleserializer
  • Test suite with tag $:/tags/wikitext-serialize-test-spec
  • It uses each parser's name as rule (nextMatch.rule.name), each AST node that needs serialization has a type property matching the rule name
    • HTML tags and widgets are handled by the html serializer

Example Usage

// Parse a tiddler's wikitext to AST
var parseTree = $tw.wiki.parseTiddler("MyTiddler").tree;

// Serialize AST back to wikitext string
var wikitextString = $tw.utils.serializeWikitextParseTree(parseTree).trimEnd();

This feature offers new tools for JS plugin developers. It is not a user-facing change.

EnhancementAdd support for commands and startups which return promises

GitHub:

This adds support for async functions to commands and startups.

In both synchronous: true and synchronous: false mode, if you return a promise (manually or by using the async keyword), it will wait for the promise to resolve, and then proceed using the resolved value as the return value of the function.

Importantly, in synchronous: false mode, returning a promise will not change the callback behavior. So you can safely use an async function and still call the callback to continue execution.

Previously, in synchronous: true mode, returning a promise would have just logged the promise to console and halted execution. Now the promise will be awaited, and if the value is truthy, it will be logged to console and halt execution. If the promise resolves to a falsy value, execution will continue. This is the main breaking change, but since logging an opaque promise to console is the most useless of all error messages, this is unlikely to seriously break anything in practice. Throwing anything, truthy or not, will still stop execution (in synchronous: true mode).

This also does not add any error handling code. Rejected promises should still be logged to console as unhandled rejections just as uncaught exceptions are currently.

EnhancementUpdate ESLint target to ES2017

GitHub:

Updates the eslint config to check for syntax newer than ES2017. This uses a plugin to check for newer syntax, for better error messages, and may need to be updated regularly along with eslint to catch the latest features.

DeprecationDeprecate CSS macros supported in 2017 baseline

Impact:
deprecation: Currently all the CSS property macros are deprecated
GitHub:

Mark CSS macros supported in 2017 baseline as deprecated. They are moved to $:/core/macros/deprecated now.

EnhancementMigrate most deprecated rules

GitHub:

Migrate eslint deprecated rules (except for nodejs related rules). Format related rules are replaced by @stylistic/eslint-plugin.

EnhancementRepacking plugins should update modified timestamp

GitHub:

This PR modifies $tw.utils.repackPlugin() so that it adds the standard tiddler modification fields to plugin tiddlers when they are repacked.

Acknowledgements

A warm thank you to the developers who have contributed to this release:

  1. @andrewgoz
  2. @Arlen22
  3. @cdruan
  4. @Jermolene
  5. @Leilei332
  6. @linonetwo
  7. @SmartDever02
  8. @yaisog