@skdx/web-components 0.27.0 → 0.28.0

package/dist/timeline/Timeline.d.ts

@@ -1,22 +1,38 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
+/** One event on a derived `<skdx-timeline>`: the whole of what `items` takes. */
+export interface SkdxTimelineItemDescriptor {
+    /** The event itself — the Item's body text. */
+    content: string;
+    /** Metadata on the far side of the marker: a timestamp, an actor, an elapsed time. */
+    opposite?: string;
+    /**
+     * Text, a glyph, or a rendered icon inside the marker. An Indicator given
+     * content is announced and names itself by that text; left empty it is
+     * decorative and hidden.
+     * @default undefined — a decorative, aria-hidden marker.
+     */
+    indicator?: string | TemplateResult;
+    /**
+     * Accessible name for a non-decorative `indicator`, where its glyph is not
+     * one — a `✓` reads as "check mark" and a `2` as "2".
+     * @default undefined — the indicator is named by its own text.
+     */
+    indicatorLabel?: string;
+    /** Where this event sits in the sequence, emitted as `data-state`. @default undefined — `complete`, the resting state. */
+    state?: 'complete' | 'current' | 'pending';
+}
 /**
- * `<skdx-timeline>` — the Web Components implementation of the shared
- * Timeline contract (see `@skdx/shared`'s `timelineContract`). Purely
- * structural: renders a real `<ol>` inside shadow DOM (`:host { display:
- * contents }`, the same technique `<skdx-table>` uses for its `<table>`) with
- * `data-orientation` for styling. No ARIA role or keyboard behavior beyond
- * the semantic ordered list — layout and connecting lines are entirely up
- * to your CSS.
+ * Renders an `<ol role="list">` inside shadow DOM with no keyboard interaction
+ * — layout and lines are CSS-only. Pass `items` for auto-derived entries or
+ * write child parts for manual composition. The role is explicit: `list-style: none`
+ * and `display: grid` cause Safari/VoiceOver to drop list semantics from that combination.
  *
  * @example
  * ```html
- * <skdx-timeline>
- *   <skdx-timeline-item>
- *     <skdx-timeline-indicator></skdx-timeline-indicator>
- *     <skdx-timeline-separator></skdx-timeline-separator>
- *     <skdx-timeline-content>Order placed</skdx-timeline-content>
- *   </skdx-timeline-item>
- * </skdx-timeline>
+ * <skdx-timeline></skdx-timeline>
+ * ```
+ * ```ts
+ * timeline.items = [{ content: 'Order placed', opposite: '09:41' }];
  * ```
  *
  * @csspart timeline - The native `<ol>` element inside the shadow root.
@@ -30,7 +46,40 @@ export declare class SkdxTimeline extends LitElement {
      * @default 'vertical'
      */
     orientation: 'vertical' | 'horizontal';
-    render(): import("lit").TemplateResult<1>;
+    /**
+     * The events, in order — one Item/Opposite/Indicator/Separator/Content set
+     * is derived per entry. Property only: an array of objects has no attribute
+     * form.
+     * @default undefined — nothing is derived, and hand-composed children stand.
+     */
+    items?: readonly SkdxTimelineItemDescriptor[];
+    /**
+     * Renders each event's body, in place of its `content` string — return
+     * anything Lit can render. Property only: a function has no attribute form.
+     * @default undefined — the entry's `content` is rendered as text.
+     */
+    renderContent?: (item: SkdxTimelineItemDescriptor, index: number) => unknown;
+    connectedCallback(): void;
+    /**
+     * Draws the canonical anatomy into the light DOM when this element has no
+     * consumer-authored part, and hands it straight back once one appears.
+     */
+    private readonly fillAnatomy;
+    /**
+     * Mirrors `data-orientation` onto the **host** as well as onto the shadow
+     * `<ol>`.
+     *
+     * `applyHostPart` puts `.skdx-timeline` on the host, and every `@sdxui/skins`
+     * selector is written `:where(.skdx-timeline)…`. With the attribute only on
+     * the inner `<ol>`, the class and the hook lived on different elements and
+     * `:where(.skdx-timeline)[data-orientation='horizontal']` matched nothing in
+     * this package alone — so implementing the horizontal axis would have fixed
+     * four packages and silently skipped the fifth.
+     *
+     * `<skdx-data-list>` solves the identical problem the identical way.
+     */
+    protected updated(changed: Map<string, unknown>): void;
+    render(): TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/timeline/Timeline.js

@@ -1,7 +1,7 @@
-var m=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var s=(i,o,a,r)=>{for(var t=r>1?void 0:r?p(o,a):o,l=i.length-1,n;l>=0;l--)(n=i[l])&&(t=(r?n(o,a,t):n(t))||t);return r&&t&&m(o,a,t),t};import{css as c,html as d,LitElement as f}from"lit";import{property as h}from"lit/decorators.js";import{customElement as v}from"../internal/define.js";var e=class extends f{constructor(){super(...arguments);this.orientation="vertical"}render(){return d`<ol part="timeline" data-orientation=${this.orientation}>
-      <slot></slot>
-    </ol>`}};e.styles=c`
+var p=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var o=(a,i,r,n)=>{for(var e=n>1?void 0:n?c(i,r):i,s=a.length-1,l;s>=0;s--)(l=a[s])&&(e=(n?l(i,r,e):l(e))||e);return n&&e&&p(i,r,e),e};import{css as d,html as f,LitElement as u}from"lit";import{property as m}from"lit/decorators.js";import{hasAuthoredParts as h}from"../internal/authored.js";import{customElement as y}from"../internal/define.js";import{reflectHostState as v}from"../internal/part.js";import{fillTimelineAnatomy as g,TIMELINE_ANATOMY_GENERATED as A}from"./TimelineAnatomy.js";var t=class extends u{constructor(){super(...arguments);this.orientation="vertical";this.fillAnatomy=()=>{h(this,A)||g(this)}}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(r){v(this,{"data-orientation":this.orientation}),(r.has("items")||r.has("renderContent"))&&this.fillAnatomy()}render(){return f`<ol part="timeline" role="list" data-orientation=${this.orientation}>
+      <slot @slotchange=${this.fillAnatomy}></slot>
+    </ol>`}};t.styles=d`
     :host {
       display: contents;
     }
