API Reference#

Complete reference for all SignalX (sigx) exports. SignalX re-exports everything from:

• @sigx/reactivity - Reactive primitives
• @sigx/runtime-core - Component system
• @sigx/runtime-dom - DOM rendering

Quick Navigation#

Reactivity#

• signal - Create reactive state
• effect - Run side effects
• computed - Derived values
• watch - Watch with callbacks
• batch - Batch updates
• untrack - Read without tracking
• toRaw - Get raw object
• isReactive - Check if reactive
• effectScope - Group effects

Components#

• component - Define component
• Fragment - Render without wrapper
• lazy - Lazy load component
• Suspense - Async boundary
• Portal - Render to different DOM location

Lifecycle#

• onMounted - After mount
• onUnmounted - Before unmount
• onCreated - After creation
• onUpdated - After update

Dependency Injection#

• provide - Provide value to descendants
• inject - Inject from ancestors
• createInjectable - Create injectable
• defineProvide - Provide + create

App & Plugins#

• defineApp - Create application
• Plugin - Plugin type

Advanced#

• defineFactory - Injectable factory
• createTopic - Pub/sub messaging
• toSubscriber - Read-only subscriber

Types#

• Define.Prop - Prop type helper
• Define.Event - Event type helper
• Define.Slot - Slot type helper
• Define.Model - Two-way binding helper
• Define.Expose - Exposed API helper
• ComponentRef - Component ref type
• Exposed - Extract exposed type

Import#

All APIs are available from the main sigx package:

import { 
    // Reactivity
    signal, effect, computed, watch,
    batch, untrack, toRaw, isReactive, effectScope,
    
    // Components
    component, Fragment, lazy, Suspense, Portal,
    
    // Lifecycle
    onMounted, onUnmounted, onCreated, onUpdated,
    
    // DI
    provide, inject, createInjectable, defineProvide,
    
    // App
    defineApp,
    
    // Types
    type Define, ComponentRef, Exposed,
    
    // Advanced
    defineFactory, createTopic, toSubscriber,
    InstanceLifetimes
} from 'sigx';

TypeScript#

SignalX is written in TypeScript and provides full type inference. All component props, events, slots, and exposed APIs are fully typed.

// Full type safety
type MyProps = 
    & Define.Prop<'name', string, true>
    & Define.Prop<'count', number>
    & Define.Event<'change', number>
    & Define.Slot<'header'>
    & Define.Expose<{ reset: () => void }>;

const MyComponent = component<MyProps>(({ props, emit, slots, expose }) => {
    // props.name is string (required)
    // props.count is number | undefined (optional)
    // emit('change', 5) is type-checked
    // slots.header is typed correctly
    
    expose({ reset: () => {} }); // Type-checked
    
    return () => <div>{props.name}</div>;
});