@santi020k/lumen 3.0.1 → 4.0.0

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,CAAA;AAwBD,eAAO,MAAM,uBAAuB,GAAI,WAAU,aAA6B,KAAG,kBAAkB,EAGnG,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,WAAU,aAA6B,KACtC,kBAAkB,GAAG,SAQvB,CAAA;AA6JD,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,GAAG,GAAG,EACpB,UAAS,wBAA6B,KACrC,OAAO,CAAC,aAAa,CAsBvB,CAAA;AAED,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,CAAA;AAwBD,eAAO,MAAM,uBAAuB,GAAI,WAAU,aAA6B,KAAG,kBAAkB,EAGnG,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,WAAU,aAA6B,KACtC,kBAAkB,GAAG,SAQvB,CAAA;AAsKD,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,GAAG,GAAG,EACpB,UAAS,wBAA6B,KACrC,OAAO,CAAC,aAAa,CAsBvB,CAAA;AAED,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAA"}

package/dist/registry.js

@@ -1,5 +1,5 @@
-/* eslint-disable complexity */
 import { readFile, stat } from 'node:fs/promises';
+import { isSafeRegistryComponentName } from './registry-component-name.js';
 import { lumenRegistry } from './registry-data.js';
 import { isSafeRegistryFilePath } from './registry-path.js';
 export { lumenRegistry };
@@ -50,30 +50,32 @@ const isRegistryItem = (value) => {
         (item.components === undefined || isStringArray(item.components)) &&
         (item.files === undefined || isRegistryFileArray(item.files)));
 };
