@glint/template 1.5.2 → 1.5.3-unstable.18ae940

package/-private/dsl/emit.d.ts

@@ -9,7 +9,12 @@ import {
   TemplateContext,
   NamedArgs,
 } from '../integration';
-import { ElementForTagName } from './types';
+import {
+  AttributesForElement,
+  ElementForTagName,
+  MathMlElementForTagName,
+  SVGElementForTagName,
+} from './types';
 
 /**
  * Used during emit to denote an object literal that corresponds
@@ -38,15 +43,29 @@ export declare function emitContent(value: ContentValue): void;
  *
  * Would produce code like:
  *
- *     emitElement('div', (𝛄) => {
- *       applySplattributes(𝚪.element, 𝛄.element);
- *       applyAttributes(𝛄.element, { class: 'hello' });
- *       applyModifier(𝛄.element, resolve(on)({}, 'click', this.clicked));
+ *     emitElement('div', (__glintY__) => {
+ *       applySplattributes(__glintRef__.element, __glintY__.element);
+ *       applyAttributes(__glintY__.element, { class: 'hello' });
+ *       applyModifier(__glintY__.element, resolve(on)({}, 'click', this.clicked));
  *     });
  */
-export declare function emitElement<Name extends string>(
-  name: Name
-): { element: ElementForTagName<Name> };
+export declare function emitElement<Name extends keyof HTMLElementTagNameMap | 'math' | 'svg'>(
+  name: Name,
+): {
+  element: Name extends 'math'
+    ? MathMlElementForTagName<'math'>
+    : Name extends 'svg'
+      ? SVGElementForTagName<'svg'>
+      : ElementForTagName<Name>;
+};
+
+export declare function emitSVGElement<Name extends keyof SVGElementTagNameMap>(
+  name: Name,
+): { element: SVGElementForTagName<Name> };
+
+export declare function emitMathMlElement<Name extends keyof MathMLElementTagNameMap>(
+  name: Name,
+): { element: MathMlElementForTagName<Name> };
 
 /*
  * Emits the given value as an entity that expects to receive blocks
@@ -60,12 +79,12 @@ export declare function emitElement<Name extends string>(
  * This form of invocation is the only one in a template that may have
  * blocks bound to it. The final line above would produce code like:
  *
- *     emitComponent(resolve(Value)({ foo: bar })), (𝛄) => {
- *       applyModifier(𝛄.element, resolve(baz)({}));
+ *     emitComponent(resolve(Value)({ foo: bar })), (__glintY__) => {
+ *       applyModifier(__glintY__.element, resolve(baz)({}));
  *     });
  */
 export declare function emitComponent<T extends ComponentReturn<any, any>>(
-  component: T
+  component: T,
 ): {
   element: T extends ComponentReturn<any, infer El> ? El : any;
   blockParams: T extends ComponentReturn<infer Yields, any> ? Required<Yields> : any;
@@ -80,8 +99,10 @@ export declare function emitComponent<T extends ComponentReturn<any, any>>(
  */
 export declare function templateExpression<
   Signature extends AnyFunction = () => ComponentReturn<{}>,
-  Context extends AnyContext = TemplateContext<void, {}, {}, void>
->(f: (𝚪: Context, χ: never) => void): new () => InvokableInstance<Signature> & HasContext<Context>;
+  Context extends AnyContext = TemplateContext<void, {}, {}, void>,
+>(
+  f: (__glintRef__: Context, __glintDSL__: never) => void,
+): new () => InvokableInstance<Signature> & HasContext<Context>;
 
 /*
  * Wraps a template body that's backed by a known value (typically a class), either
@@ -98,7 +119,7 @@ export declare function templateExpression<
  */
 export declare function templateForBackingValue<Args extends unknown[], Context extends AnyContext>(
   backingValue: abstract new (...args: Args) => HasContext<Context>,
-  body: (𝚪: Context, χ: never) => void
+  body: (__glintRef__: Context, __glintDSL__: never) => void,
 ): abstract new () => unknown;
 
 /*
@@ -108,11 +129,11 @@ export declare function templateForBackingValue<Args extends unknown[], Context
  *
  * Is equivalent to:
  *
- *     yieldToBlock(𝚪, 'name')(foo, bar);
+ *     yieldToBlock(__glintRef__, 'name')(foo, bar);
  */
 export declare function yieldToBlock<Context extends AnyContext, K extends keyof Context['blocks']>(
-  𝚪: Context,
-  to: K
+  __glintRef__: Context,
+  to: K,
 ): (...values: NonNullable<Context['blocks'][K]>) => void;
 
 /*
@@ -124,7 +145,7 @@ export declare function yieldToBlock<Context extends AnyContext, K extends keyof
  */
 export declare function applySplattributes<
   SourceElement extends Element,
-  TargetElement extends SourceElement
+  TargetElement extends SourceElement,
 >(source: SourceElement, target: TargetElement): void;
 
 /*
@@ -133,7 +154,10 @@ export declare function applySplattributes<
  *     <div foo={{bar}}></div>
  *     <AnotherComponent foo={{bar}} />
  */
-export declare function applyAttributes(element: Element, attrs: Record<string, AttrValue>): void;
+export declare function applyAttributes<T extends Element>(
+  element: T,
+  attrs: Partial<AttributesForElement<T>>,
+): void;
 
 /*
  * Applies a modifier to an element or component.