@hypen-space/core 0.3.12 → 0.4.0

package/src/remote/server.ts

@@ -44,7 +44,7 @@ import type {
   Session,
   SessionConfig,
 } from "./types.js";
-import type { Patch } from "../engine.js";
+import type { Patch } from "../types.js";
 import type { ServerWebSocket } from "bun";
 import { SessionManager } from "./session.js";
 import { frameworkLoggers } from "../logger.js";

package/src/remote/types.ts

@@ -2,7 +2,7 @@
  * Remote UI Protocol Types
  */
 
-import type { Patch } from "../engine.js";
+import type { Patch } from "../types.js";
 
 export type RemoteMessage =
   | InitialTreeMessage

package/src/renderer.ts

@@ -5,7 +5,7 @@
  * (DOM, Canvas, Native, etc.)
  */
 
-import type { Patch } from "./engine.js";
+import type { Patch } from "./types.js";
 import { frameworkLoggers } from "./logger.js";
 
 const log = frameworkLoggers.renderer;

package/src/resolver.ts

@@ -39,6 +39,12 @@ export interface ResolverOptions {
    * Useful for adding authentication, custom headers, etc.
    */
   customFetch?: (url: string) => Promise<string>;
+
+  /**
+   * Module registry for looking up pre-registered module definitions.
+   * When set, the resolver will check the registry before doing file I/O.
+   */
+  moduleRegistry?: { has: (name: string) => boolean; get: (name: string) => any };
 }
 
 /**
@@ -47,22 +53,48 @@ export interface ResolverOptions {
  */
 export class ComponentResolver {
   private cache = new Map<string, ComponentDefinition>();
-  private options: Required<ResolverOptions>;
+  private options: Required<Pick<ResolverOptions, 'baseDir' | 'cache' | 'customFetch'>> & Pick<ResolverOptions, 'moduleRegistry'>;
+
+  private moduleRegistry?: { has: (name: string) => boolean; get: (name: string) => any };
 
   constructor(options: ResolverOptions = {}) {
     this.options = {
       baseDir: options.baseDir || process.cwd(),
       cache: options.cache ?? true,
       customFetch: options.customFetch || this.defaultFetch.bind(this),
+      moduleRegistry: options.moduleRegistry,
     };
+    this.moduleRegistry = options.moduleRegistry;
   }
 
   /**
-   * Resolve a component from an import statement
+   * Resolve a component from an import statement.
+   * Checks the module registry first (if available), then falls back to file I/O.
    */
   async resolve(
     importStmt: ImportStatement
   ): Promise<Record<string, ComponentDefinition>> {
+    // Check module registry first — if a component is pre-registered,
+    // use its template directly (it will be mounted as a full module)
+    if (this.moduleRegistry) {
+      const names = importStmt.clause.type === "named"
+        ? importStmt.clause.names
+        : [importStmt.clause.name];
+
+      const allFound = names.every(name => this.moduleRegistry!.has(name));
+      if (allFound) {
+        const result: Record<string, ComponentDefinition> = {};
+        for (const name of names) {
+          const def = this.moduleRegistry!.get(name);
+          result[name] = {
+            module: def,
+            template: def?.template || "",
+          };
+        }
+        return result;
+      }
+    }
+
     const sourcePath = this.getSourcePath(importStmt.source);
 
     // Check cache first
@@ -91,13 +123,28 @@ export class ComponentResolver {
    * Resolve a component from a local file path
    */
   private async resolveLocal(path: string): Promise<ComponentDefinition> {
-    // For local paths, we expect the build system to have already
-    // processed them into the generated components file
-    // This is a fallback for dynamic resolution
-    throw new Error(
-      `Dynamic local component resolution not yet implemented: ${path}\n` +
-        `Please use the build-components.ts script to generate component imports.`
-    );
+    const { resolve, join } = await import("path");
+    const { readFile } = await import("fs/promises");
+
+    const basePath = resolve(this.options.baseDir, path);
+
+    // Try .hypen extension
+    const hypenPath = basePath.endsWith(".hypen")
+      ? basePath
+      : `${basePath}.hypen`;
+
+    const template = await readFile(hypenPath, "utf-8");
+
+    // Try loading sibling .ts module (stateless components have no module)
+    const modulePath = hypenPath.replace(/\.hypen$/, ".ts");
+    let module = {};
+    try {
+      module = await import(modulePath);
+    } catch {
+      // Stateless component — no module file
+    }
+
+    return { module, template };
   }
 
   /**

package/src/types.ts

@@ -0,0 +1,38 @@
+/**
+ * Core types shared across the engine and runtime.
+ *
+ * These types are intentionally decoupled from the WASM engine so that
+ * packages can import them without pulling in any WASM code.
+ */
+
+export type Patch = {
+  type: "create" | "setProp" | "setText" | "insert" | "move" | "remove" | "attachEvent" | "detachEvent";
+  id?: string;
+  elementType?: string;
+  props?: Record<string, any>;
+  name?: string;
+  value?: any;
+  text?: string;
+  parentId?: string;
+  beforeId?: string;
+  eventName?: string;
+};
+
+export type Action = {
+  name: string;
+  payload?: any;
+  sender?: string;
+};
+
+export type RenderCallback = (patches: Patch[]) => void;
+export type ActionHandler = (action: Action) => void | Promise<void>;
+
+export type ResolvedComponent = {
+  source: string;
+  path: string;
+};
+
+export type ComponentResolver = (
+  componentName: string,
+  contextPath: string | null
+) => ResolvedComponent | null;

package/wasm-browser/README.md

@@ -583,6 +583,12 @@ pub use state::StateChange;
 
 ## Related Documentation
 
+- [Documentation Index](./docs/README.md) - Full documentation index
+- [Control Flow Components](./docs/control-flow.md) - ForEach, When/If, Map usage guide
+- [Router](./docs/router.md) - Declarative routing and navigation
+- [Architecture Internals](./docs/architecture.md) - Reactive system, reconciliation, IR
+- [Advanced SDK Usage](./docs/advanced-sdk-usage.md) - Custom renderers, component resolvers, Remote UI
+- [Glossary](./docs/glossary.md) - Key terms and binding syntax reference
+- [Browser Compatibility](./docs/browser-compatibility.md) - Browser, platform, and WASM target support
 - [BUILD_WASM.md](./BUILD_WASM.md) - Detailed WASM build instructions
 - [../parser/README.md](../parser/README.md) - Hypen parser documentation
-- [../hypen-render-bun/README.md](../hypen-render-bun/README.md) - Bun renderer implementation

package/wasm-browser/hypen_engine.d.ts

@@ -22,6 +22,7 @@ export class WasmEngine {
   constructor();
   /**
    * Parse and render Hypen DSL source code
+   * Supports documents with import statements - imports are resolved via the component resolver
    */
   renderSource(source: string): void;
   /**

package/wasm-browser/hypen_engine.js

@@ -282,6 +282,7 @@ export class WasmEngine {
     }
     /**
      * Parse and render Hypen DSL source code
+     * Supports documents with import statements - imports are resolved via the component resolver
      * @param {string} source
      */
     renderSource(source) {

package/wasm-browser/package.json

@@ -5,7 +5,7 @@
     "Hypen Contributors"
   ],
   "description": "A Rust implementation of the Hypen engine",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/wasm-node/README.md

@@ -583,6 +583,12 @@ pub use state::StateChange;
 
 ## Related Documentation
 
+- [Documentation Index](./docs/README.md) - Full documentation index
+- [Control Flow Components](./docs/control-flow.md) - ForEach, When/If, Map usage guide
+- [Router](./docs/router.md) - Declarative routing and navigation
+- [Architecture Internals](./docs/architecture.md) - Reactive system, reconciliation, IR
+- [Advanced SDK Usage](./docs/advanced-sdk-usage.md) - Custom renderers, component resolvers, Remote UI
+- [Glossary](./docs/glossary.md) - Key terms and binding syntax reference
+- [Browser Compatibility](./docs/browser-compatibility.md) - Browser, platform, and WASM target support
 - [BUILD_WASM.md](./BUILD_WASM.md) - Detailed WASM build instructions
 - [../parser/README.md](../parser/README.md) - Hypen parser documentation
-- [../hypen-render-bun/README.md](../hypen-render-bun/README.md) - Bun renderer implementation

package/wasm-node/hypen_engine.d.ts

@@ -22,6 +22,7 @@ export class WasmEngine {
   constructor();
   /**
    * Parse and render Hypen DSL source code
+   * Supports documents with import statements - imports are resolved via the component resolver
    */
   renderSource(source: string): void;
   /**

package/wasm-node/hypen_engine.js

@@ -276,6 +276,7 @@ class WasmEngine {
     }
     /**
      * Parse and render Hypen DSL source code
+     * Supports documents with import statements - imports are resolved via the component resolver
      * @param {string} source
      */
     renderSource(source) {

package/wasm-node/package.json

@@ -4,7 +4,7 @@
     "Hypen Contributors"
   ],
   "description": "A Rust implementation of the Hypen engine",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",