@vandenberghinc/volt 1.2.5 → 1.2.6

package/frontend/dist/frontend/src/ui/context_menu.d.ts

@@ -1,36 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-import { VElementBaseSignature } from "../elements/module.js";
-declare const ContextMenuElement_base: VElementBaseSignature;
-export declare class ContextMenuElement extends ContextMenuElement_base {
-    remove_child_callback: any;
-    constructor(content: {
-        label: string;
-        on_click?: Function;
-        on_render?: Function;
-    }[] | HTMLElement[]);
-    popup(event: any): this;
-    close(): this;
-    remove(): this;
-}
-export declare const ContextMenu: <Extensions extends object = {}>(content: {
-    label: string;
-    on_click?: Function;
-    on_render?: Function;
-}[] | HTMLElement[]) => ContextMenuElement & Extensions;
-export declare const NullContextMenu: <Extensions extends object = {}>() => ContextMenuElement & Extensions;
-declare module './any_element.d.ts' {
-    interface AnyElementMap {
-        ContextMenuElement: ContextMenuElement;
-    }
-}
-declare global {
-    interface VElementExtensions {
-        _context_menu: ContextMenuElement | undefined;
-        on_context_menu(): Function | undefined;
-        on_context_menu(callback?: Function | ContextMenuElement | any[]): this;
-    }
-}
-export {};

package/frontend/dist/frontend/src/ui/context_menu.js

@@ -1,205 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-// Imports.
-import { Elements } from "../elements/module.js";
-import { Button } from "./button.js";
-import { VStackElement } from "./stack.js";
-// Context Menu.
-let ContextMenuElement = (() => {
-    let _classDecorators = [Elements.create({
-            name: "ContextMenuElement",
-        })];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = VStackElement;
-    var ContextMenuElement = class extends _classSuper {
-        static { _classThis = this; }
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-            ContextMenuElement = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        // Attributes.
-        remove_child_callback;
-        // Constructor.
-        // The content may either be an array with nodes, or an array with object like {label: ..., on_click: (element, event) => {}, on_render: (element) => {}}.
-        // A node / object may also be "null" and it will be ignored.
-        constructor(content) {
-            // Initialize base classes.
-            super();
-            this._init({
-                derived: ContextMenuElement,
-            });
-            // Append content.
-            for (const item of content) {
-                if (item == null) {
-                    break;
-                }
-                else if (!(item instanceof HTMLElement)) {
-                    const button = Button(item.label)
-                        .padding(5, 10, 5, 10)
-                        .margin(0)
-                        .font_size(12)
-                        .leading()
-                        .background("#FFFFFF15")
-                        .border_radius(0);
-                    if (typeof item.on_click === "function") {
-                        button.on_click((element, event) => item.on_click(element, event, this));
-                    }
-                    if (typeof item.on_render === "function") {
-                        button.on_render((element) => item.on_render(element));
-                    }
-                    this.append(button);
-                }
-                else {
-                    this.append(item);
-                }
-            }
-            // Set styling
-            this
-                .z_index(2) // one higher than sidebar.
-                .padding(5, 0, 5, 0)
-                .color("white")
-                .background("gray")
-                .box_shadow("0px 0px 10px #00000050")
-                .border_radius(10)
-                .min_width(150);
-            // Remove child callback.
-            this.remove_child_callback = (event) => {
-                if (!this.contains(event.target)) {
-                    this.remove();
-                }
-                document.body.removeEventListener("mousedown", this.remove_child_callback);
-            };
-        }
-        // Set default since it inherits an element.
-        // set_default() : this {
-        // 	return super.set_default(ContextMenuElement);
-        // }
-        // Popup the context menu by a event.
-        popup(event) {
-            // Prevent default.
-            event.preventDefault();
-            // Show.
-            super.show();
-            // Set position.
-            this.position(event.clientY, undefined, undefined, event.clientX);
-            // Add child.
-            document.body.appendChild(this);
-            // Add event listener to body.
-            document.body.addEventListener("mousedown", this.remove_child_callback);
-            // Response.
-            return this;
-        }
-        // Close the context menu.
-        close() {
-            // Remove from content.
-            super.remove();
-            // Remove event listener from body.
-            document.body.removeEventListener("mousedown", this.remove_child_callback);
-            // Response.
-            return this;
-        }
-        // @ts-ignore
-        remove() {
-            // Remove from content.
-            super.remove();
-            // Remove event listener from body.
-            document.body.removeEventListener("mousedown", this.remove_child_callback);
-            // Response.
-            return this;
-        }
-    };
-    return ContextMenuElement = _classThis;
-})();
-export { ContextMenuElement };
-export const ContextMenu = Elements.wrapper(ContextMenuElement);
-export const NullContextMenu = Elements.create_null(ContextMenuElement);
-Elements.extend({
-    _context_menu: undefined,
-    /**
-     * Script to be run when a context menu is triggered. This function can set or get the context menu callback.
-     *
-     * @param callback The parameter may either be a callback function, a ContextMenu object, or an Array as the ContextMenu parameter.
-     * @parent VElement
-     * @funcs 2
-     * @docs
-     * @returns Returns the `VElement` object. If `callback` is `null`, then the attribute's value is returned.
-     */
-    on_context_menu(callback) {
-        if (callback == null) {
-            if (this._context_menu !== undefined) {
-                return this._context_menu;
-            }
-            else {
-                return this.oncontextmenu ?? undefined;
-            }
-        }
-        if (callback instanceof ContextMenuElement || callback.element_name === "ContextMenuElement") {
-            this._context_menu = callback;
-            const _this_ = this;
-            this.oncontextmenu = (event) => {
-                if (this._context_menu instanceof ContextMenuElement) {
-                    this._context_menu.popup(event);
-                }
-            };
-        }
-        else if (Array.isArray(callback)) {
-            this._context_menu = ContextMenu(callback);
-            const _this_ = this;
-            this.oncontextmenu = (event) => {
-                if (this._context_menu instanceof ContextMenuElement) {
-                    this._context_menu.popup(event);
-                }
-            };
-        }
-        else {
-            const _this_ = this;
-            this.oncontextmenu = (event) => callback(_this_, event);
-        }
-        return this;
-    },
-});
-// @test
-// new VStackElement().on_context_menu();
-// VStack().on_context_menu();
-// VStack().on_context_menu_UNKNOWN();

