@fz-firefly/react-plugin 0.0.0-stage → 0.2.1

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @fz-firefly/react-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+萤火虫 SDK 的 React 错误边界与根级错误处理器，供 `@fz-firefly/react` 和 `@fz-firefly/taro/react` 复用。
+
+这个包不包含任何平台 API，也不创建客户端。业务通常不需要直接安装它。
+
+## 导出
+
+- `FireflyErrorBoundary`：类组件错误边界，捕获渲染期异常并调用 `client.captureException()`。
+- `FireflyProvider` / `useFirefly`：可选的 Context 注入，方便组件里手动上报。
+- `createFireflyErrorHandlers`：生成 React 19 `createRoot` 的 `onUncaughtError` / `onCaughtError` / `onRecoverableError`。
+- `toError`：把任意抛出值转成 `Error`。

package/dist/index.cjs

@@ -0,0 +1,188 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+// src/reported.ts
+/**
+* 已经由 FireflyErrorBoundary 上报过的错误。
+*
+* React 19 的 onCaughtError 会在错误边界处理后再次回调，
+* 这里用 WeakSet 标记，避免同一条错误被上报两次。
+* WeakSet 不持有强引用，不会阻止错误对象被回收。
+*/
+const reportedErrors = /* @__PURE__ */ new WeakSet();
+/** 把错误标记为已上报。 */
+function markReported(error) {
+	if (typeof error === "object" && error !== null) reportedErrors.add(error);
+}
+/** 判断错误是否已经由 FireflyErrorBoundary 上报。 */
+function isReported(error) {
+	return typeof error === "object" && error !== null && reportedErrors.has(error);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+// src/error-boundary.ts
+/** 把任意抛出值统一成 Error，保证 fallback 与上报都能拿到 message。 */
+function toError(value) {
+	if (value instanceof Error) return value;
+	if (typeof value === "string") return new Error(value);
+	try {
+		return new Error(typeof value === "object" && value !== null ? JSON.stringify(value) : String(value));
+	} catch (_unused) {
+		return /* @__PURE__ */ new Error("Unknown error");
+	}
+}
+/**
+* React 错误边界。
+*
+* React 没有 Vue 那样的全局 errorHandler，渲染期异常只能靠错误边界捕获。
+* 组件会把错误上报到传入的 client，然后渲染 fallback。
+*
+* ```tsx
+* <FireflyErrorBoundary client={firefly.client}>
+*   <App />
+* </FireflyErrorBoundary>
+* ```
+*/
+var FireflyErrorBoundary = class extends react.Component {
+	constructor(..._args) {
+		super(..._args);
+		_defineProperty(this, "state", { error: null });
+		_defineProperty(this, "reset", () => {
+			this.setState({ error: null });
+		});
+	}
+	static getDerivedStateFromError(error) {
+		return { error: toError(error) };
+	}
+	componentDidCatch(error, info) {
+		markReported(error);
+		try {
+			this.props.client.captureException(error, _objectSpread2({ tags: { source: "react" } }, info.componentStack ? { contexts: { react: { component_stack: info.componentStack } } } : {}));
+		} catch (_unused2) {}
+	}
+	render() {
+		var _this$props$children;
+		const { error } = this.state;
+		if (!error) return (_this$props$children = this.props.children) !== null && _this$props$children !== void 0 ? _this$props$children : null;
+		const { fallback } = this.props;
+		if (typeof fallback === "function") return fallback(error, this.reset);
+		return fallback !== null && fallback !== void 0 ? fallback : null;
+	}
+};
+// src/context.ts
+/** 当前子树可用的 Firefly 客户端。 */
+const FireflyContext = (0, react.createContext)(null);
+/**
+* 把 client 放进 React Context，方便组件里用 useFirefly() 手动上报。
+*
+* 错误边界本身要求显式传 client，不依赖这个 Provider。
+*/
+function FireflyProvider(props) {
+	return (0, react.createElement)(FireflyContext.Provider, { value: props.client }, props.children);
+}
+/** 读取最近的 FireflyProvider 注入的客户端。 */
+function useFirefly() {
+	const client = (0, react.useContext)(FireflyContext);
+	if (!client) throw new Error("Firefly: useFirefly 必须在 FireflyProvider 内使用");
+	return client;
+}
+// src/root-handlers.ts
+/**
+* 创建 React 19 createRoot / hydrateRoot 的错误回调。
+*
+* ```ts
+* createRoot(root, {
+*   ...createFireflyErrorHandlers(firefly.client),
+* })
+* ```
+*
+* - onUncaughtError：没有被错误边界接住的异常；
+* - onCaughtError：被错误边界接住的异常，已由 FireflyErrorBoundary 上报的会跳过；
+* - onRecoverableError：hydration 等可恢复错误，按 warning 上报。
+*/
+function createFireflyErrorHandlers(client, options = {}) {
+	function report(error, info, level, phase) {
+		try {
+			client.captureException(error, _objectSpread2({
+				level,
+				tags: {
+					source: "react",
+					phase
+				}
+			}, info.componentStack ? { contexts: { react: { component_stack: info.componentStack } } } : {}));
+		} catch (_unused) {}
+	}
+	return {
+		onUncaughtError(error, info) {
+			report(error, info, "error", "uncaught");
+		},
+		onCaughtError(error, info) {
+			if (options.reportCaught === false) return;
+			if (isReported(error)) return;
+			report(error, info, "error", "caught");
+		},
+		onRecoverableError(error, info) {
+			report(error, info, "warning", "recoverable");
+		}
+	};
+}
+exports.FireflyErrorBoundary = FireflyErrorBoundary;
+exports.FireflyProvider = FireflyProvider;
+exports.createFireflyErrorHandlers = createFireflyErrorHandlers;
+exports.toError = toError;
+exports.useFirefly = useFirefly;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -0,0 +1,100 @@
+import { Component, ErrorInfo, ReactNode } from "react";
+import { FireflyClient, FireflyClient as FireflyClient$1 } from "@fz-firefly/core";
+/** React 错误边界收集到的组件栈。 */
+interface FireflyErrorInfo {
+  /** React 生成的组件调用栈，部分版本可能为空。 */
+  componentStack?: string | null;
+}
+/** FireflyErrorBoundary 的参数。 */
+interface FireflyErrorBoundaryProps {
+  /** 已初始化的客户端，由业务传入。 */
+  client: FireflyClient$1;
+  /** 被保护的子树。 */
+  children?: ReactNode;
+  /**
+   * 捕获错误后的兜底内容。
+   *
+   * 传函数时可以拿到错误与 reset，适合渲染「重试」按钮。
+   */
+  fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+}
+/** FireflyErrorBoundary 的内部状态。 */
+interface FireflyErrorBoundaryState {
+  /** 当前捕获到的错误；null 表示正常渲染。 */
+  error: Error | null;
+}
+/** FireflyProvider 的参数。 */
+interface FireflyProviderProps {
+  /** 已初始化的客户端。 */
+  client: FireflyClient$1;
+  children?: ReactNode;
+}
+/**
+ * React 19 createRoot / hydrateRoot 的错误回调。
+ *
+ * 结构与 react-dom 的 RootOptions 对齐，避免 SDK 直接依赖 react-dom。
+ */
+interface FireflyRootErrorHandlers {
+  /** 没有被任何错误边界捕获的异常。 */
+  onUncaughtError(error: unknown, info: FireflyErrorInfo): void;
+  /** 被错误边界捕获的异常。 */
+  onCaughtError(error: unknown, info: FireflyErrorInfo): void;
+  /** 可恢复错误，例如 hydration 不匹配。 */
+  onRecoverableError(error: unknown, info: FireflyErrorInfo): void;
+}
+/** createFireflyErrorHandlers 的可选项。 */
+interface FireflyErrorHandlerOptions {
+  /**
+   * 是否上报被错误边界捕获的异常，默认 true。
+   *
+   * FireflyErrorBoundary 已经上报过的错误会自动跳过；
+   * 如果业务自己的错误边界也会手动上报，可以设为 false 避免重复。
+   */
+  reportCaught?: boolean;
+}
+/** 把任意抛出值统一成 Error，保证 fallback 与上报都能拿到 message。 */
+export declare function toError(value: unknown): Error;
+/**
+ * React 错误边界。
+ *
+ * React 没有 Vue 那样的全局 errorHandler，渲染期异常只能靠错误边界捕获。
+ * 组件会把错误上报到传入的 client，然后渲染 fallback。
+ *
+ * ```tsx
+ * <FireflyErrorBoundary client={firefly.client}>
+ *   <App />
+ * </FireflyErrorBoundary>
+ * ```
+ */
+export declare class FireflyErrorBoundary extends Component<FireflyErrorBoundaryProps, FireflyErrorBoundaryState> {
+  state: FireflyErrorBoundaryState;
+  static getDerivedStateFromError(error: unknown): FireflyErrorBoundaryState;
+  componentDidCatch(error: Error, info: ErrorInfo): void;
+  /** 清除错误状态，让子树重新渲染。 */
+  private reset;
+  render(): ReactNode;
+}
+/**
+ * 把 client 放进 React Context，方便组件里用 useFirefly() 手动上报。
+ *
+ * 错误边界本身要求显式传 client，不依赖这个 Provider。
+ */
+export declare function FireflyProvider(props: FireflyProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<FireflyClient$1 | null>>;
+/** 读取最近的 FireflyProvider 注入的客户端。 */
+export declare function useFirefly(): FireflyClient$1;
+/**
+ * 创建 React 19 createRoot / hydrateRoot 的错误回调。
+ *
+ * ```ts
+ * createRoot(root, {
+ *   ...createFireflyErrorHandlers(firefly.client),
+ * })
+ * ```
+ *
+ * - onUncaughtError：没有被错误边界接住的异常；
+ * - onCaughtError：被错误边界接住的异常，已由 FireflyErrorBoundary 上报的会跳过；
+ * - onRecoverableError：hydration 等可恢复错误，按 warning 上报。
+ */
+export declare function createFireflyErrorHandlers(client: FireflyClient$1, options?: FireflyErrorHandlerOptions): FireflyRootErrorHandlers;
+export type { FireflyClient, FireflyErrorBoundaryProps, FireflyErrorBoundaryState, FireflyErrorHandlerOptions, FireflyErrorInfo, FireflyProviderProps, FireflyRootErrorHandlers };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+import { Component, ErrorInfo, ReactNode } from "react";
+import { FireflyClient, FireflyClient as FireflyClient$1 } from "@fz-firefly/core";
+/** React 错误边界收集到的组件栈。 */
+interface FireflyErrorInfo {
+  /** React 生成的组件调用栈，部分版本可能为空。 */
+  componentStack?: string | null;
+}
+/** FireflyErrorBoundary 的参数。 */
+interface FireflyErrorBoundaryProps {
+  /** 已初始化的客户端，由业务传入。 */
+  client: FireflyClient$1;
+  /** 被保护的子树。 */
+  children?: ReactNode;
+  /**
+   * 捕获错误后的兜底内容。
+   *
+   * 传函数时可以拿到错误与 reset，适合渲染「重试」按钮。
+   */
+  fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+}
+/** FireflyErrorBoundary 的内部状态。 */
+interface FireflyErrorBoundaryState {
+  /** 当前捕获到的错误；null 表示正常渲染。 */
+  error: Error | null;
+}
+/** FireflyProvider 的参数。 */
+interface FireflyProviderProps {
+  /** 已初始化的客户端。 */
+  client: FireflyClient$1;
+  children?: ReactNode;
+}
+/**
+ * React 19 createRoot / hydrateRoot 的错误回调。
+ *
+ * 结构与 react-dom 的 RootOptions 对齐，避免 SDK 直接依赖 react-dom。
+ */
+interface FireflyRootErrorHandlers {
+  /** 没有被任何错误边界捕获的异常。 */
+  onUncaughtError(error: unknown, info: FireflyErrorInfo): void;
+  /** 被错误边界捕获的异常。 */
+  onCaughtError(error: unknown, info: FireflyErrorInfo): void;
+  /** 可恢复错误，例如 hydration 不匹配。 */
+  onRecoverableError(error: unknown, info: FireflyErrorInfo): void;
+}
+/** createFireflyErrorHandlers 的可选项。 */
+interface FireflyErrorHandlerOptions {
+  /**
+   * 是否上报被错误边界捕获的异常，默认 true。
+   *
+   * FireflyErrorBoundary 已经上报过的错误会自动跳过；
+   * 如果业务自己的错误边界也会手动上报，可以设为 false 避免重复。
+   */
+  reportCaught?: boolean;
+}
+/** 把任意抛出值统一成 Error，保证 fallback 与上报都能拿到 message。 */
+export declare function toError(value: unknown): Error;
+/**
+ * React 错误边界。
+ *
+ * React 没有 Vue 那样的全局 errorHandler，渲染期异常只能靠错误边界捕获。
+ * 组件会把错误上报到传入的 client，然后渲染 fallback。
+ *
+ * ```tsx
+ * <FireflyErrorBoundary client={firefly.client}>
+ *   <App />
+ * </FireflyErrorBoundary>
+ * ```
+ */
+export declare class FireflyErrorBoundary extends Component<FireflyErrorBoundaryProps, FireflyErrorBoundaryState> {
+  state: FireflyErrorBoundaryState;
+  static getDerivedStateFromError(error: unknown): FireflyErrorBoundaryState;
+  componentDidCatch(error: Error, info: ErrorInfo): void;
+  /** 清除错误状态，让子树重新渲染。 */
+  private reset;
+  render(): ReactNode;
+}
+/**
+ * 把 client 放进 React Context，方便组件里用 useFirefly() 手动上报。
+ *
+ * 错误边界本身要求显式传 client，不依赖这个 Provider。
+ */
+export declare function FireflyProvider(props: FireflyProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<FireflyClient$1 | null>>;
+/** 读取最近的 FireflyProvider 注入的客户端。 */
+export declare function useFirefly(): FireflyClient$1;
+/**
+ * 创建 React 19 createRoot / hydrateRoot 的错误回调。
+ *
+ * ```ts
+ * createRoot(root, {
+ *   ...createFireflyErrorHandlers(firefly.client),
+ * })
+ * ```
+ *
+ * - onUncaughtError：没有被错误边界接住的异常；
+ * - onCaughtError：被错误边界接住的异常，已由 FireflyErrorBoundary 上报的会跳过；
+ * - onRecoverableError：hydration 等可恢复错误，按 warning 上报。
+ */
+export declare function createFireflyErrorHandlers(client: FireflyClient$1, options?: FireflyErrorHandlerOptions): FireflyRootErrorHandlers;
+export type { FireflyClient, FireflyErrorBoundaryProps, FireflyErrorBoundaryState, FireflyErrorHandlerOptions, FireflyErrorInfo, FireflyProviderProps, FireflyRootErrorHandlers };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,183 @@
+import { Component, createContext, createElement, useContext } from "react";
+// src/reported.ts
+/**
+* 已经由 FireflyErrorBoundary 上报过的错误。
+*
+* React 19 的 onCaughtError 会在错误边界处理后再次回调，
+* 这里用 WeakSet 标记，避免同一条错误被上报两次。
+* WeakSet 不持有强引用，不会阻止错误对象被回收。
+*/
+const reportedErrors = /* @__PURE__ */ new WeakSet();
+/** 把错误标记为已上报。 */
+function markReported(error) {
+	if (typeof error === "object" && error !== null) reportedErrors.add(error);
+}
+/** 判断错误是否已经由 FireflyErrorBoundary 上报。 */
+function isReported(error) {
+	return typeof error === "object" && error !== null && reportedErrors.has(error);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+// src/error-boundary.ts
+/** 把任意抛出值统一成 Error，保证 fallback 与上报都能拿到 message。 */
+function toError(value) {
+	if (value instanceof Error) return value;
+	if (typeof value === "string") return new Error(value);
+	try {
+		return new Error(typeof value === "object" && value !== null ? JSON.stringify(value) : String(value));
+	} catch (_unused) {
+		return /* @__PURE__ */ new Error("Unknown error");
+	}
+}
+/**
+* React 错误边界。
+*
+* React 没有 Vue 那样的全局 errorHandler，渲染期异常只能靠错误边界捕获。
+* 组件会把错误上报到传入的 client，然后渲染 fallback。
+*
+* ```tsx
+* <FireflyErrorBoundary client={firefly.client}>
+*   <App />
+* </FireflyErrorBoundary>
+* ```
+*/
+var FireflyErrorBoundary = class extends Component {
+	constructor(..._args) {
+		super(..._args);
+		_defineProperty(this, "state", { error: null });
+		_defineProperty(this, "reset", () => {
+			this.setState({ error: null });
+		});
+	}
+	static getDerivedStateFromError(error) {
+		return { error: toError(error) };
+	}
+	componentDidCatch(error, info) {
+		markReported(error);
+		try {
+			this.props.client.captureException(error, _objectSpread2({ tags: { source: "react" } }, info.componentStack ? { contexts: { react: { component_stack: info.componentStack } } } : {}));
+		} catch (_unused2) {}
+	}
+	render() {
+		var _this$props$children;
+		const { error } = this.state;
+		if (!error) return (_this$props$children = this.props.children) !== null && _this$props$children !== void 0 ? _this$props$children : null;
+		const { fallback } = this.props;
+		if (typeof fallback === "function") return fallback(error, this.reset);
+		return fallback !== null && fallback !== void 0 ? fallback : null;
+	}
+};
+// src/context.ts
+/** 当前子树可用的 Firefly 客户端。 */
+const FireflyContext = createContext(null);
+/**
+* 把 client 放进 React Context，方便组件里用 useFirefly() 手动上报。
+*
+* 错误边界本身要求显式传 client，不依赖这个 Provider。
+*/
+function FireflyProvider(props) {
+	return createElement(FireflyContext.Provider, { value: props.client }, props.children);
+}
+/** 读取最近的 FireflyProvider 注入的客户端。 */
+function useFirefly() {
+	const client = useContext(FireflyContext);
+	if (!client) throw new Error("Firefly: useFirefly 必须在 FireflyProvider 内使用");
+	return client;
+}
+// src/root-handlers.ts
+/**
+* 创建 React 19 createRoot / hydrateRoot 的错误回调。
+*
+* ```ts
+* createRoot(root, {
+*   ...createFireflyErrorHandlers(firefly.client),
+* })
+* ```
+*
+* - onUncaughtError：没有被错误边界接住的异常；
+* - onCaughtError：被错误边界接住的异常，已由 FireflyErrorBoundary 上报的会跳过；
+* - onRecoverableError：hydration 等可恢复错误，按 warning 上报。
+*/
+function createFireflyErrorHandlers(client, options = {}) {
+	function report(error, info, level, phase) {
+		try {
+			client.captureException(error, _objectSpread2({
+				level,
+				tags: {
+					source: "react",
+					phase
+				}
+			}, info.componentStack ? { contexts: { react: { component_stack: info.componentStack } } } : {}));
+		} catch (_unused) {}
+	}
+	return {
+		onUncaughtError(error, info) {
+			report(error, info, "error", "uncaught");
+		},
+		onCaughtError(error, info) {
+			if (options.reportCaught === false) return;
+			if (isReported(error)) return;
+			report(error, info, "error", "caught");
+		},
+		onRecoverableError(error, info) {
+			report(error, info, "warning", "recoverable");
+		}
+	};
+}
+export { FireflyErrorBoundary, FireflyProvider, createFireflyErrorHandlers, toError, useFirefly };
+
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@fz-firefly/react-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.1",
+  "description": "萤火虫 SDK 的 React 错误边界与根级错误处理器（内部包）。",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fz-firefly/core": "0.2.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsdown": "0.23.2",
+    "typescript": "^5.6.0",
+    "vitest": "^5.0.5"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }