[{"data":1,"prerenderedAt":1382},["ShallowReactive",2],{"navigation_docs":3,"-documentation-getting-started-contributing":377,"-documentation-getting-started-contributing-surround":396,"contributing-guide":401},[4,110,314],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Documentation","\u002Fdocumentation","1.documentation",[9,35,56,89],{"title":10,"path":11,"stem":12,"children":13,"page":34},"Getting Started","\u002Fdocumentation\u002Fgetting-started","1.documentation\u002F1.getting-started",[14,18,22,26,30],{"title":15,"path":16,"stem":17},"Installation","\u002Fdocumentation\u002Fgetting-started\u002Finstallation","1.documentation\u002F1.getting-started\u002F1.installation",{"title":19,"path":20,"stem":21},"Agents","\u002Fdocumentation\u002Fgetting-started\u002Fagents","1.documentation\u002F1.getting-started\u002F2.agents",{"title":23,"path":24,"stem":25},"Migration","\u002Fdocumentation\u002Fgetting-started\u002Fmigration","1.documentation\u002F1.getting-started\u002F3.migration",{"title":27,"path":28,"stem":29},"Contributing","\u002Fdocumentation\u002Fgetting-started\u002Fcontributing","1.documentation\u002F1.getting-started\u002F4.contributing",{"title":31,"path":32,"stem":33},"What's new","\u002Fdocumentation\u002Fgetting-started\u002Fwhats-new","1.documentation\u002F1.getting-started\u002F5.whats-new",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Guidelines","\u002Fdocumentation\u002Fguidelines","1.documentation\u002F2.guidelines",[40,44,48,52],{"title":41,"path":42,"stem":43},"Design Principles","\u002Fdocumentation\u002Fguidelines\u002Fdesign-principles","1.documentation\u002F2.guidelines\u002F1.design-principles",{"title":45,"path":46,"stem":47},"Accessibility","\u002Fdocumentation\u002Fguidelines\u002Faccessibility","1.documentation\u002F2.guidelines\u002F2.accessibility",{"title":49,"path":50,"stem":51},"Interactions","\u002Fdocumentation\u002Fguidelines\u002Finteractions","1.documentation\u002F2.guidelines\u002F3.interactions",{"title":53,"path":54,"stem":55},"Components","\u002Fdocumentation\u002Fguidelines\u002Fcomponents","1.documentation\u002F2.guidelines\u002F4.components",{"title":57,"path":58,"stem":59,"children":60,"page":34},"Design","\u002Fdocumentation\u002Fdesign","1.documentation\u002F3.design",[61,65,69,73,77,81,85],{"title":62,"path":63,"stem":64},"Tokens","\u002Fdocumentation\u002Fdesign\u002Ftokens","1.documentation\u002F3.design\u002F1.tokens",{"title":66,"path":67,"stem":68},"Color Palette","\u002Fdocumentation\u002Fdesign\u002Fcolor-palette","1.documentation\u002F3.design\u002F2.color-palette",{"title":70,"path":71,"stem":72},"Elevation","\u002Fdocumentation\u002Fdesign\u002Felevation","1.documentation\u002F3.design\u002F3.elevation",{"title":74,"path":75,"stem":76},"Spacing","\u002Fdocumentation\u002Fdesign\u002Fspacing","1.documentation\u002F3.design\u002F4.spacing",{"title":78,"path":79,"stem":80},"Border Radius","\u002Fdocumentation\u002Fdesign\u002Fborder-radius","1.documentation\u002F3.design\u002F5.border-radius",{"title":82,"path":83,"stem":84},"Typography","\u002Fdocumentation\u002Fdesign\u002Ftypography","1.documentation\u002F3.design\u002F6.typography",{"title":86,"path":87,"stem":88},"Icons","\u002Fdocumentation\u002Fdesign\u002Ficons","1.documentation\u002F3.design\u002F7.icons",{"title":90,"path":91,"stem":92,"children":93,"page":34},"Content","\u002Fdocumentation\u002Fcontent","1.documentation\u002F4.content",[94,98,102,106],{"title":95,"path":96,"stem":97},"Wording","\u002Fdocumentation\u002Fcontent\u002Fwording","1.documentation\u002F4.content\u002F1.wording",{"title":99,"path":100,"stem":101},"Messaging","\u002Fdocumentation\u002Fcontent\u002Fmessaging","1.documentation\u002F4.content\u002F2.messaging",{"title":103,"path":104,"stem":105},"Glossary","\u002Fdocumentation\u002Fcontent\u002Fglossary","1.documentation\u002F4.content\u002F3.glossary",{"title":107,"path":108,"stem":109},"Artificial Intelligence","\u002Fdocumentation\u002Fcontent\u002Fartificial-intelligence","1.documentation\u002F4.content\u002F4.artificial-intelligence",{"title":53,"path":111,"stem":112,"children":113,"page":34},"\u002Fcomponents","2.components",[114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,270,274,278,282,286,290,294,298,302,306,310],{"title":115,"path":116,"stem":117},"Action Menu","\u002Fcomponents\u002Faction-menu","2.components\u002Faction-menu",{"title":119,"path":120,"stem":121},"App","\u002Fcomponents\u002Fapp","2.components\u002Fapp",{"title":123,"path":124,"stem":125},"Avatar","\u002Fcomponents\u002Favatar","2.components\u002Favatar",{"title":127,"path":128,"stem":129},"Badge","\u002Fcomponents\u002Fbadge","2.components\u002Fbadge",{"title":131,"path":132,"stem":133},"Banner","\u002Fcomponents\u002Fbanner","2.components\u002Fbanner",{"title":135,"path":136,"stem":137},"Breadcrumb","\u002Fcomponents\u002Fbreadcrumb","2.components\u002Fbreadcrumb",{"title":139,"path":140,"stem":141},"Button","\u002Fcomponents\u002Fbutton","2.components\u002Fbutton",{"title":143,"path":144,"stem":145},"Card","\u002Fcomponents\u002Fcard","2.components\u002Fcard",{"title":147,"path":148,"stem":149},"Chart","\u002Fcomponents\u002Fchart","2.components\u002Fchart",{"title":151,"path":152,"stem":153},"Checkbox","\u002Fcomponents\u002Fcheckbox","2.components\u002Fcheckbox",{"title":155,"path":156,"stem":157},"Collapsible","\u002Fcomponents\u002Fcollapsible","2.components\u002Fcollapsible",{"title":159,"path":160,"stem":161},"Colorpicker","\u002Fcomponents\u002Fcolorpicker","2.components\u002Fcolorpicker",{"title":163,"path":164,"stem":165},"Container","\u002Fcomponents\u002Fcontainer","2.components\u002Fcontainer",{"title":167,"path":168,"stem":169},"Data Table","\u002Fcomponents\u002Fdata-table","2.components\u002Fdata-table",{"title":171,"path":172,"stem":173},"Datepicker","\u002Fcomponents\u002Fdatepicker","2.components\u002Fdatepicker",{"title":175,"path":176,"stem":177},"Divider","\u002Fcomponents\u002Fdivider","2.components\u002Fdivider",{"title":179,"path":180,"stem":181},"Email Field","\u002Fcomponents\u002Femail-field","2.components\u002Femail-field",{"title":183,"path":184,"stem":185},"Empty State","\u002Fcomponents\u002Fempty-state","2.components\u002Fempty-state",{"title":187,"path":188,"stem":189},"Entity Data Table","\u002Fcomponents\u002Fentity-data-table","2.components\u002Fentity-data-table",{"title":191,"path":192,"stem":193},"Entity Select","\u002Fcomponents\u002Fentity-select","2.components\u002Fentity-select",{"title":195,"path":196,"stem":197},"Floating UI","\u002Fcomponents\u002Ffloating-ui","2.components\u002Ffloating-ui",{"title":199,"path":200,"stem":201},"Help Text","\u002Fcomponents\u002Fhelp-text","2.components\u002Fhelp-text",{"title":203,"path":204,"stem":205},"Icon","\u002Fcomponents\u002Ficon","2.components\u002Ficon",{"title":207,"path":208,"stem":209},"Link","\u002Fcomponents\u002Flink","2.components\u002Flink",{"title":211,"path":212,"stem":213},"Loader","\u002Fcomponents\u002Floader","2.components\u002Floader",{"title":215,"path":216,"stem":217},"Modal","\u002Fcomponents\u002Fmodal","2.components\u002Fmodal",{"title":219,"path":220,"stem":221},"Number Field","\u002Fcomponents\u002Fnumber-field","2.components\u002Fnumber-field",{"title":223,"path":224,"stem":225},"Pagination","\u002Fcomponents\u002Fpagination","2.components\u002Fpagination",{"title":227,"path":228,"stem":229},"Password Field","\u002Fcomponents\u002Fpassword-field","2.components\u002Fpassword-field",{"title":231,"path":232,"stem":233},"Popover","\u002Fcomponents\u002Fpopover","2.components\u002Fpopover",{"title":235,"path":236,"stem":237},"Progress Bar","\u002Fcomponents\u002Fprogress-bar","2.components\u002Fprogress-bar",{"title":239,"path":240,"stem":241},"Promo Badge","\u002Fcomponents\u002Fpromo-badge","2.components\u002Fpromo-badge",{"title":243,"path":244,"stem":245},"Radio Group","\u002Fcomponents\u002Fradio-group","2.components\u002Fradio-group",{"title":247,"path":248,"stem":249},"Search","\u002Fcomponents\u002Fsearch","2.components\u002Fsearch",{"title":251,"path":252,"stem":253},"Select","\u002Fcomponents\u002Fselect","2.components\u002Fselect",{"title":255,"path":256,"stem":257},"Skeleton Bar","\u002Fcomponents\u002Fskeleton-bar","2.components\u002Fskeleton-bar",{"title":259,"path":260,"stem":261},"Slider","\u002Fcomponents\u002Fslider","2.components\u002Fslider",{"title":263,"path":264,"stem":265},"Snackbar","\u002Fcomponents\u002Fsnackbar","2.components\u002Fsnackbar",{"title":267,"path":268,"stem":269},"Status Dot","\u002Fcomponents\u002Fstatus-dot","2.components\u002Fstatus-dot",{"title":271,"path":272,"stem":273},"Switch","\u002Fcomponents\u002Fswitch","2.components\u002Fswitch",{"title":275,"path":276,"stem":277},"Tabs","\u002Fcomponents\u002Ftabs","2.components\u002Ftabs",{"title":279,"path":280,"stem":281},"Text","\u002Fcomponents\u002Ftext","2.components\u002Ftext",{"title":283,"path":284,"stem":285},"Text Editor","\u002Fcomponents\u002Ftext-editor","2.components\u002Ftext-editor",{"title":287,"path":288,"stem":289},"Text Field","\u002Fcomponents\u002Ftext-field","2.components\u002Ftext-field",{"title":291,"path":292,"stem":293},"Textarea","\u002Fcomponents\u002Ftextarea","2.components\u002Ftextarea",{"title":295,"path":296,"stem":297},"Theme Select","\u002Fcomponents\u002Ftheme-select","2.components\u002Ftheme-select",{"title":299,"path":300,"stem":301},"Toast","\u002Fcomponents\u002Ftoast","2.components\u002Ftoast",{"title":303,"path":304,"stem":305},"Tooltip","\u002Fcomponents\u002Ftooltip","2.components\u002Ftooltip",{"title":307,"path":308,"stem":309},"Unit Field","\u002Fcomponents\u002Funit-field","2.components\u002Funit-field",{"title":311,"path":312,"stem":313},"URL Field","\u002Fcomponents\u002Furl-field","2.components\u002Furl-field",{"title":315,"path":316,"stem":317,"children":318,"page":34},"Utilities","\u002Futilities","3.utilities",[319,331,360,368],{"title":53,"path":320,"stem":321,"children":322,"page":34},"\u002Futilities\u002Fcomponents","3.utilities\u002Fcomponents",[323,327],{"title":324,"path":325,"stem":326},"Inset","\u002Futilities\u002Fcomponents\u002Finset","3.utilities\u002Fcomponents\u002Finset",{"title":328,"path":329,"stem":330},"Theme Provider","\u002Futilities\u002Fcomponents\u002Ftheme-provider","3.utilities\u002Fcomponents\u002Ftheme-provider",{"title":332,"path":333,"stem":334,"children":335,"page":34},"Composables","\u002Futilities\u002Fcomposables","3.utilities\u002Fcomposables",[336,340,344,348,352,356],{"title":337,"path":338,"stem":339},"useFutureFlags","\u002Futilities\u002Fcomposables\u002Fuse-future-flags","3.utilities\u002Fcomposables\u002Fuse-future-flags",{"title":341,"path":342,"stem":343},"useMtApp","\u002Futilities\u002Fcomposables\u002Fuse-mt-app","3.utilities\u002Fcomposables\u002Fuse-mt-app",{"title":345,"path":346,"stem":347},"useMtAppRegions","\u002Futilities\u002Fcomposables\u002Fuse-mt-app-regions","3.utilities\u002Fcomposables\u002Fuse-mt-app-regions",{"title":349,"path":350,"stem":351},"useServicePermission","\u002Futilities\u002Fcomposables\u002Fuse-service-permission","3.utilities\u002Fcomposables\u002Fuse-service-permission",{"title":353,"path":354,"stem":355},"useSnackbar","\u002Futilities\u002Fcomposables\u002Fuse-snackbar","3.utilities\u002Fcomposables\u002Fuse-snackbar",{"title":357,"path":358,"stem":359},"useTheme","\u002Futilities\u002Fcomposables\u002Fuse-theme","3.utilities\u002Fcomposables\u002Fuse-theme",{"title":361,"path":362,"stem":363,"children":364,"page":34},"Directives","\u002Futilities\u002Fdirectives","3.utilities\u002Fdirectives",[365],{"title":303,"path":366,"stem":367},"\u002Futilities\u002Fdirectives\u002Ftooltip","3.utilities\u002Fdirectives\u002Ftooltip",{"title":369,"path":370,"stem":371,"children":372,"page":34},"Plugins","\u002Futilities\u002Fplugins","3.utilities\u002Fplugins",[373],{"title":374,"path":375,"stem":376},"Device helper","\u002Futilities\u002Fplugins\u002Fdevice-helper","3.utilities\u002Fplugins\u002Fdevice-helper",{"id":378,"title":27,"body":379,"description":389,"extension":390,"links":391,"meta":392,"navigation":393,"path":28,"seo":394,"stem":29,"__hash__":395},"docs\u002F1.documentation\u002F1.getting-started\u002F4.contributing.md",{"type":380,"value":381,"toc":385},"minimark",[382],[383,384],"contributing-guide",{},{"title":386,"searchDepth":387,"depth":387,"links":388},"",2,[],"How to contribute to Meteor, including local development, pull requests, changesets, and releases.","md",null,{},true,{"title":27,"description":389},"IBILHFv1c5FisggBF6y9d6Lghd3ZKZ5h3tCM7WwCo1g",[397,399],{"title":23,"path":24,"stem":25,"description":398,"children":-1},"Guidance for transitioning from older sw- components to Meteor, including a component mapping and gradual migration steps.",{"title":31,"path":32,"stem":33,"description":400,"children":-1},"Release notes for Meteor's documented packages, organized by package and listed newest first.",{"data":402,"body":403,"toc":1365},{"title":386,"description":386},{"type":404,"children":405},"root",[406,415,421,426,442,456,462,476,482,496,510,516,529,542,548,555,560,601,637,658,664,686,691,697,829,834,840,852,923,973,986,1012,1046,1052,1057,1075,1088,1093,1123,1128,1141,1146,1195,1200,1206,1211,1244,1258,1264,1269,1274,1279,1285,1359],{"type":407,"tag":408,"props":409,"children":411},"element","h2",{"id":410},"get-involved",[412],{"type":413,"value":414},"text","Get involved",{"type":407,"tag":416,"props":417,"children":418},"p",{},[419],{"type":413,"value":420},"Thank you for taking an interest in making Meteor a better project!",{"type":407,"tag":416,"props":422,"children":423},{},[424],{"type":413,"value":425},"To contribute code (features or bug fixes) open up a pull request.\nIn case you want to make a larger change to the code base, open up\nan issue first before writing any code. That way you don't lose your\nvaluable time in case we might reject the pull request.",{"type":407,"tag":416,"props":427,"children":428},{},[429,431,440],{"type":413,"value":430},"Shopware is available under ",{"type":407,"tag":432,"props":433,"children":437},"a",{"href":434,"rel":435},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Fblob\u002Fmain\u002FLICENSE.md",[436],"nofollow",[438],{"type":413,"value":439},"MIT license",{"type":413,"value":441},".\nContribute your code under MIT license.",{"type":407,"tag":416,"props":443,"children":444},{},[445,447,454],{"type":413,"value":446},"If you've never contributed to an open source project you might\nfind the ",{"type":407,"tag":432,"props":448,"children":451},{"href":449,"rel":450},"https:\u002F\u002Fopensource.guide\u002Fhow-to-contribute\u002F",[436],[452],{"type":413,"value":453},"this guide",{"type":413,"value":455}," helpful.",{"type":407,"tag":408,"props":457,"children":459},{"id":458},"code-of-conduct",[460],{"type":413,"value":461},"Code of conduct",{"type":407,"tag":416,"props":463,"children":464},{},[465,467,474],{"type":413,"value":466},"To understand which action we tolerate we expect you to read\nour ",{"type":407,"tag":432,"props":468,"children":471},{"href":469,"rel":470},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Fblob\u002Fmain\u002FCODE_OF_CONDUCT.md",[436],[472],{"type":413,"value":473},"code of conduct",{"type":413,"value":475},".",{"type":407,"tag":408,"props":477,"children":479},{"id":478},"bugs",[480],{"type":413,"value":481},"Bugs",{"type":407,"tag":416,"props":483,"children":484},{},[485,487,494],{"type":413,"value":486},"Please take a look at the ",{"type":407,"tag":432,"props":488,"children":491},{"href":489,"rel":490},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Fissues",[436],[492],{"type":413,"value":493},"existing issues",{"type":413,"value":495},"\nbefore creating a new one. That way we keep the number of duplicate issues low.\nComplete the issue template as much as possible when creating a new issue.",{"type":407,"tag":416,"props":497,"children":498},{},[499,501,508],{"type":413,"value":500},"To get your bug fixed faster, add a link to a\n",{"type":407,"tag":432,"props":502,"children":505},{"href":503,"rel":504},"https:\u002F\u002Fstackblitz.com\u002Fedit\u002Fmeteor?file=src%2FApp.vue",[436],[506],{"type":413,"value":507},"project with the bug",{"type":413,"value":509},"\nfor us to reproduce in the issue's description.",{"type":407,"tag":408,"props":511,"children":513},{"id":512},"feature-requests",[514],{"type":413,"value":515},"Feature requests",{"type":407,"tag":416,"props":517,"children":518},{},[519,521,527],{"type":413,"value":520},"Search through the ",{"type":407,"tag":432,"props":522,"children":524},{"href":489,"rel":523},[436],[525],{"type":413,"value":526},"list of existing feature requests",{"type":413,"value":528},",\nbefore you create an issue. If somebody already requested your feature you\ncan up-vote that issue. This helps us to see what the community wants the most.",{"type":407,"tag":416,"props":530,"children":531},{},[532,534,541],{"type":413,"value":533},"If there does not already exist a feature request for your idea,\nyou can ",{"type":407,"tag":432,"props":535,"children":538},{"href":536,"rel":537},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Fissues\u002Fnew?template=03-feature.yaml",[436],[539],{"type":413,"value":540},"request a feature",{"type":413,"value":475},{"type":407,"tag":408,"props":543,"children":545},{"id":544},"local-development",[546],{"type":413,"value":547},"Local development",{"type":407,"tag":549,"props":550,"children":552},"h3",{"id":551},"running-storybook-and-the-documentation",[553],{"type":413,"value":554},"Running Storybook and the documentation",{"type":407,"tag":416,"props":556,"children":557},{},[558],{"type":413,"value":559},"To work on the components themselves, start Storybook and the documentation site together from the repository root:",{"type":407,"tag":561,"props":562,"children":566},"pre",{"className":563,"code":564,"language":565,"meta":386,"style":386},"language-sh shiki shiki-themes github-light github-dark-default github-dark-default","pnpm install\npnpm dev\n","sh",[567],{"type":407,"tag":568,"props":569,"children":570},"code",{"__ignoreMap":386},[571,589],{"type":407,"tag":572,"props":573,"children":576},"span",{"class":574,"line":575},"line",1,[577,583],{"type":407,"tag":572,"props":578,"children":580},{"style":579},"--shiki-light:#6F42C1;--shiki-default:#FFA657;--shiki-dark:#FFA657",[581],{"type":413,"value":582},"pnpm",{"type":407,"tag":572,"props":584,"children":586},{"style":585},"--shiki-light:#032F62;--shiki-default:#A5D6FF;--shiki-dark:#A5D6FF",[587],{"type":413,"value":588}," install\n",{"type":407,"tag":572,"props":590,"children":591},{"class":574,"line":387},[592,596],{"type":407,"tag":572,"props":593,"children":594},{"style":579},[595],{"type":413,"value":582},{"type":407,"tag":572,"props":597,"children":598},{"style":585},[599],{"type":413,"value":600}," dev\n",{"type":407,"tag":416,"props":602,"children":603},{},[604,606,612,614,620,622,628,630,635],{"type":413,"value":605},"This runs Storybook on ",{"type":407,"tag":568,"props":607,"children":609},{"className":608},[],[610],{"type":413,"value":611},"http:\u002F\u002Flocalhost:6006",{"type":413,"value":613}," and the documentation on ",{"type":407,"tag":568,"props":615,"children":617},{"className":616},[],[618],{"type":413,"value":619},"http:\u002F\u002Flocalhost:3001",{"type":413,"value":621}," in parallel, each opening in your browser. While both run locally, the ",{"type":407,"tag":568,"props":623,"children":625},{"className":624},[],[626],{"type":413,"value":627},"Storybook",{"type":413,"value":629}," link on a component's documentation page and the ",{"type":407,"tag":568,"props":631,"children":633},{"className":632},[],[634],{"type":413,"value":5},{"type":413,"value":636}," link in Storybook point at these local instances instead of the deployed ones, so you can move between them while developing.",{"type":407,"tag":416,"props":638,"children":639},{},[640,642,648,650,656],{"type":413,"value":641},"To start just one of them, run ",{"type":407,"tag":568,"props":643,"children":645},{"className":644},[],[646],{"type":413,"value":647},"pnpm --filter @shopware-ag\u002Fmeteor-component-library dev",{"type":413,"value":649}," for Storybook or ",{"type":407,"tag":568,"props":651,"children":653},{"className":652},[],[654],{"type":413,"value":655},"pnpm --filter meteor-docs dev",{"type":413,"value":657}," for the documentation.",{"type":407,"tag":549,"props":659,"children":661},{"id":660},"testing-your-changes-in-another-project-with-yalc",[662],{"type":413,"value":663},"Testing your changes in another project with yalc",{"type":407,"tag":416,"props":665,"children":666},{},[667,669,675,677,684],{"type":413,"value":668},"For local development we use ",{"type":407,"tag":568,"props":670,"children":672},{"className":671},[],[673],{"type":413,"value":674},"yalc",{"type":413,"value":676}," to publish packages into a virtual store and consume them from other projects.\nYou can find yalc ",{"type":407,"tag":432,"props":678,"children":681},{"href":679,"rel":680},"https:\u002F\u002Fgithub.com\u002Fwclr\u002Fyalc",[436],[682],{"type":413,"value":683},"here",{"type":413,"value":685}," on GitHub.\nTo use your changes in Shopware and your extensions, you first build and publish the changed package, then add it to your project in a second step.",{"type":407,"tag":416,"props":687,"children":688},{},[689],{"type":413,"value":690},"The walkthrough below uses the component library. Swap the package name and paths if you work on a different package.",{"type":407,"tag":549,"props":692,"children":694},{"id":693},"publish-your-changes-to-the-local-yalc-store",[695],{"type":413,"value":696},"Publish your changes to the local yalc store",{"type":407,"tag":698,"props":699,"children":700},"ol",{},[701,707,755],{"type":407,"tag":702,"props":703,"children":704},"li",{},[705],{"type":413,"value":706},"Make your changes in the desired package(s).",{"type":407,"tag":702,"props":708,"children":709},{},[710,712,742,746,748,754],{"type":413,"value":711},"Build from the meteor root so the published files include your changes:",{"type":407,"tag":561,"props":713,"children":715},{"className":563,"code":714,"language":565,"meta":386,"style":386},"npx turbo run build\n",[716],{"type":407,"tag":568,"props":717,"children":718},{"__ignoreMap":386},[719],{"type":407,"tag":572,"props":720,"children":721},{"class":574,"line":575},[722,727,732,737],{"type":407,"tag":572,"props":723,"children":724},{"style":579},[725],{"type":413,"value":726},"npx",{"type":407,"tag":572,"props":728,"children":729},{"style":585},[730],{"type":413,"value":731}," turbo",{"type":407,"tag":572,"props":733,"children":734},{"style":585},[735],{"type":413,"value":736}," run",{"type":407,"tag":572,"props":738,"children":739},{"style":585},[740],{"type":413,"value":741}," build\n",{"type":407,"tag":743,"props":744,"children":745},"br",{},[],{"type":413,"value":747},"To rebuild only one package, scope the task: ",{"type":407,"tag":568,"props":749,"children":751},{"className":750},[],[752],{"type":413,"value":753},"npx turbo run build --filter=@shopware-ag\u002Fmeteor-component-library",{"type":413,"value":475},{"type":407,"tag":702,"props":756,"children":757},{},[758,760,766,768,816,819,821,827],{"type":413,"value":759},"Publish from the package root, here ",{"type":407,"tag":568,"props":761,"children":763},{"className":762},[],[764],{"type":413,"value":765},"packages\u002Fcomponent-library",{"type":413,"value":767},":",{"type":407,"tag":561,"props":769,"children":771},{"className":563,"code":770,"language":565,"meta":386,"style":386},"cd packages\u002Fcomponent-library\nyalc publish --private --workspace --pure\n",[772],{"type":407,"tag":568,"props":773,"children":774},{"__ignoreMap":386},[775,789],{"type":407,"tag":572,"props":776,"children":777},{"class":574,"line":575},[778,784],{"type":407,"tag":572,"props":779,"children":781},{"style":780},"--shiki-light:#005CC5;--shiki-default:#79C0FF;--shiki-dark:#79C0FF",[782],{"type":413,"value":783},"cd",{"type":407,"tag":572,"props":785,"children":786},{"style":585},[787],{"type":413,"value":788}," packages\u002Fcomponent-library\n",{"type":407,"tag":572,"props":790,"children":791},{"class":574,"line":387},[792,796,801,806,811],{"type":407,"tag":572,"props":793,"children":794},{"style":579},[795],{"type":413,"value":674},{"type":407,"tag":572,"props":797,"children":798},{"style":585},[799],{"type":413,"value":800}," publish",{"type":407,"tag":572,"props":802,"children":803},{"style":780},[804],{"type":413,"value":805}," --private",{"type":407,"tag":572,"props":807,"children":808},{"style":780},[809],{"type":413,"value":810}," --workspace",{"type":407,"tag":572,"props":812,"children":813},{"style":780},[814],{"type":413,"value":815}," --pure\n",{"type":407,"tag":743,"props":817,"children":818},{},[],{"type":413,"value":820},"This copies the built package into the local yalc store, with its ",{"type":407,"tag":568,"props":822,"children":824},{"className":823},[],[825],{"type":413,"value":826},"workspace:",{"type":413,"value":828}," dependencies resolved to concrete versions so they install outside the monorepo.",{"type":407,"tag":416,"props":830,"children":831},{},[832],{"type":413,"value":833},"Repeat the build and publish steps whenever you change the source again.",{"type":407,"tag":549,"props":835,"children":837},{"id":836},"add-your-updated-package-to-shopware-and-your-extensions",[838],{"type":413,"value":839},"Add your updated package to Shopware and your extensions",{"type":407,"tag":416,"props":841,"children":842},{},[843,845,851],{"type":413,"value":844},"Switch to the project that should consume your changes. For the Shopware administration this is ",{"type":407,"tag":568,"props":846,"children":848},{"className":847},[],[849],{"type":413,"value":850},"\u003Cshopware-root-folder>\u002Fsrc\u002FAdministration\u002FResources\u002Fapp\u002Fadministration",{"type":413,"value":767},{"type":407,"tag":561,"props":853,"children":855},{"className":563,"code":854,"language":565,"meta":386,"style":386},"cd \u003Cshopware-root-folder>\u002Fsrc\u002FAdministration\u002FResources\u002Fapp\u002Fadministration\nyalc add @shopware-ag\u002Fmeteor-component-library\nnpm install\n",[856],{"type":407,"tag":568,"props":857,"children":858},{"__ignoreMap":386},[859,893,910],{"type":407,"tag":572,"props":860,"children":861},{"class":574,"line":575},[862,866,872,877,883,888],{"type":407,"tag":572,"props":863,"children":864},{"style":780},[865],{"type":413,"value":783},{"type":407,"tag":572,"props":867,"children":869},{"style":868},"--shiki-light:#D73A49;--shiki-default:#FF7B72;--shiki-dark:#FF7B72",[870],{"type":413,"value":871}," \u003C",{"type":407,"tag":572,"props":873,"children":874},{"style":585},[875],{"type":413,"value":876},"shopware-root-folde",{"type":407,"tag":572,"props":878,"children":880},{"style":879},"--shiki-light:#24292E;--shiki-default:#E6EDF3;--shiki-dark:#E6EDF3",[881],{"type":413,"value":882},"r",{"type":407,"tag":572,"props":884,"children":885},{"style":868},[886],{"type":413,"value":887},">",{"type":407,"tag":572,"props":889,"children":890},{"style":585},[891],{"type":413,"value":892},"\u002Fsrc\u002FAdministration\u002FResources\u002Fapp\u002Fadministration\n",{"type":407,"tag":572,"props":894,"children":895},{"class":574,"line":387},[896,900,905],{"type":407,"tag":572,"props":897,"children":898},{"style":579},[899],{"type":413,"value":674},{"type":407,"tag":572,"props":901,"children":902},{"style":585},[903],{"type":413,"value":904}," add",{"type":407,"tag":572,"props":906,"children":907},{"style":585},[908],{"type":413,"value":909}," @shopware-ag\u002Fmeteor-component-library\n",{"type":407,"tag":572,"props":911,"children":913},{"class":574,"line":912},3,[914,919],{"type":407,"tag":572,"props":915,"children":916},{"style":579},[917],{"type":413,"value":918},"npm",{"type":407,"tag":572,"props":920,"children":921},{"style":585},[922],{"type":413,"value":588},{"type":407,"tag":416,"props":924,"children":925},{},[926,932,934,940,942,948,950,956,958,964,966,971],{"type":407,"tag":568,"props":927,"children":929},{"className":928},[],[930],{"type":413,"value":931},"yalc add",{"type":413,"value":933}," copies the published files into a local ",{"type":407,"tag":568,"props":935,"children":937},{"className":936},[],[938],{"type":413,"value":939},".yalc",{"type":413,"value":941}," folder and points the project's ",{"type":407,"tag":568,"props":943,"children":945},{"className":944},[],[946],{"type":413,"value":947},"package.json",{"type":413,"value":949}," at them; ",{"type":407,"tag":568,"props":951,"children":953},{"className":952},[],[954],{"type":413,"value":955},"npm install",{"type":413,"value":957}," then wires them into ",{"type":407,"tag":568,"props":959,"children":961},{"className":960},[],[962],{"type":413,"value":963},"node_modules",{"type":413,"value":965},".\nBe careful not to commit the ",{"type":407,"tag":568,"props":967,"children":969},{"className":968},[],[970],{"type":413,"value":947},{"type":413,"value":972}," changes.",{"type":407,"tag":416,"props":974,"children":975},{},[976,978,984],{"type":413,"value":977},"To pick up later changes, republish from the package and run ",{"type":407,"tag":568,"props":979,"children":981},{"className":980},[],[982],{"type":413,"value":983},"yalc update",{"type":413,"value":985}," in the consuming project.",{"type":407,"tag":416,"props":987,"children":988},{},[989,991,997,999,1004,1006,1011],{"type":413,"value":990},"Alternatively, run ",{"type":407,"tag":568,"props":992,"children":994},{"className":993},[],[995],{"type":413,"value":996},"yalc link @shopware-ag\u002Fmeteor-component-library",{"type":413,"value":998}," to symlink the files into ",{"type":407,"tag":568,"props":1000,"children":1002},{"className":1001},[],[1003],{"type":413,"value":963},{"type":413,"value":1005}," without touching ",{"type":407,"tag":568,"props":1007,"children":1009},{"className":1008},[],[1010],{"type":413,"value":947},{"type":413,"value":475},{"type":407,"tag":416,"props":1013,"children":1014},{},[1015,1021,1023,1029,1031,1037,1039,1044],{"type":407,"tag":1016,"props":1017,"children":1018},"strong",{},[1019],{"type":413,"value":1020},"Caution",{"type":413,"value":1022},": ",{"type":407,"tag":568,"props":1024,"children":1026},{"className":1025},[],[1027],{"type":413,"value":1028},"yalc link",{"type":413,"value":1030}," creates symlinks with absolute paths. If you run a containerized setup, it will fail to resolve (see: ",{"type":407,"tag":432,"props":1032,"children":1035},{"href":1033,"rel":1034},"https:\u002F\u002Fgithub.com\u002Fwclr\u002Fyalc\u002Fissues\u002F123",[436],[1036],{"type":413,"value":1033},{"type":413,"value":1038},").\nIn that case use ",{"type":407,"tag":568,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":413,"value":931},{"type":413,"value":1045}," as shown above.",{"type":407,"tag":408,"props":1047,"children":1049},{"id":1048},"creating-a-pull-request",[1050],{"type":413,"value":1051},"Creating a pull request",{"type":407,"tag":416,"props":1053,"children":1054},{},[1055],{"type":413,"value":1056},"The first step is to clone your repo. Then, install the dependencies with:",{"type":407,"tag":561,"props":1058,"children":1060},{"className":563,"code":1059,"language":565,"meta":386,"style":386},"pnpm install\n",[1061],{"type":407,"tag":568,"props":1062,"children":1063},{"__ignoreMap":386},[1064],{"type":407,"tag":572,"props":1065,"children":1066},{"class":574,"line":575},[1067,1071],{"type":407,"tag":572,"props":1068,"children":1069},{"style":579},[1070],{"type":413,"value":582},{"type":407,"tag":572,"props":1072,"children":1073},{"style":585},[1074],{"type":413,"value":588},{"type":407,"tag":416,"props":1076,"children":1077},{},[1078,1080,1086],{"type":413,"value":1079},"In case you have not installed pnpm execute ",{"type":407,"tag":568,"props":1081,"children":1083},{"className":1082},[],[1084],{"type":413,"value":1085},"npm install -g pnpm",{"type":413,"value":1087},".\nIf you want to install pnpm through another way take a look at their documentation.",{"type":407,"tag":416,"props":1089,"children":1090},{},[1091],{"type":413,"value":1092},"To execute scripts defined in the packages.json file of each package you have three options:",{"type":407,"tag":698,"props":1094,"children":1095},{},[1096,1107,1118],{"type":407,"tag":702,"props":1097,"children":1098},{},[1099,1101],{"type":413,"value":1100},"You use turbo: ",{"type":407,"tag":568,"props":1102,"children":1104},{"className":1103},[],[1105],{"type":413,"value":1106},"npx turbo run \u003CTASK_NAME>",{"type":407,"tag":702,"props":1108,"children":1109},{},[1110,1112],{"type":413,"value":1111},"You run the script from the root with ",{"type":407,"tag":568,"props":1113,"children":1115},{"className":1114},[],[1116],{"type":413,"value":1117},"pnpm --filter \u003CPACKAGE_NAME> run \u003CSCRIPT_NAME>",{"type":407,"tag":702,"props":1119,"children":1120},{},[1121],{"type":413,"value":1122},"You cd into the package directory and run the script",{"type":407,"tag":416,"props":1124,"children":1125},{},[1126],{"type":413,"value":1127},"You can find the available turbo tasks in the turbo.json file",{"type":407,"tag":416,"props":1129,"children":1130},{},[1131,1133,1140],{"type":413,"value":1132},"Don't know Turborepo? Check out their ",{"type":407,"tag":432,"props":1134,"children":1137},{"href":1135,"rel":1136},"https:\u002F\u002Fturbo.build\u002Frepo\u002Fdocs",[436],[1138],{"type":413,"value":1139},"documentation",{"type":413,"value":475},{"type":407,"tag":416,"props":1142,"children":1143},{},[1144],{"type":413,"value":1145},"Make sure to follow these steps before you push your branch:",{"type":407,"tag":698,"props":1147,"children":1148},{},[1149,1160,1171,1184],{"type":407,"tag":702,"props":1150,"children":1151},{},[1152,1154],{"type":413,"value":1153},"You linted your code with ",{"type":407,"tag":568,"props":1155,"children":1157},{"className":1156},[],[1158],{"type":413,"value":1159},"pnpm run lint:eslint",{"type":407,"tag":702,"props":1161,"children":1162},{},[1163,1165],{"type":413,"value":1164},"There are no type errors, run ",{"type":407,"tag":568,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":413,"value":1170},"pnpm run lint:types",{"type":407,"tag":702,"props":1172,"children":1173},{},[1174,1176,1182],{"type":413,"value":1175},"Run ",{"type":407,"tag":568,"props":1177,"children":1179},{"className":1178},[],[1180],{"type":413,"value":1181},"pnpm run test:unit",{"type":413,"value":1183}," to see if all tests pass",{"type":407,"tag":702,"props":1185,"children":1186},{},[1187,1189],{"type":413,"value":1188},"You generated a changeset with ",{"type":407,"tag":568,"props":1190,"children":1192},{"className":1191},[],[1193],{"type":413,"value":1194},"npx changeset",{"type":407,"tag":416,"props":1196,"children":1197},{},[1198],{"type":413,"value":1199},"After completing all the tests you can submit your pull request.",{"type":407,"tag":549,"props":1201,"children":1203},{"id":1202},"create-a-changelog",[1204],{"type":413,"value":1205},"Create a changelog",{"type":407,"tag":416,"props":1207,"children":1208},{},[1209],{"type":413,"value":1210},"We create and manage our changelogs with changesets. Follow these steps\nto create a changelog:",{"type":407,"tag":698,"props":1212,"children":1213},{},[1214,1224,1229,1234,1239],{"type":407,"tag":702,"props":1215,"children":1216},{},[1217,1218],{"type":413,"value":1175},{"type":407,"tag":568,"props":1219,"children":1221},{"className":1220},[],[1222],{"type":413,"value":1223},"npx changeset add",{"type":407,"tag":702,"props":1225,"children":1226},{},[1227],{"type":413,"value":1228},"Select the package you updated",{"type":407,"tag":702,"props":1230,"children":1231},{},[1232],{"type":413,"value":1233},"Define your version bump for this package",{"type":407,"tag":702,"props":1235,"children":1236},{},[1237],{"type":413,"value":1238},"Write a meaningful changelog message",{"type":407,"tag":702,"props":1240,"children":1241},{},[1242],{"type":413,"value":1243},"Repeat the step for other packages you want to change",{"type":407,"tag":416,"props":1245,"children":1246},{},[1247,1249,1256],{"type":413,"value":1248},"Feel free to check out the ",{"type":407,"tag":432,"props":1250,"children":1253},{"href":1251,"rel":1252},"https:\u002F\u002Fgithub.com\u002Fchangesets\u002Fchangesets?tab=readme-ov-file#documentation",[436],[1254],{"type":413,"value":1255},"changesets documentation",{"type":413,"value":1257},"\nfor more information on how to work with it.",{"type":407,"tag":408,"props":1259,"children":1261},{"id":1260},"managing-releases",[1262],{"type":413,"value":1263},"Managing releases",{"type":407,"tag":416,"props":1265,"children":1266},{},[1267],{"type":413,"value":1268},"When your pull request gets merged a GitHub Action looks at your changes. If it finds a changeset in there it will copy that changeset over to a release branch.",{"type":407,"tag":416,"props":1270,"children":1271},{},[1272],{"type":413,"value":1273},"If you decide to release a new version, merge the release branch. Changesets will now take over. It updates the changelog files, bumps up the version numbers and it publishes the packages to npm.",{"type":407,"tag":416,"props":1275,"children":1276},{},[1277],{"type":413,"value":1278},"That's it there is nothing more you have to do.",{"type":407,"tag":408,"props":1280,"children":1282},{"id":1281},"updating-the-visual-tests",[1283],{"type":413,"value":1284},"Updating the visual tests",{"type":407,"tag":698,"props":1286,"children":1287},{},[1288,1293,1305,1319,1332,1337,1349,1354],{"type":407,"tag":702,"props":1289,"children":1290},{},[1291],{"type":413,"value":1292},"Copy the name of your branch",{"type":407,"tag":702,"props":1294,"children":1295},{},[1296,1298],{"type":413,"value":1297},"Go to the ",{"type":407,"tag":432,"props":1299,"children":1302},{"href":1300,"rel":1301},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Factions",[436],[1303],{"type":413,"value":1304},"actions tab",{"type":407,"tag":702,"props":1306,"children":1307},{},[1308,1310,1317],{"type":413,"value":1309},"Click on ",{"type":407,"tag":432,"props":1311,"children":1314},{"href":1312,"rel":1313},"https:\u002F\u002Fgithub.com\u002Fshopware\u002Fmeteor\u002Factions\u002Fworkflows\u002Fvisual-tests.yml",[436],[1315],{"type":413,"value":1316},"Visual tests",{"type":413,"value":1318}," in the left sidebar",{"type":407,"tag":702,"props":1320,"children":1321},{},[1322,1324,1330],{"type":413,"value":1323},"You then see a blue bar with a button that says ",{"type":407,"tag":568,"props":1325,"children":1327},{"className":1326},[],[1328],{"type":413,"value":1329},"Run workflow",{"type":413,"value":1331},", click on that",{"type":407,"tag":702,"props":1333,"children":1334},{},[1335],{"type":413,"value":1336},"Select your branch from the dropdown menu",{"type":407,"tag":702,"props":1338,"children":1339},{},[1340,1342,1347],{"type":413,"value":1341},"Click on the ",{"type":407,"tag":568,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":413,"value":1329},{"type":413,"value":1348}," button",{"type":407,"tag":702,"props":1350,"children":1351},{},[1352],{"type":413,"value":1353},"Wait...",{"type":407,"tag":702,"props":1355,"children":1356},{},[1357],{"type":413,"value":1358},"Go back to your branch overview",{"type":407,"tag":1360,"props":1361,"children":1362},"style",{},[1363],{"type":413,"value":1364},"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);}",{"title":386,"searchDepth":387,"depth":387,"links":1366},[1367,1368,1369,1370,1371,1377,1380,1381],{"id":410,"depth":387,"text":414},{"id":458,"depth":387,"text":461},{"id":478,"depth":387,"text":481},{"id":512,"depth":387,"text":515},{"id":544,"depth":387,"text":547,"children":1372},[1373,1374,1375,1376],{"id":551,"depth":912,"text":554},{"id":660,"depth":912,"text":663},{"id":693,"depth":912,"text":696},{"id":836,"depth":912,"text":839},{"id":1048,"depth":387,"text":1051,"children":1378},[1379],{"id":1202,"depth":912,"text":1205},{"id":1260,"depth":387,"text":1263},{"id":1281,"depth":387,"text":1284},1790241997292]