@constela/runtime 0.9.2 → 0.10.1

package/dist/index.d.ts

@@ -79,6 +79,12 @@ interface ActionContext {
     eventPayload?: unknown;
     refs?: Record<string, Element>;
     subscriptions?: (() => void)[];
+    route?: {
+        params: Record<string, string>;
+        query: Record<string, string>;
+        path: string;
+    };
+    imports?: Record<string, unknown>;
 }
 declare function executeAction(action: CompiledAction, ctx: ActionContext): Promise<void>;
 
@@ -96,7 +102,9 @@ interface RenderContext {
     state: StateStore;
     actions: Record<string, CompiledAction>;
     locals: Record<string, unknown>;
+    imports?: Record<string, unknown>;
     cleanups?: (() => void)[];
+    refs?: Record<string, Element>;
 }
 declare function render(node: CompiledNode, ctx: RenderContext): Node;
 
@@ -110,7 +118,22 @@ interface AppInstance {
     destroy(): void;
     setState(name: string, value: unknown): void;
     getState(name: string): unknown;
+    subscribe(name: string, fn: (value: unknown) => void): () => void;
 }
+/**
+ * Creates a Constela application and mounts it to the DOM.
+ *
+ * Lifecycle order:
+ * 1. State initialization
+ * 2. Refs map creation
+ * 3. View rendering (refs populated during render)
+ * 4. onMount execution (refs guaranteed to be available)
+ * 5. App instance returned
+ *
+ * @param program - The compiled program to execute
+ * @param mount - The DOM element to mount the app to
+ * @returns An AppInstance with destroy, setState, and getState methods
+ */
 declare function createApp(program: CompiledProgram, mount: HTMLElement): AppInstance;
 
 /**
@@ -128,10 +151,24 @@ interface HydrateOptions {
     program: CompiledProgram;
     /** The container element containing SSR-rendered HTML */
     container: HTMLElement;
+    /** Optional route context for dynamic routes */
+    route?: {
+        params: Record<string, string>;
+        query: Record<string, string>;
+        path: string;
+    };
 }
 /**
  * Hydrates a server-rendered application.
  *
+ * Lifecycle order:
+ * 1. State initialization
+ * 2. Refs map creation
+ * 3. DOM hydration (refs populated during hydration)
+ * 4. Copy buttons initialization
+ * 5. onMount execution (refs guaranteed to be available)
+ * 6. App instance returned
+ *
  * @param options - Hydration options containing program and container
  * @returns AppInstance for controlling the hydrated application
  */