@constela/runtime 0.3.0 → 0.3.2

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/dist/index.js

@@ -409,14 +409,25 @@ function renderElement(node, ctx) {
         el.addEventListener(eventName, async (event) => {
           const action = ctx.actions[handler.action];
           if (action) {
+            const eventLocals = {};
+            const target = event.target;
+            if (target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement) {
+              eventLocals["value"] = target.value;
+              if (target instanceof HTMLInputElement && target.type === "checkbox") {
+                eventLocals["checked"] = target.checked;
+              }
+            }
             let payload = void 0;
             if (handler.payload) {
-              payload = evaluate(handler.payload, { state: ctx.state, locals: ctx.locals });
+              payload = evaluate(handler.payload, {
+                state: ctx.state,
+                locals: { ...ctx.locals, ...eventLocals }
+              });
             }
             const actionCtx = {
               state: ctx.state,
               actions: ctx.actions,
-              locals: { ...ctx.locals, payload },
+              locals: { ...ctx.locals, ...eventLocals, payload },
               eventPayload: payload
             };
             await executeAction(action, actionCtx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/runtime",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Runtime DOM renderer for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,9 +14,17 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
-    "@constela/core": "0.3.0",
-    "@constela/compiler": "0.3.0"
+    "@constela/core": "workspace:*",
+    "@constela/compiler": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
@@ -29,12 +37,5 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "type-check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist"
-  }
-}
+  "license": "MIT"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Constela Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.