@cdt5058/json-render-uswds 0.0.1 → 0.1.0

package/dist/catalog.d.ts

@@ -0,0 +1,1325 @@
+import { z } from 'zod';
+
+/**
+ * U.S. Web Design System (USWDS) component definitions for json-render catalogs.
+ *
+ * These components follow USWDS design guidelines and use official `usa-*` CSS
+ * class names. Users must include the USWDS CSS in their project:
+ *
+ * ```ts
+ * import "@uswds/uswds/css/uswds.css";
+ * // or via CDN: https://designsystem.digital.gov/how-to-use-uswds/
+ * ```
+ *
+ * All components are built with accessibility in mind and follow WCAG 2.1 AA.
+ */
+declare const uswdsComponentDefinitions: {
+    Grid: {
+        props: z.ZodObject<{
+            columns: z.ZodNullable<z.ZodNumber>;
+            gap: z.ZodNullable<z.ZodEnum<{
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+            }>>;
+        }, z.core.$strip>;
+        slots: string[];
+        description: string;
+        example: {
+            columns: number;
+            gap: string;
+        };
+    };
+    CardGroup: {
+        props: z.ZodObject<{
+            cards: z.ZodArray<z.ZodObject<{
+                title: z.ZodNullable<z.ZodString>;
+                description: z.ZodNullable<z.ZodString>;
+                mediaUrl: z.ZodNullable<z.ZodString>;
+                mediaAlt: z.ZodNullable<z.ZodString>;
+                footer: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            flag: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            cards: {
+                title: string;
+                description: string;
+                mediaUrl: null;
+                mediaAlt: null;
+                footer: null;
+            }[];
+        };
+    };
+    Card: {
+        props: z.ZodObject<{
+            title: z.ZodNullable<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            headerFirst: z.ZodNullable<z.ZodBoolean>;
+            mediaUrl: z.ZodNullable<z.ZodString>;
+            mediaAlt: z.ZodNullable<z.ZodString>;
+            flag: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        slots: string[];
+        description: string;
+        example: {
+            title: string;
+            description: string;
+        };
+    };
+    Divider: {
+        props: z.ZodObject<{}, z.core.$strip>;
+        description: string;
+    };
+    Footer: {
+        props: z.ZodObject<{
+            variant: z.ZodNullable<z.ZodEnum<{
+                slim: "slim";
+                medium: "medium";
+                big: "big";
+            }>>;
+            agencyName: z.ZodString;
+            agencyUrl: z.ZodNullable<z.ZodString>;
+            logoUrl: z.ZodNullable<z.ZodString>;
+            logoAlt: z.ZodNullable<z.ZodString>;
+            navGroups: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                heading: z.ZodNullable<z.ZodString>;
+                links: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            contactHeading: z.ZodNullable<z.ZodString>;
+            contactInfo: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    address: "address";
+                    phone: "phone";
+                    email: "email";
+                }>;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+            socialLinks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                platform: z.ZodEnum<{
+                    facebook: "facebook";
+                    twitter: "twitter";
+                    youtube: "youtube";
+                    instagram: "instagram";
+                    rss: "rss";
+                    linkedin: "linkedin";
+                    github: "github";
+                }>;
+                href: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            returnToTop: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            variant: string;
+            agencyName: string;
+            agencyUrl: string;
+            logoUrl: null;
+            logoAlt: null;
+            navGroups: {
+                heading: null;
+                links: {
+                    label: string;
+                    href: string;
+                }[];
+            }[];
+            contactHeading: string;
+            contactInfo: {
+                type: string;
+                value: string;
+            }[];
+            socialLinks: null;
+            returnToTop: boolean;
+        };
+    };
+    Accordion: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                content: z.ZodString;
+                expanded: z.ZodNullable<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            bordered: z.ZodNullable<z.ZodBoolean>;
+            multiselectable: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            items: {
+                title: string;
+                content: string;
+            }[];
+        };
+    };
+    Pagination: {
+        props: z.ZodObject<{
+            totalPages: z.ZodNumber;
+            page: z.ZodNullable<z.ZodNumber>;
+            ariaLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            totalPages: number;
+            page: number;
+        };
+    };
+    StepIndicator: {
+        props: z.ZodObject<{
+            steps: z.ZodArray<z.ZodString>;
+            currentStep: z.ZodNumber;
+            counters: z.ZodNullable<z.ZodEnum<{
+                default: "default";
+                small: "small";
+            }>>;
+            centered: z.ZodNullable<z.ZodBoolean>;
+            noLabels: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            steps: string[];
+            currentStep: number;
+        };
+    };
+    Header: {
+        props: z.ZodObject<{
+            variant: z.ZodNullable<z.ZodEnum<{
+                basic: "basic";
+                extended: "extended";
+            }>>;
+            siteName: z.ZodString;
+            siteUrl: z.ZodNullable<z.ZodString>;
+            logoUrl: z.ZodNullable<z.ZodString>;
+            logoAlt: z.ZodNullable<z.ZodString>;
+            navItems: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+                current: z.ZodNullable<z.ZodBoolean>;
+                items: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            showSearch: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            variant: string;
+            siteName: string;
+            siteUrl: string;
+            logoUrl: null;
+            logoAlt: null;
+            navItems: ({
+                label: string;
+                href: string;
+                current: boolean;
+                items: null;
+            } | {
+                label: string;
+                href: string;
+                current: boolean;
+                items: {
+                    label: string;
+                    href: string;
+                }[];
+            })[];
+            showSearch: boolean;
+        };
+    };
+    SkipNav: {
+        props: z.ZodObject<{
+            href: z.ZodNullable<z.ZodString>;
+            label: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            href: string;
+            label: string;
+        };
+    };
+    SideNav: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+                current: z.ZodNullable<z.ZodBoolean>;
+                children: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    href: z.ZodString;
+                    current: z.ZodNullable<z.ZodBoolean>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            ariaLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            ariaLabel: string;
+            items: ({
+                label: string;
+                href: string;
+                current: boolean;
+                children: null;
+            } | {
+                label: string;
+                href: string;
+                current: boolean;
+                children: {
+                    label: string;
+                    href: string;
+                    current: boolean;
+                }[];
+            })[];
+        };
+    };
+    LanguageSelector: {
+        props: z.ZodObject<{
+            languages: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+                lang: z.ZodString;
+                localLabel: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            currentLang: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            currentLang: string;
+            languages: ({
+                label: string;
+                href: string;
+                lang: string;
+                localLabel: null;
+            } | {
+                label: string;
+                href: string;
+                lang: string;
+                localLabel: string;
+            })[];
+        };
+    };
+    Link: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            external: z.ZodNullable<z.ZodBoolean>;
+            variant: z.ZodNullable<z.ZodEnum<{
+                default: "default";
+                nav: "nav";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            href: string;
+        };
+    };
+    InPageNavigation: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>;
+            heading: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            items: {
+                label: string;
+                href: string;
+            }[];
+        };
+    };
+    Breadcrumb: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            items: ({
+                label: string;
+                href: string;
+            } | {
+                label: string;
+                href: null;
+            })[];
+        };
+    };
+    Identifier: {
+        props: z.ZodObject<{
+            domain: z.ZodString;
+            agencyName: z.ZodString;
+            agencyUrl: z.ZodNullable<z.ZodString>;
+            logoUrl: z.ZodNullable<z.ZodString>;
+            logoAlt: z.ZodNullable<z.ZodString>;
+            disclaimer: z.ZodNullable<z.ZodString>;
+            links: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>>;
+            showUsagov: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            domain: string;
+            agencyName: string;
+            agencyUrl: string;
+            logoUrl: null;
+            logoAlt: null;
+            disclaimer: null;
+            links: {
+                label: string;
+                href: string;
+            }[];
+            showUsagov: boolean;
+        };
+    };
+    GovBanner: {
+        props: z.ZodObject<{
+            tld: z.ZodNullable<z.ZodEnum<{
+                ".gov": ".gov";
+                ".mil": ".mil";
+            }>>;
+            expanded: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            tld: string;
+        };
+    };
+    Collection: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                href: z.ZodNullable<z.ZodString>;
+                description: z.ZodNullable<z.ZodString>;
+                date: z.ZodNullable<z.ZodString>;
+                dateLabel: z.ZodNullable<z.ZodString>;
+                tags: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                thumbnailUrl: z.ZodNullable<z.ZodString>;
+                thumbnailAlt: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            items: {
+                heading: string;
+                href: string;
+                description: string;
+                date: string;
+                dateLabel: string;
+                tags: string[];
+                thumbnailUrl: null;
+                thumbnailAlt: null;
+            }[];
+        };
+    };
+    IconList: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                icon: z.ZodString;
+                content: z.ZodString;
+                color: z.ZodNullable<z.ZodEnum<{
+                    success: "success";
+                    default: "default";
+                    warning: "warning";
+                    error: "error";
+                    info: "info";
+                }>>;
+            }, z.core.$strip>>;
+            title: z.ZodNullable<z.ZodString>;
+            size: z.ZodNullable<z.ZodEnum<{
+                sm: "sm";
+                lg: "lg";
+                xl: "xl";
+                "2xl": "2xl";
+                "3xl": "3xl";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            title: string;
+            items: {
+                icon: string;
+                content: string;
+                color: string;
+            }[];
+        };
+    };
+    Tooltip: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            content: z.ZodString;
+            position: z.ZodNullable<z.ZodEnum<{
+                top: "top";
+                bottom: "bottom";
+                left: "left";
+                right: "right";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            label: string;
+            content: string;
+            position: string;
+        };
+    };
+    Table: {
+        props: z.ZodObject<{
+            columns: z.ZodArray<z.ZodString>;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            caption: z.ZodNullable<z.ZodString>;
+            borderless: z.ZodNullable<z.ZodBoolean>;
+            striped: z.ZodNullable<z.ZodBoolean>;
+            compact: z.ZodNullable<z.ZodBoolean>;
+            scrollable: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            columns: string[];
+            rows: string[][];
+        };
+    };
+    Heading: {
+        props: z.ZodObject<{
+            text: z.ZodString;
+            level: z.ZodNullable<z.ZodEnum<{
+                h1: "h1";
+                h2: "h2";
+                h3: "h3";
+                h4: "h4";
+                h5: "h5";
+                h6: "h6";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            text: string;
+            level: string;
+        };
+    };
+    Text: {
+        props: z.ZodObject<{
+            text: z.ZodString;
+            variant: z.ZodNullable<z.ZodEnum<{
+                small: "small";
+                body: "body";
+                lead: "lead";
+                code: "code";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            text: string;
+        };
+    };
+    Alert: {
+        props: z.ZodObject<{
+            heading: z.ZodNullable<z.ZodString>;
+            message: z.ZodString;
+            type: z.ZodNullable<z.ZodEnum<{
+                success: "success";
+                warning: "warning";
+                error: "error";
+                info: "info";
+                emergency: "emergency";
+            }>>;
+            slim: z.ZodNullable<z.ZodBoolean>;
+            noIcon: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            message: string;
+            type: string;
+        };
+    };
+    SiteAlert: {
+        props: z.ZodObject<{
+            heading: z.ZodNullable<z.ZodString>;
+            message: z.ZodString;
+            type: z.ZodNullable<z.ZodEnum<{
+                info: "info";
+                emergency: "emergency";
+            }>>;
+            slim: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            message: string;
+            type: string;
+        };
+    };
+    Tag: {
+        props: z.ZodObject<{
+            text: z.ZodString;
+            big: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            text: string;
+        };
+    };
+    SummaryBox: {
+        props: z.ZodObject<{
+            heading: z.ZodString;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            items: string[];
+        };
+    };
+    ProcessList: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                content: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            items: {
+                heading: string;
+                content: string;
+            }[];
+        };
+    };
+    Button: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            variant: z.ZodNullable<z.ZodEnum<{
+                default: "default";
+                big: "big";
+                secondary: "secondary";
+                "accent-cool": "accent-cool";
+                "accent-warm": "accent-warm";
+                base: "base";
+                outline: "outline";
+                "outline-inverse": "outline-inverse";
+                unstyled: "unstyled";
+            }>>;
+            disabled: z.ZodNullable<z.ZodBoolean>;
+            type: z.ZodNullable<z.ZodEnum<{
+                submit: "submit";
+                button: "button";
+                reset: "reset";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            variant: string;
+        };
+    };
+    ButtonGroup: {
+        props: z.ZodObject<{
+            buttons: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+                variant: z.ZodNullable<z.ZodEnum<{
+                    default: "default";
+                    secondary: "secondary";
+                    outline: "outline";
+                }>>;
+            }, z.core.$strip>>;
+            segmented: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            buttons: {
+                label: string;
+                value: string;
+                variant: string;
+            }[];
+        };
+    };
+    Input: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodNullable<z.ZodEnum<{
+                number: "number";
+                email: "email";
+                text: "text";
+                password: "password";
+                search: "search";
+                tel: "tel";
+                url: "url";
+            }>>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            disabled: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            type: string;
+            hint: string;
+        };
+    };
+    Textarea: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            placeholder: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            rows: z.ZodNullable<z.ZodNumber>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            rows: number;
+        };
+    };
+    Select: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            options: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>]>>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            options: string[];
+        };
+    };
+    Checkbox: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            checked: z.ZodNullable<z.ZodBoolean>;
+            tile: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+        };
+    };
+    CheckboxGroup: {
+        props: z.ZodObject<{
+            legend: z.ZodString;
+            name: z.ZodString;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+                hint: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            tile: z.ZodNullable<z.ZodBoolean>;
+            values: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            legend: string;
+            name: string;
+            options: {
+                label: string;
+                value: string;
+                hint: null;
+            }[];
+        };
+    };
+    Radio: {
+        props: z.ZodObject<{
+            legend: z.ZodString;
+            name: z.ZodString;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+                hint: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            tile: z.ZodNullable<z.ZodBoolean>;
+            value: z.ZodNullable<z.ZodString>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            legend: string;
+            name: string;
+            options: {
+                label: string;
+                value: string;
+                hint: null;
+            }[];
+        };
+    };
+    FileInput: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            accept: z.ZodNullable<z.ZodString>;
+            multiple: z.ZodNullable<z.ZodBoolean>;
+            required: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            hint: string;
+            accept: string;
+        };
+    };
+    Search: {
+        props: z.ZodObject<{
+            label: z.ZodNullable<z.ZodString>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            size: z.ZodNullable<z.ZodEnum<{
+                medium: "medium";
+                big: "big";
+                small: "small";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            placeholder: string;
+            size: string;
+        };
+    };
+    RangeInput: {
+        props: z.ZodObject<{
+            label: z.ZodNullable<z.ZodString>;
+            name: z.ZodString;
+            min: z.ZodNullable<z.ZodNumber>;
+            max: z.ZodNullable<z.ZodNumber>;
+            step: z.ZodNullable<z.ZodNumber>;
+            value: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            min: number;
+            max: number;
+        };
+    };
+    DateInputGroup: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            monthValue: z.ZodNullable<z.ZodString>;
+            dayValue: z.ZodNullable<z.ZodString>;
+            yearValue: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            hint: string;
+        };
+    };
+    DateRangePicker: {
+        props: z.ZodObject<{
+            startLabel: z.ZodString;
+            endLabel: z.ZodString;
+            startName: z.ZodString;
+            endName: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            startValue: z.ZodNullable<z.ZodString>;
+            endValue: z.ZodNullable<z.ZodString>;
+            minDate: z.ZodNullable<z.ZodString>;
+            maxDate: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            startLabel: string;
+            endLabel: string;
+            startName: string;
+            endName: string;
+            hint: string;
+        };
+    };
+    InputMask: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            preset: z.ZodNullable<z.ZodEnum<{
+                custom: "custom";
+                phone: "phone";
+                zip: "zip";
+                "zip+4": "zip+4";
+                ssn: "ssn";
+            }>>;
+            pattern: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            preset: string;
+            hint: string;
+        };
+    };
+    Password: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            hint: string;
+        };
+    };
+    ComboBox: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            options: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>]>>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            options: string[];
+            placeholder: string;
+        };
+    };
+    DatePicker: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            minDate: z.ZodNullable<z.ZodString>;
+            maxDate: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            hint: string;
+        };
+    };
+    TimePicker: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            minTime: z.ZodNullable<z.ZodString>;
+            maxTime: z.ZodNullable<z.ZodString>;
+            step: z.ZodNullable<z.ZodNumber>;
+            required: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            hint: string;
+            step: number;
+        };
+    };
+    CharacterCount: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            maxLength: z.ZodNumber;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            multiline: z.ZodNullable<z.ZodBoolean>;
+            rows: z.ZodNullable<z.ZodNumber>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            maxLength: number;
+            hint: string;
+            multiline: boolean;
+        };
+    };
+    Modal: {
+        props: z.ZodObject<{
+            heading: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            openPath: z.ZodString;
+            large: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        slots: string[];
+        description: string;
+        example: {
+            heading: string;
+            description: string;
+            openPath: string;
+        };
+    };
+    Icon: {
+        props: z.ZodObject<{
+            name: z.ZodString;
+            size: z.ZodNullable<z.ZodEnum<{
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+                xl: "xl";
+                "2xl": "2xl";
+                "3xl": "3xl";
+            }>>;
+            color: z.ZodNullable<z.ZodString>;
+            ariaLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            name: string;
+            size: string;
+            color: string;
+        };
+    };
+    InputGroup: {
+        props: z.ZodObject<{
+            label: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodNullable<z.ZodEnum<{
+                number: "number";
+                email: "email";
+                text: "text";
+                password: "password";
+                search: "search";
+                tel: "tel";
+                url: "url";
+            }>>;
+            prefix: z.ZodNullable<z.ZodString>;
+            suffix: z.ZodNullable<z.ZodString>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            required: z.ZodNullable<z.ZodBoolean>;
+            disabled: z.ZodNullable<z.ZodBoolean>;
+            checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                message: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            validateOn: z.ZodNullable<z.ZodEnum<{
+                change: "change";
+                blur: "blur";
+                submit: "submit";
+            }>>;
+        }, z.core.$strip>;
+        events: string[];
+        description: string;
+        example: {
+            label: string;
+            name: string;
+            prefix: string;
+            suffix: string;
+            type: string;
+            placeholder: string;
+        };
+    };
+    List: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodString>;
+            variant: z.ZodNullable<z.ZodEnum<{
+                unstyled: "unstyled";
+                unordered: "unordered";
+                ordered: "ordered";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            variant: string;
+            items: string[];
+        };
+    };
+    ValidationChecklist: {
+        props: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                checked: z.ZodNullable<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            heading: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            items: {
+                label: string;
+                checked: boolean;
+            }[];
+        };
+    };
+    Prose: {
+        props: z.ZodObject<{
+            element: z.ZodNullable<z.ZodEnum<{
+                div: "div";
+                article: "article";
+                section: "section";
+                main: "main";
+            }>>;
+        }, z.core.$strip>;
+        slots: string[];
+        description: string;
+        example: {
+            element: string;
+        };
+    };
+    Hero: {
+        props: z.ZodObject<{
+            heading: z.ZodString;
+            eyebrow: z.ZodNullable<z.ZodString>;
+            body: z.ZodNullable<z.ZodString>;
+            backgroundUrl: z.ZodNullable<z.ZodString>;
+            ariaLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: string;
+            eyebrow: null;
+            body: string;
+            backgroundUrl: null;
+            ariaLabel: string;
+        };
+    };
+    GraphicList: {
+        props: z.ZodObject<{
+            heading: z.ZodNullable<z.ZodString>;
+            items: z.ZodArray<z.ZodObject<{
+                imageUrl: z.ZodNullable<z.ZodString>;
+                imageAlt: z.ZodNullable<z.ZodString>;
+                heading: z.ZodString;
+                content: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            heading: null;
+            items: {
+                imageUrl: null;
+                imageAlt: null;
+                heading: string;
+                content: string;
+            }[];
+        };
+    };
+    EmbedContainer: {
+        props: z.ZodObject<{
+            src: z.ZodString;
+            title: z.ZodString;
+            ratio: z.ZodNullable<z.ZodEnum<{
+                "16x9": "16x9";
+                "4x3": "4x3";
+            }>>;
+        }, z.core.$strip>;
+        description: string;
+        example: {
+            src: string;
+            title: string;
+            ratio: string;
+        };
+    };
+    Form: {
+        props: z.ZodObject<{
+            large: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strip>;
+        slots: string[];
+        events: string[];
+        description: string;
+        example: {
+            large: boolean;
+        };
+    };
+    Section: {
+        props: z.ZodObject<{
+            title: z.ZodNullable<z.ZodString>;
+            text: z.ZodNullable<z.ZodString>;
+            variant: z.ZodNullable<z.ZodEnum<{
+                default: "default";
+                light: "light";
+                dark: "dark";
+            }>>;
+        }, z.core.$strip>;
+        slots: string[];
+        description: string;
+        example: {
+            title: string;
+            text: string;
+            variant: null;
+        };
+    };
+};
+/**
+ * Type for a USWDS component definition
+ */
+type UswdsComponentDefinition = {
+    props: z.ZodType;
+    slots?: string[];
+    events?: string[];
+    description: string;
+    example?: Record<string, unknown>;
+};
+/**
+ * Infer the props type for a USWDS component by name.
+ *
+ * @example
+ * ```ts
+ * type ButtonProps = UswdsProps<"Button">;
+ * // { label: string; variant: string | null; disabled: boolean | null; ... }
+ * ```
+ */
+type UswdsProps<K extends keyof typeof uswdsComponentDefinitions> = z.output<(typeof uswdsComponentDefinitions)[K]["props"]>;
+
+export { type UswdsComponentDefinition, type UswdsProps, uswdsComponentDefinitions };