Projets

Packages

Bibliothèque · TypeScript · npm

Les paquets npm sous ce site, sous Mêlée, sous Séance et sous on-record, typés aussi loin que va le compilateur.

Des petits paquets TypeScript sans dépendance tierce à l’exécution, publiés sur npm, chacun sorti d’un projet dès qu’un deuxième en avait besoin. L’un traduit, et sait dès la compilation ce que chaque message attend ; un autre dit si quelque chose a marché, sans exception et sans null ; les suivants gardent le thème choisi sans flash, ôtent les exceptions de localStorage et du presse-papiers, et partagent le reset, l’anneau de focus et les réglages du compilateur et du linter dont part chaque projet.

  • TypeScript
  • React
  • Intl
  • Vitest
  • Biome
  • Changesets
  • GitHub Actions
@adrienlcp/i18n
Refusé3 erreurs
const EN = defineDictionary({ greeting: 'Hello {name}' })

translate('greeting', { name: 'Ada' })

translate('greeting')
Refusé par le compilateur: Expected 2 arguments, but got 1

translate('greeting', { nom: 'Ada' })
Refusé par le compilateur: 'nom' does not exist in type '{ name: string }'

translate('greting', { name: 'Ada' })
Refusé par le compilateur: not assignable to '"greeting"'

Les arguments d’un message se lisent dans le message lui-même : oubliez {name} et l’appel ne compile pas. Ni génération de code, ni plugin de build.

Paquets
11
sous @adrienlcp
Installés par
9 projets
Mêlée, on-record, Scoreboard, Analytics, Séance, Pastime, Arbor, List, ce site
Couverture
96 %
lignes exécutées par les tests de chaque paquet, lues le 2026-10-02
Dernière version
4 octobre 2026
sur npm, avec provenance

En bref

  • Le dictionnaire français est typé contre l’anglais, jusqu’à chaque paramètre : une clé oubliée ou un {nom} écrit à la place de {name} casse le build au lieu de s’afficher à l’écran.
  • Chaque règle qu’elle impose est une erreur de compilation : ces tests-là s’écrivent en types et c’est tsc qui les vérifie.
  • browser copie dans le presse-papiers même en HTTP simple, où l’API Clipboard n’existe pas.
  • Versionnés avec Changesets et publiés depuis GitHub Actions avec la provenance npm, jamais depuis un portable.
  • Ce site, Mêlée, Séance et on-record les installent depuis npm, jusqu’à leurs configs TypeScript et Biome.

Tel que le compilateur le lit

Mis en page comme dans un éditeur : une ligne ondulée est un build qui refuse, une ligne violette est ce que le compilateur déduit tout seul.

  1. @adrienlcp/result
    Compile0 erreur
    const parse = (input: string): Result<number, 'not_a_number'> => {
      const value = Number(input)
      return Number.isNaN(value)
        ? Result.failure('not_a_number')
        : Result.success(value)
    }
    
    const result = parse(raw)
    if (result.status === 'failure') return result.error
    Déduit par le compilateur: 'not_a_number'
    result.data
    Déduit par le compilateur: number
    

    Result tient en trente lignes. Un succès qui ne porte rien n’a pas de clé data du tout : personne n’y lit undefined.

  2. export const themeStore = createThemePreferenceStore({
      storageKey: 'app:theme'
    })
    
    // vite.config.ts: runs before the first paint
    plugins: [themePreferencePlugin(themeStore)]
    
    themeStore.setPreference('dark')
    Déduit par le compilateur: <html data-theme="dark">
    Déduit par le compilateur: dark theme-color: media="all"
    Déduit par le compilateur: light theme-color: media="not all"
    

    Un téléphone peint sa barre d’outils avec les balises theme-color, qui suivent le système, pas le visiteur. Le paquet de thème réécrit leur media query avant le premier rendu : un choix sombre sur un téléphone clair a aussi sa barre sombre.

  3. const locale = readRecognizedText({
      key: 'app:locale',
      isRecognized: isLocale
    })
    
    if (locale.status === 'failure') {
      locale.error
      Déduit par le compilateur: 'unavailable' | 'unrecognized'
    } else {
      locale.data
      Déduit par le compilateur: 'en' | 'fr' | null
    }
    

    La fenêtre privée de Safari levait une exception à chaque écriture dans localStorage ; safe-storage y renvoie un Result, comme pour un quota plein ou une valeur rangée par une ancienne version.

Les 11

Chacun à sa version sur npm, et les projets qui l’installent.

Votre équipe, peut-être ?

Je cherche mon prochain poste. Écrivez-moi, ou prenez le CV : un mis en page, et un sobre pour les logiciels de recrutement.