@vived/component-pneumatic-panel 1.1.1 → 2.0.0

package/README.md

@@ -15,13 +15,15 @@ A 3D interactive pneumatic control panel for VIVED slide applications. Features
 npm install @vived/component-pneumatic-panel @vived/core @babylonjs/core
 ```
 
+The host-facing surface is the **`PneumaticPanelFacade`** — a single typed object (Smart
+Component Facade Contract v1) that drives an instance through commands, typed events,
+lifecycle, and persisted state.
+
 ```typescript
 import { makeAppObjectRepo, makeDomainFactoryRepo } from "@vived/core";
 import {
   makePneumaticPanelFeatureFactory,
-  createBabylonPneumaticPanel,
-  tryToggleExhaust,
-  tryToggleLock,
+  PneumaticPanelFacade,
 } from "@vived/component-pneumatic-panel";
 
 const appObjects = makeAppObjectRepo();
@@ -29,32 +31,71 @@ const factoryRepo = makeDomainFactoryRepo(appObjects);
 makePneumaticPanelFeatureFactory(appObjects);
 factoryRepo.setupDomain();
 
-const appObject = await createBabylonPneumaticPanel("panel-1", appObjects);
+const panel = new PneumaticPanelFacade("panel-1", appObjects); // wires the domain stack (sync)
+await panel.load(); // attaches and loads the Babylon view
+
+panel.toggleExhaust(); // open exhaust
+panel.toggleLock(); // engage lock
+panel.toggleExhaust(); // false — blocked by lock
 
-tryToggleExhaust("panel-1", appObjects); // open exhaust
-tryToggleLock("panel-1", appObjects); // engage lock
-tryToggleExhaust("panel-1", appObjects); // false — blocked by lock
+const unsubscribe = panel.onEvent("exhaustOpened", () => console.log("opened"));
 ```
 
+> Need the raw `AppObject` (e.g. to parent the root node or register shadow casters)? Use
+> the `createBabylonPneumaticPanel(id, appObjects)` composition entry point, which creates
+> the same domain stack and view and returns the `AppObject`.
+
 ## API
 
-| Controller         | Returns   | Description                                               |
-| ------------------ | --------- | --------------------------------------------------------- |
-| `tryToggleExhaust` | `boolean` | Toggle exhaust valve. Returns `false` if locked.          |
-| `tryToggleLock`    | `boolean` | Toggle safety lock. Returns `false` if exhaust is closed. |
-| `checkPressure`    | `void`    | Shows current pressure in an alert dialog.                |
+`PneumaticPanelFacade` implements **Contract v1** — eight mandatory members shared by every
+VIVED smart component, plus component-specific commands and a typed event catalog.
+
+### Contract members
+
+| Member             | Signature                                  | Description                                              |
+| ------------------ | ------------------------------------------ | -------------------------------------------------------- |
+| `id`               | `readonly string`                          | Instance identifier.                                     |
+| `interfaceVersion` | `readonly number`                          | Contract version implemented (`1`).                      |
+| `onEvent`          | `(event, cb) => () => void`                | Subscribe to a typed event; returns unsubscribe.         |
+| `onViewModel`      | `(cb) => () => void`                       | Subscribe to the reactive VM (emits immediately).        |
+| `load`             | `(variant?) => Promise<void>`              | Attach and load the Babylon view.                        |
+| `destroy`          | `() => void`                               | Tear down and release resources.                         |
+| `getState`         | `() => PneumaticPanelState`                | Versioned state snapshot.                                |
+| `applyState`       | `(state) => void`                          | Restore a snapshot.                                      |
+
+### Commands
+
+| Command                       | Returns   | Description                                               |
+| ----------------------------- | --------- | --------------------------------------------------------- |
+| `toggleExhaust()`             | `boolean` | Toggle exhaust valve. Returns `false` if locked.          |
+| `toggleLock()`                | `boolean` | Toggle safety lock. Returns `false` if exhaust is closed. |
+| `checkPressure()`             | `void`    | Show current pressure in an alert dialog.                 |
+| `setShowGhostLockHint(show)`  | `void`    | Toggle always-visible ghost-lock hint.                    |
+| `enableHitbox()` / `disableHitbox()` | `void` | Toggle whole-panel selection mode.                   |
+
+### Events (`onEvent`)
+
+`exhaustOpened`, `exhaustClosed`, `exhaustCloseBlockedByLock`, `panelLocked`,
+`panelUnlocked`, `panelSelected`, `pressureChecked`.
+All callbacks are `() => void` — read current state from `getState()` or `onViewModel`.
+
+> Hover/hint/selection feedback is the Host's responsibility (ADR-0009). The component is
+> presentation-free for interaction state — read `view.highlightGroupsByObjectId` to outline
+> the panel from the invisible hitbox.
 
-### View Model
+### Reactive view model
 
 ```typescript
