No Native Properties Spread

ErrorRoblox

small-rules/no-native-properties-spread

Disallow spreading static property bags into nativeProperties/*NativeProperties props and onto JSX elements via intermediate objects, because the spread creates a new copied table every render.

Rationale

Spreading a static property bag into nativeProperties (or onto a JSX element through an intermediate object) allocates a brand new table every single render. Pointless garbage if the bag never changes.

This catches spreads where the source is a literal object or a module-level constant – anything that’s deterministic. Inline the properties directly on the element instead and skip the copy.

Diagnostic Messages

noElementSpread

Spreading static property bag {{source}} through an intermediate object creates a new table every render. Inline the full object properties directly on the JSX element.

noNativePropertiesSpread

Spreading static property bag {{source}} into {{prop}} creates a new table every render. Pass it directly or inline the full object instead.

Configuration

This rule does not accept options.

{
  "jsPlugins": [
    "@pobammer-ts/small-rules"
  ],
  "rules": {
    "small-rules/no-native-properties-spread": "error"
  }
}

Examples

native properties spread

const SOME_CONSTANT = {};
const view = <Frame nativeProperties={{ ...SOME_CONSTANT, Text: "hello" }} />;

direct native properties reference

const view = <Frame nativeProperties={SOME_CONSTANT} />;

Related Rules

Prefer Hoisted Jsx Object PropertiesRelatedBoth stop per-render table/object copies from invalidating memoized Roblox UI.No Inline Property On Memo ComponentRelatedSpreading property bags is a Roblox-specific form of the inline-unstable-props problem.