@djangocfg/ui-core 2.1.166 → 2.1.168

package/README.md

@@ -193,9 +193,24 @@ import '@djangocfg/ui-core/styles/globals';
 | `@djangocfg/ui-core/hooks` | Hooks only |
 | `@djangocfg/ui-core/lib` | Utilities (cn, etc.) |
 | `@djangocfg/ui-core/lib/dialog-service` | Dialog service |
+| `@djangocfg/ui-core/utils` | Runtime utilities (emitRuntimeError) |
 | `@djangocfg/ui-core/styles` | CSS |
 | `@djangocfg/ui-core/styles/palette` | Theme palette hooks & utilities |
 
+## Runtime Error Emitter
+
+Emit runtime errors as events (caught by ErrorTrackingProvider in layouts):
+
+```tsx
+import { emitRuntimeError } from '@djangocfg/ui-core/utils';
+
+try {
+  doSomething();
+} catch (error) {
+  emitRuntimeError('MyComponent', 'Operation failed', error, { extra: 'context' });
+}
+```
+
 ## What's NOT included (use ui-nextjs)
 
 These features require Next.js or browser storage APIs:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ui-core",
-  "version": "2.1.166",
+  "version": "2.1.168",
   "description": "Pure React UI component library without Next.js dependencies - for Electron, Vite, CRA apps",
   "keywords": [
     "ui-components",
@@ -53,6 +53,11 @@
       "import": "./src/lib/dialog-service/index.ts",
       "require": "./src/lib/dialog-service/index.ts"
     },
+    "./utils": {
+      "types": "./src/utils/index.ts",
+      "import": "./src/utils/index.ts",
+      "require": "./src/utils/index.ts"
+    },
     "./styles": "./src/styles/index.css",
     "./styles/globals": "./src/styles/globals.css",
     "./styles/theme": "./src/styles/theme.css",
@@ -76,7 +81,7 @@
     "playground": "playground dev"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.166",
+    "@djangocfg/i18n": "^2.1.168",
     "react-device-detect": "^2.2.3",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -138,9 +143,9 @@
     "vaul": "1.1.2"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.166",
+    "@djangocfg/i18n": "^2.1.168",
     "@djangocfg/playground": "workspace:*",
-    "@djangocfg/typescript-config": "^2.1.166",
+    "@djangocfg/typescript-config": "^2.1.168",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/snippets/index.ts

@@ -0,0 +1,10 @@
+export {
+  LazyWrapper,
+  DefaultLoader,
+  InlineLoader,
+  FullScreenLoader,
+  createLazyComponent,
+  createLazyNamedComponent,
+} from './LazyComponent';
+export type { LazyWrapperProps } from './LazyComponent';
+../utils/runtime-errors

package/src/utils/index.ts

@@ -1,9 +1 @@
-export {
-  LazyWrapper,
-  DefaultLoader,
-  InlineLoader,
-  FullScreenLoader,
-  createLazyComponent,
-  createLazyNamedComponent,
-} from './LazyComponent';
-export type { LazyWrapperProps } from './LazyComponent';
+export { emitRuntimeError, RUNTIME_ERROR_EVENT } from './runtime-errors';

package/src/utils/runtime-errors.ts

@@ -0,0 +1,49 @@
+/**
+ * Runtime Error Emitter
+ *
+ * Emits runtime errors as CustomEvents that can be caught by ErrorTrackingProvider.
+ * This is a lightweight utility with no dependencies, suitable for use in any package.
+ *
+ * @example
+ * ```ts
+ * import { emitRuntimeError } from '@djangocfg/ui-core/utils';
+ *
+ * try {
+ *   doSomething();
+ * } catch (error) {
+ *   emitRuntimeError('MyComponent', 'Failed to do something', error, { extra: 'context' });
+ * }
+ * ```
+ */
+
+/** Event name for runtime errors - must match ERROR_EVENTS.RUNTIME in layouts */
+export const RUNTIME_ERROR_EVENT = 'runtime-error';
+
+/**
+ * Emit a runtime error event
+ *
+ * @param source - Error source identifier (e.g., 'Tour', 'Form', 'API')
+ * @param message - Human-readable error message
+ * @param error - Original Error object (optional)
+ * @param context - Additional context data (optional)
+ */
+export function emitRuntimeError(
+  source: string,
+  message: string,
+  error?: Error,
+  context?: Record<string, unknown>
+): void {
+  if (typeof window === 'undefined') return;
+
+  const event = new CustomEvent(RUNTIME_ERROR_EVENT, {
+    detail: {
+      source,
+      message,
+      error,
+      context,
+      timestamp: new Date(),
+    },
+  });
+
+  window.dispatchEvent(event);
+}