@govbr-ds/webcomponents 2.1.3 → 2.3.0

package/dist/cjs/br-datetime-picker.cjs.entry.js

@@ -4,10 +4,12 @@
  */
 'use strict';
 
-var index = require('./index-CRdcutym.js');
-var isValid = require('./isValid-Fu3kaWNn.js');
+var index = require('./index-Bc30P_6z.js');
+var datetimePickerPropsValidation = require('./datetime-picker-props-validation-DmNKSXsy.js');
 var event = require('./event-CmVdNHxl.js');
-var validator = require('./validator-CTCajtT9.js');
+var validator = require('./validator-GkkueMOx.js');
+var id = require('./id-DE4jSi-L.js');
+var propWarning = require('./prop-warning-xvEHQz8H.js');
 var slot = require('./slot-DAllytTj.js');
 var datetimePickerConstants = require('./datetime-picker-constants-B5pWeOn1.js');
 
@@ -20,7 +22,7 @@ function requireIsMatch () {
 	hasRequiredIsMatch = 1;
 	isMatch.isMatch = isMatch$1;
 	var _index = /*@__PURE__*/ datetimePickerConstants.requireIsValid();
-	var _index2 = /*@__PURE__*/ isValid.requireParse();
+	var _index2 = /*@__PURE__*/ datetimePickerPropsValidation.requireParse();
 
 	/**
 	 * The {@link isMatch} function options.
@@ -320,313 +322,6 @@ function requireIsMatch () {
 
 var isMatchExports = /*@__PURE__*/ requireIsMatch();
 
-var parseISO = {};
-
-var hasRequiredParseISO;
-
-function requireParseISO () {
-	if (hasRequiredParseISO) return parseISO;
-	hasRequiredParseISO = 1;
-	parseISO.parseISO = parseISO$1;
-	var _index = /*@__PURE__*/ datetimePickerConstants.requireConstants();
-
-	var _index2 = /*@__PURE__*/ datetimePickerConstants.requireConstructFrom();
-	var _index3 = /*@__PURE__*/ datetimePickerConstants.requireToDate();
-
-	/**
-	 * The {@link parseISO} function options.
-	 */
-
-	/**
-	 * @name parseISO
-	 * @category Common Helpers
-	 * @summary Parse ISO string
-	 *
-	 * @description
-	 * Parse the given string in ISO 8601 format and return an instance of Date.
-	 *
-	 * Function accepts complete ISO 8601 formats as well as partial implementations.
-	 * ISO 8601: http://en.wikipedia.org/wiki/ISO_8601
-	 *
-	 * If the argument isn't a string, the function cannot parse the string or
-	 * the values are invalid, it returns Invalid Date.
-	 *
-	 * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
-	 * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
-	 *
-	 * @param argument - The value to convert
-	 * @param options - An object with options
-	 *
-	 * @returns The parsed date in the local time zone
-	 *
-	 * @example
-	 * // Convert string '2014-02-11T11:30:30' to date:
-	 * const result = parseISO('2014-02-11T11:30:30')
-	 * //=> Tue Feb 11 2014 11:30:30
-	 *
-	 * @example
-	 * // Convert string '+02014101' to date,
-	 * // if the additional number of digits in the extended year format is 1:
-	 * const result = parseISO('+02014101', { additionalDigits: 1 })
-	 * //=> Fri Apr 11 2014 00:00:00
-	 */
-	function parseISO$1(argument, options) {
-	  const invalidDate = () => (0, _index2.constructFrom)(options?.in, NaN);
-
-	  const additionalDigits = options?.additionalDigits ?? 2;
-	  const dateStrings = splitDateString(argument);
-
-	  let date;
-	  if (dateStrings.date) {
-	    const parseYearResult = parseYear(dateStrings.date, additionalDigits);
-	    date = parseDate(parseYearResult.restDateString, parseYearResult.year);
-	  }
-
-	  if (!date || isNaN(+date)) return invalidDate();
-
-	  const timestamp = +date;
-	  let time = 0;
-	  let offset;
-
-	  if (dateStrings.time) {
-	    time = parseTime(dateStrings.time);
-	    if (isNaN(time)) return invalidDate();
-	  }
-
-	  if (dateStrings.timezone) {
-	    offset = parseTimezone(dateStrings.timezone);
-	    if (isNaN(offset)) return invalidDate();
-	  } else {
-	    const tmpDate = new Date(timestamp + time);
-	    const result = (0, _index3.toDate)(0, options?.in);
-	    result.setFullYear(
-	      tmpDate.getUTCFullYear(),
-	      tmpDate.getUTCMonth(),
-	      tmpDate.getUTCDate(),
-	    );
-	    result.setHours(
-	      tmpDate.getUTCHours(),
-	      tmpDate.getUTCMinutes(),
-	      tmpDate.getUTCSeconds(),
-	      tmpDate.getUTCMilliseconds(),
-	    );
-	    return result;
-	  }
-
-	  return (0, _index3.toDate)(timestamp + time + offset, options?.in);
-	}
-
-	const patterns = {
-	  dateTimeDelimiter: /[T ]/,
-	  timeZoneDelimiter: /[Z ]/i,
-	  timezone: /([Z+-].*)$/,
-	};
-
-	const dateRegex =
-	  /^-?(?:(\d{3})|(\d{2})(?:-?(\d{2}))?|W(\d{2})(?:-?(\d{1}))?|)$/;
-	const timeRegex =
-	  /^(\d{2}(?:[.,]\d*)?)(?::?(\d{2}(?:[.,]\d*)?))?(?::?(\d{2}(?:[.,]\d*)?))?$/;
-	const timezoneRegex = /^([+-])(\d{2})(?::?(\d{2}))?$/;
-
-	function splitDateString(dateString) {
-	  const dateStrings = {};
-	  const array = dateString.split(patterns.dateTimeDelimiter);
-	  let timeString;
-
-	  // The regex match should only return at maximum two array elements.
-	  // [date], [time], or [date, time].
-	  if (array.length > 2) {
-	    return dateStrings;
-	  }
-
-	  if (/:/.test(array[0])) {
-	    timeString = array[0];
-	  } else {
-	    dateStrings.date = array[0];
-	    timeString = array[1];
-	    if (patterns.timeZoneDelimiter.test(dateStrings.date)) {
-	      dateStrings.date = dateString.split(patterns.timeZoneDelimiter)[0];
-	      timeString = dateString.substr(
-	        dateStrings.date.length,
-	        dateString.length,
-	      );
-	    }
-	  }
-
-	  if (timeString) {
-	    const token = patterns.timezone.exec(timeString);
-	    if (token) {
-	      dateStrings.time = timeString.replace(token[1], "");
-	      dateStrings.timezone = token[1];
-	    } else {
-	      dateStrings.time = timeString;
-	    }
-	  }
-
-	  return dateStrings;
-	}
-
-	function parseYear(dateString, additionalDigits) {
-	  const regex = new RegExp(
-	    "^(?:(\\d{4}|[+-]\\d{" +
-	      (4 + additionalDigits) +
-	      "})|(\\d{2}|[+-]\\d{" +
-	      (2 + additionalDigits) +
-	      "})$)",
-	  );
-
-	  const captures = dateString.match(regex);
-	  // Invalid ISO-formatted year
-	  if (!captures) return { year: NaN, restDateString: "" };
-
-	  const year = captures[1] ? parseInt(captures[1]) : null;
-	  const century = captures[2] ? parseInt(captures[2]) : null;
-
-	  // either year or century is null, not both
-	  return {
-	    year: century === null ? year : century * 100,
-	    restDateString: dateString.slice((captures[1] || captures[2]).length),
-	  };
-	}
-
-	function parseDate(dateString, year) {
-	  // Invalid ISO-formatted year
-	  if (year === null) return new Date(NaN);
-
-	  const captures = dateString.match(dateRegex);
-	  // Invalid ISO-formatted string
-	  if (!captures) return new Date(NaN);
-
-	  const isWeekDate = !!captures[4];
-	  const dayOfYear = parseDateUnit(captures[1]);
-	  const month = parseDateUnit(captures[2]) - 1;
-	  const day = parseDateUnit(captures[3]);
-	  const week = parseDateUnit(captures[4]);
-	  const dayOfWeek = parseDateUnit(captures[5]) - 1;
-
-	  if (isWeekDate) {
-	    if (!validateWeekDate(year, week, dayOfWeek)) {
-	      return new Date(NaN);
-	    }
-	    return dayOfISOWeekYear(year, week, dayOfWeek);
-	  } else {
-	    const date = new Date(0);
-	    if (
-	      !validateDate(year, month, day) ||
-	      !validateDayOfYearDate(year, dayOfYear)
-	    ) {
-	      return new Date(NaN);
-	    }
-	    date.setUTCFullYear(year, month, Math.max(dayOfYear, day));
-	    return date;
-	  }
-	}
-
-	function parseDateUnit(value) {
-	  return value ? parseInt(value) : 1;
-	}
-
-	function parseTime(timeString) {
-	  const captures = timeString.match(timeRegex);
-	  if (!captures) return NaN; // Invalid ISO-formatted time
-
-	  const hours = parseTimeUnit(captures[1]);
-	  const minutes = parseTimeUnit(captures[2]);
-	  const seconds = parseTimeUnit(captures[3]);
-
-	  if (!validateTime(hours, minutes, seconds)) {
-	    return NaN;
-	  }
-
-	  return (
-	    hours * _index.millisecondsInHour +
-	    minutes * _index.millisecondsInMinute +
-	    seconds * 1000
-	  );
-	}
-
-	function parseTimeUnit(value) {
-	  return (value && parseFloat(value.replace(",", "."))) || 0;
-	}
-
-	function parseTimezone(timezoneString) {
-	  if (timezoneString === "Z") return 0;
-
-	  const captures = timezoneString.match(timezoneRegex);
-	  if (!captures) return 0;
-
-	  const sign = captures[1] === "+" ? -1 : 1;
-	  const hours = parseInt(captures[2]);
-	  const minutes = (captures[3] && parseInt(captures[3])) || 0;
-
-	  if (!validateTimezone(hours, minutes)) {
-	    return NaN;
-	  }
-
-	  return (
-	    sign *
-	    (hours * _index.millisecondsInHour + minutes * _index.millisecondsInMinute)
-	  );
-	}
-
-	function dayOfISOWeekYear(isoWeekYear, week, day) {
-	  const date = new Date(0);
-	  date.setUTCFullYear(isoWeekYear, 0, 4);
-	  const fourthOfJanuaryDay = date.getUTCDay() || 7;
-	  const diff = (week - 1) * 7 + day + 1 - fourthOfJanuaryDay;
-	  date.setUTCDate(date.getUTCDate() + diff);
-	  return date;
-	}
-
-	// Validation functions
-
-	// February is null to handle the leap year (using ||)
-	const daysInMonths = [31, null, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-
-	function isLeapYearIndex(year) {
-	  return year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0);
-	}
-
-	function validateDate(year, month, date) {
-	  return (
-	    month >= 0 &&
-	    month <= 11 &&
-	    date >= 1 &&
-	    date <= (daysInMonths[month] || (isLeapYearIndex(year) ? 29 : 28))
-	  );
-	}
-
-	function validateDayOfYearDate(year, dayOfYear) {
-	  return dayOfYear >= 1 && dayOfYear <= (isLeapYearIndex(year) ? 366 : 365);
-	}
-
-	function validateWeekDate(_year, week, day) {
-	  return week >= 1 && week <= 53 && day >= 0 && day <= 6;
-	}
-
-	function validateTime(hours, minutes, seconds) {
-	  if (hours === 24) {
-	    return minutes === 0 && seconds === 0;
-	  }
-
-	  return (
-	    seconds >= 0 &&
-	    seconds < 60 &&
-	    minutes >= 0 &&
-	    minutes < 60 &&
-	    hours >= 0 &&
-	    hours < 25
-	  );
-	}
-
-	function validateTimezone(_hours, minutes) {
-	  return minutes >= 0 && minutes <= 59;
-	}
-	return parseISO;
-}
-
-var parseISOExports = /*@__PURE__*/ requireParseISO();
-
 /** Serializa o valor atual para envio em FormData conforme o modo ativo. */
 function serializeDatetimePickerFormValue(value, context) {
     if (isDateRangeMode(context)) {
@@ -698,24 +393,24 @@ function parseTimeValue(value, referenceDate) {
     if (!isMatchExports.isMatch(value, 'HH:mm')) {
         return null;
     }
-    const parsedTime = isValid.parseExports.parse(value, 'HH:mm', new Date());
-    if (!isValid.isValidExports.isValid(parsedTime)) {
+    const parsedTime = datetimePickerPropsValidation.parseExports.parse(value, 'HH:mm', new Date());
+    if (!datetimePickerPropsValidation.isValidExports.isValid(parsedTime)) {
         return null;
     }
-    const baseDate = isValid.toDateExports.toDate(referenceDate);
+    const baseDate = datetimePickerPropsValidation.toDateExports.toDate(referenceDate);
     baseDate.setHours(parsedTime.getHours(), parsedTime.getMinutes(), 0, 0);
     return baseDate;
 }
 function parseIsoDate(value) {
-    const parsedDate = parseISOExports.parseISO(value);
-    return isValid.isValidExports.isValid(parsedDate) ? parsedDate : null;
+    const parsedDate = datetimePickerPropsValidation.parseISOExports.parseISO(value);
+    return datetimePickerPropsValidation.isValidExports.isValid(parsedDate) ? parsedDate : null;
 }
 function parseDate(value) {
     if (!isMatchExports.isMatch(value, 'yyyy-MM-dd')) {
         return null;
     }
-    const parsedDate = isValid.parseExports.parse(value, 'yyyy-MM-dd', new Date());
-    if (!isValid.isValidExports.isValid(parsedDate)) {
+    const parsedDate = datetimePickerPropsValidation.parseExports.parse(value, 'yyyy-MM-dd', new Date());
+    if (!datetimePickerPropsValidation.isValidExports.isValid(parsedDate)) {
         return null;
     }
     // Garante aderência estrita ao formato/calendário evitando rollover silencioso.
@@ -729,166 +424,7 @@ function serializeDate(value) {
     return datetimePickerConstants.formatExports.format(value, 'yyyy-MM-dd');
 }
 
-const VALID_WEEK_START_DAYS = [0, 1, 2, 3, 4, 5, 6];
-const INITIAL_MOMENT_DATE_FORMATS = ['dd/MM/yyyy HH:mm', 'dd/MM/yyyy', 'yyyy-MM-dd HH:mm', 'yyyy-MM-dd'];
-function parseInitialMomentString(value) {
-    const trimmedValue = value.trim();
-    if (trimmedValue === '') {
-        return null;
-    }
-    const isoDate = parseISOExports.parseISO(trimmedValue);
-    if (isValid.isValidExports.isValid(isoDate)) {
-        return isoDate;
-    }
-    for (const formatPattern of INITIAL_MOMENT_DATE_FORMATS) {
-        const parsedDate = isValid.parseExports.parse(trimmedValue, formatPattern, new Date());
-        if (isValid.isValidExports.isValid(parsedDate)) {
-            return parsedDate;
-        }
-    }
-    return null;
-}
-function normalizeDateCandidate(value) {
-    if (value instanceof Date) {
-        if (!Number.isNaN(value.getTime())) {
-            return new Date(value);
-        }
-        return null;
-    }
-    if (typeof value === 'string') {
-        return parseInitialMomentString(value);
-    }
-    return null;
-}
-function tokenizeDisabledDatesString(value) {
-    return value
-        .trim()
-        .split(/\s+/)
-        .filter((token) => token.length > 0);
-}
-/**
- * Verifica se o valor informado corresponde a um modo suportado pelo componente.
- *
- * @param value - Valor recebido via prop ou atributo.
- * @returns `true` quando o valor pertence ao conjunto aceito de modos.
- */
-function isValidDatetimePickerMode(value) {
-    return Object.values(datetimePickerConstants.DATETIME_PICKER_MODE).includes(value);
-}
-/**
- * Normaliza o modo informado e aplica o valor padrão quando necessário.
- *
- * @param value - Valor bruto recebido do consumidor do componente.
- * @returns O modo válido correspondente, ou o valor padrão quando o input for inválido.
- */
-function normalizeDatetimePickerMode(value) {
-    if (isValidDatetimePickerMode(value))
-        return value;
-    isValid.warnInvalidPropValue('br-datetime-picker', 'mode', value, datetimePickerConstants.DATETIME_PICKER_MODE.DEFAULT);
-    return datetimePickerConstants.DATETIME_PICKER_MODE.DEFAULT;
-}
-/**
- * Verifica se o valor representa um modo de seleção suportado.
- *
- * @param value - Valor bruto recebido via prop.
- * @returns `true` quando o valor é `'single'` ou `'range'`.
- */
-function isValidDatetimePickerSelectionMode(value) {
-    return value === 'single' || value === 'range';
-}
-/**
- * Normaliza o modo de seleção informado e aplica o valor padrão quando necessário.
- *
- * @param value - Valor bruto recebido do consumidor do componente.
- * @returns O modo de seleção válido correspondente, ou `'single'` quando o input for inválido.
- */
-function normalizeDatetimePickerSelectionMode(value) {
-    if (isValidDatetimePickerSelectionMode(value))
-        return value;
-    isValid.warnInvalidPropValue('br-datetime-picker', 'selectionMode', value, 'single');
-    return 'single';
-}
-/**
- * Normaliza a seleção inicial para um valor aplicável pelo componente.
- *
- * @param value - Valor bruto recebido via prop.
- * @returns `'now'`, `Date` normalizada ou `null` quando inválido.
- */
-function normalizeDatetimePickerInitialMoment(value) {
-    if (value === null)
-        return null;
-    if (value === 'now')
-        return 'now';
-    const normalizedDate = normalizeDateCandidate(value);
-    if (normalizedDate !== null) {
-        return normalizedDate;
-    }
-    isValid.warnInvalidPropValue('br-datetime-picker', 'initialMoment', value, 'null');
-    return null;
-}
-/**
- * Normaliza a lista de datas desabilitadas para uma coleção de `Date` válidas.
- *
- * @param value - Valor bruto recebido via prop.
- * @returns Lista normalizada de datas; retorna array vazio quando inválido.
- */
-function normalizeDatetimePickerDisabledDates(value) {
-    if (value === null) {
-        return [];
-    }
-    if (typeof value === 'string') {
-        const tokens = tokenizeDisabledDatesString(value);
-        if (tokens.length === 0) {
-            isValid.warnInvalidPropValue('br-datetime-picker', 'disabledDates', value, '[]');
-            return [];
-        }
-        const normalizedDates = tokens
-            .map((dateCandidate) => normalizeDateCandidate(dateCandidate))
-            .filter((dateCandidate) => dateCandidate !== null);
-        if (normalizedDates.length !== tokens.length) {
-            isValid.warnInvalidPropValue('br-datetime-picker', 'disabledDates', value, '[]');
-        }
-        return normalizedDates;
-    }
-    if (!Array.isArray(value)) {
-        isValid.warnInvalidPropValue('br-datetime-picker', 'disabledDates', value, '[]');
-        return [];
-    }
-    const normalizedDates = value
-        .map((dateCandidate) => normalizeDateCandidate(dateCandidate))
-        .filter((dateCandidate) => dateCandidate !== null);
-    if (normalizedDates.length !== value.length) {
-        isValid.warnInvalidPropValue('br-datetime-picker', 'disabledDates', value, '[]');
-    }
-    return normalizedDates;
-}
-/**
- * Verifica se o valor informado representa um índice válido de início da semana.
- *
- * @param value - Valor bruto recebido via prop.
- * @returns `true` quando o valor está entre `0` e `6`.
- */
-function isValidDatetimePickerWeekStartsOn(value) {
-    return VALID_WEEK_START_DAYS.includes(value);
-}
-/**
- * Normaliza o índice de início da semana e aplica `0` quando o valor é inválido.
- *
- * @param value - Valor bruto recebido do consumidor do componente.
- * @returns Índice normalizado para o primeiro dia da semana.
- */
-function normalizeDatetimePickerWeekStartsOn(value) {
-    const numericValue = typeof value === 'string' ? Number(value) : value;
-    if (typeof numericValue === 'number' &&
-        Number.isInteger(numericValue) &&
-        isValidDatetimePickerWeekStartsOn(numericValue)) {
-        return numericValue;
-    }
-    isValid.warnInvalidPropValue('br-datetime-picker', 'weekStartsOn', String(value), '0');
-    return 0;
-}
-
-const datetimePickerCss = () => `*,*::before,*::after{box-sizing:border-box}:host{line-height:var(--font-line-height-medium);-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;text-size-adjust:100%}main{display:block}hr{box-sizing:content-box;height:0;overflow:visible}a{background-color:rgba(0,0,0,0)}b,strong{font-weight:bolder}code{font-family:monospace;font-size:1em}small{font-size:80%}img{border-style:none}button,input,select,textarea{font-family:inherit;font-size:100%;line-height:var(--font-line-height-medium);margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{appearance:none}::-webkit-file-upload-button{appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.d-none{display:none !important}@media (min-width: 576px){.d-sm-block{display:block !important}.d-sm-flex{display:flex !important}}[data-toggle=dropdown]+*{position:absolute}.dropdown{position:relative}.dropdown [data-toggle=dropdown]+*{box-shadow:var(--surface-shadow-sm);left:0;position:absolute;top:100%}.dropdown>.br-notification{left:auto;right:0}.dropdown .br-item{--color:var(--color-light);--color-rgb:var(--color-light-rgb);--text-color:var(--color-light);--interactive:var(--interactive-light);--interactive-rgb:var(--color-rgb);--visited:var(--visited-light);--hover:var(--hover-light);--pressed:var(--pressed-light);--focus-color:var(--focus-color-light);--focus:var(--focus-color-light);--item-padding-y:var(--spacing-scale-2x);background-color:var(--background-light);color:var(--color)}.dropdown .br-item:not(:last-child){border-bottom:1px solid var(--border-color)}.dropdown .br-item.selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}.justify-content-start{justify-content:flex-start !important}.justify-content-end{justify-content:flex-end !important}.justify-content-center{justify-content:center !important}.align-items-center{align-items:center !important}.col,[class*=col-]{padding-left:calc(var(--grid-gutter)*.5);padding-right:calc(var(--grid-gutter)*.5);width:100%}.col{flex:1 0 0%;min-width:8.3333333333%}.col-auto{flex:0 0 auto;width:auto}.col-2{flex-basis:16.6666666667%;max-width:16.6666666667%}.container,.container-fluid,.container-lg{--grid-margin:var(--grid-portrait-margin);--grid-maxwidth:var(--grid-portrait-maxwidth);margin-left:auto;margin-right:auto;max-width:var(--grid-maxwidth);padding-left:var(--grid-margin);padding-right:var(--grid-margin);width:100%}.row{--grid-gutter:var(--grid-portrait-gutter);display:flex;flex-wrap:wrap;margin-left:calc(var(--grid-gutter)*-0.5);margin-right:calc(var(--grid-gutter)*-0.5)}@media (min-width: 576px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-sm) - var(--grid-tablet-margin))}.col-sm-4{flex-basis:33.3333333333%;max-width:33.3333333333%}}@media (min-width: 992px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-md) - var(--grid-tablet-margin))}}@media (min-width: 1280px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-desktop-margin)}.row{--grid-gutter:var(--grid-desktop-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-lg) - var(--grid-desktop-margin))}.col-lg-3{flex-basis:25%;max-width:25%}}@media (min-width: 1600px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tv-margin)}.row{--grid-gutter:var(--grid-tv-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-xl) - var(--grid-tv-margin))}}.ease{animation-timing-function:cubic-bezier(0.25, 0.1, 0.25, 1)}.ease-in-out{animation-timing-function:cubic-bezier(0.42, 0, 0.58, 1)}.mt-1{margin-top:var(--spacing-scale-half) !important}.mr-1{margin-right:var(--spacing-scale-half) !important}.mb-1{margin-bottom:var(--spacing-scale-half) !important}.ml-1{margin-left:var(--spacing-scale-half) !important}.mx-3{margin-left:var(--spacing-scale-2x) !important;margin-right:var(--spacing-scale-2x) !important}.mb-4{margin-bottom:var(--spacing-scale-3x) !important}.ml-auto{margin-left:auto !important}.pt-half{padding-top:var(--spacing-scale-half) !important}@media (min-width: 576px){.ml-sm-0{margin-left:var(--spacing-scale-default) !important}}.highlight{background:var(--status-highlight-background) linear-gradient(var(--status-highlight-overlay), var(--status-highlight-overlay));color:var(--status-highlight-text);padding:0 var(--spacing-scale-half)}[disabled],.disabled{cursor:not-allowed;opacity:var(--disabled)}[disabled] *,.disabled *{pointer-events:none}.text-center{text-align:center !important}.text-right{text-align:right !important}.text-nowrap{white-space:nowrap !important}.text-uppercase{text-transform:uppercase !important}.text-bold{font-weight:700 !important}.text-base{font-size:var(--font-size-scale-base) !important}.text-down-01{font-size:var(--font-size-scale-down-01) !important}@media (min-width: 576px){.text-sm-center{text-align:center !important}.text-sm-left{text-align:left !important}.text-sm-right{text-align:right !important}}p{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-2x);margin-top:0}p a{text-decoration:underline}@media (min-width: 576px){p{font-size:var(--font-size-scale-up-01)}}a{--focus-offset:var(--spacing-scale-half)}a:focus{outline:none}a.focus-visible,a:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}a:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}a:not(:disabled):active{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--pressed)), rgba(var(--interactive-rgb), var(--pressed)))}a{color:var(--interactive);text-decoration:none}.main-content a{text-decoration:underline}button{cursor:pointer}img{max-width:100%;vertical-align:middle}h2,.h2{color:var(--color);font-size:var(--font-size-scale-up-03);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2xh);margin-top:var(--spacing-scale-3xh);padding-bottom:var(--spacing-scale-2xh)}@media (min-width: 576px){.h2,h2{font-size:var(--font-size-scale-up-05);font-weight:var(--font-weight-regular)}}ul,ol{margin-bottom:var(--spacing-scale-2x);margin-top:0;padding:0 0 0 var(--spacing-scale-5x)}table{--table-background:var(--background);--table-color:var(--color);--table-border-color:var(--gray-20);--table-border-style:solid;--table-border-width:1px;--table-hover:var(--color-rgb);--table-padding:var(--spacing-scale-3x);--table-font-weight:var(--font-weight-medium);--table-th-background:var(--background-alternative);--table-th-font-weight:var(--font-weight-semi-bold);--table-row-size:var(--spacing-scale-2x);border-collapse:collapse;width:100%}tr.selected,tr.is-selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}label,.label{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half)}fieldset,.fieldset{border:var(--surface-width-none);margin-bottom:var(--spacing-scale-5x);margin-top:0;padding:0}legend,.legend{color:var(--color);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2x);margin-top:var(--spacing-scale-2x)}::placeholder,.placeholder{color:var(--color-light);font-size:var(--font-size-scale-base);font-style:italic;font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half);margin-top:var(--spacing-scale-half);opacity:1}input,textarea,.input{color:var(--color-light);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-half)}.help{font-size:var(--font-size-scale-base)}code,.code{background:var(--gray-5);border-radius:4px;color:var(--gray-80);display:inline-block;font-family:monospace;font-size:var(--font-size-scale-base);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);padding:var(--spacing-scale-half)}*[data-toggle=collapse]:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}*[data-toggle=collapse]:focus{outline:none}*[data-toggle=collapse].focus-visible,*[data-toggle=collapse]:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}:host{display:inline-block;margin-bottom:var(--spacing-scale-base);position:relative;width:var(--br-datetime-picker-width, 304px)}:host([mode=time]){width:var(--br-datetime-picker-time-width, 144px)}:host([mode=date]){width:var(--br-datetime-picker-date-width, 304px)}:host([mode=datetime]){width:var(--br-datetime-picker-datetime-width, 304px)}.br-datetime-picker{width:100%}.br-datetime-picker br-datetime-input,.br-datetime-picker br-card{display:block;width:100%}.br-datetime-picker br-card{font-size:var(--font-size-scale-base)}`;
+const datetimePickerCss = () => `*,*::before,*::after{box-sizing:border-box}:host{line-height:var(--font-line-height-medium);-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;text-size-adjust:100%}main{display:block}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace;font-size:1em}a{background-color:rgba(0,0,0,0)}b,strong{font-weight:bolder}code{font-family:monospace;font-size:1em}small{font-size:80%}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:var(--font-line-height-medium);margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{appearance:none}::-webkit-file-upload-button{appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.d-none{display:none !important}@media (min-width: 576px){.d-sm-block{display:block !important}.d-sm-flex{display:flex !important}}[data-toggle=dropdown]+*{position:absolute}.dropdown{position:relative}.dropdown [data-toggle=dropdown]+*{box-shadow:var(--surface-shadow-sm);left:0;position:absolute;top:100%}.dropdown>.br-notification{left:auto;right:0}.dropdown .br-item{--color:var(--color-light);--color-rgb:var(--color-light-rgb);--text-color:var(--color-light);--interactive:var(--interactive-light);--interactive-rgb:var(--color-rgb);--visited:var(--visited-light);--hover:var(--hover-light);--pressed:var(--pressed-light);--focus-color:var(--focus-color-light);--focus:var(--focus-color-light);--item-padding-y:var(--spacing-scale-2x);background-color:var(--background-light);color:var(--color)}.dropdown .br-item:not(:last-child){border-bottom:1px solid var(--border-color)}.dropdown .br-item.selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}.justify-content-start{justify-content:flex-start !important}.justify-content-end{justify-content:flex-end !important}.justify-content-center{justify-content:center !important}.align-items-center{align-items:center !important}.col,[class*=col-]{padding-left:calc(var(--grid-gutter)*.5);padding-right:calc(var(--grid-gutter)*.5);width:100%}.col{flex:1 0 0%;min-width:8.3333333333%}.col-auto{flex:0 0 auto;width:auto}.col-2{flex-basis:16.6666666667%;max-width:16.6666666667%}.container,.container-fluid,.container-lg{--grid-margin:var(--grid-portrait-margin);--grid-maxwidth:var(--grid-portrait-maxwidth);margin-left:auto;margin-right:auto;max-width:var(--grid-maxwidth);padding-left:var(--grid-margin);padding-right:var(--grid-margin);width:100%}.row{--grid-gutter:var(--grid-portrait-gutter);display:flex;flex-wrap:wrap;margin-left:calc(var(--grid-gutter)*-0.5);margin-right:calc(var(--grid-gutter)*-0.5)}@media (min-width: 576px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-sm) - var(--grid-tablet-margin))}.col-sm-4{flex-basis:33.3333333333%;max-width:33.3333333333%}}@media (min-width: 992px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-md) - var(--grid-tablet-margin))}}@media (min-width: 1280px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-desktop-margin)}.row{--grid-gutter:var(--grid-desktop-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-lg) - var(--grid-desktop-margin))}.col-lg-3{flex-basis:25%;max-width:25%}}@media (min-width: 1600px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tv-margin)}.row{--grid-gutter:var(--grid-tv-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-xl) - var(--grid-tv-margin))}}.ease{animation-timing-function:cubic-bezier(0.25, 0.1, 0.25, 1)}.ease-out{animation-timing-function:cubic-bezier(0, 0, 0.58, 1)}.ease-in-out{animation-timing-function:cubic-bezier(0.42, 0, 0.58, 1)}.fast{animation-duration:var(--duration-fast)}.slow{animation-duration:var(--duration-slow)}.mt-1{margin-top:var(--spacing-scale-half) !important}.mr-1{margin-right:var(--spacing-scale-half) !important}.mb-1{margin-bottom:var(--spacing-scale-half) !important}.ml-1{margin-left:var(--spacing-scale-half) !important}.mx-3{margin-left:var(--spacing-scale-2x) !important;margin-right:var(--spacing-scale-2x) !important}.mb-4{margin-bottom:var(--spacing-scale-3x) !important}.ml-auto{margin-left:auto !important}.pt-half{padding-top:var(--spacing-scale-half) !important}@media (min-width: 576px){.ml-sm-0{margin-left:var(--spacing-scale-default) !important}}.highlight{background:var(--status-highlight-background) linear-gradient(var(--status-highlight-overlay), var(--status-highlight-overlay));color:var(--status-highlight-text);padding:0 var(--spacing-scale-half)}[disabled],.disabled{cursor:not-allowed;opacity:var(--disabled)}[disabled] *,.disabled *{pointer-events:none}fieldset[disabled]{opacity:1}.text-center{text-align:center !important}.text-right{text-align:right !important}.text-nowrap{white-space:nowrap !important}.text-uppercase{text-transform:uppercase !important}.text-bold{font-weight:700 !important}.text-base{font-size:var(--font-size-scale-base) !important}.text-down-01{font-size:var(--font-size-scale-down-01) !important}@media (min-width: 576px){.text-sm-center{text-align:center !important}.text-sm-left{text-align:left !important}.text-sm-right{text-align:right !important}}p{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-2x);margin-top:0}p a{text-decoration:underline}@media (min-width: 576px){p{font-size:var(--font-size-scale-up-01)}}a{--focus-offset:var(--spacing-scale-half)}a:focus{outline:none}a.focus-visible,a:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}a:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}a:not(:disabled):active{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--pressed)), rgba(var(--interactive-rgb), var(--pressed)))}a{color:var(--interactive);text-decoration:none}.main-content a{text-decoration:underline}button{cursor:pointer}img{max-width:100%;vertical-align:middle}h2,.h2{color:var(--color);font-size:var(--font-size-scale-up-03);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2xh);margin-top:var(--spacing-scale-3xh);padding-bottom:var(--spacing-scale-2xh)}@media (min-width: 576px){.h2,h2{font-size:var(--font-size-scale-up-05);font-weight:var(--font-weight-regular)}}ul,ol{margin-bottom:var(--spacing-scale-2x);margin-top:0;padding:0 0 0 var(--spacing-scale-5x)}table{--table-background:var(--background);--table-color:var(--color);--table-border-color:var(--gray-20);--table-border-style:solid;--table-border-width:1px;--table-hover:var(--color-rgb);--table-padding:var(--spacing-scale-3x);--table-font-weight:var(--font-weight-medium);--table-th-background:var(--background-alternative);--table-th-font-weight:var(--font-weight-semi-bold);--table-row-size:var(--spacing-scale-2x);border-collapse:collapse;width:100%}tr.selected,tr.is-selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}label,.label{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half)}fieldset,.fieldset{border:var(--surface-width-none);margin-bottom:var(--spacing-scale-5x);margin-top:0;padding:0}legend,.legend{color:var(--color);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2x);margin-top:var(--spacing-scale-2x)}::placeholder,.placeholder{color:var(--color-light);font-size:var(--font-size-scale-base);font-style:italic;font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half);margin-top:var(--spacing-scale-half);opacity:1}input,textarea,.input{color:var(--color-light);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-half)}code,.code{background:var(--gray-5);border-radius:4px;color:var(--gray-80);display:inline-block;font-family:monospace;font-size:var(--font-size-scale-base);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);padding:var(--spacing-scale-half)}pre,.pre{background:var(--gray-5);margin:var(--spacing-scale-2x) 0 var(--spacing-scale-4x);padding:var(--spacing-scale-2x)}pre code,.pre code{display:inline;padding:0}*[data-toggle=collapse]:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}*[data-toggle=collapse]:focus{outline:none}*[data-toggle=collapse].focus-visible,*[data-toggle=collapse]:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}@media (prefers-reduced-motion: reduce){:host,:host::before,:host::after,:host *,:host *::before,:host *::after{animation:none !important;scroll-behavior:auto !important;transition:none !important}}:host-context([data-wbc-reduced-motion=true])::before,:host-context([data-wbc-reduced-motion=true])::after,:host-context([data-wbc-reduced-motion=true]) *,:host-context([data-wbc-reduced-motion=true]) *::before,:host-context([data-wbc-reduced-motion=true]) *::after{animation:none !important;scroll-behavior:auto !important;transition:none !important}:host{box-sizing:border-box;display:block;margin-bottom:var(--spacing-scale-base);max-width:var(--br-datetime-picker-width, none);position:relative;width:100%}:host([mode=time]){max-width:var(--br-datetime-picker-time-width, var(--br-datetime-picker-width, none));width:100%}:host([mode=date]){max-width:var(--br-datetime-picker-date-width, var(--br-datetime-picker-width, none));width:100%}:host([mode=datetime]){max-width:var(--br-datetime-picker-datetime-width, var(--br-datetime-picker-width, none));width:100%}.br-datetime-picker{width:100%}.br-datetime-picker br-datetime-input,.br-datetime-picker br-card{display:block;width:100%}.br-datetime-picker br-card{font-size:var(--font-size-scale-base);animation:none}@media (prefers-reduced-motion: no-preference){.br-datetime-picker br-card{animation:datetime-panel-open var(--duration-fast, 300ms) var(--animation-ease-out, ease-out) both}}@keyframes datetime-panel-open{from{opacity:0}to{opacity:1}}`;
 
 const DatetimePicker = class {
     constructor(hostRef) {
@@ -912,7 +448,7 @@ const DatetimePicker = class {
         this.customValidationMessage = '';
         this.validatorMessage = null;
         this.isValidating = false;
-        this.feedbackId = `br-datetime-picker-feedback-${datetimePickerId++}`;
+        this.feedbackId = id.generateUniqueId('br-datetime-picker-feedback');
         /** Lista normalizada de datas indisponíveis para seleção. */
         this.normalizedDisabledDates = [];
         /** Data final selecionada no modo de intervalo. */
@@ -949,9 +485,25 @@ const DatetimePicker = class {
         this.name = '';
         /** Indica se o campo deve ter valor antes do envio do formulário. */
         this.required = false;
-        /** Menor data/horário aceito, interpretado conforme `mode`. */
+        /**
+         * Menor data/horário aceito, interpretado conforme `mode`. Valores inválidos são ignorados.
+         * Aceita texto no atributo HTML ou uma instância de `Date` por property binding.
+         *
+         * @example
+         * ```html
+         * <br-datetime-picker mode="date" min="2026-01-01"></br-datetime-picker>
+         * ```
+         */
         this.min = null;
-        /** Maior data/horário aceito, interpretado conforme `mode`. */
+        /**
+         * Maior data/horário aceito, interpretado conforme `mode`. Valores inválidos são ignorados.
+         * Aceita texto no atributo HTML ou uma instância de `Date` por property binding.
+         *
+         * @example
+         * ```html
+         * <br-datetime-picker mode="date" max="2026-12-31"></br-datetime-picker>
+         * ```
+         */
         this.max = null;
         /**
          * Define o tipo de seleção de datas para o calendário: única ou intervalo.
@@ -960,6 +512,7 @@ const DatetimePicker = class {
          * Se `selectionMode="range"` for informado, o componente ajusta automaticamente
          * `mode` para `date`. Se `mode` mudar para `time` ou `datetime`, o componente
          * normaliza `selectionMode` para `single` quando necessário.
+         * Valores inválidos usam `single`.
          */
         this.selectionMode = 'single';
         /**
@@ -981,11 +534,22 @@ const DatetimePicker = class {
          * Reativo em runtime: mudanças na prop atualizam estado e subcomponentes.
          *
          * @default null
+         * @example
+         * ```html
+         * <br-datetime-picker initial-moment="now"></br-datetime-picker>
+         * ```
          */
         this.initialMoment = null;
         /**
-         * Valor selecionado pelo usuário. Pode ser controlado externamente e é atualizado
-         * pelo evento `valueChange`.
+         * Instância de `Date` selecionada pelo usuário no modo simples.
+         * Pode ser controlada por property binding e é atualizada pelo evento `valueChange`.
+         * Para formulários e atributos textuais, use `serializedValue`.
+         *
+         * @example
+         * ```js
+         * const picker = document.querySelector('br-datetime-picker');
+         * picker.value = new Date(2026, 8, 7, 14, 30);
+         * ```
          */
         this.value = null;
         /**
@@ -1004,6 +568,15 @@ const DatetimePicker = class {
          * A comparação considera apenas o dia (ano/mês/dia), ignorando hora.
          *
          * @default null
+         * @example
+         * ```html
+         * <br-datetime-picker mode="date" disabled-dates="2026-09-07 2026-09-08"></br-datetime-picker>
+         * ```
+         * @example
+         * ```js
+         * const picker = document.querySelector('br-datetime-picker');
+         * picker.disabledDates = [new Date(2026, 8, 7), '2026-09-08'];
+         * ```
          */
         this.disabledDates = null;
         /**
@@ -1043,9 +616,9 @@ const DatetimePicker = class {
             if (selectedDate !== null && this.isDateDisabled(selectedDate)) {
                 return;
             }
-            this.referenceDate = isValid.toDateExports.toDate(referenceDate);
+            this.referenceDate = datetimePickerPropsValidation.toDateExports.toDate(referenceDate);
             const shouldEmitPublicEvent = this.resolvePublicEventEmissionForRange(range);
-            this.setComponentValue(value === null ? null : isValid.toDateExports.toDate(value), shouldEmitPublicEvent && this.isInitialized);
+            this.setComponentValue(value === null ? null : datetimePickerPropsValidation.toDateExports.toDate(value), shouldEmitPublicEvent && this.isInitialized);
         };
         /**
          * Alterna visibilidade do picker quando o input solicita.
@@ -1057,7 +630,7 @@ const DatetimePicker = class {
             event.stopPropagation();
             const willOpen = !this.isPickerOpen;
             if (willOpen) {
-                this.referenceDate = this.value === null ? isValid.toDateExports.toDate(new Date()) : isValid.toDateExports.toDate(this.value);
+                this.referenceDate = this.value === null ? datetimePickerPropsValidation.toDateExports.toDate(new Date()) : datetimePickerPropsValidation.toDateExports.toDate(this.value);
             }
             this.isPickerOpen = willOpen;
         };
@@ -1082,7 +655,7 @@ const DatetimePicker = class {
                 return;
             event.stopPropagation();
             this.isPickerOpen = false;
-            this.getNativeInputElement()?.focus();
+            void this.focusInput();
         };
     }
     formDisabledCallback(disabled) {
@@ -1159,7 +732,7 @@ const DatetimePicker = class {
     }
     /** Sincroniza alterações externas do valor com o estado visual e o formulário nativo. */
     handleValueChange(newValue) {
-        const normalizedValue = newValue instanceof Date && !Number.isNaN(newValue.getTime()) ? isValid.toDateExports.toDate(newValue) : null;
+        const normalizedValue = newValue instanceof Date && !Number.isNaN(newValue.getTime()) ? datetimePickerPropsValidation.toDateExports.toDate(newValue) : null;
         if (newValue !== null && normalizedValue === null) {
             this.value = null;
             return;
@@ -1180,7 +753,7 @@ const DatetimePicker = class {
     handleValueAsDateChange(newValue) {
         if (this.syncingCanonicalValues || newValue === undefined)
             return;
-        const normalizedValue = newValue instanceof Date && !Number.isNaN(newValue.getTime()) ? isValid.toDateExports.toDate(newValue) : null;
+        const normalizedValue = newValue instanceof Date && !Number.isNaN(newValue.getTime()) ? datetimePickerPropsValidation.toDateExports.toDate(newValue) : null;
         if (this.sameDate(this.value, normalizedValue))
             return;
         this.value = normalizedValue;
@@ -1204,10 +777,14 @@ const DatetimePicker = class {
     handleRangeValueChange(newValue) {
         if (!newValue || this.selectionMode !== 'range')
             return;
+        if (!datetimePickerPropsValidation.isValidDatetimePickerDateRange(newValue)) {
+            propWarning.reportInvalidPropValue(this.el, 'rangeValue', newValue, 'Informe um objeto com `start` e `end` como Date válido ou null.', 'Mantendo o último intervalo efetivo.');
+            return;
+        }
         this.rangeStart = this.cloneDate(newValue.start);
         this.rangeEnd = this.cloneDate(newValue.end);
         const nextValue = newValue.end ?? newValue.start;
-        this.referenceDate = nextValue ? isValid.toDateExports.toDate(nextValue) : this.referenceDate;
+        this.referenceDate = nextValue ? datetimePickerPropsValidation.toDateExports.toDate(nextValue) : this.referenceDate;
         this.setComponentValue(nextValue);
     }
     /** Registra o listener global somente enquanto o picker está aberto. */
@@ -1223,17 +800,19 @@ const DatetimePicker = class {
      * Normaliza o modo antes da primeira renderização e aplica a data atual quando solicitado.
      */
     componentWillLoad() {
-        this.referenceDate = isValid.resolveSsrLocalDate(this.el, this.referenceDate);
+        // A inicialização dos defaults sincroniza os espelhos; preserve as entradas do consumidor.
+        const { serializedValue, valueAsDate } = this;
+        this.referenceDate = datetimePickerPropsValidation.resolveSsrLocalDate(this.el, this.referenceDate);
         this.initializeMode();
         this.initializeSelectionMode();
         this.initializeWeekStartsOn();
         this.initializeDisabledDates();
         this.initializeDefaultValue();
-        if (this.serializedValue !== undefined) {
-            this.restoreSerializedValue(this.serializedValue);
+        if (serializedValue !== undefined) {
+            this.restoreSerializedValue(serializedValue);
         }
-        else if (this.valueAsDate !== undefined) {
-            this.handleValueAsDateChange(this.valueAsDate);
+        else if (valueAsDate !== undefined) {
+            this.handleValueAsDateChange(valueAsDate);
         }
         this.initialFormValue = this.cloneDate(this.value);
         this.syncCanonicalValues();
@@ -1268,7 +847,7 @@ const DatetimePicker = class {
             this.rangeStart = null;
             this.rangeEnd = null;
         }
-        this.referenceDate = nextValue === null ? isValid.toDateExports.toDate(new Date()) : isValid.toDateExports.toDate(nextValue);
+        this.referenceDate = nextValue === null ? datetimePickerPropsValidation.toDateExports.toDate(new Date()) : datetimePickerPropsValidation.toDateExports.toDate(nextValue);
         this.setComponentValue(nextValue);
     }
     /** Retorna uma cópia do valor selecionado atualmente. */
@@ -1279,7 +858,7 @@ const DatetimePicker = class {
     async clear() {
         this.rangeStart = null;
         this.rangeEnd = null;
-        this.referenceDate = isValid.toDateExports.toDate(new Date());
+        this.referenceDate = datetimePickerPropsValidation.toDateExports.toDate(new Date());
         this.setComponentValue(null);
     }
     /** Abre o picker quando o componente estiver habilitado. */
@@ -1287,7 +866,7 @@ const DatetimePicker = class {
         if (this.isDisabled()) {
             return;
         }
-        this.referenceDate = this.value === null ? isValid.toDateExports.toDate(new Date()) : isValid.toDateExports.toDate(this.value);
+        this.referenceDate = this.value === null ? datetimePickerPropsValidation.toDateExports.toDate(new Date()) : datetimePickerPropsValidation.toDateExports.toDate(this.value);
         this.isPickerOpen = true;
     }
     /** Fecha o picker. */
@@ -1304,7 +883,8 @@ const DatetimePicker = class {
     }
     /** Move o foco para o input nativo interno. */
     async focusInput() {
-        this.getNativeInputElement()?.focus();
+        const input = this.datetimeInputElement ?? this.el.shadowRoot?.querySelector('br-datetime-input');
+        await input?.focusInput?.();
     }
     /** Define intervalo de datas de forma imperativa, forçando modo date e selectionMode range. */
     async setRange(start, end) {
@@ -1323,7 +903,7 @@ const DatetimePicker = class {
         this.rangeStart = this.cloneDate(normalizedStart);
         this.rangeEnd = this.cloneDate(normalizedEnd);
         const nextValue = normalizedEnd ?? normalizedStart;
-        this.referenceDate = nextValue === null ? isValid.toDateExports.toDate(new Date()) : isValid.toDateExports.toDate(nextValue);
+        this.referenceDate = nextValue === null ? datetimePickerPropsValidation.toDateExports.toDate(new Date()) : datetimePickerPropsValidation.toDateExports.toDate(nextValue);
         this.setComponentValue(nextValue);
     }
     /**
@@ -1398,7 +978,7 @@ const DatetimePicker = class {
      * @param value - Modo informado pelo consumidor do componente.
      */
     ensureValidSelectionMode(value) {
-        this.selectionMode = normalizeDatetimePickerSelectionMode(value);
+        this.selectionMode = datetimePickerPropsValidation.normalizeDatetimePickerSelectionMode(value);
     }
     /**
      * Normaliza o modo de seleção logo na inicialização.
@@ -1412,7 +992,7 @@ const DatetimePicker = class {
     }
     /** Valida o dia inicial da semana e corrige para padrão quando necessário. */
     ensureValidWeekStartsOn(value) {
-        this.weekStartsOn = normalizeDatetimePickerWeekStartsOn(value);
+        this.weekStartsOn = datetimePickerPropsValidation.normalizeDatetimePickerWeekStartsOn(value);
     }
     /**
      * Limpa o estado do intervalo de datas ao mudar para modo single.
@@ -1479,7 +1059,7 @@ const DatetimePicker = class {
      * @param value - Valor bruto recebido por prop/atributo ou método público.
      */
     syncDisabledDates(value) {
-        this.normalizedDisabledDates = normalizeDatetimePickerDisabledDates(value);
+        this.normalizedDisabledDates = datetimePickerPropsValidation.normalizeDatetimePickerDisabledDates(value);
         if (this.rangeStart !== null && this.isDateDisabled(this.rangeStart)) {
             this.rangeStart = null;
         }
@@ -1495,7 +1075,7 @@ const DatetimePicker = class {
      */
     initializeDefaultValue() {
         if (this.value instanceof Date && !Number.isNaN(this.value.getTime())) {
-            this.referenceDate = isValid.toDateExports.toDate(this.value);
+            this.referenceDate = datetimePickerPropsValidation.toDateExports.toDate(this.value);
             return;
         }
         this.value = null;
@@ -1510,9 +1090,9 @@ const DatetimePicker = class {
         if (this.isDisabled()) {
             return;
         }
-        const normalizedSelection = normalizeDatetimePickerInitialMoment(selection);
+        const normalizedSelection = datetimePickerPropsValidation.normalizeDatetimePickerInitialMoment(selection);
         if (normalizedSelection === 'now') {
-            const now = isValid.toDateExports.toDate(new Date());
+            const now = datetimePickerPropsValidation.toDateExports.toDate(new Date());
             this.referenceDate = now;
             this.setComponentValue(now, shouldEmitEvents);
             return;
@@ -1523,7 +1103,7 @@ const DatetimePicker = class {
             this.setComponentValue(null, shouldEmitEvents);
             return;
         }
-        const selectedDate = isValid.toDateExports.toDate(normalizedSelection);
+        const selectedDate = datetimePickerPropsValidation.toDateExports.toDate(normalizedSelection);
         if (this.isDateDisabled(selectedDate)) {
             this.setComponentValue(null, shouldEmitEvents);
             return;
@@ -1564,7 +1144,7 @@ const DatetimePicker = class {
             return null;
         }
         if (value instanceof Date) {
-            return Number.isNaN(value.getTime()) ? null : isValid.toDateExports.toDate(value);
+            return Number.isNaN(value.getTime()) ? null : datetimePickerPropsValidation.toDateExports.toDate(value);
         }
         return parseDatetimePickerSerializedValue(value, mode, this.referenceDate);
     }
@@ -1589,7 +1169,7 @@ const DatetimePicker = class {
     }
     /** Retorna o mesmo valor que será submetido pelo ElementInternals. */
     getSerializedValue() {
-        const zero = (date) => (date === null ? null : isValid.setExports.set(date, { seconds: 0, milliseconds: 0 }));
+        const zero = (date) => (date === null ? null : datetimePickerPropsValidation.setExports.set(date, { seconds: 0, milliseconds: 0 }));
         return (serializeDatetimePickerFormValue(this.value === null ? null : zero(this.value), {
             mode: this.mode,
             selectionMode: this.selectionMode,
@@ -1601,12 +1181,9 @@ const DatetimePicker = class {
     sameDate(left, right) {
         return left === right || (left !== null && right !== null && left.getTime() === right.getTime());
     }
-    /** Busca o input nativo interno para ações imperativas de foco. */
+    /** Retorna a âncora de validação, ou undefined antes do primeiro render. */
     getNativeInputElement() {
-        return this.el.shadowRoot
-            ?.querySelector('br-datetime-input')
-            ?.shadowRoot?.querySelector('br-input')
-            ?.shadowRoot?.querySelector('input');
+        return (this.datetimeInputElement ?? this.el.shadowRoot?.querySelector('br-datetime-input') ?? undefined);
     }
     /** Atualiza estado interno, FormData e validação com uma única chamada. */
     setComponentValue(nextValue, shouldEmitPublicEvent = true) {
@@ -1645,11 +1222,11 @@ const DatetimePicker = class {
     buildRangeDatesState(start, end) {
         const intervalStart = start.getTime() <= end.getTime() ? start : end;
         const intervalEnd = start.getTime() <= end.getTime() ? end : start;
-        return isValid.eachDayOfIntervalExports.eachDayOfInterval({
+        return datetimePickerPropsValidation.eachDayOfIntervalExports.eachDayOfInterval({
             start: intervalStart,
             end: intervalEnd,
         }).map((date) => ({
-            date: isValid.toDateExports.toDate(date),
+            date: datetimePickerPropsValidation.toDateExports.toDate(date),
             disabled: this.isDateDisabled(date),
         }));
     }
@@ -1660,7 +1237,7 @@ const DatetimePicker = class {
             this.rangeStart = null;
             this.rangeEnd = null;
         }
-        this.referenceDate = nextValue === null ? isValid.toDateExports.toDate(new Date()) : isValid.toDateExports.toDate(nextValue);
+        this.referenceDate = nextValue === null ? datetimePickerPropsValidation.toDateExports.toDate(new Date()) : datetimePickerPropsValidation.toDateExports.toDate(nextValue);
         this.syncCanonicalValues();
         this.updateFormInternals();
     }
@@ -1677,7 +1254,7 @@ const DatetimePicker = class {
     /** Atualiza o valor submetido no FormData do form-associated custom element. */
     syncFormValue() {
         try {
-            const zero = (d) => (d === null ? null : isValid.setExports.set(d, { seconds: 0, milliseconds: 0 }));
+            const zero = (d) => (d === null ? null : datetimePickerPropsValidation.setExports.set(d, { seconds: 0, milliseconds: 0 }));
             const nextValue = this.isDisabled()
                 ? null
                 : serializeDatetimePickerFormValue(this.value === null ? null : zero(this.value), {
@@ -1705,8 +1282,8 @@ const DatetimePicker = class {
                 selectionMode: this.selectionMode,
                 rangeStart: this.rangeStart,
                 rangeEnd: this.rangeEnd});
-            const min = this.parseConstraintValue(this.min);
-            const max = this.parseConstraintValue(this.max);
+            const min = this.parseConstraintValue(this.min, 'min');
+            const max = this.parseConstraintValue(this.max, 'max');
             const values = this.selectionMode === 'range' ? [this.rangeStart, this.rangeEnd] : [this.value];
             const rangeUnderflow = min !== null && values.some((value) => value !== null && value.getTime() < min.getTime());
             const rangeOverflow = max !== null && values.some((value) => value !== null && value.getTime() > max.getTime());
@@ -1737,15 +1314,25 @@ const DatetimePicker = class {
             // Ambientes sem ElementInternals completo não devem falhar.
         }
     }
-    parseConstraintValue(value) {
-        return value === null ? null : this.parseMethodValue(value, this.mode);
+    parseConstraintValue(value, propertyName) {
+        if (value === null)
+            return null;
+        if (!(value instanceof Date) && typeof value !== 'string') {
+            propWarning.reportInvalidPropValue(this.el, propertyName, value, 'Informe uma data válida como Date ou string compatível com o modo atual.', 'Aplicando fallback null (sem limite).');
+            return null;
+        }
+        const parsedValue = this.parseMethodValue(value, this.mode);
+        if (parsedValue !== null)
+            return parsedValue;
+        propWarning.reportInvalidPropValue(this.el, propertyName, value, 'Informe uma data válida como Date ou string compatível com o modo atual.', 'Aplicando fallback null (sem limite).');
+        return null;
     }
     isDisabled() {
         return validator.isFormControlDisabled(this.disabled, this.formDisabled);
     }
     /** Duplica datas para evitar compartilhamento de referência mutável. */
     cloneDate(value) {
-        return value === null ? null : isValid.toDateExports.toDate(value);
+        return value === null ? null : datetimePickerPropsValidation.toDateExports.toDate(value);
     }
     /**
      * Verifica se a data pertence ao conjunto de dias bloqueados.
@@ -1754,7 +1341,7 @@ const DatetimePicker = class {
      * @returns `true` quando o dia estiver desabilitado.
      */
     isDateDisabled(date) {
-        return this.normalizedDisabledDates.some((disabledDate) => isValid.isSameDayExports.isSameDay(disabledDate, date));
+        return this.normalizedDisabledDates.some((disabledDate) => datetimePickerPropsValidation.isSameDayExports.isSameDay(disabledDate, date));
     }
     /**
      * Corrige valores inválidos para o modo padrão, preservando a consistência do estado refletido.
@@ -1762,7 +1349,7 @@ const DatetimePicker = class {
      * @param value - Modo informado pelo consumidor do componente.
      */
     ensureValidMode(value) {
-        const normalizedMode = normalizeDatetimePickerMode(value);
+        const normalizedMode = datetimePickerPropsValidation.normalizeDatetimePickerMode(value);
         if (normalizedMode !== value) {
             this.mode = normalizedMode;
         }
@@ -1796,7 +1383,9 @@ const DatetimePicker = class {
     }
     /** Renderiza o campo de entrada responsável por abrir e sincronizar o picker. */
     renderInputField() {
-        return (index.h("br-datetime-input", { referenceDate: this.referenceDate, value: this.value, selectionMode: this.selectionMode, rangeStart: this.rangeStart, rangeEnd: this.rangeEnd, placeholder: this.placeholder, mode: this.mode, disabled: this.isDisabled(), onDateStateChange: this.handleDateStateChange, onTogglePicker: this.handleTogglePicker, exportparts: "container: input-container, input: input-field, icon: input-icon" }));
+        return (index.h("br-datetime-input", { ref: (element) => {
+                this.datetimeInputElement = element;
+            }, referenceDate: this.referenceDate, value: this.value, selectionMode: this.selectionMode, rangeStart: this.rangeStart, rangeEnd: this.rangeEnd, placeholder: this.placeholder, mode: this.mode, disabled: this.isDisabled(), onDateStateChange: this.handleDateStateChange, onTogglePicker: this.handleTogglePicker, exportparts: "container: input-container, input: input-field, icon: input-icon" }));
     }
     /** Renderiza apenas o seletor de data. */
     renderDatePicker() {
@@ -1831,7 +1420,7 @@ const DatetimePicker = class {
      * Renderização principal do componente.
      */
     render() {
-        return (index.h(index.Host, { key: '906849439dfc93b18952963b95e35da332e5018b', onKeyDown: this.handlePickerKeydown, "aria-busy": this.isValidating ? 'true' : null, "aria-describedby": this.hasFeedbackSlot || this.customValidationMessage || this.validatorMessage ? this.feedbackId : null, "aria-errormessage": this.customValidationMessage || this.validatorMessage || this.hasFeedbackSlot ? this.feedbackId : null }, index.h("div", { key: '8a77432dc84c6897d7ffb2e403f72d42e333230a', class: this.getCssClassMap(), part: "container" }, this.renderInputField(), this.renderPickerContent()), index.h("div", { key: '1e3f4df6f301fbb54d76eea49848ec7910bc3f33', id: this.feedbackId, part: "feedback", hidden: !this.hasFeedbackSlot && !this.customValidationMessage && !this.validatorMessage }, index.h("slot", { key: '7000d3c447c5bfa1f674c78024a1e58ca69652a3', name: "feedback", onSlotchange: (event) => (this.hasFeedbackSlot = slot.hasAssignedSlotContent(event.currentTarget)) }), !this.hasFeedbackSlot && (this.customValidationMessage || this.validatorMessage) ? (index.h("br-message", { state: "danger", message: this.customValidationMessage || this.validatorMessage })) : null)));
+        return (index.h(index.Host, { key: 'b964215e48b1871bf6ab1b045612f3d166543177', onKeyDown: this.handlePickerKeydown, "aria-busy": this.isValidating ? 'true' : null, "aria-describedby": this.hasFeedbackSlot || this.customValidationMessage || this.validatorMessage ? this.feedbackId : null, "aria-errormessage": this.customValidationMessage || this.validatorMessage || this.hasFeedbackSlot ? this.feedbackId : null }, index.h("div", { key: '50ba10963ba4e8bdf7c70f0d4513eea657692df8', class: this.getCssClassMap(), part: "container" }, this.renderInputField(), this.renderPickerContent()), index.h("div", { key: 'b220e70a85d8ba941dabed18a5a0dcdc9a99124f', id: this.feedbackId, part: "feedback", hidden: !this.hasFeedbackSlot && !this.customValidationMessage && !this.validatorMessage }, index.h("slot", { key: 'cdcc69b126491b2cea3b634066f1e4071c1c3b61', name: "feedback", onSlotchange: (event) => (this.hasFeedbackSlot = slot.hasAssignedSlotContent(event.currentTarget)) }), !this.hasFeedbackSlot && (this.customValidationMessage || this.validatorMessage) ? (index.h("br-message", { state: "danger", message: this.customValidationMessage || this.validatorMessage })) : null)));
     }
     static get formAssociated() { return true; }
     get el() { return index.getElement(this); }
@@ -1880,7 +1469,6 @@ const DatetimePicker = class {
             }]
     }; }
 };
-let datetimePickerId = 0;
 DatetimePicker.style = datetimePickerCss();
 
 exports.br_datetime_picker = DatetimePicker;