@ardium-pl/devkit 8.3.2

package/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@ardium-pl/devkit" />
+export * from './public-api';

package/lib/click-outside/click-outside.directive.d.ts

@@ -0,0 +1,14 @@
+import * as i0 from "@angular/core";
+/**
+  Detects when the user clicks outside a given element.
+
+  @license
+  Shamelessly stolen from [Christian Liebel](https://github.com/chliebel/angular2-click-outside)
+*/
+export declare class ArdiumClickOutsideDirective {
+    private readonly _elementRef;
+    readonly ardClickOutside: import("@angular/core").OutputEmitterRef<MouseEvent>;
+    onClick(event: MouseEvent, target: HTMLElement): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumClickOutsideDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ArdiumClickOutsideDirective, "[ardClickOutside]", never, {}, { "ardClickOutside": "ardClickOutside"; }, never, never, false, never>;
+}

package/lib/click-outside/click-outside.module.d.ts

@@ -0,0 +1,8 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./click-outside.directive";
+import * as i2 from "@angular/common";
+export declare class ArdiumClickOutsideModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumClickOutsideModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ArdiumClickOutsideModule, [typeof i1.ArdiumClickOutsideDirective], [typeof i2.CommonModule], [typeof i1.ArdiumClickOutsideDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ArdiumClickOutsideModule>;
+}

package/lib/click-outside/index.d.ts

@@ -0,0 +1,2 @@
+export * from './click-outside.directive';
+export * from './click-outside.module';

package/lib/coercion/array.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Type describing the allowed values for a number input
+ */
+export type ArrayLike = string | any[] | null | undefined;
+/**
+ * Coerces a value to an array of trimmed non-empty strings.
+ * Any input that is not an array, `null` or `undefined` will be turned into a string
+ * using `String()` and split into an array with the given separator.
+ * `null`, `undefined`, and `""` will result in an empty array.
+ * This results in the following outcomes:
+ * - `null` -> `[]`
+ * - `[null]` -> `["null"]`
+ * - `["a", "b ", " "]` -> `["a", "b"]`
+ * - `[1, [2, 3]]` -> `["1", "2,3"]`
+ * - `"a,b , c"` -> `["a", "b", "c"]`
+ *
+ * Useful for defining CSS classes or table columns.
+ * @param value the value to coerce into an array of strings
+ * @param separator split-separator if value isn't an array. Defaults to the string `","`.
+ */
+export declare function coerceArrayProperty(value: any, separator?: string | RegExp): string[];

package/lib/coercion/boolean.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Type describing the allowed values for a boolean input.
+ */
+export type BooleanLike = string | boolean | null | undefined;
+/** Coerces a data-bound value (typically a string) to a boolean. */
+export declare function coerceBooleanProperty(value: any): boolean;

package/lib/coercion/date.d.ts

@@ -0,0 +1,5 @@
+export declare function getUTCDate(): Date;
+export declare function getUTCDate(year: number, monthIndex: number, day: number): Date;
+export declare function getUTCDate(year: number, monthIndex: number, day: number, hour: number, minute: number, second: number, millisecond: number): Date;
+export declare function coerceDateProperty<T>(v: any, fallback: T): Date | T;
+export declare function coerceDateOnlyProperty<T>(v: any, fallback: T, asUTC?: boolean): Date | T;

package/lib/coercion/index.d.ts

@@ -0,0 +1,4 @@
+export * from './array';
+export * from './boolean';
+export * from './date';
+export * from './number';

package/lib/coercion/number.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Type describing the allowed values for a number input
+ */
+export type NumberLike = string | number | null | undefined;
+/**
+Coerces a data-bound value (typically a string) to a number.
+*/
+/**
+ * Coerces a data-bound value (typically a string) to a number.
+ * @param value the value to be coerced.
+ * @returns the value coerced into a number, or undefined if cannot coerce.
+ */
+export declare function coerceNumberProperty(value: any): number | undefined;
+/**
+ * Coerces a data-bound value (typically a string) to a number.
+ * @param value the value to be coerced.
+ * @param fallback a value to be used if `value` cannot be coerced into a number.
+ * @returns the value coerced into a number, or `fallback` if cannot coerce.
+ */
+export declare function coerceNumberProperty<D>(value: any, fallback: D): number | D;

package/lib/dom-boxes/dom-boxes.d.ts

