@eodash/eodash 5.0.0-alpha.2.1 → 5.0.0-alpha.2.11

package/core/client/utils/eodashSTAC.js

@@ -0,0 +1,259 @@
+import { Collection, Item } from "stac-js";
+import { toAbsolute } from "stac-js/src/http.js";
+import {
+  extractLayerConfig,
+  extractRoles,
+  fetchStyle,
+  generateFeatures,
+  setMapProjFromCol,
+  uid,
+} from "./helpers";
+import { registerProjection } from "@/store/Actions";
+import {
+  createLayersFromDataAssets,
+  createLayersFromLinks,
+} from "./createLayers";
+import axios from "axios";
+
+export class EodashCollection {
+  #collectionUrl = "";
+
+  /** @type {import("stac-ts").StacCollection | undefined} */
+  #collectionStac;
+
+  /**
+   * @type {import("stac-ts").StacLink
+   *   | import("stac-ts").StacItem
+   *   | undefined}
+   */
+  selectedItem;
+
+  /** @param {string} collectionUrl */
+  constructor(collectionUrl) {
+    this.#collectionUrl = collectionUrl;
+  }
+
+  /**
+   * @async
+   * @param {import('stac-ts').StacLink | Date} [linkOrDate]
+   * @returns
+   */
+  createLayersJson = async (linkOrDate) => {
+    /**
+     * @type {import("stac-ts").StacLink | undefined}
+     **/
+    let stacItem;
+
+    /**
+     * @type {import("stac-ts").StacCollection | undefined}
+     **/
+    let stac;
+    // TODO get auxiliary layers from collection
+    /** @type {Record<string,any>[]} */
+    let layersJson = [];
+
+    // Load collectionstac if not yet initialized
+    if (!this.#collectionStac) {
+      stac = await axios.get(this.#collectionUrl).then((resp) => resp.data);
+      this.#collectionStac = new Collection(stac);
+    }
+
+    // set availabe map projection
+    setMapProjFromCol(this.#collectionStac);
+
+    const isGeoDB = stac?.endpointtype === "GeoDB";
+
+    if (linkOrDate instanceof Date) {
+      // if collectionStac not yet initialized we do it here
+      stacItem = this.getItem(linkOrDate);
+    } else {
+      stacItem = linkOrDate;
+    }
+
+    const stacItemUrl = stacItem
+      ? toAbsolute(stacItem.href, this.#collectionUrl)
+      : this.#collectionUrl;
+
+    stac = await axios.get(stacItemUrl).then((resp) => resp.data);
+
+    if (!stacItem) {
+      // no specific item was requested; render last item
+      this.#collectionStac = new Collection(stac);
+      this.selectedItem = this.getItem();
+
+      if (this.selectedItem) {
+        layersJson = /** @type {Record<string,any>[]} */ (
+          await this.createLayersJson(this.selectedItem)
+        );
+      } else {
+        console.warn(
+          "[eodash] the selected collection does not include any items",
+        );
+      }
+      return [];
+    } else {
+      // specific item was requested
+      const item = new Item(stac);
+      this.selectedItem = item;
+      const title = this.#collectionStac.title || this.#collectionStac.id;
+      layersJson.unshift(
+        ...(await this.buildJsonArray(item, stacItemUrl, title, isGeoDB)),
+      );
+      return layersJson;
+    }
+  };
+
+  /**
+   * @param {import("stac-ts").StacItem} item
+   * @param {string} itemUrl
+   * @param {string} title
+   * @param {boolean} isGeoDB
+   * @returns {Promise<Record<string,any>[]>} arrays
+   * */
+  async buildJsonArray(item, itemUrl, title, isGeoDB) {
+    await registerProjection(
+      /** @type {number | undefined} */ (item?.["proj:epsg"]),
+    );
+
+    const jsonArray = [];
+
+    if (isGeoDB) {
+      const allFeatures = generateFeatures(this.#collectionStac?.links);
+
+      return [
+        {
+          type: "Vector",
+          properties: {
+            id: item.id,
+            title: this.#collectionStac?.title || item.id,
+          },
+          source: {
+            type: "Vector",
+            url: "data:," + encodeURIComponent(JSON.stringify(allFeatures)),
+            format: "GeoJSON",
+          },
+          style: {
+            "circle-radius": 5,
+            "circle-fill-color": "#00417077",
+            "circle-stroke-color": "#004170",
+            "fill-color": "#00417077",
+            "stroke-color": "#004170",
+          },
+        },
+      ];
+    }
+
+    // I propose following approach, we "manually" create configurations
+    // for the rendering options we know and expect.
+    // If we don't find any we fallback to using the STAC ol item that
+    // will try to extract anything it supports but for which we have
+    // less control.
+
+    const { layerConfig, style } = extractLayerConfig(
+      await fetchStyle(item, itemUrl),
+    );
+
+    const dataAssets = Object.keys(item?.assets ?? {}).reduce((data, ast) => {
+      if (item.assets[ast].roles?.includes("data")) {
+        data[ast] = item.assets[ast];
+      }
+      return data;
+    }, /** @type {Record<string,import('stac-ts').StacAsset>} */ ({}));
+
+    const isSupported =
+      item.links.some((link) => ["wms", "xyz"].includes(link.rel)) ||
+      Object.keys(dataAssets).length;
+
+    if (isSupported) {
+      jsonArray.push(
+        ...createLayersFromLinks(uid(), title, item),
+
+        ...(await createLayersFromDataAssets(
+          uid(),
+          title || this.#collectionStac?.title || item.id,
+          dataAssets,
+          style,
+          layerConfig,
+        )),
+      );
+    } else {
+      // fallback to STAC
+      const json = {
+        type: "STAC",
+        displayWebMapLink: true,
+        displayFootprint: false,
+        data: item,
+        properties: {
+          id: item.id,
+          title: title || item.id,
+          layerConfig,
+        },
+        style,
+      };
+      extractRoles(json.properties, /** @type {string[]} */ (item?.roles));
+      jsonArray.push(json);
+    }
+
+    return jsonArray;
+  }
+
+  getItems() {
+    return (
+      this.#collectionStac?.links
+        .filter((i) => i.rel === "item")
+        // sort by `datetime`, where oldest is first in array
+        .sort((a, b) =>
+          /** @type {number} */ (a.datetime) <
+          /** @type {number} */ (b.datetime)
+            ? -1
+            : 1,
+        )
+    );
+  }
+
+  getDates() {
+    return (
+      this.#collectionStac?.links
+        .filter((i) => i.rel === "item")
+        // sort by `datetime`, where oldest is first in array
+        .sort((a, b) =>
+          /** @type {number} */ (a.datetime) <
+          /** @type {number} */ (b.datetime)
+            ? -1
+            : 1,
+        )
+        .map((i) => new Date(/** @type {number} */ (i.datetime)))
+    );
+  }
+
+  async getExtent() {
+    if (!this.#collectionStac) {
+      const stac = await axios
+        .get(this.#collectionUrl)
+        .then((resp) => resp.data);
+      this.#collectionStac = new Collection(stac);
+    }
+    return this.#collectionStac?.extent;
+  }
+
+  /**
+   * Get closest Item Link from a certain date,
+   * get the latest if no date provided
+   *  @param {Date} [date]
+   **/
+  getItem(date) {
+    return date
+      ? this.getItems()?.sort((a, b) => {
+          const distanceA = Math.abs(
+            new Date(/** @type {number} */ (a.datetime)).getTime() -
+              date.getTime(),
+          );
+          const distanceB = Math.abs(
+            new Date(/** @type {number} */ (b.datetime)).getTime() -
+              date.getTime(),
+          );
+          return distanceA - distanceB;
+        })[0]
+      : this.getItems()?.at(-1);
+  }
+}

package/core/client/utils/helpers.js

@@ -0,0 +1,152 @@
+import { changeMapProjection } from "@/store/Actions";
+import { availableMapProjection } from "@/store/States";
+import { toAbsolute } from "stac-js/src/http.js";
+import axios from "axios";
+
+/** @param {import("stac-ts").StacLink[]} [links] */
+export function generateFeatures(links) {
+  /**
+   * @type {{
+   *   type: string;
+   *   geometry: {
+   *     type: string;
+   *     coordinates: [number, number];
+   *   };
+   * }[]}
+   */
+  const features = [];
+  links?.forEach((element) => {
+    if (element.rel === "item" && "latlng" in element) {
+      const [lat, lon] = /** @type {string} */ (element.latlng)
+        .split(",")
+        .map((it) => Number(it));
+      features.push({
+        type: "Feature",
+        geometry: {
+          type: "Point",
+          coordinates: [lon, lat],
+        },
+      });
+    }
+  });
+  const geojsonObject = {
+    type: "FeatureCollection",
+    crs: {
+      type: "name",
+      properties: {
+        name: "EPSG:4326",
+      },
+    },
+    features,
+  };
+  return geojsonObject;
+}
+
+/** @param { import("ol/layer/WebGLTile").Style & { jsonform?: Record<string,any> } } [style] */
+export function extractLayerConfig(style) {
+  /** @type {Record<string,unknown> | undefined} */
+  let layerConfig = undefined;
+  if (style?.jsonform) {
+    layerConfig = { schema: style.jsonform, type: "style" };
+    delete style.jsonform;
+  }
+  return { layerConfig, style };
+}
+
+/**
+ * checks if there's a projection on the Collection and
+ * updates {@link availableMapProjection}
+ * @param {import('stac-ts').StacCollection} [STAcCollection]
+ */
+export const setMapProjFromCol = (STAcCollection) => {
+  // if a projection exists on the collection level
+  if (STAcCollection?.["proj:epsg"]) {
+    if (
+      availableMapProjection.value &&
+      availableMapProjection.value !== STAcCollection?.["proj:epsg"]
+    ) {
+      changeMapProjection(
+        /** @type {number} */
+        (STAcCollection["proj:epsg"]),
+      );
+    }
+    // set it for `EodashMapBtns`
+    availableMapProjection.value = /** @type {string} */ (
+      STAcCollection["proj:epsg"]
+    );
+  } else {
+    // reset to default projection
+    changeMapProjection((availableMapProjection.value = ""));
+  }
+};
+
+/**
+ * Function to extract collection urls from an indicator
+ * @param {import("stac-ts").StacCatalog
+ *   | import("stac-ts").StacCollection
+ *   | import("stac-ts").StacItem
+ *   | null
+ * } stacObject
+ * @param {string} basepath
+ * @returns {string[]}
+ */
+export function extractCollectionUrls(stacObject, basepath) {
+  const collectionUrls = [];
+  // Support for two structure types, flat and indicator, simplified here:
+  // Flat assumes Catalog-Collection-Item
+  // Indicator assumes Catalog-Collection-Collection-Item
+  // TODO: this is not the most stable test approach,
+  // we should discuss potential other approaches
+
+  if (stacObject?.links && stacObject?.links[1].rel === "item") {
+    collectionUrls.push(basepath);
+  } else if (stacObject?.links[1].rel === "child") {
+    // TODO: Iterate through all children to create collections
+    stacObject.links.forEach((link) => {
+      if (link.rel === "child") {
+        collectionUrls.push(toAbsolute(link.href, basepath));
+      }
+    });
+  }
+  return collectionUrls;
+}
+
+export const uid = () =>
+  Date.now().toString(36) + Math.random().toString(36).substring(2);
+
+/**
+ * Assign extracted roles to layer properties
+ * @param {Record<string,any>} properties
+ * @param {string[]} roles
+ * */
+export const extractRoles = (properties, roles) => {
+  roles?.forEach((role) => {
+    if (role === "visible") {
+      properties.visible = true;
+    }
+    if (role === "overlay" || role === "baselayer") {
+      properties.group = role;
+    }
+    return properties;
+  });
+};
+
+/**
+ * @param {import("stac-ts").StacItem} item
+ * @param {string} itemUrl
+ **/
+export const fetchStyle = async (item, itemUrl) => {
+  const styleLink = item.links.find((link) => link.rel.includes("style"));
+  if (styleLink) {
+    let url = "";
+    if (styleLink.href.startsWith("http")) {
+      url = styleLink.href;
+    } else {
+      url = toAbsolute(styleLink.href, itemUrl);
+    }
+
+    /** @type {import("ol/layer/WebGLTile").Style & {jsonform?:Record<string,any>}} */
+    const styleJson = await axios.get(url).then((resp) => resp.data);
+    return styleJson;
+  }
+};

package/core/client/utils/index.js

@@ -0,0 +1,51 @@
+/**
+ * Loads font in the app using `webfontloader`
+ *
+ * @param {string} [family]
+ * @param {string} [link]
+ * @param {boolean} [isWebComponent]
+ * @returns {Promise<string>} - Font family name
+ * @see {@link "https://github.com/typekit/webfontloader"}
+ */
+export const loadFont = async (
+  family = "",
+  link = "",
+  isWebComponent = false,
+) => {
+  if (family && link) {
+    const WebFontLoader = (await import("webfontloader")).default;
+    WebFontLoader.load({
+      classes: false,
+      custom: {
+        // Use FVD notation to include families https://github.com/typekit/fvd
+        families: [family],
+        // Path to stylesheet that defines font-face
+        urls: [link],
+      },
+      fontactive(familyName, _fvd) {
+        const stylesheet = new CSSStyleSheet();
+        const styles = isWebComponent
+          ? `eo-dash {font-family: ${familyName};}`
+          : `* {font-family: ${familyName};}`;
+        stylesheet.replaceSync(styles);
+        document.adoptedStyleSheets.push(stylesheet);
+      },
+      fontinactive(familyName, _fvd) {
+        throw new Error(`error loading font: ${familyName}`);
+      },
+    });
+  }
+  return family;
+};
+
+/**
+ *  @param {string} text
+ *  @param {import("vue").Ref<boolean>} showIcon
+ **/
+export const copyToClipBoard = async (text, showIcon) => {
+  await navigator.clipboard.writeText(text);
+  showIcon.value = true;
+  setTimeout(() => {
+    showIcon.value = false;
+  }, 2000);
+};

package/core/{utils → client/utils}/keys.js

@@ -1,6 +1,6 @@
 /**
- *  `eodash` injection key.
- * @type {Symbol}
+ * `eodash` injection key.
+ *
  * @see {@link "@/plugins/index.js"}
  */
 export const eodashKey = Symbol("eodash");

package/core/client/views/Dashboard.vue

@@ -0,0 +1,116 @@
+<template>
+  <HeaderComponent ref="headerRef" v-if="!eodash.brand.noLayout" />
+  <ErrorAlert v-model="error" />
+  <Suspense>
+    <TemplateComponent
+      @vue:mounted="onTemplateMount?.(hiddenElements)"
+      class="template"
+    />
+    <template #fallback>
+      <div class="loading-container">
+        <Loading />
+      </div>
+    </template>
+  </Suspense>
+  <FooterComponent ref="footerRef" v-if="!eodash.brand.noLayout" />
+</template>
+
+<script setup>
+import { useEodashRuntime } from "@/composables/DefineEodash";
+import { useURLSearchParametersSync, useUpdateTheme } from "@/composables";
+import { useSTAcStore } from "@/store/stac";
+import { defineAsyncComponent, onErrorCaptured, onMounted, ref } from "vue";
+import { useDisplay, useLayout } from "vuetify/lib/framework.mjs";
+import { loadFont } from "@/utils";
+import Loading from "@/components/Loading.vue";
+import ErrorAlert from "@/components/ErrorAlert.vue";
+
+const props = defineProps({
+  config: {
+    type: String,
+  },
+  onTemplateMount: {
+    type: Function,
+  },
+});
+const eodash = await useEodashRuntime(props.config);
+
+useURLSearchParametersSync();
+
+const theme = useUpdateTheme("dashboardTheme", eodash.brand?.theme);
+theme.global.name.value = "dashboardTheme";
+
+await loadFont(
+  eodash.brand?.font?.family,
+  eodash.brand?.font?.link,
+  !!props.onTemplateMount,
+);
+
+const { loadSTAC } = useSTAcStore();
+await loadSTAC();
+
+const { smAndDown } = useDisplay();
+const TemplateComponent = smAndDown.value
+  ? defineAsyncComponent(() => import(`@/components/MobileLayout.vue`))
+  : defineAsyncComponent(() => import(`@/components/DashboardLayout.vue`));
+
+const HeaderComponent = defineAsyncComponent(
+  () => import(`@/components/Header.vue`),
+);
+const FooterComponent = defineAsyncComponent(
+  () => import(`@/components/Footer.vue`),
+);
+const { mainRect } = useLayout();
+const templateHeight = eodash.brand.noLayout
+  ? props.onTemplateMount
+    ? "100%"
+    : "90dvh"
+  : `calc(100dvh - ${mainRect.value["top"] + mainRect.value["bottom"]}px)`;
+
+const headerRef = ref(null);
+/**
+ * @type {import("vue").Ref<InstanceType<
+ *   typeof import("@/components/Footer.vue").default
+ * > | null>}
+ */
+const footerRef = ref(null);
+
+const hiddenElements = [headerRef, footerRef];
+
+onMounted(() => {
+  if (props.onTemplateMount && !eodash.brand.noLayout) {
+    hiddenElements.forEach((element) => {
+      /** @type {HTMLElement} */
+      (
+        /** @type {import("vue").ComponentPublicInstance} */
+        (element.value).$el
+      ).style.opacity = "0";
+    });
+  }
+});
+
+const error = ref("");
+onErrorCaptured((e, comp, info) => {
+  error.value = `
+  ${e}.
+  component: ${comp?.$.type.name}.
+  info: ${info}.
+  `;
+});
+</script>
+<style>
+html {
+  overflow: hidden !important;
+}
+
+.template {
+  height: v-bind("templateHeight");
+}
+
+.loading-container {
+  height: 100dvh;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+</style>

package/core/client/vite-env.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="vite/client" />
+
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+  const component: DefineComponent<object, object, unknown>;
+  export default component;
+}
+declare interface Window {
+  eodashStore: import("@/types").EodashStore;
+}
+declare module "@eox/stacinfo" {
+  export const EOxStacInfo: CustomElementConstructor;
+}
+declare module "@eox/layercontrol" {
+  export const EOxLayerControl: CustomElementConstructor;
+}
+declare module "@eox/jsonform" {
+  export const EOxJSONForm: CustomElementConstructor;
+}
+declare module "@eox/map" {
+  export const EOxMap: CustomElementConstructor;
+}
+declare module "@eox/itemfilter" {
+  export const EOxItemFilter: CustomElementConstructor;
+}
+declare module "user:config" {
+  const eodash: import("@/types").Eodash | Promise<import("@/types").Eodash>;
+  export default eodash;
+}
+declare module "stac-js" {
+  export const Collection: {
+    new (data?: object): import("stac-ts").StacCollection;
+  };
+  export const Item: { new (data?: object): import("stac-ts").StacItem };
+}
+declare module "stac-js/src/http.js" {
+  const toAbsolute: (...args: string[]) => string;
+  export { toAbsolute };
+}