@vandenberghinc/volt 1.1.2

package/frontend/dist/ui/link.d.ts

@@ -0,0 +1,39 @@
+import { VElementTagMap } from "../elements/module.js";
+export declare class AnchorElement extends VElementTagMap.a {
+    static default_style: {
+        "font-family": string;
+        "font-size": string;
+        color: string;
+        "text-decoration": string;
+        "text-underline-position": string;
+        cursor: string;
+        outline: string;
+        border: string;
+    };
+    constructor(text?: string, href?: string, alt?: string);
+}
+export declare const Anchor: <Extensions extends object = {}>(text?: string | undefined, href?: string | undefined, alt?: string | undefined) => AnchorElement & Extensions;
+export declare const NullAnchor: <Extensions extends object = {}>() => AnchorElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        AnchorElement: AnchorElement;
+    }
+}
+export declare class LinkElement extends VElementTagMap.a {
+    static default_style: {
+        "font-family": string;
+        "font-size": string;
+        color: string;
+        "text-decoration": string;
+        "text-underline-position": string;
+        cursor: string;
+    };
+    constructor(text?: string, href?: string);
+}
+export declare const Link: <Extensions extends object = {}>(text?: string | undefined, href?: string | undefined) => LinkElement & Extensions;
+export declare const NullLink: <Extensions extends object = {}>() => LinkElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        LinkElement: LinkElement;
+    }
+}

package/frontend/dist/ui/link.js

@@ -0,0 +1,146 @@
+/*
+ * Author: Daan van den Bergh
+ * Copyright: © 2022 - 2024 Daan van den Bergh.
+ */
+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;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+// Imports.
+import { Elements, VElementTagMap } from "../elements/module.js";
+// Link.
+let AnchorElement = (() => {
+    var _a;
+    let _classDecorators = [(_a = Elements).register.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = VElementTagMap.a;
+    var AnchorElement = _classThis = class extends _classSuper {
+        // Constructor.
+        constructor(text, href, alt) {
+            // Initialize base class.
+            super({
+                derived: AnchorElement,
+            });
+            // Set href.
+            if (href !== undefined) {
+                this.href(href);
+            }
+            // Set alt.
+            if (alt !== undefined) {
+                this.alt(alt);
+            }
+            // Set text.
+            if (text !== undefined || alt !== undefined) {
+                this.text((text ?? alt));
+            }
+        }
+    };
+    __setFunctionName(_classThis, "AnchorElement");
+    (() => {
+        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);
+        AnchorElement = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+    })();
+    _classThis.default_style = {
+        "font-family": "inherit",
+        "font-size": "inherit",
+        "color": "inherit",
+        "text-decoration": "none",
+        "text-underline-position": "none",
+        "cursor": "pointer",
+        "outline": "none",
+        "border": "none",
+    };
+    (() => {
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return AnchorElement = _classThis;
+})();
+export { AnchorElement };
+export const Anchor = Elements.wrapper(AnchorElement);
+export const NullAnchor = Elements.create_null(AnchorElement);
+// Link.
+let LinkElement = (() => {
+    var _a;
+    let _classDecorators = [(_a = Elements).register.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = VElementTagMap.a;
+    var LinkElement = _classThis = class extends _classSuper {
+        // Constructor.
+        constructor(text, href) {
+            // Initialize base class.
+            super({
+                derived: LinkElement,
+            });
+            // Set text.
+            if (text !== undefined) {
+                this.text(text);
+            }
+            // Set href.
+            if (href !== undefined) {
+                this.href(href);
+            }
+        }
+    };
+    __setFunctionName(_classThis, "LinkElement");
+    (() => {
+        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);
+        LinkElement = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+    })();
+    _classThis.default_style = {
+        "font-family": "inherit",
+        "font-size": "1em",
+        "color": "rgb(85, 108, 214)",
+        "text-decoration": "underline",
+        "text-underline-position": "auto",
+        "cursor": "pointer",
+    };
+    (() => {
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return LinkElement = _classThis;
+})();
+export { LinkElement };
+export const Link = Elements.wrapper(LinkElement);
+export const NullLink = Elements.create_null(LinkElement);

package/frontend/dist/ui/list.d.ts

@@ -0,0 +1,33 @@
+import { VElementTagMap } from "../elements/module.js";
+export declare class ListItemElement extends VElementTagMap.li {
+    constructor(...content: any[]);
+}
+export declare const ListItem: <Extensions extends object = {}>(...args: any[]) => ListItemElement & Extensions;
+export declare const NullListItem: <Extensions extends object = {}>() => ListItemElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        ListItemElement: ListItemElement;
+    }
+}
+export declare class UnorderedListElement extends VElementTagMap.ul {
+    constructor(items?: (ListItemElement | any | any[])[]);
+    append_item(content: ListItemElement | any | any[]): this;
+}
+export declare const UnorderedList: <Extensions extends object = {}>(items?: any[] | undefined) => UnorderedListElement & Extensions;
+export declare const NullUnorderedList: <Extensions extends object = {}>() => UnorderedListElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        UnorderedListElement: UnorderedListElement;
+    }
+}
+export declare class OrderedListElement extends VElementTagMap.ol {
+    constructor(items?: (ListItemElement | any | any[])[]);
+    append_item(content: ListItemElement | any | any[]): this;
+}
+export declare const OrderedList: <Extensions extends object = {}>(items?: any[] | undefined) => OrderedListElement & Extensions;
+export declare const NullOrderedList: <Extensions extends object = {}>() => OrderedListElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        OrderedListElement: OrderedListElement;
+    }
+}

