igniteui-webcomponents 7.2.4 → 7.3.0-beta.1

package/components/button-group/toggle-button.js.map

@@ -1 +1 @@
-{"version":3,"file":"toggle-button.js","sourceRoot":"","sources":["../../../src/components/button-group/toggle-button.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,6CAA6C,CAAC;AAahE,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,UAAU;;aACvC,WAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,AAAnB,CAAoB;aAC1B,YAAO,GAAG,mBAAmB,AAAtB,CAAuB;IAG9C,MAAM,CAAC,QAAQ;QACpB,iBAAiB,CAAC,0BAAwB,CAAC,CAAC;IAC9C,CAAC;IA4BD;QACE,KAAK,EAAE,CAAC;QA3BO,sBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAiBzD,aAAQ,GAAG,KAAK,CAAC;QAOjB,aAAQ,GAAG,KAAK,CAAC;QAItB,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAIe,KAAK,CAAC,OAAsB;QAC1C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAIe,IAAI;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAGe,KAAK;QACnB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAEkB,MAAM;QACvB,OAAO,IAAI,CAAA;;eAEA,OAAO,CAAC;YACb,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO;SACxC,CAAC;;oBAEU,IAAI,CAAC,QAAQ;qBACZ,IAAI,CAAC,SAAS;uBACZ,IAAI,CAAC,QAAQ;wBACZ,IAAI,CAAC,QAAQ;;;;KAIhC,CAAC;IACJ,CAAC;;AA7DgB;IADhB,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC;+DACoB;AAO5C;IADN,QAAQ,EAAE;uDACW;AAOf;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;0DACnB;AAOjB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;0DACnB;AAjCL,wBAAwB;IAD5C,aAAa,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;GACnB,wBAAwB,CA0E5C;eA1EoB,wBAAwB","sourcesContent":["import { html, LitElement } from 'lit';\nimport { property, query } from 'lit/decorators.js';\n\nimport { addThemingController } from '../../theming/theming-controller.js';\nimport { addKeyboardFocusRing } from '../common/controllers/focus-ring.js';\nimport { shadowOptions } from '../common/decorators/shadow-options.js';\nimport { registerComponent } from '../common/definitions/register.js';\nimport { partMap } from '../common/part-map.js';\nimport { styles } from './themes/button.base.css.js';\nimport { all } from './themes/button.js';\nimport { styles as shared } from './themes/shared/button/button.common.css.js';\n\n/**\n * The `igc-toggle-button` wraps a native button element and exposes additional `value` and `selected` properties.\n * It is used in the context of an `igc-button-group` to facilitate the creation of group/toolbar like UX behaviors.\n *\n * @element igc-toggle-button\n *\n * @slot Renders the label/content of the button.\n *\n * @csspart toggle - The native button element.\n */\n@shadowOptions({ delegatesFocus: true })\nexport default class IgcToggleButtonComponent extends LitElement {\n  public static override styles = [styles, shared];\n  public static readonly tagName = 'igc-toggle-button';\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcToggleButtonComponent);\n  }\n\n  private readonly _focusRingManager = addKeyboardFocusRing(this);\n\n  @query('[part=\"toggle\"]', true)\n  private readonly _nativeButton!: HTMLButtonElement;\n\n  /**\n   * The value attribute of the control.\n   * @attr\n   */\n  @property()\n  public value!: string;\n\n  /**\n   * Determines whether the button is selected.\n   * @attr\n   */\n  @property({ type: Boolean, reflect: true })\n  public selected = false;\n\n  /**\n   * Determines whether the button is disabled.\n   * @attr\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  constructor() {\n    super();\n    addThemingController(this, all);\n  }\n\n  /* alternateName: focusComponent */\n  /** Sets focus on the button. */\n  public override focus(options?: FocusOptions): void {\n    this._nativeButton.focus(options);\n  }\n\n  /* alternateName: blurComponent */\n  /** Removes focus from the button. */\n  public override blur(): void {\n    this._nativeButton.blur();\n  }\n\n  /** Simulates a mouse click on the element. */\n  public override click(): void {\n    this._nativeButton.click();\n  }\n\n  protected override render() {\n    return html`\n      <button\n        part=${partMap({\n          toggle: true,\n          focused: this._focusRingManager.focused,\n        })}\n        type=\"button\"\n        ?disabled=${this.disabled}\n        .ariaLabel=${this.ariaLabel}\n        aria-pressed=${this.selected}\n        aria-disabled=${this.disabled}\n      >\n        <slot></slot>\n      </button>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-toggle-button': IgcToggleButtonComponent;\n  }\n}\n"]}
+{"version":3,"file":"toggle-button.js","sourceRoot":"","sources":["../../../src/components/button-group/toggle-button.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  html,\n  LitElement,\n  type PropertyValues,\n  type TemplateResult,\n} from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { buttonGroupContext } from '#internals/context.js';\nimport { createAsyncContext } from '#internals/controllers/async-consumer.js';\nimport { addKeyboardFocusRing } from '#internals/controllers/focus-ring.js';\nimport { shadowOptions } from '#internals/decorators/shadow-options.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport { partMap } from '#internals/part-map.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport { styles } from './themes/button.base.css.js';\nimport { all } from './themes/button.js';\nimport { styles as shared } from './themes/shared/button/button.common.css.js';\n\n/**\n * The toggle button wraps a native button element and exposes additional `value` and `selected` properties.\n * It is used in the context of a button group to facilitate the creation of group/toolbar like UX behaviors.\n *\n * @element igc-toggle-button\n *\n * @slot Renders the label/content of the button.\n *\n * @csspart toggle - The native button element.\n * @csspart focused - The native button element when focused through a keyboard interaction.\n */\n@shadowOptions({ delegatesFocus: true })\nexport default class IgcToggleButtonComponent extends LitElement {\n  public static override styles = [styles, shared];\n  public static readonly tagName = 'igc-toggle-button';\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcToggleButtonComponent);\n  }\n\n  private readonly _focusRingManager = addKeyboardFocusRing(this);\n  private readonly _context = createAsyncContext(this, buttonGroupContext);\n\n  @query('[part~=\"toggle\"]', true)\n  private readonly _nativeButton?: HTMLButtonElement;\n\n  /**\n   * The value of the control.\n   * @attr\n   */\n  @property()\n  public value!: string;\n\n  /**\n   * Whether the button is selected.\n   *\n   * @attr selected\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public selected = false;\n\n  /**\n   * Whether the button is disabled.\n   *\n   * @attr disabled\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  constructor() {\n    super();\n    addThemingController(this, all);\n  }\n\n  protected override updated(changedProperties: PropertyValues<this>): void {\n    if (changedProperties.has('selected') && this.selected) {\n      this._context.value?.syncSelection(this);\n    }\n  }\n\n  /* alternateName: focusComponent */\n  /** Sets focus on the button. */\n  public override focus(options?: FocusOptions): void {\n    this._nativeButton?.focus(options);\n  }\n\n  /* alternateName: blurComponent */\n  /** Removes focus from the button. */\n  public override blur(): void {\n    this._nativeButton?.blur();\n  }\n\n  /** Simulates a mouse click on the element. */\n  public override click(): void {\n    this._nativeButton?.click();\n  }\n\n  protected override render(): TemplateResult {\n    const group = this._context.value?.instance;\n\n    // A button of a group with a single selection mode is a radio button, and it\n    // is disabled either on its own or through the group it is part of.\n    const isRadio = group != null && group.selection !== 'multiple';\n    const disabled = this.disabled || Boolean(group?.disabled);\n    const selectedState = this.selected ? 'true' : 'false';\n\n    return html`\n      <button\n        part=${partMap({\n          toggle: true,\n          focused: this._focusRingManager.focused,\n        })}\n        type=\"button\"\n        role=${ifDefined(isRadio ? 'radio' : undefined)}\n        ?disabled=${disabled}\n        .ariaLabel=${this.ariaLabel}\n        aria-checked=${ifDefined(isRadio ? selectedState : undefined)}\n        aria-pressed=${ifDefined(isRadio ? undefined : selectedState)}\n        aria-disabled=${disabled}\n      >\n        <slot></slot>\n      </button>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-toggle-button': IgcToggleButtonComponent;\n  }\n}\n"]}

package/components/calendar/base.d.ts

@@ -1,17 +1,24 @@
 import { type ICalendarResourceStrings } from 'igniteui-i18n-core';
 import { LitElement, type PropertyValues } from 'lit';
-import type { IgcCalendarResourceStrings } from '../common/i18n/EN/calendar.resources.js';
-import { CalendarDay } from './model.js';
+import { CalendarDay } from '#internals/date/model.js';
+import type { IgcCalendarResourceStrings } from '#internals/i18n/EN/calendar.resources.js';
 import type { CalendarSelection, DateRangeDescriptor, WeekDays } from './types.js';
-export declare class IgcCalendarBaseComponent extends LitElement {
-    protected readonly _i18nController: import("../common/i18n/i18n-controller.js").I18nController<IgcCalendarResourceStrings | ICalendarResourceStrings>;
+declare const IgcCalendarBaseComponent_base: import("../../internals/mixins/constructor.js").AbstractConstructor<import("#internals/mixins/i18n.js").I18nInterface<IgcCalendarResourceStrings | ICalendarResourceStrings, IgcCalendarResourceStrings & ICalendarResourceStrings>> & typeof LitElement;
+export declare class IgcCalendarBaseComponent extends IgcCalendarBaseComponent_base {
     private _initialActiveDateSet;
     protected get _hasValues(): boolean;
+    /**
+     * The index of the first day of the week (Sunday = 0) as derived from {@link weekStart}.
+     *
+     * @remarks
+     * Derived on access instead of in `update()`, so that its consumers are not sensitive
+     * to the order in which the base class and its descendants update.
+     */
+    protected get _firstDayOfWeek(): number;
     protected get _isSingle(): boolean;
     protected get _isMultiple(): boolean;
     protected get _isRange(): boolean;
     protected _rangePreviewDate?: CalendarDay;
-    protected _firstDayOfWeek: number;
     protected _activeDate: CalendarDay;
     protected _value: CalendarDay | null;
     protected _values: CalendarDay[];
@@ -27,7 +34,7 @@ export declare class IgcCalendarBaseComponent extends LitElement {
     get value(): Date | null;
     /**
      * The current values of the calendar.
-     * Used when selection is set to multiple of range.
+     * Used when selection is set to multiple or range.
      *
      * @attr values
      */
@@ -55,24 +62,26 @@ export declare class IgcCalendarBaseComponent extends LitElement {
      */
     weekStart: WeekDays;
     /**
-     * Gets/Sets the locale used for formatting and displaying the dates in the component.
-     * @attr locale
+     * Gets/Sets the special dates for the component.
+     *
+     * @remarks
+     * Returns `undefined` when no dates are set, which the setter accepts as well so that
+     * a round trip through the property is valid.
      */
-    set locale(value: string);
-    get locale(): string;
+    set specialDates(value: DateRangeDescriptor[] | undefined);
+    get specialDates(): DateRangeDescriptor[] | undefined;
     /**
-     * The resource strings for localization.
+     * Gets/Sets the disabled dates for the component.
+     *
+     * @remarks
+     * Returns `undefined` when no dates are set, which the setter accepts as well so that
+     * a round trip through the property is valid.
      */
-    set resourceStrings(value: IgcCalendarResourceStrings | ICalendarResourceStrings);
-    get resourceStrings(): IgcCalendarResourceStrings & ICalendarResourceStrings;
-    /** Gets/Sets the special dates for the component. */
-    set specialDates(value: DateRangeDescriptor[]);
-    get specialDates(): DateRangeDescriptor[] | undefined;
-    /** Gets/Sets the disabled dates for the component. */
-    set disabledDates(value: DateRangeDescriptor[]);
+    set disabledDates(value: DateRangeDescriptor[] | undefined);
     get disabledDates(): DateRangeDescriptor[] | undefined;
     /** @internal */
-    protected update(props: PropertyValues<this>): void;
+    protected update(props: PropertyValues): void;
     /** @internal */
     protected firstUpdated(): void;
 }
+export {};

package/components/calendar/base.js

@@ -7,21 +7,21 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { CalendarResourceStringsEN, } from 'igniteui-i18n-core';
 import { LitElement } from 'lit';
 import { property, state } from 'lit/decorators.js';
-import { blazorDeepImport } from '../common/decorators/blazorDeepImport.js';
-import { blazorIndirectRender } from '../common/decorators/blazorIndirectRender.js';
-import { addI18nController } from '../common/i18n/i18n-controller.js';
-import { first } from '../common/util.js';
-import { convertToDate, convertToDates, getWeekDayNumber } from './helpers.js';
-import { CalendarDay } from './model.js';
-let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement {
+import { convertToDate, convertToDates } from '#internals/date/converters.js';
+import { CalendarDay, toCalendarDayOrNull } from '#internals/date/model.js';
+import { blazorDeepImport } from '#internals/decorators/blazorDeepImport.js';
+import { blazorIndirectRender } from '#internals/decorators/blazorIndirectRender.js';
+import { I18nMixin } from '#internals/mixins/i18n.js';
+import { firstOf } from '#internals/utils/arrays.js';
+import { getWeekDayNumber } from './helpers.js';
+const i18n = {
+    defaultEN: CalendarResourceStringsEN,
+    resourceMapName: 'calendar',
+};
+let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends I18nMixin(LitElement, i18n) {
     constructor() {
         super(...arguments);
-        this._i18nController = addI18nController(this, {
-            defaultEN: CalendarResourceStringsEN,
-            resourceMapName: 'calendar',
-        });
         this._initialActiveDateSet = false;
-        this._firstDayOfWeek = 0;
         this._activeDate = CalendarDay.today;
         this._value = null;
         this._values = [];
@@ -32,7 +32,10 @@ let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement
         this.weekStart = 'sunday';
     }
     get _hasValues() {
-        return this._values && this._values.length > 0;
+        return this._values.length > 0;
+    }
+    get _firstDayOfWeek() {
+        return getWeekDayNumber(this.weekStart);
     }
     get _isSingle() {
         return this.selection === 'single';
@@ -44,8 +47,7 @@ let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement
         return this.selection === 'range';
     }
     set value(value) {
-        const converted = convertToDate(value);
-        this._value = converted ? CalendarDay.from(converted) : null;
+        this._value = toCalendarDayOrNull(convertToDate(value));
     }
     get value() {
         return this._value ? this._value.native : null;
@@ -59,26 +61,12 @@ let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement
     }
     set activeDate(value) {
         this._initialActiveDateSet = true;
-        const converted = convertToDate(value);
-        this._activeDate = converted
-            ? CalendarDay.from(converted)
-            : CalendarDay.today;
+        this._activeDate =
+            toCalendarDayOrNull(convertToDate(value)) ?? CalendarDay.today;
     }
     get activeDate() {
         return this._activeDate.native;
     }
-    set locale(value) {
-        this._i18nController.locale = value;
-    }
-    get locale() {
-        return this._i18nController.locale;
-    }
-    set resourceStrings(value) {
-        this._i18nController.resourceStrings = value;
-    }
-    get resourceStrings() {
-        return this._i18nController.resourceStrings;
-    }
     set specialDates(value) {
         this._specialDates = value ?? [];
     }
@@ -92,9 +80,6 @@ let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement
         return this._disabledDates.length ? this._disabledDates : undefined;
     }
     update(props) {
-        if (props.has('weekStart')) {
-            this._firstDayOfWeek = getWeekDayNumber(this.weekStart);
-        }
         if (props.has('selection') && this.hasUpdated) {
             this._rangePreviewDate = undefined;
             this._value = null;
@@ -110,16 +95,13 @@ let IgcCalendarBaseComponent = class IgcCalendarBaseComponent extends LitElement
             this.activeDate = this.value ?? this.activeDate;
         }
         else {
-            this.activeDate = first(this.values) ?? this.activeDate;
+            this.activeDate = firstOf(this.values) ?? this.activeDate;
         }
     }
 };
 __decorate([
     state()
 ], IgcCalendarBaseComponent.prototype, "_rangePreviewDate", void 0);
-__decorate([
-    state()
-], IgcCalendarBaseComponent.prototype, "_firstDayOfWeek", void 0);
 __decorate([
     state()
 ], IgcCalendarBaseComponent.prototype, "_activeDate", void 0);
@@ -153,12 +135,6 @@ __decorate([
 __decorate([
     property({ attribute: 'week-start' })
 ], IgcCalendarBaseComponent.prototype, "weekStart", void 0);
-__decorate([
-    property()
-], IgcCalendarBaseComponent.prototype, "locale", null);
-__decorate([
-    property({ attribute: false })
-], IgcCalendarBaseComponent.prototype, "resourceStrings", null);
 __decorate([
     property({ attribute: false })
 ], IgcCalendarBaseComponent.prototype, "specialDates", null);

package/components/calendar/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/components/calendar/base.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CalendarResourceStringsEN,\n  type ICalendarResourceStrings,\n} from 'igniteui-i18n-core';\nimport { LitElement, type PropertyValues } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport { blazorDeepImport } from '../common/decorators/blazorDeepImport.js';\nimport { blazorIndirectRender } from '../common/decorators/blazorIndirectRender.js';\nimport type { IgcCalendarResourceStrings } from '../common/i18n/EN/calendar.resources.js';\nimport { addI18nController } from '../common/i18n/i18n-controller.js';\nimport { first } from '../common/util.js';\nimport { convertToDate, convertToDates, getWeekDayNumber } from './helpers.js';\nimport { CalendarDay } from './model.js';\nimport type {\n  CalendarSelection,\n  DateRangeDescriptor,\n  WeekDays,\n} from './types.js';\n\n@blazorIndirectRender\n@blazorDeepImport\nexport class IgcCalendarBaseComponent extends LitElement {\n  protected readonly _i18nController = addI18nController<\n    IgcCalendarResourceStrings | ICalendarResourceStrings\n  >(this, {\n    defaultEN: CalendarResourceStringsEN,\n    resourceMapName: 'calendar',\n  });\n\n  private _initialActiveDateSet = false;\n\n  protected get _hasValues(): boolean {\n    return this._values && this._values.length > 0;\n  }\n\n  protected get _isSingle(): boolean {\n    return this.selection === 'single';\n  }\n\n  protected get _isMultiple(): boolean {\n    return this.selection === 'multiple';\n  }\n\n  protected get _isRange(): boolean {\n    return this.selection === 'range';\n  }\n\n  @state()\n  protected _rangePreviewDate?: CalendarDay;\n\n  @state()\n  protected _firstDayOfWeek = 0;\n\n  @state()\n  protected _activeDate = CalendarDay.today;\n\n  @state()\n  protected _value: CalendarDay | null = null;\n\n  @state()\n  protected _values: CalendarDay[] = [];\n\n  @state()\n  protected _specialDates: DateRangeDescriptor[] = [];\n\n  @state()\n  protected _disabledDates: DateRangeDescriptor[] = [];\n\n  /* blazorSuppress */\n  /**\n   * The current value of the calendar.\n   * Used when selection is set to single\n   *\n   * @attr value\n   */\n  @property({ converter: convertToDate })\n  public set value(value: Date | string | null | undefined) {\n    const converted = convertToDate(value);\n    this._value = converted ? CalendarDay.from(converted) : null;\n  }\n\n  public get value(): Date | null {\n    return this._value ? this._value.native : null;\n  }\n\n  /* blazorSuppress */\n  /**\n   * The current values of the calendar.\n   * Used when selection is set to multiple of range.\n   *\n   * @attr values\n   */\n  @property({ converter: convertToDates })\n  public set values(values: (Date | string)[] | string | null | undefined) {\n    const converted = convertToDates(values);\n    this._values = converted ? converted.map((v) => CalendarDay.from(v)) : [];\n  }\n\n  public get values(): Date[] {\n    return this._values ? this._values.map((v) => v.native) : [];\n  }\n\n  /* blazorSuppress */\n  /** Get/Set the date which is shown in view and is highlighted. By default it is the current date. */\n  @property({ attribute: 'active-date', converter: convertToDate })\n  public set activeDate(value: Date | string | null | undefined) {\n    this._initialActiveDateSet = true;\n    const converted = convertToDate(value);\n    this._activeDate = converted\n      ? CalendarDay.from(converted)\n      : CalendarDay.today;\n  }\n\n  public get activeDate(): Date {\n    return this._activeDate.native;\n  }\n\n  /**\n   * Sets the type of selection in the component.\n   * @attr selection\n   * @default single\n   */\n  @property()\n  public selection: CalendarSelection = 'single';\n\n  /**\n   * Whether to show the week numbers.\n   * @attr show-week-numbers\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'show-week-numbers' })\n  public showWeekNumbers = false;\n\n  /**\n   * Gets/Sets the first day of the week.\n   * @attr week-start\n   * @default sunday\n   */\n  @property({ attribute: 'week-start' })\n  public weekStart: WeekDays = 'sunday';\n\n  /**\n   * Gets/Sets the locale used for formatting and displaying the dates in the component.\n   * @attr locale\n   */\n  @property()\n  public set locale(value: string) {\n    this._i18nController.locale = value;\n  }\n\n  public get locale() {\n    return this._i18nController.locale;\n  }\n\n  /**\n   * The resource strings for localization.\n   */\n  @property({ attribute: false })\n  public set resourceStrings(\n    value: IgcCalendarResourceStrings | ICalendarResourceStrings\n  ) {\n    this._i18nController.resourceStrings = value;\n  }\n\n  public get resourceStrings(): IgcCalendarResourceStrings &\n    ICalendarResourceStrings {\n    return this._i18nController.resourceStrings;\n  }\n\n  /** Gets/Sets the special dates for the component. */\n  @property({ attribute: false })\n  public set specialDates(value: DateRangeDescriptor[]) {\n    this._specialDates = value ?? [];\n  }\n\n  public get specialDates(): DateRangeDescriptor[] | undefined {\n    return this._specialDates.length ? this._specialDates : undefined;\n  }\n\n  /** Gets/Sets the disabled dates for the component. */\n  @property({ attribute: false })\n  public set disabledDates(value: DateRangeDescriptor[]) {\n    this._disabledDates = value ?? [];\n  }\n\n  public get disabledDates(): DateRangeDescriptor[] | undefined {\n    return this._disabledDates.length ? this._disabledDates : undefined;\n  }\n\n  /** @internal */\n  protected override update(props: PropertyValues<this>): void {\n    if (props.has('weekStart')) {\n      this._firstDayOfWeek = getWeekDayNumber(this.weekStart);\n    }\n\n    if (props.has('selection') && this.hasUpdated) {\n      this._rangePreviewDate = undefined;\n      this._value = null;\n      this._values = [];\n    }\n\n    super.update(props);\n  }\n\n  /** @internal */\n  protected override firstUpdated(): void {\n    if (this._initialActiveDateSet) {\n      return;\n    }\n\n    if (this._isSingle) {\n      this.activeDate = this.value ?? this.activeDate;\n    } else {\n      this.activeDate = first(this.values) ?? this.activeDate;\n    }\n  }\n}\n"]}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/components/calendar/base.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CalendarResourceStringsEN,\n  type ICalendarResourceStrings,\n} from 'igniteui-i18n-core';\nimport { LitElement, type PropertyValues } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport { convertToDate, convertToDates } from '#internals/date/converters.js';\nimport { CalendarDay, toCalendarDayOrNull } from '#internals/date/model.js';\nimport { blazorDeepImport } from '#internals/decorators/blazorDeepImport.js';\nimport { blazorIndirectRender } from '#internals/decorators/blazorIndirectRender.js';\nimport type { IgcCalendarResourceStrings } from '#internals/i18n/EN/calendar.resources.js';\nimport type { I18nControllerConfig } from '#internals/i18n/i18n-controller.js';\nimport { I18nMixin } from '#internals/mixins/i18n.js';\nimport { firstOf } from '#internals/utils/arrays.js';\nimport { getWeekDayNumber } from './helpers.js';\nimport type {\n  CalendarSelection,\n  DateRangeDescriptor,\n  WeekDays,\n} from './types.js';\n\nconst i18n: I18nControllerConfig<\n  IgcCalendarResourceStrings | ICalendarResourceStrings\n> = {\n  defaultEN: CalendarResourceStringsEN,\n  resourceMapName: 'calendar',\n};\n\n@blazorIndirectRender\n@blazorDeepImport\nexport class IgcCalendarBaseComponent extends I18nMixin<\n  IgcCalendarResourceStrings | ICalendarResourceStrings,\n  typeof LitElement,\n  IgcCalendarResourceStrings & ICalendarResourceStrings\n>(LitElement, i18n) {\n  private _initialActiveDateSet = false;\n\n  protected get _hasValues(): boolean {\n    return this._values.length > 0;\n  }\n\n  /**\n   * The index of the first day of the week (Sunday = 0) as derived from {@link weekStart}.\n   *\n   * @remarks\n   * Derived on access instead of in `update()`, so that its consumers are not sensitive\n   * to the order in which the base class and its descendants update.\n   */\n  protected get _firstDayOfWeek(): number {\n    return getWeekDayNumber(this.weekStart);\n  }\n\n  protected get _isSingle(): boolean {\n    return this.selection === 'single';\n  }\n\n  protected get _isMultiple(): boolean {\n    return this.selection === 'multiple';\n  }\n\n  protected get _isRange(): boolean {\n    return this.selection === 'range';\n  }\n\n  @state()\n  protected _rangePreviewDate?: CalendarDay;\n\n  @state()\n  protected _activeDate = CalendarDay.today;\n\n  @state()\n  protected _value: CalendarDay | null = null;\n\n  @state()\n  protected _values: CalendarDay[] = [];\n\n  @state()\n  protected _specialDates: DateRangeDescriptor[] = [];\n\n  @state()\n  protected _disabledDates: DateRangeDescriptor[] = [];\n\n  /* blazorSuppress */\n  /**\n   * The current value of the calendar.\n   * Used when selection is set to single\n   *\n   * @attr value\n   */\n  @property({ converter: convertToDate })\n  public set value(value: Date | string | null | undefined) {\n    this._value = toCalendarDayOrNull(convertToDate(value));\n  }\n\n  public get value(): Date | null {\n    return this._value ? this._value.native : null;\n  }\n\n  /* blazorSuppress */\n  /**\n   * The current values of the calendar.\n   * Used when selection is set to multiple or range.\n   *\n   * @attr values\n   */\n  @property({ converter: convertToDates })\n  public set values(values: (Date | string)[] | string | null | undefined) {\n    const converted = convertToDates(values);\n    this._values = converted ? converted.map((v) => CalendarDay.from(v)) : [];\n  }\n\n  public get values(): Date[] {\n    return this._values ? this._values.map((v) => v.native) : [];\n  }\n\n  /* blazorSuppress */\n  /** Get/Set the date which is shown in view and is highlighted. By default it is the current date. */\n  @property({ attribute: 'active-date', converter: convertToDate })\n  public set activeDate(value: Date | string | null | undefined) {\n    this._initialActiveDateSet = true;\n    this._activeDate =\n      toCalendarDayOrNull(convertToDate(value)) ?? CalendarDay.today;\n  }\n\n  public get activeDate(): Date {\n    return this._activeDate.native;\n  }\n\n  /**\n   * Sets the type of selection in the component.\n   * @attr selection\n   * @default single\n   */\n  @property()\n  public selection: CalendarSelection = 'single';\n\n  /**\n   * Whether to show the week numbers.\n   * @attr show-week-numbers\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'show-week-numbers' })\n  public showWeekNumbers = false;\n\n  /**\n   * Gets/Sets the first day of the week.\n   * @attr week-start\n   * @default sunday\n   */\n  @property({ attribute: 'week-start' })\n  public weekStart: WeekDays = 'sunday';\n\n  /**\n   * Gets/Sets the special dates for the component.\n   *\n   * @remarks\n   * Returns `undefined` when no dates are set, which the setter accepts as well so that\n   * a round trip through the property is valid.\n   */\n  @property({ attribute: false })\n  public set specialDates(value: DateRangeDescriptor[] | undefined) {\n    this._specialDates = value ?? [];\n  }\n\n  public get specialDates(): DateRangeDescriptor[] | undefined {\n    return this._specialDates.length ? this._specialDates : undefined;\n  }\n\n  /**\n   * Gets/Sets the disabled dates for the component.\n   *\n   * @remarks\n   * Returns `undefined` when no dates are set, which the setter accepts as well so that\n   * a round trip through the property is valid.\n   */\n  @property({ attribute: false })\n  public set disabledDates(value: DateRangeDescriptor[] | undefined) {\n    this._disabledDates = value ?? [];\n  }\n\n  public get disabledDates(): DateRangeDescriptor[] | undefined {\n    return this._disabledDates.length ? this._disabledDates : undefined;\n  }\n\n  /** @internal */\n  protected override update(props: PropertyValues): void {\n    if (props.has('selection') && this.hasUpdated) {\n      this._rangePreviewDate = undefined;\n      this._value = null;\n      this._values = [];\n    }\n\n    super.update(props);\n  }\n\n  /** @internal */\n  protected override firstUpdated(): void {\n    if (this._initialActiveDateSet) {\n      return;\n    }\n\n    if (this._isSingle) {\n      this.activeDate = this.value ?? this.activeDate;\n    } else {\n      this.activeDate = firstOf(this.values) ?? this.activeDate;\n    }\n  }\n}\n"]}

package/components/calendar/calendar.d.ts

@@ -1,11 +1,11 @@
 import { nothing, type TemplateResult } from 'lit';
-import type { Constructor } from '../common/mixins/constructor.js';
+import { CalendarDay } from '#internals/date/model.js';
+import type { Constructor } from '#internals/mixins/constructor.js';
 import type { ContentOrientation } from '../types.js';
 import { IgcCalendarBaseComponent } from './base.js';
-import { CalendarDay } from './model.js';
 import type { CalendarActiveView, CalendarHeaderOrientation, IgcCalendarComponentEventMap } from './types.js';
 export declare const focusActiveDate: unique symbol;
-declare const IgcCalendarComponent_base: Constructor<import("../common/mixins/event-emitter.js").EventEmitterInterface<IgcCalendarComponentEventMap>> & Constructor<IgcCalendarBaseComponent>;
+declare const IgcCalendarComponent_base: Constructor<import("#internals/mixins/event-emitter.js").EventEmitterInterface<IgcCalendarComponentEventMap>> & Constructor<IgcCalendarBaseComponent>;
 /**
  * Represents a calendar that lets users
  * to select a date value in a variety of different ways.
@@ -34,13 +34,18 @@ declare const IgcCalendarComponent_base: Constructor<import("../common/mixins/ev
  * @csspart months-view - The months view element of the calendar.
  * @csspart years-view - The years view element of the calendar.
  * @csspart days-row - Days row element of the calendar.
+ * @csspart months-row - Months row element of the calendar.
+ * @csspart years-row - Years row element of the calendar.
  * @csspart label - Week header label element of the calendar.
+ * @csspart label-inner - Week header label inner element of the calendar.
  * @csspart week-number - Week number element of the calendar.
  * @csspart week-number-inner - Week number inner element of the calendar.
  * @csspart date - Date element of the calendar.
  * @csspart date-inner - Date inner element of the calendar.
  * @csspart first - The first selected date element of the calendar in range selection.
+ * Also applies to the week numbers header cell.
  * @csspart last - The last selected date element of the calendar in range selection.
+ * Also applies to the week number of the last rendered week.
  * @csspart inactive - Inactive date element of the calendar.
  * @csspart hidden - Hidden date element of the calendar.
  * @csspart weekend - Weekend date element of the calendar.
@@ -64,14 +69,16 @@ export default class IgcCalendarComponent extends IgcCalendarComponent_base {
     private get _isDayView();
     private get _isMonthView();
     private get _isYearView();
-    private get _previousButtonLabel();
-    private get _nextButtonLabel();
+    /** The accessible name of a navigation button, based on what it pages through. */
+    private _getNavigationLabel;
+    /** The unit and the amount a single navigation step covers in the current view. */
+    private _getPageStep;
     private _activeDaysViewIndex;
     private readonly _daysViews;
     private readonly _monthsView;
     private readonly _yearsView;
     /**
-     * Whether to show the dates that do not belong to the current active month.
+     * Whether to hide the dates that do not belong to the current active month.
      * @attr hide-outside-days
      * @default false
      */
@@ -118,25 +125,49 @@ export default class IgcCalendarComponent extends IgcCalendarComponent_base {
     private _handleShiftPageKeys;
     private _handleHomeKey;
     private _handleEndKey;
+    /**
+     * Moves the active date to the first or the last date of the current view, skipping
+     * over the disabled dates towards the middle of it.
+     */
+    private _activateEdgeOfView;
     private _handleMonthChange;
     private _handleYearChange;
     private _handleValueChange;
     private _handleActiveDateChange;
     private _handleRangePreviewChange;
+    /** Makes the month rendered by the view at `viewIndex` the active one. */
     private _setActiveDaysView;
     private _navigate;
     private _navigatePrevious;
     private _navigateNext;
     private _navigateToMonthView;
     private _navigateToYearView;
-    /** @private @hidden @internal */
+    /** @hidden @internal */
     [focusActiveDate](options?: FocusOptions): Promise<void>;
     private _updateViewIndex;
     private _getActiveDates;
+    /**
+     * Returns the first enabled date starting from `start` and moving day by day in the
+     * direction of `delta`.
+     *
+     * @remarks
+     * The search is bounded, since the disabled dates can describe an open-ended range
+     * which no date in the given direction satisfies. The current active date is returned
+     * when nothing is reachable.
+     */
     private _getNextEnabledDate;
     protected _renderNavigationButtons(): TemplateResult<1>;
     protected _renderMonthButtonNavigation(active: CalendarDay, viewIndex: number): TemplateResult;
     protected _renderYearButtonNavigation(active: CalendarDay, viewIndex: number): TemplateResult;
+    /**
+     * Renders the off screen live region announcing the period the calendar navigated to.
+     *
+     * @remarks
+     * A single region for the whole calendar - one per rendered month would announce the
+     * same navigation several times over. The years view has its visible years range as a
+     * live region of its own.
+     */
+    protected _renderActivePeriod(): typeof nothing | TemplateResult<1>;
     protected _renderYearRangeNavigation(active: CalendarDay): TemplateResult;
     protected _renderNavigation(date?: CalendarDay, showButtons?: boolean, viewIndex?: number): TemplateResult;
     protected _renderHeader(): typeof nothing | TemplateResult<1>;