@sbb-esta/lyne-elements 0.0.0 → 0.52.0

package/core/base-elements.js

@@ -0,0 +1,234 @@
+import { LitElement as w, html as v, isServer as g, nothing as o } from "lit";
+import { hostAttributes as f } from "./decorators.js";
+import { getDocumentWritingMode as O, getLocalName as _ } from "./dom.js";
+import { property as l } from "lit/decorators.js";
+import { isEventPrevented as C, EventEmitter as b } from "./eventing.js";
+import { SbbLanguageController as E } from "./controllers.js";
+import { i18nTargetOpensInNewWindow as $ } from "./i18n.js";
+import "../screen-reader-only.js";
+var D = Object.defineProperty, k = Object.getOwnPropertyDescriptor, A = (e, t, r, i) => {
+  for (var s = i > 1 ? void 0 : i ? k(t, r) : t, a = e.length - 1, n; a >= 0; a--)
+    (n = e[a]) && (s = (i ? n(t, r, s) : n(s)) || s);
+  return i && s && D(t, r, s), s;
+};
+let m = class extends w {
+  get maybeDisabled() {
+    const e = this;
+    return e.disabled || e.formDisabled;
+  }
+  setupBaseEventHandlers() {
+    this.addEventListener(
+      "click",
+      (e) => {
+        this.maybeDisabled && (e.preventDefault(), e.stopImmediatePropagation());
+      },
+      // capture is necessary here, as this event handler needs to be executed before any other
+      // in order to stop immediate propagation in the disabled case.
+      { capture: !0 }
+    );
+  }
+  /** Override this method to render the component template. */
+  renderTemplate() {
+    throw new Error("Implementation needed!");
+  }
+  /** Default render method for button-like components. */
+  render() {
+    return v`
+      <span class="sbb-action-base ${this.localName ?? _(this)}">
+        ${this.renderTemplate()}
+      </span>
+    `;
+  }
+};
+m = A([
+  f({
+    dir: O(),
+    "data-action": ""
+  })
+], m);
+var P = Object.defineProperty, S = Object.getOwnPropertyDescriptor, u = (e, t, r, i) => {
+  for (var s = i > 1 ? void 0 : i ? S(t, r) : t, a = e.length - 1, n; a >= 0; a--)
+    (n = e[a]) && (s = (i ? n(t, r, s) : n(s)) || s);
+  return i && s && P(t, r, s), s;
+};
+let h = class extends m {
+  constructor() {
+    if (super(), this.type = "button", this._handleButtonClick = async (e) => {
+      if (this.type === "button" || await C(e))
+        return;
+      const t = this.form ? this.ownerDocument.querySelector(`form#${this.form}`) : this.closest("form");
+      if (t)
+        this.type === "submit" ? t.requestSubmit() : this.type === "reset" && t.reset();
+      else
+        return;
+    }, this._preventScrollOnSpaceKeydown = (e) => {
+      e.key === " " && (e.preventDefault(), e.target.toggleAttribute("data-active", !0));
+    }, this._removeActiveMarker = (e) => {
+      e.target.removeAttribute("data-active");
+    }, this._dispatchClickEventOnSpaceKeyup = (e) => {
+      e.key === " " && (this._removeActiveMarker(e), this._dispatchClickEvent(e));
+    }, this._dispatchClickEvent = (e) => {
+      const { altKey: t, ctrlKey: r, metaKey: i, shiftKey: s } = e;
+      e.target.dispatchEvent(
+        new PointerEvent("click", {
+          bubbles: !0,
+          cancelable: !0,
+          composed: !0,
+          pointerId: -1,
+          pointerType: "",
+          altKey: t,
+          ctrlKey: r,
+          metaKey: i,
+          shiftKey: s
+        })
+      );
+    }, !g) {
+      this.setupBaseEventHandlers();
+      const e = { passive: !0 };
+      this.addEventListener("click", this._handleButtonClick), this.addEventListener("keydown", this._preventScrollOnSpaceKeydown), this.addEventListener("keyup", this._dispatchClickEventOnSpaceKeyup, e), this.addEventListener("blur", this._removeActiveMarker, e), this.addEventListener(
+        "keypress",
+        (t) => {
+          (t.key === "Enter" || t.key === `
+`) && this._dispatchClickEvent(t);
+        },
+        e
+      );
+    }
+  }
+  set name(e) {
+    this.setAttribute("name", `${e}`);
+  }
+  get name() {
+    return this.getAttribute("name") ?? "";
+  }
+  set value(e) {
+    this.setAttribute("value", `${e}`);
+  }
+  get value() {
+    return this.getAttribute("value") ?? "";
+  }
+  attributeChangedCallback(e, t, r) {
+    (!["name", "value"].includes(e) || t !== r) && super.attributeChangedCallback(e, t, r);
+  }
+};
+u([
+  l()
+], h.prototype, "type", 2);
+u([
+  l()
+], h.prototype, "name", 1);
+u([
+  l()
+], h.prototype, "value", 1);
+u([
+  l()
+], h.prototype, "form", 2);
+h = u([
+  f({
+    role: "button",
+    tabindex: "0",
+    "data-button": ""
+  })
+], h);
+var L = Object.defineProperty, x = Object.getOwnPropertyDescriptor, d = (e, t, r, i) => {
+  for (var s = i > 1 ? void 0 : i ? x(t, r) : t, a = e.length - 1, n; a >= 0; a--)
+    (n = e[a]) && (s = (i ? n(t, r, s) : n(s)) || s);
+  return i && s && L(t, r, s), s;
+};
+let c = class extends m {
+  constructor() {
+    super(), this.language = new E(this), this._evaluateRelAttribute = () => this.rel ? this.rel : this.target === "_blank" ? "external noopener nofollow" : o, g || this.setupBaseEventHandlers();
+  }
+  /** @internal */
+  focus(e) {
+    var t;
+    (t = this.shadowRoot.querySelector("a")) == null || t.focus(e);
+  }
+  /** @internal */
+  blur() {
+    var e;
+    (e = this.shadowRoot.querySelector("a")) == null || e.blur();
+  }
+  /** @internal */
+  click() {
+    var e;
+    (e = this.shadowRoot.querySelector("a")) == null || e.click();
+  }
+  /** Default render method for link-like components. Can be overridden if the LinkRenderVariables are not needed. */
+  render() {
+    return v`
+      <a
+        class="sbb-action-base ${this.localName ?? _(this)}"
+        href=${this.href || o}
+        ?download=${this.download}
+        target=${this.target || o}
+        rel=${this._evaluateRelAttribute()}
+        aria-label=${this.accessibilityLabel || o}
+        tabindex=${this.maybeDisabled ? "-1" : o}
+        aria-disabled=${this.maybeDisabled ? "true" : o}
+      >
+        ${this.renderTemplate()}
+        ${this.href && this.target === "_blank" ? v`<sbb-screen-reader-only
+              >. ${$[this.language.current]}</sbb-screen-reader-only
+            >` : o}
+      </a>
+    `;
+  }
+};
+d([
+  l()
+], c.prototype, "href", 2);
+d([
+  l()
+], c.prototype, "target", 2);
+d([
+  l()
+], c.prototype, "rel", 2);
+d([
+  l({ type: Boolean })
+], c.prototype, "download", 2);
+d([
+  l({ attribute: "accessibility-label" })
+], c.prototype, "accessibilityLabel", 2);
+c = d([
+  f({
+    "data-link": ""
+  })
+], c);
+const p = class p extends w {
+  constructor() {
+    super(...arguments), this.willOpen = new b(
+      this,
+      p.events.willOpen
+    ), this.didOpen = new b(this, p.events.didOpen), this.willClose = new b(
+      this,
+      p.events.willClose
+    ), this.didClose = new b(
+      this,
+      p.events.didClose
+    );
+  }
+  /** The state of the component. */
+  set state(t) {
+    this.setAttribute("data-state", t);
+  }
+  get state() {
+    return this.getAttribute("data-state");
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.state || (this.state = "closed");
+  }
+};
+p.events = {
+  willOpen: "willOpen",
+  didOpen: "didOpen",
+  willClose: "willClose",
+  didClose: "didClose"
+};
+let y = p;
+export {
+  m as SbbActionBaseElement,
+  h as SbbButtonBaseElement,
+  c as SbbLinkBaseElement,
+  y as SbbOpenCloseBaseElement
+};

