@aceshooting/lyra-ui 27.0.0 → 28.0.0

package/dist/cli/migrate-wa.mjs

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
-import fs from"node:fs";import path from"node:path";import{fileURLToPath}from"node:url";import{LYRA_RENAME_ORIGINS,compareVersions}from"./lyra-rename-ledger.mjs";import{MIGRATION_ORIGINS,buildMigrationContract,invariant,inventoryPath,packagedRuntime,readExportDeprecations,readRenameLedger}from"./migration-contract.mjs";import{migrateText}from"./migration-transforms.mjs";import{buildProjectDomFactoryBindings}from"./migration-analysis.mjs";import{MIGRATION_RUNTIME_SCHEMA_VERSION,MIGRATION_ORIGINS as MIGRATION_ORIGINS2,buildMigrationContract as buildMigrationContract2,createMigrationRuntimeInventory,readRenameLedger as readRenameLedger2,readExportDeprecations as readExportDeprecations2,buildMirrorMap}from"./migration-contract.mjs";import{scanUnrewrittenUpstreamReferences,migrateText as migrateText2}from"./migration-transforms.mjs";const MIGRATION_REPORT_SCHEMA_VERSION=1,DEFAULT_EXTENSIONS=new Set(["html","htm","ts","tsx","js","jsx","mjs","cjs","css","vue","svelte","mdx","md"]),IGNORE_DIR_NAMES=new Set(["node_modules","dist","build","coverage",".turbo",".cache"]);function diffLines(text){const lines=text.split(`
+import fs from"node:fs";import path from"node:path";import{fileURLToPath}from"node:url";import{LYRA_RENAME_ORIGINS,compareVersions}from"./lyra-rename-ledger.mjs";import{MIGRATION_ORIGINS,buildMigrationContract,invariant,inventoryPath,packagedRuntime,readExportDeprecations,readRenameLedger}from"./migration-contract.mjs";import{migrateText}from"./migration-transforms.mjs";import{buildProjectDomFactoryBindings}from"./migration-analysis.mjs";import{THEME_SCOPE_RULE,migrateThemeScopes}from"./migration-theme-scopes.mjs";import{MIGRATION_RUNTIME_SCHEMA_VERSION,MIGRATION_ORIGINS as MIGRATION_ORIGINS2,buildMigrationContract as buildMigrationContract2,createMigrationRuntimeInventory,readRenameLedger as readRenameLedger2,readExportDeprecations as readExportDeprecations2,buildMirrorMap}from"./migration-contract.mjs";import{scanUnrewrittenUpstreamReferences,migrateText as migrateText2}from"./migration-transforms.mjs";import{migrateThemeScopes as migrateThemeScopes2}from"./migration-theme-scopes.mjs";const MIGRATION_RULES=Object.freeze([THEME_SCOPE_RULE]);function migrateRuleFiles({files,rule,dryRun=!1,reportPath=null,cwd=process.cwd(),collectDiff=!1}){invariant(MIGRATION_RULES.includes(rule),`unknown migration rule ${String(rule)}`);const changes=[],warnings=[],diffs=[];let filesChanged=0;for(const file of files){const original=fs.readFileSync(file,"utf8"),result=migrateThemeScopes(original,{file:reportPathName(file,cwd)});changes.push(...result.changes),warnings.push(...result.warnings),result.content!==original&&(filesChanged+=1,collectDiff&&diffs.push(unifiedDiff(reportPathName(file,cwd),original,result.content)),dryRun||fs.writeFileSync(file,result.content,"utf8"))}const report={schemaVersion:MIGRATION_REPORT_SCHEMA_VERSION,rule,dryRun,filesScanned:files.length,filesChanged,changes,warnings,summary:{rewrites:changes.length,warnings:warnings.length}};return reportPath&&fs.writeFileSync(reportPath,`${JSON.stringify(report,null,2)}
+`,"utf8"),collectDiff?{...report,diff:diffs.join("")}:report}const MIGRATION_REPORT_SCHEMA_VERSION=1,DEFAULT_EXTENSIONS=new Set(["html","htm","ts","tsx","js","jsx","mjs","cjs","css","vue","svelte","mdx","md"]),IGNORE_DIR_NAMES=new Set(["node_modules","dist","build","coverage",".turbo",".cache"]);function diffLines(text){const lines=text.split(`
 `),eol=lines.at(-1)==="";return eol&&lines.pop(),lines.map((line,index)=>{const terminated=index<lines.length-1||eol;return{line,eol:terminated,key:terminated?line:`${line}\0`}})}function diffOperations(before,after){let prefix=0;for(;prefix<before.length&&prefix<after.length&&before[prefix].key===after[prefix].key;)prefix+=1;let suffix=0;for(;suffix<before.length-prefix&&suffix<after.length-prefix&&before[before.length-1-suffix].key===after[after.length-1-suffix].key;)suffix+=1;const a=before.slice(prefix,before.length-suffix),b=after.slice(prefix,after.length-suffix),goesDown=(frontier2,diagonal,depth)=>diagonal===-depth||diagonal!==depth&&frontier2.get(diagonal-1)<frontier2.get(diagonal+1),trace=[];let frontier=new Map([[1,0]]);search:for(let depth=0;depth<=a.length+b.length;depth+=1){trace.push(frontier);const next=new Map;for(let diagonal=-depth;diagonal<=depth;diagonal+=2){let x2=goesDown(frontier,diagonal,depth)?frontier.get(diagonal+1):frontier.get(diagonal-1)+1,y2=x2-diagonal;for(;x2<a.length&&y2<b.length&&a[x2].key===b[y2].key;)x2+=1,y2+=1;if(next.set(diagonal,x2),x2>=a.length&&y2>=b.length)break search}frontier=next}const middle=[];let x=a.length,y=b.length;for(let depth=trace.length-1;depth>=0;depth-=1){const previous=trace[depth],diagonal=x-y,previousDiagonal=goesDown(previous,diagonal,depth)?diagonal+1:diagonal-1,previousX=previous.get(previousDiagonal),previousY=previousX-previousDiagonal;for(;x>previousX&&y>previousY;)x-=1,y-=1,middle.push({type:" ",before:prefix+x,after:prefix+y});depth>0&&(x===previousX?middle.push({type:"+",after:prefix+y-1}):middle.push({type:"-",before:prefix+x-1})),x=previousX,y=previousY}middle.reverse();const operations=[];for(let index=0;index<prefix;index+=1)operations.push({type:" ",before:index,after:index});operations.push(...middle);for(let index=suffix;index>0;index-=1)operations.push({type:" ",before:before.length-index,after:after.length-index});return operations}function quoteDiffPath(file){if(/^[\x21-\x7e]+$/.test(file)&&!/["\\]/.test(file))return file;let quoted='"';for(const byte of Buffer.from(file,"utf8"))byte===34||byte===92?quoted+=`\\${String.fromCharCode(byte)}`:byte>=32&&byte<=126?quoted+=String.fromCharCode(byte):quoted+=`\\${byte.toString(8).padStart(3,"0")}`;return`${quoted}"`}function unifiedDiff(file,original,content,context=3){if(original===content)return"";const before=diffLines(original),after=diffLines(content),operations=diffOperations(before,after),beforeSeen=[0],afterSeen=[0];for(const operation of operations)beforeSeen.push(beforeSeen.at(-1)+(operation.type==="+"?0:1)),afterSeen.push(afterSeen.at(-1)+(operation.type==="-"?0:1));const hunks=[];operations.forEach((operation,index)=>{if(operation.type===" ")return;const last=hunks.at(-1);last&&index-last.end<=context*2+1?last.end=index:hunks.push({start:index,end:index})});const output=[`--- ${quoteDiffPath(`a/${file}`)}
 `,`+++ ${quoteDiffPath(`b/${file}`)}
 `];for(const hunk of hunks){const start=Math.max(0,hunk.start-context),end=Math.min(operations.length,hunk.end+context+1),beforeCount=beforeSeen[end]-beforeSeen[start],afterCount=afterSeen[end]-afterSeen[start],beforeStart=beforeSeen[start]+(beforeCount?1:0),afterStart=afterSeen[start]+(afterCount?1:0);output.push(`@@ -${beforeStart},${beforeCount} +${afterStart},${afterCount} @@
 `);for(const operation of operations.slice(start,end)){const record=operation.type==="+"?after[operation.after]:before[operation.before];output.push(`${operation.type}${record.line}
 `),record.eol||output.push(`\
 `)}}return output.join("")}function reportPathName(file,cwd){return(path.relative(cwd,file)||path.basename(file)).split(path.sep).join("/")}function migrateFiles({files,inventory,dryRun=!1,reportPath=null,cwd=process.cwd(),origin=null,renameLedger=null,exportDeprecations=[],lyraVersion=null,collectDiff=!1,compatibilityContext=null}){if(collectDiff){const outside=files.filter(file=>{const relative=path.relative(cwd,file);return relative===".."||relative.startsWith(`..${path.sep}`)||path.isAbsolute(relative)});if(outside.length)throw new Error(`--diff needs every target inside the working directory; run it from a common parent of ${outside.join(", ")}.`)}const contract=buildMigrationContract(inventory,{renameLedger,exportDeprecations,lyraVersion,compatibilityContext}),originals=new Map(files.map(file=>[file,fs.readFileSync(file,"utf8")])),diffs=[],noteDiff=(file,original,content)=>{collectDiff&&content!==original&&diffs.push(unifiedDiff(reportPathName(file,cwd),original,content))},finish=report=>(reportPath&&fs.writeFileSync(reportPath,`${JSON.stringify(report,null,2)}
-`,"utf8"),collectDiff?{...report,diff:diffs.join("")}:report);if(origin!==null){const renameProfile=contract.renameProfiles.has(origin);invariant(contract.localMigrations.has(origin)||renameProfile,`unknown local migration origin ${String(origin)}`);const blockedLocalMigrations=new Set,constructedEvents=new Set;for(const[file,original]of originals){const analysis=migrateText(original,contract,{file:reportPathName(file,cwd),origin});for(const key of analysis.blockedLocalMigrations)blockedLocalMigrations.add(key);for(const name of analysis.constructedEvents??[])constructedEvents.add(name)}const changes2=[],warnings2=[];let filesChanged2=0,acknowledged=0;for(const[file,original]of originals){const result=migrateText(original,contract,{file:reportPathName(file,cwd),origin,blockedLocalMigrations,constructedEvents});changes2.push(...result.changes),warnings2.push(...result.warnings),acknowledged+=result.acknowledged??0,result.content!==original&&(filesChanged2+=1,noteDiff(file,original,result.content),dryRun||fs.writeFileSync(file,result.content,"utf8"))}const sortEntries2=entries=>entries.sort((left,right)=>left.file.localeCompare(right.file)||left.line-right.line||left.column-right.column||left.action.localeCompare(right.action));sortEntries2(changes2),sortEntries2(warnings2);const summary={rewrites:changes2.length,warnings:warnings2.length};return renameProfile&&(summary.acknowledged=acknowledged,lyraVersion!==null&&(summary.skipped=contract.renameProfiles.get(origin).skipped.length)),finish({schemaVersion:MIGRATION_REPORT_SCHEMA_VERSION,origin,dryRun,filesScanned:files.length,filesChanged:filesChanged2,changes:changes2,warnings:warnings2,summary})}const domFactoryBindings=buildProjectDomFactoryBindings(originals),blockedMappings=new Set,blockedEcosystems=new Set,bareImportPackages=new Set,automaticMappings=new Set,deepRegistrationMappings=new Set,usage={webawesome:{automatic:0,manual:0},shoelace:{automatic:0,manual:0}};for(const[file,original]of originals){const analysis=migrateText(original,contract,{file:reportPathName(file,cwd),rewriteBarePackages:new Set,domFactoryBindings:domFactoryBindings.get(path.resolve(file))});for(const ecosystem of Object.keys(usage))usage[ecosystem].automatic+=analysis.usage[ecosystem].automatic,usage[ecosystem].manual+=analysis.usage[ecosystem].manual;for(const upstreamTag of analysis.blockedMappings)blockedMappings.add(upstreamTag);for(const ecosystem of analysis.blockedEcosystems)blockedEcosystems.add(ecosystem);for(const packageName of analysis.bareImportPackages)bareImportPackages.add(packageName);for(const upstreamTag of analysis.automaticMappings)automaticMappings.add(upstreamTag);for(const upstreamTag of analysis.deepRegistrationMappings)deepRegistrationMappings.add(upstreamTag)}for(const packageName of bareImportPackages){const identity=contract.packageIdentities.get(packageName);identity&&usage[identity.ecosystem].manual>0&&blockedEcosystems.add(identity.ecosystem)}const rewriteBarePackages=new Set([...bareImportPackages].filter(packageName=>{const identity=contract.packageIdentities.get(packageName);if(!identity)return!1;const counts=usage[identity.ecosystem];return counts.automatic>0&&counts.manual===0&&!blockedEcosystems.has(identity.ecosystem)})),rootRegistrationMappings=new Map([...bareImportPackages].map(packageName=>{const identity=contract.packageIdentities.get(packageName),relevant=new Set([...automaticMappings].filter(upstreamTag=>{const mapping=contract.mappings.get(upstreamTag);return!!(identity&&mapping?.upstream===identity.ecosystem&&(!mapping.source?.tier||identity.tiers.has(mapping.source.tier)))}));return[packageName,relevant]})),provenRegistrationMappings=new Set(deepRegistrationMappings);for(const packageName of rewriteBarePackages)for(const upstreamTag of rootRegistrationMappings.get(packageName)??[])provenRegistrationMappings.add(upstreamTag);const registrationBlockedMappings=new Set([...automaticMappings].filter(upstreamTag=>!provenRegistrationMappings.has(upstreamTag))),changes=[],warnings=[];let filesChanged=0;for(const[file,original]of originals){const result=migrateText(original,contract,{file:reportPathName(file,cwd),rewriteBarePackages,rootRegistrationMappings,blockedMappings,blockedEcosystems,registrationBlockedMappings,domFactoryBindings:domFactoryBindings.get(path.resolve(file))});changes.push(...result.changes),warnings.push(...result.warnings),result.content!==original&&(filesChanged+=1,noteDiff(file,original,result.content),dryRun||fs.writeFileSync(file,result.content,"utf8"))}const sortEntries=entries=>entries.sort((left,right)=>left.file.localeCompare(right.file)||left.line-right.line||left.column-right.column||left.action.localeCompare(right.action));return sortEntries(changes),sortEntries(warnings),finish({schemaVersion:MIGRATION_REPORT_SCHEMA_VERSION,origin:null,dryRun,filesScanned:files.length,filesChanged,changes,warnings,summary:{rewrites:changes.length,warnings:warnings.length}})}function parseArgs(argv){const options={check:!1,diff:!1,dryRun:!1,help:!1,extensions:DEFAULT_EXTENSIONS,lyraVersion:null,origin:null,report:null,targets:[]};let positional=!1;for(const argument of argv)if(!positional&&argument==="--")positional=!0;else if(!positional&&(argument==="--dry-run"||argument==="-n"))options.dryRun=!0;else if(!positional&&argument==="--check")options.check=!0,options.dryRun=!0;else if(!positional&&argument==="--diff")options.diff=!0,options.dryRun=!0;else if(!positional&&(argument==="--help"||argument==="-h"))options.help=!0;else if(!positional&&argument.startsWith("--ext="))options.extensions=new Set(argument.slice(6).split(",").map(extension=>extension.trim().replace(/^\./,"").toLowerCase()).filter(Boolean));else if(!positional&&argument.startsWith("--report=")){if(options.report=argument.slice(9),!options.report)throw new Error("--report requires a path")}else if(!positional&&argument.startsWith("--lyra-version=")){if(options.lyraVersion=argument.slice(15),compareVersions(options.lyraVersion,options.lyraVersion)!==0)throw new Error(`--lyra-version needs a version such as 22.0.0, got ${options.lyraVersion||"nothing"}`)}else if(!positional&&argument.startsWith("--origin=")){if(options.origin=argument.slice(9),!options.origin)throw new Error("--origin requires a value");if(!MIGRATION_ORIGINS.includes(options.origin))throw new Error(`Unknown migration origin: ${options.origin}`)}else{if(!positional&&argument.startsWith("-"))throw new Error(`Unknown option: ${argument}`);options.targets.push(argument)}return options}function printUsage(){console.log(`Usage: lyra-ui-migrate [--check] [--dry-run] [--diff] [--origin=${MIGRATION_ORIGINS.join("|")}] [--lyra-version=x.y.z] [--report=path] [--ext=html,ts,...] targets...
+`,"utf8"),collectDiff?{...report,diff:diffs.join("")}:report);if(origin!==null){const renameProfile=contract.renameProfiles.has(origin);invariant(contract.localMigrations.has(origin)||renameProfile,`unknown local migration origin ${String(origin)}`);const blockedLocalMigrations=new Set,constructedEvents=new Set;for(const[file,original]of originals){const analysis=migrateText(original,contract,{file:reportPathName(file,cwd),origin});for(const key of analysis.blockedLocalMigrations)blockedLocalMigrations.add(key);for(const name of analysis.constructedEvents??[])constructedEvents.add(name)}const changes2=[],warnings2=[];let filesChanged2=0,acknowledged=0;for(const[file,original]of originals){const result=migrateText(original,contract,{file:reportPathName(file,cwd),origin,blockedLocalMigrations,constructedEvents});changes2.push(...result.changes),warnings2.push(...result.warnings),acknowledged+=result.acknowledged??0,result.content!==original&&(filesChanged2+=1,noteDiff(file,original,result.content),dryRun||fs.writeFileSync(file,result.content,"utf8"))}const sortEntries2=entries=>entries.sort((left,right)=>left.file.localeCompare(right.file)||left.line-right.line||left.column-right.column||left.action.localeCompare(right.action));sortEntries2(changes2),sortEntries2(warnings2);const summary={rewrites:changes2.length,warnings:warnings2.length};return renameProfile&&(summary.acknowledged=acknowledged,lyraVersion!==null&&(summary.skipped=contract.renameProfiles.get(origin).skipped.length)),finish({schemaVersion:MIGRATION_REPORT_SCHEMA_VERSION,origin,dryRun,filesScanned:files.length,filesChanged:filesChanged2,changes:changes2,warnings:warnings2,summary})}const domFactoryBindings=buildProjectDomFactoryBindings(originals),blockedMappings=new Set,blockedEcosystems=new Set,bareImportPackages=new Set,automaticMappings=new Set,deepRegistrationMappings=new Set,usage={webawesome:{automatic:0,manual:0},shoelace:{automatic:0,manual:0}};for(const[file,original]of originals){const analysis=migrateText(original,contract,{file:reportPathName(file,cwd),rewriteBarePackages:new Set,domFactoryBindings:domFactoryBindings.get(path.resolve(file))});for(const ecosystem of Object.keys(usage))usage[ecosystem].automatic+=analysis.usage[ecosystem].automatic,usage[ecosystem].manual+=analysis.usage[ecosystem].manual;for(const upstreamTag of analysis.blockedMappings)blockedMappings.add(upstreamTag);for(const ecosystem of analysis.blockedEcosystems)blockedEcosystems.add(ecosystem);for(const packageName of analysis.bareImportPackages)bareImportPackages.add(packageName);for(const upstreamTag of analysis.automaticMappings)automaticMappings.add(upstreamTag);for(const upstreamTag of analysis.deepRegistrationMappings)deepRegistrationMappings.add(upstreamTag)}for(const packageName of bareImportPackages){const identity=contract.packageIdentities.get(packageName);identity&&usage[identity.ecosystem].manual>0&&blockedEcosystems.add(identity.ecosystem)}const rewriteBarePackages=new Set([...bareImportPackages].filter(packageName=>{const identity=contract.packageIdentities.get(packageName);if(!identity)return!1;const counts=usage[identity.ecosystem];return counts.automatic>0&&counts.manual===0&&!blockedEcosystems.has(identity.ecosystem)})),rootRegistrationMappings=new Map([...bareImportPackages].map(packageName=>{const identity=contract.packageIdentities.get(packageName),relevant=new Set([...automaticMappings].filter(upstreamTag=>{const mapping=contract.mappings.get(upstreamTag);return!!(identity&&mapping?.upstream===identity.ecosystem&&(!mapping.source?.tier||identity.tiers.has(mapping.source.tier)))}));return[packageName,relevant]})),provenRegistrationMappings=new Set(deepRegistrationMappings);for(const packageName of rewriteBarePackages)for(const upstreamTag of rootRegistrationMappings.get(packageName)??[])provenRegistrationMappings.add(upstreamTag);const registrationBlockedMappings=new Set([...automaticMappings].filter(upstreamTag=>!provenRegistrationMappings.has(upstreamTag))),changes=[],warnings=[];let filesChanged=0;for(const[file,original]of originals){const result=migrateText(original,contract,{file:reportPathName(file,cwd),rewriteBarePackages,rootRegistrationMappings,blockedMappings,blockedEcosystems,registrationBlockedMappings,domFactoryBindings:domFactoryBindings.get(path.resolve(file))});changes.push(...result.changes),warnings.push(...result.warnings),result.content!==original&&(filesChanged+=1,noteDiff(file,original,result.content),dryRun||fs.writeFileSync(file,result.content,"utf8"))}const sortEntries=entries=>entries.sort((left,right)=>left.file.localeCompare(right.file)||left.line-right.line||left.column-right.column||left.action.localeCompare(right.action));return sortEntries(changes),sortEntries(warnings),finish({schemaVersion:MIGRATION_REPORT_SCHEMA_VERSION,origin:null,dryRun,filesScanned:files.length,filesChanged,changes,warnings,summary:{rewrites:changes.length,warnings:warnings.length}})}function parseArgs(argv){const options={check:!1,diff:!1,dryRun:!1,help:!1,extensions:DEFAULT_EXTENSIONS,lyraVersion:null,origin:null,report:null,rule:null,targets:[]};let positional=!1;for(const argument of argv)if(!positional&&argument==="--")positional=!0;else if(!positional&&(argument==="--dry-run"||argument==="-n"))options.dryRun=!0;else if(!positional&&argument==="--check")options.check=!0,options.dryRun=!0;else if(!positional&&argument==="--diff")options.diff=!0,options.dryRun=!0;else if(!positional&&(argument==="--help"||argument==="-h"))options.help=!0;else if(!positional&&argument.startsWith("--ext="))options.extensions=new Set(argument.slice(6).split(",").map(extension=>extension.trim().replace(/^\./,"").toLowerCase()).filter(Boolean));else if(!positional&&argument.startsWith("--report=")){if(options.report=argument.slice(9),!options.report)throw new Error("--report requires a path")}else if(!positional&&argument.startsWith("--lyra-version=")){if(options.lyraVersion=argument.slice(15),compareVersions(options.lyraVersion,options.lyraVersion)!==0)throw new Error(`--lyra-version needs a version such as 22.0.0, got ${options.lyraVersion||"nothing"}`)}else if(!positional&&argument.startsWith("--origin=")){if(options.origin=argument.slice(9),!options.origin)throw new Error("--origin requires a value");if(!MIGRATION_ORIGINS.includes(options.origin))throw new Error(`Unknown migration origin: ${options.origin}`)}else if(!positional&&argument.startsWith("--rule=")){if(options.rule=argument.slice(7),!MIGRATION_RULES.includes(options.rule))throw new Error(`Unknown migration rule: ${options.rule}`)}else{if(!positional&&argument.startsWith("-"))throw new Error(`Unknown option: ${argument}`);options.targets.push(argument)}return options}function printUsage(){console.log(`Usage: lyra-ui-migrate [--check] [--dry-run] [--diff] [--origin=${MIGRATION_ORIGINS.join("|")}] [--rule=theme-scopes] [--lyra-version=x.y.z] [--report=path] [--ext=html,ts,...] targets...
 
 Only exact and fully rewritten inventory mappings change automatically. Conceptual, unsafe,
 unsupported, unknown, and unresolved deep-import uses remain unchanged with source-located
@@ -19,7 +20,7 @@ change what a site reaches, preserves changed defaults, and reports everything e
 listeners of events whose detail changed. --origin=lyra-v22 reports deprecated theme APIs,
 stylesheets, window events and root attributes; review their replacement semantics explicitly.
 --origin=lyra-v26 moves the package specifiers and root-barrel types that Lyra 27 relocated,
-reports removed localization keys. Lyra profiles never rewrite
+reports removed localization keys, and runs the theme-scopes rule. Lyra profiles never rewrite
 tags. Run a Lyra profile with the CLI of the installed release, after upgrading.
 
   --dry-run, -n        report changes without writing source files
@@ -28,6 +29,10 @@ tags. Run a Lyra profile with the CLI of the installed release, after upgrading.
   --origin=lyra-v21    migrate names and defaults that change from Lyra 21 to Lyra 22
   --origin=lyra-v22    review Lyra 22 module contracts retained through Lyra 23
   --origin=lyra-v26    move specifiers and types relocated in Lyra 27, report removed locale keys
+                       and apply --rule=theme-scopes
+  --rule=theme-scopes  Lyra 27: mark elements whose inline style sets a token-layer input with
+                       data-lr-theme-scope; report dynamic inputs, markers in loops, and CSS that
+                       sets inputs or shared outputs outside a theme scope (runs without --origin)
   --lyra-version=x.y.z apply only rename entries available in this release (default: the
                        @aceshooting/lyra-ui installed under the working directory, when found)
   --report=path        write the stable JSON migration report
@@ -36,4 +41,4 @@ tags. Run a Lyra profile with the CLI of the installed release, after upgrading.
 
 A reviewed rename-profile warning is acknowledged by a "lyra-migrate-reviewed: CODE:name" comment
 (for example DETAIL_SHAPE_REVIEW:lr-close) on the reported line, alone on the line above it, or
-directly before the reported element's opening tag.`)}function detectInstalledLyraVersion(directory=process.cwd()){let current=path.resolve(directory);for(;;){const manifest=path.join(current,"node_modules","@aceshooting","lyra-ui","package.json");if(fs.existsSync(manifest))try{const version=JSON.parse(fs.readFileSync(manifest,"utf8")).version;return compareVersions(version,version)===0?version:null}catch{return null}const parent=path.dirname(current);if(parent===current)return null;current=parent}}function walkDir(directory,filter){const files=[];for(const entry of fs.readdirSync(directory,{withFileTypes:!0})){if(entry.name.startsWith("."))continue;const target=path.join(directory,entry.name);entry.isDirectory()?IGNORE_DIR_NAMES.has(entry.name)||files.push(...walkDir(target,filter)):entry.isFile()&&filter(target,entry.name)&&files.push(target)}return files}function globToRegExp(segments){let source="^";for(let index=0;index<segments.length;index+=1){const segment=segments[index];segment==="**"?source+="(?:.*/)?":(source+=segment.replace(/[.+^${}()|[\]\\]/g,"\\$&").replace(/\*/g,"[^/]*").replace(/\?/g,"[^/]"),index<segments.length-1&&(source+="/"))}return new RegExp(`${source}$`)}function expandGlob(pattern){const segments=pattern.split(path.sep).join("/").split("/");let split=0;for(;split<segments.length&&!/[*?]/.test(segments[split]);)split+=1;const base=path.resolve(segments.slice(0,split).join("/")||".");if(!fs.existsSync(base)||!fs.statSync(base).isDirectory())return[];const regex=globToRegExp(segments.slice(split));return walkDir(base,()=>!0).filter(file=>regex.test(path.relative(base,file).split(path.sep).join("/")))}function collectFiles(targets,extensions){const files=new Set;for(const target of targets){if(/[*?]/.test(target)){for(const file of expandGlob(target))files.add(file);continue}const resolved=path.resolve(target);if(!fs.existsSync(resolved)){console.error(`warning: path not found, skipping: ${target}`);continue}if(fs.statSync(resolved).isDirectory())for(const file of walkDir(resolved,(_file,name)=>extensions.has(path.extname(name).slice(1).toLowerCase())))files.add(file);else files.add(resolved)}return[...files].sort()}function run(argv,{compatibilityContext=null,currentExportDeprecations=null}={}){let options;try{options=parseArgs(argv)}catch(error){return console.error(error instanceof Error?error.message:error),1}if(options.help||!options.targets.length)return printUsage(),options.help?0:1;const files=collectFiles(options.targets,options.extensions);if(!files.length)return console.error("No files matched the given path(s)/pattern(s)."),1;try{const inventory=JSON.parse(fs.readFileSync(inventoryPath,"utf8")),renameOrigin=LYRA_RENAME_ORIGINS.includes(options.origin),lyraVersion=renameOrigin?options.lyraVersion??detectInstalledLyraVersion():null,report=migrateFiles({files,inventory,dryRun:options.dryRun,origin:options.origin,renameLedger:packagedRuntime?null:readRenameLedger(),exportDeprecations:packagedRuntime?[]:currentExportDeprecations??readExportDeprecations(),compatibilityContext,lyraVersion,reportPath:options.report?path.resolve(options.report):null,collectDiff:options.diff}),log=options.diff?console.error:console.log;options.diff&&process.stdout.write(report.diff),renameOrigin&&log(lyraVersion===null?"No installed @aceshooting/lyra-ui found under the working directory; applying every entry of the profile.":`Applying entries available in @aceshooting/lyra-ui ${lyraVersion}`+(report.summary.skipped?`; ${report.summary.skipped} entr${report.summary.skipped===1?"y needs":"ies need"} a later release.`:"."));for(const entry of report.changes)log(`${entry.file}:${entry.line}:${entry.column}  ${entry.action}: ${entry.message}`);for(const entry of report.warnings)log(`${entry.file}:${entry.line}:${entry.column}  warning ${entry.warningCode}: ${entry.message}`);if(log(`${report.filesScanned} file(s) scanned, ${report.filesChanged} changed, ${report.summary.rewrites} rewrite(s), ${report.summary.warnings} warning(s)`+(Object.hasOwn(report.summary,"acknowledged")?`, ${report.summary.acknowledged} acknowledged.`:".")),options.dryRun&&report.filesChanged&&log("Dry run only -- no source files were written."),options.report&&log(`JSON report written to ${options.report}.`),options.check){const remaining=report.filesChanged>0||report.summary.warnings>0;return log(remaining?`Migration check failed: ${report.filesChanged} file(s) need changes and ${report.summary.warnings} warning(s) require review.`:"Migration check passed: no rewrites or warnings remain."),remaining?1:0}return 0}catch(error){return console.error(error instanceof Error?error.message:error),1}}function invokedAsCli(){const invoked=process.argv[1];if(!invoked)return!1;const here=fileURLToPath(import.meta.url);try{return fs.realpathSync(invoked)===fs.realpathSync(here)}catch{return path.resolve(invoked)===here}}if(invokedAsCli())if(packagedRuntime||process.argv.includes("--help")||process.argv.length<3)process.exitCode=run(process.argv.slice(2));else{const{readCurrentCompatibilityContext}=await import("./check-published-compatibility.mjs"),{readComponentMetadataSources,assembleComponentMetadata}=await import("./component-metadata-source.mjs"),packageRoot=path.resolve(path.dirname(fileURLToPath(import.meta.url)),".."),compatibilityContext=await readCurrentCompatibilityContext(packageRoot);process.exitCode=run(process.argv.slice(2),{compatibilityContext,currentExportDeprecations:assembleComponentMetadata(readComponentMetadataSources(packageRoot)).exportDeprecations})}export{MIGRATION_ORIGINS2 as MIGRATION_ORIGINS,MIGRATION_REPORT_SCHEMA_VERSION,MIGRATION_RUNTIME_SCHEMA_VERSION,buildMigrationContract2 as buildMigrationContract,buildMirrorMap,collectFiles,createMigrationRuntimeInventory,detectInstalledLyraVersion,migrateFiles,migrateText2 as migrateText,parseArgs,readExportDeprecations2 as readExportDeprecations,readRenameLedger2 as readRenameLedger,run,scanUnrewrittenUpstreamReferences,unifiedDiff};
+directly before the reported element's opening tag.`)}function detectInstalledLyraVersion(directory=process.cwd()){let current=path.resolve(directory);for(;;){const manifest=path.join(current,"node_modules","@aceshooting","lyra-ui","package.json");if(fs.existsSync(manifest))try{const version=JSON.parse(fs.readFileSync(manifest,"utf8")).version;return compareVersions(version,version)===0?version:null}catch{return null}const parent=path.dirname(current);if(parent===current)return null;current=parent}}function walkDir(directory,filter){const files=[];for(const entry of fs.readdirSync(directory,{withFileTypes:!0})){if(entry.name.startsWith("."))continue;const target=path.join(directory,entry.name);entry.isDirectory()?IGNORE_DIR_NAMES.has(entry.name)||files.push(...walkDir(target,filter)):entry.isFile()&&filter(target,entry.name)&&files.push(target)}return files}function globToRegExp(segments){let source="^";for(let index=0;index<segments.length;index+=1){const segment=segments[index];segment==="**"?source+="(?:.*/)?":(source+=segment.replace(/[.+^${}()|[\]\\]/g,"\\$&").replace(/\*/g,"[^/]*").replace(/\?/g,"[^/]"),index<segments.length-1&&(source+="/"))}return new RegExp(`${source}$`)}function expandGlob(pattern){const segments=pattern.split(path.sep).join("/").split("/");let split=0;for(;split<segments.length&&!/[*?]/.test(segments[split]);)split+=1;const base=path.resolve(segments.slice(0,split).join("/")||".");if(!fs.existsSync(base)||!fs.statSync(base).isDirectory())return[];const regex=globToRegExp(segments.slice(split));return walkDir(base,()=>!0).filter(file=>regex.test(path.relative(base,file).split(path.sep).join("/")))}function collectFiles(targets,extensions){const files=new Set;for(const target of targets){if(/[*?]/.test(target)){for(const file of expandGlob(target))files.add(file);continue}const resolved=path.resolve(target);if(!fs.existsSync(resolved)){console.error(`warning: path not found, skipping: ${target}`);continue}if(fs.statSync(resolved).isDirectory())for(const file of walkDir(resolved,(_file,name)=>extensions.has(path.extname(name).slice(1).toLowerCase())))files.add(file);else files.add(resolved)}return[...files].sort()}function run(argv,{compatibilityContext=null,currentExportDeprecations=null}={}){let options;try{options=parseArgs(argv)}catch(error){return console.error(error instanceof Error?error.message:error),1}if(options.help||!options.targets.length)return printUsage(),options.help?0:1;const files=collectFiles(options.targets,options.extensions);if(!files.length)return console.error("No files matched the given path(s)/pattern(s)."),1;if(options.rule!==null&&options.origin!==null)return console.error("--rule runs on its own; omit --origin."),1;try{if(options.rule!==null){const report2=migrateRuleFiles({files,rule:options.rule,dryRun:options.dryRun,reportPath:options.report?path.resolve(options.report):null,collectDiff:options.diff}),log2=options.diff?console.error:console.log;options.diff&&process.stdout.write(report2.diff);for(const entry of report2.changes)log2(`${entry.file}:${entry.line}:${entry.column}  ${entry.action}: ${entry.message}`);for(const entry of report2.warnings)log2(`${entry.file}:${entry.line}:${entry.column}  warning ${entry.warningCode}: ${entry.message}`);return log2(`${report2.filesScanned} file(s) scanned, ${report2.filesChanged} changed, ${report2.summary.rewrites} rewrite(s), ${report2.summary.warnings} warning(s).`),options.dryRun&&report2.filesChanged&&log2("Dry run only -- no source files were written."),options.report&&log2(`JSON report written to ${options.report}.`),options.check&&(report2.filesChanged>0||report2.summary.warnings>0)?1:0}const inventory=JSON.parse(fs.readFileSync(inventoryPath,"utf8")),renameOrigin=LYRA_RENAME_ORIGINS.includes(options.origin),lyraVersion=renameOrigin?options.lyraVersion??detectInstalledLyraVersion():null,report=migrateFiles({files,inventory,dryRun:options.dryRun,origin:options.origin,renameLedger:packagedRuntime?null:readRenameLedger(),exportDeprecations:packagedRuntime?[]:currentExportDeprecations??readExportDeprecations(),compatibilityContext,lyraVersion,reportPath:options.report?path.resolve(options.report):null,collectDiff:options.diff}),log=options.diff?console.error:console.log;options.diff&&process.stdout.write(report.diff),renameOrigin&&log(lyraVersion===null?"No installed @aceshooting/lyra-ui found under the working directory; applying every entry of the profile.":`Applying entries available in @aceshooting/lyra-ui ${lyraVersion}`+(report.summary.skipped?`; ${report.summary.skipped} entr${report.summary.skipped===1?"y needs":"ies need"} a later release.`:"."));for(const entry of report.changes)log(`${entry.file}:${entry.line}:${entry.column}  ${entry.action}: ${entry.message}`);for(const entry of report.warnings)log(`${entry.file}:${entry.line}:${entry.column}  warning ${entry.warningCode}: ${entry.message}`);if(log(`${report.filesScanned} file(s) scanned, ${report.filesChanged} changed, ${report.summary.rewrites} rewrite(s), ${report.summary.warnings} warning(s)`+(Object.hasOwn(report.summary,"acknowledged")?`, ${report.summary.acknowledged} acknowledged.`:".")),options.dryRun&&report.filesChanged&&log("Dry run only -- no source files were written."),options.report&&log(`JSON report written to ${options.report}.`),options.check){const remaining=report.filesChanged>0||report.summary.warnings>0;return log(remaining?`Migration check failed: ${report.filesChanged} file(s) need changes and ${report.summary.warnings} warning(s) require review.`:"Migration check passed: no rewrites or warnings remain."),remaining?1:0}return 0}catch(error){return console.error(error instanceof Error?error.message:error),1}}function invokedAsCli(){const invoked=process.argv[1];if(!invoked)return!1;const here=fileURLToPath(import.meta.url);try{return fs.realpathSync(invoked)===fs.realpathSync(here)}catch{return path.resolve(invoked)===here}}if(invokedAsCli())if(packagedRuntime||process.argv.includes("--help")||process.argv.length<3)process.exitCode=run(process.argv.slice(2));else{const{readCurrentCompatibilityContext}=await import("./check-published-compatibility.mjs"),{readComponentMetadataSources,assembleComponentMetadata}=await import("./component-metadata-source.mjs"),packageRoot=path.resolve(path.dirname(fileURLToPath(import.meta.url)),".."),compatibilityContext=await readCurrentCompatibilityContext(packageRoot);process.exitCode=run(process.argv.slice(2),{compatibilityContext,currentExportDeprecations:assembleComponentMetadata(readComponentMetadataSources(packageRoot)).exportDeprecations})}export{MIGRATION_ORIGINS2 as MIGRATION_ORIGINS,MIGRATION_REPORT_SCHEMA_VERSION,MIGRATION_RULES,MIGRATION_RUNTIME_SCHEMA_VERSION,buildMigrationContract2 as buildMigrationContract,buildMirrorMap,collectFiles,createMigrationRuntimeInventory,detectInstalledLyraVersion,migrateFiles,migrateRuleFiles,migrateText2 as migrateText,migrateThemeScopes2 as migrateThemeScopes,parseArgs,readExportDeprecations2 as readExportDeprecations,readRenameLedger2 as readRenameLedger,run,scanUnrewrittenUpstreamReferences,unifiedDiff};