@vandenberghinc/volt 1.1.2

package/frontend/dist/modules/cookies.d.ts

@@ -0,0 +1,17 @@
+declare const Cookies: {
+    _cookies: {
+        [key: string]: string;
+    };
+    _last_cookies: string;
+    _disabled: boolean;
+    is_parse_required(): boolean;
+    get(name?: string | null): string | {
+        [key: string]: string;
+    } | undefined;
+    has_preference(): boolean;
+    is_accepted(): boolean;
+    enable(_set_storage?: boolean): void;
+    disable(_set_storage?: boolean): void;
+    _init(): void;
+};
+export { Cookies };

package/frontend/dist/modules/cookies.js

@@ -0,0 +1,166 @@
+/*
+ * Author: Daan van den Bergh
+ * Copyright: © 2022 - 2024 Daan van den Bergh.
+ */
+// Imports.
+import { Google } from "./google.js";
+// Cookies object.
+const Cookies = {
+    _cookies: {},
+    _last_cookies: '',
+    _disabled: false,
+    // Check if the cookies need to be parsed again.
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Is Parse Required
+        @desc: Checks if cookies need to be parsed again.
+    */
+    is_parse_required() {
+        return document.cookie !== this._last_cookies;
+    },
+    // Get the cookies or a cookie by name.
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Get cookie
+        @desc: Get a cookie by name.
+        @experimental: true
+        @param:
+            @name: name
+            @description The name of the cookie.
+    */
+    get(name = null) {
+        if (document.cookie === this._last_cookies) {
+            if (name != null) {
+                return this._cookies[name];
+            }
+            return this._cookies;
+        }
+        // Attributes.
+        this._cookies = {};
+        this._last_cookies = document.cookie;
+        // Vars.
+        let is_key = true, is_str = null;
+        let key = "", value = "";
+        // Wrapper.
+        const append = () => {
+            if (key.length > 0) {
+                this._cookies[key] = value;
+            }
+            value = "";
+            key = "";
+            is_key = true;
+            is_str = null;
+        };
+        // Parse.
+        for (let i = 0; i < document.cookie.length; i++) {
+            const c = document.cookie.charAt(i);
+            // Is key.
+            if (is_key) {
+                if (c === " " || c === "\t") {
+                    continue;
+                }
+                else if (c === "=") {
+                    is_key = false;
+                }
+                else {
+                    key += c;
+                }
+            }
+            // Is value.
+            else {
+                // End of string.
+                if (is_str != null && is_str === c) {
+                    value = value.substr(1, value.length - 1);
+                    append();
+                }
+                // End of cookie.
+                else if (c === ";") {
+                    append();
+                }
+                // Append to value.
+                else {
+                    // Start of string.
+                    if (value.length === 0 && (c === "\"" || c === "'")) {
+                        is_str = c;
+                    }
+                    value += c;
+                }
+            }
+        }
+        append();
+        if (name != null) {
+            return this._cookies[name];
+        }
+        return this._cookies;
+    },
+    // Check if all the cookies are accepted.
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Has Preference
+        @desc: Checks if the user has set a cookie preference (enabled or disabled).
+    */
+    has_preference() {
+        const pref = localStorage.getItem("volt_cookies_enabled");
+        return pref === "true" || pref === "false";
+    },
+    // Check if all the cookies are accepted.
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Is Accepted
+        @desc: Checks if cookies are accepted by the user.
+    */
+    is_accepted() {
+        return localStorage.getItem("volt_cookies_enabled") === "true";
+    },
+    // Enable cookies (opt-in).
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Enable Cookies
+        @desc: Enables cookies (opt-in) and updates the user's preference.
+        @param:
+            @name: _set_storage
+            @description Whether to update the localStorage preference (default: true).
+    */
+    enable(_set_storage = true) {
+        this._disabled = true;
+        if (_set_storage) {
+            localStorage.setItem("volt_cookies_enabled", "true");
+        }
+        Google.disable_tracking();
+    },
+    // Disable cookies (opt-out).
+    /*  @docs:
+        @nav: Frontend
+        @chapter: Cookies
+        @title: Disable Cookies
+        @desc: Disables cookies (opt-out) and updates the user's preference.
+        @param:
+            @name: _set_storage
+            @description Whether to update the localStorage preference (default: true).
+    */
+    disable(_set_storage = true) {
+        this._disabled = false;
+        if (_set_storage) {
+            localStorage.setItem("volt_cookies_enabled", "false");
+        }
+        Google.enable_tracking();
+    },
+    // Initialize the cookies.
+    _init() {
+        if (this.is_accepted()) {
+            this.enable(false);
+        }
+        else {
+            this.disable(false);
+        }
+    }
+};
+// Initialize cookies on load.
+Cookies._init();
+// Export.
+export { Cookies };

