[{"data":1,"prerenderedAt":1429},["ShallowReactive",2],{"navigation_docs":3,"package-rules-index":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",[49,226,434,607,928,1156],{"id":50,"title":51,"body":52,"category":58,"description":215,"diagnosticCodes":216,"docsUrl":60,"extension":217,"fix":61,"framework":218,"meta":219,"navigation":220,"pack":62,"path":222,"recommendedReplacement":124,"ruleId":63,"seo":223,"severity":64,"source":65,"sourceUrl":66,"stem":224,"why":117,"__hash__":225},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-duplicate-singleton.md","Install one copy of each singleton package",{"type":53,"value":54,"toc":206},"minimark",[55,67,72,110,114,118,122,125,129,141,145,150,153,165,168,202],[56,57],"rule-metadata",{"category":58,"diagnosticCodes":59,"docsUrl":60,"fix":61,"pack":62,"ruleId":63,"severity":64,"source":65,"sourceUrl":66},"dependencies","PKG0008","https:\u002F\u002Fpnpm.io\u002Fsettings#overrides","suggestion","vite-doctor\u002Fpackage","package\u002Fno-duplicate-singleton","warn","src\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-duplicate-singleton.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-duplicate-singleton.ts",[68,69,71],"h2",{"id":70},"run-this-rule","Run this rule",[73,74,79],"pre",{"className":75,"code":76,"language":77,"meta":78,"style":78},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-duplicate-singleton\n","bash","",[80,81,82],"code",{"__ignoreMap":78},[83,84,87,91,95,98,101,104,107],"span",{"class":85,"line":86},"line",1,[83,88,90],{"class":89},"sBMFI","pnpm",[83,92,94],{"class":93},"sfazB"," vite-doctor",[83,96,97],{"class":93}," .",[83,99,100],{"class":93}," --extends",[83,102,103],{"class":93}," package\u002Frecommended",[83,105,106],{"class":93}," --rules",[83,108,109],{"class":93}," package\u002Fno-duplicate-singleton\n",[68,111,113],{"id":112},"why-it-matters","Why it matters",[115,116,117],"p",{},"Two versions of a singleton are two module instances. Vue, Pinia, Nuxt and React keep their state per instance, so code from one copy cannot see the other's injections, stores or app context, and h3 and Drizzle reject objects created by the other copy. A lockfile resolves the second copy when one package pins a version or a range that excludes the app's.",[68,119,121],{"id":120},"recommended-fix","Recommended fix",[115,123,124],{},"Update the package that resolves the extra version so it accepts the version the rest of the install uses, ideally as a peer, or add a pnpm override for that version and run pnpm install. Doctor reports each duplicate where it enters the workspace, at the package.json entry that leads to it.",[68,126,128],{"id":127},"useful-links","Useful links",[130,131,132],"ul",{},[133,134,135],"li",{},[136,137,140],"a",{"href":60,"rel":138},[139],"nofollow","Rule reference",[68,142,144],{"id":143},"example","Example",[146,147,149],"h3",{"id":148},"override-a-transitive-pin-to-the-apps-vue","Override a transitive pin to the app's Vue",[115,151,152],{},"Before",[73,154,158],{"className":155,"code":156,"language":157,"meta":78,"style":78},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# pnpm-lock.yaml resolves vue 3.5.44 and, through old-ui, vue 3.4.0\n","yaml",[80,159,160],{"__ignoreMap":78},[83,161,162],{"class":85,"line":86},[83,163,156],{"class":164},"sHwdD",[115,166,167],{},"After",[73,169,171],{"className":155,"code":170,"language":157,"meta":78,"style":78},"# pnpm-workspace.yaml\noverrides:\n  vue: 3.5.44\n",[80,172,173,178,189],{"__ignoreMap":78},[83,174,175],{"class":85,"line":86},[83,176,177],{"class":164},"# pnpm-workspace.yaml\n",[83,179,181,185],{"class":85,"line":180},2,[83,182,184],{"class":183},"swJcz","overrides",[83,186,188],{"class":187},"sMK4o",":\n",[83,190,192,195,198],{"class":85,"line":191},3,[83,193,194],{"class":183},"  vue",[83,196,197],{"class":187},":",[83,199,201],{"class":200},"sbssI"," 3.5.44\n",[203,204,205],"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 .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":78,"searchDepth":180,"depth":180,"links":207},[208,209,210,211,212],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":213},[214],{"id":148,"depth":191,"text":149},"Read pnpm-lock.yaml and find workspace packages and apps whose install reaches two versions of the same major of a package the app must load once, such as vue, nuxt, nitro, h3, vite, react or drizzle-orm. Add packages with the singletons option.",[59],"md","package",{},{"title":221},"Duplicate singletons","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-duplicate-singleton",{"title":51,"description":215},"package\u002Frules\u002Fdependencies\u002Fno-duplicate-singleton","INKFpSl3xqS_14iBnhWIP2wMLBRHdVAyHqUTmrXLm_Q",{"id":227,"title":228,"body":229,"category":58,"description":423,"diagnosticCodes":424,"docsUrl":234,"extension":217,"fix":61,"framework":218,"meta":427,"navigation":428,"pack":62,"path":430,"recommendedReplacement":271,"ruleId":235,"seo":431,"severity":64,"source":236,"sourceUrl":237,"stem":432,"why":266,"__hash__":433},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-phantom-dependencies.md","Declare dependencies referenced by published output",{"type":53,"value":230,"toc":414},[231,238,240,262,264,267,269,272,274,281,283,287,289,356,358,411],[56,232],{"category":58,"diagnosticCodes":233,"docsUrl":234,"fix":61,"pack":62,"ruleId":235,"severity":64,"source":236,"sourceUrl":237},"PKG0001,PKG0002","https:\u002F\u002Fnubjs.com\u002Fblog\u002Fphantom-dependencies-package-extensions","package\u002Fno-phantom-dependencies","src\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-phantom-dependencies.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-phantom-dependencies.ts",[68,239,71],{"id":70},[73,241,243],{"className":75,"code":242,"language":77,"meta":78,"style":78},"pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-phantom-dependencies\n",[80,244,245],{"__ignoreMap":78},[83,246,247,249,251,253,255,257,259],{"class":85,"line":86},[83,248,90],{"class":89},[83,250,94],{"class":93},[83,252,97],{"class":93},[83,254,100],{"class":93},[83,256,103],{"class":93},[83,258,106],{"class":93},[83,260,261],{"class":93}," package\u002Fno-phantom-dependencies\n",[68,263,113],{"id":112},[115,265,266],{},"A library can work in its own workspace while its JavaScript or declarations fail for consumers under isolated dependency layouts. Development dependencies and another package's transitive dependencies do not establish the consumer contract.",[68,268,121],{"id":120},[115,270,271],{},"Declare the referenced package in dependencies or peerDependencies according to who owns it. For a guarded optional integration, declare an optional peer. For declaration-only references, preserve the type dependency for consumers or remove it from the emitted declarations. Rebuild and rerun Doctor; do not infer a compatible version range from an installed transitive dependency.",[68,273,128],{"id":127},[130,275,276],{},[133,277,278],{},[136,279,140],{"href":234,"rel":280},[139],[68,282,144],{"id":143},[146,284,286],{"id":285},"declare-a-dependency-retained-in-distindexjs","Declare a dependency retained in dist\u002Findex.js",[115,288,152],{},[73,290,294],{"className":291,"code":292,"language":293,"meta":78,"style":78},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{ \"main\": \"dist\u002Findex.js\", \"devDependencies\": { \"h3\": \"^1.0.0\" } }\n","json",[80,295,296],{"__ignoreMap":78},[83,297,298,301,304,308,311,313,315,318,320,323,325,328,330,332,335,337,339,341,343,345,348,350,353],{"class":85,"line":86},[83,299,300],{"class":187},"{",[83,302,303],{"class":187}," \"",[83,305,307],{"class":306},"spNyl","main",[83,309,310],{"class":187},"\"",[83,312,197],{"class":187},[83,314,303],{"class":187},[83,316,317],{"class":93},"dist\u002Findex.js",[83,319,310],{"class":187},[83,321,322],{"class":187},",",[83,324,303],{"class":187},[83,326,327],{"class":306},"devDependencies",[83,329,310],{"class":187},[83,331,197],{"class":187},[83,333,334],{"class":187}," {",[83,336,303],{"class":187},[83,338,146],{"class":89},[83,340,310],{"class":187},[83,342,197],{"class":187},[83,344,303],{"class":187},[83,346,347],{"class":93},"^1.0.0",[83,349,310],{"class":187},[83,351,352],{"class":187}," }",[83,354,355],{"class":187}," }\n",[115,357,167],{},[73,359,361],{"className":291,"code":360,"language":293,"meta":78,"style":78},"{ \"main\": \"dist\u002Findex.js\", \"dependencies\": { \"h3\": \"^1.0.0\" } }\n",[80,362,363],{"__ignoreMap":78},[83,364,365,367,369,371,373,375,377,379,381,383,385,387,389,391,393,395,397,399,401,403,405,407,409],{"class":85,"line":86},[83,366,300],{"class":187},[83,368,303],{"class":187},[83,370,307],{"class":306},[83,372,310],{"class":187},[83,374,197],{"class":187},[83,376,303],{"class":187},[83,378,317],{"class":93},[83,380,310],{"class":187},[83,382,322],{"class":187},[83,384,303],{"class":187},[83,386,58],{"class":306},[83,388,310],{"class":187},[83,390,197],{"class":187},[83,392,334],{"class":187},[83,394,303],{"class":187},[83,396,146],{"class":89},[83,398,310],{"class":187},[83,400,197],{"class":187},[83,402,303],{"class":187},[83,404,347],{"class":93},[83,406,310],{"class":187},[83,408,352],{"class":187},[83,410,355],{"class":187},[203,412,413],{},"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 .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}",{"title":78,"searchDepth":180,"depth":180,"links":415},[416,417,418,419,420],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":421},[422],{"id":285,"depth":191,"text":286},"Find external packages referenced by library entrypoints and their reachable JavaScript or declarations but absent from consumer dependency declarations.",[425,426],"PKG0001","PKG0002",{},{"title":429},"Phantom deps","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-phantom-dependencies",{"title":228,"description":423},"package\u002Frules\u002Fdependencies\u002Fno-phantom-dependencies","SpZN6AHMkP6XTI6PrVIcXTQ8I9CHVcVP5Mcrw3VoePE",{"id":435,"title":436,"body":437,"category":58,"description":595,"diagnosticCodes":596,"docsUrl":442,"extension":217,"fix":61,"framework":218,"meta":599,"navigation":600,"pack":62,"path":602,"recommendedReplacement":603,"ruleId":443,"seo":604,"severity":64,"source":444,"sourceUrl":445,"stem":605,"why":474,"__hash__":606},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-pinned-singleton.md","Declare singleton packages by range",{"type":53,"value":438,"toc":586},[439,446,448,470,472,475,477,487,489,496,498,502,504,544,546,584],[56,440],{"category":58,"diagnosticCodes":441,"docsUrl":442,"fix":61,"pack":62,"ruleId":443,"severity":64,"source":444,"sourceUrl":445},"PKG0005,PKG0006","https:\u002F\u002Fpnpm.io\u002Fhow-peers-are-resolved","package\u002Fno-pinned-singleton","src\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-pinned-singleton.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-pinned-singleton.ts",[68,447,71],{"id":70},[73,449,451],{"className":75,"code":450,"language":77,"meta":78,"style":78},"pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-pinned-singleton\n",[80,452,453],{"__ignoreMap":78},[83,454,455,457,459,461,463,465,467],{"class":85,"line":86},[83,456,90],{"class":89},[83,458,94],{"class":93},[83,460,97],{"class":93},[83,462,100],{"class":93},[83,464,103],{"class":93},[83,466,106],{"class":93},[83,468,469],{"class":93}," package\u002Fno-pinned-singleton\n",[68,471,113],{"id":112},[115,473,474],{},"An app shares a singleton only when every declaration accepts the app's version. An exact peer fails strict peer checks or makes the package manager install a second copy next to the app's, and an exact dependency installs its own copy whenever the app has another version. Two copies of Vue, Nuxt or React split their state, so injections and composables find nothing, and two copies of h3 or Drizzle fail their identity checks.",[68,476,121],{"id":120},[115,478,479,480,486],{},"Declare the peer as a range that accepts the app's version, such as \"^3.5.44\", or point catalog: at a catalog entry that is a range. For a dependency, take the singleton from the app as a peer, or depend on a range. Configure more singletons with ",[83,481,482,483,352],{},"\"warn\", { \"singletons\": ",[83,484,485],{},"\"comark\", \"@ai-sdk\u002F*\"",".",[68,488,128],{"id":127},[130,490,491],{},[133,492,493],{},[136,494,140],{"href":442,"rel":495},[139],[68,497,144],{"id":143},[146,499,501],{"id":500},"accept-the-apps-vue","Accept the app's Vue",[115,503,152],{},[73,505,507],{"className":291,"code":506,"language":293,"meta":78,"style":78},"{ \"peerDependencies\": { \"vue\": \"3.5.44\" } }\n",[80,508,509],{"__ignoreMap":78},[83,510,511,513,515,518,520,522,524,526,529,531,533,535,538,540,542],{"class":85,"line":86},[83,512,300],{"class":187},[83,514,303],{"class":187},[83,516,517],{"class":306},"peerDependencies",[83,519,310],{"class":187},[83,521,197],{"class":187},[83,523,334],{"class":187},[83,525,303],{"class":187},[83,527,528],{"class":89},"vue",[83,530,310],{"class":187},[83,532,197],{"class":187},[83,534,303],{"class":187},[83,536,537],{"class":93},"3.5.44",[83,539,310],{"class":187},[83,541,352],{"class":187},[83,543,355],{"class":187},[115,545,167],{},[73,547,549],{"className":291,"code":548,"language":293,"meta":78,"style":78},"{ \"peerDependencies\": { \"vue\": \"^3.5.44\" } }\n",[80,550,551],{"__ignoreMap":78},[83,552,553,555,557,559,561,563,565,567,569,571,573,575,578,580,582],{"class":85,"line":86},[83,554,300],{"class":187},[83,556,303],{"class":187},[83,558,517],{"class":306},[83,560,310],{"class":187},[83,562,197],{"class":187},[83,564,334],{"class":187},[83,566,303],{"class":187},[83,568,528],{"class":89},[83,570,310],{"class":187},[83,572,197],{"class":187},[83,574,303],{"class":187},[83,576,577],{"class":93},"^3.5.44",[83,579,310],{"class":187},[83,581,352],{"class":187},[83,583,355],{"class":187},[203,585,413],{},{"title":78,"searchDepth":180,"depth":180,"links":587},[588,589,590,591,592],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":593},[594],{"id":500,"depth":191,"text":501},"Find published workspace packages that declare an exact version of a package the app must load once, such as vue, nuxt, nitro, h3, vite, react or drizzle-orm, in peerDependencies, dependencies or optionalDependencies. catalog: and workspace: specifiers are resolved to the range pnpm publishes. Add packages with the singletons option.",[597,598],"PKG0005","PKG0006",{},{"title":601},"Pinned singletons","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-pinned-singleton","Declare the peer as a range that accepts the app's version, such as \"^3.5.44\", or point catalog: at a catalog entry that is a range. For a dependency, take the singleton from the app as a peer, or depend on a range. Configure more singletons with [\"warn\", { \"singletons\": [\"comark\", \"@ai-sdk\u002F*\"] }].",{"title":436,"description":595},"package\u002Frules\u002Fdependencies\u002Fno-pinned-singleton","BCMYW1Q156hKbFwhsCl3gX-1TUU64speh3VXMaTH1rE",{"id":608,"title":609,"body":610,"category":58,"description":919,"diagnosticCodes":920,"docsUrl":615,"extension":217,"fix":61,"framework":218,"meta":921,"navigation":922,"pack":62,"path":924,"recommendedReplacement":652,"ruleId":616,"seo":925,"severity":64,"source":617,"sourceUrl":618,"stem":926,"why":647,"__hash__":927},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer.md","Keep optional peers optional at the default entrypoint",{"type":53,"value":611,"toc":910},[612,619,621,643,645,648,650,653,655,662,664,668,670,753,755,907],[56,613],{"category":58,"diagnosticCodes":614,"docsUrl":615,"fix":61,"pack":62,"ruleId":616,"severity":64,"source":617,"sourceUrl":618},"PKG0003","https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fconfiguring-npm\u002Fpackage-json#peerdependenciesmeta","package\u002Fno-required-optional-peer","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",[68,620,71],{"id":70},[73,622,624],{"className":75,"code":623,"language":77,"meta":78,"style":78},"pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-required-optional-peer\n",[80,625,626],{"__ignoreMap":78},[83,627,628,630,632,634,636,638,640],{"class":85,"line":86},[83,629,90],{"class":89},[83,631,94],{"class":93},[83,633,97],{"class":93},[83,635,100],{"class":93},[83,637,103],{"class":93},[83,639,106],{"class":93},[83,641,642],{"class":93}," package\u002Fno-required-optional-peer\n",[68,644,113],{"id":112},[115,646,647],{},"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.",[68,649,121],{"id":120},[115,651,652],{},"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.",[68,654,128],{"id":127},[130,656,657],{},[133,658,659],{},[136,660,140],{"href":615,"rel":661},[139],[68,663,144],{"id":143},[146,665,667],{"id":666},"load-an-optional-peer-only-when-its-integration-is-requested","Load an optional peer only when its integration is requested",[115,669,152],{},[73,671,675],{"className":672,"code":673,"language":674,"meta":78,"style":78},"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",[80,676,677,700,729],{"__ignoreMap":78},[83,678,679,683,687,690,692,695,697],{"class":85,"line":86},[83,680,682],{"class":681},"s7zQu","import",[83,684,686],{"class":685},"sTEyZ"," peer ",[83,688,689],{"class":681},"from",[83,691,303],{"class":187},[83,693,694],{"class":93},"optional-peer",[83,696,310],{"class":187},[83,698,699],{"class":187},";\n",[83,701,702,705,708,711,714,717,720,722,725,727],{"class":85,"line":180},[83,703,704],{"class":681},"export",[83,706,707],{"class":306}," const",[83,709,710],{"class":685}," core ",[83,712,713],{"class":187},"=",[83,715,716],{"class":187}," ()",[83,718,719],{"class":306}," =>",[83,721,303],{"class":187},[83,723,724],{"class":93},"ready",[83,726,310],{"class":187},[83,728,699],{"class":187},[83,730,731,733,735,738,740,742,744,748,751],{"class":85,"line":191},[83,732,704],{"class":681},[83,734,707],{"class":306},[83,736,737],{"class":685}," integration ",[83,739,713],{"class":187},[83,741,716],{"class":187},[83,743,719],{"class":306},[83,745,747],{"class":746},"s2Zo4"," peer",[83,749,750],{"class":685},"()",[83,752,699],{"class":187},[115,754,167],{},[73,756,758],{"className":672,"code":757,"language":674,"meta":78,"style":78},"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",[80,759,760,782,800,807,847,859,870,895,901],{"__ignoreMap":78},[83,761,762,764,766,768,770,772,774,776,778,780],{"class":85,"line":86},[83,763,704],{"class":681},[83,765,707],{"class":306},[83,767,710],{"class":685},[83,769,713],{"class":187},[83,771,716],{"class":187},[83,773,719],{"class":306},[83,775,303],{"class":187},[83,777,724],{"class":93},[83,779,310],{"class":187},[83,781,699],{"class":187},[83,783,784,786,789,792,795,797],{"class":85,"line":180},[83,785,704],{"class":681},[83,787,788],{"class":306}," async",[83,790,791],{"class":306}," function",[83,793,794],{"class":746}," integration",[83,796,750],{"class":187},[83,798,799],{"class":187}," {\n",[83,801,802,805],{"class":85,"line":191},[83,803,804],{"class":681},"  try",[83,806,799],{"class":187},[83,808,810,813,815,818,820,822,824,827,830,833,836,838,840,842,845],{"class":85,"line":809},4,[83,811,812],{"class":306},"    const",[83,814,334],{"class":187},[83,816,817],{"class":183}," default",[83,819,197],{"class":187},[83,821,747],{"class":685},[83,823,352],{"class":187},[83,825,826],{"class":187}," =",[83,828,829],{"class":681}," await",[83,831,832],{"class":187}," import",[83,834,835],{"class":183},"(",[83,837,310],{"class":187},[83,839,694],{"class":93},[83,841,310],{"class":187},[83,843,844],{"class":183},")",[83,846,699],{"class":187},[83,848,850,853,855,857],{"class":85,"line":849},5,[83,851,852],{"class":681},"    return",[83,854,747],{"class":746},[83,856,750],{"class":183},[83,858,699],{"class":187},[83,860,862,865,868],{"class":85,"line":861},6,[83,863,864],{"class":187},"  }",[83,866,867],{"class":681}," catch",[83,869,799],{"class":187},[83,871,873,876,879,882,884,886,889,891,893],{"class":85,"line":872},7,[83,874,875],{"class":681},"    throw",[83,877,878],{"class":187}," new",[83,880,881],{"class":746}," Error",[83,883,835],{"class":183},[83,885,310],{"class":187},[83,887,888],{"class":93},"Install optional-peer to use this integration",[83,890,310],{"class":187},[83,892,844],{"class":183},[83,894,699],{"class":187},[83,896,898],{"class":85,"line":897},8,[83,899,900],{"class":187},"  }\n",[83,902,904],{"class":85,"line":903},9,[83,905,906],{"class":187},"}\n",[203,908,909],{},"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":78,"searchDepth":180,"depth":180,"links":911},[912,913,914,915,916],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":917},[918],{"id":666,"depth":191,"text":667},"Find optional peers loaded unconditionally by a package's default JavaScript entrypoint or its required local imports.",[614],{},{"title":923},"Optional peers","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-required-optional-peer",{"title":609,"description":919},"package\u002Frules\u002Fdependencies\u002Fno-required-optional-peer","RXqYKieYUfMSKbGSprzX1vivJV9dcQmO-hH0n4ga0mI",{"id":929,"title":930,"body":931,"category":58,"description":1147,"diagnosticCodes":1148,"docsUrl":442,"extension":217,"fix":61,"framework":218,"meta":1149,"navigation":1150,"pack":62,"path":1152,"recommendedReplacement":972,"ruleId":936,"seo":1153,"severity":64,"source":937,"sourceUrl":938,"stem":1154,"why":967,"__hash__":1155},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-unforwarded-peer.md","Forward the peers of workspace dependencies",{"type":53,"value":932,"toc":1138},[933,939,941,963,965,968,970,973,975,982,984,988,990,1052,1054,1135],[56,934],{"category":58,"diagnosticCodes":935,"docsUrl":442,"fix":61,"pack":62,"ruleId":936,"severity":64,"source":937,"sourceUrl":938},"PKG0007","package\u002Fno-unforwarded-peer","src\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-unforwarded-peer.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Fno-unforwarded-peer.ts",[68,940,71],{"id":70},[73,942,944],{"className":75,"code":943,"language":77,"meta":78,"style":78},"pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Fno-unforwarded-peer\n",[80,945,946],{"__ignoreMap":78},[83,947,948,950,952,954,956,958,960],{"class":85,"line":86},[83,949,90],{"class":89},[83,951,94],{"class":93},[83,953,97],{"class":93},[83,955,100],{"class":93},[83,957,103],{"class":93},[83,959,106],{"class":93},[83,961,962],{"class":93}," package\u002Fno-unforwarded-peer\n",[68,964,113],{"id":112},[115,966,967],{},"A peer is resolved from the packages above the one that declares it. When package A depends on workspace package B and B requires peer P, an app that installs only A never declares P: a strict install has no P and B fails to load, and an auto-installed P is a copy the app does not share. A development dependency on P covers only A's own tests. Yarn reports the same gap as a missing peer of A.",[68,969,121],{"id":120},[115,971,972],{},"Declare the peer in the dependent package's peerDependencies with the same specifier the workspace dependency uses, and keep a devDependency for its own tests. If the dependent never loads the code that needs the peer, declare it as an optional peer instead.",[68,974,128],{"id":127},[130,976,977],{},[133,978,979],{},[136,980,140],{"href":442,"rel":981},[139],[68,983,144],{"id":143},[146,985,987],{"id":986},"forward-auths-drizzle-orm-peer-from-realtime","Forward Auth's drizzle-orm peer from Realtime",[115,989,152],{},[73,991,993],{"className":291,"code":992,"language":293,"meta":78,"style":78},"{ \"name\": \"@acme\u002Frealtime\", \"dependencies\": { \"@acme\u002Fauth\": \"workspace:*\" } }\n\u002F\u002F @acme\u002Fauth: { \"peerDependencies\": { \"drizzle-orm\": \"^1.0.0\" } }\n",[80,994,995,1047],{"__ignoreMap":78},[83,996,997,999,1001,1004,1006,1008,1010,1013,1015,1017,1019,1021,1023,1025,1027,1029,1032,1034,1036,1038,1041,1043,1045],{"class":85,"line":86},[83,998,300],{"class":187},[83,1000,303],{"class":187},[83,1002,1003],{"class":306},"name",[83,1005,310],{"class":187},[83,1007,197],{"class":187},[83,1009,303],{"class":187},[83,1011,1012],{"class":93},"@acme\u002Frealtime",[83,1014,310],{"class":187},[83,1016,322],{"class":187},[83,1018,303],{"class":187},[83,1020,58],{"class":306},[83,1022,310],{"class":187},[83,1024,197],{"class":187},[83,1026,334],{"class":187},[83,1028,303],{"class":187},[83,1030,1031],{"class":89},"@acme\u002Fauth",[83,1033,310],{"class":187},[83,1035,197],{"class":187},[83,1037,303],{"class":187},[83,1039,1040],{"class":93},"workspace:*",[83,1042,310],{"class":187},[83,1044,352],{"class":187},[83,1046,355],{"class":187},[83,1048,1049],{"class":85,"line":180},[83,1050,1051],{"class":164},"\u002F\u002F @acme\u002Fauth: { \"peerDependencies\": { \"drizzle-orm\": \"^1.0.0\" } }\n",[115,1053,167],{},[73,1055,1057],{"className":291,"code":1056,"language":293,"meta":78,"style":78},"{ \"name\": \"@acme\u002Frealtime\", \"dependencies\": { \"@acme\u002Fauth\": \"workspace:*\" }, \"peerDependencies\": { \"drizzle-orm\": \"^1.0.0\" } }\n",[80,1058,1059],{"__ignoreMap":78},[83,1060,1061,1063,1065,1067,1069,1071,1073,1075,1077,1079,1081,1083,1085,1087,1089,1091,1093,1095,1097,1099,1101,1103,1106,1108,1110,1112,1114,1116,1118,1121,1123,1125,1127,1129,1131,1133],{"class":85,"line":86},[83,1062,300],{"class":187},[83,1064,303],{"class":187},[83,1066,1003],{"class":306},[83,1068,310],{"class":187},[83,1070,197],{"class":187},[83,1072,303],{"class":187},[83,1074,1012],{"class":93},[83,1076,310],{"class":187},[83,1078,322],{"class":187},[83,1080,303],{"class":187},[83,1082,58],{"class":306},[83,1084,310],{"class":187},[83,1086,197],{"class":187},[83,1088,334],{"class":187},[83,1090,303],{"class":187},[83,1092,1031],{"class":89},[83,1094,310],{"class":187},[83,1096,197],{"class":187},[83,1098,303],{"class":187},[83,1100,1040],{"class":93},[83,1102,310],{"class":187},[83,1104,1105],{"class":187}," },",[83,1107,303],{"class":187},[83,1109,517],{"class":306},[83,1111,310],{"class":187},[83,1113,197],{"class":187},[83,1115,334],{"class":187},[83,1117,303],{"class":187},[83,1119,1120],{"class":89},"drizzle-orm",[83,1122,310],{"class":187},[83,1124,197],{"class":187},[83,1126,303],{"class":187},[83,1128,347],{"class":93},[83,1130,310],{"class":187},[83,1132,352],{"class":187},[83,1134,355],{"class":187},[203,1136,1137],{},"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 .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 .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":78,"searchDepth":180,"depth":180,"links":1139},[1140,1141,1142,1143,1144],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":1145},[1146],{"id":986,"depth":191,"text":987},"Find published workspace packages that depend on another workspace package without declaring that package's required peers in peerDependencies, dependencies or optionalDependencies.",[935],{},{"title":1151},"Forwarded peers","\u002Fpackage\u002Frules\u002Fdependencies\u002Fno-unforwarded-peer",{"title":930,"description":1147},"package\u002Frules\u002Fdependencies\u002Fno-unforwarded-peer","PFMkXtMsQroYB9MENc95a95oeoFdbeusNr6BrhUGCMY",{"id":1157,"title":1158,"body":1159,"category":58,"description":1418,"diagnosticCodes":1419,"docsUrl":1164,"extension":217,"fix":61,"framework":218,"meta":1420,"navigation":1421,"pack":62,"path":1423,"recommendedReplacement":1424,"ruleId":1165,"seo":1425,"severity":64,"source":1166,"sourceUrl":1167,"stem":1426,"why":1427,"__hash__":1428},"rules\u002Fpackage\u002Frules\u002Fdependencies\u002Foptional-peer-import-in-try.md","Guard import() of optional packages with try or .catch()",{"type":53,"value":1160,"toc":1409},[1161,1168,1170,1192,1194,1212,1214,1226,1228,1235,1237,1241,1243,1297,1299,1406],[56,1162],{"category":58,"diagnosticCodes":1163,"docsUrl":1164,"fix":61,"pack":62,"ruleId":1165,"severity":64,"source":1166,"sourceUrl":1167},"PKG0004","https:\u002F\u002Fesbuild.github.io\u002Fapi\u002F#non-analyzable-imports","package\u002Foptional-peer-import-in-try","src\u002Frule-packs\u002Fpackage\u002Frules\u002Foptional-peer-import-in-try.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fpackage\u002Frules\u002Foptional-peer-import-in-try.ts",[68,1169,71],{"id":70},[73,1171,1173],{"className":75,"code":1172,"language":77,"meta":78,"style":78},"pnpm vite-doctor . --extends package\u002Frecommended --rules package\u002Foptional-peer-import-in-try\n",[80,1174,1175],{"__ignoreMap":78},[83,1176,1177,1179,1181,1183,1185,1187,1189],{"class":85,"line":86},[83,1178,90],{"class":89},[83,1180,94],{"class":93},[83,1182,97],{"class":93},[83,1184,100],{"class":93},[83,1186,103],{"class":93},[83,1188,106],{"class":93},[83,1190,1191],{"class":93}," package\u002Foptional-peer-import-in-try\n",[68,1193,113],{"id":112},[115,1195,1196,1197,1200,1201,1203,1204,1207,1208,1211],{},"esbuild, and the Wrangler, Netlify, and Vite builds that use it, fails the consumer's build when an ",[80,1198,1199],{},"import()"," names a package that is not installed. It keeps the import for run time only when the ",[80,1202,1199],{}," is directly awaited in a try body of the same function or has a .",[80,1205,1206],{},"catch()"," or two-argument .",[80,1209,1210],{},"then()",". A try in a caller, or a loader callback passed to a helper that catches, does not count.",[68,1213,121],{"id":120},[115,1215,1216,1217,1219,1220,1222,1223,1225],{},"Directly await the ",[80,1218,1199],{}," of the optional package inside a try in the function that calls it, and turn a missing package into an error that names the install command. A .",[80,1221,1206],{}," on the ",[80,1224,1199],{}," also works.",[68,1227,128],{"id":127},[130,1229,1230],{},[133,1231,1232],{},[136,1233,140],{"href":1164,"rel":1234},[139],[68,1236,144],{"id":143},[146,1238,1240],{"id":1239},"keep-the-import-of-an-optional-peer-inside-the-try","Keep the import() of an optional peer inside the try",[115,1242,152],{},[73,1244,1246],{"className":672,"code":1245,"language":674,"meta":78,"style":78},"export const loadForge = () => importOptional(() => import(\"forge\"), \"forge\");\n",[80,1247,1248],{"__ignoreMap":78},[83,1249,1250,1252,1254,1257,1259,1261,1263,1266,1268,1270,1272,1274,1276,1278,1281,1283,1285,1287,1289,1291,1293,1295],{"class":85,"line":86},[83,1251,704],{"class":681},[83,1253,707],{"class":306},[83,1255,1256],{"class":685}," loadForge ",[83,1258,713],{"class":187},[83,1260,716],{"class":187},[83,1262,719],{"class":306},[83,1264,1265],{"class":746}," importOptional",[83,1267,835],{"class":685},[83,1269,750],{"class":187},[83,1271,719],{"class":306},[83,1273,832],{"class":187},[83,1275,835],{"class":685},[83,1277,310],{"class":187},[83,1279,1280],{"class":93},"forge",[83,1282,310],{"class":187},[83,1284,844],{"class":685},[83,1286,322],{"class":187},[83,1288,303],{"class":187},[83,1290,1280],{"class":93},[83,1292,310],{"class":187},[83,1294,844],{"class":685},[83,1296,699],{"class":187},[115,1298,167],{},[73,1300,1302],{"className":672,"code":1301,"language":674,"meta":78,"style":78},"export async function loadForge() {\n  try {\n    return await import(\"forge\");\n  } catch (error) {\n    throw new Error(\"Install forge to use this integration\", { cause: error });\n  }\n}\n",[80,1303,1304,1319,1325,1345,1363,1398,1402],{"__ignoreMap":78},[83,1305,1306,1308,1310,1312,1315,1317],{"class":85,"line":86},[83,1307,704],{"class":681},[83,1309,788],{"class":306},[83,1311,791],{"class":306},[83,1313,1314],{"class":746}," loadForge",[83,1316,750],{"class":187},[83,1318,799],{"class":187},[83,1320,1321,1323],{"class":85,"line":180},[83,1322,804],{"class":681},[83,1324,799],{"class":187},[83,1326,1327,1329,1331,1333,1335,1337,1339,1341,1343],{"class":85,"line":191},[83,1328,852],{"class":681},[83,1330,829],{"class":681},[83,1332,832],{"class":187},[83,1334,835],{"class":183},[83,1336,310],{"class":187},[83,1338,1280],{"class":93},[83,1340,310],{"class":187},[83,1342,844],{"class":183},[83,1344,699],{"class":187},[83,1346,1347,1349,1351,1354,1357,1360],{"class":85,"line":809},[83,1348,864],{"class":187},[83,1350,867],{"class":681},[83,1352,1353],{"class":183}," (",[83,1355,1356],{"class":685},"error",[83,1358,1359],{"class":183},") ",[83,1361,1362],{"class":187},"{\n",[83,1364,1365,1367,1369,1371,1373,1375,1378,1380,1382,1384,1387,1389,1392,1394,1396],{"class":85,"line":849},[83,1366,875],{"class":681},[83,1368,878],{"class":187},[83,1370,881],{"class":746},[83,1372,835],{"class":183},[83,1374,310],{"class":187},[83,1376,1377],{"class":93},"Install forge to use this integration",[83,1379,310],{"class":187},[83,1381,322],{"class":187},[83,1383,334],{"class":187},[83,1385,1386],{"class":183}," cause",[83,1388,197],{"class":187},[83,1390,1391],{"class":685}," error",[83,1393,352],{"class":187},[83,1395,844],{"class":183},[83,1397,699],{"class":187},[83,1399,1400],{"class":85,"line":861},[83,1401,900],{"class":187},[83,1403,1404],{"class":85,"line":872},[83,1405,906],{"class":187},[203,1407,1408],{},"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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 .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":78,"searchDepth":180,"depth":180,"links":1410},[1411,1412,1413,1414,1415],{"id":70,"depth":180,"text":71},{"id":112,"depth":180,"text":113},{"id":120,"depth":180,"text":121},{"id":127,"depth":180,"text":128},{"id":143,"depth":180,"text":144,"children":1416},[1417],{"id":1239,"depth":191,"text":1240},"Find import() calls of optional peers and optional dependencies that no try block in the same function and no .catch() handles, in runtime JavaScript reachable from a package export.",[1163],{},{"title":1422},"Optional import()","\u002Fpackage\u002Frules\u002Fdependencies\u002Foptional-peer-import-in-try","Directly await the import() of the optional package inside a try in the function that calls it, and turn a missing package into an error that names the install command. A .catch() on the import() also works.",{"title":1158,"description":1418},"package\u002Frules\u002Fdependencies\u002Foptional-peer-import-in-try","esbuild, and the Wrangler, Netlify, and Vite builds that use it, fails the consumer's build when an import() names a package that is not installed. It keeps the import for run time only when the import() is directly awaited in a try body of the same function or has a .catch() or two-argument .then(). A try in a caller, or a loader callback passed to a helper that catches, does not count.","2re4vF--RJwRbVvLAufTw8Vr6CpoDXWLtHDBAhoj1uM",1795268783490]