@fanfare-io/fanfare-sdk-react 0.12.0 → 0.13.0

package/dist/components/compositions/index.d.ts

@@ -10,6 +10,6 @@ export { JourneyGate, type JourneyGateProps, type JourneyGateStage } from './jou
 export { ChallengeGate, type ChallengeGateProps } from './challenge-gate';
 export { AccessCodeForm, type AccessCodeFormProps } from './access-code-form';
 export { GrantedPanel, type GrantedPanelProps } from './granted-panel';
-export { OutcomePanel, type OutcomePanelProps } from './outcome-panel';
+export { OutcomePanel, type OutcomeAction, type OutcomePanelProps } from './outcome-panel';
 export { EndedModule, type EndedModuleProps } from './ended-module';
 export { ErrorView, type ErrorViewProps } from './error-view';

package/dist/components/compositions/outcome-panel.d.ts

@@ -4,6 +4,15 @@ import { OutcomeReason } from '../module';
  * (e.g. the expired re-enter button label) so each module shows terminology
  * appropriate to its mechanism rather than queue-specific copy.
  */
+/**
+ * A host-provided action for a terminal panel, such as "See what's still
+ * available" after a loss. The widget renders it as a secondary button; the
+ * host decides where it leads.
+ */
+export interface OutcomeAction {
+    label: string;
+    onClick: () => void;
+}
 export type ParticipationType = "queue" | "draw" | "auction" | "timed_release" | "appointment";
 export interface OutcomePanelProps {
     outcomeReason: OutcomeReason;
@@ -14,9 +23,11 @@ export interface OutcomePanelProps {
     participationType?: ParticipationType;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
+    /** Secondary action offered once the outcome is final. */
+    action?: OutcomeAction;
     className?: string;
 }
-export declare function OutcomePanel({ outcomeReason, participationType, onReenter, isReentering, className, }: OutcomePanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function OutcomePanel({ outcomeReason, participationType, onReenter, isReentering, action, className, }: OutcomePanelProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace OutcomePanel {
     var displayName: string;
 }

package/dist/components/module/index.d.ts

@@ -13,6 +13,8 @@ export { PanelHeading } from './panel-heading';
 export type { PanelHeadingProps, PanelHeadingVariant } from './panel-heading';
 export { InfoPanel } from './info-panel';
 export type { InfoPanelProps } from './info-panel';
+export { StageSteps } from './stage-steps';
+export type { StageStep, StageStepStatus, StageStepsProps } from './stage-steps';
 export { AlertPanel } from './alert-panel';
 export type { AlertPanelProps } from './alert-panel';
 export { normalizeOutcomeReason, normalizeSequenceOutcomeReason } from './outcome-reason';

package/dist/components/module/stage-steps.d.ts

@@ -0,0 +1,26 @@
+/**
+ * StageSteps
+ *
+ * A row of named stages for a phase whose end time is unknown. Completed
+ * stages read solid, the active stage pulses and its connector flows toward
+ * the next, and pending stages stay outlined. It communicates where the
+ * consumer is in a process without implying a percentage or a deadline.
+ *
+ *   <StageSteps
+ *     steps={[
+ *       { label: "You're in", status: "done" },
+ *       { label: "Drawing", status: "active" },
+ *       { label: "Results", status: "pending" },
+ *     ]}
+ *   />
+ */
+import * as React from "react";
+export type StageStepStatus = "done" | "active" | "pending";
+export interface StageStep {
+    label: string;
+    status: StageStepStatus;
+}
+export interface StageStepsProps extends React.HTMLAttributes<HTMLDivElement> {
+    steps: readonly StageStep[];
+}
+export declare const StageSteps: React.ForwardRefExoticComponent<StageStepsProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -2,6 +2,7 @@ import { BotMitigationState, RoutingChallenge } from '@fanfare-io/fanfare-sdk-co
 import { CheckoutNextAction, CheckoutProcessor, FanfareCheckoutResult, JourneyHandle, JourneySnapshot, JourneyView, PaymentInput, PaymentMethodSummary, ReservationPaymentAffordance, SequenceView } from '@fanfare-io/fanfare-sdk-core/experiences';
 import { BrandTheme, WidgetVariant } from '../../theme';
 import { AuthInputMode } from '../auth/auth-input';
+import { OutcomeAction } from '../compositions/outcome-panel';
 import * as React from "react";
 type ParticipationType = "queue" | "draw" | "auction" | "timed_release" | "appointment";
 type EnterableSlotSequence = Extract<SequenceView, {
@@ -137,7 +138,8 @@ export interface EndedSlotProps extends SlotProps {
 }
 export interface ErrorSlotProps extends SlotProps {
     error: string;
-    onRetry: () => void;
+    /** Absent when the refusal cannot be cleared by retrying — render no retry affordance. */
+    onRetry?: () => void;
 }
 export interface LoadingSlotProps extends SlotProps {
     /** Stage-specific message (e.g. routing). `undefined` for generic loading — show just a spinner. */
@@ -197,6 +199,11 @@ export interface ExperienceWidgetProps {
     children?: (props: ExperienceRenderProps) => React.ReactNode;
     /** Checkout URL for granted state */
     checkoutUrl?: string;
+    /**
+     * Action offered on terminal panels (not selected, sold out, closed), such as
+     * a link back to what is still available. Omit to show none.
+     */
+    endedAction?: OutcomeAction;
     /** Called when journey state changes */
     onJourneyChange?: (snapshot: JourneySnapshot) => void;
     /** Called when the journey receives a grant */
@@ -210,7 +217,7 @@ export interface ExperienceWidgetProps {
     /** Additional class name */
     className?: string;
 }
-export declare function ExperienceWidget({ experienceId, autoStart, accessCode, autoEnterWaitlist, theme, variant, slots, children, checkoutUrl, onJourneyChange, onGranted, onFanfareCheckout, onReserved, onError, className, }: ExperienceWidgetProps): import("react/jsx-runtime").JSX.Element;
+export declare function ExperienceWidget({ experienceId, autoStart, accessCode, autoEnterWaitlist, theme, variant, slots, children, checkoutUrl, endedAction, onJourneyChange, onGranted, onFanfareCheckout, onReserved, onError, className, }: ExperienceWidgetProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ExperienceWidget {
     var displayName: string;
 }

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

@@ -1,5 +1,6 @@
 import { AuctionDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
+import { OutcomeAction } from '../../compositions/outcome-panel';
 import { OutcomeReason } from '../../module';
 export interface AuctionModuleProps {
     display$?: ReadableAtom<AuctionDisplayState>;
@@ -23,11 +24,13 @@ export interface AuctionModuleProps {
     checkoutUrl?: string;
     onCheckoutClick?: () => void;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     className?: string;
 }
-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 function AuctionModule({ display$, fallbackState, sequencePhase, canEnter, canLeave, onEnter, onLeave, onBid, isEntering, isLeaving, countdownTo, defaultBidAmount, currencyCode, locale, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, outcomeAction, 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

@@ -1,5 +1,6 @@
 import { DrawDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
+import { OutcomeAction } from '../../compositions/outcome-panel';
 import { OutcomeReason } from '../../module';
 export interface DrawModuleProps {
     /** Reactive display state atom from the journey */
@@ -30,6 +31,8 @@ export interface DrawModuleProps {
     onCheckoutClick?: () => void;
     /** Denial reason (denied) */
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     /** Re-enter handler (denied with reason="expired") */
     onReenter?: () => Promise<void>;
     /** Whether re-entering is in progress */
@@ -37,7 +40,7 @@ export interface DrawModuleProps {
     /** Additional class name */
     className?: string;
 }
-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 function DrawModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, countdownTo, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, outcomeAction, 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

@@ -1,5 +1,6 @@
 import { QueueDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
+import { OutcomeAction } from '../../compositions/outcome-panel';
 import { OutcomeReason } from '../../module';
 export interface QueueModuleProps {
     display$?: ReadableAtom<QueueDisplayState>;
@@ -17,11 +18,13 @@ export interface QueueModuleProps {
     checkoutUrl?: string;
     onCheckoutClick?: () => void;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     className?: string;
 }
-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 function QueueModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, isEntering, isLeaving, closeAt, grant: _grant, expiresAt, checkoutUrl, onCheckoutClick, outcomeReason, outcomeAction, 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

@@ -1,5 +1,6 @@
 import { TimedReleaseDisplayState } from '@fanfare-io/fanfare-sdk-core/internals';
 import { ReadableAtom } from 'nanostores';
+import { OutcomeAction } from '../../compositions/outcome-panel';
 import { OutcomeReason } from '../../module';
 export interface TimedReleaseModuleProps {
     display$?: ReadableAtom<TimedReleaseDisplayState>;
@@ -17,11 +18,13 @@ export interface TimedReleaseModuleProps {
     grant?: string;
     expiresAt?: number | Date;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     className?: string;
 }
-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 function TimedReleaseModule({ display$, sequencePhase, canEnter, canLeave, onEnter, onLeave, onComplete, isEntering, isLeaving, countdownTo, checkoutUrl, onCheckoutClick, grant: _grant, expiresAt, outcomeReason, outcomeAction, onReenter, isReentering, className, }: TimedReleaseModuleProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace TimedReleaseModule {
     var displayName: string;
 }