@akashjs/runtime 0.2.0 → 0.2.1

package/dist/component-C1WnFcRp.d.cts

@@ -0,0 +1,59 @@
+/** Represents any renderable node in AkashJS */
+type AkashNode = Node | string | number | boolean | null | undefined | AkashNode[];
+
+/**
+ * Component system.
+ *
+ * Components are functions. defineComponent() wraps a setup function
+ * that runs once, establishes signals and effects, and returns a
+ * render function that produces DOM nodes.
+ */
+
+/** Mark a function as a compiler-generated reactive getter */
+declare function __getter<T>(fn: () => T): (() => T) & {
+    __reactive: true;
+};
+interface Ref<T = HTMLElement> {
+    current: T | undefined;
+}
+interface ComponentContext<P extends Record<string, unknown> = Record<string, unknown>> {
+    props: Readonly<P>;
+    children: () => AkashNode;
+}
+type Component<P extends Record<string, unknown> = Record<string, unknown>> = {
+    (props: P & {
+        children?: AkashNode | (() => AkashNode);
+    }): Node;
+    _akash: true;
+};
+/**
+ * Register a callback to run after the component is mounted to the DOM.
+ * If the callback returns a function, it will be called on unmount (cleanup).
+ */
+declare function onMount(fn: () => void | (() => void)): void;
+/**
+ * Register a callback to run before the component is unmounted.
+ */
+declare function onUnmount(fn: () => void): void;
+/**
+ * Register an error handler for this component and its descendants.
+ */
+declare function onError(fn: (error: Error) => void): void;
+/**
+ * Create a ref for accessing a DOM element or storing a mutable value.
+ */
+declare function ref<T = HTMLElement>(initialValue?: T): Ref<T>;
+/**
+ * Define a component. The setup function runs once per instance.
+ * It receives a context with typed props and must return a render function.
+ *
+ * ```ts
+ * const Counter = defineComponent<{ initial: number }>((ctx) => {
+ *   const count = signal(ctx.props.initial);
+ *   return () => <div>{count()}</div>;
+ * });
+ * ```
+ */
+declare function defineComponent<P extends Record<string, any> = Record<string, any>>(setup: (ctx: ComponentContext<P>) => () => AkashNode): Component<P>;
+
+export { type AkashNode as A, type Component as C, type Ref as R, __getter as _, type ComponentContext as a, onMount as b, onUnmount as c, defineComponent as d, onError as o, ref as r };

package/dist/component-C1WnFcRp.d.ts

@@ -0,0 +1,59 @@
+/** Represents any renderable node in AkashJS */
+type AkashNode = Node | string | number | boolean | null | undefined | AkashNode[];
+
+/**
+ * Component system.
+ *
+ * Components are functions. defineComponent() wraps a setup function
+ * that runs once, establishes signals and effects, and returns a
+ * render function that produces DOM nodes.
+ */
+
+/** Mark a function as a compiler-generated reactive getter */
+declare function __getter<T>(fn: () => T): (() => T) & {
+    __reactive: true;
+};
+interface Ref<T = HTMLElement> {
+    current: T | undefined;
+}
+interface ComponentContext<P extends Record<string, unknown> = Record<string, unknown>> {
+    props: Readonly<P>;
+    children: () => AkashNode;
+}
+type Component<P extends Record<string, unknown> = Record<string, unknown>> = {
+    (props: P & {
+        children?: AkashNode | (() => AkashNode);
+    }): Node;
+    _akash: true;
+};
+/**
+ * Register a callback to run after the component is mounted to the DOM.
+ * If the callback returns a function, it will be called on unmount (cleanup).
+ */
+declare function onMount(fn: () => void | (() => void)): void;
+/**
+ * Register a callback to run before the component is unmounted.
+ */
+declare function onUnmount(fn: () => void): void;
+/**
+ * Register an error handler for this component and its descendants.
+ */
+declare function onError(fn: (error: Error) => void): void;
+/**
+ * Create a ref for accessing a DOM element or storing a mutable value.
+ */
+declare function ref<T = HTMLElement>(initialValue?: T): Ref<T>;
+/**
+ * Define a component. The setup function runs once per instance.
+ * It receives a context with typed props and must return a render function.
+ *
+ * ```ts
+ * const Counter = defineComponent<{ initial: number }>((ctx) => {
+ *   const count = signal(ctx.props.initial);
+ *   return () => <div>{count()}</div>;
+ * });
+ * ```
+ */
+declare function defineComponent<P extends Record<string, any> = Record<string, any>>(setup: (ctx: ComponentContext<P>) => () => AkashNode): Component<P>;
+
+export { type AkashNode as A, type Component as C, type Ref as R, __getter as _, type ComponentContext as a, onMount as b, onUnmount as c, defineComponent as d, onError as o, ref as r };

