@nasa-terra/components 0.0.166 → 0.0.167

package/dist/chunks/chunk.RBEXUNHZ.js

@@ -0,0 +1,581 @@
+import {
+  tabs_styles_default
+} from "./chunk.JYKXSRHP.js";
+import {
+  scrollIntoView
+} from "./chunk.C3ZW37SO.js";
+import {
+  TerraIcon
+} from "./chunk.HWE36KUL.js";
+import {
+  watch
+} from "./chunk.NWXJOH5T.js";
+import {
+  TerraElement,
+  component_styles_default
+} from "./chunk.ABJSJSVR.js";
+import {
+  __decorateClass,
+  __spreadValues
+} from "./chunk.SHKVBVTI.js";
+
+// src/internal/scrollend-polyfill.ts
+var debounce = (fn, delay) => {
+  let timerId = 0;
+  return function(...args) {
+    window.clearTimeout(timerId);
+    timerId = window.setTimeout(() => {
+      fn.call(this, ...args);
+    }, delay);
+  };
+};
+var decorate = (proto, method, decorateFn) => {
+  const superFn = proto[method];
+  proto[method] = function(...args) {
+    superFn.call(this, ...args);
+    decorateFn.call(this, superFn, ...args);
+  };
+};
+var isSupported = "onscrollend" in window;
+if (!isSupported) {
+  const pointers = /* @__PURE__ */ new Set();
+  const scrollHandlers = /* @__PURE__ */ new WeakMap();
+  const handlePointerDown = (event) => {
+    for (const touch of event.changedTouches) {
+      pointers.add(touch.identifier);
+    }
+  };
+  const handlePointerUp = (event) => {
+    for (const touch of event.changedTouches) {
+      pointers.delete(touch.identifier);
+    }
+  };
+  document.addEventListener("touchstart", handlePointerDown, true);
+  document.addEventListener("touchend", handlePointerUp, true);
+  document.addEventListener("touchcancel", handlePointerUp, true);
+  decorate(
+    EventTarget.prototype,
+    "addEventListener",
+    function(addEventListener, type) {
+      if (type !== "scrollend")
+        return;
+      const handleScrollEnd = debounce(() => {
+        if (!pointers.size) {
+          this.dispatchEvent(new Event("scrollend"));
+        } else {
+          handleScrollEnd();
+        }
+      }, 100);
+      addEventListener.call(this, "scroll", handleScrollEnd, { passive: true });
+      scrollHandlers.set(this, handleScrollEnd);
+    }
+  );
+  decorate(
+    EventTarget.prototype,
+    "removeEventListener",
+    function(removeEventListener, type) {
+      if (type !== "scrollend")
+        return;
+      const scrollHandler = scrollHandlers.get(this);
+      if (scrollHandler) {
+        removeEventListener.call(this, "scroll", scrollHandler, {
+          passive: true
+        });
+      }
+    }
+  );
+}
+
+// src/components/tabs/tabs.component.ts
+import { classMap } from "lit/directives/class-map.js";
+import { eventOptions, property, query, state } from "lit/decorators.js";
+import { html } from "lit";
+var TerraTabs = class extends TerraElement {
+  constructor() {
+    super(...arguments);
+    this.tabs = [];
+    this.focusableTabs = [];
+    this.panels = [];
+    this.hasScrollControls = false;
+    this.shouldHideScrollStartButton = false;
+    this.shouldHideScrollEndButton = false;
+    this.placement = "top";
+    this.activation = "auto";
+    this.noScrollControls = false;
+    this.fixedScrollControls = false;
+    this.size = "large";
+    /**
+     * The reality of the browser means that we can't expect the scroll position to be exactly what we want it to be, so
+     * we add one pixel of wiggle room to our calculations.
+     */
+    this.scrollOffset = 1;
+  }
+  connectedCallback() {
+    const whenAllDefined = Promise.all([
+      customElements.whenDefined("terra-tab"),
+      customElements.whenDefined("terra-tab-panel")
+    ]);
+    super.connectedCallback();
+    this.resizeObserver = new ResizeObserver(() => {
+      this.repositionIndicator();
+      this.updateScrollControls();
+    });
+    this.mutationObserver = new MutationObserver((mutations) => {
+      const instanceMutations = mutations.filter(({ target }) => {
+        if (target === this)
+          return true;
+        if (target.closest("terra-tabs") !== this)
+          return false;
+        const tagName = target.tagName.toLowerCase();
+        return tagName === "terra-tab" || tagName === "terra-tab-panel";
+      });
+      if (instanceMutations.length === 0) {
+        return;
+      }
+      if (instanceMutations.some(
+        (m) => !["aria-labelledby", "aria-controls"].includes(
+          m.attributeName
+        )
+      )) {
+        setTimeout(() => this.setAriaLabels());
+      }
+      if (instanceMutations.some((m) => m.attributeName === "disabled")) {
+        this.syncTabsAndPanels();
+      } else if (instanceMutations.some((m) => m.attributeName === "active")) {
+        const tabs = instanceMutations.filter(
+          (m) => m.attributeName === "active" && m.target.tagName.toLowerCase() === "terra-tab"
+        ).map((m) => m.target);
+        const newActiveTab = tabs.find((tab) => tab.active);
+        if (newActiveTab) {
+          this.setActiveTab(newActiveTab);
+        }
+      }
+    });
+    this.updateComplete.then(() => {
+      this.syncTabsAndPanels();
+      this.mutationObserver.observe(this, {
+        attributes: true,
+        attributeFilter: ["active", "disabled", "name", "panel"],
+        childList: true,
+        subtree: true
+      });
+      if (this.nav) {
+        this.resizeObserver.observe(this.nav);
+      }
+      whenAllDefined.then(() => {
+        const intersectionObserver = new IntersectionObserver(
+          (entries, observer) => {
+            var _a;
+            if (entries[0].intersectionRatio > 0) {
+              this.setAriaLabels();
+              this.setActiveTab((_a = this.getActiveTab()) != null ? _a : this.tabs[0], {
+                emitEvents: false
+              });
+              observer.unobserve(entries[0].target);
+            }
+          }
+        );
+        if (this.tabsElement) {
+          intersectionObserver.observe(this.tabsElement);
+        }
+      });
+    });
+  }
+  disconnectedCallback() {
+    var _a, _b;
+    super.disconnectedCallback();
+    (_a = this.mutationObserver) == null ? void 0 : _a.disconnect();
+    if (this.nav) {
+      (_b = this.resizeObserver) == null ? void 0 : _b.unobserve(this.nav);
+    }
+  }
+  getAllTabs() {
+    const slot = this.shadowRoot.querySelector('slot[name="nav"]');
+    return slot.assignedElements();
+  }
+  getAllPanels() {
+    return [...this.body.assignedElements()].filter(
+      (el) => el.tagName.toLowerCase() === "terra-tab-panel"
+    );
+  }
+  getActiveTab() {
+    return this.tabs.find((el) => el.active);
+  }
+  handleClick(event) {
+    const target = event.target;
+    const tab = target.closest("terra-tab");
+    const tabs = tab == null ? void 0 : tab.closest("terra-tabs");
+    if (tabs !== this) {
+      return;
+    }
+    if (tab !== null) {
+      this.setActiveTab(tab, { scrollBehavior: "smooth" });
+    }
+  }
+  handleKeyDown(event) {
+    const target = event.target;
+    const tab = target.closest("terra-tab");
+    const tabs = tab == null ? void 0 : tab.closest("terra-tabs");
+    if (tabs !== this) {
+      return;
+    }
+    if (["Enter", " "].includes(event.key)) {
+      if (tab !== null) {
+        this.setActiveTab(tab, { scrollBehavior: "smooth" });
+        event.preventDefault();
+      }
+    }
+    if ([
+      "ArrowLeft",
+      "ArrowRight",
+      "ArrowUp",
+      "ArrowDown",
+      "Home",
+      "End"
+    ].includes(event.key)) {
+      const activeEl = this.tabs.find((t) => t.matches(":focus"));
+      const isRtl = getComputedStyle(this).direction === "rtl";
+      let nextTab = null;
+      if ((activeEl == null ? void 0 : activeEl.tagName.toLowerCase()) === "terra-tab") {
+        if (event.key === "Home") {
+          nextTab = this.focusableTabs[0];
+        } else if (event.key === "End") {
+          nextTab = this.focusableTabs[this.focusableTabs.length - 1];
+        } else if (["top", "bottom"].includes(this.placement) && event.key === (isRtl ? "ArrowRight" : "ArrowLeft") || ["start", "end"].includes(this.placement) && event.key === "ArrowUp") {
+          const currentIndex = this.tabs.findIndex((el) => el === activeEl);
+          nextTab = this.findNextFocusableTab(currentIndex, "backward");
+        } else if (["top", "bottom"].includes(this.placement) && event.key === (isRtl ? "ArrowLeft" : "ArrowRight") || ["start", "end"].includes(this.placement) && event.key === "ArrowDown") {
+          const currentIndex = this.tabs.findIndex((el) => el === activeEl);
+          nextTab = this.findNextFocusableTab(currentIndex, "forward");
+        }
+        if (!nextTab) {
+          return;
+        }
+        nextTab.tabIndex = 0;
+        nextTab.focus({ preventScroll: true });
+        if (this.activation === "auto") {
+          this.setActiveTab(nextTab, { scrollBehavior: "smooth" });
+        } else {
+          this.tabs.forEach((tabEl) => {
+            tabEl.tabIndex = tabEl === nextTab ? 0 : -1;
+          });
+        }
+        if (["top", "bottom"].includes(this.placement)) {
+          scrollIntoView(nextTab, this.nav, "horizontal");
+        }
+        event.preventDefault();
+      }
+    }
+  }
+  handleScrollToStart() {
+    const isRtl = getComputedStyle(this).direction === "rtl";
+    this.nav.scroll({
+      left: isRtl ? this.nav.scrollLeft + this.nav.clientWidth : this.nav.scrollLeft - this.nav.clientWidth,
+      behavior: "smooth"
+    });
+  }
+  handleScrollToEnd() {
+    const isRtl = getComputedStyle(this).direction === "rtl";
+    this.nav.scroll({
+      left: isRtl ? this.nav.scrollLeft - this.nav.clientWidth : this.nav.scrollLeft + this.nav.clientWidth,
+      behavior: "smooth"
+    });
+  }
+  setActiveTab(tab, options) {
+    options = __spreadValues({
+      emitEvents: true,
+      scrollBehavior: "auto"
+    }, options);
+    if (tab !== this.activeTab && !tab.disabled) {
+      const previousTab = this.activeTab;
+      this.activeTab = tab;
+      this.tabs.forEach((el) => {
+        el.active = el === this.activeTab;
+        el.tabIndex = el === this.activeTab ? 0 : -1;
+      });
+      this.panels.forEach((el) => {
+        var _a;
+        return el.active = el.name === ((_a = this.activeTab) == null ? void 0 : _a.panel);
+      });
+      this.syncIndicator();
+      if (["top", "bottom"].includes(this.placement)) {
+        scrollIntoView(
+          this.activeTab,
+          this.nav,
+          "horizontal",
+          options.scrollBehavior
+        );
+      }
+      if (options.emitEvents) {
+        if (previousTab) {
+          this.emit("terra-tab-hide", {
+            detail: { name: previousTab.panel }
+          });
+        }
+        this.emit("terra-tab-show", {
+          detail: { name: this.activeTab.panel }
+        });
+      }
+    }
+  }
+  setAriaLabels() {
+    this.tabs.forEach((tab) => {
+      const panel = this.panels.find((el) => el.name === tab.panel);
+      if (panel) {
+        tab.setAttribute("aria-controls", panel.getAttribute("id"));
+        panel.setAttribute("aria-labelledby", tab.getAttribute("id"));
+      }
+    });
+  }
+  repositionIndicator() {
+    const currentTab = this.getActiveTab();
+    if (!currentTab) {
+      return;
+    }
+    const width = currentTab.clientWidth;
+    const height = currentTab.clientHeight;
+    const isRtl = getComputedStyle(this).direction === "rtl";
+    const allTabs = this.getAllTabs();
+    const precedingTabs = allTabs.slice(0, allTabs.indexOf(currentTab));
+    const offset = precedingTabs.reduce(
+      (previous, current) => ({
+        left: previous.left + current.clientWidth,
+        top: previous.top + current.clientHeight
+      }),
+      { left: 0, top: 0 }
+    );
+    switch (this.placement) {
+      case "top":
+      case "bottom":
+        this.indicator.style.width = `${width}px`;
+        this.indicator.style.translate = isRtl ? `${-1 * offset.left}px` : `${offset.left}px`;
+        break;
+      case "start":
+      case "end":
+        this.indicator.style.height = `${height}px`;
+        this.indicator.style.translate = `0 ${offset.top}px`;
+        break;
+    }
+  }
+  // This stores tabs and panels so we can refer to a cache instead of calling querySelectorAll() multiple times.
+  syncTabsAndPanels() {
+    this.tabs = this.getAllTabs();
+    this.focusableTabs = this.tabs.filter((el) => !el.disabled);
+    this.tabs.forEach((tab) => {
+      if (!tab.hasAttribute("size")) {
+        tab.size = this.size;
+      }
+    });
+    this.panels = this.getAllPanels();
+    this.syncIndicator();
+    this.updateComplete.then(() => this.updateScrollControls());
+  }
+  findNextFocusableTab(currentIndex, direction) {
+    let nextTab = null;
+    const iterator = direction === "forward" ? 1 : -1;
+    let nextIndex = currentIndex + iterator;
+    while (currentIndex < this.tabs.length) {
+      nextTab = this.tabs[nextIndex] || null;
+      if (nextTab === null) {
+        if (direction === "forward") {
+          nextTab = this.focusableTabs[0];
+        } else {
+          nextTab = this.focusableTabs[this.focusableTabs.length - 1];
+        }
+        break;
+      }
+      if (!nextTab.disabled) {
+        break;
+      }
+      nextIndex += iterator;
+    }
+    return nextTab;
+  }
+  updateScrollButtons() {
+    if (this.hasScrollControls && !this.fixedScrollControls) {
+      this.shouldHideScrollStartButton = this.scrollFromStart() <= this.scrollOffset;
+      this.shouldHideScrollEndButton = this.isScrolledToEnd();
+    }
+  }
+  isScrolledToEnd() {
+    return this.scrollFromStart() + this.nav.clientWidth >= this.nav.scrollWidth - this.scrollOffset;
+  }
+  scrollFromStart() {
+    return getComputedStyle(this).direction === "rtl" ? -this.nav.scrollLeft : this.nav.scrollLeft;
+  }
+  updateScrollControls() {
+    if (this.noScrollControls) {
+      this.hasScrollControls = false;
+    } else {
+      this.hasScrollControls = ["top", "bottom"].includes(this.placement) && this.nav.scrollWidth > this.nav.clientWidth + 1;
+    }
+    this.updateScrollButtons();
+  }
+  syncIndicator() {
+    const tab = this.getActiveTab();
+    if (tab) {
+      this.indicator.style.display = "block";
+      this.repositionIndicator();
+    } else {
+      this.indicator.style.display = "none";
+    }
+  }
+  syncSize() {
+    this.tabs.forEach((tab) => {
+      if (!tab.hasAttribute("size")) {
+        tab.size = this.size;
+      }
+    });
+  }
+  /** Shows the specified tab panel. */
+  show(panel) {
+    const tab = this.tabs.find((el) => el.panel === panel);
+    if (tab) {
+      this.setActiveTab(tab, { scrollBehavior: "smooth" });
+    }
+  }
+  render() {
+    const isRtl = getComputedStyle(this).direction === "rtl";
+    return html`
+            <div
+                part="base"
+                class=${classMap({
+      tabs: true,
+      "tabs--top": this.placement === "top",
+      "tabs--bottom": this.placement === "bottom",
+      "tabs--start": this.placement === "start",
+      "tabs--end": this.placement === "end",
+      "tabs--rtl": isRtl,
+      "tabs--has-scroll-controls": this.hasScrollControls,
+      "tabs--large": this.size === "large",
+      "tabs--small": this.size === "small"
+    })}
+                @click=${this.handleClick}
+                @keydown=${this.handleKeyDown}
+            >
+                <div class="tabs__nav-container" part="nav">
+                    ${this.hasScrollControls ? html`
+                              <button
+                                  part="scroll-button scroll-button--start"
+                                  class=${classMap({
+      "tabs__scroll-button": true,
+      "tabs__scroll-button--start": true,
+      "tabs__scroll-button--start--hidden": this.shouldHideScrollStartButton
+    })}
+                                  tabindex="-1"
+                                  aria-hidden="true"
+                                  aria-label="Scroll to start"
+                                  @click=${this.handleScrollToStart}
+                                  type="button"
+                              >
+                                  <terra-icon
+                                      name=${isRtl ? "chevron-right" : "chevron-left"}
+                                      library="heroicons"
+                                      font-size="1rem"
+                                  ></terra-icon>
+                              </button>
+                          ` : ""}
+
+                    <div class="tabs__nav" @scrollend=${this.updateScrollButtons}>
+                        <div part="tabs" class="tabs__tabs" role="tablist">
+                            <div
+                                part="active-tab-indicator"
+                                class="tabs__indicator"
+                            ></div>
+                            <div class="tabs__resize-observer">
+                                <slot
+                                    name="nav"
+                                    @slotchange=${this.syncTabsAndPanels}
+                                ></slot>
+                            </div>
+                        </div>
+                    </div>
+
+                    ${this.hasScrollControls ? html`
+                              <button
+                                  part="scroll-button scroll-button--end"
+                                  class=${classMap({
+      "tabs__scroll-button": true,
+      "tabs__scroll-button--end": true,
+      "tabs__scroll-button--end--hidden": this.shouldHideScrollEndButton
+    })}
+                                  tabindex="-1"
+                                  aria-hidden="true"
+                                  aria-label="Scroll to end"
+                                  @click=${this.handleScrollToEnd}
+                                  type="button"
+                              >
+                                  <terra-icon
+                                      name=${isRtl ? "chevron-left" : "chevron-right"}
+                                      library="heroicons"
+                                      font-size="1rem"
+                                  ></terra-icon>
+                              </button>
+                          ` : ""}
+                </div>
+
+                <slot
+                    part="body"
+                    class="tabs__body"
+                    @slotchange=${this.syncTabsAndPanels}
+                ></slot>
+            </div>
+        `;
+  }
+};
+TerraTabs.styles = [component_styles_default, tabs_styles_default];
+TerraTabs.dependencies = {
+  "terra-icon": TerraIcon
+};
+__decorateClass([
+  query(".tabs")
+], TerraTabs.prototype, "tabsElement", 2);
+__decorateClass([
+  query(".tabs__body")
+], TerraTabs.prototype, "body", 2);
+__decorateClass([
+  query(".tabs__nav")
+], TerraTabs.prototype, "nav", 2);
+__decorateClass([
+  query(".tabs__indicator")
+], TerraTabs.prototype, "indicator", 2);
+__decorateClass([
+  state()
+], TerraTabs.prototype, "hasScrollControls", 2);
+__decorateClass([
+  state()
+], TerraTabs.prototype, "shouldHideScrollStartButton", 2);
+__decorateClass([
+  state()
+], TerraTabs.prototype, "shouldHideScrollEndButton", 2);
+__decorateClass([
+  property()
+], TerraTabs.prototype, "placement", 2);
+__decorateClass([
+  property()
+], TerraTabs.prototype, "activation", 2);
+__decorateClass([
+  property({ attribute: "no-scroll-controls", type: Boolean })
+], TerraTabs.prototype, "noScrollControls", 2);
+__decorateClass([
+  property({ attribute: "fixed-scroll-controls", type: Boolean })
+], TerraTabs.prototype, "fixedScrollControls", 2);
+__decorateClass([
+  property({ reflect: true })
+], TerraTabs.prototype, "size", 2);
+__decorateClass([
+  eventOptions({ passive: true })
+], TerraTabs.prototype, "updateScrollButtons", 1);
+__decorateClass([
+  watch("noScrollControls", { waitUntilFirstUpdate: true })
+], TerraTabs.prototype, "updateScrollControls", 1);
+__decorateClass([
+  watch("placement", { waitUntilFirstUpdate: true })
+], TerraTabs.prototype, "syncIndicator", 1);
+__decorateClass([
+  watch("size", { waitUntilFirstUpdate: true })
+], TerraTabs.prototype, "syncSize", 1);
+
+export {
+  TerraTabs
+};

