@igojs/signal 6.0.0-beta.1 → 6.0.0-beta.11

package/index.js

@@ -1,24 +1,14 @@
 // @igojs/signal - Reactive frontend/SSR framework for Igo.js
 
 // Server-side exports
-const server = require('./src/server');
+const server = require('./src/server/index.js');
+const SignalComponent = require('./src/client/SignalComponent.js');
 
 // Re-export server utilities
 module.exports = {
-  // Server middleware for SSR
   middleware: server.middleware,
-
-  // Template serving endpoint
   templates: server.templates,
-
-  // Configure signal (translations, etc.)
   configure: server.configure,
-
-  // Serialization for client hydration
   serialize: server.serialize,
-
-  // SignalComponent for SSR rendering
-  get SignalComponent() {
-    return require('./src/client/SignalComponent');
-  },
+  SignalComponent,
 };

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@igojs/signal",
-  "version": "6.0.0-beta.1",
+  "version": "6.0.0-beta.11",
   "description": "Signal - Reactive frontend/SSR framework for Igo.js",
   "main": "index.js",
-  "browser": "src/client/index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./src/client/index.js"
+  },
   "scripts": {
     "test": "mocha --exit 'test/**/*.js'"
   },
@@ -16,15 +19,21 @@
   ],
   "author": "@igocreate",
   "license": "ISC",
+  "homepage": "https://github.com/igocreate/igo",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/igocreate/igo.git"
+  },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@igojs/server": "*",
-    "@igojs/dust": "*",
-    "devalue": "^5.6.1",
+    "devalue": "^5.6.2",
     "diff-dom": "^5.2.1",
-    "i18next": "^25.7.3",
-    "lodash": "^4.17.21"
+    "lodash": "^4.17.23"
+  },
+  "peerDependencies": {
+    "@igojs/dust": "^6.0.0-beta.3",
+    "i18next": "^25.0.0"
   }
 }

package/src/client/EventBinder.js