package/dist/context-2uQ6fuxu.d.cts

@@ -0,0 +1,57 @@
+/**
+ * Batch multiple signal writes — subscribers are notified only once
+ * at the end of the batch.
+ */
+declare function batch(fn: () => void): void;
+/** Synchronously flush all pending effects. Useful for testing. */
+declare function flushSync(): void;
+
+/**
+ * Lightweight dependency injection via provide/inject.
+ *
+ * Context is scoped to the component tree — no injector hierarchy,
+ * no decorators, no classes. Just createContext(), provide(), inject().
+ */
+declare const CONTEXT_BRAND: unique symbol;
+interface InjectionKey<T> {
+    readonly [CONTEXT_BRAND]: true;
+    readonly _type: T;
+    readonly defaultValue: T | undefined;
+    readonly id: symbol;
+}
+interface ContextScope {
+    values: Map<symbol, unknown>;
+    parent: ContextScope | null;
+}
+/** @internal */
+declare function getCurrentScope(): ContextScope | null;
+/**
+ * Run a function within a given scope so that provide/inject
+ * work correctly for components created asynchronously
+ * (e.g., lazy-loaded route components).
+ */
+declare function runInScope<T>(scope: ContextScope, fn: () => T): T;
+/**
+ * Create a typed context key with an optional default value.
+ *
+ * ```ts
+ * const ThemeContext = createContext<'light' | 'dark'>('light');
+ * ```
+ */
+declare function createContext<T>(defaultValue?: T): InjectionKey<T>;
+/**
+ * Provide a value for a context key in the current component scope.
+ * All descendant components can inject() this value.
+ *
+ * Must be called inside defineComponent() setup.
+ */
+declare function provide<T>(key: InjectionKey<T>, value: T): void;
+/**
+ * Inject a value from the nearest ancestor that provided it.
+ *
+ * Must be called inside defineComponent() setup.
+ */
+declare function inject<T>(key: InjectionKey<T>): T;
+declare function inject<T>(key: InjectionKey<T>, fallback: T): T;
+
+export { type InjectionKey as I, batch as b, createContext as c, flushSync as f, getCurrentScope as g, inject as i, provide as p, runInScope as r };

package/dist/context-2uQ6fuxu.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Batch multiple signal writes — subscribers are notified only once
+ * at the end of the batch.
+ */
+declare function batch(fn: () => void): void;
+/** Synchronously flush all pending effects. Useful for testing. */
+declare function flushSync(): void;
+
+/**
+ * Lightweight dependency injection via provide/inject.
+ *
+ * Context is scoped to the component tree — no injector hierarchy,
+ * no decorators, no classes. Just createContext(), provide(), inject().
+ */
+declare const CONTEXT_BRAND: unique symbol;
+interface InjectionKey<T> {
+    readonly [CONTEXT_BRAND]: true;
+    readonly _type: T;
+    readonly defaultValue: T | undefined;
+    readonly id: symbol;
+}
+interface ContextScope {
+    values: Map<symbol, unknown>;
+    parent: ContextScope | null;
+}
+/** @internal */
+declare function getCurrentScope(): ContextScope | null;
+/**
+ * Run a function within a given scope so that provide/inject
+ * work correctly for components created asynchronously
+ * (e.g., lazy-loaded route components).
+ */
+declare function runInScope<T>(scope: ContextScope, fn: () => T): T;
+/**
+ * Create a typed context key with an optional default value.
+ *
+ * ```ts
+ * const ThemeContext = createContext<'light' | 'dark'>('light');
+ * ```
+ */
+declare function createContext<T>(defaultValue?: T): InjectionKey<T>;
+/**
+ * Provide a value for a context key in the current component scope.
+ * All descendant components can inject() this value.
+ *
+ * Must be called inside defineComponent() setup.
+ */
+declare function provide<T>(key: InjectionKey<T>, value: T): void;
+/**
+ * Inject a value from the nearest ancestor that provided it.
+ *
+ * Must be called inside defineComponent() setup.
+ */
+declare function inject<T>(key: InjectionKey<T>): T;
+declare function inject<T>(key: InjectionKey<T>, fallback: T): T;
+
+export { type InjectionKey as I, batch as b, createContext as c, flushSync as f, getCurrentScope as g, inject as i, provide as p, runInScope as r };

