unified_fields 0.1.6

Standalone unified form fields, pickers, and date/time UI for Flutter apps.

unified_fields

Unified Flutter input widgets—text, numbers, pickers, duration, date & time—and form-aware wrappers that plug into Form with validation, save, reset, and optional shake-on-error feedback. Includes a Gregorian / Jalali (Shamsi) calendar sheet and a vendored scrollable positioned list for large picker lists (no scrollable_positioned_list pub dependency).

---

Table of contents

1. Add to your app
2. What you get (feature map)
3. Core concepts
4. Form integration (validate · save · reset)
5. Shake on validation error
6. Date & calendar
7. Time
8. Duration
9. Pickers
10. Bindings with UnifiedInputPicker
11. Field controllers
12. Field states (isDisabled, loading, …)
13. UI strings (UnifiedFieldsStrings)
14. Theming & layout
15. Global theme (UnifiedInputThemeScope)
16. Persian digits (UnifiedFieldsTypography)
17. Localization
18. Try the built-in demo
19. Dependencies

---

Add to your app

Published on pub.dev/packages/unified_fields. In pubspec.yaml:

dependencies:
  unified_fields: ^0.1.6

Run dart pub get (or flutter pub get).

Import

import 'package:unified_fields/unified_fields.dart';

SDK: Dart ^3.10, Flutter >=3.22 (see pubspec.yaml).

Git or local path (contributors / forks)

If you need a specific commit or a local checkout instead of pub.dev:

dependencies:
  unified_fields:
    git:
      url: https://github.com/MahmoodBakhshayesh/unified_fields.git
      ref: main # or a tag / commit SHA

dependencies:
  unified_fields:
    path: ../unified_fields # relative path to your clone

---

What you get (feature map)

Area	Widgets / APIs	Purpose
Plain fields	UnifiedTextField, UnifiedNumberField, UnifiedNumericStepField, UnifiedDurationField, UnifiedDateField, UnifiedDateRangeField, UnifiedTimeOfDayField	Same visual system as form fields, without FormField
Pickers	UnifiedSinglePickerField, UnifiedMultiPickerField, UnifiedAsyncPickerField, UnifiedAsyncMultiPickerField	Bottom-sheet selection; async variants load items on demand
Customizable pickers	UnifiedCustomizablePickerField, UnifiedCustomizableMultiPickerField, UnifiedCustomizableAsyncPickerField, UnifiedCustomizableAsyncMultiPickerField, CustomizableSinglePickerController, CustomizableMultiPickerController	Controller-driven single or multi selection that also accepts free typed text
Form wrappers	UnifiedFormField, UnifiedFormTextField, UnifiedFormSinglePickerField, UnifiedFormMultiPickerField, UnifiedFormAsyncPickerField, UnifiedFormAsyncMultiPickerField, UnifiedFormDateField, UnifiedFormDateRangeField, UnifiedFormTimeOfDayField, UnifiedFormDurationField, UnifiedFormNumberField, UnifiedFormCustomizablePickerField, UnifiedFormCustomizableMultiPickerField, UnifiedFormCustomizableAsyncPickerField, UnifiedFormCustomizableAsyncMultiPickerField	Form integration: validate, save, reset, validators
Form scope	UnifiedFormFieldScope	Shared AutovalidateMode for all unified form descendants
Calendar	showUnifiedFieldsDatePicker, showUnifiedFieldsDatePickerRange, UnifiedFieldsDatePickerSheet, UnifiedFieldsDatePickerGranularity, UnifiedFieldsCalendarKind, UnifiedFieldsDatePickerStyle	Single date or range; calendar grid or scroll wheels; Gregorian vs Jalali
Time	UnifiedTimeOfDayField, showUnifiedFieldsTimePicker, UnifiedFieldsTimePickerStyle, UnifiedFieldsTimeGranularity, TimePickerUtils.show	Material dial (default) or H:M:S wheels with Shamsi digit toggle
Duration	UnifiedDurationField, showUnifiedFieldsDurationPicker, UnifiedFieldsDurationColumn, UnifiedFieldsDurationColumnPresets, UnifiedDurationGranularity, UnifiedFieldsDurationPickerStyle	Wheel picker with fixed granularity or custom column order (year · week · day · hour, …)
Chrome helpers	UnifiedBaseTextField, UnifiedFieldShell, UnifiedInputDecoration, UnifiedInputBrightness, UnifiedInputPalette, UnifiedInputThemeScope, UnifiedInputPickerHeaderStyle, UnifiedInputMultiPickerCheckboxStyle, UnifiedSuffixIconChrome	Labels, errors, palettes, global theme scope, picker headers, multi-picker checkboxes, aligned suffix icons
Controllers	UnifiedPickerFieldController, UnifiedMultiPickerFieldController, UnifiedAsyncPickerFieldController, UnifiedDateFieldController, UnifiedTimeOfDayFieldController, UnifiedDurationFieldController, UnifiedNumberFieldController, UnifiedFormController	Listenable value + validation + imperative openPicker / requestFocus
Utilities	UnifiedInputPicker, UnifiedFieldsStrings, UnifiedFieldsTypography, UnifiedFieldsContextX, UnifiedColors, UnifiedSheetButton, unifiedFormErrorText, unifiedFormPickerOverride, attachUnifiedFieldHandles	State binding, global UI copy, Persian digits, layout helpers, default colors, sheet actions
Demo	UnifiedInputsShowcasePage	Scrollable gallery of widgets + palette toggle

