= ({
24 | contribution,
25 | panelIndex,
26 | }) => {
27 | const componentStateResult = contribution.componentResult;
28 | if (componentStateResult.status === "pending") {
29 | return ;
30 | } else if (componentStateResult.error) {
31 | return (
32 |
33 |
34 | {componentStateResult.error.message}
35 |
36 |
37 | );
38 | } else if (contribution.component) {
39 | return (
40 | {
44 | handleComponentChange("panels", panelIndex, event);
45 | }}
46 | />
47 | );
48 | }
49 | return null;
50 | };
51 |
52 | export default ContributedPanel;
53 |
--------------------------------------------------------------------------------
/src/ext/config.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | // export const loggingEnabled = import.meta.env.DEV;
8 | export const loggingEnabled = false;
9 |
--------------------------------------------------------------------------------
/src/ext/plugin.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { ComponentType } from "react";
8 | import type { Plugin, ComponentProps } from "chartlets";
9 |
10 | import Markdown from "@/components/Markdown";
11 |
12 | export default function xc_viewer(): Plugin {
13 | return {
14 | // TODO: the following type cast is not acceptable, but there is
15 | // no reason why component props must implement ComponentProps
16 | // from chartlets. This need to be fixed in chartlets!
17 | components: [["Markdown", Markdown as ComponentType]],
18 | };
19 | }
20 |
--------------------------------------------------------------------------------
/src/hooks/useFetchText.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { useEffect, useState } from "react";
8 |
9 | export default function useFetchText(markdownUrl: string | null | undefined) {
10 | const [markdownText, setMarkdownText] = useState();
11 |
12 | useEffect(() => {
13 | if (!markdownUrl) {
14 | setMarkdownText(undefined);
15 | } else {
16 | fetch(markdownUrl)
17 | .then((response) => response.text())
18 | .then((text) => setMarkdownText(text))
19 | .catch((error) => {
20 | console.error(error);
21 | });
22 | }
23 | }, [markdownUrl]);
24 |
25 | return markdownText;
26 | }
27 |
--------------------------------------------------------------------------------
/src/hooks/usePromise.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { useEffect, useState } from "react";
8 |
9 | export interface PromiseState {
10 | pending?: boolean;
11 | error?: unknown;
12 | value?: T;
13 | }
14 |
15 | export default function usePromise(promise: Promise): PromiseState {
16 | const [state, setState] = useState>({});
17 | useEffect(() => {
18 | setState({ pending: true });
19 | promise
20 | .then((value) => {
21 | setState({ value });
22 | })
23 | .catch((error) => {
24 | setState({ error });
25 | });
26 | }, [promise]);
27 | return state;
28 | }
29 |
--------------------------------------------------------------------------------
/src/hooks/useResizeObserver.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { type MutableRefObject, useEffect, useRef } from "react";
8 |
9 | export type Size = { width: number; height: number };
10 |
11 | export default function useResizeObserver(
12 | callback: (size: Size) => void,
13 | ref?: MutableRefObject,
14 | ): void {
15 | const sizeRef = useRef();
16 |
17 | useEffect(() => {
18 | if (ref && !ref.current) {
19 | return;
20 | }
21 |
22 | const observer = new ResizeObserver((entries) => {
23 | for (const entry of entries) {
24 | if (entry.contentRect) {
25 | const width = entry.contentRect.width;
26 | const height = entry.contentRect.height;
27 | const prevSize = sizeRef.current;
28 | if (
29 | !prevSize ||
30 | prevSize.width !== width ||
31 | prevSize.height !== height
32 | ) {
33 | const size = {
34 | width: width,
35 | height: height,
36 | };
37 | sizeRef.current = size;
38 | if (prevSize) {
39 | callback(size);
40 | }
41 | }
42 | }
43 | }
44 | });
45 |
46 | observer.observe(ref ? ref.current! : document.documentElement);
47 |
48 | return () => observer.disconnect();
49 | }, [callback, ref]);
50 | }
51 |
--------------------------------------------------------------------------------
/src/hooks/useUndo.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { useEffect, useRef } from "react";
8 |
9 | type Undo = () => void;
10 | type UndoSetter = (undo: Undo | undefined) => void;
11 |
12 | export default function useUndo(): [Undo, UndoSetter] {
13 | const undoRef = useRef();
14 | const undo = useRef(() => {
15 | if (undoRef.current) {
16 | undoRef.current();
17 | undoRef.current = undefined;
18 | }
19 | });
20 | const setUndo = useRef((undo: Undo | undefined) => {
21 | undoRef.current = undo;
22 | });
23 | useEffect(() => undo.current, []);
24 | return [undo.current, setUndo.current];
25 | }
26 |
--------------------------------------------------------------------------------
/src/i18n.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { getCurrentLocale, LanguageDictionary } from "@/util/lang";
8 | import lang from "@/resources/lang.json";
9 |
10 | const i18n = new LanguageDictionary(lang);
11 | i18n.locale = getCurrentLocale();
12 |
13 | export default i18n;
14 |
--------------------------------------------------------------------------------
/src/index.css:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | body {
8 | margin: 0;
9 | padding: 0;
10 | width: 100vw;
11 | height: 100vh;
12 | overflow: hidden;
13 | font-family: "Roboto", "Segoe UI", "sans-serif";
14 | }
15 |
--------------------------------------------------------------------------------
/src/model/apiServer.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export interface ApiServerConfig {
8 | id: string;
9 | name: string;
10 | url: string;
11 | }
12 |
13 | export interface ApiServerInfo {
14 | name: string;
15 | description: string;
16 | version: string;
17 | configTime: string;
18 | serverTime: string;
19 | }
20 |
--------------------------------------------------------------------------------
/src/model/bg.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/xcube-dev/xcube-viewer/087b8c6d26b332b49dc148da4c1a67a1cc9b279c/src/model/bg.png
--------------------------------------------------------------------------------
/src/model/encode.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { Dataset } from "@/model/dataset";
8 | import { Variable } from "@/model/variable";
9 | import { isUserVariable } from "@/model/userVariable";
10 | import { isString } from "@/util/types";
11 |
12 | export function encodeDatasetId(dataset: Dataset | string): string {
13 | return encodeURIComponent(isString(dataset) ? dataset : dataset.id);
14 | }
15 |
16 | export function encodeVariableName(variable: Variable | string): string {
17 | return encodeURIComponent(
18 | isString(variable)
19 | ? variable
20 | : isUserVariable(variable)
21 | ? `${variable.name}=${variable.expression}`
22 | : variable.name,
23 | );
24 | }
25 |
--------------------------------------------------------------------------------
/src/model/layerState.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export interface LayerState {
8 | id: string;
9 | type?: string;
10 | title: string;
11 | subTitle?: string;
12 | disabled?: boolean;
13 | visible?: boolean;
14 | pinned?: boolean;
15 | exclusive?: boolean;
16 | }
17 |
--------------------------------------------------------------------------------
/src/model/proj.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export const GEOGRAPHIC_CRS = "EPSG:4326";
8 | export const WEB_MERCATOR_CRS = "EPSG:3857";
9 |
10 | export const DEFAULT_MAP_CRS = WEB_MERCATOR_CRS;
11 |
--------------------------------------------------------------------------------
/src/model/statistics.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { Dataset } from "./dataset";
8 | import { Variable } from "./variable";
9 | import { PlaceInfo } from "./place";
10 |
11 | export interface StatisticsSource {
12 | dataset: Dataset;
13 | variable: Variable;
14 | time: string | null;
15 | placeInfo: PlaceInfo;
16 | }
17 |
18 | export interface Histogram {
19 | values: number[];
20 | edges: number[];
21 | }
22 |
23 | export interface NullStatistics {
24 | count: 0;
25 | }
26 |
27 | export interface AreaStatistics {
28 | count: number;
29 | minimum: number;
30 | maximum: number;
31 | mean: number;
32 | deviation: number;
33 | histogram: Histogram;
34 | }
35 |
36 | export interface PointStatistics extends Omit {
37 | count: 1;
38 | }
39 |
40 | export type Statistics = NullStatistics | PointStatistics | AreaStatistics;
41 |
42 | export interface StatisticsRecord {
43 | source: StatisticsSource;
44 | statistics: Statistics;
45 | }
46 |
47 | export function isNullStatistics(s: Statistics): s is NullStatistics {
48 | return s.count === 0;
49 | }
50 |
51 | export function isPointStatistics(s: Statistics): s is PointStatistics {
52 | return s.count === 1;
53 | }
54 |
55 | export function isAreaStatistics(s: Statistics): s is AreaStatistics {
56 | return s.count > 1;
57 | }
58 |
--------------------------------------------------------------------------------
/src/model/user-place/common.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export interface Format {
8 | name: string;
9 | fileExt: string;
10 | checkError: (text: string) => string | null;
11 | }
12 |
13 | const WKT_GEOM_NAMES = [
14 | "Point",
15 | "LineString",
16 | "Polygon",
17 | "MultiPoint",
18 | "MultiLineString",
19 | "MultiPolygon",
20 | "GeometryCollection",
21 | ].map((k) => k.toLowerCase());
22 |
23 | export function detectFormatName(text: string): "csv" | "geojson" | "wkt" {
24 | text = text.trim();
25 | if (text === "") {
26 | return "csv";
27 | }
28 |
29 | if (text[0] === "{") {
30 | return "geojson";
31 | }
32 |
33 | const marker = text.substring(0, 20).toLowerCase();
34 | const geomName = WKT_GEOM_NAMES.find(
35 | (geomName) =>
36 | marker.startsWith(geomName) &&
37 | (marker.length === geomName.length ||
38 | "\n\t (".indexOf(marker[geomName.length]) >= 0),
39 | );
40 | if (geomName) {
41 | return "wkt";
42 | }
43 |
44 | return "csv";
45 | }
46 |
47 | /**
48 | * Helper function that splits a comma-separated string into lower-case
49 | * name tokens.
50 | *
51 | * @param alternatives
52 | */
53 | export function parseAlternativeNames(alternatives: string): string[] {
54 | return alternatives
55 | .split(",")
56 | .map((s) => s.trim().toLowerCase())
57 | .filter((name) => name !== "");
58 | }
59 |
--------------------------------------------------------------------------------
/src/model/userVariable.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { Variable } from "./variable";
8 | import { isString } from "@/util/types";
9 |
10 | export interface ExpressionCapabilities {
11 | namespace: {
12 | constants: string[];
13 | arrayFunctions: string[];
14 | otherFunctions: string[];
15 | arrayOperators: string[];
16 | otherOperators: string[];
17 | };
18 | }
19 |
20 | export interface UserVariable extends Variable {
21 | expression: string;
22 | }
23 |
24 | export function isUserVariable(variable: Variable): variable is UserVariable {
25 | return isString(variable.expression);
26 | }
27 |
--------------------------------------------------------------------------------
/src/model/variable.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { type VolumeRenderMode } from "@/states/controlState";
8 | import { type JsonPrimitive } from "@/util/json";
9 |
10 | export type ColorBarNorm = "lin" | "log";
11 |
12 | export interface Variable {
13 | id: string;
14 | name: string;
15 | dims: string[];
16 | shape: number[];
17 | dtype: string;
18 | units: string;
19 | title: string;
20 | description?: string;
21 | expression?: string; // user-defined variables only
22 | timeChunkSize: number | null;
23 | // The following are new since xcube 0.11
24 | tileLevelMin?: number;
25 | tileLevelMax?: number;
26 | // colorBarName may be prefixed by "_alpha" and/or "_r" (reversed)
27 | colorBarName: string;
28 | colorBarMin: number;
29 | colorBarMax: number;
30 | colorBarNorm?: ColorBarNorm;
31 | opacity?: number;
32 | volumeRenderMode?: VolumeRenderMode;
33 | volumeIsoThreshold?: number;
34 | htmlRepr?: string;
35 | attrs: Record;
36 | }
37 |
--------------------------------------------------------------------------------
/src/reducers/appReducer.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { AppState } from "@/states/appState";
8 | import { ChangeLocale, ControlAction } from "@/actions/controlActions";
9 | import { DataAction } from "@/actions/dataActions";
10 | import { MessageLogAction } from "@/actions/messageLogActions";
11 | import { UserAuthAction } from "@/actions/userAuthActions";
12 | import { controlReducer } from "./controlReducer";
13 | import { dataReducer } from "./dataReducer";
14 | import { messageLogReducer } from "./messageLogReducer";
15 | import { userAuthReducer } from "./userAuthReducer";
16 |
17 | export function appReducer(
18 | state: AppState | undefined,
19 | action: DataAction &
20 | ControlAction &
21 | MessageLogAction &
22 | UserAuthAction &
23 | ChangeLocale,
24 | ): AppState {
25 | // Not using redux.combineReducers(), because we need to pass app state into controlReducer()
26 | return {
27 | dataState: dataReducer(state && state.dataState, action),
28 | controlState: controlReducer(state && state.controlState, action, state),
29 | messageLogState: messageLogReducer(state && state.messageLogState, action),
30 | userAuthState: userAuthReducer(state && state.userAuthState, action),
31 | };
32 | }
33 |
--------------------------------------------------------------------------------
/src/reducers/userAuthReducer.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { UPDATE_ACCESS_TOKEN, UserAuthAction } from "@/actions/userAuthActions";
8 | import { newUserAuthState, UserAuthState } from "@/states/userAuthState";
9 |
10 | export function userAuthReducer(
11 | state: UserAuthState | undefined,
12 | action: UserAuthAction,
13 | ): UserAuthState {
14 | if (state === undefined) {
15 | state = newUserAuthState();
16 | }
17 | switch (action.type) {
18 | case UPDATE_ACCESS_TOKEN:
19 | return {
20 | ...state,
21 | accessToken: action.accessToken,
22 | };
23 | }
24 | return state!;
25 | }
26 |
--------------------------------------------------------------------------------
/src/resources/config.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "default",
3 | "server": {
4 | "id": "local",
5 | "name": "Local Server",
6 | "url": "http://localhost:8080"
7 | },
8 | "branding": {
9 | "appBarTitle": "xcube Viewer",
10 | "windowTitle": "xcube Viewer",
11 | "headerBackgroundColor": "#606060",
12 | "themeMode": "system",
13 | "compact": false,
14 | "organisationUrl": "https://xcube.readthedocs.io/",
15 | "logoImage": "images/logo.png",
16 | "logoWidth": 32,
17 | "headerTitleStyle": {
18 | "fontFamily": "Arial",
19 | "fontStyle": "italic",
20 | "fontSize": "1.2rem"
21 | },
22 | "baseMapUrl": "https://services.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}",
23 | "defaultAgg": "mean",
24 | "polygonFillOpacity": 0.2,
25 | "mapProjection": "EPSG:3857",
26 | "allowDownloads": true,
27 | "allowRefresh": true,
28 | "allowSharing": true,
29 | "allowUserVariables": true,
30 | "allowViewModePython": true,
31 | "allow3D": true
32 | }
33 | }
34 |
--------------------------------------------------------------------------------
/src/resources/python-bw.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/xcube-dev/xcube-viewer/087b8c6d26b332b49dc148da4c1a67a1cc9b279c/src/resources/python-bw.png
--------------------------------------------------------------------------------
/src/resources/python.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/xcube-dev/xcube-viewer/087b8c6d26b332b49dc148da4c1a67a1cc9b279c/src/resources/python.png
--------------------------------------------------------------------------------
/src/resources/spectral-indexes.txt:
--------------------------------------------------------------------------------
1 | # Frequently used Sentinel-2 indexes
2 | moisture_index = where((SCL >= 2) & (SCL <= 7), (B08 - B11) / (B08 + B11), nan)
3 | vegetation_index = where(SCL == 6, (B08 - B04) / (B08 + B04), nan)
4 | chlorophyll_index = where(SCL == 6, (B05 - B04) - 0.52 * (B06 - B04), nan)
5 |
--------------------------------------------------------------------------------
/src/selectors/controlSelectors.test.tsx:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { describe, expect, it } from "vitest";
8 | import { Dataset } from "@/model/dataset";
9 | import { Variable } from "@/model/variable";
10 | import { getTileUrl } from "./controlSelectors";
11 |
12 | describe("Assert that controlSelectors.getTileUrl()", () => {
13 | it("works for RGB", () => {
14 | const dataset = { id: "demo" } as Dataset;
15 | expect(getTileUrl("https://xcube.com/api", dataset, "rgb")).toEqual(
16 | "https://xcube.com/api/tiles/demo/rgb/{z}/{y}/{x}",
17 | );
18 | });
19 |
20 | it("works for normal variables", () => {
21 | const dataset = { id: "demo" } as Dataset;
22 | const variable = { name: "conc_chl" } as Variable;
23 | expect(getTileUrl("https://xcube.com/api", dataset, variable)).toEqual(
24 | "https://xcube.com/api/tiles/demo/conc_chl/{z}/{y}/{x}",
25 | );
26 | });
27 |
28 | it("works for user variables", () => {
29 | const dataset = { id: "demo" } as Dataset;
30 | const variable = {
31 | name: "ndvi",
32 | expression: "(B08 - B04) / (B08 + B04)",
33 | } as Variable;
34 | expect(getTileUrl("https://xcube.com/api", dataset, variable)).toEqual(
35 | "https://xcube.com/api/tiles/demo/ndvi%3D(B08%20-%20B04)%20%2F%20(B08%20%2B%20B04)/{z}/{y}/{x}",
36 | );
37 | });
38 | });
39 |
--------------------------------------------------------------------------------
/src/setupTests.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | // jest-dom adds custom jest matchers for asserting on DOM nodes.
8 | // allows you to do things like:
9 | // expect(element).toHaveTextContent(/react/i)
10 | // learn more: https://github.com/testing-library/jest-dom
11 |
12 | import "@testing-library/jest-dom/vitest";
13 |
--------------------------------------------------------------------------------
/src/states/appState.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { MessageLogState } from "./messageLogState";
8 | import { DataState } from "./dataState";
9 | import { ControlState } from "./controlState";
10 | import { UserAuthState } from "./userAuthState";
11 |
12 | export interface AppState {
13 | dataState: DataState;
14 | controlState: ControlState;
15 | messageLogState: MessageLogState;
16 | userAuthState: UserAuthState;
17 | }
18 |
--------------------------------------------------------------------------------
/src/states/messageLogState.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export type MessageType = "error" | "warning" | "info" | "success";
8 |
9 | export interface MessageLogEntry {
10 | id: number;
11 | type: MessageType;
12 | text: string;
13 | }
14 |
15 | export interface MessageLogState {
16 | newEntries: MessageLogEntry[];
17 | oldEntries: MessageLogEntry[];
18 | }
19 |
20 | export function newMessageLogState() {
21 | return {
22 | newEntries: [],
23 | oldEntries: [],
24 | };
25 | }
26 |
--------------------------------------------------------------------------------
/src/states/userAuthState.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export interface UserAuthState {
8 | accessToken: string | null;
9 | }
10 |
11 | export function newUserAuthState(): UserAuthState {
12 | return {
13 | accessToken: null,
14 | };
15 | }
16 |
--------------------------------------------------------------------------------
/src/theme.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { createTheme, type Theme } from "@mui/material";
8 |
9 | const baseTheme = {
10 | typography: {
11 | fontSize: 12,
12 | },
13 | };
14 |
15 | export const lightTheme: Theme = createTheme({
16 | ...baseTheme,
17 | palette: {
18 | mode: "light",
19 | primary: { main: "#1976d2" },
20 | secondary: { main: "#00bc4e" },
21 | background: { default: "#ffffff" },
22 | },
23 | });
24 |
25 | export const darkTheme: Theme = createTheme({
26 | ...baseTheme,
27 | palette: {
28 | mode: "dark",
29 | primary: { main: "#39a6f2" },
30 | secondary: { main: "#20dc6e" },
31 | background: { default: "#2b2d30" },
32 | },
33 | });
34 |
--------------------------------------------------------------------------------
/src/util/assert.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export class DeveloperError extends Error {}
8 |
9 | export function assertTrue(condition: unknown, message: string) {
10 | if (!condition) {
11 | throw new DeveloperError(`assertion failed: ${message}`);
12 | }
13 | }
14 |
15 | export function assertNotNull(object: unknown, objectName: string) {
16 | if (object === null) {
17 | throw new DeveloperError(
18 | `assertion failed: ${objectName} must not be null`,
19 | );
20 | }
21 | }
22 |
23 | export function assertDefined(object: unknown, objectName: string) {
24 | if (typeof object === "undefined") {
25 | throw new DeveloperError(
26 | `assertion failed: ${objectName} must not be undefined`,
27 | );
28 | }
29 | }
30 |
31 | export function assertDefinedAndNotNull(object: unknown, objectName: string) {
32 | assertNotNull(object, objectName);
33 | assertDefined(object, objectName);
34 | }
35 |
36 | export function assertArray(array: unknown, arrayName: string) {
37 | if (!Array.isArray(array)) {
38 | throw new DeveloperError(`assertion failed: ${arrayName} must be an array`);
39 | }
40 | }
41 |
42 | export function assertArrayNotEmpty(array: unknown, arrayName: string) {
43 | if (Array.isArray(array)) {
44 | if (array.length === 0) {
45 | throw new DeveloperError(
46 | `assertion failed: ${arrayName} must be a non-empty array`,
47 | );
48 | }
49 | } else {
50 | throw new DeveloperError(`assertion failed: ${arrayName} must be an array`);
51 | }
52 | }
53 |
--------------------------------------------------------------------------------
/src/util/auth.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { UserManagerSettings } from "oidc-client-ts";
8 |
9 | export type AuthClientConfig = UserManagerSettings;
10 |
--------------------------------------------------------------------------------
/src/util/baseurl.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | function _getBaseUrl(): URL {
8 | const url = new URL(window.location.href);
9 | const pathComponents = url.pathname.split("/");
10 | const numPathComponents = pathComponents.length;
11 | if (numPathComponents > 0) {
12 | const lastComponent = pathComponents[numPathComponents - 1];
13 | if (lastComponent === "index.html") {
14 | return new URL(
15 | pathComponents.slice(0, numPathComponents - 1).join("/"),
16 | window.location.origin,
17 | );
18 | } else {
19 | return new URL(url.pathname, window.location.origin);
20 | }
21 | }
22 | return new URL(window.location.origin);
23 | }
24 |
25 | const baseUrl = _getBaseUrl();
26 |
27 | export default baseUrl;
28 |
--------------------------------------------------------------------------------
/src/util/find.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | /**
8 | * Find index into `array` so that `array[index]` is closest to `value`.
9 | * Uses a bi-section algorithm, so it should perform according to O(log2(N)).
10 | *
11 | * @param {number[]} array of monotonically increasing values
12 | * @param {number} value some value to find the index for
13 | * @returns {number} the integer index or -1 if the array is empty
14 | */
15 | export function findIndexCloseTo(array: number[], value: number): number {
16 | const n = array.length;
17 | if (n === 0) {
18 | return -1;
19 | }
20 | if (n === 1) {
21 | return 0;
22 | }
23 | let i1 = 0,
24 | i3 = n - 1;
25 | if (value <= array[i1]) {
26 | return i1;
27 | }
28 | if (value >= array[i3]) {
29 | return i3;
30 | }
31 | let i2 = Math.floor(n / 2),
32 | otherValue;
33 | for (let i = 0; i < n; i++) {
34 | otherValue = array[i2];
35 | if (value < otherValue) {
36 | [i2, i3] = [Math.floor((i1 + i2) / 2), i2];
37 | } else if (value > otherValue) {
38 | [i1, i2] = [i2, Math.floor((i2 + i3) / 2)];
39 | } else {
40 | return i2;
41 | }
42 | if (i1 === i2 || i2 === i3) {
43 | return Math.abs(array[i1] - value) <= Math.abs(array[i3] - value)
44 | ? i1
45 | : i3;
46 | }
47 | }
48 | return -1;
49 | }
50 |
--------------------------------------------------------------------------------
/src/util/history.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { Action, createBrowserHistory, Location } from "history";
8 |
9 | const history = createBrowserHistory();
10 |
11 | if (import.meta.env.DEV) {
12 | history.listen((location: Location, action: Action) => {
13 | if (import.meta.env.DEV) {
14 | console.debug(`history ${action}:`, location);
15 | }
16 | });
17 | }
18 |
19 | export default history;
20 |
--------------------------------------------------------------------------------
/src/util/id.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export function newId(prefix?: string): string {
8 | return (prefix || "") + Math.random().toString(16).substring(2);
9 | }
10 |
--------------------------------------------------------------------------------
/src/util/identifier.test.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { expect, it, describe } from "vitest";
8 | import { isIdentifier, getIdentifiers } from "./identifier";
9 |
10 | describe("Assert that identifier.isIdentifier()", () => {
11 | it("returns true for identifiers", () => {
12 | expect(isIdentifier("test9")).toEqual(true);
13 | expect(isIdentifier("value")).toEqual(true);
14 | expect(isIdentifier("value_min")).toEqual(true);
15 | });
16 |
17 | it("returns false for non-identifiers", () => {
18 | expect(isIdentifier("")).toEqual(false);
19 | expect(isIdentifier("2.4")).toEqual(false);
20 | expect(isIdentifier("9test")).toEqual(false);
21 | expect(isIdentifier("+test")).toEqual(false);
22 | expect(isIdentifier("value-min")).toEqual(false);
23 | });
24 | });
25 |
26 | describe("Assert that identifier.getIdentifiers()", () => {
27 | it("works", () => {
28 | expect(getIdentifiers("")).toEqual(new Set());
29 | expect(getIdentifiers("B07")).toEqual(new Set(["B07"]));
30 | expect(getIdentifiers("(B04 - B05) / (max(B06, B07) + B05)")).toEqual(
31 | new Set(["B04", "B05", "B06", "B07", "max"]),
32 | );
33 | });
34 | });
35 |
--------------------------------------------------------------------------------
/src/util/identifier.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | const reIdentifier = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
8 | const reVariables = /[a-zA-Z_$][a-zA-Z0-9_$]*/g;
9 |
10 | const emptySet = new Set();
11 |
12 | export function isIdentifier(value: string): boolean {
13 | return reIdentifier.test(value);
14 | }
15 |
16 | export function getIdentifiers(expression: string): Set {
17 | const matches = expression.match(reVariables);
18 | return matches !== null ? new Set(matches) : emptySet;
19 | }
20 |
--------------------------------------------------------------------------------
/src/util/json.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export type JsonPrimitive = null | boolean | number | string;
8 | export type JsonArray = JsonValue[];
9 | export type JsonObject = { [key: string]: JsonValue };
10 | export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
11 |
--------------------------------------------------------------------------------
/src/util/maps.test.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { expect, it, describe } from "vitest";
8 | import { maps } from "./maps";
9 |
10 | describe("maps", () => {
11 | it("can load maps", () => {
12 | expect(maps).toBeInstanceOf(Array);
13 | expect(maps.length).toBeGreaterThan(0);
14 | });
15 | });
16 |
--------------------------------------------------------------------------------
/src/util/maps.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | // Thanks to alexurquhart, maps.json is content of
8 | // https://github.com/alexurquhart/free-tiles/blob/master/tiles.json.
9 | // Check http://alexurquhart.github.io/free-tiles/.
10 | import _maps from "@/resources/maps.json";
11 |
12 | export const maps = _maps as MapGroup[];
13 |
14 | export interface MapGroup {
15 | name: string;
16 | link: string;
17 | baseMaps: MapSource[];
18 | overlays: MapSource[];
19 | }
20 |
21 | export interface MapSource {
22 | name: string;
23 | endpoint: string;
24 | }
25 |
--------------------------------------------------------------------------------
/src/util/path.test.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { expect, it, describe } from "vitest";
8 | import { buildPath } from "./path";
9 |
10 | describe("buildPath", () => {
11 | it("works", () => {
12 | expect(buildPath("")).toEqual("");
13 | expect(buildPath("p1")).toEqual("p1");
14 | expect(buildPath("p1", "p2", "")).toEqual("p1/p2");
15 | expect(buildPath("p1", "", "p2")).toEqual("p1/p2");
16 | expect(buildPath("p1", "", "", "p2")).toEqual("p1/p2");
17 | expect(buildPath("", "p1", "p2")).toEqual("/p1/p2");
18 | });
19 | it("works with separators", () => {
20 | expect(buildPath("p1/")).toEqual("p1/");
21 | expect(buildPath("p1/", "p2")).toEqual("p1/p2");
22 | expect(buildPath("p1/", "/p2")).toEqual("p1/p2");
23 | expect(buildPath("p1", "/p2")).toEqual("p1/p2");
24 | expect(buildPath("/p1/")).toEqual("/p1/");
25 | expect(buildPath("/p1/", "p2")).toEqual("/p1/p2");
26 | expect(buildPath("/p1/", "/p2")).toEqual("/p1/p2");
27 | expect(buildPath("/p1", "/p2")).toEqual("/p1/p2");
28 | expect(buildPath("p1/", "p2/")).toEqual("p1/p2/");
29 | expect(buildPath("p1/", "/p2/")).toEqual("p1/p2/");
30 | expect(buildPath("p1", "/p2/")).toEqual("p1/p2/");
31 | });
32 | });
33 |
--------------------------------------------------------------------------------
/src/util/path.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | /**
8 | * Builds a path by concatenating a base path and subsequent path components.
9 | * The function ensures that only single path separators are used between
10 | * path components.
11 | *
12 | * @param base
13 | * @param components
14 | */
15 | export function buildPath(base: string, ...components: string[]): string {
16 | let path = base;
17 | for (const c of components) {
18 | if (c !== "") {
19 | if (path.endsWith("/")) {
20 | if (c.startsWith("/")) {
21 | path += c.substring(1);
22 | } else {
23 | path += c;
24 | }
25 | } else {
26 | if (c.startsWith("/")) {
27 | path += c;
28 | } else {
29 | path += "/" + c;
30 | }
31 | }
32 | }
33 | }
34 | return path;
35 | }
36 |
--------------------------------------------------------------------------------
/src/util/qparam.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | // based on https://stackoverflow.com/questions/901115/how-can-i-get-query-string-values-in-javascript
8 |
9 | export function getQueryParameterByName(
10 | queryStr: string | null,
11 | name: string,
12 | defaultValue: string | null = null,
13 | ): string | null {
14 | queryStr = queryStr || window.location.search;
15 | if (!queryStr) {
16 | return defaultValue;
17 | }
18 | const match = RegExp("[?&]" + name + "=([^&]*)").exec(queryStr);
19 | if (!match) {
20 | return defaultValue;
21 | }
22 | return decodeURIComponent(match[1].replace(/\+/g, " "));
23 | }
24 |
--------------------------------------------------------------------------------
/src/util/styles.test.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { expect, it, describe } from "vitest";
8 | import { makeStyles, makeCssStyles } from "./styles";
9 |
10 | describe("makeStyles", () => {
11 | it("just converts the type and not the value", () => {
12 | const rawStyles = {};
13 | expect(makeStyles(rawStyles)).toBe(rawStyles);
14 | });
15 | });
16 |
17 | describe("makeCssStyles", () => {
18 | it("just converts the type and not the value", () => {
19 | const rawStyles = {};
20 | expect(makeCssStyles(rawStyles)).toBe(rawStyles);
21 | });
22 | });
23 |
--------------------------------------------------------------------------------
/src/util/styles.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { SxProps, Theme } from "@mui/system";
8 | import { CSSProperties } from "react";
9 |
10 | type RawStyles = Record>;
11 | type Styles = {
12 | [P in keyof S]: SxProps;
13 | };
14 |
15 | /**
16 | * Convert given styles object into its type-safe version
17 | * where `S` the type of the "raw" styles
18 | * and `T` is the MUI theme type.
19 | * @param rawStyles Object that maps a property key into an `SxProps` value.
20 | */
21 | export function makeStyles(
22 | rawStyles: RawStyles,
23 | ): Styles {
24 | return rawStyles;
25 | }
26 |
27 | type CssStyles = {
28 | [P in keyof S]: CSSProperties;
29 | };
30 |
31 | export function makeCssStyles(
32 | rawStyles: CssStyles,
33 | ): CssStyles {
34 | return rawStyles;
35 | }
36 |
--------------------------------------------------------------------------------
/src/util/throttle.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { isNumber } from "@/util/types";
8 |
9 | export function throttle) => ReturnType>(
10 | callback: T,
11 | delay?: number,
12 | ): T {
13 | return isNumber(delay) && delay > 0
14 | ? throttleWithDelay(callback, delay)
15 | : throttleWithRAF(callback);
16 | }
17 |
18 | function throttleWithDelay) => ReturnType>(
19 | callback: T,
20 | delay: number,
21 | ): T {
22 | let lastExecutionTime = 0;
23 | let lastResult: ReturnType;
24 | return ((...args: Parameters) => {
25 | const currentTime = Date.now();
26 | if (lastExecutionTime === 0 || currentTime - lastExecutionTime >= delay) {
27 | lastResult = callback(...args);
28 | lastExecutionTime = currentTime;
29 | }
30 | return lastResult;
31 | }) as T;
32 | }
33 |
34 | function throttleWithRAF) => ReturnType>(
35 | callback: T,
36 | ): T {
37 | let isThrottled = false;
38 | return ((...args: Parameters) => {
39 | if (!isThrottled) {
40 | isThrottled = true;
41 | requestAnimationFrame(() => {
42 | callback(...args);
43 | isThrottled = false;
44 | });
45 | }
46 | }) as T;
47 | }
48 |
--------------------------------------------------------------------------------
/src/util/time.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | function getTimezoneOffset(date: Date): number {
8 | return date.getTimezoneOffset() * 60000;
9 | }
10 |
11 | export function localToUtcTime(local: Date): number {
12 | return local.getTime() - getTimezoneOffset(local);
13 | }
14 |
15 | export function utcTimeToLocal(utcTime: number): Date {
16 | const dateTime = new Date(utcTime);
17 | return new Date(dateTime.getTime() + getTimezoneOffset(dateTime));
18 | }
19 |
20 | export function utcTimeToIsoDateString(utcTime: number) {
21 | return new Date(utcTime).toISOString().substring(0, 10);
22 | }
23 |
24 | export function utcTimeToIsoDateTimeString(utcTime: number) {
25 | return isoDateTimeStringToLabel(new Date(utcTime).toISOString());
26 | }
27 |
28 | export function isoDateTimeStringToLabel(utcDateTimeString: string) {
29 | return utcDateTimeString.substring(0, 19).replace("T", " ");
30 | }
31 |
--------------------------------------------------------------------------------
/src/util/types.test.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import { expect, it, describe } from "vitest";
8 | import { isNumber, isObject } from "@/util/types";
9 |
10 | class A {}
11 |
12 | const TEST_VALUES = [
13 | undefined,
14 | null,
15 | true,
16 | 1.5,
17 | "Hi",
18 | () => {},
19 | [],
20 | {},
21 | A,
22 | new A(),
23 | ];
24 |
25 | describe("Assert", () => {
26 | it("isNumber() works", () => {
27 | expect(TEST_VALUES.map(isNumber)).toEqual([
28 | false,
29 | false,
30 | false,
31 | true,
32 | false,
33 | false,
34 | false,
35 | false,
36 | false,
37 | false,
38 | ]);
39 | });
40 |
41 | it("isObject() works", () => {
42 | expect(TEST_VALUES.map(isObject)).toEqual([
43 | false,
44 | false,
45 | false,
46 | false,
47 | false,
48 | false,
49 | false,
50 | true,
51 | false,
52 | false,
53 | ]);
54 | });
55 | });
56 |
--------------------------------------------------------------------------------
/src/util/types.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export function isNumber(value: unknown): value is number {
8 | return typeof value === "number";
9 | }
10 |
11 | export function isString(value: unknown): value is string {
12 | return typeof value === "string";
13 | }
14 |
15 | export function isFunction(
16 | value: unknown,
17 | ): value is (...args: unknown[]) => unknown {
18 | return typeof value === "function";
19 | }
20 |
21 | export function isObject(value: unknown): value is Record {
22 | return (
23 | value !== null && typeof value === "object" && value.constructor === Object
24 | );
25 | }
26 |
--------------------------------------------------------------------------------
/src/version.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | // Important: use semantic versioning (https://semver.org/)
8 | const version = "1.6.1-dev.0";
9 |
10 | export default version;
11 |
--------------------------------------------------------------------------------
/src/vite-env.d.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | ///
8 |
9 | interface ImportMetaEnv {
10 | readonly XCV_OAUTH2_AUTHORITY?: string;
11 | readonly XCV_OAUTH2_CLIENT_ID?: string;
12 | readonly XCV_OAUTH2_AUDIENCE?: string;
13 | readonly XCV_APP_SERVER_ID?: string;
14 | readonly XCV_SERVER_NAME?: string;
15 | readonly XCV_SERVER_URL?: string;
16 | // more env variables...
17 | }
18 |
19 | interface ImportMeta {
20 | readonly env: ImportMetaEnv;
21 | }
22 |
--------------------------------------------------------------------------------
/src/volume/ColorBarTextures.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | import * as THREE from "three";
8 |
9 | import { ColorBar, formatColorBarName } from "@/model/colorBar";
10 |
11 | class ColorBarTextures {
12 | private readonly textures: { [cmName: string]: THREE.Texture };
13 |
14 | constructor() {
15 | this.textures = {};
16 | }
17 |
18 | get(colorBar: ColorBar, onLoad?: () => void): THREE.Texture {
19 | const key = formatColorBarName(colorBar);
20 | let texture = this.textures[key];
21 | if (!texture) {
22 | // const image = new Image();
23 | // loadColorBarImage(colorBar, image).then();
24 | // texture = new THREE.Texture(image);
25 | texture = new THREE.TextureLoader().load(
26 | `data:image/png;base64,${colorBar.imageData}`,
27 | onLoad,
28 | );
29 | this.textures[key] = texture;
30 | }
31 | return texture;
32 | }
33 | }
34 |
35 | export const colorBarTextures = new ColorBarTextures();
36 |
--------------------------------------------------------------------------------
/src/volume/webgl-utils.ts:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (c) 2019-2025 by xcube team and contributors
3 | * Permissions are hereby granted under the terms of the MIT License:
4 | * https://opensource.org/licenses/MIT.
5 | */
6 |
7 | export function isWebGL2Available(): boolean {
8 | try {
9 | const canvas = document.createElement("canvas");
10 | return !!(window.WebGL2RenderingContext && canvas.getContext("webgl2"));
11 | } catch (e) {
12 | return false;
13 | }
14 | }
15 |
--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 | "compilerOptions": {
3 | "baseUrl": ".",
4 | "paths": {
5 | "@/*": ["src/*"]
6 | },
7 |
8 | "target": "ES2020",
9 | "useDefineForClassFields": true,
10 | "lib": ["ES2020", "DOM", "DOM.Iterable"],
11 | "module": "ESNext",
12 | "skipLibCheck": true,
13 |
14 | /* Bundler mode */
15 | "moduleResolution": "bundler",
16 | "allowJs": true,
17 | "allowImportingTsExtensions": false,
18 | "resolveJsonModule": true,
19 | "isolatedModules": true,
20 | "noEmit": true,
21 | "jsx": "react-jsx",
22 |
23 | /* Linting */
24 | "strict": true,
25 | "noUnusedLocals": true,
26 | "noUnusedParameters": true,
27 | "noFallthroughCasesInSwitch": true
28 | },
29 | "include": ["src"],
30 | "references": [{ "path": "./tsconfig.node.json" }]
31 | }
32 |
--------------------------------------------------------------------------------
/tsconfig.node.json:
--------------------------------------------------------------------------------
1 | {
2 | "compilerOptions": {
3 | "composite": true,
4 | "skipLibCheck": true,
5 | "module": "ESNext",
6 | "moduleResolution": "bundler",
7 | "allowSyntheticDefaultImports": true,
8 | "strict": true
9 | },
10 | "include": ["vite.config.ts"]
11 | }
12 |
--------------------------------------------------------------------------------