From 455185e98afc13641a627c70be247dd8d80aca2b Mon Sep 17 00:00:00 2001 From: Bashamega Date: Fri, 5 Dec 2025 14:04:42 +0200 Subject: [PATCH 1/8] Update deprecation messages in generated TypeScript definitions and KDL files for consistency and clarity --- baselines/dom.generated.d.ts | 10 +++++----- baselines/ts5.5/dom.generated.d.ts | 10 +++++----- baselines/ts5.6/dom.generated.d.ts | 10 +++++----- baselines/ts5.9/dom.generated.d.ts | 10 +++++----- inputfiles/patches/cssom.kdl | 4 ++-- inputfiles/patches/html.kdl | 4 +--- inputfiles/patches/uievents.kdl | 7 ++----- src/build/patches.ts | 5 +++-- 8 files changed, 28 insertions(+), 32 deletions(-) diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index c96bb81bd..4a267f8d1 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -947,12 +947,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated */ + /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated */ + /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ keyCode?: number; location?: number; repeat?: boolean; @@ -9195,7 +9195,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated + * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39462,7 +39462,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41831,7 +41831,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.5/dom.generated.d.ts b/baselines/ts5.5/dom.generated.d.ts index fc1d93ece..459a6fa24 100644 --- a/baselines/ts5.5/dom.generated.d.ts +++ b/baselines/ts5.5/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated */ + /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated */ + /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ keyCode?: number; location?: number; repeat?: boolean; @@ -9185,7 +9185,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated + * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39436,7 +39436,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41805,7 +41805,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.6/dom.generated.d.ts b/baselines/ts5.6/dom.generated.d.ts index 743813310..338a06e78 100644 --- a/baselines/ts5.6/dom.generated.d.ts +++ b/baselines/ts5.6/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated */ + /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated */ + /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ keyCode?: number; location?: number; repeat?: boolean; @@ -9192,7 +9192,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated + * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39459,7 +39459,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41828,7 +41828,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.9/dom.generated.d.ts b/baselines/ts5.9/dom.generated.d.ts index ab262d313..f808757f8 100644 --- a/baselines/ts5.9/dom.generated.d.ts +++ b/baselines/ts5.9/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated */ + /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated */ + /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ keyCode?: number; location?: number; repeat?: boolean; @@ -9192,7 +9192,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated + * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39459,7 +39459,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41828,7 +41828,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/inputfiles/patches/cssom.kdl b/inputfiles/patches/cssom.kdl index ca89ead1f..02df48195 100644 --- a/inputfiles/patches/cssom.kdl +++ b/inputfiles/patches/cssom.kdl @@ -7,9 +7,9 @@ interface CSSStyleDeclaration \ forwardExtends=CSSStyleProperties interface CSSStyleProperties replaceReference=CSSStyleDeclaration { - property wordWrap deprecated=#true + property wordWrap deprecated="The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS." // The corresponding standardized property is not supported by // anyone as of 2024-10. - property webkitLineClamp deprecated=#false + property webkitLineClamp supported=#false } diff --git a/inputfiles/patches/html.kdl b/inputfiles/patches/html.kdl index a75b74ef9..71b20bbca 100644 --- a/inputfiles/patches/html.kdl +++ b/inputfiles/patches/html.kdl @@ -12,7 +12,5 @@ interface HTMLDocument extends=Document exposed=Window interface-mixin MessageEventTarget overrideThis=T typeParameters=T interface-mixin WindowEventHandlers { - // TODO: pass a string instead for deprecated - // The unload event is not reliable, consider visibilitychange or pagehide events - property onunload deprecated=#true + property onunload deprecated="The unload event is not reliable, consider visibilitychange or pagehide events" } diff --git a/inputfiles/patches/uievents.kdl b/inputfiles/patches/uievents.kdl index 87be25d7f..cd826ca66 100644 --- a/inputfiles/patches/uievents.kdl +++ b/inputfiles/patches/uievents.kdl @@ -1,7 +1,4 @@ dictionary KeyboardEventInit { - // TODO: pass a string instead for deprecated - // charCode is inconsistent across environments, consider using .key instead - member charCode deprecated=#true - // keyCode is inconsistent across environments, consider using .key instead - member keyCode deprecated=#true + member charCode deprecated="CharCode is inconsistent across environments, consider using .key instead" + member keyCode deprecated="KeyCode is inconsistent across environments, consider using .key instead" } diff --git a/src/build/patches.ts b/src/build/patches.ts index f8a07b343..47f0b48e2 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -256,7 +256,8 @@ function handleProperty(child: Node): Partial { ? handleTyped(typeNode) : optionalMember("type", "string", child.properties?.type)), ...optionalMember("readonly", "boolean", child.properties?.readonly), - ...optionalMember("deprecated", "boolean", child.properties?.deprecated), + ...optionalMember("deprecated", "string", child.properties?.deprecated), + ...optionalMember("deprecated", "boolean", child.properties?.supported) }; } @@ -366,7 +367,7 @@ function handleMember(c: Node): Partial { name, ...optionalMember("type", "string", c.properties?.type), ...optionalMember("required", "boolean", c.properties?.required), - ...optionalMember("deprecated", "boolean", c.properties?.deprecated), + ...optionalMember("deprecated", "string", c.properties?.deprecated), ...optionalMember("overrideType", "string", c.properties?.overrideType), }; } From 3b3f60c02b39949b9eb9e12b8107735f6eceab37 Mon Sep 17 00:00:00 2001 From: Bashamega Date: Fri, 5 Dec 2025 14:15:49 +0200 Subject: [PATCH 2/8] Update webkitLineClamp support status in KDL and adjust TypeScript handling of supported properties --- inputfiles/patches/cssom.kdl | 2 +- src/build/patches.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/inputfiles/patches/cssom.kdl b/inputfiles/patches/cssom.kdl index 02df48195..a4772ccc9 100644 --- a/inputfiles/patches/cssom.kdl +++ b/inputfiles/patches/cssom.kdl @@ -11,5 +11,5 @@ interface CSSStyleProperties replaceReference=CSSStyleDeclaration { // The corresponding standardized property is not supported by // anyone as of 2024-10. - property webkitLineClamp supported=#false + property webkitLineClamp supported=#true } diff --git a/src/build/patches.ts b/src/build/patches.ts index 47f0b48e2..91fbde173 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -257,7 +257,7 @@ function handleProperty(child: Node): Partial { : optionalMember("type", "string", child.properties?.type)), ...optionalMember("readonly", "boolean", child.properties?.readonly), ...optionalMember("deprecated", "string", child.properties?.deprecated), - ...optionalMember("deprecated", "boolean", child.properties?.supported) + ...(child.properties?.supported && { deprecated: false }) }; } From 6d142a0a28364a658296fe3247fa362b64b2df63 Mon Sep 17 00:00:00 2001 From: Bashamega Date: Fri, 5 Dec 2025 14:16:08 +0200 Subject: [PATCH 3/8] lint --- src/build/patches.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/build/patches.ts b/src/build/patches.ts index 91fbde173..3fd2cf679 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -257,7 +257,7 @@ function handleProperty(child: Node): Partial { : optionalMember("type", "string", child.properties?.type)), ...optionalMember("readonly", "boolean", child.properties?.readonly), ...optionalMember("deprecated", "string", child.properties?.deprecated), - ...(child.properties?.supported && { deprecated: false }) + ...(child.properties?.supported && { deprecated: false }), }; } From c02102f8975070ebbee8c3f573c9e6af373b9ef3 Mon Sep 17 00:00:00 2001 From: Bashamega Date: Sun, 7 Dec 2025 17:26:26 +0200 Subject: [PATCH 4/8] Update KDL to deprecate webkitLineClamp in CSSStyleProperties and enhance TypeScript handling for empty objects --- inputfiles/patches/cssom.kdl | 12 ++++++++---- src/build/patches.ts | 3 +++ 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/inputfiles/patches/cssom.kdl b/inputfiles/patches/cssom.kdl index a4772ccc9..250f09198 100644 --- a/inputfiles/patches/cssom.kdl +++ b/inputfiles/patches/cssom.kdl @@ -8,8 +8,12 @@ interface CSSStyleDeclaration \ interface CSSStyleProperties replaceReference=CSSStyleDeclaration { property wordWrap deprecated="The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS." - - // The corresponding standardized property is not supported by - // anyone as of 2024-10. - property webkitLineClamp supported=#true +} + +removals { + interface CSSStyleProperties { + // The corresponding standardized property is not supported by + // anyone as of 2024-10. + property webkitLineClamp deprecated="" + } } diff --git a/src/build/patches.ts b/src/build/patches.ts index 721739960..912effc40 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -415,6 +415,9 @@ function convertForRemovals(obj: unknown): unknown { // Replace empty objects with null return Object.keys(newObj).length === 0 ? null : newObj; } + if (obj === "") { + return null; + } return obj; } From 37b41cbf92dcaebd1519dd6561f58c232eb85daa Mon Sep 17 00:00:00 2001 From: Kagami Sascha Rosylight Date: Sun, 7 Dec 2025 16:45:53 +0100 Subject: [PATCH 5/8] no `supported` anymore --- src/build/patches.ts | 1 - 1 file changed, 1 deletion(-) diff --git a/src/build/patches.ts b/src/build/patches.ts index 912effc40..30eaeb8b2 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -257,7 +257,6 @@ function handleProperty(child: Node): Partial { : optionalMember("type", "string", child.properties?.type)), ...optionalMember("readonly", "boolean", child.properties?.readonly), ...optionalMember("deprecated", "string", child.properties?.deprecated), - ...(child.properties?.supported && { deprecated: false }), }; } From f3ec07b49593255e806aa4fd88e17c96083cc228 Mon Sep 17 00:00:00 2001 From: Kagami Sascha Rosylight Date: Sun, 7 Dec 2025 17:04:35 +0100 Subject: [PATCH 6/8] random property values are all for removals --- src/build/patches.ts | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/build/patches.ts b/src/build/patches.ts index 30eaeb8b2..215d75509 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -406,17 +406,17 @@ function convertForRemovals(obj: unknown): unknown { for (const [key, value] of Object.entries(obj)) { if (key !== "name") { const cleaned = convertForRemovals(value); - if (cleaned !== undefined) { + // (intentionally covers null too) + if (typeof cleaned === "object") { newObj[key] = cleaned; + } else if (cleaned !== undefined) { + newObj[key] = null; } } } // Replace empty objects with null return Object.keys(newObj).length === 0 ? null : newObj; } - if (obj === "") { - return null; - } return obj; } From bd3d1e7442f8d9defe43a5c96ce86f0ca8a83055 Mon Sep 17 00:00:00 2001 From: Kagami Sascha Rosylight Date: Sun, 7 Dec 2025 17:28:01 +0100 Subject: [PATCH 7/8] optionalNestedMember --- src/build/patches.ts | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/src/build/patches.ts b/src/build/patches.ts index 215d75509..e54939d19 100644 --- a/src/build/patches.ts +++ b/src/build/patches.ts @@ -81,8 +81,8 @@ function handleTypeParameters(value: Value | Node) { }; } -function undefinedIfEmpty(object: object, output: object) { - return Object.entries(object).length ? output : undefined; +function optionalNestedMember(prop: string, object: object, output: T) { + return Object.entries(object).length ? { [prop]: output } : {}; } /** @@ -119,10 +119,12 @@ function convertKDLNodes(nodes: Node[]): DeepPartial { } return { - enums: undefinedIfEmpty(enums, { enum: enums }), - mixins: undefinedIfEmpty(mixin, { mixin }), - interfaces: undefinedIfEmpty(interfaces, { interface: interfaces }), - dictionaries: undefinedIfEmpty(dictionary, { dictionary }), + ...optionalNestedMember("enums", enums, { enum: enums }), + ...optionalNestedMember("mixins", mixin, { mixin }), + ...optionalNestedMember("interfaces", interfaces, { + interface: interfaces, + }), + ...optionalNestedMember("dictionaries", dictionary, { dictionary }), }; } @@ -202,7 +204,7 @@ function handleMixinAndInterfaces( }; return { name, - events: { event }, + ...optionalNestedMember("events", event, { event }), properties: { property }, methods: { method }, ...optionalMember("extends", "string", node.properties?.extends), @@ -398,8 +400,7 @@ async function readPatchDocument(fileUrl: URL): Promise { */ function convertForRemovals(obj: unknown): unknown { if (Array.isArray(obj)) { - const result = obj.map(convertForRemovals).filter((v) => v !== undefined); - return result.length === 0 ? null : result; + return obj.map(convertForRemovals).filter((v) => v !== undefined); } if (obj && typeof obj === "object") { const newObj: Record = {}; From 1075f7bc93ecc3d54181d57fd5b028ad4c76d04b Mon Sep 17 00:00:00 2001 From: Kagami Sascha Rosylight Date: Sun, 7 Dec 2025 17:29:48 +0100 Subject: [PATCH 8/8] amend deprecation messages --- baselines/dom.generated.d.ts | 10 +++++----- baselines/ts5.5/dom.generated.d.ts | 10 +++++----- baselines/ts5.6/dom.generated.d.ts | 10 +++++----- baselines/ts5.9/dom.generated.d.ts | 10 +++++----- inputfiles/patches/cssom.kdl | 2 +- inputfiles/patches/html.kdl | 2 +- inputfiles/patches/uievents.kdl | 4 ++-- 7 files changed, 24 insertions(+), 24 deletions(-) diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index 4a267f8d1..f1bede6cc 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -947,12 +947,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `charCode` is inconsistent across environments, consider using `key` instead. */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `keyCode` is inconsistent across environments, consider using `key` instead. */ keyCode?: number; location?: number; repeat?: boolean; @@ -9195,7 +9195,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. + * @deprecated `word-wrap` is a legacy alias of `overflow-wrap`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39462,7 +39462,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41831,7 +41831,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.5/dom.generated.d.ts b/baselines/ts5.5/dom.generated.d.ts index 459a6fa24..3fde2e5ff 100644 --- a/baselines/ts5.5/dom.generated.d.ts +++ b/baselines/ts5.5/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `charCode` is inconsistent across environments, consider using `key` instead. */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `keyCode` is inconsistent across environments, consider using `key` instead. */ keyCode?: number; location?: number; repeat?: boolean; @@ -9185,7 +9185,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. + * @deprecated `word-wrap` is a legacy alias of `overflow-wrap`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39436,7 +39436,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41805,7 +41805,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.6/dom.generated.d.ts b/baselines/ts5.6/dom.generated.d.ts index 338a06e78..f82e70d6d 100644 --- a/baselines/ts5.6/dom.generated.d.ts +++ b/baselines/ts5.6/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `charCode` is inconsistent across environments, consider using `key` instead. */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `keyCode` is inconsistent across environments, consider using `key` instead. */ keyCode?: number; location?: number; repeat?: boolean; @@ -9192,7 +9192,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. + * @deprecated `word-wrap` is a legacy alias of `overflow-wrap`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39459,7 +39459,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41828,7 +41828,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/baselines/ts5.9/dom.generated.d.ts b/baselines/ts5.9/dom.generated.d.ts index f808757f8..455f52d9b 100644 --- a/baselines/ts5.9/dom.generated.d.ts +++ b/baselines/ts5.9/dom.generated.d.ts @@ -944,12 +944,12 @@ interface KeySystemTrackConfiguration { } interface KeyboardEventInit extends EventModifierInit { - /** @deprecated CharCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `charCode` is inconsistent across environments, consider using `key` instead. */ charCode?: number; code?: string; isComposing?: boolean; key?: string; - /** @deprecated KeyCode is inconsistent across environments, consider using .key instead */ + /** @deprecated `keyCode` is inconsistent across environments, consider using `key` instead. */ keyCode?: number; location?: number; repeat?: boolean; @@ -9192,7 +9192,7 @@ interface CSSStyleProperties extends CSSStyleDeclarationBase { */ wordSpacing: string; /** - * @deprecated The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS. + * @deprecated `word-wrap` is a legacy alias of `overflow-wrap`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/Reference/Properties/overflow-wrap) */ @@ -39459,7 +39459,7 @@ interface WindowEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ onunhandledrejection: ((this: WindowEventHandlers, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ @@ -41828,7 +41828,7 @@ declare var onstorage: ((this: Window, ev: StorageEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unhandledrejection_event) */ declare var onunhandledrejection: ((this: Window, ev: PromiseRejectionEvent) => any) | null; /** - * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events + * @deprecated The unload event is not reliable, consider visibilitychange or pagehide events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/unload_event) */ diff --git a/inputfiles/patches/cssom.kdl b/inputfiles/patches/cssom.kdl index 250f09198..360f6f08a 100644 --- a/inputfiles/patches/cssom.kdl +++ b/inputfiles/patches/cssom.kdl @@ -7,7 +7,7 @@ interface CSSStyleDeclaration \ forwardExtends=CSSStyleProperties interface CSSStyleProperties replaceReference=CSSStyleDeclaration { - property wordWrap deprecated="The 'wordWrap' property is non-standard and has been replaced by 'overflow-wrap' in modern CSS." + property wordWrap deprecated="`word-wrap` is a legacy alias of `overflow-wrap`." } removals { diff --git a/inputfiles/patches/html.kdl b/inputfiles/patches/html.kdl index 71b20bbca..0d6af7a79 100644 --- a/inputfiles/patches/html.kdl +++ b/inputfiles/patches/html.kdl @@ -12,5 +12,5 @@ interface HTMLDocument extends=Document exposed=Window interface-mixin MessageEventTarget overrideThis=T typeParameters=T interface-mixin WindowEventHandlers { - property onunload deprecated="The unload event is not reliable, consider visibilitychange or pagehide events" + property onunload deprecated="The unload event is not reliable, consider visibilitychange or pagehide events." } diff --git a/inputfiles/patches/uievents.kdl b/inputfiles/patches/uievents.kdl index cd826ca66..4ba975cd3 100644 --- a/inputfiles/patches/uievents.kdl +++ b/inputfiles/patches/uievents.kdl @@ -1,4 +1,4 @@ dictionary KeyboardEventInit { - member charCode deprecated="CharCode is inconsistent across environments, consider using .key instead" - member keyCode deprecated="KeyCode is inconsistent across environments, consider using .key instead" + member charCode deprecated="`charCode` is inconsistent across environments, consider using `key` instead." + member keyCode deprecated="`keyCode` is inconsistent across environments, consider using `key` instead." }