-  `,s([h({type:String})],e.prototype,"orientation",2),e=s([v("skdx-timeline","timeline","root")],e);export{e as SkdxTimeline};
+  `,o([m({type:String})],t.prototype,"orientation",2),o([m({attribute:!1})],t.prototype,"items",2),o([m({attribute:!1})],t.prototype,"renderContent",2),t=o([y("skdx-timeline","timeline","root")],t);export{t as SkdxTimeline};

package/dist/timeline/TimelineAnatomy.cjs

@@ -0,0 +1,12 @@
+"use strict";var r=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var p=(e,i)=>{for(var t in i)r(e,t,{get:i[t],enumerable:!0})},x=(e,i,t,o)=>{if(i&&typeof i=="object"||typeof i=="function")for(let m of a(i))!l.call(e,m)&&m!==t&&r(e,m,{get:()=>i[m],enumerable:!(o=s(i,m))||o.enumerable});return e};var k=e=>x(r({},"__esModule",{value:!0}),e);var $={};p($,{TIMELINE_ANATOMY_GENERATED:()=>c,fillTimelineAnatomy:()=>T});module.exports=k($);var n=require("lit"),d=require("lit/directives/repeat.js"),E=require("./TimelineItem.cjs"),g=require("./TimelineOpposite.cjs"),h=require("./TimelineIndicator.cjs"),A=require("./TimelineSeparator.cjs"),N=require("./TimelineContent.cjs"),c="data-skdx-timeline-generated";function T(e){let i=e.items??[];(0,n.render)((0,d.repeat)(i,(t,o)=>o,(t,o)=>n.html`
+        <skdx-timeline-item data-skdx-timeline-generated data-state=${t.state??n.nothing}>
+          ${t.opposite?n.html`<skdx-timeline-opposite>${t.opposite}</skdx-timeline-opposite>`:n.nothing}
+          <skdx-timeline-indicator aria-label=${t.indicatorLabel??n.nothing}
+            >${t.indicator??n.nothing}</skdx-timeline-indicator
+          >
+          ${o<i.length-1?n.html`<skdx-timeline-separator></skdx-timeline-separator>`:n.nothing}
+          <skdx-timeline-content
+            >${e.renderContent?e.renderContent(t,o):t.content}</skdx-timeline-content
+          >
+        </skdx-timeline-item>
+      `),e,{host:e})}0&&(module.exports={TIMELINE_ANATOMY_GENERATED,fillTimelineAnatomy});

package/dist/timeline/TimelineAnatomy.d.cts

@@ -0,0 +1,16 @@
+import type { SkdxTimeline } from './Timeline.cjs';
+import './TimelineItem.cjs';
+import './TimelineOpposite.cjs';
+import './TimelineIndicator.cjs';
+import './TimelineSeparator.cjs';
+import './TimelineContent.cjs';
+/**
+ * @internal Marks direct `<skdx-timeline>` children this module generated (written in template).
+ */
+export declare const TIMELINE_ANATOMY_GENERATED = "data-skdx-timeline-generated";
+/**
+ * Builds one Item per entry: Opposite, Indicator, Separator (omitted last), Content. DOM order
+ * is reading order (metadata before event). Assumes no consumer composition.
+ * @internal
+ */
+export declare function fillTimelineAnatomy(root: SkdxTimeline): void;

package/dist/timeline/TimelineAnatomy.d.ts

@@ -0,0 +1,16 @@
+import type { SkdxTimeline } from './Timeline.js';
+import './TimelineItem.js';
+import './TimelineOpposite.js';
+import './TimelineIndicator.js';
+import './TimelineSeparator.js';
+import './TimelineContent.js';
+/**
+ * @internal Marks direct `<skdx-timeline>` children this module generated (written in template).
+ */
+export declare const TIMELINE_ANATOMY_GENERATED = "data-skdx-timeline-generated";
+/**
+ * Builds one Item per entry: Opposite, Indicator, Separator (omitted last), Content. DOM order
+ * is reading order (metadata before event). Assumes no consumer composition.
+ * @internal
+ */
+export declare function fillTimelineAnatomy(root: SkdxTimeline): void;

package/dist/timeline/TimelineAnatomy.js

@@ -0,0 +1,12 @@
+import{html as o,render as r,nothing as i}from"lit";import{repeat as d}from"lit/directives/repeat.js";import"./TimelineItem.js";import"./TimelineOpposite.js";import"./TimelineIndicator.js";import"./TimelineSeparator.js";import"./TimelineContent.js";var T="data-skdx-timeline-generated";function $(t){let m=t.items??[];r(d(m,(e,n)=>n,(e,n)=>o`
+        <skdx-timeline-item data-skdx-timeline-generated data-state=${e.state??i}>
+          ${e.opposite?o`<skdx-timeline-opposite>${e.opposite}</skdx-timeline-opposite>`:i}
+          <skdx-timeline-indicator aria-label=${e.indicatorLabel??i}
+            >${e.indicator??i}</skdx-timeline-indicator
+          >
+          ${n<m.length-1?o`<skdx-timeline-separator></skdx-timeline-separator>`:i}
+          <skdx-timeline-content
+            >${t.renderContent?t.renderContent(e,n):e.content}</skdx-timeline-content
+          >
+        </skdx-timeline-item>
+      `),t,{host:t})}export{T as TIMELINE_ANATOMY_GENERATED,$ as fillTimelineAnatomy};

package/dist/timeline/TimelineIndicator.cjs

