domma-js 0.55.0 → 0.57.0

package/assets/types/flags.d.ts

@@ -1,130 +0,0 @@
-/**
- * Domma Flags Module - TypeScript Declarations
- * Nation flags as inline SVG, keyed by ISO 3166-1 alpha-2 code.
- *
- * Opt-in module: load domma-flags.min.js after domma.min.js.
- * Exposes the FL global and Domma.flags / Domma.FL.
- */
-
-export type FlagRegion = 'europe' | 'americas' | 'africa' | 'asia' | 'oceania' | string;
-
-export type FlagShape = 'rect' | 'rounded' | 'square' | 'circle';
-
-/** A single overlay primitive used to compose a flag. */
-export interface FlagOverlay {
-    type: 'rect' | 'circle' | 'ellipse' | 'line' | 'path' | 'star' | 'crescent' | 'group';
-    fill?: string;
-    stroke?: string;
-    strokeWidth?: number;
-    [key: string]: unknown;
-}
-
-/** A flag definition - either raw SVG markup or a compact descriptor. */
-export interface FlagDefinition {
-    /** Country name */
-    name: string;
-    /** Region group (defaults to 'custom' when registered) */
-    region?: FlagRegion;
-    /** Raw inner SVG markup (60×40 canvas) */
-    svg?: string;
-    /** Solid background colour */
-    bg?: string;
-    /** Stripe descriptor */
-    stripes?: {
-        dir?: 'h' | 'v';
-        colors: string[];
-        weights?: number[];
-    };
-    /** Nordic (offset) cross descriptor */
-    cross?: {
-        bg: string;
-        colour: string;
-        border?: string;
-        thickness?: number;
-    };
-    /** Overlay primitives drawn on top */
-    overlays?: FlagOverlay[];
-}
-
-/** Options for rendering a flag. */
-export interface FlagRenderOptions {
-    /** Height in px; width follows the 3:2 aspect (default 24) */
-    size?: number;
-    /** Explicit width override */
-    width?: number;
-    /** Explicit height override */
-    height?: number;
-    /** Output shape (default 'rect') */
-    shape?: FlagShape;
-    /** Add a hairline border; pass a colour string to customise */
-    border?: boolean | string;
-    /** Extra CSS classes */
-    class?: string;
-    /** Accessible title (defaults to the country name) */
-    title?: string;
-    /** Additional SVG attributes */
-    attrs?: Record<string, string>;
-}
-
-export interface FlagInjectOptions extends FlagRenderOptions {
-    /** Where to place the flag relative to the target (default 'prepend') */
-    position?: 'prepend' | 'append' | 'replace';
-}
-
-export interface FlagRegionMeta {
-    name: string;
-    description?: string;
-    codes: string[];
-}
-
-/** The flag registry (FL / Domma.flags). */
-export interface Flags {
-    /** Render a flag as an SVG element. */
-    render(code: string, options?: FlagRenderOptions): SVGElement | null;
-
-    /** Get a flag as an HTML string. */
-    html(code: string, options?: FlagRenderOptions): string;
-
-    /** Inject a flag into a target element or selector. */
-    inject(target: string | HTMLElement, code: string, options?: FlagInjectOptions): SVGElement | null;
-
-    /** Replace all [data-flag] elements within a container with SVGs. */
-    scan(container?: HTMLElement | string): number;
-
-    /** Register (or override) a flag. */
-    register(code: string, definition: FlagDefinition): Flags;
-
-    /** Remove a registered flag. */
-    unregister(code: string): boolean;
-
-    /** Whether a flag exists. */
-    has(code: string): boolean;
-
-    /** Get a flag definition. */
-    get(code: string): FlagDefinition | null;
-
-    /** Get the country name for a code. */
-    name(code: string): string | null;
-
-    /** List flag codes, optionally filtered by region. */
-    list(region?: FlagRegion): string[];
-
-    /** List all regions with metadata. */
-    listRegions(): Record<string, FlagRegionMeta>;
-
-    /** Total number of flags. */
-    count(): number;
-
-    /** Search flags by code or country name. */
-    search(query: string): string[];
-}
-
-export const flags: Flags;
-
-declare global {
-    /**
-     * FL - Domma Flags (opt-in module)
-     * Nation flags as inline SVG, keyed by ISO 3166-1 alpha-2 code.
-     */
-    const FL: Flags;
-}

package/assets/types/http.d.ts

