Mason

https://github.com/awcodes/mason
Admin
Mason is a simple block-based drag and drop page/document builder field designed for Filament...
Tokens:36,361
Snippets:544
Trust Score:9.6
License:MIT
Update:3 months ago
Show doc for...
Tokens:
Raw
### Example Section Configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

An example array structure for configuring the Section brick.

```php
$config = [
    'background_color' => 'primary',
    'text' => '<h2>Welcome</h2><p>This is a section...</p>',
    'image' => 'uploads/hero-image.jpg',
    'image_position' => 'end',
    'image_alignment' => 'middle',
    'image_rounded' => true,
    'image_shadow' => true,
];
```

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

### Mason Usage Example

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/MANIFEST.md

Practical usage example for the Mason component.

```php
Mason::make('content')
    ->bricks([Section::class])
```

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

### Complete Mason Brick Block Example

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Provides a fully populated example of a Mason brick block with specific configuration values.

```php
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => [
            'background_color' => 'white',
            'text' => '<h2>Welcome</h2><p>This is a section.</p>',
            'image' => 'uploads/image.jpg',
            'image_position' => 'end',
            'image_alignment' => 'middle',
            'image_rounded' => true,
            'image_shadow' => false,
        ],
        'label' => 'Section',
        'preview' => 'PGRpdiBjbGFzcz0ic2VjdGlvbiI+Li4u',
    ],
]
```

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

### Mason helper usage examples

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Demonstrates the shorthand mason helper compared to the explicit MasonRenderer builder pattern.

```php
$html = mason($post->content, [Section::class])->toHtml();
```

```php
$html = MasonRenderer::make($post->content)
	->bricks([Section::class])
	->toHtml();
```

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

### Get Preview Layout

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/01-mason-field.md

Retrieve the currently configured preview layout path.

```php
public function getPreviewLayout(): ?string
```

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

### Install Mason via Composer

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/00-api-overview.md

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

```bash
composer require awcodes/mason
```

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

### Mason brick generation examples

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Various ways to invoke the make:mason-brick command for different naming and overwrite scenarios.

```bash
php artisan make:mason-brick Hero
```

```bash
php artisan make:mason-brick "Components/Card"
```

```bash
php artisan make:mason-brick "Admin\PageSection"
```

```bash
php artisan make:mason-brick Hero --force
```

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

### Method Signature Example

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/MANIFEST.md

Standard PHP method signature format used throughout the documentation.

```php
public function methodName(type $param1, ?string $param2 = null): ReturnType
```

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

### Test rendering with Faker

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Example of using Faker within a test suite to verify brick configuration.

```php
use Awcodes	est('rendering section content', function () {
    $content = Faker::make()
        ->brick('section', [
            'text' => '<h2>Test</h2>',
            'background_color' => 'white',
        ])
        ->asJson();

    expect($content)->toHaveCount(1);
    expect($content[0]['attrs']['id'])->toBe('section');
});
```

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

### Configure image position toggle buttons

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Creates grouped toggle buttons to set the image position to start or end.

```php
ToggleButtons::make('image_position')
    ->options([
        'start' => 'Start',
        'end' => 'End',
    ])
    ->grouped()
```

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

### Block Attribute Lifecycle Stages

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Examples of how block attributes change during creation, dehydration, storage, hydration, and UI display.

```php
// Creation (Editor Creates Block)
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Hello'],
        'label' => 'Section',          // Added by editor
        'preview' => 'base64...',      // Added by editor
    ],
]
```

```php
// Before Saving (Dehydration)
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Hello'],
        // label and preview removed
    ],
]
```

```json
[{"type":"masonBrick","attrs":{"id":"section","config":{"text":"Hello"}}}]
```

```php
// After Loading (Hydration)
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Hello'],
    ],
]
```

```php
// In Editor UI
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Hello'],
        'label' => 'Section',          // Re-generated for display
        'preview' => 'base64...',      // Re-generated for preview
    ],
]
```

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

### Mason 0.x Database Schema

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Example of the JSON structure for storing Mason bricks in the database in version 0.x.

```json
{
    "type":"masonBrick",
    "attrs":{
        "identifier": "newsletter_signup",
        "path": "mason.newsletter-signup",
        "values": {
            "background_color":"primary",
            "heading":"Want product news and updates? Sign up for our newsletter."
        }
    }
}
```

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

### Initialize MasonRenderer with make()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Create a new instance using the static factory method and chain additional configuration like brick definitions.

```php
$renderer = MasonRenderer::make($storedJsonContent)
    ->bricks([Section::class, CustomBrick::class]);
```

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

### BrickCommand make() Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/04-brick-command.md

Creates a generic command with a specified name and arguments.

```php
public static function make(string $name, array $arguments = []): static
```

```php
BrickCommand::make('insertBrick', [
    'brick' => $brickData,
    'position' => 0,
])
```

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

### Get Registered Bricks

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/07-iframe-renderers.md

Retrieves the currently registered bricks.

```php
public function getBricks(): array
```

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

### Database Backup Commands

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Recommended commands for backing up the database before running the migration.

