AI와 함께 와이어프레임을 작성하기 위한 DSL.
Wireweave는 와이어프레임을 코드로 작성하는 텍스트 기반 DSL입니다. .wf 파일(멀티페이지 캔버스 지원)에 화면을 기술하면 파싱·렌더링·검증·내보내기를 수행할 수 있고, LLM이 이 DSL을 생성·수정하도록 돕는 도구를 제공합니다.
- npm scope:
@wireweave - 도메인: wireweave.org (문서: docs.wireweave.org)
이 저장소는 Wireweave의 공개 표면(언어 + 도구 + 클라이언트)을 담은 pnpm 모노레포입니다. npm 패키지 8개, 편집기 확장, 문서 사이트로 구성됩니다. 호스티드 AI 에이전트, API 서버, 제품(대시보드·관리자)은 별도의 비공개 저장소에서 관리됩니다.
| 패키지 | 역할 | 배포 |
|---|---|---|
@wireweave/core |
DSL 파서/렌더러 (Peggy grammar). parse · render(HTML·SVG) · analyze · diff · export(figma·json) | npm |
@wireweave/language-data |
컴포넌트 어휘/속성 데이터 (에디터 자동완성·검증용). Monaco·CodeMirror 서브패스 제공 | npm |
@wireweave/ux-rules |
UX 검증 규칙 + 0~100 점수 (validateUX) |
npm |
@wireweave/agent-prompts |
LLM이 DSL을 생성하도록 돕는 문법 가이드 프롬프트 (buildGrammarPrompt) |
npm |
@wireweave/markdown-plugin |
마크다운 코드블록(.wf) 렌더링 (markdown-it · marked · remarkable) |
npm |
wireweave-vscode |
VS Code / Cursor 확장 (구문 강조 · 자동완성 · 프리뷰) | Marketplace + Open VSX |
@wireweave/sdk |
플랫폼 클라이언트. dispatch()로 로컬 도구(무료·무키)와 원격(API 서버, 키) 라우팅 + auth |
npm |
@wireweave/cli |
SDK 위의 터미널 CLI (wireweave 바이너리) |
npm |
@wireweave/mcp-server |
MCP 서버 (SDK 래핑, 로컬 도구는 API 키 불필요) | npm |
@wireweave/docs |
VitePress 문서 사이트 | Vercel (비발행) |
기본 도구 — parse · validate · render · analyze · diff · export · validate_ux — 는 로컬에서 무료로, API 키 없이 동작합니다. 호스티드 AI 에이전트 생성은 별도 유료 기능으로 API 키가 필요합니다.
@wireweave/cli,@wireweave/sdk로컬 도구: 키 불필요@wireweave/mcp-server로컬 도구: API 키 불필요. HTTP 인증과 원격 API 키는 패키지의 인증 계약을 따릅니다.
요구 사항: Node.js ≥ 22.13, pnpm ≥ 11.
pnpm install
pnpm build # 전 패키지 빌드 (pnpm -r --filter "./packages/**")
pnpm typecheck # 전 패키지 tsc --noEmit
pnpm lint # 전 패키지 ESLint
pnpm test # 전 패키지 테스트
pnpm format # Prettier개별 패키지에서 작업하려면 해당 디렉터리에서 스크립트를 실행합니다.
pnpm --filter @wireweave/core build
pnpm --filter @wireweave/docs devChangesets independent 모드로 각 패키지를 독립 버전 관리하며, npm OIDC trusted publishing으로 게시합니다.
- 게시 진입점은 Publish packages workflow이며, 브랜치별 Core 메이저와 npm 채널은 릴리스 정책이 강제합니다.
@wireweave/docs(Vercel)와wireweave-vscode(vsce / ovsx)는 changesets npm 발행 대상에서 제외되며 별도 파이프라인으로 배포됩니다.
pnpm changeset # 변경 의도 기록
pnpm version-packages # 버전 bump + CHANGELOG
pnpm release:verify # 로컬 전체 검증, 게시하지 않음승인된 main 또는 develop 푸시가 발행 워크플로를 실행합니다. 버전 커밋이 푸시된 뒤 재시도하려면 해당 브랜치의 현재 HEAD에서 workflow_dispatch를 실행합니다. 이전 트리거 커밋의 재실행은 원격 HEAD 검사에서 중단됩니다. 워크플로는 게시 전에 발행 의도를 보존하고, 패키지 내용·npm 채널·설치된 MCP 실행을 검증합니다. 누락된 릴리스 태그는 검증된 레지스트리 증거로만 복구하며 기존 태그를 덮어쓰지 않습니다.
- 기여 가이드 및 문서: docs.wireweave.org
- 이슈 / 토론: github.com/wireweave/wireweave
- 라이선스: MIT