@viraui/react 2026.0.4 → 2026.0.5

package/dist/catalog.json

@@ -92,6 +92,12 @@
       "summary": "CSS-only fit-to-width wrapper that scales children to fill available inline space.",
       "guidePath": "./components/fit-text/fit-text.guide.json"
     },
+    {
+      "id": "glow",
+      "name": "Glow",
+      "summary": "Decorative pointer-driven border highlight on a transparent Surface shell (radius only). Put the visual card as children; a shared rAF tracker paints CSS variables without React re-renders.",
+      "guidePath": "./components/glow/glow.guide.json"
+    },
     {
       "id": "icon-button",
       "name": "IconButton",

package/dist/components/dialog/dialog-sheet.js

@@ -3,8 +3,8 @@ import { Text } from "../text/text.js";
 import { Stack } from "../stack/stack.js";
 import dialog_module_default from "./dialog.module.js";
 import { Elevator } from "../elevator/elevator.js";
-import { IconButton } from "../icon-button/icon-button.js";
 import { Surface } from "../surface/surface.js";
+import { IconButton } from "../icon-button/icon-button.js";
 import { Title } from "../title/title.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Drawer } from "@base-ui/react";

package/dist/components/fit-text/fit-text.css

@@ -1 +1 @@
-@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --__fit-text-captured-length{syntax:"<length>";inherits:true;initial-value:0}@property --vui-fit-text-max-font-size{syntax:"<length>";inherits:true;initial-value:calc(infinity * 1px)}@property --__fit-text-available-space{syntax:"<length>";inherits:true;initial-value:0}@property --__fit-text-ratio{syntax:"<number>";inherits:false;initial-value:1}.viraui__fit-text-module__FitText_CdAvq{--__fit-text-captured-length:initial;display:flex;container-type:inline-size;.viraui__fit-text-module__Container_bawpR{--__fit-text-captured-length:100cqi;--__fit-text-available-space:var(--__fit-text-captured-length);flex-grow:1;container-type:inline-size}.viraui__fit-text-module__Display_Hraif{--__fit-text-captured-length:100cqi;--__fit-text-ratio:tan(atan2(var(--__fit-text-available-space),var(--__fit-text-available-space) - var(--__fit-text-captured-length)));inline-size:var(--__fit-text-available-space);font-size:clamp(0px,1em * var(--__fit-text-ratio),var(--vui-fit-text-max-font-size));>*{font-size:1em;max-inline-size:none}}.viraui__fit-text-module__Reference_6wCx7{visibility:hidden;>*{font-size:inherit;max-inline-size:none}}}}
+@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --__fit-text-captured-length{syntax:"<length>";inherits:true;initial-value:0}@property --vui-fit-text-max-font-size{syntax:"<length>";inherits:true;initial-value:calc(infinity * 1px)}@property --__fit-text-available-space{syntax:"<length>";inherits:true;initial-value:0}@property --__fit-text-ratio{syntax:"<number>";inherits:false;initial-value:1}.viraui__fit-text-module__FitText_CdAvq{--__fit-text-captured-length:initial;display:flex;container-type:inline-size;.viraui__fit-text-module__Container_bawpR{--__fit-text-captured-length:100cqi;--__fit-text-available-space:var(--__fit-text-captured-length);flex-grow:1;container-type:inline-size}.viraui__fit-text-module__Display_Hraif{--__fit-text-captured-length:100cqi;--__fit-text-ratio:tan(atan2(var(--__fit-text-available-space),var(--__fit-text-available-space) - var(--__fit-text-captured-length)));inline-size:var(--__fit-text-available-space);font-size:clamp(0px,1em * var(--__fit-text-ratio),var(--vui-fit-text-max-font-size));overflow:clip;>*{font-size:1em;max-inline-size:none;display:block}}.viraui__fit-text-module__Reference_6wCx7{visibility:hidden;>*{font-size:inherit;max-inline-size:none}}}}

package/dist/components/glow/glow-tracker.d.ts

@@ -0,0 +1,19 @@
+export type GlowTrackerEntry = {
+    el: HTMLElement;
+    proximity: number;
+    restingOpacity: number;
+    /** Unwrapped continuous angle written to `--vui-glow-starting-angle`. */
+    lastAngle?: number;
+};
+/**
+ * Advance `lastAngle` toward `rawDegrees` along the shortest arc so CSS
+ * transitions never interpolate the long way across the 0° seam.
+ */
+export declare const unwrapGlowAngle: (lastAngle: number | undefined, rawDegrees: number) => number;
+export declare const registerGlow: (entry: GlowTrackerEntry) => void;
+export declare const updateGlow: (entry: GlowTrackerEntry) => void;
+export declare const unregisterGlow: (el: HTMLElement) => void;
+/** Story / test helper: current document listener attach count (`0` or `1`). */
+export declare const getGlowListenerCount: () => number;
+/** Story / test helper: registered glow root count. */
+export declare const getGlowRegistrySize: () => number;

package/dist/components/glow/glow-tracker.js

