Filament Collapse

https://github.com/drafolin/filament-collapse
Admin
Filament Collapse is a Laravel Filament plugin providing a layout field component that collapses the...
Tokens:20,708
Snippets:299
Trust Score:6.7
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Installation Commands

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Commands to install the package via Composer and optionally publish views.

```bash
# Install via Composer
composer require drafolin/filament-collapse

# Optionally publish views for customization
php artisan vendor:publish --tag="filament-collapse-views"
```

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

### Verify package installation

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Instantiate the component to ensure the class is correctly loaded.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

// If this resolves without error, installation is successful
$collapse = FilamentCollapse::make([]);
```

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

### Basic Usage Example

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Demonstrates how to initialize a FilamentCollapse component with form fields.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('first_name')
        ->label('First Name'),
    TextInput::make('last_name')
        ->label('Last Name'),
])
->label('Full Name')
```

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

### Install Filament Collapse via Composer

Source: https://github.com/drafolin/filament-collapse/blob/main/README.md

Run this command in your terminal to add the package to your project.

```bash
composer require drafolin/filament-collapse
```

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

### Configure Filament Collapse component

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Demonstrates basic setup of a FilamentCollapse instance with child fields and method chaining for configuration.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('first_name')
        ->label('First Name')
        ->required(),
    TextInput::make('last_name')
        ->label('Last Name')
        ->required(),
])
->label('Personal Information')
->disabled(false)
->visible(true)
->extraAttributes(['class' => 'border-blue-500']);
```

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

### Valid and Invalid UUID Patterns

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Examples of valid UUID strings and patterns, alongside an example that triggers the validation error.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

// Valid: starts with letter
FilamentCollapse::make([
    TextInput::make('field'),
])->uuid('collapse_group');  // OK

// Valid: auto-generated UUID (default)
$collapse = FilamentCollapse::make([
    TextInput::make('field'),
]);  // OK - generates 'collapse__<uuid>'

// Valid: empty string generates new UUID
FilamentCollapse::make([
    TextInput::make('field'),
])->uuid('');  // OK - auto-generates

// Valid: contains hyphens (converted to underscores)
FilamentCollapse::make([
    TextInput::make('field'),
])->uuid('my-collapse-group');  // OK - becomes 'my_collapse_group'

// Invalid: starts with number
FilamentCollapse::make([
    TextInput::make('field'),
])->uuid('2checkout');  // InvalidArgumentException
```

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

### Filament Admin Panel Integration

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Example of nesting FilamentCollapse inside a standard Filament Section component.

```php
use Filament\Resources\Resource;
use Filament\Forms;

class UserResource extends Resource
{
    public static function form(Form $form): Form
    {
        return $form->schema([
            Forms\Components\Section::make('User Details')->schema([
                FilamentCollapse::make([
                    Forms\Components\TextInput::make('name'),
                    Forms\Components\TextInput::make('email'),
                ]),
            ]),
        ]);
    }
}
```

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

### Livewire Form Component Integration

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Implementation guide for using FilamentCollapse within a standalone Livewire component that implements HasForms.

```php
use Filament\Forms\Concerns\InteractsWithForms;
use Filament\Forms\Contracts\HasForms;
use Livewire\Component;

class UserForm extends Component implements HasForms
{
    use InteractsWithForms;

    public function form(Form $form): Form
    {
        return $form->schema([
            FilamentCollapse::make([
                // Components
            ]),
        ]);
    }

    public function render()
    {
        return view('livewire.user-form');
    }
}
```

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

### Implement Date Range Collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Groups start and end date pickers within a collapsible section. Use TextInput with date input types if DatePicker components do not collapse as expected.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\DatePicker;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make([
            DatePicker::make('start_date')
                ->label('Start Date')
                ->required(),
            DatePicker::make('end_date')
                ->label('End Date')
                ->required()
                ->afterOrEqual('start_date'),
        ])
        ->label('Date Range'),
    ]);
}
```

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

### Validating Collapse UUIDs

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Ensure UUIDs start with a letter to prevent malformed component identifiers.

```php
function validateCollapseUuid(string $uuid): bool
{
    if ($uuid === '') {
        return true;  // Empty string is valid
    }
    
    // Must start with a letter
    return preg_match('/^[a-zA-Z]/', $uuid) === 1;
}

// Usage
$uuid = $userInput;
if (!validateCollapseUuid($uuid)) {
    $uuid = 'collapse_' . ltrim($uuid, '0123456789');
}

FilamentCollapse::make($schema)->uuid($uuid);
```

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

### Handle InvalidArgumentException

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/types.md

Catch exceptions thrown when providing invalid UUID strings, such as those starting with a number.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use InvalidArgumentException;

try {
    FilamentCollapse::make([
        TextInput::make('field'),
    ])->uuid('123invalid');
} catch (InvalidArgumentException $e) {
    // Error message: 'The first character of the UUID must not be a number'
}
```

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

### Conditionally display the collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Use a closure with the Get helper to determine visibility based on other form field values.

