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

package/dist/types/components.d.ts

@@ -7,12 +7,14 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { ButtonEmphasis, ButtonSize, ButtonType, DeprecatedSemanticColors, FeedbackColors, GlobalFilterPosition, IconButtonShape, LabelPlacement, LoaderColors, NotificationEmphasis, NotificationPosition, SemanticSizes, TextInputAutocomplete, ToggleButtonEmphasis, ToggleButtonSize } from "./utils/constants";
 import { Column } from "./interfaces/Column";
+import { DateOnly, TimeOnly } from "./interfaces/dates";
 import { Element } from "./stencil-public-runtime";
 import { FilterMode } from "./utils/search-engine";
 import { IconName } from "./components/nv-icon/nv-icons";
 import { Placement, Strategy } from "@floating-ui/dom";
 export { ButtonEmphasis, ButtonSize, ButtonType, DeprecatedSemanticColors, FeedbackColors, GlobalFilterPosition, IconButtonShape, LabelPlacement, LoaderColors, NotificationEmphasis, NotificationPosition, SemanticSizes, TextInputAutocomplete, ToggleButtonEmphasis, ToggleButtonSize } from "./utils/constants";
 export { Column } from "./interfaces/Column";
+export { DateOnly, TimeOnly } from "./interfaces/dates";
 export { Element } from "./stencil-public-runtime";
 export { FilterMode } from "./utils/search-engine";
 export { IconName } from "./components/nv-icon/nv-icons";
@@ -572,6 +574,44 @@ export namespace Components {
          */
         "repeatTemplate": boolean;
     }
+    /**
+     * This is a test component for the new DateOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvDatetest {
+        /**
+          * Array of historical date changes.
+         */
+        "history": DateOnly[];
+        /**
+          * The last change.
+         */
+        "lastChange": DateOnly;
+        /**
+          * The date range value with start and end dates.
+         */
+        "value": { start?: DateOnly; end?: DateOnly };
+    }
+    /**
+     * This is a test component for the new DateTimeObject type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvDatetimetest {
+        /**
+          * Array of historical date changes.
+         */
+        "history": Date[];
+        /**
+          * The the last change.
+         */
+        "lastChange": Date;
+        /**
+          * The date range value with start and end dates.
+         */
+        "value": { start?: Date; end?: Date };
+    }
     interface NvDialog {
         /**
           * Controls whether the dialog should automatically focus the first focusable element when opened. When disabled, prevents unwanted tooltip triggers on dialog open.
@@ -2699,10 +2739,6 @@ export namespace Components {
          */
         "size": 'default' | 'reduced';
     }
-    /**
-     * @deprecated [EXPERIMENTAL]
-     * @experimental - Container for notifications TODO: add animations etc...
-     */
     interface NvNotificationcontainer {
         /**
           * Position of the notification container on the screen.
@@ -3120,6 +3156,25 @@ export namespace Components {
          */
         "sortable": boolean;
     }