package/dist/core.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkQDCIW4YE_cjs=require('./chunk-QDCIW4YE.cjs'),chunkV7VG23IO_cjs=require('./chunk-V7VG23IO.cjs');Object.defineProperty(exports,"For",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.t}});Object.defineProperty(exports,"Show",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.s}});Object.defineProperty(exports,"bindProperty",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.o}});Object.defineProperty(exports,"bindText",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.n}});Object.defineProperty(exports,"bindVisible",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.p}});Object.defineProperty(exports,"cloneTemplate",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.l}});Object.defineProperty(exports,"createContext",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.g}});Object.defineProperty(exports,"createElement",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.j}});Object.defineProperty(exports,"createText",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.k}});Object.defineProperty(exports,"defineComponent",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.B}});Object.defineProperty(exports,"inject",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.i}});Object.defineProperty(exports,"insert",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.v}});Object.defineProperty(exports,"nodeToDOM",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.u}});Object.defineProperty(exports,"onError",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.z}});Object.defineProperty(exports,"onMount",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.x}});Object.defineProperty(exports,"onUnmount",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.y}});Object.defineProperty(exports,"provide",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.h}});Object.defineProperty(exports,"ref",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.A}});Object.defineProperty(exports,"renderConditional",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.q}});Object.defineProperty(exports,"renderList",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.r}});Object.defineProperty(exports,"setProperty",{enumerable:true,get:function(){return chunkQDCIW4YE_cjs.m}});Object.defineProperty(exports,"batch",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.a}});Object.defineProperty(exports,"computed",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.m}});Object.defineProperty(exports,"effect",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.n}});Object.defineProperty(exports,"flushSync",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.b}});Object.defineProperty(exports,"signal",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.l}});Object.defineProperty(exports,"untrack",{enumerable:true,get:function(){return chunkV7VG23IO_cjs.o}});//# sourceMappingURL=core.cjs.map
+'use strict';var chunkNQVWTQ2I_cjs=require('./chunk-NQVWTQ2I.cjs'),chunk3AL2DVPZ_cjs=require('./chunk-3AL2DVPZ.cjs');Object.defineProperty(exports,"For",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.t}});Object.defineProperty(exports,"Show",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.s}});Object.defineProperty(exports,"bindProperty",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.o}});Object.defineProperty(exports,"bindText",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.n}});Object.defineProperty(exports,"bindVisible",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.p}});Object.defineProperty(exports,"cloneTemplate",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.l}});Object.defineProperty(exports,"createContext",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.g}});Object.defineProperty(exports,"createElement",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.j}});Object.defineProperty(exports,"createText",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.k}});Object.defineProperty(exports,"defineComponent",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.B}});Object.defineProperty(exports,"inject",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.i}});Object.defineProperty(exports,"insert",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.v}});Object.defineProperty(exports,"nodeToDOM",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.u}});Object.defineProperty(exports,"onError",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.z}});Object.defineProperty(exports,"onMount",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.x}});Object.defineProperty(exports,"onUnmount",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.y}});Object.defineProperty(exports,"provide",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.h}});Object.defineProperty(exports,"ref",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.A}});Object.defineProperty(exports,"renderConditional",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.q}});Object.defineProperty(exports,"renderList",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.r}});Object.defineProperty(exports,"setProperty",{enumerable:true,get:function(){return chunkNQVWTQ2I_cjs.m}});Object.defineProperty(exports,"batch",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.a}});Object.defineProperty(exports,"computed",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.m}});Object.defineProperty(exports,"effect",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.n}});Object.defineProperty(exports,"flushSync",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.b}});Object.defineProperty(exports,"signal",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.l}});Object.defineProperty(exports,"untrack",{enumerable:true,get:function(){return chunk3AL2DVPZ_cjs.o}});//# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/core.d.cts