```php
FilamentCollapse::make([
    TextInput::make('field'),
])
->visible(function (Get $get) {
    return $get('show_advanced');
})
```

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

### Instance Creation

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Initializes a new instance of the component with a defined schema.

```php
public static function make(array|Closure $schema): static
```

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

### Create instance with Factory Pattern

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/architecture.md

Use the static make method to initialize a new instance with a schema.

```php
FilamentCollapse::make($schema)
```

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

### Create Form Implementation

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Shows how to wrap form components in a collapsible section for create forms.

```php
public static function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make([
            TextInput::make('email')
                ->email()
                ->required(),
            TextInput::make('phone')
                ->tel(),
        ])
        ->label('Contact Information'),
    ]);
}
```

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

### Project Directory Structure

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/architecture.md

Overview of the package file organization and core source files.

```text
filament-collapse/
├── src/
│   ├── FilamentCollapse.php              # Main component class
│   └── FilamentCollapseServiceProvider.php # Service provider
├── resources/
│   ├── views/
│   │   └── filament-collapse.blade.php   # Component Blade template
│   ├── css/
│   │   └── index.css                     # Source CSS (uncompiled)
│   ├── js/
│   │   └── index.js                      # JavaScript (empty)
│   └── dist/
│       └── filament-collapse.css         # Compiled CSS
├── composer.json
├── package.json
└── README.md
```

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

### Triggering InvalidArgumentException in FilamentCollapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Demonstrates how providing a UUID starting with a numeric character triggers an InvalidArgumentException.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use InvalidArgumentException;

try {
    FilamentCollapse::make([
        TextInput::make('field'),
    ])->uuid('123invalid');  // Throws InvalidArgumentException
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();  // "The first character of the UUID must not be a number"
}
```

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

### Configure instance with Builder Pattern

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/architecture.md

Chain configuration methods fluently to set properties on the component.

```php
FilamentCollapse::make($schema)
    ->label('...')
    ->uuid('...')
    ->disabled(...)
```

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

### Configuration Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Methods for configuring component properties, all supporting method chaining.

```php
public function uuid(string|Closure $uuid): static
public function label(string|Translatable|Closure $label): static
public function disabled(bool|Closure $disabled): static
public function visible(bool|Closure $visible): static
public function extraAttributes(array $attributes, bool $merge = false): static
public function helperText(string|Translatable|Closure $helperText): static
public function hint(string|Translatable|Closure $hint): static
public function hintIcon(string $icon): static
public function hintIconTooltip(string|Translatable|Closure $tooltip): static
public function description(string|Translatable|Closure $description): static
```

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

### UUID Validation Error Message

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

The error message returned when a UUID fails validation by starting with a numeric character.

```text
"The first character of the UUID must not be a number"
```

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

### Handle components without placeholder support

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Notes that components lacking placeholder support will retain visible labels.

```php
FilamentCollapse::make([
    Select::make('status')
        ->label('Status'),  // Label may still show
    TextInput::make('name'),
])
```

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

### Display project file structure

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/README.md

Visual representation of the project directory layout.

```text
output/
├── README.md                     ← You are here
├── INDEX.md                      ← Documentation index & navigation
├── TECHNICAL-REFERENCE.md        ← Quick reference & overview
├── API-REFERENCE.md              ← Method signatures & API
├── USAGE-EXAMPLES.md             ← Practical examples
├── INTEGRATION-GUIDE.md          ← Setup & integration
├── CONFIGURATION.md              ← Configuration options
├── COMPONENTS-REFERENCE.md       ← Component details
├── ARCHITECTURE.md               ← System design
├── TYPES.md                      ← Type definitions
└── ERRORS.md                     ← Error handling
```

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

### Initialize FilamentCollapse Component

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

Entry point for creating a new instance of the component.

```php
Drafolin\FilamentCollapse\FilamentCollapse::make($schema)
```

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

### Configure Placeholder Support

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Use components that support the placeholder method to ensure labels are converted correctly.

```php
// Works - TextInput has placeholder()
FilamentCollapse::make([
    TextInput::make('name'),  // Gets placeholder
])

// May not work - needs placeholder support
FilamentCollapse::make([
    Select::make('status'),   // May not convert
])
```

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

### Manage Multiple Collapse Components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Use multiple components for small sets, but consider splitting into sections or forms when exceeding 10 components to maintain performance.

```php
// Acceptable
FilamentCollapse::make([...])  // 3-5 collapses
FilamentCollapse::make([...])
FilamentCollapse::make([...])

// Consider splitting into sections if:
FilamentCollapse::make([...])  // 10+ collapses
// Break into multiple forms or sections
```

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

### Publish Package Views

Source: https://github.com/drafolin/filament-collapse/blob/main/README.md

Optionally publish the package views to your application.

```bash
php artisan vendor:publish --tag="filament-collapse-views"
```

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

### Label-to-placeholder conversion logic

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Illustrates how components with placeholder support automatically move labels to placeholders and hide the original label.

```php
TextInput::make('first_name')
    ->label('First Name')

// Becomes:
TextInput::make('first_name')
    ->label('First Name')        // Stored but not displayed
    ->placeholder('First Name')  // Used as input placeholder
    ->hiddenLabel()              // Label hidden
