Shadcn Flutter

https://pub.dev/documentation/shadcn_flutter/latest
Admin
Shadcn Flutter is a comprehensive Flutter UI library inspired by shadcn/ui, providing over 70...
Tokens:2,142,469
Snippets:25,599
Trust Score:9.9
Update:3 months ago
Show doc for...
Tokens:
Raw
### AppBar Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AppBar/AppBar.html

A practical example demonstrating how to populate the leading, title, and trailing sections of an AppBar.

```dart
AppBar(
  leading: [BackButton()],
  title: Text('Settings'),
  trailing: [
    IconButton(icon: Icon(Icons.help), onPressed: _showHelp),
    PopupMenuButton(items: menuItems),
  ],
  backgroundColor: Theme.of(context).colorScheme.primaryContainer,
)
```

--------------------------------

### Get begin property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ShadcnPointArcTween/begin.html

Retrieves the starting value of the animation.

```dart
T? begin;
```

--------------------------------

### Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ControlledStarRating/ControlledStarRating.html

Demonstrates how to initialize a ControlledStarRating with a controller and custom styling.

```dart
ControlledStarRating(
  controller: controller,
  max: 5.0,
  step: 0.1,
  activeColor: Colors.amber,
  backgroundColor: Colors.grey[300],
)
```

--------------------------------

### Initialize ProgressTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ProgressTheme/ProgressTheme.html

Example of initializing a ProgressTheme with custom styling parameters.

```dart
const ProgressTheme(
  color: Colors.blue,
  backgroundColor: Colors.grey,
  borderRadius: BorderRadius.circular(4.0),
  minHeight: 6.0,
);
```

--------------------------------

### Calendar Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Calendar/Calendar.html

A practical example showing how to initialize a Calendar with a specific view, single selection mode, and a custom state builder to disable Sundays.

```dart
Calendar(
  view: CalendarView(2024, 3), // March 2024
  selectionMode: CalendarSelectionMode.single,
  onChanged: (value) => print('Selected: ${value?.toString()}'),
  stateBuilder: (date) => date.weekday == DateTime.sunday
    ? DateState.disabled
    : DateState.enabled,
)
```

--------------------------------

### Basic Window Usage

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Window/Window.html

Example of initializing a Window with a title, specific bounds, and content.

```dart
Window(
  title: Text('My Window'),
  bounds: Rect.fromLTWH(100, 100, 400, 300),
  resizable: true,
  content: MyContentWidget(),
)
```

--------------------------------

### AlignmentGeometry get begin

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/GradientAngleGeometry/begin.html

Retrieves the starting alignment of the gradient.

```APIDOC
## AlignmentGeometry get begin

### Description
The begin property specifies the starting alignment of the gradient. It returns an AlignmentGeometry object that defines where the gradient begins.

### Signature
`AlignmentGeometry get begin;`
```

--------------------------------

### show method implementation

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/FixedTooltipOverlayHandler/show.html

This method initializes an overlay with various parameters for positioning, constraints, and interaction behavior.

```dart
@override
OverlayCompleter<T> show<T>({
  required BuildContext context,
  required AlignmentGeometry alignment,
  required WidgetBuilder builder,
  Offset? position,
  AlignmentGeometry? anchorAlignment,
  PopoverConstraint widthConstraint = PopoverConstraint.flexible,
  PopoverConstraint heightConstraint = PopoverConstraint.flexible,
  Key? key,
  bool rootOverlay = true,
  bool modal = true,
  bool barrierDismissable = true,
  Clip clipBehavior = Clip.none,
  Object? regionGroupId,
  Offset? offset,
  AlignmentGeometry? transitionAlignment,
  EdgeInsetsGeometry? margin,
  bool follow = true,
  bool consumeOutsideTaps = true,
  ValueChanged<PopoverOverlayWidgetState>? onTickFollow,
  bool allowInvertHorizontal = true,
  bool allowInvertVertical = true,
  bool dismissBackdropFocus = true,
  Duration? showDuration,
  Duration? dismissDuration,
  OverlayBarrier? overlayBarrier,
  LayerLink? layerLink,
}) {
  TextDirection textDirection = Directionality.of(context);
  Alignment resolvedAlignment = alignment.resolve(textDirection);
  anchorAlignment ??= alignment * -1;
  Alignment resolvedAnchorAlignment = anchorAlignment.resolve(textDirection);
  final OverlayState overlay = Overlay.of(context, rootOverlay: rootOverlay);
  final themes = InheritedTheme.capture(from: context, to: overlay.context);
  final data = Data.capture(from: context, to: overlay.context);
```

--------------------------------

### DragStartBehavior get dragStartBehavior

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/TextInput/dragStartBehavior.html

Retrieves the drag start behavior configuration for the component.

```APIDOC
## Method Signature

### DragStartBehavior get dragStartBehavior

### Description
Returns the current drag start behavior configuration. This property determines how the drag gesture is initiated.

### Implementation
```dart
DragStartBehavior get dragStartBehavior;
```
```

--------------------------------

### Initialize ModalBackdropTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ModalBackdropTheme/ModalBackdropTheme.html

Example of initializing the ModalBackdropTheme with specific styling properties.

```dart
const ModalBackdropTheme(
  borderRadius: BorderRadius.circular(8),
  barrierColor: Color.fromRGBO(0, 0, 0, 0.5),
  modal: true,
)
```

--------------------------------

### double? get beginAngle

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ShadcnPointArcTween/beginAngle.html

Retrieves the starting angle of the arc in radians. Returns null if begin or end points are null.

```APIDOC
## double? get beginAngle

### Description
Gets the starting angle of the arc in radians. The angle is measured clockwise from the positive x-axis. Returns `null` if either `begin` or `end` is null.

### Return Value
- **double?** - The angle in radians, or null if the arc cannot be calculated.
```