@@ -0,0 +1,65 @@
+export { R as ReadonlySignal, S as Signal, c as computed, e as effect, s as signal, u as untrack } from './signals-C7XfOHHR.cjs';
+export { I as InjectionKey, b as batch, c as createContext, f as flushSync, i as inject, p as provide } from './context-2uQ6fuxu.cjs';
+import { A as AkashNode } from './component-C1WnFcRp.cjs';
+export { C as Component, a as ComponentContext, R as Ref, d as defineComponent, o as onError, b as onMount, c as onUnmount, r as ref } from './component-C1WnFcRp.cjs';
+
+/**
+ * Direct DOM rendering runtime.
+ *
+ * No virtual DOM. The compiler generates calls to these helpers.
+ * Signal reads inside templates become fine-grained effects that
+ * update only the specific DOM node that changed.
+ */
+
+/** Create an element and optionally set static attributes */
+declare function createElement(tag: string, attrs?: Record<string, unknown>): HTMLElement;
+/** Create a text node */
+declare function createText(value: string): Text;
+/** Clone a template element for static structure */
+declare function cloneTemplate(html: string): DocumentFragment;
+declare function setProperty(el: HTMLElement, key: string, value: unknown): void;
+/** Bind a reactive expression to a text node's content */
+declare function bindText(node: Text, fn: () => unknown): () => void;
+/** Bind a reactive expression to an element's attribute/property */
+declare function bindProperty(el: HTMLElement, key: string, fn: () => unknown): () => void;
+/** Bind a reactive expression to an element's visibility (display) */
+declare function bindVisible(el: HTMLElement, fn: () => boolean): () => void;
+/**
+ * Render a conditional block. Swaps DOM fragments based on a reactive
+ * condition. Used by the compiler for :if directives and <Show>.
+ */
+declare function renderConditional(parent: Node, anchor: Node, condition: () => boolean, trueBranch: () => Node, falseBranch?: () => Node): () => void;
+/**
+ * Render a reactive list with keyed reconciliation.
+ * Used by the compiler for :for directives and <For>.
+ */
+declare function renderList<T>(parent: Node, anchor: Node, items: () => T[], keyFn: (item: T, index: number) => unknown, renderItem: (item: T, index: number) => Node): () => void;
+/** Props for the <Show> component */
+interface ShowProps<T> {
+    when: (() => T | null | undefined | false) | T | null | undefined | false;
+    fallback?: () => AkashNode;
+    children: (value: T) => AkashNode;
+}
+/**
+ * <Show> component — conditionally renders children with type narrowing.
+ * The children callback receives the non-null/undefined value.
+ * `when` can be a reactive getter or a static value.
+ */
+declare function Show<T>(props: ShowProps<T>): Node;
+/** Props for the <For> component */
+interface ForProps<T> {
+    each: (() => T[]) | T[];
+    key: (item: T) => unknown;
+    children: (item: T, index: number) => AkashNode;
+}
+/**
+ * <For> component — renders a list with keyed reconciliation.
+ * `each` can be a reactive getter or a static array.
+ */
+declare function For<T>(props: ForProps<T>): Node;
+/** Convert an AkashNode to a DOM Node */
+declare function nodeToDOM(node: AkashNode): Node;
+/** Insert a node into a parent before an anchor */
+declare function insert(parent: Node, node: AkashNode, anchor?: Node): void;
+
+export { AkashNode, For, Show, bindProperty, bindText, bindVisible, cloneTemplate, createElement, createText, insert, nodeToDOM, renderConditional, renderList, setProperty };

package/dist/core.d.ts