@@ -75,14 +75,12 @@ class EventBinder {
         const existingHandler = eventMap.get(eventType);
 
         if (existingHandler) {
-          // ✅ Element preserved by DiffDOM → reuse existing listener
           newListeners.push({
             element: targetElement,
             eventType,
             handler: existingHandler
           });
         } else {
-          // ✅ New element or new eventType → create new listener
           const boundHandler = handler.bind(context);
           targetElement.addEventListener(eventType, boundHandler);
           eventMap.set(eventType, boundHandler);
@@ -105,7 +103,6 @@ class EventBinder {
     this._boundListeners.forEach(({ element, eventType, handler }) => {
       const processedEvents = processedElements.get(element);
       if (!processedEvents || !processedEvents.has(eventType)) {
-        // Element was removed or event type changed → cleanup
         element?.removeEventListener(eventType, handler);
         const eventMap = this._elementListeners.get(element);
         if (eventMap) {
@@ -128,7 +125,6 @@ class EventBinder {
       element?.removeEventListener(eventType, handler);
     });
     this._boundListeners = [];
-    // Note: WeakMap clears itself automatically when elements are garbage collected
   }
 }
 

package/src/client/SignalComponent.js

@@ -1,26 +1,16 @@
 // Isomorphic imports (safe for Node.js)
-const DerivedCache  = require('./DerivedCache');
-const StateProxy    = require('./StateProxy');
+const DerivedCache = require('./DerivedCache.js');
+const StateProxy = require('./StateProxy.js');
 
-// Browser-only imports are loaded lazily in constructor
+// Browser-only imports (top-level, but only used in browser methods)
+const { DiffDOM } = require('diff-dom');
+const EventBinder = require('./EventBinder.js');
+const Templates = require('./dust/Templates.js');
+const FormHandler = require('./FormHandler.js');
 
 // Detect server-side rendering
 const isServer = typeof window === 'undefined';
 
-// Browser-only dependencies (lazy loaded once)
-let _browserDeps = null;
-const getBrowserDeps = () => {
-  if (!_browserDeps) {
-    _browserDeps = {
-      DiffDOM: require('diff-dom').DiffDOM,
-      EventBinder: require('./EventBinder'),
-      Templates: require('./dust/Templates'),
-      FormHandler: require('./FormHandler'),
-    };
-  }
-  return _browserDeps;
-};
-
 class Igo2Component {
   // Component registry for auto-discovery
   static _registry = {};
@@ -77,16 +67,14 @@ class Igo2Component {
 
     // Browser-only setup
     if (!isServer) {
-      const deps = getBrowserDeps();
-
       this.element = element;
       this.element.__igoInstance  = this;
       this._dustTemplateFn        = null;
-      this._eventBinder           = new deps.EventBinder();
+      this._eventBinder           = new EventBinder();
       this._derivedCache          = new DerivedCache();
       this._isInitialized         = false;
       this._renderFrame           = null;
-      this._diffDom               = new deps.DiffDOM();
+      this._diffDom               = new DiffDOM();
     }
 
     // Default events array (only if not defined as getter in subclass)
@@ -230,13 +218,12 @@ class Igo2Component {
   // Initialize component (called automatically by constructor)
   // Can be overridden in subclasses for custom initialization
   async init() {
-    const deps = getBrowserDeps();
-    this._dustTemplateFn = await deps.Templates.loadTemplate(this.template);
+    this._dustTemplateFn = await Templates.loadTemplate(this.template);
     this._isInitialized = true;
 
     // Initialize form handler if props.form exists
     if (this.props.form) {
-      this._formHandler = new deps.FormHandler(this, this.props.form);
+      this._formHandler = new FormHandler(this, this.props.form);
     }
 
     await this.render();
@@ -406,4 +393,4 @@ class Igo2Component {
 
 }
 
-module.exports = Igo2Component;
+module.exports = Igo2Component;

package/src/client/dust/Templates.js

@@ -19,8 +19,4 @@ const loadTemplate = async (file) => {
   return _CACHE[file];
 };
 
-module.exports = {
-  getTemplate,
-  loadTemplate,
-  _CACHE
-};
+module.exports = { getTemplate, loadTemplate, _CACHE };

package/src/client/dust/Utils.js

@@ -1,7 +1,7 @@
-const Templates        = require('./Templates');
-const { uneval }       = require('devalue'); // Bundler handles ES modules correctly
-const igoDustHelpers   = require('@igojs/dust/src/render/Helpers');
-const { createSerializeHelper, htmlencode } = require('../../shared/serialize');
+const Templates = require('./Templates.js');
+const { uneval } = require('devalue');
+const igoDustHelpers = require('@igojs/dust/src/render/Helpers');
+const { createSerializeHelper, htmlencode } = require('../../shared/serialize.js');
 
 // Special characters
 const BS      = /\\/g,

package/src/client/dust/i18n.js

@@ -19,4 +19,3 @@ i18next.init({
 
 // Expose globally for use in components
 window.i18next = i18next;
-

package/src/client/index.js

@@ -2,16 +2,17 @@
  * Signal - Zero-boilerplate reactive framework (browser entry point)
  *
  * Usage:
- *   require('@igojs/signal/src/client').start({
+ *   const { start } = require('@igojs/signal/src/client');
+ *   start({
  *     components: { 'Counter': Counter },
- *     helpers: require('./helpers')
+ *     helpers: helpers
  *   });
  */
 
-require('./dust/i18n');
+require('./dust/i18n.js');
 
-const SignalComponent = require('./SignalComponent');
-const Utils = require('./dust/Utils');
+const SignalComponent = require('./SignalComponent.js');
+const Utils = require('./dust/Utils.js');
 
 window.__signal = {
   IgoDustUtils: Utils

package/src/server/SerializeUtils.js

@@ -1,5 +1,6 @@
 
 const _ = require('lodash');
+const { isFunction, isDate, isArray, map, isPlainObject, isObject } = _;
 
 /**
  * Serialize data for client-side hydration
@@ -15,23 +16,23 @@ const _ = require('lodash');
  * @param {WeakMap} [seen] - Internal map for tracking already-serialized objects
  * @returns {any} - Serialized data ready for devalue
  */
-module.exports.serialize = (data, seen = new WeakMap()) => {
+const serialize = (data, seen = new WeakMap()) => {
   if (data === null || data === undefined) {
     return null;
   }
   // Skip functions
-  if (_.isFunction(data)) {
+  if (isFunction(data)) {
     return undefined;
   }
   // Keep Date objects as-is (devalue handles them natively)
-  if (_.isDate(data)) {
+  if (isDate(data)) {
     return data;
   }
-  if (_.isArray(data)) {
-    return _.map(data, item => module.exports.serialize(item, seen));
+  if (isArray(data)) {
+    return map(data, item => serialize(item, seen));
   }
   // Model instances with serialize method
-  if (_.isFunction(data?.serialize)) {
+  if (isFunction(data?.serialize)) {
     // Check if already serialized (deduplication)
     if (seen.has(data)) {
       return seen.get(data);
@@ -41,15 +42,15 @@ module.exports.serialize = (data, seen = new WeakMap()) => {
     seen.set(data, serialized);
     // Serialize and merge into placeholder
     const result = data.serialize();
-    Object.assign(serialized, module.exports.serialize(result, seen));
+    Object.assign(serialized, serialize(result, seen));
     return serialized;
   }
   // Form instances with getValues method (Igo Form)
-  if (_.isFunction(data?.getValues) && data.constructor?.schema?.attributes) {
-    return module.exports.serialize(data.getValues(), seen);
+  if (isFunction(data?.getValues) && data.constructor?.schema?.attributes) {
+    return serialize(data.getValues(), seen);
   }
   // Plain objects only - recursively serialize values
-  if (_.isPlainObject(data)) {
+  if (isPlainObject(data)) {
     // Check if already processed (for circular plain objects)
     if (seen.has(data)) {
       return seen.get(data);
@@ -57,14 +58,16 @@ module.exports.serialize = (data, seen = new WeakMap()) => {
     const serialized = {};
     seen.set(data, serialized);
     for (const [key, value] of Object.entries(data)) {
-      serialized[key] = module.exports.serialize(value, seen);
+      serialized[key] = serialize(value, seen);
     }
     return serialized;
   }
   // Primitives (string, number, boolean)
-  if (!_.isObject(data)) {
+  if (!isObject(data)) {
     return data;
   }
   // Skip non-POJO class instances that we don't know how to serialize
   return undefined;
 };
+
+module.exports = { serialize };

package/src/server/SignalController.js

@@ -1,25 +1,19 @@
 
-const { dust: IgoDust } = require('@igojs/server');
+const IgoDust = require('@igojs/dust');
 
-const SerializeUtils  = require('./SerializeUtils');
-const { createSerializeHelper } = require('../shared/serialize');
-
-// Load devalue dynamically (ES module)
-let uneval;
-let helperRegistered = false;
-const devaluePromise = import('devalue').then(mod => {
-  uneval = mod.uneval;
-});
+const SerializeUtils = require('./SerializeUtils.js');
+const { createSerializeHelper } = require('../shared/serialize.js');
 
 // Translations are loaded from user's project (configured via signal.configure())
 let translations = {};
 
-// Register @serialize helper (called once after devalue is loaded)
-const registerHelper = () => {
-  if (helperRegistered) return;
-  helperRegistered = true;
+// devalue is ESM-only, load it dynamically at startup
+let uneval;
+const devalueReady = import('devalue').then(m => {
+  uneval = m.uneval;
+  // Register @serialize helper once devalue is loaded
   IgoDust.helpers.serialize = createSerializeHelper(uneval);
-};
+});
 
 
 /**
@@ -35,11 +29,10 @@ const registerHelper = () => {
  * 2. Compute SSR derived values from registered signal_components
  * 3. Merge everything into res.locals for template rendering
  */
-module.exports.middleware = async (req, res, next) => {
+const middleware = async (req, res, next) => {
 
-  // Wait for devalue to be loaded, then register helper
-  await devaluePromise;
-  registerHelper();
+  // Ensure devalue is loaded
+  await devalueReady;
 
   // Inject translations for frontend i18next
   res.locals.__signal_translations = uneval(translations);
@@ -80,15 +73,17 @@ module.exports.middleware = async (req, res, next) => {
 };
 
 //
-module.exports.templates = async (req, res) => {
+const templates = async (req, res) => {
   const file = req.query.file;
   const source = await IgoDust.getSource(`${file}.dust`);
   res.json({ file, source });
 };
 
 // Configure Signal (called from user's app)
-module.exports.configure = (options) => {
+const configure = (options) => {
   if (options.translations) {
     translations = options.translations;
   }
 };
+
+module.exports = { middleware, templates, configure };

package/src/server/index.js

@@ -6,8 +6,8 @@
  * - SerializeUtils: Model serialization with deduplication
  */
 
-const SignalController = require('./SignalController');
-const SerializeUtils = require('./SerializeUtils');
+const SignalController = require('./SignalController.js');
+const SerializeUtils = require('./SerializeUtils.js');
 
 module.exports = {
   middleware: SignalController.middleware,

package/test/client/DerivedCacheTest.js

@@ -1,5 +1,5 @@
 const assert = require('assert');
-const DerivedCache = require('../../src/client/DerivedCache');
+const DerivedCache = require('../../src/client/DerivedCache.js');
 
 describe('DerivedCache', () => {
 

package/test/client/SignalComponentTest.js

@@ -1,5 +1,5 @@
 const assert = require('assert');
-const SignalComponent = require('../../src/client/SignalComponent');
+const SignalComponent = require('../../src/client/SignalComponent.js');
 
 describe('SignalComponent', () => {
 

package/test/client/StateProxyTest.js

@@ -1,5 +1,5 @@
 const assert = require('assert');
-const StateProxy = require('../../src/client/StateProxy');
+const StateProxy = require('../../src/client/StateProxy.js');
 
 describe('StateProxy', () => {
 

package/test/server/SerializeUtilsTest.js

@@ -1,5 +1,5 @@
 const assert = require('assert');
-const SerializeUtils = require('../../src/server/SerializeUtils');
+const SerializeUtils = require('../../src/server/SerializeUtils.js');
 
 describe('SerializeUtils', () => {