@aurodesignsystem-dev/auro-datetime 0.0.0-pr111.0 → 0.0.0-pr112.1

package/demo/index.min.js

@@ -1,4 +1,598 @@
-import { A as AuroDatetime } from './auro-datetime.min.js';
+// Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
+
+// ---------------------------------------------------------------------
+
+/* eslint-disable line-comment-position, no-inline-comments, no-confusing-arrow, no-nested-ternary, implicit-arrow-linebreak */
+
+class AuroLibraryRuntimeUtils {
+
+  /* eslint-disable jsdoc/require-param */
+
+  /**
+   * This will register a new custom element with the browser.
+   * @param {String} name - The name of the custom element.
+   * @param {Object} componentClass - The class to register as a custom element.
+   * @returns {void}
+   */
+  registerComponent(name, componentClass) {
+    if (!customElements.get(name)) {
+      customElements.define(name, class extends componentClass {});
+    }
+  }
+
+  /**
+   * Finds and returns the closest HTML Element based on a selector.
+   * @returns {void}
+   */
+  closestElement(
+    selector, // selector like in .closest()
+    base = this, // extra functionality to skip a parent
+    __Closest = (el, found = el && el.closest(selector)) =>
+      !el || el === document || el === window
+        ? null // standard .closest() returns null for non-found selectors also
+        : found
+          ? found // found a selector INside this element
+          : __Closest(el.getRootNode().host) // recursion!! break out to parent DOM
+  ) {
+    return __Closest(base);
+  }
+  /* eslint-enable jsdoc/require-param */
+
+  /**
+   * If the element passed is registered with a different tag name than what is passed in, the tag name is added as an attribute to the element.
+   * @param {Object} elem - The element to check.
+   * @param {String} tagName - The name of the Auro component to check for or add as an attribute.
+   * @returns {void}
+   */
+  handleComponentTagRename(elem, tagName) {
+    const tag = tagName.toLowerCase();
+    const elemTag = elem.tagName.toLowerCase();
+
+    if (elemTag !== tag) {
+      elem.setAttribute(tag, true);
+    }
+  }
+
+  /**
+   * Validates if an element is a specific Auro component.
+   * @param {Object} elem - The element to validate.
+   * @param {String} tagName - The name of the Auro component to check against.
+   * @returns {Boolean} - Returns true if the element is the specified Auro component.
+   */
+  elementMatch(elem, tagName) {
+    const tag = tagName.toLowerCase();
+    const elemTag = elem.tagName.toLowerCase();
+
+    return elemTag === tag || elem.hasAttribute(tag);
+  }
+
+  /**
+   * Gets the text content of a named slot.
+   * @returns {String}
+   * @private
+   */
+  getSlotText(elem, name) {
+    const slot = elem.shadowRoot?.querySelector(`slot[name="${name}"]`);
+    const nodes = slot?.assignedNodes({ flatten: true }) || [];
+    const text = nodes.map(n => n.textContent?.trim()).join(' ').trim();
+
+    return text || null;
+  }
+}
+
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const t$1=globalThis,e$2=t$1.ShadowRoot&&(void 0===t$1.ShadyCSS||t$1.ShadyCSS.nativeShadow)&&"adoptedStyleSheets"in Document.prototype&&"replace"in CSSStyleSheet.prototype,s$2=Symbol(),o$3=new WeakMap;let n$2 = class n{constructor(t,e,o){if(this._$cssResult$=true,o!==s$2)throw Error("CSSResult is not constructable. Use `unsafeCSS` or `css` instead.");this.cssText=t,this.t=e;}get styleSheet(){let t=this.o;const s=this.t;if(e$2&&void 0===t){const e=void 0!==s&&1===s.length;e&&(t=o$3.get(s)),void 0===t&&((this.o=t=new CSSStyleSheet).replaceSync(this.cssText),e&&o$3.set(s,t));}return t}toString(){return this.cssText}};const r$2=t=>new n$2("string"==typeof t?t:t+"",void 0,s$2),S$1=(s,o)=>{if(e$2)s.adoptedStyleSheets=o.map(t=>t instanceof CSSStyleSheet?t:t.styleSheet);else for(const e of o){const o=document.createElement("style"),n=t$1.litNonce;void 0!==n&&o.setAttribute("nonce",n),o.textContent=e.cssText,s.appendChild(o);}},c$2=e$2?t=>t:t=>t instanceof CSSStyleSheet?(t=>{let e="";for(const s of t.cssRules)e+=s.cssText;return r$2(e)})(t):t;
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const{is:i$2,defineProperty:e$1,getOwnPropertyDescriptor:h$1,getOwnPropertyNames:r$1,getOwnPropertySymbols:o$2,getPrototypeOf:n$1}=Object,a$1=globalThis,c$1=a$1.trustedTypes,l$1=c$1?c$1.emptyScript:"",p$1=a$1.reactiveElementPolyfillSupport,d$1=(t,s)=>t,u$1={toAttribute(t,s){switch(s){case Boolean:t=t?l$1:null;break;case Object:case Array:t=null==t?t:JSON.stringify(t);}return t},fromAttribute(t,s){let i=t;switch(s){case Boolean:i=null!==t;break;case Number:i=null===t?null:Number(t);break;case Object:case Array:try{i=JSON.parse(t);}catch(t){i=null;}}return i}},f$1=(t,s)=>!i$2(t,s),b$1={attribute:true,type:String,converter:u$1,reflect:false,useDefault:false,hasChanged:f$1};Symbol.metadata??=Symbol("metadata"),a$1.litPropertyMetadata??=new WeakMap;let y$1 = class y extends HTMLElement{static addInitializer(t){this._$Ei(),(this.l??=[]).push(t);}static get observedAttributes(){return this.finalize(),this._$Eh&&[...this._$Eh.keys()]}static createProperty(t,s=b$1){if(s.state&&(s.attribute=false),this._$Ei(),this.prototype.hasOwnProperty(t)&&((s=Object.create(s)).wrapped=true),this.elementProperties.set(t,s),!s.noAccessor){const i=Symbol(),h=this.getPropertyDescriptor(t,i,s);void 0!==h&&e$1(this.prototype,t,h);}}static getPropertyDescriptor(t,s,i){const{get:e,set:r}=h$1(this.prototype,t)??{get(){return this[s]},set(t){this[s]=t;}};return {get:e,set(s){const h=e?.call(this);r?.call(this,s),this.requestUpdate(t,h,i);},configurable:true,enumerable:true}}static getPropertyOptions(t){return this.elementProperties.get(t)??b$1}static _$Ei(){if(this.hasOwnProperty(d$1("elementProperties")))return;const t=n$1(this);t.finalize(),void 0!==t.l&&(this.l=[...t.l]),this.elementProperties=new Map(t.elementProperties);}static finalize(){if(this.hasOwnProperty(d$1("finalized")))return;if(this.finalized=true,this._$Ei(),this.hasOwnProperty(d$1("properties"))){const t=this.properties,s=[...r$1(t),...o$2(t)];for(const i of s)this.createProperty(i,t[i]);}const t=this[Symbol.metadata];if(null!==t){const s=litPropertyMetadata.get(t);if(void 0!==s)for(const[t,i]of s)this.elementProperties.set(t,i);}this._$Eh=new Map;for(const[t,s]of this.elementProperties){const i=this._$Eu(t,s);void 0!==i&&this._$Eh.set(i,t);}this.elementStyles=this.finalizeStyles(this.styles);}static finalizeStyles(s){const i=[];if(Array.isArray(s)){const e=new Set(s.flat(1/0).reverse());for(const s of e)i.unshift(c$2(s));}else void 0!==s&&i.push(c$2(s));return i}static _$Eu(t,s){const i=s.attribute;return  false===i?void 0:"string"==typeof i?i:"string"==typeof t?t.toLowerCase():void 0}constructor(){super(),this._$Ep=void 0,this.isUpdatePending=false,this.hasUpdated=false,this._$Em=null,this._$Ev();}_$Ev(){this._$ES=new Promise(t=>this.enableUpdating=t),this._$AL=new Map,this._$E_(),this.requestUpdate(),this.constructor.l?.forEach(t=>t(this));}addController(t){(this._$EO??=new Set).add(t),void 0!==this.renderRoot&&this.isConnected&&t.hostConnected?.();}removeController(t){this._$EO?.delete(t);}_$E_(){const t=new Map,s=this.constructor.elementProperties;for(const i of s.keys())this.hasOwnProperty(i)&&(t.set(i,this[i]),delete this[i]);t.size>0&&(this._$Ep=t);}createRenderRoot(){const t=this.shadowRoot??this.attachShadow(this.constructor.shadowRootOptions);return S$1(t,this.constructor.elementStyles),t}connectedCallback(){this.renderRoot??=this.createRenderRoot(),this.enableUpdating(true),this._$EO?.forEach(t=>t.hostConnected?.());}enableUpdating(t){}disconnectedCallback(){this._$EO?.forEach(t=>t.hostDisconnected?.());}attributeChangedCallback(t,s,i){this._$AK(t,i);}_$ET(t,s){const i=this.constructor.elementProperties.get(t),e=this.constructor._$Eu(t,i);if(void 0!==e&&true===i.reflect){const h=(void 0!==i.converter?.toAttribute?i.converter:u$1).toAttribute(s,i.type);this._$Em=t,null==h?this.removeAttribute(e):this.setAttribute(e,h),this._$Em=null;}}_$AK(t,s){const i=this.constructor,e=i._$Eh.get(t);if(void 0!==e&&this._$Em!==e){const t=i.getPropertyOptions(e),h="function"==typeof t.converter?{fromAttribute:t.converter}:void 0!==t.converter?.fromAttribute?t.converter:u$1;this._$Em=e;const r=h.fromAttribute(s,t.type);this[e]=r??this._$Ej?.get(e)??r,this._$Em=null;}}requestUpdate(t,s,i,e=false,h){if(void 0!==t){const r=this.constructor;if(false===e&&(h=this[t]),i??=r.getPropertyOptions(t),!((i.hasChanged??f$1)(h,s)||i.useDefault&&i.reflect&&h===this._$Ej?.get(t)&&!this.hasAttribute(r._$Eu(t,i))))return;this.C(t,s,i);} false===this.isUpdatePending&&(this._$ES=this._$EP());}C(t,s,{useDefault:i,reflect:e,wrapped:h},r){i&&!(this._$Ej??=new Map).has(t)&&(this._$Ej.set(t,r??s??this[t]),true!==h||void 0!==r)||(this._$AL.has(t)||(this.hasUpdated||i||(s=void 0),this._$AL.set(t,s)),true===e&&this._$Em!==t&&(this._$Eq??=new Set).add(t));}async _$EP(){this.isUpdatePending=true;try{await this._$ES;}catch(t){Promise.reject(t);}const t=this.scheduleUpdate();return null!=t&&await t,!this.isUpdatePending}scheduleUpdate(){return this.performUpdate()}performUpdate(){if(!this.isUpdatePending)return;if(!this.hasUpdated){if(this.renderRoot??=this.createRenderRoot(),this._$Ep){for(const[t,s]of this._$Ep)this[t]=s;this._$Ep=void 0;}const t=this.constructor.elementProperties;if(t.size>0)for(const[s,i]of t){const{wrapped:t}=i,e=this[s];true!==t||this._$AL.has(s)||void 0===e||this.C(s,void 0,i,e);}}let t=false;const s=this._$AL;try{t=this.shouldUpdate(s),t?(this.willUpdate(s),this._$EO?.forEach(t=>t.hostUpdate?.()),this.update(s)):this._$EM();}catch(s){throw t=false,this._$EM(),s}t&&this._$AE(s);}willUpdate(t){}_$AE(t){this._$EO?.forEach(t=>t.hostUpdated?.()),this.hasUpdated||(this.hasUpdated=true,this.firstUpdated(t)),this.updated(t);}_$EM(){this._$AL=new Map,this.isUpdatePending=false;}get updateComplete(){return this.getUpdateComplete()}getUpdateComplete(){return this._$ES}shouldUpdate(t){return  true}update(t){this._$Eq&&=this._$Eq.forEach(t=>this._$ET(t,this[t])),this._$EM();}updated(t){}firstUpdated(t){}};y$1.elementStyles=[],y$1.shadowRootOptions={mode:"open"},y$1[d$1("elementProperties")]=new Map,y$1[d$1("finalized")]=new Map,p$1?.({ReactiveElement:y$1}),(a$1.reactiveElementVersions??=[]).push("2.1.2");
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const t=globalThis,i$1=t=>t,s$1=t.trustedTypes,e=s$1?s$1.createPolicy("lit-html",{createHTML:t=>t}):void 0,h="$lit$",o$1=`lit$${Math.random().toFixed(9).slice(2)}$`,n="?"+o$1,r=`<${n}>`,l=document,c=()=>l.createComment(""),a=t=>null===t||"object"!=typeof t&&"function"!=typeof t,u=Array.isArray,d=t=>u(t)||"function"==typeof t?.[Symbol.iterator],f="[ \t\n\f\r]",v=/<(?:(!--|\/[^a-zA-Z])|(\/?[a-zA-Z][^>\s]*)|(\/?$))/g,_=/-->/g,m=/>/g,p=RegExp(`>|${f}(?:([^\\s"'>=/]+)(${f}*=${f}*(?:[^ \t\n\f\r"'\`<>=]|("|')|))|$)`,"g"),g=/'/g,$=/"/g,y=/^(?:script|style|textarea|title)$/i,x=t=>(i,...s)=>({_$litType$:t,strings:i,values:s}),b=x(1),E=Symbol.for("lit-noChange"),A=Symbol.for("lit-nothing"),C=new WeakMap,P=l.createTreeWalker(l,129);function V(t,i){if(!u(t)||!t.hasOwnProperty("raw"))throw Error("invalid template strings array");return void 0!==e?e.createHTML(i):i}const N=(t,i)=>{const s=t.length-1,e=[];let n,l=2===i?"<svg>":3===i?"<math>":"",c=v;for(let i=0;i<s;i++){const s=t[i];let a,u,d=-1,f=0;for(;f<s.length&&(c.lastIndex=f,u=c.exec(s),null!==u);)f=c.lastIndex,c===v?"!--"===u[1]?c=_:void 0!==u[1]?c=m:void 0!==u[2]?(y.test(u[2])&&(n=RegExp("</"+u[2],"g")),c=p):void 0!==u[3]&&(c=p):c===p?">"===u[0]?(c=n??v,d=-1):void 0===u[1]?d=-2:(d=c.lastIndex-u[2].length,a=u[1],c=void 0===u[3]?p:'"'===u[3]?$:g):c===$||c===g?c=p:c===_||c===m?c=v:(c=p,n=void 0);const x=c===p&&t[i+1].startsWith("/>")?" ":"";l+=c===v?s+r:d>=0?(e.push(a),s.slice(0,d)+h+s.slice(d)+o$1+x):s+o$1+(-2===d?i:x);}return [V(t,l+(t[s]||"<?>")+(2===i?"</svg>":3===i?"</math>":"")),e]};class S{constructor({strings:t,_$litType$:i},e){let r;this.parts=[];let l=0,a=0;const u=t.length-1,d=this.parts,[f,v]=N(t,i);if(this.el=S.createElement(f,e),P.currentNode=this.el.content,2===i||3===i){const t=this.el.content.firstChild;t.replaceWith(...t.childNodes);}for(;null!==(r=P.nextNode())&&d.length<u;){if(1===r.nodeType){if(r.hasAttributes())for(const t of r.getAttributeNames())if(t.endsWith(h)){const i=v[a++],s=r.getAttribute(t).split(o$1),e=/([.?@])?(.*)/.exec(i);d.push({type:1,index:l,name:e[2],strings:s,ctor:"."===e[1]?I:"?"===e[1]?L:"@"===e[1]?z:H}),r.removeAttribute(t);}else t.startsWith(o$1)&&(d.push({type:6,index:l}),r.removeAttribute(t));if(y.test(r.tagName)){const t=r.textContent.split(o$1),i=t.length-1;if(i>0){r.textContent=s$1?s$1.emptyScript:"";for(let s=0;s<i;s++)r.append(t[s],c()),P.nextNode(),d.push({type:2,index:++l});r.append(t[i],c());}}}else if(8===r.nodeType)if(r.data===n)d.push({type:2,index:l});else {let t=-1;for(;-1!==(t=r.data.indexOf(o$1,t+1));)d.push({type:7,index:l}),t+=o$1.length-1;}l++;}}static createElement(t,i){const s=l.createElement("template");return s.innerHTML=t,s}}function M(t,i,s=t,e){if(i===E)return i;let h=void 0!==e?s._$Co?.[e]:s._$Cl;const o=a(i)?void 0:i._$litDirective$;return h?.constructor!==o&&(h?._$AO?.(false),void 0===o?h=void 0:(h=new o(t),h._$AT(t,s,e)),void 0!==e?(s._$Co??=[])[e]=h:s._$Cl=h),void 0!==h&&(i=M(t,h._$AS(t,i.values),h,e)),i}class R{constructor(t,i){this._$AV=[],this._$AN=void 0,this._$AD=t,this._$AM=i;}get parentNode(){return this._$AM.parentNode}get _$AU(){return this._$AM._$AU}u(t){const{el:{content:i},parts:s}=this._$AD,e=(t?.creationScope??l).importNode(i,true);P.currentNode=e;let h=P.nextNode(),o=0,n=0,r=s[0];for(;void 0!==r;){if(o===r.index){let i;2===r.type?i=new k(h,h.nextSibling,this,t):1===r.type?i=new r.ctor(h,r.name,r.strings,this,t):6===r.type&&(i=new Z(h,this,t)),this._$AV.push(i),r=s[++n];}o!==r?.index&&(h=P.nextNode(),o++);}return P.currentNode=l,e}p(t){let i=0;for(const s of this._$AV) void 0!==s&&(void 0!==s.strings?(s._$AI(t,s,i),i+=s.strings.length-2):s._$AI(t[i])),i++;}}class k{get _$AU(){return this._$AM?._$AU??this._$Cv}constructor(t,i,s,e){this.type=2,this._$AH=A,this._$AN=void 0,this._$AA=t,this._$AB=i,this._$AM=s,this.options=e,this._$Cv=e?.isConnected??true;}get parentNode(){let t=this._$AA.parentNode;const i=this._$AM;return void 0!==i&&11===t?.nodeType&&(t=i.parentNode),t}get startNode(){return this._$AA}get endNode(){return this._$AB}_$AI(t,i=this){t=M(this,t,i),a(t)?t===A||null==t||""===t?(this._$AH!==A&&this._$AR(),this._$AH=A):t!==this._$AH&&t!==E&&this._(t):void 0!==t._$litType$?this.$(t):void 0!==t.nodeType?this.T(t):d(t)?this.k(t):this._(t);}O(t){return this._$AA.parentNode.insertBefore(t,this._$AB)}T(t){this._$AH!==t&&(this._$AR(),this._$AH=this.O(t));}_(t){this._$AH!==A&&a(this._$AH)?this._$AA.nextSibling.data=t:this.T(l.createTextNode(t)),this._$AH=t;}$(t){const{values:i,_$litType$:s}=t,e="number"==typeof s?this._$AC(t):(void 0===s.el&&(s.el=S.createElement(V(s.h,s.h[0]),this.options)),s);if(this._$AH?._$AD===e)this._$AH.p(i);else {const t=new R(e,this),s=t.u(this.options);t.p(i),this.T(s),this._$AH=t;}}_$AC(t){let i=C.get(t.strings);return void 0===i&&C.set(t.strings,i=new S(t)),i}k(t){u(this._$AH)||(this._$AH=[],this._$AR());const i=this._$AH;let s,e=0;for(const h of t)e===i.length?i.push(s=new k(this.O(c()),this.O(c()),this,this.options)):s=i[e],s._$AI(h),e++;e<i.length&&(this._$AR(s&&s._$AB.nextSibling,e),i.length=e);}_$AR(t=this._$AA.nextSibling,s){for(this._$AP?.(false,true,s);t!==this._$AB;){const s=i$1(t).nextSibling;i$1(t).remove(),t=s;}}setConnected(t){ void 0===this._$AM&&(this._$Cv=t,this._$AP?.(t));}}class H{get tagName(){return this.element.tagName}get _$AU(){return this._$AM._$AU}constructor(t,i,s,e,h){this.type=1,this._$AH=A,this._$AN=void 0,this.element=t,this.name=i,this._$AM=e,this.options=h,s.length>2||""!==s[0]||""!==s[1]?(this._$AH=Array(s.length-1).fill(new String),this.strings=s):this._$AH=A;}_$AI(t,i=this,s,e){const h=this.strings;let o=false;if(void 0===h)t=M(this,t,i,0),o=!a(t)||t!==this._$AH&&t!==E,o&&(this._$AH=t);else {const e=t;let n,r;for(t=h[0],n=0;n<h.length-1;n++)r=M(this,e[s+n],i,n),r===E&&(r=this._$AH[n]),o||=!a(r)||r!==this._$AH[n],r===A?t=A:t!==A&&(t+=(r??"")+h[n+1]),this._$AH[n]=r;}o&&!e&&this.j(t);}j(t){t===A?this.element.removeAttribute(this.name):this.element.setAttribute(this.name,t??"");}}class I extends H{constructor(){super(...arguments),this.type=3;}j(t){this.element[this.name]=t===A?void 0:t;}}class L extends H{constructor(){super(...arguments),this.type=4;}j(t){this.element.toggleAttribute(this.name,!!t&&t!==A);}}class z extends H{constructor(t,i,s,e,h){super(t,i,s,e,h),this.type=5;}_$AI(t,i=this){if((t=M(this,t,i,0)??A)===E)return;const s=this._$AH,e=t===A&&s!==A||t.capture!==s.capture||t.once!==s.once||t.passive!==s.passive,h=t!==A&&(s===A||e);e&&this.element.removeEventListener(this.name,this,s),h&&this.element.addEventListener(this.name,this,t),this._$AH=t;}handleEvent(t){"function"==typeof this._$AH?this._$AH.call(this.options?.host??this.element,t):this._$AH.handleEvent(t);}}class Z{constructor(t,i,s){this.element=t,this.type=6,this._$AN=void 0,this._$AM=i,this.options=s;}get _$AU(){return this._$AM._$AU}_$AI(t){M(this,t);}}const B=t.litHtmlPolyfillSupport;B?.(S,k),(t.litHtmlVersions??=[]).push("3.3.2");const D=(t,i,s)=>{const e=s?.renderBefore??i;let h=e._$litPart$;if(void 0===h){const t=s?.renderBefore??null;e._$litPart$=h=new k(i.insertBefore(c(),t),t,void 0,s??{});}return h._$AI(t),h};
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const s=globalThis;class i extends y$1{constructor(){super(...arguments),this.renderOptions={host:this},this._$Do=void 0;}createRenderRoot(){const t=super.createRenderRoot();return this.renderOptions.renderBefore??=t.firstChild,t}update(t){const r=this.render();this.hasUpdated||(this.renderOptions.isConnected=this.isConnected),super.update(t),this._$Do=D(r,this.renderRoot,this.renderOptions);}connectedCallback(){super.connectedCallback(),this._$Do?.setConnected(true);}disconnectedCallback(){super.disconnectedCallback(),this._$Do?.setConnected(false);}render(){return E}}i._$litElement$=true,i["finalized"]=true,s.litElementHydrateSupport?.({LitElement:i});const o=s.litElementPolyfillSupport;o?.({LitElement:i});(s.litElementVersions??=[]).push("4.2.2");
+
+// Copyright (c) 2020 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
+
+
+const ISO_8601_REGEX =
+  /^(\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)?)(Z|[+-]\d{2}:\d{2})?$/u;
+
+/**
+ * Shows a date or time as text, formatted for a language and region you choose and, optionally, a specific time zone.
+ *
+ * **Key capabilities**
+ * - **What to show**: `type` picks the full date, the time, a numeric date, or a single part, such as the year or weekday.
+ * - **Date and time to show**: `value` takes an ISO 8601 date or date-time; without it, the element shows the current date and time.
+ * - **Language formatting**: `locale` formats month names, separators, and the 12- or 24-hour clock for a language, such as `de-DE`.
+ * - **Time zones**: `timezone` shows the moment in a time zone, such as `America/Los_Angeles`.
+ * - **Name length**: `month="long"` and `weekday="long"` spell out the month and weekday names.
+ *
+ * **Example**
+ * ```html
+ * <auro-datetime type="date" value="2022-07-14T08:00:00"></auro-datetime>
+ * ```
+ *
+ * @summary Date or time text formatted by language and time zone, with full, numeric, and single-part formats.
+ * @customElement auro-datetime
+ *
+ * @slot pre - Content shown before the date or time, such as "Departs". The element doesn't currently let content sit right against the date or time: this content, or text right before the element, always shows with a space between it and the date or time. {@category ui}
+ * @slot post - Content shown after the date or time, such as "local time". The element doesn't currently let content sit right against the date or time: this content, or text right after the element, always shows with a space between them, so a period or comma can't follow the date or time directly. {@category ui}
+ * @slot - Content shown after the `post` slot's content, such as the end of a sentence that includes the date. {@category ui}
+ */
+
+class AuroDatetime extends i {
+  constructor() {
+    super();
+
+    this._initializeDefaults();
+  }
+
+  /**
+   * Sets the element's default values.
+   * @private
+   * @returns {void}
+   */
+  _initializeDefaults() {
+    this.weekday = "short";
+    this.month = "short";
+    this.locale = "en-US";
+
+    /**
+     * Tracks invalid locale inputs already warned about, so a parent that
+     * re-renders with the same bad value doesn't flood the console.
+     * @private
+     */
+    this._warnedLocales = new Set();
+
+    /**
+     * Tracks invalid `timezone` values this element has already warned
+     * about, so the same bad value logs only one warning.
+     * @private
+     */
+    this._warnedTimeZones = new Set();
+
+    /**
+     * Tracks invalid `value` inputs this element has already warned about,
+     * so the same bad value logs only one warning.
+     * @private
+     */
+    this._warnedValues = new Set();
+
+    /**
+     * @private
+     */
+    this._effectiveLocale = this._resolveLocale(this.locale);
+
+    /**
+     * @private
+     */
+    this._effectiveTimeZone = this._resolveTimeZone(this.timezone);
+
+    /**
+     * @private
+     */
+    this.runtimeUtils = new AuroLibraryRuntimeUtils();
+  }
+
+  /**
+   * Checks a BCP 47 locale tag and returns its canonical form. Empty or invalid
+   * input falls back to "en-US". Each invalid value logs a console warning the
+   * first time this element sees it.
+   *
+   * @private
+   * @param {string} input - The locale tag set on the element.
+   * @returns {string} The canonical locale tag, such as "en-GB", or "en-US" for empty or invalid input.
+   */
+  _resolveLocale(input) {
+    if (!input) {
+      return "en-US";
+    }
+    try {
+      return Intl.getCanonicalLocales(input)[0];
+    } catch {
+      if (this._warnedLocales && !this._warnedLocales.has(input)) {
+        this._warnedLocales.add(input);
+        console.warn(
+          `auro-datetime: "${input}" is not a valid BCP 47 locale tag. Falling back to "en-US".`,
+        );
+      }
+      return "en-US";
+    }
+  }
+
+  /**
+   * Checks an IANA time zone name. An invalid name logs a console warning
+   * the first time this element sees it and returns `undefined`, so the
+   * element acts as if `timezone` isn't set.
+   *
+   * @private
+   * @param {string | undefined} input - The time zone name set on the element.
+   * @returns {string | undefined} The time zone name if it's valid; otherwise, `undefined`.
+   */
+  _resolveTimeZone(input) {
+    if (!input) {
+      return undefined;
+    }
+    try {
+      // Creating the formatter is enough to catch an invalid name. Without
+      // this check, a typo such as "America/Los_Angles" makes
+      // Intl.DateTimeFormat and toLocaleString throw a RangeError at render
+      // time.
+      new Intl.DateTimeFormat(undefined, { timeZone: input });
+      return input;
+    } catch {
+      if (this._warnedTimeZones && !this._warnedTimeZones.has(input)) {
+        this._warnedTimeZones.add(input);
+        console.warn(
+          `auro-datetime: "${input}" is not a valid IANA timezone. Ignoring it.`,
+        );
+      }
+      return undefined;
+    }
+  }
+
+  static get properties() {
+    return {
+      /**
+       * Sets the language and region used to format the date or time, such as `en-GB`, `de-DE`, or `ja-JP` (a BCP 47 language tag). It changes month and weekday names, separators, and whether times use a 12- or 24-hour clock, but not the time zone. A malformed tag logs a console warning and falls back to `en-US`; a well-formed tag the browser doesn't support, such as `zz-ZZ`, uses the browser's default language instead, with no warning.
+       * @type {string}
+       * @default "en-US"
+       * @category ui
+       */
+      locale: { type: String },
+
+      /**
+       * Sets how the month name is written: `short`, such as "Jul", or `long`, such as "July". It applies to the full date and to `type="month"`.
+       * @type {"short" | "long"}
+       * @default "short"
+       * @category ui
+       */
+      month: { type: String },
+
+      /**
+       * Sets the time zone to show the date or time in, such as `America/Los_Angeles` or `UTC` (an IANA time zone name). When `value` has an offset or `Z`, the element converts that moment into this zone; when it has none, the element reads `value` as a time already in this zone. Without it, or with an invalid name, which logs a console warning, the element shows the date and time in `value` as written, or the current date and time in the viewer's own time zone when `value` isn't set.
+       * @type {string}
+       * @category behavior
+       */
+      timezone: { type: String },
+
+      /**
+       * Sets which part of the date or time to show: `date` for the full date, such as "Thu, Jul 14, 2022", `numeric` for a numeric date, such as "7/14/2022", `time` for the hour and minute, such as "8:00 am", or `year`, `month`, `weekday`, or `day` for that part alone. Without it, or with any other value, the element shows the full date.
+       * @type {"date" | "time" | "year" | "month" | "weekday" | "day" | "numeric"}
+       * @category ui
+       */
+      type: { type: String },
+
+      /**
+       * Sets the date or time to show, as an ISO 8601 date or date-time, such as `2022-07-14`, `2022-07-14T08:00:00`, or `2022-07-14T08:00:00-07:00`. Without it, the element shows the current date and time from when it last rendered; it doesn't currently update as time passes. Invalid input, including an empty value, logs a console warning and shows nothing.
+       * @type {string}
+       * @category behavior
+       */
+      value: { type: String },
+
+      /**
+       * Sets how the weekday name is written: `short`, such as "Thu", or `long`, such as "Thursday". It applies to the full date and to `type="weekday"`.
+       * @type {"short" | "long"}
+       * @default "short"
+       * @category ui
+       */
+      weekday: { type: String },
+    };
+  }
+
+  /**
+   * Registers the element with the browser under a tag name. Use a custom name to run more than one version of the element on the same page. If the tag name is already registered, it does nothing.
+   * @param {string} [name="auro-datetime"] - The tag name to register the element under, such as `custom-datetime`.
+   * @returns {void}
+   *
+   * @example
+   * AuroDatetime.register("custom-datetime"); // registers <custom-datetime>
+   */
+  static register(name = "auro-datetime") {
+    AuroLibraryRuntimeUtils.prototype.registerComponent(name, AuroDatetime);
+  }
+
+  willUpdate(changedProperties) {
+    if (changedProperties.has("locale")) {
+      this._effectiveLocale = this._resolveLocale(this.locale);
+    }
+    if (changedProperties.has("timezone")) {
+      this._effectiveTimeZone = this._resolveTimeZone(this.timezone);
+    }
+  }
+
+  firstUpdated() {
+    // Adds the tag name as an attribute when it differs from auro-datetime.
+    this.runtimeUtils.handleComponentTagRename(this, "auro-datetime");
+  }
+
+  /**
+   * Creates a Date that shows the given wall-clock time when displayed in
+   * the given IANA time zone. `_resolveInputDate` uses it when `value` has
+   * no offset and `timezone` is set, so the time is read as already being
+   * in that zone rather than the viewer's.
+   *
+   * It parses the wall-clock time as if it were UTC, asks `Intl` what that
+   * moment looks like in the target zone, and uses the difference between
+   * the two to find the real moment.
+   *
+   * @private
+   * @param {string} localISO - The ISO 8601 date-time with no offset, such as "2022-07-14T08:00:00".
+   * @param {string} timeZone - The IANA time zone name, such as "America/New_York".
+   * @returns {Date} The moment that reads as `localISO` in `timeZone`.
+   */
+  _zonedWallClockToUtc(localISO, timeZone) {
+    const naiveUtc = new Date(`${localISO}Z`);
+    const parts = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      hourCycle: "h23",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+    }).formatToParts(naiveUtc);
+    const lookup = Object.fromEntries(
+      parts.filter((p) => p.type !== "literal").map((p) => [p.type, p.value]),
+    );
+    const seenInZone = new Date(
+      `${lookup.year}-${lookup.month}-${lookup.day}T${lookup.hour}:${lookup.minute}:${lookup.second}Z`,
+    );
+    const offsetMs = naiveUtc.getTime() - seenInZone.getTime();
+    return new Date(naiveUtc.getTime() + offsetMs);
+  }
+
+  /**
+   * Gets the Date to show and the `timeZone` option for `Intl.DateTimeFormat`,
+   * from `value` and `timezone`. Returns `{ date: null }` for invalid input,
+   * including an empty string.
+   *
+   * @private
+   * @returns {{ date: Date | null, timeZoneOption: string | undefined }} The Date to show, or `null` for invalid input, and the `timeZone` option to format it with.
+   */
+  _resolveInputDate() {
+    // How each case resolves:
+    // - `value` not set (null or undefined): the current date and time, in
+    //   `timezone` if it's set.
+    // - `value` invalid, including an empty string: logs a warning and
+    //   returns { date: null }. An empty string isn't the same as not set:
+    //   Lit gives value="" as an empty string, which isn't valid ISO 8601,
+    //   so it's reported as a likely mistake instead of showing the
+    //   current date.
+    // - `timezone` set and `value` has an offset or Z: reads `value` as an
+    //   exact moment and has toLocaleString convert it into `timezone`.
+    // - `timezone` set and `value` has no offset: reads `value` as a time
+    //   already in `timezone`, so every viewer sees it as written.
+    // - `timezone` not set: drops any offset or Z and reads the rest as
+    //   local time, so it shows as written.
+    const resolvedTz = this._effectiveTimeZone;
+
+    // Only true "omitted" inputs (null/undefined) get the current-date
+    // treatment. Empty string falls through to ISO validation, which
+    // fails and produces the documented warning and empty output.
+    if (this.value == null) {
+      return { date: new Date(), timeZoneOption: resolvedTz };
+    }
+
+    const match = this.value.match(ISO_8601_REGEX);
+    if (!match) {
+      if (!this._warnedValues.has(this.value)) {
+        this._warnedValues.add(this.value);
+        console.warn(
+          `auro-datetime: "${this.value}" is not a valid ISO 8601 string.`,
+        );
+      }
+      return { date: null, timeZoneOption: undefined };
+    }
+
+    const localPart = match[1];
+    const hasOffset = Boolean(match[2]);
+
+    // The regex permits an offset/Z suffix on a bare date (such as "2020-09-22Z"
+    // or "2020-09-22-07:00"). Those forms are not valid ISO 8601: an offset
+    // is only meaningful with a time component, and the wall-clock branch
+    // would silently drop the offset, producing surprising output. Reject
+    // them up front so the consumer sees a warning.
+    if (hasOffset && !localPart.includes("T")) {
+      if (!this._warnedValues.has(this.value)) {
+        this._warnedValues.add(this.value);
+        console.warn(
+          `auro-datetime: "${this.value}" is not a valid ISO 8601 string (offset/Z requires a time component).`,
+        );
+      }
+      return { date: null, timeZoneOption: undefined };
+    }
+
+    const normalized = localPart.includes("T")
+      ? localPart
+      : `${localPart}T00:00:00`;
+
+    // The regex only validates string shape, not value ranges: "2022-99-99"
+    // matches but produces an Invalid Date. Detect that and treat it like
+    // any other malformed input so render falls back to the documented
+    // empty output instead of "Invalid Date" or a thrown RangeError from
+    // downstream Intl calls.
+    const buildDate = () => {
+      if (resolvedTz && !hasOffset) {
+        return this._zonedWallClockToUtc(normalized, resolvedTz);
+      }
+      if (resolvedTz && hasOffset) {
+        return new Date(this.value);
+      }
+      // Wall-clock: keep the components in the input verbatim. JS parses
+      // bare "YYYY-MM-DD" as UTC midnight, which shifts the date in the
+      // viewer's timezone; appending a time forces local-time parsing.
+      return new Date(normalized);
+    };
+
+    const date = buildDate();
+    if (Number.isNaN(date.getTime())) {
+      if (!this._warnedValues.has(this.value)) {
+        this._warnedValues.add(this.value);
+        console.warn(
+          `auro-datetime: "${this.value}" is not a valid ISO 8601 date.`,
+        );
+      }
+      return { date: null, timeZoneOption: undefined };
+    }
+
+    return { date, timeZoneOption: resolvedTz };
+  }
+
+  /**
+   * Formats the full date, such as "Thu, Jul 14, 2022", with the current `month` and `weekday` settings.
+   * @private
+   * @returns {string} The formatted date, or an empty string when `value` is invalid.
+   */
+  humanDate() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    // Read month and weekday on every render so later changes show up.
+    const template = {
+      weekday: this.weekday || "short",
+      year: "numeric",
+      month: this.month || "short",
+      day: "numeric",
+    };
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Formats the single date part that `type` names: the year, month, weekday, or day.
+   * @private
+   * @returns {string} The formatted date, or an empty string when `value` is invalid.
+   */
+  humanDateConversion() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = {};
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+
+    switch (this.type) {
+      case "day":
+        template.day = "numeric";
+        break;
+      case "month":
+        template.month = this.month || "short";
+        break;
+      case "year":
+        template.year = "numeric";
+        break;
+      case "weekday":
+        template.weekday = this.weekday || "short";
+        break;
+    }
+
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Formats the date in numbers, in the order and with the separators `locale` uses, such as "7/14/2022" for `en-US`.
+   * @private
+   * @returns {string} The formatted date, or an empty string when `value` is invalid.
+   */
+  numericDate() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = { year: "numeric", month: "numeric", day: "numeric" };
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Formats the hour and minute. When the time ends in AM or PM, it lowercases the period and drops a leading zero.
+   * @private
+   * @returns {string} The formatted time, or an empty string when `value` is invalid.
+   */
+  humanTime() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = { hour: "2-digit", minute: "2-digit" };
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+
+    const formatted = date.toLocaleString(this._effectiveLocale, template);
+
+    // Detect a 12-hour rendered output by the presence of a Latin-script
+    // period marker. The pattern matches `am`, `pm`, `a.m.`, `p.m.`
+    // (case-insensitive), so it catches en-US (`PM`), en-AU/hi-IN (`pm`),
+    // and en-CA/es-MX (`p.m.`) alike. Non-Latin period markers (ko `오후`,
+    // ar `م`, zh-TW `下午`) have no ASCII a/p+m chars and correctly fall
+    // through unchanged. 24h locales (en-GB, de-DE, fr-FR, ja-JP, and
+    // others) also fall through, preserving their leading zeros.
+    if (!/[ap]\.?m\.?/iu.test(formatted)) {
+      return formatted;
+    }
+
+    return formatted.replace(/^0+/u, "").toLowerCase();
+  }
+
+  /**
+   * Gets the text to show for the current `type`.
+   * @private
+   * @returns {string} The formatted text; the full date when `type` isn't set or isn't recognized.
+   */
+  whichDate() {
+    switch (this.type) {
+      case "date":
+        return this.humanDate();
+      case "time":
+        return this.humanTime();
+      case "year":
+      case "month":
+      case "weekday":
+      case "day":
+        return this.humanDateConversion();
+      case "numeric":
+        return this.numericDate();
+      default:
+        return this.humanDate();
+    }
+  }
+
+  render() {
+    return b`
+      <slot name="pre"></slot>
+      <span class="yield">${this.whichDate()}</span>
+      <slot name="post"></slot>
+      <slot></slot>
+    `;
+  }
+}
 
 /* eslint-disable jsdoc/require-jsdoc, no-magic-numbers, no-param-reassign */