@openmixer/plugin-qualify 0.13.0 → 0.13.1

package/dist/hosting-codes.d.ts

@@ -1,91 +1,17 @@
 /**
- * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
- * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
- * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default —
- * a packaged plugin-qualify's runtime has no `pkg-config` binary to ask.
+ * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
+ * locale.
+ *
+ * omx-clap-core declares every hosting code: one `HOSTING_<DIMENSION>_CODES` table per dimension,
+ * in the TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
+ * (BUILDING.md). {@link HOSTING_CODE} is those tables flattened into one `key: code` map, written
+ * as plain data into `hosting-codes.generated.ts` by `tools/gen-hosting-codes.mjs` at build time:
+ * a code omx-clap-core does not declare cannot be named here, and this module reads no file and
+ * imports no `node:` module, so every public subpath that reaches it bundles for a browser.
+ * `src/contract-vocabulary-conformance.test.ts` holds the generated map to omx-clap-core's real
+ * modules, either way.
  */
-export declare function clapCoreTsDirCandidates(env?: Readonly<Record<string, string | undefined>>): readonly string[];
-/** True for an export name that is one of omx-clap-core's hosting tables. */
-export declare function isHostingTableName(name: string): boolean;
-/**
- * omx-clap-core's hosting codes, by key, across its two TypeScript modules — hand-kept here
- * (not derived from a static import: the source is a runtime-resolved install directory, not an
- * npm dependency) and held to the real modules by
- * `src/contract-vocabulary-conformance.test.ts`, which turns red on any drift either way.
- */
-export interface HostingCodeTable {
-    readonly clapExtensionsNotCovered: "hosting.clap.extensions-not-covered";
-    readonly clapFormatNotHosted: "hosting.clap.format-not-hosted";
-    readonly clapHeadlessFailed: "hosting.clap.headless-failed";
-    readonly clapLatencyMismatch: "hosting.clap.latency-mismatch";
-    readonly clapNoteInput: "hosting.clap.note-input";
-    readonly clapProcessError: "hosting.clap.process-error";
-    readonly clapThreadViolation: "hosting.clap.thread-violation";
-    readonly clapUnqualified: "hosting.clap.unqualified";
-    readonly costAboveCeiling: "hosting.cost.above-ceiling";
-    readonly costFieldsMissing: "hosting.cost.fields-missing";
-    readonly costSpiky: "hosting.cost.spiky-tail";
-    readonly costUnmeasured: "hosting.cost.unmeasured-at-rate-and-quantum";
-    readonly costWithinCeiling: "hosting.cost.within-ceiling";
-    readonly featuresAtomInUnfed: "hosting.features.atom-in-unfed";
-    readonly featuresDisqualifying: "hosting.features.host-not-provided";
-    readonly featuresMidiIn: "hosting.features.midi-in-fed-empty";
-    readonly featuresMissing: "hosting.features.missing";
-    readonly featuresPortsUnreadable: "hosting.features.ports-unreadable";
-    readonly featuresProvided: "hosting.features.all-provided";
-    readonly featuresUnscanned: "hosting.features.scan-predates-field";
-    readonly idleHoldRefused: "hosting.idle.hold-refused";
-    readonly latencyNonconforming: "hosting.latency.nonconforming";
-    readonly latencyParameterDependent: "hosting.latency.parameter-dependent";
-    readonly latencyResolved: "hosting.latency.resolved";
-    readonly latencyUnmeasured: "hosting.latency.unmeasured";
-    readonly outputNonFinite: "hosting.output.non-finite";
-    readonly overrideIsolated: "hosting.override.curator-isolated";
-    readonly patchBusy: "hosting.patch.busy";
-    readonly patchNotWritable: "hosting.patch.not-writable";
-    readonly patchTooLarge: "hosting.patch.too-large";
-    readonly presetNotFound: "hosting.preset.not-found";
-    readonly hostProvenanceDiffers: "hosting.provenance.host-differs";
-    readonly sweepControlDidNotFire: "hosting.provenance.sweep-control-did-not-fire";
-    readonly disabled: "hosting.disabled";
-    readonly linked: "hosting.linked";
-    readonly noRealisation: "hosting.no-realisation";
-    readonly realisedInProcess: "hosting.realised.in-process";
-    readonly unjudged: "hosting.unjudged";
-    readonly rtSafetyClean: "hosting.rt-safety.clean-under-sweep";
-    readonly rtSafetyNotReproducible: "hosting.rt-safety.not-reproducible";
-    readonly rtSafetyNotesClean: "hosting.rt-safety.clean-under-notes";
-    readonly rtSafetyNotesUnmeasured: "hosting.rt-safety.notes-unmeasured";
-    readonly rtSafetyNotesViolations: "hosting.rt-safety.violations-under-notes";
-    readonly rtSafetyUnmeasured: "hosting.rt-safety.unmeasured";
-    readonly rtSafetyViolations: "hosting.rt-safety.violations-in-run";
-    readonly stabilityBelowFloor: "hosting.stability.cycles-below-floor";
-    readonly stabilityCrashUnattributed: "hosting.stability.crash-unattributed";
-    readonly stabilityCrashedAttributed: "hosting.stability.crashed-attributed-plugin";
-    readonly stabilityCrashedLive: "hosting.stability.crashed-live-on-this-rig";
-    readonly stabilityLinksGuiToolkit: "hosting.stability.links-gui-toolkit";
-    readonly stabilitySoakFailedAtRate: "hosting.stability.soak-failed-at-rate";
-    readonly stabilitySoaked: "hosting.stability.soaked";
-    readonly stabilitySpawnsThreads: "hosting.stability.spawns-threads";
-    readonly stabilityUnmeasured: "hosting.stability.unmeasured";
-    readonly stabilityUnsoaked: "hosting.stability.unsoaked";
-    readonly stateNotACopy: "hosting.state.not-a-copy";
-    readonly statePathOnAudio: "hosting.state.path-on-audio";
-    readonly statePathOutside: "hosting.state.path-outside";
-    readonly statePathSymlink: "hosting.state.path-symlink";
-    readonly statePathTooLong: "hosting.state.path-too-long";
-    readonly statePathUnmakeable: "hosting.state.path-unmakeable";
-    readonly stateUnreadable: "hosting.state.unreadable";
-    readonly topologyAmbisonicConfig: "hosting.topology.ambisonic-config";
-    readonly topologyChannelMapUnknown: "hosting.topology.channel-map-unknown";
-    readonly topologyInstrument: "hosting.topology.instrument";
-    readonly topologyMatched: "hosting.topology.matched";
-    readonly topologyNoAudioInput: "hosting.topology.no-audio-input";
-    readonly topologyNoAudioOutput: "hosting.topology.no-audio-output";
-    readonly topologyPortTooWide: "hosting.topology.port-too-wide";
-    readonly topologyPortWithoutChannels: "hosting.topology.port-without-channels";
-    readonly topologyTooManyPorts: "hosting.topology.too-many-ports";
-    readonly topologyWiderThanStrip: "hosting.topology.wider-than-strip";
-    readonly workerNonconforming: "hosting.worker.nonconforming";
-}
-export declare const HOSTING_CODE: HostingCodeTable;
+import { HOSTING_CODE } from "./hosting-codes.generated.js";
+export { HOSTING_CODE };
+/** {@link HOSTING_CODE}'s type: each key's literal code. */
+export type HostingCodeTable = typeof HOSTING_CODE;

