{{--
    Themed file picker: the wireframe's upload zone
    (docs/wireframes-v12/add-project.html ~line 310) — a dashed, clickable area
    — with the real <input type="file"> hidden inside it, plus the current-file
    row an edit screen needs.

    The zone and the current-file row were already built to the wireframe's own
    class names (`.upload-zone`, `.uploaded-file` and its `.file-icon` /
    `.file-details` / `.file-name` / `.file-meta` / `.file-actions` children);
    CR-2 checked all of them against v12's style.css and they match 1:1, so the
    only change here is the download button's variant (see below).

        <x-form.file name="brochure" label="Brochure Upload" accept="application/pdf,.pdf"
                     hint="PDF · max 10 MB" icon="fa-solid fa-file-pdf"
                     :current-name="$project->brochure_original_name"
                     :current-url="route('projects.files.download', [$project, 'brochure'])" />

    Props:
        name          Field name, in HTML form. Required.
        label         Label text, rendered by the shared group above the zone.
        accept        The `accept` attribute — a filter, never a control: the
                      server rules in the FormRequest are what actually decide.
        hint          The types-and-size line, e.g. "PDF, JPG, PNG · max 5 MB".
                      Rendered *inside* the zone as the wireframe has it.
        required      Red asterisk on the label + the `required` attribute.
        icon          FontAwesome classes for the zone icon. Defaults to the
                      upload cloud; the wireframe varies it per slot.
        current-name  The stored *original* client filename on an edit screen.
                      Attacker-controlled (§5 stores it verbatim), so it is
                      rendered as escaped text and never as raw markup.
        current-url   Download href for that file. The current-file row appears
                      only when both halves are given — a name with no link is
                      a dead end, a link with no name has nothing to label it.
        max-kb        The slot's size cap in kilobytes, which arms the
                      client-side guard: the input gets `data-max-kb` and the
                      already-translated message to show, and
                      nrems-upload-guard.js clears an over-cap pick before it
                      can be submitted. Pass ProjectFileSlot::maxKilobytes()
                      (or whatever enum owns the rule), never a literal — the
                      `max:` rule in the FormRequest comes from the same
                      method, and the server stays the one that decides.
                      Omitted, no attribute is emitted and no guard runs.
        max-label     How that cap reads in the message, e.g. "10 MB". Comes
                      from the same enum (ProjectFileSlot::maxLabel()); left
                      out, it is derived from max-kb the same way, which is
                      the fallback for a caller with no enum behind it.
        group-class   Extra classes for the wrapper, e.g. "col-md-6".

    Everything else — data-*, multiple, capture — passes through to the input.
    One caveat on `multiple`: nrems-upload-guard.js checks files[0] alone, so a
    multi-file slot needs the guard extended (loop, and a decision about what
    the cap means across a set) before the attribute is passed here — otherwise
    the second file a user picks is never size-checked.

    A file input cannot be repopulated from old input: after a failed submit the
    browser has no way to re-attach the user's file and the field comes back
    empty. So there is no :value prop and no old-input resolution here; what
    matters is that the *error* renders and the rest of the form keeps its
    values, which it does because every other field resolves old() as usual.
    The consequence for the user — re-pick the file — is the browser's rule,
    not something this component can work around.

    The prompt is an <h5> because the wireframe styles `.upload-zone h5` and
    nothing else — the size and weight come from that selector. The cost is a
    real heading in the document outline for every zone (four meaningless stops
    on the project form when a screen-reader user navigates by heading); worth
    knowing before a screen grows a fifth.

    Accessibility: the zone is a <label> that both wraps the input and carries
    `for`, so a click anywhere in it opens the picker. Two labels therefore
    point at one control — the field label from the group and the zone — and a
    screen reader announces them in order: "Brochure Upload, Click to upload a
    file, PDF · max 10 MB". That is why the hint is *not* in aria-describedby:
    sitting inside the label it is already part of the accessible name, and
    describing it again would say it twice. It still carries the library's
    standard "{field}_hint" id, which is what the id contract promises; the
    size guard below addresses the group's "{field}_error" node instead, so an
    oversized pick reads exactly like a rejected one and the hint goes on
    stating the cap rather than being overwritten by a complaint about it.

    ---
    spatie/laravel-html variant: the control is html()->file() and the zone is
    an element tree, built the way the other components build theirs.
--}}
@props([
    'name',
    'label' => null,
    'accept' => null,
    'hint' => null,
    'required' => false,
    'icon' => 'fa-solid fa-cloud-arrow-up',
    'currentName' => null,
    'currentUrl' => null,
    'maxKb' => null,
    'maxLabel' => null,
    'groupClass' => null,
])

