ai2
componentaccordion-numberedsource: ok · refreshed
Numbered accordion
Styled accordion: the Numbered set. 5 decorative accordion variations (CircleAccordion, SquareAccordion, OutlineAccordion, FilledAccordion, GhostAccordion) on the ai2 token system, powered by framer-motion, reduced-motion aware and sized sm to xl. Part of the free styled layer.
npx shadcn add "https://ai2.design/r/accordion-numbered.json"free
Interaction
accordion
Tags auto-generated by rules on 9/24/2026 — empty means no evidence, not lack of support.
Dependencies
Bundle weight · lightmotion@^12.42.2lucide-react@^1.23.0
Registry dependencies
@ai2/tokens
Files1 · source cached 10/8/2026, 3:33:14 AM
registry/ai2/styled/accordion-numbered.tsx
"use client"
import * as React from "react"
import { ChevronDown } from "lucide-react"
import { AnimatePresence, motion, useReducedMotion } from "motion/react"
import { cn } from "@/lib/utils"
/* Numbered accordion family: 5 step-numbered accordions. Every row starts with
a token step-number chip; the variants change the chip's shape and fill.
Every export is a complete accordion: internal single-open state, a button
header with aria-expanded, framer height auto animation. Colour comes ONLY
from tokens. Alpha via color-mix. Under reduced-motion opening and closing are
instant. Size = padding + text scale. Renders without props too. */
export type StyledSize = "sm" | "md" | "lg" | "xl"
export interface StyledAccordionItem {
value: string
title: React.ReactNode
content: React.ReactNode
}
interface StyledAccordionProps {
className?: string
size?: StyledSize
items?: StyledAccordionItem[]
defaultOpen?: string
}
const headerPad: Record<StyledSize, string> = {
sm: "px-3 py-2.5 text-sm",
md: "px-4 py-3 text-sm",
lg: "px-5 py-4 text-base",
xl: "px-6 py-5 text-lg",
}
const bodyPad: Record<StyledSize, string> = {
sm: "pl-11 pr-3 pb-2.5 text-sm",
md: "pl-12 pr-4 pb-3 text-sm",
lg: "pl-14 pr-5 pb-4 text-base",
xl: "pl-16 pr-6 pb-5 text-base",
}
const iconSize: Record<StyledSize, string> = {
sm: "size-4",
md: "size-4",
lg: "size-5",
xl: "size-5",
}
const chipSize: Record<StyledSize, string> = {
sm: "size-5 text-xs",
md: "size-6 text-xs",
lg: "size-7 text-sm",
xl: "size-8 text-sm",
}
const defaultItems: StyledAccordionItem[] = [
{
value: "item-1",
title: "What is included?",
content:
"Every plan ships the full component library, semantic tokens, and lifetime updates for the tier you own.",
},
{
value: "item-2",
title: "How does installation work?",
content:
"Add any component with a single CLI command. Files land in your project and stay fully editable.",
},
{
value: "item-3",
title: "Can I use it in production?",
content:
"Yes. The system is framework agnostic, self contained, and safe to ship to any number of projects.",
},
]
function useSingleOpen(defaultOpen?: string) {
const [open, setOpen] = React.useState<string | null>(defaultOpen ?? null)
const toggle = React.useCallback(
(value: string) => setOpen((cur) => (cur === value ? null : value)),
[]
)
return { open, toggle }
}
const headerBase =
"flex w-full items-center gap-3 text-left font-medium outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50"
function Panel({
isOpen,
size,
children,
}: {
isOpen: boolean
size: StyledSize
children: React.ReactNode
}) {
const reduce = useReducedMotion()
return (
<AnimatePresence initial={false}>
{isOpen && (
<motion.div
key="panel"
initial={reduce ? false : { height: 0, opacity: 0 }}
animate={{ height: "auto", opacity: 1 }}
exit={{ height: 0, opacity: 0 }}
transition={
reduce ? { duration: 0 } : { duration: 0.25, ease: [0.4, 0, 0.2, 1] }
}
className="overflow-hidden"
>
<div className={cn(bodyPad[size], "text-muted-foreground")}>
{children}
</div>
</motion.div>
)}
</AnimatePresence>
)
}
function Chevron({ isOpen, size }: { isOpen: boolean; size: StyledSize }) {
const reduce = useReducedMotion()
return (
<motion.span
aria-hidden
className="ml-auto shrink-0 text-muted-foreground"
animate={{ rotate: isOpen ? 180 : 0 }}
transition={reduce ? { duration: 0 } : { duration: 0.2 }}
>
<ChevronDown className={iconSize[size]} />
</motion.span>
)
}
/* Shared numbered shell: one frame, rows divided by a token line, a step-number
chip on each row. chipClass carries each variant's shape/fill technique. */
function NumberedShell({
props,
chipClass,
}: {
props: StyledAccordionProps
chipClass: string
}) {
const { className, size = "md", items = defaultItems, defaultOpen } = props
const { open, toggle } = useSingleOpen(defaultOpen)
return (
<div
data-slot="styled-accordion"
className={cn(
"overflow-hidden rounded-xl border border-border bg-background",
className
)}
>
{items.map((item, i) => {
const isOpen = open === item.value
return (
<div key={item.value} className={cn(i > 0 && "border-t border-border")}>
<button
type="button"
aria-expanded={isOpen}
onClick={() => toggle(item.value)}
className={cn(
headerBase,
headerPad[size],
"hover:bg-[color-mix(in_oklab,var(--color-foreground)_5%,transparent)]"
)}
>
<span
aria-hidden
className={cn(
"inline-flex shrink-0 items-center justify-center font-semibold tabular-nums",
chipSize[size],
chipClass
)}
>
{i + 1}
</span>
<span className="min-w-0">{item.title}</span>
<Chevron isOpen={isOpen} size={size} />
</button>
<Panel isOpen={isOpen} size={size}>
{item.content}
</Panel>
</div>
)
})}
</div>
)
}
/* Circle: yuvarlak yumusak-primary chip. */
export function CircleAccordion(props: StyledAccordionProps) {
return (
<NumberedShell
props={props}
chipClass="rounded-full bg-[color-mix(in_oklab,var(--color-primary)_15%,transparent)] text-primary"
/>
)
}
/* Square: yuvarlatilmis kare yumusak-surface chip. */
export function SquareAccordion(props: StyledAccordionProps) {
return (
<NumberedShell
props={props}
chipClass="rounded-md bg-surface-2 text-foreground"
/>
)
}
/* Outline: cizgili yuvarlak chip, seffaf dolgu. */
export function OutlineAccordion(props: StyledAccordionProps) {
return (
<NumberedShell
props={props}
chipClass="rounded-full border border-border text-muted-foreground"
/>
)
}
/* Filled: dolu primary chip, ust-metin. */
export function FilledAccordion(props: StyledAccordionProps) {
return (
<NumberedShell
props={props}
chipClass="rounded-full bg-primary text-primary-foreground"
/>
)
}
/* Ghost: no frame, only colored number text. */
export function GhostAccordion(props: StyledAccordionProps) {
return (
<NumberedShell props={props} chipClass="rounded-full text-primary" />
)
}