coding-friend-cli 1.0.0

package/lib/learn-host/src/components/ThemeToggle.tsx

@@ -0,0 +1,30 @@
+"use client";
+
+import { useTheme } from "next-themes";
+import { useEffect, useState } from "react";
+
+export default function ThemeToggle() {
+  const { theme, setTheme } = useTheme();
+  const [mounted, setMounted] = useState(false);
+
+  useEffect(() => setMounted(true), []);
+  if (!mounted) return <div className="w-9 h-9" />;
+
+  return (
+    <button
+      onClick={() => setTheme(theme === "dark" ? "light" : "dark")}
+      className="p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+      aria-label="Toggle theme"
+    >
+      {theme === "dark" ? (
+        <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z" />
+        </svg>
+      ) : (
+        <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z" />
+        </svg>
+      )}
+    </button>
+  );
+}

package/lib/learn-host/src/lib/docs.ts

@@ -0,0 +1,113 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import type { CategoryInfo, Doc, DocFrontmatter, DocMeta } from "./types";
+
+function getDocsDir(): string {
+  const raw = process.env.DOCS_DIR || path.join(process.cwd(), "../../docs/learn");
+  return path.resolve(raw);
+}
+
+function isMarkdownDoc(fileName: string): boolean {
+  return fileName.endsWith(".md") && fileName !== "README.md";
+}
+
+function parseFrontmatter(raw: matter.GrayMatterFile<string>): DocFrontmatter {
+  const d = raw.data;
+  return {
+    title: String(d.title ?? "Untitled"),
+    category: String(d.category ?? ""),
+    tags: Array.isArray(d.tags) ? d.tags.map(String) : [],
+    created: String(d.created ?? ""),
+    updated: String(d.updated ?? ""),
+  };
+}
+
+function makeExcerpt(content: string, maxLen = 160): string {
+  const text = content
+    .replace(/^#+\s.*/gm, "")
+    .replace(/```[\s\S]*?```/g, "")
+    .replace(/\n{2,}/g, " ")
+    .replace(/\n/g, " ")
+    .trim();
+  return text.length > maxLen ? text.slice(0, maxLen) + "..." : text;
+}
+
+export function getAllCategories(): CategoryInfo[] {
+  const docsDir = getDocsDir();
+  if (!fs.existsSync(docsDir)) return [];
+  return fs
+    .readdirSync(docsDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory() && !d.name.startsWith("."))
+    .map((d) => {
+      const catPath = path.join(docsDir, d.name);
+      const count = fs
+        .readdirSync(catPath)
+        .filter(isMarkdownDoc).length;
+      return { name: d.name, docCount: count };
+    })
+    .filter((c) => c.docCount > 0);
+}
+
+export function getAllDocs(): DocMeta[] {
+  const docsDir = getDocsDir();
+  const docs: DocMeta[] = [];
+  const categories = getAllCategories();
+
+  for (const cat of categories) {
+    const catPath = path.join(docsDir, cat.name);
+    const files = fs.readdirSync(catPath).filter(isMarkdownDoc);
+
+    for (const file of files) {
+      const filePath = path.join(catPath, file);
+      const raw = matter(fs.readFileSync(filePath, "utf-8"));
+      const frontmatter = parseFrontmatter(raw);
+
+      docs.push({
+        slug: path.basename(file, ".md"),
+        category: cat.name,
+        frontmatter: { ...frontmatter, category: cat.name },
+        excerpt: makeExcerpt(raw.content),
+      });
+    }
+  }
+
+  return docs.sort(
+    (a, b) =>
+      new Date(b.frontmatter.updated || b.frontmatter.created).getTime() -
+      new Date(a.frontmatter.updated || a.frontmatter.created).getTime(),
+  );
+}
+
+export function getDocsByCategory(category: string): DocMeta[] {
+  return getAllDocs().filter((d) => d.category === category);
+}
+
+export function getDocBySlug(category: string, slug: string): Doc | null {
+  const docsDir = getDocsDir();
+  const filePath = path.join(docsDir, category, `${slug}.md`);
+  if (!fs.existsSync(filePath)) return null;
+
+  const raw = matter(fs.readFileSync(filePath, "utf-8"));
+  const frontmatter = parseFrontmatter(raw);
+
+  return {
+    slug,
+    category,
+    frontmatter: { ...frontmatter, category },
+    excerpt: makeExcerpt(raw.content),
+    content: raw.content,
+  };
+}
+
+export function getAllTags(): { tag: string; count: number }[] {
+  const tagMap = new Map<string, number>();
+  for (const doc of getAllDocs()) {
+    for (const tag of doc.frontmatter.tags) {
+      tagMap.set(tag, (tagMap.get(tag) ?? 0) + 1);
+    }
+  }
+  return Array.from(tagMap.entries())
+    .map(([tag, count]) => ({ tag, count }))
+    .sort((a, b) => b.count - a.count);
+}

package/lib/learn-host/src/lib/search.ts

@@ -0,0 +1,27 @@
+import { getAllDocs } from "./docs";
+import type { SearchIndexEntry } from "./types";
+
+export function buildSearchIndex(): SearchIndexEntry[] {
+  return getAllDocs().map((doc) => ({
+    slug: doc.slug,
+    category: doc.category,
+    title: doc.frontmatter.title,
+    tags: doc.frontmatter.tags,
+    excerpt: doc.excerpt,
+  }));
+}
+
+export function searchIndex(
+  index: SearchIndexEntry[],
+  query: string,
+): SearchIndexEntry[] {
+  const lower = query.toLowerCase();
+  return index.filter((entry) => {
+    return (
+      entry.title.toLowerCase().includes(lower) ||
+      entry.tags.some((t) => t.toLowerCase().includes(lower)) ||
+      entry.excerpt.toLowerCase().includes(lower) ||
+      entry.category.toLowerCase().includes(lower)
+    );
+  });
+}

package/lib/learn-host/src/lib/types.ts

@@ -0,0 +1,31 @@
+export interface DocFrontmatter {
+  title: string;
+  category: string;
+  tags: string[];
+  created: string;
+  updated: string;
+}
+
+export interface DocMeta {
+  slug: string;
+  category: string;
+  frontmatter: DocFrontmatter;
+  excerpt: string;
+}
+
+export interface Doc extends DocMeta {
+  content: string;
+}
+
+export interface CategoryInfo {
+  name: string;
+  docCount: number;
+}
+
+export interface SearchIndexEntry {
+  slug: string;
+  category: string;
+  title: string;
+  tags: string[];
+  excerpt: string;
+}

package/lib/learn-host/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}