@wildwinter/toolkit 0.2.7 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @wildwinter/toolkit
 
+## 0.3.1
+
+### Added
+
+- **Requirements in a manifest** (`./extensions`): `requires` names the other extensions, by id, that a project must
+  take for this one to work. The manifest check holds it to ids, each once, never the extension's own.
+  `missingRequirements(manifest, taken)` lists those a project lacks, for a host's Add Extension, its validation,
+  and its views.
+- **A view as a field's editor** (`./extensions`): a target's own map of records can name one of the manifest's views
+  as its `editor`, which a host opens in place of its own record grid. The check holds it to a declared view that
+  opens in that host, and warns of one on any other kind of field, where it means nothing.
+
+## 0.3.0
+
+### Removed
+
+- **Claims and settings** (`./extensions`): a manifest's `settings` and a target's `claims`, and with them
+  `ClaimDecl`, `SettingDecl`, `HostSpec.claimable`, `settingValues`, `resolvedClaims`, `claimClashes`, and
+  `effectiveClaim`. An extension's data is always its own; a project-wide value is a field on the `project` target.
+  A manifest that still has `settings` or `claims` is warned of by name (`removed-key`), and the key is ignored.
+
 ## 0.2.7
 
 ### Added

package/conformance/extensions/defaults.json

@@ -28,7 +28,7 @@
         { "name": "tone", "type": "enum", "values": ["calm", "tense"], "valueHelp": { "calm": "x" } },
         { "name": "act", "type": "quality", "stages": ["setup", "turn"], "renamedStages": { "opening": "setup" } },
         { "name": "cue", "type": "record", "fields": [{ "name": "gain", "type": "number", "min": 0, "help": "Loudness." }] }
-      ], "claims": [{ "setting": "moodField", "type": "text" }] },
+      ] },
       "compiled": [
         { "name": "note", "type": "text", "default": "", "required": true },
         { "name": "tone", "type": "enum", "values": ["calm", "tense"], "default": "calm" },

package/conformance/extensions/manifest.json

@@ -24,20 +24,13 @@
       "problems": []
     },
     {
-      "name": "every type, a claim and a setting pass together",
+      "name": "every type passes together",
       "manifest": {
         "schema": "wildwinter/extension@0",
         "id": "probe",
         "name": "Probe",
         "version": "2.1.0",
         "docs": "https://example.com/probe",
-        "settings": [
-          {
-            "name": "moodField",
-            "label": "Mood field",
-            "default": "mood"
-          }
-        ],
         "targets": {
           "storylets": {
             "card": {
@@ -170,17 +163,6 @@
                     "type": "text"
                   }
                 }
-              ],
-              "claims": [
-                {
-                  "setting": "moodField",
-                  "type": "enum",
-                  "values": [
-                    "calm",
-                    "tense"
-                  ],
-                  "help": "The card's mood."
-                }
               ]
             },
             "project": {
@@ -1013,159 +995,6 @@
         }
       ]
     },
-    {
-      "name": "claims: a claimable kind, a declared setting, a scalar, once per setting",
-      "manifest": {
-        "schema": "wildwinter/extension@0",
-        "id": "probe",
-        "name": "Probe",
-        "version": "1.0.0",
-        "settings": [
-          {
-            "name": "moodField",
-            "default": "mood"
-          }
-        ],
-        "targets": {
-          "storylets": {
-            "deck": {
-              "claims": [
-                {
-                  "setting": "moodField",
-                  "type": "text"
-                }
-              ]
-            },
-            "card": {
-              "claims": [
-                {
-                  "setting": "moodField",
-                  "type": "text"
-                },
-                {
-                  "setting": "moodField",
-                  "type": "text"
-                },
-                {
-                  "setting": "nope",
-                  "type": "text"
-                },
-                {
-                  "setting": "moodField",
-                  "type": "record",
-                  "fields": [
-                    {
-                      "name": "a",
-                      "type": "text"
-                    }
-                  ]
-                }
-              ]
-            }
-          }
-        }
-      },
-      "problems": [
-        {
-          "path": "targets.storylets.deck.claims[0]",
-          "code": "claim-kind"
-        },
-        {
-          "path": "targets.storylets.card.claims[1].setting",
-          "code": "claim-duplicate"
-        },
-        {
-          "path": "targets.storylets.card.claims[2].setting",
-          "code": "claim-setting"
-        },
-        {
-          "path": "targets.storylets.card.claims[3].type",
-          "code": "claim-type"
-        },
-        {
-          "path": "targets.storylets.card.claims[3].setting",
-          "code": "claim-duplicate"
-        }
-      ]
-    },
-    {
-      "name": "settings: named once each, defaulting to a field name",
-      "manifest": {
-        "schema": "wildwinter/extension@0",
-        "id": "probe",
-        "name": "Probe",
-        "version": "1.0.0",
-        "settings": [
-          {
-            "name": "a",
-            "default": "x"
-          },
-          {
-            "name": "a",
-            "default": "y"
-          },
-          {
-            "name": "b"
-          },
-          {
-            "name": "c",
-            "default": "not a name"
-          }
-        ],
-        "targets": {
-          "storylets": {
-            "card": {}
-          }
-        }
-      },
-      "problems": [
-        {
-          "path": "settings[1].name",
-          "code": "setting-duplicate"
-        },
-        {
-          "path": "settings[2].default",
-          "code": "setting-default"
-        },
-        {
-          "path": "settings[3].default",
-          "code": "setting-default"
-        }
-      ]
-    },
-    {
-      "name": "an enum claim may leave out its values, and its value help may describe values the host does not declare",
-      "manifest": {
-        "schema": "wildwinter/extension@0",
-        "id": "probe",
-        "name": "Probe",
-        "version": "1.0.0",
-        "settings": [
-          {
-            "name": "moodField",
-            "default": "mood"
-          }
-        ],
-        "targets": {
-          "storylets": {
-            "card": {
-              "claims": [
-                {
-                  "setting": "moodField",
-                  "type": "enum",
-                  "label": "Mood",
-                  "valueHelp": {
-                    "calm": "Unhurried.",
-                    "wild": "Not one the host has."
-                  }
-                }
-              ]
-            }
-          }
-        }
-      },
-      "problems": []
-    },
     {
       "name": "an enum field of the extension's own still lists its values",
       "manifest": {
@@ -1745,6 +1574,326 @@
           "code": "not-a-list"
         }
       ]