```bash
# MySQL
mysqldump -u user -p database > backup.sql

# PostgreSQL
pg_dump database > backup.sql

# Or using Laravel
php artisan backup:run --only-db
```

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

### Get sidebar actions

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Retrieves the registered sidebar action instances.

```php
public function getSidebarActions(): array
```

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

### Get flat bricks list

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Retrieves all bricks unwrapped from their groups.

```php
public function getFlatBricks(): array
```

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

### Get Section ID

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Retrieves the unique identifier for the Section brick.

```php
public static function getId(): string
```

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

### Configure Static Bricks

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Create bricks without forms by returning a view and hiding the configuration modal.

```php
public static function toHtml(array $config, ?array $data = null): ?string
{
    return view('mason.static-brick');
}

public static function configureBrickAction(Action $action): Action
{
    return $action->modalHidden();
}
```

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

### Retrieve blocks

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/07-iframe-renderers.md

Get the current array of blocks assigned to the renderer.

```php
public function getBlocks(): array
```

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

### Get sidebar position

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Retrieves the current sidebar position enum value.

```php
public function getSidebarPosition(): SidebarPosition
```

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

### Create a BrickGroup instance

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/05-brick-group.md

Initializes a new group with a label and assigns specific brick classes to it.

```php
BrickGroup::make('Content Blocks')
    ->bricks([
        Section::class,
        TextBlock::class,
    ])
```

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

### Get single brick class

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Retrieves a specific brick class by its ID.

```php
public function getBrick(string $id): ?string
```

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

### Create a Custom Brick

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/00-api-overview.md

Scaffold, implement, and register a new custom brick.

```bash
php artisan make:mason-brick Hero
```

```php
public static function getId(): string { return 'hero'; }
public static function toHtml(array $config, ?array $data = null): ?string
public static function configureBrickAction(Action $action): Action
```

```php
Mason::make('content')->bricks([Hero::class])
```

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

### Get Default Color Mode

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/01-mason-field.md

Retrieve the default color mode setting.

```php
public function getDefaultColorMode(): string
```

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

### Configure MasonEntry Component

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/INDEX.md

Initializes a read-only MasonEntry component with specified bricks and a custom preview layout.

```php
MasonEntry::make('content')
    ->bricks([Section::class])
    ->previewLayout('layouts.mason-entry')
```

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

### MasonEntry::make

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/README.md

Creates a Mason infolist entry for displaying content blocks.

```APIDOC
## MasonEntry::make

### Description
Initializes a Mason infolist entry to display content blocks.

### Methods
- `make(string $name)`: Creates the entry instance.
- `bricks(array $bricks)`: Defines allowed brick classes.
```

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

### Get Section Icon

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Retrieves the SVG icon associated with the Section brick.

```php
public static function getIcon(): string|Heroicon|Htmlable|null
```

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

### Set sidebar position

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Configures the position of the sidebar as either start or end.

```php
public function sidebarPosition(SidebarPosition|Closure|null $position = null): static
```

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

### Configure MasonEntry Preview Layout

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Set a custom preview layout for the MasonEntry component.

```php
MasonEntry::make('content')
    ->previewLayout('layouts.mason-entry')
    ->bricks([...])
```

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

### Get cached bricks mapping

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Retrieves a mapping of brick IDs to their respective classes.

```php
public function getCachedBricks(): array
```

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

### Implement environment-specific configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Use the env() helper to dynamically adjust layouts and middleware based on the application environment.

```php
// config/mason.php

return [
    'generator' => [
        'namespace' => 'App\\Mason',
        'views_path' => 'mason',
    ],
    'preview' => [
        // Use custom layout in production
        'layout' => env('APP_ENV') === 'production'
            ? 'layouts.mason-preview-prod'
            : 'mason::iframe-preview',
    ],
    'entry' => [
        'layout' => env('APP_ENV') === 'production'
            ? 'layouts.mason-entry-prod'
            : 'mason::iframe-entry',
    ],
    'routes' => [
        'middleware' => explode(',', env('MASON_MIDDLEWARE', 'web,auth')),
    ],
];
```

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

### Mason::make()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/INDEX.md

Initializes the Mason form field and configures its behavior, including available bricks, preview layouts, and interaction settings.

```APIDOC
## Mason::make()

### Description
Initializes the Mason form field component for use in Filament forms.

### Method
Static Factory Method

### Parameters
- **name** (string) - Required - The name of the form field.

### Configuration Methods
- **bricks(array $bricks)** - Optional - Registers available brick types.
- **sortBricks()** - Optional - Enables sorting of bricks by label.
- **doubleClickToEdit()** - Optional - Enables the double-click-to-edit functionality.
- **previewLayout(string $layout)** - Optional - Sets a custom preview layout.
- **defaultColorMode(string $mode)** - Optional - Sets the default color mode.
- **colorModeToggle()** - Optional - Enables the color mode toggle.

### Usage Example
```php
Mason::make('content')
    ->bricks([Section::class])
    ->previewLayout('layouts.mason')
    ->doubleClickToEdit()
```
```

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

### Implement configureBrickAction()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/02-brick-base-class.md