```

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

### Dynamic configuration with Closures

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/architecture.md

Pass closures to methods for deferred evaluation of schema and properties at render time.

```php
FilamentCollapse::make(fn() => [...])  // Schema evaluated at render time
->uuid(fn() => 'collapse_' . auth()->id())  // UUID evaluated at render time
```

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

### Visualize Project File Relationships

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/MANIFEST.md

Displays the hierarchical structure of the project documentation files.

```text
README.md (Entry point)
    ├─→ INDEX.md (Navigation)
    │   ├─→ TECHNICAL-REFERENCE.md (Quick reference)
    │   ├─→ API-REFERENCE.md (Method docs)
    │   ├─→ USAGE-EXAMPLES.md (Code examples)
    │   ├─→ INTEGRATION-GUIDE.md (Setup & troubleshooting)
    │   ├─→ CONFIGURATION.md (Config options)
    │   ├─→ COMPONENTS-REFERENCE.md (Component details)
    │   ├─→ ARCHITECTURE.md (System design)
    │   ├─→ TYPES.md (Type definitions)
    │   └─→ ERRORS.md (Error handling)
    └─→ All other files for reference
```

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

### Integrate Select components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Demonstrates wrapping standard Select components within a FilamentCollapse container.

```php
use Filament\Forms\Components\Select;

FilamentCollapse::make([
    Select::make('field1'),
    Select::make('field2'),
])
```

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

### Cache View Command

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Use this command when deploying to production to cache views.

```bash
php artisan view:cache
```

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

### Component Lifecycle Flow

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

Visual representation of the component instantiation and rendering sequence.

```text
User instantiation
    ↓
__construct() called with schema
    ↓
UUID generated: 'collapse__<uuid>'
    ↓
schema() called to register children
    ↓
configure() called
    ↓
Form rendering begins
    ↓
getChildComponentContainer() called
    ↓
CSS classes and labels processed
    ↓
Blade template renders
    ↓
Alpine.js x-init executes
    ↓
Label widths calculated and aligned
```

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

### Configure Filament Collapse via Method Chaining

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

Use this pattern to fluently configure component properties such as labels, visibility, and attributes.

```php
FilamentCollapse::make($schema)
    ->label('...')          // Set label
    ->uuid('...')           // Set UUID
    ->disabled(true)        // Disable
    ->visible(true)         // Show/hide
    ->extraAttributes([...]) // Add attributes
```

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

### Chain methods with static return types

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/types.md

Utilize the fluent interface enabled by static return types to chain configuration methods.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

$collapse = FilamentCollapse::make([
    TextInput::make('a'),
    TextInput::make('b'),
])
->label('Group A')                           // Returns static
->uuid('my_group');                          // Returns static

// Chaining is possible due to static return type
```

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

### Display File Organization Structure

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Visual representation of the project documentation directory structure.

```text
output/
├── INDEX.md                      ← You are here
├── TECHNICAL-REFERENCE.md        ← Overview & quick reference
├── API-REFERENCE.md              ← Complete API docs
├── USAGE-EXAMPLES.md             ← Practical examples
├── INTEGRATION-GUIDE.md          ← Integration & troubleshooting
├── CONFIGURATION.md              ← Config options
├── COMPONENTS-REFERENCE.md       ← Component details
├── ARCHITECTURE.md               ← System design
├── TYPES.md                      ← Type definitions
└── ERRORS.md                     ← Error handling
```

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

### Instance Configuration Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Fluent methods for configuring the behavior and appearance of a FilamentCollapse instance.

```APIDOC
## Instance Configuration Methods

### Methods
- **->uuid(string|Closure $uuid)**: Sets the unique identifier for the component.
- **->label(string|Translatable|Closure $label)**: Sets the label for the collapse component.
- **->disabled(bool|Closure $disabled)**: Sets the disabled state of the component.
- **->visible(bool|Closure $visible)**: Sets the visibility of the component.
- **->extraAttributes(array $attributes)**: Sets additional HTML attributes for the component.
```

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

### Configure child components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Shows that child components retain full configuration capabilities like validation and labels within the collapse container.

```php
FilamentCollapse::make([
    TextInput::make('email')
        ->label('Email')
        ->email()
        ->required()
        ->validationMessages([
            'email' => 'Please provide a valid email.',
        ]),
    TextInput::make('confirm_email')
        ->label('Confirm Email')
        ->email()
        ->required()
        ->same('email'),
])
->label('Email Verification')
```

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

### Component Management Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Methods for managing child components and schema definitions.

```php
public function getChildComponents(): array
public function getChildComponentContainer($key = null): ComponentContainer
public function schema(array|Closure $schema): static
public function getSchema(): array
```

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

### Integrate TextInput components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Demonstrates wrapping standard TextInput components within a FilamentCollapse container.

```php
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('field1'),
    TextInput::make('field2'),
])
```

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

### Configure FilamentCollapse with method chaining

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Use fluent methods to set properties like label, visibility, and attributes on a FilamentCollapse instance.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

