@skdx/web-components 0.26.0

package/dist/breadcrumb/BreadcrumbSeparator.d.cts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+/**
+ * `<skdx-breadcrumb-separator>` — divider between two
+ * `<skdx-breadcrumb-item>`s: renders an `<li role="presentation"
+ * aria-hidden="true">` so assistive tech skips it. Defaults to `/`; slot
+ * content (e.g. an icon) overrides it.
+ *
+ * @csspart separator - The inner `<li>` element inside the shadow root.
+ */
+export declare class SkdxBreadcrumbSeparator extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-breadcrumb-separator': SkdxBreadcrumbSeparator;
+    }
+}

package/dist/breadcrumb/BreadcrumbSeparator.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+/**
+ * `<skdx-breadcrumb-separator>` — divider between two
+ * `<skdx-breadcrumb-item>`s: renders an `<li role="presentation"
+ * aria-hidden="true">` so assistive tech skips it. Defaults to `/`; slot
+ * content (e.g. an icon) overrides it.
+ *
+ * @csspart separator - The inner `<li>` element inside the shadow root.
+ */
+export declare class SkdxBreadcrumbSeparator extends LitElement {
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-breadcrumb-separator': SkdxBreadcrumbSeparator;
+    }
+}

package/dist/breadcrumb/BreadcrumbSeparator.js

@@ -0,0 +1,9 @@
+var d=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var n=(o,r,s,i)=>{for(var e=i>1?void 0:i?c(r,s):r,l=o.length-1,a;l>=0;l--)(a=o[l])&&(e=(i?a(r,s,e):a(e))||e);return i&&e&&d(r,s,e),e};import{css as m,html as p,LitElement as b}from"lit";import{customElement as h}from"../internal/define.js";import{hiddenHostStyles as u}from"../internal/styles.js";var t=class extends b{connectedCallback(){super.connectedCallback(),this.setAttribute("aria-hidden","true")}render(){return p`<li part="separator" role="presentation" aria-hidden="true"><slot>/</slot></li>`}};t.styles=[u,m`
+      :host {
+        display: inline-block;
+      }
+      li {
+        font: inherit;
+        color: inherit;
+      }
+    `],t=n([h("skdx-breadcrumb-separator","breadcrumb","separator")],t);export{t as SkdxBreadcrumbSeparator};

package/dist/breadcrumb/index.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var B=Object.prototype.hasOwnProperty;var i=(e,r)=>{for(var o in r)d(e,o,{get:r[o],enumerable:!0})},s=(e,r,o,x)=>{if(r&&typeof r=="object"||typeof r=="function")for(let m of u(r))!B.call(e,m)&&m!==o&&d(e,m,{get:()=>r[m],enumerable:!(x=f(r,m))||x.enumerable});return e};var l=e=>s(d({},"__esModule",{value:!0}),e);var L={};i(L,{SkdxBreadcrumb:()=>a.SkdxBreadcrumb,SkdxBreadcrumbEllipsis:()=>c.SkdxBreadcrumbEllipsis,SkdxBreadcrumbItem:()=>p.SkdxBreadcrumbItem,SkdxBreadcrumbLink:()=>k.SkdxBreadcrumbLink,SkdxBreadcrumbList:()=>t.SkdxBreadcrumbList,SkdxBreadcrumbPage:()=>S.SkdxBreadcrumbPage,SkdxBreadcrumbSeparator:()=>b.SkdxBreadcrumbSeparator});module.exports=l(L);var a=require("./Breadcrumb.cjs"),t=require("./BreadcrumbList.cjs"),p=require("./BreadcrumbItem.cjs"),k=require("./BreadcrumbLink.cjs"),S=require("./BreadcrumbPage.cjs"),b=require("./BreadcrumbSeparator.cjs"),c=require("./BreadcrumbEllipsis.cjs");0&&(module.exports={SkdxBreadcrumb,SkdxBreadcrumbEllipsis,SkdxBreadcrumbItem,SkdxBreadcrumbLink,SkdxBreadcrumbList,SkdxBreadcrumbPage,SkdxBreadcrumbSeparator});

package/dist/breadcrumb/index.d.cts

@@ -0,0 +1,7 @@
+export { SkdxBreadcrumb } from './Breadcrumb.cjs';
+export { SkdxBreadcrumbList } from './BreadcrumbList.cjs';
+export { SkdxBreadcrumbItem } from './BreadcrumbItem.cjs';
+export { SkdxBreadcrumbLink } from './BreadcrumbLink.cjs';
+export { SkdxBreadcrumbPage } from './BreadcrumbPage.cjs';
+export { SkdxBreadcrumbSeparator } from './BreadcrumbSeparator.cjs';
+export { SkdxBreadcrumbEllipsis } from './BreadcrumbEllipsis.cjs';