--------------------------------

### Menubar Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Menubar/Menubar.html

Demonstrates how to initialize a Menubar with nested MenuItem structures and custom configuration.

```dart
Menubar(
  border: true,
  popoverOffset: Offset(0, 8),
  children: [
    MenuItem(
      title: Text('View'),
      children: [
        MenuItem(title: Text('Zoom In')),
        MenuItem(title: Text('Zoom Out')),
        MenuDivider(),
        MenuItem(title: Text('Full Screen')),
      ],
    ),
    MenuItem(
      title: Text('Tools'),
      children: [
        MenuItem(title: Text('Preferences')),
        MenuItem(title: Text('Extensions')),
      ],
    ),
  ],
)
```

--------------------------------

### int get hashCode

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AnimatableValue/hashCode.html

Returns the hash code for the AnimatableValue object, calculated based on its start, end, and lerp properties.

```APIDOC
## int get hashCode

### Description
The hash code for this object. A hash code is a single integer which represents the state of the object that affects operator == comparisons.

### Implementation
```dart
@override
int get hashCode {
  return Object.hash(start, end, lerp);
}
```
```

--------------------------------

### double get rangeStart

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/SliderController/rangeStart.html

Retrieves the current start value of the slider when in range mode. Throws an exception if accessed while the slider is in single mode.

```APIDOC
## double get rangeStart

### Description
Gets the current range start value. This property is valid only when the slider is operating in range mode.

### Return Type
- **double** - The current start value of the range.

### Exceptions
- **Exception** - Thrown if called when the slider is in single mode.
```

--------------------------------

### ToastLayer Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ToastLayer/ToastLayer.html

Demonstrates how to initialize a ToastLayer with custom stacking and expansion settings.

```dart
ToastLayer(
  maxStackedEntries: 5,
  expandMode: ExpandMode.expandOnTap,
  spacing: 12.0,
  child: MaterialApp(home: HomePage()),
);
```

--------------------------------

### justifyStart

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/RadixIcons/justifyStart-constant.html

A constant representing the justify start icon from the RadixIcons collection.

```APIDOC
## justifyStart

### Description
Provides the IconData for the 'justify start' icon, which is part of the RadixIcons set included in the shadcn_flutter package.

### Signature
`static const IconData justifyStart`

### Implementation
```dart
static const IconData justifyStart =
    IconData(57495, fontFamily: 'RadixIcons', fontPackage: 'shadcn_flutter');
```
```

--------------------------------

### int get hashCode

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/RangeCalendarValue/hashCode.html

Returns the hash code for the RangeCalendarValue object, calculated based on the start and end properties to ensure consistency with equality checks.

```APIDOC
## int get hashCode

### Description
The hash code for this object. It is a single integer representing the state of the object that affects operator == comparisons.

### Implementation
```dart
@override
int get hashCode => start.hashCode ^ end.hashCode;
```
```

--------------------------------

### Initialize StaticPart

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/StaticPart/StaticPart.html

Usage example for creating a new StaticPart instance with a string path.

```dart
const StaticPart('/')
```

--------------------------------

### Basic SurfaceCard implementation

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/SurfaceCard-class.html

Demonstrates how to initialize a SurfaceCard with custom blur and opacity settings.

```dart
SurfaceCard(
  surfaceBlur: 10,
  surfaceOpacity: 0.8,
  child: Text('Overlay content'),
)
```

--------------------------------

### int get hashCode

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/DateTimeRange/hashCode.html

Returns the hash code for the DateTimeRange object, calculated using the XOR operation on the hash codes of the start and end properties.

```APIDOC
## int get hashCode

### Description
The hash code for this object. A hash code is a single integer which represents the state of the object that affects operator == comparisons.

### Implementation
```dart
@override
int get hashCode => start.hashCode ^ end.hashCode;
```
```

--------------------------------

### Implement start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/SliderValue/start.html

Retrieves the start position, defaulting to the end value if the start is null.

```dart
double get start => _start ?? _end;
```

--------------------------------

### start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AnimatableValue/start.html

The start property is a final field of type T that represents the starting value of the animation.

```APIDOC
## Property: start

### Description
The starting value of the animation. This represents the initial state or value from which the animation begins.

### Signature
`final T start;`
```

--------------------------------

### show<T> method

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/DialogOverlayHandler/show.html

Displays an overlay with the specified configuration, including positioning, sizing, and behavioral settings.

