WRNexusJSDoc/app/pages/components/file-upload-primitive.wrn

page fileuploadcomponent {
  seo {
    title = "file-upload component"
    description = "Reusable file-upload component."
  }

  view {
    <div class="docs-shell">
      <SkipLink label="Skip to content" href="#main" class="docs-skip-link" />
      <header class="topbar">
        <a class="brand" href="/"><span>W</span> WRNexusJS</a>
        <nav aria-label="Primary"><a href="/getting-started">Get started</a><a href="/packages">Packages</a><a href="/components">Components</a><a href="/language">Language</a><a href="/architecture">Architecture</a></nav>
        <div class="topbar-actions"><a class="preview-pill" href="/access">Private preview · v0.2.77</a><button data-wire-theme-toggle class="theme-button" aria-label="Toggle color theme" title="Toggle color theme">◐</button></div>
      </header>
      <div class="mobile-doc-nav"><details><summary>Browse documentation</summary><nav><a href="/getting-started">Get started</a><a href="/packages">Packages</a><a href="/components">Components</a><a href="/language">Language</a><a href="/architecture">Architecture</a><a href="/tutorial">Tutorial</a><a href="/guides/project-structure">Guides</a><a href="/examples">Examples</a><a href="/search">Search</a></nav></details></div>
      <main class="portal-main docs-layout component-detail-page"><article id="main" class="documentation prose standalone"><nav class="breadcrumbs" aria-label="Breadcrumb"><a href="/">Home</a><span>/</span><a href="/components">Components</a><span>/</span><span aria-current="page">file-upload</span></nav><section class="doc-intro"><span class="eyebrow">core component</span><h1>file-upload</h1><p>Reusable file-upload component.</p><div class="doc-meta"><span>@wrnexus/ui 0.2.77</span><span>7 props</span><span>0 slots</span><span>0 events</span></div></section><section id="usage"><h2>Usage</h2><p>Components are auto-discovered. Use the component directly in any <code>.wrn</code> view:</p><pre data-language="wrn"><code>&lt;file-upload
  store=&quot;public&quot;
  endpoint=&quot;/api/upload&quot;
  accept=&quot;accept&quot;
  multiple=&quot;false&quot;
  max=&quot;0&quot;
/&gt;</code></pre><p>Legacy mount name: <code>data-component=&quot;file-upload&quot;</code>.</p></section><section id="props"><h2>Props and attributes</h2><div class="table-wrap"><table><thead><tr><th>Prop</th><th>Type</th><th>Requirement</th><th>Default</th></tr></thead><tbody><tr><td><code>store</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;public&quot;</code></td></tr><tr><td><code>endpoint</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/api/upload&quot;</code></td></tr><tr><td><code>accept</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;&quot;</code></td></tr><tr><td><code>multiple</code></td><td><code>boolean</code></td><td>Optional</td><td><code>false</code></td></tr><tr><td><code>max</code></td><td><code>number</code></td><td>Optional</td><td><code>0</code></td></tr><tr><td><code>label</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Drag files here or click to browse&quot;</code></td></tr><tr><td><code>class</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;&quot;</code></td></tr></tbody></table></div></section><section id="slots"><h2>Slots</h2><p>This component does not declare a slot.</p></section><section id="events"><h2>Events</h2><p>This component does not declare a custom event.</p></section><section id="source"><h2>Source contract</h2><p>Installed source: <code>components/file-upload.wrn</code></p><pre data-language="wrn"><code>// Drag-and-drop file uploader with per-file progress. Progressive enhancement:
// the markup is inert until /__wrnexus/uploader.js loads (auto-injected when a
// page contains `data-uploader`). Pairs with `handleUpload` on the server —
// files POST to `endpoint`, which returns `&#123; ok, files:[&#123; key, url, … &#125;] &#125;`.
//
//   &lt;div data-component=&quot;file-upload&quot; store=&quot;public&quot; endpoint=&quot;/api/upload&quot;
//        accept=&quot;image/*&quot; max=&quot;10000000&quot; multiple=&quot;true&quot;&gt;
        &lt;/div&gt;
component FileUpload &#123;
  props &#123;
    store = &quot;public&quot;
    endpoint = &quot;/api/upload&quot;
    accept = &quot;&quot;
    multiple = false
    max = 0
    label = &quot;Drag files here or click to browse&quot;
    class = &quot;&quot;
  &#125;
  view &#123;
        &lt;div class=&quot;wire-fileupload &#123;class&#125;&quot; data-uploader=&quot;&#123;store&#125;&quot; data-endpoint=&quot;&#123;endpoint&#125;&quot; data-accept=&quot;&#123;accept&#125;&quot; data-multiple=&quot;&#123;multiple&#125;&quot; data-max=&quot;&#123;max&#125;&quot; data-label=&quot;&#123;label&#125;&quot;&gt;
        &lt;/div&gt;
    &#125;
&#125;
</code></pre></section></article><aside class="on-this-page"><h2>On this page</h2><nav><a href="#usage">Usage</a><a href="#props">Props and attributes</a><a href="#slots">Slots</a><a href="#events">Events</a><a href="#source">Source contract</a></nav></aside></main>
      <footer><div class="footer-brand"><span class="footer-mark" aria-hidden="true">W</span><p><strong>WRNexusJS 0.2.77</strong><span>Complete API documentation generated from installed package declarations.</span></p></div><nav aria-label="Footer"><a href="/packages">All packages</a><a href="/getting-started">Get started</a><a href="/security">Security</a><a href="/support">Support</a><a href="/llms.txt">AI guide</a></nav><p class="footer-meta">Private Developer Preview · Bun-native</p></footer>
      <BackToTop />
    </div>
  }
}