Configures the Filament action and form schema for editing the brick.

```php
public static function configureBrickAction(Action $action): Action
```

```php
public static function configureBrickAction(Action $action): Action
{
    return $action
        ->slideOver()
        ->schema([
            TextInput::make('text')
                ->required(),
            Select::make('size')
                ->options([
                    'sm' => 'Small',
                    'md' => 'Medium',
                    'lg' => 'Large',
                ]),
        ]);
}
```

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

### Get content as JSON

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

The asJson method returns the built content as an array suitable for JSON serialization.

```php
$json = Faker::make()
    ->brick('section', ['text' => 'Test'])
    ->asJson();
// Returns: [['type' => 'masonBrick', 'attrs' => [...]]]
```

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

### Implement getTags()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/02-brick-base-class.md

Returns an array of keywords to improve brick discoverability in the selector.

```php
public static function getTags(): array
```

```php
public static function getTags(): array
{
    return ['text', 'layout', 'content'];
}
```

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

### Get processed blocks with toArray()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Use toArray() to retrieve the processed blocks as an array without rendering.

```php
public function toArray(): array
```

```php
$blocks = MasonRenderer::make($content)
    ->toArray();
```

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

### Generate Mason Bricks via Artisan

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/INDEX.md

Scaffold new brick classes and Blade templates using the make:mason-brick command.

```bash
php artisan make:mason-brick Hero
php artisan make:mason-brick "Components/Card"
php artisan make:mason-brick Hero --force
```

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

### Mason 0.x Component Definition

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Shows how to define Bricks for the Mason component in version 0.x using `Brick::make()` instances.

```php
Mason::make('content')
    ->bricks([
        Section::make(),
    ])
```

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

### Initialize MasonEntry

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/06-mason-entry.md

Create a new MasonEntry instance within a Filament infolist schema.

```php
use Awcodes\Mason\MasonEntry;

MasonEntry::make('content')
    ->bricks([
        Section::class,
        CustomBrick::class,
    ])
```

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

### Parameter Documentation Table

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/MANIFEST.md

Standard format for documenting method parameters.

```markdown
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| ... detailed for every param |
```

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

### Mason 1.x Database Schema

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Example of the updated JSON structure for storing Mason bricks in the database in version 1.x.

```json
{
    "type": "masonBrick",
    "attrs": {
        "id": "newsletter_signup",
        "config": {
            "background_color": "primary",
            "heading": "Want product news and updates? Sign up for our newsletter."
        }
    }
}
```

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

### Create fake content with Faker

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Use the make method to initialize a new Faker instance and chain brick methods to build content.

```php
$content = Faker::make()
    ->brick('section', ['text' => 'Hello'])
    ->brick('hero', ['title' => 'Welcome'])
    ->asJson();
```

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

### Mason 0.x Brick Creation

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Illustrates the fluent API approach used in Mason 0.x for creating custom Bricks by extending Filament's action class.

```php
use Awcodes\Mason\Brick;
use Awcodes\Mason\EditorCommand;
use Awcodes\Mason\Mason;

Brick::make('section')
    ->label('Section')
    ->form([
        // ...
    ])
    ->action(function (array $arguments, array $data, Mason $component) {
        $component->runCommands(
            [
                new EditorCommand(
                    name: 'setBrick',
                    arguments: [[
                        'identifier' => 'section',
                        'values' => $data,
                        'path' => 'mason::bricks.section',
                        'view' => view('mason::bricks.section', $data)->toHtml(),
                    ]],
                ),
            ],
            editorSelection: $arguments['editorSelection'],
        );
    });
```

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

### Mason Schema Format Comparison

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Shows the structural differences between the old 0.x brick format and the new 1.x format.

```php
[
    'type' => 'masonBrick',
    'attrs' => [
        'identifier' => 'section',  // Old key name
        'values' => [...],          // Old configuration key
        'path' => 'admin.bricks.section',  // Removed in 1.x
    ],
]
```

```php
[
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',          // New key name
        'config' => [...],          // New configuration key
    ],
]
```

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

### Form Field Validation

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Example of applying validation rules to form fields since the Section brick does not provide built-in validation.

```php
Radio::make('background_color')
    ->required()
    ->options([...]),

RichEditor::make('text')
    ->minLength(10)
    ->required(),
```

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

### Rendering Mason Content

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Demonstrates how to use the MasonRenderer to output the section brick content as HTML.

```php
use Awcodes\Mason\Support\MasonRenderer;

$html = MasonRenderer::make($page->content)
    ->bricks([Section::class])
    ->toHtml();
```

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

### Storing Section Brick Content

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Example structure for storing section brick data within a model's content attribute.

```php
$page->content = [
    [
        'type' => 'masonBrick',
        'attrs' => [
            'id' => 'section',
            'config' => [
                'background_color' => 'white',
                'text' => '<h2>Our Story</h2><p>We started...</p>',
                'image' => 'uploads/team.jpg',
                'image_position' => 'end',
                'image_alignment' => 'middle',
                'image_rounded' => true,
                'image_shadow' => false,
            ],
        ],
    ],
];

$page->save();
```

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

