@aceshooting/lyra-ui 26.0.0 → 27.0.0

package/dist/cli/init-agents.mjs

@@ -0,0 +1,40 @@
+import{cpSync,existsSync,lstatSync,mkdirSync,readFileSync,readdirSync,readlinkSync,realpathSync,rmSync,symlinkSync,writeFileSync}from"node:fs";import path from"node:path";import{createInterface}from"node:readline";import{fileURLToPath}from"node:url";import{AGENTS,AGENT_IDS,UNIVERSAL_SKILL_DIR,detectCaller}from"./agent-registry.mjs";const BLOCK_START="<!-- lyra-ui:start -->",BLOCK_END="<!-- lyra-ui:end -->",MANAGED_MARKER=".lyra-ui-managed",PACKAGE_NAME="@aceshooting/lyra-ui",INSTRUCTION_BLOCK=[BLOCK_START,"## Lyra UI (@aceshooting/lyra-ui)","","Before writing or reviewing any `lr-*` markup, use the `lyra-ui` skill (if your agent loads skills)","or read `node_modules/@aceshooting/lyra-ui/llms.txt`; never guess attributes, slots, events or","imports. One component: `node_modules/@aceshooting/lyra-ui/llms/components/<tag>.md`. Page and","layout design: the `compose-lyra-interfaces` skill. Refresh with `npx lyra-ui init-agents`.",BLOCK_END].join(`
+`),agentList=AGENTS.map(agent=>agent.id).join(","),AGENTS_MD_NOTE="AGENTS.md now carries the pointer block.",HELP=`Usage: lyra-ui init-agents [options]
+
+AI coding agents: run \`npx lyra-ui init-agents\` (add \`--agent <name>\` if you are not auto-detected) to
+install the Lyra UI skill for yourself. It prints what was installed (absolute paths) and what to do
+next so the skill loads; add \`--json\` for a machine-readable result.
+
+Sets up AI coding agents (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Amp,
+Windsurf, ...) for this project: installs the Lyra UI skills bundled in
+node_modules/${PACKAGE_NAME}/skills/ and adds or refreshes a short block between ${BLOCK_START}
+and ${BLOCK_END} in AGENTS.md (created if missing; read by most agents) and CLAUDE.md (only if it
+exists and does not import AGENTS.md). Safe to re-run; content outside the block and unrelated skill
+directories are never modified.
+
+The shared ${UNIVERSAL_SKILL_DIR}/ directory is always installed. Agents that read another
+directory (today: Claude Code, .claude/skills) get a link to it. Which agents, in order: --agent(s);
+the invoking agent, detected from its documented environment (Claude Code, Gemini CLI); agents
+detected from project config; in a terminal without any of those, a prompt for humans.
+
+Options:
+  --agent, --agents <list>  ${agentList}, or "all"; overrides everything else
+  --yes, -y              never prompt; use the invoking or detected agents
+  --json                 print one JSON object instead of text
+  --copy                 copy the skills instead of symlinking them to node_modules (a symlink
+                         follows package upgrades; a copy is committable and refreshed by re-running)
+  --link                 convert a previously managed copy back to a symlink
+  --dry-run, -n          print what would change and write nothing
+  --force                replace an existing skill directory that this tool did not create
+  --dir <path>           project directory (default: the current directory)
+  --help, -h             show this message
+`;function parseArguments(argv){const options={agents:void 0,yes:!1,json:!1,mode:void 0,dryRun:!1,force:!1,dir:void 0,help:!1};for(let index=0;index<argv.length;index+=1){const argument=argv[index],[flag,inline]=argument.startsWith("--")?argument.split(/=(.*)/su,2):[argument],value=()=>{const next=inline??argv[++index];if(next===void 0||next.startsWith("--"))throw new Error(`${flag} needs a value`);return next};if(flag==="--help"||flag==="-h")options.help=!0;else if(flag==="--dry-run"||flag==="-n")options.dryRun=!0;else if(flag==="--force")options.force=!0;else if(flag==="--yes"||flag==="-y")options.yes=!0;else if(flag==="--json")options.json=!0;else if(flag==="--copy")options.mode="copy";else if(flag==="--link")options.mode="link";else if(flag==="--dir")options.dir=value();else if(flag==="--agents"||flag==="--agent"){const names=[...new Set(value().split(",").map(name=>name.trim().toLowerCase()).filter(Boolean))],unknown=names.filter(name=>name!=="all"&&!AGENT_IDS.includes(name));if(unknown.length>0||names.length===0)throw new Error(`${flag} accepts ${AGENT_IDS.join(", ")} or all; got "${unknown.join(",")}"`);options.agents=names.includes("all")?[...AGENT_IDS]:names}else throw new Error(`unknown option ${argument}`)}return options}function detectAgents(projectDir){return AGENTS.filter(agent=>agent.detect.some(entry=>existsSync(path.join(projectDir,entry)))).map(agent=>agent.id)}function applySelectionInput(input,selected){const text=input.trim().toLowerCase();if(text==="")return{selected:[...selected],done:!0};if(text==="a"||text==="all")return{selected:[...AGENT_IDS],done:!1};if(text==="n"||text==="none")return{selected:[],done:!1};const next=new Set(selected);for(const token of text.split(/[\s,]+/u).filter(Boolean)){const number=Number(token),id=Number.isInteger(number)?AGENT_IDS[number-1]:AGENT_IDS.find(candidate=>candidate===token);if(!id)return{selected:[...selected],done:!1,error:`"${token}" is not a listed number or agent`};next.has(id)?next.delete(id):next.add(id)}return{selected:AGENT_IDS.filter(id=>next.has(id)),done:!1}}function renderSelection(selected){const lines=[`Which AI coding agents should be set up? ${UNIVERSAL_SKILL_DIR}/ (shared) is always installed.`];return AGENTS.forEach((agent,index)=>{const where=agent.ownSkillDir?`needs ${agent.ownSkillDir}/`:`reads ${UNIVERSAL_SKILL_DIR}/`;lines.push(`  ${String(index+1).padStart(2)}. [${selected.includes(agent.id)?"x":" "}] ${agent.name} (${where})`)}),lines.push('Type numbers to toggle (e.g. "1 3"), a = all, n = none, Enter = confirm.'),lines.join(`
+`)}async function promptForAgents(initial,input,output){const rl=createInterface({input,output}),queue=[];let waiter=null,closed=!1;rl.on("line",line=>{if(waiter){const resolve=waiter;waiter=null,resolve(line)}else queue.push(line)}),rl.on("close",()=>{closed=!0,waiter&&waiter(null)});const nextLine=()=>new Promise(resolve=>{queue.length>0?resolve(queue.shift()):closed?resolve(null):waiter=resolve});let selected=[...initial];try{for(;;){output.write(`${renderSelection(selected)}
+> `);const answer=await nextLine();if(answer===null)return selected;const result=applySelectionInput(answer,selected);if(selected=result.selected,result.error&&output.write(`${result.error}
+`),result.done)return selected}}finally{rl.close()}}function findPackageRoot(fromDirectory){let directory=fromDirectory;for(;;){const manifest=path.join(directory,"package.json");if(existsSync(manifest))try{if(JSON.parse(readFileSync(manifest,"utf8")).name===PACKAGE_NAME)return directory}catch{}const parent=path.dirname(directory);if(parent===directory)return;directory=parent}}function listFiles(directory,prefix=""){return readdirSync(directory,{withFileTypes:!0}).flatMap(entry=>{const relative=prefix?`${prefix}/${entry.name}`:entry.name;return entry.isDirectory()?listFiles(path.join(directory,entry.name),relative):[relative]}).sort()}function sameTree(left,right){const leftFiles=listFiles(left).filter(file=>file!==MANAGED_MARKER),rightFiles=listFiles(right).filter(file=>file!==MANAGED_MARKER);return leftFiles.length===rightFiles.length&&leftFiles.every((file,index)=>file===rightFiles[index]&&readFileSync(path.join(left,file)).equals(readFileSync(path.join(right,file))))}const exists=target=>{try{return lstatSync(target),!0}catch{return!1}};function bundledSkills(packageRoot){const skillsRoot=path.join(packageRoot,"skills");return existsSync(skillsRoot)?readdirSync(skillsRoot,{withFileTypes:!0}).filter(entry=>entry.isDirectory()&&existsSync(path.join(skillsRoot,entry.name,"SKILL.md"))).map(entry=>entry.name).sort():[]}function stablePackageRoot(projectDir,packageRoot){let directory=projectDir;for(;;){const candidate=path.join(directory,"node_modules",...PACKAGE_NAME.split("/"));try{if(realpathSync(candidate)===realpathSync(packageRoot))return candidate}catch{}const parent=path.dirname(directory);if(parent===directory)return packageRoot;directory=parent}}function applyInstructionBlock(original){const eol=original.includes(`\r
+`)?`\r
+`:`
+`,block=INSTRUCTION_BLOCK.replaceAll(`
+`,eol),start=original.indexOf(BLOCK_START);if(start!==-1){const endMarker=original.indexOf(BLOCK_END,start);if(endMarker===-1)return{error:`${BLOCK_START} has no matching ${BLOCK_END}`};const end=endMarker+BLOCK_END.length;return{text:original.slice(0,start)+block+original.slice(end)}}if(original.includes(BLOCK_END))return{error:`${BLOCK_END} without ${BLOCK_START}`};if(original.trim()==="")return{text:block+eol};const separator=original.endsWith(eol+eol)?"":original.endsWith(eol)?eol:eol+eol;return{text:original+separator+block+eol}}async function runInitAgents(argv,environment={}){const out=environment.stdout??(line=>console.log(line)),err=environment.stderr??(line=>console.error(line));let options;try{options=parseArguments(argv)}catch(error){return err(`lyra-ui init-agents: ${error.message}
+
+${HELP}`),2}if(options.help)return out(HELP),0;const packageRoot=environment.packageRoot??findPackageRoot(path.dirname(fileURLToPath(import.meta.url))),skills=packageRoot?bundledSkills(packageRoot):[];if(!packageRoot||skills.length===0)return err(`lyra-ui init-agents: no bundled skills found${packageRoot?` in ${path.join(packageRoot,"skills")}`:""}.`),1;const projectDir=path.resolve(environment.cwd??process.cwd(),options.dir??".");if(!existsSync(projectDir)||!lstatSync(projectDir).isDirectory())return err(`lyra-ui init-agents: ${projectDir} is not a directory.`),1;const detected=detectAgents(projectDir),caller=detectCaller(environment.env??process.env),input=environment.input??process.stdin,output=environment.output??process.stdout,interactive=options.agents===void 0&&caller===void 0&&!options.yes&&!options.json&&!!input.isTTY&&!!output.isTTY;let selectedIds,source;options.agents?[selectedIds,source]=[options.agents,"flag"]:caller?[selectedIds,source]=[[caller],"caller"]:interactive?[selectedIds,source]=[await promptForAgents(detected,input,output),"prompt"]:[selectedIds,source]=[detected,"detected"];const selected=AGENTS.filter(agent=>selectedIds.includes(agent.id)),ownDirectories=selected.filter(agent=>agent.ownSkillDir),linkSource=stablePackageRoot(projectDir,packageRoot),platform=environment.platform??process.platform,dry=options.dryRun,rel=target=>path.relative(projectDir,target).split(path.sep).join("/")||".",records=[];let failed=!1;const report=(status,text)=>{const[first,...rest]=text.split(" ");records.push({status,path:path.join(projectDir,first.replace(/:$/u,"")),detail:rest.join(" ")||void 0,error:status==="error"?text:void 0})},named=agents=>agents.map(agent=>agent.name).join(", ")||"none",sourceLabel={flag:"from --agents",caller:"invoking agent detected",prompt:"selected",detected:"detected in the project"}[source];for(const skill of skills){const bundled=path.join(packageRoot,"skills",skill),canonical=path.join(projectDir,UNIVERSAL_SKILL_DIR,skill),targets=[{target:canonical,label:rel(canonical),canonical:!0,linkTarget:path.relative(path.dirname(canonical),path.join(linkSource,"skills",skill)).split(path.sep).join("/")},...ownDirectories.map(agent=>{const target=path.join(projectDir,agent.ownSkillDir,skill);return{target,label:rel(target),canonical:!1,linkTarget:path.relative(path.dirname(target),canonical).split(path.sep).join("/")}})];for(const entry of targets)try{installSkill({...entry,bundled,options,platform,dry,report})}catch(error){failed=!0,report("error",`${entry.label}: ${error.message}`)}}for(const name of["AGENTS.md","CLAUDE.md"]){const target=path.join(projectDir,name);try{const present=existsSync(target);if(!present&&name==="CLAUDE.md")continue;const original=present?readFileSync(target,"utf8"):"";if(name==="CLAUDE.md"&&/^@AGENTS\.md\s*$/mu.test(original)){report("skipped","CLAUDE.md (imports AGENTS.md, which carries the block)");continue}const next2=applyInstructionBlock(original);next2.error?(failed=!0,report("error",`${name}: ${next2.error}; fix the markers by hand and re-run`)):next2.text===original?report("unchanged",`${name} (block up to date)`):(dry||writeFileSync(target,next2.text),report(present?original.includes(BLOCK_START)?"updated":"added":"created",`${name} (${present?"pointer block":"with pointer block"})`))}catch(error){failed=!0,report("error",`${name}: ${error.message}`)}}const dangling=!dry&&records.some(record=>record.status==="linked")&&!existsSync(path.join(projectDir,"node_modules",...PACKAGE_NAME.split("/"))),next=[];if(!failed){const targets=selected.length>0?selected:[];for(const agent of targets)next.push(`${agent.name}: ${agent.reload}.`);targets.length===0&&next.push(`Agents reading ${UNIVERSAL_SKILL_DIR}/ (Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Amp, Windsurf) pick the skill up on their next session; ${AGENTS_MD_NOTE}`),dangling&&next.push("Skills link into node_modules: run your package manager's install first, or re-run with --copy."),source!=="flag"&&next.push(`Not you? Re-run with --agent <${AGENT_IDS.join("|")}> or --agents all.`)}const code=failed?1:0;if(options.json)return out(JSON.stringify({ok:!failed,dryRun:dry,projectDir,agents:{source,caller:caller??null,selected:selected.map(agent=>agent.id),detected},changes:records.map(({status,path:target,detail,error})=>({status,path:target,...detail?{detail}:{},...error?{error}:{}})),next},null,2)),code;const shown=record=>interactive?rel(record.path):record.path;out(`${dry?"lyra-ui init-agents (dry run, nothing written)":"lyra-ui init-agents"} in ${projectDir}`),out(`Agents: ${UNIVERSAL_SKILL_DIR}/ (shared) + ${named(selected)} (${sourceLabel})`);for(const record of records)out(`  ${record.status.padEnd(10)}${shown(record)}${record.detail?` ${record.detail}`:""}`);if(!failed&&(out(dry?"Dry run: nothing was written; run without --dry-run to apply.":"Done."),next.length>0)){out("Next:");for(const line of next)out(`  - ${line}`)}return code}function installSkill({target,bundled,linkTarget,label,canonical,options,platform,dry,report}){const wantsCopy=canonical&&options.mode==="copy"||platform==="win32",present=exists(target),stat=present?lstatSync(target):void 0;let managedCopy=!1;if(stat?.isSymbolicLink()){const current=readlinkSync(target).split(path.sep).join("/");if(!(/@aceshooting\/lyra-ui\/skills\//u.test(current)||current===linkTarget||/(?:^|\/)\.agents\/skills\/[^/]+$/u.test(current))&&!options.force){report("skipped",`${label} (symlink to ${current} is not managed by lyra-ui; use --force to replace)`);return}if(!wantsCopy&&current===linkTarget){report("unchanged",`${label} -> ${linkTarget}`);return}}else if(stat?.isDirectory()){if(managedCopy=existsSync(path.join(target,MANAGED_MARKER)),!managedCopy&&!options.force){report("skipped",`${label} (existing directory not created by lyra-ui; use --force to replace)`);return}if(managedCopy&&options.mode!=="link"){if(sameTree(bundled,target)){report("unchanged",`${label} (copy up to date)`);return}dry||copySkill(bundled,target),report("updated",`${label} (copy refreshed)`);return}}else if(present&&!options.force){report("skipped",`${label} (exists and is not a directory; use --force to replace)`);return}const status=present?"updated":"created";if(dry){report(status,`${label} ${wantsCopy?"(copy)":`-> ${linkTarget}`}`);return}if(present&&rmSync(target,{recursive:!0,force:!0}),mkdirSync(path.dirname(target),{recursive:!0}),wantsCopy){copySkill(bundled,target),report(status,`${label} (copy${platform==="win32"&&options.mode!=="copy"?", symlinks skipped on Windows":""})`);return}try{symlinkSync(linkTarget,target,"dir"),report(status==="created"?"linked":"relinked",`${label} -> ${linkTarget}`)}catch(error){copySkill(bundled,target),report(status,`${label} (copy; symlink failed: ${error.code??error.message})`)}}function copySkill(source,target){rmSync(target,{recursive:!0,force:!0}),cpSync(source,target,{recursive:!0}),writeFileSync(path.join(target,MANAGED_MARKER),"Managed by `npx lyra-ui init-agents`; re-run it to refresh this copy.\n")}export{BLOCK_END,BLOCK_START,INSTRUCTION_BLOCK,MANAGED_MARKER,applyInstructionBlock,applySelectionInput,bundledSkills,detectAgents,findPackageRoot,parseArguments,runInitAgents};

package/dist/cli/is-main-module.mjs

@@ -0,0 +1 @@
+import{realpathSync}from"node:fs";import{fileURLToPath}from"node:url";function isMainModule(moduleUrl,invokedPath=process.argv[1]){if(!invokedPath)return!1;try{return realpathSync(invokedPath)===realpathSync(fileURLToPath(moduleUrl))}catch{return!1}}export{isMainModule};

package/dist/cli/lyra-rename-ledger.mjs

@@ -1 +1 @@
-const LYRA_RENAME_LEDGER_SCHEMA_VERSION=1,UNRELEASED_VERSION="unreleased",LYRA_RENAME_PROFILES=Object.freeze([Object.freeze({origin:"lyra-v21",fromMajor:21,toMajor:22,aliasRemovalMajor:23}),Object.freeze({origin:"lyra-v22",fromMajor:22,toMajor:23,aliasRemovalMajor:24}),Object.freeze({origin:"lyra-v25",fromMajor:25,toMajor:26,aliasRemovalMajor:28})]),LYRA_RENAME_ORIGINS=Object.freeze(LYRA_RENAME_PROFILES.map(profile=>profile.origin)),RENAME_KINDS=Object.freeze(["attribute","property","event","part","css-property","slot"]),REVIEW_KINDS=Object.freeze(["component","attribute","property","event","slot","part","css-property","css-state","method"]),EXPOSURE_KINDS=Object.freeze(["event","part","css-property"]),SURFACE_SECTIONS=Object.freeze({attribute:"attributes",property:"properties",event:"events",part:"parts","css-property":"cssProperties",slot:"slots","css-state":"cssStates",method:"methods"}),TAG_PATTERN=/^lr-[a-z0-9]+(?:-[a-z0-9]+)*$/,ELEMENT_PATTERN=/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/,JS_IDENTIFIER_PATTERN=/^[A-Za-z_$][\w$]*$/,VERSION_PATTERN=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/,NAME_PATTERNS=Object.freeze({component:TAG_PATTERN,attribute:/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/,property:JS_IDENTIFIER_PATTERN,method:JS_IDENTIFIER_PATTERN,event:/^lr-[a-z0-9]+(?:-[a-z0-9]+)*$/,part:/^[A-Za-z0-9_-]+$/,slot:/^(?:[A-Za-z0-9_-]+)?$/,"css-property":/^--[A-Za-z0-9_-]+$/,"css-state":/^[a-z][a-z0-9-]*$/}),MODULE_REVIEW_KINDS=["entry-point","stylesheet","function","type","constant","class","window-event","root-attribute"],MODULE_PATH_PATTERN=/^\.\/[A-Za-z0-9_./-]+\.(?:js|css)$/,moduleReviewKey=entry=>[entry.kind,entry.module??"",entry.name].join("\0"),PROFILE_LIST_KEYS=["renames","defaults","detailChanges","detailFields","propertyChanges","retiredEvents","reviews","slotContent","moduleReviews"],AUTHORED_PROFILE_KEYS=["origin","fromMajor","toMajor","aliasRemovalMajor",...PROFILE_LIST_KEYS],PROJECTED_PROFILE_KEYS=[...AUTHORED_PROFILE_KEYS,"exposure"];function isPlainObject(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function unknownKeys(value,allowed){return Object.keys(value).filter(key=>!allowed.includes(key))}function compareText(left,right){return left<right?-1:left>right?1:0}function parseVersion(version){const match=VERSION_PATTERN.exec(String(version??""));return match?match.slice(1,4).map(Number):null}function compareVersions(left,right){const a=parseVersion(left),b=parseVersion(right);if(!a||!b)return null;for(let index=0;index<3;index+=1)if(a[index]!==b[index])return a[index]-b[index];return 0}function majorOf(version){return parseVersion(version)?.[0]??null}function emptyRenameLedger(){return{schemaVersion:1,profiles:LYRA_RENAME_PROFILES.map(header=>({...header,...Object.fromEntries(PROFILE_LIST_KEYS.filter(list=>list!=="detailFields").map(list=>[list,[]]))}))}}function emptyRenameProjection(){return{schemaVersion:1,profiles:emptyRenameLedger().profiles.map(profile=>({...profile,exposure:Object.fromEntries(EXPOSURE_KINDS.map(kind=>[kind,{}]))}))}}function entryLabel(origin,list,entry){return list==="moduleReviews"?`${origin}: module review ${entry?.kind} ${entry?.module??""} ${entry?.name}`:list==="renames"?`${origin}: rename ${entry?.tag} ${entry?.kind} ${entry?.from}`:list==="defaults"?`${origin}: default ${entry?.tag} ${entry?.attribute}`:list==="retiredEvents"?`${origin}: retired event ${entry?.tag} ${entry?.event}`:list==="detailChanges"?`${origin}: detail change ${entry?.tag} ${entry?.event}`:list==="detailFields"?`${origin}: detail field ${entry?.tag} ${entry?.event} ${entry?.detailType}.${entry?.field}`:list==="propertyChanges"?`${origin}: property change ${entry?.tag} ${entry?.property}`:list==="slotContent"?`${origin}: slot content ${entry?.tag} ${JSON.stringify(entry?.slot??null)}`:`${origin}: review ${entry?.tag} ${entry?.kind} ${JSON.stringify(entry?.name??null)}`}function sortKey(list,entry){return list==="moduleReviews"?moduleReviewKey(entry):list==="renames"?[entry.tag,entry.kind,entry.from].join("\0"):list==="defaults"?[entry.tag,entry.attribute].join("\0"):list==="detailChanges"||list==="retiredEvents"?[entry.tag,entry.event].join("\0"):list==="detailFields"?[entry.tag,entry.event,entry.module,entry.detailType,entry.field].join("\0"):list==="propertyChanges"?[entry.tag,entry.property].join("\0"):list==="slotContent"?[entry.tag,entry.slot].join("\0"):[entry.tag,entry.kind,entry.name].join("\0")}function validateName(findings,label,kind,field,value){return typeof value!="string"||!NAME_PATTERNS[kind]?.test(value)?(findings.push(`${label}: ${field} must be a valid ${kind} name, got ${JSON.stringify(value)}`),!1):!0}function validateProjectedSince(findings,label,entry,projected){projected&&entry.since!==UNRELEASED_VERSION&&!parseVersion(entry.since)&&findings.push(`${label}: since must be a version or ${JSON.stringify(UNRELEASED_VERSION)}`)}function validateRemovedIn(findings,label,entry){Object.hasOwn(entry,"removedIn")&&(!parseVersion(entry.removedIn)||compareVersions(entry.removedIn,entry.removalNotBefore)<0)&&findings.push(`${label}: removedIn must be a version at or after removalNotBefore`)}function validateModuleReviewEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["kind","module","name",...projected?["replacement","since","removalNotBefore","removedIn"]:[]]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),MODULE_REVIEW_KINDS.includes(entry.kind)||findings.push(`${label}: unsupported module review kind ${entry.kind}`),entry.kind==="entry-point"||entry.kind==="stylesheet")Object.hasOwn(entry,"module")&&findings.push(`${label}: path reviews use name, not module`),typeof entry.name!="string"||!MODULE_PATH_PATTERN.test(entry.name)||entry.name.includes("..")?findings.push(`${label}: name must be a package subpath`):entry.name.endsWith(".css")!==(entry.kind==="stylesheet")&&findings.push(`${label}: stylesheet reviews must name CSS; entry-point reviews must name JavaScript`);else{entry.module!=="."&&(typeof entry.module!="string"||!MODULE_PATH_PATTERN.test(entry.module)||!entry.module.endsWith(".js")||entry.module.includes(".."))&&findings.push(`${label}: module must be a JavaScript package subpath`);const pattern=entry.kind==="window-event"?NAME_PATTERNS.event:entry.kind==="root-attribute"?/^data-lr-[a-z0-9-]+$/:JS_IDENTIFIER_PATTERN;(typeof entry.name!="string"||!pattern.test(entry.name))&&findings.push(`${label}: invalid module review name`)}projected&&((typeof entry.replacement!="string"||!entry.replacement.trim())&&findings.push(`${label}: replacement text missing`),parseVersion(entry.removalNotBefore)||findings.push(`${label}: removalNotBefore must be a version`),validateRemovedIn(findings,label,entry)),validateProjectedSince(findings,label,entry,projected)}function validateRenameEntry(findings,label,entry,projected){const allowed=["tag","kind","from","to","polarity",...projected?["since","reflects"]:[]],unknown=unknownKeys(entry,allowed);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),!RENAME_KINDS.includes(entry.kind)){findings.push(`${label}: kind must be one of ${RENAME_KINDS.join(", ")}`);return}const validFrom=validateName(findings,label,entry.kind,"from",entry.from),validTo=validateName(findings,label,entry.kind,"to",entry.to);validFrom&&validTo&&entry.from===entry.to&&findings.push(`${label}: from and to must differ`),entry.kind==="slot"&&(entry.from===""||entry.to==="")&&findings.push(`${label}: the default slot can be reviewed but not renamed`),Object.hasOwn(entry,"polarity")&&(entry.polarity!=="inverted"&&findings.push(`${label}: polarity may only be "inverted"`),entry.kind!=="attribute"&&entry.kind!=="property"&&findings.push(`${label}: only attribute and property renames can invert polarity`)),validateProjectedSince(findings,label,entry,projected),projected&&Object.hasOwn(entry,"reflects")!==(entry.kind==="attribute")&&findings.push(`${label}: reflects is recorded for attribute renames only`),projected&&entry.kind==="attribute"&&typeof entry.reflects!="boolean"&&findings.push(`${label}: reflects must be a boolean`)}function validateDefaultEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","attribute","value",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"attribute","attribute",entry.attribute),Object.hasOwn(entry,"value")?typeof entry.value!="string"&&entry.value!==!0&&!(typeof entry.value=="number"&&Number.isFinite(entry.value))&&findings.push(`${label}: value must be a string, a finite number, or true (presence)`):findings.push(`${label}: needs a value`),validateProjectedSince(findings,label,entry,projected)}function validateSummary(findings,label,summary){(typeof summary!="string"||summary.trim().length<16||/\n/.test(summary))&&findings.push(`${label}: summary must be a single-line description of the change`)}function validateDetailEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateDetailFieldEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","module","detailType","field","relation","replacement","role","notice","removalNotBefore","observedIn","removedIn"]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),(typeof entry.module!="string"||!/^(?:layout|conversation)\/[a-z0-9-]+\/[a-z0-9-]+(?:\.class|-shared)\.ts$/u.test(entry.module))&&findings.push(`${label}: module must be a canonical layout or conversation detail source path`),(typeof entry.detailType!="string"||!JS_IDENTIFIER_PATTERN.test(entry.detailType))&&findings.push(`${label}: detailType must be an exported type name`),(typeof entry.field!="string"||!JS_IDENTIFIER_PATTERN.test(entry.field))&&findings.push(`${label}: field must be a property name`),["equal","inverse"].includes(entry.relation)||findings.push(`${label}: relation must be equal or inverse`),entry.replacement!=="expanded"&&findings.push(`${label}: replacement must be expanded`),(!["request","settled"].includes(entry.role)||typeof entry.event!="string"||entry.role==="request"!==entry.event.endsWith("-request"))&&findings.push(`${label}: role must match whether the event is a request event`),(typeof entry.notice!="string"||!/^\/\*\*[\s\S]*@deprecated\b[\s\S]*\*\/$/u.test(entry.notice))&&findings.push(`${label}: notice must preserve the exact deprecation JSDoc`),entry.removalNotBefore!=="23.0.0"&&findings.push(`${label}: removalNotBefore must preserve the declared 23.0.0 floor`),entry.observedIn!=="22.0.0"&&findings.push(`${label}: observedIn must name the earliest verified packed observation, 22.0.0`),projected&&typeof entry.observedIn=="string"&&!parseVersion(entry.observedIn)&&findings.push(`${label}: observedIn must be a semantic version`),entry.removedIn!==void 0&&entry.removedIn!=="24.0.0"&&findings.push(`${label}: removedIn requires the separately authorized actual 24.0.0 retirement`),entry.removedIn!==void 0){const removal=parseVersion(entry.removedIn),floor=parseVersion(entry.removalNotBefore),observed=parseVersion(entry.observedIn);(!removal||!floor||!observed||removal[0]<floor[0]+1||removal[0]<observed[0]+2)&&findings.push(`${label}: removedIn must clear the declared floor and a full intervening published major`)}}function validateRetiredEventEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","replacement","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),validateName(findings,label,"event","replacement",entry.replacement),entry.event===entry.replacement&&findings.push(`${label}: replacement must differ from the retired event`),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validatePropertyChangeEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","property","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"property","property",entry.property),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateSlotContentEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","slot","report","allow","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"slot","slot",entry.slot);const lists=["report","allow"].filter(key=>Object.hasOwn(entry,key));if(lists.length!==1)findings.push(`${label}: needs exactly one of report (elements to report) or allow (the only elements kept)`);else{const elements=entry[lists[0]];(!Array.isArray(elements)||!elements.length||!elements.every(element=>typeof element=="string"&&ELEMENT_PATTERN.test(element))||JSON.stringify(elements)!==JSON.stringify([...new Set(elements)].sort(compareText)))&&findings.push(`${label}: ${lists[0]} must be a sorted, unique list of lowercase element names`)}validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateReviewEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,projected?["tag","kind","name","replacement","removalNotBefore","since","removedIn"]:["tag","kind","name"]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),!REVIEW_KINDS.includes(entry.kind)){findings.push(`${label}: kind must be one of ${REVIEW_KINDS.join(", ")}`);return}validateName(findings,label,entry.kind,"name",entry.name)&&entry.kind==="component"&&entry.name!==entry.tag&&findings.push(`${label}: a component review must name its own tag`),projected&&((typeof entry.replacement!="string"||!entry.replacement)&&findings.push(`${label}: replacement text missing`),majorOf(entry.removalNotBefore)===null&&findings.push(`${label}: removalNotBefore must be a version`),validateRemovedIn(findings,label,entry)),validateProjectedSince(findings,label,entry,projected)}function requiredExposure(profile){const required=new Map(EXPOSURE_KINDS.map(kind=>[kind,new Map])),need=(kind,name,tag)=>{if(!required.has(kind))return;const tags=required.get(kind).get(name)??new Set;tag&&tags.add(tag),required.get(kind).set(name,tags)};for(const entry of profile.renames??[])need(entry.kind,entry.from,entry.tag),need(entry.kind,entry.to,entry.tag);for(const entry of profile.reviews??[])need(entry.kind,entry.name,entry.tag);for(const entry of profile.detailChanges??[])need("event",entry.event,entry.tag);for(const entry of profile.retiredEvents??[])need("event",entry.event,null),need("event",entry.replacement,entry.tag);for(const entry of profile.propertyChanges??[])need("property",entry.property,entry.tag);return required}function validateExposure(findings,profile){const origin=profile.origin;if(!isPlainObject(profile.exposure)){findings.push(`${origin}: exposure must be an object`);return}const unknown=unknownKeys(profile.exposure,EXPOSURE_KINDS);unknown.length&&findings.push(`${origin}: exposure has unknown kind(s) ${unknown.join(", ")}`);const required=requiredExposure(profile);for(const kind of EXPOSURE_KINDS){const recorded=profile.exposure[kind];if(!isPlainObject(recorded)){findings.push(`${origin}: exposure.${kind} must be an object`);continue}for(const[name,tags]of Object.entries(recorded))required.get(kind).has(name)||findings.push(`${origin}: exposure.${kind} records unreferenced name ${name}`),(!Array.isArray(tags)||!tags.every(tag=>typeof tag=="string"&&TAG_PATTERN.test(tag))||JSON.stringify(tags)!==JSON.stringify([...new Set(tags)].sort(compareText)))&&findings.push(`${origin}: exposure.${kind}.${name} must be a sorted, unique tag list`);for(const[name,tags]of required.get(kind)){if(!Object.hasOwn(recorded,name)){findings.push(`${origin}: exposure.${kind}.${name} is missing`);continue}const recordedTags=new Set(recorded[name]??[]);for(const tag of tags)recordedTags.has(tag)||findings.push(`${origin}: exposure.${kind}.${name} must include ${tag}`)}}}function validateRenameLedgerShape(ledger,{projected=!1,historicalReleaseMajor=null}={}){const findings=[];if(!isPlainObject(ledger))return["rename ledger must be an object"];const unknownTop=unknownKeys(ledger,projected?["schemaVersion","profiles"]:["$comment","schemaVersion","profiles"]);if(unknownTop.length&&findings.push(`rename ledger has unknown key(s) ${unknownTop.join(", ")}`),ledger.schemaVersion!==1&&findings.push("rename ledger schemaVersion must be 1"),!Array.isArray(ledger.profiles))return[...findings,"rename ledger profiles must be an array"];const origins=ledger.profiles.map(profile=>profile?.origin),expectedOrigins=Number.isInteger(historicalReleaseMajor)&&historicalReleaseMajor>=22&&historicalReleaseMajor<26&&JSON.stringify(origins)===JSON.stringify(LYRA_RENAME_ORIGINS.slice(0,2))?LYRA_RENAME_ORIGINS.slice(0,2):LYRA_RENAME_ORIGINS;JSON.stringify(origins)!==JSON.stringify(expectedOrigins)&&findings.push(`rename ledger profiles must be exactly ${expectedOrigins.join(", ")} in that order`);for(const profile of ledger.profiles){if(!isPlainObject(profile)){findings.push("rename ledger profiles must be objects");continue}const origin=String(profile.origin),unknown=unknownKeys(profile,projected?PROJECTED_PROFILE_KEYS:AUTHORED_PROFILE_KEYS);unknown.length&&findings.push(`${origin}: unknown key(s) ${unknown.join(", ")}`);const header=LYRA_RENAME_PROFILES.find(candidate=>candidate.origin===profile.origin);if(header)for(const field of["fromMajor","toMajor","aliasRemovalMajor"])profile[field]!==header[field]&&findings.push(`${origin}: ${field} must be ${header[field]}`);for(const list of PROFILE_LIST_KEYS){if(["propertyChanges","retiredEvents","detailFields"].includes(list)&&profile[list]===void 0)continue;if(!Array.isArray(profile[list])){findings.push(`${origin}: ${list} must be an array`);continue}const seen=new Set,keys=[];for(const entry of profile[list]){const label=entryLabel(origin,list,entry);if(!isPlainObject(entry)){findings.push(`${origin}: ${list} entries must be objects`);continue}list!=="moduleReviews"&&(typeof entry.tag!="string"||!TAG_PATTERN.test(entry.tag))&&findings.push(`${label}: tag must be an lr-* element name`),list==="moduleReviews"?(validateModuleReviewEntry(findings,label,entry,projected),projected&&majorOf(entry.removalNotBefore)!==profile.aliasRemovalMajor&&findings.push(`${label}: removalNotBefore must match the profile's aliasRemovalMajor`)):list==="renames"?validateRenameEntry(findings,label,entry,projected):list==="defaults"?validateDefaultEntry(findings,label,entry,projected):list==="detailChanges"?validateDetailEntry(findings,label,entry,projected):list==="detailFields"?validateDetailFieldEntry(findings,label,entry,projected):list==="retiredEvents"?(validateRetiredEventEntry(findings,label,entry,projected),projected&&entry.since!==`${profile.toMajor}.0.0`&&findings.push(`${label}: since must match the target major release`)):list==="propertyChanges"?validatePropertyChangeEntry(findings,label,entry,projected):list==="slotContent"?validateSlotContentEntry(findings,label,entry,projected):validateReviewEntry(findings,label,entry,projected);const key=sortKey(list,entry);seen.has(key)&&findings.push(`${label}: duplicate entry`),seen.add(key),keys.push(key)}JSON.stringify(keys)!==JSON.stringify([...keys].sort(compareText))&&findings.push(`${origin}: ${list} must be sorted by ${list==="moduleReviews"?"kind, module and name":"tag and name"}`)}if(!Array.isArray(profile.renames)||!Array.isArray(profile.reviews))continue;const sources=new Map;for(const entry of profile.renames){const names=sources.get(entry.kind)??new Set;names.add(entry.from),sources.set(entry.kind,names)}for(const entry of profile.renames)sources.get(entry.kind)?.has(entry.to)&&findings.push(`${entryLabel(origin,"renames",entry)}: target ${entry.to} is itself renamed; rename directly to the final name`);const renamed=new Set(profile.renames.map(entry=>`${entry.tag}\0${entry.kind}\0${entry.from}`));for(const entry of profile.reviews)renamed.has(`${entry.tag}\0${entry.kind}\0${entry.name}`)&&findings.push(`${entryLabel(origin,"reviews",entry)}: a member is either renamed or reviewed, not both`);projected&&validateExposure(findings,profile)}if(ledger.profiles.length>=2){const historicalFields=ledger.profiles[0]?.detailFields,nextFields=ledger.profiles[1]?.detailFields;(Array.isArray(historicalFields)||Array.isArray(nextFields))&&JSON.stringify(historicalFields??[])!==JSON.stringify(nextFields??[])&&findings.push("lyra-v21 and lyra-v22 detailFields must preserve the same verified field exposures")}return findings}function componentMap(inventory){return new Map((inventory?.components??[]).map(component=>[component.tag,component]))}function surfaceEntry(component,kind,name){return(component?.surface?.[SURFACE_SECTIONS[kind]]??[]).find(entry=>entry.name===name)??null}function hasCurrentSuccessor(component,kind,name){const seen=new Set;for(;;){const key=`${kind}\0${name}`;if(seen.has(key))return!1;seen.add(key);const member=surfaceEntry(component,kind,name);if(!member)return!1;if(!member.deprecated)return!0;const replacement=deprecationRecordFor(component,kind,name)?.replacement;if(!replacement||replacement.kind==="component"||replacement.kind==="host-css-property")return!1;kind=replacement.kind,name=replacement.name}}function deprecationRecords(component){const records=[...component?.maturity?.deprecations??[]],componentRecord=component?.maturity?.deprecated;return isPlainObject(componentRecord)&&!records.some(record=>record.kind==="component")&&records.push(componentRecord),records}function deprecationRecordFor(component,kind,name){const records=deprecationRecords(component);if(kind==="component")return records.find(record=>record.kind==="component")??null;const direct=records.find(record=>record.kind===kind&&record.name===name);return direct||kind!=="attribute"?direct??null:records.find(record=>record.kind==="property"&&record.attribute===name)??null}function historicalMember(context,tag,kind,name){const key=JSON.stringify(["member",tag,kind,name]);return context?.records?.[key]??context?.records?.[context?.aliases?.[key]]??null}function historicalSourceComponent(context,tag,record=null){const historical=record??historicalMember(context,tag,"component",tag);return historical?.state!=="retired"?null:historical.sourceComponent??context?.sourceComponents?.[tag]??null}function historicalExport(context,entry){return context?.records?.[JSON.stringify(["export",entry.kind,entry.module??null,entry.name])]??null}function ownerFor(components,context,tag){const current=components.get(tag);return current||historicalSourceComponent(context,tag)}function policyFor(component,context,tag,kind,name){return deprecationRecordFor(component,kind,name)??historicalMember(context,tag,kind,name)?.policy??null}function replacementOwner(components,context,tag,kind,name){const historical=historicalMember(context,tag,kind,name);return components.get(historical?.state==="retired"?historical.replacementOwner:tag)}function replacementMatches(component,kind,record,to){const replacement=record?.replacement;return isPlainObject(replacement)?replacement.kind===kind&&replacement.name===to?!0:kind==="attribute"&&replacement.kind==="property"?surfaceEntry(component,"property",replacement.name)?.attribute===to:!1:!1}function isBooleanMember(entry){return String(entry?.type??"").split("|").map(part=>part.trim()).includes("boolean")}function exposingTags(inventory,kind,name){return(inventory?.components??[]).filter(component=>surfaceEntry(component,kind,name)).map(component=>component.tag).sort(compareText)}const UNMIRRORED_CLASSIFICATIONS=new Set(["conceptual-only","unsupported"]);function mirroredMembers(inventory){const upstreamComponents=new Map;for(const ecosystem of Object.values(inventory?.upstreams??{}))for(const component of ecosystem?.components??[])upstreamComponents.set(component.tag,component);const mirrored=new Map;for(const mapping of inventory?.mappings??[]){if(!mapping?.targetTag||UNMIRRORED_CLASSIFICATIONS.has(mapping.classification))continue;const upstream=upstreamComponents.get(mapping.upstreamTag);for(const[kind,section]of Object.entries(SURFACE_SECTIONS)){const rewrites=mapping.rewrites?.[section]??[],renamedAway=new Set(rewrites.map(rule=>rule?.from)),names=[...rewrites.map(rule=>rule?.to).filter(name=>typeof name=="string"),...(upstream?.surface?.[section]??[]).map(entry=>entry.name).filter(name=>!renamedAway.has(name))];for(const name of names){const key=`${mapping.targetTag}\0${kind}\0${name}`;mirrored.has(key)||mirrored.set(key,mapping.upstreamTag)}}}return mirrored}function validateRenameLedger(ledger,{inventory,exportDeprecations=[],requireCoverage=!1,sharedTokens=null,compatibilityContext=null,historicalReleaseMajor=null}){const findings=validateRenameLedgerShape(ledger,{historicalReleaseMajor});if(findings.length)return findings;const components=componentMap(inventory);if(!Array.isArray(exportDeprecations))return["exportDeprecations must be an array"];if(!exportDeprecations.every(isPlainObject))return["exportDeprecations entries must be objects"];const moduleRecords=new Map(exportDeprecations.map(record=>[moduleReviewKey(record),record]));moduleRecords.size!==exportDeprecations.length&&findings.push("exportDeprecations contains duplicate module records");const mirrored=mirroredMembers(inventory),mirrorOf=(tag,kind,name)=>mirrored.get(`${tag}\0${kind}\0${name}`)??null;for(const profile of ledger.profiles){const origin=profile.origin,covered=new Set,release=`${profile.toMajor}.0.0`,removalMajorMatches=record=>majorOf(record?.removalNotBefore)===profile.aliasRemovalMajor,checkRecordWindow=(label,record)=>{if(removalMajorMatches(record)||findings.push(`${label}: its deprecation record must set removalNotBefore to ${profile.aliasRemovalMajor}.0.0`),record?.since===UNRELEASED_VERSION)return;const since=compareVersions(record?.since,release);(since===null||since>0)&&findings.push(`${label}: its deprecation record must start no later than ${release} (since ${JSON.stringify(record?.since)})`)},checkLyraOnly=(label,tag,kind,name)=>{const upstream=mirrorOf(tag,kind,name);upstream&&findings.push(`${label}: ${name} mirrors ${upstream}; mirrored names never change`)},checkSharedToken=(label,kind,name)=>{kind==="css-property"&&sharedTokens?.has(name)&&findings.push(`${label}: ${name} is a canonical design token, not a component-owned custom property`)},presenceDefaults=new Set(ledger.profiles.filter(candidate=>candidate.toMajor<=profile.toMajor).flatMap(candidate=>candidate.defaults).filter(entry=>entry.value===!0).map(entry=>`${entry.tag}\0${entry.attribute}`)),inversionCompanions=new Set;for(const entry of profile.detailFields??[]){const label=entryLabel(origin,"detailFields",entry),component=ownerFor(components,compatibilityContext,entry.tag);component?surfaceEntry(component,"event",entry.event)||findings.push(`${label}: the event is not dispatched by ${entry.tag}`):findings.push(`${label}: component is not in the inventory`)}for(const entry of profile.renames){const label=entryLabel(origin,"renames",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}covered.add(`${entry.tag}\0${entry.kind}\0${entry.from}`),checkLyraOnly(label,entry.tag,entry.kind,entry.from),checkSharedToken(label,entry.kind,entry.from),checkSharedToken(label,entry.kind,entry.to);const historical=historicalMember(compatibilityContext,entry.tag,entry.kind,entry.from),retired=historical?.state==="retired",from=surfaceEntry(retired?historicalSourceComponent(compatibilityContext,entry.tag,historical):component,entry.kind,entry.from),targetOwner=replacementOwner(components,compatibilityContext,entry.tag,entry.kind,entry.from),to=surfaceEntry(targetOwner,entry.kind,entry.to);from?from.deprecated||findings.push(`${label}: the alias ${entry.from} is not marked deprecated in the manifest`):findings.push(`${label}: the deprecated alias ${entry.from} is not on the public surface`),to?to.deprecated&&!(retired&&hasCurrentSuccessor(targetOwner,entry.kind,entry.to))&&findings.push(`${label}: the canonical name ${entry.to} is itself deprecated`):findings.push(`${label}: the canonical name ${entry.to} is not on the public surface`);const record=policyFor(component,compatibilityContext,entry.tag,entry.kind,entry.from);if(record?(checkRecordWindow(label,record),replacementMatches(targetOwner,entry.kind,record,entry.to)||findings.push(`${label}: its deprecation record names a different replacement than ${entry.to}`)):findings.push(`${label}: no deprecation record retires ${entry.from}`),(entry.kind==="attribute"||entry.kind==="property")&&from&&to&&isBooleanMember(from)&&isBooleanMember(to)){const toAttribute=entry.kind==="attribute"?entry.to:to.attribute,preservesPresence=!!toAttribute&&presenceDefaults.has(`${entry.tag}\0${toAttribute}`);entry.polarity==="inverted"?(to.default===!0&&findings.push(`${label}: an inverted rename must target a boolean that defaults to false`),from.default!==!0&&toAttribute&&inversionCompanions.add(`${entry.tag}\0${toAttribute}`),from.default!==!0&&!preservesPresence&&findings.push(`${label}: ${entry.from} defaults to false, so the inverted rename needs a defaults entry inserting ${toAttribute??entry.to} where both are absent`)):from.default===!0&&to.default!==!0&&!preservesPresence&&findings.push(`${label}: ${entry.from} defaults to true and ${entry.to} to false; declare "polarity": "inverted" or preserve the default with a defaults entry`)}else entry.polarity==="inverted"&&from&&to&&findings.push(`${label}: an inverted rename must retire a boolean for a boolean`)}for(const entry of profile.reviews){const label=entryLabel(origin,"reviews",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}covered.add(`${entry.tag}\0${entry.kind}\0${entry.name}`),entry.kind!=="component"&&checkLyraOnly(label,entry.tag,entry.kind,entry.name),checkSharedToken(label,entry.kind,entry.name);const record=policyFor(component,compatibilityContext,entry.tag,entry.kind,entry.name);record?checkRecordWindow(label,record):findings.push(`${label}: no deprecation record retires ${JSON.stringify(entry.name)}`)}for(const entry of profile.detailChanges){const label=entryLabel(origin,"detailChanges",entry),component=ownerFor(components,compatibilityContext,entry.tag);component?surfaceEntry(component,"event",entry.event)?checkLyraOnly(label,entry.tag,"event",entry.event):findings.push(`${label}: the event is not dispatched by ${entry.tag}`):findings.push(`${label}: component is not in the inventory`)}for(const entry of profile.retiredEvents??[]){const label=entryLabel(origin,"retiredEvents",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component)findings.push(`${label}: component is not in the inventory`);else{surfaceEntry(component,"event",entry.event)&&findings.push(`${label}: retired event is still dispatched by ${entry.tag}`),deprecationRecordFor(component,"event",entry.event)&&findings.push(`${label}: a retired event must not keep a current deprecation record`);const target=surfaceEntry(component,"event",entry.replacement);(!target||target.deprecated)&&findings.push(`${label}: replacement is not a current event on ${entry.tag}`),checkLyraOnly(label,entry.tag,"event",entry.event)}}for(const entry of profile.propertyChanges??[]){const label=entryLabel(origin,"propertyChanges",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component)findings.push(`${label}: component is not in the inventory`);else{const historical=historicalMember(compatibilityContext,entry.tag,"property",entry.property),propertyOwner=historical?.state==="retired"?historical.sourceComponent??historicalSourceComponent(compatibilityContext,entry.tag,historical):component;surfaceEntry(propertyOwner,"property",entry.property)?checkLyraOnly(label,entry.tag,"property",entry.property):findings.push(`${label}: the property is not on the public surface`)}}for(const entry of profile.slotContent){const label=entryLabel(origin,"slotContent",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}surfaceEntry(component,"slot",entry.slot)||findings.push(`${label}: the slot is not on the public surface`);const record=policyFor(component,compatibilityContext,entry.tag,"slot-content",entry.slot);record&&(covered.add(`${entry.tag}\0slot-content\0${entry.slot}`),Array.isArray(record.permittedContent)&&JSON.stringify(entry.allow??null)!==JSON.stringify(record.permittedContent)&&findings.push(`${label}: its deprecation record permits ${record.permittedContent.join(", ")}; allow must list exactly those elements`))}for(const entry of profile.defaults){const label=entryLabel(origin,"defaults",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}const attribute=surfaceEntry(component,"attribute",entry.attribute);if(!attribute){findings.push(`${label}: the attribute is not on the public surface`);continue}inversionCompanions.has(`${entry.tag}\0${entry.attribute}`)||checkLyraOnly(label,entry.tag,"attribute",entry.attribute),entry.value===!0&&!isBooleanMember(attribute)&&findings.push(`${label}: presence insertion requires a boolean attribute`),attribute.hasDefault&&String(attribute.default)===String(entry.value)&&findings.push(`${label}: the value equals the current default, so there is nothing to preserve`)}const coveredModules=new Set;for(const entry of profile.moduleReviews){const label=entryLabel(origin,"moduleReviews",entry),key=moduleReviewKey(entry);coveredModules.add(key);const record=moduleRecords.get(key)??historicalExport(compatibilityContext,entry)?.policy;record?(checkRecordWindow(label,record),!record.replacement?.usage&&!record.replacement?.name&&findings.push(`${label}: canonical replacement is missing`)):findings.push(`${label}: no canonical exportDeprecations record`)}if(!requireCoverage)continue;for(const record of[...exportDeprecations,...Object.values(compatibilityContext?.records??{}).filter(entry=>entry.state==="retired"&&entry.key.scope==="export").map(entry=>entry.policy)])removalMajorMatches(record)&&!coveredModules.has(moduleReviewKey(record))&&findings.push(`${origin}: ${record.kind} ${record.module??""} ${record.name} is removed in ${profile.aliasRemovalMajor}.0.0 but has no moduleReviews entry`);const coverageOwners=new Map((inventory?.components??[]).map(component=>[component.tag,deprecationRecords(component)]));for(const entry of Object.values(compatibilityContext?.records??{}))entry.state!=="retired"||entry.key.scope!=="member"||coverageOwners.set(entry.key.tag,[...coverageOwners.get(entry.key.tag)??[],entry.policy]);for(const[tag,records]of coverageOwners){const component={tag};for(const record of records){if(!removalMajorMatches(record))continue;const keys=[[record.kind,record.kind==="component"?component.tag:record.name]];record.kind==="property"&&record.attribute&&keys.push(["attribute",record.attribute]);for(const[kind,name]of keys)kind!=="component"&&mirrorOf(component.tag,kind,name)||covered.has(`${component.tag}\0${kind}\0${name}`)||findings.push(`${origin}: ${component.tag} ${kind} ${JSON.stringify(name)} is removed in ${profile.aliasRemovalMajor}.0.0 but has no ${kind==="slot-content"?"slotContent":"rename or review"} entry`)}}}return[...new Set(findings)]}function projectRenameLedger(ledger,inventory,{exportDeprecations=[],compatibilityContext=null,historicalReleaseMajor=null}={}){const findings=validateRenameLedger(ledger,{inventory,exportDeprecations,compatibilityContext,historicalReleaseMajor});if(findings.length)throw new Error(`Invalid Lyra rename ledger: ${findings.join("; ")}`);const components=componentMap(inventory),moduleRecords=new Map(exportDeprecations.map(record=>[moduleReviewKey(record),record])),projection={schemaVersion:1,profiles:ledger.profiles.map(profile=>{const release=`${profile.toMajor}.0.0`,exposure=Object.fromEntries(EXPOSURE_KINDS.map(kind=>[kind,{}]));for(const[kind,names]of requiredExposure(profile))for(const name of[...names.keys()].sort(compareText))exposure[kind][name]=[...new Set([...exposingTags(inventory,kind,name),...compatibilityContext?.exposure?.[kind]?.[name]??[]])].sort(compareText);const recordFor=(entry,kind,name)=>policyFor(components.get(entry.tag),compatibilityContext,entry.tag,kind,name);return{origin:profile.origin,fromMajor:profile.fromMajor,toMajor:profile.toMajor,aliasRemovalMajor:profile.aliasRemovalMajor,renames:profile.renames.map(entry=>{const target=surfaceEntry(replacementOwner(components,compatibilityContext,entry.tag,entry.kind,entry.from),entry.kind,entry.to),attribute=entry.kind==="attribute"?entry.to:target?.attribute,preservesDefault=entry.polarity==="inverted"&&profile.defaults.some(rule=>rule.tag===entry.tag&&rule.attribute===attribute),since=recordFor(entry,entry.kind,entry.from).since,beforeRelease=since===UNRELEASED_VERSION||compareVersions(since,release)<0;return{...structuredClone(entry),since:preservesDefault&&beforeRelease?release:since,...entry.kind==="attribute"?{reflects:!!target?.reflects}:{}}}),defaults:profile.defaults.map(entry=>({...structuredClone(entry),since:release})),retiredEvents:(profile.retiredEvents??[]).map(entry=>({...structuredClone(entry),since:release})),detailChanges:profile.detailChanges.map(entry=>({...structuredClone(entry),since:release})),...Array.isArray(profile.detailFields)?{detailFields:profile.detailFields.map(entry=>structuredClone(entry))}:{},propertyChanges:(profile.propertyChanges??[]).map(entry=>({...structuredClone(entry),since:release})),reviews:profile.reviews.map(entry=>{const record=recordFor(entry,entry.kind,entry.name),retired=historicalMember(compatibilityContext,entry.tag,entry.kind,entry.name);return{...structuredClone(entry),replacement:String(record.replacement?.usage||record.replacement?.name),...retired?.state==="retired"?{removedIn:retired.removedIn}:{},removalNotBefore:record.removalNotBefore,since:record.since}}),slotContent:profile.slotContent.map(entry=>({...structuredClone(entry),since:release})),moduleReviews:profile.moduleReviews.map(entry=>{const retired=historicalExport(compatibilityContext,entry),record=moduleRecords.get(moduleReviewKey(entry))??retired?.policy;return{...structuredClone(entry),replacement:String(record.replacement.usage||record.replacement.name),...retired?.state==="retired"?{removedIn:retired.removedIn}:{},since:record.since,removalNotBefore:record.removalNotBefore}}),exposure}})},shapeFindings=validateRenameLedgerShape(projection,{projected:!0,historicalReleaseMajor});if(shapeFindings.length)throw new Error(`Invalid Lyra rename projection: ${shapeFindings.join("; ")}`);return projection}function indexBy(entries,keyOf){const index=new Map;for(const entry of entries){const key=keyOf(entry),list=index.get(key)??[];list.push(entry),index.set(key,list)}return index}const ownerKey=(tag,kind,name)=>`${tag}\0${kind}\0${name}`,nameKey=(kind,name)=>`${kind}\0${name}`;function createRenameProfiles(projection,{lyraVersion=null}={}){const findings=validateRenameLedgerShape(projection,{projected:!0});if(findings.length)throw new Error(`Invalid Lyra rename projection: ${findings.join("; ")}`);if(lyraVersion!==null&&!parseVersion(lyraVersion))throw new Error(`Invalid Lyra version: ${lyraVersion}`);const profiles=new Map,availableAcrossProfiles=entry=>lyraVersion===null||entry.since!==UNRELEASED_VERSION&&compareVersions(entry.since,lyraVersion)<=0,allRenames=projection.profiles.flatMap(profile=>profile.renames).filter(availableAcrossProfiles),allDefaults=projection.profiles.flatMap(profile=>profile.defaults).filter(availableAcrossProfiles);for(const full of projection.profiles){const skipped=[],available=list=>(full[list]??[]).filter(entry=>{if(lyraVersion===null)return!0;const availableFrom=list==="detailFields"?entry.observedIn:entry.since;return availableFrom!==UNRELEASED_VERSION&&compareVersions(availableFrom,lyraVersion)<=0?!0:(skipped.push({list,...entry}),!1)}).map(entry=>{if(!entry.removedIn||lyraVersion===null||compareVersions(lyraVersion,entry.removedIn)>=0)return entry;const{removedIn,...beforeRemoval}=entry;return beforeRemoval}),data={...full,...Object.fromEntries(PROFILE_LIST_KEYS.map(list=>[list,available(list)]))},renamesByOwner=new Map(data.renames.map(entry=>[ownerKey(entry.tag,entry.kind,entry.from),entry])),renamesByName=indexBy(data.renames,entry=>nameKey(entry.kind,entry.from)),renamesByTarget=indexBy(data.renames,entry=>nameKey(entry.kind,entry.to)),reviewsByOwner=new Map(data.reviews.map(entry=>[ownerKey(entry.tag,entry.kind,entry.name),entry])),reviewsByName=indexBy(data.reviews,entry=>nameKey(entry.kind,entry.name)),detailsByOwner=new Map(data.detailChanges.map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),detailsByName=indexBy(data.detailChanges,entry=>entry.event),fieldsByOwnerEvent=new Map((data.detailFields??[]).map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),fieldsByEvent=indexBy(data.detailFields??[],entry=>entry.event),retiredByOwner=new Map(data.retiredEvents.map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),retiredByName=indexBy(data.retiredEvents,entry=>entry.event),propertiesByOwner=new Map(data.propertyChanges.map(entry=>[ownerKey(entry.tag,"property",entry.property),entry])),exposure=new Map(EXPOSURE_KINDS.map(kind=>[kind,new Map(Object.entries(data.exposure[kind]).map(([name,tags2])=>[name,new Set(tags2)]))])),defaultsByTag=indexBy(data.defaults,entry=>entry.tag),slotContentByTag=indexBy(data.slotContent,entry=>entry.tag),tags=new Set([...data.renames,...data.reviews,...data.detailChanges,...data.detailFields??[],...data.retiredEvents,...data.propertyChanges,...data.defaults,...data.slotContent].map(entry=>entry.tag)),renamesNamed=(kind,name)=>renamesByName.get(nameKey(kind,name))??[],exposersOf=(kind,name)=>exposure.get(kind)?.get(name)??new Set,movers=(kind,from,to)=>new Set(renamesNamed(kind,from).filter(entry=>entry.to===to&&!entry.polarity).map(entry=>entry.tag)),subset=(left,right)=>[...left].every(tag=>right.has(tag));profiles.set(data.origin,{origin:data.origin,fromMajor:data.fromMajor,toMajor:data.toMajor,aliasRemovalMajor:data.aliasRemovalMajor,data,skipped,tags,isEmpty:tags.size===0&&data.moduleReviews.length===0,renameFor:(tag,kind,name)=>renamesByOwner.get(ownerKey(tag,kind,name))??null,renamesNamed,renamesOnto:(kind,name)=>renamesByTarget.get(nameKey(kind,name))??[],reviewFor:(tag,kind,name)=>reviewsByOwner.get(ownerKey(tag,kind,name))??null,reviewsNamed:(kind,name)=>reviewsByName.get(nameKey(kind,name))??[],detailFor:(tag,event)=>detailsByOwner.get(ownerKey(tag,"event",event))??null,detailsNamed:event=>detailsByName.get(event)??[],detailFieldFor:(tag,event)=>fieldsByOwnerEvent.get(ownerKey(tag,"event",event))??null,detailFieldsNamed:event=>fieldsByEvent.get(event)??[],retiredEventFor:(tag,event)=>retiredByOwner.get(ownerKey(tag,"event",event))??null,retiredEventsNamed:event=>retiredByName.get(event)??[],propertyChangeFor:(tag,property)=>propertiesByOwner.get(ownerKey(tag,"property",property))??null,defaultsFor:tag=>defaultsByTag.get(tag)??[],preservedDefaultsFor:tag=>allDefaults.filter(entry=>entry.tag===tag),defaultAliasesFor:(tag,attribute)=>{const aliases=new Set([attribute]);for(const rename of allRenames)rename.tag!==tag||rename.kind!=="attribute"||(rename.from===attribute&&aliases.add(rename.to),rename.to===attribute&&aliases.add(rename.from));return[...aliases]},slotContentFor:tag=>slotContentByTag.get(tag)??[],exposes:(kind,name,tag)=>!!tag&&exposersOf(kind,name).has(tag),exposers:(kind,name)=>[...exposersOf(kind,name)],targetKeepers(kind,from,to){const moving=movers(kind,from,to);return[...exposersOf(kind,to)].filter(tag=>!moving.has(tag))},sourceKeepers(kind,from,to){const moving=movers(kind,from,to);return[...exposersOf(kind,from)].filter(tag=>!moving.has(tag))},isGlobal(kind,from){const entries=renamesNamed(kind,from);if(!entries.length||entries.some(entry=>entry.polarity))return!1;const targets=new Set(entries.map(entry=>entry.to));if(targets.size!==1)return!1;const[to]=targets,moving=movers(kind,from,to);return exposersOf(kind,from).size>0&&subset(exposersOf(kind,from),moving)&&subset(exposersOf(kind,to),moving)},gainedOwners(kind,name){const onto=(renamesByTarget.get(nameKey(kind,name))??[]).filter(entry=>!entry.polarity);if(!onto.length)return[];const gained=new Set(onto.map(entry=>entry.tag));return[...exposersOf(kind,name)].filter(tag=>!gained.has(tag)).length?[...gained].sort(compareText):[]}})}return profiles}export{LYRA_RENAME_ORIGINS,compareVersions,createRenameProfiles,emptyRenameLedger,emptyRenameProjection,mirroredMembers,projectRenameLedger,validateRenameLedger,validateRenameLedgerShape};
+const LYRA_RENAME_LEDGER_SCHEMA_VERSION=1,UNRELEASED_VERSION="unreleased",LYRA_RENAME_PROFILES=Object.freeze([Object.freeze({origin:"lyra-v21",fromMajor:21,toMajor:22,aliasRemovalMajor:23}),Object.freeze({origin:"lyra-v22",fromMajor:22,toMajor:23,aliasRemovalMajor:24}),Object.freeze({origin:"lyra-v25",fromMajor:25,toMajor:26,aliasRemovalMajor:28}),Object.freeze({origin:"lyra-v26",fromMajor:26,toMajor:27,aliasRemovalMajor:29})]),LYRA_RENAME_ORIGINS=Object.freeze(LYRA_RENAME_PROFILES.map(profile=>profile.origin)),RENAME_KINDS=Object.freeze(["attribute","property","event","part","css-property","slot"]),REVIEW_KINDS=Object.freeze(["component","attribute","property","event","slot","part","css-property","css-state","method"]),EXPOSURE_KINDS=Object.freeze(["event","part","css-property"]),SURFACE_SECTIONS=Object.freeze({attribute:"attributes",property:"properties",event:"events",part:"parts","css-property":"cssProperties",slot:"slots","css-state":"cssStates",method:"methods"}),TAG_PATTERN=/^lr-[a-z0-9]+(?:-[a-z0-9]+)*$/,ELEMENT_PATTERN=/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/,JS_IDENTIFIER_PATTERN=/^[A-Za-z_$][\w$]*$/,VERSION_PATTERN=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/,NAME_PATTERNS=Object.freeze({component:TAG_PATTERN,attribute:/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/,property:JS_IDENTIFIER_PATTERN,method:JS_IDENTIFIER_PATTERN,event:/^lr-[a-z0-9]+(?:-[a-z0-9]+)*$/,part:/^[A-Za-z0-9_-]+$/,slot:/^(?:[A-Za-z0-9_-]+)?$/,"css-property":/^--[A-Za-z0-9_-]+$/,"css-state":/^[a-z][a-z0-9-]*$/}),MODULE_REVIEW_KINDS=["entry-point","stylesheet","function","type","constant","class","window-event","root-attribute"],MODULE_PATH_PATTERN=/^\.\/[A-Za-z0-9_./-]+\.(?:js|css)$/,moduleReviewKey=entry=>[entry.kind,entry.module??"",entry.name].join("\0"),PROFILE_LIST_KEYS=["renames","defaults","detailChanges","detailFields","propertyChanges","retiredEvents","reviews","slotContent","moduleReviews","globals"],OPTIONAL_PROFILE_LISTS=["propertyChanges","retiredEvents","detailFields","globals"],AUTHORED_PROFILE_KEYS=["origin","fromMajor","toMajor","aliasRemovalMajor",...PROFILE_LIST_KEYS],GLOBAL_KINDS=Object.freeze(["module","export","locale-key","css-property","part"]),PACKAGE_SPECIFIER_PATTERN=/^@aceshooting\/lyra-[a-z]+(?:\/[A-Za-z0-9_./-]*)?$/,PROJECTED_PROFILE_KEYS=[...AUTHORED_PROFILE_KEYS,"exposure"];function isPlainObject(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function unknownKeys(value,allowed){return Object.keys(value).filter(key=>!allowed.includes(key))}function compareText(left,right){return left<right?-1:left>right?1:0}function parseVersion(version){const match=VERSION_PATTERN.exec(String(version??""));return match?match.slice(1,4).map(Number):null}function compareVersions(left,right){const a=parseVersion(left),b=parseVersion(right);if(!a||!b)return null;for(let index=0;index<3;index+=1)if(a[index]!==b[index])return a[index]-b[index];return 0}function majorOf(version){return parseVersion(version)?.[0]??null}function emptyRenameLedger(){return{schemaVersion:1,profiles:LYRA_RENAME_PROFILES.map(header=>({...header,...Object.fromEntries(PROFILE_LIST_KEYS.filter(list=>!["detailFields","globals"].includes(list)).map(list=>[list,[]]))}))}}function emptyRenameProjection(){return{schemaVersion:1,profiles:emptyRenameLedger().profiles.map(profile=>({...profile,exposure:Object.fromEntries(EXPOSURE_KINDS.map(kind=>[kind,{}]))}))}}function entryLabel(origin,list,entry){return list==="globals"?`${origin}: global ${entry?.kind} ${entry?.from}`:list==="moduleReviews"?`${origin}: module review ${entry?.kind} ${entry?.module??""} ${entry?.name}`:list==="renames"?`${origin}: rename ${entry?.tag} ${entry?.kind} ${entry?.from}`:list==="defaults"?`${origin}: default ${entry?.tag} ${entry?.attribute}`:list==="retiredEvents"?`${origin}: retired event ${entry?.tag} ${entry?.event}`:list==="detailChanges"?`${origin}: detail change ${entry?.tag} ${entry?.event}`:list==="detailFields"?`${origin}: detail field ${entry?.tag} ${entry?.event} ${entry?.detailType}.${entry?.field}`:list==="propertyChanges"?`${origin}: property change ${entry?.tag} ${entry?.property}`:list==="slotContent"?`${origin}: slot content ${entry?.tag} ${JSON.stringify(entry?.slot??null)}`:`${origin}: review ${entry?.tag} ${entry?.kind} ${JSON.stringify(entry?.name??null)}`}function sortKey(list,entry){return list==="moduleReviews"?moduleReviewKey(entry):list==="globals"?[entry.kind,entry.from,entry.tag??""].join("\0"):list==="renames"?[entry.tag,entry.kind,entry.from].join("\0"):list==="defaults"?[entry.tag,entry.attribute].join("\0"):list==="detailChanges"||list==="retiredEvents"?[entry.tag,entry.event].join("\0"):list==="detailFields"?[entry.tag,entry.event,entry.module,entry.detailType,entry.field].join("\0"):list==="propertyChanges"?[entry.tag,entry.property].join("\0"):list==="slotContent"?[entry.tag,entry.slot].join("\0"):[entry.tag,entry.kind,entry.name].join("\0")}function validateName(findings,label,kind,field,value){return typeof value!="string"||!NAME_PATTERNS[kind]?.test(value)?(findings.push(`${label}: ${field} must be a valid ${kind} name, got ${JSON.stringify(value)}`),!1):!0}function validateProjectedSince(findings,label,entry,projected){projected&&entry.since!==UNRELEASED_VERSION&&!parseVersion(entry.since)&&findings.push(`${label}: since must be a version or ${JSON.stringify(UNRELEASED_VERSION)}`)}function validateRemovedIn(findings,label,entry){Object.hasOwn(entry,"removedIn")&&(!parseVersion(entry.removedIn)||compareVersions(entry.removedIn,entry.removalNotBefore)<0)&&findings.push(`${label}: removedIn must be a version at or after removalNotBefore`)}function validateModuleReviewEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["kind","module","name",...projected?["replacement","since","removalNotBefore","removedIn"]:[]]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),MODULE_REVIEW_KINDS.includes(entry.kind)||findings.push(`${label}: unsupported module review kind ${entry.kind}`),entry.kind==="entry-point"||entry.kind==="stylesheet")Object.hasOwn(entry,"module")&&findings.push(`${label}: path reviews use name, not module`),typeof entry.name!="string"||!MODULE_PATH_PATTERN.test(entry.name)||entry.name.includes("..")?findings.push(`${label}: name must be a package subpath`):entry.name.endsWith(".css")!==(entry.kind==="stylesheet")&&findings.push(`${label}: stylesheet reviews must name CSS; entry-point reviews must name JavaScript`);else{entry.module!=="."&&(typeof entry.module!="string"||!MODULE_PATH_PATTERN.test(entry.module)||!entry.module.endsWith(".js")||entry.module.includes(".."))&&findings.push(`${label}: module must be a JavaScript package subpath`);const pattern=entry.kind==="window-event"?NAME_PATTERNS.event:entry.kind==="root-attribute"?/^data-lr-[a-z0-9-]+$/:JS_IDENTIFIER_PATTERN;(typeof entry.name!="string"||!pattern.test(entry.name))&&findings.push(`${label}: invalid module review name`)}projected&&((typeof entry.replacement!="string"||!entry.replacement.trim())&&findings.push(`${label}: replacement text missing`),parseVersion(entry.removalNotBefore)||findings.push(`${label}: removalNotBefore must be a version`),validateRemovedIn(findings,label,entry)),validateProjectedSince(findings,label,entry,projected)}function validateGlobalEntry(findings,label,entry){const unknown=unknownKeys(entry,["kind","from","to","module","prefix","except","tag","summary","since"]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),!GLOBAL_KINDS.includes(entry.kind)){findings.push(`${label}: kind must be one of ${GLOBAL_KINDS.join(", ")}`);return}(typeof entry.summary!="string"||!entry.summary.trim())&&findings.push(`${label}: summary text missing`),parseVersion(entry.since)||findings.push(`${label}: since must be a version`);const optional=entry.kind==="locale-key";if(entry.kind==="module"){const valid=value=>typeof value=="string"&&PACKAGE_SPECIFIER_PATTERN.test(value)&&!value.includes("..");if(valid(entry.from)||findings.push(`${label}: from must be an @aceshooting package specifier`),valid(entry.to)||findings.push(`${label}: to must be an @aceshooting package specifier`),valid(entry.from)&&entry.from===entry.to&&findings.push(`${label}: from and to must differ`),Object.hasOwn(entry,"module")&&findings.push(`${label}: module entries do not take a module`),Object.hasOwn(entry,"prefix")&&entry.prefix!==!0&&findings.push(`${label}: prefix may only be true`),entry.prefix===!0&&!(entry.from?.endsWith("/")&&entry.to?.endsWith("/"))&&findings.push(`${label}: a prefix entry's from and to must end with a slash`),Object.hasOwn(entry,"except")){const exceptions=entry.except;entry.prefix!==!0||!Array.isArray(exceptions)||!exceptions.length||!exceptions.every(value=>typeof value=="string"&&value.startsWith(entry.from)&&value.endsWith("/"))?findings.push(`${label}: except needs prefix and a list of slash-terminated prefixes below from`):JSON.stringify(exceptions)!==JSON.stringify([...exceptions].sort(compareText))&&findings.push(`${label}: except must be sorted`)}return}if(entry.kind==="css-property"||entry.kind==="part"){(typeof entry.to!="string"||!entry.to.trim())&&findings.push(`${label}: to must name the replacement`),(Object.hasOwn(entry,"module")||Object.hasOwn(entry,"except"))&&findings.push(`${label}: ${entry.kind} entries take no module or except`),entry.kind==="part"?((typeof entry.tag!="string"||!TAG_PATTERN.test(entry.tag))&&findings.push(`${label}: tag must be an lr-* element name`),Object.hasOwn(entry,"prefix")&&findings.push(`${label}: prefix applies to custom properties only`),validateName(findings,label,"part","from",entry.from)):(Object.hasOwn(entry,"tag")&&findings.push(`${label}: custom properties are not tag-owned`),validateName(findings,label,"css-property","from",entry.from),Object.hasOwn(entry,"prefix")&&(entry.prefix!==!0||!entry.from.endsWith("-"))&&findings.push(`${label}: a prefix needs prefix: true and a name ending in a hyphen`));return}for(const field of["prefix","except","tag"])Object.hasOwn(entry,field)&&findings.push(`${label}: ${field} applies to module, part and custom property entries only`);(typeof entry.from!="string"||!JS_IDENTIFIER_PATTERN.test(entry.from))&&findings.push(`${label}: from must be an identifier`),(typeof entry.to!="string"||!JS_IDENTIFIER_PATTERN.test(entry.to))&&findings.push(`${label}: to must be an identifier`),entry.from===entry.to&&findings.push(`${label}: from and to must differ`),entry.kind==="export"&&entry.module!=="."&&findings.push(`${label}: an export entry needs module "." (the package root)`),optional&&Object.hasOwn(entry,"module")&&findings.push(`${label}: locale keys do not take a module`)}function validateRenameEntry(findings,label,entry,projected){const allowed=["tag","kind","from","to","polarity",...projected?["since","reflects"]:[]],unknown=unknownKeys(entry,allowed);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),!RENAME_KINDS.includes(entry.kind)){findings.push(`${label}: kind must be one of ${RENAME_KINDS.join(", ")}`);return}const validFrom=validateName(findings,label,entry.kind,"from",entry.from),validTo=validateName(findings,label,entry.kind,"to",entry.to);validFrom&&validTo&&entry.from===entry.to&&findings.push(`${label}: from and to must differ`),entry.kind==="slot"&&(entry.from===""||entry.to==="")&&findings.push(`${label}: the default slot can be reviewed but not renamed`),Object.hasOwn(entry,"polarity")&&(entry.polarity!=="inverted"&&findings.push(`${label}: polarity may only be "inverted"`),entry.kind!=="attribute"&&entry.kind!=="property"&&findings.push(`${label}: only attribute and property renames can invert polarity`)),validateProjectedSince(findings,label,entry,projected),projected&&Object.hasOwn(entry,"reflects")!==(entry.kind==="attribute")&&findings.push(`${label}: reflects is recorded for attribute renames only`),projected&&entry.kind==="attribute"&&typeof entry.reflects!="boolean"&&findings.push(`${label}: reflects must be a boolean`)}function validateDefaultEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","attribute","value",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"attribute","attribute",entry.attribute),Object.hasOwn(entry,"value")?typeof entry.value!="string"&&entry.value!==!0&&!(typeof entry.value=="number"&&Number.isFinite(entry.value))&&findings.push(`${label}: value must be a string, a finite number, or true (presence)`):findings.push(`${label}: needs a value`),validateProjectedSince(findings,label,entry,projected)}function validateSummary(findings,label,summary){(typeof summary!="string"||summary.trim().length<16||/\n/.test(summary))&&findings.push(`${label}: summary must be a single-line description of the change`)}function validateDetailEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateDetailFieldEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","module","detailType","field","relation","replacement","role","notice","removalNotBefore","observedIn","removedIn"]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),(typeof entry.module!="string"||!/^(?:layout|conversation)\/[a-z0-9-]+\/[a-z0-9-]+(?:\.class|-shared)\.ts$/u.test(entry.module))&&findings.push(`${label}: module must be a canonical layout or conversation detail source path`),(typeof entry.detailType!="string"||!JS_IDENTIFIER_PATTERN.test(entry.detailType))&&findings.push(`${label}: detailType must be an exported type name`),(typeof entry.field!="string"||!JS_IDENTIFIER_PATTERN.test(entry.field))&&findings.push(`${label}: field must be a property name`),["equal","inverse"].includes(entry.relation)||findings.push(`${label}: relation must be equal or inverse`),entry.replacement!=="expanded"&&findings.push(`${label}: replacement must be expanded`),(!["request","settled"].includes(entry.role)||typeof entry.event!="string"||entry.role==="request"!==entry.event.endsWith("-request"))&&findings.push(`${label}: role must match whether the event is a request event`),(typeof entry.notice!="string"||!/^\/\*\*[\s\S]*@deprecated\b[\s\S]*\*\/$/u.test(entry.notice))&&findings.push(`${label}: notice must preserve the exact deprecation JSDoc`),entry.removalNotBefore!=="23.0.0"&&findings.push(`${label}: removalNotBefore must preserve the declared 23.0.0 floor`),entry.observedIn!=="22.0.0"&&findings.push(`${label}: observedIn must name the earliest verified packed observation, 22.0.0`),projected&&typeof entry.observedIn=="string"&&!parseVersion(entry.observedIn)&&findings.push(`${label}: observedIn must be a semantic version`),entry.removedIn!==void 0&&entry.removedIn!=="24.0.0"&&findings.push(`${label}: removedIn requires the separately authorized actual 24.0.0 retirement`),entry.removedIn!==void 0){const removal=parseVersion(entry.removedIn),floor=parseVersion(entry.removalNotBefore),observed=parseVersion(entry.observedIn);(!removal||!floor||!observed||removal[0]<floor[0]+1||removal[0]<observed[0]+2)&&findings.push(`${label}: removedIn must clear the declared floor and a full intervening published major`)}}function validateRetiredEventEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","event","replacement","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"event","event",entry.event),validateName(findings,label,"event","replacement",entry.replacement),entry.event===entry.replacement&&findings.push(`${label}: replacement must differ from the retired event`),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validatePropertyChangeEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","property","former","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"property","property",entry.property),Object.hasOwn(entry,"former")&&validateName(findings,label,"property","former",entry.former)&&entry.former===entry.property&&findings.push(`${label}: former must differ from property`),validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateSlotContentEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,["tag","slot","report","allow","summary",...projected?["since"]:[]]);unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),validateName(findings,label,"slot","slot",entry.slot);const lists=["report","allow"].filter(key=>Object.hasOwn(entry,key));if(lists.length!==1)findings.push(`${label}: needs exactly one of report (elements to report) or allow (the only elements kept)`);else{const elements=entry[lists[0]];(!Array.isArray(elements)||!elements.length||!elements.every(element=>typeof element=="string"&&ELEMENT_PATTERN.test(element))||JSON.stringify(elements)!==JSON.stringify([...new Set(elements)].sort(compareText)))&&findings.push(`${label}: ${lists[0]} must be a sorted, unique list of lowercase element names`)}validateSummary(findings,label,entry.summary),validateProjectedSince(findings,label,entry,projected)}function validateReviewEntry(findings,label,entry,projected){const unknown=unknownKeys(entry,projected?["tag","kind","name","replacement","removalNotBefore","since","removedIn"]:["tag","kind","name"]);if(unknown.length&&findings.push(`${label}: unknown key(s) ${unknown.join(", ")}`),!REVIEW_KINDS.includes(entry.kind)){findings.push(`${label}: kind must be one of ${REVIEW_KINDS.join(", ")}`);return}validateName(findings,label,entry.kind,"name",entry.name)&&entry.kind==="component"&&entry.name!==entry.tag&&findings.push(`${label}: a component review must name its own tag`),projected&&((typeof entry.replacement!="string"||!entry.replacement)&&findings.push(`${label}: replacement text missing`),majorOf(entry.removalNotBefore)===null&&findings.push(`${label}: removalNotBefore must be a version`),validateRemovedIn(findings,label,entry)),validateProjectedSince(findings,label,entry,projected)}function requiredExposure(profile){const required=new Map(EXPOSURE_KINDS.map(kind=>[kind,new Map])),need=(kind,name,tag)=>{if(!required.has(kind))return;const tags=required.get(kind).get(name)??new Set;tag&&tags.add(tag),required.get(kind).set(name,tags)};for(const entry of profile.renames??[])need(entry.kind,entry.from,entry.tag),need(entry.kind,entry.to,entry.tag);for(const entry of profile.reviews??[])need(entry.kind,entry.name,entry.tag);for(const entry of profile.detailChanges??[])need("event",entry.event,entry.tag);for(const entry of profile.retiredEvents??[])need("event",entry.event,null),need("event",entry.replacement,entry.tag);for(const entry of profile.propertyChanges??[])need("property",entry.property,entry.tag);return required}function validateExposure(findings,profile){const origin=profile.origin;if(!isPlainObject(profile.exposure)){findings.push(`${origin}: exposure must be an object`);return}const unknown=unknownKeys(profile.exposure,EXPOSURE_KINDS);unknown.length&&findings.push(`${origin}: exposure has unknown kind(s) ${unknown.join(", ")}`);const required=requiredExposure(profile);for(const kind of EXPOSURE_KINDS){const recorded=profile.exposure[kind];if(!isPlainObject(recorded)){findings.push(`${origin}: exposure.${kind} must be an object`);continue}for(const[name,tags]of Object.entries(recorded))required.get(kind).has(name)||findings.push(`${origin}: exposure.${kind} records unreferenced name ${name}`),(!Array.isArray(tags)||!tags.every(tag=>typeof tag=="string"&&TAG_PATTERN.test(tag))||JSON.stringify(tags)!==JSON.stringify([...new Set(tags)].sort(compareText)))&&findings.push(`${origin}: exposure.${kind}.${name} must be a sorted, unique tag list`);for(const[name,tags]of required.get(kind)){if(!Object.hasOwn(recorded,name)){findings.push(`${origin}: exposure.${kind}.${name} is missing`);continue}const recordedTags=new Set(recorded[name]??[]);for(const tag of tags)recordedTags.has(tag)||findings.push(`${origin}: exposure.${kind}.${name} must include ${tag}`)}}}function validateRenameLedgerShape(ledger,{projected=!1,historicalReleaseMajor=null}={}){const findings=[];if(!isPlainObject(ledger))return["rename ledger must be an object"];const unknownTop=unknownKeys(ledger,projected?["schemaVersion","profiles"]:["$comment","schemaVersion","profiles"]);if(unknownTop.length&&findings.push(`rename ledger has unknown key(s) ${unknownTop.join(", ")}`),ledger.schemaVersion!==1&&findings.push("rename ledger schemaVersion must be 1"),!Array.isArray(ledger.profiles))return[...findings,"rename ledger profiles must be an array"];const origins=ledger.profiles.map(profile=>profile?.origin),historicalCount=!Number.isInteger(historicalReleaseMajor)||historicalReleaseMajor<22?0:historicalReleaseMajor<26?2:historicalReleaseMajor<27?3:0,expectedOrigins=historicalCount&&JSON.stringify(origins)===JSON.stringify(LYRA_RENAME_ORIGINS.slice(0,historicalCount))?LYRA_RENAME_ORIGINS.slice(0,historicalCount):LYRA_RENAME_ORIGINS;JSON.stringify(origins)!==JSON.stringify(expectedOrigins)&&findings.push(`rename ledger profiles must be exactly ${expectedOrigins.join(", ")} in that order`);for(const profile of ledger.profiles){if(!isPlainObject(profile)){findings.push("rename ledger profiles must be objects");continue}const origin=String(profile.origin),unknown=unknownKeys(profile,projected?PROJECTED_PROFILE_KEYS:AUTHORED_PROFILE_KEYS);unknown.length&&findings.push(`${origin}: unknown key(s) ${unknown.join(", ")}`);const header=LYRA_RENAME_PROFILES.find(candidate=>candidate.origin===profile.origin);if(header)for(const field of["fromMajor","toMajor","aliasRemovalMajor"])profile[field]!==header[field]&&findings.push(`${origin}: ${field} must be ${header[field]}`);for(const list of PROFILE_LIST_KEYS){if(OPTIONAL_PROFILE_LISTS.includes(list)&&profile[list]===void 0)continue;if(!Array.isArray(profile[list])){findings.push(`${origin}: ${list} must be an array`);continue}const seen=new Set,keys=[];for(const entry of profile[list]){const label=entryLabel(origin,list,entry);if(!isPlainObject(entry)){findings.push(`${origin}: ${list} entries must be objects`);continue}list!=="moduleReviews"&&list!=="globals"&&(typeof entry.tag!="string"||!TAG_PATTERN.test(entry.tag))&&findings.push(`${label}: tag must be an lr-* element name`),list==="globals"?validateGlobalEntry(findings,label,entry):list==="moduleReviews"?(validateModuleReviewEntry(findings,label,entry,projected),projected&&majorOf(entry.removalNotBefore)!==profile.aliasRemovalMajor&&findings.push(`${label}: removalNotBefore must match the profile's aliasRemovalMajor`)):list==="renames"?validateRenameEntry(findings,label,entry,projected):list==="defaults"?validateDefaultEntry(findings,label,entry,projected):list==="detailChanges"?validateDetailEntry(findings,label,entry,projected):list==="detailFields"?validateDetailFieldEntry(findings,label,entry,projected):list==="retiredEvents"?(validateRetiredEventEntry(findings,label,entry,projected),projected&&entry.since!==`${profile.toMajor}.0.0`&&findings.push(`${label}: since must match the target major release`)):list==="propertyChanges"?validatePropertyChangeEntry(findings,label,entry,projected):list==="slotContent"?validateSlotContentEntry(findings,label,entry,projected):validateReviewEntry(findings,label,entry,projected);const key=sortKey(list,entry);seen.has(key)&&findings.push(`${label}: duplicate entry`),seen.add(key),keys.push(key)}JSON.stringify(keys)!==JSON.stringify([...keys].sort(compareText))&&findings.push(`${origin}: ${list} must be sorted by ${list==="moduleReviews"?"kind, module and name":list==="globals"?"kind and name":"tag and name"}`)}if(!Array.isArray(profile.renames)||!Array.isArray(profile.reviews))continue;const sources=new Map;for(const entry of profile.renames){const names=sources.get(entry.kind)??new Set;names.add(entry.from),sources.set(entry.kind,names)}for(const entry of profile.renames)sources.get(entry.kind)?.has(entry.to)&&findings.push(`${entryLabel(origin,"renames",entry)}: target ${entry.to} is itself renamed; rename directly to the final name`);const renamed=new Set(profile.renames.map(entry=>`${entry.tag}\0${entry.kind}\0${entry.from}`));for(const entry of profile.reviews)renamed.has(`${entry.tag}\0${entry.kind}\0${entry.name}`)&&findings.push(`${entryLabel(origin,"reviews",entry)}: a member is either renamed or reviewed, not both`);projected&&validateExposure(findings,profile)}if(ledger.profiles.length>=2){const historicalFields=ledger.profiles[0]?.detailFields,nextFields=ledger.profiles[1]?.detailFields;(Array.isArray(historicalFields)||Array.isArray(nextFields))&&JSON.stringify(historicalFields??[])!==JSON.stringify(nextFields??[])&&findings.push("lyra-v21 and lyra-v22 detailFields must preserve the same verified field exposures")}return findings}function componentMap(inventory){return new Map((inventory?.components??[]).map(component=>[component.tag,component]))}function surfaceEntry(component,kind,name){return(component?.surface?.[SURFACE_SECTIONS[kind]]??[]).find(entry=>entry.name===name)??null}function hasCurrentSuccessor(component,kind,name){const seen=new Set;for(;;){const key=`${kind}\0${name}`;if(seen.has(key))return!1;seen.add(key);const member=surfaceEntry(component,kind,name);if(!member)return!1;if(!member.deprecated)return!0;const replacement=deprecationRecordFor(component,kind,name)?.replacement;if(!replacement||replacement.kind==="component"||replacement.kind==="host-css-property")return!1;kind=replacement.kind,name=replacement.name}}function deprecationRecords(component){const records=[...component?.maturity?.deprecations??[]],componentRecord=component?.maturity?.deprecated;return isPlainObject(componentRecord)&&!records.some(record=>record.kind==="component")&&records.push(componentRecord),records}function deprecationRecordFor(component,kind,name){const records=deprecationRecords(component);if(kind==="component")return records.find(record=>record.kind==="component")??null;const direct=records.find(record=>record.kind===kind&&record.name===name);return direct||kind!=="attribute"?direct??null:records.find(record=>record.kind==="property"&&record.attribute===name)??null}function historicalMember(context,tag,kind,name){const key=JSON.stringify(["member",tag,kind,name]);return context?.records?.[key]??context?.records?.[context?.aliases?.[key]]??null}function historicalSourceComponent(context,tag,record=null){const historical=record??historicalMember(context,tag,"component",tag);return historical?.state!=="retired"?null:historical.sourceComponent??context?.sourceComponents?.[tag]??null}function historicalExport(context,entry){return context?.records?.[JSON.stringify(["export",entry.kind,entry.module??null,entry.name])]??null}function ownerFor(components,context,tag){const current=components.get(tag);return current||historicalSourceComponent(context,tag)}function policyFor(component,context,tag,kind,name){return deprecationRecordFor(component,kind,name)??historicalMember(context,tag,kind,name)?.policy??null}function replacementOwner(components,context,tag,kind,name){const historical=historicalMember(context,tag,kind,name);return components.get(historical?.state==="retired"?historical.replacementOwner:tag)}function replacementMatches(component,kind,record,to){const replacement=record?.replacement;return isPlainObject(replacement)?replacement.kind===kind&&replacement.name===to?!0:kind==="attribute"&&replacement.kind==="property"?surfaceEntry(component,"property",replacement.name)?.attribute===to:!1:!1}function isBooleanMember(entry){return String(entry?.type??"").split("|").map(part=>part.trim()).includes("boolean")}function exposingTags(inventory,kind,name){return(inventory?.components??[]).filter(component=>surfaceEntry(component,kind,name)).map(component=>component.tag).sort(compareText)}const UNMIRRORED_CLASSIFICATIONS=new Set(["conceptual-only","unsupported"]);function mirroredMembers(inventory){const upstreamComponents=new Map;for(const ecosystem of Object.values(inventory?.upstreams??{}))for(const component of ecosystem?.components??[])upstreamComponents.set(component.tag,component);const mirrored=new Map;for(const mapping of inventory?.mappings??[]){if(!mapping?.targetTag||UNMIRRORED_CLASSIFICATIONS.has(mapping.classification))continue;const upstream=upstreamComponents.get(mapping.upstreamTag);for(const[kind,section]of Object.entries(SURFACE_SECTIONS)){const rewrites=mapping.rewrites?.[section]??[],renamedAway=new Set(rewrites.map(rule=>rule?.from)),names=[...rewrites.map(rule=>rule?.to).filter(name=>typeof name=="string"),...(upstream?.surface?.[section]??[]).map(entry=>entry.name).filter(name=>!renamedAway.has(name))];for(const name of names){const key=`${mapping.targetTag}\0${kind}\0${name}`;mirrored.has(key)||mirrored.set(key,mapping.upstreamTag)}}}return mirrored}function validateRenameLedger(ledger,{inventory,exportDeprecations=[],requireCoverage=!1,sharedTokens=null,compatibilityContext=null,historicalReleaseMajor=null}){const findings=validateRenameLedgerShape(ledger,{historicalReleaseMajor});if(findings.length)return findings;const components=componentMap(inventory);if(!Array.isArray(exportDeprecations))return["exportDeprecations must be an array"];if(!exportDeprecations.every(isPlainObject))return["exportDeprecations entries must be objects"];const moduleRecords=new Map(exportDeprecations.map(record=>[moduleReviewKey(record),record]));moduleRecords.size!==exportDeprecations.length&&findings.push("exportDeprecations contains duplicate module records");const mirrored=mirroredMembers(inventory),mirrorOf=(tag,kind,name)=>mirrored.get(`${tag}\0${kind}\0${name}`)??null;for(const profile of ledger.profiles){const origin=profile.origin,covered=new Set,release=`${profile.toMajor}.0.0`,removalMajorMatches=record=>majorOf(record?.removalNotBefore)===profile.aliasRemovalMajor,checkRecordWindow=(label,record)=>{if(removalMajorMatches(record)||findings.push(`${label}: its deprecation record must set removalNotBefore to ${profile.aliasRemovalMajor}.0.0`),record?.since===UNRELEASED_VERSION)return;const since=compareVersions(record?.since,release);(since===null||since>0)&&findings.push(`${label}: its deprecation record must start no later than ${release} (since ${JSON.stringify(record?.since)})`)},checkLyraOnly=(label,tag,kind,name)=>{const upstream=mirrorOf(tag,kind,name);upstream&&findings.push(`${label}: ${name} mirrors ${upstream}; mirrored names never change`)},checkSharedToken=(label,kind,name)=>{kind==="css-property"&&sharedTokens?.has(name)&&findings.push(`${label}: ${name} is a canonical design token, not a component-owned custom property`)},presenceDefaults=new Set(ledger.profiles.filter(candidate=>candidate.toMajor<=profile.toMajor).flatMap(candidate=>candidate.defaults).filter(entry=>entry.value===!0).map(entry=>`${entry.tag}\0${entry.attribute}`)),inversionCompanions=new Set;for(const entry of profile.detailFields??[]){const label=entryLabel(origin,"detailFields",entry),component=ownerFor(components,compatibilityContext,entry.tag);component?surfaceEntry(component,"event",entry.event)||findings.push(`${label}: the event is not dispatched by ${entry.tag}`):findings.push(`${label}: component is not in the inventory`)}for(const entry of profile.renames){const label=entryLabel(origin,"renames",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}covered.add(`${entry.tag}\0${entry.kind}\0${entry.from}`),checkLyraOnly(label,entry.tag,entry.kind,entry.from),checkSharedToken(label,entry.kind,entry.from),checkSharedToken(label,entry.kind,entry.to);const historical=historicalMember(compatibilityContext,entry.tag,entry.kind,entry.from),retired=historical?.state==="retired",from=surfaceEntry(retired?historicalSourceComponent(compatibilityContext,entry.tag,historical):component,entry.kind,entry.from),targetOwner=replacementOwner(components,compatibilityContext,entry.tag,entry.kind,entry.from),to=surfaceEntry(targetOwner,entry.kind,entry.to);from?from.deprecated||findings.push(`${label}: the alias ${entry.from} is not marked deprecated in the manifest`):findings.push(`${label}: the deprecated alias ${entry.from} is not on the public surface`),to?to.deprecated&&!(retired&&hasCurrentSuccessor(targetOwner,entry.kind,entry.to))&&findings.push(`${label}: the canonical name ${entry.to} is itself deprecated`):findings.push(`${label}: the canonical name ${entry.to} is not on the public surface`);const record=policyFor(component,compatibilityContext,entry.tag,entry.kind,entry.from);if(record?(checkRecordWindow(label,record),replacementMatches(targetOwner,entry.kind,record,entry.to)||findings.push(`${label}: its deprecation record names a different replacement than ${entry.to}`)):findings.push(`${label}: no deprecation record retires ${entry.from}`),(entry.kind==="attribute"||entry.kind==="property")&&from&&to&&isBooleanMember(from)&&isBooleanMember(to)){const toAttribute=entry.kind==="attribute"?entry.to:to.attribute,preservesPresence=!!toAttribute&&presenceDefaults.has(`${entry.tag}\0${toAttribute}`);entry.polarity==="inverted"?(to.default===!0&&findings.push(`${label}: an inverted rename must target a boolean that defaults to false`),from.default!==!0&&toAttribute&&inversionCompanions.add(`${entry.tag}\0${toAttribute}`),from.default!==!0&&!preservesPresence&&findings.push(`${label}: ${entry.from} defaults to false, so the inverted rename needs a defaults entry inserting ${toAttribute??entry.to} where both are absent`)):from.default===!0&&to.default!==!0&&!preservesPresence&&findings.push(`${label}: ${entry.from} defaults to true and ${entry.to} to false; declare "polarity": "inverted" or preserve the default with a defaults entry`)}else entry.polarity==="inverted"&&from&&to&&findings.push(`${label}: an inverted rename must retire a boolean for a boolean`)}for(const entry of profile.reviews){const label=entryLabel(origin,"reviews",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}covered.add(`${entry.tag}\0${entry.kind}\0${entry.name}`),entry.kind!=="component"&&checkLyraOnly(label,entry.tag,entry.kind,entry.name),checkSharedToken(label,entry.kind,entry.name);const record=policyFor(component,compatibilityContext,entry.tag,entry.kind,entry.name);record?checkRecordWindow(label,record):findings.push(`${label}: no deprecation record retires ${JSON.stringify(entry.name)}`)}for(const entry of profile.detailChanges){const label=entryLabel(origin,"detailChanges",entry),component=ownerFor(components,compatibilityContext,entry.tag);component?surfaceEntry(component,"event",entry.event)?checkLyraOnly(label,entry.tag,"event",entry.event):findings.push(`${label}: the event is not dispatched by ${entry.tag}`):findings.push(`${label}: component is not in the inventory`)}for(const entry of profile.retiredEvents??[]){const label=entryLabel(origin,"retiredEvents",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component)findings.push(`${label}: component is not in the inventory`);else{surfaceEntry(component,"event",entry.event)&&findings.push(`${label}: retired event is still dispatched by ${entry.tag}`),deprecationRecordFor(component,"event",entry.event)&&findings.push(`${label}: a retired event must not keep a current deprecation record`);const target=surfaceEntry(component,"event",entry.replacement);(!target||target.deprecated)&&findings.push(`${label}: replacement is not a current event on ${entry.tag}`),checkLyraOnly(label,entry.tag,"event",entry.event)}}for(const entry of profile.propertyChanges??[]){const label=entryLabel(origin,"propertyChanges",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component)findings.push(`${label}: component is not in the inventory`);else{const historical=historicalMember(compatibilityContext,entry.tag,"property",entry.property),propertyOwner=historical?.state==="retired"?historical.sourceComponent??historicalSourceComponent(compatibilityContext,entry.tag,historical):component;surfaceEntry(propertyOwner,"property",entry.property)?checkLyraOnly(label,entry.tag,"property",entry.property):findings.push(`${label}: the property is not on the public surface`),entry.former&&surfaceEntry(propertyOwner,"property",entry.former)&&findings.push(`${label}: the former property name is still on the public surface`)}}for(const entry of profile.slotContent){const label=entryLabel(origin,"slotContent",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}surfaceEntry(component,"slot",entry.slot)||findings.push(`${label}: the slot is not on the public surface`);const record=policyFor(component,compatibilityContext,entry.tag,"slot-content",entry.slot);record&&(covered.add(`${entry.tag}\0slot-content\0${entry.slot}`),Array.isArray(record.permittedContent)&&JSON.stringify(entry.allow??null)!==JSON.stringify(record.permittedContent)&&findings.push(`${label}: its deprecation record permits ${record.permittedContent.join(", ")}; allow must list exactly those elements`))}for(const entry of profile.defaults){const label=entryLabel(origin,"defaults",entry),component=ownerFor(components,compatibilityContext,entry.tag);if(!component){findings.push(`${label}: component is not in the inventory`);continue}const attribute=surfaceEntry(component,"attribute",entry.attribute);if(!attribute){findings.push(`${label}: the attribute is not on the public surface`);continue}inversionCompanions.has(`${entry.tag}\0${entry.attribute}`)||checkLyraOnly(label,entry.tag,"attribute",entry.attribute),entry.value===!0&&!isBooleanMember(attribute)&&findings.push(`${label}: presence insertion requires a boolean attribute`),attribute.hasDefault&&String(attribute.default)===String(entry.value)&&findings.push(`${label}: the value equals the current default, so there is nothing to preserve`)}for(const entry of profile.globals??[]){const label=entryLabel(origin,"globals",entry);if(entry.kind==="part"){const component=ownerFor(components,compatibilityContext,entry.tag);component?surfaceEntry(component,"part",entry.from)||findings.push(`${label}: the part is not on the public surface`):findings.push(`${label}: component is not in the inventory`)}else entry.kind==="css-property"&&[...components.values()].some(component=>(component.surface?.cssProperties??[]).some(property=>entry.prefix?property.name.startsWith(entry.from):property.name===entry.from))&&findings.push(`${label}: a component still exposes the custom property`)}const coveredModules=new Set;for(const entry of profile.moduleReviews){const label=entryLabel(origin,"moduleReviews",entry),key=moduleReviewKey(entry);coveredModules.add(key);const record=moduleRecords.get(key)??historicalExport(compatibilityContext,entry)?.policy;record?(checkRecordWindow(label,record),!record.replacement?.usage&&!record.replacement?.name&&findings.push(`${label}: canonical replacement is missing`)):findings.push(`${label}: no canonical exportDeprecations record`)}if(!requireCoverage)continue;for(const record of[...exportDeprecations,...Object.values(compatibilityContext?.records??{}).filter(entry=>entry.state==="retired"&&entry.key.scope==="export").map(entry=>entry.policy)])removalMajorMatches(record)&&!coveredModules.has(moduleReviewKey(record))&&findings.push(`${origin}: ${record.kind} ${record.module??""} ${record.name} is removed in ${profile.aliasRemovalMajor}.0.0 but has no moduleReviews entry`);const coverageOwners=new Map((inventory?.components??[]).map(component=>[component.tag,deprecationRecords(component)]));for(const entry of Object.values(compatibilityContext?.records??{}))entry.state!=="retired"||entry.key.scope!=="member"||coverageOwners.set(entry.key.tag,[...coverageOwners.get(entry.key.tag)??[],entry.policy]);for(const[tag,records]of coverageOwners){const component={tag};for(const record of records){if(!removalMajorMatches(record))continue;const keys=[[record.kind,record.kind==="component"?component.tag:record.name]];record.kind==="property"&&record.attribute&&keys.push(["attribute",record.attribute]);for(const[kind,name]of keys)kind!=="component"&&mirrorOf(component.tag,kind,name)||covered.has(`${component.tag}\0${kind}\0${name}`)||findings.push(`${origin}: ${component.tag} ${kind} ${JSON.stringify(name)} is removed in ${profile.aliasRemovalMajor}.0.0 but has no ${kind==="slot-content"?"slotContent":"rename or review"} entry`)}}}return[...new Set(findings)]}function projectRenameLedger(ledger,inventory,{exportDeprecations=[],compatibilityContext=null,historicalReleaseMajor=null}={}){const findings=validateRenameLedger(ledger,{inventory,exportDeprecations,compatibilityContext,historicalReleaseMajor});if(findings.length)throw new Error(`Invalid Lyra rename ledger: ${findings.join("; ")}`);const components=componentMap(inventory),moduleRecords=new Map(exportDeprecations.map(record=>[moduleReviewKey(record),record])),projection={schemaVersion:1,profiles:ledger.profiles.map(profile=>{const release=`${profile.toMajor}.0.0`,exposure=Object.fromEntries(EXPOSURE_KINDS.map(kind=>[kind,{}]));for(const[kind,names]of requiredExposure(profile))for(const name of[...names.keys()].sort(compareText))exposure[kind][name]=[...new Set([...exposingTags(inventory,kind,name),...compatibilityContext?.exposure?.[kind]?.[name]??[]])].sort(compareText);const recordFor=(entry,kind,name)=>policyFor(components.get(entry.tag),compatibilityContext,entry.tag,kind,name);return{origin:profile.origin,fromMajor:profile.fromMajor,toMajor:profile.toMajor,aliasRemovalMajor:profile.aliasRemovalMajor,renames:profile.renames.map(entry=>{const target=surfaceEntry(replacementOwner(components,compatibilityContext,entry.tag,entry.kind,entry.from),entry.kind,entry.to),attribute=entry.kind==="attribute"?entry.to:target?.attribute,preservesDefault=entry.polarity==="inverted"&&profile.defaults.some(rule=>rule.tag===entry.tag&&rule.attribute===attribute),since=recordFor(entry,entry.kind,entry.from).since,beforeRelease=since===UNRELEASED_VERSION||compareVersions(since,release)<0;return{...structuredClone(entry),since:preservesDefault&&beforeRelease?release:since,...entry.kind==="attribute"?{reflects:!!target?.reflects}:{}}}),defaults:profile.defaults.map(entry=>({...structuredClone(entry),since:release})),retiredEvents:(profile.retiredEvents??[]).map(entry=>({...structuredClone(entry),since:release})),detailChanges:profile.detailChanges.map(entry=>({...structuredClone(entry),since:release})),...Array.isArray(profile.detailFields)?{detailFields:profile.detailFields.map(entry=>structuredClone(entry))}:{},propertyChanges:(profile.propertyChanges??[]).map(entry=>({...structuredClone(entry),since:release})),...Array.isArray(profile.globals)?{globals:profile.globals.map(entry=>structuredClone(entry))}:{},reviews:profile.reviews.map(entry=>{const record=recordFor(entry,entry.kind,entry.name),retired=historicalMember(compatibilityContext,entry.tag,entry.kind,entry.name);return{...structuredClone(entry),replacement:String(record.replacement?.usage||record.replacement?.name),...retired?.state==="retired"?{removedIn:retired.removedIn}:{},removalNotBefore:record.removalNotBefore,since:record.since}}),slotContent:profile.slotContent.map(entry=>({...structuredClone(entry),since:release})),moduleReviews:profile.moduleReviews.map(entry=>{const retired=historicalExport(compatibilityContext,entry),record=moduleRecords.get(moduleReviewKey(entry))??retired?.policy;return{...structuredClone(entry),replacement:String(record.replacement.usage||record.replacement.name),...retired?.state==="retired"?{removedIn:retired.removedIn}:{},since:record.since,removalNotBefore:record.removalNotBefore}}),exposure}})},shapeFindings=validateRenameLedgerShape(projection,{projected:!0,historicalReleaseMajor});if(shapeFindings.length)throw new Error(`Invalid Lyra rename projection: ${shapeFindings.join("; ")}`);return projection}function indexBy(entries,keyOf){const index=new Map;for(const entry of entries){const key=keyOf(entry),list=index.get(key)??[];list.push(entry),index.set(key,list)}return index}const ownerKey=(tag,kind,name)=>`${tag}\0${kind}\0${name}`,nameKey=(kind,name)=>`${kind}\0${name}`;function createRenameProfiles(projection,{lyraVersion=null}={}){const findings=validateRenameLedgerShape(projection,{projected:!0});if(findings.length)throw new Error(`Invalid Lyra rename projection: ${findings.join("; ")}`);if(lyraVersion!==null&&!parseVersion(lyraVersion))throw new Error(`Invalid Lyra version: ${lyraVersion}`);const profiles=new Map,availableAcrossProfiles=entry=>lyraVersion===null||entry.since!==UNRELEASED_VERSION&&compareVersions(entry.since,lyraVersion)<=0,allRenames=projection.profiles.flatMap(profile=>profile.renames).filter(availableAcrossProfiles),allDefaults=projection.profiles.flatMap(profile=>profile.defaults).filter(availableAcrossProfiles);for(const full of projection.profiles){const skipped=[],available=list=>(full[list]??[]).filter(entry=>{if(lyraVersion===null)return!0;const availableFrom=list==="detailFields"?entry.observedIn:entry.since;return availableFrom!==UNRELEASED_VERSION&&compareVersions(availableFrom,lyraVersion)<=0?!0:(skipped.push({list,...entry}),!1)}).map(entry=>{if(!entry.removedIn||lyraVersion===null||compareVersions(lyraVersion,entry.removedIn)>=0)return entry;const{removedIn,...beforeRemoval}=entry;return beforeRemoval}),data={...full,...Object.fromEntries(PROFILE_LIST_KEYS.map(list=>[list,available(list)]))},renamesByOwner=new Map(data.renames.map(entry=>[ownerKey(entry.tag,entry.kind,entry.from),entry])),renamesByName=indexBy(data.renames,entry=>nameKey(entry.kind,entry.from)),renamesByTarget=indexBy(data.renames,entry=>nameKey(entry.kind,entry.to)),reviewsByOwner=new Map(data.reviews.map(entry=>[ownerKey(entry.tag,entry.kind,entry.name),entry])),reviewsByName=indexBy(data.reviews,entry=>nameKey(entry.kind,entry.name)),detailsByOwner=new Map(data.detailChanges.map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),detailsByName=indexBy(data.detailChanges,entry=>entry.event),fieldsByOwnerEvent=new Map((data.detailFields??[]).map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),fieldsByEvent=indexBy(data.detailFields??[],entry=>entry.event),retiredByOwner=new Map(data.retiredEvents.map(entry=>[ownerKey(entry.tag,"event",entry.event),entry])),retiredByName=indexBy(data.retiredEvents,entry=>entry.event),propertiesByOwner=new Map(data.propertyChanges.flatMap(entry=>[entry.property,...entry.former?[entry.former]:[]].map(name=>[ownerKey(entry.tag,"property",name),entry]))),exposure=new Map(EXPOSURE_KINDS.map(kind=>[kind,new Map(Object.entries(data.exposure[kind]).map(([name,tags2])=>[name,new Set(tags2)]))])),defaultsByTag=indexBy(data.defaults,entry=>entry.tag),slotContentByTag=indexBy(data.slotContent,entry=>entry.tag),tags=new Set([...data.renames,...data.reviews,...data.detailChanges,...data.detailFields??[],...data.retiredEvents,...data.propertyChanges,...data.defaults,...data.slotContent].map(entry=>entry.tag)),renamesNamed=(kind,name)=>renamesByName.get(nameKey(kind,name))??[],exposersOf=(kind,name)=>exposure.get(kind)?.get(name)??new Set,movers=(kind,from,to)=>new Set(renamesNamed(kind,from).filter(entry=>entry.to===to&&!entry.polarity).map(entry=>entry.tag)),subset=(left,right)=>[...left].every(tag=>right.has(tag));profiles.set(data.origin,{origin:data.origin,fromMajor:data.fromMajor,toMajor:data.toMajor,aliasRemovalMajor:data.aliasRemovalMajor,data,skipped,tags,isEmpty:tags.size===0&&data.moduleReviews.length===0&&data.globals.length===0,renameFor:(tag,kind,name)=>renamesByOwner.get(ownerKey(tag,kind,name))??null,renamesNamed,renamesOnto:(kind,name)=>renamesByTarget.get(nameKey(kind,name))??[],reviewFor:(tag,kind,name)=>reviewsByOwner.get(ownerKey(tag,kind,name))??null,reviewsNamed:(kind,name)=>reviewsByName.get(nameKey(kind,name))??[],detailFor:(tag,event)=>detailsByOwner.get(ownerKey(tag,"event",event))??null,detailsNamed:event=>detailsByName.get(event)??[],detailFieldFor:(tag,event)=>fieldsByOwnerEvent.get(ownerKey(tag,"event",event))??null,detailFieldsNamed:event=>fieldsByEvent.get(event)??[],retiredEventFor:(tag,event)=>retiredByOwner.get(ownerKey(tag,"event",event))??null,retiredEventsNamed:event=>retiredByName.get(event)??[],propertyChangeFor:(tag,property)=>propertiesByOwner.get(ownerKey(tag,"property",property))??null,defaultsFor:tag=>defaultsByTag.get(tag)??[],preservedDefaultsFor:tag=>allDefaults.filter(entry=>entry.tag===tag),defaultAliasesFor:(tag,attribute)=>{const aliases=new Set([attribute]);for(const rename of allRenames)rename.tag!==tag||rename.kind!=="attribute"||(rename.from===attribute&&aliases.add(rename.to),rename.to===attribute&&aliases.add(rename.from));return[...aliases]},slotContentFor:tag=>slotContentByTag.get(tag)??[],exposes:(kind,name,tag)=>!!tag&&exposersOf(kind,name).has(tag),exposers:(kind,name)=>[...exposersOf(kind,name)],targetKeepers(kind,from,to){const moving=movers(kind,from,to);return[...exposersOf(kind,to)].filter(tag=>!moving.has(tag))},sourceKeepers(kind,from,to){const moving=movers(kind,from,to);return[...exposersOf(kind,from)].filter(tag=>!moving.has(tag))},isGlobal(kind,from){const entries=renamesNamed(kind,from);if(!entries.length||entries.some(entry=>entry.polarity))return!1;const targets=new Set(entries.map(entry=>entry.to));if(targets.size!==1)return!1;const[to]=targets,moving=movers(kind,from,to);return exposersOf(kind,from).size>0&&subset(exposersOf(kind,from),moving)&&subset(exposersOf(kind,to),moving)},gainedOwners(kind,name){const onto=(renamesByTarget.get(nameKey(kind,name))??[]).filter(entry=>!entry.polarity);if(!onto.length)return[];const gained=new Set(onto.map(entry=>entry.tag));return[...exposersOf(kind,name)].filter(tag=>!gained.has(tag)).length?[...gained].sort(compareText):[]}})}return profiles}export{LYRA_RENAME_ORIGINS,compareVersions,createRenameProfiles,emptyRenameLedger,emptyRenameProjection,mirroredMembers,projectRenameLedger,validateRenameLedger,validateRenameLedgerShape};

