keystone-design-bootstrap 1.0.103 → 1.0.105-dev.0

package/dist/form-C94A_PX_.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Form definition from API (GET /public/forms/:form_type).
+ * fields is an ordered array; each item is a single field or an array of fields (inline row). Max depth 2.
+ */
+interface FormFieldOption {
+    value: string;
+    label: string;
+}
+interface FormFieldDefinition {
+    name: string;
+    type: string;
+    label: string;
+    required?: boolean;
+    placeholder?: string;
+    /** For hidden fields, optional value to submit. */
+    value?: string;
+    /** For checkbox_group fields: the selectable options. */
+    options?: FormFieldOption[];
+}
+/** One item in the fields array: either a single field or a row of fields (inline). */
+type FormFieldItem = FormFieldDefinition | FormFieldDefinition[];
+interface FormDefinition {
+    id: number;
+    name: string;
+    form_type: string;
+    /** Ordered array; each element is a field or an array of fields (inline row). */
+    fields: FormFieldItem[];
+    settings?: Record<string, unknown>;
+    /** Business name for consent copy (e.g. "{{company_name}}" in checkbox labels). */
+    company_name?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+type FormType = 'lead' | 'job_application' | 'marketing_list_signup';
+
+export type { FormDefinition as F, FormFieldDefinition as a, FormFieldItem as b, FormFieldOption as c, FormType as d };

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+export { AboutHome, BlogCardFullWidthHorizontal, BlogCardFullWidthHorizontalAlt, BlogCardFullWidthHorizontalCompact, BlogCardFullWidthHorizontalMinimal, BlogCardFullWidthVertical, BlogCardFullWidthVerticalAlt, BlogCardFullWidthVerticalCompact, BlogCardFullWidthVerticalMinimal, BlogCardHorizontal, BlogCardHorizontalBadge, BlogCardHorizontalCompact, BlogCardHorizontalMinimal, BlogCardVertical, BlogCardVerticalBadge, BlogCardVerticalCompact, BlogCardVerticalMinimal, BlogGallery, BlogHome, BlogPostSection, BlogSection, ContactHome, ContactSection, EmailSignupSection, EmailSignupSectionProps, FAQGrid, FAQHero, FAQHome, FeatureTabHorizontal, FeatureTabVertical, FeatureTextCentered, FeatureTextFeaturedIconBox, FeatureTextFeaturedIconCard, FeatureTextFeaturedIconLeft, FeatureTextFeaturedIconTopCentered, FeatureTextFeaturedIconTopCenteredBrand, FeatureTextFeaturedIconTopLeft, FeatureTextFeaturedIconTopLeftBrand, FeatureTextIconCard, FeatureTextIconLeft, FeatureTextIconTopCentered, FeatureTextIconTopLeft, FeatureTextIntegrationIconBox, FeatureTextIntegrationIconLeft, FeatureTextIntegrationIconTopCentered, FeatureTextIntegrationIconTopLeft, FeatureTextLeft, FeatureTextLeftBrand, FooterHome, GenericHeaderComponent, GenericTextHero, HeaderNavigation, HeroHome, HomeHeroComponent, JobApplicationForm, JobDetailHero, JobDetailSection, JobGallery, LocationDetailHero, LocationDetailsSection, LocationGrid, PackageForMenu, PolicyDocumentSection, ServiceDetailContent, ServiceDetailHero, ServiceMenuSection, ServiceMenuSectionProps, ServicesGrid, ServicesHome, SocialMediaGrid, SocialMediaHero, StatisticsSection, TeamGrid, TestimonialsGrid, TestimonialsHero, TestimonialsHome, ValuesSection, getBlogPostData } from './design_system/sections/index.js';
+export { Avatar, AvatarLabelGroup, Badge, BadgeGroup, BadgeWithDot, Breadcrumb, Button, ButtonGroup, Carousel, CarouselContext, CarouselSectionWrapper, ComboBox, FeaturedIcon, Form, FormContainer, GoogleMap, HintText, Input, InputBase, InputGroup, Label, MarkdownRenderer, Modal, ModalProps, NativeSelect, Pagination, PaginationPageDefault, PaginationPageMinimalCenter, PhotoWithFallback, PrivacyCheckbox, RatingBadge, RatingStars, RoundButton, Select, SelectItem, SocialIcon, StarIcon, Textarea, Tooltip, VerifiedTick, VideoModal, VideoPlayButton, Wreath, getSocialIcon, getStarProgress, useCarousel } from './design_system/elements/index.js';
+import { C as CompanyInformation } from './package-DeHKpQp7.js';
+export { ThemeProvider, useTheme } from './contexts/index.js';
+import React__default from 'react';
+export { Theme } from './themes/index.js';
+import './blog-post-vWzW8yFb.js';
+import './photos-CmBdWiuZ.js';
+import './form-C94A_PX_.js';
+import './website-photos-Cl1YqAno.js';
+import 'react-aria-components';
+import 'embla-carousel-react';
+
+interface ContactFormResult {
+    success: boolean;
+    message?: string;
+    error?: string;
+    /** Present on lead form success; use for Meta Pixel dedup: fbq('track', 'Lead', {}, { eventID: eventId }) */
+    eventId?: string;
+}
+declare function submitContactFormAction(formData: FormData): Promise<ContactFormResult>;
+declare function submitLeadFormAction(formData: FormData): Promise<ContactFormResult>;
+
+/**
+ * Resolves the primary and secondary CTA hrefs used across the site.
+ *
+ * Resolution order for primaryHref:
+ *   1. portal_url            — set by backend when account has consumer portal enabled
+ *   2. external_management_url — booking platform URL from the API
+ *   3. /contact               — final fallback
+ *
+ * No per-site configuration needed. Enable the portal in the admin console and
+ * every CTA across the site automatically routes to the portal.
+ */
+
+/** True when the href is absolute (external); use for target="_blank" and rel="noopener noreferrer". */
+declare function isExternalCtaUrl(href: string): boolean;
+interface ResolvedCtaUrls {
+    primaryHref: string;
+    secondaryHref: string;
+    hasSecondary: boolean;
+}
+declare function resolveCtaUrls(companyInformation?: CompanyInformation | null): ResolvedCtaUrls;
+
+declare const RAILS_BACKEND: "rails";
+declare const SOR_BACKEND: "sor";
+type ChatBackend = typeof RAILS_BACKEND | typeof SOR_BACKEND;
+
+interface TeamMember {
+    id: number;
+    name: string;
+    position?: string;
+    photo_url?: string;
+}
+interface ChatWidgetProps {
+    position?: 'bottom-right' | 'bottom-left';
+    /**
+     * Which backend the site's `/api/chat` proxy talks to. The two backends have
+     * architecturally different reply delivery: 'rails' (keystone-mono-proto)
+     * pushes replies over ActionCable realtime; 'sor' (sor-service) has no
+     * realtime channel and the widget polls for the reply instead. The paths are
+     * mutually exclusive — a 'sor' widget never probes/subscribes realtime, a
+     * 'rails' widget never polls.
+     *
+     * TODO(webchat): default is 'rails' while keystone-mono-proto is still a live
+     * backend; flip the default to 'sor' once the Rails backend is scrapped.
+     */
+    chatBackend?: ChatBackend;
+    primaryColor?: string;
+    /**
+     * Anonymous session identifier. Used when the visitor is not authenticated.
+     * Mutually exclusive with `contactId` — if both are provided, `contactId` wins.
+     */
+    sessionId?: string;
+    /**
+     * Authenticated contact ID. When provided, messages are loaded and sent using
+     * the contact-driven flow instead of the anonymous session flow.
+     * The `/api/chat` route must support `contact_id` (see `createChatRouteHandlers`).
+     */
+    contactId?: number;
+    displayName?: string;
+    teamMembers?: TeamMember[];
+}
+declare function ChatWidget({ position, primaryColor, chatBackend, sessionId: providedSessionId, contactId, displayName: providedDisplayName, teamMembers }: ChatWidgetProps): React__default.JSX.Element;
+
+export { ChatWidget, type ResolvedCtaUrls, isExternalCtaUrl, resolveCtaUrls, submitContactFormAction, submitLeadFormAction };