@stencil/core 5.0.0-alpha.3 → 5.0.0-alpha.4

package/dist/declarations/stencil-public-compiler.d.ts

@@ -868,6 +868,25 @@ interface CollectionCompilerVersion {
   version: string;
   typescriptVersion?: string;
 }
+/**
+ * A memoized result of the SASS + Lightning CSS transformation for a single stylesheet, keyed by
+ * the annotated Rolldown import id (e.g. `/path/to/comp.scss?tag=ion-button&encapsulation=shadow`).
+ *
+ * Storing this allows all output targets (customElements, lazy, hydrate) that process the same
+ * stylesheets to share a single computation instead of repeating it N times.
+ */
+interface CssTransformCacheEntry {
+  /** Resolved file ID after plugin (SASS) transforms */
+  pluginTransformId: string;
+  /** CSS source produced by the SASS / plugin pipeline */
+  pluginTransformCode: string;
+  /** File dependencies discovered during the SASS transform (e.g. `@import`-ed partials) */
+  pluginTransformDependencies: string[];
+  /** Diagnostics emitted during the plugin transform pass */
+  pluginTransformDiagnostics: Diagnostic[];
+  /** Full output of the subsequent `transformCssToEsm` call */
+  cssTransformOutput: TransformCssToEsmOutput;
+}
 interface CompilerCtx {
   version: number;
   activeBuildId: number;
@@ -902,6 +921,16 @@ interface CompilerCtx {
   changedFiles: Set<string>;
   worker?: CompilerWorkerContext;
   rolldownCache: Map<string, any>;
+  /**
+   * Cross-output-target cache for the SASS + Lightning CSS computation.
+   * Keyed by the annotated Rolldown import id. Null entries indicate that the
+   * source file could not be read (propagated as a `null` return from the
+   * transform hook).
+   *
+   * Entries are invalidated in `invalidateRolldownCaches` whenever a
+   * source file or one of its SASS dependencies is modified.
+   */
+  cssTransformCache: Map<string, CssTransformCacheEntry | null>;
   reset(): void;
 }
 type NodeMap = WeakMap<any, ComponentCompilerMeta>;
@@ -3982,6 +4011,27 @@ interface TranspileOptions {
    * Adds `transformTag` calls to css strings and querySelector(All) calls
    */
   additionalTagTransformers?: boolean;
+  /**
+   * A map of virtual file paths to source text for modules that the component
+   * under transpilation extends from.  When provided, `transpile()` builds a
+   * minimal multi-file TypeScript program from these sources so that
+   * {@link https://stenciljs.com/docs/component-lifecycle inheritance chains}
+   * can be resolved without requiring the parent files to exist on disk.
+   *
+   * Keys are the same import paths used in the component's `import` statements
+   * (relative paths are resolved against `currentDirectory`).  Values are the
+   * TypeScript/JavaScript source text of that module.
+   *
+   * @example
+   * ```ts
+   * transpile(myComponentCode, {
+   *   extraFiles: {
+   *     './base-component.ts': baseComponentSourceText,
+   *   },
+   * });
+   * ```
+   */
+  extraFiles?: Record<string, string>;
 }
 type CompileTarget = 'latest' | 'esnext' | 'es2020' | 'es2019' | 'es2018' | 'es2017' | 'es2015' | string | undefined;
 interface TranspileResults {
@@ -4008,6 +4058,10 @@ interface TransformOptions {
   style: 'static' | null;
   styleImportData: 'queryparams' | null;
   target?: string;
+  /**
+   * @see {@link TranspileOptions.extraFiles}
+   */
+  extraFiles?: Record<string, string>;
 }
 interface CompileScriptMinifyOptions {
   target?: CompileTarget;

package/dist/{index-CXHCTQNt.d.mts → index-9LTuoSiw.d.mts}

@@ -1,4 +1,4 @@
-import { ca as RafCallback, da as UserBuildConditionals, fa as VNode, la as ResolutionHandler, mn as RuntimeRef, oa as ErrorHandler, p as ChildType, sa as FunctionalComponent, ua as TagTransformer, wt as HostElement } from "./index-tUR6pD3J.mjs";
+import { Tt as HostElement, ca as FunctionalComponent, da as TagTransformer, fa as UserBuildConditionals, hn as RuntimeRef, la as RafCallback, p as ChildType, pa as VNode, sa as ErrorHandler, ua as ResolutionHandler } from "./index-BwTaN1Nq.mjs";
 
 //#region src/client/client-build.d.ts
 declare const Build: UserBuildConditionals;
@@ -149,6 +149,10 @@ declare const getMode: (ref: RuntimeRef) => string;
 /**
  * Method to render a virtual DOM tree to a container element.
  *
+ * Supports efficient re-renders: calling `render()` again on the same container
+ * will diff the new VNode tree against the previous one and only update what changed,
+ * preserving existing DOM elements and their state.
+ *
  * @example
  * ```tsx
  * import { render } from '@stencil/core';

package/dist/{index-tUR6pD3J.d.mts → index-BwTaN1Nq.d.mts}

@@ -4173,6 +4173,27 @@ interface TranspileOptions {
    * Adds `transformTag` calls to css strings and querySelector(All) calls
    */
   additionalTagTransformers?: boolean;
+  /**
+   * A map of virtual file paths to source text for modules that the component
+   * under transpilation extends from.  When provided, `transpile()` builds a
+   * minimal multi-file TypeScript program from these sources so that
+   * {@link https://stenciljs.com/docs/component-lifecycle inheritance chains}
+   * can be resolved without requiring the parent files to exist on disk.
+   *
+   * Keys are the same import paths used in the component's `import` statements
+   * (relative paths are resolved against `currentDirectory`).  Values are the
+   * TypeScript/JavaScript source text of that module.
+   *
+   * @example
+   * ```ts
+   * transpile(myComponentCode, {
+   *   extraFiles: {
+   *     './base-component.ts': baseComponentSourceText,
+   *   },
+   * });
+   * ```
+   */
+  extraFiles?: Record<string, string>;
 }
 type CompileTarget = 'latest' | 'esnext' | 'es2020' | 'es2019' | 'es2018' | 'es2017' | 'es2015' | string | undefined;
 interface TranspileResults {
@@ -4199,6 +4220,10 @@ interface TransformOptions {
   style: 'static' | null;
   styleImportData: 'queryparams' | null;
   target?: string;
+  /**
+   * @see {@link TranspileOptions.extraFiles}
+   */
+  extraFiles?: Record<string, string>;
 }
 interface CompileScriptMinifyOptions {
   target?: CompileTarget;
@@ -4612,6 +4637,25 @@ interface CollectionDependencyData {
   name: string;
   tags: string[];
 }
+/**
+ * A memoized result of the SASS + Lightning CSS transformation for a single stylesheet, keyed by
+ * the annotated Rolldown import id (e.g. `/path/to/comp.scss?tag=ion-button&encapsulation=shadow`).
+ *
+ * Storing this allows all output targets (customElements, lazy, hydrate) that process the same
+ * stylesheets to share a single computation instead of repeating it N times.
+ */
+interface CssTransformCacheEntry {
+  /** Resolved file ID after plugin (SASS) transforms */
+  pluginTransformId: string;
+  /** CSS source produced by the SASS / plugin pipeline */
+  pluginTransformCode: string;
+  /** File dependencies discovered during the SASS transform (e.g. `@import`-ed partials) */
+  pluginTransformDependencies: string[];
+  /** Diagnostics emitted during the plugin transform pass */
+  pluginTransformDiagnostics: Diagnostic$1[];
+  /** Full output of the subsequent `transformCssToEsm` call */
+  cssTransformOutput: TransformCssToEsmOutput;
+}
 interface CompilerCtx {
   version: number;
   activeBuildId: number;
@@ -4646,6 +4690,16 @@ interface CompilerCtx {
   changedFiles: Set<string>;
   worker?: CompilerWorkerContext;
   rolldownCache: Map<string, any>;
+  /**
+   * Cross-output-target cache for the SASS + Lightning CSS computation.
+   * Keyed by the annotated Rolldown import id. Null entries indicate that the
+   * source file could not be read (propagated as a `null` return from the
+   * transform hook).
+   *
+   * Entries are invalidated in `invalidateRolldownCaches` whenever a
+   * source file or one of its SASS dependencies is modified.
+   */
+  cssTransformCache: Map<string, CssTransformCacheEntry | null>;
   reset(): void;
 }
 type NodeMap = WeakMap<any, ComponentCompilerMeta>;
@@ -6251,4 +6305,4 @@ interface ValidateTypesResults {
   filePaths: string[];
 }
 //#endregion
-export { ComponentCompilerVirtualProperty as $, escapeRegExpSpecialCharacters as $a, TranspileOptions as $i, CompilerEventBuildFinish as $n, dashToPascalCase as $o, LoggerLineUpdater as $r, byteSize as $s, PluginTransformResults as $t, CompilerStyleDoc as A, StyleDoc as Aa, PrerenderConfig as Ai, UpdatedLazyBuildCtx as An, isOutputTargetStats as Ao, CopyResults as Ar, DIST_GLOBAL_STYLES as As, HydrateResults as At, ComponentCompilerMeta as B, isJsFile as Ba, RolldownInputOptions as Bi, BuildNoChangeResults as Bn, hasError as Bo, FsWatchResults as Br, EVENT_FLAGS as Bs, ModuleFormat as Bt, CompilerBuildStatBundle as C, JsonDocsProp as Ca, OutputTargetDocsVscode as Ci, TransformCssToEsmInput as Cn, isOutputTargetDocs as Co, CompilerSystemRenameResults as Cr, COLLECTION_MANIFEST_FILE_NAME as Cs, ExternalStyleCompiler as Ct, CompilerJsDoc as D, JsonDocsTypeLibrary as Da, PageReloadStrategy as Di, TypesImportData as Dn, isOutputTargetDocsReadme as Do, Config as Dr, DIST as Ds, HydrateComponent as Dt, CompilerCtx as E, JsonDocsTag as Ea, OutputTargetWww as Ei, TypeInfo as En, isOutputTargetDocsJson as Eo, CompilerWatcher as Er, DEFAULT_STYLE_MODE as Es, HydrateAnchorElement as Et, ComponentCompilerData as F, createJsVarName as Fa, ResolveModuleIdResults as Fi, WorkerMsgHandler as Fn, TASK_CANCELED_MSG as Fo, DevServer as Fr, DOCS_CUSTOM as Fs, JSDocTagInfo as Ft, ComponentCompilerPropertyType as G, readOnlyArrayHasStringMember as Ga, SitemapXmpOpts as Gi, CacheStorage as Gn, splitLineBreaks as Go, HydrateFactoryOptions as Gr, MEMBER_FLAGS as Gs, NodeMap as Gt, ComponentCompilerMethodComplexType as H, isTsFile as Ha, RolldownOutputOptions as Hi, BuildOnEvents as Hn, shouldIgnoreError as Ho, HmrStyleUpdate as Hr, HOST_FLAGS as Hs, MsgFromWorker as Ht, ComponentCompilerEvent as I, generatePreamble as Ia, ResolveModuleOptions as Ii, AutoprefixerOptions as In, buildError as Io, DevServerConfig as Ir, DOCS_CUSTOM_ELEMENTS_MANIFEST as Is, JsDoc as It, ComponentCompilerStaticEvent as J, getInlineSourceMappingUrlLinker as Ja, StencilDevServerConfig as Ji, CompileTarget as Jn, loadTypeScriptDiagnostics as Jo, LazyRequire as Jr, SVG_NS as Js, ParsedImport as Jt, ComponentCompilerReferencedType as K, readPackageJson as Ka, SitemapXmpResults as Ki, CliInitOptions as Kn, augmentDiagnosticWithNode as Ko, HydratedFlag as Kr, NODE_TYPES as Ks, OptimizeJsResult as Kt, ComponentCompilerEventComplexType as L, getTextDocs as La, RobotsTxtOpts as Li, BuildEmitEvents as Ln, buildJsonFileError as Lo, DevServerEditor as Lr, DOCS_JSON as Ls, LazyBundleRuntimeData as Lt, CompilerWorkerTask as M, validateComponentTag as Ma, PrerenderResults as Mi, ValidateTypesResults as Mn, isValidConfigOutputTarget as Mo, Credentials as Mr, DIST_LAZY as Ms, HydrateStaticData as Mt, ComponentCompilerChangeHandler as N, ParsePackageJsonResult as Na, PrerenderStartOptions as Ni, Workbox as Nn, relativeImport as No, CustomElementsExportBehavior as Nr, DIST_LAZY_LOADER as Ns, HydrateStyleElement as Nt, CompilerJsDocTagInfo as O, JsonDocsUsage as Oa, ParsedPath as Oi, TypesMemberNameData as On, isOutputTargetDocsVscode as Oo, ConfigBundle as Or, DIST_COLLECTION as Os, HydrateElement as Ot, ComponentCompilerCustomState as P, addDocBlock as Pa, ResolveModuleIdOptions as Pi, WorkerContextMethod as Pn, shouldExcludeComponent as Po, CustomElementsExportBehaviorOptions as Pr, DIST_TYPES as Ps, ImportData as Pt, ComponentCompilerTypeReferences as Q, result_d_exports as Qa, TranspileOnlyResults as Qi, CompilerDependency as Qn, isGlob as Qo, Logger as Qr, XLINK_NS as Qs, PluginCtx as Qt, ComponentCompilerFeatures as R, hasDependency as Ra, RobotsTxtResults as Ri, BuildEvents as Rn, buildWarn as Ro, Diagnostic$1 as Rr, DOCS_README as Rs, LazyBundlesRuntimeData as Rt, CompilerAssetDir as S, JsonDocsPart as Sa, OutputTargetDocsReadme as Si, StyleMap as Sn, isOutputTargetDistTypes as So, CompilerSystemRemoveFileResults as Sr, CMP_FLAGS as Ss, EventInitDict as St, CompilerBuildStats as T, JsonDocsStyle as Ta, OutputTargetStats as Ti, TranspileModuleResults as Tn, isOutputTargetDocsCustomElementsManifest as To, CompilerSystemWriteFileResults as Tr, CUSTOM as Ts, HostRef as Tt, ComponentCompilerProperty as U, isTsxFile as Ua, SerializeDocumentOptions as Ui, BuildOutput as Un, escapeHtml as Uo, HotModuleReplacement as Ur, HTML_NS as Us, MsgToWorker as Ut, ComponentCompilerMethod as V, isJsxFile as Va, RolldownInterface as Vi, BuildOnEventRemove as Vn, hasWarning as Vo, HistoryApiFallback as Vr, GENERATED_DTS as Vs, ModuleMap as Vt, ComponentCompilerPropertyComplexType as W, parsePackageJson as Wa, ServiceWorkerConfig as Wi, BuildResultsComponentGraph as Wn, normalizeDiagnostics as Wo, HydrateDocumentOptions as Wr, LISTENER_FLAGS as Ws, NewSpecPageOptions as Wt, ComponentCompilerStaticProperty as X, getSourceMappingUrlLinker as Xa, SystemDetails as Xi, CompilerBuildResults as Xn, loadRolldownDiagnostics as Xo, LoadConfigResults as Xr, WATCH_FLAGS as Xs, PlatformRuntime as Xt, ComponentCompilerStaticMethod as Y, getSourceMappingUrlForEndOfFile as Ya, StencilDocsConfig as Yi, Compiler as Yn, createOnWarnFn as Yo, LoadConfigInit as Yr, VALID_CONFIG_OUTPUT_TARGETS as Ys, PatchedSlotNode as Yt, ComponentCompilerTypeReference as Z, rolldownToStencilSourceMap as Za, TransformOptions as Zi, CompilerBuildStart as Zn, isRootPath as Zo, LogLevel as Zr, WWW as Zs, Plugin as Zt, CollectionCompilerVersion as _, JsonDocsDependencyGraph as _a, OutputTargetDistLazyLoader as _i, SourceMap$1 as _n, isOutputTargetDistCollection as _o, CompilerSystemCreateDirectoryOptions as _r, toTitleCase as _s, CssImportData as _t, BuildCtx as a, WorkerOptions as aa, OptimizeJsOutput as ai, PropsType as an, normalizePath as ao, CompilerEventFileAdd as ar, isDef as as, ComponentConstructorProperties as at, CollectionDependencyManifest as b, JsonDocsMethod as ba, OutputTargetDocsCustomElementsManifest as bi, StencilDocument as bn, isOutputTargetDistLazy as bo, CompilerSystemRemoveDirectoryOptions as br, formatLazyBundleRuntimeMeta as bs, Encapsulation as bt, BuildStyleUpdate as c, RafCallback as ca, OutputTargetBaseNext as ci, RolldownChunkResult as cn, FilterComponentsResult as co, CompilerEventFsChange as cr, isNumber as cs, ComponentNativeConstructor as ct, BundleModuleOutput as d, UserBuildConditionals as da, OutputTargetCustom as di, RolldownResults as dn, getComponentsDtsTypesFilePath as do, CompilerFileWatcherCallback as dr, mergeIntoWith as ds, ComponentRuntimeMember as dt, TranspileResults as ea, LoggerTimeSpan as ei, PluginTransformationDescriptor as en, queryNonceMetaTagContent as eo, CompilerEventBuildLog as er, escapeWithPattern as es, ComponentConstructor as et, Cache as f, VNode as fa, OutputTargetDist as fi, RolldownSourceMap as fn, getComponentsFromModules as fo, CompilerFileWatcherEvent as fr, noop as fs, ComponentRuntimeMembers as ft, CollectionCompilerMeta as g, JsonDocsCustomState as ga, OutputTargetDistLazy as gi, SerializedEvent as gn, isOutputTargetDist as go, CompilerSystem as gr, toDashCase as gs, ComponentTestingConstructor as gt, CollectionCompiler as h, JsonDocsComponent as ha, OutputTargetDistGlobalStyles as hi, SerializeImportData as hn, isOutputTargetCustom as ho, CompilerRequestResponse as hr, toCamelCase as hs, ComponentRuntimeReflectingAttr as ht, BuildConditionals as i, WorkerMainController as ia, OptimizeJsInput as ii, PrintLine as in, normalizeFsPathQuery as io, CompilerEventDirDelete as ir, isComplexType as is, ComponentConstructorListener as it, CompilerWorkerContext as j, FsWriteResults as ja, PrerenderHydrateOptions as ji, VNodeProdData as jn, isOutputTargetWww as jo, CopyTask as jr, DIST_HYDRATE_SCRIPT as js, HydrateScriptElement as jt, CompilerModeStyles as k, JsonDocsValue as ka, PlatformPath as ki, TypesModule as kn, isOutputTargetHydrate as ko, ConfigExtras as kr, DIST_CUSTOM_ELEMENTS as ks, HydrateImgElement as kt, BuildTask as l, ResolutionHandler as la, OutputTargetBuild as li, RolldownResult as ln, filterExcludedComponents as lo, CompilerEventName as lr, isObject as ls, ComponentPatches as lt, CollectionBundleManifest as m, JsonDocs as ma, OutputTargetDistCustomElements as mi, RuntimeRef as mn, isOutputTargetCopy as mo, CompilerRequest as mr, sortBy as ms, ComponentRuntimeMetaCompact as mt, AssetsMeta as n, ValidatedConfig as na, OptimizeCssInput as ni, PrerenderUrlRequest as nn, normalize as no, CompilerEventBuildStart as nr, fromEntries as ns, ComponentConstructorEncapsulation as nt, BuildFeatures as o, ErrorHandler as oa, OutputTarget as oi, RenderNode as on, relative as oo, CompilerEventFileDelete as or, isFunction as os, ComponentConstructorProperty as ot, ChildType as p, JsonDocMethodParameter as pa, OutputTargetDistCollection as pi, RootAppliedStyleMap as pn, isEligiblePrimaryPackageOutputTarget as po, CompilerFsStats as pr, pluck as ps, ComponentRuntimeMeta as pt, ComponentCompilerState as q, isRemoteUrl as qa, StencilConfig as qi, CompileScriptMinifyOptions as qn, loadTypeScriptDiagnostic as qo, LOG_LEVELS as qr, STATS as qs, PackageJsonData as qt, BuildComponent as r, WatcherCloseResults as ra, OptimizeCssOutput as ri, PrerenderUrlResults as rn, normalizeFsPath as ro, CompilerEventDirAdd as rr, isBoolean as rs, ComponentConstructorEvent as rt, BuildSourceGraph as s, FunctionalComponent as sa, OutputTargetBase as si, RolldownAssetResult as sn, resolve as so, CompilerEventFileUpdate as sr, isIterable as ss, ComponentConstructorPropertyType as st, AnyHTMLElement as t, UnvalidatedConfig as ta, NodeResolveConfig as ti, PrerenderManager as tn, join as to, CompilerEventBuildNoChange as tr, flatOne as ts, ComponentConstructorChangeHandlers as tt, BundleModule as u, TagTransformer as ua, OutputTargetCopy as ui, RolldownResultModule as un, getComponentsDtsSrcFilePath as uo, CompilerFileWatcher as ur, isString as us, ComponentRuntimeHostListener as ut, CollectionComponentEntryPath as v, JsonDocsEvent as va, OutputTargetDistTypes as vi, SourceTarget as vn, isOutputTargetDistCustomElements as vo, CompilerSystemCreateDirectoryResults as vr, unique as vs, CssToEsmImportData as vt, CompilerBuildStatCollection as w, JsonDocsSlot as wa, OutputTargetHydrate as wi, TransformCssToEsmOutput as wn, isOutputTargetDocsCustom as wo, CompilerSystemRenamedPath as wr, COPY as ws, HostElement as wt, CollectionManifest as x, JsonDocsMethodReturn as xa, OutputTargetDocsJson as xi, StyleCompiler as xn, isOutputTargetDistLazyLoader as xo, CompilerSystemRemoveDirectoryResults as xr, stringifyRuntimeData as xs, EntryModule as xt, CollectionDependencyData as y, JsonDocsListener as ya, OutputTargetDocsCustom as yi, SpecPage as yn, isOutputTargetDistGlobalStyles as yo, CompilerSystemRealpathResults as yr, formatComponentRuntimeMeta as ys, DocData as yt, ComponentCompilerListener as z, isDtsFile as za, RolldownConfig as zi, BuildLog as zn, catchError as zo, EligiblePrimaryPackageOutputTarget as zr, DOCS_VSCODE as zs, Module as zt };
+export { ComponentCompilerVirtualProperty as $, result_d_exports as $a, TranspileOnlyResults as $i, CompilerDependency as $n, isGlob as $o, Logger as $r, XLINK_NS as $s, PluginCtx as $t, CompilerStyleDoc as A, JsonDocsValue as Aa, PlatformPath as Ai, TypesModule as An, isOutputTargetHydrate as Ao, ConfigExtras as Ar, DIST_CUSTOM_ELEMENTS as As, HydrateImgElement as At, ComponentCompilerMeta as B, isDtsFile as Ba, RolldownConfig as Bi, BuildLog as Bn, catchError as Bo, EligiblePrimaryPackageOutputTarget as Br, DOCS_VSCODE as Bs, Module as Bt, CompilerBuildStatBundle as C, JsonDocsPart as Ca, OutputTargetDocsReadme as Ci, StyleMap as Cn, isOutputTargetDistTypes as Co, CompilerSystemRemoveFileResults as Cr, CMP_FLAGS as Cs, EventInitDict as Ct, CompilerJsDoc as D, JsonDocsTag as Da, OutputTargetWww as Di, TypeInfo as Dn, isOutputTargetDocsJson as Do, CompilerWatcher as Dr, DEFAULT_STYLE_MODE as Ds, HydrateAnchorElement as Dt, CompilerCtx as E, JsonDocsStyle as Ea, OutputTargetStats as Ei, TranspileModuleResults as En, isOutputTargetDocsCustomElementsManifest as Eo, CompilerSystemWriteFileResults as Er, CUSTOM as Es, HostRef as Et, ComponentCompilerData as F, addDocBlock as Fa, ResolveModuleIdOptions as Fi, WorkerContextMethod as Fn, shouldExcludeComponent as Fo, CustomElementsExportBehaviorOptions as Fr, DIST_TYPES as Fs, ImportData as Ft, ComponentCompilerPropertyType as G, parsePackageJson as Ga, ServiceWorkerConfig as Gi, BuildResultsComponentGraph as Gn, normalizeDiagnostics as Go, HydrateDocumentOptions as Gr, LISTENER_FLAGS as Gs, NewSpecPageOptions as Gt, ComponentCompilerMethodComplexType as H, isJsxFile as Ha, RolldownInterface as Hi, BuildOnEventRemove as Hn, hasWarning as Ho, HistoryApiFallback as Hr, GENERATED_DTS as Hs, ModuleMap as Ht, ComponentCompilerEvent as I, createJsVarName as Ia, ResolveModuleIdResults as Ii, WorkerMsgHandler as In, TASK_CANCELED_MSG as Io, DevServer as Ir, DOCS_CUSTOM as Is, JSDocTagInfo as It, ComponentCompilerStaticEvent as J, isRemoteUrl as Ja, StencilConfig as Ji, CompileScriptMinifyOptions as Jn, loadTypeScriptDiagnostic as Jo, LOG_LEVELS as Jr, STATS as Js, PackageJsonData as Jt, ComponentCompilerReferencedType as K, readOnlyArrayHasStringMember as Ka, SitemapXmpOpts as Ki, CacheStorage as Kn, splitLineBreaks as Ko, HydrateFactoryOptions as Kr, MEMBER_FLAGS as Ks, NodeMap as Kt, ComponentCompilerEventComplexType as L, generatePreamble as La, ResolveModuleOptions as Li, AutoprefixerOptions as Ln, buildError as Lo, DevServerConfig as Lr, DOCS_CUSTOM_ELEMENTS_MANIFEST as Ls, JsDoc as Lt, CompilerWorkerTask as M, FsWriteResults as Ma, PrerenderHydrateOptions as Mi, VNodeProdData as Mn, isOutputTargetWww as Mo, CopyTask as Mr, DIST_HYDRATE_SCRIPT as Ms, HydrateScriptElement as Mt, ComponentCompilerChangeHandler as N, validateComponentTag as Na, PrerenderResults as Ni, ValidateTypesResults as Nn, isValidConfigOutputTarget as No, Credentials as Nr, DIST_LAZY as Ns, HydrateStaticData as Nt, CompilerJsDocTagInfo as O, JsonDocsTypeLibrary as Oa, PageReloadStrategy as Oi, TypesImportData as On, isOutputTargetDocsReadme as Oo, Config as Or, DIST as Os, HydrateComponent as Ot, ComponentCompilerCustomState as P, ParsePackageJsonResult as Pa, PrerenderStartOptions as Pi, Workbox as Pn, relativeImport as Po, CustomElementsExportBehavior as Pr, DIST_LAZY_LOADER as Ps, HydrateStyleElement as Pt, ComponentCompilerTypeReferences as Q, rolldownToStencilSourceMap as Qa, TransformOptions as Qi, CompilerBuildStart as Qn, isRootPath as Qo, LogLevel as Qr, WWW as Qs, Plugin as Qt, ComponentCompilerFeatures as R, getTextDocs as Ra, RobotsTxtOpts as Ri, BuildEmitEvents as Rn, buildJsonFileError as Ro, DevServerEditor as Rr, DOCS_JSON as Rs, LazyBundleRuntimeData as Rt, CompilerAssetDir as S, JsonDocsMethodReturn as Sa, OutputTargetDocsJson as Si, StyleCompiler as Sn, isOutputTargetDistLazyLoader as So, CompilerSystemRemoveDirectoryResults as Sr, stringifyRuntimeData as Ss, EntryModule as St, CompilerBuildStats as T, JsonDocsSlot as Ta, OutputTargetHydrate as Ti, TransformCssToEsmOutput as Tn, isOutputTargetDocsCustom as To, CompilerSystemRenamedPath as Tr, COPY as Ts, HostElement as Tt, ComponentCompilerProperty as U, isTsFile as Ua, RolldownOutputOptions as Ui, BuildOnEvents as Un, shouldIgnoreError as Uo, HmrStyleUpdate as Ur, HOST_FLAGS as Us, MsgFromWorker as Ut, ComponentCompilerMethod as V, isJsFile as Va, RolldownInputOptions as Vi, BuildNoChangeResults as Vn, hasError as Vo, FsWatchResults as Vr, EVENT_FLAGS as Vs, ModuleFormat as Vt, ComponentCompilerPropertyComplexType as W, isTsxFile as Wa, SerializeDocumentOptions as Wi, BuildOutput as Wn, escapeHtml as Wo, HotModuleReplacement as Wr, HTML_NS as Ws, MsgToWorker as Wt, ComponentCompilerStaticProperty as X, getSourceMappingUrlForEndOfFile as Xa, StencilDocsConfig as Xi, Compiler as Xn, createOnWarnFn as Xo, LoadConfigInit as Xr, VALID_CONFIG_OUTPUT_TARGETS as Xs, PatchedSlotNode as Xt, ComponentCompilerStaticMethod as Y, getInlineSourceMappingUrlLinker as Ya, StencilDevServerConfig as Yi, CompileTarget as Yn, loadTypeScriptDiagnostics as Yo, LazyRequire as Yr, SVG_NS as Ys, ParsedImport as Yt, ComponentCompilerTypeReference as Z, getSourceMappingUrlLinker as Za, SystemDetails as Zi, CompilerBuildResults as Zn, loadRolldownDiagnostics as Zo, LoadConfigResults as Zr, WATCH_FLAGS as Zs, PlatformRuntime as Zt, CollectionCompilerVersion as _, JsonDocsCustomState as _a, OutputTargetDistLazy as _i, SerializedEvent as _n, isOutputTargetDist as _o, CompilerSystem as _r, toDashCase as _s, CssImportData as _t, BuildCtx as a, WorkerMainController as aa, OptimizeJsInput as ai, PrintLine as an, normalizeFsPathQuery as ao, CompilerEventDirDelete as ar, isComplexType as as, ComponentConstructorProperties as at, CollectionDependencyManifest as b, JsonDocsListener as ba, OutputTargetDocsCustom as bi, SpecPage as bn, isOutputTargetDistGlobalStyles as bo, CompilerSystemRealpathResults as br, formatComponentRuntimeMeta as bs, DocData as bt, BuildStyleUpdate as c, FunctionalComponent as ca, OutputTargetBase as ci, RolldownAssetResult as cn, resolve as co, CompilerEventFileUpdate as cr, isIterable as cs, ComponentNativeConstructor as ct, BundleModuleOutput as d, TagTransformer as da, OutputTargetCopy as di, RolldownResultModule as dn, getComponentsDtsSrcFilePath as do, CompilerFileWatcher as dr, isString as ds, ComponentRuntimeMember as dt, TranspileOptions as ea, byteSize as ec, LoggerLineUpdater as ei, PluginTransformResults as en, escapeRegExpSpecialCharacters as eo, CompilerEventBuildFinish as er, dashToPascalCase as es, ComponentConstructor as et, Cache as f, UserBuildConditionals as fa, OutputTargetCustom as fi, RolldownResults as fn, getComponentsDtsTypesFilePath as fo, CompilerFileWatcherCallback as fr, mergeIntoWith as fs, ComponentRuntimeMembers as ft, CollectionCompilerMeta as g, JsonDocsComponent as ga, OutputTargetDistGlobalStyles as gi, SerializeImportData as gn, isOutputTargetCustom as go, CompilerRequestResponse as gr, toCamelCase as gs, ComponentTestingConstructor as gt, CollectionCompiler as h, JsonDocs as ha, OutputTargetDistCustomElements as hi, RuntimeRef as hn, isOutputTargetCopy as ho, CompilerRequest as hr, sortBy as hs, ComponentRuntimeReflectingAttr as ht, BuildConditionals as i, WatcherCloseResults as ia, OptimizeCssOutput as ii, PrerenderUrlResults as in, normalizeFsPath as io, CompilerEventDirAdd as ir, isBoolean as is, ComponentConstructorListener as it, CompilerWorkerContext as j, StyleDoc as ja, PrerenderConfig as ji, UpdatedLazyBuildCtx as jn, isOutputTargetStats as jo, CopyResults as jr, DIST_GLOBAL_STYLES as js, HydrateResults as jt, CompilerModeStyles as k, JsonDocsUsage as ka, ParsedPath as ki, TypesMemberNameData as kn, isOutputTargetDocsVscode as ko, ConfigBundle as kr, DIST_COLLECTION as ks, HydrateElement as kt, BuildTask as l, RafCallback as la, OutputTargetBaseNext as li, RolldownChunkResult as ln, FilterComponentsResult as lo, CompilerEventFsChange as lr, isNumber as ls, ComponentPatches as lt, CollectionBundleManifest as m, JsonDocMethodParameter as ma, OutputTargetDistCollection as mi, RootAppliedStyleMap as mn, isEligiblePrimaryPackageOutputTarget as mo, CompilerFsStats as mr, pluck as ms, ComponentRuntimeMetaCompact as mt, AssetsMeta as n, UnvalidatedConfig as na, NodeResolveConfig as ni, PrerenderManager as nn, join as no, CompilerEventBuildNoChange as nr, flatOne as ns, ComponentConstructorEncapsulation as nt, BuildFeatures as o, WorkerOptions as oa, OptimizeJsOutput as oi, PropsType as on, normalizePath as oo, CompilerEventFileAdd as or, isDef as os, ComponentConstructorProperty as ot, ChildType as p, VNode as pa, OutputTargetDist as pi, RolldownSourceMap as pn, getComponentsFromModules as po, CompilerFileWatcherEvent as pr, noop as ps, ComponentRuntimeMeta as pt, ComponentCompilerState as q, readPackageJson as qa, SitemapXmpResults as qi, CliInitOptions as qn, augmentDiagnosticWithNode as qo, HydratedFlag as qr, NODE_TYPES as qs, OptimizeJsResult as qt, BuildComponent as r, ValidatedConfig as ra, OptimizeCssInput as ri, PrerenderUrlRequest as rn, normalize as ro, CompilerEventBuildStart as rr, fromEntries as rs, ComponentConstructorEvent as rt, BuildSourceGraph as s, ErrorHandler as sa, OutputTarget as si, RenderNode as sn, relative as so, CompilerEventFileDelete as sr, isFunction as ss, ComponentConstructorPropertyType as st, AnyHTMLElement as t, TranspileResults as ta, LoggerTimeSpan as ti, PluginTransformationDescriptor as tn, queryNonceMetaTagContent as to, CompilerEventBuildLog as tr, escapeWithPattern as ts, ComponentConstructorChangeHandlers as tt, BundleModule as u, ResolutionHandler as ua, OutputTargetBuild as ui, RolldownResult as un, filterExcludedComponents as uo, CompilerEventName as ur, isObject as us, ComponentRuntimeHostListener as ut, CollectionComponentEntryPath as v, JsonDocsDependencyGraph as va, OutputTargetDistLazyLoader as vi, SourceMap$1 as vn, isOutputTargetDistCollection as vo, CompilerSystemCreateDirectoryOptions as vr, toTitleCase as vs, CssToEsmImportData as vt, CompilerBuildStatCollection as w, JsonDocsProp as wa, OutputTargetDocsVscode as wi, TransformCssToEsmInput as wn, isOutputTargetDocs as wo, CompilerSystemRenameResults as wr, COLLECTION_MANIFEST_FILE_NAME as ws, ExternalStyleCompiler as wt, CollectionManifest as x, JsonDocsMethod as xa, OutputTargetDocsCustomElementsManifest as xi, StencilDocument as xn, isOutputTargetDistLazy as xo, CompilerSystemRemoveDirectoryOptions as xr, formatLazyBundleRuntimeMeta as xs, Encapsulation as xt, CollectionDependencyData as y, JsonDocsEvent as ya, OutputTargetDistTypes as yi, SourceTarget as yn, isOutputTargetDistCustomElements as yo, CompilerSystemCreateDirectoryResults as yr, unique as ys, CssTransformCacheEntry as yt, ComponentCompilerListener as z, hasDependency as za, RobotsTxtResults as zi, BuildEvents as zn, buildWarn as zo, Diagnostic$1 as zr, DOCS_README as zs, LazyBundlesRuntimeData as zt };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { A as Element, C as setPlatformHelpers, D as AttachInternals, F as PropSerialize, I as State, L as Watch, M as Listen, N as Method, O as AttrDeserialize, P as Prop, R as resolveVar, S as writeTask, T as setErrorHandler, _ as getElement, a as Mixin, b as setAssetPath, c as forceUpdate, f as getMode, g as h, h as Host, i as render, j as Event, k as Component, l as getRenderingRef, n as setTagTransformer, o as Fragment, p as setMode, r as transformTag, v as getShadowRoot, x as readTask, y as getAssetPath, z as Build } from "./client-CSm3x5ke.mjs";
+import { A as Element, C as setPlatformHelpers, D as AttachInternals, F as PropSerialize, I as State, L as Watch, M as Listen, N as Method, O as AttrDeserialize, P as Prop, R as resolveVar, S as writeTask, T as setErrorHandler, _ as getElement, a as Mixin, b as setAssetPath, c as forceUpdate, f as getMode, g as h, h as Host, i as render, j as Event, k as Component, l as getRenderingRef, n as setTagTransformer, o as Fragment, p as setMode, r as transformTag, v as getShadowRoot, x as readTask, y as getAssetPath, z as Build } from "./client-Dti6fFpE.mjs";
 export { AttachInternals, AttrDeserialize, Build, Component, Element, Event, Fragment, Host, Listen, Method, Mixin, Prop, PropSerialize, State, Watch, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, h, readTask, render, resolveVar, setAssetPath, setErrorHandler, setMode, setPlatformHelpers, setTagTransformer, transformTag, writeTask };

package/dist/jsx-runtime.js

@@ -1,2 +1,2 @@
-import { d as Fragment, n as jsx, r as jsxs } from "./runtime-BBCnuprF.js";
+import { d as Fragment, n as jsx, r as jsxs } from "./runtime-COEYYPyw.js";
 export { Fragment, jsx, jsxs };

package/dist/{node-Bg-mO5dw.mjs → node-BF2jSfWg.mjs}

@@ -1,5 +1,5 @@
 import { n as __require } from "./chunk-CjcI7cDX.mjs";
-import "./client-CSm3x5ke.mjs";
+import "./client-Dti6fFpE.mjs";
 import { h as noop, i as flatOne, l as isFunction, p as isString } from "./regular-expression-D5pGVpCu.mjs";
 import { bt as isGlob, dt as TASK_CANCELED_MSG, ft as buildError, ht as catchError, rt as normalizePath, vt as shouldIgnoreError } from "./validation-Byxie0Uk.mjs";
 import path from "node:path";

package/dist/runtime/client/index.d.ts

@@ -2269,6 +2269,10 @@ declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRun
 /**
  * Method to render a virtual DOM tree to a container element.
  *
+ * Supports efficient re-renders: calling `render()` again on the same container
+ * will diff the new VNode tree against the previous one and only update what changed,
+ * preserving existing DOM elements and their state.
+ *
  * @example
  * ```tsx
  * import { render } from '@stencil/core';

package/dist/runtime/client/index.js

@@ -3993,9 +3993,11 @@ const proxyComponent = (Cstr, cmpMeta, flags) => {
 						return;
 					}
 					const propFlags = members.find(([m]) => m === propName);
-					if (propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean) newValue = newValue !== null && newValue !== "false";
+					const isBooleanTarget = propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean;
+					const isSpuriousBooleanRemoval = isBooleanTarget && newValue === null && this[propName] === void 0;
+					if (isBooleanTarget) newValue = !(newValue === null || newValue === "false");
 					const propDesc = Object.getOwnPropertyDescriptor(prototype, propName);
-					if (newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
+					if (!isSpuriousBooleanRemoval && newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
 				});
 			};
 			Cstr.observedAttributes = Array.from(new Set([...Object.keys(cmpMeta.$watchers$ ?? {}), ...members.filter(([_, m]) => m[0] & MEMBER_FLAGS.HasAttribute).map(([propName, m]) => {
@@ -4524,8 +4526,19 @@ const setPlatformOptions = (opts) => Object.assign(plt, opts);
 //#endregion
 //#region src/runtime/render.ts
 /**
+* A WeakMap to persist HostRef objects across multiple render() calls to the
+* same container. This enables VNode diffing on re-renders — without it, each
+* call creates a fresh HostRef with no previous VNode, causing renderVdom to
+* replace the entire DOM subtree instead of patching only what changed.
+*/
+const hostRefCache = /* @__PURE__ */ new WeakMap();
+/**
 * Method to render a virtual DOM tree to a container element.
 *
+* Supports efficient re-renders: calling `render()` again on the same container
+* will diff the new VNode tree against the previous one and only update what changed,
+* preserving existing DOM elements and their state.
+*
 * @example
 * ```tsx
 * import { render } from '@stencil/core';
@@ -4542,14 +4555,19 @@ const setPlatformOptions = (opts) => Object.assign(plt, opts);
 * @param container - The container element to render the virtual DOM tree to
 */
 function render(vnode, container) {
-	renderVdom({
-		$flags$: 0,
-		$cmpMeta$: {
+	let ref = hostRefCache.get(container);
+	if (!ref) {
+		ref = {
 			$flags$: 0,
-			$tagName$: container.tagName
-		},
-		$hostElement$: container
-	}, vnode);
+			$cmpMeta$: {
+				$flags$: 0,
+				$tagName$: container.tagName
+			},
+			$hostElement$: container
+		};
+		hostRefCache.set(container, ref);
+	}
+	renderVdom(ref, vnode);
 }
 //#endregion
 //#region src/runtime/tag-transform.ts

package/dist/runtime/index.d.ts

@@ -117,6 +117,10 @@ declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRun
 /**
  * Method to render a virtual DOM tree to a container element.
  *
+ * Supports efficient re-renders: calling `render()` again on the same container
+ * will diff the new VNode tree against the previous one and only update what changed,
+ * preserving existing DOM elements and their state.
+ *
  * @example
  * ```tsx
  * import { render } from '@stencil/core';

package/dist/runtime/index.js

@@ -1,2 +1,2 @@
-import { A as h, C as postUpdateComponent, D as getMode, E as parsePropertyValue, F as HYDRATED_STYLE_ID, M as getShadowRoot, N as getAssetPath, O as setMode, P as setAssetPath, S as getRenderingRef, T as createEvent, _ as connectedCallback, a as transformTag, b as setValue, c as setNonce, d as Fragment, f as bootstrapLazy, g as disconnectedCallback, h as proxyCustomElement, i as setTagTransformer, j as getElement, k as Host, l as Mixin, m as forceModeUpdate, n as jsx, o as render, p as defineCustomElement, r as jsxs, s as setPlatformOptions, t as insertVdomAnnotations, u as addHostEventListeners, v as proxyComponent, w as renderVdom, x as forceUpdate, y as getValue } from "../runtime-BBCnuprF.js";
+import { A as h, C as postUpdateComponent, D as getMode, E as parsePropertyValue, F as HYDRATED_STYLE_ID, M as getShadowRoot, N as getAssetPath, O as setMode, P as setAssetPath, S as getRenderingRef, T as createEvent, _ as connectedCallback, a as transformTag, b as setValue, c as setNonce, d as Fragment, f as bootstrapLazy, g as disconnectedCallback, h as proxyCustomElement, i as setTagTransformer, j as getElement, k as Host, l as Mixin, m as forceModeUpdate, n as jsx, o as render, p as defineCustomElement, r as jsxs, s as setPlatformOptions, t as insertVdomAnnotations, u as addHostEventListeners, v as proxyComponent, w as renderVdom, x as forceUpdate, y as getValue } from "../runtime-COEYYPyw.js";
 export { Fragment, HYDRATED_STYLE_ID, Host, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, jsx, jsxs, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, renderVdom, setAssetPath, setMode, setNonce, setPlatformOptions, setTagTransformer, setValue, transformTag };

package/dist/runtime/server/index.d.mts

@@ -931,10 +931,6 @@ declare const hAsync: (nodeName: any, vnodeData: any, ...children: ChildType[])
 //#region src/server/platform/hydrate-app.d.ts
 declare function hydrateApp(win: Window & typeof globalThis, opts: HydrateFactoryOptions, results: HydrateResults, afterHydrate: (win: Window, opts: HydrateFactoryOptions, results: HydrateResults, resolve: (results: HydrateResults) => void) => void, resolve: (results: HydrateResults) => void): void;
 //#endregion
-//#region src/runtime/asset-path.d.ts
-declare const getAssetPath: (path: string) => string;
-declare const setAssetPath: (path: string) => string;
-//#endregion
 //#region src/runtime/bootstrap-custom-element.d.ts
 declare const defineCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => void;
 declare const proxyCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => any;
@@ -1134,6 +1130,23 @@ declare const registerHost: (elm: HostElement, cmpMeta: ComponentRuntimeMeta) =>
 declare const Build: UserBuildConditionals;
 declare const styles: StyleMap;
 declare const modeResolutionChain: ResolutionHandler[];
+/**
+ * Server-side implementation of getAssetPath.
+ *
+ * Unlike the client-side version, this doesn't use import.meta.url as a fallback
+ * because it doesn't make sense in the bundled hydrate factory context.
+ * The base URL must come from plt.$resourcesUrl$ (set via hydration options).
+ * @param path - The relative path to the asset
+ * @returns The resolved asset path, which may be an absolute URL if resourcesUrl is set to an external URL, or a relative path if resourcesUrl is a relative path or not set at all
+ */
+declare const getAssetPath: (path: string) => string;
+/**
+ * Sets the base URL for resolving asset paths in the server/hydrate context.
+ * @param path - The base URL to use for resolving asset paths. This should typically be set to the same value as the `resourcesUrl` option passed to `hydrateDocument` to ensure that asset paths are resolved correctly in the server/hydrate context.
+ * If not set, it defaults to './', which is a reasonable default for server-side rendering.
+ * @returns void
+ */
+declare const setAssetPath: (path: string) => string;
 /**
  * Checks to see any components are rendered with `scoped`
  * @param opts - SSR options

package/dist/runtime/server/index.mjs

@@ -173,14 +173,6 @@ const reWireGetterSetter = (instance, hostRef) => {
 	});
 };
 //#endregion
-//#region src/runtime/asset-path.ts
-const getAssetPath = (path) => {
-	const base = plt.$resourcesUrl$ || new URL(".", import.meta.url).href;
-	const assetUrl = new URL(path, base);
-	return assetUrl.origin !== win.location.origin ? assetUrl.href : assetUrl.pathname;
-};
-const setAssetPath = (path) => plt.$resourcesUrl$ = path;
-//#endregion
 //#region src/runtime/runtime-constants.ts
 /**
 * Bit flags for recording various properties of VDom nodes
@@ -3660,9 +3652,11 @@ const proxyComponent = (Cstr, cmpMeta, flags) => {
 						return;
 					}
 					const propFlags = members.find(([m]) => m === propName);
-					if (propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean) newValue = newValue !== null && newValue !== "false";
+					const isBooleanTarget = propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean;
+					const isSpuriousBooleanRemoval = isBooleanTarget && newValue === null && this[propName] === void 0;
+					if (isBooleanTarget) newValue = !(newValue === null || newValue === "false");
 					const propDesc = Object.getOwnPropertyDescriptor(prototype, propName);
-					if (newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
+					if (!isSpuriousBooleanRemoval && newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
 				});
 			};
 			Cstr.observedAttributes = Array.from(new Set([...Object.keys(cmpMeta.$watchers$ ?? {}), ...members.filter(([_, m]) => m[0] & MEMBER_FLAGS.HasAttribute).map(([propName, m]) => {
@@ -4844,6 +4838,27 @@ const Build = {
 const styles = /* @__PURE__ */ new Map();
 const modeResolutionChain = [];
 /**
+* Server-side implementation of getAssetPath.
+*
+* Unlike the client-side version, this doesn't use import.meta.url as a fallback
+* because it doesn't make sense in the bundled hydrate factory context.
+* The base URL must come from plt.$resourcesUrl$ (set via hydration options).
+* @param path - The relative path to the asset
+* @returns The resolved asset path, which may be an absolute URL if resourcesUrl is set to an external URL, or a relative path if resourcesUrl is a relative path or not set at all
+*/
+const getAssetPath = (path) => {
+	const base = plt.$resourcesUrl$ || "./";
+	const assetUrl = new URL(path, base);
+	return assetUrl.origin !== win.location.origin ? assetUrl.href : assetUrl.pathname;
+};
+/**
+* Sets the base URL for resolving asset paths in the server/hydrate context.
+* @param path - The base URL to use for resolving asset paths. This should typically be set to the same value as the `resourcesUrl` option passed to `hydrateDocument` to ensure that asset paths are resolved correctly in the server/hydrate context.
+* If not set, it defaults to './', which is a reasonable default for server-side rendering.
+* @returns void
+*/
+const setAssetPath = (path) => plt.$resourcesUrl$ = path;
+/**
 * Checks to see any components are rendered with `scoped`
 * @param opts - SSR options
 */

package/dist/{runtime-BBCnuprF.js → runtime-COEYYPyw.js}

@@ -3875,9 +3875,11 @@ const proxyComponent = (Cstr, cmpMeta, flags) => {
 						return;
 					}
 					const propFlags = members.find(([m]) => m === propName);
-					if (propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean) newValue = newValue !== null && newValue !== "false";
+					const isBooleanTarget = propFlags && propFlags[1][0] & MEMBER_FLAGS.Boolean;
+					const isSpuriousBooleanRemoval = isBooleanTarget && newValue === null && this[propName] === void 0;
+					if (isBooleanTarget) newValue = !(newValue === null || newValue === "false");
 					const propDesc = Object.getOwnPropertyDescriptor(prototype, propName);
-					if (newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
+					if (!isSpuriousBooleanRemoval && newValue != this[propName] && (!propDesc.get || !!propDesc.set)) this[propName] = newValue;
 				});
 			};
 			Cstr.observedAttributes = Array.from(new Set([...Object.keys(cmpMeta.$watchers$ ?? {}), ...members.filter(([_, m]) => m[0] & MEMBER_FLAGS.HasAttribute).map(([propName, m]) => {
@@ -4406,8 +4408,19 @@ const setPlatformOptions = (opts) => Object.assign(plt, opts);
 //#endregion
 //#region src/runtime/render.ts
 /**
+* A WeakMap to persist HostRef objects across multiple render() calls to the
+* same container. This enables VNode diffing on re-renders — without it, each
+* call creates a fresh HostRef with no previous VNode, causing renderVdom to
+* replace the entire DOM subtree instead of patching only what changed.
+*/
+const hostRefCache = /* @__PURE__ */ new WeakMap();
+/**
 * Method to render a virtual DOM tree to a container element.
 *
+* Supports efficient re-renders: calling `render()` again on the same container
+* will diff the new VNode tree against the previous one and only update what changed,
+* preserving existing DOM elements and their state.
+*
 * @example
 * ```tsx
 * import { render } from '@stencil/core';
@@ -4424,14 +4437,19 @@ const setPlatformOptions = (opts) => Object.assign(plt, opts);
 * @param container - The container element to render the virtual DOM tree to
 */
 function render(vnode, container) {
-	renderVdom({
-		$flags$: 0,
-		$cmpMeta$: {
+	let ref = hostRefCache.get(container);
+	if (!ref) {
+		ref = {
 			$flags$: 0,
-			$tagName$: container.tagName
-		},
-		$hostElement$: container
-	}, vnode);
+			$cmpMeta$: {
+				$flags$: 0,
+				$tagName$: container.tagName
+			},
+			$hostElement$: container
+		};
+		hostRefCache.set(container, ref);
+	}
+	renderVdom(ref, vnode);
 }
 //#endregion
 //#region src/runtime/tag-transform.ts

package/dist/sys/node/index.d.mts

@@ -1,4 +1,4 @@
-import { Qr as Logger, gr as CompilerSystem } from "../../index-tUR6pD3J.mjs";
+import { $r as Logger, _r as CompilerSystem } from "../../index-BwTaN1Nq.mjs";
 
 //#region src/sys/node/logger/index.d.ts
 /**

package/dist/sys/node/index.mjs

@@ -1,2 +1,2 @@
-import { n as setupNodeProcess, r as createNodeLogger, t as createNodeSys } from "../../node-Bg-mO5dw.mjs";
+import { n as setupNodeProcess, r as createNodeLogger, t as createNodeSys } from "../../node-BF2jSfWg.mjs";
 export { createNodeLogger, createNodeSys, setupNodeProcess };

package/dist/sys/node/worker.mjs

@@ -1,5 +1,5 @@
-import { l as createWorkerMessageHandler } from "../../compiler-D6iP7Bzb.mjs";
-import { t as createNodeSys } from "../../node-Bg-mO5dw.mjs";
+import { l as createWorkerMessageHandler } from "../../compiler-BYRrEeD-.mjs";
+import { t as createNodeSys } from "../../node-BF2jSfWg.mjs";
 //#region src/sys/node/node-worker-thread.ts
 /**
 * Initialize a worker thread, setting up various machinery for managing

package/dist/testing/index.d.mts

@@ -1,5 +1,5 @@
-import { B as ComponentCompilerMeta, E as CompilerCtx, Qr as Logger, Rr as Diagnostic, Tt as HostRef, Wt as NewSpecPageOptions, Yr as LoadConfigInit, Zr as LogLevel, a as BuildCtx, ca as RafCallback, da as UserBuildConditionals, ei as LoggerTimeSpan, gr as CompilerSystem, mn as RuntimeRef, na as ValidatedConfig, oa as ErrorHandler, pt as ComponentRuntimeMeta, ta as UnvalidatedConfig, wt as HostElement, yn as SpecPage, zt as Module } from "../index-tUR6pD3J.mjs";
-import { _ as Env, c as getMode, d as Fragment, f as createEvent, g as setAssetPath, h as getAssetPath, i as getRenderingRef, n as h, p as getElement, r as forceUpdate, t as Host, u as Mixin } from "../index-CXHCTQNt.mjs";
+import { $r as Logger, B as ComponentCompilerMeta, Bt as Module, E as CompilerCtx, Et as HostRef, Gt as NewSpecPageOptions, Qr as LogLevel, Tt as HostElement, Xr as LoadConfigInit, _r as CompilerSystem, a as BuildCtx, bn as SpecPage, fa as UserBuildConditionals, hn as RuntimeRef, la as RafCallback, na as UnvalidatedConfig, pt as ComponentRuntimeMeta, ra as ValidatedConfig, sa as ErrorHandler, ti as LoggerTimeSpan, zr as Diagnostic } from "../index-BwTaN1Nq.mjs";
+import { _ as Env, c as getMode, d as Fragment, f as createEvent, g as setAssetPath, h as getAssetPath, i as getRenderingRef, n as h, p as getElement, r as forceUpdate, t as Host, u as Mixin } from "../index-9LTuoSiw.mjs";
 import { Mock } from "vitest";
 
 //#region src/testing/testing-logger.d.ts

package/dist/testing/index.mjs

@@ -1,8 +1,8 @@
-import { B as BUILD, E as reWireGetterSetter, V as Env, _ as getElement, a as Mixin, b as setAssetPath, c as forceUpdate, d as createEvent, f as getMode, g as h, h as Host, l as getRenderingRef, o as Fragment, s as bootstrapLazy, t as insertVdomAnnotations, u as renderVdom, y as getAssetPath } from "../client-CSm3x5ke.mjs";
+import { B as BUILD, E as reWireGetterSetter, V as Env, _ as getElement, a as Mixin, b as setAssetPath, c as forceUpdate, d as createEvent, f as getMode, g as h, h as Host, l as getRenderingRef, o as Fragment, s as bootstrapLazy, t as insertVdomAnnotations, u as renderVdom, y as getAssetPath } from "../client-Dti6fFpE.mjs";
 import { C as CMP_FLAGS, V as EVENT_FLAGS, h as noop } from "../regular-expression-D5pGVpCu.mjs";
-import { _ as getBuildFeatures, c as createWorkerContext, h as BuildContext, i as createSystem, m as Cache, p as createInMemoryFs } from "../compiler-D6iP7Bzb.mjs";
+import { _ as getBuildFeatures, c as createWorkerContext, h as BuildContext, i as createSystem, m as Cache, p as createInMemoryFs } from "../compiler-BYRrEeD-.mjs";
 import { St as formatLazyBundleRuntimeMeta } from "../validation-Byxie0Uk.mjs";
-import { o as buildEvents } from "../node-Bg-mO5dw.mjs";
+import { o as buildEvents } from "../node-BF2jSfWg.mjs";
 import path from "node:path";
 import path$1 from "path";
 import { MockWindow, setupGlobal } from "@stencil/mock-doc";
@@ -387,7 +387,8 @@ function mockCompilerCtx(config) {
 		rolldownCacheLazy: null,
 		rolldownCacheNative: null,
 		styleModeNames: /* @__PURE__ */ new Set(),
-		worker: createWorkerContext(innerConfig.sys)
+		worker: createWorkerContext(innerConfig.sys),
+		cssTransformCache: /* @__PURE__ */ new Map()
 	};
 	Object.defineProperty(compilerCtx, "fs", { get() {
 		if (this._fs == null) this._fs = createInMemoryFs(innerConfig.sys);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core",
-  "version": "5.0.0-alpha.3",
+  "version": "5.0.0-alpha.4",
   "description": "A Compiler for Web Components and Progressive Web Apps",
   "keywords": [
     "components",
@@ -109,9 +109,9 @@
     "semver": "^7.7.4",
     "terser": "5.37.0",
     "typescript": "~6.0.2",
-    "@stencil/cli": "5.0.0-alpha.3",
-    "@stencil/mock-doc": "5.0.0-alpha.3",
-    "@stencil/dev-server": "5.0.0-alpha.3"
+    "@stencil/cli": "5.0.0-alpha.4",
+    "@stencil/dev-server": "5.0.0-alpha.4",
+    "@stencil/mock-doc": "5.0.0-alpha.4"
   },
   "devDependencies": {
     "@ionic/prettier-config": "^4.0.0",