К основному содержанию
правило CX Codex

types — правило для Claude Code: что делает и как установить

Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах.

Apache-2.0 ★ 141 обновлён 2026-11-17

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/types.md
Открыть на GitHub

Что делает types

Это правило описывает принципы создания компонентов, которые легко расширять и использовать повторно. Внутри собраны рекомендации по расширению встроенных атрибутов HTML, именованию типов и способам работы с конфликтами имён пропсов. Также охвачены темы композиции через несколько мелких элементов и создания полиморфных компонентов.

При использовании правила агент автоматически применяет эти стандарты при написании и рефакторинге компонентов, что упрощает масштабирование интерфейсов. Для активации достаточно разместить файл с правилами в соответствующую директорию, например .claude/rules/, .cursor/rules/ или .clinerules/ в зависимости от среды разработки.

Какие задачи решает

  • Типизировать пропсы React-компонентов
  • Избежать конфликтов имён в пропсах
  • Создать гибкие полиморфные компоненты
  • Расширить стандартные атрибуты HTML

Примеры запросов агенту

  • Приведи описание пропсов компонента Card к стандарту типов
  • Исправь типизацию, чтобы избежать конфликта имён с атрибутом title
  • Создай полиморфный Button с поддержкой стандартных атрибутов HTML

Как установить types

Вручную: положить файлы

.claude/rules/types.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о types

Как установить правило types в Claude Code?

Создайте файл .claude/rules/types.md в корне проекта и скопируйте туда содержимое правила из репозитория maxtrigify/Otto.

Что делает правило types?

Оно задаёт стандарты типизации компонентов на TypeScript. Это помогает избежать ошибок и обеспечивает единообразие интерфейсов во всём проекте.

Что нужно для работы этого правила?

В проекте необходимы TypeScript и React, так как правило напрямую опирается на React.ComponentProps.

Исходный текст

types.md · Apache-2.0
---
title: Component Types
impact: HIGH
impactDescription: Type-safe, flexible component interfaces
tags: types, typescript, props, html-attributes, export, single-element
---

## Component Types

Proper typing is essential for creating flexible, customizable, and type-safe component interfaces.

### Single Element Wrapping

Each exported component should wrap a single HTML or JSX element:

**Incorrect (hard to customize):**

```tsx
const Card = ({ title, description, footer, ...props }) => (
  <div {...props}>
    <div className="card-header">
      <h2>{title}</h2>
      <p>{description}</p>
    </div>
    <div className="card-footer">{footer}</div>
  </div>
);
```

**Correct (composable, each layer customizable):**

```tsx
<Card.Root>
  <Card.Header>
    <Card.Title>Title</Card.Title>
    <Card.Description>Description</Card.Description>
  </Card.Header>
  <Card.Footer>Footer</Card.Footer>
</Card.Root>
```

### Extending HTML Attributes

Every component should extend native HTML attributes:

```tsx
export type CardRootProps = React.ComponentProps<"div"> & {
  variant?: "default" | "outlined";
};

export const CardRoot = ({ variant = "default", ...props }: CardRootProps) => (
  <div {...props} />
);
```

**Common HTML Attribute Types:**

```tsx
type DivProps = React.ComponentProps<"div">;
type ButtonProps = React.ComponentProps<"button">;
type InputProps = React.ComponentProps<"input">;
type FormProps = React.ComponentProps<"form">;
type LinkProps = React.ComponentProps<"a">;
```

### Exporting Types

Always export prop types for consumers:

```tsx
// Enables type extraction
import type { CardRootProps } from "@/components/ui/card";
type Variant = CardRootProps["variant"];

// Enables extending
export type ExtendedCardProps = CardRootProps & { isLoading?: boolean };

// Enables wrapper components
const MyCard = (props: CardRootProps) => (
  <CardRoot {...props} className={cn("my-custom-class", props.className)} />
);
```

**Naming convention:** Export types as `<ComponentName>Props`.

### Best Practices

**1. Always Spread Props Last:**

```tsx
// ✅ User props override defaults
<div className="default-class" {...props} />

// ❌ Defaults override user props
<div {...props} className="default-class" />
```

**2. Avoid Prop Name Conflicts:**

```tsx
// ❌ Conflicts with HTML title attribute
type CardProps = React.ComponentProps<"div"> & { title: string };

// ✅ Use a different name
type CardProps = React.ComponentProps<"div"> & { heading: string };
```

**3. Document Custom Props:**

```tsx
export type DialogProps = React.ComponentProps<"div"> & {
  /** Whether the dialog is currently open */
  open: boolean;
  /** Callback when the dialog requests to be closed */
  onOpenChange: (open: boolean) => void;
  /** Whether to render the dialog in a portal */
  modal?: boolean;
};
```

### Polymorphic Types

For components that can render as different elements:

```tsx
type PolymorphicProps<E extends React.ElementType> = {
  as?: E;
} & React.ComponentPropsWithoutRef<E>;

function Component<E extends React.ElementType = "div">({
  as,
  ...props
}: PolymorphicProps<E>) {
  const Element = as || "div";
  return <Element {...props} />;
}
```

### Quick Reference

| Pattern | Usage | Example |
| --- | --- | --- |
| Basic extension | Extend single HTML element | `React.ComponentProps<'div'>` |
| Custom props | Add component-specific props | `React.ComponentProps<'button'> & { variant?: string }` |
| Polymorphic | Render as different elements | `PolymorphicProps<T>` |
| Type extraction | Get specific prop type | `CardProps['variant']` |
| Type extension | Extend existing component props | `CardProps & { isLoading?: boolean }` |

© maxtrigify · Apache-2.0 · maxtrigify/Otto

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
narrow-react-prop-types humanlayer Скилл narrow-react-prop-types сужает типы пропсов React-компонента до контракта, который реально используется в живом коде, и заставляет сторис и тесты подстроиться под него. CX Codex +1 1 500установок generate-types-from-supabase przeprogramowani Команда generate-types-from-supabase анализирует схему Supabase и генерирует TypeScript типы для DTO и Command Models. Экономит время на ручном описании структур данных. CX Codex +1 ★ 267звёзд репо roblox-luau-types TabooHarmony Скилл roblox-luau-types для аннотаций типов Luau: дженерики, юнионы, сужение типов, строгий режим, экспорт типов из модулей. Пригодится при миграции на --!strict. CX Codex +1 3 400установок typescript-expert PCL Team Скилл typescript-expert для экспертной разработки на TypeScript 5.0+ со строгой типизацией, современными инструментами сборки и тестирования. CX Codex +1 187установок typescript PatrickJS Правило задаёт агенту Cursor единый стиль TypeScript: типы, имена, обработку ошибок. Обеспечивает согласованность кода в многоразработческих проектах. CX Codex +1 ★ 41 178звёзд репо react-composition-2026 patterns.dev Скилл react-composition-2026 учит агента заменять булевы пропсы и жёсткие API компонентов на композицию: compound-компоненты, явные варианты, children вместо render props. CX Codex +1 1 200установок

Из того же набора18

Весь набор →
marketplaces Правило marketplaces для Claude Code систематизирует поиск и интеграцию компонентов из внешних реестров. Оно помогает агенту оценивать качество готового кода перед добавлением в проект. CX Codex +1 ★ 141звёзд репо design-tokens Правило design-tokens для Claude Code заменяет жёстко заданные цвета семантическими токенами. Переключение светлой и тёмной темы меняет значения переменных, а не классы компонентов. CX Codex +1 ★ 141звёзд репо composition Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов. CX Codex +1 ★ 141звёзд репо overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо data-attributes Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов. CX Codex +1 ★ 141звёзд репо principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой