@ngneers/controls 0.0.1-next.0

package/types/ngneers-controls-hint.d.ts

@@ -0,0 +1,88 @@
+import * as _ngneers_controls_custom_types from '@ngneers/controls-custom-types';
+import * as _iconify_types from '@iconify/types';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
+import * as _ngneers_controls_themes from '@ngneers/controls-themes';
+import { NgnBase } from '@ngneers/controls/base';
+
+/**
+ * Validation state rendered by a hint when connected to helpers such as ngnErrors.
+ * @category types
+ */
+interface NgnHintValidationState {
+    /** Whether the validation message should be shown. */
+    visible: boolean;
+    /** Whether validation is currently pending. */
+    pending: boolean;
+    /** Resolved validation message, if one is available. */
+    message: string | null;
+}
+/**
+ * A small sub-text control for controls — helper text that explains a value,
+ * or a validation / warning message. The semantic intent is carried by
+ * {@link kind} (`default | info | success | warning | error`).
+ *
+ * @category control
+ */
+declare class NgnHint extends NgnBase<'hint'> {
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"hint", ["root", "content", "icon", `kind-${string}`, `color-${string}`], readonly []>>;
+    /**
+     * A stable id placed on the host element so a related control can reference
+     * this hint via `aria-describedby`. Defaults to a generated id.
+     */
+    readonly controlId: _angular_core.InputSignal<string>;
+    /**
+     * Set an icon to display before the text. When omitted, a default icon is
+     * derived from the current {@link kind} (e.g. `error` shows an alert icon).
+     * The neutral `default` kind shows no icon unless one is set explicitly.
+     * @default undefined
+     */
+    readonly icon: _angular_core.InputSignal<_iconify_types.IconifyIcon | _ngneers_controls_custom_types.NgnIconEntry | undefined>;
+    /**
+     * Whether to only render the icon and show the content as tooltip.
+     * @default false
+     */
+    readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * The hint text. Can also be a `TemplateRef` for custom rendering, or set via
+     * an `<ng-template #content>` content child. Projected content (`<ng-content>`)
+     * is used as a fallback when neither is provided.
+     * @default null
+     */
+    readonly content: _angular_core.InputSignal<string | TemplateRef<unknown> | null>;
+    /**
+     * Validation state supplied by helpers such as ngnErrors.
+     * @default null
+     */
+    readonly validationState: _angular_core.InputSignal<NgnHintValidationState | null>;
+    private readonly _bridgedValidationState;
+    private readonly _activeValidationState;
+    private readonly _userContentTemplate;
+    protected readonly hasIconOnlyTooltipContent: _angular_core.Signal<boolean>;
+    /**
+     * Bridge validation state from a companion directive such as ngnErrors.
+     * @category methods
+     */
+    setValidationState(state: NgnHintValidationState | null): void;
+    constructor();
+    /**
+     * The resolved template to render, if any. A content-child `<ng-template #content>`
+     * takes precedence over a `TemplateRef` passed via the {@link content} input.
+     */
+    protected readonly contentTemplate: _angular_core.Signal<TemplateRef<unknown> | null>;
+    /**
+     * The resolved string content, if the {@link content} input is a plain string.
+     */
+    protected readonly contentString: _angular_core.Signal<string | null>;
+    /**
+     * The icon registry key of the default icon for the current kind, or
+     * `undefined` for the neutral `default` kind.
+     */
+    protected readonly defaultIconKey: _angular_core.Signal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnHint, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnHint, "ngn-hint", never, { "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "validationState": { "alias": "validationState"; "required": false; "isSignal": true; }; }, {}, ["_userContentTemplate"], ["*"], true, never>;
+}
+
+export { NgnHint };
+export type { NgnHintValidationState };

package/types/ngneers-controls-i18n-translations-de.d.ts

@@ -0,0 +1,164 @@
+declare const de: {
+    calendar: {
+        today: string;
+        input: string;
+        selectYear: string;
+        selectMonth: string;
+        previousMonth: string;
+        nextMonth: string;
+        weekdays: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        weekdaysShort: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        months: {
+            january: string;
+            february: string;
+            march: string;
+            april: string;
+            may: string;
+            june: string;
+            july: string;
+            august: string;
+            september: string;
+            october: string;
+            november: string;
+            december: string;
+        };
+    };
+    editInplace: {
+        placeholder: string;
+        confirm: string;
+    };
+    filter: {
+        noFilter: string;
+        addCondition: string;
+        removeCondition: string;
+        operator: string;
+        value: string;
+        clear: string;
+        apply: string;
+        cancel: string;
+        matchModeLabel: string;
+        match: {
+            all: string;
+            any: string;
+            and: string;
+            or: string;
+        };
+        selected: string;
+        conditions: string;
+        operators: {
+            isEqual: string;
+            isNotEqual: string;
+            contains: string;
+            startsWith: string;
+            endsWith: string;
+            in: string;
+            isEmpty: string;
+            isNotEmpty: string;
+            greaterThan: string;
+            greaterThanOrEqual: string;
+            lessThan: string;
+            lessThanOrEqual: string;
+            after: string;
+            onOrAfter: string;
+            before: string;
+            onOrBefore: string;
+            isTrue: string;
+            isFalse: string;
+            custom: string;
+        };
+    };
+    splitter: {
+        handleLabel: string;
+    };
+    inputField: {
+        clearInput: string;
+    };
+    maskInput: {
+        roleDescription: string;
+        segmentRange: string;
+        optionSeparator: string;
+    };
+    drawer: {
+        close: string;
+    };
+    dialog: {
+        close: string;
+    };
+    chip: {
+        close: string;
+    };
+    breadcrumb: {
+        overflow: string;
+    };
+    toast: {
+        close: string;
+        region: string;
+    };
+    snackbar: {
+        close: string;
+        region: string;
+        severity: {
+            error: string;
+            warning: string;
+            success: string;
+            info: string;
+        };
+    };
+    upload: {
+        upload: string;
+        uploadNamed: string;
+        retryNamed: string;
+        cancelNamed: string;
+        removeNamed: string;
+        progressNamed: string;
+    };
+    select: {
+        filterOptions: string;
+    };
+    paginator: {
+        previousPage: string;
+        nextPage: string;
+    };
+    listBox: {
+        noItemsFound: string;
+    };
+    tree: {
+        noItemsFound: string;
+    };
+    table: {
+        selectAllRows: string;
+        selectRow: string;
+        sortedBy: string;
+        sortAscending: string;
+        sortDescending: string;
+        sortCleared: string;
+        selectedCount: string;
+        page: string;
+        resultCount: string;
+    };
+    state: {
+        loading: string;
+        success: string;
+        warning: string;
+        error: string;
+        cancelled: string;
+    };
+};
+
+export { de };

package/types/ngneers-controls-i18n-translations-en.d.ts

@@ -0,0 +1,164 @@
+declare const en: {
+    calendar: {
+        today: string;
+        input: string;
+        selectYear: string;
+        selectMonth: string;
+        previousMonth: string;
+        nextMonth: string;
+        weekdays: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        weekdaysShort: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        months: {
+            january: string;
+            february: string;
+            march: string;
+            april: string;
+            may: string;
+            june: string;
+            july: string;
+            august: string;
+            september: string;
+            october: string;
+            november: string;
+            december: string;
+        };
+    };
+    editInplace: {
+        placeholder: string;
+        confirm: string;
+    };
+    filter: {
+        noFilter: string;
+        addCondition: string;
+        removeCondition: string;
+        operator: string;
+        value: string;
+        clear: string;
+        apply: string;
+        cancel: string;
+        matchModeLabel: string;
+        match: {
+            all: string;
+            any: string;
+            and: string;
+            or: string;
+        };
+        selected: string;
+        conditions: string;
+        operators: {
+            isEqual: string;
+            isNotEqual: string;
+            contains: string;
+            startsWith: string;
+            endsWith: string;
+            in: string;
+            isEmpty: string;
+            isNotEmpty: string;
+            greaterThan: string;
+            greaterThanOrEqual: string;
+            lessThan: string;
+            lessThanOrEqual: string;
+            after: string;
+            onOrAfter: string;
+            before: string;
+            onOrBefore: string;
+            isTrue: string;
+            isFalse: string;
+            custom: string;
+        };
+    };
+    splitter: {
+        handleLabel: string;
+    };
+    inputField: {
+        clearInput: string;
+    };
+    maskInput: {
+        roleDescription: string;
+        segmentRange: string;
+        optionSeparator: string;
+    };
+    drawer: {
+        close: string;
+    };
+    dialog: {
+        close: string;
+    };
+    chip: {
+        close: string;
+    };
+    breadcrumb: {
+        overflow: string;
+    };
+    toast: {
+        close: string;
+        region: string;
+    };
+    snackbar: {
+        close: string;
+        region: string;
+        severity: {
+            error: string;
+            warning: string;
+            success: string;
+            info: string;
+        };
+    };
+    upload: {
+        upload: string;
+        uploadNamed: string;
+        retryNamed: string;
+        cancelNamed: string;
+        removeNamed: string;
+        progressNamed: string;
+    };
+    select: {
+        filterOptions: string;
+    };
+    paginator: {
+        previousPage: string;
+        nextPage: string;
+    };
+    listBox: {
+        noItemsFound: string;
+    };
+    tree: {
+        noItemsFound: string;
+    };
+    table: {
+        selectAllRows: string;
+        selectRow: string;
+        sortedBy: string;
+        sortAscending: string;
+        sortDescending: string;
+        sortCleared: string;
+        selectedCount: string;
+        page: string;
+        resultCount: string;
+    };
+    state: {
+        loading: string;
+        success: string;
+        warning: string;
+        error: string;
+        cancelled: string;
+    };
+};
+
+export { en };

package/types/ngneers-controls-i18n.d.ts

@@ -0,0 +1,186 @@
+import * as i0 from '@angular/core';
+import { Signal } from '@angular/core';
+import { BaseTranslateService } from '@ngneers/signal-translate';
+
+declare const en: {
+    calendar: {
+        today: string;
+        input: string;
+        selectYear: string;
+        selectMonth: string;
+        previousMonth: string;
+        nextMonth: string;
+        weekdays: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        weekdaysShort: {
+            monday: string;
+            tuesday: string;
+            wednesday: string;
+            thursday: string;
+            friday: string;
+            saturday: string;
+            sunday: string;
+        };
+        months: {
+            january: string;
+            february: string;
+            march: string;
+            april: string;
+            may: string;
+            june: string;
+            july: string;
+            august: string;
+            september: string;
+            october: string;
+            november: string;
+            december: string;
+        };
+    };
+    editInplace: {
+        placeholder: string;
+        confirm: string;
+    };
+    filter: {
+        noFilter: string;
+        addCondition: string;
+        removeCondition: string;
+        operator: string;
+        value: string;
+        clear: string;
+        apply: string;
+        cancel: string;
+        matchModeLabel: string;
+        match: {
+            all: string;
+            any: string;
+            and: string;
+            or: string;
+        };
+        selected: string;
+        conditions: string;
+        operators: {
+            isEqual: string;
+            isNotEqual: string;
+            contains: string;
+            startsWith: string;
+            endsWith: string;
+            in: string;
+            isEmpty: string;
+            isNotEmpty: string;
+            greaterThan: string;
+            greaterThanOrEqual: string;
+            lessThan: string;
+            lessThanOrEqual: string;
+            after: string;
+            onOrAfter: string;
+            before: string;
+            onOrBefore: string;
+            isTrue: string;
+            isFalse: string;
+            custom: string;
+        };
+    };
+    splitter: {
+        handleLabel: string;
+    };
+    inputField: {
+        clearInput: string;
+    };
+    maskInput: {
+        roleDescription: string;
+        segmentRange: string;
+        optionSeparator: string;
+    };
+    drawer: {
+        close: string;
+    };
+    dialog: {
+        close: string;
+    };
+    chip: {
+        close: string;
+    };
+    breadcrumb: {
+        overflow: string;
+    };
+    toast: {
+        close: string;
+        region: string;
+    };
+    snackbar: {
+        close: string;
+        region: string;
+        severity: {
+            error: string;
+            warning: string;
+            success: string;
+            info: string;
+        };
+    };
+    upload: {
+        upload: string;
+        uploadNamed: string;
+        retryNamed: string;
+        cancelNamed: string;
+        removeNamed: string;
+        progressNamed: string;
+    };
+    select: {
+        filterOptions: string;
+    };
+    paginator: {
+        previousPage: string;
+        nextPage: string;
+    };
+    listBox: {
+        noItemsFound: string;
+    };
+    tree: {
+        noItemsFound: string;
+    };
+    table: {
+        selectAllRows: string;
+        selectRow: string;
+        sortedBy: string;
+        sortAscending: string;
+        sortDescending: string;
+        sortCleared: string;
+        selectedCount: string;
+        page: string;
+        resultCount: string;
+    };
+    state: {
+        loading: string;
+        success: string;
+        warning: string;
+        error: string;
+        cancelled: string;
+    };
+};
+
+declare const supportedLanguages: readonly ["en", "de"];
+
+type SupportedLanguage = (typeof supportedLanguages)[number];
+type Translations = typeof en;
+
+declare class I18n extends BaseTranslateService<Translations> {
+    constructor();
+    protected loadTranslations(lang: string): Promise<Translations>;
+    unsafe(key: string): Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<I18n, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<I18n>;
+}
+
+declare function registerCustomLanguage(language: string, translations: () => Promise<Translations>): void;
+declare function registerCustomLanguages(languages: Record<string, () => Promise<Translations>>): void;
+declare function loadLanguage(language: SupportedLanguage): Promise<Translations>;
+
+export { I18n, loadLanguage, registerCustomLanguage, registerCustomLanguages, supportedLanguages };
+export type { SupportedLanguage, Translations };

package/types/ngneers-controls-icon.d.ts

@@ -0,0 +1,68 @@
+import * as _angular_core from '@angular/core';
+import { OnDestroy, TemplateRef, InjectionToken } from '@angular/core';
+import { IconType, NgnIconEntry } from '@ngneers/controls-custom-types';
+export { NgnIconEntry } from '@ngneers/controls-custom-types';
+import * as _ngneers_controls_icon from '@ngneers/controls/icon';
+import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
+import { NgnFeature } from '@ngneers/controls/api/ng';
+import * as _ngneers_controls_themes from '@ngneers/controls-themes';
+import { SafeHtml } from '@angular/platform-browser';
+import { NgnBase } from '@ngneers/controls/base';
+import { IconifyIcon } from '@iconify/types';
+
+type IconTemplateContext = {
+    $implicit: {
+        icon: IconType;
+    };
+};
+
+type IconTemplateType = TemplateRef<IconTemplateContext>;
+declare class GlobalIconTemplate implements OnDestroy {
+    private readonly _globalIconTemplate;
+    readonly globalIconTemplate: _angular_core.Signal<IconTemplateType | null>;
+    setGlobalIconTemplate(template: IconTemplateType): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GlobalIconTemplate, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<GlobalIconTemplate>;
+}
+
+declare const NGN_ICON_KEYS: readonly ["accordion-collapse", "accordion-expand", "breadcrumb-separator", "breadcrumb-overflow", "calendar-trigger", "calendar-previous-month", "calendar-next-month", "checkbox-checked", "checkbox-indeterminate", "chip-remove", "dialog-close", "drawer-close", "dropdown-toggle", "edit-confirm", "filter-active", "filter-inactive", "filter-remove", "hint-info", "hint-success", "hint-warning", "hint-error", "input-clear", "menu-submenu", "paginator-previous", "paginator-next", "search", "sort-neutral", "sort-ascending", "sort-descending", "spin-decrement", "spin-increment", "table-group-toggle", "tabs-scroll-left", "tabs-scroll-right", "toast-close", "snackbar-close", "upload-trigger", "upload-done", "upload-failed", "upload-retry", "upload-cancel", "upload-remove"];
+type NgnIconKey = (typeof NGN_ICON_KEYS)[number];
+type NgnIconRegistry = Record<NgnIconKey, IconifyIcon | NgnIconEntry>;
+type NgnCustomIconRegistry = Record<NgnIconKey, IconType>;
+declare const NGN_ICON_REGISTRY: InjectionToken<NgnIconRegistry | NgnCustomIconRegistry>;
+declare const NGN_CUSTOM_ICONS: InjectionToken<boolean>;
+declare function withCustomIcons(registry: NgnCustomIconRegistry): NgnFeature;
+
+/**
+ * @category control
+ */
+declare class NgnIcon extends NgnBase<'icon'> {
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"icon", ["root", "default"], readonly []>>;
+    private readonly _globalIconTemplate;
+    private readonly _sanitizer;
+    private readonly _registry;
+    private readonly _isCustom;
+    /**
+     * A key into the registered icon set (from `withDefaultIcons()` or `withCustomIcons()`).
+     * Used as a fallback when {@link icon} is not provided; requires an icon registry.
+     * @default undefined
+     */
+    readonly defaultIcon: _angular_core.InputSignal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
+    /**
+     * The icon to render. Accepts an Iconify data object, a registered icon entry, or a
+     * custom value resolved via the {@link GlobalIconTemplate}. Takes precedence over {@link defaultIcon}.
+     * @default undefined
+     */
+    readonly icon: _angular_core.InputSignal<IconifyIcon | NgnIconEntry | undefined>;
+    protected readonly iconSvg: _angular_core.Signal<SafeHtml | null>;
+    protected readonly defaultIconSvg: _angular_core.Signal<SafeHtml | null>;
+    protected readonly customDefaultIcon: _angular_core.Signal<IconifyIcon | NgnIconEntry | null>;
+    protected readonly iconTemplate: _angular_core.Signal<_ngneers_controls_icon.IconTemplateType | null>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnIcon, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnIcon, "ngn-icon", never, { "defaultIcon": { "alias": "defaultIcon"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { GlobalIconTemplate, NGN_CUSTOM_ICONS, NGN_ICON_KEYS, NGN_ICON_REGISTRY, NgnIcon, withCustomIcons };
+export type { IconTemplateContext, IconTemplateType, NgnCustomIconRegistry, NgnIconKey, NgnIconRegistry };