no-manual-children-property

Disallow manually declaring children in React component props when a configured wrapper type should provide it.

Rule details Type-aware

This rule enforces a wrapper-based children model for React component props. By default it expects PropertiesWithChildren and reports both:

• manual children declarations such as children?: ReactNode
• other wrapper styles such as PropsWithChildren unless you explicitly allow them

mode: "auto" uses type-aware resolution when project type information is available, then falls back to syntax-only inspection when it is not.

Hard cutover by default

The default configuration intentionally accepts only PropertiesWithChildren. If your codebase uses a different wrapper name, add it through wrapperNames.

Examples

Incorrect

Manual children declaration

import type { ReactNode } from "react";

interface FrameProperties {
  readonly position: UDim2;
  readonly zIndex?: number;
  readonly children?: ReactNode;
}

Correct

Wrapper-owned children

import type { PropertiesWithChildren } from "react";

interface FrameProperties extends PropertiesWithChildren {
  readonly position: UDim2;
  readonly zIndex?: number;
}

Options

Option	Type	Default	Notes
mode	"auto" | "fast" | "accurate"	"auto"	Chooses syntax-only, type-aware, or automatic behavior.
wrapperNames	string[]	["PropertiesWithChildren"]	Accepted wrapper names that are allowed to provide children.

import ceaseNonsense from "@pobammer-ts/eslint-cease-nonsense-rules";

export default [
  {
    plugins: {
      "cease-nonsense": ceaseNonsense,
    },
    rules: {
      "cease-nonsense/no-manual-children-property": [
        "error",
        {
          mode: "auto",
          wrapperNames: ["PropertiesWithChildren", "AppChildrenProps"],
        },
      ],
    },
  },
];

Related rules

ban-react-fcMoves component typing away from React.FC and toward direct prop signatures

prefer-read-only-propsKeeps component props immutable once their shape is established