@design.estate/dees-catalog 3.61.2 → 3.63.0

package/dist_watch/bundle.js

@@ -168991,6 +168991,44 @@ var demoFunc29 = /* @__PURE__ */ __name(() => b2`
         ></dees-table>
       </div>
 
+      <div class="demo-section">
+        <h2 class="demo-title">Multi-Column Sort</h2>
+        <p class="demo-description">
+          Click any column header for a single-column sort. Hold Shift while clicking to add the
+          column to a multi-sort cascade (or cycle its direction). Right-click any sortable header
+          to open a menu where you can pin a column to a specific priority slot, remove it, or
+          clear the cascade.
+        </p>
+        <dees-table
+          heading1="People Directory"
+          heading2="Pre-seeded with department ▲ 1, name ▲ 2"
+          .sortBy=${[
+  { key: "department", dir: "asc" },
+  { key: "name", dir: "asc" }
+]}
+          .columns=${[
+  { key: "department", header: "Department", sortable: true },
+  { key: "name", header: "Name", sortable: true },
+  { key: "role", header: "Role", sortable: true },
+  { key: "createdAt", header: "Created", sortable: true },
+  { key: "location", header: "Location", sortable: true },
+  { key: "status", header: "Status", sortable: true }
+]}
+          .data=${[
+  { department: "R&D", name: "Alice Johnson", role: "Engineer", createdAt: "2023-01-12", location: "Berlin", status: "Active" },
+  { department: "R&D", name: "Diana Martinez", role: "Engineer", createdAt: "2020-06-30", location: "Madrid", status: "Active" },
+  { department: "R&D", name: "Mark Lee", role: "Engineer", createdAt: "2024-03-04", location: "Berlin", status: "Active" },
+  { department: "Design", name: "Bob Smith", role: "Designer", createdAt: "2022-11-05", location: "Paris", status: "Active" },
+  { department: "Design", name: "Sara Kim", role: "Designer", createdAt: "2021-08-19", location: "Paris", status: "On Leave" },
+  { department: "Ops", name: "Charlie Davis", role: "Manager", createdAt: "2021-04-21", location: "London", status: "On Leave" },
+  { department: "Ops", name: "Helena Voss", role: "SRE", createdAt: "2023-07-22", location: "London", status: "Active" },
+  { department: "QA", name: "Fiona Clark", role: "QA", createdAt: "2022-03-14", location: "Vienna", status: "Active" },
+  { department: "QA", name: "Tom\xE1s Rivera", role: "QA", createdAt: "2024-01-09", location: "Madrid", status: "Active" },
+  { department: "CS", name: "Ethan Brown", role: "Support", createdAt: "2019-09-18", location: "Rome", status: "Inactive" }
+]}
+        ></dees-table>
+      </div>
+
       <div class="demo-section">
         <h2 class="demo-title">Wide Properties + Many Actions</h2>
         <p class="demo-description">A table with many columns and rich actions to stress test layout and sticky Actions.</p>
@@ -169222,29 +169260,48 @@ var tableStyles = [
         border-bottom-width: 0px;
       }
 
+      /* Default mode (Mode B, page sticky): horizontal scroll lives on
+         .tableScroll (so wide tables don't get clipped by an ancestor
+         overflow:hidden such as dees-tile). Vertical sticky is handled by
+         a JS-managed floating header (.floatingHeader, position:fixed),
+         which is unaffected by ancestor overflow. */
       .tableScroll {
-        /* enable horizontal scroll only when content exceeds width */
+        position: relative;
         overflow-x: auto;
-        /* prevent vertical scroll inside the table container */
-        overflow-y: hidden;
-        /* avoid reserving extra space for classic scrollbars where possible */
+        overflow-y: visible;
+        scrollbar-gutter: stable;
+      }
+      /* Mode A, internal scroll: opt-in via fixed-height attribute.
+         The table scrolls inside its own box and the header sticks via plain CSS sticky. */
+      :host([fixed-height]) .tableScroll {
+        max-height: var(--table-max-height, 360px);
+        overflow: auto;
         scrollbar-gutter: stable both-edges;
       }
-      /* Hide horizontal scrollbar entirely when not using sticky header */
-      :host(:not([sticky-header])) .tableScroll {
-        -ms-overflow-style: none; /* IE/Edge */
-        scrollbar-width: none;   /* Firefox (hides both axes) */
+      :host([fixed-height]) .tableScroll::-webkit-scrollbar:horizontal {
+        height: 0px;
+      }
+
+      /* Floating header overlay (Mode B). Position is managed by JS so it
+         escapes any ancestor overflow:hidden (position:fixed is not clipped
+         by overflow ancestors). */
+      .floatingHeader {
+        position: fixed;
+        top: 0;
+        left: 0;
+        z-index: 100;
+        visibility: hidden;
+        overflow: hidden;
+        pointer-events: none;
       }
-      :host(:not([sticky-header])) .tableScroll::-webkit-scrollbar {
-        display: none; /* Chrome/Safari */
+      .floatingHeader.active {
+        visibility: visible;
       }
-      /* In sticky-header mode, hide only the horizontal scrollbar in WebKit/Blink */
-      :host([sticky-header]) .tableScroll::-webkit-scrollbar:horizontal {
-        height: 0px;
+      .floatingHeader table {
+        margin: 0;
       }
-      :host([sticky-header]) .tableScroll {
-        max-height: var(--table-max-height, 360px);
-        overflow: auto;
+      .floatingHeader th {
+        pointer-events: auto;
       }
 
       table {
@@ -169267,11 +169324,20 @@ var tableStyles = [
         background: ${cssManager.bdTheme("hsl(210 40% 96.1%)", "hsl(0 0% 9%)")};
         border-bottom: 1px solid var(--dees-color-border-strong);
       }
-      :host([sticky-header]) thead th {
+      /* th needs its own background so sticky cells paint over scrolled rows
+         (browsers don't paint the <thead> box behind a sticky <th>). */
+      th {
+        background: ${cssManager.bdTheme("hsl(210 40% 96.1%)", "hsl(0 0% 9%)")};
+      }
+      /* Mode A — internal scroll sticky */
+      :host([fixed-height]) thead th {
         position: sticky;
         top: 0;
         z-index: 2;
       }
+      :host([fixed-height]) thead tr.filtersRow th {
+        top: 36px; /* matches th { height: 36px } below */
+      }
       
       tbody tr {
         transition: background-color 0.15s ease;
@@ -169384,6 +169450,32 @@ var tableStyles = [
         color: ${cssManager.bdTheme("hsl(215.4 16.3% 46.9%)", "hsl(215 20.2% 65.1%)")};
         letter-spacing: -0.01em;
       }
+
+      th[role='columnheader']:hover {
+        color: var(--dees-color-text-primary);
+      }
+
+      th .sortArrow {
+        display: inline-block;
+        margin-left: 6px;
+        font-size: 10px;
+        line-height: 1;
+        opacity: 0.7;
+        vertical-align: middle;
+      }
+
+      th .sortBadge {
+        display: inline-block;
+        margin-left: 3px;
+        padding: 1px 5px;
+        font-size: 10px;
+        font-weight: 600;
+        line-height: 1;
+        color: ${cssManager.bdTheme("hsl(222.2 47.4% 30%)", "hsl(217.2 91.2% 75%)")};
+        background: ${cssManager.bdTheme("hsl(222.2 47.4% 51.2% / 0.12)", "hsl(217.2 91.2% 59.8% / 0.18)")};
+        border-radius: 999px;
+        vertical-align: middle;
+      }
       
       :host([show-vertical-lines]) th {
         border-right: 1px solid var(--dees-color-border-default);
@@ -169575,7 +169667,23 @@ function getCellValue(row, col, displayFunction) {
   return col.value ? col.value(row) : row[col.key];
 }
 __name(getCellValue, "getCellValue");
-function getViewData(data, effectiveColumns, sortKey, sortDir, filterText, columnFilters, filterMode = "table", lucenePredicate) {
+function compareCellValues(va, vb) {
+  if (va == null && vb == null) return 0;
+  if (va == null) return -1;
+  if (vb == null) return 1;
+  if (typeof va === "number" && typeof vb === "number") {
+    if (va < vb) return -1;
+    if (va > vb) return 1;
+    return 0;
+  }
+  const sa = String(va).toLowerCase();
+  const sb = String(vb).toLowerCase();
+  if (sa < sb) return -1;
+  if (sa > sb) return 1;
+  return 0;
+}
+__name(compareCellValues, "compareCellValues");
+function getViewData(data, effectiveColumns, sortBy, filterText, columnFilters, filterMode = "table", lucenePredicate) {
   let arr = data.slice();
   const ft = (filterText || "").trim().toLowerCase();
   const cf = columnFilters || {};
@@ -169589,9 +169697,9 @@ function getViewData(data, effectiveColumns, sortKey, sortDir, filterText, colum
           const needle = String(cf[k4]).toLowerCase();
           if (!s10.includes(needle)) return false;
         } else {
-          const col2 = effectiveColumns.find((c11) => String(c11.key) === k4);
-          if (!col2 || col2.hidden || col2.filterable === false) continue;
-          const val = getCellValue(row, col2);
+          const col = effectiveColumns.find((c11) => String(c11.key) === k4);
+          if (!col || col.hidden || col.filterable === false) continue;
+          const val = getCellValue(row, col);
           const s10 = String(val ?? "").toLowerCase();
           const needle = String(cf[k4]).toLowerCase();
           if (!s10.includes(needle)) return false;
@@ -169612,9 +169720,9 @@ function getViewData(data, effectiveColumns, sortKey, sortDir, filterText, colum
             }
           }
         } else {
-          for (const col2 of effectiveColumns) {
-            if (col2.hidden) continue;
-            const val = getCellValue(row, col2);
+          for (const col of effectiveColumns) {
+            if (col.hidden) continue;
+            const val = getCellValue(row, col);
             const s10 = String(val ?? "").toLowerCase();
             if (s10.includes(ft)) {
               any = true;
@@ -169627,21 +169735,14 @@ function getViewData(data, effectiveColumns, sortKey, sortDir, filterText, colum
       return true;
     });
   }
-  if (!sortKey || !sortDir) return arr;
-  const col = effectiveColumns.find((c11) => String(c11.key) === sortKey);
-  if (!col) return arr;
-  const dir = sortDir === "asc" ? 1 : -1;
+  if (!sortBy || sortBy.length === 0) return arr;
+  const resolved2 = sortBy.map((desc) => ({ desc, col: effectiveColumns.find((c11) => String(c11.key) === desc.key) })).filter((entry) => !!entry.col);
+  if (resolved2.length === 0) return arr;
   arr.sort((a5, b5) => {
-    const va = getCellValue(a5, col);
-    const vb = getCellValue(b5, col);
-    if (va == null && vb == null) return 0;
-    if (va == null) return -1 * dir;
-    if (vb == null) return 1 * dir;
-    if (typeof va === "number" && typeof vb === "number") return (va - vb) * dir;
-    const sa = String(va).toLowerCase();
-    const sb = String(vb).toLowerCase();
-    if (sa < sb) return -1 * dir;
-    if (sa > sb) return 1 * dir;
+    for (const { desc, col } of resolved2) {
+      const cmp2 = compareCellValues(getCellValue(a5, col), getCellValue(b5, col));
+      if (cmp2 !== 0) return desc.dir === "asc" ? cmp2 : -cmp2;
+    }
     return 0;
   });
   return arr;
@@ -169794,7 +169895,13 @@ __name(compileLucenePredicate, "compileLucenePredicate");
 init_dist_ts30();
 init_dist_ts29();
 init_theme();
-var _selectedIds_dec, _selectionMode_dec, _searchMode_dec, _stickyHeader_dec, _showColumnFilters_dec, _columnFilters_dec, _filterText_dec, _sortDir_dec, _sortKey_dec, _showGrid_dec, _showHorizontalLines_dec, _showVerticalLines_dec, _editableFields_dec, _selectedDataRow_dec, _reverseDisplayFunction_dec, _displayFunction_dec, _augmentFromDisplayFunction_dec, _rowKey_dec, _columns_dec, _dataActions_dec, _searchable_dec, _dataName_dec, _required_dec3, _disabled_dec3, _label_dec3, _key_dec2, _data_dec, _heading2_dec, _heading1_dec, _a42, _DeesTable_decorators, _init39, _heading1, _heading22, _data, _key2, _label3, _disabled3, _required3, _dataName, _searchable, _dataActions, _columns, _rowKey, _augmentFromDisplayFunction, _displayFunction, _reverseDisplayFunction, _selectedDataRow, _editableFields, _showVerticalLines, _showHorizontalLines, _showGrid, _sortKey, _sortDir, _filterText, _columnFilters, _showColumnFilters, _stickyHeader, _searchMode, _selectionMode, _selectedIds;
+var _selectedIds_dec, _selectionMode_dec, _searchMode_dec, _fixedHeight_dec, _showColumnFilters_dec, _columnFilters_dec, _filterText_dec, _sortBy_dec, _showGrid_dec, _showHorizontalLines_dec, _showVerticalLines_dec, _editableFields_dec, _selectedDataRow_dec, _reverseDisplayFunction_dec, _displayFunction_dec, _augmentFromDisplayFunction_dec, _rowKey_dec, _columns_dec, _dataActions_dec, _searchable_dec, _dataName_dec, _required_dec3, _disabled_dec3, _label_dec3, _key_dec2, _data_dec, _heading2_dec, _heading1_dec, _a42, _DeesTable_decorators, _init39, _heading1, _heading22, _data, _key2, _label3, _disabled3, _required3, _dataName, _searchable, _dataActions, _columns, _rowKey, _augmentFromDisplayFunction, _displayFunction, _reverseDisplayFunction, _selectedDataRow, _editableFields, _showVerticalLines, _showHorizontalLines, _showGrid, _sortBy, _filterText, _columnFilters, _showColumnFilters, _fixedHeight, _searchMode, _selectionMode, _selectedIds;
+function ordinalLabel(n12) {
+  const s10 = ["th", "st", "nd", "rd"];
+  const v5 = n12 % 100;
+  return n12 + (s10[(v5 - 20) % 10] || s10[v5] || s10[0]);
+}
+__name(ordinalLabel, "ordinalLabel");
 _DeesTable_decorators = [customElement("dees-table")];
 var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [n5({
   type: String
@@ -169837,7 +169944,7 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
   type: Boolean,
   reflect: true,
   attribute: "show-grid"
-})], _sortKey_dec = [n5({ attribute: false })], _sortDir_dec = [n5({ attribute: false })], _filterText_dec = [n5({ type: String })], _columnFilters_dec = [n5({ attribute: false })], _showColumnFilters_dec = [n5({ type: Boolean, attribute: "show-column-filters" })], _stickyHeader_dec = [n5({ type: Boolean, reflect: true, attribute: "sticky-header" })], _searchMode_dec = [n5({ type: String })], _selectionMode_dec = [n5({ type: String })], _selectedIds_dec = [n5({ attribute: false })], _a42) {
+})], _sortBy_dec = [n5({ attribute: false })], _filterText_dec = [n5({ type: String })], _columnFilters_dec = [n5({ attribute: false })], _showColumnFilters_dec = [n5({ type: Boolean, attribute: "show-column-filters" })], _fixedHeight_dec = [n5({ type: Boolean, reflect: true, attribute: "fixed-height" })], _searchMode_dec = [n5({ type: String })], _selectionMode_dec = [n5({ type: String })], _selectedIds_dec = [n5({ attribute: false })], _a42) {
   constructor() {
     super();
     __privateAdd(this, _heading1, __runInitializers(_init39, 8, this, "heading 1")), __runInitializers(_init39, 11, this);
@@ -169864,19 +169971,23 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
     __publicField(this, "files", []);
     __publicField(this, "fileWeakMap", /* @__PURE__ */ new WeakMap());
     __publicField(this, "dataChangeSubject", new domtools_pluginexports_exports.smartrx.rxjs.Subject());
-    __privateAdd(this, _sortKey, __runInitializers(_init39, 88, this)), __runInitializers(_init39, 91, this);
-    __privateAdd(this, _sortDir, __runInitializers(_init39, 92, this, null)), __runInitializers(_init39, 95, this);
-    __privateAdd(this, _filterText, __runInitializers(_init39, 96, this, "")), __runInitializers(_init39, 99, this);
-    __privateAdd(this, _columnFilters, __runInitializers(_init39, 100, this, {})), __runInitializers(_init39, 103, this);
-    __privateAdd(this, _showColumnFilters, __runInitializers(_init39, 104, this, false)), __runInitializers(_init39, 107, this);
-    __privateAdd(this, _stickyHeader, __runInitializers(_init39, 108, this, false)), __runInitializers(_init39, 111, this);
-    __privateAdd(this, _searchMode, __runInitializers(_init39, 112, this, "table")), __runInitializers(_init39, 115, this);
+    __privateAdd(this, _sortBy, __runInitializers(_init39, 88, this, [])), __runInitializers(_init39, 91, this);
+    __privateAdd(this, _filterText, __runInitializers(_init39, 92, this, "")), __runInitializers(_init39, 95, this);
+    __privateAdd(this, _columnFilters, __runInitializers(_init39, 96, this, {})), __runInitializers(_init39, 99, this);
+    __privateAdd(this, _showColumnFilters, __runInitializers(_init39, 100, this, false)), __runInitializers(_init39, 103, this);
+    __privateAdd(this, _fixedHeight, __runInitializers(_init39, 104, this, false)), __runInitializers(_init39, 107, this);
+    __privateAdd(this, _searchMode, __runInitializers(_init39, 108, this, "table")), __runInitializers(_init39, 111, this);
     __publicField(this, "__searchTextSub");
     __publicField(this, "__searchModeSub");
-    __privateAdd(this, _selectionMode, __runInitializers(_init39, 116, this, "none")), __runInitializers(_init39, 119, this);
-    __privateAdd(this, _selectedIds, __runInitializers(_init39, 120, this, /* @__PURE__ */ new Set())), __runInitializers(_init39, 123, this);
+    __privateAdd(this, _selectionMode, __runInitializers(_init39, 112, this, "none")), __runInitializers(_init39, 115, this);
+    __privateAdd(this, _selectedIds, __runInitializers(_init39, 116, this, /* @__PURE__ */ new Set())), __runInitializers(_init39, 119, this);
     __publicField(this, "_rowIdMap", /* @__PURE__ */ new WeakMap());
     __publicField(this, "_rowIdCounter", 0);
+    // ─── Floating header (page-sticky) lifecycle ─────────────────────────
+    __publicField(this, "__floatingResizeObserver");
+    __publicField(this, "__floatingScrollHandler");
+    __publicField(this, "__floatingActive", false);
+    __publicField(this, "__scrollAncestors", []);
     __publicField(this, "__debounceTimer");
   }
   get value() {
@@ -169895,8 +170006,7 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
     const viewData = getViewData(
       this.data,
       effectiveColumns,
-      this.sortKey,
-      this.sortDir,
+      this.sortBy,
       this.filterText,
       this.columnFilters,
       this.searchMode === "data" ? "data" : "table",
@@ -169968,57 +170078,7 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
               <div class="tableScroll">
               <table>
                 <thead>
-                  <tr>
-                    ${this.selectionMode !== "none" ? b2`
-                          <th style="width:42px; text-align:center;">
-                            ${this.selectionMode === "multi" ? b2`
-                                  <dees-input-checkbox
-                                    .value=${this.areAllVisibleSelected()}
-                                    .indeterminate=${this.isVisibleSelectionIndeterminate()}
-                                    @newValue=${(e11) => {
-      e11.stopPropagation();
-      this.setSelectVisible(e11.detail === true);
-    }}
-                                  ></dees-input-checkbox>
-                                ` : b2``}
-                          </th>
-                        ` : b2``}
-                    ${effectiveColumns.filter((c11) => !c11.hidden).map((col) => {
-      const isSortable = !!col.sortable;
-      const ariaSort = this.getAriaSort(col);
-      return b2`
-                          <th
-                            role="columnheader"
-                            aria-sort=${ariaSort}
-                            style="${isSortable ? "cursor: pointer;" : ""}"
-                            @click=${() => isSortable ? this.toggleSort(col) : null}
-                          >
-                            ${col.header ?? col.key}
-                            ${this.renderSortIndicator(col)}
-                          </th>`;
-    })}
-                    ${(() => {
-      if (this.dataActions && this.dataActions.length > 0) {
-        return b2` <th class="actionsCol">Actions</th> `;
-      }
-    })()}
-                  </tr>
-                  ${this.showColumnFilters ? b2`<tr class="filtersRow">
-                        ${this.selectionMode !== "none" ? b2`<th style="width:42px;"></th>` : b2``}
-                        ${effectiveColumns.filter((c11) => !c11.hidden).map((col) => {
-      const key2 = String(col.key);
-      if (col.filterable === false) return b2`<th></th>`;
-      return b2`<th>
-                              <input type="text" placeholder="Filter..." .value=${this.columnFilters[key2] || ""}
-                                @input=${(e11) => this.setColumnFilter(key2, e11.target.value)} />
-                            </th>`;
-    })}
-                        ${(() => {
-      if (this.dataActions && this.dataActions.length > 0) {
-        return b2` <th></th> `;
-      }
-    })()}
-                      </tr>` : b2``}
+                  ${this.renderHeaderRows(effectiveColumns)}
                 </thead>
                 <tbody>
                   ${viewData.map((itemArg, rowIndex) => {
@@ -170152,6 +170212,13 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
                 </tbody>
               </table>
               </div>
+              <div class="floatingHeader" aria-hidden="true">
+                <table>
+                  <thead>
+                    ${this.renderHeaderRows(effectiveColumns)}
+                  </thead>
+                </table>
+              </div>
             ` : b2` <div class="noDataSet">No data set!</div> `}
         <div slot="footer" class="footer">
           <div class="tableStatistics">
@@ -170186,11 +170253,226 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
       </dees-tile>
     `;
   }
+  /**
+   * Renders the header rows. Used twice per render: once inside the real
+   * `<thead>` and once inside the floating-header clone, so sort indicators
+   * and filter inputs stay in sync automatically.
+   */
+  renderHeaderRows(effectiveColumns) {
+    return b2`
+      <tr>
+        ${this.selectionMode !== "none" ? b2`
+              <th style="width:42px; text-align:center;">
+                ${this.selectionMode === "multi" ? b2`
+                      <dees-input-checkbox
+                        .value=${this.areAllVisibleSelected()}
+                        .indeterminate=${this.isVisibleSelectionIndeterminate()}
+                        @newValue=${(e11) => {
+      e11.stopPropagation();
+      this.setSelectVisible(e11.detail === true);
+    }}
+                      ></dees-input-checkbox>
+                    ` : b2``}
+              </th>
+            ` : b2``}
+        ${effectiveColumns.filter((c11) => !c11.hidden).map((col) => {
+      const isSortable = !!col.sortable;
+      const ariaSort = this.getAriaSort(col);
+      return b2`
+              <th
+                role="columnheader"
+                aria-sort=${ariaSort}
+                style="${isSortable ? "cursor: pointer;" : ""}"
+                @click=${(eventArg) => isSortable ? this.handleHeaderClick(eventArg, col, effectiveColumns) : null}
+                @contextmenu=${(eventArg) => isSortable ? this.openHeaderContextMenu(eventArg, col, effectiveColumns) : null}
+              >
+                ${col.header ?? col.key}
+                ${this.renderSortIndicator(col)}
+              </th>`;
+    })}
+        ${this.dataActions && this.dataActions.length > 0 ? b2`<th class="actionsCol">Actions</th>` : b2``}
+      </tr>
+      ${this.showColumnFilters ? b2`<tr class="filtersRow">
+            ${this.selectionMode !== "none" ? b2`<th style="width:42px;"></th>` : b2``}
+            ${effectiveColumns.filter((c11) => !c11.hidden).map((col) => {
+      const key2 = String(col.key);
+      if (col.filterable === false) return b2`<th></th>`;
+      return b2`<th>
+                  <input type="text" placeholder="Filter..." .value=${this.columnFilters[key2] || ""}
+                    @input=${(e11) => this.setColumnFilter(key2, e11.target.value)} />
+                </th>`;
+    })}
+            ${this.dataActions && this.dataActions.length > 0 ? b2`<th></th>` : b2``}
+          </tr>` : b2``}
+    `;
+  }
+  get __floatingHeaderEl() {
+    return this.shadowRoot?.querySelector(".floatingHeader") ?? null;
+  }
+  get __realTableEl() {
+    return this.shadowRoot?.querySelector(".tableScroll > table") ?? null;
+  }
+  get __floatingTableEl() {
+    return this.shadowRoot?.querySelector(".floatingHeader > table") ?? null;
+  }
+  /**
+   * Walks up the DOM (and through shadow roots) collecting every ancestor
+   * element whose computed `overflow-y` makes it a scroll container, plus
+   * `window` at the end. We listen for scroll on all of them so the floating
+   * header reacts whether the user scrolls the page or any nested container.
+   */
+  __collectScrollAncestors() {
+    const result = [];
+    let node2 = this;
+    const scrollish = /* @__PURE__ */ __name((v5) => v5 === "auto" || v5 === "scroll" || v5 === "overlay", "scrollish");
+    while (node2) {
+      if (node2 instanceof Element) {
+        const style2 = getComputedStyle(node2);
+        const sy = scrollish(style2.overflowY);
+        const sx = scrollish(style2.overflowX);
+        if (sy || sx) {
+          result.push({ target: node2, scrollsY: sy, scrollsX: sx });
+        }
+      }
+      const parent = node2.assignedSlot ? node2.assignedSlot : node2.parentNode;
+      if (parent) {
+        node2 = parent;
+      } else if (node2.host) {
+        node2 = node2.host;
+      } else {
+        node2 = null;
+      }
+    }
+    result.push({ target: window, scrollsY: true, scrollsX: true });
+    return result;
+  }
+  /**
+   * Returns the "stick line" — the y-coordinate (in viewport space) at which
+   * the floating header should appear. Defaults to 0 (page top), but if the
+   * table is inside a scroll container we use that container's content-box
+   * top so the header sits inside the container's border/padding instead of
+   * floating over it.
+   */
+  __getStickContext() {
+    let top = 0;
+    let left = 0;
+    let right = window.innerWidth;
+    for (const a5 of this.__scrollAncestors) {
+      if (a5.target === window) continue;
+      const el = a5.target;
+      const r11 = el.getBoundingClientRect();
+      const cs = getComputedStyle(el);
+      if (a5.scrollsY) {
+        const bt = parseFloat(cs.borderTopWidth) || 0;
+        top = Math.max(top, r11.top + bt);
+      }
+      if (a5.scrollsX) {
+        const bl = parseFloat(cs.borderLeftWidth) || 0;
+        const br = parseFloat(cs.borderRightWidth) || 0;
+        left = Math.max(left, r11.left + bl);
+        right = Math.min(right, r11.right - br);
+      }
+    }
+    return { top, left, right };
+  }
+  setupFloatingHeader() {
+    this.teardownFloatingHeader();
+    if (this.fixedHeight) return;
+    const realTable = this.__realTableEl;
+    if (!realTable) return;
+    this.__scrollAncestors = this.__collectScrollAncestors();
+    const tableScrollEl = this.shadowRoot?.querySelector(".tableScroll");
+    if (tableScrollEl) {
+      this.__scrollAncestors.unshift({ target: tableScrollEl, scrollsY: false, scrollsX: true });
+    }
+    this.__floatingResizeObserver = new ResizeObserver(() => {
+      this.__syncFloatingHeader();
+    });
+    this.__floatingResizeObserver.observe(realTable);
+    this.__floatingScrollHandler = () => this.__syncFloatingHeader();
+    for (const a5 of this.__scrollAncestors) {
+      a5.target.addEventListener("scroll", this.__floatingScrollHandler, { passive: true });
+    }
+    window.addEventListener("resize", this.__floatingScrollHandler, { passive: true });
+    this.__syncFloatingHeader();
+  }
+  teardownFloatingHeader() {
+    this.__floatingResizeObserver?.disconnect();
+    this.__floatingResizeObserver = void 0;
+    if (this.__floatingScrollHandler) {
+      for (const a5 of this.__scrollAncestors) {
+        a5.target.removeEventListener("scroll", this.__floatingScrollHandler);
+      }
+      window.removeEventListener("resize", this.__floatingScrollHandler);
+      this.__floatingScrollHandler = void 0;
+    }
+    this.__scrollAncestors = [];
+    this.__floatingActive = false;
+    const fh = this.__floatingHeaderEl;
+    if (fh) fh.classList.remove("active");
+  }
+  /**
+   * Single function that drives both activation and geometry of the floating
+   * header. Called on scroll, resize, table-resize, and after each render.
+   */
+  __syncFloatingHeader() {
+    const fh = this.__floatingHeaderEl;
+    const realTable = this.__realTableEl;
+    const floatTable = this.__floatingTableEl;
+    if (!fh || !realTable || !floatTable) return;
+    const tableRect = realTable.getBoundingClientRect();
+    const stick = this.__getStickContext();
+    floatTable.style.tableLayout = realTable.style.tableLayout || "auto";
+    const realHeadRows = realTable.tHead?.rows;
+    const floatHeadRows = floatTable.tHead?.rows;
+    let headerHeight = 0;
+    if (realHeadRows && floatHeadRows) {
+      for (let r11 = 0; r11 < realHeadRows.length && r11 < floatHeadRows.length; r11++) {
+        headerHeight += realHeadRows[r11].getBoundingClientRect().height;
+        const realCells = realHeadRows[r11].cells;
+        const floatCells = floatHeadRows[r11].cells;
+        for (let c11 = 0; c11 < realCells.length && c11 < floatCells.length; c11++) {
+          const w4 = realCells[c11].getBoundingClientRect().width;
+          floatCells[c11].style.width = `${w4}px`;
+          floatCells[c11].style.minWidth = `${w4}px`;
+          floatCells[c11].style.maxWidth = `${w4}px`;
+        }
+      }
+    }
+    const shouldBeActive = tableRect.top < stick.top && tableRect.bottom > stick.top + Math.min(headerHeight, 1);
+    if (shouldBeActive !== this.__floatingActive) {
+      this.__floatingActive = shouldBeActive;
+      fh.classList.toggle("active", shouldBeActive);
+    }
+    if (!shouldBeActive) return;
+    const clipLeft = Math.max(tableRect.left, stick.left);
+    const clipRight = Math.min(tableRect.right, stick.right);
+    const clipWidth = Math.max(0, clipRight - clipLeft);
+    fh.style.top = `${stick.top}px`;
+    fh.style.left = `${clipLeft}px`;
+    fh.style.width = `${clipWidth}px`;
+    floatTable.style.width = `${tableRect.width}px`;
+    floatTable.style.marginLeft = `${tableRect.left - clipLeft}px`;
+  }
+  async disconnectedCallback() {
+    super.disconnectedCallback();
+    this.teardownFloatingHeader();
+  }
   async firstUpdated() {
   }
   async updated(changedProperties) {
     super.updated(changedProperties);
     this.determineColumnWidths();
+    if (changedProperties.has("fixedHeight") || changedProperties.has("data") || changedProperties.has("columns") || !this.__floatingScrollHandler) {
+      if (!this.fixedHeight && this.data.length > 0) {
+        this.setupFloatingHeader();
+      } else {
+        this.teardownFloatingHeader();
+      }
+    }
+    if (!this.fixedHeight && this.data.length > 0) {
+      this.__syncFloatingHeader();
+    }
     if (this.searchable) {
       const existing = this.dataActions.find((actionArg) => actionArg.type?.includes("header") && actionArg.name === "Search");
       if (!existing) {
@@ -170287,33 +170569,302 @@ var _DeesTable = class _DeesTable extends (_a42 = DeesElement, _heading1_dec = [
     table2.style.tableLayout = "fixed";
   }
   // compute helpers moved to ./data.ts
-  toggleSort(col) {
-    const key2 = String(col.key);
-    if (this.sortKey !== key2) {
-      this.sortKey = key2;
-      this.sortDir = "asc";
-    } else {
-      if (this.sortDir === "asc") this.sortDir = "desc";
-      else if (this.sortDir === "desc") {
-        this.sortDir = null;
-        this.sortKey = void 0;
-      } else this.sortDir = "asc";
-    }
+  // ─── sort: public API ────────────────────────────────────────────────
+  /** Returns the descriptor for `key` if the column is currently in the cascade. */
+  getSortDescriptor(key2) {
+    return this.sortBy.find((d6) => d6.key === key2);
+  }
+  /** Returns the 0-based priority of `key` in the cascade, or -1 if not present. */
+  getSortPriority(key2) {
+    return this.sortBy.findIndex((d6) => d6.key === key2);
+  }
+  /** Replaces the cascade with a single sort entry. */
+  setSort(key2, dir) {
+    this.sortBy = [{ key: key2, dir }];
+    this.emitSortChange();
+    this.requestUpdate();
+  }
+  /**
+   * Inserts (or moves) `key` to a 0-based position in the cascade. If the key is
+   * already present elsewhere, its previous entry is removed before insertion so
+   * a column appears at most once.
+   */
+  addSortAt(key2, position3, dir) {
+    const next2 = this.sortBy.filter((d6) => d6.key !== key2);
+    const clamped = Math.max(0, Math.min(position3, next2.length));
+    next2.splice(clamped, 0, { key: key2, dir });
+    this.sortBy = next2;
+    this.emitSortChange();
+    this.requestUpdate();
+  }
+  /** Appends `key` to the end of the cascade (or moves it there if already present). */
+  appendSort(key2, dir) {
+    const next2 = this.sortBy.filter((d6) => d6.key !== key2);
+    next2.push({ key: key2, dir });
+    this.sortBy = next2;
+    this.emitSortChange();
+    this.requestUpdate();
+  }
+  /** Removes `key` from the cascade. No-op if not present. */
+  removeSort(key2) {
+    if (!this.sortBy.some((d6) => d6.key === key2)) return;
+    this.sortBy = this.sortBy.filter((d6) => d6.key !== key2);
+    this.emitSortChange();
+    this.requestUpdate();
+  }
+  /** Empties the cascade. */
+  clearSorts() {
+    if (this.sortBy.length === 0) return;
+    this.sortBy = [];
+    this.emitSortChange();
+    this.requestUpdate();
+  }
+  emitSortChange() {
     this.dispatchEvent(
       new CustomEvent("sortChange", {
-        detail: { key: this.sortKey, dir: this.sortDir },
+        detail: { sortBy: this.sortBy.map((d6) => ({ ...d6 })) },
         bubbles: true
       })
     );
-    this.requestUpdate();
   }
+  // ─── sort: header interaction handlers ───────────────────────────────
+  /**
+   * Plain left-click on a sortable header. Cycles `none → asc → desc → none`
+   * collapsing the cascade to a single column. If a multi-column cascade is
+   * active, asks the user to confirm the destructive replacement first. A
+   * Shift+click bypasses the modal and routes through the multi-sort cycle.
+   */
+  async handleHeaderClick(eventArg, col, _effectiveColumns) {
+    if (eventArg.shiftKey) {
+      this.handleHeaderShiftClick(col);
+      return;
+    }
+    const proceed = await this.confirmReplaceCascade(col);
+    if (!proceed) return;
+    this.cycleSingleSort(col);
+  }
+  /**
+   * Cycles a single column through `none → asc → desc → none`, collapsing the
+   * cascade. Used by both plain click and the menu's "Sort Ascending/Descending"
+   * shortcuts (after confirmation).
+   */
+  cycleSingleSort(col) {
+    const key2 = String(col.key);
+    const current = this.sortBy.length === 1 && this.sortBy[0].key === key2 ? this.sortBy[0].dir : null;
+    if (current === "asc") this.setSort(key2, "desc");
+    else if (current === "desc") this.clearSorts();
+    else this.setSort(key2, "asc");
+  }
+  /**
+   * Shift+click cycle on a sortable header. Edits the cascade in place without
+   * destroying other sort keys: append → flip dir → remove.
+   */
+  handleHeaderShiftClick(col) {
+    const key2 = String(col.key);
+    const existing = this.getSortDescriptor(key2);
+    if (!existing) {
+      this.appendSort(key2, "asc");
+    } else if (existing.dir === "asc") {
+      this.sortBy = this.sortBy.map((d6) => d6.key === key2 ? { key: key2, dir: "desc" } : d6);
+      this.emitSortChange();
+      this.requestUpdate();
+    } else {
+      this.removeSort(key2);
+    }
+  }
+  /**
+   * Opens a confirmation modal when the cascade has more than one entry and the
+   * user attempts a destructive single-sort replacement. Resolves to `true` if
+   * the user accepts, `false` if they cancel. If the cascade has 0 or 1 entries
+   * the modal is skipped and we resolve to `true` immediately.
+   */
+  confirmReplaceCascade(targetCol) {
+    if (this.sortBy.length <= 1) return Promise.resolve(true);
+    return new Promise((resolve2) => {
+      let settled = false;
+      const settle = /* @__PURE__ */ __name((result) => {
+        if (settled) return;
+        settled = true;
+        resolve2(result);
+      }, "settle");
+      const summary = this.sortBy.map((d6, i11) => {
+        const c11 = this._lookupColumnByKey?.(d6.key);
+        const label = c11?.header ?? d6.key;
+        return b2`<li>${i11 + 1}. ${label} ${d6.dir === "asc" ? "\u25B2" : "\u25BC"}</li>`;
+      });
+      DeesModal.createAndShow({
+        heading: "Replace multi-column sort?",
+        width: "small",
+        showCloseButton: true,
+        content: b2`
+          <div style="font-size:13px; line-height:1.55;">
+            <p style="margin:0 0 8px;">
+              You currently have a ${this.sortBy.length}-column sort active:
+            </p>
+            <ul style="margin:0 0 12px; padding-left:18px;">${summary}</ul>
+            <p style="margin:0;">
+              Continuing will discard the cascade and replace it with a single sort on
+              <strong>${targetCol.header ?? String(targetCol.key)}</strong>.
+            </p>
+          </div>
+        `,
+        menuOptions: [
+          {
+            name: "Cancel",
+            iconName: "lucide:x",
+            action: /* @__PURE__ */ __name(async (modal) => {
+              settle(false);
+              await modal.destroy();
+              return null;
+            }, "action")
+          },
+          {
+            name: "Replace",
+            iconName: "lucide:check",
+            action: /* @__PURE__ */ __name(async (modal) => {
+              settle(true);
+              await modal.destroy();
+              return null;
+            }, "action")
+          }
+        ]
+      });
+    });
+  }
+  /**
+   * Looks up a column by its string key in the currently effective column set.
+   * Used by the modal helper to render human-friendly labels.
+   */
+  _lookupColumnByKey(key2) {
+    const usingColumns = Array.isArray(this.columns) && this.columns.length > 0;
+    const effective = usingColumns ? computeEffectiveColumns(this.columns, this.augmentFromDisplayFunction, this.displayFunction, this.data) : computeColumnsFromDisplayFunction(this.displayFunction, this.data);
+    return effective.find((c11) => String(c11.key) === key2);
+  }
+  /**
+   * Opens the header context menu for explicit multi-sort priority control.
+   */
+  openHeaderContextMenu(eventArg, col, effectiveColumns) {
+    const items = this.buildHeaderMenuItems(col, effectiveColumns);
+    DeesContextmenu.openContextMenuWithOptions(eventArg, items);
+  }
+  /**
+   * Builds the dynamic context-menu structure for a single column header.
+   */
+  buildHeaderMenuItems(col, effectiveColumns) {
+    const key2 = String(col.key);
+    const existing = this.getSortDescriptor(key2);
+    const cascadeLen = this.sortBy.length;
+    const sortableColumnCount = effectiveColumns.filter((c11) => !!c11.sortable).length;
+    const maxSlot = Math.min(
+      Math.max(cascadeLen + (existing ? 0 : 1), 1),
+      Math.max(sortableColumnCount, 1)
+    );
+    const items = [];
+    items.push({
+      name: "Sort Ascending",
+      iconName: cascadeLen === 1 && existing?.dir === "asc" ? "lucide:check" : "lucide:arrowUp",
+      action: /* @__PURE__ */ __name(async () => {
+        if (await this.confirmReplaceCascade(col)) this.setSort(key2, "asc");
+        return null;
+      }, "action")
+    });
+    items.push({
+      name: "Sort Descending",
+      iconName: cascadeLen === 1 && existing?.dir === "desc" ? "lucide:check" : "lucide:arrowDown",
+      action: /* @__PURE__ */ __name(async () => {
+        if (await this.confirmReplaceCascade(col)) this.setSort(key2, "desc");
+        return null;
+      }, "action")
+    });
+    items.push({ divider: true });
+    for (let slot = 1; slot <= maxSlot; slot++) {
+      const ordinal = ordinalLabel(slot);
+      const isCurrentSlot = existing && this.getSortPriority(key2) === slot - 1;
+      items.push({
+        name: `Set as ${ordinal} sort`,
+        iconName: isCurrentSlot ? "lucide:check" : "lucide:listOrdered",
+        submenu: [
+          {
+            name: "Ascending",
+            iconName: "lucide:arrowUp",
+            action: /* @__PURE__ */ __name(async () => {
+              this.addSortAt(key2, slot - 1, "asc");
+              return null;
+            }, "action")
+          },
+          {
+            name: "Descending",
+            iconName: "lucide:arrowDown",
+            action: /* @__PURE__ */ __name(async () => {
+              this.addSortAt(key2, slot - 1, "desc");
+              return null;
+            }, "action")
+          }
+        ]
+      });
+    }
+    items.push({ divider: true });
+    items.push({
+      name: "Append to sort",
+      iconName: "lucide:plus",
+      submenu: [
+        {
+          name: "Ascending",
+          iconName: "lucide:arrowUp",
+          action: /* @__PURE__ */ __name(async () => {
+            this.appendSort(key2, "asc");
+            return null;
+          }, "action")
+        },
+        {
+          name: "Descending",
+          iconName: "lucide:arrowDown",
+          action: /* @__PURE__ */ __name(async () => {
+            this.appendSort(key2, "desc");
+            return null;
+          }, "action")
+        }
+      ]
+    });
+    if (existing) {
+      items.push({ divider: true });
+      items.push({
+        name: "Remove from sort",
+        iconName: "lucide:minus",
+        action: /* @__PURE__ */ __name(async () => {
+          this.removeSort(key2);
+          return null;
+        }, "action")
+      });
+    }
+    if (cascadeLen > 0) {
+      if (!existing) items.push({ divider: true });
+      items.push({
+        name: "Clear all sorts",
+        iconName: "lucide:trash",
+        action: /* @__PURE__ */ __name(async () => {
+          this.clearSorts();
+          return null;
+        }, "action")
+      });
+    }
+    return items;
+  }
+  // ─── sort: indicator + ARIA ──────────────────────────────────────────
   getAriaSort(col) {
-    if (String(col.key) !== this.sortKey || !this.sortDir) return "none";
-    return this.sortDir === "asc" ? "ascending" : "descending";
+    const primary = this.sortBy[0];
+    if (!primary || primary.key !== String(col.key)) return "none";
+    return primary.dir === "asc" ? "ascending" : "descending";
   }
   renderSortIndicator(col) {
-    if (String(col.key) !== this.sortKey || !this.sortDir) return b2``;
-    return b2`<span style="margin-left:6px; opacity:0.7;">${this.sortDir === "asc" ? "\u25B2" : "\u25BC"}</span>`;
+    const idx = this.getSortPriority(String(col.key));
+    if (idx < 0) return b2``;
+    const desc = this.sortBy[idx];
+    const arrow2 = desc.dir === "asc" ? "\u25B2" : "\u25BC";
+    if (this.sortBy.length === 1) {
+      return b2`<span class="sortArrow">${arrow2}</span>`;
+    }
+    return b2`<span class="sortArrow">${arrow2}</span><span class="sortBadge">${idx + 1}</span>`;
   }
   // filtering helpers
   setFilterText(value2) {
@@ -170478,12 +171029,11 @@ _editableFields = new WeakMap();
 _showVerticalLines = new WeakMap();
 _showHorizontalLines = new WeakMap();
 _showGrid = new WeakMap();
-_sortKey = new WeakMap();
-_sortDir = new WeakMap();
+_sortBy = new WeakMap();
 _filterText = new WeakMap();
 _columnFilters = new WeakMap();
 _showColumnFilters = new WeakMap();
-_stickyHeader = new WeakMap();
+_fixedHeight = new WeakMap();
 _searchMode = new WeakMap();
 _selectionMode = new WeakMap();
 _selectedIds = new WeakMap();
@@ -170507,12 +171057,11 @@ __decorateElement(_init39, 4, "editableFields", _editableFields_dec, _DeesTable,
 __decorateElement(_init39, 4, "showVerticalLines", _showVerticalLines_dec, _DeesTable, _showVerticalLines);
 __decorateElement(_init39, 4, "showHorizontalLines", _showHorizontalLines_dec, _DeesTable, _showHorizontalLines);
 __decorateElement(_init39, 4, "showGrid", _showGrid_dec, _DeesTable, _showGrid);
-__decorateElement(_init39, 4, "sortKey", _sortKey_dec, _DeesTable, _sortKey);
-__decorateElement(_init39, 4, "sortDir", _sortDir_dec, _DeesTable, _sortDir);
+__decorateElement(_init39, 4, "sortBy", _sortBy_dec, _DeesTable, _sortBy);
 __decorateElement(_init39, 4, "filterText", _filterText_dec, _DeesTable, _filterText);
 __decorateElement(_init39, 4, "columnFilters", _columnFilters_dec, _DeesTable, _columnFilters);
 __decorateElement(_init39, 4, "showColumnFilters", _showColumnFilters_dec, _DeesTable, _showColumnFilters);
-__decorateElement(_init39, 4, "stickyHeader", _stickyHeader_dec, _DeesTable, _stickyHeader);
+__decorateElement(_init39, 4, "fixedHeight", _fixedHeight_dec, _DeesTable, _fixedHeight);
 __decorateElement(_init39, 4, "searchMode", _searchMode_dec, _DeesTable, _searchMode);
 __decorateElement(_init39, 4, "selectionMode", _selectionMode_dec, _DeesTable, _selectionMode);
 __decorateElement(_init39, 4, "selectedIds", _selectedIds_dec, _DeesTable, _selectedIds);