veilkit 0.0.0-stage → 0.1.0

package/dist/controller-5OzP0U8X.d.cts

@@ -0,0 +1,193 @@
+import { P as ProgressProps, O as OverlayProps, S as SkeletonProps, d as VeilPrimitiveType, f as PresetProps, c as VeilGlobalConfig, A as AutoMeasureOptions, g as SkeletonController, b as SpinnerProps } from './types-Ciu5e5xt.cjs';
+import { createTheme, getThemeTokens } from './themes/index.cjs';
+
+/**
+ * Veilkit - Global Loading Manager
+ * Manages concurrent requests using request IDs and counter.
+ * Ensures loader remains active until all pending operations finish.
+ */
+type Listener = (isLoading: boolean, count: number) => void;
+declare class LoadingManager {
+    private activeIds;
+    private counter;
+    private listeners;
+    /**
+     * Start a loading operation. Optionally associate with a unique ID.
+     */
+    start(id?: string): string;
+    /**
+     * Complete a loading operation by ID or decrement counter.
+     */
+    stop(id?: string): void;
+    /**
+     * True if there is at least one active operation
+     */
+    isLoading(): boolean;
+    /**
+     * Current number of concurrent operations
+     */
+    getCount(): number;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: Listener): () => void;
+    /**
+     * Reset all active requests
+     */
+    reset(): void;
+    private notify;
+}
+declare const loadingManager: LoadingManager;
+
+/**
+ * Veilkit - Progress System
+ * Route Progress Bar (NProgress-style with auto-trickle) +
+ * Determinate & Indeterminate Linear and Circular Progress components
+ */
+
+declare class RouteProgressController {
+    private el;
+    private innerEl;
+    private currentProgress;
+    private trickleTimer;
+    private status;
+    private ensureDOM;
+    start(): void;
+    set(n: number): void;
+    inc(amount?: number): void;
+    private trickle;
+    private stopTrickle;
+    done(): void;
+    fail(): void;
+}
+declare const progressController: RouteProgressController;
+/**
+ * Creates an inline determinate or indeterminate Linear/Circular Progress element
+ */
+declare function createProgressElement(props?: ProgressProps): HTMLElement;
+
+/**
+ * Veilkit - Loading Overlay System
+ * Container-level and fullscreen blurred frosted overlays with spinner and message.
+ */
+
+declare class OverlayController {
+    /**
+     * Shows a loading overlay over a container element or fullscreen
+     */
+    show(target?: HTMLElement | string, props?: OverlayProps): HTMLElement;
+    /**
+     * Hides and removes the overlay
+     */
+    hide(target?: HTMLElement | string): void;
+}
+declare const overlayController: OverlayController;
+
+/**
+ * Veilkit - Skeleton Primitives
+ * Primitives: line, paragraph, heading, circle, rect, image, button, badge, icon, input, table-row, divider
+ */
+
+/**
+ * Creates a DOM skeleton element with applied styles, classes, and synced timing
+ */
+declare function createSkeletonElement(props?: SkeletonProps): HTMLElement;
+/**
+ * Creates multiple lines of text with natural varied widths
+ */
+declare function createSkeletonParagraph(lines?: number, props?: SkeletonProps): HTMLElement;
+/**
+ * Creates any primitive by type
+ */
+declare function createPrimitive(type: VeilPrimitiveType, props?: SkeletonProps): HTMLElement;
+
+/**
+ * Veilkit - Presets Engine
+ * 18 Ready-Made, Customizable, Responsive Skeleton Layout Presets
+ */
+
+declare function createPreset(props: PresetProps): HTMLElement;
+
+/**
+ * Veilkit - Request Tracker & Fetch Wrapper
+ * Automatic loading state tracking with anti-flicker and error resilience
+ */
+interface TrackOptions {
+    id?: string;
+    delay?: number;
+    minVisible?: number;
+    overlay?: boolean;
+    target?: HTMLElement | string;
+    progress?: boolean;
+    onStart?: () => void;
+    onFinish?: () => void;
+}
+/**
+ * Tracks a Promise or async function, updating loading states automatically
+ */
+declare function track<T>(task: Promise<T> | (() => Promise<T>), options?: TrackOptions): Promise<T>;
+/**
+ * Opt-in fetch wrapper that tracks HTTP requests automatically
+ * (Never patches global fetch by default)
+ */
+declare function wrapFetch(fetchFn?: typeof fetch, options?: TrackOptions): typeof fetch;
+
+/**
+ * Veilkit - Accessibility & Localization Engine
+ * Screen-reader announcements, polite live regions, and WCAG AA compliance
+ */
+/**
+ * Configure active localization language
+ */
+declare function setLocale(locale: string): void;
+/**
+ * Get current active locale
+ */
+declare function getLocale(): string;
+/**
+ * Register or override accessibility label strings
+ */
+declare function setLabels(labels: Record<string, string>): void;
+/**
+ * Resolves a localized label for screen readers
+ */
+declare function getLabel(key: 'loading' | 'loaded' | 'progress' | 'busy' | string): string;
+/**
+ * Marks a container element with accessible loading attributes
+ */
+declare function applyA11yLoading(container: HTMLElement, label?: string): HTMLElement;
+/**
+ * Clears accessible loading state from container
+ */
+declare function removeA11yLoading(container: HTMLElement): void;
+
+declare class VeilkitController {
+    private config;
+    /**
+     * Configure global defaults for themes, animations, anti-flicker, CSP nonce, and a11y
+     */
+    configure(config: VeilGlobalConfig): void;
+    /**
+     * Mounts a skeleton controller onto an element with show/hide/update/destroy methods
+     */
+    skeleton(target: HTMLElement | string, options?: SkeletonProps & AutoMeasureOptions): SkeletonController;
+    /**
+     * Injects a spinner into a target element
+     */
+    spinner(target: HTMLElement | string, props?: SpinnerProps): HTMLElement;
+    overlay: OverlayController;
+    progress: RouteProgressController;
+    manager: LoadingManager;
+    track: typeof track;
+    wrapFetch: typeof wrapFetch;
+    setLocale: typeof setLocale;
+    setLabels: typeof setLabels;
+    createTheme: typeof createTheme;
+    getThemeTokens: typeof getThemeTokens;
+    createSkeleton: typeof createSkeletonElement;
+    createPrimitive: typeof createPrimitive;
+    createPreset: typeof createPreset;
+}
+declare const veil: VeilkitController;
+
+export { LoadingManager as L, OverlayController as O, RouteProgressController as R, type TrackOptions as T, VeilkitController as V, applyA11yLoading as a, createPrimitive as b, createPreset as c, createProgressElement as d, createSkeletonElement as e, createSkeletonParagraph as f, getLabel as g, getLocale as h, setLocale as i, loadingManager as l, overlayController as o, progressController as p, removeA11yLoading as r, setLabels as s, track as t, veil as v, wrapFetch as w };

