@rscc/common-react 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeonghyeon-Ryu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @rscc/common-react
+
+RSCC 공통 React 훅 — `useDebounce`, `useSse`. [@rscc/common-core](https://www.npmjs.com/package/@rscc/common-core) 의 SSE 파서(`readSseStream`)를 React 상태로 래핑한다.
+
+## 설치
+
+```bash
+npm i @rscc/common-react
+```
+
+- **peerDependencies: `react >= 18`** — 소비 앱이 직접 설치
+- `@rscc/common-core` 는 `^` 범위 의존으로 함께 설치된다 (두 패키지는 락스텝 버전)
+- **Node >= 18**, ESM + CJS 듀얼 빌드, 타입 선언 동봉
+
+## 훅
+
+| 훅 | 시그니처 | 설명 |
+|---|---|---|
+| `useDebounce` | `useDebounce<T>(value, delayMs = 200): T` | 마지막 안정 값만 통과 — 자동완성 API 호출 절감 |
+| `useSse` | `useSse(options?)` → `{ start, cancel, text, sources, conversationId, error, isStreaming }` | SSE 구독 상태 훅 — 언마운트 시 자동 중단 |
+
+## 사용 예시
+
+### useDebounce
+
+```ts
+import { useDebounce } from "@rscc/common-react";
+
+const debounced = useDebounce(keyword, 200);
+// debounced 가 바뀔 때만 자동완성 API 호출
+```
+
+### useSse
+
+```ts
+import { useSse } from "@rscc/common-react";
+
+const { start, cancel, text, sources, conversationId, error, isStreaming } = useSse();
+
+await start("/api/v1/chat/stream", { method: "POST", headers, body });
+// text: delta 누적 텍스트, sources: RAG 근거, error: in-band 오류 메시지
+// cancel(): 중단 — 그때까지의 text 는 보존되고 error 는 남지 않는다
+```
+
+- 구독 전 검증 실패(`!res.ok`)는 응답 봉투의 `message` 를 `error` 로 노출한다.
+- `start` 재호출 시 이전 스트림을 중단하고 상태를 초기화한다.
+- 한계: `[DONE]` 정상 종료와 끊긴 스트림을 구분하는 신호가 없다 — 둘 다 `isStreaming=false`, `error=null` 로 끝난다.
+
+## 문서 / 저장소
+
+- 상세 문서: [js/README.md](https://github.com/Jeonghyeon-Ryu/r-common/blob/master/js/README.md)
+- SSE 프레임 계약: [contracts/sse-frames.md](https://github.com/Jeonghyeon-Ryu/r-common/blob/master/contracts/sse-frames.md)
+- 저장소: [Jeonghyeon-Ryu/r-common](https://github.com/Jeonghyeon-Ryu/r-common) · MIT

package/dist/index.cjs

@@ -0,0 +1,152 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  useDebounce: () => useDebounce,
+  useSse: () => useSse
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/useDebounce.ts
+var import_react = require("react");
+function useDebounce(value, delayMs = 200) {
+  const [debounced, setDebounced] = (0, import_react.useState)(value);
+  (0, import_react.useEffect)(() => {
+    const t = setTimeout(() => setDebounced(value), delayMs);
+    return () => clearTimeout(t);
+  }, [value, delayMs]);
+  return debounced;
+}
+
+// src/useSse.ts
+var import_react2 = require("react");
+var import_common_core = require("@rscc/common-core");
+var RECONNECT_MARKER = new Error("rscc-sse-reconnect");
+function useSse(options = {}) {
+  const { fetchImpl, reconnect } = options;
+  const [text, setText] = (0, import_react2.useState)("");
+  const [sources, setSources] = (0, import_react2.useState)(null);
+  const [conversationId, setConversationId] = (0, import_react2.useState)(null);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const [isStreaming, setIsStreaming] = (0, import_react2.useState)(false);
+  const [finishReason, setFinishReason] = (0, import_react2.useState)(null);
+  const abortRef = (0, import_react2.useRef)(null);
+  const cancel = (0, import_react2.useCallback)(() => {
+    abortRef.current?.abort();
+  }, []);
+  const start = (0, import_react2.useCallback)(
+    async (url, init) => {
+      abortRef.current?.abort();
+      const controller = new AbortController();
+      abortRef.current = controller;
+      const resetStreamState = () => {
+        setText("");
+        setSources(null);
+        setConversationId(null);
+        setError(null);
+      };
+      resetStreamState();
+      setFinishReason(null);
+      setIsStreaming(true);
+      const fetchFn = fetchImpl ?? globalThis.fetch;
+      let reason = "interrupted";
+      const attemptStream = async (attempt) => {
+        if (attempt > 0) resetStreamState();
+        let done = false;
+        let sawErrorFrame = false;
+        let streamStarted = false;
+        try {
+          const res = await fetchFn(url, { ...init, signal: controller.signal });
+          if (!res.ok) {
+            const json = await res.json().catch(() => null);
+            setError(typeof json?.message === "string" ? json.message : `HTTP ${res.status}`);
+            return;
+          }
+          streamStarted = true;
+          await (0, import_common_core.readSseStream)(res, {
+            onConversationId: setConversationId,
+            onSources: setSources,
+            onDelta: (d) => setText((prev) => prev + d),
+            onError: (m) => {
+              sawErrorFrame = true;
+              setError(m);
+            },
+            onDone: () => {
+              done = true;
+            }
+          });
+        } catch (err) {
+          if (controller.signal.aborted) {
+            reason = "aborted";
+            return;
+          }
+          setError(err instanceof Error ? err.message : String(err));
+          if (streamStarted && !sawErrorFrame && reconnect) throw RECONNECT_MARKER;
+          return;
+        }
+        if (controller.signal.aborted) {
+          reason = "aborted";
+          return;
+        }
+        if (done) {
+          reason = "done";
+          return;
+        }
+        if (!sawErrorFrame && reconnect) throw RECONNECT_MARKER;
+      };
+      try {
+        if (reconnect) {
+          await (0, import_common_core.retry)(attemptStream, {
+            retries: reconnect.retries ?? 3,
+            minDelayMs: reconnect.minDelayMs ?? 1e3,
+            maxDelayMs: reconnect.maxDelayMs ?? 15e3,
+            factor: reconnect.factor ?? 2,
+            jitter: reconnect.jitter ?? true,
+            shouldRetry: (e) => e === RECONNECT_MARKER,
+            signal: controller.signal
+          });
+        } else {
+          await attemptStream(0);
+        }
+      } catch (err) {
+        if (controller.signal.aborted) {
+          reason = "aborted";
+        } else if (err !== RECONNECT_MARKER) {
+          setError(err instanceof Error ? err.message : String(err));
+        }
+      } finally {
+        if (abortRef.current === controller) {
+          abortRef.current = null;
+          setIsStreaming(false);
+          setFinishReason(reason);
+        }
+      }
+    },
+    [fetchImpl, reconnect]
+  );
+  (0, import_react2.useEffect)(() => () => abortRef.current?.abort(), []);
+  return { start, cancel, text, sources, conversationId, error, isStreaming, finishReason };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDebounce,
+  useSse
+});

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+import { SseSource } from '@rscc/common-core';
+
+/**
+ * value 가 delayMs(ms) 동안 더 이상 바뀌지 않으면 그 값을 반환한다.
+ * 빠른 연속 입력(타이핑)에서 마지막 안정된 값만 통과시켜 자동완성 호출 수를 줄인다.
+ */
+declare function useDebounce<T>(value: T, delayMs?: number): T;
+
+/**
+ * 직전 스트림의 종료 사유.
+ *
+ * - `'done'`: [DONE] 종료 마커 수신 (in-band error 프레임 후의 [DONE] 도 포함 —
+ *   error 상태와 공존).
+ * - `'aborted'`: cancel() / 새 start() 대체 / 언마운트로 인한 중단.
+ * - `'interrupted'`: [DONE] 없이 끝난 모든 비정상 종료 — 무언 EOF, 전송 오류,
+ *   구독 전 검증 실패(!res.ok) 포함.
+ */
+type SseFinishReason = "done" | "aborted" | "interrupted";
+/**
+ * 자동 재연결 옵션 (core retry() 의 백오프 파라미터 부분집합).
+ *
+ * 재연결 트리거는 "스트림 시작(res.ok) 후 [DONE] 없이 끊긴 경우"뿐이다 —
+ * 'done'/'aborted'/구독 전 실패(!res.ok)/in-band error 프레임 종료는 서버 의도로
+ * 보고 재연결하지 않는다. 각 시도는 **전체 재요청**이며 직전 시도의
+ * text/sources/conversationId/error 상태를 초기화한다 (중복 누적 방지).
+ * 이어받기(Last-Event-ID)는 비범위 — sse-frames.md 가 `event:`/`id:`/`retry:`
+ * 필드를 사용하지 않는다고 명시하므로 재개 지점이 존재하지 않는다.
+ */
+interface SseReconnectOptions {
+    /** 최대 재연결 시도 횟수 (총 연결 = retries + 1). 기본 3. */
+    retries?: number;
+    /** 백오프 base(ms). 기본 1000. */
+    minDelayMs?: number;
+    /** 회당 대기 상한(ms). 기본 15000. */
+    maxDelayMs?: number;
+    /** 지수 배수. 기본 2. */
+    factor?: number;
+    /** full jitter 적용 여부. 기본 true. */
+    jitter?: boolean;
+}
+interface UseSseOptions {
+    /** fetch 구현체 주입 (테스트용). 기본 globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /**
+     * 자동 재연결 — 기본 undefined = off (옵트인. 비멱등 POST 스트림은 전체 재요청이
+     * 서버 측 중복 생성으로 이어질 수 있으므로 멱등성이 보장될 때만 켤 것).
+     */
+    reconnect?: SseReconnectOptions;
+}
+interface UseSseReturn {
+    /**
+     * SSE 스트림 구독 시작. 이전 스트림이 진행 중이면 중단 후 상태를 초기화한다.
+     * 반환 Promise 는 스트림 종료([DONE]/중단/오류) 시 resolve — 오류는 error 상태로 노출되며 reject 하지 않는다.
+     */
+    start: (url: string, init?: RequestInit) => Promise<void>;
+    /** 진행 중인 스트림 중단. */
+    cancel: () => void;
+    /** delta 프레임 누적 텍스트. */
+    text: string;
+    /** sources 프레임 (RAG 근거). 미수신 시 null. */
+    sources: SseSource[] | null;
+    /** conversationId 프레임 값. 미수신 시 null. */
+    conversationId: number | null;
+    /** in-band error 프레임 메시지 또는 구독 전/전송 오류 메시지. */
+    error: string | null;
+    isStreaming: boolean;
+    /** 직전 스트림의 종료 사유. 스트리밍 중/시작 전엔 null. */
+    finishReason: SseFinishReason | null;
+}
+/**
+ * @rscc/common-core 의 readSseStream 을 감싼 상태 훅 (contracts/sse-frames.md).
+ *
+ * - 구독 전 검증 실패(!res.ok — CommonResponse JSON 에러 경로)는 봉투의 message 를 error 로 노출.
+ * - 스트림 시작 후 오류는 in-band error 프레임으로 수신되어 동일하게 error 로 노출.
+ * - 언마운트 시 진행 중 스트림을 자동 중단한다.
+ * - 종료 사유는 finishReason 으로 구분한다 — 'done'([DONE] 수신) / 'aborted'(중단) /
+ *   'interrupted'([DONE] 없이 끊김). reconnect 옵트인 시 'interrupted' 성 종료 중
+ *   "스트림 시작 후 끊김"만 지수 백오프로 전체 재요청한다 ({@link SseReconnectOptions}).
+ */
+declare function useSse(options?: UseSseOptions): UseSseReturn;
+
+export { type SseFinishReason, type SseReconnectOptions, type UseSseOptions, type UseSseReturn, useDebounce, useSse };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import { SseSource } from '@rscc/common-core';
+
+/**
+ * value 가 delayMs(ms) 동안 더 이상 바뀌지 않으면 그 값을 반환한다.
+ * 빠른 연속 입력(타이핑)에서 마지막 안정된 값만 통과시켜 자동완성 호출 수를 줄인다.
+ */
+declare function useDebounce<T>(value: T, delayMs?: number): T;
+
+/**
+ * 직전 스트림의 종료 사유.
+ *
+ * - `'done'`: [DONE] 종료 마커 수신 (in-band error 프레임 후의 [DONE] 도 포함 —
+ *   error 상태와 공존).
+ * - `'aborted'`: cancel() / 새 start() 대체 / 언마운트로 인한 중단.
+ * - `'interrupted'`: [DONE] 없이 끝난 모든 비정상 종료 — 무언 EOF, 전송 오류,
+ *   구독 전 검증 실패(!res.ok) 포함.
+ */
+type SseFinishReason = "done" | "aborted" | "interrupted";
+/**
+ * 자동 재연결 옵션 (core retry() 의 백오프 파라미터 부분집합).
+ *
+ * 재연결 트리거는 "스트림 시작(res.ok) 후 [DONE] 없이 끊긴 경우"뿐이다 —
+ * 'done'/'aborted'/구독 전 실패(!res.ok)/in-band error 프레임 종료는 서버 의도로
+ * 보고 재연결하지 않는다. 각 시도는 **전체 재요청**이며 직전 시도의
+ * text/sources/conversationId/error 상태를 초기화한다 (중복 누적 방지).
+ * 이어받기(Last-Event-ID)는 비범위 — sse-frames.md 가 `event:`/`id:`/`retry:`
+ * 필드를 사용하지 않는다고 명시하므로 재개 지점이 존재하지 않는다.
+ */
+interface SseReconnectOptions {
+    /** 최대 재연결 시도 횟수 (총 연결 = retries + 1). 기본 3. */
+    retries?: number;
+    /** 백오프 base(ms). 기본 1000. */
+    minDelayMs?: number;
+    /** 회당 대기 상한(ms). 기본 15000. */
+    maxDelayMs?: number;
+    /** 지수 배수. 기본 2. */
+    factor?: number;
+    /** full jitter 적용 여부. 기본 true. */
+    jitter?: boolean;
+}
+interface UseSseOptions {
+    /** fetch 구현체 주입 (테스트용). 기본 globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /**
+     * 자동 재연결 — 기본 undefined = off (옵트인. 비멱등 POST 스트림은 전체 재요청이
+     * 서버 측 중복 생성으로 이어질 수 있으므로 멱등성이 보장될 때만 켤 것).
+     */
+    reconnect?: SseReconnectOptions;
+}
+interface UseSseReturn {
+    /**
+     * SSE 스트림 구독 시작. 이전 스트림이 진행 중이면 중단 후 상태를 초기화한다.
+     * 반환 Promise 는 스트림 종료([DONE]/중단/오류) 시 resolve — 오류는 error 상태로 노출되며 reject 하지 않는다.
+     */
+    start: (url: string, init?: RequestInit) => Promise<void>;
+    /** 진행 중인 스트림 중단. */
+    cancel: () => void;
+    /** delta 프레임 누적 텍스트. */
+    text: string;
+    /** sources 프레임 (RAG 근거). 미수신 시 null. */
+    sources: SseSource[] | null;
+    /** conversationId 프레임 값. 미수신 시 null. */
+    conversationId: number | null;
+    /** in-band error 프레임 메시지 또는 구독 전/전송 오류 메시지. */
+    error: string | null;
+    isStreaming: boolean;
+    /** 직전 스트림의 종료 사유. 스트리밍 중/시작 전엔 null. */
+    finishReason: SseFinishReason | null;
+}
+/**
+ * @rscc/common-core 의 readSseStream 을 감싼 상태 훅 (contracts/sse-frames.md).
+ *
+ * - 구독 전 검증 실패(!res.ok — CommonResponse JSON 에러 경로)는 봉투의 message 를 error 로 노출.
+ * - 스트림 시작 후 오류는 in-band error 프레임으로 수신되어 동일하게 error 로 노출.
+ * - 언마운트 시 진행 중 스트림을 자동 중단한다.
+ * - 종료 사유는 finishReason 으로 구분한다 — 'done'([DONE] 수신) / 'aborted'(중단) /
+ *   'interrupted'([DONE] 없이 끊김). reconnect 옵트인 시 'interrupted' 성 종료 중
+ *   "스트림 시작 후 끊김"만 지수 백오프로 전체 재요청한다 ({@link SseReconnectOptions}).
+ */
+declare function useSse(options?: UseSseOptions): UseSseReturn;
+
+export { type SseFinishReason, type SseReconnectOptions, type UseSseOptions, type UseSseReturn, useDebounce, useSse };

package/dist/index.js

@@ -0,0 +1,124 @@
+// src/useDebounce.ts
+import { useEffect, useState } from "react";
+function useDebounce(value, delayMs = 200) {
+  const [debounced, setDebounced] = useState(value);
+  useEffect(() => {
+    const t = setTimeout(() => setDebounced(value), delayMs);
+    return () => clearTimeout(t);
+  }, [value, delayMs]);
+  return debounced;
+}
+
+// src/useSse.ts
+import { useCallback, useEffect as useEffect2, useRef, useState as useState2 } from "react";
+import { readSseStream, retry } from "@rscc/common-core";
+var RECONNECT_MARKER = new Error("rscc-sse-reconnect");
+function useSse(options = {}) {
+  const { fetchImpl, reconnect } = options;
+  const [text, setText] = useState2("");
+  const [sources, setSources] = useState2(null);
+  const [conversationId, setConversationId] = useState2(null);
+  const [error, setError] = useState2(null);
+  const [isStreaming, setIsStreaming] = useState2(false);
+  const [finishReason, setFinishReason] = useState2(null);
+  const abortRef = useRef(null);
+  const cancel = useCallback(() => {
+    abortRef.current?.abort();
+  }, []);
+  const start = useCallback(
+    async (url, init) => {
+      abortRef.current?.abort();
+      const controller = new AbortController();
+      abortRef.current = controller;
+      const resetStreamState = () => {
+        setText("");
+        setSources(null);
+        setConversationId(null);
+        setError(null);
+      };
+      resetStreamState();
+      setFinishReason(null);
+      setIsStreaming(true);
+      const fetchFn = fetchImpl ?? globalThis.fetch;
+      let reason = "interrupted";
+      const attemptStream = async (attempt) => {
+        if (attempt > 0) resetStreamState();
+        let done = false;
+        let sawErrorFrame = false;
+        let streamStarted = false;
+        try {
+          const res = await fetchFn(url, { ...init, signal: controller.signal });
+          if (!res.ok) {
+            const json = await res.json().catch(() => null);
+            setError(typeof json?.message === "string" ? json.message : `HTTP ${res.status}`);
+            return;
+          }
+          streamStarted = true;
+          await readSseStream(res, {
+            onConversationId: setConversationId,
+            onSources: setSources,
+            onDelta: (d) => setText((prev) => prev + d),
+            onError: (m) => {
+              sawErrorFrame = true;
+              setError(m);
+            },
+            onDone: () => {
+              done = true;
+            }
+          });
+        } catch (err) {
+          if (controller.signal.aborted) {
+            reason = "aborted";
+            return;
+          }
+          setError(err instanceof Error ? err.message : String(err));
+          if (streamStarted && !sawErrorFrame && reconnect) throw RECONNECT_MARKER;
+          return;
+        }
+        if (controller.signal.aborted) {
+          reason = "aborted";
+          return;
+        }
+        if (done) {
+          reason = "done";
+          return;
+        }
+        if (!sawErrorFrame && reconnect) throw RECONNECT_MARKER;
+      };
+      try {
+        if (reconnect) {
+          await retry(attemptStream, {
+            retries: reconnect.retries ?? 3,
+            minDelayMs: reconnect.minDelayMs ?? 1e3,
+            maxDelayMs: reconnect.maxDelayMs ?? 15e3,
+            factor: reconnect.factor ?? 2,
+            jitter: reconnect.jitter ?? true,
+            shouldRetry: (e) => e === RECONNECT_MARKER,
+            signal: controller.signal
+          });
+        } else {
+          await attemptStream(0);
+        }
+      } catch (err) {
+        if (controller.signal.aborted) {
+          reason = "aborted";
+        } else if (err !== RECONNECT_MARKER) {
+          setError(err instanceof Error ? err.message : String(err));
+        }
+      } finally {
+        if (abortRef.current === controller) {
+          abortRef.current = null;
+          setIsStreaming(false);
+          setFinishReason(reason);
+        }
+      }
+    },
+    [fetchImpl, reconnect]
+  );
+  useEffect2(() => () => abortRef.current?.abort(), []);
+  return { start, cancel, text, sources, conversationId, error, isStreaming, finishReason };
+}
+export {
+  useDebounce,
+  useSse
+};

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@rscc/common-react",
+  "version": "0.1.2",
+  "description": "RSCC 공통 React 훅 — useDebounce, useSse (@rscc/common-core 의 SSE 파서 래핑).",
+  "keywords": [
+    "rscc",
+    "react",
+    "hooks",
+    "sse",
+    "use-sse",
+    "use-debounce",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Jeonghyeon-Ryu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jeonghyeon-Ryu/r-common.git",
+    "directory": "js/packages/common-react"
+  },
+  "homepage": "https://github.com/Jeonghyeon-Ryu/r-common/tree/master/js/packages/common-react",
+  "bugs": {
+    "url": "https://github.com/Jeonghyeon-Ryu/r-common/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@rscc/common-core": "^0.1.2"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}