package/dist/hosting-codes.generated.d.ts

@@ -0,0 +1,76 @@
+/** omx-clap-core's hosting codes, by key: every `HOSTING_<DIMENSION>_CODES` table, flattened. */
+export declare const HOSTING_CODE: Readonly<{
+    readonly clapExtensionsNotCovered: "hosting.clap.extensions-not-covered";
+    readonly clapFormatNotHosted: "hosting.clap.format-not-hosted";
+    readonly clapHeadlessFailed: "hosting.clap.headless-failed";
+    readonly clapLatencyMismatch: "hosting.clap.latency-mismatch";
+    readonly clapNoteInput: "hosting.clap.note-input";
+    readonly clapProcessError: "hosting.clap.process-error";
+    readonly clapThreadViolation: "hosting.clap.thread-violation";
+    readonly clapUnqualified: "hosting.clap.unqualified";
+    readonly costAboveCeiling: "hosting.cost.above-ceiling";
+    readonly costFieldsMissing: "hosting.cost.fields-missing";
+    readonly costSpiky: "hosting.cost.spiky-tail";
+    readonly costUnmeasured: "hosting.cost.unmeasured-at-rate-and-quantum";
+    readonly costWithinCeiling: "hosting.cost.within-ceiling";
+    readonly featuresAtomInUnfed: "hosting.features.atom-in-unfed";
+    readonly featuresDisqualifying: "hosting.features.host-not-provided";
+    readonly featuresMidiIn: "hosting.features.midi-in-fed-empty";
+    readonly featuresMissing: "hosting.features.missing";
+    readonly featuresPortsUnreadable: "hosting.features.ports-unreadable";
+    readonly featuresProvided: "hosting.features.all-provided";
+    readonly featuresUnscanned: "hosting.features.scan-predates-field";
+    readonly latencyNonconforming: "hosting.latency.nonconforming";
+    readonly latencyParameterDependent: "hosting.latency.parameter-dependent";
+    readonly latencyResolved: "hosting.latency.resolved";
+    readonly latencyUnmeasured: "hosting.latency.unmeasured";
+    readonly outputNonFinite: "hosting.output.non-finite";
+    readonly overrideIsolated: "hosting.override.curator-isolated";
+    readonly patchBusy: "hosting.patch.busy";
+    readonly patchNotWritable: "hosting.patch.not-writable";
+    readonly patchTooLarge: "hosting.patch.too-large";
+    readonly presetNotFound: "hosting.preset.not-found";
+    readonly hostProvenanceDiffers: "hosting.provenance.host-differs";
+    readonly sweepControlDidNotFire: "hosting.provenance.sweep-control-did-not-fire";
+    readonly disabled: "hosting.disabled";
+    readonly linked: "hosting.linked";
+    readonly noRealisation: "hosting.no-realisation";
+    readonly realisedInProcess: "hosting.realised.in-process";
+    readonly unjudged: "hosting.unjudged";
+    readonly rtSafetyClean: "hosting.rt-safety.clean-under-sweep";
+    readonly rtSafetyNotReproducible: "hosting.rt-safety.not-reproducible";
+    readonly rtSafetyNotesClean: "hosting.rt-safety.clean-under-notes";
+    readonly rtSafetyNotesUnmeasured: "hosting.rt-safety.notes-unmeasured";
+    readonly rtSafetyNotesViolations: "hosting.rt-safety.violations-under-notes";
+    readonly rtSafetyUnmeasured: "hosting.rt-safety.unmeasured";
+    readonly rtSafetyViolations: "hosting.rt-safety.violations-in-run";
+    readonly stabilityBelowFloor: "hosting.stability.cycles-below-floor";
+    readonly stabilityCrashUnattributed: "hosting.stability.crash-unattributed";
+    readonly stabilityCrashedAttributed: "hosting.stability.crashed-attributed-plugin";
+    readonly stabilityCrashedLive: "hosting.stability.crashed-live-on-this-rig";
+    readonly stabilityLinksGuiToolkit: "hosting.stability.links-gui-toolkit";
+    readonly stabilitySoakFailedAtRate: "hosting.stability.soak-failed-at-rate";
+    readonly stabilitySoaked: "hosting.stability.soaked";
+    readonly stabilitySpawnsThreads: "hosting.stability.spawns-threads";
+    readonly stabilityUnmeasured: "hosting.stability.unmeasured";
+    readonly stabilityUnsoaked: "hosting.stability.unsoaked";
+    readonly stateNotACopy: "hosting.state.not-a-copy";
+    readonly statePathOnAudio: "hosting.state.path-on-audio";
+    readonly statePathOutside: "hosting.state.path-outside";
+    readonly statePathSymlink: "hosting.state.path-symlink";
+    readonly statePathTooLong: "hosting.state.path-too-long";
+    readonly statePathUnmakeable: "hosting.state.path-unmakeable";
+    readonly stateUnreadable: "hosting.state.unreadable";
+    readonly topologyAmbisonicConfig: "hosting.topology.ambisonic-config";
+    readonly topologyChannelMapUnknown: "hosting.topology.channel-map-unknown";
+    readonly topologyInstrument: "hosting.topology.instrument";
+    readonly topologyMatched: "hosting.topology.matched";
+    readonly topologyNoAudioInput: "hosting.topology.no-audio-input";
+    readonly topologyNoAudioOutput: "hosting.topology.no-audio-output";
+    readonly topologyPortTooWide: "hosting.topology.port-too-wide";
+    readonly topologyPortWithoutChannels: "hosting.topology.port-without-channels";
+    readonly topologyTooManyPorts: "hosting.topology.too-many-ports";
+    readonly topologyWiderThanStrip: "hosting.topology.wider-than-strip";
+    readonly workerNonconforming: "hosting.worker.nonconforming";
+    readonly idleHoldRefused: "hosting.idle.hold-refused";
+}>;

package/dist/hosting-codes.generated.js

