juxscript 1.0.128 → 1.0.129

package/index.js

@@ -16,7 +16,7 @@ export { List } from './lib/componentsv2/list/List.js';
 export { BaseEngine } from './lib/componentsv2/base/BaseEngine.js';
 export { BaseSkin } from './lib/componentsv2/base/BaseSkin.js';
 export { State } from './lib/componentsv2/base/State.js';
-export { GlobalBus } from './lib/componentsv2/base/GlobalBus.js';
+export { GlobalBus } from './lib/componentsv2/base/Neighborhood.js';
 
 // Utilities
 export { validateOptions } from './lib/componentsv2/base/OptionsContract.js';

package/lib/componentsv2/base/BaseEngine.js

@@ -11,7 +11,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
 };
 var _BaseEngine_state, _BaseEngine_listeners, _BaseEngine_cleanupListeners, _BaseEngine_plugins, _BaseEngine_emitHistory, _BaseEngine_debugMode, _BaseEngine_validationResult;
 import { State } from './State.js';
-import { GlobalBus } from './GlobalBus.js';
+import { Neighborhood } from './Neighborhood.js';
 import { validateOptions } from './OptionsContract.js';
 /**
  * THE ENGINE AGREEMENT
@@ -118,9 +118,9 @@ export class BaseEngine {
      * @param callback Reaction logic
      */
     listenTo(channel, callback) {
-        GlobalBus.on(channel, callback);
+        Neighborhood.on(channel, callback);
         // Track for cleanup
-        __classPrivateFieldGet(this, _BaseEngine_cleanupListeners, "f").push(() => GlobalBus.off(channel, callback));
+        __classPrivateFieldGet(this, _BaseEngine_cleanupListeners, "f").push(() => Neighborhood.off(channel, callback));
         return this;
     }
     /**
@@ -160,7 +160,7 @@ export class BaseEngine {
         // 2. Notify The Neighborhood (Global Bus)
         // Format: "ComponentID:EventName"
         const globalChannel = `${this.state.id}:${event}`;
-        GlobalBus.emit(globalChannel, {
+        Neighborhood.emit(globalChannel, {
             ...data,
             _event: event,
             _source: this.state.id
@@ -171,7 +171,7 @@ export class BaseEngine {
      * Useful for debugging communication topology from the console.
      */
     get eventRegistry() {
-        return GlobalBus.registry;
+        return Neighborhood.registry;
     }
     /**
      * DEBUG: Access the Internal State Ledger (History).

package/lib/componentsv2/base/BaseSkin.d.ts

@@ -11,6 +11,7 @@ import { BaseEngine, BaseState } from './BaseEngine.js';
 export declare abstract class BaseSkin<TState extends BaseState, TEngine extends BaseEngine<TState>> {
     protected engine: TEngine;
     protected root: HTMLElement | null;
+    private _cleanupTasks;
     constructor(engine: TEngine);
     /**
     * CONTRACT: Provide the URL/Path to the structural CSS file.
@@ -29,6 +30,26 @@ export declare abstract class BaseSkin<TState extends BaseState, TEngine extends
      * @param href The URL to the CSS file
      */
     injectCSSLink(id: string, href: string): void;
