@qwik.dev/core 2.0.0-beta.27 → 2.0.0-beta.29

package/dist/backpatch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwik.dev/core/backpatch",
-  "version": "2.0.0-beta.27-dev+7fc6984",
+  "version": "2.0.0-beta.29-dev+bc61b71",
   "main": "index.mjs",
   "types": "index.d.ts",
   "private": true,

package/dist/build/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwik.dev/core/build",
-  "version": "2.0.0-beta.27-dev+7fc6984",
+  "version": "2.0.0-beta.29-dev+bc61b71",
   "main": "index.mjs",
   "types": "index.d.ts",
   "private": true,

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 /**
  * @license
- * @qwik.dev/core/cli 2.0.0-beta.27-dev+7fc6984
+ * @qwik.dev/core/cli 2.0.0-beta.29-dev+bc61b71
  * Copyright QwikDev. All Rights Reserved.
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://github.com/QwikDev/qwik/blob/main/LICENSE
@@ -12908,7 +12908,7 @@ async function printHelp(app) {
   await runCommand2(Object.assign(app, { task: args[0], args }));
 }
 function printVersion() {
-  console.log("2.0.0-beta.27-dev+7fc6984");
+  console.log("2.0.0-beta.29-dev+bc61b71");
 }
 export {
   runCli,

package/dist/core-internal.d.ts

@@ -79,6 +79,19 @@ import { isServer } from './build';
  */
 export declare const $: <T>(expression: T) => QRL<T>;
 
