label('Abschnitte') ->blocks(array_values(array_map(self::block(...), $registry->all()))) ->blockPreviews() ->blockPickerColumns(['default' => 1, 'md' => 2]) ->blockPickerWidth('3xl') ->addActionLabel('Abschnitt hinzufügen') ->addBetweenActionLabel('Hier einfügen') ->reorderableWithButtons() ->reorderableWithDragAndDrop() ->cloneable() ->deletable() ->maxItems(self::MAX_WIDGETS) ->addAction(fn ($action) => $action->modalHeading('Neuen Abschnitt einrichten')->modalWidth('4xl')) ->addBetweenAction(fn ($action) => $action->modalHeading('Neuen Abschnitt einrichten')->modalWidth('4xl')) ->editAction(fn ($action) => $action->modalHeading('Abschnitt bearbeiten')->modalWidth('4xl')->modalSubmitActionLabel('Übernehmen')) ->columnSpanFull(); } public static function block(WidgetType $type): Block { $variants = $type->variants(); $schema = [Hidden::make('id')]; $schema[] = count($variants) > 1 ? ToggleButtons::make('variant') ->label('Darstellung') ->options($variants) ->default($type->defaultVariant()) ->inline() ->required() : Hidden::make('variant')->default($type->defaultVariant()); if ($type->settings() !== []) { $settings = []; foreach ($type->settings() as $key => $options) { $settings[] = Select::make($key)->label(Str::headline($key))->options($options); } $schema[] = Group::make($settings)->statePath('settings'); } foreach ($type->editorSchema() as $component) { $schema[] = $component; } return WidgetBlock::make($type->key()) ->label(function (?array $state) use ($type): string|HtmlString { if ($state === null) { return self::pickerLabel($type); } return self::itemLabel($type, $state); }) ->icon($type->icon()) ->schema($schema) ->preview('filament.cms.widget-preview'); } /** * Gespeicherte Bausteine (Altformat oder Hülle) als Builder-Zustand. * * @param array|null $blocks * @return list}> */ public static function toBuilderState(?array $blocks): array { $state = []; foreach (app(WidgetRegistry::class)->read($blocks) as $widget) { $state[] = [ 'type' => $widget['type'], 'data' => [ 'id' => $widget['id'] ?? (string) Str::uuid(), 'variant' => $widget['variant'], 'settings' => $widget['settings'], 'data' => $widget['data'], 'refs' => $widget['refs'], ], ]; } return $state; } /** * Builder-Zustand als Hüllen für PageService::saveRevision(). * * @param array|null $state * @return list> */ public static function fromBuilderState(?array $state): array { $registry = app(WidgetRegistry::class); $blocks = []; foreach (array_values($state ?? []) as $item) { $key = $item['type'] ?? null; $data = is_array($item['data'] ?? null) ? $item['data'] : []; $blocks[] = [ 'id' => $data['id'] ?? null, 'type' => $key, 'v' => $registry->has($key) ? $registry->get($key)->version() : 1, 'variant' => $data['variant'] ?? null, 'settings' => is_array($data['settings'] ?? null) ? $data['settings'] : [], 'data' => self::listValues(is_array($data['data'] ?? null) ? $data['data'] : []), 'refs' => self::listValues(is_array($data['refs'] ?? null) ? $data['refs'] : []), ]; } return $blocks; } /** * Übersetzt Fehlerschlüssel des Registers ("blocks.3.data.url") in Formularpfade des Builders. * * @param array $errors * @param list $itemKeys Builder-Schlüssel in Anzeigereihenfolge * @return array */ public static function mapErrors(array $errors, array $itemKeys, string $statePath = 'data.blocks'): array { $mapped = []; foreach ($errors as $key => $messages) { if (preg_match('/^blocks\.(\d+)(?:\.(.*))?$/', (string) $key, $match) === 1 && isset($itemKeys[(int) $match[1]])) { // Verschachtelte Listen (items.2.url) tragen im Formular UUID-Schlüssel; die Meldung steht dann am Listenfeld. $suffix = preg_replace('/\.\d+\..*$/', '', $match[2] ?? ''); $mapped[$statePath.'.'.$itemKeys[(int) $match[1]].'.data'.($suffix !== '' ? '.'.$suffix : '')] = $messages; continue; } $mapped['data.'.$key] = $messages; } return $mapped; } /** * Fehler aus der Registry als sichtbare Meldung: Die Felder eines Abschnitts liegen im Bearbeitungsdialog * und sind nach dem Speichern nicht auf der Seite sichtbar. Die Meldung nennt Abschnittsnummer und Art. * * @param array> $errors * @param array $blocks Bausteine in Anzeigereihenfolge */ public static function notifyErrors(array $errors, array $blocks): void { $registry = app(WidgetRegistry::class); $blocks = array_values($blocks); $lines = []; foreach ($errors as $key => $messages) { if (preg_match('/^blocks\.(\d+)/', (string) $key, $match) === 1) { $type = $blocks[(int) $match[1]]['type'] ?? null; $label = $registry->has($type) ? $registry->get($type)->label() : 'Abschnitt'; $lines[] = 'Abschnitt '.((int) $match[1] + 1).' ('.$label.'): '.implode(' ', (array) $messages); } else { $lines[] = implode(' ', (array) $messages); } } Notification::make() ->title('Nicht gespeichert') ->body(implode("\n", array_unique($lines))) ->danger() ->persistent() ->send(); } /** * Blockvorschau: dieselbe Widget-Ansicht wie öffentlich, aus dem ungespeicherten Zustand. * * @param array $state roher Zustand eines Builder-Eintrags */ public static function renderPreview(string $type, array $state): string { $registry = app(WidgetRegistry::class); if (! $registry->has($type)) { return ''; } $widget = $registry->upcast([ 'id' => null, 'type' => $type, 'v' => $registry->get($type)->version(), 'variant' => $state['variant'] ?? null, 'settings' => is_array($state['settings'] ?? null) ? $state['settings'] : [], 'data' => self::plainState(is_array($state['data'] ?? null) ? $state['data'] : []), 'refs' => self::plainState(is_array($state['refs'] ?? null) ? $state['refs'] : []), ]); try { return app(WidgetRenderer::class)->renderWidget($widget, RenderContext::preview()); } catch (Throwable $exception) { report($exception); return '

Die Vorschau dieses Abschnitts ist noch unvollständig.

'; } } public static function previewStylesheets(): string { try { return app(Vite::class)(['resources/css/app.css'])->toHtml(); } catch (Throwable) { return ''; } } private static function pickerLabel(WidgetType $type): HtmlString { return new HtmlString( '' .self::schematicSvg($type) .''.e($type->label()).'' .''.e($type->description()).'' ); } /** * @param array $state */ private static function itemLabel(WidgetType $type, array $state): string { $variant = $state['variant'] ?? $type->defaultVariant(); $variantLabel = $type->variants()[$variant] ?? null; try { $summary = $type->summary([ 'type' => $type->key(), 'variant' => $variant, 'data' => self::plainState(is_array($state['data'] ?? null) ? $state['data'] : []), 'refs' => self::plainState(is_array($state['refs'] ?? null) ? $state['refs'] : []), 'settings' => [], ]); } catch (Throwable) { $summary = ''; } $parts = [$type->label()]; if (count($type->variants()) > 1 && $variantLabel !== null) { $parts[] = $variantLabel; } $label = implode(' · ', $parts); return $summary !== '' ? $label.' – '.Str::limit($summary, 90) : $label; } private static function schematicSvg(WidgetType $type): string { $fills = ['ink' => '#1b2838', 'accent' => '#0f6e56', 'line' => '#c5d2cb', 'image' => '#9fb8ab']; $rects = ''; foreach ($type->schematic() as [$x, $y, $w, $h, $tone]) { $rects .= sprintf('', $x, $y, $w, $h, $fills[$tone] ?? $fills['line']); } return ''; } /** * Roh-Zustand des Formulars (Repeater mit UUID-Schlüsseln, Texteditor als Dokument) in einfache Werte. * * @param array $state * @return array */ private static function plainState(array $state): array { foreach ($state as $key => $value) { if (is_array($value) && ($value['type'] ?? null) === 'doc') { try { $state[$key] = RichContentRenderer::make($value)->toHtml(); } catch (Throwable) { $state[$key] = ''; } continue; } if (is_array($value) && ! str_starts_with((string) $key, '_')) { $state[$key] = self::plainState(array_is_list($value) || ! self::isUuidKeyed($value) ? $value : array_values($value)); } } return $state; } /** * @param array $values * @return array */ private static function listValues(array $values): array { foreach ($values as $key => $value) { if (is_array($value) && ! str_starts_with((string) $key, '_')) { $values[$key] = self::isUuidKeyed($value) ? array_values(array_map(fn ($item) => is_array($item) ? self::listValues($item) : $item, $value)) : self::listValues($value); } } return $values; } /** * @param array $value */ private static function isUuidKeyed(array $value): bool { if ($value === []) { return false; } foreach (array_keys($value) as $key) { if (! is_string($key) || ! Str::isUuid($key)) { return false; } } return true; } }