```APIDOC
## show<T> method

### Description
Displays an overlay (popover, sheet, or dialog) with extensive customization options for positioning, sizing, behavior, and appearance. Returns an OverlayCompleter for managing the overlay lifecycle.

### Signature
`OverlayCompleter<T> show<T>({required BuildContext context, required AlignmentGeometry alignment, required WidgetBuilder builder, Offset? position, AlignmentGeometry? anchorAlignment, PopoverConstraint widthConstraint = PopoverConstraint.flexible, PopoverConstraint heightConstraint = PopoverConstraint.flexible, Key? key, bool rootOverlay = true, bool modal = true, bool barrierDismissable = true, Clip clipBehavior = Clip.none, Object? regionGroupId, Offset? offset, AlignmentGeometry? transitionAlignment, EdgeInsetsGeometry? margin, bool follow = true, bool consumeOutsideTaps = true, ValueChanged<PopoverOverlayWidgetState>? onTickFollow, bool allowInvertHorizontal = true, bool allowInvertVertical = true, bool dismissBackdropFocus = true, Duration? showDuration, Duration? dismissDuration, OverlayBarrier? overlayBarrier, LayerLink? layerLink})`

### Parameters
- **context** (BuildContext) - Required - Build context
- **alignment** (AlignmentGeometry) - Required - Overlay alignment
- **builder** (WidgetBuilder) - Required - Overlay content builder
- **position** (Offset?) - Optional - Explicit position (overrides alignment)
- **anchorAlignment** (AlignmentGeometry?) - Optional - Anchor alignment
- **widthConstraint** (PopoverConstraint) - Optional - Width constraint, defaults to flexible
- **heightConstraint** (PopoverConstraint) - Optional - Height constraint, defaults to flexible
- **key** (Key?) - Optional - Widget key
- **rootOverlay** (bool) - Optional - Use root overlay, defaults to true
- **modal** (bool) - Optional - Modal behavior, defaults to true
- **barrierDismissable** (bool) - Optional - Dismissible by tapping barrier, defaults to true
- **clipBehavior** (Clip) - Optional - Clipping behavior, defaults to none
- **regionGroupId** (Object?) - Optional - Region group ID
- **offset** (Offset?) - Optional - Position offset
- **transitionAlignment** (AlignmentGeometry?) - Optional - Transition alignment
- **margin** (EdgeInsetsGeometry?) - Optional - Overlay margin
- **follow** (bool) - Optional - Follow anchor on move, defaults to true
- **consumeOutsideTaps** (bool) - Optional - Consume outside taps, defaults to true
- **onTickFollow** (ValueChanged<PopoverOverlayWidgetState>?) - Optional - Follow tick callback
- **allowInvertHorizontal** (bool) - Optional - Allow horizontal inversion, defaults to true
- **allowInvertVertical** (bool) - Optional - Allow vertical inversion, defaults to true
- **dismissBackdropFocus** (bool) - Optional - Dismiss on backdrop focus, defaults to true
- **showDuration** (Duration?) - Optional - Show animation duration
- **dismissDuration** (Duration?) - Optional - Dismiss animation duration
- **overlayBarrier** (OverlayBarrier?) - Optional - Custom barrier configuration
- **layerLink** (LayerLink?) - Optional - Layer link for positioning

### Returns
- **OverlayCompleter<T>** - An object for managing the overlay lifecycle.
```

--------------------------------

### start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AxisInsetsDirectional/start.html

The start property is a double value representing the starting inset. It is defined as a final field.

```APIDOC
## Property: start

### Description
The start value of the AxisInsetsDirectional object.

### Type
double

### Implementation
final double start;
```

--------------------------------

### show<T> method

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/OverlayManagerAsTooltipOverlayHandler/show.html

Displays an overlay with the specified configuration, including positioning, constraints, and animation settings.

```APIDOC
## show<T> method

### Description
Displays an overlay (popover, sheet, or dialog) with extensive customization options for positioning, sizing, behavior, and appearance.

### Signature
`OverlayCompleter<T?> show<T>({required BuildContext context, required AlignmentGeometry alignment, required WidgetBuilder builder, Offset? position, AlignmentGeometry? anchorAlignment, PopoverConstraint widthConstraint, PopoverConstraint heightConstraint, Key? key, bool rootOverlay, bool barrierDismissable, bool modal, Clip clipBehavior, Object? regionGroupId, Offset? offset, AlignmentGeometry? transitionAlignment, EdgeInsetsGeometry? margin, bool follow, bool consumeOutsideTaps, ValueChanged<PopoverOverlayWidgetState>? onTickFollow, bool allowInvertHorizontal, bool allowInvertVertical, bool dismissBackdropFocus, Duration? showDuration, Duration? dismissDuration, OverlayBarrier? overlayBarrier, LayerLink? layerLink})`

### Parameters
- **context** (BuildContext) - Required - Build context
- **alignment** (AlignmentGeometry) - Required - Overlay alignment
- **builder** (WidgetBuilder) - Required - Overlay content builder
- **position** (Offset?) - Optional - Explicit position (overrides alignment)
- **anchorAlignment** (AlignmentGeometry?) - Optional - Anchor alignment
- **widthConstraint** (PopoverConstraint) - Optional - Width constraint, defaults to flexible
- **heightConstraint** (PopoverConstraint) - Optional - Height constraint, defaults to flexible
- **key** (Key?) - Optional - Widget key
- **rootOverlay** (bool) - Optional - Use root overlay, defaults to true
- **barrierDismissable** (bool) - Optional - Dismissible by tapping barrier, defaults to true
- **modal** (bool) - Optional - Modal behavior, defaults to true
- **clipBehavior** (Clip) - Optional - Clipping behavior, defaults to none
- **regionGroupId** (Object?) - Optional - Region group ID
- **offset** (Offset?) - Optional - Position offset
- **transitionAlignment** (AlignmentGeometry?) - Optional - Transition alignment
- **margin** (EdgeInsetsGeometry?) - Optional - Overlay margin
- **follow** (bool) - Optional - Follow anchor on move, defaults to true
- **consumeOutsideTaps** (bool) - Optional - Consume outside taps, defaults to true
- **onTickFollow** (ValueChanged<PopoverOverlayWidgetState>?) - Optional - Follow tick callback
- **allowInvertHorizontal** (bool) - Optional - Allow horizontal inversion, defaults to true
- **allowInvertVertical** (bool) - Optional - Allow vertical inversion, defaults to true
- **dismissBackdropFocus** (bool) - Optional - Dismiss on backdrop focus, defaults to true
- **showDuration** (Duration?) - Optional - Show animation duration
- **dismissDuration** (Duration?) - Optional - Dismiss animation duration
- **overlayBarrier** (OverlayBarrier?) - Optional - Custom barrier configuration
- **layerLink** (LayerLink?) - Optional - Layer link for positioning

### Returns
- **OverlayCompleter<T?>** - An object for managing the overlay lifecycle.
```

--------------------------------

### int indexWhere(bool test(T element), [int start = 0])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/indexWhere.html

Searches the list for the first element that satisfies the provided test function, starting from the optional start index.

