### Install Dependencies and Run App

Source: https://github.com/phmatray/daisyblazor/blob/main/templates/DaisyBlazor.Templates/templates/daisyblazor/README.md

Installs project dependencies including Tailwind CLI and daisyUI, then builds the CSS and starts the Blazor application.

```bash
npm install     # restores Tailwind CLI + daisyUI + the DaisyBlazor preset (first run only)
dotnet run      # builds the CSS, then starts the app on http://localhost:5080
```

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

### Install DaisyBlazor Templates

Source: https://github.com/phmatray/daisyblazor/blob/main/templates/DaisyBlazor.Templates/README.md

Installs the DaisyBlazor.Templates package using the .NET CLI.

```bash
dotnet new install DaisyBlazor.Templates
```

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

### Install Tailwind CSS and daisyUI npm Packages

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Initialize npm and install the necessary Tailwind CSS and daisyUI packages as development dependencies.

```bash
npm init -y
npm install -D tailwindcss @tailwindcss/cli daisyui
```

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

### Create a New Blazor Project with DaisyBlazor Template

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Use this command to start a new Blazor project with DaisyBlazor pre-configured.

```bash
dotnet new install DaisyBlazor.Templates
dotnet new daisyblazor -o MyApp
```

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

### Install DaisyBlazor.Components and Dependencies

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Components/README.md

Install the DaisyBlazor.Components NuGet package and the necessary npm packages for Tailwind CSS and daisyUI.

```bash
dotnet add package DaisyBlazor.Components
npm install -D tailwindcss @tailwindcss/cli daisyui
```

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

### Add DaisyBlazor.Charts Package

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Install the DaisyBlazor.Charts package using the .NET CLI.

```bash
dotnet add package DaisyBlazor.Charts
```

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

### Install Tailwind CSS Preset

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Tailwind/README.md

Install the necessary packages for Tailwind CSS, daisyUI, and the DaisyBlazor preset using npm.

```bash
npm install -D tailwindcss @tailwindcss/cli daisyui @daisyblazor/tailwind
```

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

### Create and Run a DaisyBlazor App

Source: https://github.com/phmatray/daisyblazor/blob/main/templates/DaisyBlazor.Templates/README.md

Generates a new Blazor Web App with DaisyBlazor components, installs dependencies, and runs the application.

```bash
dotnet new daisyblazor -o MyApp
cd MyApp
npm install
donet run
```

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

### Add DaisyBlazor Components Package

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Install the main DaisyBlazor components package. Optionally, install the charts package for SVG charts.

```bash
dotnet add package DaisyBlazor.Components
# optional: dependency-free SVG charts
dotnet add package DaisyBlazor.Charts
```

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

### Basic ThemeProvider Setup

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/theming.md

Wrap your application body with ThemeProvider to enable theme management. This component handles theme application, OS preference following, and persistence.

```razor
<ThemeProvider>
    @Body
</ThemeProvider>
```

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

### Chart Usage Examples

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/charts.md

Demonstrates how to implement various DaisyBlazor charts including LineChart, BarChart, DonutChart, and Sparkline with sample data.

```razor
@using DaisyBlazor.Charts

<LineChart Title="Weekly visitors"
           Labels="@(new[] { "Mon", "Tue", "Wed", "Thu", "Fri" })"
           Series="@_traffic"
           Smooth Area />

<BarChart Data="@(new[]
          {
              new ChartDataPoint("A", 12),
              new ChartDataPoint("B", 28),
              new ChartDataPoint("C", 19)
          })" />

<DonutChart Data="@_breakdown" CenterLabel="100%" />

<Sparkline Data="@(new double[] { 3, 5, 4, 8, 6, 9 })" Area />

@code {
    private readonly ChartSeries[] _traffic =
    {
        new("Visitors", new double[] { 30, 40, 35, 50, 49 }),
        new("Signups",  new double[] {  5,  8,  6, 12, 10 })
    };

    private readonly ChartDataPoint[] _breakdown =
    {
        new("Direct", 40),
        new("Search", 35),
        new("Social", 25)
    };
}
```

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

### Scaffold a New DaisyBlazor App

Source: https://github.com/phmatray/daisyblazor/blob/main/README.md

Use this command to create a new Blazor application pre-configured with DaisyBlazor. Ensure you have the templates installed and then navigate into the created directory.

