@neurocle/synapse-react 0.0.0-stage → 0.3.0

package/package.json

@@ -1,6 +1,411 @@
 {
   "name": "@neurocle/synapse-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Synapse React components — the single public package",
+  "keywords": [
+    "accessibility",
+    "components",
+    "design-system",
+    "panda-css",
+    "react",
+    "tanstack-intent",
+    "zag-js"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neurocle/synapse.git",
+    "directory": "packages/react"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "!skills/README.md",
+    "!skills/synapse/REVIEW.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "imports": {
+    "#fixtures/*": "./fixtures/*",
+    "#spikes/*": "./spikes/*",
+    "#styled-system/*": "./styled-system/*",
+    "#tests/*": "./tests/*",
+    "#/*": "./src/*"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./preset": {
+      "types": "./dist/preset.d.mts",
+      "import": "./dist/preset.mjs"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./accordion": {
+      "types": "./dist/components/accordion/index.d.mts",
+      "import": "./dist/components/accordion/index.mjs"
+    },
+    "./alert": {
+      "types": "./dist/components/alert/index.d.mts",
+      "import": "./dist/components/alert/index.mjs"
+    },
+    "./angle-slider": {
+      "types": "./dist/components/angle-slider/index.d.mts",
+      "import": "./dist/components/angle-slider/index.mjs"
+    },
+    "./avatar": {
+      "types": "./dist/components/avatar/index.d.mts",
+      "import": "./dist/components/avatar/index.mjs"
+    },
+    "./badge": {
+      "types": "./dist/components/badge/index.d.mts",
+      "import": "./dist/components/badge/index.mjs"
+    },
+    "./breadcrumb": {
+      "types": "./dist/components/breadcrumb/index.d.mts",
+      "import": "./dist/components/breadcrumb/index.mjs"
+    },
+    "./button": {
+      "types": "./dist/components/button/index.d.mts",
+      "import": "./dist/components/button/index.mjs"
+    },
+    "./card": {
+      "types": "./dist/components/card/index.d.mts",
+      "import": "./dist/components/card/index.mjs"
+    },
+    "./carousel": {
+      "types": "./dist/components/carousel/index.d.mts",
+      "import": "./dist/components/carousel/index.mjs"
+    },
+    "./cascade-select": {
+      "types": "./dist/components/cascade-select/index.d.mts",
+      "import": "./dist/components/cascade-select/index.mjs"
+    },
+    "./checkbox": {
+      "types": "./dist/components/checkbox/index.d.mts",
+      "import": "./dist/components/checkbox/index.mjs"
+    },
+    "./clipboard": {
+      "types": "./dist/components/clipboard/index.d.mts",
+      "import": "./dist/components/clipboard/index.mjs"
+    },
+    "./collapsible": {
+      "types": "./dist/components/collapsible/index.d.mts",
+      "import": "./dist/components/collapsible/index.mjs"
+    },
+    "./color-picker": {
+      "types": "./dist/components/color-picker/index.d.mts",
+      "import": "./dist/components/color-picker/index.mjs"
+    },
+    "./combobox": {
+      "types": "./dist/components/combobox/index.d.mts",
+      "import": "./dist/components/combobox/index.mjs"
+    },
+    "./date-input": {
+      "types": "./dist/components/date-input/index.d.mts",
+      "import": "./dist/components/date-input/index.mjs"
+    },
+    "./date-picker": {
+      "types": "./dist/components/date-picker/index.d.mts",
+      "import": "./dist/components/date-picker/index.mjs"
+    },
+    "./dialog": {
+      "types": "./dist/components/dialog/index.d.mts",
+      "import": "./dist/components/dialog/index.mjs"
+    },
+    "./drawer": {
+      "types": "./dist/components/drawer/index.d.mts",
+      "import": "./dist/components/drawer/index.mjs"
+    },
+    "./editable": {
+      "types": "./dist/components/editable/index.d.mts",
+      "import": "./dist/components/editable/index.mjs"
+    },
+    "./empty-state": {
+      "types": "./dist/components/empty-state/index.d.mts",
+      "import": "./dist/components/empty-state/index.mjs"
+    },
+    "./field": {
+      "types": "./dist/components/field/index.d.mts",
+      "import": "./dist/components/field/index.mjs"
+    },
+    "./fieldset": {
+      "types": "./dist/components/fieldset/index.d.mts",
+      "import": "./dist/components/fieldset/index.mjs"
+    },
+    "./file-upload": {
+      "types": "./dist/components/file-upload/index.d.mts",
+      "import": "./dist/components/file-upload/index.mjs"
+    },
+    "./floating-panel": {
+      "types": "./dist/components/floating-panel/index.d.mts",
+      "import": "./dist/components/floating-panel/index.mjs"
+    },
+    "./hover-card": {
+      "types": "./dist/components/hover-card/index.d.mts",
+      "import": "./dist/components/hover-card/index.mjs"
+    },
+    "./image-cropper": {
+      "types": "./dist/components/image-cropper/index.d.mts",
+      "import": "./dist/components/image-cropper/index.mjs"
+    },
+    "./input": {
+      "types": "./dist/components/input/index.d.mts",
+      "import": "./dist/components/input/index.mjs"
+    },
+    "./kbd": {
+      "types": "./dist/components/kbd/index.d.mts",
+      "import": "./dist/components/kbd/index.mjs"
+    },
+    "./listbox": {
+      "types": "./dist/components/listbox/index.d.mts",
+      "import": "./dist/components/listbox/index.mjs"
+    },
+    "./marquee": {
+      "types": "./dist/components/marquee/index.d.mts",
+      "import": "./dist/components/marquee/index.mjs"
+    },
+    "./menu": {
+      "types": "./dist/components/menu/index.d.mts",
+      "import": "./dist/components/menu/index.mjs"
+    },
+    "./navigation-menu": {
+      "types": "./dist/components/navigation-menu/index.d.mts",
+      "import": "./dist/components/navigation-menu/index.mjs"
+    },
+    "./number-input": {
+      "types": "./dist/components/number-input/index.d.mts",
+      "import": "./dist/components/number-input/index.mjs"
+    },
+    "./pagination": {
+      "types": "./dist/components/pagination/index.d.mts",
+      "import": "./dist/components/pagination/index.mjs"
+    },
+    "./password-input": {
+      "types": "./dist/components/password-input/index.d.mts",
+      "import": "./dist/components/password-input/index.mjs"
+    },
+    "./pin-input": {
+      "types": "./dist/components/pin-input/index.d.mts",
+      "import": "./dist/components/pin-input/index.mjs"
+    },
+    "./popover": {
+      "types": "./dist/components/popover/index.d.mts",
+      "import": "./dist/components/popover/index.mjs"
+    },
+    "./progress": {
+      "types": "./dist/components/progress/index.d.mts",
+      "import": "./dist/components/progress/index.mjs"
+    },
+    "./qr-code": {
+      "types": "./dist/components/qr-code/index.d.mts",
+      "import": "./dist/components/qr-code/index.mjs"
+    },
+    "./radio-group": {
+      "types": "./dist/components/radio-group/index.d.mts",
+      "import": "./dist/components/radio-group/index.mjs"
+    },
+    "./rating-group": {
+      "types": "./dist/components/rating-group/index.d.mts",
+      "import": "./dist/components/rating-group/index.mjs"
+    },
+    "./scroll-area": {
+      "types": "./dist/components/scroll-area/index.d.mts",
+      "import": "./dist/components/scroll-area/index.mjs"
+    },
+    "./select": {
+      "types": "./dist/components/select/index.d.mts",
+      "import": "./dist/components/select/index.mjs"
+    },
+    "./separator": {
+      "types": "./dist/components/separator/index.d.mts",
+      "import": "./dist/components/separator/index.mjs"
+    },
+    "./signature-pad": {
+      "types": "./dist/components/signature-pad/index.d.mts",
+      "import": "./dist/components/signature-pad/index.mjs"
+    },
+    "./skeleton": {
+      "types": "./dist/components/skeleton/index.d.mts",
+      "import": "./dist/components/skeleton/index.mjs"
+    },
+    "./slider": {
+      "types": "./dist/components/slider/index.d.mts",
+      "import": "./dist/components/slider/index.mjs"
+    },
+    "./snackbar": {
+      "types": "./dist/components/snackbar/index.d.mts",
+      "import": "./dist/components/snackbar/index.mjs"
+    },
+    "./spinner": {
+      "types": "./dist/components/spinner/index.d.mts",
+      "import": "./dist/components/spinner/index.mjs"
+    },
+    "./splitter": {
+      "types": "./dist/components/splitter/index.d.mts",
+      "import": "./dist/components/splitter/index.mjs"
+    },
+    "./steps": {
+      "types": "./dist/components/steps/index.d.mts",
+      "import": "./dist/components/steps/index.mjs"
+    },
+    "./switch": {
+      "types": "./dist/components/switch/index.d.mts",
+      "import": "./dist/components/switch/index.mjs"
+    },
+    "./table": {
+      "types": "./dist/components/table/index.d.mts",
+      "import": "./dist/components/table/index.mjs"
+    },
+    "./tabs": {
+      "types": "./dist/components/tabs/index.d.mts",
+      "import": "./dist/components/tabs/index.mjs"
+    },
+    "./tags-input": {
+      "types": "./dist/components/tags-input/index.d.mts",
+      "import": "./dist/components/tags-input/index.mjs"
+    },
+    "./textarea": {
+      "types": "./dist/components/textarea/index.d.mts",
+      "import": "./dist/components/textarea/index.mjs"
+    },
+    "./timer": {
+      "types": "./dist/components/timer/index.d.mts",
+      "import": "./dist/components/timer/index.mjs"
+    },
+    "./toast": {
+      "types": "./dist/components/toast/index.d.mts",
+      "import": "./dist/components/toast/index.mjs"
+    },
+    "./toc": {
+      "types": "./dist/components/toc/index.d.mts",
+      "import": "./dist/components/toc/index.mjs"
+    },
+    "./toggle": {
+      "types": "./dist/components/toggle/index.d.mts",
+      "import": "./dist/components/toggle/index.mjs"
+    },
+    "./toggle-group": {
+      "types": "./dist/components/toggle-group/index.d.mts",
+      "import": "./dist/components/toggle-group/index.mjs"
+    },
+    "./tooltip": {
+      "types": "./dist/components/tooltip/index.d.mts",
+      "import": "./dist/components/tooltip/index.mjs"
+    },
+    "./tour": {
+      "types": "./dist/components/tour/index.d.mts",
+      "import": "./dist/components/tour/index.mjs"
+    },
+    "./tree-view": {
+      "types": "./dist/components/tree-view/index.d.mts",
+      "import": "./dist/components/tree-view/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./dist/registry/*": "./dist/registry/*",
+    "./skills/*": "./skills/*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "scripts": {
+    "build": "nx run react:build",
+    "codegen": "nx run react:codegen",
+    "lint": "nx run react:lint",
+    "test": "nx run react:test",
+    "typecheck": "nx run react:typecheck"
+  },
+  "dependencies": {
+    "@zag-js/accordion": "1.44.0",
+    "@zag-js/anatomy": "1.44.0",
+    "@zag-js/angle-slider": "1.44.0",
+    "@zag-js/avatar": "1.44.0",
+    "@zag-js/carousel": "1.44.0",
+    "@zag-js/cascade-select": "1.44.0",
+    "@zag-js/checkbox": "1.44.0",
+    "@zag-js/clipboard": "1.44.0",
+    "@zag-js/collapsible": "1.44.0",
+    "@zag-js/collection": "1.44.0",
+    "@zag-js/color-picker": "1.44.0",
+    "@zag-js/combobox": "1.44.0",
+    "@zag-js/core": "1.44.0",
+    "@zag-js/date-input": "1.44.0",
+    "@zag-js/date-picker": "1.44.0",
+    "@zag-js/dialog": "1.44.0",
+    "@zag-js/dom-query": "1.44.0",
+    "@zag-js/drawer": "1.44.0",
+    "@zag-js/editable": "1.44.0",
+    "@zag-js/file-upload": "1.44.0",
+    "@zag-js/floating-panel": "1.44.0",
+    "@zag-js/hover-card": "1.44.0",
+    "@zag-js/i18n-utils": "1.44.0",
+    "@zag-js/image-cropper": "1.44.0",
+    "@zag-js/listbox": "1.44.0",
+    "@zag-js/marquee": "1.44.0",
+    "@zag-js/menu": "1.44.0",
+    "@zag-js/navigation-menu": "1.44.0",
+    "@zag-js/number-input": "1.44.0",
+    "@zag-js/pagination": "1.44.0",
+    "@zag-js/password-input": "1.44.0",
+    "@zag-js/pin-input": "1.44.0",
+    "@zag-js/popover": "1.44.0",
+    "@zag-js/progress": "1.44.0",
+    "@zag-js/qr-code": "1.44.0",
+    "@zag-js/radio-group": "1.44.0",
+    "@zag-js/rating-group": "1.44.0",
+    "@zag-js/react": "1.44.0",
+    "@zag-js/scroll-area": "1.44.0",
+    "@zag-js/select": "1.44.0",
+    "@zag-js/signature-pad": "1.44.0",
+    "@zag-js/slider": "1.44.0",
+    "@zag-js/splitter": "1.44.0",
+    "@zag-js/steps": "1.44.0",
+    "@zag-js/switch": "1.44.0",
+    "@zag-js/tabs": "1.44.0",
+    "@zag-js/tags-input": "1.44.0",
+    "@zag-js/timer": "1.44.0",
+    "@zag-js/toast": "1.44.0",
+    "@zag-js/toc": "1.44.0",
+    "@zag-js/toggle": "1.44.0",
+    "@zag-js/toggle-group": "1.44.0",
+    "@zag-js/tooltip": "1.44.0",
+    "@zag-js/tour": "1.44.0",
+    "@zag-js/tree-view": "1.44.0",
+    "lucide": "1.47.0"
+  },
+  "devDependencies": {
+    "@neurocle/synapse-artifact-check": "workspace:*",
+    "@neurocle/synapse-icons": "workspace:*",
+    "@neurocle/synapse-node-bin": "workspace:*",
+    "@neurocle/synapse-package-check": "workspace:*",
+    "@neurocle/synapse-registry": "workspace:*",
+    "@neurocle/synapse-tokens": "workspace:*",
+    "@pandacss/dev": "1.12.1",
+    "@tanstack/intent": "0.4.0",
+    "@testing-library/react": "16.3.3",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "axe-core": "4.13.0",
+    "happy-dom": "20.14.5",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsdown": "0.23.0"
+  },
+  "peerDependencies": {
+    "@pandacss/dev": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@pandacss/dev": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}

package/skills/components/accordion/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: 'accordion'
+description: 'Accordion — 하나의 키보드 모델 아래 여러 콘텐츠 영역을 두며, 하나를 열면 나머지가 닫힐 수 있습니다. 서로 조율되는 여러 개의 디스클로저가 아니라 상호 배타성을 소유하는 단일 machine이 이를 구동합니다. 다른 이름: accordion, expander group, faq list, disclosure group, collapsible list, 아코디언, 접이식 목록, FAQ 목록, 펼침 그룹.'
+metadata:
+  package: '@neurocle/synapse-react'
+  packageVersion: '0.3.0'
+  registryEntry: 'packages/registry/data/components/accordion.json'
+  registryStructuralVersion: '0.3.0'
+  lifecycle: 'active'
+  generator: 'packages/react/src/skills/generate.ts'
+---
+
+<!--
+생성된 파일 — 손으로 고치지 않습니다.
+
+Source:     packages/registry/data/components/accordion.json (항목 구조 0.3.0)
+Generator:  packages/react/src/skills/generate.ts
+Regenerate: npx nx run react:skills:generate
+
+아래에서 이 컴포넌트에 대해 말하는 모든 문장은 그 항목의 필드입니다. 여기서 고친 내용은 다음
+재생성 때 지워지고, 손으로 설명한 컴포넌트는 아무것도 실패하지 않은 채 설명과 어긋납니다.
+대신 항목을 고칩니다.
+-->
+
+# Accordion
+
+> 하나의 키보드 모델 아래 여러 콘텐츠 영역을 두며, 하나를 열면 나머지가 닫힐 수 있습니다. 서로 조율되는 여러 개의 디스클로저가 아니라 상호 배타성을 소유하는 단일 machine이 이를 구동합니다.
+
+`@neurocle/synapse-react` 0.3.0에서 생성했습니다. 설치된 버전이 이 버전이 아니면, 이 페이지의 어떤 내용보다 설치된 패키지 안에 함께 배포된 Registry를 우선합니다.
+
+- 패키지: `@neurocle/synapse-react`
+- 내보내기: `Accordion`
+- 분류: `disclosure-layout-display`
+- 수명 주기: `active`
+
+## Do
+
+> 하나를 열면 대개 사용자가 직전 것을 다 읽었다는 뜻인 여러 영역 — 질문과 답변의 모음이나 긴 폼의 섹션들이 그렇습니다. 섹션들이 서로 한 묶음일 때 여러 개의 Collapsible 대신 이것을 쓰세요. machine이 상호 배타성과 공유된 화살표 키 모델을 소유하며, 디스클로저를 손으로 조율하면 둘 다 조악하게 재현하게 됩니다.
+
+## Don't
+
+> 주변의 어떤 것과도 무관하게 보임 여부가 정해지는 단일 영역에는 쓰지 마세요 — 그것은 Collapsible이며, 섹션이 하나뿐인 아코디언은 탐색할 대상이 없는 키보드 모델일 뿐입니다. 오직 하나의 패널만 보일 수 있고 패널들이 세부 정보가 아니라 대등한 관계라면 쓰지 마세요. 그것은 Tabs이며, Tabs는 집합을 집합으로 알리고 사용자가 모든 패널을 닫지 못하게 합니다. 사용자가 눈앞의 작업을 마치는 데 필요한 콘텐츠를 숨기지 마세요. 숨겨진 콘텐츠는 모든 브라우저의 페이지 내 검색에서 찾히지는 않으며, 닫힌 섹션 안의 필드는 고칠 대상이 화면에 보이지 않는 채로 유효성 검사에 실패할 수 있습니다.
+
+## Anti-patterns
+
+> 컴포넌트 안에서 각 섹션의 높이를 애니메이션하는 것. 진입/퇴장 생명주기는 Synapse에서 뒤로 미뤄둔 작업이며, 컴포넌트별 애니메이션은 나중에 그 생명주기가 도입될 때 채택된 모든 곳에서 걷어내야 할 대상이 됩니다.
+
+Registry는 이 컴포넌트의 안내를 `reviewed`로 기록합니다(검토일 2026-09-22).
+
+## 관련 컴포넌트
+
+- `Collapsible` (`collapsible`)
+- `Tabs` (`tabs`)
+- `Steps` (`steps`)
+- `Toc` (`toc`)
+
+## 가져오기
+
+```tsx
+import { Accordion } from '@neurocle/synapse-react'
+```
+
+## Anatomy
+
+React 네임스페이스가 노출하는 part 5개를 항목의 `parts.containment`가 기록한 대로 조합했습니다. 한 part가 놓일 수 있는 정당한 자리가 둘 이상이면 스니펫은 첫 번째를 쓰고, 아래 목록이 나머지를 알려 줍니다.
+
+```tsx
+<Accordion.Root>
+  <Accordion.Item>
+    <Accordion.ItemTrigger>
+      <Accordion.ItemIndicator />
+    </Accordion.ItemTrigger>
+    <Accordion.ItemContent />
+  </Accordion.Item>
+</Accordion.Root>
+```
+
+- `Accordion.Root` — 최상위에 놓입니다
+- `Accordion.Item` — `Root` 안에 놓입니다
+- `Accordion.ItemTrigger` — `Item` 안에 놓입니다
+- `Accordion.ItemContent` — `Item` 안에 놓입니다
+- `Accordion.ItemIndicator` — `ItemTrigger` 안에 놓입니다
+
+## Props
+
+빌드가 방출하는 선언에서 도출한 prop 10개. 선언에는 기본값을 둘 자리가 없으므로 prop 기록에는 기본값이 없습니다. 기본값이 있다면 그 prop의 설명에 적혀 있습니다.
+
+모든 prop이 선택입니다. 아무것도 넘기지 않으면 컴포넌트는 비제어로 동작합니다.
+
+### 선택
+
+- `value` — `readonly string[]`, 선택. 열려 있는 섹션이며, 제어됩니다. `multiple`이 꺼져 있어도 배열입니다. 열린 섹션의 집합이라 원소가 하나여도 집합이고, 배열을 벗기면 `multiple`이 바뀔 때 prop 타입도 함께 바뀌어 사용처가 타입을 고정할 수 없기 때문입니다.
+- `defaultValue` — `readonly string[]`, 선택. 비제어 초기 열림 섹션. `value`가 주어지면 무시됩니다.
+- `onValueChange` — `(details: ValueChangeDetails<readonly string[]>) => void`, 선택. 제어 여부와 무관하게 열린 집합이 바뀔 때마다 알림을 받습니다.
+- `multiple` — `boolean`, 선택. 한 번에 둘 이상의 섹션이 열리도록 허용합니다.
+- `collapsible` — `boolean`, 선택. 마지막으로 열린 섹션까지 닫아 아무것도 열리지 않은 상태가 되도록 허용합니다.
+- `onFocusChange` — `(details: AccordionFocusChangeDetails) => void`, 선택. 키보드가 trigger 사이를 오갈 때 알림을 받습니다.
+- `orientation` — `Orientation`, 선택. 섹션이 배치되는 축. 기본값은 `vertical`입니다.
+- `disabled` — `boolean`, 선택. 비활성화된 Accordion은 어떤 trigger에도 반응하지 않습니다.
+- `size` — `Size`, 선택. 하나의 공유 척도에서 옵니다. 모든 컴포넌트가 그렇듯 기본값은 `md`입니다.
+- `id` — `string`, 선택. 팩토리가 생성하는 식별자를 덮어씁니다. 서버와 클라이언트에서 동일합니다.
+
+## Variants
+
+- `size` — `xs`, `sm`, `md`, `lg`, `xl`. 기본값은 `md`.
+
+## 폼
+
+폼 참여: 아니요.
+
+> 폼에 제출하는 값이 없습니다.
+
+## 이 컴포넌트에 일부러 없는 것
+
+- `empty-state` — 아코디언은 사용처가 작성한 섹션을 렌더링합니다. 읽어 들이는 컬렉션이 없으므로 보여줄 것이 없는 상태도 없습니다 — 섹션이 하나도 없는 아코디언은 애초에 렌더링되지 말았어야 할 컴포넌트입니다.
+- `loading-state` — 디스클로저는 동기적으로 결정됩니다. 본문을 아직 가져오는 중인 섹션은 사용처의 콘텐츠이며, 그 섹션의 나머지 마크업이 있는 item content part 안에 속합니다.
+- `error-state` — 컴포넌트가 실패할 일이 없습니다. 펼쳐진 섹션 안의 오류는 그 섹션의 것이며, 아코디언은 div가 그렇듯 그에 대해 더 말할 것이 없습니다.
+
+## 접근성
+
+### 접근 가능한 이름
+
+> 각 trigger의 이름은 사용처의 콘텐츠입니다. 여기서는 기본값을 제공하지 않으므로, 이름 없는 trigger는 Synapse가 조용히 이름을 채우는 대신 이름이 없다는 사실이 그대로 드러납니다.
+
+### 포커스
+
+> 섹션이 열려도 포커스는 trigger에 머무릅니다. machine은 trigger가 포커스를 받은 뒤에만 활성화 클릭을 받아들입니다 — 포인터는 어차피 그렇게 동작하며, 이를 구동하는 테스트도 이 순서를 재현해야 합니다.
+
+## 로케일과 컬렉션
+
+- 로케일 의존: 예. 아코디언이 가로 방향일 때 화살표 키 탐색은 텍스트 방향을 따르며, 그 방향은 prop이 아니라 provider에서 옵니다.
+- 컬렉션 윈도잉: 아니요. 항목은 이를 이유 없이 사실로만 기록합니다.
+
+## 기능 용어와 다른 이름
+
+- 다루는 기능: `expand-collapse`, `mutually-exclusive-disclosure`, `grouped-sections`, `axis-orientation`.
+- 다른 이름: `accordion`, `expander group`, `faq list`, `disclosure group`, `collapsible list`, `아코디언`, `접이식 목록`, `FAQ 목록`, `펼침 그룹`.
+- 어휘 상태: `controlled`.