```APIDOC
### Method Signature
`int indexWhere(bool test(T element), [int start = 0])`

### Description
Returns the first index in the list that satisfies the provided `test`. Searches the list from index `start` to the end of the list.

### Parameters
- **test** (bool Function(T element)) - Required - A function that returns true if the element matches the criteria.
- **start** (int) - Optional - The index to start searching from. Defaults to 0.

### Returns
- **int** - The index of the first matching element, or -1 if no element is found.

### Example
```dart
final notes = <String>['do', 're', 'mi', 're'];
final first = notes.indexWhere((note) => note.startsWith('r')); // 1
final second = notes.indexWhere((note) => note.startsWith('r'), 2); // 3
final index = notes.indexWhere((note) => note.startsWith('k')); // -1
```
```

--------------------------------

### Initialize Simple and Controlled Windows

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Window-class.html

Demonstrates creating a basic window with default behaviors and a controlled window managed by a WindowController.

```dart
// Simple window
final window = Window(
  title: Text('My Window'),
  content: MyContent(),
  bounds: Rect.fromLTWH(100, 100, 800, 600),
  resizable: true,
  draggable: true,
);

// Controlled window
final controller = WindowController(initialState);
final controlledWindow = Window.controlled(
  controller: controller,
  title: Text('Controlled Window'),
  content: MyContent(),
);
```

--------------------------------

### Command Widget Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Command/Command.html

Demonstrates how to initialize a Command widget with custom debounce settings and a search builder.

```dart
Command(
  autofocus: false,
  debounceDuration: Duration(milliseconds: 200),
  searchPlaceholder: Text('Search commands...'),
  builder: (context, query) async* {
    final filtered = commands.where((cmd) =>
      cmd.name.toLowerCase().contains(query?.toLowerCase() ?? '')
    );
    yield filtered.map((cmd) => CommandItem(
      title: Text(cmd.name),
      onTap: () => cmd.execute(),
    )).toList();
  },
)
```

--------------------------------

### Implementation of start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/IntervalDuration/start.html

Defines the start property as a nullable Duration type.

```dart
final Duration? start;
```

--------------------------------

### Form Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Form/Form.html

Demonstrates how to implement a basic form with a submission callback and child widgets.

```dart
Form(
  onSubmit: (values) => print('Submitted: $values'),
  child: Column(
    children: [
      TextInput(key: FormKey('email'), label: 'Email'),
      Button(child: Text('Submit')),
    ],
  ),
);
```

--------------------------------

### AxisInsets.start

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AxisInsets/start.html

The start property is a final double value that defines the starting inset.

```APIDOC
## Property: start

### Description
The start property represents the starting inset value for the AxisInsets configuration.

### Type
double (final)

### Usage
Access this property to retrieve the defined starting inset value.
```

--------------------------------

### Access the start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AxisInsets/start.html

The start property is defined as a final double value.

```dart
final double start;
```

--------------------------------

### Usage of showCommandDialog

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/showCommandDialog.html

Example showing how to invoke the command dialog with a search builder.

```dart
final result = await showCommandDialog<String>(
  context: context,
  builder: (context, query) async* {
    yield commands.where((c) => c.contains(query ?? '')).toList();
  },
);
```

--------------------------------

### RangeCalendarValue(DateTime start, DateTime end)

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/RangeCalendarValue/RangeCalendarValue.html

Creates a new instance of RangeCalendarValue with the specified start and end dates. The constructor automatically normalizes the input so that the start date is always before the end date.

```APIDOC
## RangeCalendarValue(DateTime start, DateTime end)

### Description
Creates a range calendar value with the specified start and end dates. Automatically normalizes the range so that the start date is before the end date.

### Parameters
- **start** (DateTime) - Required - The beginning date of the range.
- **end** (DateTime) - Required - The ending date of the range.

### Implementation
```dart
RangeCalendarValue(DateTime start, DateTime end)
    : start = start.isBefore(end) ? start : end,
      end = start.isBefore(end) ? end : start;
```
```

--------------------------------

### Initialize DrawerTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/DrawerTheme/DrawerTheme.html

Example of initializing a DrawerTheme with custom surface opacity, drag handle visibility, and barrier color.

```dart
const DrawerTheme(
  surfaceOpacity: 0.95,
  showDragHandle: true,
  barrierColor: Color.fromRGBO(0, 0, 0, 0.7),
)
```

--------------------------------

### void setRange(int start, int end, Iterable<T> newContents, [int skipCount = 0])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/setRange.html

Writes elements from an iterable into a range of the list, starting from index 'start' (inclusive) to 'end' (exclusive).

```APIDOC
## void setRange(int start, int end, Iterable<T> newContents, [int skipCount = 0])

### Description
Writes some elements of `newContents` into a range of this list. Copies the objects of `newContents`, skipping `skipCount` objects first, into the range from `start` (inclusive) to `end` (exclusive).

### Parameters
- **start** (int) - Required - The starting index of the range to be replaced (inclusive).
- **end** (int) - Required - The ending index of the range to be replaced (exclusive).
- **newContents** (Iterable<T>) - Required - The source iterable containing the new elements.
- **skipCount** (int) - Optional - The number of elements to skip from the beginning of `newContents` before copying. Defaults to 0.

### Usage Example
```dart
final list1 = <int>[1, 2, 3, 4];
final list2 = <int>[5, 6, 7, 8, 9];
// Copies the 4th and 5th items in list2 as the 2nd and 3rd items
// of list1.
const skipCount = 3;
list1.setRange(1, 3, list2, skipCount);
print(list1); // [1, 8, 9, 4]
```
```

--------------------------------

### Basic AutoComplete Implementation

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AutoComplete-class.html

Demonstrates a standard AutoComplete setup with a list of suggestions and word replacement mode.

