Noted

대한민국 인공지능기본법 (2026.1.22 시행 · 2027.1 유예 종료) 의 표시 의무를 React 로 손쉽게 적용하기. Open-source React SDK for Korea's AI Basic Act labeling obligations.

What

Noted 는 한국 「인공지능 발전과 신뢰 기반 조성 등에 관한 기본법」 제31조의 표시 의무를 따르는 React 컴포넌트와 유틸리티를 제공합니다.

• <AIDisclosure /> — 5가지 표시 변형 (inline / block / corner / deepfake / footer) + v0.2 가시성 강화
• <AINotice /> — 5가지 사전 고지 배치 (onboarding / terms / banner / footer / screen)
• <AIBasicActCheck /> — 자가진단 위젯 + v0.2 권장 SDK 설정 스니펫 자동 생성
• <AILabelEditor /> + tagAsAI() (v0.2) — 콘텐츠 제작 시점에 메타데이터 캡처 + SHA-256 서명
• <AIContentProvider /> + useAIMetadata() (v0.2) — 페이지 단위 메타데이터 전파
• getComplianceStatus() (v0.2) — 현재 설정 → 가이드라인 조항 매핑 보고
• naverAdapter / kakaoAdapter (v0.2) — 한국 모델사 워터마크 호환
• createManifest / verifySidecar — C2PA 호환 JSON 메타데이터
• Korean 우선 / English 동시 지원, 다크 모드 기본
• React 18 / 19 · TypeScript strict · 50 KB 미만 gzipped (c2pa-js 동적 import 제외)

Install

npm install noted-kr

npm 의 무스코프 noted 는 이미 점유되어 있어 noted-kr 로 게시합니다. 제품 이름은 그대로 Noted 입니다.

import { AIDisclosure } from 'noted-kr'
import 'noted-kr/style.css'

export function ChatTurn({ text }: { text: string }) {
  return (
    <AIDisclosure model="gpt-5" variant="inline">
      {text}
    </AIDisclosure>
  )
}

Docs

문서 사이트는 apps/docs 에 있습니다 (Next.js 15 + Tailwind v4).

• /docs/getting-started — 시작하기
• /docs/api — 컴포넌트 API
• /docs/legal-mapping — 법 매핑
• /docs/migration-v01-to-v02 — v0.1 → v0.2 마이그레이션
• /docs/integrations — Sanity / Strapi / Contentful 통합
• /docs/specs — Figma 플러그인 / Slack 봇 스펙
• /docs/faq — FAQ
• /playground — 인터랙티브 미리보기
• /check — 자가진단

Open core

Noted SDK 는 영구 무료 오픈소스입니다. 호스티드 컴플라이언스 플랫폼은 v0.3 에서 출시 예정입니다.

티어	가격	무엇을 줍니까
Free (OSS)	$0	SDK 전체 기능, 모든 컴포넌트, 자가진단, C2PA 매니페스트
Team (v0.3)	$49/월	호스티드 감사 로그 (시행령 §27(2) 5년 보관), 컴플라이언스 점수, PDF 리포트 — 5,000 events/월
Business (v0.3)	$299/월	위 항목 + 50,000 events/월, 업종 벤치마크, Slack/이메일 알림
Enterprise (v0.3)	협의	무제한 events, 한국어 컴플라이언스 자문, SAML SSO, 법무팀 연동

오픈소스 SDK 는 hosted 평면이 없어도 완전 동작 합니다. <NotedCloud apiKey="..." /> 컴포넌트만 추가하면 같은 onLog 이벤트가 자동으로 호스티드 로그로 흘러갑니다 (v0.3).

Project layout

packages/react   The "noted-kr" SDK (TypeScript, tsup, Vitest)
apps/docs        Documentation + landing + playground (Next.js)
DESIGN.md        Design spec
PRD.md           Product spec

Development

Requires Node 20+ and pnpm 10+.

pnpm install
pnpm dev          # docs site
pnpm test         # 122 unit tests
pnpm build        # SDK + docs
pnpm lint
pnpm typecheck

Disclaimer

이 도구는 시행령에 따른 표시 방법을 안내합니다. 법적 의무 충족 여부는 별도의 법무 검토가 필요합니다.

License

MIT — see LICENSE.