```bash
dotnet new install DaisyBlazor.Templates
dotnet new daisyblazor -o MyApp
cd MyApp && npm install && dotnet run
```

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

### Basic Chart Usage Example

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Charts/README.md

Demonstrates how to use various DaisyBlazor chart components in a Blazor component. Includes LineChart, BarChart, DonutChart, and Sparkline with sample data.

```razor
<LineChart Title="Traffic"
           Labels="@(new[] { "Mon", "Tue", "Wed", "Thu", "Fri" })"
           Series="@_series"
           Smooth Area />

<BarChart Data="@(new[]
          {
              new ChartDataPoint("A", 12),
              new ChartDataPoint("B", 28),
              new ChartDataPoint("C", 19)
          })" />

<DonutChart Data="@_breakdown" CenterLabel="100%" />

<Sparkline Data="@(new double[] { 3, 5, 4, 8, 6, 9 })" Area />

@code {
    private readonly ChartSeries[] _series =
    {
        new("Visitors", new double[] { 30, 40, 35, 50, 49 }),
        new("Signups",  new double[] {  5,  8,  6, 12, 10 })
    };

    private readonly ChartDataPoint[] _breakdown =
    {
        new("Direct", 40),
        new("Search", 35),
        new("Social", 25)
    };
}
```

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

### Chart Data Initialization

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Initializes the data arrays for the traffic and breakdown charts used in the examples. This includes defining ChartSeries for line charts and ChartDataPoint for bar/donut charts.

```csharp
@code {
    private readonly ChartSeries[] _traffic =
    {
        new("Visitors", new double[] { 30, 40, 35, 50, 49 }),
        new("Signups",  new double[] {  5,  8,  6, 12, 10 })
    };

    private readonly ChartDataPoint[] _breakdown =
    {
        new("Direct", 40),
        new("Search", 35),
        new("Social", 25)
    };
}
```

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

### Line and Bar Chart Usage

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Example of rendering a LineChart with series data and labels, and a BarChart with categorical data points. The LineChart also demonstrates the 'Smooth' and 'Area' options.

```razor
<LineChart Title="Weekly visitors"
           Labels="@(new[] { "Mon", "Tue", "Wed", "Thu", "Fri" })"
           Series="@_traffic"
           Smooth Area />

<BarChart Data="@(new[]
          {
              new ChartDataPoint("A", 12),
              new ChartDataPoint("B", 28),
              new ChartDataPoint("C", 19)
          })" />
```

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

### Donut and Sparkline Chart Usage

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Example of rendering a DonutChart with a center label and a Sparkline chart with area filling. These snippets showcase different chart types and their specific parameters.

```razor
<DonutChart Data="@_breakdown" CenterLabel="100%" />

<Sparkline Data="@(new double[] { 3, 5, 4, 8, 6, 9 })" Area />
```

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

### Basic Card with Tabs and Button

Source: https://github.com/phmatray/daisyblazor/blob/main/README.md

Example of using DaisyBlazor components including Card, Tabs, and Button with an icon. The button uses a primary color and a Material Design filled check icon.

```razor
<Card>
    <CardContent>
        <h2 class="card-title">Hello DaisyBlazor</h2>
        <Tabs>
            <Tab Title="One">First panel</Tab>
            <Tab Title="Two">Second panel</Tab>
        </Tabs>
        <Button Color="Color.Primary" StartIcon="@Icons.Material.Filled.Check">OK</Button>
    </CardContent>
</Card>
```

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

### GetBreadcrumbs

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/ibreadcrumbservice.md

Gets breadcrumb items for the given route, suitable for a daisyUI breadcrumbs trail. It returns a localized list of breadcrumb items starting with Home, or an empty list if no feature handles the route.

```APIDOC
## GetBreadcrumbs(string)

### Description
Gets breadcrumb items for the given route, suitable for a daisyUI breadcrumbs trail.

### Parameters
#### Path Parameters
- **currentRoute** (string) - Required - The current page route (e.g. `"/vouchers/lounge/42"`).

### Returns
A localized list of breadcrumb items starting with Home, or an empty list if no feature handles the route.
```

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

### Run DaisyBlazor Gallery

Source: https://github.com/phmatray/daisyblazor/blob/main/README.md

Command to run the live gallery showcasing every component. Ensure you are in the project root.

