@lark-apaas/miaoda-cli 0.1.46 → 0.1.48

package/dist/utils/migrate-adapters.js

@@ -0,0 +1,634 @@
+"use strict";
+/**
+ * migrate 定向适配的纯函数集合：输入文件文本，输出新文本或冲突原因，不读写磁盘。
+ *
+ * 这些函数只处理"本次转换必须改的键/片段"，其余内容原样保留；遇到无法确定性处理的形态
+ * 返回 conflict，由调用方报冲突并保持原工程不变。不是通用三方合并器。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELAX_ESLINT_MARKER = void 0;
+exports.parseJsoncObject = parseJsoncObject;
+exports.rewriteSrcPath = rewriteSrcPath;
+exports.adaptTsconfig = adaptTsconfig;
+exports.adaptHtmlEntry = adaptHtmlEntry;
+exports.adaptNestAppModule = adaptNestAppModule;
+exports.ensureScripts = ensureScripts;
+exports.normalizeConfigSource = normalizeConfigSource;
+exports.matchesKnownDefault = matchesKnownDefault;
+exports.rewriteLegacyLayoutGlob = rewriteLegacyLayoutGlob;
+exports.carryEslintIgnores = carryEslintIgnores;
+exports.relaxEslintRules = relaxEslintRules;
+const jsonc = __importStar(require("jsonc-parser"));
+const JSONC_FORMAT = {
+    formattingOptions: { insertSpaces: true, tabSize: 2, eol: '\n' },
+};
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** 解析 JSON(C)；不是对象或有语法错误时返回 undefined */
+function parseJsoncObject(text) {
+    const errors = [];
+    const value = jsonc.parse(text, errors, { allowTrailingComma: true });
+    if (errors.length > 0 || !isPlainObject(value))
+        return undefined;
+    return value;
+}
+function setJsonc(text, jsonPath, value) {
+    return jsonc.applyEdits(text, jsonc.modify(text, jsonPath, value, JSONC_FORMAT));
+}
+function sameJson(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+const SRC_PATH_RE = /^(\.\/)?src(\/|$)/;
+/** `./src/*` → `./client/src/*`，`src` → `client/src`；其他原样 */
+function rewriteSrcPath(value) {
+    return value.replace(SRC_PATH_RE, (_m, dot, sep) => {
+        return `${dot ?? ''}client/src${sep}`;
+    });
+}
+function isSrcIncludeEntry(value) {
+    return typeof value === 'string' && /^(\.\/)?src(\/.*)?$/.test(value);
+}
+function isViteOnlyInclude(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((e) => typeof e === 'string' && /^(\.\/)?vite\.config\.(ts|mts|js|mjs)$/.test(e)));
+}
+function getCompilerOptions(obj) {
+    const co = obj.compilerOptions;
+    return isPlainObject(co) ? co : {};
+}
+function getPaths(obj) {
+    const paths = getCompilerOptions(obj).paths;
+    return isPlainObject(paths) ? paths : {};
+}
+/** 把 paths 里每个值数组中 src 起头的条目改写到 client/src；返回改写后的文本与改动数 */
+function rewritePathsValues(text, obj) {
+    let next = text;
+    let count = 0;
+    for (const [key, raw] of Object.entries(getPaths(obj))) {
+        if (!Array.isArray(raw))
+            continue;
+        const rewritten = raw.map((v) => typeof v === 'string' ? rewriteSrcPath(v) : v);
+        if (!sameJson(rewritten, raw)) {
+            next = setJsonc(next, ['compilerOptions', 'paths', key], rewritten);
+            count++;
+        }
+    }
+    return { text: next, count };
+}
+/** 模板里有、用户缺失的 compilerOptions 键补齐（paths 单独处理） */
+function addMissingCompilerOptions(text, user, tpl) {
+    let next = text;
+    const added = [];
+    const userCo = getCompilerOptions(user);
+    for (const [key, value] of Object.entries(getCompilerOptions(tpl))) {
+        if (key === 'paths')
+            continue;
+        if (Object.prototype.hasOwnProperty.call(userCo, key))
+            continue;
+        next = setJsonc(next, ['compilerOptions', key], value);
+        added.push(key);
+    }
+    return { text: next, added };
+}
+function addMissingPaths(text, user, tpl) {
+    let next = text;
+    const added = [];
+    const userPaths = getPaths(user);
+    for (const [key, value] of Object.entries(getPaths(tpl))) {
+        if (Object.prototype.hasOwnProperty.call(userPaths, key))
+            continue;
+        next = setJsonc(next, ['compilerOptions', 'paths', key], value);
+        added.push(key);
+    }
+    return { text: next, added };
+}
+/**
+ * 顶层数组（exclude）里 src 起头的条目改写到 client/src。用户排除的目录随 src → client/src
+ * 搬迁，不改写就指向不存在的路径、排除失效（典型：旧模板排除 src/components/ui，迁移后
+ * shadcn 组件被纳入类型检查）。
+ */
+function rewriteSrcArrayKey(text, obj, key) {
+    const raw = obj[key];
+    if (!Array.isArray(raw))
+        return text;
+    const rewritten = raw.map((v) => (typeof v === 'string' ? rewriteSrcPath(v) : v));
+    if (sameJson(rewritten, raw))
+        return text;
+    return setJsonc(text, [key], rewritten);
+}
+function unionArrayKey(text, user, tpl, key) {
+    const tplRaw = tpl[key];
+    if (!Array.isArray(tplRaw))
+        return text;
+    const tplArr = tplRaw;
+    const userArr = Array.isArray(user[key]) ? user[key] : [];
+    const missing = tplArr.filter((e) => !userArr.some((u) => sameJson(u, e)));
+    if (missing.length === 0)
+        return text;
+    return setJsonc(text, [key], [...userArr, ...missing]);
+}
+/**
+ * tsconfig 定向适配，语义见 AdaptTsconfigRule。
+ * userText 为 undefined 表示用户侧文件不存在 —— 'root' / 'node' 直接采用模板。
+ */
+function adaptTsconfig(opts) {
+    const tpl = parseJsoncObject(opts.templateText);
+    if (tpl === undefined) {
+        return { ok: false, conflict: 'template tsconfig is not valid JSON' };
+    }
+    if (opts.userText === undefined) {
+        return { ok: true, text: opts.templateText, changed: true, detail: 'created from template' };
+    }
+    const user = parseJsoncObject(opts.userText);
+    if (user === undefined) {
+        return { ok: false, conflict: 'not a parsable JSON(C) object; cannot adapt automatically' };
+    }
+    if (opts.role === 'root') {
+        const { text: pathsText, count } = rewritePathsValues(opts.userText, user);
+        const text = rewriteSrcArrayKey(pathsText, user, 'exclude');
+        return {
+            ok: true,
+            text,
+            changed: text !== opts.userText,
+            detail: `${count.toString()} path(s) rewritten`,
+        };
+    }
+    if (opts.role === 'node') {
+        const tplExtends = tpl.extends;
+        if (user.extends === undefined && isViteOnlyInclude(user.include)) {
+            // 旧 stack 的 tsconfig.node.json 只服务 vite.config，与新 stack 同名文件职责不同
+            return {
+                ok: true,
+                text: opts.templateText,
+                changed: true,
+                replaced: true,
+                detail: 'replaced vite-only config',
+            };
+        }
+        if (tplExtends === undefined || !sameJson(user.extends, tplExtends)) {
+            return {
+                ok: false,
+                conflict: `extends ${JSON.stringify(user.extends ?? null)} is neither the vite-only legacy form nor ${JSON.stringify(tplExtends ?? null)}`,
+            };
+        }
+        let text = opts.userText;
+        const co = addMissingCompilerOptions(text, user, tpl);
+        text = co.text;
+        const paths = addMissingPaths(text, user, tpl);
+        text = paths.text;
+        text = unionArrayKey(text, parseJsoncObject(text) ?? user, tpl, 'include');
+        text = unionArrayKey(text, parseJsoncObject(text) ?? user, tpl, 'exclude');
+        return { ok: true, text, changed: text !== opts.userText };
+    }
+    // role === 'app'
+    let text = opts.userText;
+    const tplExtends = tpl.extends;
+    const userExtends = user.extends;
+    const legacy = opts.legacyExtends ?? [];
+    if (!sameJson(userExtends, tplExtends)) {
+        const replaceable = userExtends === undefined ||
+            (typeof userExtends === 'string' && legacy.includes(userExtends));
+        if (!replaceable || tplExtends === undefined) {
+            return {
+                ok: false,
+                conflict: `extends ${JSON.stringify(userExtends)} is not a recognized platform preset`,
+            };
+        }
+        text = setJsonc(text, ['extends'], tplExtends);
+    }
+    const tplInclude = Array.isArray(tpl.include) ? tpl.include : [];
+    const userInclude = Array.isArray(user.include) ? user.include : [];
+    const keptInclude = userInclude.filter((e) => !isSrcIncludeEntry(e) && !tplInclude.some((t) => sameJson(t, e)));
+    const nextInclude = [...tplInclude, ...keptInclude];
+    if (!sameJson(nextInclude, userInclude)) {
+        text = setJsonc(text, ['include'], nextInclude);
+    }
+    const rewritten = rewritePathsValues(text, user);
+    text = rewritten.text;
+    text = addMissingPaths(text, user, tpl).text;
+    text = addMissingCompilerOptions(text, user, tpl).text;
+    text = rewriteSrcArrayKey(text, user, 'exclude');
+    text = unionArrayKey(text, parseJsoncObject(text) ?? user, tpl, 'exclude');
+    return { ok: true, text, changed: text !== opts.userText };
+}
+// ---------------------------------------------------------------------------
+// HTML 入口
+// ---------------------------------------------------------------------------
+const HEAD_RE = /<head(\s[^>]*)?>([\s\S]*?)<\/head>/i;
+const BODY_RE = /<body(\s[^>]*)?>([\s\S]*?)<\/body>/i;
+const HTML_OPEN_RE = /<html(\s[^>]*)?>/i;
+const ELEMENT_TOKEN_RE = /<!--[\s\S]*?-->|<(title|script|style|noscript)\b[^>]*>[\s\S]*?<\/\1\s*>|<(?:meta|link|base)\b[^>]*\/?>/gi;
+const BODY_TOKEN_RE = /<!--[\s\S]*?-->|<(script|style|noscript|div|template)\b[^>]*>[\s\S]*?<\/\1\s*>|<(?:link|meta)\b[^>]*\/?>/gi;
+function tokenize(content, re) {
+    const tokens = content.match(re) ?? [];
+    let rest = content;
+    for (const t of tokens)
+        rest = rest.replace(t, '');
+    if (rest.trim() !== '')
+        return undefined;
+    return tokens;
+}
+function attr(tag, name) {
+    const m = new RegExp(`\\b${name}\\s*=\\s*(["'])([^"']*)\\1`, 'i').exec(tag);
+    return m?.[2];
+}
+/** 可选捕获组：未参与匹配时为 undefined（TS 类型标成 string），统一回落空串 */
+function group(match, index) {
+    return match[index] ?? '';
+}
+function openTag(token) {
+    return /^<[^>]*>/.exec(token)?.[0] ?? token;
+}
+function isPlatformHeadToken(token, legacyEntry) {
+    if (token.startsWith('<!--'))
+        return true;
+    const tag = openTag(token).toLowerCase();
+    if (tag.startsWith('<meta') && attr(tag, 'charset') !== undefined)
+        return true;
+    if (tag.startsWith('<meta') && attr(tag, 'name') === 'viewport')
+        return true;
+    if (tag.startsWith('<link') && (attr(tag, 'rel') ?? '').includes('icon')) {
+        return attr(tag, 'href') === '/favicon.svg';
+    }
+    if (tag.startsWith('<script') && attr(tag, 'src') === legacyEntry)
+        return true;
+    return false;
+}
+function isPlatformBodyToken(token, legacyEntry) {
+    if (token.startsWith('<!--'))
+        return true;
+    const tag = openTag(token).toLowerCase();
+    if (tag.startsWith('<script') && attr(tag, 'src') === legacyEntry)
+        return true;
+    if (tag.startsWith('<div') && attr(tag, 'id') === 'root') {
+        return /^<div\b[^>]*>\s*<\/div\s*>$/i.test(token);
+    }
+    return false;
+}
+/** 用户自定义片段里引用旧布局 /src/ 的地址同步到 /client/src/ */
+function rewriteSrcRefs(fragment) {
+    return fragment.replace(/\b(src|href)=(["'])\/src\//g, '$1=$2/client/src/');
+}
+/**
+ * 旧根 index.html → 新 client/index.html。语义见 AdaptHtmlEntryRule。
+ */
+function adaptHtmlEntry(opts) {
+    const { userHtml, templateHtml, legacyEntry } = opts;
+    if (userHtml.includes('{{')) {
+        return {
+            ok: false,
+            conflict: 'contains "{{" which the HBS view engine would evaluate; adapt manually',
+        };
+    }
+    const head = HEAD_RE.exec(userHtml);
+    const body = BODY_RE.exec(userHtml);
+    if (head === null || body === null) {
+        return { ok: false, conflict: 'unrecognized HTML structure (missing <head> or <body>)' };
+    }
+    const tplHead = HEAD_RE.exec(templateHtml);
+    const tplBody = BODY_RE.exec(templateHtml);
+    if (tplHead === null || tplBody === null) {
+        return { ok: false, conflict: 'template HTML missing <head> or <body>' };
+    }
+    const headTokens = tokenize(head[2], ELEMENT_TOKEN_RE);
+    const bodyTokens = tokenize(body[2], BODY_TOKEN_RE);
+    if (headTokens === undefined) {
+        return { ok: false, conflict: 'unrecognized content in <head>; adapt manually' };
+    }
+    if (bodyTokens === undefined) {
+        return { ok: false, conflict: 'unrecognized content in <body>; adapt manually' };
+    }
+    let userTitle;
+    const extraHead = [];
+    for (const token of headTokens) {
+        if (/^<title\b/i.test(token)) {
+            userTitle = token;
+            continue;
+        }
+        if (isPlatformHeadToken(token, legacyEntry))
+            continue;
+        extraHead.push(rewriteSrcRefs(token));
+    }
+    const extraBody = bodyTokens
+        .filter((t) => !isPlatformBodyToken(t, legacyEntry))
+        .map((t) => rewriteSrcRefs(t));
+    let headInner = tplHead[2];
+    if (userTitle !== undefined) {
+        const title = userTitle;
+        headInner = /<title\b[^>]*>[\s\S]*?<\/title\s*>/i.test(headInner)
+            ? headInner.replace(/<title\b[^>]*>[\s\S]*?<\/title\s*>/i, () => title)
+            : `${headInner}\n  ${title}`;
+    }
+    if (extraHead.length > 0) {
+        headInner = `${headInner.replace(/\s*$/, '')}\n  ${extraHead.join('\n  ')}\n`;
+    }
+    let bodyInner = tplBody[2];
+    if (extraBody.length > 0) {
+        bodyInner = `${bodyInner.replace(/\s*$/, '')}\n  ${extraBody.join('\n  ')}\n`;
+    }
+    // 替换一律用函数形式，避免用户内容里的 `$&` 等被当成替换模式
+    let text = templateHtml
+        .replace(tplHead[0], () => `<head${group(tplHead, 1)}>${headInner}</head>`)
+        .replace(tplBody[0], () => `<body${group(body, 1) || group(tplBody, 1)}>${bodyInner}</body>`);
+    const userHtmlOpen = HTML_OPEN_RE.exec(userHtml);
+    if (userHtmlOpen?.[1] !== undefined) {
+        text = text.replace(HTML_OPEN_RE, () => userHtmlOpen[0]);
+    }
+    return {
+        ok: true,
+        text,
+        changed: true,
+        detail: `kept ${(extraHead.length + extraBody.length + (userTitle ? 1 : 0)).toString()} custom element(s)`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Nest 根模块
+// ---------------------------------------------------------------------------
+/** 从 openIndex（指向 `[`）起做括号匹配，跳过字符串与注释；返回匹配的 `]` 下标 */
+function findClosingBracket(text, openIndex) {
+    let depth = 0;
+    for (let i = openIndex; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '/' && text[i + 1] === '/') {
+            const nl = text.indexOf('\n', i);
+            if (nl < 0)
+                return -1;
+            i = nl;
+            continue;
+        }
+        if (ch === '/' && text[i + 1] === '*') {
+            const end = text.indexOf('*/', i + 2);
+            if (end < 0)
+                return -1;
+            i = end + 1;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            let j = i + 1;
+            while (j < text.length && text[j] !== ch) {
+                if (text[j] === '\\')
+                    j++;
+                j++;
+            }
+            i = j;
+            continue;
+        }
+        if (ch === '[' || ch === '(' || ch === '{')
+            depth++;
+        if (ch === ']' || ch === ')' || ch === '}') {
+            depth--;
+            if (depth === 0)
+                return ch === ']' ? i : -1;
+        }
+    }
+    return -1;
+}
+/** 把注释替换成等长空格（保持下标不变），用于定位最后一个有效字符 */
+function blankComments(fragment) {
+    return fragment
+        .replace(/\/\*[\s\S]*?\*\//g, (m) => ' '.repeat(m.length))
+        .replace(/\/\/[^\n]*/g, (m) => ' '.repeat(m.length));
+}
+/** 返回 fragment 中最后一个非注释、非空白字符的下标；没有则 -1 */
+function lastMeaningfulIndex(fragment) {
+    const blanked = blankComments(fragment);
+    for (let i = blanked.length - 1; i >= 0; i--) {
+        if (!/\s/.test(blanked[i]))
+            return i;
+    }
+    return -1;
+}
+function insertImport(text, statement) {
+    const importRe = /^import[\s\S]*?from\s+['"][^'"]+['"];?[ \t]*$/gm;
+    let lastEnd = -1;
+    for (const m of text.matchAll(importRe)) {
+        lastEnd = m.index + m[0].length;
+    }
+    if (lastEnd < 0)
+        return `${statement}\n${text}`;
+    return `${text.slice(0, lastEnd)}\n${statement}${text.slice(lastEnd)}`;
+}
+/**
+ * 保证 Nest 根模块注册 PlatformModule.forRoot()（首位）与 ViewModule（末位）。
+ * includeView=false 时不处理 ViewModule（项目里没有 view 模块可引用）。
+ */
+function adaptNestAppModule(text, opts) {
+    const needPlatform = !/\bPlatformModule\b/.test(text);
+    const needView = opts.includeView && !/\bViewModule\b/.test(text);
+    if (!needPlatform && !needView)
+        return { ok: true, text, changed: false };
+    const moduleIdx = text.search(/@Module\s*\(\s*\{/);
+    if (moduleIdx < 0) {
+        return { ok: false, conflict: '@Module({...}) decorator not found; adapt manually' };
+    }
+    const importsMatch = /\bimports\s*:\s*\[/.exec(text.slice(moduleIdx));
+    if (importsMatch === null) {
+        return { ok: false, conflict: '@Module imports array not found; adapt manually' };
+    }
+    const openIdx = moduleIdx + importsMatch.index + importsMatch[0].length - 1;
+    const closeIdx = findClosingBracket(text, openIdx);
+    if (closeIdx < 0) {
+        return { ok: false, conflict: '@Module imports array is not parsable; adapt manually' };
+    }
+    let next = text;
+    const added = [];
+    // 先改尾部（ViewModule），再改头部（PlatformModule），避免下标漂移
+    if (needView) {
+        const inner = next.slice(openIdx + 1, closeIdx);
+        const lastIdx = lastMeaningfulIndex(inner);
+        let closeAt = closeIdx;
+        if (lastIdx >= 0 && inner[lastIdx] !== ',') {
+            // 末元素没有尾逗号：逗号紧跟在末元素后面（不能落进其后的行注释里）
+            const at = openIdx + 1 + lastIdx + 1;
+            next = `${next.slice(0, at)},${next.slice(at)}`;
+            closeAt++;
+        }
+        // 新元素以换行开头，插在末尾注释之后也不会被注释吞掉
+        const insertAt = openIdx + 1 + next.slice(openIdx + 1, closeAt).trimEnd().length;
+        next = `${next.slice(0, insertAt)}\n    ViewModule,${next.slice(insertAt)}`;
+        added.push('ViewModule');
+    }
+    if (needPlatform) {
+        next = `${next.slice(0, openIdx + 1)}\n    PlatformModule.forRoot(),${next.slice(openIdx + 1)}`;
+        added.push('PlatformModule');
+    }
+    if (needView) {
+        next = insertImport(next, "import { ViewModule } from './modules/view/view.module';");
+    }
+    if (needPlatform) {
+        next = insertImport(next, "import { PlatformModule } from '@lark-apaas/fullstack-nestjs-core';");
+    }
+    return { ok: true, text: next, changed: true, detail: `registered ${added.join(', ')}` };
+}
+/** 语义见 EnsureScriptsRule */
+function ensureScripts(current, specs) {
+    const scripts = { ...current };
+    const changed = [];
+    const conflicts = [];
+    for (const spec of specs) {
+        const has = Object.prototype.hasOwnProperty.call(scripts, spec.name);
+        if (!has) {
+            scripts[spec.name] = spec.command;
+            changed.push(spec.name);
+            continue;
+        }
+        const value = scripts[spec.name];
+        if (value === spec.command)
+            continue;
+        const isLegacy = (spec.legacy ?? []).includes(value) ||
+            (spec.legacyPrefixes ?? []).some((p) => value.startsWith(p));
+        if (isLegacy) {
+            scripts[spec.name] = spec.command;
+            changed.push(spec.name);
+            continue;
+        }
+        conflicts.push({ name: spec.name, current: value, expected: spec.command });
+    }
+    return { scripts, changed, conflicts };
+}
+// ---------------------------------------------------------------------------
+// 已知默认配置识别
+// ---------------------------------------------------------------------------
+// 字符串字面量优先匹配，其中的 `/*`、`//`（如 glob '**/x/**'、URL）不当注释
+const SOURCE_TOKEN_RE = /("(?:\\.|[^"\\\n])*"|'(?:\\.|[^'\\\n])*'|`(?:\\.|[^`\\])*`)|\/\*[\s\S]*?\*\/|\/\/[^\n]*/g;
+/** 去注释、空白与分号，引号统一为双引号 —— 用于和已知平台默认配置做结构比对 */
+function normalizeConfigSource(text) {
+    return text
+        .replace(SOURCE_TOKEN_RE, (match, literal) => literal ?? '')
+        .replace(/'/g, '"')
+        .replace(/[\s;]/g, '');
+}
+function matchesKnownDefault(text, patterns) {
+    const normalized = normalizeConfigSource(text);
+    return patterns.some((p) => new RegExp(`^(?:${p})$`).test(normalized));
+}
+// ---------------------------------------------------------------------------
+// ESLint 忽略项迁移
+// ---------------------------------------------------------------------------
+const GLOBAL_IGNORES_RE = /\bglobalIgnores\s*\(\s*\[([\s\S]*?)\]/;
+const IGNORES_ARRAY_RE = /(\bignores\s*:\s*\[)([\s\S]*?)(\])/;
+const STRING_LITERAL_RE = /(['"`])((?:(?!\1)[^\\\n]|\\.)*)\1/g;
+function quote(value) {
+    return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+function stringLiterals(text) {
+    return [...text.matchAll(STRING_LITERAL_RE)].map((m) => m[2]);
+}
+/** 旧布局下的根相对路径改写到新布局：src → client/src，public → client/public；glob 前缀 ! 保留 */
+function rewriteLegacyLayoutGlob(value) {
+    const negated = value.startsWith('!') ? '!' : '';
+    const body = negated ? value.slice(1) : value;
+    const rewritten = rewriteSrcPath(body).replace(/^(\.\/)?public(\/|$)/, (_m, dot, sep) => `${dot ?? ''}client/public${sep}`);
+    return negated + rewritten;
+}
+/**
+ * 把旧 flat config（eslint.config.mjs）里 `globalIgnores([...])` 的条目带到新配置第一个
+ * `ignores: [...]` 数组：路径按新布局改写，已有的不重复加。
+ *
+ * 背景：vite-react 模板用 globalIgnores 排除了 `**\/components/ui/**`，迁移删掉旧配置后新配置
+ * 不排除 shadcn 组件，组件里引用新版 react-hooks 规则的 eslint-disable 注释报"规则不存在"。
+ *
+ * 旧配置没有 globalIgnores → 无需迁移（changed=false）；新配置找不到 ignores 数组 → 冲突。
+ */
+function carryEslintIgnores(opts) {
+    const legacy = GLOBAL_IGNORES_RE.exec(opts.legacyText);
+    if (legacy === null) {
+        return { ok: true, text: opts.targetText, changed: false, detail: 'no legacy globalIgnores' };
+    }
+    const wanted = stringLiterals(legacy[1]).map(rewriteLegacyLayoutGlob);
+    const target = IGNORES_ARRAY_RE.exec(opts.targetText);
+    if (target === null) {
+        return { ok: false, conflict: 'no `ignores: [...]` array to carry legacy ignores into' };
+    }
+    const existing = new Set(stringLiterals(target[2]));
+    const missing = [...new Set(wanted)].filter((p) => !existing.has(p));
+    if (missing.length === 0) {
+        return { ok: true, text: opts.targetText, changed: false, detail: 'ignores already present' };
+    }
+    const body = target[2];
+    const itemIndent = /\n([ \t]+)\S/.exec(body)?.[1];
+    let nextBody;
+    if (itemIndent !== undefined) {
+        // 多行数组：沿用条目缩进逐行追加，保留原有收尾（换行 + 闭合缩进）
+        const closing = /\n[ \t]*$/.exec(body)?.[0] ?? '\n';
+        const items = body.slice(0, body.length - closing.length).replace(/,?\s*$/, ',');
+        nextBody = items + missing.map((p) => `\n${itemIndent}${quote(p)},`).join('') + closing;
+    }
+    else {
+        const items = body.trim().replace(/,$/, '');
+        const added = missing.map(quote).join(', ');
+        nextBody = items === '' ? added : `${items}, ${added}`;
+    }
+    const start = target.index + target[1].length;
+    const text = opts.targetText.slice(0, start) + nextBody + opts.targetText.slice(start + body.length);
+    return { ok: true, text, changed: true, detail: `carried ${missing.join(', ')}` };
+}
+/** relax-eslint-rules 追加段的标识注释 */
+exports.RELAX_ESLINT_MARKER = 'miaoda-migrate: relax rules added by the vite-react → fullstack migration';
+const CONFIG_CALL_END_RE = /\n\);?\s*$/;
+/**
+ * 在 `module.exports = tseslint.config(...)` 收尾前追加一段覆盖：files 范围内 rules 降为 warn。
+ * 已有 marker → 不变；找不到 `tseslint.config(` 或收尾的 `)` → 冲突原因（调用方记 kept，不阻断）。
+ */
+function relaxEslintRules(opts) {
+    if (opts.text.includes(exports.RELAX_ESLINT_MARKER)) {
+        return { ok: true, text: opts.text, changed: false, detail: 'already relaxed' };
+    }
+    const end = CONFIG_CALL_END_RE.exec(opts.text);
+    if (!/\btseslint\.config\(/.test(opts.text) || end === null) {
+        return { ok: false, conflict: 'not a `tseslint.config(...)` config; rules not relaxed' };
+    }
+    const before = opts.text.slice(0, end.index).replace(/,?\s*$/, ',');
+    const block = [
+        `  // ${exports.RELAX_ESLINT_MARKER}`,
+        '  // 新 preset 新增 / 加严的平台规范先降为 warn（lint 以 --quiet 运行不阻断提交），按提示逐步修复后可删除本段',
+        '  {',
+        `    files: [${opts.files.map(quote).join(', ')}],`,
+        '    rules: {',
+        ...opts.rules.map((r) => `      ${quote(r)}: 'warn',`),
+        '    },',
+        '  },',
+    ].join('\n');
+    const text = `${before}\n${block}${opts.text.slice(end.index)}`;
+    return {
+        ok: true,
+        text,
+        changed: true,
+        detail: `${opts.rules.length.toString()} rule(s) relaxed`,
+    };
+}