package/dist/controller-Co5bvnaB.d.ts

@@ -0,0 +1,193 @@
+import { P as ProgressProps, O as OverlayProps, S as SkeletonProps, d as VeilPrimitiveType, f as PresetProps, c as VeilGlobalConfig, A as AutoMeasureOptions, g as SkeletonController, b as SpinnerProps } from './types-Ciu5e5xt.js';
+import { createTheme, getThemeTokens } from './themes/index.js';
+
+/**
+ * Veilkit - Global Loading Manager
+ * Manages concurrent requests using request IDs and counter.
+ * Ensures loader remains active until all pending operations finish.
+ */
+type Listener = (isLoading: boolean, count: number) => void;
+declare class LoadingManager {
+    private activeIds;
+    private counter;
+    private listeners;
+    /**
+     * Start a loading operation. Optionally associate with a unique ID.
+     */
+    start(id?: string): string;
+    /**
+     * Complete a loading operation by ID or decrement counter.
+     */
+    stop(id?: string): void;
+    /**
+     * True if there is at least one active operation
+     */
+    isLoading(): boolean;
+    /**
+     * Current number of concurrent operations
+     */
+    getCount(): number;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: Listener): () => void;
+    /**
+     * Reset all active requests
+     */
+    reset(): void;
+    private notify;
+}
+declare const loadingManager: LoadingManager;
+
+/**
+ * Veilkit - Progress System
+ * Route Progress Bar (NProgress-style with auto-trickle) +
+ * Determinate & Indeterminate Linear and Circular Progress components
+ */
+
+declare class RouteProgressController {
+    private el;
+    private innerEl;
+    private currentProgress;
+    private trickleTimer;
+    private status;
+    private ensureDOM;
+    start(): void;
+    set(n: number): void;
+    inc(amount?: number): void;
+    private trickle;
+    private stopTrickle;
+    done(): void;
+    fail(): void;
+}
+declare const progressController: RouteProgressController;
+/**
+ * Creates an inline determinate or indeterminate Linear/Circular Progress element
+ */
+declare function createProgressElement(props?: ProgressProps): HTMLElement;
+
+/**
+ * Veilkit - Loading Overlay System
+ * Container-level and fullscreen blurred frosted overlays with spinner and message.
+ */
+
+declare class OverlayController {
+    /**
+     * Shows a loading overlay over a container element or fullscreen
+     */
+    show(target?: HTMLElement | string, props?: OverlayProps): HTMLElement;
+    /**
+     * Hides and removes the overlay
+     */
+    hide(target?: HTMLElement | string): void;
+}
+declare const overlayController: OverlayController;
+
+/**
+ * Veilkit - Skeleton Primitives
+ * Primitives: line, paragraph, heading, circle, rect, image, button, badge, icon, input, table-row, divider
+ */
+
+/**
+ * Creates a DOM skeleton element with applied styles, classes, and synced timing
+ */
+declare function createSkeletonElement(props?: SkeletonProps): HTMLElement;
+/**
+ * Creates multiple lines of text with natural varied widths
+ */
+declare function createSkeletonParagraph(lines?: number, props?: SkeletonProps): HTMLElement;
+/**
+ * Creates any primitive by type
+ */
+declare function createPrimitive(type: VeilPrimitiveType, props?: SkeletonProps): HTMLElement;
+
+/**
+ * Veilkit - Presets Engine
+ * 18 Ready-Made, Customizable, Responsive Skeleton Layout Presets
+ */
+
+declare function createPreset(props: PresetProps): HTMLElement;
+
+/**
+ * Veilkit - Request Tracker & Fetch Wrapper
+ * Automatic loading state tracking with anti-flicker and error resilience
+ */
+interface TrackOptions {
+    id?: string;
+    delay?: number;
+    minVisible?: number;
+    overlay?: boolean;
+    target?: HTMLElement | string;
+    progress?: boolean;
+    onStart?: () => void;
+    onFinish?: () => void;
+}
+/**
+ * Tracks a Promise or async function, updating loading states automatically
+ */
+declare function track<T>(task: Promise<T> | (() => Promise<T>), options?: TrackOptions): Promise<T>;
+/**
+ * Opt-in fetch wrapper that tracks HTTP requests automatically
+ * (Never patches global fetch by default)
+ */
+declare function wrapFetch(fetchFn?: typeof fetch, options?: TrackOptions): typeof fetch;
+
+/**
+ * Veilkit - Accessibility & Localization Engine
+ * Screen-reader announcements, polite live regions, and WCAG AA compliance
+ */
+/**
+ * Configure active localization language
+ */
+declare function setLocale(locale: string): void;
+/**
+ * Get current active locale
+ */
+declare function getLocale(): string;
+/**
+ * Register or override accessibility label strings
+ */
+declare function setLabels(labels: Record<string, string>): void;
+/**
+ * Resolves a localized label for screen readers
+ */
+declare function getLabel(key: 'loading' | 'loaded' | 'progress' | 'busy' | string): string;
+/**
+ * Marks a container element with accessible loading attributes
+ */
+declare function applyA11yLoading(container: HTMLElement, label?: string): HTMLElement;
+/**
+ * Clears accessible loading state from container
+ */
+declare function removeA11yLoading(container: HTMLElement): void;
+
+declare class VeilkitController {
+    private config;
+    /**
+     * Configure global defaults for themes, animations, anti-flicker, CSP nonce, and a11y
+     */
+    configure(config: VeilGlobalConfig): void;
+    /**
+     * Mounts a skeleton controller onto an element with show/hide/update/destroy methods
+     */
+    skeleton(target: HTMLElement | string, options?: SkeletonProps & AutoMeasureOptions): SkeletonController;
+    /**
+     * Injects a spinner into a target element
+     */
+    spinner(target: HTMLElement | string, props?: SpinnerProps): HTMLElement;
+    overlay: OverlayController;
+    progress: RouteProgressController;
+    manager: LoadingManager;
+    track: typeof track;
+    wrapFetch: typeof wrapFetch;
+    setLocale: typeof setLocale;
+    setLabels: typeof setLabels;
+    createTheme: typeof createTheme;
+    getThemeTokens: typeof getThemeTokens;
+    createSkeleton: typeof createSkeletonElement;
+    createPrimitive: typeof createPrimitive;
+    createPreset: typeof createPreset;
+}
+declare const veil: VeilkitController;
+
+export { LoadingManager as L, OverlayController as O, RouteProgressController as R, type TrackOptions as T, VeilkitController as V, applyA11yLoading as a, createPrimitive as b, createPreset as c, createProgressElement as d, createSkeletonElement as e, createSkeletonParagraph as f, getLabel as g, getLocale as h, setLocale as i, loadingManager as l, overlayController as o, progressController as p, removeA11yLoading as r, setLabels as s, track as t, veil as v, wrapFetch as w };