tiddlywiki 5.3.7 → 5.4.0

package/editions/tw5.com/tiddlers/css-variables/--tpc-_ variables.tid

@@ -0,0 +1,16 @@
+caption: --tpc-*
+created: 20260122104142525
+modified: 20260122104847331
+tags: [[Core CSS Variables]]
+title: --tpc-* CSS Variables
+type: text/vnd.tiddlywiki
+
+`--tpc-*` variables are CSS variables of palette colors. They can be accessed via appending the palette color names to the bottom. For example:
+
+```css
+.code {
+	background-color: var(--tpc-code-background);
+	color: var(--tpc-code-foreground);
+}
+```
+

package/editions/tw5.com/tiddlers/definitions/BT.tid

@@ -3,4 +3,4 @@ modified: 20211117195517318
 tags: Definitions
 title: BT
 
-BT (née British Telecom) is the UK's largest telecommunications company. In 2007, [[Osmosoft]] was acquired by BT. JeremyRuston subsequently left BT in 2011.
+BT (née British Telecom) is the UK's largest telecommunications company. In 2007, [[Osmosoft]] was acquired by BT. [[@Jermolene]] subsequently left BT in 2011.

package/editions/tw5.com/tiddlers/definitions/ContentType.tid

@@ -1,5 +1,5 @@
 created: 20130828185900000
-modified: 20150221120839000
+modified: 20250814073940003
 tags: Definitions
 title: ContentType
 type: text/vnd.tiddlywiki
@@ -11,19 +11,20 @@ In TiddlyWiki, the `type` field gives the content type to apply to the main `tex
 !! List of Common Content Types
 
 |!Group |!Type |!Content of `type` field |
-|^''Developer'' |Data dictionary |application/x-tiddler-dictionary|
-|~|~JavaScript code |application/javascript|
-|~|JSON data |application/json|
-|~|Static stylesheet |text/css|
+|^''Developer'' |[[Data dictionary|DictionaryTiddlers]] |application/x-tiddler-dictionary|
+|~|[[Compound Tiddler|CompoundTiddlers]] |text/vnd.tiddlywiki-multiple|
+|~|JavaScript code |application/javascript|
+|~|[[JSON data|JSONTiddlers]] |application/json|
+|~|[[Static stylesheet|Using Stylesheets]] |text/css|
 |^''Image''|GIF image |image/gif|
 |~|ICO format icon file |image/x-icon|
 |~|JPEG image |image/jpeg|
 |~|PDF image |application/pdf|
 |~|PNG image |image/png|
 |~|Structured Vector Graphics image |image/svg+xml|
-|^''Text''|HTML markup |text/html|
+|^''Text''|[[HTML markup|HyperText Markup Language]] |text/html|
 |~|[[CSS|Cascading Style Sheets]] stylesheet |text/css|
 |~|[[Comma-separated values|Comma-Separated Values]] |text/csv|
 |~|Plain text |text/plain|
-|~|~TiddlyWiki 5 |text/vnd.tiddlywiki|
-|~|~TiddlyWiki Classic |text/x-tiddlywiki|
+|~|[[TiddlyWiki 5|WikiText]] |text/vnd.tiddlywiki|
+|~|[[TiddlyWiki Classic|TiddlyWikiClassic]] |text/x-tiddlywiki|

package/editions/tw5.com/tiddlers/definitions/Intertwingled Innovations.tid

@@ -4,6 +4,6 @@ tags: Definitions
 title: Intertwingled Innovations
 type: text/vnd.tiddlywiki
 
-Intertwingled Innovations Limited is the company through which [[JeremyRuston]] performs commercial consultancy work helping companies and individuals release the business value of TiddlyWiki.
+Intertwingled Innovations Limited is [[JeremyRuston]]'s company through which he offers services helping organisations release the business value of TiddlyWiki.
 
 See https://intertwingledinnovations.com/ for more information.

package/editions/tw5.com/tiddlers/definitions/JeremyRuston.tid

@@ -4,16 +4,4 @@ tags: Definitions
 title: JeremyRuston
 type: text/vnd.tiddlywiki
 
-I'm the original inventor of TiddlyWiki. You can hire me through [[Intertwingled Innovations]], and find me on these services:
-
-* jeremy (at) jermolene (dot) com
-* [[Jermolene on GitHub|https://github.com/Jermolene]]
-* [[Jermy on LinkedIn|http://www.linkedin.com/in/jermy]]
-* [[Jermy on Flickr|http://www.flickr.com/photos/jermy/]]
-
-Further information:
-
-* A recording of the [[keynote I gave at QCon London in April 2024|https://www.infoq.com/presentations/bbc-micro/]], and the [[discussion on talk.tiddlywiki.org|https://talk.tiddlywiki.org/t/recording-of-jeremys-keynote-at-qcon-london-april-2024/10505]]. The talk mixes some nostalgia about my teenage activities with the BBC Micro with thoughts on the development of the software industry and insights gained from working with TiddlyWiki
-* An [[interview with me in The Inquirer|http://www.theinquirer.net/inquirer/feature/2105529/bt-software-engineer-tells-telco-source]] by Wendy Grossman
-* A [[hilarious interview with me|https://www.youtube.com/watch?v=auyIhw8MTmQ]] from British television in 1983
-* Here's a video of a presentation I did in 2007 called [["How to Start an Open Source Project"|http://vimeo.com/856110]].
+See [[@Jermolene]].

package/editions/tw5.com/tiddlers/definitions/Jermolene.tid

@@ -3,4 +3,4 @@ modified: 201308281902
 tags: Definitions
 title: Jermolene
 
-Alias for JeremyRuston.
+See [[@Jermolene]].

package/editions/tw5.com/tiddlers/definitions/Osmosoft.tid

@@ -3,7 +3,7 @@ modified: 20211119004632506
 tags: Definitions
 title: Osmosoft
 
-Founded in 2004 by JeremyRuston, Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on [[Socialtext Unplugged|https://www.socialtext.net/open/socialtext_unplugged]].
+Founded in 2004 by [[@Jermolene]], Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on [[Socialtext Unplugged|https://www.socialtext.net/open/socialtext_unplugged]].
 
 In 2007, Osmosoft was acquired by [[BT]] and became the champions for open source within the enterprise. As part of BT, Osmosoft has worked on a diverse range of projects within BT and for BT's customers.
 

package/editions/tw5.com/tiddlers/demonstrations/SampleTiddlerFirst.tid

@@ -1,6 +1,9 @@
 created: 20211117003509226
-modified: 20211117003657902
+modified: 20260102135713260
 tags: sampletag1 sampletag2 [[Widget Examples]]
 title: SampleTiddlerFirst
+type: text/vnd.tiddlywiki
 
-This is a test tiddler called SampleTiddlerFirst.
+This is a test tiddler called SampleTidlerFirst.
+It is used in [[DiffTextWidget]].
+You can modify its content.

package/editions/tw5.com/tiddlers/demonstrations/SampleTiddlerSecond.tid

@@ -1,6 +1,8 @@
 created: 20211117003511221
-modified: 20211117003724108
+modified: 20260102135739735
 tags: sampletag1 sampletag2 [[Widget Examples]]
 title: SampleTiddlerSecond
 
-This test tiddler is called SampleTiddlerSecond.
+This test tiddler is called SampleTiddlerSecond.
+It is used in [[DiffTextWidget]].
+You can edit its content.

package/editions/tw5.com/tiddlers/demonstrations/TableOfContentsMacro Simple Example.tid

@@ -1,11 +1,43 @@
-created: 20150221201838000
-modified: 20150221203742000
-title: Example Table of Contents: Simple
 caption: Simple
-tags: table-of-contents-example
+created: 20150221201838000
+modified: 20260124125915331
 order: 1
+tags: table-of-contents-example
+title: Example Table of Contents: Simple
+type: text/vnd.tiddlywiki
 
 <$macrocall $name=".example" n="1"
 eg="""<div class="tc-table-of-contents">
 <<toc "Contents">>
 </div>"""/>
+
+---
+
+<<.tip"""If you use several parameters in a macro call, it is advised to use ''named parameters'' for all of them""">>
+
+<$macrocall $name=".example" n="2"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"1">>
+</div>"""/>
+
+<$macrocall $name=".example" n="3"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"2">>
+</div>"""/>
+
+<$macrocall $name=".example" n="4"
+eg="""<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"4">>
+</div>"""/>
+
+* If you want to ''change'' or ''remove'' the indicator, you can locally overwrite the `toc-level-indicator` macro. 
+* It is globally defined at: $:/core/macros/toc tiddler. Eg:
+
+<$macrocall $name=".example" n="5"
+eg="""\define toc-level-indicator()
+<!-- remove the indicator --> 
+\end
+
+<div class="tc-table-of-contents">
+<<toc tag:"Contents" level:"1">>
+</div>"""/>

package/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExample.tid

@@ -4,22 +4,22 @@ tags: Learning
 title: TaskManagementExample
 type: text/vnd.tiddlywiki
 
-TiddlyWiki5 can be used as a simple task management system without further customisation. The idea is that tasks be tagged `task`, with those that are completed also tagged `done`. In this way it is straightforward to generate task lists.
+TiddlyWiki5 can be used as a simple task management system without further customisation.<br>The idea is that tasks be tagged `task`, with those that are completed also tagged `done`. In this way it is straightforward to generate task lists.
 
 <<.tip """There is [[an enhanced version of this demo|TaskManagementExample (Draggable)]] that adds the ability to drag and drop the tasks to re-order them.""">>
 
 ! Outstanding tasks
 
-<$list filter="[!has[draft.of]tag[task]!tag[done]sort[created]]">
-
-<$checkbox tag="done"> <$link/></$checkbox>
-
+<$macrocall $name='wikitext-example-without-html'
+src="""<$list filter="[!has[draft.of]tag[task]!tag[done]sort[created]]">
+<$checkbox tag="done"> <$link/></$checkbox><br>
 </$list>
+"""/>
 
 ! Completed tasks
 
-<$list filter="[!has[draft.of]tag[task]tag[done]sort[created]]">
-
-<$checkbox tag="done"> ~~<$link/>~~</$checkbox>
-
+<$macrocall $name='wikitext-example-without-html'
+src="""<$list filter="[!has[draft.of]tag[task]tag[done]sort[created]]">
+<$checkbox tag="done"> ~~<$link/>~~</$checkbox><br>
 </$list>
+"""/>

package/editions/tw5.com/tiddlers/demonstrations/Tasks/TaskManagementExampleDraggable.tid

@@ -4,20 +4,24 @@ tags: Learning
 title: TaskManagementExample (Draggable)
 type: text/vnd.tiddlywiki
 
-This is a version of the TaskManagementExample enhanced with the ability to drag and drop the task list to re-order them.
+This is a version of the TaskManagementExample enhanced with the ability to drag and drop the task list to re-order them.<br>The list uses a the itemTemplate [[TaskManagementExampleDraggableTemplate]] tiddler, which you will also need to experiment yourself.
 
 ! Outstanding tasks
 
-//Drag the tasks to re-order them//
+<$macrocall $name='wikitext-example-without-html'
+src="""//Drag the tasks to re-order them//
 
 <<list-tagged-draggable tag:"task" subFilter:"!has[draft.of]!tag[done]" itemTemplate:"TaskManagementExampleDraggableTemplate" emptyMessage:"You don't have any active tasks">>
+"""/>
 
 ! Completed tasks
 
-//(Listed in reverse order of completion)//
+<$macrocall $name='wikitext-example-without-html'
+src="""//(Listed in reverse order of completion)//
 
 <$list filter="[!has[draft.of]tag[task]tag[done]sort[modified]]">
 <div>
 <$checkbox tag="done"> ~~<$link/>~~</$checkbox>
 </div>
 </$list>
+"""/>

package/editions/tw5.com/tiddlers/features/DateFormat.tid

@@ -4,35 +4,36 @@ tags: Features
 title: DateFormat
 type: text/vnd.tiddlywiki
 
-The default representation of dates is a compact string such as <<.value 20211002153802059>>. The associated template is `[UTC]YYYY0MM0DD0hh0mm0ss0XXX`. For example, the <<.field created>> and <<.field modified>> fields are stored like this.
+The default representation of dates is a compact string such as <<.value "<$view field='modified' format='text'/>">>. The associated template is `[UTC]YYYY0MM0DD0hh0mm0ss0XXX`. For example, the <<.field created>> and <<.field modified>> fields are stored like this.
 
-The display format for this string can be controlled with a template. For example, transcluding the <<.field modified>> field automatically applies a template to display the date as <<.value "Sat Oct 02 2021 17:40:50 GMT+0200 (Central European Summer Time)">>. A few widgets and filter operators allow you to manually specify a template, for example the ViewWidget:
+The display format for this string can be controlled with a template. For example, transcluding the <<.field modified>> field automatically applies a template to display the date as "{{!!modified}}". A few widgets and filter operators allow you to manually specify a template, for example the ViewWidget:
 
 `<$view field=modified format=date template="DDth mmm YYYY 0hh:0mm:0ss" />`
 
 The date string is processed with the following substitutions:
 
 |!Token |!Substituted Value |
+|`[UTC]`|Time-shift the represented date to UTC. Must be at very start of format string |
+|`YYYY` |Full year |
+|`YY` |Two-digit year |
+|`wYYYY` |Full year with respect to week number |
+|`aYYYY` |<<.from-version "5.1.23">> Full year but negative dates are displayed as positive |
+|`wYY` |Two digit year with respect to week number |
+|`{era:BCE||CE}` |<<.from-version "5.1.23">> Displays a different string for years that are negative, zero or positive (see below) |
+|`MMM` |Month in full (e.g. "July") |
+|`mmm` |Short month (e.g. "Jul") |
+|`MM` |Month number |
+|`0MM` |Adds leading zero |
 |`ddddd` |<<.from-version "5.2.0">> Day of year (1 to 365, or 366 for leap years) |
 |`0ddddd` |<<.from-version "5.2.0">> Zero padded day of year (001 to 365, or 366 for leap years) |
-|`DDD` |Day of week in full (eg, "Monday") |
-|`ddd` |Short day of week (eg, "Mon") |
+|`DDD` |Day of week in full (e.g. "Monday") |
+|`ddd` |Short day of week (e.g. "Mon") |
 |`dddd` |<<.from-version "5.2.0">> Weekday number from 1 through 7, beginning with Monday and ending with Sunday |
 |`DD` |Day of month |
 |`0DD` |Adds a leading zero |
 |`DDth` |Adds a suffix |
 |`WW` |ISO-8601 week number of year |
 |`0WW` |Adds a leading zero |
-|`MMM` |Month in full (eg, "July") |
-|`mmm` |Short month (eg, "Jul") |
-|`MM` |Month number |
-|`0MM` |Adds leading zero |
-|`YYYY` |Full year |
-|`YY` |Two digit year |
-|`wYYYY` |Full year with respect to week number |
-|`aYYYY` |<<.from-version "5.1.23">> Full year but negative dates are displayed as positive |
-|`wYY` |Two digit year with respect to week number |
-|`{era:BCE||CE}` |<<.from-version "5.1.23">> Displays a different string for years that are negative, zero or positive (see below) |
 |`hh` |Hours |
 |`0hh` |Adds a leading zero |
 |`hh12` |Hours in 12 hour clock |
@@ -43,12 +44,12 @@ The date string is processed with the following substitutions:
 |`0ss` |Seconds with leading zero |
 |`XXX` |Milliseconds |
 |`0XXX` |Milliseconds with leading zero |
-|`am` or `pm` |Lower case AM/PM indicator |
+|`am` or `pm` |Lower case am/pm indicator |
 |`AM` or `PM` |Upper case AM/PM indicator |
-|`TZD` |Timezone offset |
+|`TZD` |Timezone offset from UTC (e.g. "+01:00", "-05:00"…) |
 |`TIMESTAMP` |<<.from-version "5.2.4">> Number of milliseconds since the [[ECMAScript epoch|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date#the_ecmascript_epoch_and_timestamps]], 1 January 1970. |
 |`\x` |Used to escape a character that would otherwise have special meaning |
-|`[UTC]`|Time-shift the represented date to UTC. Must be at very start of format string|
+
 
 Note that other text is passed through unchanged, allowing commas, colons or other separators to be used.
 

package/editions/tw5.com/tiddlers/filters/examples/days.tid

@@ -6,15 +6,13 @@ type: text/vnd.tiddlywiki
 <<.operator-example 2 "[!days:created[-800]]" "tiddlers created more than 800 days ago">>
 The filter can be used to highlight new items in a list. For example:
 <$macrocall
-  $name="wikitext-example-without-html" src=
-"""
-<ul>
+  $name="wikitext-example-without-html"
+  src="""<ul>
   <$list filter="[tag[ReleaseNotes]!<currentTiddler>!sort[modified]]">
     <li>
       <$link><$view field="title"/></$link>
-         <$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
-         <$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
+      <$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
+      <$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
     </li>
   </$list>
-</ul>
-"""/>
+</ul>"""/>

package/editions/tw5.com/tiddlers/filters/examples/jsondelete.tid

@@ -0,0 +1,59 @@
+created: 20250115120000000
+modified: 20250115120000000
+tags: [[Operator Examples]] [[jsondelete Operator]]
+title: jsondelete Operator (Examples)
+
+<$let object-a="""{
+    "a": "one",
+    "b": "",
+    "c": "three",
+    "d": {
+        "e": "four",
+        "f": [
+            "five",
+            "six",
+            true,
+            false,
+            null
+        ],
+        "g": {
+            "x": "max",
+            "y": "may",
+            "z": "maize"
+        }
+    }
+}
+"""
+object-b="""{"a":"one","b":"","c":1.618,"d":{"e":"four","f":["five","six",true,false,null]}}"""
+array-a="""["une","deux","trois",["quatre","cinq"]]""">
+
+The examples below assume the following JSON object is contained in the variable `object-a`:
+
+<pre><<object-a>></pre>
+
+<<.operator-example 1 "[<object-a>jsondelete[a]]" "Delete a top-level object property">>
+<<.operator-example 2 "[<object-a>jsondelete[d],[e]]" "Delete a nested object property">>
+<<.operator-example 3 "[<object-a>jsondelete[d],[f],[0]]" "Delete the first element from an array">>
+<<.operator-example 4 "[<object-a>jsondelete[d],[f],[-1]]" "Delete the last element from an array using negative index">>
+<<.operator-example 5 "[<object-a>jsondelete[d],[f],[-2]]" "Delete the second-to-last element from an array using negative index">>
+<<.operator-example 6 "[<object-a>jsondelete[d],[g],[x]]" "Delete a deeply nested object property">>
+<<.operator-example 7 "[<object-a>jsondelete[]]" "If no parameters are specified, the JSON object is returned unchanged">>
+<<.operator-example 8 "[<object-a>jsondelete[missing]]" "If the property does not exist, the JSON object is returned unchanged">>
+
+The examples below assume the following JSON object is contained in the variable `object-b`:
+
+<pre><<object-b>></pre>
+
+<<.operator-example 9 "[<object-b>jsondelete[b]]" "Delete an empty string property">>
+<<.operator-example 10 "[<object-b>jsondelete[d],[f],[1]]" "Delete a middle element from an array">>
+
+The examples below assume the following JSON array is contained in the variable `array-a`:
+
+<pre><<array-a>></pre>
+
+<<.operator-example 11 "[<array-a>jsondelete[0]]" "Delete the first element from a top-level array">>
+<<.operator-example 12 "[<array-a>jsondelete[-1]]" "Delete the last element from a top-level array using negative index">>
+<<.operator-example 13 "[<array-a>jsondelete[3],[0]]" "Delete an element from a nested array">>
+
+<<.operator-example 14 "[<object-a>] [<object-b>] :and[jsondelete[a]]" "If the input consists of multiple JSON objects with matching properties, the property is deleted from all of them">>
+

package/editions/tw5.com/tiddlers/filters/examples/substitute Operator (Examples).tid

@@ -1,37 +1,60 @@
 created: 20230614225302905
-modified: 20230614233448662
+modified: 20251021140446753
 tags: [[Operator Examples]] [[substitute Operator]]
 title: substitute Operator (Examples)
 type: text/vnd.tiddlywiki
 
-\define time() morning
-\define field() modified
-\procedure sentence() This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$
-\define name() Bugs Bunny
-\define address() Rabbit Hole Hill
+!! Substitute operator parameters
+
+The following example uses a ''function definition'' and a ''function call'' with a ''filter expression''
+
+<<wikitext-example-without-html """\function f.text() [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]]
+
+<<f.text>>
+""">>
+
+---
+
+The following example uses a [[filtered transclusion|Transclusion in WikiText]] with a [[filter expression|Filter Syntax]] creating a link and a text output.
+
+<<wikitext-example-without-html """link: {{{ [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]] }}}
+
+text: <$text text={{{ [[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]] }}}/>
+""">>
 
-!Substitute <<.op substitute[]>> operator parameters
-<<.operator-example 1 "[[Hi, I'm $1$ and I live in $2$]substitute[Bugs Bunny],[Rabbit Hole Hill]]">>
 
-!Substitute variables
-This example uses the following variables:
+!! Substitute variables and parameters
 
-* name: <$codeblock code=<<name>>/>
-* address: <$codeblock code=<<address>>/>
+The following example uses [[variable definitions|Pragma: \procedure]] "name", "address", a ''filtered transclusion'' assigned to a ''text-widget''. The variables "name" and "address" are used as ''substitute parameters''.
 
-<<.operator-example 2 "[[Hi, I'm $(name)$ and I live in $(address)$]substitute[]]">>
+<<wikitext-example-without-html """\procedure name() Bugs Bunny
+\procedure address() Rabbit Hole Hill
 
-!Substitute variables and operator parameters
-This example uses the following variable:
+<$text text={{{ [[Hi, I'm $1$ and I live in $2$]substitute<name>,<address>] }}}/>
+""">>
 
-* time: <$codeblock code=<<time>>/>
+!! Substitute $(variables)$
+
+The following examples use the variables "name" and "address" and directly substitute the with the [[attribute substitution|Substituted Attribute Values]] syntax. 
+
+<<wikitext-example-without-html """\procedure name() Bugs Bunny
+\procedure address() Rabbit Hole Hill
+
+<$text text=`Hi, I'm $(name)$ and I live in $(address)$`/>
+""">>
+
+!! Substitute a filter expression and a variable
+
+The following example uses a procedure, that defines the text with substitution placeholders. `$(field)$` is defined as a variable. `${ ... }$` is filtered <<.olink2 "substitution placeholder" to:"substitute">>.
+
+<<wikitext-example-without-html """\procedure field() modified
+
+\procedure sentence() This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$
 