package/frontend/dist/frontend/src/ui/css.d.ts

@@ -1,16 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-export declare class Stylesheet {
-    _element: HTMLStyleElement;
-    /** @warning This function may cause security issues if the data is unsafe provided by the user, since this assigns to innerHTML. */
-    constructor(data: string, auto_append?: boolean);
-    /** @warning This function may cause security issues if the data is unsafe provided by the user, since this assigns to innerHTML. */
-    data(): string;
-    data(val: string): this;
-    attach(): this;
-    join(): this;
-    remove(): this;
-    append_to(parent: any): this;
-}

package/frontend/dist/frontend/src/ui/css.js

@@ -1,48 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-// Button.
-export class Stylesheet {
-    // Attributes.
-    _element;
-    // Constructor.
-    /** @warning This function may cause security issues if the data is unsafe provided by the user, since this assigns to innerHTML. */
-    constructor(data, auto_append = false) {
-        this._element = document.createElement("style");
-        // Assign to tht element while security is paramount, dont assign to inner html
-        this._element.innerHTML = data;
-        if (auto_append) {
-            this.attach();
-        }
-    }
-    data(val) {
-        if (val == null) {
-            return this._element.innerHTML ?? "";
-        }
-        this._element.innerHTML = val;
-        return this;
-    }
-    // Attach.
-    attach() {
-        document.head.appendChild(this._element);
-        return this;
-    }
-    join() {
-        document.head.appendChild(this._element);
-        return this;
-    }
-    // Remove.
-    remove() {
-        this._element.remove();
-        return this;
-    }
-    // Append to.
-    append_to(parent) {
-        parent.appendChild(this._element);
-        return this;
-    }
-}
-// export const CSS = Elements.wrapper(CSSElement);
-// export const NullCSS = Elements.create_null(CSSElement);
-// declare module './any_element.d.ts' { interface AnyElementMap { CSSElement: CSSElement }}