FilamentCollapse::make($schema)
    ->label('My Group')
    ->uuid('my_collapse')
    ->visible(auth()->user()->is_admin)
    ->disabled(! $canEdit)
    ->extraAttributes(['class' => 'bg-gray-50']);
```

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

### Implement FilamentCollapse with Placeholder Guidance

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Use this pattern to group related fields while ensuring accessibility, as labels are converted to placeholders when collapsed.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make([
            TextInput::make('unit_number')
                ->label('Apt / Unit #')
                ->placeholder('202'),
            TextInput::make('building_number')
                ->label('Building #')
                ->placeholder('5'),
            TextInput::make('street_number')
                ->label('Street #')
                ->placeholder('123'),
        ])
        ->label('Address Numbers'),
    ]);
}
```

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

### Implement Reactive Components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Integrate with Filament's reactive state system to perform real-time calculations across fields within the collapse component.

```php
use Filamentorms\Get;
use Filamentorms\Set;

FilamentCollapse::make([
    TextInput::make('quantity')
        ->numeric()
        ->reactive()
        ->afterStateUpdated(function (Get $get, Set $set) {
            $qty = $get('quantity');
            $price = $get('price');
            $set('total', $qty * $price);
        }),
    TextInput::make('price')
        ->numeric()
        ->reactive()
        ->afterStateUpdated(function (Get $get, Set $set) {
            $qty = $get('quantity');
            $price = $get('price');
            $set('total', $qty * $price);
        }),
    TextInput::make('total')
        ->disabled()
        ->numeric(),
])
->label('Pricing')
```

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

### Integrate Date and Time components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Demonstrates wrapping DatePicker and TimePicker components within a FilamentCollapse container.

```php
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\TimePicker;

FilamentCollapse::make([
    DatePicker::make('start_date'),
    DatePicker::make('end_date'),
])
```

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

### Test Collapse in Full Form Context

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Ensure the component is correctly integrated within a full form schema during testing.

```php
public function test_form_with_collapse()
{
    $form = $this->resource->form(Form::make());
    
    $this->assertIsNotNull($form);
    // Assert component exists in schema
}
```

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

### Multi-Step Form Implementation

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Organize form fields into collapsible sections for multi-step data entry.

```php
FilamentCollapse::make([
    TextInput::make('step1_field1'),
    TextInput::make('step1_field2'),
])
->label('Step 1: Basic Information'),

FilamentCollapse::make([
    TextInput::make('step2_field1'),
    TextInput::make('step2_field2'),
])
->label('Step 2: Contact Information'),
```

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

### Optimize Child Component Lists

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Keep the number of child components within a collapse reasonable to avoid performance degradation.

```php
// Good
FilamentCollapse::make([
    TextInput::make('field1'),
    TextInput::make('field2'),
    TextInput::make('field3'),
])

// Less optimal
FilamentCollapse::make(array_map(
    fn($i) => TextInput::make("field_$i"),
    range(1, 100)
))
```

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

### Create FilamentCollapse via make() Factory

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Use the static make() method to instantiate and configure the component within a Filament form schema.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

public function form(Form $form)
{
    return $form->schema([
        FilamentCollapse::make([
            TextInput::make('first_name')
                ->label('First Name'),
            TextInput::make('last_name')
                ->label('Last Name'),
        ])
        ->label('Name Fields'),
    ]);
}
```

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

### Import FilamentCollapse Class

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

Include this namespace import at the top of your form resource or component file.

```php
use DrafolinilamentCollapseilamentCollapse;
```

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

### Integrate Checkbox and Toggle components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Demonstrates wrapping Checkbox and Toggle components within a FilamentCollapse container.

```php
use Filament\Forms\Components\Checkbox;
use Filament\Forms\Components\Toggle;

FilamentCollapse::make([
    Checkbox::make('agree_terms'),
    Toggle::make('enable_notifications'),
])
```

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

### FilamentCollapseServiceProvider Configuration

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Reference for the service provider properties and lifecycle methods.

```php
use Drafolin\FilamentCollapse\FilamentCollapseServiceProvider;

// Public properties
::$name = 'filament-collapse'
::$viewNamespace = 'filament-collapse'

// Methods
->configurePackage(Package $package): void
->packageRegistered(): void
->packageBooted(): void
```

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

### Support Multiple Component Types in FilamentCollapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Shows how to include various form components like Select and Textarea alongside TextInput within the collapse wrapper.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Textarea;

FilamentCollapse::make([
    TextInput::make('name'),       // Works - placeholder applied
    TextInput::make('email'),      // Works - placeholder applied
    Select::make('country'),       // Works - label may not convert to placeholder
    Textarea::make('notes'),       // Works but may not collapse optimally
])
->label('Mixed Fields');
```

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

### Define components with FilamentCollapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/types.md

Pass an array of Filament form components to the make method to initialize the collapse component.

```php
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Select;
use Drafolin\FilamentCollapse\FilamentCollapse;

$collapse = FilamentCollapse::make([
    TextInput::make('name'),    // Component
    Select::make('status'),     // Component
]);
```

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