package/dist/chunks/chunk.REHHQZMY.js

@@ -0,0 +1,11 @@
+import {
+  TerraChip
+} from "./chunk.PHNX45ET.js";
+
+// src/components/chip/chip.ts
+var chip_default = TerraChip;
+TerraChip.define("terra-chip");
+
+export {
+  chip_default
+};

package/dist/chunks/chunk.RJRVYB3F.js

@@ -0,0 +1,83 @@
+// src/components/plot-toolbar/notebooks/time-series-notebook.ts
+function getTimeSeriesNotebook(host) {
+  return [
+    {
+      cell_type: "markdown",
+      id: "367f56b9-7ca8-4435-9dcc-89bf586f33ab",
+      metadata: {},
+      source: [
+        "### Prerequisites:\n",
+        "\n",
+        "This notebook uses the `terra_ui_components`, `anywidget`, and `pandas` packages.\n",
+        "\n",
+        "After running the `pip install` cell for the first time, please reload the page to ensure the dependencies are active."
+      ]
+    },
+    {
+      id: "2733501b-0de4-4067-8aff-864e1b4c76cb",
+      cell_type: "code",
+      source: '%pip install -q "terra_ui_components==0.0.167" "anywidget==0.9.15" "pandas"',
+      metadata: {
+        trusted: true
+      },
+      outputs: [],
+      execution_count: null
+    },
+    {
+      cell_type: "markdown",
+      id: "35aa4a00-8e2c-4478-9df7-de633fd8f6ce",
+      metadata: {},
+      source: [
+        `### Render ${host.location.split(",").length > 2 ? "an area-averaged" : "a point-based"} time series plot`
+      ]
+    },
+    {
+      id: "870c1384-e706-48ee-ba07-fd552a949869",
+      cell_type: "code",
+      source: `from terra_ui_components import TerraTimeSeries
+timeseries = TerraTimeSeries()
+
+timeseries.variableEntryId = '${host.variableEntryId}'
+timeseries.startDate = '${host.startDate}'
+timeseries.endDate = '${host.endDate}'
+timeseries.location = '${host.location}'
+
+timeseries`,
+      metadata: {
+        trusted: true
+      },
+      outputs: [],
+      execution_count: null
+    },
+    {
+      cell_type: "markdown",
+      id: "25b87ed4-2ad9-4c7d-b851-bc8fea3ded5a",
+      metadata: {},
+      source: [
+        "### Access the time series data\n",
+        "\n",
+        "Once the time series runs and you see a plot, you can access the data:"
+      ]
+    },
+    {
+      cell_type: "code",
+      execution_count: null,
+      id: "6b81a089-884d-4fd7-9d4e-c45a53307c20",
+      metadata: {},
+      outputs: [],
+      source: [
+        "import pandas as pd\n",
+        'if getattr(timeseries, "data", None):\n',
+        "    df = pd.DataFrame(timeseries.data)\n",
+        "    df['timestamp'] = pd.to_datetime(df['timestamp'])\n",
+        "    df['value'] = pd.to_numeric(df['value'])\n",
+        "    print(df.dtypes)\n",
+        "    print(df.head())"
+      ]
+    }
+  ];
+}
+
+export {
+  getTimeSeriesNotebook
+};