tiddlywiki 5.3.3 → 5.3.5

package/editions/tw5.com/tiddlers/system/operator-macros.tid

@@ -1,52 +1,66 @@
 created: 20150117152607000
-modified: 20230617183916622
+modified: 20240229132501000
 tags: $:/tags/Macro
+code-body: yes
 title: $:/editions/tw5.com/operator-macros
 
-\define .operator-examples(op,text:"Examples") <$link to="$op$ Operator (Examples)">$text$</$link>
+
+\whitespace trim
+
+\procedure .operator-examples(op,text:"Examples") <$link to=`$(op)$ Operator (Examples)`><<text>></$link>
 
 \procedure .operator-example-tryit-actions() <$action-setfield $tiddler=<<.state>> text="show" filter=<<eg>>/>
+
 \procedure .operator-example(n,eg,ie)
 <div class="doc-example">
-<$list filter="[title<.state-prefix>addsuffix{!!title}addsuffix[/]addsuffix<n>]" variable=".state">
-<$reveal state=<<.state>> type="nomatch" text="show">
-	<code><$text text=<<eg>>/></code>
-	<$macrocall $name=".if" cond=<<ie>> then={{{[[<dd>&rarr; ]addsuffix<ie>addsuffix[</dd>]]}}}/>
-	<dl>
-	<dd><$button actions=<<.operator-example-tryit-actions>>>Try it</$button></dd>
-	</dl>
-</$reveal>
-<$reveal state=<<.state>> type="match" text="show">
-	<$edit-text tiddler=<<.state>> field="filter" tag="input" type=search focus="true"/>
-	<dl>
-	<dd>
-	<$button set=<<.state>> setTo="">Hide</$button>
-	<$reveal stateTitle=<<.state>> stateField="filter" type="nomatch" text=<<eg>>>
-		<$button actions=<<.operator-example-tryit-actions>>>Reset</$button>
-	</$reveal>
-	</dd>
-	</dl>
-	<blockquote class="doc-example-result">
-	<ul><$list filter={{{[<.state>get[filter]]}}} emptyMessage="(empty)">
-	<li><$link><$view field="title"/></$link></li>
-	</$list></ul>
-	</blockquote>
-</$reveal>
-</$list>
+	<$list filter="[title<.state-prefix>addsuffix{!!title}addsuffix[/]addsuffix<n>]" variable=".state">
+		<$reveal state=<<.state>> type="nomatch" text="show">
+			<code><$text text=<<eg>>/></code>
+			<% if [<ie>!is[blank]] %>
+				<dd>&rarr;&nbsp;<<ie>></dd>
+			<% endif %>
+			<dl>
+				<dd><$button actions=<<.operator-example-tryit-actions>>>Try it</$button></dd>
+			</dl>
+		</$reveal>
+		<$reveal state=<<.state>> type="match" text="show">
+			<$edit-text tiddler=<<.state>> field="filter" tag="input" type=search focus="true"/>
+			<dl>
+				<dd>
+					<$button set=<<.state>> setTo="">Hide</$button>
+					<$reveal stateTitle=<<.state>> stateField="filter" type="nomatch" text=<<eg>>>
+						<$button actions=<<.operator-example-tryit-actions>>>Reset</$button>
+					</$reveal>
+				</dd>
+			</dl>
+			<blockquote class="doc-example-result">
+				<ul>
+					<$list filter={{{[<.state>get[filter]]}}} emptyMessage="(empty)">
+						<li><$link><$view field="title"/></$link></li>
+					</$list>
+				</ul>
+			</blockquote>
+		</$reveal>
+	</$list>
+</div>
 \end
 
-\define .inline-operator-example(eg)
-<code><$text text=<<__eg__>>/></code> evaluates to <$list filter=<<__eg__>> emptyMessage="(empty)"> <code><$text text=<<currentTiddler>>/></code> </$list>
+\procedure .inline-operator-example(eg)
+<code>
+	<$text text=<<eg>>/>
+</code>
+<span class="tc-tiny-gap">evaluates to</span>
+<$list filter=<<eg>> emptyMessage="(empty)">
+	<code class="tc-tiny-gap-left"><$text text=<<currentTiddler>>/></code>
+</$list>
 \end
 
 \define .this-is-operator-example() This example tiddler is used to illustrate some of the [[Filter Operators]].
 \define .using-days-of-week() These examples make use of the [[Days of the Week]] tiddler.
 \define .s-matching-is-case-sensitive() In looking for matches for <<.place S>>, capital and lowercase letters are treated as different.
 
-\define .node-only-operator()
+\procedure .node-only-operator()
 
 <$macrocall $name=".note" _="This operator is <<.em not>> available when ~TiddlyWiki is running in a web browser."/>
 
 \end
-
-<pre><$view field="text"/></pre>

package/editions/tw5.com/tiddlers/system/operator-template.tid

@@ -1,83 +1,64 @@
 created: 20150203173506000
+modified: 20240229155612000
 list-before: $:/core/ui/ViewTemplate/body
-modified: 20230602181119360
 tags: $:/tags/ViewTemplate
+code-body: yes
 title: $:/editions/tw5.com/operator-template
 
-\define .op-place()
-<$macrocall $name=".if"
-  cond="""$(op-name)$"""
-  then="<<.place '$(op-name)$'>> = "
-  else=""/>
+\whitespace trim
+
+\procedure .op-place()
+<% if [<op-name>!is[blank]] %>
+	<$macrocall $name=".place" _=<<op-name>> /><span class="tc-tiny-gap">=</span>
+<% endif %>
 \end
 
-\define .op-row()
-<$macrocall $name=".if"
-  cond="""$(op-body)$"""
-  then="""<tr><th align="left">$(op-head)$</th><td><<.op-place>>$(op-body)$</td></tr>"""
-  else=""/>
+\procedure .op-row()
+<% if [<op-body>!is[blank]] %>
+	<tr>
+		<th align="left"><<op-head>></th><td><<.op-place>><<op-body>></td>
+	</tr>
+<% endif %>
 \end
 
-<$set name="op-head" value="">
-<$set name="op-body" value="">
-<$set name="op-name" value="">
 <$list filter="[all[current]tag[Filter Operators]]">
-<table class="doc-table before-tiddler-body">
-<!-- -->
-<$set name="op-head" value="purpose">
-<$set name="op-body" value={{!!op-purpose}}>
-<<.op-row>>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="[[input|Filter Syntax]]">
-<$set name="op-body" value={{!!op-input}}>
-<<.op-row>>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="`!` input">
-<$set name="op-body" value={{!!op-neg-input}}>
-<<.op-row>>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="[[suffix|Filter Step]]">
-<$set name="op-body" value={{!!op-suffix}}>
-<$set name="op-name" value={{!!op-suffix-name}}>
-<<.op-row>>
-</$set>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="[[parameter|Filter Parameter]]">
-<$set name="op-body" value={{!!op-parameter}}>
-<$set name="op-name" value={{!!op-parameter-name}}>
-<<.op-row>>
-</$set>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="output">
-<$set name="op-body" value={{!!op-output}}>
-<<.op-row>>
-</$set>
-</$set>
-<!-- -->
-<$set name="op-head" value="`!` output">
-<$set name="op-body" value={{!!op-neg-output}}>
-<<.op-row>>
-</$set>
-</$set>
-<!-- -->
-</table>
-
-<p>[[Learn more about how to use Filters|Filters]]</p>
+	<$let op-head="" op-body="" op-name="">
+		<table class="doc-table before-tiddler-body">
+			<!-- purpose -->
+			<$let op-head="purpose" op-body={{!!op-purpose}}>
+				<<.op-row>>
+			</$let>
+			<!-- input -->
+			<$let op-head="[[input|Filter Syntax]]" op-body={{!!op-input}}>
+				<<.op-row>>
+			</$let>
+			<!-- input negated -->
+			<$let op-head="`!` input" op-body={{!!op-neg-input}}>
+				<<.op-row>>
+			</$let>
+			<!-- suffix -->
+			<$let op-head="[[suffix|Filter Step]]" op-body={{!!op-suffix}} op-name={{!!op-suffix-name}}>
+				<<.op-row>>
+			</$let>
+			<!-- parameter -->
+			<$let op-head="[[parameter|Filter Parameter]]" op-body={{!!op-parameter}} op-name={{!!op-parameter-name}}>
+				<<.op-row>>
+			</$let>
+			<!-- output -->
+			<$let op-head="output" op-body={{!!op-output}}>
+				<<.op-row>>
+			</$let>
+			<!-- output negated -->
+			<$let op-head="`!` output" op-body={{!!op-neg-output}}>
+				<<.op-row>>
+			</$let>
+		</table>
+		<p>
+			[[Learn more about how to use Filters|Filters]]
+		</p>
 