@@ -0,0 +1,7 @@
+import { ElementRef } from '@angular/core';
+export declare function getDomContentRect(el: HTMLElement): DOMRect;
+export declare function getDomContentRect(el: ElementRef<HTMLElement>): DOMRect;
+export declare function getDomContentRect(el: HTMLElement | ElementRef<HTMLElement>): DOMRect;
+export declare function getDomPaddingRect(el: HTMLElement): DOMRect;
+export declare function getDomPaddingRect(el: ElementRef<HTMLElement>): DOMRect;
+export declare function getDomPaddingRect(el: HTMLElement | ElementRef<HTMLElement>): DOMRect;

package/lib/dom-boxes/index.d.ts

@@ -0,0 +1 @@
+export * from './dom-boxes';

package/lib/escape-html/escape-html.d.ts

@@ -0,0 +1 @@
+export declare function escapeHTML(value: string): string;

package/lib/escape-html/escape-html.module.d.ts

@@ -0,0 +1,8 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./escape-html.pipe";
+import * as i2 from "@angular/common";
+export declare class ArdiumEscapeHTMLModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumEscapeHTMLModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ArdiumEscapeHTMLModule, [typeof i1.ArdiumEscapeHTMLPipe], [typeof i2.CommonModule], [typeof i1.ArdiumEscapeHTMLPipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ArdiumEscapeHTMLModule>;
+}

package/lib/escape-html/escape-html.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class ArdiumEscapeHTMLPipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumEscapeHTMLPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ArdiumEscapeHTMLPipe, "escapeHTML", false>;
+}

package/lib/escape-html/index.d.ts

@@ -0,0 +1,3 @@
+export * from './escape-html';
+export * from './escape-html.module';
+export * from './escape-html.pipe';

package/lib/file-pipes/file-pipes.defaults.d.ts

@@ -0,0 +1,8 @@
+import { InjectionToken, Provider } from '@angular/core';
+export interface ArdFilePipesDefaults {
+    extensionWithDot: boolean;
+    sizePrecision: number;
+    sizeUseSpace: boolean;
+}
+export declare const ARD_FILE_PIPES_DEFAULTS: InjectionToken<ArdFilePipesDefaults>;
+export declare function provideFilePipesDefaults(config: Partial<ArdFilePipesDefaults>): Provider;

package/lib/file-pipes/file-pipes.module.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./fileext.pipe";
+import * as i2 from "./filename.pipe";
+import * as i3 from "./filesize.pipe";
+import * as i4 from "@angular/common";
+export declare class ArdiumFilePipesModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumFilePipesModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ArdiumFilePipesModule, [typeof i1.ArdiumFileExtensionPipe, typeof i2.ArdiumFileNamePipe, typeof i3.ArdiumFileSizePipe], [typeof i4.CommonModule], [typeof i1.ArdiumFileExtensionPipe, typeof i2.ArdiumFileNamePipe, typeof i3.ArdiumFileSizePipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ArdiumFilePipesModule>;
+}

package/lib/file-pipes/fileext.pipe.d.ts

@@ -0,0 +1,39 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Formats a file extension from a string or File object.
+ *
+ * @param {string | File | null | undefined} value - The file name or File object whose extension is to be extracted.
+ * @param {boolean} [withDot=false] - Whether to include a dot ('.') before the file extension.
+ * @returns {string | null} - The file extension, or null if no extension is found or if the input is invalid.
+ *
+ * @example
+ * formatFileExtension('image.png'); // -> 'png'
+ * formatFileExtension('image.png', true); // -> '.png'
+ */
+export declare function formatFileExtension(value: string | File | null | undefined, withDot?: boolean): string | null;
+/**
+ * Pipe that transforms a file or file name into its extension.
+ *
+ * @example
+ * {{ 'image.png' | fileext }} // -> 'png'
+ * {{ 'image.png' | fileext: true }} // -> '.png'
+ */
+export declare class ArdiumFileExtensionPipe implements PipeTransform {
+    protected readonly _DEFAULTS: import("@ardium-pl/devkit").ArdFilePipesDefaults;
+    /**
+     * Transforms the given value to its file extension.
+     *
+     * @param {string | File | null | undefined} value - The file name or File object to extract the extension from.
+     * @param {boolean} withDot - Whether to include a dot before the extension (defaults to config value).
+     * @returns {string | null} - The file extension or null if no extension is found.
+     *
+     *
+     * @example
+     * {{ 'image.png' | fileext }} // -> 'png'
+     * {{ 'image.png' | fileext: true }} // -> '.png'
+     */
+    transform(value: string | File | null | undefined, withDot?: boolean): string | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumFileExtensionPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ArdiumFileExtensionPipe, "fileext", false>;
+}

package/lib/file-pipes/filename.pipe.d.ts

@@ -0,0 +1,38 @@
+import { PipeTransform } from "@angular/core";
+import * as i0 from "@angular/core";
+/**
+ * Formats a file name by removing its extension.
+ *
+ * @param {string | File | null | undefined} value - The file name or File object to extract the name without extension from.
+ * @returns {string} - The file name without the extension, or the original input if no extension is found.
+ *
+ * @example
+ * formatFileName('image.png'); // -> 'image'
+ * formatFileName('document.pdf'); // -> 'document'
+ * formatFileName('my-component.component.ts'); // -> 'my-component.component'
+ */
+export declare function formatFileName(value: string | File | null | undefined): string;
+/**
+ * Pipe that transforms a file or file name into its name without the extension.
+ *
+ * @example
+ * {{ 'image.png' | filename }} // -> 'image'
+ * {{ 'document.pdf' | filename }} // -> 'document'
+ * {{ 'my-component.component.ts' | filename }} // -> 'my-component.component'
+ */
+export declare class ArdiumFileNamePipe implements PipeTransform {
+    /**
+     * Transforms the given value to its file name without the extension.
+     *
+     * @param {string | File | null | undefined} value - The file name or File object to extract the name without extension from.
+     * @returns {string} - The file name without the extension.
+     *
+     * @example
+     * {{ 'image.png' | filename }} // -> 'image'
+     * {{ 'document.pdf' | filename }} // -> 'document'
+   * {{ 'my-component.component.ts' | filename }} // -> 'my-component.component'
+     */
+    transform(value: string | File | null | undefined): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumFileNamePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ArdiumFileNamePipe, "filename", false>;
+}

package/lib/file-pipes/filesize.pipe.d.ts

@@ -0,0 +1,50 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Formats a file size into a human-readable string with the appropriate unit.
+ *
+ * @param {number | File | null | undefined} value - The file size as a number or a File object whose size is to be extracted.
+ * @param {number} [precision=2] - The number of decimal places to round to. Default is 2.
+ * @param {boolean} [useSpace=true] - Whether to include a space between the number and the unit. Default is true.
+ * @returns {string} - The formatted file size with the unit (e.g., '1.5 MB', '10 kB').
+ *
+ * @example
+ * formatFileSize(1024); // -> '1.00 kB'
+ * formatFileSize(1048576); // -> '1.00 MB'
+ * formatFileSize(1048576, 3); // -> '1.000 MB'
+ * formatFileSize(1048576, 3, false); // -> '1.000MB'
+ * formatFileSize(967680, 0); // -> '945 kB'
+ */
+export declare function formatFileSize(value: number | File | null | undefined, precision?: number, useSpace?: boolean): string;
+/**
+ * Pipe that transforms a file or file size into a human-readable file size string.
+ *
+ * @example
+ * {{ 1024 | filesize }} // -> '1.00 kB'
+ * {{ 1048576 | filesize }} // -> '1.00 MB'
+ * {{ 1048576 | filesize:3 }} // -> '1.000 MB'
+ * {{ 1048576 | filesize:3:false }} // -> '1.000MB'
+ * {{ 967680 | filesize:0 }} // -> '945 kB'
+ */
+export declare class ArdiumFileSizePipe implements PipeTransform {
+    /** Default configuration for the pipe */
+    protected readonly _DEFAULTS: import("@ardium-pl/devkit").ArdFilePipesDefaults;
+    /**
+     * Transforms the given value to a human-readable file size string.
+     *
+     * @param {number | File | null | undefined} value - The file size as a number or File object whose size is to be extracted.
+     * @param {number} precision - The number of decimal places to round to (defaults to config value).
+     * @param {boolean} useSpace - Whether to include a space between the number and the unit (defaults to config value).
+     * @returns {string} - The formatted file size string (e.g., '1.5 MB', '10 kB').
+     *
+     * @example
+     * {{ 1024 | filesize }} // -> '1.00 kB'
+     * {{ 1048576 | filesize }} // -> '1.00 MB'
+     * {{ 1048576 | filesize:3 }} // -> '1.000 MB'
+     * {{ 1048576 | filesize:3:false }} // -> '1.000MB'
+     * {{ 967680 | filesize:0 }} // -> '945 kB'
+     */
+    transform(value: number | File | null | undefined, precision?: number, useSpace?: boolean): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArdiumFileSizePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ArdiumFileSizePipe, "filesize", false>;
+}

