@elasticias/ui 1.0.9 → 1.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elasticias/ui",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/types/elasticias-ui.d.ts

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import { PipeTransform, OnInit, OnChanges, TemplateRef, EventEmitter, AfterContentInit, OnDestroy, SimpleChanges, InjectionToken, AfterViewInit } from '@angular/core';
 import { Menu } from 'primeng/menu';
 import * as _elasticias_core from '@elasticias/core';
-import { EfModule, EfNavSection, EfNavItem, EfModuleId, EfToast, EfToastAction, EfThemeConfigService } from '@elasticias/core';
+import { EfBuildPackage, EfModule, EfNavSection, EfNavItem, EfModuleId, EfToast, EfToastAction, EfThemeConfigService } from '@elasticias/core';
 import * as i1 from 'primeng/tooltip';
 import * as _elasticias_screens from '@elasticias/screens';
 import { ScreenContext, EfDetailToolbarAction, EfSearchToolbarAction, EfDataCardColumn, EfDataCardSort, EfDateRange, EfDatePresetKey } from '@elasticias/screens';
@@ -981,6 +981,83 @@ declare class EfBuildStampComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfBuildStampComponent, "ef-build-stamp", never, { "owner": { "alias": "owner"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * The server half of the deployment, as an app fetches it from its own API.
+ * Every field is optional: the dialog renders the group only for what it was
+ * given, so an app with no such endpoint simply omits the input.
+ */
+interface EfAboutServer {
+    /** Hosting environment — may differ from the build's own environment. */
+    environment?: string;
+    /** Runtime description, e.g. `.NET 10.0.6`. */
+    runtime?: string;
+    /** Version of the API itself. */
+    version?: string;
+    /** Shared framework assemblies loaded by the API. */
+    packages?: EfBuildPackage[];
+}
+/**
+ * "About this app" — which build is running and what shared packages it
+ * was compiled against.
+ *
+ * Reads `EF_BUILD_INFO` optionally and renders the build rows only when the
+ * app provided it, so a consumer that wired no stamp still gets a usable
+ * dialog with its product identity.
+ *
+ * It is deliberately a dialog rather than a screen: the information is
+ * consulted (to paste a commit into an issue, to check which release a
+ * tenant is on) and dismissed, never navigated to.
+ *
+ * ```html
+ * <ef-about-dialog [(visible)]="aboutOpen" product="Crescilio" [edition]="tenantName()" />
+ * ```
+ */
+declare class EfAboutDialogComponent {
+    /** Two-way open state. */
+    readonly visible: _angular_core.ModelSignal<boolean>;
+    /** Product name, shown large under the mark. */
+    readonly product: _angular_core.InputSignal<string>;
+    /** One muted line under the product — a tenant, a plan, an edition. */
+    readonly edition: _angular_core.InputSignal<string>;
+    /** Which organisation this deployment serves, as a labelled row. */
+    readonly organisation: _angular_core.InputSignal<string>;
+    /** What the API reports about itself. Leave empty to hide the group. */
+    readonly server: _angular_core.InputSignal<EfAboutServer>;
+    /** Outbound link, already carrying whatever query the app wants on it. */
+    readonly websiteUrl: _angular_core.InputSignal<string>;
+    /** What the link reads as — a domain, not a sentence. */
+    readonly websiteLabel: _angular_core.InputSignal<string>;
+    /** Brand mark. A logo wins over the initial when both are set; empty
+     *  means "none", the same way `edition` and `initial` read. */
+    readonly logoUrl: _angular_core.InputSignal<string>;
+    readonly initial: _angular_core.InputSignal<string>;
+    /** Copyright holder on the last line. */
+    readonly owner: _angular_core.InputSignal<string>;
+    protected readonly info: _elasticias_core.EfBuildInfo;
+    protected readonly year: number;
+    protected readonly packages: _angular_core.Signal<EfBuildPackage[]>;
+    /**
+     * A released build is known by its version; an unreleased one has no
+     * version to be known by. Same split as `ef-build-stamp`: printing an
+     * empty row is worse than printing none.
+     */
+    protected readonly rows: _angular_core.Signal<{
+        labelKey: string;
+        value: string;
+    }[]>;
+    /** The API's own identity, above the assemblies it loaded. */
+    protected readonly serverRows: _angular_core.Signal<{
+        labelKey: string;
+        value: string;
+    }[]>;
+    protected readonly serverPackages: _angular_core.Signal<EfBuildPackage[]>;
+    protected readonly hasServer: _angular_core.Signal<boolean>;
+    /** A footer button, not only the header ✕: a thumb needs a real target. */
+    protected readonly closeAction: EfDialogAction[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfAboutDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfAboutDialogComponent, "ef-about-dialog", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "product": { "alias": "product"; "required": false; "isSignal": true; }; "edition": { "alias": "edition"; "required": false; "isSignal": true; }; "organisation": { "alias": "organisation"; "required": false; "isSignal": true; }; "server": { "alias": "server"; "required": false; "isSignal": true; }; "websiteUrl": { "alias": "websiteUrl"; "required": false; "isSignal": true; }; "websiteLabel": { "alias": "websiteLabel"; "required": false; "isSignal": true; }; "logoUrl": { "alias": "logoUrl"; "required": false; "isSignal": true; }; "initial": { "alias": "initial"; "required": false; "isSignal": true; }; "owner": { "alias": "owner"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; }, never, never, true, never>;
+}
+
 /**
  * Comptoir-skinned tooltip.
  *
@@ -1394,10 +1471,21 @@ declare class EfAppShellComponent {
     readonly moduleSections: _angular_core.Signal<EfNavSection[]>;
     onNavigate(item: EfNavItem): void;
     openSwitcher(): void;
+    /**
+     * Dismiss the module sheet from outside.
+     *
+     * Every item the shell itself renders in the sheet navigates, and
+     * navigating closes it. An app-level entry in the `[sheet-footer]` slot
+     * may do neither — "à propos" opens a dialog — and would otherwise leave
+     * the sheet standing behind it. The app owns that button, so the app says
+     * when the sheet is done: `<ef-app-shell #shell>` then
+     * `(click)="shell.closeSwitcher(); …"`.
+     */
+    closeSwitcher(): void;
     onSwitcherChange(open: boolean): void;
     onSelect(module: EfModule): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfAppShellComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfAppShellComponent, "ef-app-shell", never, { "stripe": { "alias": "stripe"; "required": false; }; }, {}, never, ["[logo]", "[side-header-meta]", "[side-footer]", "[breadcrumb]", "[search]", "[actions]", "*", "[fab]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfAppShellComponent, "ef-app-shell", never, { "stripe": { "alias": "stripe"; "required": false; }; }, {}, never, ["[logo]", "[side-header-meta]", "[side-footer]", "[breadcrumb]", "[search]", "[actions]", "*", "[fab]", "[sheet-footer]"], true, never>;
 }
 
 /**
@@ -1818,7 +1906,7 @@ declare class EfProfileChipComponent {
     role?: string;
     /** Translation key for the role line — takes priority over `role`. */
     roleKey?: string;
-    /** Override the avatar glyph. Defaults to the first letter of `name`. */
+    /** Override the avatar glyph (up to two characters). Defaults to the first letter of `name`. */
     initial?: string;
     /** Tenant tone uses `--tenant-500`; neutral uses `--ink-active`. */
     tone: 'tenant' | 'neutral';
@@ -5230,5 +5318,5 @@ declare class EfEmailMetricsCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfEmailMetricsCardComponent, "ef-email-metrics-card", never, { "metrics": { "alias": "metrics"; "required": false; "isSignal": true; }; "recentEvents": { "alias": "recentEvents"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "rangeChange": "rangeChange"; }, never, never, true, never>;
 }
 
-export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRankListComponent, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfServerErrorsDirective, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
-export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfKpiDeltaTone, EfKpiSparkline, EfPillItem, EfPresetItem, EfRankRow, EfRowAction, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };
+export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRankListComponent, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfServerErrorsDirective, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
+export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfAboutServer, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfKpiDeltaTone, EfKpiSparkline, EfPillItem, EfPresetItem, EfRankRow, EfRowAction, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };