@wildwinter/toolkit 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @wildwinter/toolkit
 
+## 0.2.5
+
+### Added
+
+- **A `pick` value type** (`./extensions`): one choice from the sources a manifest names in `from`, in order:
+  fixed `words`, the nodes of a reference kind (`to`), and a list of text on the extension's own project node
+  (`list`). The value is text; empty is automatic. The manifest check holds each source to its shape and each
+  `list` to a list of text on the project target. `valueProblems` reports a value no source holds
+  (`not-a-choice`) and one two sources hold (`pick-ambiguous`, a warning), given the host's lists in the new
+  `ValueContext.list`. `pickChoices` lists the choices for an editor, `pickClashes` reports each name two sources
+  hold once for the project, and `pickLists` reads the lists off the project entry.
+
+## 0.2.4
+
+### Added
+
+- **Find by field value**: `parseFieldQuery`, `fieldNameMatches`, `fieldValueMatches` and `fieldValueText`, so the
+  Field tabs in Storyletter's and Patterpad's Find windows read `mood = tense` by one rule. A value matches by its
+  field's type (text, enum and quality without case, flags by membership, numbers numerically, booleans by word),
+  `!=` negates, and a bare field name matches any value.
+
 ## 0.2.3
 
 ### Added

package/README.md

@@ -73,6 +73,20 @@ matcher, or `null` for an empty query. The query is **escaped**: somebody typing
 `a.b` means those three characters, not "a, anything, b". Always global, so
 every occurrence in a string is replaced rather than only the first.
 
+Find by field value, the Field tab both families' Find windows have. Each app
+walks its own project for the values; these say what a query means, so
+`mood = tense` reads the same in both:
+
+- `parseFieldQuery(query)`: `mood`, `mood = tense`, `mood != tense`,
+  `ext.field = "two words"`, or `null` when it is not a field name.
+- `fieldNameMatches(name, query)`: names compare without case.
+- `fieldValueMatches(type, value, query)`: by the field's type. Text, enum and
+  quality compare without case, flags match when the list includes the flag
+  (`= ""` is none set), numbers numerically, booleans as `true` or `false`.
+  `!=` is the opposite, and no operator matches any value. Pass the value that
+  holds, the default where the node sets none.
+- `fieldValueText(type, value)`: the value as a row shows it.
+
 ## Archive
 
 A separate, node-only entry point, because it imports `node:path`:

package/conformance/extensions/defaults.json

@@ -11,6 +11,7 @@
     { "name": "flags: none", "decl": { "name": "a", "type": "flags", "values": ["x"] }, "default": [] },
     { "name": "quality: the first stage", "decl": { "name": "a", "type": "quality", "stages": ["p", "q"] }, "default": "p" },
     { "name": "reference: none", "decl": { "name": "a", "type": "reference", "to": "card" }, "default": "" },
+    { "name": "pick: automatic", "decl": { "name": "a", "type": "pick", "from": [{ "words": ["all"] }, { "to": "cast" }] }, "default": "" },
     { "name": "record: each field's default", "decl": { "name": "a", "type": "record", "fields": [
       { "name": "s", "type": "text" }, { "name": "n", "type": "number", "default": 2 }, { "name": "q", "type": "quality", "stages": ["p", "q"] }
     ] }, "default": { "n": 2, "q": "p", "s": "" } },

package/conformance/extensions/manifest.json

@@ -1124,6 +1124,320 @@
           "code": "value-help"
         }
       ]
+    },
+    {
+      "name": "a pick over words, a node kind and a project list passes",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "words": [
+                        "all"
+                      ]
+                    },
+                    {
+                      "to": "cast"
+                    },
+                    {
+                      "list": "pointsOfInterest"
+                    }
+                  ]
+                }
+              ]
+            },
+            "project": {
+              "fields": [
+                {
+                  "name": "pointsOfInterest",
+                  "type": "list",
+                  "of": {
+                    "type": "text"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": []
+    },
+    {
+      "name": "a pick inside a record passes, its list checked",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "look",
+                  "type": "record",
+                  "fields": [
+                    {
+                      "name": "at",
+                      "type": "pick",
+                      "from": [
+                        {
+                          "list": "pointsOfInterest"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            },
+            "project": {
+              "fields": [
+                {
+                  "name": "pointsOfInterest",
+                  "type": "list",
+                  "of": {
+                    "type": "text"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": []
+    },
+    {
+      "name": "a pick with no sources",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].from",
+          "code": "pick-from"
+        }
+      ]
+    },
+    {
+      "name": "a pick source is one of words, to and list",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "words": [
+                        "all"
+                      ],
+                      "to": "cast"
+                    },
+                    {}
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].from[0]",
+          "code": "pick-source"
+        },
+        {
+          "path": "targets.patter.line.fields[0].from[1]",
+          "code": "pick-source"
+        }
+      ]
+    },
+    {
+      "name": "a pick's nodes are of a kind the host references",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "to": "card"
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].from[0].to",
+          "code": "reference-to"
+        }
+      ]
+    },
+    {
+      "name": "a pick's words are named, once each",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "words": [
+                        "all",
+                        "",
+                        "all"
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].from[0].words[1]",
+          "code": "value-empty"
+        },
+        {
+          "path": "targets.patter.line.fields[0].from[0].words[2]",
+          "code": "value-duplicate"
+        }
+      ]
+    },
+    {
+      "name": "a pick's list is a list of text on the project node",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "to",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "list": "pointsOfInterest"
+                    },
+                    {
+                      "list": "moods"
+                    }
+                  ]
+                }
+              ]
+            },
+            "project": {
+              "fields": [
+                {
+                  "name": "moods",
+                  "type": "list",
+                  "of": {
+                    "type": "number"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].from[0].list",
+          "code": "pick-list"
+        },
+        {
+          "path": "targets.patter.line.fields[0].from[1].list",
+          "code": "pick-list"
+        }
+      ]
+    },
+    {
+      "name": "a pick's default must be a choice when its words are all it has",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "favour",
+                  "type": "pick",
+                  "from": [
+                    {
+                      "words": [
+                        "speaker"
+                      ]
+                    }
+                  ],
+                  "default": "crowd"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].default",
+          "code": "default-misfit"
+        }
+      ]
     }
   ]
 }