@frontmcp/ui 0.5.1 → 0.6.0

package/components/button.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @file button.ts
+ * @description Button Component for FrontMCP UI.
+ *
+ * Versatile button component with multiple variants, sizes, and states.
+ *
+ * @example Basic button
+ * ```typescript
+ * import { button } from '@frontmcp/ui';
+ *
+ * // Primary button (default)
+ * const html = button('Click Me');
+ * // <button type="button" class="...bg-primary...">Click Me</button>
+ * ```
+ *
+ * @example Button variants
+ * ```typescript
+ * import { button, primaryButton, dangerButton, outlineButton } from '@frontmcp/ui';
+ *
+ * // Using variant option
+ * const secondary = button('Save', { variant: 'secondary' });
+ * const danger = button('Delete', { variant: 'danger' });
+ *
+ * // Using shorthand functions
+ * const primary = primaryButton('Submit');
+ * const outline = outlineButton('Cancel');
+ * ```
+ *
+ * @example Button with loading state
+ * ```typescript
+ * const loadingBtn = button('Saving...', {
+ *   loading: true,
+ *   disabled: true,
+ * });
+ * ```
+ *
+ * @example Button group
+ * ```typescript
+ * import { button, buttonGroup } from '@frontmcp/ui';
+ *
+ * const group = buttonGroup([
+ *   button('Edit', { variant: 'outline' }),
+ *   button('Delete', { variant: 'danger' }),
+ * ], { attached: true });
+ * ```
+ *
+ * @module @frontmcp/ui/components/button
+ */
+import { type ButtonOptions, type ButtonVariant, type ButtonSize, type ButtonGroupOptions } from './button.schema';
+export type { ButtonOptions, ButtonVariant, ButtonSize, ButtonGroupOptions };
+/**
+ * Build a button component
+ *
+ * @param text - Button label text (used as aria-label for icon-only buttons)
+ * @param options - Button configuration options
+ * @returns HTML string for the button, or validation error box on invalid input
+ *
+ * @remarks
+ * **Security considerations:**
+ * - The `iconBefore` and `iconAfter` options accept raw HTML strings for SVG icons.
+ *   These are NOT escaped and should only contain trusted content (e.g., icon library output).
+ *   Never pass user-provided content to these options.
+ * - The `href` option uses an allowlist for safe protocols. Only the following are allowed:
+ *   - `http://`, `https://` - absolute URLs
+ *   - `/` - absolute paths (e.g., "/login", "/api/users")
+ *   - `#` - anchor links (e.g., "#section")
+ *   - `mailto:` - email links
+ *   - `tel:` - phone links
+ *   Note: Bare relative URLs like "login" or "./foo" are NOT allowed and will fall back to
+ *   button behavior. Use absolute paths ("/login") instead.
+ * - The `data` option keys are sanitized to prevent malformed attributes.
+ *
+ * **Accessibility:**
+ * - When `iconOnly: true`, the `text` parameter is automatically used as `aria-label`
+ *   unless an explicit `ariaLabel` option is provided.
+ * - Empty button text with `iconOnly: false` will log a warning for accessibility.
+ * - Icon-only buttons without text or ariaLabel will log a warning.
+ */
+export declare function button(text: string, options?: ButtonOptions): string;
+/**
+ * Build a button group
+ *
+ * @param buttons - Array of button HTML strings
+ * @param options - Button group configuration options
+ * @returns HTML string for the button group, or validation error box on invalid input
+ */
+export declare function buttonGroup(buttons: string[], options?: ButtonGroupOptions): string;
+/** Primary button shorthand */
+export declare const primaryButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+/** Secondary button shorthand */
+export declare const secondaryButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+/** Outline button shorthand */
+export declare const outlineButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+/** Ghost button shorthand */
+export declare const ghostButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+/** Danger button shorthand */
+export declare const dangerButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+/** Link button shorthand */
+export declare const linkButton: (text: string, opts?: Omit<ButtonOptions, "variant">) => string;
+//# sourceMappingURL=button.d.ts.map

