element-vir 25.0.2 → 25.2.0

package/dist/declarative-element/declarative-element.d.ts

@@ -79,7 +79,6 @@ export declare abstract class DeclarativeElement<TagName extends CustomElementTa
      * be called using the `.assign()` method on an element definition inside of an HTML template.
      */
     abstract assignInputs(inputs: EmptyObject extends Required<Inputs> ? never : Partial<Inputs>): void;
-    abstract _haveInputsBeenSet: boolean;
     /** The element definition for this element instance. */
     abstract readonly definition: DeclarativeElementDefinition<TagName, Inputs, State, EventsInit, HostClassKeys, CssVarKeys, SlotNames>;
 }
@@ -88,7 +87,7 @@ export declare abstract class DeclarativeElement<TagName extends CustomElementTa
  *
  * @category Internal
  */
-export type AssignMethod<Inputs extends PropertyInitMapBase> = IsAny<Inputs> extends true ? any : IsEmptyObject<Required<Inputs>> extends true ? (inputsObject: never) => never : (inputsObject: IsEmptyObject<Required<Inputs>> extends true ? never : Inputs) => MinimalDefinitionWithInputs;
+export type AssignMethod<TagName extends CustomElementTagName, Inputs extends PropertyInitMapBase> = IsAny<Inputs> extends true ? any : IsEmptyObject<Required<Inputs>> extends true ? (inputsObject: never) => never : (inputsObject: IsEmptyObject<Required<Inputs>> extends true ? never : Inputs) => MinimalDefinitionWithInputs<TagName>;
 /**
  * All static properties on a declarative element. These all come from the element's definition.
  *
@@ -96,7 +95,7 @@ export type AssignMethod<Inputs extends PropertyInitMapBase> = IsAny<Inputs> ext
  */
 export type StaticDeclarativeElementProperties<TagName extends CustomElementTagName, Inputs extends PropertyInitMapBase, State extends PropertyInitMapBase, EventsInit extends EventsInitMap, HostClassKeys extends BaseCssPropertyName<TagName>, CssVarKeys extends BaseCssPropertyName<TagName>, SlotNames extends ReadonlyArray<string>> = {
     /** Assign inputs to an element directly on its interpolated tag. */
-    readonly assign: AssignMethod<Inputs>;
+    readonly assign: AssignMethod<TagName, Inputs>;
     assignedInputs: Inputs | undefined;
     /** Pass through the render callback for direct unit testability */
     readonly render: RenderCallback<TagName, Inputs, State, EventsInit, HostClassKeys, CssVarKeys, SlotNames>;
@@ -109,6 +108,6 @@ export type StaticDeclarativeElementProperties<TagName extends CustomElementTagN
     readonly UpdateStateType: UpdateStateCallback<State>;
     readonly hostClasses: HostClassNamesMap<string, HostClassKeys>;
     readonly cssVars: CssVars<TagName, CssVarKeys>;
-    readonly tagName: string;
+    readonly tagName: TagName;
     readonly styles: CSSResult;
 };

package/dist/declarative-element/define-element-no-inputs.js

@@ -5,7 +5,6 @@ import { defineCssVars } from 'lit-css-vars';
 import { css } from '../template-transforms/vir-css/vir-css.js';
 import { DeclarativeElement, } from './declarative-element.js';
 import { defaultDeclarativeElementDefinitionOptions, } from './definition-options.js';
-import { hasDeclarativeElementParent } from './has-declarative-element-parent.js';
 import { assignInputs } from './properties/assign-inputs.js';
 import { assertValidCssProperties } from './properties/css-properties.js';
 import { createEventDescriptorMap, } from './properties/element-events.js';
