@gangtiser/md2wechat 0.1.0

package/dist/src/themes/builtin.js

@@ -0,0 +1,21 @@
+export const builtinThemes = [
+    {
+        id: "default",
+        name: "Default",
+        description: "Clean WeChat article typography with balanced spacing.",
+        prompt: "Use clean, readable WeChat Official Account typography with inline styles, moderate spacing, and restrained accent color."
+    },
+    {
+        id: "editorial",
+        name: "Editorial",
+        description: "Magazine-like headings and strong pull quotes.",
+        prompt: "Use editorial magazine pacing, strong headings, pull quotes, and inline styles compatible with WeChat."
+    },
+    {
+        id: "minimal",
+        name: "Minimal",
+        description: "Quiet typography for concise technical writing.",
+        prompt: "Use minimal inline styles, high readability, compact headings, and no decorative clutter."
+    }
+];
+//# sourceMappingURL=builtin.js.map

package/dist/src/themes/builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../../src/themes/builtin.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wDAAwD;QACrE,MAAM,EAAE,2HAA2H;KACpI;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gDAAgD;QAC7D,MAAM,EAAE,wGAAwG;KACjH;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iDAAiD;QAC9D,MAAM,EAAE,2FAA2F;KACpG;CACF,CAAC"}

package/dist/src/themes/registry.d.ts

@@ -0,0 +1,18 @@
+export interface ThemeDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    prompt: string;
+}
+export interface LoadedTheme extends ThemeDefinition {
+    builtin: boolean;
+    path?: string;
+}
+export interface ThemeRegistryOptions {
+    registryPath?: string;
+    projectThemesDir?: string;
+}
+export declare function listThemes(options?: ThemeRegistryOptions): Promise<LoadedTheme[]>;
+export declare function resolveTheme(id: string, options?: ThemeRegistryOptions): Promise<LoadedTheme>;
+export declare function registerTheme(name: string, themePath: string, options?: ThemeRegistryOptions): Promise<LoadedTheme>;
+export declare function removeTheme(name: string, options?: ThemeRegistryOptions): Promise<void>;

package/dist/src/themes/registry.js

