@porscheinformatik/clr-addons 19.10.4 → 19.11.1

package/summary-area/index.d.ts

@@ -0,0 +1,8 @@
+export * from './summary-area/summary-area';
+export * from './summary-area/summary-area.model';
+export * from './summary-area/summary-area-state.service';
+export * from './summary-area-toggle/summary-area-toggle';
+export * from './summary-item/summary-item';
+export * from './summary-item/summary-item.model';
+export * from './summary-item-value/summary-item-value';
+export * from './summary-item-value-copy-button/summary-item-value-copy-button';

package/summary-area/summary-area/summary-area-state.service.d.ts

@@ -0,0 +1,14 @@
+import { Signal } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare const defaultSummaryAreaCollapsedKey = "clrSummaryAreaCollapsed";
+export declare class ClrSummaryAreaStateService {
+    private readonly collapsedMap;
+    collapsed(key?: string): Signal<boolean>;
+    toggle(key?: string): void;
+    setCollapsed(key: string, value: boolean): void;
+    private getOrCreateEntry;
+    private persistToStorage;
+    private readInitialState;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryAreaStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ClrSummaryAreaStateService>;
+}

package/summary-area/summary-area/summary-area.d.ts

@@ -0,0 +1,45 @@
+import { AfterViewInit, QueryList, Signal } from '@angular/core';
+import { ClrSummaryItem } from '../summary-item/summary-item';
+import { ClrSummaryAreaColumns, ClrSummaryAreaRows, ClrSummaryAreaError, ClrSummaryAreaWarning, ClrSummaryAreaLoading } from './summary-area.model';
+import * as i0 from "@angular/core";
+export declare class ClrSummaryArea implements AfterViewInit {
+    items: QueryList<ClrSummaryItem>;
+    readonly rows: import("@angular/core").InputSignal<ClrSummaryAreaRows>;
+    readonly localStorageKey: import("@angular/core").InputSignal<string>;
+    readonly error: import("@angular/core").InputSignal<ClrSummaryAreaError>;
+    readonly warning: import("@angular/core").InputSignal<ClrSummaryAreaWarning>;
+    readonly loading: import("@angular/core").InputSignal<ClrSummaryAreaLoading>;
+    currentColumns: ClrSummaryAreaColumns;
+    currentRows: ClrSummaryAreaRows;
+    private readonly state;
+    private readonly cdr;
+    private readonly defaultLoadingText;
+    private readonly defaultErrorText;
+    private readonly defaultWarningText;
+    private readonly maxColumns;
+    readonly isCollapsed: Signal<boolean>;
+    constructor();
+    /**
+     * Depending on the current rows input only a specific amount of items can be visible to the user.
+     * The summary area only supports up to 5 columns.
+     * For 1 row, 5 items are visible, for 2 rows 10 items, and for 3 rows 15 items.
+     * Any items beyond that will not be shown.
+     * This logic is for meeting the requirement that it remains a summary area and does not grow indefinitely.
+     */
+    get visibleItems(): ClrSummaryItem[];
+    get hasLoading(): boolean;
+    get loadingText(): string;
+    get hasError(): boolean;
+    get errorText(): string;
+    get errorLinkText(): string | undefined;
+    get errorClick(): (() => void) | undefined;
+    get hasWarning(): boolean;
+    get warningText(): string;
+    get warningLinkText(): string | undefined;
+    get warningClick(): (() => void) | undefined;
+    onResize(): void;
+    ngAfterViewInit(): void;
+    private updateGrid;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryArea, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSummaryArea, "clr-summary-area", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "localStorageKey": { "alias": "localStorageKey"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, ["items"], never, true, never>;
+}

package/summary-area/summary-area/summary-area.model.d.ts

@@ -0,0 +1,18 @@
+export interface ClrSummaryAreaError {
+    active: boolean;
+    text?: string;
+    click?: () => void;
+    linkText?: string;
+}
+export interface ClrSummaryAreaWarning {
+    active: boolean;
+    text?: string;
+    click?: () => void;
+    linkText?: string;
+}
+export interface ClrSummaryAreaLoading {
+    active: boolean;
+    text?: string;
+}
+export type ClrSummaryAreaColumns = 1 | 2 | 3 | 4 | 5;
+export type ClrSummaryAreaRows = 1 | 2 | 3;

package/summary-area/summary-area-toggle/summary-area-toggle.d.ts

@@ -0,0 +1,12 @@
+import * as i0 from "@angular/core";
+export declare class ClrSummaryAreaToggle {
+    readonly summaryToggle: import("@angular/core").OutputEmitterRef<void>;
+    readonly ariaLabel: import("@angular/core").InputSignal<string>;
+    readonly localStorageKey: import("@angular/core").InputSignal<string>;
+    private readonly state;
+    readonly collapsed: import("@angular/core").Signal<boolean>;
+    handleKeydown(event: KeyboardEvent): void;
+    handleToggle(event?: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryAreaToggle, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSummaryAreaToggle, "clr-summary-area-toggle", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "localStorageKey": { "alias": "localStorageKey"; "required": false; "isSignal": true; }; }, { "summaryToggle": "summaryToggle"; }, never, never, true, never>;
+}

package/summary-area/summary-item/summary-item.d.ts

@@ -0,0 +1,57 @@
+import { AfterContentInit, AfterViewChecked, ElementRef, OnDestroy, QueryList, TemplateRef } from '@angular/core';
+import { ClrSummaryItemValue } from '../summary-item-value/summary-item-value';
+import { ClrSummaryItemError, ClrSummaryItemWarning, ClrSummaryItemLoading, ClrSummaryItemEditConfig } from './summary-item.model';
+import * as i0 from "@angular/core";
+export declare class ClrSummaryItem implements AfterContentInit, AfterViewChecked, OnDestroy {
+    template: TemplateRef<never>;
+    valuesContainer: ElementRef<HTMLDivElement>;
+    valueChildren: QueryList<ClrSummaryItemValue>;
+    label: import("@angular/core").InputSignal<string>;
+    error: import("@angular/core").InputSignal<ClrSummaryItemError>;
+    warning: import("@angular/core").InputSignal<ClrSummaryItemWarning>;
+    loading: import("@angular/core").InputSignal<ClrSummaryItemLoading>;
+    editConfig: import("@angular/core").InputSignal<ClrSummaryItemEditConfig>;
+    showOnEmptyValue: import("@angular/core").InputSignal<boolean>;
+    valueCopyable: import("@angular/core").InputSignal<boolean>;
+    hasProjectedContent: boolean;
+    private readonly cdr;
+    private mutationObserver?;
+    private contentCheckScheduled;
+    private viewInitialized;
+    private readonly defaultLoadingText;
+    private readonly defaultErrorText;
+    private readonly defaultWarningText;
+    private readonly defaultEditText;
+    get hasLoading(): boolean;
+    get loadingText(): string;
+    get hasError(): boolean;
+    get errorText(): string;
+    get errorClick(): (() => void) | undefined;
+    get hasWarning(): boolean;
+    get warningText(): string;
+    get warningClick(): (() => void) | undefined;
+    get showEditButton(): boolean;
+    get editText(): string;
+    get editClick(): (() => void) | undefined;
+    /**
+     * Only collect text values from child summary-item-value components
+     * Exclude projected content and empty values
+     */
+    get copyableValue(): string;
+    /**
+     * Only show copy button if:
+     * 1. valueCopyable is true
+     * 2. Not in loading, error, warning state
+     * 3. Not showing edit button
+     * 4. Has actual text values from summary-item-value components (not just projected content or placeholder)
+     */
+    get showCopyButton(): boolean;
+    ngAfterContentInit(): void;
+    ngAfterViewChecked(): void;
+    ngOnDestroy(): void;
+    private setupMutationObserver;
+    private scheduleContentCheck;
+    private updateProjectedContentFlag;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSummaryItem, "clr-summary-item", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "editConfig": { "alias": "editConfig"; "required": false; "isSignal": true; }; "showOnEmptyValue": { "alias": "showOnEmptyValue"; "required": false; "isSignal": true; }; "valueCopyable": { "alias": "valueCopyable"; "required": false; "isSignal": true; }; }, {}, ["valueChildren"], ["clr-summary-item-value", "*"], true, never>;
+}

