element-vir 26.14.0 → 26.14.2

package/dist/declarative-element/directives/render-async.directive.d.ts

@@ -1,4 +1,23 @@
+import { type PartialWithUndefined } from '@augment-vir/common';
 import { type AsyncProp } from './async-prop.js';
+/**
+ * Options for {@link renderAsync}.
+ *
+ * @category Internal
+ */
+export type RenderAsyncOptions = PartialWithUndefined<{
+    /**
+     * When set to `true`, uses `lastResolvedValue` instead of `value` from the async prop. This is
+     * useful when you want to keep showing the last resolved value while a new promise is pending.
+     */
+    useLastResolvedValue: boolean;
+}>;
+/**
+ * Properties from AsyncProp used by {@link renderAsync}.
+ *
+ * @category Internal
+ */
+export type RenderAsyncPropInput<T> = Pick<AsyncProp<T, any>, 'value' | 'lastResolvedValue'>;
 /**
  * Given a {@link AsyncProp} instance, call and return the output of the `resolutionRender` parameter
  * once the {@link AsyncProp} has been resolved, call and return the output of the `errorRender`
@@ -9,7 +28,7 @@ import { type AsyncProp } from './async-prop.js';
  *
  * @category Async
  */
-export declare function renderAsync<T, FallbackResult, ResolutionRenderResult = never, ErrorRenderResult = never>(asyncProp: Pick<AsyncProp<T, any>, 'value'>, fallback: FallbackResult, resolutionRender: (resolved: Awaited<T>) => ResolutionRenderResult, errorRender: (error: Error) => ErrorRenderResult): FallbackResult | ResolutionRenderResult | ErrorRenderResult;
+export declare function renderAsync<T, FallbackResult, ResolutionRenderResult = never, ErrorRenderResult = never>(asyncProp: RenderAsyncPropInput<T>, fallback: FallbackResult, resolutionRender: (resolved: Awaited<T>) => ResolutionRenderResult, errorRender: (error: Error) => ErrorRenderResult, options?: RenderAsyncOptions): FallbackResult | ResolutionRenderResult | ErrorRenderResult;
 /**
  * Given a {@link AsyncProp} instance, call and return the output of the `resolutionRender` parameter
  * once the {@link AsyncProp} has been resolved, call and return the output of the `errorRender`
@@ -20,7 +39,7 @@ export declare function renderAsync<T, FallbackResult, ResolutionRenderResult =
  *
  * @category Async
  */
-export declare function renderAsync<T, FallbackResult, ResolutionRenderResult = never>(asyncProp: Pick<AsyncProp<T, any>, 'value'>, fallback: FallbackResult, resolutionRender: (resolved: Awaited<T>) => ResolutionRenderResult, errorRender?: undefined): FallbackResult | ResolutionRenderResult | string;
+export declare function renderAsync<T, FallbackResult, ResolutionRenderResult = never>(asyncProp: RenderAsyncPropInput<T>, fallback: FallbackResult, resolutionRender: (resolved: Awaited<T>) => ResolutionRenderResult, errorRender?: undefined, options?: RenderAsyncOptions): FallbackResult | ResolutionRenderResult | string;
 /**
  * Given a {@link AsyncProp} instance, call and return the output of the `resolutionRender` parameter
  * once the {@link AsyncProp} has been resolved, call and return the output of the `errorRender`
@@ -31,7 +50,7 @@ export declare function renderAsync<T, FallbackResult, ResolutionRenderResult =
  *
  * @category Async
  */
-export declare function renderAsync<T, FallbackResult, ErrorRenderResult = never>(asyncProp: Pick<AsyncProp<T, any>, 'value'>, fallback: FallbackResult, resolutionRender: undefined, errorRender: (error: Error) => ErrorRenderResult): FallbackResult | Awaited<T> | ErrorRenderResult;
+export declare function renderAsync<T, FallbackResult, ErrorRenderResult = never>(asyncProp: RenderAsyncPropInput<T>, fallback: FallbackResult, resolutionRender: undefined, errorRender: (error: Error) => ErrorRenderResult, options?: RenderAsyncOptions): FallbackResult | Awaited<T> | ErrorRenderResult;
 /**
  * Given a {@link AsyncProp} instance, call and return the output of the `resolutionRender` parameter
  * once the {@link AsyncProp} has been resolved, call and return the output of the `errorRender`
@@ -42,4 +61,4 @@ export declare function renderAsync<T, FallbackResult, ErrorRenderResult = never
  *
  * @category Async
  */
-export declare function renderAsync<T, FallbackResult>(asyncProp: Pick<AsyncProp<T, any>, 'value'>, fallback: FallbackResult, resolutionRender?: undefined, errorRender?: undefined): FallbackResult | Awaited<T> | string;
+export declare function renderAsync<T, FallbackResult>(asyncProp: RenderAsyncPropInput<T>, fallback: FallbackResult, resolutionRender?: undefined, errorRender?: undefined, options?: RenderAsyncOptions): FallbackResult | Awaited<T> | string;

package/dist/declarative-element/directives/render-async.directive.js

