@page-speed/forms 0.5.7 → 0.5.9

package/dist/chunk-TOPOO33Z.js

@@ -0,0 +1,263 @@
+import { FormContext } from './chunk-MJYEXJ3U.js';
+import { cn, FieldLabel, TextInput, Button } from './chunk-455PI4LV.js';
+import * as React4 from 'react';
+import { cva } from 'class-variance-authority';
+import 'radix-ui';
+
+function renderMessage(message, fallbackClassName, className) {
+  if (typeof message === "string") {
+    return /* @__PURE__ */ React4.createElement(
+      "p",
+      {
+        className: cn(
+          "text-sm font-medium text-center text-balance",
+          className
+        )
+      },
+      message
+    );
+  }
+  return /* @__PURE__ */ React4.createElement("div", { className: cn(fallbackClassName, className) }, message);
+}
+function FormFeedback({
+  successMessage,
+  submissionError,
+  successMessageClassName,
+  errorMessageClassName
+}) {
+  if (!successMessage && !submissionError) {
+    return null;
+  }
+  return /* @__PURE__ */ React4.createElement(React4.Fragment, null, successMessage ? /* @__PURE__ */ React4.createElement(
+    "div",
+    {
+      className: cn(
+        "rounded-md border border-primary bg-primary px-4 py-3 shadow-sm",
+        successMessageClassName
+      ),
+      role: "status",
+      "aria-live": "polite"
+    },
+    renderMessage(
+      successMessage,
+      "text-primary-foreground",
+      "text-primary-foreground"
+    )
+  ) : null, submissionError ? /* @__PURE__ */ React4.createElement(
+    "div",
+    {
+      className: cn(
+        "rounded-md border border-destructive bg-destructive px-4 py-3 shadow-sm",
+        errorMessageClassName
+      ),
+      role: "alert",
+      "aria-live": "assertive"
+    },
+    renderMessage(
+      submissionError,
+      "text-destructive-foreground",
+      "text-destructive-foreground"
+    )
+  ) : null);
+}
+FormFeedback.displayName = "FormFeedback";
+var buttonGroupVariants = cva(
+  "flex w-fit items-stretch [&>*]:focus-visible:z-10 [&>*]:focus-visible:relative [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-md has-[>[data-slot=button-group]]:gap-2",
+  {
+    variants: {
+      orientation: {
+        horizontal: "[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none",
+        vertical: "flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none"
+      }
+    },
+    defaultVariants: {
+      orientation: "horizontal"
+    }
+  }
+);
+function ButtonGroup({
+  className,
+  orientation,
+  ...props
+}) {
+  return /* @__PURE__ */ React4.createElement(
+    "div",
+    {
+      role: "group",
+      "data-slot": "button-group",
+      "data-orientation": orientation,
+      className: cn(buttonGroupVariants({ orientation }), className),
+      ...props
+    }
+  );
+}
+
+// src/core/button-group-form.tsx
+function ButtonGroupForm({
+  name,
+  label,
+  inputProps,
+  submitLabel = "Submit",
+  submitVariant = "default",
+  size = "default",
+  isSubmitting = false,
+  className,
+  labelClassName
+}) {
+  const inputId = `button-group-input-${name}`;
+  const inputSizeClasses = {
+    xs: "h-8 text-xs px-3",
+    sm: "h-9 text-sm px-3",
+    default: "h-10 text-sm px-4",
+    lg: "h-12 text-base px-6"
+  };
+  const buttonSizes = {
+    xs: "xs",
+    sm: "sm",
+    default: "default",
+    lg: "lg"
+  };
+  return /* @__PURE__ */ React4.createElement("div", { className: cn("space-y-2", className) }, label && /* @__PURE__ */ React4.createElement(FieldLabel, { htmlFor: inputId, className: labelClassName }, label), /* @__PURE__ */ React4.createElement(ButtonGroup, null, /* @__PURE__ */ React4.createElement(
+    TextInput,
+    {
+      ...inputProps,
+      id: inputId,
+      className: cn(
+        inputSizeClasses[size],
+        "border-r-0 rounded-r-none focus-visible:z-10",
+        inputProps.className
+      )
+    }
+  ), /* @__PURE__ */ React4.createElement(
+    Button,
+    {
+      size: buttonSizes[size],
+      type: "submit",
+      variant: submitVariant,
+      disabled: isSubmitting,
+      className: "rounded-l-none"
+    },
+    submitLabel
+  )));
+}
+ButtonGroupForm.displayName = "ButtonGroupForm";
+
+// src/core/Form.tsx
+function Form({
+  form,
+  children,
+  fields,
+  className,
+  action,
+  method,
+  noValidate = true,
+  submissionConfig,
+  successMessage,
+  submissionError,
+  successMessageClassName,
+  errorMessageClassName,
+  onNewSubmission,
+  notificationConfig,
+  styleConfig,
+  formConfig,
+  ...props
+}) {
+  const handleFormSubmit = React4.useCallback(
+    async (e) => {
+      try {
+        await form.handleSubmit(e);
+      } catch {
+      }
+    },
+    [form]
+  );
+  const resolvedClassName = className ?? styleConfig?.formClassName;
+  const resolvedAction = action ?? formConfig?.endpoint;
+  const resolvedMethod = method ?? formConfig?.method ?? "post";
+  const resolvedSubmissionConfig = submissionConfig ?? formConfig?.submissionConfig;
+  const resolvedSuccessMessage = successMessage ?? notificationConfig?.successMessage;
+  const resolvedSubmissionError = submissionError ?? notificationConfig?.submissionError;
+  const resolvedSuccessMessageClassName = successMessageClassName ?? styleConfig?.successMessageClassName;
+  const resolvedErrorMessageClassName = errorMessageClassName ?? styleConfig?.errorMessageClassName;
+  const behavior = resolvedSubmissionConfig?.behavior || "showConfirmation";
+  const shouldManageSubmissionUi = resolvedSubmissionConfig !== void 0 || resolvedSuccessMessage !== void 0 || resolvedSuccessMessageClassName !== void 0 || resolvedErrorMessageClassName !== void 0 || resolvedSubmissionError != null || onNewSubmission !== void 0;
+  const hasSubmissionError = Boolean(resolvedSubmissionError);
+  const isSubmissionSuccessful = shouldManageSubmissionUi && form.status === "success" && !hasSubmissionError;
+  const defaultSuccessMessage = behavior === "redirect" ? "Form submitted successfully. Redirecting..." : "Thank you. Your form has been submitted successfully.";
+  const finalSuccessMessage = resolvedSuccessMessage ?? defaultSuccessMessage;
+  const shouldRenderCustomComponent = isSubmissionSuccessful && behavior === "renderCustomComponent" && Boolean(resolvedSubmissionConfig?.customComponent);
+  const newSubmissionAction = resolvedSubmissionConfig?.newFormSubmissionAction;
+  const showNewSubmissionAction = isSubmissionSuccessful && (typeof newSubmissionAction?.enable === "boolean" ? newSubmissionAction.enable : Boolean(newSubmissionAction?.label));
+  const newSubmissionLabel = newSubmissionAction?.label ?? "Submit another response";
+  const handleNewSubmission = React4.useCallback(() => {
+    form.resetForm();
+    onNewSubmission?.();
+  }, [form, onNewSubmission]);
+  const formLayout = formConfig?.formLayout ?? "standard";
+  const isButtonGroupLayout = formLayout === "button-group";
+  const hasTextField = fields && fields.length === 1 && fields[0] && ["text", "email", "password", "url", "tel", "search"].includes(fields[0].type);
+  const shouldUseButtonGroup = isButtonGroupLayout && hasTextField;
+  const buttonGroupContent = React4.useMemo(() => {
+    if (!shouldUseButtonGroup || !fields || fields.length === 0) return null;
+    const field = fields[0];
+    const fieldProps = form.getFieldProps(field.name);
+    return /* @__PURE__ */ React4.createElement(
+      ButtonGroupForm,
+      {
+        name: field.name,
+        label: field.label,
+        inputProps: {
+          name: fieldProps.name,
+          value: fieldProps.value,
+          onChange: fieldProps.onChange,
+          onBlur: fieldProps.onBlur,
+          type: field.type,
+          placeholder: field.placeholder,
+          required: field.required,
+          disabled: field.disabled
+        },
+        submitLabel: formConfig?.submitLabel,
+        submitVariant: formConfig?.submitVariant,
+        size: formConfig?.buttonGroupSize,
+        isSubmitting: form.isSubmitting
+      }
+    );
+  }, [shouldUseButtonGroup, fields, form, formConfig]);
+  return /* @__PURE__ */ React4.createElement(FormContext.Provider, { value: form }, /* @__PURE__ */ React4.createElement(
+    "form",
+    {
+      onSubmit: handleFormSubmit,
+      action: resolvedAction,
+      method: resolvedMethod,
+      noValidate,
+      className: resolvedClassName,
+      ...props
+    },
+    isSubmissionSuccessful ? /* @__PURE__ */ React4.createElement("div", { className: "space-y-4" }, shouldRenderCustomComponent ? resolvedSubmissionConfig?.customComponent : /* @__PURE__ */ React4.createElement(
+      FormFeedback,
+      {
+        successMessage: finalSuccessMessage,
+        successMessageClassName: resolvedSuccessMessageClassName
+      }
+    ), showNewSubmissionAction ? /* @__PURE__ */ React4.createElement(
+      Button,
+      {
+        type: "button",
+        variant: "outline",
+        onClick: handleNewSubmission
+      },
+      newSubmissionLabel
+    ) : null) : /* @__PURE__ */ React4.createElement(React4.Fragment, null, shouldUseButtonGroup ? buttonGroupContent : children, resolvedSubmissionError ? /* @__PURE__ */ React4.createElement("div", { className: "mt-4" }, /* @__PURE__ */ React4.createElement(
+      FormFeedback,
+      {
+        submissionError: resolvedSubmissionError,
+        errorMessageClassName: resolvedErrorMessageClassName
+      }
+    )) : null)
+  ));
+}
+Form.displayName = "Form";
+
+export { ButtonGroupForm, Form, FormFeedback };
+//# sourceMappingURL=chunk-TOPOO33Z.js.map
+//# sourceMappingURL=chunk-TOPOO33Z.js.map

package/dist/chunk-TOPOO33Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/form-feedback.tsx","../src/components/ui/button-group.tsx","../src/core/button-group-form.tsx","../src/core/Form.tsx"],"names":["React","React2","React3"],"mappings":"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","file":"chunk-TOPOO33Z.js","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"../lib/utils\";\n\nexport interface FormFeedbackProps {\n  successMessage?: React.ReactNode;\n  submissionError?: React.ReactNode;\n  successMessageClassName?: string;\n  errorMessageClassName?: string;\n}\n\nfunction renderMessage(\n  message: React.ReactNode,\n  fallbackClassName: string,\n  className?: string,\n) {\n  if (typeof message === \"string\") {\n    return (\n      <p\n        className={cn(\n          \"text-sm font-medium text-center text-balance\",\n          className,\n        )}\n      >\n        {message}\n      </p>\n    );\n  }\n\n  return <div className={cn(fallbackClassName, className)}>{message}</div>;\n}\n\nexport function FormFeedback({\n  successMessage,\n  submissionError,\n  successMessageClassName,\n  errorMessageClassName,\n}: FormFeedbackProps) {\n  if (!successMessage && !submissionError) {\n    return null;\n  }\n\n  return (\n    <>\n      {successMessage ? (\n        <div\n          className={cn(\n            \"rounded-md border border-primary bg-primary px-4 py-3 shadow-sm\",\n            successMessageClassName,\n          )}\n          role=\"status\"\n          aria-live=\"polite\"\n        >\n          {renderMessage(\n            successMessage,\n            \"text-primary-foreground\",\n            \"text-primary-foreground\",\n          )}\n        </div>\n      ) : null}\n\n      {submissionError ? (\n        <div\n          className={cn(\n            \"rounded-md border border-destructive bg-destructive px-4 py-3 shadow-sm\",\n            errorMessageClassName,\n          )}\n          role=\"alert\"\n          aria-live=\"assertive\"\n        >\n          {renderMessage(\n            submissionError,\n            \"text-destructive-foreground\",\n            \"text-destructive-foreground\",\n          )}\n        </div>\n      ) : null}\n    </>\n  );\n}\n\nFormFeedback.displayName = \"FormFeedback\";\n","import * as React from \"react\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\nimport { Slot } from \"radix-ui\"\n\nimport { cn } from \"../../lib/utils\"\nimport { Separator } from \"./separator\"\n\nconst buttonGroupVariants = cva(\n  \"flex w-fit items-stretch [&>*]:focus-visible:z-10 [&>*]:focus-visible:relative [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-md has-[>[data-slot=button-group]]:gap-2\",\n  {\n    variants: {\n      orientation: {\n        horizontal:\n          \"[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none\",\n        vertical:\n          \"flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none\",\n      },\n    },\n    defaultVariants: {\n      orientation: \"horizontal\",\n    },\n  }\n)\n\nfunction ButtonGroup({\n  className,\n  orientation,\n  ...props\n}: React.ComponentProps<\"div\"> & VariantProps<typeof buttonGroupVariants>) {\n  return (\n    <div\n      role=\"group\"\n      data-slot=\"button-group\"\n      data-orientation={orientation}\n      className={cn(buttonGroupVariants({ orientation }), className)}\n      {...props}\n    />\n  )\n}\n\nfunction ButtonGroupText({\n  className,\n  asChild = false,\n  ...props\n}: React.ComponentProps<\"div\"> & {\n  asChild?: boolean\n}) {\n  const Comp = asChild ? Slot.Root : \"div\"\n\n  return (\n    <Comp\n      className={cn(\n        \"bg-muted flex items-center gap-2 rounded-md border px-4 text-sm font-medium shadow-xs [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction ButtonGroupSeparator({\n  className,\n  orientation = \"vertical\",\n  ...props\n}: React.ComponentProps<typeof Separator>) {\n  return (\n    <Separator\n      data-slot=\"button-group-separator\"\n      orientation={orientation}\n      className={cn(\n        \"bg-input relative !m-0 self-stretch data-[orientation=vertical]:h-auto\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nexport {\n  ButtonGroup,\n  ButtonGroupSeparator,\n  ButtonGroupText,\n  buttonGroupVariants,\n}\n","\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Button } from \"../components/ui/button\";\nimport { ButtonGroup } from \"../components/ui/button-group\";\nimport { FieldLabel } from \"../components/ui/field\";\nimport { TextInput } from \"../inputs/TextInput\";\nimport type { InputProps } from \"./types\";\n\nexport type ButtonGroupFormSize = \"xs\" | \"sm\" | \"default\" | \"lg\";\n\nexport type ButtonGroupFormProps = {\n  /**\n   * Field name\n   */\n  name: string;\n  /**\n   * Optional label above the input\n   */\n  label?: React.ReactNode;\n  /**\n   * Placeholder text for the input\n   */\n  placeholder?: string;\n  /**\n   * Input props from form field\n   */\n  inputProps: InputProps<string> & {\n    type?: \"text\" | \"email\" | \"password\" | \"url\" | \"tel\" | \"search\";\n  };\n  /**\n   * Submit button label\n   */\n  submitLabel?: React.ReactNode;\n  /**\n   * Submit button size\n   */\n  size?: ButtonGroupFormSize;\n  /**\n   * Submit button variant\n   */\n  submitVariant?:\n    | \"link\"\n    | \"default\"\n    | \"destructive\"\n    | \"outline\"\n    | \"secondary\"\n    | \"ghost\"\n    | null\n    | undefined;\n  /**\n   * Whether form is submitting\n   */\n  isSubmitting?: boolean;\n  /**\n   * Additional className for the container\n   */\n  className?: string;\n  /**\n   * Additional className for the label\n   */\n  labelClassName?: string;\n};\n\n/**\n * ButtonGroupForm - Inline form layout with input and submit button grouped together\n *\n * Commonly used for newsletter signups and other simple single-field forms.\n * The input and button automatically adjust sizing together.\n *\n * Size mappings:\n * - xs: h-8 text-xs\n * - sm: h-9 text-sm\n * - default: h-10 text-sm\n * - lg: h-12 text-base\n *\n * @example\n * ```tsx\n * <ButtonGroupForm\n *   name=\"email\"\n *   placeholder=\"Enter your email\"\n *   inputProps={form.getFieldProps('email')}\n *   submitLabel=\"Subscribe\"\n *   size=\"default\"\n * />\n * ```\n */\nexport function ButtonGroupForm({\n  name,\n  label,\n  inputProps,\n  submitLabel = \"Submit\",\n  submitVariant = \"default\",\n  size = \"default\",\n  isSubmitting = false,\n  className,\n  labelClassName,\n}: ButtonGroupFormProps) {\n  const inputId = `button-group-input-${name}`;\n\n  // Size-specific classes for input to match button heights\n  const inputSizeClasses = {\n    xs: \"h-8 text-xs px-3\",\n    sm: \"h-9 text-sm px-3\",\n    default: \"h-10 text-sm px-4\",\n    lg: \"h-12 text-base px-6\",\n  };\n\n  // Map button group sizes to button sizes\n  const buttonSizes: Record<ButtonGroupFormSize, \"xs\" | \"sm\" | \"default\" | \"lg\"> = {\n    xs: \"xs\",\n    sm: \"sm\",\n    default: \"default\",\n    lg: \"lg\",\n  };\n\n  return (\n    <div className={cn(\"space-y-2\", className)}>\n      {label && (\n        <FieldLabel htmlFor={inputId} className={labelClassName}>\n          {label}\n        </FieldLabel>\n      )}\n      <ButtonGroup>\n        <TextInput\n          {...inputProps}\n          id={inputId}\n          className={cn(\n            inputSizeClasses[size],\n            \"border-r-0 rounded-r-none focus-visible:z-10\",\n            inputProps.className,\n          )}\n        />\n        <Button\n          size={buttonSizes[size]}\n          type=\"submit\"\n          variant={submitVariant}\n          disabled={isSubmitting}\n          className=\"rounded-l-none\"\n        >\n          {submitLabel}\n        </Button>\n      </ButtonGroup>\n    </div>\n  );\n}\n\nButtonGroupForm.displayName = \"ButtonGroupForm\";\n","\"use client\";\n\nimport * as React from \"react\";\nimport { FormContext } from \"./FormContext\";\nimport type { FormProps, FormValues } from \"./types\";\nimport { FormFeedback } from \"./form-feedback\";\nimport { Button } from \"../components/ui/button\";\nimport { ButtonGroupForm } from \"./button-group-form\";\nimport type { FormFieldConfig } from \"../integration/form-field-types\";\n\n/**\n * Form - Progressive enhancement form component\n *\n * Provides form context to child components and handles form submission.\n * Supports progressive enhancement with server-side fallback.\n *\n * Features:\n * - Provides FormContext for useField hook\n * - Handles form submission with validation\n * - Progressive enhancement support (works without JavaScript)\n * - Accessible form semantics\n *\n * @example\n * ```tsx\n * const form = useForm({\n *   initialValues: { email: '' },\n *   onSubmit: async (values) => {\n *     await submitForm(values);\n *   },\n * });\n *\n * return (\n *   <Form form={form} action=\"/api/submit\" method=\"post\">\n *     <input {...form.getFieldProps('email')} />\n *     <button type=\"submit\">Submit</button>\n *   </Form>\n * );\n * ```\n *\n * @see https://opensite.ai/developers/page-speed/forms/form\n */\nexport function Form<T extends FormValues = FormValues>({\n  form,\n  children,\n  fields,\n  className,\n  action,\n  method,\n  noValidate = true,\n  submissionConfig,\n  successMessage,\n  submissionError,\n  successMessageClassName,\n  errorMessageClassName,\n  onNewSubmission,\n  notificationConfig,\n  styleConfig,\n  formConfig,\n  ...props\n}: FormProps<T> & React.FormHTMLAttributes<HTMLFormElement>) {\n  // Wrap handleSubmit to catch any unhandled rejections\n  const handleFormSubmit = React.useCallback(\n    async (e: React.FormEvent) => {\n      try {\n        await form.handleSubmit(e);\n      } catch {\n        // Error is already handled by useForm, just prevent unhandled rejection\n        // The form status and errors are already set by useForm's error handling\n      }\n    },\n    [form],\n  );\n\n  const resolvedClassName = className ?? styleConfig?.formClassName;\n  const resolvedAction = action ?? formConfig?.endpoint;\n  const resolvedMethod = method ?? formConfig?.method ?? \"post\";\n  const resolvedSubmissionConfig = submissionConfig ?? formConfig?.submissionConfig;\n  const resolvedSuccessMessage =\n    successMessage ?? notificationConfig?.successMessage;\n  const resolvedSubmissionError =\n    submissionError ?? notificationConfig?.submissionError;\n  const resolvedSuccessMessageClassName =\n    successMessageClassName ?? styleConfig?.successMessageClassName;\n  const resolvedErrorMessageClassName =\n    errorMessageClassName ?? styleConfig?.errorMessageClassName;\n\n  const behavior = resolvedSubmissionConfig?.behavior || \"showConfirmation\";\n\n  const shouldManageSubmissionUi =\n    resolvedSubmissionConfig !== undefined ||\n    resolvedSuccessMessage !== undefined ||\n    resolvedSuccessMessageClassName !== undefined ||\n    resolvedErrorMessageClassName !== undefined ||\n    resolvedSubmissionError != null ||\n    onNewSubmission !== undefined;\n\n  const hasSubmissionError = Boolean(resolvedSubmissionError);\n\n  const isSubmissionSuccessful =\n    shouldManageSubmissionUi &&\n    form.status === \"success\" &&\n    !hasSubmissionError;\n\n  const defaultSuccessMessage =\n    behavior === \"redirect\"\n      ? \"Form submitted successfully. Redirecting...\"\n      : \"Thank you. Your form has been submitted successfully.\";\n\n  const finalSuccessMessage = resolvedSuccessMessage ?? defaultSuccessMessage;\n\n  const shouldRenderCustomComponent =\n    isSubmissionSuccessful &&\n    behavior === \"renderCustomComponent\" &&\n    Boolean(resolvedSubmissionConfig?.customComponent);\n\n  const newSubmissionAction = resolvedSubmissionConfig?.newFormSubmissionAction;\n\n  const showNewSubmissionAction =\n    isSubmissionSuccessful &&\n    (typeof newSubmissionAction?.enable === \"boolean\"\n      ? newSubmissionAction.enable\n      : Boolean(newSubmissionAction?.label));\n\n  const newSubmissionLabel =\n    newSubmissionAction?.label ?? \"Submit another response\";\n\n  const handleNewSubmission = React.useCallback(() => {\n    form.resetForm();\n    onNewSubmission?.();\n  }, [form, onNewSubmission]);\n\n  // Check if we should use button-group layout\n  const formLayout = formConfig?.formLayout ?? \"standard\";\n  const isButtonGroupLayout = formLayout === \"button-group\";\n  const hasTextField = fields && fields.length === 1 && fields[0] &&\n    [\"text\", \"email\", \"password\", \"url\", \"tel\", \"search\"].includes(fields[0].type);\n  const shouldUseButtonGroup = isButtonGroupLayout && hasTextField;\n\n  // Render button-group layout if conditions are met\n  const buttonGroupContent = React.useMemo(() => {\n    if (!shouldUseButtonGroup || !fields || fields.length === 0) return null;\n\n    const field = fields[0] as FormFieldConfig;\n    const fieldProps = form.getFieldProps(field.name);\n\n    return (\n      <ButtonGroupForm\n        name={field.name}\n        label={field.label}\n        inputProps={{\n          name: fieldProps.name,\n          value: fieldProps.value as string,\n          onChange: fieldProps.onChange as (value: string) => void,\n          onBlur: fieldProps.onBlur,\n          type: field.type as \"text\" | \"email\" | \"password\" | \"url\" | \"tel\" | \"search\",\n          placeholder: field.placeholder,\n          required: field.required,\n          disabled: field.disabled,\n        }}\n        submitLabel={formConfig?.submitLabel}\n        submitVariant={formConfig?.submitVariant}\n        size={formConfig?.buttonGroupSize}\n        isSubmitting={form.isSubmitting}\n      />\n    );\n  }, [shouldUseButtonGroup, fields, form, formConfig]);\n\n  return (\n    <FormContext.Provider value={form}>\n      <form\n        onSubmit={handleFormSubmit}\n        action={resolvedAction}\n        method={resolvedMethod}\n        noValidate={noValidate}\n        className={resolvedClassName}\n        {...props}\n      >\n        {isSubmissionSuccessful ? (\n          <div className=\"space-y-4\">\n            {shouldRenderCustomComponent ? (\n              resolvedSubmissionConfig?.customComponent\n            ) : (\n              <FormFeedback\n                successMessage={finalSuccessMessage}\n                successMessageClassName={resolvedSuccessMessageClassName}\n              />\n            )}\n\n            {showNewSubmissionAction ? (\n              <Button\n                type=\"button\"\n                variant=\"outline\"\n                onClick={handleNewSubmission}\n              >\n                {newSubmissionLabel}\n              </Button>\n            ) : null}\n          </div>\n        ) : (\n          <>\n            {shouldUseButtonGroup ? buttonGroupContent : children}\n            {resolvedSubmissionError ? (\n              <div className=\"mt-4\">\n                <FormFeedback\n                  submissionError={resolvedSubmissionError}\n                  errorMessageClassName={resolvedErrorMessageClassName}\n                />\n              </div>\n            ) : null}\n          </>\n        )}\n      </form>\n    </FormContext.Provider>\n  );\n}\n\nForm.displayName = \"Form\";\n"]}