### Run project tests

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Executes the test suite using Composer.

```bash
composer test
```

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

### POST /mason/entry

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Renders blocks for the infolist entry iframe.

```APIDOC
## POST /mason/entry

### Description
Render blocks for the infolist entry iframe.

### Method
POST

### Endpoint
/mason/entry

### Parameters
#### Request Body
- **blocks** (JSON/array) - Required - JSON or array of brick blocks
- **bricks** (JSON/array) - Required - JSON or array of brick class names
- **layout** (string) - Optional - Custom layout view path

### Response
#### Success Response (200)
- **Response** (HTML) - HTML response
```

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

### MasonRenderer::make

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Initializes the MasonRenderer with content. The content can be a JSON string, an array, or a wrapped array containing a 'content' key.

```APIDOC
## MasonRenderer::make(mixed $content)

### Description
Creates a new instance of the MasonRenderer. It accepts raw JSON strings or arrays. If the input is an array containing a 'content' key, the renderer will automatically unwrap it.

### Parameters
- **$content** (mixed) - Required - The Mason content to be rendered.
```

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

### Render basic Mason content

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Initialize the renderer with decoded JSON content and register the necessary brick classes.

```php
use Awcodes\\\Mason\\\Support\\\MasonRenderer;
use App\\\Mason\\\Section;

$content = json_decode($post->content, true);
$html = MasonRenderer::make($content)
    ->bricks([Section::class])
    ->toHtml();
```

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

### Execute Commands in Mason Field

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/04-brick-command.md

Demonstrates how to define a sequence of BrickCommand operations and apply them to a Mason component.

```php
use Awcodes\Mason\Support\BrickCommand;

$component = $form->getComponent('content');

$commands = [
    BrickCommand::insertBrick($newBrick, 0),
    BrickCommand::moveBrick(1, 2),
    BrickCommand::deleteBrick(3),
];

$newState = $component->executeCommands($commands);
```

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

### Run Mason Upgrade Command

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Executes the upgrade command with optional table and column arguments.

```bash
php artisan mason:upgrade-bricks {--table=} {--column=}
```

```bash
php artisan mason:upgrade-bricks --table=posts --column=content
```

```bash
php artisan mason:upgrade-bricks
```

```bash
php artisan mason:upgrade-bricks --table=pages --column=body
php artisan mason:upgrade-bricks --table=products --column=description
```

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

### Render multiple bricks and output formats

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Register multiple brick classes and generate both HTML and plain text output.

```php
$renderer = MasonRenderer::make($pageData)
    ->bricks([
        Section::class,
        Hero::class,
        CallToAction::class,
    ]);

$html = $renderer->toHtml();
$text = $renderer->toText();
```

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

### POST /mason/preview

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Renders blocks for the editor preview iframe.

```APIDOC
## POST /mason/preview

### Description
Render blocks for the editor preview iframe.

### Method
POST

### Endpoint
/mason/preview

### Parameters
#### Request Body
- **blocks** (JSON/array) - Required - JSON or array of brick blocks
- **bricks** (JSON/array) - Required - JSON or array of brick class names
- **layout** (string) - Optional - Custom layout view path

### Response
#### Success Response (200)
- **Response** (HTML) - HTML response
```

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

### Mason 1.x Component Definition

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Illustrates the updated way to define Bricks for the Mason component in version 1.x, using class strings.

```php
Mason::make('content')
    ->bricks([
        Section::class,
    ])
```

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

### Define complete Mason configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Standard configuration structure for namespace, views, layouts, and middleware.

```php
<?php

declare(strict_types=1);

return [
    'generator' => [
        'namespace' => 'App\\Mason',
        'views_path' => 'mason',
    ],
    'preview' => [
        'layout' => 'mason::iframe-preview',
    ],
    'entry' => [
        'layout' => 'mason::iframe-entry',
    ],
    'routes' => [
        'middleware' => ['web', 'auth'],
    ],
];
```

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

### Publish Mason assets

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Commands to publish configuration, stubs, views, and translations.

```bash
php artisan vendor:publish --tag="mason-config"
```

```bash
# Publish stub templates
php artisan vendor:publish --tag="mason-stubs"

# Publish views
php artisan vendor:publish --tag="mason-views"

# Publish translations
php artisan vendor:publish --tag="mason-translations"
```

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

### Mason Package File Structure

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/00-api-overview.md

Overview of the directory structure for the Mason package source code.

```text
src/
├── Mason.php                    # Form field
├── MasonEntry.php              # Infolist component
├── Brick.php                   # Abstract base class
├── BrickGroup.php              # Brick organization
├── Actions/
│   └── BrickAction.php         # Action handler
├── Bricks/
│   └── Section.php             # Built-in section brick
├── Commands/
│   ├── MakeBrickCommand.php    # Scaffolding
│   └── UpgradeBricksCommand.php # Migration
├── Concerns/
│   ├── HasBricks.php           # Brick management
│   └── HasSidebar.php          # Sidebar config
├── Enums/
│   └── SidebarPosition.php     # Position enum
├── Http/
│   └── Controllers/
│       └── MasonController.php # Iframe routes
├── Support/
│   ├── BrickCommand.php        # Command class
│   ├── Faker.php               # Test helper
│   ├── IframeRenderer.php      # Editor preview
│   ├── IframeEntryRenderer.php # Entry rendering
│   └── MasonRenderer.php       # Content renderer
├── Testing/
│   └── TestsMason.php          # Test utilities
├── MasonServiceProvider.php    # Package registration
└── helpers.php                 # Helper functions
```

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