@@ -108,18 +107,9 @@ export function defineElementNoInputs(init) {
         _stateCalled = false;
         _hasRendered = false;
         _lastRenderedProps = undefined;
-        _haveInputsBeenSet = false;
         render() {
             this._internalRenderCount++;
             try {
-                if (
-                // This ignores elements at the root of a page, as they can't receive inputs from
-                // other elements (cause they have no custom element ancestors).
-                hasDeclarativeElementParent(this) &&
-                    !this._haveInputsBeenSet &&
-                    !elementOptions.ignoreUnsetInputs) {
-                    console.warn(this, `${init.tagName} got rendered before its input object was set. This was most likely caused by forgetting to use '.assign()' on its opening tag. If no inputs are intended, use '${defineElementNoInputs.name}' to define ${init.tagName}.`);
-                }
                 this._hasRendered = true;
                 const renderParams = this.createRenderParams();
                 if (!this._stateCalled && init.state) {

package/dist/declarative-element/define-element.js

@@ -37,7 +37,6 @@ export function defineElement(
         return defineElementNoInputs({
             ...init,
             options: {
-                ignoreUnsetInputs: false,
                 ...init.options,
             },
         });

package/dist/declarative-element/definition-options.d.ts

@@ -4,8 +4,6 @@
  * @category Internal
  */
 export type DeclarativeElementDefinitionOptions = {
-    /** For internal use only. */
-    ignoreUnsetInputs: boolean;
     /**
      * If set to true, state property keys will be allowed to change at run time. Turning this on
      * will greatly reduce type safety and should be avoided.

package/dist/declarative-element/definition-options.js

@@ -4,6 +4,5 @@
  * @internal
  */
 export const defaultDeclarativeElementDefinitionOptions = {
-    ignoreUnsetInputs: true,
     allowPolymorphicState: false,
 };

package/dist/declarative-element/properties/assign-inputs.d.ts

@@ -1,2 +1 @@
 export declare function assignInputs(element: Element, inputs: object): void;
-export declare function markInputsAsHavingBeenSet(element: Element): void;

package/dist/declarative-element/properties/assign-inputs.js

@@ -22,10 +22,4 @@ export function assignInputs(element, inputs) {
             }
         });
     }
-    markInputsAsHavingBeenSet(element);
-}
-export function markInputsAsHavingBeenSet(element) {
-    if (!element._haveInputsBeenSet) {
-        element._haveInputsBeenSet = true;
-    }
 }

package/dist/index.d.ts

@@ -35,5 +35,6 @@ export * from './template-transforms/vir-css/vir-css.js';
 export * from './template-transforms/vir-html/html-interpolation.js';
 export * from './template-transforms/vir-html/vir-html.js';
 export * from './typed-event/typed-event.js';
+export * from './util/increment.js';
 export * from './util/lit-template.js';
 export * from './util/type.js';

package/dist/index.js

@@ -35,5 +35,6 @@ export * from './template-transforms/vir-css/vir-css.js';
 export * from './template-transforms/vir-html/html-interpolation.js';
 export * from './template-transforms/vir-html/vir-html.js';
 export * from './typed-event/typed-event.js';
+export * from './util/increment.js';
 export * from './util/lit-template.js';
 export * from './util/type.js';

package/dist/template-transforms/minimal-element-definition.d.ts

@@ -6,8 +6,8 @@ import { PropertyInitMapBase } from '../declarative-element/properties/element-p
  *
  * @category Internal
  */
-export type MinimalElementDefinition = {
-    tagName: string;
+export type MinimalElementDefinition<TagName extends string = string> = {
+    tagName: TagName;
     elementOptions?: DeclarativeElementDefinitionOptions | undefined;
     /** This is used when wrapping interpolated raw tag name strings. */
     tagInterpolationKey?: {
@@ -20,14 +20,14 @@ export type MinimalElementDefinition = {
  *
  * @category Internal
  */
-export type MinimalDefinitionWithInputs = {
+export type MinimalDefinitionWithInputs<TagName extends string = string> = {
     /**
      * This is what marks instance of this type as such. This does not use a symbol so it's
      * compatible with multiple `element-vir` versions being installed at once (like if a dependency
      * uses a different version).
      */
     _elementVirIsMinimalDefinitionWithInputs: true;
-    definition: MinimalElementDefinition;
+    definition: MinimalElementDefinition<TagName>;
     inputs: PropertyInitMapBase;
 };
 /**

package/dist/template-transforms/vir-html/html-interpolation.d.ts

@@ -1,7 +1,8 @@
-import { type AnyFunction } from '@augment-vir/common';
+import { type AnyFunction, type Overwrite } from '@augment-vir/common';
 import { type CSSResult, type TemplateResult, type nothing } from 'lit';
-import { type EmptyObject } from 'type-fest';
+import { type EmptyObject, type HasRequiredKeys, type IsNever } from 'type-fest';
 import { type DeclarativeElementDefinition } from '../../declarative-element/declarative-element.js';
+import type { Decrement, Increment } from '../../util/increment.js';
 import { type MinimalDefinitionWithInputs, type MinimalElementDefinition } from '../minimal-element-definition.js';
 /**
  * Unfortunately the type for `DirectiveResult` means it's just an empty object. So in order to
@@ -17,3 +18,25 @@ export type DirectiveOutput = EmptyObject;
  * @category Internal
  */
 export type HtmlInterpolation = null | undefined | string | number | boolean | bigint | CSSResult | Readonly<CSSResult> | Element | Readonly<Element> | TemplateResult | Readonly<TemplateResult> | MinimalElementDefinition | Readonly<MinimalElementDefinition> | MinimalDefinitionWithInputs | Readonly<MinimalDefinitionWithInputs> | DeclarativeElementDefinition | Readonly<DeclarativeElementDefinition> | DirectiveOutput | Readonly<DirectiveOutput> | AnyFunction | typeof nothing | HtmlInterpolation[] | ReadonlyArray<HtmlInterpolation>;
+/**
+ * This type ensures that interpolated element definitions are not missing their inputs, when inputs
+ * are required.
+ *
+ * @category Internal
+ */
+export type VerifyHtmlValues<Values extends HtmlInterpolation[], WaitingForEndTags extends Record<string, number> = {}> = Values extends [
+    infer CurrentDefinition extends DeclarativeElementDefinition,
+    ...infer Rest extends HtmlInterpolation[]
+] ? CurrentDefinition extends DeclarativeElementDefinition<infer TagName, infer Inputs> ? HasRequiredKeys<Inputs> extends true ? IsNever<Decrement<WaitingForEndTags[TagName]>> extends true ? [
+    `ERROR: This element is missing its inputs.`,
+    ...VerifyHtmlValues<Rest, WaitingForEndTags>
+] : [
+    CurrentDefinition,
+    ...VerifyHtmlValues<Rest, Overwrite<WaitingForEndTags, Record<TagName, Decrement<WaitingForEndTags[TagName]>>>>
+] : [CurrentDefinition, ...VerifyHtmlValues<Rest, WaitingForEndTags>] : [CurrentDefinition, ...VerifyHtmlValues<Rest, WaitingForEndTags>] : Values extends [
+    infer CurrentDefinition extends MinimalDefinitionWithInputs,
+    ...infer Rest extends HtmlInterpolation[]
+] ? [
+    CurrentDefinition,
+    ...VerifyHtmlValues<Rest, Overwrite<WaitingForEndTags, Record<CurrentDefinition['definition']['tagName'], Increment<WaitingForEndTags[CurrentDefinition['definition']['tagName']]>>>>
+] : Values;

package/dist/template-transforms/vir-html/html-transform.js

@@ -60,12 +60,6 @@ function transformHtml(...[lastNewString, currentTemplateString, rawCurrentValue
     if (!shouldHaveTagNameHere || !isTagNameWrapper) {
         return undefined;
     }
-    if (isOpeningTag &&
-        currentValue.elementOptions &&
-        !currentValue.elementOptions.ignoreUnsetInputs &&
-        !isMinimalDefinitionWithInputs(rawCurrentValue)) {
-        throw new Error(`Missing inputs for '${currentValue.tagName}'`);
-    }
     const replacement = currentValue.tagName;
     return {
         replacement,

package/dist/template-transforms/vir-html/vir-html.d.ts

@@ -1,5 +1,5 @@
 import { HTMLTemplateResult } from '../../lit-exports/all-lit-exports.js';
-import { HtmlInterpolation } from './html-interpolation.js';
+import { HtmlInterpolation, VerifyHtmlValues } from './html-interpolation.js';
 /**
  * Interprets a template literal as an HTML template which is lazily rendered to the DOM.
  *
@@ -8,4 +8,4 @@ import { HtmlInterpolation } from './html-interpolation.js';
  *
  * @category Element Definition
  */
-export declare function html(inputTemplateStrings: TemplateStringsArray, ...inputValues: HtmlInterpolation[]): HTMLTemplateResult;
+export declare function html<const Values extends HtmlInterpolation[]>(inputTemplateStrings: TemplateStringsArray, ...inputValues: VerifyHtmlValues<Values>): HTMLTemplateResult;

package/dist/util/increment.d.ts

@@ -0,0 +1,55 @@
+import type { ArrayElement } from '@augment-vir/common';
+import type { IsNever } from 'type-fest';
+/**
+ * The largest number in this tuple is the largest number of nestings of the same element that
+ * `element-vir` will support with types (in runtime it'll support any level of nesting the same
+ * element).
+ *
+ * @category Internal
+ */
+export type Incrementable = [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    8,
+    9,
+    10,
+    11,
+    12,
+    13,
+    14,
+    15,
+    16,
+    17,
+    18,
+    19,
+    20,
+    21,
+    22,
+    23,
+    24,
+    25,
+    26,
+    27,
+    28,
+    29,
+    30
+];
+/**
+ * Increments the given number. If an invalid type parameter is given, it is treated as `0` and this
+ * will output `1`. If the upper bound of increments has been reached, this will output `never`.
+ *
+ * @category Internal
+ */
+export type Increment<T> = IsNever<Extract<ArrayElement<Incrementable>, T>> extends true ? IsNever<T> extends true ? 1 : never : Incrementable extends [any, ...infer Rest] ? T extends keyof Rest ? Rest[T] extends undefined ? never : Rest[T] : 1 : 1;
+/**
+ * Decrements the given number. If an invalid type parameter is given, `never` is the output.
+ *
+ * @category Internal
+ */
+export type Decrement<T> = IsNever<Extract<ArrayElement<Incrementable>, T>> extends true ? never : T extends keyof Incrementable ? [never, ...Incrementable][T] : never;

package/dist/util/increment.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "element-vir",
-    "version": "25.0.2",
+    "version": "25.2.0",
     "keywords": [
         "custom",
         "web",
@@ -38,8 +38,8 @@
         "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.10.0",
-        "@augment-vir/common": "^31.10.0",
+        "@augment-vir/assert": "^31.10.1",
+        "@augment-vir/common": "^31.10.1",
         "date-vir": "^7.3.1",
         "lit": "^3.2.1",
         "lit-css-vars": "^3.0.11",
@@ -49,8 +49,8 @@
         "typed-event-target": "^4.0.3"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.10.0",
-        "@augment-vir/web": "^31.10.0",
+        "@augment-vir/test": "^31.10.1",
+        "@augment-vir/web": "^31.10.1",
         "@web/dev-server-esbuild": "^1.0.4",
         "@web/test-runner": "^0.20.0",
         "@web/test-runner-commands": "^0.9.0",
@@ -59,10 +59,10 @@
         "html-spec-tags": "^2.2.2",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.3",
-        "type-fest": "^4.37.0",
-        "typedoc": "^0.27.9",
+        "type-fest": "^4.38.0",
+        "typedoc": "^0.28.1",
         "typescript": "5.8.2",
-        "vite": "^6.2.1",
+        "vite": "^6.2.3",
         "vite-tsconfig-paths": "^5.1.4"
     },
     "engines": {