@urmzd/github-insights 2.0.0

package/src/theme.ts

@@ -0,0 +1,33 @@
+export const THEME = {
+  bg: "#0d1117",
+  cardBg: "#161b22",
+  border: "#30363d",
+  link: "#58a6ff",
+  text: "#c9d1d9",
+  secondary: "#8b949e",
+  muted: "#6e7681",
+} as const;
+
+export const FONT =
+  "-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif";
+
+export const LAYOUT = {
+  width: 808,
+  padX: 24,
+  padY: 24,
+  sectionGap: 30,
+  barHeight: 18,
+  barRowHeight: 48,
+  barMaxWidth: 700,
+} as const;
+
+export const BAR_COLORS = [
+  "#58a6ff",
+  "#3fb950",
+  "#d29922",
+  "#f85149",
+  "#bc8cff",
+  "#39d2c0",
+  "#db61a2",
+  "#79c0ff",
+] as const;

package/src/types.ts

@@ -0,0 +1,235 @@
+// ── Render result ───────────────────────────────────────────────────────────
+
+export interface RenderResult {
+  svg: string;
+  height: number;
+}
+
+// ── Language / Tech items ───────────────────────────────────────────────────
+
+export interface LanguageItem {
+  name: string;
+  value: number;
+  percent: string;
+  color: string;
+}
+
+export interface TechItem {
+  name: string;
+  value: number;
+}
+
+export interface ProjectItem {
+  name: string;
+  url: string;
+  description: string;
+  stars: number;
+  languageCount?: number;
+  codeSize?: number;
+  languages?: string[];
+  summary?: string;
+  category?: string;
+}
+
+// ── Bar chart generics ──────────────────────────────────────────────────────
+
+export interface BarItem {
+  name: string;
+  value: number;
+  percent?: string;
+  color?: string;
+}
+
+// ── Stat cards ──────────────────────────────────────────────────────────────
+
+export interface StatItem {
+  label: string;
+  value: string;
+}
+
+// ── Contribution cards ──────────────────────────────────────────────────────
+
+export interface ContributionHighlight {
+  project: string;
+  detail: string;
+}
+
+// ── Section definition ──────────────────────────────────────────────────────
+
+export interface SectionDef {
+  filename: string;
+  title: string;
+  subtitle: string;
+  renderBody?: (y: number) => RenderResult;
+  items?: BarItem[];
+  options?: Record<string, unknown>;
+}
+
+// ── GitHub API types ────────────────────────────────────────────────────────
+
+export interface RepoLanguageEdge {
+  size: number;
+  node: { name: string; color: string };
+}
+
+export interface RepoNode {
+  name: string;
+  description: string | null;
+  url: string;
+  stargazerCount: number;
+  diskUsage: number;
+  primaryLanguage: { name: string; color: string } | null;
+  isArchived: boolean;
+  isFork: boolean;
+  createdAt: string;
+  pushedAt: string;
+  repositoryTopics: { nodes: { topic: { name: string } }[] };
+  languages: {
+    totalSize: number;
+    edges: RepoLanguageEdge[];
+  };
+}
+
+export interface ContributionsCollection {
+  totalCommitContributions: number;
+  totalPullRequestContributions: number;
+  totalPullRequestReviewContributions: number;
+  totalRepositoriesWithContributedCommits: number;
+}
+
+export interface ExternalRepo {
+  nameWithOwner: string;
+  url: string;
+  stargazerCount: number;
+  description: string | null;
+  primaryLanguage: { name: string } | null;
+}
+
+// ── Commit contributions by repository ────────────────────────────────────
+
+export interface RepoCommitContribution {
+  repository: { name: string; nameWithOwner: string };
+  contributions: { totalCount: number };
+}
+
+// ── Contribution calendar ──────────────────────────────────────────────────
+
+export interface ContributionDay {
+  contributionCount: number;
+  date: string;
+  color: string;
+}
+
+export interface ContributionWeek {
+  contributionDays: ContributionDay[];
+}
+
+export interface ContributionCalendar {
+  totalContributions: number;
+  weeks: ContributionWeek[];
+}
+
+export interface ContributionData {
+  contributions: ContributionsCollection;
+  externalRepos: { totalCount: number; nodes: ExternalRepo[] };
+  contributionCalendar?: ContributionCalendar;
+  commitContributionsByRepository?: RepoCommitContribution[];
+}
+
+// ── Manifest types ──────────────────────────────────────────────────────────
+
+export type ManifestMap = Map<string, Record<string, string>>;
+export type ReadmeMap = Map<string, string>;
+
+// ── Package parser ─────────────────────────────────────────────────────────
+
+export interface PackageParser {
+  /** Filenames this parser handles (e.g. ["package.json"]) */
+  filenames: string[];
+  /** Extract dependency names from file content */
+  parseDependencies(text: string): string[];
+}
+
+export interface TechHighlight {
+  category: string;
+  items: string[];
+  score: number; // 0-100 proficiency level
+}
+
+export interface UserConfig {
+  title?: string;
+  desired_title?: string;
+  name?: string;
+  pronunciation?: string;
+  bio?: string;
+  preamble?: string;
+  template?: TemplateName;
+  sections?: string[];
+}
+
+export interface UserProfile {
+  name: string | null;
+  bio: string | null;
+  company: string | null;
+  location: string | null;
+  websiteUrl: string | null;
+  twitterUsername: string | null;
+  socialAccounts: { provider: string; url: string }[];
+}
+
+// ── SVG embed ─────────────────────────────────────────────────────────────
+
+export interface SvgEmbed {
+  label: string;
+  path: string;
+}
+
+// ── Template types ────────────────────────────────────────────────────────
+
+export type TemplateName = "classic" | "modern" | "minimal" | "ecosystem";
+
+export type ProjectStatus = "active" | "maintained" | "inactive";
+
+export interface RepoClassificationInput {
+  name: string;
+  description: string;
+  stars: number;
+  diskUsageKb: number;
+  languages: string[];
+  commitsLastYear: number;
+  createdAt?: string;
+  pushedAt: string;
+  topicCount: number;
+}
+
+export interface RepoClassificationOutput {
+  name: string;
+  status: ProjectStatus;
+  summary: string;
+  category?: string;
+}
+
+export interface TemplateContext {
+  username: string;
+  name: string;
+  firstName: string;
+  pronunciation?: string;
+  title?: string;
+  bio?: string;
+  preamble?: string;
+  svgs: SvgEmbed[];
+  sectionSvgs: Record<string, string>;
+  profile: UserProfile;
+  activeProjects: ProjectItem[];
+  maintainedProjects: ProjectItem[];
+  inactiveProjects: ProjectItem[];
+  allProjects: ProjectItem[];
+  categorizedProjects: Record<string, ProjectItem[]>;
+  languages: LanguageItem[];
+  techHighlights: TechHighlight[];
+  contributionData: ContributionData;
+  socialBadges: string;
+  svgDir: string;
+}
+
+export type TemplateFunction = (context: TemplateContext) => string;

package/teasr.toml

@@ -0,0 +1,14 @@
+[server]
+command = "npx serve metrics --listen 3123"
+url = "http://localhost:3123"
+timeout = 10000
+
+[output]
+dir = "./showcase"
+formats = ["png"]
+
+[[scenes]]
+type = "web"
+url = "/index.svg"
+name = "metrics-svg"
+viewport = { width = 1200, height = 900 }

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "jsx": "react",
+    "jsxFactory": "h",
+    "jsxFragmentFactory": "Fragment",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "build",
+    "rootDir": "src",
+    "declaration": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "build"]
+}

package/vitest.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  esbuild: {
+    jsx: "transform",
+    jsxFactory: "h",
+    jsxFragment: "Fragment",
+  },
+  test: {
+    include: ["src/**/*.test.{ts,tsx}"],
+  },
+});