@@ -1,5 +1,5 @@
-"use strict";var m=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var E=(r,e)=>{for(var s in e)m(r,s,{get:e[s],enumerable:!0})},b=(r,e,s,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!y.call(r,t)&&t!==s&&m(r,t,{get:()=>e[t],enumerable:!(o=c(e,t))||o.enumerable});return r};var g=r=>b(m({},"__esModule",{value:!0}),r),d=(r,e,s,o)=>{for(var t=o>1?void 0:o?c(e,s):e,a=r.length-1,n;a>=0;a--)(n=r[a])&&(t=(o?n(e,s,t):n(t))||t);return o&&t&&m(e,s,t),t};var u={};E(u,{SkdxTimelineIndicator:()=>l});module.exports=g(u);var i=require("lit"),p=require("../internal/define.cjs"),f=require("../internal/styles.cjs");var l=class extends i.LitElement{render(){return i.html`<slot></slot>`}};l.styles=[f.hiddenHostStyles,i.css`
+"use strict";var l=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var g=(i,e)=>{for(var r in e)l(i,r,{get:e[r],enumerable:!0})},E=(i,e,r,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of b(e))!p.call(i,t)&&t!==r&&l(i,t,{get:()=>e[t],enumerable:!(o=c(e,t))||o.enumerable});return i};var f=i=>E(l({},"__esModule",{value:!0}),i),h=(i,e,r,o)=>{for(var t=o>1?void 0:o?c(e,r):e,d=i.length-1,n;d>=0;d--)(n=i[d])&&(t=(o?n(e,r,t):n(t))||t);return o&&t&&l(e,r,t),t};var A={};g(A,{SkdxTimelineIndicator:()=>s});module.exports=f(A);var a=require("lit"),m=require("lit/decorators.js"),v=require("../internal/define.cjs"),u=require("../internal/styles.cjs");var s=class extends a.LitElement{constructor(){super(...arguments);this.decorative=!0;this.onSlotChange=r=>{let o=r.target.assignedNodes({flatten:!0});this.decorative=!o.some(t=>(t.textContent?.trim()??"")!==""||t.nodeType===Node.ELEMENT_NODE)&&!this.hasAttribute("aria-label")&&!this.hasAttribute("aria-labelledby")}}updated(){this.decorative?(this.setAttribute("aria-hidden","true"),this.removeAttribute("role")):(this.removeAttribute("aria-hidden"),this.setAttribute("role","img"))}connectedCallback(){super.connectedCallback(),this.decorative&&this.setAttribute("aria-hidden","true")}render(){return a.html`<slot @slotchange=${this.onSlotChange}></slot>`}};s.styles=[u.hiddenHostStyles,a.css`
       :host {
         display: block;
       }
-    `],l=d([(0,p.customElement)("skdx-timeline-indicator","timeline","indicator")],l);0&&(module.exports={SkdxTimelineIndicator});
+    `],h([(0,m.state)()],s.prototype,"decorative",2),s=h([(0,v.customElement)("skdx-timeline-indicator","timeline","indicator")],s);0&&(module.exports={SkdxTimelineIndicator});

package/dist/timeline/TimelineIndicator.d.cts

@@ -1,7 +1,16 @@
 import { LitElement } from 'lit';
