@zappzarapp/browser-utils 1.0.0

package/dist/storage/StorageManager.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,9 @@
+export { BaseStorageManager } from './BaseStorageManager';
+export type { BaseStorageStats } from './BaseStorageManager';
+export { StorageManager } from './StorageManager';
+export type { StorageChangeEvent, StorageStats } from './StorageManager';
+export { StorageConfig } from './StorageConfig';
+export type { StorageConfigOptions } from './StorageConfig';
+export { MemoryStorage } from './MemoryStorage';
+export type { StorageEntry } from './MemoryStorage';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,5 @@
+export { BaseStorageManager } from './BaseStorageManager';
+export { StorageManager } from './StorageManager';
+export { StorageConfig } from './StorageConfig';
+export { MemoryStorage } from './MemoryStorage';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/url/HistoryManager.d.ts

@@ -0,0 +1,24 @@
+import { ValidationError, UrlError, Result } from '../core';
+import type { CleanupFn } from '../core';
+export interface HistoryState {
+    [key: string]: unknown;
+}
+export declare const HistoryManager: {
+    readonly push: (url: string, state?: HistoryState) => void;
+    readonly pushResult: (url: string, state?: HistoryState) => Result<void, ValidationError | UrlError>;
+    readonly replace: (url: string, state?: HistoryState) => void;
+    readonly replaceResult: (url: string, state?: HistoryState) => Result<void, ValidationError | UrlError>;
+    readonly back: () => void;
+    readonly forward: () => void;
+    readonly go: (delta: number) => void;
+    readonly currentState: <T extends HistoryState = HistoryState>() => T | null;
+    readonly length: () => number;
+    readonly scrollRestoration: () => ScrollRestoration | null;
+    readonly setScrollRestoration: (mode: ScrollRestoration) => void;
+    readonly onPopState: <T extends HistoryState = HistoryState>(handler: (state: T | null, event: PopStateEvent) => void) => CleanupFn;
+    readonly onHashChange: (handler: (newHash: string, oldHash: string, event: HashChangeEvent) => void) => CleanupFn;
+    readonly isSupported: () => boolean;
+    readonly executeHistoryAction: (url: string, state: HistoryState | undefined, action: "push" | "replace") => Result<void, ValidationError | UrlError>;
+    readonly validateState: (state: unknown) => void;
+};
+//# sourceMappingURL=HistoryManager.d.ts.map

package/dist/url/HistoryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryManager.d.ts","sourceRoot":"","sources":["../../src/url/HistoryManager.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAa,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,cAAc;yBAWf,MAAM,UAAU,YAAY,KAAG,IAAI;+BAc7B,MAAM,UAAU,YAAY,KAAG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,CAAC;4BAU1E,MAAM,UAAU,YAAY,KAAG,IAAI;kCAc7B,MAAM,UAAU,YAAY,KAAG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,CAAC;yBAOlF,IAAI;4BASD,IAAI;yBAUL,MAAM,KAAG,IAAI;4BAaV,CAAC,SAAS,YAAY,sBAAoB,CAAC,GAAG,IAAI;2BAUrD,MAAM;sCAUK,iBAAiB,GAAG,IAAI;0CAUlB,iBAAiB,KAAG,IAAI;0BAcxC,CAAC,SAAS,YAAY,0BACtB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,KACvD,SAAS;qCAqBD,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,KAC1E,SAAS;gCAyBG,OAAO;yCASf,MAAM,SACJ,YAAY,GAAG,SAAS,UACvB,MAAM,GAAG,SAAS,KACzB,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,CAAC;oCAoCtB,OAAO,KAAG,IAAI;CAc3B,CAAC"}

package/dist/url/HistoryManager.js

