@hypen-space/core 0.4.3 → 0.4.11

package/dist/index.js

@@ -275,144 +275,6 @@ var init_state = __esm(() => {
   RAW_TARGET = Symbol.for("hypen.rawTarget");
 });
 
-// src/result.ts
-function Ok(value) {
-  return { ok: true, value };
-}
-function Err(error) {
-  return { ok: false, error };
-}
-function isOk(result) {
-  return result.ok;
-}
-function isErr(result) {
-  return !result.ok;
-}
-async function fromPromise(promise, mapError) {
-  try {
-    const value = await promise;
-    return Ok(value);
-  } catch (e) {
-    if (mapError) {
-      return Err(mapError(e));
-    }
-    return Err(e);
-  }
-}
-function fromTry(fn, mapError) {
-  try {
-    return Ok(fn());
-  } catch (e) {
-    if (mapError) {
-      return Err(mapError(e));
-    }
-    return Err(e);
-  }
-}
-function map(result, fn) {
-  if (result.ok) {
-    return Ok(fn(result.value));
-  }
-  return result;
-}
-function mapErr(result, fn) {
-  if (!result.ok) {
-    return Err(fn(result.error));
-  }
-  return result;
-}
-function flatMap(result, fn) {
-  if (result.ok) {
-    return fn(result.value);
-  }
-  return result;
-}
-function unwrap(result) {
-  if (result.ok) {
-    return result.value;
-  }
-  throw result.error;
-}
-function unwrapOr(result, defaultValue) {
-  if (result.ok) {
-    return result.value;
-  }
-  return defaultValue;
-}
-function unwrapOrElse(result, fn) {
-  if (result.ok) {
-    return result.value;
-  }
-  return fn(result.error);
-}
-function match(result, handlers) {
-  if (result.ok) {
-    return handlers.ok(result.value);
-  }
-  return handlers.err(result.error);
-}
-function all(results) {
-  const values = [];
-  for (const result of results) {
-    if (!result.ok) {
-      return result;
-    }
-    values.push(result.value);
-  }
-  return Ok(values);
-}
-var HypenError, ActionError, ConnectionError, StateError;
-var init_result = __esm(() => {
-  HypenError = class HypenError extends Error {
-    code;
-    context;
-    cause;
-    constructor(code, message, options) {
-      super(message);
-      this.name = "HypenError";
-      this.code = code;
-      this.context = options?.context;
-      this.cause = options?.cause;
-      Object.setPrototypeOf(this, new.target.prototype);
-    }
-  };
-  ActionError = class ActionError extends HypenError {
-    actionName;
-    constructor(actionName, cause) {
-      super("ACTION_ERROR", `Action handler "${actionName}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
-        context: { actionName },
-        cause: cause instanceof Error ? cause : undefined
-      });
-      this.name = "ActionError";
-      this.actionName = actionName;
-    }
-  };
-  ConnectionError = class ConnectionError extends HypenError {
-    url;
-    attempt;
-    constructor(url, cause, attempt) {
-      super("CONNECTION_ERROR", `Connection to "${url}" failed${attempt ? ` (attempt ${attempt})` : ""}: ${cause instanceof Error ? cause.message : String(cause)}`, {
-        context: { url, attempt },
-        cause: cause instanceof Error ? cause : undefined
-      });
-      this.name = "ConnectionError";
-      this.url = url;
-      this.attempt = attempt;
-    }
-  };
-  StateError = class StateError extends HypenError {
-    path;
-    constructor(message, path, cause) {
-      super("STATE_ERROR", message, {
-        context: { path },
-        cause: cause instanceof Error ? cause : undefined
-      });
-      this.name = "StateError";
-      this.path = path;
-    }
-  };
-});
-
 // src/logger.ts
 function isProduction() {
   if (typeof process !== "undefined" && process.env) {
@@ -612,6 +474,176 @@ var init_logger = __esm(() => {
   };
 });
 
+// src/result.ts
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+async function fromPromise(promise, mapError) {
+  try {
+    const value = await promise;
+    return Ok(value);
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function fromTry(fn, mapError) {
+  try {
+    return Ok(fn());
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function map(result, fn) {
+  if (result.ok) {
+    return Ok(fn(result.value));
+  }
+  return result;
+}
+function mapErr(result, fn) {
+  if (!result.ok) {
+    return Err(fn(result.error));
+  }
+  return result;
+}
+function flatMap(result, fn) {
+  if (result.ok) {
+    return fn(result.value);
+  }
+  return result;
+}
+function unwrap(result) {
+  if (result.ok) {
+    return result.value;
+  }
+  throw result.error;
+}
+function unwrapOr(result, defaultValue) {
+  if (result.ok) {
+    return result.value;
+  }
+  return defaultValue;
+}
+function unwrapOrElse(result, fn) {
+  if (result.ok) {
+    return result.value;
+  }
+  return fn(result.error);
+}
+function match(result, handlers) {
+  if (result.ok) {
+    return handlers.ok(result.value);
+  }
+  return handlers.err(result.error);
+}
+function all(results) {
+  const values = [];
+  for (const result of results) {
+    if (!result.ok) {
+      return result;
+    }
+    values.push(result.value);
+  }
+  return Ok(values);
+}
+function classifyEngineError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.startsWith("Parse error:")) {
+    return new ParseError(message);
+  }
+  if (message.startsWith("Invalid state:") || message.startsWith("Invalid state patch:")) {
+    return new StateError(message);
+  }
+  if (message.startsWith("Parent node not found:")) {
+    return new RenderError(message);
+  }
+  return new RenderError(message);
+}
+var HypenError, ActionError, ConnectionError, StateError, ParseError, RenderError;
+var init_result = __esm(() => {
+  HypenError = class HypenError extends Error {
+    code;
+    context;
+    cause;
+    constructor(code, message, options) {
+      super(message);
+      this.name = "HypenError";
+      this.code = code;
+      this.context = options?.context;
+      this.cause = options?.cause;
+      Object.setPrototypeOf(this, new.target.prototype);
+    }
+  };
+  ActionError = class ActionError extends HypenError {
+    actionName;
+    constructor(actionName, cause) {
+      super("ACTION_ERROR", `Action handler "${actionName}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
+        context: { actionName },
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "ActionError";
+      this.actionName = actionName;
+    }
+  };
+  ConnectionError = class ConnectionError extends HypenError {
+    url;
+    attempt;
+    constructor(url, cause, attempt) {
+      super("CONNECTION_ERROR", `Connection to "${url}" failed${attempt ? ` (attempt ${attempt})` : ""}: ${cause instanceof Error ? cause.message : String(cause)}`, {
+        context: { url, attempt },
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "ConnectionError";
+      this.url = url;
+      this.attempt = attempt;
+    }
+  };
+  StateError = class StateError extends HypenError {
+    path;
+    constructor(message, path, cause) {
+      super("STATE_ERROR", message, {
+        context: { path },
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "StateError";
+      this.path = path;
+    }
+  };
+  ParseError = class ParseError extends HypenError {
+    source;
+    constructor(message, source, cause) {
+      super("PARSE_ERROR", message, {
+        context: { source },
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "ParseError";
+      this.source = source;
+    }
+  };
+  RenderError = class RenderError extends HypenError {
+    constructor(message, cause) {
+      super("RENDER_ERROR", message, {
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "RenderError";
+    }
+  };
+});
+
 // src/app.ts
 var exports_app = {};
 __export(exports_app, {
@@ -632,9 +664,11 @@ class HypenAppBuilder {
   expireHandler;
   errorHandler;
   template;
-  constructor(initialState, options) {
+  _registry;
+  constructor(initialState, options, registry) {
     this.initialState = initialState;
     this.options = options || {};
+    this._registry = registry;
   }
   onCreated(fn) {
     this.createdHandler = fn;
@@ -670,7 +704,7 @@ class HypenAppBuilder {
   }
   build() {
     const stateKeys = this.initialState !== null && typeof this.initialState === "object" ? Object.keys(this.initialState) : [];
-    return {
+    const definition = {
       name: this.options.name,
       actions: Array.from(this.actionHandlers.keys()),
       stateKeys,
@@ -688,12 +722,46 @@ class HypenAppBuilder {
         onError: this.errorHandler
       }
     };
+    if (this.options.name && this._registry) {
+      this._registry.set(this.options.name, definition);
+    }
+    return definition;
   }
 }
 
 class HypenApp {
+  _registry = new Map;
   defineState(initial, options) {
-    return new HypenAppBuilder(initial, options);
+    return new HypenAppBuilder(initial, options, this._registry);
+  }
+  module(name) {
+    const registry = this._registry;
+    return {
+      defineState: (initial, options) => {
+        return new HypenAppBuilder(initial, { ...options, name }, registry);
+      }
+    };
+  }
+  get(name) {
+    return this._registry.get(name);
+  }
+  has(name) {
+    return this._registry.has(name);
+  }
+  get components() {
+    return this._registry;
+  }
+  getNames() {
+    return Array.from(this._registry.keys());
+  }
+  get size() {
+    return this._registry.size;
+  }
+  unregister(name) {
+    this._registry.delete(name);
+  }
+  clear() {
+    this._registry.clear();
   }
 }
 
@@ -702,13 +770,13 @@ class HypenModuleInstance {
   definition;
   state;
   isDestroyed = false;
-  routerContext;
+  router;
   globalContext;
   stateChangeCallbacks = [];
-  constructor(engine, definition, routerContext, globalContext) {
+  constructor(engine, definition, router, globalContext) {
     this.engine = engine;
     this.definition = definition;
-    this.routerContext = routerContext;
+    this.router = router ?? null;
     this.globalContext = globalContext;
     const statePrefix = (definition.name || "").toLowerCase();
     this.state = createObservableState(definition.initialState, {
@@ -730,14 +798,10 @@ class HypenModuleInstance {
           payload: action.payload,
           sender: action.sender
         };
-        const next = {
-          router: this.routerContext?.root || null
-        };
         const context = this.globalContext ? this.createGlobalContextAPI() : undefined;
         const result = await this.executeAction(actionName, handler, {
           action: actionCtx,
           state: this.state,
-          next,
           context
         });
         if (!result.ok) {
@@ -750,6 +814,21 @@ class HypenModuleInstance {
         }
       });
     }
+    this.engine.onAction("__hypen_bind", (action) => {
+      const payload = action.payload;
+      if (!payload?.path)
+        return;
+      const segments = payload.path.split(".");
+      let target = this.state;
+      for (let i = 0;i < segments.length - 1; i++) {
+        const seg = segments[i];
+        target = target?.[seg];
+        if (target == null)
+          return;
+      }
+      const lastSeg = segments[segments.length - 1];
+      target[lastSeg] = payload.value;
+    });
     this.callCreatedHandler();
   }
   createGlobalContextAPI() {
@@ -763,11 +842,9 @@ class HypenModuleInstance {
       getModuleIds: () => ctx.getModuleIds(),
       getGlobalState: () => ctx.getGlobalState(),
       emit: (event, payload) => ctx.emit(event, payload),
-      on: (event, handler) => ctx.on(event, handler)
+      on: (event, handler) => ctx.on(event, handler),
+      router: this.router
     };
-    if (ctx.__router) {
-      api.__router = ctx.__router;
-    }
     if (ctx.__hypenEngine) {
       api.__hypenEngine = ctx.__hypenEngine;
     }
@@ -818,7 +895,15 @@ class HypenModuleInstance {
   async callCreatedHandler() {
     if (this.definition.handlers.onCreated) {
       const context = this.globalContext ? this.createGlobalContextAPI() : undefined;
-      await this.definition.handlers.onCreated(this.state, context);
+      try {
+        await this.definition.handlers.onCreated(this.state, context);
+      } catch (e) {
+        const error = e instanceof HypenError ? e : new ActionError("onCreated", e);
+        const shouldRethrow = await this.handleError(error, { lifecycle: "created" });
+        if (shouldRethrow) {
+          throw error;
+        }
+      }
     }
   }
   onStateChange(callback) {
@@ -828,7 +913,15 @@ class HypenModuleInstance {
     if (this.isDestroyed)
       return;
     if (this.definition.handlers.onDestroyed) {
-      await this.definition.handlers.onDestroyed(this.state);
+      try {
+        await this.definition.handlers.onDestroyed(this.state);
+      } catch (e) {
+        const error = e instanceof HypenError ? e : new ActionError("onDestroyed", e);
+        const shouldRethrow = await this.handleError(error, { lifecycle: "destroyed" });
+        if (shouldRethrow) {
+          throw error;
+        }
+      }
     }
     this.isDestroyed = true;
   }
@@ -1934,7 +2027,7 @@ var Router = app.defineState({
     log9.error("Requires global context");
     return;
   }
-  const router = context.__router;
+  const router = context.router;
   if (!router) {
     log9.error("Router not found in context");
     return;
@@ -1981,7 +2074,7 @@ var Link = app.defineState({
   to: "/",
   isActive: false
 }, { name: "__Link" }).onAction("navigate", ({ state, context }) => {
-  const router = context?.__router;
+  const router = context?.router;
   if (!router) {
     log9.error("Link requires router context");
     return;
@@ -1991,7 +2084,7 @@ var Link = app.defineState({
 }).onCreated((state, context) => {
   if (!context)
     return;
-  const router = context.__router;
+  const router = context.router;
   if (router) {
     router.onNavigate((routeState) => {
       state.isActive = routeState.currentPath === state.to;
@@ -2228,6 +2321,7 @@ export {
   createEventEmitter,
   configureLogger,
   compositeDisposable,
+  classifyEngineError,
   batchStateUpdates,
   app,
   all,
@@ -2238,7 +2332,9 @@ export {
   Route,
   RetryPresets,
   RetryConditions,
+  RenderError,
   RemoteEngine,
+  ParseError,
   Ok,
   Logger,
   Link,
@@ -2258,4 +2354,4 @@ export {
   ActionError
 };
 
-//# debugId=27843E67245517FE64756E2164756E21
+//# debugId=6B890301380275E464756E2164756E21