-<$list filter="[all[current]has[from-version]]" variable="listItem">
-<p><$macrocall $name=".from-version" version={{!!from-version}}/></p>
-</$list>
+		<$list filter="[all[current]has[from-version]]" variable="listItem">
+			<$macrocall $name=".from-version" version={{!!from-version}}/>
+		</$list>
+	</$let>
 </$list>
-</$set>
-</$set>
-</$set>

package/editions/tw5.com/tiddlers/system/variable-macros.tid

@@ -1,21 +1,26 @@
 created: 20150228114241000
 modified: 20220227210136243
 tags: $:/tags/Macro
+code-body: yes
 title: $:/editions/tw5.com/variable-macros
 
-\define .variable-examples(v,text:"Examples") <$link to="$v$ Variable (Examples)">$text$</$link>
-\define .macro-examples(m,text:"Examples") <$link to="$m$ Macro (Examples)">$text$</$link>
-\define .widget-examples(w,text:"Examples") <$link to="$w$ Widget (Examples)">$text$</$link>
+\procedure .variable-examples(v,text:"Examples") <$link to=`$(v)$ Variable (Examples)`><<text>></$link>
+\procedure .macro-examples(m,text:"Examples") <$link to=`$(m)$ Macro (Examples)`><<text>></$link>
+\procedure .widget-examples(w,text:"Examples") <$link to=`$(w)$ Widget (Examples)`><<text>></$link>
 
-\define .js-macro-link(_) [[$_$|https://tiddlywiki.com/dev/index.html#JavaScript%20Macros]]
-
-\define .this-is-static-link-variable() <<.tip "This variable has no useful effect when ~TiddlyWiki is running in a browser, as the `href` attribute is ignored there -- links between tiddlers are performed by JavaScript instead. The variable comes into play when one is using the [[Node.js configuration|TiddlyWiki on Node.js]] to [[generate a static version|RenderTiddlersCommand]] of a wiki.">>
+\procedure .js-macro-link(_)
+<a href="https://tiddlywiki.com/dev/index.html#JavaScript%20Macros"
+	class="tc-tiddlylink-external"
+	target="_blank"
+	rel="noopener noreferrer"
+><$text text=<<_>>/></a>
+\end
 
-\define .this-is-toolbar-config-variable(configTiddler)
+\procedure .this-is-static-link-variable() <<.note "This variable has no useful effect when ~TiddlyWiki is running in a browser, as the `href` attribute is ignored there -- links between tiddlers are performed by JavaScript instead. The variable comes into play when one is using the [[Node.js configuration|TiddlyWiki on Node.js]] to [[generate a static version|RenderTiddlersCommand]] of a wiki.">>
 
+\procedure .this-is-toolbar-config-variable(configTiddler)
+\whitespace notrim
 It can be set to <<.value yes>> or <<.value no>> prior to transcluding such a button.
 
-The standard page template sets it to the value found in [[$configTiddler$]], with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the <<.controlpanel-tab Settings>> tab of the [[Control Panel|$:/ControlPanel]].
+The standard page template sets it to the value found in <$link to=<<configTiddler>>><<configTiddler>></$link>, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the <<.controlpanel-tab Settings>> tab of the [[Control Panel|$:/ControlPanel]].
 \end
-
-<pre><$view field="text"/></pre>

package/editions/tw5.com/tiddlers/system/version-macros.tid

@@ -1,14 +1,38 @@
 code-body: yes
 created: 20161008085627406
-modified: 20221007122259593
+modified: 20240229155633000
 tags: $:/tags/Macro
 title: $:/editions/tw5.com/version-macros
 type: text/vnd.tiddlywiki
 
-\define .from-version(version)
-<$link to={{{ [<__version__>addprefix[Release ]] }}} class="doc-from-version">{{$:/core/images/warning}} New in: <$text text=<<__version__>>/></$link>
+\whitespace trim
+
+\function tf.from-version-reference() 5.3.0
+
+\procedure .from-version-template(class, text)
+<$link to={{{ [<version>addprefix[Release ]] }}} class=<<class>> >
+	<span class="tc-tiny-gap-right">
+		{{$:/core/images/info-button}}
+	</span>
+	<<text>><<version>>
+</$link>
+\end
+
+\procedure .from-version(version)
+<% if [<version>compare:version:gteq<tf.from-version-reference>] %>
+	<<.from-version-template "doc-from-version doc-from-version-new" "New in v">>
+<% else %>
+	<<.from-version-template "doc-from-version" "Introduced in v">>
+<% endif %>
 \end
 
-\define .deprecated-since(version, superseded:"TODO-Link")
-<$link to="Deprecated - What does it mean" class="doc-deprecated-version tc-btn-invisible">{{$:/core/images/warning}} Deprecated since: <$text text=<<__version__>>/></$link> (see <$link to=<<__superseded__>>><$text text=<<__superseded__>>/></$link>)
+\procedure .deprecated-since(version, superseded:"TODO-Link")
+<$link to="Deprecated - What does it mean" class="doc-deprecated-version tc-btn-invisible">
+	{{$:/core/images/warning}}
+	<span class="tc-tiny-gap">Deprecated since:</span>
+	<$text text=<<version>>/>
+</$link>
+<span class="tc-tiny-gap-left">
+	(see <$link class="tc-tiny-gap-left" to=<<superseded>>><$text text=<<superseded>>/></$link>)
+</span>
 \end

package/editions/tw5.com/tiddlers/system/wikitext-macros.tid

@@ -1,104 +1,96 @@
 code-body: yes
 created: 20150117184156000
-modified: 20220617122915793
+modified: 20240315144208842
 tags: $:/tags/Macro
 title: $:/editions/tw5.com/wikitext-macros
 type: text/vnd.tiddlywiki
 
-\define activatePluginTab()
+\whitespace trim
+
+\procedure activatePluginTab()
 <$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Plugins"/>
 <$action-navigate $to="$:/ControlPanel"/>
 \end
 
-\define activateTiddlerWindow()
-<$action-sendmessage $message="tm-open-window"
-  $param=<<currentTiddler>> windowTitle="Side by Side View"
-  width="800" height="600" />
+\procedure activateTiddlerWindow()
+<$action-sendmessage $message="tm-open-window" $param=<<currentTiddler>> windowTitle="Side by Side View" width="800" height="600" />
 \end
 
-\define controlPanel-plugin-link()
+\procedure controlPanel-plugin-link()
 <$button actions=<<activatePluginTab>> class="tc-btn-invisible tc-tiddlylink">
-{{$:/core/images/options-button}} ~ControlPanel
+	{{$:/core/images/options-button}} ~ControlPanel
 </$button>
 \end
 
-\define open-tiddler-in-window()
+\procedure open-tiddler-in-window()
+\whitespace notrim
 <$button actions=<<activateTiddlerWindow>> class="tc-btn-invisible tc-tiddlylink">
-open ''this'' tiddler in a new window
+	open ''this'' tiddler in a new window
 </$button>
 \end
 
-\define activateEditionWindow(url)
-<$action-sendmessage $message="tm-open-external-window"
-  $param="""$url$""" windowName="_edition"
-  windowFeatures="width=800 height=600" />
+\procedure activateEditionWindow(url)
+<$action-sendmessage $message="tm-open-external-window" $param=<<url>> windowName="_edition" windowFeatures="width=800 height=600" />
 \end
 
-\define open-external-window(url)
-<$button actions=<<activateEditionWindow """$url$""">> class="tc-btn-invisible tc-tiddlylink">
-open the ''example edition'' in a new window
+\procedure open-external-window(url)
+\whitespace notrim
+<$button actions=<<activateEditionWindow <<url>> class="tc-btn-invisible tc-tiddlylink">
+	open the ''example edition'' in a new window
 </$button>
 \end
 
 
-\define wikitext-example(src)
+\procedure wikitext-example(src)
 <div class="doc-example">
-
-<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
-
-<$codeblock code=<<__src__>>/>
-
-That renders as:
-
-<$macrocall $name="__src__"/>
-
-... and the underlying HTML is:
-
-<$wikify name="html" text=<<__src__>> output="html">
-<$codeblock code=<<html>>/>
-</$wikify>
+	<$macrocall $name="copy-to-clipboard-above-right" src=<<src>>/>
+	<$codeblock code=<<src>>/>
+	<p>
+		That renders as:
+	</p>
+	<$transclude $variable="src" $mode="block"/>
+	<p>
+		... and the underlying HTML is:
+	</p>
+	<$wikify name="html" text=<<src>> output="html">
+		<$codeblock code=<<html>>/>
+	</$wikify>
 </div>
 \end
 
-\define wikitext-example-without-html(src)
+\procedure wikitext-example-without-html(src)
 <div class="doc-example">
-
-<$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
-
-<$codeblock code=<<__src__>>/>
-
-That renders as:
-
-<$macrocall $name="__src__"/>
-
+	<$macrocall $name="copy-to-clipboard-above-right" src=<<src>>/>
+	<$codeblock code=<<src>>/>
+	<p>
+		That renders as:
+	</p>
+	<$transclude $variable="src" $mode="block"/>
 </div>
 \end
 
-\define wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>
-
-\define wikitext-example-table-row(id, code)
- <tr>
-<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>
+\procedure wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>
 
-<<__code__>>
-</td>
+\procedure wikitext-example-table-row(id, code)
+<tr>
+	<th><<id>></th>
+	<td><$codeblock code=<<code>>/></td>
+	<td><$transclude $variable="code" $mode="block"/></td>
 </tr>
 \end
 
-\define tw-code(tiddler)
+\procedure tw-code(tiddler)
 <$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>
 \end
 
-\define tw-code-link(tiddler)
+\procedure tw-code-link(tiddler)
 [[$tiddler$]]:
-
 <<tw-code $tiddler$>>
 \end
 
-\define flex-card(class,bordercolor:"",backgroundcolor:"",textcolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")
-\whitespace trim
-<$link class={{{ [<__class__>addprefix[tc-card ]] }}} to={{{ [<currentTiddler>get<__linkField__>else<currentTiddler>] }}}>
-	<div class="tc-card-accent" style.borderTop={{{ [<__bordercolor__>!is[blank]addprefix[5px solid ]] }}} style.background={{!!background}} style.backgroundColor=<<__backgroundcolor__>> style.color=<<__textcolor__>> style.fill=<<__textcolor__>>>
+\procedure flex-card(class,bordercolor:"",backgroundcolor:"",textcolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")
+<$link class={{{ [<class>addprefix[tc-card ]] }}} to={{{ [<currentTiddler>get<linkField>else<currentTiddler>] }}}>
+	<div class="tc-card-accent" style.borderTop={{{ [<bordercolor>!is[blank]addprefix[5px solid ]] }}} style.background={{!!background}} style.backgroundColor=<<backgroundcolor>> style.color=<<textcolor>> style.fill=<<textcolor>>>
 		<$list filter="[<currentTiddler>has[ribbon-text]]" variable="ignore">
 			<div class="tc-card-ribbon-wrapper">
 				<div class="tc-card-ribbon" style.backgroundColor={{{ [<currentTiddler>get[ribbon-color]else[red]] }}}>
@@ -108,21 +100,21 @@ That renders as:
 				</div>
 			</div>
 		</$list>
-		<$list filter="[<currentTiddler>has<__imageField__>]" variable="ignore">
+		<$list filter="[<currentTiddler>has<imageField>]" variable="ignore">
 			<div class="tc-card-image">
-				<$image source={{{ [<currentTiddler>get<__imageField__>] }}}/>
+				<$image source={{{ [<currentTiddler>get<imageField>] }}}/>
 			</div>
 		</$list>
-		<div class="tc-card-title"><$transclude field=<<__captionField__>>><$view field="title"/></$transclude></div>
-		<$list filter="[<__subtitle__>!is[blank]]" variable="ignore">
+		<div class="tc-card-title"><$transclude field=<<captionField>>><$view field="title"/></$transclude></div>
+		<$list filter="[<subtitle>!is[blank]]" variable="ignore">
 			<div class="tc-card-subtitle">
-				<$text text=<<__subtitle__>>/>
+				<$text text=<<subtitle>>/>
 			</div>
 		</$list>
 		<div class="tc-card-icon"><$transclude tiddler={{!!icon}}/></div>
 		<div class="tc-card-body-wrapper">
 			<div class="tc-card-body">
-				<$transclude field=<<__descriptionField__>> mode="block"/>
+				<$transclude field=<<descriptionField>> mode="block"/>
 			</div>
 			<div class="tc-card-body-clear">
 			</div>

package/editions/tw5.com/tiddlers/tag-picker Macro (Examples).tid

@@ -0,0 +1,69 @@
+created: 20230616104546608
+modified: 20240708132312901
+tags: [[tag-picker Macro]] [[Macro Examples]]
+title: tag-picker Macro (Examples)
+type: text/vnd.tiddlywiki
+
+<<.warning """The first example will add tags to the <<.tid currentTiddler>> so you should copy / paste it to a new tiddler for testing. Otherwise you'll change "this tiddler" """>>
+
+<$transclude $variable=".example" n="1"
+eg="""Add tags to this tiddler's ''tags'' field (selecting from a list of all tags): <<tag-picker>>
+"""/>
+
+----
+
+<$let transclusion=test>
+
+<<.tip """The following examples use a temporary tiddler: $:/temp/test/tag-picker. So this tiddler will not be changed """>>
+
+
+<$transclude $variable=".example" n="2" 
+eg="""$:/temp/test/tag-picker ''tags'': <$text text={{{ [[$:/temp/test/tag-picker]get[tags]enlist-input[]join[, ]else[n/a]] }}}/>
+
+Add tags to the $:/temp/test/tag-picker ''tags'' field (selecting from a list of all tags): <<tag-picker tiddler:"$:/temp/test/tag-picker">>
+"""/>
+
+----
+
+<<.tip """Use the following example to populate the $:/temp/test/tag-picker ''foo''-field, which are needed by some examples below """>>
+
+<$transclude $variable=".example" n="3" 
+eg="""$:/temp/test/tag-picker ''foo'': <$text text={{{ [[$:/temp/test/tag-picker]get[foo]enlist-input[]join[, ]else[n/a]] }}}/>
+
+Add tags to the $:/temp/test/tag-picker ''foo'' field (selecting from a list of all tags): <<tag-picker tagField:"foo"  tiddler:"$:/temp/test/tag-picker">>
+"""/>
+
+----
+
+<<.tip """The following example expects some values in the "foo" field of the tiddler $:/temp/test/tag-picker, which can be created by the example above.""">>
+
+<$transclude $variable=".example" n="4" eg="""\procedure listSource() $:/temp/test/tag-picker
+
+$:/temp/test/tag-picker foo: <$text text={{{ [[$:/temp/test/tag-picker]get[foo]enlist-input[]join[, ]else[n/a]] }}}/><br>
+$:/temp/test/tag-picker bar: <$text text={{{ [[$:/temp/test/tag-picker]get[bar]enlist-input[]join[, ]else[n/a]] }}}/>
+
+Add tags to the ''bar'' field, selecting from values in ''foo'' field of $:/temp/test/tag-picker: <<tag-picker tagField:"bar" tagListFilter:"[<listSource>get[foo]enlist-input[]]" tiddler:"$:/temp/test/tag-picker">>
+"""/>
+
+----
+
+<<.tip """The following example expects some values in the "foo" field of the tiddler $:/temp/test/tag-picker, which can be created by the example above.<br>
+It will also add completely new tags to the bar-field and the source tiddler‘s foo-field. New tags can be entered by typing into the tag-name input
+""">>
+
+<$transclude $variable=".example" n="5" eg="""
+\procedure listSource() $:/temp/test/tag-picker
+\procedure listSourceField() foo
+
+\procedure addNewTagToSource()
+	<$action-listops $tiddler=<<listSource>> $field=<<listSourceField>> $subfilter='[<listSource>get<listSourceField>enlist-input[]] [<tag>trim[]]'/>
+\end
+
+$:/temp/test/tag-picker foo: <$text text={{{ [[$:/temp/test/tag-picker]get[foo]enlist-input[]join[, ]else[n/a]] }}}/><br>
+$:/temp/test/tag-picker ''bar'': <$text text={{{ [[$:/temp/test/tag-picker]get[bar]enlist-input[]join[, ]else[n/a]] }}}/>
+
+Add tags to ''bar'' field, selecting from values in ''foo'' field of $:/temp/test/tag-picker: <$macrocall $name="tag-picker" tagField="bar" tagListFilter="[<listSource>get<listSourceField>enlist-input[]]" tiddler="$:/temp/test/tag-picker" actions=<<addNewTagToSource>>/>
+
+"""/>
+
+</$let>

package/editions/tw5.com/tiddlers/tag-pill Macro (Examples).tid

@@ -0,0 +1,14 @@
+created: 20230803034230294
+modified: 20230803043848449
+tags: [[Macro Examples]] [[tag-pill Macro]]
+title: tag-pill Macro (Examples)
+
+This example displays the [[Community]] tag as a clickable element with no dropdown:
+
+<$transclude $variable=".example" n="1" eg="""<<tag-pill Community>>"""/>
+
+This example displays the [[Definitions]] tag as an unclickable, but still-styled, `big` element with no dropdown:
+
+<$transclude $variable=".example" n="2" eg="""<<tag-pill Definitions element-tag:"big" element-attributes:"inert">>"""/>
+
+

package/editions/tw5.com/tiddlers/testcases/DataWidget/FilterMissingTiddler.tid

@@ -0,0 +1,17 @@
+title: TestCases/DataWidget/FilterMissingTiddler
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Filter returns title of missing tiddler
+display-format: plaintext
+
+title: Narrative
+
+When the $filter attribute of the data widget returns the title of a missing tiddler, no tiddler should be added to the output array of tiddlers.
++
+title: Output
+
+<$data $filter="missing"/>
++
+title: ExpectedResult
+
+<p>[]</p>

package/editions/tw5.com/tiddlers/testcases/DataWidget/ImportCompound.tid

@@ -0,0 +1,33 @@
+title: TestCases/DataWidget/ImportCompound
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+description: Importing a compound payload tiddler and adding custom fields
+display-format: plaintext
+
+title: Narrative
+
+Using the data widget to import a tiddler stored in a compound tiddler
++
+title: Output
+
+<$data $compound-tiddler="Compound" custom="Alpha"/>
++
+title: Compound
+type: text/vnd.tiddlywiki-multiple
+tags: [[$:/tags/wiki-test-spec]]
+
+title: Payload Tiddler
+tags: Alpha Beta Gamma
+
+This is a payload tiddler from a compound tiddler
++
+title: ExpectedResult
+
+<p>[
+    {
+        "title": "Payload Tiddler",
+        "tags": "Alpha Beta Gamma",
+        "text": "This is a payload tiddler from a compound tiddler",
+        "custom": "Alpha"
+    }
+]</p>