domma-js 0.56.0 → 0.58.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/i18n.d.ts

@@ -1,99 +0,0 @@
-/**
- * Domma i18n Module - TypeScript Declarations
- * Translations, plurals and Intl formatting: `Domma.i18n`, plus `Domma.t()`.
- */
-
-/** A plural message: chosen by `params.count`; `=N` keys match exactly, `zero` matches 0. */
-export interface I18nPluralForms {
-    zero?: string;
-    one?: string;
-    two?: string;
-    few?: string;
-    many?: string;
-    other: string;
-    /** Use ordinal rules (1st, 2nd, 3rd...) */
-    ordinal?: boolean;
-    [exact: `=${number}`]: string;
-}
-
-/** A select message: `select` names the param whose value picks the form; `other` otherwise. */
-export interface I18nSelectForms {
-    select: string;
-    other: string;
-    [value: string]: string;
-}
-
-/** Nested message tree; nesting becomes dot keys. */
-export interface I18nMessages {
-    [key: string]: string | number | boolean | I18nPluralForms | I18nSelectForms | I18nMessages;
-}
-
-export interface I18nTranslateOptions {
-    /** Translate in this locale instead of the current one */
-    locale?: string;
-    /** Returned (interpolated) when the key is missing, instead of the key */
-    default?: string;
-    /** Choose plural forms by ordinal rules */
-    ordinal?: boolean;
-}
-
-export interface I18nDetectOptions {
-    /** Sources in order. Default ['storage', 'navigator', 'html'] */
-    from?: Array<'storage' | 'navigator' | 'html'>;
-    /** S key: read in 'storage', and every later locale(code) is saved there */
-    storageKey?: string;
-    /** Only these locales (or their base language) are accepted */
-    supported?: string[];
-    /** Used when nothing matches (else the current locale stays) */
-    fallback?: string;
-    /** Set the found locale (default true) */
-    apply?: boolean;
-}
-
-export interface I18nChangeDetail { locale: string; previous: string; }
-export interface I18nMissingDetail { key: string; locale: string; }
-export interface I18nLoadedDetail { locale: string; messages: I18nMessages; }
-
-type WithLocale<T> = T & { locale?: string };
-
-export interface I18n {
-    /** Add (merge) messages for a locale */
-    add(locale: string, messages: I18nMessages): I18n;
-    /** Load JSON via H.get (`{locale}` in the URL is replaced) or a loader. Cached and deduped. */
-    load(locale: string, source: string | ((locale: string) => Promise<I18nMessages> | I18nMessages), options?: { reload?: boolean }): Promise<I18nMessages>;
-    /** Current locale */
-    locale(): string;
-    /** Set the locale: fires change, sets <html lang dir>, re-translates the document */
-    locale(code: string): string;
-    /** Fallback locales searched after the current one */
-    fallback(codes?: string | string[]): string[];
-    has(key: string, options?: { locale?: string }): boolean;
-    /** Plain text: params are not escaped */
-    t(key: string, params?: Record<string, any> | null, options?: I18nTranslateOptions): string;
-    /** HTML: the message's markup is kept, params are escaped */
-    html(key: string, params?: Record<string, any> | null, options?: I18nTranslateOptions): string;
-    /** Hook for a missing key; a returned string is used as the translation */
-    onMissing(fn: ((key: string, locale: string) => string | void) | null): I18n;
-    on(event: 'change', fn: (detail: I18nChangeDetail) => void): () => void;
-    on(event: 'missing', fn: (detail: I18nMissingDetail) => void): () => void;
-    on(event: 'loaded', fn: (detail: I18nLoadedDetail) => void): () => void;
-    off(event: 'change' | 'missing' | 'loaded', fn?: (...args: any[]) => void): I18n;
-    /** Locales that have messages */
-    locales(): string[];
-    /** Text direction of a locale (default: the current one) */
-    dir(code?: string): 'rtl' | 'ltr';
-    /** Fill [data-i18n], [data-i18n-html] (sanitised) and [data-i18n-attr] under root */
-    translate(root?: Element | Document | string | ArrayLike<Element>): number;
-    /** Pick and set a locale from storage / navigator / <html lang> */
-    detect(options?: I18nDetectOptions): string;
-    number(n: number | bigint, opts?: WithLocale<Intl.NumberFormatOptions>): string;
-    currency(n: number | bigint, code: string, opts?: WithLocale<Intl.NumberFormatOptions>): string;
-    /** Date, timestamp, string or a D() wrapper; '' when invalid */
-    date(d: Date | number | string | { toDate(): Date }, opts?: WithLocale<Intl.DateTimeFormatOptions>): string;
-    relative(value: number, unit: Intl.RelativeTimeFormatUnit, opts?: WithLocale<Intl.RelativeTimeFormatOptions>): string;
-    list(items: Iterable<string>, opts?: WithLocale<{ type?: 'conjunction' | 'disjunction' | 'unit'; style?: 'long' | 'short' | 'narrow' }>): string;
-    /** Forget all messages, loads, listeners and settings */
-    reset(): I18n;
-}
-
-export declare const i18n: I18n;

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;