package/frontend/dist/ui/list.js

@@ -0,0 +1,161 @@
+/*
+ * Author: Daan van den Bergh
+ * Copyright: © 2022 - 2024 Daan van den Bergh.
+ */
+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;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+// Imports.
+import { Elements, VElementTagMap } from "../elements/module.js";
+import { Scheme } from "../modules/scheme";
+// List item.
+let ListItemElement = (() => {
+    var _a;
+    let _classDecorators = [(_a = Elements).register.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = VElementTagMap.li;
+    var ListItemElement = _classThis = class extends _classSuper {
+        // Constructor.
+        constructor(...content) {
+            // Initialize base class.
+            super({ derived: ListItemElement });
+            // Append content.
+            this.append(...content);
+        }
+    };
+    __setFunctionName(_classThis, "ListItemElement");
+    (() => {
+        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);
+        ListItemElement = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return ListItemElement = _classThis;
+})();
+export { ListItemElement };
+export const ListItem = Elements.wrapper(ListItemElement);
+export const NullListItem = Elements.create_null(ListItemElement);
+// Unordered List.
+let UnorderedListElement = (() => {
+    var _a;
+    let _classDecorators = [(_a = Elements).register.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = VElementTagMap.ul;
+    var UnorderedListElement = _classThis = class extends _classSuper {
+        // Constructor.
+        constructor(items = []) {
+            // Initialize base class.
+            super({ derived: UnorderedListElement });
+            // Add items.
+            if (Array.isArray(items)) {
+                items.iterate(node => { this.append_item(node); });
+            }
+            else {
+                console.error(`Invalid type "${Scheme.value_type(items)}" for parameter "items" the valid type is "array".`);
+            }
+        }
+        // Append item.
+        append_item(content) {
+            if (!(content instanceof ListItemElement)) {
+                content = ListItem(content);
+            }
+            this.append(content);
+            return this;
+        }
+    };
+    __setFunctionName(_classThis, "UnorderedListElement");
+    (() => {
+        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);
+        UnorderedListElement = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return UnorderedListElement = _classThis;
+})();
+export { UnorderedListElement };
+export const UnorderedList = Elements.wrapper(UnorderedListElement);
+export const NullUnorderedList = Elements.create_null(UnorderedListElement);
+// Ordered List.
+let OrderedListElement = (() => {
+    var _a;
+    let _classDecorators = [(_a = Elements).register.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = VElementTagMap.ol;
+    var OrderedListElement = _classThis = class extends _classSuper {
+        // Constructor.
+        constructor(items = []) {
+            // Initialize base class.
+            super({ derived: OrderedListElement });
+            // Add items.
+            if (Array.isArray(items)) {
+                items.iterate(node => { this.append_item(node); });
+            }
+            else {
+                console.error(`Invalid type "${Scheme.value_type(items)}" for parameter "items" the valid type is "array".`);
+            }
+        }
+        // Append item.
+        append_item(content) {
+            if (!(content instanceof ListItemElement)) {
+                content = ListItem(content);
+            }
+            this.append(content);
+            return this;
+        }
+    };
+    __setFunctionName(_classThis, "OrderedListElement");
+    (() => {
+        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);
+        OrderedListElement = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return OrderedListElement = _classThis;
+})();
+export { OrderedListElement };
+export const OrderedList = Elements.wrapper(OrderedListElement);
+export const NullOrderedList = Elements.create_null(OrderedListElement);

package/frontend/dist/ui/loader_button.d.ts

@@ -0,0 +1,108 @@
+import { VDivElement } from "../elements/module.js";
+import { AnchorHStackElement } from "./stack";
+import { RingLoaderElement } from "./loaders";
+export declare class myClass extends AnchorHStackElement {
+    constructor();
+}
+/**
+ * @warning: you should not use function "LoaderButton.loader.hide() / LoaderButton.loader.show()" use "LoaderButton.hide_loader() / LoaderButton.show_loader()" instead.
+ * @warning: This class is still experimental and may be subject to future change.
+ */
+export declare class LoaderButtonElement extends AnchorHStackElement {
+    static default_style: {
+        margin: string;
+        padding: string;
+        "border-radius": string;
+        cursor: string;
+        background: string;
+        color: string;
+        "font-size": string;
+        "user-select": string;
+        "text-decoration": string;
+        "--loader-width": string;
+        "--loader-height": string;
+    };
+    nodes: {
+        text: VDivElement;
+        loader: RingLoaderElement;
+        [key: string]: any;
+    };
+    text: VDivElement;
+    loader: RingLoaderElement;
+    /**
+     * @docs:
+     * @title: Loader Button Constructor
+     * @desc: Initializes the LoaderButton element with the provided text and loader.
+     * @param:
+     *     @name: text
+     *     @descr: The text to display on the loader button.
+     *     @type: string
+     * @param:
+     *     @name: loader
+     *     @descr: The loader function to create the loading animation.
+     *     @type: Function
+     * @return:
+     *     @type: void
+     *     @description This constructor does not return a value.
+     */
+    constructor(text?: string, loader?: () => any);
+    /**
+     * @docs:
+     * @title: Styles
+     * @desc: Retrieves or sets the styling attributes for the loader element. If no argument is provided, it returns the current styles including default loader dimensions.
+     * @param:
+     *     @name: style_dict
+     *     @descr: An optional dictionary of styles to set.
+     *     @type: object | null
+     * @return:
+     *     @type: object
+     *     @description When no argument is passed, returns the current styles including loader dimensions. When an argument is provided, returns the result of the super class's styles method.
+     * @funcs: 2
+     */
+    styles(): Record<string, string>;
+    styles(style_dict: Record<string, any>): this;
+    /**
+     * @docs:
+     * @title: Set Default
+     * @desc: Sets the default configuration for the LoaderButtonElement by calling the parent method.
+     * @return:
+     *     @type: this
+     *     @description Returns the instance of the element for chaining.
+     */
+    set_default(): this;
+    /**
+     * @docs:
+     * @title: Show Loader
+     * @desc: Displays the loader and disables the button when clicked.
+     * @return:
+     *     @type: this
+     *     @description Returns the instance of the element for chaining.
+     */
+    show_loader(): this;
+    /**
+     * @docs:
+     * @title: Start
+     * @desc: Initiates the loading process by showing the loader.
+     * @return:
+     *     @type: this
+     *     @description Returns the instance of the element for chaining.
+     */
+    start(): this;
+    /**
+     * @docs:
+     * @title: Hide Loader
+     * @desc: Hides the loader, enables the button, and shows the text on click event.
+     * @return:
+     *     @type: this
+     *     @description Returns the instance of the element for chaining.
+     */
+    hide_loader(): this;
+    stop(): this;
+}
+export declare const LoaderButton: <Extensions extends object = {}>(text?: string | undefined, loader?: (() => any) | undefined) => LoaderButtonElement & Extensions;
+export declare const NullLoaderButton: <Extensions extends object = {}>() => LoaderButtonElement & Extensions;
+declare module './any_element.d.ts' {
+    interface AnyElementMap {
+        LoaderButtonElement: LoaderButtonElement;
+    }
+}