-/** `<skdx-timeline-indicator>` — the dot/icon marker for a `<skdx-timeline-item>`. Purely presentational. */
+/**
+ * The dot/icon marker for a timeline item: empty and `aria-hidden="true"` on
+ * the host by default, or filled with content (icon, number, check) requiring
+ * an accessible name via `aria-label` or text content.
+ */
 export declare class SkdxTimelineIndicator extends LitElement {
     static styles: import("lit").CSSResult[];
+    /** @internal Whether the slot is empty, re-read on every `slotchange`. */
+    private decorative;
+    private readonly onSlotChange;
+    protected updated(): void;
+    connectedCallback(): void;
     render(): import("lit").TemplateResult<1>;
 }
 declare global {

package/dist/timeline/TimelineIndicator.d.ts

@@ -1,7 +1,16 @@
 import { LitElement } from 'lit';
-/** `<skdx-timeline-indicator>` — the dot/icon marker for a `<skdx-timeline-item>`. Purely presentational. */
+/**
+ * The dot/icon marker for a timeline item: empty and `aria-hidden="true"` on
+ * the host by default, or filled with content (icon, number, check) requiring
+ * an accessible name via `aria-label` or text content.
+ */
 export declare class SkdxTimelineIndicator extends LitElement {
     static styles: import("lit").CSSResult[];
+    /** @internal Whether the slot is empty, re-read on every `slotchange`. */
+    private decorative;
+    private readonly onSlotChange;
+    protected updated(): void;
+    connectedCallback(): void;
     render(): import("lit").TemplateResult<1>;
 }
 declare global {

package/dist/timeline/TimelineIndicator.js

@@ -1,5 +1,5 @@
-var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var a=(o,r,l,s)=>{for(var e=s>1?void 0:s?c(r,l):r,i=o.length-1,m;i>=0;i--)(m=o[i])&&(e=(s?m(r,l,e):m(e))||e);return s&&e&&n(r,l,e),e};import{css as d,html as p,LitElement as f}from"lit";import{customElement as h}from"../internal/define.js";import{hiddenHostStyles as y}from"../internal/styles.js";var t=class extends f{render(){return p`<slot></slot>`}};t.styles=[y,d`
+var n=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var d=(s,r,o,e)=>{for(var t=e>1?void 0:e?h(r,o):r,a=s.length-1,l;a>=0;a--)(l=s[a])&&(t=(e?l(r,o,t):l(t))||t);return e&&t&&n(r,o,t),t};import{css as c,html as m,LitElement as v}from"lit";import{state as u}from"lit/decorators.js";import{customElement as b}from"../internal/define.js";import{hiddenHostStyles as p}from"../internal/styles.js";var i=class extends v{constructor(){super(...arguments);this.decorative=!0;this.onSlotChange=o=>{let e=o.target.assignedNodes({flatten:!0});this.decorative=!e.some(t=>(t.textContent?.trim()??"")!==""||t.nodeType===Node.ELEMENT_NODE)&&!this.hasAttribute("aria-label")&&!this.hasAttribute("aria-labelledby")}}updated(){this.decorative?(this.setAttribute("aria-hidden","true"),this.removeAttribute("role")):(this.removeAttribute("aria-hidden"),this.setAttribute("role","img"))}connectedCallback(){super.connectedCallback(),this.decorative&&this.setAttribute("aria-hidden","true")}render(){return m`<slot @slotchange=${this.onSlotChange}></slot>`}};i.styles=[p,c`
       :host {
         display: block;
       }
-    `],t=a([h("skdx-timeline-indicator","timeline","indicator")],t);export{t as SkdxTimelineIndicator};
+    `],d([u()],i.prototype,"decorative",2),i=d([b("skdx-timeline-indicator","timeline","indicator")],i);export{i as SkdxTimelineIndicator};

package/dist/timeline/TimelineItem.d.cts

@@ -1,11 +1,8 @@
 import { LitElement } from 'lit';
 /**
- * `<skdx-timeline-item>` — a single entry in the timeline, typically
- * composing a `<skdx-timeline-indicator>`, an optional
- * `<skdx-timeline-separator>`, and `<skdx-timeline-content>`. Sets
- * `role="listitem"` on the host (it isn't a real `<li>`, since the ancestor
- * `<skdx-timeline>`'s real `<ol>` lives inside that element's own shadow
- * root and this element is merely slotted into it).
+ * A single timeline entry composed of indicator, optional separator, content,
+ * and optional opposite in that order. DOM order is the reading order only with
+ * this arrangement. Sets `role="listitem"` on the host.
  */
 export declare class SkdxTimelineItem extends LitElement {
     static styles: import("lit").CSSResult[];

package/dist/timeline/TimelineItem.d.ts

@@ -1,11 +1,8 @@
 import { LitElement } from 'lit';
 /**
- * `<skdx-timeline-item>` — a single entry in the timeline, typically
- * composing a `<skdx-timeline-indicator>`, an optional
- * `<skdx-timeline-separator>`, and `<skdx-timeline-content>`. Sets
- * `role="listitem"` on the host (it isn't a real `<li>`, since the ancestor
- * `<skdx-timeline>`'s real `<ol>` lives inside that element's own shadow
- * root and this element is merely slotted into it).
+ * A single timeline entry composed of indicator, optional separator, content,
+ * and optional opposite in that order. DOM order is the reading order only with
+ * this arrangement. Sets `role="listitem"` on the host.
  */
 export declare class SkdxTimelineItem extends LitElement {
     static styles: import("lit").CSSResult[];

package/dist/timeline/TimelineOpposite.cjs

@@ -0,0 +1,5 @@
+"use strict";var i=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var E=(o,e)=>{for(var r in e)i(o,r,{get:e[r],enumerable:!0})},b=(o,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!y.call(o,t)&&t!==r&&i(o,t,{get:()=>e[t],enumerable:!(s=c(e,t))||s.enumerable});return o};var g=o=>b(i({},"__esModule",{value:!0}),o),d=(o,e,r,s)=>{for(var t=s>1?void 0:s?c(e,r):e,a=o.length-1,n;a>=0;a--)(n=o[a])&&(t=(s?n(e,r,t):n(t))||t);return s&&t&&i(e,r,t),t};var u={};E(u,{SkdxTimelineOpposite:()=>l});module.exports=g(u);var m=require("lit"),p=require("../internal/define.cjs"),f=require("../internal/styles.cjs");var l=class extends m.LitElement{render(){return m.html`<slot></slot>`}};l.styles=[f.hiddenHostStyles,m.css`
+      :host {
+        display: block;
+      }
+    `],l=d([(0,p.customElement)("skdx-timeline-opposite","timeline","opposite")],l);0&&(module.exports={SkdxTimelineOpposite});

package/dist/timeline/TimelineOpposite.d.cts

@@ -0,0 +1,15 @@
+import { LitElement } from 'lit';
+/**
+ * The metadata region opposite a timeline item (timestamp, actor, elapsed time)
+ * in its own grid column. Slot it before `<skdx-timeline-indicator>` so reading
+ * order matches visual order — the skin places by column, not DOM order.
+ */
+export declare class SkdxTimelineOpposite extends LitElement {
+    static styles: import("lit").CSSResult[];
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-timeline-opposite': SkdxTimelineOpposite;
+    }
+}

package/dist/timeline/TimelineOpposite.d.ts

@@ -0,0 +1,15 @@
+import { LitElement } from 'lit';
+/**
+ * The metadata region opposite a timeline item (timestamp, actor, elapsed time)
+ * in its own grid column. Slot it before `<skdx-timeline-indicator>` so reading
+ * order matches visual order — the skin places by column, not DOM order.
+ */
+export declare class SkdxTimelineOpposite extends LitElement {
+    static styles: import("lit").CSSResult[];
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-timeline-opposite': SkdxTimelineOpposite;
+    }
+}

package/dist/timeline/TimelineOpposite.js

@@ -0,0 +1,5 @@
+var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var a=(s,o,l,r)=>{for(var e=r>1?void 0:r?c(o,l):o,m=s.length-1,i;m>=0;m--)(i=s[m])&&(e=(r?i(o,l,e):i(e))||e);return r&&e&&n(o,l,e),e};import{css as d,html as p,LitElement as f}from"lit";import{customElement as h}from"../internal/define.js";import{hiddenHostStyles as y}from"../internal/styles.js";var t=class extends f{render(){return p`<slot></slot>`}};t.styles=[y,d`
+      :host {
+        display: block;
+      }
+    `],t=a([h("skdx-timeline-opposite","timeline","opposite")],t);export{t as SkdxTimelineOpposite};

package/dist/timeline/index.cjs

@@ -1 +1 @@
-"use strict";var m=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var T=(o,e)=>{for(var i in e)m(o,i,{get:e[i],enumerable:!0})},a=(o,e,i,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of k(e))!l.call(o,r)&&r!==i&&m(o,r,{get:()=>e[r],enumerable:!(t=f(e,r))||t.enumerable});return o};var I=o=>a(m({},"__esModule",{value:!0}),o);var c={};T(c,{SkdxTimeline:()=>x.SkdxTimeline,SkdxTimelineContent:()=>S.SkdxTimelineContent,SkdxTimelineIndicator:()=>d.SkdxTimelineIndicator,SkdxTimelineItem:()=>n.SkdxTimelineItem,SkdxTimelineSeparator:()=>p.SkdxTimelineSeparator});module.exports=I(c);var x=require("./Timeline.cjs"),n=require("./TimelineItem.cjs"),d=require("./TimelineIndicator.cjs"),p=require("./TimelineSeparator.cjs"),S=require("./TimelineContent.cjs");0&&(module.exports={SkdxTimeline,SkdxTimelineContent,SkdxTimelineIndicator,SkdxTimelineItem,SkdxTimelineSeparator});
+"use strict";var t=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var l=(i,e)=>{for(var r in e)t(i,r,{get:e[r],enumerable:!0})},n=(i,e,r,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let m of d(e))!k.call(i,m)&&m!==r&&t(i,m,{get:()=>e[m],enumerable:!(o=x(e,m))||o.enumerable});return i};var S=i=>n(t({},"__esModule",{value:!0}),i);var T={};l(T,{SkdxTimeline:()=>p.SkdxTimeline});module.exports=S(T);var p=require("./Timeline.cjs");0&&(module.exports={SkdxTimeline});

package/dist/timeline/index.d.cts

@@ -1,5 +1 @@
-export { SkdxTimeline } from './Timeline.cjs';
-export { SkdxTimelineItem } from './TimelineItem.cjs';
-export { SkdxTimelineIndicator } from './TimelineIndicator.cjs';
-export { SkdxTimelineSeparator } from './TimelineSeparator.cjs';
-export { SkdxTimelineContent } from './TimelineContent.cjs';
+export { SkdxTimeline, type SkdxTimelineItemDescriptor } from './Timeline.cjs';