package/frontend/dist/modules/date.d.ts

@@ -0,0 +1,142 @@
+interface IncrementOptions {
+    seconds?: number;
+    minutes?: number;
+    hours?: number;
+    days?: number;
+    weeks?: number;
+    months?: number;
+    years?: number;
+}
+/** @docs
+ *  @chapter Types
+ *  @title Date
+ *  @desc Extended Date class with additional formatting and manipulation capabilities
+ */
+export declare class VDate extends Date {
+    constructor();
+    constructor(value: number | string);
+    constructor(valueOfDate: Date | VDate);
+    constructor(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number);
+    constructor(valueOrYear?: string | number | Date, month?: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number);
+    /** @docs
+     *  @title Format
+     *  @desc Format a date object to a string using various format specifiers
+     *  @param
+     *      @name format
+     *      @desc The date format string using % specifiers (e.g., %Y-%m-%d)
+     *      @type string
+     *  @returns
+     *      @type string
+     *      @desc The formatted date string
+     */
+    format(format: string): string;
+    /** @docs
+     *  @title Milliseconds
+     *  @desc Get the timestamp in milliseconds
+     *  @returns
+     *      @type number
+     *      @desc The timestamp in milliseconds
+     */
+    msec(): number;
+    /** @docs
+     *  @title Seconds
+     *  @desc Get the timestamp in seconds
+     *  @returns
+     *      @type number
+     *      @desc The timestamp in seconds
+     */
+    sec(): number;
+    /** @docs
+     *  @title Minute start
+     *  @desc Get a new date object set to the start of the current minute
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the minute
+     */
+    minute_start(): VDate;
+    /** @docs
+     *  @title Hour start
+     *  @desc Get a new date object set to the start of the current hour
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the hour
+     */
+    hour_start(): VDate;
+    /** @docs
+     *  @title Day start
+     *  @desc Get a new date object set to the start of the current day
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the day
+     */
+    day_start(): VDate;
+    /** @docs
+     *  @title Week start
+     *  @desc Get a new date object set to the start of the current week
+     *  @param
+     *      @name sunday_start
+     *      @desc Whether to use Sunday (true) or Monday (false) as the start of the week
+     *      @type boolean
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the week
+     */
+    week_start(sunday_start?: boolean): VDate;
+    /** @docs
+     *  @title Month start
+     *  @desc Get a new date object set to the start of the current month
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the month
+     */
+    month_start(): VDate;
+    /** @docs
+     *  @title Quarter year start
+     *  @desc Get a new date object set to the start of the current quarter
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the quarter
+     */
+    quarter_year_start(): VDate;
+    /** @docs
+     *  @title Half year start
+     *  @desc Get a new date object set to the start of the current half year
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the half year
+     */
+    half_year_start(): VDate;
+    /** @docs
+     *  @title Year start
+     *  @desc Get a new date object set to the start of the current year
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object set to the start of the year
+     */
+    year_start(): VDate;
+    /** @docs
+     *  @title Increment date
+     *  @desc Create a new date incremented by the specified amounts
+     *  @param
+     *      @name options
+     *      @desc Object containing increment values
+     *      @type IncrementOptions
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object incremented by the specified amounts
+     */
+    increment({ seconds, minutes, hours, days, weeks, months, years }: IncrementOptions): VDate;
+    /** @docs
+     *  @title Decrement date
+     *  @desc Create a new date decremented by the specified amounts
+     *  @param
+     *      @name options
+     *      @desc Object containing decrement values
+     *      @type IncrementOptions
+     *  @returns
+     *      @type VDate
+     *      @desc A new date object decremented by the specified amounts
+     */
+    decrement({ seconds, minutes, hours, days, weeks, months, years }: IncrementOptions): VDate;
+}
+export { VDate as Date };