@aurodesignsystem-dev/auro-datetime 0.0.0-pr93.0 → 0.0.0-pr95.0

package/demo/auro-datetime.min.js

@@ -0,0 +1,608 @@
+// 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;
+
+// See https://git.io/JJ6SJ for "How to document your components using JSDoc"
+/**
+ * The `auro-datetime` element is for the purposes of providing an easy to use date and time API.
+ * @customElement auro-datetime
+ *
+ * @slot pre - Content that comes before the `post` content
+ * @slot post - Content that comes after the `pre` content
+ */
+
+// build the component class
+class AuroDatetime extends i {
+  constructor() {
+    super();
+
+    this._initializeDefaults();
+  }
+
+  _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 inputs already warned about. Same dedup
+     * pattern as `_warnedLocales`.
+     * @private
+     */
+    this._warnedTimeZones = new Set();
+
+    /**
+     * Tracks invalid value inputs already warned about. Same dedup
+     * pattern as `_warnedLocales`.
+     * @private
+     */
+    this._warnedValues = new Set();
+
+    /**
+     * @private
+     */
+    this._effectiveLocale = this._resolveLocale(this.locale);
+
+    /**
+     * @private
+     */
+    this._effectiveTimeZone = this._resolveTimeZone(this.timezone);
+
+    /**
+     * @private
+     */
+    this.runtimeUtils = new AuroLibraryRuntimeUtils();
+  }
+
+  /**
+   * Validate and canonicalize a BCP 47 locale tag. Falls back to "en-US"
+   * for empty or invalid input. The first invalid value seen per element
+   * is logged via `console.warn`; subsequent identical inputs are silent.
+   *
+   * @private
+   * @param {string} input - User-supplied locale tag.
+   * @returns {string} Canonical locale tag (e.g. "en-GB"), or "en-US" on fallback.
+   */
+  _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";
+    }
+  }
+
+  /**
+   * Validate an IANA timezone identifier. Invalid input warns once per
+   * unique value per element and resolves to `undefined`, which makes
+   * the rest of `_resolveInputDate` behave as if `timezone` was never
+   * specified — i.e. wall-clock display from the input components.
+   *
+   * Without this guard, a typo like `"US/Pacfic"` would cause
+   * `Intl.DateTimeFormat` / `toLocaleString` to throw `RangeError` at
+   * render time and crash the component.
+   *
+   * Note: when `value` is also unset, the wall-clock branch resolves to
+   * "today's date in the viewer's machine zone," which is viewer-
+   * dependent. This narrow case is the only scenario where two viewers
+   * see different output for the same component; the warning surfaces
+   * the typo so the developer can fix it.
+   *
+   * @private
+   * @param {string | undefined} input - Consumer-supplied timezone.
+   * @returns {string | undefined} Valid timezone, or undefined on fallback.
+   */
+  _resolveTimeZone(input) {
+    if (!input) {
+      return undefined;
+    }
+    try {
+      // Constructing the formatter is enough to surface a RangeError;
+      // we don't need to format anything yet.
+      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. Falling back to viewer-local.`,
+        );
+      }
+      return undefined;
+    }
+  }
+
+  connectedCallback() {
+    super.connectedCallback();
+
+    this.dateTemplate = {
+      weekday: this.weekday,
+      year: "numeric",
+      month: this.month,
+      day: "numeric",
+    };
+
+    this.timeTemplate = {
+      hour: "2-digit",
+      minute: "2-digit",
+    };
+  }
+
+  // function to define props used within the scope of this component
+  static get properties() {
+    return {
+      // ...super.properties,
+
+      /**
+       * BCP 47 language tag for locale-aware date/time formatting (e.g. 'en-GB', 'de-DE', 'ja-JP').
+       * @type {string}
+       * @default 'en-US'
+       */
+      locale: { type: String },
+
+      /**
+       * Defines format of month
+       * @type {'short' | 'long'}
+       * @default 'short'
+       */
+      month: { type: String },
+
+      /**
+       * Pass in string to define [timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+       * When set, the moment described by `value` is converted into this IANA zone for display.
+       * When unset, the wall-clock time from the input string is rendered as-is.
+       */
+      timezone: { type: String },
+
+      /**
+       * Defines type of data to render
+       * @type {'date' | 'time' | 'year' | 'month' | 'weekday' | 'day' | 'numeric'}
+       */
+      type: { type: String },
+
+      /**
+       * ISO 8601 date or date-time string. Examples:
+       * - `2022-07-14T08:00:00-07:00` (with offset)
+       * - `2022-07-14T08:00:00Z` (UTC)
+       * - `2022-07-14T08:00:00` (no offset)
+       * - `2022-07-14` (date only)
+       *
+       * When omitted, the component renders today's date.
+       * Invalid input is logged as a warning and renders nothing.
+       */
+      value: { type: String },
+
+      /**
+       * Defines format of weekday
+       * @type {'short' | 'long'}
+       * @default 'short'
+       */
+      weekday: { type: String },
+    };
+  }
+
+  /**
+   * This will register this element with the browser.
+   * @param {string} [name="auro-datetime"] - The name of the element that you want to register.
+   *
+   * @example
+   * AuroDatetime.register("custom-datetime") // this will register this element to <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() {
+    // Add the tag name as an attribute if it is different than the component name
+    this.runtimeUtils.handleComponentTagRename(this, "auro-datetime");
+  }
+
+  /**
+   * Construct a UTC Date that, when displayed in the given IANA timezone,
+   * shows the supplied wall-clock components. Used when `value` has no
+   * offset but `timeZone` is set — the wall-clock is interpreted as being
+   * in the target zone rather than the viewer's local zone.
+   *
+   * Algorithm: parse the wall-clock as if it were UTC (a "naive" Date),
+   * ask Intl what that moment looks like in the target zone, and use the
+   * delta between the two to recover the true UTC moment.
+   *
+   * @private
+   * @param {string} localISO - ISO string with no offset, e.g. "2022-07-14T08:00:00".
+   * @param {string} timeZone - IANA zone, e.g. "US/Eastern".
+   * @returns {Date}
+   */
+  _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);
+  }
+
+  /**
+   * Resolve the `value` and `timezone` attributes into a Date and an optional
+   * timeZone option for `Intl.DateTimeFormat`.
+   *
+   * Behavior:
+   * - `value` omitted (null/undefined): returns today's date. `timezone`
+   *   (if any) is honored.
+   * - `value` invalid (including empty string ""): warns and returns
+   *   `{ date: null }`. Empty is *not* the same as omitted — Lit reflects
+   *   `value=""` as the empty string, which is not a valid ISO 8601
+   *   form, so we surface it as a typo rather than silently rendering
+   *   today's date.
+   * - `timezone` set + input has offset/Z: parses as an absolute moment
+   *   (offset honored) and asks `toLocaleString` to convert into the target zone.
+   * - `timezone` set + input has no offset: interprets the wall-clock as
+   *   being in the target zone, so display in that zone matches the input
+   *   verbatim. This is viewer-independent.
+   * - Default (no `timezone`): strips the offset/Z from the input and treats
+   *   the remaining wall-clock components as local time, so they render verbatim.
+   *
+   * @private
+   * @returns {{ date: Date | null, timeZoneOption: string | undefined }}
+   */
+  _resolveInputDate() {
+    const resolvedTz = this._effectiveTimeZone;
+
+    // Only true "omitted" inputs (null/undefined) get the today's-date
+    // treatment. Empty string falls through to ISO validation, which will
+    // fail and produce the documented warn + empty render.
+    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 (e.g. "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 };
+  }
+
+  /**
+   * Internal function to generate full date string.
+   * @private
+   * @returns {string} - Date string.
+   */
+  humanDate() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = { ...this.dateTemplate };
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Internal function to format a single date part (year/month/weekday/day).
+   * @private
+   * @returns {string} - Date string.
+   */
+  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;
+        break;
+      case "year":
+        template.year = "numeric";
+        break;
+      case "weekday":
+        template.weekday = this.weekday;
+        break;
+    }
+
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Internal function to generate numeric date string MM/DD/YYYY.
+   * @private
+   * @returns {string} - Date string.
+   */
+  numericDate() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = { ...this.dateTemplate, month: "numeric" };
+    Reflect.deleteProperty(template, "weekday");
+    if (timeZoneOption) {
+      template.timeZone = timeZoneOption;
+    }
+    return date.toLocaleString(this._effectiveLocale, template);
+  }
+
+  /**
+   * Internal function to generate standard time string.
+   * @private
+   * @returns {string} - Time string.
+   */
+  humanTime() {
+    const { date, timeZoneOption } = this._resolveInputDate();
+    if (!date) {
+      return "";
+    }
+    const template = { ...this.timeTemplate };
+    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 …) also
+    // fall through, preserving their leading zeros.
+    if (!/[ap]\.?m\.?/iu.test(formatted)) {
+      return formatted;
+    }
+
+    return formatted.replace(/^0+/u, "").toLowerCase();
+  }
+
+  /**
+   * Internal function UI decision.
+   * @private
+   * @returns {string} - String determined by `type` (or full date if no type set).
+   */
+  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();
+    }
+  }
+
+  // When using auroElement, use the following attribute and function when hiding content from screen readers.
+  // aria-hidden="${this.hideAudible(this.hiddenAudible)}"
+
+  // function that renders the HTML and CSS into  the scope of the component
+  render() {
+    return b`
+      <slot name="pre"></slot>
+      <span class="yield">${this.whichDate()}</span>
+      <slot name="post"></slot>
+      <slot></slot>
+    `;
+  }
+}
+
+export { AuroDatetime as A };

package/demo/index.md

@@ -23,34 +23,38 @@ The `<auro-datetime>` element should be used in situations where users may:
 ## Basic Date
 
 <div class="exampleWrapper">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
-<!-- The below content is automatically added from ./../apiExamples/basic.html -->
-<auro-datetime type="date"></auro-datetime>
-<!-- AURO-GENERATED-CONTENT:END -->
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basic.html -->
+  <auro-datetime type="date"></auro-datetime>
+  <!-- AURO-GENERATED-CONTENT:END -->
 </div>
 <auro-accordion alignRight>
-<span slot="trigger">See code</span>
+  <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
 <!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
 
-<pre class="language-html"><code class="language-html">&lt;auro-datetime type="date"&gt;&lt;/auro-datetime&gt;</code></pre>
+```html
+<auro-datetime type="date"></auro-datetime>
+```
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
 
 ## Basic Time
 
 <div class="exampleWrapper">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic-time.html) -->
-<!-- The below content is automatically added from ./../apiExamples/basic-time.html -->
-<auro-datetime type="time"></auro-datetime>
-<!-- AURO-GENERATED-CONTENT:END -->
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic-time.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basic-time.html -->
+  <auro-datetime type="time"></auro-datetime>
+  <!-- AURO-GENERATED-CONTENT:END -->
 </div>
 <auro-accordion alignRight>
-<span slot="trigger">See code</span>
+  <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic-time.html) -->
 <!-- The below code snippet is automatically added from ./../apiExamples/basic-time.html -->
 
-<pre class="language-html"><code class="language-html">&lt;auro-datetime type="time"&gt;&lt;/auro-datetime&gt;</code></pre>
+```html
+<auro-datetime type="time"></auro-datetime>
+```
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>