@vandenberghinc/volt 1.2.5 → 1.2.6

package/frontend/dist/frontend/src/elements/module.d.ts

@@ -1,95 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-export * from "./base.js";
-export * from "./types.js";
-import { VElement, extend as extend_velement, wrapper as _wrapper, create_null as _create_null } from "./base.js";
-import { register_element as _register_element } from "./register_element.js";
-export declare namespace Elements {
-    /**
-     * Re-exports the `register_element` helper for registering custom elements.
-     */
-    export const register_element: typeof _register_element;
-    /**
-     * Get an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    export function get(id: string): VElement;
-    /**
-     * Alias for `get` to retrieve an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    export function get_by_id(id: string): VElement;
-    /**
-     * Programmatically clicks an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    export function click(id: string): void;
-    /**
-     * Generic constructor signature used for class decorators and factories.
-     */
-    type Constructor<T = any> = new (...args: any[]) => T;
-    /**
-     * Options for the `Elements.create` class decorator.
-     * @property name The name to use for this element (becomes the “v-…” tag)
-     * @property tag Optional host tag to extend (defaults to constructor.tag if set)
-     * @property default_style Default inline styles for the element.
-     * @property default_attributes Default attributes for the element.
-     * @property default_events Default event handlers for the element.
-     */
-    interface CreateOpts {
-        name: string;
-        tag?: string;
-        default_style?: Record<string, any>;
-        default_attributes?: Record<string, any>;
-        default_events?: Record<string, any>;
-    }
-    /**
-     * Class decorator factory.
-     * @example
-     *   @create({ name: "Foo", tag?: "section", base: HTMLElement })
-     *   class Foo extends HTMLElement { … }
-     */
-    export function create(opts: CreateOpts): <T extends Constructor>(constructor: T) => T;
-    /**
-     * Re-exported constructor wrapper from the base module.
-     */
-    export const wrapper: typeof _wrapper;
-    /**
-     * Shared null element mainly for TypeScript typing convenience.
-     */
-    export const create_null: typeof _create_null;
-    /**
-     * Submits multiple elements by ID or reference.
-     * @nav Frontend
-     * @chapter Elements
-     * @deprecated
-     * @param elements A list of element IDs or element references to submit.
-     * @docs
-     */
-    export function submit(...elements: (string | VElement | HTMLElement)[]): Record<string, any>;
-    /**
-     * Forwards a function to a child element.
-     * @nav Frontend
-     * @chapter Elements
-     * @param func_name The name of the function to forward.
-     * @param child The child element or a function that returns the child element.
-     * @docs
-     */
-    export function forward_func_to_child(func_name: string, child: any): (val?: any) => any;
-    /**
-     * Typed re-export of `extend` to augment a `VElement` with additional helpers.
-     */
-    export const extend: typeof extend_velement;
-    export {};
-}

package/frontend/dist/frontend/src/elements/module.js