+/**
+ * Register an external projection on a parent component VNode.
+ *
+ * Creates a new VirtualVNode that will render the given component QRL with the given props. The
+ * VNode is stored as a projection on the parent, and a low-priority cursor is added so the cursor
+ * walker will process it.
+ *
+ * Use `_setProjectionTarget` to set the DOM target element before the cursor fires.
+ *
+ * @internal
+ */
+export declare function _addProjection(container: _Container, parentVNode: _VirtualVNode, componentQRL: QRL<any>, props: Record<string, unknown>, slotName: string): _VirtualVNode;
+
 declare interface AddRootFn {
     (obj: unknown, returnRef?: never): number;
     (obj: unknown, returnRef: true): SeenRef;
@@ -1076,7 +1089,7 @@ export declare const createContextId: <STATE = unknown>(name: string) => Context
  *
  * @internal
  */
-export declare const _createQRL: <TYPE>(chunk: string | null, symbol: string, symbolRef?: null | ValueOrPromise<TYPE>, symbolFn?: null | (() => Promise<Record<string, TYPE>>), captures?: Readonly<unknown[]> | string | null) => _QRLInternal<TYPE>;
+export declare const _createQRL: <TYPE>(chunk: string | null, symbol: string, symbolRef?: null | ValueOrPromise<TYPE>, symbolFn?: null | (() => Promise<Record<string, TYPE>>), captures?: Readonly<unknown[]> | string | null, container?: _Container) => _QRLInternal<TYPE>;
 
 /**
  * Create a signal that holds a custom serializable value. See {@link useSerializer$} for more
@@ -1422,6 +1435,13 @@ export { h }
  */
 export declare const _hasStoreEffects: (value: StoreTarget, prop: keyof StoreTarget) => boolean;
 
+/**
+ * HMR event handler. Replaces the component QRL with a fresh one and marks dirty.
+ *
+ * @internal
+ */
+export declare const _hmr: (event: Event, element: Element) => void;
+
 /** @public */
 declare interface HoistEntryStrategy {
     type: 'hoist';
@@ -1857,6 +1877,25 @@ declare type JSXWindowEvents = {
  */
 export declare type KnownEventNames = LiteralUnion<AllEventKeys, string>;
 
+/**
+ * Shared lazy-loading reference that holds module loading metadata. Multiple QRLs pointing to the
+ * same chunk+symbol can share a single LazyRef, differing only in their captured scope.
+ */
+declare class LazyRef<TYPE = unknown> {
+    readonly $chunk$: string | null;
+    readonly $symbol$: string;
+    readonly $symbolFn$: undefined | null | (() => Promise<Record<string, TYPE>>);
+    $ref$?: (null | ValueOrPromise<TYPE>) | undefined;
+    $container$: _Container | undefined;
+    dev?: QRLDev | null | undefined;
+    constructor($chunk$: string | null, $symbol$: string, $symbolFn$: undefined | null | (() => Promise<Record<string, TYPE>>), $ref$?: (null | ValueOrPromise<TYPE>) | undefined, container?: _Container | null);
+    /** We don't read hash very often so let's not allocate a string for every QRL */
+    get $hash$(): string;
+    $setRef$(ref: ValueOrPromise<TYPE>): void;
+    /** Load the raw module export without capture binding. */
+    $load$(): ValueOrPromise<TYPE>;
+}
+
 declare type LcEvent<T extends string, C extends string = Lowercase<T>> = C extends keyof AllEventsMap ? AllEventsMap[C] : Event;
 
 declare type LcEventNameMap = {
@@ -2372,21 +2411,35 @@ declare type QRLInternalMethods<TYPE> = {
     readonly $symbol$: string;
     readonly $hash$: string;
     /** If it's a string it's serialized */
-    $captures$: Readonly<unknown[]> | string | null;
-    dev: QRLDev | null;
+    readonly $captures$?: Readonly<unknown[]> | string | null;
+    dev?: QRLDev | null;
     resolve(container?: _Container): Promise<TYPE>;
     resolved: undefined | TYPE;
     getSymbol(): string;
     getHash(): string;
     getCaptured(): unknown[] | null;
-    getFn(currentCtx?: InvokeContext, beforeFn?: () => void): TYPE extends (...args: any) => any ? (...args: Parameters<TYPE>) => ValueOrPromise<ReturnType<TYPE>> : unknown;
+    getFn(currentCtx?: InvokeContext, 
+    /** If this returns false, the function execution will be skipped */
+    beforeFn?: () => void | false): TYPE extends (...args: any) => any ? (...args: Parameters<TYPE>) => ValueOrPromise<ReturnType<TYPE> | undefined> : unknown;
+    $callFn$(withThis: unknown, ...args: QrlArgs<TYPE>): ValueOrPromise<QrlReturn<TYPE>>;
+    /**
+     * "with captures" - Get a new QRL for these captures, reusing the lazy ref. It's an internal
+     * method but we need to have a stable name because it gets called in user code by the optimizer,
+     * after the $name$ props are mangled
+     */
+    w(captures: Readonly<unknown[]> | string | null): _QRLInternal<TYPE>;
+    /**
+     * "set ref" - Set the ref of the QRL. It's an internal method but we need to have a stable name
+     * because it gets called in user code by the optimizer, after the $name$ props are mangled
+     */
+    s(ref: ValueOrPromise<TYPE>): void;
     /**
      * Needed for deserialization and importing. We don't always have the container while creating
      * qrls in async sections of code
      */
-    $container$: _Container | null;
-    /** Only in dev mode */
-    $symbolRef$?: null | ValueOrPromise<TYPE>;
+    readonly $container$?: _Container | null;
+    /** The shared lazy-loading reference */
+    readonly $lazy$: LazyRef<TYPE>;
 };
 
 declare type QrlReturn<T> = T extends (...args: any) => infer R ? Awaited<R> : unknown;
@@ -2731,6 +2784,13 @@ declare type RefFnInterface<EL> = {
  */
 export declare const _regSymbol: (symbol: any, hash: string) => any;
 
+/**
+ * Remove an external projection from its parent and clean up.
+ *
+ * @internal
+ */
+export declare function _removeProjection(container: _Container, parentVNode: _VirtualVNode, vnode: _VirtualVNode, slotName: string): void;
+
 /**
  * Render JSX.
  *
@@ -3095,6 +3155,16 @@ export declare function _setEvent(serializationCtx: SerializationContext, key: s
  */
 export declare const setPlatform: (plt: CorePlatform) => CorePlatform;
 
+/**
+ * Set the DOM target element for an external projection VNode.
+ *
+ * When the cursor walker processes this VNode, DOM operations will target this element instead of
+ * walking the parent chain.
+ *
+ * @internal
+ */
+export declare function _setProjectionTarget(vnode: _VirtualVNode, targetElement: Element): void;
+
 /** @internal */
 export declare abstract class _SharedContainer implements _Container {
     readonly $version$: string;
@@ -3165,7 +3235,7 @@ declare class SignalImpl<T = any> implements Signal<T> {
     $effects$: undefined | Set<EffectSubscription>;
     $container$: _Container | null;
     $wrappedSignal$: WrappedSignalImpl<T> | null;
-    constructor(container: _Container | null, value: T);
+    constructor(container: _Container | null | undefined, value: T);
     /**
      * Use this to trigger running subscribers, for example when the calculated value has mutated but
      * remained the same object
@@ -4032,6 +4102,13 @@ declare type UnwantedKeys = keyof HTMLAttributesBase | keyof DOMAttributes<any>
  */
 export declare const unwrapStore: <T>(value: T) => T;
 
+/**
+ * Update the props on an external projection VNode and trigger re-rendering.
+ *
+ * @internal
+ */
+export declare function _updateProjectionProps(container: _Container, vnode: _VirtualVNode, newProps: Record<string, unknown>): void;
+
 /**
  * Creates an AsyncSignal which holds the result of the given async function. If the function uses
  * `track()` to track reactive state, and that state changes, the AsyncSignal is recalculated, and
@@ -4205,6 +4282,14 @@ export declare const useContextProvider: <STATE>(context: ContextId<STATE>, newV
 /** @public */
 export declare const useErrorBoundary: () => ErrorBoundaryStore;
 
+/**
+ * Injected by the optimizer into component$ bodies in HMR mode. Registers a document event listener
+ * that triggers component re-render on HMR updates.
+ *
+ * @internal
+ */
+export declare function _useHmr(devPath: string): void;
+
 /** @public */
 export declare const useId: () => string;
 
@@ -4688,7 +4773,7 @@ export declare const _VAR_PROPS: unique symbol;
 export declare const _verifySerializable: <T>(value: T, preMessage?: string) => T;
 
 /**
- * 2.0.0-beta.27-dev+7fc6984
+ * 2.0.0-beta.29-dev+bc61b71
  *
  * @public
  */
@@ -4822,7 +4907,8 @@ export declare const enum _VNodeFlags {
     NEGATED_NAMESPACE_MASK = -1537,
     NS_html = 0,// http://www.w3.org/1999/xhtml
     NS_svg = 512,// http://www.w3.org/2000/svg
-    NS_math = 1024
+    NS_math = 1024,// http://www.w3.org/1998/Math/MathML
+    HasTargetElement = 2048
 }
 
 /** @internal */