@monimesl/dot-service 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,4 @@
+# @monimesl/dot-service
+
+The logic layer. It owns every page's state, runs mutations and actions, and sends state changes
+to the webview.

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { a as Page, c as PageHost, d as PageOptions, f as State, h as definePage, i as Mutation, l as PageId, m as StateUpdate, n as ActionContext, o as PageContext, p as StateChanges, r as DeepReadonly, s as PageDefinition, t as Action, u as PageNavigation } from "./page-BfYJ-G-D.js";
+import { AppState, ColorScheme, DotEvent, DotEvent as DotEvent$1, DotHooks, DotHooks as DotHooks$1, EventEmitter, HostLayerMessages, LogicLayerMessages, MessageChannel, Navigation, PageHooks, PageLaunchOptions, PageLaunchOptions as PageLaunchOptions$1, PageState, PageState as PageState$1, SystemContext, SystemContext as SystemContext$1, Theme, Theme as Theme$1, Transport, Transport as Transport$1, UILayerMessages, createEvent, hostTransport } from "@monimesl/dot-core";
+//#region src/service.d.ts
+type ServiceChannel = MessageChannel<LogicLayerMessages, UILayerMessages & HostLayerMessages>;
+interface ServiceHooks {
+  launch(): void;
+  pageLoad(page: Page): void;
+  pageUnload(page: Page): void;
+  pageShow(page: Page): void;
+  pageHide(page: Page): void;
+  navigate(page: Page, navigation: Navigation): void;
+  event(page: Page, handler: string, event: DotEvent$1): void;
+  setState(page: Page, patch: PageState$1): void;
+  error(error: unknown, instanceId: number | undefined): void;
+}
+interface ServicePlugin {
+  readonly name: string;
+  setup(service: Service): void;
+}
+interface DotContext {
+  readonly theme: Theme$1;
+  readonly systemContext: SystemContext$1;
+  setTheme(theme: Theme$1): void;
+}
+interface DotDefinition {
+  readonly theme?: Theme$1;
+  readonly plugins?: readonly ServicePlugin[];
+  readonly pages: readonly [string, ...string[]];
+  readonly hooks?: Partial<DotHooks$1> & ThisType<DotContext>;
+}
+export declare function defineDot(dot: DotDefinition): DotDefinition;
+interface ServiceOptions {
+  transport: Transport$1;
+  dot?: Partial<DotDefinition>;
+  pages: Record<string, PageDefinition>;
+  strict?: boolean;
+}
+export declare class Service implements DotContext {
+  #private;
+  readonly channel: ServiceChannel;
+  readonly hooks: EventEmitter<ServiceHooks>;
+  constructor({ transport, pages, dot, strict }: ServiceOptions);
+  use(plugin: ServicePlugin): this;
+  start(): () => void;
+  get theme(): Theme$1;
+  get systemContext(): SystemContext$1;
+  setTheme(theme: Theme$1): void;
+  getPage(instanceId: number): Page;
+  loadPage(instanceId: number, id: string, options?: PageLaunchOptions$1): Page;
+  unloadPage(instanceId: number): void;
+  reportError(work: Promise<void>, instanceId?: number): void;
+}
+//#endregion
+//#region src/plugins/logger.d.ts
+/**
+ * Logs page lifecycle, events, state changes, and errors.
+ */
+export declare function logger(options?: {
+  log: (...args: unknown[]) => void;
+  logError: (...args: unknown[]) => void;
+}): ServicePlugin;
+//#endregion
+//#region src/index.d.ts
+export declare function createService(options: ServiceOptions): Service;
+//#endregion
+export { type Action, type ActionContext, type AppState, type ColorScheme, type DeepReadonly, type DotContext, type DotDefinition, type DotEvent, type DotHooks, type Mutation, Page, type PageContext, type PageDefinition, type PageHooks, type PageHost, type PageId, type PageLaunchOptions, type PageNavigation, type PageOptions, type PageState, type ServiceChannel, type ServiceHooks, type ServiceOptions, type ServicePlugin, type State, type StateChanges, type StateUpdate, type SystemContext, type Theme, type Transport, createEvent, definePage, hostTransport };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/service.ts","../src/plugins/logger.ts","../src/index.ts"],"mappings":";;;KA0BY,iBAAiB,eAC3B,oBACA,kBAAkB;UAGH;EACf;EAEA,SAAS,MAAM;EAEf,WAAW,MAAM;EAEjB,SAAS,MAAM;EAEf,SAAS,MAAM;EAGf,SAAS,MAAM,MAAM,YAAY;EAGjC,MAAM,MAAM,MAAM,iBAAiB,OAAO;EAG1C,SAAS,MAAM,MAAM,OAAO;EAG5B,MAAM,gBAAgB;;UAGP;WACN;EAET,MAAM,SAAS;;UAGA;WACN,OAAO;WACP,eAAe;EAExB,SAAS,OAAO;;UAGD;WACN,QAAQ;WACR,mBAAmB;WACnB;WACA,QAAQ,QAAQ,cAAY,SAAS;;wBAGhC,UAAU,KAAK,gBAAgB;UAI9B;EACf,WAAW;EACX,MAAM,QAAQ;EACd,OAAO,eAAe;EACtB;;qBAIW,mBAAmB;;WACrB,SAAS;WACT,OAAK,aAAA;EAUF,cAAE,WAAW,OAAO,KAAU,UAAkB;EAsC5D,IAAI,QAAQ;EAKZ;MAcI,SAAS;MAIT,iBAAiB;EAIrB,SAAS,OAAO;EAKhB,QAAQ,qBAAqB;EAQ7B,SAAS,oBAAoB,YAAY,UAAS,sBAAyB;EA4B3E,WAAW;EAmBX,YAAY,MAAM,eAAe;;;;;;;wBC3NnB,OACd;EACE,SAAS;EACT,cAAc;IAKf;;;wBC8Ba,cAAc,SAAS,iBAAiB"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import { i as definePage, n as defineDot, r as Page, t as Service } from "./service-dAFmZ_Mh.js";
+import { createEvent, hostTransport } from "@monimesl/dot-core";
+//#region src/plugins/logger.ts
+/**
+* Logs page lifecycle, events, state changes, and errors.
+*/
+function logger(options = {
+	log: console.debug,
+	logError: console.error
+}) {
+	const { log, logError } = options;
+	return {
+		name: "logger",
+		setup({ hooks }) {
+			hooks.on("pageLoad", (page) => log(`[dot] load ${page.id}#${page.instanceId}`, page.state));
+			hooks.on("pageUnload", (page) => log(`[dot] unload ${page.id}#${page.instanceId}`));
+			hooks.on("event", (page, handler, event) => log(`[dot] ${page.id} ${handler}`, event));
+			hooks.on("navigate", (page, navigation) => log(`[dot] ${page.id} navigate`, navigation));
+			hooks.on("setState", (page, patch) => log(`[dot] ${page.id} setState`, patch));
+			hooks.on("error", (error) => logError("[dot] error", error));
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+function createService(options) {
+	const service = new Service(options);
+	service.start();
+	return service;
+}
+//#endregion
+export { Page, Service, createEvent, createService, defineDot, definePage, hostTransport, logger };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/plugins/logger.ts","../src/index.ts"],"sourcesContent":["import type { ServicePlugin } from '../service';\n\n/**\n * Logs page lifecycle, events, state changes, and errors.\n */\nexport function logger(\n  options: {\n    log: (...args: unknown[]) => void;\n    logError: (...args: unknown[]) => void;\n  } = {\n    log: console.debug,\n    logError: console.error,\n  },\n): ServicePlugin {\n  const { log, logError } = options;\n  return {\n    name: 'logger',\n    setup({ hooks }) {\n      hooks.on('pageLoad', (page) => log(`[dot] load ${page.id}#${page.instanceId}`, page.state));\n      hooks.on('pageUnload', (page) => log(`[dot] unload ${page.id}#${page.instanceId}`));\n      hooks.on('event', (page, handler, event) => log(`[dot] ${page.id} ${handler}`, event));\n      hooks.on('navigate', (page, navigation) => log(`[dot] ${page.id} navigate`, navigation));\n      hooks.on('setState', (page, patch) => log(`[dot] ${page.id} setState`, patch));\n      hooks.on('error', (error) => logError('[dot] error', error));\n    },\n  };\n}\n","import type { ServiceOptions } from './service';\nimport { Service } from './service';\n\nexport { Page, definePage } from './page';\nexport type {\n  Action,\n  ActionContext,\n  DeepReadonly,\n  Mutation,\n  PageContext,\n  PageDefinition,\n  PageHost,\n  PageId,\n  PageNavigation,\n  PageOptions,\n  State,\n  StateChanges,\n  StateUpdate,\n} from './page';\nexport { Service, defineDot } from './service';\nexport type {\n  DotContext,\n  DotDefinition,\n  ServiceHooks,\n  ServiceOptions,\n  ServicePlugin,\n  ServiceChannel,\n} from './service';\nexport { logger } from './plugins/logger';\nexport { createEvent, hostTransport } from '@monimesl/dot-core';\nexport type {\n  ColorScheme,\n  DotEvent,\n  DotHooks,\n  PageState,\n  PageHooks,\n  PageLaunchOptions,\n  AppState,\n  SystemContext,\n  Theme,\n  Transport,\n} from '@monimesl/dot-core';\n\nexport function createService(options: ServiceOptions): Service {\n  const service = new Service(options);\n  service.start();\n  return service;\n}\n"],"mappings":";;;;;;AAKA,SAAgB,OACd,UAGI;CACF,KAAK,QAAQ;CACb,UAAU,QAAQ;AACpB,GACe;CACf,MAAM,EAAE,KAAK,aAAa;CAC1B,OAAO;EACL,MAAM;EACN,MAAM,EAAE,SAAS;GACf,MAAM,GAAG,aAAa,SAAS,IAAI,cAAc,KAAK,GAAG,GAAG,KAAK,cAAc,KAAK,KAAK,CAAC;GAC1F,MAAM,GAAG,eAAe,SAAS,IAAI,gBAAgB,KAAK,GAAG,GAAG,KAAK,YAAY,CAAC;GAClF,MAAM,GAAG,UAAU,MAAM,SAAS,UAAU,IAAI,SAAS,KAAK,GAAG,GAAG,WAAW,KAAK,CAAC;GACrF,MAAM,GAAG,aAAa,MAAM,eAAe,IAAI,SAAS,KAAK,GAAG,YAAY,UAAU,CAAC;GACvF,MAAM,GAAG,aAAa,MAAM,UAAU,IAAI,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC;GAC7E,MAAM,GAAG,UAAU,UAAU,SAAS,eAAe,KAAK,CAAC;EAC7D;CACF;AACF;;;ACiBA,SAAgB,cAAc,SAAkC;CAC9D,MAAM,UAAU,IAAI,QAAQ,OAAO;CACnC,QAAQ,MAAM;CACd,OAAO;AACT"}

package/dist/page-BfYJ-G-D.d.ts

@@ -0,0 +1,75 @@
+import { DotEvent, Navigation, PageHooks, PageLaunchOptions, PageState } from "@monimesl/dot-core";
+//#region src/page.d.ts
+declare global {
+  interface DotPageIds {}
+}
+type PageId = [keyof DotPageIds] extends [never] ? string : Extract<keyof DotPageIds, string>;
+interface PageNavigation {
+  push(page: PageId, options?: PageLaunchOptions): void;
+  replace(page: PageId, options?: PageLaunchOptions): void;
+  reset(page: PageId, options?: PageLaunchOptions): void;
+  back(delta?: number): void;
+}
+type DeepReadonly<T> = T extends ((...args: never[]) => unknown) ? T : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]>; } : T;
+type State<S> = DeepReadonly<S>;
+type StateChanges<S> = Partial<State<S>>;
+type StateUpdate<S> = StateChanges<S> | ((state: State<S>) => StateChanges<S> | undefined);
+type Mutation<S> = {
+  mutation(state: State<S>, event: DotEvent): StateChanges<S> | undefined;
+}['mutation'];
+type Action<S> = {
+  action(state: State<S>, event: DotEvent): void | Promise<void>;
+}['action'];
+type EventArgs<F> = F extends ((state: never, ...rest: infer R) => unknown) ? R : never;
+interface PageContext<S extends PageState, Mu, Ac> {
+  readonly id: string;
+  readonly instanceId: number;
+  readonly state: State<S>;
+  setState(update: StateUpdate<S>): void;
+  readonly mutations: { readonly [K in keyof Mu]: (...event: EventArgs<Mu[K]>) => void; };
+  readonly actions: { readonly [K in keyof Ac]: (...event: EventArgs<Ac[K]>) => Promise<void>; };
+}
+interface ActionContext<S extends PageState, Mu, Ac> extends PageContext<S, Mu, Ac> {
+  readonly navigation: PageNavigation;
+}
+interface PageOptions<S extends PageState, Mu, Ac> {
+  id?: string;
+  initialState: S;
+  hooks?: Partial<PageHooks> & ThisType<PageContext<S, Mu, Ac>>;
+  mutations?: Mu & ThisType<void>;
+  actions?: Ac & ThisType<ActionContext<S, Mu, Ac>>;
+}
+interface PageDefinition<S extends PageState = PageState> {
+  readonly id?: string;
+  readonly initialState: S;
+  readonly hooks?: Partial<PageHooks>;
+  readonly mutations?: Readonly<Record<string, Mutation<S>>>;
+  readonly actions?: Readonly<Record<string, Action<S>>>;
+}
+declare function definePage<S extends PageState, Mu extends Record<string, Mutation<S>>, Ac extends Record<string, Action<S>>>(options: PageOptions<S, Mu, Ac>): PageDefinition<S>;
+interface PageHost {
+  commit(page: Page, patch: PageState): void;
+  navigate(page: Page, navigation: Navigation): void;
+  readonly strict?: boolean;
+}
+type Mutations<S> = Record<string, Mutation<S>>;
+type Actions<S> = Record<string, Action<S>>;
+declare class Page<S extends PageState = PageState> {
+  #private;
+  readonly id: string;
+  readonly instanceId: number;
+  readonly context: PageContext<S, Mutations<S>, Actions<S>>;
+  readonly actionContext: ActionContext<S, Mutations<S>, Actions<S>>;
+  constructor(instanceId: number, id: string, definition: PageDefinition<S>, host: PageHost);
+  get state(): State<S>;
+  handlers(): string[];
+  setState(update: StateUpdate<S>): void;
+  mutate(name: string, event?: DotEvent): void;
+  act(name: string, event?: DotEvent): Promise<void>;
+  dispatch(name: string, event: DotEvent): Promise<void>;
+  lifecycle<K extends keyof PageHooks>(hookName: K, ...args: Parameters<PageHooks[K]>): Promise<void>;
+  close(): void;
+}
+//#endregion
+export { Page as a, PageHost as c, PageOptions as d, State as f, definePage as h, Mutation as i, PageId as l, StateUpdate as m, ActionContext as n, PageContext as o, StateChanges as p, DeepReadonly as r, PageDefinition as s, Action as t, PageNavigation as u };
+//# sourceMappingURL=page-BfYJ-G-D.d.ts.map

package/dist/page-BfYJ-G-D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-BfYJ-G-D.d.ts","names":[],"sources":["../src/page.ts"],"mappings":";;QASQ;YAEI;;KAKA,gBAAgB,uCAExB,cAAc;UAED;EACf,KAAK,MAAM,QAAQ,UAAU;EAE7B,QAAQ,MAAM,QAAQ,UAAU;EAEhC,MAAM,MAAM,QAAQ,UAAU;EAE9B,KAAK;;KAGK,aAAa,KAAK,eAAc,6BACxC,IACA,+BACc,WAAW,IAAI,aAAa,EAAE,SAC1C;KAEM,MAAM,KAAK,aAAa;KAExB,aAAa,KAAK,QAAQ,MAAM;KAEhC,YAAY,KAAK,aAAa,OAAO,OAAO,MAAM,OAAO,aAAa;KAItE,SAAS;EACnB,SAAS,OAAO,MAAM,IAAI,OAAO,WAAW,aAAa;;KAG/C,OAAO;EACjB,OAAO,OAAO,MAAM,IAAI,OAAO,kBAAkB;;KAI9C,UAAU,KAAK,YAAW,iBAAiB,YAAY,iBAAgB;UAE3D,YAAY,UAAU,WAAW,IAAI;WAC3C;WACA;WACA,OAAO,MAAM;EAEtB,SAAS,QAAQ,YAAY;WAEpB,uBAAuB,WAAW,SAAS,OAAO,UAAU,GAAG;WAC/D,qBAAqB,WAAW,SAAS,OAAO,UAAU,GAAG,QAAQ;;UAG/D,cAAc,UAAU,WAAW,IAAI,YAAY,YAAY,GAAG,IAAI;WAC5E,YAAY;;UAGN,YAAY,UAAU,WAAW,IAAI;EACpD;EACA,cAAc;EACd,QAAQ,QAAQ,aAAa,SAAS,YAAY,GAAG,IAAI;EACzD,YAAY,KAAK;EACjB,UAAU,KAAK,SAAS,cAAc,GAAG,IAAI;;UAG9B,eAAe,UAAU,YAAY;WAC3C;WACA,cAAc;WACd,QAAQ,QAAQ;WAChB,YAAY,SAAS,eAAe,SAAS;WAC7C,UAAU,SAAS,eAAe,OAAO;;iBAGpC,WACd,UAAU,WACV,WAAW,eAAe,SAAS,KACnC,WAAW,eAAe,OAAO,KACjC,SAAS,YAAY,GAAG,IAAI,MAAM,eAAe;UAIlC;EACf,OAAO,MAAM,MAAM,OAAO;EAE1B,SAAS,MAAM,MAAM,YAAY;WAExB;;KAGN,UAAU,KAAK,eAAe,SAAS;KACvC,QAAQ,KAAK,eAAe,OAAO;cAI3B,KAAK,UAAU,YAAY;;WAC7B;WACA;WACA,SAAS,YAAY,GAAG,UAAU,IAAI,QAAQ;WAC9C,eAAe,cAAc,GAAG,UAAU,IAAI,QAAQ;EAOnD,YAAA,oBAAoB,YAAY,YAAY,eAAe,IAAI,MAAM;MA2B7E,SAAS,MAAM;EAInB;EAKA,SAAS,QAAQ,YAAY;EAqB7B,OAAO,cAAc,QAAQ;EAQvB,IAAI,cAAc,QAAQ,WAAW;EAS3C,SAAS,cAAc,OAAO,WAAW;EAanC,UAAU,gBAAgB,WAC9B,UAAU,MACP,MAAM,WAAW,UAAU,MAC7B;EASH"}

package/dist/service-dAFmZ_Mh.js

@@ -0,0 +1,340 @@
+import { DEFAULT_SYSTEM_CONTEXT, EventEmitter, HostError, MAX_STACK_DEPTH, MessageChannel, applyChanges, connectHost, createHostRequest } from "@monimesl/dot-core";
+//#region src/host-calls.ts
+var HostCalls = class {
+	#channel;
+	#waiting = /* @__PURE__ */ new Map();
+	#nextId = 1;
+	constructor(channel) {
+		this.#channel = channel;
+		channel.handle("hostResult", (result) => this.#settle(result));
+	}
+	call(method, params, options) {
+		const id = this.#nextId++;
+		const promise = new Promise((resolve, reject) => {
+			this.#waiting.set(id, {
+				method,
+				resolve,
+				reject
+			});
+		});
+		const message = {
+			id,
+			method,
+			params
+		};
+		if (options.timeout !== void 0) message.timeout = options.timeout;
+		this.#channel.send("hostCall", message);
+		return createHostRequest(promise, () => this.#cancel(id));
+	}
+	#cancel(id) {
+		const call = this.#waiting.get(id);
+		if (!call) return;
+		this.#waiting.delete(id);
+		this.#channel.send("hostCancel", { id });
+		call.reject(new HostError("cancelled", `"${call.method}" was cancelled`));
+	}
+	#settle(result) {
+		const call = this.#waiting.get(result.id);
+		if (!call) return;
+		this.#waiting.delete(result.id);
+		if ("error" in result) call.reject(new HostError(result.error.code, result.error.message));
+		else call.resolve(result.value);
+	}
+};
+//#endregion
+//#region src/page.ts
+function definePage(options) {
+	return options;
+}
+var Page = class {
+	id;
+	instanceId;
+	context;
+	actionContext;
+	#definition;
+	#host;
+	#state;
+	#closed = false;
+	#previousHook = Promise.resolve();
+	constructor(instanceId, id, definition, host) {
+		this.id = id;
+		this.instanceId = instanceId;
+		this.#definition = definition;
+		this.#host = host;
+		this.#state = this.#freeze(JSON.parse(JSON.stringify(definition.initialState)));
+		const { mutations = {}, actions = {} } = definition;
+		const clash = Object.keys(mutations).find((name) => name in actions);
+		if (clash) throw new Error(`Page "${id}": "${clash}" is both a mutation and an action`);
+		const mutationCalls = mapNames(mutations, (name) => (event) => this.mutate(name, event));
+		const actionCalls = mapNames(actions, (name) => (event) => this.act(name, event));
+		this.context = new HookContext(this, mutationCalls, actionCalls);
+		this.actionContext = new HandlerContext(this, mutationCalls, actionCalls, this.#createNavigation());
+	}
+	get state() {
+		return this.#state;
+	}
+	handlers() {
+		const { mutations = {}, actions = {} } = this.#definition;
+		return [...Object.keys(mutations), ...Object.keys(actions)];
+	}
+	setState(update) {
+		if (this.#closed) return;
+		const changes = typeof update === "function" ? update(this.#state) : update;
+		if (changes === void 0) return;
+		const next = applyChanges(this.#state, changes);
+		const patch = {};
+		for (const key of Object.keys(next)) if (next[key] !== this.#state[key]) patch[key] = next[key];
+		this.#state = this.#freeze(next);
+		if (Object.keys(patch).length > 0) this.#host.commit(this, patch);
+	}
+	mutate(name, event) {
+		const mutation = this.#definition.mutations?.[name];
+		if (!mutation) throw new Error(`Page "${this.id}" has no mutation "${name}"`);
+		this.#runMutation(mutation, event);
+	}
+	async act(name, event) {
+		const action = this.#definition.actions?.[name];
+		if (!action) throw new Error(`Page "${this.id}" has no action "${name}"`);
+		await this.#runAction(action, event);
+	}
+	dispatch(name, event) {
+		const action = this.#definition.actions?.[name];
+		if (action) return this.#runAction(action, event);
+		const mutation = this.#definition.mutations?.[name];
+		if (!mutation) throw new Error(`Page "${this.id}" has no mutation or action "${name}"`);
+		this.#runMutation(mutation, event);
+		return Promise.resolve();
+	}
+	async lifecycle(hookName, ...args) {
+		const hook = this.#definition.hooks?.[hookName];
+		const run = this.#previousHook.then(() => hook?.call(this.context, ...args));
+		this.#previousHook = run.catch(() => {});
+		await run;
+	}
+	close() {
+		this.#closed = true;
+	}
+	#runMutation(mutation, event) {
+		this.setState((state) => mutation(state, event));
+	}
+	async #runAction(action, event) {
+		await action.call(this.actionContext, this.#state, event);
+	}
+	#createNavigation() {
+		return {
+			push: (page, options = {}) => this.#navigate({
+				action: "push",
+				page,
+				options
+			}),
+			replace: (page, options = {}) => this.#navigate({
+				action: "replace",
+				page,
+				options
+			}),
+			reset: (page, options = {}) => this.#navigate({
+				action: "reset",
+				page,
+				options
+			}),
+			back: (delta = 1) => this.#navigate({
+				action: "back",
+				delta
+			})
+		};
+	}
+	#navigate(navigation) {
+		if (!this.#closed) this.#host.navigate(this, navigation);
+	}
+	#freeze(state) {
+		return this.#host.strict ? deepFreeze(state) : state;
+	}
+};
+var HookContext = class {
+	id;
+	instanceId;
+	mutations;
+	actions;
+	#page;
+	constructor(page, mutations, actions) {
+		this.id = page.id;
+		this.instanceId = page.instanceId;
+		this.mutations = mutations;
+		this.actions = actions;
+		this.#page = page;
+	}
+	get state() {
+		return this.#page.state;
+	}
+	setState = (update) => {
+		this.#page.setState(update);
+	};
+};
+var HandlerContext = class extends HookContext {
+	navigation;
+	constructor(page, mutations, actions, navigation) {
+		super(page, mutations, actions);
+		this.navigation = navigation;
+	}
+};
+function mapNames(record, create) {
+	return Object.fromEntries(Object.keys(record).map((name) => [name, create(name)]));
+}
+function deepFreeze(value) {
+	if (typeof value === "object" && value !== null && !Object.isFrozen(value)) {
+		Object.freeze(value);
+		Object.values(value).forEach(deepFreeze);
+	}
+	return value;
+}
+//#endregion
+//#region src/service.ts
+function defineDot(dot) {
+	return dot;
+}
+var Service = class {
+	channel;
+	hooks = new EventEmitter();
+	#definitions;
+	#pages = /* @__PURE__ */ new Map();
+	#dot;
+	#strict;
+	#theme;
+	#systemContext = DEFAULT_SYSTEM_CONTEXT;
+	#stack = {
+		pages: [],
+		limit: MAX_STACK_DEPTH
+	};
+	#hostCalls;
+	constructor({ transport, pages, dot = {}, strict = false }) {
+		this.channel = new MessageChannel(transport);
+		this.#hostCalls = new HostCalls(this.channel);
+		this.#definitions = pages;
+		this.#dot = dot;
+		this.#strict = strict;
+		this.#theme = dot.theme ?? {};
+		this.channel.handle("connect", () => this.channel.send("setTheme", { theme: this.#theme }));
+		this.channel.handle("syncStack", (stack) => {
+			this.#stack = stack;
+		});
+		this.channel.handle("syncSystemContext", (context) => {
+			this.#systemContext = context;
+		});
+		this.channel.handle("load", ({ instanceId, page, options }) => this.loadPage(instanceId, page, options));
+		this.channel.handle("unload", ({ instanceId }) => this.unloadPage(instanceId));
+		this.channel.handle("show", ({ instanceId }) => {
+			const page = this.getPage(instanceId);
+			this.hooks.emit("pageShow", page);
+			this.reportError(page.lifecycle("onShow"), instanceId);
+		});
+		this.channel.handle("hide", ({ instanceId }) => {
+			const page = this.getPage(instanceId);
+			this.hooks.emit("pageHide", page);
+			this.reportError(page.lifecycle("onHide"), instanceId);
+		});
+		this.channel.handle("event", ({ instanceId, handler, event }) => {
+			const page = this.getPage(instanceId);
+			this.hooks.emit("event", page, handler, event);
+			this.reportError(page.dispatch(handler, event), instanceId);
+		});
+		dot.plugins?.forEach((plugin) => this.use(plugin));
+	}
+	use(plugin) {
+		plugin.setup(this);
+		return this;
+	}
+	start() {
+		const stopListening = this.channel.listen((error, message) => {
+			this.#reportError(error, instanceIdOf(message));
+		});
+		connectHost((method, params, options) => this.#hostCalls.call(method, params, options));
+		this.hooks.emit("launch");
+		this.reportError(this.#runLaunchHook());
+		return () => {
+			stopListening();
+			connectHost(null);
+		};
+	}
+	get theme() {
+		return this.#theme;
+	}
+	get systemContext() {
+		return this.#systemContext;
+	}
+	setTheme(theme) {
+		this.#theme = theme;
+		this.channel.send("setTheme", { theme });
+	}
+	getPage(instanceId) {
+		const page = this.#pages.get(instanceId);
+		if (!page) throw new Error(`Page instance ${instanceId} is not loaded`);
+		return page;
+	}
+	loadPage(instanceId, id, options = {}) {
+		const page = new Page(instanceId, id, this.#definition(id), {
+			commit: (page, patch) => {
+				this.hooks.emit("setState", page, patch);
+				this.channel.send("setPageState", {
+					instanceId: page.instanceId,
+					patchState: patch
+				});
+			},
+			navigate: (page, navigation) => {
+				if (navigation.action !== "back") this.#definition(navigation.page);
+				const { pages, limit } = this.#stack;
+				if (navigation.action === "push" && pages.length >= limit) throw new Error(`Cannot open "${navigation.page}": ${limit} pages are already open. Use replace or back.`);
+				this.hooks.emit("navigate", page, navigation);
+				this.channel.send("navigate", {
+					...navigation,
+					from: page.instanceId
+				});
+			},
+			strict: this.#strict
+		});
+		this.#pages.set(instanceId, page);
+		this.channel.send("initPageState", {
+			instanceId,
+			state: page.state
+		});
+		this.hooks.emit("pageLoad", page);
+		this.reportError(page.lifecycle("onLoad", options), instanceId);
+		return page;
+	}
+	unloadPage(instanceId) {
+		const page = this.#pages.get(instanceId);
+		if (!page) return;
+		this.#pages.delete(instanceId);
+		page.close();
+		this.reportError(page.lifecycle("onUnload"), instanceId);
+		this.hooks.emit("pageUnload", page);
+	}
+	#definition(id) {
+		const definition = this.#definitions[id];
+		if (!definition) throw new Error(`Unknown page "${id}"`);
+		return definition;
+	}
+	reportError(work, instanceId) {
+		work.catch((error) => {
+			this.#reportError(error, instanceId);
+		});
+	}
+	async #runLaunchHook() {
+		await this.#dot.hooks?.onLaunch?.call(this);
+	}
+	#reportError(error, instanceId) {
+		this.hooks.emit("error", error, instanceId);
+		const reason = error instanceof Error ? error : new Error(String(error));
+		this.#dot.hooks?.onError?.call(this, reason);
+		const report = { message: reason.message };
+		if (instanceId !== void 0) report.instanceId = instanceId;
+		this.channel.send("error", report);
+	}
+};
+function instanceIdOf(message) {
+	const payload = message.payload;
+	if (typeof payload?.instanceId === "number") return payload.instanceId;
+}
+//#endregion
+export { definePage as i, defineDot as n, Page as r, Service as t };
+
+//# sourceMappingURL=service-dAFmZ_Mh.js.map