### Publish Mason Configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Executes the Artisan command to publish the package configuration file to the local config directory.

```bash
php artisan vendor:publish --tag="mason-config"
```

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

### Mason Helper Function Usage

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Provides a shortcut for rendering Mason content to HTML.

```php
mason($content, $bricks)->toHtml()
```

```php
MasonRenderer::make($content)->bricks($bricks)->toHtml()
```

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

### Upgrade Mason Bricks via Artisan

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/INDEX.md

Migrate bricks from version 0.x to 1.x using the mason:upgrade-bricks command.

```bash
php artisan mason:upgrade-bricks --table=posts --column=content
```

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

### BrickAction Configuration Methods

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/08-brick-action.md

Methods used to configure the behavior of the brick action modal.

```php
->bootUsing(function (Action $action, array $arguments, Mason $component): ?Action {
    $brick = $component->getBrick($arguments['id']);
    
    if (blank($brick)) {
        return null;
    }
    
    return $brick::configureBrickAction($action);
})
```

```php
->fillForm(fn (array $arguments): ?array => $arguments['config'] ?? null)
```

```php
->modalHeading(function (array $arguments, Mason $component) {
    $brick = $component->getBrick($arguments['id']);
    
    if (blank($brick)) {
        return null;
    }
    
    return $brick::getLabel();
})
```

```php
->modalWidth(Width::Large)
```

```php
->modalSubmitActionLabel(fn (array $arguments): ?string => match ($arguments['mode']) {
    'insert' => __('mason::mason.actions.brick.modal.actions.insert.label'),
    'edit' => __('mason::mason.actions.brick.modal.actions.save.label'),
    default => null,
})
```

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

### Implement toHtml()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/02-brick-base-class.md

Defines the rendering logic for the brick's HTML output.

```php
public static function toHtml(array $config, ?array $data = null): ?string
```

```php
public static function toHtml(array $config, ?array $data = null): ?string
{
    $text = $config['text'] ?? '';
    $size = $config['size'] ?? 'md';
    
    return view('bricks.text', [
        'text' => $text,
        'size' => $size,
    ])->render();
}
```

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

### Scaffold a new Mason brick

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Use this command to generate the necessary PHP class and Blade view files for a new brick.

```bash
php artisan make:mason-brick {name?} {--F|force}
```

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

### Publishing Mason Views

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Artisan command to publish vendor assets for template customization.

```bash
php artisan vendor:publish --tag=mason-views
```

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

### Run All Tests

Source: https://github.com/awcodes/mason/blob/3.x/CLAUDE.md

Execute all tests including refactor check, lint check, and unit tests.

```bash
composer test
```

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

### Configure Bricks for MasonEntry

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/06-mason-entry.md

Register specific brick classes to be available for rendering the entry content.

```php
MasonEntry::make('content')
    ->bricks([
        Section::class,
        Hero::class,
        TextBlock::class,
    ])
```

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

### Configure Generator Settings

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Defines the namespace and views path for brick scaffolding.

```php
'generator' => [
    'namespace' => 'App\\Mason',
    'views_path' => 'mason',
],
```

```php
// Custom namespace
'namespace' => 'App\\Admin\\Bricks',
// Creates: app/Admin/Bricks/MyBrick.php

// Custom views path
'views_path' => 'components/bricks',
// Creates: resources/views/components/bricks/my-brick/index.blade.php
```

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

### Configure Entry Layout

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Sets the layout view for the MasonEntry component.

```php
'entry' => [
    'layout' => 'mason::iframe-entry',
],
```

```php
'entry' => [
    'layout' => 'layouts.mason-entry',
],
```

```blade
<div class="prose max-w-none">
    @foreach ($blocks as $block)
        @if ($block['html'])
            {!! $block['html'] !!}
        @endif
    @endforeach
</div>
```

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

### Display Mason content in an Infolist

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/06-mason-entry.md

Configures the MasonEntry component within an infolist schema, specifying available bricks and an optional preview layout.

```php
->infolist([
    MasonEntry::make('page_content')
        ->bricks([
            Section::class,
            CustomBrick::class,
        ])
        ->previewLayout('layouts.custom-entry'),
])
```

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

### Interactive brick creation

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

The command will prompt for a name if one is not provided as an argument.

```text
What is the brick name? [default: none]: MyCustomBrick
```

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

### BrickGroup::make()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/05-brick-group.md

Creates a new instance of a BrickGroup with a specified display label.

```APIDOC
## BrickGroup::make()

### Description
Creates a new brick group with the specified label for the UI.

### Signature
`public static function make(string $label): static`

### Parameters
- **label** (string) - Required - The group's display label in the UI.

### Returns
- `static` - A new BrickGroup instance.
```

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

