본문으로 건너뛰기
J
피드

Box of Rain — JSON/YAML/Mermaid로 ASCII 박스 다이어그램 자동 생성하는 도구

open-source 약 3분
tags
#ascii#cli#mermaid#diagram#javascript
vote
0
댓글
북마크

JSON, YAML, Mermaid 문법으로 ASCII 박스 다이어그램을 자동 생성하는 CLI/라이브러리. 중첩 박스, 화살표, 자동 레이아웃을 지원하며 코드 전체가 AI로 생성됐다고 솔직하게 밝힘.

  • 1

    JSON/YAML/Mermaid 입력으로 ASCII 다이어그램 자동 생성

  • 2

    자동 레이아웃 엔진이 박스 배치와 엣지 크로싱 최소화 처리

  • 3

    코드 전체가 AI 생성이라고 솔직하게 공개

  • 4

    Mermaid 파서는 별도 서브패스로 분리해서 번들 경량화

  • JSON, YAML, 또는 Mermaid 문법으로 입력하면 ASCII 박스 다이어그램을 자동으로 그려주는 CLI/라이브러리임. 중첩 박스, 화살표 연결, 자동 레이아웃, 다양한 테두리 스타일, 그림자까지 지원하고, 출력은 플레인 텍스트 또는 SVG로 가능함

  • turbopuffer, PlanetScale, Oxide Computing 같은 회사들이 쓰는 ASCII 다이어그램에서 영감을 받아 만들었다고 함. 이름은 Grateful Dead의 작사가 Robert Hunter 곡에서 따온 거임

  • 솔직하게 코드 전체가 AI로 생성됐다고 밝힘. 다만 "작고, 유용하고, 독립적이고, 호스팅 불필요한 라이브러리가 AI의 최적 활용처"라는 입장

  • 다이어그램은 재귀적 트리 구조로 정의됨. 각 노드는 텍스트나 자식 노드를 포함할 수 있고, children에 문자열을 넣으면 텍스트, 객체 배열을 넣으면 중첩 박스가 됨

  • Mermaid 문법도 지원하는데 꽤 충실함:

    • Flowchart: 방향(LR, RL, TD, BT), 노드 모양별 테두리 스타일 매핑, 서브그래프 중첩, 체인 엣지
    • Sequence diagram: participant/actor 선언, 별칭, 다양한 메시지 타입(->>, -->>``, -x` 등)
    • :::shadow로 그림자 추가, %% @route로 화살표 라우팅 제어 같은 확장 문법도 있음

  • 화살표 라우팅이 꽤 똑똑함 — 같은 행이면 직선, 아니면 L자형, 양쪽이 같은 방향이면 U자형으로 우회해서 그림

  • 자동 레이아웃 엔진이 콘텐츠에 맞춰 박스 크기를 정하고, 연결 흐름 기반으로 수평 레이어 배치하고, 엣지 크로싱을 최소화함. 사이클도 처리 가능하고, 자동/수동 포지셔닝 혼합도 됨

  • pnpm install box-of-rain으로 설치하고, stdin 파이프도 가능. Mermaid 파서(chevrotain)는 별도 서브패스(box-of-rain/mermaid)로 분리해서 메인 번들을 가볍게 유지함. 입력 검증은 Zod로 함

💡팁

> 문서 같은 데 ASCII 다이어그램 넣고 싶은데 손으로 그리기 귀찮았다면 써볼 만함. Mermaid 문법 그대로 쓸 수 있어서 진입장벽이 낮음

AI 생성 코드의 적절한 활용처에 대한 솔직한 입장이 인상적. 작고 독립적인 유틸리티 라이브러리는 AI의 좋은 사용처라는 주장.

prev

이전 기사 (P)

next

다음 기사 (N)

댓글

댓글

댓글을 불러오는 중...

관련 기사

open-source

위키피디아에도 빅테크식 반노조 플레이북이 들어왔다

위키미디어 재단이 5월 열흘 사이 MediaWiki 장기 핵심 개발자를 해고하고, 자원봉사 편집자 요청을 처리하던 Community Tech 팀을 해산했다는 비판 글이다. 해고된 인력 상당수가 노조 조직 활동과 연결돼 있었고, 위키피디아 편집자들은 연대 파업까지 거론하고 있다. 재단은 2억9660만 달러의 준비금과 빠르게 성장하는 AI 대상 API 매출을 갖고 있어, 이 사안이 단순 비용 절감으로 보기 어렵다는 게 글의 핵심이다.

open-source

캘리포니아, 연령 확인법에서 리눅스 빼려는 수정안 추진

캘리포니아가 운영체제에 사용자 나이 확인을 요구하는 법안에서 대부분의 오픈소스 운영체제를 제외하는 수정안을 추진 중이다. 데비안, 페도라, 우분투, 아치, 리눅스 민트 같은 배포판은 빠질 가능성이 커졌지만, 스팀OS처럼 독점 앱 생태계와 연결된 플랫폼은 여전히 애매한 상태다.

open-source

마이크로소프트, 45년 전 86-DOS 소스코드를 오픈소스로 공개

마이크로소프트가 86-DOS 1.00 출시 45주년에 맞춰 지금까지 발견된 것 중 가장 오래된 DOS 소스코드를 공개했어. 팀 패터슨의 차고에 있던 도트 매트릭스 출력물을 스캔하고 옮겨 적어, 원본 바이너리와 바이트 단위로 동일하게 다시 컴파일되는 수준까지 복원한 게 포인트야.

open-source

밤부 랩, AGPLv3 위반 논란으로 오픈소스 커뮤니티와 충돌

3D 프린터 제조사 밤부 랩이 AGPLv3 라이선스 위반 논란에 휘말렸고, Software Freedom Conservancy가 두 건의 위반 사례를 확인했다는 내용이야. Louis Rossmann과 Gamers Nexus는 관련 개발자의 법적 방어를 위해 2만달러를 기부했고, 갈등의 핵심은 오픈소스 기반 생태계를 클라우드와 DRM으로 점점 닫아가려는 움직임이야.

open-source

플리퍼, 리눅스 기반 확장형 기기 '플리퍼 원' 공개

플리퍼가 기존 플리퍼 제로를 대체하는 후속작이 아니라, 리눅스 기반 네트워킹·확장형 기기인 플리퍼 원을 공개했어. RK3576 8코어 ARM 칩, 와이파이 6E, 듀얼 이더넷, NVMe, HDMI 4K 120Hz까지 넣으면서 장난감 같은 해킹 도구에서 훨씬 범용적인 리눅스 장비 쪽으로 방향을 넓히는 그림이야.