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