package/dist/breadcrumb/index.d.ts

@@ -0,0 +1,7 @@
+export { SkdxBreadcrumb } from './Breadcrumb.js';
+export { SkdxBreadcrumbList } from './BreadcrumbList.js';
+export { SkdxBreadcrumbItem } from './BreadcrumbItem.js';
+export { SkdxBreadcrumbLink } from './BreadcrumbLink.js';
+export { SkdxBreadcrumbPage } from './BreadcrumbPage.js';
+export { SkdxBreadcrumbSeparator } from './BreadcrumbSeparator.js';
+export { SkdxBreadcrumbEllipsis } from './BreadcrumbEllipsis.js';

package/dist/breadcrumb/index.js

@@ -0,0 +1 @@
+import{SkdxBreadcrumb as m}from"./Breadcrumb.js";import{SkdxBreadcrumbList as d}from"./BreadcrumbList.js";import{SkdxBreadcrumbItem as a}from"./BreadcrumbItem.js";import{SkdxBreadcrumbLink as p}from"./BreadcrumbLink.js";import{SkdxBreadcrumbPage as S}from"./BreadcrumbPage.js";import{SkdxBreadcrumbSeparator as c}from"./BreadcrumbSeparator.js";import{SkdxBreadcrumbEllipsis as u}from"./BreadcrumbEllipsis.js";export{m as SkdxBreadcrumb,u as SkdxBreadcrumbEllipsis,a as SkdxBreadcrumbItem,p as SkdxBreadcrumbLink,d as SkdxBreadcrumbList,S as SkdxBreadcrumbPage,c as SkdxBreadcrumbSeparator};

package/dist/button/Button.cjs

@@ -0,0 +1,17 @@
+"use strict";var n=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var v=(i,t)=>{for(var o in t)n(i,o,{get:t[o],enumerable:!0})},$=(i,t,o,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of y(t))!g.call(i,e)&&e!==o&&n(i,e,{get:()=>t[e],enumerable:!(a=h(t,e))||a.enumerable});return i};var H=i=>$(n({},"__esModule",{value:!0}),i),d=(i,t,o,a)=>{for(var e=a>1?void 0:a?h(t,o):t,m=i.length-1,b;m>=0;m--)(b=i[m])&&(e=(a?b(t,o,e):b(e))||e);return a&&e&&n(t,o,e),e};var C={};v(C,{SkdxButton:()=>s});module.exports=H(C);var r=require("lit"),p=require("lit/decorators.js"),c=require("../internal/define.cjs"),f=require("../internal/form-associated.cjs"),u=require("../internal/part.cjs"),l=require("../internal/styles.cjs");var s=class extends(0,f.FormAssociated)(r.LitElement){constructor(){super(...arguments);this.loading=!1;this.disabled=!1;this.type="button";this.handleClick=()=>{this.type==="submit"?this.form?.requestSubmit():this.type==="reset"&&this.form?.reset()}}updated(){(0,u.reflectHostState)(this,{"data-disabled":this.disabled?"":null,"data-loading":this.loading?"":null})}render(){let o=this.disabled||this.loading;return r.html`
+      <button
+        part="button"
+        type=${this.type}
+        ?disabled=${o}
+        aria-busy=${this.loading?"true":r.nothing}
+        data-disabled=${this.disabled?"":r.nothing}
+        data-loading=${this.loading?"":r.nothing}
+        @click=${this.handleClick}
+      >
+        <slot></slot>
+      </button>
+    `}};s.shadowRootOptions=l.delegatesFocusShadowRootOptions,s.styles=[l.resetNativeControl,l.hiddenHostStyles,r.css`
+      :host {
+        display: inline-block;
+      }
+    `,l.controlBoxOnHost],d([(0,p.property)({type:Boolean,reflect:!0})],s.prototype,"loading",2),d([(0,p.property)({type:Boolean,reflect:!0})],s.prototype,"disabled",2),d([(0,p.property)({type:String,reflect:!0})],s.prototype,"type",2),s=d([(0,c.customElement)("skdx-button","button","root")],s);0&&(module.exports={SkdxButton});

package/dist/button/Button.d.cts

