Class App

constructor

• new App(target?: string): App

  Creates a new App instance.

  Parameters

  • Optionaltarget: string

    The CSS selector for the root element (e.g., "#app").

  Returns App

_actions

_state

components

configOptions

plugins

root

router

isBrowser

• get isBrowser(): boolean

  Checks if the code is running in a browser environment.

  Returns boolean

add

• add(component: BaseElement | BaseElement[]): this

  Adds a component or list of components to the application. Used primarily when no routing is defined.

  Parameters

  • component: BaseElement | BaseElement[]

    A BaseElement or array of BaseElements.

  Returns this

  The App instance for chaining.

  Example

  app().add(div("Hello"));
  Copy

addStyle

• addStyle(style: string): this

  Injects a global CSS style string into the document head.

  Parameters

  • style: string

    The CSS string to inject.

  Returns this

  The App instance for chaining.

config

• config(options: { title?: string }): this

  Configures global application settings.

  Parameters

  • options: { title?: string }

    Configuration object (e.g., { title: "My App" }).

  Returns this

  The App instance for chaining.

  Example

  app().config({ title: "My Awesome App" });
  Copy

logic

• logic(logicFn: (state: any, actions: any) => any): this

  Defines application logic (deprecated pattern).

  Parameters

  • logicFn: (state: any, actions: any) => any

    Function receiving state and actions.

  Returns this

  The App instance for chaining.

render

• render(): App

  Renders the application to the DOM. Must be called after configuration and setup.

  Returns App

  The App instance.

  Throws

  Error if run outside the browser or if root element is missing.

renderToString

• renderToString(): string

  Renders the application to a string (Server-Side Rendering).

  Returns string

  The HTML string representation of the app.

route

• route(path: string, handler: RouteHandler): this

  Registers a route handler for a specific path.

  Parameters

  • path: string

    The URL path (e.g., "/home").

  • handler: RouteHandler

    A BaseElement or a factory function returning one.

  Returns this

  The App instance for chaining.

  Example

  app().route("/", () => div("Home Page"));
  Copy

setTitle

• setTitle(title: string): this

  Sets the document title.

  Parameters

  • title: string

    The new title string.

  Returns this

  The App instance for chaining.

state

• state<T>(initialState: T): State<T>

  Creates a reactive state object (legacy wrapper around state()).

  Type Parameters

  • T

  Parameters

  • initialState: T

    The initial value.

  Returns State<T>

  A reactive state proxy.

use

• use(plugin: Plugin): this

  Installs a plugin into the application.

  Parameters

  • plugin: Plugin

    The plugin object implementing the Plugin interface.

  Returns this

  The App instance for chaining.

with

• with(component: BaseElement | BaseElement[]): this

  Alias for .add(). Adds a component to the application.

  Parameters

  • component: BaseElement | BaseElement[]

    A BaseElement or array of BaseElements.

  Returns this

  The App instance for chaining.