docs: update portal for WRNexusJS 0.2.75

public/llms-full.txt

@@ -1,4 +1,4 @@
-# WRNexusJS 0.2.74 comprehensive documentation index
+# WRNexusJS 0.2.75 comprehensive documentation index
 
 Status: Private Developer Preview. Runtime: Bun. UI language: .wrn.
 This is the documentation application, not the framework monorepo.
@@ -40,7 +40,7 @@ This is the documentation application, not the framework monorepo.
 - https://wrnexusjs.dev/benchmarks
 - https://wrnexusjs.dev/roadmap
 - https://wrnexusjs.dev/changelog
-- https://wrnexusjs.dev/releases/0.2.74
+- https://wrnexusjs.dev/releases/0.2.75
 - https://wrnexusjs.dev/security
 - https://wrnexusjs.dev/support
 - https://wrnexusjs.dev/license
@@ -54,6 +54,7 @@ This is the documentation application, not the framework monorepo.
 - https://wrnexusjs.dev/packages/csr
 - https://wrnexusjs.dev/packages/db
 - https://wrnexusjs.dev/packages/dev-server
+- https://wrnexusjs.dev/packages/dev-toolbar
 - https://wrnexusjs.dev/packages/encryption
 - https://wrnexusjs.dev/packages/helpers
 - https://wrnexusjs.dev/packages/i18n

public/llms.txt

@@ -1,6 +1,6 @@
-# WRNexusJS documentation 0.2.74
+# WRNexusJS documentation 0.2.75
 
-Status: Private Developer Preview. This site documents 26 release-aligned packages.
+Status: Private Developer Preview. This site documents 27 release-aligned packages.
 
 # WrNexus
 
@@ -12903,7 +12903,7 @@ Events: none
 
 # Installed package documentation
 
-The following README files and declarations come from the installed private 0.2.74 release.
+The following README files and declarations come from the installed private 0.2.75 release.
 
 ## @wrnexus/ai
 
@@ -16194,6 +16194,8 @@ import { Router } from '@wrnexus/router';
 import { ResolvedTheme, MobileConfig, PwaConfig, StylesConfig, ThemeConfig } from '@wrnexus/styles';
 import { ResolvedI18n, I18nConfig } from '@wrnexus/i18n';
 import { StorageConfig } from '@wrnexus/uploader';
+import { DevToolbarConfig } from '@wrnexus/dev-toolbar/types';
+import { DevToolbarCollector } from '@wrnexus/dev-toolbar/server';
 import { IncomingMessage, ServerResponse, Server } from 'node:http';
 
 /** Exit code a dev-server child uses to request a clean supervisor restart. */
@@ -16228,6 +16230,7 @@ declare class HmrHub {
     private version;
     add(ws: Socket): void;
     remove(ws: Socket): void;
+    broadcastJson(message: unknown): void;
     broadcast(message: HmrMessage): void;
     get size(): number;
     css(): void;
@@ -16310,6 +16313,11 @@ interface RuntimeDeps {
      * bus (use the Redis pub/sub driver). Enables realtime across multiple apps.
      */
     realtimeBus?: RealtimeBus;
+    devToolbar?: {
+        config: DevToolbarConfig;
+        collector: DevToolbarCollector;
+        root: string;
+    };
 }
 interface UpgradeServer {
     upgrade(req: Request, opts: {
@@ -16607,6 +16615,7 @@ interface ServeOptions {
     storage?: StorageConfig;
     mobile?: MobileConfig;
     pwa?: PwaConfig | false;
+    devToolbar?: boolean | DevToolbarConfig;
 }
 interface RunningServer {
     port: number;
@@ -16622,6 +16631,45 @@ export { type AssetServer, type FetchHandler, type GatewayApp, type GatewayAuth,
 
 ---
 
+## @wrnexus/dev-toolbar
+
+Documentation URL: https://wrnexusjs.dev/packages/dev-toolbar
+
+# @wrnexus/dev-toolbar
+
+Development-only page quality toolbar for WRNexusJS.
+
+## Features
+
+- Runtime, resource and unhandled promise error capture
+- Accessibility, SEO, image, media, color, HTML, form, link, responsive and security checks
+- Performance and network observations
+- Element highlighting and issue filtering
+- Server-side issue collector
+- Development-only asset strings for direct serving by `@wrnexus/dev-server`
+- Safe open-in-editor helper
+
+## Dev-server integration
+
+Serve `DEV_TOOLBAR_RUNTIME` at `/__wrnexus/dev-toolbar.js` and `DEV_TOOLBAR_CSS` at `/__wrnexus/dev-toolbar.css`, then inject this before `</body>` in development:
+
+```html
+<script type="module" src="/__wrnexus/dev-toolbar.js" data-wrnexus-dev-toolbar></script>
+```
+
+The browser runtime exposes `window.__wrnexusDevToolbar`.
+
+### Exported TypeScript declarations
+
+```ts
+export { DevToolbarCategory, DevToolbarClientApi, DevToolbarConfig, DevToolbarElementTarget, DevToolbarFix, DevToolbarIssue, DevToolbarMetrics, DevToolbarPageReport, DevToolbarServerMessage, DevToolbarSeverity, DevToolbarSourceLocation } from './types.js';
+export { DEV_TOOLBAR_RULES, DevToolbarRule, DevToolbarRuleContext, accessibilityRules, accessibleName, colorRules, contrastRatio, createFingerprint, createIssue, effectiveBackground, formRules, getStableSelector, htmlRules, imageRules, isVisible, linkRules, luminance, mediaRules, parseRgb, parseSource, performanceRules, responsiveRules, runDevToolbarRules, securityRules, seoRules } from './rules/index.js';
+export { DevToolbarApp, DevToolbarCollector, DevToolbarIssueListener, DevToolbarRegistry, DevToolbarRouteOptions, OpenEditorOptions, OpenEditorRequest, buildEditorCommand, createDevToolbarCollector, createDevToolbarRegistry, createServerIssue, handleDevToolbarRoute, issueFromError, openInEditor, resolveEditorFile, serializeDevToolbarJson } from './server/index.js';
+export { DEV_TOOLBAR_CSS, DEV_TOOLBAR_RUNTIME } from './client/index.js';
+```
+
+---
+
 ## @wrnexus/encryption
 
 Documentation URL: https://wrnexusjs.dev/packages/encryption
@@ -19371,7 +19419,27 @@ interface PwaConfig {
     /** Service-worker cache key. Change it to invalidate existing PWA caches. */
     cacheName?: string;
 }
+type DevToolbarPosition = "bottom-center" | "bottom-left" | "bottom-right";
+interface DevToolbarConfig {
+    enabled?: boolean;
+    position?: DevToolbarPosition;
+    defaultOpen?: boolean;
+    keyboardShortcut?: string;
+    scanOnNavigation?: boolean;
+    scanOnHmr?: boolean;
+    openEditor?: boolean;
+    editor?: string;
+    rules?: Partial<Record<string, boolean>>;
+    severity?: Partial<Record<string, "error" | "warning" | "info" | "suggestion">>;
+    ignoredRules?: string[];
+    ignoredPaths?: string[];
+    slowRequestMs?: number;
+    largeImageBytes?: number;
+    veryLargeImageBytes?: number;
+}
 interface AppConfig {
+    /** Development-only page diagnostics toolbar. Enabled by default in development. */
+    devToolbar?: boolean | DevToolbarConfig;
     /** Raw HTML appended to every page's `<head>` (e.g. CDN stylesheet links). */
     head?: string | string[];
     /** Global SEO defaults merged with every page's exported `meta`. */