+    /**
+     * Utility: Subscribe to MY Engine's events.
+     * "Me" refers to this component instance (Engine + Skin).
+     *
+     * Use this for internal signals like "loginSuccess", "error", or "animationStart".
+     */
+    protected listenToMe(event: string, callback: (data: any) => void): void;
+    /**
+     * Utility: Subscribe to the Global Bus (The Neighborhood).
+     * "Neighbors" refers to other components or global system events.
+     *
+     * ⚠️ USE SPARINGLY. Ideally, data flows down from the Engine via State.
+     * Use this for purely visual coordination like "theme:switched" or "layout:collapse-all".
+     */
+    protected listenToNeighbors(channel: string, callback: (data: any) => void): void;
+    /**
+     * Component Teardown.
+     * Removes the root element and cleans up all event listeners.
+     */
+    dispose(): void;
     /**
      * Utility: Inject CSS into the document head if not already present.
      * Useful for Skins to seamlessly load their required aesthetics.

package/lib/componentsv2/base/BaseSkin.js

@@ -1,3 +1,4 @@
+import { Neighborhood } from './Neighborhood.js';
 /**
  * THE SKIN AGREEMENT
  *
@@ -10,6 +11,7 @@
 export class BaseSkin {
     constructor(engine) {
         this.root = null;
+        this._cleanupTasks = [];
         this.engine = engine;
     }
     /**
@@ -32,6 +34,39 @@ export class BaseSkin {
             link.href = href;
         }
     }
+    /**
+     * Utility: Subscribe to MY Engine's events.
+     * "Me" refers to this component instance (Engine + Skin).
+     *
+     * Use this for internal signals like "loginSuccess", "error", or "animationStart".
+     */
+    listenToMe(event, callback) {
+        this.engine.on(event, callback);
+        this._cleanupTasks.push(() => this.engine.off(event, callback));
+    }
+    /**
+     * Utility: Subscribe to the Global Bus (The Neighborhood).
+     * "Neighbors" refers to other components or global system events.
+     *
+     * ⚠️ USE SPARINGLY. Ideally, data flows down from the Engine via State.
+     * Use this for purely visual coordination like "theme:switched" or "layout:collapse-all".
+     */
+    listenToNeighbors(channel, callback) {
+        Neighborhood.on(channel, callback);
+        this._cleanupTasks.push(() => Neighborhood.off(channel, callback));
+    }
+    /**
+     * Component Teardown.
+     * Removes the root element and cleans up all event listeners.
+     */
+    dispose() {
+        this._cleanupTasks.forEach(task => task());
+        this._cleanupTasks = [];
+        if (this.root) {
+            this.root.remove();
+            this.root = null;
+        }
+    }
     /**
      * Utility: Inject CSS into the document head if not already present.
      * Useful for Skins to seamlessly load their required aesthetics.

package/lib/componentsv2/base/Neighborhood.d.ts

@@ -0,0 +1,22 @@
+type GlobalListener = (data: any) => void;
+/**
+ * THE NEIGHBORHOOD (Global Event Mediator)
+ *
+ * Acts as the certal nervous system where all components post updates.
+ * Other components can tune in to specific frequencies (channels) here.
+ */
+export declare class JuxGlobalBus {
+    private listeners;
+    on(channel: string, callback: GlobalListener): void;
+    off(channel: string, callback: GlobalListener): void;
+    emit(channel: string, data: any): void;
+    /**
+     * DEBUG: Read-only Snapshot of active channels and listener identities.
+     * usage: juxV2.events.registry
+     * Returns: { "channelName": ["functionName", "(anonymous)"] }
+     */
+    get registry(): Record<string, string[]>;
+}
+export declare const Neighborhood: JuxGlobalBus;
+export {};
+//# sourceMappingURL=Neighborhood.d.ts.map

package/lib/componentsv2/base/Neighborhood.js

@@ -0,0 +1,56 @@
+/**
+ * THE NEIGHBORHOOD (Global Event Mediator)
+ *
+ * Acts as the certal nervous system where all components post updates.
+ * Other components can tune in to specific frequencies (channels) here.
+ */
+export class JuxGlobalBus {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(channel, callback) {
+        if (!this.listeners.has(channel)) {
+            this.listeners.set(channel, new Set());
+        }
+        this.listeners.get(channel).add(callback);
+    }
+    off(channel, callback) {
+        const set = this.listeners.get(channel);
+        if (set) {
+            set.delete(callback);
+            if (set.size === 0) {
+                this.listeners.delete(channel);
+            }
+        }
+    }
+    emit(channel, data) {
+        const set = this.listeners.get(channel);
+        if (set) {
+            set.forEach(callback => {
+                try {
+                    callback(data);
+                }
+                catch (e) {
+                    console.error(`Jux GlobalBus Error [${channel}]:`, e);
+                }
+            });
+        }
+        // Optional: We could have a wildcard '*' listener here for debuggers/loggers
+    }
+    /**
+     * DEBUG: Read-only Snapshot of active channels and listener identities.
+     * usage: juxV2.events.registry
+     * Returns: { "channelName": ["functionName", "(anonymous)"] }
+     */
+    get registry() {
+        const snapshot = {};
+        this.listeners.forEach((set, channel) => {
+            // Map the Set of functions to their names for easier debugging
+            snapshot[channel] = Array.from(set).map(fn => fn.name || '(anonymous)');
+        });
+        return snapshot;
+    }
+}
+// Singleton Instance
+export const Neighborhood = new JuxGlobalBus();
+//# sourceMappingURL=Neighborhood.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juxscript",
-  "version": "1.0.128",
+  "version": "1.0.129",
   "type": "module",
   "description": "A JavaScript UX authorship platform",
   "main": "./index.js",