package/summary-area/summary-item/summary-item.model.d.ts

@@ -0,0 +1,19 @@
+export interface ClrSummaryItemError {
+    active: boolean;
+    text?: string;
+    click?: () => void;
+}
+export interface ClrSummaryItemWarning {
+    active: boolean;
+    text?: string;
+    click?: () => void;
+}
+export interface ClrSummaryItemLoading {
+    active: boolean;
+    text?: string;
+}
+export interface ClrSummaryItemEditConfig {
+    enabled: boolean;
+    text?: string;
+    click: () => void;
+}

package/summary-area/summary-item-value/summary-item-value.d.ts

@@ -0,0 +1,54 @@
+import { AfterContentInit, AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class ClrSummaryItemValue implements OnInit, AfterContentInit, AfterViewInit, OnDestroy {
+    projectedContent?: ElementRef<HTMLSpanElement>;
+    valueElement?: ElementRef<HTMLSpanElement>;
+    readonly value: import("@angular/core").InputSignal<string>;
+    readonly icon: import("@angular/core").InputSignal<string>;
+    readonly tooltip: import("@angular/core").InputSignal<string>;
+    readonly clickable: import("@angular/core").InputSignal<boolean>;
+    readonly clicked: import("@angular/core").OutputEmitterRef<void>;
+    hasProjectedContent: boolean;
+    isTextOverflowing: boolean;
+    tooltipSize: string;
+    private resizeObserver?;
+    private mutationObserver?;
+    private contentCheckScheduled;
+    private readonly ngZone;
+    private readonly cdr;
+    get hasIcon(): boolean;
+    get hasText(): boolean;
+    get isHidden(): boolean;
+    get hasClickHandler(): boolean;
+    handleClick(): void;
+    /**
+     * Returns the tooltip text to display.
+     * If a text overflow is detected, the full value is used as tooltip.
+     * If no overflow, but a custom tooltip is provided, that is used.
+     * Tooltip is undefined otherwise.
+     */
+    get effectiveTooltip(): string | undefined;
+    /**
+     * Returns true if this component has any meaningful content to display.
+     * This includes: a value, an icon, or projected content.
+     */
+    get hasMeaningfulContent(): boolean;
+    /**
+     * Returns true if this component should be hidden.
+     * This happens when there's no meaningful content.
+     */
+    get shouldHide(): boolean;
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private setupMutationObserver;
+    private scheduleContentCheck;
+    private setupOverflowDetection;
+    private checkTextOverflowSync;
+    /** @internal - Manually trigger projected content check. Useful for testing. */
+    checkProjectedContent(): void;
+    private hasMeaningfulContentRecursive;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryItemValue, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSummaryItemValue, "clr-summary-item-value", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, ["*"], true, never>;
+}

package/summary-area/summary-item-value-copy-button/summary-item-value-copy-button.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class ClrSummaryItemValueCopyButton {
+    value: import("@angular/core").InputSignal<string>;
+    showValueCopiedIcon: Set<string>;
+    private readonly cdr;
+    copyValueClicked(value: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClrSummaryItemValueCopyButton, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClrSummaryItemValueCopyButton, "clr-summary-area-value-copy-button", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}