@scm-manager/ui-core 3.0.0-20240024-101702

package/src/base/forms/resourceHooks.ts

@@ -0,0 +1,164 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { apiClient, requiredLink } from "@scm-manager/ui-api";
+import { useMutation, useQueryClient } from "react-query";
+import { HalRepresentation, Link } from "@scm-manager/ui-types";
+
+type QueryKeyPair = [singular: string, plural: string];
+type LinkOrHalLink = string | [entity: HalRepresentation, link: string] | HalRepresentation;
+const unwrapLink = (input: LinkOrHalLink, linkName: string) => {
+  if (Array.isArray(input)) {
+    return requiredLink(input[0], input[1]);
+  } else if (typeof input === "string") {
+    return input;
+  } else {
+    return (input._links[linkName] as Link).href;
+  }
+};
+
+type MutationResult<I, O = unknown> = {
+  submit: (resource: I) => Promise<O>;
+  isLoading: boolean;
+  error: Error | null;
+  submissionResult?: O;
+};
+
+type MutatingResourceOptions = {
+  contentType?: string;
+};
+
+const createResource = <I, O = never>(link: string, contentType: string) => {
+  return (payload: I): Promise<O> => {
+    return apiClient
+      .post(link, payload, contentType)
+      .then((response) => {
+        const location = response.headers.get("Location");
+        if (!location) {
+          throw new Error("Server does not return required Location header");
+        }
+        return apiClient.get(location);
+      })
+      .then((response) => response.json());
+  };
+};
+
+type CreateResourceOptions = MutatingResourceOptions;
+
+/**
+ * @beta
+ * @since 2.41.0
+ */
+export const useCreateResource = <I, O>(
+  link: string,
+  [entityKey, collectionName]: QueryKeyPair,
+  idFactory: (createdResource: O) => string,
+  { contentType = "application/json" }: CreateResourceOptions = {}
+): MutationResult<I, O> => {
+  const queryClient = useQueryClient();
+  const { mutateAsync, data, isLoading, error } = useMutation<O, Error, I>(createResource<I, O>(link, contentType), {
+    onSuccess: (result) => {
+      queryClient.setQueryData([entityKey, idFactory(result)], result);
+      return queryClient.invalidateQueries(collectionName);
+    },
+  });
+  return {
+    submit: (payload: I) => mutateAsync(payload),
+    isLoading,
+    error,
+    submissionResult: data,
+  };
+};
+
+type UpdateResourceOptions = MutatingResourceOptions & {
+  collectionName?: QueryKeyPair;
+};
+
+/**
+ * @beta
+ * @since 2.41.0
+ */
+export const useUpdateResource = <T>(
+  link: LinkOrHalLink,
+  idFactory: (createdResource: T) => string,
+  {
+    contentType = "application/json",
+    collectionName: [entityQueryKey, collectionName] = ["", ""],
+  }: UpdateResourceOptions = {}
+): MutationResult<T> => {
+  const queryClient = useQueryClient();
+  const { mutateAsync, isLoading, error, data } = useMutation<unknown, Error, T>(
+    (resource) => apiClient.put(unwrapLink(link, "update"), resource, contentType),
+    {
+      onSuccess: async (_, payload) => {
+        await queryClient.invalidateQueries(entityQueryKey ? [entityQueryKey, idFactory(payload)] : idFactory(payload));
+        if (collectionName) {
+          await queryClient.invalidateQueries(collectionName);
+        }
+      },
+    }
+  );
+  return {
+    submit: (resource: T) => mutateAsync(resource),
+    isLoading,
+    error,
+    submissionResult: data,
+  };
+};
+
+type DeleteResourceOptions = {
+  collectionName?: QueryKeyPair;
+};
+
+/**
+ * @beta
+ * @since 2.41.0
+ */
+export const useDeleteResource = <T extends HalRepresentation>(
+  idFactory: (createdResource: T) => string,
+  { collectionName: [entityQueryKey, collectionName] = ["", ""] }: DeleteResourceOptions = {}
+): MutationResult<T> => {
+  const queryClient = useQueryClient();
+  const { mutateAsync, isLoading, error, data } = useMutation<unknown, Error, T>(
+    (resource) => {
+      const deleteUrl = (resource._links.delete as Link).href;
+      return apiClient.delete(deleteUrl);
+    },
+    {
+      onSuccess: async (_, resource) => {
+        const id = idFactory(resource);
+        await queryClient.removeQueries(entityQueryKey ? [entityQueryKey, id] : id);
+        if (collectionName) {
+          await queryClient.invalidateQueries(collectionName);
+        }
+      },
+    }
+  );
+  return {
+    submit: (resource: T) => mutateAsync(resource),
+    isLoading,
+    error,
+    submissionResult: data,
+  };
+};