@@ -0,0 +1,84 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+//
+// GENERATED by tools/gen-hosting-codes.mjs from omx-clap-core's hosting tables — do not hand-edit.
+//
+// Regenerate: node tools/gen-hosting-codes.mjs --write
+// Verify:     node tools/gen-hosting-codes.mjs --check
+/** omx-clap-core's hosting codes, by key: every `HOSTING_<DIMENSION>_CODES` table, flattened. */
+export const HOSTING_CODE = Object.freeze({
+    "clapExtensionsNotCovered": "hosting.clap.extensions-not-covered",
+    "clapFormatNotHosted": "hosting.clap.format-not-hosted",
+    "clapHeadlessFailed": "hosting.clap.headless-failed",
+    "clapLatencyMismatch": "hosting.clap.latency-mismatch",
+    "clapNoteInput": "hosting.clap.note-input",
+    "clapProcessError": "hosting.clap.process-error",
+    "clapThreadViolation": "hosting.clap.thread-violation",
+    "clapUnqualified": "hosting.clap.unqualified",
+    "costAboveCeiling": "hosting.cost.above-ceiling",
+    "costFieldsMissing": "hosting.cost.fields-missing",
+    "costSpiky": "hosting.cost.spiky-tail",
+    "costUnmeasured": "hosting.cost.unmeasured-at-rate-and-quantum",
+    "costWithinCeiling": "hosting.cost.within-ceiling",
+    "featuresAtomInUnfed": "hosting.features.atom-in-unfed",
+    "featuresDisqualifying": "hosting.features.host-not-provided",
+    "featuresMidiIn": "hosting.features.midi-in-fed-empty",
+    "featuresMissing": "hosting.features.missing",
+    "featuresPortsUnreadable": "hosting.features.ports-unreadable",
+    "featuresProvided": "hosting.features.all-provided",
+    "featuresUnscanned": "hosting.features.scan-predates-field",
+    "latencyNonconforming": "hosting.latency.nonconforming",
+    "latencyParameterDependent": "hosting.latency.parameter-dependent",
+    "latencyResolved": "hosting.latency.resolved",
+    "latencyUnmeasured": "hosting.latency.unmeasured",
+    "outputNonFinite": "hosting.output.non-finite",
+    "overrideIsolated": "hosting.override.curator-isolated",
+    "patchBusy": "hosting.patch.busy",
+    "patchNotWritable": "hosting.patch.not-writable",
+    "patchTooLarge": "hosting.patch.too-large",
+    "presetNotFound": "hosting.preset.not-found",
+    "hostProvenanceDiffers": "hosting.provenance.host-differs",
+    "sweepControlDidNotFire": "hosting.provenance.sweep-control-did-not-fire",
+    "disabled": "hosting.disabled",
+    "linked": "hosting.linked",
+    "noRealisation": "hosting.no-realisation",
+    "realisedInProcess": "hosting.realised.in-process",
+    "unjudged": "hosting.unjudged",
+    "rtSafetyClean": "hosting.rt-safety.clean-under-sweep",
+    "rtSafetyNotReproducible": "hosting.rt-safety.not-reproducible",
+    "rtSafetyNotesClean": "hosting.rt-safety.clean-under-notes",
+    "rtSafetyNotesUnmeasured": "hosting.rt-safety.notes-unmeasured",
+    "rtSafetyNotesViolations": "hosting.rt-safety.violations-under-notes",
+    "rtSafetyUnmeasured": "hosting.rt-safety.unmeasured",
+    "rtSafetyViolations": "hosting.rt-safety.violations-in-run",
+    "stabilityBelowFloor": "hosting.stability.cycles-below-floor",
+    "stabilityCrashUnattributed": "hosting.stability.crash-unattributed",
+    "stabilityCrashedAttributed": "hosting.stability.crashed-attributed-plugin",
+    "stabilityCrashedLive": "hosting.stability.crashed-live-on-this-rig",
+    "stabilityLinksGuiToolkit": "hosting.stability.links-gui-toolkit",
+    "stabilitySoakFailedAtRate": "hosting.stability.soak-failed-at-rate",
+    "stabilitySoaked": "hosting.stability.soaked",
+    "stabilitySpawnsThreads": "hosting.stability.spawns-threads",
+    "stabilityUnmeasured": "hosting.stability.unmeasured",
+    "stabilityUnsoaked": "hosting.stability.unsoaked",
+    "stateNotACopy": "hosting.state.not-a-copy",
+    "statePathOnAudio": "hosting.state.path-on-audio",
+    "statePathOutside": "hosting.state.path-outside",
+    "statePathSymlink": "hosting.state.path-symlink",
+    "statePathTooLong": "hosting.state.path-too-long",
+    "statePathUnmakeable": "hosting.state.path-unmakeable",
+    "stateUnreadable": "hosting.state.unreadable",
+    "topologyAmbisonicConfig": "hosting.topology.ambisonic-config",
+    "topologyChannelMapUnknown": "hosting.topology.channel-map-unknown",
+    "topologyInstrument": "hosting.topology.instrument",
+    "topologyMatched": "hosting.topology.matched",
+    "topologyNoAudioInput": "hosting.topology.no-audio-input",
+    "topologyNoAudioOutput": "hosting.topology.no-audio-output",
+    "topologyPortTooWide": "hosting.topology.port-too-wide",
+    "topologyPortWithoutChannels": "hosting.topology.port-without-channels",
+    "topologyTooManyPorts": "hosting.topology.too-many-ports",
+    "topologyWiderThanStrip": "hosting.topology.wider-than-strip",
+    "workerNonconforming": "hosting.worker.nonconforming",
+    "idleHoldRefused": "hosting.idle.hold-refused",
+});
+//# sourceMappingURL=hosting-codes.generated.js.map

package/dist/hosting-codes.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosting-codes.generated.js","sourceRoot":"","sources":["../src/hosting-codes.generated.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD,EAAE;AACF,mGAAmG;AACnG,EAAE;AACF,uDAAuD;AACvD,uDAAuD;AAEvD,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,0BAA0B,EAAE,qCAAqC;IACjE,qBAAqB,EAAE,gCAAgC;IACvD,oBAAoB,EAAE,8BAA8B;IACpD,qBAAqB,EAAE,+BAA+B;IACtD,eAAe,EAAE,yBAAyB;IAC1C,kBAAkB,EAAE,4BAA4B;IAChD,qBAAqB,EAAE,+BAA+B;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,kBAAkB,EAAE,4BAA4B;IAChD,mBAAmB,EAAE,6BAA6B;IAClD,WAAW,EAAE,yBAAyB;IACtC,gBAAgB,EAAE,6CAA6C;IAC/D,mBAAmB,EAAE,6BAA6B;IAClD,qBAAqB,EAAE,gCAAgC;IACvD,uBAAuB,EAAE,oCAAoC;IAC7D,gBAAgB,EAAE,oCAAoC;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,yBAAyB,EAAE,mCAAmC;IAC9D,kBAAkB,EAAE,+BAA+B;IACnD,mBAAmB,EAAE,sCAAsC;IAC3D,sBAAsB,EAAE,+BAA+B;IACvD,2BAA2B,EAAE,qCAAqC;IAClE,iBAAiB,EAAE,0BAA0B;IAC7C,mBAAmB,EAAE,4BAA4B;IACjD,iBAAiB,EAAE,2BAA2B;IAC9C,kBAAkB,EAAE,mCAAmC;IACvD,WAAW,EAAE,oBAAoB;IACjC,kBAAkB,EAAE,4BAA4B;IAChD,eAAe,EAAE,yBAAyB;IAC1C,gBAAgB,EAAE,0BAA0B;IAC5C,uBAAuB,EAAE,iCAAiC;IAC1D,wBAAwB,EAAE,+CAA+C;IACzE,UAAU,EAAE,kBAAkB;IAC9B,QAAQ,EAAE,gBAAgB;IAC1B,eAAe,EAAE,wBAAwB;IACzC,mBAAmB,EAAE,6BAA6B;IAClD,UAAU,EAAE,kBAAkB;IAC9B,eAAe,EAAE,qCAAqC;IACtD,yBAAyB,EAAE,oCAAoC;IAC/D,oBAAoB,EAAE,qCAAqC;IAC3D,yBAAyB,EAAE,oCAAoC;IAC/D,yBAAyB,EAAE,0CAA0C;IACrE,oBAAoB,EAAE,8BAA8B;IACpD,oBAAoB,EAAE,qCAAqC;IAC3D,qBAAqB,EAAE,sCAAsC;IAC7D,4BAA4B,EAAE,sCAAsC;IACpE,4BAA4B,EAAE,6CAA6C;IAC3E,sBAAsB,EAAE,4CAA4C;IACpE,0BAA0B,EAAE,qCAAqC;IACjE,2BAA2B,EAAE,uCAAuC;IACpE,iBAAiB,EAAE,0BAA0B;IAC7C,wBAAwB,EAAE,kCAAkC;IAC5D,qBAAqB,EAAE,8BAA8B;IACrD,mBAAmB,EAAE,4BAA4B;IACjD,eAAe,EAAE,0BAA0B;IAC3C,kBAAkB,EAAE,6BAA6B;IACjD,kBAAkB,EAAE,4BAA4B;IAChD,kBAAkB,EAAE,4BAA4B;IAChD,kBAAkB,EAAE,6BAA6B;IACjD,qBAAqB,EAAE,+BAA+B;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,yBAAyB,EAAE,mCAAmC;IAC9D,2BAA2B,EAAE,sCAAsC;IACnE,oBAAoB,EAAE,6BAA6B;IACnD,iBAAiB,EAAE,0BAA0B;IAC7C,sBAAsB,EAAE,iCAAiC;IACzD,uBAAuB,EAAE,kCAAkC;IAC3D,qBAAqB,EAAE,gCAAgC;IACvD,6BAA6B,EAAE,wCAAwC;IACvE,sBAAsB,EAAE,iCAAiC;IACzD,wBAAwB,EAAE,mCAAmC;IAC7D,qBAAqB,EAAE,8BAA8B;IACrD,iBAAiB,EAAE,2BAA2B;CACtC,CAAC,CAAC"}