@@ -0,0 +1,48 @@
+import { LitElement } from 'lit';
+declare const SkdxButton_base: typeof LitElement & (new (...args: any[]) => import("../internal/form-associated.cjs").SkdxFormAssociated) & {
+    formAssociated: boolean;
+};
+/**
+ * `<skdx-button>` — the Web Components implementation of the shared Button
+ * contract (see `@skdx/shared`'s `buttonContract`). Renders a native
+ * `<button>` in shadow DOM: behavior and accessibility only, no visual
+ * style — style the inner button with `skdx-button::part(button)`.
+ *
+ * Form association comes from the shared `FormAssociated` mixin rather than
+ * from the shadow-DOM-nested native button, since a `<button type="submit">`
+ * inside a shadow root does not automatically submit a light-DOM ancestor
+ * form (the browser only associates it through the element's own
+ * `ElementInternals.form`). The mixin also brings `formDisabledCallback`, so a
+ * `<fieldset disabled>` ancestor disables the button the way it disables a
+ * native one.
+ *
+ * @example
+ * ```html
+ * <skdx-button id="save">Save</skdx-button>
+ * <script type="module">
+ *   import '@skdx/web-components/button';
+ *   document.getElementById('save').addEventListener('click', () => { ... });
+ * </script>
+ * ```
+ *
+ * @csspart button - The native `<button>` element inside the shadow root.
+ */
+export declare class SkdxButton extends SkdxButton_base {
+    static shadowRootOptions: ShadowRootInit;
+    static styles: import("lit").CSSResult[];
+    /** Marks the button busy (e.g. while submitting). Sets `aria-busy` and disables the button. */
+    loading: boolean;
+    /** Native disabled state. Combined with `loading`: disabled if either is true. */
+    disabled: boolean;
+    /** Native button type. Defaults to `"button"` so it never accidentally submits an enclosing form. */
+    type: 'button' | 'submit' | 'reset';
+    private handleClick;
+    protected updated(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-button': SkdxButton;
+    }
+}
+export {};

package/dist/button/Button.d.ts

@@ -0,0 +1,48 @@
+import { LitElement } from 'lit';
+declare const SkdxButton_base: typeof LitElement & (new (...args: any[]) => import("../internal/form-associated.js").SkdxFormAssociated) & {
+    formAssociated: boolean;
+};
+/**
+ * `<skdx-button>` — the Web Components implementation of the shared Button
+ * contract (see `@skdx/shared`'s `buttonContract`). Renders a native
+ * `<button>` in shadow DOM: behavior and accessibility only, no visual
+ * style — style the inner button with `skdx-button::part(button)`.
+ *
+ * Form association comes from the shared `FormAssociated` mixin rather than
+ * from the shadow-DOM-nested native button, since a `<button type="submit">`
+ * inside a shadow root does not automatically submit a light-DOM ancestor
+ * form (the browser only associates it through the element's own
+ * `ElementInternals.form`). The mixin also brings `formDisabledCallback`, so a
+ * `<fieldset disabled>` ancestor disables the button the way it disables a
+ * native one.
+ *
+ * @example
+ * ```html
+ * <skdx-button id="save">Save</skdx-button>
+ * <script type="module">
+ *   import '@skdx/web-components/button';
+ *   document.getElementById('save').addEventListener('click', () => { ... });
+ * </script>
+ * ```
+ *
+ * @csspart button - The native `<button>` element inside the shadow root.
+ */
+export declare class SkdxButton extends SkdxButton_base {
+    static shadowRootOptions: ShadowRootInit;
+    static styles: import("lit").CSSResult[];
+    /** Marks the button busy (e.g. while submitting). Sets `aria-busy` and disables the button. */
+    loading: boolean;
+    /** Native disabled state. Combined with `loading`: disabled if either is true. */
+    disabled: boolean;
+    /** Native button type. Defaults to `"button"` so it never accidentally submits an enclosing form. */
+    type: 'button' | 'submit' | 'reset';
+    private handleClick;
+    protected updated(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-button': SkdxButton;
+    }
+}
+export {};

package/dist/button/Button.js

@@ -0,0 +1,17 @@
+var m=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var s=(l,i,o,r)=>{for(var e=r>1?void 0:r?b(i,o):i,a=l.length-1,d;a>=0;a--)(d=l[a])&&(e=(r?d(i,o,e):d(e))||e);return r&&e&&m(i,o,e),e};import{css as h,html as c,LitElement as f,nothing as n}from"lit";import{property as p}from"lit/decorators.js";import{customElement as u}from"../internal/define.js";import{FormAssociated as y}from"../internal/form-associated.js";import{reflectHostState as g}from"../internal/part.js";import{controlBoxOnHost as v,delegatesFocusShadowRootOptions as $,hiddenHostStyles as H,resetNativeControl as C}from"../internal/styles.js";var t=class extends y(f){constructor(){super(...arguments);this.loading=!1;this.disabled=!1;this.type="button";this.handleClick=()=>{this.type==="submit"?this.form?.requestSubmit():this.type==="reset"&&this.form?.reset()}}updated(){g(this,{"data-disabled":this.disabled?"":null,"data-loading":this.loading?"":null})}render(){let o=this.disabled||this.loading;return c`
+      <button
+        part="button"
+        type=${this.type}
+        ?disabled=${o}
+        aria-busy=${this.loading?"true":n}
+        data-disabled=${this.disabled?"":n}
+        data-loading=${this.loading?"":n}
+        @click=${this.handleClick}
+      >
+        <slot></slot>
+      </button>
+    `}};t.shadowRootOptions=$,t.styles=[C,H,h`
+      :host {
+        display: inline-block;
+      }
+    `,v],s([p({type:Boolean,reflect:!0})],t.prototype,"loading",2),s([p({type:Boolean,reflect:!0})],t.prototype,"disabled",2),s([p({type:String,reflect:!0})],t.prototype,"type",2),t=s([u("skdx-button","button","root")],t);export{t as SkdxButton};

package/dist/button/index.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var n=Object.prototype.hasOwnProperty;var p=(t,o)=>{for(var x in o)d(t,x,{get:o[x],enumerable:!0})},u=(t,o,x,e)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of m(o))!n.call(t,r)&&r!==x&&d(t,r,{get:()=>o[r],enumerable:!(e=k(o,r))||e.enumerable});return t};var B=t=>u(d({},"__esModule",{value:!0}),t);var S={};p(S,{SkdxButton:()=>f.SkdxButton});module.exports=B(S);var f=require("./Button.cjs");0&&(module.exports={SkdxButton});

package/dist/button/index.d.cts

@@ -0,0 +1 @@
+export { SkdxButton } from './Button.cjs';

package/dist/button/index.d.ts

@@ -0,0 +1 @@
+export { SkdxButton } from './Button.js';

package/dist/button/index.js

@@ -0,0 +1 @@
+import{SkdxButton as r}from"./Button.js";export{r as SkdxButton};

package/dist/calendar/Calendar.cjs