@@ -0,0 +1,134 @@
+import { Validator, UrlError, Result } from '../core';
+export const HistoryManager = {
+    push(url, state) {
+        Validator.urlSafe(url);
+        HistoryManager.validateState(state);
+        if (typeof history === 'undefined') {
+            throw UrlError.navigationFailed(new Error('History API not available'));
+        }
+        history.pushState(state ?? null, '', url);
+    },
+    pushResult(url, state) {
+        return HistoryManager.executeHistoryAction(url, state, 'push');
+    },
+    replace(url, state) {
+        Validator.urlSafe(url);
+        HistoryManager.validateState(state);
+        if (typeof history === 'undefined') {
+            throw UrlError.navigationFailed(new Error('History API not available'));
+        }
+        history.replaceState(state ?? null, '', url);
+    },
+    replaceResult(url, state) {
+        return HistoryManager.executeHistoryAction(url, state, 'replace');
+    },
+    back() {
+        if (typeof history !== 'undefined') {
+            history.back();
+        }
+    },
+    forward() {
+        if (typeof history !== 'undefined') {
+            history.forward();
+        }
+    },
+    go(delta) {
+        if (typeof history !== 'undefined') {
+            history.go(delta);
+        }
+    },
+    currentState() {
+        if (typeof history === 'undefined') {
+            return null;
+        }
+        return history.state;
+    },
+    length() {
+        if (typeof history === 'undefined') {
+            return 0;
+        }
+        return history.length;
+    },
+    scrollRestoration() {
+        if (typeof history === 'undefined') {
+            return null;
+        }
+        return history.scrollRestoration;
+    },
+    setScrollRestoration(mode) {
+        if (typeof history !== 'undefined') {
+            history.scrollRestoration = mode;
+        }
+    },
+    onPopState(handler) {
+        if (typeof window === 'undefined') {
+            return () => { };
+        }
+        const listener = (event) => {
+            handler(event.state, event);
+        };
+        window.addEventListener('popstate', listener);
+        return () => {
+            window.removeEventListener('popstate', listener);
+        };
+    },
+    onHashChange(handler) {
+        if (typeof window === 'undefined') {
+            return () => { };
+        }
+        const listener = (event) => {
+            const newHash = new URL(event.newURL).hash;
+            const oldHash = new URL(event.oldURL).hash;
+            handler(newHash, oldHash, event);
+        };
+        window.addEventListener('hashchange', listener);
+        return () => {
+            window.removeEventListener('hashchange', listener);
+        };
+    },
+    isSupported() {
+        return typeof history !== 'undefined' && typeof history.pushState === 'function';
+    },
+    executeHistoryAction(url, state, action) {
+        const urlResult = Validator.urlSafeResult(url);
+        if (Result.isErr(urlResult)) {
+            return urlResult;
+        }
+        try {
+            HistoryManager.validateState(state);
+        }
+        catch (e) {
+            if (e instanceof UrlError) {
+                return Result.err(e);
+            }
+            return Result.err(UrlError.invalidState(e.message));
+        }
+        if (typeof history === 'undefined') {
+            return Result.err(UrlError.navigationFailed(new Error('History API not available')));
+        }
+        try {
+            if (action === 'push') {
+                history.pushState(state ?? null, '', url);
+            }
+            else {
+                history.replaceState(state ?? null, '', url);
+            }
+            return Result.ok(undefined);
+        }
+        catch (e) {
+            return Result.err(UrlError.navigationFailed(e));
+        }
+    },
+    validateState(state) {
+        if (state === undefined || state === null) {
+            return;
+        }
+        try {
+            JSON.stringify(state);
+        }
+        catch {
+            throw UrlError.invalidState('State object is not serializable (may contain circular references)');
+        }
+    },
+};
+//# sourceMappingURL=HistoryManager.js.map

package/dist/url/HistoryManager.js.map

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

package/dist/url/QueryParams.d.ts

@@ -0,0 +1,32 @@
+export type QueryParamValue = string | string[];
+export declare class QueryParams {
+    private readonly params;
+    private constructor();
+    static create(): QueryParams;
+    static parse(search: string): QueryParams;
+    static current(): QueryParams;
+    static fromObject(obj: Record<string, QueryParamValue>): QueryParams;
+    static toObject(search: string): Record<string, QueryParamValue>;
+    static stringify(obj: Record<string, QueryParamValue>): string;
+    set(name: string, value: string): QueryParams;
+    append(name: string, value: string): QueryParams;
+    delete(name: string): QueryParams;
+    setAll(params: Record<string, string>): QueryParams;
+    merge(other: QueryParams | Record<string, QueryParamValue>): QueryParams;
+    clear(): QueryParams;
+    get(name: string): string | null;
+    getAll(name: string): string[];
+    has(name: string): boolean;
+    keys(): string[];
+    values(): string[];
+    entries(): Array<[string, string]>;
+    get size(): number;
+    get isEmpty(): boolean;
+    toString(): string;
+    toQueryString(): string;
+    toObject(): Record<string, QueryParamValue>;
+    toURLSearchParams(): URLSearchParams;
+    forEach(callback: (value: string, key: string) => void): void;
+    [Symbol.iterator](): IterableIterator<[string, string]>;
+}
+//# sourceMappingURL=QueryParams.d.ts.map