package/dist/service-dAFmZ_Mh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-dAFmZ_Mh.js","names":[],"sources":["../src/host-calls.ts","../src/page.ts","../src/service.ts"],"sourcesContent":["import type {\n  HostCallOptions,\n  HostRequest,\n  HostResult,\n  LogicLayerMessages,\n} from '@monimesl/dot-core';\nimport { HostError, createHostRequest } from '@monimesl/dot-core';\n\nimport type { ServiceChannel } from './service';\n\ninterface WaitingCall {\n  readonly method: string;\n  resolve(value: unknown): void;\n  reject(error: HostError): void;\n}\n\n// Calls to the host that are waiting for their `hostResult`.\nexport class HostCalls {\n  readonly #channel: ServiceChannel;\n  readonly #waiting = new Map<number, WaitingCall>();\n  #nextId = 1;\n\n  constructor(channel: ServiceChannel) {\n    this.#channel = channel;\n    channel.handle('hostResult', (result) => this.#settle(result));\n  }\n\n  call(method: string, params: unknown, options: HostCallOptions): HostRequest<unknown> {\n    const id = this.#nextId++;\n    const promise = new Promise<unknown>((resolve, reject) => {\n      this.#waiting.set(id, { method, resolve, reject });\n    });\n    const message: LogicLayerMessages['hostCall'] = { id, method, params };\n    if (options.timeout !== undefined) {\n      message.timeout = options.timeout;\n    }\n    this.#channel.send('hostCall', message);\n    return createHostRequest(promise, () => this.#cancel(id));\n  }\n\n  #cancel(id: number): void {\n    const call = this.#waiting.get(id);\n    if (!call) {\n      return;\n    }\n    this.#waiting.delete(id);\n    this.#channel.send('hostCancel', { id });\n    call.reject(new HostError('cancelled', `\"${call.method}\" was cancelled`));\n  }\n\n  #settle(result: HostResult): void {\n    const call = this.#waiting.get(result.id);\n    // A call cancelled here may still get the host's late answer, which no one wants any more.\n    if (!call) {\n      return;\n    }\n    this.#waiting.delete(result.id);\n    if ('error' in result) {\n      call.reject(new HostError(result.error.code, result.error.message));\n    } else {\n      call.resolve(result.value);\n    }\n  }\n}\n","import type {\n  DotEvent,\n  Navigation,\n  PageHooks,\n  PageLaunchOptions,\n  PageState,\n} from '@monimesl/dot-core';\nimport { applyChanges } from '@monimesl/dot-core';\n\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n  interface DotPageIds {}\n}\n\n// Any string until `.dot/pages.d.ts` lists the dot's pages; the brackets stop TypeScript from\n// applying the condition to each id separately.\nexport type PageId = [keyof DotPageIds] extends [never]\n  ? string\n  : Extract<keyof DotPageIds, string>;\n\nexport interface PageNavigation {\n  push(page: PageId, options?: PageLaunchOptions): void;\n\n  replace(page: PageId, options?: PageLaunchOptions): void;\n\n  reset(page: PageId, options?: PageLaunchOptions): void;\n\n  back(delta?: number): void;\n}\n\nexport type DeepReadonly<T> = T extends (...args: never[]) => unknown\n  ? T\n  : T extends object\n    ? { readonly [K in keyof T]: DeepReadonly<T[K]> }\n    : T;\n\nexport type State<S> = DeepReadonly<S>;\n\nexport type StateChanges<S> = Partial<State<S>>;\n\nexport type StateUpdate<S> = StateChanges<S> | ((state: State<S>) => StateChanges<S> | undefined);\n\n// Declared as methods, whose parameters TypeScript checks loosely, so a handler may narrow its\n// event, e.g. `(state, event: DotEvent<{ size: number }>) => ...`.\nexport type Mutation<S> = {\n  mutation(state: State<S>, event: DotEvent): StateChanges<S> | undefined;\n}['mutation'];\n\nexport type Action<S> = {\n  action(state: State<S>, event: DotEvent): void | Promise<void>;\n}['action'];\n\n// A handler's parameters after `state`: what calling it from another handler takes.\ntype EventArgs<F> = F extends (state: never, ...rest: infer R) => unknown ? R : never;\n\nexport interface PageContext<S extends PageState, Mu, Ac> {\n  readonly id: string;\n  readonly instanceId: number;\n  readonly state: State<S>;\n\n  setState(update: StateUpdate<S>): void;\n\n  readonly mutations: { readonly [K in keyof Mu]: (...event: EventArgs<Mu[K]>) => void };\n  readonly actions: { readonly [K in keyof Ac]: (...event: EventArgs<Ac[K]>) => Promise<void> };\n}\n\nexport interface ActionContext<S extends PageState, Mu, Ac> extends PageContext<S, Mu, Ac> {\n  readonly navigation: PageNavigation;\n}\n\nexport interface PageOptions<S extends PageState, Mu, Ac> {\n  id?: string;\n  initialState: S;\n  hooks?: Partial<PageHooks> & ThisType<PageContext<S, Mu, Ac>>;\n  mutations?: Mu & ThisType<void>;\n  actions?: Ac & ThisType<ActionContext<S, Mu, Ac>>;\n}\n\nexport interface PageDefinition<S extends PageState = PageState> {\n  readonly id?: string;\n  readonly initialState: S;\n  readonly hooks?: Partial<PageHooks>;\n  readonly mutations?: Readonly<Record<string, Mutation<S>>>;\n  readonly actions?: Readonly<Record<string, Action<S>>>;\n}\n\nexport function definePage<\n  S extends PageState,\n  Mu extends Record<string, Mutation<S>>,\n  Ac extends Record<string, Action<S>>,\n>(options: PageOptions<S, Mu, Ac>): PageDefinition<S> {\n  return options;\n}\n\nexport interface PageHost {\n  commit(page: Page, patch: PageState): void;\n\n  navigate(page: Page, navigation: Navigation): void;\n\n  readonly strict?: boolean;\n}\n\ntype Mutations<S> = Record<string, Mutation<S>>;\ntype Actions<S> = Record<string, Action<S>>;\ntype MutationCalls<S extends PageState> = PageContext<S, Mutations<S>, Actions<S>>['mutations'];\ntype ActionCalls<S extends PageState> = PageContext<S, Mutations<S>, Actions<S>>['actions'];\n\nexport class Page<S extends PageState = PageState> {\n  readonly id: string;\n  readonly instanceId: number;\n  readonly context: PageContext<S, Mutations<S>, Actions<S>>;\n  readonly actionContext: ActionContext<S, Mutations<S>, Actions<S>>;\n  readonly #definition: PageDefinition<S>;\n  readonly #host: PageHost;\n  #state: State<S>;\n  #closed = false;\n  #previousHook: Promise<unknown> = Promise.resolve();\n\n  constructor(instanceId: number, id: string, definition: PageDefinition<S>, host: PageHost) {\n    this.id = id;\n    this.instanceId = instanceId;\n    this.#definition = definition;\n    this.#host = host;\n    this.#state = this.#freeze(JSON.parse(JSON.stringify(definition.initialState)) as State<S>);\n\n    const { mutations = {}, actions = {} } = definition;\n    const clash = Object.keys(mutations).find((name) => name in actions);\n    if (clash) {\n      throw new Error(`Page \"${id}\": \"${clash}\" is both a mutation and an action`);\n    }\n\n    const mutationCalls = mapNames(\n      mutations,\n      (name) => (event?: DotEvent) => this.mutate(name, event),\n    );\n    const actionCalls = mapNames(actions, (name) => (event?: DotEvent) => this.act(name, event));\n    this.context = new HookContext(this, mutationCalls, actionCalls);\n    this.actionContext = new HandlerContext(\n      this,\n      mutationCalls,\n      actionCalls,\n      this.#createNavigation(),\n    );\n  }\n\n  get state(): State<S> {\n    return this.#state;\n  }\n\n  handlers(): string[] {\n    const { mutations = {}, actions = {} } = this.#definition;\n    return [...Object.keys(mutations), ...Object.keys(actions)];\n  }\n\n  setState(update: StateUpdate<S>): void {\n    if (this.#closed) {\n      return;\n    }\n    const changes = typeof update === 'function' ? update(this.#state) : update;\n    if (changes === undefined) {\n      return;\n    }\n    const next = applyChanges(this.#state, changes);\n    const patch: PageState = {};\n    for (const key of Object.keys(next) as (keyof State<S> & string)[]) {\n      if (next[key] !== this.#state[key]) {\n        patch[key] = next[key];\n      }\n    }\n    this.#state = this.#freeze(next);\n    if (Object.keys(patch).length > 0) {\n      this.#host.commit(this as Page, patch);\n    }\n  }\n\n  mutate(name: string, event?: DotEvent): void {\n    const mutation = this.#definition.mutations?.[name];\n    if (!mutation) {\n      throw new Error(`Page \"${this.id}\" has no mutation \"${name}\"`);\n    }\n    this.#runMutation(mutation, event);\n  }\n\n  async act(name: string, event?: DotEvent): Promise<void> {\n    const action = this.#definition.actions?.[name];\n    if (!action) {\n      throw new Error(`Page \"${this.id}\" has no action \"${name}\"`);\n    }\n    await this.#runAction(action, event);\n  }\n\n  // Runs the mutation or action named by a view event. A mutation is done when this returns.\n  dispatch(name: string, event: DotEvent): Promise<void> {\n    const action = this.#definition.actions?.[name];\n    if (action) {\n      return this.#runAction(action, event);\n    }\n    const mutation = this.#definition.mutations?.[name];\n    if (!mutation) {\n      throw new Error(`Page \"${this.id}\" has no mutation or action \"${name}\"`);\n    }\n    this.#runMutation(mutation, event);\n    return Promise.resolve();\n  }\n\n  async lifecycle<K extends keyof PageHooks>(\n    hookName: K,\n    ...args: Parameters<PageHooks[K]>\n  ): Promise<void> {\n    const hook = this.#definition.hooks?.[hookName] as\n      ((...hookArgs: Parameters<PageHooks[K]>) => unknown) | undefined;\n    // Hooks run one at a time, in call order; a failed hook does not block the next one.\n    const run = this.#previousHook.then(() => hook?.call(this.context, ...args));\n    this.#previousHook = run.catch(() => {});\n    await run;\n  }\n\n  close(): void {\n    this.#closed = true;\n  }\n\n  // Handlers called from other handlers may leave out the event, so it can be undefined here.\n  #runMutation(mutation: Mutation<S>, event: DotEvent | undefined): void {\n    this.setState((state) => mutation(state, event as DotEvent));\n  }\n\n  async #runAction(action: Action<S>, event: DotEvent | undefined): Promise<void> {\n    await action.call(this.actionContext, this.#state, event as DotEvent);\n  }\n\n  #createNavigation(): PageNavigation {\n    return {\n      push: (page, options = {}) => this.#navigate({ action: 'push', page, options }),\n      replace: (page, options = {}) => this.#navigate({ action: 'replace', page, options }),\n      reset: (page, options = {}) => this.#navigate({ action: 'reset', page, options }),\n      back: (delta = 1) => this.#navigate({ action: 'back', delta }),\n    };\n  }\n\n  #navigate(navigation: Navigation): void {\n    if (!this.#closed) {\n      this.#host.navigate(this as Page, navigation);\n    }\n  }\n\n  #freeze(state: State<S>): State<S> {\n    return this.#host.strict ? deepFreeze(state) : state;\n  }\n}\n\n// What hooks get as `this`. `setState` is bound, so a hook may destructure it.\nclass HookContext<S extends PageState> implements PageContext<S, Mutations<S>, Actions<S>> {\n  readonly id: string;\n  readonly instanceId: number;\n  readonly mutations: MutationCalls<S>;\n  readonly actions: ActionCalls<S>;\n  readonly #page: Page<S>;\n\n  constructor(page: Page<S>, mutations: MutationCalls<S>, actions: ActionCalls<S>) {\n    this.id = page.id;\n    this.instanceId = page.instanceId;\n    this.mutations = mutations;\n    this.actions = actions;\n    this.#page = page;\n  }\n\n  get state(): State<S> {\n    return this.#page.state;\n  }\n\n  readonly setState = (update: StateUpdate<S>): void => {\n    this.#page.setState(update);\n  };\n}\n\n// What actions get as `this`: the hook context plus navigation.\nclass HandlerContext<S extends PageState>\n  extends HookContext<S>\n  implements ActionContext<S, Mutations<S>, Actions<S>>\n{\n  readonly navigation: PageNavigation;\n\n  constructor(\n    page: Page<S>,\n    mutations: MutationCalls<S>,\n    actions: ActionCalls<S>,\n    navigation: PageNavigation,\n  ) {\n    super(page, mutations, actions);\n    this.navigation = navigation;\n  }\n}\n\nfunction mapNames<T>(\n  record: Readonly<Record<string, unknown>>,\n  create: (name: string) => T,\n): Record<string, T> {\n  return Object.fromEntries(Object.keys(record).map((name) => [name, create(name)]));\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (typeof value === 'object' && value !== null && !Object.isFrozen(value)) {\n    Object.freeze(value);\n    Object.values(value).forEach(deepFreeze);\n  }\n  return value;\n}\n","import type {\n  DotHooks,\n  DotEvent,\n  Envelope,\n  HostLayerMessages,\n  LogicLayerMessages,\n  Navigation,\n  PageLaunchOptions,\n  PageState,\n  SystemContext,\n  Theme,\n  Transport,\n  UILayerMessages,\n} from '@monimesl/dot-core';\nimport {\n  DEFAULT_SYSTEM_CONTEXT,\n  connectHost,\n  EventEmitter,\n  MAX_STACK_DEPTH,\n  MessageChannel,\n} from '@monimesl/dot-core';\n\nimport { HostCalls } from './host-calls';\nimport type { PageDefinition } from './page';\nimport { Page } from './page';\n\nexport type ServiceChannel = MessageChannel<\n  LogicLayerMessages,\n  UILayerMessages & HostLayerMessages\n>;\n\nexport interface ServiceHooks {\n  launch(): void;\n\n  pageLoad(page: Page): void;\n\n  pageUnload(page: Page): void;\n\n  pageShow(page: Page): void;\n\n  pageHide(page: Page): void;\n\n  // A page asked to navigate; the request is on its way to the view layer.\n  navigate(page: Page, navigation: Navigation): void;\n\n  // Before a handler runs\n  event(page: Page, handler: string, event: DotEvent): void;\n\n  // After the state changes, with the changed keys, before they are sent to the view layer\n  setState(page: Page, patch: PageState): void;\n\n  // The instance is known when the error came from one page.\n  error(error: unknown, instanceId: number | undefined): void;\n}\n\nexport interface ServicePlugin {\n  readonly name: string;\n\n  setup(service: Service): void;\n}\n\nexport interface DotContext {\n  readonly theme: Theme;\n  readonly systemContext: SystemContext;\n\n  setTheme(theme: Theme): void;\n}\n\nexport interface DotDefinition {\n  readonly theme?: Theme;\n  readonly plugins?: readonly ServicePlugin[];\n  readonly pages: readonly [string, ...string[]];\n  readonly hooks?: Partial<DotHooks> & ThisType<DotContext>;\n}\n\nexport function defineDot(dot: DotDefinition): DotDefinition {\n  return dot;\n}\n\nexport interface ServiceOptions {\n  transport: Transport;\n  dot?: Partial<DotDefinition>;\n  pages: Record<string, PageDefinition>;\n  strict?: boolean;\n}\n\n// The logic layer: owns every page's state, runs handlers, and sends state changes to the view layer.\nexport class Service implements DotContext {\n  readonly channel: ServiceChannel;\n  readonly hooks = new EventEmitter<ServiceHooks>();\n  readonly #definitions: Record<string, PageDefinition>;\n  readonly #pages = new Map<number, Page>();\n  readonly #dot: Partial<DotDefinition>;\n  readonly #strict: boolean;\n  #theme: Theme;\n  #systemContext: SystemContext = DEFAULT_SYSTEM_CONTEXT;\n  #stack: HostLayerMessages['syncStack'] = { pages: [], limit: MAX_STACK_DEPTH };\n  readonly #hostCalls: HostCalls;\n\n  constructor({ transport, pages, dot = {}, strict = false }: ServiceOptions) {\n    this.channel = new MessageChannel(transport);\n    this.#hostCalls = new HostCalls(this.channel);\n    this.#definitions = pages;\n    this.#dot = dot;\n    this.#strict = strict;\n    this.#theme = dot.theme ?? {};\n\n    this.channel.handle('connect', () => this.channel.send('setTheme', { theme: this.#theme }));\n    this.channel.handle('syncStack', (stack) => {\n      this.#stack = stack;\n    });\n    this.channel.handle('syncSystemContext', (context) => {\n      this.#systemContext = context;\n    });\n    this.channel.handle('load', ({ instanceId, page, options }) =>\n      this.loadPage(instanceId, page, options),\n    );\n    this.channel.handle('unload', ({ instanceId }) => this.unloadPage(instanceId));\n    this.channel.handle('show', ({ instanceId }) => {\n      const page = this.getPage(instanceId);\n      this.hooks.emit('pageShow', page);\n      this.reportError(page.lifecycle('onShow'), instanceId);\n    });\n    this.channel.handle('hide', ({ instanceId }) => {\n      const page = this.getPage(instanceId);\n      this.hooks.emit('pageHide', page);\n      this.reportError(page.lifecycle('onHide'), instanceId);\n    });\n    this.channel.handle('event', ({ instanceId, handler, event }) => {\n      const page = this.getPage(instanceId);\n      this.hooks.emit('event', page, handler, event);\n      this.reportError(page.dispatch(handler, event), instanceId);\n    });\n\n    dot.plugins?.forEach((plugin) => this.use(plugin));\n  }\n\n  use(plugin: ServicePlugin): this {\n    plugin.setup(this);\n    return this;\n  }\n\n  start(): () => void {\n    const stopListening = this.channel.listen((error, message) => {\n      this.#reportError(error, instanceIdOf(message));\n    });\n    // Host calls, such as `dash.ui.alert`, now go through this service's channel.\n    connectHost((method, params, options) => this.#hostCalls.call(method, params, options));\n    this.hooks.emit('launch');\n    this.reportError(this.#runLaunchHook());\n    return () => {\n      stopListening();\n      connectHost(null);\n    };\n  }\n\n  get theme(): Theme {\n    return this.#theme;\n  }\n\n  get systemContext(): SystemContext {\n    return this.#systemContext;\n  }\n\n  setTheme(theme: Theme): void {\n    this.#theme = theme;\n    this.channel.send('setTheme', { theme });\n  }\n\n  getPage(instanceId: number): Page {\n    const page = this.#pages.get(instanceId);\n    if (!page) {\n      throw new Error(`Page instance ${instanceId} is not loaded`);\n    }\n    return page;\n  }\n\n  loadPage(instanceId: number, id: string, options: PageLaunchOptions = {}): Page {\n    const page = new Page(instanceId, id, this.#definition(id), {\n      commit: (page, patch) => {\n        this.hooks.emit('setState', page, patch);\n        this.channel.send('setPageState', { instanceId: page.instanceId, patchState: patch });\n      },\n      navigate: (page, navigation) => {\n        if (navigation.action !== 'back') {\n          this.#definition(navigation.page);\n        }\n        const { pages, limit } = this.#stack;\n        if (navigation.action === 'push' && pages.length >= limit) {\n          throw new Error(\n            `Cannot open \"${navigation.page}\": ${limit} pages are already open. Use replace or back.`,\n          );\n        }\n        this.hooks.emit('navigate', page, navigation);\n        this.channel.send('navigate', { ...navigation, from: page.instanceId });\n      },\n      strict: this.#strict,\n    });\n    this.#pages.set(instanceId, page);\n    this.channel.send('initPageState', { instanceId, state: page.state });\n    this.hooks.emit('pageLoad', page);\n    this.reportError(page.lifecycle('onLoad', options), instanceId);\n    return page;\n  }\n\n  unloadPage(instanceId: number): void {\n    const page = this.#pages.get(instanceId);\n    if (!page) {\n      return;\n    }\n    this.#pages.delete(instanceId);\n    page.close();\n    this.reportError(page.lifecycle('onUnload'), instanceId);\n    this.hooks.emit('pageUnload', page);\n  }\n\n  #definition(id: string): PageDefinition {\n    const definition = this.#definitions[id];\n    if (!definition) {\n      throw new Error(`Unknown page \"${id}\"`);\n    }\n    return definition;\n  }\n\n  reportError(work: Promise<void>, instanceId?: number): void {\n    work.catch((error: unknown) => {\n      this.#reportError(error, instanceId);\n    });\n  }\n\n  async #runLaunchHook(): Promise<void> {\n    await this.#dot.hooks?.onLaunch?.call(this);\n  }\n\n  #reportError(error: unknown, instanceId: number | undefined): void {\n    this.hooks.emit('error', error, instanceId);\n    const reason = error instanceof Error ? error : new Error(String(error));\n    this.#dot.hooks?.onError?.call(this, reason);\n    const report: LogicLayerMessages['error'] = { message: reason.message };\n    if (instanceId !== undefined) {\n      report.instanceId = instanceId;\n    }\n    this.channel.send('error', report);\n  }\n}\n\n// The page instance a channel message was for, if it names one.\nfunction instanceIdOf(message: Envelope): number | undefined {\n  const payload = message.payload as { instanceId?: unknown } | undefined;\n  if (typeof payload?.instanceId === 'number') {\n    return payload.instanceId;\n  }\n  return undefined;\n}\n"],"mappings":";;AAiBA,IAAa,YAAb,MAAuB;CACrB;CACA,2BAAoB,IAAI,IAAyB;CACjD,UAAU;CAEV,YAAY,SAAyB;EACnC,KAAK,WAAW;EAChB,QAAQ,OAAO,eAAe,WAAW,KAAK,QAAQ,MAAM,CAAC;CAC/D;CAEA,KAAK,QAAgB,QAAiB,SAAgD;EACpF,MAAM,KAAK,KAAK;EAChB,MAAM,UAAU,IAAI,SAAkB,SAAS,WAAW;GACxD,KAAK,SAAS,IAAI,IAAI;IAAE;IAAQ;IAAS;GAAO,CAAC;EACnD,CAAC;EACD,MAAM,UAA0C;GAAE;GAAI;GAAQ;EAAO;EACrE,IAAI,QAAQ,YAAY,KAAA,GACtB,QAAQ,UAAU,QAAQ;EAE5B,KAAK,SAAS,KAAK,YAAY,OAAO;EACtC,OAAO,kBAAkB,eAAe,KAAK,QAAQ,EAAE,CAAC;CAC1D;CAEA,QAAQ,IAAkB;EACxB,MAAM,OAAO,KAAK,SAAS,IAAI,EAAE;EACjC,IAAI,CAAC,MACH;EAEF,KAAK,SAAS,OAAO,EAAE;EACvB,KAAK,SAAS,KAAK,cAAc,EAAE,GAAG,CAAC;EACvC,KAAK,OAAO,IAAI,UAAU,aAAa,IAAI,KAAK,OAAO,gBAAgB,CAAC;CAC1E;CAEA,QAAQ,QAA0B;EAChC,MAAM,OAAO,KAAK,SAAS,IAAI,OAAO,EAAE;EAExC,IAAI,CAAC,MACH;EAEF,KAAK,SAAS,OAAO,OAAO,EAAE;EAC9B,IAAI,WAAW,QACb,KAAK,OAAO,IAAI,UAAU,OAAO,MAAM,MAAM,OAAO,MAAM,OAAO,CAAC;OAElE,KAAK,QAAQ,OAAO,KAAK;CAE7B;AACF;;;ACuBA,SAAgB,WAId,SAAoD;CACpD,OAAO;AACT;AAeA,IAAa,OAAb,MAAmD;CACjD;CACA;CACA;CACA;CACA;CACA;CACA;CACA,UAAU;CACV,gBAAkC,QAAQ,QAAQ;CAElD,YAAY,YAAoB,IAAY,YAA+B,MAAgB;EACzF,KAAK,KAAK;EACV,KAAK,aAAa;EAClB,KAAK,cAAc;EACnB,KAAK,QAAQ;EACb,KAAK,SAAS,KAAK,QAAQ,KAAK,MAAM,KAAK,UAAU,WAAW,YAAY,CAAC,CAAa;EAE1F,MAAM,EAAE,YAAY,CAAC,GAAG,UAAU,CAAC,MAAM;EACzC,MAAM,QAAQ,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,SAAS,QAAQ,OAAO;EACnE,IAAI,OACF,MAAM,IAAI,MAAM,SAAS,GAAG,MAAM,MAAM,mCAAmC;EAG7E,MAAM,gBAAgB,SACpB,YACC,UAAU,UAAqB,KAAK,OAAO,MAAM,KAAK,CACzD;EACA,MAAM,cAAc,SAAS,UAAU,UAAU,UAAqB,KAAK,IAAI,MAAM,KAAK,CAAC;EAC3F,KAAK,UAAU,IAAI,YAAY,MAAM,eAAe,WAAW;EAC/D,KAAK,gBAAgB,IAAI,eACvB,MACA,eACA,aACA,KAAK,kBAAkB,CACzB;CACF;CAEA,IAAI,QAAkB;EACpB,OAAO,KAAK;CACd;CAEA,WAAqB;EACnB,MAAM,EAAE,YAAY,CAAC,GAAG,UAAU,CAAC,MAAM,KAAK;EAC9C,OAAO,CAAC,GAAG,OAAO,KAAK,SAAS,GAAG,GAAG,OAAO,KAAK,OAAO,CAAC;CAC5D;CAEA,SAAS,QAA8B;EACrC,IAAI,KAAK,SACP;EAEF,MAAM,UAAU,OAAO,WAAW,aAAa,OAAO,KAAK,MAAM,IAAI;EACrE,IAAI,YAAY,KAAA,GACd;EAEF,MAAM,OAAO,aAAa,KAAK,QAAQ,OAAO;EAC9C,MAAM,QAAmB,CAAC;EAC1B,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,GAChC,IAAI,KAAK,SAAS,KAAK,OAAO,MAC5B,MAAM,OAAO,KAAK;EAGtB,KAAK,SAAS,KAAK,QAAQ,IAAI;EAC/B,IAAI,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GAC9B,KAAK,MAAM,OAAO,MAAc,KAAK;CAEzC;CAEA,OAAO,MAAc,OAAwB;EAC3C,MAAM,WAAW,KAAK,YAAY,YAAY;EAC9C,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,SAAS,KAAK,GAAG,qBAAqB,KAAK,EAAE;EAE/D,KAAK,aAAa,UAAU,KAAK;CACnC;CAEA,MAAM,IAAI,MAAc,OAAiC;EACvD,MAAM,SAAS,KAAK,YAAY,UAAU;EAC1C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,SAAS,KAAK,GAAG,mBAAmB,KAAK,EAAE;EAE7D,MAAM,KAAK,WAAW,QAAQ,KAAK;CACrC;CAGA,SAAS,MAAc,OAAgC;EACrD,MAAM,SAAS,KAAK,YAAY,UAAU;EAC1C,IAAI,QACF,OAAO,KAAK,WAAW,QAAQ,KAAK;EAEtC,MAAM,WAAW,KAAK,YAAY,YAAY;EAC9C,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,SAAS,KAAK,GAAG,+BAA+B,KAAK,EAAE;EAEzE,KAAK,aAAa,UAAU,KAAK;EACjC,OAAO,QAAQ,QAAQ;CACzB;CAEA,MAAM,UACJ,UACA,GAAG,MACY;EACf,MAAM,OAAO,KAAK,YAAY,QAAQ;EAGtC,MAAM,MAAM,KAAK,cAAc,WAAW,MAAM,KAAK,KAAK,SAAS,GAAG,IAAI,CAAC;EAC3E,KAAK,gBAAgB,IAAI,YAAY,CAAC,CAAC;EACvC,MAAM;CACR;CAEA,QAAc;EACZ,KAAK,UAAU;CACjB;CAGA,aAAa,UAAuB,OAAmC;EACrE,KAAK,UAAU,UAAU,SAAS,OAAO,KAAiB,CAAC;CAC7D;CAEA,MAAM,WAAW,QAAmB,OAA4C;EAC9E,MAAM,OAAO,KAAK,KAAK,eAAe,KAAK,QAAQ,KAAiB;CACtE;CAEA,oBAAoC;EAClC,OAAO;GACL,OAAO,MAAM,UAAU,CAAC,MAAM,KAAK,UAAU;IAAE,QAAQ;IAAQ;IAAM;GAAQ,CAAC;GAC9E,UAAU,MAAM,UAAU,CAAC,MAAM,KAAK,UAAU;IAAE,QAAQ;IAAW;IAAM;GAAQ,CAAC;GACpF,QAAQ,MAAM,UAAU,CAAC,MAAM,KAAK,UAAU;IAAE,QAAQ;IAAS;IAAM;GAAQ,CAAC;GAChF,OAAO,QAAQ,MAAM,KAAK,UAAU;IAAE,QAAQ;IAAQ;GAAM,CAAC;EAC/D;CACF;CAEA,UAAU,YAA8B;EACtC,IAAI,CAAC,KAAK,SACR,KAAK,MAAM,SAAS,MAAc,UAAU;CAEhD;CAEA,QAAQ,OAA2B;EACjC,OAAO,KAAK,MAAM,SAAS,WAAW,KAAK,IAAI;CACjD;AACF;AAGA,IAAM,cAAN,MAA2F;CACzF;CACA;CACA;CACA;CACA;CAEA,YAAY,MAAe,WAA6B,SAAyB;EAC/E,KAAK,KAAK,KAAK;EACf,KAAK,aAAa,KAAK;EACvB,KAAK,YAAY;EACjB,KAAK,UAAU;EACf,KAAK,QAAQ;CACf;CAEA,IAAI,QAAkB;EACpB,OAAO,KAAK,MAAM;CACpB;CAEA,YAAqB,WAAiC;EACpD,KAAK,MAAM,SAAS,MAAM;CAC5B;AACF;AAGA,IAAM,iBAAN,cACU,YAEV;CACE;CAEA,YACE,MACA,WACA,SACA,YACA;EACA,MAAM,MAAM,WAAW,OAAO;EAC9B,KAAK,aAAa;CACpB;AACF;AAEA,SAAS,SACP,QACA,QACmB;CACnB,OAAO,OAAO,YAAY,OAAO,KAAK,MAAM,CAAC,CAAC,KAAK,SAAS,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC,CAAC;AACnF;AAEA,SAAS,WAAc,OAAa;CAClC,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,OAAO,SAAS,KAAK,GAAG;EAC1E,OAAO,OAAO,KAAK;EACnB,OAAO,OAAO,KAAK,CAAC,CAAC,QAAQ,UAAU;CACzC;CACA,OAAO;AACT;;;ACvOA,SAAgB,UAAU,KAAmC;CAC3D,OAAO;AACT;AAUA,IAAa,UAAb,MAA2C;CACzC;CACA,QAAiB,IAAI,aAA2B;CAChD;CACA,yBAAkB,IAAI,IAAkB;CACxC;CACA;CACA;CACA,iBAAgC;CAChC,SAAyC;EAAE,OAAO,CAAC;EAAG,OAAO;CAAgB;CAC7E;CAEA,YAAY,EAAE,WAAW,OAAO,MAAM,CAAC,GAAG,SAAS,SAAyB;EAC1E,KAAK,UAAU,IAAI,eAAe,SAAS;EAC3C,KAAK,aAAa,IAAI,UAAU,KAAK,OAAO;EAC5C,KAAK,eAAe;EACpB,KAAK,OAAO;EACZ,KAAK,UAAU;EACf,KAAK,SAAS,IAAI,SAAS,CAAC;EAE5B,KAAK,QAAQ,OAAO,iBAAiB,KAAK,QAAQ,KAAK,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;EAC1F,KAAK,QAAQ,OAAO,cAAc,UAAU;GAC1C,KAAK,SAAS;EAChB,CAAC;EACD,KAAK,QAAQ,OAAO,sBAAsB,YAAY;GACpD,KAAK,iBAAiB;EACxB,CAAC;EACD,KAAK,QAAQ,OAAO,SAAS,EAAE,YAAY,MAAM,cAC/C,KAAK,SAAS,YAAY,MAAM,OAAO,CACzC;EACA,KAAK,QAAQ,OAAO,WAAW,EAAE,iBAAiB,KAAK,WAAW,UAAU,CAAC;EAC7E,KAAK,QAAQ,OAAO,SAAS,EAAE,iBAAiB;GAC9C,MAAM,OAAO,KAAK,QAAQ,UAAU;GACpC,KAAK,MAAM,KAAK,YAAY,IAAI;GAChC,KAAK,YAAY,KAAK,UAAU,QAAQ,GAAG,UAAU;EACvD,CAAC;EACD,KAAK,QAAQ,OAAO,SAAS,EAAE,iBAAiB;GAC9C,MAAM,OAAO,KAAK,QAAQ,UAAU;GACpC,KAAK,MAAM,KAAK,YAAY,IAAI;GAChC,KAAK,YAAY,KAAK,UAAU,QAAQ,GAAG,UAAU;EACvD,CAAC;EACD,KAAK,QAAQ,OAAO,UAAU,EAAE,YAAY,SAAS,YAAY;GAC/D,MAAM,OAAO,KAAK,QAAQ,UAAU;GACpC,KAAK,MAAM,KAAK,SAAS,MAAM,SAAS,KAAK;GAC7C,KAAK,YAAY,KAAK,SAAS,SAAS,KAAK,GAAG,UAAU;EAC5D,CAAC;EAED,IAAI,SAAS,SAAS,WAAW,KAAK,IAAI,MAAM,CAAC;CACnD;CAEA,IAAI,QAA6B;EAC/B,OAAO,MAAM,IAAI;EACjB,OAAO;CACT;CAEA,QAAoB;EAClB,MAAM,gBAAgB,KAAK,QAAQ,QAAQ,OAAO,YAAY;GAC5D,KAAK,aAAa,OAAO,aAAa,OAAO,CAAC;EAChD,CAAC;EAED,aAAa,QAAQ,QAAQ,YAAY,KAAK,WAAW,KAAK,QAAQ,QAAQ,OAAO,CAAC;EACtF,KAAK,MAAM,KAAK,QAAQ;EACxB,KAAK,YAAY,KAAK,eAAe,CAAC;EACtC,aAAa;GACX,cAAc;GACd,YAAY,IAAI;EAClB;CACF;CAEA,IAAI,QAAe;EACjB,OAAO,KAAK;CACd;CAEA,IAAI,gBAA+B;EACjC,OAAO,KAAK;CACd;CAEA,SAAS,OAAoB;EAC3B,KAAK,SAAS;EACd,KAAK,QAAQ,KAAK,YAAY,EAAE,MAAM,CAAC;CACzC;CAEA,QAAQ,YAA0B;EAChC,MAAM,OAAO,KAAK,OAAO,IAAI,UAAU;EACvC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,WAAW,eAAe;EAE7D,OAAO;CACT;CAEA,SAAS,YAAoB,IAAY,UAA6B,CAAC,GAAS;EAC9E,MAAM,OAAO,IAAI,KAAK,YAAY,IAAI,KAAK,YAAY,EAAE,GAAG;GAC1D,SAAS,MAAM,UAAU;IACvB,KAAK,MAAM,KAAK,YAAY,MAAM,KAAK;IACvC,KAAK,QAAQ,KAAK,gBAAgB;KAAE,YAAY,KAAK;KAAY,YAAY;IAAM,CAAC;GACtF;GACA,WAAW,MAAM,eAAe;IAC9B,IAAI,WAAW,WAAW,QACxB,KAAK,YAAY,WAAW,IAAI;IAElC,MAAM,EAAE,OAAO,UAAU,KAAK;IAC9B,IAAI,WAAW,WAAW,UAAU,MAAM,UAAU,OAClD,MAAM,IAAI,MACR,gBAAgB,WAAW,KAAK,KAAK,MAAM,8CAC7C;IAEF,KAAK,MAAM,KAAK,YAAY,MAAM,UAAU;IAC5C,KAAK,QAAQ,KAAK,YAAY;KAAE,GAAG;KAAY,MAAM,KAAK;IAAW,CAAC;GACxE;GACA,QAAQ,KAAK;EACf,CAAC;EACD,KAAK,OAAO,IAAI,YAAY,IAAI;EAChC,KAAK,QAAQ,KAAK,iBAAiB;GAAE;GAAY,OAAO,KAAK;EAAM,CAAC;EACpE,KAAK,MAAM,KAAK,YAAY,IAAI;EAChC,KAAK,YAAY,KAAK,UAAU,UAAU,OAAO,GAAG,UAAU;EAC9D,OAAO;CACT;CAEA,WAAW,YAA0B;EACnC,MAAM,OAAO,KAAK,OAAO,IAAI,UAAU;EACvC,IAAI,CAAC,MACH;EAEF,KAAK,OAAO,OAAO,UAAU;EAC7B,KAAK,MAAM;EACX,KAAK,YAAY,KAAK,UAAU,UAAU,GAAG,UAAU;EACvD,KAAK,MAAM,KAAK,cAAc,IAAI;CACpC;CAEA,YAAY,IAA4B;EACtC,MAAM,aAAa,KAAK,aAAa;EACrC,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,iBAAiB,GAAG,EAAE;EAExC,OAAO;CACT;CAEA,YAAY,MAAqB,YAA2B;EAC1D,KAAK,OAAO,UAAmB;GAC7B,KAAK,aAAa,OAAO,UAAU;EACrC,CAAC;CACH;CAEA,MAAM,iBAAgC;EACpC,MAAM,KAAK,KAAK,OAAO,UAAU,KAAK,IAAI;CAC5C;CAEA,aAAa,OAAgB,YAAsC;EACjE,KAAK,MAAM,KAAK,SAAS,OAAO,UAAU;EAC1C,MAAM,SAAS,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EACvE,KAAK,KAAK,OAAO,SAAS,KAAK,MAAM,MAAM;EAC3C,MAAM,SAAsC,EAAE,SAAS,OAAO,QAAQ;EACtE,IAAI,eAAe,KAAA,GACjB,OAAO,aAAa;EAEtB,KAAK,QAAQ,KAAK,SAAS,MAAM;CACnC;AACF;AAGA,SAAS,aAAa,SAAuC;CAC3D,MAAM,UAAU,QAAQ;CACxB,IAAI,OAAO,SAAS,eAAe,UACjC,OAAO,QAAQ;AAGnB"}

