@ecopoesis/homebridge-dmx 0.1.0

package/dist/color/rgbww.js

@@ -0,0 +1,54 @@
+// rgbww — RGB + WarmWhite + CoolWhite. The extracted white component
+// is split between WW and CW based on the HomeKit CCT (mireds), falling
+// back to 50/50 when CCT isn't set. WW channel optionally declares K=K
+// (e.g. "WarmWhite 2700") and CW does the same; if absent, defaults
+// 2700K (WW) / 6500K (CW) are used.
+import { clamp, hsvToRgb01, rgbBytes, requireRoles, } from './types.js';
+const DEFAULT_WW_K = 2700;
+const DEFAULT_CW_K = 6500;
+export const rgbww = {
+    id: 'rgbww',
+    characteristics: ['On', 'Brightness', 'Hue', 'Saturation', 'ColorTemperature'],
+    validate(channels) {
+        requireRoles(channels, ['red', 'green', 'blue', 'warm-white', 'cool-white']);
+    },
+    render(state, channels) {
+        const wwK = channels.find((c) => c.role === 'warm-white')?.kMin ?? DEFAULT_WW_K;
+        const cwK = channels.find((c) => c.role === 'cool-white')?.kMin ?? DEFAULT_CW_K;
+        const rgb01 = hsvToRgb01(state.hue ?? 0, state.saturation ?? 0);
+        const px = rgbBytes(rgb01, state);
+        const w = Math.min(px.r, px.g, px.b);
+        // Mix ratio: when CCT is at WW endpoint -> all WW; at CW endpoint -> all CW.
+        let warmFrac = 0.5;
+        if (state.colorTemperatureMireds != null && state.colorTemperatureMireds > 0) {
+            const k = 1_000_000 / state.colorTemperatureMireds;
+            warmFrac = clamp((cwK - k) / (cwK - wwK), 0, 1);
+        }
+        const ww = Math.round(w * warmFrac);
+        const cw = w - ww;
+        const out = new Uint8Array(channels.length);
+        for (let i = 0; i < channels.length; i++) {
+            if (channels[i].fine)
+                continue;
+            switch (channels[i].role) {
+                case 'red':
+                    out[i] = px.r - w;
+                    break;
+                case 'green':
+                    out[i] = px.g - w;
+                    break;
+                case 'blue':
+                    out[i] = px.b - w;
+                    break;
+                case 'warm-white':
+                    out[i] = ww;
+                    break;
+                case 'cool-white':
+                    out[i] = cw;
+                    break;
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=rgbww.js.map

package/dist/color/rgbww.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgbww.js","sourceRoot":"","sources":["../../src/color/rgbww.ts"],"names":[],"mappings":"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"}

package/dist/color/types.d.ts

@@ -0,0 +1,64 @@
+export type HKCharacteristic = 'On' | 'Brightness' | 'Hue' | 'Saturation' | 'ColorTemperature';
+/** Canonical HomeKit state. Optional fields are populated only for models
+ *  that expose the corresponding characteristic. */
+export interface HomeKitLightState {
+    on: boolean;
+    brightness: number;
+    hue?: number;
+    saturation?: number;
+    colorTemperatureMireds?: number;
+}
+export type ChannelRole = 'intensity' | 'cct' | 'saturation' | 'hue' | 'red' | 'green' | 'blue' | 'white' | 'warm-white' | 'cool-white' | 'amber';
+/** One entry from a profile's `channel_order`. Produced by `parseChannelName`.
+ *  `fine: true` means the byte at this slot is the low 8 bits of the 16-bit
+ *  value paired with the immediately preceding non-fine entry of the same role. */
+export interface ChannelDef {
+    role: ChannelRole;
+    fine?: boolean;
+    /** For CCT channels: Kelvin range. Required for CCT to mireds<->byte mapping. */
+    kMin?: number;
+    kMax?: number;
+}
+export interface ColorModel {
+    /** Lowercase identifier used in YAML/JSON config (`colormodel: hsvcct`). */
+    readonly id: string;
+    /** HomeKit characteristics this model wants on its fixture. */
+    readonly characteristics: HKCharacteristic[];
+    /** Throw if `channels` is inconsistent with this model's requirements. */
+    validate(channels: ChannelDef[]): void;
+    /** Produce a byte per `channels` entry, in order, given the HomeKit state. */
+    render(state: HomeKitLightState, channels: ChannelDef[]): Uint8Array;
+    /** Optional reverse direction; not implemented in v1. */
+    parse?(bytes: Uint8Array, channels: ChannelDef[]): HomeKitLightState;
+}
+/** Map HomeKit brightness (0..100) to a 16-bit value (0..65535) honoring On. */
+export declare function brightness16(state: HomeKitLightState): number;
+/** Map HomeKit brightness (0..100) to an 8-bit value (0..255) honoring On. */
+export declare function brightness8(state: HomeKitLightState): number;
+/** Mireds → Kelvin → 0..255 byte across [kMin, kMax]. */
+export declare function ctByte(mireds: number | undefined, kMin: number, kMax: number): number;
+/** HSV → RGB at V=1 (the brightness is applied separately on top — same idiom
+ *  as unifi-ap-rgb so we don't double-darken). */
+export declare function hsvToRgb01(hueDeg: number, satPct: number): {
+    r: number;
+    g: number;
+    b: number;
+};
+/** Scale 0..1 RGB by brightness (0..100) and on/off, return 0..255 bytes. */
+export declare function rgbBytes(rgb01: {
+    r: number;
+    g: number;
+    b: number;
+}, state: HomeKitLightState): {
+    r: number;
+    g: number;
+    b: number;
+};
+export declare function clamp(v: number, lo: number, hi: number): number;
+/** Tag a single-byte channel index plus its fine companion (if any), and
+ *  emit the right 16-bit split into `out`. Returns the index advanced past
+ *  any fine companion. */
+export declare function writeMaybe16(out: Uint8Array, channels: ChannelDef[], i: number, value16: number): number;
+/** Validate that `roles` is exactly the set of (coarse) roles in `channels`. */
+export declare function requireRoles(channels: ChannelDef[], roles: ChannelRole[]): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/color/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/color/types.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GACxB,IAAI,GACJ,YAAY,GACZ,KAAK,GACL,YAAY,GACZ,kBAAkB,CAAC;AAEvB;oDACoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,KAAK,GACL,YAAY,GACZ,KAAK,GACL,KAAK,GACL,OAAO,GACP,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,OAAO,CAAC;AAEZ;;mFAEmF;AACnF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC;IAC7C,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IACrE,yDAAyD;IACzD,KAAK,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC;CACtE;AAID,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAI7D;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAG5D;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED;kDACkD;AAClD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAc9F;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,iBAAiB,GAC3F;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAOpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;0BAE0B;AAC1B,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,UAAU,EAAE,EACtB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAY/E"}

package/dist/color/types.js

@@ -0,0 +1,91 @@
+// Color-model interfaces.
+//
+// A `ColorModel` translates the canonical HomeKit lightbulb state into the
+// byte values a fixture expects, given that fixture's `channel_order` from
+// the patch config. The optional `parse` is a placeholder for future
+// state-read support; not implemented in v1.
+// ── shared helpers ─────────────────────────────────────────────────────────
+/** Map HomeKit brightness (0..100) to a 16-bit value (0..65535) honoring On. */
+export function brightness16(state) {
+    if (!state.on)
+        return 0;
+    const pct = clamp(state.brightness, 0, 100);
+    return Math.round((pct / 100) * 65535);
+}
+/** Map HomeKit brightness (0..100) to an 8-bit value (0..255) honoring On. */
+export function brightness8(state) {
+    if (!state.on)
+        return 0;
+    return Math.round((clamp(state.brightness, 0, 100) / 100) * 255);
+}
+/** Mireds → Kelvin → 0..255 byte across [kMin, kMax]. */
+export function ctByte(mireds, kMin, kMax) {
+    if (mireds == null || mireds <= 0)
+        return 128;
+    const k = 1_000_000 / mireds;
+    const t = (k - kMin) / (kMax - kMin);
+    return Math.round(clamp(t, 0, 1) * 255);
+}
+/** HSV → RGB at V=1 (the brightness is applied separately on top — same idiom
+ *  as unifi-ap-rgb so we don't double-darken). */
+export function hsvToRgb01(hueDeg, satPct) {
+    const h = ((hueDeg % 360) + 360) % 360;
+    const s = clamp(satPct, 0, 100) / 100;
+    const c = s; // chroma when V = 1
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    let r1 = 0, g1 = 0, b1 = 0;
+    if (h < 60)
+        [r1, g1, b1] = [c, x, 0];
+    else if (h < 120)
+        [r1, g1, b1] = [x, c, 0];
+    else if (h < 180)
+        [r1, g1, b1] = [0, c, x];
+    else if (h < 240)
+        [r1, g1, b1] = [0, x, c];
+    else if (h < 300)
+        [r1, g1, b1] = [x, 0, c];
+    else
+        [r1, g1, b1] = [c, 0, x];
+    const m = 1 - c; // V - c with V = 1
+    return { r: r1 + m, g: g1 + m, b: b1 + m };
+}
+/** Scale 0..1 RGB by brightness (0..100) and on/off, return 0..255 bytes. */
+export function rgbBytes(rgb01, state) {
+    const m = state.on ? clamp(state.brightness, 0, 100) / 100 : 0;
+    return {
+        r: Math.round(rgb01.r * m * 255),
+        g: Math.round(rgb01.g * m * 255),
+        b: Math.round(rgb01.b * m * 255),
+    };
+}
+export function clamp(v, lo, hi) {
+    return v < lo ? lo : v > hi ? hi : v;
+}
+/** Tag a single-byte channel index plus its fine companion (if any), and
+ *  emit the right 16-bit split into `out`. Returns the index advanced past
+ *  any fine companion. */
+export function writeMaybe16(out, channels, i, value16) {
+    const coarse = (value16 >> 8) & 0xff;
+    const fine = value16 & 0xff;
+    out[i] = coarse;
+    if (channels[i + 1]?.fine && channels[i + 1].role === channels[i].role) {
+        out[i + 1] = fine;
+        return i + 2;
+    }
+    return i + 1;
+}
+/** Validate that `roles` is exactly the set of (coarse) roles in `channels`. */
+export function requireRoles(channels, roles) {
+    const present = channels.filter((c) => !c.fine).map((c) => c.role);
+    for (const r of roles) {
+        if (!present.includes(r)) {
+            throw new Error(`channel_order missing required role '${r}'`);
+        }
+    }
+    for (const r of present) {
+        if (!roles.includes(r)) {
+            throw new Error(`channel_order has unexpected role '${r}' for this model`);
+        }
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/color/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/color/types.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+import { ChannelDef, ColorModel } from './color/types.js';
+export interface ControllerSpec {
+    id: string;
+    type: string;
+    ip: string;
+}
+export interface ProfileSpec {
+    name: string;
+    colormodel: string;
+    channel_order: string[];
+}
+export interface PatchSpec {
+    id: string;
+    name: string;
+    type: string;
+    controller?: string;
+    universe?: string;
+    start: number;
+}
+export interface RawConfig {
+    name?: string;
+    yamlPath?: string;
+    controllers?: ControllerSpec[];
+    profiles?: ProfileSpec[];
+    patch?: PatchSpec[];
+}
+export interface Profile {
+    name: string;
+    model: ColorModel;
+    channels: ChannelDef[];
+}
+export declare const CONTROLLER_TYPES: readonly ["StickDE3"];
+export type ControllerType = typeof CONTROLLER_TYPES[number];
+export interface Controller {
+    id: string;
+    type: ControllerType;
+    ip: string;
+}
+export interface Fixture {
+    id: string;
+    name: string;
+    profile: Profile;
+    controller: Controller;
+    universe: number;
+    startCh: number;
+    nChannels: number;
+}
+export interface LoadedConfig {
+    name: string;
+    controllers: Controller[];
+    fixtures: Fixture[];
+}
+export declare const DEFAULT_PLATFORM_NAME = "DMX";
+/** Load + validate the platform config. `rawJson` is the Homebridge
+ *  `platforms[]` entry; if it specifies `yamlPath`, that YAML file is loaded
+ *  and treated as a full override of the JSON.
+ *
+ *  If `cwd` is passed, relative yamlPath is resolved against it. */
+export declare function loadConfig(rawJson: RawConfig, cwd?: string): LoadedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB,uBAAwB,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;;oEAIoE;AACpE,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAyIzE"}

package/dist/config.js

@@ -0,0 +1,191 @@
+// Config loader + validator.
+//
+// Inputs:
+//   - Homebridge config: `platforms[].DMX` block from Homebridge's
+//     config.json. Optional `yamlPath` points to an external YAML file
+//     whose contents take precedence over the JSON.
+//   - YAML override: same shape as the JSON block.
+//
+// Shape:
+//   {
+//     "platform": "DMX",
+//     "name": "DMX",
+//     "yamlPath": "/optional/path/to/dmx.yaml",
+//     "controllers": [
+//       { "id": "main", "type": "StickDE3", "ip": "192.168.96.2" }
+//     ],
+//     "profiles": [
+//       { "name": "WAC", "colormodel": "hsvcct",
+//         "channel_order": ["Intensity", "Intensity (Fine)",
+//                           "ColorTemp 1650-8000", "Saturation", "Hue"] }
+//     ],
+//     "patch": [
+//       { "id": "a_down", "name": "A Down", "type": "WAC",
+//         "controller": "main", "universe": "A", "start": 6 }
+//     ]
+//   }
+//
+// Output: a normalized `LoadedConfig` the platform consumes. Validates:
+//   - controllers: unique ids, supported type, ip present
+//   - profiles: colormodel recognised, channel_order parses cleanly, model
+//     requirements satisfied
+//   - patch: unique ids, references a known profile + controller, valid
+//     universe ∈ {A,B}, start in [1, 512-nch+1], no slot overlap within a
+//     single (controller, universe).
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { getColorModel } from './color/index.js';
+import { parseChannelName } from './color/parsers.js';
+export const CONTROLLER_TYPES = ['StickDE3'];
+export const DEFAULT_PLATFORM_NAME = 'DMX';
+/** Load + validate the platform config. `rawJson` is the Homebridge
+ *  `platforms[]` entry; if it specifies `yamlPath`, that YAML file is loaded
+ *  and treated as a full override of the JSON.
+ *
+ *  If `cwd` is passed, relative yamlPath is resolved against it. */
+export function loadConfig(rawJson, cwd) {
+    let raw = rawJson;
+    if (raw.yamlPath) {
+        const p = path.isAbsolute(raw.yamlPath) ? raw.yamlPath
+            : path.resolve(cwd ?? process.cwd(), raw.yamlPath);
+        const text = fs.readFileSync(p, 'utf8');
+        const parsed = yaml.load(text);
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error(`yamlPath ${p}: not an object`);
+        }
+        raw = { ...rawJson, ...parsed };
+    }
+    // Controllers
+    const controllerSpecs = raw.controllers ?? [];
+    if (controllerSpecs.length === 0) {
+        throw new Error('config: at least one controller required under "controllers"');
+    }
+    const controllersById = new Map();
+    for (const cs of controllerSpecs) {
+        if (!cs.id)
+            throw new Error('controller: missing id');
+        if (controllersById.has(cs.id)) {
+            throw new Error(`controller: duplicate id "${cs.id}"`);
+        }
+        if (!CONTROLLER_TYPES.includes(cs.type)) {
+            throw new Error(`controller "${cs.id}": unknown type "${cs.type}". ` +
+                `Supported: ${CONTROLLER_TYPES.join(', ')}`);
+        }
+        if (!cs.ip || typeof cs.ip !== 'string') {
+            throw new Error(`controller "${cs.id}": required field "ip" missing`);
+        }
+        controllersById.set(cs.id, { id: cs.id, type: cs.type, ip: cs.ip });
+    }
+    // Profiles
+    const profileSpecs = raw.profiles ?? [];
+    const profilesByName = new Map();
+    for (const ps of profileSpecs) {
+        if (!ps.name)
+            throw new Error('profile: missing name');
+        if (profilesByName.has(ps.name)) {
+            throw new Error(`profile: duplicate name "${ps.name}"`);
+        }
+        if (!Array.isArray(ps.channel_order) || ps.channel_order.length === 0) {
+            throw new Error(`profile "${ps.name}": channel_order must be a non-empty array`);
+        }
+        let model;
+        try {
+            model = getColorModel(ps.colormodel);
+        }
+        catch (e) {
+            throw new Error(`profile "${ps.name}": ${e.message}`);
+        }
+        let channels;
+        try {
+            channels = ps.channel_order.map(parseChannelName);
+        }
+        catch (e) {
+            throw new Error(`profile "${ps.name}" channel_order: ${e.message}`);
+        }
+        try {
+            model.validate(channels);
+        }
+        catch (e) {
+            throw new Error(`profile "${ps.name}": ${e.message}`);
+        }
+        profilesByName.set(ps.name, { name: ps.name, model, channels });
+    }
+    // Patch
+    const patchSpecs = raw.patch ?? [];
+    const fixtures = [];
+    const seenIds = new Set();
+    // Per controller + per universe: 512 channels, tracking which fixture
+    // owns each slot. Key is `${controllerId}:${universe}`.
+    const occupancy = new Map();
+    const slots = (cid, u) => {
+        const key = `${cid}:${u}`;
+        let m = occupancy.get(key);
+        if (!m) {
+            m = new Map();
+            occupancy.set(key, m);
+        }
+        return m;
+    };
+    for (const ps of patchSpecs) {
+        if (!ps.id)
+            throw new Error('patch: missing id');
+        if (seenIds.has(ps.id)) {
+            throw new Error(`patch: duplicate id "${ps.id}"`);
+        }
+        seenIds.add(ps.id);
+        const profile = profilesByName.get(ps.type);
+        if (!profile) {
+            throw new Error(`patch "${ps.id}": unknown profile "${ps.type}"`);
+        }
+        // controller reference. If only one controller is configured, default to it.
+        let controllerId = ps.controller;
+        if (!controllerId) {
+            if (controllersById.size === 1) {
+                controllerId = controllersById.keys().next().value;
+            }
+            else {
+                throw new Error(`patch "${ps.id}": "controller" required when more than one controller is configured`);
+            }
+        }
+        const controller = controllersById.get(controllerId);
+        if (!controller) {
+            throw new Error(`patch "${ps.id}": unknown controller "${controllerId}"`);
+        }
+        const universeChar = (ps.universe ?? 'A').toUpperCase();
+        if (universeChar !== 'A' && universeChar !== 'B') {
+            throw new Error(`patch "${ps.id}": universe must be 'A' or 'B', got "${ps.universe}"`);
+        }
+        const universe = universeChar === 'A' ? 0 : 1;
+        const nch = profile.channels.length;
+        const start = Number(ps.start);
+        if (!Number.isInteger(start) || start < 1 || start + nch - 1 > 512) {
+            throw new Error(`patch "${ps.id}": start ${ps.start} + ${nch} channels does not fit in 1..512`);
+        }
+        const slotMap = slots(controllerId, universe);
+        for (let i = 0; i < nch; i++) {
+            const slot = start + i;
+            const owner = slotMap.get(slot);
+            if (owner) {
+                throw new Error(`patch "${ps.id}": DMX slot ${slot}@${universeChar} ` +
+                    `(controller "${controllerId}") overlaps with "${owner}"`);
+            }
+            slotMap.set(slot, ps.id);
+        }
+        fixtures.push({
+            id: ps.id,
+            name: ps.name || ps.id,
+            profile,
+            controller,
+            universe,
+            startCh: start,
+            nChannels: nch,
+        });
+    }
+    return {
+        name: raw.name ?? DEFAULT_PLATFORM_NAME,
+        controllers: [...controllersById.values()],
+        fixtures,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/controller.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from 'homebridge';
+import { Fixture } from './config.js';
+import { HomeKitLightState } from './color/types.js';
+export declare class StickController {
+    private readonly ip;
+    private readonly log;
+    private readonly debounceMs;
+    private targets;
+    private lastChangeAt;
+    private streaming;
+    /** Tracks whether the very first subprocess in this controller's
+     *  lifetime should set RUN_PROBE=1. After a Stick power-cycle (which
+     *  we can't detect in-band) the probe is required to (re-)register
+     *  the client. Subsequent subprocesses can skip it. */
+    private needsProbe;
+    constructor(ip: string, log: Logger, debounceMs?: number);
+    /** Stage a fixture's bytes into the universe target buffer and ensure
+     *  the streaming loop is running. */
+    setFixture(fixture: Fixture, state: HomeKitLightState): void;
+    private universeBuf;
+    /** Build the CLI args from current targets. Only non-zero channels are
+     *  passed — send_dmx initialises the universe to 0 so omission == 0. */
+    private buildArgs;
+    /** Subprocess approach: spawn tools/send_dmx.mjs for each transaction.
+     *  Fresh node process = no in-process state poisoning that breaks
+     *  session 2+ in the long-lived plugin. Costs ~1.5-3s per spawn (process
+     *  startup + handshake + 750ms stream + RST) but is empirically reliable. */
+    private run;
+    /** Shutdown hook. Subprocess approach has no long-lived state. */
+    shutdown(): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKzC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AASrD,qBAAa,eAAe;IAWxB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAZ7B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B;;;2DAGuD;IACvD,OAAO,CAAC,UAAU,CAAQ;gBAGP,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAoB;IAGnD;yCACqC;IACrC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAmB5D,OAAO,CAAC,WAAW;IAMnB;4EACwE;IACxE,OAAO,CAAC,SAAS;IAUjB;;;iFAG6E;YAC/D,GAAG;IA+CjB,kEAAkE;IAClE,QAAQ,IAAI,IAAI;CAGjB"}