package/dist/timeline/index.d.ts

@@ -1,5 +1 @@
-export { SkdxTimeline } from './Timeline.js';
-export { SkdxTimelineItem } from './TimelineItem.js';
-export { SkdxTimelineIndicator } from './TimelineIndicator.js';
-export { SkdxTimelineSeparator } from './TimelineSeparator.js';
-export { SkdxTimelineContent } from './TimelineContent.js';
+export { SkdxTimeline, type SkdxTimelineItemDescriptor } from './Timeline.js';

package/dist/timeline/index.js

@@ -1 +1 @@
-import{SkdxTimeline as r}from"./Timeline.js";import{SkdxTimelineItem as m}from"./TimelineItem.js";import{SkdxTimelineIndicator as x}from"./TimelineIndicator.js";import{SkdxTimelineSeparator as d}from"./TimelineSeparator.js";import{SkdxTimelineContent as S}from"./TimelineContent.js";export{r as SkdxTimeline,S as SkdxTimelineContent,x as SkdxTimelineIndicator,m as SkdxTimelineItem,d as SkdxTimelineSeparator};
+import{SkdxTimeline as m}from"./Timeline.js";export{m as SkdxTimeline};

package/dist/timeline/primitives.cjs

@@ -0,0 +1 @@
+"use strict";var m=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var T=(o,e)=>{for(var i in e)m(o,i,{get:e[i],enumerable:!0})},a=(o,e,i,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of k(e))!l.call(o,r)&&r!==i&&m(o,r,{get:()=>e[r],enumerable:!(t=f(e,r))||t.enumerable});return o};var I=o=>a(m({},"__esModule",{value:!0}),o);var c={};T(c,{SkdxTimelineContent:()=>d.SkdxTimelineContent,SkdxTimelineIndicator:()=>n.SkdxTimelineIndicator,SkdxTimelineItem:()=>x.SkdxTimelineItem,SkdxTimelineOpposite:()=>S.SkdxTimelineOpposite,SkdxTimelineSeparator:()=>p.SkdxTimelineSeparator});module.exports=I(c);var x=require("./TimelineItem.cjs"),n=require("./TimelineIndicator.cjs"),p=require("./TimelineSeparator.cjs"),d=require("./TimelineContent.cjs"),S=require("./TimelineOpposite.cjs");0&&(module.exports={SkdxTimelineContent,SkdxTimelineIndicator,SkdxTimelineItem,SkdxTimelineOpposite,SkdxTimelineSeparator});

package/dist/timeline/primitives.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Primitives for `<skdx-timeline>`.
+ * @example
+ * ```ts
+ * import * as Timeline from '@skdx/web-components/primitives/timeline';
+ * ```
+ * ```html
+ * <skdx-timeline>
+ *   <skdx-timeline-item>
+ *     <skdx-timeline-opposite>09:41</skdx-timeline-opposite>
+ *     <skdx-timeline-indicator></skdx-timeline-indicator>
+ *     <skdx-timeline-separator></skdx-timeline-separator>
+ *     <skdx-timeline-content>Order placed</skdx-timeline-content>
+ *   </skdx-timeline-item>
+ * </skdx-timeline>
+ * ```
+ */
+export { SkdxTimelineItem } from './TimelineItem.cjs';
+export { SkdxTimelineIndicator } from './TimelineIndicator.cjs';
+export { SkdxTimelineSeparator } from './TimelineSeparator.cjs';
+export { SkdxTimelineContent } from './TimelineContent.cjs';
+export { SkdxTimelineOpposite } from './TimelineOpposite.cjs';

package/dist/timeline/primitives.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Primitives for `<skdx-timeline>`.
+ * @example
+ * ```ts
+ * import * as Timeline from '@skdx/web-components/primitives/timeline';
+ * ```
+ * ```html
+ * <skdx-timeline>
+ *   <skdx-timeline-item>
+ *     <skdx-timeline-opposite>09:41</skdx-timeline-opposite>
+ *     <skdx-timeline-indicator></skdx-timeline-indicator>
+ *     <skdx-timeline-separator></skdx-timeline-separator>
+ *     <skdx-timeline-content>Order placed</skdx-timeline-content>
+ *   </skdx-timeline-item>
+ * </skdx-timeline>
+ * ```
+ */
+export { SkdxTimelineItem } from './TimelineItem.js';
+export { SkdxTimelineIndicator } from './TimelineIndicator.js';
+export { SkdxTimelineSeparator } from './TimelineSeparator.js';
+export { SkdxTimelineContent } from './TimelineContent.js';
+export { SkdxTimelineOpposite } from './TimelineOpposite.js';

package/dist/timeline/primitives.js

@@ -0,0 +1 @@
+import{SkdxTimelineItem as r}from"./TimelineItem.js";import{SkdxTimelineIndicator as m}from"./TimelineIndicator.js";import{SkdxTimelineSeparator as x}from"./TimelineSeparator.js";import{SkdxTimelineContent as p}from"./TimelineContent.js";import{SkdxTimelineOpposite as S}from"./TimelineOpposite.js";export{p as SkdxTimelineContent,m as SkdxTimelineIndicator,r as SkdxTimelineItem,S as SkdxTimelineOpposite,x as SkdxTimelineSeparator};

package/dist/toast/Toast.cjs