```dart
AutoComplete(
  suggestions: ['apple', 'apricot', 'banana', 'cherry'],
  mode: AutoCompleteMode.replaceWord,
  child: TextField(
    decoration: InputDecoration(
      hintText: 'Type to search fruits...',
    ),
  ),
)
```

--------------------------------

### Initialize and control a WindowController

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/WindowController-class.html

Demonstrates creating a controller with initial configuration, modifying properties programmatically, and listening for state changes.

```dart
final controller = WindowController(
  bounds: Rect.fromLTWH(100, 100, 800, 600),
  resizable: true,
  draggable: true,
);

// Programmatic control
controller.bounds = Rect.fromLTWH(200, 200, 900, 700);
controller.minimized = true;
controller.maximized = Rect.fromLTWH(0, 0, 1920, 1080);

// Listen for changes
controller.addListener(() {
  print('Window state changed: ${controller.value}');
});
```

--------------------------------

### void removeRange(int start, int end)

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/removeRange.html

Removes the elements with positions greater than or equal to start and less than end from the list. This operation reduces the list's length by end - start.

```APIDOC
## void removeRange(int start, int end)

### Description
Removes a range of elements from the list. The provided range, given by start and end, must be valid (0 <= start <= end <= length).

### Parameters
- **start** (int) - Required - The starting index of the range to remove (inclusive).
- **end** (int) - Required - The ending index of the range to remove (exclusive).

### Usage Example
```dart
final numbers = <int>[1, 2, 3, 4, 5];
numbers.removeRange(1, 4);
print(numbers); // [1, 5]
```
```

--------------------------------

### Initialize NavigationMenuTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/NavigationMenuTheme/NavigationMenuTheme.html

Example of instantiating the NavigationMenuTheme with custom appearance properties.

```dart
NavigationMenuTheme(
  surfaceOpacity: 0.9,
  surfaceBlur: 8.0,
  margin: EdgeInsets.all(16.0),
  offset: Offset(0, 8),
)
```

--------------------------------

### Initialize TableTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/TableTheme/TableTheme.html

Demonstrates how to instantiate a TableTheme with custom border, radius, and background color properties.

```dart
TableTheme(
  border: Border.all(color: Colors.grey),
  borderRadius: BorderRadius.circular(4.0),
  backgroundColor: Colors.white,
);
```

--------------------------------

### Define start property in TimeRange

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/TimeRange/start.html

The start property is defined as a final TimeOfDay variable.

```dart
final TimeOfDay start;
```

--------------------------------

### Search for an element with a start index

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/lastIndexOf.html

Searches the list backwards starting from the provided index.

```dart
final notes = <String>['do', 're', 'mi', 're'];
const startIndex = 2;
final index = notes.lastIndexOf('re', startIndex); // 1
```

--------------------------------

### Usage of getInitials

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Avatar/getInitials.html

Examples showing how to call the getInitials method with different name inputs.

```dart
String initials1 = Avatar.getInitials('John Doe'); // Returns 'JD'
String initials2 = Avatar.getInitials('Madonna'); // Returns 'MA'
```

--------------------------------

### Define the start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/DateTimeRange/start.html

The start property is a final DateTime field representing the beginning of the range.

```dart
final DateTime start;
```

--------------------------------

### Initialize AlertTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AlertTheme/AlertTheme.html

Usage example for creating an AlertTheme instance with custom styling properties.

```dart
const AlertTheme(
  padding: EdgeInsets.all(16.0),
  backgroundColor: Colors.blue,
  borderColor: Colors.blueAccent,
);
```

--------------------------------

### Define the start property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AnimatableValue/start.html

The start property is defined as a generic type T representing the initial animation state.

```dart
final T start;
```

--------------------------------

### Initialize ToastTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ToastTheme/ToastTheme.html

Example of initializing a ToastTheme with custom stacking and hover behavior.

```dart
const ToastTheme(
  maxStackedEntries: 5,
  expandMode: ExpandMode.expandOnHover,
  spacing: 12.0,
  collapsedScale: 0.95,
);
```

--------------------------------

### Basic MenuPopup Implementation

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/MenuPopup-class.html

A standard usage example showing how to define a MenuPopup with padding, styling, and a list of MenuItems.

```dart
MenuPopup(
  padding: EdgeInsets.all(8),
  fillColor: Colors.white,
  borderRadius: BorderRadius.circular(8),
  children: [
    MenuItem(title: Text('Option 1')),
    MenuItem(title: Text('Option 2')),
    MenuItem(title: Text('Option 3')),
  ],
)
```

--------------------------------

### Initialize TabPaneTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/TabPaneTheme/TabPaneTheme.html

Example of initializing the TabPaneTheme with custom styling properties.

```dart
const TabPaneTheme(
  borderRadius: BorderRadius.circular(8),
  backgroundColor: Colors.white,
  border: BorderSide(color: Colors.grey),
  barHeight: 32.0,
)
```

--------------------------------

### DateTimeRange(DateTime start, DateTime end)

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/DateTimeRange/DateTimeRange.html

Creates a new instance of DateTimeRange with a specified start and end date.

```APIDOC
## DateTimeRange Constructor

### Description
Creates a new DateTimeRange instance representing a period between two points in time.

### Signature
`const DateTimeRange(DateTime start, DateTime end)`

### Parameters
- **start** (DateTime) - Required - The beginning of the range.
- **end** (DateTime) - Required - The end of the range.
```

--------------------------------

### Switcher Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Switcher/Switcher.html

Demonstrates how to initialize a Switcher with specific animation parameters and a callback for index changes.

```dart
Switcher(
  index: 0,
  direction: AxisDirection.left,
  duration: Duration(milliseconds: 250),
  curve: Curves.easeOut,
  onIndexChanged: (index) => print('Switched to $index'),
  children: [
    Text('First view'),
    Text('Second view'),
    Text('Third view'),
  ],
);
```