package/dist/testing.d.ts

@@ -0,0 +1,27 @@
+import { f as State, s as PageDefinition } from "./page-BfYJ-G-D.js";
+import { DotEvent, Navigation, PageLaunchOptions, PageState } from "@monimesl/dot-core";
+//#region src/testing.d.ts
+export type TestHost = Readonly<Record<string, (params: never) => unknown>>;
+export interface TestPageOptions {
+  id?: string;
+  options?: PageLaunchOptions;
+  host?: TestHost;
+}
+export interface HostCallRecord {
+  readonly method: string;
+  readonly params: unknown;
+}
+export interface PageTest<S extends PageState> {
+  readonly state: State<S>;
+  readonly patches: readonly PageState[];
+  readonly navigations: readonly Navigation[];
+  readonly hostCalls: readonly HostCallRecord[];
+  tap(name: string, detail?: unknown): Promise<void>;
+  dispatch(name: string, event?: DotEvent): Promise<void>;
+  show(): Promise<void>;
+  hide(): Promise<void>;
+  unload(): Promise<void>;
+}
+export declare function testPage<S extends PageState>(definition: PageDefinition<S>, { id, options, host }?: TestPageOptions): Promise<PageTest<S>>;
+//#endregion
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing.ts"],"mappings":";;;YAYY,WAAW,SAAS,gBAAgB;iBAE/B;EACf;EACA,UAAU;EAEV,OAAO;;iBAGQ;WACN;WACA;;iBAGM,SAAS,UAAU;WACzB,OAAO,MAAM;WACb,kBAAkB;WAClB,sBAAsB;WACtB,oBAAoB;EAE7B,IAAI,cAAc,mBAAmB;EAErC,SAAS,cAAc,QAAQ,WAAW;EAE1C,QAAQ;EAER,QAAQ;EAER,UAAU;;wBAGU,SAAS,UAAU,WACvC,YAAY,eAAe,MACzB,IAAa,SAAc,SAAa,kBACzC,QAAQ,SAAS"}

