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

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

@@ -11,4 +11,4 @@ export { EndedModule, type EndedModuleProps } from './ended-module';
 export { ErrorView, type ErrorViewProps } from './error-view';
 export { GrantedPanel, type GrantedPanelProps } from './granted-panel';
 export { JourneyGate, type JourneyGateProps, type JourneyGateStage } from './journey-gate';
-export { OutcomePanel, type OutcomePanelProps } from './outcome-panel';
+export { OutcomePanel, type OutcomeAction, type OutcomePanelProps } from './outcome-panel';

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,6 +23,8 @@ export interface OutcomePanelProps {
     participationType?: ParticipationType;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
+    /** Secondary action offered once the outcome is final. */
+    action?: OutcomeAction;
     class?: string;
     className?: string;
 }

package/dist/components/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>;
@@ -21,6 +22,8 @@ export interface AuctionModuleProps {
     checkoutUrl?: string;
     onCheckoutClick?: () => void;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     class?: string;

package/dist/components/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 {
     display$?: ReadableAtom<DrawDisplayState>;
@@ -16,6 +17,8 @@ export interface DrawModuleProps {
     checkoutUrl?: string;
     onCheckoutClick?: () => void;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     class?: string;

package/dist/components/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,6 +18,8 @@ export interface QueueModuleProps {
     checkoutUrl?: string;
     onCheckoutClick?: () => void;
     outcomeReason?: OutcomeReason;
+    /** Host-provided action shown on the terminal panel. */
+    outcomeAction?: OutcomeAction;
     onReenter?: () => Promise<void>;
     isReentering?: boolean;
     class?: string;

package/dist/components/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,6 +18,8 @@ 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;
     class?: string;

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

@@ -3,3 +3,4 @@ export { InfoPanel, type InfoPanelProps } from './info-panel';
 export { normalizeOutcomeReason, normalizeSequenceOutcomeReason, type OutcomeReason } from './outcome-reason';
 export { PanelHeading, type PanelHeadingProps, type PanelHeadingVariant } from './panel-heading';
 export { PanelBody, PanelFooter, PanelLayout, type PanelBodyProps, type PanelFooterProps, type PanelLayoutProps, } from './panel-layout';
+export { StageSteps, type StageStep, type StageStepStatus, type StageStepsProps } from './stage-steps';

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

@@ -0,0 +1,10 @@
+import { JSX } from 'solid-js';
+export type StageStepStatus = "done" | "active" | "pending";
+export interface StageStep {
+    label: string;
+    status: StageStepStatus;
+}
+export interface StageStepsProps extends JSX.HTMLAttributes<HTMLDivElement> {
+    steps: readonly StageStep[];
+}
+export declare function StageSteps(props: StageStepsProps): JSX.Element;

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

@@ -4,6 +4,7 @@ import { BrandTheme } from '@fanfare-io/fanfare-sdk-core/theme';
 import { JSX } from 'solid-js';
 import { WidgetVariant } from '../../theme';
 import { AuthInputMode } from '../auth/auth-input';
+import { OutcomeAction } from '../compositions/outcome-panel';
 type ParticipationType = "queue" | "draw" | "auction" | "timed_release" | "appointment";
 type EnterableSlotSequence = Extract<SequenceView, {
     phase: "enterable";
@@ -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. */
@@ -186,6 +188,11 @@ export interface ExperienceWidgetProps {
     slots?: ExperienceWidgetSlots;
     children?: (props: ExperienceRenderProps) => JSX.Element;
     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;
     onJourneyChange?: (snapshot: JourneySnapshot) => void;
     onGranted?: (grant: string) => void;
     /** Called when a Fanfare-managed checkout completes (pre-auth capture or post-win reservation checkout) */

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export type { AccessCodeSlotProps, AuthSlotProps, ChallengeSlotProps, CheckoutPr
 export { CheckoutProcessingPanel, PaymentCollectionPanel, ReceiptPanel, ReservationCheckoutPanel, } from './components/checkout';
 export { LoadingView, StartView, UpcomingModule, WaitlistView } from './components/widgets';
 export type { LoadingViewProps, StartViewProps, UpcomingModuleProps, WaitlistViewProps } from './components/widgets';
-export { AuctionModule, DrawModule, QueueModule, TimedReleaseModule } from './components/widgets';
-export type { AuctionModuleProps, DrawModuleProps, QueueModuleProps, TimedReleaseModuleProps, } from './components/widgets';
+export { AppointmentModule, AuctionModule, DrawModule, QueueModule, TimedReleaseModule } from './components/widgets';
+export type { AppointmentModuleProps, AuctionModuleProps, DrawModuleProps, QueueModuleProps, TimedReleaseModuleProps, } from './components/widgets';
 export * from './styles';
 export { registerWebComponents } from './register';