--------------------------------

### Basic AppBar implementation

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/AppBar-class.html

Demonstrates a standard AppBar configuration with leading icons, title, subtitle, and trailing action buttons.

```dart
AppBar(
  leading: [
    IconButton(icon: Icon(Icons.menu), onPressed: _openDrawer),
  ],
  title: Text('My Application'),
  subtitle: Text('Dashboard'),
  trailing: [
    IconButton(icon: Icon(Icons.search), onPressed: _openSearch),
    IconButton(icon: Icon(Icons.more_vert), onPressed: _showMenu),
  ],
  backgroundColor: Colors.blue.shade50,
)
```

--------------------------------

### Extracting a sublist with start and end indices

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/sublist.html

Returns a new list containing elements from the start index up to, but not including, the end index.

```dart
final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
print(colors.sublist(1, 3)); // [green, blue]
```

--------------------------------

### int indexOf(T element, [int start = 0])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/indexOf.html

Returns the first index of the specified element in the list, searching from the optional start index.

```APIDOC
## int indexOf(T element, [int start = 0])

### Description
Returns the first index of `element` in the list. Searches the list from index `start` to the end of the list. The first time an object `o` is encountered so that `o == element`, the index of `o` is returned.

### Parameters
- **element** (T) - Required - The element to search for in the list.
- **start** (int) - Optional - The index to start the search from. Defaults to 0.

### Returns
- **int** - The index of the element if found, otherwise -1.

### Example
```dart
final notes = <String>['do', 're', 'mi', 're'];
print(notes.indexOf('re')); // 1

final indexWithStart = notes.indexOf('re', 2); // 3

final index = notes.indexOf('fa'); // -1
```
```

--------------------------------

### Usage of ColorScheme.fromColors

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ColorScheme/ColorScheme.fromColors.html

Example showing how to initialize a ColorScheme using a map of colors and a brightness setting.

```dart
ColorScheme.fromColors(
  colors: {'background': Colors.white, 'foreground': Colors.black, ...},
  brightness: Brightness.light,
)
```

--------------------------------

### Iterable<T> getRange(int start, int end)

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/getRange.html

Creates an Iterable that iterates over elements of the list with positions greater than or equal to start and less than end.

```APIDOC
## getRange(int start, int end)

### Description
Creates an Iterable that iterates over a range of elements from the list. The returned iterable includes elements at positions from `start` (inclusive) to `end` (exclusive).

### Parameters
- **start** (int) - The starting index of the range.
- **end** (int) - The ending index of the range.

### Returns
- **Iterable<T>** - An iterable containing the elements in the specified range.

### Usage Example
```dart
final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
final firstRange = colors.getRange(0, 3);
print(firstRange.join(', ')); // red, green, blue
```
```

--------------------------------

### Window()

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Window-class.html

Creates a window with explicit state and configuration.

```APIDOC
## Window({Widget? title, Widget? actions, Widget? content, bool resizable, bool draggable, bool closable, bool maximizable, bool minimizable, bool enableSnapping, required Rect? bounds, Rect? maximized, bool minimized, bool alwaysOnTop, BoxConstraints constraints})

### Description
Creates a new window instance with explicit state and configuration properties.

### Parameters
- **title** (Widget?) - Optional - Title widget displayed in the title bar.
- **actions** (Widget?) - Optional - Custom action widgets displayed in the title bar.
- **content** (Widget?) - Optional - Main content widget displayed in the window body.
- **resizable** (bool) - Optional - Whether the window can be resized.
- **draggable** (bool) - Optional - Whether the window can be dragged.
- **closable** (bool) - Optional - Whether the window can be closed.
- **maximizable** (bool) - Optional - Whether the window can be maximized.
- **minimizable** (bool) - Optional - Whether the window can be minimized.
- **enableSnapping** (bool) - Optional - Whether edge snapping is enabled.
- **bounds** (Rect?) - Required - Initial position and size of the window.
- **maximized** (Rect?) - Optional - Bounds when in maximized state.
- **minimized** (bool) - Optional - Whether the window starts minimized.
- **alwaysOnTop** (bool) - Optional - Whether the window stays on top.
- **constraints** (BoxConstraints) - Optional - Size constraints for the window.
```

--------------------------------

### void collapseToStart()

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/CharacterRange/collapseToStart.html

Collapses the range to its start position. This method updates the range so that the end position equals the start position, resulting in an empty range.

```APIDOC
## void collapseToStart()

### Description
Collapses the range to its start. Sets the end of the range to be the same position as the start. The new range is empty and positioned at the start of the current range.

### Signature
`void collapseToStart()`
```

--------------------------------

### ItemPicker Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ItemPicker/ItemPicker.html

Demonstrates how to initialize an ItemPicker with a list of icons, a grid layout, and a dialog prompt mode.

```dart
ItemPicker<IconData>(
  items: ItemList([Icons.home, Icons.star, Icons.favorite]),
  layout: ItemPickerLayout.grid,
  mode: PromptMode.dialog,
  builder: (context, icon, selected) => Icon(icon),
  onChanged: (icon) => updateIcon(icon),
);
```

--------------------------------

### List<T> sublist(int start, [int? end])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/sublist.html

Returns a new list containing the elements between start and end. If end is omitted, it defaults to the length of the list.

```APIDOC
## List<T> sublist(int start, [int? end])

### Description
Returns a new list containing the elements of this list at positions greater than or equal to `start` and less than `end` in the same order as they occur in this list.

### Parameters
- **start** (int) - Required - The starting index (inclusive).
- **end** (int?) - Optional - The ending index (exclusive). Defaults to the length of the list if omitted.

### Usage Example
```dart
final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
print(colors.sublist(1, 3)); // [green, blue]
print(colors.sublist(3)); // [orange, pink]
```

### Constraints
The `start` and `end` positions must satisfy the relations 0 ≤ `start` ≤ `end` ≤ length. If `end` is equal to `start`, the returned list is empty.
```