```bash
dotnet run --project samples/DaisyBlazor.Gallery
```

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

### Regenerating API Documentation

Source: https://github.com/phmatray/daisyblazor/blob/main/CONTRIBUTING.md

Commands to build the project and generate API reference documentation locally. Requires prior .NET build.

```bash
dotnet build src/DaisyBlazor.Components/DaisyBlazor.Components.csproj -c Release
dotnet build src/DaisyBlazor.Charts/DaisyBlazor.Charts.csproj -c Release
node website/scripts/gen-api.mjs
```

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

### Watch CSS Changes

Source: https://github.com/phmatray/daisyblazor/blob/main/templates/DaisyBlazor.Templates/templates/daisyblazor/README.md

Starts a watcher process to automatically rebuild CSS when source files are edited, providing a fast feedback loop during development.

```bash
npm run watch:css
```

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

### Author Main Stylesheet with Tailwind and DaisyBlazor Presets

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Create the main CSS file, importing Tailwind CSS and the DaisyBlazor preset. Ensure the path to DaisyBlazor.Components is correctly set for Tailwind to scan.

```css
@import "tailwindcss";
@import "daisyblazor/preset.css";  /* daisyUI plugin + neutral themes + dynamic-class safelist */

/* Let Tailwind see the classes used INSIDE the packaged components.
   Point this at wherever DaisyBlazor.Components is restored (project ref or NuGet cache). */
@source "../../**/DaisyBlazor.Components/**/*.{razor,cs}";
```

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

### Use DaisyBlazor Components in a Blazor Page

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Example of using various DaisyBlazor components like `Card`, `Tabs`, and `Button` within a Blazor component.

```razor
<Card>
    <CardContent>
        <h2 class="card-title">Hello DaisyBlazor</h2>
        <p>60+ daisyUI components with a MudBlazor-compatible API.</p>
        <Tabs>
            <Tab Title="One">First panel</Tab>
            <Tab Title="Two">Second panel</Tab>
        </Tabs>
        <CardActions>
            <Button Color="Color.Primary" StartIcon="@Icons.Material.Filled.Check">OK</Button>
        </CardActions>
    </CardContent>
</Card>
```

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

### QuickAccessButton API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the QuickAccessButton component.

```APIDOC
## QuickAccessButton API

### Description
API documentation for the QuickAccessButton component.

### Endpoint
/daisyblazor/api/components/quickaccessbutton/
```

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

### Wrap Layout with ThemeProvider and Service Hosts

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

In your main layout file, wrap the application body with `ThemeProvider` for theme management and include `DialogProvider` and `SnackbarProvider` to render dialogs and snackbars.

```razor
<ThemeProvider>
    @Body

    <DialogProvider />
    <SnackbarProvider />
</ThemeProvider>
```

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

### MockupWindow API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the MockupWindow component.

```APIDOC
## MockupWindow API

### Description
API documentation for the MockupWindow component.

### Endpoint
/daisyblazor/api/components/mockupwindow/
```

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

### ArcPath

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/charts/svggeometry.md

Builds an SVG arc or wedge path for a slice spanning a given start and end radius. It can create either a donut ring segment or a pie wedge from the center.

```APIDOC
## ArcPath(double, double, double, double, double, double, CultureInfo)

### Description
Builds an SVG arc/wedge path for a slice spanning [`startRad`, `endRad`]. When `innerRadius` > 0 a donut ring segment is produced; otherwise a pie wedge from the center.

### Method
(Not specified, likely a static method or function call)

### Parameters
* **startRad** (double) - Description not specified.
* **endRad** (double) - Description not specified.
* **innerRadius** (double) - Description not specified.
* **outerRadius** (double) - Description not specified.
* **centerX** (double) - Description not specified.
* **centerY** (double) - Description not specified.
* **cultureInfo** (CultureInfo) - Description not specified.
```

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

### Local Checks Before Pushing

Source: https://github.com/phmatray/daisyblazor/blob/main/CONTRIBUTING.md

Commands to perform local builds, tests, CSS compilation, and packaging before committing changes.

```bash
dotnet build           # builds everything incl. the gallery CSS
dotnet test            # bUnit component tests
./scripts/build-css.sh # (re)compile the gallery stylesheet
./scripts/pack.sh 0.1.1 # pack locally into ./artifacts
```

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

### QuickAccessButton Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/quickaccessbutton.md

This section details the configurable properties of the QuickAccessButton component.

```APIDOC
## QuickAccessButton

### Description
An outlined full-width button with optional badge, tooltip, and loading state. Used as a quick-access shortcut on feature home pages.

### Properties

- **BadgeText** (string) - Optional. Displays badge text and disables the button when set. The button is wrapped in a `Badge`.
- **Color** (string) - The color applied to the button.
- **Disabled** (boolean) - When true, disables the button.
- **Href** (string) - Optional. Specifies a navigation target. If set, the button functions as a link.
- **Icon** (string) - A leading icon. Use values from `Icons`.
- **Label** (string) - The button label.
- **Loading** (boolean) - When true, displays a progress spinner and disables the button.
- **OnClick** (function) - Click handler. If `Href` is also set, `Href` takes precedence for navigation.
- **TooltipText** (string) - Tooltip displayed over the badge when `BadgeText` is set.
```

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

### Placement API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Placement component.

```APIDOC
## Placement API

### Description
API documentation for the Placement component.

### Endpoint
/daisyblazor/api/components/placement/
```

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

### Repository Structure

Source: https://github.com/phmatray/daisyblazor/blob/main/README.md

Overview of the directory structure for the DaisyBlazor project, including source code, samples, templates, website, tests, and documentation.

```bash
src/        DaisyBlazor.Components, DaisyBlazor.Charts, DaisyBlazor.Tailwind
samples/    DaisyBlazor.Gallery — a runnable showcase of every component
templates/  DaisyBlazor.Templates — dotnet new template
website/    Astro Starlight documentation site (GitHub Pages)
tests/      bUnit component tests
docs/       markdown source for the docs site
scripts/    update-deps, build-css, pack
```

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

### Configure package.json Scripts for CSS Build

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Define scripts in `package.json` to build and watch for CSS changes using Tailwind CSS.

```json
{
  "scripts": {
    "build:css": "tailwindcss -i ./Styles/main.css -o ./wwwroot/css/app.css --minify",
    "watch:css": "tailwindcss -i ./Styles/main.css -o ./wwwroot/css/app.css --watch"
  }
}
```

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

### Register DaisyBlazor Services in Program.cs

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/getting-started.md

Add the necessary DaisyBlazor services, such as `ISnackbar` and `IDialogService`, to the service collection in `Program.cs`.

```csharp
using DaisyBlazor;

builder.Services.AddDaisyBlazor();   // ISnackbar + IDialogService
```

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

### IMudDialogInstance Properties and Methods

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/imuddialoginstance.md

Provides details on the properties and methods available on the IMudDialogInstance interface for managing dialog lifecycle.

```APIDOC
## IMudDialogInstance

Cascaded handle a hosted dialog component uses to close or cancel itself. Mirrors MudBlazor's `IMudDialogInstance` so existing dialog components migrate unchanged.

### Properties

#### `Title`

- **Description**: Title shown in the dialog header.
- **Type**: string

### Methods

#### `Cancel()`

- **Description**: Close the dialog as canceled.

#### `Close()`

- **Description**: Close the dialog with a successful, payload-less result.

#### `Close(DialogResult)`

- **Description**: Close the dialog with the supplied result.
- **Parameters**:
  - **DialogResult** (DialogResult) - Required - The result to close the dialog with.
```

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

### Configure Main CSS with Tailwind and DaisyUI Preset

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Components/README.md

Configure your main CSS file to import Tailwind CSS and the DaisyBlazor preset, which includes daisyUI plugins, themes, and safelist.

```css
@import "tailwindcss";
@import "daisyblazor/preset.css";                 /* daisyUI plugin + themes + safelist */
@source "../../**/DaisyBlazor.Components/**/*.{razor,cs}";  /* see styles/README.md */
```

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

### Swap API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Swap component.

```APIDOC
## Swap API

### Description
API documentation for the Swap component.

### Endpoint
/daisyblazor/api/components/swap/
```

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

### MockupWindow Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/mockupwindow.md

The MockupWindow component exposes several properties to customize its appearance and content.

```APIDOC
## MockupWindow Properties

### `BorderColor`

Optional border color token applied as `border-{token}`; defaults to base-300.

### `ChildContent`

Content rendered inside the window body.

### `Title`

Optional window title shown in the title bar.
```

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