package/frontend/dist/frontend/src/ui/divider.d.ts

@@ -1,15 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-import { VElementTagMap } from "../elements/module.js";
-export declare class DividerElement extends VElementTagMap.div {
-    constructor();
-}
-export declare const Divider: <Extensions extends object = {}>() => DividerElement & Extensions;
-export declare const NullDivider: <Extensions extends object = {}>() => DividerElement & Extensions;
-declare module './any_element.d.ts' {
-    interface AnyElementMap {
-        DividerElement: DividerElement;
-    }
-}

package/frontend/dist/frontend/src/ui/divider.js

@@ -1,78 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-// Imports.
-import { Elements, VElementTagMap } from "../elements/module.js";
-// Divider.
-let DividerElement = (() => {
-    let _classDecorators = [Elements.create({
-            name: "DividerElement",
-            default_style: {
-                "margin": "0px",
-                "padding": "0px",
-                "width": "100%",
-                "height": "1px",
-                "min-height": "1px",
-                // "background": "black",
-            },
-        })];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = VElementTagMap.div;
-    var DividerElement = class extends _classSuper {
-        static { _classThis = this; }
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-            DividerElement = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        // Constructor.
-        constructor() {
-            super({
-                derived: DividerElement,
-            });
-        }
-    };
-    return DividerElement = _classThis;
-})();
-export { DividerElement };
-export const Divider = Elements.wrapper(DividerElement);
-export const NullDivider = Elements.create_null(DividerElement);

package/frontend/dist/frontend/src/ui/dropdown.d.ts

