marko 6.1.3 → 6.1.4

package/dist/translator/index.d.ts

@@ -1,4 +1,5 @@
 import type { Config } from "@marko/compiler";
+export { version } from "../../package.json";
 export declare const tagDiscoveryDirs: string[];
 export { default as internalEntryBuilder } from "./util/entry-builder";
 export declare const preferAPI = "tags";

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"));
@@ -1368,6 +1377,7 @@ function analyzeExpressionTagName(name, extra) {
 				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",
@@ -2160,7 +2176,15 @@ const pureDOMFunctions = new Set([
 	"_for_until",
 	"_let",
 	"_let_change",
-	"_const"
+	"_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();
@@ -3880,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);
@@ -4289,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();
 			}
@@ -7875,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;
@@ -7882,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");
@@ -8103,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: {
@@ -8142,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)])));
 		});
@@ -8189,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");
@@ -8260,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");
@@ -8564,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),
@@ -8624,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)) {
@@ -8765,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;
+	}
+});

package/dist/translator/interop/index.d.ts

@@ -1,6 +1,7 @@
 import { type Config, types as t } from "@marko/compiler";
 type Taglibs = [taglibId: string, taglib: Record<string, unknown>][];
 export declare function createInteropTranslator(translate5: any): {
+    version: any;
     preferAPI: any;
     transform: Record<"Function" | "MarkoTag" | "AnyTypeAnnotation" | "ArgumentPlaceholder" | "ArrayExpression" | "ArrayPattern" | "ArrayTypeAnnotation" | "ArrowFunctionExpression" | "AssignmentExpression" | "AssignmentPattern" | "AwaitExpression" | "BigIntLiteral" | "BinaryExpression" | "BindExpression" | "BlockStatement" | "BooleanLiteral" | "BooleanLiteralTypeAnnotation" | "BooleanTypeAnnotation" | "BreakStatement" | "CallExpression" | "CatchClause" | "ClassAccessorProperty" | "ClassBody" | "ClassDeclaration" | "ClassExpression" | "ClassImplements" | "ClassMethod" | "ClassPrivateMethod" | "ClassPrivateProperty" | "ClassProperty" | "ConditionalExpression" | "ContinueStatement" | "DebuggerStatement" | "DecimalLiteral" | "DeclareClass" | "DeclareExportAllDeclaration" | "DeclareExportDeclaration" | "DeclareFunction" | "DeclareInterface" | "DeclareModule" | "DeclareModuleExports" | "DeclareOpaqueType" | "DeclareTypeAlias" | "DeclareVariable" | "DeclaredPredicate" | "Decorator" | "Directive" | "DirectiveLiteral" | "DoExpression" | "DoWhileStatement" | "EmptyStatement" | "EmptyTypeAnnotation" | "EnumBooleanBody" | "EnumBooleanMember" | "EnumDeclaration" | "EnumDefaultedMember" | "EnumNumberBody" | "EnumNumberMember" | "EnumStringBody" | "EnumStringMember" | "EnumSymbolBody" | "ExistsTypeAnnotation" | "ExportAllDeclaration" | "ExportDefaultDeclaration" | "ExportDefaultSpecifier" | "ExportNamedDeclaration" | "ExportNamespaceSpecifier" | "ExportSpecifier" | "ExpressionStatement" | "File" | "ForInStatement" | "ForOfStatement" | "ForStatement" | "FunctionDeclaration" | "FunctionExpression" | "FunctionTypeAnnotation" | "FunctionTypeParam" | "GenericTypeAnnotation" | "Identifier" | "IfStatement" | "Import" | "ImportAttribute" | "ImportDeclaration" | "ImportDefaultSpecifier" | "ImportExpression" | "ImportNamespaceSpecifier" | "ImportSpecifier" | "IndexedAccessType" | "InferredPredicate" | "InterfaceDeclaration" | "InterfaceExtends" | "InterfaceTypeAnnotation" | "InterpreterDirective" | "IntersectionTypeAnnotation" | "JSXAttribute" | "JSXClosingElement" | "JSXClosingFragment" | "JSXElement" | "JSXEmptyExpression" | "JSXExpressionContainer" | "JSXFragment" | "JSXIdentifier" | "JSXMemberExpression" | "JSXNamespacedName" | "JSXOpeningElement" | "JSXOpeningFragment" | "JSXSpreadAttribute" | "JSXSpreadChild" | "JSXText" | "LabeledStatement" | "LogicalExpression" | "MemberExpression" | "MetaProperty" | "MixedTypeAnnotation" | "ModuleExpression" | "NewExpression" | "Noop" | "NullLiteral" | "NullLiteralTypeAnnotation" | "NullableTypeAnnotation" | "NumberLiteral" | "NumberLiteralTypeAnnotation" | "NumberTypeAnnotation" | "NumericLiteral" | "ObjectExpression" | "ObjectMethod" | "ObjectPattern" | "ObjectProperty" | "ObjectTypeAnnotation" | "ObjectTypeCallProperty" | "ObjectTypeIndexer" | "ObjectTypeInternalSlot" | "ObjectTypeProperty" | "ObjectTypeSpreadProperty" | "OpaqueType" | "OptionalCallExpression" | "OptionalIndexedAccessType" | "OptionalMemberExpression" | "ParenthesizedExpression" | "PipelineBareFunction" | "PipelinePrimaryTopicReference" | "PipelineTopicExpression" | "Placeholder" | "PrivateName" | "Program" | "QualifiedTypeIdentifier" | "RecordExpression" | "RegExpLiteral" | "RegexLiteral" | "RestElement" | "RestProperty" | "ReturnStatement" | "SequenceExpression" | "SpreadElement" | "SpreadProperty" | "StaticBlock" | "StringLiteral" | "StringLiteralTypeAnnotation" | "StringTypeAnnotation" | "Super" | "SwitchCase" | "SwitchStatement" | "SymbolTypeAnnotation" | "TSAnyKeyword" | "TSArrayType" | "TSAsExpression" | "TSBigIntKeyword" | "TSBooleanKeyword" | "TSCallSignatureDeclaration" | "TSConditionalType" | "TSConstructSignatureDeclaration" | "TSConstructorType" | "TSDeclareFunction" | "TSDeclareMethod" | "TSEnumBody" | "TSEnumDeclaration" | "TSEnumMember" | "TSExportAssignment" | "TSExpressionWithTypeArguments" | "TSExternalModuleReference" | "TSFunctionType" | "TSImportEqualsDeclaration" | "TSImportType" | "TSIndexSignature" | "TSIndexedAccessType" | "TSInferType" | "TSInstantiationExpression" | "TSInterfaceBody" | "TSInterfaceDeclaration" | "TSIntersectionType" | "TSIntrinsicKeyword" | "TSLiteralType" | "TSMappedType" | "TSMethodSignature" | "TSModuleBlock" | "TSModuleDeclaration" | "TSNamedTupleMember" | "TSNamespaceExportDeclaration" | "TSNeverKeyword" | "TSNonNullExpression" | "TSNullKeyword" | "TSNumberKeyword" | "TSObjectKeyword" | "TSOptionalType" | "TSParameterProperty" | "TSParenthesizedType" | "TSPropertySignature" | "TSQualifiedName" | "TSRestType" | "TSSatisfiesExpression" | "TSStringKeyword" | "TSSymbolKeyword" | "TSTemplateLiteralType" | "TSThisType" | "TSTupleType" | "TSTypeAliasDeclaration" | "TSTypeAnnotation" | "TSTypeAssertion" | "TSTypeLiteral" | "TSTypeOperator" | "TSTypeParameter" | "TSTypeParameterDeclaration" | "TSTypeParameterInstantiation" | "TSTypePredicate" | "TSTypeQuery" | "TSTypeReference" | "TSUndefinedKeyword" | "TSUnionType" | "TSUnknownKeyword" | "TSVoidKeyword" | "TaggedTemplateExpression" | "TemplateElement" | "TemplateLiteral" | "ThisExpression" | "ThisTypeAnnotation" | "ThrowStatement" | "TopicReference" | "TryStatement" | "TupleExpression" | "TupleTypeAnnotation" | "TypeAlias" | "TypeAnnotation" | "TypeCastExpression" | "TypeParameter" | "TypeParameterDeclaration" | "TypeParameterInstantiation" | "TypeofTypeAnnotation" | "UnaryExpression" | "UnionTypeAnnotation" | "UpdateExpression" | "V8IntrinsicIdentifier" | "VariableDeclaration" | "VariableDeclarator" | "Variance" | "VoidPattern" | "VoidTypeAnnotation" | "WhileStatement" | "WithStatement" | "YieldExpression" | "MarkoParseError" | "MarkoDocumentType" | "MarkoDeclaration" | "MarkoCDATA" | "MarkoComment" | "MarkoText" | "MarkoPlaceholder" | "MarkoScriptlet" | "MarkoClass" | "MarkoAttribute" | "MarkoSpreadAttribute" | "MarkoTagBody" | "Standardized" | "Expression" | "Binary" | "Scopable" | "BlockParent" | "Block" | "Statement" | "Terminatorless" | "CompletionStatement" | "Conditional" | "Loop" | "While" | "ExpressionWrapper" | "For" | "ForXStatement" | "FunctionParent" | "Pureish" | "Declaration" | "FunctionParameter" | "PatternLike" | "LVal" | "TSEntityName" | "Literal" | "Immutable" | "UserWhitespacable" | "Method" | "ObjectMember" | "Property" | "UnaryLike" | "Pattern" | "Class" | "ImportOrExportDeclaration" | "ExportDeclaration" | "ModuleSpecifier" | "Accessor" | "Private" | "Flow" | "FlowType" | "FlowBaseAnnotation" | "FlowDeclaration" | "FlowPredicate" | "EnumBody" | "EnumMember" | "JSX" | "Miscellaneous" | "TypeScript" | "TSTypeElement" | "TSType" | "TSBaseType" | "ModuleDeclaration" | "Marko" | "Scope" | "BindingIdentifier" | "BlockScoped" | "ExistentialTypeParam" | "ForAwaitStatement" | "Generated" | "NumericLiteralTypeAnnotation" | "Pure" | "Referenced" | "ReferencedIdentifier" | "ReferencedMemberExpression" | "User" | "Var" | "enter" | "exit" | `${string}|${string}`, t.VisitNode<unknown, t.Node> | undefined>;
     analyze: Record<"Function" | "MarkoTag" | "AnyTypeAnnotation" | "ArgumentPlaceholder" | "ArrayExpression" | "ArrayPattern" | "ArrayTypeAnnotation" | "ArrowFunctionExpression" | "AssignmentExpression" | "AssignmentPattern" | "AwaitExpression" | "BigIntLiteral" | "BinaryExpression" | "BindExpression" | "BlockStatement" | "BooleanLiteral" | "BooleanLiteralTypeAnnotation" | "BooleanTypeAnnotation" | "BreakStatement" | "CallExpression" | "CatchClause" | "ClassAccessorProperty" | "ClassBody" | "ClassDeclaration" | "ClassExpression" | "ClassImplements" | "ClassMethod" | "ClassPrivateMethod" | "ClassPrivateProperty" | "ClassProperty" | "ConditionalExpression" | "ContinueStatement" | "DebuggerStatement" | "DecimalLiteral" | "DeclareClass" | "DeclareExportAllDeclaration" | "DeclareExportDeclaration" | "DeclareFunction" | "DeclareInterface" | "DeclareModule" | "DeclareModuleExports" | "DeclareOpaqueType" | "DeclareTypeAlias" | "DeclareVariable" | "DeclaredPredicate" | "Decorator" | "Directive" | "DirectiveLiteral" | "DoExpression" | "DoWhileStatement" | "EmptyStatement" | "EmptyTypeAnnotation" | "EnumBooleanBody" | "EnumBooleanMember" | "EnumDeclaration" | "EnumDefaultedMember" | "EnumNumberBody" | "EnumNumberMember" | "EnumStringBody" | "EnumStringMember" | "EnumSymbolBody" | "ExistsTypeAnnotation" | "ExportAllDeclaration" | "ExportDefaultDeclaration" | "ExportDefaultSpecifier" | "ExportNamedDeclaration" | "ExportNamespaceSpecifier" | "ExportSpecifier" | "ExpressionStatement" | "File" | "ForInStatement" | "ForOfStatement" | "ForStatement" | "FunctionDeclaration" | "FunctionExpression" | "FunctionTypeAnnotation" | "FunctionTypeParam" | "GenericTypeAnnotation" | "Identifier" | "IfStatement" | "Import" | "ImportAttribute" | "ImportDeclaration" | "ImportDefaultSpecifier" | "ImportExpression" | "ImportNamespaceSpecifier" | "ImportSpecifier" | "IndexedAccessType" | "InferredPredicate" | "InterfaceDeclaration" | "InterfaceExtends" | "InterfaceTypeAnnotation" | "InterpreterDirective" | "IntersectionTypeAnnotation" | "JSXAttribute" | "JSXClosingElement" | "JSXClosingFragment" | "JSXElement" | "JSXEmptyExpression" | "JSXExpressionContainer" | "JSXFragment" | "JSXIdentifier" | "JSXMemberExpression" | "JSXNamespacedName" | "JSXOpeningElement" | "JSXOpeningFragment" | "JSXSpreadAttribute" | "JSXSpreadChild" | "JSXText" | "LabeledStatement" | "LogicalExpression" | "MemberExpression" | "MetaProperty" | "MixedTypeAnnotation" | "ModuleExpression" | "NewExpression" | "Noop" | "NullLiteral" | "NullLiteralTypeAnnotation" | "NullableTypeAnnotation" | "NumberLiteral" | "NumberLiteralTypeAnnotation" | "NumberTypeAnnotation" | "NumericLiteral" | "ObjectExpression" | "ObjectMethod" | "ObjectPattern" | "ObjectProperty" | "ObjectTypeAnnotation" | "ObjectTypeCallProperty" | "ObjectTypeIndexer" | "ObjectTypeInternalSlot" | "ObjectTypeProperty" | "ObjectTypeSpreadProperty" | "OpaqueType" | "OptionalCallExpression" | "OptionalIndexedAccessType" | "OptionalMemberExpression" | "ParenthesizedExpression" | "PipelineBareFunction" | "PipelinePrimaryTopicReference" | "PipelineTopicExpression" | "Placeholder" | "PrivateName" | "Program" | "QualifiedTypeIdentifier" | "RecordExpression" | "RegExpLiteral" | "RegexLiteral" | "RestElement" | "RestProperty" | "ReturnStatement" | "SequenceExpression" | "SpreadElement" | "SpreadProperty" | "StaticBlock" | "StringLiteral" | "StringLiteralTypeAnnotation" | "StringTypeAnnotation" | "Super" | "SwitchCase" | "SwitchStatement" | "SymbolTypeAnnotation" | "TSAnyKeyword" | "TSArrayType" | "TSAsExpression" | "TSBigIntKeyword" | "TSBooleanKeyword" | "TSCallSignatureDeclaration" | "TSConditionalType" | "TSConstructSignatureDeclaration" | "TSConstructorType" | "TSDeclareFunction" | "TSDeclareMethod" | "TSEnumBody" | "TSEnumDeclaration" | "TSEnumMember" | "TSExportAssignment" | "TSExpressionWithTypeArguments" | "TSExternalModuleReference" | "TSFunctionType" | "TSImportEqualsDeclaration" | "TSImportType" | "TSIndexSignature" | "TSIndexedAccessType" | "TSInferType" | "TSInstantiationExpression" | "TSInterfaceBody" | "TSInterfaceDeclaration" | "TSIntersectionType" | "TSIntrinsicKeyword" | "TSLiteralType" | "TSMappedType" | "TSMethodSignature" | "TSModuleBlock" | "TSModuleDeclaration" | "TSNamedTupleMember" | "TSNamespaceExportDeclaration" | "TSNeverKeyword" | "TSNonNullExpression" | "TSNullKeyword" | "TSNumberKeyword" | "TSObjectKeyword" | "TSOptionalType" | "TSParameterProperty" | "TSParenthesizedType" | "TSPropertySignature" | "TSQualifiedName" | "TSRestType" | "TSSatisfiesExpression" | "TSStringKeyword" | "TSSymbolKeyword" | "TSTemplateLiteralType" | "TSThisType" | "TSTupleType" | "TSTypeAliasDeclaration" | "TSTypeAnnotation" | "TSTypeAssertion" | "TSTypeLiteral" | "TSTypeOperator" | "TSTypeParameter" | "TSTypeParameterDeclaration" | "TSTypeParameterInstantiation" | "TSTypePredicate" | "TSTypeQuery" | "TSTypeReference" | "TSUndefinedKeyword" | "TSUnionType" | "TSUnknownKeyword" | "TSVoidKeyword" | "TaggedTemplateExpression" | "TemplateElement" | "TemplateLiteral" | "ThisExpression" | "ThisTypeAnnotation" | "ThrowStatement" | "TopicReference" | "TryStatement" | "TupleExpression" | "TupleTypeAnnotation" | "TypeAlias" | "TypeAnnotation" | "TypeCastExpression" | "TypeParameter" | "TypeParameterDeclaration" | "TypeParameterInstantiation" | "TypeofTypeAnnotation" | "UnaryExpression" | "UnionTypeAnnotation" | "UpdateExpression" | "V8IntrinsicIdentifier" | "VariableDeclaration" | "VariableDeclarator" | "Variance" | "VoidPattern" | "VoidTypeAnnotation" | "WhileStatement" | "WithStatement" | "YieldExpression" | "MarkoParseError" | "MarkoDocumentType" | "MarkoDeclaration" | "MarkoCDATA" | "MarkoComment" | "MarkoText" | "MarkoPlaceholder" | "MarkoScriptlet" | "MarkoClass" | "MarkoAttribute" | "MarkoSpreadAttribute" | "MarkoTagBody" | "Standardized" | "Expression" | "Binary" | "Scopable" | "BlockParent" | "Block" | "Statement" | "Terminatorless" | "CompletionStatement" | "Conditional" | "Loop" | "While" | "ExpressionWrapper" | "For" | "ForXStatement" | "FunctionParent" | "Pureish" | "Declaration" | "FunctionParameter" | "PatternLike" | "LVal" | "TSEntityName" | "Literal" | "Immutable" | "UserWhitespacable" | "Method" | "ObjectMember" | "Property" | "UnaryLike" | "Pattern" | "Class" | "ImportOrExportDeclaration" | "ExportDeclaration" | "ModuleSpecifier" | "Accessor" | "Private" | "Flow" | "FlowType" | "FlowBaseAnnotation" | "FlowDeclaration" | "FlowPredicate" | "EnumBody" | "EnumMember" | "JSX" | "Miscellaneous" | "TypeScript" | "TSTypeElement" | "TSType" | "TSBaseType" | "ModuleDeclaration" | "Marko" | "Scope" | "BindingIdentifier" | "BlockScoped" | "ExistentialTypeParam" | "ForAwaitStatement" | "Generated" | "NumericLiteralTypeAnnotation" | "Pure" | "Referenced" | "ReferencedIdentifier" | "ReferencedMemberExpression" | "User" | "Var" | "enter" | "exit" | `${string}|${string}`, t.VisitNode<unknown, t.Node> | undefined>;

package/dist/translator/util/marko-config.d.ts

@@ -1,4 +1,6 @@
+import { types as t } from "@marko/compiler";
 export declare function isOutputHTML(): boolean;
 export declare function isOutputDOM(): boolean;
 export declare function getMarkoOpts(): Required<import("@marko/compiler").Config>;
 export declare function isOptimize(): boolean;
+export declare function getReadyId(file?: t.BabelFile): string | undefined;

package/dist/translator/util/runtime.d.ts

@@ -15,4 +15,5 @@ export declare function getHTMLRuntime(): {
     _escape_script: typeof _escape_script;
     _escape_style: typeof _escape_style;
 };
+export declare function getRuntimePath(output: string): string;
 export declare function getCompatRuntimeFile(): string;

package/dist/translator/util/tag-name-type.d.ts

@@ -1,4 +1,5 @@
 import { types as t } from "@marko/compiler";
+import type { LoadImportConfig } from "../visitors/import-declaration";
 declare module "@marko/compiler/dist/types" {
     interface ProgramExtra {
         featureType?: "class" | "tags";
@@ -8,6 +9,7 @@ declare module "@marko/compiler/dist/types" {
         tagNameNullable?: boolean;
         tagNameDynamic?: boolean;
         tagNameImported?: string;
+        tagNameLoad?: LoadImportConfig;
         featureType?: ProgramExtra["featureType"];
     }
 }

package/dist/translator/util/walks.d.ts

@@ -10,7 +10,7 @@ type VisitCodes = WalkCode.Get | WalkCode.Inside | WalkCode.Replace | WalkCode.D
 export declare function enter(path: t.NodePath<any>): void;
 export declare function exit(path: t.NodePath<any>): void;
 export declare function enterShallow(path: t.NodePath<any>): void;
-export declare function injectWalks(tag: t.NodePath<t.MarkoTag>, name: string, expr: Walk): void;
+export declare function injectWalks(tag: t.NodePath<t.MarkoTag>, name: string, expr?: Walk): void;
 export declare function visit(path: t.NodePath<t.MarkoTag | t.MarkoPlaceholder | t.Program>, code: VisitCodes): void;
 export declare function getWalkString(section: Section): t.Expression | undefined;
 export {};

package/dist/translator/visitors/import-declaration.d.ts

@@ -1,9 +1,18 @@
-import type { types as t } from "@marko/compiler";
+import { types as t } from "@marko/compiler";
+import type { LoadTrigger } from "../../html/assets";
 declare module "@marko/compiler/dist/types" {
     interface NodeExtra {
         tagImport?: string;
+        loadImport?: LoadImportConfig;
     }
 }
+export type LoadImportConfig = {
+    render: true;
+    triggers?: never;
+} | {
+    render: false;
+    triggers: LoadTrigger[];
+};
 declare const _default: {
     analyze(this: unknown, importDecl: t.NodePath<t.ImportDeclaration>): void;
     translate: {

package/dist/translator/visitors/tag/custom-tag.d.ts

@@ -1,4 +1,11 @@
 import { types as t } from "@marko/compiler";
+import type { Binding } from "../../util/references";
+declare const kLoadTagBinding: unique symbol;
+declare module "@marko/compiler/dist/types" {
+    interface MarkoTagExtra {
+        [kLoadTagBinding]?: Binding;
+    }
+}
 declare const _default: {
     analyze: {
         enter(this: unknown, tag: t.NodePath<t.MarkoTag>): void;