@sme.up/ketchup 8.0.1 → 8.1.0

package/dist/types/managers/kup-dates/kup-dates-declarations.d.ts

@@ -1,29 +1,39 @@
-/**
- * Normalization types.
- */
-export declare enum KupDatesNormalize {
-  DATE = "date",
-  TIME = "time",
-  TIMESTAMP = "timestamp"
-}
-/**
- * Common use formats
- */
-export declare enum KupDatesFormats {
-  ISO_DATE = "YYYY-MM-DD",
-  ISO_DATE_TIME = "YYYY-MM-DD HH:mm:ss",
-  ISO_TIME = "HH:mm:ss",
-  ISO_TIME_WITHOUT_SECONDS = "HH:mm"
-}
-/**
- * Supported locales.
- */
-export declare enum KupDatesLocales {
-  CHINESE = "cn",
-  ENGLISH = "en",
-  FRENCH = "fr",
-  ITALIAN = "it",
-  POLISH = "pl",
-  RUSSIAN = "ru",
-  SPANISH = "es"
-}
+/**
+ * Normalization types.
+ */
+export declare enum KupDatesNormalize {
+  DATE = "date",
+  TIME = "time",
+  TIMESTAMP = "timestamp"
+}
+/**
+ * Supported locales.
+ */
+export declare enum KupDatesLocales {
+  CHINESE = "cn",
+  ENGLISH = "en",
+  FRENCH = "fr",
+  ITALIAN = "it",
+  POLISH = "pl",
+  RUSSIAN = "ru",
+  SPANISH = "es"
+}
+/**
+ * Format Months
+ */
+export declare enum KupDateTimeFormatOptionsMonth {
+  NUMERIC = "numeric",
+  DIGIT2 = "2-digit",
+  LONG = "long",
+  SHORT = "short",
+  NARROW = "narrow"
+}
+/**
+ * Common use formats
+ */
+export declare enum KupDatesFormats {
+  ISO_DATE = "YYYY-MM-DD",
+  ISO_DATE_TIME = "YYYY-MM-DD HH:mm:ss",
+  ISO_TIME = "HH:mm:ss",
+  ISO_TIME_WITHOUT_SECONDS = "HH:mm"
+}

package/dist/types/managers/kup-dates/kup-dates.d.ts

@@ -1,114 +1,207 @@
-import dayjs from 'dayjs';
-import 'dayjs/locale/es';
-import 'dayjs/locale/fr';
-import 'dayjs/locale/it';
-import 'dayjs/locale/pl';
-import 'dayjs/locale/ru';
-import 'dayjs/locale/zh';
-import { KupComponent } from '../../types/GenericTypes';
-import { KupDatesLocales, KupDatesNormalize } from './kup-dates-declarations';
-/**
- * Handles operations and formatting of dates.
- * @module KupDates
- */
-export declare class KupDates {
-  dayjs: Function;
-  locale: KupDatesLocales;
-  managedComponents: Set<KupComponent>;
-  /**
-   * Initializes KupDates.
-   */
-  constructor(locale?: KupDatesLocales);
-  /**
-   * Sets the locale from the browser or from a given argument.
-   * @returns {string} Locale string.
-   * @see https://github.com/iamkun/dayjs/issues/732
-   */
-  setLocale(locale?: KupDatesLocales): string;
-  /**
-   * @returns {string} The current locale.
-   */
-  getLocale(): string;
-  /**
-   * Gets the available locales.
-   * @returns {Array<KupDatesLocales>} Array of locales' names.
-   */
-  getLocales(): Array<KupDatesLocales>;
-  /**
-   * Formats the given date.
-   * @param {dayjs.ConfigType} input - Date to be formatted.
-   * @param {string} format - Output format.
-   * @see https://day.js.org/docs/en/display/format
-   */
-  format(input: dayjs.ConfigType, format?: string): string;
-  /**
-   * Validates the given date.
-   * @param {dayjs.ConfigType} date - Date to be validated.
-   * @param {string} format - Format of the input date.
-   * @param {boolean} strict - Strict parsing requires that the format and input match exactly, including delimiters.
-   * @returns {boolean} Returns whether the argument is a valid date or not.
-   */
-  isValid(date: dayjs.ConfigType, format?: string, strict?: boolean): boolean;
-  /**
-   * Converts the input in a Date object.
-   * @param {dayjs.ConfigType} input - Input date.
-   * @param {string} format - Format of the input date.
-   * @returns {Date} Date object.
-   */
-  toDate(input: dayjs.ConfigType, format?: string): Date;
-  /**
-   * Converts the input in a Dayjs object.
-   * @param {dayjs.ConfigType} input - Input date.
-   * @param {string} format - Format of the input date.
-   * @returns {dayjs.Dayjs} Dayjs object.
-   */
-  toDayjs(input: dayjs.ConfigType, format?: string): dayjs.Dayjs;
-  /**
-   * Returns a computed ISO date/time from a partial string.
-   * @param {string} input - Input string containing a partial date/time (i.e.: 011221).
-   * @param {KupDatesNormalize} type - Type of the input string.
-   * @returns {dayjs.Dayjs} Dayjs object of the normalized date.
-   */
-  normalize(input: string, type?: KupDatesNormalize): dayjs.Dayjs;
-  /**
-   * Returns the minimum date from an array of dates.
-   * @param {dayjs.ConfigType[]} dates - Array of dates.
-   * @returns {dayjs.Dayjs} Minimum date.
-   */
-  min(dates: dayjs.ConfigType[]): dayjs.Dayjs;
-  /**
-   * Returns the maximum date from an array of dates.
-   * @param {dayjs.ConfigType[]} dates - Array of dates.
-   * @returns {dayjs.Dayjs} Maximum date.
-   */
-  max(dates: dayjs.ConfigType[]): dayjs.Dayjs;
-  /**
-   * Adds the given amount of time to the input date.
-   * @param {dayjs.ConfigType} input - Input date.
-   * @param {number} value - The value of the addition (i.e.: 7).
-   * @param {dayjs.OpUnitType} unit - The unit of the addition (i.e.: "year").
-   * @returns {dayjs.Dayjs} Computed date.
-   * @see https://day.js.org/docs/en/manipulate/add
-   */
-  add(input: dayjs.ConfigType, value: number, unit?: dayjs.OpUnitType): dayjs.Dayjs;
-  /**
-   * Subtracts the given amount of time from the input date.
-   * @param {dayjs.ConfigType} input - Input date.
-   * @param {number} value - The value of the subtraction (i.e.: 7).
-   * @param {dayjs.OpUnitType} unit - The unit of the subtraction (i.e.: "year").
-   * @returns {dayjs.Dayjs} Computed date.
-   * @see https://day.js.org/docs/en/manipulate/subtract
-   */
-  subtract(input: dayjs.ConfigType, value: number, unit?: dayjs.OpUnitType): dayjs.Dayjs;
-  /**
-   * Registers a KupComponent in KupDates, in order to be properly handled whenever the locale changes.
-   * @param {any} component - The Ketchup component to be registered.
-   */
-  register(component: any): void;
-  /**
-   * Unregisters a KupComponent, so it won't be refreshed when the locale changes.
-   *
-   * @param {any} component - The component calling this function.
-   */
-  unregister(component: any): void;
-}
+import dayjs from 'dayjs';
+import 'dayjs/locale/es';
+import 'dayjs/locale/fr';
+import 'dayjs/locale/it';
+import 'dayjs/locale/pl';
+import 'dayjs/locale/ru';
+import 'dayjs/locale/zh';
+import { KupComponent } from '../../types/GenericTypes';
+import { KupDateTimeFormatOptionsMonth, KupDatesLocales, KupDatesNormalize } from './kup-dates-declarations';
+/**
+ * Handles operations and formatting of dates.
+ * @module KupDates
+ */
+export declare class KupDates {
+  dayjs: Function;
+  locale: KupDatesLocales;
+  managedComponents: Set<KupComponent>;
+  /**
+   * Initializes KupDates.
+   */
+  constructor(locale?: KupDatesLocales);
+  /**
+   * Sets the locale from the browser or from a given argument.
+   * @returns {string} Locale string.
+   * @see https://github.com/iamkun/dayjs/issues/732
+   */
+  setLocale(locale?: KupDatesLocales): string;
+  /**
+   * @returns {string} The current locale.
+   */
+  getLocale(): string;
+  /**
+   * Gets the available locales.
+   * @returns {Array<KupDatesLocales>} Array of locales' names.
+   */
+  getLocales(): Array<KupDatesLocales>;
+  /**
+   * Gets date format by browser locale
+   * @returns {string} date format pattern, by browser locale
+   */
+  getDateFormat(): string;
+  /**
+   * Gets time format by browser locale
+   * @param {boolean} manageSeconds flag to set seconds managing
+   * @returns {string} time format pattern, by browser locale
+   */
+  getTimeFormat(manageSeconds: boolean): string;
+  /**
+   * Formats the given date.
+   * @param {dayjs.ConfigType} input - Date to be formatted.
+   * @param {string} format - Output format.
+   * @see https://day.js.org/docs/en/display/format
+   */
+  format(input: dayjs.ConfigType, format?: string): string;
+  /**
+   * Gets the time formatted
+   * @param {Date} time time as Date object
+   * @param {boolean} manageSeconds flag to set seconds managing
+   * @return {string} time as string, formatted
+   **/
+  formatTime(time: Date, manageSeconds: boolean): string;
+  /**
+   * Validates the given date.
+   * @param {dayjs.ConfigType} date - Date to be validated.
+   * @param {string} format - Format of the input date.
+   * @param {boolean} strict - Strict parsing requires that the format and input match exactly, including delimiters.
+   * @returns {boolean} Returns whether the argument is a valid date or not.
+   */
+  isValid(date: dayjs.ConfigType, format?: string, strict?: boolean): boolean;
+  /**
+   * Validates the given date as string.
+   * @param {string} value time string, formatted by actual browser locale
+   * @param {boolean} manageSeconds if manage seconds
+   * @returns {boolean} true if time string in input is a valid time
+   */
+  isValidFormattedStringTime(value: string, manageSeconds: boolean): boolean;
+  /**
+   * Converts the input in a Date object.
+   * @param {dayjs.ConfigType} input - Input date.
+   * @param {string} format - Format of the input date.
+   * @returns {Date} Date object.
+   */
+  toDate(input: dayjs.ConfigType, format?: string): Date;
+  /**
+   * Converts the input in a Dayjs object.
+   * @param {dayjs.ConfigType} input - Input date.
+   * @param {string} format - Format of the input date.
+   * @returns {dayjs.Dayjs} Dayjs object.
+   */
+  toDayjs(input: dayjs.ConfigType, format?: string): dayjs.Dayjs;
+  /**
+   * Returns a computed ISO date/time from a partial string.
+   * @param {string} input - Input string containing a partial date/time (i.e.: 011221).
+   * @param {KupDatesNormalize} type - Type of the input string.
+   * @returns {dayjs.Dayjs} Dayjs object of the normalized date.
+   */
+  normalize(input: string, type?: KupDatesNormalize): dayjs.Dayjs;
+  /**
+   * Returns the minimum date from an array of dates.
+   * @param {dayjs.ConfigType[]} dates - Array of dates.
+   * @returns {dayjs.Dayjs} Minimum date.
+   */
+  min(dates: dayjs.ConfigType[]): dayjs.Dayjs;
+  /**
+   * Returns the maximum date from an array of dates.
+   * @param {dayjs.ConfigType[]} dates - Array of dates.
+   * @returns {dayjs.Dayjs} Maximum date.
+   */
+  max(dates: dayjs.ConfigType[]): dayjs.Dayjs;
+  /**
+   * Adds the given amount of time to the input date.
+   * @param {dayjs.ConfigType} input - Input date.
+   * @param {number} value - The value of the addition (i.e.: 7).
+   * @param {dayjs.OpUnitType} unit - The unit of the addition (i.e.: "year").
+   * @returns {dayjs.Dayjs} Computed date.
+   * @see https://day.js.org/docs/en/manipulate/add
+   */
+  add(input: dayjs.ConfigType, value: number, unit?: dayjs.ManipulateType): dayjs.Dayjs;
+  /**
+   * Subtracts the given amount of time from the input date.
+   * @param {dayjs.ConfigType} input - Input date.
+   * @param {number} value - The value of the subtraction (i.e.: 7).
+   * @param {dayjs.OpUnitType} unit - The unit of the subtraction (i.e.: "year").
+   * @returns {dayjs.Dayjs} Computed date.
+   * @see https://day.js.org/docs/en/manipulate/subtract
+   */
+  subtract(input: dayjs.ConfigType, value: number, unit?: dayjs.ManipulateType): dayjs.Dayjs;
+  /**
+   * Gets the month formatted
+   * @param {number} month month id
+   * @param {KupDateTimeFormatOptionsMonth} format format
+   * @returns {string} the month formatted, by browser locale
+   */
+  getMonthAsString(month: number, format: KupDateTimeFormatOptionsMonth): string;
+  /**
+   * Gets the year months formatted
+   * @param {KupDateTimeFormatOptionsMonth} format format
+   * @returns {string[]} the months formatted, by browser locale
+   */
+  getMonthsAsString(format?: KupDateTimeFormatOptionsMonth): string[];
+  /**
+   * Gets the day formatted
+   * @param {Date} date date
+   * @returns {string} the day formatted, by browser locale
+   */
+  getDayAsString(date: Date): string;
+  /**
+   * First day of current week
+   * @param {number} firstDayIndex first day of week index
+   * @returns {Date} the first day of current week
+   */
+  firstDayThisWeek(firstDayIndex?: number): Date;
+  /**
+   * Dates of current week
+   * @param {number} firstDayIndex first day of week index
+   * @returns { startDate: Date; endDate: Date } the dates of current week
+   */
+  thisWeek(firstDayIndex?: number): {
+    startDate: Date;
+    endDate: Date;
+  };
+  /**
+   * Gets the days of current week as string
+   * @param {number} firstDayIndex first day of week index
+   * @returns {string[]} the days of current week as string
+   */
+  getDaysOfWeekAsString(firstDayIndex?: number): string[];
+  /**
+   * Gets the timestamp formatted
+   * @param {string} value date/time as string, formatted ISO
+   * @returns {string} date/time as string, formatted by actual browser locale
+   **/
+  timestampStringToFormattedString(value: string): string;
+  /**
+   * Gets ISO date/time from formatted string, as string
+   * @param {string} value date/time as string, formatted by actual browser locale
+   * @returns {string} date/time as string, formatted ISO
+   **/
+  formattedStringToTimestampString(value: string): string;
+  /**
+   * Gets formatted dateTime as customed ISO (see KupDatesFormats)
+   * @param {string} value time as string, formatted by actual browser locale
+   * @param {string} outputFormat time format to return (see KupDatesFormats)
+   * @param {boolean} manageSeconds flag to set seconds managing
+   * @returns {string} time as string, formatted
+   **/
+  formattedStringToCustomDateTime(value: string, outputFormat: string, manageSeconds: boolean): string;
+  /**
+   * Gets the time formatted
+   * @param {string} value time as string, formatted ISO
+   * @param {boolean} manageSeconds flag to set seconds managing
+   * @param {string} customedFormat time format from smeupObject
+   * @returns {string} time as string, formatted by actual browser locale
+   **/
+  timeStringToFormattedString(value: string, manageSeconds: boolean, customedFormat?: string): string;
+  /**
+   * Registers a KupComponent in KupDates, in order to be properly handled whenever the locale changes.
+   * @param {any} component - The Ketchup component to be registered.
+   */
+  register(component: any): void;
+  /**
+   * Unregisters a KupComponent, so it won't be refreshed when the locale changes.
+   *
+   * @param {any} component - The component calling this function.
+   */
+  unregister(component: any): void;
+}

package/dist/types/managers/kup-debug/kup-debug-declarations.d.ts

@@ -1,38 +1,38 @@
-/**
- * Interface for the logs of KupDebug.
- */
-export interface KupDebugLog {
-  category: KupDebugCategory;
-  date: Date;
-  id: string;
-  element: string | Object;
-  message: string;
-}
-/**
- * Interface for printed logs.
- */
-export interface KupDebugLogPrint {
-  [index: string]: {
-    date: string;
-    element: string | Object;
-    message: string;
-  }[];
-}
-/**
- * Category of debug logs.
- */
-export declare enum KupDebugCategory {
-  INFO = "Informational",
-  WARNING = "Warning",
-  ERROR = "Error"
-}
-/**
- * Colors associated with every type of log to be printed.
- */
-export declare enum KupDebugLogColor {
-  'Load' = "green",
-  'Render' = "green",
-  'Resize' = "green",
-  'Misc' = "blue",
-  'Total' = "teal"
-}
+/**
+ * Interface for the logs of KupDebug.
+ */
+export interface KupDebugLog {
+  category: KupDebugCategory;
+  date: Date;
+  id: string;
+  element: string | Object;
+  message: string;
+}
+/**
+ * Interface for printed logs.
+ */
+export interface KupDebugLogPrint {
+  [index: string]: {
+    date: string;
+    element: string | Object;
+    message: string;
+  }[];
+}
+/**
+ * Category of debug logs.
+ */
+export declare enum KupDebugCategory {
+  INFO = "Informational",
+  WARNING = "Warning",
+  ERROR = "Error"
+}
+/**
+ * Colors associated with every type of log to be printed.
+ */
+export declare enum KupDebugLogColor {
+  'Load' = "green",
+  'Render' = "green",
+  'Resize' = "green",
+  'Misc' = "blue",
+  'Total' = "teal"
+}

