@eherve/angular-material-section-tabs 0.0.0-stage → 22.0.0

package/types/eherve-angular-material-section-tabs.d.ts

@@ -0,0 +1,569 @@
+import * as i0 from "@angular/core";
+import { AfterContentInit, AfterViewInit, ChangeDetectorRef, DestroyRef, ElementRef, EventEmitter, InjectionToken, OnChanges, OnDestroy, SimpleChanges, TemplateRef, Type } from "@angular/core";
+import { Observable, Subject } from "rxjs";
+import { SafeHtml } from "@angular/platform-browser";
+import * as i9 from "@angular/common";
+import * as i10 from "@angular/material/button";
+import * as i11 from "@angular/material/icon";
+import * as i12 from "@angular/material/menu";
+import * as i13 from "@angular/material/core";
+import * as i14 from "@angular/material/slide-toggle";
+import * as i15 from "@angular/material/tooltip";
+export interface SectionSelectionHandler {
+  observe(key: string): Observable<string | null>;
+  select(key: string, value: string): void | Promise<void>;
+}
+export declare const SECTION_SELECTION_HANDLER: InjectionToken<SectionSelectionHandler>;
+export interface SectionTabsMessages {
+  sections: string;
+  emptySections: string;
+  emptyComponents: string;
+  emptyFields: string;
+  emptyFieldsDescription: string;
+  showEmptyFields: string;
+}
+export declare class SectionTabsIntl {
+  readonly changes: Subject<void>;
+  messages: SectionTabsMessages;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsIntl, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+declare namespace section_tab_content_directive_d_exports {
+  export { SectionTabContentDirective };
+}
+export declare class SectionTabContentDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  constructor(templateRef: TemplateRef<unknown>);
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabContentDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SectionTabContentDirective, "ng-template[appSectionTabContent]", never, {}, {}, never, never, false, never>;
+}
+declare namespace section_tab_label_directive_d_exports {
+  export { SectionTabLabelDirective };
+}
+export declare class SectionTabLabelDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  constructor(templateRef: TemplateRef<unknown>);
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabLabelDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SectionTabLabelDirective, "ng-template[appSectionTabLabel]", never, {}, {}, never, never, false, never>;
+}
+declare namespace section_tab_component_d_exports {
+  export { SectionTabComponent, SectionTabCounter, SectionTabType };
+}
+export type SectionTabCounter = number | string | null | undefined;
+export type SectionTabType = "button" | "separator";
+export declare class SectionTabComponent implements OnChanges, OnDestroy {
+  type: SectionTabType;
+  queryParamValue?: string;
+  disabled: boolean;
+  done: SectionTabCounter;
+  total: SectionTabCounter;
+  totalMax: SectionTabCounter;
+  progress: boolean;
+  statusColor?: string | undefined;
+  statusColorDone?: string;
+  statusColorTotal?: string;
+  labelDirective?: SectionTabLabelDirective;
+  contentDirective?: SectionTabContentDirective;
+  readonly stateChanges: Subject<void>;
+  ngOnChanges(): void;
+  ngOnDestroy(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SectionTabComponent, "app-section-tab", never, {
+    "type": {
+      "alias": "type";
+      "required": false;
+    };
+    "queryParamValue": {
+      "alias": "queryParamValue";
+      "required": false;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+    };
+    "done": {
+      "alias": "done";
+      "required": false;
+    };
+    "total": {
+      "alias": "total";
+      "required": false;
+    };
+    "totalMax": {
+      "alias": "totalMax";
+      "required": false;
+    };
+    "progress": {
+      "alias": "progress";
+      "required": false;
+    };
+    "statusColor": {
+      "alias": "statusColor";
+      "required": false;
+    };
+    "statusColorDone": {
+      "alias": "statusColorDone";
+      "required": false;
+    };
+    "statusColorTotal": {
+      "alias": "statusColorTotal";
+      "required": false;
+    };
+  }, {}, ["labelDirective", "contentDirective"], never, false, never>;
+  static ngAcceptInputType_disabled: unknown;
+}
+declare namespace section_tabs_component_d_exports {
+  export { SectionTabItem, SectionTabsComponent, sectionTabsSlideBottomTransitions, sectionTabsSlideTopTransitions };
+}
+export interface SectionTabItem {
+  tab: SectionTabComponent;
+  type: SectionTabType;
+  index: number;
+  renderIndex: number;
+  queryParamValue?: string;
+  selected: boolean;
+  disabled: boolean;
+  buttonId: string;
+  panelId: string;
+  statusDoneLabel?: string;
+  statusTotalLabel?: string;
+  progress?: number;
+  labelTemplate?: TemplateRef<unknown>;
+  contentTemplate?: TemplateRef<unknown>;
+}
+export declare const sectionTabsSlideTopTransitions: (import("@angular/animations").AnimationQueryMetadata | import("@angular/animations").AnimationGroupMetadata)[];
+export declare const sectionTabsSlideBottomTransitions: (import("@angular/animations").AnimationQueryMetadata | import("@angular/animations").AnimationGroupMetadata)[];
+export declare class SectionTabsComponent implements AfterContentInit, OnChanges, OnDestroy {
+  private static nextId;
+  selectedIndex: number;
+  queryParamKey?: string;
+  selectedIndexChange: EventEmitter<number>;
+  private tabComponents;
+  private menuHeaderDirective?;
+  private footerDirective?;
+  readonly intl: SectionTabsIntl;
+  readonly instanceId: string;
+  tabItems: SectionTabItem[];
+  activeTabItems: SectionTabItem[];
+  selectedTabItem?: SectionTabItem;
+  menuHeaderTemplate?: TemplateRef<unknown>;
+  footerTemplate?: TemplateRef<unknown>;
+  private readonly changeDetectorRef;
+  private readonly handler;
+  private readonly errorHandler;
+  private handlerSubscription?;
+  private handlerGeneration;
+  private externalValue;
+  private readonly subscriptions;
+  private tabStateSubscriptions;
+  private contentInitialized;
+  ngAfterContentInit(): void;
+  ngOnChanges(changes: SimpleChanges): void;
+  ngOnDestroy(): void;
+  selectTab(tabItem: SectionTabItem): void;
+  private handleTabsChange;
+  private handleTabStateChange;
+  private refreshProjectedTemplates;
+  private refreshTabItems;
+  private buildTabItems;
+  private refreshTabStateSubscriptions;
+  private buildTabItem;
+  private synchronizeSelectionWithQueryParameter;
+  private bindSelectionHandler;
+  private getQueryParameterValue;
+  private updateQueryParameter;
+  private buildDoneLabel;
+  private buildTotalLabel;
+  private buildDisplayedTotal;
+  private toNumericCounter;
+  private buildProgress;
+  private hasCounterValue;
+  private applySelectedIndex;
+  private getSafeSelectedIndex;
+  private refreshSelection;
+  private clearSelection;
+  private getSelectableTabItems;
+  private isSelectableTabItem;
+  private isButtonTabItem;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SectionTabsComponent, "app-section-tabs", never, {
+    "selectedIndex": {
+      "alias": "selectedIndex";
+      "required": false;
+    };
+    "queryParamKey": {
+      "alias": "queryParamKey";
+      "required": false;
+    };
+  }, {
+    "selectedIndexChange": "selectedIndexChange";
+  }, ["menuHeaderDirective", "footerDirective", "tabComponents"], never, false, never>;
+}
+export interface SectionTabsDisplayGrid {
+  columns: number;
+  gap: string;
+  minColumnWidth: string;
+}
+export type SectionTabsDisplaySectionMode = 'default' | 'single-card';
+export interface SectionTabsDisplayLayout {
+  colSpan?: number;
+  rowSpan?: number;
+  breakBefore?: boolean;
+  breakAfter?: boolean;
+  styles?: Record<string, string>;
+  classes?: string;
+}
+export type SectionTabsDisplayCounter = number | string | null | undefined;
+export interface SectionTabsDisplayCompletion {
+  disabled?: boolean;
+  done?: SectionTabsDisplayCounter;
+  total?: SectionTabsDisplayCounter;
+  donePath?: string;
+  totalPath?: string;
+}
+export interface SectionTabsDisplaySelectOption {
+  label: string;
+  value: unknown;
+  color?: string;
+}
+export interface SectionTabsDisplayChipConfig {
+  icon?: string;
+  labelPath?: string;
+  color?: string;
+  colorPath?: string;
+  trackByPath?: string;
+}
+export interface SectionTabsDisplayChipViewModel {
+  label: string;
+  trackValue: unknown;
+  icon?: string;
+  color?: string;
+}
+export type SectionTabsDisplayFieldKind = 'text' | 'number' | 'date' | 'select' | 'chips' | 'component' | string;
+export type SectionTabsDisplayCardKind = 'fields' | 'component';
+export interface SectionTabsDisplayFieldLabelAction {
+  active: boolean;
+  disabled: boolean;
+  ariaLabel: string;
+  onClick: () => void | Promise<void>;
+}
+export interface SectionTabsDisplayField {
+  kind: SectionTabsDisplayFieldKind;
+  visible?: (record: any) => boolean;
+  label: string;
+  path: string;
+  labelAction?: SectionTabsDisplayFieldLabelAction;
+  layout?: SectionTabsDisplayLayout;
+  color?: string;
+  suffix?: string;
+  decimal?: number;
+  unit?: string;
+  dateFormat?: string;
+  options?: SectionTabsDisplaySelectOption[];
+  chips?: SectionTabsDisplayChipConfig;
+  component?: Type<unknown>;
+  componentInputs?: Record<string, unknown>;
+  onClick?: (value: any) => void;
+}
+export interface SectionTabsDisplayCardMenuOption {
+  id: string;
+  label: string;
+  icon?: string;
+  tooltip?: string;
+  ariaLabel?: string;
+  disabled: boolean;
+  handle: () => void;
+}
+export interface SectionTabsDisplayCardAction {
+  id?: string;
+  type: 'icon' | 'button';
+  icon?: string;
+  label?: string;
+  tooltip?: string;
+  ariaLabel?: string;
+  color?: string;
+  disabled: boolean;
+  menuOptions?: SectionTabsDisplayCardMenuOption[];
+  handle: () => void;
+}
+export interface SectionTabsDisplayCard {
+  id: string;
+  visible?: (record: any) => boolean;
+  label: string;
+  icon?: string;
+  tooltip?: string;
+  kind?: SectionTabsDisplayCardKind;
+  path?: string;
+  grid?: SectionTabsDisplayGrid;
+  layout?: SectionTabsDisplayLayout;
+  fields?: SectionTabsDisplayField[];
+  component?: Type<unknown>;
+  componentInputs?: Record<string, unknown>;
+  completion?: false | SectionTabsDisplayCompletion;
+  actions?: SectionTabsDisplayCardAction[];
+}
+export interface SectionTabsDisplaySection {
+  id: string;
+  queryParamValue?: string;
+  visible?: (record: any) => boolean;
+  label: string;
+  icon?: string;
+  tooltip?: string;
+  sectionMode?: SectionTabsDisplaySectionMode;
+  grid?: SectionTabsDisplayGrid;
+  cards: SectionTabsDisplayCard[];
+  completion?: false | SectionTabsDisplayCompletion;
+}
+export interface SectionTabsDisplayOptions {
+  data: unknown;
+  sections: SectionTabsDisplaySection[];
+  showEmptyFields?: boolean;
+  showEmptyFieldsToggle?: boolean;
+  showEmptyFieldsLabel?: string;
+}
+export interface SectionTabsDisplayFieldComponentContext {
+  data: unknown;
+  value: unknown;
+  field: SectionTabsDisplayField;
+  card: SectionTabsDisplayCard;
+  section: SectionTabsDisplaySection;
+  options: SectionTabsDisplayOptions;
+}
+export interface SectionTabsDisplayCardComponentContext {
+  data: unknown;
+  value: unknown;
+  card: SectionTabsDisplayCard;
+  section: SectionTabsDisplaySection;
+  options: SectionTabsDisplayOptions;
+}
+declare namespace section_tabs_display_component_d_exports {
+  export { SectionTabsDisplayComponent };
+}
+interface SectionTabsDisplayCompletionState {
+  enabled: boolean;
+  done?: SectionTabsDisplayCounter;
+  total?: SectionTabsDisplayCounter;
+  label?: string;
+}
+interface SectionTabsDisplayRenderBreak {
+  id: string;
+  type: 'break';
+}
+interface SectionTabsDisplayRenderField {
+  id: string;
+  type: 'field';
+  source: SectionTabsDisplayField;
+  label: string;
+  labelAction?: SectionTabsDisplayFieldLabelAction;
+  kind: SectionTabsDisplayFieldKind;
+  value: unknown;
+  filled: boolean;
+  displayValue: string | SafeHtml;
+  chipsValue: SectionTabsDisplayChipViewModel[];
+  color?: string;
+  suffix?: string;
+  component?: Type<unknown>;
+  componentInputs?: Record<string, unknown>;
+  styles: Record<string, string>;
+  classes: Record<string, boolean>;
+  onClick?: (value: any) => void;
+}
+type SectionTabsDisplayFieldItem = SectionTabsDisplayRenderBreak | SectionTabsDisplayRenderField;
+interface SectionTabsDisplayRenderCard {
+  id: string;
+  type: 'card';
+  source: SectionTabsDisplayCard;
+  responsiveGrid: boolean;
+  label: string;
+  icon?: string;
+  tooltip?: string;
+  kind: SectionTabsDisplayCardKind;
+  component?: Type<unknown>;
+  componentInputs?: Record<string, unknown>;
+  gridStyles: Record<string, string>;
+  styles: Record<string, string>;
+  classes: Record<string, boolean>;
+  items: SectionTabsDisplayFieldItem[];
+  completion: SectionTabsDisplayCompletionState;
+  actions?: SectionTabsDisplayCardAction[];
+}
+interface SectionTabsDisplayRenderCardBreak {
+  id: string;
+  type: 'break';
+}
+type SectionTabsDisplayCardItem = SectionTabsDisplayRenderCard | SectionTabsDisplayRenderCardBreak;
+interface SectionTabsDisplayRenderSection {
+  id: string;
+  queryParamValue: string;
+  source: SectionTabsDisplaySection;
+  responsiveGrid: boolean;
+  label: string;
+  icon?: string;
+  tooltip?: string;
+  sectionMode: SectionTabsDisplaySectionMode;
+  cardCount: number;
+  gridStyles: Record<string, string>;
+  items: SectionTabsDisplayCardItem[];
+  done?: SectionTabsDisplayCounter;
+  total?: SectionTabsDisplayCounter;
+}
+interface SectionTabsDisplayViewModel {
+  sections: SectionTabsDisplayRenderSection[];
+  empty: boolean;
+}
+export declare class SectionTabsDisplayComponent implements OnChanges {
+  private readonly locale;
+  readonly intl: SectionTabsIntl;
+  private readonly componentInputNamesByType;
+  private pickDeclaredComponentInputs;
+  private getDeclaredComponentInputNames;
+  options: SectionTabsDisplayOptions;
+  selectedIndex: number;
+  queryParamKey?: string;
+  menuHeader?: string;
+  showEmptyFields?: boolean;
+  selectedIndexChange: EventEmitter<number>;
+  showEmptyFieldsChange: EventEmitter<boolean>;
+  viewModel: SectionTabsDisplayViewModel;
+  showEmptyFieldsState: boolean;
+  showEmptyFieldsToggle: boolean;
+  showEmptyFieldsLabel: string;
+  private emptyFieldsStateInitialized;
+  private lastOptionShowEmptyFields?;
+  constructor(locale: string, intl: SectionTabsIntl, changeDetector: ChangeDetectorRef, destroyRef: DestroyRef);
+  ngOnChanges(): void;
+  onSelectedIndexChange(index: number): void;
+  onShowEmptyFieldsChange(checked: boolean): void;
+  onClickFieldItem(fieldItem: SectionTabsDisplayRenderField): void;
+  private syncEmptyFieldsLabel;
+  private syncEmptyFieldsOptions;
+  private buildViewModel;
+  private buildSection;
+  private buildCardItems;
+  private buildCard;
+  private buildFields;
+  private buildVisibleFieldItems;
+  private buildField;
+  private buildFieldComponentInputs;
+  private buildCardComponentInputs;
+  private buildFieldId;
+  private buildGridStyles;
+  private buildLayoutStyles;
+  private hasRowSpan;
+  private buildLayoutClasses;
+  private resolveCompletion;
+  private calculateFieldsCompletion;
+  private calculateSectionCompletion;
+  private resolveExplicitCounter;
+  private buildCompletionLabel;
+  private hasCounterValue;
+  private isVisible;
+  private shouldRenderField;
+  private getCardKind;
+  private formatFieldValue;
+  private formatTextValue;
+  private formatNumberValue;
+  private formatDateValue;
+  private buildChipViewModels;
+  private normalizeChipItems;
+  private resolveChipLabel;
+  private resolveChipTrackValue;
+  private resolveChipColor;
+  private formatOptionalValue;
+  private isSafeHtmlValue;
+  private formatUnknownValue;
+  private findSelectOption;
+  private areValuesEqual;
+  private getPathValue;
+  private parsePath;
+  private normalizePositiveInteger;
+  private isFilled;
+  private isPrimitiveValue;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsDisplayComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SectionTabsDisplayComponent, "app-section-tabs-display", never, {
+    "options": {
+      "alias": "options";
+      "required": true;
+    };
+    "selectedIndex": {
+      "alias": "selectedIndex";
+      "required": false;
+    };
+    "queryParamKey": {
+      "alias": "queryParamKey";
+      "required": false;
+    };
+    "menuHeader": {
+      "alias": "menuHeader";
+      "required": false;
+    };
+    "showEmptyFields": {
+      "alias": "showEmptyFields";
+      "required": false;
+    };
+  }, {
+    "selectedIndexChange": "selectedIndexChange";
+    "showEmptyFieldsChange": "showEmptyFieldsChange";
+  }, never, never, false, never>;
+}
+declare namespace section_tabs_menu_header_directive_d_exports {
+  export { SectionTabsMenuHeaderDirective };
+}
+export declare class SectionTabsMenuHeaderDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  constructor(templateRef: TemplateRef<unknown>);
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsMenuHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SectionTabsMenuHeaderDirective, "ng-template[appSectionTabsMenuHeader]", never, {}, {}, never, never, false, never>;
+}
+declare namespace section_tabs_footer_directive_d_exports {
+  export { SectionTabsFooterDirective };
+}
+export declare class SectionTabsFooterDirective {
+  readonly templateRef: TemplateRef<unknown>;
+  constructor(templateRef: TemplateRef<unknown>);
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsFooterDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SectionTabsFooterDirective, "ng-template[appSectionTabsFooter]", never, {}, {}, never, never, false, never>;
+}
+declare namespace section_tabs_display_responsive_grid_directive_d_exports {
+  export { SectionTabsDisplayResponsiveGridDirective };
+}
+declare class SectionTabsDisplayResponsiveGridDirective implements AfterViewInit, OnChanges, OnDestroy {
+  private readonly elementRef;
+  grid?: SectionTabsDisplayGrid;
+  sectionTabsDisplayResponsiveGridEnabled: boolean;
+  private initialized;
+  private resizeObserver?;
+  private mutationObserver?;
+  constructor(elementRef: ElementRef<HTMLElement>);
+  ngAfterViewInit(): void;
+  ngOnChanges(_changes: SimpleChanges): void;
+  ngOnDestroy(): void;
+  private refreshObserver;
+  private observeMutations;
+  private applyLayout;
+  private applyResponsiveSpans;
+  private restoreConfiguredSpans;
+  private readOriginalSpan;
+  private resolveEffectiveColumns;
+  private getContentWidth;
+  private getGap;
+  private measureCssLength;
+  private parsePixelValue;
+  private normalizePositiveInteger;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsDisplayResponsiveGridDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SectionTabsDisplayResponsiveGridDirective, "[appSectionTabsDisplayResponsiveGrid]", never, {
+    "grid": {
+      "alias": "appSectionTabsDisplayResponsiveGrid";
+      "required": false;
+    };
+    "sectionTabsDisplayResponsiveGridEnabled": {
+      "alias": "sectionTabsDisplayResponsiveGridEnabled";
+      "required": false;
+    };
+  }, {}, never, never, false, never>;
+}
+export declare class SectionTabsModule {
+  static ɵfac: i0.ɵɵFactoryDeclaration<SectionTabsModule, never>;
+  static ɵmod: i0.ɵɵNgModuleDeclaration<SectionTabsModule, [typeof SectionTabsComponent, typeof SectionTabComponent, typeof SectionTabsDisplayComponent, typeof SectionTabLabelDirective, typeof SectionTabContentDirective, typeof SectionTabsMenuHeaderDirective, typeof SectionTabsFooterDirective, typeof SectionTabsDisplayResponsiveGridDirective], [typeof i9.CommonModule, typeof i10.MatButtonModule, typeof i11.MatIconModule, typeof i12.MatMenuModule, typeof i13.MatRippleModule, typeof i14.MatSlideToggleModule, typeof i15.MatTooltipModule], [typeof SectionTabsComponent, typeof SectionTabComponent, typeof SectionTabsDisplayComponent, typeof SectionTabLabelDirective, typeof SectionTabContentDirective, typeof SectionTabsMenuHeaderDirective, typeof SectionTabsFooterDirective]>;
+  static ɵinj: i0.ɵɵInjectorDeclaration<SectionTabsModule>;
+}