@neurocle/synapse-react 0.0.0-bootstrap → 0.0.0-stage

package/skills/components/toast/SKILL.md

@@ -1,129 +0,0 @@
----
-name: 'toast'
-description: 'Toast — 시스템 상태를 한 줄로 알리는 어두운 알림입니다. 제품이 어디서든 명령할 수 있는 큐이며 애플리케이션 가장자리에 한 번만 렌더링되고, 한 번에 하나만 보이며 3초 뒤 스스로 사라집니다. 다른 이름: toast, notification, flash message, status message, 토스트, 토스트 알림, 알림 메시지.'
-metadata:
-  package: '@neurocle/synapse-react'
-  packageVersion: '0.3.0'
-  registryEntry: 'packages/registry/data/components/toast.json'
-  registryStructuralVersion: '0.3.0'
-  lifecycle: 'active'
-  generator: 'packages/react/src/skills/generate.ts'
----
-
-<!--
-생성된 파일 — 손으로 고치지 않습니다.
-
-Source:     packages/registry/data/components/toast.json (항목 구조 0.3.0)
-Generator:  packages/react/src/skills/generate.ts
-Regenerate: npx nx run react:skills:generate
-
-아래에서 이 컴포넌트에 대해 말하는 모든 문장은 그 항목의 필드입니다. 여기서 고친 내용은 다음
-재생성 때 지워지고, 손으로 설명한 컴포넌트는 아무것도 실패하지 않은 채 설명과 어긋납니다.
-대신 항목을 고칩니다.
--->
-
-# Toast
-
-> 시스템 상태를 한 줄로 알리는 어두운 알림입니다. 제품이 어디서든 명령할 수 있는 큐이며 애플리케이션 가장자리에 한 번만 렌더링되고, 한 번에 하나만 보이며 3초 뒤 스스로 사라집니다.
-
-`@neurocle/synapse-react` 0.3.0에서 생성했습니다. 설치된 버전이 이 버전이 아니면, 이 페이지의 어떤 내용보다 설치된 패키지 안에 함께 배포된 Registry를 우선합니다.
-
-- 패키지: `@neurocle/synapse-react`
-- 내보내기: `Toast`
-- 분류: `floating-and-overlay`
-- 수명 주기: `active`
-
-## Do
-
-> 사용자가 따로 할 일이 없는 시스템 상태를 잠깐 알릴 때 쓰세요 — 저장 완료, 복사 완료, 이미지 복사 실패처럼 한 줄로 충분한 결과입니다. croissant 토스트를 따라 상태 아이콘과 문구, 닫기 버튼만 담으며, 3초 뒤 사라지고 가리키거나 창이 포커스를 잃은 동안에는 멈춥니다. 한 번에 하나만 보이고 새 토스트가 이전 것을 대신하며, 기본 위치는 아래 가운데입니다.
-
-## Don't
-
-> 사용자가 결과를 확인해야 하거나 곧바로 할 동작(`View`, `Retry`)이 있으면 쓰지 마세요 — 그것은 닫을 때까지 남는 Snackbar입니다. 사용자가 반드시 대응해야 하는 것에도 쓰지 마세요. 그것은 Dialog입니다. 폼의 오류는 그것을 일으킨 필드 옆에 두세요.
-
-## Anti-patterns
-
-> 알림을 보내는 트리 부분 안에 영역을 렌더링하는 것. 토스트는 애플리케이션 곳곳의 이벤트 핸들러, 인터셉터, 이펙트에서 만들어지므로, 큐는 `createToaster`로 한 번 만들어 `ToastProvider`로 트리에 전달하고 `Toast.Root`는 가장자리에 한 번만 마운트하세요. 기능마다 영역을 마운트하면 제품에 서로를 모르는 스택이 두 개 생기고, 컴포넌트 안에서 만든 큐는 마운트되기 전에 발생한 모든 알림을 잃습니다.
-
-Registry는 이 컴포넌트의 안내를 `reviewed`로 기록합니다(검토일 2026-09-26).
-
-## 관련 컴포넌트
-
-- `Dialog` (`dialog`)
-- `Drawer` (`drawer`)
-- `Snackbar` (`snackbar`)
-- `Tooltip` (`tooltip`)
-
-## 가져오기
-
-```tsx
-import { Toast } from '@neurocle/synapse-react'
-```
-
-## Anatomy
-
-React 네임스페이스가 노출하는 part 1개를 항목의 `parts.containment`가 기록한 대로 조합했습니다. 한 part가 놓일 수 있는 정당한 자리가 둘 이상이면 스니펫은 첫 번째를 쓰고, 아래 목록이 나머지를 알려 줍니다.
-
-```tsx
-<Toast.Root />
-```
-
-- `Toast.Root` — `Group` 안에 놓입니다
-
-### React 네임스페이스가 노출하지 않는 anatomy part
-
-- `Group`
-- `Title`
-- `Description`
-- `ActionTrigger`
-- `CloseTrigger`
-
-## Props
-
-빌드가 방출하는 선언에서 도출한 prop 4개. 선언에는 기본값을 둘 자리가 없으므로 prop 기록에는 기본값이 없습니다. 기본값이 있다면 그 prop의 설명에 적혀 있습니다.
-
-모든 prop이 선택입니다. 아무것도 넘기지 않으면 컴포넌트는 비제어로 동작합니다.
-
-### 선택
-
-- `toaster` — `Toaster`, 선택. 이 영역이 렌더하는 토스터입니다. 선택 사항인 이유는 보통 `ToastProvider`로 들어오기 때문입니다. 트리를 감싼 제품은 어느 큐인지 이미 말한 셈이고, 영역에서 그것을 되풀이하면 둘이 어긋날 수 있는 자리가 하나 더 생깁니다.
-- `translations` — `TranslationOverrides`, 선택. 이 영역에만 적용되는 접근성 문자열로, provider의 값보다 우선합니다.
-- `size` — `Size`, 선택. 하나뿐인 공용 척도를 따릅니다. 모든 컴포넌트와 마찬가지로 기본값은 `md`입니다.
-- `id` — `string`, 선택. 팩토리가 만드는 식별자를 덮어씁니다. 서버와 클라이언트에서 같은 값으로 유지됩니다.
-
-## Variants
-
-- `size` — `xs`, `sm`, `md`, `lg`, `xl`. 기본값은 `md`. 크기 축은 알림 하나의 크기 — 패딩, 액션 버튼, 닫기 대상 — 를 정합니다. 영역 자체의 범위는 뷰포트의 범위입니다. 알림 스택은 페이지 안에 배치되는 것이 아니라 화면을 기준으로 위치가 정해지기 때문입니다.
-
-## 폼
-
-폼 참여: 아니요.
-
-> 폼에 제출하는 값이 없습니다.
-
-## 이 컴포넌트에 일부러 없는 것
-
-- `empty-state` — 큐가 비어 있으면 빈 영역이 아니라 영역 자체를 렌더링하지 않습니다. 아무것도 담지 않은 채 보이는 알림 영역은 제품 레이아웃에 뚫린 영구적인 구멍이고, 그 안에 들어갈 메시지도 없습니다.
-- `loading-state` — 무언가를 로딩 중이라는 알림 자체가 토스트이며, `loading` 타입으로 만들고 작업이 끝나면 갱신합니다. 로딩 part는 machine이 이미 가진 상태보다 한 단계 위에서 같은 말을 하는 두 번째 방식이 될 뿐입니다.
-- `error-state` — 실패는 영역의 상태가 아니라 `error` 타입의 토스트입니다. 영역에는 실패할 수 있는 자체 작업이 없습니다 — 저장소가 가진 것을 렌더링할 뿐입니다.
-
-## 접근성
-
-### 접근 가능한 이름
-
-> 영역은 provider의 `toast.group.label`에서 이름을 가져오고, 각 알림은 제품이 `create`로 제공한 제목으로 이름이 붙습니다.
-
-### 포커스
-
-> 알림은 나타날 때 결코 포커스를 가져가지 않습니다 — 이것이 토스트와 대화상자를 구분하는 속성이며, 포커스를 빼앗는다면 사용자가 하던 일을 방해하면서까지 사용자가 요청하지도 않은 것을 알리게 됩니다. 포커스는 machine의 단축키를 통해서만 영역에 들어가며, 각 알림 양쪽의 고스트 요소가 들어간 뒤의 순서를 예측 가능하게 만듭니다.
-
-## 로케일과 컬렉션
-
-- 로케일 의존: 예. 닫기 버튼의 이름은 provider의 번역에서 오고, 영역은 텍스트 방향을 provider에서 가져오므로 오른쪽에서 왼쪽으로 쓰는 제품은 그에 맞게 알림을 쌓고 정렬합니다.
-- 컬렉션 윈도잉: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-
-## 기능 용어와 다른 이름
-
-- 다루는 기능: `transient-message`, `notification-queue`, `translatable-strings`.
-- 다른 이름: `toast`, `notification`, `flash message`, `status message`, `토스트`, `토스트 알림`, `알림 메시지`.
-- 어휘 상태: `controlled`.