### SmoothPath

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/charts/svggeometry.md

Builds a smoothed cubic-Bézier path through a list of points using Catmull-Rom-to-Bézier conversion. Falls back to a straight path for fewer than three points.

```APIDOC
## SmoothPath(IReadOnlyList<ValueTuple<double, double>>, CultureInfo)

### Description
Builds a smoothed cubic-Bézier path through the points using Catmull-Rom-to-Bézier conversion (tension 1). Falls back to a straight path for fewer than three points.

### Method
(Not specified, likely a static method or function call)

### Parameters
* **points** (IReadOnlyList<ValueTuple<double, double>>) - A list of points represented as tuples of doubles (x, y).
* **cultureInfo** (CultureInfo) - Description not specified.
```

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

### Importing DaisyBlazor Tailwind Preset via NPM

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/css-preset.md

Demonstrates how to import the DaisyBlazor CSS preset using its npm package name. This is the recommended approach for resolving the preset by name.

```css
@import "@daisyblazor/tailwind/preset.css";
```

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

### Loading Component Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/loading.md

This snippet outlines the configurable properties for the Loading component.

```APIDOC
## Loading Component Properties

### Description
Provides configuration options for the Loading component's appearance and behavior.

### Properties

#### `Color`
- **Type**: Enum (e.g., Primary, Secondary, etc.)
- **Description**: Semantic color applied as a Tailwind text-* utility (e.g., Color.Primary → "text-primary").

#### `Size`
- **Type**: Enum (Small, Medium, Large)
- **Description**: Size of the indicator using the standard Size enum (Small → loading-sm, Medium → loading-md, Large → loading-lg). For xs or xl pass `SizeOverride` instead.

#### `SizeOverride`
- **Type**: String
- **Description**: Raw daisyUI size token when xs or xl is needed ("loading-xs" or "loading-xl"). When set, takes precedence over `Size`.

#### `Type`
- **Type**: Enum or String
- **Description**: Animation style of the loading indicator.
```

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

### Step API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Step component.

```APIDOC
## Step API

### Description
API documentation for the Step component.

### Endpoint
/daisyblazor/api/components/step/
```

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

### Register DaisyBlazor Services in Program.cs

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Components/README.md

Add DaisyBlazor services to the service collection in your Blazor application's Program.cs file.

```csharp
builder.Services.AddDaisyBlazor();
```

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

### MenuActivator Methods

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/menuactivator.md

Provides context for menu activators, mirroring a subset of MudBlazor's menu activator context for consuming markup.

```APIDOC
## `MenuActivator(Func<Task>)`

### Description
Context passed to `Menu.ActivatorContent`. Mirrors the subset of MudBlazor's menu activator context used by consuming markup (notably `menu.ToggleAsync`).

## `ToggleAsync()`

### Description
Opens the menu if closed, closes it if open.

### Method
Asynchronous Method Call

### Endpoint
N/A (Method within a component)

### Parameters
None

### Request Example
```csharp
await menuActivator.ToggleAsync();
```

### Response
None (Modifies menu state)

```

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

### Steps API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Steps component.

```APIDOC
## Steps API

### Description
API documentation for the Steps component.

### Endpoint
/daisyblazor/api/components/steps/
```

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

### Queue a New Toast with ISnackbar

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/isnackbar.md

Use the Add method to queue a new toast message. You can specify the message text, severity, and optional configuration options.

```csharp
Snackbar.Add("msg", Severity.Success)
```

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

### MockupBrowser Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/mockupbrowser.md

Documentation for the properties of the MockupBrowser component.

```APIDOC
## MockupBrowser Component Properties

### Description
Provides properties to customize the MockupBrowser component, including border color, content, toolbar, and URL display.

### Properties

#### `BorderColor`
- **Type**: string (token)
- **Optional**: true
- **Description**: Optional border color token applied as `border-{token}`; defaults to no extra border class.

#### `ChildContent`
- **Type**: `RenderFragment`
- **Optional**: false
- **Description**: Content rendered inside the browser display area.

#### `Toolbar`
- **Type**: `RenderFragment`
- **Optional**: true
- **Description**: Optional custom toolbar content; rendered inside the toolbar bar instead of the default URL input.

#### `Url`
- **Type**: string
- **Optional**: true
- **Description**: Optional URL string shown in the address bar input.
```

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

