composables

Overview ¶

Package composables provides Vue-inspired composable functions for BubblyUI.

Composables are reusable functions that encapsulate stateful logic using the Composition API pattern. They provide a clean way to extract and share reactive state management across components.

This package is an alias for github.com/newbpydev/bubblyui/pkg/bubbly/composables, providing a cleaner import path for users.

Core Composables ¶

• UseState: Simple reactive state with getter/setter
• UseEffect: Side effects with automatic cleanup
• UseDebounce: Debounced reactive values
• UseThrottle: Throttled callback execution
• UseEventListener: Event subscription management

Data Composables ¶

• UseList: Reactive list operations (add, remove, filter)
• UseHistory: Undo/redo state management
• UseForm: Form state with validation
• UseLocalStorage: Persistent storage integration

UI Composables ¶

• UseFocus: Focus management with tab order
• UseWindowSize: Responsive breakpoint tracking
• UseCounter: Numeric counter with min/max/step
• UseInterval: Periodic callback execution

Example ¶

import "github.com/newbpydev/bubblyui/composables"

func setup(ctx *bubbly.Context) {
    // State management
    count := composables.UseState(ctx, 0)
    count.Set(count.Get() + 1)

    // Debounced search
    query := bubbly.NewRef("")
    debouncedQuery := composables.UseDebounce(ctx, query, 300*time.Millisecond)

    // Focus management
    focus := composables.UseFocus(ctx, "input1", []string{"input1", "input2", "submit"})
}