issue-sticker 0.4.0 → 0.6.0

package/dist/{tooltip-CEc_RGfI.js → tooltip-B6UPO-U8.js}

@@ -1,6 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { h as Presence, n as Portal$1, w as Arrow, D as DismissableLayer, C as Content, y as Root, j as useComposedRefs, t as createPopperScope, i as createContextScope, z as createSlottable, f as useId, e as useControllableState, v as Root2, A as Anchor, P as Primitive, g as composeEventHandlers, b as usePortalContainer, a as cn, O as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-C0Ldhp96.js";
+import { P as Presence, i as Portal$1, w as Arrow, D as DismissableLayer, C as Content, y as Root, h as useComposedRefs, t as createPopperScope, j as createContextScope, z as createSlottable, m as useId, l as useControllableState, v as Root2, A as Anchor, e as Primitive, f as composeEventHandlers, b as usePortalContainer, a as cn, O as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-BzRMP02h.js";
 var [createTooltipContext] = createContextScope("Tooltip", [
   createPopperScope
 ]);

package/headless.d.ts

@@ -71,6 +71,14 @@ export interface IssueStickerSummary {
   external_user_id?: string | null;
   created_at: string;
   updated_at: string;
+  /**
+   * 프로젝트의 스티커 디자인 규칙으로 해석된 색. 규칙이 없거나 값이 매칭되지 않으면 null.
+   * color 는 팔레트 이름이며 hex 가 아니다.
+   */
+  readonly design?: {
+    readonly color: string;
+    readonly label: string | null;
+  } | null;
 }
 
 /** 상세 조회한 이슈. */
@@ -267,11 +275,25 @@ export interface HeadlessIssueFilters {
 }
 
 export interface SubmitDraftInput {
-  title: string;
-  description: string;
+  /** intent 를 보내면 생략할 수 있다 — 서버가 생성한다. */
+  title?: string;
+  /** intent 를 보내면 생략할 수 있다 — 서버가 생성한다. */
+  description?: string;
+  /** 기대한 동작(To-be) 원문. 서버가 제목·설명을 비동기로 생성한다. */
+  intent?: string;
   dynamicFields?: Record<string, unknown>;
 }
 
+/**
+ * createIssue에 전달하는 입력. 유저 액션 없이 코드 조건으로 이슈를 만들 때 씁니다.
+ */
+export interface CreateIssueInput extends SubmitDraftInput {
+  /** 이슈를 붙일 요소. 기본값은 `document.body`(문서 좌상단). */
+  readonly target?: HTMLElement;
+  /** 기본 `'screenshot'`. `'none'`이면 캡처를 건너뛰고 즉시 전송합니다. */
+  readonly media?: 'screenshot' | 'none';
+}
+
 export interface HeadlessClient {
   readonly phase: HeadlessPhase;
   getSnapshot(): HeadlessSnapshot;
@@ -287,6 +309,17 @@ export interface HeadlessClient {
   setSessionReplayEnabled(enabled: boolean): void;
   cancelIssueCapture(): void;
   submitDraft(input: SubmitDraftInput): Promise<Issue>;
+  /**
+   * 유저 액션 없이 코드에서 이슈를 만듭니다. 캡처 단계를 거치지 않으므로 `phase`와
+   * `draft`를 건드리지 않고, 사용자가 이슈를 작성하는 중에도 호출할 수 있습니다.
+   *
+   * 실패해도 예외를 던지지 않고 `null`을 돌려줍니다. 이미 오류를 처리하는 자리에서
+   * 부르는 메서드라, 이슈 생성만을 위한 try/catch 를 한 겹 더 쓰지 않아도 됩니다.
+   * 실패 사유는 콘솔 경고로 남습니다.
+   *
+   * 호출 조건이 잘못 잡히면 이슈가 무한히 쌓이므로 SDK가 60초 5건으로 제한합니다.
+   */
+  createIssue(input: CreateIssueInput): Promise<Issue | null>;
   loginAsMember(): Promise<void>;
   logoutMember(): Promise<void>;
   destroy(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issue-sticker",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "IssueSticker SDK - Visual bug tracking widget for web applications",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -56,13 +56,14 @@
     "serve:localdev": "vite --host 0.0.0.0 --port 4173 --mode localdev",
     "preview": "vite preview",
     "lint": "cd ../.. && eslint packages/sdk --ext .ts,.tsx,.js,.jsx",
-    "typecheck": "npm run tsc",
+    "typecheck": "npm run tsc && npm run tsc:examples",
     "format": "cd ../.. && prettier --write packages/sdk --ignore-unknown",
     "format:check": "cd ../.. && prettier --check packages/sdk --ignore-unknown",
     "test": "vitest --run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "tsc": "tsc --noEmit",
+    "tsc:examples": "tsc --noEmit -p tsconfig.examples.json",
     "tsc:watch": "tsc --noEmit --watch",
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui"