@m3e/toc 1.0.0-rc.1

package/dist/index.js

@@ -0,0 +1,597 @@
+/**
+ * @license MIT
+ * Copyright (c) 2025 matraic
+ * See LICENSE file in the project root for full license text.
+ */
+import { LitElement, html, unsafeCSS, css, nothing } from 'lit';
+import { Selected, Disabled, AttachInternals, Role, DesignToken, getTextContent, guid, HtmlFor, IntersectionController, ScrollController, MutationController, debounce, hasAssignedNodes } from '@m3e/core';
+import { SelectionManager } from '@m3e/core/a11y';
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+function __classPrivateFieldGet(receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+}
+
+function __classPrivateFieldSet(receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const t$1=t=>(e,o)=>{ void 0!==o?o.addInitializer((()=>{customElements.define(t,e);})):customElements.define(t,e);};
+
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const t=globalThis,e$3=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow)&&"adoptedStyleSheets"in Document.prototype&&"replace"in CSSStyleSheet.prototype,s=Symbol(),o$2=new WeakMap;let n$2 = class n{constructor(t,e,o){if(this._$cssResult$=true,o!==s)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$3&&void 0===t){const e=void 0!==s&&1===s.length;e&&(t=o$2.get(s)),void 0===t&&((this.o=t=new CSSStyleSheet).replaceSync(this.cssText),e&&o$2.set(s,t));}return t}toString(){return this.cssText}};const r$3=t=>new n$2("string"==typeof t?t:t+"",void 0,s),S=(s,o)=>{if(e$3)s.adoptedStyleSheets=o.map((t=>t instanceof CSSStyleSheet?t:t.styleSheet));else for(const e of o){const o=document.createElement("style"),n=t.litNonce;void 0!==n&&o.setAttribute("nonce",n),o.textContent=e.cssText,s.appendChild(o);}},c$1=e$3?t=>t:t=>t instanceof CSSStyleSheet?(t=>{let e="";for(const s of t.cssRules)e+=s.cssText;return r$3(e)})(t):t;
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const{is:i,defineProperty:e$2,getOwnPropertyDescriptor:h,getOwnPropertyNames:r$2,getOwnPropertySymbols:o$1,getPrototypeOf:n$1}=Object,a=globalThis,c=a.trustedTypes,l=c?c.emptyScript:"",p=a.reactiveElementPolyfillSupport,d=(t,s)=>t,u={toAttribute(t,s){switch(s){case Boolean:t=t?l: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=(t,s)=>!i(t,s),b={attribute:true,type:String,converter:u,reflect:false,useDefault:false,hasChanged:f};Symbol.metadata??=Symbol("metadata"),a.litPropertyMetadata??=new WeakMap;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){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$2(this.prototype,t,h);}}static getPropertyDescriptor(t,s,i){const{get:e,set:r}=h(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}static _$Ei(){if(this.hasOwnProperty(d("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("finalized")))return;if(this.finalized=true,this._$Ei(),this.hasOwnProperty(d("properties"))){const t=this.properties,s=[...r$2(t),...o$1(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$1(s));}else void 0!==s&&i.push(c$1(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(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).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;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){if(void 0!==t){const e=this.constructor,h=this[t];if(i??=e.getPropertyOptions(t),!((i.hasChanged??f)(h,s)||i.useDefault&&i.reflect&&h===this._$Ej?.get(t)&&!this.hasAttribute(e._$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.elementStyles=[],y.shadowRootOptions={mode:"open"},y[d("elementProperties")]=new Map,y[d("finalized")]=new Map,p?.({ReactiveElement:y}),(a.reactiveElementVersions??=[]).push("2.1.1");
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const o={attribute:true,type:String,converter:u,reflect:false,hasChanged:f},r$1=(t=o,e,r)=>{const{kind:n,metadata:i}=r;let s=globalThis.litPropertyMetadata.get(i);if(void 0===s&&globalThis.litPropertyMetadata.set(i,s=new Map),"setter"===n&&((t=Object.create(t)).wrapped=true),s.set(r.name,t),"accessor"===n){const{name:o}=r;return {set(r){const n=e.get.call(this);e.set.call(this,r),this.requestUpdate(o,n,t);},init(e){return void 0!==e&&this.C(o,void 0,t,e),e}}}if("setter"===n){const{name:o}=r;return function(r){const n=this[o];e.call(this,r),this.requestUpdate(o,n,t);}}throw Error("Unsupported decorator location: "+n)};function n(t){return (e,o)=>"object"==typeof o?r$1(t,e,o):((t,e,o)=>{const r=e.hasOwnProperty(o);return e.constructor.createProperty(o,t),r?Object.getOwnPropertyDescriptor(e,o):void 0})(t,e,o)}
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */function r(r){return n({...r,state:true,attribute:false})}
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const e$1=(e,t,c)=>(c.configurable=true,c.enumerable=true,Reflect.decorate&&"object"!=typeof t&&Object.defineProperty(e,t,c),c);
+
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */function e(e,r){return (n,s,i)=>{const o=t=>t.renderRoot?.querySelector(e)??null;return e$1(n,s,{get(){return o(this)}})}}
+
+/**
+ * An item in a table of contents.
+ * @tag m3e-toc-item
+ *
+ * @slot - Renders the label of the item.
+ *
+ * @attr disabled - A value indicating whether the element is disabled.
+ *
+ * @cssprop --m3e-toc-item-shape - Border radius of the TOC item.
+ * @cssprop --m3e-toc-item-padding-block - Block padding for the TOC item.
+ * @cssprop --m3e-toc-item-padding - Inline padding for the TOC item.
+ * @cssprop --m3e-toc-item-inset - Indentation per level for the TOC item.
+ * @cssprop --m3e-toc-active-indicator-animation-duration - Animation duration for the active indicator.
+ * @cssprop --m3e-toc-item-font-size - Font size for unselected items.
+ * @cssprop --m3e-toc-item-font-weight - Font weight for unselected items.
+ * @cssprop --m3e-toc-item-line-height - Line height for unselected items.
+ * @cssprop --m3e-toc-item-tracking - Letter spacing for unselected items.
+ * @cssprop --m3e-toc-item-color - Text color for unselected items.
+ * @cssprop --m3e-toc-item-selected-font-size - Font size for selected items.
+ * @cssprop --m3e-toc-item-selected-font-weight - Font weight for selected items.
+ * @cssprop --m3e-toc-item-selected-line-height - Line height for selected items.
+ * @cssprop --m3e-toc-item-selected-tracking - Letter spacing for selected items.
+ * @cssprop --m3e-toc-item-selected-color - Text color for selected items.
+ */
+let M3eTocItemElement = class M3eTocItemElement extends Selected(Disabled(AttachInternals(Role(LitElement, "link")))) {
+    /** @internal */
+    update(changedProperties) {
+        super.update(changedProperties);
+        if (changedProperties.has("selected")) {
+            this.ariaSelected = null;
+            this.ariaCurrent = this.selected ? "true" : null;
+        }
+        if (changedProperties.has("node")) {
+            if (this.node) {
+                this._base?.style.setProperty("--_level", `${this.node.level - 1}`);
+            }
+            else {
+                this._base?.style.removeProperty("--_level");
+            }
+        }
+    }
+    /** @inheritdoc */
+    firstUpdated(_changedProperties) {
+        super.firstUpdated(_changedProperties);
+        this._stateLayer?.attach(this);
+    }
+    /** @inheritdoc */
+    render() {
+        return html `<m3e-state-layer class="state-layer"></m3e-state-layer>
+      <div class="base"><slot></slot></div>`;
+    }
+};
+/** The styles of the element. */
+M3eTocItemElement.styles = css `
+    :host {
+      display: inline-block;
+      position: relative;
+      user-select: none;
+      border-radius: var(--m3e-toc-item-shape, ${DesignToken.shape.corner.largeIncreased});
+      padding-block: var(--m3e-toc-item-padding-block, 0.5rem);
+    }
+    :host(:not(:disabled)) {
+      cursor: pointer;
+    }
+    .base {
+      padding-inline-start: calc(
+        var(--m3e-toc-item-padding, 1rem) + calc(var(--m3e-toc-item-inset, 0.75rem) * var(--_level, 0))
+      );
+      padding-inline-end: var(--m3e-toc-item-padding, 1rem);
+      transition: ${unsafeCSS(`color var(--m3e-toc-active-indicator-animation-duration, ${DesignToken.motion.duration.long1}) ${DesignToken.motion.easing.standard}`)};
+    }
+    :host(:not([selected])) {
+      font-size: var(--m3e-toc-item-font-size, ${DesignToken.typescale.standard.body.large.fontSize});
+      font-weight: var(--m3e-toc-item-font-weight, ${DesignToken.typescale.standard.body.large.fontWeight});
+      line-height: var(--m3e-toc-item-line-height, ${DesignToken.typescale.standard.body.large.lineHeight});
+      letter-spacing: var(--m3e-toc-item-tracking, ${DesignToken.typescale.standard.body.large.tracking});
+      color: var(--m3e-toc-item-color, ${DesignToken.color.onSurfaceVariant});
+    }
+    :host([selected]) {
+      font-size: var(--m3e-toc-item-selected-font-size, ${DesignToken.typescale.emphasized.body.large.fontSize});
+      font-weight: var(--m3e-toc-item-selected-font-weight, ${DesignToken.typescale.emphasized.body.large.fontWeight});
+      line-height: var(--m3e-toc-item-selected-line-height, ${DesignToken.typescale.emphasized.body.large.lineHeight});
+      letter-spacing: var(--m3e-toc-item-selected-tracking, ${DesignToken.typescale.emphasized.body.large.tracking});
+      color: var(--m3e-toc-item-selected-color, ${DesignToken.color.onSecondaryContainer});
+    }
+    .base {
+      justify-content: unset;
+    }
+    .state-layer {
+      --m3e-state-layer-focus-opacity: 0;
+    }
+    @media (prefers-reduced-motion) {
+      .base {
+        transition: none;
+      }
+    }
+  `;
+__decorate([
+    e(".base")
+], M3eTocItemElement.prototype, "_base", void 0);
+__decorate([
+    e(".state-layer")
+], M3eTocItemElement.prototype, "_stateLayer", void 0);
+__decorate([
+    r()
+], M3eTocItemElement.prototype, "node", void 0);
+M3eTocItemElement = __decorate([
+    t$1("m3e-toc-item")
+], M3eTocItemElement);
+
+var _a, _TocGenerator_getHeaderLevel;
+/** Provides functionality used to generate a table of contents used for in-page navigation. */
+class TocGenerator {
+    /**
+     * Generates nodes from which to construct a table of contents for in-page navigation.
+     * @param {HTMLElement} element The element for which to generate a table of contents.
+     * @param {number} [maxDepth=6] The maximum depth of the table of contents.
+     * @returns {Array<TocNode>} The top-level nodes of the table of contents.
+     */
+    static generate(element, maxDepth = 6) {
+        const maxLevel = 6;
+        let topLevel = maxLevel;
+        const nodes = new Array();
+        element
+            .querySelectorAll("h1:not([m3e-toc-ignore]),h2:not([m3e-toc-ignore]),h3:not([m3e-toc-ignore]),h4:not([m3e-toc-ignore]),h5:not([m3e-toc-ignore]),h6:not([m3e-toc-ignore]),m3e-heading[level]:not([m3e-toc-ignore])")
+            .forEach((element) => {
+            const level = __classPrivateFieldGet(_a, _a, "m", _TocGenerator_getHeaderLevel).call(_a, element);
+            topLevel = Math.min(level, topLevel);
+            nodes.push({
+                id: element.id || guid(),
+                element,
+                level,
+                label: getTextContent(element, true),
+                nodes: new Array(),
+            });
+        });
+        for (let level = topLevel + maxDepth - 1; level > topLevel; level--) {
+            for (let i = 0; i < nodes.length; i++) {
+                const node = nodes[i];
+                if (node.level === level) {
+                    for (let j = i; j >= 0; j--) {
+                        const prev = nodes[j];
+                        if (prev.level < level) {
+                            prev.nodes.push(node);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        nodes.forEach((x) => (x.level -= topLevel - 1));
+        return nodes.filter((x) => x.level === 1);
+    }
+}
+_a = TocGenerator, _TocGenerator_getHeaderLevel = function _TocGenerator_getHeaderLevel(element) {
+    return element.tagName.startsWith("H")
+        ? parseInt(element.tagName.substring(1))
+        : parseInt(element.getAttribute("level") ?? "0");
+};
+
+var _M3eTocElement_instances, _M3eTocElement_ignoreScroll, _M3eTocElement_selectionManager, _M3eTocElement_intersectionController, _M3eTocElement_scrollController, _M3eTocElement_mutationController, _M3eTocElement_renderNode, _M3eTocElement_handleOverlineSlotChange, _M3eTocElement_handleTitleSlotChange, _M3eTocElement_handleClick, _M3eTocElement_generateToc;
+/**
+ * @summary
+ * A table of contents that provides in-page scroll navigation.
+ *
+ * @description
+ * The `m3e-toc` component generates a hierarchical table of contents for in-page navigation.
+ * It automatically detects headings or sections in a target element, builds a navigable list,
+ * and highlights the active section as the user scrolls. The component supports custom header
+ * slots, depth limiting, smooth scrolling, and extensive theming via CSS custom properties.
+ *
+ * To exclude a heading from the generated table of contents, add the `m3e-toc-ignore` attribute
+ * to that heading element.
+ *
+ * @example
+ * ```html
+ * <m3e-toc for="content" max-depth="3">
+ *   <span slot="overline">Contents</span>
+ *   <span slot="title">Documentation</span>
+ * </m3e-toc>
+ * <div id="content">
+ *   <h2>Introduction</h2>
+ *   <h2>Getting Started</h2>
+ *   <h3>Installation</h3>
+ *   <h3>Usage</h3>
+ *   <h2>API Reference</h2>
+ * </div>
+ * ```
+ *
+ * @tag m3e-toc
+ *
+ * @slot - Renders content between the header and items.
+ * @slot overline - Renders the overline of the table of contents.
+ * @slot title - Renders the title of the table of contents.
+ *
+ * @attr for - The query selector used to specify the element related to this element.
+ * @attr max-depth - The maximum depth of the table of contents.
+ *
+ * @cssprop --m3e-toc-width - Width of the table of contents.
+ * @cssprop --m3e-toc-item-shape - Border radius of TOC items and active indicator.
+ * @cssprop --m3e-toc-active-indicator-color - Border color of the active indicator.
+ * @cssprop --m3e-toc-active-indicator-animation-duration - Animation duration for the active indicator.
+ * @cssprop --m3e-toc-item-padding - Inline padding for TOC items and header.
+ * @cssprop --m3e-toc-header-space - Block space below and between header elements.
+ * @cssprop --m3e-toc-overline-font-size - Font size for the overline slot.
+ * @cssprop --m3e-toc-overline-font-weight - Font weight for the overline slot.
+ * @cssprop --m3e-toc-overline-line-height - Line height for the overline slot.
+ * @cssprop --m3e-toc-overline-tracking - Letter spacing for the overline slot.
+ * @cssprop --m3e-toc-overline-color - Text color for the overline slot.
+ * @cssprop --m3e-toc-title-font-size - Font size for the title slot.
+ * @cssprop --m3e-toc-title-font-weight - Font weight for the title slot.
+ * @cssprop --m3e-toc-title-line-height - Line height for the title slot.
+ * @cssprop --m3e-toc-title-tracking - Letter spacing for the title slot.
+ * @cssprop --m3e-toc-title-color - Text color for the title slot.
+ */
+let M3eTocElement = class M3eTocElement extends HtmlFor(AttachInternals(Role(LitElement, "navigation"))) {
+    constructor() {
+        super(...arguments);
+        _M3eTocElement_instances.add(this);
+        /** @private */ this._toc = [];
+        /** @private */ _M3eTocElement_ignoreScroll.set(this, false);
+        /** @private */ _M3eTocElement_selectionManager.set(this, new SelectionManager()
+            .withHomeAndEnd()
+            .withVerticalOrientation()
+            .disableRovingTabIndex()
+            .onSelectedItemsChange(() => {
+            if (this._activeIndicator) {
+                const item = __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").selectedItems[0];
+                if (!item) {
+                    this.classList.toggle("-no-animate", true);
+                    this._activeIndicator.style.top = `0px`;
+                    this._activeIndicator.style.height = `0px`;
+                    this._activeIndicator.style.visibility = "hidden";
+                }
+                else {
+                    this._activeIndicator.style.top = `${item.offsetTop}px`;
+                    this._activeIndicator.style.height = `${item.clientHeight}px`;
+                    this._activeIndicator.style.visibility = "";
+                    if (this.classList.contains("-no-animate")) {
+                        setTimeout(() => this.classList.toggle("-no-animate", false), 40);
+                    }
+                }
+            }
+        }));
+        /** @private */
+        _M3eTocElement_intersectionController.set(this, new IntersectionController(this, {
+            target: null,
+            callback: (entries) => {
+                if (!this.control || __classPrivateFieldGet(this, _M3eTocElement_ignoreScroll, "f"))
+                    return;
+                const targetOffset = this.control.scrollTop;
+                let closestElement = null;
+                let closestDistance = Number.POSITIVE_INFINITY;
+                entries
+                    .filter((x) => x.isIntersecting)
+                    .map((x) => x.target)
+                    .forEach((item) => {
+                    const offsetTop = item.offsetTop;
+                    const distance = Math.abs(offsetTop - targetOffset);
+                    if (distance < closestDistance) {
+                        closestDistance = distance;
+                        closestElement = item;
+                    }
+                });
+                if (closestElement) {
+                    const item = __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").items.find((x) => x.node?.element === closestElement);
+                    if (item) {
+                        __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").select(item);
+                    }
+                }
+            },
+        }));
+        /** @private */
+        _M3eTocElement_scrollController.set(this, new ScrollController(this, {
+            target: null,
+            callback: () => (__classPrivateFieldSet(this, _M3eTocElement_ignoreScroll, false, "f")),
+            debounce: true,
+        }));
+        /** @private */
+        _M3eTocElement_mutationController.set(this, new MutationController(this, {
+            target: null,
+            config: {
+                childList: true,
+                subtree: true,
+            },
+            callback: () => this._updateToc(),
+        }));
+        /**
+         * The maximum depth of the table of contents.
+         * @default 2
+         */
+        this.maxDepth = 2;
+    }
+    /** @inheritdoc */
+    attach(control) {
+        super.attach(control);
+        __classPrivateFieldGet(this, _M3eTocElement_mutationController, "f").observe(control);
+        __classPrivateFieldGet(this, _M3eTocElement_scrollController, "f").observe(control);
+        __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_generateToc).call(this);
+    }
+    /** @inheritdoc */
+    detach() {
+        if (this.control) {
+            __classPrivateFieldGet(this, _M3eTocElement_mutationController, "f").unobserve(this.control);
+            __classPrivateFieldGet(this, _M3eTocElement_scrollController, "f").unobserve(this.control);
+        }
+        super.detach();
+        __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_generateToc).call(this);
+    }
+    /** @inheritdoc */
+    update(changedProperties) {
+        super.update(changedProperties);
+        if (changedProperties.has("maxDepth")) {
+            __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_generateToc).call(this);
+        }
+    }
+    /** @inheritdoc */
+    updated(_changedProperties) {
+        super.updated(_changedProperties);
+        if (_changedProperties.has("_toc")) {
+            const { added, removed } = __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").setItems([
+                ...(this.shadowRoot?.querySelectorAll("m3e-toc-item") ?? []),
+            ]);
+            if (!__classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").activeItem) {
+                this.classList.toggle("-no-animate", true);
+                __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").updateActiveItem(added.find((x) => !x.disabled));
+            }
+            for (const item of added) {
+                if (item.node) {
+                    __classPrivateFieldGet(this, _M3eTocElement_intersectionController, "f").observe(item.node.element);
+                }
+            }
+            for (const item of removed) {
+                if (item.node) {
+                    __classPrivateFieldGet(this, _M3eTocElement_intersectionController, "f").unobserve(item.node.element);
+                }
+            }
+        }
+    }
+    /** @inheritdoc */
+    render() {
+        return html `<div class="header">
+        <div class="overline">
+          <slot name="overline" @slotchange="${__classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_handleOverlineSlotChange)}"></slot>
+        </div>
+        <div class="title">
+          <slot name="title" @slotchange="${__classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_handleTitleSlotChange)}"></slot>
+        </div>
+      </div>
+      <slot></slot>
+      <ul class="list">
+        ${this._toc.map((x) => __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_renderNode).call(this, x))}
+      </ul>
+      <div class="active-indicator" aria-hidden="true"></div>`;
+    }
+    /** @private */
+    _updateToc() {
+        __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_generateToc).call(this);
+    }
+};
+_M3eTocElement_ignoreScroll = new WeakMap();
+_M3eTocElement_selectionManager = new WeakMap();
+_M3eTocElement_intersectionController = new WeakMap();
+_M3eTocElement_scrollController = new WeakMap();
+_M3eTocElement_mutationController = new WeakMap();
+_M3eTocElement_instances = new WeakSet();
+_M3eTocElement_renderNode = function _M3eTocElement_renderNode(node) {
+    return html `<li>
+      <m3e-toc-item tabindex="-1" .node="${node}" @click="${__classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_handleClick)}">${node.label}</m3e-toc-item>
+      ${node.nodes.length == 0
+        ? nothing
+        : html `<ul>
+            ${node.nodes.map((x) => __classPrivateFieldGet(this, _M3eTocElement_instances, "m", _M3eTocElement_renderNode).call(this, x))}
+          </ul>`}
+    </li>`;
+};
+_M3eTocElement_handleOverlineSlotChange = function _M3eTocElement_handleOverlineSlotChange(e) {
+    this.classList.toggle("-with-overline", hasAssignedNodes(e.target));
+};
+_M3eTocElement_handleTitleSlotChange = function _M3eTocElement_handleTitleSlotChange(e) {
+    this.classList.toggle("-with-title", hasAssignedNodes(e.target));
+};
+_M3eTocElement_handleClick = function _M3eTocElement_handleClick(e) {
+    if (e.target instanceof M3eTocItemElement && !e.target.disabled && e.target.node?.element) {
+        __classPrivateFieldSet(this, _M3eTocElement_ignoreScroll, true, "f");
+        e.target.node.element.scrollIntoView({ block: "start", inline: "start", behavior: "smooth" });
+        __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").updateActiveItem(e.target);
+        __classPrivateFieldGet(this, _M3eTocElement_selectionManager, "f").select(e.target);
+    }
+};
+_M3eTocElement_generateToc = function _M3eTocElement_generateToc() {
+    this._toc = this.control ? TocGenerator.generate(this.control, Math.max(1, Math.min(this.maxDepth, 6))) : [];
+    this.requestUpdate();
+};
+/** The styles of the element. */
+M3eTocElement.styles = css `
+    :host {
+      display: inline-block;
+      position: relative;
+      overflow-y: auto;
+      scrollbar-width: ${DesignToken.scrollbar.thinWidth};
+      scrollbar-color: ${DesignToken.scrollbar.color};
+      width: var(--m3e-toc-width, 9.75rem);
+    }
+    ul {
+      list-style: none;
+      padding-inline-start: unset;
+      margin-block-start: unset;
+      margin-block-end: unset;
+    }
+    ul,
+    li {
+      display: flex;
+      flex-direction: column;
+      align-items: stretch;
+    }
+    m3e-toc-item {
+      flex: none;
+    }
+    .active-indicator {
+      position: absolute;
+      pointer-events: none;
+      box-sizing: border-box;
+      left: 0;
+      right: 0;
+
+      border-radius: var(--m3e-toc-item-shape, ${DesignToken.shape.corner.largeIncreased});
+      border: 1px solid var(--m3e-toc-active-indicator-color, ${DesignToken.color.outline});
+      transition: ${unsafeCSS(`visibility var(--m3e-toc-active-indicator-animation-duration, ${DesignToken.motion.duration.long1})
+          ${DesignToken.motion.easing.standard},
+        height var(--m3e-toc-active-indicator-animation-duration, ${DesignToken.motion.duration.long1})
+          ${DesignToken.motion.easing.standard},
+        top var(--m3e-toc-active-indicator-animation-duration, ${DesignToken.motion.duration.long1})
+          ${DesignToken.motion.easing.standard}`)};
+    }
+    .header {
+      display: flex;
+      flex-direction: column;
+      align-items: stretch;
+      padding-inline-start: var(--m3e-toc-item-padding, 1rem);
+      padding-block-end: var(--m3e-toc-header-space, 0.5rem);
+      row-gap: var(--m3e-toc-header-space, 0.5rem);
+    }
+    .overline {
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+    .title {
+      display: -webkit-box;
+      -webkit-line-clamp: 2;
+      -webkit-box-orient: vertical;
+      overflow: hidden;
+      line-clamp: 2;
+    }
+    :host(:not(.-with-overline)) .overline,
+    :host(:not(.-with-title)) .title,
+    :host(:not(.-with-overline):not(.-with-title)) .header {
+      display: none;
+    }
+    ::slotted([slot="overline"]) {
+      font-size: var(--m3e-toc-overline-font-size, ${DesignToken.typescale.standard.label.small.fontSize});
+      font-weight: var(--m3e-toc-overline-font-weight, ${DesignToken.typescale.standard.label.small.fontWeight});
+      line-height: var(--m3e-toc-overline-line-height, ${DesignToken.typescale.standard.label.small.lineHeight});
+      letter-spacing: var(--m3e-toc-overline-tracking, ${DesignToken.typescale.standard.label.small.tracking});
+      color: var(--m3e-toc-overline-color, ${DesignToken.color.onSurfaceVariant});
+    }
+    ::slotted([slot="title"]) {
+      font-size: var(--m3e-toc-title-font-size, ${DesignToken.typescale.standard.headline.small.fontSize});
+      font-weight: var(--m3e-toc-title-font-weight, ${DesignToken.typescale.standard.headline.small.fontWeight});
+      line-height: var(--m3e-toc-title-line-height, ${DesignToken.typescale.standard.headline.small.lineHeight});
+      letter-spacing: var(--m3e-toc-title-tracking, ${DesignToken.typescale.standard.headline.small.tracking});
+      color: var(--m3e-toc-title-color, ${DesignToken.color.onSurface});
+    }
+    :host(.-no-animate) .active-indicator {
+      transition: none;
+    }
+    @media (prefers-reduced-motion) {
+      .active-indicator {
+        transition: none;
+      }
+    }
+  `;
+__decorate([
+    r()
+], M3eTocElement.prototype, "_toc", void 0);
+__decorate([
+    e(".active-indicator")
+], M3eTocElement.prototype, "_activeIndicator", void 0);
+__decorate([
+    n({ attribute: "max-depth", type: Number })
+], M3eTocElement.prototype, "maxDepth", void 0);
+__decorate([
+    debounce(40)
+], M3eTocElement.prototype, "_updateToc", null);
+M3eTocElement = __decorate([
+    t$1("m3e-toc")
+], M3eTocElement);
+
+export { M3eTocElement, M3eTocItemElement, TocGenerator };
+//# sourceMappingURL=index.js.map