+const isNonEmptyString = (value) => typeof value === 'string' && value.trim().length > 0;
 const isRegistryComponent = (value) => {
     if (!value || typeof value !== 'object')
         return false;
     const component = value;
-    return (typeof component.name === 'string' && component.name.trim().length > 0 &&
+    return (isSafeRegistryComponentName(component.name) &&
         component.type === 'component' &&
-        typeof component.description === 'string' && component.description.trim().length > 0 &&
-        typeof component.category === 'string' && component.category.trim().length > 0 &&
+        isNonEmptyString(component.description) &&
+        isNonEmptyString(component.category) &&
         isRegistryFileArray(component.files) &&
         (component.dependencies === undefined || isStringArray(component.dependencies)));
 };
+const isRegistryComponents = (value) => (Array.isArray(value) && value.every((component) => isRegistryComponent(component)));
+const isPositiveSafeInteger = (value) => (typeof value === 'number' && Number.isSafeInteger(value) && value > 0);
 const isLumenRegistry = (value) => {
     if (!value || typeof value !== 'object')
         return false;
     const registry = value;
-    return (typeof registry.name === 'string' && registry.name.trim().length > 0 &&
-        typeof registry.version === 'number' &&
-        Number.isSafeInteger(registry.version) && registry.version > 0 &&
-        typeof registry.description === 'string' && registry.description.trim().length > 0 &&
+    return (isNonEmptyString(registry.name) &&
+        isPositiveSafeInteger(registry.version) &&
+        isNonEmptyString(registry.description) &&
         isStringArray(registry.packages) &&
         Array.isArray(registry.items) &&
         registry.items.every(item => isRegistryItem(item)) &&
         (registry.components === undefined ||
-            (Array.isArray(registry.components) && registry.components.every(component => isRegistryComponent(component)))));
+            isRegistryComponents(registry.components)));
 };
 const getResponseBody = (response) => response.body;
 const readBoundedResponse = async (response, maxBytes) => {

package/dist/source-script-ranges.d.ts

@@ -0,0 +1,3 @@
+/** Use compiler grammar for regex/division; callers fail closed when the parser exceeds its nesting limit. */
+export declare const scriptRegexRanges: (source: string, file: string) => ReadonlyMap<number, number> | undefined;
+//# sourceMappingURL=source-script-ranges.d.ts.map

package/dist/source-script-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-script-ranges.d.ts","sourceRoot":"","sources":["../src/source-script-ranges.ts"],"names":[],"mappings":"AAsBA,8GAA8G;AAC9G,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SA0B9F,CAAA"}

package/dist/source-script-ranges.js

@@ -0,0 +1,41 @@
+import { createSourceFile, ScriptKind, ScriptTarget, SyntaxKind } from 'typescript';
+const frontmatter = (source) => {
+    if (!source.startsWith('---'))
+        return { offset: 0, source: '' };
+    const end = source.indexOf('\n---', 3);
+    return { offset: 3, source: source.slice(3, end < 0 ? source.length : end) };
+};
+const parseRoot = (source, file) => {
+    const jsx = ['.tsx', '.jsx'].some(extension => file.endsWith(extension));
+    try {
+        return createSourceFile(file, source, ScriptTarget.Latest, false, jsx ? ScriptKind.TSX : ScriptKind.TS);
+    }
+    catch (error) {
+        if (!(error instanceof RangeError))
+            throw error;
+        return undefined;
+    }
+};
+/** Use compiler grammar for regex/division; callers fail closed when the parser exceeds its nesting limit. */
+export const scriptRegexRanges = (source, file) => {
+    if (['.html', '.htm', '.css', '.swift', '.kt', '.kts'].some(extension => file.endsWith(extension)))
+        return new Map();
+    const fragment = file.endsWith('.astro') ? frontmatter(source) : { offset: 0, source };
+    const root = parseRoot(fragment.source, file);
+    if (!root)
+        return undefined;
+    const pending = [root];
+    const ranges = new Map();
+    while (pending.length > 0) {
+        const node = pending.pop();
+        if (!node)
+            continue;
+        if (node.kind === SyntaxKind.RegularExpressionLiteral) {
+            ranges.set(node.getStart(root) + fragment.offset, node.end + fragment.offset);
+        }
+        node.forEachChild(child => {
+            pending.push(child);
+        });
+    }
+    return ranges;
+};

package/dist/v2-migration.d.ts

@@ -23,7 +23,45 @@ export interface LumenV2MigrationReport {
     manualReview: LumenV2MigrationFinding[];
     root: string;
 }
+interface ImportStatement {
+    clause: string;
+    end: number;
+    module: string;
+    quote: '\'' | '"';
+    semicolon: boolean;
+    start: number;
+}
+interface NamedImport {
+    imported: string;
+    local: string;
+    source: string;
+    typeOnly: boolean;
+}
+interface ParsedNamedImports {
+    close: number;
+    complete: boolean;
+    imports: NamedImport[];
+    open: number;
+}
+interface MarkupAttribute {
+    end: number;
+    name: string;
+    nameEnd: number;
+    nameStart: number;
+    start: number;
+    value: string | undefined;
+    valueKind: 'boolean' | 'expression' | 'literal';
+}
+export declare const findImportStatements: (source: string, module: string) => ImportStatement[];
+export declare const parseNamedImports: (clause: string) => ParsedNamedImports | undefined;
+export declare const findBalancedEnd: (source: string, start: number, opening: string, closing: string) => number;
+export declare const parseMarkupAttributes: (source: string, start: number, end: number) => MarkupAttribute[];
+export declare const findMarkupTagEnd: (source: string, start: number, rejectNestedTags?: boolean) => number;
+export declare const getTagNameEnd: (source: string, start: number) => number;
+export declare const getMarkupStart: (source: string, file: string) => number;
 export declare const migrateLumenV2Source: (source: string, file?: string) => LumenV2SourceMigration;
+export declare const discoverSourceFiles: (path: string, extensions?: ReadonlySet<string>) => Promise<string[]>;
 export declare const migrateLumenV2: (options?: LumenV2MigrationOptions) => Promise<LumenV2MigrationReport>;
 export declare const formatLumenV2Migration: (report: LumenV2MigrationReport) => string;
+export {};
 //# sourceMappingURL=v2-migration.d.ts.map

package/dist/v2-migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-migration.d.ts","sourceRoot":"","sources":["../src/v2-migration.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACzB,+BAA+B,GAC/B,sBAAsB,GACtB,2BAA2B,CAAA;AAE7B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,oBAAoB,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,YAAY,EAAE,uBAAuB,EAAE,CAAA;IACvC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,uBAAuB,EAAE,CAAA;IACvC,IAAI,EAAE,MAAM,CAAA;CACb;AA8nCD,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,aAAiB,KAChB,sBA4DF,CAAA;AAqBD,eAAO,MAAM,cAAc,GACzB,UAAS,uBAA4B,KACpC,OAAO,CAAC,sBAAsB,CAgChC,CAAA;AAED,eAAO,MAAM,sBAAsB,GACjC,QAAQ,sBAAsB,KAC7B,MA0BF,CAAA"}
+{"version":3,"file":"v2-migration.d.ts","sourceRoot":"","sources":["../src/v2-migration.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACzB,+BAA+B,GAC/B,sBAAsB,GACtB,2BAA2B,CAAA;AAE7B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,oBAAoB,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,YAAY,EAAE,uBAAuB,EAAE,CAAA;IACvC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,uBAAuB,EAAE,CAAA;IACvC,IAAI,EAAE,MAAM,CAAA;CACb;AAQD,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,IAAI,GAAG,GAAG,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,eAAe;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;CAChD;AA4ED,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,eAAe,EAgCjB,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,kBAAkB,GAAG,SA+BvE,CAAA;AAmBD,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,MAAM,EACf,SAAS,MAAM,KACd,MA6BF,CAAA;AA+JD,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,KAAK,MAAM,KACV,eAAe,EAkBjB,CAAA;AA4BD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,0BAAwB,KAAG,MA4B1F,CAAA;AAqLD,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAM7D,CAAA;AA0ED,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MAU7D,CAAA;AAuaD,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,aAAiB,KAChB,sBA4DF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,EAAE,aAAY,WAAW,CAAC,MAAM,CAAqB,KAChE,OAAO,CAAC,MAAM,EAAE,CAmBlB,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,UAAS,uBAA4B,KACpC,OAAO,CAAC,sBAAsB,CAgChC,CAAA;AAED,eAAO,MAAM,sBAAsB,GACjC,QAAQ,sBAAsB,KAC7B,MA0BF,CAAA"}

package/dist/v2-migration.js

@@ -1,4 +1,4 @@
-import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { lstat, readdir, readFile, writeFile } from 'node:fs/promises';
 import { extname, relative, resolve } from 'node:path';
 // cspell:words swiftpm
 const ASTRO_PACKAGE = '@santi020k/lumen-astro';
@@ -76,7 +76,7 @@ const createFinding = (source, file, index, kind, message) => ({
     kind,
     message
 });
-const findImportStatements = (source, module) => {
+export const findImportStatements = (source, module) => {
     const statements = [];
     for (const quote of ['\'', '"']) {
         const needle = `${quote}${module}${quote}`;
@@ -101,7 +101,7 @@ const findImportStatements = (source, module) => {
     }
     return statements.sort((left, right) => left.start - right.start);
 };
-const parseNamedImports = (clause) => {
+export const parseNamedImports = (clause) => {
     const open = clause.indexOf('{');
     const close = clause.lastIndexOf('}');
     if (open < 0 || close <= open)
@@ -136,7 +136,7 @@ const formatImport = (clause, statement) => `import ${clause} from ${statement.q
 const applyEdits = (source, edits) => edits
     .sort((left, right) => right.start - left.start)
     .reduce((result, edit) => `${result.slice(0, edit.start)}${edit.replacement}${result.slice(edit.end)}`, source);
-const findBalancedEnd = (source, start, opening, closing) => {
+export const findBalancedEnd = (source, start, opening, closing) => {
     let depth = 0;
     let quote;
     for (let index = start; index < source.length; index += 1) {
@@ -236,7 +236,7 @@ const parseMarkupAttribute = (source, start, end) => {
     const valueStart = skipWhitespace(source, equalsStart + 1, end);
     return parseMarkupAttributeValue(source, start, nameEnd, name, valueStart, end);
 };
-const parseMarkupAttributes = (source, start, end) => {
+export const parseMarkupAttributes = (source, start, end) => {
     const attributes = [];
     let cursor = start;
     while (cursor < end) {
@@ -255,7 +255,14 @@ const advanceQuotedSource = (character, quote) => ({
     close: character === quote,
     skip: character === '\\'
 });
-const findMarkupTagEnd = (source, start) => {
+const getMarkupBoundary = (character, braceDepth, rejectNestedTags, index) => {
+    if (braceDepth !== 0)
+        return undefined;
+    if (character === '>')
+        return index;
+    return character === '<' && rejectNestedTags ? -1 : undefined;
+};
+export const findMarkupTagEnd = (source, start, rejectNestedTags = false) => {
     let braceDepth = 0;
     let quote;
     for (let index = start; index < source.length; index += 1) {
@@ -274,8 +281,11 @@ const findMarkupTagEnd = (source, start) => {
             braceDepth += 1;
         else if (character === '}')
             braceDepth = Math.max(0, braceDepth - 1);
-        else if (character === '>' && braceDepth === 0)
-            return index;
+        else {
+            const boundary = getMarkupBoundary(character, braceDepth, rejectNestedTags, index);
+            if (boundary !== undefined)
+                return boundary;
+        }
     }
     return source.length;
 };
@@ -359,7 +369,7 @@ const migrateRuntimeImports = (source, file) => {
     }
     return { changes, manualReview, source: applyEdits(source, edits) };
 };
-const getTagNameEnd = (source, start) => {
+export const getTagNameEnd = (source, start) => {
     let end = start;
     while (/[\w:.-]/u.test(source[end] ?? ''))
         end += 1;
@@ -400,7 +410,7 @@ const inspectVisualSize = (source, file, tagName, replacementName, attributes) =
         review: createFinding(source, file, size.start, 'visual-size-alias-removal', message)
     };
 };
-const getMarkupStart = (source, file) => {
+export const getMarkupStart = (source, file) => {
     if (!file.endsWith('.astro'))
         return 0;
     const opening = /^(?:\uFEFF)?\s*---\s*(?:\r?\n|$)/u.exec(source);
@@ -675,14 +685,16 @@ export const migrateLumenV2Source = (source, file = '<source>') => {
         source: sonnerElements.source
     };
 };
-const discoverSourceFiles = async (path) => {
-    const details = await stat(path);
+export const discoverSourceFiles = async (path, extensions = SOURCE_EXTENSIONS) => {
+    const details = await lstat(path);
+    if (details.isSymbolicLink())
+        return [];
     if (details.isFile())
-        return SOURCE_EXTENSIONS.has(extname(path)) ? [path] : [];
+        return extensions.has(extname(path)) ? [path] : [];
     const entries = await readdir(path, { withFileTypes: true });
     const nested = await Promise.all(entries
         .filter(entry => !entry.isDirectory() || !IGNORED_DIRECTORIES.has(entry.name))
-        .map(entry => discoverSourceFiles(resolve(path, entry.name))));
+        .map(entry => discoverSourceFiles(resolve(path, entry.name), extensions)));
     return nested.flat().sort();
 };
 export const migrateLumenV2 = async (options = {}) => {

package/dist/v4-migration.d.ts

@@ -0,0 +1,26 @@
+export interface LumenV4MigrationFinding {
+    column: number;
+    file: string;
+    line: number;
+    message: string;
+    rule: string;
+}
+export interface LumenV4MigrationReport {
+    applied: boolean;
+    changedFiles: string[];
+    changes: LumenV4MigrationFinding[];
+    filesScanned: number;
+    manualReview: LumenV4MigrationFinding[];
+    packageVersions: Record<string, string>;
+    root: string;
+    targetVersion: string;
+}
+export declare const migrateLumenV4Source: (source: string, file?: string) => {
+    changes: LumenV4MigrationFinding[];
+    source: string;
+};
+export declare const migrateLumenV4: (options?: {
+    apply?: boolean | undefined;
+    cwd?: string | undefined;
+}) => Promise<LumenV4MigrationReport>;
+//# sourceMappingURL=v4-migration.d.ts.map

package/dist/v4-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4-migration.d.ts","sourceRoot":"","sources":["../src/v4-migration.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,uBAAuB,EAAE,CAAA;IACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;CACtB;AAqKD,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,EAAE,aAAiB,KAAG;IACvE,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;CAuCf,CAAA;AA+HD,eAAO,MAAM,cAAc,GACzB,UAAS;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,KACtE,OAAO,CAAC,sBAAsB,CAwBhC,CAAA"}

package/dist/v4-migration.js

@@ -0,0 +1,272 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { basename, extname, join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { scriptRegexRanges } from './source-script-ranges.js';
+const modules = new Map([
+    ['@modelcontextprotocol/sdk/client/index.js', '@modelcontextprotocol/client'],
+    ['@modelcontextprotocol/sdk/client/stdio.js', '@modelcontextprotocol/client/stdio'],
+    ['@modelcontextprotocol/sdk/server/mcp.js', '@modelcontextprotocol/server'],
+    ['@modelcontextprotocol/sdk/server/stdio.js', '@modelcontextprotocol/server/stdio']
+]);
+const sourceExtensions = new Set(['.astro', '.html', '.htm', '.js', '.jsx', '.mjs', '.ts', '.tsx', '.swift', '.kt', '.kts']);
+const ignored = new Set(['.git', '.build', '.astro', '.next', '.expo', '.turbo', '.wrangler', '.swiftpm', 'node_modules', 'dist', 'build', 'coverage', 'Pods', 'DerivedData', 'vendor']);
+const identifier = (character) => /[A-Za-z0-9_$]/u.test(character);
+const stringToken = (source, start, quote) => {
+    let end = start + 1;
+    while (end < source.length && source[end] !== quote)
+        end += source[end] === '\\' ? 2 : 1;
+    end = Math.min(end + 1, source.length);
+    return { end, kind: 'string', start, value: source.slice(start + 1, end - 1) };
+};
+const commentAt = (source, start) => {
+    if (source.startsWith('//', start)) {
+        const end = source.indexOf('\n', start + 2);
+        return end < 0 ? source.length : end;
+    }
+    if (source.startsWith('/*', start)) {
+        const end = source.indexOf('*/', start + 2);
+        return end < 0 ? source.length : end + 2;
+    }
+    return undefined;
+};
+// Comments and complete string/template literals are consumed once. Never edit text examples.
+const tokenAt = (source, start) => {
+    const character = source[start] ?? '';
+    if (/\s/u.test(character))
+        return start + 1;
+    const commentEnd = commentAt(source, start);
+    if (commentEnd !== undefined)
+        return commentEnd;
+    if (['"', '\'', '`'].includes(character))
+        return stringToken(source, start, character);
+    if (identifier(character)) {
+        let end = start + 1;
+        while (end < source.length && identifier(source[end] ?? ''))
+            end += 1;
+        return { end, kind: 'identifier', start, value: source.slice(start, end) };
+    }
+    return { end: start + 1, kind: 'punctuation', start, value: character };
+};
+const tokenize = (source, exclusions) => {
+    const tokens = [];
+    let cursor = 0;
+    while (cursor < source.length) {
+        const excludedEnd = exclusions.get(cursor);
+        if (excludedEnd !== undefined) {
+            cursor = excludedEnd;
+            continue;
+        }
+        const token = tokenAt(source, cursor);
+        if (typeof token === 'number')
+            cursor = token;
+        else {
+            tokens.push(token);
+            cursor = token.end;
+        }
+    }
+    return tokens;
+};
+const location = (source, index) => {
+    const prefix = source.slice(0, index);
+    return { column: index - prefix.lastIndexOf('\n'), line: prefix.split('\n').length };
+};
+const planImport = (source, token, state, startsLine) => {
+    if (token.value === 'import') {
+        state.inImport = startsLine;
+        state.afterFrom = false;
+        return undefined;
+    }
+    if (!state.inImport)
+        return undefined;
+    if ([';', '(', '='].includes(token.value)) {
+        state.inImport = false;
+        return undefined;
+    }
+    if (token.kind === 'identifier' && token.value === 'from') {
+        state.afterFrom = true;
+        return undefined;
+    }
+    if (token.kind !== 'string')
+        return undefined;
+    state.inImport = false;
+    const replacement = modules.get(token.value);
+    if (!state.afterFrom)
+        return undefined;
+    if (!replacement)
+        return undefined;
+    if (source[token.start] === '`')
+        return undefined;
+    return { end: token.end - 1, replacement, start: token.start + 1 };
+};
+const advancePosition = (source, end, position) => {
+    while (position.cursor < end) {
+        const character = source[position.cursor] ?? '';
+        if (character === '\n') {
+            position.line += 1;
+            position.column = 1;
+            position.blankPrefix = true;
+        }
+        else {
+            position.column += 1;
+            if (!/\s/u.test(character))
+                position.blankPrefix = false;
+        }
+        position.cursor += 1;
+    }
+};
+export const migrateLumenV4Source = (source, file = '<source>') => {
+    const exclusions = scriptRegexRanges(source, file);
+    if (!exclusions)
+        return { changes: [], source };
+    const edits = [];
+    const changes = [];
+    const state = { afterFrom: false, inImport: false };
+    const position = { blankPrefix: true, column: 1, cursor: 0, line: 1 };
+    for (const token of tokenize(source, exclusions)) {
+        advancePosition(source, token.start, position);
+        const edit = planImport(source, token, state, position.blankPrefix);
+        if (!edit)
+            continue;
+        edits.push(edit);
+        changes.push({
+            column: position.column,
+            line: position.line,
+            file,
+            message: `Replace ${token.value} with ${edit.replacement}; update SDK dependencies and rebuild together.`,
+            rule: 'embedded-mcp-sdk-v2'
+        });
+    }
+    let migrated = '';
+    let cursor = 0;
+    for (const edit of edits) {
+        migrated += source.slice(cursor, edit.start) + edit.replacement;
+        cursor = edit.end;
+    }
+    return { changes, source: migrated + source.slice(cursor) };
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const strings = (value) => {
+    if (!Array.isArray(value) || !value.every((entry) => typeof entry === 'string'))
+        throw new Error('Invalid v4 migration string list.');
+    return value;
+};
+const loadRules = async () => {
+    const value = JSON.parse(await readFile(new URL('../v4-migration.json', import.meta.url), 'utf8'));
+    if (!isRecord(value) || typeof value.targetVersion !== 'string' || !Array.isArray(value.changes))
+        throw new Error('Invalid v4 migration contract.');
+    const rules = value.changes.map((entry) => {
+        if (!isRecord(entry) || typeof entry.id !== 'string' || typeof entry.migration !== 'string')
+            throw new Error('Invalid v4 migration rule.');
+        return {
+            id: entry.id,
+            migration: entry.migration,
+            packages: strings(entry.packages),
+            signals: strings(entry.signals)
+        };
+    });
+    return { rules, targetVersion: value.targetVersion };
+};
+const discover = async (directory) => {
+    const files = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        if (entry.isSymbolicLink())
+            continue;
+        const path = join(directory, entry.name);
+        if (entry.isDirectory() && !ignored.has(entry.name))
+            files.push(...await discover(path));
+        else if (entry.isFile() && (sourceExtensions.has(extname(path)) || entry.name === 'package.json'))
+            files.push(path);
+    }
+    return files.sort();
+};
+const resolveInstalled = async (path, name, range) => {
+    const require = createRequire(pathToFileURL(path));
+    try {
+        const installed = JSON.parse(await readFile(require.resolve(`${name}/package.json`), 'utf8'));
+        if (isRecord(installed) && typeof installed.version === 'string')
+            return installed.version;
+        throw new Error(`Invalid installed package metadata for ${name}.`);
+    }
+    catch (error) {
+        if (!isRecord(error) || !['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(String(error.code)))
+            throw error;
+        return `unresolved:${range}`;
+    }
+};
+const inventoryGroup = async (path, group) => {
+    const result = {};
+    if (!isRecord(group))
+        return result;
+    for (const [name, range] of Object.entries(group)) {
+        if (!name.startsWith('@santi020k/lumen') && !name.startsWith('@modelcontextprotocol/'))
+            continue;
+        if (typeof range !== 'string')
+            throw new Error(`Invalid dependency version for ${name}.`);
+        result[name] = await resolveInstalled(path, name, range);
+    }
+    return result;
+};
+const inventory = async (path) => {
+    const value = JSON.parse(await readFile(path, 'utf8'));
+    if (!isRecord(value))
+        throw new Error(`Invalid package manifest: ${path}`);
+    const result = {};
+    for (const group of [value.dependencies, value.devDependencies, value.peerDependencies]) {
+        for (const [name, version] of Object.entries(await inventoryGroup(path, group)))
+            result[name] = version;
+    }
+    return result;
+};
+const reviewSource = (source, file, rules) => {
+    const usesLumen = source.includes('lumen') || source.includes('LumenUI') || source.includes('Lumen');
+    return rules.flatMap(rule => {
+        if (!usesLumen && rule.id !== 'embedded-mcp-sdk-v2')
+            return [];
+        const signal = rule.signals.find(value => source.includes(value));
+        if (!signal)
+            return [];
+        return [{ ...location(source, source.indexOf(signal)), file, message: rule.migration, rule: rule.id }];
+    });
+};
+const migrateFile = async (path, rules, report) => {
+    report.filesScanned += 1;
+    const file = relative(report.root, path);
+    const source = await readFile(path, 'utf8');
+    const webCode = ['.ts', '.js', '.mjs'].includes(extname(path));
+    const migration = webCode ? migrateLumenV4Source(source, file) : { changes: [], source };
+    report.changes.push(...migration.changes);
+    report.manualReview.push(...reviewSource(source, file, rules));
+    if (migration.source === source)
+        return;
+    report.changedFiles.push(file);
+    if (!report.applied)
+        return;
+    if (await readFile(path, 'utf8') !== source)
+        throw new Error(`Source changed during migration: ${file}`);
+    await writeFile(path, migration.source, 'utf8');
+};
+export const migrateLumenV4 = async (options = {}) => {
+    const root = resolve(options.cwd ?? process.cwd());
+    const { rules, targetVersion } = await loadRules();
+    const report = {
+        applied: options.apply === true,
+        changedFiles: [],
+        changes: [],
+        filesScanned: 0,
+        manualReview: [],
+        packageVersions: {},
+        root,
+        targetVersion
+    };
+    for (const path of await discover(root)) {
+        if (basename(path) === 'package.json') {
+            for (const [name, version] of Object.entries(await inventory(path))) {
+                report.packageVersions[`${relative(root, path)}:${name}`] = version;
+            }
+        }
+        else
+            await migrateFile(path, rules, report);
+    }
+    return report;
+};

package/dist/version-migration-dependencies.d.ts

@@ -0,0 +1,8 @@
+export interface LumenMigrationDependencyOptions {
+    allowDirty?: boolean;
+    apply?: boolean;
+    dependencies?: boolean;
+}
+/** Dependency mutations precede source edits so rollout's dirty-worktree guard stays authoritative. */
+export declare const applyLumenVersionMigrationDependencies: (root: string, targetVersion: string, options: LumenMigrationDependencyOptions) => Promise<import("./consumer-rollout.js").ConsumerRolloutReport>;
+//# sourceMappingURL=version-migration-dependencies.d.ts.map

package/dist/version-migration-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-migration-dependencies.d.ts","sourceRoot":"","sources":["../src/version-migration-dependencies.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,uGAAuG;AACvG,eAAO,MAAM,sCAAsC,GACjD,MAAM,MAAM,EACZ,eAAe,MAAM,EACrB,SAAS,+BAA+B,mEAQxC,CAAA"}

package/dist/version-migration-dependencies.js

@@ -0,0 +1,10 @@
+import { runConsumerRollout } from './consumer-rollout.js';
+/** Dependency mutations precede source edits so rollout's dirty-worktree guard stays authoritative. */
+export const applyLumenVersionMigrationDependencies = (root, targetVersion, options) => runConsumerRollout({
+    allowDirty: options.allowDirty === true,
+    apply: options.apply === true,
+    repositories: [root],
+    targetVersion,
+    // Verify after source migration, through the consumer's normal completion gate.
+    verify: false
+});

package/dist/version-migration-source.d.ts

@@ -0,0 +1,4 @@
+import type { LumenMigrationVersion, LumenVersionSourceMigration } from './version-migration.js';
+/** Assumes v3 input for v4. Filesystem apply uses a ledger to prevent repeated spacing rewrites. */
+export declare const migrateLumenVersionSource: (source: string, file: string, version: LumenMigrationVersion) => LumenVersionSourceMigration;
+//# sourceMappingURL=version-migration-source.d.ts.map

package/dist/version-migration-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-migration-source.d.ts","sourceRoot":"","sources":["../src/version-migration-source.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAgC,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AA8V9H,oGAAoG;AACpG,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,SAAS,qBAAqB,KAC7B,2BA4BF,CAAA"}