@cedx/base 0.6.0 → 0.7.0

package/lib/UI/ThemeDropdown.js

@@ -1,80 +0,0 @@
-import { AppTheme, getIcon } from "#Html/AppTheme.js";
-/**
- * A dropdown menu for switching the application theme.
- */
-export class ThemeDropdown extends HTMLElement {
-    /**
-     * The media query used to check the application theme.
-     */
-    #mediaQuery = matchMedia("(prefers-color-scheme: dark)");
-    /**
-     * The key of the storage entry providing the saved theme mode.
-     */
-    #storageKey = this.getAttribute("storageKey") ?? "AppTheme";
-    /**
-     * The current application theme.
-     */
-    #theme;
-    /**
-     * Creates a new theme dropdown.
-     */
-    constructor() {
-        super();
-        const theme = localStorage.getItem(this.#storageKey);
-        this.#theme = Object.values(AppTheme).includes(theme) ? theme : AppTheme.System;
-        for (const button of this.querySelectorAll("button"))
-            button.addEventListener("click", this.#setTheme.bind(this));
-    }
-    /**
-     * Registers the component.
-     */
-    static {
-        customElements.define("theme-dropdown", this);
-    }
-    /**
-     * The current application theme.
-     */
-    get theme() {
-        return this.#theme;
-    }
-    set theme(value) {
-        localStorage.setItem(this.#storageKey, this.#theme = value);
-        this.#applyTheme();
-    }
-    /**
-     * Method invoked when this component is connected.
-     */
-    connectedCallback() {
-        this.#mediaQuery.addEventListener("change", this);
-        this.#applyTheme();
-    }
-    /**
-     * Method invoked when this component is disconnected.
-     */
-    disconnectedCallback() {
-        this.#mediaQuery.removeEventListener("change", this);
-    }
-    /**
-     * Handles the events.
-     */
-    handleEvent() {
-        this.#applyTheme();
-    }
-    /**
-     * Applies the theme to the document.
-     */
-    #applyTheme() {
-        const theme = this.#theme == AppTheme.System ? (this.#mediaQuery.matches ? AppTheme.Dark : AppTheme.Light) : this.#theme;
-        document.documentElement.dataset.bsTheme = theme.toLowerCase();
-        this.querySelector(".dropdown-toggle > .icon").textContent = getIcon(this.#theme);
-        this.querySelector(`button[data-theme="${this.#theme}"]`).appendChild(this.querySelector(".dropdown-item > .icon"));
-    }
-    /**
-     * Changes the current theme.
-     * @param event The dispatched event.
-     */
-    #setTheme(event) {
-        const button = event.target.closest("button");
-        this.theme = button.dataset.theme;
-    }
-}

package/src/Client/Abstractions/ILoadingIndicator.ts

@@ -1,16 +0,0 @@
-/**
- * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
- */
-export interface ILoadingIndicator {
-
-	/**
-	 * Starts the loading indicator.
-	 */
-	start: () => void;
-
-	/**
-	 * Stops the loading indicator.
-	 * @param options Value indicating whether to force the loading indicator to stop.
-	 */
-	stop: (options?: {force?: boolean}) => void;
-}

package/src/Client/DependencyInjection/Container.ts

@@ -1,75 +0,0 @@
-/**
- * Provides a dependency container.
- */
-export class Container {
-
-	/**
-	 * The registered factories.
-	 */
-	readonly #factories = new Map<ContainerToken, () => any>;
-
-	/**
-	 * The registered services.
-	 */
-	readonly #services = new Map<ContainerToken, any>;
-
-	/**
-	 * Removes the service registered with the specified identifier.
-	 * @param id The identification token.
-	 */
-	delete(id: ContainerToken): void {
-		this.#factories.delete(id);
-		this.#services.delete(id);
-	}
-
-	/**
-	 * Gets the service registered with the specified identifier.
-	 * @param id The identification token.
-	 * @returns The instance of the service registered with the specified identifier.
-	 * @throws `Error` if there is no factory registered with the specified identifier.
-	 */
-	get<T>(id: ContainerToken): T { // eslint-disable-line @typescript-eslint/no-unnecessary-type-parameters
-		if (!this.#services.has(id))
-			if (this.#factories.has(id)) this.set(id, this.#factories.get(id)!.call(this));
-			else if (typeof id == "function") this.set(id, Reflect.construct(id, []));
-			else throw Error("There is no factory registered with the specified identifier.");
-
-		return this.#services.get(id) as T;
-	}
-
-	/**
-	 * Gets a value indicating whether this container has a service registered with the specified identifier.
-	 * @param id The identification token.
-	 * @returns `true` if a service registered with the specified identifier exists in this container, otherwise `false`.
-	 */
-	has(id: ContainerToken): boolean {
-		return this.#factories.has(id) || this.#services.has(id);
-	}
-
-	/**
-	 * Registers a service factory with this container.
-	 * @param id The identification token.
-	 * @param factory The service factory.
-	 * @returns This instance.
-	 */
-	register(id: ContainerToken, factory: () => unknown): this {
-		this.#factories.set(id, factory);
-		return this;
-	}
-
-	/**
-	 * Registers a service instance with this container.
-	 * @param id The identification token.
-	 * @param service The service instance.
-	 * @returns This instance.
-	 */
-	set(id: ContainerToken, service: unknown): this {
-		this.#services.set(id, service);
-		return this;
-	}
-}
-
-/**
- * A token identifying a service.
- */
-export type ContainerToken = string|symbol|(new(...args: any[]) => any);

package/src/Client/DependencyInjection/tsconfig.json

@@ -1,13 +0,0 @@
-{
-	"extends": "../../../tsconfig.json",
-	"include": ["*.ts"],
-	"compilerOptions": {
-		"composite": true,
-		"declaration": true,
-		"declarationMap": true,
-		"noEmit": false,
-		"outDir": "../../../lib/DependencyInjection",
-		"rootDir": ".",
-		"tsBuildInfoFile": "../../../var/DependencyInjection.tsbuildinfo"
-	}
-}

package/src/Client/Html/tsconfig.json

@@ -1,16 +0,0 @@
-{
-	"extends": "../../../tsconfig.json",
-	"include": ["*.ts"],
-	"compilerOptions": {
-		"composite": true,
-		"declaration": true,
-		"declarationMap": true,
-		"noEmit": false,
-		"outDir": "../../../lib/Html",
-		"rootDir": ".",
-		"tsBuildInfoFile": "../../../var/Html.tsbuildinfo"
-	},
-	"references": [
-		{"path": "../Base/tsconfig.json"}
-	]
-}

package/src/Client/Http/StatusCodes.ts

@@ -1,140 +0,0 @@
-/**
- * Provides common HTTP status codes.
- */
-export const StatusCodes = Object.freeze({
-
-	/**
-	 * The `OK` status.
-	 */
-	OK: 200,
-
-	/**
-	 * The `Created` status.
-	 */
-	Created: 201,
-
-	/**
-	 * The `No Content` status.
-	 */
-	NoContent: 204,
-
-	/**
-	 * The `Moved Permanently` status.
-	 */
-	MovedPermanently: 301,
-
-	/**
-	 * The `Found` status.
-	 */
-	Found: 302,
-
-	/**
-	 * The `Not Modified` status.
-	 */
-	NotModified: 304,
-
-	/**
-	 * The `Bad Request` status.
-	 */
-	BadRequest: 400,
-
-	/**
-	 * The `Unauthorized` status.
-	 */
-	Unauthorized: 401,
-
-	/**
-	 * The `Payment Required` status.
-	 */
-	PaymentRequired: 402,
-
-	/**
-	 * The `Forbidden` status.
-	 */
-	Forbidden: 403,
-
-	/**
-	 * The `Not Found` status.
-	 */
-	NotFound: 404,
-
-	/**
-	 * The `Method Not Allowed` status.
-	 */
-	MethodNotAllowed: 405,
-
-	/**
-	 * The `Not Acceptable` status.
-	 */
-	NotAcceptable: 406,
-
-	/**
-	 * The `Request Timeout` status.
-	 */
-	RequestTimeout: 408,
-
-	/**
-	 * The `Conflict` status.
-	 */
-	Conflict: 409,
-
-	/**
-	 * The `Payload Too Large` status.
-	 */
-	PayloadTooLarge: 413,
-
-	/**
-	 * The `Unsupported Media Type` status.
-	 */
-	UnsupportedMediaType: 415,
-
-	/**
-	 * The `Page Expired` status.
-	 */
-	PageExpired: 419,
-
-	/**
-	 * The `Unprocessable Content` status.
-	 */
-	UnprocessableContent: 422,
-
-	/**
-	 * The `Too Many Requests` status.
-	 */
-	TooManyRequests: 429,
-
-	/**
-	 * The `Internal Server Error` status.
-	 */
-	InternalServerError: 500,
-
-	/**
-	 * The `Not Implemented` status.
-	 */
-	NotImplemented: 501,
-
-	/**
-	 * The `Bad Gateway` status.
-	 */
-	BadGateway: 502,
-
-	/**
-	 * The `Service Unavailable` status.
-	 */
-	ServiceUnavailable: 503,
-
-	/**
-	 * The `Gateway Timeout` status.
-	 */
-	GatewayTimeout: 504,
-
-	/**
-	 * The `Bandwidth Limit Exceeded` status
-	 */
-	BandwidthLimitExceeded: 509
-});
-
-/**
- * Provides common HTTP status codes.
- */
-export type StatusCodes = typeof StatusCodes[keyof typeof StatusCodes];

package/src/Client/Http/tsconfig.json

@@ -1,16 +0,0 @@
-{
-	"extends": "../../../tsconfig.json",
-	"include": ["*.ts"],
-	"compilerOptions": {
-		"composite": true,
-		"declaration": true,
-		"declarationMap": true,
-		"noEmit": false,
-		"outDir": "../../../lib/Http",
-		"rootDir": ".",
-		"tsBuildInfoFile": "../../../var/Http.tsbuildinfo"
-	},
-	"references": [
-		{"path": "../Abstractions/tsconfig.json"}
-	]
-}

package/src/Client/UI/Component.ts

@@ -1,34 +0,0 @@
-import {LitElement, type CSSResultGroup} from "lit";
-
-/**
- * The optional base class for UI components. Alternatively, components may extend {@link LitElement} directly.
- */
-export abstract class Component extends LitElement {
-
-	/**
-	 * The component styles.
-	 */
-	static override styles: CSSResultGroup = [document.adoptedStyleSheets];
-
-	/**
-	 * Value indicating whether this component uses a shadow root.
-	 */
-	readonly #useShadowRoot: boolean;
-
-	/**
-	 * Creates a new component.
-	 * @param options Value indicating whether this component uses a shadow root.
-	 */
-	constructor(options: {shadowRoot?: boolean} = {}) {
-		super();
-		this.#useShadowRoot = options.shadowRoot ?? false;
-	}
-
-	/**
-	 * Returns the node into which this component should render.
-	 * @returns The node into which this component should render.
-	 */
-	protected override createRenderRoot(): DocumentFragment|HTMLElement {
-		return this.#useShadowRoot ? super.createRenderRoot() : this;
-	}
-}

package/src/Client/UI/ThemeDropdown.ts

@@ -1,104 +0,0 @@
-import {AppTheme, getIcon} from "#Html/AppTheme.js";
-
-/**
- * A dropdown menu for switching the application theme.
- */
-export class ThemeDropdown extends HTMLElement {
-
-	/**
-	 * The media query used to check the application theme.
-	 */
-	readonly #mediaQuery = matchMedia("(prefers-color-scheme: dark)");
-
-	/**
-	 * The key of the storage entry providing the saved theme mode.
-	 */
-	readonly #storageKey = this.getAttribute("storageKey") ?? "AppTheme";
-
-	/**
-	 * The current application theme.
-	 */
-	#theme: AppTheme;
-
-	/**
-	 * Creates a new theme dropdown.
-	 */
-	constructor() {
-		super();
-		const theme = localStorage.getItem(this.#storageKey) as AppTheme;
-		this.#theme = Object.values(AppTheme).includes(theme) ? theme : AppTheme.System;
-		for (const button of this.querySelectorAll("button")) button.addEventListener("click", this.#setTheme.bind(this));
-	}
-
-	/**
-	 * Registers the component.
-	 */
-	static {
-		customElements.define("theme-dropdown", this);
-	}
-
-	/**
-	 * The current application theme.
-	 */
-	get theme(): AppTheme {
-		return this.#theme;
-	}
-	set theme(value: AppTheme) {
-		localStorage.setItem(this.#storageKey, this.#theme = value);
-		this.#applyTheme();
-	}
-
-	/**
-	 * Method invoked when this component is connected.
-	 */
-	connectedCallback(): void {
-		this.#mediaQuery.addEventListener("change", this);
-		this.#applyTheme();
-	}
-
-	/**
-	 * Method invoked when this component is disconnected.
-	 */
-	disconnectedCallback(): void {
-		this.#mediaQuery.removeEventListener("change", this);
-	}
-
-	/**
-	 * Handles the events.
-	 */
-	handleEvent(): void {
-		this.#applyTheme();
-	}
-
-	/**
-	 * Applies the theme to the document.
-	 */
-	#applyTheme(): void {
-		const theme = this.#theme == AppTheme.System ? (this.#mediaQuery.matches ? AppTheme.Dark : AppTheme.Light) : this.#theme;
-		document.documentElement.dataset.bsTheme = theme.toLowerCase();
-		this.querySelector(".dropdown-toggle > .icon")!.textContent = getIcon(this.#theme);
-		this.querySelector(`button[data-theme="${this.#theme}"]`)!.appendChild(this.querySelector(".dropdown-item > .icon")!);
-	}
-
-	/**
-	 * Changes the current theme.
-	 * @param event The dispatched event.
-	 */
-	#setTheme(event: Event): void {
-		const button = (event.target as HTMLElement).closest("button")!;
-		this.theme = button.dataset.theme as AppTheme;
-	}
-}
-
-/**
- * Declaration merging.
- */
-declare global {
-
-	/**
-	 * The map of HTML tag names.
-	 */
-	interface HTMLElementTagNameMap {
-		"theme-dropdown": ThemeDropdown;
-	}
-}