@@ -12,15 +12,18 @@ import { extractErrorMessage } from '@augment-vir/common';
  */
 export function renderAsync(asyncProp, 
 /** This value will be rendered if the async prop has not settled yet. */
-fallback, resolutionRender, errorRender) {
-    const asyncPropValue = asyncProp.value;
+fallback, resolutionRender, errorRender, options = {}) {
+    const asyncPropValue = options.useLastResolvedValue
+        ? asyncProp.lastResolvedValue
+        : asyncProp.value;
     if (asyncPropValue instanceof Error) {
         const errorResult = errorRender
             ? errorRender(asyncPropValue)
             : extractErrorMessage(asyncPropValue);
         return errorResult;
     }
-    else if (check.isPromiseLike(asyncPropValue)) {
+    else if (check.isPromiseLike(asyncPropValue) ||
+        (options.useLastResolvedValue && asyncPropValue === undefined)) {
         const fallbackResult = fallback;
         return fallbackResult;
     }

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

@@ -3,15 +3,13 @@ import { type DeclarativeElementDefinition } from './declarative-element.js';
  * Asserts that the given input is a declarative element definition.
  *
  * @category Util
- * @see
- * - {@link isDeclarativeElementDefinition}
+ * @see {@link isDeclarativeElementDefinition}
  */
 export declare function assertDeclarativeElementDefinition(input: unknown, failMessage?: string | undefined): asserts input is DeclarativeElementDefinition;
 /**
  * Checks that the given input is a declarative element definition.
  *
  * @category Util
- * @see
- * - {@link assertDeclarativeElementDefinition}
+ * @see {@link assertDeclarativeElementDefinition}
  */
 export declare function isDeclarativeElementDefinition(input: unknown): input is DeclarativeElementDefinition;

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

@@ -21,8 +21,7 @@ const expectedStaticProperties = getObjectTypedKeys({
  * Asserts that the given input is a declarative element definition.
  *
  * @category Util
- * @see
- * - {@link isDeclarativeElementDefinition}
+ * @see {@link isDeclarativeElementDefinition}
  */
 export function assertDeclarativeElementDefinition(input, failMessage) {
     if (!check.isFunction(input)) {
@@ -38,8 +37,7 @@ export function assertDeclarativeElementDefinition(input, failMessage) {
  * Checks that the given input is a declarative element definition.
  *
  * @category Util
- * @see
- * - {@link assertDeclarativeElementDefinition}
+ * @see {@link assertDeclarativeElementDefinition}
  */
 export function isDeclarativeElementDefinition(input) {
     return wrapInTry(() => {

package/dist/lit-exports/base-lit-exports.d.ts

@@ -1,5 +1,5 @@
-export { LitElement, noChange, nothing, svg, unsafeCSS } from 'lit';
-export type { CSSResult, CSSResultGroup, CompiledTemplate, CompiledTemplateResult, HTMLTemplateResult, SVGTemplateResult, TemplateResult, } from 'lit';
+export { CSSResult, LitElement, noChange, nothing, svg, unsafeCSS } from 'lit';
+export type { CSSResultGroup, CompiledTemplate, CompiledTemplateResult, HTMLTemplateResult, SVGTemplateResult, TemplateResult, } from 'lit';
 export * from 'lit/async-directive.js';
 export * from 'lit/decorators.js';
 export * from 'lit/directive-helpers.js';

package/dist/lit-exports/base-lit-exports.js

@@ -1,4 +1,4 @@
-export { LitElement, noChange, nothing, svg, unsafeCSS } from 'lit';
+export { CSSResult, LitElement, noChange, nothing, svg, unsafeCSS } from 'lit';
 export * from 'lit/async-directive.js';
 export * from 'lit/decorators.js';
 export * from 'lit/directive-helpers.js';

package/dist/lit-exports/lit-repeat-fix.d.ts

@@ -1,8 +1,8 @@
 export type { KeyFn } from 'lit/directives/repeat.js';
 export type { RepeatDirective };
+import { type ChildPart, type noChange } from 'lit-html';
 import { type Directive, type PartInfo } from 'lit-html/directive.js';
 import { type KeyFn } from 'lit-html/directives/repeat.js';
-import { type ChildPart, type noChange } from 'lit-html/lit-html.js';
 import { type HtmlInterpolation } from '../template-transforms/vir-html/html-interpolation.js';
 /**
  * A modified class type for the built-in lit `repeat` directive which works for element-vir

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "element-vir",
-    "version": "26.14.0",
+    "version": "26.14.2",
     "keywords": [
         "custom",
         "web",
@@ -39,19 +39,19 @@
         "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.57.3",
-        "@augment-vir/common": "^31.57.3",
+        "@augment-vir/assert": "^31.59.0",
+        "@augment-vir/common": "^31.59.0",
         "date-vir": "^8.1.0",
         "lit": "^3.3.2",
-        "lit-css-vars": "^3.0.11",
+        "lit-css-vars": "^3.1.1",
         "lit-html": "^3.3.2",
         "object-shape-tester": "^6.11.0",
-        "observavir": "^2.3.0",
+        "observavir": "^2.3.1",
         "typed-event-target": "^4.1.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.57.3",
-        "@augment-vir/web": "^31.57.3",
+        "@augment-vir/test": "^31.59.0",
+        "@augment-vir/web": "^31.59.0",
         "@web/dev-server-esbuild": "^1.0.4",
         "@web/test-runner": "^0.20.2",
         "@web/test-runner-commands": "^0.9.0",
@@ -60,11 +60,11 @@
         "html-spec-tags": "^2.2.3",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.3",
-        "type-fest": "^5.3.1",
-        "typedoc": "^0.28.15",
+        "type-fest": "^5.4.1",
+        "typedoc": "^0.28.16",
         "typescript": "5.9.3",
-        "vite": "^7.3.0",
-        "vite-tsconfig-paths": "^6.0.3"
+        "vite": "^7.3.1",
+        "vite-tsconfig-paths": "^6.0.4"
     },
     "engines": {
         "node": ">=22"