### BrickCommand

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/00-api-overview.md

Commands for programmatically manipulating Mason content.

```APIDOC
## BrickCommand

### Description
Provides static methods to generate commands for content manipulation.

### Methods
- **insertBrick($data, $index)**: Creates an insert command.
- **moveBrick($from, $to)**: Creates a move command.
- **deleteBrick($index)**: Creates a delete command.
```

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

### Mason Renderer Output Methods

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Available methods for retrieving rendered content as HTML, plain text, or an array of blocks.

```php
// toHtml() - Sanitized HTML string
"<div class='section'>...</div><div class='hero'>...</div>"

// toText() - Plain text
"Section content here. Hero title here."

// toArray() - Array of blocks
[
    ['type' => 'masonBrick', 'attrs' => [...]],
]
```

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

### Mason Upgrade Command

Source: https://github.com/awcodes/mason/blob/3.x/UPGRADE.md

Command to execute the brick migration process in Mason 1.x.

```bash
php artisan mason:upgrade-bricks
```

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

### Create Custom Bricks

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/00-api-overview.md

Implementation of a custom brick by extending the base Brick class.

```php
use Awcodes\Mason\Brick;
use Filament\Actions\Action;

class MyBrick extends Brick
{
    public static function getId(): string { return 'my-brick'; }
    
    public static function toHtml(array $config, ?array $data = null): ?string
    {
        return view('bricks.my-brick', $config)->render();
    }
    
    public static function configureBrickAction(Action $action): Action
    {
        return $action->slideOver()->schema([
            // Filament form components
        ]);
    }
}
```

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

### Configure Mason Preview Layout

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Set a custom preview layout for the Mason field to match application styles.

```php
Mason::make('content')
    ->previewLayout('layouts.mason-preview') // your app's layout
    ->bricks([...])
```

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

### Handling empty states in Mason

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Demonstrates how various empty inputs result in an empty string output when processed by the MasonRenderer.

```php
// All treated as empty
$content = null;
$content = [];
$content = '';
$content = '[]';
$content = json_encode([]);

// Result: renderer produces empty output
MasonRenderer::make($content)->toHtml();  // Returns ""
```

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

### Configure Preview Layout

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Sets the layout view for the editor preview iframe.

```php
'preview' => [
    'layout' => 'mason::iframe-preview',
],
```

```php
'preview' => [
    'layout' => 'layouts.mason-preview',
],
```

```blade
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        body { font-family: system-ui; margin: 20px; }
    </style>
    @masonStyles
</head>
<body>
    @foreach ($blocks as $block)
        @if ($block['html'])
            <div class="block">
                <div class="label">{{ $block['label'] }}</div>
                {!! $block['html'] !!}
            </div>
        @endif
    @endforeach
</body>
</html>
```

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

### Implement a custom Brick class

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/02-brick-base-class.md

Defines a new brick by extending the Brick base class and implementing the required static methods for configuration and rendering.

```php
namespace App\Mason;

use Awcodes\Mason\Brick;
use Filament\Actions\Action;
use Filament\Forms\Components\RichEditor;
use Filament\Forms\Components\TextInput;
use Filament\Support\Icons\Heroicon;

class TextSection extends Brick
{
    public static function getId(): string
    {
        return 'text-section';
    }

    public static function getLabel(): string
    {
        return 'Text Section';
    }

    public static function getIcon(): Heroicon|null
    {
        return Heroicon::make('hero-document-text');
    }

    public static function getTags(): array
    {
        return ['content', 'text', 'basic'];
    }

    public static function toHtml(array $config, ?array $data = null): ?string
    {
        return view('mason.text-section', [
            'title' => $config['title'] ?? '',
            'content' => $config['content'] ?? '',
        ])->render();
    }

    public static function configureBrickAction(Action $action): Action
    {
        return $action
            ->slideOver()
            ->schema([
                TextInput::make('title')
                    ->label('Section Title'),
                RichEditor::make('content')
                    ->label('Content'),
            ]);
    }
}
```

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

### MasonController Preview Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Signature for the preview method used to render blocks in the editor iframe.

```php
public function preview(Request $request): Response
```

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

### Configure Brick Action

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Configures the editing action for the brick using a slideOver form.

```php
public static function configureBrickAction(Action $action): Action
```

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

### Initialize Mason Form Field

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Add the Mason component to a Filament form schema with required bricks.

```php
use Awcodes
eson
eson;
use Awcodes
esonricks
ection;

->schema([
    reson::make('content')
        ->bricks([
            rection::class,
        ]),
])
```

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

### Configure multiple guards and tenants

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/12-configuration.md

Adjust route middleware to support specific guards or tenant-based authentication.

```php
'routes' => [
    'middleware' => [
        'web',
        env('FILAMENT_GUARD', 'auth'),  // Use configured guard
    ],
],
```

```php
'routes' => [
    'middleware' => [
        'web',
        'tenant',           // Custom tenant middleware
        'auth:admin',       // Specific admin guard
    ],
],
```

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

### Display Brick Actions as Grid

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Switch the default list view of brick actions to a grid layout.

