marko 6.1.2 → 6.1.4

package/dist/translator/index.js

@@ -118,6 +118,7 @@ let AccessorProp$1 = /* @__PURE__ */ function(AccessorProp) {
 	AccessorProp["DetachedAwait"] = "#DetachedAwait";
 	AccessorProp["EndNode"] = "#EndNode";
 	AccessorProp["Id"] = "#Id";
+	AccessorProp["Load"] = "#Load";
 	AccessorProp["LoopKey"] = "#LoopKey";
 	AccessorProp["ParentBranch"] = "#ParentBranch";
 	AccessorProp["PendingEffects"] = "#PendingEffects";
@@ -248,8 +249,9 @@ function normalizeDynamicRenderer(value) {
 const decodeAccessor = (num) => (num + (num < 26 ? 10 : num < 962 ? 334 : 11998)).toString(36);
 //#endregion
 //#region src/html/serializer.ts
+const K_SCOPE_ID = Symbol("Scope ID");
 const kTouchedIterator = Symbol.for("marko.touchedIterator");
-const { hasOwnProperty } = {};
+const { hasOwnProperty: hasOwnProperty$1 } = {};
 const Generator = (function* () {})().constructor;
 const AsyncGenerator = (async function* () {})().constructor;
 patchIteratorNext(Generator.prototype);
@@ -1078,6 +1080,7 @@ let AccessorProp = /* @__PURE__ */ function(AccessorProp) {
 	AccessorProp["DetachedAwait"] = "V";
 	AccessorProp["EndNode"] = "K";
 	AccessorProp["Id"] = "L";
+	AccessorProp["Load"] = "X";
 	AccessorProp["LoopKey"] = "M";
 	AccessorProp["ParentBranch"] = "N";
 	AccessorProp["PendingEffects"] = "J";
@@ -1104,6 +1107,11 @@ function getMarkoOpts() {
 function isOptimize() {
 	return getMarkoOpts().optimize;
 }
+function getReadyId(file = (0, _marko_compiler_babel_utils.getFile)()) {
+	const { markoOpts } = file;
+	if (!markoOpts.linkAssets) return void 0;
+	return (markoOpts.optimize ? "_" : "ready:") + (0, _marko_compiler_babel_utils.getTemplateId)(markoOpts, file.opts.filename);
+}
 //#endregion
 //#region src/translator/util/get-accessor-char.ts
 function getAccessorPrefix() {
@@ -1340,6 +1348,7 @@ function analyzeExpressionTagName(name, extra) {
 	let type;
 	let nullable = false;
 	let tagNameImported;
+	let tagNameLoad;
 	while ((path = pending.pop()) && type !== 2) if (path.isConditionalExpression()) {
 		pending.push(path.get("consequent"));
 		if (path.node.alternate) pending.push(path.get("alternate"));
@@ -1364,10 +1373,11 @@ function analyzeExpressionTagName(name, extra) {
 		if (binding.kind === "module") {
 			const decl = binding.path.parent;
 			if (MARKO_FILE_REG.test(decl.source.value) && decl.specifiers.some((it) => _marko_compiler.types.isImportDefaultSpecifier(it))) {
-				const resolvedImport = (0, _marko_compiler_babel_utils.resolveTagImport)(name, decl.source.value) || decl.source.value;
+				const resolvedImport = decl.extra?.tagImport || decl.source.value;
 				if (type === void 0) {
 					type = 1;
 					tagNameImported = resolvedImport;
+					tagNameLoad = decl.extra?.loadImport;
 				} else if (type === 0) {
 					type = 2;
 					tagNameImported = void 0;
@@ -1392,7 +1402,10 @@ function analyzeExpressionTagName(name, extra) {
 	} else type = 2;
 	extra.tagNameType = type ?? 2;
 	extra.tagNameNullable = nullable;
-	if (type === 1 && tagNameImported) extra.tagNameImported = tagNameImported;
+	if (type === 1 && tagNameImported) {
+		extra.tagNameImported = tagNameImported;
+		extra.tagNameLoad = tagNameLoad;
+	}
 }
 //#endregion
 //#region src/translator/util/sections.ts
@@ -1851,7 +1864,6 @@ function _escape_comment(val) {
 //#endregion
 //#region src/html/writer.ts
 let $chunk;
-const K_SCOPE_ID = Symbol("Scope ID");
 function getContext(key) {
 	return $chunk.context?.[key];
 }
@@ -1862,7 +1874,7 @@ function _html(html) {
 	$chunk.writeHTML(html);
 }
 function _script(scopeId, registryId) {
-	if ($chunk.context?.[kIsAsync]) _resume_branch(scopeId);
+	if ($chunk.serializeState.readyId || $chunk.context?.[kIsAsync]) _resume_branch(scopeId);
 	$chunk.boundary.state.needsMainRuntime = true;
 	$chunk.writeEffect(scopeId, registryId);
 }
@@ -1901,20 +1913,21 @@ function withBranchId(branchId, cb) {
 	return withContext(kBranchId, branchId, cb);
 }
 let writeScope = (scopeId, partialScope) => {
-	return writeScopeToState($chunk.boundary.state, scopeId, partialScope);
+	const { state } = $chunk.boundary;
+	const target = $chunk.serializeState;
+	const scope = scopeWithId(state, scopeId);
+	const pending = target.writeScopes[scopeId];
+	state.needsMainRuntime = true;
+	Object.assign(scope, partialScope);
+	if (pending && pending !== partialScope) Object.assign(pending, partialScope);
+	else target.writeScopes[scopeId] = partialScope;
+	target.flushScopes = true;
+	return scope;
 };
-function writeScopeToState(state, scopeId, partialScope) {
+function scopeWithId(state, scopeId) {
 	const { scopes } = state;
 	let scope = scopes.get(scopeId);
-	state.needsMainRuntime = true;
-	if (scope) Object.assign(scope, partialScope);
-	else {
-		scope = partialScope;
-		scope[K_SCOPE_ID] = scopeId;
-		state.scopes.set(scopeId, scope);
-	}
-	if (state.writeScopes) state.writeScopes[scopeId] = scope;
-	else state.writeScopes = { [scopeId]: scope };
+	if (!scope) scopes.set(scopeId, scope = { [K_SCOPE_ID]: scopeId });
 	return scope;
 }
 globalThis.setImmediate || globalThis.setTimeout || globalThis.queueMicrotask;
@@ -2103,7 +2116,7 @@ let _dynamic_tag = (scopeId, accessor, tag, inputOrArgs, content, inputIsArgs, s
 		const childScope = getScopeById(branchId);
 		const needsScript = childScope && (childScope["EventAttributes:a"] || childScope["ControlledHandler:a"]);
 		if (needsScript) {
-			childScope["#Renderer"] = renderer;
+			writeScope(branchId, { ["#Renderer"]: renderer });
 			_script(branchId, "d");
 		}
 		if (shouldResume || needsScript) _html(state.mark("'", scopeId + " " + accessor + " " + branchId));
@@ -2138,6 +2151,9 @@ let _dynamic_tag = (scopeId, accessor, tag, inputOrArgs, content, inputIsArgs, s
 	};
 })(_dynamic_tag);
 //#endregion
+//#region src/html/assets.ts
+const { hasOwnProperty } = {};
+//#endregion
 //#region src/translator/util/runtime.ts
 const pureDOMFunctions = new Set([
 	"_await_promise",
@@ -2159,7 +2175,16 @@ const pureDOMFunctions = new Set([
 	"_for_to",
 	"_for_until",
 	"_let",
-	"_const"
+	"_let_change",
+	"_const",
+	"_load_signal",
+	"_load_setup",
+	"_load_template",
+	"_load_visible_trigger",
+	"_load_event_trigger",
+	"_load_idle_trigger",
+	"_load_media_trigger",
+	"_load_race_trigger"
 ]);
 function importRuntime(name) {
 	const { output } = getMarkoOpts();
@@ -2167,10 +2192,7 @@ function importRuntime(name) {
 }
 function callRuntime(name, ...args) {
 	const callExpression = _marko_compiler.types.callExpression(importRuntime(name), filterArguments(args));
-	if (isOutputDOM() && pureDOMFunctions.has(name)) callExpression.leadingComments = [{
-		type: "CommentBlock",
-		value: ` @__PURE__ `
-	}];
+	if (isOutputDOM() && pureDOMFunctions.has(name)) return _marko_compiler.types.addComment(callExpression, "leading", "@__PURE__");
 	return callExpression;
 }
 function getHTMLRuntime() {
@@ -2943,7 +2965,7 @@ function initValue(binding, isLet = false) {
 	signal.build = () => {
 		const fn = getSignalFn(signal);
 		if (binding.upstreamAlias && binding.property === void 0 && binding.excludeProperties === void 0 || !signal.hasSideEffect || !signalHasStatements(signal)) return fn;
-		return callRuntime(isLet ? "_let" : "_const", getScopeAccessorLiteral(binding, true, isLet), fn);
+		return callRuntime(isLet ? signal.extraArgs ? "_let_change" : "_let" : "_const", getScopeAccessorLiteral(binding, true, isLet), fn);
 	};
 	for (const alias of binding.aliases) if (alias.type !== 6) initValue(alias);
 	for (const alias of binding.propertyAliases.values()) if (alias.type !== 6) initValue(alias);
@@ -2966,19 +2988,24 @@ function getSignalFn(signal) {
 		for (const alias of binding.aliases) {
 			const aliasSignal = getSignal(alias.section, alias);
 			if (signalHasStatements(aliasSignal)) if (alias.excludeProperties !== void 0) {
-				const props = [];
 				const aliasId = _marko_compiler.types.identifier(alias.name);
-				forEach(alias.excludeProperties, (name) => {
-					const propId = toPropertyName(name);
-					const shorthand = propId.type === "Identifier" && _marko_compiler.types.isValidIdentifier(name);
-					props.push(_marko_compiler.types.objectProperty(propId, shorthand ? propId : generateUidIdentifier(name), false, shorthand));
-				});
-				props.push(_marko_compiler.types.restElement(aliasId));
-				signal.render.push(_marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(_marko_compiler.types.arrowFunctionExpression([_marko_compiler.types.objectPattern(props)], _marko_compiler.types.callExpression(aliasSignal.identifier, [
+				let pattern;
+				if (alias.restOffset) pattern = _marko_compiler.types.arrayPattern(new Array(alias.restOffset).fill(null).concat(_marko_compiler.types.restElement(aliasId)));
+				else {
+					const props = [];
+					forEach(alias.excludeProperties, (name) => {
+						const propId = toPropertyName(name);
+						const shorthand = propId.type === "Identifier" && _marko_compiler.types.isValidIdentifier(name);
+						props.push(_marko_compiler.types.objectProperty(propId, shorthand ? propId : generateUidIdentifier(name), false, shorthand));
+					});
+					props.push(_marko_compiler.types.restElement(aliasId));
+					pattern = _marko_compiler.types.objectPattern(props);
+				}
+				signal.render.push(_marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(_marko_compiler.types.arrowFunctionExpression([pattern], _marko_compiler.types.callExpression(aliasSignal.identifier, [
 					scopeIdentifier,
 					aliasId,
 					...getTranslatedExtraArgs(aliasSignal)
-				])), [binding.nullable ? _marko_compiler.types.logicalExpression("||", createScopeReadExpression(binding), _marko_compiler.types.objectExpression([])) : createScopeReadExpression(binding)])));
+				])), [binding.nullable ? _marko_compiler.types.logicalExpression("||", createScopeReadExpression(binding), alias.restOffset ? _marko_compiler.types.arrayExpression([]) : _marko_compiler.types.objectExpression([])) : createScopeReadExpression(binding)])));
 			} else signal.render.push(_marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(aliasSignal.identifier, [
 				scopeIdentifier,
 				createScopeReadExpression(binding),
@@ -3877,19 +3904,60 @@ var program_default = {
 	translate: {
 		enter(program) {
 			scopeIdentifier = isOutputDOM() ? generateUidIdentifier("scope") : null;
-			if (getMarkoOpts().output === "hydrate") {
-				const entryFile = program.hub.file;
-				const visitedFiles = new Set([(0, _marko_compiler_babel_utils.resolveRelativePath)(entryFile, entryFile.opts.filename)]);
-				entry_builder_default.visit(entryFile, entryFile, function visitChild(resolved) {
-					if (!visitedFiles.has(resolved)) {
-						visitedFiles.add(resolved);
-						const file = (0, _marko_compiler_babel_utils.loadFileForImport)(entryFile, resolved);
-						if (file) entry_builder_default.visit(file, entryFile, (id) => visitChild(resolveRelativeToEntry(entryFile, file, id)));
-					}
-				});
-				program.node.body = entry_builder_default.build(entryFile);
-				program.skip();
-				return;
+			{
+				const markoOpts = getMarkoOpts();
+				const { output, entry, runtimeId } = markoOpts;
+				const isLoadEntry = entry === "load";
+				const isDOMPageEntry = output === "dom" && entry === "page" || output === "hydrate";
+				const isServerEntry = output === "html" && entry === "page";
+				if (entry && !markoOpts.linkAssets) throw program.buildCodeFrameError("The \"entry\" option requires the `linkAssets` compiler option to be configured.");
+				if (runtimeId && !/^[_$a-z][_$a-z0-9]*$/i.test(runtimeId)) throw program.buildCodeFrameError(`Invalid runtimeId: "${runtimeId}". The runtimeId must be a valid JavaScript identifier.`);
+				if (isLoadEntry) {
+					const entryFile = program.hub.file;
+					const { filename } = entryFile.opts;
+					const readyArgs = [_marko_compiler.types.stringLiteral(getReadyId(entryFile))];
+					if (runtimeId) readyArgs.push(_marko_compiler.types.stringLiteral(runtimeId));
+					program.node.body = [_marko_compiler.types.importDeclaration([_marko_compiler.types.importSpecifier(_marko_compiler.types.identifier("ready"), _marko_compiler.types.identifier("ready"))], _marko_compiler.types.stringLiteral(getRuntimePath("dom"))), _marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(_marko_compiler.types.memberExpression(_marko_compiler.types.callExpression(_marko_compiler.types.import(), [_marko_compiler.types.stringLiteral((0, _marko_compiler_babel_utils.resolveRelativePath)(entryFile, filename))]), _marko_compiler.types.identifier("then")), [_marko_compiler.types.arrowFunctionExpression([], _marko_compiler.types.callExpression(_marko_compiler.types.identifier("ready"), readyArgs))]))];
+					program.skip();
+					return;
+				}
+				if (isDOMPageEntry) {
+					const entryFile = program.hub.file;
+					const { filename } = entryFile.opts;
+					const visitedFiles = new Set([(0, _marko_compiler_babel_utils.resolveRelativePath)(entryFile, filename)]);
+					entry_builder_default.visit(entryFile, entryFile, function visitChild(resolved) {
+						if (!visitedFiles.has(resolved)) {
+							visitedFiles.add(resolved);
+							const file = (0, _marko_compiler_babel_utils.loadFileForImport)(entryFile, resolved);
+							if (file) entry_builder_default.visit(file, entryFile, (id) => visitChild(resolveRelativeToEntry(entryFile, file, id)));
+						}
+					});
+					program.node.body = entry_builder_default.build(entryFile);
+					program.skip();
+					return;
+				}
+				if (isServerEntry) {
+					const entryFile = program.hub.file;
+					const { filename } = entryFile.opts;
+					const relativeImport = (0, _marko_compiler_babel_utils.resolveRelativePath)(entryFile, filename);
+					const templateId = (0, _marko_compiler_babel_utils.getTemplateId)(markoOpts, filename);
+					const pageAssetArgs = [
+						_marko_compiler.types.identifier("template"),
+						_marko_compiler.types.identifier("flush"),
+						_marko_compiler.types.stringLiteral(templateId)
+					];
+					if (runtimeId) pageAssetArgs.push(_marko_compiler.types.stringLiteral(runtimeId));
+					markoOpts.linkAssets.onAsset("page", filename, templateId);
+					program.node.body = [
+						_marko_compiler.types.importDeclaration([_marko_compiler.types.importSpecifier(_marko_compiler.types.identifier("flush"), _marko_compiler.types.identifier("flush"))], _marko_compiler.types.stringLiteral(markoOpts.linkAssets.runtime)),
+						_marko_compiler.types.importDeclaration([_marko_compiler.types.importDefaultSpecifier(_marko_compiler.types.identifier("template"))], _marko_compiler.types.stringLiteral(relativeImport)),
+						_marko_compiler.types.importDeclaration([_marko_compiler.types.importSpecifier(_marko_compiler.types.identifier("withPageAssets"), _marko_compiler.types.identifier("withPageAssets"))], _marko_compiler.types.stringLiteral(getRuntimePath("html"))),
+						_marko_compiler.types.exportAllDeclaration(_marko_compiler.types.stringLiteral(relativeImport)),
+						_marko_compiler.types.exportDefaultDeclaration(_marko_compiler.types.callExpression(_marko_compiler.types.identifier("withPageAssets"), pageAssetArgs))
+					];
+					program.skip();
+					return;
+				}
 			}
 			if (isOutputHTML()) html_default.translate.enter();
 			else dom_default.translate.enter(program);
@@ -4286,7 +4354,10 @@ var native_tag_default = {
 					for (const child of tag.node.body.body) if (_marko_compiler.types.isMarkoText(child)) write`${child.value}`;
 					else if (_marko_compiler.types.isMarkoPlaceholder(child)) write`${callRuntime(getTextOnlyEscapeHelper(tagName), child.value)}`;
 				} else tag.insertBefore(tag.node.body.body).forEach((child) => child.skip());
-				if (!tagExtra[kSkipEndTag] && !isOpenOnly && !selectArgs) write`</${tagName}>`;
+				if (!tagExtra[kSkipEndTag] && !isOpenOnly && !selectArgs) {
+					if (tagName === "head" && getMarkoOpts().linkAssets) write`${callRuntime("_flush_head")}`;
+					write`</${tagName}>`;
+				}
 				if (markerSerializeReason) markNode(tag, nodeBinding, markerSerializeReason);
 				tag.remove();
 			}
@@ -5655,6 +5726,7 @@ function createBinding(name, type, refSection, upstreamAlias, property, excludeP
 		getters: /* @__PURE__ */ new Map(),
 		propertyAliases: /* @__PURE__ */ new Map(),
 		upstreamAlias,
+		restOffset: void 0,
 		scopeOffset: void 0,
 		scopeAccessor: void 0,
 		export: void 0,
@@ -5725,7 +5797,7 @@ function trackParamsReferences(body, type) {
 		if (bodySection) bodySection.params = paramsBinding;
 		for (let i = 0; i < params.length; i++) {
 			const param = params[i];
-			if (param.type === "RestElement") createBindingsAndTrackReferences(param.argument, type, body.scope, section, paramsBinding, void 0, i > 0 ? addNumericPropertiesUntil(void 0, i - 1) : void 0);
+			if (param.type === "RestElement") createBindingsAndTrackReferences(param.argument, type, body.scope, section, paramsBinding, void 0, i > 0 ? addNumericPropertiesUntil(void 0, i) : void 0, i);
 			else if (_marko_compiler.types.isLVal(param)) createBindingsAndTrackReferences(param, type, body.scope, section, paramsBinding, i + "", void 0);
 		}
 		return paramsBinding;
@@ -5815,11 +5887,14 @@ function setReferencesScope(path) {
 	const fnRoot = getFnRoot(path);
 	if (fnRoot) (fnRoot.node.extra ??= {}).referencesScope = true;
 }
-function createBindingsAndTrackReferences(lVal, type, scope, section, upstreamAlias, property, excludeProperties) {
+function createBindingsAndTrackReferences(lVal, type, scope, section, upstreamAlias, property, excludeProperties, restOffset) {
 	switch (lVal.type) {
-		case "Identifier":
-			trackReferencesForBinding(scope.getBinding(lVal.name), (lVal.extra ??= {}).binding = createBinding(lVal.name, type, section, upstreamAlias, property, excludeProperties, lVal.loc, true));
+		case "Identifier": {
+			const binding = (lVal.extra ??= {}).binding = createBinding(lVal.name, type, section, upstreamAlias, property, excludeProperties, lVal.loc, true);
+			if (restOffset) binding.restOffset = restOffset;
+			trackReferencesForBinding(scope.getBinding(lVal.name), binding);
 			break;
+		}
 		case "ObjectPattern": {
 			const patternBinding = (property ? upstreamAlias.propertyAliases.get(property) : upstreamAlias) || ((lVal.extra ??= {}).binding = createBinding(generateUid(property || "pattern"), type, section, upstreamAlias, property, excludeProperties, lVal.loc));
 			const hasRest = lVal.properties[lVal.properties.length - 1]?.type === "RestElement";
@@ -5844,8 +5919,8 @@ function createBindingsAndTrackReferences(lVal, type, scope, section, upstreamAl
 				i++;
 				if (element) {
 					if (element.type === "RestElement") {
-						excludeProperties = i > 0 ? addNumericPropertiesUntil(excludeProperties, i - 1) : void 0;
-						createBindingsAndTrackReferences(element.argument, type, scope, section, patternBinding, property, excludeProperties);
+						excludeProperties = i > 0 ? addNumericPropertiesUntil(excludeProperties, i) : void 0;
+						createBindingsAndTrackReferences(element.argument, type, scope, section, patternBinding, property, excludeProperties, i);
 					} else if (_marko_compiler.types.isLVal(element)) createBindingsAndTrackReferences(element, type, scope, section, patternBinding, `${i}`, void 0);
 				}
 			}
@@ -5859,9 +5934,16 @@ function trackReference(referencePath, binding) {
 	while (true) {
 		const { parent } = root;
 		if (!_marko_compiler.types.isMemberExpression(parent) && !_marko_compiler.types.isOptionalMemberExpression(parent)) break;
-		const prop = getMemberExpressionPropString(parent);
+		let prop = getMemberExpressionPropString(parent);
 		if (prop === void 0) break;
-		if (reference.upstreamAlias && reference.excludeProperties !== void 0 && !propsUtil.has(reference.excludeProperties, prop)) reference = reference.upstreamAlias;
+		if (reference.upstreamAlias && reference.excludeProperties !== void 0) {
+			if (reference.restOffset) {
+				if (/^\d+$/.test(prop)) {
+					prop = `${+prop + reference.restOffset}`;
+					reference = reference.upstreamAlias;
+				}
+			} else if (!propsUtil.has(reference.excludeProperties, prop)) reference = reference.upstreamAlias;
+		}
 		if (isInvokedFunction(root.parentPath) && !isEventOrChangeHandler(prop)) break;
 		root = root.parentPath;
 		reference = getOrCreatePropertyAlias(reference, prop);
@@ -5925,8 +6007,7 @@ function finalizeReferences() {
 	for (const [expr, reads] of readsByExpression) if (isReferencedExtra(expr)) {
 		const exprBindings = resolveReferencedBindings(expr, reads, intersectionsBySection);
 		expr.referencedBindings = exprBindings.referencedBindings;
-		expr.constantBindings = exprBindings.constantBindings;
-		expr.hoistedBindings = expr.section.referencedHoists = exprBindings.hoistedBindings;
+		if (exprBindings.hoistedBindings) expr.section.referencedHoists = bindingUtil.union(expr.section.referencedHoists, exprBindings.hoistedBindings);
 		if (expr.isEffect) {
 			forEach(exprBindings.referencedBindings, (binding) => {
 				addSerializeReason(binding.section, true, binding);
@@ -5941,7 +6022,6 @@ function finalizeReferences() {
 				const fnBindings = fn === expr ? exprBindings : resolveReferencedBindingsInFunction(exprBindings.allBindings, fnReads);
 				fn.referencedBindingsInFunction = fnBindings.referencedBindings;
 				fn.constantBindingsInFunction = fnBindings.constantBindings;
-				fn.hoistedBindingsInFunction = fnBindings.hoistedBindings;
 			}
 		}
 	}
@@ -6069,10 +6149,22 @@ function finalizeReferences() {
 		finalizeParamSerializeReasonGroups(section);
 	});
 	forEachSection((section) => {
-		let intersectionIndex = 0;
-		const intersections = intersectionsBySection.get(section) || [];
 		const { id, bindings } = section;
 		const isOwnedBinding = ({ section }) => section.id === id;
+		let intersections = intersectionsBySection.get(section) || [];
+		if (intersections.length) {
+			const anchors = /* @__PURE__ */ new Map();
+			for (const intersection of intersections) for (let i = intersection.length; i--;) if (isOwnedBinding(intersection[i])) {
+				anchors.set(intersection, intersection[i]);
+				break;
+			}
+			intersections = [...intersections].sort((a, b) => {
+				const aAnchor = anchors.get(a);
+				const bAnchor = anchors.get(b);
+				return aAnchor ? bAnchor ? bindingUtil.compare(aAnchor, bAnchor) : -1 : bAnchor ? 1 : 0;
+			});
+		}
+		let intersectionIndex = 0;
 		let lastBindingIndex = 0;
 		let intersection;
 		forEach(filter(bindings, isOwnedBinding), (binding, bindingIndex) => {
@@ -6421,27 +6513,21 @@ function pruneBinding(binding) {
 function resolveReferencedBindingsInFunction(refs, reads) {
 	let referencedBindings;
 	let constantBindings;
-	let hoistedBindings;
 	if (reads) if (Array.isArray(reads)) for (const read of reads) {
 		const { getter, binding } = read;
-		if (getter) {
-			if (getter.hoisted && bindingUtil.find(refs, binding)) hoistedBindings = bindingUtil.add(hoistedBindings, binding);
-		} else if (binding.type === 6) {
+		if (getter) {} else if (binding.type === 6) {
 			if (bindingUtil.find(refs, binding)) constantBindings = bindingUtil.add(constantBindings, binding);
 		} else if (binding.type !== 0) referencedBindings = bindingUtil.add(referencedBindings, findClosestReference(read.binding, refs));
 	}
 	else {
 		const { getter, binding } = reads;
-		if (getter) {
-			if (getter.hoisted && bindingUtil.find(refs, binding)) hoistedBindings = binding;
-		} else if (binding.type === 6) {
+		if (getter) {} else if (binding.type === 6) {
 			if (bindingUtil.find(refs, binding)) constantBindings = binding;
 		} else if (binding.type !== 0) referencedBindings = findClosestReference(binding, refs);
 	}
 	return {
 		referencedBindings,
-		constantBindings,
-		hoistedBindings
+		constantBindings
 	};
 }
 function findClosestReference(from, refs) {
@@ -6538,7 +6624,7 @@ function resolveReferencedBindings(expr, reads, intersectionsBySection) {
 	}
 	if (referencedBindings && constantBindings) {
 		const intersections = intersectionsBySection.get(expr.section) || [];
-		const combined = concat(referencedBindings, constantBindings);
+		const combined = bindingUtil.union(referencedBindings, constantBindings);
 		if (!findSorted(compareIntersections, intersections, combined)) intersectionsBySection.set(expr.section, addSorted(compareIntersections, intersections, combined));
 	}
 	return {
@@ -7857,6 +7943,8 @@ var document_type_default = { translate: { exit(documentType) {
 } } };
 //#endregion
 //#region src/translator/visitors/import-declaration.ts
+const triggerRegExp = /\s*([\w-]+)\s*([^?|]+?)?\s*(?:\?([^|]*?))?\s*(?:\||$)/g;
+const [getHtmlLoadWrapped] = createProgramState(() => /* @__PURE__ */ new Map());
 var import_declaration_default = {
 	analyze(importDecl) {
 		const { node } = importDecl;
@@ -7864,19 +7952,118 @@ var import_declaration_default = {
 		const { value } = source;
 		const tagImport = (0, _marko_compiler_babel_utils.resolveTagImport)(importDecl, value);
 		if (tagImport) {
-			node.extra ??= {};
-			node.extra.tagImport = tagImport;
+			(node.extra ??= {}).tagImport = tagImport;
 			const tags = importDecl.hub.file.metadata.marko.tags;
 			if (!tags.includes(tagImport)) tags.push(tagImport);
 		}
+		const loadAttrValuePath = importDecl.get("attributes").find((p) => (p.node.key.type === "Identifier" ? p.node.key.name : p.node.key.value) === "load")?.get("value");
+		if (loadAttrValuePath) {
+			(node.extra ??= {}).loadImport = getLoadImportConfig(loadAttrValuePath);
+			const { file } = importDecl.hub;
+			if (!getMarkoOpts().linkAssets) throw importDecl.buildCodeFrameError("The `load` import attribute requires the `linkAssets` compiler option to be configured.");
+			if (!(tagImport && (0, _marko_compiler_babel_utils.loadFileForImport)(file, value))) throw importDecl.buildCodeFrameError("Unable to resolve marko file for load import.");
+			if ((node.importKind || "value") !== "value") throw importDecl.buildCodeFrameError("Invalid load import.");
+			for (const specifier of importDecl.get("specifiers")) if (!_marko_compiler.types.isImportDefaultSpecifier(specifier.node)) throw specifier.buildCodeFrameError("Invalid load import, only a default specifier is allowed.");
+		}
 	},
 	translate: { exit(importDecl) {
 		const { node } = importDecl;
 		const { extra } = node;
 		const tagImport = extra?.tagImport;
-		if (tagImport) node.source.value = tagImport;
+		const loadImport = extra?.loadImport;
+		if (tagImport) {
+			if (loadImport) {
+				const { local } = node.specifiers.find(_marko_compiler.types.isImportDefaultSpecifier);
+				const binding = importDecl.scope.getBinding(local.name);
+				if (isOutputHTML()) {
+					const { file } = importDecl.hub;
+					const loadFile = (0, _marko_compiler_babel_utils.loadFileForImport)(file, node.source.value);
+					const wrappedName = getOrCreateHtmlLoadWrapped(getReadyId(loadFile), _marko_compiler.types.identifier(local.name), loadFile.opts.filename, loadImport.render ? void 0 : loadImport.triggers);
+					for (const ref of binding.referencePaths) ref.replaceWith(_marko_compiler.types.identifier(wrappedName));
+					node.source.value = tagImport;
+					return;
+				} else if (binding.referencePaths.every((ref) => _marko_compiler.types.isMarkoTag(ref.parent) && ref.parent.extra?.tagNameLoad)) importDecl.remove();
+				else {
+					const { file } = importDecl.hub;
+					const loadFile = (0, _marko_compiler_babel_utils.loadFileForImport)(file, node.source.value);
+					const resolvedPath = (0, _marko_compiler_babel_utils.resolveRelativePath)(file, loadFile.opts.filename);
+					importDecl.replaceWith(_marko_compiler.types.variableDeclaration("const", [_marko_compiler.types.variableDeclarator(local, callRuntime("_load_template", _marko_compiler.types.stringLiteral(loadFile.metadata.marko.id), _marko_compiler.types.arrowFunctionExpression([], _marko_compiler.types.callExpression(_marko_compiler.types.memberExpression(_marko_compiler.types.callExpression(_marko_compiler.types.import(), [_marko_compiler.types.stringLiteral(resolvedPath)]), _marko_compiler.types.identifier("then")), [_marko_compiler.types.arrowFunctionExpression([_marko_compiler.types.identifier("mod")], toMemberExpression(_marko_compiler.types.identifier("mod"), "default"))]))))]));
+				}
+				return;
+			}
+			node.source.value = tagImport;
+		}
 	} }
 };
+function getOrCreateHtmlLoadWrapped(readyId, originalIdentifier, filename, triggers) {
+	const markoOpts = getMarkoOpts();
+	const loadWrapped = getHtmlLoadWrapped();
+	const existing = loadWrapped.get(readyId);
+	if (existing) return existing;
+	markoOpts.linkAssets?.onAsset("load", filename, readyId);
+	const wrappedName = generateUid(`${originalIdentifier.name ?? "tag"}_withLoadAssets`);
+	loadWrapped.set(readyId, wrappedName);
+	(0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.markoScriptlet([_marko_compiler.types.variableDeclaration("const", [_marko_compiler.types.variableDeclarator(_marko_compiler.types.identifier(wrappedName), callRuntime("withLoadAssets", originalIdentifier, _marko_compiler.types.stringLiteral(readyId), triggers ? _marko_compiler.types.valueToNode(triggers) : void 0))])], true));
+	return wrappedName;
+}
+function getLoadImportConfig(attrValue) {
+	const raw = attrValue.node.value;
+	if (raw === "render") return { render: true };
+	const triggers = [];
+	for (const match of raw.matchAll(triggerRegExp)) {
+		const type = parseTriggerType(match[1]);
+		const selector = match[2];
+		const query = match[3];
+		if (!type) throw attrValue.buildCodeFrameError(`Unknown trigger type "${match[1]}". Supported triggers are "visible", "idle", "media", and "on*".`);
+		if (type === "render") throw attrValue.buildCodeFrameError("The \"render\" trigger must be used alone.");
+		if (type === "idle") {
+			if (selector) throw attrValue.buildCodeFrameError(`Selector is not supported for the "idle" trigger.`);
+		} else if (!selector) throw attrValue.buildCodeFrameError(type === "media" ? `A media query is required for the "media" trigger. (e.g. "media(max-width:768px)")` : `A selector is required for the "${type}" trigger. (e.g. "${type}.my-element")`);
+		const trigger = selector ? {
+			type,
+			selector
+		} : { type };
+		if (query) {
+			const params = new URLSearchParams(query);
+			switch (type) {
+				case "visible": {
+					let rootMargin;
+					for (const [key, value] of params) {
+						if (key !== "rootMargin") throw attrValue.buildCodeFrameError(`Unknown param "${key}" for the "visible" trigger. Supported params: "rootMargin".`);
+						rootMargin = value;
+					}
+					if (rootMargin) trigger.options = { rootMargin };
+					break;
+				}
+				case "idle": {
+					let timeout;
+					for (const [key, value] of params) {
+						if (key !== "timeout") throw attrValue.buildCodeFrameError(`Unknown param "${key}" for the "idle" trigger. Supported params: "timeout".`);
+						timeout = Number(value);
+					}
+					if (timeout) trigger.options = { timeout };
+					break;
+				}
+				default: throw attrValue.buildCodeFrameError(`Params are not supported for the "${type}" trigger.`);
+			}
+		}
+		triggers.push(trigger);
+	}
+	if (!triggers.length) throw attrValue.buildCodeFrameError("The \"load\" attribute requires \"render\" or at least one trigger (e.g. \"visible.my-element\").");
+	return {
+		render: false,
+		triggers
+	};
+}
+function parseTriggerType(type) {
+	switch (type) {
+		case "idle":
+		case "media":
+		case "render":
+		case "visible": return type;
+		default: return isEventHandler(type) ? `on-${getEventHandlerName(type)}` : void 0;
+	}
+}
 //#endregion
 //#region src/translator/visitors/placeholder.ts
 const kNodeBinding = Symbol("placeholder node binding");
@@ -8085,17 +8272,24 @@ var attribute_tag_default = {
 };
 //#endregion
 //#region src/translator/visitors/tag/custom-tag.ts
+const kLoadTagBinding = Symbol("load tag binding");
+const [getLoadIdentifiers] = createProgramState(() => ({
+	triggers: /* @__PURE__ */ new Map(),
+	signals: /* @__PURE__ */ new Map()
+}));
 var custom_tag_default = {
 	analyze: { enter(tag) {
 		if (!(0, _marko_compiler_babel_utils.getTagTemplate)(tag)) throw tagNotFoundError(tag);
 		(0, _marko_compiler_babel_utils.assertAttributesOrSingleArg)(tag);
 		const childFile = (0, _marko_compiler_babel_utils.loadFileForTag)(tag);
 		if (!childFile) throw tag.get("name").buildCodeFrameError("Unable to resolve file for tag.");
+		const tagExtra = tag.node.extra ??= {};
 		const programExtra = (0, _marko_compiler_babel_utils.getProgram)().node.extra;
 		const programSection = programExtra.section;
 		const childExtra = childFile.ast.program.extra;
 		const childSection = childExtra.section;
 		if (childExtra.page) programExtra.page ??= true;
+		if (tagExtra.tagNameLoad) tagExtra[kLoadTagBinding] = createBinding("#text", 0, getOrCreateSection(tag));
 		knownTagAnalyze(tag, childSection, programSection === childSection ? programSection.params && getBindingPropTree(programSection.params) : childExtra.domExports?.params);
 	} },
 	translate: {
@@ -8124,11 +8318,46 @@ function translateDOM(tag) {
 	const write = writeTo(tag);
 	const relativePath = getTagRelativePath(tag);
 	const programSection = (0, _marko_compiler_babel_utils.getProgram)().node.extra.section;
-	const childExtra = (0, _marko_compiler_babel_utils.loadFileForTag)(tag).ast.program.extra;
+	const childFile = (0, _marko_compiler_babel_utils.loadFileForTag)(tag);
+	const childExtra = childFile.ast.program.extra;
 	const childExports = childExtra.domExports;
 	const childSection = childExtra.section;
+	const loadConfig = node.extra?.tagNameLoad;
+	const isLoad = !!loadConfig;
 	const tagName = _marko_compiler.types.isIdentifier(node.name) ? node.name.name : _marko_compiler.types.isStringLiteral(node.name) ? node.name.value : "tag";
-	if (programSection === childSection) {
+	if (isLoad) {
+		const childFileName = childFile.opts.filename;
+		const { triggers, signals } = getLoadIdentifiers();
+		let triggerIdent = triggers.get(loadConfig);
+		if (!triggerIdent) {
+			const triggerExpr = loadTriggersToExpression(loadConfig);
+			if (triggerExpr) {
+				triggerIdent = generateUidIdentifier(`load_${tagName}_trigger`);
+				triggers.set(loadConfig, triggerIdent);
+				(0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.variableDeclaration("const", [_marko_compiler.types.variableDeclarator(triggerIdent, triggerExpr)]));
+			}
+		}
+		knownTagTranslateDOM(tag, childExports.params, (binding) => {
+			const signalKey = `${triggerIdent ? triggerIdent.name : ""}\0${childFileName}\0${binding.export}`;
+			let signalIdent = signals.get(signalKey);
+			if (!signalIdent) {
+				signalIdent = generateUidIdentifier(`load_${tagName}_tag_${binding.name}`);
+				signals.set(signalKey, signalIdent);
+				const loadExpr = _marko_compiler.types.arrowFunctionExpression([], _marko_compiler.types.callExpression(_marko_compiler.types.import(), [_marko_compiler.types.stringLiteral(buildLoadSignalVirtualModule(file, childFileName, binding.export, binding.name))]));
+				(0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.variableDeclaration("let", [_marko_compiler.types.variableDeclarator(signalIdent, callRuntime("_load_signal", triggerIdent ? _marko_compiler.types.addComment(_marko_compiler.types.callExpression(triggerIdent, [loadExpr]), "leading", "@__PURE__") : loadExpr))]));
+			}
+			return signalIdent;
+		}, (section, childBinding) => {
+			const setupIdent = generateUidIdentifier(`load_${tagName}_setup`);
+			const setupLoadExpr = _marko_compiler.types.arrowFunctionExpression([], _marko_compiler.types.callExpression(_marko_compiler.types.import(), [_marko_compiler.types.stringLiteral(buildLoadSetupVirtualModule(file, childFileName, childExports))]));
+			(0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.variableDeclaration("let", [_marko_compiler.types.variableDeclarator(setupIdent, callRuntime("_load_setup", getScopeAccessorLiteral(node.extra[kLoadTagBinding], true), getScopeAccessorLiteral(childBinding, true), triggerIdent ? _marko_compiler.types.addComment(_marko_compiler.types.callExpression(triggerIdent, [setupLoadExpr]), "leading", "@__PURE__") : setupLoadExpr))]));
+			addStatement("render", section, void 0, _marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(setupIdent, [scopeIdentifier])));
+		});
+		write`<!>`;
+		visit(tag, 37);
+		injectWalks(tag, tagName);
+		enterShallow(tag);
+	} else if (programSection === childSection) {
 		knownTagTranslateDOM(tag, childExports.params, (binding, preferredName) => getSignal(programSection, binding, preferredName).identifier, (section, childBinding) => {
 			addStatement("render", section, void 0, _marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression(_marko_compiler.types.identifier(childExports.setup), [createScopeReadExpression(childBinding, section)])));
 		});
@@ -8171,6 +8400,35 @@ function isCircularRequest(file, request) {
 	const { filename } = file.opts;
 	return request === filename || request[0] === "." && path.default.resolve(filename, "..", request) === filename;
 }
+function buildLoadSetupVirtualModule(file, childFileName, childExports) {
+	const parts = `${childExports.template}, ${childExports.walks}, ${childExports.setup}`;
+	return getMarkoOpts().resolveVirtualDependency(file.opts.filename, {
+		virtualPath: `${(0, _marko_compiler_babel_utils.resolveRelativePath)(file, childFileName)}.setup.js`,
+		code: `import { ${parts} } from "./${path.default.basename(childFileName)}"\nexport const _ = [${parts}]`
+	});
+}
+function buildLoadSignalVirtualModule(file, childFileName, childExport, childBinding) {
+	return getMarkoOpts().resolveVirtualDependency(file.opts.filename, {
+		virtualPath: `${(0, _marko_compiler_babel_utils.resolveRelativePath)(file, childFileName)}.${childBinding}.js`,
+		code: `export { ${childExport} as _ } from "./${path.default.basename(childFileName)}"`
+	});
+}
+function loadTriggersToExpression(loadConfig) {
+	if (!loadConfig || loadConfig.render) return;
+	const triggers = loadConfig.triggers.map(toDOMTriggerExpression);
+	return triggers.length === 1 ? triggers[0] : callRuntime("_load_race_trigger", ...triggers);
+}
+function toDOMTriggerExpression(trigger) {
+	switch (trigger.type) {
+		case "visible": return callRuntime("_load_visible_trigger", _marko_compiler.types.stringLiteral(trigger.selector), optionalValueToNode(trigger.options));
+		case "idle": return callRuntime("_load_idle_trigger", optionalValueToNode(trigger.options));
+		case "media": return callRuntime("_load_media_trigger", _marko_compiler.types.stringLiteral(trigger.selector));
+		default: return callRuntime("_load_event_trigger", _marko_compiler.types.stringLiteral(trigger.type.slice(3)), _marko_compiler.types.stringLiteral(trigger.selector));
+	}
+}
+function optionalValueToNode(value) {
+	return value ? _marko_compiler.types.valueToNode(value) : void 0;
+}
 //#endregion
 //#region src/translator/visitors/tag/dynamic-tag.ts
 const kDOMBinding = Symbol("dynamic tag dom binding");
@@ -8242,7 +8500,7 @@ var dynamic_tag_default = {
 			let tagExpression = node.name;
 			if (_marko_compiler.types.isStringLiteral(tagExpression)) tagExpression = (0, _marko_compiler_babel_utils.importDefault)(tag.hub.file, getTagRelativePath(tag), tagExpression.value);
 			if (isClassAPI) if ((0, _marko_compiler_babel_utils.getTagTemplate)(tag)) {
-				if (getSerializeReason(tagSection, nodeBinding)) if (isOutputHTML()) (0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.markoScriptlet([_marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression((0, _marko_compiler_babel_utils.importNamed)(tag.hub.file, getCompatRuntimeFile(), "s"), [_marko_compiler.types.identifier(tagExpression.name), _marko_compiler.types.stringLiteral((0, _marko_compiler_babel_utils.loadFileForTag)(tag).metadata.marko.id)]))], true));
+				if (getSerializeReason(tagSection, nodeBinding)) if (isOutputHTML()) (0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.markoScriptlet([_marko_compiler.types.expressionStatement(_marko_compiler.types.callExpression((0, _marko_compiler_babel_utils.importNamed)(tag.hub.file, getCompatRuntimeFile(), "s"), [_marko_compiler.types.stringLiteral((0, _marko_compiler_babel_utils.loadFileForTag)(tag).metadata.marko.id), _marko_compiler.types.identifier(tagExpression.name)]))], true));
 				else (0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.expressionStatement(callRuntime("_resume", _marko_compiler.types.stringLiteral((0, _marko_compiler_babel_utils.loadFileForTag)(tag).metadata.marko.id), _marko_compiler.types.identifier(tagExpression.name))));
 			} else (0, _marko_compiler_babel_utils.getProgram)().node.body.push(_marko_compiler.types.markoScriptlet([_marko_compiler.types.expressionStatement(_marko_compiler.types.assignmentExpression("??=", _marko_compiler.types.memberExpression(_marko_compiler.types.identifier(tagExpression.name), _marko_compiler.types.identifier("_")), _marko_compiler.types.identifier(tagExpression.name)))], true));
 			const { properties, statements } = translateAttrs(tag, void 0, void 0, void 0, isClassAPI ? "renderBody" : "content");
@@ -8546,6 +8804,7 @@ function addFeature(state, type, name, path) {
 //#region src/translator/interop/index.ts
 function createInteropTranslator(translate5) {
 	return {
+		version: translate5.version ?? "0.0.0",
 		preferAPI: translate5.preferAPI,
 		transform: mergeVisitors(translate5.transform, transform),
 		analyze: mergeVisitors(translate5.analyze, analyze),
@@ -8606,7 +8865,8 @@ function createInteropTranslator(translate5) {
 			Program: {
 				enter(program, state) {
 					const entryFile = program.hub.file;
-					if (entryFile.markoOpts.output !== "hydrate") return enterProgram?.call(this, program, state);
+					const { output, entry } = entryFile.markoOpts;
+					if (!(output === "dom" && entry === "page" || output === "hydrate")) return enterProgram?.call(this, program, state);
 					const visitedFiles = new Set([(0, _marko_compiler_babel_utils.resolveRelativePath)(entryFile, entryFile.opts.filename)]);
 					entryBuilder.visit(entryFile, entryFile, function visitChild(resolved) {
 						if (!visitedFiles.has(resolved)) {
@@ -8747,3 +9007,9 @@ exports.tagDiscoveryDirs = tagDiscoveryDirs;
 exports.taglibs = taglibs;
 exports.transform = transform;
 exports.translate = translate;
+Object.defineProperty(exports, "version", {
+	enumerable: true,
+	get: function() {
+		return package_json.version;
+	}
+});