domma-js 0.56.0 → 0.57.0

package/assets/types/models.d.ts

@@ -1,260 +0,0 @@
-/**
- * Domma Models Module - TypeScript Declarations
- * Pub/Sub events and reactive data binding
- */
-
-export type TypeValidator = (value: any) => boolean;
-
-export interface FieldDefinition {
-    type?: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'date' | 'any';
-    default?: any;
-    required?: boolean;
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: RegExp;
-    validate?: (value: any) => boolean | string;
-}
-
-export interface Schema {
-    [field: string]: FieldDefinition;
-}
-
-export interface ValidationResult {
-    valid: boolean;
-    errors: Array<{ field: string; error: string }>;
-}
-
-export interface ModelOptions {
-    persist?: string;
-    autoSave?: boolean;
-}
-
-export interface ChangeEvent {
-    field: string;
-    newValue: any;
-    oldValue: any;
-    model: Model;
-}
-
-export type ChangeCallback = (event: ChangeEvent) => void;
-export type FieldChangeCallback = (newValue: any, oldValue: any, model: Model) => void;
-export type UnsubscribeFn = () => void;
-
-export interface BindingOptions {
-    format?: (value: any) => any;
-    parse?: (value: any) => any;
-    twoWay?: boolean;
-}
-
-/**
- * A lazily-evaluated, dependency-tracked derived value.
- */
-export interface ComputedRef<T = any> {
-    /** Current value, recomputing only if a dependency changed. */
-    get(): T;
-
-    /** Current value without registering a dependency on the caller. */
-    peek(): T;
-
-    /** Unlink from the dependency graph. */
-    dispose(): void;
-}
-
-export interface ComputedOptions<T = any> {
-    /** Debug label used in console warnings. */
-    label?: string;
-
-    /** Called with the new value whenever it changes. */
-    onChange?: (value: T) => void;
-}
-
-export interface EffectOptions {
-    /** Debug label used in console warnings. */
-    label?: string;
-}
-
-/**
- * Reactive Model class
- */
-export declare class Model {
-    constructor(schema: Schema, data?: Record<string, any>, options?: ModelOptions);
-
-    /**
-     * Get field value or all data.
-     * Reads inside a computed or effect are tracked as dependencies.
-     */
-    get(): Record<string, any>;
-    get(field: string): any;
-
-    /**
-     * Read-tracked, write-through view of the model's data.
-     * Property reads register a dependency; writes route through set(),
-     * preserving validation, change notification and persistence.
-     */
-    tracked(): Record<string, any>;
-
-    /** Set field value(s) */
-    set(field: string, value: any): Model;
-    set(data: Record<string, any>): Model;
-
-    /** Validate all fields */
-    validate(): ValidationResult;
-
-    /** Get model data as JSON */
-    toJSON(): Record<string, any>;
-
-    /** Subscribe to any change; callback receives {field, newValue, oldValue, model} */
-    onChange(callback: ChangeCallback): UnsubscribeFn;
-
-    /** Subscribe to changes on a single field; callback receives the same change object */
-    onChange(field: string, callback: ChangeCallback): UnsubscribeFn;
-
-    /** Subscribe to specific field change */
-    onFieldChange(field: string, callback: FieldChangeCallback): UnsubscribeFn;
-
-    /** Reset model to initial data */
-    reset(clearStorage?: boolean): Model;
-
-    /** Destroy model and cleanup */
-    destroy(clearStorage?: boolean): void;
-
-    // Persistence Methods
-
-    /** Manually save model to localStorage */
-    save(): boolean;
-
-    /** Manually load model from localStorage */
-    load(): boolean;
-
-    /** Clear persisted data from localStorage */
-    clearStorage(): boolean;
-
-    /** Get the persistence key */
-    getPersistKey(): string | null;
-
-    /** Check if model is persisted */
-    isPersisted(): boolean;
-}
-
-export interface Store {
-    /** Get current state */
-    getState(): Record<string, any>;
-
-    /** Update state with partial updates */
-    setState(updates: Record<string, any>): void;
-
-    /** Subscribe to state changes */
-    subscribe(listener: (state: Record<string, any>, oldState: Record<string, any>) => void): UnsubscribeFn;
-
-    /** Reset state to initial or new state */
-    reset(newState?: Record<string, any>): void;
-}
-
-export interface TypeValidators {
-    string: TypeValidator;
-    number: TypeValidator;
-    boolean: TypeValidator;
-    array: TypeValidator;
-    object: TypeValidator;
-    date: TypeValidator;
-    any: TypeValidator;
-}
-
-export interface Models {
-    // ============================================
-    // Pub/Sub Event System
-    // ============================================
-
-    /** Subscribe to an event */
-    subscribe(event: string, callback: (data: any) => void): UnsubscribeFn;
-
-    /** Alias for subscribe */
-    on(event: string, callback: (data: any) => void): UnsubscribeFn;
-
-    /** Unsubscribe from an event */
-    unsubscribe(event: string, callback: (data: any) => void): void;
-
-    /** Alias for unsubscribe */
-    off(event: string, callback: (data: any) => void): void;
-
-    /** Publish an event */
-    publish(event: string, data?: any): void;
-
-    /** Alias for publish */
-    emit(event: string, data?: any): void;
-
-    /** Subscribe to an event once */
-    once(event: string, callback: (data: any) => void): UnsubscribeFn;
-
-    /** Clear event listeners */
-    clear(event?: string): void;
-
-    // ============================================
-    // Model Creation
-    // ============================================
-
-    /** Create a new reactive model */
-    create(schema: Schema, initialData?: Record<string, any>, options?: ModelOptions): Model;
-
-    /** Extend a blueprint with additional fields */
-    extend(...blueprints: Schema[]): Schema;
-
-    /** Pick specific fields from a blueprint */
-    pick(blueprint: Schema, fields: string[]): Schema;
-
-    /** Omit specific fields from a blueprint */
-    omit(blueprint: Schema, fields: string[]): Schema;
-
-    // ============================================
-    // Dependency-Tracked Reactivity
-    // ============================================
-
-    /**
-     * Create a lazily-evaluated derived value that tracks whatever it reads.
-     * The body must be synchronous - tracking stops at the first `await`.
-     */
-    computed<T = any>(fn: () => T, options?: ComputedOptions<T>): ComputedRef<T>;
-
-    /**
-     * Run a function now, and again whenever any field it read changes.
-     * Re-runs are batched into a single microtask flush.
-     * Returns a function that stops the effect.
-     */
-    effect(fn: () => void, options?: EffectOptions): UnsubscribeFn;
-
-    /** Read values without registering them as dependencies. */
-    untracked<T = any>(fn: () => T): T;
-
-    /** Settle pending reactive work immediately instead of on the microtask. */
-    flush(): void;
-
-    // ============================================
-    // Type Validators
-    // ============================================
-
-    types: TypeValidators;
-
-    // ============================================
-    // DOM Binding
-    // ============================================
-
-    /** Bind a model field to DOM element(s) */
-    bind(model: Model, field: string, selector: string | HTMLElement, options?: BindingOptions): UnsubscribeFn;
-
-    // ============================================
-    // Store (Simple State Management)
-    // ============================================
-
-    /** Get or create a named store */
-    store(name: string, initialState?: Record<string, any>): Store;
-
-    /** Get an existing store */
-    getStore(name: string): Store | undefined;
-
-    /** Remove a store */
-    removeStore(name: string): void;
-}
-
-export declare const models: Models;