package/src/base/forms/select/ControlledSelectField.tsx

@@ -0,0 +1,87 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import React, { ComponentProps } from "react";
+import { Controller, ControllerRenderProps, Path } from "react-hook-form";
+import { useScmFormContext } from "../ScmFormContext";
+import SelectField from "./SelectField";
+import { useScmFormPathContext } from "../FormPathContext";
+import { prefixWithoutIndices } from "../helpers";
+import classNames from "classnames";
+
+type Props<T extends Record<string, unknown>> = Omit<
+  ComponentProps<typeof SelectField>,
+  "error" | "label" | "required" | keyof ControllerRenderProps
+> & {
+  rules?: ComponentProps<typeof Controller>["rules"];
+  name: Path<T>;
+  label?: string;
+};
+
+function ControlledSelectField<T extends Record<string, unknown>>({
+  name,
+  label,
+  helpText,
+  rules,
+  testId,
+  defaultValue,
+  readOnly,
+  className,
+  ...props
+}: Props<T>) {
+  const { control, t, readOnly: formReadonly, formId } = useScmFormContext();
+  const formPathPrefix = useScmFormPathContext();
+  const nameWithPrefix = formPathPrefix ? `${formPathPrefix}.${name}` : name;
+  const prefixedNameWithoutIndices = prefixWithoutIndices(nameWithPrefix);
+  const labelTranslation = label || t(`${prefixedNameWithoutIndices}.label`) || "";
+  const helpTextTranslation = helpText || t(`${prefixedNameWithoutIndices}.helpText`);
+  return (
+    <Controller
+      control={control}
+      name={nameWithPrefix}
+      rules={rules}
+      defaultValue={defaultValue as never}
+      render={({ field, fieldState }) => (
+        <SelectField
+          form={formId}
+          readOnly={readOnly ?? formReadonly}
+          required={rules?.required as boolean}
+          className={classNames("column", className)}
+          {...props}
+          {...field}
+          label={labelTranslation}
+          helpText={helpTextTranslation}
+          error={
+            fieldState.error
+              ? fieldState.error.message || t(`${prefixedNameWithoutIndices}.error.${fieldState.error.type}`)
+              : undefined
+          }
+          testId={testId ?? `select-${nameWithPrefix}`}
+        />
+      )}
+    />
+  );
+}
+
+export default ControlledSelectField;

package/src/base/forms/select/Select.tsx

@@ -0,0 +1,57 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import React, { InputHTMLAttributes, Key, OptionHTMLAttributes } from "react";
+import classNames from "classnames";
+import { createVariantClass, Variant } from "../variants";
+import { createAttributesForTesting } from "../../helpers";
+
+type Props = {
+  variant?: Variant;
+  options?: Array<OptionHTMLAttributes<HTMLOptionElement> & { label: string }>;
+  testId?: string;
+} & InputHTMLAttributes<HTMLSelectElement>;
+
+/**
+ * @beta
+ * @since 2.44.0
+ */
+const Select = React.forwardRef<HTMLSelectElement, Props>(
+  ({ variant, children, className, options, testId, ...props }, ref) => (
+    <div className={classNames("select", { "is-multiple": props.multiple }, createVariantClass(variant), className)}>
+      <select ref={ref} {...props} {...createAttributesForTesting(testId)} className={className}>
+        {options
+          ? options.map((opt) => (
+              <option {...opt} key={opt.value as Key}>
+                {opt.label}
+                {opt.children}
+              </option>
+            ))
+          : children}
+      </select>
+    </div>
+  )
+);
+
+export default Select;