@@ -0,0 +1,87 @@
+//#region src/components/glow/glow-tracker.ts
+var entries = /* @__PURE__ */ new Map();
+var listenerCount = 0;
+var rafId = null;
+var pendingEvent = null;
+var POINTER_QUERY = "(hover: hover) and (pointer: fine)";
+var REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+var canTrackPointer = () => {
+	if (typeof window === "undefined" || typeof matchMedia !== "function") return false;
+	return matchMedia(POINTER_QUERY).matches && !matchMedia(REDUCED_MOTION_QUERY).matches;
+};
+/** Normalize degrees into `[0, 360)`. */
+var normalizeAngle = (degrees) => (degrees % 360 + 360) % 360;
+/**
+* Advance `lastAngle` toward `rawDegrees` along the shortest arc so CSS
+* transitions never interpolate the long way across the 0° seam.
+*/
+var unwrapGlowAngle = (lastAngle, rawDegrees) => {
+	const target = normalizeAngle(rawDegrees);
+	if (lastAngle === void 0) return target;
+	let delta = target - normalizeAngle(lastAngle);
+	if (delta > 180) delta -= 360;
+	else if (delta < -180) delta += 360;
+	return lastAngle + delta;
+};
+var paintEntry = (entry, event) => {
+	const bounds = entry.el.getBoundingClientRect();
+	const pointerX = event.clientX;
+	const pointerY = event.clientY;
+	const activeOpacity = pointerX > bounds.left - entry.proximity && pointerX < bounds.left + bounds.width + entry.proximity && pointerY > bounds.top - entry.proximity && pointerY < bounds.top + bounds.height + entry.proximity ? 1 : entry.restingOpacity;
+	const centerX = bounds.left + bounds.width * .5;
+	const centerY = bounds.top + bounds.height * .5;
+	let angle = Math.atan2(pointerY - centerY, pointerX - centerX) * 180 / Math.PI;
+	if (angle < 0) angle += 360;
+	const lastAngle = unwrapGlowAngle(entry.lastAngle, angle + 90);
+	entries.set(entry.el, {
+		...entry,
+		lastAngle
+	});
+	entry.el.style.setProperty("--vui-glow-starting-angle", String(lastAngle));
+	entry.el.style.setProperty("--vui-glow-active-opacity", String(activeOpacity));
+};
+var flushPaint = () => {
+	rafId = null;
+	const event = pendingEvent;
+	pendingEvent = null;
+	if (!event) return;
+	for (const entry of entries.values()) paintEntry(entry, event);
+};
+var onPointerMove = (event) => {
+	pendingEvent = event;
+	if (rafId !== null) return;
+	rafId = requestAnimationFrame(flushPaint);
+};
+var attachListener = () => {
+	if (listenerCount > 0 || !canTrackPointer()) return;
+	document.addEventListener("pointermove", onPointerMove);
+	listenerCount = 1;
+};
+var detachListener = () => {
+	if (listenerCount === 0 || entries.size > 0) return;
+	document.removeEventListener("pointermove", onPointerMove);
+	listenerCount = 0;
+	if (rafId !== null) {
+		cancelAnimationFrame(rafId);
+		rafId = null;
+	}
+	pendingEvent = null;
+};
+var registerGlow = (entry) => {
+	const existing = entries.get(entry.el);
+	entries.set(entry.el, {
+		...entry,
+		...existing?.lastAngle !== void 0 && { lastAngle: existing.lastAngle }
+	});
+	attachListener();
+};
+var unregisterGlow = (el) => {
+	entries.delete(el);
+	detachListener();
+};
+/** Story / test helper: current document listener attach count (`0` or `1`). */
+var getGlowListenerCount = () => listenerCount;
+/** Story / test helper: registered glow root count. */
+var getGlowRegistrySize = () => entries.size;
+//#endregion
+export { getGlowListenerCount, getGlowRegistrySize, registerGlow, unregisterGlow, unwrapGlowAngle };

package/dist/components/glow/glow.css