@@ -0,0 +1,5 @@
+"use strict";var p=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var Y=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var C=(e,t)=>{for(var n in t)p(e,n,{get:t[n],enumerable:!0})},E=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of Y(t))!N.call(e,a)&&a!==n&&p(e,a,{get:()=>t[a],enumerable:!(r=T(t,a))||r.enumerable});return e};var $=e=>E(p({},"__esModule",{value:!0}),e),i=(e,t,n,r)=>{for(var a=r>1?void 0:r?T(t,n):t,l=e.length-1,u;l>=0;l--)(u=e[l])&&(a=(r?u(t,n,a):u(a))||a);return r&&a&&p(t,n,a),a};var z={};C(z,{SkdxCalendar:()=>o,addDays:()=>w,addMonths:()=>M,addYears:()=>R,anchorOf:()=>m,clampToMonth:()=>P,emptySelection:()=>L,endOfWeek:()=>W,getDaysInMonth:()=>y,getVisibleWeeks:()=>I,isDateDisabled:()=>_,isDateRange:()=>D,isDateSelected:()=>U,isSameDay:()=>b,isSameMonth:()=>x,nextSelection:()=>F,rangePositionOf:()=>V,selectionAnnouncement:()=>O,startOfMonth:()=>f,startOfWeek:()=>v,stripTime:()=>c,toISODateString:()=>k});module.exports=$(z);var h=require("lit"),s=require("lit/decorators.js"),A=require("../internal/define.cjs"),S=require("../utils/live-announcer.cjs"),d=require("./locale.cjs");function y(e,t){return new Date(e,t+1,0).getDate()}function f(e){return new Date(e.getFullYear(),e.getMonth(),1)}function M(e,t){let n=e.getDate(),r=new Date(e.getFullYear(),e.getMonth(),1);r.setMonth(r.getMonth()+t);let a=y(r.getFullYear(),r.getMonth());return r.setDate(Math.min(n,a)),r}function R(e,t){return M(e,t*12)}function w(e,t){let n=new Date(e);return n.setDate(n.getDate()+t),n}function b(e,t){return!e||!t?!1:e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate()}function x(e,t){return e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()}function v(e,t){let n=new Date(e.getFullYear(),e.getMonth(),e.getDate()),r=(n.getDay()-t+7)%7;return n.setDate(n.getDate()-r),n}function W(e,t){return w(v(e,t),6)}function c(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function _(e,t,n,r){let a=c(e).getTime();return!!(t&&a<c(t).getTime()||n&&a>c(n).getTime()||r?.(e))}function k(e){let t=e.getFullYear(),n=String(e.getMonth()+1).padStart(2,"0"),r=String(e.getDate()).padStart(2,"0");return`${t}-${n}-${r}`}function P(e,t){if(x(e,t))return e;let n=y(t.getFullYear(),t.getMonth());return new Date(t.getFullYear(),t.getMonth(),Math.min(e.getDate(),n))}function I(e,t=0){let n=v(f(e),t),r=[],a=n;for(let l=0;l<6;l++){let u=[];for(let g=0;g<7;g++)u.push({date:a,outsideMonth:!x(a,e)}),a=w(a,1);r.push(u)}return r}function D(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function L(e){return e==="multiple"?[]:null}function V(e,t){let n=c(t).getTime(),r=c(e.start).getTime();if(e.end===null)return n===r?"start":void 0;let a=c(e.end).getTime();if(!(n<r||n>a))return n===r?"start":n===a?"end":"middle"}function U(e,t){return e===null?!1:Array.isArray(e)?e.some(n=>b(n,t)):D(e)?V(e,t)!==void 0:b(e,t)}function F(e,t,n){if(e==="single")return n;if(e==="multiple"){let a=Array.isArray(t)?t:[],l=a.filter(u=>!b(u,n));return l.length!==a.length?l:[...a,n].sort((u,g)=>u.getTime()-g.getTime())}let r=D(t)&&t.end===null?t:void 0;return r?c(n).getTime()<c(r.start).getTime()?{start:n,end:r.start}:{start:r.start,end:n}:{start:n,end:null}}function O(e,t){return D(e)?e.end===null?`${(0,d.formatDateLabel)(e.start,t)} selected as the range start. Select an end date.`:`Range selected, ${(0,d.formatDateLabel)(e.start,t)} to ${(0,d.formatDateLabel)(e.end,t)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var q={fromAttribute(e){if(e==null)return;let t=/^(\d{4})-(\d{2})(?:-(\d{2}))?$/.exec(e.trim()),n=t?new Date(Number(t[1]),Number(t[2])-1,Number(t[3]??"1")):new Date(e);return Number.isNaN(n.getTime())?void 0:n},toAttribute(){}};function m(e){return e===null?null:Array.isArray(e)?e[0]??null:D(e)?e.start:e}var o=class extends h.LitElement{constructor(){super(...arguments);this.selectionMode="single";this.value=null;this.month=f(new Date);this._constructedMonth=this.month;this._monthSeeded=!1;this.numberOfMonths=1;this.focusedDate=m(this.value)??this.month}get resolvedWeekStartsOn(){return this.weekStartsOn??(0,d.getLocaleWeekStartsOn)(this.locale)}get months(){return Array.from({length:Math.max(1,this.numberOfMonths)},(n,r)=>M(this.month,r))}get weekDayNames(){let n=this.resolvedWeekStartsOn,r=(0,d.getWeekDayNames)(this.locale,n,"short"),a=(0,d.getWeekDayNames)(this.locale,n,"long");return r.map((l,u)=>({short:l,long:a[u]}))}connectedCallback(){super.connectedCallback(),this.focusedDate=m(this.value)??this.month}setValue(n){let r=F(this.selectionMode,this.value,n);this.value=r,this.focusedDate=n,this.emit("value-change",r);let a=(this.getSelectionAnnouncement??O)(r,this.locale);a&&(0,S.announce)(a)}setMonth(n){let r=f(n);r.getTime()!==f(this.month).getTime()&&(this.month=r,this.emit("month-change",this.month))}setFocusedDate(n){this.focusedDate=n,this.notify()}emit(n,r){this.dispatchEvent(new CustomEvent(n,{detail:r,bubbles:!0,composed:!0})),this.notify()}notify(){this.dispatchEvent(new CustomEvent("skdx-calendar-internal-update",{bubbles:!0,composed:!0})),this.requestUpdate()}willUpdate(n){if(this._monthSeeded||!(n.has("defaultMonth")||n.has("value")))return;if(this.month!==this._constructedMonth){this._monthSeeded=!0;return}let r=this.defaultMonth??m(this.value);r&&(this._monthSeeded=!0,this.month=f(r),this.focusedDate=m(this.value)??this.month)}updated(n){n.size>0&&this.dispatchEvent(new CustomEvent("skdx-calendar-internal-update",{bubbles:!0,composed:!0}))}render(){return h.html`<slot></slot>`}};o.styles=h.css`
+    :host {
+      display: block;
+    }
+  `,i([(0,s.property)({type:String,reflect:!0,attribute:"selection-mode"})],o.prototype,"selectionMode",2),i([(0,s.property)({attribute:!1})],o.prototype,"value",2),i([(0,s.property)({attribute:!1})],o.prototype,"month",2),i([(0,s.property)({converter:q,attribute:"default-month"})],o.prototype,"defaultMonth",2),i([(0,s.property)({type:Number,attribute:"number-of-months"})],o.prototype,"numberOfMonths",2),i([(0,s.property)({type:String})],o.prototype,"locale",2),i([(0,s.property)({type:Number,attribute:"week-starts-on"})],o.prototype,"weekStartsOn",2),i([(0,s.property)({attribute:!1})],o.prototype,"minDate",2),i([(0,s.property)({attribute:!1})],o.prototype,"maxDate",2),i([(0,s.property)({attribute:!1})],o.prototype,"disabled",2),i([(0,s.property)({attribute:!1})],o.prototype,"isDateUnavailable",2),i([(0,s.property)({attribute:!1})],o.prototype,"getSelectionAnnouncement",2),o=i([(0,A.customElement)("skdx-calendar","calendar","root")],o);0&&(module.exports={SkdxCalendar,addDays,addMonths,addYears,anchorOf,clampToMonth,emptySelection,endOfWeek,getDaysInMonth,getVisibleWeeks,isDateDisabled,isDateRange,isDateSelected,isSameDay,isSameMonth,nextSelection,rangePositionOf,selectionAnnouncement,startOfMonth,startOfWeek,stripTime,toISODateString});

package/dist/calendar/Calendar.d.cts

@@ -0,0 +1,248 @@
+import { LitElement, type PropertyValues } from 'lit';
+/** @internal Number of days in the given zero-based `month` of `year`. */
+export declare function getDaysInMonth(year: number, month: number): number;
+/** @internal Midnight on the first day of `date`'s month, in local time. */
+export declare function startOfMonth(date: Date): Date;
+/** @internal Adds `amount` calendar months to `date`, clamping the day of month so it never overflows. */
+export declare function addMonths(date: Date, amount: number): Date;
+/** @internal Adds `amount` years to `date` via {@link addMonths}. */
+export declare function addYears(date: Date, amount: number): Date;
+/** @internal Adds `amount` days to `date`, rolling over month/year boundaries. */
+export declare function addDays(date: Date, amount: number): Date;
+/** @internal Whether `a` and `b` fall on the same calendar day. */
+export declare function isSameDay(a: Date | null | undefined, b: Date | null | undefined): boolean;
+/** @internal Whether `a` and `b` fall in the same calendar month of the same year. */
+export declare function isSameMonth(a: Date, b: Date): boolean;
+/** @internal Midnight on the first day of the week containing `date`. */
+export declare function startOfWeek(date: Date, weekStartsOn: number): Date;
+/** @internal Midnight on the last day of the week containing `date`. */
+export declare function endOfWeek(date: Date, weekStartsOn: number): Date;
+/** @internal Copy of `date` with the time component zeroed to local midnight. */
+export declare function stripTime(date: Date): Date;
+/** @internal Whether `date` is before `minDate`, after `maxDate`, or rejected by `disabledFn`. */
+export declare function isDateDisabled(date: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/** @internal Formats `date` as a local-time `YYYY-MM-DD` string. */
+export declare function toISODateString(date: Date): string;
+/** @internal Projects `date`'s day-of-month onto `targetMonth`, clamping to that month's last day. */
+export declare function clampToMonth(date: Date, targetMonth: Date): Date;
+/** One cell in a Calendar grid week. */
+export interface CalendarDay {
+    date: Date;
+    outsideMonth: boolean;
+}
+/** Always returns a 6x7 (weeks x weekdays) grid, including adjacent-month filler days. */
+export declare function getVisibleWeeks(month: Date, weekStartsOn?: number): CalendarDay[][];
+/**
+ * How many dates a `<skdx-calendar>` selects at once, and therefore what shape
+ * its `value` takes:
+ *
+ * | `selectionMode` | `value` type          | empty selection |
+ * | --------------- | --------------------- | --------------- |
+ * | `'single'`      | `Date \| null`        | `null`          |
+ * | `'multiple'`    | `Date[]`              | `[]`            |
+ * | `'range'`       | `DateRange \| null`   | `null`          |
+ */
+export type CalendarSelectionMode = 'single' | 'multiple' | 'range';
+/**
+ * A selected date range. `end` is `null` while the range is *anchored* — the
+ * user has picked a start date and the next selection will close the range.
+ */
+export interface DateRange {
+    /** First date of the range (always the earlier of the two once `end` is set). */
+    start: Date;
+    /** Last date of the range, or `null` while only the anchor has been picked. */
+    end: Date | null;
+}
+/**
+ * A calendar's selection, whose concrete shape follows
+ * {@link CalendarSelectionMode}. One union rather than a discriminated type,
+ * because a Web Component property cannot discriminate on a sibling property —
+ * semantic parity across the five frameworks beats a type trick only two of
+ * them could express.
+ */
+export type CalendarValue = Date | Date[] | DateRange | null;
+/** Where a date sits inside a selected range, for the `data-range-*` styling hooks. */
+export type RangePosition = 'start' | 'middle' | 'end';
+/** Whether `value` is a {@link DateRange} rather than a single date, a date array, or nothing. */
+export declare function isDateRange(value: CalendarValue): value is DateRange;
+/** The empty selection for `mode`: `[]` for `multiple`, `null` for `single` and `range`. */
+export declare function emptySelection(mode: CalendarSelectionMode): CalendarValue;
+/**
+ * Where `date` sits in `range`: `'start'`, `'end'`, `'middle'`, or `undefined`
+ * when it is outside the range. A range still being anchored (`end: null`)
+ * only ever reports `'start'`.
+ */
+export declare function rangePositionOf(range: DateRange, date: Date): RangePosition | undefined;
+/**
+ * Whether `date` is part of `value` — the selected day in `single` mode, a
+ * member of the array in `multiple`, or anywhere from `start` to `end`
+ * inclusive in `range` (so every cell in a range carries `aria-selected`).
+ */
+export declare function isDateSelected(value: CalendarValue, date: Date): boolean;
+/**
+ * The selection that results from choosing `date` while `current` is selected.
+ *
+ * - `single` — just `date`.
+ * - `multiple` — `date` toggled into/out of the array, kept chronological.
+ * - `range` — anchors a new range (`{ start: date, end: null }`) when nothing
+ *   is anchored or the previous range was already complete, otherwise closes
+ *   the anchored range, ordering `start`/`end` so a backwards drag still
+ *   yields `start <= end`.
+ */
+export declare function nextSelection(mode: CalendarSelectionMode, current: CalendarValue, date: Date): CalendarValue;
+/** @internal The live-region message for a selection change, or `''` when there is nothing worth announcing. */
+export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
+/** @internal The date a fresh calendar should focus and display, given whatever `value` holds. */
+export declare function anchorOf(value: CalendarValue): Date | null;
+/**
+ * `<skdx-calendar>` — the Web Components implementation of the shared
+ * Calendar contract (see `@skdx/shared`'s `calendarContract`). A month-grid
+ * date picker (WAI-ARIA `grid` pattern) built on plain native `Date` math and
+ * `Intl` for every month/weekday name — no date library, no bundled name
+ * table. `selection-mode` decides what `value` holds: a `Date` (`single`, the
+ * default), a `Date[]` (`multiple`), or a `{ start, end }` {@link DateRange}
+ * (`range`, where `end` stays `null` until the second date closes it).
+ * Renders no visible box of its own (`display:
+ * contents`) — it only owns selection/displayed-month/roving-focus state
+ * and exposes it to descendant `<skdx-calendar-*>` parts, which look it up
+ * via `closest('skdx-calendar')` and listen for its internal update event to
+ * know when to re-render. Like `<skdx-dialog>`, properties are the single
+ * source of truth (no separate controlled/uncontrolled mode) — listen for
+ * `value-change`/`month-change` to observe or override changes.
+ *
+ * @example
+ * ```html
+ * <skdx-calendar id="cal">
+ *   <skdx-calendar-header>
+ *     <skdx-calendar-previous-button>‹</skdx-calendar-previous-button>
+ *     <skdx-calendar-heading></skdx-calendar-heading>
+ *     <skdx-calendar-next-button>›</skdx-calendar-next-button>
+ *   </skdx-calendar-header>
+ *   <skdx-calendar-grid></skdx-calendar-grid>
+ * </skdx-calendar>
+ * ```
+ *
+ * @fires value-change - Fired with the *whole* new selection (a `Date`, a `Date[]`, or a `{ start, end }` range, per `selection-mode`) whenever a cell is picked.
+ * @fires month-change - Fired with the first day of the newly displayed month whenever the calendar is navigated.
+ */
+export declare class SkdxCalendar extends LitElement {
+    static styles: import("lit").CSSResult;
+    /**
+     * How many dates can be selected at once, which also fixes the shape of
+     * `value` — see {@link CalendarSelectionMode}.
+     * @default 'single'
+     */
+    selectionMode: CalendarSelectionMode;
+    /**
+     * Current selection; its shape follows `selectionMode`. Property-only —
+     * the array and range shapes have no attribute form. Listen for
+     * `value-change` to observe or override changes.
+     */
+    value: CalendarValue;
+    /** Displayed month. Listen for `month-change` to observe or override changes. */
+    month: Date;
+    /**
+     * Initially displayed month, for uncontrolled usage — the seed for
+     * {@link month}, which the calendar then owns. Defaults to the month of
+     * `value`, or the current month
+     * (`packages/react/src/calendar/Calendar.tsx:331`).
+     *
+     * Unlike `month`, this one *does* take an attribute: a seed is the thing
+     * static markup needs to say, and a month has an unambiguous text form.
+     * `default-month="2024-01"` and `default-month="2024-01-01"` are both read
+     * as local time — `new Date('2024-01-01')` is UTC midnight, which is the
+     * *previous* month anywhere west of Greenwich.
+     * @default undefined — the month of `value`, else the current month.
+     */
+    defaultMonth?: Date;
+    /**
+     * The `month` this element was constructed with, held by identity so
+     * {@link defaultMonth} can tell "nobody has set `month`" from "somebody set
+     * it to today's month". Assigning `month` replaces the object, so `===`
+     * against this is the whole test.
+     */
+    private readonly _constructedMonth;
+    private _monthSeeded;
+    /**
+     * How many consecutive months to display, starting at `month` — compose one
+     * `<skdx-calendar-grid>` per month with a matching `month-offset`, and one
+     * `<skdx-calendar-heading>` per month.
+     * @default 1
+     */
+    numberOfMonths: number;
+    /**
+     * BCP 47 tag used to derive month and weekday names (via `Intl`) and, when
+     * `week-starts-on` is omitted, the first day of the week.
+     * @default undefined — the runtime's own locale.
+     */
+    locale?: string;
+    /**
+     * Day of week the grid's first column represents (`0` = Sunday … `6` = Saturday).
+     * @default undefined — derived from `locale`, falling back to `0` (Sunday).
+     */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Earliest selectable date; earlier dates render disabled. */
+    minDate?: Date;
+    /** Latest selectable date; later dates render disabled. */
+    maxDate?: Date;
+    /** Predicate marking arbitrary dates as disabled, in addition to minDate/maxDate. */
+    disabled?: (date: Date) => boolean;
+    /**
+     * Predicate marking dates as *unavailable* — a booked hotel night, a closed
+     * clinic day. Receives the cell's local `YYYY-MM-DD` string. Property only:
+     * it is a function, so there is no attribute form.
+     *
+     * Distinct from `disabled`: an unavailable cell stays keyboard-reachable and
+     * is announced as `aria-disabled`, so a screen-reader user can arrow onto it
+     * and hear *why* it can't be picked, where a `disabled` cell is skipped
+     * entirely.
+     */
+    isDateUnavailable?: (isoDate: string) => boolean;
+    /**
+     * Words the polite live-region message announced after a selection change in
+     * `multiple` and `range` mode — the state that changed lives across several
+     * cells, so no cell's own `aria-selected` flip carries it. Return `''` to
+     * announce nothing.
+     *
+     * The month and weekday names around it are already localized by `locale`;
+     * this sentence is the one string in the calendar that a `locale` cannot
+     * translate on its own. Property only — it is a function.
+     * @default undefined — the built-in English wording ("Range selected, 1 May to 8 May.").
+     */
+    getSelectionAnnouncement?: (value: CalendarValue, locale: string | undefined) => string;
+    /** The currently roving-focused date (tabindex=0 cell). */
+    focusedDate: Date;
+    /** The first day of the week actually in effect: `weekStartsOn`, else whatever `locale` implies. */
+    get resolvedWeekStartsOn(): 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Every displayed month, `numberOfMonths` long, starting at `month`. @internal */
+    get months(): Date[];
+    /** Weekday names for `locale`, rotated to start at the resolved week start, as short/long pairs. @internal */
+    get weekDayNames(): Array<{
+        short: string;
+        long: string;
+    }>;
+    connectedCallback(): void;
+    /**
+     * Folds `date` into the current selection per `selectionMode`, moves roving
+     * focus to it, and dispatches `value-change` with the *whole* new selection.
+     *
+     * Range and multi-select changes are also pushed through the shared
+     * LiveAnnouncer: that state lives across several cells, so no single
+     * `aria-selected` flip conveys it (a single-date pick needs no announcement).
+     */
+    setValue(date: Date): void;
+    /** Sets `month` (normalized to its first day) and dispatches `month-change`. The month already displayed is a no-op. */
+    setMonth(date: Date): void;
+    /** Sets the roving-focus date without changing selection. */
+    setFocusedDate(date: Date): void;
+    private emit;
+    private notify;
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(changed: Map<string, unknown>): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-calendar': SkdxCalendar;
+    }
+}