---

Core concepts

One visual language

Fields share UnifiedInputDecoration (label, placeholder, radii, validation colors, prefix/suffix) and UnifiedInputBrightness (light / dark palette). For colors that should be the same on every field (disabled chrome, required *, validation red, picker sheet background), wrap your app or a screen in UnifiedInputThemeScope — see Global theme.

Two usage modes

1. Standalone — e.g. UnifiedTextField, UnifiedSinglePickerField: drop into any screen; you own validation if needed.
2. Under a Form — use UnifiedForm… variants so GlobalKey<FormState> can call validate(), save(), and reset() on the whole form.

label, placeholder, isRequired

Every field exposes label, placeholder, and isRequired as root-level constructor parameters. They always win over the equivalent values inside UnifiedInputDecoration (which still work as the form-wide default):

UnifiedTextField(
  label: 'Email',
  placeholder: '[e-mail]',
  isRequired: true,
)

UnifiedFormField<T>

Low-level shell: one FormField<T> + your builder. Prefer the prebuilt UnifiedForm… widgets; use UnifiedFormField when you need a custom control but the same autovalidate, reset sync, and optional shakeOnError.

---

Form integration (validate · save · reset)

Wrap inputs in a Form and keep a key:

final _formKey = GlobalKey<FormState>();

@override
Widget build(BuildContext context) {
  return Form(
    key: _formKey,
    child: Column(
      children: [
        UnifiedFormTextField(
          label: 'Name',
          validator: (v) => (v == null || v.isEmpty) ? 'Required' : null,
        ),
        UnifiedFormSinglePickerField<String?>(
          label: 'Country',
          items: countries,
          resetValue: () => null, // on Form reset, clear selection
          validator: (v) => v == null ? 'Pick one' : null,
        ),
        FilledButton(
          onPressed: () {
            if (_formKey.currentState!.validate()) {
              _formKey.currentState!.save();
            }
          },
          child: const Text('Submit'),
        ),
      ],
    ),
  );
}

Reset behavior — UnifiedFormResetValue<T>

typedef UnifiedFormResetValue<T> = T Function();

You pass	On FormState.reset
resetValue: null (default)	Field value is not forced by reset (baseline tracks live value / controller).
resetValue: () => ''	Text / number string resets to empty.
resetValue: () => null	Nullable picker / date clears to null (use nullable generic, e.g. UnifiedFormSinglePickerField<MyEnum?>).
resetValue: () => model.defaultX	Restores that snapshot (pass a new closure if the snapshot should change).
Lists	UnifiedFormMultiPickerField: resetValue: () => const <T>[] or () => myList

Nullable return type is carried by T on the picker (e.g. RoastLevel?), not by T? on the typedef.

---

Shake on validation error

Any UnifiedForm… widget and UnifiedFormField accept shakeOnError (default false). When true, the field runs a short horizontal shake the first time hasError goes from false to true (typical failed validate()).

UnifiedFormTextField(
  label: 'Email',
  shakeOnError: true,
  validator: (v) => v!.contains('@') ? null : 'Invalid',
)

---

Date & calendar

Sheet API

• showUnifiedFieldsDatePicker — returns DateTime?.
• showUnifiedFieldsDatePickerRange — returns DateTimeRange?.

Presentation: bottom sheet on smaller widths; centered dialog when context.unifiedFieldsUseDialogLayout is true (see UnifiedFieldsContextX — width ≥ 900).

Granularity (UnifiedFieldsDatePickerGranularity)

