@wildwinter/toolkit 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @wildwinter/toolkit
 
+## 0.2.6
+
+### Added
+
+- **Views and reads in a manifest** (`./extensions`, tier 2): `views` declares the web components an extension's
+  installed package supplies, each with an `id`, a `name`, an `entry` script inside the package, the custom `element`
+  it defines, and optionally the `hosts` that offer it; `reads` names the other extensions whose data the views read.
+  The manifest check holds both to their shape. `viewsFor(manifest, host)` lists the views a host offers, and
+  `isViewEntry` keeps an entry inside its package.
+
+## 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

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,552 @@
           "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"
+        }
+      ]
+    },
+    {
+      "name": "views and reads pass",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "mood",
+                  "type": "text"
+                }
+              ]
+            }
+          }
+        },
+        "views": [
+          {
+            "id": "sheet",
+            "name": "Sheet",
+            "entry": "view/sheet.js",
+            "element": "probe-sheet"
+          },
+          {
+            "id": "cards",
+            "name": "Cards",
+            "entry": "cards.js",
+            "element": "probe-cards",
+            "hosts": [
+              "patter"
+            ]
+          }
+        ],
+        "reads": [
+          "patterstage"
+        ]
+      },
+      "problems": []
+    },
+    {
+      "name": "a view's shape is checked",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "mood",
+                  "type": "text"
+                }
+              ]
+            }
+          }
+        },
+        "views": [
+          {
+            "id": "Sheet",
+            "name": " ",
+            "entry": "../sheet.js",
+            "element": "sheet",
+            "colour": "red"
+          },
+          {
+            "id": "two",
+            "name": "Two",
+            "entry": "/abs/two.js",
+            "element": "Probe-Two",
+            "hosts": []
+          },
+          {
+            "id": "three",
+            "name": "Three",
+            "entry": "view\\three.js",
+            "element": "probe-three",
+            "hosts": [
+              "ink",
+              "storylets"
+            ]
+          },
+          {
+            "id": "three",
+            "name": "Again",
+            "entry": "view/again.mjs",
+            "element": "probe-three"
+          }
+        ]
+      },
+      "problems": [
+        {
+          "path": "views[0].colour",
+          "code": "unknown-key",
+          "severity": "warning"
+        },
+        {
+          "path": "views[0].id",
+          "code": "view-id"
+        },
+        {
+          "path": "views[0].name",
+          "code": "view-name"
+        },
+        {
+          "path": "views[0].entry",
+          "code": "view-entry"
+        },
+        {
+          "path": "views[0].element",
+          "code": "view-element"
+        },
+        {
+          "path": "views[1].entry",
+          "code": "view-entry"
+        },
+        {
+          "path": "views[1].element",
+          "code": "view-element"
+        },
+        {
+          "path": "views[1].hosts",
+          "code": "view-hosts"
+        },
+        {
+          "path": "views[2].entry",
+          "code": "view-entry"
+        },
+        {
+          "path": "views[2].hosts[0]",
+          "code": "unknown-host"
+        },
+        {
+          "path": "views[2].hosts[1]",
+          "code": "view-host-untargeted",
+          "severity": "warning"
+        },
+        {
+          "path": "views[3].id",
+          "code": "view-duplicate"
+        },
+        {
+          "path": "views[3].entry",
+          "code": "view-entry"
+        },
+        {
+          "path": "views[3].element",
+          "code": "view-duplicate"
+        }
+      ]
+    },
+    {
+      "name": "reads name other extensions, once each",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "mood",
+                  "type": "text"
+                }
+              ]
+            }
+          }
+        },
+        "reads": [
+          "patterstage",
+          "probe",
+          "patterstage",
+          "Bad"
+        ]
+      },
+      "problems": [
+        {
+          "path": "reads[1]",
+          "code": "reads-self",
+          "severity": "warning"
+        },
+        {
+          "path": "reads[2]",
+          "code": "reads-duplicate"
+        },
+        {
+          "path": "reads[3]",
+          "code": "reads-id"
+        }
+      ]
+    },
+    {
+      "name": "views and reads must be lists",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "mood",
+                  "type": "text"
+                }
+              ]
+            }
+          }
+        },
+        "views": {
+          "id": "sheet"
+        },
+        "reads": "patterstage"
+      },
+      "problems": [
+        {
+          "path": "views",
+          "code": "not-a-list"
+        },
+        {
+          "path": "reads",
+          "code": "not-a-list"
+        }
+      ]
     }
   ]
 }