package/src/base/forms/select/SelectField.tsx

@@ -0,0 +1,63 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import React from "react";
+import Field from "../base/Field";
+import Control from "../base/Control";
+import Label from "../base/label/Label";
+import FieldMessage from "../base/field-message/FieldMessage";
+import Help from "../base/help/Help";
+import Select from "./Select";
+import { useAriaId } from "../../helpers";
+
+type Props = {
+  label: string;
+  helpText?: string;
+  error?: string;
+} & React.ComponentProps<typeof Select>;
+
+/**
+ * @see https://bulma.io/documentation/form/select/
+ * @beta
+ * @since 2.44.0
+ */
+const SelectField = React.forwardRef<HTMLSelectElement, Props>(
+  ({ label, helpText, error, className, id, ...props }, ref) => {
+    const selectId = useAriaId(id ?? props.testId);
+    const variant = error ? "danger" : undefined;
+    return (
+      <Field className={className}>
+        <Label htmlFor={selectId}>
+          {label}
+          {helpText ? <Help className="ml-1" text={helpText} /> : null}
+        </Label>
+        <Control>
+          <Select id={selectId} variant={variant} ref={ref} className="is-full-width" {...props}></Select>
+        </Control>
+        {error ? <FieldMessage variant={variant}>{error}</FieldMessage> : null}
+      </Field>
+    );
+  }
+);
+export default SelectField;

package/src/base/forms/table/ControlledColumn.tsx

@@ -0,0 +1,49 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import React, { FC, HTMLAttributes, useMemo } from "react";
+import { useScmFormPathContext } from "../FormPathContext";
+import { useScmFormContext } from "../ScmFormContext";
+import { useWatch } from "react-hook-form";
+
+type Props = {
+  name: string;
+  children?: (value: unknown) => React.ReactNode | React.ReactNode[];
+} & HTMLAttributes<HTMLTableCellElement>;
+
+/**
+ * @beta
+ * @since 2.43.0
+ */
+const ControlledColumn: FC<Props> = ({ name, children, ...props }) => {
+  const { control } = useScmFormContext();
+  const formPathPrefix = useScmFormPathContext();
+  const nameWithPrefix = useMemo(() => (formPathPrefix ? `${formPathPrefix}.${name}` : name), [formPathPrefix, name]);
+  const value = useWatch({ control, name: nameWithPrefix, disabled: typeof children === "function" });
+  const allValues = useWatch({ control, name: formPathPrefix, disabled: typeof children !== "function" });
+
+  return <td {...props}>{typeof children === "function" ? children(allValues) : value}</td>;
+};
+
+export default ControlledColumn;

package/src/base/forms/table/ControlledTable.tsx

@@ -0,0 +1,99 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import React, { ReactElement } from "react";
+import { Path, PathValue } from "react-hook-form";
+import { useScmFormContext } from "../ScmFormContext";
+import { ScmFormPathContextProvider, useScmFormPathContext } from "../FormPathContext";
+import { Button } from "../../buttons";
+import { prefixWithoutIndices } from "../helpers";
+import classNames from "classnames";
+import { useScmFormListContext } from "../ScmFormListContext";
+import { useTranslation } from "react-i18next";
+import { Notification } from "../../notifications";
+
+type RenderProps<T extends Record<string, unknown>, PATH extends Path<T>> = {
+  value: PathValue<T, PATH>;
+  index: number;
+  remove: () => void;
+};
+
+type Props<T extends Record<string, unknown>, PATH extends Path<T>> = {
+  withDelete?: boolean;
+  children: ((renderProps: RenderProps<T, PATH>) => React.ReactNode | React.ReactNode[]) | React.ReactNode;
+  className?: string;
+};
+
+/**
+ * @beta
+ * @since 2.43.0
+ */
+function ControlledTable<T extends Record<string, unknown>, PATH extends Path<T>>({
+  withDelete,
+  children,
+  className,
+}: Props<T, PATH>) {
+  const [defaultTranslate] = useTranslation("commons", { keyPrefix: "form.table" });
+  const { readOnly, t } = useScmFormContext();
+  const nameWithPrefix = useScmFormPathContext();
+  const prefixedNameWithoutIndices = prefixWithoutIndices(nameWithPrefix);
+  const { fields, remove } = useScmFormListContext();
+  const deleteLabel = t(`${prefixedNameWithoutIndices}.delete`) || defaultTranslate("delete.label");
+  const emptyTableLabel = t(`${prefixedNameWithoutIndices}.empty`) || defaultTranslate("empty.label");
+  const actionHeaderLabel = t(`${prefixedNameWithoutIndices}.action.label`) || defaultTranslate("headers.action.label");
+
+  return (
+    <table className={classNames("table content is-hoverable", className)}>
+      <thead>
+        <tr>
+          {React.Children.map(children, (child) => (
+            <th>{t(`${prefixedNameWithoutIndices}.${(child as ReactElement).props.name}.label`)}</th>
+          ))}
+          {withDelete && !readOnly ? <th className="has-text-right">{actionHeaderLabel}</th> : null}
+        </tr>
+      </thead>
+      <tbody>
+      {fields.length === 0 ? <tr><td colSpan={1000}><Notification type="info">{emptyTableLabel}</Notification></td></tr> : null}
+        {fields.map((value, index) => (
+          <ScmFormPathContextProvider key={value.id} path={`${nameWithPrefix}.${index}`}>
+            <tr>
+              {children}
+              {withDelete && !readOnly ? (
+                <td className="has-text-right">
+                  <Button className="px-4" onClick={() => remove(index)} aria-label={deleteLabel}>
+                    <span className="icon is-small">
+                      <i className="fas fa-trash" />
+                    </span>
+                  </Button>
+                </td>
+              ) : null}
+            </tr>
+          </ScmFormPathContextProvider>
+        ))}
+      </tbody>
+    </table>
+  );
+}
+
+export default ControlledTable;

package/src/base/forms/variants.ts

@@ -0,0 +1,27 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export const variants = ["danger"] as const;
+export type Variant = typeof variants[number];
+export const createVariantClass = (variant?: Variant) => (variant ? `is-${variant}` : undefined);

package/src/base/helpers/devbuild.ts

@@ -0,0 +1,44 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export const isDevBuild = () =>
+  ((window as unknown as { scmStage: string }).scmStage || "").toUpperCase() !== "PRODUCTION";
+
+export const createAttributesForTesting = (testId?: string) => {
+  if (!testId) {
+    return undefined;
+  }
+  return {
+    "data-testid": normalizeTestId(testId),
+  };
+};
+
+// keep this weird function instead of replaceAll because of browser compatibility
+const normalizeTestId = (testId?: string) => {
+  let id = testId?.toLowerCase();
+  while (id?.includes(" ")) {
+    id = id.replace(" ", "-");
+  }
+  return id;
+};

package/src/base/helpers/index.ts

@@ -0,0 +1,26 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export { default as useAriaId } from "./useAriaId";
+export { createAttributesForTesting, isDevBuild } from "./devbuild";

package/src/base/helpers/useAriaId.tsx

@@ -0,0 +1,31 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { useMemo } from "react";
+
+let counter = 0;
+
+export default function useAriaId(id?: string) {
+  return useMemo(() => id ?? `scm-id-${++counter}`, [id]);
+}