@m1kapp/kit 0.0.50 → 0.0.52

package/README.md

@@ -219,6 +219,8 @@ import { ShareButton, useShare } from "@m1kapp/kit";
 
 // 버튼 그대로 사용 — 모바일은 네이티브 공유, 데스크탑은 클립보드 복사
 <ShareButton url="https://m1k.app" title="My App" />
+// 설치할 수 있는 기기면 "링크 보내기 · 홈 화면에 추가" 시트를 띄운다(AppShell 안에서)
+<ShareButton url="https://m1k.app" title="My App" install={{ appName: "My App", iconSrc: "/icon-192.png" }} />
 
 // 커스텀 UI
 const { share, copied, canNativeShare } = useShare({ url: "https://m1k.app" });

package/dist/index.d.mts

@@ -817,8 +817,16 @@ interface ShareButtonProps {
     label?: string;
     copiedLabel?: string;
     className?: string;
+    /**
+     * 설치할 수 있는 기기면 누를 때 "링크 보내기 · 홈 화면에 추가" 시트를 띄운다.
+     * 이미 설치했거나 지원 안 하는 브라우저면 지금처럼 바로 공유. AppShell 안에서 쓴다(시트가 거기 뜬다).
+     */
+    install?: boolean | {
+        appName?: string;
+        iconSrc?: string;
+    };
 }
-declare function ShareButton({ url, title, text, label, copiedLabel, className, }: ShareButtonProps): react_jsx_runtime.JSX.Element;
+declare function ShareButton({ url, title, text, label, copiedLabel, className, install, }: ShareButtonProps): react_jsx_runtime.JSX.Element;
 
 type ToastVariant = "default" | "success" | "error" | "info";
 interface ToastOptions {
@@ -1692,7 +1700,7 @@ interface CumulativeCurveProps {
 /** 누적 성장 곡선 + 마일스톤 배지 + 다음 목표선. 방문자·판매·적립 총량류에. */
 declare function CumulativeCurve({ daily, total, todayCount, accent, milestones, empty, className, }: CumulativeCurveProps): react_jsx_runtime.JSX.Element | null;
 
-type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
+type PWAInstallState = "android-ready" | "ios-safari" | "in-app" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
     state: PWAInstallState;
     /** Android only — triggers the native install dialog */
@@ -1705,12 +1713,14 @@ interface IOSInstallSheetProps {
     onClose(): void;
     appName: string;
     iconSrc?: string;
+    /** "in-app": 인스타·카톡 안 브라우저 — 바깥 브라우저로 여는 법을 안내한다 */
+    mode?: "safari" | "in-app";
 }
 /**
  * Bottom-sheet guide for iOS "Add to Home Screen".
  * Can also be used standalone if you need custom trigger UI.
  */
-declare function IOSInstallSheet({ open, onClose, appName, iconSrc }: IOSInstallSheetProps): react_jsx_runtime.JSX.Element | null;
+declare function IOSInstallSheet({ open, onClose, appName, iconSrc, mode }: IOSInstallSheetProps): React$1.ReactPortal | null;
 
 interface PWAInstallButtonProps {
     /** App name shown in iOS guide sheet */
@@ -1722,6 +1732,8 @@ interface PWAInstallButtonProps {
     /** Label shown when already installed. Default: undefined — button hidden */
     installedLabel?: string;
     className?: string;
+    /** "chip": 헤더용 — ShareButton 과 같은 연회색 알약. 기본 "solid"(검은 버튼) */
+    variant?: "solid" | "chip";
 }
 /**
  * PWA install button that handles both Android and iOS.
@@ -1734,7 +1746,7 @@ interface PWAInstallButtonProps {
  * Usage:
  *   <PWAInstallButton appName="My App" iconSrc="/icon.png" />
  */
-declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
+declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, variant, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Drop into <head> in your root layout to pre-load kit styles and

package/dist/index.d.ts

@@ -817,8 +817,16 @@ interface ShareButtonProps {
     label?: string;
     copiedLabel?: string;
     className?: string;
+    /**
+     * 설치할 수 있는 기기면 누를 때 "링크 보내기 · 홈 화면에 추가" 시트를 띄운다.
+     * 이미 설치했거나 지원 안 하는 브라우저면 지금처럼 바로 공유. AppShell 안에서 쓴다(시트가 거기 뜬다).
+     */
+    install?: boolean | {
+        appName?: string;
+        iconSrc?: string;
+    };
 }
-declare function ShareButton({ url, title, text, label, copiedLabel, className, }: ShareButtonProps): react_jsx_runtime.JSX.Element;
+declare function ShareButton({ url, title, text, label, copiedLabel, className, install, }: ShareButtonProps): react_jsx_runtime.JSX.Element;
 
 type ToastVariant = "default" | "success" | "error" | "info";
 interface ToastOptions {
@@ -1692,7 +1700,7 @@ interface CumulativeCurveProps {
 /** 누적 성장 곡선 + 마일스톤 배지 + 다음 목표선. 방문자·판매·적립 총량류에. */
 declare function CumulativeCurve({ daily, total, todayCount, accent, milestones, empty, className, }: CumulativeCurveProps): react_jsx_runtime.JSX.Element | null;
 
-type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
+type PWAInstallState = "android-ready" | "ios-safari" | "in-app" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
     state: PWAInstallState;
     /** Android only — triggers the native install dialog */
@@ -1705,12 +1713,14 @@ interface IOSInstallSheetProps {
     onClose(): void;
     appName: string;
     iconSrc?: string;
+    /** "in-app": 인스타·카톡 안 브라우저 — 바깥 브라우저로 여는 법을 안내한다 */
+    mode?: "safari" | "in-app";
 }
 /**
  * Bottom-sheet guide for iOS "Add to Home Screen".
  * Can also be used standalone if you need custom trigger UI.
  */
-declare function IOSInstallSheet({ open, onClose, appName, iconSrc }: IOSInstallSheetProps): react_jsx_runtime.JSX.Element | null;
+declare function IOSInstallSheet({ open, onClose, appName, iconSrc, mode }: IOSInstallSheetProps): React$1.ReactPortal | null;
 
 interface PWAInstallButtonProps {
     /** App name shown in iOS guide sheet */
@@ -1722,6 +1732,8 @@ interface PWAInstallButtonProps {
     /** Label shown when already installed. Default: undefined — button hidden */
     installedLabel?: string;
     className?: string;
+    /** "chip": 헤더용 — ShareButton 과 같은 연회색 알약. 기본 "solid"(검은 버튼) */
+    variant?: "solid" | "chip";
 }
 /**
  * PWA install button that handles both Android and iOS.
@@ -1734,7 +1746,7 @@ interface PWAInstallButtonProps {
  * Usage:
  *   <PWAInstallButton appName="My App" iconSrc="/icon.png" />
  */
-declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
+declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, variant, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Drop into <head> in your root layout to pre-load kit styles and