litegui.ts 1.0.0

package/dist/inspector/inspector.d.ts

@@ -0,0 +1,350 @@
+import type { HTMLDivElementOptions, InspectorSection, InspectorValue, InspectorWidget, InspectorWidgetTypes, GenericCreationOptions, AppendOptions, CreateWidgetOptions, ProcessElementOptions, WidgetChangeOptions, InspectorOptions, BeginGroupOptions, AddTitleOptions, AddContainerOptions, InspectorContainer, InspectorGroupWidget } from "../@types/Inspector";
+import { LiteGUIObject } from "../@types/globals";
+/**
+ * Inspector class for creating property inspectors.
+ * @class Inspector
+ * @example
+ * ```typescript
+ * const inspector = new Inspector();
+ * inspector.add("string", "Name", "unnamed");
+ * inspector.appendTo(document.body);
+ * ```
+ */
+export declare class Inspector implements LiteGUIObject {
+    /**
+     * The root HTML element of the inspector.
+     */
+    root: HTMLDivElement;
+    /**
+     * List of sections within the inspector.
+     */
+    sections: InspectorSection[];
+    /**
+     * Map of values managed by the inspector.
+     */
+    values: Map<string, InspectorValue>;
+    /**
+     * List of all widgets in the inspector.
+     */
+    widgets: InspectorWidget[];
+    /**
+     * Map of widgets indexed by their name.
+     */
+    widgetsByName: Map<string, InspectorWidget>;
+    /**
+     * Internal row counter for styling even/odd rows.
+     */
+    rowNumber: number;
+    /**
+     * Width of the name column.
+     */
+    nameWidth?: number;
+    /**
+     * Default width for widgets.
+     */
+    widgetsWidth?: number;
+    /**
+     * Current tab index for accessibility.
+     */
+    tabIndex: number;
+    /**
+     * Callback triggered when any value in the inspector changes.
+     */
+    onChange?: (name?: string, value?: InspectorValue, element?: InspectorWidget) => void;
+    /**
+     * CSS class name for the root element.
+     */
+    className: string;
+    /**
+     * Number of widgets to display per row.
+     */
+    widgetsPerRow: number;
+    /**
+     * If true, displays the inspector in a single line.
+     */
+    oneLine?: boolean | null;
+    /**
+     * The currently active section.
+     */
+    currentSection?: InspectorSection;
+    /**
+     * Stack of active containers.
+     * @private
+     */
+    private _currentContainerStack;
+    /**
+     * The current container where widgets are appended.
+     * @private
+     */
+    private _currentContainer?;
+    /**
+     * Callback triggered to refresh the inspector.
+     */
+    onRefresh?: () => void;
+    /**
+     * Hook called when a property is added.
+     */
+    onAddProperty?: (name: string, instance: unknown, varname: string | number, value: unknown, options?: unknown) => void;
+    /**
+     * Name of the inspector instance.
+     */
+    name: string;
+    /**
+     * Configuration options.
+     */
+    options: InspectorOptions;
+    /**
+     * Height of the inspector.
+     */
+    height?: string | number;
+    /**
+     * Counter for generating unique names for empty widgets.
+     */
+    emptyWidgetIndex: number;
+    /**
+     * Creates an instance of the Inspector.
+     * @param {InspectorOptions} [options] Configuration options.
+     */
+    constructor(options?: InspectorOptions);
+    /**
+     * Retrieves all values from the widgets in the inspector.
+     * @returns {Map<string, InspectorValue>} A map of widget names to their values.
+     */
+    getValues(): Map<string, InspectorValue>;
+    /**
+     * Sets values for multiple widgets in the inspector.
+     * @param {{ [key: string]: InspectorValue }} values An object where keys are widget names and values are the new values.
+     */
+    setValues(values: {
+        [key: string]: InspectorValue;
+    }): void;
+    /**
+     * Appends the inspector to a parent element.
+     * @param {HTMLElement | string} parent The parent element or its selector string.
+     * @param {boolean} [atFront] If true, inserts the inspector at the beginning of the parent.
+     */
+    appendTo(parent?: HTMLElement | string, atFront?: boolean): void;
+    /**
+     * Removes all the widgets inside the inspector
+     */
+    clear(): void;
+    /**
+     * Tries to refresh (calls on_refresh)
+     */
+    refresh(): void;
+    /**
+     * Append widget to this inspector
+     * @param {InspectorWidget} widget The widget to append.
+     * @param {AppendOptions} options Configuration options for appending.
+     */
+    appendWidget(widget: InspectorWidget, options?: AppendOptions): void;
+    /**
+     * Pushes a container onto the stack, making it the current active container for new widgets.
+     * @param {InspectorContainer} container The container element to push.
+     */
+    pushContainer(container: InspectorContainer): void;
+    /**
+     * Checks if a container is currently in the stack.
+     * @param {InspectorContainer} container The container to check.
+     * @returns {boolean} True if the container is in the stack.
+     */
+    isContainerInStack(container: InspectorContainer): boolean;
+    /**
+     * Pops a container from the stack, reverting to the previous container.
+     * @param {HTMLElement} [container] Optional specific container to pop up to.
+     */
+    popContainer(container?: HTMLElement): void;
+    /**
+     * Configures the inspector with a list of widget creation options.
+     * @param {GenericCreationOptions[]} info Array of widget configuration objects.
+     */
+    setup(info: GenericCreationOptions[]): void;
+    /**
+     * Returns the widget given the name.
+     * @param {string | number} name The name of the widget supplied when creating it or the index of the widget.
+     * @returns {InspectorWidget | undefined} The widget object or undefined if not found.
+     */
+    getWidget(name: string | number): InspectorWidget | undefined;
+    /**
+     * Inspects an instance and creates widgets for its properties.
+     * @param {unknown} instance The instance that you want to inspect, attributes will be collected from this object.
+     * @param {{[key:string]: unknown}} [properties] An object with all the names of the properties you want to inspect.
+     *		  If not specified then it calls getProperties, otherwise collect them and tries to guess the type.
+     * @param {{ [key: string]: unknown }} [propertiesInfoExample] It overwrites the info about properties found in the object (in case the automatically guessed type is wrong).
+     * @param {string[]} [skipProperties] This properties will be ignored.
+     */
+    inspectInstance(instance: Record<string, unknown>, properties?: Record<string, unknown>, propertiesInfoExample?: Record<string, unknown>, skipProperties?: string[]): void;
+    /**
+     * Adds the widgets for the properties specified in the info of instance, it will create callback and onUpdate.
+     * @param {any} instance The instance that you want to inspect.
+     * @param {{[key:string]:GenericCreationOptions|undefined}} info Object containing "property name" :{ type: value, widget:..., min:..., max:... } or just "property":"type".
+     * @param {string[]} [skipProperties] These properties will be ignored.
+     */
+    showProperties(instance: Record<string, unknown>, info: {
+        [key: string]: GenericCreationOptions | undefined;
+    }, skipProperties?: string[]): void;
+    /**
+     * Used by all widgets to create the container of one widget.
+     * @param {string} [name] The string to show at the left side of the widget, if null this element wont be created and the value part will use the full width.
+     * @param {string | number | boolean | HTMLElement} [content] The string with the html of the elements that conform the interactive part of the widget.
+     * @param {CreateWidgetOptions} [options] Some generic options that any widget could have:
+     * - widgetName: the name used to store this widget in the widgetsByName container, if omitted the parameter name is used
+     * - width: the width of the widget (if omitted it will use the Inspector widgetsWidth, otherwise 100%
+     * - nameWidth: the width of the name part of the widget, if not specified it will use Inspector nameWidth, otherwise css default
+     * - contentWidth: the width of the widget content area
+     * - preTitle: string to append to the left side of the name, this is helpful if you want to add icons with behaviour when clicked
+     * - title: string or string[] to replace the name, sometimes you want to supply a different name than the one you want to show (this is helpful to retrieve values from an inspector)
+     * @returns {InspectorWidget} The created widget element.
+     */
+    createWidget(name?: string, content?: string | number | boolean | HTMLElement, options?: CreateWidgetOptions): InspectorWidget;
+    /**
+     * Internal method called when a widget's value changes.
+     * Handles callbacks, events, and value updates.
+     * @param {InspectorWidget} element The widget element.
+     * @param {string} name The name of the value/widget.
+     * @param {InspectorValue} value The new value.
+     * @param {WidgetChangeOptions} options Options containing callbacks.
+     * @param {boolean} [expand_value] If true and value is array, spreads arguments applied to callback.
+     * @param {Event} [event] The original event that triggered the change.
+     * @returns {any} The result of the callback.
+     */
+    onWidgetChange(element: InspectorWidget, name: string, value: InspectorValue, options: WidgetChangeOptions, expand_value?: boolean, event?: Event): void;
+    /**
+     * Resolves the proper name for a value/widget, generating a unique one if missing.
+     * @param {string} [widgetName] The proposed name.
+     * @param {GenericCreationOptions} [options] Options potentially containing a widget_name.
+     * @returns {string} The resolved name.
+     */
+    getValueName(widgetName?: string, options?: GenericCreationOptions): string;
+    /**
+     * Registry of available widget constructors.
+     * Maps widget type strings to function names or instances.
+     */
+    static widgetConstructors: {
+        [key: string]: string | ((name?: string, value?: InspectorValue, options?: CreateWidgetOptions) => InspectorWidget);
+    };
+    /**
+     * Registers a new custom widget type.
+     * @param {string} name The type name of the widget.
+     * @param {string | Function} constructor The constructor function or method name.
+     */
+    static registerWidget(name: string, constructor: string | ((name?: string, value?: InspectorValue, options?: CreateWidgetOptions) => InspectorWidget)): void;
+    /**
+     * Unregisters a widget type.
+     * @param {string} name The type name of the widget to unregister.
+     */
+    static unregisterWidget(name: string): void;
+    /**
+     * Adds a widget to the inspector, its a way to provide the widget type from a string.
+     * @param {InspectorWidgetTypes | string} [type] String specifying the name of the widget to use (check Inspector.widget_constructors for a complete list).
+     * @param {string} [name] The string to show at the left side of the widget, if null this element wont be created and the value part will use the full width.
+     * @param {InspectorValue} [value] The value to assign to the widget.
+     * @param {GenericCreationOptions} [options] Some generic options that any widget could have:
+     * - type: overwrites the type
+     * - callback: function to call when the user interacts with the widget and changes the value
+     * [For a bigger list check createWidget and every widget in particular]
+     * @returns {InspectorWidget | undefined} The widget in the form of the DOM element that contains it.
+     */
+    add(type?: InspectorWidgetTypes | string, name?: string, value?: InspectorValue, options?: GenericCreationOptions): InspectorWidget | undefined;
+    /**
+     * Retrieves the value of a specific widget by name.
+     * @param {string} name The name of the widget.
+     * @returns {InspectorValue} The value of the widget.
+     */
+    getValue(name: string): InspectorValue;
+    /**
+     * Applies standard options (id, classes, style) to a container element.
+     * @param {HTMLDivElement} element The DOM element to modify.
+     * @param {HTMLDivElementOptions} options The options containing id, className, width, height, etc.
+     */
+    applyOptions(element: HTMLDivElement, options: HTMLDivElementOptions): void;
+    /**
+     * Helper method that does nothing. Used as a placeholder for invalid widget types.
+     * @private
+     * @returns {undefined} Always returns undefined.
+     */
+    private _doNothing;
+    /**
+     * Creates an empty container but does not set it as the active stack container.
+     * @param {AddContainerOptions} [options] Configuration options.
+     * @returns {InspectorContainer} The created container element.
+     */
+    addEmptyContainer(options?: AddContainerOptions): InspectorContainer;
+    /**
+     * Creates a new container and sets it as the active container for subsequent widgets.
+     * @param {AddContainerOptions} options Configuration options.
+     * @returns {InspectorContainer} The created container element.
+     */
+    startContainer(options: AddContainerOptions): InspectorContainer;
+    /**
+     * Closes the current container and pops it from the stack.
+     */
+    endContainer(): void;
+    /**
+     * Adds a collapsible section to the inspector. Sections cannot be nested inside containers, but they contain a container.
+     * @param {string} [name] Title of the section.
+     * @param {InspectorOptions} [options] Configuration options for the section.
+     * @returns {InspectorSection} The created section element.
+     */
+    addSection(name?: string, options?: InspectorOptions): InspectorSection;
+    /**
+     * Changes the current active section to the specified one.
+     * @param {InspectorSection} section The section to make active.
+     */
+    setCurrentSection(section: InspectorSection): void;
+    /**
+     * Retrieves the currently active section.
+     * @returns {HTMLElement | null} The section element or null if no section is active.
+     */
+    getCurrentSection(): ParentNode | null;
+    /**
+     * Ends the current section, popping it from the stack.
+     */
+    endCurrentSection(): void;
+    /**
+     * Begins a new group of widgets. Groups provide a visual grouping and can be collapsed.
+     * @param {string} [name] The title of the group.
+     * @param {BeginGroupOptions} [options] Configuration options.
+     * @returns {InspectorGroupWidget} The group element.
+     */
+    beginGroup(name?: string, options?: BeginGroupOptions): InspectorGroupWidget;
+    /**
+     * Ends the current group, popping it from the stack.
+     */
+    endGroup(): void;
+    /**
+     * Creates a title bar in the widgets list to help separate widgets.
+     * @param {string} title The text to display in the title.
+     * @param {AddTitleOptions} [options] Configuration options.
+     * @returns {HTMLDivElement} The title widget element.
+     */
+    addTitle(title: string, options?: AddTitleOptions): InspectorWidget;
+    /**
+     * Scrolls the inspector to show the element with the specified ID.
+     * @param {string} id The ID of the element to scroll to.
+     */
+    scrollTo(id: string): void;
+    /**
+     * Processes options, ensuring they are in an object format.
+     * @param {Record<string, unknown> | (...args: unknown[]) => unknown} options The options to process.
+     * @returns {Record<string, unknown>} The processed options object.
+     */
+    processOptions(options?: object | ((...args: unknown[]) => unknown)): object;
+    /**
+     * Processes a widget element, applying update hooks if provided.
+     * @param {InspectorWidget} element The widget element.
+     * @param {ProcessElementOptions} options Options containing update hooks.
+     */
+    processElement(element: InspectorWidget, options: ProcessElementOptions): void;
+    /**
+     * Updates all widgets that have an onWidgetUpdate hook.
+     */
+    updateWidgets(): void;
+    /**
+     * Helper to parse a color array into a styled HTML string.
+     * @param {[number, number, number, number]} color The color array [r, g, b, a].
+     * @returns {string} The styled HTML string representing the color.
+     */
+    static parseColor(color: [number, number, number, number]): string;
+}
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/inspector/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KACP,EACC,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAEhB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,qBAAqB,CAAC;AAW7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIlD;;;;;;;;;GASG;AACH,qBAAa,SAAU,YAAW,aAAa;IAE9C;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,EAAE,CAAM;IAClC;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAqC;IACxE;;OAEG;IACH,OAAO,EAAE,eAAe,EAAE,CAAM;IAChC;;OAEG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAsC;IAEjF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAK;IACtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACtF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAQ;IAChC;;OAEG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAElC;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAA4B;IAE1D;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAC,CAAqB;IAC/C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvH;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAClB;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAK;IAE7B;;;OAGG;gBACS,OAAO,CAAC,EAAE,gBAAgB;IAqCtC;;;OAGG;IACH,SAAS;IAgBT;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE;IAYnD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAoBzD;;OAEG;IACH,KAAK;IAsBL;;OAEG;IACH,OAAO;IAQP;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,aAAa;IAiB7D;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,kBAAkB;IAoB3C;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,kBAAkB;IAOhD;;;OAGG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,WAAW;IAuBpC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,sBAAsB,EAAE;IASpC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS/B;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtF,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;IAgI3E;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAAA;KAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;IA0ExI;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,EAC5E,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe;IAsHhD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAqCjJ;;;;;OAKG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAU3E;;;OAGG;IACH,OAAc,kBAAkB,EAAE;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GACrB,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,eAAe,CAAC,CAAA;KAC9F,CAKA;IAEJ;;;;OAIG;WACW,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GACvD,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,eAAe,CAAC;IAKlG;;;OAGG;WACW,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAQ3C;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,GAAG,SAAS;IAwC/I;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAKtC;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB;IAUpE;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,mBAAmB;IAQ/C;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB;IA6B3C;;OAEG;IACH,YAAY;IAKZ;;;;;OAKG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,gBAAgB;IA+FvE;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,gBAAgB;IAe3C;;;OAGG;IACH,iBAAiB;IAWjB;;OAEG;IACH,iBAAiB;IAKjB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IA2CrD;;OAEG;IACH,QAAQ;IASR;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAsBjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM;IAUnB;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM;IAK5E;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB;IAWvE;;OAEG;IACH,aAAa;IASb;;;;OAIG;WACW,UAAU,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;CAOhE"}