### ShowMessageBoxAsync(string, string, string, string, string)

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/idialogservice.md

Displays a built-in message box dialog with customizable buttons and returns the user's choice.

```APIDOC
## ShowMessageBoxAsync(string, string, string, string, string)

### Description
Shows a built-in confirm dialog. Returns `true` for yes, `false` for no, or `null` when canceled or dismissed.

### Method Signature
`ShowMessageBoxAsync(string title, string message, string yesButtonText, string noButtonText, string cancelButtonText)`

### Parameters
- **title** (string): The title of the message box.
- **message** (string): The message content to display in the message box.
- **yesButtonText** (string): The text for the 'Yes' button.
- **noButtonText** (string): The text for the 'No' button.
- **cancelButtonText** (string): The text for the 'Cancel' button.

### Returns
- `true` if the 'Yes' button is clicked.
- `false` if the 'No' button is clicked.
- `null` if the dialog is canceled or dismissed without a selection.
```

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

### MockupPhone API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the MockupPhone component.

```APIDOC
## MockupPhone API

### Description
API documentation for the MockupPhone component.

### Endpoint
/daisyblazor/api/components/mockupphone/
```

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

### Origin API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Origin component.

```APIDOC
## Origin API

### Description
API documentation for the Origin component.

### Endpoint
/daisyblazor/api/components/origin/
```

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

### StackAlign API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the StackAlign component.

```APIDOC
## StackAlign API

### Description
API documentation for the StackAlign component.

### Endpoint
/daisyblazor/api/components/stackalign/
```

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

### StackOverlay API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the StackOverlay component.

```APIDOC
## StackOverlay API

### Description
API documentation for the StackOverlay component.

### Endpoint
/daisyblazor/api/components/stackoverlay/
```

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

### ThemeController API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the ThemeController component.

```APIDOC
## ThemeController API

### Description
API documentation for the ThemeController component.

### Endpoint
/daisyblazor/api/components/themecontroller/
```

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

### Wrap API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Wrap component.

```APIDOC
## Wrap API

### Description
API documentation for the Wrap component.

### Endpoint
/daisyblazor/api/components/wrap/
```

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

### Configure ThemeProvider with Custom Themes

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Components/styles/README.md

Configure the ThemeProvider component to use your custom themes, including system light/dark themes and other available daisyUI themes.

```razor
<ThemeProvider SystemLightTheme="mybrand" SystemDarkTheme="daisyblazor-dark"
               Themes="@(new[] { "mybrand", "daisyblazor-dark", "dark", "light" })">
    ...
</ThemeProvider>
```

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

### Theme Picker using Select Element

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/theming.md

Create a theme picker by binding a select element to the available themes from ThemeProvider. The selected option reflects the user's current preference.

```razor
<select class="select" @onchange="@(e => Theme!.SetThemeAsync(e.Value!.ToString()!))">
    <option value="system">System</option>
    @foreach (string t in Theme!.Themes)
    {
        <option value="@t" selected="@(t == Theme.Preference)">@t</option>
    }
</select>
```

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

### SwapAnimation API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the SwapAnimation component.

```APIDOC
## SwapAnimation API

### Description
API documentation for the SwapAnimation component.

### Endpoint
/daisyblazor/api/components/swapanimation/
```

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

### LoadingSize

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/cssclass.md

Converts a Size enum to a daisyUI spinner or progress bar size class string.

```APIDOC
## LoadingSize(Size)

### Description
Maps a `Size` enum to a corresponding daisyUI spinner or progress bar size class.

### Method
`LoadingSize`

### Parameters
#### Path Parameters
- **Size** (enum) - Required - The Size enum value.
```

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

### ShowAsync

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/dialogservice.md

Shows a dialog asynchronously. This method is generic and allows specifying the dialog type. It takes a title, optional parameters, and optional dialog options.

```APIDOC
## ShowAsync<T>(string, DialogParameters, DialogOptions)

### Description
Shows a dialog asynchronously with a specified title, optional parameters, and optional dialog options.

### Method Signature
`ShowAsync<T>(string title, DialogParameters parameters = null, DialogOptions options = null)`

### Parameters
#### Type Parameters
- **T**: The type of the dialog to show.

#### Method Parameters
- **title** (string) - Required - The title of the dialog.
- **parameters** (DialogParameters) - Optional - Parameters to pass to the dialog.
- **options** (DialogOptions) - Optional - Options for configuring the dialog display.
```

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