--------------------------------

### Implementation of the show method

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/FullScreenDialogOverlayHandler/show.html

This method handles the creation and display of a full-screen dialog route, including theme capturing and barrier configuration.

```dart
@override
OverlayCompleter<T> show<T>({
  required BuildContext context,
  required AlignmentGeometry alignment,
  required WidgetBuilder builder,
  Offset? position,
  AlignmentGeometry? anchorAlignment,
  PopoverConstraint widthConstraint = PopoverConstraint.flexible,
  PopoverConstraint heightConstraint = PopoverConstraint.flexible,
  Key? key,
  bool rootOverlay = true,
  bool modal = true,
  bool barrierDismissable = true,
  Clip clipBehavior = Clip.none,
  Object? regionGroupId,
  Offset? offset,
  AlignmentGeometry? transitionAlignment,
  EdgeInsetsGeometry? margin,
  bool follow = true,
  bool consumeOutsideTaps = true,
  ValueChanged<PopoverOverlayWidgetState>? onTickFollow,
  bool allowInvertHorizontal = true,
  bool allowInvertVertical = true,
  bool dismissBackdropFocus = true,
  Duration? showDuration,
  Duration? dismissDuration,
  OverlayBarrier? overlayBarrier,
  LayerLink? layerLink,
}) {
  var navigatorState = Navigator.of(
    context,
    rootNavigator: rootOverlay,
  );
  final CapturedThemes themes =
      InheritedTheme.capture(from: context, to: navigatorState.context);
  final CapturedData data =
      Data.capture(from: context, to: navigatorState.context);
  var dialogRoute = DialogRoute<T>(
    context: context,
    fullScreen: true,
    builder: (context) {
      final theme = Theme.of(context);
      final surfaceOpacity = theme.surfaceOpacity;
      var child = _DialogOverlayWrapper(
        route: ModalRoute.of(context) as DialogRoute<T>,
        child: Builder(builder: (context) {
          return builder(context);
        }),
      );
      if (overlayBarrier != null) {
        return MultiModel(
          data: const [
            Model(#shadcn_flutter_dialog_overlay, true),
          ],
          child: ModalBackdrop(
            modal: modal,
            surfaceClip: ModalBackdrop.shouldClipSurface(surfaceOpacity),
            borderRadius: overlayBarrier.borderRadius,
            padding: overlayBarrier.padding,
            barrierColor: overlayBarrier.barrierColor ??
                const Color.fromRGBO(0, 0, 0, 0.8),
            child: child,
          ),
        );
      }
      return MultiModel(
        data: const [
          Model(#shadcn_flutter_dialog_overlay, true),
        ],
        child: child,
      );
    },
    themes: themes,
    barrierDismissible: barrierDismissable,
    barrierColor: overlayBarrier == null
        ? const Color.fromRGBO(0, 0, 0, 0.8)
        : Colors.transparent,
    barrierLabel: 'Dismiss',
    useSafeArea: true,
    data: data,
    traversalEdgeBehavior: TraversalEdgeBehavior.closedLoop,
    transitionBuilder: (context, animation, secondaryAnimation, child) {
      return _buildShadcnDialogTransitions(
        context,
        BorderRadius.zero,
        Alignment.center,
        animation,
        secondaryAnimation,
        true,
        child,
      );
    },
    alignment: Alignment.center,
  );
  navigatorState.push(
    dialogRoute,
  );
  return DialogOverlayCompleter(dialogRoute);
}
```

--------------------------------

### Create ButtonStyle instances

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ButtonStyle-class.html

Demonstrates how to instantiate primary and outline button styles with specific size, density, and shape configurations.

```dart
// Create a large primary button
const ButtonStyle.primary(
  size: ButtonSize.large,
  density: ButtonDensity.comfortable,
)

// Create a small outline button with circular shape
const ButtonStyle.outline(
  size: ButtonSize.small,
  shape: ButtonShape.circle,
)
```

--------------------------------

### int lastIndexOf(T element, [int? start])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/ListNotifier/lastIndexOf.html

Searches the list backwards from the provided start index (or the end of the list if not provided) to find the last occurrence of the specified element.

```APIDOC
## int lastIndexOf(T element, [int? start])

### Description
Returns the last index of `element` in the list. Searches the list backwards from index `start` to 0. If `start` is not provided, the search begins from the end of the list.

### Parameters
- **element** (T) - Required - The element to search for in the list.
- **start** (int?) - Optional - The index to start searching backwards from.

### Returns
- **int** - The index of the last occurrence of `element`, or -1 if the element is not found.

### Example
```dart
final notes = <String>['do', 're', 'mi', 're'];
final index = notes.lastIndexOf('re'); // 3
```
```

--------------------------------

### Initialize and use SelectController

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/SelectController-class.html

Demonstrates how to instantiate a SelectController, listen for value changes, and update the selection programmatically.

```dart
final controller = SelectController<String>('initial');

// Listen to changes
controller.addListener(() {
  print('Selection changed to: ${controller.value}');
});

// Update selection
controller.value = 'new_value';
```

--------------------------------

### Characters.getRange(int start, [int? end])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Characters/getRange.html

Eagerly selects a range of characters from the start index to the end index. If end is omitted, it defaults to the length of the character sequence.

```APIDOC
## Characters.getRange(int start, [int? end])

### Description
Eagerly selects the range of characters from `start` to `end`. If `end` is omitted, the call is equivalent to `characters.skip(start)`.

### Signature
`Characters getRange(int start, [int? end])`

### Parameters
- **start** (int) - Required - The starting index (must be non-negative).
- **end** (int?) - Optional - The ending index (must be greater than or equal to start).

### Behavior
- If `start` is greater than or equal to the length, the returned characters are empty.
- If `end` is greater than the length or omitted, `end` is treated as the length of the sequence.
```

