@viglet/viglet-design-system 2026.2.28 → 2026.2.30

package/dist/src/components/backend-status.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Centralized "is the backend reachable" indicator.
+ *
+ * - Wrap your app in `<BackendStatusProvider>` (with a health endpoint).
+ * - From your axios interceptors, call `reportBackendOffline()` when a request
+ *   fails with no response, and `reportBackendOnline()` on any success.
+ * - The provider polls the health endpoint while offline to detect recovery
+ *   and renders a sticky banner at the top of the viewport.
+ *
+ * @since 2026.2.29
+ */
+type Status = "online" | "offline" | "checking";
+/** Call from an axios response error handler when `!error.response`. */
+export declare function reportBackendOffline(): void;
+/** Call from an axios response success handler (or after a recovered request). */
+export declare function reportBackendOnline(): void;
+interface BackendStatusContextValue {
+    status: Status;
+    retry: () => void;
+}
+export declare function useBackendStatus(): BackendStatusContextValue;
+interface BackendStatusProviderProps {
+    /** Health endpoint URL polled while offline. Defaults to `/api/v2/ping`. */
+    healthEndpoint?: string;
+    /** Polling interval in ms while offline. Defaults to 5000. */
+    pollInterval?: number;
+    /** When true (default), renders the built-in sticky banner. */
+    showBanner?: boolean;
+    children: React.ReactNode;
+}
+export declare function BackendStatusProvider({ healthEndpoint, pollInterval, showBanner, children, }: Readonly<BackendStatusProviderProps>): import("react/jsx-runtime").JSX.Element;
+export declare function BackendStatusBanner(): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=backend-status.d.ts.map

package/dist/src/components/backend-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-status.d.ts","sourceRoot":"","sources":["../../../src/components/backend-status.tsx"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AAEH,KAAK,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AA8BhD,wEAAwE;AACxE,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAID,UAAU,yBAAyB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID,wBAAgB,gBAAgB,IAAI,yBAAyB,CAM5D;AAID,UAAU,0BAA0B;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,cAA+B,EAC/B,YAAmB,EACnB,UAAiB,EACjB,QAAQ,GACT,EAAE,QAAQ,CAAC,0BAA0B,CAAC,2CA+BtC;AAID,wBAAgB,mBAAmB,mDAqClC"}

package/dist/src/components/error-boundary.d.ts

@@ -0,0 +1,35 @@
+import { default as React, ErrorInfo, ReactNode } from 'react';
+/**
+ * Top-level boundary that catches React render errors and displays a friendly
+ * fallback with a reload button. Logs the stack trace to the console.
+ *
+ * Usage:
+ * ```tsx
+ * <ErrorBoundary>
+ *   <App />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @since 2026.2.29
+ */
+interface Props {
+    children: ReactNode;
+    /** Custom fallback. Receives the captured error and a `reset()` callback. */
+    fallback?: (props: {
+        error: Error;
+        reset: () => void;
+    }) => ReactNode;
+}
+interface State {
+    hasError: boolean;
+    error?: Error;
+}
+export declare class ErrorBoundary extends React.Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    reset: () => void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/src/components/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../../src/components/error-boundary.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9D;;;;;;;;;;;;GAYG;AAEH,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,SAAS,CAAC;CACtE;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IAC9D,KAAK,EAAE,KAAK,CAAuB;IAEnC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAIpD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAKtD,KAAK,QAAO,IAAI,CAEd;IAEF,MAAM,IAAI,SAAS;CASpB"}

package/dist/src/components/index.d.ts

@@ -2,7 +2,9 @@ export * from './ui';
 export { AppFooter } from './app-footer';
 export { BadgeColorful } from './badge-colorful';
 export { BadgeLocale, getLocaleCountryCode } from './badge-locale';
+export { BackendStatusBanner, BackendStatusProvider, reportBackendOffline, reportBackendOnline, useBackendStatus, } from './backend-status';
 export { BlankSlate } from './blank-slate';
+export { ErrorBoundary } from './error-boundary';
 export { DialogDelete, type VigBlockedByItem } from './dialog.delete';
 export { GridList } from './grid.list';
 export { InternalSidebar } from './internal.sidebar';

package/dist/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/i18n/index.d.ts

@@ -105,6 +105,16 @@ export declare const vigDesignSystemTranslations: {
             openNavigation: string;
             connectionError: string;
         };
+        backendStatus: {
+            offline: string;
+            checking: string;
+            retry: string;
+        };
+        errorBoundary: {
+            title: string;
+            description: string;
+            reload: string;
+        };
     };
     pt: {
         theme: {
@@ -211,6 +221,16 @@ export declare const vigDesignSystemTranslations: {
             openNavigation: string;
             connectionError: string;
         };
+        backendStatus: {
+            offline: string;
+            checking: string;
+            retry: string;
+        };
+        errorBoundary: {
+            title: string;
+            description: string;
+            reload: string;
+        };
     };
 };
 /**

package/dist/src/i18n/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAoB3B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,0BA+BpF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,OAAO,IAAI,QAWhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAoB3B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,0BA+BpF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,OAAO,IAAI,QAWhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}