• day — full month grid (default).
• month — pick first day of month in range.
• year — pick first day of year in range.

Calendars (UnifiedFieldsCalendarKind)

Users can switch Gregorian vs Jalali (Shamsi) when showCalendarKindToggle is true. Jalali math uses the shamsi_date package.

Widgets

• UnifiedDateField / UnifiedFormDateField — text field + tap to open picker.
• UnifiedDateRangeField / UnifiedFormDateRangeField — range in one field.

Picker style (UnifiedFieldsDatePickerStyle)

Style	UI
calendar (default)	Month grid (day granularity) or year/month lists
wheels	Scroll wheels left→right: year · month · day (subset per pickerGranularity)

Both styles support Gregorian / Shamsi when showCalendarKindToggle is true. In Shamsi wheel mode, column headers use سال / ماه / روز (customize via UnifiedFieldsStrings). Set showWeekdayInWheel: false to show only the day numeral; weekday + day use fixed column widths on UnifiedFieldsDateWheelStyle.

Calendar today is shown as a hollow circle (same shape as the selected day fill).

UnifiedDateField(
  label: 'Birth date',
  pickerStyle: UnifiedFieldsDatePickerStyle.wheels,
  showWeekdayInWheel: true,
  initialCalendarKind: UnifiedFieldsCalendarKind.jalali,
  pickerGranularity: UnifiedFieldsDatePickerGranularity.day,
)

// Same parameters on the Form wrapper:
UnifiedFormDateField(
  label: 'Birth date',
  pickerStyle: UnifiedFieldsDatePickerStyle.wheels,
  wheelStyle: null, // optional; auto-themed when omitted
)

Date ranges still use the calendar sheet (showUnifiedFieldsDatePickerRange).

Wheel chrome is themed automatically (UnifiedFieldsDateWheelStyle.resolve). Pass optional wheelStyle: only when you need custom colors or zoom.

Jalali field text: when initialCalendarKind / active kind is jalali, the field shows Shamsi-formatted text (e.g. ۱۳,مرداد ۱۴۰۳) after pick, not a Gregorian DateFormat. initialCalendarKind: jalali applies to both calendar grid and wheel pickers (0.1.4).

UnifiedDateField(
  label: 'Event',
  initialCalendarKind: UnifiedFieldsCalendarKind.jalali,
  pickerStyle: UnifiedFieldsDatePickerStyle.calendar, // grid respects jalali
)

---

Time

• UnifiedTimeOfDayField / UnifiedFormTimeOfDayField — display + edit time with unified chrome.
• showUnifiedFieldsTimePicker — bottom sheet with UnifiedFieldsTimePickerStyle.dial (Material) or wheels (H:M:S scroll wheels).
• TimePickerUtils.show(context, …) — forwards to showUnifiedFieldsTimePicker (wheels by default in recent versions; pass pickerStyle to use the platform dial).

Picker style (UnifiedFieldsTimePickerStyle)

Style	UI
dial	Platform showTimePicker
wheels	Scroll wheels for hour · minute · (optional) second

Granularity (UnifiedFieldsTimeGranularity)

• hours — hour wheel only
• hoursMinutes — hour + minute (default for wheels)
• hoursMinutesSeconds — hour + minute + second

Wheels support Gregorian / Shamsi digit toggle via initialCalendarKind and showCalendarKindToggle (same idea as date/duration wheels).

UnifiedTimeOfDayField(
  label: 'Start time',
  pickerStyle: UnifiedFieldsTimePickerStyle.wheels,
  pickerGranularity: UnifiedFieldsTimeGranularity.hoursMinutesSeconds,
  initialCalendarKind: UnifiedFieldsCalendarKind.jalali,
)

---

Duration

• UnifiedDurationField / UnifiedFormDurationField — tap to open a duration sheet; optional manual edit of the formatted string.
• showUnifiedFieldsDurationPicker — imperative sheet API (also used internally by the field).

Picker style (UnifiedFieldsDurationPickerStyle)

Style	UI
wheels (default)	Unified scroll wheels (themed like date/time wheels)
cupertino	Legacy Cupertino-style H:M:S wheels

Granularity vs custom columns

Use granularity for the classic fixed shapes when you do not need year/month/week:

UnifiedDurationGranularity	Columns	Display example
hours	hour	05
hoursMinutes	hour, minute	05:30
hoursMinutesSeconds	hour, minute, second	05:30:45
minutesSeconds	minute, second (minutes may exceed 59)	90:00

Use pickerColumns when you need calendar-style units in a custom order (largest unit first, left → right on the wheel):

UnifiedDurationField(
  label: 'Tenure',
  pickerColumns: [
    UnifiedFieldsDurationColumn.year,
    UnifiedFieldsDurationColumn.week,
    UnifiedFieldsDurationColumn.day,
    UnifiedFieldsDurationColumn.hour,
  ],
  // or: UnifiedFieldsDurationColumnPresets.yearsWeeksDaysHours
  initialCalendarKind: UnifiedFieldsCalendarKind.jalali,
  min: Duration.zero,
  max: const Duration(days: 365 * 10),
)

UnifiedFieldsDurationColumn: year, month, week, day, hour, minute, second.

Presets on UnifiedFieldsDurationColumnPresets: yearsMonthsDays, yearsWeeksDaysHours, hoursMinutesSeconds, minutesSeconds.

When pickerColumns is set, it overrides granularity for both the picker and display format. Wheel ranges: year 0…999, month 0…11, week 0…4 (when used with coarser calendar columns). Totals still compose with year = 365 days, month = 30 days, week = 7 days per unit (standard day/hour/minute/second otherwise); the result is clamped to max on confirm.

Helpers: unifiedFormatDuration, unifiedTryParseDuration, composeUnifiedDuration, decomposeUnifiedDuration, formatUnifiedDurationColumns.

---

Pickers

Widget	Data
UnifiedSinglePickerField<T>	T? selection, searchable list, suggestions
UnifiedMultiPickerField<T>	List<T>, checkboxes in sheet
UnifiedAsyncPickerField<T>	Items from Future<List<T>> Function()
UnifiedAsyncMultiPickerField<T>	Same, multi-select

PickerSheetWidget / MultiPickerSheetWidget are the sheet implementations (scrollable list + search). Form variants mirror the same behavior with FormField.

Customizable APIs (unified_cutomizable_picker_fields.dart — filename keeps the historical typo cutomizable): single or multi selection with CustomizableSinglePickerController / CustomizableMultiPickerController plus async siblings for remote data. Each controller carries either typed text or the selected value(s); the matching UnifiedFormCustomizable… wrappers expose resetValue snapshots so FormState.reset restores both the mode and the payload in one step.

---

Bindings with UnifiedInputPicker

UnifiedInputPicker<T> is a ChangeNotifier holding value, optional errorText, and helpers clear, setError, silentSetValue. Pass it as binding: on fields so UI and domain state stay in sync; form wrappers also write back on save/reset when configured.

Form-aware pickers and date/time fields listen to the binding, so clearing from code updates the visible field:

final country = UnifiedInputPicker<String?>();

UnifiedFormSinglePickerField<String?>(
  label: 'Country',
  binding: country,
  items: countries,
);

// Later — UI and FormField both clear:
country.clear();

You can use binding and fieldController together: the binding holds app state; the typed controller adds picker-specific APIs (openPicker, displayText, sheet options).

AppInputController was renamed in 0.1.4; a deprecated typedef points to UnifiedInputPicker.

---

Field controllers

BaseUnifiedFieldController<T> (and typed subclasses) mirror TextEditingController for pickers, dates, numbers, and duration. Pass fieldController: on the matching Unified… widget.

Controller	Field(s)
UnifiedPickerFieldController<T>	UnifiedSinglePickerField, UnifiedAsyncPickerField
UnifiedMultiPickerFieldController<T>	UnifiedMultiPickerField, UnifiedAsyncMultiPickerField
UnifiedDateFieldController	UnifiedDateField
UnifiedDateRangeFieldController	UnifiedDateRangeField
UnifiedTimeOfDayFieldController	UnifiedTimeOfDayField
UnifiedDurationFieldController	UnifiedDurationField
UnifiedNumberFieldController	UnifiedNumberField, UnifiedNumericStepField

When the field is mounted, openPicker(context) (and async openPickerAsync) use the same code path as a tap—no need to pass items / label again. Off-tree or tests: call bindPicker / bindPickerLabel first, or pass items and label explicitly.

requestFocus() on the controller (or on a binding that shares the attached focus node) focuses the wired field.

UnifiedFormController coordinates multiple controllers for validate/save/reset on a custom form layout.

---

Field states (isDisabled, loading, …)

Shared by UnifiedBaseTextField and every field built on it:

