tiddlywiki 5.4.0 → 5.4.1

package/editions/ja-JP/tiddlers/wikitext/Description Lists in WikiText.tid

@@ -1,16 +1,46 @@
 caption: 説明リスト
 created: 20131205160424246
-modified: 20260221103246354
-original-modified: 20251229110936191
+modified: 20260409111112126
+original-modified: 20260405082055301
 tags: WikiText
 title: Description Lists in WikiText
 ja-title: Wikiテキストでの説明リスト
 type: text/vnd.tiddlywiki
 
+!! 基本的な構文
+
 HTML説明リスト(<abbr title="またの名を">別名</abbr> 定義リスト)は次の構文で作成できます:
 
 <<wikitext-example src:"; 説明する用語
 : その用語の説明/定義
 ; 別の用語
 : 別の説明/定義
-">>
+">>
+
+!! 複数の用語と説明
+
+1つの用語に対して複数の説明を作成することも、1つの説明に対して複数の用語を作成することもできます:
+
+<<wikitext-example src:"; ねずみ
+: 体が小さく尾が長い齧歯類
+: コンピュータを操作するために使用するポインティングデバイス
+; りんご
+; なし
+: バラ科に属する果物の一種
+">>
+
+!! 入れ子になった説明リスト
+
+説明リストはネストして、リストの中にリストを作成することもできます:
+
+<<wikitext-example src:"; コーヒー
+: 焙煎したコーヒー豆から作られた飲み物
+:; ブラックコーヒー
+:: 添加物を一切使用しないコーヒー
+:; ミルクコーヒー
+:: コーヒーにスチームミルクやフォームミルクを加えたもの
+::; ラテ
+::: エスプレッソとスチームミルクで作ったコーヒー
+; ティー
+: 一般的に茶葉から作られる飲み物
+">>

package/editions/ja-JP/tiddlers/wikitext/Formatting in WikiText.tid

@@ -40,7 +40,7 @@ type: text/vnd.tiddlywiki
 |`__下線テキスト__`には二重アンダースコアを使用します|`<u>下線テキスト<u>` |
 |`^^上付き文字^^`テキストには二重サーカムフレックスアクセントを使用します |`<sup>上付き文字</sup>`テキストには二重サーカムフレックスアクセントを使用します |
 |`,,下付き文字,,`テキストには二重カンマを使用します |`<sub>下付き文字</sub>`テキストには二重カンマを使用します |
-|`~~取り消し線~~`テキストには二重チルダ記号を使用します |`<strike>取り消し線</strike>`テキストには二重チルダ記号を使用します |
+|`~~取り消し線~~`テキストには二重チルダ記号を使用します |`<s>取り消し線</s>`テキストには二重チルダ記号を使用します |
 |```等幅文字` ``には単一のバッククォートを使用します |`<code>等幅文字</code>`には単一のバッククォートを使用します |
 |`@@ハイライト@@`するには二重@記号を使用します |`<span class="tc-inline-style">ハイライト</span>`するには二重@記号を使用します |
 

package/editions/ja-JP/tiddlers/wikitext/Lists in WikiText.tid

@@ -1,7 +1,7 @@
 caption: リスト
 created: 20131205160257619
-modified: 20260225114001626
-original-modified: 20160607093103220
+modified: 20260409112505342
+original-modified: 20260405094604397
 tags: WikiText Lists
 title: Lists in WikiText
 ja-title: Wikiテキストでのリスト
@@ -45,6 +45,10 @@ type: text/vnd.tiddlywiki
 #** そしてもう一つ
 ">>
 
+! 説明リスト
+
+{{Description Lists in WikiText}}
+
 ! CSSクラス
 
 次の表記法を使用して、リストの個々のメンバーにCSSクラスを割り当てることもできます: 

package/editions/ja-JP/tiddlers/wikitext/Macro Calls.tid

@@ -2,59 +2,8 @@ caption: マクロ呼び出し
 created: 20150220182252000
 modified: 20260321104805874
 original-modified: 20230419103154328
-tags: WikiText Macros
 title: Macro Calls
 ja-title: マクロ呼び出し
 type: text/vnd.tiddlywiki
 
