@skippr/live-agent-sdk 0.106.0 → 0.108.0

package/dist/types/capture/snapdom.d.ts

@@ -1,11 +1,5 @@
 import type { SnapdomOptions } from '@zumer/snapdom';
 export type SnapdomCaptureOptions = SnapdomOptions & {
-    clip?: 'viewport' | {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
     snap?: unknown;
 };
 export declare function preCacheSnapshotResources(): void;

package/dist/types/components/LogoMark.d.ts

@@ -0,0 +1,6 @@
+interface LogoMarkProps {
+    className?: string;
+    decorative?: boolean;
+}
+export declare function LogoMark({ className, decorative }: LogoMarkProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/SplashAlwaysOn.d.ts

@@ -0,0 +1,19 @@
+import type { AdoptionGoalMatch } from '../context/LiveAgentContext';
+import type { SplashPresentation } from '../lib/splashPresentation';
+export interface SplashAlwaysOnViewProps {
+    agentName: string;
+    presentation: SplashPresentation;
+    headerIconUrl: string | null;
+    attributionVisible: boolean;
+    tips: AdoptionGoalMatch[];
+    micEnabled: boolean;
+    startMuted: boolean;
+    screenEnabled: boolean | null;
+    enableMic: () => void;
+    toggleStartMuted: () => void;
+    enableScreen: () => void;
+    startTip: (goal: AdoptionGoalMatch) => void;
+    start: () => void;
+    dismiss: () => void;
+}
+export declare function SplashAlwaysOn({ agentName, presentation, headerIconUrl, attributionVisible, tips, micEnabled, startMuted, screenEnabled, enableMic, toggleStartMuted, enableScreen, startTip, start, dismiss, }: SplashAlwaysOnViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/SplashMediaSection.d.ts

@@ -0,0 +1,11 @@
+import type { SplashPresentation } from '../lib/splashPresentation';
+export interface SplashMediaSectionProps {
+    copy: SplashPresentation['copy'];
+    micEnabled: boolean;
+    startMuted: boolean;
+    screenEnabled: boolean | null;
+    enableMic: () => void;
+    toggleStartMuted: () => void;
+    enableScreen: () => void;
+}
+export declare function SplashMediaSection({ copy, micEnabled, startMuted, screenEnabled, enableMic, toggleStartMuted, enableScreen, }: SplashMediaSectionProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/{SplashDefault.d.ts → SplashPrimary.d.ts}

@@ -27,4 +27,4 @@ export interface SplashViewProps {
     start: () => void;
     dismiss: () => void;
 }
-export declare function SplashDefault({ agentName, presentation, headerIconUrl, sections, attributionVisible, skipButtonVisible, intent, lastCompletedPhase, upcomingPhases, micEnabled, startMuted, screenEnabled, enableMic, toggleStartMuted, enableScreen, start, dismiss, }: SplashViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function SplashPrimary({ agentName, presentation, headerIconUrl, sections, attributionVisible, skipButtonVisible, intent, lastCompletedPhase, upcomingPhases, micEnabled, startMuted, screenEnabled, enableMic, toggleStartMuted, enableScreen, start, dismiss, }: SplashViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/context/LiveAgentContext.d.ts

@@ -1,7 +1,7 @@
 import type { LauncherDropTarget } from '../hooks/useLauncherDrag';
 import type { PhaseStatus } from '../hooks/usePhaseUpdates';
 import type { AgentMode } from '../lib/agentMode';
-import { type ActionPlanMode, type BuddyShape, CAPTURE_MODE, type CaptureMode, type ChatSurface, DEFAULT_CAPTURE_MODE, type LauncherMode, MIC_MODE, type MicMode, type PENDING_START_KIND, type SplashCopy, type SplashSection, type SplashVariant } from '../lib/constants';
+import { type ActionPlanMode, type BuddyShape, CAPTURE_MODE, type CaptureMode, type ChatSurface, DEFAULT_CAPTURE_MODE, type LauncherMode, MIC_MODE, type MicMode, type PENDING_START_KIND, type SplashCopy, type SplashSection } from '../lib/constants';
 import type { SessionStatus } from '../lib/sessionStatus';
 import type { BarPos } from '../lib/voiceBar';
 import type { Message } from '../types';
@@ -51,11 +51,12 @@ export interface BuddyAppearance {
 }
 export interface SplashAppearance {
     enabled: boolean;
-    variant: SplashVariant;
+    variant: 'primary';
     copy?: SplashCopy;
     sections?: SplashSection[];
     attributionVisible?: boolean;
-    skipButtonVisible?: boolean;
+    startSkipButtonVisible?: boolean;
+    continueSkipButtonVisible?: boolean;
     width?: number;
     maxHeight?: number;
 }
@@ -185,6 +186,7 @@ export interface LiveAgentContextValue extends LiveAgentPublicValue {
     hasResolvedModules: boolean;
     appearance: WidgetAppearance | null;
     adoptionGoals: AdoptionGoalMatch[];
+    hasResolvedAdoptionGoals: boolean;
     startAdoptionSession: (goal: AdoptionGoalMatch) => void;
     attendGoal: (goalId: string) => void;
     setTextModeState: (enabled: boolean) => void;

package/dist/types/hooks/useAdoptionGoals.d.ts

@@ -7,6 +7,7 @@ interface UseAdoptionGoalsParams {
 }
 interface UseAdoptionGoalsResult {
     goals: AdoptionGoalMatch[];
+    hasResolved: boolean;
     attendGoal: (goalId: string) => void;
 }
 export declare function useAdoptionGoals({ enabled, bearerToken, authedFetch, }: UseAdoptionGoalsParams): UseAdoptionGoalsResult;

package/dist/types/hooks/useSplash.d.ts

@@ -1,2 +1,9 @@
-import type { SplashViewProps } from '../components/SplashDefault';
-export declare function useSplash(onDismiss?: (() => void) | undefined): SplashViewProps | null;
+import type { SplashAlwaysOnViewProps } from '../components/SplashAlwaysOn';
+import type { SplashViewProps } from '../components/SplashPrimary';
+import { SPLASH_LAYOUT } from '../lib/constants';
+export type ResolvedSplash = ({
+    layout: typeof SPLASH_LAYOUT.Primary;
+} & SplashViewProps) | ({
+    layout: typeof SPLASH_LAYOUT.AlwaysOn;
+} & SplashAlwaysOnViewProps);
+export declare function useSplash(onDismiss?: (() => void) | undefined): ResolvedSplash | null;

package/dist/types/lib/constants.d.ts

@@ -79,7 +79,11 @@ export declare const LAUNCHER_MODE: {
 };
 export type LauncherMode = (typeof LAUNCHER_MODE)[keyof typeof LAUNCHER_MODE];
 export declare const DEFAULT_LAUNCHER_MODE: LauncherMode;
-export type SplashVariant = 'default';
+export declare const SPLASH_LAYOUT: {
+    readonly Primary: "primary";
+    readonly AlwaysOn: "always_on";
+};
+export type SplashLayout = (typeof SPLASH_LAYOUT)[keyof typeof SPLASH_LAYOUT];
 export declare const SPLASH_COPY_DEFAULTS: {
     readonly howItWorksHeading: "How it works";
     readonly lastAccomplishmentHeading: "Last accomplishment";
@@ -92,6 +96,10 @@ export declare const SPLASH_COPY_DEFAULTS: {
     readonly startCta: "Start with Skippr";
     readonly continueCta: "Continue session";
     readonly dismissLabel: "Skip for now";
+    readonly tipsHeading: "Tips";
+    readonly tipsCta: "Need help with something else?";
+    readonly tipsEmptyTitle: "Ask about this page";
+    readonly tipsEmptyDescription: "Get instant answers about anything you see here";
 };
 export type SplashCopyKey = keyof typeof SPLASH_COPY_DEFAULTS;
 export type SplashCopy = Partial<Record<SplashCopyKey, string>>;

package/dist/types/lib/splashStyles.d.ts

@@ -0,0 +1,10 @@
+export declare const SECTION_HEADING = "skippr:text-[11px] skippr:font-semibold skippr:uppercase skippr:tracking-[0.05em] skippr:text-[#6b6875]";
+export declare const SECTION_BLOCK = "skippr:mt-[6px] skippr:flex skippr:flex-col skippr:gap-[14px] skippr:first:mt-0";
+export declare const ICON_TILE = "skippr:flex skippr:size-[38px] skippr:shrink-0 skippr:items-center skippr:justify-center skippr:rounded-[11px] skippr:bg-[#f2f0eb] skippr:text-[#2D2D3F]";
+export declare const ICON_TILE_BRAND = "skippr:flex skippr:size-[38px] skippr:shrink-0 skippr:items-center skippr:justify-center skippr:rounded-[11px] skippr:bg-primary skippr:text-primary-foreground";
+export declare const ROW_TEXT = "skippr:flex skippr:min-w-0 skippr:flex-col skippr:gap-px";
+export declare const ROW_TITLE = "skippr:text-[14px] skippr:font-medium skippr:text-[#2D2D3F]";
+export declare const ROW_SUBTEXT = "skippr:text-[12px] skippr:text-[#6b6875]";
+export declare const ROW_ICON = "skippr:size-[17px]";
+export declare const ROW_ICON_STROKE = 1.8;
+export declare const FOCUS_RING = "skippr:focus-visible:outline-2 skippr:focus-visible:outline-offset-2 skippr:focus-visible:outline-[var(--skippr-brand)]";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skippr/live-agent-sdk",
-  "version": "0.106.0",
+  "version": "0.108.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",
@@ -34,7 +34,7 @@
     "release": "release-it"
   },
   "dependencies": {
-    "@zumer/snapdom": "2.18.0",
+    "@zumer/snapdom": "2.23.1",
     "clsx": "2.1.1",
     "lucide-react": "1.8.0",
     "tailwind-merge": "3.5.0"