Parameter	Effect
isDisabled / disabled	Read-only look; when both placeholder and value exist, both are shown (not hidden like a greyed empty field).
locked	Blocks interaction; distinct from disabled styling.
loading	Small suffix spinner (replaces dropdown/chevron); field does not use full-field overlay or muted disabled colors.
interactionBlocked	Absorbs pointer events without disabled chrome—used for pick-only surfaces (date, async picker while idle).
labelInRow	Label and body share one rounded border; a straight vertical divider separates them (no inner radius on the body edge).

Async pickers set loading: true while itemProvider runs; date fields use interactionBlocked: true so the platform picker still opens without disabled: true.

---

UI strings (UnifiedFieldsStrings)

All built-in button and sheet copy (Cancel, Confirm, Clear, Done, Pick, Suggestion, date-picker labels, time hour/minute labels, default duration title) comes from UnifiedFieldsStrings.instance. Override once at startup:

void main() {
  UnifiedFieldsStrings.instance = const UnifiedFieldsStrings(
    cancel: 'لغو',
    confirm: 'تأیید',
    clear: 'پاک کردن',
    pickPrefix: 'انتخاب',
  );
  runApp(const MyApp());
}

Multi-picker titles use multiPickerTitle(label) (default "Pick $label"). UnifiedDatePickerStrings is deprecated and reads from the same instance.

---

Theming & layout

• UnifiedColors — default static palette used by built-in styles (replace over time with your design tokens or override via UnifiedInputDecoration / Theme).
• resolveUnifiedDecoration(context, overrides: …, brightness: …) — merges theme + field overrides (used internally by several fields).
• UnifiedFieldsContextX on BuildContext: unifiedFieldsScreenWidth, unifiedFieldsScreenHeight, unifiedFieldsUseDialogLayout, unifiedFieldsPrimaryColor (prefixed to avoid clashing with app extensions).
• UnifiedSheetButton — compact primary / outlined actions used inside picker sheets.

---

Global theme (UnifiedInputThemeScope)

Only child is required. Pass a UnifiedInputThemeData to set shared chrome for every unified field in that subtree (labels, values, placeholders, required icon, errors, suffix icons, picker sheets).

App-wide (recommended)

Wrap runApp so settings screens and forms inherit the same rules:

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(
    UnifiedInputThemeScope(
      data: const UnifiedInputThemeData(
        requiredIconColor: Color(0xFF1565C0),
        requiredIconSize: 9,
        validationColor: Color(0xFFD32F2F),
        disabledFieldOpacity: 0.38,
        placeholderOpacityWhenDisabled: 0.38,
        pickerSheetBackgroundColor: Color(0xFFF5F7FA),
        defaultSuffixIcons: UnifiedInputDefaultSuffixIcons(
          date: Icons.calendar_month_outlined,
          time: Icons.access_time,
          duration: Icons.timelapse_outlined,
          picker: Icons.unfold_more,
        ),
        pickerHeaderStyle: UnifiedInputPickerHeaderStyle(
          padding: EdgeInsets.fromLTRB(16, 14, 8, 14),
          backgroundColor: Colors.white,
        ),
        multiPickerCheckboxStyle: UnifiedInputMultiPickerCheckboxStyle(
          borderRadius: 6,
          fillColor: Color(0xFF1565C0),
          checkColor: Colors.white,
        ),
      ),
      child: const MyApp(),
    ),
  );
}

The runnable example/ app uses this pattern in example/lib/main.dart.

Nested scope (one screen or card)

Inner scopes merge over ancestors — useful for a settings subsection or A/B styling:

UnifiedInputThemeScope(
  data: const UnifiedInputThemeData(
    requiredIconColor: Colors.orange,
    disabledFieldColor: Colors.grey,
    disabledFieldOpacity: 0.5,
  ),
  child: Column(
    children: [
      UnifiedFormTextField(
        label: 'Nickname',
        isRequired: true, // orange * from this scope
      ),
      UnifiedFormTextField(
        label: 'Archived',
        isDisabled: true,
        resetValue: () => 'Read-only',
      ),
    ],
  ),
)

Common UnifiedInputThemeData fields

