@aquera/nile-elements 2.0.18 → 2.0.20

package/src/nile-calendar/timezones.ts

@@ -346,3 +346,60 @@ export const TIMEZONES = [
   'Pacific/Wallis',
   'Pacific/Apia',
   'Africa/Johannesburg'];
+
+/** Validates timezones with `Intl` to avoid alias mismatches like `Asia/Calcutta` vs `Asia/Kolkata`. */
+export function isValidTimezone(zone: string | null | undefined): boolean {
+  if (typeof zone !== 'string' || !zone.trim()) return false;
+  try {
+    new Intl.DateTimeFormat(undefined, { timeZone: zone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * `Date.UTC` with the year taken literally. `Date.UTC(y, ...)` (and `new Date(y, ...)`) remap years 0-99 to 1900-1999,
+ * so year 0001 silently becomes 1901. This anchors the same fields in UTC without that remap; for years >= 100
+ * it returns exactly what `Date.UTC` returns, overflowing month/day/time fields included.
+ */
+export function utcFromFields(
+  year: number, month0: number, day = 1,
+  hours = 0, minutes = 0, seconds = 0, ms = 0
+): number {
+  const d = new Date(0);
+  d.setUTCFullYear(year, month0, day);
+  d.setUTCHours(hours, minutes, seconds, ms);
+  return d.getTime();
+}
+
+/**
+ * Whether a clock face reads as a real time of day. Hours 0-23, minutes and seconds 0-59; `24:00:00(.000)` is ISO 8601
+ * end-of-day and is kept (it resolves to the next midnight). Anything else, e.g. 25:61:00, is not a time: date math would
+ * silently roll it into the next day, so callers treat the value as unparseable instead.
+ */
+export function isClockTime(hours: number, minutes: number, seconds = 0, ms = 0): boolean {
+  if (![hours, minutes, seconds, ms].every(Number.isFinite)) return false;
+  if (minutes < 0 || minutes > 59 || seconds < 0 || seconds > 59 || ms < 0 || ms > 999 || hours < 0) return false;
+  return hours <= 23 || (hours === 24 && minutes === 0 && seconds === 0 && ms === 0);
+}
+
+/** Host-local counterpart of {@link utcFromFields}: `new Date(y, m, d, …)` remaps years 0-99 to 1900-1999, this does not. */
+export function localDateFromFields(
+  year: number, month0: number, day = 1,
+  hours = 0, minutes = 0, seconds = 0, ms = 0
+): Date {
+  const d = new Date(2000, 0, 1, 0, 0, 0, 0);
+  d.setFullYear(year, month0, day);
+  d.setHours(hours, minutes, seconds, ms);
+  return d;
+}
+
+/** Fallback year range when `startYear` / `endYear` are not set: the year dropdown, and in the date-time-picker variant also month navigation and typed-year clamping. An explicit bound always wins. */
+export const DEFAULT_START_YEAR = 2000;
+export const DEFAULT_END_YEAR = 2050;
+
+/** Four-digit year for `YYYY` tokens: years 0-99 are zero-padded (`0050`); every other year renders exactly as `String(year)`. */
+export function formatYear4(year: number): string {
+  return year >= 0 && year < 100 ? String(year).padStart(4, '0') : String(year);
+}

package/src/nile-date-time-picker/index.ts

@@ -0,0 +1 @@
+export { NileDateTimePicker } from './nile-date-time-picker';

package/src/nile-date-time-picker/nile-date-time-picker.css.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright Aquera Inc 2026
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { css } from 'lit';
+
+export const styles = css`
+  :host {
+    -webkit-font-smoothing: var(--nile-webkit-font-smoothing, var(--ng-webkit-font-smoothing));
+    -moz-osx-font-smoothing: var(--nile-moz-osx-font-smoothing, var(--ng-moz-osx-font-smoothing));
+    text-rendering: var(--nile-text-rendering, var(--ng-text-rendering));
+    display: inline-block;
+    min-width: 296px;
+  }
+  nile-dropdown {
+    display: block;
+    width: 100%;
+  }
+`;
+
+export const globalPanelStyles = `
+  .nile-dtp-panel .tippy-box[data-theme~='floating-panel'],
+  .tippy-box[data-theme~='floating-panel'].nile-dtp-panel {
+    background: transparent;
+    border: none;
+    border-radius: 0;
+    box-shadow: none;
+  }
+
+  .nile-dtp-panel .nile-floating-panel__body {
+    min-width: 0;
+    gap: 0;
+    padding: 0;
+  }
+`;
+
+export function injectGlobalDateTimePickerStyles(): void {
+  if (typeof document === 'undefined') return;
+
+  const STYLE_ID = 'nile-date-time-picker-panel-styles';
+  if (document.getElementById(STYLE_ID)) return;
+
+  const style = document.createElement('style');
+  style.id = STYLE_ID;
+  style.textContent = globalPanelStyles;
+  document.head?.appendChild(style);
+}
+
+injectGlobalDateTimePickerStyles();
+
+export default [styles];