package/components/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/components/button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;AAyF7E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAkHxE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAkCvF;AAMD,+BAA+B;AAC/B,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC;AAEhD,iCAAiC;AACjC,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC;AAElD,+BAA+B;AAC/B,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC;AAEhD,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC;AAE9C,8BAA8B;AAC9B,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC;AAE/C,4BAA4B;AAC5B,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,WAClC,CAAC"}

package/components/button.schema.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @file button.schema.ts
+ * @description Zod schemas for Button component options validation.
+ *
+ * Provides strict validation schemas for button options including variants,
+ * sizes, and data attributes. All schemas use .strict()
+ * to reject unknown properties.
+ *
+ * @example
+ * ```typescript
+ * import { ButtonOptionsSchema } from '@frontmcp/ui';
+ *
+ * // Validate button options
+ * const result = ButtonOptionsSchema.safeParse({ variant: 'primary' });
+ * if (result.success) {
+ *   // Use result.data
+ * }
+ * ```
+ *
+ * @module @frontmcp/ui/components/button.schema
+ */
+import { z } from 'zod';
+/**
+ * Button variant enum schema
+ */
+export declare const ButtonVariantSchema: z.ZodEnum<{
+    primary: "primary";
+    secondary: "secondary";
+    link: "link";
+    success: "success";
+    danger: "danger";
+    outline: "outline";
+    ghost: "ghost";
+}>;
+/**
+ * Button variant type
+ */
+export type ButtonVariant = z.infer<typeof ButtonVariantSchema>;
+/**
+ * Button size enum schema
+ */
+export declare const ButtonSizeSchema: z.ZodEnum<{
+    xs: "xs";
+    sm: "sm";
+    lg: "lg";
+    xl: "xl";
+    md: "md";
+}>;
+/**
+ * Button size type
+ */
+export type ButtonSize = z.infer<typeof ButtonSizeSchema>;
+/**
+ * Complete button options schema
+ */
+export declare const ButtonOptionsSchema: z.ZodObject<{
+    variant: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+        link: "link";
+        success: "success";
+        danger: "danger";
+        outline: "outline";
+        ghost: "ghost";
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        xs: "xs";
+        sm: "sm";
+        lg: "lg";
+        xl: "xl";
+        md: "md";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        button: "button";
+        submit: "submit";
+        reset: "reset";
+    }>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    loading: z.ZodOptional<z.ZodBoolean>;
+    fullWidth: z.ZodOptional<z.ZodBoolean>;
+    iconBefore: z.ZodOptional<z.ZodString>;
+    iconAfter: z.ZodOptional<z.ZodString>;
+    iconOnly: z.ZodOptional<z.ZodBoolean>;
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodEnum<{
+        _blank: "_blank";
+        _self: "_self";
+    }>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Button options type (derived from schema)
+ */
+export type ButtonOptions = z.infer<typeof ButtonOptionsSchema>;
+/**
+ * Button group options schema
+ */
+export declare const ButtonGroupOptionsSchema: z.ZodObject<{
+    attached: z.ZodOptional<z.ZodBoolean>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+    gap: z.ZodOptional<z.ZodEnum<{
+        sm: "sm";
+        lg: "lg";
+        md: "md";
+    }>>;
+    className: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Button group options type
+ */
+export type ButtonGroupOptions = z.infer<typeof ButtonGroupOptionsSchema>;
+//# sourceMappingURL=button.schema.d.ts.map

package/components/button.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.schema.d.ts","sourceRoot":"","sources":["../../src/components/button.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;EAAoF,CAAC;AAErH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAAyC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqCrB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAW1B,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/components/card.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Card Component
+ *
+ * Versatile card component for content containers.
+ */
+/**
+ * Card variant styles
+ */
+export type CardVariant = 'default' | 'outlined' | 'elevated' | 'filled' | 'ghost';
+/**
+ * Card size options
+ */
+export type CardSize = 'sm' | 'md' | 'lg';
+/**
+ * Card component options
+ */
+export interface CardOptions {
+    /** Card variant */
+    variant?: CardVariant;
+    /** Card size (padding) */
+    size?: CardSize;
+    /** Card title */
+    title?: string;
+    /** Card subtitle/description */
+    subtitle?: string;
+    /** Header actions (HTML) */
+    headerActions?: string;
+    /** Footer content (HTML) */
+    footer?: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Card ID */
+    id?: string;
+    /** Data attributes */
+    data?: Record<string, string>;
+    /** Clickable card (adds hover effects) */
+    clickable?: boolean;
+    /** Click handler URL */
+    href?: string;
+}
+/**
+ * Build a card component
+ */
+export declare function card(content: string, options?: CardOptions): string;
+/**
+ * Build a card group (horizontal or vertical)
+ */
+export declare function cardGroup(cards: string[], options?: {
+    direction?: 'horizontal' | 'vertical';
+    gap?: 'sm' | 'md' | 'lg';
+    className?: string;
+}): string;
+//# sourceMappingURL=card.d.ts.map

package/components/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/components/card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0CD;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAoDvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACtC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,MAAM,CASR"}

package/components/card.schema.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @file card.schema.ts
+ * @description Zod schemas for Card component options validation.
+ *
+ * Provides strict validation schemas for card options including variants,
+ * sizes, and clickable behavior.
+ *
+ * @example
+ * ```typescript
+ * import { CardOptionsSchema } from '@frontmcp/ui';
+ *
+ * const result = CardOptionsSchema.safeParse({ variant: 'elevated' });
+ * ```
+ *
+ * @module @frontmcp/ui/components/card.schema
+ */
+import { z } from 'zod';
+/**
+ * Card variant enum schema
+ */
+export declare const CardVariantSchema: z.ZodEnum<{
+    default: "default";
+    elevated: "elevated";
+    ghost: "ghost";
+    outlined: "outlined";
+    filled: "filled";
+}>;
+/**
+ * Card variant type
+ */
+export type CardVariant = z.infer<typeof CardVariantSchema>;
+/**
+ * Card size enum schema
+ */
+export declare const CardSizeSchema: z.ZodEnum<{
+    sm: "sm";
+    lg: "lg";
+    md: "md";
+}>;
+/**
+ * Card size type
+ */
+export type CardSize = z.infer<typeof CardSizeSchema>;
+/**
+ * Complete card options schema
+ */
+export declare const CardOptionsSchema: z.ZodObject<{
+    variant: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        elevated: "elevated";
+        ghost: "ghost";
+        outlined: "outlined";
+        filled: "filled";
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        sm: "sm";
+        lg: "lg";
+        md: "md";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    headerActions: z.ZodOptional<z.ZodString>;
+    footer: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    clickable: z.ZodOptional<z.ZodBoolean>;
+    href: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Card options type (derived from schema)
+ */
+export type CardOptions = z.infer<typeof CardOptionsSchema>;
+/**
+ * Card group options schema
+ */
+export declare const CardGroupOptionsSchema: z.ZodObject<{
+    direction: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+    gap: z.ZodOptional<z.ZodEnum<{
+        sm: "sm";
+        lg: "lg";
+        md: "md";
+    }>>;
+    className: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Card group options type
+ */
+export type CardGroupOptions = z.infer<typeof CardGroupOptionsSchema>;
+//# sourceMappingURL=card.schema.d.ts.map

package/components/card.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.schema.d.ts","sourceRoot":"","sources":["../../src/components/card.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAAiE,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAA6B,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;kBAyBnB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;kBASxB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/components/form.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Form Components
+ *
+ * Form elements including inputs, selects, textareas, and form layouts.
+ */
+/**
+ * Input type options
+ */
+export type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | 'date' | 'time' | 'datetime-local' | 'hidden';
+/**
+ * Input size options
+ */
+export type InputSize = 'sm' | 'md' | 'lg';
+/**
+ * Input state
+ */
+export type InputState = 'default' | 'error' | 'success' | 'warning';
+/**
+ * Base input options
+ */
+export interface InputOptions {
+    /** Input type */
+    type?: InputType;
+    /** Input name */
+    name: string;
+    /** Input ID (defaults to name) */
+    id?: string;
+    /** Input value */
+    value?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Label text */
+    label?: string;
+    /** Helper text */
+    helper?: string;
+    /** Error message */
+    error?: string;
+    /** Input size */
+    size?: InputSize;
+    /** Input state */
+    state?: InputState;
+    /** Required field */
+    required?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Readonly state */
+    readonly?: boolean;
+    /** Autocomplete attribute */
+    autocomplete?: string;
+    /** Pattern for validation */
+    pattern?: string;
+    /** Min value (for number/date) */
+    min?: string | number;
+    /** Max value (for number/date) */
+    max?: string | number;
+    /** Step value (for number) */
+    step?: string | number;
+    /** Additional CSS classes */
+    className?: string;
+    /** Data attributes */
+    data?: Record<string, string>;
+    /** Icon before input */
+    iconBefore?: string;
+    /** Icon after input */
+    iconAfter?: string;
+}
+/**
+ * Select options
+ */
+export interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    selected?: boolean;
+}
+export interface SelectOptions extends Omit<InputOptions, 'type' | 'pattern' | 'min' | 'max' | 'step' | 'autocomplete'> {
+    /** Select options */
+    options: SelectOption[];
+    /** Multiple selection */
+    multiple?: boolean;
+}
+/**
+ * Textarea options
+ */
+export interface TextareaOptions extends Omit<InputOptions, 'type' | 'pattern' | 'min' | 'max' | 'step'> {
+    /** Number of rows */
+    rows?: number;
+    /** Resize behavior */
+    resize?: 'none' | 'vertical' | 'horizontal' | 'both';
+}
+/**
+ * Checkbox options
+ */
+export interface CheckboxOptions {
+    /** Input name */
+    name: string;
+    /** Input ID */
+    id?: string;
+    /** Input value */
+    value?: string;
+    /** Label text */
+    label: string;
+    /** Checked state */
+    checked?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Helper text */
+    helper?: string;
+    /** Error message */
+    error?: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Radio group options
+ */
+export interface RadioGroupOptions {
+    /** Group name */
+    name: string;
+    /** Radio options */
+    options: Array<{
+        value: string;
+        label: string;
+        disabled?: boolean;
+    }>;
+    /** Selected value */
+    value?: string;
+    /** Label for the group */
+    label?: string;
+    /** Helper text */
+    helper?: string;
+    /** Error message */
+    error?: string;
+    /** Layout direction */
+    direction?: 'horizontal' | 'vertical';
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a text input component
+ */
+export declare function input(options: InputOptions): string;
+/**
+ * Build a select component
+ */
+export declare function select(options: SelectOptions): string;
+/**
+ * Build a textarea component
+ */
+export declare function textarea(options: TextareaOptions): string;
+/**
+ * Build a checkbox component
+ */
+export declare function checkbox(options: CheckboxOptions): string;
+/**
+ * Build a radio group component
+ */
+export declare function radioGroup(options: RadioGroupOptions): string;
+/**
+ * Form wrapper options
+ */
+export interface FormOptions {
+    /** Form action URL */
+    action?: string;
+    /** HTTP method */
+    method?: 'get' | 'post';
+    /** Form ID */
+    id?: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Prevent default submission */
+    preventDefault?: boolean;
+    /** Autocomplete */
+    autocomplete?: 'on' | 'off';
+    /** Enctype for file uploads */
+    enctype?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
+}
+/**
+ * Build form wrapper
+ */
+export declare function form(content: string, options?: FormOptions): string;
+/**
+ * Build form row (for horizontal forms)
+ */
+export declare function formRow(fields: string[], options?: {
+    gap?: 'sm' | 'md' | 'lg';
+    className?: string;
+}): string;
+/**
+ * Build form section with title
+ */
+export declare function formSection(content: string, options?: {
+    title?: string;
+    description?: string;
+    className?: string;
+}): string;
+/**
+ * Build form actions (submit/cancel buttons area)
+ */
+export declare function formActions(buttons: string[], options?: {
+    align?: 'left' | 'center' | 'right' | 'between';
+    className?: string;
+}): string;
+/**
+ * Build a hidden input
+ */
+export declare function hiddenInput(name: string, value: string): string;
+/**
+ * Build CSRF token hidden input
+ */
+export declare function csrfInput(token: string): string;
+//# sourceMappingURL=form.d.ts.map

package/components/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/components/form.ts"],"names":[],"mappings":"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"}