Merge branch 'master' into feat-ai-tools

editions/tw5.com/tiddlers/Operators without parameters.tid

@@ -0,0 +1,18 @@
+created: 20240708171243370
+modified: 20240708201827711
+tags: 
+title: Operators without parameters
+
+Many [[Filter Operators]] have no [[parameter|Filter Parameter]] available. Still, each operator must be followed by a bracketed parameter expression — even if it is empty — as with the <<.olink backlinks>> operator below:
+
+`[<currentTiddler>backlinks[]]`
+
+(Even though an expression such as `[<currentTiddler>backlinks]` may at first <<.em seem>> well-formed — insofar as closing brackets seem to pair properly with opening brackets — each operator needs its own parameter brackets, even if empty. See [[Filter Syntax]].)
+
+The following [[Filter Operators]] accept no parameters:
+
+<div>
+
+<<list-links filter:"[op-parameter[none]] [tag[Filter Operators]!has[op-parameter]] -[search:op-purpose[same]]" class:"multi-columns">>
+
+</div>

editions/tw5.com/tiddlers/Selection Constructors Conditional.tid

@@ -0,0 +1,9 @@
+created: 20240708174435694
+modified: 20240708175546166
+title: Selection Constructors: Conditional
+
+Most [[filter Operators|filter Operator]] are either ''selection modifiers'' or [[Selection Constructors]].
+
+Within the exceptional category <<tag>> are a tiny minority that //usually// act as ''selection modifiers'', but which can construct a fresh selection under special conditions — namely, whenever their [[parameter|Filter Parameter]] is specified with a selection constructor.
+
+<<list-links "[tag<currentTiddler>]">>

editions/tw5.com/tiddlers/concepts/Dominant Append.tid

@@ -1,5 +1,5 @@
 created: 20150123220223000
-modified: 20190610165255223
+modified: 20240709170746678
 tags: Filters
 title: Dominant Append
 type: text/vnd.tiddlywiki
