@aceshooting/lyra-ui 26.0.0 → 27.0.0

package/dist/cli/component-inventory.mjs

@@ -1 +1 @@
-import path from"node:path";const INVENTORY_SCHEMA_VERSION=1,SURFACE_SECTIONS=["attributes","properties","slots","events","parts","cssProperties","cssStates","methods","staticProperties","staticMethods","moduleExports","form","native"],MAPPING_CLASSIFICATIONS=["exact","rewritten","warning-required","conceptual-only","unsupported"],ACCESSIBILITY_PROFILE_SECTIONS=["semantics","naming","keyboard","focus","states","announcements","motion"],ACCESSIBILITY_BEHAVIOR_VOCABULARY=Object.freeze({semantics:Object.freeze(["alert","article","button","checkbox","combobox","composition-primitive","dialog","document","grid","group","iframe","img","link","list","listbox","menu","menuitem","navigation","option","presentation","progressbar","radio","radiogroup","region","separator","slider","spinbutton","status","switch","tab","table","tablist","tabpanel","text-content","textbox","tooltip","transparent-content","tree","treeitem","video"]),naming:Object.freeze(["alternative-text","author-label-required","content-derived","content-or-author-label","control-labels-localized","current-page","frame-title","heading-level","value-text","visible-or-author-label"]),keyboard:Object.freeze(["arrow-navigation","data-point-navigation","escape-dismiss","home-end-navigation","media-controls","native-activation","native-editing","page-navigation","range-adjustment","spatial-adjustment","tab-cycle","typeahead"]),focus:Object.freeze(["focus-follows-selection","focus-preserved","focus-return","focus-trap","focus-visible-on-reveal","frame-focus-gated","initial-focus","native-focus","roving-focus"]),states:Object.freeze(["busy","checked","current","disabled","expanded","invalid","modal","multiselectable","orientation","paused","pressed","readonly","required","selected","sort","value-range"]),announcements:Object.freeze(["autoplay-content-change","character-count","content-change","copy-result","live-alert","live-status","page-change","playback-state","progress-value","selection-change","validation-message"]),motion:Object.freeze(["respects-reduced-motion","stops-autoplay","suppresses-animation","user-pause-control"])}),ACCESSIBILITY_COMPARISON_STATUSES=["equivalent","target-additive","not-applicable","warning-required"],ACCESSIBILITY_EVIDENCE=Object.freeze({upstream:"pinned-public-contract",target:"lyra-authored-contract-and-automated-tests"}),REWRITE_RULE_SECTIONS=["attributes","properties","events","slots","parts","cssProperties","methods","defaults"],NORMALIZATION_SECTIONS=["typeEquivalences","structuralTypeAliases","methodParameterTypeEquivalences","defaultEquivalences","derivedDefaultEquivalences","inferredAttributeSuppressions","unknownMethodReturnTypes","cancelabilityEquivalences","cancelabilityPathAdditions","attributePropertyEquivalences","reflectionEquivalences","cssDefaultEquivalences","deprecationEquivalences"],CANCELABILITY_RANK=new Map([["never",0],["conditional",1],["always",2]]),LOCAL_MIGRATION_ORIGINS=[],LOCAL_MIGRATION_PROFILES=[],MIGRATION_ATTRIBUTE_EXCLUSIONS=Object.freeze({dir:"platform-global-passthrough",lang:"platform-global-passthrough",role:"platform-global-passthrough",tabindex:"platform-global-passthrough",title:"platform-global-passthrough","did-ssr":"upstream-hydration-marker"});function emptyRewrites(){return Object.fromEntries(REWRITE_RULE_SECTIONS.map(section=>[section,[]]))}function emptyNormalizations(){return Object.fromEntries(NORMALIZATION_SECTIONS.map(section=>[section,[]]))}function isPlainObject(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function accessibilityBehaviorSet(profile){return new Set(ACCESSIBILITY_PROFILE_SECTIONS.flatMap(section=>(profile?.[section]??[]).map(behavior=>`${section}:${behavior}`)))}function compareAccessibilityProfiles(profiles,upstreamProfile,targetProfile){const upstream=profiles?.[upstreamProfile],target=profiles?.[targetProfile];if(!upstream)throw new Error(`unknown upstream accessibility profile ${String(upstreamProfile)}`);if(!target)throw new Error(`unknown target accessibility profile ${String(targetProfile)}`);const upstreamBehaviors=accessibilityBehaviorSet(upstream),targetBehaviors=accessibilityBehaviorSet(target),missing=[...upstreamBehaviors].filter(behavior=>!targetBehaviors.has(behavior)).sort(),additions=[...targetBehaviors].filter(behavior=>!upstreamBehaviors.has(behavior)).sort();return{status:upstreamBehaviors.size===0&&targetBehaviors.size===0?"not-applicable":missing.length>0?"warning-required":additions.length>0?"target-additive":"equivalent",missing,additions}}function deriveStaticApiReviewStatus({upstreamReviewStatus,targetPresent,comparisonPerformed}){return upstreamReviewStatus==="tag-only"?"tag-only":upstreamReviewStatus==="complete"&&targetPresent===!0&&comparisonPerformed===!0?"reviewed":"unreviewed"}function validateAccessibilityProfiles(profiles,findings){if(!isPlainObject(profiles)||Object.keys(profiles).length===0){findings.push("accessibilityProfiles must be a non-empty object");return}for(const[profileName,profile]of Object.entries(profiles)){if(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(profileName)||findings.push(`accessibility profile ${profileName}: invalid profile name`),!isPlainObject(profile)){findings.push(`accessibility profile ${profileName}: profile must be an object`);continue}const allowedKeys=new Set(["description",...ACCESSIBILITY_PROFILE_SECTIONS]),unknownKeys=Object.keys(profile).filter(key=>!allowedKeys.has(key));unknownKeys.length>0&&findings.push(`accessibility profile ${profileName}: unknown key(s) ${unknownKeys.join(", ")}`),(typeof profile.description!="string"||!profile.description.trim())&&findings.push(`accessibility profile ${profileName}: description must be non-empty`);for(const section of ACCESSIBILITY_PROFILE_SECTIONS){const behaviors=profile[section];if(!Array.isArray(behaviors)){findings.push(`accessibility profile ${profileName}: ${section} must be an array`);continue}new Set(behaviors).size!==behaviors.length&&findings.push(`accessibility profile ${profileName}: duplicate ${section} behavior`),JSON.stringify(behaviors)!==JSON.stringify([...behaviors].sort())&&findings.push(`accessibility profile ${profileName}: ${section} behaviors must be sorted`);const allowed=new Set(ACCESSIBILITY_BEHAVIOR_VOCABULARY[section]);for(const behavior of behaviors)allowed.has(behavior)||findings.push(`accessibility profile ${profileName}: unknown ${section} behavior ${String(behavior)}`)}}}function validateAccessibilityParity(mapping,profiles,findings){const accessibility=mapping.parity?.accessibility;if(!isPlainObject(accessibility)){findings.push(`${mapping.upstreamTag}: missing accessibility parity review`);return}const allowedKeys=new Set(["reviewStatus","upstreamProfile","targetProfile","evidence","comparison","rationale"]),unknownKeys=Object.keys(accessibility).filter(key=>!allowedKeys.has(key));unknownKeys.length>0&&findings.push(`${mapping.upstreamTag}: accessibility parity has unknown key(s) ${unknownKeys.join(", ")}`),accessibility.reviewStatus!=="complete"&&findings.push(`${mapping.upstreamTag}: accessibility parity review is incomplete`),(!isPlainObject(accessibility.evidence)||accessibility.evidence.upstream!==ACCESSIBILITY_EVIDENCE.upstream||accessibility.evidence.target!==ACCESSIBILITY_EVIDENCE.target||Object.keys(accessibility.evidence??{}).some(key=>key!=="upstream"&&key!=="target"))&&findings.push(`${mapping.upstreamTag}: accessibility parity evidence is invalid`),(typeof accessibility.rationale!="string"||!accessibility.rationale.trim())&&findings.push(`${mapping.upstreamTag}: accessibility parity rationale must be non-empty`);let expected;try{expected=compareAccessibilityProfiles(profiles,accessibility.upstreamProfile,accessibility.targetProfile)}catch(error){findings.push(`${mapping.upstreamTag}: ${error instanceof Error?error.message:String(error)}`);return}(!isPlainObject(accessibility.comparison)||!sameJson(accessibility.comparison,expected))&&findings.push(`${mapping.upstreamTag}: stored accessibility comparison is stale`);const hasScopedConditionalReview=mapping.parity?.lightDom==="warning-required"&&Array.isArray(mapping.parity?.behaviorReviewFlags)&&mapping.parity.behaviorReviewFlags.length>0;(mapping.classification==="exact"||mapping.classification==="rewritten")&&expected.status==="warning-required"&&!hasScopedConditionalReview&&findings.push(`${mapping.upstreamTag}: automatic mapping has missing accessibility behavior`)}function validateAccessibilityContract(profiles,mappings){const findings=[];if(validateAccessibilityProfiles(profiles,findings),!Array.isArray(mappings))findings.push("accessibility mappings must be an array");else for(const mapping of mappings)validateAccessibilityParity(mapping,profiles,findings);return findings.sort()}const INTERNAL_METHOD_NAMES=new Set(["constructor","render","update","performUpdate","requestUpdate","shouldUpdate","willUpdate","updated","firstUpdated","createRenderRoot","connectedCallback","disconnectedCallback","adoptedCallback","attributeChangedCallback","addEventListener","removeEventListener","emit","localize","scheduleAfterUpdate","beginAbortableLoad","setCustomStates","setValue","updateValidity"]),PUBLIC_METHOD_NAMES=new Set(["focus","blur","click","select","show","hide","open","close","openSubmenu","closeSubmenu","toggle","checkValidity","reportValidity","setCustomValidity","resetValidity","formStateRestoreCallback","getForm","setSelectionRange","setRangeText","showPicker","stepUp","stepDown","play","pause","load","clearSearch","getHeadingTree","renderChart","renderMarkdown","search","searchNext","searchPrevious","handleColumnsChange","handlePageChange","handleSearchTermChange"]),FORM_PROPERTIES=new Set(["form","name","type","value","defaultValue","checked","defaultChecked","disabled","required","validity","validationMessage","willValidate","labels"]),FORM_METHODS=new Set(["checkValidity","reportValidity","setCustomValidity","getForm"]),NATIVE_METHODS=new Set(["focus","blur","click","select","setSelectionRange","setRangeText","showPicker","stepUp","stepDown","play","pause","load"]),NATIVE_EVENTS=new Set(["beforeinput","input","change","focus","blur","invalid","load","error","play","pause","ended","loadedmetadata","timeupdate","volumechange"]),UNDOCUMENTED_PUBLIC_FIELDS=new Set(["title"]),UNSPECIFIED_PUBLIC_DOCUMENTATION="unspecified-public-documentation",FRAMEWORK_CONTROLLER_FIELDS=new Set(["localize"]),PROPERTY_ONLY_FIELDS=new Set(["accessibleLabel","config","chart","currentTime","filter","files","keyframes","languages","marked","modal","selectedItems","selectedOptions","valueAsDate","valueAsNumber","validationMessage","validity","willValidate"]),hasOwn=(value,key)=>Object.prototype.hasOwnProperty.call(value,key),textOf=type=>type?.text?.replace(/\s+/g," ").trim()||"unknown",sortByName=entries=>[...entries].sort((a,b)=>a.name.localeCompare(b.name)),unique=entries=>[...new Set(entries)].sort();function canonicalDefault(raw){if(raw===void 0)return;if(raw===null||typeof raw=="boolean"||typeof raw=="number")return raw;const value=String(raw).trim();return value==="true"?!0:value==="false"?!1:value==="null"?null:value==="undefined"?"undefined":/^-?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i.test(value)?Number(value):value.startsWith("'")&&value.endsWith("'")||value.startsWith('"')&&value.endsWith('"')?value.slice(1,-1).replace(/\\(['"\\])/g,"$1"):value.replace(/\s+/g," ")}function kebabCase(name){return name.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replaceAll("_","-").toLowerCase()}function isInternalMethod(member,ecosystem){return member.kind!=="method"||member.static||member.privacy==="private"||member.privacy==="protected"?!0:ecosystem==="lyra"&&!member.inheritedFrom?!1:!!(INTERNAL_METHOD_NAMES.has(member.name)||/^(?:handle|on|_)[A-Z_]/.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||/Callback$/.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||member.inheritedFrom&&!PUBLIC_METHOD_NAMES.has(member.name)&&!FORM_METHODS.has(member.name)||ecosystem!=="lyra"&&!member.description&&!PUBLIC_METHOD_NAMES.has(member.name)&&!FORM_METHODS.has(member.name))}function isPublicField(member,attributeNames,ecosystem){return member.kind!=="field"||member.static||member.privacy==="private"||member.privacy==="protected"?!1:ecosystem==="lyra"&&!member.inheritedFrom?!0:/^_/.test(member.name)||FRAMEWORK_CONTROLLER_FIELDS.has(member.name)&&!member.attribute&&!attributeNames.has(member.name)&&!member.description?!1:attributeNames.has(member.name)||member.attribute||FORM_PROPERTIES.has(member.name)||PROPERTY_ONLY_FIELDS.has(member.name)?!0:member.inheritedFrom?FORM_PROPERTIES.has(member.name)||PROPERTY_ONLY_FIELDS.has(member.name):ecosystem==="shoelace"?!!member.description||FORM_PROPERTIES.has(member.name)||UNDOCUMENTED_PUBLIC_FIELDS.has(member.name):member.privacy==="public"||!!member.description||!!member.readonly}const FRAMEWORK_STATIC_FIELDS=new Set(["css","dependencies","elementProperties","formAssociated","observeSlots","shadowRootOptions","styles"]);function isPublicStaticField(member,ecosystem){return member.kind!=="field"||member.static!==!0||member.privacy==="private"||member.privacy==="protected"||FRAMEWORK_STATIC_FIELDS.has(member.name)?!1:ecosystem==="lyra"&&!member.inheritedFrom?!0:member.privacy==="public"||!!member.description||!!member.readonly}function isPublicStaticMethod(member,ecosystem){return member.kind!=="method"||member.static!==!0||member.privacy==="private"||member.privacy==="protected"?!1:ecosystem==="lyra"&&!member.inheritedFrom?!(INTERNAL_METHOD_NAMES.has(member.name)||/^(?:handle|on|_)[A-Z_]/u.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||/Callback$/u.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)):member.privacy==="public"||!!member.description}function normalizeParameter(parameter,ecosystem){const normalized={name:parameter.name,type:ecosystem!=="lyra"&&!parameter.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(parameter.type),optional:parameter.optional===!0};return hasOwn(parameter,"default")?(normalized.hasDefault=!0,normalized.default=canonicalDefault(parameter.default)):normalized.hasDefault=!1,normalized}function eventCancelabilityFromDescription(description="",ecosystem="lyra",eventName){const text=description.toLowerCase().replace(/\b(?:conditionally\s+|non[- ]?|not\s+|never\s+)?cancell?able\s+`(lr-[a-z0-9-]+)`/gu,(phrase,referencedEvent)=>referencedEvent===eventName?phrase:""),conditionalPattern=/\bconditionally\s+cancell?able\b/gu,negativePattern=/\b(?:non[- ]?|not\s+|never\s+)cancell?able\b/gu,conditional=conditionalPattern.exec(text),negative=negativePattern.exec(text),withoutQualifiedMarkers=text.replace(conditionalPattern,phrase=>" ".repeat(phrase.length)).replace(negativePattern,phrase=>" ".repeat(phrase.length)),markers=[{kind:"conditional",match:conditional},{kind:"never",match:negative},{kind:"always",match:/\bcancell?able\b/u.exec(withoutQualifiedMarkers)},{kind:"implicit-always",match:/preventdefault\(\)|\bcancel(?:ing|ling) this event\b/u.exec(text)}].filter(({match})=>match);markers.sort((left,right)=>left.match.index-right.match.index);const first=markers[0];if(!first)return ecosystem==="lyra"?"never":UNSPECIFIED_PUBLIC_DOCUMENTATION;if(first.kind==="conditional")return"conditional";const kinds=new Set(markers.map(({kind})=>kind));return kinds.has("always")&&kinds.has("never")||first.kind==="always"&&/\b(?:except|unless|single\s+exception)\b/u.test(text)?"conditional":first.kind==="implicit-always"?"always":first.kind}function normalizeAttributes(declaration,publicFields,ecosystem){const fields=new Map(publicFields.map(member=>[member.name,member])),declared=declaration.attributes??[],source=declared.length?declared:publicFields.filter(member=>!member.readonly&&!PROPERTY_ONLY_FIELDS.has(member.name)).map(member=>({name:member.attribute||kebabCase(member.name),fieldName:member.name,type:member.type,...hasOwn(member,"default")?{default:member.default}:{},inferred:!0}));return sortByName(source.map(attribute=>{const field=fields.get(attribute.fieldName||attribute.name)??publicFields.find(member=>member.attribute===attribute.name),normalized={name:attribute.name,property:attribute.fieldName||field?.name||attribute.name,type:textOf(attribute.parsedType||attribute.type||field?.type),reflects:field?.reflects===!0,inferred:attribute.inferred===!0||ecosystem==="shoelace"&&declared.length===0,deprecated:attribute.deprecation??attribute.deprecated??field?.deprecation??field?.deprecated??null,hasDefault:hasOwn(attribute,"default")||!!(field&&hasOwn(field,"default"))};return normalized.hasDefault&&(normalized.default=canonicalDefault(hasOwn(attribute,"default")?attribute.default:field.default)),normalized}))}function normalizeProperties(publicFields){return sortByName(publicFields.map(member=>{const normalized={name:member.name,attribute:typeof member.attribute=="string"?member.attribute:null,type:textOf(member.parsedType||member.type),readonly:member.readonly===!0,reflects:member.reflects===!0,deprecated:member.deprecation||member.deprecated||null,hasDefault:hasOwn(member,"default")};return normalized.hasDefault&&(normalized.default=canonicalDefault(member.default)),normalized}))}function normalizeMethodEntries(members,ecosystem){const grouped=new Map;for(const member of members){const overload={parameters:(member.parameters??[]).map(parameter=>normalizeParameter(parameter,ecosystem)),returnType:ecosystem!=="lyra"&&!member.return?.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(member.return?.type)},key=JSON.stringify(overload),current=grouped.get(member.name)??new Map;current.set(key,overload),grouped.set(member.name,current)}return[...grouped].map(([name,overloads])=>{const declaration=members.find(member=>member.kind==="method"&&member.name===name),deprecated=declaration?.deprecation||declaration?.deprecated||null;return{name,overloads:[...overloads.values()],...deprecated?{deprecated}:{}}}).sort((a,b)=>a.name.localeCompare(b.name))}function normalizeMethods(members,ecosystem){return normalizeMethodEntries(members.filter(member=>!isInternalMethod(member,ecosystem)),ecosystem)}function normalizeStaticProperties(members,ecosystem){return sortByName(members.filter(member=>isPublicStaticField(member,ecosystem)).map(member=>({name:member.name,type:textOf(member.parsedType||member.type),readonly:member.readonly===!0,deprecated:member.deprecation||member.deprecated||null})))}function normalizeStaticMethods(members,ecosystem){return normalizeMethodEntries(members.filter(member=>isPublicStaticMethod(member,ecosystem)),ecosystem)}function normalizedModulePath(modulePath){return typeof modulePath!="string"||!modulePath?null:path.posix.normalize(modulePath.replaceAll("\\","/").replace(/^\/+/,""))}function moduleLookupPath(modulePath){return normalizedModulePath(modulePath)?.replace(/\.(?:[cm]?js|ts)$/u,"")??null}function resolvedExportDeclarationPath(exportingModule,declarationModule){const exportingPath=normalizedModulePath(exportingModule),declaredPath=normalizedModulePath(declarationModule);return!exportingPath||!declaredPath?null:declarationModule.startsWith(".")?path.posix.normalize(path.posix.join(path.posix.dirname(exportingPath),declarationModule)):declaredPath}function moduleDeclarationIndex(manifest){const index=new Map;for(const module of manifest.modules??[]){const modulePath=moduleLookupPath(module.path);if(modulePath)for(const declaration of module.declarations??[]){if(!declaration?.name)continue;const key=`${modulePath}\0${declaration.name}`,declarations=index.get(key)??[];declarations.push(declaration),index.set(key,declarations)}}return index}function moduleExportDeclaration(index,module,entry){const exportingPath=moduleLookupPath(module.path),declarationName=entry.declaration?.name??entry.name,declaredPath=entry.declaration?.module?moduleLookupPath(resolvedExportDeclarationPath(module.path,entry.declaration.module)):exportingPath;return index.get(`${declaredPath}\0${declarationName}`)??index.get(`${exportingPath}\0${declarationName}`)??[]}function normalizeComponentModuleExports(manifest,componentModulePath,{ecosystem,additionalModules=[]}){const componentPath=normalizedModulePath(componentModulePath);if(!componentPath)return[];const scopedModules=new Set([componentPath,...additionalModules.map(modulePath=>normalizedModulePath(modulePath)).filter(Boolean)]),declarationIndex=moduleDeclarationIndex(manifest),normalized=[];for(const module of manifest.modules??[]){const modulePath=normalizedModulePath(module.path);if(!modulePath||!scopedModules.has(modulePath))continue;const explicitlyScoped=modulePath!==componentPath;for(const entry of module.exports??[]){if(entry.kind!=="js"||!entry.name||entry.name==="default"||entry.name==="*")continue;const declarations=moduleExportDeclaration(declarationIndex,module,entry),functions=declarations.filter(declaration=>declaration.kind==="function"&&declaration.privacy!=="private"&&declaration.privacy!=="protected"&&(ecosystem==="lyra"||declaration.privacy==="public"||!!declaration.description)),variable=declarations.find(declaration=>declaration.kind==="variable"&&declaration.privacy!=="private"&&declaration.privacy!=="protected"&&(ecosystem==="lyra"||declaration.privacy==="public"||!!declaration.description));if(functions.length>0){const callable=normalizeMethodEntries(functions.map(declaration=>({...declaration,kind:"method"})),ecosystem)[0];normalized.push({module:modulePath,name:entry.name,kind:"function",overloads:callable?.overloads??[],...callable?.deprecated?{deprecated:callable.deprecated}:{}})}else variable?normalized.push({module:modulePath,name:entry.name,kind:"variable",type:ecosystem!=="lyra"&&!variable.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(variable.type),readonly:variable.readonly===!0,deprecated:variable.deprecation||variable.deprecated||null}):declarations.length===0&&explicitlyScoped&&normalized.push({module:modulePath,name:entry.name,kind:"unknown",type:UNSPECIFIED_PUBLIC_DOCUMENTATION,deprecated:null})}}return normalized.sort((left,right)=>`${left.module}:${left.name}:${left.kind}`.localeCompare(`${right.module}:${right.name}:${right.kind}`))}const REVIEWED_COMPONENT_MODULE_EXPORT_SCOPES=new Map([["webawesome:wa-animation",["components/animation/animations.js"]]]);function normalizeNamed(entries){return sortByName((entries??[]).map(entry=>({name:entry.name??"",deprecated:entry.deprecation||entry.deprecated||null})))}function normalizeCssProperties(entries,tagName="custom element"){return sortByName((entries??[]).map(entry=>{if(typeof entry?.name!="string"||!entry.name)throw new Error(`${tagName}: malformed CSS custom-property manifest entry`);const normalized={name:entry.name,deprecated:entry.deprecation||entry.deprecated||null,hasDefault:hasOwn(entry,"default")};return normalized.hasDefault&&(normalized.default=canonicalDefault(entry.default)),normalized}))}function eventFlag(description,positive,negative){const text=String(description??"").toLowerCase();if(negative.test(text))return!1;if(positive.test(text))return!0}const EVENT_CONSTRUCTORS=["AnimationEvent","BeforeUnloadEvent","ClipboardEvent","CloseEvent","CompositionEvent","CustomEvent","DeviceMotionEvent","DeviceOrientationEvent","DragEvent","ErrorEvent","Event","FocusEvent","GamepadEvent","HashChangeEvent","InputEvent","KeyboardEvent","MessageEvent","MouseEvent","PageTransitionEvent","PointerEvent","PopStateEvent","ProgressEvent","PromiseRejectionEvent","SecurityPolicyViolationEvent","StorageEvent","SubmitEvent","ToggleEvent","TouchEvent","TrackEvent","TransitionEvent","UIEvent","WheelEvent"],EVENT_CONSTRUCTOR_PATTERN=EVENT_CONSTRUCTORS.join("|"),SINGLE_EVENT_TYPE=new RegExp(`^(${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?$`,"u"),EVENT_UNION_TYPE=new RegExp(`^(?:${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?(?:\\s*\\|\\s*(?:${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?)+$`,"u"),EVENT_WITH_COMPATIBILITY_DETAIL=new RegExp(`^(${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?\\s*&\\s*\\{[^]*\\bdetail\\s*:`,"u");function eventConstructor(type){const text=textOf(type),single=SINGLE_EVENT_TYPE.exec(text);if(single)return single[1];const withCompatibilityDetail=EVENT_WITH_COMPATIBILITY_DETAIL.exec(text);return withCompatibilityDetail?withCompatibilityDetail[1]:EVENT_UNION_TYPE.test(text)?text:void 0}function normalizeEvents(entries,ecosystem){return sortByName((entries??[]).map(entry=>{const deprecated=entry.deprecation||entry.deprecated||null,normalized={name:entry.name,type:textOf(entry.type),cancelable:eventCancelabilityFromDescription(entry.description,ecosystem,entry.name),...deprecated?{deprecated}:{}},constructor=eventConstructor(entry.type),bubbles=eventFlag(entry.description,/\b(?:bubbling|bubbles)\b/,/\b(?:non[- ]?bubbling|does not bubble|doesn't bubble)\b/),composed=eventFlag(entry.description,/\bcomposed\b/,/\b(?:non[- ]?composed|not composed)\b/);return constructor!==void 0&&(normalized.constructor=constructor),bubbles!==void 0&&(normalized.bubbles=bubbles),composed!==void 0&&(normalized.composed=composed),normalized}))}function declaredFormAssociation(declaration){if(typeof declaration.formAssociated=="boolean")return declaration.formAssociated;const ownStatic=(declaration.members??[]).find(member=>member.kind==="field"&&member.name==="formAssociated"&&member.static===!0&&!member.inheritedFrom);if(ownStatic)return ownStatic.default===!0||String(ownStatic.default).trim()==="true";if((declaration.mixins??[]).some(mixin=>mixin.name==="FormAssociated"))return!0}function canonicalModulePath(modulePath){return typeof modulePath=="string"?modulePath.replace(/^\/+/,"").replace(/\.js$/u,".ts"):null}function manifestFormAssociations(manifest){const declarations=[],byModuleAndName=new Map,byName=new Map;for(const module of manifest.modules??[])for(const declaration of module.declarations??[]){if(!declaration?.name)continue;declarations.push(declaration);const modulePath=canonicalModulePath(module.path);modulePath&&byModuleAndName.set(`${modulePath}\0${declaration.name}`,declaration);const named=byName.get(declaration.name)??[];named.push(declaration),byName.set(declaration.name,named)}const resolved=new Map,resolving=new Set,resolve=declaration=>{if(resolved.has(declaration))return resolved.get(declaration);if(resolving.has(declaration))return!1;resolving.add(declaration);let associated=declaredFormAssociation(declaration);if(associated===void 0&&declaration.superclass?.name){const modulePath=canonicalModulePath(declaration.superclass.module),exact=modulePath?byModuleAndName.get(`${modulePath}\0${declaration.superclass.name}`):void 0,named=byName.get(declaration.superclass.name)??[],superclass=exact??(named.length===1?named[0]:void 0);superclass&&(associated=resolve(superclass))}return associated===void 0&&(associated=(declaration.members??[]).some(member=>member.kind==="field"&&member.name==="formAssociated"&&member.static===!0&&!!member.inheritedFrom&&(member.default===!0||String(member.default).trim()==="true"))),resolving.delete(declaration),resolved.set(declaration,associated===!0),associated===!0};for(const declaration of declarations)resolve(declaration);return resolved}function normalizeDeclaration(declaration,{ecosystem,formAssociated}){const attributeFieldNames=new Set((declaration.attributes??[]).flatMap(attribute=>[attribute.fieldName,attribute.name]).filter(Boolean)),publicFields=(declaration.members??[]).filter(member=>isPublicField(member,attributeFieldNames,ecosystem)),properties=normalizeProperties(publicFields),methods=normalizeMethods(declaration.members??[],ecosystem),staticProperties=normalizeStaticProperties(declaration.members??[],ecosystem),staticMethods=normalizeStaticMethods(declaration.members??[],ecosystem),events=normalizeEvents(declaration.events,ecosystem),formProperties=properties.filter(entry=>FORM_PROPERTIES.has(entry.name)).map(entry=>entry.name),formMethods=methods.filter(entry=>FORM_METHODS.has(entry.name)).map(entry=>entry.name),delegatedMethods=methods.filter(entry=>NATIVE_METHODS.has(entry.name)).map(entry=>entry.name),forwardedEvents=events.filter(entry=>NATIVE_EVENTS.has(entry.name)).map(entry=>entry.name),associated=formAssociated??declaredFormAssociation(declaration)===!0;return{attributes:normalizeAttributes(declaration,publicFields,ecosystem),properties,slots:normalizeNamed(declaration.slots),events,parts:normalizeNamed(declaration.cssParts),cssProperties:normalizeCssProperties(declaration.cssProperties,declaration.tagName),cssStates:normalizeNamed(declaration.cssStates),methods,staticProperties,staticMethods,moduleExports:[],form:{associated,properties:unique(formProperties),methods:unique(formMethods)},native:{forwardedEvents:unique(forwardedEvents),delegatedMethods:unique(delegatedMethods)},maturity:{status:declaration.status||"unclassified",since:declaration.since||null,deprecated:declaration.deprecated||null}}}function normalizeManifest(manifest,{ecosystem,tierByTag=new Map}){const components=[],formAssociations=manifestFormAssociations(manifest);for(const module of manifest.modules??[])for(const declaration of module.declarations??[]){if(!declaration.customElement||!declaration.tagName)continue;const normalized=normalizeDeclaration(declaration,{ecosystem,formAssociated:formAssociations.get(declaration)});normalized.moduleExports=normalizeComponentModuleExports(manifest,module.path,{ecosystem,additionalModules:REVIEWED_COMPONENT_MODULE_EXPORT_SCOPES.get(`${ecosystem}:${declaration.tagName}`)??[]}),components.push({tag:declaration.tagName,module:module.path||declaration.modulePath||declaration.definitionPath||null,tier:tierByTag.get(declaration.tagName)||null,maturity:normalized.maturity,surface:Object.fromEntries(SURFACE_SECTIONS.map(section=>[section,normalized[section]])),review:{status:"complete",source:"published-manifest",unreviewedSections:[]}})}return components.sort((a,b)=>a.tag.localeCompare(b.tag))}const UPSTREAM_RUNTIME_PACKAGES=Object.freeze({webawesome:"@awesome.me/webawesome",shoelace:"@shoelace-style/shoelace"});function runtimeEvidenceInvariant(condition,message){if(!condition)throw new Error(message)}function exactObjectKeys(value,expected){return value&&typeof value=="object"&&!Array.isArray(value)&&Object.keys(value).sort().join("\0")===[...expected].sort().join("\0")}function applyRuntimeEventCancelabilityEvidence(components,evidence,{ecosystem,version}={}){runtimeEvidenceInvariant(Array.isArray(components),"runtime cancelability evidence needs normalized components");const augmented=structuredClone(components);if(evidence==null)return augmented;runtimeEvidenceInvariant(exactObjectKeys(evidence,["source","coverage","events"]),`${String(ecosystem)}: malformed runtime cancelability evidence envelope`),runtimeEvidenceInvariant(exactObjectKeys(evidence.source,["package","version","tarballIntegrity"]),`${String(ecosystem)}: malformed runtime cancelability evidence source`);const expectedPackage=UPSTREAM_RUNTIME_PACKAGES[ecosystem];runtimeEvidenceInvariant(typeof expectedPackage=="string"&&evidence.source.package===expectedPackage,`${String(ecosystem)}: runtime evidence package ${String(evidence.source.package)} does not match ${String(expectedPackage)}`),runtimeEvidenceInvariant(evidence.source.version===version,`${String(ecosystem)}: runtime evidence version ${String(evidence.source.version)} does not match pin ${String(version)}`),runtimeEvidenceInvariant(typeof evidence.source.tarballIntegrity=="string"&&evidence.source.tarballIntegrity.startsWith("sha512-"),`${String(ecosystem)}: runtime evidence needs a SHA-512 package integrity`),runtimeEvidenceInvariant(evidence.coverage==="all-public-transition-paths",`${String(ecosystem)}: runtime cancelability evidence must cover all public transition paths`),runtimeEvidenceInvariant(Array.isArray(evidence.events)&&evidence.events.length>0,`${String(ecosystem)}: runtime cancelability evidence needs events`);const byTag=new Map(augmented.map(component=>[component.tag,component])),seen=new Set;for(const observation of evidence.events){runtimeEvidenceInvariant(exactObjectKeys(observation,["tag","event","cancelable","paths"]),`${String(observation?.tag)}#${String(observation?.event)}: malformed runtime cancelability evidence`);const key=`${observation.tag}#${observation.event}`;runtimeEvidenceInvariant(!seen.has(key),`duplicate runtime cancelability evidence ${key}`),seen.add(key),runtimeEvidenceInvariant(["always","never","conditional"].includes(observation.cancelable),`${key}: runtime cancelability evidence has an invalid result`),runtimeEvidenceInvariant(Array.isArray(observation.paths)&&observation.paths.length>0&&observation.paths.every(path2=>typeof path2=="string"&&!!path2.trim())&&new Set(observation.paths).size===observation.paths.length,`${key}: runtime cancelability evidence needs reviewed public paths`);const event=byTag.get(observation.tag)?.surface?.events?.find(entry=>entry.name===observation.event);runtimeEvidenceInvariant(event,`${key}: runtime cancelability evidence targets an unknown event`),runtimeEvidenceInvariant(event.cancelable===UNSPECIFIED_PUBLIC_DOCUMENTATION&&!event.cancelabilityEvidence,`${key}: pinned runtime evidence is stale because the manifest now documents cancelability`),event.cancelable=observation.cancelable,event.cancelabilityEvidence="pinned-runtime"}return augmented}const METHOD_EDGE_MEASUREMENT_BASES=new Set(["ambient-page-viewport"]),METHOD_EDGE_PARITY_EVIDENCE=Object.freeze({upstream:"pinned-package-black-box",target:"lyra-authored-contract-and-automated-tests"}),METHOD_EDGE_DIVERGENCE_FLAG="method-edge-return-sentinel-divergence";function validMethodEdgeOutcome(outcome){return!outcome||typeof outcome!="object"||Array.isArray(outcome)?!1:outcome.kind==="sentinel"?exactObjectKeys(outcome,["kind","value"])&&(outcome.value===null||typeof outcome.value=="string"||typeof outcome.value=="boolean"||typeof outcome.value=="number"&&Number.isFinite(outcome.value)):outcome.kind==="measurement"&&exactObjectKeys(outcome,["kind","basis"])&&METHOD_EDGE_MEASUREMENT_BASES.has(outcome.basis)}function applyRuntimeMethodEdgeSemanticsEvidence(components,evidence,{ecosystem,version}={}){runtimeEvidenceInvariant(Array.isArray(components),"runtime method-edge evidence needs normalized components");const augmented=structuredClone(components);if(evidence==null)return augmented;runtimeEvidenceInvariant(exactObjectKeys(evidence,["source","methods"]),`${String(ecosystem)}: malformed runtime method-edge evidence envelope`),runtimeEvidenceInvariant(exactObjectKeys(evidence.source,["package","version","tarballIntegrity"]),`${String(ecosystem)}: malformed runtime method-edge evidence source`);const expectedPackage=UPSTREAM_RUNTIME_PACKAGES[ecosystem];runtimeEvidenceInvariant(typeof expectedPackage=="string"&&evidence.source.package===expectedPackage,`${String(ecosystem)}: runtime method-edge evidence package ${String(evidence.source.package)} does not match ${String(expectedPackage)}`),runtimeEvidenceInvariant(evidence.source.version===version,`${String(ecosystem)}: runtime method-edge evidence version ${String(evidence.source.version)} does not match pin ${String(version)}`),runtimeEvidenceInvariant(typeof evidence.source.tarballIntegrity=="string"&&evidence.source.tarballIntegrity.startsWith("sha512-"),`${String(ecosystem)}: runtime method-edge evidence needs a SHA-512 package integrity`),runtimeEvidenceInvariant(Array.isArray(evidence.methods)&&evidence.methods.length>0,`${String(ecosystem)}: runtime method-edge evidence needs methods`);const byTag=new Map(augmented.map(component=>[component.tag,component])),seenMethods=new Set;for(const observation of evidence.methods){runtimeEvidenceInvariant(exactObjectKeys(observation,["tag","method","cases"]),`${String(observation?.tag)}#${String(observation?.method)}: malformed runtime method-edge evidence`);const key=`${observation.tag}#${observation.method}`;runtimeEvidenceInvariant(!seenMethods.has(key),`duplicate runtime method-edge evidence ${key}`),seenMethods.add(key);const method=byTag.get(observation.tag)?.surface?.methods?.find(entry=>entry.name===observation.method);runtimeEvidenceInvariant(method,`${key}: runtime method-edge evidence targets an unknown method`),runtimeEvidenceInvariant((method.overloads??[]).length>0&&(method.overloads??[]).every(overload=>overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)&&!method.edgeSemantics,`${key}: pinned method-edge evidence is stale because the manifest now documents its return`);const caseNames=new Set;runtimeEvidenceInvariant(Array.isArray(observation.cases)&&observation.cases.length>0&&observation.cases.every(entry=>!exactObjectKeys(entry,["case","arguments","outcome"])||typeof entry.case!="string"||!entry.case.trim()||caseNames.has(entry.case)||!Array.isArray(entry.arguments)||!entry.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())||!(method.overloads??[]).some(overload=>(overload.parameters??[]).length===entry.arguments.length)||!validMethodEdgeOutcome(entry.outcome)?!1:(caseNames.add(entry.case),!0)),`${key}: runtime method-edge evidence must cover unique named cases`),method.edgeSemantics={evidence:"pinned-runtime",cases:structuredClone(observation.cases)}}return augmented}function validateMethodEdgeParity(mapping,{upstream,target}={}){const findings=[],label=mapping?.upstreamTag??"<unknown>",methods=mapping?.parity?.methodEdges,observed=(upstream?.methods??[]).filter(method=>method.edgeSemantics),observedByName=new Map(observed.map(method=>[method.name,method])),behaviorFlags=mapping?.parity?.behaviorReviewFlags,hasDivergenceFlag=Array.isArray(behaviorFlags)&&behaviorFlags.includes(METHOD_EDGE_DIVERGENCE_FLAG);if(methods===void 0)return observed.length>0&&findings.push(`${label}: missing method-edge parity review`),hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings;if(!Array.isArray(methods)||methods.length===0)return findings.push(`${label}: parity.methodEdges must be a non-empty array`),hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings;const seenMethods=new Set;let hasDifferentCase=!1;for(const method of methods){if(!(exactObjectKeys(method,["method","evidence","cases","rationale"])&&typeof method.method=="string"&&!!method.method.trim()&&exactObjectKeys(method.evidence,["upstream","target"])&&method.evidence.upstream===METHOD_EDGE_PARITY_EVIDENCE.upstream&&method.evidence.target===METHOD_EDGE_PARITY_EVIDENCE.target&&Array.isArray(method.cases)&&method.cases.length>0&&typeof method.rationale=="string"&&!!method.rationale.trim())){findings.push(`${label}: malformed method-edge parity review`);continue}seenMethods.has(method.method)&&findings.push(`${label}: duplicate method-edge parity review ${method.method}`),seenMethods.add(method.method);const observedMethod=observedByName.get(method.method);upstream!==void 0&&!observedMethod&&findings.push(`${label}#${method.method}: stale method-edge parity review`),target!==void 0&&!(target.methods??[]).some(entry=>entry.name===method.method)&&findings.push(`${label}#${method.method}: dangling method-edge parity target`);const observedCases=new Map((observedMethod?.edgeSemantics?.cases??[]).map(entry=>[entry.case,entry])),seenCases=new Set;for(const edgeCase of method.cases){if(!(exactObjectKeys(edgeCase,["case","arguments","upstream","target","status"])&&typeof edgeCase.case=="string"&&!!edgeCase.case.trim()&&Array.isArray(edgeCase.arguments)&&edgeCase.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())&&validMethodEdgeOutcome(edgeCase.upstream)&&validMethodEdgeOutcome(edgeCase.target)&&(edgeCase.status==="equivalent"||edgeCase.status==="different"))){findings.push(`${label}#${method.method}: malformed method-edge parity case`);continue}seenCases.has(edgeCase.case)&&findings.push(`${label}#${method.method}: duplicate method-edge parity case ${edgeCase.case}`),seenCases.add(edgeCase.case);const expectedStatus=sameJson(edgeCase.upstream,edgeCase.target)?"equivalent":"different";if(edgeCase.status!==expectedStatus&&findings.push(`${label}#${method.method}:${edgeCase.case}: stale method-edge parity status`),expectedStatus==="different"&&(hasDifferentCase=!0),observedMethod){const observedCase=observedCases.get(edgeCase.case);(!observedCase||!sameJson(observedCase.arguments,edgeCase.arguments)||!sameJson(observedCase.outcome,edgeCase.upstream))&&findings.push(`${label}#${method.method}:${edgeCase.case}: stored upstream method-edge observation is stale`)}}if(observedMethod)for(const observedCase of observedMethod.edgeSemantics.cases??[])seenCases.has(observedCase.case)||findings.push(`${label}#${method.method}:${observedCase.case}: missing method-edge parity case`)}if(upstream!==void 0)for(const method of observed)seenMethods.has(method.name)||findings.push(`${label}#${method.name}: missing method-edge parity review`);return hasDifferentCase?(mapping.classification!=="warning-required"&&findings.push(`${label}: method-edge divergence requires warning-required classification`),hasDivergenceFlag||findings.push(`${label}: missing ${METHOD_EDGE_DIVERGENCE_FLAG} behavior flag`),methods.some(method=>typeof mapping.rationale!="string"||typeof method?.rationale!="string"||!mapping.rationale.includes(method.rationale))&&findings.push(`${label}: mapping rationale omits method-edge divergence`)):hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings}function mappedEventName(name,upstreamPrefix){return name.startsWith(upstreamPrefix)?`lr-${name.slice(upstreamPrefix.length)}`:name}function polarity(name){return/^(?:no|not|without|hide|disable)-/.test(name)?-1:/^(?:with|show|enable)-/.test(name)?1:0}function polarityStem(name){return name.replace(/^(?:no|not|without|hide|disable|with|show|enable)-/,"")}function pushMissing(drift,code,section,name){drift.push({code,section,member:name})}function normalizationKey(memberKind,member){return`${memberKind}:${member}`}function normalizedExpectedDefault(normalizations,memberKind,member,upstreamDefault){const rule=(normalizations.defaultEquivalences??[]).find(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamDefault);return rule?rule.target:upstreamDefault}function reviewedAttributeProperty(normalizations,attribute,upstreamProperty,targetProperty){return(normalizations.attributePropertyEquivalences??[]).some(entry=>entry.attribute===attribute&&entry.upstream===upstreamProperty&&entry.target===targetProperty)}function reviewedReflection(normalizations,memberKind,member,upstreamReflects,targetReflects){return(normalizations.reflectionEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamReflects&&entry.target===targetReflects)}function reviewedCssDefault(normalizations,member,upstreamEntry,targetEntry){return(normalizations.cssDefaultEquivalences??[]).some(entry=>entry.member===member&&entry.upstreamHasDefault===upstreamEntry.hasDefault&&(!entry.upstreamHasDefault||entry.upstream===upstreamEntry.default)&&entry.targetHasDefault===targetEntry.hasDefault&&(!entry.targetHasDefault||entry.target===targetEntry.default))}function deprecationReplacement(value){if(value&&typeof value=="object"){const replacement=value.replacement;if(!replacement||typeof replacement!="object")return null;const usage=typeof replacement.usage=="string"?replacement.usage.trim():"";return/^([a-z][a-z0-9-]*)\s*=\s*["'][^"']+["']$/iu.exec(usage)?.[1]===replacement.name?usage.replace(/\s+/gu,""):typeof replacement.name=="string"&&replacement.name?replacement.name:null}return typeof value!="string"?null:/\buse\s+(?:the\s+)?`([^`]+)`/iu.exec(value)?.[1]??/\buse\s+(?:the\s+)?(?!the\b)([a-z][a-z0-9-]*)\s+(?:part|property|attribute|slot|method)\b/iu.exec(value)?.[1]??null}function reviewedDeprecation(normalizations,section,member,upstreamDeprecated,upstreamReplacement,targetDeprecated,targetReplacement){return(normalizations.deprecationEquivalences??[]).some(entry=>entry.section===section&&entry.member===member&&entry.upstreamDeprecated===upstreamDeprecated&&entry.upstreamReplacement===upstreamReplacement&&entry.targetDeprecated===targetDeprecated&&entry.targetReplacement===targetReplacement)}function rewriteDeprecationReplacement(replacement,rewrites){if(replacement===null)return null;const assignment=/^([a-z][a-z0-9-]*)(=.*)$/iu.exec(replacement);return assignment?`${rewrites.get(assignment[1])||assignment[1]}${assignment[2]}`:rewrites.get(replacement)||replacement}function reviewedDerivedDefault(normalizations,memberKind,member,upstreamDefault,candidate){return candidate.hasDefault?!1:(normalizations.derivedDefaultEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamDefault)}function containsTypePositionKeyword(type,keyword){if(typeof type!="string")return!1;let quote=null;for(let index=0;index<type.length;){const character=type[index];if(quote){if(character==="\\"){index+=2;continue}character===quote&&(quote=null),index++;continue}if(character==="'"||character==='"'||character==="`"){quote=character,index++;continue}if(/[A-Za-z_$]/u.test(character)){let end=index+1;for(;end<type.length&&/[A-Za-z0-9_$]/u.test(type[end]);)end++;if(type.slice(index,end)===keyword){let next=end;for(;next<type.length&&/\s/u.test(type[next]);)next++;if(type[next]==="?")for(next++;next<type.length&&/\s/u.test(type[next]);)next++;if(type[next]!==":"&&type[next]!=="(")return!0}index=end;continue}index++}return!1}function containsAnyTypeKeyword(type){return containsTypePositionKeyword(type,"any")}function containsUnknownTypeKeyword(type){return containsTypePositionKeyword(type,"unknown")}function containsTemplateInterpolation(type){return typeof type=="string"&&type.includes("${")}function structuralTypeAliasMap(normalizations){return new Map((normalizations?.structuralTypeAliases??[]).filter(entry=>typeof entry?.name=="string"&&typeof entry.target=="string").map(entry=>[entry.name,entry.target]))}function typeContainsIdentifier(type,identifier){return typeof type!="string"?!1:new RegExp(`(^|[^A-Za-z0-9_$])${identifier.replace(/[.*+?^${}()|[\]\\]/gu,"\\$&")}([^A-Za-z0-9_$]|$)`,"u").test(type)}function expandStructuralTypeAliases(type,normalizations,resolving=new Set){if(typeof type!="string")return type;const aliases=structuralTypeAliasMap(normalizations);if(aliases.size===0)return type;let expanded="",quote=null;for(let index=0;index<type.length;){const character=type[index];if(quote){if(expanded+=character,character==="\\"&&index+1<type.length){expanded+=type[index+1],index+=2;continue}character===quote&&(quote=null),index+=1;continue}if(character==="'"||character==='"'||character==="`"){quote=character,expanded+=character,index+=1;continue}if(/[A-Za-z_$]/u.test(character)){let end=index+1;for(;end<type.length&&/[A-Za-z0-9_$]/u.test(type[end]);)end+=1;const identifier=type.slice(index,end),target=aliases.get(identifier);typeof target=="string"&&!resolving.has(identifier)?expanded+=expandStructuralTypeAliases(target,normalizations,new Set([...resolving,identifier])):expanded+=identifier,index=end;continue}expanded+=character,index+=1}return expanded}function reviewedTypeEquivalent(normalizations,memberKind,member,upstreamType,targetType){return containsAnyTypeKeyword(upstreamType)||containsAnyTypeKeyword(targetType)||memberKind==="event"&&(isUnknownEventType(upstreamType)||isUnknownEventType(targetType)||isBareCustomEventType(targetType))?!1:(normalizations.typeEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamType&&entry.target===targetType)}function reviewedMethodParameterTypeEquivalent(normalizations,method,parameter,upstreamType,targetType){return typeof upstreamType!="string"||typeof targetType!="string"||containsAnyTypeKeyword(upstreamType)||containsAnyTypeKeyword(targetType)||containsUnknownTypeKeyword(upstreamType)||containsUnknownTypeKeyword(targetType)||containsTemplateInterpolation(upstreamType)||containsTemplateInterpolation(targetType)?!1:(normalizations.methodParameterTypeEquivalences??[]).some(entry=>entry.method===method&&entry.parameter===parameter&&entry.upstream===upstreamType&&entry.target===targetType)}function reviewedCancelability(normalizations,event,upstreamCancelable,targetCancelable){const upstreamRank=CANCELABILITY_RANK.get(upstreamCancelable),targetRank=CANCELABILITY_RANK.get(targetCancelable);if(upstreamRank===void 0||targetRank===void 0)return!1;const matches=entry=>entry.event===event&&entry.upstream===upstreamCancelable&&entry.target===targetCancelable;return targetRank>upstreamRank?(normalizations.cancelabilityEquivalences??[]).some(matches):upstreamCancelable==="always"&&targetCancelable==="conditional"&&(normalizations.cancelabilityPathAdditions??[]).some(matches)}function insertionPreservesDefault(rewrites,memberKind,member,upstreamDefault){return(rewrites.defaults??[]).some(rule=>rule.action==="insert-if-absent"&&rule.memberKind===memberKind&&rule.member===member&&rule.value===upstreamDefault)}function mappedPublicType(type,upstreamPrefix){if(typeof type!="string")return type;const sourcePrefix=upstreamPrefix==="wa-"?"Wa":upstreamPrefix==="sl-"?"Sl":null;return sourcePrefix?type.replace(new RegExp(`\\b${sourcePrefix}([A-Z][A-Za-z0-9_$]*)\\b`,"gu"),"Lyra$1"):type}function hasPublishedType(type){return!!type&&type!=="unknown"&&type!==UNSPECIFIED_PUBLIC_DOCUMENTATION}function splitTopLevelUnion(type){const tokens=[];let start=0,depth=0,quote=null;for(let index=0;index<type.length;index+=1){const character=type[index];if(quote){character===quote&&type[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if("([{<".includes(character))depth+=1;else if([")","]","}",">"].includes(character))depth=Math.max(0,depth-1);else if(character==="|"&&depth===0){const token2=type.slice(start,index).trim();token2&&tokens.push(token2),start=index+1}}const token=type.slice(start).trim();return token&&tokens.push(token),tokens}function normalizedTypeTokens(type){return typeof type!="string"?[]:splitTopLevelUnion(type.replace(/^\s*\|\s*/u,"").replace(/\s+/gu," ").trim())}function literalPrimitive(token){return/^(?:'[^']*'|"[^"]*"|`[^`]*`)$/u.test(token)?"string":/^-?(?:\d+(?:\.\d*)?|\.\d+)$/u.test(token)?"number":token==="true"||token==="false"?"boolean":null}function publicTypeCompatible(expected,actual){if(containsAnyTypeKeyword(expected)||containsAnyTypeKeyword(actual))return!1;const expectedTokens=normalizedTypeTokens(expected),actualTokens=normalizedTypeTokens(actual);if(expectedTokens.length===actualTokens.length){const actualSet2=new Set(actualTokens);if(expectedTokens.every(token=>actualSet2.has(token)))return!0}const actualSet=new Set(actualTokens);return expectedTokens.every(token=>{if(actualSet.has(token))return!0;const primitive=literalPrimitive(token);return!!(primitive&&actualSet.has(primitive)||token==="array"&&actualTokens.some(candidate=>/(?:\[\]|Array<.+>)$/u.test(candidate)))})}function canonicalEventType(type){if(typeof type!="string")return;const trimmed=type.trim(),detail=/^CustomEvent\s*</u.test(trimmed)&&trimmed.endsWith(">")?trimmed.slice(trimmed.indexOf("<")+1,-1).trim():trimmed;let canonical="",quote=null,escaped=!1,curlyDepth=0,angleDepth=0,squareDepth=0,parenDepth=0;for(const character of detail){if(quote){canonical+=character,escaped?escaped=!1:character==="\\"?escaped=!0:character===quote&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character,canonical+=character;continue}/\s/u.test(character)||(character==="{"?curlyDepth+=1:character==="}"?curlyDepth=Math.max(0,curlyDepth-1):character==="<"?angleDepth+=1:character===">"?angleDepth=Math.max(0,angleDepth-1):character==="["?squareDepth+=1:character==="]"?squareDepth=Math.max(0,squareDepth-1):character==="("?parenDepth+=1:character===")"&&(parenDepth=Math.max(0,parenDepth-1)),character===","&&curlyDepth>0&&angleDepth===0&&squareDepth===0&&parenDepth===0?canonical+=";":canonical+=character)}return canonical.replace(/\bvoid\b/gu,"undefined").replace(/;\}/gu,"}")}function stripBalancedOuterParentheses(type){let text=type.trim();for(;text.startsWith("(")&&text.endsWith(")");){let depth=0,quote=null,closesAtEnd=!1;for(let index=0;index<text.length;index+=1){const character=text[index];if(quote){character===quote&&text[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if(character==="(")depth+=1;else if(character===")"&&(depth-=1,depth===0)){closesAtEnd=index===text.length-1;break}}if(!closesAtEnd)break;text=text.slice(1,-1).trim()}return text}function customEventDetailType(type){const text=type.trim(),opening=/^CustomEvent\s*</u.exec(text);if(!opening)return;const start=opening[0].lastIndexOf("<");let depth=0,quote=null;for(let index=start;index<text.length;index+=1){const character=text[index];if(quote){character===quote&&text[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if(character==="<")depth+=1;else if(character===">"&&(depth-=1,depth===0))return text.slice(index+1).trim()===""?text.slice(start+1,index).trim():void 0}}function hasTopLevelUnknown(type){return splitTopLevelUnion(stripBalancedOuterParentheses(type)).includes("unknown")}function isUnknownEventType(type){if(typeof type!="string")return!1;const trimmed=stripBalancedOuterParentheses(type);if(hasTopLevelUnknown(trimmed))return!0;const detail=customEventDetailType(trimmed);return detail!==void 0&&hasTopLevelUnknown(detail)}function isBareCustomEventType(type){return typeof type=="string"&&/^CustomEvent\s*$/u.test(type.trim())}function eventTypeCompatible(expected,actual,normalizations={}){if(actual=expandStructuralTypeAliases(actual,normalizations),!hasPublishedType(expected)||!hasPublishedType(actual)||containsAnyTypeKeyword(expected)||containsAnyTypeKeyword(actual)||isUnknownEventType(expected)||isUnknownEventType(actual)||isBareCustomEventType(actual))return!1;const expectedCustom=/^CustomEvent\s*</u.test(expected.trim()),actualCustom=/^CustomEvent\s*</u.test(actual.trim());return expectedCustom!==actualCustom&&eventConstructor(expectedCustom?actual:expected)!==void 0?!1:canonicalEventType(expected)===canonicalEventType(actual)}function parametersMatch(expected,actual,upstreamPrefix,method,normalizations){const expectedParameters=expected??[],actualParameters=actual??[];return actualParameters.length<expectedParameters.length||!expectedParameters.every((parameter,index)=>{const candidate=actualParameters[index];return!candidate||parameter.name!==candidate.name||parameter.type!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&mappedPublicType(parameter.type,upstreamPrefix)!==candidate.type&&!reviewedMethodParameterTypeEquivalent(normalizations,method,parameter.name,parameter.type,candidate.type)||(parameter.optional||parameter.hasDefault)&&!(candidate.optional||candidate.hasDefault)?!1:!parameter.hasDefault||candidate.hasDefault&&parameter.default===candidate.default})?!1:actualParameters.slice(expectedParameters.length).every(parameter=>parameter.optional||parameter.hasDefault)}function overloadMatches(method,expected,actual,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified=!1){return parametersMatch(expected.parameters,actual.parameters,upstreamPrefix,method,normalizations)&&(expected.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION||unknownReturnTypeIsUnspecified&&expected.returnType==="unknown"||mappedPublicType(expected.returnType,upstreamPrefix)===actual.returnType)}function methodOverloadsMatch(method,expected,actual,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified=!1){return(expected??[]).every(overload=>(actual??[]).some(candidate=>overloadMatches(method,overload,candidate,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified)))}function compareMappedSurfaces(upstream,target,{upstreamPrefix,rewrites={},normalizations={}}={}){const drift=[],attributeRewrites=new Map((rewrites.attributes??[]).map(entry=>[entry.from,entry.to])),propertyRewrites=new Map((rewrites.properties??[]).map(entry=>[entry.from,entry.to])),eventRewrites=new Map((rewrites.events??[]).map(entry=>[entry.from,entry.to])),methodRewrites=new Map((rewrites.methods??[]).map(entry=>[entry.from,entry.to])),sectionDeprecationRewrites=new Map([["attributes",attributeRewrites],["properties",propertyRewrites],["events",eventRewrites],["methods",methodRewrites],["staticProperties",new Map],["staticMethods",new Map],["moduleExports",new Map],...["slots","parts","cssProperties","cssStates"].map(section=>[section,new Map((rewrites[section]??[]).map(entry=>[entry.from,entry.to]))])]),unknownMethodReturnTypes=new Set((normalizations.unknownMethodReturnTypes??[]).map(entry=>entry.method)),inferredAttributeSuppressions=new Map((normalizations.inferredAttributeSuppressions??[]).map(entry=>[entry.attribute,entry])),suppressionRequiredProperties=new Set,excludedAttributeProperties=new Set((upstream.attributes??[]).filter(attribute=>Object.hasOwn(MIGRATION_ATTRIBUTE_EXCLUSIONS,attribute.name)).map(attribute=>attribute.property).filter(Boolean)),compareDeprecation=(section,upstreamMember,targetMember)=>{const upstreamDeprecated=!!upstreamMember.deprecated,targetDeprecated=!!targetMember.deprecated,upstreamReplacement=deprecationReplacement(upstreamMember.deprecated),targetReplacement=deprecationReplacement(targetMember.deprecated),expectedReplacement=rewriteDeprecationReplacement(upstreamReplacement,sectionDeprecationRewrites.get(section)??new Map);(upstreamDeprecated!==targetDeprecated||upstreamDeprecated&&targetDeprecated&&expectedReplacement!==targetReplacement)&&!reviewedDeprecation(normalizations,section,upstreamMember.name,upstreamDeprecated,upstreamReplacement,targetDeprecated,targetReplacement)&&drift.push({code:upstreamDeprecated===targetDeprecated?"deprecation-replacement-mismatch":"deprecation-mismatch",section,member:upstreamMember.name,expected:upstreamDeprecated?expectedReplacement??!0:!1,actual:targetDeprecated?targetReplacement??!0:!1})};for(const attribute of upstream.attributes??[]){if(Object.hasOwn(MIGRATION_ATTRIBUTE_EXCLUSIONS,attribute.name))continue;const suppression=inferredAttributeSuppressions.get(attribute.name),requiredProperty=suppression?.property;if(requiredProperty&&(attribute.inferred===!0||suppression.explicit===!0)){suppressionRequiredProperties.add(requiredProperty),(target.properties??[]).some(property=>property.name===requiredProperty)||pushMissing(drift,"missing-property","properties",requiredProperty);continue}const expectedName=attributeRewrites.get(attribute.name)||attribute.name,candidate=(target.attributes??[]).find(entry=>entry.name===expectedName);if(!candidate){const opposite=(target.attributes??[]).find(entry=>polarityStem(entry.name)===polarityStem(expectedName)&&polarity(entry.name)!==polarity(expectedName));opposite?drift.push({code:"polarity-mismatch",section:"attributes",member:attribute.name,expected:expectedName,actual:opposite.name}):pushMissing(drift,"missing-attribute","attributes",attribute.name);continue}const expectedType=mappedPublicType(attribute.type,upstreamPrefix);hasPublishedType(attribute.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"attribute",attribute.name,attribute.type,candidate.type)&&drift.push({code:"type-mismatch",section:"attributes",member:attribute.name,expected:expectedType,actual:candidate.type});const expectedProperty=propertyRewrites.get(attribute.property)||attribute.property;expectedProperty!==candidate.property&&!reviewedAttributeProperty(normalizations,attribute.name,attribute.property,candidate.property)&&drift.push({code:"attribute-property-mismatch",section:"attributes",member:attribute.name,expected:expectedProperty,actual:candidate.property}),attribute.reflects!==candidate.reflects&&!reviewedReflection(normalizations,"attribute",attribute.name,attribute.reflects,candidate.reflects)&&drift.push({code:"reflection-mismatch",section:"attributes",member:attribute.name,expected:attribute.reflects,actual:hasOwn(candidate,"reflects")?candidate.reflects:null});const expectedDefault=normalizedExpectedDefault(normalizations,"attribute",attribute.name,attribute.default);attribute.hasDefault&&(!candidate.hasDefault||candidate.default!==expectedDefault)&&!reviewedDerivedDefault(normalizations,"attribute",attribute.name,attribute.default,candidate)&&!insertionPreservesDefault(rewrites,"attribute",attribute.name,expectedDefault)&&drift.push({code:"default-mismatch",section:"attributes",member:attribute.name,expected:expectedDefault,actual:candidate.hasDefault?candidate.default:null}),compareDeprecation("attributes",attribute,candidate)}for(const property of upstream.properties??[]){if(excludedAttributeProperties.has(property.name))continue;const expectedName=propertyRewrites.get(property.name)||property.name,candidate=(target.properties??[]).find(entry=>entry.name===expectedName);if(!(!candidate&&suppressionRequiredProperties.has(expectedName))){if((upstream.attributes??[]).some(attribute=>attribute.property===property.name)){candidate?property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"readonly-mismatch",section:"properties",member:property.name,expected:property.readonly,actual:hasOwn(candidate,"readonly")?candidate.readonly:null}):pushMissing(drift,"missing-property","properties",property.name),candidate&&compareDeprecation("properties",property,candidate);continue}if(!candidate)pushMissing(drift,"missing-property","properties",property.name);else{const expectedType=mappedPublicType(property.type,upstreamPrefix);hasPublishedType(property.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"property",property.name,property.type,candidate.type)&&drift.push({code:"type-mismatch",section:"properties",member:property.name,expected:expectedType,actual:candidate.type}),property.reflects!==candidate.reflects&&!reviewedReflection(normalizations,"property",property.name,property.reflects,candidate.reflects)&&drift.push({code:"reflection-mismatch",section:"properties",member:property.name,expected:property.reflects,actual:hasOwn(candidate,"reflects")?candidate.reflects:null}),property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"readonly-mismatch",section:"properties",member:property.name,expected:property.readonly,actual:hasOwn(candidate,"readonly")?candidate.readonly:null});const expectedDefault=normalizedExpectedDefault(normalizations,"property",property.name,property.default);if(compareDeprecation("properties",property,candidate),!property.hasDefault||candidate.hasDefault&&candidate.default===expectedDefault||reviewedDerivedDefault(normalizations,"property",property.name,property.default,candidate)||insertionPreservesDefault(rewrites,"property",property.name,expectedDefault))continue;drift.push({code:"default-mismatch",section:"properties",member:property.name,expected:expectedDefault,actual:candidate.hasDefault?candidate.default:null})}}}for(const property of upstream.staticProperties??[]){const candidate=(target.staticProperties??[]).find(entry=>entry.name===property.name);if(!candidate){pushMissing(drift,"missing-static-property","staticProperties",property.name);continue}const expectedType=mappedPublicType(property.type,upstreamPrefix);hasPublishedType(property.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"staticProperty",property.name,property.type,candidate.type)&&drift.push({code:"static-property-type-mismatch",section:"staticProperties",member:property.name,expected:expectedType,actual:candidate.type}),property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"static-property-readonly-mismatch",section:"staticProperties",member:property.name,expected:!1,actual:hasOwn(candidate,"readonly")?candidate.readonly:null}),compareDeprecation("staticProperties",property,candidate)}for(const[section,code]of[["slots","missing-slot"],["parts","missing-part"],["cssProperties","missing-css-property"],["cssStates","missing-css-state"]]){const targetEntries=new Map((target[section]??[]).map(entry=>[entry.name,entry])),sectionRewrites=new Map((rewrites[section]??[]).map(entry=>[entry.from,entry.to]));for(const entry of upstream[section]??[]){const expectedName=sectionRewrites.get(entry.name)||entry.name,candidate=targetEntries.get(expectedName);if(!candidate){pushMissing(drift,code,section,entry.name);continue}section==="cssProperties"&&!(entry.hasDefault===candidate.hasDefault&&(!entry.hasDefault||entry.default===candidate.default))&&!reviewedCssDefault(normalizations,entry.name,entry,candidate)&&drift.push({code:"css-default-mismatch",section,member:entry.name,expectedHasDefault:entry.hasDefault,expected:entry.hasDefault?entry.default:null,actualHasDefault:candidate.hasDefault,actual:candidate.hasDefault?candidate.default:null}),compareDeprecation(section,entry,candidate)}}for(const method of upstream.methods??[]){const expectedName=methodRewrites.get(method.name)||method.name,candidate=(target.methods??[]).find(entry=>entry.name===expectedName);candidate?methodOverloadsMatch(method.name,method.overloads,candidate.overloads,upstreamPrefix,normalizations,unknownMethodReturnTypes.has(method.name))||drift.push({code:"method-signature-mismatch",section:"methods",member:method.name,expected:method.overloads,actual:candidate.overloads}):pushMissing(drift,"missing-method","methods",method.name),candidate&&compareDeprecation("methods",method,candidate)}for(const method of upstream.staticMethods??[]){const candidate=(target.staticMethods??[]).find(entry=>entry.name===method.name);candidate?methodOverloadsMatch(method.name,method.overloads,candidate.overloads,upstreamPrefix,normalizations)||drift.push({code:"static-method-signature-mismatch",section:"staticMethods",member:method.name,expected:method.overloads,actual:candidate.overloads}):pushMissing(drift,"missing-static-method","staticMethods",method.name),candidate&&compareDeprecation("staticMethods",method,candidate)}for(const exported of upstream.moduleExports??[]){const candidates=(target.moduleExports??[]).filter(entry=>entry.name===exported.name);if(candidates.length===0){drift.push({code:"missing-module-export",section:"moduleExports",member:exported.name,module:exported.module});continue}if(exported.kind==="unknown")continue;const sameKind=candidates.filter(entry=>entry.kind===exported.kind);if(sameKind.length===0){drift.push({code:"module-export-kind-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:exported.kind,actual:unique(candidates.map(entry=>entry.kind))});continue}exported.kind==="function"?sameKind.some(candidate=>methodOverloadsMatch(exported.name,exported.overloads,candidate.overloads,upstreamPrefix,normalizations))||drift.push({code:"module-export-signature-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:exported.overloads,actual:sameKind.map(candidate=>candidate.overloads)}):hasPublishedType(exported.type)&&!sameKind.some(candidate=>publicTypeCompatible(mappedPublicType(exported.type,upstreamPrefix),candidate.type)||reviewedTypeEquivalent(normalizations,"moduleExport",exported.name,exported.type,candidate.type))&&drift.push({code:"module-export-type-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:mappedPublicType(exported.type,upstreamPrefix),actual:unique(sameKind.map(candidate=>candidate.type))})}for(const event of upstream.events??[]){const expectedName=eventRewrites.get(event.name)||mappedEventName(event.name,upstreamPrefix),candidate=(target.events??[]).find(entry=>entry.name===expectedName);if(!candidate)pushMissing(drift,"missing-event","events",event.name);else{const expectedType=mappedPublicType(event.type,upstreamPrefix);hasPublishedType(event.type)&&!eventTypeCompatible(expectedType,candidate.type,normalizations)&&!reviewedTypeEquivalent(normalizations,"event",event.name,event.type,candidate.type)&&drift.push({code:"event-type-mismatch",section:"events",member:event.name,expected:expectedType,actual:candidate.type}),event.cancelable!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&candidate.cancelable!==event.cancelable&&!reviewedCancelability(normalizations,event.name,event.cancelable,candidate.cancelable)&&drift.push({code:"cancelability-mismatch",section:"events",member:event.name,expected:event.cancelable,actual:candidate.cancelable});for(const[field,code]of[["constructor","event-constructor-mismatch"],["bubbles","event-bubbles-mismatch"],["composed","event-composed-mismatch"]])!hasOwn(event,field)||candidate[field]===event[field]||drift.push({code,section:"events",member:event.name,expected:event[field],actual:hasOwn(candidate,field)?candidate[field]:null});compareDeprecation("events",event,candidate)}}upstream.form?.associated&&!target.form?.associated&&drift.push({code:"form-association-mismatch",section:"form",member:"associated"});for(const property of upstream.form?.properties??[])(target.form?.properties??[]).includes(property)||pushMissing(drift,"missing-form-property","form",property);for(const method of upstream.form?.methods??[])(target.form?.methods??[]).includes(method)||pushMissing(drift,"missing-form-method","form",method);for(const event of upstream.native?.forwardedEvents??[])(target.native?.forwardedEvents??[]).includes(event)||pushMissing(drift,"missing-native-event","native",event);for(const method of upstream.native?.delegatedMethods??[])(target.native?.delegatedMethods??[]).includes(method)||pushMissing(drift,"missing-native-method","native",method);return drift.sort((a,b)=>`${a.section}:${a.member}:${a.code}`.localeCompare(`${b.section}:${b.member}:${b.code}`))}function validateSurface(surface,label,findings){if(!surface||typeof surface!="object"){findings.push(`${label}: missing normalized surface`);return}for(const section of SURFACE_SECTIONS)section==="form"||section==="native"?(!surface[section]||typeof surface[section]!="object")&&findings.push(`${label}: missing ${section} contract`):Array.isArray(surface[section])||findings.push(`${label}: ${section} must be an array`);for(const event of surface.events??[])["always","never","conditional",UNSPECIFIED_PUBLIC_DOCUMENTATION].includes(event.cancelable)||findings.push(`${label}: event ${event.name} has unreviewed cancelability`),hasOwn(event,"cancelabilityEvidence")&&(event.cancelable!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&event.cancelabilityEvidence==="pinned-runtime"||findings.push(`${label}: event ${event.name} has malformed cancelability evidence`));for(const method of surface.methods??[]){if(!hasOwn(method,"edgeSemantics"))continue;const edgeSemantics=method.edgeSemantics,caseNames=new Set;exactObjectKeys(edgeSemantics,["evidence","cases"])&&edgeSemantics.evidence==="pinned-runtime"&&Array.isArray(edgeSemantics.cases)&&edgeSemantics.cases.length>0&&edgeSemantics.cases.every(entry=>!exactObjectKeys(entry,["case","arguments","outcome"])||typeof entry.case!="string"||!entry.case.trim()||caseNames.has(entry.case)||!Array.isArray(entry.arguments)||!entry.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())||!validMethodEdgeOutcome(entry.outcome)?!1:(caseNames.add(entry.case),!0))||findings.push(`${label}: method ${method.name} has malformed edge-semantics evidence`)}}function validateRewrites(mapping,findings){if(!mapping.rewrites||typeof mapping.rewrites!="object"){findings.push(`${mapping.upstreamTag}: missing deterministic rewrite contract`);return}for(const section of REWRITE_RULE_SECTIONS)Array.isArray(mapping.rewrites[section])||findings.push(`${mapping.upstreamTag}: rewrites.${section} must be an array`);for(const section of Object.keys(mapping.rewrites))REWRITE_RULE_SECTIONS.includes(section)||findings.push(`${mapping.upstreamTag}: unknown rewrite section ${section}`);for(const section of REWRITE_RULE_SECTIONS.filter(name=>name!=="defaults")){const seen=new Set;for(const rule of mapping.rewrites[section]??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!rule||typeof rule.from!="string"||!rule.from||typeof rule.to!="string"||!rule.to||keys.some(key=>key!=="from"&&key!=="to")){findings.push(`${mapping.upstreamTag}: invalid rewrites.${section} rule`);continue}rule.from===rule.to&&findings.push(`${mapping.upstreamTag}: identity rewrites.${section} rule`),seen.has(rule.from)&&findings.push(`${mapping.upstreamTag}: duplicate rewrites.${section} source ${rule.from}`),seen.add(rule.from)}}const seenDefaults=new Set;for(const rule of mapping.rewrites.defaults??[]){const action=rule?.action,allowedKeys=action==="insert-if-absent"?new Set(["memberKind","member","action","value"]):action==="replace-value"?new Set(["memberKind","member","action","from","to"]):new Set,keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&allowedKeys.size>0&&keys.every(key2=>allowedKeys.has(key2))&&(action==="insert-if-absent"?rule.memberKind==="attribute"&&Object.hasOwn(rule,"value")&&(rule.value===null||["string","boolean"].includes(typeof rule.value)||typeof rule.value=="number"&&Number.isFinite(rule.value)):Object.hasOwn(rule,"from")&&Object.hasOwn(rule,"to")&&rule.from!==rule.to&&[rule.from,rule.to].every(value=>value===null||["string","boolean"].includes(typeof value)||typeof value=="number"&&Number.isFinite(value))))){findings.push(`${mapping.upstreamTag}: invalid rewrites.defaults rule`);continue}const key=`${rule.memberKind}:${rule.member}:${action}`;seenDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate rewrites.defaults rule ${key}`),seenDefaults.add(key)}}function validateDefaultRewriteSemantics(mapping,{upstream,target}={}){const findings=[];for(const rule of mapping.rewrites?.defaults??[]){if(rule?.action!=="insert-if-absent")continue;const section=rule.memberKind==="attribute"?"attributes":"properties",sourceMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);sourceMember?(!sourceMember.hasDefault||sourceMember.default!==rule.value)&&findings.push(`${mapping.upstreamTag}: stale upstream default rewrite ${rule.memberKind}:${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling upstream default rewrite ${rule.memberKind}:${rule.member}`),targetMember?targetMember.hasDefault&&targetMember.default===rule.value&&findings.push(`${mapping.upstreamTag}: stale target default rewrite ${rule.memberKind}:${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling target default rewrite ${rule.memberKind}:${rule.member}`)}return findings}function isReviewedScalar(value){return value===null||typeof value=="string"||typeof value=="boolean"||typeof value=="number"&&Number.isFinite(value)}function validateMappingNormalizations(mapping,{upstream,target}={}){const findings=[],normalizations=mapping.normalizations;if(normalizations===void 0)return findings;if(!normalizations||typeof normalizations!="object"||Array.isArray(normalizations))return[`${mapping.upstreamTag}: normalizations must be an object`];for(const section of NORMALIZATION_SECTIONS)Array.isArray(normalizations[section])||findings.push(`${mapping.upstreamTag}: normalizations.${section} must be an array`);for(const section of Object.keys(normalizations))NORMALIZATION_SECTIONS.includes(section)||findings.push(`${mapping.upstreamTag}: unknown normalization section ${section}`);const attributeRewrites=new Map((mapping.rewrites?.attributes??[]).map(entry=>[entry.from,entry.to])),propertyRewrites=new Map((mapping.rewrites?.properties??[]).map(entry=>[entry.from,entry.to])),seenAttributeProperties=new Set;for(const rule of normalizations.attributePropertyEquivalences??[]){if(!(typeof rule?.attribute=="string"&&!!rule.attribute&&typeof rule.upstream=="string"&&!!rule.upstream&&typeof rule.target=="string"&&!!rule.target&&Object.keys(rule).length===3)){findings.push(`${mapping.upstreamTag}: invalid normalizations.attributePropertyEquivalences rule`);continue}seenAttributeProperties.has(rule.attribute)&&findings.push(`${mapping.upstreamTag}: duplicate attribute-property normalization ${rule.attribute}`),seenAttributeProperties.add(rule.attribute);const source=(upstream?.attributes??[]).find(entry=>entry.name===rule.attribute),targetName=attributeRewrites.get(rule.attribute)||rule.attribute,candidate=(target?.attributes??[]).find(entry=>entry.name===targetName);source?source.property!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream attribute-property normalization ${rule.attribute}`):findings.push(`${mapping.upstreamTag}: dangling upstream attribute-property normalization ${rule.attribute}`),candidate?candidate.property!==rule.target?findings.push(`${mapping.upstreamTag}: stale target attribute-property normalization ${rule.attribute}`):(propertyRewrites.get(rule.upstream)||rule.upstream)===rule.target&&findings.push(`${mapping.upstreamTag}: stale equivalent attribute-property normalization ${rule.attribute}`):findings.push(`${mapping.upstreamTag}: dangling target attribute-property normalization ${rule.attribute}`)}const seenReflections=new Set;for(const rule of normalizations.reflectionEquivalences??[]){if(!(["attribute","property"].includes(rule?.memberKind)&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstream=="boolean"&&typeof rule.target=="boolean"&&rule.upstream!==rule.target&&Object.keys(rule).length===4)){findings.push(`${mapping.upstreamTag}: invalid normalizations.reflectionEquivalences rule`);continue}const key=`${rule.memberKind}:${rule.member}`;seenReflections.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate reflection normalization ${key}`),seenReflections.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",rewrites=rule.memberKind==="attribute"?attributeRewrites:propertyRewrites,source=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),candidate=(target?.[section]??[]).find(entry=>entry.name===(rewrites.get(rule.member)||rule.member));source?source.reflects!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream reflection normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream reflection normalization ${key}`),candidate?candidate.reflects!==rule.target&&findings.push(`${mapping.upstreamTag}: stale target reflection normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target reflection normalization ${key}`)}const seenCssDefaults=new Set;for(const rule of normalizations.cssDefaultEquivalences??[]){const expectedKeys=new Set(["member","upstreamHasDefault","targetHasDefault"]);rule?.upstreamHasDefault===!0&&expectedKeys.add("upstream"),rule?.targetHasDefault===!0&&expectedKeys.add("target");const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.member=="string"&&!!rule.member&&typeof rule.upstreamHasDefault=="boolean"&&typeof rule.targetHasDefault=="boolean"&&(rule.upstreamHasDefault!==!0||isReviewedScalar(rule.upstream))&&(rule.targetHasDefault!==!0||isReviewedScalar(rule.target))&&keys.length===expectedKeys.size&&keys.every(key=>expectedKeys.has(key))&&(rule.upstreamHasDefault!==rule.targetHasDefault||rule.upstreamHasDefault&&rule.upstream!==rule.target))){findings.push(`${mapping.upstreamTag}: invalid normalizations.cssDefaultEquivalences rule`);continue}seenCssDefaults.has(rule.member)&&findings.push(`${mapping.upstreamTag}: duplicate CSS-default normalization ${rule.member}`),seenCssDefaults.add(rule.member);const source=(upstream?.cssProperties??[]).find(entry=>entry.name===rule.member),targetName=new Map((mapping.rewrites?.cssProperties??[]).map(entry=>[entry.from,entry.to])).get(rule.member)||rule.member,candidate=(target?.cssProperties??[]).find(entry=>entry.name===targetName);source?(source.hasDefault!==rule.upstreamHasDefault||rule.upstreamHasDefault&&source.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream CSS-default normalization ${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling upstream CSS-default normalization ${rule.member}`),candidate?(candidate.hasDefault!==rule.targetHasDefault||rule.targetHasDefault&&candidate.default!==rule.target)&&findings.push(`${mapping.upstreamTag}: stale target CSS-default normalization ${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling target CSS-default normalization ${rule.member}`)}const seenDeprecations=new Set;for(const rule of normalizations.deprecationEquivalences??[]){if(!(["attributes","properties","slots","events","parts","cssProperties","cssStates","methods","staticProperties","staticMethods","moduleExports"].includes(rule?.section)&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstreamDeprecated=="boolean"&&(rule.upstreamReplacement===null||typeof rule.upstreamReplacement=="string")&&typeof rule.targetDeprecated=="boolean"&&(rule.targetReplacement===null||typeof rule.targetReplacement=="string")&&Object.keys(rule).length===6)){findings.push(`${mapping.upstreamTag}: invalid normalizations.deprecationEquivalences rule`);continue}const key=`${rule.section}:${rule.member}`;seenDeprecations.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate deprecation normalization ${key}`),seenDeprecations.add(key);const sectionRewrites=new Map((mapping.rewrites?.[rule.section]??[]).map(entry=>[entry.from,entry.to])),targetName=sectionRewrites.get(rule.member)||rule.member,source=(upstream?.[rule.section]??[]).find(entry=>entry.name===rule.member),candidate=(target?.[rule.section]??[]).find(entry=>entry.name===targetName);if(!source){findings.push(`${mapping.upstreamTag}: dangling upstream deprecation normalization ${key}`);continue}if(!candidate){findings.push(`${mapping.upstreamTag}: dangling target deprecation normalization ${key}`);continue}const sourceDeprecated=!!source.deprecated,sourceReplacement=deprecationReplacement(source.deprecated),targetDeprecated=!!candidate.deprecated,targetReplacement=deprecationReplacement(candidate.deprecated);(sourceDeprecated!==rule.upstreamDeprecated||sourceReplacement!==rule.upstreamReplacement)&&findings.push(`${mapping.upstreamTag}: stale upstream deprecation normalization ${key}`),(targetDeprecated!==rule.targetDeprecated||targetReplacement!==rule.targetReplacement)&&findings.push(`${mapping.upstreamTag}: stale target deprecation normalization ${key}`);const expectedReplacement=rewriteDeprecationReplacement(sourceReplacement,sectionRewrites);sourceDeprecated===targetDeprecated&&expectedReplacement===targetReplacement&&findings.push(`${mapping.upstreamTag}: stale equivalent deprecation normalization ${key}`)}const seenStructuralAliases=new Set,structuralAliasRules=new Map;for(const rule of normalizations.structuralTypeAliases??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.name=="string"&&/^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(rule.name)&&typeof rule.target=="string"&&!!rule.target.trim()&&!containsAnyTypeKeyword(rule.target)&&!containsUnknownTypeKeyword(rule.target)&&!containsTemplateInterpolation(rule.target)&&keys.length===2&&keys.every(key=>key==="name"||key==="target"))){findings.push(`${mapping.upstreamTag}: invalid normalizations.structuralTypeAliases rule`);continue}seenStructuralAliases.has(rule.name)&&findings.push(`${mapping.upstreamTag}: duplicate structural type alias ${rule.name}`),seenStructuralAliases.add(rule.name),structuralAliasRules.set(rule.name,rule.target)}const reachableStructuralAliases=new Set,visitStructuralAlias=(name,trail=new Set)=>{if(trail.has(name)){findings.push(`${mapping.upstreamTag}: cyclic structural type alias ${name}`);return}if(reachableStructuralAliases.has(name))return;const targetType=structuralAliasRules.get(name);if(targetType===void 0)return;reachableStructuralAliases.add(name);const nextTrail=new Set([...trail,name]);for(const candidate of structuralAliasRules.keys())typeContainsIdentifier(targetType,candidate)&&visitStructuralAlias(candidate,nextTrail)};for(const event of target?.events??[])for(const name of structuralAliasRules.keys())typeContainsIdentifier(event.type,name)&&visitStructuralAlias(name);for(const name of structuralAliasRules.keys())reachableStructuralAliases.has(name)||findings.push(`${mapping.upstreamTag}: stale structural type alias ${name}`);const seenTypes=new Set;for(const rule of normalizations.typeEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property"||rule?.memberKind==="event"||rule?.memberKind==="staticProperty"||rule?.memberKind==="moduleExport")&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstream=="string"&&!!rule.upstream&&typeof rule.target=="string"&&!!rule.target&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.typeEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);(containsAnyTypeKeyword(rule.upstream)||containsAnyTypeKeyword(rule.target)||rule.memberKind==="event"&&isBareCustomEventType(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe any type normalization ${key}`),rule.memberKind==="event"&&(isUnknownEventType(rule.upstream)||isUnknownEventType(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe unknown event type normalization ${key}`),seenTypes.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.typeEquivalences rule ${key}`),seenTypes.add(key);const section=rule.memberKind==="attribute"?"attributes":rule.memberKind==="property"?"properties":rule.memberKind==="event"?"events":rule.memberKind==="staticProperty"?"staticProperties":"moduleExports",rewrites=new Map((mapping.rewrites?.[section]??[]).map(entry=>[entry.from,entry.to])),upstreamPrefix=mapping.upstreamTag?.startsWith("wa-")?"wa-":"sl-",targetName=rewrites.get(rule.member)||(rule.memberKind==="event"?mappedEventName(rule.member,upstreamPrefix):rule.member),upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===targetName);rule.memberKind==="property"&&(upstream?.attributes??[]).some(attribute=>attribute.property===rule.member)&&findings.push(`${mapping.upstreamTag}: unreachable property type normalization ${key}`),upstreamMember?(!hasPublishedType(upstreamMember.type)||upstreamMember.type!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream type normalization ${key}`),targetMember?targetMember.type!==rule.target?findings.push(`${mapping.upstreamTag}: stale target type normalization ${key}`):upstreamMember&&hasPublishedType(upstreamMember.type)&&(rule.memberKind==="event"?eventTypeCompatible(mappedPublicType(upstreamMember.type,upstreamPrefix),targetMember.type,normalizations):publicTypeCompatible(mappedPublicType(upstreamMember.type,upstreamPrefix),targetMember.type))&&findings.push(`${mapping.upstreamTag}: stale compatible type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target type normalization ${key}`)}const methodRewrites=new Map((mapping.rewrites?.methods??[]).map(entry=>[entry.from,entry.to])),seenMethodParameters=new Set;for(const rule of normalizations.methodParameterTypeEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.method=="string"&&!!rule.method.trim()&&typeof rule.parameter=="string"&&!!rule.parameter.trim()&&typeof rule.upstream=="string"&&!!rule.upstream.trim()&&rule.upstream!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&typeof rule.target=="string"&&!!rule.target.trim()&&rule.target!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["method","parameter","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.methodParameterTypeEquivalences rule`);continue}const key=`${rule.method}:${rule.parameter}`;seenMethodParameters.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.methodParameterTypeEquivalences rule ${key}`),seenMethodParameters.add(key),(containsAnyTypeKeyword(rule.upstream)||containsAnyTypeKeyword(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe any method-parameter type normalization ${key}`),(containsUnknownTypeKeyword(rule.upstream)||containsUnknownTypeKeyword(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe unknown method-parameter type normalization ${key}`),(containsTemplateInterpolation(rule.upstream)||containsTemplateInterpolation(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe template interpolation method-parameter type normalization ${key}`);const upstreamMethod=(upstream?.methods??[]).find(entry=>entry.name===rule.method),targetMethodName=methodRewrites.get(rule.method)||rule.method,targetMethod=(target?.methods??[]).find(entry=>entry.name===targetMethodName),upstreamParameters=(upstreamMethod?.overloads??[]).flatMap(overload=>overload.parameters??[]),targetParameters=(targetMethod?.overloads??[]).flatMap(overload=>overload.parameters??[]),upstreamParameter=upstreamParameters.find(entry=>entry.name===rule.parameter),targetParameter=targetParameters.find(entry=>entry.name===rule.parameter);upstreamMethod?upstreamParameter?upstreamParameter.type!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream method-parameter type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream method parameter normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream method-parameter type normalization ${key}`),targetMethod?targetParameter?targetParameter.type!==rule.target?findings.push(`${mapping.upstreamTag}: stale target method-parameter type normalization ${key}`):mappedPublicType(rule.upstream,mapping.upstreamTag?.startsWith("wa-")?"wa-":"sl-")===targetParameter.type&&findings.push(`${mapping.upstreamTag}: stale compatible method-parameter type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target method parameter normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target method-parameter type normalization ${key}`)}const seenDefaults=new Set;for(const rule of normalizations.defaultEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&Object.hasOwn(rule,"upstream")&&Object.hasOwn(rule,"target")&&isReviewedScalar(rule.upstream)&&isReviewedScalar(rule.target)&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.defaultEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);seenDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.defaultEquivalences rule ${key}`),seenDefaults.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);upstreamMember?(!upstreamMember.hasDefault||upstreamMember.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream default normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream normalization member ${key}`),targetMember?(!targetMember.hasDefault||targetMember.default!==rule.target)&&findings.push(`${mapping.upstreamTag}: stale target default normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target normalization member ${key}`)}const seenAttributes=new Set,seenProperties=new Set;for(const rule of normalizations.inferredAttributeSuppressions??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.attribute=="string"&&!!rule.attribute&&typeof rule.property=="string"&&!!rule.property&&(rule.explicit===void 0||rule.explicit===!0)&&keys.every(key=>key==="attribute"||key==="property"||key==="explicit"))){findings.push(`${mapping.upstreamTag}: invalid normalizations.inferredAttributeSuppressions rule`);continue}(seenAttributes.has(rule.attribute)||seenProperties.has(rule.property))&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.inferredAttributeSuppressions rule ${rule.attribute}:${rule.property}`),seenAttributes.add(rule.attribute),seenProperties.add(rule.property);const upstreamAttribute=(upstream?.attributes??[]).find(entry=>entry.name===rule.attribute),upstreamProperty=(upstream?.properties??[]).find(entry=>entry.name===rule.property),targetAttribute=(target?.attributes??[]).find(entry=>entry.name===rule.attribute),targetProperty=(target?.properties??[]).find(entry=>entry.name===rule.property);upstreamAttribute?(upstreamAttribute.inferred!==!0&&rule.explicit!==!0&&findings.push(`${mapping.upstreamTag}: cannot suppress explicit upstream attribute ${rule.attribute}`),upstreamAttribute.inferred===!0&&rule.explicit===!0&&findings.push(`${mapping.upstreamTag}: stale explicit attribute suppression ${rule.attribute}`),upstreamAttribute.property!==rule.property&&findings.push(`${mapping.upstreamTag}: stale inferred attribute property ${rule.attribute}:${rule.property}`)):findings.push(`${mapping.upstreamTag}: dangling inferred upstream attribute ${rule.attribute}`),upstreamProperty||findings.push(`${mapping.upstreamTag}: dangling inferred upstream property ${rule.property}`),targetProperty||findings.push(`${mapping.upstreamTag}: dangling inferred target property ${rule.property}`),targetAttribute&&findings.push(`${mapping.upstreamTag}: stale inferred attribute suppression ${rule.attribute}`)}const seenDerivedDefaults=new Set;for(const rule of normalizations.derivedDefaultEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&Object.hasOwn(rule,"upstream")&&Object.hasOwn(rule,"target")&&isReviewedScalar(rule.upstream)&&isReviewedScalar(rule.target)&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.derivedDefaultEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);seenDerivedDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.derivedDefaultEquivalences rule ${key}`),seenDerivedDefaults.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);upstreamMember?(!upstreamMember.hasDefault||upstreamMember.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale derived upstream default ${key}`):findings.push(`${mapping.upstreamTag}: dangling derived-default upstream member ${key}`),targetMember?targetMember.hasDefault&&findings.push(`${mapping.upstreamTag}: stale derived target default ${key}`):findings.push(`${mapping.upstreamTag}: dangling derived-default target member ${key}`)}const seenMethods=new Set;for(const rule of normalizations.unknownMethodReturnTypes??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.method=="string"&&!!rule.method&&keys.length===1&&keys[0]==="method")){findings.push(`${mapping.upstreamTag}: invalid normalizations.unknownMethodReturnTypes rule`);continue}seenMethods.has(rule.method)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.unknownMethodReturnTypes rule ${rule.method}`),seenMethods.add(rule.method);const upstreamMethod=(upstream?.methods??[]).find(entry=>entry.name===rule.method),targetMethod=(target?.methods??[]).find(entry=>entry.name===rule.method);upstreamMethod?(upstreamMethod.overloads??[]).some(overload=>overload.returnType==="unknown"||overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)||findings.push(`${mapping.upstreamTag}: stale unknown-return normalization ${rule.method}`):findings.push(`${mapping.upstreamTag}: dangling unknown-return upstream method ${rule.method}`),targetMethod?(targetMethod.overloads??[]).every(overload=>overload.returnType==="unknown"||overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)&&findings.push(`${mapping.upstreamTag}: stale concrete target return normalization ${rule.method}`):findings.push(`${mapping.upstreamTag}: dangling unknown-return target method ${rule.method}`)}const seenCancelabilities=new Set,cancelabilityPrefix=mapping.upstreamTag?.startsWith("sl-")?"sl-":"wa-",cancelabilityEventRewrites=new Map((mapping.rewrites?.events??[]).map(entry=>[entry.from,entry.to]));for(const[section,allowedKeys]of[["cancelabilityEquivalences",["event","upstream","target"]],["cancelabilityPathAdditions",["event","upstream","target","addedPath"]]])for(const rule of normalizations[section]??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.event=="string"&&!!rule.event&&CANCELABILITY_RANK.has(rule.upstream)&&CANCELABILITY_RANK.has(rule.target)&&keys.length===allowedKeys.length&&keys.every(key=>allowedKeys.includes(key))&&(section==="cancelabilityEquivalences"?CANCELABILITY_RANK.get(rule.target)>CANCELABILITY_RANK.get(rule.upstream):rule.upstream==="always"&&rule.target==="conditional"&&typeof rule.addedPath=="string"&&!!rule.addedPath))){findings.push(`${mapping.upstreamTag}: invalid normalizations.${section} rule`);continue}seenCancelabilities.has(rule.event)&&findings.push(`${mapping.upstreamTag}: duplicate cancelability normalization ${rule.event}`),seenCancelabilities.add(rule.event);const upstreamEvent=(upstream?.events??[]).find(entry=>entry.name===rule.event),targetName=cancelabilityEventRewrites.get(rule.event)||mappedEventName(rule.event,cancelabilityPrefix),targetEvent=(target?.events??[]).find(entry=>entry.name===targetName);upstreamEvent?upstreamEvent.cancelable!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream cancelability normalization ${rule.event}`):findings.push(`${mapping.upstreamTag}: dangling upstream cancelability normalization ${rule.event}`),targetEvent?targetEvent.cancelable!==rule.target&&findings.push(`${mapping.upstreamTag}: stale target cancelability normalization ${rule.event}`):findings.push(`${mapping.upstreamTag}: dangling target cancelability normalization ${rule.event}`)}return findings.sort()}function manifestDeclarations(manifest){return(manifest.modules??[]).flatMap(module=>(module.declarations??[]).filter(declaration=>declaration.customElement&&declaration.tagName).map(declaration=>({module,declaration}))).sort((a,b)=>a.declaration.tagName.localeCompare(b.declaration.tagName))}function sameJson(left,right){return JSON.stringify(left)===JSON.stringify(right)}function validateLocalMigrations(inventory){const findings=[];if(!Array.isArray(inventory?.localMigrations))return["localMigrations must be an array"];const allowedOrigins=new Set(LOCAL_MIGRATION_ORIGINS),components=new Map((inventory.components??[]).map(component=>[component.tag,component])),seenProfiles=new Set;for(const profile of inventory.localMigrations){if(!profile||typeof profile!="object"||Array.isArray(profile)){findings.push("localMigrations entries must be objects");continue}const unknownProfileKeys=Object.keys(profile).filter(key2=>key2!=="origin"&&key2!=="tag"&&key2!=="defaults");unknownProfileKeys.length&&findings.push(`local migration has unknown key(s) ${unknownProfileKeys.join(", ")}`),allowedOrigins.has(profile.origin)||findings.push(`local migration has unknown origin ${String(profile.origin)}`),(typeof profile.tag!="string"||!profile.tag.startsWith("lr-"))&&findings.push(`local migration needs a valid lr-* tag, got ${String(profile.tag)}`);const key=`${String(profile.origin)}:${String(profile.tag)}`;seenProfiles.has(key)&&findings.push(`duplicate local migration ${key}`),seenProfiles.add(key);const component=components.get(profile.tag);if(component||findings.push(`${key}: target tag is not registered`),!Array.isArray(profile.defaults)||profile.defaults.length===0){findings.push(`${key}: defaults must be a non-empty array`);continue}const attributes=new Map((component?.surface?.attributes??[]).map(attribute=>[attribute.name,attribute])),seenDefaults=new Set;for(const rule of profile.defaults){if(!rule||typeof rule!="object"||Array.isArray(rule)){findings.push(`${key}: default rules must be objects`);continue}const unknownRuleKeys=Object.keys(rule).filter(name=>!["memberKind","member","action","value"].includes(name));if(unknownRuleKeys.length&&findings.push(`${key}: default rule has unknown key(s) ${unknownRuleKeys.join(", ")}`),rule.memberKind!=="attribute"&&findings.push(`${key}: local defaults support only attribute members`),rule.action!=="insert-if-absent"&&findings.push(`${key}: local defaults support only insert-if-absent`),typeof rule.member!="string"||!rule.member){findings.push(`${key}: default rule needs a member`);continue}seenDefaults.has(rule.member)&&findings.push(`${key}: duplicate default member ${rule.member}`),seenDefaults.add(rule.member);const attribute=attributes.get(rule.member);attribute||findings.push(`${key}: unknown target attribute ${rule.member}`),Object.hasOwn(rule,"value")?typeof rule.value!="string"&&typeof rule.value!="boolean"&&!(typeof rule.value=="number"&&Number.isFinite(rule.value))?findings.push(`${key}: ${rule.member} value must be a finite string, number, or boolean`):rule.value===!1?findings.push(`${key}: false boolean insertion requires explicit converter evidence`):rule.value===!0&&!String(attribute?.type).includes("boolean")&&findings.push(`${key}: true presence insertion requires a boolean target attribute ${rule.member}`):findings.push(`${key}: ${rule.member} needs a value`)}}return findings}function validateInventory(inventory,{upstreamTags,lyraManifest,strict=!1}={}){const findings=[];if(inventory.schemaVersion!==INVENTORY_SCHEMA_VERSION&&findings.push(`schemaVersion must be ${INVENTORY_SCHEMA_VERSION}`),Array.isArray(inventory.components)||findings.push("components must be an array"),Array.isArray(inventory.mappings)||findings.push("mappings must be an array"),findings.length)return findings;const lyraByTag=new Map(inventory.components.map(component=>[component.tag,component]));validateAccessibilityProfiles(inventory.accessibilityProfiles,findings),findings.push(...validateLocalMigrations(inventory)),lyraByTag.size!==inventory.components.length&&findings.push("components contain duplicate Lyra tags");const expectedLyra=manifestDeclarations(lyraManifest),normalizedLyraByTag=new Map(normalizeManifest(lyraManifest,{ecosystem:"lyra"}).map(component=>[component.tag,component])),expectedLyraTags=expectedLyra.map(({declaration})=>declaration.tagName),actualLyraTags=[...lyraByTag.keys()].sort();sameJson(actualLyraTags,expectedLyraTags)||findings.push("Lyra tag inventory drifted from custom-elements.json");for(const{declaration}of expectedLyra){const component=lyraByTag.get(declaration.tagName);if(!component)continue;validateSurface(component.surface,component.tag,findings);const expectedSurface=normalizedLyraByTag.get(declaration.tagName)?.surface;sameJson(component.surface,expectedSurface)||findings.push(`${component.tag}: normalized public surface drifted`),(!component.family||!component.classModule||!component.registrationModule)&&findings.push(`${component.tag}: incomplete registration metadata`),(!Array.isArray(component.optionalPeers)||!Array.isArray(component.counterparts))&&findings.push(`${component.tag}: peers/counterparts must be arrays`),component.maturity?.status||findings.push(`${component.tag}: missing maturity classification`),strict&&component.maturity.status==="unclassified"&&findings.push(`${component.tag}: maturity remains unclassified`)}const catalogs={webawesome:[...upstreamTags.webawesome.free,...upstreamTags.webawesome.pro].sort(),shoelace:[...upstreamTags.shoelace.tags].sort()},upstreamByTag=new Map;for(const ecosystem of["webawesome","shoelace"]){const upstream=inventory.upstreams?.[ecosystem];if(!upstream){findings.push(`missing ${ecosystem} inventory`);continue}const expectedPin=upstreamTags[ecosystem];(upstream.version!==expectedPin.version||upstream.commit!==expectedPin.commit)&&findings.push(`${ecosystem}: pin drifted from upstream-tags.json`);const tags=(upstream.components??[]).map(component=>component.tag).sort();sameJson(tags,catalogs[ecosystem])||findings.push(`${ecosystem}: tag catalog drifted from upstream-tags.json`);for(const component of upstream.components??[])upstreamByTag.has(component.tag)&&findings.push(`${component.tag}: duplicate upstream tag`),upstreamByTag.set(component.tag,{ecosystem,component}),validateSurface(component.surface,component.tag,findings),(!component.review?.status||!Array.isArray(component.review.unreviewedSections))&&findings.push(`${component.tag}: missing surface review metadata`),strict&&component.review.status!=="complete"&&findings.push(`${component.tag}: public surface review is incomplete`);const expectedRuntimeEvidence=new Set;for(const observation of expectedPin.runtimeEventCancelability?.events??[]){const key=`${observation.tag}#${observation.event}`;if(expectedRuntimeEvidence.has(key)){findings.push(`${ecosystem}: duplicate runtime cancelability evidence ${key}`);continue}expectedRuntimeEvidence.add(key);const event=(upstream.components??[]).find(entry=>entry.tag===observation.tag)?.surface?.events?.find(entry=>entry.name===observation.event);(event?.cancelable!==observation.cancelable||event?.cancelabilityEvidence!=="pinned-runtime")&&findings.push(`${key}: stored runtime cancelability evidence drifted from upstream-tags.json`)}for(const component of upstream.components??[])for(const event of component.surface?.events??[])event.cancelabilityEvidence&&!expectedRuntimeEvidence.has(`${component.tag}#${event.name}`)&&findings.push(`${component.tag}#${event.name}: stored runtime cancelability evidence is stale`);const expectedMethodEdgeEvidence=new Set;for(const observation of expectedPin.runtimeMethodEdgeSemantics?.methods??[]){const key=`${observation.tag}#${observation.method}`;if(expectedMethodEdgeEvidence.has(key)){findings.push(`${ecosystem}: duplicate runtime method-edge evidence ${key}`);continue}expectedMethodEdgeEvidence.add(key);const method=(upstream.components??[]).find(entry=>entry.tag===observation.tag)?.surface?.methods?.find(entry=>entry.name===observation.method);sameJson(method?.edgeSemantics,{evidence:"pinned-runtime",cases:observation.cases})||findings.push(`${key}: stored runtime method-edge evidence drifted from upstream-tags.json`)}for(const component of upstream.components??[])for(const method of component.surface?.methods??[])method.edgeSemantics&&!expectedMethodEdgeEvidence.has(`${component.tag}#${method.name}`)&&findings.push(`${component.tag}#${method.name}: stored runtime method-edge evidence is stale`)}const mappingByTag=new Map;for(const mapping of inventory.mappings){mappingByTag.has(mapping.upstreamTag)&&findings.push(`${mapping.upstreamTag}: duplicate mapping`),mappingByTag.set(mapping.upstreamTag,mapping),upstreamByTag.has(mapping.upstreamTag)||findings.push(`${mapping.upstreamTag}: fictional upstream mapping`),MAPPING_CLASSIFICATIONS.includes(mapping.classification)||findings.push(`${mapping.upstreamTag}: invalid mapping classification`),validateAccessibilityParity(mapping,inventory.accessibilityProfiles,findings),validateRewrites(mapping,findings),mapping.classification==="exact"&&mapping.rationale!==null&&findings.push(`${mapping.upstreamTag}: exact mappings must not carry a rationale`),mapping.classification==="exact"&&REWRITE_RULE_SECTIONS.some(section=>mapping.rewrites?.[section]?.length)&&findings.push(`${mapping.upstreamTag}: exact mappings cannot declare rewrite rules`),mapping.classification==="rewritten"&&!REWRITE_RULE_SECTIONS.some(section=>mapping.rewrites?.[section]?.length)&&findings.push(`${mapping.upstreamTag}: rewritten mappings need a deterministic rule`),mapping.classification!=="exact"&&!mapping.rationale?.trim()&&findings.push(`${mapping.upstreamTag}: non-exact mapping needs a rationale`),mapping.targetTag&&!lyraByTag.has(mapping.targetTag)&&mapping.classification!=="unsupported"&&findings.push(`${mapping.upstreamTag} -> ${mapping.targetTag}: dangling target`);for(const rewrite of mapping.rewrites?.attributes??[]){const from=polarity(rewrite.from),to=polarity(rewrite.to);from!==to&&(from===-1||to===-1)&&findings.push(`${mapping.upstreamTag}: ${rewrite.from} -> ${rewrite.to} inverts polarity`)}const upstreamEntry=upstreamByTag.get(mapping.upstreamTag)?.component,target=lyraByTag.get(mapping.targetTag);if(findings.push(...validateMethodEdgeParity(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),findings.push(...validateDefaultRewriteSemantics(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),findings.push(...validateMappingNormalizations(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),upstreamEntry?.review.status==="complete"&&target){const expectedDrift=compareMappedSurfaces(upstreamEntry.surface,target.surface,{upstreamPrefix:mapping.upstream==="webawesome"?"wa-":"sl-",rewrites:mapping.rewrites,normalizations:mapping.normalizations});sameJson(mapping.drift,expectedDrift)||findings.push(`${mapping.upstreamTag}: stored surface drift is stale`),mapping.classification==="exact"&&expectedDrift.length&&findings.push(`${mapping.upstreamTag}: exact mapping has ${expectedDrift.length} surface difference(s)`)}const expectedStaticApiReview=deriveStaticApiReviewStatus({upstreamReviewStatus:upstreamEntry?.review.status,targetPresent:!!target,comparisonPerformed:upstreamEntry?.review.status==="complete"&&!!target});mapping.parity?.staticApi!==expectedStaticApiReview&&findings.push(`${mapping.upstreamTag}: static API review status is stale; expected ${expectedStaticApiReview}`),strict&&mapping.classification==="unsupported"&&findings.push(`${mapping.upstreamTag}: unsupported release blocker remains`)}mappingByTag.size!==upstreamByTag.size&&findings.push("not every upstream tag has exactly one mapping decision");for(const tag of upstreamByTag.keys())mappingByTag.has(tag)||findings.push(`${tag}: no mapping decision`);return findings.sort()}function validatePinnedManifests(inventory,{webawesomeManifest,shoelaceManifest,upstreamTags}){const findings=[],manifests={webawesome:{manifest:webawesomeManifest,prefix:"wa-"},shoelace:{manifest:shoelaceManifest,prefix:"sl-"}};for(const[ecosystem,{manifest,prefix}]of Object.entries(manifests)){const checked=new Map(applyRuntimeMethodEdgeSemanticsEvidence(applyRuntimeEventCancelabilityEvidence(normalizeManifest(manifest,{ecosystem}),upstreamTags?.[ecosystem]?.runtimeEventCancelability,{ecosystem,version:upstreamTags?.[ecosystem]?.version??inventory.upstreams[ecosystem].version}),upstreamTags?.[ecosystem]?.runtimeMethodEdgeSemantics,{ecosystem,version:upstreamTags?.[ecosystem]?.version??inventory.upstreams[ecosystem].version}).filter(entry=>entry.tag.startsWith(prefix)).map(entry=>[entry.tag,entry])),stored=new Map(inventory.upstreams[ecosystem].components.map(entry=>[entry.tag,entry]));for(const[tag,entry]of checked){const snapshot=stored.get(tag);if(!snapshot){findings.push(`${tag}: pinned manifest tag is absent from the inventory`);continue}sameJson(snapshot.surface,entry.surface)||findings.push(`${tag}: pinned public surface drifted`),sameJson(snapshot.maturity,entry.maturity)||findings.push(`${tag}: pinned maturity metadata drifted`),snapshot.review.status!=="complete"&&findings.push(`${tag}: pinned manifest surface is marked unreviewed`)}for(const[tag,snapshot]of stored)snapshot.review.source==="published-manifest"&&!checked.has(tag)&&findings.push(`${tag}: stored published-manifest surface is fictional or stale`)}return findings.sort()}function emptySurface(){return{attributes:[],properties:[],slots:[],events:[],parts:[],cssProperties:[],cssStates:[],methods:[],staticProperties:[],staticMethods:[],moduleExports:[],form:{associated:!1,properties:[],methods:[]},native:{forwardedEvents:[],delegatedMethods:[]}}}function familyFromModule(modulePath){return modulePath.split(path.posix.sep)[2]||null}export{ACCESSIBILITY_PROFILE_SECTIONS,INVENTORY_SCHEMA_VERSION,LOCAL_MIGRATION_ORIGINS,LOCAL_MIGRATION_PROFILES,MIGRATION_ATTRIBUTE_EXCLUSIONS,NORMALIZATION_SECTIONS,REWRITE_RULE_SECTIONS,SURFACE_SECTIONS,applyRuntimeEventCancelabilityEvidence,applyRuntimeMethodEdgeSemanticsEvidence,compareAccessibilityProfiles,compareMappedSurfaces,deriveStaticApiReviewStatus,emptyNormalizations,emptyRewrites,emptySurface,eventCancelabilityFromDescription,familyFromModule,normalizeDeclaration,normalizeManifest,validateAccessibilityContract,validateInventory,validateLocalMigrations,validateMappingNormalizations,validateMethodEdgeParity,validatePinnedManifests};
+import path from"node:path";const INVENTORY_SCHEMA_VERSION=1,SURFACE_SECTIONS=["attributes","properties","slots","events","parts","cssProperties","cssStates","methods","staticProperties","staticMethods","moduleExports","form","native"],MAPPING_CLASSIFICATIONS=["exact","rewritten","warning-required","conceptual-only","unsupported"],ACCESSIBILITY_PROFILE_SECTIONS=["semantics","naming","keyboard","focus","states","announcements","motion"],ACCESSIBILITY_BEHAVIOR_VOCABULARY=Object.freeze({semantics:Object.freeze(["alert","article","button","checkbox","combobox","composition-primitive","dialog","document","grid","group","iframe","img","link","list","listbox","menu","menuitem","navigation","option","presentation","progressbar","radio","radiogroup","region","separator","slider","spinbutton","status","switch","tab","table","tablist","tabpanel","text-content","textbox","tooltip","transparent-content","tree","treeitem","video"]),naming:Object.freeze(["alternative-text","author-label-required","content-derived","content-or-author-label","control-labels-localized","current-page","frame-title","heading-level","value-text","visible-or-author-label"]),keyboard:Object.freeze(["arrow-navigation","data-point-navigation","escape-dismiss","home-end-navigation","media-controls","native-activation","native-editing","page-navigation","range-adjustment","spatial-adjustment","tab-cycle","typeahead"]),focus:Object.freeze(["focus-follows-selection","focus-preserved","focus-return","focus-trap","focus-visible-on-reveal","frame-focus-gated","initial-focus","native-focus","roving-focus"]),states:Object.freeze(["busy","checked","current","disabled","expanded","invalid","modal","multiselectable","orientation","paused","pressed","readonly","required","selected","sort","value-range"]),announcements:Object.freeze(["autoplay-content-change","character-count","content-change","copy-result","live-alert","live-status","page-change","playback-state","progress-value","selection-change","validation-message"]),motion:Object.freeze(["respects-reduced-motion","stops-autoplay","suppresses-animation","user-pause-control"])}),ACCESSIBILITY_COMPARISON_STATUSES=["equivalent","target-additive","not-applicable","warning-required"],ACCESSIBILITY_EVIDENCE=Object.freeze({upstream:"pinned-public-contract",target:"lyra-authored-contract-and-automated-tests"}),REWRITE_RULE_SECTIONS=["attributes","properties","events","slots","parts","cssProperties","methods","defaults"],NORMALIZATION_SECTIONS=["typeEquivalences","structuralTypeAliases","methodParameterTypeEquivalences","defaultEquivalences","derivedDefaultEquivalences","inferredAttributeSuppressions","unknownMethodReturnTypes","cancelabilityEquivalences","cancelabilityPathAdditions","attributePropertyEquivalences","reflectionEquivalences","cssDefaultEquivalences","deprecationEquivalences"],CANCELABILITY_RANK=new Map([["never",0],["conditional",1],["always",2]]),LOCAL_MIGRATION_ORIGINS=[],LOCAL_MIGRATION_PROFILES=[],MIGRATION_ATTRIBUTE_EXCLUSIONS=Object.freeze({dir:"platform-global-passthrough",lang:"platform-global-passthrough",role:"platform-global-passthrough",tabindex:"platform-global-passthrough",title:"platform-global-passthrough","did-ssr":"upstream-hydration-marker"});function emptyRewrites(){return Object.fromEntries(REWRITE_RULE_SECTIONS.map(section=>[section,[]]))}function emptyNormalizations(){return Object.fromEntries(NORMALIZATION_SECTIONS.map(section=>[section,[]]))}function isPlainObject(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function accessibilityBehaviorSet(profile){return new Set(ACCESSIBILITY_PROFILE_SECTIONS.flatMap(section=>(profile?.[section]??[]).map(behavior=>`${section}:${behavior}`)))}function compareAccessibilityProfiles(profiles,upstreamProfile,targetProfile){const upstream=profiles?.[upstreamProfile],target=profiles?.[targetProfile];if(!upstream)throw new Error(`unknown upstream accessibility profile ${String(upstreamProfile)}`);if(!target)throw new Error(`unknown target accessibility profile ${String(targetProfile)}`);const upstreamBehaviors=accessibilityBehaviorSet(upstream),targetBehaviors=accessibilityBehaviorSet(target),missing=[...upstreamBehaviors].filter(behavior=>!targetBehaviors.has(behavior)).sort(),additions=[...targetBehaviors].filter(behavior=>!upstreamBehaviors.has(behavior)).sort();return{status:upstreamBehaviors.size===0&&targetBehaviors.size===0?"not-applicable":missing.length>0?"warning-required":additions.length>0?"target-additive":"equivalent",missing,additions}}function deriveStaticApiReviewStatus({upstreamReviewStatus,targetPresent,comparisonPerformed}){return upstreamReviewStatus==="tag-only"?"tag-only":upstreamReviewStatus==="complete"&&targetPresent===!0&&comparisonPerformed===!0?"reviewed":"unreviewed"}function validateAccessibilityProfiles(profiles,findings){if(!isPlainObject(profiles)||Object.keys(profiles).length===0){findings.push("accessibilityProfiles must be a non-empty object");return}for(const[profileName,profile]of Object.entries(profiles)){if(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(profileName)||findings.push(`accessibility profile ${profileName}: invalid profile name`),!isPlainObject(profile)){findings.push(`accessibility profile ${profileName}: profile must be an object`);continue}const allowedKeys=new Set(["description",...ACCESSIBILITY_PROFILE_SECTIONS]),unknownKeys=Object.keys(profile).filter(key=>!allowedKeys.has(key));unknownKeys.length>0&&findings.push(`accessibility profile ${profileName}: unknown key(s) ${unknownKeys.join(", ")}`),(typeof profile.description!="string"||!profile.description.trim())&&findings.push(`accessibility profile ${profileName}: description must be non-empty`);for(const section of ACCESSIBILITY_PROFILE_SECTIONS){const behaviors=profile[section];if(!Array.isArray(behaviors)){findings.push(`accessibility profile ${profileName}: ${section} must be an array`);continue}new Set(behaviors).size!==behaviors.length&&findings.push(`accessibility profile ${profileName}: duplicate ${section} behavior`),JSON.stringify(behaviors)!==JSON.stringify([...behaviors].sort())&&findings.push(`accessibility profile ${profileName}: ${section} behaviors must be sorted`);const allowed=new Set(ACCESSIBILITY_BEHAVIOR_VOCABULARY[section]);for(const behavior of behaviors)allowed.has(behavior)||findings.push(`accessibility profile ${profileName}: unknown ${section} behavior ${String(behavior)}`)}}}function validateAccessibilityParity(mapping,profiles,findings){const accessibility=mapping.parity?.accessibility;if(!isPlainObject(accessibility)){findings.push(`${mapping.upstreamTag}: missing accessibility parity review`);return}const allowedKeys=new Set(["reviewStatus","upstreamProfile","targetProfile","evidence","comparison","rationale"]),unknownKeys=Object.keys(accessibility).filter(key=>!allowedKeys.has(key));unknownKeys.length>0&&findings.push(`${mapping.upstreamTag}: accessibility parity has unknown key(s) ${unknownKeys.join(", ")}`),accessibility.reviewStatus!=="complete"&&findings.push(`${mapping.upstreamTag}: accessibility parity review is incomplete`),(!isPlainObject(accessibility.evidence)||accessibility.evidence.upstream!==ACCESSIBILITY_EVIDENCE.upstream||accessibility.evidence.target!==ACCESSIBILITY_EVIDENCE.target||Object.keys(accessibility.evidence??{}).some(key=>key!=="upstream"&&key!=="target"))&&findings.push(`${mapping.upstreamTag}: accessibility parity evidence is invalid`),(typeof accessibility.rationale!="string"||!accessibility.rationale.trim())&&findings.push(`${mapping.upstreamTag}: accessibility parity rationale must be non-empty`);let expected;try{expected=compareAccessibilityProfiles(profiles,accessibility.upstreamProfile,accessibility.targetProfile)}catch(error){findings.push(`${mapping.upstreamTag}: ${error instanceof Error?error.message:String(error)}`);return}(!isPlainObject(accessibility.comparison)||!sameJson(accessibility.comparison,expected))&&findings.push(`${mapping.upstreamTag}: stored accessibility comparison is stale`);const hasScopedConditionalReview=mapping.parity?.lightDom==="warning-required"&&Array.isArray(mapping.parity?.behaviorReviewFlags)&&mapping.parity.behaviorReviewFlags.length>0;(mapping.classification==="exact"||mapping.classification==="rewritten")&&expected.status==="warning-required"&&!hasScopedConditionalReview&&findings.push(`${mapping.upstreamTag}: automatic mapping has missing accessibility behavior`)}function validateAccessibilityContract(profiles,mappings){const findings=[];if(validateAccessibilityProfiles(profiles,findings),!Array.isArray(mappings))findings.push("accessibility mappings must be an array");else for(const mapping of mappings)validateAccessibilityParity(mapping,profiles,findings);return findings.sort()}const INTERNAL_METHOD_NAMES=new Set(["constructor","render","update","performUpdate","requestUpdate","shouldUpdate","willUpdate","updated","firstUpdated","createRenderRoot","connectedCallback","disconnectedCallback","adoptedCallback","attributeChangedCallback","addEventListener","removeEventListener","emit","localize","scheduleAfterUpdate","beginAbortableLoad","setCustomStates","setValue","updateValidity"]),PUBLIC_METHOD_NAMES=new Set(["focus","blur","click","select","show","hide","open","close","openSubmenu","closeSubmenu","toggle","checkValidity","reportValidity","setCustomValidity","resetValidity","formStateRestoreCallback","getForm","setSelectionRange","setRangeText","showPicker","stepUp","stepDown","play","pause","load","clearSearch","getHeadingTree","renderChart","renderMarkdown","search","searchNext","searchPrevious","handleColumnsChange","handlePageChange","handleSearchTermChange"]),FORM_PROPERTIES=new Set(["form","name","type","value","defaultValue","checked","defaultChecked","disabled","required","validity","validationMessage","willValidate","labels"]),FORM_METHODS=new Set(["checkValidity","reportValidity","setCustomValidity","getForm"]),NATIVE_METHODS=new Set(["focus","blur","click","select","setSelectionRange","setRangeText","showPicker","stepUp","stepDown","play","pause","load"]),NATIVE_EVENTS=new Set(["beforeinput","input","change","focus","blur","invalid","load","error","play","pause","ended","loadedmetadata","timeupdate","volumechange"]),UNDOCUMENTED_PUBLIC_FIELDS=new Set(["title"]),UNSPECIFIED_PUBLIC_DOCUMENTATION="unspecified-public-documentation",FRAMEWORK_CONTROLLER_FIELDS=new Set(["localize"]),PROPERTY_ONLY_FIELDS=new Set(["accessibleLabel","config","chart","currentTime","filter","files","keyframes","languages","marked","modal","selectedItems","selectedOptions","valueAsDate","valueAsNumber","validationMessage","validity","willValidate"]),hasOwn=(value,key)=>Object.prototype.hasOwnProperty.call(value,key),textOf=type=>type?.text?.replace(/\s+/g," ").trim()||"unknown",sortByName=entries=>[...entries].sort((a,b)=>a.name.localeCompare(b.name)),unique=entries=>[...new Set(entries)].sort();function canonicalDefault(raw){if(raw===void 0)return;if(raw===null||typeof raw=="boolean"||typeof raw=="number")return raw;const value=String(raw).trim();return value==="true"?!0:value==="false"?!1:value==="null"?null:value==="undefined"?"undefined":/^-?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i.test(value)?Number(value):value.startsWith("'")&&value.endsWith("'")||value.startsWith('"')&&value.endsWith('"')?value.slice(1,-1).replace(/\\(['"\\])/g,"$1"):value.replace(/\s+/g," ")}function kebabCase(name){return name.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replaceAll("_","-").toLowerCase()}function isInternalMethod(member,ecosystem){return member.kind!=="method"||member.static||member.privacy==="private"||member.privacy==="protected"?!0:ecosystem==="lyra"&&!member.inheritedFrom?!1:!!(INTERNAL_METHOD_NAMES.has(member.name)||/^(?:handle|on|_)[A-Z_]/.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||/Callback$/.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||member.inheritedFrom&&!PUBLIC_METHOD_NAMES.has(member.name)&&!FORM_METHODS.has(member.name)||ecosystem!=="lyra"&&!member.description&&!PUBLIC_METHOD_NAMES.has(member.name)&&!FORM_METHODS.has(member.name))}function isPublicField(member,attributeNames,ecosystem){return member.kind!=="field"||member.static||member.privacy==="private"||member.privacy==="protected"?!1:ecosystem==="lyra"&&!member.inheritedFrom?!0:/^_/.test(member.name)||FRAMEWORK_CONTROLLER_FIELDS.has(member.name)&&!member.attribute&&!attributeNames.has(member.name)&&!member.description?!1:attributeNames.has(member.name)||member.attribute||FORM_PROPERTIES.has(member.name)||PROPERTY_ONLY_FIELDS.has(member.name)?!0:member.inheritedFrom?FORM_PROPERTIES.has(member.name)||PROPERTY_ONLY_FIELDS.has(member.name):ecosystem==="shoelace"?!!member.description||FORM_PROPERTIES.has(member.name)||UNDOCUMENTED_PUBLIC_FIELDS.has(member.name):member.privacy==="public"||!!member.description||!!member.readonly}const FRAMEWORK_STATIC_FIELDS=new Set(["css","dependencies","elementProperties","formAssociated","observeSlots","shadowRootOptions","styles"]);function isPublicStaticField(member,ecosystem){return member.kind!=="field"||member.static!==!0||member.privacy==="private"||member.privacy==="protected"||FRAMEWORK_STATIC_FIELDS.has(member.name)?!1:ecosystem==="lyra"&&!member.inheritedFrom?!0:member.privacy==="public"||!!member.description||!!member.readonly}function isPublicStaticMethod(member,ecosystem){return member.kind!=="method"||member.static!==!0||member.privacy==="private"||member.privacy==="protected"?!1:ecosystem==="lyra"&&!member.inheritedFrom?!(INTERNAL_METHOD_NAMES.has(member.name)||/^(?:handle|on|_)[A-Z_]/u.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)||/Callback$/u.test(member.name)&&!PUBLIC_METHOD_NAMES.has(member.name)):member.privacy==="public"||!!member.description}function normalizeParameter(parameter,ecosystem){const normalized={name:parameter.name,type:ecosystem!=="lyra"&&!parameter.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(parameter.type),optional:parameter.optional===!0};return hasOwn(parameter,"default")?(normalized.hasDefault=!0,normalized.default=canonicalDefault(parameter.default)):normalized.hasDefault=!1,normalized}function eventCancelabilityFromDescription(description="",ecosystem="lyra",eventName){const text=description.toLowerCase().replace(/\b(?:conditionally\s+|non[- ]?|not\s+|never\s+)?cancell?able\s+`(lr-[a-z0-9-]+)`/gu,(phrase,referencedEvent)=>referencedEvent===eventName?phrase:""),conditionalPattern=/\bconditionally\s+cancell?able\b/gu,negativePattern=/\b(?:non[- ]?|not\s+|never\s+)cancell?able\b/gu,conditional=conditionalPattern.exec(text),negative=negativePattern.exec(text),withoutQualifiedMarkers=text.replace(conditionalPattern,phrase=>" ".repeat(phrase.length)).replace(negativePattern,phrase=>" ".repeat(phrase.length)),markers=[{kind:"conditional",match:conditional},{kind:"never",match:negative},{kind:"always",match:/\bcancell?able\b/u.exec(withoutQualifiedMarkers)},{kind:"implicit-always",match:/preventdefault\(\)|\bcancel(?:ing|ling) this event\b/u.exec(text)}].filter(({match})=>match);markers.sort((left,right)=>left.match.index-right.match.index);const first=markers[0];if(!first)return ecosystem==="lyra"?"never":UNSPECIFIED_PUBLIC_DOCUMENTATION;if(first.kind==="conditional")return"conditional";const kinds=new Set(markers.map(({kind})=>kind));return kinds.has("always")&&kinds.has("never")||first.kind==="always"&&/\b(?:except|unless|single\s+exception)\b/u.test(text)?"conditional":first.kind==="implicit-always"?"always":first.kind}function normalizeAttributes(declaration,publicFields,ecosystem){const fields=new Map(publicFields.map(member=>[member.name,member])),declared=declaration.attributes??[],source=declared.length?declared:publicFields.filter(member=>!member.readonly&&!PROPERTY_ONLY_FIELDS.has(member.name)).map(member=>({name:member.attribute||kebabCase(member.name),fieldName:member.name,type:member.type,...hasOwn(member,"default")?{default:member.default}:{},inferred:!0}));return sortByName(source.map(attribute=>{const field=fields.get(attribute.fieldName||attribute.name)??publicFields.find(member=>member.attribute===attribute.name),normalized={name:attribute.name,property:attribute.fieldName||field?.name||attribute.name,type:textOf(attribute.parsedType||attribute.type||field?.type),reflects:field?.reflects===!0,inferred:attribute.inferred===!0||ecosystem==="shoelace"&&declared.length===0,deprecated:attribute.deprecation??attribute.deprecated??field?.deprecation??field?.deprecated??null,hasDefault:hasOwn(attribute,"default")||!!(field&&hasOwn(field,"default"))};return normalized.hasDefault&&(normalized.default=canonicalDefault(hasOwn(attribute,"default")?attribute.default:field.default)),normalized}))}function normalizeProperties(publicFields){return sortByName(publicFields.map(member=>{const normalized={name:member.name,attribute:typeof member.attribute=="string"?member.attribute:null,type:textOf(member.parsedType||member.type),readonly:member.readonly===!0,reflects:member.reflects===!0,deprecated:member.deprecation||member.deprecated||null,hasDefault:hasOwn(member,"default")};return normalized.hasDefault&&(normalized.default=canonicalDefault(member.default)),normalized}))}function normalizeMethodEntries(members,ecosystem){const grouped=new Map;for(const member of members){const overload={parameters:(member.parameters??[]).map(parameter=>normalizeParameter(parameter,ecosystem)),returnType:ecosystem!=="lyra"&&!member.return?.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(member.return?.type)},key=JSON.stringify(overload),current=grouped.get(member.name)??new Map;current.set(key,overload),grouped.set(member.name,current)}return[...grouped].map(([name,overloads])=>{const declaration=members.find(member=>member.kind==="method"&&member.name===name),deprecated=declaration?.deprecation||declaration?.deprecated||null;return{name,overloads:[...overloads.values()],...deprecated?{deprecated}:{}}}).sort((a,b)=>a.name.localeCompare(b.name))}function normalizeMethods(members,ecosystem){return normalizeMethodEntries(members.filter(member=>!isInternalMethod(member,ecosystem)),ecosystem)}function normalizeStaticProperties(members,ecosystem){return sortByName(members.filter(member=>isPublicStaticField(member,ecosystem)).map(member=>({name:member.name,type:textOf(member.parsedType||member.type),readonly:member.readonly===!0,deprecated:member.deprecation||member.deprecated||null})))}function normalizeStaticMethods(members,ecosystem){return normalizeMethodEntries(members.filter(member=>isPublicStaticMethod(member,ecosystem)),ecosystem)}function normalizedModulePath(modulePath){return typeof modulePath!="string"||!modulePath?null:path.posix.normalize(modulePath.replaceAll("\\","/").replace(/^\/+/,""))}function moduleLookupPath(modulePath){return normalizedModulePath(modulePath)?.replace(/\.(?:[cm]?js|ts)$/u,"")??null}function resolvedExportDeclarationPath(exportingModule,declarationModule){const exportingPath=normalizedModulePath(exportingModule),declaredPath=normalizedModulePath(declarationModule);return!exportingPath||!declaredPath?null:declarationModule.startsWith(".")?path.posix.normalize(path.posix.join(path.posix.dirname(exportingPath),declarationModule)):declaredPath}function moduleDeclarationIndex(manifest){const index=new Map;for(const module of manifest.modules??[]){const modulePath=moduleLookupPath(module.path);if(modulePath)for(const declaration of module.declarations??[]){if(!declaration?.name)continue;const key=`${modulePath}\0${declaration.name}`,declarations=index.get(key)??[];declarations.push(declaration),index.set(key,declarations)}}return index}function moduleExportDeclaration(index,module,entry){const exportingPath=moduleLookupPath(module.path),declarationName=entry.declaration?.name??entry.name,declaredPath=entry.declaration?.module?moduleLookupPath(resolvedExportDeclarationPath(module.path,entry.declaration.module)):exportingPath;return index.get(`${declaredPath}\0${declarationName}`)??index.get(`${exportingPath}\0${declarationName}`)??[]}function normalizeComponentModuleExports(manifest,componentModulePath,{ecosystem,additionalModules=[]}){const componentPath=normalizedModulePath(componentModulePath);if(!componentPath)return[];const scopedModules=new Set([componentPath,...additionalModules.map(modulePath=>normalizedModulePath(modulePath)).filter(Boolean)]),declarationIndex=moduleDeclarationIndex(manifest),normalized=[];for(const module of manifest.modules??[]){const modulePath=normalizedModulePath(module.path);if(!modulePath||!scopedModules.has(modulePath))continue;const explicitlyScoped=modulePath!==componentPath;for(const entry of module.exports??[]){if(entry.kind!=="js"||!entry.name||entry.name==="default"||entry.name==="*")continue;const declarations=moduleExportDeclaration(declarationIndex,module,entry),functions=declarations.filter(declaration=>declaration.kind==="function"&&declaration.privacy!=="private"&&declaration.privacy!=="protected"&&(ecosystem==="lyra"||declaration.privacy==="public"||!!declaration.description)),variable=declarations.find(declaration=>declaration.kind==="variable"&&declaration.privacy!=="private"&&declaration.privacy!=="protected"&&(ecosystem==="lyra"||declaration.privacy==="public"||!!declaration.description));if(functions.length>0){const callable=normalizeMethodEntries(functions.map(declaration=>({...declaration,kind:"method"})),ecosystem)[0];normalized.push({module:modulePath,name:entry.name,kind:"function",overloads:callable?.overloads??[],...callable?.deprecated?{deprecated:callable.deprecated}:{}})}else variable?normalized.push({module:modulePath,name:entry.name,kind:"variable",type:ecosystem!=="lyra"&&!variable.type?UNSPECIFIED_PUBLIC_DOCUMENTATION:textOf(variable.type),readonly:variable.readonly===!0,deprecated:variable.deprecation||variable.deprecated||null}):declarations.length===0&&explicitlyScoped&&normalized.push({module:modulePath,name:entry.name,kind:"unknown",type:UNSPECIFIED_PUBLIC_DOCUMENTATION,deprecated:null})}}return normalized.sort((left,right)=>`${left.module}:${left.name}:${left.kind}`.localeCompare(`${right.module}:${right.name}:${right.kind}`))}const REVIEWED_COMPONENT_MODULE_EXPORT_SCOPES=new Map([["webawesome:wa-animation",["components/animation/animations.js"]]]);function normalizeNamed(entries){return sortByName((entries??[]).map(entry=>({name:entry.name??"",deprecated:entry.deprecation||entry.deprecated||null})))}function normalizeCssProperties(entries,tagName="custom element"){return sortByName((entries??[]).map(entry=>{if(typeof entry?.name!="string"||!entry.name)throw new Error(`${tagName}: malformed CSS custom-property manifest entry`);const normalized={name:entry.name,deprecated:entry.deprecation||entry.deprecated||null,hasDefault:hasOwn(entry,"default")};return normalized.hasDefault&&(normalized.default=canonicalDefault(entry.default)),normalized}))}function eventFlag(description,positive,negative){const text=String(description??"").toLowerCase();if(negative.test(text))return!1;if(positive.test(text))return!0}const EVENT_CONSTRUCTORS=["AnimationEvent","BeforeUnloadEvent","ClipboardEvent","CloseEvent","CompositionEvent","CustomEvent","DeviceMotionEvent","DeviceOrientationEvent","DragEvent","ErrorEvent","Event","FocusEvent","GamepadEvent","HashChangeEvent","InputEvent","KeyboardEvent","MessageEvent","MouseEvent","PageTransitionEvent","PointerEvent","PopStateEvent","ProgressEvent","PromiseRejectionEvent","SecurityPolicyViolationEvent","StorageEvent","SubmitEvent","ToggleEvent","TouchEvent","TrackEvent","TransitionEvent","UIEvent","WheelEvent"],EVENT_CONSTRUCTOR_PATTERN=EVENT_CONSTRUCTORS.join("|"),SINGLE_EVENT_TYPE=new RegExp(`^(${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?$`,"u"),EVENT_UNION_TYPE=new RegExp(`^(?:${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?(?:\\s*\\|\\s*(?:${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?)+$`,"u"),EVENT_WITH_COMPATIBILITY_DETAIL=new RegExp(`^(${EVENT_CONSTRUCTOR_PATTERN})(?:<.*>)?\\s*&\\s*\\{[^]*\\bdetail\\s*:`,"u");function eventConstructor(type){const text=textOf(type),single=SINGLE_EVENT_TYPE.exec(text);if(single)return single[1];const withCompatibilityDetail=EVENT_WITH_COMPATIBILITY_DETAIL.exec(text);return withCompatibilityDetail?withCompatibilityDetail[1]:EVENT_UNION_TYPE.test(text)?text:void 0}function normalizeEvents(entries,ecosystem){return sortByName((entries??[]).map(entry=>{const deprecated=entry.deprecation||entry.deprecated||null,normalized={name:entry.name,type:textOf(entry.type),cancelable:eventCancelabilityFromDescription(entry.description,ecosystem,entry.name),...deprecated?{deprecated}:{}},constructor=eventConstructor(entry.type),bubbles=eventFlag(entry.description,/\b(?:bubbling|bubbles)\b/,/\b(?:non[- ]?bubbling|does not bubble|doesn't bubble)\b/),composed=eventFlag(entry.description,/\bcomposed\b/,/\b(?:non[- ]?composed|not composed)\b/);return constructor!==void 0&&(normalized.constructor=constructor),bubbles!==void 0&&(normalized.bubbles=bubbles),composed!==void 0&&(normalized.composed=composed),normalized}))}function declaredFormAssociation(declaration){if(typeof declaration.formAssociated=="boolean")return declaration.formAssociated;const ownStatic=(declaration.members??[]).find(member=>member.kind==="field"&&member.name==="formAssociated"&&member.static===!0&&!member.inheritedFrom);if(ownStatic)return ownStatic.default===!0||String(ownStatic.default).trim()==="true";if((declaration.mixins??[]).some(mixin=>mixin.name==="FormAssociated"||mixin.name==="CheckedFormAssociated"))return!0}function canonicalModulePath(modulePath){return typeof modulePath=="string"?modulePath.replace(/^\/+/,"").replace(/\.js$/u,".ts"):null}function manifestFormAssociations(manifest){const declarations=[],byModuleAndName=new Map,byName=new Map;for(const module of manifest.modules??[])for(const declaration of module.declarations??[]){if(!declaration?.name)continue;declarations.push(declaration);const modulePath=canonicalModulePath(module.path);modulePath&&byModuleAndName.set(`${modulePath}\0${declaration.name}`,declaration);const named=byName.get(declaration.name)??[];named.push(declaration),byName.set(declaration.name,named)}const resolved=new Map,resolving=new Set,resolve=declaration=>{if(resolved.has(declaration))return resolved.get(declaration);if(resolving.has(declaration))return!1;resolving.add(declaration);let associated=declaredFormAssociation(declaration);if(associated===void 0&&declaration.superclass?.name){const modulePath=canonicalModulePath(declaration.superclass.module),exact=modulePath?byModuleAndName.get(`${modulePath}\0${declaration.superclass.name}`):void 0,named=byName.get(declaration.superclass.name)??[],superclass=exact??(named.length===1?named[0]:void 0);superclass&&(associated=resolve(superclass))}return associated===void 0&&(associated=(declaration.members??[]).some(member=>member.kind==="field"&&member.name==="formAssociated"&&member.static===!0&&!!member.inheritedFrom&&(member.default===!0||String(member.default).trim()==="true"))),resolving.delete(declaration),resolved.set(declaration,associated===!0),associated===!0};for(const declaration of declarations)resolve(declaration);return resolved}function normalizeDeclaration(declaration,{ecosystem,formAssociated}){const attributeFieldNames=new Set((declaration.attributes??[]).flatMap(attribute=>[attribute.fieldName,attribute.name]).filter(Boolean)),publicFields=(declaration.members??[]).filter(member=>isPublicField(member,attributeFieldNames,ecosystem)),properties=normalizeProperties(publicFields),methods=normalizeMethods(declaration.members??[],ecosystem),staticProperties=normalizeStaticProperties(declaration.members??[],ecosystem),staticMethods=normalizeStaticMethods(declaration.members??[],ecosystem),events=normalizeEvents(declaration.events,ecosystem),formProperties=properties.filter(entry=>FORM_PROPERTIES.has(entry.name)).map(entry=>entry.name),formMethods=methods.filter(entry=>FORM_METHODS.has(entry.name)).map(entry=>entry.name),delegatedMethods=methods.filter(entry=>NATIVE_METHODS.has(entry.name)).map(entry=>entry.name),forwardedEvents=events.filter(entry=>NATIVE_EVENTS.has(entry.name)).map(entry=>entry.name),associated=formAssociated??declaredFormAssociation(declaration)===!0;return{attributes:normalizeAttributes(declaration,publicFields,ecosystem),properties,slots:normalizeNamed(declaration.slots),events,parts:normalizeNamed(declaration.cssParts),cssProperties:normalizeCssProperties(declaration.cssProperties,declaration.tagName),cssStates:normalizeNamed(declaration.cssStates),methods,staticProperties,staticMethods,moduleExports:[],form:{associated,properties:unique(formProperties),methods:unique(formMethods)},native:{forwardedEvents:unique(forwardedEvents),delegatedMethods:unique(delegatedMethods)},maturity:{status:declaration.status||"unclassified",since:declaration.since||null,deprecated:declaration.deprecated||null}}}function normalizeManifest(manifest,{ecosystem,tierByTag=new Map}){const components=[],formAssociations=manifestFormAssociations(manifest);for(const module of manifest.modules??[])for(const declaration of module.declarations??[]){if(!declaration.customElement||!declaration.tagName)continue;const normalized=normalizeDeclaration(declaration,{ecosystem,formAssociated:formAssociations.get(declaration)});normalized.moduleExports=normalizeComponentModuleExports(manifest,module.path,{ecosystem,additionalModules:REVIEWED_COMPONENT_MODULE_EXPORT_SCOPES.get(`${ecosystem}:${declaration.tagName}`)??[]}),components.push({tag:declaration.tagName,module:module.path||declaration.modulePath||declaration.definitionPath||null,tier:tierByTag.get(declaration.tagName)||null,maturity:normalized.maturity,surface:Object.fromEntries(SURFACE_SECTIONS.map(section=>[section,normalized[section]])),review:{status:"complete",source:"published-manifest",unreviewedSections:[]}})}return components.sort((a,b)=>a.tag.localeCompare(b.tag))}const UPSTREAM_RUNTIME_PACKAGES=Object.freeze({webawesome:"@awesome.me/webawesome",shoelace:"@shoelace-style/shoelace"});function runtimeEvidenceInvariant(condition,message){if(!condition)throw new Error(message)}function exactObjectKeys(value,expected){return value&&typeof value=="object"&&!Array.isArray(value)&&Object.keys(value).sort().join("\0")===[...expected].sort().join("\0")}function applyRuntimeEventCancelabilityEvidence(components,evidence,{ecosystem,version}={}){runtimeEvidenceInvariant(Array.isArray(components),"runtime cancelability evidence needs normalized components");const augmented=structuredClone(components);if(evidence==null)return augmented;runtimeEvidenceInvariant(exactObjectKeys(evidence,["source","coverage","events"]),`${String(ecosystem)}: malformed runtime cancelability evidence envelope`),runtimeEvidenceInvariant(exactObjectKeys(evidence.source,["package","version","tarballIntegrity"]),`${String(ecosystem)}: malformed runtime cancelability evidence source`);const expectedPackage=UPSTREAM_RUNTIME_PACKAGES[ecosystem];runtimeEvidenceInvariant(typeof expectedPackage=="string"&&evidence.source.package===expectedPackage,`${String(ecosystem)}: runtime evidence package ${String(evidence.source.package)} does not match ${String(expectedPackage)}`),runtimeEvidenceInvariant(evidence.source.version===version,`${String(ecosystem)}: runtime evidence version ${String(evidence.source.version)} does not match pin ${String(version)}`),runtimeEvidenceInvariant(typeof evidence.source.tarballIntegrity=="string"&&evidence.source.tarballIntegrity.startsWith("sha512-"),`${String(ecosystem)}: runtime evidence needs a SHA-512 package integrity`),runtimeEvidenceInvariant(evidence.coverage==="all-public-transition-paths",`${String(ecosystem)}: runtime cancelability evidence must cover all public transition paths`),runtimeEvidenceInvariant(Array.isArray(evidence.events)&&evidence.events.length>0,`${String(ecosystem)}: runtime cancelability evidence needs events`);const byTag=new Map(augmented.map(component=>[component.tag,component])),seen=new Set;for(const observation of evidence.events){runtimeEvidenceInvariant(exactObjectKeys(observation,["tag","event","cancelable","paths"]),`${String(observation?.tag)}#${String(observation?.event)}: malformed runtime cancelability evidence`);const key=`${observation.tag}#${observation.event}`;runtimeEvidenceInvariant(!seen.has(key),`duplicate runtime cancelability evidence ${key}`),seen.add(key),runtimeEvidenceInvariant(["always","never","conditional"].includes(observation.cancelable),`${key}: runtime cancelability evidence has an invalid result`),runtimeEvidenceInvariant(Array.isArray(observation.paths)&&observation.paths.length>0&&observation.paths.every(path2=>typeof path2=="string"&&!!path2.trim())&&new Set(observation.paths).size===observation.paths.length,`${key}: runtime cancelability evidence needs reviewed public paths`);const event=byTag.get(observation.tag)?.surface?.events?.find(entry=>entry.name===observation.event);runtimeEvidenceInvariant(event,`${key}: runtime cancelability evidence targets an unknown event`),runtimeEvidenceInvariant(event.cancelable===UNSPECIFIED_PUBLIC_DOCUMENTATION&&!event.cancelabilityEvidence,`${key}: pinned runtime evidence is stale because the manifest now documents cancelability`),event.cancelable=observation.cancelable,event.cancelabilityEvidence="pinned-runtime"}return augmented}const METHOD_EDGE_MEASUREMENT_BASES=new Set(["ambient-page-viewport"]),METHOD_EDGE_PARITY_EVIDENCE=Object.freeze({upstream:"pinned-package-black-box",target:"lyra-authored-contract-and-automated-tests"}),METHOD_EDGE_DIVERGENCE_FLAG="method-edge-return-sentinel-divergence";function validMethodEdgeOutcome(outcome){return!outcome||typeof outcome!="object"||Array.isArray(outcome)?!1:outcome.kind==="sentinel"?exactObjectKeys(outcome,["kind","value"])&&(outcome.value===null||typeof outcome.value=="string"||typeof outcome.value=="boolean"||typeof outcome.value=="number"&&Number.isFinite(outcome.value)):outcome.kind==="measurement"&&exactObjectKeys(outcome,["kind","basis"])&&METHOD_EDGE_MEASUREMENT_BASES.has(outcome.basis)}function applyRuntimeMethodEdgeSemanticsEvidence(components,evidence,{ecosystem,version}={}){runtimeEvidenceInvariant(Array.isArray(components),"runtime method-edge evidence needs normalized components");const augmented=structuredClone(components);if(evidence==null)return augmented;runtimeEvidenceInvariant(exactObjectKeys(evidence,["source","methods"]),`${String(ecosystem)}: malformed runtime method-edge evidence envelope`),runtimeEvidenceInvariant(exactObjectKeys(evidence.source,["package","version","tarballIntegrity"]),`${String(ecosystem)}: malformed runtime method-edge evidence source`);const expectedPackage=UPSTREAM_RUNTIME_PACKAGES[ecosystem];runtimeEvidenceInvariant(typeof expectedPackage=="string"&&evidence.source.package===expectedPackage,`${String(ecosystem)}: runtime method-edge evidence package ${String(evidence.source.package)} does not match ${String(expectedPackage)}`),runtimeEvidenceInvariant(evidence.source.version===version,`${String(ecosystem)}: runtime method-edge evidence version ${String(evidence.source.version)} does not match pin ${String(version)}`),runtimeEvidenceInvariant(typeof evidence.source.tarballIntegrity=="string"&&evidence.source.tarballIntegrity.startsWith("sha512-"),`${String(ecosystem)}: runtime method-edge evidence needs a SHA-512 package integrity`),runtimeEvidenceInvariant(Array.isArray(evidence.methods)&&evidence.methods.length>0,`${String(ecosystem)}: runtime method-edge evidence needs methods`);const byTag=new Map(augmented.map(component=>[component.tag,component])),seenMethods=new Set;for(const observation of evidence.methods){runtimeEvidenceInvariant(exactObjectKeys(observation,["tag","method","cases"]),`${String(observation?.tag)}#${String(observation?.method)}: malformed runtime method-edge evidence`);const key=`${observation.tag}#${observation.method}`;runtimeEvidenceInvariant(!seenMethods.has(key),`duplicate runtime method-edge evidence ${key}`),seenMethods.add(key);const method=byTag.get(observation.tag)?.surface?.methods?.find(entry=>entry.name===observation.method);runtimeEvidenceInvariant(method,`${key}: runtime method-edge evidence targets an unknown method`),runtimeEvidenceInvariant((method.overloads??[]).length>0&&(method.overloads??[]).every(overload=>overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)&&!method.edgeSemantics,`${key}: pinned method-edge evidence is stale because the manifest now documents its return`);const caseNames=new Set;runtimeEvidenceInvariant(Array.isArray(observation.cases)&&observation.cases.length>0&&observation.cases.every(entry=>!exactObjectKeys(entry,["case","arguments","outcome"])||typeof entry.case!="string"||!entry.case.trim()||caseNames.has(entry.case)||!Array.isArray(entry.arguments)||!entry.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())||!(method.overloads??[]).some(overload=>(overload.parameters??[]).length===entry.arguments.length)||!validMethodEdgeOutcome(entry.outcome)?!1:(caseNames.add(entry.case),!0)),`${key}: runtime method-edge evidence must cover unique named cases`),method.edgeSemantics={evidence:"pinned-runtime",cases:structuredClone(observation.cases)}}return augmented}function validateMethodEdgeParity(mapping,{upstream,target}={}){const findings=[],label=mapping?.upstreamTag??"<unknown>",methods=mapping?.parity?.methodEdges,observed=(upstream?.methods??[]).filter(method=>method.edgeSemantics),observedByName=new Map(observed.map(method=>[method.name,method])),behaviorFlags=mapping?.parity?.behaviorReviewFlags,hasDivergenceFlag=Array.isArray(behaviorFlags)&&behaviorFlags.includes(METHOD_EDGE_DIVERGENCE_FLAG);if(methods===void 0)return observed.length>0&&findings.push(`${label}: missing method-edge parity review`),hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings;if(!Array.isArray(methods)||methods.length===0)return findings.push(`${label}: parity.methodEdges must be a non-empty array`),hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings;const seenMethods=new Set;let hasDifferentCase=!1;for(const method of methods){if(!(exactObjectKeys(method,["method","evidence","cases","rationale"])&&typeof method.method=="string"&&!!method.method.trim()&&exactObjectKeys(method.evidence,["upstream","target"])&&method.evidence.upstream===METHOD_EDGE_PARITY_EVIDENCE.upstream&&method.evidence.target===METHOD_EDGE_PARITY_EVIDENCE.target&&Array.isArray(method.cases)&&method.cases.length>0&&typeof method.rationale=="string"&&!!method.rationale.trim())){findings.push(`${label}: malformed method-edge parity review`);continue}seenMethods.has(method.method)&&findings.push(`${label}: duplicate method-edge parity review ${method.method}`),seenMethods.add(method.method);const observedMethod=observedByName.get(method.method);upstream!==void 0&&!observedMethod&&findings.push(`${label}#${method.method}: stale method-edge parity review`),target!==void 0&&!(target.methods??[]).some(entry=>entry.name===method.method)&&findings.push(`${label}#${method.method}: dangling method-edge parity target`);const observedCases=new Map((observedMethod?.edgeSemantics?.cases??[]).map(entry=>[entry.case,entry])),seenCases=new Set;for(const edgeCase of method.cases){if(!(exactObjectKeys(edgeCase,["case","arguments","upstream","target","status"])&&typeof edgeCase.case=="string"&&!!edgeCase.case.trim()&&Array.isArray(edgeCase.arguments)&&edgeCase.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())&&validMethodEdgeOutcome(edgeCase.upstream)&&validMethodEdgeOutcome(edgeCase.target)&&(edgeCase.status==="equivalent"||edgeCase.status==="different"))){findings.push(`${label}#${method.method}: malformed method-edge parity case`);continue}seenCases.has(edgeCase.case)&&findings.push(`${label}#${method.method}: duplicate method-edge parity case ${edgeCase.case}`),seenCases.add(edgeCase.case);const expectedStatus=sameJson(edgeCase.upstream,edgeCase.target)?"equivalent":"different";if(edgeCase.status!==expectedStatus&&findings.push(`${label}#${method.method}:${edgeCase.case}: stale method-edge parity status`),expectedStatus==="different"&&(hasDifferentCase=!0),observedMethod){const observedCase=observedCases.get(edgeCase.case);(!observedCase||!sameJson(observedCase.arguments,edgeCase.arguments)||!sameJson(observedCase.outcome,edgeCase.upstream))&&findings.push(`${label}#${method.method}:${edgeCase.case}: stored upstream method-edge observation is stale`)}}if(observedMethod)for(const observedCase of observedMethod.edgeSemantics.cases??[])seenCases.has(observedCase.case)||findings.push(`${label}#${method.method}:${observedCase.case}: missing method-edge parity case`)}if(upstream!==void 0)for(const method of observed)seenMethods.has(method.name)||findings.push(`${label}#${method.name}: missing method-edge parity review`);return hasDifferentCase?(mapping.classification!=="warning-required"&&findings.push(`${label}: method-edge divergence requires warning-required classification`),hasDivergenceFlag||findings.push(`${label}: missing ${METHOD_EDGE_DIVERGENCE_FLAG} behavior flag`),methods.some(method=>typeof mapping.rationale!="string"||typeof method?.rationale!="string"||!mapping.rationale.includes(method.rationale))&&findings.push(`${label}: mapping rationale omits method-edge divergence`)):hasDivergenceFlag&&findings.push(`${label}: stale method-edge divergence behavior flag`),findings}function mappedEventName(name,upstreamPrefix){return name.startsWith(upstreamPrefix)?`lr-${name.slice(upstreamPrefix.length)}`:name}function polarity(name){return/^(?:no|not|without|hide|disable)-/.test(name)?-1:/^(?:with|show|enable)-/.test(name)?1:0}function polarityStem(name){return name.replace(/^(?:no|not|without|hide|disable|with|show|enable)-/,"")}function pushMissing(drift,code,section,name){drift.push({code,section,member:name})}function normalizationKey(memberKind,member){return`${memberKind}:${member}`}function normalizedExpectedDefault(normalizations,memberKind,member,upstreamDefault){const rule=(normalizations.defaultEquivalences??[]).find(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamDefault);return rule?rule.target:upstreamDefault}function reviewedAttributeProperty(normalizations,attribute,upstreamProperty,targetProperty){return(normalizations.attributePropertyEquivalences??[]).some(entry=>entry.attribute===attribute&&entry.upstream===upstreamProperty&&entry.target===targetProperty)}function reviewedReflection(normalizations,memberKind,member,upstreamReflects,targetReflects){return(normalizations.reflectionEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamReflects&&entry.target===targetReflects)}function reviewedCssDefault(normalizations,member,upstreamEntry,targetEntry){return(normalizations.cssDefaultEquivalences??[]).some(entry=>entry.member===member&&entry.upstreamHasDefault===upstreamEntry.hasDefault&&(!entry.upstreamHasDefault||entry.upstream===upstreamEntry.default)&&entry.targetHasDefault===targetEntry.hasDefault&&(!entry.targetHasDefault||entry.target===targetEntry.default))}function deprecationReplacement(value){if(value&&typeof value=="object"){const replacement=value.replacement;if(!replacement||typeof replacement!="object")return null;const usage=typeof replacement.usage=="string"?replacement.usage.trim():"";return/^([a-z][a-z0-9-]*)\s*=\s*["'][^"']+["']$/iu.exec(usage)?.[1]===replacement.name?usage.replace(/\s+/gu,""):typeof replacement.name=="string"&&replacement.name?replacement.name:null}return typeof value!="string"?null:/\buse\s+(?:the\s+)?`([^`]+)`/iu.exec(value)?.[1]??/\buse\s+(?:the\s+)?(?!the\b)([a-z][a-z0-9-]*)\s+(?:part|property|attribute|slot|method)\b/iu.exec(value)?.[1]??null}function reviewedDeprecation(normalizations,section,member,upstreamDeprecated,upstreamReplacement,targetDeprecated,targetReplacement){return(normalizations.deprecationEquivalences??[]).some(entry=>entry.section===section&&entry.member===member&&entry.upstreamDeprecated===upstreamDeprecated&&entry.upstreamReplacement===upstreamReplacement&&entry.targetDeprecated===targetDeprecated&&entry.targetReplacement===targetReplacement)}function rewriteDeprecationReplacement(replacement,rewrites){if(replacement===null)return null;const assignment=/^([a-z][a-z0-9-]*)(=.*)$/iu.exec(replacement);return assignment?`${rewrites.get(assignment[1])||assignment[1]}${assignment[2]}`:rewrites.get(replacement)||replacement}function reviewedDerivedDefault(normalizations,memberKind,member,upstreamDefault,candidate){return candidate.hasDefault?!1:(normalizations.derivedDefaultEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamDefault)}function containsTypePositionKeyword(type,keyword){if(typeof type!="string")return!1;let quote=null;for(let index=0;index<type.length;){const character=type[index];if(quote){if(character==="\\"){index+=2;continue}character===quote&&(quote=null),index++;continue}if(character==="'"||character==='"'||character==="`"){quote=character,index++;continue}if(/[A-Za-z_$]/u.test(character)){let end=index+1;for(;end<type.length&&/[A-Za-z0-9_$]/u.test(type[end]);)end++;if(type.slice(index,end)===keyword){let next=end;for(;next<type.length&&/\s/u.test(type[next]);)next++;if(type[next]==="?")for(next++;next<type.length&&/\s/u.test(type[next]);)next++;if(type[next]!==":"&&type[next]!=="(")return!0}index=end;continue}index++}return!1}function containsAnyTypeKeyword(type){return containsTypePositionKeyword(type,"any")}function containsUnknownTypeKeyword(type){return containsTypePositionKeyword(type,"unknown")}function containsTemplateInterpolation(type){return typeof type=="string"&&type.includes("${")}function structuralTypeAliasMap(normalizations){return new Map((normalizations?.structuralTypeAliases??[]).filter(entry=>typeof entry?.name=="string"&&typeof entry.target=="string").map(entry=>[entry.name,entry.target]))}function typeContainsIdentifier(type,identifier){return typeof type!="string"?!1:new RegExp(`(^|[^A-Za-z0-9_$])${identifier.replace(/[.*+?^${}()|[\]\\]/gu,"\\$&")}([^A-Za-z0-9_$]|$)`,"u").test(type)}function expandStructuralTypeAliases(type,normalizations,resolving=new Set){if(typeof type!="string")return type;const aliases=structuralTypeAliasMap(normalizations);if(aliases.size===0)return type;let expanded="",quote=null;for(let index=0;index<type.length;){const character=type[index];if(quote){if(expanded+=character,character==="\\"&&index+1<type.length){expanded+=type[index+1],index+=2;continue}character===quote&&(quote=null),index+=1;continue}if(character==="'"||character==='"'||character==="`"){quote=character,expanded+=character,index+=1;continue}if(/[A-Za-z_$]/u.test(character)){let end=index+1;for(;end<type.length&&/[A-Za-z0-9_$]/u.test(type[end]);)end+=1;const identifier=type.slice(index,end),target=aliases.get(identifier);typeof target=="string"&&!resolving.has(identifier)?expanded+=expandStructuralTypeAliases(target,normalizations,new Set([...resolving,identifier])):expanded+=identifier,index=end;continue}expanded+=character,index+=1}return expanded}function reviewedTypeEquivalent(normalizations,memberKind,member,upstreamType,targetType){return containsAnyTypeKeyword(upstreamType)||containsAnyTypeKeyword(targetType)||memberKind==="event"&&(isUnknownEventType(upstreamType)||isUnknownEventType(targetType)||isBareCustomEventType(targetType))?!1:(normalizations.typeEquivalences??[]).some(entry=>entry.memberKind===memberKind&&entry.member===member&&entry.upstream===upstreamType&&entry.target===targetType)}function reviewedMethodParameterTypeEquivalent(normalizations,method,parameter,upstreamType,targetType){return typeof upstreamType!="string"||typeof targetType!="string"||containsAnyTypeKeyword(upstreamType)||containsAnyTypeKeyword(targetType)||containsUnknownTypeKeyword(upstreamType)||containsUnknownTypeKeyword(targetType)||containsTemplateInterpolation(upstreamType)||containsTemplateInterpolation(targetType)?!1:(normalizations.methodParameterTypeEquivalences??[]).some(entry=>entry.method===method&&entry.parameter===parameter&&entry.upstream===upstreamType&&entry.target===targetType)}function reviewedCancelability(normalizations,event,upstreamCancelable,targetCancelable){const upstreamRank=CANCELABILITY_RANK.get(upstreamCancelable),targetRank=CANCELABILITY_RANK.get(targetCancelable);if(upstreamRank===void 0||targetRank===void 0)return!1;const matches=entry=>entry.event===event&&entry.upstream===upstreamCancelable&&entry.target===targetCancelable;return targetRank>upstreamRank?(normalizations.cancelabilityEquivalences??[]).some(matches):upstreamCancelable==="always"&&targetCancelable==="conditional"&&(normalizations.cancelabilityPathAdditions??[]).some(matches)}function insertionPreservesDefault(rewrites,memberKind,member,upstreamDefault){return(rewrites.defaults??[]).some(rule=>rule.action==="insert-if-absent"&&rule.memberKind===memberKind&&rule.member===member&&rule.value===upstreamDefault)}function mappedPublicType(type,upstreamPrefix){if(typeof type!="string")return type;const sourcePrefix=upstreamPrefix==="wa-"?"Wa":upstreamPrefix==="sl-"?"Sl":null;return sourcePrefix?type.replace(new RegExp(`\\b${sourcePrefix}([A-Z][A-Za-z0-9_$]*)\\b`,"gu"),"Lyra$1"):type}function hasPublishedType(type){return!!type&&type!=="unknown"&&type!==UNSPECIFIED_PUBLIC_DOCUMENTATION}function splitTopLevelUnion(type){const tokens=[];let start=0,depth=0,quote=null;for(let index=0;index<type.length;index+=1){const character=type[index];if(quote){character===quote&&type[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if("([{<".includes(character))depth+=1;else if([")","]","}",">"].includes(character))depth=Math.max(0,depth-1);else if(character==="|"&&depth===0){const token2=type.slice(start,index).trim();token2&&tokens.push(token2),start=index+1}}const token=type.slice(start).trim();return token&&tokens.push(token),tokens}function normalizedTypeTokens(type){return typeof type!="string"?[]:splitTopLevelUnion(type.replace(/^\s*\|\s*/u,"").replace(/\s+/gu," ").trim())}function literalPrimitive(token){return/^(?:'[^']*'|"[^"]*"|`[^`]*`)$/u.test(token)?"string":/^-?(?:\d+(?:\.\d*)?|\.\d+)$/u.test(token)?"number":token==="true"||token==="false"?"boolean":null}function publicTypeCompatible(expected,actual){if(containsAnyTypeKeyword(expected)||containsAnyTypeKeyword(actual))return!1;const expectedTokens=normalizedTypeTokens(expected),actualTokens=normalizedTypeTokens(actual);if(expectedTokens.length===actualTokens.length){const actualSet2=new Set(actualTokens);if(expectedTokens.every(token=>actualSet2.has(token)))return!0}const actualSet=new Set(actualTokens);return expectedTokens.every(token=>{if(actualSet.has(token))return!0;const primitive=literalPrimitive(token);return!!(primitive&&actualSet.has(primitive)||token==="array"&&actualTokens.some(candidate=>/(?:\[\]|Array<.+>)$/u.test(candidate)))})}function canonicalEventType(type){if(typeof type!="string")return;const trimmed=type.trim(),detail=/^CustomEvent\s*</u.test(trimmed)&&trimmed.endsWith(">")?trimmed.slice(trimmed.indexOf("<")+1,-1).trim():trimmed;let canonical="",quote=null,escaped=!1,curlyDepth=0,angleDepth=0,squareDepth=0,parenDepth=0;for(const character of detail){if(quote){canonical+=character,escaped?escaped=!1:character==="\\"?escaped=!0:character===quote&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character,canonical+=character;continue}/\s/u.test(character)||(character==="{"?curlyDepth+=1:character==="}"?curlyDepth=Math.max(0,curlyDepth-1):character==="<"?angleDepth+=1:character===">"?angleDepth=Math.max(0,angleDepth-1):character==="["?squareDepth+=1:character==="]"?squareDepth=Math.max(0,squareDepth-1):character==="("?parenDepth+=1:character===")"&&(parenDepth=Math.max(0,parenDepth-1)),character===","&&curlyDepth>0&&angleDepth===0&&squareDepth===0&&parenDepth===0?canonical+=";":canonical+=character)}return canonical.replace(/\bvoid\b/gu,"undefined").replace(/;\}/gu,"}")}function stripBalancedOuterParentheses(type){let text=type.trim();for(;text.startsWith("(")&&text.endsWith(")");){let depth=0,quote=null,closesAtEnd=!1;for(let index=0;index<text.length;index+=1){const character=text[index];if(quote){character===quote&&text[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if(character==="(")depth+=1;else if(character===")"&&(depth-=1,depth===0)){closesAtEnd=index===text.length-1;break}}if(!closesAtEnd)break;text=text.slice(1,-1).trim()}return text}function customEventDetailType(type){const text=type.trim(),opening=/^CustomEvent\s*</u.exec(text);if(!opening)return;const start=opening[0].lastIndexOf("<");let depth=0,quote=null;for(let index=start;index<text.length;index+=1){const character=text[index];if(quote){character===quote&&text[index-1]!=="\\"&&(quote=null);continue}if(character==="'"||character==='"'||character==="`"){quote=character;continue}if(character==="<")depth+=1;else if(character===">"&&(depth-=1,depth===0))return text.slice(index+1).trim()===""?text.slice(start+1,index).trim():void 0}}function hasTopLevelUnknown(type){return splitTopLevelUnion(stripBalancedOuterParentheses(type)).includes("unknown")}function isUnknownEventType(type){if(typeof type!="string")return!1;const trimmed=stripBalancedOuterParentheses(type);if(hasTopLevelUnknown(trimmed))return!0;const detail=customEventDetailType(trimmed);return detail!==void 0&&hasTopLevelUnknown(detail)}function isBareCustomEventType(type){return typeof type=="string"&&/^CustomEvent\s*$/u.test(type.trim())}function eventTypeCompatible(expected,actual,normalizations={}){if(actual=expandStructuralTypeAliases(actual,normalizations),!hasPublishedType(expected)||!hasPublishedType(actual)||containsAnyTypeKeyword(expected)||containsAnyTypeKeyword(actual)||isUnknownEventType(expected)||isUnknownEventType(actual)||isBareCustomEventType(actual))return!1;const expectedCustom=/^CustomEvent\s*</u.test(expected.trim()),actualCustom=/^CustomEvent\s*</u.test(actual.trim());return expectedCustom!==actualCustom&&eventConstructor(expectedCustom?actual:expected)!==void 0?!1:canonicalEventType(expected)===canonicalEventType(actual)}function parametersMatch(expected,actual,upstreamPrefix,method,normalizations){const expectedParameters=expected??[],actualParameters=actual??[];return actualParameters.length<expectedParameters.length||!expectedParameters.every((parameter,index)=>{const candidate=actualParameters[index];return!candidate||parameter.name!==candidate.name||parameter.type!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&mappedPublicType(parameter.type,upstreamPrefix)!==candidate.type&&!reviewedMethodParameterTypeEquivalent(normalizations,method,parameter.name,parameter.type,candidate.type)||(parameter.optional||parameter.hasDefault)&&!(candidate.optional||candidate.hasDefault)?!1:!parameter.hasDefault||candidate.hasDefault&&parameter.default===candidate.default})?!1:actualParameters.slice(expectedParameters.length).every(parameter=>parameter.optional||parameter.hasDefault)}function overloadMatches(method,expected,actual,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified=!1){return parametersMatch(expected.parameters,actual.parameters,upstreamPrefix,method,normalizations)&&(expected.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION||unknownReturnTypeIsUnspecified&&expected.returnType==="unknown"||mappedPublicType(expected.returnType,upstreamPrefix)===actual.returnType)}function methodOverloadsMatch(method,expected,actual,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified=!1){return(expected??[]).every(overload=>(actual??[]).some(candidate=>overloadMatches(method,overload,candidate,upstreamPrefix,normalizations,unknownReturnTypeIsUnspecified)))}function compareMappedSurfaces(upstream,target,{upstreamPrefix,rewrites={},normalizations={}}={}){const drift=[],attributeRewrites=new Map((rewrites.attributes??[]).map(entry=>[entry.from,entry.to])),propertyRewrites=new Map((rewrites.properties??[]).map(entry=>[entry.from,entry.to])),eventRewrites=new Map((rewrites.events??[]).map(entry=>[entry.from,entry.to])),methodRewrites=new Map((rewrites.methods??[]).map(entry=>[entry.from,entry.to])),sectionDeprecationRewrites=new Map([["attributes",attributeRewrites],["properties",propertyRewrites],["events",eventRewrites],["methods",methodRewrites],["staticProperties",new Map],["staticMethods",new Map],["moduleExports",new Map],...["slots","parts","cssProperties","cssStates"].map(section=>[section,new Map((rewrites[section]??[]).map(entry=>[entry.from,entry.to]))])]),unknownMethodReturnTypes=new Set((normalizations.unknownMethodReturnTypes??[]).map(entry=>entry.method)),inferredAttributeSuppressions=new Map((normalizations.inferredAttributeSuppressions??[]).map(entry=>[entry.attribute,entry])),suppressionRequiredProperties=new Set,excludedAttributeProperties=new Set((upstream.attributes??[]).filter(attribute=>Object.hasOwn(MIGRATION_ATTRIBUTE_EXCLUSIONS,attribute.name)).map(attribute=>attribute.property).filter(Boolean)),compareDeprecation=(section,upstreamMember,targetMember)=>{const upstreamDeprecated=!!upstreamMember.deprecated,targetDeprecated=!!targetMember.deprecated,upstreamReplacement=deprecationReplacement(upstreamMember.deprecated),targetReplacement=deprecationReplacement(targetMember.deprecated),expectedReplacement=rewriteDeprecationReplacement(upstreamReplacement,sectionDeprecationRewrites.get(section)??new Map);(upstreamDeprecated!==targetDeprecated||upstreamDeprecated&&targetDeprecated&&expectedReplacement!==targetReplacement)&&!reviewedDeprecation(normalizations,section,upstreamMember.name,upstreamDeprecated,upstreamReplacement,targetDeprecated,targetReplacement)&&drift.push({code:upstreamDeprecated===targetDeprecated?"deprecation-replacement-mismatch":"deprecation-mismatch",section,member:upstreamMember.name,expected:upstreamDeprecated?expectedReplacement??!0:!1,actual:targetDeprecated?targetReplacement??!0:!1})};for(const attribute of upstream.attributes??[]){if(Object.hasOwn(MIGRATION_ATTRIBUTE_EXCLUSIONS,attribute.name))continue;const suppression=inferredAttributeSuppressions.get(attribute.name),requiredProperty=suppression?.property;if(requiredProperty&&(attribute.inferred===!0||suppression.explicit===!0)){suppressionRequiredProperties.add(requiredProperty),(target.properties??[]).some(property=>property.name===requiredProperty)||pushMissing(drift,"missing-property","properties",requiredProperty);continue}const expectedName=attributeRewrites.get(attribute.name)||attribute.name,candidate=(target.attributes??[]).find(entry=>entry.name===expectedName);if(!candidate){const opposite=(target.attributes??[]).find(entry=>polarityStem(entry.name)===polarityStem(expectedName)&&polarity(entry.name)!==polarity(expectedName));opposite?drift.push({code:"polarity-mismatch",section:"attributes",member:attribute.name,expected:expectedName,actual:opposite.name}):pushMissing(drift,"missing-attribute","attributes",attribute.name);continue}const expectedType=mappedPublicType(attribute.type,upstreamPrefix);hasPublishedType(attribute.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"attribute",attribute.name,attribute.type,candidate.type)&&drift.push({code:"type-mismatch",section:"attributes",member:attribute.name,expected:expectedType,actual:candidate.type});const expectedProperty=propertyRewrites.get(attribute.property)||attribute.property;expectedProperty!==candidate.property&&!reviewedAttributeProperty(normalizations,attribute.name,attribute.property,candidate.property)&&drift.push({code:"attribute-property-mismatch",section:"attributes",member:attribute.name,expected:expectedProperty,actual:candidate.property}),attribute.reflects!==candidate.reflects&&!reviewedReflection(normalizations,"attribute",attribute.name,attribute.reflects,candidate.reflects)&&drift.push({code:"reflection-mismatch",section:"attributes",member:attribute.name,expected:attribute.reflects,actual:hasOwn(candidate,"reflects")?candidate.reflects:null});const expectedDefault=normalizedExpectedDefault(normalizations,"attribute",attribute.name,attribute.default);attribute.hasDefault&&(!candidate.hasDefault||candidate.default!==expectedDefault)&&!reviewedDerivedDefault(normalizations,"attribute",attribute.name,attribute.default,candidate)&&!insertionPreservesDefault(rewrites,"attribute",attribute.name,expectedDefault)&&drift.push({code:"default-mismatch",section:"attributes",member:attribute.name,expected:expectedDefault,actual:candidate.hasDefault?candidate.default:null}),compareDeprecation("attributes",attribute,candidate)}for(const property of upstream.properties??[]){if(excludedAttributeProperties.has(property.name))continue;const expectedName=propertyRewrites.get(property.name)||property.name,candidate=(target.properties??[]).find(entry=>entry.name===expectedName);if(!(!candidate&&suppressionRequiredProperties.has(expectedName))){if((upstream.attributes??[]).some(attribute=>attribute.property===property.name)){candidate?property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"readonly-mismatch",section:"properties",member:property.name,expected:property.readonly,actual:hasOwn(candidate,"readonly")?candidate.readonly:null}):pushMissing(drift,"missing-property","properties",property.name),candidate&&compareDeprecation("properties",property,candidate);continue}if(!candidate)pushMissing(drift,"missing-property","properties",property.name);else{const expectedType=mappedPublicType(property.type,upstreamPrefix);hasPublishedType(property.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"property",property.name,property.type,candidate.type)&&drift.push({code:"type-mismatch",section:"properties",member:property.name,expected:expectedType,actual:candidate.type}),property.reflects!==candidate.reflects&&!reviewedReflection(normalizations,"property",property.name,property.reflects,candidate.reflects)&&drift.push({code:"reflection-mismatch",section:"properties",member:property.name,expected:property.reflects,actual:hasOwn(candidate,"reflects")?candidate.reflects:null}),property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"readonly-mismatch",section:"properties",member:property.name,expected:property.readonly,actual:hasOwn(candidate,"readonly")?candidate.readonly:null});const expectedDefault=normalizedExpectedDefault(normalizations,"property",property.name,property.default);if(compareDeprecation("properties",property,candidate),!property.hasDefault||candidate.hasDefault&&candidate.default===expectedDefault||reviewedDerivedDefault(normalizations,"property",property.name,property.default,candidate)||insertionPreservesDefault(rewrites,"property",property.name,expectedDefault))continue;drift.push({code:"default-mismatch",section:"properties",member:property.name,expected:expectedDefault,actual:candidate.hasDefault?candidate.default:null})}}}for(const property of upstream.staticProperties??[]){const candidate=(target.staticProperties??[]).find(entry=>entry.name===property.name);if(!candidate){pushMissing(drift,"missing-static-property","staticProperties",property.name);continue}const expectedType=mappedPublicType(property.type,upstreamPrefix);hasPublishedType(property.type)&&!publicTypeCompatible(expectedType,candidate.type)&&!reviewedTypeEquivalent(normalizations,"staticProperty",property.name,property.type,candidate.type)&&drift.push({code:"static-property-type-mismatch",section:"staticProperties",member:property.name,expected:expectedType,actual:candidate.type}),property.readonly===!1&&candidate.readonly!==!1&&drift.push({code:"static-property-readonly-mismatch",section:"staticProperties",member:property.name,expected:!1,actual:hasOwn(candidate,"readonly")?candidate.readonly:null}),compareDeprecation("staticProperties",property,candidate)}for(const[section,code]of[["slots","missing-slot"],["parts","missing-part"],["cssProperties","missing-css-property"],["cssStates","missing-css-state"]]){const targetEntries=new Map((target[section]??[]).map(entry=>[entry.name,entry])),sectionRewrites=new Map((rewrites[section]??[]).map(entry=>[entry.from,entry.to]));for(const entry of upstream[section]??[]){const expectedName=sectionRewrites.get(entry.name)||entry.name,candidate=targetEntries.get(expectedName);if(!candidate){pushMissing(drift,code,section,entry.name);continue}section==="cssProperties"&&!(entry.hasDefault===candidate.hasDefault&&(!entry.hasDefault||entry.default===candidate.default))&&!reviewedCssDefault(normalizations,entry.name,entry,candidate)&&drift.push({code:"css-default-mismatch",section,member:entry.name,expectedHasDefault:entry.hasDefault,expected:entry.hasDefault?entry.default:null,actualHasDefault:candidate.hasDefault,actual:candidate.hasDefault?candidate.default:null}),compareDeprecation(section,entry,candidate)}}for(const method of upstream.methods??[]){const expectedName=methodRewrites.get(method.name)||method.name,candidate=(target.methods??[]).find(entry=>entry.name===expectedName);candidate?methodOverloadsMatch(method.name,method.overloads,candidate.overloads,upstreamPrefix,normalizations,unknownMethodReturnTypes.has(method.name))||drift.push({code:"method-signature-mismatch",section:"methods",member:method.name,expected:method.overloads,actual:candidate.overloads}):pushMissing(drift,"missing-method","methods",method.name),candidate&&compareDeprecation("methods",method,candidate)}for(const method of upstream.staticMethods??[]){const candidate=(target.staticMethods??[]).find(entry=>entry.name===method.name);candidate?methodOverloadsMatch(method.name,method.overloads,candidate.overloads,upstreamPrefix,normalizations)||drift.push({code:"static-method-signature-mismatch",section:"staticMethods",member:method.name,expected:method.overloads,actual:candidate.overloads}):pushMissing(drift,"missing-static-method","staticMethods",method.name),candidate&&compareDeprecation("staticMethods",method,candidate)}for(const exported of upstream.moduleExports??[]){const candidates=(target.moduleExports??[]).filter(entry=>entry.name===exported.name);if(candidates.length===0){drift.push({code:"missing-module-export",section:"moduleExports",member:exported.name,module:exported.module});continue}if(exported.kind==="unknown")continue;const sameKind=candidates.filter(entry=>entry.kind===exported.kind);if(sameKind.length===0){drift.push({code:"module-export-kind-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:exported.kind,actual:unique(candidates.map(entry=>entry.kind))});continue}exported.kind==="function"?sameKind.some(candidate=>methodOverloadsMatch(exported.name,exported.overloads,candidate.overloads,upstreamPrefix,normalizations))||drift.push({code:"module-export-signature-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:exported.overloads,actual:sameKind.map(candidate=>candidate.overloads)}):hasPublishedType(exported.type)&&!sameKind.some(candidate=>publicTypeCompatible(mappedPublicType(exported.type,upstreamPrefix),candidate.type)||reviewedTypeEquivalent(normalizations,"moduleExport",exported.name,exported.type,candidate.type))&&drift.push({code:"module-export-type-mismatch",section:"moduleExports",member:exported.name,module:exported.module,expected:mappedPublicType(exported.type,upstreamPrefix),actual:unique(sameKind.map(candidate=>candidate.type))})}for(const event of upstream.events??[]){const expectedName=eventRewrites.get(event.name)||mappedEventName(event.name,upstreamPrefix),candidate=(target.events??[]).find(entry=>entry.name===expectedName);if(!candidate)pushMissing(drift,"missing-event","events",event.name);else{const expectedType=mappedPublicType(event.type,upstreamPrefix);hasPublishedType(event.type)&&!eventTypeCompatible(expectedType,candidate.type,normalizations)&&!reviewedTypeEquivalent(normalizations,"event",event.name,event.type,candidate.type)&&drift.push({code:"event-type-mismatch",section:"events",member:event.name,expected:expectedType,actual:candidate.type}),event.cancelable!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&candidate.cancelable!==event.cancelable&&!reviewedCancelability(normalizations,event.name,event.cancelable,candidate.cancelable)&&drift.push({code:"cancelability-mismatch",section:"events",member:event.name,expected:event.cancelable,actual:candidate.cancelable});for(const[field,code]of[["constructor","event-constructor-mismatch"],["bubbles","event-bubbles-mismatch"],["composed","event-composed-mismatch"]])!hasOwn(event,field)||candidate[field]===event[field]||drift.push({code,section:"events",member:event.name,expected:event[field],actual:hasOwn(candidate,field)?candidate[field]:null});compareDeprecation("events",event,candidate)}}upstream.form?.associated&&!target.form?.associated&&drift.push({code:"form-association-mismatch",section:"form",member:"associated"});for(const property of upstream.form?.properties??[])(target.form?.properties??[]).includes(property)||pushMissing(drift,"missing-form-property","form",property);for(const method of upstream.form?.methods??[])(target.form?.methods??[]).includes(method)||pushMissing(drift,"missing-form-method","form",method);for(const event of upstream.native?.forwardedEvents??[])(target.native?.forwardedEvents??[]).includes(event)||pushMissing(drift,"missing-native-event","native",event);for(const method of upstream.native?.delegatedMethods??[])(target.native?.delegatedMethods??[]).includes(method)||pushMissing(drift,"missing-native-method","native",method);return drift.sort((a,b)=>`${a.section}:${a.member}:${a.code}`.localeCompare(`${b.section}:${b.member}:${b.code}`))}function validateSurface(surface,label,findings){if(!surface||typeof surface!="object"){findings.push(`${label}: missing normalized surface`);return}for(const section of SURFACE_SECTIONS)section==="form"||section==="native"?(!surface[section]||typeof surface[section]!="object")&&findings.push(`${label}: missing ${section} contract`):Array.isArray(surface[section])||findings.push(`${label}: ${section} must be an array`);for(const event of surface.events??[])["always","never","conditional",UNSPECIFIED_PUBLIC_DOCUMENTATION].includes(event.cancelable)||findings.push(`${label}: event ${event.name} has unreviewed cancelability`),hasOwn(event,"cancelabilityEvidence")&&(event.cancelable!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&event.cancelabilityEvidence==="pinned-runtime"||findings.push(`${label}: event ${event.name} has malformed cancelability evidence`));for(const method of surface.methods??[]){if(!hasOwn(method,"edgeSemantics"))continue;const edgeSemantics=method.edgeSemantics,caseNames=new Set;exactObjectKeys(edgeSemantics,["evidence","cases"])&&edgeSemantics.evidence==="pinned-runtime"&&Array.isArray(edgeSemantics.cases)&&edgeSemantics.cases.length>0&&edgeSemantics.cases.every(entry=>!exactObjectKeys(entry,["case","arguments","outcome"])||typeof entry.case!="string"||!entry.case.trim()||caseNames.has(entry.case)||!Array.isArray(entry.arguments)||!entry.arguments.every(argument=>typeof argument=="string"&&!!argument.trim())||!validMethodEdgeOutcome(entry.outcome)?!1:(caseNames.add(entry.case),!0))||findings.push(`${label}: method ${method.name} has malformed edge-semantics evidence`)}}function validateRewrites(mapping,findings){if(!mapping.rewrites||typeof mapping.rewrites!="object"){findings.push(`${mapping.upstreamTag}: missing deterministic rewrite contract`);return}for(const section of REWRITE_RULE_SECTIONS)Array.isArray(mapping.rewrites[section])||findings.push(`${mapping.upstreamTag}: rewrites.${section} must be an array`);for(const section of Object.keys(mapping.rewrites))REWRITE_RULE_SECTIONS.includes(section)||findings.push(`${mapping.upstreamTag}: unknown rewrite section ${section}`);for(const section of REWRITE_RULE_SECTIONS.filter(name=>name!=="defaults")){const seen=new Set;for(const rule of mapping.rewrites[section]??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!rule||typeof rule.from!="string"||!rule.from||typeof rule.to!="string"||!rule.to||keys.some(key=>key!=="from"&&key!=="to")){findings.push(`${mapping.upstreamTag}: invalid rewrites.${section} rule`);continue}rule.from===rule.to&&findings.push(`${mapping.upstreamTag}: identity rewrites.${section} rule`),seen.has(rule.from)&&findings.push(`${mapping.upstreamTag}: duplicate rewrites.${section} source ${rule.from}`),seen.add(rule.from)}}const seenDefaults=new Set;for(const rule of mapping.rewrites.defaults??[]){const action=rule?.action,allowedKeys=action==="insert-if-absent"?new Set(["memberKind","member","action","value"]):action==="replace-value"?new Set(["memberKind","member","action","from","to"]):new Set,keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&allowedKeys.size>0&&keys.every(key2=>allowedKeys.has(key2))&&(action==="insert-if-absent"?rule.memberKind==="attribute"&&Object.hasOwn(rule,"value")&&(rule.value===null||["string","boolean"].includes(typeof rule.value)||typeof rule.value=="number"&&Number.isFinite(rule.value)):Object.hasOwn(rule,"from")&&Object.hasOwn(rule,"to")&&rule.from!==rule.to&&[rule.from,rule.to].every(value=>value===null||["string","boolean"].includes(typeof value)||typeof value=="number"&&Number.isFinite(value))))){findings.push(`${mapping.upstreamTag}: invalid rewrites.defaults rule`);continue}const key=`${rule.memberKind}:${rule.member}:${action}`;seenDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate rewrites.defaults rule ${key}`),seenDefaults.add(key)}}function validateDefaultRewriteSemantics(mapping,{upstream,target}={}){const findings=[];for(const rule of mapping.rewrites?.defaults??[]){if(rule?.action!=="insert-if-absent")continue;const section=rule.memberKind==="attribute"?"attributes":"properties",sourceMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);sourceMember?(!sourceMember.hasDefault||sourceMember.default!==rule.value)&&findings.push(`${mapping.upstreamTag}: stale upstream default rewrite ${rule.memberKind}:${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling upstream default rewrite ${rule.memberKind}:${rule.member}`),targetMember?targetMember.hasDefault&&targetMember.default===rule.value&&findings.push(`${mapping.upstreamTag}: stale target default rewrite ${rule.memberKind}:${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling target default rewrite ${rule.memberKind}:${rule.member}`)}return findings}function isReviewedScalar(value){return value===null||typeof value=="string"||typeof value=="boolean"||typeof value=="number"&&Number.isFinite(value)}function validateMappingNormalizations(mapping,{upstream,target}={}){const findings=[],normalizations=mapping.normalizations;if(normalizations===void 0)return findings;if(!normalizations||typeof normalizations!="object"||Array.isArray(normalizations))return[`${mapping.upstreamTag}: normalizations must be an object`];for(const section of NORMALIZATION_SECTIONS)Array.isArray(normalizations[section])||findings.push(`${mapping.upstreamTag}: normalizations.${section} must be an array`);for(const section of Object.keys(normalizations))NORMALIZATION_SECTIONS.includes(section)||findings.push(`${mapping.upstreamTag}: unknown normalization section ${section}`);const attributeRewrites=new Map((mapping.rewrites?.attributes??[]).map(entry=>[entry.from,entry.to])),propertyRewrites=new Map((mapping.rewrites?.properties??[]).map(entry=>[entry.from,entry.to])),seenAttributeProperties=new Set;for(const rule of normalizations.attributePropertyEquivalences??[]){if(!(typeof rule?.attribute=="string"&&!!rule.attribute&&typeof rule.upstream=="string"&&!!rule.upstream&&typeof rule.target=="string"&&!!rule.target&&Object.keys(rule).length===3)){findings.push(`${mapping.upstreamTag}: invalid normalizations.attributePropertyEquivalences rule`);continue}seenAttributeProperties.has(rule.attribute)&&findings.push(`${mapping.upstreamTag}: duplicate attribute-property normalization ${rule.attribute}`),seenAttributeProperties.add(rule.attribute);const source=(upstream?.attributes??[]).find(entry=>entry.name===rule.attribute),targetName=attributeRewrites.get(rule.attribute)||rule.attribute,candidate=(target?.attributes??[]).find(entry=>entry.name===targetName);source?source.property!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream attribute-property normalization ${rule.attribute}`):findings.push(`${mapping.upstreamTag}: dangling upstream attribute-property normalization ${rule.attribute}`),candidate?candidate.property!==rule.target?findings.push(`${mapping.upstreamTag}: stale target attribute-property normalization ${rule.attribute}`):(propertyRewrites.get(rule.upstream)||rule.upstream)===rule.target&&findings.push(`${mapping.upstreamTag}: stale equivalent attribute-property normalization ${rule.attribute}`):findings.push(`${mapping.upstreamTag}: dangling target attribute-property normalization ${rule.attribute}`)}const seenReflections=new Set;for(const rule of normalizations.reflectionEquivalences??[]){if(!(["attribute","property"].includes(rule?.memberKind)&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstream=="boolean"&&typeof rule.target=="boolean"&&rule.upstream!==rule.target&&Object.keys(rule).length===4)){findings.push(`${mapping.upstreamTag}: invalid normalizations.reflectionEquivalences rule`);continue}const key=`${rule.memberKind}:${rule.member}`;seenReflections.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate reflection normalization ${key}`),seenReflections.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",rewrites=rule.memberKind==="attribute"?attributeRewrites:propertyRewrites,source=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),candidate=(target?.[section]??[]).find(entry=>entry.name===(rewrites.get(rule.member)||rule.member));source?source.reflects!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream reflection normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream reflection normalization ${key}`),candidate?candidate.reflects!==rule.target&&findings.push(`${mapping.upstreamTag}: stale target reflection normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target reflection normalization ${key}`)}const seenCssDefaults=new Set;for(const rule of normalizations.cssDefaultEquivalences??[]){const expectedKeys=new Set(["member","upstreamHasDefault","targetHasDefault"]);rule?.upstreamHasDefault===!0&&expectedKeys.add("upstream"),rule?.targetHasDefault===!0&&expectedKeys.add("target");const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.member=="string"&&!!rule.member&&typeof rule.upstreamHasDefault=="boolean"&&typeof rule.targetHasDefault=="boolean"&&(rule.upstreamHasDefault!==!0||isReviewedScalar(rule.upstream))&&(rule.targetHasDefault!==!0||isReviewedScalar(rule.target))&&keys.length===expectedKeys.size&&keys.every(key=>expectedKeys.has(key))&&(rule.upstreamHasDefault!==rule.targetHasDefault||rule.upstreamHasDefault&&rule.upstream!==rule.target))){findings.push(`${mapping.upstreamTag}: invalid normalizations.cssDefaultEquivalences rule`);continue}seenCssDefaults.has(rule.member)&&findings.push(`${mapping.upstreamTag}: duplicate CSS-default normalization ${rule.member}`),seenCssDefaults.add(rule.member);const source=(upstream?.cssProperties??[]).find(entry=>entry.name===rule.member),targetName=new Map((mapping.rewrites?.cssProperties??[]).map(entry=>[entry.from,entry.to])).get(rule.member)||rule.member,candidate=(target?.cssProperties??[]).find(entry=>entry.name===targetName);source?(source.hasDefault!==rule.upstreamHasDefault||rule.upstreamHasDefault&&source.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream CSS-default normalization ${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling upstream CSS-default normalization ${rule.member}`),candidate?(candidate.hasDefault!==rule.targetHasDefault||rule.targetHasDefault&&candidate.default!==rule.target)&&findings.push(`${mapping.upstreamTag}: stale target CSS-default normalization ${rule.member}`):findings.push(`${mapping.upstreamTag}: dangling target CSS-default normalization ${rule.member}`)}const seenDeprecations=new Set;for(const rule of normalizations.deprecationEquivalences??[]){if(!(["attributes","properties","slots","events","parts","cssProperties","cssStates","methods","staticProperties","staticMethods","moduleExports"].includes(rule?.section)&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstreamDeprecated=="boolean"&&(rule.upstreamReplacement===null||typeof rule.upstreamReplacement=="string")&&typeof rule.targetDeprecated=="boolean"&&(rule.targetReplacement===null||typeof rule.targetReplacement=="string")&&Object.keys(rule).length===6)){findings.push(`${mapping.upstreamTag}: invalid normalizations.deprecationEquivalences rule`);continue}const key=`${rule.section}:${rule.member}`;seenDeprecations.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate deprecation normalization ${key}`),seenDeprecations.add(key);const sectionRewrites=new Map((mapping.rewrites?.[rule.section]??[]).map(entry=>[entry.from,entry.to])),targetName=sectionRewrites.get(rule.member)||rule.member,source=(upstream?.[rule.section]??[]).find(entry=>entry.name===rule.member),candidate=(target?.[rule.section]??[]).find(entry=>entry.name===targetName);if(!source){findings.push(`${mapping.upstreamTag}: dangling upstream deprecation normalization ${key}`);continue}if(!candidate){findings.push(`${mapping.upstreamTag}: dangling target deprecation normalization ${key}`);continue}const sourceDeprecated=!!source.deprecated,sourceReplacement=deprecationReplacement(source.deprecated),targetDeprecated=!!candidate.deprecated,targetReplacement=deprecationReplacement(candidate.deprecated);(sourceDeprecated!==rule.upstreamDeprecated||sourceReplacement!==rule.upstreamReplacement)&&findings.push(`${mapping.upstreamTag}: stale upstream deprecation normalization ${key}`),(targetDeprecated!==rule.targetDeprecated||targetReplacement!==rule.targetReplacement)&&findings.push(`${mapping.upstreamTag}: stale target deprecation normalization ${key}`);const expectedReplacement=rewriteDeprecationReplacement(sourceReplacement,sectionRewrites);sourceDeprecated===targetDeprecated&&expectedReplacement===targetReplacement&&findings.push(`${mapping.upstreamTag}: stale equivalent deprecation normalization ${key}`)}const seenStructuralAliases=new Set,structuralAliasRules=new Map;for(const rule of normalizations.structuralTypeAliases??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.name=="string"&&/^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(rule.name)&&typeof rule.target=="string"&&!!rule.target.trim()&&!containsAnyTypeKeyword(rule.target)&&!containsUnknownTypeKeyword(rule.target)&&!containsTemplateInterpolation(rule.target)&&keys.length===2&&keys.every(key=>key==="name"||key==="target"))){findings.push(`${mapping.upstreamTag}: invalid normalizations.structuralTypeAliases rule`);continue}seenStructuralAliases.has(rule.name)&&findings.push(`${mapping.upstreamTag}: duplicate structural type alias ${rule.name}`),seenStructuralAliases.add(rule.name),structuralAliasRules.set(rule.name,rule.target)}const reachableStructuralAliases=new Set,visitStructuralAlias=(name,trail=new Set)=>{if(trail.has(name)){findings.push(`${mapping.upstreamTag}: cyclic structural type alias ${name}`);return}if(reachableStructuralAliases.has(name))return;const targetType=structuralAliasRules.get(name);if(targetType===void 0)return;reachableStructuralAliases.add(name);const nextTrail=new Set([...trail,name]);for(const candidate of structuralAliasRules.keys())typeContainsIdentifier(targetType,candidate)&&visitStructuralAlias(candidate,nextTrail)};for(const event of target?.events??[])for(const name of structuralAliasRules.keys())typeContainsIdentifier(event.type,name)&&visitStructuralAlias(name);for(const name of structuralAliasRules.keys())reachableStructuralAliases.has(name)||findings.push(`${mapping.upstreamTag}: stale structural type alias ${name}`);const seenTypes=new Set;for(const rule of normalizations.typeEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property"||rule?.memberKind==="event"||rule?.memberKind==="staticProperty"||rule?.memberKind==="moduleExport")&&typeof rule.member=="string"&&!!rule.member&&typeof rule.upstream=="string"&&!!rule.upstream&&typeof rule.target=="string"&&!!rule.target&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.typeEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);(containsAnyTypeKeyword(rule.upstream)||containsAnyTypeKeyword(rule.target)||rule.memberKind==="event"&&isBareCustomEventType(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe any type normalization ${key}`),rule.memberKind==="event"&&(isUnknownEventType(rule.upstream)||isUnknownEventType(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe unknown event type normalization ${key}`),seenTypes.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.typeEquivalences rule ${key}`),seenTypes.add(key);const section=rule.memberKind==="attribute"?"attributes":rule.memberKind==="property"?"properties":rule.memberKind==="event"?"events":rule.memberKind==="staticProperty"?"staticProperties":"moduleExports",rewrites=new Map((mapping.rewrites?.[section]??[]).map(entry=>[entry.from,entry.to])),upstreamPrefix=mapping.upstreamTag?.startsWith("wa-")?"wa-":"sl-",targetName=rewrites.get(rule.member)||(rule.memberKind==="event"?mappedEventName(rule.member,upstreamPrefix):rule.member),upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===targetName);rule.memberKind==="property"&&(upstream?.attributes??[]).some(attribute=>attribute.property===rule.member)&&findings.push(`${mapping.upstreamTag}: unreachable property type normalization ${key}`),upstreamMember?(!hasPublishedType(upstreamMember.type)||upstreamMember.type!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream type normalization ${key}`),targetMember?targetMember.type!==rule.target?findings.push(`${mapping.upstreamTag}: stale target type normalization ${key}`):upstreamMember&&hasPublishedType(upstreamMember.type)&&(rule.memberKind==="event"?eventTypeCompatible(mappedPublicType(upstreamMember.type,upstreamPrefix),targetMember.type,normalizations):publicTypeCompatible(mappedPublicType(upstreamMember.type,upstreamPrefix),targetMember.type))&&findings.push(`${mapping.upstreamTag}: stale compatible type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target type normalization ${key}`)}const methodRewrites=new Map((mapping.rewrites?.methods??[]).map(entry=>[entry.from,entry.to])),seenMethodParameters=new Set;for(const rule of normalizations.methodParameterTypeEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.method=="string"&&!!rule.method.trim()&&typeof rule.parameter=="string"&&!!rule.parameter.trim()&&typeof rule.upstream=="string"&&!!rule.upstream.trim()&&rule.upstream!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&typeof rule.target=="string"&&!!rule.target.trim()&&rule.target!==UNSPECIFIED_PUBLIC_DOCUMENTATION&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["method","parameter","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.methodParameterTypeEquivalences rule`);continue}const key=`${rule.method}:${rule.parameter}`;seenMethodParameters.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.methodParameterTypeEquivalences rule ${key}`),seenMethodParameters.add(key),(containsAnyTypeKeyword(rule.upstream)||containsAnyTypeKeyword(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe any method-parameter type normalization ${key}`),(containsUnknownTypeKeyword(rule.upstream)||containsUnknownTypeKeyword(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe unknown method-parameter type normalization ${key}`),(containsTemplateInterpolation(rule.upstream)||containsTemplateInterpolation(rule.target))&&findings.push(`${mapping.upstreamTag}: unsafe template interpolation method-parameter type normalization ${key}`);const upstreamMethod=(upstream?.methods??[]).find(entry=>entry.name===rule.method),targetMethodName=methodRewrites.get(rule.method)||rule.method,targetMethod=(target?.methods??[]).find(entry=>entry.name===targetMethodName),upstreamParameters=(upstreamMethod?.overloads??[]).flatMap(overload=>overload.parameters??[]),targetParameters=(targetMethod?.overloads??[]).flatMap(overload=>overload.parameters??[]),upstreamParameter=upstreamParameters.find(entry=>entry.name===rule.parameter),targetParameter=targetParameters.find(entry=>entry.name===rule.parameter);upstreamMethod?upstreamParameter?upstreamParameter.type!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream method-parameter type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream method parameter normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream method-parameter type normalization ${key}`),targetMethod?targetParameter?targetParameter.type!==rule.target?findings.push(`${mapping.upstreamTag}: stale target method-parameter type normalization ${key}`):mappedPublicType(rule.upstream,mapping.upstreamTag?.startsWith("wa-")?"wa-":"sl-")===targetParameter.type&&findings.push(`${mapping.upstreamTag}: stale compatible method-parameter type normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target method parameter normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target method-parameter type normalization ${key}`)}const seenDefaults=new Set;for(const rule of normalizations.defaultEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&Object.hasOwn(rule,"upstream")&&Object.hasOwn(rule,"target")&&isReviewedScalar(rule.upstream)&&isReviewedScalar(rule.target)&&rule.upstream!==rule.target&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.defaultEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);seenDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.defaultEquivalences rule ${key}`),seenDefaults.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);upstreamMember?(!upstreamMember.hasDefault||upstreamMember.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale upstream default normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling upstream normalization member ${key}`),targetMember?(!targetMember.hasDefault||targetMember.default!==rule.target)&&findings.push(`${mapping.upstreamTag}: stale target default normalization ${key}`):findings.push(`${mapping.upstreamTag}: dangling target normalization member ${key}`)}const seenAttributes=new Set,seenProperties=new Set;for(const rule of normalizations.inferredAttributeSuppressions??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.attribute=="string"&&!!rule.attribute&&typeof rule.property=="string"&&!!rule.property&&(rule.explicit===void 0||rule.explicit===!0)&&keys.every(key=>key==="attribute"||key==="property"||key==="explicit"))){findings.push(`${mapping.upstreamTag}: invalid normalizations.inferredAttributeSuppressions rule`);continue}(seenAttributes.has(rule.attribute)||seenProperties.has(rule.property))&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.inferredAttributeSuppressions rule ${rule.attribute}:${rule.property}`),seenAttributes.add(rule.attribute),seenProperties.add(rule.property);const upstreamAttribute=(upstream?.attributes??[]).find(entry=>entry.name===rule.attribute),upstreamProperty=(upstream?.properties??[]).find(entry=>entry.name===rule.property),targetAttribute=(target?.attributes??[]).find(entry=>entry.name===rule.attribute),targetProperty=(target?.properties??[]).find(entry=>entry.name===rule.property);upstreamAttribute?(upstreamAttribute.inferred!==!0&&rule.explicit!==!0&&findings.push(`${mapping.upstreamTag}: cannot suppress explicit upstream attribute ${rule.attribute}`),upstreamAttribute.inferred===!0&&rule.explicit===!0&&findings.push(`${mapping.upstreamTag}: stale explicit attribute suppression ${rule.attribute}`),upstreamAttribute.property!==rule.property&&findings.push(`${mapping.upstreamTag}: stale inferred attribute property ${rule.attribute}:${rule.property}`)):findings.push(`${mapping.upstreamTag}: dangling inferred upstream attribute ${rule.attribute}`),upstreamProperty||findings.push(`${mapping.upstreamTag}: dangling inferred upstream property ${rule.property}`),targetProperty||findings.push(`${mapping.upstreamTag}: dangling inferred target property ${rule.property}`),targetAttribute&&findings.push(`${mapping.upstreamTag}: stale inferred attribute suppression ${rule.attribute}`)}const seenDerivedDefaults=new Set;for(const rule of normalizations.derivedDefaultEquivalences??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!((rule?.memberKind==="attribute"||rule?.memberKind==="property")&&typeof rule.member=="string"&&!!rule.member&&Object.hasOwn(rule,"upstream")&&Object.hasOwn(rule,"target")&&isReviewedScalar(rule.upstream)&&isReviewedScalar(rule.target)&&keys.length===4&&keys.every(key2=>["memberKind","member","upstream","target"].includes(key2)))){findings.push(`${mapping.upstreamTag}: invalid normalizations.derivedDefaultEquivalences rule`);continue}const key=normalizationKey(rule.memberKind,rule.member);seenDerivedDefaults.has(key)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.derivedDefaultEquivalences rule ${key}`),seenDerivedDefaults.add(key);const section=rule.memberKind==="attribute"?"attributes":"properties",upstreamMember=(upstream?.[section]??[]).find(entry=>entry.name===rule.member),targetMember=(target?.[section]??[]).find(entry=>entry.name===rule.member);upstreamMember?(!upstreamMember.hasDefault||upstreamMember.default!==rule.upstream)&&findings.push(`${mapping.upstreamTag}: stale derived upstream default ${key}`):findings.push(`${mapping.upstreamTag}: dangling derived-default upstream member ${key}`),targetMember?targetMember.hasDefault&&findings.push(`${mapping.upstreamTag}: stale derived target default ${key}`):findings.push(`${mapping.upstreamTag}: dangling derived-default target member ${key}`)}const seenMethods=new Set;for(const rule of normalizations.unknownMethodReturnTypes??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.method=="string"&&!!rule.method&&keys.length===1&&keys[0]==="method")){findings.push(`${mapping.upstreamTag}: invalid normalizations.unknownMethodReturnTypes rule`);continue}seenMethods.has(rule.method)&&findings.push(`${mapping.upstreamTag}: duplicate normalizations.unknownMethodReturnTypes rule ${rule.method}`),seenMethods.add(rule.method);const upstreamMethod=(upstream?.methods??[]).find(entry=>entry.name===rule.method),targetMethod=(target?.methods??[]).find(entry=>entry.name===rule.method);upstreamMethod?(upstreamMethod.overloads??[]).some(overload=>overload.returnType==="unknown"||overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)||findings.push(`${mapping.upstreamTag}: stale unknown-return normalization ${rule.method}`):findings.push(`${mapping.upstreamTag}: dangling unknown-return upstream method ${rule.method}`),targetMethod?(targetMethod.overloads??[]).every(overload=>overload.returnType==="unknown"||overload.returnType===UNSPECIFIED_PUBLIC_DOCUMENTATION)&&findings.push(`${mapping.upstreamTag}: stale concrete target return normalization ${rule.method}`):findings.push(`${mapping.upstreamTag}: dangling unknown-return target method ${rule.method}`)}const seenCancelabilities=new Set,cancelabilityPrefix=mapping.upstreamTag?.startsWith("sl-")?"sl-":"wa-",cancelabilityEventRewrites=new Map((mapping.rewrites?.events??[]).map(entry=>[entry.from,entry.to]));for(const[section,allowedKeys]of[["cancelabilityEquivalences",["event","upstream","target"]],["cancelabilityPathAdditions",["event","upstream","target","addedPath"]]])for(const rule of normalizations[section]??[]){const keys=rule&&typeof rule=="object"?Object.keys(rule):[];if(!(typeof rule?.event=="string"&&!!rule.event&&CANCELABILITY_RANK.has(rule.upstream)&&CANCELABILITY_RANK.has(rule.target)&&keys.length===allowedKeys.length&&keys.every(key=>allowedKeys.includes(key))&&(section==="cancelabilityEquivalences"?CANCELABILITY_RANK.get(rule.target)>CANCELABILITY_RANK.get(rule.upstream):rule.upstream==="always"&&rule.target==="conditional"&&typeof rule.addedPath=="string"&&!!rule.addedPath))){findings.push(`${mapping.upstreamTag}: invalid normalizations.${section} rule`);continue}seenCancelabilities.has(rule.event)&&findings.push(`${mapping.upstreamTag}: duplicate cancelability normalization ${rule.event}`),seenCancelabilities.add(rule.event);const upstreamEvent=(upstream?.events??[]).find(entry=>entry.name===rule.event),targetName=cancelabilityEventRewrites.get(rule.event)||mappedEventName(rule.event,cancelabilityPrefix),targetEvent=(target?.events??[]).find(entry=>entry.name===targetName);upstreamEvent?upstreamEvent.cancelable!==rule.upstream&&findings.push(`${mapping.upstreamTag}: stale upstream cancelability normalization ${rule.event}`):findings.push(`${mapping.upstreamTag}: dangling upstream cancelability normalization ${rule.event}`),targetEvent?targetEvent.cancelable!==rule.target&&findings.push(`${mapping.upstreamTag}: stale target cancelability normalization ${rule.event}`):findings.push(`${mapping.upstreamTag}: dangling target cancelability normalization ${rule.event}`)}return findings.sort()}function manifestDeclarations(manifest){return(manifest.modules??[]).flatMap(module=>(module.declarations??[]).filter(declaration=>declaration.customElement&&declaration.tagName).map(declaration=>({module,declaration}))).sort((a,b)=>a.declaration.tagName.localeCompare(b.declaration.tagName))}function sameJson(left,right){return JSON.stringify(left)===JSON.stringify(right)}function validateLocalMigrations(inventory){const findings=[];if(!Array.isArray(inventory?.localMigrations))return["localMigrations must be an array"];const allowedOrigins=new Set(LOCAL_MIGRATION_ORIGINS),components=new Map((inventory.components??[]).map(component=>[component.tag,component])),seenProfiles=new Set;for(const profile of inventory.localMigrations){if(!profile||typeof profile!="object"||Array.isArray(profile)){findings.push("localMigrations entries must be objects");continue}const unknownProfileKeys=Object.keys(profile).filter(key2=>key2!=="origin"&&key2!=="tag"&&key2!=="defaults");unknownProfileKeys.length&&findings.push(`local migration has unknown key(s) ${unknownProfileKeys.join(", ")}`),allowedOrigins.has(profile.origin)||findings.push(`local migration has unknown origin ${String(profile.origin)}`),(typeof profile.tag!="string"||!profile.tag.startsWith("lr-"))&&findings.push(`local migration needs a valid lr-* tag, got ${String(profile.tag)}`);const key=`${String(profile.origin)}:${String(profile.tag)}`;seenProfiles.has(key)&&findings.push(`duplicate local migration ${key}`),seenProfiles.add(key);const component=components.get(profile.tag);if(component||findings.push(`${key}: target tag is not registered`),!Array.isArray(profile.defaults)||profile.defaults.length===0){findings.push(`${key}: defaults must be a non-empty array`);continue}const attributes=new Map((component?.surface?.attributes??[]).map(attribute=>[attribute.name,attribute])),seenDefaults=new Set;for(const rule of profile.defaults){if(!rule||typeof rule!="object"||Array.isArray(rule)){findings.push(`${key}: default rules must be objects`);continue}const unknownRuleKeys=Object.keys(rule).filter(name=>!["memberKind","member","action","value"].includes(name));if(unknownRuleKeys.length&&findings.push(`${key}: default rule has unknown key(s) ${unknownRuleKeys.join(", ")}`),rule.memberKind!=="attribute"&&findings.push(`${key}: local defaults support only attribute members`),rule.action!=="insert-if-absent"&&findings.push(`${key}: local defaults support only insert-if-absent`),typeof rule.member!="string"||!rule.member){findings.push(`${key}: default rule needs a member`);continue}seenDefaults.has(rule.member)&&findings.push(`${key}: duplicate default member ${rule.member}`),seenDefaults.add(rule.member);const attribute=attributes.get(rule.member);attribute||findings.push(`${key}: unknown target attribute ${rule.member}`),Object.hasOwn(rule,"value")?typeof rule.value!="string"&&typeof rule.value!="boolean"&&!(typeof rule.value=="number"&&Number.isFinite(rule.value))?findings.push(`${key}: ${rule.member} value must be a finite string, number, or boolean`):rule.value===!1?findings.push(`${key}: false boolean insertion requires explicit converter evidence`):rule.value===!0&&!String(attribute?.type).includes("boolean")&&findings.push(`${key}: true presence insertion requires a boolean target attribute ${rule.member}`):findings.push(`${key}: ${rule.member} needs a value`)}}return findings}function validateInventory(inventory,{upstreamTags,lyraManifest,strict=!1}={}){const findings=[];if(inventory.schemaVersion!==INVENTORY_SCHEMA_VERSION&&findings.push(`schemaVersion must be ${INVENTORY_SCHEMA_VERSION}`),Array.isArray(inventory.components)||findings.push("components must be an array"),Array.isArray(inventory.mappings)||findings.push("mappings must be an array"),findings.length)return findings;const lyraByTag=new Map(inventory.components.map(component=>[component.tag,component]));validateAccessibilityProfiles(inventory.accessibilityProfiles,findings),findings.push(...validateLocalMigrations(inventory)),lyraByTag.size!==inventory.components.length&&findings.push("components contain duplicate Lyra tags");const expectedLyra=manifestDeclarations(lyraManifest),normalizedLyraByTag=new Map(normalizeManifest(lyraManifest,{ecosystem:"lyra"}).map(component=>[component.tag,component])),expectedLyraTags=expectedLyra.map(({declaration})=>declaration.tagName),actualLyraTags=[...lyraByTag.keys()].sort();sameJson(actualLyraTags,expectedLyraTags)||findings.push("Lyra tag inventory drifted from custom-elements.json");for(const{declaration}of expectedLyra){const component=lyraByTag.get(declaration.tagName);if(!component)continue;validateSurface(component.surface,component.tag,findings);const expectedSurface=normalizedLyraByTag.get(declaration.tagName)?.surface;sameJson(component.surface,expectedSurface)||findings.push(`${component.tag}: normalized public surface drifted`),(!component.family||!component.classModule||!component.registrationModule)&&findings.push(`${component.tag}: incomplete registration metadata`),(!Array.isArray(component.optionalPeers)||!Array.isArray(component.counterparts))&&findings.push(`${component.tag}: peers/counterparts must be arrays`),component.maturity?.status||findings.push(`${component.tag}: missing maturity classification`),strict&&component.maturity.status==="unclassified"&&findings.push(`${component.tag}: maturity remains unclassified`)}const catalogs={webawesome:[...upstreamTags.webawesome.free,...upstreamTags.webawesome.pro].sort(),shoelace:[...upstreamTags.shoelace.tags].sort()},upstreamByTag=new Map;for(const ecosystem of["webawesome","shoelace"]){const upstream=inventory.upstreams?.[ecosystem];if(!upstream){findings.push(`missing ${ecosystem} inventory`);continue}const expectedPin=upstreamTags[ecosystem];(upstream.version!==expectedPin.version||upstream.commit!==expectedPin.commit)&&findings.push(`${ecosystem}: pin drifted from upstream-tags.json`);const tags=(upstream.components??[]).map(component=>component.tag).sort();sameJson(tags,catalogs[ecosystem])||findings.push(`${ecosystem}: tag catalog drifted from upstream-tags.json`);for(const component of upstream.components??[])upstreamByTag.has(component.tag)&&findings.push(`${component.tag}: duplicate upstream tag`),upstreamByTag.set(component.tag,{ecosystem,component}),validateSurface(component.surface,component.tag,findings),(!component.review?.status||!Array.isArray(component.review.unreviewedSections))&&findings.push(`${component.tag}: missing surface review metadata`),strict&&component.review.status!=="complete"&&findings.push(`${component.tag}: public surface review is incomplete`);const expectedRuntimeEvidence=new Set;for(const observation of expectedPin.runtimeEventCancelability?.events??[]){const key=`${observation.tag}#${observation.event}`;if(expectedRuntimeEvidence.has(key)){findings.push(`${ecosystem}: duplicate runtime cancelability evidence ${key}`);continue}expectedRuntimeEvidence.add(key);const event=(upstream.components??[]).find(entry=>entry.tag===observation.tag)?.surface?.events?.find(entry=>entry.name===observation.event);(event?.cancelable!==observation.cancelable||event?.cancelabilityEvidence!=="pinned-runtime")&&findings.push(`${key}: stored runtime cancelability evidence drifted from upstream-tags.json`)}for(const component of upstream.components??[])for(const event of component.surface?.events??[])event.cancelabilityEvidence&&!expectedRuntimeEvidence.has(`${component.tag}#${event.name}`)&&findings.push(`${component.tag}#${event.name}: stored runtime cancelability evidence is stale`);const expectedMethodEdgeEvidence=new Set;for(const observation of expectedPin.runtimeMethodEdgeSemantics?.methods??[]){const key=`${observation.tag}#${observation.method}`;if(expectedMethodEdgeEvidence.has(key)){findings.push(`${ecosystem}: duplicate runtime method-edge evidence ${key}`);continue}expectedMethodEdgeEvidence.add(key);const method=(upstream.components??[]).find(entry=>entry.tag===observation.tag)?.surface?.methods?.find(entry=>entry.name===observation.method);sameJson(method?.edgeSemantics,{evidence:"pinned-runtime",cases:observation.cases})||findings.push(`${key}: stored runtime method-edge evidence drifted from upstream-tags.json`)}for(const component of upstream.components??[])for(const method of component.surface?.methods??[])method.edgeSemantics&&!expectedMethodEdgeEvidence.has(`${component.tag}#${method.name}`)&&findings.push(`${component.tag}#${method.name}: stored runtime method-edge evidence is stale`)}const mappingByTag=new Map;for(const mapping of inventory.mappings){mappingByTag.has(mapping.upstreamTag)&&findings.push(`${mapping.upstreamTag}: duplicate mapping`),mappingByTag.set(mapping.upstreamTag,mapping),upstreamByTag.has(mapping.upstreamTag)||findings.push(`${mapping.upstreamTag}: fictional upstream mapping`),MAPPING_CLASSIFICATIONS.includes(mapping.classification)||findings.push(`${mapping.upstreamTag}: invalid mapping classification`),validateAccessibilityParity(mapping,inventory.accessibilityProfiles,findings),validateRewrites(mapping,findings),mapping.classification==="exact"&&mapping.rationale!==null&&findings.push(`${mapping.upstreamTag}: exact mappings must not carry a rationale`),mapping.classification==="exact"&&REWRITE_RULE_SECTIONS.some(section=>mapping.rewrites?.[section]?.length)&&findings.push(`${mapping.upstreamTag}: exact mappings cannot declare rewrite rules`),mapping.classification==="rewritten"&&!REWRITE_RULE_SECTIONS.some(section=>mapping.rewrites?.[section]?.length)&&findings.push(`${mapping.upstreamTag}: rewritten mappings need a deterministic rule`),mapping.classification!=="exact"&&!mapping.rationale?.trim()&&findings.push(`${mapping.upstreamTag}: non-exact mapping needs a rationale`),mapping.targetTag&&!lyraByTag.has(mapping.targetTag)&&mapping.classification!=="unsupported"&&findings.push(`${mapping.upstreamTag} -> ${mapping.targetTag}: dangling target`);for(const rewrite of mapping.rewrites?.attributes??[]){const from=polarity(rewrite.from),to=polarity(rewrite.to);from!==to&&(from===-1||to===-1)&&findings.push(`${mapping.upstreamTag}: ${rewrite.from} -> ${rewrite.to} inverts polarity`)}const upstreamEntry=upstreamByTag.get(mapping.upstreamTag)?.component,target=lyraByTag.get(mapping.targetTag);if(findings.push(...validateMethodEdgeParity(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),findings.push(...validateDefaultRewriteSemantics(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),findings.push(...validateMappingNormalizations(mapping,{upstream:upstreamEntry?.surface,target:target?.surface})),upstreamEntry?.review.status==="complete"&&target){const expectedDrift=compareMappedSurfaces(upstreamEntry.surface,target.surface,{upstreamPrefix:mapping.upstream==="webawesome"?"wa-":"sl-",rewrites:mapping.rewrites,normalizations:mapping.normalizations});sameJson(mapping.drift,expectedDrift)||findings.push(`${mapping.upstreamTag}: stored surface drift is stale`),mapping.classification==="exact"&&expectedDrift.length&&findings.push(`${mapping.upstreamTag}: exact mapping has ${expectedDrift.length} surface difference(s)`)}const expectedStaticApiReview=deriveStaticApiReviewStatus({upstreamReviewStatus:upstreamEntry?.review.status,targetPresent:!!target,comparisonPerformed:upstreamEntry?.review.status==="complete"&&!!target});mapping.parity?.staticApi!==expectedStaticApiReview&&findings.push(`${mapping.upstreamTag}: static API review status is stale; expected ${expectedStaticApiReview}`),strict&&mapping.classification==="unsupported"&&findings.push(`${mapping.upstreamTag}: unsupported release blocker remains`)}mappingByTag.size!==upstreamByTag.size&&findings.push("not every upstream tag has exactly one mapping decision");for(const tag of upstreamByTag.keys())mappingByTag.has(tag)||findings.push(`${tag}: no mapping decision`);return findings.sort()}function validatePinnedManifests(inventory,{webawesomeManifest,shoelaceManifest,upstreamTags}){const findings=[],manifests={webawesome:{manifest:webawesomeManifest,prefix:"wa-"},shoelace:{manifest:shoelaceManifest,prefix:"sl-"}};for(const[ecosystem,{manifest,prefix}]of Object.entries(manifests)){const checked=new Map(applyRuntimeMethodEdgeSemanticsEvidence(applyRuntimeEventCancelabilityEvidence(normalizeManifest(manifest,{ecosystem}),upstreamTags?.[ecosystem]?.runtimeEventCancelability,{ecosystem,version:upstreamTags?.[ecosystem]?.version??inventory.upstreams[ecosystem].version}),upstreamTags?.[ecosystem]?.runtimeMethodEdgeSemantics,{ecosystem,version:upstreamTags?.[ecosystem]?.version??inventory.upstreams[ecosystem].version}).filter(entry=>entry.tag.startsWith(prefix)).map(entry=>[entry.tag,entry])),stored=new Map(inventory.upstreams[ecosystem].components.map(entry=>[entry.tag,entry]));for(const[tag,entry]of checked){const snapshot=stored.get(tag);if(!snapshot){findings.push(`${tag}: pinned manifest tag is absent from the inventory`);continue}sameJson(snapshot.surface,entry.surface)||findings.push(`${tag}: pinned public surface drifted`),sameJson(snapshot.maturity,entry.maturity)||findings.push(`${tag}: pinned maturity metadata drifted`),snapshot.review.status!=="complete"&&findings.push(`${tag}: pinned manifest surface is marked unreviewed`)}for(const[tag,snapshot]of stored)snapshot.review.source==="published-manifest"&&!checked.has(tag)&&findings.push(`${tag}: stored published-manifest surface is fictional or stale`)}return findings.sort()}function emptySurface(){return{attributes:[],properties:[],slots:[],events:[],parts:[],cssProperties:[],cssStates:[],methods:[],staticProperties:[],staticMethods:[],moduleExports:[],form:{associated:!1,properties:[],methods:[]},native:{forwardedEvents:[],delegatedMethods:[]}}}function familyFromModule(modulePath){return modulePath.split(path.posix.sep)[2]||null}export{ACCESSIBILITY_PROFILE_SECTIONS,INVENTORY_SCHEMA_VERSION,LOCAL_MIGRATION_ORIGINS,LOCAL_MIGRATION_PROFILES,MIGRATION_ATTRIBUTE_EXCLUSIONS,NORMALIZATION_SECTIONS,REWRITE_RULE_SECTIONS,SURFACE_SECTIONS,applyRuntimeEventCancelabilityEvidence,applyRuntimeMethodEdgeSemanticsEvidence,compareAccessibilityProfiles,compareMappedSurfaces,deriveStaticApiReviewStatus,emptyNormalizations,emptyRewrites,emptySurface,eventCancelabilityFromDescription,familyFromModule,normalizeDeclaration,normalizeManifest,validateAccessibilityContract,validateInventory,validateLocalMigrations,validateMappingNormalizations,validateMethodEdgeParity,validatePinnedManifests};