tycho-components 0.41.6 → 0.42.0

package/dist/common/AppToast/AppToast.js

@@ -79,35 +79,33 @@ export default function AppToast() {
         }
     }, [state.toastLoading, state.toastLoadingText]);
     useEffect(() => {
-        if (state.message && state.message.value !== '') {
-            const persistent = state.message.autoClose === false;
-            const toastOptions = {
-                onClose: () => handleClose(),
-                onClick: () => handleToastAction(),
-                ...(persistent
-                    ? { autoClose: false, closeOnClick: false }
-                    : {}),
-                ...(state.message.action === 'report'
-                    ? { bodyClassName: 'toast-report-action' }
-                    : {}),
-            };
-            switch (state.message.type) {
-                case 'error':
-                    toast.error(state.message.value, toastOptions);
-                    break;
-                case 'warning':
-                    toast.warning(state.message.value, toastOptions);
-                    break;
-                case 'success':
-                    toast.success(state.message.value, toastOptions);
-                    break;
-                default:
-                    toast(state.message.value, toastOptions);
-                    break;
-            }
+        if (!state.message?.value) {
+            return;
         }
-        else {
-            dispatch(message(EMPTY_TOAST));
+        const persistent = state.message.autoClose === false;
+        const isReport = state.message.action === 'report';
+        const toastOptions = {
+            toastId: isReport ? 'tycho-error-report' : undefined,
+            onClose: () => handleClose(),
+            onClick: () => handleToastAction(),
+            ...(persistent
+                ? { autoClose: false, closeOnClick: false }
+                : {}),
+            ...(isReport ? { bodyClassName: 'toast-report-action' } : {}),
+        };
+        switch (state.message.type) {
+            case 'error':
+                toast.error(state.message.value, toastOptions);
+                break;
+            case 'warning':
+                toast.warning(state.message.value, toastOptions);
+                break;
+            case 'success':
+                toast.success(state.message.value, toastOptions);
+                break;
+            default:
+                toast(state.message.value, toastOptions);
+                break;
         }
     }, [state.message]);
     return (_jsxs(_Fragment, { children: [_jsx(ToastContainer, { closeOnClick: state.message.action !== 'report' }), reportModalOpen && (_jsx(ServerErrorReport, { errorContext: reportErrorContext, corpus: state.corpus, onClose: handleReportModalClose, onSent: handleReportSent }))] }));

package/dist/common/AppToast/ToastMessage.d.ts

@@ -7,6 +7,10 @@ export type ServerErrorContext = {
     responseDescription?: string;
     requestId?: string;
     occurredAt?: string;
+    /** Distinguishes API 5xx reports from unexpected client/runtime errors. */
+    source?: 'api' | 'client';
+    /** Client/runtime stack for the report payload only (not shown in UI). */
+    stack?: string;
 };
 export default interface ToastMessage {
     value: string;

package/dist/configs/api/dispatchApiError.d.ts

@@ -1,5 +1,6 @@
 import type { AxiosResponseHeaders, RawAxiosResponseHeaders } from 'axios';
 import type { TFunction } from 'i18next';
+import type { ServerErrorContext } from '../../common/AppToast/ToastMessage';
 type DispatchApiErrorOptions = {
     err: unknown;
     t?: TFunction;
@@ -7,10 +8,16 @@ type DispatchApiErrorOptions = {
     autoClose?: boolean;
 };
 export declare function extractRequestId(headers?: RawAxiosResponseHeaders | AxiosResponseHeaders): string | undefined;
+export declare function buildClientErrorContext(err: unknown): ServerErrorContext;
 export declare function dispatchApiError({ err, t, key, autoClose, }: DispatchApiErrorOptions): void;
 /** Persistent 5xx toast that opens the server-error report modal on click. */
 export declare function dispatchServerApiError({ err, t, }: {
     err: unknown;
     t?: TFunction;
 }): void;
+/** Persistent toast for unexpected client/runtime errors; opens report modal on click. */
+export declare function dispatchClientError({ err, t, }: {
+    err: unknown;
+    t?: TFunction;
+}): void;
 export {};

package/dist/configs/api/dispatchApiError.js

@@ -30,6 +30,7 @@ export function extractRequestId(headers) {
     }
     return undefined;
 }
+const CLIENT_STACK_MAX_LENGTH = 4000;
 function buildServerErrorContext(err) {
     if (!err || typeof err !== 'object' || !('response' in err)) {
         return {};
@@ -44,6 +45,40 @@ function buildServerErrorContext(err) {
         responseDescription: typeof data?.description === 'string' ? data.description : undefined,
         requestId: extractRequestId(axiosErr.response?.headers),
         occurredAt: new Date().toISOString(),
+        source: 'api',
+    };
+}
+function normalizeToError(err) {
+    if (err instanceof Error) {
+        return err;
+    }
+    if (typeof err === 'string' && err.trim()) {
+        return new Error(err);
+    }
+    try {
+        return new Error(JSON.stringify(err));
+    }
+    catch {
+        return new Error(String(err));
+    }
+}
+function truncateStack(stack) {
+    if (!stack) {
+        return undefined;
+    }
+    if (stack.length <= CLIENT_STACK_MAX_LENGTH) {
+        return stack;
+    }
+    return `${stack.slice(0, CLIENT_STACK_MAX_LENGTH)}…`;
+}
+export function buildClientErrorContext(err) {
+    const error = normalizeToError(err);
+    return {
+        responseMessage: error.message,
+        stack: truncateStack(error.stack),
+        url: typeof window !== 'undefined' ? window.location.href : undefined,
+        occurredAt: new Date().toISOString(),
+        source: 'client',
     };
 }
 export function dispatchApiError({ err, t, key, autoClose, }) {
@@ -69,3 +104,16 @@ export function dispatchServerApiError({ err, t, }) {
         errorContext,
     }));
 }
+/** Persistent toast for unexpected client/runtime errors; opens report modal on click. */
+export function dispatchClientError({ err, t, }) {
+    const translate = t ?? i18n.t.bind(i18n);
+    const value = translate('server.error.report.prompt', { ns: 'common' });
+    const errorContext = buildClientErrorContext(err);
+    getCommonDispatch()?.(message({
+        value,
+        type: 'error',
+        autoClose: false,
+        action: 'report',
+        errorContext,
+    }));
+}

package/dist/configs/api/index.d.ts

@@ -13,6 +13,6 @@ export { applyAuthErrorHandling } from './applyAuthErrorHandling';
 export type { ApplyAuthErrorHandlingOptions, AuthErrorHandling, } from './applyAuthErrorHandling';
 export { isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, } from './apiHandledError';
 export type { ApiErrorHandled, AuthErrorHandled } from './apiHandledError';
-export { dispatchApiError, dispatchServerApiError } from './dispatchApiError';
+export { buildClientErrorContext, dispatchApiError, dispatchClientError, dispatchServerApiError, } from './dispatchApiError';
 export { resolveAccessDeniedMessage } from './resolveAccessDeniedMessage';
 export default api;

package/dist/configs/api/index.js

@@ -13,6 +13,6 @@ const api = applyAuthErrorHandling(createApiClient({ baseURL: platformApiBase })
 export { createApiClient } from './createApiClient';
 export { applyAuthErrorHandling } from './applyAuthErrorHandling';
 export { isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, } from './apiHandledError';
-export { dispatchApiError, dispatchServerApiError } from './dispatchApiError';
+export { buildClientErrorContext, dispatchApiError, dispatchClientError, dispatchServerApiError, } from './dispatchApiError';
 export { resolveAccessDeniedMessage } from './resolveAccessDeniedMessage';
 export default api;

package/dist/configs/index.d.ts

@@ -2,7 +2,7 @@ export { CommonProvider } from "./CommonContext";
 export { default as CommonContext } from "./CommonContext";
 export { default as CommonDispatchBridge } from "./CommonDispatchBridge";
 export { default as CookieStorage } from "./CookieStorage";
-export { createApiClient, applyAuthErrorHandling, dispatchApiError, dispatchServerApiError, resolveAccessDeniedMessage, isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, platformApi, parserApiBase, } from "./api";
+export { createApiClient, applyAuthErrorHandling, dispatchApiError, dispatchClientError, dispatchServerApiError, resolveAccessDeniedMessage, isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, platformApi, parserApiBase, } from "./api";
 export type { ApplyAuthErrorHandlingOptions, AuthErrorHandling, CreateApiClientOptions, ServerErrorHandling, ApiErrorHandled, AuthErrorHandled, } from "./api";
 export { getCommonDispatch, registerCommonDispatch, } from "./store/commonDispatchBridge";
 export { commonResources, featureResources, mergeResources, commonLocalization, } from "./Localization";

package/dist/configs/index.js

@@ -2,7 +2,7 @@ export { CommonProvider } from "./CommonContext";
 export { default as CommonContext } from "./CommonContext";
 export { default as CommonDispatchBridge } from "./CommonDispatchBridge";
 export { default as CookieStorage } from "./CookieStorage";
-export { createApiClient, applyAuthErrorHandling, dispatchApiError, dispatchServerApiError, resolveAccessDeniedMessage, isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, platformApi, parserApiBase, } from "./api";
+export { createApiClient, applyAuthErrorHandling, dispatchApiError, dispatchClientError, dispatchServerApiError, resolveAccessDeniedMessage, isHandledApiError, isHandledAuthError, markApiErrorHandled, markAuthErrorHandled, platformApi, parserApiBase, } from "./api";
 export { getCommonDispatch, registerCommonDispatch, } from "./store/commonDispatchBridge";
 export { commonResources, featureResources, mergeResources, commonLocalization, } from "./Localization";
 export { default as ProfileService } from "./services/ProfileService";

package/dist/configs/types/Struct.d.ts

@@ -11,8 +11,12 @@ export type Chunk = {
     f: number;
     l: number;
     t: string;
+    /** Stable chunk identity (4-char alphanumeric), mirrors token `tid`. */
+    kid?: string;
     coidx?: number[];
     ep?: boolean;
+    /** Runtime: empty-category phrase node. */
+    empty?: boolean;
 };
 export type Token = {
     p: number;

package/dist/shell/Base/ErrorBoundary.d.ts

@@ -1,5 +1,4 @@
 import { ReactNode } from 'react';
-import './style.scss';
 type Props = {
     children: ReactNode;
 };

package/dist/shell/Base/ErrorBoundary.js

@@ -1,25 +1,44 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
-import { useTranslation } from 'react-i18next';
-import { isHandledApiError } from '../../configs/api';
-import logo from './logo.png';
-import './style.scss';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { dispatchClientError, isHandledApiError } from '../../configs/api';
+/** Survives remounts; one client-report toast per full page load. */
+let globalErrorReported = false;
+function toError(reason) {
+    if (reason instanceof Error) {
+        return reason;
+    }
+    if (typeof reason === 'string' && reason.trim()) {
+        return new Error(reason);
+    }
+    try {
+        return new Error(JSON.stringify(reason));
+    }
+    catch {
+        return new Error(String(reason));
+    }
+}
 export default function ErrorBoundary({ children }) {
-    const { t } = useTranslation('base');
-    const [state, setState] = useState({
-        hasError: false,
-        error: null,
-    });
+    const listenerReadyRef = useRef(false);
     useEffect(() => {
+        if (listenerReadyRef.current) {
+            return;
+        }
+        listenerReadyRef.current = true;
         const handleError = (error) => {
-            console.error('Caught by ErrorBoundary:', error);
-            setState({ hasError: true, error });
+            if (globalErrorReported) {
+                return;
+            }
+            globalErrorReported = true;
+            const normalized = toError(error);
+            console.error('Caught by ErrorBoundary:', normalized);
+            dispatchClientError({ err: normalized });
         };
         const onUnhandledRejection = (event) => {
             if (isHandledApiError(event.reason)) {
                 event.preventDefault();
                 return;
             }
+            event.preventDefault();
             handleError(event.reason);
         };
         const onError = (event) => {
@@ -27,6 +46,7 @@ export default function ErrorBoundary({ children }) {
                 event.preventDefault();
                 return;
             }
+            event.preventDefault();
             handleError(event.error);
         };
         window.addEventListener('unhandledrejection', onUnhandledRejection);
@@ -34,10 +54,8 @@ export default function ErrorBoundary({ children }) {
         return () => {
             window.removeEventListener('unhandledrejection', onUnhandledRejection);
             window.removeEventListener('error', onError);
+            listenerReadyRef.current = false;
         };
     }, []);
-    if (state.hasError && state.error) {
-        return (_jsx("div", { className: "box-container", children: _jsxs("div", { className: "box", children: [_jsx("img", { src: logo }), _jsx("div", { className: "title", children: t('label.error.found') }), _jsx("div", { className: "message", children: state.error?.message }), _jsx("pre", { className: "error-stack", children: state.error?.stack })] }) }));
-    }
     return _jsx(_Fragment, { children: children });
 }

package/dist/shell/Base/ErrorFound.d.ts

@@ -1,2 +1,6 @@
-import './style.scss';
+import "./style.scss";
+/**
+ * React Router errorElement: template page + report toast (stack only in report payload).
+ * Does not auto-redirect on mount (that remounts failing routes like `/` → `/catalog`).
+ */
 export default function ErrorFound(): import("react").JSX.Element;

package/dist/shell/Base/ErrorFound.js

@@ -1,22 +1,64 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
-import { useTranslation } from 'react-i18next';
-import { useNavigate, useRouteError } from 'react-router-dom';
-import { Button } from 'tycho-storybook';
-import CookieStorage from '../../configs/CookieStorage';
-import logo from './logo.png';
-import './style.scss';
+import { useEffect } from "react";
+import { useTranslation } from "react-i18next";
+import { useNavigate, useRouteError } from "react-router-dom";
+import { dispatchClientError } from "../../configs/api";
+import CookieStorage from "../../configs/CookieStorage";
+import logo from "./logo.png";
+import "./style.scss";
+/** Survives remounts so context updates from the toast cannot re-dispatch forever. */
+let routeErrorReported = false;
+function toError(reason) {
+    if (reason instanceof Error) {
+        return reason;
+    }
+    if (typeof reason === "string" && reason.trim()) {
+        return new Error(reason);
+    }
+    if (reason &&
+        typeof reason === "object" &&
+        "statusText" in reason &&
+        typeof reason.statusText === "string") {
+        return new Error(reason.statusText);
+    }
+    if (reason &&
+        typeof reason === "object" &&
+        "message" in reason &&
+        typeof reason.message === "string") {
+        return new Error(reason.message);
+    }
+    try {
+        return new Error(JSON.stringify(reason));
+    }
+    catch {
+        return new Error(String(reason));
+    }
+}
+/**
+ * React Router errorElement: template page + report toast (stack only in report payload).
+ * Does not auto-redirect on mount (that remounts failing routes like `/` → `/catalog`).
+ */
 export default function ErrorFound() {
     const navigate = useNavigate();
-    const { t } = useTranslation('base');
-    const error = useRouteError();
-    const [show, setShow] = useState(false);
+    const { t } = useTranslation("base");
+    const routeError = useRouteError();
+    const error = toError(routeError);
+    useEffect(() => {
+        if (routeErrorReported) {
+            return;
+        }
+        routeErrorReported = true;
+        const id = window.setTimeout(() => {
+            dispatchClientError({ err: toError(routeError) });
+        }, 0);
+        return () => window.clearTimeout(id);
+    }, [routeError]);
     const handleRedirect = () => {
-        navigate('/', { replace: true });
+        navigate("/", { replace: true });
     };
     const handleRetry = () => {
         const redirectUri = CookieStorage.getRedirectUri();
         redirectUri ? (window.location.href = redirectUri) : handleRedirect();
     };
-    return (_jsxs("div", { className: "box-container", children: [_jsxs("div", { className: "box", children: [_jsx("img", { src: logo }), _jsx("div", { className: "title", children: t('label.error.found') }), _jsxs("div", { className: "buttons", children: [_jsx(Button, { text: t('label.retry'), size: "small", onClick: handleRetry }), _jsx(Button, { text: t('label.redirect'), size: "small", onClick: handleRedirect }), _jsx(Button, { text: t('label.error.details'), size: "small", onClick: () => setShow(!show) })] })] }), show && (_jsx("pre", { className: "error-stack", children: JSON.stringify(error, null, 2) }))] }));
+    return (_jsx("div", { className: "box-container", children: _jsxs("div", { className: "box", children: [_jsx("img", { src: logo, alt: "" }), _jsx("div", { className: "title", children: t("label.error.found") })] }) }));
 }

package/dist/shell/Base/style.scss

@@ -25,6 +25,14 @@
       margin: 16px 0px;
     }
 
+    > .message {
+      @include body-small-1;
+      color: var(--text-secondary);
+      text-align: center;
+      margin-bottom: 24px;
+      word-break: break-word;
+    }
+
     > .subtitle {
       @include label-medium-1;
       color: var(text-secondary);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tycho-components",
   "private": false,
-  "version": "0.41.6",
+  "version": "0.42.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {