@vived/component-pneumatic-panel 1.1.1 → 1.2.0

package/README.md

@@ -54,7 +54,9 @@ interface PneumaticPanelVM {
 }
 ```
 
-Subscribe to state changes via `pneumaticPanelPMAdapter.subscribe(id, appObjects, callback)`.
+Subscribe to state changes via the facade: `panel.onViewModel(callback)` (returns an
+unsubscribe function). See `COMPONENT_KNOWLEDGE.md` for the full `PneumaticPanelFacade`
+host-facing surface.
 
 ## Development
 

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,CAuBN"}

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,CAsBrB"}

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

@@ -0,0 +1,7 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Subscribes to panel-hover-enter events on the given panel.
+ * Returns an unsubscribe function.
+ */
+export declare function onPanelHoverEnter(id: string, appObjects: AppObjectRepo, callback: () => void): () => void;
+//# sourceMappingURL=onPanelHoverEnter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onPanelHoverEnter.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/onPanelHoverEnter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAYZ"}

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

@@ -0,0 +1,7 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Subscribes to panel-hover-exit events on the given panel.
+ * Returns an unsubscribe function.
+ */
+export declare function onPanelHoverExit(id: string, appObjects: AppObjectRepo, callback: () => void): () => void;
+//# sourceMappingURL=onPanelHoverExit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onPanelHoverExit.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/onPanelHoverExit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAYZ"}

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

@@ -0,0 +1,7 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Framework boundary controller — called by the Babylon HitboxView when
+ * the pointer enters the panel_hitbox mesh. Notifies domain subscribers.
+ */
+export declare function panelHitboxHoverEnter(id: string, appObjects: AppObjectRepo): void;
+//# sourceMappingURL=panelHitboxHoverEnter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panelHitboxHoverEnter.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/panelHitboxHoverEnter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,IAAI,CAYN"}

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

@@ -0,0 +1,7 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Framework boundary controller — called by the Babylon HitboxView when
+ * the pointer exits the panel_hitbox mesh. Notifies domain subscribers.
+ */
+export declare function panelHitboxHoverExit(id: string, appObjects: AppObjectRepo): void;
+//# sourceMappingURL=panelHitboxHoverExit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panelHitboxHoverExit.d.ts","sourceRoot":"","sources":["../../../src/Domain/Controllers/panelHitboxHoverExit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,IAAI,CAYN"}

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

@@ -0,0 +1,8 @@
+export declare const PNEUMATIC_PANEL_DEFAULT_STATE_FIELDS: {
+    readonly exhaustOpen: false;
+    readonly isLocked: false;
+    readonly showGhostLockHint: false;
+    readonly highlightedObject: "none";
+    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;;;;;;CAMvC,CAAC"}

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

@@ -6,8 +6,12 @@ import { PneumaticPanelSelectUC } from "../UCs/PneumaticPanelSelectUC";
 export declare class MockPneumaticPanelSelectUC extends PneumaticPanelSelectUC {
     enableHitbox: () => void;
     disableHitbox: () => void;
-    subscribeOnPanelSelected: (_callback: () => void) => (() => void);
+    subscribeOnPanelSelected: () => (() => void);
     notifyPanelSelected: () => void;
+    subscribeOnPanelHoverEnter: () => (() => void);
+    notifyPanelHoverEnter: () => void;
+    subscribeOnPanelHoverExit: () => (() => void);
+    notifyPanelHoverExit: () => void;
     constructor(appObject: AppObject);
 }
 //# sourceMappingURL=MockPneumaticPanelSelectUC.d.ts.map

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;IACrC,0BAA0B,QAAO,CAAC,MAAM,IAAI,CAAC,CAAa;IAC1D,qBAAqB,QAAO,IAAI,CAAO;IACvC,yBAAyB,QAAO,CAAC,MAAM,IAAI,CAAC,CAAa;IACzD,oBAAoB,QAAO,IAAI,CAAO;gBAE1B,SAAS,EAAE,SAAS;CAGjC"}

package/dist/Domain/UCs/PneumaticPanelSelectUC.d.ts

@@ -18,6 +18,20 @@ export declare abstract class PneumaticPanelSelectUC extends AppObjectUC {
      * Called exclusively via the panelHitboxClicked controller (framework boundary).
      */
     abstract notifyPanelSelected(): void;
+    /** Subscribe to panel-hover-enter events. Returns an unsubscribe function. */
+    abstract subscribeOnPanelHoverEnter(callback: () => void): () => void;
+    /**
+     * Notify all subscribers that the pointer entered the panel hitbox.
+     * Called exclusively via the panelHitboxHoverEnter controller (framework boundary).
+     */
+    abstract notifyPanelHoverEnter(): void;
+    /** Subscribe to panel-hover-exit events. Returns an unsubscribe function. */
+    abstract subscribeOnPanelHoverExit(callback: () => void): () => void;
+    /**
+     * Notify all subscribers that the pointer exited the panel hitbox.
+     * Called exclusively via the panelHitboxHoverExit controller (framework boundary).
+     */
+    abstract notifyPanelHoverExit(): void;
     static get(appObj: AppObject): PneumaticPanelSelectUC | undefined;
     static getById(id: string, appObjects: AppObjectRepo): PneumaticPanelSelectUC | undefined;
 }

package/dist/Domain/UCs/PneumaticPanelSelectUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PneumaticPanelSelectUC.d.ts","sourceRoot":"","sources":["../../../src/Domain/UCs/PneumaticPanelSelectUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpE;;;;;GAKG;AACH,8BAAsB,sBAAuB,SAAQ,WAAW;IAC9D,MAAM,CAAC,QAAQ,CAAC,IAAI,4BAA4B;IAEhD,mDAAmD;IACnD,QAAQ,CAAC,YAAY,IAAI,IAAI;IAE7B,mFAAmF;IACnF,QAAQ,CAAC,aAAa,IAAI,IAAI;IAE9B,2EAA2E;IAC3E,QAAQ,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAEnE;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,IAAI,IAAI;IAEpC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,GAAG,SAAS;IAIjE,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,sBAAsB,GAAG,SAAS;CAGtC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}
+{"version":3,"file":"PneumaticPanelSelectUC.d.ts","sourceRoot":"","sources":["../../../src/Domain/UCs/PneumaticPanelSelectUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGpE;;;;;GAKG;AACH,8BAAsB,sBAAuB,SAAQ,WAAW;IAC9D,MAAM,CAAC,QAAQ,CAAC,IAAI,4BAA4B;IAEhD,mDAAmD;IACnD,QAAQ,CAAC,YAAY,IAAI,IAAI;IAE7B,mFAAmF;IACnF,QAAQ,CAAC,aAAa,IAAI,IAAI;IAE9B,2EAA2E;IAC3E,QAAQ,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAEnE;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,IAAI,IAAI;IAEpC,8EAA8E;IAC9E,QAAQ,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAErE;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,IAAI,IAAI;IAEtC,6EAA6E;IAC7E,QAAQ,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAEpE;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,IAAI,IAAI;IAErC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,GAAG,SAAS;IAIjE,MAAM,CAAC,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,aAAa,GACxB,sBAAsB,GAAG,SAAS;CAGtC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,GACnB,sBAAsB,CAExB"}

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/PanelOutlineController.d.ts

@@ -0,0 +1,32 @@
+import { AbstractMesh, Color3, Scene } from "@babylonjs/core";
+type PanelOutlineOptions = {
+    /** Outline color (default: amber `Color3(1, 0.8, 0)`). */
+    color?: Color3;
+    /** Outline edge width in **pixels** (default: 4). */
+    thickness?: number;
+    /**
+     * How much to dim the outline where the panel is occluded by foreground objects.
+     * 0 = fully visible through occluders (x-ray); 1 = hidden behind occluders.
+     * Default: 0 (full-strength see-through, per user requirement).
+     */
+    occlusionStrength?: number;
+};
+export type PanelOutlineController = {
+    apply(on: boolean): void;
+    dispose(): void;
+};
+/**
+ * Screen-space outline controller wrapping Babylon's `SelectionOutlineLayer`.
+ *
+ * Draws a crisp, unified silhouette around a group of meshes on hover:
+ * - `outlineThickness` is in **pixel space** — constant width regardless of zoom.
+ * - All meshes are passed to `addSelection` as a single group, so internal seams
+ *   between panel sub-meshes produce no outline; only the outer contour draws.
+ * - `occlusionStrength = 0` renders the outline at full alpha even where foreground
+ *   objects occlude the panel (x-ray / on-top effect).
+ *
+ * Usage: `apply(true)` shows the outline; `apply(false)` hides it. Dispose when done.
+ */
+export declare function makePanelOutlineController(getMeshes: () => AbstractMesh[], scene: Scene, options?: PanelOutlineOptions): PanelOutlineController;
+export {};
+//# sourceMappingURL=PanelOutlineController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PanelOutlineController.d.ts","sourceRoot":"","sources":["../../../src/Frameworks/Babylon/PanelOutlineController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG9D,KAAK,mBAAmB,GAAG;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,YAAY,EAAE,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,sBAAsB,CAyCxB"}

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;AAIrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwBvD,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"}

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

@@ -1,5 +1,6 @@
 import { HighlightLayer, Node } from "@babylonjs/core";
 import { AppObject, AppObjectView } from "@vived/core";
+import { type PanelOutlineController } from "./PanelOutlineController";
 export declare const pneumaticPanelHitboxMetadata = "panel_hitbox";
 /**
  * Babylon view that owns panel hitbox interaction and visual feedback.
@@ -11,7 +12,7 @@ export declare const pneumaticPanelHitboxMetadata = "panel_hitbox";
  */
 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>, highlightLayer: HighlightLayer, panelOutline: PanelOutlineController): 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,EAIL,cAAc,EAEd,IAAI,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOvD,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,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,EAC9B,YAAY,EAAE,sBAAsB,GACnC,IAAI;IAEP,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,wBAAwB,GAAG,SAAS;CAGpE;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,GACnB,wBAAwB,CAE1B"}

package/dist/PneumaticPanelFacade.d.ts

@@ -0,0 +1,128 @@
+import { AppObjectRepo } from "@vived/core";
+import { type PneumaticPanelHighlightedObject } from "./Domain/Entities/PneumaticPanelEntity";
+import type { PneumaticPanelVM } from "./Domain/PMs/PneumaticPanelPM";
+export declare const PNEUMATIC_PANEL_STATE_VERSION = 1;
+export type PneumaticPanelState = {
+    version: number;
+    exhaustOpen: boolean;
+    isLocked: boolean;
+    showGhostLockHint: boolean;
+    highlightedObject: PneumaticPanelHighlightedObject;
+    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;
+    panelHoverEnter: () => void;
+    panelHoverExit: () => 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;
+    /**
+     * Set which single object should be highlighted in the scene.
+     */
+    setHighlightedObject(obj: PneumaticPanelHighlightedObject): void;
+    /**
+     * Clear all highlights.
+     */
+    clearAllHighlights(): 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":"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"}

package/dist/clipPlaneFragment-BRmzi2tV.js

@@ -0,0 +1,55 @@
+import { S as e } from "./index-CmNnQLDH.js";
+const i = "clipPlaneFragmentDeclaration", d = `#ifdef CLIPPLANE
+varying float fClipDistance;
+#endif
+#ifdef CLIPPLANE2
+varying float fClipDistance2;
+#endif
+#ifdef CLIPPLANE3
+varying float fClipDistance3;
+#endif
+#ifdef CLIPPLANE4
+varying float fClipDistance4;
+#endif
+#ifdef CLIPPLANE5
+varying float fClipDistance5;
+#endif
+#ifdef CLIPPLANE6
+varying float fClipDistance6;
+#endif
+`;
+e.IncludesShadersStore[i] || (e.IncludesShadersStore[i] = d);
+const s = { name: i, shader: d }, f = "clipPlaneFragment", n = `#if defined(CLIPPLANE) || defined(CLIPPLANE2) || defined(CLIPPLANE3) || defined(CLIPPLANE4) || defined(CLIPPLANE5) || defined(CLIPPLANE6)
+if (false) {}
+#endif
+#ifdef CLIPPLANE
+else if (fClipDistance>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE2
+else if (fClipDistance2>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE3
+else if (fClipDistance3>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE4
+else if (fClipDistance4>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE5
+else if (fClipDistance5>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE6
+else if (fClipDistance6>0.0)
+{discard;}
+#endif
+`;
+e.IncludesShadersStore[f] || (e.IncludesShadersStore[f] = n);
+const P = { name: f, shader: n };
+export {
+  s as a,
+  P as c
+};

package/dist/clipPlaneFragment-CDdVuU0n.js

@@ -0,0 +1,55 @@
+import { S as e } from "./index-CmNnQLDH.js";
+const i = "clipPlaneFragmentDeclaration", n = `#ifdef CLIPPLANE
+varying fClipDistance: f32;
+#endif
+#ifdef CLIPPLANE2
+varying fClipDistance2: f32;
+#endif
+#ifdef CLIPPLANE3
+varying fClipDistance3: f32;
+#endif
+#ifdef CLIPPLANE4
+varying fClipDistance4: f32;
+#endif
+#ifdef CLIPPLANE5
+varying fClipDistance5: f32;
+#endif
+#ifdef CLIPPLANE6
+varying fClipDistance6: f32;
+#endif
+`;
+e.IncludesShadersStoreWGSL[i] || (e.IncludesShadersStoreWGSL[i] = n);
+const s = { name: i, shader: n }, f = "clipPlaneFragment", d = `#if defined(CLIPPLANE) || defined(CLIPPLANE2) || defined(CLIPPLANE3) || defined(CLIPPLANE4) || defined(CLIPPLANE5) || defined(CLIPPLANE6)
+if (false) {}
+#endif
+#ifdef CLIPPLANE
+else if (fragmentInputs.fClipDistance>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE2
+else if (fragmentInputs.fClipDistance2>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE3
+else if (fragmentInputs.fClipDistance3>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE4
+else if (fragmentInputs.fClipDistance4>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE5
+else if (fragmentInputs.fClipDistance5>0.0)
+{discard;}
+#endif
+#ifdef CLIPPLANE6
+else if (fragmentInputs.fClipDistance6>0.0)
+{discard;}
+#endif
+`;
+e.IncludesShadersStoreWGSL[f] || (e.IncludesShadersStoreWGSL[f] = d);
+const t = { name: f, shader: d };
+export {
+  t as a,
+  s as c
+};