@fanfare-io/fanfare-sdk-solid 0.18.0 → 0.19.0

package/dist/components/primitives/countdown.d.ts

@@ -1,14 +1,48 @@
+/**
+ * Countdown Component
+ *
+ * Displays time remaining until a target date.
+ * Automatically updates every second.
+ *
+ * Two layouts:
+ * - "swiss" (default): Prominent display with animated digits and labels above
+ * - "compact": Simple text-based countdown that inherits parent styling
+ *
+ * The Solid adapter resolves the remaining time on the client, from the device
+ * clock, because the adapter renders on the client. The React adapter anchors
+ * to a server-supplied instant because it renders on the server, where a
+ * device clock is not available and the markup has to match on hydration.
+ */
+export type CountdownSize = "default" | "hero";
+export type CountdownTone = "calm" | "warning" | "critical";
 export interface CountdownProps {
+    /** Target date/time to count down to */
     targetDate: Date | string | number;
+    /** Callback when countdown reaches zero */
     onComplete?: () => void;
+    /** Label to show when expired */
     expiredLabel?: string;
-    class?: string;
+    /** Additional CSS classes */
     className?: string;
+    /** Show days in countdown */
     showDays?: boolean;
+    /** Show hours in countdown */
     showHours?: boolean;
+    /** Show minutes in countdown */
     showMinutes?: boolean;
+    /** Show seconds in countdown */
     showSeconds?: boolean;
+    /** Layout: "swiss" for prominent animated display, "compact" for simple text */
     layout?: "swiss" | "compact";
+    /** Size: "default" (compact display) or "hero" (52px monospace, urgency-driver). */
+    size?: CountdownSize;
+    /**
+     * Presentational urgency tone. Caller derives from phase + time-remaining and passes it.
+     * - calm: foreground color (default)
+     * - warning: warning token color
+     * - critical: danger token color (in retro, also flips the unit container bg)
+     */
+    tone?: CountdownTone;
 }
 export declare function Countdown(props: CountdownProps): import("solid-js").JSX.Element;
 export declare namespace Countdown {

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

@@ -1,7 +1,7 @@
 export { Badge, badgeVariants, type BadgeProps, type BadgeVariant } from './badge';
 export { Button, buttonVariants, type ButtonProps } from './button';
 export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, cardVariants, type CardContentProps, type CardDescriptionProps, type CardFooterProps, type CardHeaderProps, type CardProps, type CardTitleProps, } from './card';
-export { Countdown, type CountdownProps } from './countdown';
+export { Countdown, type CountdownProps, type CountdownSize, type CountdownTone } from './countdown';
 export { FadePresence, type FadePresenceProps } from './fade-presence';
 export { FanfareLogo, type FanfareLogoProps } from './fanfare-logo';
 export { Input, type InputProps } from './input';

package/dist/index.d.ts

@@ -14,8 +14,8 @@ export { THEME_CSS_VARS, ThemeProvider, buildThemeCssVars } from './theme';
 export type { ResolvedTheme, ThemeCssVar, ThemeProviderProps, WidgetThemeConfig, WidgetVariant } from './theme';
 export { AuthForm, AuthInput, OTPInput } from './components/auth';
 export type { AuthFormProps, AuthInputProps } from './components/auth';
-export { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Input, buttonVariants, } from './components/primitives';
-export type { ButtonProps } from './components/primitives';
+export { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Countdown, Input, buttonVariants, } from './components/primitives';
+export type { ButtonProps, CountdownProps, CountdownSize, CountdownTone } from './components/primitives';
 export { InfoPanel, PanelBody, PanelFooter, PanelHeading, PanelLayout, normalizeOutcomeReason, } from './components/module';
 export type { InfoPanelProps, OutcomeReason, PanelBodyProps, PanelFooterProps, PanelHeadingProps, PanelHeadingVariant, PanelLayoutProps, } from './components/module';
 export { AccessCodeForm, ChallengeGate, EndedModule, ErrorView, GrantedPanel, OutcomePanel, } from './components/compositions';