-<<.operator-example 3 "[[Something in the $(time)$ at $2$ about $1$ ]substitute[Maths],[the Library]]">>
+<$text text={{{ [<sentence>substitute[]] }}}/>
 
-!Substitute a filter expression and a variable
-This example uses the following variables:
+---
 
-* field: <$codeblock code=<<field>>/>
-* sentence: <$codeblock code=<<sentence>>/>
+<$text text=`This tiddler was last $(field)$ on ${[{!!modified}format:date[DDth MMM YYYY]]}$`/>
 
-<<.operator-example 4 "[<sentence>substitute[]]">>
+""">>

package/editions/tw5.com/tiddlers/filters/function.tid

@@ -1,6 +1,6 @@
 caption: function
 created: 20220909111836951
-modified: 20230419103154328
+modified: 20260130210336084
 op-input: a [[selection of titles|Title Selection]] passed as input to the function <<.place F>>
 op-output: the [[selection of titles|Title Selection]] returned from the function <<.place F>>
 op-parameter: first parameter is the [[function name|Functions]], subsequent parameters are passed to the function by position
@@ -10,7 +10,7 @@ tags: [[Filter Operators]]
 title: function Operator
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.3.0">> The <<.op function>> operator applies a named [[function|Functions]] to the input titles, and returns the results from the function. The function is invoked once with all of the input titles (in contrast, the [[filter Operator]] invokes its function separately for each input title).
+<<.from-version "5.3.0">> The <<.op function>> operator applies a named [[function|Functions]] to the input titles, and returns the results from the function. The function is called once with all of the input titles (in contrast, the [[filter Operator]] calls its function separately for each input title).
 
 The first parameter of the <<.op function>> operator specifies the name of the function to be called. Subsequent parameters are passed to the function.
 

package/editions/tw5.com/tiddlers/filters/jsondelete.tid

@@ -0,0 +1,54 @@
+caption: jsondelete
+created: 20250115120000000
+modified: 20250115120000000
+op-input: a selection of JSON objects
+op-output: the JSON objects with the specified property deleted
+op-parameter: one or more indexes of the property to delete
+op-purpose: delete a property from JSON objects
+tags: [[Filter Operators]] [[JSON Operators]]
+title: jsondelete Operator
+
+<<.from-version "5.4.0">> The <<.op jsondelete>> operator is used to delete a property from JSON strings. See [[JSON in TiddlyWiki]] for background. See also the following related operators:
+
+* <<.olink jsonset>> to set values within JSON objects
+* <<.olink jsonget>> to retrieve the values of a property in JSON data
+* <<.olink jsontype>> to retrieve the type of a JSON value
+* <<.olink jsonindexes>> to retrieve the names of the fields of a JSON object, or the indexes of a JSON array
+* <<.olink jsonextract>> to retrieve a JSON value as a string of JSON
+
+Properties within a JSON object are identified by a sequence of indexes. In the following example, the value at `[a]` is `one`, and the value at `[d][f][0]` is `five`.
+
+```
+{
+    "a": "one",
+    "b": "",
+    "c": "three",
+    "d": {
+        "e": "four",
+        "f": [
+            "five",
+            "six",
+            true,
+            false,
+            null
+        ],
+        "g": {
+            "x": "max",
+            "y": "may",
+            "z": "maize"
+        }
+    }
+}
+```
+
+The <<.op jsondelete>> operator uses multiple parameters to specify the indexes of the property to delete. For object properties, the property is removed using JavaScript's `delete` operator. For array elements, the element is removed using `splice`, which shifts remaining elements.
+
+Negative indexes into an array are counted from the end, so -1 means the last item, -2 the next-to-last item, and so on.
+
+Indexes can be dynamically composed from variables and transclusions, e.g. `[<jsondata>jsondelete<variable>,{!!field},[0]]`.
+
+If the specified property does not exist, the JSON object is returned unchanged. If you attempt to delete the root object itself (by providing no indexes or a blank index), the JSON object is returned unchanged.
+
+If the input consists of multiple JSON objects, the property is deleted from all of them.
+
+<<.operator-examples "jsondelete">>

package/editions/tw5.com/tiddlers/filters/range.tid

@@ -1,9 +1,9 @@
 caption: range
 created: 20171221184734665
-modified: 20230321133838310
+modified: 20251008154315078
 op-input: ignored
-op-neg-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>` in reverse order
-op-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>`
+op-neg-output: a series of evenly spaced numbers ranging from `[BEGIN]` to `[END]` in reverse order
+op-output: a series of evenly spaced numbers ranging from `[BEGIN]` to `[END]`
 op-parameter: a range specification, like `[1],[5]`
 op-parameter-name: N
 op-purpose: generate a range of numbers
@@ -23,42 +23,56 @@ The `range` operator produces a list of numbers counting up or down.  It is usef
 
 <<.from-version "5.2.0">> The range operator has been updated to use multiple parameters. Prior to this version, the range operator only had one parameter, with the three parts delimited by `,`, `;` or `:`.
 
+In the descriptions below the words `BEGIN`, `END` and `STEP` are placeholders. 
+
 ```
-[range[<begin>]]
-[range[<begin>],[<end>]]
-[range[<begin>],[<end>],[<step>]]
+[range[END]]
+[range[BEGIN],[END]]
+[range[BEGIN],[END],[STEP]]
 ```
 
 The behaviour depends on the number of parameters:
 
-|Parameter |Output |h
-|`<end>` |Whole numbers up to `<end>` |
-|`<begin>,<end>` |Numbers from `<begin>` to `<end>`, spaced by whole numbers |
-|`<begin>,<end>,<step>` |Numbers from `<begin>` to `<end>` spaced out by `<step>` |
+|Parameter(s) Literal |Output |h
+|`[END]` |Whole numbers up to `[END]` eg: `[range[7]]`|
+|`[BEGIN],[END]` |Numbers from `[BEGIN]` to `[END]`, spaced by whole numbers eg: `[range[1],[10]]` |
+|`[BEGIN],[END],[STEP]` |Numbers from `[BEGIN]` to `[END]` spaced out by `[STEP]` eg: `[range[1],[7],[2]]` |
+
+|Parameter(s) Dynamic |Output |h
+|`<END>` |Whole numbers up to `<END>` eg: `[range<myRangeEnd>]`.<br>The <<.var myRangeEnd>> variable has to be defined somewhere else with eg: <<.wid let>> widget |
+|`{BEGIN},<END>` |Numbers from `{BEGIN}` to `<END>` eg: `[range{myRangeStart},<myRangeEnd>]`.<br>The <<.param myRangeStart>> will be transcluded from a tiddler "myRanageStart"  and <<.var myRangeEnd>> comes from a variable |
+
+Each parameter must be a number, and works as follows:
 
-Each part must be a number, and works as follows:
+* `[BEGIN]`: start counting at this number.
+** Defaults to 1 if `[END]` is at least 1 (or -1 if `[END]` is at most -1).
 
-* `<begin>`: start counting at this number.
-** Defaults to 1 if `<end>` is at least 1 (or -1 if `<end>` is at most -1).
-* `<end>`: stop counting at this number.
+* `[END]`: stop counting at this number.
 ** This number will appear in the list unless it falls between two steps.
-* `<step>`: count up (or down) by this amount.
+
+* `[STEP]`: count up (or down) by this amount.
 ** Defaults to 1.
 ** Cannot be zero.
-** We always count from `<begin>` toward `<end>`, whether `<step>` is positive or negative.
+** We always count from `[BEGIN]` toward `[END]`, whether `[STEP]` is positive or negative.
 
 The number of decimal points in the output is fixed, and based on the parameter with the //most// decimal points.
 
 To prevent the browser from freezing, `range` is currently limited to 10,000 values.
 
-!!Examples
+!! Examples
+
+<<wikitext-example-without-html
+"""<$list variable=n filter="[range[7]]" join=", "><<n>></$list>""">>
 
-<<range_example "7">>
+<<wikitext-example-without-html
+"""<$list variable=n filter="[range[3],[10]]" join=", "><<n>></$list>""">>
 
-<<range_example "1],[10">>
+<<wikitext-example-without-html
+"""<$list variable=n filter="[range[17],[13]]" join=", "><<n>></$list>""">>
 
-<<range_example "17],[13">>
+<<wikitext-example-without-html
+"""<$list variable=n filter="[range[1.001],[8],[2]]" join=", "><<n>></$list>""">>
 
-<<range_example "1.001],[5],[1">>
+<<wikitext-example-without-html
+"""<$list variable=n filter="[range[.9],[1.1],[.004]]" join=", "><<n>></$list>""">>
 
-<<range_example ".5],[1.4],[.004">>