issue-sticker 0.10.0 → 0.12.0

package/dist/{three-_bdgDAmI.js → three-B228j4M6.js}

@@ -27689,8 +27689,8 @@ function registerThree(handle) {
 }
 installThreeAutoDetect();
 export {
-  Root2 as A,
-  Anchor as B,
+  Anchor as A,
+  Root2 as B,
   CANVAS_INTERACTION_TAG as C,
   DismissableLayer as D,
   Arrow as E,
@@ -27709,15 +27709,15 @@ export {
   createLucideIcon as c,
   usePortalContainer as d,
   OVERLAY_LAYER as e,
-  Primitive as f,
-  composeEventHandlers as g,
-  useDismissableLayerSurface as h,
-  useComposedRefs as i,
-  Portal as j,
-  createContextScope as k,
-  createSlot as l,
-  useControllableState as m,
-  useId as n,
+  useControllableState as f,
+  useId as g,
+  Primitive as h,
+  composeEventHandlers as i,
+  useDismissableLayerSurface as j,
+  useComposedRefs as k,
+  Portal as l,
+  createContextScope as m,
+  createSlot as n,
   useLayoutEffect2 as o,
   useCallbackRef as p,
   PortalContainerProvider as q,

package/dist/{tooltip-UijEbdDX.js → tooltip-CT7e9xbU.js}

@@ -1,6 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { P as Presence, j as Portal$1, E as Arrow, D as DismissableLayer, y as Content, G as Root, i as useComposedRefs, z as createPopperScope, k as createContextScope, H as createSlottable, n as useId, m as useControllableState, A as Root2, B as Anchor, f as Primitive, g as composeEventHandlers, d as usePortalContainer, a as cn, e as OVERLAY_LAYER, s as stopEscapePropagation } from "./three-_bdgDAmI.js";
+import { P as Presence, l as Portal$1, E as Arrow, D as DismissableLayer, y as Content, G as Root, k as useComposedRefs, z as createPopperScope, m as createContextScope, H as createSlottable, g as useId, f as useControllableState, B as Root2, A as Anchor, h as Primitive, i as composeEventHandlers, d as usePortalContainer, a as cn, e as OVERLAY_LAYER, s as stopEscapePropagation } from "./three-B228j4M6.js";
 var [createTooltipContext] = createContextScope("Tooltip", [
   createPopperScope
 ]);

package/headless.d.ts

@@ -19,6 +19,28 @@ export interface IssuePosition {
     width: number;
     height: number;
   };
+  /** 대상 요소를 다시 찾기 위한 의미 지문. 캡처가 채운다. */
+  locator?: {
+    v: number;
+    tag: string;
+    role?: string;
+    name?: string;
+    text?: string;
+    attrs?: Record<string, string>;
+    classes?: string[];
+    context?: {
+      container?: { role: string; name?: string };
+      heading?: string;
+      landmark?: string;
+      rowText?: string;
+    };
+    roleIndex?: number;
+  };
+  /** 대상 요소를 그린 UI 컴포넌트 경로(바깥→안쪽). 수집하지 못하면 없다. */
+  component?: {
+    framework: string;
+    path: string[];
+  };
 }
 
 export interface NetworkLog {
@@ -79,6 +101,21 @@ export interface IssueStickerSummary {
     readonly color: string;
     readonly label: string | null;
   } | null;
+  /** 영상 URL. 업로드 중이거나 영상이 없으면 `null` 입니다. */
+  video?: string | null;
+  /**
+   * 영상 업로드 상태. `submitDraft()` 직후에는 `'uploading'` 이고, 업로드가 끝나면
+   * `snapshot.issues` 의 같은 이슈가 `'ready'` 로 바뀝니다. 영상 URL 은 `openIssue()` 로 연
+   * `snapshot.activeIssue.video` 에서 확인합니다. 업로드를 끝내 포기하면 `'failed'` 입니다.
+   * 영상이 없으면 `null`.
+   */
+  video_status?: 'uploading' | 'ready' | 'failed' | null;
+  /**
+   * 세션 리플레이 업로드 상태. 리플레이가 있는 이슈는 `submitDraft()`·`createIssue()` 직후
+   * `'uploading'` 이고, 업로드가 끝나면 `snapshot.issues` 의 같은 이슈가 `'ready'` 로 바뀝니다.
+   * 업로드를 끝내 포기하면 `'failed'` 이고 그 이슈에는 리플레이가 없습니다. 리플레이가 없으면 `null`.
+   */
+  replay_status?: 'uploading' | 'ready' | 'failed' | null;
 }
 
 /** 상세 조회한 이슈. */
@@ -235,6 +272,28 @@ export interface HeadlessSessionReplayState {
   readonly error: string | null;
 }
 
+/** 뒤에서 올리는 영상 하나의 상태. 업로드가 끝나면 목록에서 빠집니다. */
+export interface HeadlessVideoUpload {
+  readonly issueId: string;
+  /** `failed` 는 네트워크 재시도를 모두 쓴 상태입니다. `retryVideoUpload()` 로 이어 올립니다. */
+  readonly status: 'queued' | 'uploading' | 'failed';
+  /** 0~1 */
+  readonly progress: number;
+}
+
+/** 뒤에서 올리는 세션 리플레이·웹소켓 로그 하나의 상태. 업로드가 끝나면 목록에서 빠집니다. */
+export interface HeadlessAttachmentUpload {
+  readonly issueId: string;
+  readonly kind: 'replay' | 'socket';
+  /**
+   * `failed` 는 네트워크 재시도를 모두 쓴 상태입니다. 연결이 돌아오거나 다음에 초기화할 때,
+   * 또는 `retryVideoUpload(issueId)` 를 부르면 다시 올립니다.
+   */
+  readonly status: 'queued' | 'uploading' | 'failed';
+  /** 0~1 */
+  readonly progress: number;
+}
+
 export interface HeadlessSnapshot {
   readonly phase: HeadlessPhase;
   readonly auth: HeadlessAuthState;
@@ -243,6 +302,8 @@ export interface HeadlessSnapshot {
   readonly draft: HeadlessIssueDraft | null;
   readonly videoCapture: HeadlessVideoCaptureState;
   readonly sessionReplay: HeadlessSessionReplayState;
+  readonly videoUploads: readonly HeadlessVideoUpload[];
+  readonly attachmentUploads: readonly HeadlessAttachmentUpload[];
   readonly formSchema: IssueFormSchema | null;
   readonly filterSchema: IssueFilterSchema | null;
   readonly error: IssueStickerHeadlessError | null;
@@ -307,7 +368,13 @@ export interface HeadlessClient {
   stopVideoCapture(): Promise<void>;
   setSessionReplayEnabled(enabled: boolean): void;
   cancelIssueCapture(): void;
+  /**
+   * 이슈를 생성하고 바로 돌려줍니다. 녹화 영상·세션 리플레이·웹소켓 로그는 이슈가 생성된 뒤
+   * 따로 업로드되며, 진행은 `snapshot.videoUploads`·`snapshot.attachmentUploads` 로 확인합니다.
+   */
   submitDraft(input: SubmitDraftInput): Promise<Issue>;
+  /** 이슈의 실패한 업로드(영상·세션 리플레이·웹소켓 로그)를 다시 올립니다. */
+  retryVideoUpload(issueId: string): void;
   /**
    * 유저 액션 없이 코드에서 이슈를 만듭니다. 캡처 단계를 거치지 않으므로 `phase`와
    * `draft`를 건드리지 않고, 사용자가 이슈를 작성하는 중에도 호출할 수 있습니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issue-sticker",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "IssueSticker SDK - Visual bug tracking widget for web applications",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -75,6 +75,7 @@
     "@tanstack/react-query": "^5.90.12",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "dom-accessibility-api": "^0.7.1",
     "es-toolkit": "^1.49.0",
     "framer-motion": "^12.29.2",
     "lucide-react": "^0.562.0",