keystone-design-bootstrap 1.0.58 → 1.0.59

package/dist/blog-post-vWzW8yFb.d.ts

@@ -0,0 +1,50 @@
+import { P as PhotoAttachment } from './photos-CmBdWiuZ.js';
+
+interface BlogPost {
+    id: number;
+    title: string;
+    slug: string;
+    status: string;
+    published_at?: string;
+    excerpt_markdown?: string;
+    content_markdown: string;
+    featured: boolean;
+    seo_title?: string;
+    seo_description?: string;
+    seo_keywords?: string;
+    created_at: string;
+    updated_at: string;
+    photo_attachments?: PhotoAttachment[];
+    blog_post_authors?: BlogPostAuthor[];
+    blog_post_tags?: BlogPostTag[];
+}
+interface BlogPostParams {
+    status?: string;
+    author_id?: number;
+    tag_id?: number;
+    q?: string;
+    page?: number;
+    per_page?: number;
+    featured?: boolean;
+}
+type BlogPostResponse = BlogPost[];
+interface BlogPostAuthor {
+    id: number;
+    name: string;
+    slug: string;
+    bio_markdown?: string;
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+    photo_attachments?: PhotoAttachment[];
+}
+interface BlogPostTag {
+    id: number;
+    name: string;
+    slug: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+
+export type { BlogPost as B, BlogPostAuthor as a, BlogPostParams as b, BlogPostResponse as c, BlogPostTag as d };

package/dist/contexts/index.d.ts

@@ -0,0 +1,13 @@
+import * as React$1 from 'react';
+import { Theme } from '../themes/index.js';
+
+interface ThemeContextValue {
+    theme: Theme;
+}
+declare function ThemeProvider({ theme, children }: {
+    theme: Theme;
+    children: React.ReactNode;
+}): React$1.JSX.Element;
+declare function useTheme(): ThemeContextValue;
+
+export { ThemeProvider, useTheme };

package/dist/design_system/elements/index.d.ts

@@ -0,0 +1,383 @@
+import * as React from 'react';
+import React__default, { ReactNode, Ref, ComponentType, HTMLAttributes, CSSProperties, FC, SVGProps, ComponentPropsWithRef, RefAttributes } from 'react';
+import { TextFieldProps as TextFieldProps$1, ComboBoxProps as ComboBoxProps$1, ListBoxProps } from 'react-aria-components';
+import useEmblaCarousel, { UseEmblaCarouselType } from 'embla-carousel-react';
+
+interface InputBaseProps extends TextFieldProps {
+    /** Tooltip message on hover. */
+    tooltip?: string;
+    /**
+     * Input size.
+     * @default "sm"
+     */
+    size?: "sm" | "md";
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Class name for the icon. */
+    iconClassName?: string;
+    /** Class name for the input. */
+    inputClassName?: string;
+    /** Class name for the input wrapper. */
+    wrapperClassName?: string;
+    /** Class name for the tooltip. */
+    tooltipClassName?: string;
+    /** Keyboard shortcut to display. */
+    shortcut?: string | boolean;
+    ref?: Ref<HTMLInputElement>;
+    groupRef?: Ref<HTMLDivElement>;
+    /** Icon component to display on the left side of the input. */
+    icon?: ComponentType<HTMLAttributes<HTMLOrSVGElement>>;
+}
+interface BaseProps {
+    /** Label text for the input */
+    label?: string;
+    /** Helper text displayed below the input */
+    hint?: ReactNode;
+}
+interface TextFieldProps extends BaseProps, TextFieldProps$1, Pick<InputBaseProps, "size" | "wrapperClassName" | "inputClassName" | "iconClassName" | "tooltipClassName"> {
+    ref?: Ref<HTMLDivElement>;
+}
+
+/**
+ * A2P 10DLC-compliant privacy + SMS consent checkbox. Use on any form that collects phone numbers.
+ * Same copy and markup used across contact and job application forms.
+ */
+declare function PrivacyCheckbox$1(): React.JSX.Element;
+
+type PaginationPage = {
+    /** The type of the pagination item. */
+    type: "page";
+    /** The value of the pagination item. */
+    value: number;
+    /** Whether the pagination item is the current page. */
+    isCurrent: boolean;
+};
+type PaginationEllipsisType = {
+    type: "ellipsis";
+    key: number;
+};
+type PaginationItemType = PaginationPage | PaginationEllipsisType;
+interface PaginationContextType {
+    /** The pages of the pagination. */
+    pages: PaginationItemType[];
+    /** The current page of the pagination. */
+    currentPage: number;
+    /** The total number of pages. */
+    total: number;
+    /** The function to call when the page changes. */
+    onPageChange: (page: number) => void;
+}
+interface PaginationRootProps {
+    /** Number of sibling pages to show on each side of the current page */
+    siblingCount?: number;
+    /** Current active page number */
+    page: number;
+    /** Total number of pages */
+    total: number;
+    children: ReactNode;
+    /** The style of the pagination root. */
+    style?: CSSProperties;
+    /** The class name of the pagination root. */
+    className?: string;
+    /** Callback function that's called when the page changes with the new page number. */
+    onPageChange?: (page: number) => void;
+}
+interface TriggerRenderProps$1 {
+    isDisabled: boolean;
+    onClick: () => void;
+}
+interface TriggerProps$1 {
+    /** The children of the trigger. Can be a render prop or a valid element. */
+    children: ReactNode | ((props: TriggerRenderProps$1) => ReactNode);
+    /** The style of the trigger. */
+    style?: CSSProperties;
+    /** The class name of the trigger. */
+    className?: string | ((args: {
+        isDisabled: boolean;
+    }) => string);
+    /** If true, the child element will be cloned and passed down the prop of the trigger. */
+    asChild?: boolean;
+    /** The direction of the trigger. */
+    direction: "prev" | "next";
+    /** The aria label of the trigger. */
+    ariaLabel?: string;
+}
+interface PaginationItemRenderProps {
+    isSelected: boolean;
+    onClick: () => void;
+    value: number;
+    "aria-current"?: "page";
+    "aria-label"?: string;
+}
+interface PaginationItemProps {
+    /** The value of the pagination item. */
+    value: number;
+    /** Whether the pagination item is the current page. */
+    isCurrent: boolean;
+    /** The children of the pagination item. Can be a render prop or a valid element. */
+    children?: ReactNode | ((props: PaginationItemRenderProps) => ReactNode);
+    /** The style object of the pagination item. */
+    style?: CSSProperties;
+    /** The class name of the pagination item. */
+    className?: string | ((args: {
+        isSelected: boolean;
+    }) => string);
+    /** The aria label of the pagination item. */
+    ariaLabel?: string;
+    /** If true, the child element will be cloned and passed down the prop of the item. */
+    asChild?: boolean;
+}
+interface PaginationEllipsisProps {
+    key: number;
+    children?: ReactNode;
+    style?: CSSProperties;
+    className?: string | (() => string);
+}
+interface PaginationContextComponentProps {
+    children: (pagination: PaginationContextType) => ReactNode;
+}
+declare const Pagination: {
+    Root: ({ total, siblingCount, page, onPageChange, children, style, className }: PaginationRootProps) => React__default.JSX.Element;
+    PrevTrigger: FC<Omit<TriggerProps$1, "direction">>;
+    NextTrigger: FC<Omit<TriggerProps$1, "direction">>;
+    Item: ({ value, isCurrent, children, style, className, ariaLabel, asChild }: PaginationItemProps) => React__default.JSX.Element;
+    Ellipsis: FC<PaginationEllipsisProps>;
+    Context: FC<PaginationContextComponentProps>;
+};
+
+declare const getStarProgress: (starPosition: number, rating: number, maxRating?: number) => number;
+interface StarIconProps extends SVGProps<SVGSVGElement> {
+    /**
+     * The progress of the star icon. It should be a number between 0 and 100.
+     *
+     * @default 100
+     */
+    progress?: number;
+}
+declare const StarIcon: ({ progress, ...props }: StarIconProps) => React.JSX.Element;
+
+declare const Wreath: (props: HTMLAttributes<HTMLOrSVGElement>) => React.JSX.Element;
+
+interface SocialIconProps {
+    platform: string;
+    className?: string;
+}
+/** Renders the icon for a given platform (facebook, instagram, tiktok, etc.). */
+declare function SocialIcon({ platform, className }: SocialIconProps): React__default.ReactNode;
+/** Returns the icon element for a platform (for use in map/render). */
+declare function getSocialIcon(platform: string, className?: string): React__default.ReactNode;
+
+type CarouselApi = UseEmblaCarouselType[1];
+type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
+type CarouselOptions = UseCarouselParameters[0];
+type CarouselPlugin = UseCarouselParameters[1];
+type CarouselProps = {
+    /** The options for the Embla carousel. */
+    opts?: CarouselOptions;
+    /** The plugins for the Embla carousel. */
+    plugins?: CarouselPlugin;
+    /** The orientation of the carousel. */
+    orientation?: "horizontal" | "vertical";
+    /** The function to set the API for the carousel. */
+    setApi?: (api: CarouselApi) => void;
+};
+type CarouselContextProps = CarouselProps & {
+    /** The ref of the carousel. */
+    carouselRef: ReturnType<typeof useEmblaCarousel>[0];
+    /** The API of the carousel. */
+    api: ReturnType<typeof useEmblaCarousel>[1];
+    /** The function to scroll the carousel to the previous slide. */
+    scrollPrev: () => void;
+    /** The function to scroll the carousel to the next slide. */
+    scrollNext: () => void;
+    /** Whether the carousel can scroll to the previous slide. */
+    canScrollPrev: boolean;
+    /** Whether the carousel can scroll to the next slide. */
+    canScrollNext: boolean;
+    /** The index of the selected slide. */
+    selectedIndex: number;
+    /** The scroll snaps of the carousel. */
+    scrollSnaps: number[];
+};
+declare const CarouselContext: React.Context<CarouselContextProps | null>;
+declare const useCarousel: () => CarouselContextProps;
+interface CarouselContentProps extends ComponentPropsWithRef<"div"> {
+    /** The class name of the content. */
+    className?: string;
+    /** Whether to hide the overflow. */
+    overflowHidden?: boolean;
+}
+interface TriggerRenderProps {
+    isDisabled: boolean;
+    onClick: () => void;
+}
+interface TriggerProps {
+    /** The ref of the trigger. */
+    ref?: Ref<HTMLButtonElement>;
+    /** If true, the child element will be cloned and passed down the prop of the trigger. */
+    asChild?: boolean;
+    /** The direction of the trigger. */
+    direction: "prev" | "next";
+    /** The children of the trigger. Can be a render prop or a valid element. */
+    children: ReactNode | ((props: TriggerRenderProps) => ReactNode);
+    /** The style of the trigger. */
+    style?: CSSProperties;
+    /** The class name of the trigger. */
+    className?: string | ((args: {
+        isDisabled: boolean;
+    }) => string);
+}
+interface CarouselIndicatorRenderProps {
+    isSelected: boolean;
+    onClick: () => void;
+}
+interface CarouselIndicatorProps {
+    /** The index of the indicator. */
+    index: number;
+    /** If true, the child element will be cloned and passed down the prop of the indicator. */
+    asChild?: boolean;
+    /** If true, the indicator will be selected. */
+    isSelected?: boolean;
+    /** The children of the indicator. Can be a render prop or a valid element. */
+    children?: ReactNode | ((props: CarouselIndicatorRenderProps) => ReactNode);
+    /** The style of the indicator. */
+    style?: CSSProperties;
+    /** The class name of the indicator. */
+    className?: string | ((args: {
+        isSelected: boolean;
+    }) => string);
+}
+interface CarouselIndicatorGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    children: ReactNode | ((props: {
+        index: number;
+    }) => ReactNode);
+    className?: string;
+}
+declare const Carousel: {
+    Root: ({ orientation, opts, setApi, plugins, className, children, ...props }: ComponentPropsWithRef<"div"> & CarouselProps) => React.JSX.Element;
+    Content: ({ className, overflowHidden, ...props }: CarouselContentProps) => React.JSX.Element;
+    Item: ({ className, ...props }: ComponentPropsWithRef<"div">) => React.JSX.Element;
+    PrevTrigger: (props: Omit<TriggerProps, "direction">) => React.JSX.Element;
+    NextTrigger: (props: Omit<TriggerProps, "direction">) => React.JSX.Element;
+    IndicatorGroup: ({ children, ...props }: CarouselIndicatorGroupProps) => React.JSX.Element;
+    Indicator: ({ index, isSelected, children, asChild, className, style }: CarouselIndicatorProps) => React.JSX.Element;
+};
+
+interface CarouselSectionWrapperProps {
+    title: string;
+    subtitle?: string;
+    hasItems: boolean;
+    children: React__default.ReactNode;
+    emptyMessage?: string;
+}
+declare const CarouselSectionWrapper: ({ title, subtitle, hasItems, children, emptyMessage, }: CarouselSectionWrapperProps) => React__default.JSX.Element;
+
+type SelectItemType = {
+    id: string;
+    label?: string;
+    avatarUrl?: string;
+    isDisabled?: boolean;
+    supportingText?: string;
+    icon?: FC | ReactNode;
+};
+interface CommonProps {
+    hint?: string;
+    label?: string;
+    tooltip?: string;
+    size?: "sm" | "md";
+    placeholder?: string;
+}
+
+interface ComboBoxProps extends Omit<ComboBoxProps$1<SelectItemType>, "children" | "items">, RefAttributes<HTMLDivElement>, CommonProps {
+    shortcut?: boolean;
+    items?: SelectItemType[];
+    popoverClassName?: string;
+    shortcutClassName?: string;
+    children: ListBoxProps<SelectItemType>["children"];
+}
+declare const ComboBox: ({ placeholder, shortcut, size, children, items, shortcutClassName, ...otherProps }: ComboBoxProps) => React.JSX.Element;
+
+interface VideoModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    videoUrl: string;
+}
+declare function VideoModal({ isOpen, onClose, videoUrl }: VideoModalProps): React.JSX.Element | null;
+
+interface VideoPlayButtonProps {
+    onClick: () => void;
+    className?: string;
+}
+declare function VideoPlayButton({ onClick, className }: VideoPlayButtonProps): React.JSX.Element;
+
+interface ModalProps {
+    /** Whether the modal is open */
+    isOpen: boolean;
+    /** Called when the user requests close (button, Escape, or overlay click) */
+    onClose: () => void;
+    /** Optional title for the dialog (used for aria-labelledby) */
+    title?: string;
+    /** Optional id for the title element (must be set if title is set for a11y) */
+    titleId?: string;
+    /** Dialog content */
+    children: React__default.ReactNode;
+    /** Optional footer rendered below scrollable content (e.g. branding or action bars). */
+    footer?: React__default.ReactNode;
+    /**
+     * Hide the built-in header bar and close button. Use when the content provides its own
+     * title and close affordance (e.g. a form with its own header). Escape and overlay click
+     * still close the dialog.
+     */
+    hideHeader?: boolean;
+    /** Accessible name for the dialog when no visible title is rendered (i.e. when hideHeader is true). */
+    ariaLabel?: string;
+    /** Optional className for the overlay (backdrop) */
+    overlayClassName?: string;
+    /** Optional className for the dialog panel */
+    panelClassName?: string;
+    /** Optional max width class for the panel (default: max-w-md). Use max-w-lg, max-w-2xl, etc. */
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl';
+}
+/**
+ * Shared modal (dialog) component. Escape to close, aria-modal, overlay click to close, scroll lock, focus return on close.
+ * Use for detail views, confirmations, and other overlay content. Renders in place (use a portal from the consumer if needed).
+ * When `hideHeader` is true, provide an `aria-label` via `panelClassName` or ensure children supply a visible heading.
+ */
+declare function Modal({ isOpen, onClose, title, titleId, children, footer, hideHeader, ariaLabel, overlayClassName, panelClassName, maxWidth, }: ModalProps): React__default.JSX.Element | null;
+
+declare const Button: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const RoundButton: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const ButtonGroup: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Input: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const InputBase: {
+    ({ ref, tooltip, shortcut, groupRef, size, isInvalid, isDisabled, icon: Icon, placeholder, wrapperClassName, tooltipClassName, inputClassName, iconClassName, ...inputProps }: Omit<InputBaseProps, "label" | "hint" | "isRequired">): React__default.JSX.Element;
+    displayName: string;
+};
+declare const Textarea: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const PrivacyCheckbox: typeof PrivacyCheckbox$1;
+declare const Form: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const FormContainer: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const InputGroup: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Label: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const HintText: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Select: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const SelectItem: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const NativeSelect: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const PhotoWithFallback: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Badge: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const BadgeWithDot: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const BadgeGroup: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const RatingStars: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const RatingBadge: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Tooltip: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Avatar: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const AvatarLabelGroup: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const VerifiedTick: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const Breadcrumb: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const FeaturedIcon: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const PaginationPageDefault: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const PaginationPageMinimalCenter: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const GoogleMap: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+declare const MarkdownRenderer: (props: Record<string, unknown>) => React__default.ReactElement<Record<string, unknown>, string | React__default.JSXElementConstructor<any>>;
+
+export { Avatar, AvatarLabelGroup, Badge, BadgeGroup, BadgeWithDot, Breadcrumb, Button, ButtonGroup, Carousel, CarouselContext, CarouselSectionWrapper, ComboBox, FeaturedIcon, Form, FormContainer, GoogleMap, HintText, Input, InputBase, InputGroup, Label, MarkdownRenderer, Modal, type ModalProps, NativeSelect, Pagination, PaginationPageDefault, PaginationPageMinimalCenter, PhotoWithFallback, PrivacyCheckbox, RatingBadge, RatingStars, RoundButton, Select, SelectItem, SocialIcon, StarIcon, Textarea, Tooltip, VerifiedTick, VideoModal, VideoPlayButton, Wreath, getSocialIcon, getStarProgress, useCarousel };

package/dist/design_system/logo/keystone-logo.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import { HTMLAttributes } from 'react';
+
+declare const KeystoneLogo: (props: HTMLAttributes<HTMLOrSVGElement>) => React.JSX.Element;
+
+export { KeystoneLogo };