@cosmicdrift/kumiko-renderer 0.365.1 → 0.366.0

package/dist/app/feature-schema.js

@@ -23,7 +23,7 @@
 //   // feature.ts  (server-only — imports defineFeature)
 //   import { taskEntity, editScreen, ... } from "./feature-schema.js";
 //   export const taskFeature = defineFeature("tasks", (r) => {
-//     r.entity("task", taskEntity);
+//     r.entity({ name: "task", ...taskEntity });
 //     r.writeHandler(...);
 //     r.screen(editScreen);
 //     ...

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

@@ -0,0 +1,25 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+export type ErrorBoundaryFallbackProps = {
+    readonly error: Error;
+    readonly reset: () => void;
+};
+export type ErrorBoundaryProps = {
+    readonly children: ReactNode;
+    readonly fallback: (props: ErrorBoundaryFallbackProps) => ReactNode;
+    /** Prefix for the logged message, e.g. "screen" or "root". */
+    readonly scope: string;
+    /** Called after the default console.error log, e.g. to forward to telemetry. */
+    readonly onError?: (error: Error, info: ErrorInfo) => void;
+};
+type ErrorBoundaryState = {
+    readonly error: Error | undefined;
+};
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(thrown: unknown): ErrorBoundaryState;
+    componentDidCatch(thrown: unknown, info: ErrorInfo): void;
+    private logCaught;
+    private reset;
+    render(): ReactNode;
+}
+export {};

package/dist/components/error-boundary.js

@@ -0,0 +1,35 @@
+import { ERROR_BOUNDARY_LOG_MARKER } from "@cosmicdrift/kumiko-types/error-boundary";
+import { Component } from "react";
+function toError(thrown) {
+    return thrown instanceof Error ? thrown : new Error(String(thrown));
+}
+export class ErrorBoundary extends Component {
+    state = { error: undefined };
+    static getDerivedStateFromError(thrown) {
+        return { error: toError(thrown) };
+    }
+    componentDidCatch(thrown, info) {
+        const error = toError(thrown);
+        this.logCaught(error, info.componentStack);
+        try {
+            this.props.onError?.(error, info);
+        }
+        catch (handlerError) {
+            // A throw escaping componentDidCatch hands the error to the next boundary up, so a broken telemetry hook would replace the screen card with the root fallback.
+            this.logCaught(toError(handlerError), "onError handler threw");
+        }
+    }
+    logCaught(error, detail) {
+        // biome-ignore lint/suspicious/noConsole: the client has no logger and the boundary must not swallow the error; the e2e fixture detects boundary failures via this exact console.error line
+        console.error(`[kumiko] ${this.props.scope} ${ERROR_BOUNDARY_LOG_MARKER}:`, error, detail);
+    }
+    reset = () => {
+        this.setState({ error: undefined });
+    };
+    render() {
+        const { error } = this.state;
+        if (error === undefined)
+            return this.props.children;
+        return this.props.fallback({ error, reset: this.reset });
+    }
+}

package/dist/i18n-defaults.js

@@ -135,6 +135,9 @@ export const kumikoDefaultTranslations = {
         "kumiko.app-boot.no-open-screen": "This app has no screen that's accessible without a role restriction.",
         "kumiko.widget.loading": "Loading…",
         "kumiko.widget.error.title": "Couldn't load.",
+        "kumiko.screen-error.title": "This screen failed to render.",
+        "kumiko.screen-error.detail": "Screen: {screen}. {message}",
+        "kumiko.screen-error.screen": "Screen: {screen}",
         "kumiko.widget.upload.uploading": "Uploading…",
         "kumiko.widget.upload.done": "Uploaded",
         "kumiko.widget.upload.error": "Failed",

package/dist/index.d.ts

@@ -33,6 +33,8 @@ export type { VariableChipsProps } from "./app/variable-chips.js";
 export { VariableChips } from "./app/variable-chips.js";
 export { evalVisibleWhen, type VisibleWhenVerdict } from "./app/visible-when.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.js";
+export type { ErrorBoundaryFallbackProps, ErrorBoundaryProps, } from "./components/error-boundary.js";
+export { ErrorBoundary } from "./components/error-boundary.js";
 export { RelatedListSection } from "./components/related-list-section.js";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./components/render-edit.js";
 export { RenderEdit } from "./components/render-edit.js";

package/dist/index.js

@@ -28,6 +28,7 @@ export { useEmbeddedScreen } from "./app/use-embedded-screen.js";
 export { VariableChips } from "./app/variable-chips.js";
 export { evalVisibleWhen } from "./app/visible-when.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.js";
+export { ErrorBoundary } from "./components/error-boundary.js";
 export { RelatedListSection } from "./components/related-list-section.js";
 export { RenderEdit } from "./components/render-edit.js";
 export { needsActionConfirm } from "./components/render-edit-action-button.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.365.1",
+  "version": "0.366.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.365.1",
-    "@cosmicdrift/kumiko-headless": "0.365.1",
-    "@cosmicdrift/kumiko-types": "0.365.1",
+    "@cosmicdrift/kumiko-framework": "0.366.0",
+    "@cosmicdrift/kumiko-headless": "0.366.0",
+    "@cosmicdrift/kumiko-types": "0.366.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.365.1"
+    "@cosmicdrift/kumiko-locale-de": "0.366.0"
   },
   "repository": {
     "type": "git",