package/core/config/config.d.ts

@@ -0,0 +1,22 @@
+import { DateAdapter } from '../datetime.js';
+
+export interface SbbIconConfig {
+    interceptor?: (parameters: {
+        namespace: string;
+        name: string;
+        url: string;
+        request: () => Promise<string>;
+    }) => Promise<string>;
+    namespaces?: Map<string, string>;
+}
+export interface SbbDatetimeConfig {
+    dateAdapter?: DateAdapter;
+}
+export interface SbbConfig {
+    language?: string;
+    icon?: SbbIconConfig;
+    datetime?: SbbDatetimeConfig;
+}
+export declare function readConfig(): SbbConfig;
+export declare function mergeConfig(config: Partial<SbbConfig>): void;
+//# sourceMappingURL=config.d.ts.map

package/core/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/elements/core/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KAChC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,wBAAgB,UAAU,IAAI,SAAS,CAKtC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAG5D"}

package/core/config.d.ts

@@ -0,0 +1,2 @@
+export * from './config/config.js';
+//# sourceMappingURL=config.d.ts.map

package/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/elements/core/config.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/core/config.js

@@ -0,0 +1,11 @@
+function o() {
+  return "sbbConfig" in globalThis || (globalThis.sbbConfig = {}), globalThis.sbbConfig;
+}
+function g(i) {
+  const n = o();
+  Object.assign(n, i);
+}
+export {
+  g as mergeConfig,
+  o as readConfig
+};

