docs: update portal for WRNexusJS 0.2.74

This commit is contained in:
2026-07-21 11:23:06 +05:30
parent 11e13331fa
commit 71635ba08d
979 changed files with 4306 additions and 4163 deletions
+60 -19
View File
@@ -10,16 +10,27 @@ page PublicHeadercomponent {
<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.73</a><button data-wire-theme-toggle class="theme-button" aria-label="Toggle color theme" title="Toggle color theme">◐</button></div>
<div class="topbar-actions"><a class="preview-pill" href="/access">Private preview · v0.2.74</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">PublicHeader</span></nav><section class="doc-intro"><span class="eyebrow">layout component</span><h1>PublicHeader</h1><p>Reusable public header component.</p><div class="doc-meta"><span>@wrnexus/ui 0.2.73</span><span>22 props</span><span>2 slots</span><span>1 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;PublicHeader
<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">PublicHeader</span></nav><section class="doc-intro"><span class="eyebrow">layout component</span><h1>PublicHeader</h1><p>Reusable public header component.</p><div class="doc-meta"><span>@wrnexus/ui 0.2.74</span><span>30 props</span><span>2 slots</span><span>1 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;PublicHeader
homeHref=&quot;/&quot;
brandName=&quot;WRNexusJS&quot;
brandTagline=&quot;Identity Cloud&quot;
brandAriaLabel=&quot;WRNexusJS home&quot;
brandIcon=&quot;icon-[lucide--blocks]&quot;
/&gt;</code></pre><p>Legacy mount name: <code>data-component=&quot;PublicHeader&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>class</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;&quot;</code></td></tr><tr><td><code>homeHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/&quot;</code></td></tr><tr><td><code>brandName</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;WRNexusJS&quot;</code></td></tr><tr><td><code>brandTagline</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Identity Cloud&quot;</code></td></tr><tr><td><code>brandAriaLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;WRNexusJS home&quot;</code></td></tr><tr><td><code>brandIcon</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;icon-[lucide--blocks]&quot;</code></td></tr><tr><td><code>pricingLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Pricing&quot;</code></td></tr><tr><td><code>pricingHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/pricing&quot;</code></td></tr><tr><td><code>statusLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;All systems operational&quot;</code></td></tr><tr><td><code>statusHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/status&quot;</code></td></tr><tr><td><code>signInLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Sign in&quot;</code></td></tr><tr><td><code>signInHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/sign-in&quot;</code></td></tr><tr><td><code>primaryLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Start free&quot;</code></td></tr><tr><td><code>primaryHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/sign-up&quot;</code></td></tr><tr><td><code>showStatus</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showThemeToggle</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showSignIn</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showPrimaryAction</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>productLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Product&quot;</code></td></tr><tr><td><code>solutionsLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Solutions&quot;</code></td></tr><tr><td><code>developersLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Developers&quot;</code></td></tr><tr><td><code>resourcesLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Resources&quot;</code></td></tr></tbody></table></div></section><section id="slots"><h2>Slots</h2><ul><li><code>navigation</code></li><li><code>actions</code></li></ul></section><section id="events"><h2>Events</h2><ul><li><code>click</code></li></ul></section><section id="source"><h2>Source contract</h2><p>Installed source: <code>components/PublicHeader.wrn</code></p><pre data-language="wrn"><code>component PublicHeader &#123;
/&gt;</code></pre><p>Legacy mount name: <code>data-component=&quot;PublicHeader&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>class</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;&quot;</code></td></tr><tr><td><code>homeHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/&quot;</code></td></tr><tr><td><code>brandName</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;WRNexusJS&quot;</code></td></tr><tr><td><code>brandTagline</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Identity Cloud&quot;</code></td></tr><tr><td><code>brandAriaLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;WRNexusJS home&quot;</code></td></tr><tr><td><code>brandIcon</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;icon-[lucide--blocks]&quot;</code></td></tr><tr><td><code>pricingLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Pricing&quot;</code></td></tr><tr><td><code>pricingHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/pricing&quot;</code></td></tr><tr><td><code>statusLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;All systems operational&quot;</code></td></tr><tr><td><code>statusHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/status&quot;</code></td></tr><tr><td><code>signInLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Sign in&quot;</code></td></tr><tr><td><code>signInHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/sign-in&quot;</code></td></tr><tr><td><code>primaryLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Start free&quot;</code></td></tr><tr><td><code>primaryHref</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;/sign-up&quot;</code></td></tr><tr><td><code>showStatus</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showThemeToggle</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showSignIn</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showPrimaryAction</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>productLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Product&quot;</code></td></tr><tr><td><code>solutionsLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Solutions&quot;</code></td></tr><tr><td><code>developersLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Developers&quot;</code></td></tr><tr><td><code>resourcesLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Resources&quot;</code></td></tr><tr><td><code>navigationAriaLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Main navigation&quot;</code></td></tr><tr><td><code>themeToggleLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Toggle color theme&quot;</code></td></tr><tr><td><code>mobileMenuOpenLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Open navigation menu&quot;</code></td></tr><tr><td><code>mobileMenuCloseLabel</code></td><td><code>string</code></td><td>Optional</td><td><code>&quot;Close navigation menu&quot;</code></td></tr><tr><td><code>navigationItems</code></td><td><code>PublicHeaderNavigationItem[]</code></td><td>Optional</td><td><code>[]</code></td></tr><tr><td><code>actionItems</code></td><td><code>PublicHeaderActionItem[]</code></td><td>Optional</td><td><code>[]</code></td></tr><tr><td><code>showNavigation</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr><tr><td><code>showMobileThemeToggle</code></td><td><code>boolean</code></td><td>Optional</td><td><code>true</code></td></tr></tbody></table></div></section><section id="slots"><h2>Slots</h2><ul><li><code>navigation</code></li><li><code>actions</code></li></ul></section><section id="events"><h2>Events</h2><ul><li><code>click</code></li></ul></section><section id="source"><h2>Source contract</h2><p>Installed source: <code>components/PublicHeader.wrn</code></p><pre data-language="wrn"><code>component PublicHeader &#123;
types &#123;
interface PublicHeaderNavigationItem &#123;
label: string
href: string
ariaLabel?: string
target?: string
&#125;
interface PublicHeaderActionItem extends PublicHeaderNavigationItem &#123;
variant?: &quot;primary&quot; | &quot;secondary&quot; | &quot;ghost&quot;
&#125;
&#125;
props &#123;
class: string = &quot;&quot;
homeHref: string = &quot;/&quot;
@@ -43,6 +54,14 @@ page PublicHeadercomponent {
solutionsLabel: string = &quot;Solutions&quot;
developersLabel: string = &quot;Developers&quot;
resourcesLabel: string = &quot;Resources&quot;
navigationAriaLabel: string = &quot;Main navigation&quot;
themeToggleLabel: string = &quot;Toggle color theme&quot;
mobileMenuOpenLabel: string = &quot;Open navigation menu&quot;
mobileMenuCloseLabel: string = &quot;Close navigation menu&quot;
navigationItems: PublicHeaderNavigationItem[] = []
actionItems: PublicHeaderActionItem[] = []
showNavigation: boolean = true
showMobileThemeToggle: boolean = true
&#125;
state activeMenu = &quot;&quot;
state mobileMenuOpen = false
@@ -89,11 +108,17 @@ page PublicHeadercomponent {
&lt;/a&gt;
&lt;!-- Desktop navigation --&gt;
&lt;nav
aria-label=&quot;Main navigation&quot;
aria-label=&quot;&#123;navigationAriaLabel&#125;&quot;
data-show=&quot;showNavigation&quot;
class=&quot;hidden items-center gap-1 lg:flex&quot;
&gt;
&lt;slot name=&quot;navigation&quot;&gt;
&lt;!-- Product --&gt;
&#123;#if navigationItems.length &gt; 0&#125;
&#123;#each navigationItems as item&#125;
&lt;a href=&quot;&#123;item.href&#125;&quot; aria-label=&quot;&#123;item.ariaLabel || item.label&#125;&quot; target=&quot;&#123;item.target || '_self'&#125;&quot; class=&quot;inline-flex h-10 items-center rounded-xl px-3.5 text-sm font-semibold text-slate-700 transition hover:bg-slate-100 hover:text-slate-950 focus:outline-none focus-visible:ring-2 focus-visible:ring-indigo-500 dark:text-slate-300 dark:hover:bg-white/5 dark:hover:text-white&quot;&gt;&#123;item.label&#125;&lt;/a&gt;
&#123;/each&#125;
&#123;:else&#125;
&lt;!-- Product --&gt;
&lt;button
type=&quot;button&quot;
@click=&quot;activeMenu = activeMenu === 'product' ? '' : 'product'&quot;
@@ -189,12 +214,18 @@ page PublicHeadercomponent {
&gt;
&#123;pricingLabel&#125;
&lt;/a&gt;
&lt;/slot&gt;
&#123;/if&#125;
&lt;/slot&gt;
&lt;/nav&gt;
&lt;!-- Desktop actions --&gt;
&lt;div class=&quot;hidden items-center gap-2 lg:flex&quot;&gt;
&lt;slot name=&quot;actions&quot;&gt;
&lt;a data-show=&quot;showStatus&quot;
&#123;#if actionItems.length &gt; 0&#125;
&#123;#each actionItems as item&#125;
&lt;a href=&quot;&#123;item.href&#125;&quot; aria-label=&quot;&#123;item.ariaLabel || item.label&#125;&quot; target=&quot;&#123;item.target || '_self'&#125;&quot; class=&quot;wire-public-header-action wire-public-header-action--&#123;item.variant || 'secondary'&#125;&quot;&gt;&#123;item.label&#125;&#123;#if item.variant === 'primary'&#125;&lt;span aria-hidden=&quot;true&quot;&gt;→&lt;/span&gt;&#123;/if&#125;&lt;/a&gt;
&#123;/each&#125;
&#123;:else&#125;
&lt;a data-show=&quot;showStatus&quot;
href=&quot;&#123;statusHref&#125;&quot;
class=&quot;mr-1 inline-flex items-center gap-2 rounded-xl px-3 py-2 text-xs font-semibold text-slate-500 transition hover:bg-slate-100 hover:text-slate-950 dark:text-slate-400 dark:hover:bg-white/5 dark:hover:text-white&quot;
&gt;
@@ -210,8 +241,8 @@ page PublicHeadercomponent {
&lt;button data-show=&quot;showThemeToggle&quot;
type=&quot;button&quot;
data-wire-theme-toggle
aria-label=&quot;Toggle color theme&quot;
title=&quot;Toggle color theme&quot;
aria-label=&quot;&#123;themeToggleLabel&#125;&quot;
title=&quot;&#123;themeToggleLabel&#125;&quot;
class=&quot;grid h-10 w-10 place-items-center rounded-xl border border-slate-200 bg-white text-slate-600 shadow-sm transition hover:border-slate-300 hover:bg-slate-100 hover:text-slate-950 focus:outline-none focus-visible:ring-2 focus-visible:ring-indigo-500 dark:border-white/10 dark:bg-white/5 dark:text-slate-300 dark:hover:border-white/20 dark:hover:bg-white/10 dark:hover:text-white&quot;
&gt;
&lt;span class=&quot;icon-[lucide--moon] h-4 w-4 dark:hidden&quot; aria-hidden=&quot;true&quot; &gt;
@@ -219,7 +250,7 @@ page PublicHeadercomponent {
&lt;span class=&quot;icon-[lucide--sun] hidden h-4 w-4 dark:block&quot; aria-hidden=&quot;true&quot; &gt;
&lt;/span&gt;
&lt;span class=&quot;sr-only&quot;&gt;
Toggle color theme
&#123;themeToggleLabel&#125;
&lt;/span&gt;
&lt;/button&gt;
&lt;a data-show=&quot;showSignIn&quot;
@@ -237,15 +268,16 @@ page PublicHeadercomponent {
&lt;span class=&quot;icon-[lucide--arrow-right] h-4 w-4 transition-transform group-hover:translate-x-0.5&quot; aria-hidden=&quot;true&quot; &gt;
&lt;/span&gt;
&lt;/a&gt;
&lt;/slot&gt;
&#123;/if&#125;
&lt;/slot&gt;
&lt;/div&gt;
&lt;!-- Mobile actions --&gt;
&lt;div class=&quot;flex items-center gap-2 lg:hidden&quot;&gt;
&lt;button
&lt;button data-show=&quot;showThemeToggle &amp;&amp; showMobileThemeToggle&quot;
type=&quot;button&quot;
data-wire-theme-toggle
aria-label=&quot;Toggle color theme&quot;
title=&quot;Toggle color theme&quot;
aria-label=&quot;&#123;themeToggleLabel&#125;&quot;
title=&quot;&#123;themeToggleLabel&#125;&quot;
class=&quot;grid h-10 w-10 place-items-center rounded-xl border border-slate-200 bg-white text-slate-600 shadow-sm transition hover:bg-slate-100 hover:text-slate-950 focus:outline-none focus-visible:ring-2 focus-visible:ring-indigo-500 dark:border-white/10 dark:bg-white/5 dark:text-slate-300 dark:hover:bg-white/10 dark:hover:text-white&quot;
&gt;
&lt;span class=&quot;icon-[lucide--moon] h-4 w-4 dark:hidden&quot; aria-hidden=&quot;true&quot; &gt;
@@ -256,7 +288,7 @@ page PublicHeadercomponent {
&lt;button
type=&quot;button&quot;
@click=&quot;mobileMenuOpen = !mobileMenuOpen&quot;
aria-label=&quot;&#123;mobileMenuOpen ? 'Close navigation menu' : 'Open navigation menu'&#125;&quot;
aria-label=&quot;&#123;mobileMenuOpen ? mobileMenuCloseLabel : mobileMenuOpenLabel&#125;&quot;
aria-expanded=&quot;&#123;mobileMenuOpen&#125;&quot;
aria-controls=&quot;public-mobile-navigation&quot;
class=&quot;grid h-10 w-10 place-items-center rounded-xl border border-slate-200 bg-white text-slate-700 shadow-sm transition hover:bg-slate-100 hover:text-slate-950 focus:outline-none focus-visible:ring-2 focus-visible:ring-indigo-500 dark:border-white/10 dark:bg-white/5 dark:text-slate-200 dark:hover:bg-white/10 dark:hover:text-white&quot;
@@ -272,7 +304,7 @@ page PublicHeadercomponent {
&lt;/div&gt;
&lt;/div&gt;
&lt;!-- Outside-click backdrop --&gt;
&lt;button type=&quot;button&quot; data-show=&quot;activeMenu !== ''&quot; @click=&quot;activeMenu = ''&quot; aria-label=&quot;Close navigation menu&quot; class=&quot;fixed inset-0 z-40 hidden cursor-default bg-transparent lg:block&quot; class:hidden=&quot;activeMenu === ''&quot; class:block=&quot;activeMenu !== ''&quot; &gt;
&lt;button type=&quot;button&quot; data-show=&quot;activeMenu !== ''&quot; @click=&quot;activeMenu = ''&quot; aria-label=&quot;&#123;mobileMenuCloseLabel&#125;&quot; class=&quot;fixed inset-0 z-40 hidden cursor-default bg-transparent lg:block&quot; class:hidden=&quot;activeMenu === ''&quot; class:block=&quot;activeMenu !== ''&quot; &gt;
&lt;/button&gt;
&lt;!-- Desktop mega menus --&gt;
&lt;div
@@ -312,13 +344,22 @@ page PublicHeadercomponent {
class:hidden=&quot;!mobileMenuOpen&quot;
class:block=&quot;mobileMenuOpen&quot;
&gt;
&lt;PublicMobileNavigation /&gt;
&lt;/div&gt;
&#123;#if navigationItems.length &gt; 0 || actionItems.length &gt; 0&#125;
&lt;nav aria-label=&quot;&#123;navigationAriaLabel&#125;&quot; class=&quot;border-t border-slate-200 bg-white px-5 py-5 shadow-xl dark:border-white/10 dark:bg-slate-950&quot;&gt;
&lt;div class=&quot;grid gap-2&quot;&gt;
&#123;#each navigationItems as item&#125;&lt;a href=&quot;&#123;item.href&#125;&quot; target=&quot;&#123;item.target || '_self'&#125;&quot; class=&quot;rounded-xl px-4 py-3 text-sm font-semibold text-slate-700 hover:bg-slate-100 dark:text-slate-200 dark:hover:bg-white/5&quot;&gt;&#123;item.label&#125;&lt;/a&gt;&#123;/each&#125;
&#123;#each actionItems as item&#125;&lt;a href=&quot;&#123;item.href&#125;&quot; target=&quot;&#123;item.target || '_self'&#125;&quot; class=&quot;wire-public-header-action wire-public-header-action--&#123;item.variant || 'secondary'&#125;&quot;&gt;&#123;item.label&#125;&lt;/a&gt;&#123;/each&#125;
&lt;/div&gt;
&lt;/nav&gt;
&#123;:else&#125;
&lt;PublicMobileNavigation /&gt;
&#123;/if&#125;
&lt;/div&gt;
&lt;/header&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.73</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>
<footer><div class="footer-brand"><span class="footer-mark" aria-hidden="true">W</span><p><strong>WRNexusJS 0.2.74</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>
}