package/dist/url/QueryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryParams.d.ts","sourceRoot":"","sources":["../../src/url/QueryParams.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAEhD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAWP,MAAM,CAAC,MAAM,IAAI,WAAW;IAQ5B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAQzC,MAAM,CAAC,OAAO,IAAI,WAAW;IAW7B,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,WAAW;IAwBpE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAQhE,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM;IAW9D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAS7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAShD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IASjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW;IAWnD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,WAAW;IAqBxE,KAAK,IAAI,WAAW;IAWpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOhC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAO9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO1B,IAAI,IAAI,MAAM,EAAE;IAOhB,MAAM,IAAI,MAAM,EAAE;IAOlB,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAOlC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,OAAO,IAAI,OAAO,CAErB;IASD,QAAQ,IAAI,MAAM;IAOlB,aAAa,IAAI,MAAM;IASvB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAc3C,iBAAiB,IAAI,eAAe;IAOpC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAO7D,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGxD"}

package/dist/url/QueryParams.js

@@ -0,0 +1,130 @@
+export class QueryParams {
+    params;
+    constructor(params) {
+        this.params = params;
+    }
+    static create() {
+        return new QueryParams(new URLSearchParams());
+    }
+    static parse(search) {
+        const cleaned = search.startsWith('?') ? search.substring(1) : search;
+        return new QueryParams(new URLSearchParams(cleaned));
+    }
+    static current() {
+        if (typeof window === 'undefined' || !window.location) {
+            return QueryParams.create();
+        }
+        return QueryParams.parse(window.location.search);
+    }
+    static fromObject(obj) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(obj)) {
+            if (Array.isArray(value)) {
+                for (const v of value) {
+                    params.append(key, v);
+                }
+            }
+            else {
+                params.set(key, value);
+            }
+        }
+        return new QueryParams(params);
+    }
+    static toObject(search) {
+        const params = QueryParams.parse(search);
+        return params.toObject();
+    }
+    static stringify(obj) {
+        return QueryParams.fromObject(obj).toString();
+    }
+    set(name, value) {
+        const newParams = new URLSearchParams(this.params);
+        newParams.set(name, value);
+        return new QueryParams(newParams);
+    }
+    append(name, value) {
+        const newParams = new URLSearchParams(this.params);
+        newParams.append(name, value);
+        return new QueryParams(newParams);
+    }
+    delete(name) {
+        const newParams = new URLSearchParams(this.params);
+        newParams.delete(name);
+        return new QueryParams(newParams);
+    }
+    setAll(params) {
+        const newParams = new URLSearchParams(this.params);
+        for (const [name, value] of Object.entries(params)) {
+            newParams.set(name, value);
+        }
+        return new QueryParams(newParams);
+    }
+    merge(other) {
+        const newParams = new URLSearchParams(this.params);
+        const otherObj = other instanceof QueryParams ? other.toObject() : other;
+        for (const [key, value] of Object.entries(otherObj)) {
+            if (Array.isArray(value)) {
+                newParams.delete(key);
+                for (const v of value) {
+                    newParams.append(key, v);
+                }
+            }
+            else {
+                newParams.set(key, value);
+            }
+        }
+        return new QueryParams(newParams);
+    }
+    clear() {
+        return QueryParams.create();
+    }
+    get(name) {
+        return this.params.get(name);
+    }
+    getAll(name) {
+        return this.params.getAll(name);
+    }
+    has(name) {
+        return this.params.has(name);
+    }
+    keys() {
+        return Array.from(this.params.keys());
+    }
+    values() {
+        return Array.from(this.params.values());
+    }
+    entries() {
+        return Array.from(this.params.entries());
+    }
+    get size() {
+        return Array.from(this.params).length;
+    }
+    get isEmpty() {
+        return this.size === 0;
+    }
+    toString() {
+        return this.params.toString();
+    }
+    toQueryString() {
+        const str = this.toString();
+        return str ? `?${str}` : '';
+    }
+    toObject() {
+        const result = {};
+        for (const key of this.params.keys()) {
+            const values = this.params.getAll(key);
+            result[key] = values.length === 1 ? values[0] : values;
+        }
+        return result;
+    }
+    toURLSearchParams() {
+        return new URLSearchParams(this.params);
+    }
+    forEach(callback) {
+        this.params.forEach(callback);
+    }
+    [Symbol.iterator]() {
+        return this.params[Symbol.iterator]();
+    }
+}
+//# sourceMappingURL=QueryParams.js.map

package/dist/url/QueryParams.js.map

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

package/dist/url/UrlBuilder.d.ts

