[{"data":1,"prerenderedAt":1475},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig":3,"series-context-\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library":1245},{"id":4,"title":5,"body":6,"contentId":1232,"date":1233,"description":1234,"extension":1235,"github":1236,"meetTheInstructor":1236,"meta":1237,"navigation":210,"part":194,"path":1238,"rawbody":1239,"robots":1236,"schemaOrg":1236,"seo":1240,"seriesSlug":1241,"sitemap":1242,"stem":1243,"subtitle":1236,"topics":1236,"__hash__":1244},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig.md","Une meilleure expérience avec TypeScript et TSConfig",{"type":7,"value":8,"toc":1224},"minimark",[9,35,44,68,73,79,112,126,129,145,153,283,286,293,296,309,325,328,349,353,360,373,376,615,632,635,639,648,652,664,667,716,719,735,741,753,767,770,774,780,784,796,798,868,875,878,886,890,893,899,906,1027,1035,1038,1053,1065,1102,1106,1109,1116,1195,1208,1220],[10,11,12,13,17,18,22,23,26,27,30,31,34],"p",{},"Depuis le début de cette série, nous avons travaillé avec ",[14,15,16],"strong",{},"TypeScript"," en créant des fichiers ",[19,20,21],"code",{},".ts"," et en utilisant ",[19,24,25],{},"lang=\"ts\""," dans la section ",[19,28,29],{},"script"," des composants ",[14,32,33],{},"Vue.js",".",[10,36,37,38,40,41,34],{},"Cependant, nous n'avons pas encore configuré ",[14,39,16],{}," dans notre projet, donc nous ne tirons pas parti de tout son potentiel. De plus, l'un des avantages d'utiliser TypeScript dans une bibliothèque est d'exposer des types aux développeurs qui l'utiliseront. Cela permet le contrôle de type et l'auto-complétion dans leur ",[14,42,43],{},"IDE",[45,46,49],"callout",{"color":47,"icon":48},"success","i-ph-lightbulb-duotone",[10,50,51,52,55,56,59,60,63,64,67],{},"Vérifiez le dossier ",[19,53,54],{},"dist"," dans ",[19,57,58],{},"packages\u002Fhuchet-vue",". Vous remarquerez que seuls des fichiers ",[19,61,62],{},".js"," sont présents. Nous devons générer des fichiers ",[19,65,66],{},".d.ts"," pour exposer les types.",[69,70,72],"h2",{"id":71},"configuration-de-typescript","Configuration de TypeScript",[10,74,75,76,78],{},"Commencez par installer TypeScript et les types Node.js nécessaires dans ",[19,77,58],{}," :",[80,81,87],"pre",{"className":82,"code":83,"filename":84,"language":85,"meta":86,"style":86},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm add -D typescript @types\u002Fnode\n","terminal","bash","",[19,88,89],{"__ignoreMap":86},[90,91,94,98,102,106,109],"span",{"class":92,"line":93},"line",1,[90,95,97],{"class":96},"snPdu","pnpm",[90,99,101],{"class":100},"sIIMD"," add",[90,103,105],{"class":104},"sBjJW"," -D",[90,107,108],{"class":100}," typescript",[90,110,111],{"class":100}," @types\u002Fnode\n",[10,113,114,115,118,119,122,123,125],{},"Grâce à l'énorme ",[14,116,117],{},"écosystème de plugins Vite",", nous pouvons utiliser le plugin ",[19,120,121],{},"vite-plugin-dts"," pour générer des fichiers ",[19,124,66],{}," pour notre bibliothèque.",[10,127,128],{},"Installez-le :",[80,130,132],{"className":82,"code":131,"filename":66,"language":85,"meta":86,"style":86},"pnpm add -D vite-plugin-dts\n",[19,133,134],{"__ignoreMap":86},[90,135,136,138,140,142],{"class":92,"line":93},[90,137,97],{"class":96},[90,139,101],{"class":100},[90,141,105],{"class":104},[90,143,144],{"class":100}," vite-plugin-dts\n",[10,146,147,148,55,151,78],{},"Ensuite, mettez à jour le fichier ",[19,149,150],{},"vite.config.ts",[19,152,58],{},[80,154,158],{"className":155,"code":156,"filename":150,"language":157,"meta":86,"style":86},"language-ts shiki shiki-themes github-light github-light github-dark has-diff","import Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\nimport Dts from 'vite-plugin-dts' \u002F\u002F [!code ++]\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Dts(), \u002F\u002F [!code ++]\n  ],\n  build: {\n    \u002F\u002F ...\n  }\n})\n","ts",[19,159,160,176,189,205,212,227,233,242,252,258,264,271,277],{"__ignoreMap":86},[90,161,162,166,170,173],{"class":92,"line":93},[90,163,165],{"class":164},"s8jYJ","import",[90,167,169],{"class":168},"sxrX7"," Vue ",[90,171,172],{"class":164},"from",[90,174,175],{"class":100}," '@vitejs\u002Fplugin-vue'\n",[90,177,179,181,184,186],{"class":92,"line":178},2,[90,180,165],{"class":164},[90,182,183],{"class":168}," { defineConfig } ",[90,185,172],{"class":164},[90,187,188],{"class":100}," 'vite'\n",[90,190,195,197,200,202],{"class":191,"line":194},[92,192,193],"diff","add",3,[90,196,165],{"class":164},[90,198,199],{"class":168}," Dts ",[90,201,172],{"class":164},[90,203,204],{"class":100}," 'vite-plugin-dts'",[90,206,208],{"class":92,"line":207},4,[90,209,211],{"emptyLinePlaceholder":210},true,"\n",[90,213,215,218,221,224],{"class":92,"line":214},5,[90,216,217],{"class":164},"export",[90,219,220],{"class":164}," default",[90,222,223],{"class":96}," defineConfig",[90,225,226],{"class":168},"({\n",[90,228,230],{"class":92,"line":229},6,[90,231,232],{"class":168},"  plugins: [\n",[90,234,236,239],{"class":92,"line":235},7,[90,237,238],{"class":96},"    Vue",[90,240,241],{"class":168},"(),\n",[90,243,246,249],{"class":244,"line":245},[92,192,193],8,[90,247,248],{"class":96},"    Dts",[90,250,251],{"class":168},"(), ",[90,253,255],{"class":92,"line":254},9,[90,256,257],{"class":168},"  ],\n",[90,259,261],{"class":92,"line":260},10,[90,262,263],{"class":168},"  build: {\n",[90,265,267],{"class":92,"line":266},11,[90,268,270],{"class":269},"sCsY4","    \u002F\u002F ...\n",[90,272,274],{"class":92,"line":273},12,[90,275,276],{"class":168},"  }\n",[90,278,280],{"class":92,"line":279},13,[90,281,282],{"class":168},"})\n",[10,284,285],{},"Est-ce que cela fonctionne maintenant ? Pas encore. Si c'était aussi simple, je n'écrirais pas tout un article à ce sujet !",[10,287,288,289,292],{},"Lorsque vous utilisez TypeScript, vous devez le configurer via un fichier ",[19,290,291],{},"tsconfig.json",". Ce fichier comprend de nombreuses options pour informer TypeScript sur le type de projet, y compris les types et variables globaux, les chemins de fichiers, et même la méthode de compilation de code souhaitée.",[10,294,295],{},"Écrire cela pour la première fois peut être fastidieux, mais heureusement, certains projets fournissent une configuration de base à partir de laquelle étendre.",[10,297,298,299,301,302,304,305,308],{},"Un autre problème avec ",[19,300,291],{}," est qu'un package peut en avoir plusieurs. Notre fichier ",[19,303,150],{}," et nos fichiers ",[19,306,307],{},".vue"," ont des contextes différents. Le premier doit avoir accès à l'API Node.js, tandis que le second a besoin d'accéder à l'API DOM et navigateur.",[10,310,311,312,314,315,324],{},"Nous pouvons résoudre cela en utilisant un seul fichier ",[19,313,291],{}," avec l'option ",[316,317,321],"a",{"href":318,"rel":319},"https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig\u002F#references",[320],"nofollow",[19,322,323],{},"references",". Cela nous permet de diviser un fichier TSConfig en plusieurs fichiers, chacun ciblant un contexte spécifique.",[10,326,327],{},"Voici le plan :",[329,330,331,337,343],"ol",{},[332,333,334,336],"li",{},[19,335,291],{}," pour combiner les deux contextes.",[332,338,339,342],{},[19,340,341],{},"tsconfig.node.json"," pour le contexte Node.js.",[332,344,345,348],{},[19,346,347],{},"tsconfig.app.json"," pour le contexte Vue.js.",[69,350,352],{"id":351},"le-contexte-typescript-node","Le contexte TypeScript Node",[10,354,355,356,55,358,78],{},"Créez le fichier ",[19,357,341],{},[19,359,58],{},[80,361,363],{"className":82,"code":362,"filename":341,"language":85,"meta":86,"style":86},"touch tsconfig.node.json\n",[19,364,365],{"__ignoreMap":86},[90,366,367,370],{"class":92,"line":93},[90,368,369],{"class":96},"touch",[90,371,372],{"class":100}," tsconfig.node.json\n",[10,374,375],{},"Remplissez-le avec le contenu suivant :",[80,377,382],{"className":378,"code":379,"filename":380,"language":381,"meta":86,"style":86},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"compilerOptions\": {\n    \"tsBuildInfoFile\": \".\u002Fnode_modules\u002F.tmp\u002Ftsconfig.node.tsbuildinfo\",\n    \"target\": \"ES2022\",\n    \"lib\": [\"ES2023\"],\n    \"moduleDetection\": \"force\",\n    \"types\": [\"node\"],\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"Bundler\",\n    \"allowImportingTsExtensions\": true,\n    \"strict\": true,\n    \"noFallthroughCasesInSwitch\": true,\n    \"noUnusedLocals\": true,\n    \"noUnusedParameters\": true,\n    \"noEmit\": true,\n    \"isolatedModules\": true,\n    \"skipLibCheck\": true,\n    \"noUncheckedSideEffectImports\": true\n  },\n  \"include\": [\"vite.config.ts\"]\n}\n","Exemple","json",[19,383,384,389,397,411,423,437,449,461,473,485,497,508,519,530,542,554,566,578,589,595,609],{"__ignoreMap":86},[90,385,386],{"class":92,"line":93},[90,387,388],{"class":168},"{\n",[90,390,391,394],{"class":92,"line":178},[90,392,393],{"class":104},"  \"compilerOptions\"",[90,395,396],{"class":168},": {\n",[90,398,399,402,405,408],{"class":92,"line":194},[90,400,401],{"class":104},"    \"tsBuildInfoFile\"",[90,403,404],{"class":168},": ",[90,406,407],{"class":100},"\".\u002Fnode_modules\u002F.tmp\u002Ftsconfig.node.tsbuildinfo\"",[90,409,410],{"class":168},",\n",[90,412,413,416,418,421],{"class":92,"line":207},[90,414,415],{"class":104},"    \"target\"",[90,417,404],{"class":168},[90,419,420],{"class":100},"\"ES2022\"",[90,422,410],{"class":168},[90,424,425,428,431,434],{"class":92,"line":214},[90,426,427],{"class":104},"    \"lib\"",[90,429,430],{"class":168},": [",[90,432,433],{"class":100},"\"ES2023\"",[90,435,436],{"class":168},"],\n",[90,438,439,442,444,447],{"class":92,"line":229},[90,440,441],{"class":104},"    \"moduleDetection\"",[90,443,404],{"class":168},[90,445,446],{"class":100},"\"force\"",[90,448,410],{"class":168},[90,450,451,454,456,459],{"class":92,"line":235},[90,452,453],{"class":104},"    \"types\"",[90,455,430],{"class":168},[90,457,458],{"class":100},"\"node\"",[90,460,436],{"class":168},[90,462,463,466,468,471],{"class":92,"line":245},[90,464,465],{"class":104},"    \"module\"",[90,467,404],{"class":168},[90,469,470],{"class":100},"\"ESNext\"",[90,472,410],{"class":168},[90,474,475,478,480,483],{"class":92,"line":254},[90,476,477],{"class":104},"    \"moduleResolution\"",[90,479,404],{"class":168},[90,481,482],{"class":100},"\"Bundler\"",[90,484,410],{"class":168},[90,486,487,490,492,495],{"class":92,"line":260},[90,488,489],{"class":104},"    \"allowImportingTsExtensions\"",[90,491,404],{"class":168},[90,493,494],{"class":104},"true",[90,496,410],{"class":168},[90,498,499,502,504,506],{"class":92,"line":266},[90,500,501],{"class":104},"    \"strict\"",[90,503,404],{"class":168},[90,505,494],{"class":104},[90,507,410],{"class":168},[90,509,510,513,515,517],{"class":92,"line":273},[90,511,512],{"class":104},"    \"noFallthroughCasesInSwitch\"",[90,514,404],{"class":168},[90,516,494],{"class":104},[90,518,410],{"class":168},[90,520,521,524,526,528],{"class":92,"line":279},[90,522,523],{"class":104},"    \"noUnusedLocals\"",[90,525,404],{"class":168},[90,527,494],{"class":104},[90,529,410],{"class":168},[90,531,533,536,538,540],{"class":92,"line":532},14,[90,534,535],{"class":104},"    \"noUnusedParameters\"",[90,537,404],{"class":168},[90,539,494],{"class":104},[90,541,410],{"class":168},[90,543,545,548,550,552],{"class":92,"line":544},15,[90,546,547],{"class":104},"    \"noEmit\"",[90,549,404],{"class":168},[90,551,494],{"class":104},[90,553,410],{"class":168},[90,555,557,560,562,564],{"class":92,"line":556},16,[90,558,559],{"class":104},"    \"isolatedModules\"",[90,561,404],{"class":168},[90,563,494],{"class":104},[90,565,410],{"class":168},[90,567,569,572,574,576],{"class":92,"line":568},17,[90,570,571],{"class":104},"    \"skipLibCheck\"",[90,573,404],{"class":168},[90,575,494],{"class":104},[90,577,410],{"class":168},[90,579,581,584,586],{"class":92,"line":580},18,[90,582,583],{"class":104},"    \"noUncheckedSideEffectImports\"",[90,585,404],{"class":168},[90,587,588],{"class":104},"true\n",[90,590,592],{"class":92,"line":591},19,[90,593,594],{"class":168},"  },\n",[90,596,598,601,603,606],{"class":92,"line":597},20,[90,599,600],{"class":104},"  \"include\"",[90,602,430],{"class":168},[90,604,605],{"class":100},"\"vite.config.ts\"",[90,607,608],{"class":168},"]\n",[90,610,612],{"class":92,"line":611},21,[90,613,614],{"class":168},"}\n",[10,616,617,618,621,622,625,626,629,630,34],{},"Ce fichier est similaire à ce qui est fourni dans n'importe quel template ",[14,619,620],{},"Vite",", sauf que nous avons ajouté l'option ",[19,623,624],{},"types"," définie sur ",[19,627,628],{},"[\"node\"]"," pour garantir que les types Node.js sont disponibles dans le fichier de configuration Vite. Cette configuration cible uniquement le fichier ",[19,631,150],{},[10,633,634],{},"Cela constitue notre premier contexte TypeScript.",[69,636,638],{"id":637},"le-contexte-typescript-vuejs","Le contexte TypeScript Vue.js",[10,640,641,642,645,646,34],{},"Le deuxième contexte ciblera les fichiers Vue.js et TypeScript de notre dossier ",[19,643,644],{},"src",", nommé ",[19,647,347],{},[10,649,355,650,78],{},[19,651,347],{},[80,653,655],{"className":82,"code":654,"filename":347,"language":85,"meta":86,"style":86},"touch tsconfig.app.json\n",[19,656,657],{"__ignoreMap":86},[90,658,659,661],{"class":92,"line":93},[90,660,369],{"class":96},[90,662,663],{"class":100}," tsconfig.app.json\n",[10,665,666],{},"Incluez le contenu suivant :",[80,668,670],{"className":378,"code":669,"filename":380,"language":381,"meta":86,"style":86},"{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ]\n}\n",[19,671,672,676,688,695,702,707,712],{"__ignoreMap":86},[90,673,674],{"class":92,"line":93},[90,675,388],{"class":168},[90,677,678,681,683,686],{"class":92,"line":178},[90,679,680],{"class":104},"  \"extends\"",[90,682,404],{"class":168},[90,684,685],{"class":100},"\"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\"",[90,687,410],{"class":168},[90,689,690,692],{"class":92,"line":194},[90,691,600],{"class":104},[90,693,694],{"class":168},": [\n",[90,696,697,700],{"class":92,"line":207},[90,698,699],{"class":100},"    \"src\u002F**\u002F*.ts\"",[90,701,410],{"class":168},[90,703,704],{"class":92,"line":214},[90,705,706],{"class":100},"    \"src\u002F**\u002F*.vue\"\n",[90,708,709],{"class":92,"line":229},[90,710,711],{"class":168},"  ]\n",[90,713,714],{"class":92,"line":235},[90,715,614],{"class":168},[10,717,718],{},"Avant d'utiliser cette configuration, installez la configuration de base TypeScript de Vue.js :",[80,720,722],{"className":82,"code":721,"filename":84,"language":85,"meta":86,"style":86},"pnpm add -D @vue\u002Ftsconfig\n",[19,723,724],{"__ignoreMap":86},[90,725,726,728,730,732],{"class":92,"line":93},[90,727,97],{"class":96},[90,729,101],{"class":100},[90,731,105],{"class":104},[90,733,734],{"class":100}," @vue\u002Ftsconfig\n",[10,736,737,738,740],{},"Vue.js propose une configuration de base sur laquelle s'appuyer, ce qui est crucial car TypeScript évolue rapidement, et ",[14,739,33],{}," nécessite des configurations spécifiques. Écrire une configuration TypeScript à partir de zéro n'est pas attrayant pour la plupart des développeurs.",[45,742,743],{"color":47,"icon":48},[10,744,745,746,748,749,752],{},"Je recommande d'examiner le fichier ",[19,747,291],{}," dans le package ",[19,750,751],{},"@vue\u002Ftsconfig",". Il est bien documenté et offre des informations utiles.",[10,754,755,756,759,760,762,763,766],{},"Notre configuration étend la configuration de Vue.js avec l'option ",[19,757,758],{},"extends"," et cible le dossier ",[19,761,644],{}," à l'aide de l'option ",[19,764,765],{},"include",". C'est simple et fonctionnel.",[10,768,769],{},"C'est notre deuxième contexte TypeScript.",[69,771,773],{"id":772},"la-configuration-typescript-globale","La configuration TypeScript globale",[10,775,776,777,779],{},"Maintenant, créez le fichier ",[19,778,291],{}," pour unifier les deux contextes. Ce fichier ne définit pas un nouveau contexte ou des options de compilateur, mais référence les deux autres contextes pour que le compilateur TypeScript puisse les utiliser au besoin.",[10,781,355,782,78],{},[19,783,291],{},[80,785,787],{"className":82,"code":786,"filename":291,"language":85,"meta":86,"style":86},"touch tsconfig.json\n",[19,788,789],{"__ignoreMap":86},[90,790,791,793],{"class":92,"line":93},[90,792,369],{"class":96},[90,794,795],{"class":100}," tsconfig.json\n",[10,797,666],{},[80,799,801],{"className":378,"code":800,"filename":380,"language":381,"meta":86,"style":86},"{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    }\n  ]\n}\n",[19,802,803,807,815,822,827,837,842,846,855,860,864],{"__ignoreMap":86},[90,804,805],{"class":92,"line":93},[90,806,388],{"class":168},[90,808,809,812],{"class":92,"line":178},[90,810,811],{"class":104},"  \"files\"",[90,813,814],{"class":168},": [],\n",[90,816,817,820],{"class":92,"line":194},[90,818,819],{"class":104},"  \"references\"",[90,821,694],{"class":168},[90,823,824],{"class":92,"line":207},[90,825,826],{"class":168},"    {\n",[90,828,829,832,834],{"class":92,"line":214},[90,830,831],{"class":104},"      \"path\"",[90,833,404],{"class":168},[90,835,836],{"class":100},"\".\u002Ftsconfig.app.json\"\n",[90,838,839],{"class":92,"line":229},[90,840,841],{"class":168},"    },\n",[90,843,844],{"class":92,"line":235},[90,845,826],{"class":168},[90,847,848,850,852],{"class":92,"line":245},[90,849,831],{"class":104},[90,851,404],{"class":168},[90,853,854],{"class":100},"\".\u002Ftsconfig.node.json\"\n",[90,856,857],{"class":92,"line":254},[90,858,859],{"class":168},"    }\n",[90,861,862],{"class":92,"line":260},[90,863,711],{"class":168},[90,865,866],{"class":92,"line":266},[90,867,614],{"class":168},[10,869,870,871,874],{},"Le tableau ",[19,872,873],{},"files"," vide est crucial pour éviter d'inclure tous les fichiers du projet. Chaque référence a son propre contexte, donc nous devons nous assurer qu'un seul contexte cible un fichier.",[10,876,877],{},"Cela constitue notre configuration TypeScript globale.",[45,879,880],{"color":47,"icon":48},[10,881,882,883,885],{},"Pour vérifier que tout fonctionne correctement, essayez d'importer un module Node.js dans ",[19,884,150],{}," où il devrait être accessible et dans un fichier Vue.js où il ne devrait pas l'être.",[69,887,889],{"id":888},"génération-des-types","Génération des types",[10,891,892],{},"Avec nos configurations TypeScript en place, nous pouvons procéder à la génération des types pour notre bibliothèque.",[10,894,895,896,898],{},"Puisque nous combinons deux contextes, le plugin ",[19,897,121],{}," a besoin d'un lien explicite vers le contexte de nos composants.",[10,900,901,902,55,904,78],{},"Mettez à jour le fichier ",[19,903,150],{},[19,905,58],{},[80,907,910],{"className":908,"code":909,"filename":150,"language":157,"meta":86,"style":86},"language-ts shiki shiki-themes github-light github-light github-dark","import { resolve } from 'node:path'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\nimport Dts from 'vite-plugin-dts'\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Dts({\n      tsconfigPath: resolve(__dirname, 'tsconfig.app.json'),\n    })\n  ],\n  build: {\n    \u002F\u002F ...\n  },\n})\n",[19,911,912,924,934,944,955,959,969,973,979,985,1002,1007,1011,1015,1019,1023],{"__ignoreMap":86},[90,913,914,916,919,921],{"class":92,"line":93},[90,915,165],{"class":164},[90,917,918],{"class":168}," { resolve } ",[90,920,172],{"class":164},[90,922,923],{"class":100}," 'node:path'\n",[90,925,926,928,930,932],{"class":92,"line":178},[90,927,165],{"class":164},[90,929,169],{"class":168},[90,931,172],{"class":164},[90,933,175],{"class":100},[90,935,936,938,940,942],{"class":92,"line":194},[90,937,165],{"class":164},[90,939,183],{"class":168},[90,941,172],{"class":164},[90,943,188],{"class":100},[90,945,946,948,950,952],{"class":92,"line":207},[90,947,165],{"class":164},[90,949,199],{"class":168},[90,951,172],{"class":164},[90,953,954],{"class":100}," 'vite-plugin-dts'\n",[90,956,957],{"class":92,"line":214},[90,958,211],{"emptyLinePlaceholder":210},[90,960,961,963,965,967],{"class":92,"line":229},[90,962,217],{"class":164},[90,964,220],{"class":164},[90,966,223],{"class":96},[90,968,226],{"class":168},[90,970,971],{"class":92,"line":235},[90,972,232],{"class":168},[90,974,975,977],{"class":92,"line":245},[90,976,238],{"class":96},[90,978,241],{"class":168},[90,980,981,983],{"class":92,"line":254},[90,982,248],{"class":96},[90,984,226],{"class":168},[90,986,987,990,993,996,999],{"class":92,"line":260},[90,988,989],{"class":168},"      tsconfigPath: ",[90,991,992],{"class":96},"resolve",[90,994,995],{"class":168},"(__dirname, ",[90,997,998],{"class":100},"'tsconfig.app.json'",[90,1000,1001],{"class":168},"),\n",[90,1003,1004],{"class":92,"line":266},[90,1005,1006],{"class":168},"    })\n",[90,1008,1009],{"class":92,"line":273},[90,1010,257],{"class":168},[90,1012,1013],{"class":92,"line":279},[90,1014,263],{"class":168},[90,1016,1017],{"class":92,"line":532},[90,1018,270],{"class":269},[90,1020,1021],{"class":92,"line":544},[90,1022,594],{"class":168},[90,1024,1025],{"class":92,"line":556},[90,1026,282],{"class":168},[10,1028,1029,1030,1032,1033,34],{},"Nous utilisons le fichier ",[19,1031,347],{}," puisque Vite construit les fichiers Vue.js et TypeScript à partir du dossier ",[19,1034,644],{},[10,1036,1037],{},"Procédez à la génération des types :",[80,1039,1041],{"className":82,"code":1040,"filename":347,"language":85,"meta":86,"style":86},"pnpm run build\n",[19,1042,1043],{"__ignoreMap":86},[90,1044,1045,1047,1050],{"class":92,"line":93},[90,1046,97],{"class":96},[90,1048,1049],{"class":100}," run",[90,1051,1052],{"class":100}," build\n",[10,1054,1055,1056,1058,1059,1061,1062,1064],{},"Dans notre dossier ",[19,1057,54],{},", un dossier ",[19,1060,624],{}," contenant les fichiers ",[19,1063,66],{}," devrait apparaître.",[80,1066,1070],{"className":1067,"code":1068,"filename":66,"language":1069,"meta":86,"style":86},"language-txt shiki shiki-themes github-light github-light github-dark","dist\n├── index.d.ts\n├── index.mjs\n└── Button\n    ├── Button.vue.d.ts\n    └── index.d.ts\n","txt",[19,1071,1072,1077,1082,1087,1092,1097],{"__ignoreMap":86},[90,1073,1074],{"class":92,"line":93},[90,1075,1076],{},"dist\n",[90,1078,1079],{"class":92,"line":178},[90,1080,1081],{},"├── index.d.ts\n",[90,1083,1084],{"class":92,"line":194},[90,1085,1086],{},"├── index.mjs\n",[90,1088,1089],{"class":92,"line":207},[90,1090,1091],{},"└── Button\n",[90,1093,1094],{"class":92,"line":214},[90,1095,1096],{},"    ├── Button.vue.d.ts\n",[90,1098,1099],{"class":92,"line":229},[90,1100,1101],{},"    └── index.d.ts\n",[69,1103,1105],{"id":1104},"exposition-des-types","Exposition des types",[10,1107,1108],{},"Ayant généré les types, l'étape suivante consiste à les exposer aux développeurs utilisant notre bibliothèque.",[10,1110,901,1111,55,1114,78],{},[19,1112,1113],{},"package.json",[19,1115,58],{},[80,1117,1119],{"className":378,"code":1118,"filename":1113,"language":381,"meta":86,"style":86},"{\n  \"exports\": {\n    \".\": {\n      \"types\": \".\u002Fdist\u002Findex.d.ts\",\n      \"import\": \".\u002Fdist\u002Findex.mjs\"\n    }\n  },\n  \"main\": \".\u002Fdist\u002Findex.mjs\",\n  \"types\": \"dist\u002Findex.d.ts\"\n}\n",[19,1120,1121,1125,1132,1139,1151,1161,1165,1169,1181,1191],{"__ignoreMap":86},[90,1122,1123],{"class":92,"line":93},[90,1124,388],{"class":168},[90,1126,1127,1130],{"class":92,"line":178},[90,1128,1129],{"class":104},"  \"exports\"",[90,1131,396],{"class":168},[90,1133,1134,1137],{"class":92,"line":194},[90,1135,1136],{"class":104},"    \".\"",[90,1138,396],{"class":168},[90,1140,1141,1144,1146,1149],{"class":92,"line":207},[90,1142,1143],{"class":104},"      \"types\"",[90,1145,404],{"class":168},[90,1147,1148],{"class":100},"\".\u002Fdist\u002Findex.d.ts\"",[90,1150,410],{"class":168},[90,1152,1153,1156,1158],{"class":92,"line":214},[90,1154,1155],{"class":104},"      \"import\"",[90,1157,404],{"class":168},[90,1159,1160],{"class":100},"\".\u002Fdist\u002Findex.mjs\"\n",[90,1162,1163],{"class":92,"line":229},[90,1164,859],{"class":168},[90,1166,1167],{"class":92,"line":235},[90,1168,594],{"class":168},[90,1170,1171,1174,1176,1179],{"class":92,"line":245},[90,1172,1173],{"class":104},"  \"main\"",[90,1175,404],{"class":168},[90,1177,1178],{"class":100},"\".\u002Fdist\u002Findex.mjs\"",[90,1180,410],{"class":168},[90,1182,1183,1186,1188],{"class":92,"line":254},[90,1184,1185],{"class":104},"  \"types\"",[90,1187,404],{"class":168},[90,1189,1190],{"class":100},"\"dist\u002Findex.d.ts\"\n",[90,1192,1193],{"class":92,"line":260},[90,1194,614],{"class":168},[10,1196,1197,1198,1200,1201,1204,1205,1207],{},"Nous définissons le champ ",[19,1199,624],{}," pour qu'il pointe vers le fichier ",[19,1202,1203],{},"index.d.ts"," dans le dossier ",[19,1206,54],{},", garantissant que les types sont disponibles dans l'IDE lorsque les développeurs importent notre bibliothèque.",[45,1209,1212],{"color":1210,"icon":1211},"primary","i-ph-info-duotone",[10,1213,1214,1215,1217,1218,34],{},"Assurez-vous que le champ ",[19,1216,624],{}," précède toute autre exportation dans le fichier ",[19,1219,1113],{},[1221,1222,1223],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":86,"searchDepth":178,"depth":178,"links":1225},[1226,1227,1228,1229,1230,1231],{"id":71,"depth":178,"text":72},{"id":351,"depth":178,"text":352},{"id":637,"depth":178,"text":638},{"id":772,"depth":178,"text":773},{"id":888,"depth":178,"text":889},{"id":1104,"depth":178,"text":1105},"09cf0b6c-6e56-4718-85d2-784fc0337ebd","2024-11-24","Apprenez à configurer TypeScript avec plusieurs contextes et à générer des types pour une bibliothèque afin d'exposer des types aux développeurs.","md",null,{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig","---\ncontentId: 09cf0b6c-6e56-4718-85d2-784fc0337ebd\npart: 3\ntitle: Une meilleure expérience avec TypeScript et TSConfig\ndescription: \"Apprenez à configurer TypeScript avec plusieurs contextes et à générer des types pour une bibliothèque afin d'exposer des types aux développeurs.\"\ndate: 2024-11-24\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nDepuis le début de cette série, nous avons travaillé avec **TypeScript** en créant des fichiers `.ts` et en utilisant `lang=\"ts\"` dans la section `script` des composants **Vue.js**.\n\nCependant, nous n'avons pas encore configuré **TypeScript** dans notre projet, donc nous ne tirons pas parti de tout son potentiel. De plus, l'un des avantages d'utiliser TypeScript dans une bibliothèque est d'exposer des types aux développeurs qui l'utiliseront. Cela permet le contrôle de type et l'auto-complétion dans leur **IDE**.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nVérifiez le dossier `dist` dans `packages\u002Fhuchet-vue`. Vous remarquerez que seuls des fichiers `.js` sont présents. Nous devons générer des fichiers `.d.ts` pour exposer les types.\n::\n\n## Configuration de TypeScript\n\nCommencez par installer TypeScript et les types Node.js nécessaires dans `packages\u002Fhuchet-vue` :\n\n```bash [terminal]\npnpm add -D typescript @types\u002Fnode\n```\n\nGrâce à l'énorme **écosystème de plugins Vite**, nous pouvons utiliser le plugin `vite-plugin-dts` pour générer des fichiers `.d.ts` pour notre bibliothèque.\n\nInstallez-le :\n\n```bash [.d.ts]\npnpm add -D vite-plugin-dts\n```\n\nEnsuite, mettez à jour le fichier `vite.config.ts` dans `packages\u002Fhuchet-vue` :\n\n```ts [vite.config.ts]\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\nimport Dts from 'vite-plugin-dts' \u002F\u002F [!code ++]\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Dts(), \u002F\u002F [!code ++]\n  ],\n  build: {\n    \u002F\u002F ...\n  }\n})\n```\n\nEst-ce que cela fonctionne maintenant ? Pas encore. Si c'était aussi simple, je n'écrirais pas tout un article à ce sujet !\n\nLorsque vous utilisez TypeScript, vous devez le configurer via un fichier `tsconfig.json`. Ce fichier comprend de nombreuses options pour informer TypeScript sur le type de projet, y compris les types et variables globaux, les chemins de fichiers, et même la méthode de compilation de code souhaitée.\n\nÉcrire cela pour la première fois peut être fastidieux, mais heureusement, certains projets fournissent une configuration de base à partir de laquelle étendre.\n\nUn autre problème avec `tsconfig.json` est qu'un package peut en avoir plusieurs. Notre fichier `vite.config.ts` et nos fichiers `.vue` ont des contextes différents. Le premier doit avoir accès à l'API Node.js, tandis que le second a besoin d'accéder à l'API DOM et navigateur.\n\nNous pouvons résoudre cela en utilisant un seul fichier `tsconfig.json` avec l'option [`references`](https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig\u002F#references). Cela nous permet de diviser un fichier TSConfig en plusieurs fichiers, chacun ciblant un contexte spécifique.\n\nVoici le plan :\n\n1. `tsconfig.json` pour combiner les deux contextes.\n2. `tsconfig.node.json` pour le contexte Node.js.\n3. `tsconfig.app.json` pour le contexte Vue.js.\n\n## Le contexte TypeScript Node\n\nCréez le fichier `tsconfig.node.json` dans `packages\u002Fhuchet-vue` :\n\n```bash [tsconfig.node.json]\ntouch tsconfig.node.json\n```\n\nRemplissez-le avec le contenu suivant :\n\n```json [Exemple]\n{\n  \"compilerOptions\": {\n    \"tsBuildInfoFile\": \".\u002Fnode_modules\u002F.tmp\u002Ftsconfig.node.tsbuildinfo\",\n    \"target\": \"ES2022\",\n    \"lib\": [\"ES2023\"],\n    \"moduleDetection\": \"force\",\n    \"types\": [\"node\"],\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"Bundler\",\n    \"allowImportingTsExtensions\": true,\n    \"strict\": true,\n    \"noFallthroughCasesInSwitch\": true,\n    \"noUnusedLocals\": true,\n    \"noUnusedParameters\": true,\n    \"noEmit\": true,\n    \"isolatedModules\": true,\n    \"skipLibCheck\": true,\n    \"noUncheckedSideEffectImports\": true\n  },\n  \"include\": [\"vite.config.ts\"]\n}\n```\n\nCe fichier est similaire à ce qui est fourni dans n'importe quel template **Vite**, sauf que nous avons ajouté l'option `types` définie sur `[\"node\"]` pour garantir que les types Node.js sont disponibles dans le fichier de configuration Vite. Cette configuration cible uniquement le fichier `vite.config.ts`.\n\nCela constitue notre premier contexte TypeScript.\n\n## Le contexte TypeScript Vue.js\n\nLe deuxième contexte ciblera les fichiers Vue.js et TypeScript de notre dossier `src`, nommé `tsconfig.app.json`.\n\nCréez le fichier `tsconfig.app.json` :\n\n```bash [tsconfig.app.json]\ntouch tsconfig.app.json\n```\n\nIncluez le contenu suivant :\n\n```json [Exemple]\n{\n  \"extends\": \"@vue\u002Ftsconfig\u002Ftsconfig.dom.json\",\n  \"include\": [\n    \"src\u002F**\u002F*.ts\",\n    \"src\u002F**\u002F*.vue\"\n  ]\n}\n```\n\nAvant d'utiliser cette configuration, installez la configuration de base TypeScript de Vue.js :\n\n```bash [terminal]\npnpm add -D @vue\u002Ftsconfig\n```\n\nVue.js propose une configuration de base sur laquelle s'appuyer, ce qui est crucial car TypeScript évolue rapidement, et **Vue.js** nécessite des configurations spécifiques. Écrire une configuration TypeScript à partir de zéro n'est pas attrayant pour la plupart des développeurs.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nJe recommande d'examiner le fichier `tsconfig.json` dans le package `@vue\u002Ftsconfig`. Il est bien documenté et offre des informations utiles.\n::\n\nNotre configuration étend la configuration de Vue.js avec l'option `extends` et cible le dossier `src` à l'aide de l'option `include`. C'est simple et fonctionnel.\n\nC'est notre deuxième contexte TypeScript.\n\n## La configuration TypeScript globale\n\nMaintenant, créez le fichier `tsconfig.json` pour unifier les deux contextes. Ce fichier ne définit pas un nouveau contexte ou des options de compilateur, mais référence les deux autres contextes pour que le compilateur TypeScript puisse les utiliser au besoin.\n\nCréez le fichier `tsconfig.json` :\n\n```bash [tsconfig.json]\ntouch tsconfig.json\n```\n\nIncluez le contenu suivant :\n\n```json [Exemple]\n{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.node.json\"\n    }\n  ]\n}\n```\n\nLe tableau `files` vide est crucial pour éviter d'inclure tous les fichiers du projet. Chaque référence a son propre contexte, donc nous devons nous assurer qu'un seul contexte cible un fichier.\n\nCela constitue notre configuration TypeScript globale.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nPour vérifier que tout fonctionne correctement, essayez d'importer un module Node.js dans `vite.config.ts` où il devrait être accessible et dans un fichier Vue.js où il ne devrait pas l'être.\n::\n\n## Génération des types\n\nAvec nos configurations TypeScript en place, nous pouvons procéder à la génération des types pour notre bibliothèque.\n\nPuisque nous combinons deux contextes, le plugin `vite-plugin-dts` a besoin d'un lien explicite vers le contexte de nos composants.\n\nMettez à jour le fichier `vite.config.ts` dans `packages\u002Fhuchet-vue` :\n\n```ts [vite.config.ts]\nimport { resolve } from 'node:path'\nimport Vue from '@vitejs\u002Fplugin-vue'\nimport { defineConfig } from 'vite'\nimport Dts from 'vite-plugin-dts'\n\nexport default defineConfig({\n  plugins: [\n    Vue(),\n    Dts({\n      tsconfigPath: resolve(__dirname, 'tsconfig.app.json'),\n    })\n  ],\n  build: {\n    \u002F\u002F ...\n  },\n})\n```\n\nNous utilisons le fichier `tsconfig.app.json` puisque Vite construit les fichiers Vue.js et TypeScript à partir du dossier `src`.\n\nProcédez à la génération des types :\n\n```bash [tsconfig.app.json]\npnpm run build\n```\n\nDans notre dossier `dist`, un dossier `types` contenant les fichiers `.d.ts` devrait apparaître.\n\n```txt [.d.ts]\ndist\n├── index.d.ts\n├── index.mjs\n└── Button\n    ├── Button.vue.d.ts\n    └── index.d.ts\n```\n\n## Exposition des types\n\nAyant généré les types, l'étape suivante consiste à les exposer aux développeurs utilisant notre bibliothèque.\n\nMettez à jour le fichier `package.json` dans `packages\u002Fhuchet-vue` :\n\n```json [package.json]\n{\n  \"exports\": {\n    \".\": {\n      \"types\": \".\u002Fdist\u002Findex.d.ts\",\n      \"import\": \".\u002Fdist\u002Findex.mjs\"\n    }\n  },\n  \"main\": \".\u002Fdist\u002Findex.mjs\",\n  \"types\": \"dist\u002Findex.d.ts\"\n}\n```\n\nNous définissons le champ `types` pour qu'il pointe vers le fichier `index.d.ts` dans le dossier `dist`, garantissant que les types sont disponibles dans l'IDE lorsque les développeurs importent notre bibliothèque.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"primary\"}\nAssurez-vous que le champ `types` précède toute autre exportation dans le fichier `package.json`.\n::\n",{"title":5,"description":1234},"the-complete-guide-to-building-a-vue-js-component-library",{"loc":1238},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fa-better-development-experience-with-typescript-and-tsconfig","i3frYJ1p-BwTR2dXMDgky1_aG5NgE5P8dGlGlSBt0Po",{"overview":1246,"chapters":1443},{"id":1247,"title":1248,"body":1249,"contentId":1425,"date":1233,"description":1426,"extension":1235,"github":1427,"meetTheInstructor":1430,"meta":1431,"navigation":210,"part":1236,"path":1432,"rawbody":1433,"robots":1236,"schemaOrg":1236,"seo":1434,"seriesSlug":1241,"sitemap":1435,"stem":1436,"subtitle":1437,"topics":1438,"__hash__":1442},"series\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library.md","Guide pour construire une bibliothèque de composants Vue.js",{"type":7,"value":1250,"toc":1422},[1251,1254,1257,1269,1273,1276,1289,1292,1409,1412,1416],[10,1252,1253],{},"Bienvenue ! 👋",[10,1255,1256],{},"Au départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.",[10,1258,1259,1260,1264,1265],{},"Cette série est en quelque sorte une suite de l'article ",[316,1261,1263],{"href":1262},"\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library","La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js",", mais elle adopte une approche plus professionnelle. ",[1266,1267,1268],"em",{},"Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre.",[1270,1271],"callout-read-more",{"id":1272},"75df6bff-de40-4056-af23-fae2401cd21a",[10,1274,1275],{},"Bien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.",[10,1277,1278,1279,1284,1285,34],{},"C'est compréhensible. Bien que ",[316,1280,1283],{"href":1281,"rel":1282},"https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild",[320],"unbuild"," soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de ",[316,1286,620],{"href":1287,"rel":1288},"https:\u002F\u002Fvite.dev\u002F",[320],[10,1290,1291],{},"Tout au long de cette série, nous aborderons les sujets suivants :",[329,1293,1294,1306,1339,1356,1373,1379,1391],{},[332,1295,1296,1299,1300,1305],{},[14,1297,1298],{},"Prise en Main avec Monorepo, Linter et Formatter"," : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également ",[316,1301,1304],{"href":1302,"rel":1303},"https:\u002F\u002Feslint.org\u002F",[320],"ESLint"," pour assurer la cohérence du code.",[332,1307,1308,1311,1312,1316,1317,1322,1323,1328,1329,1322,1334,34],{},[14,1309,1310],{},"Création d'un Premier Composant avec Vue.js et Tailwind CSS"," : Nous créerons notre premier composant avec ",[316,1313,33],{"href":1314,"rel":1315},"https:\u002F\u002Fvuejs.org\u002F",[320],", ",[316,1318,1321],{"href":1319,"rel":1320},"https:\u002F\u002Ftailwindcss.com\u002F",[320],"Tailwind CSS"," et ",[316,1324,1327],{"href":1325,"rel":1326},"https:\u002F\u002Fwww.tailwind-variants.org\u002F",[320],"Tailwind Variants"," en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme ",[316,1330,1333],{"href":1331,"rel":1332},"https:\u002F\u002Fwww.radix-vue.com\u002F",[320],"Radix Vue",[316,1335,1338],{"href":1336,"rel":1337},"https:\u002F\u002Fui.nuxt.com\u002F",[320],"Nuxt UI",[332,1340,1341,1344,1345,1349,1350,1355],{},[14,1342,1343],{},"Une Meilleure Expérience de Développement avec TypeScript et TSConfig"," : Nous améliorerons notre expérience de développement en ajoutant ",[316,1346,16],{"href":1347,"rel":1348},"https:\u002F\u002Fwww.typescriptlang.org\u002F",[320]," à notre bibliothèque de composants et en configurant ",[316,1351,1354],{"href":1352,"rel":1353},"https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig",[320],"TSConfig"," pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.",[332,1357,1358,1361,1362,1322,1367,1372],{},[14,1359,1360],{},"Tests Automatiques des Composants avec Vitest et Testing Library"," : Nous écrirons des tests pour nos composants en utilisant ",[316,1363,1366],{"href":1364,"rel":1365},"https:\u002F\u002Fvitest.dev\u002Fguide\u002F",[320],"Vitest",[316,1368,1371],{"href":1369,"rel":1370},"https:\u002F\u002Ftesting-library.com\u002F",[320],"Testing Library"," pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.",[332,1374,1375,1378],{},[14,1376,1377],{},"Livraison Continue et Confiance dans les Composants"," : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.",[332,1380,1381,1384,1385,1390],{},[14,1382,1383],{},"Création d'un Playground et d'un Storybook pour les Composants"," : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec ",[316,1386,1389],{"href":1387,"rel":1388},"https:\u002F\u002Fhistoire.dev\u002F",[320],"Histoire"," pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.",[332,1392,1393,1396,1397,1402,1403,1408],{},[14,1394,1395],{},"Amélioration de l'Intégration avec Unplugin et le Module Nuxt"," : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec ",[316,1398,1401],{"href":1399,"rel":1400},"https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components",[320],"Unplugin Vue Components"," et un ",[316,1404,1407],{"href":1405,"rel":1406},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules",[320],"module Nuxt"," pour utiliser nos composants dans une application Nuxt.",[10,1410,1411],{},"À la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎",[69,1413,1415],{"id":1414},"chapitres","Chapitres",[1417,1418],"series-chapters-list",{"className":1419},[1420,1421],"mx-auto","max-w-5xl",{"title":86,"searchDepth":178,"depth":178,"links":1423},[1424],{"id":1414,"depth":178,"text":1415},"1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2","Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.",{"name":1428,"repository":1429},"huchet-vue","barbapapazes\u002Fhuchet-vue","J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.",{},"\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","---\ncontentId: 1fafed86-05bb-4de4-b7d0-bb0bd6abc9d2\ntitle: Guide pour construire une bibliothèque de composants Vue.js\nsubtitle: Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.\ndescription: Découvrez comment construire une bibliothèque de composants Vue.js en utilisant Vite avec un guide couvrant des techniques de développement web professionnel.\ndate: 2024-11-24\ntopics:\n  - vue\n  - vite\n  - bibliothèque de composants\ngithub:\n  name: huchet-vue\n  repository: barbapapazes\u002Fhuchet-vue\nmeetTheInstructor: J'ai créé cette série parce que j'aime \u003Cstrong>Vue.js\u003C\u002Fstrong> et que, depuis des années, je n'ai pas réussi à trouver un guide complet, à jour et \u003Cstrong>professionnel\u003C\u002Fstrong> sur la façon de construire une bibliothèque de composants Vue.js et que je veux que plus de développeurs de logiciels se sentent capables de créer leur propre bibliothèque.\nseriesSlug: the-complete-guide-to-building-a-vue-js-component-library\n---\n\nBienvenue ! 👋\n\nAu départ, cette série était censée être un seul article, mais il est rapidement devenu évident qu'elle serait trop longue. Même GitHub ne voulait pas l'afficher dans l'onglet des fichiers des pull requests. Par conséquent, j'ai décidé de la diviser en plusieurs articles pour la rendre plus digeste et pour me concentrer sur chaque partie individuellement.\n\nCette série est en quelque sorte une suite de l'article [La Méthode la Plus Simple pour Créer une Bibliothèque de Composants Vue.js](\u002Ffr\u002Fposts\u002Fthe-simplest-method-to-create-a-vue-js-component-library), mais elle adopte une approche plus professionnelle. _Vous apprendrez comment les bibliothèques de composants les plus populaires sont construites dans les coulisses et comment créer la vôtre._\n\n\u003CCalloutReadMore id=\"75df6bff-de40-4056-af23-fae2401cd21a\" \u002F>\n\nBien que ce soit toujours ma méthode préférée lorsque je suis certain de ce que je veux réaliser, j'ai également reçu des retours de lecteurs cherchant un comportement plus personnalisé et nécessitant des fonctionnalités plus complexes.\n\nC'est compréhensible. Bien que [unbuild](https:\u002F\u002Fgithub.com\u002Funjs\u002Funbuild) soit un outil puissant, il ne peut égaler la flexibilité, l'écosystème de plugins et l'adoption de [Vite](https:\u002F\u002Fvite.dev\u002F).\n\nTout au long de cette série, nous aborderons les sujets suivants :\n\n1. **Prise en Main avec Monorepo, Linter et Formatter** : Nous mettrons en place un monorepo pour gérer notre bibliothèque de composants et tous les outils nécessaires pour garantir une bonne expérience de développement. Nous configurerons également [ESLint](https:\u002F\u002Feslint.org\u002F) pour assurer la cohérence du code.\n2. **Création d'un Premier Composant avec Vue.js et Tailwind CSS** : Nous créerons notre premier composant avec [Vue.js](https:\u002F\u002Fvuejs.org\u002F), [Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F) et [Tailwind Variants](https:\u002F\u002Fwww.tailwind-variants.org\u002F) en utilisant les techniques les plus avancées et puissantes employées dans des bibliothèques de composants populaires comme [Radix Vue](https:\u002F\u002Fwww.radix-vue.com\u002F) et [Nuxt UI](https:\u002F\u002Fui.nuxt.com\u002F).\n3. **Une Meilleure Expérience de Développement avec TypeScript et TSConfig** : Nous améliorerons notre expérience de développement en ajoutant [TypeScript](https:\u002F\u002Fwww.typescriptlang.org\u002F) à notre bibliothèque de composants et en configurant [TSConfig](https:\u002F\u002Fwww.typescriptlang.org\u002Ftsconfig) pour nous assurer que nos composants sont correctement typés et que nous pouvons tirer pleinement parti des fonctionnalités de TypeScript.\n4. **Tests Automatiques des Composants avec Vitest et Testing Library** : Nous écrirons des tests pour nos composants en utilisant [Vitest](https:\u002F\u002Fvitest.dev\u002Fguide\u002F) et [Testing Library](https:\u002F\u002Ftesting-library.com\u002F) pour garantir que nos composants fonctionnent comme prévu. Cela est crucial pour une bibliothèque de composants professionnelle qui reste fiable dans le temps.\n5. **Livraison Continue et Confiance dans les Composants** : Nous établirons un processus d'intégration continue pour garantir que nos composants sont toujours livrés avec confiance. Pour chaque commit de chaque branche, nous exécuterons nos tests pour vérifier que tout fonctionne correctement. Nous établirons également un processus de publication pour publier nos composants sur npm.\n6. **Création d'un Playground et d'un Storybook pour les Composants** : Nous créerons un playground pour tester nos composants dans un environnement réel et un storybook avec [Histoire](https:\u002F\u002Fhistoire.dev\u002F) pour les documenter. Cela nous permettra de partager nos composants avec d'autres développeurs et de les tester dans divers scénarios, tant en isolation qu'en combinaison.\n7. **Amélioration de l'Intégration avec Unplugin et le Module Nuxt** : Nous améliorerons l'intégration de notre bibliothèque de composants avec l'écosystème en créant un plugin Vite avec [Unplugin Vue Components](https:\u002F\u002Fgithub.com\u002Funplugin\u002Funplugin-vue-components) et un [module Nuxt](https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fguide\u002Fgoing-further\u002Fmodules) pour utiliser nos composants dans une application Nuxt.\n\nÀ la fin de cette série, vous aurez une bibliothèque de composants Vue.js complète que vous pourrez utiliser dans vos projets ou partager avec la communauté, comme un développeur professionnel. N'est-ce pas excitant ? 😎\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1248,"description":1426},{"loc":1432},"fr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library","Le cours le plus avancé et le plus professionnel pour créer une bibliothèque de composants Vue.js avec Vite.",[1439,1440,1441],"vue","vite","bibliothèque de composants","uPZbK53-TcUyWNHiN_UucohLqZHXH1ZV1Tpgk8hOc5c",[1444,1449,1454,1455,1460,1465,1470],{"contentId":1445,"title":1446,"description":1447,"path":1448,"part":93,"github":1236,"topics":1236},"bd5d11e9-876b-4ed0-b27b-ba400670de76","Bien démarrer avec un monorepo, un linter et un formatter","Commencez votre aventure avec le monorepo ! Apprenez à configurer un linter et un formatter pour un codage rationalisé et l'organisation de votre projet.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fgetting-started-with-monorepo-linter-and-formatter",{"contentId":1450,"title":1451,"description":1452,"path":1453,"part":178,"github":1236,"topics":1236},"24847f3a-2219-4e78-829b-0f5a08fa9baa","Construire un premier composant avec Vue.js et Tailwind CSS","Création d'un composant avec Vue.js en utilisant Tailwind CSS pour le style et les variantes, ainsi qu'une configuration du build avec Vite.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fbuilding-a-first-component-with-vuejs-and-tailwind-css",{"contentId":1232,"title":5,"description":1234,"path":1238,"part":194,"github":1236,"topics":1236},{"contentId":1456,"title":1457,"description":1458,"path":1459,"part":207,"github":1236,"topics":1236},"ebf9971d-0101-4d55-815b-87be77651be6","Test de composants automatisé avec Vitest et Testing Library","Apprenez à automatiser les tests pour les composants Vue.js en utilisant Vitest et Testing Library pour des tests efficaces et centrés sur l'utilisateur.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fautomatic-component-testing-with-vitest-and-testing-library",{"contentId":1461,"title":1462,"description":1463,"path":1464,"part":214,"github":1236,"topics":1236},"e3477b60-7fca-49d3-a944-2bde3f39a3c1","Intégration continue et livraison simplifiée des composants","Implémentez un pipeline d'intégration continue avec GitHub Actions et automatisez le processus de publication sur npm","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fdelivering-components-continuously-and-with-confidence",{"contentId":1466,"title":1467,"description":1468,"path":1469,"part":229,"github":1236,"topics":1236},"0d31ab1a-2cc6-44d0-bdf5-31a5ecacd755","Créer un Playground et un Storybook pour les Composants","Découvrez comment créer un playground et utiliser Histoire pour visualiser et documenter vos composants dans des scénarios isolés et combinés.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fcreating-a-playground-and-a-storybook-for-components",{"contentId":1471,"title":1472,"description":1473,"path":1474,"part":235,"github":1236,"topics":1236},"aa563897-2826-4726-bdaf-4441199328d8","Améliorer l'intégration avec Unplugin et Nuxt Module","Découvrez comment intégrer sans effort une bibliothèque de composants Vue.js en utilisant Unplugin Vue Components et Nuxt Module.","\u002Ffr\u002Fseries\u002Fthe-complete-guide-to-building-a-vue-js-component-library\u002Fenhancing-integration-with-unplugin-and-nuxt-module",1795016703252]