@discourse/types 2026.9.0-c0ef3a11 → 2026.9.0-cc57a7e8

package/external-types/glint__template/index.d.ts

@@ -109,18 +109,29 @@ declare module '@glint/template/-private/signature' {
 	export type ComponentSignatureArgs<S> = S extends {
 	  Args: infer Args;
 	}
-	  ? Args extends {
-	      Named?: object;
-	      Positional?: unknown[];
-	    }
-	    ? {
-	        Named: Get<S['Args'], 'Named', {}>;
-	        Positional: Get<S['Args'], 'Positional', []>;
-	      }
-	    : {
+	  ? string extends keyof Args
+	    ? // An args map with a string index signature (e.g. `Record<string, never>`
+	      // or `Record<string, unknown>`) is shorthand named args. Without this
+	      // guard, the index signature satisfies the expanded-form test below (it
+	      // "provides" both `Named` and `Positional`), normalizing the signature
+	      // to `{ Named: never; Positional: never }` and making the component
+	      // uninvokable.
+	      {
 	        Named: S['Args'];
 	        Positional: [];
 	      }
+	    : Args extends {
+	          Named?: object;
+	          Positional?: unknown[];
+	        }
+	      ? {
+	          Named: Get<S['Args'], 'Named', {}>;
+	          Positional: Get<S['Args'], 'Positional', []>;
+	        }
+	      : {
+	          Named: S['Args'];
+	          Positional: [];
+	        }
 	  : {
 	      Named: keyof S extends 'Args' | 'Blocks' | 'Element' ? {} : S;
 	      Positional: [];
@@ -257,6 +268,20 @@ declare module '@glint/template' {
 	 */
 	export type AttrValue = string | number | boolean | null | undefined | SafeString;
 
+	/**
+	 * A signature `Args` member for an invokable that accepts no arguments:
+	 * there are no positional arguments, and every named argument is an error.
+	 *
+	 *     import Component from '@glimmer/component';
+	 *     import type { NoArgs } from '@glint/template';
+	 *
+	 *     export default class Divider extends Component<{ Args: NoArgs }> {}
+	 */
+	export type NoArgs = {
+	  Named: Record<string, never>;
+	  Positional: [];
+	};
+
 	/**
 	 * A value that is invokable like a component in a template. In an
 	 * appropriate Glint environment, subclasses of `EmberComponent` and
@@ -1090,18 +1115,78 @@ declare module '@glint/template/-private/dsl/elements' {
 	 global {
 	interface GlobalSVGAttributes extends GlobalHTMLAttributes {
 	  ['about']: AttrValue;
+	  ['alignment-baseline']: AttrValue;
+	  ['baseline-shift']: AttrValue;
 	  ['class']: AttrValue;
+	  ['clip-path']: AttrValue;
+	  ['clip-rule']: AttrValue;
+	  ['color']: AttrValue;
+	  ['color-interpolation']: AttrValue;
+	  ['color-interpolation-filters']: AttrValue;
+	  ['color-rendering']: AttrValue;
 	  ['content']: AttrValue;
+	  ['cursor']: AttrValue;
 	  ['datatype']: AttrValue;
+	  ['direction']: AttrValue;
+	  ['display']: AttrValue;
+	  ['dominant-baseline']: AttrValue;
+	  ['fill']: AttrValue;
+	  ['fill-opacity']: AttrValue;
+	  ['fill-rule']: AttrValue;
+	  ['filter']: AttrValue;
+	  ['flood-color']: AttrValue;
+	  ['flood-opacity']: AttrValue;
+	  ['font-family']: AttrValue;
+	  ['font-size']: AttrValue;
+	  ['font-size-adjust']: AttrValue;
+	  ['font-stretch']: AttrValue;
+	  ['font-style']: AttrValue;
+	  ['font-variant']: AttrValue;
+	  ['font-weight']: AttrValue;
+	  ['glyph-orientation-horizontal']: AttrValue;
+	  ['glyph-orientation-vertical']: AttrValue;
 	  ['id']: AttrValue;
+	  ['image-rendering']: AttrValue;
 	  ['lang']: AttrValue;
+	  ['letter-spacing']: AttrValue;
+	  ['lighting-color']: AttrValue;
+	  ['marker-end']: AttrValue;
+	  ['marker-mid']: AttrValue;
+	  ['marker-start']: AttrValue;
+	  ['mask']: AttrValue;
+	  ['opacity']: AttrValue;
+	  ['overflow']: AttrValue;
+	  ['paint-order']: AttrValue;
+	  ['pointer-events']: AttrValue;
 	  ['property']: AttrValue;
 	  ['rel']: AttrValue;
 	  ['resource']: AttrValue;
 	  ['rev']: AttrValue;
+	  ['shape-rendering']: AttrValue;
+	  ['stop-color']: AttrValue;
+	  ['stop-opacity']: AttrValue;
+	  ['stroke']: AttrValue;
+	  ['stroke-dasharray']: AttrValue;
+	  ['stroke-dashoffset']: AttrValue;
+	  ['stroke-linecap']: AttrValue;
+	  ['stroke-linejoin']: AttrValue;
+	  ['stroke-miterlimit']: AttrValue;
+	  ['stroke-opacity']: AttrValue;
+	  ['stroke-width']: AttrValue;
 	  ['style']: AttrValue;
 	  ['tabindex']: AttrValue;
+	  ['text-anchor']: AttrValue;
+	  ['text-decoration']: AttrValue;
+	  ['text-overflow']: AttrValue;
+	  ['text-rendering']: AttrValue;
+	  ['transform']: AttrValue;
 	  ['typeof']: AttrValue;
+	  ['unicode-bidi']: AttrValue;
+	  ['vector-effect']: AttrValue;
+	  ['visibility']: AttrValue;
+	  ['white-space']: AttrValue;
+	  ['word-spacing']: AttrValue;
+	  ['writing-mode']: AttrValue;
 	  ['onabort']: AttrValue;
 	  ['onactivate']: AttrValue;
 	  ['onafterprint']: AttrValue;
@@ -1206,8 +1291,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -1442,8 +1527,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -1666,8 +1751,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3000,8 +3085,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3084,8 +3169,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3165,8 +3250,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3252,8 +3337,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3560,8 +3645,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3716,8 +3801,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3798,8 +3883,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -3952,8 +4037,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4112,8 +4197,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	}
 	interface SVGSVGElementAttributes extends GlobalSVGAttributes {
 	  ['alignment-baseline']: AttrValue;
-	  ['baseProfile']: AttrValue;
 	  ['baseline-shift']: AttrValue;
+	  ['baseProfile']: AttrValue;
 	  ['clip']: AttrValue;
 	  ['clip-path']: AttrValue;
 	  ['clip-rule']: AttrValue;
@@ -4136,8 +4221,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4168,8 +4253,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['nav-up-right']: AttrValue;
 	  ['opacity']: AttrValue;
 	  ['overflow']: AttrValue;
-	  ['playbackOrder']: AttrValue;
 	  ['playbackorder']: AttrValue;
+	  ['playbackOrder']: AttrValue;
 	  ['pointer-events']: AttrValue;
 	  ['preserveAspectRatio']: AttrValue;
 	  ['requiredExtensions']: AttrValue;
@@ -4192,8 +4277,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['text-anchor']: AttrValue;
 	  ['text-decoration']: AttrValue;
 	  ['text-rendering']: AttrValue;
-	  ['timelineBegin']: AttrValue;
 	  ['timelinebegin']: AttrValue;
+	  ['timelineBegin']: AttrValue;
 	  ['transform']: AttrValue;
 	  ['unicode-bidi']: AttrValue;
 	  ['version']: AttrValue;
@@ -4230,8 +4315,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4383,8 +4468,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4550,8 +4635,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4634,8 +4719,8 @@ declare module '@glint/template/-private/dsl/elements' {
 	  ['filter']: AttrValue;
 	  ['flood-color']: AttrValue;
 	  ['flood-opacity']: AttrValue;
-	  ['focusHighlight']: AttrValue;
 	  ['focusable']: AttrValue;
+	  ['focusHighlight']: AttrValue;
 	  ['font-family']: AttrValue;
 	  ['font-size']: AttrValue;
 	  ['font-size-adjust']: AttrValue;
@@ -4777,6 +4862,67 @@ declare module '@glint/template/-private/dsl/elements' {
 	}
 	}
 
+}
+declare module '@glint/template/-private/dsl/custom-elements' {
+	// Registries for typed custom elements / web components.
+	//
+	// Both interfaces are intentionally empty by default; projects register
+	// their custom elements by merging additional entries into them via
+	// `declare global`.
+
+	 global {
+	  /**
+	   * Maps custom element tag names to their element instance type, mirroring
+	   * the built-in `HTMLElementTagNameMap`. Registering an element here gives
+	   * `<my-element>` a real element type in templates, so modifiers,
+	   * `...attributes`, and hover information all work.
+	   *
+	   * ```ts
+	   * import type { MyElement } from './my-element';
+	   *
+	   * declare global {
+	   *   interface GlintCustomElementTagNameMap {
+	   *     'my-element': MyElement;
+	   *   }
+	   * }
+	   * ```
+	   *
+	   * Note that augmenting the standard `HTMLElementTagNameMap` (as is
+	   * conventional for custom elements, e.g. in Lit) works as well; this
+	   * interface exists for projects that prefer not to extend the DOM's own
+	   * registry.
+	   */
+	  interface GlintCustomElementTagNameMap {
+	    /* intentionally empty; projects register their own custom elements */
+	  }
+
+	  /**
+	   * Maps custom element tag names to the attributes they accept. There is no
+	   * TypeScript mechanism for deriving "settable attributes" from an element
+	   * class (methods and readonly DOM properties would leak in), so attributes
+	   * are registered separately from the element type.
+	   *
+	   * Attributes for tag names registered here are checked strictly; tag names
+	   * not registered here continue to accept arbitrary attribute values.
+	   *
+	   * ```ts
+	   * declare global {
+	   *   interface GlintCustomElementAttributesMap {
+	   *     'my-element': {
+	   *       'prop-num': number;
+	   *       'prop-str': string;
+	   *     };
+	   *   }
+	   * }
+	   * ```
+	   */
+	  interface GlintCustomElementAttributesMap {
+	    /* intentionally empty; projects register their own custom elements */
+	  }
+	}
+
+	export {};
+
 }
 declare module '@glint/template/-private/dsl/lib.dom.augmentation' {
 	// Auto-generated by bin/build-augmentations.mjs
@@ -4924,6 +5070,7 @@ declare module '@glint/template/-private/dsl/lib.dom.augmentation' {
 }
 declare module '@glint/template/-private/dsl/types' {
 	import  '@glint/template/-private/dsl/elements';
+	import  '@glint/template/-private/dsl/custom-elements';
 	import { AttrValue } from  '@glint/template';
 	import type { HTMLElementMap, SVGElementMap } from  '@glint/template/-private/dsl/lib.dom.augmentation';
 
@@ -4939,7 +5086,11 @@ declare module '@glint/template/-private/dsl/types' {
 	 */
 	export type ElementForTagName<Name extends string> = Name extends keyof HTMLElementTagNameMap
 	  ? HTMLElementTagNameMap[Name]
-	  : Element;
+	  : Name extends keyof GlintCustomElementTagNameMap
+	    ? GlintCustomElementTagNameMap[Name] extends Element
+	      ? GlintCustomElementTagNameMap[Name]
+	      : Element
+	    : Element;
 
 	export type SVGElementForTagName<Name extends string> = Name extends keyof SVGElementTagNameMap
 	  ? SVGElementTagNameMap[Name]
@@ -4976,13 +5127,57 @@ declare module '@glint/template/-private/dsl/types' {
 	    : never;
 	}[keyof SVGElementMap];
 
-	type WithDataAttributes<T> = T & Record<`data-${string}`, AttrValue>;
+	export type WithDataAttributes<T> = T & Record<`data-${string}`, AttrValue>;
 
-	export type AttributesForElement<T extends Element> = T extends HTMLElement
-	  ? WithDataAttributes<GlintHtmlElementAttributesMap[HTMLElementLookup<T>]>
-	  : T extends SVGElement
-	    ? WithDataAttributes<GlintSvgElementAttributesMap[SVGElementLookup<T>]>
-	    : Record<string, AttrValue>;
+	/**
+	 * Reverse lookup from an element instance type to its registered custom
+	 * element tag name(s), using the same bidirectional-assignability technique
+	 * as `HTMLElementLookup` above. `never` when the type isn't registered.
+	 */
+	type CustomElementLookup<T> = {
+	  [K in keyof GlintCustomElementTagNameMap]: [GlintCustomElementTagNameMap[K]] extends [T]
+	    ? [T] extends [GlintCustomElementTagNameMap[K]]
+	      ? K
+	      : never
+	    : never;
+	}[keyof GlintCustomElementTagNameMap];
+
+	/**
+	 * Attributes for a registered custom element tag name: strict when the tag
+	 * has an entry in `GlintCustomElementAttributesMap`, otherwise arbitrary
+	 * attribute values are accepted (custom elements take arbitrary attributes,
+	 * and we have no way to know which ones are meaningful).
+	 */
+	type AttributesForCustomElement<Name> = Name extends keyof GlintCustomElementAttributesMap
+	  ? WithDataAttributes<GlintCustomElementAttributesMap[Name]>
+	  : Record<string, AttrValue>;
+
+	export type AttributesForElement<T extends Element> = [CustomElementLookup<T>] extends [never]
+	  ? T extends HTMLElement
+	    ? [HTMLElementLookup<T>] extends [never]
+	      ? // An `HTMLElement` subclass we know nothing about, e.g. an unregistered
+	        // custom element class used as a component signature's `Element`.
+	        Record<string, AttrValue>
+	      : WithDataAttributes<GlintHtmlElementAttributesMap[HTMLElementLookup<T>]>
+	    : T extends SVGElement
+	      ? [SVGElementLookup<T>] extends [never]
+	        ? Record<string, AttrValue>
+	        : WithDataAttributes<GlintSvgElementAttributesMap[SVGElementLookup<T>]>
+	      : Record<string, AttrValue>
+	  : AttributesForCustomElement<CustomElementLookup<T>>;
+
+	/**
+	 * Attributes for an element written with the given tag name. Unlike
+	 * `AttributesForElement`, this can resolve attributes for custom elements
+	 * that only have an attributes registration (no element type registration),
+	 * since it looks up by name rather than by element type.
+	 */
+	export type AttributesForTagName<Name extends string> =
+	  Name extends keyof GlintCustomElementAttributesMap
+	    ? WithDataAttributes<GlintCustomElementAttributesMap[Name]>
+	    : Name extends keyof HTMLElementTagNameMap
+	      ? AttributesForElement<HTMLElementTagNameMap[Name]>
+	      : Record<string, AttrValue>;
 
 }
 declare module '@glint/template/-private/dsl/emit' {
@@ -5000,6 +5195,7 @@ declare module '@glint/template/-private/dsl/emit' {
 	} from  '@glint/template/-private/integration';
 	import {
 	  AttributesForElement,
+	  AttributesForTagName,
 	  ElementForTagName,
 	  MathMlElementForTagName,
 	  SVGElementForTagName,
@@ -5024,6 +5220,47 @@ declare module '@glint/template/-private/dsl/emit' {
 	 */
 	export  function emitContent(value: ContentValue): void;
 
+	/*
+	 * Rewrites hyphens in tag names to underscores so that tag names can be
+	 * emitted as *identifier* property accesses of the same length as the source
+	 * tag name. Both constraints matter: hover only works when TypeScript's
+	 * quickinfo textSpan (the referenced identifier) lies entirely within a
+	 * length-preserving mapping back to the template — a quoted key's textSpan
+	 * includes the quotes, which have no source counterpart, so Volar drops the
+	 * hover result. (This is the same trick used for hyphenated keywords like
+	 * `each-in` -> `Globals.each_in`.)
+	 */
+	type IdentifierSafeName<Name> = Name extends `${infer Head}-${infer Tail}`
+	  ? `${Head}_${IdentifierSafeName<Tail>}`
+	  : Name;
+
+	type IdentifierSafeKeys<T> = {
+	  [K in keyof T as IdentifierSafeName<K & string>]: T[K];
+	};
+
+	/*
+	 * A value-level tag name -> element type lookup. The transform emits
+	 * discarded references like:
+	 *
+	 *     __glintDSL__.noop(__glintDSL__.elementTypes.my_element);
+	 *     __glintDSL__.noop(__glintDSL__.elementTypes["my-element"]);
+	 *
+	 * with the tag name in the template mapped onto both, so that hovering an
+	 * element's tag name shows its element type (served by the identifier form)
+	 * and go-to-definition resolves to the corresponding `HTMLElementTagNameMap`
+	 * / `GlintCustomElementTagNameMap` entry (served by the raw-key form, since
+	 * TypeScript retains no declaration links through the key-remapped copies).
+	 */
+	export  const elementTypes: HTMLElementTagNameMap &
+	  GlintCustomElementTagNameMap &
+	  IdentifierSafeKeys<HTMLElementTagNameMap> &
+	  IdentifierSafeKeys<GlintCustomElementTagNameMap> & {
+	    svg: SVGSVGElement;
+	    math: MathMLElement;
+	  } & {
+	    [tagName: string]: Element;
+	  };
+
 	/*
 	 * Emits an element of the given name, providing a value to the
 	 * given handler of an appropriate type for the DOM node that will
@@ -5042,20 +5279,35 @@ declare module '@glint/template/-private/dsl/emit' {
 	export  function emitElement<Name extends string | 'math' | 'svg'>(
 	  name: Name,
 	): {
+	  name: Name;
 	  element: Name extends 'math'
 	    ? MathMlElementForTagName<'math'>
 	    : Name extends 'svg'
 	      ? SVGElementForTagName<'svg'>
 	      : ElementForTagName<Name>;
+	  attributes: Name extends 'math'
+	    ? Record<string, AttrValue>
+	    : Name extends 'svg'
+	      ? AttributesForElement<SVGElementForTagName<'svg'>>
+	      : AttributesForTagName<Name>;
 	};
 
 	export  function emitSVGElement<Name extends keyof SVGElementTagNameMap>(
 	  name: Name,
-	): { element: SVGElementForTagName<Name> };
+	): {
+	  name: Name;
+	  element: SVGElementForTagName<Name>;
+	  attributes: AttributesForElement<SVGElementTagNameMap[Name]>;
+	};
 
 	export  function emitMathMlElement<Name extends keyof MathMLElementTagNameMap>(
 	  name: Name,
-	): { element: MathMlElementForTagName<Name> };
+	): {
+	  name: Name;
+	  element: MathMlElementForTagName<Name>;
+	  // MathML elements have no attribute typings, so anything goes.
+	  attributes: Record<string, AttrValue>;
+	};
 
 	/*
 	 * Emits the given value as an entity that expects to receive blocks
@@ -5149,6 +5401,25 @@ declare module '@glint/template/-private/dsl/emit' {
 	  attrs: Partial<AttributesForElement<T>>,
 	): void;
 
+	/*
+	 * Applies named attributes to a plain element, resolving them from the tag
+	 * name the element was emitted with (via the `attributes` member of the
+	 * `emitElement`/`emitSVGElement`/`emitMathMlElement` result) rather than from
+	 * the element's instance type. This is what allows registered custom elements
+	 * to have their attributes checked.
+	 *
+	 *     <my-element prop-num={{123}}></my-element>
+	 *
+	 * Would produce code like:
+	 *
+	 *     const __glintY__ = emitElement('my-element');
+	 *     applyTagAttributes(__glintY__, { 'prop-num': 123 });
+	 */
+	export  function applyTagAttributes<T extends { attributes: object }>(
+	  target: T,
+	  attrs: Partial<T['attributes']>,
+	): void;
+
 	/*
 	 * Applies a modifier to an element or component.
 	 *
@@ -5309,7 +5580,7 @@ declare module '@glint/template/-private/keywords/-bind-invokable' {
 	  // {{bind invokableWithNamedAndPositionalArgs name="foo"}}
 	  <Named, Positional extends unknown[], Return extends Kind, GivenNamed extends Partial<Named>>(
 	    invokable: (...args: [...Positional, NamedArgs<Named>]) => Return,
-	    named: GivenNamed,
+	    named: NamedArgs<GivenNamed>,
 	  ): Invokable<
 	    (
 	      ...args: [
@@ -5319,9 +5590,9 @@ declare module '@glint/template/-private/keywords/-bind-invokable' {
 	    ) => Return
 	  >;
 	  <Named, Positional extends unknown[], Return extends Kind, GivenNamed extends Partial<Named>>(
-	    invokable: (...args: [...Positional, NamedArgs<Named>]) => Return,
-	    named: GivenNamed,
-	  ): Invokable<
+	    invokable: null | undefined | ((...args: [...Positional, NamedArgs<Named>]) => Return),
+	    named: NamedArgs<GivenNamed>,
+	  ): null | Invokable<
 	    (
 	      ...args: [
 	        ...Positional,

package/external-types/glint__template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glint/template",
-  "version": "1.7.8",
+  "version": "1.9.0",
   "repository": "typed-ember/glint",
   "description": "Type definitions to back typechecking for Glimmer templates",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "html-element-attributes": "^3.5.0",
     "html-event-attributes": "^2.2.0",
     "sums-up": "^2.1.0",
-    "svg-element-attributes": "^2.1.0",
+    "svg-element-attributes": "^2.2.0",
     "svg-event-attributes": "^2.0.2",
     "typescript": "^5.9.3"
   },