@@ -0,0 +1,65 @@
+export { R as ReadonlySignal, S as Signal, c as computed, e as effect, s as signal, u as untrack } from './signals-C7XfOHHR.js';
+export { I as InjectionKey, b as batch, c as createContext, f as flushSync, i as inject, p as provide } from './context-2uQ6fuxu.js';
+import { A as AkashNode } from './component-C1WnFcRp.js';
+export { C as Component, a as ComponentContext, R as Ref, d as defineComponent, o as onError, b as onMount, c as onUnmount, r as ref } from './component-C1WnFcRp.js';
+
+/**
+ * Direct DOM rendering runtime.
+ *
+ * No virtual DOM. The compiler generates calls to these helpers.
+ * Signal reads inside templates become fine-grained effects that
+ * update only the specific DOM node that changed.
+ */
+
+/** Create an element and optionally set static attributes */
+declare function createElement(tag: string, attrs?: Record<string, unknown>): HTMLElement;
+/** Create a text node */
+declare function createText(value: string): Text;
+/** Clone a template element for static structure */
+declare function cloneTemplate(html: string): DocumentFragment;
+declare function setProperty(el: HTMLElement, key: string, value: unknown): void;
+/** Bind a reactive expression to a text node's content */
+declare function bindText(node: Text, fn: () => unknown): () => void;
+/** Bind a reactive expression to an element's attribute/property */
+declare function bindProperty(el: HTMLElement, key: string, fn: () => unknown): () => void;
+/** Bind a reactive expression to an element's visibility (display) */
+declare function bindVisible(el: HTMLElement, fn: () => boolean): () => void;
+/**
+ * Render a conditional block. Swaps DOM fragments based on a reactive
+ * condition. Used by the compiler for :if directives and <Show>.
+ */
+declare function renderConditional(parent: Node, anchor: Node, condition: () => boolean, trueBranch: () => Node, falseBranch?: () => Node): () => void;
+/**
+ * Render a reactive list with keyed reconciliation.
+ * Used by the compiler for :for directives and <For>.
+ */
+declare function renderList<T>(parent: Node, anchor: Node, items: () => T[], keyFn: (item: T, index: number) => unknown, renderItem: (item: T, index: number) => Node): () => void;
+/** Props for the <Show> component */
+interface ShowProps<T> {
+    when: (() => T | null | undefined | false) | T | null | undefined | false;
+    fallback?: () => AkashNode;
+    children: (value: T) => AkashNode;
+}
+/**
+ * <Show> component — conditionally renders children with type narrowing.
+ * The children callback receives the non-null/undefined value.
+ * `when` can be a reactive getter or a static value.
+ */
+declare function Show<T>(props: ShowProps<T>): Node;
+/** Props for the <For> component */
+interface ForProps<T> {
+    each: (() => T[]) | T[];
+    key: (item: T) => unknown;
+    children: (item: T, index: number) => AkashNode;
+}
+/**
+ * <For> component — renders a list with keyed reconciliation.
+ * `each` can be a reactive getter or a static array.
+ */
+declare function For<T>(props: ForProps<T>): Node;
+/** Convert an AkashNode to a DOM Node */
+declare function nodeToDOM(node: AkashNode): Node;
+/** Insert a node into a parent before an anchor */
+declare function insert(parent: Node, node: AkashNode, anchor?: Node): void;
+
+export { AkashNode, For, Show, bindProperty, bindText, bindVisible, cloneTemplate, createElement, createText, insert, nodeToDOM, renderConditional, renderList, setProperty };

package/dist/core.js

@@ -1,2 +1,2 @@
-export{t as For,s as Show,o as bindProperty,n as bindText,p as bindVisible,l as cloneTemplate,g as createContext,j as createElement,k as createText,B as defineComponent,i as inject,v as insert,u as nodeToDOM,z as onError,x as onMount,y as onUnmount,h as provide,A as ref,q as renderConditional,r as renderList,m as setProperty}from'./chunk-DYJUCZXA.js';export{a as batch,m as computed,n as effect,b as flushSync,l as signal,o as untrack}from'./chunk-EUKRTV4W.js';//# sourceMappingURL=core.js.map
+export{t as For,s as Show,o as bindProperty,n as bindText,p as bindVisible,l as cloneTemplate,g as createContext,j as createElement,k as createText,B as defineComponent,i as inject,v as insert,u as nodeToDOM,z as onError,x as onMount,y as onUnmount,h as provide,A as ref,q as renderConditional,r as renderList,m as setProperty}from'./chunk-BT6HNBE7.js';export{a as batch,m as computed,n as effect,b as flushSync,l as signal,o as untrack}from'./chunk-POLTPHUA.js';//# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map