@antelopejs/dms 0.12.0 → 0.13.0

package/frontend-vue/layers/dms-ui/app/build/composables/table-view/utils/writeError.ts

@@ -1,6 +1,6 @@
 import type { I18nTranslate } from "#dms-core/app/composables/translation/useTranslation";
 import type { TableViewColumn } from "../../../../composables/table-view/types/column";
-import { resolveActionError } from "../../confirm/actionError";
+import { describeFieldErrors } from "#dms-core/app/composables/useFieldErrors";
 
 /**
  * Why a table view's write failed (a card moved on the board, a row moved
@@ -8,14 +8,18 @@ import { resolveActionError } from "../../confirm/actionError";
  * data API refused named by its column's label ("Loss reason is
  * required."). Never the raw ofetch error line.
  */
-export function describeTableWriteError(
-  error: Parameters<typeof resolveActionError>[0],
+export function tableWriteErrorOptions(
+  error: unknown,
   translate: I18nTranslate,
   columns: ReadonlyArray<Pick<TableViewColumn, "accessorKey" | "header">>,
   processI18n: (text: string) => string,
-): string {
-  return resolveActionError(error, translate, (field) => {
+  fallbackKey = "dms.action_error.generic",
+): ResolveApiErrorOptions {
+  const summary = describeFieldErrors(error, translate, (field) => {
     const column = columns.find((entry) => entry.accessorKey === field);
     return column ? processI18n(column.header) : undefined;
   });
+  return summary
+    ? { fallbackKey: "dms.action_error.fields", params: { summary } }
+    : { fallbackKey };
 }

package/frontend-vue/layers/dms-ui/app/build/utils/fetchNotFound.ts

@@ -5,7 +5,7 @@ import {
 import { HTTP_NOT_FOUND } from "../../../../dms-core/app/utils/http-status";
 import type { I18nTranslate } from "#dms-core/app/composables/translation/useTranslation";
 import type { BlockAction } from "../components/blocks/BlockActions.vue";
-import { userFacingText } from "../composables/confirm/actionError";
+import type { ApiErrorPresenter } from "#dms-core/app/composables/useApiErrorPresenter";
 import type { Tone } from "#dms-core/app/types/tone";
 
 /** Translation key of the not-found title, shared by blocks and guards. */
@@ -76,11 +76,12 @@ export function readFetchNotFound(
 export function notFoundTexts(
   notFound: FetchNotFound | null | undefined,
   translate: I18nTranslate,
+  resolveError: ApiErrorPresenter["resolveError"],
 ) {
   return {
     title: translate(NOT_FOUND_TITLE_KEY, {}),
     description:
-      userFacingText(notFound?.message, translate) ??
-      translate(NOT_FOUND_HINT_KEY, {}),
+      resolveError(notFound?.message, { fallbackKey: NOT_FOUND_HINT_KEY })
+        ?.message ?? translate(NOT_FOUND_HINT_KEY, {}),
   };
 }

package/frontend-vue/layers/dms-ui/app/components/block-preview/BlockPreview.vue

@@ -14,6 +14,8 @@ import {
 } from "../../build/utils/blockPreview";
 import { childComponentId } from "../../utils/componentId";
 
+const { resolveError } = useApiErrorPresenter();
+
 /**
  * Draws a tree of registered DMS blocks exactly as a page would.
  *
@@ -129,7 +131,10 @@ onMounted(async () => {
     fetchedBlockTypes.value =
       await $authFetch<PreviewBlockTypes>(BLOCK_TYPES_ENDPOINT);
   } catch (error: unknown) {
-    embed?.reportError(error instanceof Error ? error.message : String(error));
+    const notice = resolveError(error, {
+      fallbackKey: "dms.blocks.load_error_hint",
+    });
+    if (notice) embed?.reportError(notice.message);
   }
 });
 </script>

package/frontend-vue/layers/dms-ui/app/components/blocks/BannerBlock.vue

@@ -92,12 +92,14 @@ const { data } = useChartFetch<BannerContent | null>({
   watchSource: () => JSON.stringify(watchState.value),
 });
 
+const { presentError } = useApiErrorPresenter();
 const { handleCustomButton } = useActionTargets({
   api: useAuthFetch().$authFetch,
   componentId: props.componentId ?? FALLBACK_COMPONENT_ID,
   pageId: props.pageId ?? FALLBACK_PAGE_ID,
   refreshCallback: refreshPageBlocks,
-  handleApiError: (error, title) => useApiError(error, { title }),
+  handleApiError: (error, title) =>
+    presentError(error, { fallbackKey: title ?? "error.500.description" }),
 });
 
 const hasFetchedContent = computed(

package/frontend-vue/layers/dms-ui/app/components/chart/Chart.vue

@@ -43,6 +43,7 @@ import {
   NESTED_CHART_INJECT_KEY,
 } from "../../composables/chart/types";
 import type { DefaultComponentProps } from "../../../../dms-core/app/types/component";
+import { responseSeries } from "../../build/composables/chart/groupPoints";
 
 interface Props extends DefaultComponentProps {
   type: ChartType;
@@ -164,7 +165,9 @@ const seriesFromCtx = computed<ChartSeries[]>(() => {
 
 const fetchSeries = computed<ChartSeries[]>(() => {
   if (!data.value) return [];
-  return localized(data.value.series ?? []);
+  return localized(
+    responseSeries(data.value.series ?? [], props.title ?? "", props.xaxisType),
+  );
 });
 
 const finalSeries = computed<ChartSeries[]>(() => {

package/frontend-vue/layers/dms-ui/app/components/chart/ChartCard.vue

@@ -21,6 +21,7 @@ import {
   type ValuePrecision,
 } from "../../composables/chart/types";
 import type { DefaultComponentProps } from "../../../../dms-core/app/types/component";
+import { drawableSeries } from "../../build/composables/chart/groupPoints";
 
 interface Props extends DefaultComponentProps {
   title: string;
@@ -93,13 +94,13 @@ function localized(entry: ChartSeries): ChartSeries {
 }
 
 const cardSeries = computed<ChartSeries[]>(() =>
-  (data.value?.series ?? []).map(localized),
+  drawableSeries(data.value?.series ?? []).map(localized),
 );
 
 const cardComparisonSeries = computed<ChartSeries[]>(() =>
   comparison.isOff.value
     ? []
-    : (data.value?.comparisonSeries ?? []).map((entry) => ({
+    : drawableSeries(data.value?.comparisonSeries ?? []).map((entry) => ({
         ...localized(entry),
         color: entry.color ?? comparisonColor.value,
       })),

package/frontend-vue/layers/dms-ui/app/components/confirm/ConfirmModal.vue

@@ -23,7 +23,6 @@ import {
   ConfirmTextError,
   type ConfirmValues,
 } from "../../composables/confirm/types";
-import { resolveActionError } from "../../build/composables/confirm/actionError";
 import { isConfirmTextMatch } from "../../build/composables/confirm/confirmTextMatch";
 import type { ConfirmDialogField } from "#dms-core/app/types/confirm-dialog";
 import { resolveFieldErrors } from "#dms-core/app/composables/useFieldErrors";
@@ -113,6 +112,7 @@ const props = withDefaults(defineProps<ConfirmModalProps>(), {
 const emit = defineEmits<ConfirmModalEmits>();
 const slots = defineSlots<ConfirmModalSlots>();
 const { t } = useI18n();
+const { resolveError } = useApiErrorPresenter();
 
 const BodyRender: FunctionalComponent = () => props.body?.();
 
@@ -123,8 +123,6 @@ const DEFAULT_ICONS: Partial<Record<ConfirmColor, string>> = {
 };
 const FALLBACK_ICON = "i-ph-question";
 
-const { processApiMessage } = useTranslation();
-
 const values = ref<ConfirmValues>(
   Object.fromEntries(
     props.fields.map((field) => [field.id, field.defaultValue]),
@@ -169,7 +167,7 @@ const typedText = ref("");
 const isPending = ref(false);
 const isSecondaryPending = ref(false);
 
-const notice = ref<ConfirmNotice & { tone: "error" | "warning" }>();
+const notice = ref<ConfirmNotice & { tone: ApiErrorSeverity }>();
 
 const isSettled = ref(false);
 
@@ -245,13 +243,12 @@ const isPartialOutcome = (
 ): value is ConfirmPartialOutcome =>
   isObject(value) && value !== null && "partial" in value;
 
-function errorNotice(
-  error: Parameters<typeof resolveActionError>[0],
-): ConfirmNotice {
-  if (error instanceof ConfirmActionError) {
-    return { title: error.message, description: error.description };
-  }
-  return { title: resolveActionError(error, t) };
+function resolveConfirmationFailure(error: unknown): ApiErrorNotice | null {
+  const action = error instanceof ConfirmActionError ? error : undefined;
+  return resolveError(error, {
+    fallbackKey: action?.message ?? "dms.action_error.generic",
+    params: action?.params,
+  });
 }
 
 /**
@@ -267,9 +264,12 @@ function showFieldErrors(
   });
   if (resolved.fields.length === 0) return false;
   fieldErrors.value = Object.fromEntries(
-    resolved.fields.map(({ field, message }) => [
+    resolved.fields.map(({ field, message, params, fallbackKey }) => [
       field,
-      processApiMessage(message),
+      resolveError(message, {
+        fallbackKey: fallbackKey ?? "dms.field_errors.invalid",
+        params,
+      })?.message,
     ]),
   );
   return !resolved.hasUnmatched;
@@ -293,9 +293,14 @@ async function runConfirm(
     }
   } catch (error) {
     if (error instanceof ConfirmTextError && props.confirmText) {
-      typedError.value = error.message;
+      typedError.value = resolveError(error, {
+        fallbackKey: "dms.field_errors.invalid",
+      })?.message;
     } else if (!showFieldErrors(error)) {
-      notice.value = { ...errorNotice(error), tone: "error" };
+      const resolved = resolveConfirmationFailure(error);
+      notice.value = resolved
+        ? { title: resolved.message, tone: resolved.severity }
+        : undefined;
     }
   } finally {
     isPending.value = false;
@@ -341,7 +346,10 @@ async function handleSecondary() {
   try {
     await action.run();
   } catch (error) {
-    notice.value = { ...errorNotice(error), tone: "error" };
+    const resolved = resolveConfirmationFailure(error);
+    notice.value = resolved
+      ? { title: resolved.message, tone: resolved.severity }
+      : undefined;
   } finally {
     isSecondaryPending.value = false;
   }

package/frontend-vue/layers/dms-ui/app/components/form/components/Cascader.vue

@@ -60,7 +60,7 @@ const invalid = computed(() => fieldColor.value === "error");
 
 const instanceId = useId();
 const { $authFetch } = useAuthFetch();
-const toast = useToast();
+const { presentError } = useApiErrorPresenter();
 const { t } = useI18n();
 const { processI18n } = useTranslation();
 
@@ -77,11 +77,7 @@ const { data, status, execute } = await useDmsAsyncData(
     return $authFetch<CascaderResponse>(url, {
       params: { limit: CASCADER_FETCH_LIMIT },
       onRequestError: ({ error }: { error: Error }) => {
-        toast.add({
-          color: Color.error,
-          title: t("dms.form.error_title"),
-          description: error.message,
-        });
+        presentError(error, { fallbackKey: "dms.form.error_title" });
       },
     });
   },

package/frontend-vue/layers/dms-ui/app/components/form/components/DatePicker.vue

@@ -164,8 +164,7 @@ function trackRangePick(value: Parameters<typeof forwardEmit>[1]): void {
     report(undefined);
     return;
   }
-  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- The forwarded event has no validated range owner; keep optional property reads on arbitrary non-null values rather than adding validation.
-  const ends = value as Partial<StrictDateRange>;
+  const ends: { start?: unknown; end?: unknown } = value;
   if (!ends.start) return;
   isHalfPicked = !ends.end;
   if (!isHalfPicked) report(undefined);
@@ -180,8 +179,7 @@ const isPickerOpen = ref(false);
 function isPickComplete(value: Parameters<typeof forwardEmit>[1]): boolean {
   if (!value || props.multiple) return false;
   if (!props.range) return true;
-  // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- The forwarded event has no validated range owner; keep its existing optional-property truthiness checks on arbitrary values.
-  const ends = value as Partial<StrictDateRange>;
+  const ends: { start?: unknown; end?: unknown } = value;
   return !!ends.start && !!ends.end;
 }
 

package/frontend-vue/layers/dms-ui/app/components/form/components/File.vue

@@ -41,6 +41,7 @@ const emit = defineEmits<{
 
 const { $authFetch } = useAuthFetch();
 const { t } = useI18n();
+const { presentError, resolveError } = useApiErrorPresenter();
 
 const { emitFormChange, color, highlight, ariaAttrs } = useFormField();
 
@@ -156,11 +157,14 @@ const processFile = async (file: File) => {
     }
 
     emitValue();
-  } catch (_error) {
+  } catch (error) {
     const uploadingFile = uploadingFiles.value.find((u) => u.id === uploadId);
     if (uploadingFile) {
-      uploadingFile.error = "Upload failed";
+      uploadingFile.error = resolveError(error, {
+        fallbackKey: "dms.form.image.upload_failed",
+      })?.message;
     }
+    presentError(error, { fallbackKey: "dms.form.image.upload_failed" });
   } finally {
     setFieldLoading?.(uploadId, false);
   }

package/frontend-vue/layers/dms-ui/app/components/form/components/Image.vue

@@ -39,6 +39,7 @@ interface ImageProps {
 }
 
 const props = defineProps<ImageProps>();
+const { resolveError } = useApiErrorPresenter();
 const emit = defineEmits<{
   "update:modelValue": [ImageItemValue | ImageItemValue[] | null];
 }>();
@@ -206,8 +207,11 @@ const runUpload = async (item: GalleryItem) => {
     item.progress = 100;
     ensurePrincipal();
     emitValue();
-  } catch (_error) {
+  } catch (error) {
     item.status = "error";
+    item.errorMessage = resolveError(error, {
+      fallbackKey: "dms.form.image.upload_failed",
+    })?.message;
   } finally {
     setFieldLoading?.(item.id, false);
   }

package/frontend-vue/layers/dms-ui/app/components/form/components/ImagePresentation.vue

@@ -168,7 +168,7 @@ const {
             <span
               class="bg-error rounded-md px-2 py-0.5 text-[11px] font-semibold text-white"
             >
-              {{ t(failureLabelKey(item)!) }}
+              {{ item.errorMessage ?? t(failureLabelKey(item)!) }}
             </span>
             <UButton
               v-if="item.file"
@@ -311,7 +311,7 @@ const {
             <span
               class="bg-error rounded-md px-2 py-0.5 text-[11px] font-semibold text-white"
             >
-              {{ t(failureLabelKey(singleItem)!) }}
+              {{ singleItem.errorMessage ?? t(failureLabelKey(singleItem)!) }}
             </span>
             <UButton
               v-if="singleItem.file"

package/frontend-vue/layers/dms-ui/app/components/form/components/InputAddress.vue

@@ -223,7 +223,7 @@ const mapCountryData = (item: Record<string, string>) => {
 };
 
 const { $authFetch } = useAuthFetch();
-const toast = useToast();
+const { presentError } = useApiErrorPresenter();
 
 /** The remote country list, already shaped for `USelectMenu`. */
 interface CountryOptions {
@@ -239,11 +239,7 @@ async function fetchCountryOptions(): Promise<CountryOptions> {
       q: countrySearchTermDebounced.value,
     },
     onRequestError: ({ error }: { error: Error }) => {
-      toast.add({
-        color: Color.error,
-        title: t("dms.form.error_title"),
-        description: error.message,
-      });
+      presentError(error, { fallbackKey: "dms.form.error_title" });
     },
   });
 

package/frontend-vue/layers/dms-ui/app/components/form/components/Relation.vue

@@ -130,7 +130,7 @@ const loadedFilterSource = filterSourceValue.value;
 
 const { $authFetch } = useAuthFetch();
 const { readRelationRows } = useRelationRows();
-const toast = useToast();
+const { presentError } = useApiErrorPresenter();
 const { t } = useI18n();
 const { processI18n } = useTranslation();
 const { hasPermission, loadPermissions } = usePermissions();
@@ -229,11 +229,7 @@ async function fetchRelationItems(): Promise<RelationItems> {
       ...filterParams.value,
     },
     onRequestError: ({ error }: { error: Error }) => {
-      toast.add({
-        color: Color.error,
-        title: t("dms.form.error_title"),
-        description: error.message,
-      });
+      presentError(error, { fallbackKey: "dms.form.error_title" });
     },
   });
 

package/frontend-vue/layers/dms-ui/app/components/form/components/imageItems.ts

@@ -16,6 +16,7 @@ export interface GalleryItem {
   principal: boolean;
   status: ItemStatus;
   progress: number;
+  errorMessage?: string;
 }
 
 const FAILURE_LABEL_KEYS: Partial<Record<ItemStatus, string>> = {

package/frontend-vue/layers/dms-ui/app/components/guard/Guard.vue

@@ -32,6 +32,7 @@ const props = withDefaults(defineProps<GuardProps>(), {
 });
 
 const { t } = useI18n();
+const { resolveError } = useApiErrorPresenter();
 
 const state = useGuard(
   () => props,
@@ -44,7 +45,7 @@ const DEFAULT_FALLBACKS: Record<
 > = {
   empty: () => ({ title: t("dms.blocks.empty") }),
   notFound: ({ notFound }) => ({
-    ...notFoundTexts(notFound, t),
+    ...notFoundTexts(notFound, t, resolveError),
     variant: "no-result",
   }),
 };

package/frontend-vue/layers/dms-ui/app/components/table-view/KanbanBoard.vue

@@ -23,7 +23,7 @@ import {
 import { readSubline } from "../../build/composables/data-types/cellHelpers";
 import { useComposedText } from "#dms-core/app/composables/translation/useComposedText";
 import { useCardFields } from "../../build/composables/table-view/useCardFields";
-import { describeTableWriteError } from "../../build/composables/table-view/utils/writeError";
+import { tableWriteErrorOptions } from "../../build/composables/table-view/utils/writeError";
 
 const DEFAULT_COLUMN_PAGE_SIZE = 10;
 const DEFAULT_COLUMN_MAX_HEIGHT = "60vh";
@@ -89,6 +89,7 @@ const { getDataType } = useDataTypes();
 const { t } = useI18n();
 const { processText } = useComposedText();
 const toast = useToast();
+const { presentError } = useApiErrorPresenter();
 
 const rowIdKey = computed(() => props.rowIdKey ?? DEFAULT_ROW_ID_KEY);
 const pageSize = computed(
@@ -295,14 +296,17 @@ const awaitNewerMoves = async (itemId: string, current: Promise<void>) => {
   }
 };
 
-const notifyMoveError = (
-  error: Parameters<typeof describeTableWriteError>[0],
-) => {
-  toast.add({
-    color: Color.error,
-    title: t("dms.table.kanban.move_error"),
-    description: describeTableWriteError(error, t, props.columns, processI18n),
-  });
+const notifyMoveError = (error: unknown) => {
+  presentError(
+    error,
+    tableWriteErrorOptions(
+      error,
+      t,
+      props.columns,
+      processI18n,
+      "dms.table.kanban.move_error",
+    ),
+  );
 };
 
 const onColumnChange = async (

package/frontend-vue/layers/dms-ui/app/composables/chart/types.ts

@@ -122,8 +122,18 @@ export interface TopListCardResponse {
   items: TopListItem[];
 }
 
+/** One measured group, as a data source of shape `series` answers it. */
+export interface ChartGroupPoint {
+  x: string | number;
+  y: number | null;
+}
+
+/**
+ * What a bare chart's data source answers: one point per group, the shape the
+ * block registry declares as `series`, or named series.
+ */
 export interface ChartResponse {
-  series: ChartSeries[];
+  series: ChartSeries[] | ChartGroupPoint[];
 }
 
 export type ValueFormat = "number" | "currency" | "percent" | "compact";

package/frontend-vue/layers/dms-ui/app/composables/confirm/types.ts

@@ -115,15 +115,15 @@ export interface ConfirmPartialOutcome {
 }
 
 /**
- * Thrown by `onConfirm` with a message already worded for users (a title and
- * its reason): the modal shows both in its error alert, as they are.
+ * Thrown by `onConfirm` with a fallback translation key and optional params.
+ * A translated server reason retained in `cause` takes precedence.
  */
 export class ConfirmActionError extends Error {
-  readonly description?: string;
+  readonly params?: ApiErrorParams;
 
-  constructor(notice: ConfirmNotice) {
-    super(notice.title);
-    this.description = notice.description;
+  constructor(options: ResolveApiErrorOptions, cause?: ErrorOptions) {
+    super(options.fallbackKey, cause);
+    this.params = options.params;
   }
 }
 

package/frontend-vue/layers/dms-ui/app/composables/form/useForm.ts

@@ -9,7 +9,6 @@ import {
   type ReplaceUrlVariablesContext,
   resolveLinkVariables,
 } from "../../build/utils/urlVariables";
-import { apiErrorText } from "#dms-core/app/composables/useFieldErrors";
 import type { I18nTranslate } from "#dms-core/app/composables/translation/useTranslation";
 import { isNumber } from "#dms-core/app/utils/type-check";
 import { isPlainObject } from "../../build/composables/unsaved-changes/formValue";
@@ -93,6 +92,7 @@ function createFormNotices(
   context: ReturnType<typeof createFormFields>,
   options: UseFormOptions,
 ) {
+  const { presentError, resolveError } = useApiErrorPresenter();
   const {
     props,
     toast,
@@ -143,13 +143,6 @@ function createFormNotices(
     });
   };
 
-  const resolveSubmitErrorDescription = (error: EventError) => {
-    if (props.errorMessage) return processI18n(props.errorMessage);
-    const text = apiErrorText(error);
-    if (text) return processApiMessage(text);
-    return processI18n("$dms.form.error_unknown");
-  };
-
   /** Puts a refused submit's field errors under its fields, if any. */
   const showServerFieldErrors = (
     error: Parameters<typeof resolveFormFieldErrors>[0],
@@ -165,10 +158,16 @@ function createFormNotices(
         name: entry.field,
         message: entry.values?.length
           ? t("dms.field_errors.with_values", {
-              message: processApiMessage(entry.message, entry.params),
+              message: resolveError(entry.message, {
+                fallbackKey: entry.fallbackKey ?? "dms.field_errors.invalid",
+                params: entry.params,
+              })?.message,
               values: entry.values.join(", "),
             })
-          : processApiMessage(entry.message, entry.params),
+          : (resolveError(entry.message, {
+              fallbackKey: entry.fallbackKey ?? "dms.field_errors.invalid",
+              params: entry.params,
+            })?.message ?? ""),
         values: entry.values,
         path: entry.path,
       })),
@@ -176,16 +175,15 @@ function createFormNotices(
   };
 
   const showSubmitErrorToast = (error: EventError) => {
-    toast.add({
-      title: processI18n("$dms.form.error_title"),
-      description: resolveSubmitErrorDescription(error),
-      color: Color.error,
+    presentError(error, {
+      fallbackKey: props.errorMessage || "dms.form.error_unknown",
     });
   };
 
   return {
     ...context,
     options,
+    presentError,
     showSubmitSuccessToast,
     showSubmitNotice,
     showServerFieldErrors,
@@ -278,8 +276,7 @@ function createSavedForm(context: ReturnType<typeof createFormNotices>) {
 function createFormSubmission(context: ReturnType<typeof createSavedForm>) {
   const {
     props,
-    toast,
-    processI18n,
+    presentError,
     buildUrlContext,
     showSubmitSuccessToast,
     showSubmitNotice,
@@ -307,11 +304,7 @@ function createFormSubmission(context: ReturnType<typeof createSavedForm>) {
   };
 
   const showUnresolvedTargetToast = () => {
-    toast.add({
-      title: processI18n("$dms.form.error_title"),
-      description: processI18n("$dms.form.error_no_target"),
-      color: Color.error,
-    });
+    presentError(null, { fallbackKey: "dms.form.error_no_target" });
   };
 
   /** Sends through submit events, marking accepted data clean before success. */