@php
    $fieldId = $attributes->get('id') ?? form_field_id($name);
    $error = form_error_message($name);
    $hasCurrentFile = filled($currentName) && filled($currentUrl);

    // The cap the guard enforces, and the sentence it says when it trips —
    // rendered here so the module holds no wording and no number of its own.
    // The label is the enum's own (ProjectFileSlot::maxLabel()) whenever the
    // caller has one; the fallback rounds the same way it does.
    $guardLabel = $maxLabel ?? (filled($maxKb) ? round((int) $maxKb / 1024, 1).' MB' : null);

    $control = html()->file($name)
        ->id($fieldId)
        ->class('visually-hidden')
        ->addClassIf($error !== null, 'is-invalid')
        ->attributeIf(filled($accept), 'accept', (string) $accept)
        ->attributeIf((bool) $required, 'required')
        ->attributeIf(filled($maxKb), 'data-max-kb', (string) (int) $maxKb)
        ->attributeIf(filled($maxKb), 'data-max-message', __('forms.upload.too_large', ['max' => (string) $guardLabel]))
        ->attributeIf($error !== null, 'aria-invalid', 'true')
        ->attributeIf($error !== null, 'aria-describedby', form_field_id($name).'_error');

    $passthrough = form_passthrough_attributes($attributes);

    $control = $control->attributes($passthrough);

    // Bootstrap's border-danger is !important, so it wins over the zone's own
    // dashed border colour: an invalid slot is visible even though the input
    // that carries .is-invalid is hidden.
    $zone = html()->label()
        ->class('upload-zone d-block')
        ->addClassIf($error !== null, 'border-danger')
        ->attribute('for', $fieldId)
        ->addChild(html()->i()->class((string) $icon)->attribute('aria-hidden', 'true'))
        ->addChild(html()->element('h5')->text(
            $hasCurrentFile ? __('forms.upload.replace') : __('forms.upload.prompt')
        ))
        ->addChildIf(filled($hint), html()->p()
            ->id(form_field_id($name).'_hint')
            ->text((string) $hint))
        ->addChild($control);

    $currentFile = $hasCurrentFile
        ? html()->div()->class('uploaded-file')->addChildren([
            html()->div()->class('file-icon')->addChild(
                html()->i()->class('fa-solid fa-file-lines')->attribute('aria-hidden', 'true')
            ),
            html()->div()->class('file-details')->addChildren([
                html()->div()->class('file-name')->text((string) $currentName),
                html()->div()->class('file-meta')->text(__('forms.upload.replace_note')),
            ]),
            html()->div()->class('file-actions')->addChild(
                html()->a()
                    ->attribute('href', (string) $currentUrl)
                    ->class('btn btn-sm btn-outline')
                    ->addChild(html()->i()
                        ->class('fa-solid fa-download')
                        ->attribute('aria-hidden', 'true'))
                    ->addChild(e(__('forms.upload.download')))
            ),
        ])
        : null;
@endphp

<x-form.group :name="$name" :label="$label" :required="$required" :for="$fieldId" :group-class="$groupClass">{!! $zone->render() !!}{!! $currentFile?->render() !!}</x-form.group>