### Use dynamic closures for schema and UUID

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/types.md

Provide closures to make or uuid methods to evaluate values at runtime.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

FilamentCollapse::make(function () {
    return [
        TextInput::make('field1'),
        TextInput::make('field2'),
    ];
})->label('Dynamic Fields');
```

```php
FilamentCollapse::make([
    TextInput::make('name'),
])
->uuid(function () {
    return 'collapse_' . auth()->id();
});
```

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

### Data Retrieval Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Methods to access the current state and configuration values of the component.

```php
public function getUuid(): string
public function getLabel(): ?string
public function getId(): ?string
public function isDisabled(): bool
public function isVisible(): bool
```

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

### Register Service Provider in composer.json

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Add the service provider to the extra section of your composer.json file to enable automatic registration.

```json
// In composer.json "extra" section:
"laravel": {
    "providers": [
        "Drafolin\\FilamentCollapse\\FilamentCollapseServiceProvider"
    ]
}
```

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

### Implement Basic Filament Collapse Component

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/README.md

Use the FilamentCollapse class to group form components and reduce vertical spacing. Ensure the necessary classes are imported from the package and Filament Forms.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('first_name')->label('First Name'),
    TextInput::make('last_name')->label('Last Name'),
])
->label('Full Name')
```

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

### Troubleshoot Label Alignment

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Ensure scripts are stacked or manually trigger field updates if labels fail to align.

```php
// Ensure Alpine.js is loaded
@stack('scripts')

// Or manually trigger recalculation in console
window.updateFields?.()
```

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

### Optimize Component Types

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Maintain consistency in component types within a single collapse to ensure clean visual behavior.

```php
// Less optimal
FilamentCollapse::make([
    TextInput::make('name'),
    Select::make('type'),
    Textarea::make('description'),
])

// Better: Keep to similar component types
FilamentCollapse::make([
    TextInput::make('first_name'),
    TextInput::make('last_name'),
])
```

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

### Alpine.js Observer Optimization Note

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

The component uses a MutationObserver for width recalculation; note that current implementation always observes.

```php
// If you know the collapse won't change:
// (Current implementation always observes)
// Consider filing an issue if optimization needed
```

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

### Define Descriptive Labels

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Labels provided to components within the collapse are automatically converted into placeholders.

```php
TextInput::make('area_code')
    ->label('Area Code (3 digits)')  // Descriptive label becomes placeholder
```

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

### Configuration Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Methods used to configure the properties of the FilamentCollapse component.

```APIDOC
## Configuration Methods

### Methods
- **uuid(string|Closure $uuid): static** - Sets the UUID for the component.
- **label(string|Translatable|Closure $label): static** - Sets the label for the component.
- **disabled(bool|Closure $disabled): static** - Sets the disabled state.
- **visible(bool|Closure $visible): static** - Sets the visibility state.
- **extraAttributes(array $attributes, bool $merge = false): static** - Sets extra HTML attributes.
- **helperText(string|Translatable|Closure $helperText): static** - Sets the helper text.
- **hint(string|Translatable|Closure $hint): static** - Sets the hint text.
- **hintIcon(string $icon): static** - Sets the hint icon.
- **hintIconTooltip(string|Translatable|Closure $tooltip): static** - Sets the hint icon tooltip.
- **description(string|Translatable|Closure $description): static** - Sets the component description.
```

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

### Manage data binding in collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Shows that the collapse component is a layout wrapper and does not interfere with individual child component data storage.

```php
// All data is stored by individual components
FilamentCollapse::make([
    TextInput::make('first_name'),  // Stores: 'first_name' key
    TextInput::make('last_name'),   // Stores: 'last_name' key
])

// Retrieved via normal form submission:
$data = $form->getState();
// Result: ['first_name' => 'John', 'last_name' => 'Doe']
```

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

### Instantiate FilamentCollapse via Constructor

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Create a new instance of FilamentCollapse by passing an array of form components directly to the constructor.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

$collapse = new FilamentCollapse([
    TextInput::make('first_name')->label('First Name'),
    TextInput::make('last_name')->label('Last Name'),
]);
```

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

### FilamentCollapse::make

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Factory method to create and configure a new FilamentCollapse instance.

```APIDOC
## static make(array|Closure $schema)

### Description
Factory method for creating and configuring a new FilamentCollapse instance. This is the primary way to instantiate the component in form schemas.

### Parameters
- **schema** (array<Component>|Closure) - Required - An array of child components or a closure that returns an array.

### Returns
- static - A new instance of FilamentCollapse.
```

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

### Configure TextInput Fields in FilamentCollapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Demonstrates grouping multiple TextInput fields within a single collapse component with custom labels and placeholders.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('phone_country')
        ->label('Country Code')
        ->placeholder('US')
        ->maxLength(3)
        ->prefix('+'),
    TextInput::make('phone_area')
        ->label('Area Code')
        ->placeholder('555')
        ->maxLength(3),
    TextInput::make('phone_number')
        ->label('Number')
        ->placeholder('1234')
        ->maxLength(4),
])
->label('Phone Number');
```

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

