@pulse-91/ui-lib

CLI de type shadcn/ui pour injecter des composants dans un projet.

Utilisation

pnpm dlx @pulse-91/ui-lib add orion/buttons/rounded

Pour ecraser directement le bouton shadcn sans changer les imports:

pnpm dlx @pulse-91/ui-lib add orion/buttons/rounded --replace-shadcn button

Par defaut, les composants sont installes dans:

src/components/pulse-lib

Exemple de resultat:

src/components/pulse-lib/orion/buttons/rounded.tsx

Configuration projet cible

Si un fichier pulse-lib.json existe a la racine du projet cible, la CLI l'utilise.

Exemple:

{
  "installDir": "src/components/custom"
}

Composants disponibles

La CLI calcule automatiquement les composants depuis l'arborescence components/. Aucune entree manuelle de registry n'est necessaire.

Option --replace-shadcn

L'option permet de choisir quel composant shadcn doit etre redirige. Exemples de cibles: button, input, form/field.

Pour orion/buttons/rounded, avec --replace-shadcn button:

• garde le fichier shadcn original intact
• redirige l'alias @/components/shadcn-ui/button vers <installDir>/orion/buttons/rounded.tsx
• adapte automatiquement l'import interne de ce fichier pour eviter la recursion
• ajoute un alias @/components/shadcn-ui/button dans les paths TypeScript afin d'utiliser la surcouche sans changer les imports existants

Commande restore

Pour revenir en arriere sur un override:

pnpm dlx @pulse-91/ui-lib restore --shadcn button

La commande:

• retire l'alias @/components/shadcn-ui/<target> de tsconfig.app.json et tsconfig.json
• garde le composant installe (ex: orion/buttons/rounded.tsx)
• supprime d'anciens fichiers techniques eventuels (<installDir>/shadcn-ui et <installDir>/_base)

Commande remove

Pour supprimer un composant et son override:

pnpm dlx @pulse-91/ui-lib remove orion/buttons/rounded --shadcn button

La commande:

• supprime le composant installe
• retire l'override shadcn (alias)

Publication npm via GitHub

Le projet est configure pour publier automatiquement sur npm lors d'un push sur main:

• branche declencheur: main uniquement
• workflow: .github/workflows/publish-npm.yml
• mode par defaut: publication publique (npm publish --access public)

Prerequis GitHub

Dans le repo GitHub, ajouter le secret:

• NPM_TOKEN: token npm avec droit de publish sur @pulse-91/ui-lib (granular token recommande, avec bypass 2FA pour la publication CI)

Flow release

1. Incremente la version dans package.json (obligatoire avant chaque publication npm).
2. Commit et push sur main.
3. GitHub Actions publie automatiquement sur npm.

Exemple:

npm version patch
git push origin main --follow-tags

Scripts deploy

Pour automatiser ton flow:

npm run deploy:dev

• checkout dev
• pnpm check + pnpm build
• bump version prerelease (x.y.z-dev.n)
• aucun push GitHub

npm run deploy:main

• checkout main
• pnpm check + pnpm build
• bump version patch
• push origin/main avec tag (--follow-tags)
• publication npm auto via GitHub Actions