package/assets/types/smooth-caret.d.ts

@@ -1,12 +0,0 @@
-export type CaretPreference = 'auto' | 'smooth' | 'native';
-export interface SmoothCaretHandle {
-    refresh(): void;
-    destroy(): void;
-}
-export interface SmoothCaret {
-    attach(element: HTMLInputElement | HTMLTextAreaElement | HTMLElement): SmoothCaretHandle;
-    install(root?: Document | HTMLElement | ShadowRoot): {destroy(): void};
-    getPreference(): CaretPreference;
-    setPreference(value: CaretPreference): void;
-}
-export declare const smoothCaret: SmoothCaret;

package/assets/types/storage.d.ts

@@ -1,93 +0,0 @@
-/**
- * Domma Storage Module - TypeScript Declarations
- * localStorage wrapper with auto-serialisation and key prefixing
- */
-
-export interface Storage {
-    /**
-     * Get a value from storage
-     * @param key - The storage key
-     * @param defaultValue - Default value if key doesn't exist
-     * @returns The stored value or default
-     */
-    get<T = any>(key: string, defaultValue?: T): T;
-
-    /**
-     * Set a value in storage
-     * @param key - The storage key
-     * @param value - The value to store (auto-serialised)
-     * @returns true if successful
-     */
-    set(key: string, value: any): boolean;
-
-    /**
-     * Remove a key from storage
-     * @param key - The storage key
-     * @returns true if successful
-     */
-    remove(key: string): boolean;
-
-    /**
-     * Check if a key exists in storage
-     * @param key - The storage key
-     * @returns true if key exists
-     */
-    has(key: string): boolean;
-
-    /**
-     * Clear all storage (within prefix)
-     * @returns true if successful
-     */
-    clear(): boolean;
-
-    /**
-     * Get all storage keys (within prefix)
-     * @returns Array of keys
-     */
-    keys(): string[];
-
-    /**
-     * Get the number of stored items (within prefix)
-     * @returns Number of items
-     */
-    size(): number;
-
-    /**
-     * Get total storage size in bytes
-     * @returns Size in bytes
-     */
-    totalSize(): number;
-
-    /**
-     * Get all stored data as an object
-     * @returns Object with all key-value pairs
-     */
-    getAll(): Record<string, any>;
-
-    /**
-     * Set multiple values at once
-     * @param data - Object with key-value pairs
-     * @returns true if all successful
-     */
-    setAll(data: Record<string, any>): boolean;
-
-    /**
-     * Check if localStorage is available
-     * @returns true if available
-     */
-    isAvailable(): boolean;
-
-    /**
-     * Set the key prefix
-     * @param prefix - Prefix string for all keys
-     */
-    setPrefix(prefix: string): void;
-
-    /**
-     * Get the current key prefix
-     * @returns Current prefix
-     */
-    getPrefix(): string;
-}
-
-export declare const storage: Storage;

