API 참조 · 소스 구성 요소 CLI

@oriatheme/cli

편집 가능한 React/Vue ThemeEditor 소스를 소비자 프로젝트에 안전하게 복사합니다. 이는 런타임 종속성이 아닙니다.

패키지 및 환경

노드 실행 파일. 일반적으로 브라우저 번들에 추가하는 대신 pnpm dlx, npm exec, Yarn dlx 또는 bunx를 통해 한 번 실행합니다.

bash

pnpm add -D @oriatheme/cli

bash

npm install -D @oriatheme/cli

bash

yarn add -D @oriatheme/cli

bash

bun add -D @oriatheme/cli

소비자 프로젝트에서 이미 선택한 패키지 관리자와 잠금 파일을 사용하세요. 예제에서는 패키지 루트 내보내기만 사용합니다. src, dist 또는 레지스트리 템플릿에서 깊이 가져오지 마세요.

Programmatic export

수출	서명	설명
`runCli`	`(args: readonly string[], cwd?: string) => Promise<CliResult>`	프로그래밍 방식으로 CLI를 실행하고 exitCode와 출력 라인을 반환합니다.

일반적인 명령

bash

pnpm dlx @oriatheme/cli@latest add theme-editor --framework react --dry-run

bash

npm exec --yes --package=@oriatheme/cli@latest -- oria add theme-editor --framework react --dry-run

bash

yarn dlx @oriatheme/cli@latest add theme-editor --framework react --dry-run

bash

bunx @oriatheme/cli@latest add theme-editor --framework react --dry-run

add는 계획을 인쇄하고 기본적으로 코드 2로 종료합니다. --yes만 씁니다. --dry-run는 쓰기를 수행하지 않고 코드 0으로 종료합니다. 프로젝트 내 대상에는 --path를 사용하고 Vue의 프레임워크로 vue를 사용합니다. 검토 후 동일한 러너를 통해 --dry-run를 --yes로 교체합니다. 차이점에 대해 diff 테마 편집기 --framework 반응과 함께 해당 러너를 사용하십시오.

레지스트리 테마 편집기는 이제 0.2.0이고 oria-standard@2를 렌더링하며 소비자 프로젝트에 @oriatheme/core@^0.3.0이 필요합니다. 두 번째 명령은 정적 Tailwind CSS v4 브리지를 사전 구축하고 생성된 CSS만 --out 파일에 씁니다.

bash

oria theme tailwind-bridge --out src/oria-tailwind.css
oria theme tailwind-bridge --prefix acme --out src/oria-tailwind.css --dry-run

쓰기 전 안전

CLI는 매니페스트, 프레임워크, 호환 버전, 상대 경로, 파일 크기 및 SHA-256의 유효성을 검사합니다. 스크립트, HTTP, 경로 이스케이프 및 심볼릭 링크 대상을 거부합니다. 기본적으로 덮어쓰기를 거부합니다. diff는 절대 쓰지 않으며 --overwrite에는 명시적인 --yes가 필요합니다. CLI는 레지스트리 수명 주기 스크립트를 실행하지 않으며 테마나 프로젝트 파일을 업로드하지 않습니다.