@constela/runtime 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+import { CompiledExpression, CompiledAction, CompiledNode, CompiledProgram } from '@constela/compiler';
+
+interface Signal<T> {
+    get(): T;
+    set(value: T): void;
+    subscribe?(fn: (value: T) => void): () => void;
+}
+declare function createSignal<T>(initial: T): Signal<T>;
+
+/**
+ * Effect - Reactive side effect
+ *
+ * An effect runs a function and automatically tracks signal dependencies.
+ * When any tracked signal changes, the effect re-runs.
+ */
+type CleanupFn = () => void;
+type EffectFn = () => void | CleanupFn;
+declare function createEffect(fn: EffectFn): () => void;
+
+/**
+ * StateStore - Centralized state management
+ *
+ * Creates signals for each state field defined in the program.
+ * Provides get/set methods for accessing state.
+ */
+interface StateStore {
+    get(name: string): unknown;
+    set(name: string, value: unknown): void;
+}
+interface StateDefinition {
+    type: string;
+    initial: unknown;
+}
+declare function createStateStore(definitions: Record<string, StateDefinition>): StateStore;
+
+/**
+ * Expression Evaluator - Evaluates compiled expressions
+ *
+ * Supports:
+ * - Literal values (lit)
+ * - State reads (state)
+ * - Variable reads (var)
+ * - Binary operations (bin)
+ * - Not operation (not)
+ * - Conditional expressions (cond)
+ * - Property access (get)
+ */
+
+interface EvaluationContext {
+    state: StateStore;
+    locals: Record<string, unknown>;
+}
+declare function evaluate(expr: CompiledExpression, ctx: EvaluationContext): unknown;
+
+/**
+ * Action Executor - Executes compiled action steps
+ *
+ * Supports:
+ * - set: Update state with value
+ * - update: Increment/decrement numbers, push/pop/remove for arrays
+ * - fetch: Make HTTP requests with onSuccess/onError handlers
+ */
+
+interface ActionContext {
+    state: StateStore;
+    actions: Record<string, CompiledAction>;
+    locals: Record<string, unknown>;
+    eventPayload?: unknown;
+}
+declare function executeAction(action: CompiledAction, ctx: ActionContext): Promise<void>;
+
+/**
+ * Renderer - DOM rendering for compiled view nodes
+ *
+ * Renders:
+ * - element: Creates DOM elements with props and event handlers
+ * - text: Creates text nodes
+ * - if: Conditional rendering with reactive updates
+ * - each: List rendering with reactive updates
+ */
+
+interface RenderContext {
+    state: StateStore;
+    actions: Record<string, CompiledAction>;
+    locals: Record<string, unknown>;
+    cleanups?: (() => void)[];
+}
+declare function render(node: CompiledNode, ctx: RenderContext): Node;
+
+/**
+ * App - Main entry point for creating Constela applications
+ *
+ * Creates a reactive application from a CompiledProgram and mounts it to the DOM.
+ */
+
+interface AppInstance {
+    destroy(): void;
+    setState(name: string, value: unknown): void;
+    getState(name: string): unknown;
+}
+declare function createApp(program: CompiledProgram, mount: HTMLElement): AppInstance;
+
+export { type ActionContext, type AppInstance, type EvaluationContext, type RenderContext, type Signal, type StateStore, createApp, createEffect, createSignal, createStateStore, evaluate, executeAction, render };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/runtime",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Runtime DOM renderer for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,8 +15,8 @@
     "dist"
   ],
   "dependencies": {
-    "@constela/core": "0.3.0",
-    "@constela/compiler": "0.3.0"
+    "@constela/core": "0.3.1",
+    "@constela/compiler": "0.3.1"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",