kecare 1.0.0-beta.54

package/README.md

@@ -0,0 +1,15 @@
+# kecare-tools
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.2.22. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/__VERSION__.ts

@@ -0,0 +1 @@
+export const __VERSION__ = '1.0.0-beta.54'

package/generator-helpers/__ROOT__.ts

@@ -0,0 +1,104 @@
+export type Article = {
+    id: string;
+    title: string;
+    sticky?: number;
+    desc?: string;
+    coverSrc?: string;
+    contentHtml: string;
+    date: string;
+    author?: string;
+    to: string;
+    menu?: string | null;
+    menudata?: NavItem[] | null;
+    headings: Heading[];
+    hidden?: boolean;
+    filename?: string;
+    translate?: boolean;
+    targetLanguage?: string;
+    Variant: ArticleVariant;
+};
+
+type ArticleVariant = {
+    title: string | undefined;
+    contentHtml: string | undefined;
+    language: string | undefined;
+    headings: Heading[];
+};
+
+export type HeadingH1 = {
+    depth: 1;
+    text: string;
+    id: string;
+    children: HeadingH2[];
+};
+export type HeadingH2 = {
+    depth: 2;
+    text: string;
+    id: string;
+};
+export type Heading = HeadingH1 | HeadingH2;
+
+/**
+ * Translation configuration (user-configurable settings)
+ */
+export type TranslationConfigOptions = {
+    /**
+     * Model name (e.g., 'deepseek-chat', 'gpt-4', etc.)
+     */
+    model?: string;
+    /**
+     * API base URL
+     */
+    baseUrl?: string;
+    /**
+     * API key
+     */
+    apiKey?: string;
+    /**
+     * Additional system prompts
+     */
+    additionalPrompts?: string[];
+};
+
+export type TranslateCallOptions = {
+    /**
+     * Text to translate
+     */
+    text: string;
+    /**
+     * Target language (optional, defaults to TranslationConfig.targetLanguage)
+     */
+    targetLanguage?: string;
+    /**
+     * Model name (optional, defaults to TranslationConfig.model)
+     */
+    model?: string;
+    /**
+     * Additional system prompts (optional, defaults to TranslationConfig.additionalPrompts)
+     */
+    additionalPrompts?: string[];
+    /*
+     *
+     */
+    title: string;
+};
+
+export type ArticleListGenerator = (params: { projectPath: string; article: Article; articles: Article[]; NavItems: NavItem[] }) => Promise<{
+    path: string;
+    template: string;
+}>;
+
+export type PagesListGenerator = (params: { projectPath: string; page: number; cards: []; isIndex: number; pageSize: number; totalPages: number; totalArticles: number; listTitle: number }) => Promise<{
+    path: string;
+    template: string;
+}>;
+
+export type NavItem = { text: string; link: string; level: number; desc?: string; icon?: string } | { text: string; items: NavItem[]; level: number };
+
+export function defineArticleListGenerator<Generator extends ArticleListGenerator>(yourGenerator: Generator) {
+    return yourGenerator;
+}
+
+export function PagesListGenerator<Generator extends PagesListGenerator>(yourGenerator: Generator) {
+    return yourGenerator;
+}

package/index.ts

@@ -0,0 +1,2 @@
+export * from "./generator-helpers/__ROOT__.ts";
+export * from "./sdk/__ROOT__.ts";

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "kecare",
+  "version": "1.0.0-beta.54",
+  "module": "index.ts",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pamperkyumi/kecare"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/sdk/__ROOT__.ts

@@ -0,0 +1,36 @@
+import { onMountedSidebar } from './sidebar';
+import { style } from './style';
+import { onMountedSyntaxHighlight } from './syntax-highlight';
+
+let instancePromise: ReturnType<typeof createKecareSDK> | null = null; // 缓存 Promise
+
+async function createKecareSDK() {
+    if (typeof window === 'undefined' || typeof document === 'undefined') return; // 确保在浏览器环境下运行，在服务端渲染或其他情况下不执行
+
+    await style();
+
+    // 等待页面完全加载
+    const loaded = new Promise((resolve) => {
+        if (document.readyState === 'complete') resolve(undefined);
+        else window.addEventListener('load', resolve, { once: true });
+    });
+
+    const kecareSDK = {
+        mounted: async () => {
+            await loaded;
+            const articleElement = document.querySelector('.kecare')! as HTMLDivElement;
+            await onMountedSidebar(articleElement);
+            await onMountedSyntaxHighlight(articleElement);
+        },
+    }
+
+
+    return kecareSDK;
+}
+
+export function useKecareSDK() {
+    if (!instancePromise) {
+        instancePromise = createKecareSDK();
+    }
+    return instancePromise;
+}