@@ -0,0 +1,38 @@
+import { Result, UrlError, ValidationError } from '../core';
+export declare class UrlBuilder {
+    private readonly url;
+    private constructor();
+    static from(url: string, base?: string): UrlBuilder;
+    static fromResult(url: string, base?: string): Result<UrlBuilder, ValidationError | UrlError>;
+    static current(): UrlBuilder;
+    static currentResult(): Result<UrlBuilder, UrlError>;
+    static fromURL(url: URL): UrlBuilder;
+    withPath(path: string): UrlBuilder;
+    withQuery(query: string): UrlBuilder;
+    withParam(name: string, value: string): UrlBuilder;
+    withAppendedParam(name: string, value: string): UrlBuilder;
+    withoutParam(name: string): UrlBuilder;
+    withParams(params: Record<string, string>): UrlBuilder;
+    withoutQuery(): UrlBuilder;
+    withHash(hash: string): UrlBuilder;
+    withoutHash(): UrlBuilder;
+    withProtocol(protocol: string): UrlBuilder;
+    withHost(host: string): UrlBuilder;
+    withPort(port: string | number): UrlBuilder;
+    get protocol(): string;
+    get hostname(): string;
+    get host(): string;
+    get port(): string;
+    get pathname(): string;
+    get search(): string;
+    get hash(): string;
+    get origin(): string;
+    getParam(name: string): string | null;
+    getAllParams(name: string): string[];
+    hasParam(name: string): boolean;
+    params(): Record<string, string>;
+    toString(): string;
+    toURL(): URL;
+    get href(): string;
+}
+//# sourceMappingURL=UrlBuilder.d.ts.map

package/dist/url/UrlBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlBuilder.d.ts","sourceRoot":"","sources":["../../src/url/UrlBuilder.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAE1B,OAAO;IAaP,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAcnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,QAAQ,CAAC;IAkB7F,MAAM,CAAC,OAAO,IAAI,UAAU;IAW5B,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;IAWpD,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU;IAWpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IASlC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IASpC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;IASlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;IAS1D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAStC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU;IAWtD,YAAY,IAAI,UAAU;IAS1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IASlC,WAAW,IAAI,UAAU;IASzB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAY1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IASlC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU;IAa3C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAKD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAKD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAKD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAKD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAKD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOrC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAOpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO/B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAehC,QAAQ,IAAI,MAAM;IAOlB,KAAK,IAAI,GAAG;IAOZ,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/url/UrlBuilder.js