@@ -1,5 +1,7 @@
-"use strict";var h=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var b=(r,t)=>{for(var e in t)h(r,e,{get:t[e],enumerable:!0})},g=(r,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of f(t))!y.call(r,i)&&i!==e&&h(r,i,{get:()=>t[i],enumerable:!(n=l(t,i))||n.enumerable});return r};var T=r=>g(h({},"__esModule",{value:!0}),r),o=(r,t,e,n)=>{for(var i=n>1?void 0:n?l(t,e):t,p=r.length-1,u;p>=0;p--)(u=r[p])&&(i=(n?u(t,e,i):u(i))||i);return n&&i&&h(t,e,i),i};var E={};b(E,{SkdxToast:()=>s});module.exports=T(E);var d=require("lit"),a=require("lit/decorators.js"),m=require("../internal/define.cjs"),v=require("../internal/positioning.cjs"),c=require("../internal/styles.cjs");var s=class extends d.LitElement{constructor(){super(...arguments);this.defaultOpen=!0;this.type="foreground";this._uncontrolledOpen=!0;this._initialized=!1;this.provider=null;this.remaining=0;this.startTime=0;this.startTimer=()=>{Number.isFinite(this.remaining)&&(clearTimeout(this.timerId),this.startTime=Date.now(),this.timerId=setTimeout(()=>this.setOpen(!1),this.remaining))};this.pauseTimer=()=>{clearTimeout(this.timerId),this.remaining-=Date.now()-this.startTime,this.startTime=Date.now()};this.handleVisibilityChange=()=>{this.currentOpen&&(document.hidden?this.pauseTimer():this.startTimer())};this.handleKeyDown=e=>{e.key==="Escape"&&this.setOpen(!1)}}get currentOpen(){return this.open!==void 0?this.open:this._uncontrolledOpen}connectedCallback(){super.connectedCallback(),this._initialized||(this._uncontrolledOpen=this.defaultOpen,this._initialized=!0),this.provider=this.closest("skdx-toast-provider"),this.hasAttribute("role")||this.setAttribute("role","status"),this.tabIndex=0,this.addEventListener("pointerenter",this.pauseTimer),this.addEventListener("pointerleave",this.startTimer),this.addEventListener("focus",this.pauseTimer),this.addEventListener("blur",this.startTimer),this.addEventListener("keydown",this.handleKeyDown),document.addEventListener("visibilitychange",this.handleVisibilityChange),window.addEventListener("pagehide",this.pauseTimer),this.syncState(),this.currentOpen&&(this.remaining=this.getDuration(),this.startTimer(),this.announce())}disconnectedCallback(){clearTimeout(this.timerId),this.removeEventListener("pointerenter",this.pauseTimer),this.removeEventListener("pointerleave",this.startTimer),this.removeEventListener("focus",this.pauseTimer),this.removeEventListener("blur",this.startTimer),this.removeEventListener("keydown",this.handleKeyDown),document.removeEventListener("visibilitychange",this.handleVisibilityChange),window.removeEventListener("pagehide",this.pauseTimer),super.disconnectedCallback()}updated(e){e.has("open")&&this.open!==void 0&&(this.syncState(),this.currentOpen?(this.remaining=this.getDuration(),this.startTimer()):clearTimeout(this.timerId))}getDuration(){return this.duration??this.provider?.duration??5e3}announce(){let e=this.textContent?.trim()??"",n=this.provider;!n||!e||n.updateComplete.then(()=>{n.announce(e,this.type==="foreground"?"assertive":"polite")})}syncState(){let e=this.currentOpen;this.setAttribute("data-state",e?"open":"closed"),this.hidden=!e}setOpen(e){this.currentOpen!==e&&(this.open===void 0&&(this._uncontrolledOpen=e,this.syncState(),e?(this.remaining=this.getDuration(),this.startTimer()):clearTimeout(this.timerId)),this.dispatchEvent(new CustomEvent("open-change",{detail:e,bubbles:!0,composed:!0})))}render(){return d.html`<slot></slot>`}};s.styles=[c.hiddenHostStyles,d.css`
+"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var E=(s,n)=>{for(var e in n)l(s,e,{get:n[e],enumerable:!0})},P=(s,n,e,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of b(n))!g.call(s,i)&&i!==e&&l(s,i,{get:()=>n[i],enumerable:!(t=u(n,i))||t.enumerable});return s};var T=s=>P(l({},"__esModule",{value:!0}),s),a=(s,n,e,t)=>{for(var i=t>1?void 0:t?u(n,e):n,r=s.length-1,p;r>=0;r--)(p=s[r])&&(i=(t?p(n,e,i):p(i))||i);return t&&i&&l(n,e,i),i};var L={};E(L,{SkdxToast:()=>o});module.exports=T(L);var h=require("lit"),d=require("lit/decorators.js"),c=require("../internal/define.cjs"),v=require("../internal/direction.cjs"),m=require("../internal/open-change-complete.cjs"),f=require("../internal/positioning.cjs"),y=require("../internal/styles.cjs");var O=0,o=class extends h.LitElement{constructor(){super(...arguments);this.defaultOpen=!0;this.type="background";this._uncontrolledOpen=!0;this.paused=!1;this._initialized=!1;this.provider=null;this.remaining=0;this.startTime=0;this.wasOpen=!1;this.announcementPending=!1;this.hasSyncedOnce=!1;this.swipeStart=null;this.swipeDirectionResolved="right";this.setPaused=e=>{this.paused!==e&&(this.paused=e,this.toggleAttribute("data-paused",e),this.dispatchEvent(new CustomEvent(e?"pause":"resume",{bubbles:!0,composed:!0})))};this.startTimer=()=>{this.setPaused(!1),Number.isFinite(this.remaining)&&(clearTimeout(this.timerId),this.startTime=Date.now(),this.timerId=setTimeout(()=>this.setOpen(!1),this.remaining))};this.pauseTimer=()=>{clearTimeout(this.timerId),this.remaining-=Date.now()-this.startTime,this.startTime=Date.now(),Number.isFinite(this.remaining)&&this.setPaused(!0)};this.handleVisibilityChange=()=>{this.currentOpen&&(document.hidden?this.pauseTimer():this.startTimer())};this.handleKeyDown=e=>{e.key==="Escape"&&(this.dispatchEvent(new CustomEvent("escape-key-down",{detail:e,bubbles:!0,composed:!0})),!e.defaultPrevented&&this.setOpen(!1))};this.handlePointerDown=e=>{if(!e.isPrimary)return;let t=this.resolveSwipeDirection(this.provider?.swipeDirection??"end");this.swipeDirectionResolved=t,this.swipeStart={x:e.clientX,y:e.clientY,pointerId:e.pointerId},this.setPointerCapture?.(e.pointerId),this.setSwipe("start"),this.setAttribute("data-swipe-direction",t),this.pauseTimer()};this.handlePointerMove=e=>{let t=this.swipeStart;if(!t||e.pointerId!==t.pointerId)return;let i=e.clientX-t.x,r=e.clientY-t.y;this.setSwipe("move"),this.style.setProperty("--skdx-toast-swipe-move-x",`${i}px`),this.style.setProperty("--skdx-toast-swipe-move-y",`${r}px`)};this.handlePointerUp=e=>{let t=this.swipeStart;if(!t||e.pointerId!==t.pointerId)return;this.swipeStart=null,this.releasePointerCapture?.(e.pointerId);let i=e.clientX-t.x,r=e.clientY-t.y,p=this.travelled(this.swipeDirectionResolved,i,r),w=this.provider?.swipeThreshold??50;p>=w?(this.setSwipe("end"),this.setOpen(!1)):(this.setSwipe("cancel"),this.style.removeProperty("--skdx-toast-swipe-move-x"),this.style.removeProperty("--skdx-toast-swipe-move-y"),this.startTimer())};this.handlePointerCancel=e=>{!this.swipeStart||this.swipeStart.pointerId!==e.pointerId||(this.swipeStart=null,this.releasePointerCapture?.(e.pointerId),this.setSwipe("cancel"),this.style.removeProperty("--skdx-toast-swipe-move-x"),this.style.removeProperty("--skdx-toast-swipe-move-y"),this.startTimer())};this.syncLabelling=()=>{for(let[e,t,i]of[["skdx-toast-title","aria-labelledby","title"],["skdx-toast-description","aria-describedby","description"]]){let r=this.querySelector(e);if(!r){this.removeAttribute(t);continue}r.id||(r.id=`skdx-toast-${i}-${++O}`),this.setAttribute(t,r.id)}};this.flushAnnouncement=()=>{let e=this.provider;if(!this.announcementPending||!this.currentOpen||!e)return;let t=this.textContent?.trim()??"";t&&(this.announcementPending=!1,e.updateComplete.then(()=>{e.announce(t,this.type==="foreground"?"assertive":"polite")}))}}get currentOpen(){return this.open!==void 0?this.open:this._uncontrolledOpen}connectedCallback(){super.connectedCallback(),this._initialized||(this._uncontrolledOpen=this.defaultOpen,this._initialized=!0),this.provider=this.closest("skdx-toast-provider"),this.provider===null&&!this.hasAttribute("role")&&this.setAttribute("role","status"),this.tabIndex=0,this.addEventListener("pointerenter",this.pauseTimer),this.addEventListener("pointerleave",this.startTimer),this.addEventListener("focus",this.pauseTimer),this.addEventListener("blur",this.startTimer),this.addEventListener("pointerdown",this.handlePointerDown),this.addEventListener("pointermove",this.handlePointerMove),this.addEventListener("pointerup",this.handlePointerUp),this.addEventListener("pointercancel",this.handlePointerCancel),this.addEventListener("keydown",this.handleKeyDown),document.addEventListener("visibilitychange",this.handleVisibilityChange),window.addEventListener("pagehide",this.pauseTimer),this.syncState(),this.syncLabelling(),this.syncOpenState()}disconnectedCallback(){clearTimeout(this.timerId),this.wasOpen=!1,this.hasSyncedOnce=!1,this.completeTeardown?.(),this.completeTeardown=void 0,this.removeEventListener("pointerenter",this.pauseTimer),this.removeEventListener("pointerleave",this.startTimer),this.removeEventListener("focus",this.pauseTimer),this.removeEventListener("blur",this.startTimer),this.removeEventListener("pointerdown",this.handlePointerDown),this.removeEventListener("pointermove",this.handlePointerMove),this.removeEventListener("pointerup",this.handlePointerUp),this.removeEventListener("pointercancel",this.handlePointerCancel),this.removeEventListener("keydown",this.handleKeyDown),document.removeEventListener("visibilitychange",this.handleVisibilityChange),window.removeEventListener("pagehide",this.pauseTimer),super.disconnectedCallback()}updated(e){e.has("open")&&this.open!==void 0&&(this.syncState(),this.syncOpenState())}syncOpenState(){let e=this.currentOpen,t=!this.hasSyncedOnce;if(!(e===this.wasOpen&&!t)){if(this.wasOpen=e,e?(this.remaining=this.getDuration(),this.startTimer(),this.announce()):clearTimeout(this.timerId),t){this.hasSyncedOnce=!0;return}this.completeTeardown?.(),this.completeTeardown=(0,m.notifyOpenChangeComplete)(()=>this,e,i=>this.dispatchEvent(new CustomEvent("open-change-complete",{detail:i,bubbles:!0,composed:!0})))}}getDuration(){return this.duration??this.provider?.duration??5e3}resolveSwipeDirection(e){if(e!=="start"&&e!=="end")return e;let t=(0,v.resolveDirection)(this)==="rtl";return e==="start"?t?"right":"left":t?"left":"right"}travelled(e,t,i){return e==="left"?-t:e==="right"?t:e==="up"?-i:i}setSwipe(e){this.setAttribute("data-swipe",e)}announce(){this.announcementPending=!0,this.flushAnnouncement()}syncState(){let e=this.currentOpen;this.setAttribute("data-state",e?"open":"closed"),this.hidden=!e}setOpen(e){this.currentOpen!==e&&(this.open===void 0&&(this._uncontrolledOpen=e,this.syncState(),this.syncOpenState()),this.dispatchEvent(new CustomEvent("open-change",{detail:e,bubbles:!0,composed:!0})))}render(){return h.html`<slot
+      @slotchange=${()=>{this.flushAnnouncement(),this.syncLabelling()}}
+    ></slot>`}};o.styles=[y.hiddenHostStyles,h.css`
       :host {
         display: block;
       }
-    `],o([(0,a.property)({type:Boolean})],s.prototype,"open",2),o([(0,a.property)({converter:v.optOutBoolean,attribute:"default-open"})],s.prototype,"defaultOpen",2),o([(0,a.property)({type:Number})],s.prototype,"duration",2),o([(0,a.property)({type:String})],s.prototype,"type",2),o([(0,a.state)()],s.prototype,"_uncontrolledOpen",2),s=o([(0,m.customElement)("skdx-toast","toast","root")],s);0&&(module.exports={SkdxToast});
+    `],a([(0,d.property)({type:Boolean})],o.prototype,"open",2),a([(0,d.property)({converter:f.optOutBoolean,attribute:"default-open"})],o.prototype,"defaultOpen",2),a([(0,d.property)({type:Number})],o.prototype,"duration",2),a([(0,d.property)({type:String})],o.prototype,"type",2),a([(0,d.state)()],o.prototype,"_uncontrolledOpen",2),o=a([(0,c.customElement)("skdx-toast","toast","root")],o);0&&(module.exports={SkdxToast});