package/dist/cli/lyra-ui.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import{spawnSync}from"node:child_process";import{fileURLToPath}from"node:url";import{runInitAgents}from"./init-agents.mjs";import{isMainModule}from"./is-main-module.mjs";const USAGE=`Usage: lyra-ui <command> [options]
+
+Commands:
+  init-agents   set up AI coding agents (Claude Code, Codex, OpenCode, ...) with the Lyra UI skills
+  migrate-wa    rename Web Awesome / Shoelace usage to lr-* (same as lyra-ui-migrate)
+
+Run \`lyra-ui <command> --help\` for a command's options.
+`;async function runLyraUi(argv){const[command,...rest]=argv;return command==="init-agents"?await runInitAgents(rest):command==="migrate-wa"?spawnSync(process.execPath,[fileURLToPath(new URL("./migrate-wa.mjs",import.meta.url)),...rest],{stdio:"inherit"}).status??1:command===void 0||command==="--help"||command==="-h"?(console.log(USAGE),command===void 0?2:0):(console.error(`lyra-ui: unknown command "${command}"
+
+${USAGE}`),2)}isMainModule(import.meta.url)&&(process.exitCode=await runLyraUi(process.argv.slice(2)));export{runLyraUi};

package/dist/cli/migrate-wa.mjs

@@ -18,14 +18,16 @@ deprecated Lyra 21 member names
 change what a site reaches, preserves changed defaults, and reports everything else, including
 listeners of events whose detail changed. --origin=lyra-v22 reports deprecated theme APIs,
 stylesheets, window events and root attributes; review their replacement semantics explicitly.
-Lyra profiles never rewrite tags or imports. Run a Lyra profile with the CLI of the installed
-release, after upgrading.
+--origin=lyra-v26 moves the package specifiers and root-barrel types that Lyra 27 relocated,
+reports removed localization keys. 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
   --check              exit nonzero when rewrites or warnings remain; never write source files
   --diff               print a unified diff of the changes instead of writing source files
   --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
   --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