### ThemeProvider Methods

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/theming/themeprovider.md

Methods available on the ThemeProvider component for theme resolution and selection.

```APIDOC
## ThemeProvider Methods

### `OnAfterRenderAsync(bool)`

### `OnInitialized()`

### `ResolveTheme(string, bool)`

Resolves a preference (theme name or "system") to a concrete daisyUI theme.

### `SetThemeAsync(string)`

Selects a theme and persists it. Pass any value from `ThemeProvider.Themes`, or `ThemeProvider.SystemPreference` to follow the OS setting.
```

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

### MockupCode Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/mockupcode.md

Details the properties available for the MockupCode component, which allows for rendering code blocks with optional line prefixes.

```APIDOC
## MockupCode Component Properties

### `ChildContent`

**Description**: Content rendered verbatim inside the code block. Use this property when you need custom `<pre>` rows.

### `Lines`

**Description**: A convenience list of code lines. Each line is automatically wrapped in `<pre data-prefix="..."><code>`.

### `Prefix`

**Description**: The prefix shown before each line when using `MockupCode.Lines`. Defaults to "$".
```

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

### Import DaisyBlazor.Charts Namespace

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Import the necessary namespace to use the charting components in your Razor files.

```razor
@using DaisyBlazor.Charts
```

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

### ChartSeries()

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/charts/chartseries.md

Creates an empty series. This method initializes a new ChartSeries object without any data or name.

```APIDOC
## ChartSeries()

### Description
Creates an empty series.

### Method
Constructor

### Endpoint
N/A (Class Constructor)

### Parameters
None

### Response
- Initializes an empty ChartSeries object.
```

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

### Size API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Size component.

```APIDOC
## Size API

### Description
API documentation for the Size component.

### Endpoint
/daisyblazor/api/components/size/
```

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

### ChartSeries(string, IReadOnlyList<double>, string)

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/charts/chartseries.md

Creates a named series from a sequence of values. This constructor allows for the creation of a ChartSeries with a specified name, a list of double values, and an optional CSS color override.

```APIDOC
## ChartSeries(string name, IReadOnlyList<double> data, string color)

### Description
Creates a named series from a sequence of values.

### Method
Constructor

### Endpoint
N/A (Class Constructor)

### Parameters
#### Parameters
- **name** (string) - Required - The display name for the series (legend / tooltip label).
- **data** (IReadOnlyList<double>) - Required - Ordered values; index `i` aligns with X label `i`.
- **color** (string) - Optional - CSS color override; falls back to the cycling palette when null.
```

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

### Configure Main Stylesheet

Source: https://github.com/phmatray/daisyblazor/blob/main/src/DaisyBlazor.Tailwind/README.md

Import Tailwind CSS and the DaisyBlazor preset into your main stylesheet. Ensure Tailwind can detect classes used within DaisyBlazor's Razor components by specifying the source path.

```css
@import "tailwindcss";
@import "@daisyblazor/tailwind/preset.css";

/* Let Tailwind see the classes used inside DaisyBlazor's .razor components: */
@source "../**/DaisyBlazor.Components/**/*.{razor,cs}";
```

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

### Alert Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/alert.md

Documentation for the configurable properties of the Alert component.

```APIDOC
## Alert Component Properties

### `Icon`

**Description:** Explicit icon ligature; overrides the severity default when set.

### `NoIcon`

**Description:** Suppress the leading severity icon.
```

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

### Skeleton API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Skeleton component.

```APIDOC
## Skeleton API

### Description
API documentation for the Skeleton component.

### Endpoint
/daisyblazor/api/components/skeleton/
```

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

### SnackbarMessage Constructor

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/snackbarmessage.md

Initializes a new instance of the SnackbarMessage class. This represents a single snackbar/toast entry tracked by ISnackbar.

```APIDOC
## `SnackbarMessage(Guid, string, Severity, SnackbarOptions)`

### Description

Initializes a new instance of the SnackbarMessage class. This represents a single snackbar/toast entry tracked by ISnackbar.

### Parameters

#### Path Parameters

- **id** (Guid) - Required - The unique identifier for the snackbar message.
- **message** (string) - Required - The text content of the snackbar message.
- **severity** (Severity) - Required - The severity level of the snackbar message (e.g., Info, Success, Warning, Error).
- **options** (SnackbarOptions) - Required - Configuration options for the snackbar message display.
```

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

