@salesforce/webapp-template-app-react-template-b2x-experimental 1.71.0 → 1.71.2

package/dist/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.71.2](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.71.1...v1.71.2) (2026-03-05)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
+## [1.71.1](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.71.0...v1.71.1) (2026-03-05)
+
+**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
+
+
+
+
+
 # [1.71.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.70.0...v1.71.0) (2026-03-05)
 
 **Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental

package/dist/README.md

@@ -1,10 +1,64 @@
-# Salesforce DX Project: Next Steps
+# App React Template B2X
 
-Now that you’ve created a Salesforce DX project, what’s next? Here are some documentation resources to get you started.
+A B2X (Business-to-Consumer) React starter template for customer-facing apps on the Salesforce platform. Includes authentication, global search, and an Experience Cloud site container. Built with React, Vite, TypeScript, and Tailwind/shadcn.
 
-## How Do You Plan to Deploy Your Changes?
+## What's included
 
-Do you want to deploy a set of changes, or create a self-contained application? Choose a [development model](https://developer.salesforce.com/tools/vscode/en/user-guide/development-models).
+| Path                                                          | Description                                                                                                                              |
+| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `force-app/main/default/webapplications/appreacttemplateb2x/` | React web app (source, config, tests)                                                                                                    |
+| `force-app/main/default/classes/`                             | Apex classes for authentication — `WebAppAuthUtils`, `WebAppChangePassword`, `WebAppForgotPassword`, `WebAppLogin`, `WebAppRegistration` |
+| `force-app/main/default/digitalExperienceConfigs/`            | Experience Cloud site configuration                                                                                                      |
+| `force-app/main/default/digitalExperiences/`                  | Experience Cloud site definition                                                                                                         |
+| `force-app/main/default/networks/`                            | Experience Cloud network                                                                                                                 |
+| `force-app/main/default/sites/`                               | Salesforce site                                                                                                                          |
+
+## Getting started
+
+Navigate to the web app and install dependencies:
+
+```bash
+cd force-app/main/default/webapplications/appreacttemplateb2x
+npm install
+npm run dev
+```
+
+Opens at http://localhost:5173 by default. For build and test instructions, see the [web app README](force-app/main/default/webapplications/appreacttemplateb2x/README.md).
+
+## Deploy
+
+### Deploy everything (metadata + Experience Cloud site + web app)
+
+```bash
+cd force-app/main/default/webapplications/appreacttemplateb2x && npm install && npm run build && cd -
+sf project deploy start --source-dir force-app --target-org <alias>
+```
+
+### Deploy the web app only
+
+```bash
+cd force-app/main/default/webapplications/appreacttemplateb2x && npm install && npm run build && cd -
+sf project deploy start --source-dir force-app/main/default/webapplications --target-org <alias>
+```
+
+### Deploy Experience Cloud site only
+
+```bash
+sf project deploy start \
+  --source-dir force-app/main/default/digitalExperienceConfigs \
+  --source-dir force-app/main/default/digitalExperiences \
+  --source-dir force-app/main/default/networks \
+  --source-dir force-app/main/default/sites \
+  --target-org <alias>
+```
+
+### Deploy authentication classes only
+
+```bash
+sf project deploy start --source-dir force-app/main/default/classes --target-org <alias>
+```
+
+Replace `<alias>` with your target org alias.
 
 ## Configure Your Salesforce DX Project
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/package.json

@@ -15,8 +15,8 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/sdk-data": "^1.71.0",
-    "@salesforce/webapp-experimental": "^1.71.0",
+    "@salesforce/sdk-data": "^1.71.2",
+    "@salesforce/webapp-experimental": "^1.71.2",
     "@tailwindcss/vite": "^4.1.17",
     "@tanstack/react-form": "^1.28.4",
     "class-variance-authority": "^0.7.1",
@@ -40,7 +40,7 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/vite-plugin-webapp-experimental": "^1.71.0",
+    "@salesforce/vite-plugin-webapp-experimental": "^1.71.2",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/components/alerts/status-alert.tsx

@@ -1,45 +1,49 @@
-import { cva, type VariantProps } from "class-variance-authority";
-import { Alert, AlertDescription } from "../ui/alert";
-import { useId } from "react";
-import { AlertCircle, CheckCircle } from "lucide-react";
+import { cva, type VariantProps } from 'class-variance-authority';
+import { AlertCircleIcon, CheckCircle2Icon } from 'lucide-react';
+import { Alert, AlertDescription } from '../../components/ui/alert';
+import { useId } from 'react';
 
-const statusAlertVariants = cva("", {
-	variants: {
-		variant: {
-			error: "",
-			success: "",
-		},
-	},
-	defaultVariants: {
-		variant: "error",
-	},
+const statusAlertVariants = cva('', {
+  variants: {
+    variant: {
+      error: '',
+      success: '',
+    },
+  },
+  defaultVariants: {
+    variant: 'error',
+  },
 });
 
 interface StatusAlertProps extends VariantProps<typeof statusAlertVariants> {
-	children?: React.ReactNode;
-	/** Alert variant type. @default "error" */
-	variant?: "error" | "success";
+  children?: React.ReactNode;
+  /** Alert variant type. @default "error" */
+  variant?: 'error' | 'success';
 }
 
 /**
  * Status alert component for displaying error or success messages.
  * Returns null if no children are provided.
  */
-export function StatusAlert({ children, variant = "error" }: StatusAlertProps) {
-	if (!children) return null;
+export function StatusAlert({ children, variant = 'error' }: StatusAlertProps) {
+  if (!children) return null;
 
-	const isError = variant === "error";
-	const descriptionId = useId();
+  const isError = variant === 'error';
+  const descriptionId = useId();
 
-	return (
-		<Alert
-			variant={isError ? "destructive" : "default"}
-			className={statusAlertVariants({ variant })}
-			aria-describedby={descriptionId}
-			role={isError ? "alert" : "status"}
-		>
-			{isError ? <AlertCircle aria-hidden="true" /> : <CheckCircle aria-hidden="true" />}
-			<AlertDescription id={descriptionId}>{children}</AlertDescription>
-		</Alert>
-	);
+  return (
+    <Alert
+      variant={isError ? 'destructive' : 'default'}
+      className={statusAlertVariants({ variant })}
+      aria-describedby={descriptionId}
+      role={isError ? 'alert' : 'status'}
+    >
+      {isError ? (
+        <AlertCircleIcon aria-hidden="true" />
+      ) : (
+        <CheckCircle2Icon aria-hidden="true" />
+      )}
+      <AlertDescription id={descriptionId}>{children}</AlertDescription>
+    </Alert>
+  );
 }

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/components/layouts/card-layout.tsx

@@ -0,0 +1,29 @@
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '../../components/ui/card';
+
+interface CardLayoutProps {
+  title: string;
+  description?: string;
+  children: React.ReactNode;
+}
+
+/**
+ * Card layout component for authentication pages.
+ * Provides CardHeader with title and optional description, and CardContent.
+ */
+export function CardLayout({ title, description, children }: CardLayoutProps) {
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="text-2xl">{title}</CardTitle>
+        {description && <CardDescription>{description}</CardDescription>}
+      </CardHeader>
+      <CardContent>{children}</CardContent>
+    </Card>
+  );
+}

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/footers/footer-link.tsx

@@ -1,5 +1,5 @@
 import { Link } from "react-router";
-import { cn } from "../../lib/utils";
+import { cn } from "../../../lib/utils";
 
 interface FooterLinkProps extends Omit<React.ComponentProps<typeof Link>, "children"> {
 	/** Link text prefix (e.g., "Don't have an account?") */

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/forms/auth-form.tsx

@@ -1,8 +1,8 @@
-import { FieldGroup } from "../../components/ui/field";
-import { StatusAlert } from "../alerts/status-alert";
+import { FieldGroup } from "../../../components/ui/field";
+import { StatusAlert } from "../../../components/alerts/status-alert";
 import { FooterLink } from "../footers/footer-link";
 import { SubmitButton } from "./submit-button";
-import { CardLayout } from "../layout/card-layout";
+import { CardLayout } from "../../../components/layouts/card-layout";
 import { useFormContext } from "../hooks/form";
 import { useId } from "react";
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/forms/submit-button.tsx

@@ -1,6 +1,6 @@
-import { Button } from "../../components/ui/button";
-import { Spinner } from "../../components/ui/spinner";
-import { cn } from "../../lib/utils";
+import { Button } from "../../../components/ui/button";
+import { Spinner } from "../../../components/ui/spinner";
+import { cn } from "../../../lib/utils";
 import { useFormContext } from "../hooks/form";
 
 interface SubmitButtonProps extends Omit<React.ComponentProps<typeof Button>, "type"> {

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/hooks/form.tsx

@@ -5,9 +5,9 @@ import {
 	FieldDescription,
 	FieldError,
 	FieldLabel,
-} from "../../components/ui/field";
-import { Input } from "../../components/ui/input";
-import { cn } from "../../lib/utils";
+} from "../../../components/ui/field";
+import { Input } from "../../../components/ui/input";
+import { cn } from "../../../lib/utils";
 import { AUTH_PLACEHOLDERS } from "../authenticationConfig";
 
 // Create form hook contexts

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/layout/card-skeleton.tsx

@@ -1,6 +1,6 @@
 import { CenteredPageLayout } from "./centered-page-layout";
-import { Card, CardContent, CardHeader } from "../../components/ui/card";
-import { Skeleton } from "../../components/ui/skeleton";
+import { Card, CardContent, CardHeader } from "../../../components/ui/card";
+import { Skeleton } from "../../../components/ui/skeleton";
 
 interface CardSkeletonProps {
 	/**

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/layout/centered-page-layout.tsx

@@ -1,5 +1,5 @@
 import { cva, type VariantProps } from "class-variance-authority";
-import { cn } from "../../lib/utils";
+import { cn } from "../../../lib/utils";
 
 /**
  * Variant styles for the content container's maximum width.

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/layouts/AuthAppLayout.tsx

@@ -1,6 +1,6 @@
 import SessionTimeoutValidator from "../sessionTimeout/SessionTimeoutValidator";
 import { AuthProvider } from "../context/AuthContext";
-import AppLayout from "../../appLayout";
+import AppLayout from "../../../appLayout";
 
 export default function AuthAppLayout() {
 	return (

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/pages/ResetPassword.tsx

@@ -1,9 +1,9 @@
 import { useState } from "react";
 import { Link, useSearchParams } from "react-router";
-import { CardLayout } from "../layout/card-layout";
+import { CardLayout } from "../../../components/layouts/card-layout";
 import { CenteredPageLayout } from "../layout/centered-page-layout";
 import { AuthForm } from "../forms/auth-form";
-import { StatusAlert } from "../alerts/status-alert";
+import { StatusAlert } from "../../../components/alerts/status-alert";
 import { useAppForm } from "../hooks/form";
 import { getDataSDK } from "@salesforce/sdk-data";
 import { ROUTES, AUTH_PLACEHOLDERS } from "../authenticationConfig";

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{auth → features/authentication}/sessionTimeout/SessionTimeoutValidator.tsx

@@ -10,8 +10,8 @@ import { useAuth } from "../context/AuthContext";
 import { pollSessionTimeServlet, extendSessionTime } from "./sessionTimeService";
 import { useCountdownTimer } from "../hooks/useCountdownTimer";
 import { useRetryWithBackoff } from "../hooks/useRetryWithBackoff";
-import { Alert, AlertTitle, AlertDescription } from "../../components/ui/alert";
-import { Button } from "../../components/ui/button";
+import { Alert, AlertTitle, AlertDescription } from "../../../components/ui/alert";
+import { Button } from "../../../components/ui/button";
 import {
 	Dialog,
 	DialogContent,
@@ -19,7 +19,7 @@ import {
 	DialogTitle,
 	DialogDescription,
 	DialogFooter,
-} from "../../components/ui/dialog";
+} from "../../../components/ui/dialog";
 import {
 	STORAGE_KEYS,
 	LABELS,

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{api → features/global-search/api}/objectDetailService.ts

@@ -11,9 +11,9 @@ import { uiApiClient } from "@salesforce/webapp-experimental/api";
 import type { LayoutResponse } from "../types/recordDetail/recordDetail";
 import { LayoutResponseSchema } from "../types/recordDetail/recordDetail";
 import { fetchAndValidate, safeEncodePath } from "../utils/apiUtils";
-import { objectInfoService } from "../api/objectInfoService";
+import { objectInfoService } from "./objectInfoService";
 import type { ObjectInfoResult } from "../types/objectInfo/objectInfo";
-import { getRecordByIdGraphQL, type GraphQLRecordNode } from "../api/recordListGraphQLService";
+import { getRecordByIdGraphQL, type GraphQLRecordNode } from "./recordListGraphQLService";
 import type { Column } from "../types/search/searchResults";
 import { calculateFieldsToFetch } from "../utils/recordUtils";
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/detail/DetailHeader.tsx

@@ -4,7 +4,7 @@
  * @param title - Record title (e.g. record name) shown next to the back control.
  * @param onBack - Called when the user activates the back control.
  */
-import { Button } from "../ui/button";
+import { Button } from "../../../../components/ui/button";
 import { ArrowLeft } from "lucide-react";
 
 interface DetailHeaderProps {

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/filters/FilterInput.tsx

@@ -22,8 +22,8 @@
  * />
  * ```
  */
-import { Input } from "../ui/input";
-import { Field, FieldLabel, FieldDescription } from "../ui/field";
+import { Input } from "../../../../components/ui/input";
+import { Field, FieldLabel, FieldDescription } from "../../../../components/ui/field";
 import type { Filter } from "../../types/filters/filters";
 
 interface FilterInputProps {

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/filters/FilterSelect.tsx

@@ -30,8 +30,8 @@ import {
 	SelectItem,
 	SelectTrigger,
 	SelectValue,
-} from "../ui/select";
-import { Field, FieldLabel, FieldDescription } from "../ui/field";
+} from "../../../../components/ui/select";
+import { Field, FieldLabel, FieldDescription } from "../../../../components/ui/field";
 import type { Filter } from "../../types/filters/filters";
 import type { PicklistValue } from "../../types/filters/picklist";
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components/filters}/FiltersPanel.tsx

@@ -27,16 +27,21 @@
  * ```
  */
 import { useState, useMemo, useCallback, useEffect, useRef } from "react";
-import { Card, CardContent, CardHeader, CardTitle } from "./ui/card";
-import { Skeleton } from "./ui/skeleton";
-import { FiltersForm } from "./forms/filters-form";
-import { Field, FieldLabel, FieldDescription } from "./ui/field";
-import { useAppForm, validateRangeValues } from "../hooks/form";
-import type { Filter, FilterCriteria } from "../types/filters/filters";
-import type { PicklistValue } from "../types/filters/picklist";
-import { parseFilterValue } from "../utils/filterUtils";
-import { sanitizeFilterValue } from "../utils/sanitizationUtils";
-import { getFormValueByPath } from "../utils/formUtils";
+import {
+	Card,
+	CardContent,
+	CardHeader,
+	CardTitle,
+} from "../../../../components/ui/card";
+import { Skeleton } from "../../../../components/ui/skeleton";
+import { FiltersForm } from "../forms/filters-form";
+import { Field, FieldLabel, FieldDescription } from "../../../../components/ui/field";
+import { useAppForm, validateRangeValues } from "../../hooks/form";
+import type { Filter, FilterCriteria } from "../../types/filters/filters";
+import type { PicklistValue } from "../../types/filters/picklist";
+import { parseFilterValue } from "../../utils/filterUtils";
+import { sanitizeFilterValue } from "../../utils/sanitizationUtils";
+import { getFormValueByPath } from "../../utils/formUtils";
 
 interface FiltersPanelProps {
 	filters: Filter[];

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/forms/filters-form.tsx

@@ -1,8 +1,8 @@
-import { FieldGroup } from "../ui/field";
-import { StatusAlert } from "../alerts/status-alert";
-import { CardLayout } from "../layout/card-layout";
+import { FieldGroup } from "../../../../components/ui/field";
+import { StatusAlert } from "../../../../components/alerts/status-alert";
+import { CardLayout } from "../../../../components/layouts/card-layout";
 import { SubmitButton } from "./submit-button";
-import { Button } from "../ui/button";
+import { Button } from "../../../../components/ui/button";
 import { useFormContext } from "../../hooks/form";
 import { useId, useEffect, useRef } from "react";
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/forms/submit-button.tsx

@@ -1,6 +1,6 @@
-import { Button } from "../ui/button";
-import { Spinner } from "../ui/spinner";
-import { cn } from "../../lib/utils";
+import { Button } from "../../../../components/ui/button";
+import { Spinner } from "../../../../components/ui/spinner";
+import { cn } from "../../../../lib/utils";
 import { useFormContext } from "../../hooks/form";
 
 interface SubmitButtonProps extends Omit<React.ComponentProps<typeof Button>, "type" | "disabled"> {

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components/shared → features/global-search/components/search}/GlobalSearchInput.tsx

@@ -7,11 +7,11 @@
 import { useState, useCallback, useMemo, useId } from "react";
 import type { KeyboardEvent, ChangeEvent } from "react";
 import { useNavigate } from "react-router";
-import { Card, CardContent } from "../ui/card";
-import { Input } from "../ui/input";
-import { Button } from "../ui/button";
+import { Card, CardContent } from "../../../../components/ui/card";
+import { Input } from "../../../../components/ui/input";
+import { Button } from "../../../../components/ui/button";
 import { Search } from "lucide-react";
-import { OBJECT_API_NAMES } from "../../constants";
+import { OBJECT_API_NAMES } from "../../../../constants";
 import { useObjectInfoBatch } from "../../hooks/useObjectInfoBatch";
 
 const BROWSE_SEGMENT = "browse__all";

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/search/SearchPagination.tsx

@@ -9,15 +9,15 @@
  * - Previous disabled when !hasPreviousPage (cursor stack enables prev when pageIndex > 0).
  * - Next disabled when !hasNextPage or nextPageToken is null.
  */
-import { Button } from "../ui/button";
+import { Button } from "../../../../components/ui/button";
 import {
 	Select,
 	SelectContent,
 	SelectItem,
 	SelectTrigger,
 	SelectValue,
-} from "../ui/select";
-import { Label } from "../ui/label";
+} from "../../../../components/ui/select";
+import { Label } from "../../../../components/ui/label";
 import { PAGE_SIZE_OPTIONS, getValidPageSize, isValidPageSize } from "../../utils/paginationUtils";
 import { ChevronLeft, ChevronRight } from "lucide-react";
 

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components/search}/SearchResultCard.tsx

@@ -25,11 +25,16 @@
  */
 import { useNavigate } from "react-router";
 import { useMemo, useCallback } from "react";
-import { Card, CardContent, CardHeader, CardTitle } from "./ui/card";
-import type { Column, SearchResultRecordData } from "../types/search/searchResults";
-import { getNestedFieldValue } from "../utils/fieldUtils";
-import ResultCardFields from "./search/ResultCardFields";
-import { OBJECT_API_NAMES } from "../constants";
+import {
+	Card,
+	CardContent,
+	CardHeader,
+	CardTitle,
+} from "../../../../components/ui/card";
+import type { Column, SearchResultRecordData } from "../../types/search/searchResults";
+import { getNestedFieldValue } from "../../utils/fieldUtils";
+import ResultCardFields from "./ResultCardFields";
+import { OBJECT_API_NAMES } from "../../../../constants";
 
 interface SearchResultCardProps {
 	record: SearchResultRecordData;

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components}/search/SearchResultsPanel.tsx

@@ -32,8 +32,8 @@
  * ```
  */
 import { useMemo } from "react";
-import { Alert, AlertDescription, AlertTitle } from "../ui/alert";
-import { Skeleton } from "../ui/skeleton";
+import { Alert, AlertDescription, AlertTitle } from "../../../../components/ui/alert";
+import { Skeleton } from "../../../../components/ui/skeleton";
 import { AlertCircle } from "lucide-react";
 import {
 	Select,
@@ -41,9 +41,9 @@ import {
 	SelectItem,
 	SelectTrigger,
 	SelectValue,
-} from "../ui/select";
-import { Label } from "../ui/label";
-import SearchResultCard from "../SearchResultCard";
+} from "../../../../components/ui/select";
+import { Label } from "../../../../components/ui/label";
+import SearchResultCard from "./SearchResultCard";
 import SearchPagination from "./SearchPagination";
 import type { Column, SearchResultRecord } from "../../types/search/searchResults";
 import { getSafeKey } from "../../utils/recordUtils";

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/{components → features/global-search/components/shared}/LoadingFallback.tsx

@@ -17,7 +17,7 @@
  * ```
  */
 import { cva, type VariantProps } from "class-variance-authority";
-import { Spinner } from "./ui/spinner";
+import { Spinner } from "../../../../components/ui/spinner";
 
 /**
  * Spinner size variants based on content width.

package/dist/force-app/main/default/webapplications/appreacttemplateb2x/src/features/global-search/filters/FilterInput.tsx

@@ -0,0 +1,55 @@
+/**
+ * FilterInput Component
+ *
+ * Renders a text input field for filter values.
+ * Used for filters that don't have a picklist (affordance !== 'select').
+ *
+ * @param filter - Filter definition containing field path, label, and attributes
+ * @param value - Current filter input value
+ * @param onChange - Callback when input value changes
+ *
+ * @remarks
+ * - Displays filter label or field path as the label
+ * - Shows placeholder text from filter attributes or generates default
+ * - Displays help message if available
+ *
+ * @example
+ * ```tsx
+ * <FilterInput
+ *   filter={textFilter}
+ *   value={filterValue}
+ *   onChange={(value) => setFilterValue(value)}
+ * />
+ * ```
+ */
+import { Input } from "../../../components/ui/input";
+import { Field, FieldLabel, FieldDescription } from "../../../components/ui/field";
+import type { Filter } from "../types/filters/filters";
+
+interface FilterInputProps {
+	filter: Filter;
+	value: string;
+	onChange: (value: string) => void;
+}
+
+export default function FilterInput({ filter, value, onChange }: FilterInputProps) {
+	return (
+		<Field>
+			<FieldLabel htmlFor={filter.targetFieldPath}>
+				{filter.label || filter.targetFieldPath}
+			</FieldLabel>
+			<Input
+				id={filter.targetFieldPath}
+				type="text"
+				value={value}
+				onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.value)}
+				placeholder={
+					filter.attributes?.placeholder ||
+					`Enter ${(filter.label || filter.targetFieldPath).toLowerCase()}`
+				}
+				aria-label={filter.label || filter.targetFieldPath}
+			/>
+			{filter.helpMessage && <FieldDescription>{filter.helpMessage}</FieldDescription>}
+		</Field>
+	);
+}