element-vir 4.0.2 → 4.1.2

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

@@ -15,8 +15,14 @@ export function defineFunctionalElement(functionalElementInit) {
         static events = eventsMap;
         static renderCallback = functionalElementInit.renderCallback;
         static props = createPropertyDescriptorMap(functionalElementInit.props);
+        initCalled = false;
         render() {
-            return functionalElementInit.renderCallback(this.createRenderParams());
+            const renderParams = this.createRenderParams();
+            if (!this.initCalled && functionalElementInit.initCallback) {
+                this.initCalled = true;
+                functionalElementInit.initCallback(renderParams);
+            }
+            return functionalElementInit.renderCallback(renderParams);
         }
         instanceProps = createPropertyProxy(functionalElementInit.props, this);
         constructor() {

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

@@ -1,7 +1,7 @@
 import { CSSResult, LitElement, TemplateResult } from 'lit';
 import { EventDescriptorMap, EventsInitMap } from './element-events';
 import { ElementPropertyDescriptorMap, PropertyInitMapBase } from './element-properties';
-import { RenderCallback } from './render-callback';
+import { InitCallback, RenderCallback } from './render-callback';
 export declare type CustomElementTagName = `${string}-${string}`;
 export declare type FunctionalElementInit<PropertyInitGeneric extends PropertyInitMapBase, EventsInitGeneric extends EventsInitMap> = {
     /**
@@ -15,6 +15,8 @@ export declare type FunctionalElementInit<PropertyInitGeneric extends PropertyIn
     props?: PropertyInitGeneric | undefined;
     /** Initializer for events that the element can dispatch. (These can be thought of as "outputs".) */
     events?: EventsInitGeneric | undefined;
+    /** Called as part of the first renderCallback call, before the first renderCallback call. */
+    initCallback?: InitCallback<PropertyInitGeneric, EventsInitGeneric>;
     renderCallback: RenderCallback<PropertyInitGeneric, EventsInitGeneric>;
 };
 export declare abstract class FunctionalElementBaseClass<PropertyInitGeneric extends PropertyInitMapBase> extends LitElement {

package/dist/functional-element/render-callback.d.ts

@@ -3,7 +3,8 @@ import { TypedEvent } from '../typed-event/typed-event';
 import { EventDescriptorMap, EventInitMapEventDetailExtractor, EventsInitMap } from './element-events';
 import { PropertyInitMapBase } from './element-properties';
 import { FunctionalElementInstance } from './functional-element';
-export declare type RenderCallback<PropertyInitGeneric extends PropertyInitMapBase, EventsInitGeneric extends EventsInitMap> = (params: RenderParams<PropertyInitGeneric, EventsInitGeneric>) => TemplateResult | Promise<TemplateResult>;
+export declare type RenderCallback<PropertyInitGeneric extends PropertyInitMapBase, EventsInitGeneric extends EventsInitMap> = (params: RenderParams<PropertyInitGeneric, EventsInitGeneric>) => TemplateResult;
+export declare type InitCallback<PropertyInitGeneric extends PropertyInitMapBase, EventsInitGeneric extends EventsInitMap> = (params: RenderParams<PropertyInitGeneric, EventsInitGeneric>) => void;
 export declare type RenderParams<PropertyInitGeneric extends PropertyInitMapBase, EventsInitGeneric extends EventsInitMap> = {
     props: PropertyInitGeneric;
     events: EventDescriptorMap<EventsInitGeneric>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "element-vir",
-    "version": "4.0.2",
+    "version": "4.1.2",
     "keywords": [
         "custom",
         "web",
@@ -37,16 +37,16 @@
         "update-docs": "virmator code-in-markdown README.md --index src/index.ts"
     },
     "dependencies": {
-        "augment-vir": "^1.4.3",
-        "lit": "^2.1.1"
+        "augment-vir": "^1.5.1",
+        "lit": "^2.2.0"
     },
     "devDependencies": {
         "@types/jest": "^27.4.0",
-        "jest": "^27.4.7",
+        "jest": "^27.5.1",
         "ts-jest": "^27.1.3",
-        "ts-node": "^10.4.0",
-        "typescript": "^4.5.4",
-        "virmator": "^1.3.7",
-        "vite": "^2.7.12"
+        "ts-node": "^10.5.0",
+        "typescript": "^4.5.5",
+        "virmator": "^1.4.4",
+        "vite": "^2.8.4"
     }
 }