[{"data":1,"prerenderedAt":424},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer":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,"description":413,"diagnosticCodes":414,"docsUrl":59,"extension":415,"fix":60,"framework":416,"meta":417,"navigation":418,"pack":61,"path":420,"recommendedReplacement":123,"ruleId":62,"seo":421,"severity":63,"source":64,"sourceUrl":65,"stem":422,"why":116,"__hash__":423},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer.md","Keep optional peers optional at the default entrypoint",{"type":52,"value":53,"toc":404},"minimark",[54,66,71,109,113,117,121,124,128,140,144,149,152,241,244,400],[55,56],"rule-metadata",{"category":57,"diagnosticCodes":58,"docsUrl":59,"fix":60,"pack":61,"ruleId":62,"severity":63,"source":64,"sourceUrl":65},"dependencies","PKG0003","https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fconfiguring-npm\u002Fpackage-json#peerdependenciesmeta","suggestion","vite-doctor\u002Fpackage","package\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},"run-this-rule","Run this rule",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"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","",[79,80,81],"code",{"__ignoreMap":77},[82,83,86,90,94,97,100,103,106],"span",{"class":84,"line":85},"line",1,[82,87,89],{"class":88},"sBMFI","pnpm",[82,91,93],{"class":92},"sfazB"," vite-doctor",[82,95,96],{"class":92}," .",[82,98,99],{"class":92}," --extends",[82,101,102],{"class":92}," package\u002Frecommended",[82,104,105],{"class":92}," --rules",[82,107,108],{"class":92}," package\u002Fno-required-optional-peer\n",[67,110,112],{"id":111},"why-it-matters","Why it matters",[114,115,116],"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,118,120],{"id":119},"recommended-fix","Recommended fix",[114,122,123],{},"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,125,127],{"id":126},"useful-links","Useful links",[129,130,131],"ul",{},[132,133,134],"li",{},[135,136,139],"a",{"href":59,"rel":137},[138],"nofollow","Rule reference",[67,141,143],{"id":142},"example","Example",[145,146,148],"h3",{"id":147},"load-an-optional-peer-only-when-its-integration-is-requested","Load an optional peer only when its integration is requested",[114,150,151],{},"Before",[72,153,157],{"className":154,"code":155,"language":156,"meta":77,"style":77},"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",[79,158,159,185,216],{"__ignoreMap":77},[82,160,161,165,169,172,176,179,182],{"class":84,"line":85},[82,162,164],{"class":163},"s7zQu","import",[82,166,168],{"class":167},"sTEyZ"," peer ",[82,170,171],{"class":163},"from",[82,173,175],{"class":174},"sMK4o"," \"",[82,177,178],{"class":92},"optional-peer",[82,180,181],{"class":174},"\"",[82,183,184],{"class":174},";\n",[82,186,188,191,195,198,201,204,207,209,212,214],{"class":84,"line":187},2,[82,189,190],{"class":163},"export",[82,192,194],{"class":193},"spNyl"," const",[82,196,197],{"class":167}," core ",[82,199,200],{"class":174},"=",[82,202,203],{"class":174}," ()",[82,205,206],{"class":193}," =>",[82,208,175],{"class":174},[82,210,211],{"class":92},"ready",[82,213,181],{"class":174},[82,215,184],{"class":174},[82,217,219,221,223,226,228,230,232,236,239],{"class":84,"line":218},3,[82,220,190],{"class":163},[82,222,194],{"class":193},[82,224,225],{"class":167}," integration ",[82,227,200],{"class":174},[82,229,203],{"class":174},[82,231,206],{"class":193},[82,233,235],{"class":234},"s2Zo4"," peer",[82,237,238],{"class":167},"()",[82,240,184],{"class":174},[114,242,243],{},"After",[72,245,247],{"className":154,"code":246,"language":156,"meta":77,"style":77},"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",[79,248,249,271,289,296,340,352,363,388,394],{"__ignoreMap":77},[82,250,251,253,255,257,259,261,263,265,267,269],{"class":84,"line":85},[82,252,190],{"class":163},[82,254,194],{"class":193},[82,256,197],{"class":167},[82,258,200],{"class":174},[82,260,203],{"class":174},[82,262,206],{"class":193},[82,264,175],{"class":174},[82,266,211],{"class":92},[82,268,181],{"class":174},[82,270,184],{"class":174},[82,272,273,275,278,281,284,286],{"class":84,"line":187},[82,274,190],{"class":163},[82,276,277],{"class":193}," async",[82,279,280],{"class":193}," function",[82,282,283],{"class":234}," integration",[82,285,238],{"class":174},[82,287,288],{"class":174}," {\n",[82,290,291,294],{"class":84,"line":218},[82,292,293],{"class":163},"  try",[82,295,288],{"class":174},[82,297,299,302,305,309,312,314,317,320,323,326,329,331,333,335,338],{"class":84,"line":298},4,[82,300,301],{"class":193},"    const",[82,303,304],{"class":174}," {",[82,306,308],{"class":307},"swJcz"," default",[82,310,311],{"class":174},":",[82,313,235],{"class":167},[82,315,316],{"class":174}," }",[82,318,319],{"class":174}," =",[82,321,322],{"class":163}," await",[82,324,325],{"class":174}," import",[82,327,328],{"class":307},"(",[82,330,181],{"class":174},[82,332,178],{"class":92},[82,334,181],{"class":174},[82,336,337],{"class":307},")",[82,339,184],{"class":174},[82,341,343,346,348,350],{"class":84,"line":342},5,[82,344,345],{"class":163},"    return",[82,347,235],{"class":234},[82,349,238],{"class":307},[82,351,184],{"class":174},[82,353,355,358,361],{"class":84,"line":354},6,[82,356,357],{"class":174},"  }",[82,359,360],{"class":163}," catch",[82,362,288],{"class":174},[82,364,366,369,372,375,377,379,382,384,386],{"class":84,"line":365},7,[82,367,368],{"class":163},"    throw",[82,370,371],{"class":174}," new",[82,373,374],{"class":234}," Error",[82,376,328],{"class":307},[82,378,181],{"class":174},[82,380,381],{"class":92},"Install optional-peer to use this integration",[82,383,181],{"class":174},[82,385,337],{"class":307},[82,387,184],{"class":174},[82,389,391],{"class":84,"line":390},8,[82,392,393],{"class":174},"  }\n",[82,395,397],{"class":84,"line":396},9,[82,398,399],{"class":174},"}\n",[401,402,403],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .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 pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":77,"searchDepth":187,"depth":187,"links":405},[406,407,408,409,410],{"id":69,"depth":187,"text":70},{"id":111,"depth":187,"text":112},{"id":119,"depth":187,"text":120},{"id":126,"depth":187,"text":127},{"id":142,"depth":187,"text":143,"children":411},[412],{"id":147,"depth":218,"text":148},"Find optional peers loaded unconditionally by a package's default JavaScript entrypoint or its required local imports.",[58],"md","package",{},{"title":419},"Optional peers","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer",{"title":50,"description":413},"package\u002Frules\u002Fdependencies\u002Fno-required-optional-peer","RXqYKieYUfMSKbGSprzX1vivJV9dcQmO-hH0n4ga0mI",1795268786046]