@ikas/code-components-mcp 1.4.0-beta.22 → 1.4.0-beta.23

package/dist/index.js

@@ -98,16 +98,9 @@ function loadStorefrontTypes() {
     }
     return null;
 }
-const SUBTREE_KINDS = [
-    "children",
-    "components",
-    "sub-components",
-];
+const SUBTREE_KINDS = ["children", "components", "sub-components"];
 function normalizeName(value) {
-    return value
-        .trim()
-        .replace(/^`+|`+$/g, "")
-        .trim();
+    return value.trim().replace(/^`+|`+$/g, "").trim();
 }
 const storefrontData = loadStorefrontData();
 const frameworkData = loadJsonFile("../data/framework.json");
@@ -268,11 +261,7 @@ function searchMigrationTopics(query) {
         const descScore = matchScore(topic.description, query) * 2;
         const contentScore = matchScore(topic.content, query);
         const tagScore = topic.tags.some((t) => matchScore(t, query) > 0) ? 5 : 0;
-        return {
-            key,
-            topic,
-            score: titleScore + descScore + contentScore + tagScore,
-        };
+        return { key, topic, score: titleScore + descScore + contentScore + tagScore };
     })
         .filter((item) => item.score > 0)
         .sort((a, b) => b.score - a.score);
@@ -299,7 +288,7 @@ function analyzeOldTheme(themeJson) {
     parts.push(`> **CRITICAL:** The old system (\`@ikas/storefront\`) and the new code-component system (\`@ikas/bp-storefront\`) are **entirely different packages**. Even when type names look the same (e.g., \`IkasImage\`, \`IkasProduct\`), they are different types with different properties. The prop type systems are also completely separate — old theme.json prop types and new ikas.config.json prop types have different semantics even when names match. **Never assume old-system knowledge applies to the new system.** Always use \`get_type_definition\`, \`get_model_guide\`, and \`get_function_doc\` to look up the correct new-system APIs.\n`);
     parts.push(`## Summary Statistics\n`);
     parts.push(`- **Components:** ${components.length}`);
-    parts.push(`- **Custom Data Definitions:** ${customData.filter((cd) => cd.isRoot).length}`);
+    parts.push(`- **Custom Data Definitions:** ${customData.filter(cd => cd.isRoot).length}`);
     parts.push(`- **Prop Groups:** ${groups.length}`);
     // Component analysis
     parts.push(`\n## Components (${components.length})\n`);
@@ -338,11 +327,7 @@ function analyzeOldTheme(themeJson) {
         const typesSummary = Object.entries(propTypeCounts)
             .map(([t, c]) => `${t}×${c}`)
             .join(", ");
-        const headerFooter = comp.isHeader
-            ? " [HEADER]"
-            : comp.isFooter
-                ? " [FOOTER]"
-                : "";
+        const headerFooter = comp.isHeader ? " [HEADER]" : comp.isFooter ? " [FOOTER]" : "";
         parts.push(`### ${comp.displayName || comp.dir || comp.id}${headerFooter}`);
         parts.push(`- **Dir:** \`${comp.dir || "?"}\` | **Props:** ${props.length} (${typesSummary})`);
         parts.push(`- **Recommended new type:** section`);
@@ -357,7 +342,7 @@ function analyzeOldTheme(themeJson) {
         parts.push("");
     }
     // Custom data analysis
-    const rootCustomData = customData.filter((cd) => cd.isRoot);
+    const rootCustomData = customData.filter(cd => cd.isRoot);
     if (rootCustomData.length > 0) {
         parts.push(`\n## Custom Data Definitions (${rootCustomData.length})\n`);
         for (const cd of rootCustomData) {
@@ -367,9 +352,7 @@ function analyzeOldTheme(themeJson) {
                 const describeNested = (items, indent) => {
                     const lines = [];
                     for (const item of items) {
-                        const key = item.key
-                            ? `\`${item.key}\``
-                            : item.typescriptName || item.name || "unnamed";
+                        const key = item.key ? `\`${item.key}\`` : item.typescriptName || item.name || "unnamed";
                         lines.push(`${indent}- ${key}: ${item.type}${item.isRequired ? " (required)" : ""}`);
                         if (item.nestedData && item.nestedData.length > 0) {
                             lines.push(...describeNested(item.nestedData, indent + "  "));
@@ -381,7 +364,7 @@ function analyzeOldTheme(themeJson) {
                 parts.push(...describeNested(cd.nestedData, "  "));
             }
             if (cd.enumOptions && cd.enumOptions.length > 0) {
-                parts.push(`- **Enum options:** ${cd.enumOptions.map((o) => `"${o.value}"`).join(", ")}`);
+                parts.push(`- **Enum options:** ${cd.enumOptions.map(o => `"${o.value}"`).join(", ")}`);
             }
             // Find which components reference this customData
             const referencingComponents = [];
@@ -463,9 +446,7 @@ function scanSharedSubcomponents(sourceDir) {
     const walk = (dir) => {
         for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
             if (entry.isDirectory()) {
-                if (entry.name === "node_modules" ||
-                    entry.name === "__generated__" ||
-                    entry.name.startsWith("."))
+                if (entry.name === "node_modules" || entry.name === "__generated__" || entry.name.startsWith("."))
                     continue;
                 walk(path.join(dir, entry.name));
             }
@@ -500,14 +481,10 @@ function scanSharedSubcomponents(sourceDir) {
             if (!importPath.startsWith("."))
                 continue;
             // Skip imports of generated types, utils, hooks
-            if (importPath.includes("__generated__") ||
-                importPath.includes("/utils") ||
-                importPath.includes("/hooks"))
+            if (importPath.includes("__generated__") || importPath.includes("/utils") || importPath.includes("/hooks"))
                 continue;
             // Extract base name from path
-            const pathSegments = importPath
-                .split("/")
-                .filter((s) => s && s !== "." && s !== "..");
+            const pathSegments = importPath.split("/").filter(s => s && s !== "." && s !== "..");
             if (pathSegments.length === 0)
                 continue;
             const lastSegment = pathSegments[pathSegments.length - 1];
@@ -518,10 +495,7 @@ function scanSharedSubcomponents(sourceDir) {
                 continue;
             seenInFile.add(key);
             if (!importUsage.has(key)) {
-                importUsage.set(key, {
-                    usingComponents: new Set(),
-                    rawImportPath: importPath,
-                });
+                importUsage.set(key, { usingComponents: new Set(), rawImportPath: importPath });
             }
             importUsage.get(key).usingComponents.add(componentDir);
         }
@@ -530,7 +504,7 @@ function scanSharedSubcomponents(sourceDir) {
     const shared = [];
     for (const [name, { usingComponents, rawImportPath }] of importUsage) {
         // Don't flag the component itself (e.g., Navbar imports from ../Navbar/something)
-        const users = [...usingComponents].filter((c) => c !== name);
+        const users = [...usingComponents].filter(c => c !== name);
         if (users.length >= 3) {
             shared.push({ name, usedBy: users.sort(), importPaths: [rawImportPath] });
         }
@@ -547,7 +521,7 @@ function toKebabCase(s) {
 }
 function classifyComplexity(comp, customDataMap) {
     const props = comp.props || [];
-    const customCount = props.filter((p) => p.type === "CUSTOM").length;
+    const customCount = props.filter(p => p.type === "CUSTOM").length;
     if (customCount === 0 && props.length < 10)
         return "simple";
     // Check for deeply nested CUSTOM (customData referencing another customData)
@@ -558,9 +532,7 @@ function classifyComplexity(comp, customDataMap) {
             if (cd?.nestedData) {
                 const hasNested = (items) => {
                     for (const item of items) {
-                        if (item.type === "DYNAMIC_LIST" ||
-                            item.type === "STATIC_LIST" ||
-                            item.customDataId)
+                        if (item.type === "DYNAMIC_LIST" || item.type === "STATIC_LIST" || item.customDataId)
                             return true;
                         if (item.nestedData && hasNested(item.nestedData))
                             return true;
@@ -592,7 +564,7 @@ function generateMigrationPlan(theme, projectName, oldSourceDir) {
     parts.push(`# Theme Migration Plan — \`${projectName}\``);
     parts.push("");
     parts.push(`**Generated:** ${new Date().toISOString().slice(0, 10)}`);
-    parts.push(`**Source:** ${components.length} old components, ${customData.filter((cd) => cd.isRoot).length} custom data types, ${(theme.pages || []).length} pages`);
+    parts.push(`**Source:** ${components.length} old components, ${customData.filter(cd => cd.isRoot).length} custom data types, ${(theme.pages || []).length} pages`);
     parts.push("");
     parts.push(`> ## READ THIS FIRST`);
     parts.push(`>`);
@@ -682,22 +654,16 @@ function generateMigrationPlan(theme, projectName, oldSourceDir) {
             const cdType = cd.type || "?";
             let shape = "";
             if (cd.type === "ENUM") {
-                const opts = (cd.enumOptions || [])
-                    .map((o) => o.value || o.displayName)
-                    .filter(Boolean);
+                const opts = (cd.enumOptions || []).map((o) => o.value || o.displayName).filter(Boolean);
                 shape = ` — shape: \`enum {${opts.slice(0, 6).join(", ")}${opts.length > 6 ? ", ..." : ""}}\``;
             }
             else if (cd.nestedData && cd.nestedData.length > 0) {
                 const first = cd.nestedData[0];
-                const fields = (first?.nestedData || cd.nestedData || [])
-                    .map((f) => `${f.key || f.name || "?"}: ${f.type || "?"}`)
-                    .slice(0, 8);
+                const fields = (first?.nestedData || cd.nestedData || []).map((f) => `${f.key || f.name || "?"}: ${f.type || "?"}`).slice(0, 8);
                 shape = ` — shape: \`{${fields.join(", ")}}\``;
             }
             const usedBy = cd.id ? usageByCustomDataId.get(cd.id) || [] : [];
-            const usedByStr = usedBy.length > 0
-                ? ` — used by: ${usedBy.slice(0, 6).join(", ")}${usedBy.length > 6 ? `, +${usedBy.length - 6} more` : ""}`
-                : ` — _not directly referenced by any section's props (may be nested inside another customData)_`;
+            const usedByStr = usedBy.length > 0 ? ` — used by: ${usedBy.slice(0, 6).join(", ")}${usedBy.length > 6 ? `, +${usedBy.length - 6} more` : ""}` : ` — _not directly referenced by any section's props (may be nested inside another customData)_`;
             parts.push(`- \`${cdName}\` (${cdType})${shape}${usedByStr}`);
         }
         parts.push("");
@@ -731,11 +697,7 @@ function generateMigrationPlan(theme, projectName, oldSourceDir) {
             const oldName = comp.displayName || comp.dir || comp.id || "Unknown";
             const kebabName = toKebabCase(comp.dir || comp.displayName || comp.id || "unknown");
             const newId = `${projectName}-${kebabName}`;
-            const headerFooter = comp.isHeader
-                ? " **[HEADER]**"
-                : comp.isFooter
-                    ? " **[FOOTER]**"
-                    : "";
+            const headerFooter = comp.isHeader ? " **[HEADER]**" : comp.isFooter ? " **[FOOTER]**" : "";
             const propCount = (comp.props || []).length;
             // Detect children from CUSTOM DYNAMIC_LIST props
             const children = [];
@@ -745,13 +707,8 @@ function generateMigrationPlan(theme, projectName, oldSourceDir) {
                     if (cd && (cd.type === "DYNAMIC_LIST" || cd.type === "STATIC_LIST")) {
                         const itemObj = cd.nestedData?.[0];
                         if (itemObj) {
-                            const childName = itemObj.typescriptName ||
-                                (itemObj.name
-                                    ? itemObj.name.replace(/[^a-zA-Z0-9]/g, "")
-                                    : `${oldName}Item`);
-                            const fields = (itemObj.nestedData || [])
-                                .map((f) => f.key || f.name || "?")
-                                .slice(0, 8);
+                            const childName = itemObj.typescriptName || (itemObj.name ? itemObj.name.replace(/[^a-zA-Z0-9]/g, "") : `${oldName}Item`);
+                            const fields = (itemObj.nestedData || []).map((f) => f.key || f.name || "?").slice(0, 8);
                             children.push({ propName: p.name || "?", childName, fields });
                         }
                     }
@@ -810,25 +767,11 @@ function generateMigrationPlan(theme, projectName, oldSourceDir) {
 }
 // Known libraries we detect in old themes and want to flag for replacement
 const KNOWN_LIBRARIES = [
-    "swiper",
-    "@headlessui/react",
-    "@heroicons/react",
-    "recharts",
-    "react-player",
-    "react-simple-star-rating",
-    "react-slider",
-    "react-compound-slider",
-    "react-zoom-pan-pinch",
-    "react-hot-toast",
-    "react-fast-marquee",
-    "react-indiana-drag-scroll",
-    "react-simple-typewriter",
-    "react-timer-hook",
-    "date-fns",
-    "slugify",
-    "classnames",
-    "clsx",
-    "@react-pdf/renderer",
+    "swiper", "@headlessui/react", "@heroicons/react", "recharts",
+    "react-player", "react-simple-star-rating", "react-slider", "react-compound-slider",
+    "react-zoom-pan-pinch", "react-hot-toast", "react-fast-marquee",
+    "react-indiana-drag-scroll", "react-simple-typewriter", "react-timer-hook",
+    "date-fns", "slugify", "classnames", "clsx", "@react-pdf/renderer",
 ];
 // Heuristic: member-access patterns on old storefront stores/singletons that likely need new-system equivalents
 const OLD_STOREFRONT_CALL_REGEX = /\b(customerStore|cartStore|productStore|categoryStore|orderStore|searchStore|favoritesStore|i18nStore|Router|useStore)\.\w+/g;
@@ -847,8 +790,7 @@ function scanSectionSource(componentDir, propNames) {
     // Collect all .tsx/.ts files in the component dir
     try {
         for (const entry of fs.readdirSync(componentDir, { withFileTypes: true })) {
-            if (entry.isFile() &&
-                (entry.name.endsWith(".tsx") || entry.name.endsWith(".ts"))) {
+            if (entry.isFile() && (entry.name.endsWith(".tsx") || entry.name.endsWith(".ts"))) {
                 result.sourceFiles.push(path.join(componentDir, entry.name));
             }
         }
@@ -865,18 +807,7 @@ function scanSectionSource(componentDir, propNames) {
     const subCompSet = new Map();
     const callSet = new Set();
     // Packages we treat as "framework" and don't flag for replacement (but do note in reactPackageUsage)
-    const REACT_PACKAGES = new Set([
-        "react",
-        "react-dom",
-        "next",
-        "next/link",
-        "next/image",
-        "next/router",
-        "next/head",
-        "next/script",
-        "mobx-react-lite",
-        "mobx",
-    ]);
+    const REACT_PACKAGES = new Set(["react", "react-dom", "next", "next/link", "next/image", "next/router", "next/head", "next/script", "mobx-react-lite", "mobx"]);
     for (const file of result.sourceFiles) {
         let content;
         try {
@@ -890,7 +821,7 @@ function scanSectionSource(componentDir, propNames) {
         while ((m = importRegex.exec(content)) !== null) {
             const p = m[1];
             if (p.startsWith(".")) {
-                const segs = p.split("/").filter((s) => s && s !== "." && s !== "..");
+                const segs = p.split("/").filter(s => s && s !== "." && s !== "..");
                 const last = segs[segs.length - 1];
                 if (last && /^[A-Z]/.test(last) && !last.includes("__generated__")) {
                     subCompSet.set(last, p);
@@ -898,9 +829,7 @@ function scanSectionSource(componentDir, propNames) {
             }
             else if (!p.startsWith("@ikas/")) {
                 // Classify: known library, react-family, or unknown-external
-                const base = p.startsWith("@")
-                    ? p.split("/").slice(0, 2).join("/")
-                    : p.split("/")[0];
+                const base = p.startsWith("@") ? p.split("/").slice(0, 2).join("/") : p.split("/")[0];
                 if (REACT_PACKAGES.has(p) || REACT_PACKAGES.has(base)) {
                     reactSet.add(base);
                 }
@@ -963,10 +892,7 @@ function scanSectionSource(componentDir, propNames) {
             }
         }
     }
-    result.importedSubComponents = [...subCompSet.entries()].map(([name, p]) => ({
-        name,
-        path: p,
-    }));
+    result.importedSubComponents = [...subCompSet.entries()].map(([name, p]) => ({ name, path: p }));
     result.importedLibraries = [...libSet].sort();
     result.importedUnknownLibraries = [...unknownLibSet].sort();
     result.reactPackageUsage = [...reactSet].sort();
@@ -982,38 +908,27 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
             customDataMap.set(cd.id, cd);
     }
     // Find the component — try match by dir, displayName, id, or new-id
-    const target = components.find((c) => {
+    const target = components.find(c => {
         if (!c)
             return false;
-        if (c.dir === sectionName ||
-            c.displayName === sectionName ||
-            c.id === sectionName)
+        if (c.dir === sectionName || c.displayName === sectionName || c.id === sectionName)
             return true;
         const kebab = toKebabCase(c.dir || c.displayName || c.id || "");
         const newId = `${projectName}-${kebab}`;
         return newId === sectionName;
     });
     if (!target) {
-        const available = components
-            .map((c) => c.dir || c.displayName || c.id)
-            .filter(Boolean)
-            .join(", ");
+        const available = components.map(c => c.dir || c.displayName || c.id).filter(Boolean).join(", ");
         return `Section "${sectionName}" not found in theme. Available: ${available}`;
     }
     const parts = [];
     const oldName = target.displayName || target.dir || target.id || "Unknown";
     const kebabName = toKebabCase(target.dir || target.displayName || target.id || "unknown");
     const sectionId = `${projectName}-${kebabName}`;
-    const sectionPascal = (target.dir || target.displayName || "").replace(/[^a-zA-Z0-9]/g, "") ||
-        kebabName
-            .split("-")
-            .map((s) => s[0]?.toUpperCase() + s.slice(1))
-            .join("");
+    const sectionPascal = (target.dir || target.displayName || "").replace(/[^a-zA-Z0-9]/g, "") || kebabName.split("-").map(s => s[0]?.toUpperCase() + s.slice(1)).join("");
     // Scan the old source for imports, libraries, field usage
-    const propNames = (target.props || [])
-        .map((p) => p.name || "")
-        .filter(Boolean);
-    const sourceScan = oldSourceDir && target.dir
+    const propNames = (target.props || []).map(p => p.name || "").filter(Boolean);
+    const sourceScan = (oldSourceDir && target.dir)
         ? scanSectionSource(path.join(oldSourceDir, target.dir), propNames)
         : null;
     parts.push(`# Section Migration Plan: ${oldName}`);
@@ -1059,7 +974,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         }
         if (sourceScan.reactPackageUsage.length > 0) {
             parts.push("");
-            parts.push(`**React/Next.js framework imports detected:** ${sourceScan.reactPackageUsage.map((p) => `\`${p}\``).join(", ")}. These do NOT carry over — the new system is Preact. See \`get_migration_guide("react-to-preact")\` for conversion patterns (hooks, observer, event types, routing).`);
+            parts.push(`**React/Next.js framework imports detected:** ${sourceScan.reactPackageUsage.map(p => `\`${p}\``).join(", ")}. These do NOT carry over — the new system is Preact. See \`get_migration_guide("react-to-preact")\` for conversion patterns (hooks, observer, event types, routing).`);
         }
         if (sourceScan.oldStorefrontCalls.length > 0) {
             parts.push("");
@@ -1105,11 +1020,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         if (oldType === "SLIDER") {
             newType = "NUMBER";
             notes = `Was SLIDER(min=${p.sliderData?.min}, max=${p.sliderData?.max}) — replace \`.value\` access with direct number`;
-            const prop = {
-                name: newName,
-                displayName: p.displayName || newName,
-                type: "NUMBER",
-            };
+            const prop = { name: newName, displayName: p.displayName || newName, type: "NUMBER" };
             if (p.isRequired)
                 prop.required = true;
             parentPropsJson.push(prop);
@@ -1117,11 +1028,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         else if (oldType === "PRODUCT_DETAIL") {
             newType = "PRODUCT";
             notes = "Renamed — PRODUCT_DETAIL → PRODUCT";
-            const prop = {
-                name: newName,
-                displayName: p.displayName || newName,
-                type: "PRODUCT",
-            };
+            const prop = { name: newName, displayName: p.displayName || newName, type: "PRODUCT" };
             if (p.isRequired)
                 prop.required = true;
             parentPropsJson.push(prop);
@@ -1132,10 +1039,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                 if (cd.type === "DYNAMIC_LIST" || cd.type === "STATIC_LIST") {
                     // Child component needed
                     const itemObj = cd.nestedData?.[0];
-                    const childName = itemObj?.typescriptName ||
-                        (itemObj?.name
-                            ? itemObj.name.replace(/[^a-zA-Z0-9]/g, "")
-                            : `${sectionPascal}Item`);
+                    const childName = itemObj?.typescriptName || (itemObj?.name ? itemObj.name.replace(/[^a-zA-Z0-9]/g, "") : `${sectionPascal}Item`);
                     const childProps = [];
                     const nestedWarnings = [];
                     for (const f of (itemObj?.nestedData || [])) {
@@ -1146,18 +1050,11 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                             fType = "NUMBER";
                         else if (fType === "PRODUCT_DETAIL")
                             fType = "PRODUCT";
-                        else if (fType === "CUSTOM" ||
-                            fType === "DYNAMIC_LIST" ||
-                            fType === "STATIC_LIST" ||
-                            fType === "OBJECT") {
+                        else if (fType === "CUSTOM" || fType === "DYNAMIC_LIST" || fType === "STATIC_LIST" || fType === "OBJECT") {
                             nestedWarnings.push(`\`${f.key}\` (${fType})`);
                             fType = "COMPONENT_LIST";
                         }
-                        const prop = {
-                            name: f.key,
-                            displayName: f.name || f.key,
-                            type: fType,
-                        };
+                        const prop = { name: f.key, displayName: f.name || f.key, type: fType };
                         if (f.isRequired)
                             prop.required = true;
                         childProps.push(prop);
@@ -1169,14 +1066,10 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                     if (childProps.length === 0 && sourceScan?.propFieldUsage[oldName]) {
                         const inferred = sourceScan.propFieldUsage[oldName];
                         for (const fieldName of inferred) {
-                            childProps.push({
-                                name: fieldName,
-                                displayName: fieldName,
-                                type: "TEXT",
-                            });
+                            childProps.push({ name: fieldName, displayName: fieldName, type: "TEXT" });
                         }
                         if (inferred.length > 0) {
-                            notes = `Was CUSTOM → ${cd.type} with empty customData. **Inferred props from source usage:** ${inferred.map((f) => `\`${f}\``).join(", ")}. Verify types and required flags — default inferred type is TEXT.`;
+                            notes = `Was CUSTOM → ${cd.type} with empty customData. **Inferred props from source usage:** ${inferred.map(f => `\`${f}\``).join(", ")}. Verify types and required flags — default inferred type is TEXT.`;
                         }
                     }
                     children.push({
@@ -1205,11 +1098,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                             let fType = f.type;
                             if (fType === "SLIDER")
                                 fType = "NUMBER";
-                            const prop = {
-                                name: f.key,
-                                displayName: f.name || f.key,
-                                type: fType,
-                            };
+                            const prop = { name: f.key, displayName: f.name || f.key, type: fType };
                             if (f.isRequired)
                                 prop.required = true;
                             parentPropsJson.push(prop);
@@ -1224,8 +1113,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                 }
                 else if (cd.type === "ENUM") {
                     newType = "ENUM";
-                    const enumName = cd.typescriptName ||
-                        (cd.name ? cd.name.replace(/[^a-zA-Z0-9]/g, "") : "Enum");
+                    const enumName = cd.typescriptName || (cd.name ? cd.name.replace(/[^a-zA-Z0-9]/g, "") : "Enum");
                     const options = (cd.enumOptions || []).reduce((acc, o) => {
                         if (o.displayName && o.value)
                             acc[o.displayName] = o.value;
@@ -1233,12 +1121,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                     }, {});
                     enumsNeeded.push({ name: enumName, options });
                     notes = `Was CUSTOM (ENUM) — create enum \`${enumName}\` via \`config add-enum\` first, then reference its enumId here`;
-                    const prop = {
-                        name: newName,
-                        displayName: p.displayName || newName,
-                        type: "ENUM",
-                        enumTypeId: `<ENUM_ID_FROM_add-enum_${enumName}>`,
-                    };
+                    const prop = { name: newName, displayName: p.displayName || newName, type: "ENUM", enumTypeId: `<ENUM_ID_FROM_add-enum_${enumName}>` };
                     if (p.isRequired)
                         prop.required = true;
                     parentPropsJson.push(prop);
@@ -1247,11 +1130,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         }
         else {
             // Direct mapping
-            const prop = {
-                name: newName,
-                displayName: p.displayName || newName,
-                type: newType,
-            };
+            const prop = { name: newName, displayName: p.displayName || newName, type: newType };
             if (p.isRequired)
                 prop.required = true;
             parentPropsJson.push(prop);
@@ -1260,9 +1139,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
     }
     parts.push("");
     // Custom Data Decision Callouts — per prop referencing a customData type
-    const customDataPropsForCallouts = (target.props || []).filter((p) => p.type === "CUSTOM" &&
-        p.customDataId &&
-        customDataMap.has(p.customDataId));
+    const customDataPropsForCallouts = (target.props || []).filter((p) => p.type === "CUSTOM" && p.customDataId && customDataMap.has(p.customDataId));
     if (customDataPropsForCallouts.length > 0) {
         parts.push(`## Custom Data Decisions to Make`);
         parts.push("");
@@ -1277,9 +1154,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
             let shape = "";
             let shapeKind = "unknown";
             if (cd.type === "ENUM") {
-                const opts = (cd.enumOptions || [])
-                    .map((o) => o.value || o.displayName)
-                    .filter(Boolean);
+                const opts = (cd.enumOptions || []).map((o) => o.value || o.displayName).filter(Boolean);
                 shape = `enum {${opts.slice(0, 6).join(", ")}${opts.length > 6 ? ", ..." : ""}}`;
                 shapeKind = "enum";
             }
@@ -1312,8 +1187,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
             if (shapeKind === "enum") {
                 parts.push(`**Default: enum prop.** Flat scalar set; use \`config add-enum\`.`);
                 parts.push("");
-                const enumName = cd.typescriptName ||
-                    (cd.name ? cd.name.replace(/[^a-zA-Z0-9]/g, "") : "Enum");
+                const enumName = cd.typescriptName || (cd.name ? cd.name.replace(/[^a-zA-Z0-9]/g, "") : "Enum");
                 const enumOptions = (cd.enumOptions || []).reduce((acc, o) => {
                     if (o.displayName && o.value)
                         acc[o.displayName] = o.value;
@@ -1348,10 +1222,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                     parts.push(`> See \`get_migration_guide("component-composition-decision-guide")\` for when \`COMPONENT_LIST\` is overkill.`);
                     parts.push("");
                 }
-                const compName = cd.typescriptName ||
-                    (cd.name
-                        ? cd.name.replace(/[^a-zA-Z0-9]/g, "")
-                        : `${sectionPascal}Item`);
+                const compName = cd.typescriptName || (cd.name ? cd.name.replace(/[^a-zA-Z0-9]/g, "") : `${sectionPascal}Item`);
                 const compPropsForCli = [];
                 for (const f of fieldSource) {
                     if (!f.key)
@@ -1361,11 +1232,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
                         fType = "NUMBER";
                     else if (fType === "PRODUCT_DETAIL")
                         fType = "PRODUCT";
-                    compPropsForCli.push({
-                        name: f.key,
-                        displayName: f.name || f.key,
-                        type: fType,
-                    });
+                    compPropsForCli.push({ name: f.key, displayName: f.name || f.key, type: fType });
                 }
                 parts.push("```bash");
                 if (isMinimal) {
@@ -1404,10 +1271,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
             existing.usedByProps.push(ch.propName);
         }
         else {
-            uniqueChildren.set(ch.childName, {
-                child: ch,
-                usedByProps: [ch.propName],
-            });
+            uniqueChildren.set(ch.childName, { child: ch, usedByProps: [ch.propName] });
         }
     }
     if (uniqueChildren.size > 0) {
@@ -1420,7 +1284,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         for (const { child: ch, usedByProps } of uniqueChildren.values()) {
             parts.push(`### \`${ch.childName}\``);
             const propsLabel = usedByProps.length > 1
-                ? `Used by parent props: ${usedByProps.map((p) => `\`${p}\``).join(", ")} (${usedByProps.length}×)`
+                ? `Used by parent props: ${usedByProps.map(p => `\`${p}\``).join(", ")} (${usedByProps.length}×)`
                 : `For parent prop: \`${usedByProps[0]}\``;
             parts.push(propsLabel);
             parts.push(`Old customData: "${ch.customDataName}"`);
@@ -1466,15 +1330,12 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         parts.push(`- **Every COMPONENT_LIST slot needs a child component to render individual items.** A product list needs a ProductCard child, a blog list needs a BlogCard child, etc. Check if the child already exists (run \`config list\` to see all components and their opaque ids; reuse the existing id in \`filteredComponentIds\`). If not, create it as a registered component and use the \`componentId\` from the CLI's response.`);
     }
     // Check if the section itself has data-driven list props (PRODUCT_LIST, BLOG_LIST, CATEGORY_LIST)
-    const dataListProps = (target.props || []).filter((p) => p.type === "PRODUCT_LIST" ||
-        p.type === "BLOG_LIST" ||
-        p.type === "CATEGORY_LIST" ||
-        p.type === "BRAND_LIST");
+    const dataListProps = (target.props || []).filter(p => p.type === "PRODUCT_LIST" || p.type === "BLOG_LIST" || p.type === "CATEGORY_LIST" || p.type === "BRAND_LIST");
     if (dataListProps.length > 0) {
         parts.push("");
         parts.push(`### Data-Driven List Rendering`);
         parts.push("");
-        parts.push(`This section has data-driven list props: ${dataListProps.map((p) => `\`${p.name}\` (${p.type})`).join(", ")}.`);
+        parts.push(`This section has data-driven list props: ${dataListProps.map(p => `\`${p.name}\` (${p.type})`).join(", ")}.`);
         parts.push(`These are NOT COMPONENT_LIST — the data comes from dynamic queries (filters, categories, search), not hand-picked items. Render items **internally** by mapping over the data:`);
         parts.push("");
         parts.push("```tsx");
@@ -1501,22 +1362,9 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         parts.push(`See \`get_migration_guide("custom-data-conversion")\` → "Two Ways to Render Lists" for the full pattern.`);
     }
     // Detect form-page sections (0 or few props, name suggests a form/auth page)
-    const formKeywords = [
-        "login",
-        "register",
-        "forgot",
-        "recover",
-        "password",
-        "account",
-        "email",
-        "verification",
-        "activate",
-        "contact",
-        "checkout",
-        "address",
-    ];
+    const formKeywords = ["login", "register", "forgot", "recover", "password", "account", "email", "verification", "activate", "contact", "checkout", "address"];
     const lowerDir = (target.dir || "").toLowerCase();
-    const isLikelyFormPage = formKeywords.some((kw) => lowerDir.includes(kw));
+    const isLikelyFormPage = formKeywords.some(kw => lowerDir.includes(kw));
     if (isLikelyFormPage) {
         parts.push("");
         parts.push(`### Form Page Pattern`);
@@ -1545,9 +1393,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
         // Fallback heuristic only when source scan unavailable
         const heuristicLibs = [];
         const lowerName = oldName.toLowerCase();
-        if (lowerName.includes("slider") ||
-            lowerName.includes("carousel") ||
-            lowerName.includes("banner")) {
+        if (lowerName.includes("slider") || lowerName.includes("carousel") || lowerName.includes("banner")) {
             heuristicLibs.push("swiper");
         }
         if (lowerName.includes("marquee"))
@@ -1556,9 +1402,7 @@ function generateSectionMigrationPlan(theme, sectionName, projectName, oldSource
             heuristicLibs.push("react-player");
         if (lowerName.includes("chart"))
             heuristicLibs.push("recharts");
-        if (lowerName.includes("star") ||
-            lowerName.includes("rating") ||
-            lowerName.includes("review"))
+        if (lowerName.includes("star") || lowerName.includes("rating") || lowerName.includes("review"))
             heuristicLibs.push("react-simple-star-rating");
         if (heuristicLibs.length > 0) {
             parts.push(`### Likely Library Replacements (heuristic — source not scanned)`);
@@ -1630,7 +1474,8 @@ function levenshtein(a, b) {
             const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
             curr[j] = Math.min(curr[j - 1] + 1, // insertion
             prev[j] + 1, // deletion
-            prev[j - 1] + cost);
+            prev[j - 1] + cost // substitution
+            );
         }
         for (let j = 0; j <= n; j++)
             prev[j] = curr[j];
@@ -1661,29 +1506,17 @@ function searchFunctions(query) {
     const scored = storefrontData.functions
         .map((fn) => {
         const nameScore = matchScore(fn.name, query) * 3;
-        const displayNameScore = fn.displayName
-            ? matchScore(fn.displayName, query) * 3
-            : 0;
+        const displayNameScore = fn.displayName ? matchScore(fn.displayName, query) * 3 : 0;
         const descScore = matchScore(fn.description, query);
-        const catScore = fn.categories.some((c) => matchScore(c, query) > 0)
-            ? 5
-            : 0;
+        const catScore = fn.categories.some((c) => matchScore(c, query) > 0) ? 5 : 0;
         const paramScore = fn.params.some((p) => matchScore(p.name, query) > 0 || matchScore(p.description, query) > 0)
             ? 2
             : 0;
         const sigScore = matchScore(fn.signature, query) * 2;
-        const typeScore = fn.parameterTypes?.some((t) => matchScore(t, query) > 0)
-            ? 8
-            : 0;
+        const typeScore = fn.parameterTypes?.some((t) => matchScore(t, query) > 0) ? 8 : 0;
         return {
             fn,
-            score: nameScore +
-                displayNameScore +
-                descScore +
-                catScore +
-                paramScore +
-                sigScore +
-                typeScore,
+            score: nameScore + displayNameScore + descScore + catScore + paramScore + sigScore + typeScore,
         };
     })
         .filter((item) => item.score > 0)
@@ -1697,11 +1530,7 @@ function searchFrameworkTopics(query) {
         const descScore = matchScore(topic.description, query) * 2;
         const contentScore = matchScore(topic.content, query);
         const tagScore = topic.tags.some((t) => matchScore(t, query) > 0) ? 5 : 0;
-        return {
-            key,
-            topic,
-            score: titleScore + descScore + contentScore + tagScore,
-        };
+        return { key, topic, score: titleScore + descScore + contentScore + tagScore };
     })
         .filter((item) => item.score > 0)
         .sort((a, b) => b.score - a.score);
@@ -1716,9 +1545,7 @@ function searchTypes(query) {
         const propScore = td.properties?.some((p) => matchScore(p.name, query) > 0 || matchScore(p.type, query) > 0)
             ? 4
             : 0;
-        const enumScore = td.enumValues?.some((v) => matchScore(v, query) > 0)
-            ? 4
-            : 0;
+        const enumScore = td.enumValues?.some((v) => matchScore(v, query) > 0) ? 4 : 0;
         return { td, score: nameScore + domainScore + propScore + enumScore };
     })
         .filter((item) => item.score > 0)
@@ -1760,12 +1587,8 @@ function formatFunctionDoc(fn) {
     return lines.join("\n");
 }
 function formatFunctionSummary(fn) {
-    const desc = fn.description
-        ? fn.description.split(".")[0] + "."
-        : "No description.";
-    const alias = fn.displayName && fn.displayName !== fn.name
-        ? ` (alias: ${fn.displayName})`
-        : "";
+    const desc = fn.description ? fn.description.split(".")[0] + "." : "No description.";
+    const alias = fn.displayName && fn.displayName !== fn.name ? ` (alias: ${fn.displayName})` : "";
     return `- \`${fn.name}\`${alias} - ${desc}`;
 }
 function formatTypeDefinition(td, opts = {}) {
@@ -1806,9 +1629,7 @@ function formatTypeDefinition(td, opts = {}) {
             const fn = storefrontData.functions.find((f) => f.name === fnName);
             if (fn) {
                 const desc = fn.description ? fn.description.split(".")[0] + "." : "";
-                const alias = fn.displayName && fn.displayName !== fn.name
-                    ? ` (alias: ${fn.displayName})`
-                    : "";
+                const alias = fn.displayName && fn.displayName !== fn.name ? ` (alias: ${fn.displayName})` : "";
                 lines.push(`- **\`${fn.name}\`**${alias} — ${desc}`);
                 lines.push(`  \`${fn.signature}\``);
             }
@@ -1817,9 +1638,7 @@ function formatTypeDefinition(td, opts = {}) {
             }
         }
         lines.push("");
-        lines.push('Use `get_functions_for_type("' +
-            td.name +
-            '")` for full documentation of these functions.');
+        lines.push("Use `get_functions_for_type(\"" + td.name + "\")` for full documentation of these functions.");
     }
     return lines.join("\n");
 }
@@ -1837,13 +1656,7 @@ const server = new McpServer({
     name: "ikas-code-components",
     version: "0.1.0",
 }, {
-    instructions: "Examples and section templates from this server are API reference only — reuse imports, function calls, and data-access patterns; create your own JSX structure, CSS class names, and visual design.\n\n" +
-        "Live-editor actions (require `ikas-component dev` running with the editor connected): `list_editor_pages` → page ids; `list_imported_sections` → imported component ids; `import_section` → import a built component; `add_section_to_page` → place a section on a page; `list_page_sections` → the sections already placed on a page, each with its per-placement `elementId`, current `propValues`, and blueprint `props`; `update_section_prop` → change a single prop value of a placed section; `upload_image` → upload an image (file or URL) and get an image id to use in an IMAGE prop value.\n\n" +
-        "To CHANGE/EDIT a prop value (text, color, boolean, number, etc.) of a section that is already on a page, this IS supported: call `list_page_sections(page_id)` to get the placement `elementId` and the prop names/ids, then `update_section_prop(page_id, element_id, prop_name|prop_id, value)`. Do not assume prop editing is unavailable.\n\n" +
-        "TWO DISTINCT JOBS — do not confuse them, and do not jump to writing code for the second one:\n" +
-        "(A) DEFINING props / authoring a component = changing which props a component HAS. This edits the component source/config (types.ts via `ikas-component config add-prop`/`add-component`, JSX in index.tsx, etc.) and requires a rebuild. Use this ONLY when the needed prop does not exist yet, or the user explicitly asks to build/modify the component's code or prop schema.\n" +
-        "(B) SETTING prop VALUES / filling content = giving values to props that ALREADY exist on a section placed on a page. This is pure data entry via `list_page_sections` + `update_section_prop` (and `upload_image` for images). It writes NO code and needs NO rebuild.\n" +
-        "When the user says things like 'fill this section', 'set the heading/title/text/image/link', 'populate', 'change the content/value', or 'enter this data', that is JOB (B): use `update_section_prop`. First call `list_page_sections` and check the existing `props` — if the prop is already there (it usually is), just set its value. Only fall back to JOB (A) if the required prop genuinely does not exist in that section's `props`. Writing a new component or adding a prop to fill in a value the section already supports is the wrong move.",
+    instructions: "Examples and section templates from this server are API reference only — reuse imports, function calls, and data-access patterns; create your own JSX structure, CSS class names, and visual design.",
 });
 // Tool: search_docs
 server.tool("search_docs", "Search across all ikas storefront API docs, framework guides, and migration guides. Returns matching functions, framework topics, and migration topics ranked by relevance.", { query: z.string().describe("Search keyword or phrase") }, async ({ query }) => {
@@ -1884,20 +1697,13 @@ server.tool("search_docs", "Search across all ikas storefront API docs, framewor
         parts.push("");
         parts.push("Use `get_migration_guide(topic)` to get full content for any migration topic.");
     }
-    if (functions.length === 0 &&
-        topics.length === 0 &&
-        types.length === 0 &&
-        migrationTopics.length === 0) {
+    if (functions.length === 0 && topics.length === 0 && types.length === 0 && migrationTopics.length === 0) {
         parts.push(`No results found for "${query}". Try different keywords or use \`list_functions()\` to see all available functions.`);
     }
     return { content: [{ type: "text", text: parts.join("\n") }] };
 });
 // Tool: get_function_doc
-server.tool("get_function_doc", "Get full documentation for a specific storefront API function including signature, parameters, return type, and example.", {
-    name: z
-        .string()
-        .describe("Function name (e.g. 'addItemToCart', 'Router.navigate')"),
-}, async ({ name }) => {
+server.tool("get_function_doc", "Get full documentation for a specific storefront API function including signature, parameters, return type, and example.", { name: z.string().describe("Function name (e.g. 'addItemToCart', 'Router.navigate')") }, async ({ name }) => {
     const nameLower = name.toLowerCase();
     // Phase 1: canonical-name match wins. A real function name always outranks
     // any displayName alias so aliases can never shadow the function they're
@@ -1905,9 +1711,7 @@ server.tool("get_function_doc", "Get full documentation for a specific storefron
     // [BP-DISPLAY-NAME: hasCustomer] alias).
     const byName = storefrontData.functions.find((f) => f.name.toLowerCase() === nameLower);
     if (byName) {
-        return {
-            content: [{ type: "text", text: formatFunctionDoc(byName) }],
-        };
+        return { content: [{ type: "text", text: formatFunctionDoc(byName) }] };
     }
     // Phase 2: fall back to displayName aliases.
     const byAlias = storefrontData.functions.filter((f) => f.displayName && f.displayName.toLowerCase() === nameLower);
@@ -1915,9 +1719,7 @@ server.tool("get_function_doc", "Get full documentation for a specific storefron
         const fn = byAlias[0];
         const note = `> Note: "${name}" is a display alias for \`${fn.name}\`.\n\n`;
         return {
-            content: [
-                { type: "text", text: note + formatFunctionDoc(fn) },
-            ],
+            content: [{ type: "text", text: note + formatFunctionDoc(fn) }],
         };
     }
     if (byAlias.length > 1) {
@@ -1935,9 +1737,7 @@ server.tool("get_function_doc", "Get full documentation for a specific storefron
         (f.displayName && f.displayName.toLowerCase().includes(nameLower)));
     if (matches.length > 0) {
         const suggestions = matches.slice(0, 5).map((f) => {
-            const alias = f.displayName && f.displayName !== f.name
-                ? ` (alias: ${f.displayName})`
-                : "";
+            const alias = f.displayName && f.displayName !== f.name ? ` (alias: ${f.displayName})` : "";
             return `  - ${f.name}${alias}`;
         });
         return {
@@ -1950,12 +1750,7 @@ server.tool("get_function_doc", "Get full documentation for a specific storefron
         };
     }
     return {
-        content: [
-            {
-                type: "text",
-                text: `Function "${name}" not found. Use \`list_functions()\` to see all available functions.`,
-            },
-        ],
+        content: [{ type: "text", text: `Function "${name}" not found. Use \`list_functions()\` to see all available functions.` }],
     };
 });
 // Tool: list_functions
@@ -2005,7 +1800,7 @@ server.tool("list_functions", "List storefront API functions. Without a `categor
         if (uncategorized > 0) {
             lines.push(`- \`Other\` (${uncategorized})`);
         }
-        lines.push("", 'Call `list_functions(category: "<name>")` to see one-line summaries for a category.');
+        lines.push("", "Call `list_functions(category: \"<name>\")` to see one-line summaries for a category.");
         return { content: [{ type: "text", text: lines.join("\n") }] };
     }
     const catLower = category.toLowerCase();
@@ -2037,11 +1832,7 @@ server.tool("list_functions", "List storefront API functions. Without a `categor
     return { content: [{ type: "text", text: parts.join("\n") }] };
 });
 // Tool: get_code_example
-server.tool("get_code_example", "Get an API usage reference for a specific task. Shows correct function calls, imports, and data-handling patterns from a real production theme. The JSX layout and CSS are illustrative only — create your own original visual design. Call `list_examples()` to see available example IDs.", {
-    task: z
-        .string()
-        .describe("Task description or example ID (call `list_examples()` for the full list)"),
-}, async ({ task }) => {
+server.tool("get_code_example", "Get an API usage reference for a specific task. Shows correct function calls, imports, and data-handling patterns from a real production theme. The JSX layout and CSS are illustrative only — create your own original visual design. Call `list_examples()` to see available example IDs.", { task: z.string().describe("Task description or example ID (call `list_examples()` for the full list)") }, async ({ task }) => {
     const taskLower = task.toLowerCase();
     // Try exact ID match first
     let example = storefrontData.codeExamples.find((e) => e.id === taskLower);
@@ -2061,9 +1852,7 @@ server.tool("get_code_example", "Get an API usage reference for a specific task.
         }
     }
     if (!example) {
-        const available = storefrontData.codeExamples
-            .map((e) => `  - \`${e.id}\` - ${e.title}`)
-            .join("\n");
+        const available = storefrontData.codeExamples.map((e) => `  - \`${e.id}\` - ${e.title}`).join("\n");
         return {
             content: [
                 {
@@ -2086,24 +1875,14 @@ server.tool("get_code_example", "Get an API usage reference for a specific task.
     if (example.files && example.files.length > 0) {
         for (const file of example.files) {
             const ext = file.filename.split(".").pop() || "text";
-            const lang = ext === "tsx" || ext === "ts"
-                ? "typescript"
-                : ext === "css"
-                    ? "css"
-                    : ext === "json"
-                        ? "json"
-                        : "text";
+            const lang = ext === "tsx" || ext === "ts" ? "typescript" : ext === "css" ? "css" : ext === "json" ? "json" : "text";
             // Add inline originality comments to CSS and TSX files
             let content = file.content;
             if (ext === "css") {
-                content =
-                    "/* EXAMPLE STYLING — create your own original CSS with different class names and design */\n" +
-                        content;
+                content = "/* EXAMPLE STYLING — create your own original CSS with different class names and design */\n" + content;
             }
             else if (ext === "tsx") {
-                content =
-                    "// EXAMPLE COMPONENT — use the API patterns but create your own JSX structure and layout\n" +
-                        content;
+                content = "// EXAMPLE COMPONENT — use the API patterns but create your own JSX structure and layout\n" + content;
             }
             parts.push(`### ${file.filename}`, "", `\`\`\`${lang}`, content, "```", "");
         }
@@ -2117,88 +1896,63 @@ server.tool("get_code_example", "Get an API usage reference for a specific task.
     return { content: [{ type: "text", text: parts.join("\n") }] };
 });
 // Tool: get_framework_guide
-server.tool("get_framework_guide", "Get a framework guide on a specific topic (e.g. 'ai-workflow', 'common-pitfalls', 'prop-types', 'css-scoping', 'form-handling'). Call `list_topics()` to see all available topic keys.", {
-    topic: z
-        .string()
-        .describe("Topic key or keyword (call `list_topics()` for the full list)"),
-}, async ({ topic }) => {
+server.tool("get_framework_guide", "Get a framework guide on a specific topic (e.g. 'ai-workflow', 'common-pitfalls', 'prop-types', 'css-scoping', 'form-handling'). Call `list_topics()` to see all available topic keys.", { topic: z.string().describe("Topic key or keyword (call `list_topics()` for the full list)") }, async ({ topic }) => {
     const topicLower = topic.toLowerCase().replace(/\s+/g, "-");
     // Alias mapping for common alternative topic names
     const topicAliases = {
         "form-handling": "form-patterns",
-        forms: "form-patterns",
+        "forms": "form-patterns",
         "data-fetching": "async-data-patterns",
-        async: "async-data-patterns",
-        loading: "async-data-patterns",
+        "async": "async-data-patterns",
+        "loading": "async-data-patterns",
         "sub-components": "sub-component-patterns",
-        subcomponents: "sub-component-patterns",
-        routing: "navigation-patterns",
-        router: "navigation-patterns",
-        observer: "component-structure",
-        reactivity: "component-structure",
-        pitfalls: "common-pitfalls",
-        gotchas: "common-pitfalls",
-        mistakes: "common-pitfalls",
-        header: "header-footer-patterns",
-        footer: "header-footer-patterns",
-        blog: "blog-patterns",
-        cart: "cart-patterns",
-        account: "account-patterns",
+        "subcomponents": "sub-component-patterns",
+        "routing": "navigation-patterns",
+        "router": "navigation-patterns",
+        "observer": "component-structure",
+        "reactivity": "component-structure",
+        "pitfalls": "common-pitfalls",
+        "gotchas": "common-pitfalls",
+        "mistakes": "common-pitfalls",
+        "header": "header-footer-patterns",
+        "footer": "header-footer-patterns",
+        "blog": "blog-patterns",
+        "cart": "cart-patterns",
+        "account": "account-patterns",
         "product-detail": "product-detail-patterns",
         "product-list": "product-list-patterns",
-        filtering: "product-list-patterns",
-        reviews: "review-patterns",
-        slider: "slider-overlay-patterns",
-        overlay: "slider-overlay-patterns",
-        modal: "slider-overlay-patterns",
-        architecture: "real-world-architecture",
-        theme: "real-world-architecture",
+        "filtering": "product-list-patterns",
+        "reviews": "review-patterns",
+        "slider": "slider-overlay-patterns",
+        "overlay": "slider-overlay-patterns",
+        "modal": "slider-overlay-patterns",
+        "architecture": "real-world-architecture",
+        "theme": "real-world-architecture",
         "global-styles": "global-css",
-        global: "global-css",
+        "global": "global-css",
         "css-variables": "global-css",
         "custom-properties": "global-css",
     };
     const resolvedTopic = topicAliases[topicLower] || topicLower;
     // Topics that involve MobX store reads get a reminder about root reactivity
     const storeTopics = new Set([
-        "product-detail-patterns",
-        "product-list-patterns",
-        "cart-patterns",
-        "account-patterns",
-        "header-footer-patterns",
-        "review-patterns",
-        "blog-patterns",
-        "form-handling",
-        "async-data-patterns",
-        "component-structure",
-        "imports",
+        "product-detail-patterns", "product-list-patterns", "cart-patterns",
+        "account-patterns", "header-footer-patterns", "review-patterns",
+        "blog-patterns", "form-handling", "async-data-patterns",
+        "component-structure", "imports",
     ]);
     const observerReminder = "> **IMPORTANT: Do NOT use `observer()` on root component exports.** The ikas runtime wraps root renders in MobX `autorun()`, making them automatically reactive. All store reads (`cartStore`, `customerStore`, etc.) in root components are tracked automatically. Only use `observer()` on extracted sub-components.\n\n";
     // Try exact key match (with alias resolution)
     if (frameworkData.topics[resolvedTopic]) {
         const t = frameworkData.topics[resolvedTopic];
         const prefix = storeTopics.has(resolvedTopic) ? observerReminder : "";
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `## ${t.title}\n\n${prefix}${t.content}`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `## ${t.title}\n\n${prefix}${t.content}` }] };
     }
     // Try original topic key (without alias) in case it's a direct key
     if (resolvedTopic !== topicLower && frameworkData.topics[topicLower]) {
         const t = frameworkData.topics[topicLower];
         const prefix = storeTopics.has(topicLower) ? observerReminder : "";
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `## ${t.title}\n\n${prefix}${t.content}`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `## ${t.title}\n\n${prefix}${t.content}` }] };
     }
     // Try keyword search
     const matches = searchFrameworkTopics(topic);
@@ -2206,12 +1960,7 @@ server.tool("get_framework_guide", "Get a framework guide on a specific topic (e
         const best = matches[0];
         const prefix = storeTopics.has(best.key) ? observerReminder : "";
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `## ${best.topic.title}\n\n${prefix}${best.topic.content}`,
-                },
-            ],
+            content: [{ type: "text", text: `## ${best.topic.title}\n\n${prefix}${best.topic.content}` }],
         };
     }
     const available = Object.entries(frameworkData.topics)
@@ -2227,27 +1976,16 @@ server.tool("get_framework_guide", "Get a framework guide on a specific topic (e
     };
 });
 // Tool: get_type_definition
-server.tool("get_type_definition", "Get the full definition of a storefront type or enum by name (e.g. 'IkasProduct', 'IkasOrderStatus'). Shows all properties with types, extends, or enum values.", {
-    name: z
-        .string()
-        .describe("Type or enum name (e.g. 'IkasProduct', 'IkasOrderStatus')"),
-}, async ({ name }) => {
+server.tool("get_type_definition", "Get the full definition of a storefront type or enum by name (e.g. 'IkasProduct', 'IkasOrderStatus'). Shows all properties with types, extends, or enum values.", { name: z.string().describe("Type or enum name (e.g. 'IkasProduct', 'IkasOrderStatus')") }, async ({ name }) => {
     if (!typesData) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first.",
-                },
-            ],
+            content: [{ type: "text", text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first." }],
         };
     }
     const nameLower = name.toLowerCase();
     const td = typesData.types.find((t) => t.name.toLowerCase() === nameLower);
     if (td) {
-        return {
-            content: [{ type: "text", text: formatTypeDefinition(td) }],
-        };
+        return { content: [{ type: "text", text: formatTypeDefinition(td) }] };
     }
     // Fuzzy match
     const matches = typesData.types.filter((t) => t.name.toLowerCase().includes(nameLower));
@@ -2263,28 +2001,14 @@ server.tool("get_type_definition", "Get the full definition of a storefront type
         };
     }
     return {
-        content: [
-            {
-                type: "text",
-                text: `Type "${name}" not found. Use \`list_types()\` to see all available types.`,
-            },
-        ],
+        content: [{ type: "text", text: `Type "${name}" not found. Use \`list_types()\` to see all available types.` }],
     };
 });
 // Tool: get_functions_for_type
-server.tool("get_functions_for_type", "Get full documentation for all utility functions that operate on a given storefront type. For example, get_functions_for_type('IkasImage') returns getSrc, getDefaultSrc, getThumbnailSrc, createMediaSrcset with full signatures, descriptions, and examples.", {
-    typeName: z
-        .string()
-        .describe("Type name (e.g. 'IkasImage', 'IkasProduct', 'IkasOrder')"),
-}, async ({ typeName }) => {
+server.tool("get_functions_for_type", "Get full documentation for all utility functions that operate on a given storefront type. For example, get_functions_for_type('IkasImage') returns getSrc, getDefaultSrc, getThumbnailSrc, createMediaSrcset with full signatures, descriptions, and examples.", { typeName: z.string().describe("Type name (e.g. 'IkasImage', 'IkasProduct', 'IkasOrder')") }, async ({ typeName }) => {
     if (!typesData) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first.",
-                },
-            ],
+            content: [{ type: "text", text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first." }],
         };
     }
     const nameLower = typeName.toLowerCase();
@@ -2304,12 +2028,7 @@ server.tool("get_functions_for_type", "Get full documentation for all utility fu
             };
         }
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Type "${typeName}" not found. Use \`list_types()\` to see all available types.`,
-                },
-            ],
+            content: [{ type: "text", text: `Type "${typeName}" not found. Use \`list_types()\` to see all available types.` }],
         };
     }
     if (!td.relatedFunctions || td.relatedFunctions.length === 0) {
@@ -2340,10 +2059,7 @@ server.tool("get_functions_for_type", "Get full documentation for all utility fu
 });
 // Tool: get_model_guide
 server.tool("get_model_guide", "Get an overview of a storefront model type. By default returns the type definition, related function names with one-line summaries, matching example titles/IDs, and related type summaries. Pass `mode: 'full'` to inline full function docs and example code.", {
-    model: z
-        .string()
-        .optional()
-        .describe("Model type name (e.g. 'IkasImage', 'IkasProduct', 'IkasOrder')"),
+    model: z.string().optional().describe("Model type name (e.g. 'IkasImage', 'IkasProduct', 'IkasOrder')"),
     name: z.string().optional().describe("Alias for 'model'"),
     mode: z
         .enum(["summary", "full"])
@@ -2354,22 +2070,12 @@ server.tool("get_model_guide", "Get an overview of a storefront model type. By d
     const model = modelParam || nameParam;
     if (!model) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: "Please provide a model name (e.g. 'IkasProduct', 'IkasOrder'). Use the 'model' or 'name' parameter.",
-                },
-            ],
+            content: [{ type: "text", text: "Please provide a model name (e.g. 'IkasProduct', 'IkasOrder'). Use the 'model' or 'name' parameter." }],
         };
     }
     if (!typesData) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first.",
-                },
-            ],
+            content: [{ type: "text", text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first." }],
         };
     }
     const modelLower = model.toLowerCase();
@@ -2391,12 +2097,7 @@ server.tool("get_model_guide", "Get an overview of a storefront model type. By d
             };
         }
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Model "${model}" not found. Use \`list_types()\` to see all available types.`,
-                },
-            ],
+            content: [{ type: "text", text: `Model "${model}" not found. Use \`list_types()\` to see all available types.` }],
         };
     }
     const parts = [`# Model Guide: ${td.name}\n`];
@@ -2504,23 +2205,13 @@ server.tool("get_model_guide", "Get an overview of a storefront model type. By d
 server.tool("search_types", "Search storefront types and enums by keyword (e.g. 'price', 'address', 'status'). Returns top matches ranked by relevance.", { query: z.string().describe("Search keyword or phrase") }, async ({ query }) => {
     if (!typesData) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first.",
-                },
-            ],
+            content: [{ type: "text", text: "Type data not available. Run 'npm run docs:generate' in storefront-docs first." }],
         };
     }
     const results = searchTypes(query).slice(0, 15);
     if (results.length === 0) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `No types found matching "${query}". Use \`list_types()\` to see all available types.`,
-                },
-            ],
+            content: [{ type: "text", text: `No types found matching "${query}". Use \`list_types()\` to see all available types.` }],
         };
     }
     const parts = [`## Type Search Results for "${query}"\n`];
@@ -2584,7 +2275,7 @@ server.tool("list_types", "List storefront types and enums. Use `domain` and/or
         for (const [d, count] of sorted) {
             lines.push(`- \`${d}\` (${count})`);
         }
-        lines.push("", 'Call `list_types(domain: "<name>")` to see summaries for a domain.');
+        lines.push("", "Call `list_types(domain: \"<name>\")` to see summaries for a domain.");
         return { content: [{ type: "text", text: lines.join("\n") }] };
     }
     const domainLower = domain.toLowerCase();
@@ -2623,25 +2314,15 @@ server.tool("list_types", "List storefront types and enums. Use `domain` and/or
     return { content: [{ type: "text", text: parts.join("\n") }] };
 });
 // Tool: get_prop_types
-server.tool("get_prop_types", "Get all available ikas.config.json prop types with descriptions, TypeScript types, and examples. NOTE: these are the TypeScript prop-definition types for authoring a component — they are NOT the runtime JSON value shapes you write via `update_section_prop` (e.g. a TEXT prop is typed `string` here but written as `{ \"value\": \"...\" }`, and an IMAGE is `IkasImage | null` here but written as `{ \"id\": \"...\" }`). For the value shapes to pass to `update_section_prop`, see that tool's description. Tip: Use `npx ikas-component config add-component --props '[...]'` to create a component with all props in one command, or `add-prop` to add props incrementally. NEVER manually edit types.ts — it is auto-generated by the CLI.", {}, async () => {
+server.tool("get_prop_types", "Get all available ikas.config.json prop types with descriptions, TypeScript types, and examples. Tip: Use `npx ikas-component config add-component --props '[...]'` to create a component with all props in one command, or `add-prop` to add props incrementally. NEVER manually edit types.ts — it is auto-generated by the CLI.", {}, async () => {
     const propTypesTopic = frameworkData.topics["prop-types"];
     if (propTypesTopic) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `## ${propTypesTopic.title}\n\n${propTypesTopic.content}`,
-                },
-            ],
+            content: [{ type: "text", text: `## ${propTypesTopic.title}\n\n${propTypesTopic.content}` }],
         };
     }
     return {
-        content: [
-            {
-                type: "text",
-                text: "Prop types documentation not available.",
-            },
-        ],
+        content: [{ type: "text", text: "Prop types documentation not available." }],
     };
 });
 // Tool: get_section_template
@@ -2738,8 +2419,7 @@ server.tool("get_section_template", "Get the root files of a starter section tem
     // the end of the response in the existing recipe-builder block.
     {
         const snippetStrForBanner = bundle.rootFiles["ikas-config-snippet.json"];
-        if (snippetStrForBanner &&
-            /<id-of-[A-Za-z0-9_]+>/.test(snippetStrForBanner)) {
+        if (snippetStrForBanner && /<id-of-[A-Za-z0-9_]+>/.test(snippetStrForBanner)) {
             const childMatches = Array.from(snippetStrForBanner.matchAll(/<id-of-([A-Za-z0-9_]+)>/g));
             const uniqueChildren = Array.from(new Set(childMatches.map((m) => m[1])));
             parts.push(`> 🔧 **CONTAINER SECTION — required wiring.** This template hosts ${uniqueChildren.length} child component${uniqueChildren.length === 1 ? "" : "s"} (${uniqueChildren.map((n) => `\`${n}\``).join(", ")}) via a \`COMPONENT_LIST\` slot. Creating the parent alone produces an empty, unusable section. **You MUST follow the full Setup Recipe below**: create each child → capture its \`componentId\` → wire them into the parent's \`filteredComponentIds\` with \`config update-prop\`. Component ids are opaque random strings (e.g. \`7ojrigep-Eml9n5sN3i\`) — they cannot be derived from names, and the CLI rejects unknown ids.`, "");
@@ -2863,10 +2543,7 @@ server.tool("get_section_template", "Get the root files of a starter section tem
                     try {
                         const childSnippet = JSON.parse(fs.readFileSync(childSnippetPath, "utf-8"));
                         const childProps = (childSnippet.props || []).map((p) => {
-                            const out = {
-                                name: p.name,
-                                type: p.type,
-                            };
+                            const out = { name: p.name, type: p.type };
                             if (p.displayName)
                                 out.displayName = p.displayName;
                             if (p.required)
@@ -2939,7 +2616,10 @@ server.tool("get_section_child", "Fetch one item's files from a section's childr
         .string()
         .optional()
         .describe("The item name as listed in `get_section_template`'s response (Children/Components/Sub-components)"),
-    child: z.string().optional().describe("Alias for `name`"),
+    child: z
+        .string()
+        .optional()
+        .describe("Alias for `name`"),
     kind: z
         .enum(["children", "components", "sub-components"])
         .optional()
@@ -3102,11 +2782,7 @@ server.tool("list_section_types", "List all available `get_section_template` sec
 });
 // --- Migration tools ---
 // Tool: analyze_old_theme
-server.tool("analyze_old_theme", "Analyze an old ikas storefront theme.json and produce a structured migration report. Shows all components, custom data definitions, prop type breakdown, and migration recommendations. Use this as the first step when converting an old theme.", {
-    theme_json: z
-        .string()
-        .describe("The raw JSON content of the old theme.json file"),
-}, async ({ theme_json }) => {
+server.tool("analyze_old_theme", "Analyze an old ikas storefront theme.json and produce a structured migration report. Shows all components, custom data definitions, prop type breakdown, and migration recommendations. Use this as the first step when converting an old theme.", { theme_json: z.string().describe("The raw JSON content of the old theme.json file") }, async ({ theme_json }) => {
     try {
         const parsed = JSON.parse(theme_json);
         const analysis = analyzeOldTheme(parsed);
@@ -3114,162 +2790,102 @@ server.tool("analyze_old_theme", "Analyze an old ikas storefront theme.json and
     }
     catch (err) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error parsing theme.json: ${err instanceof Error ? err.message : String(err)}. Make sure you're passing valid JSON.`,
-                },
-            ],
+            content: [{ type: "text", text: `Error parsing theme.json: ${err instanceof Error ? err.message : String(err)}. Make sure you're passing valid JSON.` }],
         };
     }
 });
 // Tool: get_migration_guide
 const migrationTopicAliases = {
-    overview: "migration-overview",
-    migrate: "migration-overview",
-    custom: "custom-data-conversion",
+    "overview": "migration-overview",
+    "migrate": "migration-overview",
+    "custom": "custom-data-conversion",
     "custom-data": "custom-data-conversion",
-    customdata: "custom-data-conversion",
+    "customdata": "custom-data-conversion",
     "dynamic-list": "custom-data-conversion",
     "component-list": "custom-data-conversion",
-    slider: "prop-type-mapping",
-    props: "prop-type-mapping",
+    "slider": "prop-type-mapping",
+    "props": "prop-type-mapping",
     "prop-mapping": "prop-type-mapping",
-    types: "prop-type-mapping",
-    react: "react-to-preact",
-    preact: "react-to-preact",
-    observer: "react-to-preact",
-    libraries: "library-replacements",
-    swiper: "library-replacements",
-    headlessui: "library-replacements",
-    tailwind: "library-replacements",
-    tailwindcss: "library-replacements",
-    recharts: "library-replacements",
-    marquee: "library-replacements",
-    imports: "storefront-import-mapping",
-    storefront: "storefront-import-mapping",
+    "types": "prop-type-mapping",
+    "react": "react-to-preact",
+    "preact": "react-to-preact",
+    "observer": "react-to-preact",
+    "libraries": "library-replacements",
+    "swiper": "library-replacements",
+    "headlessui": "library-replacements",
+    "tailwind": "library-replacements",
+    "tailwindcss": "library-replacements",
+    "recharts": "library-replacements",
+    "marquee": "library-replacements",
+    "imports": "storefront-import-mapping",
+    "storefront": "storefront-import-mapping",
     "bp-storefront": "storefront-import-mapping",
     "theme-json": "theme-json-anatomy",
-    anatomy: "theme-json-anatomy",
-    decompose: "component-decomposition-strategy",
-    decomposition: "component-decomposition-strategy",
-    strategy: "component-decomposition-strategy",
-    project: "complete-project-generation",
-    generate: "complete-project-generation",
-    generation: "complete-project-generation",
-    settings: "settings-conversion",
-    colors: "settings-conversion",
-    fonts: "settings-conversion",
-    find: "finding-new-system-equivalents",
-    search: "finding-new-system-equivalents",
-    discover: "finding-new-system-equivalents",
-    equivalent: "finding-new-system-equivalents",
-    equivalents: "finding-new-system-equivalents",
-    replacement: "finding-new-system-equivalents",
+    "anatomy": "theme-json-anatomy",
+    "decompose": "component-decomposition-strategy",
+    "decomposition": "component-decomposition-strategy",
+    "strategy": "component-decomposition-strategy",
+    "project": "complete-project-generation",
+    "generate": "complete-project-generation",
+    "generation": "complete-project-generation",
+    "settings": "settings-conversion",
+    "colors": "settings-conversion",
+    "fonts": "settings-conversion",
+    "find": "finding-new-system-equivalents",
+    "search": "finding-new-system-equivalents",
+    "discover": "finding-new-system-equivalents",
+    "equivalent": "finding-new-system-equivalents",
+    "equivalents": "finding-new-system-equivalents",
+    "replacement": "finding-new-system-equivalents",
 };
 const migrationTopicKeys = migrationData
     ? Object.keys(migrationData.topics)
     : [];
-server.tool("get_migration_guide", `Get a migration guide for converting old ikas themes to the new code-component system. **Start with \`get_migration_guide("iterative-workflow")\` if you're new to this MCP** — it explains the MCP-vs-LLM responsibility split and the four phases.${migrationTopicKeys.length > 0 ? ` Available topics: ${migrationTopicKeys.join(", ")}. Also supports aliases like "custom", "slider", "react", "libraries", "imports", "settings".` : ""} Call with topic "list" to see all available topics.`, {
-    topic: z
-        .string()
-        .describe("Migration topic key, alias, or 'list' to see all topics"),
-}, async ({ topic }) => {
+server.tool("get_migration_guide", `Get a migration guide for converting old ikas themes to the new code-component system. **Start with \`get_migration_guide("iterative-workflow")\` if you're new to this MCP** — it explains the MCP-vs-LLM responsibility split and the four phases.${migrationTopicKeys.length > 0 ? ` Available topics: ${migrationTopicKeys.join(", ")}. Also supports aliases like "custom", "slider", "react", "libraries", "imports", "settings".` : ""} Call with topic "list" to see all available topics.`, { topic: z.string().describe("Migration topic key, alias, or 'list' to see all topics") }, async ({ topic }) => {
     if (!migrationData) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "Migration data not available. Ensure data/migration.json exists.",
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: "Migration data not available. Ensure data/migration.json exists." }] };
     }
     if (topic.toLowerCase() === "list") {
         const available = Object.entries(migrationData.topics)
             .map(([key, t]) => `- \`${key}\` — ${t.title}: ${t.description}`)
             .join("\n");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `## Available Migration Topics\n\n${available}`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `## Available Migration Topics\n\n${available}` }] };
     }
     const topicLower = topic.toLowerCase().replace(/\s+/g, "-");
     const resolvedTopic = migrationTopicAliases[topicLower] || topicLower;
     if (migrationData.topics[resolvedTopic]) {
         const t = migrationData.topics[resolvedTopic];
-        return {
-            content: [
-                { type: "text", text: `## ${t.title}\n\n${t.content}` },
-            ],
-        };
+        return { content: [{ type: "text", text: `## ${t.title}\n\n${t.content}` }] };
     }
     // Try original key
     if (resolvedTopic !== topicLower && migrationData.topics[topicLower]) {
         const t = migrationData.topics[topicLower];
-        return {
-            content: [
-                { type: "text", text: `## ${t.title}\n\n${t.content}` },
-            ],
-        };
+        return { content: [{ type: "text", text: `## ${t.title}\n\n${t.content}` }] };
     }
     // Keyword search
     const matches = searchMigrationTopics(topic);
     if (matches.length > 0) {
         const best = matches[0];
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `## ${best.topic.title}\n\n${best.topic.content}`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `## ${best.topic.title}\n\n${best.topic.content}` }] };
     }
     const available = Object.entries(migrationData.topics)
         .map(([key, t]) => `  - \`${key}\` - ${t.title}`)
         .join("\n");
     return {
-        content: [
-            {
-                type: "text",
-                text: `Migration topic "${topic}" not found. Available topics:\n${available}`,
-            },
-        ],
+        content: [{ type: "text", text: `Migration topic "${topic}" not found. Available topics:\n${available}` }],
     };
 });
 // Tool: get_migration_example
-server.tool("get_migration_example", `Get a concrete before/after migration example showing how to convert an old theme component to the new code-component system.${migrationExampleNames.length > 0 ? ` Available examples: ${migrationExampleNames.join(", ")}.` : ""} Call with example "list" to see all examples.`, {
-    example: z.string().describe("Example name or 'list' to see all examples"),
-}, async ({ example }) => {
+server.tool("get_migration_example", `Get a concrete before/after migration example showing how to convert an old theme component to the new code-component system.${migrationExampleNames.length > 0 ? ` Available examples: ${migrationExampleNames.join(", ")}.` : ""} Call with example "list" to see all examples.`, { example: z.string().describe("Example name or 'list' to see all examples") }, async ({ example }) => {
     if (example.toLowerCase() === "list") {
         if (migrationExampleNames.length === 0) {
-            return {
-                content: [
-                    { type: "text", text: "No migration examples available." },
-                ],
-            };
+            return { content: [{ type: "text", text: "No migration examples available." }] };
         }
-        const list = migrationExampleNames
-            .map((name) => {
+        const list = migrationExampleNames.map((name) => {
             const ex = loadMigrationExample(name);
-            return ex
-                ? `- \`${name}\` — ${ex.title}: ${ex.description}`
-                : `- \`${name}\``;
-        })
-            .join("\n");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `## Available Migration Examples\n\n${list}`,
-                },
-            ],
-        };
+            return ex ? `- \`${name}\` — ${ex.title}: ${ex.description}` : `- \`${name}\``;
+        }).join("\n");
+        return { content: [{ type: "text", text: `## Available Migration Examples\n\n${list}` }] };
     }
     const exampleLower = example.toLowerCase();
     let exName = migrationExampleNames.find((n) => n === exampleLower);
@@ -3279,26 +2895,19 @@ server.tool("get_migration_example", `Get a concrete before/after migration exam
     if (!exName) {
         const available = migrationExampleNames.join(", ");
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Migration example "${example}" not found. Available: ${available}`,
-                },
-            ],
+            content: [{ type: "text", text: `Migration example "${example}" not found. Available: ${available}` }],
         };
     }
     const ex = loadMigrationExample(exName);
     if (!ex) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to load migration example "${exName}".`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `Failed to load migration example "${exName}".` }] };
     }
-    const parts = [`## ${ex.title}`, "", ex.description, ""];
+    const parts = [
+        `## ${ex.title}`,
+        "",
+        ex.description,
+        "",
+    ];
     for (const [filename, content] of Object.entries(ex.files)) {
         const ext = filename.split(".").pop() || "text";
         const lang = ext === "tsx" || ext === "ts"
@@ -3317,31 +2926,13 @@ server.tool("get_migration_example", `Get a concrete before/after migration exam
 });
 // Tool: plan_migration
 server.tool("plan_migration", "Generate the **initial** migration plan and (when `project_root` is provided) write it to <project_root>/MIGRATION.md. **This is the only time the MCP writes that file.** From here, you own it: tick checkboxes as you finish work, log custom-data decisions, scan the old source for atomic components (Button, Input, Card, etc.) that theme.json doesn't see, and append them to MIGRATION.md yourself. theme.json is incomplete by design — the MCP can only describe what's listed there. Pass `theme_json_path` for large themes (raw `theme_json` string is supported for backward compat but fails on real-world sizes).", {
-    theme_json: z
-        .string()
-        .optional()
-        .describe("Raw JSON content of the old theme.json. EITHER this OR theme_json_path is required (not both). For real themes use theme_json_path — raw strings exceed tool/context limits at production sizes."),
-    theme_json_path: z
-        .string()
-        .optional()
-        .describe("Absolute path to the old theme.json file on disk. Preferred for any real-world theme."),
-    project_name: z
-        .string()
-        .optional()
-        .describe("Target new project name, used to prefix migration-tracking IDs (default: 'my-theme')"),
-    old_source_dir: z
-        .string()
-        .optional()
-        .describe("Absolute path to the old project's src/ directory. When provided, the tool scans .tsx files to detect shared sub-components used across 3+ components. This scan is partial — atomic components used by only 1-2 sections will be missed and must be added by the LLM."),
-    project_root: z
-        .string()
-        .optional()
-        .describe("Absolute path to the new project root. When provided, the MCP writes MIGRATION.md to <project_root>/MIGRATION.md and returns a short summary instead of the full markdown body."),
-    overwrite: z
-        .boolean()
-        .optional()
-        .describe("If MIGRATION.md already exists at <project_root>/MIGRATION.md and is non-empty, refuse the write unless this is true. Default: false."),
-}, async ({ theme_json, theme_json_path, project_name, old_source_dir, project_root, overwrite, }) => {
+    theme_json: z.string().optional().describe("Raw JSON content of the old theme.json. EITHER this OR theme_json_path is required (not both). For real themes use theme_json_path — raw strings exceed tool/context limits at production sizes."),
+    theme_json_path: z.string().optional().describe("Absolute path to the old theme.json file on disk. Preferred for any real-world theme."),
+    project_name: z.string().optional().describe("Target new project name, used to prefix migration-tracking IDs (default: 'my-theme')"),
+    old_source_dir: z.string().optional().describe("Absolute path to the old project's src/ directory. When provided, the tool scans .tsx files to detect shared sub-components used across 3+ components. This scan is partial — atomic components used by only 1-2 sections will be missed and must be added by the LLM."),
+    project_root: z.string().optional().describe("Absolute path to the new project root. When provided, the MCP writes MIGRATION.md to <project_root>/MIGRATION.md and returns a short summary instead of the full markdown body."),
+    overwrite: z.boolean().optional().describe("If MIGRATION.md already exists at <project_root>/MIGRATION.md and is non-empty, refuse the write unless this is true. Default: false."),
+}, async ({ theme_json, theme_json_path, project_name, old_source_dir, project_root, overwrite }) => {
     try {
         const parsed = resolveThemeJson(theme_json, theme_json_path);
         const projectName = project_name || "my-theme";
@@ -3402,37 +2993,18 @@ server.tool("plan_migration", "Generate the **initial** migration plan and (when
     }
     catch (err) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error: ${err instanceof Error ? err.message : String(err)}`,
-                },
-            ],
+            content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
         };
     }
 });
 // Tool: get_section_migration_plan
 server.tool("get_section_migration_plan", "Returns concrete CLI commands and prop conversions for one section. For each prop that references a customData type, you'll see a 'Decide: enum or component?' callout — log your decision in MIGRATION.md under `## Custom Data Decisions`. Pass `theme_json_path` for large themes.", {
-    theme_json: z
-        .string()
-        .optional()
-        .describe("Raw JSON content of the old theme.json. EITHER this OR theme_json_path is required (not both)."),
-    theme_json_path: z
-        .string()
-        .optional()
-        .describe("Absolute path to the old theme.json file on disk. Preferred for any real-world theme."),
-    section_name: z
-        .string()
-        .describe("Old component name (e.g. 'Navbar', 'ProductGrid') or dir name, OR the new section ID (e.g. 'my-theme-navbar')"),
-    project_name: z
-        .string()
-        .optional()
-        .describe("Target new project name (must match what was used in plan_migration). Default: 'my-theme'"),
-    old_source_dir: z
-        .string()
-        .optional()
-        .describe("Absolute path to old src/ directory (used to output exact source file paths to read)"),
-}, async ({ theme_json, theme_json_path, section_name, project_name, old_source_dir, }) => {
+    theme_json: z.string().optional().describe("Raw JSON content of the old theme.json. EITHER this OR theme_json_path is required (not both)."),
+    theme_json_path: z.string().optional().describe("Absolute path to the old theme.json file on disk. Preferred for any real-world theme."),
+    section_name: z.string().describe("Old component name (e.g. 'Navbar', 'ProductGrid') or dir name, OR the new section ID (e.g. 'my-theme-navbar')"),
+    project_name: z.string().optional().describe("Target new project name (must match what was used in plan_migration). Default: 'my-theme'"),
+    old_source_dir: z.string().optional().describe("Absolute path to old src/ directory (used to output exact source file paths to read)"),
+}, async ({ theme_json, theme_json_path, section_name, project_name, old_source_dir }) => {
     try {
         const parsed = resolveThemeJson(theme_json, theme_json_path);
         const projectName = project_name || "my-theme";
@@ -3441,12 +3013,7 @@ server.tool("get_section_migration_plan", "Returns concrete CLI commands and pro
     }
     catch (err) {
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error: ${err instanceof Error ? err.message : String(err)}`,
-                },
-            ],
+            content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
         };
     }
 });
@@ -3482,11 +3049,7 @@ async function runIkasComponentCli(projectRoot, args) {
                 : err
                     ? 1
                     : 0;
-            resolve({
-                stdout: stdout?.toString() ?? "",
-                stderr: stderr?.toString() ?? "",
-                exitCode,
-            });
+            resolve({ stdout: stdout?.toString() ?? "", stderr: stderr?.toString() ?? "", exitCode });
         });
     });
 }
@@ -3496,11 +3059,7 @@ function parseCliJson(stdout) {
         return null;
     // CLI prints exactly one JSON object on stdout; if multiple lines appeared
     // (e.g., warnings on stderr leaked), take the last non-empty line.
-    const last = trimmed
-        .split("\n")
-        .map((l) => l.trim())
-        .filter(Boolean)
-        .pop();
+    const last = trimmed.split("\n").map(l => l.trim()).filter(Boolean).pop();
     if (!last)
         return null;
     try {
@@ -3515,11 +3074,7 @@ async function callEditorAction(projectRoot, args) {
         const { stdout, stderr, exitCode } = await runIkasComponentCli(projectRoot, args);
         const parsed = parseCliJson(stdout);
         if (parsed) {
-            return {
-                content: [
-                    { type: "text", text: JSON.stringify(parsed, null, 2) },
-                ],
-            };
+            return { content: [{ type: "text", text: JSON.stringify(parsed, null, 2) }] };
         }
         return {
             content: [
@@ -3542,77 +3097,38 @@ async function callEditorAction(projectRoot, args) {
         };
     }
 }
-//
 // Tool: list_editor_pages
 server.tool("list_editor_pages", "List pages in the connected editor's project. Returns id, name, pageType, slug for each page. Requires `ikas-component dev` to be running with the editor connected. Use the returned `id`s as the `pageId` argument to `add_section_to_page`.", {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project (where `node_modules/.bin/ikas-component` lives)."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
+    project_root: z.string().describe("Absolute path to the code-component project (where `node_modules/.bin/ikas-component` lives)."),
+    port: z.number().optional().describe("Dev server WebSocket port (default 5201)."),
 }, async ({ project_root, port }) => {
     const args = ["list-pages", ...(port ? ["--port", String(port)] : [])];
     return callEditorAction(project_root, args);
 });
 // Tool: list_imported_sections
 server.tool("list_imported_sections", "List section-type code components already imported into the editor's project (theme.codeComponents, filtered to type=section). Use to confirm a component is ready to be placed on a page. The component must be built (`ikas-component build`/`dev`) and imported (`import_section`) before it can be added to a page. The returned `id` is the editor's id for the imported component — normally identical to the id in `ikas.config.json`, but it can differ if the dev component was deleted and re-scaffolded after a previous import. Always use the `id` from this tool, not from `ikas.config.json`, when calling `add_section_to_page`.", {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
+    project_root: z.string().describe("Absolute path to the code-component project."),
+    port: z.number().optional().describe("Dev server WebSocket port (default 5201)."),
 }, async ({ project_root, port }) => {
-    const args = [
-        "list-imported",
-        "--sections-only",
-        ...(port ? ["--port", String(port)] : []),
-    ];
+    const args = ["list-imported", "--sections-only", ...(port ? ["--port", String(port)] : [])];
     return callEditorAction(project_root, args);
 });
 // Tool: import_section
 server.tool("import_section", "Import a built section-type code component into the editor's project. This copies the compiled JS/CSS/props into `theme.codeComponents` and auto-creates the wrapper section needed to place it on a page. Idempotent: re-running updates the existing entry in place. Required before `add_section_to_page`. The component must have been built (`ikas-component build`/`dev`).", {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    component_id: z
-        .string()
-        .describe("Component id from `ikas.config.json` (strict — no name resolution)."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
+    project_root: z.string().describe("Absolute path to the code-component project."),
+    component_id: z.string().describe("Component id from `ikas.config.json` (strict — no name resolution)."),
+    port: z.number().optional().describe("Dev server WebSocket port (default 5201)."),
 }, async ({ project_root, component_id, port }) => {
-    const args = [
-        "import",
-        "--id",
-        component_id,
-        ...(port ? ["--port", String(port)] : []),
-    ];
+    const args = ["import", "--id", component_id, ...(port ? ["--port", String(port)] : [])];
     return callEditorAction(project_root, args);
 });
 // Tool: add_section_to_page
-server.tool("add_section_to_page", 'Place an already-imported section-type code component on a page in the editor. Equivalent to right-clicking the section in the dev-components panel and choosing "Add to Page". Errors if the component is not imported, is not section-type, or the page id is unknown. Use `list_editor_pages` to discover page ids and `list_imported_sections` to discover component ids. After placing, change the section\'s prop values with `update_section_prop` (use `list_page_sections` to get the placement\'s `elementId` and prop names).', {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    component_id: z
-        .string()
-        .describe("Imported code component id from `list_imported_sections` — NOT the id in `ikas.config.json` (the two are usually the same but can diverge after a rescaffold)."),
+server.tool("add_section_to_page", "Place an already-imported section-type code component on a page in the editor. Equivalent to right-clicking the section in the dev-components panel and choosing \"Add to Page\". Errors if the component is not imported, is not section-type, or the page id is unknown. Use `list_editor_pages` to discover page ids and `list_imported_sections` to discover component ids.", {
+    project_root: z.string().describe("Absolute path to the code-component project."),
+    component_id: z.string().describe("Imported code component id from `list_imported_sections` — NOT the id in `ikas.config.json` (the two are usually the same but can diverge after a rescaffold)."),
     page_id: z.string().describe("Target page id (from `list_editor_pages`)."),
-    index: z
-        .number()
-        .int()
-        .nonnegative()
-        .optional()
-        .describe("Zero-based insertion index in the page; appends when omitted."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
+    index: z.number().int().nonnegative().optional().describe("Zero-based insertion index in the page; appends when omitted."),
+    port: z.number().optional().describe("Dev server WebSocket port (default 5201)."),
 }, async ({ project_root, component_id, page_id, index, port }) => {
     const args = [
         "add-to-page",
@@ -3625,98 +3141,6 @@ server.tool("add_section_to_page", 'Place an already-imported section-type code
     ];
     return callEditorAction(project_root, args);
 });
-// Tool: list_page_sections
-server.tool("list_page_sections", "List the sections placed on a page. Each entry includes the per-placement `elementId` (the identity of THIS placement — there can be multiple placements of the same section), `sectionId`, `componentId`, `name`, the current `propValues`, and the blueprint `props` (each with `id`, `name`, `type`). Use the returned `elementId` plus a prop `id`/`name` with `update_section_prop` to change a prop value of that specific placement. Use `list_editor_pages` to discover page ids.", {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    page_id: z.string().describe("Target page id (from `list_editor_pages`)."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
-}, async ({ project_root, page_id, port }) => {
-    const args = [
-        "list-page-sections",
-        "--page-id",
-        page_id,
-        ...(port ? ["--port", String(port)] : []),
-    ];
-    return callEditorAction(project_root, args);
-});
-// Tool: update_section_prop
-server.tool("update_section_prop", 'Change a single prop value of a section placed on a page. This is the tool for FILLING/SETTING content (heading, text, image, link, etc.) on an existing section — it is pure data entry: it writes NO component code and needs NO rebuild. Do not author a new prop or component to set a value the section already supports; first check the section\'s existing `props` via `list_page_sections`. Target the specific placement by its `element_id` (from `list_page_sections`) and the prop by `prop_id` or `prop_name` (also from `list_page_sections`). `value` is the prop value object as stored by the editor — for scalar props it is wrapped as `{ "value": <scalar> }` (e.g. `{ "value": "Hello" }` for TEXT, `{ "value": true }` for BOOLEAN, `{ "value": 12 }` for NUMBER, `{ "value": "#FF0000" }` for COLOR, `{ "value": "<enum-key>" }` for ENUM). Richer object prop types use their own object shape and are NOT `{ "value": ... }`-wrapped: IMAGE/VIDEO/SVG = `{ "id": "<asset-id>", "altText"?: "<alt>", "isVideo"?: false }` (the `id` MUST reference an already-uploaded asset — call `upload_image` with a `file_path`/`image_url` to get one, or reuse an existing `id` from another section\'s `propValues`); LINK = a single link object `{ "id": "<unique-short-id>", "linkType": "PAGE"|"EXTERNAL"|"FILE", "label": "...", "openInNewTab"?: false, "subLinks": [] }` plus the target for its type — for PAGE add `"pageId"` AND `"pageType"` (both from `list_editor_pages`, e.g. pageType "INDEX"; for dynamic page types like PRODUCT/CATEGORY/BLOG also add the target `"itemId"`), for EXTERNAL add `"externalLink": "https://..."`. Examples: PAGE → `{ "id": "k3p9x", "linkType": "PAGE", "label": "Home", "pageId": "<page-id>", "pageType": "INDEX", "openInNewTab": false, "subLinks": [] }`; EXTERNAL → `{ "id": "m7q2z", "linkType": "EXTERNAL", "label": "Docs", "externalLink": "https://example.com", "openInNewTab": true, "subLinks": [] }`. LIST_OF_LINK = `{ "links": [ <link>, ... ] }` (each item is a link object as above). PRODUCT = `{ "productId": "...", "variantId"?: "..." }`. This SAME unwrapped shape applies whether the prop sits at section level OR nested inside a COMPONENT_LIST entry\'s `propValues` — there is no section-vs-nested difference. IMPORTANT: pass `value` as the parsed JSON object/array itself, NEVER as a JSON string (a stringified value is double-encoded and stored as a useless string). Values are validated server-side (deeply, including nested COMPONENT_LIST children): wrong shapes AND wrong semantics are REJECTED with an explanatory error instead of being silently stored. This includes: a `{ "value": [...] }` wrapper for a COMPONENT_LIST; a `{ "value": ... }`-wrapped IMAGE; `props` instead of `propValues`; a missing/duplicate entry `id`; a child referenced by the wrong key (a code component MUST use `codeComponentId`, a theme component `componentId`) or by an id that does not exist (child ids are opaque — take them from `get_section_template` / `list_imported_sections`, never invent them); and any `propValues` key that is not a real prop of that child component (the error lists the valid prop names). Auto-import: a referenced child code component that has been BUILT but not yet imported into the theme is imported automatically before the value is set (the response lists any such ids under `autoImported`); only children that are not built at all fail with a "no imported code component" error — build them first (`ikas-component build`/`dev`). For any prop type you are unsure about, inspect the existing entry in `list_page_sections` `propValues` and match its exact shape. The change is applied with undo support.\n\n' +
-    'COMPONENT_LIST / COMPONENT props: the value is NOT wrapped in `{ "value": ... }`. A COMPONENT_LIST value is `{ "components": [ <entry>, ... ] }`; a single COMPONENT value is one `<entry>`. Each entry = `{ "id": "<unique-id>", "codeComponentId": "<child-id>" | "componentId": "<child-id>", "propValues": { "<childPropName>": <wrapped-value>, ... } }`. Rules: (1) `id` is a unique short alphanumeric string identifying THIS entry — generate a fresh one per new entry and NEVER reuse an existing entry\'s id. (2) Use `codeComponentId` for code components, `componentId` for built-in theme components. (3) `propValues` is keyed by the CHILD component\'s prop NAMES, each using the same scalar wrappers as above (nesting is recursive — a child may itself hold a COMPONENT_LIST). (4) `update_section_prop` REPLACES the whole prop value — there is NO partial/deep merge. ALWAYS send the COMPLETE, fully-nested value for the prop: every existing entry (with its id), every nested `propValues`, and every nested COMPONENT_LIST at every depth. To change anything (even one deeply-nested scalar, or to add/remove/reorder a child), READ-MODIFY-WRITE: take the current `{ "components": [...] }` from `list_page_sections`, edit it in place (preserving all other entries, ids, and nested structures), then send the ENTIRE updated object back. Sending only the changed part — a single entry, or a child without its siblings — wipes everything you omitted. (5) You can only add child component types the prop permits; the allowed set is the blueprint prop\'s `filteredComponentIds`, which for container sections (Header, Footer, ProductDetail, …) is wired at build/config time per the `get_section_template` setup recipe (`config update-prop`), not here.\n\n' +
-    'Example — a full COMPONENT_LIST `value` with two children, where the second child itself nests another COMPONENT_LIST (note: scalar leaves are `{ "value": ... }`-wrapped, COMPONENT_LIST values are `{ "components": [...] }` and are NOT wrapped, every entry has a unique `id`, and this is the COMPLETE value you would send even to change just one field): ' +
-    `{ "components": [ { "id": "a1b2c", "codeComponentId": "7ojrigep-Eml9n5sN3i", "propValues": { "heading": { "value": "Featured" }, "visible": { "value": true } } }, { "id": "d3e4f", "codeComponentId": "x2plk9zq-Qw8rt", "propValues": { "title": { "value": "Sub group" }, "cards": { "components": [ { "id": "g5h6i", "codeComponentId": "card01ab-Zz12", "propValues": { "label": { "value": "Card 1" } } }, { "id": "j7k8l", "codeComponentId": "card01ab-Zz12", "propValues": { "label": { "value": "Card 2" } } } ] } } } ] }`, {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    page_id: z.string().describe("Target page id (from `list_editor_pages`)."),
-    element_id: z
-        .string()
-        .describe("Placed-section elementId identifying THIS placement on the page (from `list_page_sections`)."),
-    prop_id: z
-        .string()
-        .optional()
-        .describe("Blueprint prop id to update (from `list_page_sections`). Provide this or `prop_name`."),
-    prop_name: z
-        .string()
-        .optional()
-        .describe("Blueprint prop name to update (alternative to `prop_id`)."),
-    value: z
-        .any()
-        .describe('The prop value object to store, e.g. `{ "value": "Hello" }`. Match the shape of the existing entry in `list_page_sections` propValues for non-scalar prop types.'),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
-}, async ({ project_root, page_id, element_id, prop_id, prop_name, value, port }) => {
-    const args = [
-        "update-section-prop",
-        "--page-id",
-        page_id,
-        "--element-id",
-        element_id,
-        ...(prop_id ? ["--prop-id", prop_id] : []),
-        ...(prop_name ? ["--prop-name", prop_name] : []),
-        "--value",
-        // The CLI JSON.parses --value. If `value` is already a JSON string, pass
-        // it through verbatim — re-stringifying it would double-encode it and the
-        // editor would store a string instead of the object/array.
-        typeof value === "string" ? value : JSON.stringify(value),
-        ...(port ? ["--port", String(port)] : []),
-    ];
-    return callEditorAction(project_root, args);
-});
-// Tool: upload_image
-server.tool("upload_image", "Upload an image to the connected editor's project and get back its image `id`. Provide the image via `file_path` (a local path) OR `image_url`. Use the returned `id` as the `id` of an IMAGE prop value passed to `update_section_prop` (e.g. `{ \"id\": \"<returned-id>\", \"altText\": \"...\", \"isVideo\": false }`). This is the way to set an image prop — `update_section_prop` does not upload, it only references an existing image id. Supported types: png, jpg, jpeg, webp, gif; max 10MB. Requires the editor to be embedded in the ikas admin panel (the admin panel performs the actual upload; a standalone editor cannot upload and will error/time out).", {
-    project_root: z
-        .string()
-        .describe("Absolute path to the code-component project."),
-    file_path: z
-        .string()
-        .optional()
-        .describe("Local image file path (.png, .jpg, .jpeg, .webp, .gif). Provide this or `image_url`."),
-    image_url: z
-        .string()
-        .optional()
-        .describe("Image URL to fetch and upload (alternative to `file_path`)."),
-    alt_text: z.string().optional().describe("Alt text to store with the image."),
-    port: z
-        .number()
-        .optional()
-        .describe("Dev server WebSocket port (default 5201)."),
-}, async ({ project_root, file_path, image_url, alt_text, port }) => {
-    const args = [
-        "upload-image",
-        ...(file_path ? ["--file", file_path] : []),
-        ...(image_url ? ["--url", image_url] : []),
-        ...(alt_text ? ["--alt", alt_text] : []),
-        ...(port ? ["--port", String(port)] : []),
-    ];
-    return callEditorAction(project_root, args);
-});
 // --- Start server ---
 async function main() {
     const transport = new StdioServerTransport();