litegui.ts 1.0.0

package/dist/utilities.d.ts

@@ -0,0 +1,508 @@
+import { LiteGUIObject } from "./@types/globals";
+import { Dialog, DialogOptions } from "./dialog";
+/**
+ * Removes event listeners (assigned as properties) and references from a DOM element and its children.
+ * Used to help with garbage collection and memory leaks by breaking circular references.
+ * @function PurgeElement
+ * @param {HTMLElement} element The DOM element to purge.
+ */
+export declare function PurgeElement(element: HTMLElement): void;
+/**
+ * Basic object cloner. Copies own enumerable properties from original to target.
+ * @function CloneInsides
+ * @param {{ [key: string]: unknown }} [original] The source object to clone from.
+ * @param {{ [key: string]: unknown }} [target] The target object to copy to. If null, a new object is created.
+ * @returns {{ [key: string]: unknown }} The target object with copied properties.
+ */
+export declare function CloneInsides(original?: Record<string, unknown>, target?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Focuses an element.
+ * @function FocusElement
+ * @param {HTMLElement | Window} element The element to focus.
+ */
+export declare function FocusElement(element: HTMLElement | Window): void;
+/**
+ * Blurs an element.
+ * @function BlurElement
+ * @param {HTMLElement | Window} element The element to blur.
+ */
+export declare function BlurElement(element: HTMLElement | Window): void;
+/**
+ * Interface to hold a reference to an object property and its options.
+ */
+export interface InstanceHolder {
+    /** The instance object containing the property. */
+    instance: Record<string, unknown>;
+    /** The name of the property. */
+    name: string;
+    /** Options associated with the property. */
+    options?: Record<string, unknown>;
+}
+/**
+ * Tries to assign a value to the instance stored in an instance holder
+ * @function AssignValue
+ * @param {InstanceHolder} holder The instance holder containing the instance and property name.
+ * @param {string | null | unknown[] | unknown} value The value to assign.
+ */
+export declare function AssignValue(holder: InstanceHolder, value: string | null | unknown[] | unknown): void;
+/**
+ *  Extract all attributes from an instance (enumerable properties that are not function and a name starting with alphabetic character)
+ *
+ * @function CollectProperties
+ * @param {unknown} instance extract enumerable and public (name do not start with '_' ) properties from an object
+ * @returns {{[key:string]: unknown}} Object with "name" : value for every property
+ *
+ */
+export declare function CollectProperties(instance: unknown): {
+    [key: string]: unknown;
+};
+export declare function EscapeHtmlEntities(text: string): string;
+/**
+ * Syntax highlights a string of code by wrapping parts in HTML spans with classes.
+ * @function BeautifyCode
+ * @param {string} code The source code string to beautify.
+ * @param {string[]} reserved Array of reserved keywords to highlight.
+ * @param {boolean} skipCSS If true, suppresses the generation of the <style> block.
+ * @returns {string} The HTML string containing the beautified code.
+ */
+export declare function BeautifyCode(code: string, reserved: string[], skipCSS: boolean): string;
+/**
+ * Syntax highlights a JSON string or object by wrapping parts in HTML spans.
+ * @function BeautifyJSON
+ * @param {string | object} code The JSON string or object to beautify.
+ * @param {boolean} skipCSS If true, suppresses the generation of the <style> block.
+ * @returns {string} The HTML string containing the beautified JSON.
+ */
+export declare function BeautifyJSON(code: string, skipCSS: boolean): string;
+/**
+ * Converts a Data URI string into a Blob object.
+ * @function DataURItoBlob
+ * @param {string} dataURI The data URI string (e.g., "data:image/png;base64,...").
+ * @returns {Blob} The resulting Blob object.
+ */
+export declare function DataURItoBlob(dataURI: string): Blob;
+/**
+ * Converts an RGBA array to a HEXA color string.
+ * @function RGBAToHEXA
+ * @param {[number, number, number, number]} rgba Array containing r, g, b, a values.
+ * @returns {string} The HEXA color string (e.g., "#RRGGBBAA").
+ */
+export declare function RGBAToHEXA(rgba: [number, number, number, number]): string;
+/**
+ * Convert sizes in any format to a valid CSS format (number to string, negative number to calc( 100% - number px )
+ * @function SizeToCSS
+ * @param {string|Number} value
+ * @return {string|undefined} valid css size string
+ *
+ */
+export declare function SizeToCSS(value?: number | string): string | undefined;
+/**
+ * Triggers a simple event in an object (similar to jQuery.trigger)
+ * @function Trigger
+ * @param {unknown} element could be an HTMLEntity or a regular object
+ * @param {string} eventName the type of the event
+ * @param {unknown} params it will be stored in e.detail
+ */
+export declare function Trigger(element: unknown, eventName: string, params?: unknown): CustomEvent<unknown>;
+/**
+ * Interface for elements that can trigger events via a hidden __events property.
+ */
+export interface TriggerableElement {
+    /** Hidden event target for handling custom events. */
+    __events: EventTarget;
+}
+/**
+ * Interface for elements that can dispatch events.
+ */
+export interface DispatchableElement {
+    /** Dispatches a custom event. */
+    dispatchEvent: (event: CustomEvent<unknown>) => boolean;
+}
+/**
+ * Interface for objects that hold content within an HTMLDivElement.
+ */
+export interface ContentHolder {
+    /** The HTML container for the content. */
+    content: HTMLDivElement;
+}
+/**
+ * Interface mixing LiteGUIObject and HTMLElement, with an add function.
+ */
+export interface EmptyLiteGUIObject extends LiteGUIObject, HTMLElement {
+    /** Adds a child element or widget. */
+    add: (v: HTMLDivElement | LiteGUIObject) => void;
+}
+/**
+ * Interface mixing LiteGUIObject and HTMLButtonElement.
+ */
+export interface EmptyLiteGUIButton extends LiteGUIObject, HTMLButtonElement {
+}
+/**
+ * Interface for HTMLSpanElements that reference a widget.
+ */
+export interface TriggerableSpan extends HTMLSpanElement {
+    /** Reference to the widget associated with this span. */
+    widget: object;
+}
+/**
+ * Interface for script elements with additional metadata used by the core.
+ */
+export interface CoreScriptElement extends HTMLScriptElement {
+    /** The original source URL of the script. */
+    originalSrc: string;
+    /** The numeric index or identifier of the script. */
+    num: number;
+}
+/**
+ * Interface extending the standard Document to include parentWindow reference.
+ */
+export interface CoreDocument extends Document {
+    /** Reference to the parent window if applicable. */
+    parentWindow?: Window;
+}
+/**
+ * Remove from the interface, it is is an HTML element it is removed from its parent, if it is a widget the same.
+ * @function RemoveElement
+ * @param {string | LiteGUIObject | HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>} element it also supports HTMLentity, selector string or Array of elements
+ */
+export declare function RemoveElement(element: string | LiteGUIObject | HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>): void;
+/**
+ * Binds an event in an object (similar to jQuery.bind)
+ * If the element is not an HTML entity a new one is created, attached to the object (as non-enumerable, called __events) and used
+ * @function Bind
+ * @param {string | Object | Object[] | NodeListOf<HTMLElement>} element could be an HTMLEntity, a regular object, a query string or a regular Array of entities
+ * @param {String} event the string defining the event
+ * @param {EventListenerOrEventListenerObject} callback where to call
+ */
+export declare function Bind(element: string | object | object[] | NodeListOf<HTMLElement>, event: string, callback: EventListenerOrEventListenerObject): void;
+/**
+ * Unbinds an event in an object (similar to jQuery.unbind)
+ * @function Unbind
+ * @param {Object} element could be an HTMLEntity or a regular object
+ * @param {String} event the string defining the event
+ * @param {EventListenerOrEventListenerObject} callback where to call
+ */
+export declare function Unbind(element: HTMLElement | TriggerableElement, event: string, callback: EventListenerOrEventListenerObject): void;
+/**
+ * Removes a class
+ * @function RemoveClass
+ * @param {HTMLElement} elem
+ * @param {String} selector
+ * @param {String} className
+ */
+export declare function RemoveClass(elem: HTMLElement, selector: string, className?: string): void;
+/**
+ * Wrapper of document.getElementById
+ * @function GetById
+ * @param {String} id
+ * return {HTMLEntity}
+ *
+ */
+export declare function GetById(id: string): HTMLElement | null;
+/**
+ * Test if the cursor is inside an element
+ * @function IsCursorOverElement
+ * @param {MouseEvent} event
+ * @param {HTMLElement} element
+ *
+ */
+export declare function IsCursorOverElement(event: MouseEvent, element: HTMLElement): boolean;
+/**
+ * Returns the bounding client rect of an element.
+ * @function getRect
+ * @param {HTMLElement} element The element to measure.
+ * @returns {DOMRect} The bounding rectangle.
+ */
+export declare function GetRect(element: HTMLElement): DOMRect;
+/**
+ * Copy a string to the clipboard (it needs to be invoqued from a click event)
+ * @function ToClipboard
+ * @param {String | Record<string, unknown>} data
+ */
+export declare function ToClipboard(data: string | Record<string, unknown>): void;
+/**
+ * Insert some CSS code to the website
+ * @function AddCSS
+ * @param {String|CSSStyleDeclaration} code it could be a string with CSS rules, or an object with the style syntax.
+ *
+ */
+export declare function AddCSS(code: string | CSSStyleDeclaration): void;
+/**
+ * Requires a new CSS
+ * @function RequireCSS
+ * @param {String} url string with url or an array with several urls
+ * @param {Function} onComplete
+ *
+ */
+export declare function RequireCSS(url: string | Array<string>, onComplete: (ev: Event) => void): void;
+export interface RequestOptions {
+    url: string;
+    dataType: string;
+    mimeType?: string;
+    data?: Array<string>;
+    nocache?: boolean;
+    error?: (err: string | ProgressEvent<EventTarget>) => void;
+    success?: (data: unknown, xhr: XMLHttpRequest) => void;
+}
+/**
+ * Request file from url (it could be a binary, text, etc.). If you want a simplied version use
+ * @function Request
+ * @param {RequestOptions} request object with all the parameters like data (for sending forms), dataType, success, error
+ */
+export declare function Request(request: RequestOptions): XMLHttpRequest;
+/**
+ * Request file from url
+ * @function RequestText
+ * @param {String} url
+ * @param {(data: string, xhr: XMLHttpRequest) => void} onComplete
+ * @param {(err: string | ProgressEvent<EventTarget>) => void} onError
+ *
+ */
+export declare function RequestText(url: string, onComplete: (data: unknown | string, xhr: XMLHttpRequest) => void, onError: (err: string | ProgressEvent<EventTarget>) => void): XMLHttpRequest;
+/**
+ * Request file from url
+ * @function RequestJSON
+ * @param {String} url
+ * @param {(data: object, xhr: XMLHttpRequest) => void} onComplete
+ * @param {(err: string | ProgressEvent<EventTarget>) => void} onError
+ *
+ */
+export declare function RequestJSON(url: string, onComplete: (data: object | unknown, xhr: XMLHttpRequest) => void, onError: (err: string | ProgressEvent<EventTarget>) => void): XMLHttpRequest;
+/**
+ * Request binary file from url
+ * @function RequestBinary
+ * @param {String} url
+ * @param {(data: ArrayBuffer | unknown, xhr: XMLHttpRequest) => void} onComplete
+ * @param {(err: string | ProgressEvent<EventTarget>) => void} onError
+ *
+ */
+export declare function RequestBinary(url: string, onComplete: (data: ArrayBuffer | unknown, xhr: XMLHttpRequest) => void, onError: (err: string | ProgressEvent<EventTarget>) => void): XMLHttpRequest;
+/**
+ * Request script and inserts it in the DOM
+ * @function RequireScript
+ * @param {String|Array} url the url of the script or an array containing several urls
+ * @param {(scripts: Array<CoreScriptElement>) => void} onComplete
+ * @param {(err: string | Event, src: string, num: number) => void} onError
+ * @param {(src: string, num: number) => void} onProgress (if several files are required, onProgress is called after every file is added to the DOM)
+ *
+ */
+export declare function RequireScript(url: string | Array<string>, onComplete: (scripts: Array<CoreScriptElement>) => void, onError: (err: string | Event, src: string, num: number) => void, onProgress: (src: string, num: number) => void, version: number): void;
+/**
+ * Shows a generic message dialog.
+ * @function ShowMessage
+ * @param {string} content The message content.
+ * @param {DialogOptions} [options] Configuration options.
+ * @returns {Dialog} The created Dialog instance.
+ */
+export declare function ShowMessage(content: string, options?: DialogOptions): Dialog;
+/**
+ * Shows a dialog with a message
+ * @function PopupDialog
+ * @param {String} content
+ * @param {DialogOptions} [options]
+ * @returns {Dialog}
+ */
+export declare function PopupDialog(content: string, options?: DialogOptions): Dialog;
+/**
+ * Options for configuring message dialogs (alert, confirm, prompt).
+ */
+export interface MessageOptions {
+    /** Whether to show a textarea for input. */
+    textarea?: boolean;
+    /** Initial value for input fields. */
+    value?: string;
+    /** Custom CSS class name for the dialog. */
+    className?: string;
+    /** Title of the dialog. */
+    title?: string;
+    /** Width of the dialog in pixels. */
+    width?: number;
+    /** Height of the dialog in pixels. */
+    height?: number;
+    /** HTML content to display in the dialog. */
+    content?: string;
+    /** If true, the dialog cannot be closed by the user. */
+    noclose?: boolean;
+}
+/**
+ * Shows an alert dialog with a message
+ * @function AlertDialog
+ * @param {String} content
+ * @param {MessageOptions} [options]
+ * @returns {Dialog}
+ */
+export declare function AlertDialog(content: string, options?: MessageOptions): Dialog;
+/**
+ * Shows a confirm dialog with a message
+ * @function ConfirmDialog
+ * @param {String} content
+ * @param {(value: boolean) => void} callback
+ * @param {MessageOptions} [options]
+ * @returns {Dialog}
+ */
+export declare function ConfirmDialog(content: string, callback: (value: boolean) => void, options?: MessageOptions): Dialog;
+/**
+ * Shows a prompt dialog with a message
+ * @function PromptDialog
+ * @param {String} content
+ * @param {(value?: string) => void} callback
+ * @param {MessageOptions} [options]
+ * @returns {Dialog}
+ */
+export declare function PromptDialog(content: string, callback: (value?: string) => void, options?: MessageOptions): Dialog;
+/**
+ * Shows a choice dialog with a message
+ * @function ChoiceDialog
+ * @param {String} content
+ * @param {Array<string|ContentHolder>} choices
+ * @param {(value: string | ContentHolder) => void} callback
+ * @param {MessageOptions} [options]
+ * @returns {Dialog}
+ */
+export declare function ChoiceDialog(content: string, choices: Array<string | ContentHolder>, callback: (value: string | ContentHolder) => void, options?: MessageOptions): Dialog;
+/**
+ * Loads scripts sequentially from a list of URLs.
+ * @function RequireScriptSerial
+ * @param {string | string[]} url Single URL or array of URLs to load.
+ * @param {(loadedScripts: GlobalEventHandlers[]) => void} onComplete Callback when all scripts are loaded.
+ * @param {(url: string, remaining: number) => void} onProgress Callback for progress updates.
+ */
+export declare function RequireScriptSerial(url: string | string[], onComplete: (loadedScripts: GlobalEventHandlers[]) => void, onProgress: (url: string, remaining: number) => void): void;
+/**
+ * Creates an HTML element
+ * @function CreateElement
+ * @param {String} tag
+ * @param {String} classID string containing id and classes, example: "myid .someclass .anotherclass"
+ * @param {String} content
+ * @param {string | CSSStyleDeclaration} [style]
+ * @param {EventListenerOrEventListenerObject[]} [events]
+ */
+export declare function CreateElement(tag: string, classID: string, content: string, style?: string | CSSStyleDeclaration, events?: EventListenerOrEventListenerObject[]): EmptyLiteGUIObject;
+/**
+ * Useful to create elements from a text like '<div><span class="title"></span></div>' and an object like { ".title":"mytitle" }
+ * @function CreateListItem
+ * @param {String} code
+ * @param {Record<string, string>} values it will use innerText in the elements that matches that selector
+ * @param {CSSStyleDeclaration} style
+ * @return {HTMLElement}
+ *
+ */
+export declare function CreateListItem(code: string, values: Record<string, string>, style?: Partial<CSSStyleDeclaration> | Record<string, string>): HTMLSpanElement;
+/**
+ * Creates a button element
+ * @function CreateButton
+ * @param {String} classID ID or class
+ * @param {String} content
+ * @param {(ev: PointerEvent) => void} callback when the button is pressed
+ * @param {CSSStyleDeclaration|String} style
+ *
+ */
+export declare function CreateButton(classID: string, content: string, callback: (ev: PointerEvent) => void, style: CSSStyleDeclaration | string): EmptyLiteGUIButton;
+/**
+ * Retrieves all parent elements of the given element up to the document root.
+ * @function GetParents
+ * @param {HTMLElement} element The starting element.
+ * @returns {HTMLElement[]} Array of parent elements.
+ */
+export declare function GetParents(element: HTMLElement): Array<HTMLElement>;
+/**
+ * Opens a new window with copied styles and optional scripts.
+ * @function NewWindow
+ * @param {string} title syntax title for the new window.
+ * @param {number} width Width of the window.
+ * @param {number} height Height of the window.
+ * @param {{ scripts?: boolean, content?: string }} [options] Configuration object.
+ * @param {boolean} [options.scripts] Whether to copy scripts to the new window.
+ * @param {string} [options.content] HTML content to inject into the new window.
+ * @returns {Window} The newly created window object.
+ */
+export declare function NewWindow(title: string, width: number, height: number, options?: {
+    scripts?: boolean;
+    content?: string;
+}): Window;
+/**
+ * Triggers a download of the resource at the specified URL.
+ * @function DownloadURL
+ * @param {string} url The URL of the resource to download.
+ * @param {string} filename The name to save the file as.
+ */
+export declare function DownloadURL(url: string, filename: string): void;
+/**
+ * Triggers a download of a File or Blob object.
+ * @function DownloadFile
+ * @param {string} filename The name to save the file as.
+ * @param {File | Blob} data The file data.
+ * @param {string} dataType MIME type of the data if not specified in the Blob.
+ */
+export declare function DownloadFile(filename: string, data: File | Blob, dataType: string): void;
+/**
+ * Returns the URL vars ( ?foo=faa&foo2=etc )
+ * @function GetUrlVars
+ *
+ */
+export declare function GetUrlVars(): Array<string>;
+/**
+ * Retrieves a specific query parameter from the URL.
+ * @function GetUrlVar
+ * @param {string} name The name of the parameter.
+ * @returns {string} The value of the parameter.
+ */
+export declare function GetUrlVar(name: string): string;
+/**
+ * Makes one element draggable
+ * @function Draggable
+ * @param {HTMLElement} container the element that will be dragged
+ * @param {HTMLElement} dragger the area to start the dragging
+ * @param {(container: HTMLElement, e: MouseEvent) => void} onStart Callback when the dragging starts.
+ * @param {(container: HTMLElement, e: MouseEvent) => void} onFinish Callback when the dragging finishes.
+ * @param {(container: HTMLElement, e: MouseEvent) => boolean} onIsDraggable Callback to determine if the element is currently draggable.
+ */
+export declare function Draggable(container: HTMLElement, dragger?: HTMLElement, onStart?: (container: HTMLElement, e: MouseEvent) => void, onFinish?: (container: HTMLElement, e: MouseEvent) => void, onIsDraggable?: (container: HTMLElement, e: MouseEvent) => boolean): void;
+/**
+ * Clones object content
+ * @function CloneObject
+ * @param {Object} source
+ * @param {Object} target
+ *
+ */
+export declare function CloneObject(source: any, target: any): any;
+/**
+ * Removing spaces and dots from a string.
+ * @function SafeName
+ * @param {string} str The input string.
+ * @returns {string} The sanitized string.
+ */
+export declare function SafeName(str: string): string;
+/**
+ * Encodes an HTML string by replacing special characters with unicode.
+ * @function HTMLEncode
+ * @param {string} htmlCode The HTML string to encode.
+ * @returns {string} The encoded string (text content).
+ */
+export declare function HTMLEncode(htmlCode: string): string;
+/**
+ * Decodes a unicode string back to HTML.
+ * @function HTMLDecode
+ * @param {string} unicodeCharacter The string to decode.
+ * @returns {string} The decoded HTML string.
+ */
+export declare function HTMLDecode(unicodeCharacter: string): string;
+/**
+ * Returns the window where this element is attached (used in multi window applications)
+ * @function GetElementWindow
+ * @param {HTMLElement} element
+ * @return {Window} the window element
+ *
+ */
+export declare function GetElementWindow(element: HTMLElement): Window | undefined;
+/**
+ * Helper, makes drag and drop easier by enabling drag and drop in a given element
+ * @function CreateDropArea
+ * @param {HTMLElement} element the element where users could drop items
+ * @param {(evt: DragEvent) => boolean} onDrop function to call when the user drops the item
+ * @param {(evt: DragEvent, element: HTMLElement) => void} onEnter [optional] function to call when the user drags something inside
+ * @param {(evt: DragEvent, element: HTMLElement) => void} onExit [optional] function to call when the user drags something outside
+ *
+ */
+export declare function CreateDropArea(element: HTMLElement, onDrop: (evt: DragEvent) => boolean, onEnter?: (evt: DragEvent, element: HTMLElement) => void, onExit?: (evt: DragEvent, element: HTMLElement) => void): void;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}

