replace *Properties with *Declaration

saschanaz · saschanaz · commit 5c8017914342 · 2025-10-01T00:15:21.000+02:00
diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts
@@ -4821,7 +4821,7 @@ interface CSSFontFaceRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSFontFaceRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -4991,7 +4991,7 @@ interface CSSKeyframeRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeyframeRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -5326,7 +5326,7 @@ interface CSSNestedDeclarations extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNestedDeclarations/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -7417,7 +7417,7 @@ interface CSSStyleRule extends CSSGroupingRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
     /**
      * The **`styleMap`** read-only property of the CSSStyleRule interface returns a StylePropertyMap object which provides access to the rule's property-value pairs.
@@ -11461,7 +11461,7 @@ interface ElementCSSInlineStyle {
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/attributeStyleMap) */
     readonly attributeStyleMap: StylePropertyMap;
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/style) */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -37358,7 +37358,7 @@ interface Window extends EventTarget, AnimationFrameProvider, GlobalEventHandler
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
      */
-    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
     /**
      * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
      *
@@ -39460,7 +39460,7 @@ declare function focus(): void;
  *
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
  */
-declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
 /**
  * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
  *
diff --git a/baselines/ts5.5/dom.generated.d.ts b/baselines/ts5.5/dom.generated.d.ts
@@ -4821,7 +4821,7 @@ interface CSSFontFaceRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSFontFaceRule/style)
      */
-    readonly style: CSSStyleProperties;
+    readonly style: CSSStyleDeclaration;
 }
 
 declare var CSSFontFaceRule: {
@@ -4989,7 +4989,7 @@ interface CSSKeyframeRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeyframeRule/style)
      */
-    readonly style: CSSStyleProperties;
+    readonly style: CSSStyleDeclaration;
 }
 
 declare var CSSKeyframeRule: {
@@ -5322,7 +5322,7 @@ interface CSSNestedDeclarations extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNestedDeclarations/style)
      */
-    readonly style: CSSStyleProperties;
+    readonly style: CSSStyleDeclaration;
 }
 
 declare var CSSNestedDeclarations: {
@@ -7410,7 +7410,7 @@ interface CSSStyleRule extends CSSGroupingRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleRule/style)
      */
-    readonly style: CSSStyleProperties;
+    readonly style: CSSStyleDeclaration;
     /**
      * The **`styleMap`** read-only property of the CSSStyleRule interface returns a StylePropertyMap object which provides access to the rule's property-value pairs.
      *
@@ -11451,7 +11451,7 @@ interface ElementCSSInlineStyle {
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/attributeStyleMap) */
     readonly attributeStyleMap: StylePropertyMap;
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/style) */
-    readonly style: CSSStyleProperties;
+    readonly style: CSSStyleDeclaration;
 }
 
 interface ElementContentEditable {
@@ -37335,7 +37335,7 @@ interface Window extends EventTarget, AnimationFrameProvider, GlobalEventHandler
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
      */
-    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
     /**
      * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
      *
@@ -39437,7 +39437,7 @@ declare function focus(): void;
  *
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
  */
-declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
 /**
  * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
  *
diff --git a/baselines/ts5.6/dom.generated.d.ts b/baselines/ts5.6/dom.generated.d.ts
@@ -4821,7 +4821,7 @@ interface CSSFontFaceRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSFontFaceRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -4991,7 +4991,7 @@ interface CSSKeyframeRule extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeyframeRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -5326,7 +5326,7 @@ interface CSSNestedDeclarations extends CSSRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNestedDeclarations/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -7417,7 +7417,7 @@ interface CSSStyleRule extends CSSGroupingRule {
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleRule/style)
      */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
     /**
      * The **`styleMap`** read-only property of the CSSStyleRule interface returns a StylePropertyMap object which provides access to the rule's property-value pairs.
@@ -11461,7 +11461,7 @@ interface ElementCSSInlineStyle {
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/attributeStyleMap) */
     readonly attributeStyleMap: StylePropertyMap;
     /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/style) */
-    get style(): CSSStyleProperties;
+    get style(): CSSStyleDeclaration;
     set style(cssText: string);
 }
 
@@ -37358,7 +37358,7 @@ interface Window extends EventTarget, AnimationFrameProvider, GlobalEventHandler
      *
      * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
      */
-    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+    getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
     /**
      * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
      *
@@ -39460,7 +39460,7 @@ declare function focus(): void;
  *
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)
  */
-declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleProperties;
+declare function getComputedStyle(elt: Element, pseudoElt?: string | null): CSSStyleDeclaration;
 /**
  * The **`getSelection()`** method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
  *
diff --git a/inputfiles/patches/cssom.kdl b/inputfiles/patches/cssom.kdl
@@ -5,3 +5,5 @@
 interface CSSStyleDeclaration \
   forward=CSSStyleDeclarationBase \
   forwardExtends=CSSStyleProperties
+
+interface CSSStyleProperties replaceReference=CSSStyleDeclaration
diff --git a/src/build/emitter.ts b/src/build/emitter.ts
@@ -472,15 +472,18 @@ export function emitWebIdl(
     if (baseTypeConversionMap.has(objDomType)) {
       return baseTypeConversionMap.get(objDomType)!;
     }
-    // Name of an interface / enum / dict. Just return itself
+    if (allInterfacesMap[objDomType]) {
+      return allInterfacesMap[objDomType].replaceReference ?? objDomType;
+    }
+    // Name of an alias / callback / enum / dict. Just return itself
     if (
-      allInterfacesMap[objDomType] ||
       allLegacyWindowAliases.includes(objDomType) ||
       allCallbackFunctionsMap[objDomType] ||
       allDictionariesMap[objDomType] ||
       allEnumsMap[objDomType]
-    )
+    ) {
       return objDomType;
+    }
     // Name of a type alias. Just return itself
     if (allTypedefsMap[objDomType]) return objDomType;
 
diff --git a/src/build/patches.ts b/src/build/patches.ts
@@ -189,6 +189,11 @@ function handleMixinandInterfaces(
       "string",
       node.properties?.forwardExtends,
     ),
+    ...optionalMember(
+      "replaceReference",
+      "string",
+      node.properties?.replaceReference,
+    ),
     ...handleTypeParameters(node.properties?.typeParameters),
     ...interfaceObject,
   } as DeepPartial<Interface>;
diff --git a/src/build/types.ts b/src/build/types.ts
@@ -155,6 +155,8 @@ export interface Interface {
   forward?: string;
   // "extends" for the original interface, in case `forward: true`.
   forwardExtends?: string;
+  // replaces references from methods and properties
+  replaceReference?: string;
   comment?: string;
   constants?: {
     constant: Record<string, Constant>;

Original file line number	Diff line number	Diff line change
`@@ -4821,7 +4821,7 @@ interface CSSFontFaceRule extends CSSRule {`
`4821`	`4821`	`*`
`4822`	`4822`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSFontFaceRule/style)`
`4823`	`4823`	`*/`
`4824`		`- get style(): CSSStyleProperties;`
	`4824`	`+ get style(): CSSStyleDeclaration;`
`4825`	`4825`	`set style(cssText: string);`
`4826`	`4826`	`}`
`4827`	`4827`
`@@ -4991,7 +4991,7 @@ interface CSSKeyframeRule extends CSSRule {`
`4991`	`4991`	`*`
`4992`	`4992`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeyframeRule/style)`
`4993`	`4993`	`*/`
`4994`		`- get style(): CSSStyleProperties;`
	`4994`	`+ get style(): CSSStyleDeclaration;`
`4995`	`4995`	`set style(cssText: string);`
`4996`	`4996`	`}`
`4997`	`4997`
`@@ -5326,7 +5326,7 @@ interface CSSNestedDeclarations extends CSSRule {`
`5326`	`5326`	`*`
`5327`	`5327`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNestedDeclarations/style)`
`5328`	`5328`	`*/`
`5329`		`- get style(): CSSStyleProperties;`
	`5329`	`+ get style(): CSSStyleDeclaration;`
`5330`	`5330`	`set style(cssText: string);`
`5331`	`5331`	`}`
`5332`	`5332`
`@@ -7417,7 +7417,7 @@ interface CSSStyleRule extends CSSGroupingRule {`
`7417`	`7417`	`*`
`7418`	`7418`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleRule/style)`
`7419`	`7419`	`*/`
`7420`		`- get style(): CSSStyleProperties;`
	`7420`	`+ get style(): CSSStyleDeclaration;`
`7421`	`7421`	`set style(cssText: string);`
`7422`	`7422`	`/**`
`7423`	`7423`	* The `styleMap` read-only property of the CSSStyleRule interface returns a StylePropertyMap object which provides access to the rule's property-value pairs.
`@@ -11461,7 +11461,7 @@ interface ElementCSSInlineStyle {`
`11461`	`11461`	`/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/attributeStyleMap) */`
`11462`	`11462`	`readonly attributeStyleMap: StylePropertyMap;`
`11463`	`11463`	`/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/style) */`
`11464`		`- get style(): CSSStyleProperties;`
	`11464`	`+ get style(): CSSStyleDeclaration;`
`11465`	`11465`	`set style(cssText: string);`
`11466`	`11466`	`}`
`11467`	`11467`
`@@ -37358,7 +37358,7 @@ interface Window extends EventTarget, AnimationFrameProvider, GlobalEventHandler`
`37358`	`37358`	`*`
`37359`	`37359`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)`
`37360`	`37360`	`*/`
`37361`		`- getComputedStyle(elt: Element, pseudoElt?: string \| null): CSSStyleProperties;`
	`37361`	`+ getComputedStyle(elt: Element, pseudoElt?: string \| null): CSSStyleDeclaration;`
`37362`	`37362`	`/**`
`37363`	`37363`	* The `getSelection()` method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
`37364`	`37364`	`*`
`@@ -39460,7 +39460,7 @@ declare function focus(): void;`
`39460`	`39460`	`*`
`39461`	`39461`	`* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/getComputedStyle)`
`39462`	`39462`	`*/`
`39463`		`-declare function getComputedStyle(elt: Element, pseudoElt?: string \| null): CSSStyleProperties;`
	`39463`	`+declare function getComputedStyle(elt: Element, pseudoElt?: string \| null): CSSStyleDeclaration;`
`39464`	`39464`	`/**`
`39465`	`39465`	* The `getSelection()` method of the Window interface returns the Selection object associated with the window's document, representing the range of text selected by the user or the current position of the caret.
`39466`	`39466`	`*`