@@ -1,216 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-// Import elements create func.
-export * from "./base.js";
-export * from "./types.js";
-import { extend as extend_velement, wrapper as _wrapper, create_null as _create_null, } from "./base.js";
-import { register_element as _register_element } from "./register_element.js";
-// Elements module.
-export var Elements;
-(function (Elements) {
-    /**
-     * Re-exports the `register_element` helper for registering custom elements.
-     */
-    Elements.register_element = _register_element;
-    // Get by id.
-    // @note: always use VElement as return type since this is most likely the case and avoids type casting for users.
-    /**
-     * Get an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    function get(id) {
-        const e = document.getElementById(id);
-        if (e == null) {
-            throw new Error(`Unable to find element with id "${id}".`);
-        }
-        return e;
-    }
-    Elements.get = get;
-    // Get by id (alias).
-    // @note: always use VElement as return type since this is most likely the case and avoids type casting for users.
-    /**
-     * Alias for `get` to retrieve an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    function get_by_id(id) {
-        return Elements.get(id);
-    }
-    Elements.get_by_id = get_by_id;
-    // Click an element by id.
-    /**
-     * Programmatically clicks an element by its ID.
-     * @nav Frontend
-     * @chapter Elements
-     * @param id The ID of the element.
-     * @docs
-     */
-    function click(id) {
-        const element = document.getElementById(id);
-        if (element) {
-            element.click();
-        }
-        else {
-            throw new Error(`Unable to find element with id "${id}".`);
-        }
-    }
-    Elements.click = click;
-    /**
-     * Class decorator factory.
-     * @example
-     *   @create({ name: "Foo", tag?: "section", base: HTMLElement })
-     *   class Foo extends HTMLElement { … }
-     */
-    function create(opts) {
-        // Validate required options at factory time
-        if (typeof opts.name !== "string" || opts.name.trim() === "") {
-            throw new Error(`@Elements.create requires a non-empty string “name”`);
-        }
-        // Factory function
-        return function (constructor) {
-            const any_ctor = constructor;
-            // Define readonly static attributes.
-            any_ctor.element_name = opts.name;
-            // Object.defineProperty(any_ctor, "element_name", { value: opts.name, writable: false, enumerable: true, configurable: false });
-            if (opts.tag != null) {
-                any_ctor.element_tag = opts.tag;
-                // Object.defineProperty(any_ctor, "element_tag", { value: opts.tag, writable: false, enumerable: true, configurable: false });
-            }
-            if (opts.default_style != null) {
-                any_ctor.default_style = opts.default_style;
-                // Object.defineProperty(any_ctor, "default_style", { value: opts.default_style, writable: false, enumerable: true, configurable: false });
-            }
-            if (opts.default_attributes != null) {
-                any_ctor.default_attributes = opts.default_attributes;
-                // Object.defineProperty(any_ctor, "default_attributes", { value: opts.default_attributes, writable: false, enumerable: true, configurable: false });
-            }
-            if (opts.default_events != null) {
-                any_ctor.default_events = opts.default_events;
-                // Object.defineProperty(any_ctor, "default_events", { value: opts.default_events, writable: false, enumerable: true, configurable: false });
-            }
-            // Register custom element exactly once
-            _register_element(constructor);
-            return constructor;
-        };
-    }
-    Elements.create = create;
-    // export function create<T extends { new(...args: any[]): {} }>(constructor: T): void {
-    //     const any_con = constructor as any;
-    //     // Register new html element.
-    //     if (!any_con._volt_is_registered) {
-    //         console.log({ type: constructor })
-    //         if (!any_con.element_name) {
-    //             throw new Error(`Static element attribute '${any_con.name}.element_name' should always be defined, create static attribute \"element_name: string\" and assign the name of the class to this attribute.`)
-    //         }
-    //         const name = any_con.element_name || any_con.name;
-    //         let new_xml_name = "", count = 0;
-    //         do {
-    //             new_xml_name = "v-" + name.toLowerCase() + (count > 0 ? "-" + count : "");
-    //         } while (registered_type_names.has(new_xml_name) && ++count);
-    //         registered_type_names.add(new_xml_name);
-    //         const ext = tag || any_con.element_tag;
-    //         // @debug
-    //         console.log("Registering custom element: ", {
-    //             name,
-    //             type: constructor,
-    //             new_xml_name,
-    //             extends: ext,
-    //             element_name: any_con.element_name,
-    //         });
-    //         any_con._volt_is_registered = true;
-    //         // customElements.define(type.name, type, { extends: tag || (type as any).element_tag });
-    //         customElements.define(new_xml_name, any_con, { extends: ext });
-    //     }
-    // }
-    /**
-     * Re-exported constructor wrapper from the base module.
-     */
-    // Create a constructor wrapper.
-    Elements.wrapper = _wrapper;
-    /**
-     * Shared null element mainly for TypeScript typing convenience.
-     */
-    // Create a shared null element mainly for typescript types.
-    Elements.create_null = _create_null;
-    // Submit multiple elements by id or element.
-    // When one is not filled in then an error is thrown.
-    // When an input is not required, no errors will be thrown.
-    // An object will be returned with each input's id as the key and the input's value as value.
-    // Only supported extended input elements like `ExtendedInput`.
-    /**
-     * Submits multiple elements by ID or reference.
-     * @nav Frontend
-     * @chapter Elements
-     * @deprecated
-     * @param elements A list of element IDs or element references to submit.
-     * @docs
-     */
-    function submit(...elements) {
-        const params = {};
-        let error;
-        for (let i = 0; i < elements.length; i++) {
-            try {
-                let element = elements[i];
-                if (typeof element === "string") {
-                    element = Elements.get(element);
-                }
-                const id = element.id();
-                if (id == null || id === "") {
-                    continue;
-                }
-                if (element.required() !== true) {
-                    params[id] = element.value();
-                }
-                else {
-                    params[id] = element.submit();
-                }
-            }
-            catch (e) {
-                error = e;
-            }
-        }
-        if (error) {
-            throw error;
-        }
-        return params;
-    }
-    Elements.submit = submit;
-    // Forward a function to a child so a user can easily create functions on the parent like border_radius() which actually set the border radius of a child.
-    // The new function still returns `this`.
-    /**
-     * Forwards a function to a child element.
-     * @nav Frontend
-     * @chapter Elements
-     * @param func_name The name of the function to forward.
-     * @param child The child element or a function that returns the child element.
-     * @docs
-     */
-    function forward_func_to_child(func_name, child) {
-        return function (val) {
-            if (typeof child === "function") {
-                child = child(this);
-            }
-            if (val == null) {
-                return child[func_name]();
-            }
-            child[func_name](val);
-            return this;
-        };
-    }
-    Elements.forward_func_to_child = forward_func_to_child;
-    // Update the extend_velement function to use proper types
-    /**
-     * Typed re-export of `extend` to augment a `VElement` with additional helpers.
-     */
-    Elements.extend = extend_velement;
-    // Create.
-    // export const create = create_velement;
-})(Elements || (Elements = {}));
-;