package/dist/widgets/button.d.ts

@@ -0,0 +1,33 @@
+import { LiteGUIObject } from "../@types/globals";
+/**
+ * The options for the standard button class construction.
+ */
+export interface ButtonOptions {
+    /**
+     * Callback function to be executed when the button is clicked.
+     */
+    callback?: () => void;
+}
+/**
+ * Standard button class.
+ * @class Button
+ */
+export declare class Button implements LiteGUIObject {
+    /** Root element of the widget */
+    root: HTMLDivElement;
+    /** Button element inside the root */
+    content: HTMLButtonElement;
+    /** Callback function to be executed when the button is clicked */
+    callback?: () => void;
+    /**
+     * Creates an instance of the Button widget.
+     * @param {string} value - The text to be displayed on the button.
+     * @param {ButtonOptions | Function} [options] - Configuration options or a callback function.
+     */
+    constructor(value: string, options?: (() => void) | ButtonOptions);
+    /**
+     * Triggers the click event on the button.
+     */
+    click(): void;
+}
+//# sourceMappingURL=button.d.ts.map

package/dist/widgets/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/widgets/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,MAAO,YAAW,aAAa;IAE3C,iCAAiC;IAC1B,IAAI,EAAE,cAAc,CAAC;IAC5B,qCAAqC;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAClC,kEAAkE;IAC3D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAE7B;;;;OAIG;gBACS,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,CAAC,MAAM,IAAI,CAAC,GAAG,aAAkB;IAsBrE;;OAEG;IACH,KAAK;CAIL"}

package/dist/widgets/checkbox.d.ts

@@ -0,0 +1,36 @@
+import { LiteGUIObject } from "../@types/globals";
+/**
+ * Standard checkbox class.
+ * @class Checkbox
+ */
+export declare class Checkbox implements LiteGUIObject {
+    /** Root element of the widget */
+    root: HTMLSpanElement;
+    /** Current value of the checkbox */
+    value: boolean;
+    /** Element representing the checkbox state */
+    element: HTMLSpanElement;
+    /** Callback function executed when value changes */
+    onChange: (value: boolean) => void;
+    /**
+     * Creates an instance of the Checkbox widget.
+     * @param {boolean} value - Initial value.
+     * @param {Function} onChange - Callback function when value changes.
+     */
+    constructor(value: boolean, onChange: (value: boolean) => void);
+    /**
+     * Sets the value of the checkbox.
+     * @param {boolean} value - New value.
+     */
+    setValue(value: boolean): void;
+    /**
+     * Gets the current value of the checkbox.
+     * @returns {boolean} The current value.
+     */
+    getValue(): boolean;
+    /**
+     * Handles click event to toggle value.
+     */
+    onClick(): void;
+}
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/widgets/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../src/widgets/checkbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,qBAAa,QAAS,YAAW,aAAa;IAE7C,iCAAiC;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnC;;;;OAIG;gBACS,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAe9D;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO;IAuBvB;;;OAGG;IACH,QAAQ;IAKR;;OAEG;IACH,OAAO;CAIP"}