feat(toolbar): add demo path indicator and use JSDoc comments

Author: josephfusco

examples/next/toolbar-demo/example-app/lib/toolbar.ts

@@ -1,7 +1,9 @@
 import { Toolbar } from '@wpengine/hwp-toolbar';
 
-// Singleton toolbar instance
-// This ensures the same toolbar state is shared across the app
+/**
+ * Singleton toolbar instance
+ * This ensures the same toolbar state is shared across the app
+ */
 export const toolbar = new Toolbar({
   onPreviewChange: (enabled) => {
     console.log('Preview mode:', enabled);
@@ -10,7 +12,11 @@ export const toolbar = new Toolbar({
   },
 });
 
-// Register custom nodes
+/**
+ * Register custom nodes
+ */
 toolbar.register('home', 'Home', () => {
   window.location.href = '/';
 });
+
+toolbar.register('demo-path', 'examples/next/toolbar-demo');

examples/vanilla/toolbar-demo/example-app/src/main.js

@@ -4,41 +4,37 @@ import './style.css';
 
 const WP_URL = import.meta.env.VITE_WP_URL;
 
-// ============================================================================
-// Initialize Toolbar
-// ============================================================================
-
+/**
+ * Initialize Toolbar
+ */
 const toolbar = new Toolbar({
   onPreviewChange: (enabled) => {
     console.log('Preview mode:', enabled);
     alert(`Preview mode: ${enabled ? 'ON' : 'OFF'}\n\nIn production, this would trigger Next.js/framework preview mode`);
   }
 });
 
-// Render toolbar to DOM
 const renderer = new VanillaRenderer(toolbar, 'toolbar');
 
-// ============================================================================
-// Register Custom Nodes
-// ============================================================================
-
+/**
+ * Register Custom Nodes
+ */
 toolbar.register('home', 'Home', () => {
   window.location.href = '/';
 });
 
-// ============================================================================
-// State Management
-// ============================================================================
+toolbar.register('demo-path', 'examples/vanilla/toolbar-demo');
 
-// Subscribe to state changes for debugging display
+/**
+ * State Management
+ */
 toolbar.subscribe((nodes, state) => {
   document.getElementById('state').textContent = JSON.stringify(state, null, 2);
 });
 
-// ============================================================================
-// Demo Actions
-// ============================================================================
-
+/**
+ * Demo Actions
+ */
 window.login = async () => {
   try {
     const response = await fetch(`${WP_URL}/?rest_route=/wp/v2/users/1`);