package/dist/inspector/line.d.ts

@@ -0,0 +1,20 @@
+import { Inspector } from "./inspector";
+import { LineEditorOptions } from "../widgets";
+import { InspectorWidget } from "../@types/Inspector";
+/**
+ * Adds a line editor widget to the inspector with the specified name, value, and options.
+ * @function AddLine
+ *
+ * @param {Inspector} that - The reference to the inspector
+ * @param {string} name - The name of the line widget.
+ * @param {number[][]} value - The initial value of the file input widget.
+ * @param {LineEditorOptions} [options] - The options for the file input widget.
+ * @returns The created file input widget element.
+ */
+export declare function AddLineEditor(that: Inspector, name: string, value: number[][], options: LineEditorOptions): InspectorWidget;
+declare module "./inspector" {
+    interface Inspector {
+        addLineEditor(name: string, value: number[][], options?: LineEditorOptions): InspectorWidget;
+    }
+}
+//# sourceMappingURL=line.d.ts.map

package/dist/inspector/line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../src/inspector/line.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAiC,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAuB,MAAM,qBAAqB,CAAC;AAE3E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,mBAsBzG;AAED,OAAO,QAAQ,aAAa,CAAC;IAC5B,UAAU,SAAS;QAElB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;KAC7F;CACD"}