Field	Effect
brightnessOverride / paletteOverride	Force light/dark or a full custom palette
disabledLabelColor / disabledLabelOpacity	Label when isDisabled / disabled
disabledFieldColor / disabledFieldOpacity	Input text when disabled
disabledFieldBackgroundOpacity	Field body fade when disabled
lockedLabelColor / lockedLabelOpacity	Label when locked
lockedFieldColor / lockedFieldOpacity	Input text when locked
lockedFieldBackgroundOpacity	Body fade when locked
placeholderColor / placeholderOpacity	Hint when enabled
placeholderOpacityWhenDisabled	Hint when disabled
requiredIcon / requiredIconColor / requiredIconSize	Required * marker
validationColor	Inline errors and error border
clearButtonColor	Clear (×) button
suffixIconColor / suffixIconOpacity	Lock, password, default picker suffixes
loadingIndicatorColor	Loading spinner on fields
pickerSheetBackgroundColor	Date/time/duration sheets (else bottomSheetTheme → palette)
pickerHeaderStyle	UnifiedInputPickerHeaderStyle: header padding, backgroundColor, titleStyle, clearButtonColor
multiPickerCheckboxStyle	UnifiedInputMultiPickerCheckboxStyle: size, borderRadius, fillColor, checkColor, borderColor
defaultSuffixIcons	Default suffix per field type (date, time, duration, picker, …)

Field-level UnifiedInputDecoration and per-widget params still win for one-off overrides.

Live demos: example/lib/main.dart (app + nested card) and UnifiedInputsShowcasePage (scoped block near the top of the gallery).

---

Persian digits (UnifiedFieldsTypography)

Shamsi (Jalali) date pickers show Persian numerals (۰–۹) using the bundled KookFaNum font. Override at startup:

void main() {
  UnifiedFieldsTypography.instance = const UnifiedFieldsTypography(
    usePersianDigitsGlobally: true, // all unified text / number fields
    // persianFontFamily: 'YourAppNumFont', // optional
  );
  runApp(const MyApp());
}

By default only Shamsi UI uses Persian digits (usePersianDigitsInShamsi: true). Set usePersianDigitsGlobally: true to apply the font and digit mapping to every field (including UnifiedBaseTextField, numeric step fields, and duration wheels).

---

Localization

• Set UnifiedFieldsStrings.instance for package-owned copy (pickers, date sheet, duration sheet, time picker hour/minute fallbacks, wheel headers including Shamsi سال/ماه/روز, duration column headers via durationColumnHeader).
• Time picker OK/Cancel use MaterialLocalizations when available.
• Clear tooltip on the base text field uses MaterialLocalizations.deleteButtonTooltip (platform).

---

Try the built-in demo

UnifiedInputsShowcasePage is a long-form scroll demo with a brightness / palette toggle. Push it from debug menus or a settings screen:

Navigator.of(context).push(
  MaterialPageRoute<void>(
    builder: (_) => const UnifiedInputsShowcasePage(),
  ),
);

A runnable example app lives in example/ — open it with flutter run from that folder. It wraps the app in UnifiedInputThemeScope, shows a nested-scope demo card on the home form, and opens UnifiedInputsShowcasePage from the app bar (includes a dedicated theme-scope section).

---

Dependencies

Package	Role
intl	Date/number formatting in date fields and picker
shamsi_date	Jalali calendar conversion
collection	Used by the vendored scrollable list implementation

Async pickers show loading via the field suffix spinner (loading on UnifiedBaseTextField), not a full-field overlay.

Vendored code

Under lib/src/scrollable_list/ you’ll find a local copy of a scrollable positioned list implementation (same family as the popular package, kept in-tree so this package stays self-contained).

---

Architecture sketch

flowchart TB
  subgraph form [Form]
    UFS[UnifiedFormFieldScope optional]
    UFT[UnifiedFormTextField]
    UFS2[UnifiedFormSinglePickerField]
    UFD[UnifiedFormDateField]
  end
  UFS --> UFT
  UFS --> UFS2
  UFS --> UFD
  form --> FF[FormState validate save reset]

---

Version

Current release: 0.1.6 (see pubspec.yaml and pub.dev for the latest). Follow semver when upgrading.

Upgrading to 0.1.6

• Wrap your app (or a screen) in UnifiedInputThemeScope for global disabled/placeholder/required/validation colors, picker sheet background, header padding, and multi-picker checkbox styling — see Global theme.
• Replace context.isDesktop / context.width with context.unifiedFieldsUseDialogLayout / context.unifiedFieldsScreenWidth (old names are deprecated).
• Duration wheels default to UnifiedFieldsDurationPickerStyle.wheels; use pickerColumns for year/month/week-style columns.
• unifiedFormatDuration / unifiedTryParseDuration use named granularity: and optional pickerColumns: / calendarKind:.
• Shamsi dates: set initialCalendarKind: jalali; optional UnifiedFieldsTypography for Persian digits (KookFaNum font).

---

License

See the LICENSE file in this repository.