플러그인 매니페스트

{
  "id": "my-word-count",
  "name": "Word Count",
  "description": "Displays word and character count in the status bar",
  "version": "1.0.0",
  "author": "Your Name",
  "license": "MIT",
  "main": "dist/index.mjs",
  "engines": {
    "baram": ">=0.5.0"
  },
  "trust": "sandboxed",
  "capabilities": ["editor:readonly", "events", "statusbar"],
  "contributions": {
    "statusBar": [{ "id": "count", "text": "— words" }]
  },
  "keywords": ["word", "count", "statistics"],
  "repository": "https://github.com/user/my-word-count",
  "homepage": "https://example.com"
}

필수 필드

필드	타입	설명
id	string	고유 식별자. 소문자·숫자·하이픈만 씁니다.
name	string	사람이 읽는 표시 이름
description	string	짧은 설명
version	string	Semver 버전
author	string	저자 이름
license	string	SPDX 라이선스 식별자
main	string	진입점 파일. 플러그인 디렉터리 기준 상대 경로(예: dist/index.mjs)
engines.baram	string	최소 Baram 버전. >=X.Y.Z 로 씁니다 — 버전 하한 참조
capabilities	string[]	필요한 권한 — 권한 참조

선택 필드

필드	타입	설명
dependencies	string[]	이 플러그인이 의존하는 다른 플러그인 ID
tiptapExtensions	object[]	이 플러그인이 내보내는 Tiptap 확장 — Tiptap 확장 플러그인 참조
repository	string	소스 코드 URL
homepage	string	문서 URL
icon	string	마켓플레이스·개발 목록용 이모지 아이콘
keywords	string[]	검색 키워드

버전 하한

engines.baram은 플러그인이 도는 가장 오래된 Baram이고, 강제됩니다 — 실행 중인 Baram이 자기 버전으로 그 하한을 채우지 못하면 그 플러그인의 설치·업데이트를 거부하고, 어떤 버전이 필요한지 알려 줍니다. 이것을 틀리는 것은 겉치레 문제가 아닙니다. 필요보다 높은 하한을 선언하면, 돌 수 있었던 사용자에게 플러그인이 설치 불가가 됩니다.

세 숫자를 모두 적어 >=X.Y.Z 로 씁니다.

{ "engines": { "baram": ">=0.5.0" } }

Baram과 배포 워크플로가 함께 읽는 형태는 그것뿐입니다. 그 밖의 것 — ^0.5.0, ~0.5, 0.5.0, 양쪽이 있는 범위 — 은 앱이 하한 없음으로 취급하므로 사용자 보호가 조용히 멈춥니다. 배포 워크플로는 그것을 아예 거부하므로 1군 릴리스가 그렇게 나가지는 않습니다. 프리릴리스 빌드(0.6.0-beta.1)는 semver에 따라 >=0.6.0을 충족하지 않습니다.