@weapp-vite/web 1.3.37 → 1.4.1

package/dist/runtime/polyfill/routeRuntime/appLifecycle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLifecycle.mjs","names":["#appInstance","#visibilityDocument","#unbindVisibility","#visibilityHandler","#syncVisibility","#launched","#launchOptions","#lastEnterOptions","#foreground"],"sources":["../../../../src/runtime/polyfill/routeRuntime/appLifecycle.ts"],"sourcesContent":["import type { AppLaunchOptions, AppRuntime, PageStackEntry } from './options'\nimport { cloneLaunchOptions, resolveFallbackLaunchOptions } from '../appState'\nimport { isRecord } from './options'\n\ntype VisibilityDocument = Pick<Document, 'addEventListener' | 'hidden' | 'removeEventListener' | 'visibilityState'>\n\nfunction resolveEntryOptions(entry: Pick<PageStackEntry, 'id' | 'query'> | undefined): AppLaunchOptions {\n  return resolveFallbackLaunchOptions(entry ? [entry] : [])\n}\n\nfunction isDocumentHidden(target: VisibilityDocument) {\n  return target.visibilityState === 'hidden' || target.hidden === true\n}\n\nexport class AppLifecycleRuntime {\n  #appInstance: AppRuntime | undefined\n  #foreground = false\n  #lastEnterOptions: AppLaunchOptions | undefined\n  #launchOptions: AppLaunchOptions | undefined\n  #launched = false\n  #visibilityDocument: VisibilityDocument | undefined\n  #visibilityHandler: (() => void) | undefined\n\n  constructor(private readonly resolveCurrentEntry: () => PageStackEntry | undefined) {}\n\n  register<T extends AppRuntime | undefined>(options: T): T {\n    const resolved = (options ?? {}) as AppRuntime\n    if (this.#appInstance) {\n      const currentGlobal = this.#appInstance.globalData\n      Object.assign(this.#appInstance, resolved)\n      if (isRecord(currentGlobal)) {\n        this.#appInstance.globalData = currentGlobal\n      }\n      else if (!isRecord(this.#appInstance.globalData)) {\n        this.#appInstance.globalData = {}\n      }\n      return options\n    }\n    this.#appInstance = resolved\n    if (!isRecord(this.#appInstance.globalData)) {\n      this.#appInstance.globalData = {}\n    }\n    return options\n  }\n\n  bindVisibility(target: VisibilityDocument | undefined = typeof document === 'undefined' ? undefined : document) {\n    if (!target || this.#visibilityDocument === target || typeof target.addEventListener !== 'function') {\n      return\n    }\n    this.#unbindVisibility()\n    this.#visibilityDocument = target\n    this.#visibilityHandler = () => this.#syncVisibility(target)\n    target.addEventListener('visibilitychange', this.#visibilityHandler)\n  }\n\n  ensureLaunched(entry: PageStackEntry) {\n    if (!this.#appInstance || this.#launched) {\n      return\n    }\n    const options = resolveEntryOptions(entry)\n    this.#launchOptions = cloneLaunchOptions(options)\n    this.#lastEnterOptions = cloneLaunchOptions(options)\n    this.#foreground = true\n    this.#launched = true\n    this.#appInstance.onLaunch?.(cloneLaunchOptions(options))\n    this.#appInstance.onShow?.(cloneLaunchOptions(options))\n  }\n\n  get instance() {\n    return this.#appInstance\n  }\n\n  getLaunchOptions() {\n    return this.#launchOptions\n      ? cloneLaunchOptions(this.#launchOptions)\n      : resolveEntryOptions(this.resolveCurrentEntry())\n  }\n\n  getEnterOptions() {\n    return this.#lastEnterOptions\n      ? cloneLaunchOptions(this.#lastEnterOptions)\n      : this.getLaunchOptions()\n  }\n\n  dispose() {\n    this.#unbindVisibility()\n  }\n\n  #syncVisibility(target: VisibilityDocument) {\n    if (!this.#appInstance || !this.#launched) {\n      return\n    }\n    if (isDocumentHidden(target)) {\n      if (!this.#foreground) {\n        return\n      }\n      this.#appInstance.onHide?.()\n      this.#foreground = false\n      return\n    }\n    if (this.#foreground) {\n      return\n    }\n    const options = resolveEntryOptions(this.resolveCurrentEntry())\n    this.#lastEnterOptions = cloneLaunchOptions(options)\n    this.#appInstance.onShow?.(cloneLaunchOptions(options))\n    this.#foreground = true\n  }\n\n  #unbindVisibility() {\n    if (this.#visibilityDocument && this.#visibilityHandler) {\n      this.#visibilityDocument.removeEventListener('visibilitychange', this.#visibilityHandler)\n    }\n    this.#visibilityDocument = undefined\n    this.#visibilityHandler = undefined\n  }\n}\n"],"mappings":";;;;AAMA,SAAS,oBAAoB,OAA2E;CACtG,OAAO,6BAA6B,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;AAC1D;AAEA,SAAS,iBAAiB,QAA4B;CACpD,OAAO,OAAO,oBAAoB,YAAY,OAAO,WAAW;AAClE;AAEA,IAAa,sBAAb,MAAiC;CASF;CAR7B;CACA,cAAc;CACd;CACA;CACA,YAAY;CACZ;CACA;CAEA,YAAY,AAAiB,qBAAuD;EAAvD;CAAwD;CAErF,SAA2C,SAAe;EACxD,MAAM,WAAY,WAAW,CAAC;EAC9B,IAAI,KAAKA,cAAc;GACrB,MAAM,gBAAgB,KAAKA,aAAa;GACxC,OAAO,OAAO,KAAKA,cAAc,QAAQ;GACzC,IAAI,SAAS,aAAa,GACxB,KAAKA,aAAa,aAAa;QAE5B,IAAI,CAAC,SAAS,KAAKA,aAAa,UAAU,GAC7C,KAAKA,aAAa,aAAa,CAAC;GAElC,OAAO;EACT;EACA,KAAKA,eAAe;EACpB,IAAI,CAAC,SAAS,KAAKA,aAAa,UAAU,GACxC,KAAKA,aAAa,aAAa,CAAC;EAElC,OAAO;CACT;CAEA,eAAe,SAAyC,OAAO,aAAa,cAAc,SAAY,UAAU;EAC9G,IAAI,CAAC,UAAU,KAAKC,wBAAwB,UAAU,OAAO,OAAO,qBAAqB,YACvF;EAEF,KAAKC,kBAAkB;EACvB,KAAKD,sBAAsB;EAC3B,KAAKE,2BAA2B,KAAKC,gBAAgB,MAAM;EAC3D,OAAO,iBAAiB,oBAAoB,KAAKD,kBAAkB;CACrE;CAEA,eAAe,OAAuB;EACpC,IAAI,CAAC,KAAKH,gBAAgB,KAAKK,WAC7B;EAEF,MAAM,UAAU,oBAAoB,KAAK;EACzC,KAAKC,iBAAiB,mBAAmB,OAAO;EAChD,KAAKC,oBAAoB,mBAAmB,OAAO;EACnD,KAAKC,cAAc;EACnB,KAAKH,YAAY;EACjB,KAAKL,aAAa,WAAW,mBAAmB,OAAO,CAAC;EACxD,KAAKA,aAAa,SAAS,mBAAmB,OAAO,CAAC;CACxD;CAEA,IAAI,WAAW;EACb,OAAO,KAAKA;CACd;CAEA,mBAAmB;EACjB,OAAO,KAAKM,iBACR,mBAAmB,KAAKA,cAAc,IACtC,oBAAoB,KAAK,oBAAoB,CAAC;CACpD;CAEA,kBAAkB;EAChB,OAAO,KAAKC,oBACR,mBAAmB,KAAKA,iBAAiB,IACzC,KAAK,iBAAiB;CAC5B;CAEA,UAAU;EACR,KAAKL,kBAAkB;CACzB;CAEA,gBAAgB,QAA4B;EAC1C,IAAI,CAAC,KAAKF,gBAAgB,CAAC,KAAKK,WAC9B;EAEF,IAAI,iBAAiB,MAAM,GAAG;GAC5B,IAAI,CAAC,KAAKG,aACR;GAEF,KAAKR,aAAa,SAAS;GAC3B,KAAKQ,cAAc;GACnB;EACF;EACA,IAAI,KAAKA,aACP;EAEF,MAAM,UAAU,oBAAoB,KAAK,oBAAoB,CAAC;EAC9D,KAAKD,oBAAoB,mBAAmB,OAAO;EACnD,KAAKP,aAAa,SAAS,mBAAmB,OAAO,CAAC;EACtD,KAAKQ,cAAc;CACrB;CAEA,oBAAoB;EAClB,IAAI,KAAKP,uBAAuB,KAAKE,oBACnC,KAAKF,oBAAoB,oBAAoB,oBAAoB,KAAKE,kBAAkB;EAE1F,KAAKF,sBAAsB;EAC3B,KAAKE,qBAAqB;CAC5B;AACF"}

package/dist/runtime/polyfill/routeRuntime/dom.mjs

@@ -1,36 +1,65 @@
+import { ensureAppContainer, onDocumentReady } from "../../appShell/container.mjs";
 import { attachRouteMeta } from "./lifecycle.mjs";
+import { bindPageScrollOwner, getPageContainer, restoreEntryScrollPosition, setEntryScrollOwner } from "./scroll.mjs";
 
 //#region src/runtime/polyfill/routeRuntime/dom.ts