@@ -13,3 +13,5 @@ For example, if a selection contains `Andrew Becky Clara Daniel` and `Andrew Bar
 This behaviour can cause unexpected results when working with [[Mathematics Operators]]. For example, `1 2 3 +[sum[]]` evaluates to `6`, as expected. But `1 1 1 +[sum[]]` evaluates to `1`. Removing the `+[sum[]]` from each filter reveals the problem: `1 2 3` evaluates to the list `1`, `2`, `3`, while `1 1 1` evaluates to the single item `1` due to de-duplication.
 
 In such situations, the `=` prefix can be used to disable the de-duplication. For example, `=1 =1 =1 +[sum[]]` evaluates to `3` as expected. Alternatively, the [[split Operator]] can be used: `[[1,1,1]split[,]sum[]]`.
+
+<<.tip """To build a list of unique values that retains only the <<.em earliest>> copy of each value (the opposite behavior from <<.link "Dominant Append" "Dominant Append">>), first use the <<.link `:all` "All Filter Run Prefix">> filter run prefix (or its short form `=`) to retain all duplicate values while building your list. Then finish your filter run with the <<.olink unique>> operator to remove later duplicates.""">>

editions/tw5.com/tiddlers/concepts/Selection Constructors.tid

@@ -1,5 +1,5 @@
 created: 20150117204109000
-modified: 20150917193713204
+modified: 20240708201746542
 tags: Filters
 title: Selection Constructors
 type: text/vnd.tiddlywiki
@@ -11,3 +11,7 @@ The output of a [[Filter Step]] depends on its [[operator|Filter Operators]]:
 * A few operators ignore their input and generate an independent output instead. These are called <<.def "selection constructors">>: they construct an entirely new [[selection|Title Selection]].
 
 A good example of a constructor is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is a modifier, so `[title[A]field:title[B]` outputs nothing at all.
+
+The following [[filter Operators|filter Operator]] are tagged <<tag>>:
+
+<<list-links "[tag<currentTiddler>]" class:"multi-columns">>

editions/tw5.com/tiddlers/filters/minlength.tid

@@ -1,12 +1,12 @@
 caption: minlength
 created: 20161011074235805
 from-version: 5.1.14
-modified: 20240621073052597
+modified: 20240709161140504
 op-input: a list of items
 op-output: those items at least as long as the specified minimum length
 op-parameter: the minimum length for items
 op-parameter-name: minlength
-op-purpose: filter items whose length is greater than the specified minimum length
+op-purpose: filter items whose length is greater than or equal to the specified minimum length
 tags: [[Filter Operators]]
 title: minlength Operator
 type: text/vnd.tiddlywiki

editions/tw5.com/tiddlers/filters/syntax/Filter Parameter.tid

@@ -1,5 +1,5 @@
 created: 20150220152540000
-modified: 20230710074423650
+modified: 20240708202234843
 tags: [[Filter Step]]
 title: Filter Parameter
 type: text/vnd.tiddlywiki
@@ -29,6 +29,8 @@ The parameter to a [[filter operator|Filter Operators]] can be:
 :: The parameter is the current value of the [[variable|Variables]] whose name appears between the angle brackets. Macro parameters are <<.em not>> supported up to v5.2.0
 ::<<.from-version "5.2.0">> Literal macro parameters are supported. For example: `[<now [UTC]YYYY0MM0DD0hh0mm0ssXXX>]`.
 
+<<.note """Every [[filter Operator]] must be followed by a parameter expression. In the case of [[Operators without parameters]], that expression is empty, as with the filter Operator <<.olink links>> in `[<currentTiddler>links[]]`.""">>
+
 ---
 
 <<.from-version "5.1.23">>  [[Filter Step]]s support multiple parameters which are separated by a `,` character.

editions/tw5.com/tiddlers/filters/unique.tid

@@ -1,4 +1,6 @@
 caption: unique
+created: 20240709151018238
+modified: 20240709151336906
 op-input: a list of items
 op-output: a list of unique items
 op-parameter: ignored
@@ -7,4 +9,6 @@ tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
 title: unique Operator
 type: text/vnd.tiddlywiki
 
+<<.note """Unlike the default <<.link "Dominant Append" "Dominant Append">> handling of duplication, the effect of <<.op unique>> is to retain only the <<.em earliest>> instance among duplicated values.""">>
+
 <<.operator-examples "unique">>

editions/tw5.com/tiddlers/hellothere/HelloThere.tid

@@ -1,6 +1,6 @@
 created: 20130822170200000
 list: [[A Gentle Guide to TiddlyWiki]] [[Discover TiddlyWiki]] [[Some of the things you can do with TiddlyWiki]] [[Ten reasons to switch to TiddlyWiki]] Examples [[What happened to the original TiddlyWiki?]]
-modified: 20240627165458407
+modified: 20240710115948992
 tags: TableOfContents
 title: HelloThere
 type: text/vnd.tiddlywiki

editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid

@@ -1,6 +1,6 @@
 caption: tag-picker
 created: 20161128191316701
-modified: 20230616114543787
+modified: 20240708175550512
 tags: Macros [[Core Macros]]
 title: tag-picker Macro
 type: text/vnd.tiddlywiki
@@ -19,7 +19,8 @@ The <<.def tag-picker>> [[macro|Macros]] generates a combination of a text box a
 : <<.from-version 5.3.4>> Defines the target tiddler, which should be manipulated. Defaults to: <<.var currentTiddler>>.
 
 ; tagListFilter
-: <<.from-version 5.3.4>> This parameter defaults to: `[tags[]]` which creates a list of all existing tags. If the tag list should come from a different source the filter should look similar to eg: `[<listSource>get[field-name]enlist-input[]]`. 
+: <<.from-version 5.3.4>> This parameter defaults to: `[tags[]]` which creates a list of all existing tags. If the tag list should come from a different source the filter should look similar to eg: `[<listSource>get[field-name]enlist-input[]]`. See examples.
+: <<.from-version 5.3.5>> This parameter defaults to: `[tags[]sort[]]`. This change allows a custom sort order, since `sort[]` is not hardcoded into the tag-picker macro anymore. 
 
 
 <<.macro-examples "tag-picker">>

editions/tw5.com/tiddlers/releasenotes/Release 5.3.5.tid

@@ -0,0 +1,49 @@
+caption: 5.3.5
+created: 20240710115948992
+modified: 20240710115948992
+tags: ReleaseNotes
+title: Release 5.3.5
+type: text/vnd.tiddlywiki
+description: Under development
+
+//[[See GitHub for detailed change history of this release|https://github.com/Jermolene/TiddlyWiki5/compare/v5.3.4...v5.3.5]]//
+
+<<.banner-credits
+	credit:"""Congratulations to [[duarte.framos|https://talk.tiddlywiki.org/u/duarte.framos]] for their winning design for the banner for this release (here is the [[competition thread|https://talk.tiddlywiki.org/t/banner-image-competition-for-v5-3-4/9940]]).
+"""
+	url:"https://raw.githubusercontent.com/Jermolene/TiddlyWiki5/a9b6de8c35f0789a27a36218e8422bb11066f115/editions/tw5.com/tiddlers/images/New%20Release%20Banner.png"
+>>
+
+This is a bug fix release to address a number of bugs that were introduced with [[Release 5.3.4]].
+
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8327">> backwards compatibility issues with [[colour Macro]] as a procedure
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8322">> typo extra "tags: "
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8332">> adding fields without clicking the "add" button
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8317">> stability badges colors in the Gruvbox, Nord and Solarized palettes
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8333">> crash with DataWidget if `$filter` attribute specifies a missing tiddler
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/6554b5c9f4f6888f0c25c833b775c3a74ea15531">> reapplies [[#8246 Link to correct plugin instructions for Node.js|https://github.com/Jermolene/TiddlyWiki5/pull/8246]] which had accidentally been reverted
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/d2c2ada33ccd3d73d39d8c0461f327e4dee68234">> tour display in "zoomin" storyview
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/commit/8f1792df2059378db0f038c563551373e5d95fbe">> test case import icon
+* <<.link-badge-fixed "https://github.com/Jermolene/TiddlyWiki5/pull/8354">> crash when editing JSON text of a plugin tiddler
+
+! Acknowledgements for v5.3.5
+
+[[@Jermolene|https://github.com/Jermolene]] would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
+
+<<.contributors """
+andrewgoz
+btheado
+Leilei332
+michaeljmcd
+oeyoews
+pmario
+springerspandrel
+""">>
+
+---
+
+! Release Note for v5.3.4
+
+Since v5.3.5 replaces v5.3.4 after only a couple of weeks, here is the release note for v5.3.4.
+
+{{Release 5.3.4}}

editions/tw5.com/tiddlers/system/SiteTitle.tid

@@ -3,4 +3,4 @@ modified: 20131211131023829
 title: $:/SiteTitle
 type: text/vnd.tiddlywiki
 
-TiddlyWiki AI Tools Plugin
+TiddlyWiki AI Tools Plugin

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

@@ -1,13 +1,13 @@
 created: 20230616104546608
-modified: 20240214174032498
+modified: 20240708132312901
 tags: [[tag-picker Macro]] [[Macro Examples]]
 title: tag-picker Macro (Examples)
 type: text/vnd.tiddlywiki
 
-<<.warning """The first example will set the tag of the <<.tid currentTiddler>> so you should copy / paste it to a new tiddler for testing. Otherwise you'll change "this tiddler" """>>
+<<.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" """>>
 
-<$macrocall $name=".example" n="1"
-eg="""Use all existing tags and set the ''tags'' field here: <<tag-picker>>
+<$transclude $variable=".example" n="1"
+eg="""Add tags to this tiddler's ''tags'' field (selecting from a list of all tags): <<tag-picker>>
 """/>
 
 ----
@@ -17,41 +17,41 @@ eg="""Use all existing tags and set the ''tags'' field here: <<tag-picker>>
 <<.tip """The following examples use a temporary tiddler: $:/temp/test/tag-picker. So this tiddler will not be changed """>>
 
 
-<$macrocall $name=".example" n="2" 
+<$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]] }}}/>
 
-Use all existing tags and set the $:/temp/test/tag-picker ''tags'' field: <<tag-picker tiddler:"$:/temp/test/tag-picker">>
+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 """>>
 
-<$macrocall $name=".example" n="3" 
+<$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]] }}}/>
 
-Use all existing tags and set the $:/temp/test/tag-picker ''foo'' field: <<tag-picker tagField:"foo"  tiddler:"$:/temp/test/tag-picker">>
+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.""">>
 
-<$macrocall $name=".example" n="4" eg="""\procedure listSource() $:/temp/test/tag-picker
+<$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]] }}}/>
 
-Use $:/temp/test/tag-picker ''foo'' field as source and set ''bar'': <<tag-picker tagField:"bar" tagListFilter:"[<listSource>get[foo]enlist-input[]]" tiddler:"$:/temp/test/tag-picker">>
+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 tiddlers foo-field. New tags can be entered by typing into the tag-name input
+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
 """>>
 
-<$macrocall $name=".example" n="5" eg="""
+<$transclude $variable=".example" n="5" eg="""
 \procedure listSource() $:/temp/test/tag-picker
 \procedure listSourceField() foo
 
@@ -62,7 +62,7 @@ It will also add completely new tags to the bar-field and the source tiddlers fo
 $:/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]] }}}/>
 
-Use $:/temp/test/tag-picker ''foo'' field as source and set ''bar'': <$macrocall $name="tag-picker" tagField="bar" tagListFilter="[<listSource>get<listSourceField>enlist-input[]]" tiddler="$:/temp/test/tag-picker" actions=<<addNewTagToSource>>/>
+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>>/>
 
 """/>