package/sdk/sidebar.ts

@@ -0,0 +1,65 @@
+export async function onMountedSidebar(articleElement: HTMLDivElement) {
+    const articleSidebarElement = document.querySelector('.kecare-sidebar');
+    if (!articleSidebarElement) return; // 主题开发者如果没有在主题里添加侧边栏元素，则不执行侧边栏相关逻辑
+
+    const headings = articleElement.querySelectorAll('h1, h2, h3, h4, h5, h6');
+    const headingHierarchy: Array<{ level: number; element: HTMLElement; children: typeof headingHierarchy }> = [];
+
+    const stack: typeof headingHierarchy = [];
+    for (let i = 0; i < headings.length; i++) {
+        const heading = headings[i]!;
+        const level = parseInt(heading.tagName[1]!);
+        const node = { level, element: heading as HTMLElement, children: [] };
+
+        // 找到正确的父节点
+        while (stack.length > 0 && stack[stack.length - 1]!.level >= level) {
+            stack.pop();
+        }
+
+        if (stack.length > 0) stack[stack.length - 1]!.children.push(node);
+        else headingHierarchy.push(node);
+
+        stack.push(node);
+    }
+
+    function buildTOC(nodes: typeof headingHierarchy, isSub = false): string {
+        let result = '';
+        for (const node of nodes) {
+            const element = node.element;
+            const id = element.id || '';
+            const text = element.textContent || '';
+            const linkClass = isSub ? 'toc-sublink' : 'toc-link';
+
+            result += `<li class="${isSub ? 'toc-subitem' : 'toc-item'}">`;
+            result += `<a class="${linkClass}" data-target="${id}" title="${text}">${text}</a>`;
+
+            if (node.children.length > 0) {
+                result += `<ul class="toc-sublist">`;
+                result += buildTOC(node.children, true);
+                result += `</ul>`;
+            }
+
+            result += `</li>`;
+        }
+        return result;
+    }
+
+    const tocHtml = `<ul class="toc-list">${buildTOC(headingHierarchy)}</ul>`;
+    articleSidebarElement.innerHTML = tocHtml;
+
+    // 注册点击事件
+    const links = articleSidebarElement.querySelectorAll('a.toc-link, a.toc-sublink');
+    for (let i = 0; i < links.length; i++) {
+        const link = links[i] as HTMLAnchorElement;
+        link.addEventListener('click', (e) => {
+            e.preventDefault();
+            const targetId = link.dataset.target;
+            if (!targetId) return;
+            const targetElement = document.getElementById(targetId);
+            if (targetElement) {
+                targetElement.scrollIntoView({ behavior: 'smooth', block: 'start' });
+            }
+        });
+    }
+
+}

package/sdk/style.ts

@@ -0,0 +1,12 @@
+export const __STYLE__ = `
+.kecare h1 {
+  font-size: 24px;
+}
+`; // 这里放你需要在用户那边加载的编辑器区域的样式
+
+export async function style() {
+    // 创建 style 标签并添加到 head
+    const styleElement = document.createElement('style');
+    styleElement.textContent = __STYLE__;
+    document.head.appendChild(styleElement);
+}

package/sdk/syntax-highlight.ts

@@ -0,0 +1,30 @@
+export async function onMountedSyntaxHighlight(articleElement: HTMLDivElement) {
+    const codeElements = articleElement.querySelectorAll('code');
+    const { codeToHtml } = await import('shiki');
+
+    for (const codeElement of codeElements) {
+        const classList = codeElement.className.split(' ')
+        const langClass = classList.find(cls => cls.startsWith('language-'))
+        const lang = langClass ? langClass.replace('language-', '') : 'text'
+
+        const code = codeElement.textContent || '';
+
+        const highlightedHtml = await codeToHtml(code, {
+            lang,
+            theme: 'one-dark-pro' // or 亮色主题 one-light
+        })
+
+        const tempDiv = document.createElement('div')
+        tempDiv.innerHTML = highlightedHtml
+        const preElement = tempDiv.firstElementChild
+
+        if (!preElement) continue
+
+        const parentElement = codeElement.parentElement
+        if (parentElement && parentElement.tagName === 'PRE') {
+            parentElement.replaceWith(preElement)
+        } else {
+            codeElement.replaceWith(preElement)
+        }
+    }
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}