@replicated/portal-components 0.0.2 → 0.0.3

package/components/metadata/registry.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.2",
-  "generatedAt": "2025-11-18T13:16:42Z",
+  "version": "0.0.3",
+  "generatedAt": "2025-12-12T22:19:20Z",
   "components": [
     {
       "name": "Button",
@@ -293,6 +293,87 @@
       "relatedComponents": [
         "Button"
       ]
+    },
+    {
+      "name": "TopNav",
+      "displayName": "Top Navigation",
+      "versionIntroduced": "0.0.2",
+      "stability": "experimental",
+      "category": "layout",
+      "tags": [
+        "navigation",
+        "hero",
+        "tabs"
+      ],
+      "description": "Gradient hero banner containing the primary dashboard navigation tabs. Mirrors the default portal shell shown after login.",
+      "props": [
+        {
+          "name": "links",
+          "type": "Array<{ label: string; icon: ReactNode }>",
+          "required": false,
+          "description": "Override the default portal links. Leave undefined to render the standard set (Dashboard, Download, etc.)."
+        },
+        {
+          "name": "hiddenLabels",
+          "type": "string[]",
+          "required": false,
+          "description": "List of link labels to hide from the default set."
+        },
+        {
+          "name": "additionalLinks",
+          "type": "Array<{ label: string; icon: ReactNode }>",
+          "required": false,
+          "description": "Links appended after the base set. Useful for vendor-specific pages."
+        },
+        {
+          "name": "order",
+          "type": "string[]",
+          "required": false,
+          "description": "Optional ordering hint. Labels listed here are shown first in the specified order; remaining links follow in their original sequence."
+        },
+        {
+          "name": "userMenuLabel",
+          "type": "string",
+          "required": false,
+          "defaultValue": "\"Team: Example\"",
+          "description": "Text to render in the top-right account dropdown trigger."
+        }
+      ],
+      "composition": {
+        "requiredParents": [],
+        "requiredChildren": [],
+        "forbiddenChildren": [],
+        "slots": []
+      },
+      "examples": [
+        {
+          "id": "default-links",
+          "description": "Use the standard portal sections as tabs.",
+          "scenario": "Dashboard shell after successful login.",
+          "code": "<TopNav links={[{ label: \"Dashboard\", icon: <DashboardIcon /> }, { label: \"Download\", icon: <DownloadIcon /> }]} />"
+        }
+      ],
+      "behavior": {
+        "mode": "server",
+        "requiresJavaScript": false,
+        "dataAccess": "none",
+        "managesState": "presentational"
+      },
+      "accessibility": {
+        "aria": [],
+        "keyboard": [],
+        "screenReader": [],
+        "focusManagement": []
+      },
+      "performance": {
+        "bundleImpact": "low",
+        "notes": "Purely presentational markup; icons provided by callers.",
+        "lazyLoadable": true,
+        "virtualization": false
+      },
+      "relatedComponents": [
+        "Login"
+      ]
     }
   ]
 }

package/components/metadata/registry.md

@@ -1,7 +1,7 @@
 # Component Registry
 
-- Version: 0.0.2
-- Generated: 2025-11-18T13:16:42Z
+- Version: 0.0.3
+- Generated: 2025-12-12T22:19:20Z
 
 ## Button
 
@@ -100,3 +100,28 @@ export async function continueWithEmail(email: string) {
 
 <Login onContinue={continueWithEmail} />
 ```
+
+---
+
+## Top Navigation
+
+Gradient hero banner containing the primary dashboard navigation tabs. Mirrors the default portal shell shown after login.
+
+**Category:** layout
+**Stability:** experimental
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| links | `Array<{ label: string; icon: ReactNode }>` | No | Override the default portal links. Leave undefined to render the standard set (Dashboard, Download, etc.). |
+| hiddenLabels | `string[]` | No | List of link labels to hide from the default set. |
+| additionalLinks | `Array<{ label: string; icon: ReactNode }>` | No | Links appended after the base set. Useful for vendor-specific pages. |
+| order | `string[]` | No | Optional ordering hint. Labels listed here are shown first in the specified order; remaining links follow in their original sequence. |
+| userMenuLabel | `string` | No | Text to render in the top-right account dropdown trigger. |
+
+**Examples**
+
+**Use the standard portal sections as tabs.**
+
+```tsx
+<TopNav links={[{ label: "Dashboard", icon: <DashboardIcon /> }, { label: "Download", icon: <DownloadIcon /> }]} />
+```