@constela/start 0.1.2 → 0.2.0

package/dist/runtime/entry-client.d.ts

@@ -1,8 +1,41 @@
+import { CompiledProgram } from '@constela/compiler';
+import { AppInstance } from '@constela/runtime';
+
 /**
  * Client-side entry point for Constela applications
- * Handles hydration and client-side routing
+ * Handles hydration and Escape Hatch mechanism for external library integration.
+ */
+
+/**
+ * Context provided to EscapeHandler mount functions
+ */
+interface EscapeContext {
+    appInstance: AppInstance;
+    getState: (name: string) => unknown;
+    setState: (name: string, value: unknown) => void;
+    subscribe: (name: string, fn: (value: unknown) => void) => () => void;
+}
+/**
+ * Handler for escape hatch elements
+ */
+interface EscapeHandler {
+    name: string;
+    mount: (element: HTMLElement, ctx: EscapeContext) => () => void;
+}
+/**
+ * Options for initializing the client application
+ */
+interface InitClientOptions {
+    program: CompiledProgram;
+    container: HTMLElement;
+    escapeHandlers?: EscapeHandler[];
+}
+/**
+ * Initialize the client application with hydration and escape hatch support.
+ *
+ * @param options - Configuration options
+ * @returns AppInstance for controlling the application
  */
-declare function hydrate(): void;
-declare function mount(_element: HTMLElement): void;
+declare function initClient(options: InitClientOptions): AppInstance;
 
-export { hydrate, mount };
+export { type EscapeContext, type EscapeHandler, type InitClientOptions, initClient };

package/dist/runtime/entry-client.js

@@ -1,11 +1,58 @@
 // src/runtime/entry-client.ts
-function hydrate() {
-  throw new Error("hydrate is not yet implemented");
-}
-function mount(_element) {
-  throw new Error("mount is not yet implemented");
+import { hydrateApp } from "@constela/runtime";
+function initClient(options) {
+  const { program, container, escapeHandlers = [] } = options;
+  const appInstance = hydrateApp({ program, container });
+  const escapeElements = container.querySelectorAll(
+    "[data-constela-escape]"
+  );
+  const handlerMap = /* @__PURE__ */ new Map();
+  for (const handler of escapeHandlers) {
+    handlerMap.set(handler.name, handler);
+  }
+  const cleanupFns = [];
+  for (const element of escapeElements) {
+    const escapeName = element.getAttribute("data-constela-escape") ?? "";
+    const handler = handlerMap.get(escapeName);
+    if (!handler) {
+      continue;
+    }
+    const escapeContext = {
+      appInstance,
+      getState: (name) => appInstance.getState(name),
+      setState: (name, value) => appInstance.setState(name, value),
+      subscribe: (name, fn) => {
+        if (typeof appInstance.subscribe === "function") {
+          return appInstance.subscribe(name, fn);
+        }
+        return () => {
+        };
+      }
+    };
+    try {
+      const cleanup = handler.mount(element, escapeContext);
+      cleanupFns.push(cleanup);
+    } catch {
+    }
+  }
+  let destroyed = false;
+  return {
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      for (const cleanup of cleanupFns) {
+        cleanup();
+      }
+      appInstance.destroy();
+    },
+    setState(name, value) {
+      appInstance.setState(name, value);
+    },
+    getState(name) {
+      return appInstance.getState(name);
+    }
+  };
 }
 export {
-  hydrate,
-  mount
+  initClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/start",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Meta-framework for Constela applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,10 +34,15 @@
     "vite": "^6.0.0",
     "commander": "^12.0.0",
     "fast-glob": "^3.3.0",
+    "unified": "^11.0.0",
+    "remark-parse": "^11.0.0",
+    "remark-mdx": "^3.0.0",
+    "remark-gfm": "^4.0.0",
+    "gray-matter": "^4.0.0",
+    "@constela/runtime": "0.7.0",
+    "@constela/router": "4.0.0",
     "@constela/compiler": "0.4.0",
-    "@constela/server": "0.1.2",
-    "@constela/router": "3.0.0",
-    "@constela/runtime": "0.6.0"
+    "@constela/server": "0.1.2"
   },
   "devDependencies": {
     "typescript": "^5.3.0",