package/lib/file-pipes/index.d.ts

@@ -0,0 +1,5 @@
+export * from './file-pipes.defaults';
+export * from './file-pipes.module';
+export * from './fileext.pipe';
+export * from './filename.pipe';
+export * from './filesize.pipe';

package/lib/file-system/file-system.service.d.ts

@@ -0,0 +1,69 @@
+import { FileSystemRequestOptions, FileSystemSaveOptions } from './file-system.types';
+import * as i0 from "@angular/core";
+/**
+ * Service for handling file system operations, including saving, uploading, and reading files.
+ *
+ * This service leverages the File System Access API when available and falls back to traditional
+ * methods when necessary. It provides methods to check for API support, save files, request file uploads,
+ * and read file contents.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+ */
+export declare class FileSystemService {
+    /**
+     * Checks if the File System Access API is supported for the specified method.
+     *
+     * @param method - The file system method to check ('showSaveFilePicker' or 'showOpenFilePicker').
+     * @returns True if the specified method is supported, otherwise false.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    isFileSystemAPISupported(method: 'showSaveFilePicker' | 'showOpenFilePicker'): boolean;
+    /**
+     * Saves data as a file using the File System Access API or a fallback method.
+     *
+     * @param data - The data to be saved, either as a string or a Blob.
+     * @param options - Options for saving the file, such as file name and save method.
+     * @returns A promise that resolves to true if the file was saved successfully, otherwise false.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    saveAs(data: string | Blob, options?: FileSystemSaveOptions): Promise<boolean>;
+    /**
+     * Requests a file upload using the File System Access API or a fallback method.
+     *
+     * @param options - Options for requesting the file upload, such as accepted file types and method.
+     * @returns A promise that resolves to the selected file or files, or null if the operation was canceled.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    requestFileUpload(options?: FileSystemRequestOptions): Promise<File | File[] | null>;
+    /**
+     * Reads the content of a file as a string with optional encoding.
+     *
+     * @param file - The file to read.
+     * @param readAs - The method to read the file (in this case - "text").
+     * @param encoding - The encoding to use when reading the file as text. Defaults to UTF-8.
+     * @returns A promise that resolves to the file content as a string or null.
+     */
+    readFile(file: File, readAs?: 'text', encoding?: string): Promise<string | null>;
+    /**
+     * Reads the content of a file as an ArrayBuffer.
+     *
+     * @param file - The file to read.
+     * @param readAs - The method to read the file (in this case - "binary").
+     * @returns A promise that resolves to the file content as an ArrayBuffer or null.
+     */
+    readFile(file: File, readAs?: 'binary'): Promise<ArrayBuffer | null>;
+    /**
+     * Reads the content of a file.
+     *
+     * @param file - The file to read.
+     * @param readAs - The method to read the file ("text" or "binary").
+     * @param encoding - The encoding to use when reading the file as text (default is 'UTF-8').
+     * @returns A promise that resolves to the file content as a string, ArrayBuffer, or null.
+     */
+    readFile(file: File, readAs?: 'text' | 'binary', encoding?: string): Promise<string | ArrayBuffer | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileSystemService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FileSystemService>;
+}

