@fanfare-io/fanfare-sdk-react 0.2.0 → 0.4.0

package/dist/components/module/outcome-reason.d.ts

@@ -10,18 +10,22 @@
  * already-normalized UI value) to a member of the union. Unknown values
  * fall back to `"ended"`.
  *
- *   journey machine code  ->  UI outcome reason
+ *   journey machine code   ->  UI outcome reason
  *   ----------------------------------------------
- *   expired               ->  expired
- *   queue_denied          ->  not_selected
- *   draw_denied           ->  not_selected
- *   timed_release_denied  ->  sold_out
- *   already_completed     ->  ended
- *   closed                ->  ended
- *   unknown / other       ->  ended
+ *   expired                ->  expired
+ *   queue_denied / draw_denied / denied / lost -> not_selected
+ *   timed_release_denied   ->  sold_out
+ *   outbid                 ->  outbid
+ *   reserve_not_met        ->  reserve_not_met
+ *   completed / already_completed -> completed (a success terminal, not a loss)
+ *   closed / unknown / other -> ended
+ *
+ * The terminal projection carries the outcome TYPE (completed/denied/lost);
+ * mapping it here makes a paying winner, a denied entrant, and a plain loss
+ * render distinct copy rather than collapsing to the generic "ended" panel.
  *
  * Static story lanes pass UI values directly (e.g. `"outbid"`); those
  * pass through unchanged.
  */
-export type OutcomeReason = "expired" | "not_selected" | "sold_out" | "outbid" | "reserve_not_met" | "ended";
+export type OutcomeReason = "expired" | "not_selected" | "sold_out" | "outbid" | "reserve_not_met" | "completed" | "ended";
 export declare function normalizeOutcomeReason(reason: string | undefined): OutcomeReason;

package/dist/components/widgets/experience-widget.d.ts

@@ -1,6 +1,6 @@
 import { BotMitigationState, RoutingChallenge } from '@fanfare-io/fanfare-sdk-core/challenges';
 import { JourneyHandle, JourneySnapshot, JourneyView, SequenceView } from '@fanfare-io/fanfare-sdk-core/experiences';
-import { BrandTheme } from '../../theme';
+import { BrandTheme, WidgetVariant } from '../../theme';
 import { AuthInputMode } from '../auth/auth-input';
 import * as React from "react";
 type ParticipationType = "queue" | "draw" | "auction" | "timed_release" | "appointment";
