@ikonai/sdk-react-ui 1.0.58 → 1.0.60

package/app/use-ikon-app.d.ts

@@ -94,6 +94,12 @@ export interface UseIkonAppResult {
      * When set, the app should show an access denied screen instead of the normal UI.
      */
     accessDeniedReason: string | null;
+    /**
+     * True when the server rejected the connection because it is at capacity (the app instance
+     * reached its maximum client limit). Terminal — the SDK does not retry. The app should show an
+     * "at capacity" message (the offline overlay) rather than a transient offline/reconnecting state.
+     */
+    isServerFull: boolean;
     /**
      * UI stores for rendering.
      */

package/debug/debug-overlay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * On-screen debug overlay, enabled with `?ikon-debug-overlay=true`.
+ *
+ * Surfaces the environment, connection-state timeline, and ALL captured JS errors + SDK log
+ * events directly on screen — invaluable for debugging on devices with no usable console
+ * (smart TVs, phones, kiosks). This is a DISTINCT opt-in from `ikon-debug` (verbose logging /
+ * devtools): debug mode does NOT force the visual overlay, since on a desktop you usually want
+ * a console, not a panel over the UI.
+ *
+ * Rendered automatically by {@link IkonApp} and the (deprecated) ConnectionStateRenderer, so
+ * apps get it for free; it returns null unless the param is set, making it zero-cost when off.
+ */
+export declare const DEBUG_OVERLAY_ENABLED: boolean;
+export interface DebugOverlayProps {
+    /** Current connection state, shown in the header. When 'connected'/'reconnecting' the panel
+     *  renders as a small collapsible corner badge instead of a full-screen panel. */
+    state?: string;
+}
+/**
+ * The overlay component. Returns null unless `?ikon-debug-overlay=true` is set.
+ */
+export declare function DebugOverlay({ state }: DebugOverlayProps): import("react/jsx-runtime").JSX.Element | null;

package/index.d.ts

@@ -17,3 +17,5 @@ export { ConnectionStateRenderer, type ConnectedRenderProps, type ConnectionStat
 export { useLazyFont, useToasts, useIkonReactive, useReactive, type Toast } from './hooks';
 export { I18nProvider, useI18n, type I18nContextValue, type I18nProviderProps } from './i18n';
 export { InspectOverlay, type InspectElementPayload } from './inspect/inspect-overlay';
+export { DebugOverlay, DEBUG_OVERLAY_ENABLED, type DebugOverlayProps } from './debug/debug-overlay';
+export { randomUuid } from '../../sdk/src/index.ts';