@@ -0,0 +1 @@
+@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --vui-glow-starting-angle{syntax:"<number>";inherits:true;initial-value:0}@property --vui-glow-angle-lag{syntax:"<time>";inherits:true;initial-value:80ms}@property --vui-glow-auto-rotate-speed{syntax:"<time>";inherits:true;initial-value:4s}@property --vui-glow-active-opacity{syntax:"<number>";inherits:true;initial-value:0}@property --vui-glow-spread{syntax:"<number>";inherits:true;initial-value:250}@property --vui-glow-border-width{syntax:"<length>";inherits:true;initial-value:2px}@property --vui-glow-border-color{syntax:"<color>";inherits:true;initial-value:#0000}@property --vui-glow-border-offset{syntax:"<length>";inherits:true;initial-value:5px}@property --vui-glow-color{syntax:"*";inherits:true;initial-value:#0000}@property --__glow-radius-tl{syntax:"<length-percentage>";inherits:true;initial-value:0}@property --__glow-radius-tr{syntax:"<length-percentage>";inherits:true;initial-value:0}@property --__glow-radius-br{syntax:"<length-percentage>";inherits:true;initial-value:0}@property --__glow-radius-bl{syntax:"<length-percentage>";inherits:true;initial-value:0}@keyframes viraui__glow-module__vui-glow-auto-rotate_Zh-hL{0%{--vui-glow-starting-angle:0}to{--vui-glow-starting-angle:360}}.viraui__glow-module__Glow_7394e{--vui-glow-border-color:var(--global-contrast);--vui-glow-color:conic-gradient(from 180deg at 50% 70%,#0000,var(--global-primary),#0000);--__glow-radius-tl:var(--vui-surface-border-radius-top-left);--__glow-radius-tr:var(--vui-surface-border-radius-top-right);--__glow-radius-br:var(--vui-surface-border-radius-bottom-right);--__glow-radius-bl:var(--vui-surface-border-radius-bottom-left);position:relative;z-index:0;transition:--vui-glow-starting-angle var(--vui-glow-angle-lag) ease-out;&[data-glow-fit-content=true]{max-width:fit-content}&[data-glow-rainbow=true]{--vui-glow-color:conic-gradient(from 180deg at 50% 50%,var(--highlight-cyan),var(--highlight-blue),var(--highlight-green),var(--highlight-purple),var(--highlight-red),var(--highlight-indigo),var(--highlight-yellow),var(--highlight-salmon),var(--highlight-magenta),var(--highlight-cyan))}&[data-glow-auto-rotate=true]{--vui-glow-active-opacity:1;transition:none;animation:viraui__glow-module__vui-glow-auto-rotate_Zh-hL var(--vui-glow-auto-rotate-speed) linear infinite;@media (prefers-reduced-motion:reduce){animation:none}}&:after,&:before{content:"";position:absolute;z-index:1;pointer-events:none;inset:calc(var(--vui-glow-border-offset) * -1);opacity:var(--vui-glow-active-opacity);border:var(--vui-glow-border-width) solid #0000;border-radius:calc(var(--vui-glow-border-offset) + var(--__glow-radius-tl)) calc(var(--vui-glow-border-offset) + var(--__glow-radius-tr)) calc(var(--vui-glow-border-offset) + var(--__glow-radius-br)) calc(var(--vui-glow-border-offset) + var(--__glow-radius-bl));transition:opacity 1s;@media (prefers-reduced-motion:reduce){display:none}}&:not([data-glow-auto-rotate=true]){&:after,&:before{@media (hover:none),(pointer:coarse){display:none}}}&:before{background:var(--vui-glow-border-color);mask:linear-gradient(#0000,#0000),conic-gradient(from calc(((var(--vui-glow-starting-angle) + (var(--vui-glow-spread) * .25)) - (var(--vui-glow-spread) * 1.5)) * 1deg),oklch(100% 0 0deg/15%) 0deg,#fff,oklch(100% 0 0deg/15%) calc(var(--vui-glow-spread) * 2.5deg));mask-clip:padding-box,border-box;mask-composite:intersect}&:after{background:var(--vui-glow-color);filter:brightness(1.5);mask:linear-gradient(#0000,#0000),conic-gradient(from calc(((var(--vui-glow-starting-angle) + (var(--vui-glow-spread) * .25)) - (var(--vui-glow-spread) * .5)) * 1deg),#0000 0deg,#fff,#0000 calc(var(--vui-glow-spread) * .5deg));mask-clip:padding-box,border-box;mask-composite:intersect;background-size:calc(100% + var(--vui-glow-border-width) * 2) calc(100% + var(--vui-glow-border-width) * 2);background-position:calc(var(--vui-glow-border-width) * -1) calc(var(--vui-glow-border-width) * -1)}&[data-glow-global=true]:after{background-attachment:fixed}}}

package/dist/components/glow/glow.d.ts

@@ -0,0 +1,97 @@
+import { SurfaceProps } from '../surface';
+import type * as React from 'react';
+/**
+ * Public Glow props.
+ *
+ * Glow root is a transparent Surface shell that exposes only `radius` (token, per-corner
+ * tuple, or `auto`). Put the visual card as children (typically `Surface` with `radius="auto"`).
+ *
+ * @default Glow-owned props use the defaults below; `radius` keeps Surface defaults when omitted.
+ */
+export type GlowProps = React.ComponentProps<'div'> & Pick<SurfaceProps, 'radius'> & {
+    /**
+     * Distance from the surface edge where the glow becomes fully active.
+     *
+     * @default 170
+     */
+    proximity?: number;
+    /**
+     * Angular width of the highlighted arc (degrees, used as a unitless CSS number).
+     *
+     * @default 250
+     */
+    spread?: number;
+    /**
+     * Resting opacity of the glow when the pointer is outside proximity.
+     *
+     * @default 0
+     */
+    opacity?: number;
+    /**
+     * Shrinks the root to fit its content (`max-width: fit-content`).
+     *
+     * @default false
+     */
+    fitContent?: boolean;
+    /**
+     * Width of the masked glow border ring.
+     *
+     * @default 2
+     */
+    borderWidth?: number;
+    /**
+     * Color of the masked border ring under the highlight.
+     *
+     * @default var(--global-contrast)
+     */
+    borderColor?: string;
+    /**
+     * Offset of the glow ring from the surface edge. Negative values place the ring outside.
+     *
+     * @default 5
+     */
+    borderOffset?: number;
+    /**
+     * Overrides the glow gradient with a solid color or custom background value.
+     * Ignored when `rainbowColors` is true.
+     *
+     * @default Theme highlight conic gradient
+     */
+    glowColor?: string;
+    /**
+     * Shares the highlight gradient across cards via `background-attachment: fixed`.
+     * Forced off when `rainbowColors` is true.
+     *
+     * @default true
+     */
+    globalHighlight?: boolean;
+    /**
+     * Uses the multi-stop rainbow highlight gradient and disables global highlight attachment.
+     *
+     * @default false
+     */
+    rainbowColors?: boolean;
+    /**
+     * CSS transition duration (ms) for `--vui-glow-starting-angle`. Soft follow by default;
+     * set `0` for instant snap. Tracker writes an unwrapped continuous angle so the
+     * transition does not take the long way across the 0° seam.
+     * Ignored when `autoRotate` is true.
+     *
+     * @default 80
+     */
+    angleLag?: number;
+    /**
+     * Continuously rotates the highlight with a linear CSS animation and ignores the pointer.
+     * Always visible (including coarse pointers); still hidden under `prefers-reduced-motion`.
+     *
+     * @default false
+     */
+    autoRotate?: boolean;
+    /**
+     * Full-turn duration in seconds when `autoRotate` is true.
+     *
+     * @default 2
+     */
+    autoRotateSpeed?: number;
+};
+export declare const Glow: React.FC<GlowProps>;

package/dist/components/glow/glow.guide.json

@@ -0,0 +1,117 @@
+{
+  "name": "Glow",
+  "structure": "<Glow>{children}</Glow>",
+  "summary": "Decorative pointer-driven border highlight on a transparent Surface shell (radius only). Put the visual card as children; a shared rAF tracker paints CSS variables without React re-renders.",
+  "whenToUse": [
+    "Wrap a Surface (or other content) that should highlight toward the pointer",
+    "Grid of glow shells that share one pointer highlight path",
+    "Nested glow inside a padded Surface using radius=\"auto\"",
+    "Decorative continuous spin with autoRotate (no pointer)"
+  ],
+  "whenNotToUse": [
+    "Static borders with no pointer interaction — use Surface border instead",
+    "Accessible status or focus indication — glow is decorative only",
+    "As a replacement for Surface color/padding — compose Surface as children"
+  ],
+  "accessibility": [
+    "Root stays in the accessibility tree; highlight is decorative CSS only",
+    "Glow is not a focus or status indicator — consumer owns accessible names and state",
+    "Pointer mode hides under coarse pointer / no-hover; autoRotate stays visible; both hide under prefers-reduced-motion"
+  ],
+  "antiPatterns": [
+    "Relying on Glow for keyboard focus visibility",
+    "Treating Glow as the visual card (color/padding) instead of composing Surface children",
+    "Setting overflow:hidden on an ancestor Surface when outer glow must remain visible",
+    "Expecting soft bloom Light layer — Glow is border-ring only"
+  ],
+  "related": ["Surface", "Shimmer", "ProgressiveBlur"],
+  "properties": {
+    "react": {
+      "radius": {
+        "description": "Sets corner radius from the Vira radius token scale, a per-corner [top-left, top-right, bottom-right, bottom-left] tuple (0 for square corners), or auto for concentric radii from the nearest ancestor Surface."
+      },
+      "proximity": {
+        "description": "Distance from the surface edge where the glow becomes fully active."
+      },
+      "spread": {
+        "description": "Angular width of the highlighted arc (degrees, used as a unitless CSS number).",
+        "refCss": "spread"
+      },
+      "opacity": {
+        "description": "Resting opacity of the glow when the pointer is outside proximity."
+      },
+      "fitContent": {
+        "description": "Shrinks the root to fit its content (`max-width: fit-content`)."
+      },
+      "borderWidth": {
+        "description": "Width of the masked glow border ring.",
+        "refCss": "border-width"
+      },
+      "borderColor": {
+        "description": "Color of the masked border ring under the highlight.",
+        "refCss": "border-color"
+      },
+      "borderOffset": {
+        "description": "Offset of the glow ring from the surface edge. Negative values place the ring outside.",
+        "refCss": "border-offset"
+      },
+      "glowColor": {
+        "description": "Overrides the glow gradient with a solid color or custom background value. Ignored when `rainbowColors` is true.",
+        "refCss": "color"
+      },
+      "globalHighlight": {
+        "description": "Shares the highlight gradient across cards via `background-attachment: fixed`. Forced off when `rainbowColors` is true."
+      },
+      "rainbowColors": {
+        "description": "Uses the multi-stop rainbow highlight gradient and disables global highlight attachment."
+      },
+      "angleLag": {
+        "description": "CSS transition duration in milliseconds for the pointer-driven starting angle. Soft follow by default; set 0 for instant snap. Ignored when autoRotate is true.",
+        "refCss": "angle-lag"
+      },
+      "autoRotate": {
+        "description": "Continuously rotates the highlight with a linear CSS animation and ignores the pointer. Always visible including on coarse pointers; still hidden under prefers-reduced-motion."
+      },
+      "autoRotateSpeed": {
+        "description": "Full-turn duration in seconds when autoRotate is true.",
+        "refCss": "auto-rotate-speed"
+      }
+    },
+    "css": {
+      "starting-angle": {
+        "description": "Conic gradient start angle in degrees (unitless number). Pointer tracker writes a continuous unwrapped value; autoRotate animates 0→360."
+      },
+      "angle-lag": {
+        "description": "Transition duration for `--vui-glow-starting-angle` (pointer mode).",
+        "refReact": "angleLag"
+      },
+      "auto-rotate-speed": {
+        "description": "Duration of one full auto-rotate turn.",
+        "refReact": "autoRotateSpeed"
+      },
+      "active-opacity": {
+        "description": "Current glow opacity from proximity tracking. Written by the shared tracker."
+      },
+      "spread": {
+        "description": "Angular width of the highlighted arc.",
+        "refReact": "spread"
+      },
+      "border-width": {
+        "description": "Masked glow border ring width.",
+        "refReact": "borderWidth"
+      },
+      "border-color": {
+        "description": "Masked border ring color under the highlight.",
+        "refReact": "borderColor"
+      },
+      "border-offset": {
+        "description": "Glow ring offset from the surface edge.",
+        "refReact": "borderOffset"
+      },
+      "color": {
+        "description": "Glow fill (solid color or gradient).",
+        "refReact": "glowColor"
+      }
+    }
+  }
+}

package/dist/components/glow/glow.js

@@ -0,0 +1,67 @@
+"use client";
+import './glow.css';
+import { clsx } from "../../core/clsx.js";
+import { Surface } from "../surface/surface.js";
+import { registerGlow, unregisterGlow } from "./glow-tracker.js";
+import glow_module_default from "./glow.module.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+//#region src/components/glow/glow.tsx
+var assignRef = (ref, value) => {
+	if (typeof ref === "function") {
+		ref(value);
+		return;
+	}
+	if (ref) Reflect.set(ref, "current", value);
+};
+var glowGlobalAttr = (rainbowColors, globalHighlight) => {
+	if (rainbowColors) return "false";
+	return globalHighlight ? "true" : "false";
+};
+var Glow = ({ angleLag = 80, autoRotate = false, autoRotateSpeed = 4, borderColor = "var(--global-contrast)", borderOffset = 5, borderWidth = 2, children, className, fitContent = false, globalHighlight = true, glowColor, opacity = 0, proximity = 170, rainbowColors = false, ref, spread = 250, style, radius, ...otherProps }) => {
+	const rootRef = useRef(null);
+	const setRootRef = (node) => {
+		rootRef.current = node;
+		assignRef(ref, node);
+	};
+	useEffect(() => {
+		const el = rootRef.current;
+		if (!el || autoRotate) return;
+		registerGlow({
+			el,
+			proximity,
+			restingOpacity: opacity
+		});
+		return () => {
+			unregisterGlow(el);
+		};
+	}, [
+		autoRotate,
+		proximity,
+		opacity
+	]);
+	const dynamicStyle = {
+		"--vui-glow-spread": spread,
+		"--vui-glow-border-width": `${borderWidth}px`,
+		"--vui-glow-border-color": borderColor,
+		"--vui-glow-border-offset": `${borderOffset}px`,
+		"--vui-glow-angle-lag": `${angleLag}ms`,
+		"--vui-glow-auto-rotate-speed": `${autoRotateSpeed}s`,
+		...glowColor && !rainbowColors && { "--vui-glow-color": glowColor },
+		...style
+	};
+	return /* @__PURE__ */ jsx(Surface, {
+		...otherProps,
+		ref: setRootRef,
+		className: clsx(glow_module_default.Glow, className),
+		style: dynamicStyle,
+		radius,
+		"data-glow-fit-content": fitContent ? "true" : "false",
+		"data-glow-global": glowGlobalAttr(rainbowColors, globalHighlight),
+		"data-glow-rainbow": rainbowColors ? "true" : "false",
+		"data-glow-auto-rotate": autoRotate ? "true" : "false",
+		children
+	});
+};
+//#endregion
+export { Glow };

package/dist/components/glow/glow.module.js

@@ -0,0 +1,8 @@
+//#region src/components/glow/glow.module.css
+var Glow = "viraui__glow-module__Glow_7394e";
+var glow_module_default = {
+	Glow,
+	"vui-glow-auto-rotate": "viraui__glow-module__vui-glow-auto-rotate_Zh-hL"
+};
+//#endregion
+export { Glow, glow_module_default as default };

package/dist/components/glow/index.d.ts

@@ -0,0 +1,3 @@
+export { Glow } from './glow';
+export type { GlowProps } from './glow';
+export { getGlowListenerCount, getGlowRegistrySize } from './glow-tracker';

package/dist/components/index.d.ts

@@ -13,6 +13,7 @@ export * from './dialog';
 export * from './elevator';
 export * from './fieldset';
 export * from './fit-text';
+export * from './glow';
 export * from './icon-button';
 export * from './linear-progress';
 export * from './masonry';

package/dist/components/popover/popover-sheet.js

@@ -1,8 +1,8 @@
 import { ChromeXmark } from "../../internal/chrome-icons/chrome-icons.js";
 import { Text } from "../text/text.js";
 import { Stack } from "../stack/stack.js";
-import { IconButton } from "../icon-button/icon-button.js";
 import { Surface } from "../surface/surface.js";
+import { IconButton } from "../icon-button/icon-button.js";
 import popover_module_default from "./popover.module.js";
 import { Title } from "../title/title.js";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/components/select/select.js

@@ -7,8 +7,8 @@ import { FieldHelperCopy } from "../basic-input/field-helper-copy.js";
 import { FieldLabel } from "../basic-input/field-label.js";
 import { Stack } from "../stack/stack.js";
 import { Elevator } from "../elevator/elevator.js";
-import { IconButton } from "../icon-button/icon-button.js";
 import { Surface } from "../surface/surface.js";
+import { IconButton } from "../icon-button/icon-button.js";
 import select_module_default from "./select.module.js";
 import { SelectGroup } from "./select-group.js";
 import { SelectOption } from "./select-option.js";

package/dist/components/surface/surface.css

@@ -1 +1 @@
-@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --vui-surface-background{syntax:"*";inherits:false;initial-value:none}@property --vui-surface-background-hover{syntax:"*";inherits:false;initial-value:none}@property --vui-surface-border-style{syntax:"<custom-ident>";inherits:false;initial-value:solid}@property --vui-surface-overflow{syntax:"<custom-ident>";inherits:false;initial-value:visible}@property --vui-surface-border-radius{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-top-left{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-top-right{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-bottom-right{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-bottom-left{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-padding-inline-start{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-inline-end{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-block-start{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-block-end{syntax:"<length>";inherits:false;initial-value:0}.viraui__surface-module__Surface_slEYq{--vui-surface-border-radius-top-left:var(--vui-surface-border-radius);--vui-surface-border-radius-top-right:var(--vui-surface-border-radius);--vui-surface-border-radius-bottom-right:var(--vui-surface-border-radius);--vui-surface-border-radius-bottom-left:var(--vui-surface-border-radius);--vui-surface-background-hover:var(--vui-surface-background);position:relative;overflow:var(--vui-surface-overflow);box-sizing:border-box;background:var(--vui-surface-background);border-radius:var(--vui-surface-border-radius-top-left) var(--vui-surface-border-radius-top-right) var(--vui-surface-border-radius-bottom-right) var(--vui-surface-border-radius-bottom-left);border:0;@container root not style(--vibrancy-enable: initial){&[data-vibrant]{background:light-dark(oklab(from var(--vui-surface-background) l a b/60%),oklab(from var(--vui-surface-background) l a b/80%))}}&[data-surface-has-padding=true]{padding:var(--vui-surface-padding-block-start) var(--vui-surface-padding-inline-end) var(--vui-surface-padding-block-end) var(--vui-surface-padding-inline-start)}&[data-surface-border]{border-style:var(--vui-surface-border-style);border-color:var(--global-contrast)}&[data-surface-border=all]{border-width:1px}&[data-surface-border=top]{border-width:1px 0 0}&[data-surface-border=right]{border-width:0 1px 0 0}&[data-surface-border=bottom]{border-width:0 0 1px}&[data-surface-border=left]{border-width:0 0 0 1px}&[data-surface-border=x]{border-width:0 1px}&[data-surface-border=y]{border-width:1px 0}@media (hover:hover) and (pointer:fine){&[data-surface-has-hover-color=true]:hover{background:var(--vui-surface-background-hover)}}}}
+@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --vui-surface-background{syntax:"*";inherits:false;initial-value:none}@property --vui-surface-background-hover{syntax:"*";inherits:false;initial-value:none}@property --vui-surface-border-style{syntax:"<custom-ident>";inherits:false;initial-value:solid}@property --vui-surface-overflow{syntax:"<custom-ident>";inherits:false;initial-value:visible}@property --vui-surface-border-radius{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-top-left{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-top-right{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-bottom-right{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-border-radius-bottom-left{syntax:"<length-percentage>";inherits:false;initial-value:0}@property --vui-surface-padding-inline-start{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-inline-end{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-block-start{syntax:"<length>";inherits:false;initial-value:0}@property --vui-surface-padding-block-end{syntax:"<length>";inherits:false;initial-value:0}.viraui__surface-module__Surface_slEYq{--vui-surface-border-radius-top-left:var(--vui-surface-border-radius);--vui-surface-border-radius-top-right:var(--vui-surface-border-radius);--vui-surface-border-radius-bottom-right:var(--vui-surface-border-radius);--vui-surface-border-radius-bottom-left:var(--vui-surface-border-radius);--vui-surface-background-hover:var(--vui-surface-background);position:relative;overflow:var(--vui-surface-overflow);box-sizing:border-box;background:var(--vui-surface-background);border-radius:var(--vui-surface-border-radius-top-left) var(--vui-surface-border-radius-top-right) var(--vui-surface-border-radius-bottom-right) var(--vui-surface-border-radius-bottom-left);border:0;&[data-surface-color=primary]{--vui-surface-background:light-dark(oklab(from var(--global-primary) l a b/20%),oklab(from var(--global-primary) l a b/10%))}&[data-surface-hover-color=primary]{--vui-surface-background-hover:light-dark(oklab(from var(--global-primary) l a b/20%),oklab(from var(--global-primary) l a b/10%))}@container root not style(--vibrancy-enable: initial){&[data-vibrant]{background:light-dark(oklab(from var(--vui-surface-background) l a b/60%),oklab(from var(--vui-surface-background) l a b/80%))}}&[data-surface-has-padding=true]{padding:var(--vui-surface-padding-block-start) var(--vui-surface-padding-inline-end) var(--vui-surface-padding-block-end) var(--vui-surface-padding-inline-start)}&[data-surface-border]{border-style:var(--vui-surface-border-style);border-color:var(--global-contrast)}&[data-surface-border=all]{border-width:1px}&[data-surface-border=top]{border-width:1px 0 0}&[data-surface-border=right]{border-width:0 1px 0 0}&[data-surface-border=bottom]{border-width:0 0 1px}&[data-surface-border=left]{border-width:0 0 0 1px}&[data-surface-border=x]{border-width:0 1px}&[data-surface-border=y]{border-width:1px 0}@media (hover:hover) and (pointer:fine){&[data-surface-has-hover-color=true]:hover{background:var(--vui-surface-background-hover)}}}}

package/dist/components/surface/surface.d.ts

@@ -3,7 +3,9 @@ import { SurfacePadding, SurfaceRadiusInput } from './surface-radius-context';
 import type * as React from 'react';
 /** Base ramp layer for nested surfaces; clamped to 1–3 at runtime. */
 type SurfaceBaseLevel = 1 | 2 | 3;
-type SurfaceColor = string | SurfaceBaseLevel;
+/** Named surface color tokens resolved via `data-surface-color` / `data-surface-hover-color` CSS hooks. */
+type SurfaceColorToken = 'primary';
+type SurfaceColor = string | SurfaceBaseLevel | SurfaceColorToken;
 /**
  * Public Surface props.
  *
@@ -26,13 +28,15 @@ export type SurfaceProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'color'>
      */
     ref?: React.Ref<HTMLElement>;
     /**
-     * Sets the resting background using a base ramp layer (`1`–`3`) or a literal CSS color value.
+     * Sets the resting background using a base ramp layer (`1`–`3`), a literal CSS color value, or the named token
+     * `primary` (`data-surface-color="primary"`; CSS owns light/dark opacity via `--global-primary`).
      *
      * @default No background.
      */
     color?: SurfaceColor;
     /**
-     * Sets the hover background on hover-capable pointers using a base ramp layer (`1`–`3`) or literal CSS value.
+     * Sets the hover background on hover-capable pointers using a base ramp layer (`1`–`3`), a literal CSS value, or the
+     * named token `primary` (`data-surface-hover-color="primary"`; CSS owns light/dark opacity via `--global-primary`).
      *
      * @default No hover color override.
      */

package/dist/components/surface/surface.guide.json

@@ -40,10 +40,10 @@
         "description": "Sets the CSS border style when `border` is set."
       },
       "color": {
-        "description": "Sets the resting background using a base ramp layer (`1`–`3`) or a literal CSS color value."
+        "description": "Sets the resting background using a base ramp layer (`1`–`3`), a literal CSS color value, or the named token `primary` (`data-surface-color=\"primary\"`; CSS owns light/dark opacity via `--global-primary`)."
       },
       "hoverColor": {
-        "description": "Sets the hover background on hover-capable pointers using a base ramp layer (`1`–`3`) or literal CSS value."
+        "description": "Sets the hover background on hover-capable pointers using a base ramp layer (`1`–`3`), a literal CSS value, or the named token `primary` (`data-surface-hover-color=\"primary\"`; CSS owns light/dark opacity via `--global-primary`)."
       },
       "hPadding": {
         "description": "Sets inline padding using one token for both sides or a `[start, end]` tuple."

package/dist/components/surface/surface.js

@@ -7,6 +7,7 @@ import surface_module_default from "./surface.module.js";
 import { jsx } from "react/jsx-runtime";
 import { useRender } from "@base-ui/react/use-render";
 //#region src/components/surface/surface.tsx
+var isSurfaceColorToken = (value) => value === "primary";
 var clampSurfaceBaseLevel = (value) => {
 	if (value <= 1) return 1;
 	if (value >= 3) return 3;
@@ -30,8 +31,8 @@ var Surface = ({ border, borderStyle = "solid", className, color, hPadding, hove
 		vPadding
 	});
 	const dynamicStyle = {
-		"--vui-surface-background": toSurfaceColor(color ?? "none"),
-		...hasHoverColor && { "--vui-surface-background-hover": toSurfaceColor(hoverColor) },
+		...!isSurfaceColorToken(color) && { "--vui-surface-background": toSurfaceColor(color ?? "none") },
+		...hasHoverColor && !isSurfaceColorToken(hoverColor) && { "--vui-surface-background-hover": toSurfaceColor(hoverColor) },
 		...border && { "--vui-surface-border-style": borderStyle },
 		...overflow && { "--vui-surface-overflow": overflow },
 		...radiusStyle,
@@ -47,6 +48,8 @@ var Surface = ({ border, borderStyle = "solid", className, color, hPadding, hove
 			...otherProps,
 			...border && { "data-surface-border": border },
 			...hasAutoRadius && { "data-surface-radius": "auto" },
+			...isSurfaceColorToken(color) && { "data-surface-color": color },
+			...isSurfaceColorToken(hoverColor) && { "data-surface-hover-color": hoverColor },
 			"data-surface-has-hover-color": hasHoverColor ? "true" : "false",
 			"data-surface-has-padding": hasPadding ? "true" : "false",
 			className: clsx(surface_module_default.Surface, className),

package/dist/index.js

@@ -25,11 +25,13 @@ import { getElevationProps } from "./core/elevation/get-elevation-props.js";
 import { Elevator } from "./components/elevator/elevator.js";
 import { Fieldset } from "./components/fieldset/fieldset.js";
 import { FitText } from "./components/fit-text/fit-text.js";
+import { Surface } from "./components/surface/surface.js";
+import { getGlowListenerCount, getGlowRegistrySize } from "./components/glow/glow-tracker.js";
+import { Glow } from "./components/glow/glow.js";
 import { IconButton } from "./components/icon-button/icon-button.js";
 import { IconButtonLink } from "./components/icon-button/icon-button-link.js";
 import { LinearProgress } from "./components/linear-progress/linear-progress.js";
 import { Masonry } from "./components/masonry/masonry.js";
-import { Surface } from "./components/surface/surface.js";
 import { MenuCheckboxItem } from "./components/menu/menu-checkbox-item.js";
 import { MenuGroup } from "./components/menu/menu-group.js";
 import { MenuItem } from "./components/menu/menu-item.js";
@@ -63,4 +65,4 @@ import { ToggleGroup } from "./components/toggle-group/toggle-group.js";
 import { Typewriter } from "./components/typewriter/typewriter.js";
 import { TooltipContent } from "./components/tooltip/tooltip-content.js";
 import { Tooltip, TooltipProvider, TooltipTrigger } from "./components/tooltip/tooltip.js";
-export { Accordion, Annotate, Autocomplete, Avatar, AvatarGroup, Badge, Bleed, Button, ButtonLink, Checkbox, CheckboxGroup, Chip, ClampText, Dialog, DialogClose, DialogIndent, DialogIndentBackground, DialogSheet, DialogTrigger, ELEVATION_DEFAULTS, Elevator, Fieldset, FitText, IconButton, IconButtonLink, LinearProgress, Masonry, Menu, MenuCheckboxItem, MenuGroup, MenuItem, MenuLinkItem, MenuPopup, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubmenu, MenuSubmenuTrigger, MenuTrigger, Meter, Popover, PopoverClose, PopoverDescription, PopoverSheet, PopoverTitle, PopoverTrigger, ProgressiveBlur, Radio, RadioGroup, Select, Separator, Shimmer, Skeleton, Slider, Spinner, Stack, StaticNoise, Surface, Switch, Tabs, Text, Textarea, Textfield, Title, Toast, ToggleButton, ToggleGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Typewriter, getElevationProps };
+export { Accordion, Annotate, Autocomplete, Avatar, AvatarGroup, Badge, Bleed, Button, ButtonLink, Checkbox, CheckboxGroup, Chip, ClampText, Dialog, DialogClose, DialogIndent, DialogIndentBackground, DialogSheet, DialogTrigger, ELEVATION_DEFAULTS, Elevator, Fieldset, FitText, Glow, IconButton, IconButtonLink, LinearProgress, Masonry, Menu, MenuCheckboxItem, MenuGroup, MenuItem, MenuLinkItem, MenuPopup, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubmenu, MenuSubmenuTrigger, MenuTrigger, Meter, Popover, PopoverClose, PopoverDescription, PopoverSheet, PopoverTitle, PopoverTrigger, ProgressiveBlur, Radio, RadioGroup, Select, Separator, Shimmer, Skeleton, Slider, Spinner, Stack, StaticNoise, Surface, Switch, Tabs, Text, Textarea, Textfield, Title, Toast, ToggleButton, ToggleGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Typewriter, getElevationProps, getGlowListenerCount, getGlowRegistrySize };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viraui/react",
-  "version": "2026.0.4",
+  "version": "2026.0.5",
   "private": false,
   "files": [
     "dist"
@@ -35,7 +35,7 @@
     "unplugin-dts": "1.0.3",
     "vite": "8.1.4",
     "vite-plugin-static-copy": "4.1.1",
-    "@viraui/foundation": "2026.0.4",
+    "@viraui/foundation": "2026.0.5",
     "@viraui/icons": "2026.0.0",
     "@viraui/postcss-config": "2026.0.0",
     "@viraui/tsconfig": "2026.0.0"