package/frontend/dist/frontend/src/elements/register_element.d.ts

@@ -1,3 +0,0 @@
-/** Separate file for register_element() method to prevent recursive imports from base.ts and module.ts */
-export declare const registered_names: Set<string>;
-export declare function register_element(constructor: any): void;

package/frontend/dist/frontend/src/elements/register_element.js

@@ -1,22 +0,0 @@
-/** Separate file for register_element() method to prevent recursive imports from base.ts and module.ts */
-export const registered_names = new Set();
-export function register_element(constructor) {
-    // @warning dont use any caching on the constructor, it will break the element registration since the constructor can be used as base class.
-    const any_ctor = constructor;
-    if (!any_ctor.element_name) {
-        console.error("Error constructor:", constructor);
-        throw new Error("Static element attribute 'element_name' should always be defined, create static attribute \"element_name: string\" and assign the name of the class to this attribute.");
-    }
-    const base_name = any_ctor.element_name;
-    let new_tag = "";
-    let count = 0;
-    do {
-        new_tag = `v-${base_name.toLowerCase()}${count ? `-${count}` : ""}`;
-        count++;
-    } while (registered_names.has(new_tag));
-    registered_names.add(new_tag);
-    const extend_options = any_ctor.element_tag
-        ? { extends: any_ctor.element_tag }
-        : undefined;
-    customElements.define(new_tag, any_ctor, extend_options);
-}

package/frontend/dist/frontend/src/elements/resize_query_manager.js