```php
Mason::make('content')
    ->displayActionsAsGrid()
    ->bricks([...])
```

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

### BrickCommand moveBrick() Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/04-brick-command.md

Creates a command to reorder a brick from a source index to a destination index.

```php
public static function moveBrick(int $from, int $to): static
```

```php
$command = BrickCommand::moveBrick(1, 3);
// Moves brick from position 1 to position 3
```

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

### Implement MasonEntry in a Filament Resource

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/06-mason-entry.md

Integrates MasonEntry into a standard Filament resource infolist schema.

```php
use Awcodes\Mason\MasonEntry;
use App\Mason\Section;
use App\Mason\Hero;

class PostResource extends Resource
{
    protected static string $model = Post::class;

    public static function infolist(Infolist $infolist): Infolist
    {
        return $infolist
            ->schema([
                Section::make('Content')
                    ->schema([
                        TextEntry::make('title'),
                        MasonEntry::make('body')
                            ->bricks([
                                Hero::class,
                                Section::class,
                            ]),
                    ]),
            ]);
    }
}
```

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

### mason()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

A shortcut function for creating MasonRenderer instances.

```APIDOC
## mason()

### Description
Shortcut function for creating MasonRenderer instances.

### Signature
`function mason(string|array|stdClass|null $content, ?array $bricks = []): MasonRenderer`

### Parameters
- **content** (string|array|stdClass|null) - Required - Mason content (JSON string or array)
- **bricks** (array) - Optional - Brick class names

### Returns
- **MasonRenderer** - Configured renderer

### Example
```php
$html = mason($post->content, [Section::class])->toHtml();
```
```

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

### Configure bricks for a group

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/05-brick-group.md

Assigns an array of brick class names to a previously created BrickGroup instance.

```php
$group = BrickGroup::make('Layouts')
    ->bricks([
        TwoColumnLayout::class,
        ThreeColumnLayout::class,
        FullWidthLayout::class,
    ])
```

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

### MasonRenderer::make()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Creates a new instance of the MasonRenderer using a fluent factory method.

```APIDOC
## MasonRenderer::make()

### Description
Creates a new renderer instance with fluent initialization.

### Signature
`public static function make(string|array|null $content = null): static`

### Parameters
- **content** (string|array|null) - Optional - JSON string or array of brick blocks.

### Returns
- **static** - A new MasonRenderer instance.
```

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

### BrickCommand insertBrick() Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/04-brick-command.md

Creates a command to insert a new brick at a specific index position.

```php
public static function insertBrick(array $brick, int $position): static
```

```php
$command = BrickCommand::insertBrick([
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Hello'],
    ],
], 0);

// Inserts at the beginning
```

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

### Default Configuration Settings

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/09-section-brick.md

Defines the fallback values used when specific configuration keys are missing.

```php
'background_color' => $config['background_color'] ?? 'white',
'image_position' => $config['image_position'] ?? null,
'image_alignment' => $config['image_alignment'] ?? null,
'image_rounded' => $config['image_rounded'] ?? false,
'image_shadow' => $config['image_shadow'] ?? false,
'text' => $config['text'] ?? null,
'image' => $config['image'] ?? null,
```

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

### Create a New Brick

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/README.md

Generates a new brick class using the Artisan CLI.

```bash
php artisan make:mason-brick Hero

# Then implement:
# - getId()
# - toHtml()
# - configureBrickAction()
```

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

### Render a single brick with getBrickHtml()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/03-mason-renderer.md

Use getBrickHtml() to render a specific brick by ID and configuration; returns an empty string if the brick is not found.

```php
public function getBrickHtml(string $id, array $config): string
```

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

### MasonEntry::make()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/06-mason-entry.md

Creates a new instance of the MasonEntry component for use in Filament infolist schemas.

```APIDOC
## MasonEntry::make()

### Description
Creates a new infolist entry component.

### Signature
`public static function make(string | Stringable $name): static`

### Parameters
- **name** (string|Stringable) - Required - The field name in the record model

### Returns
`static` - A new MasonEntry instance
```

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

### BrickGroup::make

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/INDEX.md

Creates a new BrickGroup instance to organize bricks within the sidebar.

```APIDOC
## BrickGroup::make

### Description
Creates a new instance of a BrickGroup for organizing bricks in the sidebar.

### Usage
```php
BrickGroup::make('Layout')
    ->bricks([Section::class, TwoColumns::class])
```
```

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

### Define Text Brick configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Configuration object for a text brick.

```php
'config' => [
    'text' => 'Rich HTML content...',
    'alignment' => 'left',
    'max_width' => '800px',
]
```

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

### Display File Relationships

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/MANIFEST.md

Visual representation of the project's documentation file hierarchy.

```text
00-api-overview.md (entry point)
├── 01-mason-field.md (form component)
├── 02-brick-base-class.md (core pattern)
├── 03-mason-renderer.md (rendering)
├── 04-brick-command.md (state commands)
├── 05-brick-group.md (organization)
├── 06-mason-entry.md (infolist)
├── 07-iframe-renderers.md (preview/entry)
├── 08-brick-action.md (edit actions)
├── 09-section-brick.md (example)
├── 10-artisan-commands.md (scaffolding)
├── 11-support-classes.md (utilities)
├── 12-configuration.md (setup)
└── 13-data-structures.md (data format)

INDEX.md (searchable index)
README.md (navigation guide)
```

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