package/skills/components/toc/SKILL.md

@@ -1,141 +0,0 @@
----
-name: 'toc'
-description: 'Toc — 문서의 제목들로 가는 링크 모음이며, 현재 화면에 보이는 제목을 활성으로 표시합니다. 활성 여부는 스크롤 오프셋으로 계산하는 대신 문서 자체를 관찰해 판단합니다. 다른 이름: toc, table of contents, on this page, outline, anchor nav, 목차, 페이지 목차, 이 페이지에서, 앵커 내비게이션.'
-metadata:
-  package: '@neurocle/synapse-react'
-  packageVersion: '0.3.0'
-  registryEntry: 'packages/registry/data/components/toc.json'
-  registryStructuralVersion: '0.3.0'
-  lifecycle: 'active'
-  generator: 'packages/react/src/skills/generate.ts'
----
-
-<!--
-생성된 파일 — 손으로 고치지 않습니다.
-
-Source:     packages/registry/data/components/toc.json (항목 구조 0.3.0)
-Generator:  packages/react/src/skills/generate.ts
-Regenerate: npx nx run react:skills:generate
-
-아래에서 이 컴포넌트에 대해 말하는 모든 문장은 그 항목의 필드입니다. 여기서 고친 내용은 다음
-재생성 때 지워지고, 손으로 설명한 컴포넌트는 아무것도 실패하지 않은 채 설명과 어긋납니다.
-대신 항목을 고칩니다.
--->
-
-# Toc
-
-> 문서의 제목들로 가는 링크 모음이며, 현재 화면에 보이는 제목을 활성으로 표시합니다. 활성 여부는 스크롤 오프셋으로 계산하는 대신 문서 자체를 관찰해 판단합니다.
-
-`@neurocle/synapse-react` 0.3.0에서 생성했습니다. 설치된 버전이 이 버전이 아니면, 이 페이지의 어떤 내용보다 설치된 패키지 안에 함께 배포된 Registry를 우선합니다.
-
-- 패키지: `@neurocle/synapse-react`
-- 내보내기: `Toc`
-- 분류: `disclosure-layout-display`
-- 수명 주기: `active`
-
-## Do
-
-> 제목을 따라 이동할 가치가 있고, 사용자가 현재 위치를 아는 것이 도움이 되는 긴 문서에 쓰세요 — 문서화, 긴 아티클, 서비스 약관처럼 말입니다. 대안이 손으로 쓴 앵커 목록일 때 선택하세요. 활성 제목 추적이 제대로 만들기 어려운 부분이며, 이것이 컴포넌트로 존재하는 이유의 전부입니다.
-
-## Don't
-
-> 페이지 사이의 이동에는 쓰지 마세요. 그것은 내비게이션 메뉴이며, Toc의 활성 상태는 사이트 안에서 사용자의 위치가 아니라 화면에 무엇이 있는지에 관한 것입니다. 한 화면에서 스크롤로 훑을 수 있을 만큼 짧은 문서에도 쓰지 마세요 — 항목 세 개짜리 개요는 아껴 주는 것보다 사용자의 주의를 더 많이 씁니다. 제목이 문서의 실제 제목 요소가 아닌 곳에도 쓰지 마세요. 옵저버는 항목이 가리키는 요소에 붙으므로, 아무것도 가리키지 않는 항목은 영원히 활성화되지 않는 링크입니다.
-
-## Anti-patterns
-
-> href 없이 항목을 렌더링하는 것. machine의 클릭 핸들러는 이벤트가 발생한 요소에서 대상 해시를 읽으므로, href가 없는 항목은 단지 스타일이 빠진 것이 아닙니다 — 키보드로 닿을 수 없고, 가운데 클릭이나 새 탭에서 열기도 안 되며, 부드러운 스크롤도 실행되지 않습니다. 컴포넌트가 DOM 속성을 추론할 틈이 없으므로, href는 사용처가 절대 잊어서는 안 되는 단 하나입니다.
-
-Registry는 이 컴포넌트의 안내를 `reviewed`로 기록합니다(검토일 2026-09-22).
-
-## 관련 컴포넌트
-
-- `Accordion` (`accordion`)
-- `Tabs` (`tabs`)
-- `ScrollArea` (`scroll-area`)
-
-## 가져오기
-
-```tsx
-import { Toc } from '@neurocle/synapse-react'
-```
-
-## Anatomy
-
-React 네임스페이스가 노출하는 part 6개를 항목의 `parts.containment`가 기록한 대로 조합했습니다. 한 part가 놓일 수 있는 정당한 자리가 둘 이상이면 스니펫은 첫 번째를 쓰고, 아래 목록이 나머지를 알려 줍니다.
-
-```tsx
-<Toc.Root>
-  <Toc.Title />
-  <Toc.List>
-    <Toc.Item>
-      <Toc.Link />
-      <Toc.Indicator />
-    </Toc.Item>
-  </Toc.List>
-</Toc.Root>
-```
-
-- `Toc.Root` — 최상위에 놓입니다
-- `Toc.Title` — `Root` 안에 놓입니다
-- `Toc.List` — `Root` 안에 놓입니다
-- `Toc.Item` — `List` 안에 놓입니다
-- `Toc.Link` — `Item` 안에 놓입니다
-- `Toc.Indicator` — `Item` 안에 놓입니다
-
-## Props
-
-빌드가 방출하는 선언에서 도출한 prop 11개. 선언에는 기본값을 둘 자리가 없으므로 prop 기록에는 기본값이 없습니다. 기본값이 있다면 그 prop의 설명에 적혀 있습니다.
-
-### 필수
-
-- `items` — `readonly TocEntry[]`, 필수. 모든 제목을 문서 순서대로 담습니다. 필수입니다. 내용이 없는 목차는 이 컴포넌트가 가질 수 있는 상태가 아니라, 애초에 렌더하지 말았어야 할 컴포넌트입니다.
-
-### 선택
-
-- `value` — `readonly string[]`, 선택. 지금 화면에 보이는 제목들이며 제어 모드입니다.
-- `defaultValue` — `readonly string[]`, 선택. 비제어 모드의 초기 활성 집합. `value`를 주면 무시됩니다.
-- `onValueChange` — `(details: ValueChangeDetails<readonly string[]>) => void`, 선택. 제어 여부와 무관하게 활성 집합이 바뀔 때마다 호출됩니다.
-- `rootMargin` — `string`, 선택. 옵저버의 루트 마진. 무엇까지를 화면 안으로 칠지 정합니다. CSS 마진 문자열이며 기본값은 `"-20px 0px -40% 0px"`입니다. 활성 제목을 뷰포트 위쪽으로 치우치게 잡아서, 긴 섹션의 중간쯤을 읽고 있는 사람이 다음 섹션이 아니라 지금 그 섹션이 표시된 것을 보게 합니다.
-- `threshold` — `number | readonly number[]`, 선택. 제목이 얼마나 보여야 하는지 정합니다. `0`이면 1픽셀만 보여도 됩니다.
-- `scrollEl` — `() => HTMLElement | null`, 선택. 관찰의 기준이 될 스크롤 컨테이너. 기본값은 문서입니다.
-- `autoScroll` — `boolean`, 선택. 활성 엔트리를 Toc 자체의 스크롤 박스 안에 계속 보이게 합니다. 기본값은 true입니다.
-- `scrollBehavior` — `TocScrollBehavior`, 선택. 엔트리를 따라갈 때 페이지가 움직이는 방식. 기본값은 `smooth`이며, 동작 줄이기 설정에서는 `smooth`가 `instant`로 바뀝니다.
-- `size` — `Size`, 선택. 하나뿐인 공용 척도를 따릅니다. 모든 컴포넌트와 마찬가지로 기본값은 `md`입니다.
-- `id` — `string`, 선택. 팩토리가 만드는 식별자를 덮어씁니다. 서버와 클라이언트에서 같은 값으로 유지됩니다.
-
-## Variants
-
-- `size` — `xs`, `sm`, `md`, `lg`, `xl`. 기본값은 `md`. 크기 축은 제목, 항목, 활성 항목 인디케이터의 크기를 정합니다. 컴포넌트 자체의 너비는 레이아웃이 정합니다 — 목차는 사이드바이거나 열이며, 그중 무엇인지는 다섯 단계 척도가 아니라 페이지가 정할 일입니다.
-
-## 폼
-
-폼 참여: 아니요.
-
-> 폼에 제출하는 값이 없습니다.
-
-## 이 컴포넌트에 일부러 없는 것
-
-- `empty-state` — `items`가 필수이므로 Toc는 자신이 설명하는 제목들을 항상 압니다. 제목이 없는 문서에는 목차가 없으며, 이는 이 컴포넌트가 표시하는 상태가 아니라 제품이 목차를 렌더링하기 전에 내리는 결정입니다.
-- `loading-state` — 항목은 제품이 이미 가진 데이터입니다. 나중에 도착하는 것은 문서이며, machine의 옵저버는 제목이 나타나는 대로 붙으므로 문서가 준비되기 전에 렌더링된 Toc에 따로 알려 줄 필요가 없습니다.
-- `error-state` — 존재하지 않는 제목을 가리키는 항목은 그저 활성화되지 않을 뿐입니다. 이는 컴포넌트의 상태가 아니라 콘텐츠의 실수이며, 오류로 드러내면 작성자만 고칠 수 있는 것에 사용자의 주의를 쏠리게 합니다.
-
-## 접근성
-
-### 접근 가능한 이름
-
-> 랜드마크는 machine의 aria-labelledby를 통해 Title part로 이름이 붙으므로, 내비게이션 영역이 여럿인 페이지에서도 서로 구분됩니다. 각 항목의 이름은 사용처의 콘텐츠이며, 보통 가리키는 제목의 텍스트입니다.
-
-### 포커스
-
-> 여기에는 의도적으로 로빙 tabindex가 없습니다. 목차는 링크 목록이고 링크 목록처럼 동작하므로, 브라우저 찾기, 가운데 클릭, 새 탭에서 열기가 모두 계속 작동합니다.
-
-## 로케일과 컬렉션
-
-- 로케일 의존: 예. 깊이 들여쓰기는 논리적 인라인 방향으로 적용되고 활성 인디케이터는 논리적 인라인 시작 가장자리에 놓이므로, 오른쪽에서 왼쪽으로 쓰는 로케일에서는 둘 다 이동합니다 — prop이 아니라 provider에 따라서 말입니다.
-- 컬렉션 윈도잉: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-
-## 기능 용어와 다른 이름
-
-- 다루는 기능: `table-of-contents`, `in-page-navigation`, `scroll-spy`, `current-page`, `hierarchy-display`.
-- 다른 이름: `toc`, `table of contents`, `on this page`, `outline`, `anchor nav`, `목차`, `페이지 목차`, `이 페이지에서`, `앵커 내비게이션`.
-- 어휘 상태: `controlled`.

