registry: RangeController, ModeController, ToggleController with resources, presets and semantics

The three generic controllers are described in full and leave the stub table (62 stubs remain). A declaration
takes an instance name, friendly names from text() and asset(), and the options of the interface: range, unit and
presets for a range; supportedModes and ordered for a mode; semantics() for all three, with actions mapped to
directives and states mapped to a value or a range of values.

Refused at device.add(), each with the endpoint, interface and instance in the message: no instance name or no
friendly name; an instance declared twice; a first friendly name or a phrase used by another capability of the
endpoint; a reserved word, an asset id that is not in the catalog; range.max not above range.min; a preset off the
precision grid or outside the range; fewer than two modes or a mode listed twice; a mapping to a directive the
interface does not have, to a payload that does not fit, to a mode that is not listed, to AdjustMode on modes
that are not ordered; SetEcoOn, SetEcoOff, EcoOn and EcoOff on anything but a toggle.

For 1.x callers: Alexa.RangeController lists rangeValue (1.5.2 sent supported: []); addSupportedModes() announces
a mode given as a string as { value } and notes it, and takes { ordered: false } as a second argument, the default
stays true as 1.5.2 sent it (device.add() defaults to false). Declared the 1.x way, the zoo fan and curtain give
the same JSON as before.

Tests: the zoo blind, whose range, unit and semantics were written by hand into the JSON of 1.5.2, is declared
with device.add() and equals that JSON plus the Alexa capability; five capability objects of Amazon's examples
are reproduced the same way. 27 examples of four pages added. npm test: 108 pass (was 85) in 10.5-11.3 s, also on
Node 18.20.8 and 20.20.2.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

test/fixtures/alexa-docs/alexa-discovery-objects/actionMapping.json

@@ -0,0 +1,13 @@
+{
+  "@type": "ActionsToDirective",
+  "actions": [
+    "Alexa.Actions.Close",
+    "Alexa.Actions.Lower"
+  ],
+  "directive": {
+    "name": "SetRangeValue",
+    "payload": {
+      "rangeValue": 0
+    }
+  }
+}

test/fixtures/alexa-docs/alexa-discovery-objects/semantics.json

@@ -0,0 +1,51 @@
+{
+  "semantics": {
+    "actionMappings": [
+      {
+        "@type": "ActionsToDirective",
+        "actions": [
+          "Alexa.Actions.Close",
+          "Alexa.Actions.Lower"
+        ],
+        "directive": {
+          "name": "SetRangeValue",
+          "payload": {
+            "rangeValue": 0
+          }
+        }
+      },
+      {
+        "@type": "ActionsToDirective",
+        "actions": [
+          "Alexa.Actions.Open",
+          "Alexa.Actions.Raise"
+        ],
+        "directive": {
+          "name": "SetRangeValue",
+          "payload": {
+            "rangeValue": 100
+          }
+        }
+      }
+    ],
+    "stateMappings": [
+      {
+        "@type": "StatesToValue",
+        "states": [
+          "Alexa.States.Closed"
+        ],
+        "value": 0
+      },
+      {
+        "@type": "StatesToRange",
+        "states": [
+          "Alexa.States.Open"
+        ],
+        "range": {
+          "minimumValue": 1,
+          "maximumValue": 100
+        }
+      }
+    ]
+  }
+}

test/fixtures/alexa-docs/alexa-discovery-objects/stateMapping.json

@@ -0,0 +1,10 @@
+{
+  "@type": "StatesToRange",
+  "states": [
+    "Alexa.States.Open"
+  ],
+  "range": {
+    "minimumValue": 1,
+    "maximumValue": 100
+  }
+}