-!! 紹介
-
-このTiddlerでは、[[マクロ|Macros]]を呼び出すさまざまな方法について説明します。
-
-!! マクロ呼び出しトランスクルージョンのショートカット
-
-[[マクロ|Macros]]を呼び出すには、マクロ名とパラメータ値を`<<`二重山括弧`>>`で囲みます。
-
-```
-<<mymacro param:"これはパラメータ値です">>
-```
-
-デフォルトでは、パラメータはマクロの定義と同じ順序でリストします。パラメータに名前とコロンを付けることで、異なる順序でリストすることも可能です。
-
-パラメータに値が指定されていない場合は、[[マクロ定義|Macro Definitions]]でそのパラメータに指定されているデフォルト値が代わりに使用されます。(デフォルト値が定義されていない場合は、パラメータはブランクになります。)
-
-各パラメータ値は、`'`シングルクォーテーション`'`、`"`ダブルクォーテーション`"`、`"""`三重ダブルクォーテーション`"""`、または`[[`二重角括弧`]]`で囲むことができます。三重ダブルクォーテーションを使用すると、値にほぼあらゆる文字列を含めることができます。値にスペース、シングルクォーテーション、ダブルクォーテーションが含まれていない場合は、区切り文字は必要ありません。
-
-この構文の正式な[[説明|Macro Call Syntax]]も利用可能です。
-
-[[パーサーモード|WikiText parser mode: macro examples]]に関する[[例|Macro Calls in WikiText (Examples)]]と議論を参照してください。
-
-!! <<.wlink TranscludeWidget>>ウィジェットを用いたマクロ呼び出し
-
-ショートカット構文は、トランスクルードするマクロの名前を指定する`$variable`属性を持つ<<.wlink TranscludeWidget>>ウィジェットに展開されます。
-
-```
-<$transclude $variable="mymacro" param="これはパラメータ値です"/>
-```
-
-ウィジェット自体は、パラメータ値を指定できるなど、ショートカット構文よりも柔軟です。
-
-!! 属性値にマクロ呼び出しを割り当てる
-
-マクロの実行結果は、ウィジェットやHTML要素の属性に割り当てることができます。マクロの実行結果はWiki変換されませんが、[[パラメータの置換|Macro Parameter Handling]]は実行されます。
-
-```
-<div class=<<myclasses "Horizontal">>>
-...
-</div>
-```
-
-!! フィルターでマクロ呼び出しを使用する
-
-マクロ呼び出しはフィルタ内で使用できます:
-
-```
-<$list filter="[<mymacro param:'value'>]">
-...
-</$list>
-```
+<<.deprecated-since "5.4.0" "Calls">>

package/editions/ja-JP/tiddlers/wikitext/Multi-Valued Variable Attribute Values.tid

@@ -0,0 +1,39 @@
+created: 20250208120000000
+modified: 20260507110511201
+original-modified: 20250208120000000
+tags: WikiText [[Widget Attributes]]
+title: Multi-Valued Variable Attribute Values
+ja-title: 複数値変数の属性値
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.4.0">> 複数値変数の属性値は、変数名を二重の丸括弧で囲むことで指定できるようになりました。これにより、[[複数値変数|Multi-Valued Variables]]の最初の値だけでなく、すべての値が属性に渡されます。
+
+```
+<$transclude $variable="myproc" items=((myvar))/>
+```
+
+これは、下位互換性のために最初の値のみを返す[[変数の属性値|Variable Attribute Values]]構文`<<var>>`の複数値版です。この関係は、`<var>`が単一の値を返し、`(var)`がすべての値を返すフィルタオペランドの既存の慣例を反映しています。
+
+! 複数値変数非対応の属性
+
+`((var))`が複数値変数をサポートしていないウィジェット属性([[textウィジェット|TextWidget]]の`text`属性など)で使用される場合、最初の値のみが使用されます: 
+
+```
+<$text text=((myvar))/>
+```
+
+! プロシージャに複数値変数を渡す
+
+この構文の主なユースケースは、複数の値を持つ変数を`$transclude`パイプラインを通してプロシージャや関数に渡すことです:
+
+```
+\procedure showItems(itemList)
+<$text text={{{ [(itemList)join[-]] }}}/>
+\end
+
+<$let items={{{ [all[tiddlers]sort[]] }}}>
+<$transclude $variable="showItems" itemList=((items))/>
+</$let>
+```
+
+この例では、`items`に格納されているTiddlerタイトルの完全なリストが`showItems`プロシージャの`itemList`パラメータに渡されます。 