### Implement getIcon()

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/02-brick-base-class.md

Specifies an icon to display next to the brick label in the UI.

```php
public static function getIcon(): string|Heroicon|Htmlable|null
```

```php
public static function getIcon(): Heroicon|null
{
    return Heroicon::make('hero-squares-2x2');
}
```

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

### Publish and configure Mason

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Commands and configuration settings to customize the generator's output paths and namespaces.

```bash
php artisan vendor:publish --tag="mason-config"
```

```php
'generator' => [
    'namespace' => 'App\\MyBricks',        // Custom namespace
    'views_path' => 'components/bricks',   // Custom views directory
],
```

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

### BrickCommand

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/README.md

Static methods for performing atomic state modifications on bricks.

```APIDOC
## BrickCommand

### Description
Provides atomic operations to manipulate the state of bricks.

### Methods
- `insertBrick($brick, int $index)`: Inserts a brick at the specified index.
- `updateBrick(int $id, $brick)`: Updates an existing brick by ID.
- `deleteBrick(int $id)`: Deletes a brick by ID.
- `moveBrick(int $from, int $to)`: Moves a brick from one index to another.
```

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

### Database Storage Schemas

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Database migration and model casting configurations for storing Mason content.

```php
Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->longText('content');  // JSON stored here
    $table->timestamps();
});

// In model
protected $casts = [
    'content' => 'array',
];

// Usage
$post = Post::find(1);
echo count($post->content);  // Number of bricks
```

```php
Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->json('content');  // Native JSON type
    $table->timestamps();
});

// Same casting as MySQL
protected $casts = [
    'content' => 'array',
];
```

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

### Scaffold New Brick

Source: https://github.com/awcodes/mason/blob/3.x/CLAUDE.md

Generate a new brick class and its associated view templates.

```bash
php artisan make:mason-brick {Name}
```

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

### Configure Custom Theme CSS

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Add the plugin's CSS and source path to your custom theme file to ensure proper styling.

```css
@import '../../../../vendor/awcodes/mason/resources/css/plugin.css';

@source '../../../../vendor/awcodes/mason/resources/**/*.blade.php';
```

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

### MasonController Entry Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/11-support-classes.md

Signature for the entry method used to render blocks in the infolist iframe.

```php
public function entry(Request $request): Response
```

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

### Define Section Brick configuration

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/13-data-structures.md

Configuration object for a section brick.

```php
'config' => [
    'background_color' => 'white',
    'text' => '<h2>Title</h2><p>Content</p>',
    'image' => 'uploads/image.jpg',
    'image_position' => 'end',
    'image_alignment' => 'middle',
    'image_rounded' => false,
    'image_shadow' => true,
]
```

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

### BrickCommand updateBrick() Method

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/04-brick-command.md

Creates a command to replace an existing brick at a given index.

```php
public static function updateBrick(int $index, array $brick): static
```

```php
$command = BrickCommand::updateBrick(0, [
    'type' => 'masonBrick',
    'attrs' => [
        'id' => 'section',
        'config' => ['text' => 'Updated text'],
    ],
]);
```

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

### Mason Configuration File Structure

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/10-artisan-commands.md

Defines the namespace and views path for Mason generators within the application configuration.

```php
// config/mason.php
return [
    'generator' => [
        'namespace' => 'App\\Mason',
        'views_path' => 'mason',
    ],
    // ...
];
```

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

### Mason File Structure

Source: https://github.com/awcodes/mason/blob/3.x/_autodocs/README.md

Overview of the documentation file organization.

```text
00-api-overview.md              ← Start here
├── 01-mason-field.md           ← Form field API
├── 02-brick-base-class.md      ← Creating bricks
├── 03-mason-renderer.md        ← Rendering content
├── 04-brick-command.md         ← State commands
├── 05-brick-group.md           ← Organizing bricks
├── 06-mason-entry.md           ← Infolist component
├── 07-iframe-renderers.md      ← Preview/entry rendering
├── 08-brick-action.md          ← Edit action lifecycle
├── 09-section-brick.md         ← Built-in example
├── 10-artisan-commands.md      ← CLI tools
├── 11-support-classes.md       ← Utilities
├── 12-configuration.md         ← Configuration
└── 13-data-structures.md       ← Data format reference
```

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

### Advanced Mason rendering with MasonRenderer

Source: https://github.com/awcodes/mason/blob/3.x/README.md

Use the MasonRenderer class for more granular control over the rendering process, supporting multiple output formats like HTML, arrays, or plain text.

```php
use Awcodes\Mason\Support\MasonRenderer;

$renderer = MasonRenderer::make($content)->bricks(\App\Mason\BrickCollection::make());

$renderer->toHtml()
$renderer->toUnsafeHtml();
$renderer->toArray();
$renderer->toText();
```
Tokens:
Raw