@yuuvis/client-components 3.0.1 → 3.2.0

package/types/yuuvis-client-components-charts.d.ts

@@ -0,0 +1,47 @@
+import * as _angular_core from '@angular/core';
+import { AgChartOptions, AgChartTheme } from 'ag-charts-community';
+
+/**
+ * Wrapper component around AG Charts that automatically applies the
+ * application's chart theme based on the current UI theme (light, dark,
+ * high-contrast). Consumers provide standard AG Charts options and may
+ * optionally override the theme.
+ *
+ * @example
+ * ```html
+ * <yuv-chart [options]="chartOptions" />
+ * ```
+ */
+declare class YuvChartComponent {
+    private readonly themeService;
+    /** AG Charts configuration (data, series, axes, etc.). */
+    readonly options: _angular_core.InputSignal<AgChartOptions>;
+    /**
+     * Optional theme override. When provided, takes precedence over the
+     * theme resolved by {@link YuvChartThemeService} from the current UI mode.
+     */
+    readonly theme: _angular_core.InputSignal<string | AgChartTheme | undefined>;
+    /**
+     * Final options passed to AG Charts: the user-supplied {@link options}
+     * merged with either the explicit {@link theme} input or the theme
+     * derived from the active UI mode.
+     */
+    protected readonly mergedOptions: _angular_core.Signal<AgChartOptions>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuvChartComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuvChartComponent, "yuv-chart", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class YuvChartThemeService {
+    #private;
+    readonly chartTheme: _angular_core.Signal<AgChartTheme>;
+    constructor();
+    refresh(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuvChartThemeService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<YuvChartThemeService>;
+}
+
+type YuvChartOptions = AgChartOptions;
+type YuvChartMode = 'light' | 'dark' | 'high-contrast';
+
+export { YuvChartComponent, YuvChartThemeService };
+export type { YuvChartMode, YuvChartOptions };

package/types/yuuvis-client-components-common.d.ts

@@ -215,6 +215,12 @@ interface DragSelectOptions {
     disabled?: boolean;
     selectorColor?: string;
 }
+declare class DragSelectItemDirective {
+    #private;
+    el: HTMLElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DragSelectItemDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DragSelectItemDirective, "[yuvDragSelectItem]", never, {}, {}, never, never, true, never>;
+}
 declare class DragSelectDirective {
     #private;
     onPointerDown(event: PointerEvent): void;
@@ -225,12 +231,6 @@ declare class DragSelectDirective {
     static ɵfac: i0.ɵɵFactoryDeclaration<DragSelectDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<DragSelectDirective, "[yuvDragSelect]", never, { "yuvDragSelect": { "alias": "yuvDragSelect"; "required": false; "isSignal": true; }; }, { "dragSelectChange": "dragSelectChange"; "dragSelect": "dragSelect"; }, ["items"], never, true, never>;
 }
-declare class DragSelectItemDirective {
-    #private;
-    el: HTMLElement;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DragSelectItemDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DragSelectItemDirective, "[yuvDragSelectItem]", never, {}, {}, never, never, true, never>;
-}
 
 /**
  * Directive for adding drag scroll behaviour to a container element. Elements that overlow will then

package/types/yuuvis-client-components-list.d.ts

@@ -359,14 +359,14 @@ declare class ListComponent implements OnDestroy {
 }
 
 declare class ListTileComponent {
-    iconSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    titleSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    descriptionSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    asideSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    actionsSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    badgesSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    metaSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
-    extensionSlot: _angular_core.Signal<TemplateRef<any> | undefined>;
+    iconSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    titleSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    descriptionSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    asideSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    actionsSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    badgesSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    metaSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    extensionSlot: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListTileComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListTileComponent, "yuv-list-tile", never, {}, {}, ["iconSlot", "titleSlot", "descriptionSlot", "asideSlot", "actionsSlot", "badgesSlot", "metaSlot", "extensionSlot"], ["*"], true, never>;
 }

package/types/yuuvis-client-components-table-grid.d.ts

@@ -0,0 +1,60 @@
+import * as _angular_core from '@angular/core';
+import { AgGridAngular } from 'ag-grid-angular';
+import { ColDef, ColGroupDef, GridOptions, Theme, GridReadyEvent, SelectionChangedEvent, RowClickedEvent, RowDoubleClickedEvent, CellClickedEvent, SortChangedEvent, FilterChangedEvent } from 'ag-grid-community';
+export { CellClickedEvent, ColDef, ColGroupDef, FilterChangedEvent, GridApi, GridOptions, GridReadyEvent, RowClickedEvent, RowDoubleClickedEvent, SelectionChangedEvent, SortChangedEvent, Theme } from 'ag-grid-community';
+
+/**
+ * Thin Angular wrapper around {@link AgGridAngular} that provides a yuuvis-themed
+ * data grid with a consistent host class and pre-applied default theme.
+ *
+ * Inputs are forwarded to the underlying AG Grid instance, and the most common
+ * grid events are re-emitted as Angular outputs. Consumers that need access to
+ * the raw grid API can read the {@link grid} view child.
+ *
+ * @typeParam TData - Row data type rendered by the grid.
+ *
+ * @example
+ * ```html
+ * <yuv-table-grid
+ *   [rowData]="rows()"
+ *   [columnDefs]="columns"
+ *   (rowClicked)="onRowClicked($event)">
+ * </yuv-table-grid>
+ * ```
+ */
+declare class YuvTableGridComponent<TData = unknown> {
+    /** Row data rendered by the grid. `null` keeps the grid in its loading state. */
+    readonly rowData: _angular_core.InputSignal<TData[] | null>;
+    /** Column or column-group definitions describing the grid's structure. */
+    readonly columnDefs: _angular_core.InputSignal<(ColDef<TData, any> | ColGroupDef<TData>)[]>;
+    /** Additional AG Grid options merged with the component's defaults. */
+    readonly gridOptions: _angular_core.InputSignal<GridOptions<TData>>;
+    /** AG Grid theme applied to the grid; defaults to the yuuvis grid theme. */
+    readonly theme: _angular_core.InputSignal<Theme>;
+    /** Emitted once the grid has finished initializing and the API is available. */
+    readonly gridReady: _angular_core.OutputEmitterRef<GridReadyEvent<TData, any>>;
+    /** Emitted whenever the set of selected rows changes. */
+    readonly selectionChanged: _angular_core.OutputEmitterRef<SelectionChangedEvent<TData, any>>;
+    /** Emitted when a row is clicked. */
+    readonly rowClicked: _angular_core.OutputEmitterRef<RowClickedEvent<TData, any>>;
+    /** Emitted when a row is double-clicked. */
+    readonly rowDoubleClicked: _angular_core.OutputEmitterRef<RowDoubleClickedEvent<TData, any>>;
+    /** Emitted when a cell is clicked. */
+    readonly cellClicked: _angular_core.OutputEmitterRef<CellClickedEvent<TData, any, any>>;
+    /** Emitted when the grid's sort state changes. */
+    readonly sortChanged: _angular_core.OutputEmitterRef<SortChangedEvent<TData, any>>;
+    /** Emitted when the grid's filter state changes. */
+    readonly filterChanged: _angular_core.OutputEmitterRef<FilterChangedEvent<TData, any>>;
+    /** Reference to the underlying AG Grid Angular instance for direct API access. */
+    readonly grid: _angular_core.Signal<AgGridAngular<any, any>>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuvTableGridComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuvTableGridComponent<any>, "yuv-table-grid", never, { "rowData": { "alias": "rowData"; "required": false; "isSignal": true; }; "columnDefs": { "alias": "columnDefs"; "required": false; "isSignal": true; }; "gridOptions": { "alias": "gridOptions"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; }, { "gridReady": "gridReady"; "selectionChanged": "selectionChanged"; "rowClicked": "rowClicked"; "rowDoubleClicked": "rowDoubleClicked"; "cellClicked": "cellClicked"; "sortChanged": "sortChanged"; "filterChanged": "filterChanged"; }, never, never, true, never>;
+}
+
+declare const yuuvisTableGridTheme: Theme;
+type YuuvisTableGridThemeOverrides = Record<string, unknown>;
+declare function buildYuuvisTableGridTheme(overrides?: YuuvisTableGridThemeOverrides): Theme;
+
+export { YuvTableGridComponent, buildYuuvisTableGridTheme, yuuvisTableGridTheme };
+export type { YuuvisTableGridThemeOverrides };