@stencil/core 5.0.0-alpha.1 → 5.0.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/app-data/index.d.ts +2 -0
  2. package/dist/{runtime/app-data → app-data}/index.js +17 -12
  3. package/dist/{client-B1nuvCd2.mjs → client-aTQ7xHxx.mjs} +2432 -2278
  4. package/dist/compiler/index.d.mts +6 -6
  5. package/dist/compiler/index.mjs +2 -2
  6. package/dist/compiler/utils/index.d.mts +2 -2
  7. package/dist/compiler/utils/index.mjs +3 -3
  8. package/dist/{compiler-LX4_RKKd.mjs → compiler-lTINDSgw.mjs} +14854 -13500
  9. package/dist/declarations/stencil-public-compiler.d.ts +4374 -2
  10. package/dist/declarations/stencil-public-compiler.js +2 -4
  11. package/dist/declarations/stencil-public-docs.d.ts +504 -1
  12. package/dist/declarations/stencil-public-runtime.d.ts +1982 -2
  13. package/dist/{index-fIuYTL9f.d.mts → index-BvkyxSY6.d.mts} +29 -2
  14. package/dist/{index-D-LlB2nw.d.mts → index-vY35H18z.d.mts} +795 -1188
  15. package/dist/{index-BONzXKJt.d.ts → index-xAkMgLX_.d.ts} +88 -39
  16. package/dist/index.d.mts +1 -1
  17. package/dist/index.mjs +2 -2
  18. package/dist/jsx-runtime.d.mts +18 -0
  19. package/dist/jsx-runtime.mjs +2 -0
  20. package/dist/{node-SxQIOCZE.mjs → node--akYC-sG.mjs} +20 -30
  21. package/dist/regular-expression-CFVJOTUh.mjs +508 -0
  22. package/dist/{runtime-CF9DJtSu.js → runtime/client/lazy.js} +2675 -2493
  23. package/dist/runtime/client/{index.d.ts → runtime.d.ts} +106 -78
  24. package/dist/runtime/client/{index.js → runtime.js} +2545 -2487
  25. package/dist/runtime/index.d.ts +58 -29
  26. package/dist/runtime/index.js +4795 -2
  27. package/dist/runtime/server/index.d.mts +103 -70
  28. package/dist/runtime/server/index.mjs +2545 -2350
  29. package/dist/runtime/server/runner.d.mts +44 -48
  30. package/dist/runtime/server/runner.mjs +347 -751
  31. package/dist/signals/index.d.ts +47 -0
  32. package/dist/signals/index.js +199 -0
  33. package/dist/sys/node/index.d.mts +1 -1
  34. package/dist/sys/node/index.mjs +1 -1
  35. package/dist/sys/node/worker.mjs +2 -2
  36. package/dist/testing/index.d.mts +97 -3
  37. package/dist/testing/index.mjs +367 -59
  38. package/dist/{validation-CaCgjw-f.mjs → validation-ByxKj8bC.mjs} +116 -99
  39. package/package.json +47 -38
  40. package/dist/index-CHjZtib0.d.ts +0 -30
  41. package/dist/jsx-runtime-DBzBJLKk.d.ts +0 -28
  42. package/dist/jsx-runtime.d.ts +0 -2
  43. package/dist/jsx-runtime.js +0 -2
  44. package/dist/runtime/app-data/index.d.ts +0 -2
  45. package/dist/serialize-BkYHk7Mi.mjs +0 -766
  46. package/dist/stencil-public-compiler-C_X1iolo.d.ts +0 -4455
  47. package/dist/stencil-public-runtime-DlV8o7-z.d.ts +0 -1845
  48. /package/dist/{runtime/app-globals → app-globals}/index.d.ts +0 -0
  49. /package/dist/{runtime/app-globals → app-globals}/index.js +0 -0
  50. /package/dist/{chunk-CjcI7cDX.mjs → chunk-z9aeyW2b.mjs} +0 -0
package/dist/runtime/client/{index.d.ts → runtime.d.ts} RENAMED
@@ -1,4 +1,4 @@
1
- import { BUILD, Env, NAMESPACE } from "@stencil/core/runtime/app-data";
1
+ import { BUILD, Env, NAMESPACE } from "@stencil/core/app-data";
2
2
  //#region src/declarations/stencil-public-runtime.d.ts