--------------------------------

### Implementation of show<T> method

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/MenuOverlayHandler/show.html

The method delegates overlay creation to the internal manager, returning an OverlayCompleter for lifecycle management.

```dart
@override
OverlayCompleter<T?> show<T>({
  required BuildContext context,
  required AlignmentGeometry alignment,
  required WidgetBuilder builder,
  Offset? position,
  AlignmentGeometry? anchorAlignment,
  PopoverConstraint widthConstraint = PopoverConstraint.flexible,
  PopoverConstraint heightConstraint = PopoverConstraint.flexible,
  Key? key,
  bool rootOverlay = true,
  bool modal = true,
  bool barrierDismissable = true,
  Clip clipBehavior = Clip.none,
  Object? regionGroupId,
  Offset? offset,
  AlignmentGeometry? transitionAlignment,
  EdgeInsetsGeometry? margin,
  bool follow = true,
  bool consumeOutsideTaps = true,
  ValueChanged<PopoverOverlayWidgetState>? onTickFollow,
  bool allowInvertHorizontal = true,
  bool allowInvertVertical = true,
  bool dismissBackdropFocus = true,
  Duration? showDuration,
  Duration? dismissDuration,
  OverlayBarrier? overlayBarrier,
  LayerLink? layerLink,
}) {
  return manager.showMenu(
    context: context,
    alignment: alignment,
    builder: builder,
    position: position,
    anchorAlignment: anchorAlignment,
    widthConstraint: widthConstraint,
    heightConstraint: heightConstraint,
    key: key,
    rootOverlay: rootOverlay,
    modal: modal,
    barrierDismissable: barrierDismissable,
    clipBehavior: clipBehavior,
    regionGroupId: regionGroupId,
    offset: offset,
    transitionAlignment: transitionAlignment,
    margin: margin,
    follow: follow,
    consumeOutsideTaps: consumeOutsideTaps,
    onTickFollow: onTickFollow,
    allowInvertHorizontal: allowInvertHorizontal,
    allowInvertVertical: allowInvertVertical,
    dismissBackdropFocus: dismissBackdropFocus,
    showDuration: showDuration,
    dismissDuration: dismissDuration,
    overlayBarrier: overlayBarrier,
    layerLink: layerLink,
  );
}
```

--------------------------------

### RangeCalendarValue(DateTime start, DateTime end)

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/RangeCalendarValue-class.html

Creates a new range calendar value instance. The range is automatically normalized so that the start date is always before or equal to the end date.

```APIDOC
### Constructor
RangeCalendarValue(DateTime start, DateTime end)

### Parameters
- **start** (DateTime) - The beginning of the date range.
- **end** (DateTime) - The end of the date range.
```

--------------------------------

### Initialize TreeTheme

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/TreeTheme/TreeTheme.html

Example of configuring a TreeTheme instance with specific branch lines, padding, and multi-select settings.

```dart
TreeTheme(
  branchLine: BranchLine.solid,
  padding: EdgeInsets.all(8),
  allowMultiSelect: true,
)
```

--------------------------------

### NavigationMenu Usage Example

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/NavigationMenu/NavigationMenu.html

Demonstrates how to initialize a NavigationMenu with custom surface opacity and a list of NavigationMenuItem children.

```dart
NavigationMenu(
  surfaceOpacity: 0.9,
  children: [
    NavigationMenuItem(child: Text('Home'), onPressed: _goHome),
    NavigationMenuItem(child: Text('About'), onPressed: _showAbout),
  ],
)
```

--------------------------------

### onTapDown property

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/Button/onTapDown.html

The onTapDown property allows developers to define a callback that triggers when a tap down gesture starts. It is useful for custom press animations or tracking interaction start points.

```APIDOC
## onTapDown

### Description
Callback invoked when a tap down gesture begins. Provides the position and details of the initial touch/click.

### Signature
`GestureTapDownCallback? onTapDown`

### Usage
Useful for implementing custom press animations or tracking interaction start points.
```

--------------------------------

### WindowNavigator({Key? key, required List<Window> initialWindows, Widget? child, bool showTopSnapBar = true})

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/WindowNavigator/WindowNavigator.html

Creates a new instance of WindowNavigator to manage window states and display.

```APIDOC
## WindowNavigator Constructor

### Description
Creates a WindowNavigator widget to manage a collection of windows within the application.

### Parameters
- **key** (Key?) - Optional - The widget key.
- **initialWindows** (List<Window>) - Required - The list of windows to display initially.
- **child** (Widget?) - Optional - A background widget to display behind the windows.
- **showTopSnapBar** (bool) - Optional (default: true) - Whether to show the top snap bar.
```

--------------------------------

### Stream<Uint8List> openRead([int? start, int? end])

Source: https://pub.dev/documentation/shadcn_flutter/latest/shadcn_flutter/XFile/openRead.html

Creates a new independent Stream for the contents of the file. If start is provided, reading begins at that byte-offset; if end is provided, reading stops at that byte-index.

```APIDOC
## Method: openRead

### Signature
`Stream<Uint8List> openRead([int? start, int? end])`

### Description
Creates a new independent Stream for the contents of this file. To ensure system resources are freed, the stream must be read to completion or the subscription must be cancelled.

### Parameters
- **start** (int?) - Optional - The byte-offset to begin reading from. Defaults to 0.
- **end** (int?) - Optional - The byte-index to stop reading at. Defaults to the end of the file.

### Returns
- **Stream<Uint8List>** - A stream containing the file contents.
```
Tokens:
Raw