package/skills/components/toggle/SKILL.md

@@ -1,125 +0,0 @@
----
-name: 'toggle'
-description: 'Toggle — 눌린 채로 머무는 버튼이며, 사용자가 작업하는 동안 켜져 있거나 꺼져 있는 모드를 위한 것입니다 — 굵은 텍스트, 적용된 필터, 고정해 둔 패널처럼 말입니다. 다른 이름: toggle, toggle button, pressed button, sticky button, mode button, 토글, 토글 버튼, 눌림 버튼, 모드 버튼.'
-metadata:
-  package: '@neurocle/synapse-react'
-  packageVersion: '0.3.0'
-  registryEntry: 'packages/registry/data/components/toggle.json'
-  registryStructuralVersion: '0.3.0'
-  lifecycle: 'active'
-  generator: 'packages/react/src/skills/generate.ts'
----
-
-<!--
-생성된 파일 — 손으로 고치지 않습니다.
-
-Source:     packages/registry/data/components/toggle.json (항목 구조 0.3.0)
-Generator:  packages/react/src/skills/generate.ts
-Regenerate: npx nx run react:skills:generate
-
-아래에서 이 컴포넌트에 대해 말하는 모든 문장은 그 항목의 필드입니다. 여기서 고친 내용은 다음
-재생성 때 지워지고, 손으로 설명한 컴포넌트는 아무것도 실패하지 않은 채 설명과 어긋납니다.
-대신 항목을 고칩니다.
--->
-
-# Toggle
-
-> 눌린 채로 머무는 버튼이며, 사용자가 작업하는 동안 켜져 있거나 꺼져 있는 모드를 위한 것입니다 — 굵은 텍스트, 적용된 필터, 고정해 둔 패널처럼 말입니다.
-
-`@neurocle/synapse-react` 0.3.0에서 생성했습니다. 설치된 버전이 이 버전이 아니면, 이 페이지의 어떤 내용보다 설치된 패키지 안에 함께 배포된 Registry를 우선합니다.
-
-- 패키지: `@neurocle/synapse-react`
-- 내보내기: `Toggle`
-- 분류: `form-controls`
-- 수명 주기: `active`
-
-## Do
-
-> 사용자가 작업 중인 대상 전체에 적용되며, 눌린 채 머무는 버튼으로 자연스럽게 읽히는 모드에 쓰세요 — 텍스트 에디터의 굵게, 툴바의 필터, 지도에 표시된 레이어처럼 말입니다. 효과가 화면의 다른 곳에서 보이기 때문에 눌림 상태가 컨트롤에 있어야 합니다.
-
-## Don't
-
-> 사용자가 제출하는 설정에는 Toggle을 쓰지 마세요 — 이름도, 폼도, 숨겨진 요소도 없어서 상태가 FormData에 결코 도달하지 않습니다. 폼에 참여하는 컨트롤은 Checkbox와 Switch입니다. 대안들 중 하나를 고르는 선택을 위해 Toggle을 한 줄로 늘어놓지 마세요. 버튼들이 함께 속한다는 사실을 사용자에게도 보조 기술에도 알려 주는 것이 없으며, 그것을 더해 주는 것이 ToggleGroup입니다. 켜진 채로 머물지 않는 동작을 수행하는 데 Toggle을 쓰지 마세요. 그것은 평범한 버튼입니다.
-
-## Anti-patterns
-
-> 스타일링에 `_checked`를 쓰는 것. machine은 aria-pressed, data-pressed, data-state="on"을 내보내는데, 그 조건은 이 중 어느 것과도 일치하지 않습니다 — 그래서 레시피는 컴파일되고 렌더링되지만 눌림 상태를 결코 보여 주지 않습니다. 올바른 조건은 `_pressed`이며, Switch와의 차이는 취향이 아니라 machine에 관한 사실입니다.
-
-Registry는 이 컴포넌트의 안내를 `reviewed`로 기록합니다(검토일 2026-09-22).
-
-## 관련 컴포넌트
-
-- `ToggleGroup` (`toggle-group`)
-- `Switch` (`switch`)
-- `Checkbox` (`checkbox`)
-
-## 가져오기
-
-```tsx
-import { Toggle } from '@neurocle/synapse-react'
-```
-
-## Anatomy
-
-React 네임스페이스가 노출하는 part 2개를 항목의 `parts.containment`가 기록한 대로 조합했습니다. 한 part가 놓일 수 있는 정당한 자리가 둘 이상이면 스니펫은 첫 번째를 쓰고, 아래 목록이 나머지를 알려 줍니다.
-
-```tsx
-<Toggle.Root>
-  <Toggle.Indicator />
-</Toggle.Root>
-```
-
-- `Toggle.Root` — 최상위에 놓입니다
-- `Toggle.Indicator` — `Root` 안에 놓입니다
-
-## Props
-
-빌드가 방출하는 선언에서 도출한 prop 6개. 선언에는 기본값을 둘 자리가 없으므로 prop 기록에는 기본값이 없습니다. 기본값이 있다면 그 prop의 설명에 적혀 있습니다.
-
-모든 prop이 선택입니다. 아무것도 넘기지 않으면 컴포넌트는 비제어로 동작합니다.
-
-### 선택
-
-- `value` — `boolean`, 선택. 제어되는 눌림 상태.
-- `defaultValue` — `boolean`, 선택. 비제어 모드의 초기 눌림 상태. `value`를 주면 무시됩니다.
-- `onValueChange` — `(details: ValueChangeDetails<boolean>) => void`, 선택. 제어 여부와 무관하게 눌림 상태가 바뀔 때마다 호출됩니다.
-- `disabled` — `boolean`, 선택. 비활성화된 Toggle은 반응하지 않습니다.
-- `size` — `Size`, 선택. 하나뿐인 공용 척도를 따릅니다. 모든 컴포넌트와 마찬가지로 기본값은 `md`입니다.
-- `id` — `string`, 선택. 렌더된 버튼의 식별자. 이 machine은 식별자를 만들지 않아서, 버튼의 `id`는 여기서 준 값뿐입니다.
-
-## Variants
-
-- `size` — `xs`, `sm`, `md`, `lg`, `xl`. 기본값은 `md`.
-
-## 폼
-
-폼 참여: 아니요.
-
-> machine은 `name`, `form`, 숨겨진 요소 중 어느 것도 선언하지 않습니다. Toggle은 눌린 곳에서 작동합니다. 제출 후에도 남아야 하는 이진 선택은 Checkbox나 Switch입니다.
-
-## 이 컴포넌트에 일부러 없는 것
-
-- `empty-state` — 컬렉션이 아니라 하나의 이진 모드를 가지므로 비어 있을 수 있는 집합이 없습니다. 모드가 적용되지 않는 Toggle은 비활성화하거나 렌더링하지 않아야 하며, 둘 중 어느 것도 빈 상태가 아닙니다.
-- `loading-state` — 아직 들어갈 수 없는 모드는 비활성화된 Toggle입니다. 로딩 part를 주면 사용할 수 없음을 표현하는 두 번째 방식이 생기고, 둘 중 하나만 갱신되는 첫 순간부터 두 방식이 어긋나게 됩니다.
-- `error-state` — Toggle은 폼에 참여하지 않고 검증할 값도 없습니다. `invalid` prop도, 그것이 보고할 제약도 없습니다. 무엇이 실패했든 그것은 Toggle이 촉발한 동작의 몫이며, 그 동작이 있는 곳에서 알립니다.
-
-## 접근성
-
-### 접근 가능한 이름
-
-> 버튼 자체의 콘텐츠입니다. Indicator만 렌더링하는 Toggle은 glyph가 aria-hidden이므로 접근 가능한 이름이 없습니다 — 텍스트를 주거나, 사용처가 관리하는 aria-label을 주세요.
-
-### 포커스
-
-> root가 곧 버튼이며 유일하게 포커스 가능한 요소입니다. 팩토리는 machine이 내보내는 `type="button"`에서 `button` 요소를 추론하며, 이것이 aria-pressed를 그것을 가질 수 있도록 허용된 요소에 유지시킵니다.
-
-## 로케일과 컬렉션
-
-- 로케일 의존: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-- 컬렉션 윈도잉: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-
-## 기능 용어와 다른 이름
-
-- 다루는 기능: `pressed-state`, `toolbar-control`.
-- 다른 이름: `toggle`, `toggle button`, `pressed button`, `sticky button`, `mode button`, `토글`, `토글 버튼`, `눌림 버튼`, `모드 버튼`.
-- 어휘 상태: `controlled`.