3
3
  interface ElementDecorator {
4
4
  (): PropertyDecorator;
@@ -107,6 +107,14 @@ interface ComponentInterface {
107
107
  interface RafCallback {
108
108
  (timeStamp: number): void;
109
109
  }
110
+ /**
111
+ * Minimal interface matched by signal objects (from @stencil/core/signals).
112
+ * Used in JSX attribute types.
113
+ */
114
+ interface SignalRef<T = any> {
115
+ readonly value: T;
116
+ peek(): T;
117
+ }
110
118
  /**
111
119
  * Utilities for working with functional Stencil components. An object
112
120
  * conforming to this interface is passed by the Stencil runtime as the third
@@ -148,7 +156,7 @@ interface FunctionalUtilities {
148
156
  map: (children: VNode[], cb: (vnode: ChildNode$1, index: number, array: ChildNode$1[]) => ChildNode$1) => VNode[];
149
157
  }
150
158
  interface FunctionalComponent<T = {}> {
151
- (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[] | null;
159
+ (props: T, children: VNode[], utils: FunctionalUtilities): VNode | null;
152
160
  }
153
161
  /**
154
162
  * A Child VDOM node
@@ -159,7 +167,7 @@ interface FunctionalComponent<T = {}> {
159
167
  * {@link FunctionalUtilities}).
160
168
  */
161
169
  interface ChildNode$1 {
162
- vtag?: string | number | Function;
170
+ vtag?: string | number | Function | symbol | null;
163
171
  vkey?: string | number;
164
172
  vtext?: string;
165
173
  vchildren?: VNode[];
@@ -171,13 +179,15 @@ interface ChildNode$1 {
171
179
  */
172
180
  interface VNode {
173
181
  $flags$: number;
174
- $tag$: string | number | Function;
182
+ $tag$: string | number | Function | symbol | null;
175
183
  $elm$: any;
176
184
  $text$: string;
177
185
  $children$: VNode[];
178
186
  $attrs$?: any;
179
187
  $name$?: string;
180
188
  $key$?: string | number;
189
+ /** Signal reference for vdom bypass: signal text nodes store the signal here. */
190
+ $signal$?: any;
181
191
  }
182
192
  declare namespace JSXBase {
183
193
  interface IntrinsicElements {
@@ -497,6 +507,7 @@ declare namespace JSXBase {
497
507
  importance?: 'low' | 'auto' | 'high';
498
508
  height?: number | string;
499
509
  loading?: 'lazy' | 'auto' | 'eager';
510
+ referrerPolicy?: ReferrerPolicy;
500
511
  sizes?: string;
501
512
  src?: string;
502
513
  srcSet?: string;
@@ -812,7 +823,7 @@ declare namespace JSXBase {
812
823
  autofocus?: boolean | string;
813
824
  class?: string | {
814
825
  [className: string]: boolean;
815
- };
826
+ } | SignalRef<string>;
816
827
  contentEditable?: boolean | string;
817
828
  contenteditable?: boolean | string;
818
829
  contextMenu?: string;
@@ -871,7 +882,7 @@ declare namespace JSXBase {
871
882
  interface SVGAttributes<T = SVGElement> extends DOMAttributes<T> {
872
883
  class?: string | {
873
884
  [className: string]: boolean;
874
- };
885
+ } | SignalRef<string>;
875
886
  color?: string;
876
887
  height?: number | string;
877
888
  id?: string;
@@ -1272,12 +1283,13 @@ declare namespace JSXBase {
1272
1283
  interface JSXAttributes<T = Element$2> {
1273
1284
  key?: string | number;
1274
1285
  ref?: (elm?: T) => void;
1286
+ children?: any;
1275
1287
  }
1276
1288
  interface CustomElementsDefineOptions {
1277
1289
  exclude?: string[];
1278
1290
  syncQueue?: boolean;
1279
- /** @deprecated in-favour of `setTagTransformer` and `transformTag` */
1280
- transformTagName?: (tagName: string) => string;
1291
+ /** Scoped custom element registry to define components in. Defaults to the global registry. */
1292
+ registry?: CustomElementRegistry;
1281
1293
  jmp?: (c: Function) => any;
1282
1294
  raf?: (c: FrameRequestCallback) => number;
1283
1295
  ael?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
@@ -1286,7 +1298,7 @@ interface CustomElementsDefineOptions {
1286
1298
  }
1287
1299
  //#endregion
1288
1300
  //#region src/declarations/stencil-public-compiler.d.ts
1289
- interface HydrateDocumentOptions {
1301
+ interface SsrDocumentOptions {
1290
1302
  /**
1291
1303
  * Build ID that will be added to `<html data-stencil-build="BUILD_ID">`. By default
1292
1304
  * a random ID will be generated
@@ -1303,7 +1315,7 @@ interface HydrateDocumentOptions {
1303
1315
  * JavaScript to read the structure of the HTML and rebuild each
1304
1316
  * component. Defaults to `true`.
1305
1317
  */
1306
- clientHydrateAnnotations?: boolean;
1318
+ clientSsrAnnotations?: boolean;
1307
1319
  /**
1308
1320
  * Constrain `setTimeout()` to 1ms, but still async. Also
1309
1321
  * only allows `setInterval()` to fire once, also constrained to 1ms.
@@ -1402,10 +1414,14 @@ interface HydrateDocumentOptions {
1402
1414
  default: 'declarative-shadow-dom' | 'scoped';
1403
1415
  } | boolean;
1404
1416
  }
1405
- interface SerializeDocumentOptions extends HydrateDocumentOptions {
1417
+ interface SerializeDocumentOptions extends SsrDocumentOptions {
1406
1418
  /**
1407
1419
  * Runs after the `document` has been hydrated.
1408
1420
  */
1421
+ afterSsr?(document: any): any | Promise<any>;
1422
+ /**
1423
+ * @deprecated Use `afterSsr` instead.
1424
+ */
1409
1425
  afterHydrate?(document: any): any | Promise<any>;
1410
1426
  /**
1411
1427
  * Sets an approximate line width the HTML should attempt to stay within.
@@ -1418,6 +1434,10 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
1418
1434
  /**
1419
1435
  * Runs before the `document` has been hydrated.
1420
1436
  */
1437
+ beforeSsr?(document: any): any | Promise<any>;
1438
+ /**
1439
+ * @deprecated Use `beforeSsr` instead.
1440
+ */
1421
1441
  beforeHydrate?(document: any): any | Promise<any>;
1422
1442
  /**
1423
1443
  * Format the HTML in a nicely indented format.
@@ -1455,7 +1475,7 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
1455
1475
  */
1456
1476
  modes?: ResolutionHandler[];
1457
1477
  }
1458
- interface HydrateFactoryOptions extends SerializeDocumentOptions {
1478
+ interface SsrFactoryOptions extends SerializeDocumentOptions {
1459
1479
  serializeToHtml: boolean;
1460
1480
  destroyWindow: boolean;
1461
1481
  destroyDocument: boolean;
@@ -1525,7 +1545,7 @@ interface HostElement extends HTMLElement {
1525
1545
  disconnectedCallback?: () => void;
1526
1546
  host?: Element;
1527
1547
  forceUpdate?: () => void;
1528
- __stencil__getHostRef?: () => HostRef;
1548
+ __s_ghr?: () => HostRef;
1529
1549
  /**
1530
1550
  * Unique stencil id for this element
1531
1551
  */
@@ -1673,61 +1693,61 @@ interface RenderNode extends HostElement {
1673
1693
  ['s-en']?: '' | /*shadow*/'c';
1674
1694
  /**
1675
1695
  * On a `scoped: true` component
1676
- * with `experimentalSlotFixes` flag enabled,
1696
+ * with `lightDomPatches` flag enabled,
1677
1697
  * returns the internal `childNodes` of the component
1678
1698
  */
1679
1699
  readonly __childNodes?: NodeListOf<ChildNode>;
1680
1700
  /**
1681
1701
  * On a `scoped: true` component
1682
- * with `experimentalSlotFixes` flag enabled,
1702
+ * with `lightDomPatches` flag enabled,
1683
1703
  * returns the internal `children` of the component
1684
1704
  */
1685
1705
  readonly __children?: HTMLCollectionOf<Element>;
1686
1706
  /**
1687
1707
  * On a `scoped: true` component
1688
- * with `experimentalSlotFixes` flag enabled,
1708
+ * with `lightDomPatches` flag enabled,
1689
1709
  * returns the internal `firstChild` of the component
1690
1710
  */
1691
1711
  readonly __firstChild?: ChildNode;
1692
1712
  /**
1693
1713
  * On a `scoped: true` component
1694
- * with `experimentalSlotFixes` flag enabled,
1714
+ * with `lightDomPatches` flag enabled,
1695
1715
  * returns the internal `lastChild` of the component
1696
1716
  */
1697
1717
  readonly __lastChild?: ChildNode;
1698
1718
  /**
1699
1719
  * On a `scoped: true` component
1700
- * with `experimentalSlotFixes` flag enabled,
1720
+ * with `lightDomPatches` flag enabled,
1701
1721
  * returns the internal `textContent` of the component
1702
1722
  */
1703
1723
  __textContent?: string;
1704
1724
  /**
1705
1725
  * On a `scoped: true` component
1706
- * with `experimentalSlotFixes` flag enabled,
1726
+ * with `lightDomPatches` flag enabled,
1707
1727
  * gives access to the original `append` method
1708
1728
  */
1709
1729
  __append?: (...nodes: (Node | string)[]) => void;
1710
1730
  /**
1711
1731
  * On a `scoped: true` component
1712
- * with `experimentalSlotFixes` flag enabled,
1732
+ * with `lightDomPatches` flag enabled,
1713
1733
  * gives access to the original `prepend` method
1714
1734
  */
1715
1735
  __prepend?: (...nodes: (Node | string)[]) => void;
1716
1736
  /**
1717
1737
  * On a `scoped: true` component
1718
- * with `experimentalSlotFixes` flag enabled,
1738
+ * with `lightDomPatches` flag enabled,
1719
1739
  * gives access to the original `appendChild` method
1720
1740
  */
1721
1741
  __appendChild?: <T extends Node>(newChild: T) => T;
1722
1742
  /**
1723
1743
  * On a `scoped: true` component
1724
- * with `experimentalSlotFixes` flag enabled,
1744
+ * with `lightDomPatches` flag enabled,
1725
1745
  * gives access to the original `insertBefore` method
1726
1746
  */
1727
1747
  __insertBefore?: <T extends Node>(node: T, child: Node | null) => T;
1728
1748
  /**
1729
1749
  * On a `scoped: true` component
1730
- * with `experimentalSlotFixes` flag enabled,
1750
+ * with `lightDomPatches` flag enabled,
1731
1751
  * gives access to the original `removeChild` method
1732
1752
  */
1733
1753
  __removeChild?: <T extends Node>(child: T) => T;
@@ -1765,31 +1785,31 @@ interface PatchedSlotNode extends Node {
1765
1785
  ['s-sr']?: boolean;
1766
1786
  /**
1767
1787
  * On a `scoped: true` component
1768
- * with `experimentalSlotFixes` flag enabled,
1788
+ * with `lightDomPatches` flag enabled,
1769
1789
  * returns the actual `parentNode` of the component
1770
1790
  */
1771
1791
  __parentNode?: RenderNode;
1772
1792
  /**
1773
1793
  * On a `scoped: true` component
1774
- * with `experimentalSlotFixes` flag enabled,
1794
+ * with `lightDomPatches` flag enabled,
1775
1795
  * returns the actual `nextSibling` of the component
1776
1796
  */
1777
1797
  __nextSibling?: RenderNode;
1778
1798
  /**
1779
1799
  * On a `scoped: true` component
1780
- * with `experimentalSlotFixes` flag enabled,
1800
+ * with `lightDomPatches` flag enabled,
1781
1801
  * returns the actual `previousSibling` of the component
1782
1802
  */
1783
1803
  __previousSibling?: RenderNode;
1784
1804
  /**
1785
1805
  * On a `scoped: true` component
1786
- * with `experimentalSlotFixes` flag enabled,
1806
+ * with `lightDomPatches` flag enabled,
1787
1807
  * returns the actual `nextElementSibling` of the component
1788
1808
  */
1789
1809
  __nextElementSibling?: RenderNode;
1790
1810
  /**
1791
1811
  * On a `scoped: true` component
1792
- * with `experimentalSlotFixes` flag enabled,
1812
+ * with `lightDomPatches` flag enabled,
1793
1813
  * returns the actual `nextElementSibling` of the component
1794
1814
  */
1795
1815
  __previousElementSibling?: RenderNode;
@@ -1890,7 +1910,7 @@ type ComponentRuntimeReflectingAttr = [string, string | undefined];
1890
1910
  * associated {@link HostRef} instance.
1891
1911
  */
1892
1912
  type RuntimeRef = HostElement | {
1893
- __stencil__getHostRef?: () => HostRef;
1913
+ __s_ghr?: () => HostRef;
1894
1914
  };
1895
1915
  /**
1896
1916
  * Interface used to track an Element, it's virtual Node (`VNode`), and other data
@@ -1901,6 +1921,9 @@ interface HostRef {
1901
1921
  $cmpMeta$: ComponentRuntimeMeta;
1902
1922
  $hostElement$: HostElement;
1903
1923
  $instanceValues$?: Map<string, any>;
1924
+ $signalValues$?: Map<string, import('@preact/signals-core').Signal<any>>;
1925
+ /** Dispose function that tears down all signal effects for this component. */
1926
+ $signalCleanup$?: () => void;
1904
1927
  $serializerValues$?: Map<string, string>;
1905
1928
  $lazyInstance$?: ComponentInterface;
1906
1929
  /**
@@ -2111,6 +2134,7 @@ declare const isMemberInElement: (elm: any, memberName: string) => boolean;
2111
2134
  declare const cmpModules: Map<string, {
2112
2135
  [exportName: string]: ComponentConstructor;
2113
2136
  }>;
2137
+ declare const setLazyLoadBasePath: (url: string) => void;
2114
2138
  declare const loadModule: (cmpMeta: ComponentRuntimeMeta, hostRef: HostRef, hmrVersionId?: string) => Promise<ComponentConstructor | undefined> | ComponentConstructor | undefined;
2115
2139
  //#endregion
2116
2140
  //#region src/client/client-log.d.ts
@@ -2124,7 +2148,7 @@ declare const setErrorHandler: (handler: ErrorHandler) => ErrorHandler;
2124
2148
  //#region src/client/client-style.d.ts
2125
2149
  declare const styles: StyleMap;
2126
2150
  declare const modeResolutionChain: ResolutionHandler[];
2127
- declare const setScopedSSR: (_opts: HydrateFactoryOptions) => void;
2151
+ declare const setScopedSsr: (_opts: SsrFactoryOptions) => void;
2128
2152
  declare const needsScopedSSR: () => boolean;
2129
2153
  //#endregion
2130
2154
  //#region src/client/client-task-queue.d.ts
@@ -2146,7 +2170,6 @@ declare const setPlatformHelpers: (helpers: {
2146
2170
  rel?: (el: any, eventName: string, listener: any, options: any) => void;
2147
2171
  ce?: (eventName: string, opts?: any) => any;
2148
2172
  }) => void;
2149
- declare const supportsShadow: boolean;
2150
2173
  declare const supportsListenerOptions: boolean;
2151
2174
  declare const promiseResolve: (v?: any) => Promise<any>;
2152
2175
  declare const supportsConstructableStylesheets: boolean;
@@ -2156,12 +2179,16 @@ declare const supportsMutableAdoptedStyleSheets: boolean;
2156
2179
  declare const getAssetPath: (path: string) => string;
2157
2180
  declare const setAssetPath: (path: string) => string;
2158
2181
  //#endregion
2159
- //#region src/runtime/bootstrap-custom-element.d.ts
2182
+ //#region src/runtime/bootstrap-standalone.d.ts
2160
2183
  declare const defineCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => void;
2161
2184
  declare const proxyCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => any;
2162
2185
  declare const forceModeUpdate: (elm: RenderNode) => void;
2163
2186
  //#endregion
2164
- //#region src/runtime/bootstrap-lazy.d.ts
2187
+ //#region src/runtime/registry.d.ts
2188
+ declare const setRegistry: (registry: CustomElementRegistry) => void;
2189
+ declare const getRegistry: () => CustomElementRegistry;
2190
+ //#endregion
2191
+ //#region src/runtime/bootstrap-loader.d.ts
2165
2192
  declare const bootstrapLazy: (lazyBundles: LazyBundlesRuntimeData, options?: CustomElementsDefineOptions) => void;
2166
2193
  //#endregion
2167
2194
  //#region src/runtime/connected-callback.d.ts
@@ -2172,6 +2199,18 @@ declare const disconnectedCallback: (elm: HostElement) => Promise<void>;
2172
2199
  //#endregion
2173
2200
  //#region src/runtime/element.d.ts
2174
2201
  declare const getElement: (ref: any) => HostElement;
2202
+ /**
2203
+ * Get the shadow root for a Stencil component's host element.
2204
+ * This works for both open and closed shadow DOM modes.
2205
+ *
2206
+ * For closed shadow DOM, `element.shadowRoot` returns `null` by design,
2207
+ * but Stencil stores the reference internally so components can still
2208
+ * access their own shadow root.
2209
+ *
2210
+ * @param element The host element (from @Element() decorator)
2211
+ * @returns The shadow root, or null if no shadow root exists
2212
+ */
2213
+ declare const getShadowRoot: (element: HTMLElement) => ShadowRoot | null;
2175
2214
  //#endregion
2176
2215
  //#region src/runtime/event-emitter.d.ts
2177
2216
  declare const createEvent: (ref: RuntimeRef, name: string, flags: number) => {
@@ -2182,7 +2221,7 @@ declare const createEvent: (ref: RuntimeRef, name: string, flags: number) => {
2182
2221
  declare const Fragment: FunctionalComponent;
2183
2222
  //#endregion
2184
2223
  //#region src/runtime/host-listener.d.ts
2185
- declare const addHostEventListeners: (elm: HostElement, hostRef: HostRef, listeners?: ComponentRuntimeHostListener[], attachParentListeners?: boolean) => void;
2224
+ declare const addHostEventListeners: (elm: HostElement, hostRef: HostRef, listeners?: ComponentRuntimeHostListener[]) => void;
2186
2225
  //#endregion
2187
2226
  //#region src/runtime/mixin.d.ts
2188
2227
  type Ctor<T = {}> = new (...args: any[]) => T;
@@ -2201,6 +2240,30 @@ declare const getMode: (ref: RuntimeRef) => string;
2201
2240
  */
2202
2241
  declare const setNonce: (nonce: string) => string;
2203
2242
  //#endregion
2243
+ //#region src/runtime/normalize-watchers.d.ts
2244
+ /**
2245
+ * Normalizes watcher metadata to the current `{ [methodName]: flags }[]` format.
2246
+ *
2247
+ * Prior to Stencil 4.39.x (PR #6484), the `@Watch()` compiler emitted watcher
2248
+ * handlers as a plain string array: `{ "min": ["minChanged"] }`. The new format
2249
+ * wraps each entry in an object that carries option flags (e.g. `immediate`):
2250
+ * `{ "min": [{ "minChanged": 0 }] }`.
2251
+ *
2252
+ * When a library (e.g. Ionic Framework) was compiled with an older Stencil compiler
2253
+ * but consumed by an app using a newer Stencil runtime, the runtime's
2254
+ * `Object.entries(watcher)` call receives a string and misinterprets its character
2255
+ * indices as method names, causing:
2256
+ * `TypeError: instance[watchMethodName] is not a function`
2257
+ *
2258
+ * This helper should be used at `$watchers$` assignment sites that need to
2259
+ * accept both legacy and current compiler metadata so downstream code on those
2260
+ * paths can safely assume the new object format.
2261
+ *
2262
+ * @param raw The raw watcher map from compiled metadata (new or legacy format).
2263
+ * @returns A normalized watcher map in the `{ [methodName]: flags }[]` format, or `undefined` if `raw` is `undefined` or empty.
2264
+ */
2265
+ declare const normalizeWatchers: (raw: ComponentConstructorChangeHandlers | undefined) => ComponentConstructorChangeHandlers | undefined;
2266
+ //#endregion
2204
2267
  //#region src/runtime/parse-property-value.d.ts
2205
2268
  /**
2206
2269
  * Parse a new property value for a given property type.
@@ -2259,6 +2322,10 @@ declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRun
2259
2322
  /**
2260
2323
  * Method to render a virtual DOM tree to a container element.
2261
2324
  *
2325
+ * Supports efficient re-renders: calling `render()` again on the same container
2326
+ * will diff the new VNode tree against the previous one and only update what changed,
2327
+ * preserving existing DOM elements and their state.
2328
+ *
2262
2329
  * @example
2263
2330
  * ```tsx
2264
2331
  * import { render } from '@stencil/core';
@@ -2306,53 +2373,14 @@ declare const h: (nodeName: any, vnodeData: any, ...children: ChildType[]) => VN
2306
2373
  declare const Host: {};
2307
2374
  //#endregion
2308
2375
  //#region src/runtime/vdom/jsx-runtime.d.ts
2309
- /**
2310
- * JSX runtime function for creating elements in production mode.
2311
- * Called by TypeScript's jsx transform for elements without static children.
2312
- *
2313
- * @param type - The element type (string tag name or functional component)
2314
- * @param props - The element props (includes children)
2315
- * @param key - Optional key for the element
2316
- * @returns A virtual DOM node
2317
- */
2318
2376
  declare function jsx(type: any, props: any, key?: string): VNode;
2319
2377
  /**
2320
- * JSX runtime function for creating elements with static children.
2321
- * Called by TypeScript's jsx transform as an optimization when children are static.
2322
- *
2323
- * @param type - The element type (string tag name or functional component)
2324
- * @param props - The element props (includes children)
2325
- * @param key - Optional key for the element
2326
- * @returns A virtual DOM node
2327
- */
2328
- declare function jsxs(type: any, props: any, key?: string): VNode;
2329
- //#endregion
2330
- //#region src/runtime/vdom/vdom-annotations.d.ts
2331
- /**
2332
- * Updates the DOM generated on the server with annotations such as node attributes and
2333
- * comment nodes to facilitate future client-side hydration. These annotations are used for things
2334
- * like moving elements back to their original hosts if using Shadow DOM on the client, and for quickly
2335
- * reconstructing the vNode representations of the DOM.
2336
- *
2337
- * @param doc The DOM generated by the server.
2338
- * @param staticComponents Any components that should be considered static and do not need client-side hydration.
2378
+ * @alias
2339
2379
  */
2340
- declare const insertVdomAnnotations: (doc: Document, staticComponents: string[]) => void;
2341
- //#endregion
2342
- //#region src/runtime/vdom/vdom-render.d.ts
2380
+ declare const jsxs: typeof jsx;
2343
2381
  /**
2344
- * The main entry point for Stencil's virtual DOM-based rendering engine
2345
- *
2346
- * Given a {@link d.HostRef} container and some virtual DOM nodes, this
2347
- * function will handle creating a virtual DOM tree with a single root, patching
2348
- * the current virtual DOM tree onto an old one (if any), dealing with slot
2349
- * relocation, and reflecting attributes.
2350
- *
2351
- * @param hostRef data needed to root and render the virtual DOM tree, such as
2352
- * the DOM node into which it should be rendered.
2353
- * @param renderFnResults the virtual DOM nodes to be rendered
2354
- * @param isInitialLoad whether or not this is the first call after page load
2382
+ * @alias
2355
2383
  */
2356
- declare const renderVdom: (hostRef: HostRef, renderFnResults: VNode | VNode[], isInitialLoad?: boolean) => void;
2384
+ declare const jsxDEV: typeof jsx;
2357
2385
  //#endregion
2358
- export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRenderingRef, getValue, h, insertVdomAnnotations, isMemberInElement, jsx, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, render, renderVdom, resolveVar, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, supportsShadow, transformTag, win, writeTask };
2386
+ export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSsr, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, win, writeTask };