@reftrixmcp/mcp-server 0.1.7

package/dist/services/layout/html-to-jsx-converter.js

@@ -0,0 +1,484 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertHtmlToJsx = convertHtmlToJsx;
+/* global Attr */
+/**
+ * HTML to JSX Converter
+ *
+ * HTMLスニペットをReact JSXコンポーネントに変換する機能を提供します。
+ *
+ * 機能:
+ * - HTML要素 → React JSX要素（自己閉じタグ対応）
+ * - class属性 → className
+ * - for属性 → htmlFor
+ * - style属性（文字列） → styleオブジェクト
+ * - style属性 → TailwindCSSクラス（useTailwindオプション）
+ * - イベントハンドラ属性（onclick等）→ 除去（セキュリティ）
+ * - scriptタグの除去
+ *
+ * @module services/layout/html-to-jsx-converter
+ */
+const jsdom_1 = require("jsdom");
+const style_to_tailwind_mapper_1 = require("./style-to-tailwind-mapper");
+// ==========================================================
+// 定数
+// ==========================================================
+/**
+ * 自己閉じタグ（void elements）
+ * これらの要素は終了タグを持たない
+ */
+const VOID_ELEMENTS = new Set([
+    "area",
+    "base",
+    "br",
+    "col",
+    "embed",
+    "hr",
+    "img",
+    "input",
+    "link",
+    "meta",
+    "param",
+    "source",
+    "track",
+    "wbr",
+]);
+/**
+ * HTMLからJSXへの属性名マッピング
+ */
+const ATTRIBUTE_MAP = {
+    // React DOM属性
+    class: "className",
+    for: "htmlFor",
+    // キャメルケース変換が必要な属性
+    tabindex: "tabIndex",
+    colspan: "colSpan",
+    rowspan: "rowSpan",
+    maxlength: "maxLength",
+    minlength: "minLength",
+    readonly: "readOnly",
+    contenteditable: "contentEditable",
+    autocomplete: "autoComplete",
+    autofocus: "autoFocus",
+    autoplay: "autoPlay",
+    spellcheck: "spellCheck",
+    cellpadding: "cellPadding",
+    cellspacing: "cellSpacing",
+    frameborder: "frameBorder",
+    allowfullscreen: "allowFullScreen",
+    usemap: "useMap",
+    crossorigin: "crossOrigin",
+    datetime: "dateTime",
+    enctype: "encType",
+    formaction: "formAction",
+    formenctype: "formEncType",
+    formmethod: "formMethod",
+    formnovalidate: "formNoValidate",
+    formtarget: "formTarget",
+    hreflang: "hrefLang",
+    inputmode: "inputMode",
+    novalidate: "noValidate",
+    srcset: "srcSet",
+    srcdoc: "srcDoc",
+    srclang: "srcLang",
+    // ハイフン付き属性
+    "accept-charset": "acceptCharset",
+    "http-equiv": "httpEquiv",
+};
+/**
+ * ブール属性（値なしで使用可能）
+ */
+const BOOLEAN_ATTRIBUTES = new Set([
+    "disabled",
+    "checked",
+    "selected",
+    "readonly",
+    "required",
+    "multiple",
+    "autofocus",
+    "autoplay",
+    "controls",
+    "loop",
+    "muted",
+    "open",
+    "hidden",
+    "novalidate",
+    "async",
+    "defer",
+]);
+/**
+ * controlled componentでdefaultValueに変換すべき要素
+ */
+const DEFAULT_VALUE_ELEMENTS = new Set(["input", "textarea", "select"]);
+/**
+ * デフォルトで除去する独自クラス名のプレフィックス
+ *
+ * 各Webビルダー/CMSの独自クラス名パターン:
+ * - dwg-*: 不明なビルダー
+ * - webflow-*: Webflow
+ * - w-*: Webflow（短縮形、w-container, w-nav-menu等）
+ * - framer-*: Framer
+ * - wix-*: Wix
+ * - squarespace-*: Squarespace
+ * - shopify-*: Shopify
+ * - wp-*: WordPress
+ * - elementor-*: Elementor (WordPress plugin)
+ * - divi-*: Divi (WordPress theme)
+ * - beaver-*: Beaver Builder
+ * - et-*: Elegant Themes
+ * - vc-*: Visual Composer
+ * - js-*: 一般的なJS制御用クラス
+ * - is-*: 状態クラス（is-active, is-visible等）
+ * - has-*: 状態クラス（has-dropdown等）
+ */
+const DEFAULT_PROPRIETARY_CLASS_PREFIXES = [
+    "dwg-",
+    "webflow-",
+    "w-",
+    "framer-",
+    "wix-",
+    "squarespace-",
+    "shopify-",
+    "wp-",
+    "elementor-",
+    "divi-",
+    "beaver-",
+    "et-",
+    "vc-",
+    "js-",
+    "is-",
+    "has-",
+];
+// ==========================================================
+// ヘルパー関数
+// ==========================================================
+/**
+ * 独自クラス名を除去する
+ *
+ * @param classString - スペース区切りのクラス名文字列
+ * @param prefixes - 除去するプレフィックスリスト
+ * @returns 独自クラス名を除去した後のクラス名配列
+ */
+function removeProprietaryClasses(classString, prefixes) {
+    if (!classString || classString.trim() === "") {
+        return [];
+    }
+    const classes = classString.split(/\s+/).filter(Boolean);
+    return classes.filter((cls) => {
+        // プレフィックスリストに一致するクラスを除去
+        return !prefixes.some((prefix) => cls.startsWith(prefix));
+    });
+}
+/**
+ * CSSプロパティ名をキャメルケースに変換
+ */
+function cssPropertyToCamelCase(prop) {
+    // ベンダープレフィックス（-webkit-, -moz- など）の処理
+    if (prop.startsWith("-")) {
+        // -webkit-transform → WebkitTransform
+        const withoutLeadingDash = prop.slice(1);
+        const parts = withoutLeadingDash.split("-");
+        return parts
+            .map((part, index) => index === 0
+            ? part.charAt(0).toUpperCase() + part.slice(1)
+            : part.charAt(0).toUpperCase() + part.slice(1))
+            .join("");
+    }
+    // 通常のハイフン付きプロパティ
+    return prop.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * style文字列をパースしてスタイルオブジェクトに変換
+ */
+function parseStyleString(styleString) {
+    if (!styleString || styleString.trim() === "") {
+        return {};
+    }
+    const styles = {};
+    const declarations = styleString.split(";").filter((s) => s.trim());
+    for (const declaration of declarations) {
+        const colonIndex = declaration.indexOf(":");
+        if (colonIndex === -1)
+            continue;
+        const property = declaration.slice(0, colonIndex).trim();
+        const value = declaration.slice(colonIndex + 1).trim();
+        if (!property || !value)
+            continue;
+        const camelCaseProperty = cssPropertyToCamelCase(property);
+        styles[camelCaseProperty] = value;
+    }
+    return styles;
+}
+/**
+ * スタイルオブジェクトをJSX形式の文字列に変換
+ */
+function stylesToJsxString(styles) {
+    if (Object.keys(styles).length === 0) {
+        return "";
+    }
+    const styleEntries = Object.entries(styles)
+        .map(([key, val]) => `${key}: '${val.replace(/'/g, "\\'")}'`)
+        .join(", ");
+    return `style={{${styleEntries}}}`;
+}
+/**
+ * style文字列をJSXスタイルオブジェクト表現に変換
+ */
+function convertStyleToJsx(styleString) {
+    const styles = parseStyleString(styleString);
+    return stylesToJsxString(styles);
+}
+/**
+ * style文字列をTailwindクラスとremainingスタイルに変換
+ */
+function convertStyleToTailwind(styleString) {
+    const styles = parseStyleString(styleString);
+    if (Object.keys(styles).length === 0) {
+        return { tailwindClasses: [], remainingStyleJsx: "" };
+    }
+    const result = (0, style_to_tailwind_mapper_1.mapStyleToTailwind)(styles);
+    return {
+        tailwindClasses: result.tailwindClasses,
+        remainingStyleJsx: stylesToJsxString(result.remainingStyles),
+    };
+}
+/**
+ * 属性名をJSX形式に変換
+ */
+function convertAttributeName(name, tagName) {
+    const lowerName = name.toLowerCase();
+    // イベントハンドラは除去（セキュリティ）
+    if (lowerName.startsWith("on")) {
+        return null;
+    }
+    // マッピングがある場合はそれを使用
+    if (ATTRIBUTE_MAP[lowerName]) {
+        return ATTRIBUTE_MAP[lowerName];
+    }
+    // data-*, aria-*, role はそのまま
+    if (lowerName.startsWith("data-") || lowerName.startsWith("aria-") || lowerName === "role") {
+        return lowerName;
+    }
+    // value属性はcontrolled component要素ではdefaultValueに変換
+    if (lowerName === "value" && DEFAULT_VALUE_ELEMENTS.has(tagName.toLowerCase())) {
+        return "defaultValue";
+    }
+    // checked属性はdefaultCheckedに変換
+    if (lowerName === "checked" && tagName.toLowerCase() === "input") {
+        return "defaultChecked";
+    }
+    // selected属性はdefaultSelectedに変換
+    if (lowerName === "selected" && tagName.toLowerCase() === "option") {
+        return "defaultSelected";
+    }
+    return name;
+}
+/**
+ * 属性をJSX形式に変換（style, class属性は除外）
+ */
+function convertAttributeToJsx(attr, tagName, options) {
+    const name = attr.name.toLowerCase();
+    const value = attr.value;
+    // style属性は別処理（useTailwind対応のため）
+    if (name === "style") {
+        // useTailwindの場合は後で処理するので空を返す
+        if (options.useTailwind) {
+            return "";
+        }
+        const styleJsx = convertStyleToJsx(value);
+        return styleJsx;
+    }
+    // class属性も別処理（useTailwind対応またはremoveProprietaryClasses対応のため）
+    if (name === "class") {
+        // useTailwindの場合は後で処理するので空を返す
+        if (options.useTailwind) {
+            return "";
+        }
+        // 空の属性を除去するオプション
+        if (options.removeEmptyAttributes && value === "") {
+            return "";
+        }
+        // 独自クラス名の除去（removeProprietaryClasses オプションが有効な場合）
+        // useTailwind=falseでも独自クラスを除去できるようにする
+        if (options.removeProprietaryClasses) {
+            const prefixes = options.proprietaryClassPrefixes ?? DEFAULT_PROPRIETARY_CLASS_PREFIXES;
+            const filteredClasses = removeProprietaryClasses(value, prefixes);
+            if (filteredClasses.length === 0) {
+                // すべてのクラスが除去された場合、className属性自体を削除
+                return "";
+            }
+            return `className="${filteredClasses.join(" ")}"`;
+        }
+        return `className="${value}"`;
+    }
+    // 属性名を変換
+    const jsxName = convertAttributeName(name, tagName);
+    if (jsxName === null) {
+        // イベントハンドラなど、除去すべき属性
+        return "";
+    }
+    // 空の属性を除去するオプション
+    if (options.removeEmptyAttributes && value === "") {
+        return "";
+    }
+    // ブール属性の処理
+    if (BOOLEAN_ATTRIBUTES.has(name)) {
+        // 値がない場合、またはtrue相当の場合
+        if (value === "" || value === name || value === "true") {
+            return jsxName;
+        }
+        // falseの場合は属性自体を除去
+        if (value === "false") {
+            return "";
+        }
+    }
+    // 通常の属性
+    return `${jsxName}="${value}"`;
+}
+/**
+ * ノードをJSXに変換
+ */
+function nodeToJsx(node, options, indent = "") {
+    const newLine = options.pretty ? "\n" : "";
+    const childIndent = options.pretty ? indent + "  " : "";
+    // テキストノード
+    if (node.nodeType === 3) {
+        // Node.TEXT_NODE
+        const text = node.textContent || "";
+        // 空白のみのテキストノードは除去（prettyモードでない場合）
+        if (!options.pretty && text.trim() === "") {
+            return "";
+        }
+        return text;
+    }
+    // コメントノード
+    if (node.nodeType === 8) {
+        // Node.COMMENT_NODE
+        if (options.preserveComments) {
+            return `{/* ${node.textContent || ""} */}`;
+        }
+        return "";
+    }
+    // 要素ノード
+    if (node.nodeType === 1) {
+        // Node.ELEMENT_NODE
+        const element = node;
+        const tagName = element.tagName.toLowerCase();
+        // scriptタグは除去
+        if (tagName === "script") {
+            return "";
+        }
+        // 属性を変換
+        const attrs = [];
+        // useTailwindの場合、classとstyleを特別処理
+        if (options.useTailwind) {
+            const existingClass = element.getAttribute("class") || "";
+            const styleAttr = element.getAttribute("style") || "";
+            // Tailwind変換
+            const { tailwindClasses, remainingStyleJsx } = convertStyleToTailwind(styleAttr);
+            // 既存クラスを取得
+            let existingClasses = existingClass.split(/\s+/).filter(Boolean);
+            // 独自クラス名の除去（removeProprietaryClasses オプションが有効な場合）
+            if (options.removeProprietaryClasses) {
+                const prefixes = options.proprietaryClassPrefixes ?? DEFAULT_PROPRIETARY_CLASS_PREFIXES;
+                existingClasses = removeProprietaryClasses(existingClass, prefixes);
+            }
+            // classNameをマージ
+            const allClasses = [...existingClasses, ...tailwindClasses];
+            if (allClasses.length > 0) {
+                attrs.push(`className="${allClasses.join(" ")}"`);
+            }
+            // 残りのstyleがある場合のみ追加
+            if (remainingStyleJsx) {
+                attrs.push(remainingStyleJsx);
+            }
+        }
+        // その他の属性を変換
+        for (const attr of Array.from(element.attributes)) {
+            const jsxAttr = convertAttributeToJsx(attr, tagName, options);
+            if (jsxAttr) {
+                attrs.push(jsxAttr);
+            }
+        }
+        const attrString = attrs.length > 0 ? " " + attrs.join(" ") : "";
+        // 自己閉じタグ
+        if (VOID_ELEMENTS.has(tagName)) {
+            return `${indent}<${tagName}${attrString} />`;
+        }
+        // 子要素を変換
+        const children = Array.from(element.childNodes)
+            .map((child) => nodeToJsx(child, options, childIndent))
+            .filter((s) => s !== "");
+        if (children.length === 0) {
+            return `${indent}<${tagName}${attrString}></${tagName}>`;
+        }
+        const childContent = options.pretty
+            ? newLine + children.join(newLine) + newLine + indent
+            : children.join("");
+        return `${indent}<${tagName}${attrString}>${childContent}</${tagName}>`;
+    }
+    return "";
+}
+// ==========================================================
+// メイン関数
+// ==========================================================
+/**
+ * HTMLをJSXに変換する
+ *
+ * @param html - 変換するHTML文字列
+ * @param options - 変換オプション
+ * @returns 変換されたJSX文字列
+ *
+ * @example
+ * ```typescript
+ * const jsx = convertHtmlToJsx('<div class="container"><p>Hello</p></div>');
+ * // '<div className="container"><p>Hello</p></div>'
+ *
+ * const jsx = convertHtmlToJsx('<img src="image.jpg" alt="Test">');
+ * // '<img src="image.jpg" alt="Test" />'
+ *
+ * const jsx = convertHtmlToJsx('<div style="color: red; font-size: 16px;">Text</div>');
+ * // '<div style={{color: 'red', fontSize: '16px'}}>Text</div>'
+ * ```
+ */
+function convertHtmlToJsx(html, options) {
+    const opts = {
+        preserveComments: false,
+        removeEmptyAttributes: false,
+        pretty: false,
+        wrapInFragment: false,
+        useTailwind: false,
+        removeProprietaryClasses: false,
+        ...options,
+    };
+    // 空の入力は空文字を返す
+    if (!html || html.trim() === "") {
+        return "";
+    }
+    // JSDOMでパース
+    const dom = new jsdom_1.JSDOM(html);
+    const body = dom.window.document.body;
+    // 子ノードを変換
+    const children = Array.from(body.childNodes)
+        .map((node) => nodeToJsx(node, opts, opts.pretty ? "" : ""))
+        .filter((s) => s !== "");
+    // 結果が空の場合
+    if (children.length === 0) {
+        return "";
+    }
+    // 単一のルート要素
+    if (children.length === 1 && !opts.wrapInFragment) {
+        // children[0]は必ず存在する（length === 1 のため）
+        return children[0];
+    }
+    // 複数のルート要素
+    if (opts.wrapInFragment) {
+        const content = opts.pretty ? "\n" + children.join("\n") + "\n" : children.join("");
+        return `<>${content}</>`;
+    }
+    // フラグメントなしの場合は連結して返す
+    return children.join(opts.pretty ? "\n" : "");
+}
+//# sourceMappingURL=html-to-jsx-converter.js.map

package/dist/services/layout/html-to-jsx-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-jsx-converter.js","sourceRoot":"","sources":["../../../src/services/layout/html-to-jsx-converter.ts"],"names":[],"mappings":"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"}

package/dist/services/layout/semantic-html-converter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * セマンティック変換オプション
+ */
+export interface SemanticConversionOptions {
+    /** セクションタイプ（hero, header, footer など） */
+    sectionType: string;
+    /** セクション名（aria-label用、オプション） */
+    sectionName?: string;
+    /** aria-labelを追加するか（デフォルト: true） */
+    addAriaLabel?: boolean;
+    /** 既存のaria-labelを保持するか（デフォルト: false） */
+    preserveExistingAriaLabel?: boolean;
+    /** ルート要素のみ変換するか（デフォルト: true） */
+    convertRootOnly?: boolean;
+}
+/**
+ * sectionTypeからHTML要素名を取得
+ *
+ * @param sectionType - セクションタイプ（例: hero, header, footer）
+ * @returns HTML要素名（例: section, header, footer）
+ *
+ * @example
+ * ```typescript
+ * mapSectionTypeToElement('hero');     // 'section'
+ * mapSectionTypeToElement('header');   // 'header'
+ * mapSectionTypeToElement('footer');   // 'footer'
+ * mapSectionTypeToElement('navigation'); // 'nav'
+ * ```
+ */
+export declare function mapSectionTypeToElement(sectionType: string): string;
+/**
+ * aria-labelを生成
+ *
+ * @param sectionType - セクションタイプ
+ * @param sectionName - セクション名（オプション）
+ * @returns aria-label文字列
+ *
+ * @example
+ * ```typescript
+ * generateAriaLabel('hero', 'Modern Hero Section'); // 'Modern Hero Section'
+ * generateAriaLabel('hero', undefined);             // 'Hero section'
+ * generateAriaLabel('header', undefined);           // 'Site header'
+ * ```
+ */
+export declare function generateAriaLabel(sectionType: string, sectionName: string | undefined): string;
+/**
+ * HTMLをセマンティックHTML要素に変換
+ *
+ * ルートの<div>要素をsectionTypeに応じたセマンティック要素に変換し、
+ * aria-label属性を追加します。
+ *
+ * @param html - 変換対象のHTML文字列
+ * @param options - 変換オプション
+ * @returns 変換されたHTML文字列
+ *
+ * @example
+ * ```typescript
+ * const html = '<div class="hero"><h1>Welcome</h1></div>';
+ * const result = convertToSemanticHtml(html, {
+ *   sectionType: 'hero',
+ *   sectionName: 'Hero Section',
+ * });
+ * // '<section class="hero" aria-label="Hero Section"><h1>Welcome</h1></section>'
+ * ```
+ */
+export declare function convertToSemanticHtml(html: string, options: SemanticConversionOptions): string;
+//# sourceMappingURL=semantic-html-converter.d.ts.map

package/dist/services/layout/semantic-html-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-html-converter.d.ts","sourceRoot":"","sources":["../../../src/services/layout/semantic-html-converter.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2FD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAe9F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAsF9F"}