Are the ai2 Notice collapsibles free?

Yes. The whole styled layer is free and MIT licensed, like the component core.

Can I change the size?

Yes. Every variation takes a size prop of sm, md, lg or xl, aligned to the base Button height scale.

Notice collapsibles

Five info-style collapsibles, each driven by its semantic tone family for the tinted surface and leading icon: info, success, warning, danger and muted. Each toggles a token content panel with an accessible trigger and is sized.

CollapsibleNotice

Installation

The styled layer is free and installs like any other ai2 component.

Run the following command

npx shadcn@latest add @ai2/collapsible-notice

Dependencies, the @ai2/tokens theme and the component file are installed together.

Install dependencies

npm install motion lucide-react

Copy the source

components/ui/collapsible-notice.tsx

"use client"

import * as React from "react"
import {
  ChevronDown,
  CircleCheck,
  CircleDashed,
  Info,
  OctagonAlert,
  TriangleAlert,
} from "lucide-react"
import { AnimatePresence, motion, useReducedMotion } from "motion/react"

import { cn } from "@/lib/utils"

/* Notice collapsible family: 5 toned info-box collapsibles. Each export is a
   complete collapsible: a leading lucide icon + a single trigger + a single
   expanding body, a button with aria-expanded, and a framer height auto
   animation. Works controlled (open/onOpenChange) and uncontrolled (defaultOpen).
   Each variant uses its own semantic token family (info/success/warning/danger/
   muted): a tinted surface + border + icon. Color comes ONLY from tokens. Alpha
   via color-mix. No transform under reduced-motion. Size = padding + text
   scale. */

export type StyledSize = "sm" | "md" | "lg" | "xl"

interface StyledCollapsibleProps {
  className?: string
  size?: StyledSize
  title?: React.ReactNode
  children?: React.ReactNode
  open?: boolean
  defaultOpen?: boolean
  onOpenChange?: (o: boolean) => void
}

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: "px-3 pb-2.5 text-sm",
  md: "px-4 pb-3 text-sm",
  lg: "px-5 pb-4 text-base",
  xl: "px-6 pb-5 text-base",
}

const iconSize: Record<StyledSize, string> = {
  sm: "size-4",
  md: "size-4",
  lg: "size-5",
  xl: "size-5",
}

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"

const defaultTitle = "What is included?"

const defaultChildren =
  "Every plan ships the full component library, semantic tokens, and lifetime updates for the tier you own. Add any component with a single CLI command and keep the files fully editable."

/* Controlled and uncontrolled open state in a single hook. */
function useControllableOpen({
  open,
  defaultOpen,
  onOpenChange,
}: {
  open?: boolean
  defaultOpen?: boolean
  onOpenChange?: (o: boolean) => void
}) {
  const isControlled = open !== undefined
  const [internal, setInternal] = React.useState<boolean>(defaultOpen ?? false)
  const current = isControlled ? (open as boolean) : internal
  const toggle = React.useCallback(() => {
    const next = !current
    if (!isControlled) setInternal(next)
    onOpenChange?.(next)
  }, [current, isControlled, onOpenChange])
  return { isOpen: current, toggle }
}

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={reduce ? undefined : { rotate: isOpen ? 180 : 0 }}
      transition={reduce ? { duration: 0 } : { type: "spring" as const, stiffness: 300, damping: 24 }}
    >
      <ChevronDown className={iconSize[size]} />
    </motion.span>
  )
}

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], "pl-11 text-muted-foreground")}>{children}</div>
        </motion.div>
      )}
    </AnimatePresence>
  )
}

/* Shared shell: a toned surface plus border plus a leading icon. Every tone class arrives as a LITERAL string (Tailwind JIT cannot produce dynamic strings). */
function NoticeShell({
  props,
  surface,
  iconColor,
  hover,
  Icon,
}: {
  props: StyledCollapsibleProps
  surface: string
  iconColor: string
  hover: string
  Icon: React.ComponentType<{ className?: string }>
}) {
  const { className, size = "md", title = defaultTitle, children = defaultChildren } = props
  const { isOpen, toggle } = useControllableOpen(props)
  return (
    <div
      data-slot="styled-collapsible"
      className={cn("overflow-hidden rounded-xl border", surface, className)}
    >
      <button
        type="button"
        aria-expanded={isOpen}
        onClick={toggle}
        className={cn(headerBase, headerPad[size], hover)}
      >
        <span aria-hidden className={cn("shrink-0", iconColor)}>
          <Icon className={iconSize[size]} />
        </span>
        <span className="min-w-0 flex-1">{title}</span>
        <Chevron isOpen={isOpen} size={size} />
      </button>
      <Panel isOpen={isOpen} size={size}>
        {children}
      </Panel>
    </div>
  )
}

/* Info: mavi bilgi tonu. */
export function InfoCollapsible(props: StyledCollapsibleProps) {
  return (
    <NoticeShell
      props={props}
      surface="border-[color-mix(in_oklab,var(--color-info)_30%,transparent)] bg-[color-mix(in_oklab,var(--color-info)_10%,transparent)]"
      iconColor="text-info"
      hover="hover:bg-[color-mix(in_oklab,var(--color-info)_16%,transparent)]"
      Icon={Info}
    />
  )
}

/* Success: yesil basari tonu. */
export function SuccessCollapsible(props: StyledCollapsibleProps) {
  return (
    <NoticeShell
      props={props}
      surface="border-[color-mix(in_oklab,var(--color-success)_30%,transparent)] bg-[color-mix(in_oklab,var(--color-success)_10%,transparent)]"
      iconColor="text-success"
      hover="hover:bg-[color-mix(in_oklab,var(--color-success)_16%,transparent)]"
      Icon={CircleCheck}
    />
  )
}

/* Warning: sari uyari tonu. */
export function WarningCollapsible(props: StyledCollapsibleProps) {
  return (
    <NoticeShell
      props={props}
      surface="border-[color-mix(in_oklab,var(--color-warning)_30%,transparent)] bg-[color-mix(in_oklab,var(--color-warning)_10%,transparent)]"
      iconColor="text-warning"
      hover="hover:bg-[color-mix(in_oklab,var(--color-warning)_16%,transparent)]"
      Icon={TriangleAlert}
    />
  )
}

/* Danger: kirmizi tehlike tonu. */
export function DangerCollapsible(props: StyledCollapsibleProps) {
  return (
    <NoticeShell
      props={props}
      surface="border-[color-mix(in_oklab,var(--color-danger)_30%,transparent)] bg-[color-mix(in_oklab,var(--color-danger)_10%,transparent)]"
      iconColor="text-danger"
      hover="hover:bg-[color-mix(in_oklab,var(--color-danger)_16%,transparent)]"
      Icon={OctagonAlert}
    />
  )
}

/* Muted: notr sessiz ton. */
export function MutedCollapsible(props: StyledCollapsibleProps) {
  return (
    <NoticeShell
      props={props}
      surface="border-border bg-[color-mix(in_oklab,var(--color-foreground)_5%,transparent)]"
      iconColor="text-muted-foreground"
      hover="hover:bg-[color-mix(in_oklab,var(--color-foreground)_9%,transparent)]"
      Icon={CircleDashed}
    />
  )
}

Manual installs skip the @ai2/tokens theme, so add the token CSS from the theming guide or the tone colors will be missing.

Variations

5 takes on the same idea. Each is its own export, and every one accepts a size prop (sm, md, lg, xl) aligned to the base Button scale.

Info

An info-toned surface with a leading info icon.

Success

A success-toned surface with a leading check icon.

Warning

A warning-toned surface with a leading triangle icon.

Danger

A danger-toned surface with a leading octagon icon.

Muted

A neutral muted surface with a leading dashed-circle icon.

ai2 Notice collapsibles: 5 styled variations on the token system

The ai2 Notice collapsibles are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around tone-driven info disclosures with a leading icon. They are free and MIT licensed, and every color comes from a semantic token, so they theme with the rest of ai2 in light and dark.

Motion runs on framer-motion: framer-motion animates the panel height open and closed. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the panel shows and hides instantly with no height animation.

What is in the ai2 Notice collapsibles?

5 exports in one file: Info, Success, Warning, Danger and Muted. Each renders a native button and takes a size prop (sm, md, lg, xl) aligned to the base Button. They are separate from the base Button on purpose: the base keeps its clean variant, tone and size axes, while the styled layer carries the effects.

You own the file. Copy the one category file and you have all 5 variations, with no runtime dependency on ai2 itself.

Why use it

On-system by construction: Every color resolves to an ai2 semantic token, so the buttons follow your theme in light and dark with no extra work.
Effect without the sprawl: The decorations live in a dedicated styled file, so the base Button keeps its clean, predictable API.
Accessible and honest: Each renders a real button element, keeps a visible focus ring, and respects prefers-reduced-motion.

Features

Token-driven color: No hardcoded hex or oklch; the look recolors with your theme tokens.
framer-motion: framer-motion animates the panel height open and closed.
Reduced-motion aware: Under prefers-reduced-motion, the panel shows and hides instantly with no height animation.
Size aligned to the base: Every variation takes sm, md, lg and xl matching the base Button height scale, so styled and base buttons line up in a row.

Production tips

Use it for emphasis, not everywhere: Styled buttons draw the eye. Reserve them for the one action you want people to take on a screen, and use the base Button for the rest.
Keep labels as verbs: The decoration adds weight, so a clear action label keeps the button scannable.
Pick one variation per surface: The variations share a family; using two different ones in the same view competes for attention.

Works with the rest of ai2

The Notice collapsibles sit alongside the base Button and the rest of the @ai2 registry. They share the same token file, so a styled action next to a base button or a badge stays visually consistent in both modes.