@webywz/breathing-github-profile 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 webywz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,281 @@
-# Temporary Holding Version
+# breathing-github-profile
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**A living GitHub profile README — declarative config, marker-safe refresh, CLI + library.**  
+**会呼吸的 GitHub 主页 README：声明式配置、标记保护区刷新，CLI 与库双入口。**
+
+[![npm](https://img.shields.io/npm/v/@webywz/breathing-github-profile.svg)](https://www.npmjs.com/package/@webywz/breathing-github-profile)
+[![Test](https://github.com/webywz/breathing-github-profile/actions/workflows/test.yml/badge.svg)](https://github.com/webywz/breathing-github-profile/actions/workflows/test.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+Package: `@webywz/breathing-github-profile` · CLI binary: `breathing-profile` · Node 18+
+
+> Not on the npm registry yet. Install from GitHub until the first publish.  
+> 尚未发布到 npm，请先从 GitHub 安装。
+
+---
+
+## Features · 特性
+
+| | EN | 中文 |
+| --- | --- | --- |
+| Config | YAML / JSON define intro, sections, and style | YAML / JSON 声明介绍、章节与样式 |
+| Refresh | Updates only `<!--MARKER:START-->…<!--MARKER:END-->` | 只改标记区，手写文案保留 |
+| Stats | Stars, forks, repos, followers; language mix; featured repos | 统计、语言分布、精选仓库 |
+| Sections | `stats` · `languages` · `repos` · `custom` | 四种章节类型 |
+| Automation | Daily GitHub Actions workflow | Actions 每日定时刷新 |
+| API | CLI commands + TypeScript library exports | CLI + 库 |
+
+Live example: [webywz/webywz](https://github.com/webywz/webywz).
+
+---
+
+## Install · 安装
+
+```bash
+npm install github:webywz/breathing-github-profile
+npx breathing-profile --help
+```
+
+From source (develop / unpublished):
+
+```bash
+git clone https://github.com/webywz/breathing-github-profile.git
+cd breathing-github-profile
+npm install
+npm run build
+```
+
+One-shot without a local clone:
+
+```bash
+npx --yes --package github:webywz/breathing-github-profile -- breathing-profile generate -c config.yml -o README.md
+```
+
+After the package is published:
+
+```bash
+npm i -g @webywz/breathing-github-profile
+npx @webywz/breathing-github-profile --help
+```
+
+---
+
+## Quick start · 快速开始
+
+### 1. Config · 配置
+
+Create `config.yml`:
+
+```yaml
+username: your-github-username
+
+intro:
+  zh: |
+    Full-stack developer · open source
+    Happy to connect.
+  en: |
+    Full-stack developer · open source
+    Let's connect.
+
+featuredRepos:
+  - your-best-repo
+
+sections:
+  - type: stats
+    marker: STATS
+    title: GitHub Stats · 统计
+
+  - type: languages
+    marker: LANGUAGES
+    title: Languages · 常用语言
+
+  - type: repos
+    marker: REPOS
+    title: Featured · 精选项目
+```
+
+Full sample: [examples/webywz.yml](examples/webywz.yml).
+
+### 2. Generate · 生成
+
+```bash
+npx breathing-profile generate -c config.yml -o README.md
+npx breathing-profile refresh  -c config.yml -r README.md
+npx breathing-profile validate -c config.yml
+```
+
+| Command | EN | 中文 |
+| --- | --- | --- |
+| `generate` | Write a full README from config + GitHub data | 按配置与 GitHub 数据生成完整 README |
+| `refresh` | Rewrite marker sections only | 只刷新标记区 |
+| `validate` | Check the config file | 校验配置 |
+
+Optional: set `GITHUB_TOKEN` (or use `secrets.GITHUB_TOKEN` in Actions) for higher API rate limits.
+
+---
+
+## Configuration · 配置说明
+
+### Top-level · 顶层字段
+
+| Field | Type | Required | Notes |
+| --- | --- | --- | --- |
+| `username` | string | yes | GitHub login |
+| `intro.zh` / `intro.en` | string | one of zh/en | Bilingual intro blocks |
+| `featuredRepos` | string[] | no | Pinned repo names |
+| `sections` | Section[] | no | Ordered sections |
+| `style` | StyleConfig | no | Theme / layout knobs |
+
+### Section types · 章节类型
+
+**`stats`** — totals (stars, forks, public repos, followers, following).
+
+```yaml
+- type: stats
+  marker: STATS
+  title: GitHub Stats · 统计
+```
+
+**`languages`** — top languages by share.
+
+```yaml
+- type: languages
+  marker: LANGUAGES
+  title: Languages · 常用语言
+```
+
+**`repos`** — featured list, or highest-star repos when `featuredRepos` is empty.
+
+```yaml
+- type: repos
+  marker: REPOS
+  title: Featured · 精选项目
+```
+
+**`custom`** — raw Markdown inside a marker.
+
+```yaml
+- type: custom
+  marker: TECH_STACK
+  title: Stack · 技术栈
+  content: |
+    TypeScript · NestJS · FastAPI · Vue
+```
+
+Markers must match exactly:
+
+```markdown
+<!--STATS:START-->
+…
+<!--STATS:END-->
+```
+
+---
+
+## Automation · 自动刷新
+
+In your profile repo (`USER/USER`):
+
+1. Add `config.yml`
+2. Add `.github/workflows/refresh-profile.yml`:
+
+```yaml
+name: Refresh profile README
+
+on:
+  schedule:
+    - cron: '0 0 * * *'   # daily 00:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  refresh:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm install github:webywz/breathing-github-profile
+      - name: Refresh README
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx breathing-profile refresh
+      - name: Commit if changed
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add README.md data/profile.json
+          git diff --quiet || git commit -m "chore: refresh profile README"
+          git push
+```
+
+Flow: cron → GitHub API → rewrite markers → commit only when content changed. Copy outside markers is never touched.
+
+流程：定时触发 → 拉 GitHub 数据 → 只改标记区 → 有变更才提交。标记外的手写内容不会被动。
+
+---
+
+## Library · 作为库使用
+
+```ts
+import {
+  loadConfig,
+  GitHubClient,
+  ReadmeGenerator,
+} from '@webywz/breathing-github-profile';
+
+const config = loadConfig('config.yml');
+const client = new GitHubClient(process.env.GITHUB_TOKEN);
+const data = await client.getProfileData(config.username);
+const readme = new ReadmeGenerator(config, data).generate();
+```
+
+Also exported: `validateConfig`, `getDefaultConfig`, `updateReadmeMarkers`.
+
+---
+
+## Develop · 开发
+
+```bash
+git clone https://github.com/webywz/breathing-github-profile.git
+cd breathing-github-profile
+npm install
+npm run build
+npm test
+npm run lint
+
+npm run generate -- -c examples/webywz.yml -o examples/README.md
+npm run refresh  -- -c examples/webywz.yml -r examples/README.md
+```
+
+```
+src/
+  types.ts       types
+  config.ts      load / validate
+  github.ts      GitHub client
+  generator.ts   README generate + marker update
+  cli.ts         CLI
+  index.ts       library entry
+examples/        sample configs
+```
+
+---
+
+## FAQ · 常见问题
+
+**Rate limits?** Set `GITHUB_TOKEN`. Actions already injects `secrets.GITHUB_TOKEN`.
+
+**Only update part of the README?** Use `refresh`, not `generate`.
+
+**Markers not updating?** Names must match `marker` in config; use `<!--NAME:START-->` / `<!--NAME:END-->`.
+
+---
+
+## Links · 链接
+
+- Demo profile: [webywz/webywz](https://github.com/webywz/webywz)
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- License: [MIT](LICENSE) © webywz

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("./config");
+const github_1 = require("./github");
+const generator_1 = require("./generator");
+const program = new commander_1.Command();
+program
+    .name('breathing-profile')
+    .description('可复用的活跃 GitHub profile README 生成器')
+    .version('1.0.0');
+program
+    .command('generate')
+    .description('生成新的 README.md')
+    .option('-c, --config <path>', '配置文件路径', 'config.yml')
+    .option('-o, --output <path>', '输出文件路径', 'README.md')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('正在生成 README...').start();
+    try {
+        if (!(0, fs_1.existsSync)(options.config)) {
+            throw new Error(`配置文件不存在: ${options.config}`);
+        }
+        const config = (0, config_1.loadConfig)(options.config);
+        const client = new github_1.GitHubClient();
+        spinner.text = `正在获取 ${config.username} 的 GitHub 数据...`;
+        const data = await client.getProfileData(config.username);
+        spinner.text = '正在生成 README 内容...';
+        const generator = new generator_1.ReadmeGenerator(config, data);
+        const readme = generator.generate();
+        (0, fs_1.writeFileSync)(options.output, readme, 'utf-8');
+        const dataDir = 'data';
+        if (!(0, fs_1.existsSync)(dataDir)) {
+            (0, fs_1.mkdirSync)(dataDir, { recursive: true });
+        }
+        (0, fs_1.writeFileSync)((0, path_1.join)(dataDir, 'profile.json'), JSON.stringify(data, null, 2), 'utf-8');
+        spinner.succeed(chalk_1.default.green(`✓ README 已生成: ${options.output}`));
+        console.log(chalk_1.default.gray(`  数据已保存到: ${(0, path_1.join)(dataDir, 'profile.json')}`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('生成失败'));
+        console.error(chalk_1.default.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command('refresh')
+    .description('刷新现有 README 的标记部分')
+    .option('-c, --config <path>', '配置文件路径', 'config.yml')
+    .option('-r, --readme <path>', 'README 文件路径', 'README.md')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('正在刷新 README...').start();
+    try {
+        if (!(0, fs_1.existsSync)(options.config)) {
+            throw new Error(`配置文件不存在: ${options.config}`);
+        }
+        if (!(0, fs_1.existsSync)(options.readme)) {
+            throw new Error(`README 文件不存在: ${options.readme}`);
+        }
+        const config = (0, config_1.loadConfig)(options.config);
+        const client = new github_1.GitHubClient();
+        spinner.text = `正在获取 ${config.username} 的 GitHub 数据...`;
+        const data = await client.getProfileData(config.username);
+        spinner.text = '正在更新 README 标记部分...';
+        const existingReadme = (0, fs_1.readFileSync)(options.readme, 'utf-8');
+        const markerSections = (config.sections || []).map(section => {
+            const marker = section.marker || section.type.toUpperCase();
+            let content = '';
+            const tempGenerator = new generator_1.ReadmeGenerator(config, data);
+            const fullReadme = tempGenerator.generate();
+            const startMarker = `<!--${marker}:START-->`;
+            const endMarker = `<!--${marker}:END-->`;
+            const regex = new RegExp(`${escapeRegex(startMarker)}([\\s\\S]*?)${escapeRegex(endMarker)}`);
+            const match = fullReadme.match(regex);
+            if (match) {
+                content = match[1].trim();
+            }
+            return { marker, content };
+        });
+        const updatedReadme = (0, generator_1.updateReadmeMarkers)(existingReadme, markerSections);
+        (0, fs_1.writeFileSync)(options.readme, updatedReadme, 'utf-8');
+        const dataDir = 'data';
+        if (!(0, fs_1.existsSync)(dataDir)) {
+            (0, fs_1.mkdirSync)(dataDir, { recursive: true });
+        }
+        (0, fs_1.writeFileSync)((0, path_1.join)(dataDir, 'profile.json'), JSON.stringify(data, null, 2), 'utf-8');
+        spinner.succeed(chalk_1.default.green(`✓ README 已刷新: ${options.readme}`));
+        console.log(chalk_1.default.gray(`  数据已保存到: ${(0, path_1.join)(dataDir, 'profile.json')}`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('刷新失败'));
+        console.error(chalk_1.default.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command('validate')
+    .description('验证配置文件')
+    .option('-c, --config <path>', '配置文件路径', 'config.yml')
+    .action(async (options) => {
+    try {
+        if (!(0, fs_1.existsSync)(options.config)) {
+            throw new Error(`配置文件不存在: ${options.config}`);
+        }
+        const config = (0, config_1.loadConfig)(options.config);
+        console.log(chalk_1.default.green('✓ 配置文件有效'));
+        console.log(chalk_1.default.gray('\n配置内容:'));
+        console.log(JSON.stringify(config, null, 2));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`✗ 配置文件无效: ${error.message}`));
+        process.exit(1);
+    }
+});
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import { ProfileConfig } from './types';
+export declare function loadConfig(configPath: string): ProfileConfig;
+export declare function validateConfig(config: ProfileConfig): void;
+export declare function getDefaultConfig(): Partial<ProfileConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAc5D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA+B1D;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAazD"}

package/dist/config.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.validateConfig = validateConfig;
+exports.getDefaultConfig = getDefaultConfig;
+const fs_1 = require("fs");
+const yaml_1 = require("yaml");
+function loadConfig(configPath) {
+    const content = (0, fs_1.readFileSync)(configPath, 'utf-8');
+    let config;
+    if (configPath.endsWith('.json')) {
+        config = JSON.parse(content);
+    }
+    else if (configPath.endsWith('.yml') || configPath.endsWith('.yaml')) {
+        config = (0, yaml_1.parse)(content);
+    }
+    else {
+        throw new Error('配置文件必须是 .json, .yml 或 .yaml 格式');
+    }
+    validateConfig(config);
+    return config;
+}
+function validateConfig(config) {
+    if (!config.username || typeof config.username !== 'string') {
+        throw new Error('配置中必须包含有效的 username 字段');
+    }
+    if (!config.intro || typeof config.intro !== 'object') {
+        throw new Error('配置中必须包含 intro 对象');
+    }
+    if (!config.intro.zh && !config.intro.en) {
+        throw new Error('intro 必须至少包含 zh 或 en 字段');
+    }
+    if (config.featuredRepos && !Array.isArray(config.featuredRepos)) {
+        throw new Error('featuredRepos 必须是数组');
+    }
+    if (config.sections && !Array.isArray(config.sections)) {
+        throw new Error('sections 必须是数组');
+    }
+    if (config.sections) {
+        for (const section of config.sections) {
+            if (!['stats', 'languages', 'repos', 'custom'].includes(section.type)) {
+                throw new Error(`不支持的 section 类型: ${section.type}`);
+            }
+            if (section.type === 'custom' && !section.content) {
+                throw new Error('custom 类型的 section 必须包含 content 字段');
+            }
+        }
+    }
+}
+function getDefaultConfig() {
+    return {
+        sections: [
+            { type: 'stats', marker: 'STATS' },
+            { type: 'languages', marker: 'LANGUAGES' },
+            { type: 'repos', marker: 'REPOS' }
+        ],
+        style: {
+            theme: 'auto',
+            icons: true,
+            badges: true
+        }
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAIA,gCAcC;AAED,wCA+BC;AAED,4CAaC;AAlED,2BAAkC;AAClC,+BAA0C;AAG1C,SAAgB,UAAU,CAAC,UAAkB;IAC3C,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAElD,IAAI,MAAqB,CAAC;IAC1B,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,IAAA,YAAS,EAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,cAAc,CAAC,MAAqB;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE;YAC1C,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;SACnC;QACD,KAAK,EAAE;YACL,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;SACb;KACF,CAAC;AACJ,CAAC"}

package/dist/generator.d.ts

@@ -0,0 +1,16 @@
+import { ProfileConfig, ProfileData, MarkerSection } from './types';
+export declare class ReadmeGenerator {
+    private config;
+    private data;
+    constructor(config: ProfileConfig, data: ProfileData);
+    generate(): string;
+    private generateHeader;
+    private generateIntro;
+    private generateSection;
+    private generateStats;
+    private generateLanguages;
+    private generateRepos;
+    private generateFooter;
+}
+export declare function updateReadmeMarkers(existingReadme: string, markerSections: MarkerSection[]): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,qBAAa,eAAe;IAExB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;gBADJ,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW;IAG3B,QAAQ,IAAI,MAAM;IAiBlB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,cAAc;CAcvB;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,aAAa,EAAE,GAC9B,MAAM,CAsBR"}

package/dist/generator.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadmeGenerator = void 0;
+exports.updateReadmeMarkers = updateReadmeMarkers;
+class ReadmeGenerator {
+    constructor(config, data) {
+        this.config = config;
+        this.data = data;
+    }
+    generate() {
+        const sections = [];
+        sections.push(this.generateHeader());
+        sections.push(this.generateIntro());
+        if (this.config.sections) {
+            for (const section of this.config.sections) {
+                sections.push(this.generateSection(section));
+            }
+        }
+        sections.push(this.generateFooter());
+        return sections.filter(s => s.trim()).join('\n\n');
+    }
+    generateHeader() {
+        const { user } = this.data;
+        return `# Hi there, I'm ${user.name || user.login} 👋
+
+<div align="center">
+  <img src="${user.avatar_url}" width="150" height="150" alt="${user.login}" style="border-radius: 50%;" />
+</div>`;
+    }
+    generateIntro() {
+        const { intro } = this.config;
+        const parts = [];
+        if (intro.zh) {
+            parts.push(`## 👨‍💻 关于我
+
+${intro.zh}`);
+        }
+        if (intro.en) {
+            parts.push(`## 👨‍💻 About Me
+
+${intro.en}`);
+        }
+        return parts.join('\n\n');
+    }
+    generateSection(section) {
+        const marker = section.marker || section.type.toUpperCase();
+        let content = '';
+        switch (section.type) {
+            case 'stats':
+                content = this.generateStats();
+                break;
+            case 'languages':
+                content = this.generateLanguages();
+                break;
+            case 'repos':
+                content = this.generateRepos();
+                break;
+            case 'custom':
+                content = section.content || '';
+                break;
+        }
+        if (!content)
+            return '';
+        return `<!--${marker}:START-->
+${section.title ? `## ${section.title}\n\n` : ''}${content}
+<!--${marker}:END-->`;
+    }
+    generateStats() {
+        const { user, totalStars, totalForks } = this.data;
+        return `## 📊 GitHub 统计
+
+<div align="center">
+
+| 统计项 | 数值 |
+|:---:|:---:|
+| 🌟 总 Stars | ${totalStars} |
+| 🍴 总 Forks | ${totalForks} |
+| 📦 公开仓库 | ${user.public_repos} |
+| 👥 关注者 | ${user.followers} |
+| 💫 正在关注 | ${user.following} |
+
+</div>`;
+    }
+    generateLanguages() {
+        const { languages } = this.data;
+        const sorted = Object.entries(languages)
+            .sort(([, a], [, b]) => b - a)
+            .slice(0, 8);
+        if (sorted.length === 0)
+            return '';
+        const rows = sorted.map(([lang, count]) => {
+            const percentage = ((count / Object.values(languages).reduce((a, b) => a + b, 0)) * 100).toFixed(1);
+            return `| ${lang} | ${count} | ${percentage}% |`;
+        }).join('\n');
+        return `## 💻 编程语言
+
+| 语言 | 仓库数 | 占比 |
+|:---|:---:|:---:|
+${rows}`;
+    }
+    generateRepos() {
+        const { repos } = this.data;
+        const featured = this.config.featuredRepos || [];
+        let displayRepos = repos;
+        if (featured.length > 0) {
+            displayRepos = repos.filter(r => featured.some(f => r.name === f || r.full_name === f));
+        }
+        else {
+            displayRepos = repos
+                .sort((a, b) => b.stargazers_count - a.stargazers_count)
+                .slice(0, 6);
+        }
+        if (displayRepos.length === 0)
+            return '';
+        const cards = displayRepos.map(repo => {
+            const lang = repo.language || 'N/A';
+            const desc = repo.description || '暂无描述';
+            return `### 📦 [${repo.name}](${repo.html_url})
+${desc}
+
+⭐ ${repo.stargazers_count} stars | 🍴 ${repo.forks_count} forks | 📝 ${lang}`;
+        }).join('\n\n');
+        return `## 🔥 精选项目
+
+${cards}`;
+    }
+    generateFooter() {
+        const { updatedAt } = this.data;
+        const date = new Date(updatedAt).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' });
+        return `---
+
+<div align="center">
+
+*此 README 由 [breathing-github-profile](https://github.com/webywz/breathing-github-profile) 自动生成*
+
+*最后更新: ${date} (北京时间)*
+
+</div>`;
+    }
+}
+exports.ReadmeGenerator = ReadmeGenerator;
+function updateReadmeMarkers(existingReadme, markerSections) {
+    let updated = existingReadme;
+    for (const { marker, content } of markerSections) {
+        const startMarker = `<!--${marker}:START-->`;
+        const endMarker = `<!--${marker}:END-->`;
+        const regex = new RegExp(`${escapeRegex(startMarker)}[\\s\\S]*?${escapeRegex(endMarker)}`, 'g');
+        const replacement = `${startMarker}\n${content}\n${endMarker}`;
+        if (regex.test(updated)) {
+            updated = updated.replace(regex, replacement);
+        }
+        else {
+            updated += `\n\n${replacement}`;
+        }
+    }
+    return updated;
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}

package/dist/github.d.ts

@@ -0,0 +1,11 @@
+import { GitHubUser, GitHubRepo, ProfileData } from './types';
+export declare class GitHubClient {
+    private token?;
+    private baseUrl;
+    constructor(token?: string);
+    private fetch;
+    getUser(username: string): Promise<GitHubUser>;
+    getRepos(username: string): Promise<GitHubRepo[]>;
+    getProfileData(username: string): Promise<ProfileData>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE9D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAA4B;gBAE/B,KAAK,CAAC,EAAE,MAAM;YAIZ,KAAK;IAmBb,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqBjD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA4B7D"}

package/dist/github.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubClient = void 0;
+class GitHubClient {
+    constructor(token) {
+        this.baseUrl = 'https://api.github.com';
+        this.token = token || process.env.GITHUB_TOKEN;
+    }
+    async fetch(endpoint) {
+        const headers = {
+            'Accept': 'application/vnd.github.v3+json',
+            'User-Agent': 'breathing-github-profile'
+        };
+        if (this.token) {
+            headers['Authorization'] = `token ${this.token}`;
+        }
+        const response = await fetch(`${this.baseUrl}${endpoint}`, { headers });
+        if (!response.ok) {
+            throw new Error(`GitHub API 错误: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async getUser(username) {
+        return this.fetch(`/users/${username}`);
+    }
+    async getRepos(username) {
+        const repos = [];
+        let page = 1;
+        const perPage = 100;
+        const maxPages = 10;
+        while (page <= maxPages) {
+            const batch = await this.fetch(`/users/${username}/repos?per_page=${perPage}&page=${page}&sort=updated`);
+            if (batch.length === 0)
+                break;
+            repos.push(...batch);
+            if (batch.length < perPage)
+                break;
+            page++;
+        }
+        return repos.filter(repo => !repo.fork);
+    }
+    async getProfileData(username) {
+        const [user, repos] = await Promise.all([
+            this.getUser(username),
+            this.getRepos(username)
+        ]);
+        const languages = {};
+        let totalStars = 0;
+        let totalForks = 0;
+        for (const repo of repos) {
+            totalStars += repo.stargazers_count;
+            totalForks += repo.forks_count;
+            if (repo.language) {
+                languages[repo.language] = (languages[repo.language] || 0) + 1;
+            }
+        }
+        return {
+            user,
+            repos,
+            languages,
+            totalStars,
+            totalForks,
+            updatedAt: new Date().toISOString()
+        };
+    }
+}
+exports.GitHubClient = GitHubClient;
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IAIvB,YAAY,KAAc;QAFlB,YAAO,GAAG,wBAAwB,CAAC;QAGzC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,KAAK,CAAI,QAAgB;QACrC,MAAM,OAAO,GAA2B;YACtC,QAAQ,EAAE,gCAAgC;YAC1C,YAAY,EAAE,0BAA0B;SACzC,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAExE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAa,UAAU,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,CAAC;QACpB,MAAM,QAAQ,GAAG,EAAE,CAAC;QAEpB,OAAO,IAAI,IAAI,QAAQ,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAC5B,UAAU,QAAQ,mBAAmB,OAAO,SAAS,IAAI,eAAe,CACzE,CAAC;YAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAErB,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;gBAAE,MAAM;YAClC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACxB,CAAC,CAAC;QAEH,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,IAAI,IAAI,CAAC,gBAAgB,CAAC;YACpC,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC;YAE/B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI;YACJ,KAAK;YACL,SAAS;YACT,UAAU;YACV,UAAU;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;CACF;AAhFD,oCAgFC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ProfileConfig, ProfileData, GitHubUser, GitHubRepo, Section, StyleConfig } from './types';
+export { loadConfig, validateConfig, getDefaultConfig } from './config';
+export { GitHubClient } from './github';
+export { ReadmeGenerator, updateReadmeMarkers } from './generator';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateReadmeMarkers = exports.ReadmeGenerator = exports.GitHubClient = exports.getDefaultConfig = exports.validateConfig = exports.loadConfig = void 0;
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_1.validateConfig; } });
+Object.defineProperty(exports, "getDefaultConfig", { enumerable: true, get: function () { return config_1.getDefaultConfig; } });
+var github_1 = require("./github");
+Object.defineProperty(exports, "GitHubClient", { enumerable: true, get: function () { return github_1.GitHubClient; } });
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "ReadmeGenerator", { enumerable: true, get: function () { return generator_1.ReadmeGenerator; } });
+Object.defineProperty(exports, "updateReadmeMarkers", { enumerable: true, get: function () { return generator_1.updateReadmeMarkers; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,mCAAwE;AAA/D,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AACrD,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,yCAAmE;AAA1D,4GAAA,eAAe,OAAA;AAAE,gHAAA,mBAAmB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export interface ProfileConfig {
+    username: string;
+    intro: {
+        zh?: string;
+        en?: string;
+    };
+    featuredRepos?: string[];
+    sections?: Section[];
+    style?: StyleConfig;
+}
+export interface Section {
+    type: 'stats' | 'languages' | 'repos' | 'custom';
+    title?: string;
+    content?: string;
+    marker?: string;
+}
+export interface StyleConfig {
+    theme?: 'light' | 'dark' | 'auto';
+    icons?: boolean;
+    badges?: boolean;
+}
+export interface GitHubUser {
+    login: string;
+    name: string;
+    bio: string;
+    public_repos: number;
+    followers: number;
+    following: number;
+    created_at: string;
+    avatar_url: string;
+    html_url: string;
+    location?: string;
+    blog?: string;
+    twitter_username?: string;
+    company?: string;
+}
+export interface GitHubRepo {
+    name: string;
+    full_name: string;
+    description: string;
+    html_url: string;
+    homepage: string;
+    stargazers_count: number;
+    forks_count: number;
+    language: string;
+    topics: string[];
+    created_at: string;
+    updated_at: string;
+    pushed_at: string;
+    size: number;
+    watchers_count: number;
+    open_issues_count: number;
+    archived: boolean;
+    fork: boolean;
+}
+export interface ProfileData {
+    user: GitHubUser;
+    repos: GitHubRepo[];
+    languages: Record<string, number>;
+    totalStars: number;
+    totalForks: number;
+    updatedAt: string;
+}
+export interface MarkerSection {
+    marker: string;
+    content: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/README.md

@@ -0,0 +1,115 @@
+# 示例和演示
+
+本目录包含使用 breathing-github-profile 的示例配置。
+
+## 📄 webywz.yml
+
+完整的配置示例，展示所有可用功能：
+
+- ✅ 中英文双语介绍
+- ✅ 精选仓库列表
+- ✅ 多种章节类型（统计、语言、项目）
+- ✅ 自定义内容（技术栈徽章）
+- ✅ 样式配置
+
+## 🚀 快速测试
+
+### 1. 验证配置
+
+```bash
+npm run validate -- -c examples/webywz.yml
+```
+
+预期输出：
+```
+✓ 配置文件有效
+```
+
+### 2. 生成 README（演示模式）
+
+```bash
+# 生成到临时文件
+npm run generate -- -c examples/webywz.yml -o examples/test-output.md
+```
+
+### 3. 测试刷新功能
+
+```bash
+# 首先生成一个 README
+npm run generate -- -c examples/webywz.yml -o examples/demo.md
+
+# 手动编辑 demo.md，在标记外添加自定义内容
+
+# 刷新（只更新标记部分）
+npm run refresh -- -c examples/webywz.yml -r examples/demo.md
+```
+
+你会发现自定义内容被保留，只有标记部分被更新！
+
+## 📝 创建你自己的配置
+
+1. 复制 `webywz.yml` 作为模板
+2. 修改 `username` 为你的 GitHub 用户名
+3. 更新 `intro` 中的介绍
+4. 根据需要调整 `sections`
+5. 运行 `npm run generate` 生成 README
+
+## 🔧 配置选项参考
+
+### 章节类型
+
+#### stats
+显示 GitHub 统计信息
+
+```yaml
+- type: stats
+  marker: STATS
+  title: 📊 我的统计
+```
+
+#### languages
+显示编程语言分布
+
+```yaml
+- type: languages
+  marker: LANGUAGES
+  title: 💻 技术栈
+```
+
+#### repos
+显示精选项目
+
+```yaml
+- type: repos
+  marker: REPOS
+  title: 🔥 热门项目
+```
+
+#### custom
+自定义 Markdown 内容
+
+```yaml
+- type: custom
+  marker: BADGES
+  title: 🎯 技能徽章
+  content: |
+    ![TypeScript](https://img.shields.io/badge/-TypeScript-blue)
+    ![React](https://img.shields.io/badge/-React-61DAFB)
+```
+
+## 💡 提示
+
+1. **标记名称**: 确保每个章节的 `marker` 唯一
+2. **GitHub Token**: 设置 `GITHUB_TOKEN` 环境变量以避免 API 速率限制
+3. **精选仓库**: 使用 `featuredRepos` 手动选择要展示的项目
+4. **自定义样式**: 在 `custom` 章节中使用 HTML 和 Markdown
+
+## 🌟 实际案例
+
+使用此工具的 Profile README：
+
+- [webywz/webywz](https://github.com/webywz/webywz) - 配套的 profile 仓库
+
+---
+
+有问题？查看 [主文档](../README.md) 或提交 [issue](https://github.com/webywz/breathing-github-profile/issues)。

package/examples/demo-config.yml

@@ -0,0 +1,21 @@
+username: octocat
+
+intro:
+  zh: |
+    👋 你好！我是 Octocat
+    
+    GitHub 的吉祥物，开源爱好者
+  
+  en: |
+    👋 Hi! I'm Octocat
+    
+    GitHub's mascot and open source enthusiast
+
+sections:
+  - type: stats
+    marker: STATS
+    title: 📊 统计数据
+  
+  - type: languages
+    marker: LANGUAGES
+    title: 💻 编程语言

package/examples/webywz.yml

@@ -0,0 +1,66 @@
+username: webywz
+
+intro:
+  zh: |
+    🚀 全栈开发者 | AI 爱好者 | 开源贡献者
+    
+    💡 专注于现代 Web 开发和人工智能技术
+    - 🔧 后端：Node.js (NestJS) / Python (FastAPI)
+    - 🎨 前端：React / Vue / TypeScript
+    - 🤖 AI：LangChain / Prompt Engineering
+    - 🛠 工具：GitHub Actions / Docker / Cloudflare
+    
+    📫 欢迎交流合作！
+  
+  en: |
+    🚀 Full-stack Developer | AI Enthusiast | Open Source Contributor
+    
+    💡 Focus on Modern Web Development and AI Technologies
+    - 🔧 Backend: Node.js (NestJS) / Python (FastAPI)
+    - 🎨 Frontend: React / Vue / TypeScript
+    - 🤖 AI: LangChain / Prompt Engineering
+    - 🛠 Tools: GitHub Actions / Docker / Cloudflare
+    
+    📫 Let's connect and collaborate!
+
+featuredRepos:
+  - breathing-github-profile
+  - webywz
+
+sections:
+  - type: stats
+    marker: STATS
+    title: 📊 GitHub 统计
+  
+  - type: languages
+    marker: LANGUAGES
+    title: 💻 常用语言
+  
+  - type: repos
+    marker: REPOS
+    title: 🔥 精选项目
+  
+  - type: custom
+    marker: TECH_STACK
+    title: 🛠 技术栈
+    content: |
+      ### 后端开发
+      ![Node.js](https://img.shields.io/badge/-Node.js-339933?style=flat-square&logo=node.js&logoColor=white)
+      ![NestJS](https://img.shields.io/badge/-NestJS-E0234E?style=flat-square&logo=nestjs&logoColor=white)
+      ![Python](https://img.shields.io/badge/-Python-3776AB?style=flat-square&logo=python&logoColor=white)
+      ![FastAPI](https://img.shields.io/badge/-FastAPI-009688?style=flat-square&logo=fastapi&logoColor=white)
+      
+      ### 前端开发
+      ![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)
+      ![React](https://img.shields.io/badge/-React-61DAFB?style=flat-square&logo=react&logoColor=black)
+      ![Vue](https://img.shields.io/badge/-Vue-4FC08D?style=flat-square&logo=vue.js&logoColor=white)
+      
+      ### AI & 工具
+      ![LangChain](https://img.shields.io/badge/-LangChain-1C3C3C?style=flat-square&logo=chainlink&logoColor=white)
+      ![Docker](https://img.shields.io/badge/-Docker-2496ED?style=flat-square&logo=docker&logoColor=white)
+      ![GitHub Actions](https://img.shields.io/badge/-GitHub_Actions-2088FF?style=flat-square&logo=github-actions&logoColor=white)
+
+style:
+  theme: auto
+  icons: true
+  badges: true

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@webywz/breathing-github-profile",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "可复用的活跃 GitHub profile README 生成器，支持每日自动刷新",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "breathing-profile": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "refresh": "tsx src/cli.ts refresh",
+    "generate": "tsx src/cli.ts generate",
+    "validate": "tsx src/cli.ts validate",
+    "lint": "eslint src --ext .ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "github",
+    "profile",
+    "readme",
+    "generator",
+    "automation"
+  ],
+  "author": "webywz",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "dependencies": {
+    "yaml": "^2.3.4",
+    "commander": "^11.1.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "@types/jest": "^29.5.11",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webywz/breathing-github-profile.git"
+  },
+  "homepage": "https://github.com/webywz/breathing-github-profile#readme",
+  "bugs": {
+    "url": "https://github.com/webywz/breathing-github-profile/issues"
+  }
+}