{"_id":"@alt-gnome/vitepress-plugin-contributors","name":"@alt-gnome/vitepress-plugin-contributors","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@alt-gnome/vitepress-plugin-contributors","type":"module","version":"1.0.0","description":"VitePress plugin for displaying contributors and teams with GitHub, Forgejo and Git integration","keywords":["vitepress","vitepress-plugin","contributors","github","forgejo","git","teams","collaborators","documentation","vue","static-site","alt-gnome","altlinux"],"homepage":"https://altlinux.space/alt-gnome/integrations/src/branch/main/packages/vitepress-plugin-contributors","repository":{"type":"git","url":"https://altlinux.space/alt-gnome/integrations.git","directory":"packages/vitepress-plugin-contributors"},"bugs":{"url":"https://altlinux.space/alt-gnome/integrations/issues"},"license":"MIT","author":{"name":"ALT Gnome Team","url":"https://altlinux.space/alt-gnome"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs"},"./client":{"types":"./dist/client/index.d.ts","import":"./dist/client/index.mjs"},"./style":"./dist/client/style.css","./ContributorsList":{"types":"./dist/client/components/ContributorsList.d.ts","import":"./dist/client/components/ContributorsList.vue"},"./AGWTeams":{"types":"./dist/client/components/AGWTeams.d.ts","import":"./dist/client/components/AGWTeams.vue"},"./AGWTeam":{"types":"./dist/client/components/AGWTeam.d.ts","import":"./dist/client/components/AGWTeam.vue"},"./AGWHomeTeams":{"types":"./dist/client/components/AGWHomeTeams.d.ts","import":"./dist/client/components/AGWHomeTeams.vue"}},"main":"./dist/index.mjs","module":"./dist/index.mjs","types":"./dist/index.d.ts","peerDependencies":{"vitepress":"^1.0.0","vue":"^3.3.0"},"devDependencies":{"@types/node":"^24.10.0","@vitejs/plugin-vue":"^6.0.1","@vue/runtime-core":"^3.5.22","ora":"^9.0.0","vue":"3.5.14","yaml":"^2.8.1"},"engines":{"node":">=18.0.0"},"scripts":{"build":"vite build && tsc --project tsconfig.build.json","dev":"vite build --watch"},"_id":"@alt-gnome/vitepress-plugin-contributors@1.0.0","_integrity":"sha512-qQqPfDsZpijFzCf6vVKHR8uWg5GcE3e+WUU6Ns+qEv2EgOQQkVg7YI4Z1haM4D/JulZ620di/cZqoQ3ZxWaCXw==","_resolved":"/tmp/.private/ampernic/f03326c44670576fbdf84a0926ad6f1d/alt-gnome-vitepress-plugin-contributors-1.0.0.tgz","_from":"file:alt-gnome-vitepress-plugin-contributors-1.0.0.tgz","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-qQqPfDsZpijFzCf6vVKHR8uWg5GcE3e+WUU6Ns+qEv2EgOQQkVg7YI4Z1haM4D/JulZ620di/cZqoQ3ZxWaCXw==","shasum":"673cca0350657d1cfaa77b73666f6bea968d49e5","tarball":"https://registry.npmjs.org/@alt-gnome/vitepress-plugin-contributors/-/vitepress-plugin-contributors-1.0.0.tgz","fileCount":38,"unpackedSize":99858,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDXGNIg3ueLEONt3RqWCnADNhJGa4nFgJjS5oGGEKRL0gIgI9SvdlipTqgPUf96uUgtmDMetnsPNBNehSd9waLzs4Q="}]},"_npmUser":{"name":"ampernic","email":"ampernic@inbox.ru"},"directories":{},"maintainers":[{"name":"ampernic","email":"ampernic@inbox.ru"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vitepress-plugin-contributors_1.0.0_1762303412701_0.07576780300224484"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-05T00:43:32.624Z","1.0.0":"2025-11-05T00:43:32.928Z","modified":"2025-11-05T00:43:33.230Z"},"maintainers":[{"name":"ampernic","email":"ampernic@inbox.ru"}],"description":"VitePress plugin for displaying contributors and teams with GitHub, Forgejo and Git integration","homepage":"https://altlinux.space/alt-gnome/integrations/src/branch/main/packages/vitepress-plugin-contributors","keywords":["vitepress","vitepress-plugin","contributors","github","forgejo","git","teams","collaborators","documentation","vue","static-site","alt-gnome","altlinux"],"repository":{"type":"git","url":"https://altlinux.space/alt-gnome/integrations.git","directory":"packages/vitepress-plugin-contributors"},"author":{"name":"ALT Gnome Team","url":"https://altlinux.space/alt-gnome"},"bugs":{"url":"https://altlinux.space/alt-gnome/integrations/issues"},"license":"MIT","readme":"# VitePress Contributors Plugin\n\nПлагин для отображения контрибьюторов и команд в VitePress проектах с поддержкой\nGitHub, Forgejo и локального Git.\n\n## Установка\n\n```bash\nnpm install vitepress-plugin-contributors\n```\n\n## Настройка\n\n### 1. Конфигурация VitePress\n\n```typescript\n// .vitepress/config.ts\nimport { defineConfig } from \"vitepress\";\nimport { contributorsPlugin } from \"vitepress-plugin-contributors\";\n\nexport default defineConfig({\n  vite: {\n    plugins: [\n      contributorsPlugin({\n        // GitHub настройки (опционально)\n        github: {\n          token: \"your_github_token\",\n          repoOwner: \"your-org\",\n          repoName: \"your-repo\",\n        },\n        // Forgejo настройки (опционально)\n        forgejo: {\n          token: \"your_forgejo_token\",\n          baseUrl: \"https://your-forgejo-instance.com\",\n          repoOwner: \"your-org\",\n          repoName: \"your-repo\",\n        },\n        // Файл маппинга пользователей\n        map: \"./contributors-map.yaml\",\n        // Режим работы: 'fast' | 'ultra-fast' | 'full'\n        mode: \"fast\",\n      }),\n    ],\n  },\n});\n```\n\n### 2. Файл маппинга пользователей\n\nСоздайте `.vitepress/data/teams.data.yaml`:\n\n```yaml\n- avatar: https://avatars.githubusercontent.com/u/12345?v=4\n  name:\n    ru: Иван Иванов\n    en: Ivan Ivanov\n  title: ivanov\n  collaborator:\n    - knowledge\n    - maintainer\n  links:\n    - icon: github\n      link: https://github.com/ivanov\n    - icon: altlinux-space\n      link: https://altlinux.space/ivanov\n  sponsor: https://sponsor.link\n  mapByNameAliases:\n    - Ivan Ivanov\n    - Иван Иванов\n  mapByEmailAliases:\n    - ivan@example.com\n  mapByLoginAliases:\n    - ivanov-github\n```\n\n## Компоненты\n\n- `ContributorsList` - полный список контрибьюторов со статистикой\n- `AGWTeams` - отображение команд с фильтрацией\n- `AGWTeam` - страница команды\n- `AGWHomeTeams` - команды для главной страницы\n\n## Режимы работы\n\n### Полный режим (с токенами)\n\n- Сбор данных из GitHub API\n- Сбор данных из Forgejo API\n- Анализ локального Git репозитория\n- Объединение и дедупликация данных\n\n### Fallback режим (без токенов)\n\n- Используется только файл маппинга\n- Идеально для демо и тестирования\n\n## Поля маппинга\n\n- `avatar` - URL аватара\n- `name` - локализованное имя\n- `title` - уникальный идентификатор\n- `collaborator` - роли: `knowledge`, `maintainer`\n- `links` - ссылки на профили\n- `sponsor` - ссылка для спонсорства\n- `mapBy*Aliases` - алиасы для сопоставления\n\n## Типы источников\n\n- `github` - данные из GitHub API\n- `forgejo` - данные из Forgejo API\n- `git` - данные из локального Git\n- `git+api` - объединенные данные Git + API\n","readmeFilename":"README.md","_rev":"1-7c95696e235221c7ff0d2a681647b896"}