package/lib/file-system/file-system.types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Enumeration of file system methods.
+ */
+export declare const FileSystemMethod: {
+    /**
+     * Prefer using the File System Access API, or if not supported, use a cross-browser compatible method.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    readonly PreferFileSystem: "preferFileSystem";
+    /**
+     * Always use a cross-browser compatible method.
+     */
+    readonly CrossBrowser: "crossBrowser";
+};
+/**
+ * Type representing file system methods.
+ */
+export type FileSystemMethod = (typeof FileSystemMethod)[keyof typeof FileSystemMethod];
+/**
+ * Enumeration of file system start directories.
+ */
+export declare const FileSystemStartDirectory: {
+    /**
+     * Always start in the Desktop directory.
+     */
+    readonly Desktop: "desktop";
+    /**
+     * Always start in the Documents directory.
+     */
+    readonly Documents: "documents";
+    /**
+     * Always start in the Downloads directory.
+     */
+    readonly Downloads: "downloads";
+    /**
+     * Always start in the Music directory.
+     */
+    readonly Music: "music";
+    /**
+     * Always start in the Pictures directory.
+     */
+    readonly Pictures: "pictures";
+    /**
+     * Always start in the Videos directory.
+     */
+    readonly Videos: "videos";
+};
+/**
+ * Type representing file system start directories.
+ */
+export type FileSystemStartDirectory = (typeof FileSystemStartDirectory)[keyof typeof FileSystemStartDirectory];
+/**
+ * Base type for file system save options.
+ *
+ * @property {string} [fileName] - The name of the file to be saved.
+ */
+type _FileSystemSaveOptionsBase = {
+    fileName?: string;
+};
+/**
+ * Type representing file system save options
+ */
+export type FileSystemSaveOptions = _FileSystemSaveOptionsBase & ({
+    /**
+     * Prefer using the File System Access API, or if not supported, use a cross-browser compatible method.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    method: 'preferFileSystem';
+    /**
+     * By specifying an ID, the browser can remember different directories for different IDs. If the same ID is used for another picker, the picker opens in the same directory.
+     */
+    directoryId?: string;
+    /**
+     * The directory to open the dialog in. Leaving this undefined results in the dialog being opened in the last known directory.
+     */
+    startDirectory?: FileSystemStartDirectory;
+    /**
+     * An array of allowed file types to save. Each item is an object with the following options:
+     * - `description?` - An optional desciption of the category of file types allowed. Default to be an empty string.
+     * - `accept` - An object with the keys set to the MIME type and the values an array of file extensions (see below for an example).
+     * ```ts
+     * const opts = {
+     *   types: [
+     *     {
+     *       description: "Text file",
+     *       accept: { "text/plain": [".txt"] },
+     *     },
+     *   ],
+     * };
+     * ```
+     */
+    types?: {
+        /**
+         * An optional desciption of the category of file types allowed. Default to be an empty string.
+         */
+        description?: string;
+        /**
+         * An object with the keys set to the MIME type and the values an array of file extensions (see below for an example).
+         * ```ts
+         * const opts = {
+         *   types: [
+         *     {
+         *       description: "Text file",
+         *       accept: { "text/plain": [".txt"] },
+         *     },
+         *   ],
+         * };
+         * ```
+         */
+        accept: Record<string, string[]>;
+    }[];
+} | {
+    /**
+     * Always use a cross-browser compatible method.
+     */
+    method?: 'crossBrowser';
+});
+/**
+ * Base type for file system request options.
+ */
+type _FileSystemRequestOptionsBase = {
+    accept?: string | string[];
+    multiple?: boolean;
+};
+/**
+ * Type representing file system request options.
+ */
+export type FileSystemRequestOptions = _FileSystemRequestOptionsBase & ({
+    /**
+     * Prefer using the File System Access API, or if not supported, use a cross-browser compatible method.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API File System Access API}
+     */
+    method: 'preferFileSystem';
+    /**
+     * By specifying an ID, the browser can remember different directories for different IDs. If the same ID is used for another picker, the picker opens in the same directory.
+     */
+    directoryId?: string;
+    /**
+     * The directory to open the dialog in. Leaving this undefined results in the dialog being opened in the last known directory.
+     */
+    startDirectory?: FileSystemStartDirectory;
+    /**
+     * An array of allowed file types to request. Each item is an object with the following options:
+     * - `description?` - An optional desciption of the category of file types allowed. Default to be an empty string.
+     * - `accept` - An object with the keys set to the MIME type and the values an array of file extensions (see below for an example).
+     * ```ts
+     * const opts = {
+     *   types: [
+     *     {
+     *       description: "Text file",
+     *       accept: { "text/plain": [".txt"] },
+     *     },
+     *   ],
+     * };
+     * ```
+     */
+    types?: {
+        /**
+         * An optional desciption of the category of file types allowed. Default to be an empty string.
+         */
+        description?: string;
+        /**
+         * An object with the keys set to the MIME type and the values an array of file extensions (see below for an example).
+         * ```ts
+         * const opts = {
+         *   types: [
+         *     {
+         *       description: "Text file",
+         *       accept: { "text/plain": [".txt"] },
+         *     },
+         *   ],
+         * };
+         * ```
+         */
+        accept: Record<string, string[]>;
+    }[];
+} | {
+    /**
+     * Always use a cross-browser compatible method.
+     */
+    method?: 'crossBrowser';
+});
+export {};

package/lib/file-system/index.d.ts

@@ -0,0 +1,2 @@
+export * from './file-system.service';
+export * from './file-system.types';

package/lib/find-functions/find-suggestion.d.ts