@@ -1,97 +0,0 @@
-/**
- * Domma HTTP Module - TypeScript Declarations
- * Fetch-based HTTP client
- */
-
-export interface RequestOptions extends Omit<RequestInit, 'body'> {
-    /** Request body - will be JSON.stringify'd if object */
-    body?: any;
-    /** Request headers */
-    headers?: Record<string, string>;
-    /** Request timeout in ms */
-    timeout?: number;
-    /** Base URL to prepend */
-    baseUrl?: string;
-    /** Query parameters */
-    params?: Record<string, string | number | boolean>;
-}
-
-export interface HttpResponse<T = any> {
-    /** Response data */
-    data: T;
-    /** HTTP status code */
-    status: number;
-    /** Status text */
-    statusText: string;
-    /** Response headers */
-    headers: Headers;
-    /** Original response object */
-    response: Response;
-}
-
-export interface Http {
-    /**
-     * Make a generic HTTP request
-     * @param url - Request URL
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    request<T = any>(url: string, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Make a GET request
-     * @param url - Request URL
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    get<T = any>(url: string, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Make a POST request
-     * @param url - Request URL
-     * @param data - Request body data
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    post<T = any>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Make a PUT request
-     * @param url - Request URL
-     * @param data - Request body data
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    put<T = any>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Make a PATCH request
-     * @param url - Request URL
-     * @param data - Request body data
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    patch<T = any>(url: string, data?: any, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Make a DELETE request
-     * @param url - Request URL
-     * @param options - Request options
-     * @returns Promise resolving to response data
-     */
-    delete<T = any>(url: string, options?: RequestOptions): Promise<T>;
-
-    /**
-     * Set default options for all requests
-     * @param options - Default options to apply
-     */
-    setDefaults(options: RequestOptions): void;
-
-    /**
-     * Get current default options
-     * @returns Default options object
-     */
-    getDefaults(): RequestOptions;
-}
-
-export declare const http: Http;

package/assets/types/icons.d.ts

@@ -1,147 +0,0 @@
-/**
- * Domma Icons Module - TypeScript Declarations
- * SVG icon library with categories and rendering
- */
-
-export type IconCategory =
-    | 'ui'
-    | 'navigation'
-    | 'media'
-    | 'communication'
-    | 'files'
-    | 'social'
-    | 'status'
-    | 'commerce';
-
-export interface IconDefinition {
-    /** SVG path or full SVG content */
-    svg: string;
-    /** Icon category */
-    category?: IconCategory;
-    /** Icon tags for search */
-    tags?: string[];
-    /** ViewBox dimensions */
-    viewBox?: string;
-}
-
-export interface RenderOptions {
-    /** Icon size in pixels or CSS value */
-    size?: number | string;
-    /** Icon colour */
-    color?: string;
-    /** Additional CSS class */
-    className?: string;
-    /** Additional inline styles */
-    style?: Record<string, string>;
-    /** Accessible label */
-    ariaLabel?: string;
-    /** Custom attributes */
-    attrs?: Record<string, string>;
-}
-
-export interface Icons {
-    /**
-     * Render an icon as an SVG element
-     * @param name - Icon name
-     * @param options - Render options
-     * @returns SVG element or null if not found
-     */
-    render(name: string, options?: RenderOptions): SVGElement | null;
-
-    /**
-     * Get icon as HTML string
-     * @param name - Icon name
-     * @param options - Render options
-     * @returns SVG HTML string or empty string if not found
-     */
-    html(name: string, options?: RenderOptions): string;
-
-    /**
-     * Inject icon into a DOM element
-     * @param selector - Target element selector or element
-     * @param name - Icon name
-     * @param options - Render options
-     * @returns The target element or null
-     */
-    inject(selector: string | HTMLElement, name: string, options?: RenderOptions): HTMLElement | null;
-
-    /**
-     * Scan DOM for icon placeholders and inject icons
-     * @param container - Container to scan (default: document)
-     * @param attribute - Data attribute to look for (default: 'data-icon')
-     * @returns Number of icons injected
-     */
-    scan(container?: HTMLElement | Document, attribute?: string): number;
-
-    /**
-     * Register a custom icon
-     * @param name - Icon name
-     * @param definition - Icon definition (SVG string or full definition)
-     */
-    register(name: string, definition: string | IconDefinition): void;
-
-    /**
-     * Unregister an icon
-     * @param name - Icon name
-     * @returns true if icon was removed
-     */
-    unregister(name: string): boolean;
-
-    /**
-     * Check if an icon exists
-     * @param name - Icon name
-     * @returns true if icon exists
-     */
-    has(name: string): boolean;
-
-    /**
-     * Get icon definition
-     * @param name - Icon name
-     * @returns Icon definition or undefined
-     */
-    get(name: string): IconDefinition | undefined;
-
-    /**
-     * List all icon names
-     * @param category - Optional category filter
-     * @returns Array of icon names
-     */
-    list(category?: IconCategory): string[];
-
-    /**
-     * List all categories
-     * @returns Array of category names
-     */
-    listCategories(): IconCategory[];
-
-    /**
-     * Get total icon count
-     * @param category - Optional category filter
-     * @returns Number of icons
-     */
-    count(category?: IconCategory): number;
-
-    /**
-     * Search icons by name or tags
-     * @param query - Search query
-     * @returns Array of matching icon names
-     */
-    search(query: string): string[];
-
-    /**
-     * Create an SVG sprite sheet
-     * @param icons - Array of icon names (default: all icons)
-     * @returns SVG sprite element
-     */
-    createSprite(icons?: string[]): SVGElement;
-
-    /**
-     * Use an icon from a sprite sheet
-     * @param name - Icon name
-     * @param options - Render options
-     * @returns SVG use element HTML string
-     */
-    use(name: string, options?: RenderOptions): string;
-}
-
-export declare const icons: Icons;

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;