@fanfare-io/fanfare-sdk-solid 0.1.0

package/dist/internal-sdk.d.ts

@@ -0,0 +1,2 @@
+import { FanfareSDK } from '@fanfare-io/fanfare-sdk-core';
+export type AdapterRuntimeSDK = FanfareSDK;

package/dist/lib/animations.d.ts

@@ -0,0 +1,31 @@
+import { WidgetVariant } from '@fanfare-io/fanfare-sdk-core/theme';
+export type AnimationConfig = {
+    duration?: number;
+    delay?: number;
+    easing?: string;
+    respectMotionPreference?: boolean;
+};
+export declare const defaultAnimationConfig: AnimationConfig;
+export declare const prefersReducedMotion: () => boolean;
+export declare const getAnimationDuration: (config?: AnimationConfig) => number;
+export declare const getAnimationDelay: (config?: AnimationConfig) => number;
+export declare const animationClasses: {
+    readonly fadeIn: "ff:animate-fade-in";
+    readonly fadeOut: "ff:animate-fade-out";
+    readonly slideIn: "ff:animate-slide-in";
+    readonly slideOut: "ff:animate-slide-out";
+    readonly scaleIn: "ff:animate-scale-in";
+    readonly scaleOut: "ff:animate-scale-out";
+    readonly accordionDown: "ff:animate-accordion-down";
+    readonly accordionUp: "ff:animate-accordion-up";
+    readonly celebration: "ff:animate-celebration";
+    readonly shake: "ff:animate-shake";
+    readonly pulseSuccess: "ff:animate-pulse-success";
+};
+export type AnimationType = keyof typeof animationClasses;
+export declare const getAnimationClass: (animation: AnimationType, config?: AnimationConfig) => string;
+export declare const getVariantEntranceAnimationClass: (variant: WidgetVariant, config?: AnimationConfig) => string;
+export declare const createTransition: (properties?: string[], config?: AnimationConfig) => string;
+export declare const withAnimation: <T extends Record<string, unknown>>(baseProps: T, animation: AnimationType, config?: AnimationConfig) => T & {
+    class?: string;
+};

package/dist/lib/appointment-format.d.ts

@@ -0,0 +1,26 @@
+import { AppointmentSlot } from '@fanfare-io/fanfare-sdk-core/appointments';
+/**
+ * Date / time formatting helpers shared across the appointment picker
+ * components. Every helper falls back to the input string when given an
+ * unparseable value or when `Intl.DateTimeFormat` throws on a bad `timeZone`
+ * (it raises `RangeError: Invalid time zone specified`), so a bad input can
+ * never crash the render.
+ */
+export declare function formatTime(value: string, timezone?: string): string;
+/** Format the start time of an appointment slot, falling back to its id string. */
+export declare function formatSlotTime(slot: AppointmentSlot): string;
+/**
+ * Return the YYYY-MM-DD calendar date of `date` as seen in `timezone`.
+ * Buckets slots by day and renders the day strip. `sv-SE` produces
+ * ISO-format output, so it doubles as a TZ-shifted date key.
+ */
+export declare function isoDateInTimezone(date: Date, timezone?: string): string;
+/** Add `days` calendar days to a YYYY-MM-DD date string. Calendar-day arithmetic only. */
+export declare function addCalendarDays(isoDate: string, days: number): string;
+/**
+ * Weekday label (e.g. "Mon") for a YYYY-MM-DD calendar date. Uses noon UTC so
+ * a TZ offset can't push the formatter to the wrong weekday.
+ */
+export declare function weekdayLabel(isoDate: string): string;
+/** Day-of-month from a YYYY-MM-DD calendar date. */
+export declare function dayOfMonth(isoDate: string): number;

package/dist/lib/confetti.d.ts

@@ -0,0 +1,3 @@
+import { WidgetVariant } from '../theme';
+export declare function triggerCelebration(variant: WidgetVariant): void;
+export declare function triggerCelebrationFromElement(element: HTMLElement, variant: WidgetVariant): void;

package/dist/lib/currency.d.ts

@@ -0,0 +1,9 @@
+export type CurrencyFormatOptions = {
+    currencyCode?: string;
+    currencySymbol?: string;
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+};
+export declare function getCurrencySymbol(currencyCode: string, locale?: string): string;
+export declare function formatMoney(amount: number, options?: CurrencyFormatOptions): string;

package/dist/lib/phone-formatter-lite.d.ts

@@ -0,0 +1,4 @@
+export declare function extractPhoneInput(value: string): string;
+export declare function formatPhoneAsYouType(value: string): string;
+export declare function toE164(value: string): string | null;
+export declare function validatePhone(value: string): boolean;

package/dist/lib/use-grant-celebration.d.ts

@@ -0,0 +1,2 @@
+import { Accessor } from 'solid-js';
+export declare function useGrantCelebration(element: Accessor<HTMLElement | undefined>): void;

package/dist/lib/utils.d.ts

@@ -0,0 +1,13 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function fanfareClass(...inputs: ClassValue[]): string;
+export declare const extractAriaProps: (props: {
+    [key: string]: unknown;
+}) => {
+    [key: string]: unknown;
+};
+export declare const extractDataProps: (props: {
+    [key: string]: unknown;
+}) => {
+    [key: string]: unknown;
+};

package/dist/register.d.ts

@@ -0,0 +1,52 @@
+import { FanfareConfig } from '@fanfare-io/fanfare-sdk-core';
+import { BrandTheme, WidgetVariant } from '@fanfare-io/fanfare-sdk-core/theme';
+import { Locale, PartialTranslationMessages, TranslationMessageKey } from '@fanfare-io/fanfare-sdk-i18n';
+export interface RegisterWebComponentsOptions {
+    /** Fanfare organization ID */
+    organizationId?: string;
+    /** Fanfare publishable key */
+    publishableKey?: string;
+    /** SDK environment */
+    environment?: FanfareConfig["environment"];
+    /** Custom API URL (overrides environment) */
+    apiUrl?: string;
+    /** Enable debug mode */
+    debug?: boolean;
+    /** Whether to auto-restore a session */
+    autoRestore?: boolean;
+    /** Whether to auto-resume after restore */
+    autoResume?: boolean;
+    /** Locale for translations */
+    locale?: Locale;
+    /** Custom translations */
+    translations?: PartialTranslationMessages<TranslationMessageKey>;
+    /** Theme configuration (overrides host CSS vars when provided) */
+    themeConfig?: BrandTheme | null;
+    /** Styling variant (default/retro/rounded/clean) */
+    variant?: WidgetVariant;
+    /** CSS class applied to the internal widget container */
+    containerClass?: string;
+}
+/**
+ * Register all widget web components.
+ *
+ * @example
+ * ```html
+ * <script type="module">
+ *   import { registerWebComponents } from "@fanfare-io/fanfare-sdk-solid";
+ *
+ *   registerWebComponents({ organizationId: "org_123", publishableKey: "pk_live_123" });
+ * </script>
+ *
+ * <fanfare-experience-widget
+ *   experience-id="exp_123"
+ *   container-class="my-fanfare-widget"
+ *   debug
+ *   auto-start
+ * ></fanfare-experience-widget>
+ * ```
+ *
+ * Note: defaults are applied at registration time and cannot be changed after the
+ * custom elements are defined.
+ */
+export declare function registerWebComponents(options?: RegisterWebComponentsOptions): void;