package/core/controllers/connected-abort-controller.d.ts

@@ -0,0 +1,11 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+
+export declare class SbbConnectedAbortController implements ReactiveController {
+    private _host;
+    private _abortController?;
+    get signal(): AbortSignal | undefined;
+    constructor(_host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+}
+//# sourceMappingURL=connected-abort-controller.d.ts.map

package/core/controllers/connected-abort-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-abort-controller.d.ts","sourceRoot":"","sources":["../../../../src/elements/core/controllers/connected-abort-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAEtE,qBAAa,2BAA4B,YAAW,kBAAkB;IAOjD,OAAO,CAAC,KAAK;IANhC,OAAO,CAAC,gBAAgB,CAAC,CAA0C;IAEnE,IAAW,MAAM,IAAI,WAAW,GAAG,SAAS,CAE3C;gBAE0B,KAAK,EAAE,sBAAsB;IAIjD,aAAa,IAAI,IAAI;IAMrB,gBAAgB,IAAI,IAAI;CAIhC"}

package/core/controllers/language-controller.d.ts

@@ -0,0 +1,33 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+
+/**
+ * The LanguageController is a reactive controller that observes the "lang" attribute
+ * of the <html> tag.
+ * On change of the "lang" attribute, it will request an update of connected
+ * components.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang
+ */
+export declare class SbbLanguageController implements ReactiveController {
+    private _host;
+    private static readonly _defaultLanguage;
+    private static readonly _supportedLocales;
+    /** A set of connected components that should be notified on language change. */
+    private static readonly _listeners;
+    /** MutationObserver that observes the "lang" attribute of the <html> element. */
+    private static readonly _observer;
+    private static readonly _observerConfig;
+    /** Get the current language. */
+    static get current(): string;
+    /** Get the current language. */
+    get current(): string;
+    private _previousLanguage?;
+    private _handlers;
+    constructor(_host: ReactiveControllerHost);
+    /** Add a language change handler. */
+    withHandler(handler: () => void): this;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _callHandlers;
+}
+//# sourceMappingURL=language-controller.d.ts.map

package/core/controllers/language-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-controller.d.ts","sourceRoot":"","sources":["../../../../src/elements/core/controllers/language-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAKrF;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IA0C3C,OAAO,CAAC,KAAK;IAzChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAErE,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAEtE,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAI9B;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAGrC;IAEF,gCAAgC;IAChC,WAAkB,OAAO,IAAI,MAAM,CAalC;IAED,gCAAgC;IAChC,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,SAAS,CAAsB;gBAEZ,KAAK,EAAE,sBAAsB;IAIxD,qCAAqC;IAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAOtC,aAAa,IAAI,IAAI;IAcrB,gBAAgB,IAAI,IAAI;IAQ/B,OAAO,CAAC,aAAa;CAMtB"}

package/core/controllers/slot-state-controller.d.ts

@@ -0,0 +1,32 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+
+/**
+ * This controller checks for slotted children. From these it generates
+ * a list of used slot names (`unnamed` for children without a slot attribute)
+ * and adds this to the `data-slot-names` attribute, as a space separated list.
+ *
+ * This allows CSS attribute selector to display/hide/configure a section
+ * of the component as required (see [attr~=value] selector specifically).
+ *
+ * @example
+ * .example {
+ *   display: none;
+ *
+ *   :host([data-slot-names~="icon"]) & {
+ *     display: inline;
+ *   }
+ * }
+ *
+ * https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors
+ */
+export declare class SbbSlotStateController implements ReactiveController {
+    private _host;
+    private _onChangeCallback;
+    readonly slots: Set<string>;
+    private _slotchangeHandler;
+    constructor(_host: ReactiveControllerHost & HTMLElement, _onChangeCallback?: (() => void) | null);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _syncSlots;
+}
+//# sourceMappingURL=slot-state-controller.d.ts.map

package/core/controllers/slot-state-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-state-controller.d.ts","sourceRoot":"","sources":["../../../../src/elements/core/controllers/slot-state-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAU7D,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,iBAAiB;IAV3B,SAAgB,KAAK,cAAqB;IAI1C,OAAO,CAAC,kBAAkB,CAExB;gBAGQ,KAAK,EAAE,sBAAsB,GAAG,WAAW,EAC3C,iBAAiB,GAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAW;IAKhD,aAAa,IAAI,IAAI;IAMrB,gBAAgB,IAAI,IAAI;IAI/B,OAAO,CAAC,UAAU;CAuBnB"}

package/core/controllers.d.ts

@@ -0,0 +1,4 @@
+export * from './controllers/connected-abort-controller.js';
+export * from './controllers/language-controller.js';
+export * from './controllers/slot-state-controller.js';
+//# sourceMappingURL=controllers.d.ts.map

package/core/controllers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllers.d.ts","sourceRoot":"","sources":["../../../src/elements/core/controllers.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC"}

package/core/controllers.js

@@ -0,0 +1,88 @@
+import { isServer as d } from "lit";
+import { readConfig as u } from "./config.js";
+import { AgnosticMutationObserver as _ } from "./observers.js";
+class b {
+  constructor(t) {
+    this._host = t, this._abortController = new AbortController(), this._host.addController(this);
+  }
+  get signal() {
+    var t;
+    return (t = this._abortController) == null ? void 0 : t.signal;
+  }
+  hostConnected() {
+    this._abortController || (this._abortController = new AbortController());
+  }
+  hostDisconnected() {
+    var t;
+    (t = this._abortController) == null || t.abort(), this._abortController = void 0;
+  }
+}
+const e = class e {
+  constructor(t) {
+    this._host = t, this._handlers = [], this._host.addController(this);
+  }
+  /** Get the current language. */
+  static get current() {
+    const s = ((u().language ?? (d ? e._defaultLanguage : document.documentElement.getAttribute("lang"))) || e._defaultLanguage).split("-")[0];
+    return e._supportedLocales.includes(s) ? s : e._defaultLanguage;
+  }
+  /** Get the current language. */
+  get current() {
+    return e.current;
+  }
+  /** Add a language change handler. */
+  withHandler(t) {
+    return this._handlers.unshift(t), this;
+  }
+  hostConnected() {
+    e._listeners.size || e._observer.observe(
+      document.documentElement,
+      e._observerConfig
+    ), e._listeners.add(this), this._previousLanguage !== this.current && this._callHandlers(this._previousLanguage !== void 0);
+  }
+  hostDisconnected() {
+    this._previousLanguage = this.current, e._listeners.delete(this), e._listeners.size || e._observer.disconnect();
+  }
+  _callHandlers(t = !0) {
+    this._handlers.forEach((s) => s()), t && this._host.requestUpdate();
+  }
+};
+e._defaultLanguage = "en", e._supportedLocales = ["en", "de", "fr", "it"], e._listeners = /* @__PURE__ */ new Set(), e._observer = new _((t) => {
+  t[0].oldValue !== document.documentElement.getAttribute("lang") && e._listeners.forEach((s) => s._callHandlers());
+}), e._observerConfig = {
+  attributeFilter: ["lang"],
+  attributeOldValue: !0
+};
+let h = e;
+class C {
+  constructor(t, s = null) {
+    this._host = t, this._onChangeCallback = s, this.slots = /* @__PURE__ */ new Set(), this._slotchangeHandler = (o) => {
+      this._syncSlots(o.target);
+    }, this._host.addController(this);
+  }
+  hostConnected() {
+    var t;
+    this._syncSlots(...this._host.querySelectorAll("slot")), (t = this._host.shadowRoot) == null || t.addEventListener("slotchange", this._slotchangeHandler);
+  }
+  hostDisconnected() {
+    var t;
+    (t = this._host.shadowRoot) == null || t.removeEventListener("slotchange", this._slotchangeHandler);
+  }
+  _syncSlots(...t) {
+    var n;
+    for (const r of t) {
+      const i = r.name || "unnamed";
+      r.assignedNodes().some((l) => {
+        var a;
+        return "tagName" in l || ((a = l.textContent) == null ? void 0 : a.trim());
+      }) ? this.slots.add(i) : this.slots.delete(i);
+    }
+    const s = this._host.getAttribute("data-slot-names"), o = [...this.slots].sort().join(" ");
+    o ? this._host.getAttribute("data-slot-names") !== o && this._host.setAttribute("data-slot-names", o) : this._host.removeAttribute("data-slot-names"), o !== s && ((n = this._onChangeCallback) == null || n.call(this));
+  }
+}
+export {
+  b as SbbConnectedAbortController,
+  h as SbbLanguageController,
+  C as SbbSlotStateController
+};

package/core/datetime/date-adapter.d.ts

@@ -0,0 +1,162 @@
+export declare const DAYS_PER_ROW: number;
+export declare const MONTHS_PER_ROW: number;
+export declare const YEARS_PER_ROW: number;
+export declare const YEARS_PER_PAGE: number;
+export declare const FORMAT_DATE: RegExp;
+/**
+ * Abstract date functionality.
+ *
+ * Adapted from https://github.com/angular/components/blob/main/src/material/core/datetime/date-adapter.ts
+ */
+export declare abstract class DateAdapter<T = any> {
+    /**
+     * Get the year as a number.
+     * @param date
+     */
+    abstract getYear(date: T): number;
+    /**
+     * Get the month as a number.
+     * Attention: This returns 1-12 and mitigates the default JavaScript Date behavior.
+     * @param date
+     */
+    abstract getMonth(date: T): number;
+    /**
+     * Get the day of the month as a number.
+     * @param date
+     */
+    abstract getDate(date: T): number;
+    /**
+     * Get the Day of the week as a number.
+     * @param date
+     */
+    abstract getDayOfWeek(date: T): number;
+    abstract getFirstDayOfWeek(): number;
+    /**
+     * Get the number of days in a month.
+     * @param year
+     * @param month
+     * */
+    abstract getNumDaysInMonth(date: T): number;
+    /**
+     * Get a list of all the months in a given style.
+     * @param style
+     */
+    abstract getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    /** Get a string array with length = 31, filled with the days in a month, starting from 1. */
+    abstract getDateNames(): string[];
+    /**
+     * Get a list of all the week days in a given style.
+     * @param style
+     */
+    abstract getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    /** Creates today's date. */
+    abstract today(): T;
+    /**
+     * Checks whether a given `date` is valid.
+     * @param date
+     * */
+    abstract isValid(date: T | null | undefined): boolean;
+    /** Creates a new date by cloning the given one.
+     * @param date
+     * */
+    abstract clone(date: T): T;
+    /**
+     * Creates a new date, given day, month and year; without date's overflow.
+     * @param year
+     * @param month The month of the date (1-indexed, 1 = January). Must be an integer 1 - 12.
+     * @param date
+     * */
+    abstract createDate(year: number, month: number, date: number): T;
+    /**
+     * Attempts to deserialize a value to a valid date object. This is different from parsing in that
+     * deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
+     * string). The default implementation does not allow any deserialization, it simply checks that
+     * the given value is already a valid date object or null.
+     * @param value Either Date, ISOString, Unix Timestamp (number of seconds since Jan 1, 1970).
+     * @returns The date if the input is valid, `null` otherwise.
+     * */
+    deserialize(value: T | string | number | null | undefined): T | null;
+    /**
+     * Creates a new date adding the number of provided `years` to the provided `date`.
+     * @param date The starting date.
+     * @param years The number of years to add.
+     */
+    abstract addCalendarYears(date: T, years: number): T;
+    /**
+     * Creates a new date adding the number of provided `months` to the provided `date`.
+     * If the calculated month has fewer days than the original one, the date is set to the last day of the month.
+     * E.g. with `date` = new Date(2022, 0, 31) and `months` = 1, it returns new Date(2022, 1, 28).
+     * @param date The starting date.
+     * @param months The number of months to add.
+     */
+    abstract addCalendarMonths(date: T, months: number): T;
+    /** Creates a new date by adding the number of provided `days` to the provided `date`.
+     * @param date The starting date.
+     * @param days The number of days to add.
+     */
+    abstract addCalendarDays(date: T, days: number): T;
+    /** Get the date in the local format.
+     * @param date The date to format
+     * @returns The `date` in the local format as string.
+     */
+    abstract getAccessibilityFormatDate(date: T | string): string;
+    /** Get the given string as Date.
+     * @param value The date in the format DD.MM.YYYY.
+     * @param now The current date as Date.
+     */
+    abstract parse(value: string | null | undefined, now: T): T | undefined;
+    /** Format the given Date as string.
+     * @param date The date to format.
+     */
+    abstract format(date: T | null | undefined): string;
+    /** Checks whether the given `obj` is a Date.
+     * @param obj The object to check.
+     */
+    abstract isDateInstance(obj: any): boolean;
+    /**
+     * Gets date instance that is not valid.
+     * @returns An invalid date.
+     */
+    abstract invalid(): T;
+    /** Get the given date as ISO String.
+     * @param date The date to convert to ISO String.
+     */
+    toIso8601(date: T): string;
+    /**
+     * Given a potential date object, returns that same date object if it is
+     * a valid date, or `null` if it's not a valid date.
+     * @param value The object to check.
+     * @returns A date or `null`.
+     */
+    getValidDateOrNull(value: unknown): T | null;
+    /**
+     * Calculates the day of the week of the first day of the month, and then its offset from the first day of the week.
+     */
+    getFirstWeekOffset(date: T): number;
+    /**
+     * Compares two dates.
+     * @param first The first date to compare.
+     * @param second The second date to compare.
+     * @returns 0 if the dates are equal, a number less than 0 if the first date is earlier,
+     *     a number greater than 0 if the first date is later.
+     */
+    compareDate(first: T, second: T): number;
+    /**
+     * Checks if two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameDate(first: T | null, second: T | null): boolean;
+    /**
+     * Clamp the given date between min and max dates.
+     * @param date The date to clamp.
+     * @param min The minimum value to allow. If null or omitted no min is enforced.
+     * @param max The maximum value to allow. If null or omitted no max is enforced.
+     * @returns `min` if `date` is less than `min`, `max` if date is greater than `max`,
+     *     otherwise `date`.
+     */
+    clampDate(date: T, min?: T | null, max?: T | null): T;
+}
+//# sourceMappingURL=date-adapter.d.ts.map

package/core/datetime/date-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-adapter.d.ts","sourceRoot":"","sources":["../../../../src/elements/core/datetime/date-adapter.ts"],"names":[],"mappings":"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"}