package/dist/types/managers/kup-debug/kup-debug.d.ts

@@ -1,95 +1,95 @@
-import type { GenericObject } from '../../types/GenericTypes';
-import { KupDebugCategory, KupDebugLog } from './kup-debug-declarations';
-/**
- * Debugging suite, used to log messages and statuses from the Ketchup components.
- * @module KupDebug
- */
-export declare class KupDebug {
-  #private;
-  active: boolean;
-  autoPrint: boolean;
-  container: HTMLElement;
-  logLimit: number;
-  logs: KupDebugLog[];
-  /**
-   * Initializes KupDebug.
-   * @param {boolean} active - When true, the debug is active on initialization.
-   * @param {boolean} autoprint - When true, logs will be automatically printed inside the debug widget.
-   * @param {number} logLimit - Maximum amount of logs stored, when they exceed the number specified in logLimit the cache will be automatically cleared.
-   */
-  constructor(active?: boolean, autoprint?: boolean, logLimit?: number);
-  /**
-   * Allows the download of props by creating a temporary clickable anchor element.
-   */
-  private downloadProps;
-  /**
-   * Creates the debug widget.
-   */
-  private showWidget;
-  /**
-   * Listens the card events and handles the related actions.
-   * @param {CustomEvent<KupCardEventPayload>} e - kup-card-event.
-   * @param {KupDebug} kupDebug - Instance of the KupDebug class.
-   */
-  private handleEvents;
-  /**
-   * Closes the debug widget.
-   */
-  private hideWidget;
-  /**
-   * Clears all the printed logs inside the debug widget.
-   */
-  private widgetClear;
-  /**
-   * Prints the stored logs inside the debug widget.
-   */
-  private widgetPrint;
-  /**
-   * Dumps the stored logs.
-   */
-  dump(): void;
-  /**
-   * Displays a table with debug information inside the browser's console.
-   */
-  print(): void;
-  /**
-   * Function used to set the status of the debug.
-   * If no argument is provided, this method will work as a toggler.
-   * @param {boolean} value - If this argument is provided, the debug status will be forced to its value.
-   */
-  toggle(value?: boolean): void;
-  /**
-   * Function used to check whether the debug is active or not.
-   * @returns {boolean} Status of the debug.
-   */
-  isDebug(): boolean;
-  /**
-   * Retrieves the information for every component in this.logs by invoking the getProps public method of each component.
-   * 'tag' will contain the props of the component's html tag (i.e.: <kup-chip>).
-   * 'props' will contain the developer defined props of the component, making it handy for test purposes.
-   * @param {boolean} detail - If provided and true, the returned object will contain additional information (i.e.: className, id).
-   * @returns {GenericObject} Props of the components.
-   */
-  getProps(detail?: boolean): Promise<GenericObject>;
-  /**
-   * Displays a timestamped message in the browser's console when the kupDebug property on document.documentElement is true.
-   * Warnings and errors will be displayed even when kupDebug !== true.
-   * @param {any} comp - The component calling this function or a string.
-   * @param {string} message - The actual message that will be printed.
-   * @param {KupDebugCategory} category - The type of console message, defaults to log but warning and error can be used as well.
-   */
-  logMessage(comp: any, message: string, category?: KupDebugCategory): void;
-  /**
-   * Function used to time the loading times of a component.
-   * @param {any} comp - The component calling this function or a string.
-   * @param {boolean} didLoad - Must be set to false when called inside a componentWillLoad() lifecycle hook and true when called inside componentDidLoad().
-   */
-  logLoad(comp: any, didLoad: boolean): void;
-  /**
-   * Function used to time the render times of a component.
-   * @param {any} comp - The component calling this function or a string.
-   * @param {boolean} didRender - Must be set to false when called inside a componentWillRender() lifecycle hook and true when called inside componentDidRender().
-   * @param {string} breakpoint - When present, this log is supposedly between a willRender and didRender hook. Used to time single features of the render lifecycle.
-   */
-  logRender(comp: any, didRender: boolean, breakpoint?: string): void;
-}
+import type { GenericObject } from '../../types/GenericTypes';
+import { KupDebugCategory, KupDebugLog } from './kup-debug-declarations';
+/**
+ * Debugging suite, used to log messages and statuses from the Ketchup components.
+ * @module KupDebug
+ */
+export declare class KupDebug {
+  #private;
+  active: boolean;
+  autoPrint: boolean;
+  container: HTMLElement;
+  logLimit: number;
+  logs: KupDebugLog[];
+  /**
+   * Initializes KupDebug.
+   * @param {boolean} active - When true, the debug is active on initialization.
+   * @param {boolean} autoprint - When true, logs will be automatically printed inside the debug widget.
+   * @param {number} logLimit - Maximum amount of logs stored, when they exceed the number specified in logLimit the cache will be automatically cleared.
+   */
+  constructor(active?: boolean, autoprint?: boolean, logLimit?: number);
+  /**
+   * Allows the download of props by creating a temporary clickable anchor element.
+   */
+  private downloadProps;
+  /**
+   * Creates the debug widget.
+   */
+  private showWidget;
+  /**
+   * Listens the card events and handles the related actions.
+   * @param {CustomEvent<KupCardEventPayload>} e - kup-card-event.
+   * @param {KupDebug} kupDebug - Instance of the KupDebug class.
+   */
+  private handleEvents;
+  /**
+   * Closes the debug widget.
+   */
+  private hideWidget;
+  /**
+   * Clears all the printed logs inside the debug widget.
+   */
+  private widgetClear;
+  /**
+   * Prints the stored logs inside the debug widget.
+   */
+  private widgetPrint;
+  /**
+   * Dumps the stored logs.
+   */
+  dump(): void;
+  /**
+   * Displays a table with debug information inside the browser's console.
+   */
+  print(): void;
+  /**
+   * Function used to set the status of the debug.
+   * If no argument is provided, this method will work as a toggler.
+   * @param {boolean} value - If this argument is provided, the debug status will be forced to its value.
+   */
+  toggle(value?: boolean): void;
+  /**
+   * Function used to check whether the debug is active or not.
+   * @returns {boolean} Status of the debug.
+   */
+  isDebug(): boolean;
+  /**
+   * Retrieves the information for every component in this.logs by invoking the getProps public method of each component.
+   * 'tag' will contain the props of the component's html tag (i.e.: <kup-chip>).
+   * 'props' will contain the developer defined props of the component, making it handy for test purposes.
+   * @param {boolean} detail - If provided and true, the returned object will contain additional information (i.e.: className, id).
+   * @returns {GenericObject} Props of the components.
+   */
+  getProps(detail?: boolean): Promise<GenericObject>;
+  /**
+   * Displays a timestamped message in the browser's console when the kupDebug property on document.documentElement is true.
+   * Warnings and errors will be displayed even when kupDebug !== true.
+   * @param {any} comp - The component calling this function or a string.
+   * @param {string} message - The actual message that will be printed.
+   * @param {KupDebugCategory} category - The type of console message, defaults to log but warning and error can be used as well.
+   */
+  logMessage(comp: any, message: string, category?: KupDebugCategory): void;
+  /**
+   * Function used to time the loading times of a component.
+   * @param {any} comp - The component calling this function or a string.
+   * @param {boolean} didLoad - Must be set to false when called inside a componentWillLoad() lifecycle hook and true when called inside componentDidLoad().
+   */
+  logLoad(comp: any, didLoad: boolean): void;
+  /**
+   * Function used to time the render times of a component.
+   * @param {any} comp - The component calling this function or a string.
+   * @param {boolean} didRender - Must be set to false when called inside a componentWillRender() lifecycle hook and true when called inside componentDidRender().
+   * @param {string} breakpoint - When present, this log is supposedly between a willRender and didRender hook. Used to time single features of the render lifecycle.
+   */
+  logRender(comp: any, didRender: boolean, breakpoint?: string): void;
+}