@voltro/ui-shadcn 0.66.0 → 0.67.0

package/CHANGELOG.md

@@ -39,6 +39,58 @@ _Changes staged for the next release accumulate here (rolled up from
 
 ---
 
+## [0.67.0] — 2026-09-07
+
+### ⚠ BREAKING
+
+- **@voltro/client, @voltro/protocol, @voltro/runtime, @voltro/cli, @voltro/web** — Confirmed optimistic writes now reconcile against a token-bound post-ACK primary snapshot, never an unrelated delta, changed row or timeout. Matching snapshots retire only covered previews; server normalisation and later writers remain authoritative. Same-tick acknowledgements coalesce, and affected cache entries preserve primary consistency across same-subject reconnects. Migration: deploy matching client/server framework versions together and account for an additional subscription read per affected acknowledgement group; affected entries use primary snapshots instead of replica reads/delta-resume for their cache lifetime. Native hooks need no source rewrite. Direct callers of the public `supersedesConfirmedPatches(event, baseBefore, baseAfter)` helper must migrate to `(event, reconciliationToken)` using the token of the post-ACK read, or use the native `SubscriptionCache`; row comparison cannot be mechanically rewritten into causal proof.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/01_subscription-reconciliation`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+- **@voltro/cli** — `voltro support sentry <eventId>` is removed. It wrapped `sentry-cli sourcemaps explain`, which sentry-cli 3 dropped in favour of Sentry's in-product source-map debugger; `@voltro/cli` now depends on `@sentry/cli` 3, whose `execute(args, live)` takes a boolean. Migration: delete the invocation from scripts, CI jobs and runbooks and read the event's source-map resolution in Sentry itself. `voltro support collect` is unchanged.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/03_support-sentry-removed`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+- **@voltro/cli, @voltro/workflow, @voltro/testing** — `voltro test` runs on vitest 5, and `@voltro/workflow` names `vitest ^5.0.0` as its peer. Migration: set `vitest` and `@vitest/coverage-v8` to `^5.0.0` together in every app that declares them (the coverage provider peer-pins the exact vitest version), install, and run the suite once — vitest 5 clears mocks before each test by default, fails a test whose async assertion was not awaited, and no longer looks a config file up in ancestor directories. Scaffolded templates ship on 5.
+
+  **`voltro update` carries you across this** — codemod `0.67.0/02_vitest-5`. If you pin versions by hand and never run it, print the notes without changing anything: `voltro update --codemods-only --from <your current version> --dry-run` (this one ships in 0.67.0).
+
+### Added
+
+- **@voltro/ui-shadcn, @voltro/cli, @voltro/devtools, @voltro/devtools-ui** — Add the opt-in Signal brand stylesheet, accessible `SignalHeader` and pausable `SignalField` with reduced-motion and visibility handling. Development and production builds resolve the stylesheet from the same UI-kit installation; the in-browser devtools use the matching plum/violet palette and declare the Tailwind dependency required to compile their source stylesheet locally.
+
+  Code blocks use matching light/dark surfaces, code comparisons retain readable contrast, and the shared routes view uses a direct heading.
+
+  `DocsLayout` supports custom header and introduction slots and an optional desktop sidebar. Its mobile drawer uses native modal focus and Escape behavior; search contains keyboard focus and restores the opener when dismissed.
+
+  `VoltroWordmark` owns product badges and an operator warning tone. `SignalHeader` shares responsive brand geometry and an optional sticky reading surface; `AppShell` accepts a custom header slot. All first-party product headers and footers use this composition, including the compact local Devtools identity.
+
+  Shared `SignalPreferences`, `SignalSearch` and `SignalHeaderAction` align header controls across public and operating apps. Signal fields support both themes; `ProfileMenu` accepts a custom trigger and preserves an explicit System choice.
+
+### Changed
+
+- **@voltro/cli, @voltro/runtime, @voltro/database, @voltro/protocol, @voltro/voltro, @voltro/sql-mssql, @voltro/sql-turso, @voltro/workflow, @voltro/plugin-sso-saml, @voltro/plugin-sentry** — Dependency refresh: Effect 3.22.1 with the matching `@effect/*` patch releases (`@effect/cluster` 0.60.2, `@effect/sql-mssql` 0.54.0, `@effect/platform` 0.97.1, `@effect/rpc` 0.76.2, `@effect/sql` 0.52.1, `@effect/workflow` 0.19.1), `@libsql/client` 0.18.0 — and `@effect/sql-mssql` 0.54.0 flipped its TLS default to encrypt-and-verify, so the mssql dialect now passes `encrypt: false` explicitly for an unset connection to keep the documented modes (unset → plaintext, `sslmode=require` → encrypt without verification) — `@sentry/cli` 3, `xml-encryption` 6, vite 8.2.2, and the tracked minor/patch lines. The mssql patch for `@effect/cluster` — the four SQL fixes plus the shard-release backoff — was regenerated against 0.60.2 (upstream refactored `SqlMessageStorage`, so the 0.60.0 hunks no longer applied) and ships as `patches/@effect__cluster@0.60.2.patch`; `voltro add mssql` writes the new key. Projects scaffolded by the CLI record the pnpm that ran it, which is 12.x on the framework's own toolchain; pnpm 11+ replaced `onlyBuiltDependencies` with `allowBuilds`, and the framework's workspaces declare it.
+
+### Fixed
+
+- **@voltro/cli, @voltro/runtime, @voltro/database, @voltro/voltro** — The tunable readers that take `env = process.env` (`resolveEagerFallbackWarnIntervalMs`, `resolveWorkflowRecordingMode`, `readPollCeilingMs`, and the `SchedulingEnv` / `ReactiveEnv` / `InspectRingsEnv` shapes) accept a bare `NodeJS.ProcessEnv` again. They were typed as all-optional literals, which TypeScript's weak-type check rejects for `Dict<string>` the moment nothing in the compilation augments `ProcessEnv` — an app that compiles framework source with only `@types/node` (a mobile app, which declares no env) failed `tsc` on `dbMetrics.ts`. The parameters now carry an index signature.
+- **@voltro/client, @voltro/web** — The subscription recovery watchdog knows when it was throttled. A browser delays timers in a hidden tab, so the stall timer could fire long after it was due, report the interval it was armed with as the interval waited, warn, and invalidate entries whose deliveries were queued behind the same throttling. It now compares its due time with its fire time: late beyond a tolerance, or firing in a hidden tab, it records one `subscription.recovery-timer-late` per attempt (with `timerLateMs` and `hidden`) and re-arms; the first on-time fire in a visible tab decides. `subscription.recovery-stuck` carries the time actually waited and the number of deferrals.
+
+  The client runtime yields to the event loop through a `MessageChannel` in the browser instead of `setTimeout`, so tasks queued behind Effect's periodic yield are not held to the hidden-tab timer grid. `runtime.resolved` records the channel in use as `scheduler`.
+
+  `socket.frames` marks frame-arrival bursts on the raw socket — the first frame after open and each frame that follows a gap of five seconds or more, at most eight per socket — so an export separates a late arrival from late processing.
+
+  `apiSurface: compatible` — the golden churn in `@voltro/client` and `@voltro/web` is two members added to the `ClientDiagnosticKind` union (`socket.frames`, `subscription.recovery-timer-late`); every existing member is unchanged, the framework is the only producer, and a reader that does not know the new kinds sees two more events it can ignore. Only a switch exhaustive over the vocabulary needs two arms.
+- **@voltro/cli** — Web middleware is precompiled into the server production output and rooted by runtime pruning, preserving its behavior in source-free Docker deployments. Missing transitive imports now fail loudly instead of silently disabling a present middleware; rebuilding after removal clears the previous policy. Runtime tracing also preserves transitive dependencies when a deploy directory is reached through a symlink. Native bundle imports now propagate missing-library and initialization errors instead of returning a circular shim's empty exports. Rebuild and deploy the complete `.framework` output; no application API changes are required.
+
+---
+
+## [0.66.1] — 2026-09-06
+
+### Fixed
+
+- **@voltro/cli** — API serve and web start bundles preserve esbuild's caught-import handling: a missing `require()` inside `try/catch` or a caught dynamic import can use its source fallback without a package.json optional-dependency declaration. This fixes the 0.66.0 minified MySQL/MariaDB serve-build regression at mysql2's optional `cardinal` debug highlighter; no direct `cardinal` dependency is needed after upgrading and rebuilding the API. Unhandled missing dependencies and broken installed exports still fail the build. Regression tests execute minified fallback code and build/import production serve bundles for every registered SQL-driver package, plus MariaDB, without requiring database services.
+
+---
+
 ## [0.66.0] — 2026-09-06
 
 ### ⚠ BREAKING

package/THIRD-PARTY-NOTICES.md

@@ -9,7 +9,7 @@ Generated from the resolved runtime dependency closure (107 packages).
 
 ---
 
-## @effect/sql@0.52.0
+## @effect/sql@0.52.1
 
 License: MIT
 
@@ -37,7 +37,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @floating-ui/core@1.7.5
+## @floating-ui/core@1.8.0
 
 License: MIT
 
@@ -64,7 +64,7 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## @floating-ui/dom@1.7.6
+## @floating-ui/dom@1.8.0
 
 License: MIT
 
@@ -118,7 +118,7 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## @floating-ui/utils@0.2.11
+## @floating-ui/utils@0.2.12
 
 License: MIT
 
@@ -1876,7 +1876,7 @@ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## effect@3.22.0
+## effect@3.22.1
 
 License: MIT
 
@@ -2047,7 +2047,7 @@ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## jose@6.2.8
+## jose@6.2.10
 
 License: MIT
 

package/dist/brand.d.ts

@@ -52,7 +52,7 @@ export declare type VoltroMarkVariant = 'gradient' | 'mono' | 'white';
  * type set in the surrounding font and `currentColor`, so it inherits
  * the app's typography and is correct in light + dark automatically.
  */
-export declare const VoltroWordmark: ({ size, markVariant, label, className, style, }: VoltroWordmarkProps) => ReactNode;
+export declare const VoltroWordmark: ({ size, markVariant, label, product, productTone, className, style, }: VoltroWordmarkProps) => ReactNode;
 
 export declare interface VoltroWordmarkProps {
     /** Mark height in px; the wordmark text scales with it. Default 28. */
@@ -60,6 +60,10 @@ export declare interface VoltroWordmarkProps {
     readonly markVariant?: VoltroMarkVariant;
     /** Wordmark label. Default "Voltro". */
     readonly label?: string;
+    /** Product badge beside the shared wordmark, e.g. Framework or Cloud. */
+    readonly product?: ReactNode;
+    /** Warning tone for an operator surface; proportions stay shared. */
+    readonly productTone?: 'brand' | 'warning';
     readonly className?: string;
     readonly style?: CSSProperties;
 }

package/dist/brand.js

@@ -1,177 +1,3 @@
-import { cn as e } from "./cn.js";
-import { useId as t } from "react";
-import { Fragment as n, jsx as r, jsxs as i } from "react/jsx-runtime";
-//#region src/brand/voltroLogo.tsx
-var a = "M28 5 13 27 22 26 20 43 35 21 26 22Z", o = "M28 5 13 27 22 26 20 43Z", s = "M28 5 20 43 35 21 26 22Z", c = "#7C3AED", l = ({ size: c = 32, variant: l = "gradient", title: u, className: d, ...f }) => {
-	let p = t(), m = `vmF-${p}`, h = `vmB-${p}`;
-	return /* @__PURE__ */ r("svg", {
-		width: c,
-		height: c,
-		viewBox: "0 0 48 48",
-		fill: "none",
-		xmlns: "http://www.w3.org/2000/svg",
-		...u === void 0 ? { "aria-hidden": !0 } : {
-			role: "img",
-			"aria-label": u
-		},
-		className: e("inline-block shrink-0", d),
-		...f,
-		children: l === "gradient" ? /* @__PURE__ */ i(n, { children: [
-			/* @__PURE__ */ i("defs", { children: [/* @__PURE__ */ i("linearGradient", {
-				id: m,
-				x1: "13",
-				y1: "5",
-				x2: "33",
-				y2: "43",
-				gradientUnits: "userSpaceOnUse",
-				children: [/* @__PURE__ */ r("stop", { stopColor: "#A874FF" }), /* @__PURE__ */ r("stop", {
-					offset: "1",
-					stopColor: "#7C3AED"
-				})]
-			}), /* @__PURE__ */ i("linearGradient", {
-				id: h,
-				x1: "22",
-				y1: "5",
-				x2: "35",
-				y2: "43",
-				gradientUnits: "userSpaceOnUse",
-				children: [/* @__PURE__ */ r("stop", { stopColor: "#6D28D9" }), /* @__PURE__ */ r("stop", {
-					offset: "1",
-					stopColor: "#4C1D95"
-				})]
-			})] }),
-			/* @__PURE__ */ r("path", {
-				d: o,
-				fill: `url(#${m})`
-			}),
-			/* @__PURE__ */ r("path", {
-				d: s,
-				fill: `url(#${h})`
-			})
-		] }) : /* @__PURE__ */ r("path", {
-			d: a,
-			fill: l === "white" ? "#FFFFFF" : "currentColor"
-		})
-	});
-}, u = ({ size: a = 40, tone: c = "brand", radius: l = .225, title: u = "Voltro", className: d, style: f }) => {
-	let p = t(), m = `viBg-${p}`, h = `viGlow-${p}`, g = `viF-${p}`, _ = `viB-${p}`, v = (64 * l).toFixed(2);
-	return /* @__PURE__ */ i("svg", {
-		width: a,
-		height: a,
-		viewBox: "0 0 64 64",
-		fill: "none",
-		xmlns: "http://www.w3.org/2000/svg",
-		role: "img",
-		"aria-label": u,
-		className: e("inline-block shrink-0", d),
-		style: f,
-		children: [
-			/* @__PURE__ */ i("defs", { children: [
-				/* @__PURE__ */ r("linearGradient", {
-					id: m,
-					x1: "0",
-					y1: "0",
-					x2: "64",
-					y2: "64",
-					gradientUnits: "userSpaceOnUse",
-					children: c === "brand" ? /* @__PURE__ */ i(n, { children: [/* @__PURE__ */ r("stop", { stopColor: "#8B5CFF" }), /* @__PURE__ */ r("stop", {
-						offset: "1",
-						stopColor: "#6D28D9"
-					})] }) : /* @__PURE__ */ i(n, { children: [/* @__PURE__ */ r("stop", { stopColor: "#1B1726" }), /* @__PURE__ */ r("stop", {
-						offset: "1",
-						stopColor: "#120F1A"
-					})] })
-				}),
-				c === "dark" ? /* @__PURE__ */ i("radialGradient", {
-					id: h,
-					cx: "0.5",
-					cy: "0.46",
-					r: "0.5",
-					children: [/* @__PURE__ */ r("stop", {
-						stopColor: "#7C3AED",
-						stopOpacity: "0.55"
-					}), /* @__PURE__ */ r("stop", {
-						offset: "1",
-						stopColor: "#7C3AED",
-						stopOpacity: "0"
-					})]
-				}) : null,
-				/* @__PURE__ */ i("linearGradient", {
-					id: g,
-					x1: "13",
-					y1: "5",
-					x2: "33",
-					y2: "43",
-					gradientUnits: "userSpaceOnUse",
-					children: [/* @__PURE__ */ r("stop", { stopColor: "#C4A6FF" }), /* @__PURE__ */ r("stop", {
-						offset: "1",
-						stopColor: "#9D5BFF"
-					})]
-				}),
-				/* @__PURE__ */ i("linearGradient", {
-					id: _,
-					x1: "22",
-					y1: "5",
-					x2: "35",
-					y2: "43",
-					gradientUnits: "userSpaceOnUse",
-					children: [/* @__PURE__ */ r("stop", { stopColor: "#A874FF" }), /* @__PURE__ */ r("stop", {
-						offset: "1",
-						stopColor: "#7C3AED"
-					})]
-				})
-			] }),
-			/* @__PURE__ */ r("rect", {
-				width: "64",
-				height: "64",
-				rx: v,
-				fill: `url(#${m})`
-			}),
-			c === "brand" ? /* @__PURE__ */ i(n, { children: [/* @__PURE__ */ r("path", {
-				transform: "translate(8 8)",
-				d: o,
-				fill: "#FFFFFF"
-			}), /* @__PURE__ */ r("path", {
-				transform: "translate(8 8)",
-				d: s,
-				fill: "#D7C4FF"
-			})] }) : /* @__PURE__ */ i(n, { children: [
-				/* @__PURE__ */ r("ellipse", {
-					cx: "32",
-					cy: "30",
-					rx: "26",
-					ry: "26",
-					fill: `url(#${h})`
-				}),
-				/* @__PURE__ */ r("path", {
-					transform: "translate(8 8)",
-					d: o,
-					fill: `url(#${g})`
-				}),
-				/* @__PURE__ */ r("path", {
-					transform: "translate(8 8)",
-					d: s,
-					fill: `url(#${_})`
-				})
-			] })
-		]
-	});
-}, d = ({ size: t = 28, markVariant: n = "gradient", label: a = "Voltro", className: o, style: s }) => /* @__PURE__ */ i("span", {
-	className: e("inline-flex items-center font-semibold tracking-tight leading-none", o),
-	style: {
-		gap: t * .28,
-		fontSize: t * .74,
-		...s
-	},
-	children: [/* @__PURE__ */ r(l, {
-		size: Math.round(t * 1.18),
-		variant: n,
-		"aria-hidden": !0
-	}), /* @__PURE__ */ r("span", { children: a })]
-}), f = {
-	full: a,
-	front: o,
-	back: s
-};
-//#endregion
-export { f as VOLTRO_BOLT_PATH, c as VOLTRO_VIOLET, u as VoltroIcon, l as VoltroMark, d as VoltroWordmark };
+import "./cn.js";
+import { a as e, i as t, n, r, t as i } from "./voltroLogo-CSnSpQhz.js";
+export { i as VOLTRO_BOLT_PATH, n as VOLTRO_VIOLET, r as VoltroIcon, t as VoltroMark, e as VoltroWordmark };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { ButtonHTMLAttributes } from 'react';
 import { ClassProp } from 'class-variance-authority/types';
 import { ClassValue } from 'clsx';
+import { ComponentProps } from 'react';
 import { ComponentPropsWithoutRef } from 'react';
 import { ComponentType } from 'react';
 import { CSSProperties } from 'react';
@@ -40,10 +41,12 @@ declare interface AnimatedNumberProps {
  *  is immediate (the pre-paint `themeBootScript` handles the first load). */
 export declare const applyTheme: (theme: ThemePreference) => void;
 
-export declare const AppShell: ({ brand, nav, right, children, className, LinkComponent, }: AppShellProps) => ReactNode;
+export declare const AppShell: ({ brand, header, nav, right, children, className, LinkComponent, }: AppShellProps) => ReactNode;
 
 declare interface AppShellProps {
     readonly brand: ReactNode;
+    /** Custom top navigation using the app's own shared header composition. */
+    readonly header?: ReactNode;
     readonly nav?: ReadonlyArray<NavLink>;
     readonly right?: ReactNode;
     readonly children: ReactNode;
@@ -189,7 +192,7 @@ declare interface CodeComparePanelProps {
     readonly code?: string;
     /** Shiki language. Triggers syntax highlighting on `code`. */
     readonly lang?: ShikiLang;
-    /** Visual treatment — `'muted'` is dimmed (the "before"),
+    /** Visual treatment — `'muted'` uses a neutral border (the "before"),
      *  `'highlight'` keeps the full styling + adds a primary border. */
     readonly tone?: 'muted' | 'highlight';
     /** The corner tag. Pass a translated string on a localised page. */
@@ -317,7 +320,7 @@ declare interface DocShellProps {
     readonly LinkComponent?: ComponentType<ShellLinkProps>;
 }
 
-export declare const DocsLayout: ({ brand, nav, children, currentPath, topNav, topRight, search, page, LinkComponent, className, labels, footer, sidebarHeader, }: DocsLayoutProps) => ReactNode;
+export declare const DocsLayout: ({ brand, nav, children, currentPath, topNav, topRight, search, page, LinkComponent, className, labels, footer, sidebarHeader, header, intro, sidebar, }: DocsLayoutProps) => ReactNode;
 
 /** User-facing strings for the layout's own chrome. Defaults are English
  *  so the layout works unconfigured; pass catalog values to localize. */
@@ -350,6 +353,14 @@ declare interface DocsLayoutProps {
     readonly brand: ReactNode;
     readonly nav: ReadonlyArray<DocsNavGroup>;
     readonly children: ReactNode;
+    /** Compose the top bar while retaining the layout's mobile navigation control. */
+    readonly header?: (controls: {
+        readonly menuButton: ReactNode;
+    }) => ReactNode;
+    /** Full-width introduction above the reading columns. */
+    readonly intro?: ReactNode;
+    /** Show the desktop section rail. Mobile navigation remains available. */
+    readonly sidebar?: boolean;
     /** Current pathname — used to highlight the active nav entry +
      *  decide which group opens by default. */
     readonly currentPath?: string;
@@ -712,7 +723,7 @@ export declare interface PreferenceCookies {
     readonly locale?: string;
 }
 
-export declare const ProfileMenu: ({ identity, links, languages, currentLanguage, onLanguageChange, logoutUrl, onLogout, signInUrl, labels, }: ProfileMenuProps) => ReactNode;
+export declare const ProfileMenu: ({ identity, links, languages, currentLanguage, onLanguageChange, logoutUrl, onLogout, signInUrl, labels, trigger, }: ProfileMenuProps) => ReactNode;
 
 export declare interface ProfileMenuLabels {
     /** Section label for the theme switch. Default `'Theme'`. */
@@ -747,6 +758,8 @@ export declare interface ProfileMenuLink {
 }
 
 export declare interface ProfileMenuProps {
+    /** Custom accessible trigger; Radix supplies menu state and focus handling. */
+    readonly trigger?: ReactNode;
     readonly identity?: {
         readonly name: string;
         readonly sublabel?: string;
@@ -912,6 +925,61 @@ export declare const SHIKI_LANGS: readonly ["text", "ts", "tsx", "typescript", "
 
 export declare type ShikiLang = typeof SHIKI_LANGS[number];
 
+/** Decorative Voltro contour field. Import `@voltro/ui-shadcn/signal.css`.
+ * Static at SSR, with reduced-motion and visibility-aware animation on hydration. */
+export declare function SignalField({ animated, paused, className }: SignalFieldProps): ReactNode;
+
+export declare interface SignalFieldProps {
+    /** Enable the ambient wave. Supply a visible pause control when enabling it. */
+    readonly animated?: boolean;
+    readonly paused?: boolean;
+    readonly className?: string;
+}
+
+/** Compact brand navigation with a keyboard-accessible disclosure and moving marker. */
+export declare function SignalHeader({ brand, links, navigationLabel, menuLabel, menuTitle, menuLinks, utilities, navigationAction, className, sticky }: SignalHeaderProps): ReactNode;
+
+/** Secondary header action; the filled Signal CTA remains the page's primary action. */
+export declare function SignalHeaderAction({ children, className, ...props }: ComponentProps<'a'>): ReactNode;
+
+export declare interface SignalHeaderProps {
+    readonly brand: ReactNode;
+    readonly links: readonly SignalNavigationLink[];
+    readonly navigationLabel: string;
+    readonly menuLabel: string;
+    readonly menuTitle: ReactNode;
+    readonly menuLinks: readonly SignalNavigationLink[];
+    readonly utilities?: ReactNode;
+    /** Context navigation, such as the Docs section drawer, stays beside the rail. */
+    readonly navigationAction?: ReactNode;
+    readonly className?: string;
+    /** Keep navigation available while reading; the surface appears after scrolling. */
+    readonly sticky?: boolean;
+}
+
+export declare interface SignalNavigationLink {
+    readonly label: string;
+    readonly href: string;
+    readonly description?: string;
+    readonly current?: boolean;
+}
+
+/** One appearance/language entry point for public and operating Signal surfaces. */
+export declare function SignalPreferences({ locale, ...props }: SignalPreferencesProps): ReactNode;
+
+export declare interface SignalPreferencesProps extends Omit<ProfileMenuProps, 'trigger' | 'labels' | 'languages' | 'currentLanguage'> {
+    readonly locale: 'en' | 'de';
+}
+
+/** Search is a command trigger, sized to the navigation rail with a compact mobile state. */
+export declare function SignalSearch({ label, onOpen, className }: SignalSearchProps): ReactNode;
+
+export declare interface SignalSearchProps {
+    readonly label: string;
+    readonly onOpen: () => void;
+    readonly className?: string;
+}
+
 export declare const SiteFooter: ({ brand, tagline, social, columns, bottomLeft, bottomRight, copyrightHolder, socialLabel, LinkComponent, className, }: SiteFooterProps) => ReactNode;
 
 export declare interface SiteFooterColumn {
@@ -1054,6 +1122,9 @@ export declare const TerminalIcon: (p: DocIconProps) => ReactNode;
 
 export declare const Textarea: ({ className, ...props }: TextareaHTMLAttributes<HTMLTextAreaElement>) => ReactNode;
 
+/** Fired after applyTheme so preference controls in the same document stay in sync. */
+export declare const THEME_CHANGE_EVENT = "voltro:theme-change";
+
 export declare const THEME_COOKIE = "voltro:theme";
 
 /**
@@ -1170,7 +1241,7 @@ export declare type VoltroMarkVariant = 'gradient' | 'mono' | 'white';
  * type set in the surrounding font and `currentColor`, so it inherits
  * the app's typography and is correct in light + dark automatically.
  */
-export declare const VoltroWordmark: ({ size, markVariant, label, className, style, }: VoltroWordmarkProps) => ReactNode;
+export declare const VoltroWordmark: ({ size, markVariant, label, product, productTone, className, style, }: VoltroWordmarkProps) => ReactNode;
 
 export declare interface VoltroWordmarkProps {
     /** Mark height in px; the wordmark text scales with it. Default 28. */
@@ -1178,6 +1249,10 @@ export declare interface VoltroWordmarkProps {
     readonly markVariant?: VoltroMarkVariant;
     /** Wordmark label. Default "Voltro". */
     readonly label?: string;
+    /** Product badge beside the shared wordmark, e.g. Framework or Cloud. */
+    readonly product?: ReactNode;
+    /** Warning tone for an operator surface; proportions stay shared. */
+    readonly productTone?: 'brand' | 'warning';
     readonly className?: string;
     readonly style?: CSSProperties;
 }