[{"data":1,"prerenderedAt":439},["ShallowReactive",2],{"navigation_docs":3,"diagnostic-content-PKG0003":48},[4,8,12,16,20,24,28,32,36,40,44],{"title":5,"path":6,"stem":7},"CLI","\u002Fcli","1.cli",{"title":9,"path":10,"stem":11},"Nuxt","\u002Fnuxt","2.nuxt",{"title":13,"path":14,"stem":15},"Vue","\u002Fvue","3.vue",{"title":17,"path":18,"stem":19},"Vite","\u002Fvite","4.vite",{"title":21,"path":22,"stem":23},"Nitro","\u002Fnitro","5.nitro",{"title":25,"path":26,"stem":27},"TypeScript","\u002Ftypescript","6.typescript",{"title":29,"path":30,"stem":31},"shadcn","\u002Fshadcn","7.shadcn",{"title":33,"path":34,"stem":35},"Package","\u002Fpackage","8.package",{"title":37,"path":38,"stem":39},"Extending Doctor","\u002Fextending","9.extending",{"title":41,"path":42,"stem":43},"MCP","\u002Fmcp","9.mcp",{"title":45,"path":46,"stem":47},"Pinia","\u002Fpinia","9.pinia",{"id":49,"title":50,"body":51,"category":57,"code":429,"description":430,"docsUrl":58,"extension":431,"fix":81,"framework":432,"meta":433,"navigation":434,"pack":60,"path":435,"ruleId":61,"rulePath":62,"seo":436,"severity":63,"source":64,"sourceUrl":65,"stem":437,"why":74,"__hash__":438},"diagnostics\u002Fdiagnostics\u002FPKG0003.md","PKG0003: Keep optional peers optional at the default entrypoint",{"type":52,"value":53,"toc":419},"minimark",[54,66,71,75,79,82,86,91,94,190,193,349,353,356,387,391,403,407,415],[55,56],"rule-metadata",{"category":57,"docsUrl":58,"fix":59,"pack":60,"ruleId":61,"rulePath":62,"severity":63,"source":64,"sourceUrl":65},"dependencies","https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fconfiguring-npm\u002Fpackage-json#peerdependenciesmeta","suggestion","vite-doctor\u002Fpackage","package\u002Fno-required-optional-peer","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer","warn","src\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-required-optional-peer.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-required-optional-peer.ts",[67,68,70],"h2",{"id":69},"why-it-happens","Why it happens",[72,73,74],"p",{},"peerDependenciesMeta.optional lets consumers omit a peer. A static import, re-export, or unconditional load from the default entrypoint still requires that peer, so loading the library can fail before an optional integration is used.",[67,76,78],{"id":77},"fix","Fix",[72,80,81],{},"Remove optional: true if every consumer needs the peer. Otherwise defer loading it until the integration is requested and handle absence, or expose that integration through a dedicated subpath that the default entrypoint does not load. Doctor conservatively skips guarded and deferred loads; it does not prove that their error handling is correct.",[67,83,85],{"id":84},"example","Example",[87,88,90],"h3",{"id":89},"load-an-optional-peer-only-when-its-integration-is-requested","Load an optional peer only when its integration is requested",[72,92,93],{},"Before",[95,96,101],"pre",{"className":97,"code":98,"language":99,"meta":100,"style":100},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import peer from \"optional-peer\";\nexport const core = () => \"ready\";\nexport const integration = () => peer();\n","js","",[102,103,104,134,165],"code",{"__ignoreMap":100},[105,106,109,113,117,120,124,128,131],"span",{"class":107,"line":108},"line",1,[105,110,112],{"class":111},"s7zQu","import",[105,114,116],{"class":115},"sTEyZ"," peer ",[105,118,119],{"class":111},"from",[105,121,123],{"class":122},"sMK4o"," \"",[105,125,127],{"class":126},"sfazB","optional-peer",[105,129,130],{"class":122},"\"",[105,132,133],{"class":122},";\n",[105,135,137,140,144,147,150,153,156,158,161,163],{"class":107,"line":136},2,[105,138,139],{"class":111},"export",[105,141,143],{"class":142},"spNyl"," const",[105,145,146],{"class":115}," core ",[105,148,149],{"class":122},"=",[105,151,152],{"class":122}," ()",[105,154,155],{"class":142}," =>",[105,157,123],{"class":122},[105,159,160],{"class":126},"ready",[105,162,130],{"class":122},[105,164,133],{"class":122},[105,166,168,170,172,175,177,179,181,185,188],{"class":107,"line":167},3,[105,169,139],{"class":111},[105,171,143],{"class":142},[105,173,174],{"class":115}," integration ",[105,176,149],{"class":122},[105,178,152],{"class":122},[105,180,155],{"class":142},[105,182,184],{"class":183},"s2Zo4"," peer",[105,186,187],{"class":115},"()",[105,189,133],{"class":122},[72,191,192],{},"After",[95,194,196],{"className":97,"code":195,"language":99,"meta":100,"style":100},"export const core = () => \"ready\";\nexport async function integration() {\n  try {\n    const { default: peer } = await import(\"optional-peer\");\n    return peer();\n  } catch {\n    throw new Error(\"Install optional-peer to use this integration\");\n  }\n}\n",[102,197,198,220,238,245,289,301,312,337,343],{"__ignoreMap":100},[105,199,200,202,204,206,208,210,212,214,216,218],{"class":107,"line":108},[105,201,139],{"class":111},[105,203,143],{"class":142},[105,205,146],{"class":115},[105,207,149],{"class":122},[105,209,152],{"class":122},[105,211,155],{"class":142},[105,213,123],{"class":122},[105,215,160],{"class":126},[105,217,130],{"class":122},[105,219,133],{"class":122},[105,221,222,224,227,230,233,235],{"class":107,"line":136},[105,223,139],{"class":111},[105,225,226],{"class":142}," async",[105,228,229],{"class":142}," function",[105,231,232],{"class":183}," integration",[105,234,187],{"class":122},[105,236,237],{"class":122}," {\n",[105,239,240,243],{"class":107,"line":167},[105,241,242],{"class":111},"  try",[105,244,237],{"class":122},[105,246,248,251,254,258,261,263,266,269,272,275,278,280,282,284,287],{"class":107,"line":247},4,[105,249,250],{"class":142},"    const",[105,252,253],{"class":122}," {",[105,255,257],{"class":256},"swJcz"," default",[105,259,260],{"class":122},":",[105,262,184],{"class":115},[105,264,265],{"class":122}," }",[105,267,268],{"class":122}," =",[105,270,271],{"class":111}," await",[105,273,274],{"class":122}," import",[105,276,277],{"class":256},"(",[105,279,130],{"class":122},[105,281,127],{"class":126},[105,283,130],{"class":122},[105,285,286],{"class":256},")",[105,288,133],{"class":122},[105,290,292,295,297,299],{"class":107,"line":291},5,[105,293,294],{"class":111},"    return",[105,296,184],{"class":183},[105,298,187],{"class":256},[105,300,133],{"class":122},[105,302,304,307,310],{"class":107,"line":303},6,[105,305,306],{"class":122},"  }",[105,308,309],{"class":111}," catch",[105,311,237],{"class":122},[105,313,315,318,321,324,326,328,331,333,335],{"class":107,"line":314},7,[105,316,317],{"class":111},"    throw",[105,319,320],{"class":122}," new",[105,322,323],{"class":183}," Error",[105,325,277],{"class":256},[105,327,130],{"class":122},[105,329,330],{"class":126},"Install optional-peer to use this integration",[105,332,130],{"class":122},[105,334,286],{"class":256},[105,336,133],{"class":122},[105,338,340],{"class":107,"line":339},8,[105,341,342],{"class":122},"  }\n",[105,344,346],{"class":107,"line":345},9,[105,347,348],{"class":122},"}\n",[67,350,352],{"id":351},"verify-the-fix","Verify the fix",[72,354,355],{},"Run only this rule after editing so the report stays focused on the diagnostic you are closing:",[95,357,361],{"className":358,"code":359,"language":360,"meta":100,"style":100},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-required-optional-peer\n","bash",[102,362,363],{"__ignoreMap":100},[105,364,365,369,372,375,378,381,384],{"class":107,"line":108},[105,366,368],{"class":367},"sBMFI","pnpm",[105,370,371],{"class":126}," vite-doctor",[105,373,374],{"class":126}," .",[105,376,377],{"class":126}," --extends",[105,379,380],{"class":126}," package\u002Frecommended",[105,382,383],{"class":126}," --rules",[105,385,386],{"class":126}," package\u002Fno-required-optional-peer\n",[67,388,390],{"id":389},"useful-links","Useful links",[392,393,394],"ul",{},[395,396,397],"li",{},[398,399,402],"a",{"href":58,"rel":400},[401],"nofollow","Upstream docs",[67,404,406],{"id":405},"related-rule","Related rule",[392,408,409],{},[395,410,411],{},[398,412,413],{"href":62},[102,414,61],{},[416,417,418],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":100,"searchDepth":136,"depth":136,"links":420},[421,422,423,426,427,428],{"id":69,"depth":136,"text":70},{"id":77,"depth":136,"text":78},{"id":84,"depth":136,"text":85,"children":424},[425],{"id":89,"depth":167,"text":90},{"id":351,"depth":136,"text":352},{"id":389,"depth":136,"text":390},{"id":405,"depth":136,"text":406},"PKG0003","Find optional peers loaded unconditionally by a package's default JavaScript entrypoint or its required local imports.","md","package",{},true,"\u002Fdiagnostics\u002Fpkg0003",{"title":50,"description":430},"diagnostics\u002FPKG0003","V1--VG4crj4aYlAMsZvq4OcXQ7q5qw0GNo_xnYHbg7Q",1795268808576]