@@ -1,150 +0,0 @@
-"use strict";
-// /**
-//  * @author Daan van den Bergh
-//  * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
-//  */
-// import { AnyElement } from "src/ui/any_element";
-// /**
-//  * Global manager for container-style predicates (single ResizeObserver).
-//  */
-// export class ResizeQueryManager {
-//     /** Shared ResizeObserver instance (one per app). */
-//     private static resize_observer: ResizeObserver | null = null;
-//     /** Target -> records depending on this container target. */
-//     private static records_by_target = new Map<AnyElement, Set<ResizeQueryManager.Record<any>>>();
-//     /** Target -> latest size from RO callback (batched). */
-//     private static pending_sizes = new Map<AnyElement, { width: number; height: number }>();
-//     /** Prevent scheduling multiple RAF flushes. */
-//     private static raf_scheduled = false;
-//     /**
-//      * Ensure global observer exists.
-//      */
-//     static ensure_observer(): void {
-//         if (this.resize_observer !== null) return;
-//         // ResizeObserver fires for element size changes, not just window resizes.
-//         this.resize_observer = new ResizeObserver((entries) => {
-//             for (const entry of entries) {
-//                 const target = entry.target as unknown as AnyElement;
-//                 const rect = entry.contentRect;
-//                 // Coalesce sizes per target so we only compute once per frame.
-//                 this.pending_sizes.set(target, { width: rect.width, height: rect.height });
-//             }
-//             this.schedule_flush();
-//         });
-//     }
-//     /**
-//      * Observe a target element and register a record.
-//      */
-//     static observe_target<T extends AnyElement>(target: AnyElement, record: ResizeQueryManager.Record<T>): void {
-//         this.ensure_observer();
-//         let records = this.records_by_target.get(target);
-//         if (records === undefined) {
-//             records = new Set();
-//             this.records_by_target.set(target, records);
-//             // Start observing this target once, regardless of how many records use it.
-//             this.resize_observer!.observe(target as unknown as HTMLElement);
-//         }
-//         records.add(record as ResizeQueryManager.Record<any>);
-//         // Initialize immediately using current layout (no need to wait for RO tick).
-//         this.evaluate_record(record, target);
-//     }
-//     /**
-//      * Unobserve a record from a target; stop observing target if unused.
-//      */
-//     static unobserve_target<T extends AnyElement>(target: AnyElement, record: ResizeQueryManager.Record<T>): void {
-//         const records = this.records_by_target.get(target);
-//         if (records === undefined) return;
-//         records.delete(record as ResizeQueryManager.Record<any>);
-//         // If no more records depend on this target, unobserve it.
-//         if (records.size === 0) {
-//             this.records_by_target.delete(target);
-//             this.resize_observer?.unobserve(target as unknown as HTMLElement);
-//         }
-//     }
-//     /**
-//      * Schedule a batched flush of pending size changes.
-//      */
-//     private static schedule_flush(): void {
-//         if (this.raf_scheduled) return;
-//         this.raf_scheduled = true;
-//         requestAnimationFrame(() => {
-//             this.raf_scheduled = false;
-//             this.flush_pending();
-//         });
-//     }
-//     /**
-//      * Evaluate all records for all targets that changed this frame.
-//      */
-//     private static flush_pending(): void {
-//         for (const [target] of this.pending_sizes) {
-//             const records = this.records_by_target.get(target);
-//             if (records === undefined) continue;
-//             // Evaluate all records attached to this target.
-//             for (const record of records) {
-//                 this.evaluate_record(record, target);
-//             }
-//         }
-//         this.pending_sizes.clear();
-//     }
-//     /**
-//      * Evaluate one record against a target and fire handlers on state changes.
-//      */
-//     private static evaluate_record<T extends AnyElement>(record: ResizeQueryManager.Record<T>, target: AnyElement): void {
-//         let matches = false;
-//         try {
-//             // NOTE: predicate gets the AnyElement + the target container element.
-//             // Users can do target.clientWidth / target.getBoundingClientRect() etc.
-//             matches = record.predicate(record.owner, target);
-//         } catch {
-//             // Treat predicate errors as "no match" to keep the system stable.
-//             matches = false;
-//         }
-//         // Only fire when state flips (or first run).
-//         if (record.last_match === undefined || record.last_match !== matches) {
-//             record.last_match = matches;
-//             if (matches) record.on_true?.(record.owner);
-//             else record.on_false?.(record.owner);
-//         }
-//     }
-// }
-// /**
-//  * Namespaced types for ContainerQueryManager.
-//  */
-// export namespace ResizeQueryManager {
-//     /**
-//      * Generic callback type for handlers.
-//      */
-//     export type Callback<T> = (e: T) => void;
-//     /**
-//      * Predicate for container evaluation.
-//      *
-//      * `target` is the observed container (defaults to the element's own AnyElement).
-//      */
-//     export type Predicate<T extends AnyElement> = (e: T, target: AnyElement) => boolean;
-//     /**
-//      * Internal record stored in the manager.
-//      */
-//     export type Record<T extends AnyElement> = {
-//         /** Owning AnyElement instance. */
-//         owner: T;
-//         /** User-provided predicate. */
-//         predicate: Predicate<T>;
-//         /** Called when predicate becomes true. */
-//         on_true?: Callback<T>;
-//         /** Called when predicate becomes false. */
-//         on_false?: Callback<T>;
-//         /** Last match state for flip detection. */
-//         last_match?: boolean;
-//     };
-//     /**
-//      * Per-element subscription handle.
-//      */
-//     export type Subscription<T extends AnyElement> = {
-//         /** Container element being observed. */
-//         target: AnyElement;
-//         /** Record registered with the manager. */
-//         record: Record<T>;
-//         /** Remove function for cleanup. */
-//         remove: () => void;
-//     };
-// }