@@ -0,0 +1,3 @@
+export declare function findBestSuggestions<T extends string>(toMatch: string, suggestions: Readonly<T[]>): T[];
+export declare function findBestSuggestions<T extends Exclude<any, string>>(toMatch: string, suggestions: Readonly<T[]>, mapFn: (v: T) => string): T[];
+export declare function findBestAutocomplate(toMatch: string, autocompletes: string[]): string;

package/lib/find-functions/index.d.ts

@@ -0,0 +1 @@
+export * from './find-suggestion';

package/lib/forms/index.d.ts

@@ -0,0 +1 @@
+export * from './track-form-control/';

package/lib/forms/track-form-control/index.d.ts

@@ -0,0 +1 @@
+export * from './track-form-control';

package/lib/forms/track-form-control/track-form-control.d.ts

@@ -0,0 +1,83 @@
+import { Injector, Signal } from '@angular/core';
+import { AbstractControl, AsyncValidatorFn, FormControlStatus, ValidationErrors, ValidatorFn } from '@angular/forms';
+import { Observable } from 'rxjs';
+export interface FormControlTrackerOptions {
+    injector?: Injector;
+}
+export interface BoundControlTrackerOptions extends FormControlTrackerOptions {
+    attachValueAccessor?: boolean;
+}
+export interface TrackedFormControl<T> {
+    readonly instance: AbstractControl<T>;
+    readonly value$: Observable<T>;
+    readonly value: Signal<T>;
+    readonly errors$: Observable<ValidationErrors | null>;
+    readonly errors: Signal<ValidationErrors | null>;
+    readonly touched$: Observable<boolean>;
+    readonly touched: Signal<boolean>;
+    readonly untouched$: Observable<boolean>;
+    readonly untouched: Signal<boolean>;
+    readonly pristine$: Observable<boolean>;
+    readonly pristine: Signal<boolean>;
+    readonly dirty$: Observable<boolean>;
+    readonly dirty: Signal<boolean>;
+    readonly status$: Observable<FormControlStatus>;
+    readonly status: Signal<FormControlStatus>;
+    readonly valid$: Observable<boolean>;
+    readonly valid: Signal<boolean>;
+    readonly invalid$: Observable<boolean>;
+    readonly invalid: Signal<boolean>;
+    readonly pending$: Observable<boolean>;
+    readonly pending: Signal<boolean>;
+    readonly disabled$: Observable<boolean>;
+    readonly disabled: Signal<boolean>;
+    readonly enabled$: Observable<boolean>;
+    readonly enabled: Signal<boolean>;
+    readonly touchedHasErrors: Signal<boolean>;
+    readonly validators$: Observable<ValidatorFn[] | null>;
+    readonly validators: Signal<ValidatorFn[] | null>;
+    readonly asyncValidators$: Observable<AsyncValidatorFn[] | null>;
+    readonly asyncValidators: Signal<AsyncValidatorFn[] | null>;
+    init(): void;
+    destroy(): void;
+}
+/**
+ * Gives reactive access to the properties of the given form control.
+ *
+ * Call `destroy()` to dispose of form control tracker.
+ *
+ * @param formControl the form control to be tracked.
+ * @param options optional configuration for the form control tracker.
+ * @returns an object containing all standard form control getters as signals.
+ * @example
+ * ```
+ * readonly ageControl = new FormControl('John');
+ *
+ * readonly ageControlTracker = trackFormControl(this.ageControl);
+ * ```
+ */
+export declare function trackFormControl<T = any>(formControl: AbstractControl<T>, options?: FormControlTrackerOptions): TrackedFormControl<T>;
+/**
+ * Gives reactive access to the properties of the Form Control assigned to the component instance.
+ *
+ * Call the `init()` method inside `ngOnInit()` to start listening to the Form Control, call `destroy()` to dispose of the listener.
+ *
+ * @param thisObj the component instance.
+ * @param options optional configuration for the form control tracker.
+ * @returns an object containing all standard form control getters as signals.
+ * @example
+ * ```
+ * export class MyComponent implements ControlValueAccessor, OnInit, OnDestroy {
+ *   readonly control = trackFormControl(this);
+ *
+ *   ngOnInit(): void {
+ *     this.control.init();
+ *   }
+ *   ngOnDestroy(): void {
+ *     this.control.destroy();
+ *   }
+ *   // control value accessor implementation ...
+ * }
+ * ```
+ */
+export declare function trackBoundControl<T = any>(thisObj: any, options?: BoundControlTrackerOptions): TrackedFormControl<T>;