html2pptx-local-mcp 1.1.19 → 1.1.21

package/scripts/extract-html2pptx-comments.mjs

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+import { readFile } from 'node:fs/promises';
+import { extname, resolve } from 'node:path';
+import { JSDOM } from 'jsdom';
+
+const ALLOWED_EXTENSIONS = new Set(['.html', '.htm']);
+
+function usage() {
+  return [
+    'Usage: html2pptx-comments <file.html> [--json|--format markdown|--format json]',
+    '',
+    'Extracts edit-slide element comments saved as data-html2pptx-comment attributes.',
+  ].join('\n');
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  let file = '';
+  let format = 'markdown';
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--help' || arg === '-h') {
+      return { help: true, file, format };
+    }
+    if (arg === '--json') {
+      format = 'json';
+      continue;
+    }
+    if (arg === '--format') {
+      const value = args[i + 1];
+      if (!['json', 'markdown'].includes(value)) {
+        throw new Error('--format must be "json" or "markdown".');
+      }
+      format = value;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith('-')) {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+    if (file) {
+      throw new Error(`Unexpected extra file argument: ${arg}`);
+    }
+    file = arg;
+  }
+  return { help: false, file, format };
+}
+
+function cssEscape(value) {
+  return String(value).replace(/[^a-zA-Z0-9_-]/g, (char) => `\\${char}`);
+}
+
+function shortText(value, max = 80) {
+  const text = String(value || '').trim().replace(/\s+/g, ' ');
+  return text.length > max ? `${text.slice(0, max - 1)}...` : text;
+}
+
+function elementLabel(element) {
+  const tag = element.tagName.toLowerCase();
+  const named =
+    element.getAttribute('data-layer-name') ||
+    element.getAttribute('data-name') ||
+    element.getAttribute('aria-label') ||
+    element.getAttribute('alt') ||
+    shortText(element.textContent, 48);
+  return named ? `${tag}: ${named}` : tag;
+}
+
+function cssPath(element, root) {
+  if (!element || element === root) return '';
+  const parts = [];
+  let node = element;
+  while (node && node !== root && node.nodeType === 1) {
+    const tag = node.tagName.toLowerCase();
+    const id = node.getAttribute('id');
+    if (id) {
+      parts.unshift(`${tag}#${cssEscape(id)}`);
+      break;
+    }
+    const className = node.getAttribute('class');
+    const classes = className ? className.split(/\s+/).filter(Boolean).slice(0, 2).map(cssEscape) : [];
+    const classPart = classes.length ? `.${classes.join('.')}` : '';
+    const siblings = Array.from(node.parentElement?.children || []).filter((child) => child.tagName === node.tagName);
+    const indexPart = siblings.length > 1 ? `:nth-of-type(${siblings.indexOf(node) + 1})` : '';
+    parts.unshift(`${tag}${classPart}${indexPart}`);
+    node = node.parentElement;
+  }
+  return parts.join(' > ');
+}
+
+function extractComments(html, filePath) {
+  const dom = new JSDOM(html);
+  const document = dom.window.document;
+  const slides = Array.from(document.querySelectorAll('section.slide'));
+  const commented = Array.from(document.querySelectorAll('[data-html2pptx-comment]'));
+  return commented
+    .map((element, index) => {
+      const comment = shortText(element.getAttribute('data-html2pptx-comment'), 2000);
+      if (!comment) return null;
+      const slideElement = element.closest('section.slide');
+      const slideIndex = slideElement ? slides.indexOf(slideElement) : -1;
+      const root = slideElement || document.body;
+      const selector = element.getAttribute('data-html2pptx-comment-selector') || cssPath(element, root) || '__root__';
+      return {
+        index: index + 1,
+        file: filePath,
+        slide: slideIndex >= 0 ? slideIndex + 1 : null,
+        id: element.getAttribute('data-html2pptx-comment-id') || null,
+        selector,
+        tag: element.tagName.toLowerCase(),
+        label: elementLabel(element),
+        comment,
+        updatedAt: element.getAttribute('data-html2pptx-comment-updated-at') || null,
+      };
+    })
+    .filter(Boolean);
+}
+
+function formatMarkdown(filePath, comments) {
+  if (!comments.length) {
+    return `No html2pptx comments found in ${filePath}.`;
+  }
+  const lines = [
+    `# html2pptx comments`,
+    '',
+    `File: \`${filePath}\``,
+    `Count: ${comments.length}`,
+    '',
+  ];
+  for (const item of comments) {
+    lines.push(
+      `## ${item.index}. ${item.slide ? `Slide ${item.slide}` : 'Document'} / ${item.label}`,
+      '',
+      `- selector: \`${item.selector}\``,
+      item.id ? `- id: \`${item.id}\`` : null,
+      item.updatedAt ? `- updated: ${item.updatedAt}` : null,
+      '',
+      item.comment,
+      '',
+    );
+  }
+  return lines.filter((line) => line !== null).join('\n');
+}
+
+async function main() {
+  const { help, file, format } = parseArgs(process.argv);
+  if (help) {
+    console.log(usage());
+    return;
+  }
+  if (!file) {
+    throw new Error(`Missing file.\n\n${usage()}`);
+  }
+  const filePath = resolve(file);
+  const ext = extname(filePath).toLowerCase();
+  if (!ALLOWED_EXTENSIONS.has(ext)) {
+    throw new Error('Only .html and .htm files are supported.');
+  }
+  const html = await readFile(filePath, 'utf8');
+  const comments = extractComments(html, filePath);
+  if (format === 'json') {
+    console.log(JSON.stringify({ file: filePath, count: comments.length, comments }, null, 2));
+  } else {
+    console.log(formatMarkdown(filePath, comments));
+  }
+}
+
+main().catch((error) => {
+  console.error(error?.message || String(error));
+  process.exitCode = 1;
+});

