registry: describe an Alexa interface as data

src/registry/ holds what the library knows about an interface: namespace, version, the page it was read from,
properties with their value schemas and directives with their payload schemas. Five interfaces are described
(Alexa, PowerController, BrightnessController, TemperatureSensor, EndpointHealth); the other 65 names of
AlexaInterfaceType are stubs with the version and property names of 1.5.2. schema.ts is the run-time check behind
it (241 lines, no new dependency), catalog.ts the vocabularies of the pages: 103 assets (23 units), 6 actions,
9 states, 56 display categories, 22 reserved words, 73 error types under 11 namespaces.

AlexaInterface.getVersion() and getProps() read the registry; the two switch statements are gone (-167 lines).
On the wire: Alexa.EndpointHealth is announced at 3.1 (was 3.3; the page is titled 3.1 and no page mentions 3.3),
and TimeHoldController and Camera.LiveViewController at 3 and 1.7 (1.5.2 sent the string "UNKNOWN").
DisplayCategory gains VACUUM. New exports: registry, DeclarationError, SchemaError, Assets, Units, Actions,
States, DisplayCategories and the descriptor types.

Tests: 20 JSON examples of the five pages under test/fixtures/alexa-docs; every directive payload and property
value in them parses with its descriptor. npm test: 57 pass (was 30) in 10.8 s, also on Node 18.20.8 and 20.20.2.

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

dist/cjs/registry/index.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaError = exports.s = exports.defineInterface = exports.DeclarationError = exports.TemperatureSensor = exports.PowerController = exports.EndpointHealth = exports.BrightnessController = exports.Alexa = exports.registry = void 0;
+// The interfaces the library knows, by namespace.
+const Alexa_js_1 = require("./interfaces/Alexa.js");
+Object.defineProperty(exports, "Alexa", { enumerable: true, get: function () { return Alexa_js_1.Alexa; } });
+const BrightnessController_js_1 = require("./interfaces/BrightnessController.js");
+Object.defineProperty(exports, "BrightnessController", { enumerable: true, get: function () { return BrightnessController_js_1.BrightnessController; } });
+const EndpointHealth_js_1 = require("./interfaces/EndpointHealth.js");
+Object.defineProperty(exports, "EndpointHealth", { enumerable: true, get: function () { return EndpointHealth_js_1.EndpointHealth; } });
+const PowerController_js_1 = require("./interfaces/PowerController.js");
+Object.defineProperty(exports, "PowerController", { enumerable: true, get: function () { return PowerController_js_1.PowerController; } });
+const TemperatureSensor_js_1 = require("./interfaces/TemperatureSensor.js");
+Object.defineProperty(exports, "TemperatureSensor", { enumerable: true, get: function () { return TemperatureSensor_js_1.TemperatureSensor; } });
+const stubs_js_1 = require("./interfaces/stubs.js");
+const types_js_1 = require("./types.js");
+const described = [
+    Alexa_js_1.Alexa,
+    BrightnessController_js_1.BrightnessController,
+    EndpointHealth_js_1.EndpointHealth,
+    PowerController_js_1.PowerController,
+    TemperatureSensor_js_1.TemperatureSensor,
+];
+const descriptors = new Map();
+for (const descriptor of [...described, ...stubs_js_1.STUBS]) {
+    // A stub left in the table next to the descriptor that replaces it would win or lose by the order of this list
+    if (descriptors.has(descriptor.namespace))
+        throw new Error(`${descriptor.namespace} is described twice`);
+    descriptors.set(descriptor.namespace, descriptor);
+}
+exports.registry = {
+    /** Whether an interface of this name is known. */
+    has(namespace) {
+        return descriptors.has(namespace);
+    },
+    /** The descriptor of "Alexa.RangeController" or of AlexaInterfaceType.RANGE_CONTROLLER, which is that string. */
+    get(namespace) {
+        const descriptor = descriptors.get(namespace);
+        if (!descriptor)
+            throw new types_js_1.DeclarationError({}, `${JSON.stringify(namespace)} is not an interface alex2node knows`);
+        return descriptor;
+    },
+    /** Every descriptor, ordered by namespace. */
+    list() {
+        return [...descriptors.values()].sort((a, b) => (a.namespace < b.namespace ? -1 : 1));
+    },
+};
+var types_js_2 = require("./types.js");
+Object.defineProperty(exports, "DeclarationError", { enumerable: true, get: function () { return types_js_2.DeclarationError; } });
+Object.defineProperty(exports, "defineInterface", { enumerable: true, get: function () { return types_js_2.defineInterface; } });
+var schema_js_1 = require("./schema.js");
+Object.defineProperty(exports, "s", { enumerable: true, get: function () { return schema_js_1.s; } });
+Object.defineProperty(exports, "SchemaError", { enumerable: true, get: function () { return schema_js_1.SchemaError; } });
+__exportStar(require("./catalog.js"), exports);