package/dist/toast/Toast.d.cts

@@ -1,27 +1,20 @@
 import { LitElement } from 'lit';
 /**
- * `<skdx-toast>` — the Web Components implementation of the shared Toast
- * contract (see `@skdx/shared`'s `toastContract`). A single toast
- * notification: `role="status"` and `data-state` (`open`/`closed`) on the
- * host. Must render under a `<skdx-toast-provider>`. Self-closes after
- * `duration` ms (or the provider's default), pausing the timer while
- * hovered, while focused, and while the page is hidden, and closing
- * immediately on Escape. Author `role="alert"` to raise an error or warning
- * assertively instead of the default polite `role="status"`. Announces its text
- * content to screen readers via the provider's persistent `aria-live`
- * region on mount/reopen. Self-closing and uncontrolled by default — mount
- * one `<skdx-toast>` per notification and remove it from the DOM on
- * `open-change` with `detail: false`.
- *
- * @fires open-change - Fires with the new open state whenever it changes, controlled or not.
- *
+ * A toast notification with auto-dismiss, pause-on-hover/focus, and Escape to
+ * close. Announced through the provider's persistent `aria-live` region
+ * (politeness determined by `type`). Self-closing and uncontrolled by default.
+ * @fires open-change - Emitted when the open state changes with the new state.
+ * @fires open-change-complete - Emitted when the toast animation has finished.
+ * @fires escape-key-down - On Escape; cancelable to keep toast open.
+ * @fires pause - Emitted when the auto-dismiss timer pauses (edge-triggered).
+ * @fires resume - Emitted when the auto-dismiss timer resumes.
  * @example
  * ```html
- * <skdx-toast duration="4000" type="background">
+ * <skdx-toast duration="4000">
  *   <skdx-toast-title>Saved</skdx-toast-title>
  *   <skdx-toast-description>Your changes have been saved.</skdx-toast-description>
  *   <skdx-toast-action alt-text="Undo the save">Undo</skdx-toast-action>
- *   <skdx-toast-close aria-label="Dismiss">✕</skdx-toast-close>
+ *   <skdx-toast-close>✕</skdx-toast-close>
  * </skdx-toast>
  * ```
  */