package/editions/ja-JP/tiddlers/wikitext/Tables in WikiText CSS Utility Classes.tid

@@ -1,5 +1,5 @@
 created: 20220817153236691
-modified: 20260404112841923 
+modified: 20260409114243582
 original-modified: 20221010074314452
 tags: [[Tables in WikiText]]
 title: Tables in WikiText CSS Utility Classes
@@ -81,3 +81,14 @@ full-tiddler-widthである表に、左右の余白を追加するには、`tc-m
 | セル1|<$edit-text tiddler="$:/temp/test-table-input" tag="input" field="test"/> |
 |^ [[Tiddlerへのリンク|Link to a tiddler]]<br>さらに詳しい説明|<$edit-text tiddler="$:/temp/test-table-input" field="text"/>  |
 """>>
+
+!! 行スタイルを交互にした表
+
+独自のスタイルシートを作成する必要があります。[[スタイルシートの使用|Using Stylesheets]]を参照してください。考え方は、`:nth-of-type(even/odd)`を使用してルールを作成することです。例:
+
+```
+.myclass tbody tr:nth-of-type(even) { background-color: <<color tiddler-editor-fields-even>>; }
+.myclass tbody tr:nth-of-type(odd) { background-color: <<color tiddler-editor-fields-odd>>; }
+```
+
+<<.note """~TiddlyWikiは、テーブルの行に`evenRow`クラスと`oddRow`クラスを自動的に適用します。ただし、これらのクラスの使用は推奨されません。行は'even'(想定とは逆)で始まり、ヘッダー、フッター、本文のいずれに表示されるかに関わらず、テーブルのすべての行は単一の結合された行セットとして扱われます。""">>

package/editions/ja-JP/tiddlers/wikitext/Transclusion in WikiText.tid

@@ -66,6 +66,28 @@ or, when used with a template, `{{{ [tag[mechanism]]||TemplateTitle }}}` expands
 
 <<.tip "//Internals//プラグインをインストールすると、生成されたウィジェットツリーをエディターのプレビューペインに表示できます">>
 
+!! 複数値変数の表示
+
+<<.from-version "5.4.0">> `((var))`構文をインラインで使用して、[[複数値変数|Multi-Valued Variables]]の値を、デフォルトではカンマとスペースで連結して表示できるようになりました:
+
+```
+((myvar))
+((myvar||:))
+```
+
+オプションの`||`区切り文字は、カスタムの区切り文字を指定します。
+
+!! インラインフィルター表示
+
+<<.from-version "5.4.0">> `(((filter)))`構文によりフィルタ式の結果をデフォルトではカンマとスペースで連結してインラインで表示します:
+
+```
+((( [all[tiddlers]sort[]] )))
+((( [all[tiddlers]sort[]] ||: )))
+```
+
+オプションの`||`区切り文字は、カスタムの区切り文字を指定します。これは、フィルタリングされたトランスクルージョン構文`{{{ }}}`に対応するインライン表示の表現です。
+
 ---
 
 参照:

package/editions/ja-JP/tiddlers/wikitext/Widget Attributes.tid

@@ -13,6 +13,7 @@ type: text/vnd.tiddlywiki
 * [[マクロ/変数のトランスクルージョン|Variable Attribute Values]]
 * [[フィルター式の結果として|Filtered Attribute Values]]
 * <<.from-version "5.3.0">> [[指定された文字列に対してフィルタと変数置換を実行した結果として|Substituted Attribute Values]]
+* <<.from-version "5.4.0">> [[複数値変数の参照として|Multi-Valued Variable Attribute Values]]
 
 |属性タイプ|構文|h
 |リテラル |スペースを含まない値には、シングルクォーテーション、ダブルクォーテーション、トリプルクォーテーション、またはクォーテーションなし |
@@ -20,9 +21,9 @@ type: text/vnd.tiddlywiki
 |変数 |マクロまたは変数呼び出しを囲む二重の山括弧 |
 |フィルタリング結果 |フィルター式を囲む三重の中括弧|
 |置換結果|置換処理を行うテキストの、単一または三重のバッククォート|
+|複数値変数 |変数名を囲む二重の丸括弧 |
 
-
-<$list filter="[[Literal Attribute Values]] [[Transcluded Attribute Values]] [[Variable Attribute Values]] [[Filtered Attribute Values]] [[Substituted Attribute Values]]">
+<$list filter="[[Literal Attribute Values]] [[Transcluded Attribute Values]] [[Variable Attribute Values]] [[Filtered Attribute Values]] [[Substituted Attribute Values]] [[Multi-Valued Variable Attribute Values]]">
 <$link><h1><$view tiddler=<<currentTiddler>> field=ja-title/></h1></$link>
 <$transclude mode="block"/>
 </$list>

package/editions/prerelease/tiddlers/system/PrereleaseLocalPluginLibrary.tid

@@ -1,6 +1,6 @@
 title: $:/config/LocalPluginLibrary
 tags: $:/tags/PluginLibrary
-url: http://127.0.0.1:8080/prerelease/library/v5.4.0/index.html
+url: http://127.0.0.1:8080/prerelease/library/v5.4.1/index.html
 caption: {{$:/language/OfficialPluginLibrary}} (Prerelease Local)
 
 A locally installed version of the official ~TiddlyWiki plugin library at tiddlywiki.com for testing and debugging. //Requires a local web server to share the library//

package/editions/prerelease/tiddlers/system/PrereleaseOfficialPluginLibrary.tid

@@ -1,6 +1,6 @@
 title: $:/config/OfficialPluginLibrary
 tags: $:/tags/PluginLibrary
-url: https://tiddlywiki.com/prerelease/library/v5.4.0/index.html
+url: https://tiddlywiki.com/prerelease/library/v5.4.1/index.html
 caption: {{$:/language/OfficialPluginLibrary}} (Prerelease)
 
 The prerelease version of the official ~TiddlyWiki plugin library at tiddlywiki.com. Plugins, themes and language packs are maintained by the core team.

package/editions/test/playwright.spec.js

@@ -7,7 +7,7 @@ const crossPlatformIndexPath = indexPath.replace(/^\/+/, "");
 
 test("get started link", async ({ page }) => {
 	// The tests can take a while to run
-	const timeout = 1000 * 30;
+	const timeout = 1000 * 60;
 	test.setTimeout(timeout);
 
 	// Load the generated test TW html

package/editions/test/quick-test.js

@@ -0,0 +1,71 @@
+/*
+Fast test runner that boots the test edition and runs selected test specs.
+Skips the expensive --rendertiddler step from --build index.
+
+Usage:
+  node test-parser-quick.js [test-files...]
+
+Examples:
+  node test-parser-quick.js                                     # Run ALL specs
+  node test-parser-quick.js test-wikitext-parser                # Run one spec file
+  node test-parser-quick.js test-wikitext-parser test-filters   # Run multiple spec files
+*/
+
+"use strict";
+
+var $tw = require("../../boot/boot.js").TiddlyWiki();
+
+$tw.boot.argv = ["editions/test"];
+
+// Disable startup modules that aren't needed for tests
+$tw.boot.disabledStartupModules = [
+	"favicon", "password", "browser-messaging", "info",
+	"render", "rootwidget", "story", "windows"
+];
+
+$tw.boot.boot(function() {
+	var args = process.argv.slice(2);
+	var allTests = $tw.wiki.filterTiddlers("[all[tiddlers+shadows]type[application/javascript]tag[$:/tags/test-spec]]");
+
+	// Filter test tiddlers if arguments provided
+	var testsToRun;
+	if(args.length > 0) {
+		testsToRun = allTests.filter(function(title) {
+			return args.some(function(arg) {
+				return title.toLowerCase().indexOf(arg.toLowerCase()) !== -1;
+			});
+		});
+		if(testsToRun.length === 0) {
+			console.error("No test files matched: " + args.join(", "));
+			console.error("Available test files:");
+			allTests.forEach(function(t) { console.error("  " + t); });
+			process.exit(1);
+		}
+	} else {
+		testsToRun = allTests;
+	}
+
+	// Override the test filter to only include our selected tests
+	var titlesSet = Object.create(null);
+	testsToRun.forEach(function(t) { titlesSet[t] = true; });
+
+	var origFilterTiddlers = $tw.wiki.filterTiddlers.bind($tw.wiki);
+	$tw.wiki.filterTiddlers = function(filterString) {
+		var result = origFilterTiddlers.apply(null, arguments);
+		if(filterString.indexOf("$:/tags/test-spec") !== -1) {
+			return result.filter(function(t) { return titlesSet[t]; });
+		}
+		return result;
+	};
+
+	console.log("Running " + testsToRun.length + " of " + allTests.length + " test files");
+
+	// Use the jasmine plugin's own runTests function
+	var jasmine = $tw.modules.execute("$:/plugins/tiddlywiki/jasmine/jasmine-plugin.js");
+	jasmine.runTests(function(err) {
+		if(err) {
+			console.error(err);
+			process.exit(1);
+		}
+	});
+});

package/editions/test/tiddlers/tests/test-deprecated.js

@@ -0,0 +1,252 @@
+/*\
+title: test-deprecated.js
+type: application/javascript
+tags: [[$:/tags/test-spec]]
+
+Regression-guard tests for $:/core/modules/utils/deprecated.js.
+
+Locks in pre-5.4.0 tolerant behaviour of $tw.utils helpers that regressed
+in PR #9251 (one-line modern equivalents diverge on edge-case inputs).
+Without the companion restoration patch to core/modules/utils/deprecated.js:
+8 specs fail. With the patch: green.
+
+The addClass/removeClass/toggleClass specs at the end were moved from
+test-utils.js — RSOD guard for the SampleWizard report (class field
+"aaa bbb" crashing classList.add with InvalidCharacterError).
+
+\*/
+
+"use strict";
+
+describe("deprecated.js — backwards-compat",function() {
+
+	describe("$tw.utils.repeat",function() {
+		it("returns '' for zero or negative count (does not throw)",function() {
+			expect($tw.utils.repeat("x",0)).toBe("");
+			expect($tw.utils.repeat("x",-1)).toBe("");
+			expect($tw.utils.repeat("x",-100)).toBe("");
+		});
+		it("coerces null/undefined str rather than throwing",function() {
+			expect($tw.utils.repeat(null,3)).toBe("nullnullnull");
+			expect($tw.utils.repeat(undefined,2)).toBe("undefinedundefined");
+		});
+		it("still works for normal inputs",function() {
+			expect($tw.utils.repeat("ab",3)).toBe("ababab");
+			expect($tw.utils.repeat("-",5)).toBe("-----");
+		});
+	});
+
+	describe("$tw.utils.startsWith / $tw.utils.endsWith",function() {
+		it("tolerate a RegExp search argument without throwing",function() {
+			// Old impl uses substring coercion; native String.prototype.startsWith
+			// throws TypeError when passed a RegExp.
+			expect(function() { $tw.utils.startsWith("abc",/a/); }).not.toThrow();
+			expect(function() { $tw.utils.endsWith("abc",/c/); }).not.toThrow();
+		});
+		it("still match normal string inputs",function() {
+			expect($tw.utils.startsWith("abcdef","abc")).toBe(true);
+			expect($tw.utils.startsWith("abcdef","xyz")).toBe(false);
+			expect($tw.utils.endsWith("abcdef","def")).toBe(true);
+			expect($tw.utils.endsWith("abcdef","xyz")).toBe(false);
+		});
+	});
+
+	describe("$tw.utils.stringifyNumber",function() {
+		it("coerces null/undefined via string-concat rather than throwing",function() {
+			expect($tw.utils.stringifyNumber(null)).toBe("null");
+			expect($tw.utils.stringifyNumber(undefined)).toBe("undefined");
+		});
+		it("still returns a number's string form",function() {
+			expect($tw.utils.stringifyNumber(42)).toBe("42");
+			expect($tw.utils.stringifyNumber(-3.14)).toBe("-3.14");
+			expect($tw.utils.stringifyNumber(0)).toBe("0");
+		});
+	});
+
+	describe("$tw.utils.domContains",function() {
+		// Stub nodes expose both .contains() and .compareDocumentPosition() so
+		// both the old (compareDocumentPosition & 16 → number) and new
+		// (a !== b && a.contains(b) → boolean) forms can be observed.
+		function makeNode(children) {
+			children = children || [];
+			var self;
+			self = {
+				contains: function(other) {
+					if(other === self) { return true; }
+					return children.some(function(c) { return c === other || c.contains(other); });
+				},
+				compareDocumentPosition: function(other) {
+					if(other === self) { return 0; }
+					return self.contains(other) ? 16 : 0;
+				}
+			};
+			return self;
+		}
+		it("returns strictly boolean true/false, not a bit-mask number",function() {
+			var child = makeNode();
+			var parent = makeNode([child]);
+			var unrelated = makeNode();
+			expect($tw.utils.domContains(parent,child)).toBe(true);
+			expect($tw.utils.domContains(parent,unrelated)).toBe(false);
+		});
+		it("returns false for domContains(x, x)",function() {
+			var a = makeNode();
+			expect($tw.utils.domContains(a,a)).toBe(false);
+		});
+	});
+
+	describe("$tw.utils.hasClass",function() {
+		it("returns false for null/undefined element without throwing",function() {
+			expect(function() { $tw.utils.hasClass(null,"foo"); }).not.toThrow();
+			expect($tw.utils.hasClass(null,"foo")).toBe(false);
+			expect(function() { $tw.utils.hasClass(undefined,"foo"); }).not.toThrow();
+			expect($tw.utils.hasClass(undefined,"foo")).toBe(false);
+		});
+		it("returns strictly false (not undefined) for elements without classList",function() {
+			expect($tw.utils.hasClass({},"foo")).toBe(false);
+		});
+		it("delegates to classList.contains for real elements",function() {
+			var el = { classList: { contains: function(c) { return c === "a" || c === "b"; } } };
+			expect($tw.utils.hasClass(el,"a")).toBe(true);
+			expect($tw.utils.hasClass(el,"b")).toBe(true);
+			expect($tw.utils.hasClass(el,"c")).toBe(false);
+		});
+	});
+
+	// getLocationPath reads window.location: specs pend in Node (no `window`
+	// in the TW5 sandbox) and use history.replaceState in the browser —
+	// assigning to window.location would trigger a navigation and reload.
+	describe("$tw.utils.getLocationPath",function() {
+		var originalUrl;
+		beforeEach(function() {
+			if(!$tw.browser) { return; }
+			originalUrl = window.location.href;
+		});
+		afterEach(function() {
+			if(!$tw.browser) { return; }
+			history.replaceState(null,"",originalUrl);
+		});
+		it("preserves the query string in the returned path",function() {
+			if(!$tw.browser) { pending("browser-only: requires window.location - run in browser"); return; }
+			history.replaceState(null,"","?lang=de&x=1#Intro");
+			var path = $tw.utils.getLocationPath();
+			expect(path).toContain("?lang=de&x=1");
+			expect(path).not.toContain("#Intro");
+		});
+		it("strips the hash fragment",function() {
+			if(!$tw.browser) { pending("browser-only: requires window.location - run in browser"); return; }
+			history.replaceState(null,"","#SomeTiddler");
+			// Sanity check: replaceState actually changed the hash.
+			expect(window.location.hash).toBe("#SomeTiddler");
+			var path = $tw.utils.getLocationPath();
+			expect(path).not.toContain("#");
+			// Rebuild expected href without the hash — works on http(s):// and file://.
+			var expected = window.location.href.split("#")[0];
+			expect(path).toBe(expected);
+		});
+		it("includes the query string when no hash is present",function() {
+			if(!$tw.browser) { pending("browser-only: requires window.location - run in browser"); return; }
+			history.replaceState(null,"","?x=1");
+			var path = $tw.utils.getLocationPath();
+			expect(path).toMatch(/\?x=1$/);
+			expect(path).not.toContain("#");
+		});
+	});
+
+	// Regression guard: classList.add/remove/toggle throw InvalidCharacterError on
+	// whitespace. Manual repro: tw5-com #SampleWizard, class="aaa bbb", Done, popup
+	// -> OK -> nested popup -> RSOD. Stub classList mirrors real DOM semantics
+	// (reject whitespace, de-dupe on add, no-op on remove of missing token).
+	describe("addClass/removeClass/toggleClass",function() {
+		function makeEl() {
+			var tokens = [];
+			function reject(t) { if(/\s/.test(t)) { throw new Error("InvalidCharacterError: '" + t + "'"); } }
+			return {
+				classList: {
+					add: function() {
+						for(var i = 0; i < arguments.length; i++) {
+							reject(arguments[i]);
+							if(tokens.indexOf(arguments[i]) === -1) { tokens.push(arguments[i]); }
+						}
+					},
+					remove: function() {
+						for(var i = 0; i < arguments.length; i++) {
+							reject(arguments[i]);
+							var idx = tokens.indexOf(arguments[i]);
+							if(idx !== -1) { tokens.splice(idx,1); }
+						}
+					},
+					toggle: function(cls,status) {
+						reject(cls);
+						var has = tokens.indexOf(cls) !== -1;
+						var want = status === undefined ? !has : status;
+						if(want && !has) { tokens.push(cls); }
+						if(!want && has) { tokens.splice(tokens.indexOf(cls),1); }
+					}
+				},
+				_tokens: tokens
+			};
+		}
+
+		it("splits on every ASCII-whitespace flavour (space, tab, newline, CR, mixed runs, leading/trailing)",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"  a\tb\nc\r\nd  \t  e  ");
+			expect(el._tokens).toEqual(["a","b","c","d","e"]);
+		});
+
+		it("splits on Unicode whitespace too (U+00A0 non-breaking space, a common paste-in hazard)",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"a\u00A0b");
+			expect(el._tokens).toEqual(["a","b"]);
+		});
+
+		it("de-duplicates tokens within one call and across calls",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"x x y");
+			$tw.utils.addClass(el,"y z");
+			expect(el._tokens).toEqual(["x","y","z"]);
+		});
+
+		it("remove is a no-op for missing tokens and tolerates mixed-presence input",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"a b");
+			$tw.utils.removeClass(el,"b c d");
+			expect(el._tokens).toEqual(["a"]);
+		});
+
+		it("toggle with no status flips each token independently",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"a");
+			$tw.utils.toggleClass(el,"a b");
+			expect(el._tokens).toEqual(["b"]);
+		});
+
+		it("toggle with status=true/false forces state regardless of current",function() {
+			var el = makeEl();
+			$tw.utils.addClass(el,"a");
+			$tw.utils.toggleClass(el,"a b",true);
+			expect(el._tokens).toEqual(["a","b"]);
+			$tw.utils.toggleClass(el,"a b",false);
+			expect(el._tokens).toEqual([]);
+		});
+
+		it("is a silent no-op for whitespace-only / empty / non-string / null / undefined className",function() {
+			var el = makeEl();
+			var inputs = ["", "   \t\n ", null, undefined, 42, {}, ["a"]];
+			inputs.forEach(function(v) {
+				expect(function() { $tw.utils.addClass(el,v); }).not.toThrow();
+				expect(function() { $tw.utils.removeClass(el,v); }).not.toThrow();
+				expect(function() { $tw.utils.toggleClass(el,v); }).not.toThrow();
+			});
+			expect(el._tokens).toEqual([]);
+		});
+
+		it("is a silent no-op when element has no classList (SVG in old browsers, detached nodes, stubs)",function() {
+			var el = {};
+			expect(function() { $tw.utils.addClass(el,"a b"); }).not.toThrow();
+			expect(function() { $tw.utils.removeClass(el,"a b"); }).not.toThrow();
+			expect(function() { $tw.utils.toggleClass(el,"a b",true); }).not.toThrow();
+		});
+	});
+
+});