package/dist/testing.js

@@ -0,0 +1,55 @@
+import { i as definePage, n as defineDot, r as Page } from "./service-dAFmZ_Mh.js";
+import { HostError, connectHost, createEvent, createHostRequest } from "@monimesl/dot-core";
+//#region src/testing.ts
+Object.assign(globalThis, {
+	definePage,
+	defineDot,
+	createEvent
+});
+async function testPage(definition, { id = "test", options = {}, host = {} } = {}) {
+	const patches = [];
+	const navigations = [];
+	const hostCalls = [];
+	connectHost((method, params) => {
+		hostCalls.push({
+			method,
+			params
+		});
+		const handler = host[method];
+		if (!handler) {
+			const error = new HostError("unsupported", `The test gives no host method "${method}"`);
+			return createHostRequest(Promise.reject(error));
+		}
+		return createHostRequest(Promise.resolve().then(() => handler(params)));
+	});
+	const page = new Page(1, id, definition, {
+		commit: (_page, patch) => patches.push(patch),
+		navigate: (_page, navigation) => navigations.push(navigation),
+		strict: true
+	});
+	const dispatch = async (name, event = createEvent("tap")) => {
+		await page.dispatch(name, event);
+	};
+	await page.lifecycle("onLoad", options);
+	await page.lifecycle("onShow");
+	return {
+		get state() {
+			return page.state;
+		},
+		patches,
+		navigations,
+		hostCalls,
+		tap: (name, detail = {}) => dispatch(name, createEvent("tap", detail)),
+		dispatch,
+		show: () => page.lifecycle("onShow"),
+		hide: () => page.lifecycle("onHide"),
+		unload: async () => {
+			page.close();
+			await page.lifecycle("onUnload");
+		}
+	};
+}
+//#endregion
+export { testPage };
+
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type { DotEvent, Navigation, PageLaunchOptions, PageState } from '@monimesl/dot-core';\nimport { HostError, connectHost, createEvent, createHostRequest } from '@monimesl/dot-core';\n\nimport type { PageDefinition, State } from './page';\nimport { definePage, Page } from './page';\nimport { defineDot } from './service';\n\n// A dot's code calls these without importing them; the compiler adds the imports when it bundles.\n// Tests import that code directly, so this module provides them, and must be imported first.\nObject.assign(globalThis, { definePage, defineDot, createEvent });\n\n// Fake host methods by name, such as `'dash.ui.alert': () => ({ action: 'ok' })`.\nexport type TestHost = Readonly<Record<string, (params: never) => unknown>>;\n\nexport interface TestPageOptions {\n  id?: string;\n  options?: PageLaunchOptions;\n  // Methods the page may call on the host; any other rejects with `unsupported`.\n  host?: TestHost;\n}\n\nexport interface HostCallRecord {\n  readonly method: string;\n  readonly params: unknown;\n}\n\nexport interface PageTest<S extends PageState> {\n  readonly state: State<S>;\n  readonly patches: readonly PageState[];\n  readonly navigations: readonly Navigation[];\n  readonly hostCalls: readonly HostCallRecord[];\n\n  tap(name: string, detail?: unknown): Promise<void>;\n\n  dispatch(name: string, event?: DotEvent): Promise<void>;\n\n  show(): Promise<void>;\n\n  hide(): Promise<void>;\n\n  unload(): Promise<void>;\n}\n\nexport async function testPage<S extends PageState>(\n  definition: PageDefinition<S>,\n  { id = 'test', options = {}, host = {} }: TestPageOptions = {},\n): Promise<PageTest<S>> {\n  const patches: PageState[] = [];\n  const navigations: Navigation[] = [];\n  const hostCalls: HostCallRecord[] = [];\n  connectHost((method, params) => {\n    hostCalls.push({ method, params });\n    const handler = host[method];\n    if (!handler) {\n      const error = new HostError('unsupported', `The test gives no host method \"${method}\"`);\n      return createHostRequest(Promise.reject(error));\n    }\n    return createHostRequest(Promise.resolve().then(() => handler(params as never)));\n  });\n  const page = new Page<S>(1, id, definition, {\n    commit: (_page, patch) => patches.push(patch),\n    navigate: (_page, navigation) => navigations.push(navigation),\n    strict: true,\n  });\n  const dispatch = async (name: string, event: DotEvent = createEvent('tap')) => {\n    await page.dispatch(name, event);\n  };\n\n  await page.lifecycle('onLoad', options);\n  await page.lifecycle('onShow');\n\n  return {\n    get state() {\n      return page.state;\n    },\n    patches,\n    navigations,\n    hostCalls,\n    tap: (name, detail = {}) => dispatch(name, createEvent('tap', detail)),\n    dispatch,\n    show: () => page.lifecycle('onShow'),\n    hide: () => page.lifecycle('onHide'),\n    unload: async () => {\n      page.close();\n      await page.lifecycle('onUnload');\n    },\n  };\n}\n"],"mappings":";;;AASA,OAAO,OAAO,YAAY;CAAE;CAAY;CAAW;AAAY,CAAC;AAkChE,eAAsB,SACpB,YACA,EAAE,KAAK,QAAQ,UAAU,CAAC,GAAG,OAAO,CAAC,MAAuB,CAAC,GACvC;CACtB,MAAM,UAAuB,CAAC;CAC9B,MAAM,cAA4B,CAAC;CACnC,MAAM,YAA8B,CAAC;CACrC,aAAa,QAAQ,WAAW;EAC9B,UAAU,KAAK;GAAE;GAAQ;EAAO,CAAC;EACjC,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;GACZ,MAAM,QAAQ,IAAI,UAAU,eAAe,kCAAkC,OAAO,EAAE;GACtF,OAAO,kBAAkB,QAAQ,OAAO,KAAK,CAAC;EAChD;EACA,OAAO,kBAAkB,QAAQ,QAAQ,CAAC,CAAC,WAAW,QAAQ,MAAe,CAAC,CAAC;CACjF,CAAC;CACD,MAAM,OAAO,IAAI,KAAQ,GAAG,IAAI,YAAY;EAC1C,SAAS,OAAO,UAAU,QAAQ,KAAK,KAAK;EAC5C,WAAW,OAAO,eAAe,YAAY,KAAK,UAAU;EAC5D,QAAQ;CACV,CAAC;CACD,MAAM,WAAW,OAAO,MAAc,QAAkB,YAAY,KAAK,MAAM;EAC7E,MAAM,KAAK,SAAS,MAAM,KAAK;CACjC;CAEA,MAAM,KAAK,UAAU,UAAU,OAAO;CACtC,MAAM,KAAK,UAAU,QAAQ;CAE7B,OAAO;EACL,IAAI,QAAQ;GACV,OAAO,KAAK;EACd;EACA;EACA;EACA;EACA,MAAM,MAAM,SAAS,CAAC,MAAM,SAAS,MAAM,YAAY,OAAO,MAAM,CAAC;EACrE;EACA,YAAY,KAAK,UAAU,QAAQ;EACnC,YAAY,KAAK,UAAU,QAAQ;EACnC,QAAQ,YAAY;GAClB,KAAK,MAAM;GACX,MAAM,KAAK,UAAU,UAAU;EACjC;CACF;AACF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@monimesl/dot-service",
+  "version": "0.1.0-alpha.2",
+  "description": "Dot logic layer: pages, state and plugins",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/monime-lab/dot.git",
+    "directory": "packages/service"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "@monimesl/dot-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "@monimesl/dot-source": "./src/testing.ts",
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@monimesl/dot-core": "0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "publint": "^0.3.24",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.23.0",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "clean": "rimraf dist *.tsbuildinfo"
+  }
+}