@@ -32,32 +25,62 @@ export declare class SkdxToast extends LitElement {
      * @default undefined
      */
     open?: boolean;
-    /** Whether the toast is initially open, for uncontrolled usage — a toast is typically mounted already-visible. */
+    /**
+     * Whether the toast is initially open. Defaults to `true` (toasts are mounted
+     * after the event that triggered them).
+     */
     defaultOpen: boolean;
     /**
-     * Auto-dismiss duration (ms). `Infinity` disables auto-dismiss. Falls back
-     * to the ancestor `<skdx-toast-provider>`'s `duration` when unset.
+     * Auto-dismiss duration (ms); `Infinity` disables it.
+     * Falls back to the provider's `duration` when unset.
      * @default undefined
      */
     duration?: number;
     /**
-     * `'foreground'` interrupts the user (announced `assertive`);
-     * `'background'` does not (announced `polite`).
-     * @default 'foreground'
+     * `'foreground'` (assertive, interrupts); `'background'` (polite, does not).
+     * Picks which of the provider's two live regions announces the toast.
+     * @default 'background'
      */
     type: 'foreground' | 'background';
     private _uncontrolledOpen;
+    /**
+     * Whether the timer is paused; published as `data-paused`.
+     * Edge-triggered (one event per pause interval, not per source).
+     */
+    private paused;
     private _initialized;
     private provider;
     private timerId?;
     private remaining;
     private startTime;
+    /** Track the open state to announce only on transitions, not re-renders. */
+    private wasOpen;
+    /** Whether the announcer still needs this toast's text for the current open. */
+    private announcementPending;
+    /** Whether syncOpenState has run — mount is not a completed change. */
+    private hasSyncedOnce;
+    private completeTeardown?;
+    private swipeStart;
+    private swipeDirectionResolved;
     /** @internal Resolved open state, controlled or uncontrolled. */
     get currentOpen(): boolean;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected updated(changed: Map<string, unknown>): void;
+    /**
+     * Acts on an open-state *transition*: restarts the full duration and hands
+     * the text to the announcer on the way in, clears the timer on the way out.
+     * A reopened toast is a new notification, and with no live-region role on
+     * the host to re-read it, this call is the only thing that announces it.
+     *
+     * Also the single choke point `open-change-complete` is reported from,
+     * whether the transition came from `setOpen()` (uncontrolled) or `updated()`
+     * (controlled) — both call this. Called from `connectedCallback()` is the
+     * mount pass, not a change, so `hasSyncedOnce` skips it.
+     */
+    private syncOpenState;
     private getDuration;
+    private readonly setPaused;
     private readonly startTimer;
     private readonly pauseTimer;
     /**
@@ -67,7 +90,43 @@ export declare class SkdxToast extends LitElement {
      */
     private readonly handleVisibilityChange;
     private readonly handleKeyDown;
+    private resolveSwipeDirection;
+    private travelled;
+    private setSwipe;
+    private readonly handlePointerDown;
+    private readonly handlePointerMove;
+    private readonly handlePointerUp;
+    private readonly handlePointerCancel;
+    /**
+     * Points `aria-labelledby`/`aria-describedby` at the Title and Description
+     * this toast actually renders.
+     *
+     * Read off the light-DOM children rather than registered by the parts, which
+     * is how the other four packages do it: a custom element has no context to
+     * register through, and `<skdx-toast-title>` is a direct child here. The ids
+     * land on the part hosts themselves so the IDREF resolves from the document —
+     * an id inside a shadow root is unreachable to an IDREF outside it, which
+     * would leave the toast with no accessible name at all rather than a weaker
+     * one.
+     */
+    private readonly syncLabelling;
+    /** Queues this toast's text for the provider's announcer, once per open. */
     private announce;
+    /**
+     * Hands the pending text to the announcer as soon as there is text to hand
+     * over. Also the slot's `slotchange` listener, which is what makes the
+     * declarative case work: the HTML parser runs `connectedCallback` at the
+     * start tag, before this element's own children exist, so a
+     * `<skdx-toast>` written into a page's markup has no text at connect time
+     * and would otherwise be announced as an empty string — that is, not at all,
+     * now that the host carries no live-region role to fall back on. An empty
+     * message therefore leaves the announcement pending rather than cancelling
+     * it, and the first `slotchange` after the children are assigned delivers
+     * it. A toast that genuinely has no text stays pending forever and announces
+     * nothing, which is correct: writing "" into the live region would make a
+     * screen reader read the silence as a change.
+     */
+    private readonly flushAnnouncement;
     private syncState;
     /** Sets open state (updating internal state if uncontrolled) and fires `open-change`. */
     setOpen(next: boolean): void;