@nova-design-system/nova-webcomponents 3.27.0 → 3.29.0

package/dist/types/index.d.ts

@@ -12,8 +12,10 @@ export * as classUtils from './utils/class.utils';
 export * as eventUtils from './utils/events.utils';
 export * as stringUtils from './utils/string.utils';
 export * as uriUtils from './utils/uri.utils';
+export * as dateTimeUtils from './utils/nova-datetime';
 export type * from './components.d.ts';
 export * as animations from './animations';
 export * as searchEngine from './utils/search-engine';
 export { iconNames } from './components/nv-icon/nv-icons';
 export { WeekAbbreviations } from './interfaces/localization';
+export * from './interfaces/dates';

package/dist/types/interfaces/dates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * JS representation of a TimeOnly value (maps to TimeOnly in C#)
+ */
+export type TimeOnly = `${number}:${number}:${number}`;
+/**
+ * JS representation of a DateOnly value (maps to DateOnly in C#)
+ */
+export type DateOnly = `${number}-${number}-${number}`;

package/dist/types/nova-docs.d.ts

@@ -34,6 +34,14 @@ export interface NovaDocsGeneric<T> {
    */
   badge?: NovaBadge;
 
+  /**
+   * Parent grouping name for organizing related components together.
+   * When set, creates a hierarchy under components: "components/parent-component/sub-component"
+   * Use the parent component name (e.g., 'nv-breadcrumbs') to group child components.
+   * Example: parentGroup: 'nv-breadcrumbs' creates "components/nv-breadcrumbs/nv-breadcrumb"
+   */
+  parentGroup?: string;
+
   /**
    * Tag name of the component
    */

package/dist/types/utils/nova-datetime.d.ts

@@ -0,0 +1,79 @@
+import { LocalTime, LocalDate, LocalDateTime } from '@js-joda/core';
+import type { TimeOnly, DateOnly } from '../interfaces/dates';
+/**
+ * Parse a TimeOnly string (HH:mm or HH:mm:ss) into a LocalTime.
+ * @param {string} value - The time string to parse.
+ * @returns {LocalTime | null} The parsed LocalTime, or null if invalid.
+ */
+export declare function parseTimeOnly(value: string): LocalTime | null;
+/**
+ * Parse a DateOnly string (YYYY-MM-DD) into a LocalDate.
+ * @param {string} value - The date string to parse.
+ * @returns {LocalDate | null} The parsed LocalDate, or null if invalid.
+ */
+export declare function parseDateOnly(value: string): LocalDate | null;
+/**
+ * Parse an ISO-8601 date-time string into a LocalDateTime.
+ * @param {string} value - The date-time string to parse.
+ * @returns {LocalDateTime | null} The parsed LocalDateTime, or null if invalid.
+ */
+export declare function parseLocalDateTime(value: string): LocalDateTime | null;
+/**
+ * Format a LocalTime as a TimeOnly string (always HH:mm:ss).
+ * @param {LocalTime} time - The LocalTime to format.
+ * @returns {TimeOnly} The formatted TimeOnly string.
+ */
+export declare function formatTimeOnly(time: LocalTime): TimeOnly;
+/**
+ * Format a LocalDate as a DateOnly string (YYYY-MM-DD).
+ * @param {LocalDate} date - The LocalDate to format.
+ * @returns {DateOnly} The formatted DateOnly string.
+ */
+export declare function formatDateOnly(date: LocalDate): DateOnly;
+/**
+ * Format a LocalDateTime as an ISO-8601 string.
+ * @param {LocalDateTime} dt - The LocalDateTime to format.
+ * @returns {string} The formatted ISO-8601 string.
+ */
+export declare function formatLocalDateTime(dt: LocalDateTime): string;
+/**
+ * Returns true if the string is a valid TimeOnly value.
+ * @param {string} value - The string to validate.
+ * @returns {boolean} Whether the string is a valid TimeOnly.
+ */
+export declare function isValidTimeOnly(value: string): value is TimeOnly;
+/**
+ * Returns true if the string is a valid DateOnly value.
+ * @param {string} value - The string to validate.
+ * @returns {boolean} Whether the string is a valid DateOnly.
+ */
+export declare function isValidDateOnly(value: string): value is DateOnly;
+/**
+ * Returns true if time `a` is before time `b`.
+ * @param {TimeOnly} a - The first time to compare.
+ * @param {TimeOnly} b - The second time to compare.
+ * @returns {boolean} Whether `a` is before `b`.
+ */
+export declare function isTimeBefore(a: TimeOnly, b: TimeOnly): boolean;
+/**
+ * Returns true if time `a` is after time `b`.
+ * @param {TimeOnly} a - The first time to compare.
+ * @param {TimeOnly} b - The second time to compare.
+ * @returns {boolean} Whether `a` is after `b`.
+ */
+export declare function isTimeAfter(a: TimeOnly, b: TimeOnly): boolean;
+/**
+ * Returns true if date `a` is before date `b`.
+ * @param {DateOnly} a - The first date to compare.
+ * @param {DateOnly} b - The second date to compare.
+ * @returns {boolean} Whether `a` is before `b`.
+ */
+export declare function isDateBefore(a: DateOnly, b: DateOnly): boolean;
+/**
+ * Returns true if date `a` is after date `b`.
+ * @param {DateOnly} a - The first date to compare.
+ * @param {DateOnly} b - The second date to compare.
+ * @returns {boolean} Whether `a` is after `b`.
+ */
+export declare function isDateAfter(a: DateOnly, b: DateOnly): boolean;
+export { LocalTime, LocalDate, LocalDateTime } from '@js-joda/core';

package/dist/types/utils/test/nova-datetime.test.d.ts

@@ -0,0 +1 @@
+export {};