package/dist/hosting-codes.js

@@ -4,92 +4,15 @@
  * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
  * locale.
  *
- * omx-clap-core declares every hosting code now (the contract split moved `data/hosting/*.json`
- * there, byte for byte): one `HOSTING_<DIMENSION>_CODES` table per dimension, rendered into the
- * TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
- * (BUILDING.md) — `omx-clap-core-vocabulary.js` for the dimensions carried from omx-contract,
- * `omx-clap-core-hosting.js` for `hosting.idle.*`, its own (both with a `.d.ts`). {@link
- * HOSTING_CODE} is those tables flattened into one `key: code` map, loaded at import: a code
- * neither module declares cannot be named here, and a dimension either adds arrives without an
- * edit.
+ * omx-clap-core declares every hosting code: one `HOSTING_<DIMENSION>_CODES` table per dimension,
+ * in the TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
+ * (BUILDING.md). {@link HOSTING_CODE} is those tables flattened into one `key: code` map, written
+ * as plain data into `hosting-codes.generated.ts` by `tools/gen-hosting-codes.mjs` at build time:
+ * a code omx-clap-core does not declare cannot be named here, and this module reads no file and
+ * imports no `node:` module, so every public subpath that reaches it bundles for a browser.
+ * `src/contract-vocabulary-conformance.test.ts` holds the generated map to omx-clap-core's real
+ * modules, either way.
  */
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-/** The two TypeScript modules omx-clap-core's `tsdir` carries, each a `HOSTING_<DIMENSION>_CODES` source. */
-const CLAP_CORE_TS_MODULES = ["omx-clap-core-vocabulary.js", "omx-clap-core-hosting.js"];
-/** This package's own root, resolved from this module so it follows wherever it is installed. */
-const PACKAGE_ROOT = fileURLToPath(new URL("..", import.meta.url));
-/** `native/fetch-deps.sh`'s own checkout of omx-clap-core, for a build with no omx-clap-core-devel installed. */
-const DEPS_TS_DIR = join(PACKAGE_ROOT, "native/deps/omx-clap-core/ts");
-/** Where `make install` of omx-clap-host puts them (BUILDING.md), for a run with no `pkg-config` binary at all. */
-const DEFAULT_SYSTEM_TS_DIR = "/usr/share/omx-clap-core/ts";
-/** `pkg-config --variable=tsdir omx-clap-core`, or `undefined` where pkg-config or the package is absent. */
-function pkgConfigTsDir(env) {
-    try {
-        const out = execFileSync(env.PKG_CONFIG ?? "pkg-config", ["--variable=tsdir", "omx-clap-core"], {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        return out === "" ? undefined : out;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
- * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
- * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default —
- * a packaged plugin-qualify's runtime has no `pkg-config` binary to ask.
- */
-export function clapCoreTsDirCandidates(env = process.env) {
-    const set = env.OMX_CLAP_CORE_TSDIR;
-    if (set !== undefined && set !== "")
-        return [set];
-    const fromPkgConfig = pkgConfigTsDir(env);
-    return [...(fromPkgConfig === undefined ? [] : [fromPkgConfig]), DEPS_TS_DIR, DEFAULT_SYSTEM_TS_DIR];
-}
-function locateClapCoreTsDir() {
-    const candidates = clapCoreTsDirCandidates();
-    const dir = candidates.find((d) => CLAP_CORE_TS_MODULES.every((m) => existsSync(join(d, m))));
-    if (dir === undefined) {
-        throw new Error(`omx-clap-core's TypeScript modules (${CLAP_CORE_TS_MODULES.join(", ")}) were not found in any of: ` +
-            `${candidates.join(", ")}. Install omx-clap-core-devel (pkg-config omx-clap-core), set ` +
-            "OMX_CLAP_CORE_TSDIR to its tsdir, or run native/fetch-deps.sh.");
-    }
-    return dir;
-}
-/** True for an export name that is one of omx-clap-core's hosting tables. */
-export function isHostingTableName(name) {
-    return /^HOSTING_[A-Z0-9_]+_CODES$/.test(name);
-}
-async function loadHostingTables() {
-    const dir = locateClapCoreTsDir();
-    const tables = {};
-    for (const name of CLAP_CORE_TS_MODULES) {
-        // The modules are self-contained ES modules in a directory with no package.json: Node 18 reads such a .js as
-        // CommonJS and refuses `export`, so the source is imported as a data: module, which is a module on every Node.
-        const source = readFileSync(join(dir, name), "utf8");
-        const mod = await import(`data:text/javascript;base64,${Buffer.from(source).toString("base64")}`);
-        for (const [exportName, table] of Object.entries(mod)) {
-            if (isHostingTableName(exportName))
-                tables[exportName] = table;
-        }
-    }
-    return tables;
-}
-function flatten(tables) {
-    const table = {};
-    for (const [name, entries] of Object.entries(tables)) {
-        for (const [key, entry] of Object.entries(entries)) {
-            if (key in table)
-                throw new Error(`omx-clap-core declares the hosting key ${key} twice (${name})`);
-            table[key] = entry.code;
-        }
-    }
-    return Object.freeze(table);
-}
-export const HOSTING_CODE = flatten(await loadHostingTables());
+import { HOSTING_CODE } from "./hosting-codes.generated.js";
+export { HOSTING_CODE };
 //# sourceMappingURL=hosting-codes.js.map

package/dist/hosting-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosting-codes.js","sourceRoot":"","sources":["../src/hosting-codes.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,6GAA6G;AAC7G,MAAM,oBAAoB,GAAG,CAAC,6BAA6B,EAAE,0BAA0B,CAAU,CAAC;AAElG,iGAAiG;AACjG,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEnE,iHAAiH;AACjH,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,8BAA8B,CAAC,CAAC;AAEvE,mHAAmH;AACnH,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAE5D,6GAA6G;AAC7G,SAAS,cAAc,CAAC,GAAiD;IACvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,IAAI,YAAY,EAAE,CAAC,kBAAkB,EAAE,eAAe,CAAC,EAAE;YAC9F,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAoD,OAAO,CAAC,GAAG;IACrG,MAAM,GAAG,GAAG,GAAG,CAAC,mBAAmB,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,uCAAuC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B;YAClG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gEAAgE;YACxF,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAID,KAAK,UAAU,iBAAiB;IAC9B,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,6GAA6G;QAC7G,+GAA+G;QAC/G,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,GAAG,GAA4B,MAAM,MAAM,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3H,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACtD,IAAI,kBAAkB,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,KAAuB,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,MAAsC;IACrD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,GAAG,IAAI,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,WAAW,IAAI,GAAG,CAAC,CAAC;YACnG,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAgC,CAAC;AAC7D,CAAC;AAoFD,MAAM,CAAC,MAAM,YAAY,GAAqB,OAAO,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC"}
+{"version":3,"file":"hosting-codes.js","sourceRoot":"","sources":["../src/hosting-codes.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/plugin-qualify",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Qualify audio plugins for real-time hosting: scan, offline latency and cost measurement, a mod-host hosting sweep, and a fail-closed rating.",
   "type": "module",
   "license": "GPL-3.0-or-later",
@@ -77,12 +77,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && node tools/gen-hosting-codes.mjs --build && tsc -p tsconfig.json",
     "prepare": "npm run build",
     "test": "vitest run src",
     "lint": "tsc -p tsconfig.lint.json",
     "test:py": "python3 -m pytest tools -q",
-    "check:generated": "node tools/gen-python-declarations.mjs --check",
+    "check:generated": "node tools/gen-python-declarations.mjs --check && node tools/gen-hosting-codes.mjs --check",
     "check:private-refs": "tools/private-refs-check.sh && tools/private-refs-check.sh --self-test"
   },
   "devDependencies": {

package/src/hosting-codes.generated.ts

@@ -0,0 +1,84 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+//
+// GENERATED by tools/gen-hosting-codes.mjs from omx-clap-core's hosting tables — do not hand-edit.
+//
+// Regenerate: node tools/gen-hosting-codes.mjs --write
+// Verify:     node tools/gen-hosting-codes.mjs --check
+
+/** omx-clap-core's hosting codes, by key: every `HOSTING_<DIMENSION>_CODES` table, flattened. */
+export const HOSTING_CODE = Object.freeze({
+  "clapExtensionsNotCovered": "hosting.clap.extensions-not-covered",
+  "clapFormatNotHosted": "hosting.clap.format-not-hosted",
+  "clapHeadlessFailed": "hosting.clap.headless-failed",
+  "clapLatencyMismatch": "hosting.clap.latency-mismatch",
+  "clapNoteInput": "hosting.clap.note-input",
+  "clapProcessError": "hosting.clap.process-error",
+  "clapThreadViolation": "hosting.clap.thread-violation",
+  "clapUnqualified": "hosting.clap.unqualified",
+  "costAboveCeiling": "hosting.cost.above-ceiling",
+  "costFieldsMissing": "hosting.cost.fields-missing",
+  "costSpiky": "hosting.cost.spiky-tail",
+  "costUnmeasured": "hosting.cost.unmeasured-at-rate-and-quantum",
+  "costWithinCeiling": "hosting.cost.within-ceiling",
+  "featuresAtomInUnfed": "hosting.features.atom-in-unfed",
+  "featuresDisqualifying": "hosting.features.host-not-provided",
+  "featuresMidiIn": "hosting.features.midi-in-fed-empty",
+  "featuresMissing": "hosting.features.missing",
+  "featuresPortsUnreadable": "hosting.features.ports-unreadable",
+  "featuresProvided": "hosting.features.all-provided",
+  "featuresUnscanned": "hosting.features.scan-predates-field",
+  "latencyNonconforming": "hosting.latency.nonconforming",
+  "latencyParameterDependent": "hosting.latency.parameter-dependent",
+  "latencyResolved": "hosting.latency.resolved",
+  "latencyUnmeasured": "hosting.latency.unmeasured",
+  "outputNonFinite": "hosting.output.non-finite",
+  "overrideIsolated": "hosting.override.curator-isolated",
+  "patchBusy": "hosting.patch.busy",
+  "patchNotWritable": "hosting.patch.not-writable",
+  "patchTooLarge": "hosting.patch.too-large",
+  "presetNotFound": "hosting.preset.not-found",
+  "hostProvenanceDiffers": "hosting.provenance.host-differs",
+  "sweepControlDidNotFire": "hosting.provenance.sweep-control-did-not-fire",
+  "disabled": "hosting.disabled",
+  "linked": "hosting.linked",
+  "noRealisation": "hosting.no-realisation",
+  "realisedInProcess": "hosting.realised.in-process",
+  "unjudged": "hosting.unjudged",
+  "rtSafetyClean": "hosting.rt-safety.clean-under-sweep",
+  "rtSafetyNotReproducible": "hosting.rt-safety.not-reproducible",
+  "rtSafetyNotesClean": "hosting.rt-safety.clean-under-notes",
+  "rtSafetyNotesUnmeasured": "hosting.rt-safety.notes-unmeasured",
+  "rtSafetyNotesViolations": "hosting.rt-safety.violations-under-notes",
+  "rtSafetyUnmeasured": "hosting.rt-safety.unmeasured",
+  "rtSafetyViolations": "hosting.rt-safety.violations-in-run",
+  "stabilityBelowFloor": "hosting.stability.cycles-below-floor",
+  "stabilityCrashUnattributed": "hosting.stability.crash-unattributed",
+  "stabilityCrashedAttributed": "hosting.stability.crashed-attributed-plugin",
+  "stabilityCrashedLive": "hosting.stability.crashed-live-on-this-rig",
+  "stabilityLinksGuiToolkit": "hosting.stability.links-gui-toolkit",
+  "stabilitySoakFailedAtRate": "hosting.stability.soak-failed-at-rate",
+  "stabilitySoaked": "hosting.stability.soaked",
+  "stabilitySpawnsThreads": "hosting.stability.spawns-threads",
+  "stabilityUnmeasured": "hosting.stability.unmeasured",
+  "stabilityUnsoaked": "hosting.stability.unsoaked",
+  "stateNotACopy": "hosting.state.not-a-copy",
+  "statePathOnAudio": "hosting.state.path-on-audio",
+  "statePathOutside": "hosting.state.path-outside",
+  "statePathSymlink": "hosting.state.path-symlink",
+  "statePathTooLong": "hosting.state.path-too-long",
+  "statePathUnmakeable": "hosting.state.path-unmakeable",
+  "stateUnreadable": "hosting.state.unreadable",
+  "topologyAmbisonicConfig": "hosting.topology.ambisonic-config",
+  "topologyChannelMapUnknown": "hosting.topology.channel-map-unknown",
+  "topologyInstrument": "hosting.topology.instrument",
+  "topologyMatched": "hosting.topology.matched",
+  "topologyNoAudioInput": "hosting.topology.no-audio-input",
+  "topologyNoAudioOutput": "hosting.topology.no-audio-output",
+  "topologyPortTooWide": "hosting.topology.port-too-wide",
+  "topologyPortWithoutChannels": "hosting.topology.port-without-channels",
+  "topologyTooManyPorts": "hosting.topology.too-many-ports",
+  "topologyWiderThanStrip": "hosting.topology.wider-than-strip",
+  "workerNonconforming": "hosting.worker.nonconforming",
+  "idleHoldRefused": "hosting.idle.hold-refused",
+} as const);

package/src/hosting-codes.ts

@@ -4,184 +4,18 @@
  * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
  * locale.
  *
- * omx-clap-core declares every hosting code now (the contract split moved `data/hosting/*.json`
- * there, byte for byte): one `HOSTING_<DIMENSION>_CODES` table per dimension, rendered into the
- * TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
- * (BUILDING.md) — `omx-clap-core-vocabulary.js` for the dimensions carried from omx-contract,
- * `omx-clap-core-hosting.js` for `hosting.idle.*`, its own (both with a `.d.ts`). {@link
- * HOSTING_CODE} is those tables flattened into one `key: code` map, loaded at import: a code
- * neither module declares cannot be named here, and a dimension either adds arrives without an
- * edit.
+ * omx-clap-core declares every hosting code: one `HOSTING_<DIMENSION>_CODES` table per dimension,
+ * in the TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
+ * (BUILDING.md). {@link HOSTING_CODE} is those tables flattened into one `key: code` map, written
+ * as plain data into `hosting-codes.generated.ts` by `tools/gen-hosting-codes.mjs` at build time:
+ * a code omx-clap-core does not declare cannot be named here, and this module reads no file and
+ * imports no `node:` module, so every public subpath that reaches it bundles for a browser.
+ * `src/contract-vocabulary-conformance.test.ts` holds the generated map to omx-clap-core's real
+ * modules, either way.
  */
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
+import { HOSTING_CODE } from "./hosting-codes.generated.js";
 
-/** The two TypeScript modules omx-clap-core's `tsdir` carries, each a `HOSTING_<DIMENSION>_CODES` source. */
-const CLAP_CORE_TS_MODULES = ["omx-clap-core-vocabulary.js", "omx-clap-core-hosting.js"] as const;
+export { HOSTING_CODE };
 
-/** This package's own root, resolved from this module so it follows wherever it is installed. */
-const PACKAGE_ROOT = fileURLToPath(new URL("..", import.meta.url));
-
-/** `native/fetch-deps.sh`'s own checkout of omx-clap-core, for a build with no omx-clap-core-devel installed. */
-const DEPS_TS_DIR = join(PACKAGE_ROOT, "native/deps/omx-clap-core/ts");
-
-/** Where `make install` of omx-clap-host puts them (BUILDING.md), for a run with no `pkg-config` binary at all. */
-const DEFAULT_SYSTEM_TS_DIR = "/usr/share/omx-clap-core/ts";
-
-/** `pkg-config --variable=tsdir omx-clap-core`, or `undefined` where pkg-config or the package is absent. */
-function pkgConfigTsDir(env: Readonly<Record<string, string | undefined>>): string | undefined {
-  try {
-    const out = execFileSync(env.PKG_CONFIG ?? "pkg-config", ["--variable=tsdir", "omx-clap-core"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-    }).trim();
-    return out === "" ? undefined : out;
-  } catch {
-    return undefined;
-  }
-}
-
-/**
- * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
- * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
- * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default —
- * a packaged plugin-qualify's runtime has no `pkg-config` binary to ask.
- */
-export function clapCoreTsDirCandidates(env: Readonly<Record<string, string | undefined>> = process.env): readonly string[] {
-  const set = env.OMX_CLAP_CORE_TSDIR;
-  if (set !== undefined && set !== "") return [set];
-  const fromPkgConfig = pkgConfigTsDir(env);
-  return [...(fromPkgConfig === undefined ? [] : [fromPkgConfig]), DEPS_TS_DIR, DEFAULT_SYSTEM_TS_DIR];
-}
-
-function locateClapCoreTsDir(): string {
-  const candidates = clapCoreTsDirCandidates();
-  const dir = candidates.find((d) => CLAP_CORE_TS_MODULES.every((m) => existsSync(join(d, m))));
-  if (dir === undefined) {
-    throw new Error(
-      `omx-clap-core's TypeScript modules (${CLAP_CORE_TS_MODULES.join(", ")}) were not found in any of: ` +
-        `${candidates.join(", ")}. Install omx-clap-core-devel (pkg-config omx-clap-core), set ` +
-        "OMX_CLAP_CORE_TSDIR to its tsdir, or run native/fetch-deps.sh.",
-    );
-  }
-  return dir;
-}
-
-/** True for an export name that is one of omx-clap-core's hosting tables. */
-export function isHostingTableName(name: string): boolean {
-  return /^HOSTING_[A-Z0-9_]+_CODES$/.test(name);
-}
-
-type HostingEntries = Record<string, { readonly code: string }>;
-
-async function loadHostingTables(): Promise<Record<string, HostingEntries>> {
-  const dir = locateClapCoreTsDir();
-  const tables: Record<string, HostingEntries> = {};
-  for (const name of CLAP_CORE_TS_MODULES) {
-    // The modules are self-contained ES modules in a directory with no package.json: Node 18 reads such a .js as
-    // CommonJS and refuses `export`, so the source is imported as a data: module, which is a module on every Node.
-    const source = readFileSync(join(dir, name), "utf8");
-    const mod: Record<string, unknown> = await import(`data:text/javascript;base64,${Buffer.from(source).toString("base64")}`);
-    for (const [exportName, table] of Object.entries(mod)) {
-      if (isHostingTableName(exportName)) tables[exportName] = table as HostingEntries;
-    }
-  }
-  return tables;
-}
-
-function flatten(tables: Record<string, HostingEntries>): HostingCodeTable {
-  const table: Record<string, string> = {};
-  for (const [name, entries] of Object.entries(tables)) {
-    for (const [key, entry] of Object.entries(entries)) {
-      if (key in table) throw new Error(`omx-clap-core declares the hosting key ${key} twice (${name})`);
-      table[key] = entry.code;
-    }
-  }
-  return Object.freeze(table) as unknown as HostingCodeTable;
-}
-
-/**
- * omx-clap-core's hosting codes, by key, across its two TypeScript modules — hand-kept here
- * (not derived from a static import: the source is a runtime-resolved install directory, not an
- * npm dependency) and held to the real modules by
- * `src/contract-vocabulary-conformance.test.ts`, which turns red on any drift either way.
- */
-export interface HostingCodeTable {
-  readonly clapExtensionsNotCovered: "hosting.clap.extensions-not-covered";
-  readonly clapFormatNotHosted: "hosting.clap.format-not-hosted";
-  readonly clapHeadlessFailed: "hosting.clap.headless-failed";
-  readonly clapLatencyMismatch: "hosting.clap.latency-mismatch";
-  readonly clapNoteInput: "hosting.clap.note-input";
-  readonly clapProcessError: "hosting.clap.process-error";
-  readonly clapThreadViolation: "hosting.clap.thread-violation";
-  readonly clapUnqualified: "hosting.clap.unqualified";
-  readonly costAboveCeiling: "hosting.cost.above-ceiling";
-  readonly costFieldsMissing: "hosting.cost.fields-missing";
-  readonly costSpiky: "hosting.cost.spiky-tail";
-  readonly costUnmeasured: "hosting.cost.unmeasured-at-rate-and-quantum";
-  readonly costWithinCeiling: "hosting.cost.within-ceiling";
-  readonly featuresAtomInUnfed: "hosting.features.atom-in-unfed";
-  readonly featuresDisqualifying: "hosting.features.host-not-provided";
-  readonly featuresMidiIn: "hosting.features.midi-in-fed-empty";
-  readonly featuresMissing: "hosting.features.missing";
-  readonly featuresPortsUnreadable: "hosting.features.ports-unreadable";
-  readonly featuresProvided: "hosting.features.all-provided";
-  readonly featuresUnscanned: "hosting.features.scan-predates-field";
-  readonly idleHoldRefused: "hosting.idle.hold-refused";
-  readonly latencyNonconforming: "hosting.latency.nonconforming";
-  readonly latencyParameterDependent: "hosting.latency.parameter-dependent";
-  readonly latencyResolved: "hosting.latency.resolved";
-  readonly latencyUnmeasured: "hosting.latency.unmeasured";
-  readonly outputNonFinite: "hosting.output.non-finite";
-  readonly overrideIsolated: "hosting.override.curator-isolated";
-  readonly patchBusy: "hosting.patch.busy";
-  readonly patchNotWritable: "hosting.patch.not-writable";
-  readonly patchTooLarge: "hosting.patch.too-large";
-  readonly presetNotFound: "hosting.preset.not-found";
-  readonly hostProvenanceDiffers: "hosting.provenance.host-differs";
-  readonly sweepControlDidNotFire: "hosting.provenance.sweep-control-did-not-fire";
-  readonly disabled: "hosting.disabled";
-  readonly linked: "hosting.linked";
-  readonly noRealisation: "hosting.no-realisation";
-  readonly realisedInProcess: "hosting.realised.in-process";
-  readonly unjudged: "hosting.unjudged";
-  readonly rtSafetyClean: "hosting.rt-safety.clean-under-sweep";
-  readonly rtSafetyNotReproducible: "hosting.rt-safety.not-reproducible";
-  readonly rtSafetyNotesClean: "hosting.rt-safety.clean-under-notes";
-  readonly rtSafetyNotesUnmeasured: "hosting.rt-safety.notes-unmeasured";
-  readonly rtSafetyNotesViolations: "hosting.rt-safety.violations-under-notes";
-  readonly rtSafetyUnmeasured: "hosting.rt-safety.unmeasured";
-  readonly rtSafetyViolations: "hosting.rt-safety.violations-in-run";
-  readonly stabilityBelowFloor: "hosting.stability.cycles-below-floor";
-  readonly stabilityCrashUnattributed: "hosting.stability.crash-unattributed";
-  readonly stabilityCrashedAttributed: "hosting.stability.crashed-attributed-plugin";
-  readonly stabilityCrashedLive: "hosting.stability.crashed-live-on-this-rig";
-  readonly stabilityLinksGuiToolkit: "hosting.stability.links-gui-toolkit";
-  readonly stabilitySoakFailedAtRate: "hosting.stability.soak-failed-at-rate";
-  readonly stabilitySoaked: "hosting.stability.soaked";
-  readonly stabilitySpawnsThreads: "hosting.stability.spawns-threads";
-  readonly stabilityUnmeasured: "hosting.stability.unmeasured";
-  readonly stabilityUnsoaked: "hosting.stability.unsoaked";
-  readonly stateNotACopy: "hosting.state.not-a-copy";
-  readonly statePathOnAudio: "hosting.state.path-on-audio";
-  readonly statePathOutside: "hosting.state.path-outside";
-  readonly statePathSymlink: "hosting.state.path-symlink";
-  readonly statePathTooLong: "hosting.state.path-too-long";
-  readonly statePathUnmakeable: "hosting.state.path-unmakeable";
-  readonly stateUnreadable: "hosting.state.unreadable";
-  readonly topologyAmbisonicConfig: "hosting.topology.ambisonic-config";
-  readonly topologyChannelMapUnknown: "hosting.topology.channel-map-unknown";
-  readonly topologyInstrument: "hosting.topology.instrument";
-  readonly topologyMatched: "hosting.topology.matched";
-  readonly topologyNoAudioInput: "hosting.topology.no-audio-input";
-  readonly topologyNoAudioOutput: "hosting.topology.no-audio-output";
-  readonly topologyPortTooWide: "hosting.topology.port-too-wide";
-  readonly topologyPortWithoutChannels: "hosting.topology.port-without-channels";
-  readonly topologyTooManyPorts: "hosting.topology.too-many-ports";
-  readonly topologyWiderThanStrip: "hosting.topology.wider-than-strip";
-  readonly workerNonconforming: "hosting.worker.nonconforming";
-}
-
-export const HOSTING_CODE: HostingCodeTable = flatten(await loadHostingTables());
+/** {@link HOSTING_CODE}'s type: each key's literal code. */
+export type HostingCodeTable = typeof HOSTING_CODE;

package/tools/clap-core-tsdir.d.mts

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The two TypeScript modules omx-clap-core's `tsdir` carries. */
+export const CLAP_CORE_TS_MODULES: readonly string[];
+/** Where omx-clap-core's TypeScript modules are looked for, in order. */
+export function clapCoreTsDirCandidates(env?: Readonly<Record<string, string | undefined>>): readonly string[];
+/** The first candidate holding both modules, or `undefined`. */
+export function findClapCoreTsDir(env?: Readonly<Record<string, string | undefined>>): string | undefined;
+/** True for an export name that is one of omx-clap-core's hosting tables. */
+export function isHostingTableName(name: string): boolean;
+/** One hosting table: key to its entry. */
+export type HostingEntries = Readonly<Record<string, { readonly code: string }>>;
+/** Every hosting table the modules in `dir` export, by export name. */
+export function loadHostingTables(dir: string): Promise<Record<string, HostingEntries>>;
+/** The tables flattened into one `key: code` map. */
+export function flattenHostingTables(tables: Readonly<Record<string, HostingEntries>>): Record<string, string>;

package/tools/clap-core-tsdir.mjs

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/*
+ * clap-core-tsdir.mjs — where omx-clap-core's TypeScript modules are, and their hosting tables.
+ *
+ * omx-clap-core declares every hosting code: one `HOSTING_<DIMENSION>_CODES` table per dimension,
+ * rendered into the modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
+ * (BUILDING.md) — `omx-clap-core-vocabulary.js` for the dimensions carried from omx-contract,
+ * `omx-clap-core-hosting.js` for `hosting.idle.*`. `tools/gen-hosting-codes.mjs` reads them here
+ * to write `src/hosting-codes.generated.ts`, and the conformance test reads them here to hold that
+ * file to them.
+ *
+ * Node only, and build and test only: no module under src/ imports it, so nothing a public subpath
+ * reaches touches the filesystem or a child process.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** The two TypeScript modules omx-clap-core's `tsdir` carries, each a `HOSTING_<DIMENSION>_CODES` source. */
+export const CLAP_CORE_TS_MODULES = Object.freeze(['omx-clap-core-vocabulary.js', 'omx-clap-core-hosting.js']);
+
+/** This package's root. */
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+/** `native/fetch-deps.sh`'s own checkout of omx-clap-core, for a build with no omx-clap-core-devel installed. */
+const DEPS_TS_DIR = join(PACKAGE_ROOT, 'native/deps/omx-clap-core/ts');
+
+/** Where `make install` of omx-clap-host puts them (BUILDING.md), for a run with no `pkg-config` binary at all. */
+const DEFAULT_SYSTEM_TS_DIR = '/usr/share/omx-clap-core/ts';
+
+/** `pkg-config --variable=tsdir omx-clap-core`, or `undefined` where pkg-config or the package is absent. */
+function pkgConfigTsDir(env) {
+  try {
+    const out = execFileSync(env.PKG_CONFIG ?? 'pkg-config', ['--variable=tsdir', 'omx-clap-core'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+    return out === '' ? undefined : out;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
+ * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
+ * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default.
+ */
+export function clapCoreTsDirCandidates(env = process.env) {
+  const set = env.OMX_CLAP_CORE_TSDIR;
+  if (set !== undefined && set !== '') return [set];
+  const fromPkgConfig = pkgConfigTsDir(env);
+  return [...(fromPkgConfig === undefined ? [] : [fromPkgConfig]), DEPS_TS_DIR, DEFAULT_SYSTEM_TS_DIR];
+}
+
+/** The first candidate holding both modules, or `undefined`. */
+export function findClapCoreTsDir(env = process.env) {
+  return clapCoreTsDirCandidates(env).find((d) => CLAP_CORE_TS_MODULES.every((m) => existsSync(join(d, m))));
+}
+
+/** True for an export name that is one of omx-clap-core's hosting tables. */
+export function isHostingTableName(name) {
+  return /^HOSTING_[A-Z0-9_]+_CODES$/.test(name);
+}
+
+/** Every `HOSTING_<DIMENSION>_CODES` table the two modules in `dir` export, by export name, in module order. */
+export async function loadHostingTables(dir) {
+  const tables = {};
+  for (const name of CLAP_CORE_TS_MODULES) {
+    // The modules are self-contained ES modules in a directory with no package.json: Node 18 reads such a .js as
+    // CommonJS and refuses `export`, so the source is imported as a data: module, which is a module on every Node.
+    const source = readFileSync(join(dir, name), 'utf8');
+    const mod = await import(`data:text/javascript;base64,${Buffer.from(source).toString('base64')}`);
+    for (const [exportName, table] of Object.entries(mod)) {
+      if (isHostingTableName(exportName)) tables[exportName] = table;
+    }
+  }
+  return tables;
+}
+
+/** The tables flattened into one `key: code` map; a key two tables declare is refused. */
+export function flattenHostingTables(tables) {
+  const flat = {};
+  for (const [name, entries] of Object.entries(tables)) {
+    for (const [key, entry] of Object.entries(entries)) {
+      if (key in flat) throw new Error(`omx-clap-core declares the hosting key ${key} twice (${name})`);
+      flat[key] = entry.code;
+    }
+  }
+  return flat;
+}

package/tools/gen-hosting-codes.d.mts

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The committed generated module, `src/hosting-codes.generated.ts`. */
+export const OUT: string;
+/** The generated module's text for a flattened `key: code` map. */
+export function hostingCodesFile(flat: Readonly<Record<string, string>>): string;
+/** The generated module's text from the omx-clap-core modules in `dir`. */
+export function hostingCodesFileFrom(dir: string): Promise<string>;

package/tools/gen-hosting-codes.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/*
+ * gen-hosting-codes.mjs — `src/hosting-codes.generated.ts`, omx-clap-core's hosting tables flattened
+ * into one `key: code` map, as plain data.
+ *
+ * The codes are omx-clap-core's (tools/clap-core-tsdir.mjs finds its TypeScript modules). They reach
+ * `HOSTING_CODE` as a generated module rather than a read at import, so every module a public subpath
+ * reaches stays free of `node:` imports and bundles for a browser (#134). The file is committed and
+ * checked identical, as `tools/_declarations.py` is; `pnpm build` regenerates it whenever omx-clap-core's
+ * modules are found, and keeps the committed one where they are not.
+ *
+ * Usage:
+ *   node tools/gen-hosting-codes.mjs --check   # exit 1 if the committed file is stale, 2 if omx-clap-core is absent
+ *   node tools/gen-hosting-codes.mjs --write   # (re)write the committed file; omx-clap-core required
+ *   node tools/gen-hosting-codes.mjs --build   # --write when omx-clap-core is found, else keep the committed file
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { clapCoreTsDirCandidates, findClapCoreTsDir, flattenHostingTables, loadHostingTables } from './clap-core-tsdir.mjs';
+
+const PKG = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+export const OUT = join(PKG, 'src/hosting-codes.generated.ts');
+
+/** The generated module's text for a flattened `key: code` map. */
+export function hostingCodesFile(flat) {
+  const lines = Object.entries(flat).map(([key, code]) => `  ${JSON.stringify(key)}: ${JSON.stringify(code)},\n`);
+  return (
+    `// SPDX-License-Identifier: GPL-3.0-or-later\n` +
+    `// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>\n` +
+    `//\n` +
+    `// GENERATED by tools/gen-hosting-codes.mjs from omx-clap-core's hosting tables — do not hand-edit.\n` +
+    `//\n` +
+    `// Regenerate: node tools/gen-hosting-codes.mjs --write\n` +
+    `// Verify:     node tools/gen-hosting-codes.mjs --check\n` +
+    `\n` +
+    `/** omx-clap-core's hosting codes, by key: every \`HOSTING_<DIMENSION>_CODES\` table, flattened. */\n` +
+    `export const HOSTING_CODE = Object.freeze({\n` +
+    lines.join('') +
+    `} as const);\n`
+  );
+}
+
+/** The generated module's text from the omx-clap-core modules in `dir`. */
+export async function hostingCodesFileFrom(dir) {
+  return hostingCodesFile(flattenHostingTables(await loadHostingTables(dir)));
+}
+
+function absent() {
+  return (
+    `omx-clap-core's TypeScript modules were not found in any of: ${clapCoreTsDirCandidates().join(', ')}. ` +
+    'Install omx-clap-core-devel (pkg-config omx-clap-core), set OMX_CLAP_CORE_TSDIR to its tsdir, or run make -C native deps.'
+  );
+}
+
+async function main() {
+  const mode = process.argv[2];
+  if (!['--check', '--write', '--build'].includes(mode)) {
+    console.error('usage: node tools/gen-hosting-codes.mjs --check|--write|--build');
+    process.exit(2);
+  }
+  const dir = findClapCoreTsDir();
+  if (dir === undefined) {
+    if (mode === '--build') {
+      console.log(`gen-hosting-codes: omx-clap-core not found, keeping the committed ${OUT}`);
+      return;
+    }
+    console.error(`gen-hosting-codes: ${absent()}`);
+    process.exit(2);
+  }
+  const content = await hostingCodesFileFrom(dir);
+  let onDisk;
+  try {
+    onDisk = readFileSync(OUT, 'utf8');
+  } catch {
+    onDisk = undefined;
+  }
+  if (mode === '--check') {
+    if (onDisk !== content) {
+      console.error(`gen-hosting-codes: ${OUT} is stale against ${dir} — run with --write`);
+      process.exit(1);
+    }
+    console.log('gen-hosting-codes: up to date');
+    return;
+  }
+  if (onDisk !== content) writeFileSync(OUT, content);
+  console.log(`gen-hosting-codes: ${onDisk === content ? 'up to date' : 'wrote'} ${OUT} from ${dir}`);
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) await main();