refactor(lint): drive ui_primitives to zero on the type-assertion rule

Every `require-safety-comment-for-type-assertion` finding in
web/src/components/ui_primitives is gone, by naming what the assertions
were papering over rather than commenting them.

Production:

- `snapSpacing` now returns `SpacingStep`, the type its own step tuple
  already implies, so FormGrid stops re-asserting the result.
- `Surface` binds `RADIUS_MAP[rounded]` once; TypeScript cannot narrow a
  repeated index expression, which is what the `keyof Theme["rounded"]`
  assertion was standing in for.
- `getThemeColor` resolves a palette path through entry lookups checked
  by `isObjectLike`/`isString` instead of three `Record` casts, and now
  says in one place what a `colorKey` prop means.
- `sxEntries` in tokens.ts normalizes the three `SxProps` forms, so
  Popover and ContextMenu compose the caller's `sx` under their defaults
  as an array. ContextMenu previously spread it through `as object`,
  which silently dropped the callback and array forms.
- `Stack` reads a component's display name through a declared shape;
  `InfoTooltip` names the CSS-custom-property style it builds; the
  generic-erasing `memo` cast on `Autocomplete` keeps its assertion and
  gains the SAFETY comment stating the invariant.

Tests: `firstElement`, `queryElement`, `queryInput` and `asElement` in
test-utils/doubles.ts replace 120 DOM assertions with checked narrowings,
so a query that misses fails where it queried. `HoverActionGroup`'s
pass-through case names its `data-*` prop instead of `as any`, and the
media-locator suite mints its branded URLs with `asResolvedMediaUrl`.

The enforced overrides are regenerated: that also picks up 19 pairs in
packages/godot, packages/godot-templates and packages/blender-nodes that
were already clean but never ratcheted.

Author: github-actions[bot]

.oxlintrc.anti-slop-enforced.json

@@ -34,6 +34,8 @@
         "packages/execution/src/**",
         "packages/fal-codegen/src/**",
         "packages/fal-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/gpu/src/**",
         "packages/huggingface/src/**",
         "packages/huggingface-nodes/src/**",
@@ -74,6 +76,7 @@
         "packages/auth/src/**",
         "packages/automation-nodes/src/**",
         "packages/base-nodes/src/**",
+        "packages/blender-nodes/src/**",
         "packages/browser/src/**",
         "packages/chat/src/**",
         "packages/code-nodes/src/**",
@@ -85,6 +88,8 @@
         "packages/dsl/src/**",
         "packages/elevenlabs-nodes/src/**",
         "packages/fal-codegen/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/gpu/src/**",
         "packages/huggingface/src/**",
         "packages/image-editor/src/**",
@@ -123,6 +128,7 @@
         "packages/document-nodes/src/**",
         "packages/dsl/src/**",
         "packages/execution/src/**",
+        "packages/godot-templates/src/**",
         "packages/huggingface-nodes/src/**",
         "packages/image-editor/src/**",
         "packages/kie-codegen/src/**",
@@ -150,6 +156,7 @@
         "packages/auth/src/**",
         "packages/automation-nodes/src/**",
         "packages/base-nodes/src/**",
+        "packages/blender-nodes/src/**",
         "packages/browser/src/**",
         "packages/chat/src/**",
         "packages/cli/src/**",
@@ -165,6 +172,8 @@
         "packages/execution/src/**",
         "packages/fal-codegen/src/**",
         "packages/fal-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/gpu/src/**",
         "packages/huggingface/src/**",
         "packages/huggingface-nodes/src/**",
@@ -220,6 +229,8 @@
         "packages/config/src/**",
         "packages/data-nodes/src/**",
         "packages/document-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/image-editor/src/**",
         "packages/image-nodes/src/**",
         "packages/kie-codegen/src/**",
@@ -257,6 +268,8 @@
         "packages/data-nodes/src/**",
         "packages/document-nodes/src/**",
         "packages/elevenlabs-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/kie-codegen/src/**",
         "packages/minimax-nodes/src/**",
         "packages/model-pricing/src/**",
@@ -280,6 +293,7 @@
         "packages/auth/src/**",
         "packages/automation-nodes/src/**",
         "packages/base-nodes/src/**",
+        "packages/blender-nodes/src/**",
         "packages/chat/src/**",
         "packages/code-nodes/src/**",
         "packages/compute/src/**",
@@ -291,6 +305,8 @@
         "packages/elevenlabs-nodes/src/**",
         "packages/fal-codegen/src/**",
         "packages/fal-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/huggingface/src/**",
         "packages/huggingface-nodes/src/**",
         "packages/image-editor/src/**",
@@ -334,6 +350,8 @@
         "packages/config/src/**",
         "packages/data-nodes/src/**",
         "packages/document-nodes/src/**",
+        "packages/godot/src/**",
+        "packages/godot-templates/src/**",
         "packages/kie-codegen/src/**",
         "packages/model-pricing/src/**",
         "packages/nodes-utils/src/**",
