[{"data":1,"prerenderedAt":650},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Fguides\u002Fpackage-library":231,"\u002Fdocs\u002Fguides\u002Fpackage-library-surround":645},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","\u002Fdocs","docs",[9,12,16,20,69,90,123,144,165,190],{"title":10,"path":6,"stem":11},"Gerbtrace Documentation","docs\u002Findex",{"title":13,"path":14,"stem":15},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":17,"path":18,"stem":19},"Licensing","\u002Fdocs\u002Flicensing","docs\u002F2.licensing",{"title":21,"path":22,"stem":23,"children":24,"page":68},"Viewer","\u002Fdocs\u002Fviewer","docs\u002F3.viewer",[25,29,33,37,41,45,49,53,56,60,64],{"title":26,"path":27,"stem":28},"Files","\u002Fdocs\u002Fviewer\u002Ffiles","docs\u002F3.viewer\u002F01.files",{"title":30,"path":31,"stem":32},"PCB","\u002Fdocs\u002Fviewer\u002Fpcb","docs\u002F3.viewer\u002F02.pcb",{"title":34,"path":35,"stem":36},"Panel","\u002Fdocs\u002Fviewer\u002Fpanel","docs\u002F3.viewer\u002F03.panel",{"title":38,"path":39,"stem":40},"Paste","\u002Fdocs\u002Fviewer\u002Fpaste","docs\u002F3.viewer\u002F04.paste",{"title":42,"path":43,"stem":44},"SMD","\u002Fdocs\u002Fviewer\u002Fsmd","docs\u002F3.viewer\u002F05.smd",{"title":46,"path":47,"stem":48},"THT","\u002Fdocs\u002Fviewer\u002Ftht","docs\u002F3.viewer\u002F06.tht",{"title":50,"path":51,"stem":52},"BOM","\u002Fdocs\u002Fviewer\u002Fbom","docs\u002F3.viewer\u002F07.bom",{"title":5,"path":54,"stem":55},"\u002Fdocs\u002Fviewer\u002Fdocs","docs\u002F3.viewer\u002F08.docs",{"title":57,"path":58,"stem":59},"Conversation","\u002Fdocs\u002Fviewer\u002Fconversation","docs\u002F3.viewer\u002F09.conversation",{"title":61,"path":62,"stem":63},"Summary","\u002Fdocs\u002Fviewer\u002Fsummary","docs\u002F3.viewer\u002F10.summary",{"title":65,"path":66,"stem":67},"Pricing","\u002Fdocs\u002Fviewer\u002Fpricing","docs\u002F3.viewer\u002F11.pricing",false,{"title":70,"path":71,"stem":72,"children":73,"page":68},"Tools","\u002Fdocs\u002Ftools","docs\u002F4.tools",[74,78,82,86],{"title":75,"path":76,"stem":77},"Exports","\u002Fdocs\u002Ftools\u002Fexports","docs\u002F4.tools\u002F1.exports",{"title":79,"path":80,"stem":81},"Compare","\u002Fdocs\u002Ftools\u002Fcompare","docs\u002F4.tools\u002F2.compare",{"title":83,"path":84,"stem":85},"Package Manager","\u002Fdocs\u002Ftools\u002Fpackage-manager","docs\u002F4.tools\u002F3.package-manager",{"title":87,"path":88,"stem":89},"Draw Tool","\u002Fdocs\u002Ftools\u002Fdraw-tool","docs\u002F4.tools\u002F4.draw-tool",{"title":91,"path":92,"stem":93,"children":94,"page":68},"Collaboration","\u002Fdocs\u002Fcollaboration","docs\u002F5.collaboration",[95,99,103,107,111,115,119],{"title":96,"path":97,"stem":98},"Team Settings","\u002Fdocs\u002Fcollaboration\u002Fteam-settings","docs\u002F5.collaboration\u002F1.team-settings",{"title":100,"path":101,"stem":102},"Team Members","\u002Fdocs\u002Fcollaboration\u002Fteam-members","docs\u002F5.collaboration\u002F2.team-members",{"title":104,"path":105,"stem":106},"User Profile","\u002Fdocs\u002Fcollaboration\u002Fuser-profile","docs\u002F5.collaboration\u002F3.user-profile",{"title":108,"path":109,"stem":110},"Spaces","\u002Fdocs\u002Fcollaboration\u002Fspaces","docs\u002F5.collaboration\u002F4.spaces",{"title":112,"path":113,"stem":114},"Notifications","\u002Fdocs\u002Fcollaboration\u002Fnotifications","docs\u002F5.collaboration\u002F6.notifications",{"title":116,"path":117,"stem":118},"Plans & Billing","\u002Fdocs\u002Fcollaboration\u002Fplans-and-billing","docs\u002F5.collaboration\u002F7.plans-and-billing",{"title":120,"path":121,"stem":122},"Connected Apps & MCP","\u002Fdocs\u002Fcollaboration\u002Fconnected-apps","docs\u002F5.collaboration\u002F8.connected-apps",{"title":124,"path":125,"stem":126,"children":127,"page":68},"App","\u002Fdocs\u002Fapp","docs\u002F6.app",[128,132,136,140],{"title":129,"path":130,"stem":131},"Desktop App","\u002Fdocs\u002Fapp\u002Fdesktop","docs\u002F6.app\u002F1.desktop",{"title":133,"path":134,"stem":135},"Light & Dark Mode","\u002Fdocs\u002Fapp\u002Flight-dark-mode","docs\u002F6.app\u002F2.light-dark-mode",{"title":137,"path":138,"stem":139},"Performance Monitor","\u002Fdocs\u002Fapp\u002Fperformance-monitor","docs\u002F6.app\u002F3.performance-monitor",{"title":141,"path":142,"stem":143},"Report a Bug","\u002Fdocs\u002Fapp\u002Freport-a-bug","docs\u002F6.app\u002F4.report-a-bug",{"title":145,"path":146,"stem":147,"children":148,"page":68},"Guides","\u002Fdocs\u002Fguides","docs\u002F7.guides",[149,153,157,161],{"title":150,"path":151,"stem":152},"Importing Files","\u002Fdocs\u002Fguides\u002Fimporting-files","docs\u002F7.guides\u002F1.importing-files",{"title":154,"path":155,"stem":156},"Supported Formats","\u002Fdocs\u002Fguides\u002Fsupported-formats","docs\u002F7.guides\u002F2.supported-formats",{"title":158,"path":159,"stem":160},"Package Library","\u002Fdocs\u002Fguides\u002Fpackage-library","docs\u002F7.guides\u002F3.package-library",{"title":162,"path":163,"stem":164},"Panel Checks","\u002Fdocs\u002Fguides\u002Fpanel-checks","docs\u002F7.guides\u002F4.panel-checks",{"title":166,"path":167,"stem":168,"children":169,"page":68},"Reference","\u002Fdocs\u002Freference","docs\u002F8.reference",[170,174,178,182,186],{"title":171,"path":172,"stem":173},"BOM File Format","\u002Fdocs\u002Freference\u002Fbom-format","docs\u002F8.reference\u002F1.bom-format",{"title":175,"path":176,"stem":177},"Package Definitions","\u002Fdocs\u002Freference\u002Fpackage-definitions","docs\u002F8.reference\u002F2.package-definitions",{"title":179,"path":180,"stem":181},"Package Naming","\u002Fdocs\u002Freference\u002Fpackage-naming","docs\u002F8.reference\u002F3.package-naming",{"title":183,"path":184,"stem":185},"TPSys Format","\u002Fdocs\u002Freference\u002Ftpsys-format","docs\u002F8.reference\u002F4.tpsys-format",{"title":187,"path":188,"stem":189},"Jet Printing","\u002Fdocs\u002Freference\u002Fjet-printing","docs\u002F8.reference\u002F5.jet-printing",{"title":191,"path":192,"stem":193,"children":194,"page":68},"Development","\u002Fdocs\u002Fdevelopment","docs\u002F9.development",[195,199,203,207,211,215,219,223,227],{"title":196,"path":197,"stem":198},"Development Setup","\u002Fdocs\u002Fdevelopment\u002Fsetup","docs\u002F9.development\u002F1.setup",{"title":200,"path":201,"stem":202},"Architecture","\u002Fdocs\u002Fdevelopment\u002Farchitecture","docs\u002F9.development\u002F2.architecture",{"title":204,"path":205,"stem":206},"CAD Libraries","\u002Fdocs\u002Fdevelopment\u002Fcad-libraries","docs\u002F9.development\u002F3.cad-libraries",{"title":208,"path":209,"stem":210},"Release Process","\u002Fdocs\u002Fdevelopment\u002Frelease-process","docs\u002F9.development\u002F4.release-process",{"title":212,"path":213,"stem":214},"Error Monitoring","\u002Fdocs\u002Fdevelopment\u002Ferror-monitoring","docs\u002F9.development\u002F5.error-monitoring",{"title":216,"path":217,"stem":218},"Contributing","\u002Fdocs\u002Fdevelopment\u002Fcontributing","docs\u002F9.development\u002F6.contributing",{"title":220,"path":221,"stem":222},"Commit Conventions","\u002Fdocs\u002Fdevelopment\u002Fcommit-conventions","docs\u002F9.development\u002F7.commit-conventions",{"title":224,"path":225,"stem":226},"Sidebar Design","\u002Fdocs\u002Fdevelopment\u002Fsidebar-design","docs\u002F9.development\u002F8.sidebar-design",{"title":228,"path":229,"stem":230},"Operational Runbooks","\u002Fdocs\u002Fdevelopment\u002Frunbooks","docs\u002F9.development\u002F9.runbooks",{"id":232,"title":158,"body":233,"description":638,"extension":639,"links":640,"meta":641,"navigation":642,"path":159,"seo":643,"stem":160,"__hash__":644},"docs\u002Fdocs\u002F7.guides\u002F3.package-library.md",{"type":234,"value":235,"toc":623},"minimark",[236,240,244,249,252,256,264,278,281,302,305,309,312,452,459,463,466,491,494,498,501,537,540,544,547,573,576,590,595,598,609,613,616,620],[237,238,158],"h1",{"id":239},"package-library",[241,242,243],"p",{},"Gerbtrace includes a built-in library of component packages used to render footprints on the board canvas. The library supports both SMD (surface mount) and THT (through-hole) packages, with the ability to add custom team packages.",[245,246,248],"h2",{"id":247},"how-packages-are-used","How packages are used",[241,250,251],{},"When PnP data is imported, Gerbtrace matches the CAD package name from each component against the library. Matched components render with accurate body outlines, pad geometry, and pin-1 markers. Unmatched components display a generic placeholder.",[245,253,255],{"id":254},"built-in-packages","Built-in packages",[241,257,258,259,263],{},"Built-in packages are organized into libraries under ",[260,261,262],"code",{},"public\u002Fpackages\u002Flibraries\u002F",". Each library has:",[265,266,267,275],"ul",{},[268,269,270,271,274],"li",{},"A ",[260,272,273],{},"library.json"," with attribution, license, and provenance metadata",[268,276,277],{},"Individual package JSON files defining the geometry",[241,279,280],{},"Current built-in libraries include:",[265,282,283,290,296],{},[268,284,285,289],{},[286,287,288],"strong",{},"Gerbtrace"," (Newmatik) — core package definitions",[268,291,292,295],{},[286,293,294],{},"KiCad"," — packages derived from the KiCad footprint libraries",[268,297,298,301],{},[286,299,300],{},"DigiKey KiCad"," — packages from DigiKey's KiCad library",[241,303,304],{},"The runtime loads the library tree on demand, so only the packages you use are fetched.",[245,306,308],{"id":307},"package-types","Package types",[241,310,311],{},"All packages use TPSys (Mycronic) package type classifications:",[313,314,315,331],"table",{},[316,317,318],"thead",{},[319,320,321,325,328],"tr",{},[322,323,324],"th",{},"Type",[322,326,327],{},"Description",[322,329,330],{},"Typical packages",[332,333,334,348,361,374,387,400,413,426,439],"tbody",{},[319,335,336,342,345],{},[337,338,339],"td",{},[260,340,341],{},"PT_TWO_POLE",[337,343,344],{},"Two-terminal passives",[337,346,347],{},"Chip resistors, capacitors, diodes",[319,349,350,355,358],{},[337,351,352],{},[260,353,354],{},"PT_THREE_POLE",[337,356,357],{},"Three-terminal devices",[337,359,360],{},"SOT-23 family",[319,362,363,368,371],{},[337,364,365],{},[260,366,367],{},"PT_TWO_SYM",[337,369,370],{},"Dual-inline symmetric",[337,372,373],{},"SOIC, SSOP, TSSOP, DFN",[319,375,376,381,384],{},[337,377,378],{},[260,379,380],{},"PT_FOUR_SYM",[337,382,383],{},"Quad-flat symmetric",[337,385,386],{},"QFP, QFN, LQFP",[319,388,389,394,397],{},[337,390,391],{},[260,392,393],{},"PT_TWO_PLUS_TWO",[337,395,396],{},"Asymmetric quad",[337,398,399],{},"Different lead counts per side pair",[319,401,402,407,410],{},[337,403,404],{},[260,405,406],{},"PT_FOUR_ON_TWO",[337,408,409],{},"Four leads on two sides",[337,411,412],{},"DO-214AA and similar",[319,414,415,420,423],{},[337,416,417],{},[260,418,419],{},"PT_BGA",[337,421,422],{},"Ball Grid Array",[337,424,425],{},"BGA packages",[319,427,428,433,436],{},[337,429,430],{},[260,431,432],{},"PT_OUTLINE",[337,434,435],{},"Outline only",[337,437,438],{},"No lead geometry",[319,440,441,446,449],{},[337,442,443],{},[260,444,445],{},"PT_GENERIC",[337,447,448],{},"Generic with lead groups",[337,450,451],{},"Non-standard layouts",[241,453,454,455,458],{},"See ",[456,457,175],"a",{"href":176}," for the complete technical reference.",[245,460,462],{"id":461},"searching-and-matching","Searching and matching",[241,464,465],{},"The package library supports search by name and alias. When you type a package name in the PnP panel, the search matches against:",[265,467,468,475],{},[268,469,470,471,474],{},"Canonical package names (e.g., ",[260,472,473],{},"SOIC-8",")",[268,476,477,478,481,482,481,485,488,489,474],{},"Aliases (e.g., ",[260,479,480],{},"SO-8",", ",[260,483,484],{},"SO8",[260,486,487],{},"SOP-8"," all resolve to ",[260,490,473],{},[241,492,493],{},"The lookup normalizes input by stripping separators and converting to uppercase, so common variations are handled automatically.",[245,495,497],{"id":496},"team-packages-smd","Team packages (SMD)",[241,499,500],{},"Teams can create custom SMD packages that are shared across all team members:",[265,502,503,509,515,521,527],{},[268,504,505,508],{},[286,506,507],{},"Create"," a new package from the package manager",[268,510,511,514],{},[286,512,513],{},"Edit"," package geometry and properties",[268,516,517,520],{},[286,518,519],{},"Duplicate"," a built-in package as a starting point",[268,522,523,526],{},[286,524,525],{},"Delete"," team packages that are no longer needed",[268,528,529,532,533,536],{},[286,530,531],{},"Export"," packages as JSON or ",[260,534,535],{},".pck"," (TPSys format)",[241,538,539],{},"Team packages are stored in Supabase and available to all team members. Package names must be unique and cannot shadow built-in package names.",[245,541,543],{"id":542},"tht-packages","THT packages",[241,545,546],{},"THT (through-hole) packages use a separate visual system based on primitive shapes:",[265,548,549,555,561,567],{},[268,550,551,554],{},[286,552,553],{},"Rectangles"," — for IC bodies, connectors",[268,556,557,560],{},[286,558,559],{},"Circles"," — for pins, mounting holes",[268,562,563,566],{},[286,564,565],{},"Rounded rectangles"," — for rounded pads",[268,568,569,572],{},[286,570,571],{},"Lines"," — for outlines and details",[241,574,575],{},"THT packages include:",[265,577,578,581,584,587],{},[268,579,580],{},"Pin positions and shapes",[268,582,583],{},"Body graphics (from fabrication and silkscreen layers)",[268,585,586],{},"Drill hole indicators",[268,588,589],{},"Polarity markers near pin 1",[591,592,594],"h3",{"id":593},"team-tht-packages","Team THT packages",[241,596,597],{},"Like SMD packages, teams can create and share custom THT packages. The THT package editor provides a visual canvas where you can:",[265,599,600,603,606],{},[268,601,602],{},"Add and position shape primitives",[268,604,605],{},"Customize colors for body, pins, and strokes",[268,607,608],{},"Preview the package in real time",[245,610,612],{"id":611},"package-preview","Package preview",[241,614,615],{},"The package manager includes a preview pane that renders each package with its full geometry, showing body outline, pads\u002Fballs, and pin-1 highlighting. This helps verify that a package definition is correct before assigning it to components.",[245,617,619],{"id":618},"cad-package-mapping","CAD package mapping",[241,621,622],{},"When PnP data uses non-standard package names, you can create a mapping from the CAD package name to a library package. These mappings persist with the project, so subsequent imports of the same file use the established mapping automatically.",{"title":624,"searchDepth":625,"depth":626,"links":627},"",3,2,[628,629,630,631,632,633,636,637],{"id":247,"depth":626,"text":248},{"id":254,"depth":626,"text":255},{"id":307,"depth":626,"text":308},{"id":461,"depth":626,"text":462},{"id":496,"depth":626,"text":497},{"id":542,"depth":626,"text":543,"children":634},[635],{"id":593,"depth":625,"text":594},{"id":611,"depth":626,"text":612},{"id":618,"depth":626,"text":619},"Browse, search, and manage SMD and THT component packages for Pick and Place visualization.","md",null,{},true,{"title":158,"description":638},"2loyy5eFMVkgkZc_yAagTVvz4XHtjqXHiG2Z9IdboB4",[646,648],{"title":154,"path":155,"stem":156,"description":647,"children":-1},"Complete list of file formats supported by Gerbtrace for Gerber, drill, BOM, PnP, and documents.",{"title":162,"path":163,"stem":164,"description":649,"children":-1},"Validation checklist for verifying panel setup before production handover.",1790998748123]