+    },
+    {
+      "name": "settings and claims were removed: each warned of by name, and ignored",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "settings": [
+          {
+            "name": "moodField",
+            "default": "mood"
+          }
+        ],
+        "targets": {
+          "storylets": {
+            "card": {
+              "fields": [
+                {
+                  "name": "tone",
+                  "type": "text"
+                }
+              ],
+              "claims": [
+                {
+                  "setting": "moodField",
+                  "type": "enum"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "settings",
+          "code": "removed-key",
+          "severity": "warning"
+        },
+        {
+          "path": "targets.storylets.card.claims",
+          "code": "removed-key",
+          "severity": "warning"
+        }
+      ]
+    },
+    {
+      "name": "requires and a field's editor pass",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "performance",
+                  "type": "map",
+                  "key": {
+                    "type": "text"
+                  },
+                  "of": {
+                    "type": "record",
+                    "fields": [
+                      {
+                        "name": "look",
+                        "type": "text"
+                      }
+                    ]
+                  },
+                  "editor": "sheet"
+                }
+              ]
+            }
+          }
+        },
+        "views": [
+          {
+            "id": "sheet",
+            "name": "Sheet",
+            "entry": "view/sheet.js",
+            "element": "probe-sheet",
+            "hosts": [
+              "patter"
+            ]
+          }
+        ],
+        "reads": [
+          "patterstage"
+        ],
+        "requires": [
+          "patterstage"
+        ]
+      },
+      "problems": []
+    },
+    {
+      "name": "requires names 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"
+                }
+              ]
+            }
+          }
+        },
+        "requires": [
+          "patterstage",
+          "probe",
+          "patterstage",
+          "Bad"
+        ]
+      },
+      "problems": [
+        {
+          "path": "requires[1]",
+          "code": "requires-self"
+        },
+        {
+          "path": "requires[2]",
+          "code": "requires-duplicate"
+        },
+        {
+          "path": "requires[3]",
+          "code": "requires-id"
+        }
+      ]
+    },
+    {
+      "name": "requires must be a list",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "mood",
+                  "type": "text"
+                }
+              ]
+            }
+          }
+        },
+        "requires": "patterstage"
+      },
+      "problems": [
+        {
+          "path": "requires",
+          "code": "not-a-list"
+        }
+      ]
+    },
+    {
+      "name": "a field's editor names a view that opens in its host, on a map of records",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "perf",
+                  "type": "map",
+                  "key": {
+                    "type": "text"
+                  },
+                  "of": {
+                    "type": "record",
+                    "fields": [
+                      {
+                        "name": "look",
+                        "type": "text",
+                        "editor": "sheet"
+                      }
+                    ]
+                  },
+                  "editor": "nope"
+                },
+                {
+                  "name": "cues",
+                  "type": "map",
+                  "key": {
+                    "type": "text"
+                  },
+                  "of": {
+                    "type": "record",
+                    "fields": [
+                      {
+                        "name": "at",
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "editor": 3
+                },
+                {
+                  "name": "mood",
+                  "type": "text",
+                  "editor": "sheet"
+                }
+              ]
+            }
+          },
+          "storylets": {
+            "card": {
+              "fields": [
+                {
+                  "name": "perf",
+                  "type": "map",
+                  "key": {
+                    "type": "text"
+                  },
+                  "of": {
+                    "type": "record",
+                    "fields": [
+                      {
+                        "name": "look",
+                        "type": "text"
+                      }
+                    ]
+                  },
+                  "editor": "sheet"
+                }
+              ]
+            }
+          }
+        },
+        "views": [
+          {
+            "id": "sheet",
+            "name": "Sheet",
+            "entry": "view/sheet.js",
+            "element": "probe-sheet",
+            "hosts": [
+              "patter"
+            ]
+          }
+        ]
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].of.fields[0].editor",
+          "code": "editor-nested"
+        },
+        {
+          "path": "targets.patter.line.fields[0].editor",
+          "code": "editor-view"
+        },
+        {
+          "path": "targets.patter.line.fields[1].editor",
+          "code": "editor-view"
+        },
+        {
+          "path": "targets.patter.line.fields[2].editor",
+          "code": "editor-ignored",
+          "severity": "warning"
+        },
+        {
+          "path": "targets.storylets.card.fields[0].editor",
+          "code": "editor-host"
+        }
+      ]
+    },
+    {
+      "name": "an editor names a view the manifest declares",
+      "manifest": {
+        "schema": "wildwinter/extension@0",
+        "id": "probe",
+        "name": "Probe",
+        "version": "1.0.0",
+        "targets": {
+          "patter": {
+            "line": {
+              "fields": [
+                {
+                  "name": "perf",
+                  "type": "map",
+                  "key": {
+                    "type": "text"
+                  },
+                  "of": {
+                    "type": "record",
+                    "fields": [
+                      {
+                        "name": "look",
+                        "type": "text"
+                      }
+                    ]
+                  },
+                  "editor": "sheet"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "problems": [
+        {
+          "path": "targets.patter.line.fields[0].editor",
+          "code": "editor-view"
+        }
+      ]
     }
   ]
 }

package/conformance/extensions/values.json

@@ -937,92 +937,6 @@
       ]
     }
   ],
-  "claims": [
-    {
-      "name": "a claim without values takes the host's, and keeps its own label, help and value help",
-      "claim": {
-        "setting": "moodField",
-        "type": "enum",
-        "label": "Mood",
-        "help": "How it feels.",
-        "valueHelp": {
-          "calm": "Unhurried.",
-          "wild": "Unused."
-        }
-      },
-      "host": {
-        "type": "enum",
-        "values": [
-          "calm",
-          "tense"
-        ],
-        "default": "calm"
-      },
-      "effective": {
-        "setting": "moodField",
-        "type": "enum",
-        "label": "Mood",
-        "help": "How it feels.",
-        "valueHelp": {
-          "calm": "Unhurried.",
-          "wild": "Unused."
-        },
-        "values": [
-          "calm",
-          "tense"
-        ],
-        "default": "calm"
-      }
-    },
-    {
-      "name": "a claim's own values stand",
-      "claim": {
-        "setting": "moodField",
-        "type": "enum",
-        "values": [
-          "calm"
-        ]
-      },
-      "host": {
-        "type": "enum",
-        "values": [
-          "calm",
-          "tense"
-        ]
-      },
-      "effective": {
-        "setting": "moodField",
-        "type": "enum",
-        "values": [
-          "calm"
-        ]
-      }
-    },
-    {
-      "name": "a quality claim takes the host's ladder, as a claimed field keeps the host's",
-      "claim": {
-        "setting": "actField",
-        "type": "quality",
-        "label": "Act"
-      },
-      "host": {
-        "type": "quality",
-        "stages": [
-          "setup",
-          "turn"
-        ]
-      },
-      "effective": {
-        "setting": "actField",
-        "type": "quality",
-        "label": "Act",
-        "stages": [
-          "setup",
-          "turn"
-        ]
-      }
-    }
-  ],
   "picks": [
     {
       "name": "choices in source order, each source's in its own",