+    /**
+     * This is a test component for the new TimeOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvTimetest {
+        /**
+          * Array of historical time changes.
+         */
+        "history": TimeOnly[];
+        /**
+          * The last change.
+         */
+        "lastChange": TimeOnly;
+        /**
+          * The time range value with start and end times.
+         */
+        "value": { start?: TimeOnly; end?: TimeOnly };
+    }
     interface NvToggle {
         /**
           * Indicates whether the toggle is checked or not.
@@ -3266,6 +3321,14 @@ export interface NvDatagridCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvDatagridElement;
 }
+export interface NvDatetestCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLNvDatetestElement;
+}
+export interface NvDatetimetestCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLNvDatetimetestElement;
+}
 export interface NvDialogCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvDialogElement;
@@ -3378,6 +3441,10 @@ export interface NvTableheaderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvTableheaderElement;
 }
+export interface NvTimetestCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLNvTimetestElement;
+}
 export interface NvToggleCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvToggleElement;
@@ -3595,6 +3662,55 @@ declare global {
         prototype: HTMLNvDatagridcolumnElement;
         new (): HTMLNvDatagridcolumnElement;
     };
+    interface HTMLNvDatetestElementEventMap {
+        "valueChanged": { start?: DateOnly; end?: DateOnly };
+        "lastChanged": { date: DateOnly };
+        "historyChanged": { dates: DateOnly[] };
+        "valueDateChanged": { start?: Date; end?: Date };
+    }
+    /**
+     * This is a test component for the new DateOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface HTMLNvDatetestElement extends Components.NvDatetest, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLNvDatetestElementEventMap>(type: K, listener: (this: HTMLNvDatetestElement, ev: NvDatetestCustomEvent<HTMLNvDatetestElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLNvDatetestElementEventMap>(type: K, listener: (this: HTMLNvDatetestElement, ev: NvDatetestCustomEvent<HTMLNvDatetestElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLNvDatetestElement: {
+        prototype: HTMLNvDatetestElement;
+        new (): HTMLNvDatetestElement;
+    };
+    interface HTMLNvDatetimetestElementEventMap {
+        "valueChanged": { start?: Date; end?: Date };
+        "lastChanged": { date: Date };
+        "historyChanged": { dates: Date[] };
+    }
+    /**
+     * This is a test component for the new DateTimeObject type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface HTMLNvDatetimetestElement extends Components.NvDatetimetest, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLNvDatetimetestElementEventMap>(type: K, listener: (this: HTMLNvDatetimetestElement, ev: NvDatetimetestCustomEvent<HTMLNvDatetimetestElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLNvDatetimetestElementEventMap>(type: K, listener: (this: HTMLNvDatetimetestElement, ev: NvDatetimetestCustomEvent<HTMLNvDatetimetestElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLNvDatetimetestElement: {
+        prototype: HTMLNvDatetimetestElement;
+        new (): HTMLNvDatetimetestElement;
+    };
     interface HTMLNvDialogElementEventMap {
         "openChanged": boolean;
     }
@@ -4057,10 +4173,6 @@ declare global {
         prototype: HTMLNvNotificationBulletElement;
         new (): HTMLNvNotificationBulletElement;
     };
-    /**
-     * @deprecated [EXPERIMENTAL]
-     * @experimental - Container for notifications TODO: add animations etc...
-     */
     interface HTMLNvNotificationcontainerElement extends Components.NvNotificationcontainer, HTMLStencilElement {
     }
     var HTMLNvNotificationcontainerElement: {
@@ -4276,6 +4388,31 @@ declare global {
         prototype: HTMLNvTableheaderElement;
         new (): HTMLNvTableheaderElement;
     };
+    interface HTMLNvTimetestElementEventMap {
+        "valueChanged": { start?: TimeOnly; end?: TimeOnly };
+        "lastChanged": { time: TimeOnly };
+        "historyChanged": { times: TimeOnly[] };
+        "valueDateChanged": { start?: Date; end?: Date };
+    }
+    /**
+     * This is a test component for the new TimeOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface HTMLNvTimetestElement extends Components.NvTimetest, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLNvTimetestElementEventMap>(type: K, listener: (this: HTMLNvTimetestElement, ev: NvTimetestCustomEvent<HTMLNvTimetestElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLNvTimetestElementEventMap>(type: K, listener: (this: HTMLNvTimetestElement, ev: NvTimetestCustomEvent<HTMLNvTimetestElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLNvTimetestElement: {
+        prototype: HTMLNvTimetestElement;
+        new (): HTMLNvTimetestElement;
+    };
     interface HTMLNvToggleElementEventMap {
         "checkedChanged": boolean;
     }
@@ -4363,6 +4500,8 @@ declare global {
         "nv-col": HTMLNvColElement;
         "nv-datagrid": HTMLNvDatagridElement;
         "nv-datagridcolumn": HTMLNvDatagridcolumnElement;
+        "nv-datetest": HTMLNvDatetestElement;
+        "nv-datetimetest": HTMLNvDatetimetestElement;
         "nv-dialog": HTMLNvDialogElement;
         "nv-dialogfooter": HTMLNvDialogfooterElement;
         "nv-dialogheader": HTMLNvDialogheaderElement;
@@ -4409,6 +4548,7 @@ declare global {
         "nv-stack": HTMLNvStackElement;
         "nv-table": HTMLNvTableElement;
         "nv-tableheader": HTMLNvTableheaderElement;
+        "nv-timetest": HTMLNvTimetestElement;
         "nv-toggle": HTMLNvToggleElement;
         "nv-togglebutton": HTMLNvTogglebuttonElement;
         "nv-togglebuttongroup": HTMLNvTogglebuttongroupElement;
@@ -5053,6 +5193,74 @@ declare namespace LocalJSX {
          */
         "repeatTemplate"?: boolean;
     }
+    /**
+     * This is a test component for the new DateOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvDatetest {
+        /**
+          * Array of historical date changes.
+         */
+        "history"?: DateOnly[];
+        /**
+          * The last change.
+         */
+        "lastChange"?: DateOnly;
+        /**
+          * Emitted when the history array changes.
+         */
+        "onHistoryChanged"?: (event: NvDatetestCustomEvent<{ dates: DateOnly[] }>) => void;
+        /**
+          * Emitted when the last change date updates.
+         */
+        "onLastChanged"?: (event: NvDatetestCustomEvent<{ date: DateOnly }>) => void;
+        /**
+          * Emitted when the date range value changes.
+          * @bind value
+         */
+        "onValueChanged"?: (event: NvDatetestCustomEvent<{ start?: DateOnly; end?: DateOnly }>) => void;
+        /**
+          * Emitted when the date range value changes as Date objects (local time).
+         */
+        "onValueDateChanged"?: (event: NvDatetestCustomEvent<{ start?: Date; end?: Date }>) => void;
+        /**
+          * The date range value with start and end dates.
+         */
+        "value"?: { start?: DateOnly; end?: DateOnly };
+    }
+    /**
+     * This is a test component for the new DateTimeObject type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvDatetimetest {
+        /**
+          * Array of historical date changes.
+         */
+        "history"?: Date[];
+        /**
+          * The the last change.
+         */
+        "lastChange"?: Date;
+        /**
+          * Emitted when the history array changes.
+         */
+        "onHistoryChanged"?: (event: NvDatetimetestCustomEvent<{ dates: Date[] }>) => void;
+        /**
+          * Emitted when the last change timestamp updates.
+         */
+        "onLastChanged"?: (event: NvDatetimetestCustomEvent<{ date: Date }>) => void;
+        /**
+          * Emitted when the date range value changes.
+          * @bind value
+         */
+        "onValueChanged"?: (event: NvDatetimetestCustomEvent<{ start?: Date; end?: Date }>) => void;
+        /**
+          * The date range value with start and end dates.
+         */
+        "value"?: { start?: Date; end?: Date };
+    }
     interface NvDialog {
         /**
           * Controls whether the dialog should automatically focus the first focusable element when opened. When disabled, prevents unwanted tooltip triggers on dialog open.
@@ -7265,10 +7473,6 @@ declare namespace LocalJSX {
          */
         "size"?: 'default' | 'reduced';
     }