package/assets/types/tables.d.ts

@@ -1,327 +0,0 @@
-/**
- * Domma Tables Module - TypeScript Declarations
- * DataTable-like functionality with sorting, filtering, pagination, and export
- */
-
-// ============================================
-// Types
-// ============================================
-
-export type SortDirection = 'asc' | 'desc' | null;
-export type SelectionMode = 'single' | 'multiple';
-export type ExportFormat = 'csv' | 'json' | 'excel';
-export type TableEventType = 'sort' | 'filter' | 'page' | 'select' | 'edit' | 'render';
-
-export interface ColumnDefinition {
-    /** Column key in data object */
-    key: string;
-    /** Display header text */
-    title?: string;
-    /** Enable sorting for this column */
-    sortable?: boolean;
-    /** Enable filtering for this column */
-    filterable?: boolean;
-    /** Column width */
-    width?: string | number;
-    /** Text alignment */
-    align?: 'left' | 'center' | 'right';
-    /** Custom render function */
-    render?: (value: any, row: Record<string, any>, index: number) => string;
-    /** Custom sort comparator */
-    comparator?: (a: any, b: any) => number;
-    /** Make column editable */
-    editable?: boolean;
-    /** Input type for editable cells */
-    editType?: 'text' | 'number' | 'select' | 'checkbox';
-    /** Options for select edit type */
-    editOptions?: string[] | { value: any; label: string }[];
-    /** Column visibility */
-    visible?: boolean;
-    /** CSS class for column */
-    className?: string;
-}
-
-export interface SortState {
-    column: string;
-    direction: SortDirection;
-}
-
-export interface FilterState {
-    column: string;
-    value: any;
-    operator?: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'startsWith' | 'endsWith';
-}
-
-export interface PageInfo {
-    currentPage: number;
-    pageSize: number;
-    totalPages: number;
-    totalRows: number;
-    startRow: number;
-    endRow: number;
-}
-
-export interface TableEventData {
-    type: TableEventType;
-    data?: any;
-}
-
-export type TableEventCallback = (event: TableEventData) => void;
-
-// ============================================
-// Table Options
-// ============================================
-
-export interface TableOptions {
-    /** Initial data array */
-    data?: Record<string, any>[];
-    /** Column definitions */
-    columns?: ColumnDefinition[];
-    /** Enable sorting */
-    sortable?: boolean;
-    /** Enable filtering */
-    filterable?: boolean;
-    /** Enable global search */
-    searchable?: boolean;
-    /** Enable pagination */
-    pagination?: boolean;
-    /** Rows per page */
-    pageSize?: number;
-    /** Page size options */
-    pageSizeOptions?: number[];
-    /** Enable row selection */
-    selectable?: boolean;
-    /** Selection mode: 'single' or 'multiple' */
-    selectionMode?: SelectionMode;
-    /** Enable cell editing */
-    editable?: boolean;
-    /** Enable column resizing */
-    resizable?: boolean;
-    /** Show export panel */
-    exportPanel?: boolean;
-    /** Show row numbers */
-    showRowNumbers?: boolean;
-    /** Empty state message */
-    emptyMessage?: string;
-    /** Loading state message */
-    loadingMessage?: string;
-    /** CSS class for table */
-    className?: string;
-    /** Striped rows */
-    striped?: boolean;
-    /** Hoverable rows */
-    hover?: boolean;
-    /** Bordered table */
-    bordered?: boolean;
-    /** Compact/dense layout */
-    compact?: boolean;
-    /** Responsive wrapper */
-    responsive?: boolean;
-}
-
-// ============================================
-// Table Instance
-// ============================================
-
-export interface TableInstance {
-    /** The table element */
-    element: HTMLElement;
-    /** Current options */
-    options: TableOptions;
-
-    // Data Methods
-    /** Set table data */
-    setData(data: Record<string, any>[]): this;
-
-    /** Get current data (filtered and sorted) */
-    getData(): Record<string, any>[];
-
-    /** Get original unfiltered data */
-    getOriginalData(): Record<string, any>[];
-
-    /** Add a single row */
-    addRow(row: Record<string, any>): this;
-
-    /** Add multiple rows */
-    addRows(rows: Record<string, any>[]): this;
-
-    /** Update a row by index */
-    updateRow(index: number, data: Partial<Record<string, any>>): this;
-
-    /** Remove a row by index */
-    removeRow(index: number): this;
-
-    /** Remove multiple rows by indices */
-    removeRows(indices: number[]): this;
-
-    /** Clear all data */
-    clear(): this;
-
-    /** Refresh the table display */
-    refresh(): this;
-
-    // Sort Methods
-    /** Sort by column */
-    sort(column: string, direction?: SortDirection): this;
-
-    /** Sort by multiple columns */
-    sortMultiple(sorts: SortState[]): this;
-
-    /** Clear all sorting */
-    clearSort(): this;
-
-    /** Get current sort state */
-    getSortState(): SortState[];
-
-    // Filter Methods
-    /** Global search across all columns */
-    search(query: string): this;
-
-    /** Filter with a custom function */
-    filter(fn: (row: Record<string, any>, index: number) => boolean): this;
-
-    /** Filter by column value */
-    filterBy(column: string, value: any, operator?: FilterState['operator']): this;
-
-    /** Clear all filters */
-    clearFilters(): this;
-
-    /** Get current filter state */
-    getFilters(): FilterState[];
-
-    // Pagination Methods
-    /** Go to a specific page (1-indexed) */
-    page(pageNumber: number): this;
-
-    /** Set page size */
-    pageSize(size: number): this;
-
-    /** Go to next page */
-    nextPage(): this;
-
-    /** Go to previous page */
-    prevPage(): this;
-
-    /** Go to first page */
-    firstPage(): this;
-
-    /** Go to last page */
-    lastPage(): this;
-
-    /** Get pagination info */
-    pageInfo(): PageInfo;
-
-    // Selection Methods
-    /** Select row(s) by index */
-    select(index: number | number[]): this;
-
-    /** Deselect row(s) by index */
-    deselect(index: number | number[]): this;
-
-    /** Select all rows */
-    selectAll(): this;
-
-    /** Deselect all rows */
-    deselectAll(): this;
-
-    /** Toggle row selection */
-    toggleSelect(index: number): this;
-
-    /** Get selected row data */
-    getSelected(): Record<string, any>[];
-
-    /** Get selected row indices */
-    getSelectedIndices(): number[];
-
-    // Column Methods
-    /** Show a column */
-    showColumn(key: string): this;
-
-    /** Hide a column */
-    hideColumn(key: string): this;
-
-    /** Toggle column visibility */
-    toggleColumn(key: string): this;
-
-    /** Get column visibility state */
-    getColumnVisibility(): Record<string, boolean>;
-
-    /** Reorder columns */
-    reorderColumns(keys: string[]): this;
-
-    // Editing Methods
-    /** Edit a cell value */
-    editCell(rowIndex: number, column: string, value: any): this;
-
-    /** Get edited cells */
-    getEditedCells(): Array<{ row: number; column: string; value: any; originalValue: any }>;
-
-    /** Clear edit history */
-    clearEdits(): this;
-
-    // Export Methods
-    /** Export to CSV string */
-    toCSV(options?: { delimiter?: string; includeHeaders?: boolean }): string;
-
-    /** Export to JSON string */
-    toJSON(options?: { pretty?: boolean }): string;
-
-    /** Export to Excel-compatible format */
-    toExcel(): Blob;
-
-    /** Download export file */
-    download(format: ExportFormat, filename?: string): this;
-
-    /** Copy to clipboard */
-    copyToClipboard(format?: 'csv' | 'json'): Promise<boolean>;
-
-    // Event Methods
-    /** Subscribe to table events */
-    on(event: TableEventType, callback: TableEventCallback): this;
-
-    /** Unsubscribe from table events */
-    off(event: TableEventType, callback?: TableEventCallback): this;
-
-    /** Subscribe to event once */
-    once(event: TableEventType, callback: TableEventCallback): this;
-
-    // Rendering Methods
-    /** Force re-render */
-    render(): this;
-
-    /** Destroy the table instance */
-    destroy(): void;
-
-    // State Methods
-    /** Get current table state */
-    getState(): {
-        data: Record<string, any>[];
-        sort: SortState[];
-        filters: FilterState[];
-        page: PageInfo;
-        selected: number[];
-    };
-
-    /** Restore table state */
-    setState(state: Partial<ReturnType<TableInstance['getState']>>): this;
-}
-
-// ============================================
-// Tables Module
-// ============================================
-
-export interface Tables {
-    /** Create a new table instance */
-    create(selector: string | HTMLElement, options?: TableOptions): TableInstance;
-
-    /** Get an existing table instance */
-    get(selector: string | HTMLElement): TableInstance | undefined;
-
-    /** Destroy a table instance */
-    destroy(selector: string | HTMLElement): void;
-
-    /** Destroy all table instances */
-    destroyAll(): void;
-}
-
-export declare const tables: Tables;