package/dist/core.cjs

@@ -1,34 +1,38 @@
 'use strict';
 
-var chunkO4ZLR7AN_cjs = require('./chunk-O4ZLR7AN.cjs');
-var chunkKPHMVGTU_cjs = require('./chunk-KPHMVGTU.cjs');
-require('./chunk-QQSBW6N3.cjs');
+var chunkOF6ZYT7A_cjs = require('./chunk-OF6ZYT7A.cjs');
+var chunkMUBEMXI7_cjs = require('./chunk-MUBEMXI7.cjs');
+require('./chunk-QRI5TMES.cjs');
 
 
 
+Object.defineProperty(exports, "ButtonGroupForm", {
+  enumerable: true,
+  get: function () { return chunkOF6ZYT7A_cjs.ButtonGroupForm; }
+});
 Object.defineProperty(exports, "Form", {
   enumerable: true,
-  get: function () { return chunkO4ZLR7AN_cjs.Form; }
+  get: function () { return chunkOF6ZYT7A_cjs.Form; }
 });
 Object.defineProperty(exports, "FormFeedback", {
   enumerable: true,
-  get: function () { return chunkO4ZLR7AN_cjs.FormFeedback; }
+  get: function () { return chunkOF6ZYT7A_cjs.FormFeedback; }
 });
 Object.defineProperty(exports, "Field", {
   enumerable: true,
-  get: function () { return chunkKPHMVGTU_cjs.Field; }
+  get: function () { return chunkMUBEMXI7_cjs.Field; }
 });
 Object.defineProperty(exports, "FormContext", {
   enumerable: true,
-  get: function () { return chunkKPHMVGTU_cjs.FormContext; }
+  get: function () { return chunkMUBEMXI7_cjs.FormContext; }
 });
 Object.defineProperty(exports, "useField", {
   enumerable: true,
-  get: function () { return chunkKPHMVGTU_cjs.useField; }
+  get: function () { return chunkMUBEMXI7_cjs.useField; }
 });
 Object.defineProperty(exports, "useForm", {
   enumerable: true,
-  get: function () { return chunkKPHMVGTU_cjs.useForm; }
+  get: function () { return chunkMUBEMXI7_cjs.useForm; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/core.d.cts

@@ -1,154 +1,79 @@
-import { b as FormValues, U as UseFormOptions, m as UseFormReturn, p as UseFieldOptions, q as UseFieldReturn, r as FormProps, s as FieldProps } from './types-CnOCn7b3.cjs';
-export { E as ErrorHandler, n as FieldInputProps, o as FieldMeta, F as FieldValidator, l as FormActions, c as FormErrors, i as FormHelpers, f as FormNotificationConfig, h as FormRenderConfig, k as FormState, g as FormStyleConfig, d as FormSubmissionBehavior, e as FormSubmissionConfig, I as InputProps, N as NewFormSubmissionActionConfig, S as SubmissionStatus, j as SubmitHandler, T as TouchedFields, a as ValidationMode, V as ValidationSchema } from './types-CnOCn7b3.cjs';
+export { b as Field, F as Form, d as FormContext, c as FormFeedback, e as FormFeedbackProps, a as useField, u as useForm } from './FormContext-iHzBALZa.cjs';
 import * as React from 'react';
+import { I as InputProps } from './types-BemGfSPA.cjs';
+export { E as ErrorHandler, n as FieldInputProps, o as FieldMeta, s as FieldProps, F as FieldValidator, l as FormActions, c as FormErrors, i as FormHelpers, f as FormNotificationConfig, r as FormProps, h as FormRenderConfig, k as FormState, g as FormStyleConfig, d as FormSubmissionBehavior, e as FormSubmissionConfig, b as FormValues, N as NewFormSubmissionActionConfig, S as SubmissionStatus, j as SubmitHandler, T as TouchedFields, p as UseFieldOptions, q as UseFieldReturn, U as UseFormOptions, m as UseFormReturn, a as ValidationMode, V as ValidationSchema } from './types-BemGfSPA.cjs';
 
+type ButtonGroupFormSize = "xs" | "sm" | "default" | "lg";
+type ButtonGroupFormProps = {
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * Optional label above the input
+     */
+    label?: React.ReactNode;
+    /**
+     * Placeholder text for the input
+     */
+    placeholder?: string;
+    /**
+     * Input props from form field
+     */
+    inputProps: InputProps<string> & {
+        type?: "text" | "email" | "password" | "url" | "tel" | "search";
+    };
+    /**
+     * Submit button label
+     */
+    submitLabel?: React.ReactNode;
+    /**
+     * Submit button size
+     */
+    size?: ButtonGroupFormSize;
+    /**
+     * Submit button variant
+     */
+    submitVariant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    /**
+     * Whether form is submitting
+     */
+    isSubmitting?: boolean;
+    /**
+     * Additional className for the container
+     */
+    className?: string;
+    /**
+     * Additional className for the label
+     */
+    labelClassName?: string;
+};
 /**
- * useForm - High-performance form state management with field-level reactivity
+ * ButtonGroupForm - Inline form layout with input and submit button grouped together
  *
- * Built on @legendapp/state for optimal performance:
- * - Field-level reactivity: Only re-render the specific field that changed
- * - Observable-based state: ~1 re-render per change vs ~10 for traditional hooks
- * - Tree-shakable: Only bundle what you use
+ * Commonly used for newsletter signups and other simple single-field forms.
+ * The input and button automatically adjust sizing together.
  *
- * @example
- * ```tsx
- * const form = useForm({
- *   initialValues: { email: '', password: '' },
- *   onSubmit: async (values) => {
- *     await login(values);
- *   },
- *   validationSchema: {
- *     email: (value) => !value ? 'Required' : undefined,
- *     password: (value) => value.length < 8 ? 'Too short' : undefined,
- *   },
- * });
- *
- * return (
- *   <form onSubmit={form.handleSubmit}>
- *     <input {...form.getFieldProps('email')} />
- *     {form.errors.email && <span>{form.errors.email}</span>}
- *   </form>
- * );
- * ```
- *
- * @see https://opensite.ai/developers/page-speed/forms/use-form
- */
-declare function useForm<T extends FormValues = FormValues>(options: UseFormOptions<T>): UseFormReturn<T>;
-
-/**
- * useField - Field-level reactive hook for form inputs
- *
- * Provides isolated reactivity for individual form fields.
- * Only re-renders when the specific field changes, not when other fields update.
- *
- * Must be used within a FormContext (inside <Form> component).
- *
- * @example
- * ```tsx
- * function EmailInput() {
- *   const { field, meta, helpers } = useField({ name: 'email' });
- *
- *   return (
- *     <div>
- *       <input {...field} type="email" />
- *       {meta.touched && meta.error && <span>{meta.error}</span>}
- *     </div>
- *   );
- * }
- * ```
- *
- * @see https://opensite.ai/developers/page-speed/forms/use-field
- */
-declare function useField<T = any>(options: UseFieldOptions<T>): UseFieldReturn<T>;
-
-/**
- * Form - Progressive enhancement form component
- *
- * Provides form context to child components and handles form submission.
- * Supports progressive enhancement with server-side fallback.
- *
- * Features:
- * - Provides FormContext for useField hook
- * - Handles form submission with validation
- * - Progressive enhancement support (works without JavaScript)
- * - Accessible form semantics
- *
- * @example
- * ```tsx
- * const form = useForm({
- *   initialValues: { email: '' },
- *   onSubmit: async (values) => {
- *     await submitForm(values);
- *   },
- * });
- *
- * return (
- *   <Form form={form} action="/api/submit" method="post">
- *     <input {...form.getFieldProps('email')} />
- *     <button type="submit">Submit</button>
- *   </Form>
- * );
- * ```
- *
- * @see https://opensite.ai/developers/page-speed/forms/form
- */
-declare function Form<T extends FormValues = FormValues>({ form, children, className, action, method, noValidate, submissionConfig, successMessage, submissionError, successMessageClassName, errorMessageClassName, onNewSubmission, notificationConfig, styleConfig, formConfig, ...props }: FormProps<T> & React.FormHTMLAttributes<HTMLFormElement>): React.JSX.Element;
-declare namespace Form {
-    var displayName: string;
-}
-
-/**
- * Field - Field wrapper component with label, description, and error display
- *
- * Provides a complete field UI with automatic error handling and accessibility.
- * Uses useField hook internally for field-level reactivity.
- *
- * Features:
- * - Automatic label association
- * - Error display with accessibility
- * - Optional description text
- * - Render prop pattern for flexibility
- * - Full accessibility support
+ * Size mappings:
+ * - xs: h-8 text-xs
+ * - sm: h-9 text-sm
+ * - default: h-10 text-sm
+ * - lg: h-12 text-base
  *
  * @example
  * ```tsx
- * <Field name="email" label="Email Address" description="We'll never share your email">
- *   {({ field, meta }) => (
- *     <input
- *       {...field}
- *       type="email"
- *       className={meta.error && meta.touched ? 'error' : ''}
- *     />
- *   )}
- * </Field>
+ * <ButtonGroupForm
+ *   name="email"
+ *   placeholder="Enter your email"
+ *   inputProps={form.getFieldProps('email')}
+ *   submitLabel="Subscribe"
+ *   size="default"
+ * />
  * ```
- *
- * @see https://opensite.ai/developers/page-speed/forms/field
  */
-declare function Field({ name, label, description, children, showError, className, errorClassName, required, validate, }: FieldProps): React.JSX.Element;
-declare namespace Field {
-    var displayName: string;
-}
-
-interface FormFeedbackProps {
-    successMessage?: React.ReactNode;
-    submissionError?: React.ReactNode;
-    successMessageClassName?: string;
-    errorMessageClassName?: string;
-}
-declare function FormFeedback({ successMessage, submissionError, successMessageClassName, errorMessageClassName, }: FormFeedbackProps): React.JSX.Element | null;
-declare namespace FormFeedback {
+declare function ButtonGroupForm({ name, label, inputProps, submitLabel, submitVariant, size, isSubmitting, className, labelClassName, }: ButtonGroupFormProps): React.JSX.Element;
+declare namespace ButtonGroupForm {
     var displayName: string;
 }
 
-/**
- * FormContext - React context for providing form state to child components
- *
- * Allows useField hook to access form state without prop drilling.
- * Automatically provided by the <Form> component.
- *
- * @internal
- */
-declare const FormContext: React.Context<UseFormReturn<any> | null>;
-
-export { Field, FieldProps, Form, FormContext, FormFeedback, type FormFeedbackProps, FormProps, FormValues, UseFieldOptions, UseFieldReturn, UseFormOptions, UseFormReturn, useField, useForm };
+export { ButtonGroupForm, type ButtonGroupFormProps, type ButtonGroupFormSize, InputProps };