-    /**
-     * @deprecated [EXPERIMENTAL]
-     * @experimental - Container for notifications TODO: add animations etc...
-     */
     interface NvNotificationcontainer {
         /**
           * Position of the notification container on the screen.
@@ -7658,6 +7862,42 @@ declare namespace LocalJSX {
          */
         "sortable"?: boolean;
     }
+    /**
+     * This is a test component for the new TimeOnly type
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvTimetest {
+        /**
+          * Array of historical time changes.
+         */
+        "history"?: TimeOnly[];
+        /**
+          * The last change.
+         */
+        "lastChange"?: TimeOnly;
+        /**
+          * Emitted when the history array changes.
+         */
+        "onHistoryChanged"?: (event: NvTimetestCustomEvent<{ times: TimeOnly[] }>) => void;
+        /**
+          * Emitted when the last change timestamp updates.
+         */
+        "onLastChanged"?: (event: NvTimetestCustomEvent<{ time: TimeOnly }>) => void;
+        /**
+          * Emitted when the time range value changes.
+          * @bind value
+         */
+        "onValueChanged"?: (event: NvTimetestCustomEvent<{ start?: TimeOnly; end?: TimeOnly }>) => void;
+        /**
+          * Emitted when the time range value changes as Date objects (local time).
+         */
+        "onValueDateChanged"?: (event: NvTimetestCustomEvent<{ start?: Date; end?: Date }>) => void;
+        /**
+          * The time range value with start and end times.
+         */
+        "value"?: { start?: TimeOnly; end?: TimeOnly };
+    }
     interface NvToggle {
         /**
           * Indicates whether the toggle is checked or not.
@@ -7815,6 +8055,8 @@ declare namespace LocalJSX {
         "nv-col": NvCol;
         "nv-datagrid": NvDatagrid;
         "nv-datagridcolumn": NvDatagridcolumn;
+        "nv-datetest": NvDatetest;
+        "nv-datetimetest": NvDatetimetest;
         "nv-dialog": NvDialog;
         "nv-dialogfooter": NvDialogfooter;
         "nv-dialogheader": NvDialogheader;
@@ -7861,6 +8103,7 @@ declare namespace LocalJSX {
         "nv-stack": NvStack;
         "nv-table": NvTable;
         "nv-tableheader": NvTableheader;
+        "nv-timetest": NvTimetest;
         "nv-toggle": NvToggle;
         "nv-togglebutton": NvTogglebutton;
         "nv-togglebuttongroup": NvTogglebuttongroup;
@@ -7891,6 +8134,18 @@ declare module "@stencil/core" {
              */
             "nv-datagrid": LocalJSX.NvDatagrid & JSXBase.HTMLAttributes<HTMLNvDatagridElement>;
             "nv-datagridcolumn": LocalJSX.NvDatagridcolumn & JSXBase.HTMLAttributes<HTMLNvDatagridcolumnElement>;
+            /**
+             * This is a test component for the new DateOnly type
+             * @deprecated [EXPERIMENTAL]
+             * @experimental This component is still in development and subject to change in future releases.
+             */
+            "nv-datetest": LocalJSX.NvDatetest & JSXBase.HTMLAttributes<HTMLNvDatetestElement>;
+            /**
+             * This is a test component for the new DateTimeObject type
+             * @deprecated [EXPERIMENTAL]
+             * @experimental This component is still in development and subject to change in future releases.
+             */
+            "nv-datetimetest": LocalJSX.NvDatetimetest & JSXBase.HTMLAttributes<HTMLNvDatetimetestElement>;
             "nv-dialog": LocalJSX.NvDialog & JSXBase.HTMLAttributes<HTMLNvDialogElement>;
             "nv-dialogfooter": LocalJSX.NvDialogfooter & JSXBase.HTMLAttributes<HTMLNvDialogfooterElement>;
             "nv-dialogheader": LocalJSX.NvDialogheader & JSXBase.HTMLAttributes<HTMLNvDialogheaderElement>;
@@ -7931,10 +8186,6 @@ declare module "@stencil/core" {
              * Inherits intention and emphasis from parent nv-sidebar if not explicitly set.
              */
             "nv-notification-bullet": LocalJSX.NvNotificationBullet & JSXBase.HTMLAttributes<HTMLNvNotificationBulletElement>;
-            /**
-             * @deprecated [EXPERIMENTAL]
-             * @experimental - Container for notifications TODO: add animations etc...
-             */
             "nv-notificationcontainer": LocalJSX.NvNotificationcontainer & JSXBase.HTMLAttributes<HTMLNvNotificationcontainerElement>;
             /**
              * A pagination navigation component that displays page numbers with Previous/Next controls.
@@ -7993,6 +8244,12 @@ declare module "@stencil/core" {
             "nv-stack": LocalJSX.NvStack & JSXBase.HTMLAttributes<HTMLNvStackElement>;
             "nv-table": LocalJSX.NvTable & JSXBase.HTMLAttributes<HTMLNvTableElement>;
             "nv-tableheader": LocalJSX.NvTableheader & JSXBase.HTMLAttributes<HTMLNvTableheaderElement>;
+            /**
+             * This is a test component for the new TimeOnly type
+             * @deprecated [EXPERIMENTAL]
+             * @experimental This component is still in development and subject to change in future releases.
+             */
+            "nv-timetest": LocalJSX.NvTimetest & JSXBase.HTMLAttributes<HTMLNvTimetestElement>;
             "nv-toggle": LocalJSX.NvToggle & JSXBase.HTMLAttributes<HTMLNvToggleElement>;
             "nv-togglebutton": LocalJSX.NvTogglebutton & JSXBase.HTMLAttributes<HTMLNvTogglebuttonElement>;
             "nv-togglebuttongroup": LocalJSX.NvTogglebuttongroup & JSXBase.HTMLAttributes<HTMLNvTogglebuttongroupElement>;

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 {};

package/dist/vscode-data.json

@@ -641,6 +641,27 @@
         }
       ]
     },
+    {
+      "name": "nv-datetest",
+      "description": {
+        "kind": "markdown",
+        "value": "This is a test component for the new DateOnly type"
+      },
+      "attributes": [
+        {
+          "name": "last-change",
+          "description": "The last change."
+        }
+      ]
+    },
+    {
+      "name": "nv-datetimetest",
+      "description": {
+        "kind": "markdown",
+        "value": "This is a test component for the new DateTimeObject type"
+      },
+      "attributes": []
+    },
     {
       "name": "nv-dialog",
       "description": {
@@ -3684,6 +3705,9 @@
             {
               "name": "calendar-time"
             },
+            {
+              "name": "calendar-week"
+            },
             {
               "name": "camera"
             },
@@ -3789,6 +3813,9 @@
             {
               "name": "circle-check"
             },
+            {
+              "name": "circle-minus"
+            },
             {
               "name": "circle-x"
             },
@@ -4293,6 +4320,12 @@
             {
               "name": "keyboard-show"
             },
+            {
+              "name": "layers-intersect"
+            },
+            {
+              "name": "layers-off"
+            },
             {
               "name": "layout"
             },
@@ -5758,6 +5791,9 @@
             {
               "name": "calendar-time"
             },
+            {
+              "name": "calendar-week"
+            },
             {
               "name": "camera"
             },
@@ -5863,6 +5899,9 @@
             {
               "name": "circle-check"
             },
+            {
+              "name": "circle-minus"
+            },
             {
               "name": "circle-x"
             },
@@ -6367,6 +6406,12 @@
             {
               "name": "keyboard-show"
             },
+            {
+              "name": "layers-intersect"
+            },
+            {
+              "name": "layers-off"
+            },
             {
               "name": "layout"
             },
@@ -7154,6 +7199,19 @@
         }
       ]
     },
+    {
+      "name": "nv-timetest",
+      "description": {
+        "kind": "markdown",
+        "value": "This is a test component for the new TimeOnly type"
+      },
+      "attributes": [
+        {
+          "name": "last-change",
+          "description": "The last change."
+        }
+      ]
+    },
     {
       "name": "nv-toggle",
       "description": {