@@ -0,0 +1,130 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { AppError } from "../core/errors.js";
+import { builtinThemes } from "./builtin.js";
+const DEFAULT_REGISTRY_PATH = ".md2wechat/themes/registry.json";
+export async function listThemes(options = {}) {
+    const registry = await readRegistry(options);
+    const customThemes = await Promise.all(registry.themes.map(async (entry) => {
+        const theme = await loadThemeFile(entry.path, entry.id);
+        return { ...theme, builtin: false, path: entry.path };
+    }));
+    return [
+        ...builtinThemes.map((theme) => ({ ...theme, builtin: true })),
+        ...customThemes
+    ];
+}
+export async function resolveTheme(id, options = {}) {
+    const theme = (await listThemes(options)).find((candidate) => candidate.id === id);
+    if (!theme) {
+        throw new AppError("THEME_NOT_FOUND", `Theme not found: ${id}`);
+    }
+    return theme;
+}
+export async function registerTheme(name, themePath, options = {}) {
+    const theme = await loadThemeFile(themePath, name);
+    if (isBuiltinTheme(theme.id)) {
+        throw new AppError("THEME_BUILTIN", `Cannot register built-in theme: ${theme.id}`);
+    }
+    const registry = await readRegistry(options);
+    const absolutePath = resolve(themePath);
+    const existingIndex = registry.themes.findIndex((entry) => entry.id === theme.id);
+    const entry = { id: theme.id, path: absolutePath };
+    if (existingIndex >= 0) {
+        registry.themes[existingIndex] = entry;
+    }
+    else {
+        registry.themes.push(entry);
+    }
+    await writeRegistry(registry, options);
+    return { ...theme, builtin: false, path: absolutePath };
+}
+export async function removeTheme(name, options = {}) {
+    if (isBuiltinTheme(name)) {
+        throw new AppError("THEME_BUILTIN", `Cannot remove built-in theme: ${name}`);
+    }
+    const registry = await readRegistry(options);
+    const nextThemes = registry.themes.filter((entry) => entry.id !== name);
+    await writeRegistry({ themes: nextThemes }, options);
+}
+async function loadThemeFile(themePath, suppliedId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(themePath, "utf8"));
+    }
+    catch (error) {
+        throw new AppError("THEME_INVALID", `Unable to read theme file: ${themePath}`, false, error);
+    }
+    if (!isRecord(parsed)) {
+        throw new AppError("THEME_INVALID", "Theme file must contain a JSON object");
+    }
+    const id = stringValue(parsed.id) || suppliedId;
+    const name = stringValue(parsed.name);
+    const prompt = stringValue(parsed.prompt);
+    if (!id || !name || !prompt) {
+        throw new AppError("THEME_INVALID", "Theme id, name, and prompt must be non-empty strings");
+    }
+    return {
+        id,
+        name,
+        description: stringValue(parsed.description),
+        prompt
+    };
+}
+async function readRegistry(options) {
+    const registryPath = getRegistryPath(options);
+    try {
+        const parsed = JSON.parse(await readFile(registryPath, "utf8"));
+        if (!isRecord(parsed) || !Array.isArray(parsed.themes)) {
+            throw new AppError("THEME_REGISTRY_INVALID", "Theme registry must contain a themes array");
+        }
+        return {
+            themes: parsed.themes.map(parseRegistryEntry)
+        };
+    }
+    catch (error) {
+        if (isMissingFile(error)) {
+            return { themes: [] };
+        }
+        if (error instanceof AppError) {
+            throw error;
+        }
+        throw new AppError("THEME_REGISTRY_INVALID", `Unable to read theme registry: ${registryPath}`, false, error);
+    }
+}
+async function writeRegistry(registry, options) {
+    const registryPath = getRegistryPath(options);
+    await mkdir(dirname(registryPath), { recursive: true });
+    await writeFile(registryPath, `${JSON.stringify(registry, null, 2)}\n`);
+}
+function getRegistryPath(options) {
+    return resolve(options.registryPath || options.projectThemesDir || DEFAULT_REGISTRY_PATH);
+}
+function parseRegistryEntry(value) {
+    if (!isRecord(value)) {
+        throw new AppError("THEME_REGISTRY_INVALID", "Theme registry entries must be JSON objects");
+    }
+    const id = stringValue(value.id);
+    const entryPath = stringValue(value.path);
+    if (!id || !entryPath) {
+        throw new AppError("THEME_REGISTRY_INVALID", "Theme registry entries require id and path");
+    }
+    return { id, path: entryPath };
+}
+function isBuiltinTheme(id) {
+    return builtinThemes.some((theme) => theme.id === id);
+}
+function isMissingFile(error) {
+    return isRecord(error) && error.code === "ENOENT";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function stringValue(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/themes/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/themes/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4B7C,MAAM,qBAAqB,GAAG,iCAAiC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAgC,EAAE;IACjE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,GAAG,YAAY;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,UAAgC,EAAE;IAC/E,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB,EAAE,UAAgC,EAAE;IACrG,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,mCAAmC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAEnD,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,UAAgC,EAAE;IAChF,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,iCAAiC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACxE,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,SAAiB,EAAE,UAAmB;IACjE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,8BAA8B,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,uCAAuC,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,sDAAsD,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO;QACL,EAAE;QACF,IAAI;QACJ,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC5C,MAAM;KACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAA6B;IACvD,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,4CAA4C,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,kCAAkC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/G,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAA2B,EAAE,OAA6B;IACrF,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe,CAAC,OAA6B;IACpD,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,gBAAgB,IAAI,qBAAqB,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,6CAA6C,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,4CAA4C,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@gangtiser/md2wechat",
+  "version": "0.1.0",
+  "description": "TypeScript md2wechat CLI, Skill, and MCP server without hosted API conversion mode.",
+  "keywords": [
+    "wechat",
+    "markdown",
+    "mcp",
+    "codex",
+    "cli",
+    "openai"
+  ],
+  "author": "Gangtiser",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "bin": {
+    "md2wechat": "./dist/src/cli/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gangtiser/md2wechat.git"
+  },
+  "homepage": "https://github.com/gangtiser/md2wechat#readme",
+  "bugs": {
+    "url": "https://github.com/gangtiser/md2wechat/issues"
+  },
+  "files": [
+    "dist/src",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test \"dist/test/**/*.test.js\"",
+    "verify:api-removal": "npm run build && node --test dist/test/api-removal.test.js",
+    "verify": "npm run typecheck && npm test && npm run verify:api-removal",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run build && npm run verify:api-removal"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/md2wechat/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: md2wechat
+description: Convert Markdown to WeChat Official Account HTML, generate images, manage themes, and use the md2wechat MCP server.
+---
+
+# md2wechat Skill
+
+Use this skill when the user wants to turn Markdown into WeChat Official Account content, preview an article, generate a cover or infographic, manage themes, or expose the workflow through MCP.
+
+## Defaults
+
+- Text rendering model: `gpt-5.5`
+- Image generation model: `gpt-image-2`
+- Conversion is local through the CLI or MCP server.
+
+## Workflow
+
+1. Run `md2wechat inspect <file> --json`.
+2. Run `md2wechat themes list --json` before choosing a theme.
+3. Run `md2wechat convert <file> --theme <theme> --output <file>.html --json`.
+4. Run `md2wechat preview <file> --theme <theme> --output preview.html --json` when the user wants a local confirmation page.
+5. Run `md2wechat generate-image --article <file> --output cover.png --json` for covers or visual assets.
+
+## Theme Management
+
+- Register a theme: `md2wechat themes register <name> <path> --json`
+- Remove a custom theme: `md2wechat themes remove <name> --json`
+- List themes: `md2wechat themes list --json`
+
+## MCP
+
+Start the MCP server with:
+
+```bash
+md2wechat mcp
+```
+
+Available tools:
+
+- `convert_article`
+- `preview_article`
+- `generate_image`
+- `list_themes`
+- `register_theme`
+- `remove_theme`
+
+## Rules
+
+- Prefer file paths over large inline article content.
+- Do not assume a theme exists; list themes first.
+- Keep generated HTML and preview files on disk unless the user asks for stdout.
+- Treat `OPENAI_API_KEY` as required for conversion and image generation.