package/scripts/install-mcp.mjs

@@ -2,7 +2,7 @@
 
 import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 
 const REMOTE_SERVER_NAME = 'html2pptx';
 const LOCAL_SERVER_NAME = 'html2pptx-local';
@@ -13,6 +13,7 @@ const args = process.argv.slice(2);
 const dryRun = args.includes('--dry-run');
 const help = args.includes('--help') || args.includes('-h');
 const client = resolveClient(args);
+const localCommand = buildLocalMcpCommand();
 
 if (help) {
   printHelp();
@@ -20,7 +21,7 @@ if (help) {
 }
 
 if (!client) {
-  console.error('Unknown MCP client. Use one of: claude, codex.');
+  console.error('Unknown MCP client. Use one of: claude, codex, grok.');
   printHelp();
   process.exit(1);
 }
@@ -29,7 +30,7 @@ const steps = buildSteps(client);
 
 console.log(`Installing html2pptx MCP for ${client}.`);
 console.log(`Remote server: ${REMOTE_SERVER_NAME} -> ${REMOTE_MCP_URL}`);
-console.log(`Local server:  ${LOCAL_SERVER_NAME} -> npx -y -p ${LOCAL_PACKAGE_SPEC} html2pptx-mcp`);
+console.log(`Local server:  ${LOCAL_SERVER_NAME} -> ${renderCommand(localCommand.command, localCommand.args)}`);
 console.log('');
 
 for (const step of steps) {
@@ -61,6 +62,7 @@ function resolveClient(argv) {
 function normalizeClient(value) {
   if (value === 'claude' || value === 'claude-code') return 'claude';
   if (value === 'codex') return 'codex';
+  if (value === 'grok' || value === 'grok-build') return 'grok';
   return null;
 }
 
@@ -77,6 +79,29 @@ function buildSteps(targetClient) {
     ];
   }
 
+  if (targetClient === 'grok') {
+    return [
+      {
+        command: 'grok',
+        args: ['mcp', 'add', REMOTE_SERVER_NAME, '--url', REMOTE_MCP_URL],
+      },
+      {
+        command: 'grok',
+        args: [
+          'mcp',
+          'add',
+          LOCAL_SERVER_NAME,
+          '--command',
+          'npx',
+          `--args=--yes`,
+          `--args=--package`,
+          `--args=${LOCAL_PACKAGE_SPEC}`,
+          `--args=html2pptx-mcp`,
+        ],
+      },
+    ];
+  }
+
   return [
     {
       command: 'codex',
@@ -89,11 +114,8 @@ function buildSteps(targetClient) {
         'add',
         LOCAL_SERVER_NAME,
         '--',
-        'npx',
-        '-y',
-        '-p',
-        LOCAL_PACKAGE_SPEC,
-        'html2pptx-mcp',
+        localCommand.command,
+        ...localCommand.args,
       ],
     },
   ];
@@ -103,8 +125,8 @@ function writeClaudeLocalMcpConfig() {
   const configPath = join(process.env.HOME || process.cwd(), '.claude.json');
   const serverConfig = {
     type: 'stdio',
-    command: 'npx',
-    args: ['-y', '-p', LOCAL_PACKAGE_SPEC, 'html2pptx-mcp'],
+    command: localCommand.command,
+    args: localCommand.args,
     env: {},
   };
 
@@ -135,6 +157,27 @@ function writeClaudeLocalMcpConfig() {
   console.log(`Registered local MCP server ${LOCAL_SERVER_NAME} in Claude user config.`);
 }
 
+export function buildLocalMcpCommand(env = process.env) {
+  const npmExecPath = env.npm_execpath || env.npm_execPath;
+  const npxCli = npmExecPath ? join(dirname(npmExecPath), 'npx-cli.js') : '';
+
+  if (npxCli && existsSync(npxCli)) {
+    return {
+      command: process.execPath,
+      args: [npxCli, '--yes', '--package', LOCAL_PACKAGE_SPEC, 'html2pptx-mcp'],
+    };
+  }
+
+  return {
+    command: 'npx',
+    args: ['--yes', '--package', LOCAL_PACKAGE_SPEC, 'html2pptx-mcp'],
+  };
+}
+
+function renderCommand(command, args) {
+  return [command, ...args].join(' ');
+}
+
 function runStep(step) {
   const rendered = [step.command, ...step.args].join(' ');
   console.log(`> ${rendered}`);
@@ -174,13 +217,15 @@ function isAlreadyRegistered(output) {
 function printHelp() {
   console.log(`
 Usage:
-  html2pptx-install-mcp [claude|codex] [--dry-run]
+  html2pptx-install-mcp [claude|codex|grok] [--dry-run]
   html2pptx-install-mcp --client claude
   html2pptx-install-mcp --client codex
+  html2pptx-install-mcp --client grok
 
 Examples:
-  npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude
-  npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp codex
+  npx --yes --package html2pptx-local-mcp@latest html2pptx-install-mcp claude
+  npx --yes --package html2pptx-local-mcp@latest html2pptx-install-mcp codex
+  npx --yes --package html2pptx-local-mcp@latest html2pptx-install-mcp grok
 
 Optional:
   HTML2PPTX_LOCAL_MCP_PACKAGE_SPEC=<package-or-tarball> html2pptx-install-mcp claude

package/scripts/install-skills.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+import { cpSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+const PUBLIC_SKILLS_DIR = join(PACKAGE_ROOT, 'public', 'skills');
+
+const args = process.argv.slice(2);
+const dryRun = args.includes('--dry-run');
+const help = args.includes('--help') || args.includes('-h');
+const client = resolveClient(args);
+
+if (help) {
+  printHelp();
+  process.exit(0);
+}
+
+if (!client) {
+  console.error('Unknown skills client. Use: grok.');
+  printHelp();
+  process.exit(1);
+}
+
+console.log(`Installing html2pptx skills for ${client}.`);
+installGrokSkills();
+console.log('');
+console.log('html2pptx skills setup finished.');
+
+function resolveClient(argv) {
+  const clientFlagIndex = argv.findIndex((value) => value === '--client');
+  if (clientFlagIndex !== -1) {
+    return normalizeClient(argv[clientFlagIndex + 1]);
+  }
+
+  const clientEquals = argv.find((value) => value.startsWith('--client='));
+  if (clientEquals) {
+    return normalizeClient(clientEquals.slice('--client='.length));
+  }
+
+  const positional = argv.find((value) => !value.startsWith('-'));
+  return normalizeClient(positional || 'grok');
+}
+
+function normalizeClient(value) {
+  if (value === 'grok' || value === 'grok-build') return 'grok';
+  return null;
+}
+
+function installGrokSkills() {
+  const targetRoot = join(process.env.HOME || process.cwd(), '.grok', 'skills');
+
+  console.log(`> install Grok skills ${PUBLIC_SKILLS_DIR} -> ${targetRoot}`);
+
+  if (dryRun) return;
+
+  if (!existsSync(PUBLIC_SKILLS_DIR)) {
+    console.error(`Public skills directory not found: ${PUBLIC_SKILLS_DIR}`);
+    process.exit(1);
+  }
+
+  mkdirSync(targetRoot, { recursive: true });
+  cpSync(PUBLIC_SKILLS_DIR, targetRoot, {
+    recursive: true,
+    force: true,
+    errorOnExist: false,
+  });
+  console.log(`Installed html2pptx skills in ${targetRoot}.`);
+}
+
+function printHelp() {
+  console.log(`
+Usage:
+  html2pptx-install-skills [grok] [--dry-run]
+  html2pptx-install-skills --client grok
+
+Examples:
+  npx --yes --package html2pptx-local-mcp@latest html2pptx-install-skills grok
+  npx --yes --package html2pptx-local-mcp@latest html2pptx-install-skills --client grok
+`.trim());
+}