-function ensureDocumentReady(callback) {
-	if (typeof document === "undefined") return;
-	if (document.readyState === "loading") {
-		document.addEventListener("DOMContentLoaded", () => callback(), { once: true });
+function applyEntryVisibility(entry) {
+	const element = entry.element;
+	if (!element) return;
+	const styleWithoutDisplay = (element.getAttribute("style") ?? "").replace(/(?:^|;)\s*display\s*:[^;]*/gi, "").replace(/^;|;$/g, "");
+	const setDisplay = (display) => {
+		element.setAttribute("style", `${styleWithoutDisplay}${styleWithoutDisplay ? ";" : ""}display:${display};`);
+	};
+	element.setAttribute("data-weapp-page-active", entry.active ? "true" : "false");
+	setEntryScrollOwner(entry, entry.active);
+	if (entry.active) {
+		setDisplay("block");
+		element.removeAttribute("hidden");
+		element.removeAttribute("aria-hidden");
 		return;
 	}
-	callback();
+	setDisplay("none");
+	element.setAttribute("hidden", "");
+	element.setAttribute("aria-hidden", "true");
 }
-function ensureContainer() {
-	if (typeof document === "undefined") return;
-	return document.querySelector("#app") ?? document.body;
+function setEntryActiveInDom(entry, active) {
+	entry.active = active;
+	applyEntryVisibility(entry);
 }
-function mountEntryToDom(entry, pageRegistry, onMounted) {
+function unmountEntryFromDom(entry) {
+	setEntryScrollOwner(entry, false);
+	const element = entry.element;
+	if (!element) {
+		entry.instance = void 0;
+		return;
+	}
+	if (element.parentNode) element.parentNode.removeChild(element);
+	entry.element = void 0;
+	entry.instance = void 0;
+}
+function mountEntryToDom(entry, pageRegistry, onBeforeMount) {
 	const record = pageRegistry.get(entry.id);
-	if (!record) return;
-	ensureDocumentReady(() => {
-		const container = ensureContainer();
+	if (!record || entry.element) return;
+	onDocumentReady(() => {
+		const container = ensureAppContainer();
 		if (!container) return;
-		while (container.childNodes.length) container.removeChild(container.childNodes[0]);
+		bindPageScrollOwner(container);
+		onBeforeMount(entry);
 		const element = document.createElement(record.tag);
+		element.setAttribute("data-weapp-page", entry.id);
+		element.setAttribute("style", "display:block;min-height:100%;box-sizing:border-box;padding-bottom:var(--weapp-tab-bar-inset, 0px);padding-top:var(--weapp-tab-bar-top-inset, 0px);");
+		entry.element = element;
+		applyEntryVisibility(entry);
 		attachRouteMeta(element, {
 			id: entry.id,
 			query: entry.query,
 			entry
 		});
 		container.append(element);
-		onMounted(entry);
+		if (entry.active) restoreEntryScrollPosition(entry);
 	});
 }
 
 //#endregion
-export { mountEntryToDom };
+export { mountEntryToDom, setEntryActiveInDom, unmountEntryFromDom };
 //# sourceMappingURL=dom.mjs.map

package/dist/runtime/polyfill/routeRuntime/dom.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dom.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/dom.ts"],"sourcesContent":["import type { ComponentPublicInstance } from '../../component'\nimport type { PageRecord, PageStackEntry } from './options'\nimport { attachRouteMeta } from './lifecycle'\n\nfunction ensureDocumentReady(callback: () => void) {\n  if (typeof document === 'undefined') {\n    return\n  }\n  if (document.readyState === 'loading') {\n    document.addEventListener('DOMContentLoaded', () => callback(), { once: true })\n    return\n  }\n  callback()\n}\n\nfunction ensureContainer(): HTMLElement | undefined {\n  if (typeof document === 'undefined') {\n    return undefined\n  }\n  return (document.querySelector('#app') as HTMLElement | null) ?? document.body\n}\n\nexport function mountEntryToDom(\n  entry: PageStackEntry,\n  pageRegistry: Map<string, PageRecord>,\n  onMounted: (entry: PageStackEntry) => void,\n) {\n  const record = pageRegistry.get(entry.id)\n  if (!record) {\n    return\n  }\n  ensureDocumentReady(() => {\n    const container = ensureContainer()\n    if (!container) {\n      return\n    }\n    while (container.childNodes.length) {\n      container.removeChild(container.childNodes[0]!)\n    }\n    const element = document.createElement(record.tag) as HTMLElement & ComponentPublicInstance\n    attachRouteMeta(element, {\n      id: entry.id,\n      query: entry.query,\n      entry,\n    })\n    container.append(element)\n    onMounted(entry)\n  })\n}\n"],"mappings":";;;AAIA,SAAS,oBAAoB,UAAsB;CACjD,IAAI,OAAO,aAAa,aACtB;CAEF,IAAI,SAAS,eAAe,WAAW;EACrC,SAAS,iBAAiB,0BAA0B,SAAS,GAAG,EAAE,MAAM,KAAK,CAAC;EAC9E;CACF;CACA,SAAS;AACX;AAEA,SAAS,kBAA2C;CAClD,IAAI,OAAO,aAAa,aACtB;CAEF,OAAQ,SAAS,cAAc,MAAM,KAA4B,SAAS;AAC5E;AAEA,SAAgB,gBACd,OACA,cACA,WACA;CACA,MAAM,SAAS,aAAa,IAAI,MAAM,EAAE;CACxC,IAAI,CAAC,QACH;CAEF,0BAA0B;EACxB,MAAM,YAAY,gBAAgB;EAClC,IAAI,CAAC,WACH;EAEF,OAAO,UAAU,WAAW,QAC1B,UAAU,YAAY,UAAU,WAAW,EAAG;EAEhD,MAAM,UAAU,SAAS,cAAc,OAAO,GAAG;EACjD,gBAAgB,SAAS;GACvB,IAAI,MAAM;GACV,OAAO,MAAM;GACb;EACF,CAAC;EACD,UAAU,OAAO,OAAO;EACxB,UAAU,KAAK;CACjB,CAAC;AACH"}
+{"version":3,"file":"dom.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/dom.ts"],"sourcesContent":["import type { ComponentPublicInstance } from '../../component'\nimport type { PageRecord, PageStackEntry } from './options'\nimport { ensureAppContainer, onDocumentReady } from '../../appShell/container'\nimport { attachRouteMeta } from './lifecycle'\nimport {\n  bindPageScrollOwner,\n  restoreEntryScrollPosition,\n  setEntryScrollOwner,\n} from './scroll'\n\nfunction applyEntryVisibility(entry: PageStackEntry) {\n  const element = entry.element\n  if (!element) {\n    return\n  }\n  const currentStyle = element.getAttribute('style') ?? ''\n  const styleWithoutDisplay = currentStyle\n    .replace(/(?:^|;)\\s*display\\s*:[^;]*/gi, '')\n    .replace(/^;|;$/g, '')\n  const setDisplay = (display: 'block' | 'none') => {\n    element.setAttribute('style', `${styleWithoutDisplay}${styleWithoutDisplay ? ';' : ''}display:${display};`)\n  }\n  element.setAttribute('data-weapp-page-active', entry.active ? 'true' : 'false')\n  setEntryScrollOwner(entry, entry.active)\n  if (entry.active) {\n    setDisplay('block')\n    element.removeAttribute('hidden')\n    element.removeAttribute('aria-hidden')\n    return\n  }\n  // 自定义页面元素挂载时带有内联 display，必须同步清零才能真正隐藏。\n  setDisplay('none')\n  element.setAttribute('hidden', '')\n  element.setAttribute('aria-hidden', 'true')\n}\n\nexport function setEntryActiveInDom(entry: PageStackEntry, active: boolean) {\n  entry.active = active\n  applyEntryVisibility(entry)\n}\n\nexport function unmountEntryFromDom(entry: PageStackEntry) {\n  setEntryScrollOwner(entry, false)\n  const element = entry.element\n  if (!element) {\n    entry.instance = undefined\n    return\n  }\n  if (element.parentNode) {\n    element.parentNode.removeChild(element)\n  }\n  entry.element = undefined\n  entry.instance = undefined\n}\n\nexport function mountEntryToDom(\n  entry: PageStackEntry,\n  pageRegistry: Map<string, PageRecord>,\n  onBeforeMount: (entry: PageStackEntry) => void,\n) {\n  const record = pageRegistry.get(entry.id)\n  if (!record || entry.element) {\n    return\n  }\n  onDocumentReady(() => {\n    const container = ensureAppContainer()\n    if (!container) {\n      return\n    }\n    bindPageScrollOwner(container)\n    onBeforeMount(entry)\n    const element = document.createElement(record.tag) as HTMLElement & ComponentPublicInstance\n    element.setAttribute('data-weapp-page', entry.id)\n    element.setAttribute('style', 'display:block;min-height:100%;box-sizing:border-box;padding-bottom:var(--weapp-tab-bar-inset, 0px);padding-top:var(--weapp-tab-bar-top-inset, 0px);')\n    entry.element = element\n    applyEntryVisibility(entry)\n    attachRouteMeta(element, {\n      id: entry.id,\n      query: entry.query,\n      entry,\n    })\n    container.append(element)\n    if (entry.active) {\n      restoreEntryScrollPosition(entry)\n    }\n  })\n}\n\nexport { getPageContainer } from './scroll'\n"],"mappings":";;;;;AAUA,SAAS,qBAAqB,OAAuB;CACnD,MAAM,UAAU,MAAM;CACtB,IAAI,CAAC,SACH;CAGF,MAAM,uBADe,QAAQ,aAAa,OAAO,KAAK,GACd,CACrC,QAAQ,gCAAgC,EAAE,CAAC,CAC3C,QAAQ,UAAU,EAAE;CACvB,MAAM,cAAc,YAA8B;EAChD,QAAQ,aAAa,SAAS,GAAG,sBAAsB,sBAAsB,MAAM,GAAG,UAAU,QAAQ,EAAE;CAC5G;CACA,QAAQ,aAAa,0BAA0B,MAAM,SAAS,SAAS,OAAO;CAC9E,oBAAoB,OAAO,MAAM,MAAM;CACvC,IAAI,MAAM,QAAQ;EAChB,WAAW,OAAO;EAClB,QAAQ,gBAAgB,QAAQ;EAChC,QAAQ,gBAAgB,aAAa;EACrC;CACF;CAEA,WAAW,MAAM;CACjB,QAAQ,aAAa,UAAU,EAAE;CACjC,QAAQ,aAAa,eAAe,MAAM;AAC5C;AAEA,SAAgB,oBAAoB,OAAuB,QAAiB;CAC1E,MAAM,SAAS;CACf,qBAAqB,KAAK;AAC5B;AAEA,SAAgB,oBAAoB,OAAuB;CACzD,oBAAoB,OAAO,KAAK;CAChC,MAAM,UAAU,MAAM;CACtB,IAAI,CAAC,SAAS;EACZ,MAAM,WAAW;EACjB;CACF;CACA,IAAI,QAAQ,YACV,QAAQ,WAAW,YAAY,OAAO;CAExC,MAAM,UAAU;CAChB,MAAM,WAAW;AACnB;AAEA,SAAgB,gBACd,OACA,cACA,eACA;CACA,MAAM,SAAS,aAAa,IAAI,MAAM,EAAE;CACxC,IAAI,CAAC,UAAU,MAAM,SACnB;CAEF,sBAAsB;EACpB,MAAM,YAAY,mBAAmB;EACrC,IAAI,CAAC,WACH;EAEF,oBAAoB,SAAS;EAC7B,cAAc,KAAK;EACnB,MAAM,UAAU,SAAS,cAAc,OAAO,GAAG;EACjD,QAAQ,aAAa,mBAAmB,MAAM,EAAE;EAChD,QAAQ,aAAa,SAAS,qJAAqJ;EACnL,MAAM,UAAU;EAChB,qBAAqB,KAAK;EAC1B,gBAAgB,SAAS;GACvB,IAAI,MAAM;GACV,OAAO,MAAM;GACb;EACF,CAAC;EACD,UAAU,OAAO,OAAO;EACxB,IAAI,MAAM,QACR,2BAA2B,KAAK;CAEpC,CAAC;AACH"}

package/dist/runtime/polyfill/routeRuntime/history.d.mts

@@ -0,0 +1,30 @@
+import "./options.mjs";
+//#region src/runtime/polyfill/routeRuntime/history.d.ts
+type WebRoutingMode = 'memory' | 'history' | 'hash';
+interface WebRoutingConfig {
+  mode?: WebRoutingMode;
+  /** 部署目录前缀，例如 /mini-program。 */
+  base?: string;
+}
+interface ResolvedWebRoutingConfig {
+  mode: WebRoutingMode;
+  base: string;
+}
+interface WebRouteTarget {
+  id: string;
+  query: Record<string, string>;
+}
+interface WebRouteHistoryState {
+  __weappWebRuntime?: {
+    stack: WebRouteTarget[];
+  };
+}
+declare function resolveWebRoutingConfig(config?: WebRoutingConfig): ResolvedWebRoutingConfig;
+declare function disposeWebRouting(): void;
+declare function getWebRoutingConfig(): {
+  mode: WebRoutingMode;
+  base: string;
+};
+//#endregion
+export { ResolvedWebRoutingConfig, WebRouteHistoryState, WebRouteTarget, WebRoutingConfig, WebRoutingMode, disposeWebRouting, getWebRoutingConfig, resolveWebRoutingConfig };
+//# sourceMappingURL=history.d.mts.map

package/dist/runtime/polyfill/routeRuntime/history.mjs

@@ -0,0 +1,148 @@
+//#region src/runtime/polyfill/routeRuntime/history.ts
+const DEFAULT_CONFIG = {
+	mode: "memory",
+	base: "/"
+};
+let resolvedConfig = { ...DEFAULT_CONFIG };
+let knownPageIds = /* @__PURE__ */ new Set();
+let popstateHandler;
+let hashchangeHandler;
+let scrollRestorationHistory;
+let previousScrollRestoration;
+function normalizeBase(base) {
+	if (!base?.trim()) return "/";
+	return base.trim().replace(/\\/g, "/").replace(/^\/*/, "/").replace(/\/*$/, "") || "/";
+}
+function resolveWebRoutingConfig(config) {
+	return {
+		mode: config?.mode === "history" || config?.mode === "hash" ? config.mode : "memory",
+		base: normalizeBase(config?.base)
+	};
+}
+function isBrowserHistoryAvailable() {
+	return typeof window !== "undefined" && typeof window.history?.pushState === "function" && typeof window.history?.replaceState === "function";
+}
+function bindManualScrollRestoration() {
+	if (typeof window === "undefined" || !("scrollRestoration" in window.history)) return;
+	scrollRestorationHistory = window.history;
+	previousScrollRestoration = window.history.scrollRestoration;
+	window.history.scrollRestoration = "manual";
+}
+function restoreBrowserScrollRestoration() {
+	if (scrollRestorationHistory && previousScrollRestoration) scrollRestorationHistory.scrollRestoration = previousScrollRestoration;
+	scrollRestorationHistory = void 0;
+	previousScrollRestoration = void 0;
+}
+function normalizePath(path) {
+	return decodeURIComponent(path || "/").split("?")[0].replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.html$/, "");
+}
+function parseQuery(search) {
+	const query = {};
+	const params = new URLSearchParams(search.startsWith("?") ? search : `?${search}`);
+	for (const [key, value] of params.entries()) query[key] = value;
+	return query;
+}
+function toQueryString(query) {
+	const params = new URLSearchParams();
+	for (const [key, value] of Object.entries(query)) params.set(key, value);
+	const search = params.toString();
+	return search ? `?${search}` : "";
+}
+function resolvePageId(path) {
+	const normalized = normalizePath(path);
+	if (knownPageIds.has(normalized)) return normalized;
+	const indexId = `${normalized}/index`;
+	if (knownPageIds.has(indexId)) return indexId;
+}
+function resolveTargetFromUrl(url) {
+	if (resolvedConfig.mode === "hash") {
+		const [path, query = ""] = url.hash.replace(/^#\/?/, "").split("?");
+		const id = resolvePageId(path);
+		return id ? {
+			id,
+			query: parseQuery(query)
+		} : void 0;
+	}
+	const base = resolvedConfig.base === "/" ? "" : resolvedConfig.base;
+	const id = resolvePageId(!base || url.pathname === base || url.pathname.startsWith(`${base}/`) ? url.pathname.slice(base.length) : url.pathname);
+	return id ? {
+		id,
+		query: parseQuery(url.search)
+	} : void 0;
+}
+function readWebRouteTarget(pageIds, url) {
+	knownPageIds = new Set(pageIds);
+	if (resolvedConfig.mode === "memory" || typeof URL === "undefined") return;
+	const runtimeUrl = url ?? (typeof window !== "undefined" ? window.location.href : void 0);
+	if (!runtimeUrl) return;
+	try {
+		return resolveTargetFromUrl(new URL(runtimeUrl, "http://weapp-vite.local"));
+	} catch {
+		return;
+	}
+}
+function formatRouteUrl(target) {
+	const query = toQueryString(target.query);
+	const path = `${target.id}${query}`;
+	if (resolvedConfig.mode === "hash") return `${resolvedConfig.base === "/" ? "" : resolvedConfig.base}/#/${path}`;
+	return `${resolvedConfig.base === "/" ? "" : resolvedConfig.base}/${path}`;
+}
+function toHistoryState(entries) {
+	return { __weappWebRuntime: { stack: entries.map((entry) => ({
+		id: entry.id,
+		query: { ...entry.query }
+	})) } };
+}
+function disposeWebRouting() {
+	if (typeof window !== "undefined") {
+		if (popstateHandler) window.removeEventListener("popstate", popstateHandler);
+		if (hashchangeHandler) window.removeEventListener("hashchange", hashchangeHandler);
+	}
+	popstateHandler = void 0;
+	hashchangeHandler = void 0;
+	restoreBrowserScrollRestoration();
+	resolvedConfig = { ...DEFAULT_CONFIG };
+	knownPageIds = /* @__PURE__ */ new Set();
+}
+function configureWebRouting(config, pageIds, onPopState) {
+	disposeWebRouting();
+	resolvedConfig = resolveWebRoutingConfig(config);
+	knownPageIds = new Set(pageIds);
+	if (resolvedConfig.mode === "memory" || typeof window === "undefined") return resolvedConfig;
+	bindManualScrollRestoration();
+	popstateHandler = () => {
+		const state = window.history.state;
+		onPopState(readWebRouteTarget(pageIds), state);
+	};
+	window.addEventListener("popstate", popstateHandler);
+	if (resolvedConfig.mode === "hash") {
+		hashchangeHandler = () => {
+			const state = window.history.state;
+			onPopState(readWebRouteTarget(pageIds), state);
+		};
+		window.addEventListener("hashchange", hashchangeHandler);
+	}
+	return resolvedConfig;
+}
+function syncWebRouting(entries, operation) {
+	if (resolvedConfig.mode === "memory" || !isBrowserHistoryAvailable() || !entries.length) return;
+	const target = entries[entries.length - 1];
+	const url = formatRouteUrl({
+		id: target.id,
+		query: target.query
+	});
+	const state = toHistoryState(entries);
+	if (operation === "push") window.history.pushState(state, "", url);
+	else window.history.replaceState(state, "", url);
+}
+function getWebHistoryStack(state) {
+	const stack = state?.__weappWebRuntime?.stack;
+	return Array.isArray(stack) ? stack : void 0;
+}
+function getWebRoutingConfig() {
+	return { ...resolvedConfig };
+}
+
+//#endregion
+export { configureWebRouting, disposeWebRouting, getWebHistoryStack, getWebRoutingConfig, readWebRouteTarget, resolveWebRoutingConfig, syncWebRouting };
+//# sourceMappingURL=history.mjs.map

package/dist/runtime/polyfill/routeRuntime/history.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/history.ts"],"sourcesContent":["import type { PageStackEntry } from './options'\n\nexport type WebRoutingMode = 'memory' | 'history' | 'hash'\n\nexport interface WebRoutingConfig {\n  mode?: WebRoutingMode\n  /** 部署目录前缀，例如 /mini-program。 */\n  base?: string\n}\n\nexport interface ResolvedWebRoutingConfig {\n  mode: WebRoutingMode\n  base: string\n}\n\nexport interface WebRouteTarget {\n  id: string\n  query: Record<string, string>\n}\n\nexport interface WebRouteHistoryState {\n  __weappWebRuntime?: {\n    stack: WebRouteTarget[]\n  }\n}\n\nconst DEFAULT_CONFIG: ResolvedWebRoutingConfig = {\n  mode: 'memory',\n  base: '/',\n}\n\nlet resolvedConfig = { ...DEFAULT_CONFIG }\nlet knownPageIds = new Set<string>()\nlet popstateHandler: (() => void) | undefined\nlet hashchangeHandler: (() => void) | undefined\nlet scrollRestorationHistory: History | undefined\nlet previousScrollRestoration: ScrollRestoration | undefined\n\nfunction normalizeBase(base?: string) {\n  if (!base?.trim()) {\n    return '/'\n  }\n  const normalized = base.trim().replace(/\\\\/g, '/').replace(/^\\/*/, '/').replace(/\\/*$/, '')\n  return normalized || '/'\n}\n\nexport function resolveWebRoutingConfig(config?: WebRoutingConfig): ResolvedWebRoutingConfig {\n  return {\n    mode: config?.mode === 'history' || config?.mode === 'hash' ? config.mode : 'memory',\n    base: normalizeBase(config?.base),\n  }\n}\n\nfunction isBrowserHistoryAvailable() {\n  return typeof window !== 'undefined'\n    && typeof window.history?.pushState === 'function'\n    && typeof window.history?.replaceState === 'function'\n}\n\nfunction bindManualScrollRestoration() {\n  if (typeof window === 'undefined' || !('scrollRestoration' in window.history)) {\n    return\n  }\n  scrollRestorationHistory = window.history\n  previousScrollRestoration = window.history.scrollRestoration\n  window.history.scrollRestoration = 'manual'\n}\n\nfunction restoreBrowserScrollRestoration() {\n  if (scrollRestorationHistory && previousScrollRestoration) {\n    scrollRestorationHistory.scrollRestoration = previousScrollRestoration\n  }\n  scrollRestorationHistory = undefined\n  previousScrollRestoration = undefined\n}\n\nfunction normalizePath(path: string) {\n  const decoded = decodeURIComponent(path || '/')\n  const withoutQuery = decoded.split('?')[0]!\n  const withoutLeading = withoutQuery.replace(/^\\/+/, '').replace(/\\/+$/, '')\n  return withoutLeading.replace(/\\.html$/, '')\n}\n\nfunction parseQuery(search: string) {\n  const query: Record<string, string> = {}\n  const params = new URLSearchParams(search.startsWith('?') ? search : `?${search}`)\n  for (const [key, value] of params.entries()) {\n    query[key] = value\n  }\n  return query\n}\n\nfunction toQueryString(query: Record<string, string>) {\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    params.set(key, value)\n  }\n  const search = params.toString()\n  return search ? `?${search}` : ''\n}\n\nfunction resolvePageId(path: string) {\n  const normalized = normalizePath(path)\n  if (knownPageIds.has(normalized)) {\n    return normalized\n  }\n  const indexId = `${normalized}/index`\n  if (knownPageIds.has(indexId)) {\n    return indexId\n  }\n  return undefined\n}\n\nfunction resolveTargetFromUrl(url: URL) {\n  if (resolvedConfig.mode === 'hash') {\n    const rawHash = url.hash.replace(/^#\\/?/, '')\n    const [path, query = ''] = rawHash.split('?')\n    const id = resolvePageId(path)\n    return id ? { id, query: parseQuery(query) } : undefined\n  }\n\n  const base = resolvedConfig.base === '/' ? '' : resolvedConfig.base\n  const matchesBase = !base || url.pathname === base || url.pathname.startsWith(`${base}/`)\n  const path = matchesBase ? url.pathname.slice(base.length) : url.pathname\n  const id = resolvePageId(path)\n  return id ? { id, query: parseQuery(url.search) } : undefined\n}\n\nexport function readWebRouteTarget(pageIds: string[], url?: string): WebRouteTarget | undefined {\n  knownPageIds = new Set(pageIds)\n  if (resolvedConfig.mode === 'memory' || typeof URL === 'undefined') {\n    return undefined\n  }\n  const runtimeUrl = url ?? (typeof window !== 'undefined' ? window.location.href : undefined)\n  if (!runtimeUrl) {\n    return undefined\n  }\n  try {\n    return resolveTargetFromUrl(new URL(runtimeUrl, 'http://weapp-vite.local'))\n  }\n  catch {\n    return undefined\n  }\n}\n\nfunction formatRouteUrl(target: WebRouteTarget) {\n  const query = toQueryString(target.query)\n  const path = `${target.id}${query}`\n  if (resolvedConfig.mode === 'hash') {\n    const prefix = resolvedConfig.base === '/' ? '' : resolvedConfig.base\n    return `${prefix}/#/${path}`\n  }\n  const prefix = resolvedConfig.base === '/' ? '' : resolvedConfig.base\n  return `${prefix}/${path}`\n}\n\nfunction toHistoryState(entries: PageStackEntry[]): WebRouteHistoryState {\n  return {\n    __weappWebRuntime: {\n      stack: entries.map(entry => ({\n        id: entry.id,\n        query: { ...entry.query },\n      })),\n    },\n  }\n}\n\nfunction resolveCurrentUrl() {\n  if (typeof window === 'undefined') {\n    return undefined\n  }\n  return `${window.location.pathname}${window.location.search}${window.location.hash}`\n}\n\nexport function disposeWebRouting() {\n  if (typeof window !== 'undefined') {\n    if (popstateHandler) {\n      window.removeEventListener('popstate', popstateHandler)\n    }\n    if (hashchangeHandler) {\n      window.removeEventListener('hashchange', hashchangeHandler)\n    }\n  }\n  popstateHandler = undefined\n  hashchangeHandler = undefined\n  restoreBrowserScrollRestoration()\n  resolvedConfig = { ...DEFAULT_CONFIG }\n  knownPageIds = new Set()\n}\n\nexport function configureWebRouting(\n  config: WebRoutingConfig | undefined,\n  pageIds: string[],\n  onPopState: (target: WebRouteTarget | undefined, state: WebRouteHistoryState | undefined) => void,\n) {\n  disposeWebRouting()\n  resolvedConfig = resolveWebRoutingConfig(config)\n  knownPageIds = new Set(pageIds)\n  if (resolvedConfig.mode === 'memory' || typeof window === 'undefined') {\n    return resolvedConfig\n  }\n\n  bindManualScrollRestoration()\n\n  popstateHandler = () => {\n    const state = window.history.state as WebRouteHistoryState | undefined\n    onPopState(readWebRouteTarget(pageIds), state)\n  }\n  window.addEventListener('popstate', popstateHandler)\n  if (resolvedConfig.mode === 'hash') {\n    hashchangeHandler = () => {\n      const state = window.history.state as WebRouteHistoryState | undefined\n      onPopState(readWebRouteTarget(pageIds), state)\n    }\n    window.addEventListener('hashchange', hashchangeHandler)\n  }\n  return resolvedConfig\n}\n\nexport function syncWebRouting(entries: PageStackEntry[], operation: 'push' | 'replace') {\n  if (resolvedConfig.mode === 'memory' || !isBrowserHistoryAvailable() || !entries.length) {\n    return\n  }\n  const target = entries[entries.length - 1]!\n  const url = formatRouteUrl({ id: target.id, query: target.query })\n  const state = toHistoryState(entries)\n  if (operation === 'push') {\n    window.history.pushState(state, '', url)\n  }\n  else {\n    window.history.replaceState(state, '', url)\n  }\n}\n\nexport function getWebHistoryStack(state: WebRouteHistoryState | undefined) {\n  const stack = state?.__weappWebRuntime?.stack\n  return Array.isArray(stack) ? stack : undefined\n}\n\nexport function getWebRoutingConfig() {\n  return { ...resolvedConfig }\n}\n\nexport function getWebRoutingUrl() {\n  return resolveCurrentUrl()\n}\n"],"mappings":"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"}

package/dist/runtime/polyfill/routeRuntime/lifecycle.mjs

@@ -1,3 +1,5 @@
+import { WEVU_PAGE_LAYOUT_NAME_KEY, WEVU_PAGE_LAYOUT_PROPS_KEY, WEVU_PAGE_LAYOUT_SETTER_KEY } from "@weapp-core/constants";
+
 //#region src/runtime/polyfill/routeRuntime/lifecycle.ts
 const ROUTE_META_SYMBOL = Symbol("@weapp-vite/web:route-meta");
 const PAGE_STATE_SYMBOL = Symbol("@weapp-vite/web:page-state");
@@ -6,7 +8,10 @@ function getRouteMeta(instance) {
 }
 function getPageState(instance) {
 	const target = instance;
-	target[PAGE_STATE_SYMBOL] ??= { loaded: false };
+	target[PAGE_STATE_SYMBOL] ??= {
+		loaded: false,
+		visible: false
+	};
 	return target[PAGE_STATE_SYMBOL];
 }
 function walkElementsDeep(root, collector) {
@@ -30,7 +35,23 @@ function dispatchPageLifetimeToComponents(page, type) {
 	}
 }
 function attachRouteMeta(element, meta) {
-	element[ROUTE_META_SYMBOL] = meta;
+	const carrier = element;
+	carrier[ROUTE_META_SYMBOL] = meta;
+	carrier.route = meta.id;
+}
+function hidePageInstance(instance, record) {
+	const state = getPageState(instance);
+	if (!state.visible) return;
+	dispatchPageLifetimeToComponents(instance, "hide");
+	record.hooks.onHide?.call(instance);
+	state.visible = false;
+}
+function showPageInstance(instance, record) {
+	const state = getPageState(instance);
+	if (state.visible || !state.loaded) return;
+	record.hooks.onShow?.call(instance);
+	dispatchPageLifetimeToComponents(instance, "show");
+	state.visible = true;
 }
 function augmentPageComponentOptions(component, record) {
 	const lifetimes = component.lifetimes ?? {};
@@ -44,6 +65,13 @@ function augmentPageComponentOptions(component, record) {
 			...lifetimes,
 			created() {
 				originalCreated?.call(this);
+				const target = this;
+				target[WEVU_PAGE_LAYOUT_SETTER_KEY] = (layout, props) => {
+					target.setData?.({
+						[WEVU_PAGE_LAYOUT_NAME_KEY]: layout === false ? "__wv_no_layout" : layout,
+						[WEVU_PAGE_LAYOUT_PROPS_KEY]: layout === false ? {} : props ?? {}
+					});
+				};
 				getPageState(this);
 				record.instances.add(this);
 			},
@@ -56,22 +84,25 @@ function augmentPageComponentOptions(component, record) {
 					record.hooks.onLoad?.call(this, meta?.query ?? {});
 					state.loaded = true;
 				}
-				record.hooks.onShow?.call(this);
+				if (meta?.entry.active !== false) {
+					record.hooks.onShow?.call(this);
+					state.visible = true;
+				}
 			},
 			ready() {
 				originalReady?.call(this);
 				record.hooks.onReady?.call(this);
-				dispatchPageLifetimeToComponents(this, "show");
+				if (getPageState(this).visible) dispatchPageLifetimeToComponents(this, "show");
 			},
 			detached() {
 				originalDetached?.call(this);
 				const meta = getRouteMeta(this);
 				if (meta?.entry) meta.entry.instance = void 0;
-				dispatchPageLifetimeToComponents(this, "hide");
-				record.hooks.onHide?.call(this);
-				record.hooks.onUnload?.call(this);
 				const state = getPageState(this);
+				hidePageInstance(this, record);
+				if (state.loaded) record.hooks.onUnload?.call(this);
 				state.loaded = false;
+				state.visible = false;
 				record.instances.delete(this);
 			}
 		}
@@ -79,5 +110,5 @@ function augmentPageComponentOptions(component, record) {
 }
 
 //#endregion
-export { attachRouteMeta, augmentPageComponentOptions, dispatchPageLifetimeToComponents };
+export { attachRouteMeta, augmentPageComponentOptions, dispatchPageLifetimeToComponents, hidePageInstance, showPageInstance };
 //# sourceMappingURL=lifecycle.mjs.map

package/dist/runtime/polyfill/routeRuntime/lifecycle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/lifecycle.ts"],"sourcesContent":["import type { ComponentOptions, ComponentPublicInstance } from '../../component'\nimport type { PageRecord, RouteMeta } from './options'\n\nconst ROUTE_META_SYMBOL = Symbol('@weapp-vite/web:route-meta')\nconst PAGE_STATE_SYMBOL = Symbol('@weapp-vite/web:page-state')\n\ninterface RouteMetaCarrier {\n  [ROUTE_META_SYMBOL]?: RouteMeta\n}\n\ninterface PageInstanceState {\n  loaded: boolean\n}\n\ninterface PageStateCarrier {\n  [PAGE_STATE_SYMBOL]?: PageInstanceState\n}\n\ntype ComponentPageLifetimeType = 'show' | 'hide' | 'resize'\n\ninterface PageLifetimeAwareComponent extends HTMLElement {\n  __weappInvokePageLifetime?: (type: ComponentPageLifetimeType) => void\n  renderRoot?: ShadowRoot | HTMLElement\n}\n\nfunction getRouteMeta(instance: ComponentPublicInstance): RouteMeta | undefined {\n  return (instance as RouteMetaCarrier)[ROUTE_META_SYMBOL]\n}\n\nfunction getPageState(instance: ComponentPublicInstance): PageInstanceState {\n  const target = instance as PageStateCarrier\n  target[PAGE_STATE_SYMBOL] ??= { loaded: false }\n  return target[PAGE_STATE_SYMBOL]!\n}\n\nfunction walkElementsDeep(root: ParentNode, collector: Set<HTMLElement>) {\n  const nodes = Array.from((root as ParentNode & { childNodes?: ArrayLike<unknown> }).childNodes ?? [])\n  for (const node of nodes) {\n    if (!(node instanceof HTMLElement)) {\n      continue\n    }\n    collector.add(node)\n    walkElementsDeep(node, collector)\n    if (node.shadowRoot) {\n      walkElementsDeep(node.shadowRoot, collector)\n    }\n  }\n}\n\nexport function dispatchPageLifetimeToComponents(\n  page: ComponentPublicInstance,\n  type: ComponentPageLifetimeType,\n) {\n  const host = page as ComponentPublicInstance & {\n    renderRoot?: ShadowRoot | HTMLElement\n    shadowRoot?: ShadowRoot | null\n  }\n  const root = host.renderRoot ?? host.shadowRoot ?? host\n  if (!root || typeof root.querySelectorAll !== 'function') {\n    return\n  }\n  const elements = new Set<HTMLElement>()\n  walkElementsDeep(root, elements)\n  for (const element of elements) {\n    const component = element as PageLifetimeAwareComponent\n    if (typeof component.__weappInvokePageLifetime === 'function') {\n      component.__weappInvokePageLifetime(type)\n    }\n  }\n}\n\nexport function attachRouteMeta(\n  element: HTMLElement & ComponentPublicInstance,\n  meta: RouteMeta,\n) {\n  (element as RouteMetaCarrier)[ROUTE_META_SYMBOL] = meta\n}\n\nexport function augmentPageComponentOptions(component: ComponentOptions, record: PageRecord) {\n  const lifetimes = component.lifetimes ?? {}\n  const originalCreated = lifetimes?.created\n  const originalAttached = lifetimes?.attached\n  const originalReady = lifetimes?.ready\n  const originalDetached = lifetimes?.detached\n\n  const enhanced: ComponentOptions = {\n    ...component,\n    lifetimes: {\n      ...lifetimes,\n      created(this: ComponentPublicInstance) {\n        originalCreated?.call(this)\n        getPageState(this)\n        record.instances.add(this)\n      },\n      attached(this: ComponentPublicInstance) {\n        originalAttached?.call(this)\n        const meta = getRouteMeta(this)\n        if (meta?.entry) {\n          meta.entry.instance = this\n        }\n        const state = getPageState(this)\n        if (!state.loaded) {\n          record.hooks.onLoad?.call(this, meta?.query ?? {})\n          state.loaded = true\n        }\n        record.hooks.onShow?.call(this)\n      },\n      ready(this: ComponentPublicInstance) {\n        originalReady?.call(this)\n        record.hooks.onReady?.call(this)\n        dispatchPageLifetimeToComponents(this, 'show')\n      },\n      detached(this: ComponentPublicInstance) {\n        originalDetached?.call(this)\n        const meta = getRouteMeta(this)\n        if (meta?.entry) {\n          meta.entry.instance = undefined\n        }\n        dispatchPageLifetimeToComponents(this, 'hide')\n        record.hooks.onHide?.call(this)\n        record.hooks.onUnload?.call(this)\n        const state = getPageState(this)\n        state.loaded = false\n        record.instances.delete(this)\n      },\n    },\n  }\n\n  return enhanced\n}\n"],"mappings":";AAGA,MAAM,oBAAoB,OAAO,4BAA4B;AAC7D,MAAM,oBAAoB,OAAO,4BAA4B;AAqB7D,SAAS,aAAa,UAA0D;CAC9E,OAAQ,SAA8B;AACxC;AAEA,SAAS,aAAa,UAAsD;CAC1E,MAAM,SAAS;CACf,OAAO,uBAAuB,EAAE,QAAQ,MAAM;CAC9C,OAAO,OAAO;AAChB;AAEA,SAAS,iBAAiB,MAAkB,WAA6B;CACvE,MAAM,QAAQ,MAAM,KAAM,KAA0D,cAAc,CAAC,CAAC;CACpG,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,EAAE,gBAAgB,cACpB;EAEF,UAAU,IAAI,IAAI;EAClB,iBAAiB,MAAM,SAAS;EAChC,IAAI,KAAK,YACP,iBAAiB,KAAK,YAAY,SAAS;CAE/C;AACF;AAEA,SAAgB,iCACd,MACA,MACA;CACA,MAAM,OAAO;CAIb,MAAM,OAAO,KAAK,cAAc,KAAK,cAAc;CACnD,IAAI,CAAC,QAAQ,OAAO,KAAK,qBAAqB,YAC5C;CAEF,MAAM,2BAAW,IAAI,IAAiB;CACtC,iBAAiB,MAAM,QAAQ;CAC/B,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,YAAY;EAClB,IAAI,OAAO,UAAU,8BAA8B,YACjD,UAAU,0BAA0B,IAAI;CAE5C;AACF;AAEA,SAAgB,gBACd,SACA,MACA;CACA,AAAC,QAA6B,qBAAqB;AACrD;AAEA,SAAgB,4BAA4B,WAA6B,QAAoB;CAC3F,MAAM,YAAY,UAAU,aAAa,CAAC;CAC1C,MAAM,kBAAkB,WAAW;CACnC,MAAM,mBAAmB,WAAW;CACpC,MAAM,gBAAgB,WAAW;CACjC,MAAM,mBAAmB,WAAW;CA6CpC,OAAO;EA1CL,GAAG;EACH,WAAW;GACT,GAAG;GACH,UAAuC;IACrC,iBAAiB,KAAK,IAAI;IAC1B,aAAa,IAAI;IACjB,OAAO,UAAU,IAAI,IAAI;GAC3B;GACA,WAAwC;IACtC,kBAAkB,KAAK,IAAI;IAC3B,MAAM,OAAO,aAAa,IAAI;IAC9B,IAAI,MAAM,OACR,KAAK,MAAM,WAAW;IAExB,MAAM,QAAQ,aAAa,IAAI;IAC/B,IAAI,CAAC,MAAM,QAAQ;KACjB,OAAO,MAAM,QAAQ,KAAK,MAAM,MAAM,SAAS,CAAC,CAAC;KACjD,MAAM,SAAS;IACjB;IACA,OAAO,MAAM,QAAQ,KAAK,IAAI;GAChC;GACA,QAAqC;IACnC,eAAe,KAAK,IAAI;IACxB,OAAO,MAAM,SAAS,KAAK,IAAI;IAC/B,iCAAiC,MAAM,MAAM;GAC/C;GACA,WAAwC;IACtC,kBAAkB,KAAK,IAAI;IAC3B,MAAM,OAAO,aAAa,IAAI;IAC9B,IAAI,MAAM,OACR,KAAK,MAAM,WAAW;IAExB,iCAAiC,MAAM,MAAM;IAC7C,OAAO,MAAM,QAAQ,KAAK,IAAI;IAC9B,OAAO,MAAM,UAAU,KAAK,IAAI;IAChC,MAAM,QAAQ,aAAa,IAAI;IAC/B,MAAM,SAAS;IACf,OAAO,UAAU,OAAO,IAAI;GAC9B;EACF;CAGY;AAChB"}
+{"version":3,"file":"lifecycle.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/lifecycle.ts"],"sourcesContent":["import type { ComponentOptions, ComponentPublicInstance } from '../../component'\nimport type { PageRecord, RouteMeta } from './options'\nimport { WEVU_PAGE_LAYOUT_NAME_KEY, WEVU_PAGE_LAYOUT_PROPS_KEY, WEVU_PAGE_LAYOUT_SETTER_KEY } from '@weapp-core/constants'\n\nconst ROUTE_META_SYMBOL = Symbol('@weapp-vite/web:route-meta')\nconst PAGE_STATE_SYMBOL = Symbol('@weapp-vite/web:page-state')\n\ninterface RouteMetaCarrier {\n  [ROUTE_META_SYMBOL]?: RouteMeta\n  route?: string\n}\n\ninterface PageInstanceState {\n  loaded: boolean\n  visible: boolean\n}\n\ninterface PageStateCarrier {\n  [PAGE_STATE_SYMBOL]?: PageInstanceState\n}\n\ntype ComponentPageLifetimeType = 'show' | 'hide' | 'resize'\n\ninterface PageLifetimeAwareComponent extends HTMLElement {\n  __weappInvokePageLifetime?: (type: ComponentPageLifetimeType) => void\n  renderRoot?: ShadowRoot | HTMLElement\n}\n\nfunction getRouteMeta(instance: ComponentPublicInstance): RouteMeta | undefined {\n  return (instance as RouteMetaCarrier)[ROUTE_META_SYMBOL]\n}\n\nfunction getPageState(instance: ComponentPublicInstance): PageInstanceState {\n  const target = instance as PageStateCarrier\n  target[PAGE_STATE_SYMBOL] ??= { loaded: false, visible: false }\n  return target[PAGE_STATE_SYMBOL]!\n}\n\nfunction walkElementsDeep(root: ParentNode, collector: Set<HTMLElement>) {\n  const nodes = Array.from((root as ParentNode & { childNodes?: ArrayLike<unknown> }).childNodes ?? [])\n  for (const node of nodes) {\n    if (!(node instanceof HTMLElement)) {\n      continue\n    }\n    collector.add(node)\n    walkElementsDeep(node, collector)\n    if (node.shadowRoot) {\n      walkElementsDeep(node.shadowRoot, collector)\n    }\n  }\n}\n\nexport function dispatchPageLifetimeToComponents(\n  page: ComponentPublicInstance,\n  type: ComponentPageLifetimeType,\n) {\n  const host = page as ComponentPublicInstance & {\n    renderRoot?: ShadowRoot | HTMLElement\n    shadowRoot?: ShadowRoot | null\n  }\n  const root = host.renderRoot ?? host.shadowRoot ?? host\n  if (!root || typeof root.querySelectorAll !== 'function') {\n    return\n  }\n  const elements = new Set<HTMLElement>()\n  walkElementsDeep(root, elements)\n  for (const element of elements) {\n    const component = element as PageLifetimeAwareComponent\n    if (typeof component.__weappInvokePageLifetime === 'function') {\n      component.__weappInvokePageLifetime(type)\n    }\n  }\n}\n\nexport function attachRouteMeta(\n  element: HTMLElement & ComponentPublicInstance,\n  meta: RouteMeta,\n) {\n  const carrier = element as RouteMetaCarrier\n  carrier[ROUTE_META_SYMBOL] = meta\n  carrier.route = meta.id\n}\n\nexport function hidePageInstance(instance: ComponentPublicInstance, record: PageRecord) {\n  const state = getPageState(instance)\n  if (!state.visible) {\n    return\n  }\n  dispatchPageLifetimeToComponents(instance, 'hide')\n  record.hooks.onHide?.call(instance)\n  state.visible = false\n}\n\nexport function showPageInstance(instance: ComponentPublicInstance, record: PageRecord) {\n  const state = getPageState(instance)\n  if (state.visible || !state.loaded) {\n    return\n  }\n  record.hooks.onShow?.call(instance)\n  dispatchPageLifetimeToComponents(instance, 'show')\n  state.visible = true\n}\n\nexport function augmentPageComponentOptions(component: ComponentOptions, record: PageRecord) {\n  const lifetimes = component.lifetimes ?? {}\n  const originalCreated = lifetimes?.created\n  const originalAttached = lifetimes?.attached\n  const originalReady = lifetimes?.ready\n  const originalDetached = lifetimes?.detached\n\n  const enhanced: ComponentOptions = {\n    ...component,\n    lifetimes: {\n      ...lifetimes,\n      created(this: ComponentPublicInstance) {\n        originalCreated?.call(this)\n        const target = this as ComponentPublicInstance & Record<string, any>\n        target[WEVU_PAGE_LAYOUT_SETTER_KEY] = (layout: string | false, props?: Record<string, any>) => {\n          target.setData?.({\n            [WEVU_PAGE_LAYOUT_NAME_KEY]: layout === false ? '__wv_no_layout' : layout,\n            [WEVU_PAGE_LAYOUT_PROPS_KEY]: layout === false ? {} : (props ?? {}),\n          })\n        }\n        getPageState(this)\n        record.instances.add(this)\n      },\n      attached(this: ComponentPublicInstance) {\n        originalAttached?.call(this)\n        const meta = getRouteMeta(this)\n        if (meta?.entry) {\n          meta.entry.instance = this\n        }\n        const state = getPageState(this)\n        if (!state.loaded) {\n          record.hooks.onLoad?.call(this, meta?.query ?? {})\n          state.loaded = true\n        }\n        if (meta?.entry.active !== false) {\n          record.hooks.onShow?.call(this)\n          state.visible = true\n        }\n      },\n      ready(this: ComponentPublicInstance) {\n        originalReady?.call(this)\n        record.hooks.onReady?.call(this)\n        if (getPageState(this).visible) {\n          dispatchPageLifetimeToComponents(this, 'show')\n        }\n      },\n      detached(this: ComponentPublicInstance) {\n        originalDetached?.call(this)\n        const meta = getRouteMeta(this)\n        if (meta?.entry) {\n          meta.entry.instance = undefined\n        }\n        const state = getPageState(this)\n        hidePageInstance(this, record)\n        if (state.loaded) {\n          record.hooks.onUnload?.call(this)\n        }\n        state.loaded = false\n        state.visible = false\n        record.instances.delete(this)\n      },\n    },\n  }\n\n  return enhanced\n}\n"],"mappings":";;;AAIA,MAAM,oBAAoB,OAAO,4BAA4B;AAC7D,MAAM,oBAAoB,OAAO,4BAA4B;AAuB7D,SAAS,aAAa,UAA0D;CAC9E,OAAQ,SAA8B;AACxC;AAEA,SAAS,aAAa,UAAsD;CAC1E,MAAM,SAAS;CACf,OAAO,uBAAuB;EAAE,QAAQ;EAAO,SAAS;CAAM;CAC9D,OAAO,OAAO;AAChB;AAEA,SAAS,iBAAiB,MAAkB,WAA6B;CACvE,MAAM,QAAQ,MAAM,KAAM,KAA0D,cAAc,CAAC,CAAC;CACpG,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,EAAE,gBAAgB,cACpB;EAEF,UAAU,IAAI,IAAI;EAClB,iBAAiB,MAAM,SAAS;EAChC,IAAI,KAAK,YACP,iBAAiB,KAAK,YAAY,SAAS;CAE/C;AACF;AAEA,SAAgB,iCACd,MACA,MACA;CACA,MAAM,OAAO;CAIb,MAAM,OAAO,KAAK,cAAc,KAAK,cAAc;CACnD,IAAI,CAAC,QAAQ,OAAO,KAAK,qBAAqB,YAC5C;CAEF,MAAM,2BAAW,IAAI,IAAiB;CACtC,iBAAiB,MAAM,QAAQ;CAC/B,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,YAAY;EAClB,IAAI,OAAO,UAAU,8BAA8B,YACjD,UAAU,0BAA0B,IAAI;CAE5C;AACF;AAEA,SAAgB,gBACd,SACA,MACA;CACA,MAAM,UAAU;CAChB,QAAQ,qBAAqB;CAC7B,QAAQ,QAAQ,KAAK;AACvB;AAEA,SAAgB,iBAAiB,UAAmC,QAAoB;CACtF,MAAM,QAAQ,aAAa,QAAQ;CACnC,IAAI,CAAC,MAAM,SACT;CAEF,iCAAiC,UAAU,MAAM;CACjD,OAAO,MAAM,QAAQ,KAAK,QAAQ;CAClC,MAAM,UAAU;AAClB;AAEA,SAAgB,iBAAiB,UAAmC,QAAoB;CACtF,MAAM,QAAQ,aAAa,QAAQ;CACnC,IAAI,MAAM,WAAW,CAAC,MAAM,QAC1B;CAEF,OAAO,MAAM,QAAQ,KAAK,QAAQ;CAClC,iCAAiC,UAAU,MAAM;CACjD,MAAM,UAAU;AAClB;AAEA,SAAgB,4BAA4B,WAA6B,QAAoB;CAC3F,MAAM,YAAY,UAAU,aAAa,CAAC;CAC1C,MAAM,kBAAkB,WAAW;CACnC,MAAM,mBAAmB,WAAW;CACpC,MAAM,gBAAgB,WAAW;CACjC,MAAM,mBAAmB,WAAW;CA2DpC,OAAO;EAxDL,GAAG;EACH,WAAW;GACT,GAAG;GACH,UAAuC;IACrC,iBAAiB,KAAK,IAAI;IAC1B,MAAM,SAAS;IACf,OAAO,gCAAgC,QAAwB,UAAgC;KAC7F,OAAO,UAAU;OACd,4BAA4B,WAAW,QAAQ,mBAAmB;OAClE,6BAA6B,WAAW,QAAQ,CAAC,IAAK,SAAS,CAAC;KACnE,CAAC;IACH;IACA,aAAa,IAAI;IACjB,OAAO,UAAU,IAAI,IAAI;GAC3B;GACA,WAAwC;IACtC,kBAAkB,KAAK,IAAI;IAC3B,MAAM,OAAO,aAAa,IAAI;IAC9B,IAAI,MAAM,OACR,KAAK,MAAM,WAAW;IAExB,MAAM,QAAQ,aAAa,IAAI;IAC/B,IAAI,CAAC,MAAM,QAAQ;KACjB,OAAO,MAAM,QAAQ,KAAK,MAAM,MAAM,SAAS,CAAC,CAAC;KACjD,MAAM,SAAS;IACjB;IACA,IAAI,MAAM,MAAM,WAAW,OAAO;KAChC,OAAO,MAAM,QAAQ,KAAK,IAAI;KAC9B,MAAM,UAAU;IAClB;GACF;GACA,QAAqC;IACnC,eAAe,KAAK,IAAI;IACxB,OAAO,MAAM,SAAS,KAAK,IAAI;IAC/B,IAAI,aAAa,IAAI,CAAC,CAAC,SACrB,iCAAiC,MAAM,MAAM;GAEjD;GACA,WAAwC;IACtC,kBAAkB,KAAK,IAAI;IAC3B,MAAM,OAAO,aAAa,IAAI;IAC9B,IAAI,MAAM,OACR,KAAK,MAAM,WAAW;IAExB,MAAM,QAAQ,aAAa,IAAI;IAC/B,iBAAiB,MAAM,MAAM;IAC7B,IAAI,MAAM,QACR,OAAO,MAAM,UAAU,KAAK,IAAI;IAElC,MAAM,SAAS;IACf,MAAM,UAAU;IAChB,OAAO,UAAU,OAAO,IAAI;GAC9B;EACF;CAGY;AAChB"}

package/dist/runtime/polyfill/routeRuntime/options.d.mts

@@ -1,11 +1,14 @@
+import { NavigationBarConfig } from "../../../compiler/wxml/types.mjs";
 import { TemplateRenderer } from "../../template.mjs";
 import { ComponentOptions, ComponentPublicInstance } from "../../component/types.mjs";
 import "../../component/index.mjs";
+import { MiniProgramAsyncOptions, MiniProgramBaseResult } from "../types/base.mjs";
 //#region src/runtime/polyfill/routeRuntime/options.d.ts
 interface RegisterMeta {
   id: string;
   template?: TemplateRenderer;
   style?: string;
+  navigationBar?: NavigationBarConfig;
 }
 interface PageHooks {
   onLoad?: (this: ComponentPublicInstance, query: Record<string, string>) => void;
@@ -17,6 +20,7 @@ interface PageHooks {
 interface AppLifecycleHooks {
   onLaunch?: (this: AppRuntime, options: AppLaunchOptions) => void;
   onShow?: (this: AppRuntime, options: AppLaunchOptions) => void;
+  onHide?: (this: AppRuntime) => void;
 }
 type AppRuntime = Record<string, unknown> & Partial<AppLifecycleHooks> & {
   globalData?: Record<string, unknown>;
@@ -27,8 +31,14 @@ interface AppLaunchOptions {
   query: Record<string, string>;
   referrerInfo: Record<string, unknown>;
 }
+interface RouteOptions extends MiniProgramAsyncOptions<MiniProgramBaseResult> {
+  url: string;
+}
+interface NavigateBackOptions extends MiniProgramAsyncOptions<MiniProgramBaseResult> {
+  delta?: number;
+}
 type PageRawOptions = ComponentOptions & PageHooks & Record<string, unknown>;
 type ComponentRawOptions = ComponentOptions & Record<string, unknown>;
 //#endregion
-export { AppLaunchOptions, AppRuntime, ComponentRawOptions, PageHooks, PageRawOptions, RegisterMeta };
+export { AppLaunchOptions, AppRuntime, ComponentRawOptions, NavigateBackOptions, PageHooks, PageRawOptions, RegisterMeta, RouteOptions };
 //# sourceMappingURL=options.d.mts.map

package/dist/runtime/polyfill/routeRuntime/options.mjs

@@ -28,7 +28,6 @@ const RESERVED_COMPONENT_METHOD_KEYS = /* @__PURE__ */ new Set([
 	"mixins"
 ]);
 function cloneLifetimes(source) {
-	if (!source) return;
 	return { ...source };
 }
 function isRecord(value) {

package/dist/runtime/polyfill/routeRuntime/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/options.ts"],"sourcesContent":["import type { ComponentOptions, ComponentPublicInstance } from '../../component'\nimport type { TemplateRenderer } from '../../template'\n\nexport interface RegisterMeta {\n  id: string\n  template?: TemplateRenderer\n  style?: string\n}\n\nexport interface PageHooks {\n  onLoad?: (this: ComponentPublicInstance, query: Record<string, string>) => void\n  onReady?: (this: ComponentPublicInstance) => void\n  onShow?: (this: ComponentPublicInstance) => void\n  onHide?: (this: ComponentPublicInstance) => void\n  onUnload?: (this: ComponentPublicInstance) => void\n}\n\nexport interface PageRecord {\n  tag: string\n  hooks: PageHooks\n  instances: Set<ComponentPublicInstance>\n}\n\nexport interface ComponentRecord {\n  tag: string\n}\n\nexport interface PageStackEntry {\n  id: string\n  query: Record<string, string>\n  instance?: ComponentPublicInstance\n}\n\nexport interface RouteMeta {\n  id: string\n  query: Record<string, string>\n  entry: PageStackEntry\n}\n\ninterface AppLifecycleHooks {\n  onLaunch?: (this: AppRuntime, options: AppLaunchOptions) => void\n  onShow?: (this: AppRuntime, options: AppLaunchOptions) => void\n}\n\nexport type AppRuntime = Record<string, unknown> & Partial<AppLifecycleHooks> & {\n  globalData?: Record<string, unknown>\n}\n\nexport interface AppLaunchOptions {\n  path: string\n  scene: number\n  query: Record<string, string>\n  referrerInfo: Record<string, unknown>\n}\n\ntype MethodHandler = (this: ComponentPublicInstance, ...args: unknown[]) => unknown\n\nexport type PageRawOptions = ComponentOptions & PageHooks & Record<string, unknown>\nexport type ComponentRawOptions = ComponentOptions & Record<string, unknown>\n\nconst PAGE_LIFECYCLE_KEYS = new Set(['onLoad', 'onReady', 'onShow', 'onHide', 'onUnload'])\nconst RESERVED_PAGE_METHOD_KEYS = new Set([\n  'data',\n  'methods',\n  'lifetimes',\n  'properties',\n  'behaviors',\n  'options',\n  'observers',\n  'mixins',\n  ...PAGE_LIFECYCLE_KEYS,\n])\nconst RESERVED_COMPONENT_METHOD_KEYS = new Set([\n  'data',\n  'methods',\n  'lifetimes',\n  'pageLifetimes',\n  'properties',\n  'behaviors',\n  'options',\n  'observers',\n  'mixins',\n])\n\nfunction cloneLifetimes(source?: ComponentOptions['lifetimes']): ComponentOptions['lifetimes'] {\n  if (!source) {\n    return undefined\n  }\n  return {\n    ...source,\n  }\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null\n}\n\nfunction isMethodHandler(value: unknown): value is MethodHandler {\n  return typeof value === 'function'\n}\n\nfunction normalizeMethodBag(\n  source: Record<string, unknown> | undefined,\n  reserved: Set<string>,\n) {\n  const methods: Record<string, MethodHandler> = {}\n  const sourceMethods = isRecord(source?.methods) ? source?.methods : undefined\n\n  if (sourceMethods) {\n    for (const [key, value] of Object.entries(sourceMethods)) {\n      if (isMethodHandler(value)) {\n        methods[key] = value\n      }\n    }\n  }\n\n  if (source) {\n    for (const [key, value] of Object.entries(source)) {\n      if (reserved.has(key)) {\n        continue\n      }\n      if (isMethodHandler(value) && methods[key] === undefined) {\n        methods[key] = value\n      }\n    }\n  }\n  return methods\n}\n\nexport function normalizePageOptions(raw: PageRawOptions | undefined): { component: ComponentOptions, hooks: PageHooks } {\n  const component = { ...(raw ?? {}) } as ComponentOptions\n  component.methods = normalizeMethodBag(raw as Record<string, unknown> | undefined, RESERVED_PAGE_METHOD_KEYS) as ComponentOptions['methods']\n  if (raw?.lifetimes) {\n    component.lifetimes = cloneLifetimes(raw.lifetimes)\n  }\n  const hooks: PageHooks = {}\n  if (typeof raw?.onLoad === 'function') {\n    hooks.onLoad = raw.onLoad as PageHooks['onLoad']\n  }\n  if (typeof raw?.onReady === 'function') {\n    hooks.onReady = raw.onReady as PageHooks['onReady']\n  }\n  if (typeof raw?.onShow === 'function') {\n    hooks.onShow = raw.onShow as PageHooks['onShow']\n  }\n  if (typeof raw?.onHide === 'function') {\n    hooks.onHide = raw.onHide as PageHooks['onHide']\n  }\n  if (typeof raw?.onUnload === 'function') {\n    hooks.onUnload = raw.onUnload as PageHooks['onUnload']\n  }\n  return { component, hooks }\n}\n\nexport function normalizeComponentOptions(raw: ComponentRawOptions | undefined): ComponentOptions {\n  const component = { ...(raw ?? {}) } as ComponentOptions\n  component.methods = normalizeMethodBag(raw as Record<string, unknown> | undefined, RESERVED_COMPONENT_METHOD_KEYS) as ComponentOptions['methods']\n  if (raw?.lifetimes) {\n    component.lifetimes = cloneLifetimes(raw.lifetimes)\n  }\n  return component\n}\n"],"mappings":";AA6DA,MAAM,4CAA4B,IAAI,IAAI;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,mBAAG,IAV2B,IAAI;EAAC;EAAU;EAAW;EAAU;EAAU;CAAU,CAUjE;AACvB,CAAC;AACD,MAAM,iDAAiC,IAAI,IAAI;CAC7C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,eAAe,QAAuE;CAC7F,IAAI,CAAC,QACH;CAEF,OAAO,EACL,GAAG,OACL;AACF;AAEA,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,gBAAgB,OAAwC;CAC/D,OAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,mBACP,QACA,UACA;CACA,MAAM,UAAyC,CAAC;CAChD,MAAM,gBAAgB,SAAS,QAAQ,OAAO,IAAI,QAAQ,UAAU;CAEpE,IAAI,eACF;OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,GACrD,IAAI,gBAAgB,KAAK,GACvB,QAAQ,OAAO;CAEnB;CAGF,IAAI,QACF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;EACjD,IAAI,SAAS,IAAI,GAAG,GAClB;EAEF,IAAI,gBAAgB,KAAK,KAAK,QAAQ,SAAS,QAC7C,QAAQ,OAAO;CAEnB;CAEF,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAoF;CACvH,MAAM,YAAY,EAAE,GAAI,OAAO,CAAC,EAAG;CACnC,UAAU,UAAU,mBAAmB,KAA4C,yBAAyB;CAC5G,IAAI,KAAK,WACP,UAAU,YAAY,eAAe,IAAI,SAAS;CAEpD,MAAM,QAAmB,CAAC;CAC1B,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,YAAY,YAC1B,MAAM,UAAU,IAAI;CAEtB,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,aAAa,YAC3B,MAAM,WAAW,IAAI;CAEvB,OAAO;EAAE;EAAW;CAAM;AAC5B;AAEA,SAAgB,0BAA0B,KAAwD;CAChG,MAAM,YAAY,EAAE,GAAI,OAAO,CAAC,EAAG;CACnC,UAAU,UAAU,mBAAmB,KAA4C,8BAA8B;CACjH,IAAI,KAAK,WACP,UAAU,YAAY,eAAe,IAAI,SAAS;CAEpD,OAAO;AACT"}
+{"version":3,"file":"options.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/options.ts"],"sourcesContent":["import type { NavigationBarConfig } from '../../../compiler/wxml'\nimport type { ComponentOptions, ComponentPublicInstance } from '../../component'\nimport type { TemplateRenderer } from '../../template'\nimport type { MiniProgramAsyncOptions, MiniProgramBaseResult } from '../types'\n\nexport interface RegisterMeta {\n  id: string\n  template?: TemplateRenderer\n  style?: string\n  navigationBar?: NavigationBarConfig\n}\n\nexport interface PageHooks {\n  onLoad?: (this: ComponentPublicInstance, query: Record<string, string>) => void\n  onReady?: (this: ComponentPublicInstance) => void\n  onShow?: (this: ComponentPublicInstance) => void\n  onHide?: (this: ComponentPublicInstance) => void\n  onUnload?: (this: ComponentPublicInstance) => void\n}\n\nexport interface PageRecord {\n  tag: string\n  hooks: PageHooks\n  instances: Set<ComponentPublicInstance>\n  navigationBar?: NavigationBarConfig\n}\n\nexport interface ComponentRecord {\n  tag: string\n}\n\nexport interface PageStackEntry {\n  id: string\n  query: Record<string, string>\n  active: boolean\n  element?: HTMLElement & ComponentPublicInstance\n  instance?: ComponentPublicInstance\n  scrollTop?: number\n}\n\nexport interface RouteMeta {\n  id: string\n  query: Record<string, string>\n  entry: PageStackEntry\n}\n\ninterface AppLifecycleHooks {\n  onLaunch?: (this: AppRuntime, options: AppLaunchOptions) => void\n  onShow?: (this: AppRuntime, options: AppLaunchOptions) => void\n  onHide?: (this: AppRuntime) => void\n}\n\nexport type AppRuntime = Record<string, unknown> & Partial<AppLifecycleHooks> & {\n  globalData?: Record<string, unknown>\n}\n\nexport interface AppLaunchOptions {\n  path: string\n  scene: number\n  query: Record<string, string>\n  referrerInfo: Record<string, unknown>\n}\n\nexport interface RouteOptions extends MiniProgramAsyncOptions<MiniProgramBaseResult> {\n  url: string\n}\n\nexport interface NavigateBackOptions extends MiniProgramAsyncOptions<MiniProgramBaseResult> {\n  delta?: number\n}\n\ntype MethodHandler = (this: ComponentPublicInstance, ...args: unknown[]) => unknown\n\nexport type PageRawOptions = ComponentOptions & PageHooks & Record<string, unknown>\nexport type ComponentRawOptions = ComponentOptions & Record<string, unknown>\n\nconst PAGE_LIFECYCLE_KEYS = new Set(['onLoad', 'onReady', 'onShow', 'onHide', 'onUnload'])\nconst RESERVED_PAGE_METHOD_KEYS = new Set([\n  'data',\n  'methods',\n  'lifetimes',\n  'properties',\n  'behaviors',\n  'options',\n  'observers',\n  'mixins',\n  ...PAGE_LIFECYCLE_KEYS,\n])\nconst RESERVED_COMPONENT_METHOD_KEYS = new Set([\n  'data',\n  'methods',\n  'lifetimes',\n  'pageLifetimes',\n  'properties',\n  'behaviors',\n  'options',\n  'observers',\n  'mixins',\n])\n\nfunction cloneLifetimes(source: NonNullable<ComponentOptions['lifetimes']>): ComponentOptions['lifetimes'] {\n  return {\n    ...source,\n  }\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null\n}\n\nfunction isMethodHandler(value: unknown): value is MethodHandler {\n  return typeof value === 'function'\n}\n\nfunction normalizeMethodBag(\n  source: Record<string, unknown> | undefined,\n  reserved: Set<string>,\n) {\n  const methods: Record<string, MethodHandler> = {}\n  const sourceMethods = isRecord(source?.methods) ? source?.methods : undefined\n\n  if (sourceMethods) {\n    for (const [key, value] of Object.entries(sourceMethods)) {\n      if (isMethodHandler(value)) {\n        methods[key] = value\n      }\n    }\n  }\n\n  if (source) {\n    for (const [key, value] of Object.entries(source)) {\n      if (reserved.has(key)) {\n        continue\n      }\n      if (isMethodHandler(value) && methods[key] === undefined) {\n        methods[key] = value\n      }\n    }\n  }\n  return methods\n}\n\nexport function normalizePageOptions(raw: PageRawOptions | undefined): { component: ComponentOptions, hooks: PageHooks } {\n  const component = { ...(raw ?? {}) } as ComponentOptions\n  component.methods = normalizeMethodBag(raw as Record<string, unknown> | undefined, RESERVED_PAGE_METHOD_KEYS) as ComponentOptions['methods']\n  if (raw?.lifetimes) {\n    component.lifetimes = cloneLifetimes(raw.lifetimes)\n  }\n  const hooks: PageHooks = {}\n  if (typeof raw?.onLoad === 'function') {\n    hooks.onLoad = raw.onLoad as PageHooks['onLoad']\n  }\n  if (typeof raw?.onReady === 'function') {\n    hooks.onReady = raw.onReady as PageHooks['onReady']\n  }\n  if (typeof raw?.onShow === 'function') {\n    hooks.onShow = raw.onShow as PageHooks['onShow']\n  }\n  if (typeof raw?.onHide === 'function') {\n    hooks.onHide = raw.onHide as PageHooks['onHide']\n  }\n  if (typeof raw?.onUnload === 'function') {\n    hooks.onUnload = raw.onUnload as PageHooks['onUnload']\n  }\n  return { component, hooks }\n}\n\nexport function normalizeComponentOptions(raw: ComponentRawOptions | undefined): ComponentOptions {\n  const component = { ...(raw ?? {}) } as ComponentOptions\n  component.methods = normalizeMethodBag(raw as Record<string, unknown> | undefined, RESERVED_COMPONENT_METHOD_KEYS) as ComponentOptions['methods']\n  if (raw?.lifetimes) {\n    component.lifetimes = cloneLifetimes(raw.lifetimes)\n  }\n  return component\n}\n"],"mappings":";AA6EA,MAAM,4CAA4B,IAAI,IAAI;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,mBAAG,IAV2B,IAAI;EAAC;EAAU;EAAW;EAAU;EAAU;CAAU,CAUjE;AACvB,CAAC;AACD,MAAM,iDAAiC,IAAI,IAAI;CAC7C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,eAAe,QAAmF;CACzG,OAAO,EACL,GAAG,OACL;AACF;AAEA,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,gBAAgB,OAAwC;CAC/D,OAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,mBACP,QACA,UACA;CACA,MAAM,UAAyC,CAAC;CAChD,MAAM,gBAAgB,SAAS,QAAQ,OAAO,IAAI,QAAQ,UAAU;CAEpE,IAAI,eACF;OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,GACrD,IAAI,gBAAgB,KAAK,GACvB,QAAQ,OAAO;CAEnB;CAGF,IAAI,QACF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;EACjD,IAAI,SAAS,IAAI,GAAG,GAClB;EAEF,IAAI,gBAAgB,KAAK,KAAK,QAAQ,SAAS,QAC7C,QAAQ,OAAO;CAEnB;CAEF,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAoF;CACvH,MAAM,YAAY,EAAE,GAAI,OAAO,CAAC,EAAG;CACnC,UAAU,UAAU,mBAAmB,KAA4C,yBAAyB;CAC5G,IAAI,KAAK,WACP,UAAU,YAAY,eAAe,IAAI,SAAS;CAEpD,MAAM,QAAmB,CAAC;CAC1B,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,YAAY,YAC1B,MAAM,UAAU,IAAI;CAEtB,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,WAAW,YACzB,MAAM,SAAS,IAAI;CAErB,IAAI,OAAO,KAAK,aAAa,YAC3B,MAAM,WAAW,IAAI;CAEvB,OAAO;EAAE;EAAW;CAAM;AAC5B;AAEA,SAAgB,0BAA0B,KAAwD;CAChG,MAAM,YAAY,EAAE,GAAI,OAAO,CAAC,EAAG;CACnC,UAAU,UAAU,mBAAmB,KAA4C,8BAA8B;CACjH,IAAI,KAAK,WACP,UAAU,YAAY,eAAe,IAAI,SAAS;CAEpD,OAAO;AACT"}

package/dist/runtime/polyfill/routeRuntime/result.mjs

@@ -0,0 +1,12 @@
+import { callMiniProgramAsyncFailure, callMiniProgramAsyncSuccess } from "../async.mjs";
+
+//#region src/runtime/polyfill/routeRuntime/result.ts
+function resolveRouteAction(action, options, succeeded, failureReason = "page not found") {
+	if (succeeded) return Promise.resolve(callMiniProgramAsyncSuccess(options, { errMsg: `${action}:ok` }));
+	const failure = callMiniProgramAsyncFailure(options, `${action}:fail ${failureReason}`);
+	return Promise.reject(failure);
+}
+
+//#endregion
+export { resolveRouteAction };
+//# sourceMappingURL=result.mjs.map

package/dist/runtime/polyfill/routeRuntime/result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/result.ts"],"sourcesContent":["import type { MiniProgramAsyncOptions, MiniProgramBaseResult } from '../types'\nimport {\n  callMiniProgramAsyncFailure,\n  callMiniProgramAsyncSuccess,\n} from '../async'\n\nexport function resolveRouteAction(\n  action: string,\n  options: MiniProgramAsyncOptions<MiniProgramBaseResult> | undefined,\n  succeeded: boolean,\n  failureReason = 'page not found',\n) {\n  if (succeeded) {\n    return Promise.resolve(callMiniProgramAsyncSuccess(options, {\n      errMsg: `${action}:ok`,\n    }))\n  }\n  const failure = callMiniProgramAsyncFailure(options, `${action}:fail ${failureReason}`)\n  return Promise.reject(failure)\n}\n"],"mappings":";;;AAMA,SAAgB,mBACd,QACA,SACA,WACA,gBAAgB,kBAChB;CACA,IAAI,WACF,OAAO,QAAQ,QAAQ,4BAA4B,SAAS,EAC1D,QAAQ,GAAG,OAAO,KACpB,CAAC,CAAC;CAEJ,MAAM,UAAU,4BAA4B,SAAS,GAAG,OAAO,QAAQ,eAAe;CACtF,OAAO,QAAQ,OAAO,OAAO;AAC/B"}

package/dist/runtime/polyfill/routeRuntime/scroll.mjs

@@ -0,0 +1,39 @@
+import { getAppContainer } from "../../appShell/container.mjs";
+
+//#region src/runtime/polyfill/routeRuntime/scroll.ts
+let activeEntry;
+let boundContainer;
+let scrollHandler;
+function getPageContainer() {
+	return getAppContainer();
+}
+function captureEntryScrollPosition(entry) {
+	if (!entry.active) return;
+	const container = getPageContainer();
+	if (container) entry.scrollTop = container.scrollTop;
+}
+function restoreEntryScrollPosition(entry) {
+	const container = getPageContainer();
+	if (container) container.scrollTop = entry.scrollTop ?? 0;
+}
+function setEntryScrollOwner(entry, active) {
+	if (active) {
+		activeEntry = entry;
+		return;
+	}
+	if (activeEntry === entry) activeEntry = void 0;
+}
+function recordActiveEntryScrollPosition() {
+	if (activeEntry) captureEntryScrollPosition(activeEntry);
+}
+function bindPageScrollOwner(container) {
+	if (boundContainer === container) return;
+	if (boundContainer && scrollHandler) boundContainer.removeEventListener("scroll", scrollHandler);
+	boundContainer = container;
+	scrollHandler = recordActiveEntryScrollPosition;
+	container.addEventListener("scroll", scrollHandler, { passive: true });
+}
+
+//#endregion
+export { bindPageScrollOwner, captureEntryScrollPosition, getPageContainer, recordActiveEntryScrollPosition, restoreEntryScrollPosition, setEntryScrollOwner };
+//# sourceMappingURL=scroll.mjs.map

package/dist/runtime/polyfill/routeRuntime/scroll.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.mjs","names":[],"sources":["../../../../src/runtime/polyfill/routeRuntime/scroll.ts"],"sourcesContent":["import type { PageStackEntry } from './options'\nimport { getAppContainer } from '../../appShell/container'\n\ntype ScrollContainer = HTMLElement & Pick<EventTarget, 'addEventListener' | 'removeEventListener'>\n\nlet activeEntry: PageStackEntry | undefined\nlet boundContainer: ScrollContainer | undefined\nlet scrollHandler: (() => void) | undefined\n\nexport function getPageContainer() {\n  return getAppContainer()\n}\n\nexport function captureEntryScrollPosition(entry: PageStackEntry) {\n  if (!entry.active) {\n    return\n  }\n  const container = getPageContainer()\n  if (container) {\n    entry.scrollTop = container.scrollTop\n  }\n}\n\nexport function restoreEntryScrollPosition(entry: PageStackEntry) {\n  const container = getPageContainer()\n  if (container) {\n    container.scrollTop = entry.scrollTop ?? 0\n  }\n}\n\nexport function setEntryScrollOwner(entry: PageStackEntry, active: boolean) {\n  if (active) {\n    activeEntry = entry\n    return\n  }\n  if (activeEntry === entry) {\n    activeEntry = undefined\n  }\n}\n\nexport function recordActiveEntryScrollPosition() {\n  if (activeEntry) {\n    captureEntryScrollPosition(activeEntry)\n  }\n}\n\nexport function bindPageScrollOwner(container: ScrollContainer) {\n  if (boundContainer === container) {\n    return\n  }\n  if (boundContainer && scrollHandler) {\n    boundContainer.removeEventListener('scroll', scrollHandler)\n  }\n  boundContainer = container\n  scrollHandler = recordActiveEntryScrollPosition\n  container.addEventListener('scroll', scrollHandler, { passive: true })\n}\n\nexport function disposePageScrollOwner() {\n  if (boundContainer && scrollHandler) {\n    boundContainer.removeEventListener('scroll', scrollHandler)\n  }\n  activeEntry = undefined\n  boundContainer = undefined\n  scrollHandler = undefined\n}\n"],"mappings":";;;AAKA,IAAI;AACJ,IAAI;AACJ,IAAI;AAEJ,SAAgB,mBAAmB;CACjC,OAAO,gBAAgB;AACzB;AAEA,SAAgB,2BAA2B,OAAuB;CAChE,IAAI,CAAC,MAAM,QACT;CAEF,MAAM,YAAY,iBAAiB;CACnC,IAAI,WACF,MAAM,YAAY,UAAU;AAEhC;AAEA,SAAgB,2BAA2B,OAAuB;CAChE,MAAM,YAAY,iBAAiB;CACnC,IAAI,WACF,UAAU,YAAY,MAAM,aAAa;AAE7C;AAEA,SAAgB,oBAAoB,OAAuB,QAAiB;CAC1E,IAAI,QAAQ;EACV,cAAc;EACd;CACF;CACA,IAAI,gBAAgB,OAClB,cAAc;AAElB;AAEA,SAAgB,kCAAkC;CAChD,IAAI,aACF,2BAA2B,WAAW;AAE1C;AAEA,SAAgB,oBAAoB,WAA4B;CAC9D,IAAI,mBAAmB,WACrB;CAEF,IAAI,kBAAkB,eACpB,eAAe,oBAAoB,UAAU,aAAa;CAE5D,iBAAiB;CACjB,gBAAgB;CAChB,UAAU,iBAAiB,UAAU,eAAe,EAAE,SAAS,KAAK,CAAC;AACvE"}