@poveste/shared 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './codegen/index.js';
 export * from './setup.js';
 export * from './state.js';
+export * from './story-error.js';
 export * from './story.js';
 export * from './type-utils.js';
 export * from './types/index.js';

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './codegen/index.js';
 export * from './setup.js';
 export * from './state.js';
+export * from './story-error.js';
 export * from './story.js';
 export * from './type-utils.js';
 export * from './types/index.js';

package/dist/story-error.d.ts

@@ -0,0 +1,13 @@
+export declare const SANDBOX_ERROR = "__poveste:sandbox-error";
+export interface StoryError {
+    message: string;
+    stack?: string;
+    /**
+     * Which occupant threw. A warm realm is retargeted rather than reloaded
+     * (#240), so the host has to reject a report from the previous one.
+     */
+    storyId?: string;
+    variantId?: string;
+}
+export declare function toStoryError(error: unknown): Pick<StoryError, 'message' | 'stack'>;
+export declare function reportStoryError(error: unknown, occupant?: Pick<StoryError, 'storyId' | 'variantId'>): void;

package/dist/story-error.js

@@ -0,0 +1,30 @@
+// A story whose component throws still renders — Vue routes the error to
+// `console.error` and leaves the template on screen, so the book shows a broken
+// component as if it worked (#323). Nothing in the app can observe that on its
+// own: the throw never reaches `window.onerror`, so it has to be reported from
+// inside the framework that swallowed it.
+//
+// This lives in `shared` because both the app and every plugin can import it,
+// which keeps the sandbox-to-host contract in one place.
+export const SANDBOX_ERROR = '__poveste:sandbox-error';
+export function toStoryError(error) {
+    if (error instanceof Error) {
+        return { message: error.message || String(error), stack: error.stack };
+    }
+    return { message: typeof error === 'string' ? error : String(error) };
+}
+// Reports from inside the sandbox to the host. A no-op outside one, so a plugin
+// can call it unconditionally — stories also render in the host document
+// itself, where there is no parent to tell.
+export function reportStoryError(error, occupant = {}) {
+    if (typeof window === 'undefined' || !window.parent || window.parent === window) {
+        return;
+    }
+    const payload = { ...toStoryError(error), ...occupant };
+    try {
+        window.parent.postMessage({ type: SANDBOX_ERROR, ...payload }, window.location.origin);
+    }
+    catch {
+        // Reporting a failure must not become one.
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@poveste/shared",
   "type": "module",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared utilities for Poveste",
   "author": {
     "name": "Sorin Gitlan"
@@ -44,7 +44,7 @@
     "pathe": "^1.1.2",
     "picocolors": "^1.1.1",
     "unhead": "^3.1.0",
-    "@poveste/vendors": "^0.7.0"
+    "@poveste/vendors": "^0.8.0"
   },
   "devDependencies": {
     "typescript": "5.6.3",