*/ protected array $plugins = []; protected ?FileAttachmentProvider $fileAttachmentProvider = null; /** * @var ?array */ protected ?array $mergeTags = null; /** * @var ?array */ protected ?array $mergeTagLabels = null; /** * @var ?array */ protected ?array $mentionProviders = null; /** * @var ?array | array | Closure> */ protected ?array $customBlocks = null; protected bool $isJson = false; /** * @var ?array */ protected ?array $textColors = null; protected bool $hasCustomTextColors = false; public function __construct(protected Model $model, protected string $name) {} public static function make(Model $model, string $name): static { return app(static::class, ['model' => $model, 'name' => $name]); } public function fileAttachmentsDisk(?string $name): static { $this->fileAttachmentsDiskName = $name; return $this; } public function fileAttachmentsVisibility(?string $visibility): static { $this->fileAttachmentsVisibility = $visibility; return $this; } public function getFileAttachmentsDiskName(): ?string { return $this->fileAttachmentsDiskName; } public function getFileAttachmentsVisibility(): ?string { return $this->fileAttachmentsVisibility ?? $this->getFileAttachmentProvider()?->getDefaultFileAttachmentVisibility(); } /** * @param array $plugins */ public function plugins(array $plugins): static { $this->plugins = [ ...$this->plugins, ...$plugins, ]; return $this; } /** * @return array */ public function getPlugins(): array { return $this->plugins; } public function fileAttachmentProvider(?FileAttachmentProvider $provider): static { $this->fileAttachmentProvider = $provider?->attribute($this); return $this; } public function getFileAttachmentProvider(): ?FileAttachmentProvider { if ($this->fileAttachmentProvider) { return $this->fileAttachmentProvider; } foreach ($this->getPlugins() as $plugin) { if ($plugin instanceof HasFileAttachmentProvider) { $provider = $plugin->getFileAttachmentProvider(); if ($provider) { return $this->fileAttachmentProvider = $provider->attribute($this); } } } return null; } public function getModel(): Model { return $this->model; } public function getName(): string { return $this->name; } public function toHtml(): string { $content = $this->model->getAttribute($this->name); if (blank($content)) { return ''; } return $this->getRenderer()->toHtml(); } public function toText(): string { $content = $this->model->getAttribute($this->name); if (blank($content)) { return ''; } return $this->getRenderer()->toText(); } public function getRenderer(): RichContentRenderer { return RichContentRenderer::make($this->model->getAttribute($this->name) ?? '') ->plugins($this->getPlugins()) ->customBlocks($this->customBlocks) ->mergeTags($this->mergeTags) ->mentions($this->mentionProviders) ->fileAttachmentsDisk($this->getFileAttachmentsDiskName()) ->fileAttachmentsVisibility($this->getFileAttachmentsVisibility()) ->fileAttachmentProvider($this->getFileAttachmentProvider()) ->textColors($this->getTextColors()); } /** * @param ?array $tags */ public function mergeTags(?array $tags): static { $this->mergeTags = $tags; return $this; } /** * @param ?array $labels */ public function mergeTagLabels(?array $labels): static { $this->mergeTagLabels = $labels; return $this; } /** * @return ?array */ public function getMergeTags(): ?array { if (blank($this->mergeTags) && blank($this->mergeTagLabels)) { return null; } return [ ...array_combine(array_keys($this->mergeTags ?? []), array_keys($this->mergeTags ?? [])), ...($this->mergeTagLabels ?? []), ]; } /** * @param ?array $providers */ public function mentions(?array $providers): static { $this->mentionProviders = $providers; return $this; } /** * @return ?array */ public function getMentionProviders(): ?array { return $this->mentionProviders; } /** * @param ?array | array> | array | Closure> $blocks */ public function customBlocks(?array $blocks): static { $this->customBlocks = $blocks; return $this; } /** * @return ?array> */ public function getCustomBlocks(): ?array { if (blank($this->customBlocks)) { return null; } $blocks = []; foreach ($this->customBlocks as $key => $block) { if (is_string($key) && is_a($key, RichContentCustomBlock::class, allow_string: true)) { // Data association: `BlockClass::class => $data` $blocks[] = $key; } elseif (is_array($block)) { // Group or ungrouped section: `'Label' => [...]` or `[...]` foreach ($block as $innerKey => $innerValue) { $blocks[] = is_string($innerKey) ? $innerKey : $innerValue; } } else { $blocks[] = $block; } } return $blocks; } /** * @return array | array>> */ public function getCustomBlocksConfig(): array { return $this->customBlocks ?? []; } public function json(bool $condition = true): static { $this->isJson = $condition; return $this; } public function isJson(): bool { return $this->isJson; } /** * @param ?array $colors */ public function textColors(?array $colors): static { $this->textColors = $colors; return $this; } /** * @return array */ public function getTextColors(): array { $textColors = $this->textColors ?? TextColor::getDefaults(); return Arr::mapWithKeys( $textColors, fn (string | TextColor $color, string $name): array => [$name => ($color instanceof TextColor) ? $color : TextColor::make($color, $name)], ); } public function customTextColors(bool $condition = true): static { $this->hasCustomTextColors = $condition; return $this; } public function hasCustomTextColors(): bool { return $this->hasCustomTextColors; } }