### Color Theming with DaisyUI

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/charts.md

Demonstrates how to override individual series or point colors using CSS variables or literals. Colors are derived from ChartPalette, which maps to daisyUI theme tokens.

```csharp
new ChartSeries("Errors", data, color: "var(--color-error)");   // a theme token
new ChartDataPoint("Other", 12, "#94a3b8");                     // a hex literal
```

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

### Tooltip Properties

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/tooltip.md

This section details the configurable properties of the Tooltip component.

```APIDOC
## Tooltip Properties

### `Arrow`

Accepted for MudBlazor compatibility; daisyUI tooltips always show an arrow.

### `Placement`

Tooltip placement relative to the wrapped content.

### `Text`

Tooltip text shown on hover.
```

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

### Pushing to Release Branch

Source: https://github.com/phmatray/daisyblazor/blob/main/CONTRIBUTING.md

Command to fast-forward the release branch to the main branch for triggering a publish workflow.

```bash
git push origin main:release
```

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

### TimelinePosition API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the TimelinePosition component.

```APIDOC
## TimelinePosition API

### Description
API documentation for the TimelinePosition component.

### Endpoint
/daisyblazor/api/components/timelineposition/
```

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

### ShowAsync<T>(string, DialogParameters, DialogOptions)

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/components/idialogservice.md

Shows a dialog component of type T with a specified title, parameters, and options.

```APIDOC
## ShowAsync<T>(string, DialogParameters, DialogOptions)

### Description
Shows a dialog component of type T with the given title, parameters, and options.

### Method Signature
`ShowAsync<T>(string title, DialogParameters parameters, DialogOptions options)`

### Parameters
- **T**: The type of the dialog component to show.
- **title** (string): The title of the dialog.
- **parameters** (DialogParameters): An object containing parameters to pass to the dialog component.
- **options** (DialogOptions): An object containing options for the dialog's appearance and behavior.
```

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

### Tooltip API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Tooltip component.

```APIDOC
## Tooltip API

### Description
API documentation for the Tooltip component.

### Endpoint
/daisyblazor/api/components/tooltip/
```

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

### Underline API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Underline component.

```APIDOC
## Underline API

### Description
API documentation for the Underline component.

### Endpoint
/daisyblazor/api/components/underline/
```

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

### SnackbarOptions API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the SnackbarOptions component.

```APIDOC
## SnackbarOptions API

### Description
API documentation for the SnackbarOptions component.

### Endpoint
/daisyblazor/api/components/snackbaroptions/
```

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

### TimelineAlign API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the TimelineAlign component.

```APIDOC
## TimelineAlign API

### Description
API documentation for the TimelineAlign component.

### Endpoint
/daisyblazor/api/components/timelinealign/
```

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

### Using Material Icons with Button and Icon Components

Source: https://github.com/phmatray/daisyblazor/blob/main/docs/mudblazor-migration.md

Demonstrates how to use Material Symbols ligatures for icons within Button and Icon components. Ensure the Material Symbols webfont is loaded in your host page.

```razor
<Button StartIcon="@Icons.Material.Filled.Check">OK</Button>
<Icon Name="@Icons.Material.Filled.Delete" />
```

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

### Navbar API

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/index.md

API documentation for the Navbar component.

```APIDOC
## Navbar API

### Description
API documentation for the Navbar component.

### Endpoint
/daisyblazor/api/components/navbar/
```

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

### DataGrid<T> Methods

Source: https://github.com/phmatray/daisyblazor/blob/main/website/src/content/docs/api/data/datagrid.md

Methods available on the DataGrid component for programmatic control.

```APIDOC
## DataGrid<T> Methods

### `AddColumn(Column<T>)`

Registers a column (called by child columns on init).

### `ReloadServerData()`

Forces a reload from the server-data source (no-op for client-side data).

### `SetPageAsync(int)`

Sets the current page and refreshes the body.

### `SetPageSizeAsync(int)`

Changes the page size, resets to the first page, and refreshes.

### `UsePageSizeOptions(int[])`

Lets a child pager supply the page-size options without externally setting the parameter.
```