@@ -359,6 +377,7 @@
         "packages/config/src/**",
         "packages/data-nodes/src/**",
         "packages/document-nodes/src/**",
+        "packages/godot-templates/src/**",
         "packages/image-editor/src/**",
         "packages/kie-codegen/src/**",
         "packages/model-pricing/src/**",

web/src/components/ui_primitives/Autocomplete.tsx

@@ -150,4 +150,8 @@ function AutocompleteInternal<
   );
 }
 
-export const Autocomplete = memo(AutocompleteInternal) as typeof AutocompleteInternal;
+export const Autocomplete =
+  // SAFETY: `memo` returns a non-generic `MemoExoticComponent`, dropping the
+  // three type parameters callers pass. The runtime value is unchanged; only
+  // the generic call signature is restored.
+  memo(AutocompleteInternal) as typeof AutocompleteInternal;

web/src/components/ui_primitives/CircularActionButton.tsx

@@ -183,25 +183,26 @@ export interface CircularActionButtonProps {
   tabIndex?: number;
 }
 
+/**
+ * Resolves a `"group.variant"` palette path, or a top-level palette color's
+ * `main`. MUI's `Palette` carries no index signature, so the dynamic key a
+ * `color` prop names is matched against the palette's entries. An unresolvable
+ * key comes back unchanged, which is how a literal CSS color passes through.
+ */
 const getThemeColor = (theme: Theme, colorKey: string): string => {
-  const palette = theme.vars.palette as Record<string, unknown>;
-
-  const parts = colorKey.split(".");
-  if (parts.length === 2 && parts[0] in palette) {
-    const [category, variant] = parts;
-    const categoryPalette = palette[category];
-    if (categoryPalette && isObjectLike(categoryPalette) && variant in (categoryPalette as Record<string, unknown>)) {
-      const value = (categoryPalette as Record<string, string>)[variant];
-      return value || colorKey;
-    }
-  }
-  if (colorKey in palette) {
-    const colorEntry = palette[colorKey];
-    if (colorEntry && isObjectLike(colorEntry) && "main" in colorEntry) {
-      return (colorEntry as { main: string }).main || colorKey;
-    }
+  const [group, variant] = colorKey.split(".");
+  const groupName = variant === undefined ? colorKey : group;
+  const entry = Object.entries(theme.vars.palette).find(
+    ([name]) => name === groupName
+  )?.[1];
+  if (!isObjectLike(entry)) {
+    return colorKey;
   }
-  return colorKey;
+  const variantName = variant ?? "main";
+  const color = Object.entries(entry).find(
+    ([name]) => name === variantName
+  )?.[1];
+  return (isString(color) && color) || colorKey;
 };
 
 export const CircularActionButton = memo(

web/src/components/ui_primitives/ContextMenu.tsx

@@ -14,6 +14,7 @@ import {
 import { useTheme } from "@mui/material/styles";
 import { SxProps, Theme } from "@mui/material";
 import { isNumber } from "../../utils/typePredicates";
+import { sxEntries } from "./tokens";
 
 export interface ContextMenuProps extends Omit<MuiMenuProps, "anchorPosition"> {
   /** Position for right-click context menus */
@@ -87,19 +88,21 @@ const ContextMenuInternal: React.FC<ContextMenuProps> = ({
         ...slotProps,
         paper: {
           ...slotProps?.paper,
-          sx: {
-            borderRadius: borderRadiusValue,
-            maxHeight,
-            minWidth,
-            ...(compact && {
-              "& .MuiMenuItem-root": {
-                minHeight: "auto",
-                py: 0.5,
-                fontSize: theme.fontSizeSmall,
-              },
-            }),
-            ...(paperSx as object),
-          } as SxProps<Theme>,
+          sx: [
+            {
+              borderRadius: borderRadiusValue,
+              maxHeight,
+              minWidth,
+              ...(compact && {
+                "& .MuiMenuItem-root": {
+                  minHeight: "auto",
+                  py: 0.5,
+                  fontSize: theme.fontSizeSmall,
+                },
+              }),
+            },
+            ...sxEntries(paperSx),
+          ],
         },
       }}
       {...props}

web/src/components/ui_primitives/FormGrid.tsx

@@ -15,6 +15,7 @@ import {
   SPACING_STEPS,
   resolveSpacing,
   snapSpacing,
+  type SpacingStep,
   type SpacingValue
 } from "./spacing";
 
@@ -31,9 +32,8 @@ export interface FormGridProps {
 }
 
 /** One canonical step below the given spacing (xl → lg); floors at the smallest step. */
-const stepDownSpacing = (units: number): number => {
-  const snapped = snapSpacing(units) as (typeof SPACING_STEPS)[number];
-  const index = SPACING_STEPS.indexOf(snapped);
+const stepDownSpacing = (units: number): SpacingStep => {
+  const index = SPACING_STEPS.indexOf(snapSpacing(units));
   return SPACING_STEPS[Math.max(index - 1, 0)];
 };
 

web/src/components/ui_primitives/InfoTooltip.tsx

@@ -100,6 +100,9 @@ type TooltipOrigin = {
   horizontal: "left" | "center" | "right";
 };
 
+/** An inline style that also sets CSS custom properties the stylesheet reads. */
+type StyleWithCssVars = React.CSSProperties & Record<`--${string}`, string>;
+
 export const InfoTooltip: React.FC<InfoTooltipProps> = memo(({
   content,
   title,
@@ -188,7 +191,8 @@ export const InfoTooltip: React.FC<InfoTooltipProps> = memo(({
   };
 
   const origins = getPopoverOrigins(placement);
-  
+  const popoverStyle: StyleWithCssVars = { "--max-width": `${maxWidth}px` };
+
   return (
     <div className={`info-tooltip nodrag ${className || ""}`} css={styles(theme)}>
       {button}
@@ -205,7 +209,7 @@ export const InfoTooltip: React.FC<InfoTooltipProps> = memo(({
           horizontal: origins.transform.horizontal
         }}
         css={popoverStyles(theme)}
-        style={{ "--max-width": `${maxWidth}px` } as React.CSSProperties}
+        style={popoverStyle}
       >
         <Box className="popover-content">
           {title && (

web/src/components/ui_primitives/Popover.tsx

@@ -12,6 +12,7 @@ import MuiPopover, {
 import { useTheme } from "@mui/material/styles";
 import { SxProps, Theme } from "@mui/material";
 import { isNumber } from "../../utils/typePredicates";
+import { sxEntries } from "./tokens";
 
 export type PopoverPlacement =
   | "bottom-left"
@@ -124,8 +125,6 @@ const PopoverInternal: React.FC<PopoverProps> = ({
     paperSlot && typeof paperSlot === "object" && "sx" in paperSlot
       ? paperSlot.sx
       : undefined;
-  const asArray = (s: SxProps<Theme> | undefined) =>
-    s === undefined ? [] : Array.isArray(s) ? s : [s];
 
   return (
     <MuiPopover
@@ -144,9 +143,9 @@ const PopoverInternal: React.FC<PopoverProps> = ({
               maxHeight,
               overflow: maxHeight ? "auto" : undefined
             },
-            ...asArray(callerPaperSx),
-            ...asArray(paperSx)
-          ] as SxProps<Theme>
+            ...sxEntries(callerPaperSx),
+            ...sxEntries(paperSx)
+          ]
         }
       }}
       {...props}

web/src/components/ui_primitives/Stack.tsx

@@ -21,6 +21,16 @@ export interface StackProps extends Omit<BoxProps, 'display' | 'flexDirection'>
   fullWidth?: boolean;
 }
 
+/** The name React would show for an element's type: a tag, or a component name. */
+const elementTypeName = (type: React.ReactElement["type"]): string => {
+  if (isString(type)) {
+    return type;
+  }
+  // `displayName` is a React convention, not part of the constructor type.
+  const named: { name: string; displayName?: string } = type;
+  return named.displayName || named.name || "component";
+};
+
 /**
  * Stack - A vertical stack container with consistent spacing
  * 
@@ -51,9 +61,7 @@ const getChildKey = (child: React.ReactNode, index: number): string | number =>
     if (child.key) {
       return child.key;
     }
-    const componentType = child.type as string | (React.FC & { displayName?: string });
-    const type = isString(componentType) ? componentType : componentType?.displayName || componentType?.name || "component";
-    return `${type}-${index}`;
+    return `${elementTypeName(child.type)}-${index}`;
   }
   return index;
 };

web/src/components/ui_primitives/Surface.tsx

@@ -74,6 +74,7 @@ export const Surface = memo(
       ref
     ) => {
       const theme = useTheme();
+      const radiusKey = RADIUS_MAP[rounded];
 
       // Read backgrounds from theme.vars (CSS variables) so the active color
       // scheme is honored. theme.palette.* is baked from the default scheme at
@@ -90,10 +91,7 @@ export const Surface = memo(
           ref={ref}
           elevation={elevation}
           sx={{
-            borderRadius:
-              RADIUS_MAP[rounded] === "none"
-                ? 0
-                : theme.rounded[RADIUS_MAP[rounded] as keyof Theme["rounded"]],
+            borderRadius: radiusKey === "none" ? 0 : theme.rounded[radiusKey],
             padding:
               isNumber(padding)
                 ? theme.spacing(padding)

web/src/components/ui_primitives/ThemeToggleButton.tsx

@@ -71,7 +71,7 @@ export const ThemeToggleButtonInternal: React.FC<ThemeToggleButtonProps> = ({
         <Switch
           checked={isDark}
           onChange={handleToggle}
-          slotProps={{ input: { "aria-label": tooltipText, role: "switch" } as React.InputHTMLAttributes<HTMLInputElement> }}
+          slotProps={{ input: { "aria-label": tooltipText, role: "switch" } }}
           icon={<LightModeIcon fontSize="small" />}
           checkedIcon={<DarkModeIcon fontSize="small" />}
           size={buttonSize === "large" ? "medium" : "small"}