package/skills/components/toggle-group/SKILL.md

@@ -1,129 +0,0 @@
----
-name: 'toggle-group'
-description: 'ToggleGroup — 서로를 아는 여러 개의 토글입니다. 공유되는 단일 선택 또는 다중 선택, 선언된 축을 따른 화살표 키 이동, 그리고 그룹 전체에 대한 하나의 탭 정지 지점을 가집니다. 다른 이름: toggle group, button group, segmented buttons, view switcher, filter bar, 토글 그룹, 버튼 그룹, 세그먼트 버튼, 보기 전환 버튼.'
-metadata:
-  package: '@neurocle/synapse-react'
-  packageVersion: '0.3.0'
-  registryEntry: 'packages/registry/data/components/toggle-group.json'
-  registryStructuralVersion: '0.3.0'
-  lifecycle: 'active'
-  generator: 'packages/react/src/skills/generate.ts'
----
-
-<!--
-생성된 파일 — 손으로 고치지 않습니다.
-
-Source:     packages/registry/data/components/toggle-group.json (항목 구조 0.3.0)
-Generator:  packages/react/src/skills/generate.ts
-Regenerate: npx nx run react:skills:generate
-
-아래에서 이 컴포넌트에 대해 말하는 모든 문장은 그 항목의 필드입니다. 여기서 고친 내용은 다음
-재생성 때 지워지고, 손으로 설명한 컴포넌트는 아무것도 실패하지 않은 채 설명과 어긋납니다.
-대신 항목을 고칩니다.
--->
-
-# ToggleGroup
-
-> 서로를 아는 여러 개의 토글입니다. 공유되는 단일 선택 또는 다중 선택, 선언된 축을 따른 화살표 키 이동, 그리고 그룹 전체에 대한 하나의 탭 정지 지점을 가집니다.
-
-`@neurocle/synapse-react` 0.3.0에서 생성했습니다. 설치된 버전이 이 버전이 아니면, 이 페이지의 어떤 내용보다 설치된 패키지 안에 함께 배포된 Registry를 우선합니다.
-
-- 패키지: `@neurocle/synapse-react`
-- 내보내기: `ToggleGroup`
-- 분류: `form-controls`
-- 수명 주기: `active`
-
-## Do
-
-> 함께 속하며 탭 순서에서 하나의 정지 지점이어야 하는, 작고 고정된 뷰·서식 컨트롤 묶음에 쓰세요 — 텍스트 정렬, 목록/그리드 전환, 지도 레이어 묶음처럼 말입니다. 정확히 하나만 적용될 때는 단일 선택, 몇 개든 적용될 수 있을 때는 다중 선택으로 쓰세요.
-
-## Don't
-
-> 폼과 함께 제출되는 선택에는 쓰지 마세요. 이름도 숨겨진 요소도 없어 FormData에 아무것도 도달하지 않으며, 폼에 참여하는 컨트롤은 RadioGroup입니다. 선택지가 길거나, 많거나, 데이터에서 오는 경우에도 쓰지 마세요 — 모든 항목이 항상 렌더링되고 항상 닿을 수 있으며, 그래서 몇 개를 넘어서면 Select가 알맞은 컨트롤입니다. 내비게이션 바로도 쓰지 마세요. 항목을 누르면 페이지가 아니라 값이 바뀌며, 그렇지 않다고 말하는 패턴은 Tabs입니다.
-
-## Anti-patterns
-
-> `multiple`에 따라 `value`의 타입이 바뀌게 하는 것. 두 모드 모두에서 배열이며, 그 이유는 Select와 같습니다. 하나만 선택된 것도 여전히 선택이고, 형제 prop이 바뀔 때 모양이 바뀌는 prop은 어떤 사용처도 타입을 맞출 수 없는 prop입니다.
-
-Registry는 이 컴포넌트의 안내를 `reviewed`로 기록합니다(검토일 2026-09-22).
-
-## 관련 컴포넌트
-
-- `Toggle` (`toggle`)
-- `RadioGroup` (`radio-group`)
-- `Checkbox` (`checkbox`)
-
-## 가져오기
-
-```tsx
-import { ToggleGroup } from '@neurocle/synapse-react'
-```
-
-## Anatomy
-
-React 네임스페이스가 노출하는 part 2개를 항목의 `parts.containment`가 기록한 대로 조합했습니다. 한 part가 놓일 수 있는 정당한 자리가 둘 이상이면 스니펫은 첫 번째를 쓰고, 아래 목록이 나머지를 알려 줍니다.
-
-```tsx
-<ToggleGroup.Root>
-  <ToggleGroup.Item />
-</ToggleGroup.Root>
-```
-
-- `ToggleGroup.Root` — 최상위에 놓입니다
-- `ToggleGroup.Item` — `Root` 안에 놓입니다
-
-## Props
-
-빌드가 방출하는 선언에서 도출한 prop 10개. 선언에는 기본값을 둘 자리가 없으므로 prop 기록에는 기본값이 없습니다. 기본값이 있다면 그 prop의 설명에 적혀 있습니다.
-
-모든 prop이 선택입니다. 아무것도 넘기지 않으면 컴포넌트는 비제어로 동작합니다.
-
-### 선택
-
-- `value` — `readonly string[]`, 선택. 제어되는 선택. `multiple`을 켜지 않았다면 항목이 하나입니다.
-- `defaultValue` — `readonly string[]`, 선택. 비제어 모드의 초기 선택. `value`를 주면 무시됩니다.
-- `onValueChange` — `(details: ValueChangeDetails<readonly string[]>) => void`, 선택. 제어 여부와 무관하게 선택이 바뀔 때마다 호출됩니다.
-- `multiple` — `boolean`, 선택. 한 번에 둘 이상의 아이템이 눌려 있도록 허용합니다.
-- `deselectable` — `boolean`, 선택. 눌린 아이템을 다시 누르면 해제됩니다. 기본값은 true이고, `multiple`일 때는 무시됩니다.
-- `loopFocus` — `boolean`, 선택. 화살표 키 이동이 양 끝을 넘어가면 반대쪽으로 돌아옵니다. 기본값은 true입니다.
-- `orientation` — `Orientation`, 선택. 그룹이 배치되는 축이자, 그 축을 따라 움직이는 화살표 키를 정합니다.
-- `disabled` — `boolean`, 선택. 비활성화된 ToggleGroup은 반응하지 않고, 그 안의 어떤 아이템도 반응하지 않습니다.
-- `size` — `Size`, 선택. 하나뿐인 공용 척도를 따릅니다. 모든 컴포넌트와 마찬가지로 기본값은 `md`입니다.
-- `id` — `string`, 선택. 팩토리가 만드는 식별자를 덮어씁니다. 서버와 클라이언트에서 같은 값으로 유지됩니다.
-
-## Variants
-
-- `size` — `xs`, `sm`, `md`, `lg`, `xl`. 기본값은 `md`.
-
-## 폼
-
-폼 참여: 아니요.
-
-> machine은 `name`, `form`, 숨겨진 요소 중 어느 것도 선언하지 않습니다. 제출 후에도 남아야 하는 선택은, 여럿 중 하나라면 RadioGroup이고 여럿 중 아무것이나라면 Checkbox 묶음입니다.
-
-## 이 컴포넌트에 일부러 없는 것
-
-- `empty-state` — 항목은 컴포넌트가 보관하는 데이터로 주어지는 것이 아니라 사용처가 자신의 마크업으로 작성하므로, 컴포넌트는 집합이 비어서 돌아왔다는 사실을 결코 알 수 없습니다. 아무것도 없는 그룹은 사용처가 렌더링하기 전에 이미 처리한 분기입니다.
-- `loading-state` — 선택지가 아직 도착하지 않은 그룹은 아직 렌더링되지 않은 그룹입니다. 항목이 데이터가 아니라 마크업이므로, 사용처는 모르는데 컴포넌트만 기다리고 있다는 것을 아는 순간이 존재하지 않습니다.
-- `error-state` — machine은 `invalid` prop을 노출하지 않고 그룹은 폼 제출에 참여하지 않으므로, 오류 part가 보고할 제약이 없습니다. 검증이 필요한 선택은 실제로 폼에 참여하고 유효하지 않음을 보고하는 RadioGroup에 속합니다.
-
-## 접근성
-
-### 접근 가능한 이름
-
-> 그룹에는 자체 레이블 part가 없으므로 이름은 사용처가 제공합니다 — 자체 제목을 가리키는 aria-labelledby나 aria-label로 말입니다. 뷰 컨트롤 그룹에는 보통 보이는 제목이 이미 있으며, 없는 그룹에는 이름을 지정해야 합니다.
-
-### 포커스
-
-> 로빙 tabindex입니다. 그룹은 탭 순서에서 하나의 정지 지점이고 화살표 키가 그 안에서 이동합니다. machine이 제공하는 `rovingFocus` prop은 의도적으로 노출하지 않습니다. 이를 끄면 모든 항목이 탭 순서에 들어가, ARIA가 이런 형태의 컨트롤에 대해 정의한 복합 위젯 패턴을 버리게 되기 때문입니다.
-
-## 로케일과 컬렉션
-
-- 로케일 의존: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-- 컬렉션 윈도잉: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
-
-## 기능 용어와 다른 이름
-
-- 다루는 기능: `single-select`, `multi-select`, `segmented-control`, `toolbar-control`, `axis-orientation`.
-- 다른 이름: `toggle group`, `button group`, `segmented buttons`, `view switcher`, `filter bar`, `토글 그룹`, `버튼 그룹`, `세그먼트 버튼`, `보기 전환 버튼`.
-- 어휘 상태: `controlled`.