@lemonppt/cli 0.1.8 → 0.2.0

package/dist/index.js

@@ -2,15 +2,16 @@
 // Copyright (c) 2026 lemonforme
 // SPDX-License-Identifier: AGPL-3.0-or-later
 import { generateGoal } from '@lemonppt/agent-prompts';
-import { normalizeDeckGoal } from '@lemonppt/core';
+import { normalizeDeckGoal, validateDeckGoal, validateDeckGoalContent, validateSlideCount } from '@lemonppt/core';
 import { exportDeckToPdf, exportDeckToPptx, renderDeck, } from '@lemonppt/renderer';
-import { getTheme } from '@lemonppt/themes';
+import { getTheme, themes } from '@lemonppt/themes';
+import { getLayout, getLayoutSchema, listLayoutsByRoleAndTheme } from '@lemonppt/templates';
 import { copyFile, cp, mkdir, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 function resolveTheme(themeId) {
-    const id = themeId || 'base';
-    return getTheme(id) ? id : 'base';
+    const id = themeId || 'theme01';
+    return getTheme(id) ? id : 'theme01';
 }
 async function copyThemeAssets(themeId, assetsDir) {
     const theme = resolveTheme(themeId);
@@ -22,17 +23,34 @@ async function copyThemeAssets(themeId, assetsDir) {
     const fontsSource = resolvePackagePath('@lemonppt/renderer', 'assets', 'fonts');
     const fontsDest = path.join(assetsDir, 'fonts');
     await cp(fontsSource, fontsDest, { recursive: true, force: true });
+    // 复制客户端离线渲染脚本，支持静态文件模式下结构编辑
+    const clientRenderSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client-render.js');
+    const clientRenderDest = path.join(assetsDir, 'client-render.js');
+    await copyFile(clientRenderSource, clientRenderDest);
+    // 复制 jQuery，供编辑器初始化自定义滚动条样式类
+    const jquerySource = resolvePackagePath('jquery', 'dist', 'jquery.min.js');
+    const jqueryDest = path.join(assetsDir, 'jquery.min.js');
+    await copyFile(jquerySource, jqueryDest);
 }
 function resolvePackagePath(pkg, ...segments) {
-    const mainUrl = import.meta.resolve(pkg);
-    const pkgRoot = path.resolve(path.dirname(fileURLToPath(mainUrl)), '..');
-    return path.join(pkgRoot, ...segments);
+    // 优先通过 package.json 定位包根（第三方 npm 包）
+    try {
+        const pkgJsonUrl = import.meta.resolve(`${pkg}/package.json`);
+        const pkgRoot = path.dirname(fileURLToPath(pkgJsonUrl));
+        return path.join(pkgRoot, ...segments);
+    }
+    catch {
+        // 工作区包可能未导出 package.json，回退到主入口的父目录的父目录
+        const mainUrl = import.meta.resolve(pkg);
+        const pkgRoot = path.resolve(path.dirname(fileURLToPath(mainUrl)), '..');
+        return path.join(pkgRoot, ...segments);
+    }
 }
 /**
  * 生成 goal.json 并可选写入文件。
  */
 export async function generateGoalToFile(options) {
-    const { input, pageCount = 8, theme = 'base', language = 'zh', apiKey, baseUrl, model, outFile, } = options;
+    const { input, pageCount = 8, theme = 'theme01', language = 'zh', apiKey, baseUrl, model, outFile, } = options;
     const result = await generateGoal({
         input,
         pageCount,
@@ -90,3 +108,297 @@ export async function exportGoalToPdf(goal, options) {
     await mkdir(path.dirname(outFile), { recursive: true });
     await exportDeckToPdf(goal, { outFile });
 }
+/**
+ * 列出所有可用主题。
+ */
+export function listThemes() {
+    return themes.map((t) => ({ id: t.id, name: t.displayName || t.id }));
+}
+/**
+ * 按主题与角色查询候选版式。
+ */
+export function queryLayouts(options) {
+    const { theme, role, keyword, needsMedia, limit = 8, seed = `lemon-${Date.now()}` } = options;
+    let layouts = listLayoutsByRoleAndTheme(role, theme);
+    if (keyword) {
+        const kw = keyword.toLowerCase();
+        layouts = layouts.filter((m) => [m.id, m.displayName, m.description || '', ...(m.tags || []), m.contentShape || '']
+            .join(' ')
+            .toLowerCase()
+            .includes(kw));
+    }
+    if (needsMedia) {
+        layouts = layouts.filter((m) => m.needsMedia);
+    }
+    // 按 seed 做可复现的伪随机排序
+    let s = 0;
+    const seedStr = `${seed}-${role}-${theme}`;
+    for (let i = 0; i < seedStr.length; i++) {
+        s = (s * 31 + seedStr.charCodeAt(i)) >>> 0;
+    }
+    if (s === 0)
+        s = 123456789;
+    let x = s, y = 362436069, z = 521288629, w = 88675123;
+    const random = () => {
+        const t = x ^ (x << 11);
+        x = y;
+        y = z;
+        z = w;
+        w = (w ^ (w >>> 19) ^ (t ^ (t >>> 8))) >>> 0;
+        return w / 0xffffffff;
+    };
+    const copy = [...layouts];
+    for (let i = copy.length - 1; i > 0; i--) {
+        const j = Math.floor(random() * (i + 1));
+        [copy[i], copy[j]] = [copy[j], copy[i]];
+    }
+    const picked = copy.slice(0, limit);
+    return {
+        theme,
+        role,
+        count: picked.length,
+        layouts: picked.map((m) => ({
+            layout: m.id,
+            displayName: m.displayName,
+            description: m.description || '',
+            needsMedia: m.needsMedia,
+        })),
+    };
+}
+/**
+ * 查看指定版式的字段契约。
+ */
+export function inspectLayout(layoutId) {
+    const registered = getLayout(layoutId);
+    const schema = getLayoutSchema(layoutId);
+    if (!registered || !schema)
+        return null;
+    const meta = registered.meta;
+    function simplifyField(field) {
+        const out = {
+            key: field.key,
+            label: field.label,
+            type: field.type,
+        };
+        if (field.defaultValue !== undefined)
+            out.defaultValue = field.defaultValue;
+        return out;
+    }
+    return {
+        layout: meta.id,
+        displayName: meta.displayName,
+        theme: meta.theme,
+        role: meta.role,
+        description: meta.description || '',
+        needsMedia: meta.needsMedia,
+        mediaSlots: meta.mediaSlots || [],
+        tags: meta.tags || [],
+        contentShape: meta.contentShape || '',
+        fields: schema.fields.map(simplifyField),
+    };
+}
+function createSeededRandom(seed) {
+    let s = 0;
+    for (let i = 0; i < seed.length; i++) {
+        s = (s * 31 + seed.charCodeAt(i)) >>> 0;
+    }
+    if (s === 0)
+        s = 123456789;
+    let x = s;
+    let y = 362436069;
+    let z = 521288629;
+    let w = 88675123;
+    return () => {
+        const t = x ^ (x << 11);
+        x = y;
+        y = z;
+        z = w;
+        w = (w ^ (w >>> 19) ^ (t ^ (t >>> 8))) >>> 0;
+        return w / 0xffffffff;
+    };
+}
+function chooseRoles(pageCount, seed) {
+    const random = createSeededRandom(seed);
+    if (pageCount < 3) {
+        return Array.from({ length: pageCount }, () => 'content');
+    }
+    const roles = ['cover'];
+    if (pageCount >= 4)
+        roles.push('tableOfContents');
+    const contentRoles = ['content', 'metric', 'chart', 'process', 'comparison', 'feature', 'timeline', 'quote', 'image', 'table', 'stats'];
+    const remaining = pageCount - roles.length - 1;
+    for (let i = 0; i < remaining; i++) {
+        const idx = Math.floor(random() * contentRoles.length);
+        roles.push(contentRoles[idx]);
+    }
+    roles.push('closing');
+    return roles;
+}
+/**
+ * 生成只含 role 的 goal.json 骨架。
+ */
+export async function scaffoldGoalToFile(options) {
+    const { title, goal, audience = '内部团队', owner, theme = 'theme01', pages = 8, language = 'zh', seed = `lemon-${Date.now()}`, outFile, } = options;
+    const roles = chooseRoles(pages, seed);
+    const { composeDeckFromRaw: compose } = await import('@lemonppt/composer');
+    const result = compose({
+        title,
+        goal,
+        audience,
+        owner,
+        theme,
+        language,
+        pageCount: pages,
+        randomSeed: seed,
+        slides: roles.map((role) => ({ role: role, props: {} })),
+    });
+    if (outFile) {
+        await mkdir(path.dirname(path.resolve(outFile)), { recursive: true });
+        await writeFile(path.resolve(outFile), JSON.stringify(result, null, 2), 'utf-8');
+    }
+    return result;
+}
+function getDefaultValue(field) {
+    if (field.defaultValue !== undefined)
+        return field.defaultValue;
+    switch (field.type) {
+        case 'text':
+        case 'textarea':
+            return '';
+        case 'number':
+        case 'slider':
+            return field.min ?? 0;
+        case 'boolean':
+            return false;
+        case 'array':
+            return [];
+        case 'select':
+            return field.options?.[0]?.value ?? '';
+        case 'image':
+        case 'color':
+            return '';
+        case 'object':
+            return {};
+        default:
+            return '';
+    }
+}
+function normalizePropsWithSchema(props, fields) {
+    const result = {};
+    const knownKeys = new Set();
+    for (const field of fields || []) {
+        const key = field.key;
+        knownKeys.add(key);
+        const current = props[key];
+        if (field.type === 'array' && field.itemSchema) {
+            if (!Array.isArray(current)) {
+                result[key] = [];
+            }
+            else {
+                result[key] = current.map((item) => item && typeof item === 'object'
+                    ? normalizePropsWithSchema(item, field.itemSchema)
+                    : item);
+            }
+        }
+        else if (current === undefined || current === null) {
+            result[key] = getDefaultValue(field);
+        }
+        else {
+            result[key] = current;
+        }
+    }
+    for (const key of Object.keys(props)) {
+        if (!knownKeys.has(key) && !key.startsWith('_')) {
+            result[key] = props[key];
+        }
+    }
+    return result;
+}
+/**
+ * 规范化 goal.json 的 props。
+ */
+export async function writeSafePropsToFile(options) {
+    const { goalPath, write } = options;
+    const raw = JSON.parse(await readFile(path.resolve(goalPath), 'utf-8'));
+    const { composeDeckFromRaw: compose } = await import('@lemonppt/composer');
+    const composed = compose({
+        title: raw.title,
+        goal: raw.goal,
+        audience: raw.audience,
+        owner: raw.owner,
+        theme: raw.theme,
+        language: raw.language,
+        colorScheme: raw.colorScheme,
+        appearance: raw.appearance,
+        pageCount: raw.pageCount,
+        randomSeed: raw.randomSeed,
+        slides: raw.slides.map((s) => ({ role: s.role, layout: s.layout, props: s.props })),
+    });
+    const layoutChanges = [];
+    const unknownFields = [];
+    const safeSlides = composed.slides.map((slide, index) => {
+        const originalLayout = raw.slides[index]?.layout;
+        const registered = getLayout(slide.layout);
+        const schema = registered ? getLayoutSchema(slide.layout) : undefined;
+        if (originalLayout && originalLayout !== slide.layout) {
+            layoutChanges.push({ index: index + 1, from: originalLayout, to: slide.layout });
+        }
+        if (!schema)
+            return { ...slide, props: slide.props };
+        const normalized = normalizePropsWithSchema(slide.props || {}, schema.fields);
+        const unknownKeys = Object.keys(slide.props || {}).filter((k) => !schema.fields.some((f) => f.key === k) && !k.startsWith('_'));
+        if (unknownKeys.length > 0) {
+            unknownFields.push({ index: index + 1, layout: slide.layout, keys: unknownKeys });
+        }
+        return { ...slide, props: normalized };
+    });
+    const safeGoal = { ...composed, slides: safeSlides };
+    const validation = validateDeckGoal(safeGoal);
+    if (write) {
+        await writeFile(path.resolve(goalPath), JSON.stringify(safeGoal, null, 2), 'utf-8');
+    }
+    if (!validation.success) {
+        throw new Error(`goal.json 校验失败: ${JSON.stringify(validation.errors?.format())}`);
+    }
+    return { valid: true, layoutChanges, unknownFields, goal: safeGoal };
+}
+/**
+ * 校验 goal.json 规范。
+ */
+export async function validateGoalSpec(goalPath, strict) {
+    const raw = JSON.parse(await readFile(path.resolve(goalPath), 'utf-8'));
+    const result = {
+        valid: false,
+        errors: [],
+        warnings: [],
+    };
+    const validation = validateDeckGoal(raw);
+    if (!validation.success || !validation.data) {
+        result.errors.push({ type: 'schema', detail: validation.errors?.format() });
+        return result;
+    }
+    const goal = validation.data;
+    const countErrors = validateSlideCount({ pageCount: goal.pageCount, slides: goal.slides });
+    if (countErrors.length > 0) {
+        result.errors.push(...countErrors.map((msg) => ({ type: 'count', detail: msg })));
+    }
+    const contentWarnings = validateDeckGoalContent(goal);
+    if (contentWarnings.length > 0) {
+        if (strict) {
+            result.errors.push(...contentWarnings.map((msg) => ({ type: 'content', detail: msg })));
+        }
+        else {
+            result.warnings.push(...contentWarnings);
+        }
+    }
+    const firstSlide = goal.slides[0];
+    const lastSlide = goal.slides[goal.slides.length - 1];
+    if (firstSlide?.role !== 'cover')
+        result.warnings.push('第一页建议使用 cover 角色');
+    if (lastSlide?.role !== 'closing')
+        result.warnings.push('最后一页建议使用 closing 角色');
+    if (result.errors.length === 0) {
+        result.valid = true;
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemonppt/cli",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,7 +15,8 @@
   },
   "files": [
     "dist",
-    "SKILL.md"
+    "SKILL.md",
+    "agents"
   ],
   "publishConfig": {
     "access": "public"
@@ -30,10 +31,10 @@
   },
   "homepage": "https://github.com/lemonforme/lemonPPT#readme",
   "dependencies": {
-    "@lemonppt/agent-prompts": "0.1.7",
-    "@lemonppt/core": "0.1.7",
-    "@lemonppt/themes": "0.1.7",
-    "@lemonppt/renderer": "0.1.8"
+    "@lemonppt/agent-prompts": "0.2.0",
+    "@lemonppt/renderer": "0.2.0",
+    "@lemonppt/core": "0.2.0",
+    "@lemonppt/themes": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",