package/frontend/dist/frontend/src/elements/types.d.ts

@@ -1,52 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved.
- */
-/** Null / undefined alias. */
-export type None = undefined | null;
-/**
- * Return type helper for common VElement methods.
- * Resolving the return type to `This` if `V` is `undefined,
- * or to `R` if no value is passed and `V` is undefined.
- */
-export type ValueOrThis<V, R, This> = V extends undefined ? R : This;
-/** Options for configuring a border through {@link VElement.border}. */
-export interface BorderOpts {
-    /** Default color. */
-    color?: string;
-    /**
-     *  Border width.
-     * @default 1px
-     */
-    width?: string | number;
-    /**
-     * Border style.
-     * @default "solid"
-     */
-    style?: string;
-    /**
-     * Border radius.
-     * @default 0
-     */
-    radius?: string | number;
-    /**
-     * Top border enabled or a specific color for this border.
-     * @default true
-     */
-    top?: boolean | string;
-    /**
-     * Bottom border enabled or a specific color for this border.
-     * @default true
-     */
-    bottom?: boolean | string;
-    /**
-     * Left border enabled or a specific color for this border.
-     * @default true
-     */
-    left?: boolean | string;
-    /**
-     * Right border enabled or a specific color for this border.
-     * @default true
-     */
-    right?: boolean | string;
-}

package/frontend/dist/frontend/src/elements/types.js

@@ -1,5 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved.
- */
-export {};

package/frontend/dist/frontend/src/index.d.ts

@@ -1,21 +0,0 @@
-export declare const production: boolean;
-export * from "./modules/auth.js";
-export * from "./modules/color.js";
-export * from "./modules/compression.js";
-export * from "./modules/cookies.js";
-export * from "./modules/events.js";
-export * from "./modules/google.js";
-export * from "./modules/meta.js";
-export * as Payments from "./modules/stripe/index.m.js";
-export * as payments from "./modules/stripe/index.m.js";
-export * from "./modules/statics.js";
-export * from "./modules/support.js";
-export * from "./modules/themes.js";
-export * from "./modules/user.js";
-export * from "./modules/utils.js";
-export * from "./modules/theme.js";
-export * from "./modules/request.js";
-export * from "./modules/attachment.js";
-export * from "./elements/module.js";
-export * from "./ui/ui.js";
-export * from "../../backend/src/status.js";

package/frontend/dist/frontend/src/index.js

@@ -1,29 +0,0 @@
-// Vars.
-// @ts-ignore
-export const production = "{{PRODUCTION}}" === "true";
-// Modules.
-export * from "./modules/auth.js";
-export * from "./modules/color.js";
-// export * from "./modules/colors.js"
-export * from "./modules/compression.js";
-export * from "./modules/cookies.js";
-export * from "./modules/events.js";
-export * from "./modules/google.js";
-export * from "./modules/meta.js";
-// export * from "./modules/paddle.js"
-export * as Payments from "./modules/stripe/index.m.js";
-export * as payments from "./modules/stripe/index.m.js";
-export * from "./modules/statics.js";
-export * from "./modules/support.js";
-export * from "./modules/themes.js";
-export * from "./modules/user.js";
-export * from "./modules/utils.js";
-export * from "./modules/theme.js";
-export * from "./modules/request.js";
-export * from "./modules/attachment.js";
-// Elements.
-export * from "./elements/module.js";
-// VoltUI.
-export * from "./ui/ui.js";
-// Backend.
-export * from "../../backend/src/status.js";