package/dist/inspector/list.d.ts

@@ -0,0 +1,153 @@
+import { CreateWidgetOptions, InspectorActiveWidget, InspectorValue, WidgetChangeOptions } from "../@types/Inspector";
+import { Inspector } from "./inspector";
+/**
+ * Options for creating a List widget.
+ */
+export interface AddListOptions extends CreateWidgetOptions, Omit<WidgetChangeOptions, 'callback'> {
+    /**
+     * Height of the list in pixels.
+     */
+    height?: number;
+    /**
+     * Whether the list is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Allow multiple items to be selected.
+     * @default false
+     */
+    multiSelection?: boolean;
+    /**
+     * The initially selected item value.
+     */
+    selected?: string;
+    /**
+     * Callback function to execute when an item is double-clicked.
+     */
+    onDoubleClick?: (value: string) => void;
+}
+/**
+ * Represents an item in the list.
+ */
+export interface ListItemOptions {
+    /**
+     * Content to display for the item (can be HTML).
+     */
+    content: string;
+    /**
+     * Title tooltip for the item.
+     */
+    title: string;
+    /**
+     * Unique name/identifier for the item.
+     */
+    name: string;
+    /**
+     * Inline CSS styles for the item.
+     */
+    style: string;
+    /**
+     * URL of an icon to display with the item.
+     */
+    icon: string;
+    /**
+     * Whether the item is selected.
+     */
+    selected: boolean;
+}
+/**
+ * Interface representing the List widget.
+ */
+export interface InspectorListWidget extends InspectorActiveWidget {
+    /**
+     * Adds a new item to the list.
+     * @param {string} value The value/name of the item.
+     * @param {boolean} selected Whether the item should be selected.
+     */
+    addItem: (value: string, selected: boolean) => void;
+    /**
+     * Removes an item from the list by name.
+     * @param {string} value The value/name of the item to remove.
+     */
+    removeItem: (value: string) => void;
+    /**
+     * Updates the entire list of items.
+     * @param {string[]} new_values Array of new item values.
+     * @param {string} [item_selected] The value of the item to select.
+     */
+    updateItems: (new_values: string[], item_selected?: string) => void;
+    /**
+     * Retrieves the currently selected items.
+     * @returns {string[]} Array of selected item names.
+     */
+    getSelected: () => string[];
+    /**
+     * Gets the list item element by its index.
+     * @param {number} index The index of the item.
+     * @returns {HTMLElement} The list item element.
+     */
+    getByIndex: (index: number) => HTMLElement;
+    /**
+     * Selects an item by its index.
+     * @param {number} index The index of the item to select.
+     * @param {boolean} [add_to_selection] If true, adds to existing selection instead of replacing it.
+     * @returns {HTMLElement} The selected list item element.
+     */
+    selectIndex: (index: number, add_to_selection?: boolean) => HTMLElement;
+    /**
+     * Deselects an item by its index.
+     * @param {number} index The index of the item to deselect.
+     * @returns {HTMLElement} The deselected list item element.
+     */
+    deselectIndex: (index: number) => HTMLElement;
+    /**
+     * Scrolls the list to ensure the item at the specified index is visible.
+     * @param {number} index The index of the item to scroll to.
+     */
+    scrollToIndex: (index: number) => void;
+    /**
+     * Selects all items in the list.
+     */
+    selectAll: () => void;
+    /**
+     * Deselects all items in the list.
+     */
+    deselectAll: () => void;
+    /**
+     * Sets the values (items) of the list.
+     * @param {string[]} value Array of item values.
+     */
+    setValue: (value: InspectorValue) => void;
+    /**
+     * Returns the number of items in the list.
+     */
+    getNumberOfItems: () => void;
+    /**
+     * Filters the list items based on a callback or string match.
+     * @param {string | ((value: number, item: HTMLElement, selected: boolean) => boolean)} [callback] filter string or callback function.
+     * @param {boolean} [case_sensitive] Whether the string filter is case sensitive.
+     */
+    filter: (callback?: string | ((value: number, item: HTMLElement, selected: boolean) => boolean), case_sensitive?: boolean) => void;
+    /**
+     * Selects items that match a filter callback.
+     * @param {(value: number, item: HTMLElement, selected: boolean) => boolean} callback Function to determine if an item should be selected.
+     */
+    selectByFilter: (callback: ((value: number, item: HTMLElement, selected: boolean) => boolean)) => void;
+}
+/**
+ * Widget to select from a list of items.
+ * @function AddList
+ * @param {Inspector} that The inspector instance.
+ * @param {string} [name] The name of the widget.
+ * @param {string[]} [values] Array of string values for the list items.
+ * @param {AddListOptions} [options] Configuration options.
+ * @returns {InspectorListWidget} The created list widget element.
+ */
+export declare function AddList(that: Inspector, name?: string, values?: string[], options?: AddListOptions): InspectorListWidget;
+declare module "./inspector" {
+    interface Inspector {
+        addList(name?: string, values?: string[], options?: AddListOptions): InspectorListWidget;
+    }
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/inspector/list.d.ts.map

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

package/dist/inspector/number.d.ts

@@ -0,0 +1,85 @@
+import { Inspector } from "./inspector";
+import { Dragger, DraggerOptions } from "../dragger";
+import { CreateWidgetOptions, WidgetChangeOptions, InspectorActiveWidget, InspectorValue } from "../@types/Inspector";
+/**
+ * Options for creating a Number widget.
+ */
+export interface AddNumberOptions extends CreateWidgetOptions, DraggerOptions, Omit<WidgetChangeOptions, 'callback'> {
+    /**
+     * Tab index for the input element.
+     */
+    tabIndex?: number;
+    /**
+     * CSS class to apply to the widget.
+     */
+    extraClass?: string;
+    /**
+     * Whether to use full number width.
+     */
+    fullNumWidth?: boolean;
+    /**
+     * Number of digits after the decimal point.
+     */
+    precision?: number;
+    /**
+     * Step value for incrementing/decrementing.
+     */
+    step?: number;
+    /**
+     * Unit string to display after the number (e.g. "px", "%").
+     */
+    units?: string;
+    /**
+     * Whether the widget is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Callback function triggered when the value changes visually.
+     */
+    onChange?: (value: number) => number | void;
+    /**
+     * Callback function triggered after the value changes logically.
+     */
+    callback?: (value: number) => void;
+    /**
+     * Callback function triggered before the value changes (on start dragging).
+     */
+    preCallback?: () => void;
+}
+/**
+ * Interface representing the Number widget.
+ */
+export interface InspectorNumberWidget extends InspectorActiveWidget {
+    /**
+     * Reference to the internal Dragger instance.
+     */
+    dragger: Dragger;
+    /**
+     * Sets the valid range for the number.
+     * @param {number} min Minimum value.
+     * @param {number} max Maximum value.
+     */
+    setRange: (min: number, max: number) => void;
+    /**
+     * Sets the value of the widget.
+     * @param {number | string} [value] The new value.
+     * @param {boolean} [skipEvent] If true, change event is not triggered.
+     */
+    setValue: (value?: InspectorValue, skipEvent?: boolean) => void;
+}
+/**
+ * Widget to edit numbers (it adds a dragging mini widget in the right side).
+ * @function AddNumber
+ * @param {Inspector} that The inspector instance.
+ * @param {string | undefined} name The name of the widget.
+ * @param {number | undefined} value The initial value.
+ * @param {AddNumberOptions | undefined} options Configuration options.
+ * @returns {InspectorNumberWidget} The created number widget element.
+ */
+export declare function AddNumber(that: Inspector, name?: string, value?: number, options?: AddNumberOptions): InspectorNumberWidget;
+declare module "./inspector" {
+    interface Inspector {
+        addNumber(name?: string, value?: number, options?: AddNumberOptions): InspectorNumberWidget;
+    }
+}
+//# sourceMappingURL=number.d.ts.map

package/dist/inspector/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/inspector/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGtH;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB,EAAE,cAAc,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAEnH;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAEnE;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAuF3H;AAED,OAAO,QAAQ,aAAa,CAAC;IAC5B,UAAU,SAAS;QAElB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAAC;KAC5F;CACD"}