@@ -118,7 +118,7 @@ export interface ExperienceWidgetProps {
     /** Theme customization */
     theme?: BrandTheme;
     /** Widget variant (overrides theme.variant if provided) */
-    variant?: "default" | "retro" | "rounded" | "clean";
+    variant?: WidgetVariant;
     /** Slots for targeted overrides */
     slots?: ExperienceWidgetSlots;
     /** Render prop for full control (ignores slots if provided) */

package/dist/components/widgets/internal/appointment-module.d.ts

@@ -3,7 +3,7 @@ import { ReadableAtom } from 'nanostores';
 import { OutcomeReason } from '../../module';
 export interface AppointmentModuleProps {
     appointmentId: string;
-    state$?: ReadableAtom<AppointmentDisplayState>;
+    display$?: ReadableAtom<AppointmentDisplayState>;
     sequencePhase: "enterable" | "participating" | "ended";
     bookingWindowOpenAt?: string;
     bookingWindowCloseAt?: string;
@@ -22,7 +22,7 @@ export interface AppointmentModuleProps {
     isReentering?: boolean;
     className?: string;
 }
-export declare function AppointmentModule({ appointmentId, state$, sequencePhase, bookingWindowOpenAt, bookingWindowCloseAt, timezone, defaultLocationId, onBook, onCancel, onReschedule, isBooking, isCancelling, isRescheduling, bookError, cancelError, outcomeReason, onReenter, isReentering, className, }: AppointmentModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppointmentModule({ appointmentId, display$, sequencePhase, bookingWindowOpenAt, bookingWindowCloseAt, timezone, defaultLocationId, onBook, onCancel, onReschedule, isBooking, isCancelling, isRescheduling, bookError, cancelError, outcomeReason, onReenter, isReentering, className, }: AppointmentModuleProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace AppointmentModule {
     var displayName: string;
 }

package/dist/components/widgets/internal/auction-module.d.ts

@@ -2,7 +2,7 @@ import { AuctionDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
 import { OutcomeReason } from '../../module';
 export interface AuctionModuleProps {
-    state$?: ReadableAtom<AuctionDisplayState>;
+    display$?: ReadableAtom<AuctionDisplayState>;
     fallbackState?: AuctionDisplayState;
     sequencePhase: "enterable" | "participating" | "settling" | "granted" | "ended";
     canEnter: boolean;
@@ -27,7 +27,7 @@ export interface AuctionModuleProps {
     isReentering?: boolean;
     className?: string;
 }
-export declare function AuctionModule({ state$, fallbackState, sequencePhase, canEnter, canLeave, onEnter, onLeave, onBid, isEntering, isLeaving, countdownTo, defaultBidAmount, currencyCode, locale, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: AuctionModuleProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AuctionModule({ display$, fallbackState, sequencePhase, canEnter, canLeave, onEnter, onLeave, onBid, isEntering, isLeaving, countdownTo, defaultBidAmount, currencyCode, locale, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: AuctionModuleProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace AuctionModule {
     var displayName: string;
 }

package/dist/components/widgets/internal/draw-module.d.ts

@@ -3,7 +3,7 @@ import { ReadableAtom } from 'nanostores';
 import { OutcomeReason } from '../../module';
 export interface DrawModuleProps {
     /** Reactive display state atom from the journey */
-    state$?: ReadableAtom<DrawDisplayState>;
+    display$?: ReadableAtom<DrawDisplayState>;
     /** Current sequence phase */
     sequencePhase: "enterable" | "participating" | "settling" | "granted" | "ended";
     /** Whether user can enter (active only) */
@@ -37,7 +37,7 @@ export interface DrawModuleProps {
     /** Additional class name */
     className?: string;
 }
-export declare function DrawModule({ state$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, countdownTo, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: DrawModuleProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function DrawModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, countdownTo, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: DrawModuleProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace DrawModule {
     var displayName: string;
 }

package/dist/components/widgets/internal/queue-module.d.ts

@@ -2,7 +2,7 @@ import { QueueDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
 import { OutcomeReason } from '../../module';
 export interface QueueModuleProps {
-    state$?: ReadableAtom<QueueDisplayState>;
+    display$?: ReadableAtom<QueueDisplayState>;
     sequencePhase: "enterable" | "participating" | "granted" | "ended";
     canEnter: boolean;
     canLeave: boolean;
@@ -21,7 +21,7 @@ export interface QueueModuleProps {
     isReentering?: boolean;
     className?: string;
 }
-export declare function QueueModule({ state$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, closeAt, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: QueueModuleProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function QueueModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, closeAt, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, onReenter, isReentering, className, }: QueueModuleProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace QueueModule {
     var displayName: string;
 }

package/dist/components/widgets/internal/timed-release-module.d.ts

@@ -2,7 +2,7 @@ import { TimedReleaseDisplayState } from '@fanfare-io/fanfare-sdk-core/internals
 import { ReadableAtom } from 'nanostores';
 import { OutcomeReason } from '../../module';
 export interface TimedReleaseModuleProps {
-    state$?: ReadableAtom<TimedReleaseDisplayState>;
+    display$?: ReadableAtom<TimedReleaseDisplayState>;
     sequencePhase: "enterable" | "participating" | "granted" | "ended";
     canEnter: boolean;
     canLeave: boolean;
@@ -21,7 +21,7 @@ export interface TimedReleaseModuleProps {
     isReentering?: boolean;
     className?: string;
 }
-export declare function TimedReleaseModule({ state$, sequencePhase, canEnter, canLeave, onEnter, onLeave, onComplete, isEntering, isLeaving, countdownTo, checkoutUrl, onCheckoutClick, grant: _grant, expiresAt, outcomeReason, onReenter, isReentering, className, }: TimedReleaseModuleProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function TimedReleaseModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, onComplete, isEntering, isLeaving, countdownTo, checkoutUrl, onCheckoutClick, grant: _grant, expiresAt, outcomeReason, onReenter, isReentering, className, }: TimedReleaseModuleProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace TimedReleaseModule {
     var displayName: string;
 }

package/dist/components/widgets/internal/upcoming-module.d.ts

@@ -18,12 +18,14 @@ export interface UpcomingModuleProps {
     canEnter?: boolean;
     /** Called when user enters */
     onEnter?: () => void;
+    /** Entry button label override */
+    enterLabel?: string;
     /** Whether entry is in progress */
     isEntering?: boolean;
     /** Additional class name */
     className?: string;
 }
-export declare function UpcomingModule({ title, description, startsAt, onCountdownComplete, canEnter, onEnter, isEntering, className, }: UpcomingModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare function UpcomingModule({ title, description, startsAt, onCountdownComplete, canEnter, onEnter, enterLabel, isEntering, className, }: UpcomingModuleProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace UpcomingModule {
     var displayName: string;
 }

package/dist/components/widgets/upgrade-offer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * UpgradeOffer
+ *
+ * Rough-and-ready affordance shown in the routed state when a higher-priority
+ * sequence is available behind an access-code gate. Renders an unobtrusive link
+ * that reveals an input; submitting attempts the upgrade via
+ * `RoutedView.submitAccessCode`. Routing is monotonic for the consumer: a wrong
+ * code leaves them in their current sequence.
+ *
+ * Controlled: open/invalid/submitting are owned by the widget so the panel
+ * survives the brief `routing` transition a reroute passes through (otherwise
+ * the affordance unmounts mid-attempt and loses its state).
+ */
+export interface UpgradeOfferProps {
+    open: boolean;
+    invalid: boolean;
+    submitting: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onSubmit: (accessCode: string) => void;
+}
+export declare function UpgradeOffer({ open, invalid, submitting, onOpen, onClose, onSubmit }: UpgradeOfferProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace UpgradeOffer {
+    var displayName: string;
+}

package/dist/components/widgets/waitlist/index.d.ts

@@ -1,6 +1,5 @@
 /**
  * Waitlist Widget Internal Components
  *
- * Building blocks for the WaitlistWidget.
+ * Waitlist confirmation is rendered by the shared internal WaitlistView.
  */
-export { WaitlistActions, type WaitlistActionsProps, type WaitlistStatus } from './waitlist-actions';