-interface PneumaticPanelVM {
-  exhaustOpen: boolean;
-  isLocked: boolean;
-  pressure: number;
-}
+const unsubscribe = panel.onViewModel((vm) => {
+  console.log(vm.exhaustOpen, vm.isLocked, vm.pressure, vm.panelHitboxEnabled);
+});
 ```
 
-Subscribe to state changes via `pneumaticPanelPMAdapter.subscribe(id, appObjects, callback)`.
+The flat controllers and `pneumaticPanelPMAdapter` remain exported as the underlying
+mechanism the facade delegates to (and which the Babylon view boundary calls directly),
+but the facade is the canonical host-facing surface. See
+[COMPONENT_KNOWLEDGE.md](COMPONENT_KNOWLEDGE.md) for the full API reference, recipes, and
+the complete export list.
 
 ## Development
 

package/dist/Domain/Adapters/pneumaticPanelPMAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pneumaticPanelPMAdapter.d.ts","sourceRoot":"","sources":["../../../src/Domain/Adapters/pneumaticPanelPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,CAAC,gBAAgB,CA0C/D,CAAC"}
+{"version":3,"file":"pneumaticPanelPMAdapter.d.ts","sourceRoot":"","sources":["../../../src/Domain/Adapters/pneumaticPanelPMAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,CAAC,gBAAgB,CAyC/D,CAAC"}

package/dist/Domain/Controllers/applyPanelState.d.ts

@@ -0,0 +1,4 @@
+import { AppObjectRepo } from "@vived/core";
+import type { PneumaticPanelState } from "../../PneumaticPanelFacade";
+export declare function applyPanelState(id: string, appObjects: AppObjectRepo, state: Partial<PneumaticPanelState>): void;
+//# sourceMappingURL=applyPanelState.d.ts.map

package/dist/Domain/Controllers/applyPanelState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPanelState.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/applyPanelState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,EACzB,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAClC,IAAI,CAoBN"}

package/dist/Domain/Controllers/getPanelState.d.ts

@@ -0,0 +1,4 @@
+import { AppObjectRepo } from "@vived/core";
+import type { PneumaticPanelState } from "../../PneumaticPanelFacade";
+export declare function getPanelState(id: string, appObjects: AppObjectRepo, version: number): PneumaticPanelState;
+//# sourceMappingURL=getPanelState.d.ts.map

package/dist/Domain/Controllers/getPanelState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPanelState.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/getPanelState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,MAAM,GACd,mBAAmB,CAqBrB"}

package/dist/Domain/Controllers/panelStateDefaults.d.ts

@@ -0,0 +1,7 @@
+export declare const PNEUMATIC_PANEL_DEFAULT_STATE_FIELDS: {
+    readonly exhaustOpen: false;
+    readonly isLocked: false;
+    readonly showGhostLockHint: false;
+    readonly panelHitboxEnabled: false;
+};
+//# sourceMappingURL=panelStateDefaults.d.ts.map

package/dist/Domain/Controllers/panelStateDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelStateDefaults.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/panelStateDefaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC;;;;;CAKvC,CAAC"}

package/dist/Domain/Entities/PneumaticPanelEntity.d.ts

@@ -1,5 +1,4 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
-export type PneumaticPanelHighlightedObject = "none" | "ghostLock" | "lock" | "exhaustKnob" | "gauge" | "panelHitbox";
 /**
  * Pneumatic Panel Entity
  *
@@ -23,9 +22,6 @@ export declare abstract class PneumaticPanelEntity extends AppObjectEntity {
      */
     abstract get showGhostLockHint(): boolean;
     abstract set showGhostLockHint(val: boolean);
-    /** Which object should be highlighted in the scene. */
-    abstract get highlightedObject(): PneumaticPanelHighlightedObject;
-    abstract set highlightedObject(val: PneumaticPanelHighlightedObject);
     /** Whether the panel hitbox is enabled for whole-panel selection. */
     abstract get panelHitboxEnabled(): boolean;
     abstract set panelHitboxEnabled(val: boolean);

package/dist/Domain/Entities/PneumaticPanelEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelEntity.d.ts","sourceRoot":"","sources":["../../../src/Domain/Entities/PneumaticPanelEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAGd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,+BAA+B,GACvC,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,OAAO,GACP,aAAa,CAAC;AAElB;;;;;GAKG;AACH,8BAAsB,oBAAqB,SAAQ,eAAe;IAChE,MAAM,CAAC,QAAQ,CAAC,IAAI,0BAA0B;IAE9C,wCAAwC;IACxC,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC;IACpC,QAAQ,KAAK,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE;IAEvC,gEAAgE;IAChE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE;IAEpC,+BAA+B;IAC/B,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE;IAEnC;;;OAGG;IACH,QAAQ,KAAK,iBAAiB,IAAI,OAAO,CAAC;IAC1C,QAAQ,KAAK,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE;IAE7C,uDAAuD;IACvD,QAAQ,KAAK,iBAAiB,IAAI,+BAA+B,CAAC;IAClE,QAAQ,KAAK,iBAAiB,CAAC,GAAG,EAAE,+BAA+B,EAAE;IAErE,qEAAqE;IACrE,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAC3C,QAAQ,KAAK,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE;IAE9C;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,GAAG,SAAS;IAI/D;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,oBAAoB,GAAG,SAAS;CAGpC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,oBAAoB,CAEtB"}
+{"version":3,"file":"PneumaticPanelEntity.d.ts","sourceRoot":"","sources":["../../../src/Domain/Entities/PneumaticPanelEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAGd,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,8BAAsB,oBAAqB,SAAQ,eAAe;IAChE,MAAM,CAAC,QAAQ,CAAC,IAAI,0BAA0B;IAE9C,wCAAwC;IACxC,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC;IACpC,QAAQ,KAAK,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE;IAEvC,gEAAgE;IAChE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE;IAEpC,+BAA+B;IAC/B,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE;IAEnC;;;OAGG;IACH,QAAQ,KAAK,iBAAiB,IAAI,OAAO,CAAC;IAC1C,QAAQ,KAAK,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE;IAE7C,qEAAqE;IACrE,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAC3C,QAAQ,KAAK,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE;IAE9C;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,GAAG,SAAS;IAI/D;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,oBAAoB,GAAG,SAAS;CAGpC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,oBAAoB,CAEtB"}

package/dist/Domain/Mocks/MockPneumaticPanelSelectUC.d.ts

@@ -6,7 +6,7 @@ import { PneumaticPanelSelectUC } from "../UCs/PneumaticPanelSelectUC";
 export declare class MockPneumaticPanelSelectUC extends PneumaticPanelSelectUC {
     enableHitbox: () => void;
     disableHitbox: () => void;
-    subscribeOnPanelSelected: (_callback: () => void) => (() => void);
+    subscribeOnPanelSelected: () => (() => void);
     notifyPanelSelected: () => void;
     constructor(appObject: AppObject);
 }

package/dist/Domain/Mocks/MockPneumaticPanelSelectUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockPneumaticPanelSelectUC.d.ts","sourceRoot":"","sources":["../../../src/Domain/Mocks/MockPneumaticPanelSelectUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,sBAAsB;IACpE,YAAY,QAAO,IAAI,CAAO;IAC9B,aAAa,QAAO,IAAI,CAAO;IAC/B,wBAAwB,GACrB,WAAW,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAC5B;IACX,mBAAmB,QAAO,IAAI,CAAO;gBAEzB,SAAS,EAAE,SAAS;CAGjC"}
+{"version":3,"file":"MockPneumaticPanelSelectUC.d.ts","sourceRoot":"","sources":["../../../src/Domain/Mocks/MockPneumaticPanelSelectUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,sBAAsB;IACpE,YAAY,QAAO,IAAI,CAAO;IAC9B,aAAa,QAAO,IAAI,CAAO;IAC/B,wBAAwB,QAAO,CAAC,MAAM,IAAI,CAAC,CAAa;IACxD,mBAAmB,QAAO,IAAI,CAAO;gBAEzB,SAAS,EAAE,SAAS;CAGjC"}

package/dist/Domain/PMs/PneumaticPanelPM.d.ts

@@ -1,5 +1,4 @@
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
-import { type PneumaticPanelHighlightedObject } from "../Entities/PneumaticPanelEntity";
 /**
  * View Model for Pneumatic Panel UI rendering.
  * Immutable snapshot of component state suitable for views.
@@ -16,8 +15,6 @@ export interface PneumaticPanelVM {
      * When false, reveal it only on hover (assessment mode).
      */
     showGhostLockHint: boolean;
-    /** Which object should be highlighted in the scene. */
-    highlightedObject: PneumaticPanelHighlightedObject;
     /** Whether the panel hitbox is enabled for whole-panel selection. */
     panelHitboxEnabled: boolean;
     /**

package/dist/Domain/PMs/PneumaticPanelPM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelPM.d.ts","sourceRoot":"","sources":["../../../src/Domain/PMs/PneumaticPanelPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,iBAAiB,EAAE,+BAA+B,CAAC;IACnD,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,8BAAsB,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,IAAI,sBAAsB;IAE1C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS;IAI3D,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,gBAAgB,GAAG,SAAS;CAGhC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}
+{"version":3,"file":"PneumaticPanelPM.d.ts","sourceRoot":"","sources":["../../../src/Domain/PMs/PneumaticPanelPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,8BAAsB,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,IAAI,sBAAsB;IAE1C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS;IAI3D,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,gBAAgB,GAAG,SAAS;CAGhC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAE3E"}

package/dist/Domain/makeDomainForTesting.d.ts

@@ -0,0 +1,6 @@
+import { AppObjectRepo } from "@vived/core";
+export interface DomainForTesting {
+    appObjects: AppObjectRepo;
+}
+export declare function makeDomainForTesting(): DomainForTesting;
+//# sourceMappingURL=makeDomainForTesting.d.ts.map

package/dist/Domain/makeDomainForTesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeDomainForTesting.d.ts","sourceRoot":"","sources":["../../src/Domain/makeDomainForTesting.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAGd,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,IAAI,gBAAgB,CAMvD"}

package/dist/Frameworks/Babylon/PneumaticPanelBabylonView.d.ts

@@ -2,14 +2,6 @@ import type { AbstractMesh } from "@babylonjs/core";
 import type { Node } from "@babylonjs/core";
 import type { TransformNode } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
-export type PneumaticPanelGlowConfig = {
-    blurHorizontalSize: number;
-    blurVerticalSize: number;
-    innerGlow: boolean;
-    isEnabled: boolean;
-    neutralAlpha: number;
-    outerGlow: boolean;
-};
 export declare abstract class PneumaticPanelBabylonView extends AppObjectView {
     static readonly type = "PneumaticPanelBabylonView";
     /** Resolves the Babylon scene, loads meshes, and subscribes to updates. */
@@ -20,10 +12,15 @@ export declare abstract class PneumaticPanelBabylonView extends AppObjectView {
     abstract get shadowCasters(): AbstractMesh[];
     /** Lookup of every scene node keyed by its objectId metadata. Populated after load() completes. */
     abstract get nodesByObjectId(): ReadonlyMap<string, Node>;
-    /** Current runtime glow/highlight layer config used by this view. */
-    abstract get glowConfig(): Readonly<PneumaticPanelGlowConfig>;
-    /** Merge-and-apply a partial glow config at runtime. */
-    abstract updateGlowConfig(patch: Partial<PneumaticPanelGlowConfig>): Readonly<PneumaticPanelGlowConfig>;
+    /**
+     * Meshes the Host should treat as one highlightable unit, keyed by semantic objectId.
+     * Populated after load() completes.
+     *
+     * The `panel_hitbox` entry maps to every visible panel mesh (all meshes except the
+     * invisible hitbox itself), so outlining the invisible hitbox outlines the visible panel.
+     * All other entries map to a single-element array for their respective mesh.
+     */
+    abstract get highlightGroupsByObjectId(): ReadonlyMap<string, AbstractMesh[]>;
     static get(appObj: AppObject): PneumaticPanelBabylonView | undefined;
 }
 export declare function makePneumaticPanelBabylonView(appObject: AppObject): PneumaticPanelBabylonView;

package/dist/Frameworks/Babylon/PneumaticPanelBabylonView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelBabylonView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelBabylonView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBvD,MAAM,MAAM,wBAAwB,GAAG;IACrC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,8BAAsB,yBAA0B,SAAQ,aAAa;IACnE,MAAM,CAAC,QAAQ,CAAC,IAAI,+BAA+B;IAEnD,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B,gGAAgG;IAChG,QAAQ,KAAK,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAAC;IAE5D,sEAAsE;IACtE,QAAQ,KAAK,aAAa,IAAI,YAAY,EAAE,CAAC;IAE7C,mGAAmG;IACnG,QAAQ,KAAK,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1D,qEAAqE;IACrE,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IAE9D,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,CACvB,KAAK,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACvC,QAAQ,CAAC,wBAAwB,CAAC;IAErC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,yBAAyB,GAAG,SAAS;CAGrE;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,GACnB,yBAAyB,CAE3B"}
+{"version":3,"file":"PneumaticPanelBabylonView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelBabylonView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBvD,8BAAsB,yBAA0B,SAAQ,aAAa;IACnE,MAAM,CAAC,QAAQ,CAAC,IAAI,+BAA+B;IAEnD,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B,gGAAgG;IAChG,QAAQ,KAAK,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAAC;IAE5D,sEAAsE;IACtE,QAAQ,KAAK,aAAa,IAAI,YAAY,EAAE,CAAC;IAE7C,mGAAmG;IACnG,QAAQ,KAAK,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,QAAQ,KAAK,yBAAyB,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAE9E,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,yBAAyB,GAAG,SAAS;CAGrE;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,GACnB,yBAAyB,CAE3B"}

package/dist/Frameworks/Babylon/PneumaticPanelExhaustView.d.ts

@@ -1,4 +1,4 @@
-import { HighlightLayer, Node } from "@babylonjs/core";
+import { Node } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
 export declare const pneumaticPanelExhaustKnobMetadata = "exhaust_knob";
 /**
@@ -10,7 +10,7 @@ export declare const pneumaticPanelExhaustKnobMetadata = "exhaust_knob";
  */
 export declare abstract class PneumaticPanelExhaustView extends AppObjectView {
     static readonly type = "PneumaticPanelExhaustView";
-    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>, highlightLayer: HighlightLayer): void;
+    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>): void;
     static get(appObj: AppObject): PneumaticPanelExhaustView | undefined;
 }
 export declare function makePneumaticPanelExhaustView(appObject: AppObject): PneumaticPanelExhaustView;

package/dist/Frameworks/Babylon/PneumaticPanelExhaustView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelExhaustView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelExhaustView.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,cAAc,EACd,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQvD,eAAO,MAAM,iCAAiC,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,8BAAsB,yBAA0B,SAAQ,aAAa;IACnE,MAAM,CAAC,QAAQ,CAAC,IAAI,+BAA+B;IAEnD,QAAQ,CAAC,UAAU,CACjB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAC1C,cAAc,EAAE,cAAc,GAC7B,IAAI;IAEP,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,yBAAyB,GAAG,SAAS;CAGrE;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,GACnB,yBAAyB,CAE3B"}
+{"version":3,"file":"PneumaticPanelExhaustView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelExhaustView.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMvD,eAAO,MAAM,iCAAiC,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,8BAAsB,yBAA0B,SAAQ,aAAa;IACnE,MAAM,CAAC,QAAQ,CAAC,IAAI,+BAA+B;IAEnD,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI;IAErE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,yBAAyB,GAAG,SAAS;CAGrE;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,GACnB,yBAAyB,CAE3B"}

package/dist/Frameworks/Babylon/PneumaticPanelGaugeView.d.ts

@@ -1,9 +1,9 @@
-import { HighlightLayer, Node } from "@babylonjs/core";
+import { Node } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
 export declare const pneumaticPanelGaugeMetadata = "gauge";
 export declare abstract class PneumaticPanelGaugeView extends AppObjectView {
     static readonly type = "PneumaticPanelGaugeView";
-    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>, highlightLayer: HighlightLayer): void;
+    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>): void;
     static get(appObj: AppObject): PneumaticPanelGaugeView | undefined;
 }
 export declare function makePneumaticPanelGaugeView(appObject: AppObject): PneumaticPanelGaugeView;

package/dist/Frameworks/Babylon/PneumaticPanelGaugeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelGaugeView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelGaugeView.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOvD,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD,8BAAsB,uBAAwB,SAAQ,aAAa;IACjE,MAAM,CAAC,QAAQ,CAAC,IAAI,6BAA6B;IAEjD,QAAQ,CAAC,UAAU,CACjB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAC1C,cAAc,EAAE,cAAc,GAC7B,IAAI;IAEP,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,uBAAuB,GAAG,SAAS;CAGnE;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,GACnB,uBAAuB,CAEzB"}
+{"version":3,"file":"PneumaticPanelGaugeView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelGaugeView.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKvD,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD,8BAAsB,uBAAwB,SAAQ,aAAa;IACjE,MAAM,CAAC,QAAQ,CAAC,IAAI,6BAA6B;IAEjD,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI;IAErE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,uBAAuB,GAAG,SAAS;CAGnE;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,GACnB,uBAAuB,CAEzB"}

package/dist/Frameworks/Babylon/PneumaticPanelHitboxView.d.ts

@@ -1,17 +1,16 @@
-import { HighlightLayer, Node } from "@babylonjs/core";
+import { Node } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
 export declare const pneumaticPanelHitboxMetadata = "panel_hitbox";
 /**
- * Babylon view that owns panel hitbox interaction and visual feedback.
+ * Babylon view that owns panel hitbox click interaction.
  *
  * The hitbox is an invisible bounding mesh (objectId: "panel_hitbox") that
- * covers the entire panel. When enabled, it is pickable and responds to
- * pointer events with a hover outline. The Activity-authored hint glow is
- * driven by highlightedObject === "panelHitbox" via the domain VM.
+ * covers the entire panel. When enabled, it is pickable. The Host owns all
+ * hover detection and interaction-state presentation (ADR 0009).
  */
 export declare abstract class PneumaticPanelHitboxView extends AppObjectView {
     static readonly type = "PneumaticPanelHitboxView";
-    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>, highlightLayer: HighlightLayer): void;
+    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>): void;
     static get(appObj: AppObject): PneumaticPanelHitboxView | undefined;
 }
 export declare function makePneumaticPanelHitboxView(appObject: AppObject): PneumaticPanelHitboxView;

package/dist/Frameworks/Babylon/PneumaticPanelHitboxView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelHitboxView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelHitboxView.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EAEd,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOvD,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAQ3D;;;;;;;GAOG;AACH,8BAAsB,wBAAyB,SAAQ,aAAa;IAClE,MAAM,CAAC,QAAQ,CAAC,IAAI,8BAA8B;IAElD,QAAQ,CAAC,UAAU,CACjB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAC1C,cAAc,EAAE,cAAc,GAC7B,IAAI;IAEP,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,wBAAwB,GAAG,SAAS;CAGpE;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,GACnB,wBAAwB,CAE1B"}
+{"version":3,"file":"PneumaticPanelHitboxView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelHitboxView.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKvD,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAE3D;;;;;;GAMG;AACH,8BAAsB,wBAAyB,SAAQ,aAAa;IAClE,MAAM,CAAC,QAAQ,CAAC,IAAI,8BAA8B;IAElD,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI;IAErE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,wBAAwB,GAAG,SAAS;CAGpE;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,GACnB,wBAAwB,CAE1B"}

package/dist/Frameworks/Babylon/PneumaticPanelLockView.d.ts

@@ -1,4 +1,4 @@
-import { HighlightLayer, Node } from "@babylonjs/core";
+import { Node } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
 export declare const pneumaticPanelLockMetadata = "lock";
 export declare const pneumaticPanelGhostLockMetadata = "ghost_lock";
@@ -10,7 +10,7 @@ export declare const pneumaticPanelGhostLockMetadata = "ghost_lock";
  */
 export declare abstract class PneumaticPanelLockView extends AppObjectView {
     static readonly type = "PneumaticPanelLockView";
-    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>, highlightLayer: HighlightLayer): void;
+    abstract bindMeshes(nodesByObjectId: ReadonlyMap<string, Node>): void;
     abstract flash(): void;
     static get(appObj: AppObject): PneumaticPanelLockView | undefined;
 }

package/dist/Frameworks/Babylon/PneumaticPanelLockView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelLockView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelLockView.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,cAAc,EACd,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOvD,eAAO,MAAM,0BAA0B,SAAS,CAAC;AACjD,eAAO,MAAM,+BAA+B,eAAe,CAAC;AAE5D;;;;;GAKG;AACH,8BAAsB,sBAAuB,SAAQ,aAAa;IAChE,MAAM,CAAC,QAAQ,CAAC,IAAI,4BAA4B;IAEhD,QAAQ,CAAC,UAAU,CACjB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAC1C,cAAc,EAAE,cAAc,GAC7B,IAAI;IACP,QAAQ,CAAC,KAAK,IAAI,IAAI;IAEtB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,GAAG,SAAS;CAGlE;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}
+{"version":3,"file":"PneumaticPanelLockView.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PneumaticPanelLockView.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKvD,eAAO,MAAM,0BAA0B,SAAS,CAAC;AACjD,eAAO,MAAM,+BAA+B,eAAe,CAAC;AAE5D;;;;;GAKG;AACH,8BAAsB,sBAAuB,SAAQ,aAAa;IAChE,MAAM,CAAC,QAAQ,CAAC,IAAI,4BAA4B;IAEhD,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI;IACrE,QAAQ,CAAC,KAAK,IAAI,IAAI;IAEtB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,GAAG,SAAS;CAGlE;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}

package/dist/PneumaticPanelFacade.d.ts

@@ -0,0 +1,116 @@
+import { AppObjectRepo } from "@vived/core";
+import type { PneumaticPanelVM } from "./Domain/PMs/PneumaticPanelPM";
+export declare const PNEUMATIC_PANEL_STATE_VERSION = 2;
+export type PneumaticPanelState = {
+    version: number;
+    exhaustOpen: boolean;
+    isLocked: boolean;
+    showGhostLockHint: boolean;
+    panelHitboxEnabled: boolean;
+};
+/**
+ * SmartComponent structural convention (local definition per ADR-0006).
+ * Smart Component Facade Contract v1 — eight mandatory members. Copied
+ * per-project and satisfied by structural typing (no shared base class).
+ */
+export interface SmartComponent {
+    readonly id: string;
+    readonly interfaceVersion: number;
+    onEvent(event: string, cb: (...args: never[]) => void): () => void;
+    onViewModel(cb: (vm: PneumaticPanelVM) => void): () => void;
+    load(variant?: string): Promise<void>;
+    destroy(): void;
+    getState(): PneumaticPanelState;
+    applyState(state: PneumaticPanelState): void;
+}
+/**
+ * Typed event catalog for PneumaticPanel events (per ADR-0006)
+ */
+export type PneumaticPanelEvents = {
+    exhaustOpened: () => void;
+    exhaustClosed: () => void;
+    exhaustCloseBlockedByLock: () => void;
+    panelLocked: () => void;
+    panelUnlocked: () => void;
+    panelSelected: () => void;
+    pressureChecked: () => void;
+};
+/**
+ * Host-facing facade for Pneumatic Panel smart component.
+ * Wraps flat controllers behind a single typed class implementing SmartComponent.
+ */
+export declare class PneumaticPanelFacade implements SmartComponent {
+    readonly id: string;
+    readonly interfaceVersion = 1;
+    private appObjects;
+    /**
+     * Dispatch map: event key → subscribe controller
+     * Each controller has signature: (id, appObjects, cb: () => void) => () => void
+     */
+    private eventDispatchMap;
+    /**
+     * Constructor: synchronously wire the domain instance.
+     * No Babylon dependency; fully headless and testable.
+     *
+     * @param id - The instance identifier
+     * @param appObjects - The AppObject repository
+     */
+    constructor(id: string, appObjects: AppObjectRepo);
+    /**
+     * Asynchronously load and attach the Babylon view.
+     * Required before the component renders in a 3D scene.
+     */
+    /**
+     * Asynchronously load and attach the Babylon view.
+     *
+     * @param variant - Optional asset variant. No variants are implemented yet,
+     *   so an omitted or unrecognized variant loads the default asset
+     *   (best-effort, per Contract v1).
+     */
+    load(variant?: string): Promise<void>;
+    /**
+     * Tear down the component and release all resources.
+     */
+    destroy(): void;
+    /**
+     * Toggle the exhaust valve open/closed.
+     * @returns true if toggle succeeded, false if blocked (e.g., by lock)
+     */
+    toggleExhaust(): boolean;
+    /**
+     * Toggle the lock state.
+     * @returns true if toggle succeeded, false if blocked (e.g., exhaust open)
+     */
+    toggleLock(): boolean;
+    /**
+     * Trigger a pressure check.
+     */
+    checkPressure(): void;
+    /**
+     * Show or hide the ghost lock hint.
+     */
+    setShowGhostLockHint(show: boolean): void;
+    /**
+     * Enable the whole-panel hitbox for single-target selection.
+     */
+    enableHitbox(): void;
+    /**
+     * Disable the whole-panel hitbox, restoring sub-component interactivity.
+     */
+    disableHitbox(): void;
+    getState(): PneumaticPanelState;
+    applyState(state: PneumaticPanelState): void;
+    /**
+     * Subscribe to a typed event.
+     * @param event - The event key (typed by PneumaticPanelEvents)
+     * @param cb - The callback function
+     * @returns An unsubscribe function
+     */
+    onEvent<K extends keyof PneumaticPanelEvents>(event: K, cb: PneumaticPanelEvents[K]): () => void;
+    /**
+     * Subscribe to the reactive view model. Emits the current VM immediately,
+     * then on every change. Returns an unsubscribe function.
+     */
+    onViewModel(cb: (vm: PneumaticPanelVM) => void): () => void;
+}
+//# sourceMappingURL=PneumaticPanelFacade.d.ts.map

package/dist/PneumaticPanelFacade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PneumaticPanelFacade.d.ts","sourceRoot":"","sources":["../src/PneumaticPanelFacade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkB5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,IAAI,mBAAmB,CAAC;IAChC,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,yBAAyB,EAAE,MAAM,IAAI,CAAC;IACtC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,gBAAgB,KAAK;IAC9B,OAAO,CAAC,UAAU,CAAgB;IAElC;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAWtB;IAEF;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;IASjD;;;OAGG;IACH;;;;;;OAMG;IAEG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB,QAAQ,IAAI,mBAAmB;IAQ/B,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAI5C;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,oBAAoB,EAC1C,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC1B,MAAM,IAAI;IAKb;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;CAI5D"}

package/dist/index.d.ts

@@ -13,8 +13,8 @@ export { tryToggleExhaust } from "./Domain/Controllers/tryToggleExhaust";
 export { tryToggleLock } from "./Domain/Controllers/tryToggleLock";
 export { checkPressure } from "./Domain/Controllers/checkPressure";
 export { setShowGhostLockHint } from "./Domain/Controllers/setShowGhostLockHint";
-export { setHighlightedObject } from "./Domain/Controllers/setHighlightedObject";
-export { clearAllHighlights } from "./Domain/Controllers/clearAllHighlights";
+export { getPanelState } from "./Domain/Controllers/getPanelState";
+export { applyPanelState } from "./Domain/Controllers/applyPanelState";
 export { onExhaustOpened } from "./Domain/Controllers/onExhaustOpened";
 export { onExhaustClosed } from "./Domain/Controllers/onExhaustClosed";
 export { onExhaustCloseBlockedByLock } from "./Domain/Controllers/onExhaustCloseBlockedByLock";
@@ -27,7 +27,7 @@ export { onCheckPressure } from "./Domain/Controllers/onCheckPressure";
 export { panelHitboxClicked } from "./Domain/Controllers/panelHitboxClicked";
 export { PneumaticPanelPM, makePneumaticPanelPM, type PneumaticPanelVM, } from "./Domain/PMs/PneumaticPanelPM";
 export { pneumaticPanelPMAdapter } from "./Domain/Adapters/pneumaticPanelPMAdapter";
-export { PneumaticPanelBabylonView, makePneumaticPanelBabylonView, type PneumaticPanelGlowConfig, } from "./Frameworks/Babylon/PneumaticPanelBabylonView";
+export { PneumaticPanelBabylonView, makePneumaticPanelBabylonView, } from "./Frameworks/Babylon/PneumaticPanelBabylonView";
 export { PneumaticPanelFeatureFactory, makePneumaticPanelFeatureFactory, } from "./Domain/Factory/PneumaticPanelFeatureFactory";
 export { createBabylonPneumaticPanel } from "./Frameworks/Babylon/createBabylonPneumaticPanel";
 export { MockPneumaticPanelPM } from "./Domain/Mocks/MockPneumaticPanelPM";
@@ -36,4 +36,5 @@ export { MockPneumaticPanelToggleLockUC } from "./Domain/Mocks/MockPneumaticPane
 export { MockPneumaticPanelCheckPressureUC } from "./Domain/Mocks/MockPneumaticPanelCheckPressureUC";
 export { MockPneumaticPanelSelectUC } from "./Domain/Mocks/MockPneumaticPanelSelectUC";
 export { default as componentConfig } from "./component.config";
+export { PneumaticPanelFacade, PNEUMATIC_PANEL_STATE_VERSION, type PneumaticPanelState, type SmartComponent, type PneumaticPanelEvents, } from "./PneumaticPanelFacade";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,gDAAgD,CAAC;AAGxD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,+CAA+C,CAAC;AAGvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAG/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAGvF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,gDAAgD,CAAC;AAGxD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,+CAA+C,CAAC;AAGvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAG/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAGvF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC"}