@@ -0,0 +1,159 @@
+import { Result, UrlError, Validator } from '../core';
+export class UrlBuilder {
+    url;
+    constructor(url) {
+        this.url = url;
+    }
+    static from(url, base) {
+        Validator.urlSafe(url);
+        try {
+            const parsed = new URL(url, base);
+            return new UrlBuilder(parsed);
+        }
+        catch {
+            throw UrlError.invalidFormat(url);
+        }
+    }
+    static fromResult(url, base) {
+        const safeResult = Validator.urlSafeResult(url);
+        if (Result.isErr(safeResult)) {
+            return safeResult;
+        }
+        try {
+            const parsed = new URL(url, base);
+            return Result.ok(new UrlBuilder(parsed));
+        }
+        catch {
+            return Result.err(UrlError.invalidFormat(url));
+        }
+    }
+    static current() {
+        if (typeof window === 'undefined' || !window.location) {
+            throw new Error('UrlBuilder.current() requires browser environment');
+        }
+        return new UrlBuilder(new URL(window.location.href));
+    }
+    static currentResult() {
+        if (typeof window === 'undefined' || !window.location) {
+            return Result.err(UrlError.navigationFailed(new Error('Not in browser environment')));
+        }
+        return Result.ok(new UrlBuilder(new URL(window.location.href)));
+    }
+    static fromURL(url) {
+        return new UrlBuilder(new URL(url.href));
+    }
+    withPath(path) {
+        const newUrl = new URL(this.url.href);
+        newUrl.pathname = path;
+        return new UrlBuilder(newUrl);
+    }
+    withQuery(query) {
+        const newUrl = new URL(this.url.href);
+        newUrl.search = query.startsWith('?') ? query : `?${query}`;
+        return new UrlBuilder(newUrl);
+    }
+    withParam(name, value) {
+        const newUrl = new URL(this.url.href);
+        newUrl.searchParams.set(name, value);
+        return new UrlBuilder(newUrl);
+    }
+    withAppendedParam(name, value) {
+        const newUrl = new URL(this.url.href);
+        newUrl.searchParams.append(name, value);
+        return new UrlBuilder(newUrl);
+    }
+    withoutParam(name) {
+        const newUrl = new URL(this.url.href);
+        newUrl.searchParams.delete(name);
+        return new UrlBuilder(newUrl);
+    }
+    withParams(params) {
+        const newUrl = new URL(this.url.href);
+        for (const [name, value] of Object.entries(params)) {
+            newUrl.searchParams.set(name, value);
+        }
+        return new UrlBuilder(newUrl);
+    }
+    withoutQuery() {
+        const newUrl = new URL(this.url.href);
+        newUrl.search = '';
+        return new UrlBuilder(newUrl);
+    }
+    withHash(hash) {
+        const newUrl = new URL(this.url.href);
+        newUrl.hash = hash.startsWith('#') ? hash : `#${hash}`;
+        return new UrlBuilder(newUrl);
+    }
+    withoutHash() {
+        const newUrl = new URL(this.url.href);
+        newUrl.hash = '';
+        return new UrlBuilder(newUrl);
+    }
+    withProtocol(protocol) {
+        const normalized = protocol.endsWith(':') ? protocol : `${protocol}:`;
+        Validator.urlSafe(`${normalized}//x`);
+        const newUrl = new URL(this.url.href);
+        newUrl.protocol = normalized;
+        return new UrlBuilder(newUrl);
+    }
+    withHost(host) {
+        const newUrl = new URL(this.url.href);
+        newUrl.host = host;
+        return new UrlBuilder(newUrl);
+    }
+    withPort(port) {
+        const newUrl = new URL(this.url.href);
+        newUrl.port = String(port);
+        return new UrlBuilder(newUrl);
+    }
+    get protocol() {
+        return this.url.protocol;
+    }
+    get hostname() {
+        return this.url.hostname;
+    }
+    get host() {
+        return this.url.host;
+    }
+    get port() {
+        return this.url.port;
+    }
+    get pathname() {
+        return this.url.pathname;
+    }
+    get search() {
+        return this.url.search;
+    }
+    get hash() {
+        return this.url.hash;
+    }
+    get origin() {
+        return this.url.origin;
+    }
+    getParam(name) {
+        return this.url.searchParams.get(name);
+    }
+    getAllParams(name) {
+        return this.url.searchParams.getAll(name);
+    }
+    hasParam(name) {
+        return this.url.searchParams.has(name);
+    }
+    params() {
+        const result = {};
+        for (const [key, value] of this.url.searchParams) {
+            result[key] = value;
+        }
+        return result;
+    }
+    toString() {
+        return this.url.href;
+    }
+    toURL() {
+        return new URL(this.url.href);
+    }
+    get href() {
+        return this.url.href;
+    }
+}
+//# sourceMappingURL=UrlBuilder.js.map

package/dist/url/UrlBuilder.js.map

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

package/dist/url/index.d.ts

@@ -0,0 +1,6 @@
+export { UrlBuilder } from './UrlBuilder.js';
+export { QueryParams } from './QueryParams.js';
+export type { QueryParamValue } from './QueryParams.js';
+export { HistoryManager } from './HistoryManager.js';
+export type { HistoryState } from './HistoryManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/url/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/url/index.js

@@ -0,0 +1,4 @@
+export { UrlBuilder } from './UrlBuilder.js';
+export { QueryParams } from './QueryParams.js';
+export { HistoryManager } from './HistoryManager.js';
+//# sourceMappingURL=index.js.map

package/dist/url/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/visibility/VisibilityManager.d.ts

@@ -0,0 +1,10 @@
+import type { CleanupFn } from '../core';
+export declare const VisibilityManager: {
+    readonly isVisible: () => boolean;
+    readonly isHidden: () => boolean;
+    readonly getState: () => DocumentVisibilityState;
+    readonly onChange: (handler: (state: DocumentVisibilityState) => void) => CleanupFn;
+    readonly onVisible: (handler: () => void) => CleanupFn;
+    readonly onHidden: (handler: () => void) => CleanupFn;
+};
+//# sourceMappingURL=VisibilityManager.d.ts.map

package/dist/visibility/VisibilityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisibilityManager.d.ts","sourceRoot":"","sources":["../../src/visibility/VisibilityManager.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,eAAO,MAAM,iBAAiB;8BASf,OAAO;6BAWR,OAAO;6BAWP,uBAAuB;iCAgBjB,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,KAAG,SAAS;kCAqBnD,MAAM,IAAI,KAAG,SAAS;iCAuBvB,MAAM,IAAI,KAAG,SAAS;CAiBhC,CAAC"}