First determine what you are doing
- When you need to first locate in the current project the
@veltra/vite、@veltra/desktop, installation artifact, or workspace source code, read references/source-discovery.md - When you need to add or fix the
vite.config.tsresolver configuration, confirm dependencies, and the minimal integration method, read references/integration.md - When you need to troubleshoot components not being auto-imported, styles not coming in, inconsistent dev/build behavior, or abnormal child component style mapping, read references/troubleshooting.md
- When you need to confirm the resolver's exact contract,
importStyleoptions, and the co-directory style mapping table, read references/resolver-contract.md
Keep these constraints during execution
- Treat
@veltra/viteas a consumer-side integration package; do not assume the current environment necessarily has this repository'spackages/vite VeltraDesktopUIResolver()is only responsible for@veltra/desktopcomponent auto-import; it is not responsible for installing dependencies, nor for handling non-Uprefixed components- Style side effects are enabled by default; they are only disabled when
importStyle: falseis explicitly passed - Style side effect paths are fixed to point to
@veltra/desktop/components/<dir>/style; do not hand-writesrcordistpaths in the consuming project - Style resolution in dev and build depends on
@veltra/desktopconditional exports; when troubleshooting, first check the consumed package'sexports, and do not suspect the resolver itself first
When handling cross-package issues, also check these skills
- Component implementation,
style.tsentry and component directory conventions:veltra-desktop - Sass infrastructure,
pkg:@veltra/styles/...and theme runtime:veltra-styles
Quick source anchors
node_modules/@veltra/vite/package.jsonnode_modules/@veltra/vite/src/resolver.tsnode_modules/@veltra/vite/dist/index.mjsnode_modules/@veltra/vite/dist/index.d.mtsnode_modules/@veltra/desktop/package.json