Référence API · CLI du composant source

@oriatheme/cli

Copiez en toute sécurité la source modifiable de React/Vue ThemeEditor dans un projet grand public ; ce n'est pas une dépendance d'exécution.

Forfait et environnement

Un exécutable Node. Exécuté généralement une fois via pnpm dlx, npm exec, thread dlx ou bunx au lieu de l'ajouter à un bundle de navigateur.

bash

pnpm add -D @oriatheme/cli

bash

npm install -D @oriatheme/cli

bash

yarn add -D @oriatheme/cli

bash

bun add -D @oriatheme/cli

Utilisez le gestionnaire de packages et le fichier de verrouillage déjà choisis par le projet consommateur. Les exemples utilisent uniquement les exportations racine du package ; n'effectuez pas d'importation approfondie à partir de modèles src, dist ou de registre.

Programmatic export

Exporter	Signature	Descriptif
`runCli`	`(args: readonly string[], cwd?: string) => Promise<CliResult>`	Exécute la CLI par programme et renvoie exitCode ainsi que les lignes de sortie.

Commandes courantes

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 imprime un plan et quitte avec le code 2 par défaut ; seul --yes écrit. --dry-run n'effectue aucune écriture et quitte avec le code 0. Utilisez --path pour une cible et une vue dans le projet comme cadre pour Vue. Après examen, remplacez --dry-run par --yes via le même canal ; utilisez ce coureur avec l'éditeur de thème diff --framework pour réagir aux différences.

L'éditeur de thème du registre est désormais 0.2.0, affiche oria-standard@2 et nécessite @oriatheme/core@^0.3.0 dans le projet consommateur. Une deuxième commande préconstruit un pont statique Tailwind CSS v4 et écrit uniquement le CSS généré dans le fichier --out :

bash

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

Sécurité avant d'écrire

La CLI valide les manifestes, le framework, les versions compatibles, les chemins relatifs, les tailles de fichiers et SHA-256. Il rejette les scripts, les HTTP, les échappements de chemin et les cibles de liens symboliques. Il refuse les écrasements par défaut ; diff n'écrit jamais et --overwrite nécessite un --yes explicite. La CLI n’exécute aucun script de cycle de vie du registre et ne télécharge aucun thème ou fichier de projet.