@@ -1,176 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-import { VElementBaseSignature } from "../elements/module.js";
-import { HStackElement, AnchorHStackElement } from "./stack.js";
-import { ImageMaskElement } from "./image.js";
-import { AnyElement } from "./any_element.js";
-/**
- * Callback invoked with the dropdown element instance.
- */
-type DropdownCallback = (element: DropdownElement) => void;
-declare const DropdownElement_base: VElementBaseSignature;
-/**
- * Easily create a dropdown element.
- * @nav Frontend/Elements
- * @param target The target element for where the dropdown will be placed.
- * @param animate Enable animations.
- * @param duration The animation duration in milliseconds.
- * @param side Expand to the `"left"` or `"right"` side relative to the target element.
- * @param auto_remove Auto remove the dropdown when it is closed.
- * @param use_target_min Use the target element for a minimum width of the dropdown.
- * @param below_target Place the dropdown below the target with by default an `y_offset` of `10`, unless `y_offset` is defined as `false`.
- * @param x_offset The additional x offset of the dropdown's position, this value will be added the computed x position.
- * @param y_offset The additional y offset of the dropdown's position, this value will be added the computed y position.
- * @param content Optional content array to easily create a context-menu like dropdown menu.
- * @param content.text The content text. Required.
- * @param content.image The content image source.
- * @param content.image_padding The image padding.
- * @param content.image_top The image margin top.
- * @param content.href The href redirect on click.
- * @param content.callback The on click callback.
- * @param content.on_click The on click callback.
- * @param content.on_click_redirect The on click redirect function arguments.
- * @param content.anchor Flag indicating if the content node should be an anchor. Default: false.
- * @docs
- */
-export declare class DropdownElement extends DropdownElement_base {
-    static element_name: string;
-    private _target;
-    private _animate;
-    private _duration;
-    private _side?;
-    private _use_target_min;
-    private _auto_remove;
-    private _min_width?;
-    private _max_width?;
-    private _min_height?;
-    private _max_height?;
-    private _below_target;
-    x_offset: number;
-    y_offset: number;
-    content_items: ((AnchorHStackElement | HStackElement) & {
-        image: ImageMaskElement;
-    })[];
-    on_expand_callback?: DropdownCallback;
-    on_minimize_callback?: DropdownCallback;
-    mouse_over_background: string;
-    mouse_out_opacity: number;
-    _content_padding: [any, any] | [any, any, any, any];
-    _content_margin: [any, any] | [any, any, any, any];
-    _frame_min_width: number;
-    _frame_min_height: number;
-    _frame_max_width: number;
-    _frame_max_height: number;
-    next_toggle_allowed?: number;
-    expanded: boolean;
-    animation_timeout: any;
-    close_handler?: Function;
-    /**
-     * Create a new dropdown instance. See the class documentation for available options.
-     */
-    constructor({ target, animate, duration, side, auto_remove, min_width, max_width, min_height, max_height, use_target_min, below_target, x_offset, y_offset, content, }: {
-        target: AnyElement | HTMLElement;
-        animate?: boolean;
-        duration?: number;
-        side?: string;
-        auto_remove?: boolean;
-        min_width?: number;
-        max_width?: number;
-        min_height?: number;
-        max_height?: number;
-        use_target_min?: boolean;
-        below_target?: boolean;
-        x_offset?: number;
-        y_offset?: number;
-        content?: {
-            text: string;
-            image?: string;
-            image_padding?: number;
-            image_top?: number;
-            href?: string;
-            callback?: Function;
-            on_click?: Function;
-            on_click_redirect?: string;
-            anchor?: boolean;
-            ellipsis_overflow?: boolean;
-        }[];
-    });
-    /**
-     * Measure the dropdown to compute and cache min/max frame sizes based on current content and constraints.
-     * @private
-     */
-    _get_frame(): void;
-    /**
-     * Toggle the dropdown: expands when minimized, minimizes when expanded.
-     */
-    toggle(): this;
-    /**
-     * Expand (open) the dropdown and position it relative to the target.
-     * Triggers the `on_expand` callback when set.
-     */
-    expand(): this;
-    /**
-     * Minimize (close) the dropdown.
-     * When `force` is true, skips the debounce guard to close immediately.
-     * @param force Force closing even if toggling is temporarily blocked.
-     */
-    minimize(force?: boolean): this;
-    on_expand(): undefined | DropdownCallback;
-    on_expand(callback: DropdownCallback): this;
-    on_minimize(): undefined | DropdownCallback;
-    on_minimize(callback: DropdownCallback): this;
-    font_size(): string;
-    font_size(value: string | number): this;
-    color(): string;
-    color(value: string): this;
-    /**
-     * Iterate content nodes created by the `content` parameter. When the callback returns any non null value the iteration will be stopped.
-     * @param callback The callback invoked for each content element.
-     * @docs
-    */
-    iterate_content(callback: (element: AnchorHStackElement | HStackElement) => any): this;
-    content_padding(): typeof this._content_padding;
-    content_padding(...args: typeof this._content_padding): this;
-    content_margin(): typeof this._content_margin;
-    content_margin(...args: typeof this._content_margin): this;
-    content_background(): string;
-    content_background(value: string): this;
-    content_opacity(): number;
-    content_opacity(value: number): this;
-}
-export declare const Dropdown: <Extensions extends object = {}>(args_0: {
-    target: AnyElement | HTMLElement;
-    animate?: boolean;
-    duration?: number;
-    side?: string;
-    auto_remove?: boolean;
-    min_width?: number;
-    max_width?: number;
-    min_height?: number;
-    max_height?: number;
-    use_target_min?: boolean;
-    below_target?: boolean;
-    x_offset?: number;
-    y_offset?: number;
-    content?: {
-        text: string;
-        image?: string;
-        image_padding?: number;
-        image_top?: number;
-        href?: string;
-        callback?: Function;
-        on_click?: Function;
-        on_click_redirect?: string;
-        anchor?: boolean;
-        ellipsis_overflow?: boolean;
-    }[];
-}) => DropdownElement & Extensions;
-export declare const NullDropdown: <Extensions extends object = {}>() => DropdownElement & Extensions;
-declare module './any_element.d.ts' {
-    interface AnyElementMap {
-        DropdownElement: DropdownElement;
-    }
-}
-export {};