### FilamentCollapse::make

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Creates a new instance of the FilamentCollapse component with the provided schema.

```APIDOC
## FilamentCollapse::make

### Description
Creates a new instance of the FilamentCollapse component.

### Signature
`public static function make(array|Closure $schema): static`

### Parameters
- **$schema** (array|Closure) - Required - The form components to be contained within the collapse element.
```

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

### Create a simple two-field collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Groups two text inputs under a single collapsible label. Labels for the internal fields are automatically converted to placeholders.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make([
            TextInput::make('first_name')
                ->label('First Name')
                ->required(),
            TextInput::make('last_name')
                ->label('Last Name')
                ->required(),
        ])
        ->label('Full Name'),
    ]);
}
```

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

### FilamentCollapse::make

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Creates a new instance of the FilamentCollapse component.

```APIDOC
## public static function make(array|Closure $schema): static

### Description
Creates a new FilamentCollapse instance with the given schema.

### Parameters
- **$schema** (array|Closure) - Required - The schema definition for the collapse component.
```

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

### Assign CSS classes to child components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Demonstrates how child components automatically receive specific CSS classes based on their position within the collapse group.

```php
FilamentCollapse::make([
    TextInput::make('field1'),   // Gets: filament-collapse__collapse-item-first
    TextInput::make('field2'),   // Gets: filament-collapse__collapse-item
    TextInput::make('field3'),   // Gets: filament-collapse__collapse-item-last
])
```

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

### Show/Hide Collapse Based on User Permission

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Use the visible method to restrict the visibility of the collapse component to specific users, such as administrators.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make([
            TextInput::make('username')
                ->label('Username')
                ->required(),
            TextInput::make('password')
                ->label('Password')
                ->password()
                ->required()
                ->confirmed(),
            TextInput::make('password_confirmation')
                ->label('Confirm Password')
                ->password()
                ->required(),
        ])
        ->label('Account Credentials')
        ->visible(auth()->user()->is_admin),
    ]);
}
```

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

### Test FilamentCollapse Components

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Verify component rendering and UUID validation logic using standard Filament test cases.

```php
use Filament\Tests\TestCase;

class FilamentCollapseTest extends TestCase
{
    public function test_collapse_renders()
    {
        $component = FilamentCollapse::make([
            TextInput::make('field1'),
        ]);

        $this->assertNotNull($component->getUuid());
    }

    public function test_uuid_validation()
    {
        $this->expectException(InvalidArgumentException::class);
        
        FilamentCollapse::make([])
            ->uuid('123invalid');
    }
}
```

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

### Generate Dynamic Schemas with Closures

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Use a closure within the component to return different form fields based on user authentication or other runtime conditions.

```php
FilamentCollapse::make(function () {
    if (auth()->user()->is_admin) {
        return [
            TextInput::make('admin_notes'),
            Select::make('status'),
        ];
    }

    return [
        TextInput::make('name'),
    ];
})
```

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

### FilamentCollapse::__construct

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Initializes a new instance of the FilamentCollapse component with a schema of child components.

```APIDOC
## __construct(array|Closure $schema)

### Description
Creates a new FilamentCollapse instance. This component wraps multiple related fields into a grouped container.

### Parameters
- **schema** (array<Component>|Closure) - Required - An array of child Filament form components or a closure that returns an array of components.

### Returns
- void
```

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

### Handling UUID Validation Errors

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Shows how to validate user-provided UUIDs or catch exceptions to provide a fallback mechanism.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use InvalidArgumentException;

try {
    $customUuid = $userInput;  // From user input or config
    
    // Validate before passing
    if (preg_match('/^\d/', $customUuid)) {
        $customUuid = 'collapse_' . $customUuid;
    }
    
    FilamentCollapse::make($schema)
        ->uuid($customUuid);
        
} catch (InvalidArgumentException $e) {
    // Fallback: let the default UUID be used
    FilamentCollapse::make($schema);
}
```

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

### FilamentCollapseServiceProvider Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Lifecycle methods for the package service provider.

```APIDOC
## configurePackage(Package $package)

### Description
Configures the package using Spatie's Laravel Package Tools. Sets the package name and registers the views directory.

## packageRegistered()

### Description
Called during the package registration phase.

## packageBooted()

### Description
Called after the application is fully booted. Registers the compiled CSS asset with Filament's asset manager.
```

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

### Load Filament Styles

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Ensure Filament styles are correctly included in your layout to prevent rendering issues.

```blade
@filamentStyles
<!-- Or if using a custom Filament setup -->
<link rel="stylesheet" href="...filament-collapse.css">
```

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

### Customizing the Blade View Template

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

The base structure for the component, including the critical Alpine.js initialization logic in the x-init directive.

```blade
<div x-data x-init="...">
    <!-- Alpine.js initialization code that:
         1. Finds all label elements
         2. Calculates maximum label width
         3. Centers labels in aligned width
         4. Updates on DOM mutations
    -->
    <x-filament::input.wrapper :data="$uuid" class="filament-collapse__wrapper">
        {{$getChildComponentContainer()}}
    </x-filament::input.wrapper>
</div>
```

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

### HTML Output Structure

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

The component renders a nested structure using Alpine.js for interactivity and specific CSS classes for styling child components.

```html
<div class="fi-fo-field-wrp">
    <div x-data x-init="...">
        <div class="filament-collapse__wrapper">
            <div class="fi-input-wrp" data="collapse__<uuid>">
                <!-- Child components rendered here -->
                <div class="fi-input-wrp filament-collapse__collapse-item filament-collapse__collapse-item-first">
                    <!-- First child component -->
                </div>
                <div class="fi-input-wrp filament-collapse__collapse-item">
                    <!-- Middle child components -->
                </div>
                <div class="fi-input-wrp filament-collapse__collapse-item filament-collapse__collapse-item-last">
                    <!-- Last child component -->
                </div>
            </div>
        </div>
    </div>
</div>
```

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

### Retrieve Child Component Container

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Access the component container for child components, which applies necessary styling and placeholder transformations.

```php
$collapse = FilamentCollapse::make([
    TextInput::make('start_date')->label('Start'),
    TextInput::make('end_date')->label('End'),
]);

// Internal usage - typically called during form rendering
$container = $collapse->getChildComponentContainer();
```

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

### Dynamic Collapse Schema with Closure

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Pass a closure to FilamentCollapse::make to dynamically define child components based on application state or user attributes.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        FilamentCollapse::make(function () {
            if (auth()->user()->is_business) {
                return [
                    TextInput::make('business_name')
                        ->label('Business Name')
                        ->required(),
                    TextInput::make('tax_id')
                        ->label('Tax ID')
                        ->required(),
                ];
            }
            
            return [
                TextInput::make('first_name')
                    ->label('First Name')
                    ->required(),
                TextInput::make('last_name')
                    ->label('Last Name')
                    ->required(),
            ];
        })
        ->label('Name Information'),
    ]);
}
```

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

### FilamentCollapse Main Class API

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/INDEX.md

Reference for the primary FilamentCollapse class methods, including factory creation, instance configuration, and data retrieval.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

// Factory method (preferred)
FilamentCollapse::make(array|Closure $schema): static

// Instance methods
->uuid(string|Closure $uuid): static
->label(string|Translatable|Closure $label): static
->disabled(bool|Closure $disabled): static
->visible(bool|Closure $visible): static
->extraAttributes(array $attributes): static

// Data retrieval
->getUuid(): string
->getLabel(): ?string
->getChildComponents(): array
->getChildComponentContainer(?key = null): ComponentContainer
```

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

### FilamentCollapse::make

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

The primary method to initialize a FilamentCollapse component with a set of child components.

```APIDOC
## FilamentCollapse::make

### Description
Initializes a new collapse container containing an array of child components.

### Parameters
- **components** (array) - Required - The list of Filament components to be wrapped within the collapse.

### Methods
- **disabled(bool|Closure $condition)**: Sets the disabled state for all child components within the collapse.
- **visible(bool|Closure $condition)**: Controls the visibility of the entire collapse container and its children.
```

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

### Handle events within the collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Child components support standard Filament reactive features and state updates.

```php
use Filamentorms\Get;
use Filamentorms\Set;

FilamentCollapse::make([
    TextInput::make('quantity')
        ->reactive()
        ->afterStateUpdated(function (Get $get, Set $set) {
            // Update based on other field changes
        }),
])
```

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

### Protected Extension Methods

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

Internal methods intended for overriding or extending component functionality.

```php
protected function evaluate(mixed $value, array $arguments = []): mixed
protected function getStateUsing(Closure $callback): static
protected function getDefaultName(): ?string
```

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

### Group Logically Related Fields

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Organize fields by logical relationship to ensure the collapse component remains intuitive for users.

```php
// Good: Related fields
FilamentCollapse::make([
    TextInput::make('street'),
    TextInput::make('city'),
    TextInput::make('zip'),
])

// Less effective: Unrelated fields
FilamentCollapse::make([
    TextInput::make('username'),
    TextInput::make('company_tax_id'),
])
```

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

### Implement Multi-field Address Collapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Collapses secondary address fields like city, state, and zip code while keeping the street address visible.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Select;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        TextInput::make('street_address')
            ->label('Street Address')
            ->required(),
        
        FilamentCollapse::make([
            TextInput::make('city')
                ->label('City')
                ->required(),
            Select::make('state')
                ->label('State')
                ->options([
                    'CA' => 'California',
                    'NY' => 'New York',
                    'TX' => 'Texas',
                ])
                ->required(),
            TextInput::make('zip_code')
                ->label('ZIP Code')
                ->maxLength(5)
                ->required(),
        ])
        ->label('City, State, ZIP'),
    ]);
}
```

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

### Apply Custom Validation Rules

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/integration-guide.md

Define standard Filament validation rules and custom messages for child components inside the collapse container.

```php
FilamentCollapse::make([
    TextInput::make('password')
        ->password()
        ->required()
        ->minLength(8)
        ->validationMessages([
            'min_length' => 'Password must be at least 8 characters.',
        ])
        ->rules([
            'required',
            'min:8',
            'regex:/[A-Z]/',  // Must contain uppercase
        ]),
    TextInput::make('password_confirmation')
        ->password()
        ->required()
        ->same('password'),
])
```

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

### View Resolution Paths

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/components-reference.md

The component uses a specific Blade view path which can be customized after publishing assets.

```text
filament-collapse::filament-collapse
```

```text
resources/views/vendor/filament-collapse/filament-collapse.blade.php
```

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

### Drafolin\FilamentCollapse\FilamentCollapse::make

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

The factory method used to instantiate a new FilamentCollapse component with a provided schema.

```APIDOC
## Drafolin\FilamentCollapse\FilamentCollapse::make

### Description
Creates a new instance of the FilamentCollapse component.

### Signature
`make(array|Closure $schema): static`

### Parameters
- **$schema** (array|Closure) - Required - The child components schema to be contained within the collapse.
```

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

### Identifying Published View Path

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

The path where the view template is located after publishing.

```text
resources/views/vendor/filament-collapse/filament-collapse.blade.php
```

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

### Organizing Multiple Collapses in a Section

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/usage-examples.md

Group multiple FilamentCollapse components within a single Section for structured form layouts.

```php
use Filament\Forms\Form;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Section;
use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form): Form
{
    return $form->schema([
        Section::make('User Profile')->schema([
            FilamentCollapse::make([
                TextInput::make('first_name')
                    ->label('First Name')
                    ->required(),
                TextInput::make('last_name')
                    ->label('Last Name')
                    ->required(),
            ])
            ->label('Name'),
            
            FilamentCollapse::make([
                TextInput::make('email')
                    ->label('Email')
                    ->email()
                    ->required(),
                TextInput::make('email_secondary')
                    ->label('Secondary Email')
                    ->email(),
            ])
            ->label('Email Addresses'),
            
            FilamentCollapse::make([
                TextInput::make('phone_country')
                    ->label('Country')
                    ->maxLength(3),
                TextInput::make('phone_number')
                    ->label('Number')
                    ->tel(),
            ])
            ->label('Phone'),
        ]),
    ]);
}
```

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

### Catching Filament Component Exceptions

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Handle exceptions propagated during the creation of child component containers within a try-catch block.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

try {
    $collapse = FilamentCollapse::make([
        TextInput::make('field'),
    ]);
    
    // Container creation happens during form rendering
    // Exceptions from child components are propagated
    $container = $collapse->getChildComponentContainer();
    
} catch (\Exception $e) {
    // Log or handle form rendering errors
}
```

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

### Rebuild Assets After CSS Overrides

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/configuration.md

Use these commands to rebuild your assets after modifying the CSS files in a Tailwind CSS project.

```bash
# If using npm/yarn
npm run build

# Or compile specific CSS
npm run build -- resources/css/index.css
```

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

### Extend Alpine.js behavior

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/architecture.md

Modify the x-init directive within the Blade template to inject custom JavaScript logic.

```blade
<div x-data="collapseComponent()" x-init="init()">
```

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

### Access FilamentCollapse in Forms

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/api-reference.md

Demonstrates usage within a Filament form schema, where CSS assets are automatically loaded.

```php
// The CSS is automatically loaded when FilamentCollapse is used in a form
// No additional configuration is required

use Drafolin\FilamentCollapse\FilamentCollapse;

public function form(Form $form)
{
    return $form->schema([
        FilamentCollapse::make([
            // CSS is automatically included
        ]),
    ]);
}
```

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

### Generating Safe Default UUIDs

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Use auto-generated UUIDs or explicitly generated strings to ensure component uniqueness.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;

// Always safe - uses auto-generated UUID
$collapse = FilamentCollapse::make([
    TextInput::make('field1'),
    TextInput::make('field2'),
]);

// Safe - explicitly generated
$collapse = FilamentCollapse::make([
    TextInput::make('field1'),
    TextInput::make('field2'),
])->uuid('collapse_' . uniqid());
```

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

### Handling Child Component Errors in FilamentCollapse

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/errors.md

Demonstrates defining child components with validation rules within a FilamentCollapse container.

```php
use Drafolin\FilamentCollapse\FilamentCollapse;
use Filament\Forms\Components\TextInput;

FilamentCollapse::make([
    TextInput::make('email')
        ->email()  // Adds email validation to the field
        ->required(),  // Adds required validation to the field
    TextInput::make('phone')
        ->tel(),  // Adds phone validation to the field
])
->label('Contact Information');

// Validation errors are handled by Filament's form system
// Not thrown as exceptions but returned in form validation responses
```

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

### Display Class Hierarchy

Source: https://github.com/drafolin/filament-collapse/blob/main/_autodocs/TECHNICAL-REFERENCE.md

Inheritance structure for the FilamentCollapse component.

```text
Filament\Forms\Components\Component
    └── Drafolin\FilamentCollapse\FilamentCollapse
            └── Uses: Filament\Forms\Components\Concerns\HasChildComponents
```
Tokens:
Raw